code-mode-core 2.0.0

package/dist/schema-to-ts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @code-mode/core — JSON Schema to TypeScript converter
+ *
+ * Adapted from @utcp/code-mode (CodeModeUtcpClient) by UTCP Contributors.
+ * Original: https://github.com/universal-tool-calling-protocol/code-mode
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+import type { JsonSchemaLike } from './types';
+/** Tool-like shape expected by the converter. */
+export interface ToolLike {
+    name: string;
+    description: string;
+    inputs: JsonSchemaLike;
+    outputs: JsonSchemaLike;
+    tags: string[];
+}
+/** Sanitize a name to be a valid, safe TypeScript identifier. */
+export declare function sanitizeIdentifier(name: string): string;
+/** Escape text for safe use in JSDoc comments. */
+export declare function escapeComment(text: string): string;
+/** Convert a JSON Schema to an inline TypeScript type string. */
+export declare function jsonSchemaToTypeScriptType(schema: JsonSchemaLike): string;
+/** Convert a Tool to its TypeScript interface string (cached). */
+export declare function toolToTypeScriptInterface(tool: ToolLike): string;
+/** Generate TypeScript interfaces for all tools. */
+export declare function getAllToolsTypeScriptInterfaces(tools: ToolLike[]): string;
+/** Clear the interface cache (e.g., when tools change). */
+export declare function clearInterfaceCache(): void;
+//# sourceMappingURL=schema-to-ts.d.ts.map

