restore vision/image backwards compatibility

src/pipecat/frames/frames.py

@@ -1215,12 +1215,32 @@ class UserImageRequestFrame(SystemFrame):
         text: An optional text associated to the image request.
         append_to_context: Whether the requested image should be appended to the LLM context.
         video_source: Specific video source to capture from.
+        context: [DEPRECATED] Optional context for the image request.
+        function_name: [DEPRECATED] Name of function that generated this request (if any).
+        tool_call_id: [DEPRECATED] Tool call ID if generated by function call.
     """
 
     user_id: str
     text: Optional[str] = None
     append_to_context: Optional[bool] = None
     video_source: Optional[str] = None
+    context: Optional[Any] = None
+    function_name: Optional[str] = None
+    tool_call_id: Optional[str] = None
+
+    def __post_init__(self):
+        super().__post_init__()
+
+        if self.context or self.function_name or self.tool_call_id:
+            import warnings
+
+            with warnings.catch_warnings():
+                warnings.simplefilter("always")
+                warnings.warn(
+                    "`UserImageRequestFrame` fields `context`, `function_name` and `tool_call_id` are deprecated.",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
 
     def __str__(self):
         return f"{self.name}(user: {self.user_id}, text: {self.text}, append_to_context: {self.append_to_context}, {self.video_source})"
@@ -1299,11 +1319,27 @@ class UserImageRawFrame(InputImageRawFrame):
         user_id: Identifier of the user who provided this image.
         text: An optional text associated to this image.
         append_to_context: Whether the requested image should be appended to the LLM context.
+        request: [DEPRECATED] The original image request frame if this is a response.
     """
 
     user_id: str = ""
     text: Optional[str] = None
     append_to_context: Optional[bool] = None
+    request: Optional[UserImageRequestFrame] = None
+
+    def __post_init__(self):
+        super().__post_init__()
+
+        if self.request:
+            import warnings
+
+            with warnings.catch_warnings():
+                warnings.simplefilter("always")
+                warnings.warn(
+                    "`UserImageRawFrame` field `request` is deprecated.",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
 
     def __str__(self):
         pts = format_pts(self.pts)