@alexkroman1/aai 0.4.0 → 0.6.0

package/dist/sdk/builtin_tools.js

@@ -0,0 +1,263 @@
+// Copyright 2025 the AAI authors. MIT license.
+/**
+ * Built-in tool definitions for the AAI agent SDK.
+ *
+ * These tools run inside the sandboxed worker alongside custom tools.
+ * Network requests go through the host's fetch proxy (with SSRF protection).
+ *
+ * @module
+ */
+import { z } from "zod";
+const EMPTY_PARAMS = z.object({});
+// ─── HTML to text ──────────────────────────────────────────────────────────
+function htmlToText(html) {
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<(br|hr)\s*\/?>/gi, "\n")
+        .replace(/<\/(p|div|li|h[1-6]|tr|blockquote)>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#0?39;/g, "'")
+        .replace(/[ \t]+/g, " ")
+        .replace(/\n /g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+// ─── web_search ────────────────────────────────────────────────────────────
+const webSearchParams = z.object({
+    query: z.string().describe("The search query"),
+    max_results: z.number().describe("Maximum number of results to return (default 5)").optional(),
+});
+const BRAVE_SEARCH_URL = "https://api.search.brave.com/res/v1/web/search";
+const BraveSearchResponseSchema = z.object({
+    web: z
+        .object({
+        results: z.array(z.object({
+            title: z.string(),
+            url: z.string(),
+            description: z.string(),
+        })),
+    })
+        .optional(),
+});
+function createWebSearch() {
+    return {
+        description: "Search the web for current information, facts, news, or answers to questions. Returns a list of results with title, URL, and description. Use this when the user asks about something you don't know, need up-to-date information, or want to verify facts.",
+        parameters: webSearchParams,
+        async execute(args, ctx) {
+            const { query, max_results: maxResults = 5 } = args;
+            const apiKey = ctx.env.BRAVE_API_KEY ?? "";
+            if (!apiKey) {
+                return { error: "BRAVE_API_KEY is not set — web search unavailable" };
+            }
+            const url = `${BRAVE_SEARCH_URL}?${new URLSearchParams({
+                q: query,
+                count: String(maxResults),
+                text_decorations: "false",
+            })}`;
+            const resp = await fetch(url, {
+                headers: { "X-Subscription-Token": apiKey },
+                signal: ctx.abortSignal ?? AbortSignal.timeout(15_000),
+            });
+            if (!resp.ok)
+                return [];
+            const raw = await resp.json();
+            const data = BraveSearchResponseSchema.safeParse(raw);
+            if (!data.success)
+                return [];
+            return (data.data.web?.results ?? []).slice(0, maxResults).map((r) => ({
+                title: r.title,
+                url: r.url,
+                description: r.description,
+            }));
+        },
+    };
+}
+// ─── visit_webpage ─────────────────────────────────────────────────────────
+const MAX_PAGE_CHARS = 10_000;
+const MAX_HTML_BYTES = 200_000;
+const visitWebpageParams = z.object({
+    url: z.string().describe("The full URL to fetch (e.g., 'https://example.com/page')"),
+});
+function createVisitWebpage() {
+    return {
+        description: "Fetch a webpage and return its content as clean text. Use this to read the full content of a URL found via web_search, or any link the user shares. Good for reading articles, documentation, blog posts, or product pages.",
+        parameters: visitWebpageParams,
+        async execute(args, ctx) {
+            const { url } = args;
+            const resp = await fetch(url, {
+                headers: {
+                    "User-Agent": "Mozilla/5.0 (compatible; VoiceAgent/1.0; +https://github.com/AssemblyAI/aai)",
+                    Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                },
+                redirect: "follow",
+                signal: ctx.abortSignal ?? AbortSignal.timeout(15_000),
+            });
+            if (!resp.ok) {
+                return { error: `Failed to fetch: ${resp.status} ${resp.statusText}`, url };
+            }
+            const htmlContent = await resp.text();
+            const trimmedHtml = htmlContent.length > MAX_HTML_BYTES ? htmlContent.slice(0, MAX_HTML_BYTES) : htmlContent;
+            const text = htmlToText(trimmedHtml);
+            const truncated = text.length > MAX_PAGE_CHARS;
+            const content = truncated ? text.slice(0, MAX_PAGE_CHARS) : text;
+            return {
+                url,
+                content,
+                ...(truncated ? { truncated: true, totalChars: text.length } : {}),
+            };
+        },
+    };
+}
+// ─── fetch_json ────────────────────────────────────────────────────────────
+const fetchJsonParams = z.object({
+    url: z.string().describe("The URL to fetch JSON from"),
+    headers: z
+        .record(z.string(), z.string())
+        .describe("Optional HTTP headers to include in the request")
+        .optional(),
+});
+function createFetchJson() {
+    return {
+        description: "Call a REST API endpoint via HTTP GET and return the JSON response. Use this to fetch structured data from APIs — for example, weather data, stock prices, exchange rates, or any public JSON API. Supports custom headers for authenticated APIs.",
+        parameters: fetchJsonParams,
+        async execute(args, ctx) {
+            const { url, headers } = args;
+            const resp = await fetch(url, {
+                ...(headers && { headers }),
+                signal: ctx.abortSignal ?? AbortSignal.timeout(15_000),
+            });
+            if (!resp.ok) {
+                return { error: `HTTP ${resp.status} ${resp.statusText}`, url };
+            }
+            try {
+                return await resp.json();
+            }
+            catch {
+                return { error: "Response was not valid JSON", url };
+            }
+        },
+    };
+}
+// ─── run_code ──────────────────────────────────────────────────────────────
+const runCodeParams = z.object({
+    code: z.string().describe("JavaScript code to execute. Use console.log() for output."),
+});
+function createRunCode() {
+    return {
+        description: "Execute JavaScript code in a secure sandbox and return the output. Use this for calculations, data transformations, string manipulation, or any task that benefits from running code. Output is captured from console.log(). No network or filesystem access.",
+        parameters: runCodeParams,
+        async execute(args) {
+            const { code } = args;
+            const output = [];
+            function capture(...captureArgs) {
+                output.push(captureArgs.map(String).join(" "));
+            }
+            const fakeConsole = {
+                log: capture,
+                info: capture,
+                warn: capture,
+                error: capture,
+                debug: capture,
+            };
+            const AsyncFunction = Object.getPrototypeOf(async () => { }).constructor;
+            try {
+                const fn = new AsyncFunction("console", code);
+                await fn(fakeConsole);
+                const result = output.join("\n").trim();
+                return result || "Code ran successfully (no output)";
+            }
+            catch (err) {
+                return { error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    };
+}
+// ─── vector_search ─────────────────────────────────────────────────────────
+const vectorSearchParams = z.object({
+    query: z
+        .string()
+        .describe("Short keyword query to search the knowledge base. Use specific topic " +
+        "terms, not full sentences. Do NOT include the company or product name " +
+        "since all documents are from the same source. For example, if the user " +
+        'asks "how much does Acme cost", search for "pricing plans rates".'),
+    topK: z.number().describe("Maximum results to return (default: 5)").optional(),
+});
+function createVectorSearch(vectorSearchFn) {
+    return {
+        description: "Search the agent's knowledge base for relevant information. Use this when the user asks a question that might be answered by previously ingested documents or data. Returns the most relevant matches ranked by similarity.",
+        parameters: vectorSearchParams,
+        async execute(args) {
+            const { query, topK = 5 } = args;
+            return vectorSearchFn(query, topK);
+        },
+    };
+}
+/**
+ * Create built-in tool definitions for the given tool names.
+ *
+ * @param names - Built-in tool names from the agent config.
+ * @param opts - Options including RPC callbacks for host-proxied tools.
+ * @returns A record of tool name → ToolDef.
+ */
+export function getBuiltinToolDefs(names, opts) {
+    const defs = {};
+    for (const name of names) {
+        switch (name) {
+            case "web_search":
+                defs[name] = createWebSearch();
+                break;
+            case "visit_webpage":
+                defs[name] = createVisitWebpage();
+                break;
+            case "fetch_json":
+                defs[name] = createFetchJson();
+                break;
+            case "run_code":
+                defs[name] = createRunCode();
+                break;
+            case "vector_search":
+                if (opts?.vectorSearch) {
+                    defs[name] = createVectorSearch(opts.vectorSearch);
+                }
+                break;
+        }
+    }
+    return defs;
+}
+/** All available tool creators, keyed by builtin tool name. */
+const TOOL_CREATORS = {
+    web_search: createWebSearch,
+    visit_webpage: createVisitWebpage,
+    fetch_json: createFetchJson,
+    run_code: createRunCode,
+    // vector_search uses a stub for schema generation
+    vector_search: () => createVectorSearch(async () => ""),
+};
+/**
+ * Returns JSON tool schemas for the specified builtin tools.
+ *
+ * Used by both the worker (to report schemas) and the server (to
+ * assemble tool lists for the LLM).
+ */
+export function getBuiltinToolSchemas(names) {
+    return names.flatMap((name) => {
+        const creator = TOOL_CREATORS[name];
+        if (!creator)
+            return [];
+        const def = creator();
+        return [
+            {
+                name,
+                description: def.description,
+                parameters: z.toJSONSchema(def.parameters ?? EMPTY_PARAMS),
+            },
+        ];
+    });
+}
+//# sourceMappingURL=builtin_tools.js.map

package/dist/sdk/builtin_tools.js.map

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

package/dist/sdk/capnweb.d.ts

@@ -0,0 +1,69 @@
+/**
+ * MessagePort RPC + WebSocket bridge for capnweb sandbox communication.
+ *
+ * Provides bidirectional RPC over MessagePort/Worker and WebSocket
+ * bridging for both standard WebSocket (client connections) and
+ * S2sWebSocket (.on()-style API for S2S connections).
+ *
+ * @module
+ */
+import type { S2sWebSocket } from "./s2s.ts";
+/** Minimal port interface for CapnwebEndpoint. Works with Worker, MessagePort, or worker self. */
+export type CapnwebPort = {
+    postMessage(msg: unknown, transfer?: Transferable[]): void;
+    onmessage: ((ev: MessageEvent) => any) | null;
+};
+/** RPC handler function. Receives call arguments and any transferred ports. */
+export type RpcHandler = (args: unknown[], ports: readonly MessagePort[]) => unknown | Promise<unknown>;
+/**
+ * Bidirectional RPC endpoint over MessagePort or Worker.
+ *
+ * Both sides can send calls and handle incoming calls on the same channel.
+ *
+ * Wire protocol:
+ * - Call: `{$: 0, id: number, m: string, a: unknown[]}`
+ * - Result: `{$: 1, id: number, v?: unknown, e?: string}`
+ * - Notify (fire-and-forget): id = -1, no response sent
+ */
+export declare class CapnwebEndpoint {
+    private nextId;
+    private pending;
+    private handlers;
+    private port;
+    constructor(port: CapnwebPort);
+    /** Register an RPC handler for incoming calls with the given method name. */
+    handle(method: string, handler: RpcHandler): void;
+    /** Call a remote method and wait for the result. */
+    call(method: string, args: unknown[], transfer?: Transferable[]): Promise<unknown>;
+    /** Fire-and-forget: call a remote method without waiting for a response. */
+    notify(method: string, args: unknown[], transfer?: Transferable[]): void;
+    private send;
+    private onMessage;
+}
+/**
+ * Wraps a MessagePort as a standard WebSocket (extends EventTarget).
+ * Used in the worker for client connections bridged from the host.
+ */
+export declare class BridgedWebSocket extends EventTarget {
+    readyState: number;
+    private port;
+    constructor(port: MessagePort);
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+}
+/**
+ * Wraps a MessagePort as an {@linkcode S2sWebSocket} (.on() event API).
+ * Used in the worker for S2S connections bridged from the host.
+ */
+export declare function createBridgedS2sWebSocket(port: MessagePort): S2sWebSocket;
+/**
+ * Bridges a standard WebSocket (e.g. from `Deno.upgradeWebSocket`) to a
+ * MessagePort. Used on the host side for client connections.
+ */
+export declare function bridgeWebSocketToPort(ws: WebSocket, port: MessagePort): void;
+/**
+ * Bridges a ws-style {@linkcode S2sWebSocket} to a MessagePort.
+ * Used on the host side for S2S connections to AssemblyAI.
+ */
+export declare function bridgeS2sWebSocketToPort(ws: S2sWebSocket, port: MessagePort): void;
+//# sourceMappingURL=capnweb.d.ts.map

package/dist/sdk/capnweb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capnweb.d.ts","sourceRoot":"","sources":["../../sdk/capnweb.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,EAAE,SAAS,WAAW,EAAE,KAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,IAAI,CAAc;gBAEd,IAAI,EAAE,WAAW;IAK7B,6EAA6E;IAC7E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAIjD,oDAAoD;IACpD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAQlF,4EAA4E;IAC5E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI;IAIxE,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,SAAS;CAwClB;AAqBD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,UAAU,SAAK;IACf,OAAO,CAAC,IAAI,CAAc;gBAEd,IAAI,EAAE,WAAW;IAgC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI;IAanD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAK5C;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CA8CzE;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAyC5E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAkClF"}

package/dist/sdk/capnweb.js

@@ -0,0 +1,291 @@
+// Copyright 2025 the AAI authors. MIT license.
+/**
+ * MessagePort RPC + WebSocket bridge for capnweb sandbox communication.
+ *
+ * Provides bidirectional RPC over MessagePort/Worker and WebSocket
+ * bridging for both standard WebSocket (client connections) and
+ * S2sWebSocket (.on()-style API for S2S connections).
+ *
+ * @module
+ */
+/**
+ * Bidirectional RPC endpoint over MessagePort or Worker.
+ *
+ * Both sides can send calls and handle incoming calls on the same channel.
+ *
+ * Wire protocol:
+ * - Call: `{$: 0, id: number, m: string, a: unknown[]}`
+ * - Result: `{$: 1, id: number, v?: unknown, e?: string}`
+ * - Notify (fire-and-forget): id = -1, no response sent
+ */
+export class CapnwebEndpoint {
+    nextId = 1;
+    pending = new Map();
+    handlers = new Map();
+    port;
+    constructor(port) {
+        this.port = port;
+        port.onmessage = (ev) => this.onMessage(ev);
+    }
+    /** Register an RPC handler for incoming calls with the given method name. */
+    handle(method, handler) {
+        this.handlers.set(method, handler);
+    }
+    /** Call a remote method and wait for the result. */
+    call(method, args, transfer) {
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.send({ $: 0, id, m: method, a: args }, transfer);
+        });
+    }
+    /** Fire-and-forget: call a remote method without waiting for a response. */
+    notify(method, args, transfer) {
+        this.send({ $: 0, id: -1, m: method, a: args }, transfer);
+    }
+    send(msg, transfer) {
+        if (transfer && transfer.length > 0) {
+            this.port.postMessage(msg, transfer);
+        }
+        else {
+            this.port.postMessage(msg);
+        }
+    }
+    onMessage(ev) {
+        const msg = ev.data;
+        if (!msg || typeof msg !== "object" || !("$" in msg))
+            return;
+        if (msg.$ === 0) {
+            // Incoming call
+            const { id, m, a } = msg;
+            const handler = this.handlers.get(m);
+            if (!handler) {
+                if (id >= 0)
+                    this.send({ $: 1, id, e: `No handler for ${m}` });
+                return;
+            }
+            const ports = [...ev.ports];
+            Promise.resolve()
+                .then(() => handler(a, ports))
+                .then((v) => {
+                if (id >= 0)
+                    this.send({ $: 1, id, v });
+            })
+                .catch((err) => {
+                if (id >= 0) {
+                    this.send({
+                        $: 1,
+                        id,
+                        e: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            });
+        }
+        else if (msg.$ === 1) {
+            // Incoming result
+            const { id, v, e } = msg;
+            const pending = this.pending.get(id);
+            if (!pending)
+                return;
+            this.pending.delete(id);
+            if (e !== undefined) {
+                pending.reject(new Error(e));
+            }
+            else {
+                pending.resolve(v);
+            }
+        }
+    }
+}
+// ─── BridgedWebSocket (standard EventTarget-based) ───────────────────────────
+/**
+ * Wraps a MessagePort as a standard WebSocket (extends EventTarget).
+ * Used in the worker for client connections bridged from the host.
+ */
+export class BridgedWebSocket extends EventTarget {
+    readyState = 0;
+    port;
+    constructor(port) {
+        super();
+        this.port = port;
+        port.onmessage = (ev) => {
+            const msg = ev.data;
+            switch (msg.k) {
+                case 0:
+                    this.dispatchEvent(new MessageEvent("message", { data: msg.d }));
+                    break;
+                case 1:
+                    this.dispatchEvent(new MessageEvent("message", { data: msg.d }));
+                    break;
+                case 2:
+                    this.readyState = 3;
+                    this.dispatchEvent(new CloseEvent("close", {
+                        ...(msg.code !== undefined ? { code: msg.code } : {}),
+                        ...(msg.reason !== undefined ? { reason: msg.reason } : {}),
+                    }));
+                    break;
+                case 3:
+                    this.readyState = 1;
+                    this.dispatchEvent(new Event("open"));
+                    break;
+                case 4:
+                    this.dispatchEvent(new ErrorEvent("error", { message: msg.m }));
+                    break;
+            }
+        };
+    }
+    send(data) {
+        if (this.readyState !== 1)
+            return;
+        if (typeof data === "string") {
+            this.port.postMessage({ k: 0, d: data });
+        }
+        else {
+            const ab = data instanceof ArrayBuffer
+                ? data
+                : data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+            this.port.postMessage({ k: 1, d: ab }, [ab]);
+        }
+    }
+    close(code, reason) {
+        if (this.readyState >= 2)
+            return;
+        this.readyState = 2;
+        this.port.postMessage({ k: 2, code, reason });
+    }
+}
+// ─── BridgedS2sWebSocket (.on()-style API) ───────────────────────────────────
+/**
+ * Wraps a MessagePort as an {@linkcode S2sWebSocket} (.on() event API).
+ * Used in the worker for S2S connections bridged from the host.
+ */
+export function createBridgedS2sWebSocket(port) {
+    let readyState = 0;
+    const handlers = new Map();
+    function emit(event, ...args) {
+        for (const h of handlers.get(event) ?? [])
+            h(...args);
+    }
+    port.onmessage = (ev) => {
+        const msg = ev.data;
+        switch (msg.k) {
+            case 0:
+                emit("message", msg.d);
+                break;
+            case 2:
+                readyState = 3;
+                emit("close", msg.code, msg.reason);
+                break;
+            case 3:
+                readyState = 1;
+                emit("open");
+                break;
+            case 4:
+                emit("error", new Error(msg.m));
+                break;
+        }
+    };
+    return {
+        get readyState() {
+            return readyState;
+        },
+        send(data) {
+            if (readyState !== 1)
+                return;
+            port.postMessage({ k: 0, d: data });
+        },
+        close() {
+            if (readyState >= 2)
+                return;
+            readyState = 2;
+            port.postMessage({ k: 2 });
+        },
+        on(event, handler) {
+            if (!handlers.has(event))
+                handlers.set(event, []);
+            handlers.get(event).push(handler);
+        },
+    };
+}
+// ─── Host-side bridges ───────────────────────────────────────────────────────
+/**
+ * Bridges a standard WebSocket (e.g. from `Deno.upgradeWebSocket`) to a
+ * MessagePort. Used on the host side for client connections.
+ */
+export function bridgeWebSocketToPort(ws, port) {
+    ws.binaryType = "arraybuffer";
+    ws.addEventListener("open", () => {
+        port.postMessage({ k: 3 });
+    });
+    ws.addEventListener("message", (ev) => {
+        const { data } = ev;
+        if (typeof data === "string") {
+            port.postMessage({ k: 0, d: data });
+        }
+        else if (data instanceof ArrayBuffer) {
+            port.postMessage({ k: 1, d: data }, [data]);
+        }
+    });
+    ws.addEventListener("close", (ev) => {
+        const e = ev;
+        port.postMessage({ k: 2, code: e.code, reason: e.reason });
+    });
+    ws.addEventListener("error", (ev) => {
+        const msg = ev instanceof ErrorEvent ? ev.message : "WebSocket error";
+        port.postMessage({ k: 4, m: msg });
+    });
+    // Messages from worker → real WebSocket
+    port.onmessage = (ev) => {
+        const msg = ev.data;
+        switch (msg.k) {
+            case 0:
+                if (ws.readyState === 1)
+                    ws.send(msg.d);
+                break;
+            case 1:
+                if (ws.readyState === 1)
+                    ws.send(msg.d);
+                break;
+            case 2:
+                ws.close(msg.code, msg.reason);
+                break;
+        }
+    };
+}
+/**
+ * Bridges a ws-style {@linkcode S2sWebSocket} to a MessagePort.
+ * Used on the host side for S2S connections to AssemblyAI.
+ */
+export function bridgeS2sWebSocketToPort(ws, port) {
+    ws.on("open", () => {
+        port.postMessage({ k: 3 });
+    });
+    ws.on("message", (data) => {
+        port.postMessage({ k: 0, d: String(data) });
+    });
+    ws.on("close", (code, reason) => {
+        port.postMessage({
+            k: 2,
+            code: typeof code === "number" ? code : undefined,
+            reason: String(reason ?? ""),
+        });
+    });
+    ws.on("error", (err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        port.postMessage({ k: 4, m: msg });
+    });
+    // Messages from worker → real S2S WebSocket
+    port.onmessage = (ev) => {
+        const msg = ev.data;
+        switch (msg.k) {
+            case 0:
+                if (ws.readyState === 1)
+                    ws.send(msg.d);
+                break;
+            case 2:
+                ws.close();
+                break;
+        }
+    };
+}
+//# sourceMappingURL=capnweb.js.map

package/dist/sdk/capnweb.js.map

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