package/dist/schema-to-ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-ts.d.ts","sourceRoot":"","sources":["../src/schema-to-ts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAYD,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAgBD,iEAAiE;AACjE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyCzE;AAgGD,kEAAkE;AAClE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAkDhE;AAED,oDAAoD;AACpD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAKzE;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/schema-to-ts.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * @code-mode/core — JSON Schema to TypeScript converter
+ *
+ * Adapted from @utcp/code-mode (CodeModeUtcpClient) by UTCP Contributors.
+ * Original: https://github.com/universal-tool-calling-protocol/code-mode
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeIdentifier = sanitizeIdentifier;
+exports.escapeComment = escapeComment;
+exports.jsonSchemaToTypeScriptType = jsonSchemaToTypeScriptType;
+exports.toolToTypeScriptInterface = toolToTypeScriptInterface;
+exports.getAllToolsTypeScriptInterfaces = getAllToolsTypeScriptInterfaces;
+exports.clearInterfaceCache = clearInterfaceCache;
+const MAX_CACHE_SIZE = 16;
+const interfaceCache = new Map();
+// Names that would pollute the global/prototype chain if set on `global`
+const RESERVED_NAMES = new Set([
+    '__proto__', 'constructor', 'prototype', 'toString', 'valueOf',
+    'hasOwnProperty', '__defineGetter__', '__defineSetter__',
+    '__lookupGetter__', '__lookupSetter__', 'global',
+]);
+/** Sanitize a name to be a valid, safe TypeScript identifier. */
+function sanitizeIdentifier(name) {
+    const id = name
+        .replace(/[^a-zA-Z0-9_]/g, '_')
+        .replace(/^[0-9]/, '_$&');
+    return RESERVED_NAMES.has(id) ? `_${id}` : id;
+}
+/** Escape text for safe use in JSDoc comments. */
+function escapeComment(text) {
+    return text.replace(/\*\//g, '*\\/').replace(/\n/g, ' ');
+}
+/** Map a JSON Schema type string to a TypeScript type. */
+function mapJsonTypeToTS(type) {
+    switch (type) {
+        case 'string': return 'string';
+        case 'number':
+        case 'integer': return 'number';
+        case 'boolean': return 'boolean';
+        case 'null': return 'null';
+        case 'object': return 'object';
+        case 'array': return 'any[]';
+        default: return 'any';
+    }
+}
+/** Convert a JSON Schema to an inline TypeScript type string. */
+function jsonSchemaToTypeScriptType(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return 'any';
+    }
+    if (schema.enum) {
+        return schema.enum.map(val => typeof val === 'string' ? JSON.stringify(val) : String(val)).join(' | ');
+    }
+    switch (schema.type) {
+        case 'object':
+            if (!schema.properties)
+                return '{ [key: string]: any }';
+            const props = Object.entries(schema.properties).map(([key, propSchema]) => {
+                const isRequired = schema.required?.includes(key) ?? false;
+                const optional = isRequired ? '' : '?';
+                const propType = jsonSchemaToTypeScriptType(propSchema);
+                return `${key}${optional}: ${propType}`;
+            }).join('; ');
+            return `{ ${props} }`;
+        case 'array':
+            if (!schema.items)
+                return 'any[]';
+            const itemType = Array.isArray(schema.items)
+                ? schema.items.map(item => jsonSchemaToTypeScriptType(item)).join(' | ')
+                : jsonSchemaToTypeScriptType(schema.items);
+            return `(${itemType})[]`;
+        case 'string': return 'string';
+        case 'number':
+        case 'integer': return 'number';
+        case 'boolean': return 'boolean';
+        case 'null': return 'null';
+        default:
+            if (Array.isArray(schema.type)) {
+                return schema.type.map(t => mapJsonTypeToTS(t)).join(' | ');
+            }
+            return 'any';
+    }
+}
+/** Convert a JSON Schema to TypeScript object content (properties only). */
+function jsonSchemaToObjectContent(schema) {
+    if (!schema || typeof schema !== 'object' || schema.type !== 'object') {
+        return '    [key: string]: any;';
+    }
+    const properties = schema.properties || {};
+    const required = schema.required || [];
+    const lines = [];
+    for (const [propName, propSchema] of Object.entries(properties)) {
+        const isRequired = required.includes(propName);
+        const optionalMarker = isRequired ? '' : '?';
+        const description = propSchema.description || '';
+        const tsType = jsonSchemaToTypeScriptType(propSchema);
+        if (description) {
+            lines.push(`    /** ${escapeComment(description)} */`);
+        }
+        lines.push(`    ${propName}${optionalMarker}: ${tsType};`);
+    }
+    return lines.length > 0 ? lines.join('\n') : '    [key: string]: any;';
+}
+/** Convert a JSON Schema to a full TypeScript type definition. */
+function jsonSchemaToTypeScript(schema, typeName) {
+    if (!schema || typeof schema !== 'object') {
+        return `type ${typeName} = any;`;
+    }
+    switch (schema.type) {
+        case 'object':
+            return objectSchemaToTypeScript(schema, typeName);
+        case 'array':
+            return arraySchemaToTypeScript(schema, typeName);
+        case 'string':
+            return primitiveSchemaToTypeScript(schema, typeName, 'string');
+        case 'number':
+        case 'integer':
+            return primitiveSchemaToTypeScript(schema, typeName, 'number');
+        case 'boolean':
+            return primitiveSchemaToTypeScript(schema, typeName, 'boolean');
+        case 'null':
+            return `type ${typeName} = null;`;
+        default:
+            if (Array.isArray(schema.type)) {
+                const types = schema.type.map(t => mapJsonTypeToTS(t)).join(' | ');
+                return `type ${typeName} = ${types};`;
+            }
+            return `type ${typeName} = any;`;
+    }
+}
+function objectSchemaToTypeScript(schema, typeName) {
+    if (!schema.properties) {
+        return `interface ${typeName} {\n  [key: string]: any;\n}`;
+    }
+    const properties = Object.entries(schema.properties).map(([key, propSchema]) => {
+        const isRequired = schema.required?.includes(key) ?? false;
+        const optional = isRequired ? '' : '?';
+        const propType = jsonSchemaToTypeScriptType(propSchema);
+        const description = propSchema.description ? `  /** ${escapeComment(propSchema.description)} */\n` : '';
+        return `${description}  ${key}${optional}: ${propType};`;
+    }).join('\n');
+    return `interface ${typeName} {\n${properties}\n}`;
+}
+function arraySchemaToTypeScript(schema, typeName) {
+    if (!schema.items) {
+        return `type ${typeName} = any[];`;
+    }
+    const itemType = Array.isArray(schema.items)
+        ? schema.items.map(item => jsonSchemaToTypeScriptType(item)).join(' | ')
+        : jsonSchemaToTypeScriptType(schema.items);
+    return `type ${typeName} = (${itemType})[];`;
+}
+function primitiveSchemaToTypeScript(schema, typeName, baseType) {
+    if (schema.enum) {
+        const enumValues = schema.enum.map(val => typeof val === 'string' ? JSON.stringify(val) : String(val)).join(' | ');
+        return `type ${typeName} = ${enumValues};`;
+    }
+    return `type ${typeName} = ${baseType};`;
+}
+/** Convert a Tool to its TypeScript interface string (cached). */
+function toolToTypeScriptInterface(tool) {
+    if (interfaceCache.has(tool.name)) {
+        return interfaceCache.get(tool.name);
+    }
+    let interfaceContent;
+    let accessPattern;
+    if (tool.name.includes('.')) {
+        const [manualName, ...toolParts] = tool.name.split('.');
+        const sanitizedManualName = sanitizeIdentifier(manualName);
+        const toolName = toolParts.map(part => sanitizeIdentifier(part)).join('_');
+        accessPattern = `${sanitizedManualName}.${toolName}`;
+        const inputInterfaceContent = jsonSchemaToObjectContent(tool.inputs);
+        const outputInterfaceContent = jsonSchemaToObjectContent(tool.outputs);
+        interfaceContent = `
+namespace ${sanitizedManualName} {
+  interface ${toolName}Input {
+${inputInterfaceContent}
+  }
+
+  interface ${toolName}Output {
+${outputInterfaceContent}
+  }
+}`;
+    }
+    else {
+        const sanitizedToolName = sanitizeIdentifier(tool.name);
+        accessPattern = sanitizedToolName;
+        const inputType = jsonSchemaToTypeScript(tool.inputs, `${sanitizedToolName}Input`);
+        const outputType = jsonSchemaToTypeScript(tool.outputs, `${sanitizedToolName}Output`);
+        interfaceContent = `${inputType}\n\n${outputType}`;
+    }
+    const interfaceString = `
+${interfaceContent}
+
+/**
+ * ${escapeComment(tool.description)}
+ * Tags: ${escapeComment(tool.tags.join(', '))}
+ * Access as: ${accessPattern}(args)
+ */`;
+    if (!interfaceCache.has(tool.name) && interfaceCache.size >= MAX_CACHE_SIZE) {
+        const oldestKey = interfaceCache.keys().next().value;
+        if (oldestKey !== undefined)
+            interfaceCache.delete(oldestKey);
+    }
+    interfaceCache.set(tool.name, interfaceString);
+    return interfaceString;
+}
+/** Generate TypeScript interfaces for all tools. */
+function getAllToolsTypeScriptInterfaces(tools) {
+    const interfaces = tools.map(tool => toolToTypeScriptInterface(tool));
+    return `// Auto-generated TypeScript interfaces for UTCP tools
+${interfaces.join('\n\n')}`;
+}
+/** Clear the interface cache (e.g., when tools change). */
+function clearInterfaceCache() {
+    interfaceCache.clear();
+}
+//# sourceMappingURL=schema-to-ts.js.map

