1.0.0 (2026-07-22)
@a2a-js/sdk is now generally available. This release promotes the v1.0 line to stable, implementing the full A2A Protocol Specification v1.0 across all three transports (JSON-RPC, HTTP+JSON/REST, gRPC), with opt-in v0.3 backward compatibility for staged migrations.
Upgrading from 0.3.x? See the v0.3 → v1.0 migration guide.
Interoperating with peers still on v0.3? See the end-user v0.3 compatibility guide.
⚠ BREAKING CHANGES
- unify A2AError hierarchy with transport specific subclasses (#587)
- server: replace individual properties with SendMessageRequest in RequestContext (#581)
Features
- add state bag and ServerCallContextBuilder to ServerCallContext (#364) (477e394)
- export SSE wire-format helpers from public entry point (#548) (8bc21f5), closes #547
- server: expose SendMessageRequest metadata to AgentExecutor via RequestContext (#564) (a92f54e)
- server: replace individual properties with SendMessageRequest in RequestContext (#581) (7cd30de)
- unify A2AError hierarchy with transport specific subclasses (#587) (4806f8f)
Bug Fixes
- client: bound SSE event size to prevent client-side memory exhaustion (#582) (e6e8ce9)
- client: cancel the SSE stream on teardown to avoid leaking connections (#580) (83269a5)
- grpc: preserve null values in protobuf Struct (#578) (f447e4e), closes #576
- resolve sdk compatibility bugs (#568) (b57f026)
- server: await _handleProcessingError so blocking drains surface errors (#579) (5833652)
- support GET for resubscribe route (#569) (8dd43d1)