agent-framework

Python: [BREAKING] Types API Review improvements (#3647 )

* Replace Role and FinishReason classes with NewType + Literal

- Remove EnumLike metaclass from _types.py
- Replace Role class with NewType('Role', str) + RoleLiteral
- Replace FinishReason class with NewType('FinishReason', str) + FinishReasonLiteral
- Update all usages across codebase to use string literals
- Remove .value access patterns (direct string comparison now works)
- Add backward compatibility for legacy dict serialization format
- Update tests to reflect new string-based types

Addresses #3591, #3615

* Simplify ChatResponse and AgentResponse type hints (#3592)

- Remove overloads from ChatResponse.__init__
- Remove text parameter from ChatResponse.__init__
- Remove | dict[str, Any] from finish_reason and usage_details params
- Remove **kwargs from AgentResponse.__init__
- Both now accept ChatMessage | Sequence[ChatMessage] | None for messages
- Update docstrings and examples to reflect changes
- Fix tests that were using removed kwargs
- Fix Role type hint usage in ag-ui utils

* Remove text parameter from ChatResponseUpdate and AgentResponseUpdate (#3597)

- Remove text parameter from ChatResponseUpdate.__init__
- Remove text parameter from AgentResponseUpdate.__init__
- Remove **kwargs from both update classes
- Simplify contents parameter type to Sequence[Content] | None
- Update all usages to use contents=[Content.from_text(...)] pattern
- Fix imports in test files
- Update docstrings and examples

* Rename from_chat_response_updates to from_updates (#3593)

- ChatResponse.from_chat_response_updates → ChatResponse.from_updates
- ChatResponse.from_chat_response_generator → ChatResponse.from_update_generator
- AgentResponse.from_agent_run_response_updates → AgentResponse.from_updates

* Remove try_parse_value method from ChatResponse and AgentResponse (#3595)

- Remove try_parse_value method from ChatResponse
- Remove try_parse_value method from AgentResponse
- Remove try_parse_value calls from from_updates and from_update_generator methods
- Update samples to use try/except with response.value instead
- Update tests to use response.value pattern
- Users should now use response.value with try/except for safe parsing

* Add agent_id to AgentResponse and clarify author_name documentation (#3596)

- Add agent_id parameter to AgentResponse class
- Document that author_name is on ChatMessage objects, not responses
- Update ChatResponse docstring with author_name note
- Update AgentResponse docstring with author_name note

* Simplify ChatMessage.__init__ signature (#3618)

- Make contents a positional argument accepting Sequence[Content | str]
- Auto-convert strings in contents to TextContent
- Remove overloads, keep text kwarg for backward compatibility with serialization
- Update _parse_content_list to handle string items
- Update all usages across codebase to use new format: ChatMessage("role", ["text"])

* Allow Content as input on run and get_response

- Update prepare_messages and normalize_messages to accept Content
- Update type signatures in _agents.py and _clients.py
- Add tests for Content input handling

* Fix ChatMessage usage across packages and samples

Update all remaining ChatMessage(role=..., text=...) to use new
ChatMessage('role', ['text']) signature.

* Fix Role string usage and response format parsing

- Fix redis provider: remove .value access on string literals
- Fix durabletask ensure_response_format: set _response_format before accessing .value

* Fix ollama .value and ai_model_id issues, handle None in content list

- Fix ollama _chat_client: remove .value on string literals
- Fix ollama _chat_client: rename ai_model_id to model_id
- Fix _parse_content_list: skip None values gracefully

* Fix A2AAgent type signature to include Content

* Fix Role/FinishReason NewType dict annotations and improve test coverage to 95%

* Fix mypy errors for Role/FinishReason NewType usage

* Fix Role.TOOL and Role.ASSISTANT usage in _orchestrator_helpers.py

* Fix Role NewType usage in durabletask _models.py

Eduard van Valkenburg · 2026-02-04 10:13:23 +00:00

838a7fd61d

Python: Fix broken Content API imports in Python samples (#3639 )

* Initial plan

* Fix broken import paths for Content API in all Python sample files

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

---------

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

Copilot · 2026-02-03 22:48:26 +00:00

96d3f2a55e

Python: Updated instructions/system_message logic in GitHub Copilot agent (#3625 )

* Updated instructions handling

* Small improvement

* Included runtime options in session creation logic

Dmytro Struk · 2026-02-03 05:40:35 +00:00

73033c300f

Python: Replaced obsolete create_response method in samples (#3542 )

* Replaced obsolete create_response method in samples

* Addressed PR comments

Dmytro Struk · 2026-01-30 22:22:00 +00:00

493891620d

Python: Add BaseAgent implementation for Claude Agent SDK (#3509 )

* Added ClaudeAgent implementation

* Updated streaming logic

* Small updates

* Small update

* Fixes

* Small fix

* Naming improvements

* Updated imports

* Addressed comments

* Updated package versions

Dmytro Struk · 2026-01-30 18:11:41 +00:00

8b475afe17

Python: Add sample on how to share a thread between agents in a workflow (#3405 )

* Add sample on how to share a thread between agents in a workflow

* Fix sample

* Fix formatting

* Comments

* comment

Tao Chen · 2026-01-30 18:07:58 +00:00

0fcf075ea7

Python: Add coverage threshold gate for PR checks (#3392 ) (#3510 )

* Python: Add coverage threshold gate for PR checks (#3392)

- Add python-check-coverage.py script to enforce coverage threshold on specific modules
- Modify python-test-coverage.yml to run coverage check after tests
- Initial enforced module: agent_framework_azure_ai at 85% threshold
- Other modules are reported for visibility but don't block merges

* Fail if module not found

* Force unit test job to run

* Comment 1

* Fix coverage check to use full package paths for submodule support

* Update report format

Tao Chen · 2026-01-29 23:58:52 +00:00

0a0de4ac21

Python: added generic types to ChatOptions and ChatResponse/AgentResponse for Response Format (#3305 )

* added generic types to ChatOptions and ChatResponse/AgentResponse for response format

* fix typevar import

* fix for older python versions

* fix missing import

* fixed imports

* fixed mypy

* mypy fix

Eduard van Valkenburg · 2026-01-28 21:23:02 +00:00

1226828ec2

.NET: Python: [BREAKING] Renamed Github to GitHub (#3486 )

* Renamed Github to GitHub

* Small fix

* Updated package versions

Dmytro Struk · 2026-01-28 19:58:31 +00:00

45a020be43

Python: [BREAKING] changed AIFunction to FunctionTool and @ai_function to @tool (#3413 )

* changed AIFunction to FunctionTool and @ai_function to @tool

* test and mypy fixes

* mypy fix

* switch function tool to always_require

* fix noop

* fix github copilot imports

* test fixes

* fix ollama test

* fixes for tests

* fix tests

* reverted change to always_require and extended timeout

* fix test

Eduard van Valkenburg · 2026-01-28 14:53:53 +00:00

a7d924a7d2

Python: Add BaseAgent implementation for GitHub Copilot SDK (#3404 )

* Added GithubCopilotAgent

* Fixed errors

* Updated examples

* Updated naming and tests

* Resolved comments and more tests

* Updated tool handling

* Updated tool handling

* Small fixes

* Removed default permission handler

* Resolved comments

* Updated positional args

* Updated docstrings

* Small fixes and more examples

* Added example with MCP

Dmytro Struk · 2026-01-26 18:09:04 +00:00

407fb3025e

Python: add(azure-ai): support reasoning config for AzureAIClient (#3403 )

* add(azure-ai): support reasoning config for AzureAIClient

* Update sample

* Merge main

* improvements

* improve sample

Evan Mattson · 2026-01-23 09:37:23 +00:00

7b8777d1fc

Python: Azure AI mapping HostedImageGenerationTool to ImageGenTool (#3263 )

* azureai image gen sample fix

* mypy fixes

* addressed comments + mapping updates

* image model fix

* content type fix

Giles Odigwe · 2026-01-23 06:11:16 +00:00

a97bc322ac

Python: Fix local MCP tools with AzureAIProjectAgentProvider (#3315 )

* azureai v2 local mcp fix

* addressed copilot comments

Giles Odigwe · 2026-01-21 12:43:05 +00:00

88e0ee1a2c

Python: [Breaking] Simplified Content types to a single class with classmethod constructors. (#3252 )

* ported Content to a new model

* fixed linting

* fixes

* fixed data format handling

* fix for 3.10 mypy

* fix

* fix int test

Eduard van Valkenburg · 2026-01-20 22:09:39 +00:00

83e6229c11

Python: [BREAKING] Make response_format validation errors visible to users (#3274 )

* Make response_format validation errors visible to users

* Small fix

* Addressed comments

Dmytro Struk · 2026-01-19 17:20:46 +00:00

83e8965c8e

Python: Filter conversation_id when passing kwargs to agent as tool (#3266 )

* Filter conversation_id when passing kwargs to agent as tool

* Small fix

* Update python/samples/getting_started/agents/azure_ai/README.md

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

* Update python/samples/getting_started/agents/openai/openai_responses_client_with_agent_as_tool.py

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

* Update python/samples/getting_started/agents/azure_ai/azure_ai_with_agent_as_tool.py

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

---------

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

Dmytro Struk · 2026-01-19 12:54:06 +00:00

3243652df6

Python: Added rai_config to Azure AI agent creation (#3265 )

* Add kwargs to create_agent method

* Added test for kwargs

* Addressed comment

* Added doc string

Dmytro Struk · 2026-01-19 12:51:27 +00:00

915df3b404

Python: [BREAKING] Renamed create_agent to as_agent (#3249 )

* Renamed create_agent to as_agent

* Override for as_agent

* Added override

Dmytro Struk · 2026-01-16 19:21:52 +00:00

5687e13221

Create/Get Agent API - fixes and example improvements (#3246 )

Dmytro Struk · 2026-01-16 04:36:34 +00:00

b773830e4b

Python: Create/Get Agent API for OpenAI Assistants (#3208 )

* Added provider implementation

* Added example with response format

* Small improvements

Dmytro Struk · 2026-01-15 22:52:32 +00:00

b5ca0c8eda

Python: Create/Get Agent API for Azure V1 (#3192 )

* Added provider implementation for Azure AI V1

* Small fixes

* Fixed OpenAPI example

* Fixed local MCP example

* Fixed hosted MCP example

* Fixed file search sample

* Small fixes

* Resolved comments

* Doc updates

Dmytro Struk · 2026-01-15 22:19:03 +00:00

48d124efbe

Python: Properly configure structured outputs based on new options dict (#3213 )

* Properly configure structured outputs based on new options dict

* Fix mypy

Evan Mattson · 2026-01-15 11:41:46 +09:00

15d0c34d9f

Python: Added AzureAI sample for downloading code interpreter generated files (#3189 )

* added azure ai code interpreter file download sample

* copilot fix suggestions

* function name fixes + readme update

* small fix

Giles Odigwe · 2026-01-14 22:50:07 +00:00

9b9a0f178c

Python: Create/Get Agent API for Azure V2 (#3059 )

* Added get_agent method to Azure AI V2

* Small fixes

* Small fix

* Removed AzureAIAgentProvider

* Added create_agent method

* Small fixes

* Fixed code interpreter tool mapping

* Added agent provider for V2 client

* Updated response format handling

* Added provider example

* Fixed errors

* Update python/samples/getting_started/agents/azure_ai/README.md

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

* Small fix

* Updates from merge

* Resolved comments

* Resolved comments

---------

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

Dmytro Struk · 2026-01-14 19:35:01 +00:00

99c5718696

renamed all (#3207 )

Eduard van Valkenburg · 2026-01-14 05:54:07 +00:00

d8cf8361bd

Python: [BREAKING]: Introducing Options as TypedDict and Generic (#3140 )

* WIP typeddict for options

* updated all clients and ChatAgents

* updated everything

* added ADR

* fix mypy

* proper typevar imports

* fixed import

* fixed other imports

* slight update in the sample

* updated from feedback

* fixes

* fixed missing covariants and test fixes

* fixed typing

* updated anthropic thinking config

* ruff fixes

* fixed int tests

* fix tests and mypy

* updated integration tests

* updated docstring and test fix

* improved options handling in obser

* mypy fix

* updated a host of integration tests

* fix tests

* bedrock fix

Eduard van Valkenburg · 2026-01-13 16:41:05 +00:00

3e97425245

Python: [BREAKING]: removed display_name, renamed context_providers, middleware and AggregateContextProvider (#3139 )

* removed display_name, renamed context_providers, middleware and AggregateContextProvider

* fixes

* fixed test

* testfix

* removed mistakenly put back test

* updated new test

* rename middlewares to middleware

* middleware fixes

Eduard van Valkenburg · 2026-01-13 02:24:07 +00:00

203fb7b1c4

azureai direct a2a endpoint support (#3127 )

Giles Odigwe · 2026-01-12 22:03:04 +00:00

ef44fb4960

Fix Ollama model env var in documentation (#3156 )

Signed-off-by: Dina Suehiro Jones <dina.s.jones@intel.com>

Dina Suehiro Jones · 2026-01-12 14:15:49 +00:00

3a5fe31263

Python: Add tool call/result content types and update connectors and samples (#2971 )

* Add new AI content types and image tool support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Add Python content types for tool calls/results and image generation tool support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Address review feedback for tool content and samples

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Tighten image generation typing and sample tools list

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Align image generation output typing

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Handle MCP naming, image options mapping, and connector tool content

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Allow MCP call in function approval request

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Remove raw image_generation tool remapping

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Restore Anthropic tool_use to function calls unless code execution

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix lint issues for hosted file docstring and MCP parsing

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Import ChatResponse types in Anthropic client

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix Anthropics citation type imports and MCP typing for handoff/tools

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Skip lightning tests without agentlightning and fix function call import

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* fix lint on lab package

* rebuilt anthropic parsing

* redid anthropic parsing

* typo

* updated parsing and added missing docstrings

* fix tests

* mypy fixes

* second mypy fix

* add new class to other samples

---------

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: eavanvalkenburg <github@vanvalkenburg.eu>

Copilot · 2026-01-08 19:46:32 +00:00

3f7ea350dc

sharepoint sample fix (#3108 )

Giles Odigwe · 2026-01-06 22:57:54 +00:00

ea370f8ff6

Python: Preserve reasoning blocks with OpenRouter (#2950 )

* Preserve reasoning blocks with OpenRouter

* Put encrypted reasoning in TextReasoningContent

* Remove unneccessary change

* Fix docs

* Support streaming

* Fix handling None in TextReasoningContent.text

SuperKenVery · 2025-12-19 17:03:19 +00:00

85d70f01f6

Python: Move ollama samples to samples getting started dir (#2921 )

* Move ollama samples to samples getting started dir

* Address feedback

Evan Mattson · 2025-12-18 08:37:05 +00:00

ca1532cf22

Python: Azure AI Agent with Bing Grounding Citations Sample (#2892 )

* bing grounding sample with citations

* small fix

* fix

Giles Odigwe · 2025-12-17 00:43:38 +00:00

d5527982b6

Python : Ollama Connector for Agent Framework (#1104 )

* Initial Commit for Olama Connector

* Added Olama Sample

* Add Sample & Fixed Open Telemetry

* Fixed Spelling from Olama to Ollama

* remove"opentelemetry-semantic-conventions-ai ~=0.4.13" since its handled in a different pr

* Added Tool Calling

* Finalizing test cases

* Adjust samples to be more reliable

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

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

* Update python/packages/ollama/pyproject.toml

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

* Update python/packages/ollama/tests/test_ollama_chat_client.py

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

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

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

* Improved Docstrings & Sample

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>

* Integrate PR Feedback
- Divided Streaming and Non-Streaming into independent Methods
- Catch Ollama Validation Error
- Add OTEL Provider Name
- Checked Ollama Messages
- Add Usage Statistics

* Revert setting, so it can be none

* Validate Message formatting between AF and Ollama

* Catch Ollama Error and raise a ServiceResponse Error

* Fix mypy error

* remove .vscode comma

* Add Reasoning support & adjust to new structure

* Add Ollama Multimodality and Reasoning

* Add test cases for reasoning

* Add Tests for Error Handling in Ollama Client

* Update python/samples/getting_started/multimodal_input/ollama_chat_multimodal.py

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

* Integrated Copilot Feedback

* Implement first PR Feedback

* Adjust Readme files for examples

* Adjust argument passing via additional chat options

* Implemented PR Feedback

* Removing Ollama Package from Core and moving samples

* Fix Link & Adding Samples to Main Sample Readme

* Fixing Links in Readme

* Moved Multimodal and Chat Example

* Fixed Link in ChatClient to Ollama

* Fix AgentFramework Links in Ollama Project

* Fix observability breaking change

---------

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

Nico Möller · 2025-12-16 15:02:38 +00:00

2f06fe557a

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

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

3481914981

azureai image gen sample update (#2709 )

Giles Odigwe · 2025-12-09 13:50:04 +00:00

b55095f0fb

Renamed async_credential to credential (#2648 )

Dmytro Struk · 2025-12-08 01:21:18 +00:00

cfcb71334a

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: AzureAI Local MCP Sample (#2616 )

* added azure ai local mcp sample

* small fix

* handling for local mcp

* remove redundant local mcp handling

Giles Odigwe · 2025-12-04 19:10:00 +00:00

365e438981

Python: Added support for application endpoints in Azure AI client (#2460 )

* Added support for application endpoints in Azure AI client

* Fixed tests

* Update python/samples/getting_started/agents/azure_ai/azure_ai_with_application_endpoint.py

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

* Addressed comments

---------

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

Dmytro Struk · 2025-11-25 19:32:55 +00:00

5d8be5836c

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

* Removed default store value

* Small fix

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

b8260ae24c

Python: Fix runtime response format for responses client (#2440 )

* Fix runtime response format for responses client

* Handle run time schema for Azure AI Client.

Evan Mattson · 2025-11-25 07:50:20 +00:00

2a4802eac3

Python: AzureAI OpenAPI + Memory Search Samples (#2390 )

* openapi + memory search samples

* readme update

* memory store name fix

Giles Odigwe · 2025-11-25 01:17:14 +00:00

e303cc963d

Python: renamed ai search and cleanup of samples and unified import logic (#2369 )

* renamed ai search and cleanup of samples and unified import logic

* fixed error messages

* fixed folder name

* remove old samples from readme

Eduard van Valkenburg · 2025-11-24 17:06:22 +00:00

9f43108ef1

a2a sample update (#2391 )

Giles Odigwe · 2025-11-24 10:57:00 +00:00

ec08ee541d

Python: Integration tests for Azure AI client and fixes in samples (#2387 )

* Added integration tests

* Update python/packages/azure-ai/tests/test_azure_ai_client.py

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

* Small fixes in samples

* Small fix

* Small fix

---------

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

Dmytro Struk · 2025-11-22 00:31:57 +00:00

ee8936d514

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

Sample to show passing in JSON schema for structured outputs (#2362 )

Evan Mattson · 2025-11-21 01:42:46 +00:00

5bdf8a774a

130 Commits