@alexkroman1/aai 0.4.0 → 0.6.0

package/dist/sdk/_internal_types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Internal type definitions shared by server and CLI.
+ *
+ * Note: this module is for internal use only and should not be used directly.
+ *
+ * @module
+ */
+import type { JSONSchema7 } from "json-schema";
+import type { BuiltinTool, ToolChoice, ToolDef, Transport } from "./types.ts";
+/**
+ * Serializable agent configuration sent over the wire.
+ *
+ * This is the JSON-safe subset of the agent definition that can be
+ * transmitted between the worker and the host process via structured clone.
+ */
+export type AgentConfig = {
+    name: string;
+    instructions: string;
+    greeting: string;
+    voice: string;
+    mode?: "s2s" | undefined;
+    sttPrompt?: string | undefined;
+    maxSteps?: number | undefined;
+    toolChoice?: ToolChoice | undefined;
+    transport?: readonly Transport[] | undefined;
+    builtinTools?: readonly BuiltinTool[] | undefined;
+    /** Default set of active tools. Can be overridden per-turn via `onBeforeStep`. */
+    activeTools?: readonly string[] | undefined;
+};
+/**
+ * Serialized tool schema sent over the wire.
+ * `parameters` must be a valid JSON Schema object (with `type`, `properties`,
+ * etc.) — the Vercel AI SDK wraps it via `jsonSchema()`.
+ */
+export type ToolSchema = {
+    name: string;
+    description: string;
+    parameters: JSONSchema7;
+};
+/**
+ * Request body for the deploy endpoint.
+ *
+ * Sent by the CLI to the server when deploying a bundled agent.
+ */
+export type DeployBody = {
+    /** Env vars are optional at deploy time — set separately via `aai env add`. */
+    env?: Readonly<Record<string, string>> | undefined;
+    worker: string;
+    html: string;
+    transport?: readonly Transport[] | undefined;
+    /** Agent configuration extracted at build time. */
+    config: AgentConfig;
+    /** Tool schemas extracted at build time. */
+    toolSchemas: ToolSchema[];
+};
+/** Environment variables required by the agent runtime. */
+export type AgentEnv = {
+    ASSEMBLYAI_API_KEY: string;
+    [key: string]: string | undefined;
+};
+/** Configuration + tool schemas bundle returned by the worker's getConfig RPC. */
+export type WorkerConfig = {
+    config: AgentConfig;
+    toolSchemas: ToolSchema[];
+};
+/**
+ * Convert agent tool definitions to JSON Schema format for wire transport.
+ *
+ * Transforms the Zod-based `parameters` of each tool into a plain JSON Schema
+ * object suitable for structured clone / JSON serialization.
+ */
+export declare function agentToolsToSchemas(tools: Readonly<Record<string, ToolDef>>): ToolSchema[];
+//# sourceMappingURL=_internal_types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_internal_types.d.ts","sourceRoot":"","sources":["../../sdk/_internal_types.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAC;IAC7C,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,CAAC;IAClD,kFAAkF;IAClF,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,WAAW,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAC;IAC7C,mDAAmD;IACnD,MAAM,EAAE,WAAW,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,UAAU,EAAE,CAM1F"}

package/dist/sdk/_internal_types.js

@@ -0,0 +1,24 @@
+// Copyright 2025 the AAI authors. MIT license.
+/**
+ * Internal type definitions shared by server and CLI.
+ *
+ * Note: this module is for internal use only and should not be used directly.
+ *
+ * @module
+ */
+import { z } from "zod";
+const EMPTY_PARAMS = z.object({});
+/**
+ * Convert agent tool definitions to JSON Schema format for wire transport.
+ *
+ * Transforms the Zod-based `parameters` of each tool into a plain JSON Schema
+ * object suitable for structured clone / JSON serialization.
+ */
+export function agentToolsToSchemas(tools) {
+    return Object.entries(tools).map(([name, def]) => ({
+        name,
+        description: def.description,
+        parameters: z.toJSONSchema(def.parameters ?? EMPTY_PARAMS),
+    }));
+}
+//# sourceMappingURL=_internal_types.js.map

package/dist/sdk/_internal_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_internal_types.js","sourceRoot":"","sources":["../../sdk/_internal_types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgExB,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAwC;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI;QACJ,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,IAAI,YAAY,CAAgB;KAC1E,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/sdk/_mock_ws.d.ts

