agentfootprint 9.67.0 → 9.69.0

package/dist/adapters/browser/agentcore.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * agentCoreBrowser — AWS Bedrock AgentCore **Browser** as a {@link BrowserRunner}.
+ *
+ * A managed Chrome in AWS's account that an agent can drive, a person can watch
+ * live, and — the part this adapter exists for — a person can TAKE OVER
+ * mid-session and hand back.
+ *
+ * ── Two channels, and only one of them is here ───────────────────────────────
+ * A browser session has two doors, and confusing them wastes a day:
+ *
+ *   1. **The automation stream** — a CDP WebSocket. Navigate, find an element,
+ *      fill a form: everything page-shaped happens here, driven by Playwright
+ *      or another CDP client. This adapter hands you
+ *      {@link BrowserSession.automationEndpoint} and stays out of the way. It
+ *      does not depend on Playwright and does not drive the page for you.
+ *   2. **`InvokeBrowser`** — the data-plane operation this adapter calls. It is
+ *      OS-LEVEL input ABOVE the page: mouse, keyboard, screenshots. Its action
+ *      union, read off the SDK rather than remembered, is exactly
+ *      `mouseClick | mouseMove | mouseDrag | mouseScroll | keyType | keyPress |
+ *      keyShortcut | screenshot`. **There is no navigate action**, and a reader
+ *      expecting one is looking at the wrong door.
+ *
+ * ── The takeover ─────────────────────────────────────────────────────────────
+ * `UpdateBrowserStream` with `automationStreamUpdate.streamStatus` set to
+ * `DISABLED` stops the automation channel and leaves the live-view user in
+ * control; `ENABLED` gives it back. That is `handControlTo('person' | 'agent')`
+ * here, and it composes with this library's check-in: the agent pauses, a
+ * person finishes the login, the agent resumes on the page they left — and both
+ * handovers are ordinary events in the trace.
+ *
+ * ── How this talks to the SDK (the 9.4.0 law) ────────────────────────────────
+ * Through `client.send(new SomeCommand(input))`, never a method on the client —
+ * a bare `@aws-sdk/client-*` Client carries `send` and `destroy` and nothing
+ * else. Every command name and request shape below was read off a real install
+ * of `@aws-sdk/client-bedrock-agentcore` **3.1118.0**, including the action
+ * union above and `ScreenshotResult`'s `{ status, error?, data? }`.
+ *
+ * ── One documented contradiction, left as AWS wrote it ───────────────────────
+ * The devguide says a session defaults to 15 minutes; `StartBrowserSession`'s
+ * API reference says 3600 seconds. This adapter sends nothing unless you pass
+ * `sessionTimeoutSeconds`, so the default is whatever the service applies —
+ * rather than this file picking a side in somebody else's disagreement.
+ *
+ * Pattern: Adapter (GoF) + lazy peer-dep load — the SDK is required only when
+ * `start()` first runs, or never, if you inject `_client` / `_sdk`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentCoreBrowser = exports.AWS_SYSTEM_BROWSER = void 0;
+const lazyRequire_js_1 = require("../../lib/lazyRequire.js");
+/** AWS's managed browser. A custom `CreateBrowser` resource id goes here instead. */
+exports.AWS_SYSTEM_BROWSER = 'aws.browser.v1';
+const BUTTONS = { left: 'LEFT', middle: 'MIDDLE', right: 'RIGHT' };
+function createBrowserClient(options) {
+    let mod;
+    if (options._sdk) {
+        mod = options._sdk;
+    }
+    else {
+        try {
+            mod = (0, lazyRequire_js_1.lazyRequire)('@aws-sdk/client-bedrock-agentcore');
+        }
+        catch {
+            throw new Error('agentCoreBrowser requires the `@aws-sdk/client-bedrock-agentcore` peer dependency.\n' +
+                '  Install:  npm install @aws-sdk/client-bedrock-agentcore\n' +
+                '  Or pass `_client` for a pre-built or mock client.');
+        }
+    }
+    if (!mod.BedrockAgentCoreClient) {
+        throw new Error('agentCoreBrowser: `@aws-sdk/client-bedrock-agentcore` is installed but ' +
+            '`BedrockAgentCoreClient` was not found. Update the SDK.');
+    }
+    const sdk = new mod.BedrockAgentCoreClient({ ...(options.region && { region: options.region }) });
+    const send = async (Ctor, name, input) => {
+        if (!Ctor) {
+            throw new Error(`agentCoreBrowser: \`@aws-sdk/client-bedrock-agentcore\` is missing ${name}. ` +
+                'Upgrade the SDK, or pass `_client` with your own mapping.');
+        }
+        return sdk.send(new Ctor(input));
+    };
+    return {
+        async startBrowserSession(input) {
+            return (await send(mod.StartBrowserSessionCommand, 'StartBrowserSessionCommand', input));
+        },
+        async invokeBrowser(input) {
+            return (await send(mod.InvokeBrowserCommand, 'InvokeBrowserCommand', input));
+        },
+        async updateBrowserStream(input) {
+            await send(mod.UpdateBrowserStreamCommand, 'UpdateBrowserStreamCommand', input);
+        },
+        async stopBrowserSession(input) {
+            await send(mod.StopBrowserSessionCommand, 'StopBrowserSessionCommand', input);
+        },
+    };
+}
+/**
+ * Build a {@link BrowserRunner} backed by AgentCore Browser.
+ *
+ * @example  A session, a person taking over, and the agent resuming
+ *   const browser = agentCoreBrowser({ region: 'us-east-1' });
+ *   const session = await browser.start({ key: toolSessionKey(ctx, 'run') });
+ *
+ *   // Page work goes over CDP, not through this adapter:
+ *   //   const page = await chromium.connectOverCDP(session.automationEndpoint!)
+ *
+ *   await session.handControlTo?.('person');   // they finish the login
+ *   await session.handControlTo?.('agent');    // and the agent carries on
+ *   await session.stop();
+ */
+function agentCoreBrowser(options = {}) {
+    const browserIdentifier = options.browserIdentifier ?? exports.AWS_SYSTEM_BROWSER;
+    let client;
+    const getClient = () => {
+        client ??= options._client ?? createBrowserClient(options);
+        return client;
+    };
+    return {
+        id: options.id ?? 'agentcore-browser',
+        async start(req) {
+            const c = getClient();
+            const started = await c.startBrowserSession({
+                browserIdentifier,
+                name: req.key,
+                ...(options.sessionTimeoutSeconds !== undefined && {
+                    sessionTimeoutSeconds: options.sessionTimeoutSeconds,
+                }),
+                ...(options.viewport !== undefined && { viewPort: options.viewport }),
+            });
+            const sessionId = started.sessionId;
+            if (!sessionId) {
+                throw new Error('agentCoreBrowser: StartBrowserSession returned no sessionId, so there is no session ' +
+                    'to drive. Check the browser identifier and the execution role.');
+            }
+            const act = async (action) => {
+                const answer = await c.invokeBrowser({ browserIdentifier, sessionId, action });
+                return answer.result;
+            };
+            const automationEndpoint = started.streams?.automationStream?.streamEndpoint;
+            const liveViewEndpoint = started.streams?.liveViewStream?.streamEndpoint;
+            const session = {
+                id: sessionId,
+                ...(automationEndpoint !== undefined && { automationEndpoint }),
+                ...(liveViewEndpoint !== undefined && { liveViewEndpoint }),
+                async click({ x, y, button, clicks }) {
+                    await act({
+                        mouseClick: {
+                            x,
+                            y,
+                            ...(button !== undefined && { button: BUTTONS[button] }),
+                            ...(clicks !== undefined && { clickCount: clicks }),
+                        },
+                    });
+                },
+                async type(text) {
+                    await act({ keyType: { text } });
+                },
+                async press({ key, times }) {
+                    await act({ keyPress: { key, ...(times !== undefined && { presses: times }) } });
+                },
+                async screenshot() {
+                    const result = await act({ screenshot: { format: 'PNG' } });
+                    const shot = result?.screenshot;
+                    if (!shot?.data) {
+                        // The result member carries its own status and error, so a failed
+                        // screenshot says what the service said rather than answering with
+                        // an empty image that reads as a blank page.
+                        throw new Error(`agentCoreBrowser: the screenshot did not produce image data` +
+                            `${shot?.status ? ` (status ${shot.status})` : ''}` +
+                            `${shot?.error ? `: ${shot.error}` : '.'}`);
+                    }
+                    return { data: shot.data, format: 'png' };
+                },
+                async handControlTo(driver) {
+                    // The person takes over by DISABLING automation: the live-view user
+                    // is already connected, and stopping the automation stream is what
+                    // lets their input through.
+                    await c.updateBrowserStream({
+                        browserIdentifier,
+                        sessionId,
+                        streamUpdate: {
+                            automationStreamUpdate: {
+                                streamStatus: driver === 'person' ? 'DISABLED' : 'ENABLED',
+                            },
+                        },
+                    });
+                },
+                async stop() {
+                    try {
+                        await c.stopBrowserSession({ browserIdentifier, sessionId });
+                    }
+                    catch {
+                        // A managed session reaped by its own idle timeout is the ordinary
+                        // case, and stopping one that is already gone is a no-op — the port
+                        // says so, and a throw here would fail a teardown that succeeded.
+                    }
+                },
+            };
+            return session;
+        },
+    };
+}
+exports.agentCoreBrowser = agentCoreBrowser;
+//# sourceMappingURL=agentcore.js.map

