Commit Graph

23 Commits

  • Python: [BREAKING] Types API Review improvements (#3647)
    * Replace Role and FinishReason classes with NewType + Literal
    
    - Remove EnumLike metaclass from _types.py
    - Replace Role class with NewType('Role', str) + RoleLiteral
    - Replace FinishReason class with NewType('FinishReason', str) + FinishReasonLiteral
    - Update all usages across codebase to use string literals
    - Remove .value access patterns (direct string comparison now works)
    - Add backward compatibility for legacy dict serialization format
    - Update tests to reflect new string-based types
    
    Addresses #3591, #3615
    
    * Simplify ChatResponse and AgentResponse type hints (#3592)
    
    - Remove overloads from ChatResponse.__init__
    - Remove text parameter from ChatResponse.__init__
    - Remove | dict[str, Any] from finish_reason and usage_details params
    - Remove **kwargs from AgentResponse.__init__
    - Both now accept ChatMessage | Sequence[ChatMessage] | None for messages
    - Update docstrings and examples to reflect changes
    - Fix tests that were using removed kwargs
    - Fix Role type hint usage in ag-ui utils
    
    * Remove text parameter from ChatResponseUpdate and AgentResponseUpdate (#3597)
    
    - Remove text parameter from ChatResponseUpdate.__init__
    - Remove text parameter from AgentResponseUpdate.__init__
    - Remove **kwargs from both update classes
    - Simplify contents parameter type to Sequence[Content] | None
    - Update all usages to use contents=[Content.from_text(...)] pattern
    - Fix imports in test files
    - Update docstrings and examples
    
    * Rename from_chat_response_updates to from_updates (#3593)
    
    - ChatResponse.from_chat_response_updates → ChatResponse.from_updates
    - ChatResponse.from_chat_response_generator → ChatResponse.from_update_generator
    - AgentResponse.from_agent_run_response_updates → AgentResponse.from_updates
    
    * Remove try_parse_value method from ChatResponse and AgentResponse (#3595)
    
    - Remove try_parse_value method from ChatResponse
    - Remove try_parse_value method from AgentResponse
    - Remove try_parse_value calls from from_updates and from_update_generator methods
    - Update samples to use try/except with response.value instead
    - Update tests to use response.value pattern
    - Users should now use response.value with try/except for safe parsing
    
    * Add agent_id to AgentResponse and clarify author_name documentation (#3596)
    
    - Add agent_id parameter to AgentResponse class
    - Document that author_name is on ChatMessage objects, not responses
    - Update ChatResponse docstring with author_name note
    - Update AgentResponse docstring with author_name note
    
    * Simplify ChatMessage.__init__ signature (#3618)
    
    - Make contents a positional argument accepting Sequence[Content | str]
    - Auto-convert strings in contents to TextContent
    - Remove overloads, keep text kwarg for backward compatibility with serialization
    - Update _parse_content_list to handle string items
    - Update all usages across codebase to use new format: ChatMessage("role", ["text"])
    
    * Allow Content as input on run and get_response
    
    - Update prepare_messages and normalize_messages to accept Content
    - Update type signatures in _agents.py and _clients.py
    - Add tests for Content input handling
    
    * Fix ChatMessage usage across packages and samples
    
    Update all remaining ChatMessage(role=..., text=...) to use new
    ChatMessage('role', ['text']) signature.
    
    * Fix Role string usage and response format parsing
    
    - Fix redis provider: remove .value access on string literals
    - Fix durabletask ensure_response_format: set _response_format before accessing .value
    
    * Fix ollama .value and ai_model_id issues, handle None in content list
    
    - Fix ollama _chat_client: remove .value on string literals
    - Fix ollama _chat_client: rename ai_model_id to model_id
    - Fix _parse_content_list: skip None values gracefully
    
    * Fix A2AAgent type signature to include Content
    
    * Fix Role/FinishReason NewType dict annotations and improve test coverage to 95%
    
    * Fix mypy errors for Role/FinishReason NewType usage
    
    * Fix Role.TOOL and Role.ASSISTANT usage in _orchestrator_helpers.py
    
    * Fix Role NewType usage in durabletask _models.py
  • Python: Fix broken Content API imports in Python samples (#3639)
    * Initial plan
    
    * Fix broken import paths for Content API in all Python sample files
    
    Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>
    
    ---------
    
    Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
    Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>
  • [BREAKING] Python: Add factory pattern to GroupChat and Magentic (#3224)
    * group chat
    
    * magentic
    
    * Fix tests
    
    * AI comments
    
    * Unifiy error message and add warning
    
    * misc
    
    * Add overload
    
    * Collapse orchestrator params
  • Python: [BREAKING] changed AIFunction to FunctionTool and @ai_function to @tool (#3413)
    * changed AIFunction to FunctionTool and @ai_function to @tool
    
    * test and mypy fixes
    
    * mypy fix
    
    * switch function tool to always_require
    
    * fix noop
    
    * fix github copilot imports
    
    * test fixes
    
    * fix ollama test
    
    * fixes for tests
    
    * fix tests
    
    * reverted change to always_require and extended timeout
    
    * fix test
  • Python: [BREAKING] Renamed create_agent to as_agent (#3249)
    * Renamed create_agent to as_agent
    
    * Override for as_agent
    
    * Added override
  • [BREAKING] Python: Refactor orchestrations (#3023)
    * Group chat refactoring Part 1; Next: HIL and handoff
    
    * Add agent approval flow; next samples
    
    * WIP: samples
    
    * WIP: HIL samples
    
    * Group chat HIL working; next: handoff
    
    * Fix group chat tool approval sample
    
    * WIP: refactor handoff; next handoff handling
    
    * Handoff done; next handoff samples and concurrent and sequential
    
    * Handoff samples, concurrent, and sequential done; next Magentic
    
    * WIP: magentic; next test with samples + HIL
    
    * Magentic Working; next fix all samples and tests
    
    * Fix handoff samples; next tests
    
    * WIP: fixing tests; some orchestration as agent samples are failing
    
    * Group chat unit tests done
    
    * Handoff  unit tests done
    
    * Remove old orchestration_request_info and fix related tests
    
    * Magentic unit tests done
    
    * Fix samples
    
    * Fix test
    
    * Fix test 2
    
    * mypy
    
    * Address comments
    
    * Update readme
    
    * Address comments
    
    * Address comments 2
    
    * Replace display name
  • [BREAKING] Python: Add factory pattern to handoff orchestration builder (#2844)
    * WIP: Factory pattern to handoff
    
    * Add factory pattern to concurrent orchestration builder; Next: tests and sample verification
    
    * Add tests and improve comments
    
    * Fix mypy
    
    * Simplify handoff_simple.py
    
    * Simplify handoff_autonoumous.py and bug fix
    
    * Update readme
    
    * Address Copilot comments
  • Python: Add factory pattern to concurrent orchestration builder (#2738)
    * Add factory pattern to concurrent orchestration builder
    
    * Update readme
    
    * Address AI comments
    
    * Fix unit tests
    
    * Fix import
    
    * Prevent multiple calls to set participants or factories
    
    * Add comments
    
    * Mitigate warnings
    
    * Fix mypy
    
    * Address comments
    
    * Address Copilot comments
    
    * Fix tests
  • Python: Add factory pattern to sequential orchestration builder (#2710)
    * Add factory pattern to sequential orchestration builder
    
    * Use temp list to avoid override
    
    * Add sample and some other fixes
    
    * Fix comments
    
    * Small fix
    
    * Update readme
  • Python: Support an autonomous handoff flow (#2497)
    * Support an autonomous handoff flow.
    
    * Simplify public API
    
    * Address feedback
  • Python [BREAKING]: support magentic agent tool call approvals and plan stalling HITL behavior (#2569)
    * Provide way for HITL with magentic
    
    * support tool call approvals and hitl stall replan
    
    * human plan intervention sample
    
    * Clean up
    
    * Improve loging
    
    * updates
  • [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
  • [BREAKING] Python: Adjust magentic event types raised. No need for custom events. (#2215)
    * Adjust magentic event types raised. No need for custom events.
    
    * Cleanup
    
    * Fix test
    
    * Update python/packages/core/agent_framework/_workflows/_magentic.py
    
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
    
    ---------
    
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  • Python: Fix the example of multi-tier handoff workflow with specialist-to-specialist routing (#2332)
    * Fix the example (1) to send only one initial message (2) to end conversation after trigger the last response as the comment describes
    
    * Apply suggestions from code review
    
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
    
    * changed the hard-coded user query
    
    ---------
    
    Co-authored-by: tsuting.kao <tsu.kao@microsoft.com>
    Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  • Python: Fix underlying tool choice bug and all for return to previous Handoff subagent (#2037)
    * Fix tool_choice override bug and add enable_return_to_previous support
    
    * Add unit test for handoff checkpointing
    
    * Handle tools when we have them
  • Python: [BREAKING] consolidate workflow run APIs (#1723)
    * consolidate workflow run apis
    
    * improve validation, add tests
    
    * Proper code tags for docs
    
    * Update sample output
    
    * Remove cycle validation
    
    * PR feedback
    
    * Validation
    
    * Cleanup
  • [BREAKING] Python: Replace RequestInfoExecutor with request_info API and @response_handler (#1466)
    * Prototype: Add request_info API and @response_handler
    
    * Add original_request as a parameter to the response handler
    
    * Prototype: request interception in sub workflows
    
    * Prototype: request interception in sub workflows 2
    
    * WIP: Make checkpointing work
    
    * checkpointing with sub workflow
    
    * Fix function executor
    
    * Allow sub-workflow to output directly
    
    * Remove ReqeustInfoExecutor and related classes; Debugging checkpoint_with_human_in_the_loop
    
    * Fix Handoff and sample
    
    * fix pending requests in checkpoint
    
    * Fix unit tests
    
    * Fix formatting
    
    * Resolve comments
    
    * Address comment
    
    * Add checkpoint tests
    
    * Add tests
    
    * misc
    
    * fix mypy
    
    * fix mypy
    
    * Use request type as part of the key
    
    * Log warning if there is not response handler for a request
    
    * Update Internal edge group comments
    
    * REcord message type in executor processing span
    
    * Update sample
    
    * Improve tests
  • Python: [BREAKING] Python: Intro group chat and refactor orchestrations. Fix as_agent(). Standardize orchestration start msg types. (#1538)
    * Intro group chat and refactor magentic. Fix as_agent()
    
    * Cleanup and improvements
    
    * Add as_agent docstring clarification
    
    * Standardize orchestration messages to use agent-style inputs.
    
    * Simplify group chat constructs
    
    * Further cleanup
    
    * Add sk to af group chat migration sample. Update README.
    
    * Improvements and simplifications
    
    * consolidating shared orchestration logic
    
    * Further clean up
    
    * Add group chat sample
    
    * Improve typing
    
    * Fix test imports
    
    * Fix readme links
    
    * Cleanup per PR Feedback
  • Python: Add Handoff orchestration pattern support (#1469)
    * Add Handoff orchestration pattern support
    
    * PR feedback
    
    * Use AOAI client in samples
    
    * Adjust to tool
    
    * Handoff to sub-agent via ai function
    
    * PR feedback
    
    * More cleanup
    
    * Improvements
    
    * PR feedback cleanup
    
    * Add handoff migration sample.
    
    * Remove type ignore
    
    * fix markdown link formatting
    
    * Remove readme link for non-existent sample
  • Python: [BREAKING] added SerializationMixin and applied to contents, agents, chat client… (#1012)
    * added SerializationMixin and applied to contents, agents, chat clients, removed AFBaseModel
    
    * fix annotations type
    
    * mypy fixes
    
    * fix tests
    
    * fix serializable subvalues and added large docstring
    
    * updated indents in code block
    
    * fixed exported urls
  • Python: [BREAKING] Python: Rename workflow to workflows (#1007)
    * Rename workflow to workflows
    
    * Update occurence of workflow to new name