@darkiceinteractive/mcp-conductor 1.0.0

package/dist/modes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/modes/index.js

@@ -0,0 +1,5 @@
+/**
+ * Modes module exports
+ */
+export { ModeHandler, getModeHandler, shutdownModeHandler, } from './mode-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/modes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,mBAAmB,GAKpB,MAAM,mBAAmB,CAAC"}

package/dist/modes/mode-handler.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Mode Handler
+ *
+ * Manages operation modes for the MCP Executor:
+ * - execution: All requests go through code execution (maximum token savings)
+ * - passthrough: Direct tool exposure from connected MCP servers
+ * - hybrid: Automatic selection based on task complexity
+ */
+import { EventEmitter } from 'node:events';
+import type { ExecutionMode } from '../config/index.js';
+export interface ModeMetrics {
+    executionCalls: number;
+    passthroughCalls: number;
+    hybridAutoExecutions: number;
+    hybridAutoPassthroughs: number;
+    tokensSavedEstimate: number;
+}
+export interface PassthroughToolCall {
+    server: string;
+    tool: string;
+    params: Record<string, unknown>;
+    timestamp: Date;
+    durationMs?: number;
+    success: boolean;
+    error?: string;
+}
+export interface HybridDecision {
+    task: string;
+    decision: 'execution' | 'passthrough';
+    reason: string;
+    confidence: number;
+}
+export interface ModeHandlerConfig {
+    /** Default operation mode */
+    defaultMode: ExecutionMode;
+    /** Hybrid mode threshold - tool calls above this use execution mode */
+    hybridToolCallThreshold: number;
+    /** Hybrid mode threshold - data above this KB uses execution mode */
+    hybridDataThreshold: number;
+}
+/**
+ * Handles operation mode logic and tracking
+ */
+export declare class ModeHandler extends EventEmitter {
+    private currentMode;
+    private config;
+    private metrics;
+    private recentPassthroughCalls;
+    private maxRecentCalls;
+    constructor(config?: Partial<ModeHandlerConfig>);
+    /**
+     * Get current operation mode
+     */
+    getMode(): ExecutionMode;
+    /**
+     * Set operation mode
+     */
+    setMode(mode: ExecutionMode): ExecutionMode;
+    /**
+     * Check if passthrough mode is active
+     */
+    isPassthroughMode(): boolean;
+    /**
+     * Check if execution mode is active
+     */
+    isExecutionMode(): boolean;
+    /**
+     * Check if hybrid mode is active
+     */
+    isHybridMode(): boolean;
+    /**
+     * Decide which mode to use for a task (hybrid mode logic)
+     */
+    decideMode(task: {
+        description?: string;
+        estimatedToolCalls?: number;
+        estimatedDataKb?: number;
+        toolNames?: string[];
+    }): HybridDecision;
+    /**
+     * Check if description contains data processing keywords
+     */
+    private containsProcessingKeywords;
+    /**
+     * Record an execution mode call
+     */
+    recordExecutionCall(tokensSaved?: number): void;
+    /**
+     * Record a passthrough mode call
+     */
+    recordPassthroughCall(call: Omit<PassthroughToolCall, 'timestamp'>): void;
+    /**
+     * Get mode metrics
+     */
+    getMetrics(): ModeMetrics;
+    /**
+     * Reset metrics
+     */
+    resetMetrics(): void;
+    /**
+     * Get recent passthrough calls
+     */
+    getRecentPassthroughCalls(): PassthroughToolCall[];
+    /**
+     * Generate tool prefix for passthrough mode
+     */
+    generatePassthroughToolName(serverName: string, toolName: string): string;
+    /**
+     * Parse a passthrough tool name back to server and tool
+     */
+    parsePassthroughToolName(combinedName: string): {
+        server: string;
+        tool: string;
+    } | null;
+    /**
+     * Get effective mode for a request (handles hybrid auto-selection)
+     */
+    getEffectiveMode(task?: {
+        description?: string;
+        estimatedToolCalls?: number;
+        estimatedDataKb?: number;
+    }): 'execution' | 'passthrough';
+}
+/**
+ * Get or create the global mode handler
+ */
+export declare function getModeHandler(config?: Partial<ModeHandlerConfig>): ModeHandler;
+/**
+ * Shutdown the global mode handler
+ */
+export declare function shutdownModeHandler(): void;
+//# sourceMappingURL=mode-handler.d.ts.map

package/dist/modes/mode-handler.d.ts.map

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

