From 64e48e46601e17d581af1f2f01ef8a9003eee50e Mon Sep 17 00:00:00 2001
From: Paul Kompfner <paul@daily.co>
Date: Wed, 6 Aug 2025 11:33:07 -0400
Subject: [PATCH] Deprecate `LLMMessagesFrame`.

The same functionality can be achieved using either:
- `LLMMessagesUpdateFrame` with the desired messages, with `run_llm` set to `True`
- `OpenAILLMContextFrame` with a new context initialized with the desired messages
---
 src/pipecat/frames/frames.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/pipecat/frames/frames.py b/src/pipecat/frames/frames.py
index e587e563d..69fc4ff51 100644
--- a/src/pipecat/frames/frames.py
+++ b/src/pipecat/frames/frames.py
@@ -490,6 +490,17 @@ class LLMMessagesFrame(DataFrame):
 
     messages: List[dict]
 
+    def __post_init__(self):
+        super().__post_init__()
+        import warnings
+
+        warnings.simplefilter("always")
+        warnings.warn(
+            "LLMMessagesFrame is deprecated and will be removed in a future release.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
 
 @dataclass
 class LLMMessagesAppendFrame(DataFrame):