@@ -0,0 +1,105 @@
+/**
+ * A mock WebSocket implementation for testing.
+ *
+ * Extends `EventTarget` to simulate WebSocket behavior without a real
+ * network connection. Records all sent messages in the {@linkcode sent}
+ * array and provides helper methods to simulate incoming messages,
+ * connection events, and errors.
+ *
+ * @example
+ * ```ts
+ * const ws = new MockWebSocket("wss://example.com");
+ * ws.send(JSON.stringify({ type: "ping" }));
+ * ws.simulateMessage(JSON.stringify({ type: "pong" }));
+ * assertEquals(ws.sentJson(), [{ type: "ping" }]);
+ * ```
+ */
+export declare class MockWebSocket extends EventTarget {
+    static readonly CONNECTING = 0;
+    static readonly OPEN = 1;
+    static readonly CLOSING = 2;
+    static readonly CLOSED = 3;
+    readyState: number;
+    binaryType: string;
+    /** All messages passed to {@linkcode send}, in order. */
+    sent: (string | ArrayBuffer | Uint8Array)[];
+    url: string;
+    /**
+     * Create a new MockWebSocket.
+     *
+     * Automatically transitions to `OPEN` state on the next microtask,
+     * dispatching an `"open"` event.
+     *
+     * @param url - The WebSocket URL.
+     * @param _protocols - Ignored; accepted for API compatibility.
+     */
+    constructor(url: string | URL, _protocols?: string | string[] | Record<string, unknown>);
+    /**
+     * Record a sent message without transmitting it.
+     *
+     * @param data - The message data to record.
+     */
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    /**
+     * Transition to `CLOSED` state and dispatch a `"close"` event.
+     *
+     * @param code - The close code (defaults to 1000).
+     * @param _reason - Ignored; accepted for API compatibility.
+     */
+    close(code?: number, _reason?: string): void;
+    /**
+     * Simulate receiving a message from the server.
+     *
+     * @param data - The message data (string or binary).
+     */
+    simulateMessage(data: string | ArrayBuffer): void;
+    /** Transition to `OPEN` state and dispatch an `"open"` event. */
+    open(): void;
+    /**
+     * Shorthand for {@linkcode simulateMessage}.
+     *
+     * @param data - The message data to dispatch.
+     */
+    msg(data: string | ArrayBuffer): void;
+    /**
+     * Simulate a connection close from the server.
+     *
+     * @param code - The close code (defaults to 1000).
+     */
+    disconnect(code?: number): void;
+    /** Dispatch an `"error"` event on this socket. */
+    error(): void;
+    /**
+     * Return all sent string messages parsed as JSON objects.
+     *
+     * Binary messages are filtered out.
+     *
+     * @returns An array of parsed JSON objects from sent string messages.
+     */
+    sentJson(): Record<string, unknown>[];
+}
+/**
+ * Replace `globalThis.WebSocket` with {@linkcode MockWebSocket} for testing.
+ *
+ * Returns a handle that tracks all created mock sockets and can restore the
+ * original `WebSocket` constructor. Supports the `using` declaration via
+ * `Symbol.dispose` for automatic cleanup.
+ *
+ * @returns An object with `created` array, `lastWs` getter, `restore()`, and `[Symbol.dispose]()`.
+ *
+ * @example
+ * ```ts
+ * using mock = installMockWebSocket();
+ * const session = new Session("wss://example.com");
+ * const ws = mock.lastWs!;
+ * ws.simulateMessage(JSON.stringify({ type: "ready" }));
+ * // mock automatically restores WebSocket when disposed
+ * ```
+ */
+export declare function installMockWebSocket(): {
+    restore: () => void;
+    created: MockWebSocket[];
+    get lastWs(): MockWebSocket | null;
+    [Symbol.dispose]: () => void;
+};
+//# sourceMappingURL=_mock_ws.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_mock_ws.d.ts","sourceRoot":"","sources":["../../sdk/_mock_ws.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAU,KAAK;IAE/B,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK;IAEzB,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK;IAE5B,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK;IAE3B,UAAU,SAA4B;IACtC,UAAU,SAAiB;IAC3B,yDAAyD;IACzD,IAAI,EAAE,CAAC,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,EAAE,CAAM;IACjD,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;;;OAQG;gBACS,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWvF;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU;IAI5C;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKrC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAI1C,iEAAiE;IACjE,IAAI;IAKJ;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAI9B;;;;OAIG;IACH,UAAU,CAAC,IAAI,SAAO;IAItB,kDAAkD;IAClD,KAAK;IAIL;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAGtC;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,IAAI,MAAM,IAAI,aAAa,GAAG,IAAI,CAAC;IACnC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B,CAuBA"}

