@alexkroman1/aai 0.8.8 → 0.9.0

package/dist/sdk/host.d.ts

@@ -1,59 +0,0 @@
-/**
- * Host-side helpers for managing sandboxed workers.
- *
- * Provides `createHostEndpoint` factory that registers all standard
- * host→worker RPC methods for server implementations.
- *
- * @module
- */
-import { type BridgeableWebSocket, type WorkerPort } from "./capnweb.ts";
-import type { Kv } from "./kv.ts";
-import type { VectorStore } from "./vector.ts";
-/** Serialized fetch response for RPC transport. */
-export type FetchResult = {
-    status: number;
-    headers: Record<string, string>;
-    body: string;
-};
-/** Fetch function signature for host→worker RPC. */
-export type HostFetchFn = (url: string, method: string, headers: Record<string, string>, body?: string) => Promise<FetchResult>;
-/** Kv with optional key-listing support. */
-export type KvWithKeys = Kv & {
-    keys?(pattern?: string): Promise<string[]>;
-};
-/**
- * Execute an HTTP fetch on behalf of the sandboxed worker.
- *
- * Default implementation for the host fetch RPC — performs the fetch
- * and returns a serialized response. Servers can wrap this to add SSRF
- * checks or other guards.
- */
-export declare function defaultHostFetch(url: string, method: string, headers: Record<string, string>, body?: string): Promise<FetchResult>;
-/** Options for {@linkcode createHostEndpoint}. */
-export type HostEndpointOptions = {
-    /** Environment variables passed to the worker on init. */
-    env: Record<string, string>;
-    /** KV store operations. */
-    kv: KvWithKeys;
-    /** Vector store operations. Omit if not configured. */
-    vector?: VectorStore | undefined;
-    /** Fetch handler. Use {@linkcode defaultHostFetch} as the base. */
-    fetch: HostFetchFn;
-    /** Called when the worker requests an S2S WebSocket connection. */
-    createWebSocket(url: string, headers: Record<string, string>, port: MessagePort): void;
-};
-/** A host-side sandbox created by {@linkcode createHostEndpoint}. */
-export type HostSandbox = {
-    /** Bridge a WebSocket to a new worker session. */
-    startSession(socket: BridgeableWebSocket, skipGreeting?: boolean): void;
-    /** Forward an HTTP request to the worker. */
-    fetch(request: Request): Promise<Response>;
-};
-/**
- * Create a host endpoint for a sandboxed worker.
- *
- * Sets up capnweb RPC with a {@linkcode HostService}, initializes the worker,
- * and returns a {@linkcode HostSandbox} with `startSession` and `fetch`.
- */
-export declare function createHostEndpoint(port: WorkerPort, opts: HostEndpointOptions): Promise<HostSandbox>;
-//# sourceMappingURL=host.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../sdk/host.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,mBAAmB,EAMxB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,EAAE,EAAiB,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB/C,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,KACV,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,EAAE,GAAG;IAAE,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAOtB;AAuED,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG;IAChC,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,2BAA2B;IAC3B,EAAE,EAAE,UAAU,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,mEAAmE;IACnE,KAAK,EAAE,WAAW,CAAC;IACnB,mEAAmE;IACnE,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CACxF,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG;IACxB,kDAAkD;IAClD,YAAY,CAAC,MAAM,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxE,6CAA6C;IAC7C,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,WAAW,CAAC,CA2CtB"}

package/dist/sdk/host.js

