@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/runtime/agentWorkerPool.js

@@ -0,0 +1,435 @@
+/**
+ * Agent Worker Pool Module
+ *
+ * Provides multi-agent parallelism with automatic load balancing,
+ * work distribution, and result aggregation for AGI workflows.
+ *
+ * Principal Investigator: Bo Shang
+ * Framework: agi-cli
+ */
+// ============================================================================
+// Agent Worker
+// ============================================================================
+class AgentWorker {
+    id;
+    maxConcurrency;
+    priority;
+    tags;
+    controller = null;
+    createController;
+    activeTasks = 0;
+    _completedTasks = 0;
+    _failedTasks = 0;
+    _status = 'idle';
+    constructor(config) {
+        this.id = config.id;
+        this.createController = config.createController;
+        this.maxConcurrency = config.maxConcurrency ?? 1;
+        this.priority = config.priority ?? 0;
+        this.tags = new Set(config.tags ?? []);
+    }
+    get status() {
+        return this._status;
+    }
+    get completedTasks() {
+        return this._completedTasks;
+    }
+    get failedTasks() {
+        return this._failedTasks;
+    }
+    get currentLoad() {
+        return this.activeTasks;
+    }
+    get isAvailable() {
+        return this._status !== 'offline' && this._status !== 'error' && this.activeTasks < this.maxConcurrency;
+    }
+    hasTags(requiredTags) {
+        return requiredTags.every(tag => this.tags.has(tag));
+    }
+    async initialize() {
+        if (this.controller)
+            return;
+        try {
+            this.controller = await this.createController();
+            this._status = 'idle';
+        }
+        catch (error) {
+            this._status = 'error';
+            throw error;
+        }
+    }
+    async execute(task) {
+        if (!this.controller) {
+            await this.initialize();
+        }
+        if (!this.controller) {
+            throw new Error(`Worker ${this.id} failed to initialize`);
+        }
+        this.activeTasks++;
+        this._status = this.activeTasks >= this.maxConcurrency ? 'busy' : 'idle';
+        try {
+            let result = '';
+            if (task.streaming && task.onEvent) {
+                // Streaming mode: collect events and final result
+                for await (const event of this.controller.send(task.message)) {
+                    task.onEvent(event);
+                    if (event.type === 'message.complete') {
+                        result = event.content;
+                    }
+                    else if (event.type === 'message.delta') {
+                        result += event.content;
+                    }
+                }
+            }
+            else {
+                // Non-streaming: collect complete response
+                for await (const event of this.controller.send(task.message)) {
+                    if (event.type === 'message.complete') {
+                        result = event.content;
+                    }
+                    else if (event.type === 'message.delta') {
+                        result += event.content;
+                    }
+                }
+            }
+            this._completedTasks++;
+            return task.transform ? task.transform(result) : result;
+        }
+        catch (error) {
+            this._failedTasks++;
+            throw error;
+        }
+        finally {
+            this.activeTasks--;
+            this._status = this.activeTasks > 0 ? 'busy' : 'idle';
+        }
+    }
+    getInfo() {
+        return {
+            id: this.id,
+            status: this._status,
+            activeTasks: this.activeTasks,
+            completedTasks: this._completedTasks,
+            failedTasks: this._failedTasks,
+            tags: Array.from(this.tags),
+            priority: this.priority,
+        };
+    }
+}
+// ============================================================================
+// Agent Worker Pool
+// ============================================================================
+export class AgentWorkerPool {
+    workers = new Map();
+    taskQueue = [];
+    balanceStrategy;
+    defaultTimeout;
+    maxQueueSize;
+    onEvent;
+    roundRobinIndex = 0;
+    totalTaskDuration = 0;
+    completedTaskCount = 0;
+    processing = false;
+    constructor(config) {
+        this.balanceStrategy = config.balanceStrategy ?? 'least-busy';
+        this.defaultTimeout = config.defaultTimeout ?? 24 * 60 * 60 * 1000; // 24 hours default timeout
+        this.maxQueueSize = config.maxQueueSize ?? 100;
+        this.onEvent = config.onEvent ?? (() => { });
+        for (const workerConfig of config.workers) {
+            const worker = new AgentWorker(workerConfig);
+            this.workers.set(worker.id, worker);
+        }
+    }
+    /**
+     * Initialize all workers
+     */
+    async initialize() {
+        const initPromises = Array.from(this.workers.values()).map(async (worker) => {
+            try {
+                await worker.initialize();
+                this.emit({ type: 'worker.ready', workerId: worker.id, timestamp: Date.now() });
+            }
+            catch (error) {
+                this.emit({
+                    type: 'worker.error',
+                    workerId: worker.id,
+                    timestamp: Date.now(),
+                    data: { error: error instanceof Error ? error.message : String(error) },
+                });
+            }
+        });
+        await Promise.allSettled(initPromises);
+    }
+    /**
+     * Submit a task to the pool
+     */
+    async submit(task) {
+        if (this.taskQueue.length >= this.maxQueueSize) {
+            throw new Error('Task queue is full');
+        }
+        return new Promise((resolve, reject) => {
+            this.taskQueue.push({
+                task: task,
+                resolve: resolve,
+                reject,
+                queuedAt: Date.now(),
+            });
+            this.emit({
+                type: 'task.queued',
+                taskId: task.id,
+                timestamp: Date.now(),
+                data: { queueLength: this.taskQueue.length },
+            });
+            if (this.taskQueue.length >= this.maxQueueSize) {
+                this.emit({ type: 'pool.saturated', timestamp: Date.now() });
+            }
+            // Trigger processing
+            this.processQueue();
+        });
+    }
+    /**
+     * Submit multiple tasks and wait for all results
+     */
+    async submitAll(tasks) {
+        const promises = tasks.map(task => this.submit(task));
+        return Promise.all(promises);
+    }
+    /**
+     * Submit multiple tasks and process results as they complete
+     */
+    async *submitStream(tasks) {
+        const pending = tasks.map(task => this.submit(task));
+        while (pending.length > 0) {
+            const result = await Promise.race(pending.map((p, i) => p.then(r => ({ result: r, index: i }))));
+            pending.splice(result.index, 1);
+            yield result.result;
+        }
+    }
+    /**
+     * Process queued tasks
+     */
+    async processQueue() {
+        if (this.processing)
+            return;
+        this.processing = true;
+        try {
+            while (this.taskQueue.length > 0) {
+                const worker = this.selectWorker(this.taskQueue[0]?.task);
+                if (!worker) {
+                    // No available workers, wait and retry
+                    await this.sleep(50);
+                    continue;
+                }
+                const item = this.taskQueue.shift();
+                if (!item)
+                    break;
+                // Execute task asynchronously (don't await)
+                this.executeTask(worker, item.task, item.resolve, item.reject, item.queuedAt);
+            }
+            if (this.taskQueue.length === 0) {
+                this.emit({ type: 'pool.drained', timestamp: Date.now() });
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /**
+     * Execute a task on a worker
+     */
+    async executeTask(worker, task, resolve, reject, queuedAt) {
+        const startedAt = Date.now();
+        this.emit({
+            type: 'task.started',
+            taskId: task.id,
+            workerId: worker.id,
+            timestamp: startedAt,
+            data: { queueWaitMs: startedAt - queuedAt },
+        });
+        this.emit({ type: 'worker.busy', workerId: worker.id, timestamp: startedAt });
+        try {
+            const timeout = task.timeout ?? this.defaultTimeout;
+            const result = await Promise.race([
+                worker.execute(task),
+                new Promise((_, rej) => setTimeout(() => rej(new Error(`Task ${task.id} timed out after ${timeout}ms`)), timeout)),
+            ]);
+            const completedAt = Date.now();
+            const durationMs = completedAt - startedAt;
+            this.totalTaskDuration += durationMs;
+            this.completedTaskCount++;
+            this.emit({
+                type: 'task.completed',
+                taskId: task.id,
+                workerId: worker.id,
+                timestamp: completedAt,
+                data: { durationMs },
+            });
+            resolve({
+                taskId: task.id,
+                workerId: worker.id,
+                success: true,
+                result,
+                durationMs,
+                startedAt,
+                completedAt,
+            });
+        }
+        catch (error) {
+            const completedAt = Date.now();
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.emit({
+                type: 'task.failed',
+                taskId: task.id,
+                workerId: worker.id,
+                timestamp: completedAt,
+                data: { error: err.message },
+            });
+            resolve({
+                taskId: task.id,
+                workerId: worker.id,
+                success: false,
+                error: err,
+                durationMs: completedAt - startedAt,
+                startedAt,
+                completedAt,
+            });
+        }
+        finally {
+            if (worker.isAvailable) {
+                this.emit({ type: 'worker.idle', workerId: worker.id, timestamp: Date.now() });
+            }
+            // Continue processing queue
+            this.processQueue();
+        }
+    }
+    /**
+     * Select a worker based on the balancing strategy
+     */
+    selectWorker(task) {
+        const available = this.getAvailableWorkers(task);
+        if (available.length === 0)
+            return null;
+        // Check for preferred worker
+        if (task?.preferredWorker) {
+            const preferred = available.find(w => w.id === task.preferredWorker);
+            if (preferred)
+                return preferred;
+        }
+        switch (this.balanceStrategy) {
+            case 'round-robin': {
+                const worker = available[this.roundRobinIndex % available.length];
+                this.roundRobinIndex++;
+                return worker;
+            }
+            case 'random': {
+                const idx = Math.floor(Math.random() * available.length);
+                return available[idx];
+            }
+            case 'priority': {
+                // Sort by priority (descending) then by load (ascending)
+                available.sort((a, b) => {
+                    if (b.priority !== a.priority)
+                        return b.priority - a.priority;
+                    return a.currentLoad - b.currentLoad;
+                });
+                return available[0];
+            }
+            case 'least-busy':
+            default: {
+                // Sort by current load (ascending)
+                available.sort((a, b) => a.currentLoad - b.currentLoad);
+                return available[0];
+            }
+        }
+    }
+    /**
+     * Get available workers filtered by task requirements
+     */
+    getAvailableWorkers(task) {
+        const workers = Array.from(this.workers.values()).filter(w => w.isAvailable);
+        if (task?.requiredTags && task.requiredTags.length > 0) {
+            return workers.filter(w => w.hasTags(task.requiredTags));
+        }
+        return workers;
+    }
+    /**
+     * Get information about all workers
+     */
+    getWorkerInfo() {
+        return Array.from(this.workers.values()).map(w => w.getInfo());
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        const workerInfos = this.getWorkerInfo();
+        const activeWorkers = workerInfos.filter(w => w.status === 'busy').length;
+        const activeTasks = workerInfos.reduce((sum, w) => sum + w.activeTasks, 0);
+        const completedTasks = workerInfos.reduce((sum, w) => sum + w.completedTasks, 0);
+        const failedTasks = workerInfos.reduce((sum, w) => sum + w.failedTasks, 0);
+        return {
+            totalWorkers: workerInfos.length,
+            activeWorkers,
+            idleWorkers: workerInfos.length - activeWorkers,
+            queuedTasks: this.taskQueue.length,
+            activeTasks,
+            completedTasks,
+            failedTasks,
+            averageTaskDurationMs: this.completedTaskCount > 0
+                ? this.totalTaskDuration / this.completedTaskCount
+                : 0,
+        };
+    }
+    /**
+     * Cancel all queued tasks
+     */
+    cancelAll() {
+        const cancelled = this.taskQueue.length;
+        while (this.taskQueue.length > 0) {
+            const item = this.taskQueue.shift();
+            if (item) {
+                item.reject(new Error('Task cancelled'));
+            }
+        }
+        return cancelled;
+    }
+    emit(event) {
+        try {
+            this.onEvent(event);
+        }
+        catch {
+            // Ignore callback errors
+        }
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Create an agent worker pool with the given configuration
+ */
+export function createAgentWorkerPool(config) {
+    return new AgentWorkerPool(config);
+}
+/**
+ * Create a simple agent task
+ */
+export function createAgentTask(id, message, options) {
+    return {
+        id,
+        message,
+        ...options,
+    };
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default {
+    AgentWorkerPool,
+    createAgentWorkerPool,
+    createAgentTask,
+};
+//# sourceMappingURL=agentWorkerPool.js.map

package/dist/runtime/agentWorkerPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentWorkerPool.js","sourceRoot":"","sources":["../../src/runtime/agentWorkerPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqGH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,WAAW;IACN,EAAE,CAAS;IACX,cAAc,CAAS;IACvB,QAAQ,CAAS;IACjB,IAAI,CAAc;IAEnB,UAAU,GAA2B,IAAI,CAAC;IACjC,gBAAgB,CAAmD;IAC5E,WAAW,GAAG,CAAC,CAAC;IAChB,eAAe,GAAG,CAAC,CAAC;IACpB,YAAY,GAAG,CAAC,CAAC;IACjB,OAAO,GAAiB,MAAM,CAAC;IAEvC,YAAY,MAAyB;QACnC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;IAC1G,CAAC;IAED,OAAO,CAAC,YAAsB;QAC5B,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,IAAkB;QACjC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAEzE,IAAI,CAAC;YACH,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnC,kDAAkD;gBAClD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACtC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;oBACzB,CAAC;yBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;wBAC1C,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;oBAC1B,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,2CAA2C;gBAC3C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACtC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;oBACzB,CAAC;yBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;wBAC1C,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;oBAC1B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAuB,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,OAAO,eAAe;IACT,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,SAAS,GAKrB,EAAE,CAAC;IACS,eAAe,CAAkB;IACjC,cAAc,CAAS;IACvB,YAAY,CAAS;IACrB,OAAO,CAA6B;IAC7C,eAAe,GAAG,CAAC,CAAC;IACpB,iBAAiB,GAAG,CAAC,CAAC;IACtB,kBAAkB,GAAG,CAAC,CAAC;IACvB,UAAU,GAAG,KAAK,CAAC;IAE3B,YAAY,MAA6B;QACvC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,YAAY,CAAC;QAC9D,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,2BAA2B;QAC/F,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAE5C,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC1E,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAClF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACxE,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAI,IAAkB;QAChC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,IAAiB;gBACvB,OAAO,EAAE,OAAuC;gBAChD,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;aAC7C,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/D,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAI,KAAqB;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,YAAY,CAAI,KAAqB;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAErD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAC/B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAC9D,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,MAAM,CAAC,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,uCAAuC;oBACvC,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI;oBAAE,MAAM;gBAEjB,4CAA4C;gBAC5C,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChF,CAAC;YAED,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,MAAmB,EACnB,IAAkB,EAClB,OAAwC,EACxC,MAA8B,EAC9B,QAAgB;QAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,SAAS,EAAE,SAAS;YACpB,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,GAAG,QAAQ,EAAE;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAE9E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC;YACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;gBACpB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,oBAAoB,OAAO,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAC1F;aACF,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;YAC3C,IAAI,CAAC,iBAAiB,IAAI,UAAU,CAAC;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAE1B,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,SAAS,EAAE,WAAW;gBACtB,IAAI,EAAE,EAAE,UAAU,EAAE;aACrB,CAAC,CAAC;YAEH,OAAO,CAAC;gBACN,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,OAAO,EAAE,IAAI;gBACb,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,SAAS,EAAE,WAAW;gBACtB,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE;aAC7B,CAAC,CAAC;YAEH,OAAO,CAAC;gBACN,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG;gBACV,UAAU,EAAE,WAAW,GAAG,SAAS;gBACnC,SAAS;gBACT,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACjF,CAAC;YAED,4BAA4B;YAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAgB;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAExC,6BAA6B;QAC7B,IAAI,IAAI,EAAE,eAAe,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,eAAe,CAAC,CAAC;YACrE,IAAI,SAAS;gBAAE,OAAO,SAAS,CAAC;QAClC,CAAC;QAED,QAAQ,IAAI,CAAC,eAAe,EAAE,CAAC;YAC7B,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC,MAAM,CAAE,CAAC;gBACnE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;gBACzD,OAAO,SAAS,CAAC,GAAG,CAAE,CAAC;YACzB,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,yDAAyD;gBACzD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBACtB,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;wBAAE,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;oBAC9D,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;gBACvC,CAAC,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC,CAAC,CAAE,CAAC;YACvB,CAAC;YACD,KAAK,YAAY,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC;gBACR,mCAAmC;gBACnC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;gBACxD,OAAO,SAAS,CAAC,CAAC,CAAE,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,IAAgB;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAE7E,IAAI,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,YAAa,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAC1E,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAE3E,OAAO;YACL,YAAY,EAAE,WAAW,CAAC,MAAM;YAChC,aAAa;YACb,WAAW,EAAE,WAAW,CAAC,MAAM,GAAG,aAAa;YAC/C,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;YAClC,WAAW;YACX,cAAc;YACd,WAAW;YACX,qBAAqB,EAAE,IAAI,CAAC,kBAAkB,GAAG,CAAC;gBAChD,CAAC,CAAC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,kBAAkB;gBAClD,CAAC,CAAC,CAAC;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,IAAI,CAAC,KAAgB;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAU,EACV,OAAe,EACf,OAAuD;IAEvD,OAAO;QACL,EAAE;QACF,OAAO;QACP,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,eAAe;IACb,eAAe;IACf,qBAAqB;IACrB,eAAe;CAChB,CAAC"}

package/dist/runtime/node.d.ts

@@ -0,0 +1,9 @@
+import { type UniversalRuntime, type UniversalRuntimeOptions } from './universal.js';
+import type { CapabilityModule } from './agentHost.js';
+import { OFFSEC_PROFILES, isOffsecProfile } from './profileGates.js';
+export { OFFSEC_PROFILES, isOffsecProfile };
+export interface NodeRuntimeOptions extends Omit<UniversalRuntimeOptions, 'additionalModules'> {
+    additionalModules?: CapabilityModule[];
+}
+export declare function createNodeRuntime(options: NodeRuntimeOptions): Promise<UniversalRuntime>;
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/runtime/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA6BvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;AAE5C,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IAC1D,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC;AAsDD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB9F"}

package/dist/runtime/node.js

@@ -0,0 +1,112 @@
+import { createUniversalRuntime } from './universal.js';
+import { FilesystemCapabilityModule, EditCapabilityModule, BashCapabilityModule, SearchCapabilityModule, WebCapabilityModule, HITLCapabilityModule, McpCapabilityModule, KaliCapabilityModule, AflppCapabilityModule, GdbCapabilityModule, PwntoolsCapabilityModule, BinaryAnalysisCapabilityModule, GhidraHeadlessCapabilityModule, LlmRedteamCapabilityModule, EngagementCapabilityModule, WorktreeCapabilityModule, PlanModeCapabilityModule, MonitorCapabilityModule, InteractionCapabilityModule, ScheduleCapabilityModule, TriggerCapabilityModule, } from '../capabilities/index.js';
+import { TodoCapabilityModule } from '../capabilities/todoCapability.js';
+import { MemoryCapabilityModule } from '../capabilities/memoryCapability.js';
+import { SkillCapabilityModule } from '../capabilities/skillCapability.js';
+import { NotebookCapabilityModule } from '../capabilities/notebookCapability.js';
+import { OFFSEC_PROFILES, isOffsecProfile } from './profileGates.js';
+import { createPhaseEmitterObserver } from './phaseEmitter.js';
+export { OFFSEC_PROFILES, isOffsecProfile };
+/**
+ * Build the capability set for the requested profile.
+ *
+ * Coding profiles get filesystem/edit/search/web/HITL/todo/memory/skill/
+ * notebook + MCP. Offsec profiles additionally get Kali/AFL++/gdb/
+ * pwntools/binary-analysis/Ghidra. The cowork productivity surface was
+ * extracted in 2026-05 to its own placeholder repo at
+ * ~/GitHub/erosolar-cowork — same engineering split Anthropic uses for
+ * Claude Code vs Claude Cowork.
+ */
+function createNodeCapabilityModules(profile) {
+    const modules = [
+        new FilesystemCapabilityModule(),
+        new EditCapabilityModule(),
+        new BashCapabilityModule(),
+        new SearchCapabilityModule(),
+        new WebCapabilityModule(),
+        new HITLCapabilityModule({ autoPause: true, timeoutMs: 0 }),
+        new TodoCapabilityModule(),
+        new MemoryCapabilityModule(),
+        new SkillCapabilityModule(),
+        new NotebookCapabilityModule(),
+        new WorktreeCapabilityModule(),
+        new PlanModeCapabilityModule(),
+        new MonitorCapabilityModule(),
+        new InteractionCapabilityModule(),
+        new ScheduleCapabilityModule(),
+        new TriggerCapabilityModule(),
+    ];
+    if (isOffsecProfile(profile)) {
+        modules.push(new KaliCapabilityModule(), new AflppCapabilityModule(), new GdbCapabilityModule(), new PwntoolsCapabilityModule(), new BinaryAnalysisCapabilityModule(), new GhidraHeadlessCapabilityModule(), new LlmRedteamCapabilityModule(), new EngagementCapabilityModule());
+    }
+    // MCP bridge auto-connects servers from .erosolar/mcp.json. The
+    // bridge itself is profile-agnostic; per-server tenant filtering
+    // happens inside McpCapabilityModule using each server's optional
+    // `profiles` allow-list.
+    modules.push(new McpCapabilityModule());
+    return modules;
+}
+export async function createNodeRuntime(options) {
+    const coreModules = createNodeCapabilityModules(options.profile);
+    const additionalModules = options.additionalModules ?? [];
+    // Compose the caller-supplied observer (if any) with the phase
+    // emitter so offsec tool calls auto-write into the engagement
+    // pipeline. For non-offsec profiles the emitter is a no-op object
+    // and we skip the merge entirely.
+    const phaseObserver = createPhaseEmitterObserver(options.profile);
+    const composedObserver = options.toolObserver
+        ? composeObservers(options.toolObserver, phaseObserver)
+        : (Object.keys(phaseObserver).length ? phaseObserver : undefined);
+    return createUniversalRuntime({
+        ...options,
+        toolObserver: composedObserver,
+        additionalModules: [...coreModules, ...additionalModules],
+    });
+}
+function composeObservers(a, b) {
+    return {
+        onToolStart(call) { try {
+            a.onToolStart?.(call);
+        }
+        catch { } try {
+            b.onToolStart?.(call);
+        }
+        catch { } },
+        onToolResult(call, output) { try {
+            a.onToolResult?.(call, output);
+        }
+        catch { } try {
+            b.onToolResult?.(call, output);
+        }
+        catch { } },
+        onToolError(call, error) { try {
+            a.onToolError?.(call, error);
+        }
+        catch { } try {
+            b.onToolError?.(call, error);
+        }
+        catch { } },
+        onCacheHit(call) { try {
+            a.onCacheHit?.(call);
+        }
+        catch { } try {
+            b.onCacheHit?.(call);
+        }
+        catch { } },
+        onToolProgress(call, progress) { try {
+            a.onToolProgress?.(call, progress);
+        }
+        catch { } try {
+            b.onToolProgress?.(call, progress);
+        }
+        catch { } },
+        onToolWarning(call, warning) { try {
+            a.onToolWarning?.(call, warning);
+        }
+        catch { } try {
+            b.onToolWarning?.(call, warning);
+        }
+        catch { } },
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/runtime/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/runtime/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAuD,MAAM,gBAAgB,CAAC;AAE7G,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;AAO5C;;;;;;;;;GASG;AACH,SAAS,2BAA2B,CAAC,OAAoB;IACvD,MAAM,OAAO,GAAuB;QAClC,IAAI,0BAA0B,EAAE;QAChC,IAAI,oBAAoB,EAAE;QAC1B,IAAI,oBAAoB,EAAE;QAC1B,IAAI,sBAAsB,EAAE;QAC5B,IAAI,mBAAmB,EAAE;QACzB,IAAI,oBAAoB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAC3D,IAAI,oBAAoB,EAAE;QAC1B,IAAI,sBAAsB,EAAE;QAC5B,IAAI,qBAAqB,EAAE;QAC3B,IAAI,wBAAwB,EAAE;QAC9B,IAAI,wBAAwB,EAAE;QAC9B,IAAI,wBAAwB,EAAE;QAC9B,IAAI,uBAAuB,EAAE;QAC7B,IAAI,2BAA2B,EAAE;QACjC,IAAI,wBAAwB,EAAE;QAC9B,IAAI,uBAAuB,EAAE;KAC9B,CAAC;IAEF,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,IAAI,CACV,IAAI,oBAAoB,EAAE,EAC1B,IAAI,qBAAqB,EAAE,EAC3B,IAAI,mBAAmB,EAAE,EACzB,IAAI,wBAAwB,EAAE,EAC9B,IAAI,8BAA8B,EAAE,EACpC,IAAI,8BAA8B,EAAE,EACpC,IAAI,0BAA0B,EAAE,EAChC,IAAI,0BAA0B,EAAE,CACjC,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,iEAAiE;IACjE,kEAAkE;IAClE,yBAAyB;IACzB,OAAO,CAAC,IAAI,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA2B;IACjE,MAAM,WAAW,GAAG,2BAA2B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAE1D,+DAA+D;IAC/D,8DAA8D;IAC9D,kEAAkE;IAClE,kCAAkC;IAClC,MAAM,aAAa,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,MAAM,gBAAgB,GACpB,OAAO,CAAC,YAAY;QAClB,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC;QACvD,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEtE,OAAO,sBAAsB,CAAC;QAC5B,GAAG,OAAO;QACV,YAAY,EAAE,gBAAgB;QAC9B,iBAAiB,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,iBAAiB,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAsB,EAAE,CAAsB;IACtE,OAAO;QACL,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC;YAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC;QACrG,YAAY,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC;YAAC,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC;QAChI,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;YAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC;QAC1H,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC;YAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC;QAClG,cAAc,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;YAAC,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC;QAC5I,aAAa,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC;YAAC,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC;YAAC,CAAC,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC;KACvI,CAAC;AACJ,CAAC"}

package/dist/runtime/phaseEmitter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Phase emitter — auto-instruments offsec tools so the portal's
+ * Engagement → Target → Finding phase tabs populate without the
+ * operator manually calling FindingUpdatePhase after every tool run.
+ *
+ * The mapping below routes a tool name (e.g. 'kali_subfinder',
+ * 'bin_radare2_cmd', 'afl_fuzz_start') to one of the canonical phase
+ * names the portal renders (recon, static, fuzz, triage, exploit,
+ * validate, disclose). On a successful tool result, the emitter:
+ *
+ *   1. Reads the active engagement / target / finding selection from
+ *      the EngagementCapability in-process state. If no finding is
+ *      selected, no-op (we don't invent a finding for a tool run).
+ *   2. Calls the cliFindingUpdate Lambda with `{ <phase>: { tool, args,
+ *      output, ts } }` merged into the finding doc. The CLI does not
+ *      block on Lambda — emit is fire-and-forget.
+ *   3. For long-running tools (afl_fuzz_start, ghidra_batch), also
+ *      writes a `users/<uid>/jobs/<id>` row via cliJobStart so the
+ *      portal's Jobs rail shows it live.
+ *
+ * Gating: only fires when the active profile is offsec (variant-research
+ * / engagement-delivery). Default coding sessions never emit. Best-
+ * effort throughout — a Lambda failure or unauthenticated session
+ * silently drops the emit; the tool result is unaffected.
+ */
+import type { ToolCallRequest } from '../core/types.js';
+import type { ToolRuntimeObserver } from '../core/toolRuntime.js';
+import type { ProfileName } from './profileGates.js';
+type Phase = 'recon' | 'static' | 'fuzz' | 'triage' | 'exploit' | 'validate' | 'disclose' | 'audit';
+export declare function phaseForTool(name: string): Phase | null;
+export declare function jobKindForTool(name: string): {
+    kind: string;
+    tool: string;
+} | null;
+export declare function jobEndStatusForTool(name: string): 'done' | 'stopped' | 'failed' | null;
+interface EmitContext {
+    profile: ProfileName;
+    /** Override for tests — when present, skips the offsec-profile gate. */
+    forceEmit?: boolean;
+}
+/**
+ * Emit a phase block for a successful tool call. Returns silently when
+ * gating denies the emit (wrong profile, no selection, no auth). Never
+ * throws — best-effort.
+ */
+export declare function emitPhaseRecord(call: ToolCallRequest, output: string, ctx: EmitContext): Promise<void>;
+/**
+ * Emit a Jobs record for a tool that starts a long-running background
+ * task. Re-issued via cliJobUpdate / cliJobComplete by the matching
+ * stop / status tools (or by the process-exit hook in
+ * tools/monitorTools.ts).
+ */
+export declare function emitJobStart(call: ToolCallRequest, output: string, ctx: EmitContext): Promise<void>;
+export declare function emitJobEnd(call: ToolCallRequest, output: string, ctx: EmitContext): Promise<void>;
+/**
+ * Build the ToolRuntimeObserver that hooks all three emits onto the
+ * runtime. Wire it via createNodeRuntime's `toolObserver` option.
+ * Returns a no-op observer for non-offsec profiles so the runtime
+ * doesn't pay the per-call cost when gating would deny anyway.
+ */
+export declare function createPhaseEmitterObserver(profile: ProfileName): ToolRuntimeObserver;
+export {};
+//# sourceMappingURL=phaseEmitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phaseEmitter.d.ts","sourceRoot":"","sources":["../../src/runtime/phaseEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,KAAK,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAgDpG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAMvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAElF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAEtF;AASD,UAAU,WAAW;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,mBAAmB,CAapF"}