agentfootprint 9.67.0 → 9.69.0

package/dist/esm/adapters/browser/agentcore.d.ts

@@ -0,0 +1,141 @@
+/**
+ * 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`.
+ */
+import type { BrowserRunner } from '../types.js';
+/** AWS's managed browser. A custom `CreateBrowser` resource id goes here instead. */
+export declare const AWS_SYSTEM_BROWSER = "aws.browser.v1";
+export interface AgentCoreBrowserOptions {
+    /** AWS region. Falls back to the SDK's own resolution when omitted. */
+    readonly region?: string;
+    /** Which browser resource. Default {@link AWS_SYSTEM_BROWSER}. */
+    readonly browserIdentifier?: string;
+    /**
+     * Session lifetime in seconds. **Left unset by default on purpose** — AWS's
+     * own devguide (15 minutes) and API reference (3600 seconds) disagree, so
+     * sending nothing lets the service apply whichever it actually means.
+     */
+    readonly sessionTimeoutSeconds?: number;
+    /** Viewport for the session, when you want one that is not the default. */
+    readonly viewport?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /** Stable runner id (default `'agentcore-browser'`). */
+    readonly id?: string;
+    /** Test seam — inject a client implementing {@link AgentCoreBrowserClientLike}. */
+    readonly _client?: AgentCoreBrowserClientLike;
+    /** @internal Test injection — the AWS SDK module. */
+    readonly _sdk?: BedrockAgentCoreBrowserSdkModule;
+}
+/** The operation-semantic surface this adapter calls. */
+export interface AgentCoreBrowserClientLike {
+    startBrowserSession(input: {
+        readonly browserIdentifier: string;
+        readonly name?: string;
+        readonly sessionTimeoutSeconds?: number;
+        readonly viewPort?: {
+            readonly width: number;
+            readonly height: number;
+        };
+    }): Promise<{
+        readonly sessionId?: string;
+        readonly streams?: {
+            readonly automationStream?: {
+                readonly streamEndpoint?: string;
+            };
+            readonly liveViewStream?: {
+                readonly streamEndpoint?: string;
+            };
+        };
+    }>;
+    invokeBrowser(input: {
+        readonly browserIdentifier: string;
+        readonly sessionId: string;
+        readonly action: Readonly<Record<string, unknown>>;
+    }): Promise<{
+        readonly result?: Readonly<Record<string, unknown>>;
+    }>;
+    updateBrowserStream(input: {
+        readonly browserIdentifier: string;
+        readonly sessionId: string;
+        readonly streamUpdate: {
+            readonly automationStreamUpdate: {
+                readonly streamStatus: 'ENABLED' | 'DISABLED';
+            };
+        };
+    }): Promise<void>;
+    stopBrowserSession(input: {
+        readonly browserIdentifier: string;
+        readonly sessionId: string;
+    }): Promise<void>;
+}
+/** The slice of `@aws-sdk/client-bedrock-agentcore` this shim touches. */
+export interface BedrockAgentCoreBrowserSdkModule {
+    readonly BedrockAgentCoreClient?: new (config: {
+        region?: string;
+    }) => {
+        send(cmd: unknown): Promise<unknown>;
+    };
+    readonly StartBrowserSessionCommand?: new (input: unknown) => unknown;
+    readonly InvokeBrowserCommand?: new (input: unknown) => unknown;
+    readonly UpdateBrowserStreamCommand?: new (input: unknown) => unknown;
+    readonly StopBrowserSessionCommand?: new (input: unknown) => unknown;
+}
+/**
+ * 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();
+ */
+export declare function agentCoreBrowser(options?: AgentCoreBrowserOptions): BrowserRunner;

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

