@justanothermldude/mcp-exec 0.1.0

package/dist/codegen/wrapper-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TypeScript wrapper generator for MCP tools.
+ * Generates type-safe wrapper functions that call bridge endpoint.
+ */
+import type { ToolDefinition } from '@justanothermldude/meta-mcp-core';
+/**
+ * Generate TypeScript wrapper code for a single MCP tool (legacy - kept for compatibility)
+ * @param tool - Tool definition from MCP server
+ * @param serverName - Name of the MCP server
+ * @returns TypeScript code string
+ * @deprecated Use generateServerModule instead for namespace-based wrappers
+ */
+export declare function generateToolWrapper(tool: ToolDefinition, serverName: string): string;
+/**
+ * Generate a complete TypeScript module with a namespace object for all tools
+ * @param tools - Array of tool definitions
+ * @param serverName - Name of the MCP server
+ * @param bridgePort - Port for the MCP bridge (default: 3000)
+ * @returns TypeScript code string with namespace object
+ */
+export declare function generateServerModule(tools: ToolDefinition[], serverName: string, bridgePort?: number): string;
+//# sourceMappingURL=wrapper-generator.d.ts.map

package/dist/codegen/wrapper-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-generator.d.ts","sourceRoot":"","sources":["../../src/codegen/wrapper-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAqOvE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAqDpF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa,GAAG,MAAM,CAiCnH"}

package/dist/codegen/wrapper-generator.js