package/dist/adapters/browser/agentcore.js.map

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

package/dist/adapters/hosting/a2aWire.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * 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',
+ *   });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.a2aWire = exports.a2aAgentCardDocument = exports.readA2AMessageText = 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 = void 0;
+const errors_js_1 = require("../../hosting/errors.js");
+/** The A2A protocol revision this wire's documents declare. */
+exports.A2A_PROTOCOL_VERSION = '0.3.0';
+/** Where the A2A specification puts an agent's discovery document. */
+exports.A2A_AGENT_CARD_PATH = '/.well-known/agent-card.json';
+/** The one method this wire carries. */
+exports.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.
+ */
+exports.JSONRPC_METHOD_NOT_FOUND = -32601;
+exports.JSONRPC_INVALID_PARAMS = -32602;
+exports.JSONRPC_INTERNAL_ERROR = -32603;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** The request's JSON-RPC id, echoed onto every reply. `null` is legal and distinct from absent. */
+function requestId(facts) {
+    const id = facts?.body.id;
+    return typeof id === 'string' || typeof id === 'number' ? id : null;
+}
+/**
+ * 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.
+ */
+function readA2AMessageText(message) {
+    if (!isRecord(message)) {
+        throw new errors_js_1.WireRequestRefusal('invalid_params', 'params.message must be an object', 400);
+    }
+    const parts = message.parts;
+    if (!Array.isArray(parts) || parts.length === 0) {
+        throw new errors_js_1.WireRequestRefusal('invalid_params', 'params.message.parts must be a non-empty array', 400);
+    }
+    const text = [];
+    for (const part of parts) {
+        if (!isRecord(part) || part.kind !== 'text' || typeof part.text !== 'string') {
+            const kind = isRecord(part) && typeof part.kind === 'string' ? part.kind : 'unknown';
+            throw new errors_js_1.WireRequestRefusal('unsupported_part', `this agent carries text parts only; '${kind}' parts are not supported`, 400);
+        }
+        text.push(part.text);
+    }
+    return text.join('');
+}
+exports.readA2AMessageText = readA2AMessageText;
+/**
+ * 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.
+ */
+function a2aAgentCardDocument(card) {
+    return {
+        name: card.name,
+        description: card.description,
+        version: card.version,
+        ...(card.url !== undefined && { url: card.url }),
+        protocolVersion: exports.A2A_PROTOCOL_VERSION,
+        preferredTransport: 'JSONRPC',
+        capabilities: { streaming: card.streaming === true },
+        defaultInputModes: card.defaultInputModes ?? ['text'],
+        defaultOutputModes: card.defaultOutputModes ?? ['text'],
+        skills: (card.skills ?? []).map((s) => ({
+            id: s.id,
+            name: s.name,
+            description: s.description,
+            tags: s.tags ?? [],
+        })),
+    };
+}
+exports.a2aAgentCardDocument = a2aAgentCardDocument;
+/** An `HttpWire` speaking A2A's `message/send`. */
+function a2aWire(options) {
+    const health = options.health ?? { status: 'ok' };
+    const name = options.name ?? 'a2aWire';
+    const codeFor = options.errorCodeFor ?? (() => exports.JSONRPC_INTERNAL_ERROR);
+    const envelope = (facts, body) => ({
+        jsonrpc: '2.0',
+        id: requestId(facts),
+        ...body,
+    });
+    return {
+        readRequest(facts) {
+            const { body } = facts;
+            if (body.jsonrpc !== '2.0') {
+                throw new errors_js_1.WireRequestRefusal('invalid_request', `${name}: every request must carry "jsonrpc": "2.0"`, 400);
+            }
+            if (body.method !== exports.A2A_SEND_METHOD) {
+                // Named rather than ignored: a caller using a method this agent does
+                // not implement learns which one it does, instead of receiving an
+                // empty answer to a question that was never asked.
+                throw new errors_js_1.WireRequestRefusal('method_not_found', `${name}: only '${exports.A2A_SEND_METHOD}' is implemented; received '${String(body.method)}'`, 404);
+            }
+            const params = isRecord(body.params) ? body.params : undefined;
+            const input = readA2AMessageText(params?.message);
+            if (input.trim() === '') {
+                throw new errors_js_1.WireRequestRefusal('invalid_params', `${name}: message text must not be empty`, 400);
+            }
+            // A2A carries no session of its own — the transport hosting it does, and
+            // the runtime adapter reads it from wherever that transport puts it.
+            return { input };
+        },
+        health: () => health,
+        output: (output, facts) => envelope(facts, {
+            result: {
+                artifacts: [
+                    {
+                        artifactId: String(facts?.body.id ?? 'artifact'),
+                        name: 'agent_response',
+                        parts: [{ kind: 'text', text: output }],
+                    },
+                ],
+            },
+        }),
+        chunk: (text) => ({ kind: 'text', text }),
+        failure: (message, code, facts, origin) => envelope(facts, {
+            error: {
+                code: codeFor(code),
+                // A thrown exception's words are the author's note to their own logs.
+                // A refusal this library authored was written to be read.
+                message: origin === 'threw' ? 'The agent could not complete this request.' : message,
+            },
+        }),
+    };
+}
+exports.a2aWire = a2aWire;
+//# sourceMappingURL=a2aWire.js.map

