Python: feat: Add Agent Framework to A2A bridge support by Shubham-Kumar-2000 · Pull Request #2403 · microsoft/agent-framework

Shubham-Kumar-2000 · 2025-11-23T13:40:17Z

Motivation and Context

This integration enables agent framework agents to communicate and execute as a A2A hosted agent server.

Description

Implement A2A event adapter for converting agent messages to A2A protocol
Implement A2A executor for running agents in A2A environment
Add comprehensive unit tests for event adapter, and executor
Update agent framework core A2A module exports and type stubs
Integrate thread management utilities for async execution
Add getting started sample for A2A agent framework integration
Update dependencies in uv.lock

Contribution Checklist

The code builds clean without any errors or warnings
The PR follows the Contribution Guidelines
All unit tests pass, and I have added new tests where possible
Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

- Implement A2A event adapter for converting agent messages to A2A protocol - Add A2A execution context for managing agent execution state - Implement A2A executor for running agents in A2A environment - Add comprehensive unit tests for event adapter, execution context, and executor - Update agent framework core A2A module exports and type stubs - Integrate thread management utilities for async execution - Add getting started sample for A2A agent framework integration - Update dependencies in uv.lock This integration enables agent framework agents to communicate and execute within the A2A (Agent to Agent) infrastructure.

…rage in A2A executor tests

- Reordered imports in various files for consistency and clarity. - Updated `__all__` definitions to maintain a consistent order across modules. - Simplified method signatures by removing unnecessary line breaks. - Enhanced readability by adjusting formatting in several sections. - Removed redundant comments and example scenarios in the execution context. - Improved handling of agent messages in the event adapter. - Added type hints for better clarity and type checking. - Cleaned up test cases for better organization and readability.

…orage

- Deleted the test file for A2aExecutionContext as it is no longer needed. - Updated A2aExecutor tests to remove dependencies on A2aExecutionContext and adjusted method calls accordingly. - Modified event adapter tests to use ChatMessage instead of AgentRunResponseUpdate. - Removed A2aExecutionContext from imports in agent_framework.a2a module and updated type hints accordingly.

eavanvalkenburg

I like the idea behind this, but there are some major issues with the implementation, especially the addition of the AgentThreadStore, please discuss that further with us.

- Updated test cases to use A2AExecutor instead of A2aExecutor for consistency. - Removed mock_event_adapter fixture and related tests as A2aEventAdapter is deprecated. - Consolidated event handling tests into TestA2AExecutorEventAdapter. - Adjusted imports in various files to reflect the removal of deprecated components. - Ensured all references to A2aExecutor are updated to A2AExecutor across the codebase.

Shubham-Kumar-2000 · 2025-11-25T21:56:37Z

Hi @eavanvalkenburg thanks for the review.

I have further simplified the code for this feature and have addressed most of you review comments.

Regarding your major concern around AgentThreadStore I have started a discussion to finalize the approach.
#2463

Do let me know if any other changes are required.

…asses from threads and tests

…methods for persistent storage.

…amework into agent_framework_to_a2a

Shubham-Kumar-2000 · 2025-11-30T11:46:27Z

I have successfully addressed all mentioned review comments.
Please re-review.

eavanvalkenburg · 2026-02-16T18:08:43Z

@Shubham-Kumar-2000 we have redone the threads, now called sessions, and the context providers,please update if you can!

Shubham-Kumar-2000 · 2026-02-16T20:17:00Z

@Shubham-Kumar-2000 we have redone the threads, now called sessions, and the context providers,please update if you can!

Sure @eavanvalkenburg give me sometime let me go through the changes.

…nto agent_framework_to_a2a

- Consolidated mock agent fixtures in test_a2a_executor.py to simplify agent mocking. - Removed redundant tests related to thread storage and agent types, focusing on A2AExecutor's core functionality. - Updated test assertions to reflect changes in message handling with new Message and Content classes. - Enhanced integration tests to ensure compatibility with the new agent framework structure. - Added A2AExecutor to the module exports in __init__.py and __init__.pyi for better accessibility.

