mcp-codex-subagent 2.0.8 → 2.0.10

package/dist/event/bus.d.ts

@@ -0,0 +1,53 @@
+/**
+ * TaskEventBus — lightweight pub/sub for task events.
+ *
+ * Subscribers receive parsed event objects (not raw JSON strings).
+ * Supports per-task subscriptions and wildcard ('*') subscriptions.
+ *
+ * Phase 1: Used to decouple event flow from inline handler code.
+ * Phase 2: Wave orchestration subscribes here for progress streams.
+ */
+import type { ParsedProcessEvent } from '../process/types.js';
+/**
+ * Event delivered to subscribers.
+ */
+export interface TaskEvent {
+    taskId: string;
+    event: ParsedProcessEvent;
+}
+export type TaskEventCallback = (taskEvent: TaskEvent) => void;
+/**
+ * Unsubscribe function returned by subscribe().
+ */
+export type Unsubscribe = () => void;
+export declare class TaskEventBus {
+    /** Per-task subscribers */
+    private readonly taskSubs;
+    /** Wildcard subscribers (receive all events) */
+    private readonly wildcardSubs;
+    /**
+     * Subscribe to events for a specific task or all tasks ('*').
+     * Returns an unsubscribe function.
+     */
+    subscribe(taskIdOrWildcard: string, callback: TaskEventCallback): Unsubscribe;
+    /**
+     * Emit an event for a task.
+     * Delivers to per-task subscribers first, then wildcard subscribers.
+     */
+    emit(taskId: string, event: ParsedProcessEvent): void;
+    /**
+     * Remove all subscriptions for a specific task.
+     * Called when a task reaches a terminal state.
+     */
+    removeTaskSubscriptions(taskId: string): void;
+    /**
+     * Remove all subscriptions (for shutdown/testing).
+     */
+    clear(): void;
+    /**
+     * Get subscriber count (for diagnostics).
+     */
+    get subscriberCount(): number;
+}
+export declare const taskEventBus: TaskEventBus;
+//# sourceMappingURL=bus.d.ts.map

package/dist/event/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/event/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,qBAAa,YAAY;IACvB,2BAA2B;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IACtE,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAE7D;;;OAGG;IACH,SAAS,CACP,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,iBAAiB,GAC1B,WAAW;IAuBd;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAyBrD;;;OAGG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAM5B;CACF;AAID,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/event/bus.js

@@ -0,0 +1,94 @@
+/**
+ * TaskEventBus — lightweight pub/sub for task events.
+ *
+ * Subscribers receive parsed event objects (not raw JSON strings).
+ * Supports per-task subscriptions and wildcard ('*') subscriptions.
+ *
+ * Phase 1: Used to decouple event flow from inline handler code.
+ * Phase 2: Wave orchestration subscribes here for progress streams.
+ */
+export class TaskEventBus {
+    /** Per-task subscribers */
+    taskSubs = new Map();
+    /** Wildcard subscribers (receive all events) */
+    wildcardSubs = new Set();
+    /**
+     * Subscribe to events for a specific task or all tasks ('*').
+     * Returns an unsubscribe function.
+     */
+    subscribe(taskIdOrWildcard, callback) {
+        if (taskIdOrWildcard === '*') {
+            this.wildcardSubs.add(callback);
+            return () => {
+                this.wildcardSubs.delete(callback);
+            };
+        }
+        let subs = this.taskSubs.get(taskIdOrWildcard);
+        if (!subs) {
+            subs = new Set();
+            this.taskSubs.set(taskIdOrWildcard, subs);
+        }
+        subs.add(callback);
+        return () => {
+            subs.delete(callback);
+            if (subs.size === 0) {
+                this.taskSubs.delete(taskIdOrWildcard);
+            }
+        };
+    }
+    /**
+     * Emit an event for a task.
+     * Delivers to per-task subscribers first, then wildcard subscribers.
+     */
+    emit(taskId, event) {
+        const taskEvent = { taskId, event };
+        // Per-task subscribers
+        const subs = this.taskSubs.get(taskId);
+        if (subs) {
+            for (const cb of subs) {
+                try {
+                    cb(taskEvent);
+                }
+                catch {
+                    // Don't let one subscriber break others
+                }
+            }
+        }
+        // Wildcard subscribers
+        for (const cb of this.wildcardSubs) {
+            try {
+                cb(taskEvent);
+            }
+            catch {
+                // Don't let one subscriber break others
+            }
+        }
+    }
+    /**
+     * Remove all subscriptions for a specific task.
+     * Called when a task reaches a terminal state.
+     */
+    removeTaskSubscriptions(taskId) {
+        this.taskSubs.delete(taskId);
+    }
+    /**
+     * Remove all subscriptions (for shutdown/testing).
+     */
+    clear() {
+        this.taskSubs.clear();
+        this.wildcardSubs.clear();
+    }
+    /**
+     * Get subscriber count (for diagnostics).
+     */
+    get subscriberCount() {
+        let count = this.wildcardSubs.size;
+        for (const subs of this.taskSubs.values()) {
+            count += subs.size;
+        }
+        return count;
+    }
+}
+// --- Module-level singleton ---
+export const taskEventBus = new TaskEventBus();
+//# sourceMappingURL=bus.js.map

