Python: [BREAKING] Migrate agent-framework-a2a to a2a-sdk v1.0#5752
Merged
Conversation
Upgrade the a2a-sdk dependency from v0.3.x to v1.0.0 and migrate all
source, tests, samples, and documentation to the v1.0 API.
Key changes:
- Dependency: a2a-sdk>=1.0.0,<2 (was >=0.3.5,<0.3.24)
- Types are now protobuf-based: Part replaces TextPart/FilePart/DataPart
- Enums use SCREAMING_SNAKE_CASE (e.g. TaskState.TASK_STATE_COMPLETED)
- Roles: Role.ROLE_AGENT, Role.ROLE_USER
- Client: SendMessageRequest wrapper, subscribe() replaces resubscribe()
- Server: A2AStarletteApplication replaced by Starlette + route factories
- DefaultRequestHandler now requires agent_card parameter
- TaskUpdater: final parameter removed, add_artifact gains last_chunk
- AgentCard.url removed; use supported_interfaces with AgentInterface
- Stream yields StreamResponse with WhichOneof('payload')
Closes microsoft#5661
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
moonbox3
added
documentation
Contributor
Python Test Coverage Report •
Python Unit Test Overview
|
|||||||||||||||||||||||||||||||||||
giles17
changed the title
giles17
changed the title
Contributor
There was a problem hiding this comment.
Pull request overview
Migrates the Python agent-framework-a2a package and related samples/tests/docs from a2a-sdk 0.3.x to 1.0.x, updating protocol types, enums, streaming payload handling, and server route setup to align with A2A protocol v1.0.
Changes:
- Upgraded
a2a-sdkdependency constraints and regenerateduv.lockfor the new dependency graph. - Refactored the A2A agent + executor implementation to use protobuf-backed
Part/StreamResponse, updated enum/role values, and updated client request wrappers (SendMessageRequest,SubscribeToTaskRequest,GetTaskRequest). - Updated samples, docs, and unit tests to the new server route model (
Starlette+create_*_routes) and updated A2A types.
Reviewed changes
Copilot reviewed 10 out of 11 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| python/uv.lock | Locks a2a-sdk v1.x and new transitive dependencies. |
| python/packages/a2a/pyproject.toml | Updates a2a-sdk requirement to >=1.0.0,<2. |
| python/packages/a2a/agent_framework_a2a/_agent.py | Migrates agent streaming/client logic to v1 StreamResponse + protobuf metadata handling. |
| python/packages/a2a/agent_framework_a2a/_a2a_executor.py | Migrates executor task creation + content-to-Part mapping to v1 APIs. |
| python/packages/a2a/tests/test_a2a_agent.py | Updates agent tests to StreamResponse payload model and new enums/parts. |
| python/packages/a2a/tests/test_a2a_executor.py | Updates executor tests for new task creation helper and enums/parts. |
| python/packages/a2a/AGENTS.md | Updates hosting guidance to Starlette route factories and new handler requirements. |
| python/samples/04-hosting/a2a/agent_framework_to_a2a.py | Updates sample hosting app from A2AStarletteApplication to Starlette routes + supported_interfaces. |
| python/samples/04-hosting/a2a/a2a_server.py | Updates sample server to new DefaultRequestHandler signature and Starlette routes. |
| python/samples/04-hosting/a2a/agent_definitions.py | Updates AgentCard construction to use supported_interfaces instead of url. |
| python/samples/04-hosting/a2a/agent_executor.py | Updates sample executor output to new Part/Role/TaskState enum names. |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
- Raise ValueError with clear message when transport negotiation fails and no fallback URL is available (neither url arg nor supported_interfaces) - Remove unused task_id local in status_update branch - Inline artifact_event.task_id directly in artifact_update branch Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
TaoChenOSU
approved these changes
May 11, 2026
moonbox3
approved these changes
May 11, 2026
learn-build-service-prod Bot
pushed a commit
to MicrosoftDocs/semantic-kernel-docs
that referenced
this pull request
May 20, 2026
Update the Python zone pivot in integrations/a2a.md to reflect breaking changes from a2a-sdk v0.3 to v1.0 (microsoft/agent-framework#5752 and microsoft/agent-framework#5849): - Replace A2AStarletteApplication with Starlette + route helpers - Add agent_card parameter to DefaultRequestHandler - Replace AgentCard.url with supported_interfaces/AgentInterface - Fix camelCase to snake_case (defaultInputModes -> default_input_modes) - Add rpc_url parameter to create_jsonrpc_routes - Fix resubscribe -> subscribe terminology - Update A2AExecutor description (remove stale save_thread/get_thread) - Add language parity table - Update ms.date Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation and Context
Migrates the Python
agent-framework-a2apackage froma2a-sdkv0.3.x to v1.0, aligning with the A2A protocol v1.0 release. This is the Python counterpart of the .NET migration in #5423.Closes #5661
Description
Upgrades the
a2a-sdkdependency from>=0.3.5,<0.3.24to>=1.0.0,<2and migrates all source code, tests, samples, and documentation to the v1.0 API.Source changes (
_agent.py,_a2a_executor.py):PartreplacesTextPart/FilePart/DataPartTaskState.TASK_STATE_COMPLETED)Role.ROLE_AGENT,Role.ROLE_USERSendMessageRequestwrapper,subscribe()replacesresubscribe()StreamResponsewithWhichOneof('payload')TaskUpdater.update_status:finalparameter removedMessageToDictServer/sample changes:
A2AStarletteApplicationreplaced byStarlette+create_agent_card_routes()/create_jsonrpc_routes()DefaultRequestHandlernow requiresagent_cardparameterAgentCard.urlremoved; usesupported_interfaceswithAgentInterfaceTests:
Contribution Checklist
a2a-sdk>=1.0.0. This is a breaking change in the upstream dependency, not in Agent Framework's public API.