…Executor

…d_dotenv call in agent_framework_to_a2a.py

…and fix agent creation method

…umar-2000/agent-framework into agent_framework_to_a2a

Shubham-Kumar-2000 · 2026-04-16T15:05:46Z

Hi @eavanvalkenburg I have addressed all new review comments.

eavanvalkenburg · 2026-04-17T15:37:09Z

@Shubham-Kumar-2000 one of the checks fail, please run the pre-commit jobs, it looks like a ruff issue

…iple files

Shubham-Kumar-2000 · 2026-04-17T16:02:00Z

Hi @eavanvalkenburg I have fixed the lint issue and also merged with master.

Copilot

Pull request overview

This PR adds Python “hosting-side” support to expose Agent Framework agents as A2A-compliant servers, complementing the existing A2A client integration.

Changes:

Introduces A2AExecutor to bridge SupportsAgentRun agents into the A2A server execution model (including streaming support).
Updates Agent Framework agent_framework.a2a exports/type stubs and the agent-framework-a2a package exports/docs.
Adds a new hosting sample and a comprehensive unit test suite for the executor.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
python/samples/04-hosting/a2a/agent_framework_to_a2a.py	New sample that hosts an Agent Framework agent via an A2A Starlette app using `A2AExecutor`.
python/samples/04-hosting/a2a/README.md	Documents the new sample and how to run it.
python/packages/core/agent_framework/a2a/init.pyi	Updates typing exports to include `A2AExecutor`.
python/packages/core/agent_framework/a2a/init.py	Extends lazy re-exports to include `A2AExecutor`.
python/packages/a2a/agent_framework_a2a/_a2a_executor.py	Implements the new `A2AExecutor` bridging Agent Framework responses into A2A task events.
python/packages/a2a/agent_framework_a2a/init.py	Exports `A2AExecutor` from the `agent_framework_a2a` package.
python/packages/a2a/tests/test_a2a_executor.py	Adds unit tests covering executor initialization, execution paths, streaming updates, and content conversions.
python/packages/a2a/README.md	Adds documentation for `A2AExecutor` hosting usage alongside `A2AAgent`.
python/packages/a2a/AGENTS.md	Updates package docs to describe both `A2AAgent` (client) and `A2AExecutor` (hosting/bridge).

…ixed review comments

Shubham-Kumar-2000 · 2026-04-20T21:13:07Z

Hi @eavanvalkenburg I have made changes regarding the review comments from Copilot

…ata from data URIs and update references

…tor and A2AAgent

Shubham-Kumar-2000 · 2026-04-21T08:00:42Z

Hi @eavanvalkenburg I have fixed the failing checks.

But it required to move one function used in both A2aAgent and A2aExecutor to be extracted to a common utils.

Shubham-Kumar-2000 · 2026-04-21T08:12:35Z

Please let me know if any anything else is required from my end

…sertions

Shubham-Kumar-2000 · 2026-04-23T07:51:28Z

Hi @eavanvalkenburg
This will require a re review from you as the previous one got stale due to copilot comments & fixes.

Previous commit incorrectly renamed the [1.1.1] header to [1.2.0], which wiped the historical 1.1.1 entries and wrongly attributed them to 1.2.0. This restores [1.1.1] to its origin/main content and adds a new [1.2.0] section above containing only the commits in python-1.1.1..HEAD: - microsoft#4238 functional workflow API - microsoft#5142 GitHub Copilot OpenTelemetry - microsoft#2403 A2A bridge support - microsoft#5070 oauth_consent_request events in Foundry clients - microsoft#5447 FoundryAgent hosted agent sessions - microsoft#5459 hosting server dependency upgrade + types - microsoft#5389 AG-UI reasoning/multimodal parsing fix - microsoft#5440 stop [TOOLBOXES] warning spam - microsoft#5455 user agent prefix fix Also corrects the [1.2.0] compare base to python-1.1.1 (not 1.1.0) and adds the missing [1.1.1] reference link.

