@tickernelz/paperclip-pro-adapter-codex-local 2026.925.0

package/dist/server/output-inactivity-monitor.integration.test.js

@@ -0,0 +1,136 @@
+import { describe, expect, it } from "vitest";
+import { runChildProcess } from "@tickernelz/paperclip-pro-adapter-utils/server-utils";
+import { CODEX_OUTPUT_INACTIVITY_MONITOR_SIGTERM_GRACE_MS, createCodexOutputInactivityMonitor, formatOutputInactivityMonitorErrorMessage, } from "./output-inactivity-monitor.js";
+import { createCodexProcessActivityMonitor } from "./process-activity-monitor.js";
+const FAKE_CODEX_SCRIPT = `
+process.stdout.write(JSON.stringify({ type: "thread.started", thread_id: "abc" }) + "\\n");
+// Simulate a wedged codex: read stdin forever, never write again.
+process.stdin.resume();
+process.stdin.on("data", () => {});
+setInterval(() => {}, 60_000);
+`;
+describe("codex inactivity monitor (integration: real subprocess)", () => {
+    it.skipIf(process.platform !== "linux")("allows a long silent build while the child process group is consuming CPU", async () => {
+        const runId = `monitor-active-build-${Date.now()}`;
+        const timeoutMs = 500;
+        const processActivityMonitor = { current: null };
+        let monitorFired = false;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs,
+            onFire: () => {
+                monitorFired = true;
+            },
+        });
+        try {
+            const proc = await runChildProcess(runId, process.execPath, ["-e", "const end = Date.now() + 2_000; while (Date.now() < end) {}"], {
+                cwd: process.cwd(),
+                env: process.env,
+                timeoutSec: 5,
+                graceSec: 1,
+                onSpawn: async (meta) => {
+                    processActivityMonitor.current = createCodexProcessActivityMonitor({
+                        pid: meta.pid,
+                        processGroupId: meta.processGroupId,
+                        intervalMs: 50,
+                        onActivity: () => monitor.noteProcessActivity(),
+                    });
+                },
+                onLog: async (stream, chunk) => monitor.noteOutputChunk(stream, chunk),
+            });
+            expect(proc.exitCode).toBe(0);
+            expect(proc.timedOut).toBe(false);
+            expect(monitorFired).toBe(false);
+            expect(monitor.state().processActivityCount).toBeGreaterThan(0);
+        }
+        finally {
+            processActivityMonitor.current?.stop();
+            monitor.stop();
+        }
+    }, 10_000);
+    it("kills a codex child that goes silent after one event and surfaces a monitor failure", async () => {
+        const runId = `monitor-integration-${Date.now()}`;
+        const timeoutMs = 250;
+        const logs = [];
+        let killTarget = null;
+        let monitorFired = false;
+        let terminationSignal = null;
+        let sigkillTimer = null;
+        const processActivityMonitor = { current: null };
+        let elapsedMs = 0;
+        const kill = (signal) => {
+            const target = killTarget;
+            if (!target)
+                return false;
+            if (target.processGroupId && target.processGroupId > 0) {
+                try {
+                    process.kill(-target.processGroupId, signal);
+                    return true;
+                }
+                catch {
+                    /* fall through */
+                }
+            }
+            if (target.pid && target.pid > 0) {
+                try {
+                    process.kill(target.pid, signal);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            }
+            return false;
+        };
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs,
+            onFire: (state) => {
+                monitorFired = true;
+                elapsedMs = (state.firedAt ?? Date.now()) - state.lastEventAt;
+                if (kill("SIGTERM"))
+                    terminationSignal = "SIGTERM";
+                sigkillTimer = setTimeout(() => {
+                    if (kill("SIGKILL"))
+                        terminationSignal = "SIGKILL";
+                }, CODEX_OUTPUT_INACTIVITY_MONITOR_SIGTERM_GRACE_MS);
+            },
+        });
+        try {
+            const proc = await runChildProcess(runId, process.execPath, ["-e", FAKE_CODEX_SCRIPT], {
+                cwd: process.cwd(),
+                env: process.env,
+                timeoutSec: 30,
+                graceSec: 1,
+                onSpawn: async (meta) => {
+                    killTarget = { pid: meta.pid, processGroupId: meta.processGroupId };
+                    processActivityMonitor.current = createCodexProcessActivityMonitor({
+                        pid: meta.pid,
+                        processGroupId: meta.processGroupId,
+                        intervalMs: 25,
+                        onActivity: () => monitor.noteProcessActivity(),
+                    });
+                },
+                onLog: async (stream, chunk) => {
+                    logs.push({ stream, chunk });
+                    monitor.noteOutputChunk(stream, chunk);
+                },
+            });
+            expect(monitorFired, "monitor should fire when codex goes silent").toBe(true);
+            // Process was killed by our signal, not by hitting timeoutSec.
+            expect(proc.timedOut).toBe(false);
+            expect(["SIGTERM", "SIGKILL"]).toContain(proc.signal);
+            expect(["SIGTERM", "SIGKILL"]).toContain(terminationSignal);
+            // The errorMessage shape mirrors the AdapterExecutionResult that
+            // execute.ts will produce for this case.
+            expect(formatOutputInactivityMonitorErrorMessage(elapsedMs)).toMatch(/^monitor: no codex activity \(output or process\) for \d+m \d+s$/);
+            // We should have observed exactly one parsed JSONL event before silence.
+            expect(monitor.state().parsedEventCount).toBe(1);
+        }
+        finally {
+            processActivityMonitor.current?.stop();
+            monitor.stop();
+            if (sigkillTimer)
+                clearTimeout(sigkillTimer);
+        }
+    }, 15_000);
+});
+//# sourceMappingURL=output-inactivity-monitor.integration.test.js.map