@@ -0,0 +1,199 @@
+/**
+ * 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`.
+ */
+import { lazyRequire } from '../../lib/lazyRequire.js';
+/** AWS's managed browser. A custom `CreateBrowser` resource id goes here instead. */
+export const 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 = 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();
+ */
+export function agentCoreBrowser(options = {}) {
+    const browserIdentifier = options.browserIdentifier ?? 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;
+        },
+    };
+}
+//# sourceMappingURL=agentcore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentcore.js","sourceRoot":"","sources":["../../../../src/adapters/browser/agentcore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAkEnD,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAE5E,SAAS,mBAAmB,CAAC,OAAgC;IAC3D,IAAI,GAAqC,CAAC;IAC1C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,GAAG,GAAG,WAAW,CAAmC,mCAAmC,CAAC,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,sFAAsF;gBACpF,6DAA6D;gBAC7D,qDAAqD,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,sBAAsB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAElG,MAAM,IAAI,GAAG,KAAK,EAChB,IAA+C,EAC/C,IAAY,EACZ,KAAc,EACI,EAAE;QACpB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,sEAAsE,IAAI,IAAI;gBAC5E,2DAA2D,CAC9D,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,mBAAmB,CAAC,KAAK;YAC7B,OAAO,CAAC,MAAM,IAAI,CAChB,GAAG,CAAC,0BAA0B,EAC9B,4BAA4B,EAC5B,KAAK,CACN,CAA2E,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,KAAK,CAAC,CAE1E,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,KAAK;YAC7B,MAAM,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,4BAA4B,EAAE,KAAK,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,KAAK;YAC5B,MAAM,IAAI,CAAC,GAAG,CAAC,yBAAyB,EAAE,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,kBAAkB,CAAC;IAC1E,IAAI,MAA8C,CAAC;IACnD,MAAM,SAAS,GAAG,GAA+B,EAAE;QACjD,MAAM,KAAK,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,mBAAmB;QACrC,KAAK,CAAC,KAAK,CAAC,GAAG;YACb,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,mBAAmB,CAAC;gBAC1C,iBAAiB;gBACjB,IAAI,EAAE,GAAG,CAAC,GAAG;gBACb,GAAG,CAAC,OAAO,CAAC,qBAAqB,KAAK,SAAS,IAAI;oBACjD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;iBACrD,CAAC;gBACF,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;aACtE,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YACpC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,sFAAsF;oBACpF,gEAAgE,CACnE,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,KAAK,EACf,MAAyC,EACe,EAAE;gBAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,aAAa,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC/E,OAAO,MAAM,CAAC,MAAM,CAAC;YACvB,CAAC,CAAC;YAEF,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,CAAC;YAC7E,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,CAAC;YAEzE,MAAM,OAAO,GAAmB;gBAC9B,EAAE,EAAE,SAAS;gBACb,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,EAAE,kBAAkB,EAAE,CAAC;gBAC/D,GAAG,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,CAAC;gBAE3D,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;oBAClC,MAAM,GAAG,CAAC;wBACR,UAAU,EAAE;4BACV,CAAC;4BACD,CAAC;4BACD,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;4BACxD,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;yBACpD;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,CAAC,IAAI,CAAC,IAAI;oBACb,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBACnC,CAAC;gBAED,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE;oBACxB,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnF,CAAC;gBAED,KAAK,CAAC,UAAU;oBACd,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC5D,MAAM,IAAI,GAAG,MAAM,EAAE,UAER,CAAC;oBACd,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;wBAChB,kEAAkE;wBAClE,mEAAmE;wBACnE,6CAA6C;wBAC7C,MAAM,IAAI,KAAK,CACb,6DAA6D;4BAC3D,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;4BACnD,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAC7C,CAAC;oBACJ,CAAC;oBACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBAC5C,CAAC;gBAED,KAAK,CAAC,aAAa,CAAC,MAAqB;oBACvC,oEAAoE;oBACpE,mEAAmE;oBACnE,4BAA4B;oBAC5B,MAAM,CAAC,CAAC,mBAAmB,CAAC;wBAC1B,iBAAiB;wBACjB,SAAS;wBACT,YAAY,EAAE;4BACZ,sBAAsB,EAAE;gCACtB,YAAY,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;6BAC3D;yBACF;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,CAAC,IAAI;oBACR,IAAI,CAAC;wBACH,MAAM,CAAC,CAAC,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC;oBAC/D,CAAC;oBAAC,MAAM,CAAC;wBACP,mEAAmE;wBACnE,oEAAoE;wBACpE,kEAAkE;oBACpE,CAAC;gBACH,CAAC;aACF,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,110 @@
+/**
+ * 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 {};

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

@@ -0,0 +1,166 @@
+/**
+ * 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 { WireRequestRefusal } from '../../hosting/errors.js';
+/** The A2A protocol revision this wire's documents declare. */
+export const A2A_PROTOCOL_VERSION = '0.3.0';
+/** Where the A2A specification puts an agent's discovery document. */
+export const A2A_AGENT_CARD_PATH = '/.well-known/agent-card.json';
+/** The one method this wire carries. */
+export 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 const JSONRPC_METHOD_NOT_FOUND = -32601;
+export const JSONRPC_INVALID_PARAMS = -32602;
+export const 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.
+ */
+export function readA2AMessageText(message) {
+    if (!isRecord(message)) {
+        throw new WireRequestRefusal('invalid_params', 'params.message must be an object', 400);
+    }
+    const parts = message.parts;
+    if (!Array.isArray(parts) || parts.length === 0) {
+        throw new 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 WireRequestRefusal('unsupported_part', `this agent carries text parts only; '${kind}' parts are not supported`, 400);
+        }
+        text.push(part.text);
+    }
+    return text.join('');
+}
+/**
+ * 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 function a2aAgentCardDocument(card) {
+    return {
+        name: card.name,
+        description: card.description,
+        version: card.version,
+        ...(card.url !== undefined && { url: card.url }),
+        protocolVersion: 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 ?? [],
+        })),
+    };
+}
+/** An `HttpWire` speaking A2A's `message/send`. */
+export function a2aWire(options) {
+    const health = options.health ?? { status: 'ok' };
+    const name = options.name ?? 'a2aWire';
+    const codeFor = options.errorCodeFor ?? (() => 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 WireRequestRefusal('invalid_request', `${name}: every request must carry "jsonrpc": "2.0"`, 400);
+            }
+            if (body.method !== 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 WireRequestRefusal('method_not_found', `${name}: only '${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 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,
+            },
+        }),
+    };
+}
+//# sourceMappingURL=a2aWire.js.map

package/dist/esm/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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"}