Commit Graph

18 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 explicit input, output, and workflow_output parameters to @handler, @executor and request_info (#3472)
    * Support specifying types via handler and executor decorators
    
    * Add handling for string types
    
    * Fix typing
    
    * Address PR feedback
    
    * All or nothing for handler typing approach
    
    * Fix mypy issues
    
    * type support for request info
    
    * Fix naming issue
    
    * Fix mypy
  • Python: Replaced obsolete create_response method in samples (#3542)
    * Replaced obsolete create_response method in samples
    
    * Addressed PR comments
  • 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
  • Python: Fix context duplication in handoff workflows when restoring from checkpoint (#2867)
    * Fix context duplication in handoff workflows when restoring from checkpoint
    
    * Address Copilot PR review
  • 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: Add Handoff + tool approval + checkpointing sample (#2346)
    * Handoff sample
    
    * handoff with tool approval
    
    * add Hanoff sample with tool approval and checkpointing
    
    * Add to README
    
    * Remove unnecessary files
    
    * Update python/samples/getting_started/workflows/checkpoint/handoff_with_tool_approval_checkpoint_resume.py
    
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
    
    * Fix comment
    
    ---------
    
    Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  • Python: Add checkpoint save and restore hooks to executor (#2097)
    * Add checkpoint hooks
    
    * Deprecate get_executor_state and set_executor_state
    
    * Fix tests and samples
    
    * Add doc strings
    
    * Add sample
    
    * Fix import
    
    * Address comments and fix tests
    
    * Address comments
    
    * conditional import
  • 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
  • [BREAKING] Python: Refactor Checkpointing for runner and runner context (#1645)
    * Refactor Checkpointing for runner and runner context
    
    * exception
    
    * Fix formatting
    
    * Comments
    
    * rename
    
    * Add detailed doc string
  • Python: Refactor RequestInfoExecutor (#1403)
    * Refactor RequestInfoExecutor
    
    * Update AI script
    
    * Fix formatting
    
    * Address comments
    
    * fix unit test
  • Python: [BREAKING] Python: Rename workflow to workflows (#1007)
    * Rename workflow to workflows
    
    * Update occurence of workflow to new name