agentfootprint 9.67.0 → 9.68.0

package/dist/esm/adapters/hosting/agentCoreA2A.d.ts

@@ -0,0 +1,95 @@
+/**
+ * adapters/hosting/agentCoreA2A — an agentfootprint agent as an AWS Bedrock
+ * **AgentCore A2A** server, callable by other agents.
+ *
+ * ── The split, again ─────────────────────────────────────────────────────────
+ * Two different things are needed, and only one is Amazon's:
+ *
+ *   • The **A2A protocol** — JSON-RPC 2.0, `message/send`, artifacts, the agent
+ *     card. An open protocol several runtimes speak, so it lives in
+ *     `a2aWire.ts` with no vendor in it.
+ *   • The **container contract** — port 9000 (not 8080, and not 8000: each
+ *     protocol gets its own), the agent mounted at `/`, `GET /ping` answering
+ *     `{"status":"Healthy"}`, the session id arriving in
+ *     `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id`, and a table of JSON-RPC
+ *     error codes that are this runtime's exceptions rather than A2A's. That
+ *     IS Amazon's, and it is what this file supplies.
+ *
+ * ── One deviation you must know about ────────────────────────────────────────
+ * The A2A specification delivers JSON-RPC errors over HTTP 200. **AgentCore
+ * does not** — it returns the real status code (409, 404, …) with the JSON-RPC
+ * error body. That is a fact about the platform in front of your container, so
+ * a CLIENT must parse the error body even on a non-2xx response; see
+ * `agentCoreA2AErrorCode` for the table this host mirrors on the way out.
+ *
+ * ── What is NOT provided ─────────────────────────────────────────────────────
+ * `message/stream` and the task lifecycle. The agent card this host serves
+ * therefore declares `streaming: false` unless you overrule it, because a card
+ * that advertises streaming to a wire that cannot stream is a caller left
+ * waiting. AWS's own sample card says `true`; ours says what is true of ours.
+ *
+ * @example  An agent other agents can call
+ *   import { agentCoreA2AHost, memorySessions, standingAgent } from 'agentfootprint/hosting';
+ *
+ *   const handle = await standingAgent({
+ *     agent,
+ *     sessions: memorySessions(),
+ *     host: agentCoreA2AHost({
+ *       card: { name: 'triage', description: 'Triages SAN alerts.', version: '1.0.0' },
+ *     }),
+ *   });
+ *   process.on('SIGTERM', () => void handle.close());
+ */
+/// <reference types="node" />
+import type { IncomingMessage, Server, ServerResponse } from 'node:http';
+import { type HttpHost } from '../../hosting/httpHost.js';
+import { type A2AAgentCard } from './a2aWire.js';
+/** The port an AgentCore A2A server is expected on — its own, not HTTP's or MCP's. */
+export declare const DEFAULT_AGENTCORE_A2A_PORT = 9000;
+/** A2A mounts the agent at the root. */
+export declare const AGENTCORE_A2A_INVOKE_PATH = "/";
+/** The runtime's health path for every protocol. */
+export declare const AGENTCORE_PING_PATH = "/ping";
+/** Where the platform puts the caller's session. */
+export declare const AGENTCORE_SESSION_HEADER = "X-Amzn-Bedrock-AgentCore-Runtime-Session-Id";
+/**
+ * AgentCore's own JSON-RPC error codes, mapped from this library's refusal codes.
+ *
+ * These numbers are the RUNTIME's exception table, not A2A's: `-32051`
+ * ResourceNotFound, `-32052` Validation, `-32053` Throttling and
+ * ServiceQuotaExceeded, `-32054` Conflict and RetryableConflict, `-32055`
+ * RuntimeClientError, `-32603` anything else. A client reads them to decide
+ * whether to retry — `-32054` with "Session operation in progress" is the one
+ * that must be retried with backoff, and A2A clients do not do that on their
+ * own.
+ *
+ * Exported so a client built against this host can share one table with it
+ * rather than keep a second copy that drifts.
+ */
+export declare function agentCoreA2AErrorCode(code: string | undefined): number;
+export interface AgentCoreA2AHostOptions {
+    /** The agent card other agents read. Required — discovery is not optional in A2A. */
+    readonly card: A2AAgentCard;
+    /** Port to bind. Default {@link DEFAULT_AGENTCORE_A2A_PORT}. Pass `0` in tests. */
+    readonly port?: number;
+    /** Interface to bind. Default `'0.0.0.0'` — a container's door must be reachable. */
+    readonly hostname?: string;
+    /** Ceiling on a request body. Default one mebibyte. */
+    readonly maxBodyBytes?: number;
+    /** A `node:http` server you own. Refused together with `port`/`hostname`. */
+    readonly server?: Server;
+    /**
+     * Answer a path this host does not own. The agent card is served BEFORE this
+     * runs, and everything else falls through to you unchanged — so supplying one
+     * costs you nothing the card was not already going to take.
+     */
+    readonly onUnhandled?: (req: IncomingMessage, res: ServerResponse) => void;
+}
+/**
+ * An {@link HttpHost} serving AgentCore's A2A container contract.
+ *
+ * `httpHost` keeps its own promises — draining, aborting on disconnect, failing
+ * a handler that throws or answers nothing — and this supplies the protocol,
+ * the paths, the port, the session header and the error table.
+ */
+export declare function agentCoreA2AHost(options: AgentCoreA2AHostOptions): HttpHost;

package/dist/esm/adapters/hosting/agentCoreA2A.js