package/dist/event/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../src/event/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,MAAM,OAAO,YAAY;IACvB,2BAA2B;IACV,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IACtE,gDAAgD;IAC/B,YAAY,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE7D;;;OAGG;IACH,SAAS,CACP,gBAAwB,EACxB,QAA2B;QAE3B,IAAI,gBAAgB,KAAK,GAAG,EAAE,CAAC;YAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChC,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnB,OAAO,GAAG,EAAE;YACV,IAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvB,IAAI,IAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,MAAc,EAAE,KAAyB;QAC5C,MAAM,SAAS,GAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAE/C,uBAAuB;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,EAAE,CAAC,SAAS,CAAC,CAAC;gBAChB,CAAC;gBAAC,MAAM,CAAC;oBACP,wCAAwC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,uBAAuB,CAAC,MAAc;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACjB,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,iCAAiC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/event/throttle.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Notification throttle — coalesces MCP resource-update notifications.
+ *
+ * Under high parallelism, many tasks complete/update simultaneously.
+ * Instead of sending one notification per event, we batch them over
+ * a configurable window and send at most one per window.
+ */
+export interface ThrottleOptions {
+    /** Coalesce window in ms (default: 500) */
+    intervalMs?: number;
+    /** Callback to send the actual notification */
+    send: () => Promise<void>;
+}
+export declare class NotificationThrottle {
+    private readonly intervalMs;
+    private readonly send;
+    private timer;
+    private pending;
+    constructor(options: ThrottleOptions);
+    /**
+     * Request a notification. If one is already pending in the current
+     * window, this is a no-op (coalesced). Otherwise, schedules delivery
+     * at the end of the window.
+     */
+    notify(): void;
+    /**
+     * Flush any pending notification immediately.
+     * Call this during shutdown to ensure final state is delivered.
+     */
+    flush(): Promise<void>;
+    /**
+     * Cancel any pending notification and stop the throttle.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=throttle.d.ts.map

package/dist/event/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/event/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,eAAe;IAKpC;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAed;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/event/throttle.js

@@ -0,0 +1,66 @@
+/**
+ * Notification throttle — coalesces MCP resource-update notifications.
+ *
+ * Under high parallelism, many tasks complete/update simultaneously.
+ * Instead of sending one notification per event, we batch them over
+ * a configurable window and send at most one per window.
+ */
+export class NotificationThrottle {
+    intervalMs;
+    send;
+    timer = null;
+    pending = false;
+    constructor(options) {
+        this.intervalMs = options.intervalMs ?? 500;
+        this.send = options.send;
+    }
+    /**
+     * Request a notification. If one is already pending in the current
+     * window, this is a no-op (coalesced). Otherwise, schedules delivery
+     * at the end of the window.
+     */
+    notify() {
+        this.pending = true;
+        if (this.timer !== null)
+            return; // already scheduled
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            if (this.pending) {
+                this.pending = false;
+                this.send().catch(() => {
+                    // Non-fatal — client may not support notifications
+                });
+            }
+        }, this.intervalMs);
+    }
+    /**
+     * Flush any pending notification immediately.
+     * Call this during shutdown to ensure final state is delivered.
+     */
+    async flush() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.pending) {
+            this.pending = false;
+            try {
+                await this.send();
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+    }
+    /**
+     * Cancel any pending notification and stop the throttle.
+     */
+    dispose() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.pending = false;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/dist/event/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/event/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,OAAO,oBAAoB;IACd,UAAU,CAAS;IACnB,IAAI,CAAsB;IACnC,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,OAAwB;QAClC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,oBAAoB;QAErD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;gBACrB,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;oBACrB,mDAAmD;gBACrD,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CACF"}

package/dist/index.js

@@ -2,12 +2,22 @@
 import chalk from 'chalk';
 import { CodexMcpServer } from './server.js';
 import { closeAllOutputHandles } from './services/output-file.js';
+import { initTemplates } from './services/template-init.js';
+import { validateAccountsBinary, cleanupRotationLock, } from './services/account-rotator.js';
+import { taskStore } from './task/store.js';
+import { flushNotifications } from './tools/handlers.js';
+import { taskEventBus } from './event/bus.js';
+import { groupRegistry } from './wave/registry.js';
+import { concurrencySemaphore } from './wave/semaphore.js';
 const SERVER_CONFIG = {
     name: 'codex-mcp-server',
     version: '0.0.6',
 };
 async function main() {
     try {
+        await initTemplates(); // Must happen before server construction
+        validateAccountsBinary(); // Throws if CODEX_ROTATE=1 and binary missing
+        groupRegistry.loadAll(); // Restore group state from JSONL
         const server = new CodexMcpServer(SERVER_CONFIG);
         await server.start();
     }
@@ -16,9 +26,30 @@ async function main() {
         process.exit(1);
     }
 }
-// Graceful shutdown: close all output file handles
+// Graceful shutdown: cancel tasks, flush notifications, close handles
 async function shutdown() {
     try {
+        // 1. Dispose semaphore (reject all queued waiters)
+        concurrencySemaphore.dispose();
+        // 2. Cancel all running tasks (triggers process kills + cleanup)
+        const cancelled = await taskStore.cancelAll();
+        if (cancelled > 0) {
+            console.error(chalk.yellow(`Shutdown: cancelled ${cancelled} running task(s)`));
+        }
+        // 3. Transition non-terminal groups to done_timeout
+        for (const group of groupRegistry.getAllNonTerminal()) {
+            groupRegistry.transitionGroup(group.id, 'done_timeout', {
+                error: 'Server shutdown',
+            });
+            groupRegistry.persist(group.id);
+        }
+        // 4. Clean up rotation lock if held by this process
+        cleanupRotationLock();
+        // 5. Flush pending notifications
+        await flushNotifications();
+        // 6. Clear event bus subscriptions
+        taskEventBus.clear();
+        // 7. Close all output file handles
         await closeAllOutputHandles();
     }
     catch {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACR,CAAC;AAEX,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC;QACH,MAAM,qBAAqB,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACR,CAAC;AAEX,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,aAAa,EAAE,CAAC,CAAC,yCAAyC;QAChE,sBAAsB,EAAE,CAAC,CAAC,8CAA8C;QACxE,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,iCAAiC;QAC1D,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC;QACH,mDAAmD;QACnD,oBAAoB,CAAC,OAAO,EAAE,CAAC;QAE/B,iEAAiE;QACjE,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;QAC9C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CAAC,uBAAuB,SAAS,kBAAkB,CAAC,CACjE,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACtD,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,EAAE;gBACtD,KAAK,EAAE,iBAAiB;aACzB,CAAC,CAAC;YACH,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,oDAAoD;QACpD,mBAAmB,EAAE,CAAC;QAEtB,iCAAiC;QACjC,MAAM,kBAAkB,EAAE,CAAC;QAE3B,mCAAmC;QACnC,YAAY,CAAC,KAAK,EAAE,CAAC;QAErB,mCAAmC;QACnC,MAAM,qBAAqB,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,IAAI,EAAE,CAAC"}

package/dist/process/event-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * JSONL event parser for codex --json output.
+ *
+ * Extracted from tools/handlers.ts to be reusable across
+ * single-agent runner and future wave orchestration.
+ *
+ * Design:
+ *   - Skips streaming intermediates (item.started, thread.started, turn.started)
+ *   - Extracts completed items as clean JSONL
+ *   - Preserves turn.completed for usage stats
+ *   - Preserves turn.failed and item.failed for error visibility
+ *   - Normalises legacy event shapes to the modern item schema
+ *
+ * Ref: https://developers.openai.com/codex/noninteractive/
+ */
+import type { ParsedProcessEvent } from './types.js';
+/**
+ * Test whether a stderr chunk is noise (should be dropped).
+ */
+export declare function isStderrNoise(chunk: string): boolean;
+/**
+ * Parse a single JSONL line from codex --json output.
+ *
+ * Returns a normalized JSON string, or null if the line should be skipped
+ * (intermediates, empty lines, malformed JSON).
+ */
+export declare function parseCodexEvent(line: string): string | null;
+/**
+ * Parse a JSON string into a typed event object.
+ * Returns null if parsing fails.
+ */
+export declare function parseEventString(jsonStr: string): ParsedProcessEvent | null;
+/**
+ * Create a stderr event JSON string from a raw chunk.
+ */
+export declare function createStderrEvent(chunk: string): string;
+//# sourceMappingURL=event-parser.d.ts.map

package/dist/process/event-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-parser.d.ts","sourceRoot":"","sources":["../../src/process/event-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBrD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuF3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAU3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/process/event-parser.js

@@ -0,0 +1,141 @@
+/**
+ * JSONL event parser for codex --json output.
+ *
+ * Extracted from tools/handlers.ts to be reusable across
+ * single-agent runner and future wave orchestration.
+ *
+ * Design:
+ *   - Skips streaming intermediates (item.started, thread.started, turn.started)
+ *   - Extracts completed items as clean JSONL
+ *   - Preserves turn.completed for usage stats
+ *   - Preserves turn.failed and item.failed for error visibility
+ *   - Normalises legacy event shapes to the modern item schema
+ *
+ * Ref: https://developers.openai.com/codex/noninteractive/
+ */
+/**
+ * Known stderr noise patterns from codex-core internals.
+ * These are non-actionable internal diagnostics that pollute output.
+ */
+const STDERR_NOISE_PATTERNS = [
+    'state db missing rollout path',
+    'missing rollout path for thread',
+    'codex_core::rollout::list',
+    'codex_core::config_watcher',
+    'codex_core::telemetry',
+    'Refreshing model list',
+    'model list refreshed',
+];
+/**
+ * Test whether a stderr chunk is noise (should be dropped).
+ */
+export function isStderrNoise(chunk) {
+    return STDERR_NOISE_PATTERNS.some((p) => chunk.includes(p));
+}
+/**
+ * Parse a single JSONL line from codex --json output.
+ *
+ * Returns a normalized JSON string, or null if the line should be skipped
+ * (intermediates, empty lines, malformed JSON).
+ */
+export function parseCodexEvent(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    try {
+        const event = JSON.parse(trimmed);
+        // 1. Skip lifecycle / streaming intermediate events
+        if (event.type === 'thread.started' ||
+            event.type === 'turn.started' ||
+            event.type === 'item.started') {
+            return null;
+        }
+        // 2. Turn completion — emit usage stats
+        if (event.type === 'turn.completed') {
+            if (event.usage) {
+                return JSON.stringify({ type: 'turn_usage', ...event.usage });
+            }
+            return null;
+        }
+        // 3. Turn failure — surface error
+        if (event.type === 'turn.failed') {
+            const err = event.error;
+            return JSON.stringify({
+                type: 'turn_failed',
+                code: err?.code ?? err?.codexErrorInfo?.type ?? null,
+                message: err?.message || 'Unknown turn failure',
+            });
+        }
+        // 4. Item failed — emit item with _failed marker
+        if (event.type === 'item.failed' && event.item) {
+            return JSON.stringify({ ...event.item, _failed: true });
+        }
+        // 5. Item completed — the primary event
+        if (event.type === 'item.completed' && event.item) {
+            return JSON.stringify(event.item);
+        }
+        // 6. Top-level error
+        if (event.type === 'error') {
+            const err = event.error ?? event;
+            return JSON.stringify({
+                type: 'error',
+                code: err.code ?? null,
+                message: err.message || trimmed,
+            });
+        }
+        // 7. Legacy / alternate event shapes (pre-2025)
+        if (event.type === 'message' && event.content) {
+            return JSON.stringify({
+                id: event.id ?? null,
+                type: 'agent_message',
+                text: event.content,
+            });
+        }
+        if (event.type === 'function_call') {
+            return JSON.stringify({
+                id: event.id ?? null,
+                type: 'function_call',
+                name: event.name,
+                arguments: event.arguments,
+            });
+        }
+        if (event.type === 'function_call_output') {
+            return JSON.stringify({
+                id: event.id ?? null,
+                type: 'function_call_output',
+                output: typeof event.output === 'string'
+                    ? event.output
+                    : JSON.stringify(event.output),
+            });
+        }
+        // 8. Unknown event — pass through
+        return JSON.stringify(event);
+    }
+    catch {
+        // Not valid JSON — skip malformed lines
+        return null;
+    }
+}
+/**
+ * Parse a JSON string into a typed event object.
+ * Returns null if parsing fails.
+ */
+export function parseEventString(jsonStr) {
+    try {
+        const parsed = JSON.parse(jsonStr);
+        if (parsed && typeof parsed === 'object' && parsed.type) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create a stderr event JSON string from a raw chunk.
+ */
+export function createStderrEvent(chunk) {
+    return JSON.stringify({ type: 'stderr', text: chunk.slice(0, 500) });
+}
+//# sourceMappingURL=event-parser.js.map

package/dist/process/event-parser.js.map

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

package/dist/process/runner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * CodexProcessRunner — owns the lifecycle of one codex child process.
+ *
+ * Responsibilities:
+ * - Spawn the codex process
+ * - Line-buffer stdout for JSONL parsing
+ * - Filter stderr noise
+ * - Emit normalized events via callbacks
+ * - Deterministic cleanup: SIGTERM → grace → SIGKILL → remove listeners
+ *
+ * Single-use: one runner per task, created once, not reused.
+ */
+import { type ProcessState, type SpawnOptions, type ProcessCallbacks, type ProcessExitInfo, type ProcessHandle } from './types.js';
+export declare class CodexProcessRunner {
+    private child;
+    private _state;
+    private stdoutBuffer;
+    private readonly killGraceMs;
+    private readonly callbacks;
+    private exitPromise;
+    private exitResolve;
+    private wasKilledByUs;
+    constructor(callbacks: ProcessCallbacks, killGraceMs?: number);
+    get state(): ProcessState;
+    /**
+     * Spawn the codex process. Returns a ProcessHandle for PID access
+     * and kill control.
+     */
+    spawn(options: SpawnOptions): ProcessHandle;
+    /**
+     * Kill the process deterministically.
+     * SIGTERM → wait grace period → SIGKILL → wait for exit.
+     */
+    kill(): Promise<void>;
+    /**
+     * Wait for the process to exit naturally.
+     */
+    waitForExit(): Promise<ProcessExitInfo>;
+    private onStdout;
+    private onStderr;
+    private onClose;
+    private onError;
+    /**
+     * Remove all listeners from the child process.
+     */
+    private removeListeners;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/process/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/process/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAUpB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,WAAW,CAAkD;IACrE,OAAO,CAAC,aAAa,CAAS;gBAElB,SAAS,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM;IAK7D,IAAI,KAAK,IAAI,YAAY,CAExB;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa;IAuD3C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD3B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;IAS7C,OAAO,CAAC,QAAQ,CAgBd;IAEF,OAAO,CAAC,QAAQ,CAWd;IAEF,OAAO,CAAC,OAAO,CAoCb;IAEF,OAAO,CAAC,OAAO,CAgBb;IAEF;;OAEG;IACH,OAAO,CAAC,eAAe;CAOxB"}