@darkiceinteractive/mcp-conductor 2.0.0-alpha.1 → 3.0.0-beta.2

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

@@ -0,0 +1,11 @@
+/**
+ * Runtime pool — warm Deno worker pool for low-latency code execution.
+ * @module runtime/pool
+ */
+export { WorkerPool } from './worker-pool.js';
+export type { WorkerPoolOptions, PoolExecuteOptions } from './worker-pool.js';
+export { PooledWorker } from './worker.js';
+export type { WorkerOptions, WorkerJob, WorkerResult, WorkerState } from './worker.js';
+export { evaluateRecycle, isEligible } from './recycle.js';
+export type { RecycleCandidate, RecycleDecision } from './recycle.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/pool/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime/pool/index.js

@@ -0,0 +1,8 @@
+/**
+ * Runtime pool — warm Deno worker pool for low-latency code execution.
+ * @module runtime/pool
+ */
+export { WorkerPool } from './worker-pool.js';
+export { PooledWorker } from './worker.js';
+export { evaluateRecycle, isEligible } from './recycle.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/pool/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Worker Recycle Policy
+ *
+ * Determines when a warm Deno worker should be replaced. Three eviction
+ * triggers are evaluated in order:
+ *   1. Error state — worker crashed or entered an unrecoverable error
+ *   2. Age — worker has been alive longer than `maxAgeMs`
+ *   3. Job count — worker has processed more than `maxJobsPerWorker` jobs
+ *
+ * Recycle is designed to be async-safe: the pool spawns a replacement
+ * *before* terminating the old worker, ensuring capacity is never reduced
+ * during normal operation.
+ *
+ * @module runtime/pool/recycle
+ */
+import type { WorkerPoolOptions } from './worker-pool.js';
+export interface RecycleCandidate {
+    /** Worker unique identifier */
+    id: string;
+    /** Current state of the worker */
+    state: 'idle' | 'busy' | 'recycling' | 'dead';
+    /** Epoch ms when the worker was created */
+    createdAt: number;
+    /** Total jobs run since creation */
+    jobsRun: number;
+}
+export interface RecycleDecision {
+    shouldRecycle: boolean;
+    reason?: 'error' | 'age' | 'job-count';
+}
+/**
+ * Evaluate whether a worker should be recycled based on the pool policy.
+ *
+ * Called by the pool after every job completion and after any error event.
+ * When `shouldRecycle` is true, the pool spawns a replacement then calls
+ * `worker.shutdown(drainFirst=false)` on the old worker.
+ */
+export declare function evaluateRecycle(candidate: RecycleCandidate, opts: Pick<WorkerPoolOptions, 'maxJobsPerWorker' | 'maxAgeMs'>): RecycleDecision;
+/**
+ * Return true if a worker is eligible to receive new jobs
+ * (idle and not scheduled for recycle).
+ */
+export declare function isEligible(candidate: RecycleCandidate, opts: Pick<WorkerPoolOptions, 'maxJobsPerWorker' | 'maxAgeMs'>): boolean;
+//# sourceMappingURL=recycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recycle.d.ts","sourceRoot":"","sources":["../../../src/runtime/pool/recycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC9C,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;CACxC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,GAAG,UAAU,CAAC,GAC7D,eAAe,CAoBjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,kBAAkB,GAAG,UAAU,CAAC,GAC7D,OAAO,CAIT"}

package/dist/runtime/pool/recycle.js

