@alexkroman1/aai 0.11.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "files": [
     "dist"
@@ -11,55 +11,60 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./isolate": {
+      "@dev/source": "./isolate/index.ts",
+      "types": "./dist/isolate/index.d.ts",
+      "import": "./dist/isolate/index.js"
+    },
+    "./host": {
+      "@dev/source": "./host/index.ts",
+      "types": "./dist/host/index.d.ts",
+      "import": "./dist/host/index.js"
+    },
     "./server": {
-      "@dev/source": "./server.ts",
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js"
+      "@dev/source": "./host/server.ts",
+      "types": "./dist/host/server.d.ts",
+      "import": "./dist/host/server.js"
     },
     "./types": {
-      "@dev/source": "./types.ts",
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js"
+      "@dev/source": "./isolate/types.ts",
+      "types": "./dist/isolate/types.d.ts",
+      "import": "./dist/isolate/types.js"
     },
     "./kv": {
-      "@dev/source": "./kv.ts",
-      "types": "./dist/kv.d.ts",
-      "import": "./dist/kv.js"
+      "@dev/source": "./isolate/kv.ts",
+      "types": "./dist/isolate/kv.d.ts",
+      "import": "./dist/isolate/kv.js"
     },
     "./protocol": {
-      "@dev/source": "./protocol.ts",
-      "types": "./dist/protocol.d.ts",
-      "import": "./dist/protocol.js"
+      "@dev/source": "./isolate/protocol.ts",
+      "types": "./dist/isolate/protocol.d.ts",
+      "import": "./dist/isolate/protocol.js"
     },
     "./testing": {
-      "@dev/source": "./testing.ts",
-      "types": "./dist/testing.d.ts",
-      "import": "./dist/testing.js"
+      "@dev/source": "./host/testing.ts",
+      "types": "./dist/host/testing.d.ts",
+      "import": "./dist/host/testing.js"
     },
     "./testing/matchers": {
-      "@dev/source": "./matchers.ts",
-      "types": "./dist/matchers.d.ts",
-      "import": "./dist/matchers.js"
-    },
-    "./internal": {
-      "@dev/source": "./internal.ts",
-      "types": "./dist/internal.d.ts",
-      "import": "./dist/internal.js"
+      "@dev/source": "./host/matchers.ts",
+      "types": "./dist/host/matchers.d.ts",
+      "import": "./dist/host/matchers.js"
     },
     "./hooks": {
-      "@dev/source": "./hooks.ts",
-      "types": "./dist/hooks.d.ts",
-      "import": "./dist/hooks.js"
+      "@dev/source": "./isolate/hooks.ts",
+      "types": "./dist/isolate/hooks.d.ts",
+      "import": "./dist/isolate/hooks.js"
     },
     "./utils": {
-      "@dev/source": "./_utils.ts",
-      "types": "./dist/_utils.d.ts",
-      "import": "./dist/_utils.js"
+      "@dev/source": "./isolate/_utils.ts",
+      "types": "./dist/isolate/_utils.d.ts",
+      "import": "./dist/isolate/_utils.js"
     },
     "./vite-plugin": {
-      "@dev/source": "./vite-plugin.ts",
-      "types": "./dist/vite-plugin.d.ts",
-      "import": "./dist/vite-plugin.js"
+      "@dev/source": "./host/vite-plugin.ts",
+      "types": "./dist/host/vite-plugin.d.ts",
+      "import": "./dist/host/vite-plugin.js"
     }
   },
   "dependencies": {
@@ -95,7 +100,7 @@
   },
   "scripts": {
     "build": "tsdown && tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p isolate/tsconfig.json",
     "lint": "biome check .",
     "check:publint": "publint",
     "check:attw": "attw --pack --profile esm-only"

package/dist/constants-CwotjpJR.js

@@ -1,45 +0,0 @@
-//#region constants.ts
-/**
-* Centralised numeric constants — timeouts, size limits, sample rates.
-*
-* Every magic number that controls a timeout, buffer size, or threshold
-* lives here so the values are discoverable in one place.
-*/
-/** Default sample rate for speech-to-text audio in Hz (AssemblyAI). */
-const DEFAULT_STT_SAMPLE_RATE = 16e3;
-/** Default sample rate for text-to-speech audio in Hz. */
-const DEFAULT_TTS_SAMPLE_RATE = 24e3;
-/** Default timeout for agent lifecycle hooks (onConnect, onTurn, etc). */
-const HOOK_TIMEOUT_MS = 5e3;
-/** Default timeout for tool execution in the worker. */
-const TOOL_EXECUTION_TIMEOUT_MS = 3e4;
-/** Timeout for session.start() (S2S connection setup). */
-const DEFAULT_SESSION_START_TIMEOUT_MS = 1e4;
-/** S2S session idle timeout before auto-close. */
-const DEFAULT_IDLE_TIMEOUT_MS = 3e5;
-/** Per-fetch timeout for network tools (web_search, visit_webpage, fetch_json). */
-const FETCH_TIMEOUT_MS = 15e3;
-/** Timeout for sandboxed run_code execution. */
-const RUN_CODE_TIMEOUT_MS = 5e3;
-/** Maximum time to wait for sessions to stop during graceful shutdown. */
-const DEFAULT_SHUTDOWN_TIMEOUT_MS = 3e4;
-/** Maximum length for tool result strings sent to clients. */
-const MAX_TOOL_RESULT_CHARS = 4e3;
-/** Maximum chars for webpage text after HTML-to-text conversion. */
-const MAX_PAGE_CHARS = 1e4;
-/** Maximum bytes to fetch from an HTML page before conversion. */
-const MAX_HTML_BYTES = 2e5;
-/** Maximum value size for KV store entries (bytes). */
-const MAX_VALUE_SIZE = 65536;
-/** Maximum glob pattern length to prevent ReDoS. */
-const MAX_GLOB_PATTERN_LENGTH = 1024;
-/** Maximum conversation messages to retain (sliding window). */
-const DEFAULT_MAX_HISTORY = 200;
-/**
-* Content-Security-Policy applied to agent UI pages (both self-hosted and
-* platform). Single source of truth — used by `secureHeaders` middleware
-* and per-response CSP headers.
-*/
-const AGENT_CSP = "default-src 'self'; script-src 'self' 'unsafe-eval' blob:; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; connect-src 'self' wss: ws:; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com; object-src 'none'; base-uri 'self'";
-//#endregion
-export { DEFAULT_SHUTDOWN_TIMEOUT_MS as a, FETCH_TIMEOUT_MS as c, MAX_HTML_BYTES as d, MAX_PAGE_CHARS as f, TOOL_EXECUTION_TIMEOUT_MS as g, RUN_CODE_TIMEOUT_MS as h, DEFAULT_SESSION_START_TIMEOUT_MS as i, HOOK_TIMEOUT_MS as l, MAX_VALUE_SIZE as m, DEFAULT_IDLE_TIMEOUT_MS as n, DEFAULT_STT_SAMPLE_RATE as o, MAX_TOOL_RESULT_CHARS as p, DEFAULT_MAX_HISTORY as r, DEFAULT_TTS_SAMPLE_RATE as s, AGENT_CSP as t, MAX_GLOB_PATTERN_LENGTH as u };

package/dist/kv.js

@@ -1,33 +0,0 @@
-import { m as MAX_VALUE_SIZE, u as MAX_GLOB_PATTERN_LENGTH } from "./constants-CwotjpJR.js";
-//#region kv.ts
-/**
-* Key-value storage interface and shared utilities.
-*/
-/** Sort entries by key and apply reverse/limit options. Mutates the array. */
-function sortAndPaginate(entries, options) {
-	entries.sort((a, b) => a.key.localeCompare(b.key));
-	if (options?.reverse) entries.reverse();
-	if (options?.limit && options.limit > 0) entries.length = Math.min(entries.length, options.limit);
-	return entries;
-}
-/** Simple glob matcher — supports `*` as a wildcard for any characters. */
-function matchGlob(key, pattern) {
-	if (pattern.length > 1024) throw new Error(`Glob pattern exceeds maximum length of ${MAX_GLOB_PATTERN_LENGTH}`);
-	const parts = pattern.split("*");
-	if (parts.length === 1) return key === pattern;
-	const first = parts[0];
-	if (!key.startsWith(first)) return false;
-	const last = parts.at(-1);
-	if (key.length < first.length + last.length) return false;
-	if (!key.endsWith(last)) return false;
-	let pos = first.length;
-	const end = key.length - last.length;
-	for (const part of parts.slice(1, -1)) {
-		const idx = key.indexOf(part, pos);
-		if (idx === -1 || idx > end) return false;
-		pos = idx + part.length;
-	}
-	return pos <= end;
-}
-//#endregion
-export { MAX_VALUE_SIZE, matchGlob, sortAndPaginate };

package/dist/memory-tools.d.ts

@@ -1,39 +0,0 @@
-/**
- * KV-backed memory tools for agent persistent state.
- */
-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.
- *
- * @example
- * ```ts
- * import { defineAgent, memoryTools } from "aai";
- *
- * export default defineAgent({
- *   name: "My Agent",
- *   tools: { ...memoryTools() },
- * });
- * ```
- *
- * @returns A record with four tool definitions: `save_memory`, `recall_memory`,
- *   `list_memories`, and `forget_memory`.
- * @public
- */
-export declare function memoryTools(): {
-    save_memory: import("./types.ts").ToolDef<z.ZodObject<{
-        key: z.ZodString;
-        value: z.ZodString;
-    }, z.core.$strip>, Record<string, unknown>>;
-    recall_memory: import("./types.ts").ToolDef<z.ZodObject<{
-        key: z.ZodString;
-    }, z.core.$strip>, Record<string, unknown>>;
-    list_memories: import("./types.ts").ToolDef<z.ZodObject<{
-        prefix: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, Record<string, unknown>>;
-    forget_memory: import("./types.ts").ToolDef<z.ZodObject<{
-        key: z.ZodString;
-    }, z.core.$strip>, Record<string, unknown>>;
-};

package/dist/{protocol.d.ts → isolate/protocol.d.ts}

@@ -39,11 +39,11 @@ export type KvRequest = z.infer<typeof KvRequestSchema>;
  */
 export declare const SessionErrorCodeSchema: z.ZodEnum<{
     tool: "tool";
-    connection: "connection";
     stt: "stt";
     llm: "llm";
     tts: "tts";
     protocol: "protocol";
+    connection: "connection";
     audio: "audio";
     internal: "internal";
 }>;
@@ -94,11 +94,11 @@ export declare const ClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"error">;
     code: z.ZodEnum<{
         tool: "tool";
-        connection: "connection";
         stt: "stt";
         llm: "llm";
         tts: "tts";
         protocol: "protocol";
+        connection: "connection";
         audio: "audio";
         internal: "internal";
     }>;
@@ -182,11 +182,11 @@ export declare const ServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"error">;
     code: z.ZodEnum<{
         tool: "tool";
-        connection: "connection";
         stt: "stt";
         llm: "llm";
         tts: "tts";
         protocol: "protocol";
+        connection: "connection";
         audio: "audio";
         internal: "internal";
     }>;