@alexkroman1/aai 0.10.4 → 0.11.1

package/dist/{testing-BonJtfHJ.js → testing-CNNg2-n-.js}

@@ -1,10 +1,10 @@
-import "./types.js";
-import { i as createUnstorageKv, t as createRuntime } from "./direct-executor-BfHrDdPL.js";
-import { resolve } from "node:path";
+import "./isolate/types.js";
+import { i as createUnstorageKv, t as createRuntime } from "./direct-executor-DyY-Y4ZE.js";
+import { vi } from "vitest";
 import { createStorage } from "unstorage";
 import "nanoevents";
-import { vi } from "vitest";
-//#region _mock-ws.ts
+import { resolve } from "node:path";
+//#region host/_mock-ws.ts
 /**
 * A mock WebSocket implementation for testing.
 *
@@ -157,15 +157,29 @@ function installMockWebSocket() {
 	};
 }
 //#endregion
-//#region _test-utils.ts
+//#region host/_test-utils.ts
 /** Yield to the microtask queue so pending promises settle. */
 function flush() {
 	return new Promise((r) => queueMicrotask(r));
 }
+/** Create a stub Session with all methods as vi.fn() spies. */
+function makeStubSession(overrides) {
+	return {
+		start: vi.fn(() => Promise.resolve()),
+		stop: vi.fn(() => Promise.resolve()),
+		onAudio: vi.fn(),
+		onAudioReady: vi.fn(),
+		onCancel: vi.fn(),
+		onReset: vi.fn(),
+		onHistory: vi.fn(),
+		waitForTurn: vi.fn(() => Promise.resolve()),
+		...overrides
+	};
+}
 vi.fn(), vi.fn(), vi.fn(), vi.fn();
 resolve(import.meta.dirname, "__fixtures__");
 //#endregion
-//#region testing.ts
+//#region host/testing.ts
 /**
 * Testing utilities for AAI agents.
 *
@@ -496,4 +510,4 @@ function createTestHarness(agent, options = {}) {
 	}), `test-${Date.now()}`);
 }
 //#endregion
-export { MockWebSocket as a, flush as i, TurnResult as n, installMockWebSocket as o, createTestHarness as r, TestHarness as t };
+export { makeStubSession as a, flush as i, TurnResult as n, MockWebSocket as o, createTestHarness as r, installMockWebSocket as s, TestHarness as t };

package/package.json

@@ -1,72 +1,76 @@
 {
   "name": "@alexkroman1/aai",
-  "version": "0.10.4",
+  "version": "0.11.1",
   "type": "module",
   "files": [
     "dist"
   ],
   "exports": {
     ".": {
-      "source": "./index.ts",
+      "@dev/source": "./index.ts",
       "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": {
-      "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": {
-      "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": {
-      "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": {
-      "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": {
-      "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": {
-      "source": "./matchers.ts",
-      "types": "./dist/matchers.d.ts",
-      "import": "./dist/matchers.js"
-    },
-    "./internal": {
-      "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": {
-      "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": {
-      "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": {
-      "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": {
     "hookable": "^6.1.0",
     "nanoevents": "^9.1.0",
     "p-timeout": "^7.0.1",
-    "secure-exec": "^0.1.0",
     "unstorage": "^1.17.5",
     "ws": "^8.20.0",
     "zod": "^4.3.6"
@@ -96,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/_run-code.d.ts

@@ -1,31 +0,0 @@
-/**
- * run_code built-in tool — executes user JavaScript in a fresh secure-exec
- * V8 isolate with no network, filesystem writes, or env access.
- */
-import { z } from "zod";
-import type { ToolDef } from "./types.ts";
-declare const runCodeParams: z.ZodObject<{
-    code: z.ZodString;
-}, z.core.$strip>;
-/**
- * Execute JavaScript code inside a fresh secure-exec V8 isolate.
- *
- * Each invocation spins up a disposable isolate with:
- * - No filesystem writes
- * - No network access
- * - No child process spawning
- * - No environment variable access
- * - 32 MB memory limit
- * - 5 second execution timeout
- *
- * The isolate is disposed immediately after execution, so no state
- * leaks between invocations or across sessions.
- */
-export declare function createRunCode(): ToolDef<typeof runCodeParams>;
-/**
- * Exported for testing — execute user code in a fresh secure-exec V8 isolate.
- */
-export declare function executeInIsolate(code: string): Promise<string | {
-    error: string;
-}>;
-export {};

