Interface A2AAdapter

Value returned by createA2AAdapter.

For almost every seller, adapter.mount(app) is the right entry point — it wires all four routes (JSON-RPC at the agent-card's path, the agent card at both {basePath}/.well-known/agent-card.json for A2A discovery and /.well-known/agent-card.json for origin-root probes) with one call.

The jsonRpcHandler and agentCardHandler fields stay exposed for deployments that need finer control (mounting behind a custom auth layer, serving the card from a CDN, testing).

interface A2AAdapter {
    jsonRpcHandler: RequestHandler;
    agentCardHandler: RequestHandler;
    getAgentCard(): Promise<AgentCard>;
    mount(app: ExpressAppLike, options?: A2AMountOptions): void;
}

Index

Properties

jsonRpcHandler agentCardHandler

Methods

getAgentCard mount

Properties

jsonRpcHandler

jsonRpcHandler: RequestHandler

The A2A JSON-RPC middleware (message/send, tasks/get, tasks/cancel).

agentCardHandler

agentCardHandler: RequestHandler

The agent-card discovery GET middleware.

Methods

getAgentCard

getAgentCard(): Promise<AgentCard>
Returns the merged, validated agent card.

Returns Promise<AgentCard>
- Defined in src/lib/server/a2a-adapter.ts:230

mount

mount(app: ExpressAppLike, options?: A2AMountOptions): void
Wire all A2A routes onto an Express-compatible app in one call. Eliminates the "card mounted at only one location" footgun: the A2A SDK derives ${agentCard.url}/.well-known/agent-card.json for discovery, while many clients also probe origin root — this helper satisfies both. See A2AMountOptions to override paths.
Parameters
- app: ExpressAppLike
- Optionaloptions: A2AMountOptions
Returns void
- Defined in src/lib/server/a2a-adapter.ts:238

Interface A2AAdapter

Index

Properties

Methods

Properties

jsonRpcHandler

agentCardHandler

Methods

getAgentCard

Returns Promise<AgentCard>

mount

Parameters

Returns void

Settings

On This Page