[BREAKING] Python: Standardize orchestration outputs as list of ChatMessage. Allow agent as group chat manager. (#2291)

* Standardize orchestration outputs as list of chatmessage. Add chat options to group chat prompt manager

* refactor group chat

* Improve group chat manager

* README Update

* Cleanup

* Add comment

* More cleanup

* Standardize termination condition for group chat

* Improvements on termination logic

* Fix tests

* Fix new line

* PR feedback

* Update ChatKit based on OpenAI type change

* Raise error if response format is not expected type

* Only one starting executor required. Add tests.

* Add magentic start executor test

Author: moonbox3

python/packages/chatkit/agent_framework_chatkit/_converter.py

@@ -27,6 +27,7 @@
     EndOfTurnItem,
     HiddenContextItem,
     ImageAttachment,
+    SDKHiddenContextItem,
     TaskItem,
     ThreadItem,
     UserMessageItem,
@@ -180,8 +181,10 @@ async def fetch_data(attachment_id: str) -> bytes:
         # Subclasses can override this method to provide custom handling
         return None
 
-    def hidden_context_to_input(self, item: HiddenContextItem) -> ChatMessage | list[ChatMessage] | None:
-        """Convert a ChatKit HiddenContextItem to Agent Framework ChatMessage(s).
+    def hidden_context_to_input(
+        self, item: HiddenContextItem | SDKHiddenContextItem
+    ) -> ChatMessage | list[ChatMessage] | None:
+        """Convert a ChatKit HiddenContextItem or SDKHiddenContextItem to Agent Framework ChatMessage(s).
 
         This method is called internally by `to_agent_input()`. Override this method
         to customize how hidden context is converted.
@@ -522,6 +525,9 @@ async def _thread_item_to_input_item(
             case HiddenContextItem():
                 out = self.hidden_context_to_input(item) or []
                 return out if isinstance(out, list) else [out]
+            case SDKHiddenContextItem():
+                out = self.hidden_context_to_input(item) or []
+                return out if isinstance(out, list) else [out]
             case _:
                 assert_never(item)
 

python/packages/chatkit/pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
 ]
 dependencies = [
     "agent-framework-core",
-    "openai-chatkit>=1.1.0,<2.0.0",
+    "openai-chatkit>=1.4.0,<2.0.0",
 ]
 
 [tool.uv]

python/packages/core/agent_framework/_workflows/__init__.py

@@ -61,6 +61,8 @@
     GroupChatDirective,
     GroupChatStateSnapshot,
     ManagerDirectiveModel,
+    ManagerSelectionRequest,
+    ManagerSelectionResponse,
 )
 from ._handoff import HandoffBuilder, HandoffUserInputRequest
 from ._magentic import (
@@ -147,6 +149,8 @@
     "MagenticPlanReviewReply",
     "MagenticPlanReviewRequest",
     "ManagerDirectiveModel",
+    "ManagerSelectionRequest",
+    "ManagerSelectionResponse",
     "Message",
     "OrchestrationState",
     "RequestInfoEvent",