package/dist/_runtime-conformance.d.ts

@@ -1,64 +0,0 @@
-/**
- * Shared runtime conformance tests.
- *
- * Both the self-hosted direct executor and the platform sandbox must satisfy
- * the same behavioral contract. This module defines that contract as a
- * reusable test suite that can be wired to either runtime.
- *
- * Inspired by Nitro's `testNitro()` pattern: one test fixture, many runtimes.
- *
- * @example Direct executor (unit test)
- * ```ts
- * import { testRuntime } from "./_runtime-conformance.ts";
- *
- * testRuntime("direct", () => {
- *   const exec = createRuntime({ agent: CONFORMANCE_AGENT, env: { MY_VAR: "test-value" } });
- *   return { executeTool: exec.executeTool, hooks: exec.hooks };
- * });
- * ```
- *
- * @example Sandbox (integration test)
- * ```ts
- * import { testRuntime, CONFORMANCE_AGENT_BUNDLE } from "@alexkroman1/aai/runtime-conformance";
- *
- * testRuntime("sandbox", async () => {
- *   // ... start isolate with CONFORMANCE_AGENT_BUNDLE
- *   return { executeTool: buildExecuteTool(...), hooks: buildHookInvoker(...) };
- * });
- * ```
- */
-import type { ExecuteTool } from "./_internal-types.ts";
-import type { AgentHooks } from "./hooks.ts";
-import { type AgentDef } from "./types.ts";
-/**
- * Minimal runtime surface needed for conformance tests.
- *
- * Both `Runtime` and `buildExecuteTool`/`buildHookInvoker` from the
- * sandbox produce objects that satisfy this interface.
- */
-export type RuntimeTestContext = {
-    executeTool: ExecuteTool;
-    hooks: AgentHooks;
-};
-/**
- * Agent definition used by the conformance suite (direct executor path).
- *
- * Must be kept in sync with {@link CONFORMANCE_AGENT_BUNDLE}.
- */
-export declare const CONFORMANCE_AGENT: AgentDef;
-/**
- * JavaScript bundle equivalent of {@link CONFORMANCE_AGENT} for the sandbox
- * isolate path. Must be kept in sync with the AgentDef above.
- */
-export declare const CONFORMANCE_AGENT_BUNDLE = "\nexport default {\n  name: \"conformance-test\",\n  instructions: \"Conformance test agent.\",\n  greeting: \"Hello!\",\n  maxSteps: 5,\n  state: () => ({ count: 0, lastTurn: \"\" }),\n  tools: {\n    echo: {\n      description: \"Echo input\",\n      execute(args) { return \"echo:\" + args.text; },\n    },\n    get_env: {\n      description: \"Get MY_VAR from env\",\n      execute(_args, ctx) { return ctx.env.MY_VAR ?? \"missing\"; },\n    },\n    get_state: {\n      description: \"Get session state\",\n      execute(_args, ctx) { return JSON.stringify(ctx.state); },\n    },\n    echo_messages: {\n      description: \"Return messages as JSON\",\n      execute(_args, ctx) { return JSON.stringify(ctx.messages); },\n    },\n    kv_roundtrip: {\n      description: \"KV set then get\",\n      async execute(args, ctx) {\n        await ctx.kv.set(\"test-key\", args.value);\n        const result = await ctx.kv.get(\"test-key\");\n        return \"stored:\" + JSON.stringify(result);\n      },\n    },\n  },\n  onConnect: (ctx) => { ctx.state.count = 1; },\n  onTurn: (text, ctx) => { ctx.state.lastTurn = text; },\n};\n";
-/**
- * Run the runtime conformance test suite against a given runtime context.
- *
- * The `getContext` callback is invoked once per test to retrieve the
- * current {@link RuntimeTestContext}. This allows the caller to set up
- * the runtime in a `beforeAll` and return it lazily.
- *
- * All tests assume the runtime was created with {@link CONFORMANCE_AGENT}
- * (or its bundle equivalent) and `env: { MY_VAR: "test-value" }`.
- */
-export declare function testRuntime(label: string, getContext: () => RuntimeTestContext): void;