@@ -0,0 +1,168 @@
+/**
+ * adapters/hosting/agentCoreA2A — an agentfootprint agent as an AWS Bedrock
+ * **AgentCore A2A** server, callable by other agents.
+ *
+ * ── The split, again ─────────────────────────────────────────────────────────
+ * Two different things are needed, and only one is Amazon's:
+ *
+ *   • The **A2A protocol** — JSON-RPC 2.0, `message/send`, artifacts, the agent
+ *     card. An open protocol several runtimes speak, so it lives in
+ *     `a2aWire.ts` with no vendor in it.
+ *   • The **container contract** — port 9000 (not 8080, and not 8000: each
+ *     protocol gets its own), the agent mounted at `/`, `GET /ping` answering
+ *     `{"status":"Healthy"}`, the session id arriving in
+ *     `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id`, and a table of JSON-RPC
+ *     error codes that are this runtime's exceptions rather than A2A's. That
+ *     IS Amazon's, and it is what this file supplies.
+ *
+ * ── One deviation you must know about ────────────────────────────────────────
+ * The A2A specification delivers JSON-RPC errors over HTTP 200. **AgentCore
+ * does not** — it returns the real status code (409, 404, …) with the JSON-RPC
+ * error body. That is a fact about the platform in front of your container, so
+ * a CLIENT must parse the error body even on a non-2xx response; see
+ * `agentCoreA2AErrorCode` for the table this host mirrors on the way out.
+ *
+ * ── What is NOT provided ─────────────────────────────────────────────────────
+ * `message/stream` and the task lifecycle. The agent card this host serves
+ * therefore declares `streaming: false` unless you overrule it, because a card
+ * that advertises streaming to a wire that cannot stream is a caller left
+ * waiting. AWS's own sample card says `true`; ours says what is true of ours.
+ *
+ * @example  An agent other agents can call
+ *   import { agentCoreA2AHost, memorySessions, standingAgent } from 'agentfootprint/hosting';
+ *
+ *   const handle = await standingAgent({
+ *     agent,
+ *     sessions: memorySessions(),
+ *     host: agentCoreA2AHost({
+ *       card: { name: 'triage', description: 'Triages SAN alerts.', version: '1.0.0' },
+ *     }),
+ *   });
+ *   process.on('SIGTERM', () => void handle.close());
+ */
+import { headerValue, httpHost } from '../../hosting/httpHost.js';
+import { a2aAgentCardDocument, a2aWire, A2A_AGENT_CARD_PATH, } from './a2aWire.js';
+/** The port an AgentCore A2A server is expected on — its own, not HTTP's or MCP's. */
+export const DEFAULT_AGENTCORE_A2A_PORT = 9000;
+/** A2A mounts the agent at the root. */
+export const AGENTCORE_A2A_INVOKE_PATH = '/';
+/** The runtime's health path for every protocol. */
+export const AGENTCORE_PING_PATH = '/ping';
+/** Where the platform puts the caller's session. */
+export const AGENTCORE_SESSION_HEADER = 'X-Amzn-Bedrock-AgentCore-Runtime-Session-Id';
+/**
+ * AgentCore's own JSON-RPC error codes, mapped from this library's refusal codes.
+ *
+ * These numbers are the RUNTIME's exception table, not A2A's: `-32051`
+ * ResourceNotFound, `-32052` Validation, `-32053` Throttling and
+ * ServiceQuotaExceeded, `-32054` Conflict and RetryableConflict, `-32055`
+ * RuntimeClientError, `-32603` anything else. A client reads them to decide
+ * whether to retry — `-32054` with "Session operation in progress" is the one
+ * that must be retried with backoff, and A2A clients do not do that on their
+ * own.
+ *
+ * Exported so a client built against this host can share one table with it
+ * rather than keep a second copy that drifts.
+ */
+export function agentCoreA2AErrorCode(code) {
+    switch (code) {
+        case 'ERR_SESSION_NOT_FOUND':
+        case 'ERR_ARTIFACT_NOT_FOUND':
+            return -32051;
+        case 'ERR_INVALID_WIRE_OP':
+        case 'ERR_DECISION_REQUIRED':
+        case 'ERR_ARTIFACT_SESSION_REQUIRED':
+        case 'invalid_request':
+        case 'invalid_params':
+        case 'unsupported_part':
+            return -32052;
+        case 'ERR_ADMISSION_REFUSED':
+        case 'ERR_REQUEST_TOO_LARGE':
+            return -32053;
+        case 'ERR_CONCURRENT_RUN':
+        case 'ERR_HOST_CLOSED':
+        case 'ERR_AWAITING_DECISION':
+        case 'ERR_PAUSE_NOT_CARRIED':
+            return -32054;
+        case 'method_not_found':
+            // JSON-RPC's own "method not found" is -32601, but this runtime reports a
+            // route it cannot resolve as ResourceNotFound. The platform's table wins
+            // inside the platform's container.
+            return -32051;
+        default:
+            return -32603;
+    }
+}
+const DEFAULT_MAX_BODY_BYTES = 1_048_576;
+/**
+ * An {@link HttpHost} serving AgentCore's A2A container contract.
+ *
+ * `httpHost` keeps its own promises — draining, aborting on disconnect, failing
+ * a handler that throws or answers nothing — and this supplies the protocol,
+ * the paths, the port, the session header and the error table.
+ */
+export function agentCoreA2AHost(options) {
+    const { server, onUnhandled, hostname, card } = options;
+    const cardDocument = JSON.stringify(a2aAgentCardDocument(card));
+    /** The discovery document, served before anything falls through to the caller. */
+    const serveCard = (req, res) => {
+        const path = (req.url ?? '').split('?')[0];
+        if (req.method === 'GET' && path === A2A_AGENT_CARD_PATH) {
+            res.writeHead(200, {
+                'content-type': 'application/json',
+                'content-length': Buffer.byteLength(cardDocument),
+            });
+            res.end(cardDocument);
+            return;
+        }
+        // Not the card: the caller's own routes, if they have any. Chaining rather
+        // than consuming the slot — an adapter that took `onUnhandled` for itself
+        // would silently remove a seam the host documents as the consumer's.
+        if (onUnhandled) {
+            onUnhandled(req, res);
+            return;
+        }
+        res.writeHead(404, { 'content-type': 'application/json' });
+        res.end(JSON.stringify({ error: `no route for ${req.method ?? '?'} ${path}` }));
+    };
+    const socket = server
+        ? { server }
+        : {
+            port: options.port ?? DEFAULT_AGENTCORE_A2A_PORT,
+            ...(hostname === undefined ? {} : { hostname }),
+            onUnhandled: serveCard,
+        };
+    const protocol = a2aWire({
+        card,
+        // The runtime's health contract, not A2A's — A2A has no /ping at all.
+        health: { status: 'Healthy' },
+        errorCodeFor: agentCoreA2AErrorCode,
+        name: 'agentCoreA2AHost',
+    });
+    return httpHost({
+        name: 'agentCoreA2AHost',
+        wire: {
+            ...protocol,
+            // The one thing the protocol does not carry and the platform does: which
+            // conversation this call belongs to, in a header of the runtime's own.
+            readRequest(facts) {
+                const base = protocol.readRequest(facts);
+                const sessionId = headerValue(facts, AGENTCORE_SESSION_HEADER);
+                return { ...base, ...(sessionId !== undefined && { sessionId }) };
+            },
+        },
+        invokePath: AGENTCORE_A2A_INVOKE_PATH,
+        healthPath: AGENTCORE_PING_PATH,
+        // NOT `['streaming']`, which is this file's default. `message/send` has
+        // nowhere to put a chunk: a caller gets one JSON-RPC reply and nothing
+        // before it. Declaring streaming anyway would make `requireCapability`
+        // pass for a host that cannot honour it, and would contradict the agent
+        // card, which says `streaming: false` for the same reason. The host
+        // conformance suite catches exactly this — it asserts chunks IF AND ONLY IF
+        // the capability is declared, and it caught it here.
+        capabilities: [],
+        maxBodyBytes: options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES,
+        ...socket,
+    });
+}
+//# sourceMappingURL=agentCoreA2A.js.map