@@ -0,0 +1,50 @@
+/**
+ * Worker Recycle Policy
+ *
+ * Determines when a warm Deno worker should be replaced. Three eviction
+ * triggers are evaluated in order:
+ *   1. Error state — worker crashed or entered an unrecoverable error
+ *   2. Age — worker has been alive longer than `maxAgeMs`
+ *   3. Job count — worker has processed more than `maxJobsPerWorker` jobs
+ *
+ * Recycle is designed to be async-safe: the pool spawns a replacement
+ * *before* terminating the old worker, ensuring capacity is never reduced
+ * during normal operation.
+ *
+ * @module runtime/pool/recycle
+ */
+/**
+ * Evaluate whether a worker should be recycled based on the pool policy.
+ *
+ * Called by the pool after every job completion and after any error event.
+ * When `shouldRecycle` is true, the pool spawns a replacement then calls
+ * `worker.shutdown(drainFirst=false)` on the old worker.
+ */
+export function evaluateRecycle(candidate, opts) {
+    // Error state always recycles
+    if (candidate.state === 'dead' || candidate.state === 'recycling') {
+        return { shouldRecycle: true, reason: 'error' };
+    }
+    const now = Date.now();
+    const ageMs = now - candidate.createdAt;
+    const maxAge = opts.maxAgeMs ?? 600_000;
+    const maxJobs = opts.maxJobsPerWorker ?? 100;
+    if (ageMs >= maxAge) {
+        return { shouldRecycle: true, reason: 'age' };
+    }
+    if (candidate.jobsRun >= maxJobs) {
+        return { shouldRecycle: true, reason: 'job-count' };
+    }
+    return { shouldRecycle: false };
+}
+/**
+ * Return true if a worker is eligible to receive new jobs
+ * (idle and not scheduled for recycle).
+ */
+export function isEligible(candidate, opts) {
+    if (candidate.state !== 'idle')
+        return false;
+    const { shouldRecycle } = evaluateRecycle(candidate, opts);
+    return !shouldRecycle;
+}
+//# sourceMappingURL=recycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recycle.js","sourceRoot":"","sources":["../../../src/runtime/pool/recycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoBH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,SAA2B,EAC3B,IAA8D;IAE9D,8BAA8B;IAC9B,IAAI,SAAS,CAAC,KAAK,KAAK,MAAM,IAAI,SAAS,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAClE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI,GAAG,CAAC;IAE7C,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,SAA2B,EAC3B,IAA8D;IAE9D,IAAI,SAAS,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,EAAE,aAAa,EAAE,GAAG,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,aAAa,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,77 @@
+/**
+ * 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 type { WorkerJob } from './worker.js';
+export interface WorkerPoolOptions {
+    /** Number of warm workers to maintain (default: 4) */
+    size?: number;
+    /** Recycle a worker after this many jobs (default: 100) */
+    maxJobsPerWorker?: number;
+    /** Recycle a worker after this age in ms (default: 600000 = 10 min) */
+    maxAgeMs?: number;
+    /** Directory of generated .d.ts files from the registry (Agent A output) */
+    preloadTypesDir: string;
+    /**
+     * Additional helper scripts to preload in each worker.
+     * Phase 5 (Agent E) passes compact/summarize/delta helpers here.
+     * Default: [] (no additional preloads).
+     */
+    preloadHelpers?: string[];
+    /** Max Deno memory per worker in MB (default: 128) */
+    maxMemoryMb?: number;
+    /** Bridge URL injected into the sandbox (default: http://127.0.0.1:9847) */
+    bridgeUrl?: string;
+}
+export interface PoolExecuteOptions {
+    signal?: AbortSignal;
+    /** Timeout in ms for waiting to acquire an idle worker (default: 5000) */
+    acquireTimeoutMs?: number;
+}
+export declare class WorkerPool {
+    private readonly opts;
+    private workers;
+    private queue;
+    private isShuttingDown;
+    private isWarmedUp;
+    constructor(options: WorkerPoolOptions);
+    /** Pre-spawn all workers. Must be called before `execute()`. */
+    warmUp(): Promise<void>;
+    /**
+     * 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.
+     */
+    execute<T = unknown>(job: Omit<WorkerJob, 'signal'>, execOpts?: PoolExecuteOptions): Promise<T>;
+    size(): number;
+    busyCount(): number;
+    idleCount(): number;
+    /** Gracefully drain all in-flight jobs then terminate all workers. */
+    shutdown(): Promise<void>;
+    private _findIdle;
+    private _runOnWorker;
+    private _maybeRecycle;
+    private _removeWorker;
+    private _drainQueue;
+}
+//# sourceMappingURL=worker-pool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../src/runtime/pool/worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,aAAa,CAAC;AAM1E,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,iBAAiB;IAYtC,gEAAgE;IAC1D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB7B;;;;;OAKG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAC9B,QAAQ,GAAE,kBAAuB,GAChC,OAAO,CAAC,CAAC,CAAC;IAkCb,IAAI,IAAI,MAAM;IAId,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,MAAM;IAInB,sEAAsE;IAChE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB/B,OAAO,CAAC,SAAS;YAIH,YAAY;YAuBZ,aAAa;IAkD3B,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;CAapB"}

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"}