package/dist/server/output-inactivity-monitor.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-inactivity-monitor.integration.test.js","sourceRoot":"","sources":["../../src/server/output-inactivity-monitor.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/server/output-inactivity-monitor.js

@@ -0,0 +1,112 @@
+import { parseJson } from "@tickernelz/paperclip-pro-adapter-utils/server-utils";
+export const DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS = 30 * 60 * 1000;
+export const CODEX_OUTPUT_INACTIVITY_MONITOR_SIGTERM_GRACE_MS = 5_000;
+/**
+ * Resolve the inactivity monitor timeout from raw adapter config.
+ *
+ * - `null`         → disabled (explicit escape hatch).
+ * - missing/`undefined` → default 30m.
+ * - number > 0     → configured value.
+ * - number ≤ 0     → default 30m (and a `non_positive` note for logging).
+ */
+export function resolveCodexInactivityTimeout(rawValue) {
+    if (rawValue === null)
+        return { mode: "disabled", reason: "explicit_null" };
+    if (typeof rawValue === "number" && Number.isFinite(rawValue)) {
+        if (rawValue > 0)
+            return { mode: "configured", timeoutMs: rawValue };
+        return { mode: "default", timeoutMs: DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS, reason: "non_positive" };
+    }
+    return { mode: "default", timeoutMs: DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS };
+}
+function defaultIsHeartbeatLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return false;
+    return parseJson(trimmed) !== null;
+}
+export function createCodexOutputInactivityMonitor(options) {
+    const now = options.now ?? (() => Date.now());
+    const setTimer = options.setTimer ?? ((cb, ms) => setTimeout(cb, ms));
+    const clearTimer = options.clearTimer ?? ((h) => clearTimeout(h));
+    const isHeartbeatLine = options.isHeartbeatLine ?? defaultIsHeartbeatLine;
+    const timeoutMs = options.timeoutMs;
+    if (!(timeoutMs > 0)) {
+        throw new Error(`createCodexOutputInactivityMonitor requires timeoutMs > 0 (got ${timeoutMs})`);
+    }
+    const spawnedAt = now();
+    const state = {
+        fired: false,
+        spawnedAt,
+        lastEventAt: spawnedAt,
+        firedAt: null,
+        outputChunkCount: 0,
+        outputBytes: 0,
+        parsedEventCount: 0,
+        processActivityCount: 0,
+    };
+    let timerHandle = null;
+    let stopped = false;
+    const fire = () => {
+        if (state.fired || stopped)
+            return;
+        state.fired = true;
+        state.firedAt = now();
+        timerHandle = null;
+        options.onFire({ ...state });
+    };
+    const arm = () => {
+        if (stopped || state.fired)
+            return;
+        if (timerHandle != null)
+            clearTimer(timerHandle);
+        timerHandle = setTimer(fire, timeoutMs);
+    };
+    arm();
+    return {
+        noteOutputChunk(stream, chunk) {
+            if (stopped || state.fired || chunk.length === 0)
+                return;
+            state.outputChunkCount += 1;
+            state.outputBytes += Buffer.byteLength(chunk, "utf8");
+            if (stream === "stdout") {
+                for (const rawLine of chunk.split(/\r?\n/)) {
+                    if (isHeartbeatLine(rawLine)) {
+                        state.parsedEventCount += 1;
+                    }
+                }
+            }
+            state.lastEventAt = now();
+            arm();
+        },
+        noteProcessActivity() {
+            if (stopped || state.fired)
+                return;
+            state.processActivityCount += 1;
+            state.lastEventAt = now();
+            arm();
+        },
+        state() {
+            return { ...state };
+        },
+        stop() {
+            stopped = true;
+            if (timerHandle != null) {
+                clearTimer(timerHandle);
+                timerHandle = null;
+            }
+            return { ...state };
+        },
+    };
+}
+/**
+ * Format the inactivity monitor error message in the canonical
+ * `monitor: no codex activity (output or process) for {N}m {S}s` shape consumed by NEE-81.
+ */
+export function formatOutputInactivityMonitorErrorMessage(elapsedMs) {
+    const total = Math.max(0, Math.round(elapsedMs / 1000));
+    const minutes = Math.floor(total / 60);
+    const seconds = total - minutes * 60;
+    return `monitor: no codex activity (output or process) for ${minutes}m ${seconds}s`;
+}
+//# sourceMappingURL=output-inactivity-monitor.js.map