package/dist/esm/adapters/hosting/agentCoreA2A.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCoreA2A.js","sourceRoot":"","sources":["../../../../src/adapters/hosting/agentCoreA2A.ts"],"names":[],"mappings":"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"}

package/dist/esm/hosting-providers.d.ts

@@ -25,6 +25,21 @@
  *     idleMs: 900000 }` declared, session affinity readable from header or
  *     query, and a `Sec-WebSocket-Protocol` bearer mapped into
  *     `headers.authorization`.
+ *   • `agentCoreA2AHost({ card, port?, hostname?, maxBodyBytes? })` — an
+ *     `AgentHost` for AgentCore's **A2A** container contract, so OTHER AGENTS
+ *     can call yours: JSON-RPC 2.0 at `POST /` on port 9000, the agent card at
+ *     `/.well-known/agent-card.json`, `GET /ping` answering
+ *     `{"status":"Healthy"}`, and the session read from
+ *     `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id`. It declares NO streaming
+ *     capability and its card says `streaming: false`, because `message/send`
+ *     has nowhere to put a chunk — the two agree on purpose. Errors carry a
+ *     REAL HTTP status alongside the JSON-RPC error body (the platform's
+ *     documented deviation from the A2A spec); `agentCoreA2AErrorCode` is the
+ *     table, exported so a client shares it rather than keeping a copy.
+ *   • `a2aWire({ card, health?, errorCodeFor? })` — the A2A PROTOCOL as an
+ *     `HttpWire`, with no vendor in it, for the next runtime that speaks it.
+ *     `a2aAgentCardDocument(card)` builds the discovery document on its own,
+ *     for deployments that must serve it from somewhere else.
  *   • `foundryResponsesHost({ port?, hostname?, model?, maxBodyBytes? })` — an
  *     `AgentHost` for Microsoft Foundry's hosted-agent contract: `POST
  *     /responses`, a `HEAD` capability probe on the same path, `GET /readiness`
@@ -100,6 +115,10 @@
  * symbols, one door. Import from the door.
  */
 export { agentCoreRuntimeHost, agentCoreRuntimeWire, readAgentCoreConversation, agentCoreSessions, DEFAULT_SESSION_STORAGE_PATH, } from './adapters/hosting/agentcore.js';
+export { agentCoreA2AHost, agentCoreA2AErrorCode, DEFAULT_AGENTCORE_A2A_PORT, AGENTCORE_A2A_INVOKE_PATH, AGENTCORE_PING_PATH, AGENTCORE_SESSION_HEADER, } from './adapters/hosting/agentCoreA2A.js';
+export type { AgentCoreA2AHostOptions } from './adapters/hosting/agentCoreA2A.js';
+export { a2aWire, a2aAgentCardDocument, readA2AMessageText, A2A_PROTOCOL_VERSION, A2A_AGENT_CARD_PATH, A2A_SEND_METHOD, JSONRPC_METHOD_NOT_FOUND, JSONRPC_INVALID_PARAMS, JSONRPC_INTERNAL_ERROR, } from './adapters/hosting/a2aWire.js';
+export type { A2AWireOptions, A2AAgentCard, A2ASkill } from './adapters/hosting/a2aWire.js';
 export { foundryResponsesHost, DEFAULT_FOUNDRY_PORT, FOUNDRY_INVOKE_PATH, FOUNDRY_READINESS_PATH, FOUNDRY_SESSION_FIELDS, } from './adapters/hosting/foundryResponses.js';
 export type { FoundryResponsesHostOptions } from './adapters/hosting/foundryResponses.js';
 export { responsesWire, readResponsesInput, readResponsesSession, DEFAULT_SESSION_FIELDS, PUBLIC_FAILURE_MESSAGE, } from './adapters/hosting/responsesWire.js';

package/dist/esm/hosting-providers.js

@@ -25,6 +25,21 @@
  *     idleMs: 900000 }` declared, session affinity readable from header or
  *     query, and a `Sec-WebSocket-Protocol` bearer mapped into
  *     `headers.authorization`.
