@alexkroman1/aai 0.8.3 → 0.8.4

package/dist/sdk/direct_executor.js.map

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

package/dist/sdk/host.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,131 @@
+// 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

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

package/dist/sdk/mod.d.ts

@@ -21,9 +21,7 @@
  *
  * @module
  */
-export { defineAgent } from "./define_agent.ts";
-export { memoryTools } from "./memory_tools.ts";
-export type { AgentOptions, BeforeStepResult, BuiltinTool, HookContext, Message, StepInfo, ToolContext, ToolDef, } from "./types.ts";
-export { tool } from "./types.ts";
+export { memoryTools } from "./builtin_tools.ts";
+export { type AgentOptions, type BeforeStepResult, type BuiltinTool, defineAgent, type HookContext, type Message, type StepInfo, type ToolContext, type ToolDef, tool, } from "./types.ts";
 export type { VectorEntry, VectorStore } from "./vector.ts";
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../sdk/mod.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,OAAO,EACP,QAAQ,EACR,WAAW,EACX,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"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

@@ -22,7 +22,6 @@
  *
  * @module
  */
-export { defineAgent } from "./define_agent.js";
-export { memoryTools } from "./memory_tools.js";
-export { tool } from "./types.js";
+export { memoryTools } from "./builtin_tools.js";
+export { defineAgent, tool, } from "./types.js";
 //# sourceMappingURL=mod.js.map

package/dist/sdk/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../sdk/mod.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWhD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}
+{"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

@@ -6,7 +6,6 @@
  * @module
  */
 import { z } from "zod";
-import type { Message, StepInfo } from "./types.ts";
 /**
  * Default sample rate for speech-to-text audio in Hz.
  *
@@ -27,42 +26,14 @@ export declare const DEFAULT_TTS_SAMPLE_RATE = 24000;
 export declare const AUDIO_FORMAT: "pcm16";
 /** Specification for binary audio frames exchanged over WebSocket. */
 export declare const AudioFrameSpec: {
-    /** Audio codec identifier sent in the `ready` message. */
     readonly format: "pcm16";
-    /** Signed 16-bit integer samples. */
     readonly bitsPerSample: 16;
-    /** Little-endian byte order. */
     readonly endianness: "little";
-    /** Mono audio. */
     readonly channels: 1;
-    /** Bytes per sample — derived from bitsPerSample and channels. */
-    readonly bytesPerSample: number;
+    readonly bytesPerSample: 2;
 };
-/**
- * KV operation request sent from the worker to the host via postMessage RPC.
- *
- * This is a discriminated union on the `op` field, representing the four
- * key-value store operations available to sandboxed agent workers.
- */
-export type KvRequest = {
-    op: "get";
-    key: string;
-} | {
-    op: "set";
-    key: string;
-    value: string;
-    ttl?: number | undefined;
-} | {
-    op: "del";
-    key: string;
-} | {
-    op: "list";
-    prefix: string;
-    limit?: number | undefined;
-    reverse?: boolean | undefined;
-};
-/** Zod schema for {@linkcode KvRequest}. */
-export declare const KvRequestBaseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+/** Zod schema for KV operation requests from the worker to the host. */
+export declare const KvRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     op: z.ZodLiteral<"get">;
     key: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -78,14 +49,34 @@ export declare const KvRequestBaseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     prefix: z.ZodString;
     limit: z.ZodOptional<z.ZodNumber>;
     reverse: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"keys">;
+    pattern: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "op">;
+/** KV operation request — discriminated union on the `op` field. */
+export type KvRequest = z.infer<typeof KvRequestSchema>;
+/** Zod schema for vector operation requests. */
+export declare const VectorRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"upsert">;
+    id: z.ZodString;
+    data: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"query">;
+    text: z.ZodString;
+    topK: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"remove">;
+    ids: z.ZodArray<z.ZodString>;
 }, z.core.$strip>], "op">;
+/** Vector operation request — discriminated union on the `op` field. */
+export type VectorRequest = z.infer<typeof VectorRequestSchema>;
 /** Default timeout for agent lifecycle hooks (onConnect, onTurn, etc). */
 export declare const HOOK_TIMEOUT_MS = 5000;
 /** Default timeout for tool execution in the worker. */
 export declare const TOOL_EXECUTION_TIMEOUT_MS = 30000;
