agent-framework

Python: Fix ExecutorInvokedEvent and ExecutorCompletedEvent observability data (#3090 )

* Fix ExecutorInvokedEvent.data mutation bug

* Fix bug related to not yielding output type

Evan Mattson · 2026-01-06 09:12:26 +00:00

844d345106

fix and extra int test (#3037 )

Eduard van Valkenburg · 2026-01-05 04:35:10 +00:00

deea844bc7

Python: Added response.created and response.in_progress event process to OpenAIBaseResponseClient (#2975 )

* added response.created and response.in_progress to include response.id

* better doc string

* added tests for the new streaming event types

Hao Luo · 2025-12-19 17:50:15 +00:00

defe0f1a89

Python: Bump Py version to 1.0.0b251218 for a release. Update CHANGELOG (#2968 )

* Bump Py version to 1.0.0b251218 for a release. Update CHANGELOG

* update lock

* Fix formatting

* Fix ChatKit typing

Evan Mattson · 2025-12-19 01:31:57 +00:00

e15eab7da6

Python: Fix WorkflowAgent event handling and kwargs forwarding (#2946 )

* Fix kwargs propagation through workflow.as_agent()

* Fix WorkflowAgent to respect AgentExecutor output_response setting

Evan Mattson · 2025-12-18 19:35:07 +00:00

b0a7a1fcb8

Python: cleanup and refactoring of chat clients (#2937 )

* refactoring and unifying naming schemes of internal methods of chat clients

* set tool_choice to auto

* fix for mypy

* added note on naming and fix #2951

* fix responses

* fixes in azure ai agents client

Eduard van Valkenburg · 2025-12-18 12:02:23 +00:00

e5c11d38d6

Pass kwargs into subworkflows (#2923 )

Evan Mattson · 2025-12-18 04:34:33 +00:00

360839782c

Python: Correction of MCP image type conversion in _mcp.py (#2901 )

* Correction of MCP image type conversion in  _mcp.py

* Added a new overload to the init function of the DataContent() type of the Agent Framework, edited the test case to correctly test the usage of the data and uri fields while using DataContent()

* Fixed tests related to the changes of the DataContent type, added testing for both string and byte representations

Ege Ozan Özyedek · 2025-12-17 16:11:39 +00:00

ee53fe4666

Fix Pydantic error when using Literal type for tool params (#2893 )

Evan Mattson · 2025-12-17 00:27:01 +00:00

06cdcb93f0

Python: Flow custom kwargs to agents via Workflow SharedState (#2894 )

* Flow custom kwargs to agents via SharedState

* Address Copilot feedback

* Improve sample typing

* Fix test

Evan Mattson · 2025-12-17 00:04:00 +00:00

6adcac2e97

[BREAKING] Python: Add factory pattern to handoff orchestration builder (#2844 )

* WIP: Factory pattern to handoff

* Add factory pattern to concurrent orchestration builder; Next: tests and sample verification

* Add tests and improve comments

* Fix mypy

* Simplify handoff_simple.py

* Simplify handoff_autonoumous.py and bug fix

* Update readme

* Address Copilot comments

Tao Chen · 2025-12-16 23:38:33 +00:00

8fca71e5ad

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

Evan Mattson · 2025-12-16 09:52:59 +00:00

958a488f96

Python: Fix middleware terminate flag to exit function calling loop immediately (#2868 )

* Fix middleware terminate flag to exit function calling loop immediately

* Eliminating duck typing

* Improve function exec result handling

* Fix race condition

* Fix mypy issues

Evan Mattson · 2025-12-16 09:52:52 +00:00

11d6dcfe80

Python: [BREAKING] Observability updates (#2782 )

* fixes Python: Add env_file_path parameter to setup_observability() similar to AzureOpenAIChatClient
Fixes #2186

* WIP on updates using configure_azure_monitor

* improved setup and clarity

* fixed root .env.example

* revert changes

* updated files

* updated sample

* updated zero code

* test fixes and fixed links

* fix devui

* removed planning docs

* added enable method and updated readme and samples

* clarified docstring

* add return annotation

* updated naming

* update capatilized version

* updated readme and some fixes

* updated decorator name inline with the rest

* feedback from comments addressed

Eduard van Valkenburg · 2025-12-16 06:56:30 +00:00

3139347526

Python: Fix WorkflowAgent to emit yield_output as agent response (#2866 )

* Fix WorkflowAgent to emit yield_output as agent response

* use raw_representation

* Raw representation handling

Evan Mattson · 2025-12-16 01:14:26 +00:00

a7298757f5

Python: Remove warnings from workflow builder on not using factories (#2808 )

* Revert concurrent

* Fix comments

Tao Chen · 2025-12-12 07:56:16 +00:00

e0ff153ee9

Fix WorkflowAgent to include thread convo history. Enable checkpointing. (#2774 )

Evan Mattson · 2025-12-12 04:04:31 +00:00

0fc7933a92

Python: Added custom args and thread object to ai_function kwargs (#2769 )

* Added an example of using kwargs in ai_function

* Added thread object to ai_function kwargs

* Updated docs

* Small fix

* Added thread parameter filtering

Dmytro Struk · 2025-12-12 01:53:04 +00:00

d7434d59ce

Python: added more complete parsing for mcp tool arguments (#2756 )

* added more complete parsing for mcp tool arguments

* fixed mypy

* added nonlocal model counter, and some fixes

* fixes in naming logic

* extracted json parsing function, added parametrized test and checked coverage

Eduard van Valkenburg · 2025-12-11 17:24:08 +00:00

c376868ec9

Capture file IDs from code interpreter in streaming responses (#2741 )

Evan Mattson · 2025-12-11 07:30:19 +00:00

3481914981

Python: Add factory pattern to concurrent orchestration builder (#2738 )

* Add factory pattern to concurrent orchestration builder

* Update readme

* Address AI comments

* Fix unit tests

* Fix import

* Prevent multiple calls to set participants or factories

* Add comments

* Mitigate warnings

* Fix mypy

* Address comments

* Address Copilot comments

* Fix tests

Tao Chen · 2025-12-11 01:23:28 +00:00

191779ce80

Python: Add factory pattern to sequential orchestration builder (#2710 )

* Add factory pattern to sequential orchestration builder

* Use temp list to avoid override

* Add sample and some other fixes

* Fix comments

* Small fix

* Update readme

Tao Chen · 2025-12-10 18:16:10 +00:00

523305ac62

Python: extend HITL support for all orchestration patterns (#2620 )

* Support HITL for orchestration patterns

* Cleanup around naming

* Fix typing issues

* Clean up

* Naming clean up

* Updates to HITL to make it cleaner

* Rename human input hook to orchestration request info

* Clean up per PR feedback

Evan Mattson · 2025-12-10 15:59:29 +00:00

b378ca75d1

Python: Added Azure OpenAI Responses File Search sample + Integration test update (#2645 )

* added azure responses file search sample + int test update

* sample update to use token credential

Giles Odigwe · 2025-12-05 19:01:48 +00:00

f5f909f2e2

Python: Support an autonomous handoff flow (#2497 )

* Support an autonomous handoff flow.

* Simplify public API

* Address feedback

Evan Mattson · 2025-12-05 07:13:22 +00:00

b78a2b6d2e

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

Tao Chen · 2025-12-05 05:26:10 +00:00

f2ed5b55f6

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

Evan Mattson · 2025-12-04 05:13:27 +00:00

19ac6e57c0

Python: Fix: AgentRunResponse.created_at returns local datetime labeled as UTC (#2590 )

* Initial plan

* Fix created_at to use UTC datetime and add unit tests

Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>

* Address code review feedback: move datetime imports to top of test files

Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>

* Add UTC timestamp test for OpenAIResponsesClient._create_response_content

Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>

* Fix lint issue

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>
Co-authored-by: Evan Mattson <evan.mattson@microsoft.com>

Copilot · 2025-12-04 05:09:52 +00:00

292a2078fa

Add support for Pydantic BaseModel as function call result (#2606 )

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: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

Copilot · 2025-12-04 01:41:47 +00:00

ae06c9e4bb

Python: Add executor I/O data to ExecutorInvokedEvent and ExecutorCompletedEvent (#2591 )

* Add executor I/O data to ExecutorInvokedEvent and ExecutorCompletedEvent

* Sample cleanup

Evan Mattson · 2025-12-04 01:41:40 +00:00

f7a9005235

Python: added inline yaml sample (#2582 )

* added inline yaml sample

* fixed some typos and added intro comment

* added description params and pass through to client

* add azure assistants

* fix tests

* observabiltiy mypy fix

* for some reason mypy doesn't accept a subclass

---------

Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

Eduard van Valkenburg · 2025-12-04 01:30:56 +00:00

d774b64df0

Python: Use executor_id and edge_group_id as span names for meaningful observability traces (#2538 )

* Use executor_id and edge_group_id as span names for meaningful observability traces

* Update tests

* Adjust naming

Evan Mattson · 2025-12-04 01:03:12 +00:00

a683c0e865

Python: Add type annotations for AgentRunEvent and AgentRunUpdateEvent data attributes (#2589 )

* Add type annotations for AgentRunEvent and AgentRunUpdateEvent data attributes

* Fix unnecessary cast after typing improvement

* Mcp pkg update introduced type change. Fix it.

* update opentelemetry deps to 1.39.0 and use LogRecordExporter for type compatibility

Evan Mattson · 2025-12-04 00:40:49 +00:00

a597a925cb

Python: Pin meta core (#2597 )

* pin core dependency in the meta package

* fix for mcp latest

* fix mypy

* test fix

* test fix

* fix tests for content parsing

Eduard van Valkenburg · 2025-12-03 18:19:17 +00:00

a81279d960

Python: Emit ExecutorFailedEvent before WorkflowFailedEvent when executor throws exception (#2537 )

* Emit ExecutorFailedEvent before WorkflowFailedEvent when executor throws exception

* Cleanup

Evan Mattson · 2025-12-02 01:21:28 +00:00

0d5d10d24a

[BREAKING] Python: Standardize orchestration outputs as list of ChatMessage. Allow agent as group chat manager. (#2291 )

* Standardize orchestration outputs as list of chatmessage. Add chat options to group chat prompt manager

* refactor group chat

* Improve group chat manager

* README Update

* Cleanup

* Add comment

* More cleanup

* Standardize termination condition for group chat

* Improvements on termination logic

* Fix tests

* Fix new line

* PR feedback

* Update ChatKit based on OpenAI type change

* Raise error if response format is not expected type

* Only one starting executor required. Add tests.

* Add magentic start executor test

Evan Mattson · 2025-11-26 07:51:04 +00:00

907d79ab3c

Python: [BREAKING] Removed default "store" value (#2443 )

* Removed default store value

* Small fix

Dmytro Struk · 2025-11-25 17:53:08 +00:00

b8260ae24c

[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>

Evan Mattson · 2025-11-25 08:24:08 +00:00

27b3a517eb

Python: Preserve MCP array items schema in Pydantic field generation (#2382 )

* mcp tool parameter fix

* small fixes

Giles Odigwe · 2025-11-24 17:16:30 +00:00

bcbf1b33e8

Bug fix for Redis TypeError (#2411 )

Evan Mattson · 2025-11-24 10:48:33 +00:00

f9a94ce7b5

Python: feat(mcp): add full _meta field support for CallToolResult objects (#2286 )

* feat(mcp): add full _meta field support for CallToolResult objects

- Extract and preserve complete _meta field from MCP CallToolResult responses
- Merge metadata into additional_properties of converted content items
- Handle isError field for proper error state integration
- Support arbitrary metadata like token usage, costs, and performance metrics
- Maintain backward compatibility with existing tool execution workflows
- Add comprehensive test coverage for all metadata scenarios including edge cases
- Update documentation with metadata handling examples and patterns

Fixes protocol compliance violation where _meta fields were being dropped,
enables proper monitoring and cost tracking of MCP tool usage.

* Update python/packages/core/agent_framework/_mcp.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Clarify MCP _meta field test to use generic example metadata

- Updated test_mcp_call_tool_result_with_meta_arbitrary_data to use arbitrary metadata fields
- Added comments to emphasize that _meta structure is server-specific and not standardized

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Bryan Ostdiek · 2025-11-21 08:43:24 +00:00

d18ce24bf8

fix(observability): handle datetime serialization in tool results (#2248 )

Fixes #2219

Adds default=str to json.dumps() calls to handle non-JSON-serializable
types like datetime objects in tool function results.

Co-authored-by: kishikawa-hayato <84244732+HerBest-max@users.noreply.github.com>

Hayato Kishikawa · 2025-11-20 17:50:45 +00:00

f99dca033f

Python: Fix tool execution bleed-over in aiohttp/Bot Framework scenarios (#2314 )

* Deep copy the agent chat options to avoid mutations

* avoiding _thread.RLock pickling errors

Evan Mattson · 2025-11-20 08:06:14 +00:00

d714b91a14

Python: propagate as_tool() kwargs. Add sample for runtime context with as_tool kwargs and middleware. (#2311 )

* as tool kwargs

* simplify

Evan Mattson · 2025-11-20 00:53:44 +00:00

4fcc5a4b7d

Python: Clean up imports (#2318 )

* chore: tidy imports

* Update python/packages/azurefunctions/agent_framework_azurefunctions/_errors.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/azurefunctions/agent_framework_azurefunctions/_callbacks.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* chore: revert stub file change

* chore: trigger pre-commit hook, re-add `annotations` import

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Brandon McConnell · 2025-11-19 23:41:01 +00:00

79bb87061b

added test to validate status set (#2265 )

Eduard van Valkenburg · 2025-11-19 15:54:12 +00:00

4e339f841a

Python: fix: @ai_function doesn't properly handle 'self' param (#2266 )

* Fixes Python: @ai_function doesn't properly handle 'self' param
Fixes #1343

* fix for declaration only funcs

* fix mypy

Eduard van Valkenburg · 2025-11-19 15:49:50 +00:00

34a00f1b8a

Python: fix: resolve string annotations in FunctionExecutor (#2308 )

* fix: resolve string annotations in FunctionExecutor

Enhance type hint validation in FunctionExecutor by importing `typing` and
using `get_type_hints` to correctly resolve annotations.

This fixes validation failures when `from __future__ import annotations`
is enabled, which stores annotations as strings.

Fixes #1808

* Update python/packages/core/tests/workflow/test_function_executor_future.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* ran pre commit

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Gwyneth Peña-Siguenza · 2025-11-19 07:26:44 +00:00

f83c39f924

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

Tao Chen · 2025-11-17 18:19:01 +00:00

c361ad8d33

Python: Fix: Prevent duplicate MCP tools and prompts (#1876 ) (#1890 )

* Fix: Prevent duplicate MCP tools and prompts (#1876)

- Added deduplication logic in MCPTool.load_tools() method
- Added deduplication logic in MCPTool.load_prompts() method
- Track existing function names before loading from MCP server
- Skip tools/prompts that are already registered in _functions list
- Prevents 400 error from Azure AI Foundry caused by duplicate tool names

The issue occurred because load_tools() was being called multiple times
(during connect() and by notification handlers), causing tools to be
appended without duplicate checking.

Changes made:
1. In load_tools(): Added existing_names set to track registered functions
2. In load_tools(): Added check to skip tools already in existing_names
3. In load_prompts(): Applied same deduplication pattern

Testing:
- Created unit test verifying deduplication logic
- Confirmed duplicates are skipped correctly
- Confirmed new functions are added correctly
- Prevents duplicate tool names being sent to LLM

Fixes #1876

* Address review feedback: Prevent multiple calls to load_tools and load_prompts

- Added _tools_loaded and _prompts_loaded flags to MCPTool class
- Modified load_tools() to check if already loaded and return early
- Modified load_prompts() to check if already loaded and return early
- Moved test cases from test_mcp_fix.py to test_mcp.py
- Added tests for multiple call prevention
- Deleted separate test_mcp_fix.py file

Addresses review feedback from @eavanvalkenburg:
- Prevents accidental multiple calls to load_tools()
- Prevents accidental multiple calls to load_prompts()
- Test file now in proper location (test_mcp.py)

* Address review feedback: Move flag checks to connect() and remove comments

- Removed verbose comments from code
- Moved _tools_loaded and _prompts_loaded checks to connect() method
- Allows manual calls to load_tools() and load_prompts() for updates
- Updated tests to reflect new behavior
- connect() now prevents duplicate loading during connection
- Users can still manually call load_tools()/load_prompts() to refresh

Addresses feedback from @eavanvalkenburg

* Fix: Code quality and formatting issues

- Applied black formatting
- Fixed ruff linting issues
- All tests passing locally

* chore: Re-run uv lock per review request

* Apply pre-commit formatting: consolidate type annotations

- Consolidate multi-line type annotations to single line
- Remove unnecessary parentheses
- Apply ruff format and security checks

ISHAN RAJ SINGH · 2025-11-14 02:40:25 +00:00

36c1217605

94 Commits