package/dist/server/output-inactivity-monitor.js.map

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

package/dist/server/output-inactivity-monitor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output-inactivity-monitor.test.d.ts.map

package/dist/server/output-inactivity-monitor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-inactivity-monitor.test.d.ts","sourceRoot":"","sources":["../../src/server/output-inactivity-monitor.test.ts"],"names":[],"mappings":""}

package/dist/server/output-inactivity-monitor.test.js

@@ -0,0 +1,284 @@
+import { describe, expect, it } from "vitest";
+import { CODEX_OUTPUT_INACTIVITY_MONITOR_SIGTERM_GRACE_MS, DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS, createCodexOutputInactivityMonitor, formatOutputInactivityMonitorErrorMessage, resolveCodexInactivityTimeout, } from "./output-inactivity-monitor.js";
+class FakeClock {
+    nowMs = 0;
+    nextHandle = 1;
+    timers = new Map();
+    now() {
+        return this.nowMs;
+    }
+    setTimer(cb, ms) {
+        const handle = this.nextHandle++;
+        this.timers.set(handle, { fireAt: this.nowMs + ms, cb });
+        return handle;
+    }
+    clearTimer(handle) {
+        if (typeof handle === "number")
+            this.timers.delete(handle);
+    }
+    advance(ms) {
+        const targetMs = this.nowMs + ms;
+        while (true) {
+            let nextHandle = null;
+            let nextTimer = null;
+            for (const [h, timer] of this.timers) {
+                if (timer.fireAt <= targetMs && (!nextTimer || timer.fireAt < nextTimer.fireAt)) {
+                    nextHandle = h;
+                    nextTimer = timer;
+                }
+            }
+            if (!nextTimer || nextHandle == null)
+                break;
+            this.timers.delete(nextHandle);
+            this.nowMs = nextTimer.fireAt;
+            nextTimer.cb();
+        }
+        this.nowMs = targetMs;
+    }
+    pendingTimerCount() {
+        return this.timers.size;
+    }
+}
+describe("resolveCodexInactivityTimeout", () => {
+    it("defaults to 30 minutes", () => {
+        expect(DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS).toBe(30 * 60 * 1000);
+    });
+    it("uses default when value is unset", () => {
+        expect(resolveCodexInactivityTimeout(undefined)).toEqual({
+            mode: "default",
+            timeoutMs: DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS,
+        });
+    });
+    it("treats explicit null as disabled", () => {
+        expect(resolveCodexInactivityTimeout(null)).toEqual({
+            mode: "disabled",
+            reason: "explicit_null",
+        });
+    });
+    it("returns configured value for positive numbers", () => {
+        expect(resolveCodexInactivityTimeout(12_000)).toEqual({
+            mode: "configured",
+            timeoutMs: 12_000,
+        });
+    });
+    it("falls back to default for non-positive numbers", () => {
+        expect(resolveCodexInactivityTimeout(0)).toEqual({
+            mode: "default",
+            timeoutMs: DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS,
+            reason: "non_positive",
+        });
+        expect(resolveCodexInactivityTimeout(-100)).toEqual({
+            mode: "default",
+            timeoutMs: DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS,
+            reason: "non_positive",
+        });
+    });
+    it("falls back to default for non-number, non-null values", () => {
+        expect(resolveCodexInactivityTimeout("420000")).toEqual({
+            mode: "default",
+            timeoutMs: DEFAULT_CODEX_OUTPUT_INACTIVITY_TIMEOUT_MS,
+        });
+    });
+});
+describe("formatOutputInactivityMonitorErrorMessage", () => {
+    it("formats minutes and seconds", () => {
+        expect(formatOutputInactivityMonitorErrorMessage(0)).toBe("monitor: no codex activity (output or process) for 0m 0s");
+        expect(formatOutputInactivityMonitorErrorMessage(7 * 60 * 1000)).toBe("monitor: no codex activity (output or process) for 7m 0s");
+        expect(formatOutputInactivityMonitorErrorMessage(7 * 60 * 1000 + 12_000)).toBe("monitor: no codex activity (output or process) for 7m 12s");
+        expect(formatOutputInactivityMonitorErrorMessage(45_000)).toBe("monitor: no codex activity (output or process) for 0m 45s");
+    });
+});
+describe("createCodexOutputInactivityMonitor (acceptance criteria 1: fires)", () => {
+    it("fires after timeoutMs when child emits one event then goes silent", () => {
+        const clock = new FakeClock();
+        const fires = [];
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs: 7 * 60 * 1000,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: (state) => {
+                fires.push({
+                    elapsed: (state.firedAt ?? 0) - state.lastEventAt,
+                    parsedEventCount: state.parsedEventCount,
+                });
+            },
+        });
+        // One event right after spawn.
+        clock.advance(50);
+        monitor.noteOutputChunk("stdout", '{"type":"thread.started","thread_id":"abc"}\n');
+        expect(fires).toHaveLength(0);
+        expect(monitor.state().parsedEventCount).toBe(1);
+        // Now go silent for 7 minutes; monitor should fire exactly at threshold.
+        clock.advance(7 * 60 * 1000 - 1);
+        expect(fires).toHaveLength(0);
+        clock.advance(1);
+        expect(fires).toHaveLength(1);
+        expect(fires[0].elapsed).toBe(7 * 60 * 1000);
+        expect(fires[0].parsedEventCount).toBe(1);
+        // Stopping after fire is a no-op for the timer but returns final state.
+        const finalState = monitor.stop();
+        expect(finalState.fired).toBe(true);
+    });
+    it("only fires once even if more silence elapses after firing", () => {
+        const clock = new FakeClock();
+        let fireCount = 0;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs: 1_000,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: () => {
+                fireCount += 1;
+            },
+        });
+        clock.advance(2_000);
+        expect(fireCount).toBe(1);
+        clock.advance(10_000);
+        expect(fireCount).toBe(1);
+        monitor.stop();
+    });
+    it("resets on non-JSON stdout bytes", () => {
+        const clock = new FakeClock();
+        let fireCount = 0;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs: 1_000,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: () => {
+                fireCount += 1;
+            },
+        });
+        clock.advance(500);
+        monitor.noteOutputChunk("stdout", "loading model...\n");
+        expect(monitor.state()).toMatchObject({
+            outputChunkCount: 1,
+            outputBytes: Buffer.byteLength("loading model...\n", "utf8"),
+            parsedEventCount: 0,
+        });
+        clock.advance(999);
+        expect(fireCount).toBe(0);
+        clock.advance(1);
+        expect(fireCount).toBe(1);
+        monitor.stop();
+    });
+    it("resets on process activity without output", () => {
+        const clock = new FakeClock();
+        let fireCount = 0;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs: 1_000,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: () => {
+                fireCount += 1;
+            },
+        });
+        clock.advance(900);
+        monitor.noteProcessActivity();
+        expect(monitor.state().processActivityCount).toBe(1);
+        clock.advance(999);
+        expect(fireCount).toBe(0);
+        clock.advance(1);
+        expect(fireCount).toBe(1);
+        monitor.stop();
+    });
+});
+describe("createCodexOutputInactivityMonitor (acceptance criteria 2: does not fire)", () => {
+    it("keeps long verification alive while non-JSON stdout and stderr bytes continue", () => {
+        const clock = new FakeClock();
+        let fireCount = 0;
+        const timeoutMs = 7 * 60 * 1000;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: () => {
+                fireCount += 1;
+            },
+        });
+        clock.advance(timeoutMs - 1_000);
+        monitor.noteOutputChunk("stdout", "packages/server: typecheck passed\n");
+        clock.advance(timeoutMs - 1_000);
+        monitor.noteOutputChunk("stderr", "packages/ui: build still running\n");
+        clock.advance(timeoutMs - 1_000);
+        monitor.noteOutputChunk("stdout", "packages/ui: build passed\n");
+        expect(fireCount).toBe(0);
+        expect(monitor.state()).toMatchObject({
+            outputChunkCount: 3,
+            parsedEventCount: 0,
+            fired: false,
+        });
+        monitor.stop();
+    });
+    it("does not fire when events arrive every (threshold - 1s)", () => {
+        const clock = new FakeClock();
+        let fireCount = 0;
+        const timeoutMs = 7 * 60 * 1000;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: () => {
+                fireCount += 1;
+            },
+        });
+        // Pump events at threshold-1s intervals for 12 cycles (~84 minutes).
+        for (let i = 0; i < 12; i += 1) {
+            clock.advance(timeoutMs - 1_000);
+            monitor.noteOutputChunk("stdout", `{"type":"item.completed","item":{"type":"agent_message","text":"tick ${i}"}}\n`);
+            expect(fireCount).toBe(0);
+        }
+        // Final event lets us "complete" — total state shows 12 parsed events.
+        expect(monitor.state().parsedEventCount).toBe(12);
+        expect(fireCount).toBe(0);
+        // Stop cleanly before the timer would have fired.
+        monitor.stop();
+        expect(fireCount).toBe(0);
+    });
+    it("multiple events in one chunk all reset the timer", () => {
+        const clock = new FakeClock();
+        let fireCount = 0;
+        const monitor = createCodexOutputInactivityMonitor({
+            timeoutMs: 1_000,
+            now: () => clock.now(),
+            setTimer: (cb, ms) => clock.setTimer(cb, ms),
+            clearTimer: (handle) => clock.clearTimer(handle),
+            onFire: () => {
+                fireCount += 1;
+            },
+        });
+        clock.advance(500);
+        monitor.noteOutputChunk("stdout", '{"type":"thread.started","thread_id":"a"}\n{"type":"item.completed","item":{"type":"agent_message","text":"hi"}}\n');
+        expect(monitor.state().parsedEventCount).toBe(2);
+        // Now wait 999ms — should still not fire.
+        clock.advance(999);
+        expect(fireCount).toBe(0);
+        // Wait one more ms — fires now.
+        clock.advance(1);
+        expect(fireCount).toBe(1);
+        monitor.stop();
+    });
+});
+describe("createCodexOutputInactivityMonitor (acceptance criteria 3: disabled)", () => {
+    it("resolveCodexInactivityTimeout returns disabled for null and the adapter creates no monitor", () => {
+        const resolution = resolveCodexInactivityTimeout(null);
+        expect(resolution.mode).toBe("disabled");
+        // Sanity: when a caller (execute.ts) honors `disabled`, it must not
+        // construct a monitor at all. Verify the constructor would otherwise
+        // require a positive timeoutMs.
+        expect(() => createCodexOutputInactivityMonitor({
+            timeoutMs: 0,
+            onFire: () => { },
+        })).toThrow(/timeoutMs > 0/);
+    });
+});
+describe("CODEX_OUTPUT_INACTIVITY_MONITOR_SIGTERM_GRACE_MS", () => {
+    it("matches the 5-second grace window required by NEE-81", () => {
+        expect(CODEX_OUTPUT_INACTIVITY_MONITOR_SIGTERM_GRACE_MS).toBe(5_000);
+    });
+});
+//# sourceMappingURL=output-inactivity-monitor.test.js.map