package/dist/_utils.d.ts

@@ -1,21 +0,0 @@
-/** Shared utility functions. */
-/** Extract an error message from an unknown thrown value. */
-export declare function errorMessage(err: unknown): string;
-/** Extract a detailed error string (message + stack) for diagnostic logging. */
-export declare function errorDetail(err: unknown): string;
-/** Check whether a filesystem operation is a read-only operation. */
-export declare function isReadOnlyFsOp(op: string): boolean;
-/**
- * Lazily initialized per-session state manager.
- *
- * On first access for a given session, calls `initState()` (if provided) to
- * create the initial state. Returns `{}` if no initializer and no prior state.
- */
-export declare function createSessionStateMap(initState?: () => Record<string, unknown>): {
-    get(sessionId: string): Record<string, unknown>;
-    /** Explicitly set the state for a session. */
-    set(sessionId: string, state: Record<string, unknown>): void;
-    delete(sessionId: string): boolean;
-};
-/** Return a JSON error string for the LLM: `'{"error":"<message>"}'`. */
-export declare function toolError(message: string): string;

package/dist/_utils.js

@@ -1,49 +0,0 @@
-//#region _utils.ts
-/** Shared utility functions. */
-/** Extract an error message from an unknown thrown value. */
-function errorMessage(err) {
-	return err instanceof Error ? err.message : String(err);
-}
-/** Extract a detailed error string (message + stack) for diagnostic logging. */
-function errorDetail(err) {
-	if (err instanceof Error) return err.stack ?? err.message;
-	return String(err);
-}
-/** Set of filesystem operations that are safe for read-only access. */
-const READ_ONLY_FS_OPS = new Set([
-	"read",
-	"stat",
-	"readdir",
-	"exists"
-]);
-/** Check whether a filesystem operation is a read-only operation. */
-function isReadOnlyFsOp(op) {
-	return READ_ONLY_FS_OPS.has(op);
-}
-/**
-* Lazily initialized per-session state manager.
-*
-* On first access for a given session, calls `initState()` (if provided) to
-* create the initial state. Returns `{}` if no initializer and no prior state.
-*/
-function createSessionStateMap(initState) {
-	const map = /* @__PURE__ */ new Map();
-	return {
-		get(sessionId) {
-			if (!map.has(sessionId) && initState) map.set(sessionId, initState());
-			return map.get(sessionId) ?? {};
-		},
-		set(sessionId, state) {
-			map.set(sessionId, state);
-		},
-		delete(sessionId) {
-			return map.delete(sessionId);
-		}
-	};
-}
-/** Return a JSON error string for the LLM: `'{"error":"<message>"}'`. */
-function toolError(message) {
-	return JSON.stringify({ error: message });
-}
-//#endregion
-export { createSessionStateMap, errorDetail, errorMessage, isReadOnlyFsOp, toolError };

package/dist/testing.js

@@ -1,2 +0,0 @@
-import { a as MockWebSocket, i as flush, n as TurnResult, o as installMockWebSocket, r as createTestHarness, t as TestHarness } from "./testing-BonJtfHJ.js";
-export { MockWebSocket, TestHarness, TurnResult, createTestHarness, flush, installMockWebSocket };

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";
     }>;