package/dist/adapters/hosting/a2aWire.js.map

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

package/dist/adapters/hosting/agentCoreA2A.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * 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());
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentCoreA2AHost = exports.agentCoreA2AErrorCode = exports.AGENTCORE_SESSION_HEADER = exports.AGENTCORE_PING_PATH = exports.AGENTCORE_A2A_INVOKE_PATH = exports.DEFAULT_AGENTCORE_A2A_PORT = void 0;
+const httpHost_js_1 = require("../../hosting/httpHost.js");
+const a2aWire_js_1 = require("./a2aWire.js");
+/** The port an AgentCore A2A server is expected on — its own, not HTTP's or MCP's. */
+exports.DEFAULT_AGENTCORE_A2A_PORT = 9000;
+/** A2A mounts the agent at the root. */
+exports.AGENTCORE_A2A_INVOKE_PATH = '/';
+/** The runtime's health path for every protocol. */
+exports.AGENTCORE_PING_PATH = '/ping';
+/** Where the platform puts the caller's session. */
+exports.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.
+ */
+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;
+    }
+}
+exports.agentCoreA2AErrorCode = agentCoreA2AErrorCode;
+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.
+ */
+function agentCoreA2AHost(options) {
+    const { server, onUnhandled, hostname, card } = options;
+    const cardDocument = JSON.stringify((0, a2aWire_js_1.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 === a2aWire_js_1.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 ?? exports.DEFAULT_AGENTCORE_A2A_PORT,
+            ...(hostname === undefined ? {} : { hostname }),
+            onUnhandled: serveCard,
+        };
+    const protocol = (0, a2aWire_js_1.a2aWire)({
+        card,
+        // The runtime's health contract, not A2A's — A2A has no /ping at all.
+        health: { status: 'Healthy' },
+        errorCodeFor: agentCoreA2AErrorCode,
+        name: 'agentCoreA2AHost',
+    });
+    return (0, httpHost_js_1.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 = (0, httpHost_js_1.headerValue)(facts, exports.AGENTCORE_SESSION_HEADER);
+                return { ...base, ...(sessionId !== undefined && { sessionId }) };
+            },
+        },
+        invokePath: exports.AGENTCORE_A2A_INVOKE_PATH,
+        healthPath: exports.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,
+    });
+}
+exports.agentCoreA2AHost = agentCoreA2AHost;
+//# sourceMappingURL=agentCoreA2A.js.map