package/dist/schema-to-ts.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @code-mode/core — Type definitions
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+/** Minimal JSON Schema subset used for tool input/output definitions. */
+export interface JsonSchemaLike {
+    type?: string | string[];
+    properties?: Record<string, JsonSchemaLike>;
+    required?: string[];
+    items?: JsonSchemaLike | JsonSchemaLike[];
+    enum?: unknown[];
+    description?: string;
+}
+/** A tool registered with the engine. */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchemaLike;
+    outputSchema: JsonSchemaLike;
+    tags: string[];
+}
+/** Options for code execution. */
+export interface ExecutionOptions {
+    /** Timeout in milliseconds. Default: 30000 */
+    timeout: number;
+    /** Memory limit in MB for the isolate. Default: 128 */
+    memoryLimit: number;
+    /** Enable execution tracing (tool call timing). Default: false */
+    enableTrace: boolean;
+}
+/** A single tool call recorded during traced execution. */
+export interface ToolCallRecord {
+    toolName: string;
+    args: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    durationMs: number;
+}
+/** Aggregate execution statistics. */
+export interface ExecutionStats {
+    totalCalls: number;
+    totalDurationMs: number;
+    failures: number;
+}
+/** Result of executing code in the sandbox. */
+export interface ExecutionResult {
+    result: unknown;
+    logs: string[];
+    /** Set when sandbox execution fails (timeout, syntax error, runtime error). */
+    error?: string;
+    trace?: ToolCallRecord[];
+    stats?: ExecutionStats;
+}
+/** Configuration for a tool source to register with the engine. */
+export interface ToolSourceConfig {
+    name: string;
+    call_template_type: string;
+    callable_name?: string;
+    config?: Record<string, unknown>;
+}
+/** Result of registering a tool source. */
+export interface RegisterResult {
+    success: boolean;
+    toolNames: string[];
+    errors?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC1C,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,YAAY,EAAE,cAAc,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @code-mode/core — Type definitions
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "code-mode-core",
+  "version": "2.0.0",
+  "description": "Platform-agnostic code execution engine. Chains multiple tool calls into a single TypeScript code execution in a secure sandbox.",
+  "license": "MPL-2.0",
+  "author": "Marius J",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mj-deving/n8n-nodes-utcp-codemode.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "code-mode",
+    "sandbox",
+    "isolated-vm",
+    "tool-calling",
+    "ai-agent",
+    "mcp",
+    "utcp"
+  ],
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@utcp/sdk": "^1.1.0",
+    "isolated-vm": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/bridges.ts