package/dist/modes/mode-handler.js

@@ -0,0 +1,252 @@
+/**
+ * Mode Handler
+ *
+ * Manages operation modes for the MCP Executor:
+ * - execution: All requests go through code execution (maximum token savings)
+ * - passthrough: Direct tool exposure from connected MCP servers
+ * - hybrid: Automatic selection based on task complexity
+ */
+import { EventEmitter } from 'node:events';
+import { logger } from '../utils/index.js';
+/**
+ * Handles operation mode logic and tracking
+ */
+export class ModeHandler extends EventEmitter {
+    currentMode;
+    config;
+    metrics;
+    recentPassthroughCalls = [];
+    maxRecentCalls = 100;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            defaultMode: 'execution',
+            hybridToolCallThreshold: 3,
+            hybridDataThreshold: 5,
+            ...config,
+        };
+        this.currentMode = this.config.defaultMode;
+        this.metrics = {
+            executionCalls: 0,
+            passthroughCalls: 0,
+            hybridAutoExecutions: 0,
+            hybridAutoPassthroughs: 0,
+            tokensSavedEstimate: 0,
+        };
+    }
+    /**
+     * Get current operation mode
+     */
+    getMode() {
+        return this.currentMode;
+    }
+    /**
+     * Set operation mode
+     */
+    setMode(mode) {
+        const previousMode = this.currentMode;
+        this.currentMode = mode;
+        if (previousMode !== mode) {
+            logger.info('Operation mode changed', { from: previousMode, to: mode });
+            this.emit('modeChanged', { previousMode, currentMode: mode });
+        }
+        return previousMode;
+    }
+    /**
+     * Check if passthrough mode is active
+     */
+    isPassthroughMode() {
+        return this.currentMode === 'passthrough';
+    }
+    /**
+     * Check if execution mode is active
+     */
+    isExecutionMode() {
+        return this.currentMode === 'execution';
+    }
+    /**
+     * Check if hybrid mode is active
+     */
+    isHybridMode() {
+        return this.currentMode === 'hybrid';
+    }
+    /**
+     * Decide which mode to use for a task (hybrid mode logic)
+     */
+    decideMode(task) {
+        const { estimatedToolCalls = 1, estimatedDataKb = 0, description = '' } = task;
+        // Simple heuristics for hybrid mode
+        let decision = 'passthrough';
+        let reason = '';
+        let confidence = 0.5;
+        // Check tool call count
+        if (estimatedToolCalls > this.config.hybridToolCallThreshold) {
+            decision = 'execution';
+            reason = `Multiple tool calls expected (${estimatedToolCalls})`;
+            confidence = 0.8;
+        }
+        // Check data volume
+        else if (estimatedDataKb > this.config.hybridDataThreshold) {
+            decision = 'execution';
+            reason = `Large data volume expected (${estimatedDataKb}KB)`;
+            confidence = 0.75;
+        }
+        // Check for data processing keywords
+        else if (this.containsProcessingKeywords(description)) {
+            decision = 'execution';
+            reason = 'Task involves data processing';
+            confidence = 0.7;
+        }
+        // Default to passthrough for simple tasks
+        else {
+            decision = 'passthrough';
+            reason = 'Simple task suitable for direct tool calls';
+            confidence = 0.6;
+        }
+        // Update metrics
+        if (decision === 'execution') {
+            this.metrics.hybridAutoExecutions++;
+        }
+        else {
+            this.metrics.hybridAutoPassthroughs++;
+        }
+        const result = {
+            task: description || 'Unknown task',
+            decision,
+            reason,
+            confidence,
+        };
+        this.emit('hybridDecision', result);
+        return result;
+    }
+    /**
+     * Check if description contains data processing keywords
+     */
+    containsProcessingKeywords(description) {
+        const keywords = [
+            'filter',
+            'aggregate',
+            'summarise',
+            'summarize',
+            'analyse',
+            'analyze',
+            'process',
+            'transform',
+            'combine',
+            'merge',
+            'calculate',
+            'compute',
+            'iterate',
+            'loop',
+            'multiple',
+            'batch',
+            'bulk',
+        ];
+        const lower = description.toLowerCase();
+        return keywords.some((k) => lower.includes(k));
+    }
+    /**
+     * Record an execution mode call
+     */
+    recordExecutionCall(tokensSaved = 0) {
+        this.metrics.executionCalls++;
+        this.metrics.tokensSavedEstimate += tokensSaved;
+    }
+    /**
+     * Record a passthrough mode call
+     */
+    recordPassthroughCall(call) {
+        this.metrics.passthroughCalls++;
+        const record = {
+            ...call,
+            timestamp: new Date(),
+        };
+        this.recentPassthroughCalls.push(record);
+        // Trim old calls
+        if (this.recentPassthroughCalls.length > this.maxRecentCalls) {
+            this.recentPassthroughCalls.shift();
+        }
+        this.emit('passthroughCall', record);
+    }
+    /**
+     * Get mode metrics
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    /**
+     * Reset metrics
+     */
+    resetMetrics() {
+        this.metrics = {
+            executionCalls: 0,
+            passthroughCalls: 0,
+            hybridAutoExecutions: 0,
+            hybridAutoPassthroughs: 0,
+            tokensSavedEstimate: 0,
+        };
+        this.recentPassthroughCalls = [];
+    }
+    /**
+     * Get recent passthrough calls
+     */
+    getRecentPassthroughCalls() {
+        return [...this.recentPassthroughCalls];
+    }
+    /**
+     * Generate tool prefix for passthrough mode
+     */
+    generatePassthroughToolName(serverName, toolName) {
+        return `${serverName}__${toolName}`;
+    }
+    /**
+     * Parse a passthrough tool name back to server and tool
+     */
+    parsePassthroughToolName(combinedName) {
+        const parts = combinedName.split('__');
+        if (parts.length !== 2)
+            return null;
+        const server = parts[0];
+        const tool = parts[1];
+        if (!server || !tool)
+            return null;
+        return { server, tool };
+    }
+    /**
+     * Get effective mode for a request (handles hybrid auto-selection)
+     */
+    getEffectiveMode(task) {
+        if (this.currentMode === 'execution')
+            return 'execution';
+        if (this.currentMode === 'passthrough')
+            return 'passthrough';
+        // Hybrid mode - decide automatically
+        if (task) {
+            const decision = this.decideMode(task);
+            return decision.decision;
+        }
+        // Default to execution for hybrid without task info
+        return 'execution';
+    }
+}
+// Global mode handler instance
+let globalModeHandler = null;
+/**
+ * Get or create the global mode handler
+ */
+export function getModeHandler(config) {
+    if (!globalModeHandler) {
+        globalModeHandler = new ModeHandler(config);
+    }
+    return globalModeHandler;
+}
+/**
+ * Shutdown the global mode handler
+ */
+export function shutdownModeHandler() {
+    if (globalModeHandler) {
+        globalModeHandler.removeAllListeners();
+        globalModeHandler = null;
+    }
+}
+//# sourceMappingURL=mode-handler.js.map

