PyPI · #1116 most downloaded on PyPI

a2a-sdk

1.2.111M downloads/moa2aproject/a2a-python ↗New releases in your daily digest, changelog included.

A2A Python SDK

Last release 4 days ago
30 Sep 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 54 of 54 stable releases
1 version withdrawn
withdrawn after publishing
1 years old
62 releases · first in 2025

Release timeline

62 releases since 2025

20252026

One column per month.

Releases

1.2.130 Sept 20263 sources agree
server: use keyset cursors for ListTasks page tokens ( #1282 ) ( b7cba7c ), closes #1280
1.2.1 (2026-09-30)

Bug Fixes

server: use keyset cursors for ListTasks page tokens (#1282) (b7cba7c), closes #1280
Open source →
1.2.029 Sept 20263 sources agree
rest: serve HTTP+JSON responses as application/a2a+json
1.2.0 (2026-09-29)

Features

rest: serve HTTP+JSON responses as application/a2a+json (#1274) (dc5a5da)

server: add caching headers to the agent card endpoint (#1272) (83d7f5d)

server: add multi-replica cluster mode (#1281) (942d621)

server: add opt-in validation of message media types against the agent card (#1269) (8037b24)

Bug Fixes

compare in-memory task timestamps numerically (#1233) (0d5473c)

server: ignore unrecognized request fields and fix parse-error data shape (#1273) (83f1cf8)

server: reject a message whose contextId disagrees with its task (#1270) (c25022f)

server: reject terminal-task operations with UnsupportedOperationError (#1268) (6cce91b)

server: send PushNotificationConfig.authentication as an Authorization header (#1271) (5751d31), closes #585

Documentation

samples: add Agent Card signing sample (#1198) (f3ac824)

1.1.521 Sept 2026Deprecated3 sources agree

replace deprecated FieldDescriptor.label with is_repeated in proto_utils

1.1.5 (2026-09-21)

Bug Fixes

deps: support protobuf 7 (#1260) (67ba0a4)
replace deprecated FieldDescriptor.label with is_repeated in proto_utils (#1158) (4554e2d)
server: avoid out-of-range datetime task ordering (#1220) (d55a3d3)

Open source →

1.1.418 Sept 20263 sources agree

itk: register itk-python-v10-agent as a uv workspace member and update dependency version markers

1.1.4 (2026-09-07)

Features

itk: register itk-python-v10-agent as a uv workspace member and update dependency version markers (#1203) (6eee895)
itk: use shared scenarios (#1201) (b4a0b21)

Bug Fixes

make event queue sink removal idempotent (#1134) (58c72c6)
omit artifacts from list tasks responses (#1212) (35ef52e)
owner-scope cancel/subscribe and write terminal state on cancel (#1159, #1170) (#1172) (ddbf853)
prevent first-owner write loss in in-memory stores (#1194) (bcc489c)
server: let subscriber taps evict on full instead of wedging dispatch (#1137) (0c2126f)
server: surface producer errors after failed tasks (#1229) (bc32d7e)
server: validate push-notification URLs at config creation (#1173) (3eb88e2)
server: validate push-notification URLs before dispatch (SSRF hardening) (#1164) (57a9df3)
server: warn when queue_manager is ignored in DefaultRequestHandlerV2 (#1153) (08fd223)

Documentation

server: say what the evict-on-full check actually tests (#1209) (4b7b242)

Open source →

1.1.318 Sept 20263 sources agree

use threading.RLock for in-memory server singletons

1.1.3 (2026-08-18)

Bug Fixes

use threading.RLock for in-memory server singletons (#1162) (5bae35b)

Open source →

1.1.222 Jul 20263 sources agree

server: add aclose() to drain ActiveTask background tasks

1.1.2 (2026-07-20)

Features

server: add aclose() to drain ActiveTask background tasks (#1101) (#1105) (9801f46)

Bug Fixes

agent_execution: resolve ActiveTask 'destroyed but pending' warning during teardown (#1122) (d19c4d2)
persist early producer failure as FAILED with originating message (#1106) (4e3d724)

Open source →

1.1.116 Jul 20263 sources agree

server: improve Swagger /docs example annotations for A2A routes

1.1.1 (2026-07-15)

Bug Fixes

server: improve Swagger /docs example annotations for A2A routes (#1092) (46b292b)

Miscellaneous Chores

grpc: eliminate third-party grpcio-status dependency (#1130) (723880e)
http: eliminate httpx-sse dependency (#1132) (0d82ab9)

Open source →

1.1.029 May 20263 sources agree

server: restore FastAPI /docs visibility for A2A routes

1.1.0 (2026-05-29)

Features

server: restore FastAPI /docs visibility for A2A routes (#1024) (1122d4e)

Bug Fixes

compat: remove ListTasks from v0.3 REST adapter (#1043) (#1068) (5c88793)
properly convert metadata to dict in RequestContext.metadata (#1081) (d2f2e18)
raise on append=True for unknown artifact_id (#1038) (#1077) (fe1f24b)
release reference count on non-terminal exit to prevent stale registry entries (#1079) (501255c)
server: preserve non-ASCII characters in streaming JSON responses (#1080) (d46c6f9)
telemetry: don't mark QueueShutDown as an error span (#1075) (54a485c)

Documentation

clarify EventQueue usage (#1066) (11dd68a)

Miscellaneous Chores

release 1.1.0 (#1088) (3058a33)

Open source →

1.0.313 May 20263 sources agree

helpers: add non-text Part extractors and artifact update events

1.0.3 (2026-05-13)

Features

helpers: add non-text Part extractors and artifact update events (745d998)

Bug Fixes

deps: cap protobuf below 7 (#1019) (7af6050)
errors: align error mappings with A2A spec (#1055) (4e01a91)
errors: emit JSON-RPC error.data as typed-details array per A2A 1.0 spec hot-fix (#1058) (3ce65c5)
Improve task_push_notification_config presence check. (#1047) (94ad594)

Documentation

high level active task architecture documentation (#1056) (09a2221)

Open source →

1.0.224 Apr 20263 sources agree

helpers: add non-text Part, Message, and Artifact helpers

1.0.2 (2026-04-24)

Features

helpers: add non-text Part, Message, and Artifact helpers (#1004) (cfdbe4c)

Bug Fixes

proto: use field.label instead of is_repeated for protobuf compatibility (#1010) (7d197db)
server: deliver push notifications across all owners (#1016) (c24ae05)

Open source →

1.0.122 Apr 20263 sources agree

compat: avoid unconditional grpc import in v0.3 context builders

1.0.1 (2026-04-22)

Bug Fixes

compat: avoid unconditional grpc import in v0.3 context builders (#1006) (6b46ceb)

Open source →

1.0.020 Apr 20263 sources agree

See the v0.3 → v1.0 migration guide and changelog entries for alpha versions below.

1.0.0 (2026-04-20)

See the v0.3 → v1.0 migration guide and changelog entries for alpha versions below.

⚠ BREAKING CHANGES

remove Vertex AI Task Store integration (#999)

Bug Fixes

rely on agent executor implementation for stream termination (#988) (d77cd68)

Documentation

add comprehensive v0.3 to v1.0 migration guide (#987) (10dea8b)

Miscellaneous Chores

release 1.0.0 (530ec37)
remove Vertex AI Task Store integration (#999) (7fce2ad)

Open source →

1.0.0a317 Apr 2026pre-release3 sources agree

update with_a2a_extensions to append instead of overwriting

1.0.0-alpha.3 (2026-04-17)

Bug Fixes

update with_a2a_extensions to append instead of overwriting (#985) (e1d0e7a)

Open source →

1.0.0a217 Apr 2026pre-release3 sources agree

clean helpers and utils folders structure

1.0.0-alpha.2 (2026-04-17)

⚠ BREAKING CHANGES

clean helpers and utils folders structure (#983)
Raise errors on invalid AgentExecutor behavior. (#979)
extract developer helpers in helpers folder (#978)

Features

Raise errors on invalid AgentExecutor behavior. (#979) (f4a0bcd)
utils: add display_agent_card() utility for human-readable AgentCard inspection (#972) (3468180)

Bug Fixes

Don't generate empty metadata change events in VertexTaskStore (#974) (b58b03e), closes #802
extensions: support both header names and remove "activation" concept (#984) (b8df210)

Documentation

AgentExecutor interface documentation (#976) (d667e4f)
move ai_learnings.md to local-only and update GEMINI.md (#982) (f6610fa)

Code Refactoring

clean helpers and utils folders structure (#983) (c87e87c)
extract developer helpers in helpers folder (#978) (5f3ea29)

Open source →

1.0.0a110 Apr 2026pre-releaseDeprecated3 sources agree

remove the use of deprecated types from VertexTaskStore

1.0.0-alpha.1 (2026-04-10)

⚠ BREAKING CHANGES

client: make ClientConfig.push_notification_config singular (#955)
client: reorganize ClientFactory API (#947)
server: add build_user function to DefaultContextBuilder to allow A2A user creation customization (#925)
client: remove ClientTaskManager and Consumers from client (#916)
server: migrate from Application wrappers to Starlette route-based endpoints for rest (#892)
server: migrate from Application wrappers to Starlette route-based endpoints for jsonrpc (#873)

Features

A2A Version Header validation on server side. (#865) (b261ceb)
Add GetExtendedAgentCard Support to RequestHandlers (#919) (2159140)
Add support for more Task Message and Artifact fields in the Vertex Task Store (#936) (605fa49)
Create EventQueue interface and make tap() async. (#914) (9ccf99c), closes #869
EventQueue - unify implementation between python versions (#877) (7437b88), closes #869
EventQueue is now a simple interface with single enqueue_event method. (#944) (f0e1d74)
Implementation of DefaultRequestHandlerV2 (#933) (462eb3c), closes #869
InMemoryTaskStore creates a copy of Task by default to make it consistent with database task stores (#887) (8c65e84), closes #869
merge metadata of new and old artifact when append=True (#945) (cc094aa)
server: add async context manager support to EventQueue (#743) (f68b22f)
server: validate presence according to google.api.field_behavior annotations (#870) (4586c3e)
Simplify ActiveTask.subscribe() (#958) (62e5e59)
Support AgentExectuor enqueue of a Task object. (#960) (12ce017)
Support Message-only simplified execution without creating Task (#956) (354fdfb)
Unhandled exception in AgentExecutor marks task as failed (#943) (4fc6b54)

Bug Fixes

Add packaging to base dependencies (#897) (7a9aec7)
client: do not mutate SendMessageRequest in BaseClient.send_message (#949) (94537c3)
fix athrow() RuntimeError on streaming responses (#912) (ca7edc3)
fix docstrings related to CallContextBuilder args in constructors and make ServerCallContext mandatory in compat folder (#907) (9cade9b)
fix error handling for gRPC and SSE streaming (#879) (2b323d0)
fix JSONRPC error handling (#957) (6c807d5)
fix REST error handling (#893) (405be3f)
handle SSE errors occurred after stream started (#894) (3a68d8f)
remove the use of deprecated types from VertexTaskStore (#889) (6d49122)
Remove unconditional SQLAlchemy dependency from SDK core (#898) (ab762f0), closes #883
remove unused import and request for FastAPI in pyproject (#934) (fe5de77)
replace stale entry in a2a.types.all with actual import name (#902) (05cd5e9)
wrong method name for ExtendedAgentCard endpoint in JsonRpc compat version (#931) (5d22186)

Documentation

add Database Migration Documentation (#864) (fd12dff)

Miscellaneous Chores

release 1.0.0-alpha.1 (a61f6d4)

Code Refactoring

client: make ClientConfig.push_notification_config singular (#955) (be4c5ff)
client: remove ClientTaskManager and Consumers from client (#916) (97058bb), closes #734
client: reorganize ClientFactory API (#947) (01b3b2c)
server: add build_user function to DefaultContextBuilder to allow A2A user creation customization (#925) (2648c5e)
server: migrate from Application wrappers to Starlette route-based endpoints for jsonrpc (#873) (734d062)
server: migrate from Application wrappers to Starlette route-based endpoints for rest (#892) (4be2064)

Open source →

1.0.0a017 Mar 2026pre-release3 sources agree

spec: upgrade SDK to A2A 1.0 spec and use proto-based types (#572, #665, #804, #765)

1.0.0-alpha.0 (2026-03-17)

⚠ BREAKING CHANGES

spec: upgrade SDK to A2A 1.0 spec and use proto-based types (#572, #665, #804, #765)
client: introduce ServiceParameters for extensions and include it in ClientCallContext (#784)
client: rename "callback" -> "push_notification_config" (#749)
client: transport agnostic interceptors (#796) (a910cbc)
add protocol_version column to Task and PushNotificationConfig models and create a migration (#789) (2e2d431)
server: implement Resource Scoping for tasks and push notifications (#709) (f0d4669)

Features

add GetExtendedAgentCardRequest as input parameter to GetExtendedAgentCard method (#767) (13a092f)
add validation for the JSON-RPC version (#808) (6eb7e41)
client: expose close() and async context manager support on abstract Client (#719) (e25ba7b)
compat: AgentCard backward compatibility helpers and tests (#760) (81f3494)
compat: GRPC client compatible with 0.3 server (#779) (0ebca93)
compat: GRPC server compatible with 0.3 client (#772) (80d827a)
compat: legacy v0.3 protocol models, conversion logic and utilities (#754) (26835ad)
compat: REST and JSONRPC clients compatible with 0.3 servers (#798) (08794f7)
compat: REST and JSONRPC servers compatible with 0.3 clients (#795) (9856054)
compat: set a2a-version header to 1.0.0 (#764) (4cb68aa)
compat: unify v0.3 REST url prefix and expand cross-version tests (#820) (0925f0a)
database forward compatibility: make owner field optional (#812) (cc29d1f)
handle tenant in Client (#758) (5b354e4)
implement missing push notifications related methods (#711) (041f0f5)
implement rich gRPC error details per A2A v1.0 spec (#790) (245eca3)
rest: add tenant support to rest (#773) (4771b5a)
send task as a first subscribe event (#716) (e71ac62)
server, grpc: Implement tenant context propagation for gRPC requests. (#781) (164f919)
server, json-rpc: Implement tenant context propagation for JSON-RPC requests. (#778) (72a330d)
server: add v0.3 legacy compatibility for database models (#783) (08c491e)
spec: add tasks/list method with filtering and pagination to the specification (#511) (d5818e5)
use StreamResponse as push notifications payload (#724) (a149a09)
rest: update REST error handling to use google.rpc.Status (#838) (ea7d3ad)

Bug Fixes

add history length and page size validations (#726) (e67934b)
allign error codes with the latest spec (#826) (709b1ff)
client: align send_message signature with BaseClient (#740) (57cb529)
get_agent_card trailing slash when agent_card_path="" (#799) (#800) (a55c97e)
handle parsing error in REST (#806) (bbd09f2)
Improve error handling for Timeout exceptions on REST and JSON-RPC clients (#690) (2acd838)
Improve streaming errors handling (#576) (7ea7475)
properly handle unset and zero history length (#717) (72a1007)
return entire history when history_length=0 (#537) (acdc0de)
return mandatory fields from list_tasks (#710) (6132053)
taskslist error on invalid page token and response serialization (#814) (a102d31)
use correct REST path for Get Extended Agent Card operation (#769) (ced3f99)
Use POST method for REST endpoint /tasks/{id}:subscribe (#843) (a0827d0)

Open source →

0.3.269 Apr 2026Deprecated3 sources agree

remove the use of deprecated types from VertexTaskStore

0.3.26 (2026-04-09)

Features

Add support for more Task Message and Artifact fields in the Vertex Task Store (#908) (5e0dcd7)

Bug Fixes

remove the use of deprecated types from VertexTaskStore (#889) (6d49122)

Open source →

0.3.2510 Mar 20263 sources agree

Implement a vertex based task store

0.3.25 (2026-03-10)

Features

Implement a vertex based task store (#752) (fa14dbf)

Bug Fixes

return background task from consume_and_break_on_interrupt to prevent GC (#775) (a236d4d)
use default_factory for mutable field defaults in ServerCallContext (#744) (22b25d6)

Open source →

0.3.2420 Feb 2026Deprecated3 sources agree

deps: DeprecationWarning on HTTP_413_REQUEST_ENTITY_TOO_LARGE

0.3.24 (2026-02-20)

Bug Fixes

core: preserve legitimate falsy values in _clean_empty (#713) (7632f55)
deps: DeprecationWarning on HTTP_413_REQUEST_ENTITY_TOO_LARGE (#693) (9968f9c)

Open source →

0.3.2317 Feb 20263 sources agree

add async context manager support to BaseClient

0.3.23 (2026-02-13)

Features

add async context manager support to BaseClient (#688) (ae9dc88)
add async context manager support to ClientTransport (#682) (2e45c0d)
support async card modifiers (#654) (a802500)
support disabling OTel instrumentation via env var (#611) (72216b9)

Bug Fixes

do not crash on SSE comment line (#636) (3dcb847)
gRPC metadata header casing and invocation_metadata() call (#676) (390b763)
Improve error handling for Timeout exceptions on REST and JSON-RPC clients (#690) (2acd838)
map rejected task state in proto converters (#668) (957e92b), closes #625
server: fix deadlocks on agent execution failure in non-streaming (#614) (d3c973f)

Documentation

explicitly mention supported spec version and transports in readme (#681) (c91d4fb), closes #677
Update README to include Code Wiki badge (2698cc0)

Open source →

0.3.2216 Dec 20253 sources agree

Add custom ID generators to SimpleRequestContextBuilder

0.3.22 (2025-12-16)

Features

Add custom ID generators to SimpleRequestContextBuilder (#594) (04bcafc)

Code Refactoring

Move agent card signature verification into A2ACardResolver (6fa6a6c)

Open source →

0.3.2112 Dec 2025

## 0.3.21 (2025-12-12) ### Documentation * Fixing typos

0.3.21 (2025-12-12)

Documentation

Fixing typos (#586) (5fea21f)

Open source →

Additional notes2 sources agree

Documentation

Fixing typos (#586) (5fea21f)

Open source →

0.3.203 Dec 20253 sources agree

Improve streaming errors handling

0.3.20 (2025-12-03)

Bug Fixes

Improve streaming errors handling (#576) (7ea7475)

Open source →

0.3.1925 Nov 20253 sources agree

jsonrpc, rest: extensions support in get_card methods in json-rpc and rest transports

0.3.19 (2025-11-25)

Bug Fixes

jsonrpc, rest: extensions support in get_card methods in json-rpc and rest transports (#564) (847f18e)

Open source →

0.3.1825 Nov 20253 sources agree

return updated agent_card in JsonRpcTransport.get_card()

0.3.18 (2025-11-24)

Bug Fixes

return updated agent_card in JsonRpcTransport.get_card() (#552) (0ce239e)

Open source →

0.3.1724 Nov 20253 sources agree

client: allow specifying history_length via call-site MessageSendConfiguration in BaseClient.send_message

0.3.17 (2025-11-24)

Features

client: allow specifying history_length via call-site MessageSendConfiguration in BaseClient.send_message (53bbf7a)

Open source →

0.3.1621 Nov 20253 sources agree

Ensure metadata propagation for Task ToProto and FromProto conversion

0.3.16 (2025-11-21)

Bug Fixes

Ensure metadata propagation for Task ToProto and FromProto conversion (#557) (fc31d03)

Open source →

0.3.1519 Nov 2025

Add client-side extension support

0.3.15 (2025-11-19)

Features

Add client-side extension support (https://github.com/a2aproject/a2a-python/pull/525) (https://github.com/a2aproject/a2a-python/commit/9a92bd238e7560b195165ac5f78742981760525e)
rest, jsonrpc: Add client-side extension support (https://github.com/a2aproject/a2a-python/commit/9a92bd238e7560b195165ac5f78742981760525e)

Open source →

Additional notes2 sources agree

Features

Add client-side extension support (#525) (9a92bd2)
rest, jsonrpc: Add client-side extension support (9a92bd2)

Open source →

0.3.1418 Nov 20253 sources agree

jsonrpc: add option to disable oversized payload check in JSONRPC applications

0.3.14 (2025-11-17)

Features

jsonrpc: add option to disable oversized payload check in JSONRPC applications (ba142df)

Open source →

0.3.1317 Nov 20253 sources agree

return entire history when history_length=0

0.3.13 (2025-11-13)

Bug Fixes

return entire history when history_length=0 (#537) (acdc0de)

Open source →

0.3.1212 Nov 20253 sources agree

grpc: Add extensions to Artifact converters.

0.3.12 (2025-11-12)

Bug Fixes

grpc: Add extensions to Artifact converters. (#523) (c03129b)

Open source →

0.3.117 Nov 20253 sources agree

add metadata to send message request

0.3.11 (2025-11-07)

Bug Fixes

add metadata to send message request (12b4a1d)

Open source →

0.3.1021 Oct 20253 sources agree

add get_artifact_text() helper method

0.3.10 (2025-10-21)

Features

add get_artifact_text() helper method (9155888)
Add a ClientFactory.connect() method for easy client creation (d585635)

Bug Fixes

change MAX_CONTENT_LENGTH (for file attachment) in json-rpc to be larger size (10mb) (#518) (5b81385)
correct new_artifact methods signature (#503) (ee026aa)

Code Refactoring

utils: move part helpers to their own file (9155888)

Open source →

0.3.915 Oct 20253 sources agree

apply history_length for message/send requests

0.3.9 (2025-10-15)

Features

custom ID generators (051ab20)

Bug Fixes

apply history_length for message/send requests (#498) (a49f94e)
client: A2ACardResolver.get_agent_card will auto-populate with agent_card_path when relative_card_path is empty (#508) (ba24ead)

Documentation

Fix Docstring formatting for code samples (#492) (dca66c3)

Open source →

0.3.86 Oct 20253 sources agree

Add __str__ and __repr__ methods to ServerError

0.3.8 (2025-10-06)

Bug Fixes

Add __str__ and __repr__ methods to ServerError (#489) (2c152c0)
grpc: Fix missing extensions from protobuf (#476) (8dbc78a)
rest: send historyLength=0 (avoid falsy omission) (#480) (ed28b59), closes #479

Documentation

a2a-sdk[all] installation command in Readme (#485) (6ac9a7c)

Open source →

0.3.723 Sept 20253 sources agree

jsonrpc client send streaming request header and timeout field

0.3.7 (2025-09-22)

Bug Fixes

jsonrpc client send streaming request header and timeout field (#475) (675354a)
Task state is not persisted to task store after client disconnect (#472) (5342ca4), closes #464

Open source →

0.3.617 Sept 20253 sources agree

add JSON-RPC method to ServerCallContext.state

0.3.6 (2025-09-09)

Features

add JSON-RPC method to ServerCallContext.state (d62df7a)
gRPC: Add proto conversion utilities (80fc33a)

Miscellaneous Chores

release 0.3.6 (acc9d3b)

Open source →

0.3.58 Sept 20253 sources agree

Prevent client disconnect from stopping task execution (#440) (58b4c81), closes #296

0.3.5 (2025-09-08)

Bug Fixes

Prevent client disconnect from stopping task execution (#440) (58b4c81), closes #296
proto: Adds metadata field to A2A DataPart proto (#455) (6d0ef59)

Documentation

add example docs for [@validate](https://github.com/validate) and [@validate](https://github.com/validate)_async_generator (#422) (18289eb)
Restructure README (9758f78)

Open source →

0.3.42 Sept 20253 sources agree

Add ServerCallContext into task store operations

0.3.4 (2025-09-02)

Features

Add ServerCallContext into task store operations (#443) (e3e5c4b)
Add extensions support to TaskUpdater.add_artifact (#436) (598d8a1)

Bug Fixes

convert auth_required state in proto utils (#444) (ac12f05)
handle concurrent task completion during cancellation (#449) (f4c9c18)
Remove logger error from init on rest_adapter and jsonrpc_app (#439) (9193208)
resolve streaming endpoint deadlock by pre-consuming request body (#426) (4186731)
Sync jsonrpc and rest implementation of authenticated agent card (#441) (9da9ecc)

Performance Improvements

Improve performance and code style for proto_utils.py (#452) (1e4b574)

Open source →

0.3.325 Aug 20253 sources agree

Update proto conversion utilities

0.3.3 (2025-08-22)

Features

Update proto conversion utilities (#424) (a3e7e1e)

Bug Fixes

fixing JSONRPC error mapping (#414) (d2e869f)
Revert code that enforces uuid structure on context id in tasks (#429) (e3a7207), closes #427

Performance Improvements

optimize logging performance and modernize string formatting (#411) (3ffae8f)

Reverts

Revert "chore(gRPC): Update a2a.proto to include metadata on GetTaskRequest" (#428) (39c6b43)

Open source →

0.3.220 Aug 20253 sources agree

Add missing mime_type and name in proto conversion utils

0.3.2 (2025-08-20)

Bug Fixes

Add missing mime_type and name in proto conversion utils (#408) (72b2ee7)
Add name field to FilePart protobuf message (#403) (1dbe33d)
Client hangs when implementing AgentExecutor and awaiting twice in execute method (#379) (c147a83)
grpc: Update CreateTaskPushNotificationConfig endpoint to /v1/{parent=tasks/*/pushNotificationConfigs} (#415) (73dddc3)
make event_consumer tolerant to closed queues on py3.13 (#407) (a371461)
non-blocking send_message server handler not invoke push notification (#394) (db82a65)
proto: Add icon_url to a2a.proto (#416) (00703e3)
spec: Suggest Unique Identifier fields to be UUID (#405) (da14cea)

Open source →

0.3.113 Aug 20253 sources agree

Add agent card as a route in rest adapter

0.3.1 (2025-08-13)

Features

Add agent card as a route in rest adapter (ba93053)

Bug Fixes

gracefully handle task exceptions in event consumer (#383) (2508a9b)
openapi working in sub-app (#324) (dec4b48)
Pass message_length param in get_task() (#384) (b6796b9)
relax protobuf dependency version requirement (#381) (0f55f55)
Use HasField for simple message retrieval for grpc transport (#380) (3032aa6)

Open source →

0.3.031 Jul 2025Deprecated3 sources agree

Support for serving agent card at deprecated path

0.3.0 (2025-07-31)

⚠ BREAKING CHANGES

deps: Make opentelemetry an optional dependency (#369)
spec: Update Agent Card Well-Known Path to /.well-known/agent-card.json (#320)
Remove custom __getattr__ and __setattr__ for camelCase fields in types.py (#335)
- Use Script refactor_camel_to_snake.sh to convert your codebase to the new field names.
Add mTLS to SecuritySchemes, add oauth2 metadata url field, allow Skills to specify Security (#362)
Support for serving agent card at deprecated path (#352)

Features

Add metadata as parameter to TaskUpdater.update_status() (#371) (9444ed6)
Add mTLS to SecuritySchemes, add oauth2 metadata url field, allow Skills to specify Security (#362) (be6c517)
Add RESTful API Serving (#348) (82a6b7c)
Add server-side support for plumbing requested and activated extensions (#333) (4d5b92c)
Allow agent cards (default and extended) to be dynamic (#365) (ee92aab)
Support for serving agent card at deprecated path (#352) (2444034)
support non-blocking sendMessage (#349) (70b4999)
Type update to support fetching extended card (#361) (83304bb)

Bug Fixes

Add Input Validation for Task Context IDs in new_task Function (#340) (a7ed7ef)
deps: Reduce FastAPI library required version to 0.95.0 (#372) (a319334)
Remove DeprecationWarning for regular properties (#345) (2806f3e)
spec: Add SendMessageRequest.request json_name mapping to message proto (bc97cba)
spec: Add Transport enum to specification (https://github.com/a2aproject/A2A/pull/909) (d9e463c)

Documentation

Address typos in docstrings and docs. (#370) (ee48d68)

Miscellaneous Chores

Add support for authenticated extended card method (#356) (b567e80)

Code Refactoring

deps: Make opentelemetry an optional dependency (#369) (9ad8b96)
Remove custom __getattr__ and __setattr__ for camelCase fields in types.py (#335) (cd94167)
spec: Update Agent Card Well-Known Path to /.well-known/agent-card.json (#320) (270ea9b)

Open source →

0.2.1621 Jul 2025Deprecated3 sources agree

Add deprecation warning for camelCase alias

0.2.16 (2025-07-21)

Features

Convert fields in types.py to use snake_case (#199) (0bb5563)

Bug Fixes

Add deprecation warning for camelCase alias (#334) (f22b384)
client should not specify taskId if it doesn't exist (#264) (97f1093)

Open source →

0.2.1521 Jul 20253 sources agree

Add Input Validation for Empty Message Content

0.2.15 (2025-07-21)

Bug Fixes

Add Input Validation for Empty Message Content (#327) (5061834)
Prevent import grpc issues for Client after making dependencies optional (#330) (53ad485), closes #326

Open source →

0.2.1418 Jul 2025withdrawn: gRPC requirements handled incorrectly3 sources agree

Set grpc dependencies as optional

CAUTION: Yanked Release

0.2.14 (2025-07-18)

Features

Set grpc dependencies as optional (#322) (365f158)
spec: Update A2A types from specification 🤖 (#325) (02e7a31)

Open source →

0.2.1317 Jul 20253 sources agree

Add get_data_parts() and get_file_parts() helper methods

0.2.13 (2025-07-17)

Features

Add get_data_parts() and get_file_parts() helper methods (#312) (5b98c32)
Support for Database based Push Config Store (#299) (e5d99ee)
Update A2A types from specification 🤖 (#319) (18506a4)

Bug Fixes

Add Input Validation for Task IDs in TaskManager (#310) (a38d438)
Add validation for empty artifact lists in completed_task (#308) (c4a324d)
Handle readtimeout errors. (#305) (b94b8f5), closes #249

Documentation

Update Documentation Site Link (#315) (edf392c)

Open source →

0.2.1214 Jul 20253 sources agree

add metadata property to RequestContext

0.2.12 (2025-07-14)

Features

add metadata property to RequestContext (#302) (e781ced)
add A2ABaseModel (#292) (24f2eb0)
add support for notification tokens in PushNotificationSender (#266) (75aa4ed)
Update A2A types from specification 🤖 (#289) (ecb321a)

Bug Fixes

add proper a2a request body documentation to Swagger UI (#276) (4343be9), closes #274
Handle asyncio.cancellederror and raise to propagate back (#293) (9d6cb68)
Improve error handling in task creation (#294) (6412c75)
Resolve dependency issue with sql stores (#303) (2126828)
Send push notifications for message/send (#298) (0274112)
server: Improve event consumer error handling (#282) (a5786a1)

Open source →

0.2.118 Jul 20253 sources agree

Removes push_notifier interface from the SDK and introduces push_notification_config_store and push_notification_sender for supporting push notificati

0.2.11 (2025-07-07)

⚠ BREAKING CHANGES

Removes push_notifier interface from the SDK and introduces push_notification_config_store and push_notification_sender for supporting push notifications.

Features

Add constants for Well-Known URIs (#271) (1c8e12e)
Adds support for List and Delete push notification configurations. (f1b576e)
Adds support for more than one push_notification_config per task. (f1b576e)
server: Add lock to TaskUpdater to prevent race conditions (#279) (1022093)
Support for database backend Task Store (#259) (7c46e70)

Code Refactoring

Removes push_notifier interface from the SDK and introduces push_notification_config_store and push_notification_sender for supporting push notifications. (f1b576e)

Open source →

0.2.1030 Jun 20253 sources agree

Update to A2A Spec Version 0.2.5

0.2.10 (2025-06-30)

⚠ BREAKING CHANGES

Update to A2A Spec Version 0.2.5 (#197)

Features

Add append and last_chunk to add_artifact method on TaskUpdater (#186) (8c6560f)
add a2a routes to existing app (#188) (32fecc7)
Add middleware to the client SDK (#171) (efaabd3)
Add more task state management methods to TaskUpdater (#208) (2b3bf6d)
raise error for tasks in terminal states (#215) (a0bf13b)

Bug Fixes

consume_all doesn't catch asyncio.TimeoutError in python 3.10 (#216) (39307f1)
Append metadata and context id when processing TaskStatusUpdateE… (#238) (e106020)
Fix reference to grpc.aio.ServicerContext (#237) (0c1987b)
Fixes Short Circuit clause for context ID (#236) (a5509e6)
Resolve APIKeySecurityScheme parsing failed (#226) (aa63b98)
send notifications on message not streaming (#219) (91539d6), closes #218

Open source →

0.2.924 Jun 2025

Set protobuf==5.29.5 and fastapi>=0.115.2 to prevent version conflicts

Full Changelog: https://github.com/a2aproject/a2a-python/compare/v0.2.8...v0.2.9

Set protobuf==5.29.5 and fastapi>=0.115.2 to prevent version conflicts

Open source →

Additional notes2 sources agree

Bug Fixes

Set protobuf==5.29.5 and fastapi>=0.115.2 to prevent version conflicts (#224) (1412a85)

Open source →

0.2.813 Jun 20253 sources agree

Add HTTP Headers to ServerCallContext for Improved Handler Access

0.2.8 (2025-06-12)

Features

Add HTTP Headers to ServerCallContext for Improved Handler Access (#182) (d5e5f5f)
Update A2A types from specification 🤖 (#191) (174230b)

Bug Fixes

Add protobuf==6.31.1 to dependencies (#189) (ae1c31c), closes #185

Open source →

0.2.711 Jun 20253 sources agree

Update A2A types from specification 🤖

0.2.7 (2025-06-11)

Features

Update A2A types from specification 🤖 (#179) (3ef4240)

Open source →

0.2.69 Jun 20253 sources agree

Add FastAPI JSONRPC Application

0.2.6 (2025-06-09)

⚠ BREAKING CHANGES

Add FastAPI JSONRPC Application (#104)
stream: don't block event loop in EventQueue (#151) (efd9080)

Features

Add FastAPI JSONRPC Application (#104) (0e66e1f)
Add gRPC server and client support (#162) (a981605)
add reject method to task_updater (#147) (2a6ef10)
Add timestamp to TaskStatus updates on TaskUpdater (#140) (0c9df12)
spec: Add an optional iconUrl field to the AgentCard 🤖 (a1025f4)

Bug Fixes

Correctly adapt starlette BaseUser to A2A User (#133) (88d45eb)
Event consumer should stop on input_required (#167) (51c2d8a)
Fix Release Version (#161) (011d632)
generate StrEnum types for enums (#134) (0c49dab)
library should released as 0.2.6 (d8187e8)
remove error types from enqueable events (#138) (511992f)
task_updater: fix potential duplicate artifact_id from default v… (#156) (1f0a769)

Documentation

remove final and metadata fields from docstring (#66) (3c50ee1)
Update Links to Documentation Site (5e7d418)

Open source →

0.2.527 May 20253 sources agree

Add a User representation to ServerCallContext

0.2.5 (2025-05-27)

Features

Add a User representation to ServerCallContext (#116) (2cc2a0d)
Add functionality for extended agent card. (#31) (20f0826)
Introduce a ServerCallContext (#94) (85b521d)

Bug Fixes

fix hello world example for python 3.12 (#98) (536e4a1)
Remove unused dependencies and update py version (#119) (9f8bc02)
Update hello world test client to match sdk behavior. Also down-level required python version (#117) (04c7c45)
Update the google adk demos to use ADK v1.0 (#95) (c351656)

Documentation

Update README for Python 3.10+ support (#90) (e0db20f)

Open source →

0.2.422 May 20253 sources agree

Throw exception for task_id mismatches

0.2.4 (2025-05-22)

Features

Update to support python 3.10 (#85) (fd9c3b5)

Bug Fixes

Throw exception for task_id mismatches (#70) (a9781b5)

Open source →

0.2.320 May 20253 sources agree

Add request context builder with referenceTasks

0.2.3 (2025-05-20)

Features

Add request context builder with referenceTasks (#56) (f20bfe7)

Open source →

0.2.220 May 20253 sources agree

Write/Update Docstrings for Classes/Methods

0.2.2 (2025-05-20)

Documentation

Write/Update Docstrings for Classes/Methods (#59) (9f773ef)

Open source →

0.2.120 May 2025

Python SDK implementing A2A v0.2.0

Open source →

0.2.1a220 May 2025pre-release

Alpha2 build to test the deployment for RC1

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →

a2a-sdk

Release timeline

Releases

1.2.1 (2026-09-30)

Bug Fixes

1.2.0 (2026-09-29)

Features

Bug Fixes

Documentation

1.1.5 (2026-09-21)

Bug Fixes

1.1.4 (2026-09-07)

Features

Bug Fixes

Documentation

1.1.3 (2026-08-18)

Bug Fixes

1.1.2 (2026-07-20)

Features

Bug Fixes

1.1.1 (2026-07-15)

Bug Fixes

Miscellaneous Chores

1.1.0 (2026-05-29)

Features

Bug Fixes

Documentation

Miscellaneous Chores

1.0.3 (2026-05-13)

Features

Bug Fixes

Documentation

1.0.2 (2026-04-24)

Features

Bug Fixes

1.0.1 (2026-04-22)

Bug Fixes

1.0.0 (2026-04-20)

⚠ BREAKING CHANGES

Bug Fixes

Documentation

Miscellaneous Chores

1.0.0-alpha.3 (2026-04-17)

Bug Fixes

1.0.0-alpha.2 (2026-04-17)

⚠ BREAKING CHANGES

Features

Bug Fixes

Documentation

Code Refactoring

1.0.0-alpha.1 (2026-04-10)

⚠ BREAKING CHANGES

Features

Bug Fixes

Documentation

Miscellaneous Chores

Code Refactoring

1.0.0-alpha.0 (2026-03-17)

⚠ BREAKING CHANGES

Features

Bug Fixes

0.3.26 (2026-04-09)

Features

Bug Fixes

0.3.25 (2026-03-10)

Features

Bug Fixes

0.3.24 (2026-02-20)

Bug Fixes

0.3.23 (2026-02-13)

Features

Bug Fixes

Documentation

0.3.22 (2025-12-16)

Features

Code Refactoring

0.3.21 (2025-12-12)

Documentation

Documentation

0.3.20 (2025-12-03)