@darkiceinteractive/mcp-conductor 1.1.0 → 3.0.0-beta.1

package/dist/runtime/pool/worker-pool.js

@@ -0,0 +1,216 @@
+/**
+ * Warm Deno Worker Pool
+ *
+ * Maintains a fixed pool of pre-warmed Deno workers so that the first
+ * execute_code call after startup hits an already-running sandbox.
+ *
+ * Lifecycle:
+ *   1. `new WorkerPool(opts)` — configure
+ *   2. `await pool.warmUp()` — spawn `size` workers concurrently
+ *   3. `await pool.execute(job)` — pick idle worker, run, release
+ *   4. `await pool.shutdown()` — drain in-flight jobs, terminate all workers
+ *
+ * Recycle policy (see recycle.ts):
+ *   - After `maxJobsPerWorker` jobs the worker is replaced before termination
+ *   - After `maxAgeMs` age the worker is replaced after its current job finishes
+ *   - After any uncaught error the worker is replaced immediately
+ *
+ * Phase 5 plug-in: pass `preloadHelpers` to `WorkerPoolOptions` and the
+ * bootstrap script inside `worker.ts` will `await import()` each path before
+ * entering the job loop.
+ *
+ * @module runtime/pool/worker-pool
+ */
+import { logger } from '../../utils/index.js';
+import { PooledWorker } from './worker.js';
+import { evaluateRecycle } from './recycle.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// WorkerPool
+// ─────────────────────────────────────────────────────────────────────────────
+const DEFAULT_SIZE = 4;
+const DEFAULT_MAX_JOBS = 100;
+const DEFAULT_MAX_AGE_MS = 600_000;
+const DEFAULT_ACQUIRE_TIMEOUT_MS = 5_000;
+export class WorkerPool {
+    opts;
+    workers = [];
+    queue = [];
+    isShuttingDown = false;
+    isWarmedUp = false;
+    constructor(options) {
+        this.opts = {
+            size: options.size ?? DEFAULT_SIZE,
+            maxJobsPerWorker: options.maxJobsPerWorker ?? DEFAULT_MAX_JOBS,
+            maxAgeMs: options.maxAgeMs ?? DEFAULT_MAX_AGE_MS,
+            preloadTypesDir: options.preloadTypesDir,
+            preloadHelpers: options.preloadHelpers ?? [],
+            maxMemoryMb: options.maxMemoryMb ?? 128,
+            bridgeUrl: options.bridgeUrl ?? 'http://127.0.0.1:9847',
+        };
+    }
+    /** Pre-spawn all workers. Must be called before `execute()`. */
+    async warmUp() {
+        if (this.isWarmedUp)
+            return;
+        const workerOpts = {
+            preloadTypesDir: this.opts.preloadTypesDir,
+            preloadHelpers: this.opts.preloadHelpers,
+            maxMemoryMb: this.opts.maxMemoryMb,
+            bridgeUrl: this.opts.bridgeUrl,
+        };
+        const spawns = Array.from({ length: this.opts.size }, async () => {
+            const w = new PooledWorker(workerOpts);
+            await w.start();
+            this.workers.push(w);
+        });
+        await Promise.allSettled(spawns);
+        const alive = this.workers.filter((w) => w.currentState !== 'dead').length;
+        logger.info('WorkerPool warmed up', { requested: this.opts.size, alive });
+        this.isWarmedUp = true;
+    }
+    /**
+     * Execute a job on an idle worker.
+     *
+     * If no idle worker is available, the job is queued until one becomes
+     * free or the acquire timeout elapses.
+     */
+    async execute(job, execOpts = {}) {
+        if (this.isShuttingDown) {
+            throw new Error('WorkerPool is shutting down');
+        }
+        const fullJob = {
+            ...job,
+            signal: execOpts.signal,
+        };
+        const worker = this._findIdle();
+        if (worker) {
+            return this._runOnWorker(worker, fullJob);
+        }
+        // Queue the job
+        const acquireTimeoutMs = execOpts.acquireTimeoutMs ?? DEFAULT_ACQUIRE_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            const timeoutTimer = setTimeout(() => {
+                const idx = this.queue.findIndex((q) => q.job.id === fullJob.id);
+                if (idx !== -1)
+                    this.queue.splice(idx, 1);
+                reject(new Error(`WorkerPool: acquire timeout after ${acquireTimeoutMs}ms`));
+            }, acquireTimeoutMs);
+            if (timeoutTimer.unref)
+                timeoutTimer.unref();
+            this.queue.push({
+                job: fullJob,
+                resolve: resolve,
+                reject,
+                timeoutTimer,
+            });
+        });
+    }
+    size() {
+        return this.workers.filter((w) => w.currentState !== 'dead').length;
+    }
+    busyCount() {
+        return this.workers.filter((w) => w.currentState === 'busy').length;
+    }
+    idleCount() {
+        return this.workers.filter((w) => w.currentState === 'idle').length;
+    }
+    /** Gracefully drain all in-flight jobs then terminate all workers. */
+    async shutdown() {
+        this.isShuttingDown = true;
+        // Reject queued jobs that haven't started
+        for (const queued of this.queue) {
+            clearTimeout(queued.timeoutTimer);
+            queued.reject(new Error('WorkerPool shut down'));
+        }
+        this.queue.length = 0;
+        // Drain busy workers (wait for current jobs to finish, then terminate)
+        await Promise.allSettled(this.workers.map((w) => w.shutdown(true)));
+        this.workers.length = 0;
+        logger.info('WorkerPool: shutdown complete');
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Private
+    // ─────────────────────────────────────────────────────────────────────────
+    _findIdle() {
+        return this.workers.find((w) => w.isIdle && w.currentState === 'idle');
+    }
+    async _runOnWorker(worker, job) {
+        let result;
+        try {
+            result = await worker.execute(job);
+        }
+        catch (err) {
+            // Worker errored — mark for recycle and propagate
+            await this._maybeRecycle(worker);
+            throw err;
+        }
+        // Post-job recycle check (age / job-count triggers)
+        await this._maybeRecycle(worker);
+        // Drain one queued job onto the (now idle) worker or next available idle
+        this._drainQueue();
+        if (!result.success && result.error) {
+            throw new Error(result.error.message);
+        }
+        return result.result;
+    }
+    async _maybeRecycle(worker) {
+        const decision = evaluateRecycle({
+            id: worker.id,
+            state: worker.currentState,
+            createdAt: worker.createdAt,
+            jobsRun: worker.jobsRun,
+        }, { maxJobsPerWorker: this.opts.maxJobsPerWorker, maxAgeMs: this.opts.maxAgeMs });
+        if (!decision.shouldRecycle)
+            return;
+        logger.debug('WorkerPool: recycling worker', { workerId: worker.id, reason: decision.reason });
+        // Spawn replacement first to maintain capacity
+        const workerOpts = {
+            preloadTypesDir: this.opts.preloadTypesDir,
+            preloadHelpers: this.opts.preloadHelpers,
+            maxMemoryMb: this.opts.maxMemoryMb,
+            bridgeUrl: this.opts.bridgeUrl,
+        };
+        if (!this.isShuttingDown) {
+            const replacement = new PooledWorker(workerOpts);
+            // Start async — don't block the caller
+            replacement.start().then(() => {
+                const idx = this.workers.indexOf(worker);
+                if (idx !== -1) {
+                    this.workers.splice(idx, 1, replacement);
+                }
+                else {
+                    this.workers.push(replacement);
+                }
+                this._drainQueue();
+                logger.debug('WorkerPool: replacement worker ready', { workerId: replacement.id });
+            }).catch((err) => {
+                logger.error('WorkerPool: replacement spawn failed', { err: String(err) });
+                // Remove old dead worker anyway
+                this._removeWorker(worker);
+            });
+        }
+        // Terminate old worker (drainFirst=false: it's already idle or dead)
+        await worker.shutdown(false);
+        if (this.isShuttingDown) {
+            this._removeWorker(worker);
+        }
+    }
+    _removeWorker(worker) {
+        const idx = this.workers.indexOf(worker);
+        if (idx !== -1)
+            this.workers.splice(idx, 1);
+    }
+    _drainQueue() {
+        while (this.queue.length > 0) {
+            const idle = this._findIdle();
+            if (!idle)
+                break;
+            const queued = this.queue.shift();
+            clearTimeout(queued.timeoutTimer);
+            this._runOnWorker(idle, queued.job)
+                .then((result) => queued.resolve(result))
+                .catch((err) => queued.reject(err));
+        }
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/runtime/pool/worker-pool.js.map

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

package/dist/runtime/pool/worker.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Individual Deno Worker Lifecycle
+ *
+ * Manages a single warm Deno worker subprocess. The worker runs a persistent
+ * bootstrap script that:
+ *   1. Accepts a list of preload helper scripts (Phase 5 plug-in point)
+ *   2. Waits for job messages on stdin, executes the code, returns results on stdout
+ *
+ * Communication protocol (newline-delimited JSON over stdio):
+ *   host → worker: { id, code, context }
+ *   worker → host: { id, success, result?, error?, logs }
+ *
+ * @module runtime/pool/worker
+ */
+export interface WorkerOptions {
+    /** Directory containing generated .d.ts files from the registry */
+    preloadTypesDir: string;
+    /**
+     * Additional helper scripts to preload (absolute paths or Deno URLs).
+     * Phase 5 (Agent E) plugs compact/summarize/delta helpers in here.
+     */
+    preloadHelpers?: string[];
+    /** Maximum old-space memory for the Deno process (MB) */
+    maxMemoryMb?: number;
+    /** Bridge URL the sandbox code uses for MCP calls */
+    bridgeUrl?: string;
+}
+export interface WorkerJob {
+    /** Unique job identifier for routing responses */
+    id: string;
+    /** TypeScript source code to execute */
+    code: string;
+    /** Execution context injected as global variables */
+    context: Record<string, unknown>;
+    /** Optional AbortSignal to cancel in-flight job */
+    signal?: AbortSignal;
+}
+export interface WorkerResult {
+    id: string;
+    success: boolean;
+    result?: unknown;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+    logs: string[];
+}
+export type WorkerState = 'idle' | 'busy' | 'recycling' | 'dead';
+export declare class PooledWorker {
+    private readonly opts;
+    readonly id: string;
+    private state;
+    private proc;
+    private bootstrapFile;
+    private lineBuffer;
+    private pending;
+    readonly createdAt: number;
+    jobsRun: number;
+    constructor(opts: WorkerOptions);
+    get currentState(): WorkerState;
+    get isIdle(): boolean;
+    /** Spawn the Deno subprocess. */
+    start(): Promise<void>;
+    /**
+     * Execute a job on this worker.
+     * The worker must be idle before calling this.
+     */
+    execute(job: WorkerJob): Promise<WorkerResult>;
+    /**
+     * Gracefully shut down the worker.
+     * If `drainFirst` is true, waits for any in-flight job to complete.
+     */
+    shutdown(drainFirst?: boolean): Promise<void>;
+    private _handleLine;
+    private _handleClose;
+    private _rejectAll;
+    private _terminate;
+    private _cleanup;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/runtime/pool/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/runtime/pool/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AA4GjE,qBAAa,YAAY;IAcX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,OAAO,CAGA;IAEf,QAAQ,CAAC,SAAS,SAAc;IAChC,OAAO,SAAK;gBAEiB,IAAI,EAAE,aAAa;IAIhD,IAAI,YAAY,IAAI,WAAW,CAE9B;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,iCAAiC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8D5B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAoD9C;;;OAGG;IACG,QAAQ,CAAC,UAAU,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhD,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/runtime/pool/worker.js

@@ -0,0 +1,324 @@
+/**
+ * Individual Deno Worker Lifecycle
+ *
+ * Manages a single warm Deno worker subprocess. The worker runs a persistent
+ * bootstrap script that:
+ *   1. Accepts a list of preload helper scripts (Phase 5 plug-in point)
+ *   2. Waits for job messages on stdin, executes the code, returns results on stdout
+ *
+ * Communication protocol (newline-delimited JSON over stdio):
+ *   host → worker: { id, code, context }
+ *   worker → host: { id, success, result?, error?, logs }
+ *
+ * @module runtime/pool/worker
+ */
+import { spawn } from 'node:child_process';
+import { writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { logger, minimalChildEnv } from '../../utils/index.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Bootstrap script written to a temp file once per worker
+// ─────────────────────────────────────────────────────────────────────────────
+function buildBootstrapScript(opts) {
+    const preloads = (opts.preloadHelpers ?? [])
+        .map((p) => `await import(${JSON.stringify(p)});`)
+        .join('\n');
+    return `
+// MCP Conductor — Warm Worker Bootstrap
+// This script runs persistently inside a Deno subprocess.
+// It receives jobs on stdin and returns results on stdout.
+
+// Preload Phase-5 helpers when available
+${preloads}
+
+const __bridgeUrl = ${JSON.stringify(opts.bridgeUrl ?? 'http://127.0.0.1:9847')};
+const __logs: string[] = [];
+
+// Override console.log to capture output
+const __origLog = console.log;
+console.log = (...args: unknown[]) => {
+  const msg = args.map(a => typeof a === 'object' ? JSON.stringify(a) : String(a)).join(' ');
+  __logs.push(msg);
+  __origLog(...args);
+};
+
+// MCPServerClient — mirrors executor.ts sandbox runtime
+class MCPServerClient {
+  constructor(public readonly name: string) {}
+  async call(tool: string, params: Record<string, unknown> = {}): Promise<unknown> {
+    const response = await fetch(\`\${__bridgeUrl}/call\`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ server: this.name, tool, params }),
+    });
+    const data = await response.json();
+    if (data.error) throw new Error(\`Tool error (\${this.name}.\${tool}): \${data.error.message}\`);
+    return data.result;
+  }
+}
+
+const __mcpBase = {
+  server(name: string) { return new MCPServerClient(name); },
+  log(...args: unknown[]) { console.log(...args); },
+};
+const mcp = new Proxy(__mcpBase, {
+  get(t, p) {
+    if (p in t) return (t as Record<string|symbol, unknown>)[p];
+    if (typeof p === 'string') return new MCPServerClient(p);
+    return undefined;
+  },
+});
+
+// Main job loop — read one JSON line per job
+const decoder = new TextDecoder();
+let buf = '';
+
+async function processLine(line: string): Promise<void> {
+  let job: { id: string; code: string; context: Record<string, unknown> };
+  try {
+    job = JSON.parse(line);
+  } catch {
+    return; // malformed, skip
+  }
+
+  __logs.length = 0; // reset per job
+
+  let result: unknown;
+  let error: { message: string; stack?: string } | undefined;
+  let success = true;
+
+  try {
+    // Execute user code in an async wrapper with mcp in scope
+    const __fn = new Function('mcp', '__ctx', \`return (async () => { \${job.code} })()\`);
+    result = await __fn(mcp, job.context ?? {});
+  } catch (err: unknown) {
+    success = false;
+    const e = err as Error;
+    error = { message: e.message, stack: e.stack };
+  }
+
+  const response = JSON.stringify({ id: job.id, success, result, error, logs: [...__logs] });
+  __origLog(response); // use original console.log to avoid capture loop
+}
+
+// Read stdin line by line
+for await (const chunk of Deno.stdin.readable) {
+  buf += decoder.decode(chunk);
+  let nl: number;
+  while ((nl = buf.indexOf('\\n')) !== -1) {
+    const line = buf.slice(0, nl).trim();
+    buf = buf.slice(nl + 1);
+    if (line) await processLine(line);
+  }
+}
+`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// PooledWorker
+// ─────────────────────────────────────────────────────────────────────────────
+let workerSeq = 0;
+export class PooledWorker {
+    opts;
+    id;
+    state = 'idle';
+    proc = null;
+    bootstrapFile = null;
+    lineBuffer = '';
+    pending = new Map();
+    createdAt = Date.now();
+    jobsRun = 0;
+    constructor(opts) {
+        this.opts = opts;
+        this.id = `worker-${++workerSeq}-${Date.now()}`;
+    }
+    get currentState() {
+        return this.state;
+    }
+    get isIdle() {
+        return this.state === 'idle';
+    }
+    /** Spawn the Deno subprocess. */
+    async start() {
+        const script = buildBootstrapScript(this.opts);
+        const tmpPath = join(tmpdir(), `mcp-worker-${this.id}.ts`);
+        writeFileSync(tmpPath, script);
+        this.bootstrapFile = tmpPath;
+        const maxMemMb = this.opts.maxMemoryMb ?? 128;
+        const proc = spawn('deno', [
+            'run',
+            '--allow-net',
+            '--allow-read',
+            '--no-prompt',
+            `--v8-flags=--max-old-space-size=${maxMemMb}`,
+            tmpPath,
+        ], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: minimalChildEnv({
+                DENO_DIR: process.env.DENO_DIR,
+                NO_COLOR: '1',
+            }),
+        });
+        this.proc = proc;
+        proc.stdout?.on('data', (chunk) => {
+            this.lineBuffer += chunk.toString('utf8');
+            let nl;
+            while ((nl = this.lineBuffer.indexOf('\n')) !== -1) {
+                const line = this.lineBuffer.slice(0, nl).trim();
+                this.lineBuffer = this.lineBuffer.slice(nl + 1);
+                if (line)
+                    this._handleLine(line);
+            }
+        });
+        proc.stderr?.on('data', (chunk) => {
+            const text = chunk.toString('utf8').trim();
+            if (text) {
+                logger.debug('Worker stderr', { workerId: this.id, text: text.slice(0, 500) });
+            }
+        });
+        proc.on('close', (code) => {
+            this._handleClose(code ?? -1);
+        });
+        proc.on('error', (err) => {
+            logger.error('Worker spawn error', { workerId: this.id, err: err.message });
+            this._rejectAll(err);
+            this.state = 'dead';
+        });
+        // Brief pause to allow the Deno runtime to initialise before accepting jobs.
+        // This ensures the warm-up cost is paid at pool startup, not at first job.
+        await new Promise((resolve) => {
+            const t = setTimeout(resolve, 50);
+            if (t.unref)
+                t.unref();
+        });
+        logger.debug('Worker started', { workerId: this.id });
+    }
+    /**
+     * Execute a job on this worker.
+     * The worker must be idle before calling this.
+     */
+    execute(job) {
+        if (this.state !== 'idle') {
+            return Promise.reject(new Error(`Worker ${this.id} is not idle (state: ${this.state})`));
+        }
+        if (!this.proc?.stdin?.writable) {
+            return Promise.reject(new Error(`Worker ${this.id} stdin is not writable`));
+        }
+        this.state = 'busy';
+        this.jobsRun++;
+        return new Promise((resolve, reject) => {
+            // Honour AbortSignal cancellation
+            const onAbort = () => {
+                this.pending.delete(job.id);
+                this.state = 'idle';
+                reject(new Error('Job cancelled by AbortSignal'));
+            };
+            if (job.signal?.aborted) {
+                this.state = 'idle';
+                this.jobsRun--; // didn't actually run
+                onAbort();
+                return;
+            }
+            job.signal?.addEventListener('abort', onAbort, { once: true });
+            this.pending.set(job.id, {
+                resolve: (result) => {
+                    job.signal?.removeEventListener('abort', onAbort);
+                    this.state = 'idle';
+                    resolve(result);
+                },
+                reject: (err) => {
+                    job.signal?.removeEventListener('abort', onAbort);
+                    this.state = 'idle';
+                    reject(err);
+                },
+            });
+            const message = JSON.stringify({ id: job.id, code: job.code, context: job.context });
+            try {
+                this.proc.stdin.write(message + '\n');
+            }
+            catch (writeErr) {
+                this.pending.delete(job.id);
+                this.state = 'idle';
+                job.signal?.removeEventListener('abort', onAbort);
+                reject(writeErr instanceof Error ? writeErr : new Error(String(writeErr)));
+            }
+        });
+    }
+    /**
+     * Gracefully shut down the worker.
+     * If `drainFirst` is true, waits for any in-flight job to complete.
+     */
+    async shutdown(drainFirst = true) {
+        if (this.state === 'dead')
+            return;
+        if (drainFirst && this.state === 'busy') {
+            await new Promise((resolve) => {
+                const interval = setInterval(() => {
+                    if (this.state !== 'busy') {
+                        clearInterval(interval);
+                        resolve();
+                    }
+                }, 10);
+            });
+        }
+        this.state = 'recycling';
+        this._terminate();
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Private
+    // ─────────────────────────────────────────────────────────────────────────
+    _handleLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            logger.warn('Worker: unparseable response', { workerId: this.id, line: line.slice(0, 200) });
+            return;
+        }
+        const pending = this.pending.get(msg.id);
+        if (pending) {
+            this.pending.delete(msg.id);
+            pending.resolve(msg);
+        }
+    }
+    _handleClose(code) {
+        this.state = 'dead';
+        this._cleanup();
+        this._rejectAll(new Error(`Worker ${this.id} exited with code ${code}`));
+        logger.debug('Worker exited', { workerId: this.id, code });
+    }
+    _rejectAll(err) {
+        for (const [, handlers] of this.pending) {
+            handlers.reject(err);
+        }
+        this.pending.clear();
+    }
+    _terminate() {
+        try {
+            this.proc?.kill('SIGTERM');
+            const t = setTimeout(() => {
+                try {
+                    this.proc?.kill('SIGKILL');
+                }
+                catch { /* already gone */ }
+            }, 2000);
+            if (t.unref)
+                t.unref();
+        }
+        catch {
+            // Already dead
+        }
+        this._cleanup();
+    }
+    _cleanup() {
+        if (this.bootstrapFile) {
+            try {
+                unlinkSync(this.bootstrapFile);
+            }
+            catch { /* ignore */ }
+            this.bootstrapFile = null;
+        }
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/runtime/pool/worker.js.map

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

package/dist/server/mcp-server.d.ts

@@ -19,6 +19,7 @@ export declare class MCPExecutorServer {
     private config;
     private useMockServers;
     private currentMode;
+    private registry;
     private mockServers;
     constructor(config: MCPExecutorConfig, options?: {
         useMockServers?: boolean;
@@ -30,6 +31,11 @@ export declare class MCPExecutorServer {
     /**
      * Register all MCP tools
      */
+    /**
+     * Record metrics + shape the execute_code tool response. Extracted so the
+     * progress/cancel wiring in the handler stays readable.
+     */
+    private finaliseExecuteCodeResult;
     private registerTools;
     /**
      * Start the server