@@ -0,0 +1,160 @@
+/**
+ * @code-mode/core — Console and tool bridges for isolated-vm sandbox
+ *
+ * Adapted from @utcp/code-mode (CodeModeUtcpClient) by UTCP Contributors.
+ * Original: https://github.com/universal-tool-calling-protocol/code-mode
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+import type ivm from 'isolated-vm';
+import { sanitizeIdentifier } from './schema-to-ts';
+import type { ToolLike } from './schema-to-ts';
+
+export type CallToolFn = (toolName: string, args: Record<string, unknown>) => Promise<unknown>;
+
+/**
+ * Set up console.log/error/warn/info bridges in the isolate.
+ * Console calls are forwarded to the logs array in the main process.
+ */
+export async function setupConsoleBridge(
+  isolate: ivm.Isolate,
+  context: ivm.Context,
+  jail: ivm.Reference<Record<string | number | symbol, unknown>>,
+  logs: string[],
+  ivm_module: typeof ivm,
+): Promise<void> {
+  const createLogHandler = (prefix: string) => {
+    return new ivm_module.Reference((...args: any[]) => {
+      const message = args.join(' ');
+      logs.push(prefix ? `${prefix} ${message}` : message);
+    });
+  };
+
+  await jail.set('__logRef', createLogHandler(''));
+  await jail.set('__errorRef', createLogHandler('[ERROR]'));
+  await jail.set('__warnRef', createLogHandler('[WARN]'));
+  await jail.set('__infoRef', createLogHandler('[INFO]'));
+
+  const consoleSetupScript = await isolate.compileScript(`
+    const __stringify = (a) => typeof a === 'object' && a !== null ? JSON.stringify(a, null, 2) : String(a);
+    global.console = {
+      log: (...args) => __logRef.applySync(undefined, args.map(__stringify)),
+      error: (...args) => __errorRef.applySync(undefined, args.map(__stringify)),
+      warn: (...args) => __warnRef.applySync(undefined, args.map(__stringify)),
+      info: (...args) => __infoRef.applySync(undefined, args.map(__stringify))
+    };
+  `);
+  await consoleSetupScript.run(context);
+}
+
+/**
+ * Set up tool bridge functions in the isolate.
+ * Tool calls are forwarded to the main process via callToolFn.
+ */
+export async function setupToolBridges(
+  isolate: ivm.Isolate,
+  context: ivm.Context,
+  jail: ivm.Reference<Record<string | number | symbol, unknown>>,
+  tools: ToolLike[],
+  callToolFn: CallToolFn,
+  ivm_module: typeof ivm,
+): Promise<void> {
+  const toolCallerRef = new ivm_module.Reference(async (toolName: string, argsJson: string) => {
+    try {
+      const args = JSON.parse(argsJson);
+      const result = await callToolFn(toolName, args);
+      return JSON.stringify({ success: true, result });
+    } catch (error: any) {
+      let errorMsg: string = error instanceof Error ? error.message : String(error);
+      if (error.response?.data) {
+        errorMsg += ` Error data: ${JSON.stringify(error.response.data)}`;
+      }
+      return JSON.stringify({
+        success: false,
+        error: errorMsg,
+      });
+    }
+  });
+
+  await jail.set('__callToolRef', toolCallerRef);
+
+  const toolSetupParts: string[] = [];
+  const seenPaths = new Set<string>();
+  const namespaces = new Set<string>();
+
+  // Resolve collisions when two tool names sanitize to the same identifier
+  const getUniquePath = (fullPath: string): string => {
+    let uniquePath = fullPath;
+    let counter = 1;
+    while (seenPaths.has(uniquePath)) {
+      uniquePath = `${fullPath}_${counter}`;
+      counter += 1;
+    }
+    seenPaths.add(uniquePath);
+    return uniquePath;
+  };
+
+  for (const tool of tools) {
+    if (tool.name.includes('.')) {
+      const [manualName, ...toolParts] = tool.name.split('.');
+      const sanitizedManualName = sanitizeIdentifier(manualName);
+      const baseFnName = toolParts.map(part => sanitizeIdentifier(part)).join('_');
+      const fullPath = getUniquePath(`${sanitizedManualName}.${baseFnName}`);
+      const toolFnName = fullPath.slice(sanitizedManualName.length + 1);
+
+      if (!namespaces.has(sanitizedManualName)) {
+        namespaces.add(sanitizedManualName);
+        toolSetupParts.push(`global.${sanitizedManualName} = global.${sanitizedManualName} || {};`);
+      }
+
+      toolSetupParts.push(`
+        global.${sanitizedManualName}.${toolFnName} = function(args) {
+          var resultJson = __callToolRef.applySyncPromise(undefined, [${JSON.stringify(tool.name)}, JSON.stringify(args || {})]);
+          var parsed = JSON.parse(resultJson);
+          if (!parsed.success) throw new Error(parsed.error);
+          return parsed.result;
+        };
+      `);
+    } else {
+      const baseName = sanitizeIdentifier(tool.name);
+      const sanitizedToolName = getUniquePath(baseName);
+      toolSetupParts.push(`
+        global.${sanitizedToolName} = function(args) {
+          var resultJson = __callToolRef.applySyncPromise(undefined, [${JSON.stringify(tool.name)}, JSON.stringify(args || {})]);
+          var parsed = JSON.parse(resultJson);
+          if (!parsed.success) throw new Error(parsed.error);
+          return parsed.result;
+        };
+      `);
+    }
+  }
+
+  const toolSetupScript = await isolate.compileScript(toolSetupParts.join('\n'));
+  await toolSetupScript.run(context);
+}
+
+/**
+ * Set up utility functions (__interfaces, __getToolInterface) in the isolate.
+ */
+export async function setupUtilities(
+  isolate: ivm.Isolate,
+  context: ivm.Context,
+  jail: ivm.Reference<Record<string | number | symbol, unknown>>,
+  tools: ToolLike[],
+  interfacesString: string,
+  interfaceMap: Record<string, string>,
+): Promise<void> {
+  await jail.set('__interfaces', interfacesString);
+  await jail.set('__interfaceMapJson', JSON.stringify(interfaceMap));
+
+  const utilSetupScript = await isolate.compileScript(`
+    global.__getToolInterface = (toolName) => {
+      const map = JSON.parse(__interfaceMapJson);
+      return map[toolName] || null;
+    };
+  `);
+  await utilSetupScript.run(context);
+}

