@tanstack/ai-code-mode-snippets 0.3.14

package/dist/esm/snippets-to-bindings.js

@@ -0,0 +1,74 @@
+//#region src/snippets-to-bindings.ts
+/**
+* Convert snippets to sandbox bindings with the snippet_ prefix.
+* Snippets become callable functions inside the sandbox.
+*/
+function snippetsToBindings({ snippets, context, executeInSandbox, storage }) {
+	const bindings = {};
+	for (const snippet of snippets) {
+		const bindingName = `snippet_${snippet.name}`;
+		bindings[bindingName] = {
+			name: bindingName,
+			description: snippet.description,
+			inputSchema: snippet.inputSchema,
+			outputSchema: snippet.outputSchema,
+			execute: async (input) => {
+				const startTime = Date.now();
+				context?.emitCustomEvent("code_mode:snippet_call", {
+					snippet: snippet.name,
+					input,
+					timestamp: startTime
+				});
+				try {
+					const result = await executeInSandbox(`
+            const input = ${JSON.stringify(input)};
+            ${snippet.code}
+          `, input);
+					const duration = Date.now() - startTime;
+					context?.emitCustomEvent("code_mode:snippet_result", {
+						snippet: snippet.name,
+						result,
+						duration,
+						timestamp: Date.now()
+					});
+					storage.updateStats(snippet.name, true).catch(() => {});
+					return result;
+				} catch (error) {
+					const duration = Date.now() - startTime;
+					context?.emitCustomEvent("code_mode:snippet_error", {
+						snippet: snippet.name,
+						error: error instanceof Error ? error.message : String(error),
+						duration,
+						timestamp: Date.now()
+					});
+					storage.updateStats(snippet.name, false).catch(() => {});
+					throw error;
+				}
+			}
+		};
+	}
+	return bindings;
+}
+/**
+* Create a simple binding record for snippets without full sandbox execution.
+* This is used when snippets are being documented in the system prompt
+* but not yet being executed.
+*/
+function snippetsToSimpleBindings(snippets) {
+	const bindings = {};
+	for (const snippet of snippets) {
+		const bindingName = `snippet_${snippet.name}`;
+		bindings[bindingName] = {
+			name: bindingName,
+			description: snippet.description,
+			inputSchema: snippet.inputSchema,
+			outputSchema: snippet.outputSchema,
+			execute: () => Promise.reject(/* @__PURE__ */ new Error(`Snippet ${snippet.name} is not available for execution in this context`))
+		};
+	}
+	return bindings;
+}
+//#endregion
+export { snippetsToBindings, snippetsToSimpleBindings };
+
+//# sourceMappingURL=snippets-to-bindings.js.map