package/dist/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/adapters/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAsHH;;;;GAIG;AACU,QAAA,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAqsBH;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAsC,EACtC,UAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAPD,wCAOC;AAqDD;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAgGpD;uDACuD;AACvD,SAAgB,kBAAkB,CAChC,OAAoB;IAEpB,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;AACnD,CAAC;AAJD,gDAIC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAsHH;;;;GAIG;AACU,QAAA,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAqsBH;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAsC,EACtC,UAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAPD,wCAOC;AAqID;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAgGpD;uDACuD;AACvD,SAAgB,kBAAkB,CAChC,OAAoB;IAEpB,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;AACnD,CAAC;AAJD,gDAIC"}

package/dist/doors/providers.js

@@ -41,7 +41,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentCoreCodeRunner = exports.localCodeRunner = void 0;
+exports.agentCoreCodeRunner = exports.AWS_SYSTEM_BROWSER = exports.agentCoreBrowser = exports.localCodeRunner = void 0;
 __exportStar(require("../llm-providers.js"), exports);
 __exportStar(require("../embedders/index.js"), exports);
 __exportStar(require("../tool-providers/index.js"), exports);
@@ -51,6 +51,12 @@ __exportStar(require("../thinking/index.js"), exports);
 // other adapter ports.
 var local_js_1 = require("../adapters/code/local.js");
 Object.defineProperty(exports, "localCodeRunner", { enumerable: true, get: function () { return local_js_1.localCodeRunner; } });
