Commit Graph

29 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: Add sample on how to share a thread between agents in a workflow (#3405)
    * Add sample on how to share a thread between agents in a workflow
    
    * Fix sample
    
    * Fix formatting
    
    * Comments
    
    * comment
  • [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] Simplified Content types to a single class with classmethod constructors. (#3252)
    * ported Content to a new model
    
    * fixed linting
    
    * fixes
    
    * fixed data format handling
    
    * fix for 3.10 mypy
    
    * fix
    
    * fix int test
  • Python: [BREAKING] Renamed create_agent to as_agent (#3249)
    * Renamed create_agent to as_agent
    
    * Override for as_agent
    
    * Added override
  • Python: Properly configure structured outputs based on new options dict (#3213)
    * Properly configure structured outputs based on new options dict
    
    * Fix mypy
  • [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
  • Python: [BREAKING]: Introducing Options as TypedDict and Generic (#3140)
    * WIP typeddict for options
    
    * updated all clients and ChatAgents
    
    * updated everything
    
    * added ADR
    
    * fix mypy
    
    * proper typevar imports
    
    * fixed import
    
    * fixed other imports
    
    * slight update in the sample
    
    * updated from feedback
    
    * fixes
    
    * fixed missing covariants and test fixes
    
    * fixed typing
    
    * updated anthropic thinking config
    
    * ruff fixes
    
    * fixed int tests
    
    * fix tests and mypy
    
    * updated integration tests
    
    * updated docstring and test fix
    
    * improved options handling in obser
    
    * mypy fix
    
    * updated a host of integration tests
    
    * fix tests
    
    * bedrock fix
  • Python: Fix WorkflowAgent event handling and kwargs forwarding (#2946)
    * Fix kwargs propagation through workflow.as_agent()
    
    * Fix WorkflowAgent to respect AgentExecutor output_response setting
  • Python: Support an autonomous handoff flow (#2497)
    * Support an autonomous handoff flow.
    
    * Simplify public API
    
    * Address feedback
  • Python: WorkflowBuilder registry (#2486)
    * Add workflow builder factory pattern
    
    * Add internal edge groups to registered executors; next samples
    
    * Update samples: Part 1
    
    * register -> register_executor
    
    * update hil samples
    
    * Update other samples
    
    * Update agent  samples
    
    * Update doc string
    
    * Add new sample
    
    * Fix mypy
    
    * Address comments
    
    * Fix mypy
  • 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
  • Python: Add sample to show handoff as agent with HITL (#2534)
    * Add sample to show handoff as agent with HITL
    
    * Update uv.lock with latest pkg versions. Fix lint error.
    
    * Upgrade grpcio to 1.76.0
    
    * Handle grpcio versions
    
    * Case insensitive compare for declarative
  • [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>
  • Add simple workflow sample that mixes agents and executors (#1946)
    * Add workflow mix agent executor samples
    
    * Apply suggestion from @Copilot
    
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
    
    ---------
    
    Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  • 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: Remove request_type param from ctx.request_info() (#1824)
    * Remove request_type param from ctx.request_info()
    
    * Address comments
  • [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: Remove deprecated add_agent() calls from workflow samples (#1508)
    * Initial plan
    
    * Remove add_agent calls from workflow samples
    
    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>
  • Python: Refactor RequestInfoExecutor (#1403)
    * Refactor RequestInfoExecutor
    
    * Update AI script
    
    * Fix formatting
    
    * Address comments
    
    * fix unit test
  • Python: fix tool call content not showing up in workflow events (#1290)
    * fix tool call content not showing up in workflow events
    
    * fix lint
    
    * touch up
    
    * add another sample to show function bridge
    
    * missing sample
  • Python: Introduce add_agent functionality and added output_response to AgentExecutor; agent streaming behavior to follow workflow invocation (#1184)
    * refactor AgentExecutor, add output_response flag for switching on or off workflow output for each agent.
    
    * introduce add_agent
    
    * make default agent's streaming to false
    
    * address comments
    
    * fix test
    
    * add is_streaming to RunnerContext and WorkflowContext
    
    * fix add_agent return
    
    * fix tests
    
    * address comments
    
    * resolve conflict
    
    * update to address comments
    
    * fix
  • 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