package/dist/esm/snippets-to-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets-to-bindings.js","names":[],"sources":["../../src/snippets-to-bindings.ts"],"sourcesContent":["import type { ToolExecutionContext } from '@tanstack/ai'\nimport type { ToolBinding } from '@tanstack/ai-code-mode'\nimport type { Snippet, SnippetStorage } from './types'\n\ninterface SnippetsToBindingsOptions {\n  /**\n   * Snippets to convert to bindings\n   */\n  snippets: Array<Snippet>\n\n  /**\n   * Tool execution context for emitting custom events\n   */\n  context?: ToolExecutionContext\n\n  /**\n   * Function to execute snippet code in the sandbox\n   * The snippet code receives `input` as a variable\n   */\n  executeInSandbox: (code: string, input: unknown) => Promise<unknown>\n\n  /**\n   * Storage for updating execution stats\n   */\n  storage: SnippetStorage\n}\n\n/**\n * Convert snippets to sandbox bindings with the snippet_ prefix.\n * Snippets become callable functions inside the sandbox.\n */\nexport function snippetsToBindings({\n  snippets,\n  context,\n  executeInSandbox,\n  storage,\n}: SnippetsToBindingsOptions): Record<string, ToolBinding> {\n  const bindings: Record<string, ToolBinding> = {}\n\n  for (const snippet of snippets) {\n    const bindingName = `snippet_${snippet.name}`\n\n    bindings[bindingName] = {\n      name: bindingName,\n      description: snippet.description,\n      inputSchema: snippet.inputSchema,\n      outputSchema: snippet.outputSchema,\n      execute: async (input: unknown) => {\n        const startTime = Date.now()\n\n        // Emit snippet call event\n        context?.emitCustomEvent('code_mode:snippet_call', {\n          snippet: snippet.name,\n          input,\n          timestamp: startTime,\n        })\n\n        try {\n          // Wrap the snippet code to receive input as a variable\n          const wrappedCode = `\n            const input = ${JSON.stringify(input)};\n            ${snippet.code}\n          `\n\n          const result = await executeInSandbox(wrappedCode, input)\n          const duration = Date.now() - startTime\n\n          // Emit success event\n          context?.emitCustomEvent('code_mode:snippet_result', {\n            snippet: snippet.name,\n            result,\n            duration,\n            timestamp: Date.now(),\n          })\n\n          // Update stats (async, don't await to not block)\n          storage.updateStats(snippet.name, true).catch(() => {\n            // Silently ignore stats update failures\n          })\n\n          return result\n        } catch (error) {\n          const duration = Date.now() - startTime\n\n          // Emit error event\n          context?.emitCustomEvent('code_mode:snippet_error', {\n            snippet: snippet.name,\n            error: error instanceof Error ? error.message : String(error),\n            duration,\n            timestamp: Date.now(),\n          })\n\n          // Update stats (async, don't await)\n          storage.updateStats(snippet.name, false).catch(() => {\n            // Silently ignore stats update failures\n          })\n\n          throw error\n        }\n      },\n    }\n  }\n\n  return bindings\n}\n\n/**\n * Create a simple binding record for snippets without full sandbox execution.\n * This is used when snippets are being documented in the system prompt\n * but not yet being executed.\n */\nexport function snippetsToSimpleBindings(\n  snippets: Array<Snippet>,\n): Record<string, ToolBinding> {\n  const bindings: Record<string, ToolBinding> = {}\n\n  for (const snippet of snippets) {\n    const bindingName = `snippet_${snippet.name}`\n\n    bindings[bindingName] = {\n      name: bindingName,\n      description: snippet.description,\n      inputSchema: snippet.inputSchema,\n      outputSchema: snippet.outputSchema,\n      execute: () =>\n        Promise.reject(\n          new Error(\n            `Snippet ${snippet.name} is not available for execution in this context`,\n          ),\n        ),\n    }\n  }\n\n  return bindings\n}\n"],"mappings":";;;;;AA+BA,SAAgB,mBAAmB,EACjC,UACA,SACA,kBACA,WACyD;CACzD,MAAM,WAAwC,CAAC;CAE/C,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,cAAc,WAAW,QAAQ;EAEvC,SAAS,eAAe;GACtB,MAAM;GACN,aAAa,QAAQ;GACrB,aAAa,QAAQ;GACrB,cAAc,QAAQ;GACtB,SAAS,OAAO,UAAmB;IACjC,MAAM,YAAY,KAAK,IAAI;IAG3B,SAAS,gBAAgB,0BAA0B;KACjD,SAAS,QAAQ;KACjB;KACA,WAAW;IACb,CAAC;IAED,IAAI;KAOF,MAAM,SAAS,MAAM,iBAAiB;4BAJpB,KAAK,UAAU,KAAK,EAAE;cACpC,QAAQ,KAAK;aAGkC,KAAK;KACxD,MAAM,WAAW,KAAK,IAAI,IAAI;KAG9B,SAAS,gBAAgB,4BAA4B;MACnD,SAAS,QAAQ;MACjB;MACA;MACA,WAAW,KAAK,IAAI;KACtB,CAAC;KAGD,QAAQ,YAAY,QAAQ,MAAM,IAAI,CAAC,CAAC,YAAY,CAEpD,CAAC;KAED,OAAO;IACT,SAAS,OAAO;KACd,MAAM,WAAW,KAAK,IAAI,IAAI;KAG9B,SAAS,gBAAgB,2BAA2B;MAClD,SAAS,QAAQ;MACjB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;MAC5D;MACA,WAAW,KAAK,IAAI;KACtB,CAAC;KAGD,QAAQ,YAAY,QAAQ,MAAM,KAAK,CAAC,CAAC,YAAY,CAErD,CAAC;KAED,MAAM;IACR;GACF;EACF;CACF;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,yBACd,UAC6B;CAC7B,MAAM,WAAwC,CAAC;CAE/C,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,cAAc,WAAW,QAAQ;EAEvC,SAAS,eAAe;GACtB,MAAM;GACN,aAAa,QAAQ;GACrB,aAAa,QAAQ;GACrB,cAAc,QAAQ;GACtB,eACE,QAAQ,uBACN,IAAI,MACF,WAAW,QAAQ,KAAK,gDAC1B,CACF;EACJ;CACF;CAEA,OAAO;AACT"}

package/dist/esm/snippets-to-tools.d.ts

@@ -0,0 +1,74 @@
+import { SchemaInput, ServerTool } from '@tanstack/ai';
+import { CodeModeTool, IsolateDriver, ToolBinding } from '@tanstack/ai-code-mode';
+import { Snippet, SnippetStorage } from './types.js';
+/**
+ * Options for converting a single snippet to a tool
+ */
+export interface SnippetToToolOptions {
+    /**
+     * The snippet to convert
+     */
+    snippet: Snippet;
+    /**
+     * Isolate driver for executing snippet code
+     */
+    driver: IsolateDriver;
+    /**
+     * Pre-computed bindings for external_* functions
+     */
+    bindings: Record<string, ToolBinding>;
+    /**
+     * Storage for updating execution stats
+     */
+    storage: SnippetStorage;
+    /**
+     * Timeout for snippet execution in ms
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Memory limit in bytes
+     * @default 128
+     */
+    memoryLimit?: number;
+}
+interface SnippetsToToolsOptions {
+    /**
+     * Snippets to convert to tools
+     */
+    snippets: Array<Snippet>;
+    /**
+     * Isolate driver for executing snippet code
+     */
+    driver: IsolateDriver;
+    /**
+     * Original tools that become external_* bindings
+     * (so snippets can call external_* functions)
+     */
+    tools: Array<CodeModeTool>;
+    /**
+     * Storage for updating execution stats
+     */
+    storage: SnippetStorage;
+    /**
+     * Timeout for snippet execution in ms
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Memory limit in bytes
+     * @default 128
+     */
+    memoryLimit?: number;
+}
+/**
+ * Convert a single snippet to a ServerTool that the LLM can call directly.
+ * The snippet executes its code in the sandbox with access to external_* bindings.
+ */
+export declare function snippetToTool({ snippet, driver, bindings, storage, timeout, memoryLimit, }: SnippetToToolOptions): ServerTool<SchemaInput, SchemaInput, string>;
+/**
+ * Convert multiple snippets to ServerTools that the LLM can call directly.
+ * Snippets become real tools that execute their code in the sandbox.
+ */
+export declare function snippetsToTools({ snippets, driver, tools, storage, timeout, memoryLimit, }: SnippetsToToolsOptions): Array<ServerTool<SchemaInput, SchemaInput, string>>;
+export {};

package/dist/esm/snippets-to-tools.js

@@ -0,0 +1,147 @@
+import { createEventAwareBindings, stripTypeScript, toolsToBindings } from "@tanstack/ai-code-mode";
+import { toolDefinition } from "@tanstack/ai";
+import { z } from "zod";
+//#region src/snippets-to-tools.ts
+/**
+* Convert JSON Schema to Zod schema.
+* This is a simplified converter that handles common cases.
+*/
+function jsonSchemaToZod(schema) {
+	const type = schema.type;
+	if (type === "string") {
+		let zodString = z.string();
+		if (schema.description) zodString = zodString.describe(schema.description);
+		return zodString;
+	}
+	if (type === "number" || type === "integer") {
+		let zodNum = z.number();
+		if (schema.description) zodNum = zodNum.describe(schema.description);
+		return zodNum;
+	}
+	if (type === "boolean") {
+		let zodBool = z.boolean();
+		if (schema.description) zodBool = zodBool.describe(schema.description);
+		return zodBool;
+	}
+	if (type === "array") {
+		const items = schema.items;
+		if (items) return z.array(jsonSchemaToZod(items));
+		return z.array(z.unknown());
+	}
+	if (type === "object") {
+		const properties = schema.properties;
+		const required = schema.required ?? [];
+		if (properties) {
+			const shape = {};
+			for (const [key, propSchema] of Object.entries(properties)) {
+				let zodProp = jsonSchemaToZod(propSchema);
+				if (!required.includes(key)) zodProp = zodProp.optional();
+				shape[key] = zodProp;
+			}
+			return z.object(shape);
+		}
+		return z.record(z.string(), z.unknown());
+	}
+	return z.unknown();
+}
+/**
+* Convert a single snippet to a ServerTool that the LLM can call directly.
+* The snippet executes its code in the sandbox with access to external_* bindings.
+*/
+function snippetToTool({ snippet, driver, bindings, storage, timeout = 3e4, memoryLimit = 128 }) {
+	const inputSchema = jsonSchemaToZod(snippet.inputSchema);
+	const outputSchema = jsonSchemaToZod(snippet.outputSchema);
+	return toolDefinition({
+		name: snippet.name,
+		description: `[SNIPPET] ${snippet.description}`,
+		inputSchema,
+		outputSchema
+	}).server(async (input, context) => {
+		const startTime = Date.now();
+		const emitCustomEvent = context?.emitCustomEvent || (() => {});
+		emitCustomEvent("code_mode:snippet_call", {
+			snippet: snippet.name,
+			input,
+			timestamp: startTime
+		});
+		let isolateContext = null;
+		try {
+			console.log(`[Snippet:${snippet.name}] Starting execution with input:`, JSON.stringify(input).substring(0, 200));
+			const wrappedCode = `
+          const input = ${JSON.stringify(input)};
+          ${snippet.code}
+        `;
+			console.log(`[Snippet:${snippet.name}] Wrapped code (first 500 chars):`, wrappedCode.substring(0, 500));
+			const strippedCode = await stripTypeScript(wrappedCode);
+			console.log(`[Snippet:${snippet.name}] Stripped code (first 500 chars):`, strippedCode.substring(0, 500));
+			const eventAwareBindings = createEventAwareBindings(bindings, emitCustomEvent);
+			console.log(`[Snippet:${snippet.name}] Event-aware bindings:`, Object.keys(eventAwareBindings));
+			console.log(`[Snippet:${snippet.name}] Creating sandbox context...`);
+			isolateContext = await driver.createContext({
+				bindings: eventAwareBindings,
+				timeout,
+				memoryLimit
+			});
+			console.log(`[Snippet:${snippet.name}] Sandbox context created`);
+			console.log(`[Snippet:${snippet.name}] Executing code...`);
+			const executionResult = await isolateContext.execute(strippedCode);
+			console.log(`[Snippet:${snippet.name}] Execution result:`, {
+				success: executionResult.success,
+				hasValue: "value" in executionResult,
+				error: executionResult.error,
+				logs: executionResult.logs
+			});
+			const duration = Date.now() - startTime;
+			if (!executionResult.success) {
+				console.error(`[Snippet:${snippet.name}] Execution failed:`, executionResult.error);
+				throw new Error(executionResult.error?.message || "Snippet execution failed");
+			}
+			emitCustomEvent("code_mode:snippet_result", {
+				snippet: snippet.name,
+				result: executionResult.value,
+				duration,
+				timestamp: Date.now()
+			});
+			storage.updateStats(snippet.name, true).catch(() => {});
+			return executionResult.value;
+		} catch (error) {
+			const duration = Date.now() - startTime;
+			console.error(`[Snippet:${snippet.name}] CAUGHT ERROR:`, {
+				message: error instanceof Error ? error.message : String(error),
+				stack: error instanceof Error ? error.stack : void 0,
+				duration
+			});
+			emitCustomEvent("code_mode:snippet_error", {
+				snippet: snippet.name,
+				error: error instanceof Error ? error.message : String(error),
+				duration,
+				timestamp: Date.now()
+			});
+			storage.updateStats(snippet.name, false).catch(() => {});
+			throw error;
+		} finally {
+			if (isolateContext) await isolateContext.dispose();
+		}
+	});
+}
+/**
+* Convert multiple snippets to ServerTools that the LLM can call directly.
+* Snippets become real tools that execute their code in the sandbox.
+*/
+function snippetsToTools({ snippets, driver, tools, storage, timeout = 3e4, memoryLimit = 128 }) {
+	console.log("[SnippetsToTools] Creating bindings from tools:", tools.map((t) => t.name));
+	const bindings = toolsToBindings(tools, "external_");
+	console.log("[SnippetsToTools] Created bindings:", Object.keys(bindings));
+	return snippets.map((snippet) => snippetToTool({
+		snippet,
+		driver,
+		bindings,
+		storage,
+		timeout,
+		memoryLimit
+	}));
+}
+//#endregion
+export { snippetToTool, snippetsToTools };
+
+//# sourceMappingURL=snippets-to-tools.js.map

package/dist/esm/snippets-to-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets-to-tools.js","names":[],"sources":["../../src/snippets-to-tools.ts"],"sourcesContent":["import { toolDefinition } from '@tanstack/ai'\nimport {\n  createEventAwareBindings,\n  stripTypeScript,\n  toolsToBindings,\n} from '@tanstack/ai-code-mode'\nimport { z } from 'zod'\nimport type {\n  SchemaInput,\n  ServerTool,\n  ToolExecutionContext,\n} from '@tanstack/ai'\nimport type {\n  CodeModeTool,\n  IsolateDriver,\n  ToolBinding,\n} from '@tanstack/ai-code-mode'\nimport type { Snippet, SnippetStorage } from './types'\n\n/**\n * Options for converting a single snippet to a tool\n */\nexport interface SnippetToToolOptions {\n  /**\n   * The snippet to convert\n   */\n  snippet: Snippet\n\n  /**\n   * Isolate driver for executing snippet code\n   */\n  driver: IsolateDriver\n\n  /**\n   * Pre-computed bindings for external_* functions\n   */\n  bindings: Record<string, ToolBinding>\n\n  /**\n   * Storage for updating execution stats\n   */\n  storage: SnippetStorage\n\n  /**\n   * Timeout for snippet execution in ms\n   * @default 30000\n   */\n  timeout?: number\n\n  /**\n   * Memory limit in bytes\n   * @default 128\n   */\n  memoryLimit?: number\n}\n\ninterface SnippetsToToolsOptions {\n  /**\n   * Snippets to convert to tools\n   */\n  snippets: Array<Snippet>\n\n  /**\n   * Isolate driver for executing snippet code\n   */\n  driver: IsolateDriver\n\n  /**\n   * Original tools that become external_* bindings\n   * (so snippets can call external_* functions)\n   */\n  tools: Array<CodeModeTool>\n\n  /**\n   * Storage for updating execution stats\n   */\n  storage: SnippetStorage\n\n  /**\n   * Timeout for snippet execution in ms\n   * @default 30000\n   */\n  timeout?: number\n\n  /**\n   * Memory limit in bytes\n   * @default 128\n   */\n  memoryLimit?: number\n}\n\n/**\n * Convert JSON Schema to Zod schema.\n * This is a simplified converter that handles common cases.\n */\nfunction jsonSchemaToZod(schema: Record<string, unknown>): z.ZodType {\n  const type = schema.type as string\n\n  if (type === 'string') {\n    let zodString = z.string()\n    if (schema.description) {\n      zodString = zodString.describe(schema.description as string)\n    }\n    return zodString\n  }\n  if (type === 'number' || type === 'integer') {\n    let zodNum = z.number()\n    if (schema.description) {\n      zodNum = zodNum.describe(schema.description as string)\n    }\n    return zodNum\n  }\n  if (type === 'boolean') {\n    let zodBool = z.boolean()\n    if (schema.description) {\n      zodBool = zodBool.describe(schema.description as string)\n    }\n    return zodBool\n  }\n  if (type === 'array') {\n    const items = schema.items as Record<string, unknown> | undefined\n    if (items) {\n      return z.array(jsonSchemaToZod(items))\n    }\n    return z.array(z.unknown())\n  }\n  if (type === 'object') {\n    const properties = schema.properties as\n      | Record<string, Record<string, unknown>>\n      | undefined\n    const required = (schema.required as Array<string> | undefined) ?? []\n\n    if (properties) {\n      const shape: Record<string, z.ZodType> = {}\n      for (const [key, propSchema] of Object.entries(properties)) {\n        let zodProp = jsonSchemaToZod(propSchema)\n        if (!required.includes(key)) {\n          zodProp = zodProp.optional()\n        }\n        shape[key] = zodProp\n      }\n      return z.object(shape)\n    }\n    return z.record(z.string(), z.unknown())\n  }\n\n  // Fallback\n  return z.unknown()\n}\n\n/**\n * Convert a single snippet to a ServerTool that the LLM can call directly.\n * The snippet executes its code in the sandbox with access to external_* bindings.\n */\nexport function snippetToTool({\n  snippet,\n  driver,\n  bindings,\n  storage,\n  timeout = 30000,\n  memoryLimit = 128,\n}: SnippetToToolOptions): ServerTool<SchemaInput, SchemaInput, string> {\n  // Generate input and output schemas from JSON Schema\n  const inputSchema = jsonSchemaToZod(snippet.inputSchema)\n  const outputSchema = jsonSchemaToZod(snippet.outputSchema)\n\n  return toolDefinition({\n    name: snippet.name,\n    description: `[SNIPPET] ${snippet.description}`,\n    inputSchema,\n    outputSchema,\n  }).server(async (input: unknown, context?: ToolExecutionContext) => {\n    const startTime = Date.now()\n    const emitCustomEvent = context?.emitCustomEvent || (() => {})\n\n    // Emit snippet call event\n    emitCustomEvent('code_mode:snippet_call', {\n      snippet: snippet.name,\n      input,\n      timestamp: startTime,\n    })\n\n    let isolateContext = null\n\n    try {\n      console.log(\n        `[Snippet:${snippet.name}] Starting execution with input:`,\n        JSON.stringify(input).substring(0, 200),\n      )\n\n      // Wrap the snippet code to receive input as a variable\n      const wrappedCode = `\n          const input = ${JSON.stringify(input)};\n          ${snippet.code}\n        `\n      console.log(\n        `[Snippet:${snippet.name}] Wrapped code (first 500 chars):`,\n        wrappedCode.substring(0, 500),\n      )\n\n      // Strip TypeScript to JavaScript\n      const strippedCode = await stripTypeScript(wrappedCode)\n      console.log(\n        `[Snippet:${snippet.name}] Stripped code (first 500 chars):`,\n        strippedCode.substring(0, 500),\n      )\n\n      // Create event-aware bindings\n      const eventAwareBindings = createEventAwareBindings(\n        bindings,\n        emitCustomEvent,\n      )\n      console.log(\n        `[Snippet:${snippet.name}] Event-aware bindings:`,\n        Object.keys(eventAwareBindings),\n      )\n\n      // Create sandbox context\n      console.log(`[Snippet:${snippet.name}] Creating sandbox context...`)\n      isolateContext = await driver.createContext({\n        bindings: eventAwareBindings,\n        timeout,\n        memoryLimit,\n      })\n      console.log(`[Snippet:${snippet.name}] Sandbox context created`)\n\n      // Execute the code\n      console.log(`[Snippet:${snippet.name}] Executing code...`)\n      const executionResult = await isolateContext.execute(strippedCode)\n      console.log(`[Snippet:${snippet.name}] Execution result:`, {\n        success: executionResult.success,\n        hasValue: 'value' in executionResult,\n        error: executionResult.error,\n        logs: executionResult.logs,\n      })\n\n      const duration = Date.now() - startTime\n\n      if (!executionResult.success) {\n        console.error(\n          `[Snippet:${snippet.name}] Execution failed:`,\n          executionResult.error,\n        )\n        throw new Error(\n          executionResult.error?.message || 'Snippet execution failed',\n        )\n      }\n\n      // Emit success event\n      emitCustomEvent('code_mode:snippet_result', {\n        snippet: snippet.name,\n        result: executionResult.value,\n        duration,\n        timestamp: Date.now(),\n      })\n\n      // Update stats (async, don't await to not block)\n      storage.updateStats(snippet.name, true).catch(() => {\n        // Silently ignore stats update failures\n      })\n\n      return executionResult.value\n    } catch (error) {\n      const duration = Date.now() - startTime\n      console.error(`[Snippet:${snippet.name}] CAUGHT ERROR:`, {\n        message: error instanceof Error ? error.message : String(error),\n        stack: error instanceof Error ? error.stack : undefined,\n        duration,\n      })\n\n      // Emit error event\n      emitCustomEvent('code_mode:snippet_error', {\n        snippet: snippet.name,\n        error: error instanceof Error ? error.message : String(error),\n        duration,\n        timestamp: Date.now(),\n      })\n\n      // Update stats (async, don't await)\n      storage.updateStats(snippet.name, false).catch(() => {\n        // Silently ignore stats update failures\n      })\n\n      throw error\n    } finally {\n      if (isolateContext) {\n        await isolateContext.dispose()\n      }\n    }\n  })\n}\n\n/**\n * Convert multiple snippets to ServerTools that the LLM can call directly.\n * Snippets become real tools that execute their code in the sandbox.\n */\nexport function snippetsToTools({\n  snippets,\n  driver,\n  tools,\n  storage,\n  timeout = 30000,\n  memoryLimit = 128,\n}: SnippetsToToolsOptions): Array<\n  ServerTool<SchemaInput, SchemaInput, string>\n> {\n  // Pre-compute bindings from tools (these are shared across all snippet executions)\n  console.log(\n    '[SnippetsToTools] Creating bindings from tools:',\n    tools.map((t) => t.name),\n  )\n  const bindings = toolsToBindings(tools, 'external_')\n  console.log('[SnippetsToTools] Created bindings:', Object.keys(bindings))\n\n  return snippets.map((snippet) =>\n    snippetToTool({\n      snippet,\n      driver,\n      bindings,\n      storage,\n      timeout,\n      memoryLimit,\n    }),\n  )\n}\n"],"mappings":"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"}

package/dist/esm/storage/file-storage.d.ts

@@ -0,0 +1,27 @@
+import { SnippetStorage } from '../types.js';
+import { TrustStrategy } from '../trust-strategies.js';
+export interface FileSnippetStorageOptions {
+    /**
+     * Directory path for storing snippets
+     */
+    directory: string;
+    /**
+     * Trust strategy for determining snippet trust levels
+     * @default createDefaultTrustStrategy()
+     */
+    trustStrategy?: TrustStrategy;
+}
+/**
+ * File-system based snippet storage
+ *
+ * Directory structure:
+ *   .snippets/
+ *     _index.json          # Fast catalog loading
+ *     fetch_github_stats/
+ *       meta.json          # Metadata (description, schemas, hints, stats)
+ *       code.ts            # The actual TypeScript code
+ *     deploy_to_prod/
+ *       meta.json
+ *       code.ts
+ */
+export declare function createFileSnippetStorage(directoryOrOptions: string | FileSnippetStorageOptions): SnippetStorage;

package/dist/esm/storage/file-storage.js

@@ -0,0 +1,155 @@
+import { createDefaultTrustStrategy } from "../trust-strategies.js";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+//#region src/storage/file-storage.ts
+/**
+* File-system based snippet storage
+*
+* Directory structure:
+*   .snippets/
+*     _index.json          # Fast catalog loading
+*     fetch_github_stats/
+*       meta.json          # Metadata (description, schemas, hints, stats)
+*       code.ts            # The actual TypeScript code
+*     deploy_to_prod/
+*       meta.json
+*       code.ts
+*/
+function createFileSnippetStorage(directoryOrOptions) {
+	const { directory, trustStrategy = createDefaultTrustStrategy() } = typeof directoryOrOptions === "string" ? { directory: directoryOrOptions } : directoryOrOptions;
+	const indexPath = join(directory, "_index.json");
+	console.log("[FileSnippetStorage] Initialized with directory:", directory);
+	const SAFE_SNIPPET_NAME = /^[A-Za-z0-9_-]+$/;
+	function isSafeSnippetName(name) {
+		return typeof name === "string" && SAFE_SNIPPET_NAME.test(name);
+	}
+	function assertSafeSnippetName(name) {
+		if (!isSafeSnippetName(name)) throw new Error(`Invalid snippet name ${JSON.stringify(name)}: names must match /^[A-Za-z0-9_-]+$/ (no path separators or traversal).`);
+	}
+	async function ensureDirectory() {
+		if (!existsSync(directory)) {
+			console.log("[FileSnippetStorage] Creating directory:", directory);
+			await mkdir(directory, { recursive: true });
+		}
+	}
+	async function loadIndex() {
+		await ensureDirectory();
+		if (!existsSync(indexPath)) return [];
+		const content = await readFile(indexPath, "utf-8");
+		return JSON.parse(content);
+	}
+	async function loadAll() {
+		const index = await loadIndex();
+		const snippets = [];
+		for (const entry of index) {
+			const snippet = await get(entry.name);
+			if (snippet) snippets.push(snippet);
+		}
+		return snippets;
+	}
+	async function saveIndex(index) {
+		await writeFile(indexPath, JSON.stringify(index, null, 2));
+	}
+	async function get(name) {
+		if (!isSafeSnippetName(name)) return null;
+		const snippetDir = join(directory, name);
+		const metaPath = join(snippetDir, "meta.json");
+		const codePath = join(snippetDir, "code.ts");
+		if (!existsSync(metaPath)) return null;
+		const [metaContent, code] = await Promise.all([readFile(metaPath, "utf-8"), readFile(codePath, "utf-8")]);
+		return {
+			...JSON.parse(metaContent),
+			code
+		};
+	}
+	async function save(snippet) {
+		assertSafeSnippetName(snippet.name);
+		await ensureDirectory();
+		const snippetDir = join(directory, snippet.name);
+		const metaPath = join(snippetDir, "meta.json");
+		const codePath = join(snippetDir, "code.ts");
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const existing = await get(snippet.name);
+		const fullSnippet = {
+			...snippet,
+			createdAt: existing?.createdAt ?? now,
+			updatedAt: now
+		};
+		const { code, ...meta } = fullSnippet;
+		await mkdir(snippetDir, { recursive: true });
+		await Promise.all([writeFile(metaPath, JSON.stringify(meta, null, 2)), writeFile(codePath, code)]);
+		const index = await loadIndex();
+		const indexEntry = {
+			id: fullSnippet.id,
+			name: fullSnippet.name,
+			description: fullSnippet.description,
+			usageHints: fullSnippet.usageHints,
+			trustLevel: fullSnippet.trustLevel
+		};
+		const existingIdx = index.findIndex((s) => s.name === snippet.name);
+		if (existingIdx >= 0) index[existingIdx] = indexEntry;
+		else index.push(indexEntry);
+		await saveIndex(index);
+		return fullSnippet;
+	}
+	async function deleteSnippet(name) {
+		assertSafeSnippetName(name);
+		const snippetDir = join(directory, name);
+		if (!existsSync(snippetDir)) return false;
+		await rm(snippetDir, { recursive: true });
+		await saveIndex((await loadIndex()).filter((s) => s.name !== name));
+		return true;
+	}
+	async function search(query, searchOptions = {}) {
+		const { limit = 5 } = searchOptions;
+		const index = await loadIndex();
+		const terms = query.toLowerCase().split(/\s+/);
+		return index.map((snippet) => {
+			let score = 0;
+			const searchText = [
+				snippet.name,
+				snippet.description,
+				...snippet.usageHints
+			].join(" ").toLowerCase();
+			for (const term of terms) {
+				if (searchText.includes(term)) score += 1;
+				if (snippet.name.toLowerCase().includes(term)) score += 2;
+			}
+			return {
+				snippet,
+				score
+			};
+		}).filter((s) => s.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((s) => s.snippet);
+	}
+	async function updateStats(name, success) {
+		const snippet = await get(name);
+		if (!snippet) return;
+		const { executions, successRate } = snippet.stats;
+		const newExecutions = executions + 1;
+		const newStats = {
+			executions: newExecutions,
+			successRate: (successRate * executions + (success ? 1 : 0)) / newExecutions
+		};
+		const newTrustLevel = trustStrategy.calculateTrustLevel(snippet.trustLevel, newStats);
+		await save({
+			...snippet,
+			stats: newStats,
+			trustLevel: newTrustLevel
+		});
+	}
+	return {
+		loadIndex,
+		loadAll,
+		get,
+		save,
+		delete: deleteSnippet,
+		search,
+		updateStats,
+		trustStrategy
+	};
+}
+//#endregion
+export { createFileSnippetStorage };
+
+//# sourceMappingURL=file-storage.js.map

package/dist/esm/storage/file-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.js","names":[],"sources":["../../../src/storage/file-storage.ts"],"sourcesContent":["import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport { existsSync } from 'node:fs'\nimport { createDefaultTrustStrategy } from '../trust-strategies'\nimport type {\n  Snippet,\n  SnippetIndexEntry,\n  SnippetSearchOptions,\n  SnippetStorage,\n} from '../types'\nimport type { TrustStrategy } from '../trust-strategies'\n\nexport interface FileSnippetStorageOptions {\n  /**\n   * Directory path for storing snippets\n   */\n  directory: string\n\n  /**\n   * Trust strategy for determining snippet trust levels\n   * @default createDefaultTrustStrategy()\n   */\n  trustStrategy?: TrustStrategy\n}\n\n/**\n * File-system based snippet storage\n *\n * Directory structure:\n *   .snippets/\n *     _index.json          # Fast catalog loading\n *     fetch_github_stats/\n *       meta.json          # Metadata (description, schemas, hints, stats)\n *       code.ts            # The actual TypeScript code\n *     deploy_to_prod/\n *       meta.json\n *       code.ts\n */\nexport function createFileSnippetStorage(\n  directoryOrOptions: string | FileSnippetStorageOptions,\n): SnippetStorage {\n  const options =\n    typeof directoryOrOptions === 'string'\n      ? { directory: directoryOrOptions }\n      : directoryOrOptions\n\n  const { directory, trustStrategy = createDefaultTrustStrategy() } = options\n  const indexPath = join(directory, '_index.json')\n\n  console.log('[FileSnippetStorage] Initialized with directory:', directory)\n\n  // Snippet names are used both as on-disk directory segments and as\n  // `snippet_<name>` sandbox tool names, so they must be a single safe\n  // identifier segment. Rejecting anything else keeps an LLM-supplied name\n  // (e.g. `../../etc`) from escaping `directory` during read/write/delete.\n  const SAFE_SNIPPET_NAME = /^[A-Za-z0-9_-]+$/\n\n  function isSafeSnippetName(name: string): boolean {\n    return typeof name === 'string' && SAFE_SNIPPET_NAME.test(name)\n  }\n\n  function assertSafeSnippetName(name: string): void {\n    if (!isSafeSnippetName(name)) {\n      throw new Error(\n        `Invalid snippet name ${JSON.stringify(\n          name,\n        )}: names must match /^[A-Za-z0-9_-]+$/ (no path separators or traversal).`,\n      )\n    }\n  }\n\n  async function ensureDirectory(): Promise<void> {\n    if (!existsSync(directory)) {\n      console.log('[FileSnippetStorage] Creating directory:', directory)\n      await mkdir(directory, { recursive: true })\n    }\n  }\n\n  async function loadIndex(): Promise<Array<SnippetIndexEntry>> {\n    await ensureDirectory()\n\n    if (!existsSync(indexPath)) {\n      return []\n    }\n\n    const content = await readFile(indexPath, 'utf-8')\n    return JSON.parse(content) as Array<SnippetIndexEntry>\n  }\n\n  async function loadAll(): Promise<Array<Snippet>> {\n    const index = await loadIndex()\n    const snippets: Array<Snippet> = []\n\n    for (const entry of index) {\n      const snippet = await get(entry.name)\n      if (snippet) {\n        snippets.push(snippet)\n      }\n    }\n\n    return snippets\n  }\n\n  async function saveIndex(index: Array<SnippetIndexEntry>): Promise<void> {\n    await writeFile(indexPath, JSON.stringify(index, null, 2))\n  }\n\n  async function get(name: string): Promise<Snippet | null> {\n    // Treat an unsafe name as \"not found\" rather than reading outside `directory`.\n    if (!isSafeSnippetName(name)) {\n      return null\n    }\n\n    const snippetDir = join(directory, name)\n    const metaPath = join(snippetDir, 'meta.json')\n    const codePath = join(snippetDir, 'code.ts')\n\n    if (!existsSync(metaPath)) {\n      return null\n    }\n\n    const [metaContent, code] = await Promise.all([\n      readFile(metaPath, 'utf-8'),\n      readFile(codePath, 'utf-8'),\n    ])\n\n    const meta = JSON.parse(metaContent) as Omit<Snippet, 'code'>\n    return { ...meta, code }\n  }\n\n  async function save(\n    snippet: Omit<Snippet, 'createdAt' | 'updatedAt'>,\n  ): Promise<Snippet> {\n    assertSafeSnippetName(snippet.name)\n    await ensureDirectory()\n\n    const snippetDir = join(directory, snippet.name)\n    const metaPath = join(snippetDir, 'meta.json')\n    const codePath = join(snippetDir, 'code.ts')\n\n    const now = new Date().toISOString()\n    const existing = await get(snippet.name)\n\n    const fullSnippet: Snippet = {\n      ...snippet,\n      createdAt: existing?.createdAt ?? now,\n      updatedAt: now,\n    }\n\n    // Separate code from metadata\n    const { code, ...meta } = fullSnippet\n\n    // Write snippet files\n    await mkdir(snippetDir, { recursive: true })\n    await Promise.all([\n      writeFile(metaPath, JSON.stringify(meta, null, 2)),\n      writeFile(codePath, code),\n    ])\n\n    // Update index\n    const index = await loadIndex()\n    const indexEntry: SnippetIndexEntry = {\n      id: fullSnippet.id,\n      name: fullSnippet.name,\n      description: fullSnippet.description,\n      usageHints: fullSnippet.usageHints,\n      trustLevel: fullSnippet.trustLevel,\n    }\n\n    const existingIdx = index.findIndex((s) => s.name === snippet.name)\n    if (existingIdx >= 0) {\n      index[existingIdx] = indexEntry\n    } else {\n      index.push(indexEntry)\n    }\n    await saveIndex(index)\n\n    return fullSnippet\n  }\n\n  async function deleteSnippet(name: string): Promise<boolean> {\n    assertSafeSnippetName(name)\n\n    const snippetDir = join(directory, name)\n\n    if (!existsSync(snippetDir)) {\n      return false\n    }\n\n    await rm(snippetDir, { recursive: true })\n\n    // Update index\n    const index = await loadIndex()\n    const filtered = index.filter((s) => s.name !== name)\n    await saveIndex(filtered)\n\n    return true\n  }\n\n  async function search(\n    query: string,\n    searchOptions: SnippetSearchOptions = {},\n  ): Promise<Array<SnippetIndexEntry>> {\n    const { limit = 5 } = searchOptions\n    const index = await loadIndex()\n\n    // Simple text matching - can be replaced with embeddings\n    const queryLower = query.toLowerCase()\n    const terms = queryLower.split(/\\s+/)\n\n    const scored = index.map((snippet) => {\n      let score = 0\n      const searchText = [\n        snippet.name,\n        snippet.description,\n        ...snippet.usageHints,\n      ]\n        .join(' ')\n        .toLowerCase()\n\n      for (const term of terms) {\n        if (searchText.includes(term)) {\n          score += 1\n        }\n        // Boost exact name matches\n        if (snippet.name.toLowerCase().includes(term)) {\n          score += 2\n        }\n      }\n\n      return { snippet, score }\n    })\n\n    return scored\n      .filter((s) => s.score > 0)\n      .sort((a, b) => b.score - a.score)\n      .slice(0, limit)\n      .map((s) => s.snippet)\n  }\n\n  async function updateStats(name: string, success: boolean): Promise<void> {\n    const snippet = await get(name)\n    if (!snippet) return\n\n    const { executions, successRate } = snippet.stats\n    const newExecutions = executions + 1\n    const newSuccessRate =\n      (successRate * executions + (success ? 1 : 0)) / newExecutions\n\n    const newStats = { executions: newExecutions, successRate: newSuccessRate }\n\n    // Use trust strategy to calculate new trust level\n    const newTrustLevel = trustStrategy.calculateTrustLevel(\n      snippet.trustLevel,\n      newStats,\n    )\n\n    await save({\n      ...snippet,\n      stats: newStats,\n      trustLevel: newTrustLevel,\n    })\n  }\n\n  return {\n    loadIndex,\n    loadAll,\n    get,\n    save,\n    delete: deleteSnippet,\n    search,\n    updateStats,\n    trustStrategy,\n  }\n}\n"],"mappings":"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"}

package/dist/esm/storage/index.d.ts

@@ -0,0 +1,3 @@
+export { createFileSnippetStorage } from './file-storage.js';
+export { createMemorySnippetStorage } from './memory-storage.js';
+export type { SnippetStorage, Snippet, SnippetIndexEntry } from '../types.js';

package/dist/esm/storage/index.js

@@ -0,0 +1,3 @@
+import { createMemorySnippetStorage } from "./memory-storage.js";
+import { createFileSnippetStorage } from "./file-storage.js";
+export { createFileSnippetStorage, createMemorySnippetStorage };

package/dist/esm/storage/memory-storage.d.ts

@@ -0,0 +1,17 @@
+import { Snippet, SnippetStorage } from '../types.js';
+import { TrustStrategy } from '../trust-strategies.js';
+export interface MemorySnippetStorageOptions {
+    /**
+     * Initial snippets to populate the storage with
+     */
+    initialSnippets?: Array<Snippet>;
+    /**
+     * Trust strategy for determining snippet trust levels
+     * @default createDefaultTrustStrategy()
+     */
+    trustStrategy?: TrustStrategy;
+}
+/**
+ * In-memory snippet storage for testing and demos
+ */
+export declare function createMemorySnippetStorage(optionsOrSnippets?: MemorySnippetStorageOptions | Array<Snippet>): SnippetStorage;

package/dist/esm/storage/memory-storage.js

@@ -0,0 +1,100 @@
+import { createDefaultTrustStrategy } from "../trust-strategies.js";
+//#region src/storage/memory-storage.ts
+/**
+* In-memory snippet storage for testing and demos
+*/
+function createMemorySnippetStorage(optionsOrSnippets = []) {
+	const { initialSnippets = [], trustStrategy = createDefaultTrustStrategy() } = Array.isArray(optionsOrSnippets) ? { initialSnippets: optionsOrSnippets } : optionsOrSnippets;
+	const snippets = /* @__PURE__ */ new Map();
+	for (const snippet of initialSnippets) snippets.set(snippet.name, snippet);
+	function loadIndex() {
+		return Promise.resolve(Array.from(snippets.values()).map((snippet) => ({
+			id: snippet.id,
+			name: snippet.name,
+			description: snippet.description,
+			usageHints: snippet.usageHints,
+			trustLevel: snippet.trustLevel
+		})));
+	}
+	function loadAll() {
+		return Promise.resolve(Array.from(snippets.values()));
+	}
+	function get(name) {
+		return Promise.resolve(snippets.get(name) ?? null);
+	}
+	function save(snippet) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const existing = snippets.get(snippet.name);
+		const fullSnippet = {
+			...snippet,
+			createdAt: existing?.createdAt ?? now,
+			updatedAt: now
+		};
+		snippets.set(snippet.name, fullSnippet);
+		return Promise.resolve(fullSnippet);
+	}
+	function deleteSnippet(name) {
+		if (!snippets.has(name)) return Promise.resolve(false);
+		snippets.delete(name);
+		return Promise.resolve(true);
+	}
+	function search(query, searchOptions = {}) {
+		const { limit = 5 } = searchOptions;
+		const terms = query.toLowerCase().split(/\s+/);
+		const scored = Array.from(snippets.values()).map((snippet) => {
+			let score = 0;
+			const searchText = [
+				snippet.name,
+				snippet.description,
+				...snippet.usageHints
+			].join(" ").toLowerCase();
+			for (const term of terms) {
+				if (searchText.includes(term)) score += 1;
+				if (snippet.name.toLowerCase().includes(term)) score += 2;
+			}
+			return {
+				snippet,
+				score
+			};
+		});
+		return Promise.resolve(scored.filter((s) => s.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((s) => ({
+			id: s.snippet.id,
+			name: s.snippet.name,
+			description: s.snippet.description,
+			usageHints: s.snippet.usageHints,
+			trustLevel: s.snippet.trustLevel
+		})));
+	}
+	function updateStats(name, success) {
+		const snippet = snippets.get(name);
+		if (!snippet) return Promise.resolve();
+		const { executions, successRate } = snippet.stats;
+		const newExecutions = executions + 1;
+		const newStats = {
+			executions: newExecutions,
+			successRate: (successRate * executions + (success ? 1 : 0)) / newExecutions
+		};
+		const newTrustLevel = trustStrategy.calculateTrustLevel(snippet.trustLevel, newStats);
+		snippets.set(name, {
+			...snippet,
+			stats: newStats,
+			trustLevel: newTrustLevel,
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		return Promise.resolve();
+	}
+	return {
+		loadIndex,
+		loadAll,
+		get,
+		save,
+		delete: deleteSnippet,
+		search,
+		updateStats,
+		trustStrategy
+	};
+}
+//#endregion
+export { createMemorySnippetStorage };
+
+//# sourceMappingURL=memory-storage.js.map