-/** Error codes for categorizing session errors on the wire. */
-export type SessionErrorCode = "stt" | "llm" | "tts" | "tool" | "protocol" | "connection" | "audio" | "internal";
-/** Zod schema for {@linkcode SessionErrorCode}. */
+/** Zod schema for session error codes. */
 export declare const SessionErrorCodeSchema: z.ZodEnum<{
     tool: "tool";
     audio: "audio";
@@ -96,54 +87,8 @@ export declare const SessionErrorCodeSchema: z.ZodEnum<{
     connection: "connection";
     internal: "internal";
 }>;
-/**
- * Discriminated union of all server→client session events.
- *
- * Sent via a single `event()` RPC method instead of one method per type.
- */
-export type ClientEvent = {
-    type: "speech_started";
-} | {
-    type: "speech_stopped";
-} | {
-    type: "transcript";
-    text: string;
-    isFinal: false;
-} | {
-    type: "transcript";
-    text: string;
-    isFinal: true;
-    turnOrder?: number | undefined;
-} | {
-    type: "turn";
-    text: string;
-    turnOrder?: number | undefined;
-} | {
-    type: "chat";
-    text: string;
-} | {
-    type: "chat_delta";
-    text: string;
-} | {
-    type: "tool_call_start";
-    toolCallId: string;
-    toolName: string;
-    args: Record<string, unknown>;
-} | {
-    type: "tool_call_done";
-    toolCallId: string;
-    result: string;
-} | {
-    type: "tts_done";
-} | {
-    type: "cancelled";
-} | {
-    type: "reset";
-} | {
-    type: "error";
-    code: SessionErrorCode;
-    message: string;
-};
+/** Error codes for categorizing session errors on the wire. */
+export type SessionErrorCode = z.infer<typeof SessionErrorCodeSchema>;
 /** Zod schema for {@linkcode ClientEvent}. */
 export declare const ClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"speech_started">;
@@ -193,6 +138,8 @@ export declare const ClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     message: z.ZodString;
 }, z.core.$strip>], "type">;
+/** Discriminated union of all server→client session events. */
+export type ClientEvent = z.infer<typeof ClientEventSchema>;
 /**
  * Typed interface for pushing session events to a connected client.
  *
@@ -216,27 +163,13 @@ export type ReadyConfig = {
     sampleRate: number;
     ttsSampleRate: number;
 };
-/** Client→server text messages (binary frames carry raw PCM16 audio). */
-export type ClientMessage = {
-    type: "audio_ready";
-} | {
-    type: "cancel";
-} | {
-    type: "reset";
-} | {
-    type: "history";
-    messages: readonly {
-        role: "user" | "assistant";
-        text: string;
-    }[];
-};
 /** Server→client text messages (binary frames carry raw PCM16 audio). */
 export type ServerMessage = ({
     type: "config";
 } & ReadyConfig) | {
     type: "audio_done";
 } | ClientEvent;
-/** Zod schema for {@linkcode ClientMessage}. */
+/** Zod schema for client→server text messages. */
 export declare const ClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"audio_ready">;
 }, z.core.$strip>, z.ZodObject<{
@@ -253,46 +186,11 @@ export declare const ClientMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         text: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>], "type">;
-/**
- * API shape the host process exposes to the sandboxed worker.
- *
- * Since workers run with all permissions denied, they use this interface
- * to proxy network requests and KV operations back to the host.
- */
-export type HostApi = {
-    fetch(req: {
-        url: string;
-        method: string;
-        headers: Readonly<Record<string, string>>;
-        body: string | null;
-    }): Promise<{
-        status: number;
-        statusText: string;
-        headers: Record<string, string>;
-        body: string;
-    }>;
-    kv(req: KvRequest): Promise<{
-        result: unknown;
-    }>;
-    vectorSearch(req: {
-        query: string;
-        topK: number;
-    }): Promise<string>;
-};
+/** Client→server text messages (binary frames carry raw PCM16 audio). */
+export type ClientMessage = z.infer<typeof ClientMessageSchema>;
 /** Combined turn configuration resolved from the worker before a turn starts. */
 export type TurnConfig = {
     maxSteps?: number;
     activeTools?: string[];
 };
-/** Worker-side RPC target interface (host calls these methods). */
-export interface WorkerRpcApi {
-    withEnv(env: Record<string, string>): WorkerRpcApi;
-    executeTool(name: string, args: Readonly<Record<string, unknown>>, sessionId: string | undefined, messages: readonly Message[] | undefined): Promise<string>;
-    onConnect(sessionId: string): Promise<void>;
-    onDisconnect(sessionId: string): Promise<void>;
-    onTurn(sessionId: string, text: string): Promise<void>;
-    onError(sessionId: string, error: string): void;
-    onStep(sessionId: string, step: StepInfo): Promise<void>;
-    resolveTurnConfig(sessionId: string): Promise<TurnConfig | null>;
-}
 //# sourceMappingURL=protocol.d.ts.map

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

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