@@ -0,0 +1,282 @@
+/**
+ * TypeScript wrapper generator for MCP tools.
+ * Generates type-safe wrapper functions that call bridge endpoint.
+ */
+/**
+ * Bridge endpoint URL for tool calls
+ */
+const BRIDGE_ENDPOINT = 'http://localhost:3000/call';
+/**
+ * Convert a JSON Schema type to TypeScript type
+ * @param prop - JSON Schema property definition
+ * @param required - Whether the property is required
+ * @returns TypeScript type string
+ */
+function jsonSchemaToTs(prop, _required = true) {
+    if (!prop) {
+        return 'unknown';
+    }
+    // Handle array of types (e.g., ["string", "null"])
+    if (Array.isArray(prop.type)) {
+        const types = prop.type.map((t) => primitiveToTs(t));
+        return types.join(' | ');
+    }
+    // Handle enum types
+    if (prop.enum) {
+        return prop.enum.map((v) => JSON.stringify(v)).join(' | ');
+    }
+    // Handle object types with properties
+    if (prop.type === 'object' && prop.properties) {
+        const propLines = Object.entries(prop.properties).map(([key, value]) => {
+            const isRequired = prop.required?.includes(key) ?? false;
+            const tsType = jsonSchemaToTs(value, isRequired);
+            const optionalMark = isRequired ? '' : '?';
+            return `${key}${optionalMark}: ${tsType}`;
+        });
+        return `{ ${propLines.join('; ')} }`;
+    }
+    // Handle array types
+    if (prop.type === 'array') {
+        const itemType = prop.items ? jsonSchemaToTs(prop.items, true) : 'unknown';
+        return `${itemType}[]`;
+    }
+    // Handle primitive types
+    return primitiveToTs(prop.type ?? 'unknown');
+}
+/**
+ * Convert JSON Schema primitive type to TypeScript
+ */
+function primitiveToTs(type) {
+    switch (type) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        case 'object':
+            return 'Record<string, unknown>';
+        case 'array':
+            return 'unknown[]';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Generate TypeScript interface from JSON Schema
+ * @param name - Interface name
+ * @param schema - JSON Schema object
+ * @returns TypeScript interface definition
+ */
+function generateInterface(name, schema) {
+    if (!schema.properties || Object.keys(schema.properties).length === 0) {
+        return `interface ${name} {}`;
+    }
+    const lines = [];
+    lines.push(`interface ${name} {`);
+    for (const [propName, propValue] of Object.entries(schema.properties)) {
+        const prop = propValue;
+        const isRequired = schema.required?.includes(propName) ?? false;
+        const optionalMark = isRequired ? '' : '?';
+        const tsType = jsonSchemaToTs(prop, isRequired);
+        // Add JSDoc if description exists
+        if (prop.description) {
+            lines.push(`  /** ${prop.description} */`);
+        }
+        lines.push(`  ${propName}${optionalMark}: ${tsType};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Sanitize tool name to valid TypeScript identifier
+ */
+function sanitizeIdentifier(name) {
+    // Replace non-alphanumeric chars with underscore, ensure starts with letter
+    let sanitized = name.replace(/[^a-zA-Z0-9_]/g, '_');
+    if (/^[0-9]/.test(sanitized)) {
+        sanitized = '_' + sanitized;
+    }
+    return sanitized;
+}
+/**
+ * Convert tool name to camelCase for method name
+ */
+function toCamelCase(name) {
+    const words = name.split(/[^a-zA-Z0-9]+/).filter(Boolean);
+    if (words.length === 0)
+        return name;
+    return words
+        .map((word, index) => index === 0
+        ? word.toLowerCase()
+        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Convert tool name to PascalCase for interface name
+ */
+function toPascalCase(name) {
+    return name
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Generate interface definition for a tool (if it has input properties)
+ * @param tool - Tool definition from MCP server
+ * @returns Interface definition string or empty string
+ */
+function generateToolInterface(tool) {
+    const interfaceName = `${toPascalCase(tool.name)}Input`;
+    if (tool.inputSchema?.properties && Object.keys(tool.inputSchema.properties).length > 0) {
+        return generateInterface(interfaceName, tool.inputSchema);
+    }
+    return '';
+}
+/**
+ * Generate a method definition for the namespace object
+ * @param tool - Tool definition from MCP server
+ * @param serverName - Name of the MCP server
+ * @param bridgePort - Port for the MCP bridge
+ * @returns Method definition string for inclusion in namespace object
+ */
+function generateMethodDefinition(tool, serverName, bridgePort) {
+    const methodName = toCamelCase(tool.name);
+    const interfaceName = `${toPascalCase(tool.name)}Input`;
+    const hasInput = tool.inputSchema?.properties && Object.keys(tool.inputSchema.properties).length > 0;
+    const inputParam = hasInput ? `input: ${interfaceName}` : '';
+    const inputArg = hasInput ? 'input' : '{}';
+    const lines = [];
+    // Add JSDoc comment
+    if (tool.description) {
+        lines.push('  /**');
+        lines.push(`   * ${tool.description}`);
+        if (tool.inputSchema?.properties) {
+            for (const [propName, propValue] of Object.entries(tool.inputSchema.properties)) {
+                const prop = propValue;
+                if (prop.description) {
+                    lines.push(`   * @param input.${propName} - ${prop.description}`);
+                }
+            }
+        }
+        lines.push('   */');
+    }
+    // Escape server/tool names to prevent code injection via malicious names
+    const safeServerName = JSON.stringify(serverName);
+    const safeToolName = JSON.stringify(tool.name);
+    lines.push(`  ${methodName}: async (${inputParam}): Promise<unknown> => {`);
+    lines.push(`    const response = await fetch('http://localhost:${bridgePort}/call', {`);
+    lines.push(`      method: 'POST',`);
+    lines.push(`      headers: { 'Content-Type': 'application/json' },`);
+    lines.push(`      body: JSON.stringify({`);
+    lines.push(`        server: ${safeServerName},`);
+    lines.push(`        tool: ${safeToolName},`);
+    lines.push(`        args: ${inputArg},`);
+    lines.push(`      }),`);
+    lines.push(`    });`);
+    lines.push(`    if (!response.ok) {`);
+    lines.push('      throw new Error(`Tool call failed: ${response.statusText}`);');
+    lines.push(`    }`);
+    lines.push(`    const data = await response.json() as { success: boolean; content?: unknown; error?: string };`);
+    lines.push(`    if (!data.success) {`);
+    lines.push(`      throw new Error(data.error || 'Tool call failed');`);
+    lines.push(`    }`);
+    lines.push(`    return data.content;`);
+    lines.push(`  },`);
+    return lines.join('\n');
+}
+/**
+ * Generate TypeScript wrapper code for a single MCP tool (legacy - kept for compatibility)
+ * @param tool - Tool definition from MCP server
+ * @param serverName - Name of the MCP server
+ * @returns TypeScript code string
+ * @deprecated Use generateServerModule instead for namespace-based wrappers
+ */
+export function generateToolWrapper(tool, serverName) {
+    const funcName = sanitizeIdentifier(tool.name);
+    const interfaceName = `${toPascalCase(tool.name)}Input`;
+    const lines = [];
+    // Generate input interface if there are properties
+    if (tool.inputSchema?.properties && Object.keys(tool.inputSchema.properties).length > 0) {
+        lines.push(generateInterface(interfaceName, tool.inputSchema));
+        lines.push('');
+    }
+    // Add JSDoc comment
+    if (tool.description) {
+        lines.push('/**');
+        lines.push(` * ${tool.description}`);
+        if (tool.inputSchema?.properties) {
+            lines.push(' *');
+            for (const [propName, propValue] of Object.entries(tool.inputSchema.properties)) {
+                const prop = propValue;
+                if (prop.description) {
+                    lines.push(` * @param input.${propName} - ${prop.description}`);
+                }
+            }
+        }
+        lines.push(' * @returns Promise resolving to tool result');
+        lines.push(' */');
+    }
+    // Generate function signature (no export - for inline execution)
+    const hasInput = tool.inputSchema?.properties && Object.keys(tool.inputSchema.properties).length > 0;
+    const inputParam = hasInput ? `input: ${interfaceName}` : '';
+    const inputArg = hasInput ? 'input' : '{}';
+    lines.push(`async function ${funcName}(${inputParam}): Promise<unknown> {`);
+    lines.push(`  const response = await fetch('${BRIDGE_ENDPOINT}', {`);
+    lines.push(`    method: 'POST',`);
+    lines.push(`    headers: { 'Content-Type': 'application/json' },`);
+    lines.push(`    body: JSON.stringify({`);
+    lines.push(`      server: '${serverName}',`);
+    lines.push(`      tool: '${tool.name}',`);
+    lines.push(`      args: ${inputArg},`);
+    lines.push(`    }),`);
+    lines.push(`  });`);
+    lines.push('');
+    lines.push('  if (!response.ok) {');
+    lines.push('    throw new Error(`Tool call failed: ${response.statusText}`);');
+    lines.push('  }');
+    lines.push('');
+    lines.push('  return response.json();');
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Generate a complete TypeScript module with a namespace object for all tools
+ * @param tools - Array of tool definitions
+ * @param serverName - Name of the MCP server
+ * @param bridgePort - Port for the MCP bridge (default: 3000)
+ * @returns TypeScript code string with namespace object
+ */
+export function generateServerModule(tools, serverName, bridgePort = 3000) {
+    const lines = [];
+    const namespaceName = sanitizeIdentifier(serverName);
+    // File header comment
+    lines.push('/**');
+    lines.push(` * Auto-generated TypeScript wrappers for ${serverName} MCP server tools.`);
+    lines.push(` * Access tools via: ${namespaceName}.methodName()`);
+    lines.push(' */');
+    lines.push('');
+    // Generate all interfaces first
+    for (const tool of tools) {
+        const interfaceCode = generateToolInterface(tool);
+        if (interfaceCode) {
+            lines.push(interfaceCode);
+            lines.push('');
+        }
+    }
+    // Generate the namespace object with all methods
+    lines.push(`const ${namespaceName} = {`);
+    for (let i = 0; i < tools.length; i++) {
+        const tool = tools[i];
+        lines.push(generateMethodDefinition(tool, serverName, bridgePort));
+        // No trailing comma after last method (already handled by generateMethodDefinition)
+    }
+    lines.push('};');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=wrapper-generator.js.map

package/dist/codegen/wrapper-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper-generator.js","sourceRoot":"","sources":["../../src/codegen/wrapper-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAgBrD;;;;;GAKG;AACH,SAAS,cAAc,CAAC,IAAoC,EAAE,YAAqB,IAAI;IACrF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,sCAAsC;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACrE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;YACzD,MAAM,MAAM,GAAG,cAAc,CAAC,KAA2B,EAAE,UAAU,CAAC,CAAC;YACvE,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3C,OAAO,GAAG,GAAG,GAAG,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,OAAO,GAAG,QAAQ,IAAI,CAAC;IACzB,CAAC;IAED,yBAAyB;IACzB,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,yBAAyB,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,IAAY,EAAE,MAAqE;IAC5G,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,aAAa,IAAI,KAAK,CAAC;IAChC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,GAAG,SAA+B,CAAC;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;QAChE,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhD,kCAAkC;QAClC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,GAAG,YAAY,KAAK,MAAM,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACtC,4EAA4E;IAC5E,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,SAAS,GAAG,GAAG,GAAG,SAAS,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnB,KAAK,KAAK,CAAC;QACT,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;QACpB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAC/D;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI;SACR,KAAK,CAAC,eAAe,CAAC;SACtB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,IAAoB;IACjD,MAAM,aAAa,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAExD,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxF,OAAO,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB,CAAC,IAAoB,EAAE,UAAkB,EAAE,UAAkB;IAC5F,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oBAAoB;IACpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChF,MAAM,IAAI,GAAG,SAA+B,CAAC;gBAC7C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,KAAK,CAAC,IAAI,CAAC,qBAAqB,QAAQ,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,yEAAyE;IACzE,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/C,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,YAAY,UAAU,0BAA0B,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,sDAAsD,UAAU,WAAW,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,mBAAmB,cAAc,GAAG,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,iBAAiB,YAAY,GAAG,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,GAAG,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IACjF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,oGAAoG,CAAC,CAAC;IACjH,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoB,EAAE,UAAkB;IAC1E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAExD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mDAAmD;IACnD,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChF,MAAM,IAAI,GAAG,SAA+B,CAAC;gBAC7C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,QAAQ,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3C,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,IAAI,UAAU,uBAAuB,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,mCAAmC,eAAe,MAAM,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,kBAAkB,UAAU,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1C,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,GAAG,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAuB,EAAE,UAAkB,EAAE,aAAqB,IAAI;IACzG,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAErD,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,6CAA6C,UAAU,oBAAoB,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,wBAAwB,aAAa,eAAe,CAAC,CAAC;IACjE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gCAAgC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,IAAI,CAAC,SAAS,aAAa,MAAM,CAAC,CAAC;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;QACnE,oFAAoF;IACtF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+export * from './types/index.js';
+export * from './sandbox/index.js';
+export * from './codegen/index.js';
+export * from './bridge/index.js';
+export * from './tools/index.js';
+export { createMcpExecServer, type McpExecServerConfig } from './server.js';
+export type { ExecuteCodeInput, ExecutionResult } from './types/execution.js';
+import type { ExecuteCodeInput, ExecutionResult } from './types/execution.js';
+import { SandboxExecutor, type SandboxExecutorConfig } from './sandbox/index.js';
+export declare const APP_NAME = "mcp-exec";
+export declare const VERSION = "0.1.0";
+/**
+ * Execute code in a sandboxed environment using @anthropic-ai/sandbox-runtime.
+ * Provides OS-level isolation (sandbox-exec on macOS, bubblewrap on Linux).
+ *
+ * @param input - The code execution input parameters
+ * @returns Promise resolving to execution result
+ */
+export declare function executeCode(input: ExecuteCodeInput): Promise<ExecutionResult>;
+/**
+ * Create a new SandboxExecutor with custom configuration
+ * @param config - Configuration options for the sandbox
+ * @returns New SandboxExecutor instance
+ */
+export declare function createExecutor(config?: SandboxExecutorConfig): SandboxExecutor;
+//# 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":";AAWA,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG5E,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGjF,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,OAAO,UAAU,CAAC;AAe/B;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAInF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAE9E"}

package/dist/index.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+/**
+ * @meta-mcp/exec - MCP execution utilities for sandboxed code execution
+ *
+ * Entry point for both the MCP server and programmatic API usage.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createMcpExecServer } from './server.js';
+import { ServerPool, createConnection, getServerConfig, loadServerManifest } from '@justanothermldude/meta-mcp-core';
+// Export types
+export * from './types/index.js';
+// Export sandbox module
+export * from './sandbox/index.js';
+// Export codegen module
+export * from './codegen/index.js';
+// Export bridge module
+export * from './bridge/index.js';
+// Export tools module
+export * from './tools/index.js';
+// Export server module
+export { createMcpExecServer } from './server.js';
+import { SandboxExecutor } from './sandbox/index.js';
+import { DEFAULT_TIMEOUT_MS } from './types/execution.js';
+export const APP_NAME = 'mcp-exec';
+export const VERSION = '0.1.0';
+// Default executor instance (lazily initialized)
+let defaultExecutor = null;
+/**
+ * Get or create the default SandboxExecutor instance
+ */
+function getDefaultExecutor() {
+    if (!defaultExecutor) {
+        defaultExecutor = new SandboxExecutor();
+    }
+    return defaultExecutor;
+}
+/**
+ * Execute code in a sandboxed environment using @anthropic-ai/sandbox-runtime.
+ * Provides OS-level isolation (sandbox-exec on macOS, bubblewrap on Linux).
+ *
+ * @param input - The code execution input parameters
+ * @returns Promise resolving to execution result
+ */
+export async function executeCode(input) {
+    const { code, timeout_ms = DEFAULT_TIMEOUT_MS } = input;
+    const executor = getDefaultExecutor();
+    return executor.execute(code, timeout_ms);
+}
+/**
+ * Create a new SandboxExecutor with custom configuration
+ * @param config - Configuration options for the sandbox
+ * @returns New SandboxExecutor instance
+ */
+export function createExecutor(config) {
+    return new SandboxExecutor(config);
+}
+// Handle --version and --help flags
+const args = process.argv.slice(2);
+if (args.includes('--version') || args.includes('-v')) {
+    console.log(VERSION);
+    process.exit(0);
+}
+if (args.includes('--help') || args.includes('-h')) {
+    console.log(`${APP_NAME} v${VERSION}
+
+An MCP server for executing TypeScript/JavaScript code in sandboxed environments
+with access to MCP tools via HTTP bridge.
+
+Usage:
+  mcp-exec              Start the server (stdio transport)
+  mcp-exec --version    Show version
+  mcp-exec --help       Show this help
+
+Environment:
+  SERVERS_CONFIG    Path to servers.json config file
+                    Default: ~/.meta-mcp/servers.json
+`);
+    process.exit(0);
+}
+async function main() {
+    // Load config on startup
+    const configPath = process.env.SERVERS_CONFIG;
+    if (configPath) {
+        process.stderr.write(`Loading config from: ${configPath}\n`);
+    }
+    // Load server manifest (required before getServerConfig works)
+    loadServerManifest();
+    // Create connection factory
+    const connectionFactory = async (serverId) => {
+        const config = getServerConfig(serverId);
+        if (!config) {
+            throw new Error(`Server config not found: ${serverId}`);
+        }
+        return createConnection(config);
+    };
+    // Initialize pool
+    const pool = new ServerPool(connectionFactory);
+    // Create server
+    const { server, shutdown } = createMcpExecServer(pool);
+    // Graceful shutdown handlers
+    const handleShutdown = async () => {
+        process.stderr.write('Shutting down...\n');
+        await shutdown();
+        await pool.shutdown();
+        await server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', handleShutdown);
+    process.on('SIGTERM', handleShutdown);
+    // Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('mcp-exec server running on stdio\n');
+}
+// Only run main if this is the entry point (not when imported as a module)
+const isMainModule = process.argv[1]?.endsWith('index.js') || process.argv[1]?.endsWith('mcp-exec');
+if (isMainModule && !args.includes('--no-server')) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/sandbox/config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Sandbox configuration for OS-level code execution isolation
+ * Uses @anthropic-ai/sandbox-runtime for security boundaries
+ */
+import type { SandboxRuntimeConfig, NetworkConfig, FilesystemConfig } from '@anthropic-ai/sandbox-runtime';
+/**
+ * Default MCP bridge port for sandbox communication
+ */
+export declare const DEFAULT_MCP_BRIDGE_PORT = 3000;
+/**
+ * Default network configuration - only allows localhost:3000 for MCP bridge
+ */
+export declare function createDefaultNetworkConfig(mcpBridgePort?: number): NetworkConfig;
+/**
+ * Default filesystem configuration - only allows writes to temp directory
+ */
+export declare function createDefaultFilesystemConfig(additionalWritePaths?: string[]): FilesystemConfig;
+/**
+ * Configuration options for SandboxExecutor
+ */
+export interface SandboxExecutorConfig {
+    /** Port for MCP bridge communication (default: 3000) */
+    mcpBridgePort?: number;
+    /** Additional paths to allow writes to */
+    additionalWritePaths?: string[];
+    /** Enable log monitoring for sandbox violations */
+    enableLogMonitor?: boolean;
+    /** Custom network configuration (overrides default) */
+    networkConfig?: NetworkConfig;
+    /** Custom filesystem configuration (overrides default) */
+    filesystemConfig?: FilesystemConfig;
+}
+/**
+ * Creates a complete SandboxRuntimeConfig from executor options
+ */
+export declare function createSandboxRuntimeConfig(options?: SandboxExecutorConfig): SandboxRuntimeConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/sandbox/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/sandbox/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAG3G;;GAEG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,GAAE,MAAgC,GAAG,aAAa,CAMzG;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,oBAAoB,GAAE,MAAM,EAAO,GAAG,gBAAgB,CAMnG;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CAYpG"}

package/dist/sandbox/config.js

@@ -0,0 +1,36 @@
+import { tmpdir } from 'node:os';
+/**
+ * Default MCP bridge port for sandbox communication
+ */
+export const DEFAULT_MCP_BRIDGE_PORT = 3000;
+/**
+ * Default network configuration - only allows localhost:3000 for MCP bridge
+ */
+export function createDefaultNetworkConfig(mcpBridgePort = DEFAULT_MCP_BRIDGE_PORT) {
+    return {
+        allowedDomains: [`localhost:${mcpBridgePort}`],
+        deniedDomains: [],
+        allowLocalBinding: true,
+    };
+}
+/**
+ * Default filesystem configuration - only allows writes to temp directory
+ */
+export function createDefaultFilesystemConfig(additionalWritePaths = []) {
+    return {
+        denyRead: [],
+        allowWrite: [tmpdir(), ...additionalWritePaths],
+        denyWrite: [],
+    };
+}
+/**
+ * Creates a complete SandboxRuntimeConfig from executor options
+ */
+export function createSandboxRuntimeConfig(options = {}) {
+    const { mcpBridgePort = DEFAULT_MCP_BRIDGE_PORT, additionalWritePaths = [], networkConfig, filesystemConfig, } = options;
+    return {
+        network: networkConfig ?? createDefaultNetworkConfig(mcpBridgePort),
+        filesystem: filesystemConfig ?? createDefaultFilesystemConfig(additionalWritePaths),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/sandbox/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/sandbox/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,gBAAwB,uBAAuB;IACxF,OAAO;QACL,cAAc,EAAE,CAAC,aAAa,aAAa,EAAE,CAAC;QAC9C,aAAa,EAAE,EAAE;QACjB,iBAAiB,EAAE,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,uBAAiC,EAAE;IAC/E,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,oBAAoB,CAAC;QAC/C,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAkBD;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAAiC,EAAE;IAC5E,MAAM,EACJ,aAAa,GAAG,uBAAuB,EACvC,oBAAoB,GAAG,EAAE,EACzB,aAAa,EACb,gBAAgB,GACjB,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,OAAO,EAAE,aAAa,IAAI,0BAA0B,CAAC,aAAa,CAAC;QACnE,UAAU,EAAE,gBAAgB,IAAI,6BAA6B,CAAC,oBAAoB,CAAC;KACpF,CAAC;AACJ,CAAC"}

package/dist/sandbox/executor.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SandboxExecutor - Executes code in an OS-level sandbox using @anthropic-ai/sandbox-runtime
+ * Provides isolation for running agent-generated code safely with network and filesystem restrictions
+ */
+import { type SandboxRuntimeConfig } from '@anthropic-ai/sandbox-runtime';
+import type { ExecutionResult } from '../types/execution.js';
+import { type SandboxExecutorConfig } from './config.js';
+/**
+ * SandboxExecutor class for executing code in an isolated environment
+ */
+export declare class SandboxExecutor {
+    private config;
+    private executorConfig;
+    private initialized;
+    private tempDir;
+    constructor(options?: SandboxExecutorConfig);
+    /**
+     * Initialize the sandbox manager with configured restrictions
+     */
+    initialize(): Promise<void>;
+    /**
+     * Generate the MCP helper preamble that provides the global `mcp` object
+     * for calling MCP tools via the HTTP bridge
+     */
+    private getMcpPreamble;
+    /**
+     * Execute TypeScript/JavaScript code in the sandbox
+     *
+     * @param code - The code to execute
+     * @param timeoutMs - Maximum execution time in milliseconds
+     * @returns ExecutionResult with output, error, and duration
+     */
+    execute(code: string, timeoutMs: number): Promise<ExecutionResult>;
+    /**
+     * Execute a command and capture its output
+     */
+    private executeCommand;
+    /**
+     * Cleanup temporary files
+     */
+    private cleanup;
+    /**
+     * Reset the sandbox manager (useful for testing)
+     */
+    reset(): Promise<void>;
+    /**
+     * Check if sandbox dependencies are available
+     */
+    checkDependencies(): boolean;
+    /**
+     * Check if sandboxing is enabled on this platform
+     */
+    isSandboxingEnabled(): boolean;
+    /**
+     * Get the current sandbox configuration
+     */
+    getConfig(): SandboxRuntimeConfig;
+    /**
+     * Update sandbox configuration (requires re-initialization)
+     */
+    updateConfig(newConfig: Partial<SandboxExecutorConfig>): void;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/sandbox/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/sandbox/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAO1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA8B,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,qBAA0B;IAM/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;;OAGG;IACH,OAAO,CAAC,cAAc;IA0CtB;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuFxE;;OAEG;IACH,OAAO,CAAC,cAAc;IAwCtB;;OAEG;YACW,OAAO;IAYrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,SAAS,IAAI,oBAAoB;IAIjC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;CAK9D"}