package/dist/server/output-inactivity-monitor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-inactivity-monitor.test.js","sourceRoot":"","sources":["../../src/server/output-inactivity-monitor.test.ts"],"names":[],"mappings":"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"}

package/dist/server/parse.d.ts

@@ -0,0 +1,51 @@
+export type CodexAuthRefreshFailureClass = "refresh_token_reused" | "refresh_token_expired" | "refresh_token_invalidated";
+export declare function parseCodexJsonl(stdout: string): {
+    sessionId: string | null;
+    summary: string;
+    usage: {
+        inputTokens: number;
+        cachedInputTokens: number;
+        outputTokens: number;
+    };
+    usageBasis: "per_run";
+    errorMessage: string | null;
+    sawProtocolEvent: boolean;
+    sawProtocolTerminalEvent: boolean;
+};
+/**
+ * Structural crash detection: the codex CLI can only report an agent-level
+ * failure through the JSONL protocol (an `error` event, `turn.failed`, or a
+ * finished `turn.completed` followed by a nonzero exit). A nonzero exit after
+ * the protocol stream started but before any terminal event means the process
+ * died out from under the agent (MCP transport crash, worker panic, killed
+ * tool server) — retriable infrastructure, not agent behavior. This
+ * deliberately does not match error text: transport failure strings vary, and
+ * stdout/stderr can quote agent output that merely discusses network errors.
+ */
+export declare function isCodexHarnessCrash(input: {
+    exitCode: number | null;
+    sawProtocolEvent: boolean;
+    sawProtocolTerminalEvent: boolean;
+}): boolean;
+export declare function isCodexUnknownSessionError(stdout: string, stderr: string): boolean;
+export declare function classifyCodexAuthRefreshFailure(input: {
+    stdout?: string | null;
+    stderr?: string | null;
+    errorMessage?: string | null;
+}): CodexAuthRefreshFailureClass | null;
+export declare function extractCodexRetryNotBefore(input: {
+    stdout?: string | null;
+    stderr?: string | null;
+    errorMessage?: string | null;
+}, now?: Date): Date | null;
+export declare function isCodexTransientUpstreamError(input: {
+    stdout?: string | null;
+    stderr?: string | null;
+    errorMessage?: string | null;
+}): boolean;
+export declare function isCodexProviderQuotaError(input: {
+    stdout?: string | null;
+    stderr?: string | null;
+    errorMessage?: string | null;
+}): boolean;
+//# sourceMappingURL=parse.d.ts.map

package/dist/server/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/server/parse.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,4BAA4B,GACpC,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,CAAC;AAEhC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM;;;;;;;;gBA+D9B,SAAS;;;;EAKxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;CACnC,GAAG,OAAO,CAGV;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CASlF;AAmBD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,4BAA4B,GAAG,IAAI,CAStC;AAwID,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,EAAE,GAAG,OAAa,GAAG,IAAI,GAAG,IAAI,CAKhC;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAQV;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAGV"}