@@ -1,131 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/**
- * Host-side helpers for managing sandboxed workers.
- *
- * Provides `createHostEndpoint` factory that registers all standard
- * host→worker RPC methods for server implementations.
- *
- * @module
- */
-import { bridgeWebSocketToPort, createRpcSession, isTransferMessage, RpcTarget, sendTransfer, } from "./capnweb.js";
-// ─── Audio validation (applied at the host transport layer) ─────────────────
-/** Max size for a single audio chunk from the browser (1 MB). */
-const MAX_AUDIO_CHUNK_BYTES = 1_048_576;
-/** Validate a PCM16 audio chunk: non-empty, within size bounds, even byte length. */
-function isValidAudioChunk(data) {
-    return (data.byteLength > 0 && data.byteLength <= MAX_AUDIO_CHUNK_BYTES && data.byteLength % 2 === 0);
-}
-/**
- * Execute an HTTP fetch on behalf of the sandboxed worker.
- *
- * Default implementation for the host fetch RPC — performs the fetch
- * and returns a serialized response. Servers can wrap this to add SSRF
- * checks or other guards.
- */
-export async function defaultHostFetch(url, method, headers, body) {
-    const response = await fetch(new Request(url, { method, headers, ...(body ? { body } : {}) }));
-    return {
-        status: response.status,
-        headers: Object.fromEntries(response.headers),
-        body: await response.text(),
-    };
-}
-// ─── Host RPC service ────────────────────────────────────────────────────────
-/** Convert a void promise to null (capnweb RPC requires a return value). */
-async function voidToNull(p) {
-    await p;
-    return null;
-}
-/**
- * RPC service exposed by the host to the sandboxed worker.
- * Methods are callable via capnweb RPC stubs.
- */
-class HostService extends RpcTarget {
-    #kv;
-    #vec;
-    #fetchFn;
-    constructor(kv, vec, fetchFn) {
-        super();
-        this.#kv = kv;
-        this.#vec = vec;
-        this.#fetchFn = fetchFn;
-    }
-    hostFetch(url, method, headers, body) {
-        return this.#fetchFn(url, method, headers, body);
-    }
-    kvGet(key) {
-        return this.#kv.get(key);
-    }
-    kvSet(key, value, options) {
-        return voidToNull(this.#kv.set(key, value, options));
-    }
-    kvDel(key) {
-        return voidToNull(this.#kv.delete(key));
-    }
-    kvList(prefix, options) {
-        return this.#kv.list(prefix, options);
-    }
-    kvKeys(pattern) {
-        if (!this.#kv.keys)
-            throw new Error("keys op not supported");
-        return this.#kv.keys(pattern);
-    }
-    #requireVec() {
-        if (!this.#vec)
-            throw new Error("Vector store not configured");
-        return this.#vec;
-    }
-    vecUpsert(id, data, metadata) {
-        return voidToNull(this.#requireVec().upsert(id, data, metadata));
-    }
-    vecQuery(text, options) {
-        return this.#requireVec().query(text, options);
-    }
-    vecRemove(ids) {
-        return voidToNull(this.#requireVec().remove(ids));
-    }
-}
-/**
- * Create a host endpoint for a sandboxed worker.
- *
- * Sets up capnweb RPC with a {@linkcode HostService}, initializes the worker,
- * and returns a {@linkcode HostSandbox} with `startSession` and `fetch`.
- */
-export async function createHostEndpoint(port, opts) {
-    const hostService = new HostService(opts.kv, opts.vector, opts.fetch);
-    const workerStub = createRpcSession({
-        port,
-        localMain: hostService,
-        onTransfer(data, ports) {
-            if (!isTransferMessage(data))
-                return;
-            if (data._t === "createWs") {
-                const transferPort = ports[0];
-                if (!transferPort)
-                    throw new Error("No port transferred for WebSocket");
-                const headers = JSON.parse(data.headers);
-                opts.createWebSocket(data.url, headers, transferPort);
-            }
-        },
-    });
-    // Initialize the worker
-    await workerStub.init(opts.env);
-    return {
-        startSession(socket, skipGreeting) {
-            const { port1, port2 } = new MessageChannel();
-            bridgeWebSocketToPort(socket, port1, {
-                filterBinary: isValidAudioChunk,
-            });
-            sendTransfer(port, { _t: "handleWs", skipGreeting: skipGreeting ?? false }, [port2]);
-        },
-        async fetch(request) {
-            const body = request.body ? await request.text() : undefined;
-            const result = await workerStub.workerFetch(request.url, request.method, Object.fromEntries(request.headers), body);
-            return new Response(result.body, {
-                status: result.status,
-                headers: result.headers,
-            });
-        },
-    };
-}
-//# sourceMappingURL=host.js.map

package/dist/sdk/host.js.map

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../sdk/kv.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,IAAI;IACjC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,EAAE,GAAG;IACf;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjD;;;;;;;;;OASG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CACnF,CAAC;AAEF,eAAO,MAAM,cAAc,QAAS,CAAC;AAErC,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACvD,OAAO,EAAE,CAAC,EAAE,EACZ,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,CAAC,EAAE,CAOL;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,IAAI,EAAE,CAqDnC"}

package/dist/sdk/kv.js

@@ -1,94 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/**
- * Key-value storage interface and in-memory implementation.
- *
- * @module
- */
-export const MAX_VALUE_SIZE = 65_536;
-/** Sort entries by key and apply reverse/limit options. Mutates the array. */
-export function sortAndPaginate(entries, options) {
-    entries.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
-    if (options?.reverse)
-        entries.reverse();
-    if (options?.limit && options.limit > 0) {
-        entries.length = Math.min(entries.length, options.limit);
-    }
-    return entries;
-}
-/**
- * Create an in-memory KV store (useful for testing and local development).
- *
- * Data is stored in a plain `Map` and does not persist across restarts.
- * TTL expiration is checked lazily on reads and list operations.
- *
- * @returns A {@linkcode Kv} instance backed by in-memory storage.
- *
- * @example
- * ```ts
- * import { createMemoryKv } from "./kv.ts";
- *
- * const kv = createMemoryKv();
- * await kv.set("greeting", "hello");
- * const value = await kv.get<string>("greeting"); // "hello"
- * ```
- *
- * @example With TTL
- * ```ts
- * import { createMemoryKv } from "./kv.ts";
- *
- * const kv = createMemoryKv();
- * await kv.set("temp", "expires soon", { expireIn: 5000 });
- * ```
- */
-export function createMemoryKv() {
-    const store = new Map();
-    function isExpired(entry) {
-        return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();
-    }
-    return {
-        get(key) {
-            const entry = store.get(key);
-            if (!entry || isExpired(entry)) {
-                if (entry)
-                    store.delete(key);
-                return Promise.resolve(null);
-            }
-            return Promise.resolve(JSON.parse(entry.raw));
-        },
-        set(key, value, options) {
-            const raw = JSON.stringify(value);
-            if (raw.length > MAX_VALUE_SIZE) {
-                throw new Error(`Value exceeds max size of ${MAX_VALUE_SIZE} bytes`);
-            }
-            const expireIn = options?.expireIn;
-            const entry = { raw };
-            if (expireIn && expireIn > 0) {
-                entry.expiresAt = Date.now() + expireIn;
-            }
-            store.set(key, entry);
-            return Promise.resolve();
-        },
-        delete(key) {
-            store.delete(key);
-            return Promise.resolve();
-        },
-        async list(prefix, options) {
-            const now = Date.now();
-            const entries = [];
-            let i = 0;
-            for (const [key, entry] of store) {
-                if (++i % 500 === 0)
-                    await new Promise((r) => setTimeout(r, 0));
-                if (entry.expiresAt && entry.expiresAt <= now) {
-                    store.delete(key);
-                    continue;
-                }
-                if (key.startsWith(prefix)) {
-                    entries.push({ key, value: JSON.parse(entry.raw) });
-                }
-            }
-            return sortAndPaginate(entries, options);
-        },
-    };
-}
-//# sourceMappingURL=kv.js.map

package/dist/sdk/kv.js.map

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

package/dist/sdk/memory_tools.d.ts

@@ -1,38 +0,0 @@
-import { z } from "zod";
-/**
- * Returns a standard set of KV-backed memory tools: `save_memory`,
- * `recall_memory`, `list_memories`, and `forget_memory`.
- *
- * Spread the result into your agent's `tools` record. Combine with
- * custom tools as needed.
- *
- * @example
- * ```ts
- * import { defineAgent } from "aai";
- * import { memoryTools } from "aai";
- *
- * export default defineAgent({
- *   name: "My Agent",
- *   tools: {
- *     ...memoryTools(),
- *     // other tools...
- *   },
- * });
- * ```
- */
-export declare function memoryTools(): {
-    save_memory: import("./types.ts").ToolDef<z.ZodObject<{
-        key: z.ZodString;
-        value: z.ZodString;
-    }, z.core.$strip>, any>;
-    recall_memory: import("./types.ts").ToolDef<z.ZodObject<{
-        key: z.ZodString;
-    }, z.core.$strip>, any>;
-    list_memories: import("./types.ts").ToolDef<z.ZodObject<{
-        prefix: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, any>;
-    forget_memory: import("./types.ts").ToolDef<z.ZodObject<{
-        key: z.ZodString;
-    }, z.core.$strip>, any>;
-};
-//# sourceMappingURL=memory_tools.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"memory_tools.d.ts","sourceRoot":"","sources":["../../sdk/memory_tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW;;;;;;;;;;;;;;EAmD1B"}

package/dist/sdk/memory_tools.js

@@ -1,77 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-import { z } from "zod";
-import { tool } from "./types.js";
-/**
- * Returns a standard set of KV-backed memory tools: `save_memory`,
- * `recall_memory`, `list_memories`, and `forget_memory`.
- *
- * Spread the result into your agent's `tools` record. Combine with
- * custom tools as needed.
- *
- * @example
- * ```ts
- * import { defineAgent } from "aai";
- * import { memoryTools } from "aai";
- *
- * export default defineAgent({
- *   name: "My Agent",
- *   tools: {
- *     ...memoryTools(),
- *     // other tools...
- *   },
- * });
- * ```
- */
-export function memoryTools() {
-    return {
-        save_memory: tool({
-            description: "Save a piece of information to persistent memory. Use a descriptive key like 'user:name' or 'project:status'.",
-            parameters: z.object({
-                key: z
-                    .string()
-                    .describe("A descriptive key for this memory (e.g. 'user:name', 'preference:color')"),
-                value: z.string().describe("The information to remember"),
-            }),
-            execute: async ({ key, value }, ctx) => {
-                await ctx.kv.set(key, value);
-                return { saved: key };
-            },
-        }),
-        recall_memory: tool({
-            description: "Retrieve a previously saved memory by its key.",
-            parameters: z.object({
-                key: z.string().describe("The key to look up"),
-            }),
-            execute: async ({ key }, ctx) => {
-                const value = await ctx.kv.get(key);
-                if (value === null)
-                    return { found: false, key };
-                return { found: true, key, value };
-            },
-        }),
-        list_memories: tool({
-            description: "List all saved memory keys, optionally filtered by a prefix (e.g. 'user:').",
-            parameters: z.object({
-                prefix: z
-                    .string()
-                    .describe("Prefix to filter keys (e.g. 'user:'). Use empty string for all.")
-                    .optional(),
-            }),
-            execute: async ({ prefix }, ctx) => {
-                const entries = await ctx.kv.list(prefix ?? "");
-                return { count: entries.length, keys: entries.map((e) => e.key) };
-            },
-        }),
-        forget_memory: tool({
-            description: "Delete a previously saved memory by its key.",
-            parameters: z.object({
-                key: z.string().describe("The key to delete"),
-            }),
-            execute: async ({ key }, ctx) => {
-                await ctx.kv.delete(key);
-                return { deleted: key };
-            },
-        }),
-    };
-}
-//# sourceMappingURL=memory_tools.js.map

package/dist/sdk/memory_tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory_tools.js","sourceRoot":"","sources":["../../sdk/memory_tools.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,WAAW,EAAE,IAAI,CAAC;YAChB,WAAW,EACT,+GAA+G;YACjH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,GAAG,EAAE,CAAC;qBACH,MAAM,EAAE;qBACR,QAAQ,CAAC,0EAA0E,CAAC;gBACvF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;aAC1D,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;gBACrC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACxB,CAAC;SACF,CAAC;QACF,aAAa,EAAE,IAAI,CAAC;YAClB,WAAW,EAAE,gDAAgD;YAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;aAC/C,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE;gBAC9B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACpC,IAAI,KAAK,KAAK,IAAI;oBAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;gBACjD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YACrC,CAAC;SACF,CAAC;QACF,aAAa,EAAE,IAAI,CAAC;YAClB,WAAW,EAAE,6EAA6E;YAC1F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC;qBACN,MAAM,EAAE;qBACR,QAAQ,CAAC,iEAAiE,CAAC;qBAC3E,QAAQ,EAAE;aACd,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE;gBACjC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBAChD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACpE,CAAC;SACF,CAAC;QACF,aAAa,EAAE,IAAI,CAAC;YAClB,WAAW,EAAE,8CAA8C;YAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;aAC9C,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE;gBAC9B,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;YAC1B,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../sdk/mod.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/sdk/mod.js

@@ -1,27 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/**
- * AAI SDK — build voice agents powered by STT, LLM, and TTS.
- *
- * @example
- * ```ts
- * import { defineAgent } from "aai";
- * import { z } from "zod";
- *
- * export default defineAgent({
- *   name: "my-agent",
- *   instructions: "You are a helpful voice assistant.",
- *   tools: {
- *     greet: {
- *       description: "Greet the user by name",
- *       parameters: z.object({ name: z.string() }),
- *       execute: ({ name }) => `Hello, ${name}!`,
- *     },
- *   },
- * });
- * ```
- *
- * @module
- */
-export { memoryTools } from "./builtin_tools.js";
-export { defineAgent, tool, } from "./types.js";
-//# sourceMappingURL=mod.js.map

package/dist/sdk/mod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../sdk/mod.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAIL,WAAW,EAMX,IAAI,GACL,MAAM,YAAY,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../sdk/protocol.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAE7C,sEAAsE;AACtE,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;yBAgB1B,CAAC;AAEH,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,gDAAgD;AAChD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;yBAiB9B,CAAC;AAEH,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,0EAA0E;AAC1E,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC,wDAAwD;AACxD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAIhD,0CAA0C;AAC1C,eAAO,MAAM,sBAAsB;;;;;;;;;EASjC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAWtE,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAsB5B,CAAC;AAEH,+DAA+D;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,yCAAyC;IACzC,aAAa,IAAI,IAAI,CAAC;CACvB;AAID,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,aAAa,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,aAAa,GACrB,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,WAAW,CAAC,GAClC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB,WAAW,CAAC;AAEhB,kDAAkD;AAClD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;2BAU9B,CAAC;AAEH,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC"}

package/dist/sdk/protocol.js

@@ -1,133 +0,0 @@
-// Copyright 2025 the AAI authors. MIT license.
-/**
- * WebSocket wire-format types shared by server and client.
- *
- * Note: this module is for internal use only and should not be used directly.
- *
- * @module
- */
-import { z } from "zod";
-/**
- * Default sample rate for speech-to-text audio in Hz.
- *
- * This is the sample rate expected by the STT provider (AssemblyAI).
- */
-export const DEFAULT_STT_SAMPLE_RATE = 16_000;
-/**
- * Default sample rate for text-to-speech audio in Hz.
- *
- * This is the sample rate produced by the TTS provider.
- */
-export const DEFAULT_TTS_SAMPLE_RATE = 24_000;
-/**
- * Audio codec identifier used in the wire protocol.
- *
- * All audio frames are 16-bit signed PCM, little-endian, mono.
- */
-export const AUDIO_FORMAT = "pcm16";
-/** Specification for binary audio frames exchanged over WebSocket. */
-export const AudioFrameSpec = {
-    format: AUDIO_FORMAT,
-    bitsPerSample: 16,
-    endianness: "little",
-    channels: 1,
-    bytesPerSample: 2,
-};
-/** Zod schema for KV operation requests from the worker to the host. */
-export const KvRequestSchema = z.discriminatedUnion("op", [
-    z.object({ op: z.literal("get"), key: z.string().min(1) }),
-    z.object({
-        op: z.literal("set"),
-        key: z.string().min(1),
-        value: z.string(),
-        ttl: z.number().int().positive().optional(),
-    }),
-    z.object({ op: z.literal("del"), key: z.string().min(1) }),
-    z.object({
-        op: z.literal("list"),
-        prefix: z.string(),
-        limit: z.number().int().positive().optional(),
-        reverse: z.boolean().optional(),
-    }),
-    z.object({ op: z.literal("keys"), pattern: z.string().optional() }),
-]);
-// ─── Vector request types ───────────────────────────────────────────────────
-/** Zod schema for vector operation requests. */
-export const VectorRequestSchema = z.discriminatedUnion("op", [
-    z.object({
-        op: z.literal("upsert"),
-        id: z.string().min(1),
-        data: z.string().min(1),
-        metadata: z.record(z.string(), z.unknown()).optional(),
-    }),
-    z.object({
-        op: z.literal("query"),
-        text: z.string().min(1),
-        topK: z.number().int().positive().max(100).optional(),
-        filter: z.string().optional(),
-    }),
-    z.object({
-        op: z.literal("remove"),
-        ids: z.array(z.string().min(1)).min(1),
-    }),
-]);
-// ─── Timeout constants ─────────────────────────────────────────────────────
-/** Default timeout for agent lifecycle hooks (onConnect, onTurn, etc). */
-export const HOOK_TIMEOUT_MS = 5_000;
-/** Default timeout for tool execution in the worker. */
-export const TOOL_EXECUTION_TIMEOUT_MS = 30_000;
-// ─── Error codes ───────────────────────────────────────────────────────────
-/** Zod schema for session error codes. */
-export const SessionErrorCodeSchema = z.enum([
-    "stt",
-    "llm",
-    "tts",
-    "tool",
-    "protocol",
-    "connection",
-    "audio",
-    "internal",
-]);
-// ─── Client events ─────────────────────────────────────────────────────────
-/** Helper: simple event with only a type field. */
-const ev = (t) => z.object({ type: z.literal(t) });
-/** Helper: event with type + text. */
-const textEv = (t) => z.object({ type: z.literal(t), text: z.string() });
-const turnOrder = z.number().int().nonnegative().optional();
-/** Zod schema for {@linkcode ClientEvent}. */
-export const ClientEventSchema = z.discriminatedUnion("type", [
-    ev("speech_started"),
-    ev("speech_stopped"),
-    z.object({ type: z.literal("transcript"), text: z.string(), isFinal: z.boolean(), turnOrder }),
-    textEv("turn").extend({ turnOrder }),
-    textEv("chat"),
-    textEv("chat_delta"),
-    z.object({
-        type: z.literal("tool_call_start"),
-        toolCallId: z.string(),
-        toolName: z.string(),
-        args: z.record(z.string(), z.unknown()),
-    }),
-    z.object({
-        type: z.literal("tool_call_done"),
-        toolCallId: z.string(),
-        result: z.string().max(4000),
-    }),
-    ev("tts_done"),
-    ev("cancelled"),
-    ev("reset"),
-    z.object({ type: z.literal("error"), code: SessionErrorCodeSchema, message: z.string() }),
-]);
-/** Zod schema for client→server text messages. */
-export const ClientMessageSchema = z.discriminatedUnion("type", [
-    ev("audio_ready"),
-    ev("cancel"),
-    ev("reset"),
-    z.object({
-        type: z.literal("history"),
-        messages: z
-            .array(z.object({ role: z.enum(["user", "assistant"]), text: z.string().max(100_000) }))
-            .max(200),
-    }),
-]);
-//# sourceMappingURL=protocol.js.map

package/dist/sdk/protocol.js.map

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

package/dist/sdk/runtime.d.ts

@@ -1,36 +0,0 @@
-/**
- * Pluggable interfaces for cross-runtime concerns.
- *
- * @module
- */
-/** Structured context attached to log messages. */
-export type LogContext = Record<string, unknown>;
-/** Runtime-agnostic structured logger. */
-export type Logger = {
-    info(msg: string, ctx?: LogContext): void;
-    warn(msg: string, ctx?: LogContext): void;
-    error(msg: string, ctx?: LogContext): void;
-    debug(msg: string, ctx?: LogContext): void;
-};
-/** Runtime-agnostic session metrics. */
-export type Metrics = {
-    sessionsTotal: {
-        inc(labels: Record<string, string>): void;
-    };
-    sessionsActive: {
-        inc(labels: Record<string, string>): void;
-        dec(labels: Record<string, string>): void;
-    };
-};
-export declare const consoleLogger: Logger;
-/** No-op metrics implementation for environments without monitoring. */
-export declare const noopMetrics: Metrics;
-/** Configuration for the AssemblyAI Speech-to-Speech connection. */
-export type S2SConfig = {
-    wssUrl: string;
-    inputSampleRate: number;
-    outputSampleRate: number;
-};
-/** Default S2S configuration pointing to AssemblyAI's production endpoint. */
-export declare const DEFAULT_S2S_CONFIG: S2SConfig;
-//# sourceMappingURL=runtime.d.ts.map