* Bump Python package versions for 1.2.0 release Released tier bumps 1.1.1 -> 1.2.0 (core, openai, foundry, root) to reflect additive public APIs landed since 1.1.0: functional workflow API (#4238) and FunctionTool SKIP_PARSING sentinel (#5424). All beta packages stamped 1.0.0b260424, alpha packages 1.0.0a260424. All 26 non-core agent-framework-core floors raised to >=1.2.0,<2. CHANGELOG consolidates the never-tagged 1.1.1 entries with the post-merge additions into [1.2.0]. * Update CHANGELOG footer links for 1.2.0 Advance [Unreleased] comparison base from python-1.1.0 to python-1.2.0 and add a [1.2.0] reference link comparing python-1.1.0...python-1.2.0 so the heading links resolve correctly. * Fix CHANGELOG: restore [1.1.1] section and add proper [1.2.0] Previous commit incorrectly renamed the [1.1.1] header to [1.2.0], which wiped the historical 1.1.1 entries and wrongly attributed them to 1.2.0. This restores [1.1.1] to its origin/main content and adds a new [1.2.0] section above containing only the commits in python-1.1.1..HEAD: - #4238 functional workflow API - #5142 GitHub Copilot OpenTelemetry - #2403 A2A bridge support - #5070 oauth_consent_request events in Foundry clients - #5447 FoundryAgent hosted agent sessions - #5459 hosting server dependency upgrade + types - #5389 AG-UI reasoning/multimodal parsing fix - #5440 stop [TOOLBOXES] warning spam - #5455 user agent prefix fix Also corrects the [1.2.0] compare base to python-1.1.1 (not 1.1.0) and adds the missing [1.1.1] reference link.

* Sync Agent Framework Python docs for PRs since 2026-04-22 Updates docs to reflect changes in microsoft/agent-framework Python PRs merged after MicrosoftDocs/semantic-kernel-pr#982 (2026-04-22). - get-started/workflows.md, AGENTS.md: rename 01-get-started/05_first_workflow.py -> 07_first_graph_workflow.py (microsoft/agent-framework#4238). - integrations/a2a.md: add Python section 'Exposing an Agent Framework agent over A2A' documenting A2AExecutor and the new agent_framework_to_a2a.py sample (microsoft/agent-framework#2403). - agents/providers/github-copilot.md: add Observability subsection in Python zone showing configure_otel_providers() and RawGitHubCopilotAgent (microsoft/agent-framework#5142). - agents/providers/microsoft-foundry.md: add 'Connecting to a deployed (hosted) Foundry agent' subsection covering allow_preview=True / v2 and explicit AIProjectClient session creation (microsoft/agent-framework#5447). - integrations/hyperlight.md: note that result_parser does not run on the sandbox path; tools must format in-sandbox themselves (microsoft/agent-framework#5424). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Defer #4238 (functional workflow API) doc updates to PR author Revert the get-started/workflows.md sample rename and the AGENTS.md mapping update. The author of microsoft/agent-framework#4238 will handle the docs (rename + new functional workflow page) in a dedicated follow-up. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

markwallace-microsoft added documentation Improvements or additions to documentation python labels Nov 23, 2025

github-actions Bot changed the title ~~feat: Add Agent Framework to A2A bridge support~~ Python: feat: Add Agent Framework to A2A bridge support Nov 23, 2025

Shubham-Kumar-2000 added 7 commits November 23, 2025 19:19

fix: Update references from agent_thread_storage to _agent_thread_sto…

828b733

…rage in A2A executor tests

fix: Lint fix new line added

1e600dc

test: Add unit tests for AgentThreadStorage and InMemoryAgentThreadSt…

c7a8b80

…orage

refactor: Update type hints to use new syntax for Union and List

db5bdf3

fix: Validate RequestContext for context_id and message before execution

a3a5c48

eavanvalkenburg reviewed Nov 25, 2025

View reviewed changes

Shubham-Kumar-2000 added 4 commits November 30, 2025 16:38

refactor: Remove AgentThreadStorage and InMemoryAgentThreadStorage cl…

c732a05

…asses from threads and tests

feat: A2AExecutor to have its own override able save and get threads …

64c1cfb

…methods for persistent storage.

fix: linter bugs

1f8a002

Merge branch 'main' of https://github.com/Shubham-Kumar-2000/agent-fr…

293f25d

…amework into agent_framework_to_a2a

Shubham-Kumar-2000 added 2 commits November 30, 2025 17:21

removed unnecessary changes form core package

e3bb889

new line added

960bb22

Shubham-Kumar-2000 requested a review from eavanvalkenburg November 30, 2025 11:53

Shubham-Kumar-2000 added 6 commits February 26, 2026 23:43

Merge branch 'main' of https://github.com/microsoft/agent-framework i…

ed01679

…nto agent_framework_to_a2a

Update A2A documentation: enhance usage examples for A2AAgent and A2A…

f14e7c4

…Executor

Updated uv lock

9d84791

Fix metadata assertion in TestA2AExecutorHandleEvents and reorder loa…

6e61d13

…d_dotenv call in agent_framework_to_a2a.py

Update agent card configuration: add default input and output modes, …

14b17d8

…and fix agent creation method

Merge branch 'agent_framework_to_a2a' of https://github.com/Shubham-K…

877cefd

…umar-2000/agent-framework into agent_framework_to_a2a

Merge branch 'main' into agent_framework_to_a2a

2ce08eb

Shubham-Kumar-2000 requested a review from eavanvalkenburg April 17, 2026 15:24

Shubham-Kumar-2000 and others added 2 commits April 17, 2026 21:25

refactor: streamline imports and improve code readability across mult…

39b1491

…iple files

Merge branch 'main' into agent_framework_to_a2a

6a5f29d

moonbox3 requested a review from Copilot April 20, 2026 07:52

Copilot started reviewing on behalf of moonbox3 April 20, 2026 07:53 View session

Copilot AI reviewed Apr 20, 2026

View reviewed changes

eavanvalkenburg approved these changes Apr 20, 2026

View reviewed changes

feat: enhance A2AExecutor cancel method with context validation and f…

9bb1fae

…ixed review comments

Shubham-Kumar-2000 added 2 commits April 21, 2026 13:16

feat: implement get_uri_data utility function for extracting base64 d…

0257d01

…ata from data URIs and update references

fix: update import path for get_uri_data utility function in A2AExecu…

1e5766c

…tor and A2AAgent

Shubham-Kumar-2000 and others added 2 commits April 22, 2026 01:01

fix: correct error message handling in A2AExecutor and update test as…

9889e68

…sertions

Merge branch 'main' into agent_framework_to_a2a

0f46d52

chetantoshniwal requested a review from SergeyMenshykh April 23, 2026 23:33

moonbox3 approved these changes Apr 24, 2026

View reviewed changes

moonbox3 added this pull request to the merge queue Apr 24, 2026

Merged via the queue into microsoft:main with commit b00465d Apr 24, 2026
32 checks passed

github-project-automation Bot moved this from Community PR to Done in Agent Framework Apr 24, 2026

Conversation

Shubham-Kumar-2000 commented Nov 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation and Context

Description

Contribution Checklist

Uh oh!

eavanvalkenburg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Shubham-Kumar-2000 commented Nov 25, 2025

Uh oh!

Shubham-Kumar-2000 commented Nov 30, 2025

Uh oh!

eavanvalkenburg commented Feb 16, 2026

Uh oh!

Shubham-Kumar-2000 commented Feb 16, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 16, 2026

Uh oh!

eavanvalkenburg commented Apr 17, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Shubham-Kumar-2000 commented Apr 20, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 21, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 21, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Shubham-Kumar-2000 commented Nov 23, 2025 •

edited

Loading