Hellō Wallet (the reference PS) converted all /aauth/* error responses to RFC 9457 application/problem+json (hellocoop/Wallet#4153, shipped in Wallet 2026.8.22): {error, detail, ...extensions}, with error_description renamed to detail — never both. Wallet production and staging are verified on that version.
@aauth/agent carries a deliberate leniency shim for the old spelling:
agent/src/deferred.ts — describeAAuthError: error?.detail ?? error?.error_description ?? error?.error (comment: "Drop the leniency only once no PS in the fleet emits the old member")
agent/src/token-exchange.ts:24
agent/src/person-token.ts:31
- test coverage in
agent/src/person-token.test.ts
- the older
@aauth/mcp-agent dist has the same fallback
Caveat before dropping: Wallet's beta branch has NOT been back-merged, so wallet.hello-beta.net still emits error_description. Dropping the fallback now would lose error detail for agents pointed at beta. Sequence: back-merge Wallet main→beta (or confirm beta redeployed ≥ 2026.8.22), confirm no other PS emits the old member, then remove the fallback and its tests.
Originally misfiled as hellocoop/aauth-proxy#40 — the proxy fleet never parses Wallet /aauth errors and doesn't depend on @aauth/agent; analysis there confirmed the shim lives only in this repo.
🤖 Filed by Claude Code on Dick's behalf — https://claude.ai/code/session_01XqXCHVDWT1BdmyEB9zNCcR
Hellō Wallet (the reference PS) converted all
/aauth/*error responses to RFC 9457application/problem+json(hellocoop/Wallet#4153, shipped in Wallet 2026.8.22):{error, detail, ...extensions}, witherror_descriptionrenamed todetail— never both. Wallet production and staging are verified on that version.@aauth/agentcarries a deliberate leniency shim for the old spelling:agent/src/deferred.ts—describeAAuthError:error?.detail ?? error?.error_description ?? error?.error(comment: "Drop the leniency only once no PS in the fleet emits the old member")agent/src/token-exchange.ts:24agent/src/person-token.ts:31agent/src/person-token.test.ts@aauth/mcp-agentdist has the same fallbackCaveat before dropping: Wallet's
betabranch has NOT been back-merged, so wallet.hello-beta.net still emitserror_description. Dropping the fallback now would lose error detail for agents pointed at beta. Sequence: back-merge Wallet main→beta (or confirm beta redeployed ≥ 2026.8.22), confirm no other PS emits the old member, then remove the fallback and its tests.Originally misfiled as hellocoop/aauth-proxy#40 — the proxy fleet never parses Wallet /aauth errors and doesn't depend on
@aauth/agent; analysis there confirmed the shim lives only in this repo.🤖 Filed by Claude Code on Dick's behalf — https://claude.ai/code/session_01XqXCHVDWT1BdmyEB9zNCcR