From 809ab0b7b6139bfb555a2fb5fe0a7735aee159c0 Mon Sep 17 00:00:00 2001
From: Paul Kompfner <paul@daily.co>
Date: Thu, 7 Aug 2025 11:16:30 -0400
Subject: [PATCH] Improve printed deprecation warning

---
 src/pipecat/frames/frames.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/pipecat/frames/frames.py b/src/pipecat/frames/frames.py
index f6334dc17..e1c998d25 100644
--- a/src/pipecat/frames/frames.py
+++ b/src/pipecat/frames/frames.py
@@ -502,7 +502,10 @@ class LLMMessagesFrame(DataFrame):
 
         warnings.simplefilter("always")
         warnings.warn(
-            "LLMMessagesFrame is deprecated and will be removed in a future release.",
+            "LLMMessagesFrame is deprecated and will be removed in a future version. "
+            "Instead, use either "
+            "`LLMMessagesUpdateFrame` with `run_llm=True`, or "
+            "`OpenAILLMContextFrame` with desired messages in a new context",
             DeprecationWarning,
             stacklevel=2,
         )