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

markwallace-microsoft · 2026-03-20T02:34:08Z

@Shubham-Kumar-2000, friendly reminder — this issue is waiting on your response. Please share any updates when you get a chance. (This is an automated message.)

Shubham-Kumar-2000 · 2026-03-22T10:04:36Z

Hi I have updated the PR with the new sessions implementation.

Please let me know what more info is required by my side on this?

eavanvalkenburg · 2026-04-10T18:46:38Z

@Shubham-Kumar-2000 sorry about the delays we've been busy with getting things to v1. Could you do another rebase to main and then I'll keep track and help you get this over the line!

Shubham-Kumar-2000 · 2026-04-10T18:50:16Z

Hi @eavanvalkenburg I have merged the master branch.

eavanvalkenburg

Looks quite good overall, few small comments.

eavanvalkenburg · 2026-04-13T09:14:04Z

+            user_message = Message(role="user", contents=[Content.from_text(text=query)])
+
+            # Run the agent with the message list
+            response = await self._agent.run(user_message, session=session)


when i look at our A2A connector, it seems it really only support streaming, should we use:

Suggested change

response = await self._agent.run(user_message, session=session)

response_stream = self._agent.run(user_message, stream=True, session=session)

and then use something like (with a updated handle_events function and a new complete closure that calls updater.complete)):

stream = response_stream.with_transform_hook(self.handle_events).with_finalizer(complete) await stream.get_final_response() # this ensures the whole stream is exhausted

I have added support for both streaming and non-streaming modes

eavanvalkenburg · 2026-04-13T09:14:24Z

+                parts.append(Part(root=FilePart(file=FileWithBytes(bytes=base64_str, mime_type=content.media_type))))
+            elif content.type == "uri" and content.uri:
+                parts.append(Part(root=FilePart(file=FileWithUri(uri=content.uri, mime_type=content.media_type))))
+            # Silently skip unsupported content types


can we at least log those?

eavanvalkenburg · 2026-04-13T09:20:35Z

@@ -0,0 +1,62 @@
+import uvicorn


missing copyright header

Added copyright header

eavanvalkenburg · 2026-04-13T09:21:23Z

