@justanothermldude/mcp-exec 0.1.0

package/dist/tools/execute-batch.js

@@ -0,0 +1,325 @@
+import { SandboxExecutor } from '../sandbox/index.js';
+import { MCPBridge } from '../bridge/index.js';
+import { DEFAULT_TIMEOUT_MS } from '../types/execution.js';
+/**
+ * MCP Tool definition for execute_batch
+ */
+export const executeBatchTool = {
+    name: 'execute_batch',
+    description: 'Execute multiple code snippets in sequence with dependency ordering. ' +
+        'Snippets can declare dependencies on other snippets via depends_on. ' +
+        'The handler performs topological sort to determine execution order.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            snippets: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        id: {
+                            type: 'string',
+                            description: 'Unique identifier for this snippet',
+                        },
+                        code: {
+                            type: 'string',
+                            description: 'The TypeScript/JavaScript code to execute',
+                        },
+                        depends_on: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'IDs of snippets that must execute before this one',
+                        },
+                    },
+                    required: ['id', 'code'],
+                },
+                description: 'Array of code snippets to execute',
+            },
+            timeout_ms: {
+                type: 'number',
+                description: `Maximum execution time in milliseconds per snippet (default: ${DEFAULT_TIMEOUT_MS})`,
+            },
+            stop_on_error: {
+                type: 'boolean',
+                description: 'Stop execution on first error (default: true)',
+            },
+        },
+        required: ['snippets'],
+    },
+};
+/**
+ * Type guard for ExecuteBatchInput
+ */
+export function isExecuteBatchInput(args) {
+    if (typeof args !== 'object' || args === null) {
+        return false;
+    }
+    const input = args;
+    if (!('snippets' in input) || !Array.isArray(input.snippets)) {
+        return false;
+    }
+    // Validate each snippet has required id and code
+    for (const snippet of input.snippets) {
+        if (typeof snippet !== 'object' || snippet === null) {
+            return false;
+        }
+        if (typeof snippet.id !== 'string' || typeof snippet.code !== 'string') {
+            return false;
+        }
+        if (snippet.depends_on !== undefined && !Array.isArray(snippet.depends_on)) {
+            return false;
+        }
+        if (snippet.depends_on && !snippet.depends_on.every((d) => typeof d === 'string')) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Performs topological sort using Kahn's algorithm
+ * Returns sorted snippet IDs or throws if circular dependency detected
+ */
+function topologicalSort(snippets) {
+    // Build adjacency list and in-degree map
+    const snippetMap = new Map();
+    const inDegree = new Map();
+    const adjacencyList = new Map();
+    // Initialize maps
+    for (const snippet of snippets) {
+        snippetMap.set(snippet.id, snippet);
+        inDegree.set(snippet.id, 0);
+        adjacencyList.set(snippet.id, []);
+    }
+    // Build graph edges
+    for (const snippet of snippets) {
+        if (snippet.depends_on) {
+            for (const dep of snippet.depends_on) {
+                if (!snippetMap.has(dep)) {
+                    throw new Error(`Snippet '${snippet.id}' depends on unknown snippet '${dep}'`);
+                }
+                // Edge from dep -> snippet.id (dep must come before snippet)
+                adjacencyList.get(dep).push(snippet.id);
+                inDegree.set(snippet.id, inDegree.get(snippet.id) + 1);
+            }
+        }
+    }
+    // Kahn's algorithm: process nodes with zero in-degree
+    const queue = [];
+    const sorted = [];
+    // Find all nodes with zero in-degree
+    for (const [id, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(id);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        sorted.push(current);
+        // Reduce in-degree for all neighbors
+        for (const neighbor of adjacencyList.get(current)) {
+            const newDegree = inDegree.get(neighbor) - 1;
+            inDegree.set(neighbor, newDegree);
+            if (newDegree === 0) {
+                queue.push(neighbor);
+            }
+        }
+    }
+    // Check for circular dependencies
+    if (sorted.length !== snippets.length) {
+        const remaining = snippets.filter((s) => !sorted.includes(s.id)).map((s) => s.id);
+        throw new Error(`Circular dependency detected involving snippets: ${remaining.join(', ')}`);
+    }
+    return sorted;
+}
+/**
+ * Creates the execute_batch handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_batch tool
+ */
+export function createExecuteBatchHandler(pool, config = {}) {
+    // Ensure bridge port matches sandbox network config
+    const bridgePort = config.bridgeConfig?.port ?? 3000;
+    const sandboxConfig = {
+        ...config.sandboxConfig,
+        mcpBridgePort: bridgePort,
+    };
+    const executor = new SandboxExecutor(sandboxConfig);
+    const bridge = new MCPBridge(pool, {
+        ...config.bridgeConfig,
+        port: bridgePort,
+    });
+    /**
+     * Execute batch handler - performs topological sort and executes snippets in order
+     */
+    return async function executeBatchHandler(args) {
+        const { snippets, timeout_ms = DEFAULT_TIMEOUT_MS, stop_on_error = true } = args;
+        // Validate input
+        if (!snippets || !Array.isArray(snippets)) {
+            return {
+                content: [{ type: 'text', text: 'Error: snippets parameter is required and must be an array' }],
+                isError: true,
+            };
+        }
+        if (snippets.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'Error: snippets array must contain at least one snippet' }],
+                isError: true,
+            };
+        }
+        // Validate each snippet
+        for (const snippet of snippets) {
+            if (!snippet.id || typeof snippet.id !== 'string') {
+                return {
+                    content: [{ type: 'text', text: 'Error: each snippet must have a string id' }],
+                    isError: true,
+                };
+            }
+            if (!snippet.code || typeof snippet.code !== 'string') {
+                return {
+                    content: [{ type: 'text', text: `Error: snippet '${snippet.id}' must have a string code` }],
+                    isError: true,
+                };
+            }
+        }
+        // Check for duplicate IDs
+        const ids = snippets.map((s) => s.id);
+        const duplicates = ids.filter((id, index) => ids.indexOf(id) !== index);
+        if (duplicates.length > 0) {
+            return {
+                content: [{ type: 'text', text: `Error: duplicate snippet IDs: ${[...new Set(duplicates)].join(', ')}` }],
+                isError: true,
+            };
+        }
+        if (timeout_ms !== undefined && (typeof timeout_ms !== 'number' || timeout_ms <= 0)) {
+            return {
+                content: [{ type: 'text', text: 'Error: timeout_ms must be a positive number' }],
+                isError: true,
+            };
+        }
+        // Perform topological sort
+        let sortedIds;
+        try {
+            sortedIds = topologicalSort(snippets);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+                isError: true,
+            };
+        }
+        // Create snippet map for quick lookup
+        const snippetMap = new Map();
+        for (const snippet of snippets) {
+            snippetMap.set(snippet.id, snippet);
+        }
+        // Execute snippets in sorted order
+        const results = [];
+        let hasError = false;
+        try {
+            // Start the MCP bridge server
+            await bridge.start();
+            for (const id of sortedIds) {
+                const snippet = snippetMap.get(id);
+                try {
+                    const result = await executor.execute(snippet.code, timeout_ms);
+                    const snippetResult = {
+                        id,
+                        output: result.output,
+                        durationMs: result.durationMs,
+                    };
+                    if (result.error) {
+                        snippetResult.error = result.error;
+                        hasError = true;
+                    }
+                    results.push(snippetResult);
+                    // Stop on error if configured
+                    if (result.error && stop_on_error) {
+                        break;
+                    }
+                }
+                catch (execError) {
+                    const errorMessage = execError instanceof Error ? execError.message : String(execError);
+                    results.push({
+                        id,
+                        output: [],
+                        error: errorMessage,
+                        durationMs: 0,
+                    });
+                    hasError = true;
+                    if (stop_on_error) {
+                        break;
+                    }
+                }
+            }
+            // Stop the bridge server
+            await bridge.stop();
+            // Format and return results
+            return formatBatchResult(results, hasError);
+        }
+        catch (error) {
+            // Ensure bridge is stopped on error
+            try {
+                if (bridge.isRunning()) {
+                    await bridge.stop();
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return formatBatchErrorResult(errorMessage, results);
+        }
+    };
+}
+/**
+ * Format batch execution results
+ */
+function formatBatchResult(results, hasError) {
+    const lines = [];
+    for (const result of results) {
+        lines.push(`=== Snippet '${result.id}' ===`);
+        if (result.output.length > 0) {
+            lines.push(...result.output);
+        }
+        if (result.error) {
+            lines.push(`[stderr]: ${result.error}`);
+        }
+        lines.push(`[Completed in ${result.durationMs}ms]`);
+        lines.push('');
+    }
+    const totalDuration = results.reduce((sum, r) => sum + r.durationMs, 0);
+    lines.push(`[Batch completed: ${results.length} snippet(s) in ${totalDuration}ms]`);
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: hasError,
+    };
+}
+/**
+ * Format batch error result with partial results
+ */
+function formatBatchErrorResult(errorMessage, partialResults) {
+    const lines = [];
+    if (partialResults.length > 0) {
+        lines.push('[Partial results]:');
+        for (const result of partialResults) {
+            lines.push(`=== Snippet '${result.id}' ===`);
+            if (result.output.length > 0) {
+                lines.push(...result.output);
+            }
+            if (result.error) {
+                lines.push(`[stderr]: ${result.error}`);
+            }
+            lines.push(`[Completed in ${result.durationMs}ms]`);
+            lines.push('');
+        }
+    }
+    lines.push(`Error: ${errorMessage}`);
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=execute-batch.js.map

package/dist/tools/execute-batch.js.map

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

package/dist/tools/execute-code.d.ts

@@ -0,0 +1,65 @@
+/**
+ * execute_code MCP tool handler
+ * Orchestrates sandbox execution with MCP bridge for tool access
+ */
+import type { ServerPool } from '@justanothermldude/meta-mcp-core';
+import { type SandboxExecutorConfig } from '../sandbox/index.js';
+import { type MCPBridgeConfig } from '../bridge/index.js';
+import { type ExecuteCodeInput } from '../types/execution.js';
+/**
+ * MCP Tool definition for execute_code
+ */
+export declare const executeCodeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * CallToolResult content item
+ */
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Standard MCP CallToolResult format
+ */
+export interface CallToolResult {
+    content: TextContent[];
+    isError?: boolean;
+}
+/**
+ * Configuration for the execute_code handler
+ */
+export interface ExecuteCodeHandlerConfig {
+    /** Configuration for the sandbox executor */
+    sandboxConfig?: SandboxExecutorConfig;
+    /** Configuration for the MCP bridge */
+    bridgeConfig?: MCPBridgeConfig;
+}
+/**
+ * Creates the execute_code handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_code tool
+ */
+export declare function createExecuteCodeHandler(pool: ServerPool, config?: ExecuteCodeHandlerConfig): (args: ExecuteCodeInput) => Promise<CallToolResult>;
+/**
+ * Type guard for ExecuteCodeInput
+ */
+export declare function isExecuteCodeInput(args: unknown): args is ExecuteCodeInput;
+//# sourceMappingURL=execute-code.d.ts.map

package/dist/tools/execute-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-code.d.ts","sourceRoot":"","sources":["../../src/tools/execute-code.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAsB,KAAK,gBAAgB,EAAwB,MAAM,uBAAuB,CAAC;AAExG;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAkB3B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,uCAAuC;IACvC,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,wBAA6B,IAmBnC,MAAM,gBAAgB,KACrB,OAAO,CAAC,cAAc,CAAC,CA+C3B;AAwDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAO1E"}

package/dist/tools/execute-code.js

@@ -0,0 +1,141 @@
+import { SandboxExecutor } from '../sandbox/index.js';
+import { MCPBridge } from '../bridge/index.js';
+import { DEFAULT_TIMEOUT_MS } from '../types/execution.js';
+/**
+ * MCP Tool definition for execute_code
+ */
+export const executeCodeTool = {
+    name: 'execute_code',
+    description: 'Execute TypeScript/JavaScript code in a sandboxed environment with access to MCP tools via HTTP bridge',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            code: {
+                type: 'string',
+                description: 'The TypeScript/JavaScript code to execute',
+            },
+            timeout_ms: {
+                type: 'number',
+                description: `Maximum execution time in milliseconds (default: ${DEFAULT_TIMEOUT_MS})`,
+            },
+        },
+        required: ['code'],
+    },
+};
+/**
+ * Creates the execute_code handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_code tool
+ */
+export function createExecuteCodeHandler(pool, config = {}) {
+    // Ensure bridge port matches sandbox network config
+    const bridgePort = config.bridgeConfig?.port ?? 3000;
+    const sandboxConfig = {
+        ...config.sandboxConfig,
+        mcpBridgePort: bridgePort,
+    };
+    const executor = new SandboxExecutor(sandboxConfig);
+    const bridge = new MCPBridge(pool, {
+        ...config.bridgeConfig,
+        port: bridgePort,
+    });
+    /**
+     * Execute code handler - orchestrates bridge, executor, and cleanup
+     */
+    return async function executeCodeHandler(args) {
+        const { code, timeout_ms = DEFAULT_TIMEOUT_MS } = args;
+        // Validate input
+        if (!code || typeof code !== 'string') {
+            return {
+                content: [{ type: 'text', text: 'Error: code parameter is required and must be a string' }],
+                isError: true,
+            };
+        }
+        if (timeout_ms !== undefined && (typeof timeout_ms !== 'number' || timeout_ms <= 0)) {
+            return {
+                content: [{ type: 'text', text: 'Error: timeout_ms must be a positive number' }],
+                isError: true,
+            };
+        }
+        let result = null;
+        try {
+            // Step 1: Start the MCP bridge server
+            await bridge.start();
+            // Step 2: Execute code in sandbox
+            result = await executor.execute(code, timeout_ms);
+            // Step 3: Stop the bridge server
+            await bridge.stop();
+            // Step 4: Format and return result
+            return formatResult(result);
+        }
+        catch (error) {
+            // Ensure bridge is stopped on error
+            try {
+                if (bridge.isRunning()) {
+                    await bridge.stop();
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            // Return error with any partial output
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return formatErrorResult(errorMessage, result);
+        }
+    };
+}
+/**
+ * Format a successful execution result
+ */
+function formatResult(result) {
+    const lines = [];
+    // Add output
+    if (result.output.length > 0) {
+        lines.push(...result.output);
+    }
+    // Add error if present (non-fatal stderr)
+    if (result.error) {
+        lines.push(`[stderr]: ${result.error}`);
+    }
+    // Add execution time
+    lines.push(`[Execution completed in ${result.durationMs}ms]`);
+    const hasError = !!result.error;
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: hasError,
+    };
+}
+/**
+ * Format an error result with optional partial output
+ */
+function formatErrorResult(errorMessage, partialResult) {
+    const lines = [];
+    // Add partial output if available
+    if (partialResult?.output.length) {
+        lines.push('[Partial output]:');
+        lines.push(...partialResult.output);
+        lines.push('');
+    }
+    // Add error message
+    lines.push(`Error: ${errorMessage}`);
+    // Add duration if available
+    if (partialResult?.durationMs) {
+        lines.push(`[Execution failed after ${partialResult.durationMs}ms]`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: true,
+    };
+}
+/**
+ * Type guard for ExecuteCodeInput
+ */
+export function isExecuteCodeInput(args) {
+    return (typeof args === 'object' &&
+        args !== null &&
+        'code' in args &&
+        typeof args.code === 'string');
+}
+//# sourceMappingURL=execute-code.js.map

package/dist/tools/execute-code.js.map

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

package/dist/tools/execute-with-context.d.ts

@@ -0,0 +1,80 @@
+/**
+ * execute_with_context MCP tool handler
+ * Executes code with pre-injected context variables
+ */
+import type { ServerPool } from '@justanothermldude/meta-mcp-core';
+import { type SandboxExecutorConfig } from '../sandbox/index.js';
+import { type MCPBridgeConfig } from '../bridge/index.js';
+/**
+ * Input for execute_with_context requests
+ */
+export interface ExecuteWithContextInput {
+    /** The code to execute */
+    code: string;
+    /** Context object to inject into code execution */
+    context?: Record<string, unknown>;
+    /** Execution timeout in milliseconds (default: 30000) */
+    timeout_ms?: number;
+}
+/**
+ * MCP Tool definition for execute_with_context
+ */
+export declare const executeWithContextTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * CallToolResult content item
+ */
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Standard MCP CallToolResult format
+ */
+export interface CallToolResult {
+    content: TextContent[];
+    isError?: boolean;
+}
+/**
+ * Configuration for the execute_with_context handler
+ */
+export interface ExecuteWithContextHandlerConfig {
+    /** Configuration for the sandbox executor */
+    sandboxConfig?: SandboxExecutorConfig;
+    /** Configuration for the MCP bridge */
+    bridgeConfig?: MCPBridgeConfig;
+}
+/**
+ * Creates the execute_with_context handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_with_context tool
+ */
+export declare function createExecuteWithContextHandler(pool: ServerPool, config?: ExecuteWithContextHandlerConfig): (args: ExecuteWithContextInput) => Promise<CallToolResult>;
+/**
+ * Type guard for ExecuteWithContextInput
+ */
+export declare function isExecuteWithContextInput(args: unknown): args is ExecuteWithContextInput;
+//# sourceMappingURL=execute-with-context.d.ts.map

package/dist/tools/execute-with-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-with-context.d.ts","sourceRoot":"","sources":["../../src/tools/execute-with-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;CAuBlC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6CAA6C;IAC7C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,uCAAuC;IACvC,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAsCD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,+BAAoC,IAmB1C,MAAM,uBAAuB,KAC5B,OAAO,CAAC,cAAc,CAAC,CAgF3B;AAwDD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,uBAAuB,CAoBxF"}