+ *   • `agentCoreA2AHost({ card, port?, hostname?, maxBodyBytes? })` — an
+ *     `AgentHost` for AgentCore's **A2A** container contract, so OTHER AGENTS
+ *     can call yours: JSON-RPC 2.0 at `POST /` on port 9000, the agent card at
+ *     `/.well-known/agent-card.json`, `GET /ping` answering
+ *     `{"status":"Healthy"}`, and the session read from
+ *     `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id`. It declares NO streaming
+ *     capability and its card says `streaming: false`, because `message/send`
+ *     has nowhere to put a chunk — the two agree on purpose. Errors carry a
+ *     REAL HTTP status alongside the JSON-RPC error body (the platform's
+ *     documented deviation from the A2A spec); `agentCoreA2AErrorCode` is the
+ *     table, exported so a client shares it rather than keeping a copy.
+ *   • `a2aWire({ card, health?, errorCodeFor? })` — the A2A PROTOCOL as an
+ *     `HttpWire`, with no vendor in it, for the next runtime that speaks it.
+ *     `a2aAgentCardDocument(card)` builds the discovery document on its own,
+ *     for deployments that must serve it from somewhere else.
  *   • `foundryResponsesHost({ port?, hostname?, model?, maxBodyBytes? })` — an
  *     `AgentHost` for Microsoft Foundry's hosted-agent contract: `POST
  *     /responses`, a `HEAD` capability probe on the same path, `GET /readiness`
@@ -100,6 +115,10 @@
  * symbols, one door. Import from the door.
  */
 export { agentCoreRuntimeHost, agentCoreRuntimeWire, readAgentCoreConversation, agentCoreSessions, DEFAULT_SESSION_STORAGE_PATH, } from './adapters/hosting/agentcore.js';
+export { agentCoreA2AHost, agentCoreA2AErrorCode, DEFAULT_AGENTCORE_A2A_PORT, AGENTCORE_A2A_INVOKE_PATH, AGENTCORE_PING_PATH, AGENTCORE_SESSION_HEADER, } from './adapters/hosting/agentCoreA2A.js';
+// The protocol under it, on the barrel in its own right — A2A is an open
+// protocol, and reaching it should not mean importing a vendor's module.
+export { a2aWire, a2aAgentCardDocument, readA2AMessageText, A2A_PROTOCOL_VERSION, A2A_AGENT_CARD_PATH, A2A_SEND_METHOD, JSONRPC_METHOD_NOT_FOUND, JSONRPC_INVALID_PARAMS, JSONRPC_INTERNAL_ERROR, } from './adapters/hosting/a2aWire.js';
 export { foundryResponsesHost, DEFAULT_FOUNDRY_PORT, FOUNDRY_INVOKE_PATH, FOUNDRY_READINESS_PATH, FOUNDRY_SESSION_FIELDS, } from './adapters/hosting/foundryResponses.js';
 // The protocol under it, on the barrel in its own right: a deployment that
 // speaks Responses on paths of its own is a `httpHost` away, and having to

package/dist/esm/hosting-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"hosting-providers.js","sourceRoot":"","sources":["../../src/hosting-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoGG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAIhD,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,kCAAkC;AAClC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAOjD,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,mBAAmB;AACnB,OAAO,EACL,iBAAiB,EACjB,0BAA0B;AAC1B,uEAAuE;AACvE,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"hosting-providers.js","sourceRoot":"","sources":["../../src/hosting-providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmHG;AAEH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAI5C,yEAAyE;AACzE,yEAAyE;AACzE,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAIhD,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,kCAAkC;AAClC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AAOjD,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,mBAAmB;AACnB,OAAO,EACL,iBAAiB,EACjB,0BAA0B;AAC1B,uEAAuE;AACvE,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,yCAAyC,CAAC"}

package/dist/hosting-providers.js

@@ -26,6 +26,21 @@
  *     idleMs: 900000 }` declared, session affinity readable from header or
  *     query, and a `Sec-WebSocket-Protocol` bearer mapped into
  *     `headers.authorization`.