package/dist/sdk/_mock_ws.js

@@ -0,0 +1,154 @@
+// Copyright 2025 the AAI authors. MIT license.
+/**
+ * A mock WebSocket implementation for testing.
+ *
+ * Extends `EventTarget` to simulate WebSocket behavior without a real
+ * network connection. Records all sent messages in the {@linkcode sent}
+ * array and provides helper methods to simulate incoming messages,
+ * connection events, and errors.
+ *
+ * @example
+ * ```ts
+ * const ws = new MockWebSocket("wss://example.com");
+ * ws.send(JSON.stringify({ type: "ping" }));
+ * ws.simulateMessage(JSON.stringify({ type: "pong" }));
+ * assertEquals(ws.sentJson(), [{ type: "ping" }]);
+ * ```
+ */
+export class MockWebSocket extends EventTarget {
+    // mirrors the WebSocket API
+    static CONNECTING = 0;
+    // mirrors the WebSocket API
+    static OPEN = 1;
+    // mirrors the WebSocket API
+    static CLOSING = 2;
+    // mirrors the WebSocket API
+    static CLOSED = 3;
+    readyState = MockWebSocket.CONNECTING;
+    binaryType = "arraybuffer";
+    /** All messages passed to {@linkcode send}, in order. */
+    sent = [];
+    url;
+    /**
+     * Create a new MockWebSocket.
+     *
+     * Automatically transitions to `OPEN` state on the next microtask,
+     * dispatching an `"open"` event.
+     *
+     * @param url - The WebSocket URL.
+     * @param _protocols - Ignored; accepted for API compatibility.
+     */
+    constructor(url, _protocols) {
+        super();
+        this.url = typeof url === "string" ? url : url.toString();
+        queueMicrotask(() => {
+            if (this.readyState === MockWebSocket.CONNECTING) {
+                this.readyState = MockWebSocket.OPEN;
+                this.dispatchEvent(new Event("open"));
+            }
+        });
+    }
+    /**
+     * Record a sent message without transmitting it.
+     *
+     * @param data - The message data to record.
+     */
+    send(data) {
+        this.sent.push(data);
+    }
+    /**
+     * Transition to `CLOSED` state and dispatch a `"close"` event.
+     *
+     * @param code - The close code (defaults to 1000).
+     * @param _reason - Ignored; accepted for API compatibility.
+     */
+    close(code, _reason) {
+        this.readyState = MockWebSocket.CLOSED;
+        this.dispatchEvent(new CloseEvent("close", { code: code ?? 1000 }));
+    }
+    /**
+     * Simulate receiving a message from the server.
+     *
+     * @param data - The message data (string or binary).
+     */
+    simulateMessage(data) {
+        this.dispatchEvent(new MessageEvent("message", { data }));
+    }
+    /** Transition to `OPEN` state and dispatch an `"open"` event. */
+    open() {
+        this.readyState = MockWebSocket.OPEN;
+        this.dispatchEvent(new Event("open"));
+    }
+    /**
+     * Shorthand for {@linkcode simulateMessage}.
+     *
+     * @param data - The message data to dispatch.
+     */
+    msg(data) {
+        this.dispatchEvent(new MessageEvent("message", { data }));
+    }
+    /**
+     * Simulate a connection close from the server.
+     *
+     * @param code - The close code (defaults to 1000).
+     */
+    disconnect(code = 1000) {
+        this.dispatchEvent(new CloseEvent("close", { code }));
+    }
+    /** Dispatch an `"error"` event on this socket. */
+    error() {
+        this.dispatchEvent(new Event("error"));
+    }
+    /**
+     * Return all sent string messages parsed as JSON objects.
+     *
+     * Binary messages are filtered out.
+     *
+     * @returns An array of parsed JSON objects from sent string messages.
+     */
+    sentJson() {
+        return this.sent.filter((d) => typeof d === "string").map((s) => JSON.parse(s));
+    }
+}
+const g = globalThis;
+/**
+ * Replace `globalThis.WebSocket` with {@linkcode MockWebSocket} for testing.
+ *
+ * Returns a handle that tracks all created mock sockets and can restore the
+ * original `WebSocket` constructor. Supports the `using` declaration via
+ * `Symbol.dispose` for automatic cleanup.
+ *
+ * @returns An object with `created` array, `lastWs` getter, `restore()`, and `[Symbol.dispose]()`.
+ *
+ * @example
+ * ```ts
+ * using mock = installMockWebSocket();
+ * const session = new Session("wss://example.com");
+ * const ws = mock.lastWs!;
+ * ws.simulateMessage(JSON.stringify({ type: "ready" }));
+ * // mock automatically restores WebSocket when disposed
+ * ```
+ */
+export function installMockWebSocket() {
+    const saved = globalThis.WebSocket;
+    const created = [];
+    g.WebSocket = class extends MockWebSocket {
+        constructor(url, protocols) {
+            super(url, protocols);
+            created.push(this);
+        }
+    };
+    return {
+        created,
+        get lastWs() {
+            return created.length > 0 ? created[created.length - 1] : null;
+        },
+        restore() {
+            globalThis.WebSocket = saved;
+        },
+        [Symbol.dispose]() {
+            globalThis.WebSocket = saved;
+        },
+    };
+}
+//# sourceMappingURL=_mock_ws.js.map

