npm / @a2a-js/sdk
@a2a-js/sdk
What changed in @a2a-js/sdk 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
1 security2 new APIs and options21 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@a2a-js/sdk 124 changes
Security 1
The client caches the extended Agent Card only after signature verification.
New APIs and options 2
Adds database-backed stores for tasks and push notifications.
Introduces the server SettleByTaskId method.
Fixes and other changes 21
JSON-RPC dispatch now uses A2A-Version.
JSON-RPC errors are returned with HTTP 200.
JSON-RPC response versions are now validated.
The server adds optional media type validation against the agent's defaultInputModes.
Status or artifact event metadata now propagates to the task.
When creating push notification configs through REST, taskId is now correctly set from path parameters.
Avoids mutating the caller's message configuration.
Guards terminal state transitions and makes cancelTask atomic.
Rejects empty task IDs with RequestMalformedError.
Scopes the manager by tenant and owner to match TaskStore.
Accepts JSON-RPC calls with omitted params.
Rejects empty task IDs with RequestMalformedError.
Preserves HeadersInit in authenticating fetch.
Preserves historyLength=0 rather than treating it as absent.
Preserves call context for tenant requests.
Rejects invalid REST listTasks pageSize values.
Rejects invalid status filters with RequestMalformedError.
Missing push notification configs now return 404/-32001.
Rejects whitespace-only taskId values.
Stamps the resolved taskId onto sendMessage push configs.
Rejects missing required extensions before mutating task history.