package/src/cache.ts

@@ -0,0 +1,48 @@
+/**
+ * @code-mode/core — Internal setup caching
+ *
+ * Always-on caching for tool bridge setup strings, TypeScript interfaces,
+ * and tool description prompts. Keyed on a hash of tool configuration.
+ * No user-facing configuration.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+import { createHash } from 'crypto';
+import type { ToolLike } from './schema-to-ts';
+
+export interface CachedSetup {
+  interfacesString: string;
+  interfaceMap: Record<string, string>;
+  toolDescription: string;
+}
+
+const MAX_CACHE_SIZE = 16;
+const setupCache = new Map<string, CachedSetup>();
+
+/** Compute a hash key from the current set of tools (name, schema, description). */
+export function computeToolsHash(tools: ToolLike[]): string {
+  const data = tools.map(t => `${t.name}:${t.description}:${JSON.stringify(t.inputs)}:${JSON.stringify(t.outputs)}`).join('|');
+  return createHash('sha256').update(data).digest('hex').slice(0, 16);
+}
+
+/** Get cached setup data for the given tools hash, or null. */
+export function getCachedSetup(hash: string): CachedSetup | null {
+  return setupCache.get(hash) ?? null;
+}
+
+/** Store setup data in the cache (FIFO eviction at MAX_CACHE_SIZE). */
+export function setCachedSetup(hash: string, setup: CachedSetup): void {
+  if (!setupCache.has(hash) && setupCache.size >= MAX_CACHE_SIZE) {
+    const oldestKey = setupCache.keys().next().value;
+    if (oldestKey !== undefined) setupCache.delete(oldestKey);
+  }
+  setupCache.set(hash, setup);
+}
+
+/** Clear the entire setup cache. */
+export function clearSetupCache(): void {
+  setupCache.clear();
+}