2.9.0 (2026-11-17)
Features
- plugins: extend clients and servers with
a2aclient.WithPluginsanda2asrv.WithPlugins. Client plugins wrap calls; server plugins wrap calls, the agent executor, the task store and push delivery. Thea2apluginpackage builds plugins from hooks (#572, #581) (5216340, b25d155) - a2aclient/oauth: OAuth 2.0 client support.
oauth.Managerdiscovers authorization servers from agent cards and Protected Resource Metadata, signs users in (authorization code or device grant), and its plugin attaches and refreshes tokens (#568, #570) (c42999a, 50dd177) - a2aclient: errors received from a server carry the response HTTP headers or gRPC metadata in
a2a.Error.ServiceParams(#595) (d6a1d26) - a2asrv: pass the client's accepted output modes to agents in
ExecutorContext.AcceptedOutputModes(#603) (57ee56c)
Behavior Changes
- a2asrv:
SendMessageandSendStreamingMessagereturn at mostConfig.HistoryLengthmessages of task history (#603) (57ee56c) - a2asrv:
NewAgentCardEnforcerrejects messages with a push config when the card doesn't support push notifications (#603) (57ee56c) - a2asrv: a message reply gets the execution's contextId when the agent doesn't set one, and its taskId is cleared (#577, #609) (eee75ec, 97de334)
- a2asrv: getting a missing push config returns
TaskNotFoundinstead of an internal error, and a REST push config delete returns{}(#578, #600) (ff3fcf8, 0d1ac2a) - a2aclient: a JSON-RPC HTTP error without a JSON-RPC body is an
*a2a.Error(ErrUnauthenticatedfor 401,ErrUnauthorizedfor 403,ErrServerErrorotherwise) instead of a plain error (#595) (d6a1d26) - a2aclient: stream responses of an unknown type are skipped instead of ending the stream with an error (#532) (212512b)
Bug Fixes
- a2a: accept pointer OAuth flow types when marshalling (#541) (fe407e3)
- a2aacp: don't count exited agents in makeRoom (#563) (6b0c5bd)
- a2aacp: drop empty parts instead of sending a block without content (#594) (d8323ce)
- a2aacp: fail turns of a stopped agent with
AgentStoppedError(#573) (4acb390) - a2aacp: release the context lock before reporting the end of a turn, so
RejectBusyContextaccepts the next message (#601) (964e814) - a2aacp: reserve pool capacity during startup (#587) (621d73b)
- a2av0: keep unset ListTasks history length unset (#527) (9b4435f)
- pbconv: leave an unset ListTasks page size unset (#576) (5a3d99d)
- sse: support carriage-return event line endings (#487) (ecaea9c)
- taskexec: don't end remote subscriptions at the caller's message (#575) (d0710f5)