+
+    # --8<-- [start:AgentCard]
+    # This will be the public-facing agent card
+    public_agent_card = AgentCard(


could we add a helper function to _a2a_executor that generates this from a Agent object?

We can but only fields available to us as part of agent being common to the AgentCard are name and description . For all other fields, they will just become a parameter to the helper function as well.

We can still go ahead and add a simple helper function but not sure how much helpful it will be.

eavanvalkenburg · 2026-04-13T09:25:47Z

+            user_message = Message(role="user", contents=[Content.from_text(text=query)])
+
+            # Run the agent with the message list
+            response = await self._agent.run(user_message, session=session)


is there no way to get additional options passed from the caller?

Added support to pass additional run_kwargs

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

…ate agent framework sample for flight and hotel booking capabilities

eavanvalkenburg · 2026-04-14T07:32:12Z

+from typing import Annotated
+
 import uvicorn
+from pydantic import Field


doesn't look like this is being used...

…update tests for initialization and execution scenarios

…umar-2000/agent-framework into agent_framework_to_a2a

…pdate tests for new behavior

Shubham-Kumar-2000 · 2026-04-15T22:49:53Z

Hi @eavanvalkenburg I have addressed all the review comments.

Please check once and let me know if any further changes are required from my end.

…attributes

…umar-2000/agent-framework into agent_framework_to_a2a

Shubham-Kumar-2000 · 2026-04-16T14:15:27Z

I have fixed the mypy issue as well

eavanvalkenburg · 2026-04-16T14:02:52Z

+
+    async def _run_stream(self, query: Any, session: AgentSession, updater: TaskUpdater) -> None:
+        """Run the agent in streaming mode and publish updates to the task updater."""
+        response_stream = await self._agent.run(query, session=session, stream=True, **self._run_kwargs)


Suggested change

response_stream = await self._agent.run(query, session=session, stream=True, **self._run_kwargs)

response_stream = self._agent.run(query, session=session, stream=True, **self._run_kwargs)

eavanvalkenburg · 2026-04-16T14:03:34Z

+
+    async def _run(self, query: Any, session: AgentSession, updater: TaskUpdater) -> None:
+        """Run the agent in non-streaming mode and publish messages to the task updater."""
+        response = await self._agent.run(query, session=session, stream=False, **self._run_kwargs)


FYI: this is correct, it depends on the stream param

eavanvalkenburg · 2026-04-16T14:05:15Z

+    # --8<-- [end:AgentCard]
+
+    agent = Agent(
+        client=OpenAIChatCompletionClient(),


let's use at least OpenAIChatClient since that is the modern one, ideally we use FoundryChatClient in our samples, but you might not have that setup, so OpenAI is fine.

Updated, I was actually using gemini and OpenAIChatClient doesn't seems to work with it that's why I was using chat completion client

…response stream handling; clean up imports in agent_framework_to_a2a.py

…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.

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

markwallace-microsoft added the requested-info label Mar 20, 2026

Shubham-Kumar-2000 added 2 commits March 22, 2026 15:34

Merge branch 'main' into agent_framework_to_a2a

46c6dcf

Merge branch 'main' into agent_framework_to_a2a

9791458

eavanvalkenburg self-assigned this Apr 10, 2026

eavanvalkenburg added this to Agent Framework Apr 10, 2026

eavanvalkenburg moved this to Community PR in Agent Framework Apr 10, 2026

Merge branch 'main' into agent_framework_to_a2a

4d3cf2b

eavanvalkenburg reviewed Apr 13, 2026

View reviewed changes

Shubham-Kumar-2000 and others added 2 commits April 13, 2026 23:06

Apply suggestions from code review

50f8e83

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

Refactor A2AExecutor to use SupportsAgentRun and enhance logging; upd…

8e31511

…ate agent framework sample for flight and hotel booking capabilities

eavanvalkenburg reviewed Apr 14, 2026

View reviewed changes

eavanvalkenburg and others added 4 commits April 14, 2026 09:57

Merge branch 'main' into agent_framework_to_a2a

0297c6f

Enhance A2AExecutor with streaming support and custom run arguments; …

327352f

…update tests for initialization and execution scenarios

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

e5b42a9

…umar-2000/agent-framework into agent_framework_to_a2a

Enhance A2AExecutor event handling with streamed artifact tracking; u…

e857572

…pdate tests for new behavior

Shubham-Kumar-2000 and others added 4 commits April 16, 2026 04:21

Merge branch 'main' into agent_framework_to_a2a

81032f8

Refactor A2AExecutor to enforce type hints for stream and run_kwargs …

59dea33

…attributes

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

c1340d3

…umar-2000/agent-framework into agent_framework_to_a2a

Merge branch 'main' into agent_framework_to_a2a

fad2e82

eavanvalkenburg reviewed Apr 16, 2026

View reviewed changes

Shubham-Kumar-2000 added 2 commits April 16, 2026 20:32

Refactor A2AExecutor and tests: replace AsyncMock with MagicMock for …

dae1c19

…response stream handling; clean up imports in agent_framework_to_a2a.py

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

	response = await self._agent.run(user_message, session=session)
	response_stream = self._agent.run(user_message, stream=True, session=session)

	response_stream = await self._agent.run(query, session=session, stream=True, **self._run_kwargs)
	response_stream = self._agent.run(query, session=session, stream=True, **self._run_kwargs)

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!

markwallace-microsoft commented Mar 20, 2026

Uh oh!

Shubham-Kumar-2000 commented Mar 22, 2026

Uh oh!

eavanvalkenburg commented Apr 10, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 10, 2026

Uh oh!

eavanvalkenburg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Shubham-Kumar-2000 commented Apr 15, 2026

Uh oh!

Shubham-Kumar-2000 commented Apr 16, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Shubham-Kumar-2000 commented Nov 23, 2025 •

edited

Loading