package/dist/modes/mode-handler.js.map

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

package/dist/runtime/executor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Deno Sandbox Executor
+ *
+ * Executes user code in an isolated Deno subprocess with access to the MCP API.
+ */
+import type { SandboxConfig } from '../config/index.js';
+export interface ExecutionResult {
+    /** Unique execution ID for tracking and streaming */
+    executionId: string;
+    success: boolean;
+    result?: unknown;
+    error?: {
+        type: 'syntax' | 'runtime' | 'timeout' | 'security';
+        message: string;
+        stack?: string;
+        line?: number;
+    };
+    logs: string[];
+    metrics: {
+        executionTimeMs: number;
+        toolCalls: number;
+        dataProcessedBytes: number;
+        resultSizeBytes: number;
+    };
+}
+export interface ExecutionOptions {
+    timeoutMs: number;
+    bridgeUrl: string;
+    servers: string[];
+    /** Enable streaming mode for real-time progress updates */
+    stream?: boolean;
+}
+/**
+ * Deno Sandbox Executor
+ */
+export declare class DenoExecutor {
+    private config;
+    private tempDir;
+    constructor(config: SandboxConfig);
+    /**
+     * Check if Deno is available
+     */
+    checkDeno(): Promise<boolean>;
+    /**
+     * Execute code in the Deno sandbox
+     */
+    execute(code: string, options: ExecutionOptions): Promise<ExecutionResult>;
+    /**
+     * Get an execution ID without executing (for pre-creating streams)
+     */
+    generateExecutionId(): string;
+    /**
+     * Run Deno subprocess
+     */
+    private runDeno;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/runtime/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;QACpD,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA+aD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,aAAa;IAUjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAQnC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6DhF;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,OAAO,CAAC,OAAO;CAkMhB"}