+ *   • `agentCoreA2AHost({ card, port?, hostname?, maxBodyBytes? })` — an
+ *     `AgentHost` for AgentCore's **A2A** container contract, so OTHER AGENTS
+ *     can call yours: JSON-RPC 2.0 at `POST /` on port 9000, the agent card at
+ *     `/.well-known/agent-card.json`, `GET /ping` answering
+ *     `{"status":"Healthy"}`, and the session read from
+ *     `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id`. It declares NO streaming
+ *     capability and its card says `streaming: false`, because `message/send`
+ *     has nowhere to put a chunk — the two agree on purpose. Errors carry a
+ *     REAL HTTP status alongside the JSON-RPC error body (the platform's
+ *     documented deviation from the A2A spec); `agentCoreA2AErrorCode` is the
+ *     table, exported so a client shares it rather than keeping a copy.
+ *   • `a2aWire({ card, health?, errorCodeFor? })` — the A2A PROTOCOL as an
+ *     `HttpWire`, with no vendor in it, for the next runtime that speaks it.
+ *     `a2aAgentCardDocument(card)` builds the discovery document on its own,
+ *     for deployments that must serve it from somewhere else.
  *   • `foundryResponsesHost({ port?, hostname?, model?, maxBodyBytes? })` — an
  *     `AgentHost` for Microsoft Foundry's hosted-agent contract: `POST
  *     /responses`, a `HEAD` capability probe on the same path, `GET /readiness`
@@ -101,13 +116,32 @@
  * symbols, one door. Import from the door.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FirestoreIndexMissingError = exports.EnvelopeTooLargeError = exports.FIRESTORE_MAX_ENVELOPE_BYTES = exports.FIRESTORE_MAX_DOCUMENT_BYTES = exports.EXPIRES_AT_FIELD = exports.DEFAULT_SESSION_COLLECTION = exports.firestoreSessions = exports.SESSION_EVENT_AUTHOR = exports.SESSION_STATE_KEY = exports.DEFAULT_USER_ID = exports.agentEngineSessions = exports.PUBLIC_FAILURE_MESSAGE = exports.DEFAULT_SESSION_FIELDS = exports.readResponsesSession = exports.readResponsesInput = exports.responsesWire = exports.FOUNDRY_SESSION_FIELDS = exports.FOUNDRY_READINESS_PATH = exports.FOUNDRY_INVOKE_PATH = exports.DEFAULT_FOUNDRY_PORT = exports.foundryResponsesHost = exports.DEFAULT_SESSION_STORAGE_PATH = exports.agentCoreSessions = exports.readAgentCoreConversation = exports.agentCoreRuntimeWire = exports.agentCoreRuntimeHost = void 0;
+exports.FirestoreIndexMissingError = exports.EnvelopeTooLargeError = exports.FIRESTORE_MAX_ENVELOPE_BYTES = exports.FIRESTORE_MAX_DOCUMENT_BYTES = exports.EXPIRES_AT_FIELD = exports.DEFAULT_SESSION_COLLECTION = exports.firestoreSessions = exports.SESSION_EVENT_AUTHOR = exports.SESSION_STATE_KEY = exports.DEFAULT_USER_ID = exports.agentEngineSessions = exports.PUBLIC_FAILURE_MESSAGE = exports.DEFAULT_SESSION_FIELDS = exports.readResponsesSession = exports.readResponsesInput = exports.responsesWire = exports.FOUNDRY_SESSION_FIELDS = exports.FOUNDRY_READINESS_PATH = exports.FOUNDRY_INVOKE_PATH = exports.DEFAULT_FOUNDRY_PORT = exports.foundryResponsesHost = exports.JSONRPC_INTERNAL_ERROR = exports.JSONRPC_INVALID_PARAMS = exports.JSONRPC_METHOD_NOT_FOUND = exports.A2A_SEND_METHOD = exports.A2A_AGENT_CARD_PATH = exports.A2A_PROTOCOL_VERSION = exports.readA2AMessageText = exports.a2aAgentCardDocument = exports.a2aWire = exports.AGENTCORE_SESSION_HEADER = exports.AGENTCORE_PING_PATH = exports.AGENTCORE_A2A_INVOKE_PATH = exports.DEFAULT_AGENTCORE_A2A_PORT = exports.agentCoreA2AErrorCode = exports.agentCoreA2AHost = exports.DEFAULT_SESSION_STORAGE_PATH = exports.agentCoreSessions = exports.readAgentCoreConversation = exports.agentCoreRuntimeWire = exports.agentCoreRuntimeHost = void 0;
 var agentcore_js_1 = require("./adapters/hosting/agentcore.js");
 Object.defineProperty(exports, "agentCoreRuntimeHost", { enumerable: true, get: function () { return agentcore_js_1.agentCoreRuntimeHost; } });
 Object.defineProperty(exports, "agentCoreRuntimeWire", { enumerable: true, get: function () { return agentcore_js_1.agentCoreRuntimeWire; } });
 Object.defineProperty(exports, "readAgentCoreConversation", { enumerable: true, get: function () { return agentcore_js_1.readAgentCoreConversation; } });
 Object.defineProperty(exports, "agentCoreSessions", { enumerable: true, get: function () { return agentcore_js_1.agentCoreSessions; } });
 Object.defineProperty(exports, "DEFAULT_SESSION_STORAGE_PATH", { enumerable: true, get: function () { return agentcore_js_1.DEFAULT_SESSION_STORAGE_PATH; } });
+var agentCoreA2A_js_1 = require("./adapters/hosting/agentCoreA2A.js");
+Object.defineProperty(exports, "agentCoreA2AHost", { enumerable: true, get: function () { return agentCoreA2A_js_1.agentCoreA2AHost; } });
+Object.defineProperty(exports, "agentCoreA2AErrorCode", { enumerable: true, get: function () { return agentCoreA2A_js_1.agentCoreA2AErrorCode; } });
+Object.defineProperty(exports, "DEFAULT_AGENTCORE_A2A_PORT", { enumerable: true, get: function () { return agentCoreA2A_js_1.DEFAULT_AGENTCORE_A2A_PORT; } });
+Object.defineProperty(exports, "AGENTCORE_A2A_INVOKE_PATH", { enumerable: true, get: function () { return agentCoreA2A_js_1.AGENTCORE_A2A_INVOKE_PATH; } });
+Object.defineProperty(exports, "AGENTCORE_PING_PATH", { enumerable: true, get: function () { return agentCoreA2A_js_1.AGENTCORE_PING_PATH; } });
+Object.defineProperty(exports, "AGENTCORE_SESSION_HEADER", { enumerable: true, get: function () { return agentCoreA2A_js_1.AGENTCORE_SESSION_HEADER; } });
+// The protocol under it, on the barrel in its own right — A2A is an open
+// protocol, and reaching it should not mean importing a vendor's module.
+var a2aWire_js_1 = require("./adapters/hosting/a2aWire.js");
+Object.defineProperty(exports, "a2aWire", { enumerable: true, get: function () { return a2aWire_js_1.a2aWire; } });
+Object.defineProperty(exports, "a2aAgentCardDocument", { enumerable: true, get: function () { return a2aWire_js_1.a2aAgentCardDocument; } });
+Object.defineProperty(exports, "readA2AMessageText", { enumerable: true, get: function () { return a2aWire_js_1.readA2AMessageText; } });
+Object.defineProperty(exports, "A2A_PROTOCOL_VERSION", { enumerable: true, get: function () { return a2aWire_js_1.A2A_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "A2A_AGENT_CARD_PATH", { enumerable: true, get: function () { return a2aWire_js_1.A2A_AGENT_CARD_PATH; } });
+Object.defineProperty(exports, "A2A_SEND_METHOD", { enumerable: true, get: function () { return a2aWire_js_1.A2A_SEND_METHOD; } });
+Object.defineProperty(exports, "JSONRPC_METHOD_NOT_FOUND", { enumerable: true, get: function () { return a2aWire_js_1.JSONRPC_METHOD_NOT_FOUND; } });
+Object.defineProperty(exports, "JSONRPC_INVALID_PARAMS", { enumerable: true, get: function () { return a2aWire_js_1.JSONRPC_INVALID_PARAMS; } });
+Object.defineProperty(exports, "JSONRPC_INTERNAL_ERROR", { enumerable: true, get: function () { return a2aWire_js_1.JSONRPC_INTERNAL_ERROR; } });
 var foundryResponses_js_1 = require("./adapters/hosting/foundryResponses.js");
 Object.defineProperty(exports, "foundryResponsesHost", { enumerable: true, get: function () { return foundryResponses_js_1.foundryResponsesHost; } });
 Object.defineProperty(exports, "DEFAULT_FOUNDRY_PORT", { enumerable: true, get: function () { return foundryResponses_js_1.DEFAULT_FOUNDRY_PORT; } });

package/dist/hosting-providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"hosting-providers.js","sourceRoot":"","sources":["../src/hosting-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoGG;;;AAEH,gEAMyC;AALvC,oHAAA,oBAAoB,OAAA;AACpB,oHAAA,oBAAoB,OAAA;AACpB,yHAAA,yBAAyB,OAAA;AACzB,iHAAA,iBAAiB,OAAA;AACjB,4HAAA,4BAA4B,OAAA;AAG9B,8EAMgD;AAL9C,2HAAA,oBAAoB,OAAA;AACpB,2HAAA,oBAAoB,OAAA;AACpB,0HAAA,mBAAmB,OAAA;AACnB,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAKxB,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,kCAAkC;AAClC,wEAM6C;AAL3C,iHAAA,aAAa,OAAA;AACb,sHAAA,kBAAkB,OAAA;AAClB,wHAAA,oBAAoB,OAAA;AACpB,0HAAA,sBAAsB,OAAA;AACtB,0HAAA,sBAAsB,OAAA;AAKxB,gFAKiD;AAJ/C,2HAAA,mBAAmB,OAAA;AACnB,uHAAA,eAAe,OAAA;AACf,yHAAA,iBAAiB,OAAA;AACjB,4HAAA,oBAAoB,OAAA;AAQtB,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,mBAAmB;AACnB,gFAaiD;AAZ/C,yHAAA,iBAAiB,OAAA;AACjB,kIAAA,0BAA0B,OAAA;AAC1B,uEAAuE;AACvE,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,wHAAA,gBAAgB,OAAA;AAChB,oIAAA,4BAA4B,OAAA;AAC5B,oIAAA,4BAA4B,OAAA;AAC5B,6HAAA,qBAAqB,OAAA;AACrB,kIAAA,0BAA0B,OAAA"}
+{"version":3,"file":"hosting-providers.js","sourceRoot":"","sources":["../src/hosting-providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmHG;;;AAEH,gEAMyC;AALvC,oHAAA,oBAAoB,OAAA;AACpB,oHAAA,oBAAoB,OAAA;AACpB,yHAAA,yBAAyB,OAAA;AACzB,iHAAA,iBAAiB,OAAA;AACjB,4HAAA,4BAA4B,OAAA;AAG9B,sEAO4C;AAN1C,mHAAA,gBAAgB,OAAA;AAChB,wHAAA,qBAAqB,OAAA;AACrB,6HAAA,0BAA0B,OAAA;AAC1B,4HAAA,yBAAyB,OAAA;AACzB,sHAAA,mBAAmB,OAAA;AACnB,2HAAA,wBAAwB,OAAA;AAK1B,yEAAyE;AACzE,yEAAyE;AACzE,4DAUuC;AATrC,qGAAA,OAAO,OAAA;AACP,kHAAA,oBAAoB,OAAA;AACpB,gHAAA,kBAAkB,OAAA;AAClB,kHAAA,oBAAoB,OAAA;AACpB,iHAAA,mBAAmB,OAAA;AACnB,6GAAA,eAAe,OAAA;AACf,sHAAA,wBAAwB,OAAA;AACxB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AAKxB,8EAMgD;AAL9C,2HAAA,oBAAoB,OAAA;AACpB,2HAAA,oBAAoB,OAAA;AACpB,0HAAA,mBAAmB,OAAA;AACnB,6HAAA,sBAAsB,OAAA;AACtB,6HAAA,sBAAsB,OAAA;AAKxB,2EAA2E;AAC3E,2EAA2E;AAC3E,8EAA8E;AAC9E,kCAAkC;AAClC,wEAM6C;AAL3C,iHAAA,aAAa,OAAA;AACb,sHAAA,kBAAkB,OAAA;AAClB,wHAAA,oBAAoB,OAAA;AACpB,0HAAA,sBAAsB,OAAA;AACtB,0HAAA,sBAAsB,OAAA;AAKxB,gFAKiD;AAJ/C,2HAAA,mBAAmB,OAAA;AACnB,uHAAA,eAAe,OAAA;AACf,yHAAA,iBAAiB,OAAA;AACjB,4HAAA,oBAAoB,OAAA;AAQtB,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,mBAAmB;AACnB,gFAaiD;AAZ/C,yHAAA,iBAAiB,OAAA;AACjB,kIAAA,0BAA0B,OAAA;AAC1B,uEAAuE;AACvE,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,wHAAA,gBAAgB,OAAA;AAChB,oIAAA,4BAA4B,OAAA;AAC5B,oIAAA,4BAA4B,OAAA;AAC5B,6HAAA,qBAAqB,OAAA;AACrB,kIAAA,0BAA0B,OAAA"}

package/dist/types/adapters/hosting/a2aWire.d.ts

@@ -0,0 +1,111 @@
+/**
+ * adapters/hosting/a2aWire — the A2A protocol, as an `HttpWire`.
+ *
+ * ── What this is ─────────────────────────────────────────────────────────────
+ * **A2A** (agent-to-agent) is an open protocol for one agent calling another:
+ * JSON-RPC 2.0 over HTTP, a `message/send` method carrying text parts, a result
+ * carrying artifacts, and a discovery document — the **agent card** — that says
+ * what the agent is and what it can do. It is nobody's product; several
+ * runtimes speak it, so it lives here on its own and the runtimes that host it
+ * configure this rather than reimplement it.
+ *
+ * ── The subset, stated plainly ───────────────────────────────────────────────
+ * One method: `message/send`, text parts only. Deliberately NOT carried:
+ * `message/stream` and the rest of the task lifecycle (`tasks/get`,
+ * `tasks/cancel`, push notifications), non-text parts, and multi-turn task
+ * state. An agent card built here therefore declares `streaming: false` by
+ * default — advertising a capability this wire cannot honour is how a caller
+ * finds out by hanging.
+ *
+ * ── Why it fits `httpHost` without changing it ───────────────────────────────
+ * JSON-RPC's one hard requirement on a reply is that it ECHOES the request's
+ * `id`. That is possible here only because `HttpWire`'s body methods receive
+ * the request that produced them — a seam added for a different protocol
+ * entirely, and the reason this one needed no new machinery.
+ *
+ * @example  A2A on paths of your own choosing
+ *   httpHost({
+ *     name: 'myA2AHost',
+ *     wire: a2aWire({ card: { name: 'triage', description: '…', version: '1.0.0' } }),
+ *     invokePath: '/',
+ *     healthPath: '/health',
+ *   });
+ */
+import type { HttpWire } from '../../hosting/httpHost.js';
+/** The A2A protocol revision this wire's documents declare. */
+export declare const A2A_PROTOCOL_VERSION = "0.3.0";
+/** Where the A2A specification puts an agent's discovery document. */
+export declare const A2A_AGENT_CARD_PATH = "/.well-known/agent-card.json";
+/** The one method this wire carries. */
+export declare const A2A_SEND_METHOD = "message/send";
+/**
+ * JSON-RPC's own reserved codes, the two this wire can raise.
+ *
+ * `-32601` is "method not found" and `-32602` is "invalid params" — both from
+ * the JSON-RPC specification rather than from A2A or any runtime, which is why
+ * they are the only numbers this neutral file knows. A runtime's own error
+ * codes belong to that runtime's adapter.
+ */
+export declare const JSONRPC_METHOD_NOT_FOUND = -32601;
+export declare const JSONRPC_INVALID_PARAMS = -32602;
+export declare const JSONRPC_INTERNAL_ERROR = -32603;
+/** One skill an agent card advertises. */
+export interface A2ASkill {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly tags?: readonly string[];
+}
+/** The agent card this wire serves — what another agent reads to decide to call yours. */
+export interface A2AAgentCard {
+    readonly name: string;
+    readonly description: string;
+    readonly version: string;
+    /** Where callers reach this agent. A runtime that mounts the agent behind its
+     *  own URL fills this in; left out, the card simply omits it. */
+    readonly url?: string;
+    /** Default `false` — see the module note on why this wire does not claim it. */
+    readonly streaming?: boolean;
+    readonly defaultInputModes?: readonly string[];
+    readonly defaultOutputModes?: readonly string[];
+    readonly skills?: readonly A2ASkill[];
+}
+export interface A2AWireOptions {
+    /** The agent card. Required: A2A discovery is not optional in the protocol. */
+    readonly card: A2AAgentCard;
+    /** Body for the health probe. Default `{ status: 'ok' }`. */
+    readonly health?: unknown;
+    /**
+     * Map a refusal's stable code onto the numeric JSON-RPC code this deployment
+     * reports. Absent, everything that is not a malformed request is
+     * `-32603` (internal error) — the JSON-RPC catch-all.
+     *
+     * A runtime with its own published code table passes one; that table is the
+     * runtime's, and this file does not carry anybody's.
+     */
+    readonly errorCodeFor?: (code: string | undefined) => number;
+    /** Name used in refusal messages. Default `'a2aWire'`. */
+    readonly name?: string;
+}
+type JsonObject = Readonly<Record<string, unknown>>;
+/**
+ * The text of one A2A message — every part concatenated, refusing what is not text.
+ *
+ * A non-text part is refused rather than skipped for the reason every dialect
+ * in this library refuses rather than skips: an answer produced from the parts
+ * that happened to be understood is a wrong answer delivered confidently.
+ */
+export declare function readA2AMessageText(message: unknown): string;
+/**
+ * The agent card document, as the protocol prints it.
+ *
+ * Exported on its own because a deployment often has to serve the card from
+ * somewhere this wire does not own — a CDN, a route in a framework, a runtime's
+ * own discovery API — and the document should be built once, here, rather than
+ * hand-copied into each of those places.
+ */
+export declare function a2aAgentCardDocument(card: A2AAgentCard): JsonObject;
+/** An `HttpWire` speaking A2A's `message/send`. */
+export declare function a2aWire(options: A2AWireOptions): HttpWire;
+export {};
+//# sourceMappingURL=a2aWire.d.ts.map

package/dist/types/adapters/hosting/a2aWire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2aWire.d.ts","sourceRoot":"","sources":["../../../../src/adapters/hosting/a2aWire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EAAmC,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE3F,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wCAAwC;AACxC,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAC/C,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAC7C,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAE7C,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,0FAA0F;AAC1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;qEACiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;IAC7D,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAYpD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAyB3D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAkBnE;AAED,mDAAmD;AACnD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,CAwEzD"}

package/dist/types/adapters/hosting/agentCoreA2A.d.ts

@@ -0,0 +1,96 @@
+/**
+ * adapters/hosting/agentCoreA2A — an agentfootprint agent as an AWS Bedrock
+ * **AgentCore A2A** server, callable by other agents.
+ *
+ * ── The split, again ─────────────────────────────────────────────────────────
+ * Two different things are needed, and only one is Amazon's:
+ *
+ *   • The **A2A protocol** — JSON-RPC 2.0, `message/send`, artifacts, the agent
+ *     card. An open protocol several runtimes speak, so it lives in
+ *     `a2aWire.ts` with no vendor in it.
+ *   • The **container contract** — port 9000 (not 8080, and not 8000: each
+ *     protocol gets its own), the agent mounted at `/`, `GET /ping` answering
+ *     `{"status":"Healthy"}`, the session id arriving in
+ *     `X-Amzn-Bedrock-AgentCore-Runtime-Session-Id`, and a table of JSON-RPC
+ *     error codes that are this runtime's exceptions rather than A2A's. That
+ *     IS Amazon's, and it is what this file supplies.
+ *
+ * ── One deviation you must know about ────────────────────────────────────────
+ * The A2A specification delivers JSON-RPC errors over HTTP 200. **AgentCore
+ * does not** — it returns the real status code (409, 404, …) with the JSON-RPC
+ * error body. That is a fact about the platform in front of your container, so
+ * a CLIENT must parse the error body even on a non-2xx response; see
+ * `agentCoreA2AErrorCode` for the table this host mirrors on the way out.
+ *
+ * ── What is NOT provided ─────────────────────────────────────────────────────
+ * `message/stream` and the task lifecycle. The agent card this host serves
+ * therefore declares `streaming: false` unless you overrule it, because a card
+ * that advertises streaming to a wire that cannot stream is a caller left
+ * waiting. AWS's own sample card says `true`; ours says what is true of ours.
+ *
+ * @example  An agent other agents can call
+ *   import { agentCoreA2AHost, memorySessions, standingAgent } from 'agentfootprint/hosting';
+ *
+ *   const handle = await standingAgent({
+ *     agent,
+ *     sessions: memorySessions(),
+ *     host: agentCoreA2AHost({
+ *       card: { name: 'triage', description: 'Triages SAN alerts.', version: '1.0.0' },
+ *     }),
+ *   });
+ *   process.on('SIGTERM', () => void handle.close());
+ */
+/// <reference types="node" />
+import type { IncomingMessage, Server, ServerResponse } from 'node:http';
+import { type HttpHost } from '../../hosting/httpHost.js';
+import { type A2AAgentCard } from './a2aWire.js';
+/** The port an AgentCore A2A server is expected on — its own, not HTTP's or MCP's. */
+export declare const DEFAULT_AGENTCORE_A2A_PORT = 9000;
+/** A2A mounts the agent at the root. */
+export declare const AGENTCORE_A2A_INVOKE_PATH = "/";
+/** The runtime's health path for every protocol. */
+export declare const AGENTCORE_PING_PATH = "/ping";
+/** Where the platform puts the caller's session. */
+export declare const AGENTCORE_SESSION_HEADER = "X-Amzn-Bedrock-AgentCore-Runtime-Session-Id";
+/**
+ * AgentCore's own JSON-RPC error codes, mapped from this library's refusal codes.
+ *
+ * These numbers are the RUNTIME's exception table, not A2A's: `-32051`
+ * ResourceNotFound, `-32052` Validation, `-32053` Throttling and
+ * ServiceQuotaExceeded, `-32054` Conflict and RetryableConflict, `-32055`
+ * RuntimeClientError, `-32603` anything else. A client reads them to decide
+ * whether to retry — `-32054` with "Session operation in progress" is the one
+ * that must be retried with backoff, and A2A clients do not do that on their
+ * own.
+ *
+ * Exported so a client built against this host can share one table with it
+ * rather than keep a second copy that drifts.
+ */
+export declare function agentCoreA2AErrorCode(code: string | undefined): number;
+export interface AgentCoreA2AHostOptions {
+    /** The agent card other agents read. Required — discovery is not optional in A2A. */
+    readonly card: A2AAgentCard;
+    /** Port to bind. Default {@link DEFAULT_AGENTCORE_A2A_PORT}. Pass `0` in tests. */
+    readonly port?: number;
+    /** Interface to bind. Default `'0.0.0.0'` — a container's door must be reachable. */
+    readonly hostname?: string;
+    /** Ceiling on a request body. Default one mebibyte. */
+    readonly maxBodyBytes?: number;
+    /** A `node:http` server you own. Refused together with `port`/`hostname`. */
+    readonly server?: Server;
+    /**
+     * Answer a path this host does not own. The agent card is served BEFORE this
+     * runs, and everything else falls through to you unchanged — so supplying one
+     * costs you nothing the card was not already going to take.
+     */
+    readonly onUnhandled?: (req: IncomingMessage, res: ServerResponse) => void;
+}
+/**
+ * An {@link HttpHost} serving AgentCore's A2A container contract.
+ *
+ * `httpHost` keeps its own promises — draining, aborting on disconnect, failing
+ * a handler that throws or answers nothing — and this supplies the protocol,
+ * the paths, the port, the session header and the error table.
+ */
+export declare function agentCoreA2AHost(options: AgentCoreA2AHostOptions): HttpHost;
+//# sourceMappingURL=agentCoreA2A.d.ts.map

package/dist/types/adapters/hosting/agentCoreA2A.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCoreA2A.d.ts","sourceRoot":"","sources":["../../../../src/adapters/hosting/agentCoreA2A.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,sFAAsF;AACtF,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,gDAAgD,CAAC;AAEtF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA4BtE;AAED,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5E;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,QAAQ,CAmE3E"}