-var agentcore_js_1 = require("../adapters/code/agentcore.js");
-Object.defineProperty(exports, "agentCoreCodeRunner", { enumerable: true, get: function () { return agentcore_js_1.agentCoreCodeRunner; } });
+// A managed browser behind the `BrowserRunner` port (9.68.0). Page work goes
+// over CDP through `session.automationEndpoint`; what this carries is the
+// session, the OS-level input above the page, and the human takeover.
+var agentcore_js_1 = require("../adapters/browser/agentcore.js");
+Object.defineProperty(exports, "agentCoreBrowser", { enumerable: true, get: function () { return agentcore_js_1.agentCoreBrowser; } });
+Object.defineProperty(exports, "AWS_SYSTEM_BROWSER", { enumerable: true, get: function () { return agentcore_js_1.AWS_SYSTEM_BROWSER; } });
+var agentcore_js_2 = require("../adapters/code/agentcore.js");
+Object.defineProperty(exports, "agentCoreCodeRunner", { enumerable: true, get: function () { return agentcore_js_2.agentCoreCodeRunner; } });
 //# sourceMappingURL=providers.js.map

package/dist/doors/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/doors/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,wDAAsC;AACtC,6DAA2C;AAC3C,uDAAqC;AAErC,6EAA6E;AAC7E,gFAAgF;AAChF,uBAAuB;AACvB,sDAAyF;AAAhF,2GAAA,eAAe,OAAA;AACxB,8DAMuC;AALrC,mHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/doors/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,wDAAsC;AACtC,6DAA2C;AAC3C,uDAAqC;AAErC,6EAA6E;AAC7E,gFAAgF;AAChF,uBAAuB;AACvB,sDAAyF;AAAhF,2GAAA,eAAe,OAAA;AACxB,6EAA6E;AAC7E,0EAA0E;AAC1E,sEAAsE;AACtE,iEAM0C;AALxC,gHAAA,gBAAgB,OAAA;AAChB,kHAAA,kBAAkB,OAAA;AAKpB,8DAMuC;AALrC,mHAAA,mBAAmB,OAAA"}