package/dist/sdk/_mock_ws.js.map

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

package/dist/sdk/_timeout.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Timeout wrapper for promises, used by both worker-side and host-side RPC.
+ *
+ * @module
+ */
+/**
+ * Wrap a promise with a timeout. Rejects with `Error` if the promise
+ * does not settle within `timeoutMs` milliseconds.
+ *
+ * If `timeoutMs` is `undefined` or `0`, the original promise is returned
+ * unchanged.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs?: number): Promise<T>;
+//# sourceMappingURL=_timeout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_timeout.d.ts","sourceRoot":"","sources":["../../sdk/_timeout.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAIH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAOlF"}

package/{sdk/_timeout.ts → dist/sdk/_timeout.js}

@@ -4,9 +4,7 @@
  *
  * @module
  */
-
 import pTimeout from "p-timeout";
-
 /**
  * Wrap a promise with a timeout. Rejects with `Error` if the promise
  * does not settle within `timeoutMs` milliseconds.
@@ -14,11 +12,13 @@ import pTimeout from "p-timeout";
  * If `timeoutMs` is `undefined` or `0`, the original promise is returned
  * unchanged.
  */
-export function withTimeout<T>(promise: Promise<T>, timeoutMs?: number): Promise<T> {
-  const normalized = Promise.resolve(promise);
-  if (!timeoutMs) return normalized;
-  return pTimeout(normalized, {
-    milliseconds: timeoutMs,
-    message: `RPC timed out after ${timeoutMs}ms`,
-  });
+export function withTimeout(promise, timeoutMs) {
+    const normalized = Promise.resolve(promise);
+    if (!timeoutMs)
+        return normalized;
+    return pTimeout(normalized, {
+        milliseconds: timeoutMs,
+        message: `RPC timed out after ${timeoutMs}ms`,
+    });
 }
+//# sourceMappingURL=_timeout.js.map

package/dist/sdk/_timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_timeout.js","sourceRoot":"","sources":["../../sdk/_timeout.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAI,OAAmB,EAAE,SAAkB;IACpE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,SAAS;QAAE,OAAO,UAAU,CAAC;IAClC,OAAO,QAAQ,CAAC,UAAU,EAAE;QAC1B,YAAY,EAAE,SAAS;QACvB,OAAO,EAAE,uBAAuB,SAAS,IAAI;KAC9C,CAAC,CAAC;AACL,CAAC"}

package/dist/sdk/builtin_tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 type { ToolSchema } from "./_internal_types.ts";
+import type { ToolDef } from "./types.ts";
+/** Callback for proxying vector search through the host RPC. */
+export type VectorSearchFn = (query: string, topK: number) => Promise<string>;
+/** Options for creating built-in tool definitions. */
+export type BuiltinToolOptions = {
+    /** RPC callback for vector_search (proxied through host). */
+    vectorSearch?: VectorSearchFn;
+};
+/**
+ * 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 declare function getBuiltinToolDefs(names: readonly string[], opts?: BuiltinToolOptions): Record<string, ToolDef>;
+/**
+ * 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 declare function getBuiltinToolSchemas(names: readonly string[]): ToolSchema[];
+//# sourceMappingURL=builtin_tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtin_tools.d.ts","sourceRoot":"","sources":["../../sdk/builtin_tools.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAgN1C,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAgB9E,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,CAAC,EAAE,kBAAkB,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAYD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,EAAE,CAa5E"}