211 Commits

• Python: Forward runtime kwargs to skill resource functions (#4417)

  * support code skills
  
  * address pr review comments
  
  * address package and syntax checks
  
  * address pr review comments
  
  * address pr review comment
  
  * address failed check
  
  * rename agentskill and agetnskillprovider
  
  * move agent skills related assets to _skills.py
  
  * address pr review comments
  
  * address review comments
  
  * support kwargs
  
  * address pr review feedback

  SergeyMenshykh · 2026-03-05 18:01:25 +00:00
  8bf4235f4e
• Python: Fix Python pyright package scoping and typing remediation (#4426)

  * Fix Python pyright package scoping and typing remediation
  
  Implements issue #4407 by removing the root pyright include, adding package-level pyright includes, and resolving pyright/mypy typing issues across Python packages. Also cleans unnecessary casts and applies line-level, rule-specific ignores where external libraries are too dynamic.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Reduce pyright cost in handoff cloning
  
  Simplify cloned_options construction in HandoffAgentExecutor to avoid expensive TypedDict narrowing/inference in _handoff.py, which was causing pyright to spend a long time in orchestrations.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix types
  
  * Fix lint and type-check regressions
  
  Resolve current Python package check failures across lint, pyright, and mypy after recent code changes, including purview/declarative pyright issues and multiple ruff simplification findings.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fixed hooks
  
  * Stabilize package tests and test tasks
  
  Resolve cross-package non-integration test failures, simplify streaming type flow, harden locale/culture handling, and standardize package test poe tasks to exclude integration tests where applicable.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * lots of small fixes
  
  * Fix current Python test regressions
  
  Address current failing unit tests in azure-ai, bedrock, and azure-cosmos while keeping Bedrock parsing logic inline (no new static helper methods).
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * small fixes
  
  * small fixes
  
  * removed pydantic from json
  
  * final updates
  
  * fix core
  
  * fix tests
  
  * fix obser
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-03-05 15:32:24 +00:00
  55ddd841b7
• Python: Add propagate_session to as_tool() for session sharing in agent-as-tool scenarios (#4439)

  * Python: Add propagate_session parameter to as_tool() for session sharing
  
  Add opt-in session propagation in agent-as-tool scenarios. When
  propagate_session=True, the parent agent's AgentSession is forwarded
  to the sub-agent's run() call, allowing both agents to share session
  state (history, metadata, session_id).
  
  - Add propagate_session parameter to BaseAgent.as_tool() (default False)
  - Include session in additional_function_arguments so it flows to tools
  - Add 3 tests for propagation on/off and shared state verification
  - Add sample showing session propagation with observability middleware
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Clarify propagate_session docstring per review feedback
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Giles Odigwe · 2026-03-04 23:14:17 +00:00
  d02051dbb6
• Python: [BREAKING] Support code-defined agent skills (#4387)

  * support code skills
  
  * address pr review comments
  
  * address package and syntax checks
  
  * address pr review comments
  
  * address pr review comment
  
  * address failed check
  
  * rename agentskill and agetnskillprovider
  
  * move agent skills related assets to _skills.py
  
  * address pr review comments
  
  * address review comments

  SergeyMenshykh · 2026-03-04 18:36:02 +00:00
  4dad26fcae
• Python: Fix MCP tools duplicated on second turn when runtime tools are present (#4432)

  * Fix MCP tools duplicated on second turn when runtime tools are present
  
  When AG-UI's collect_server_tools pre-expands MCP functions on turn 2
  (after the MCP server is connected), _prepare_run_context unconditionally
  appends them again from self.mcp_tools, duplicating every MCP tool.
  
  Skip MCP functions whose names already exist in the final tool list,
  following the same name-based dedup pattern used in _merge_options.
  
  Fixes #4381
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * mypy fix
  
  * Remove issue-specific references from test docstring
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Giles Odigwe · 2026-03-04 00:21:01 +00:00
  b0ac3939c1
• Python: Fix: Parse oauth_consent_request events in Azure AI client (#4197)

  * Fix: Parse oauth_consent_request events in Azure AI client (#3950)
  
  When Azure AI Agent Service returns an oauth_consent_request output item
  for OAuth-protected MCP tools, the base OpenAI responses parser drops it
  (hits case _ default branch). This causes agent runs to complete silently
  with zero content.
  
  Changes:
  - Add oauth_consent_request ContentType and Content.from_oauth_consent_request()
    factory with consent_link field and user_input_request=True
  - Override _parse_response_from_openai and _parse_chunk_from_openai in
    RawAzureAIClient to intercept Azure-specific oauth_consent_request items
  - Add _emit_oauth_consent helper in AG-UI to emit CustomEvent for frontends
  - Add tests proving base parser drops the event and Azure AI override catches it
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * addressed comment
  
  * addressed comments
  
  * addressed comments
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Giles Odigwe · 2026-03-03 23:02:03 +00:00
  2b3c401848
• Python: Fix workflow tests pyright warnings (#4362)

  * Fix workflow tests pyright warnings
  
  * Update uv.lock
  
  * Fix pyright
  
  * Comments
  
  * Update root pyproject pyright setting
  
  * Update core pyproject pyright setting
  
  * Update core pyproject pyright setting

  Tao Chen · 2026-03-03 21:52:05 +00:00
  1a8729d5a7
• Python: Added Shell tool (#4339)

  * Added shell tool
  
  * Fixed CI error
  
  * Add ShellTool support for OpenAI and Anthropic providers
  
  - Add shell_tool_call, shell_tool_result, and shell_command_output content types
  - Add ShellTool class and shell_tool decorator to core
  - Add get_hosted_shell_tool() to OpenAI Responses client
  - Handle shell_call and shell_call_output parsing in OpenAI (sync and streaming)
  - Map ShellTool to Anthropic bash tool API format
  - Parse bash_code_execution_tool_result as shell_tool_result in Anthropic
  - Add unit tests for all new functionality
  - Add sample scripts for hosted and local shell execution
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Addressed comments
  
  * Reverted ruff change
  
  * Fixed tests
  
  * Addressed comments
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Dmytro Struk · 2026-03-03 16:22:15 +00:00
  1c0ae4b659
• Python: Fix IndexError when reasoning models produce reasoning-only messages in Magentic-One workflow (#4413)

  * Fix IndexError when reasoning models return no text content (#4384)
  
  In _prepare_message_for_openai(), the text_reasoning case unconditionally
  accessed all_messages[-1] to attach reasoning_details. When a reasoning
  model (e.g. gpt-5-mini) returns reasoning_details without text content,
  all_messages is empty, causing an IndexError.
  
  Guard the access by initializing all_messages with the current args dict
  when it is empty, so reasoning_details can be safely attached.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address review: buffer reasoning details for valid message payloads (#4384)
  
  - Buffer pending reasoning details and attach to the next message with
    content/tool_calls, avoiding standalone reasoning-only messages.
  - When reasoning is the only content, emit a message with empty content
    to satisfy Chat Completions schema requirements.
  - Strengthen test assertions to verify text+reasoning co-location and
    that all messages with reasoning_details also have content or tool_calls.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix text_reasoning handling: always buffer and tighten tests (#4384)
  
  - Always buffer reasoning into pending_reasoning instead of conditionally
    attaching to the previous message via fragile all_messages emptiness check
  - Attach buffered reasoning to last message at end-of-loop when no subsequent
    content consumed it
  - Assert exact content values (content == '' not in ('', None))
  - Assert exact list lengths (== 1 not >= 1) for stronger regression guards
  - Add test for reasoning before FunctionCallContent
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Apply pre-commit auto-fixes
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-03-03 16:13:24 +00:00
  dae3caa719
• Python: fix(python): Handle thread.message.completed event in Assistants API streaming (#4333)

  * fix: handle thread.message.completed event in Assistants API streaming
  
  Previously, `thread.message.completed` events fell through to the
  catch-all `else` branch and yielded empty `ChatResponseUpdate` objects,
  silently discarding fully-resolved annotation data (file citations,
  file paths, and their character-offset regions).
  
  This commit adds a dedicated handler for `thread.message.completed`
  that:
  - Walks the completed ThreadMessage.content array
  - Extracts text blocks with their fully-resolved annotations
  - Maps FileCitationAnnotation and FilePathAnnotation to the
    framework's Annotation type with proper TextSpanRegion data
  - Yields a ChatResponseUpdate containing the complete text and
    annotations
  
  Fixes #4322
  
  * test: add tests for thread.message.completed annotation handling
  
  Tests cover:
  - File citation annotation extraction
  - File path annotation extraction
  - Multiple annotations on a single text block
  - Text-only messages (no annotations)
  - Non-text blocks are skipped
  - Mixed content blocks (text + image)
  - Conversation ID propagation
  
  * fix: address Copilot review - add quote field and log unrecognized annotations
  
  - Include `quote` from `annotation.file_citation.quote` in
    `additional_properties` for FileCitationAnnotation, preserving the
    exact cited text snippet from the source file
  - Add `else` clause to log unrecognized annotation types at debug level,
    consistent with the pattern in `_responses_client.py`
  - Add `import logging` and module-level logger
  
  * test: add coverage for quote field and unrecognized annotation logging
  
  - test_message_completed_with_file_citation_quote: verifies quote is
    included in additional_properties
  - test_message_completed_with_file_citation_no_quote: verifies quote
    is omitted when None
  - test_message_completed_unrecognized_annotation_logged: verifies
    unknown annotation types are logged at debug level and skipped
  
  * fix: address reviewer nits — logger name convention + annotation type string
  
  Per @giles17's review:
  - Use logging.getLogger('agent_framework.openai') to match module convention
  - Simplify debug message to use annotation.type instead of type().__name__
  
  * refactor: move message.completed tests into consolidated test file
  
  Per @giles17's review: moved all tests from test_assistants_message_completed.py
  into test_openai_assistants_client.py and deleted the standalone file.
  
  * fix: resolve mypy no-redef and ruff RET504 lint errors
  
  - Remove duplicate type annotation for 'ann' variable (no-redef)
  - Return directly from fixture instead of unnecessary assignment (RET504)
  
  * fix: rename annotation variable in completed block to fix mypy type conflict
  
  The 'annotation' loop variable in thread.message.completed has type
  FileCitationAnnotation | FilePathAnnotation, which conflicts with the
  delta block's 'annotation' of type FileCitationDeltaAnnotation |
  FilePathDeltaAnnotation. Renamed to 'completed_annotation' to avoid
  mypy 'Incompatible types in assignment' error.
  
  * fix: remove quote field from FileCitationAnnotation handling
  
  ---------
  
  Co-authored-by: Giles Odigwe <79032838+giles17@users.noreply.github.com>

  L. Elaine Dazzio · 2026-03-03 04:07:00 +00:00
  869e51fdce
• Python: Fix walrus operator precedence for model_id kwarg in AzureOpenAIResponsesClient (#4310)

  * Fix walrus operator precedence for model_id in AzureOpenAIResponsesClient (#4299)
  
  Add parentheses around the walrus assignment so model_id receives the
  actual string value instead of the boolean result of
  `kwargs.pop(...) and not deployment_name`.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address review: replace walrus with explicit None check, add edge-case tests (#4299)
  
  - Replace walrus operator with explicit assignment and 'is not None'
    check to avoid boolean-coercion pitfalls (empty string now correctly
    surfaces as ValueError instead of silently falling back)
  - Add test: deployment_name takes precedence over model_id kwarg
  - Add test: model_id='' raises ValueError
  - Add test: model_id=None falls back to env var
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add explicit validation for empty model_id in AzureOpenAIResponsesClient
  
  Reject empty or whitespace-only model_id with ValueError instead of
  silently passing an empty deployment name downstream. This ensures the
  test_init_model_id_kwarg_empty_string test correctly validates behavior
  defined in production code rather than relying on downstream validation.
  
  Addresses PR review feedback for #4299.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Simplify model_id handling using walrus operator
  
  Addresses review comment on PR #4310.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Restore explicit model_id validation to fix test failures (#4299)
  
  The walrus operator refactor silently dropped the empty-string validation,
  causing test_init_model_id_kwarg_empty_string to fail. Restore the explicit
  None check and ValueError raise for empty model_id.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Revert "Restore explicit model_id validation to fix test failures (#4299)"
  
  This reverts commit 1d2965fff6.
  
  * Revert to walrus operator fix per review feedback
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-03-02 14:06:58 +00:00
  c4f643a750
• Python: Fix executor handler type resolution when using from __future__ import annotations (#4317)

  * Python: Fix Executor handler type checking with __future__ annotations (#3898)
  
  Use typing.get_type_hints() in _validate_handler_signature to resolve
  string annotations from `from __future__ import annotations`. This
  mirrors the fix applied to FunctionExecutor in #2308.
  
  When __future__ annotations are enabled, type annotations are stored as
  strings. The handler decorator was passing these strings directly to
  validate_workflow_context_annotation, which uses typing.get_origin and
  returns None for strings, causing a ValueError.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review feedback for #3898: improve error handling and test coverage
  
  - Wrap typing.get_type_hints() in try/except to provide a descriptive
    ValueError mentioning the handler name when annotations cannot be resolved
  - Strengthen bare context test to assert output_types and workflow_output_types
  - Add test for @handler(input=..., output=...) with future annotations
    covering the skip_message_annotation branch
  - Add test for union-type context annotations with future annotations
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Narrow exception catch and add test for unresolvable annotations (#3898)
  
  - Narrow except clause from bare Exception to (NameError, AttributeError,
    TypeError) to avoid masking unexpected errors.
  - Add test_handler_unresolvable_annotation_raises to verify that a handler
    with a forward-reference to a non-existent type raises ValueError with
    the expected message.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix #3898: fall back to raw annotations when get_type_hints fails
  
  When typing.get_type_hints(func) raises NameError (unresolvable forward
  ref), AttributeError, RecursionError, or any other exception, fall back
  to the raw parameter annotations instead of raising a ValueError.
  This matches the suggestion from @moonbox3 on PR #4317.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix test to match new fallback behavior when get_type_hints fails (#3898)
  
  The code now falls back to raw string annotations instead of raising
  'Failed to resolve type annotations'. A ValueError is still raised when
  the raw string ctx annotation is not a valid WorkflowContext type, so
  update the test to match on ValueError without checking the message.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Apply pyupgrade: remove unnecessary string annotation quote
  
  * Add noqa for intentionally undefined name in annotation test
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-27 02:59:57 +00:00
  0d6b9d61a5
• Python: Fix agent option merge to support dict-defined tools (#4314)

  * Fix _merge_options dropping dict-defined tools (#4303)
  
  _merge_options used getattr(tool, 'name', None) to de-duplicate tools,
  which returns None for dict-style tool definitions. This caused all
  override dict tools to be treated as duplicates of each other and of any
  base dict tools, silently dropping them.
  
  Add _get_tool_name() helper that extracts the name from both object-style
  tools (via .name attribute) and dict-style tools (via tool['function']['name']).
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address review: fix None dedup bug and add comprehensive tests (#4303)
  
  - Exclude None from existing_names set so nameless/malformed tools are
    not silently deduplicated against each other
  - Add test for cross-type dedup (dict tool + object tool with same name)
  - Add test verifying nameless tools are preserved (not falsely deduped)
  - Add unit tests for _get_tool_name edge cases: missing function key,
    non-dict function value, missing name, no name attribute, non-dict
    inputs, and valid dict/object tools
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 22:09:36 +00:00
  54c0bea3b6
• Python: Fix single-tool input handling in OpenAIResponsesClient._prepare_tools_for_openai (#4312)

  * Fix OpenAIResponsesClient mishandling single-tool inputs (#4304)
  
  Use normalize_tools() in _prepare_tools_for_openai to wrap single tools
  (FunctionTool or dict) in a list before iteration, consistent with the
  chat client implementation.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review feedback for #4304
  
  - Use precise type annotation matching normalize_tools/OpenAIChatClient signature
    instead of collapsed Sequence[Any] | Any | None
  - Move emptiness guard after normalize_tools() call so single falsy tool
    objects are not silently swallowed
  - Import ToolTypes for the type annotation
  - Expand test_prepare_tools_for_openai_single_function_tool assertions to
    verify parameters, strict, and parameter schema fields
  - Add test_prepare_tools_for_openai_none to verify None input returns []
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 22:09:28 +00:00
  ff124c44a9
• Python: Fix WorkflowAgent not persisting response messages to session history (#1694) (#4319)

  WorkflowAgent._run_impl() and _run_stream_impl() did not set
  session_context._response before calling _run_after_providers().
  This caused InMemoryHistoryProvider.after_run() to see context.response
  as None, so response messages were never stored in the session.
  
  On subsequent runs, the workflow only received prior user inputs without
  assistant responses, breaking multi-turn conversations.
  
  Fix: Set session_context._response to the workflow result before running
  after_run providers, matching the behavior of the regular Agent class.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 22:07:58 +00:00
  6f7e55c430
• Python: Map file citation annotations from TextDeltaBlock in Assistants API streaming (#4316) (#4320)

  During Assistants API streaming, TextDeltaBlock.text.annotations was
  ignored when creating Content objects. This caused raw placeholder
  strings like 【4:0†source】 to pass through to downstream consumers
  (including AG-UI) instead of being resolved to citation metadata.
  
  Map FileCitationDeltaAnnotation and FilePathDeltaAnnotation from
  delta_block.text.annotations to Annotation objects on the Content,
  consistent with the existing patterns in _responses_client.py and
  _chat_client.py.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 22:07:23 +00:00
  e0461b42c1
• Python: Preserve workflow run kwargs when continuing with run(responses=...) (#4296)

  * fix(python): preserve workflow run kwargs on response continuation (#4293)
  
  When continuing a paused workflow with run(responses=...), the existing
  run kwargs stored in state were unconditionally overwritten with an empty
  dict. This caused subsequent agent invocations to lose the original run
  context (e.g., custom_data, user tokens).
  
  Now kwargs are only overwritten when:
  - New kwargs are explicitly provided (override), or
  - State was just cleared for a fresh run (initialize to {})
  
  On continuation without new kwargs, existing kwargs are preserved.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review feedback for #4293
  
  - Use consistent get_state(key, {}) default pattern in _agent_executor.py
    and _workflow_executor.py instead of get_state(key) or {} to safely
    handle missing WORKFLOW_RUN_KWARGS_KEY
  - Add test for empty-value kwargs on continuation (custom_data={}) to
    verify the is-not-None boundary between overwrite and preserve
  - Add test for reset_context=True with no kwargs to exercise the elif
    branch that initializes WORKFLOW_RUN_KWARGS_KEY to {}
  - Add len assertion to override test for consistency
  - Document kwargs-collapsing behavior at the public API call site
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 20:57:04 +00:00
  b46fe1c82e
• Python: Strip reserved kwargs in AgentExecutor to prevent duplicate-argument TypeError (#4298)

  * Python: Strip reserved kwargs in AgentExecutor to prevent collision (#4295)
  
  workflow.run(session=...) passed 'session' through to agent.run() via
  **run_kwargs while AgentExecutor also passes session=self._session
  explicitly, causing TypeError: got multiple values for keyword argument.
  
  _prepare_agent_run_args now strips reserved params (session, stream,
  messages) from run_kwargs and logs a warning when they are present.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review feedback for #4295
  
  - Use _RESERVED_RUN_PARAMS constant in stripping loop instead of
    hardcoded tuple to maintain single source of truth
  - Trim frozenset to only stripped keys (session, stream, messages);
    options and additional_function_arguments have separate merge logic
  - Fix caplog type annotation to use TYPE_CHECKING pattern
  - Assert options return value in reserved-kwarg stripping test
  - Add test for multiple reserved kwargs supplied simultaneously
  - Add integration test for messages= kwarg via workflow.run()
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 20:53:20 +00:00
  823e714ccf
• Python: Fix response_format resolution in streaming finalizer (#4291)

  * Python: Fix AgentResponse.value being None when streaming workflow (#3970)
  
  The streaming path in BaseAgent.run() used the raw 'options' parameter
  (passed by the caller) to bind response_format into the outer stream's
  finalizer. When response_format was set in default_options rather than
  runtime options, it was missing from the finalizer and value was None.
  
  Fix: Use the merged chat_options from the run context (via ctx_holder),
  matching the non-streaming path which already uses ctx['chat_options'].
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address review feedback for #3970: safer ctx access, add test coverage
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Evan Mattson · 2026-02-26 18:28:14 +00:00
  a033721ac2
• Python: Fix Bedrock embedding test stub missing meta attribute (#4287)

  * Fix Bedrock embedding test stub missing meta attribute
  
  * Increase test coverage so gate passes

  Evan Mattson · 2026-02-26 11:50:40 +09:00
  02ba27493c
• Update Python package versions to rc2 (#4258)

  - Bump core and azure-ai to 1.0.0rc2
  - Bump preview packages to 1.0.0b260225
  - Update dependencies to >=1.0.0rc2
  - Add CHANGELOG entries for changes since rc1
  - Update uv.lock
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Dmytro Struk · 2026-02-25 19:37:44 +00:00
  7d56a5a4d6
• Python: Phase 2: Embedding clients for Ollama, Bedrock, and Azure AI Inference (#4207)

  * Phase 2: Embedding clients for Ollama, Bedrock, and Azure AI Inference
  
  Add embedding client implementations to existing provider packages:
  
  - OllamaEmbeddingClient: Text embeddings via Ollama's embed API
  - BedrockEmbeddingClient: Text embeddings via Amazon Titan on Bedrock
  - AzureAIInferenceEmbeddingClient: Text and image embeddings via Azure AI
    Inference, supporting Content | str input with separate model IDs for
    text (AZURE_AI_INFERENCE_EMBEDDING_MODEL_ID) and image
    (AZURE_AI_INFERENCE_IMAGE_EMBEDDING_MODEL_ID) endpoints
  
  Additional changes:
  - Rename EmbeddingCoT -> EmbeddingT, EmbeddingOptionsCoT -> EmbeddingOptionsT
  - Add otel_provider_name passthrough to all embedding clients
  - Register integration pytest marker in all packages
  - Add lazy-loading namespace exports for Ollama and Bedrock embeddings
  - Add image embedding sample using Cohere-embed-v3-english
  - Add azure-ai-inference dependency to azure-ai package
  
  Part of #1188
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix mypy duplicate name and ruff lint issues
  
  - Rename second 'vector' variable to 'img_vector' in image embedding loop
  - Combine nested with statements in tests
  - Remove unused result assignments in tests
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * updates from feedback
  
  * Fix CI failures in embedding usage handling
  
  - Fix Azure AI embedding mypy issues by normalizing vectors to list[float],
    safely accumulating optional usage token fields, and filtering None entries
    before constructing GeneratedEmbeddings
  - Avoid Bandit false positive by initializing usage details as an empty dict
  - Update OpenAI embedding tests to assert canonical usage keys
    (input_token_count/total_token_count)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-25 17:45:08 +00:00
  6138487888
• Python: Support Agent Skills (#4210)

  * Python: Support Agent Skills
  
  Add FileAgentSkillsProvider, a context provider that discovers and exposes
  Agent Skills from filesystem directories following the Agent Skills
  specification (https://agentskills.io/) progressive disclosure pattern:
  advertise, load, read resources.
  
  Changes:
  - FileAgentSkillsProvider - discovers SKILL.md files from configured
    directories, advertises skills via system prompt injection, and provides
    load_skill / read_skill_resource tools for on-demand access.
  - Internal helpers for skill discovery, frontmatter parsing, and secure
    resource reading (path traversal / symlink guards).
  - Unit tests covering discovery, loading, resource reading, and security
    scenarios.
  - Sample (basic_file_skills) demonstrating usage with an expense-report skill.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Python: Move skills sample to samples/02-agents/basic_skills/
  
  Align sample directory name with .NET equivalent (Agent_Step01_BasicSkills).
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix code quality checks
  
  * address pr review comment and code quality check issue
  
  * address pr review comments
  
  * move the sample to the skills folder
  
  * update readme
  
  * reame consts and use types for them
  
  * leverage pathlib for working with files
  
  * refactor the test
  
  * supply schema to functions
  
  * update readme
  
  * update sample name
  
  * address pr review comments
  
  * fix failing lint check
  
  * address failing check
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  SergeyMenshykh · 2026-02-25 13:02:26 +00:00
  4dc35e9bb0
• Python: Fixing issue #1366 - Thread corruption when max_iterations is reached. (#4234)

  * Fix thread corruption when max_iterations exhausted (#1366)
  
  When the function invocation loop exhausts max_iterations while the model
  keeps requesting tools, the failsafe code path (calling the model with
  tool_choice='none' and prepending fcc_messages) was unreachable because
  'if response is not None: return response' short-circuited before it.
  
  The fix removes the premature return so the failsafe always runs after
  loop exhaustion, making a final model call with tool_choice='none' to
  produce a clean text answer and prepending accumulated fcc_messages from
  prior iterations. This matches the existing pattern used by the error
  threshold and max_function_calls paths.
  
  Also unskips test_max_iterations_limit and test_streaming_max_iterations_limit
  which were previously skipped with 'needs investigation in unified API'.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add fix report for issue #1366
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix ruff formatting in _tools.py and test_issue_1366_thread_corruption.py
  
  Apply ruff format to fix multi-line string concatenation and function call
  formatting issues flagged by the linter.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add quality review for issue #1366 fix
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Remove temporary investigation docs.
  
  * Address PR review: explicit enabled check in log condition, clarify mock behavior in test
  
  - Add explicit function_invocation_configuration['enabled'] check to the
    'Maximum iterations reached' log condition in both non-streaming and
    streaming paths, making intent clearer when function invocation is disabled.
  - Add comment in test_thread_safe_after_max_iterations_with_agent explaining
    that the failsafe response (tool_choice='none') is provided automatically
    by the mock client, not from run_responses.
  
  * Blend fix and tests into project without issue-specific callouts
  
  - Remove issue #1366 references from _tools.py comments
  - Move regression tests from standalone test_issue_1366_thread_corruption.py
    into test_function_invocation_logic.py alongside existing max_iterations tests
  - Clean up test docstrings to describe behavior generically
  - Delete the standalone issue-specific test file
  
  ---------
  
  Co-authored-by: alliscode <bentho@microsoft.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Ben Thomas · 2026-02-25 00:58:34 +00:00
  23fe2c16b3
• Python: Fix workflow runner concurrent processing (#4143)

  * Fix workflow runner concurrent processing
  
  * Comments 1
  
  * Add test

  Tao Chen · 2026-02-24 16:36:04 +00:00
  f77f40b987
• Python: updated integration tests and guidance (#4181)

  * updated integration tests and guidance
  
  * fixed merge test
  
  * updated integration tests
  
  * fix: remove duplicate --dist loadfile flag from pytest-xdist config
  
  Only one --dist mode can be active at a time; the second value silently
  overrides the first. Keep --dist worksteal (dynamic load balancing) and
  remove the redundant --dist loadfile from all workflow files and
  pyproject.toml configs.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * docs: add keep-in-sync notes for merge and integration test workflows
  
  Both python-merge-tests.yml and python-integration-tests.yml share the
  same parallel job structure. Added sync reminders in workflow file
  comments, the python-testing SKILL.md, and CODING_STANDARD.md.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * refactor: remove RUN_INTEGRATION_TESTS flag
  
  Integration test gating now uses two mechanisms:
  - `@pytest.mark.integration` for test selection via `-m` filtering
  - `skip_if_*_disabled` for credential/service availability checks
  
  The RUN_INTEGRATION_TESTS env var was redundant since the marker handles
  selection and the skip decorators already check for actual credentials.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: sync missing env vars from merge-tests to integration-tests
  
  Add OPENAI_EMBEDDINGS_MODEL_ID and AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
  to python-integration-tests.yml to match python-merge-tests.yml.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: remove remaining RUN_INTEGRATION_TESTS from embedding tests and docs
  
  Missed test_openai_embedding_client.py and vector-stores README in the
  earlier cleanup.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * set functions tests to 3.10
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-24 09:35:46 +00:00
  acc49196c1
• Python: feat(python): Add embedding abstractions and OpenAI implementation (Phase 1) (#4153)

  * feat(python): Add embedding abstractions and OpenAI implementation (Phase 1)
  
  This PR contains two parts:
  
  1. **Overall migration plan** for porting vector stores and embeddings from
     Semantic Kernel to Agent Framework (docs/features/vector-stores-and-embeddings/README.md)
     covering all 10 phases from core abstractions through connectors and TextSearch.
  
  2. **Phase 1 implementation** — core embedding abstractions and OpenAI/Azure OpenAI
     embedding clients:
  
     Core types (_types.py):
     - EmbeddingGenerationOptions TypedDict (total=False)
     - Embedding[EmbeddingT] generic class with model_id, dimensions, created_at
     - GeneratedEmbeddings[EmbeddingT, EmbeddingOptionsT] list container with options, usage
     - EmbeddingInputT (default str) and EmbeddingT (default list[float]) TypeVars
  
     Protocol + base class (_clients.py):
     - SupportsGetEmbeddings protocol — Generic[EmbeddingInputT, EmbeddingT, OptionsContraT]
     - BaseEmbeddingClient ABC — Generic[EmbeddingInputT, EmbeddingT, OptionsCoT]
  
     Telemetry (observability.py):
     - EmbeddingTelemetryLayer with gen_ai.operation.name = "embeddings"
  
     OpenAI implementation (openai/_embedding_client.py):
     - RawOpenAIEmbeddingClient, OpenAIEmbeddingClient, OpenAIEmbeddingOptions
     - Uses _ensure_client() factory pattern
  
     Azure OpenAI implementation (azure/_embedding_client.py):
     - AzureOpenAIEmbeddingClient following AzureOpenAIChatClient pattern
     - Supports API key, Entra ID credentials, env var configuration
  
     Tests:
     - 47 unit tests for types, protocol, base class, OpenAI, and Azure clients
     - 6 integration tests (gated behind RUN_INTEGRATION_TESTS + credentials)
  
     Samples:
     - samples/02-agents/embeddings/openai_embeddings.py
     - samples/02-agents/embeddings/azure_openai_embeddings.py
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Add AzureOpenAIEmbeddingClient to azure __init__.pyi stub
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * ci: Add embedding env vars to Python integration tests
  
  Map OPENAI_EMBEDDING_MODEL_ID and AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME
  from GitHub vars to the integration test environment.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Handle base64 encoding_format in OpenAI embedding client
  
  When encoding_format='base64' is used, the OpenAI API returns base64-encoded
  floats instead of a JSON array. Decode these automatically to list[float]
  so the return type stays consistent regardless of encoding format.
  
  Also adds a unit test for base64 decoding and fixes minor docstring/import issues.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Only record INPUT_TOKENS for embedding telemetry
  
  Embeddings have no output/completion tokens. Remove OUTPUT_TOKENS recording
  which was double-counting prompt_tokens via the total_tokens fallback.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Resolve mypy variance error and lint warning
  
  Use contravariant/covariant TypeVars for SupportsGetEmbeddings Protocol.
  Combine nested if into single statement in telemetry layer.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Make EmbeddingCoT invariant for mypy compatibility
  
  GeneratedEmbeddings is invariant in its type param, so the Protocol
  TypeVar cannot be covariant.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Address PR review - empty values guard, service_url for telemetry
  
  - Add early return for empty values in get_embeddings to avoid unnecessary API calls
  - Add service_url() method to RawOpenAIEmbeddingClient for proper telemetry endpoint reporting
  - Add test for empty values behavior
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Python: Fix OpenAI chat client compatibility with third-party endpoints and OTel 0.4.14 (#4161)
  
  * Fix system message content sent as list instead of string
  
  Some OpenAI-compatible endpoints (e.g. NVIDIA NIM) reject system messages
  when content is a list of content parts. This change flattens system and
  developer message content to a plain string in the Chat Completions client.
  
  Fixes https://github.com/microsoft/agent-framework/issues/1407
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix compatibility with opentelemetry-semantic-conventions-ai 0.4.14
  
  Version 0.4.14 removed several LLM_* attributes from SpanAttributes
  (LLM_SYSTEM, LLM_REQUEST_MODEL, LLM_RESPONSE_MODEL, LLM_REQUEST_MAX_TOKENS,
  LLM_REQUEST_TEMPERATURE, LLM_REQUEST_TOP_P, LLM_TOKEN_TYPE).
  
  Move these to the OtelAttr enum with their well-known gen_ai.* string values
  and update all references in observability.py and tests.
  
  Fixes https://github.com/microsoft/agent-framework/issues/4160
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Flatten text-only message content to string for all roles
  
  Extend the system/developer fix to all message roles. Text-only content
  lists are now post-processed into plain strings, while multimodal content
  (text + images/audio) remains as a list. This fixes compatibility with
  OpenAI-like endpoints that cannot deserialize list content (e.g. Foundry
  Local's Neutron backend).
  
  Partially fixes https://github.com/microsoft/agent-framework/issues/4084
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix streaming text lost when usage data in same chunk
  
  Some providers (e.g. Gemini) include both usage data and text content
  in the same streaming chunk. The early return on chunk.usage caused
  text and tool call parsing to be skipped entirely. Remove the early
  return and process usage alongside text/tool calls.
  
  Fixes https://github.com/microsoft/agent-framework/issues/3434
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix mypy errors in _chat_client.py
  
  Rename shadowed variable 'args' in system/developer branch to 'sys_args'
  and rename loop variable 'content' to 'msg_content' to avoid type conflict.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * reorder imports
  
  * fix: Use OtelAttr.REQUEST_MODEL instead of removed SpanAttributes.LLM_REQUEST_MODEL
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * docs: Add score_threshold to vector store plan
  
  Reference SK .NET PR #13501 for score threshold filtering semantics.
  Include score_threshold in SearchOptions from Phase 3.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * docs: Add reference to roji's SK .NET MEVD work for SQL connectors
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: Clear env vars in construction tests to avoid CI leakage
  
  Tests for missing API key / model ID now use monkeypatch.delenv to ensure
  env vars from the integration test environment don't prevent the expected
  ValueError from being raised.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-24 07:40:20 +00:00
  6305e3e092
• Python: Add max_function_calls to FunctionInvocationConfiguration (#2329) (#4175)

  * Add max_function_calls to FunctionInvocationConfiguration (#2329)
  
  Add a new per-request max_function_calls setting to FunctionInvocationConfiguration
  that limits the total number of individual function invocations across all iterations
  within a single get_response call. This complements max_iterations (which limits LLM
  roundtrips) by providing a hard cap on actual tool executions regardless of parallelism.
  
  - Add max_function_calls field to FunctionInvocationConfiguration (default: None/unlimited)
  - Track cumulative function call count in both streaming and non-streaming tool loops
  - Force tool_choice='none' when the limit is reached
  - Add validation in normalize_function_invocation_configuration
  - Improve docstrings for FunctionInvocationConfiguration, FunctionTool, and @tool
    to clarify semantics of max_iterations vs max_function_calls vs max_invocations
  - Add tests for parallel calls, single calls, unlimited mode, and config validation
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add sample for controlling total tool executions
  
  Showcases all three mechanisms for limiting tool executions:
  1. max_iterations — caps LLM roundtrips
  2. max_function_calls — caps total individual function invocations per request
  3. max_invocations — lifetime cap on a specific tool instance
  Plus a combined scenario demonstrating defense in depth.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Suppress ruff E305/fmt in hosting sample to preserve XML doc tags
  
  The XML snippet tags (# <create_agent> / # </create_agent>) are used for
  docs extraction and must stay adjacent to the code they wrap. Both ruff
  check (E305) and ruff format add blank lines after the function definition,
  pushing the closing tag away. Suppress with ruff: noqa: E305 and fmt: off.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Add per-agent tool wrapping scenario to control_total_tool_executions sample
  
  Show that wrapping the same callable with @tool multiple times creates
  independent FunctionTool instances with separate invocation counters,
  enabling per-agent max_invocations budgets for shared functions.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Clarify max_function_calls is a best-effort limit
  
  The limit is checked after each batch of parallel calls completes, so the
  current batch always runs to completion even if it overshoots the limit.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Address PR review: fix docstring reference, clarify best-effort in sample
  
  - Fix malformed Sphinx :attr: role in FunctionTool docstring — use plain
    backtick reference instead
  - Update sample to say 'best-effort cap' instead of 'hard cap' for
    max_function_calls, noting it's checked between iterations
  - Parametrize pattern is correct (fixture override, matching existing tests)
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * clarify max_invocations limits
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-24 01:00:25 +00:00
  55398e21df
• Python: (ag-ui): Add Workflow Support, Harden Streaming Semantics, and add Dynamic Handoff Demo (#3911)

  * fix Workflow.as_agent() streaming regression in ag-ui
  
  * Address PR feedback
  
  * workflows wip
  
  * wip
  
  * wip
  
  * Workflow AG-UI demo
  
  * Fixes for handoff workflow demo
  
  * Fixes to workflows support in AG-UI
  
  * Fixes
  
  * Add headers to some demo files
  
  * Fix comment
  
  * Fixes for store
  
  * Make _input_schema lazy-loaded
  
  * fix mypy
  
  * revert session change to handoff only for now
  
  ---------
  
  Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>

  Evan Mattson · 2026-02-23 11:59:56 +00:00
  d8b9409e96
• Python: Fix OpenAI chat client compatibility with third-party endpoints and OTel 0.4.14 (#4161)

  * Fix system message content sent as list instead of string
  
  Some OpenAI-compatible endpoints (e.g. NVIDIA NIM) reject system messages
  when content is a list of content parts. This change flattens system and
  developer message content to a plain string in the Chat Completions client.
  
  Fixes https://github.com/microsoft/agent-framework/issues/1407
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix compatibility with opentelemetry-semantic-conventions-ai 0.4.14
  
  Version 0.4.14 removed several LLM_* attributes from SpanAttributes
  (LLM_SYSTEM, LLM_REQUEST_MODEL, LLM_RESPONSE_MODEL, LLM_REQUEST_MAX_TOKENS,
  LLM_REQUEST_TEMPERATURE, LLM_REQUEST_TOP_P, LLM_TOKEN_TYPE).
  
  Move these to the OtelAttr enum with their well-known gen_ai.* string values
  and update all references in observability.py and tests.
  
  Fixes https://github.com/microsoft/agent-framework/issues/4160
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Flatten text-only message content to string for all roles
  
  Extend the system/developer fix to all message roles. Text-only content
  lists are now post-processed into plain strings, while multimodal content
  (text + images/audio) remains as a list. This fixes compatibility with
  OpenAI-like endpoints that cannot deserialize list content (e.g. Foundry
  Local's Neutron backend).
  
  Partially fixes https://github.com/microsoft/agent-framework/issues/4084
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix streaming text lost when usage data in same chunk
  
  Some providers (e.g. Gemini) include both usage data and text content
  in the same streaming chunk. The early return on chunk.usage caused
  text and tool call parsing to be skipped entirely. Remove the early
  return and process usage alongside text/tool calls.
  
  Fixes https://github.com/microsoft/agent-framework/issues/3434
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix mypy errors in _chat_client.py
  
  Rename shadowed variable 'args' in system/developer branch to 'sys_args'
  and rename loop variable 'content' to 'msg_content' to avoid type conflict.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-23 10:05:36 +00:00
  b1c7c7c844
• Python: fix reasoning model workflow handoff and history serialization (#4083)

  * fix: strip function_call and text_reasoning from cross-agent workflow handoff
  
  When a reasoning model (e.g. gpt-5-mini) runs as Agent 1 in a workflow, its
  response includes text_reasoning items (with server-scoped IDs like rs_XXXX)
  and function_call items. Forwarding these to Agent 2 in a fresh conversation
  caused API errors because the reasoning/call IDs are scoped to the original
  stored response context.
  
  Changes:
  - Strip 'function_call', 'text_reasoning', 'function_approval_request', and
    'function_approval_response' from handoff messages in _agent_executor.py
  - Keep 'function_result' so the actual tool output content is preserved for
    the next agent's context
  - Update unit tests to reflect that function_result messages survive handoff
    (messages grow from 2→3: user, tool(result), assistant(summary))
  - Fix incorrect test assertions in test_function_invocation_stop_clears_*
    that assumed the client layer updates session.service_session_id
  - Also fixed _extract_function_calls to search all messages with call_id
    deduplication, and the error-limit stop path to submit function_call_output
    items before halting (via tool_choice=none cleanup call)
  
  Relates to: https://github.com/microsoft/agent-framework/issues/4047
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix: reasoning model workflow handoff and history serialization
  
  Fixes multiple related issues when using reasoning models (gpt-5-mini,
  gpt-5.2) in multi-agent workflows that chain agents via from_response
  or replay full conversation history via AgentExecutorRequest.
  
  ## Reasoning items always emitted on output_item.added
  
  When a reasoning model produces encrypted or hidden reasoning (no
  visible text), the Responses API still fires a reasoning output item
  without any reasoning_text.delta events. Previously no text_reasoning
  Content was emitted in that case, making it invisible to downstream
  logic. Both the non-streaming (_parse_response_from_openai) and
  streaming (output_item.added) paths now always emit at least one
  text_reasoning Content — with empty text if no content is available —
  so co-occurrence detection and serialization guards work reliably.
  
  ## Reasoning items only serialized when paired with a function_call
  
  The Responses API only accepts reasoning items in input when they
  directly preceded a function_call in the original response. Sending a
  reasoning item that preceded a text response (no tool call) causes:
    "reasoning was provided without its required following item"
  _prepare_message_for_openai now checks has_function_call per message
  and skips text_reasoning serialization when there is no accompanying
  function_call.
  
  ## summary field is an array, not an object
  
  The reasoning item summary field sent to the Responses API must be an
  array of objects ([{"type": "summary_text", "text": ...}]), not a
  single object. Fixed _prepare_content_for_openai accordingly.
  
  ## service_session_id cleared when explicit history is provided
  
  When a workflow coordinator replays a full conversation (including
  function calls from a previous agent run) back to an executor via
  AgentExecutorRequest or from_response, the executor's session still
  held a service_session_id (previous_response_id) from the prior run.
  The API then received the same function-call items twice — once from
  previous_response_id (server-stored) and once from the explicit input —
  causing: "Duplicate item found with id fc_...".
  
  AgentExecutor.run (when should_respond=True) and from_response now
  reset self._session.service_session_id = None before running so that
  explicit input is the sole source of conversation context.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * small improvements in text reasoning
  
  * refactor: add reset_service_session to AgentExecutorRequest for explicit history replay
  
  Replace the implicit 'always clear service_session_id when should_respond=True'
  with an explicit opt-in field on AgentExecutorRequest.
  
  The old approach used should_respond=True as a proxy for 'full history replay',
  but that conflates two distinct intents:
  - Orchestrations group chat sends should_respond=True with an empty/single-message
    list (not a full replay) — unnecessarily clearing service_session_id.
  - HITL / feedback coordinators send the full prior conversation and truly need
    a fresh service session ID to avoid duplicate-item API errors.
  
  Changes:
  - Add AgentExecutorRequest.reset_service_session: bool = False
  - AgentExecutor.run only clears service_session_id when this flag is True
  - AgentExecutor.from_response unchanged (always clears; always full conversation)
  - Set reset_service_session=True in all full-history-replay call sites:
    agents_with_HITL.py, azure_chat_agents_tool_calls_with_feedback.py,
    autogen-migration round-robin coordinator, tau2 runner
  - Update _FullHistoryReplayCoordinator test helper to pass the flag
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * comment update
  
  * fixes from feedback
  
  * fix test
  
  * reverted changes to agent executor
  
  * fix: remove reset_service_session from tau2 runner
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * two other reverts
  
  * fix sample
  
  ---------
  
  Co-authored-by: Giles Odigwe <79032838+giles17@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-19 21:02:20 +00:00
  67ce1baecf
• Python: [BREAKING] Redesign Python exception hierarchy (#4082)

  * [BREAKING] Redesign Python exception hierarchy
  
  Replace the flat ServiceException family with domain-scoped branches:
  - AgentException (with InvalidAuth, InvalidRequest, InvalidResponse, ContentFilter)
  - ChatClientException (same consistent suberrors)
  - IntegrationException (same + InitializationError)
  - WorkflowException (Runner, Convergence, Checkpoint, Validation, Action, Declarative)
  - ContentError (AdditionItemMismatch)
  - ToolException / ToolExecutionException (unchanged)
  - MiddlewareException / MiddlewareTermination (unchanged)
  
  Key changes:
  - All Service* exceptions removed (ServiceException, ServiceInitializationError, etc.)
  - AgentExecutionException split into AgentInvalidRequest/ResponseException
  - AgentInvocationError removed, split into AgentInvalidRequest/ResponseException
  - Workflow exceptions moved from _workflows/_exceptions.py into main exceptions.py
  - _workflows/__init__.py emptied; main __init__.py imports directly from submodules
  - Purview exceptions re-parented under IntegrationException hierarchy
  - Init validation errors use built-in ValueError/TypeError instead of custom exceptions
  - CODING_STANDARD.md updated with hierarchy design and rationale
  
  Fixes microsoft/agent-framework#3410
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Clarify ToolException vs ToolExecutionException docstrings
  
  ToolException: base class for all tool-related exceptions (preconditions,
  connection/init failures).
  ToolExecutionException: runtime call failures (tool call failed, reconnect
  failed, MCP errors).
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix remaining stale imports from agent_framework._workflows
  
  - azurefunctions: _context.py, _app.py, _serialization.py, test_func_utils.py
    used 'from agent_framework._workflows import X' which broke after
    emptying _workflows/__init__.py; changed to direct submodule imports
  - azure-ai-search: test still referenced ServiceInitializationError;
    updated to ValueError to match production code
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-19 17:58:14 +00:00
  5ee06853a1
• Unify Azure credential handling across all Python packages (#4088)

  Replace ad_token, ad_token_provider, and get_entra_auth_token with a
  unified credential parameter across all Azure-related packages.
  
  Core changes:
  - Add AzureCredentialTypes (TokenCredential | AsyncTokenCredential) and
    AzureTokenProvider (Callable[[], str | Awaitable[str]]) type aliases
  - Add resolve_credential_to_token_provider() using azure.identity's
    get_bearer_token_provider for automatic token caching/refresh
  - Update AzureOpenAIChatClient, AzureOpenAIResponsesClient, and
    AzureOpenAIAssistantsClient to accept credential: AzureCredentialTypes |
    AzureTokenProvider
  - Remove ad_token, ad_token_provider params and get_entra_auth_token helpers
  
  Package updates:
  - azure-ai: Accept AzureCredentialTypes on AzureAIClient,
    AzureAIAgentClient, AzureAIProjectAgentProvider, AzureAIAgentsProvider
  - azure-ai-search: Accept AzureCredentialTypes on
    AzureAISearchContextProvider
  - purview: Accept AzureCredentialTypes | AzureTokenProvider on
    PurviewClient, PurviewPolicyMiddleware, PurviewChatPolicyMiddleware
  
  Fixes #3449
  Fixes #3500
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-19 16:30:16 +00:00
  fd4e6e816c
• Python: Fix hosted MCP tool approval flow for all session/streaming combinations (#4054)

  * fix openai hosted mcp samples
  
  * addressed copilot comments
  
  * Update python/samples/02-agents/providers/azure_openai/azure_responses_client_with_hosted_mcp.py
  
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

  Giles Odigwe · 2026-02-18 23:28:11 +00:00
  21769e2cd1
• Python: Fix Eval samples (#4033)

  * fix red team sample
  
  * Updated self-reflection
  
  * fix for workflow eval sample
  
  * fix test

  Eduard van Valkenburg · 2026-02-18 19:50:33 +00:00
  aab80d9ed9
• Python: improve .env handling and observability samples (#4032)

  * Python: improve .env precedence and observability samples
  
  - Switch load_settings to explicit precedence: overrides -> explicit .env -> environment -> defaults\n- Raise when env_file_path is provided but missing\n- Update settings docs and tests for new behavior\n- Refresh observability samples and README guidance for env loading options\n\nCloses #3864\n\nCo-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fixed some imports
  
  * Fix load_settings CI regressions
  
  Allow explicit env_file_path values that exist but are not regular files (for example /dev/null) by checking path existence before dotenv parsing, and restore a dict accumulator with typed return cast to satisfy mypy.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Avoid implicit dotenv in observability
  
  Only load dotenv in observability helpers when env_file_path is explicitly provided, and remove test os.devnull workarounds that are no longer necessary.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-18 11:18:52 +00:00
  534e5f5bf7
• Python: Fixed middleware and multimodal input samples (#4022)

  * Fix streaming branch in weather override middleware sample
  
  The streaming branch of weather_override_middleware only prefixed the
  original weather data via a transform hook instead of replacing the
  content with the 'perfect weather' override like the non-streaming
  branch does. Replace with a new ResponseStream that yields the override
  content as ChatResponseUpdate chunks.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fixed exception handling middleware sample
  
  * Fixed runtime context delegation middleware example
  
  * Fixed multimodal input examples
  
  * Small update
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Dmytro Struk · 2026-02-18 00:49:33 +00:00
  2dd731f90f
• Python: Add missing system instruction attr to invoke_agent span (#4012)

  * Add missing sysmte instruction attr to invoke_agent span
  
  * Temp remove azure search gate
  
  * fix pipeline error

  Tao Chen · 2026-02-17 20:49:12 +00:00
  9a369c69c0
• Python: [BREAKING] Scope provider state by source_id and standardize source IDs (#3995)

  * Initial plan
  
  * Add FoundryMemoryProvider and tests
  
  Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
  
  * Add sample and documentation for FoundryMemoryProvider
  
  Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
  
  * Address code review feedback for FoundryMemoryProvider
  
  Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
  
  * Address PR review comments: Add DEFAULT_SOURCE_ID, use logging.getLogger, move state to session.state
  
  Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
  
  * Fix Foundry memory ItemParam usage and exports
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Refactor provider hook state and standardize source IDs
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Support endpoint-based Foundry memory init
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix core README workflows link
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * updated implementation and sample
  
  * Split out Foundry memory provider changes
  
  Remove FoundryMemoryProvider implementation/tests/sample plus export and docs mentions from this branch so only non-Foundry changes remain.
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Trigger CI rerun for PR #3995
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  ---------
  
  Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
  Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-17 19:12:28 +00:00
  cc98d5b6f7
• Python: feature: Inject OpenTelemetry trace context into MCP requests and update… (#3780)

  * feat: Inject OpenTelemetry trace context into MCP requests and update documentation
  
  * Update python/samples/getting_started/observability/README.md
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * Update python/packages/core/tests/core/test_mcp.py
  
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
  
  * refactor: move opentelemetry import to module level
  
  OpenTelemetry is a hard dependency of agent-framework-core (per
  pyproject.toml), so the try/except ImportError guard was dead code.
  Move the import to the top of the file to fail fast on missing
  dependencies instead of silently hiding installation issues.
  
  ---------
  
  Co-authored-by: Pete Roden <Pete.Roden@microsoft.com>
  Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com>
  Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

  Pete Roden · 2026-02-17 15:22:04 +00:00
  36d52a1f9f
• Python: Fix tool normalization and provider sample consolidation (#3953)

  * Fix tool normalization and provider samples
  
  - restore callable/single-tool normalization paths and unset tool-choice behavior\n- consolidate and expand chat/provider samples (OpenAI/Azure/Anthropic/Ollama/Bedrock)\n- migrate Bedrock lazy import surface to agent_framework.amazon and move provider samples
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * small fix in sample
  
  * Finalize provider, samples, and core cleanup
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * Fix CopilotTool passthrough in agent
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  
  * fix link
  
  ---------
  
  Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

  Eduard van Valkenburg · 2026-02-16 16:30:38 +00:00
  aab621f5eb
• Python: [BREAKING] Fix #3613 chat/agent message typing alignment (#3920)

  * Fix #3613 message typing across chat and agents
  
  * Address #3613 review feedback and sample input style
  
  * refactor: use shared AgentRunMessages aliases (#3613)
  
  * refactor: rename agent run input aliases for #3613
  
  * samples: inline image content in run calls
  
  * core: export AgentRunInputs from package init
  
  * core: use explicit init re-exports without __all__
  
  * updated logging and inits
  
  * Fix core mypy export and samples XML note
  
  * Remove AgentRunInputsOrNone and dedupe loggers
  
  * Remove prepare_messages helper
  
  * fix integration tests

  Eduard van Valkenburg · 2026-02-16 15:27:25 +00:00
  dc9439a75a
• Python: [BREAKING] Remove FunctionTool[Any] compatibility shim for schema passthrough (#3600) (#3907)

  * Fix #3600: Pass JSON schemas through without Pydantic conversion
  
  This change optimizes FunctionTool and MCP flows by passing JSON schemas
  directly to providers without converting them to Pydantic models first.
  
  Key changes:
  - Store JSON schema as-is when supplied to FunctionTool
  - Skip Pydantic model_validate for schema-supplied tools in invoke()
  - Return MCP tool schemas directly without conversion
  - Add comprehensive tests for schema passthrough behavior
  
  Performance benefits:
  - Eliminates expensive Pydantic model creation for supplied schemas
  - Preserves exact schema structure (additionalProperties, custom fields, etc.)
  - Reduces memory overhead and initialization time
  
  Maintains backward compatibility:
  - Function signature inference still uses Pydantic models
  - Explicit Pydantic models passed as input_model work as before
  - All existing tests pass
  
  * Fix schema passthrough validation and remove helper
  
  * Simplify FunctionTool without generic model dependency
  
  * Fix FunctionTool typing fallout in 3600
  
  * Remove FunctionTool[Any] compatibility shim
  
  * Use serializable kwargs in OTEL tool args

  Eduard van Valkenburg · 2026-02-14 10:12:21 +00:00
  fc9c81b0b1
• Add default in-memory history provider for workflow agents (#3918)
  Eduard van Valkenburg · 2026-02-13 13:55:39 +00:00
  f3ea872156
• Python: fix: prevent repeating instructions in continued Responses API conversations (#3909)

  * fix: prevent repeating instructions in continued Responses API conversations
  
  - Instructions are now only prepended to messages on the first turn
  - When conversation_id/response_id exists (continuation), instructions are skipped
  - Covers OpenAI and Azure Responses API paths
  - Adds regression tests for all continuation scenarios
  
  Fixes #3498
  
  * Apply lint fixes to continuation tests
  
  * Consolidate responses continuation tests

  Eduard van Valkenburg · 2026-02-13 13:34:15 +00:00
  e9b3a5bbc7
• Python: Fix non-ascii chars in span attributes (#3894)

  * Fix non-ascii chars in span attributes
  
  * Comments

  Tao Chen · 2026-02-12 22:53:32 +00:00
  1441fd903c
• Python: Fix streamed workflow agent continuation context by finalizing AgentExecutor streams (#3882)

  * Fix streamed workflow agent continuation context by finalizing AgentExecutor streams
  
  * Fix stream handling
  
  * Fixes
  
  * Fix DevUI and tests

  Evan Mattson · 2026-02-12 22:45:46 +00:00
  a276c1295a
• Python: [BREAKING] PR2 — Wire context provider pipeline, remove old types, update all consumers (#3850)

  * PR2: Wire context provider pipeline and update all internal consumers
  
  - Replace AgentThread with AgentSession across all packages
  - Replace ContextProvider with BaseContextProvider across all packages
  - Replace context_provider param with context_providers (Sequence)
  - Replace thread= with session= in run() signatures
  - Replace get_new_thread() with create_session()
  - Add get_session(service_session_id) to agent interface
  - DurableAgentThread -> DurableAgentSession
  - Remove _notify_thread_of_new_messages from WorkflowAgent
  - Wire before_run/after_run context provider pipeline in RawAgent
  - Auto-inject InMemoryHistoryProvider when no providers configured
  
  * fix: update all tests for context provider pipeline, fix lazy-loaders, remove old test files
  
  * refactor: update all sample files for context provider pipeline (AgentThread→AgentSession, ContextProvider→BaseContextProvider)
  
  * fix: update remaining ag-ui references (client docstring, getting_started sample)
  
  * fix: make get_session service_session_id keyword-only to avoid confusion with session_id
  
  * refactor: rename _RunContext.thread_messages to session_messages
  
  * refactor: remove _threads.py, _memory.py, and old provider files; migrate devui to use plain message lists
  
  * rename: remove _new_ prefix from test files
  
  * refactor: rewrite SlidingWindowChatMessageStore as SlidingWindowHistoryProvider(InMemoryHistoryProvider)
  
  * fix: read full history from session state directly instead of reaching into provider internals
  
  * fix: update stale .pyi stubs, sample imports, and README references for new provider types
  
  * fix: remove stale message_store, _notify_thread_of_new_messages, and session_id.key references in samples
  
  * refactor: merge context_providers and sessions sample folders into sessions, remove aggregate_context_provider
  
  * refactor: UserInfoMemory stores state in session.state instead of instance attributes
  
  * feat: add Pydantic BaseModel support to session state serialization
  
  Pydantic models stored in session.state are now automatically serialized
  via model_dump() and restored via model_validate() during to_dict()/from_dict()
  round-trips. Models are auto-registered on first serialization; use
  register_state_type() for cold-start deserialization.
  
  Also export register_state_type as a public API.
  
  * fix mem0
  
  * Update sample README links and descriptions for session terminology
  
  - Replace 'thread' with 'session' in sample descriptions across all READMEs
  - Update file links for renamed samples (mem0_sessions, redis_sessions, etc.)
  - Fix Threads section → Sessions section in main samples/README.md
  - Update tools, middleware, workflows, durabletask, azure_functions READMEs
  - Update architecture diagrams in concepts/tools/README.md
  - Update migration guides (autogen, semantic-kernel)
  
  * Fix broken Redis README link to renamed sample
  
  * Fix Mem0 OSS client search: pass scoping params as direct kwargs
  
  AsyncMemory (OSS) expects user_id/agent_id/run_id as direct kwargs,
  while AsyncMemoryClient (Platform) expects them in a filters dict.
  Adds tests for both client types.
  
  Port of fix from #3844 to new Mem0ContextProvider.
  
  * Fix rebase issues: restore missing _conversation_state.py and checkpoint decode logic
  
  - Add back _conversation_state.py (encode/decode_chat_messages) lost in rebase
  - Fix on_checkpoint_restore to decode cache/conversation with decode_chat_messages
  - Fix on_checkpoint_restore to use decode_checkpoint_value for pending requests
  - Add tests/workflow/__init__.py for relative import support
  - Fix test_agent_executor checkpoint selection (checkpoints[1] not superstep)
  
  * Add STORES_BY_DEFAULT ClassVar to skip redundant InMemoryHistoryProvider injection
  
  Chat clients that store history server-side by default (OpenAI Responses API,
  Azure AI Agent) now declare STORES_BY_DEFAULT = True. The agent checks this
  during auto-injection and skips InMemoryHistoryProvider unless the user
  explicitly sets store=False.
  
  * Fix broken markdown links in azure_ai and redis READMEs
  
  * Fix getting-started samples to use session API instead of removed thread/ContextProvider API
  
  * updates to workflow as agent
  
  * fix group chat import
  
  * Rename Thread→Session throughout, fix service_session_id propagation, remove stale AGUIThread
  
  - Fix: Propagate conversation_id from ChatResponse back to session.service_session_id
    in both streaming and non-streaming paths in _agents.py
  - Rename AgentThreadException → AgentSessionException
  - Remove stale AGUIThread from ag_ui lazy-loader
  - Rename use_service_thread → use_service_session in ag-ui package
  - Rename test functions from *_thread_* to *_session_*
  - Rename sample files from *_thread* to *_session*
  - Update docstrings and comments: thread → session
  - Update _mcp.py kwargs filter: add 'session' alongside 'thread'
  - Fix ContinuationToken docstring example: thread=thread → session=session
  - Fix _clients.py docstring: 'Agent threads' → 'Agent sessions'
  
  * Fix broken markdown links after thread→session file renames
  
  * fix azure ai test

  Eduard van Valkenburg · 2026-02-12 21:00:32 +00:00
  1e350ea22f
• Python: Centralize tool result parsing in FunctionTool.invoke() (#3854)

  * Centralize tool result parsing in FunctionTool.invoke()
  
  - Add parse_result static method to FunctionTool that converts raw
    function return values to strings at invocation time
  - Add result_parser parameter to FunctionTool and @tool decorator
    for custom parsing
  - Remove prepare_function_call_results from all 9 consumer files
    and from the public API
  - Update MCPTool to parse MCP types directly to strings via
    _parse_tool_result_from_mcp and _parse_prompt_result_from_mcp
  - Change MCPTool parse_tool_results/parse_prompt_results type from
    Literal[True] | Callable | None to Callable | None
  - Remove ReturnT type parameter from FunctionTool (now single
    generic ArgsT since invoke() always returns str)
  - Update all subclass signatures and docstrings
  
  Fixes #1147
  
  * Fix test_mcp_tool_call_tool_with_meta_integration for string results
  
  The test was still accessing result[0].additional_properties but
  invoke() now returns a string, not a list of Content objects.
  
  * Fix SIM108 lint: use binary operator for output assignment
  
  * Fix bedrock: use FunctionTool.parse_result instead of str() fallback
  
  str(result) turns None into literal 'None' and dicts into Python reprs
  with single quotes, breaking JSON parsing. Use the shared parse_result
  which handles None as '' and serializes via json.dumps.
  
  * updated lock
  
  * updates from feedback

  Eduard van Valkenburg · 2026-02-12 13:49:42 +00:00
  8ed50009c6
• Python: (samples): adopt AzureOpenAIResponsesClient, reorganize orchestration examples, and fix workflow/orchestration bugs (#3873)

  * adopt AzureOpenAIResponsesClient, reorganize orchestration examples, and fix workflow/orchestration bugs
  
  * Updates
  
  * add comment

  Evan Mattson · 2026-02-12 10:46:58 +00:00
  1b10b051fd