code-mode-core 2.0.0

package/dist/bridges.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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 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 declare function setupConsoleBridge(isolate: ivm.Isolate, context: ivm.Context, jail: ivm.Reference<Record<string | number | symbol, unknown>>, logs: string[], ivm_module: typeof ivm): Promise<void>;
+/**
+ * Set up tool bridge functions in the isolate.
+ * Tool calls are forwarded to the main process via callToolFn.
+ */
+export declare 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>;
+/**
+ * Set up utility functions (__interfaces, __getToolInterface) in the isolate.
+ */
+export declare 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>;
+//# sourceMappingURL=bridges.d.ts.map

package/dist/bridges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridges.d.ts","sourceRoot":"","sources":["../src/bridges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAEnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/F;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9D,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,OAAO,GAAG,GACrB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9D,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,OAAO,GAAG,GACrB,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,OAAO,EAAE,GAAG,CAAC,OAAO,EACpB,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9D,KAAK,EAAE,QAAQ,EAAE,EACjB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/bridges.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * @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/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupConsoleBridge = setupConsoleBridge;
+exports.setupToolBridges = setupToolBridges;
+exports.setupUtilities = setupUtilities;
+const schema_to_ts_1 = require("./schema-to-ts");
+/**
+ * Set up console.log/error/warn/info bridges in the isolate.
+ * Console calls are forwarded to the logs array in the main process.
+ */
+async function setupConsoleBridge(isolate, context, jail, logs, ivm_module) {
+    const createLogHandler = (prefix) => {
+        return new ivm_module.Reference((...args) => {
+            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.
+ */
+async function setupToolBridges(isolate, context, jail, tools, callToolFn, ivm_module) {
+    const toolCallerRef = new ivm_module.Reference(async (toolName, argsJson) => {
+        try {
+            const args = JSON.parse(argsJson);
+            const result = await callToolFn(toolName, args);
+            return JSON.stringify({ success: true, result });
+        }
+        catch (error) {
+            let errorMsg = 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 = [];
+    const seenPaths = new Set();
+    const namespaces = new Set();
+    // Resolve collisions when two tool names sanitize to the same identifier
+    const getUniquePath = (fullPath) => {
+        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 = (0, schema_to_ts_1.sanitizeIdentifier)(manualName);
+            const baseFnName = toolParts.map(part => (0, schema_to_ts_1.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 = (0, schema_to_ts_1.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.
+ */
+async function setupUtilities(isolate, context, jail, tools, interfacesString, interfaceMap) {
+    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);
+}
+//# sourceMappingURL=bridges.js.map

package/dist/bridges.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 type { ToolLike } from './schema-to-ts';
+export interface CachedSetup {
+    interfacesString: string;
+    interfaceMap: Record<string, string>;
+    toolDescription: string;
+}
+/** Compute a hash key from the current set of tools (name, schema, description). */
+export declare function computeToolsHash(tools: ToolLike[]): string;
+/** Get cached setup data for the given tools hash, or null. */
+export declare function getCachedSetup(hash: string): CachedSetup | null;
+/** Store setup data in the cache (FIFO eviction at MAX_CACHE_SIZE). */
+export declare function setCachedSetup(hash: string, setup: CachedSetup): void;
+/** Clear the entire setup cache. */
+export declare function clearSetupCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB;AAKD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAG1D;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAE/D;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAMrE;AAED,oCAAoC;AACpC,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/cache.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @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/.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeToolsHash = computeToolsHash;
+exports.getCachedSetup = getCachedSetup;
+exports.setCachedSetup = setCachedSetup;
+exports.clearSetupCache = clearSetupCache;
+const crypto_1 = require("crypto");
+const MAX_CACHE_SIZE = 16;
+const setupCache = new Map();
+/** Compute a hash key from the current set of tools (name, schema, description). */
+function computeToolsHash(tools) {
+    const data = tools.map(t => `${t.name}:${t.description}:${JSON.stringify(t.inputs)}:${JSON.stringify(t.outputs)}`).join('|');
+    return (0, crypto_1.createHash)('sha256').update(data).digest('hex').slice(0, 16);
+}
+/** Get cached setup data for the given tools hash, or null. */
+function getCachedSetup(hash) {
+    return setupCache.get(hash) ?? null;
+}
+/** Store setup data in the cache (FIFO eviction at MAX_CACHE_SIZE). */
+function setCachedSetup(hash, setup) {
+    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. */
+function clearSetupCache() {
+    setupCache.clear();
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAeH,4CAGC;AAGD,wCAEC;AAGD,wCAMC;AAGD,0CAEC;AAnCD,mCAAoC;AASpC,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;AAElD,oFAAoF;AACpF,SAAgB,gBAAgB,CAAC,KAAiB;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7H,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,+DAA+D;AAC/D,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,uEAAuE;AACvE,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAkB;IAC7D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACjD,IAAI,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IACD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,oCAAoC;AACpC,SAAgB,eAAe;IAC7B,UAAU,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @code-mode/core — CodeModeEngine
+ *
+ * Platform-agnostic engine for executing TypeScript code with tool access
+ * in a secure isolated-vm sandbox.
+ *
+ * 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 { ExecutionOptions, ExecutionResult, ToolSourceConfig, RegisterResult } from './types';
+export declare class CodeModeEngine {
+    private client;
+    private toolsHash;
+    private constructor();
+    /** Create a new CodeModeEngine instance. */
+    static create(): Promise<CodeModeEngine>;
+    /** Register a tool source (MCP server, HTTP API, etc.). */
+    registerToolSource(config: ToolSourceConfig): Promise<RegisterResult>;
+    /** Execute code in the sandbox with registered tools. */
+    execute(code: string, options?: Partial<ExecutionOptions>): Promise<ExecutionResult>;
+    /** Get tool descriptions for LLM prompt generation. */
+    getToolDescription(): Promise<string>;
+    /** Clean up resources including the underlying UTCP client and MCP transports. */
+    close(): Promise<void>;
+    private getToolsAsToolLike;
+    private getOrComputeSetup;
+    private createCallTool;
+    private createTracedCallTool;
+    private computeStats;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EAGf,MAAM,SAAS,CAAC;AAqBjB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAAc;IAE/B,OAAO;IAIP,4CAA4C;WAC/B,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAK9C,2DAA2D;IACrD,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAuB3E,yDAAyD;IACnD,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC;IAoC3B,uDAAuD;IACjD,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAM3C,kFAAkF;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,kBAAkB;YAWlB,iBAAiB;IAgC/B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,YAAY;CAOrB"}

package/dist/engine.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * @code-mode/core — CodeModeEngine
+ *
+ * Platform-agnostic engine for executing TypeScript code with tool access
+ * in a secure isolated-vm sandbox.
+ *
+ * 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.CodeModeEngine = void 0;
+const sdk_1 = require("@utcp/sdk");
+const schema_to_ts_1 = require("./schema-to-ts");
+const sandbox_1 = require("./sandbox");
+const cache_1 = require("./cache");
+const DEFAULT_OPTIONS = {
+    timeout: 30000,
+    memoryLimit: 128,
+    enableTrace: false,
+};
+class CodeModeEngine {
+    constructor(client) {
+        this.toolsHash = '';
+        this.client = client;
+    }
+    /** Create a new CodeModeEngine instance. */
+    static async create() {
+        const client = await sdk_1.UtcpClient.create();
+        return new CodeModeEngine(client);
+    }
+    /** Register a tool source (MCP server, HTTP API, etc.). */
+    async registerToolSource(config) {
+        // Always invalidate cache — tool state may have changed regardless of outcome
+        this.toolsHash = '';
+        try {
+            const result = await this.client.registerManual(config);
+            if (result.success) {
+                const toolNames = (result.manual?.tools ?? []).map((t) => t.name ?? 'unknown');
+                return { success: true, toolNames };
+            }
+            return {
+                success: false,
+                toolNames: [],
+                errors: result.errors ?? ['Registration failed'],
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                toolNames: [],
+                errors: [err instanceof Error ? err.message : String(err)],
+            };
+        }
+    }
+    /** Execute code in the sandbox with registered tools. */
+    async execute(code, options) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        const tools = await this.getToolsAsToolLike();
+        // Get or compute cached setup
+        const setup = await this.getOrComputeSetup(tools);
+        // Build callToolFn — optionally with tracing
+        const trace = [];
+        const callToolFn = opts.enableTrace
+            ? this.createTracedCallTool(trace)
+            : this.createCallTool();
+        const sandboxResult = await (0, sandbox_1.executeInSandbox)(code, tools, callToolFn, setup.interfacesString, setup.interfaceMap, { timeout: opts.timeout, memoryLimit: opts.memoryLimit });
+        const executionResult = {
+            result: sandboxResult.result,
+            logs: sandboxResult.logs,
+            ...(sandboxResult.error ? { error: sandboxResult.error } : {}),
+        };
+        if (opts.enableTrace) {
+            executionResult.trace = trace;
+            executionResult.stats = this.computeStats(trace);
+        }
+        return executionResult;
+    }
+    /** Get tool descriptions for LLM prompt generation. */
+    async getToolDescription() {
+        const tools = await this.getToolsAsToolLike();
+        const setup = await this.getOrComputeSetup(tools);
+        return setup.toolDescription;
+    }
+    /** Clean up resources including the underlying UTCP client and MCP transports. */
+    async close() {
+        this.toolsHash = '';
+        (0, schema_to_ts_1.clearInterfaceCache)();
+        (0, cache_1.clearSetupCache)();
+        await this.client.close();
+    }
+    async getToolsAsToolLike() {
+        const tools = await this.client.getTools();
+        return tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputs: t.inputs,
+            outputs: t.outputs,
+            tags: t.tags ?? [],
+        }));
+    }
+    async getOrComputeSetup(tools) {
+        const hash = (0, cache_1.computeToolsHash)(tools);
+        if (hash === this.toolsHash) {
+            const cached = (0, cache_1.getCachedSetup)(hash);
+            if (cached)
+                return cached;
+        }
+        // Compute fresh — build interfaceMap in one pass, then join for interfacesString
+        (0, schema_to_ts_1.clearInterfaceCache)();
+        const interfaceMap = {};
+        for (const tool of tools) {
+            interfaceMap[tool.name] = (0, schema_to_ts_1.toolToTypeScriptInterface)(tool);
+        }
+        const interfacesString = `// Auto-generated TypeScript interfaces for UTCP tools\n${Object.values(interfaceMap).join('\n\n')}`;
+        const toolDescription = [
+            'Execute a TypeScript code block with access to registered UTCP tools.',
+            'The code runs in an isolated sandbox. Tools are called as synchronous functions: manual.tool({ param: value }).',
+            'Use `return` to return the final result.',
+            '',
+            'Available tool interfaces:',
+            interfacesString || '(no tools registered — configure tool sources on the node)',
+        ].join('\n');
+        const setup = { interfacesString, interfaceMap, toolDescription };
+        (0, cache_1.setCachedSetup)(hash, setup);
+        this.toolsHash = hash;
+        return setup;
+    }
+    createCallTool() {
+        return async (toolName, args) => {
+            return this.client.callTool(toolName, args);
+        };
+    }
+    createTracedCallTool(trace) {
+        return async (toolName, args) => {
+            const start = performance.now();
+            try {
+                const result = await this.client.callTool(toolName, args);
+                trace.push({ toolName, args, result, durationMs: performance.now() - start });
+                return result;
+            }
+            catch (err) {
+                trace.push({
+                    toolName,
+                    args,
+                    error: err instanceof Error ? err.message : String(err),
+                    durationMs: performance.now() - start,
+                });
+                throw err;
+            }
+        };
+    }
+    computeStats(trace) {
+        return {
+            totalCalls: trace.length,
+            totalDurationMs: trace.reduce((sum, r) => sum + r.durationMs, 0),
+            failures: trace.filter(r => r.error !== undefined).length,
+        };
+    }
+}
+exports.CodeModeEngine = CodeModeEngine;
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @code-mode/core — Public API
+ *
+ * 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/.
+ */
+export { CodeModeEngine } from './engine';
+export type { ExecutionOptions, ExecutionResult, ToolDefinition, ToolCallRecord, ExecutionStats, ToolSourceConfig, RegisterResult, JsonSchemaLike, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @code-mode/core — Public API
+ *
+ * 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.CodeModeEngine = void 0;
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "CodeModeEngine", { enumerable: true, get: function () { return engine_1.CodeModeEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,mCAA0C;AAAjC,wGAAA,cAAc,OAAA"}

package/dist/sandbox.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @code-mode/core — SandboxManager
+ *
+ * Only file that imports isolated-vm. Contains isolate creation and
+ * code execution within the 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 { ToolLike } from './schema-to-ts';
+import type { CallToolFn } from './bridges';
+/** Create an isolated-vm isolate with the given memory limit. */
+export declare function createIsolate(memoryLimit: number): Promise<{
+    isolate: import("isolated-vm").Isolate;
+    ivm: typeof import("isolated-vm");
+}>;
+export interface SandboxExecuteOptions {
+    timeout: number;
+    memoryLimit: number;
+}
+/**
+ * Execute code in an isolated sandbox with tool access.
+ *
+ * Sets up console bridges, tool bridges, and utilities, then runs the
+ * user code. Returns the result and captured logs.
+ */
+export declare function executeInSandbox(code: string, tools: ToolLike[], callToolFn: CallToolFn, interfacesString: string, interfaceMap: Record<string, string>, options: SandboxExecuteOptions): Promise<{
+    result: unknown;
+    logs: string[];
+    error?: string;
+}>;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,iEAAiE;AACjE,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM;;;GAItD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC9D"}

package/dist/sandbox.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * @code-mode/core — SandboxManager
+ *
+ * Only file that imports isolated-vm. Contains isolate creation and
+ * code execution within the 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/.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIsolate = createIsolate;
+exports.executeInSandbox = executeInSandbox;
+const bridges_1 = require("./bridges");
+/** Create an isolated-vm isolate with the given memory limit. */
+async function createIsolate(memoryLimit) {
+    const ivm = await Promise.resolve().then(() => __importStar(require('isolated-vm')));
+    const isolate = new ivm.default.Isolate({ memoryLimit });
+    return { isolate, ivm: ivm.default };
+}
+/**
+ * Execute code in an isolated sandbox with tool access.
+ *
+ * Sets up console bridges, tool bridges, and utilities, then runs the
+ * user code. Returns the result and captured logs.
+ */
+async function executeInSandbox(code, tools, callToolFn, interfacesString, interfaceMap, options) {
+    const { isolate, ivm: ivm_module } = await createIsolate(options.memoryLimit);
+    const logs = [];
+    try {
+        const context = await isolate.createContext();
+        const jail = context.global;
+        await jail.set('global', jail.derefInto());
+        await (0, bridges_1.setupConsoleBridge)(isolate, context, jail, logs, ivm_module);
+        await (0, bridges_1.setupToolBridges)(isolate, context, jail, tools, callToolFn, ivm_module);
+        await (0, bridges_1.setupUtilities)(isolate, context, jail, tools, interfacesString, interfaceMap);
+        const wrappedCode = `
+      (function() {
+        var __result = (function() {
+          ${code}
+        })();
+        return JSON.stringify({ __result: __result });
+      })()
+    `;
+        const script = await isolate.compileScript(wrappedCode);
+        const resultJson = await script.run(context, { timeout: options.timeout });
+        const result = typeof resultJson === 'string'
+            ? JSON.parse(resultJson).__result
+            : resultJson;
+        return { result, logs };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            result: null,
+            logs: [...logs, `[ERROR] Code execution failed: ${errorMessage}`],
+            error: errorMessage,
+        };
+    }
+    finally {
+        isolate.dispose();
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOH,sCAIC;AAaD,4CAgDC;AArED,uCAAiF;AAGjF,iEAAiE;AAC1D,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,GAAG,GAAG,wDAAa,aAAa,GAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;AACvC,CAAC;AAOD;;;;;GAKG;AACI,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,KAAiB,EACjB,UAAsB,EACtB,gBAAwB,EACxB,YAAoC,EACpC,OAA8B;IAE9B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;QAE5B,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAE3C,MAAM,IAAA,4BAAkB,EAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACnE,MAAM,IAAA,0BAAgB,EAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC9E,MAAM,IAAA,wBAAc,EAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;QAEpF,MAAM,WAAW,GAAG;;;YAGZ,IAAI;;;;KAIX,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAE3E,MAAM,MAAM,GAAG,OAAO,UAAU,KAAK,QAAQ;YAC3C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ;YACjC,CAAC,CAAC,UAAU,CAAC;QAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,kCAAkC,YAAY,EAAE,CAAC;YACjE,KAAK,EAAE,YAAY;SACpB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}