Skip to content

@aauth/agent: drop error_description fallback once no PS in the fleet emits the old member #22

Description

@dickhardt

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.tsdescribeAAuthError: 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions