agent-framework-orchestrations 1.3.2__tar.gz → 1.4.1__tar.gz

{agent_framework_orchestrations-1.3.2 → agent_framework_orchestrations-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-framework-orchestrations
-Version: 1.3.2
+Version: 1.4.1
 Summary: Orchestration patterns for Microsoft Agent Framework. Includes SequentialBuilder, ConcurrentBuilder, HandoffBuilder, GroupChatBuilder, and MagenticBuilder.
 Author-email: Microsoft <af-support@microsoft.com>
 Requires-Python: >=3.10
@@ -9,7 +9,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -17,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Classifier: Typing :: Typed
 License-File: LICENSE
-Requires-Dist: agent-framework-core>=1.19.0,<2
+Requires-Dist: agent-framework-core>=1.23.0,<2
 Project-URL: homepage, https://aka.ms/agent-framework
 Project-URL: issues, https://github.com/microsoft/agent-framework/issues
 Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true

{agent_framework_orchestrations-1.3.2 → agent_framework_orchestrations-1.4.1}/agent_framework_orchestrations/_handoff.py

@@ -657,15 +657,15 @@ class HandoffBuilder:
     tool injection, and middleware — capabilities only available on ``Agent``.
 
     Outputs:
-    Each agent's response surfaces as a workflow `output` event as it speaks; there is no
+    By default, each agent's response surfaces as a workflow `output` event as it speaks; there is no
     synthetic terminal event. Consumers iterating events see per-agent ``AgentResponse`` (or
     ``AgentResponseUpdate`` while streaming) in conversation order. The workflow returns to
     idle once the termination condition is met (or the user terminates an interactive run).
 
     Note:
     1. Agents in handoff workflows must be ``Agent`` instances and support local tool calls.
-    2. Because each agent's response is itself Workflow Output, handoff has no separate
-       "intermediate outputs" channel — every per-agent response is the primary output.
+    2. Use ``output_from`` and ``intermediate_output_from`` to select participants for Workflow Output
+       and Intermediate Output. Unselected participant outputs are hidden.
     """
 
     def __init__(

{agent_framework_orchestrations-1.3.2 → agent_framework_orchestrations-1.4.1}/agent_framework_orchestrations/_magentic.py

@@ -942,7 +942,10 @@ class MagenticOrchestrator(BaseGroupChatOrchestrator):
 
         # Termination related state
         self._terminated: bool = False
-        self._max_rounds = manager.max_round_count
+        # The base group chat contract coerces a max round count below 1 up to 1; this
+        # value is assigned after super().__init__, so apply the same rule here instead
+        # of ending the workflow before any round can run.
+        self._max_rounds = max(1, manager.max_round_count) if manager.max_round_count is not None else None
 
     @override
     async def _handle_messages(

{agent_framework_orchestrations-1.3.2 → agent_framework_orchestrations-1.4.1}/agent_framework_orchestrations/_orchestration_request_info.py

@@ -199,6 +199,7 @@ class AgentApprovalExecutor(WorkflowExecutor):
         context_mode: Literal["full", "last_agent", "custom"] | None = None,
         *,
         allow_direct_output: bool = False,
+        ensure_trailing_user_turn: bool = False,
     ) -> None:
         """Initialize the AgentApprovalExecutor.
 
@@ -210,8 +211,13 @@ class AgentApprovalExecutor(WorkflowExecutor):
                 downstream participant). Set this when this executor is the workflow's
                 terminator — so the user-approved final response surfaces as a workflow
                 ``output`` event.
+            ensure_trailing_user_turn: If True, appends a synthetic user continuation
+                message when the cache ends on an assistant message. Some chat-completions
+                providers return empty text when the prompt ends on ``assistant``.
+                Defaults to False.
         """
         self._context_mode: Literal["full", "last_agent", "custom"] | None = context_mode
+        self._ensure_trailing_user_turn = ensure_trailing_user_turn
         self._description = agent.description
 
         super().__init__(
@@ -235,6 +241,7 @@ class AgentApprovalExecutor(WorkflowExecutor):
         agent_executor = AgentExecutor(
             agent,
             context_mode=self._context_mode,
+            ensure_trailing_user_turn=self._ensure_trailing_user_turn,
         )
         request_info_cls = _TerminalAgentRequestInfoExecutor if terminal else AgentRequestInfoExecutor
         request_info_executor = request_info_cls(id="agent_request_info_executor")

{agent_framework_orchestrations-1.3.2 → agent_framework_orchestrations-1.4.1}/agent_framework_orchestrations/_sequential.py

@@ -105,6 +105,7 @@ class SequentialBuilder:
         chain_only_agent_responses: bool = False,
         output_from: Sequence[_ParticipantOutputSpecifier] | Literal["all"] | None = cast(Any, UNSET),
         intermediate_output_from: _ParticipantIntermediateOutputSelection = None,
+        ensure_trailing_user_turn: bool = False,
     ) -> None:
         """Initialize the SequentialBuilder.
 
@@ -120,6 +121,11 @@ class SequentialBuilder:
             intermediate_output_from: Optional participant names or instances whose ``yield_output`` calls
                 surface as workflow ``intermediate`` events. Pass ``"all_other"`` to select every participant
                 not selected by ``output_from``. Unlisted participant outputs are hidden.
+            ensure_trailing_user_turn: If True, whenever a participant would be run with a
+                conversation ending on an assistant message (e.g. chaining into the next agent),
+                a synthetic user continuation message is appended first. Some chat-completions
+                providers return empty text when the prompt ends on ``assistant``. Defaults to
+                False to preserve existing behavior.
         """
         self._name = name or DEFAULT_WORKFLOW_NAME
         self._participants: list[SupportsAgentRun | Executor] = []
@@ -129,6 +135,7 @@ class SequentialBuilder:
         self._request_info_filter: set[str] | None = None
         self._output_from = _coalesce_output_from(output_from=output_from)
         self._intermediate_output_from = _coerce_intermediate_output_from(intermediate_output_from)
+        self._ensure_trailing_user_turn: bool = ensure_trailing_user_turn
 
         self._set_participants(participants)
 
@@ -223,10 +230,17 @@ class SequentialBuilder:
                             p,
                             context_mode=context_mode,
                             allow_direct_output=(idx == last_idx),
+                            ensure_trailing_user_turn=self._ensure_trailing_user_turn,
                         )
                     )
                 else:
-                    executors.append(AgentExecutor(p, context_mode=context_mode))
+                    executors.append(
+                        AgentExecutor(
+                            p,
+                            context_mode=context_mode,
+                            ensure_trailing_user_turn=self._ensure_trailing_user_turn,
+                        )
+                    )
             else:
                 raise TypeError(f"Participants must be SupportsAgentRun or Executor instances. Got {type(p).__name__}.")
 

{agent_framework_orchestrations-1.3.2 → agent_framework_orchestrations-1.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ description = "Orchestration patterns for Microsoft Agent Framework. Includes Se
 authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
 readme = "README.md"
 requires-python = ">=3.10"
-version = "1.3.2"
+version = "1.4.1"
 license-files = ["LICENSE"]
 urls.homepage = "https://aka.ms/agent-framework"
 urls.source = "https://github.com/microsoft/agent-framework/tree/main/python"
@@ -15,7 +15,6 @@ classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -24,7 +23,7 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-    "agent-framework-core>=1.19.0,<2",
+    "agent-framework-core>=1.23.0,<2",
 ]
 
 [tool.uv]