@aiden-ade/sandbox-agent 0.1.59 → 0.1.60

package/dist/__tests__/sleep-inhibitor.test.js

@@ -0,0 +1,236 @@
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { isSleepPreventionDisabled, registerSleepInhibitorBackend, SleepInhibitor, } from "../sleep-inhibitor.js";
+vi.mock("node:child_process", () => ({ spawn: vi.fn() }));
+const spawnMock = vi.mocked(spawn);
+function fakeChild(pid) {
+    const child = new EventEmitter();
+    Object.assign(child, {
+        pid,
+        exitCode: null,
+        signalCode: null,
+        kill: vi.fn(() => true),
+    });
+    return child;
+}
+/** Records calls and lets a test simulate the helper process dying. */
+class FakeBackend {
+    name = "fake";
+    acquireCalls = 0;
+    releaseCalls = 0;
+    held = false;
+    /** Flipped by a test to simulate the OS helper dying under us. */
+    killed = false;
+    acquire() {
+        this.acquireCalls += 1;
+        this.held = true;
+        this.killed = false;
+    }
+    release() {
+        this.releaseCalls += 1;
+        this.held = false;
+    }
+    isHealthy() {
+        return this.held && !this.killed;
+    }
+}
+const disposers = [];
+const inhibitors = [];
+beforeEach(() => {
+    let nextPid = 10_000;
+    spawnMock.mockImplementation(() => fakeChild(nextPid++));
+});
+function withBackend(backend) {
+    disposers.push(registerSleepInhibitorBackend(backend));
+}
+function createInhibitor(env = {}) {
+    const inhibitor = new SleepInhibitor({ env });
+    inhibitors.push(inhibitor);
+    return inhibitor;
+}
+afterEach(() => {
+    for (const inhibitor of inhibitors.splice(0))
+        inhibitor.dispose();
+    for (const dispose of disposers.splice(0))
+        dispose();
+    spawnMock.mockReset();
+    vi.useRealTimers();
+});
+describe("SleepInhibitor", () => {
+    it("acquires on the first active run and releases when the last one finishes", () => {
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        expect(backend.acquireCalls).toBe(1);
+        expect(inhibitor.isActive()).toBe(true);
+        inhibitor.setActive(false);
+        expect(backend.releaseCalls).toBe(1);
+        expect(inhibitor.isActive()).toBe(false);
+    });
+    it("does not re-acquire a healthy assertion when more runs start", () => {
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        inhibitor.setActive(true);
+        inhibitor.setActive(true);
+        // Concurrent runs must not stack assertions.
+        expect(backend.acquireCalls).toBe(1);
+        expect(backend.releaseCalls).toBe(0);
+    });
+    it("re-acquires when the helper died before the next run starts", () => {
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        expect(backend.acquireCalls).toBe(1);
+        // The OS helper is killed externally while runs are still active.
+        backend.killed = true;
+        inhibitor.setActive(true);
+        expect(backend.acquireCalls).toBe(2);
+    });
+    it("self-heals a dead helper from the health watchdog without a new run", () => {
+        vi.useFakeTimers();
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        expect(backend.acquireCalls).toBe(1);
+        backend.killed = true;
+        vi.advanceTimersByTime(30_000);
+        expect(backend.acquireCalls).toBe(2);
+        expect(backend.isHealthy()).toBe(true);
+    });
+    it("stops the health watchdog once no runs are active", () => {
+        vi.useFakeTimers();
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        inhibitor.setActive(false);
+        backend.killed = true;
+        vi.advanceTimersByTime(120_000);
+        // Exactly the initial acquire; an idle daemon must not respawn helpers.
+        expect(backend.acquireCalls).toBe(1);
+    });
+    it("releases on dispose and ignores later activation", () => {
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        inhibitor.dispose();
+        expect(backend.releaseCalls).toBe(1);
+        inhibitor.setActive(true);
+        expect(backend.acquireCalls).toBe(1);
+        expect(inhibitor.isActive()).toBe(false);
+    });
+    it("is inert when disabled by environment", () => {
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor({ ALAN_DISABLE_SLEEP_PREVENTION: "1" });
+        inhibitor.setActive(true);
+        expect(backend.acquireCalls).toBe(0);
+        expect(inhibitor.backendNames()).toEqual([]);
+    });
+    it("keeps working when a backend throws", () => {
+        const exploding = {
+            name: "exploding",
+            acquire() {
+                throw new Error("nope");
+            },
+            release() {
+                throw new Error("nope");
+            },
+            isHealthy: () => false,
+        };
+        const healthy = new FakeBackend();
+        withBackend(exploding);
+        withBackend(healthy);
+        const inhibitor = createInhibitor();
+        // A broken backend must not stop the others from holding the assertion.
+        expect(() => inhibitor.setActive(true)).not.toThrow();
+        expect(healthy.acquireCalls).toBe(1);
+        expect(() => inhibitor.setActive(false)).not.toThrow();
+        expect(healthy.releaseCalls).toBe(1);
+    });
+    it("does not leak process exit listeners across activation cycles", () => {
+        const backend = new FakeBackend();
+        withBackend(backend);
+        const inhibitor = createInhibitor();
+        const before = process.listenerCount("exit");
+        for (let i = 0; i < 5; i += 1) {
+            inhibitor.setActive(true);
+            inhibitor.setActive(false);
+        }
+        expect(process.listenerCount("exit")).toBe(before);
+    });
+});
+describe("isSleepPreventionDisabled", () => {
+    it("treats common truthy spellings as disabled", () => {
+        for (const value of ["1", "true", "TRUE", " yes "]) {
+            expect(isSleepPreventionDisabled({ ALAN_DISABLE_SLEEP_PREVENTION: value })).toBe(true);
+        }
+    });
+    it("defaults to enabled when unset or falsy", () => {
+        expect(isSleepPreventionDisabled({})).toBe(false);
+        expect(isSleepPreventionDisabled({ ALAN_DISABLE_SLEEP_PREVENTION: "0" })).toBe(false);
+        expect(isSleepPreventionDisabled({ ALAN_DISABLE_SLEEP_PREVENTION: "false" })).toBe(false);
+    });
+});
+describe("Linux backend fallback", () => {
+    const originalPlatform = process.platform;
+    beforeEach(() => {
+        Object.defineProperty(process, "platform", { value: "linux", configurable: true });
+    });
+    afterEach(() => {
+        Object.defineProperty(process, "platform", { value: originalPlatform, configurable: true });
+    });
+    it("falls back when systemd-inhibit exits unexpectedly", () => {
+        const systemdChild = fakeChild(20_001);
+        const gnomeChild = fakeChild(20_002);
+        spawnMock.mockReturnValueOnce(systemdChild).mockReturnValueOnce(gnomeChild);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        systemdChild.emit("exit", 1, null);
+        expect(spawnMock).toHaveBeenCalledTimes(2);
+        expect(spawnMock.mock.calls[0]?.[0]).toBe("systemd-inhibit");
+        expect(spawnMock.mock.calls[1]?.[0]).toBe("gnome-session-inhibit");
+    });
+    it("does not fall back when the active assertion is released", () => {
+        const systemdChild = fakeChild(20_003);
+        vi.mocked(systemdChild.kill).mockImplementation(() => {
+            systemdChild.emit("exit", null, "SIGTERM");
+            return true;
+        });
+        spawnMock.mockReturnValueOnce(systemdChild);
+        const inhibitor = createInhibitor();
+        inhibitor.setActive(true);
+        inhibitor.setActive(false);
+        expect(spawnMock).toHaveBeenCalledTimes(1);
+    });
+});
+describe("Windows standalone backend selection", () => {
+    const originalPlatform = process.platform;
+    function setPlatform(value) {
+        Object.defineProperty(process, "platform", { value, configurable: true });
+    }
+    afterEach(() => {
+        Object.defineProperty(process, "platform", { value: originalPlatform, configurable: true });
+    });
+    it("spawns the PowerShell helper when nothing else is registered", () => {
+        setPlatform("win32");
+        const inhibitor = createInhibitor();
+        expect(inhibitor.backendNames()).toEqual(["windows-power-request"]);
+    });
+    it("defers to a registered external backend (e.g. Electron powerSaveBlocker) instead", () => {
+        setPlatform("win32");
+        const electron = new FakeBackend();
+        withBackend(electron);
+        const inhibitor = createInhibitor();
+        // Only the external backend should be present — no redundant PowerShell helper.
+        expect(inhibitor.backendNames()).toEqual(["fake"]);
+    });
+});
+//# sourceMappingURL=sleep-inhibitor.test.js.map

package/dist/__tests__/sleep-inhibitor.test.js.map

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

package/dist/__tests__/status-local-workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status-local-workspace.test.d.ts.map

package/dist/__tests__/status-local-workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-local-workspace.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/status-local-workspace.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/status-local-workspace.test.js

@@ -0,0 +1,121 @@
+import { spawnSync } from "node:child_process";
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { statusLocalWorkspace } from "../daemon.js";
+const tempRoots = [];
+function runGit(cwd, args) {
+    const result = spawnSync("git", args, {
+        cwd,
+        encoding: "utf8",
+        env: {
+            ...process.env,
+            GIT_AUTHOR_NAME: "Alan Test",
+            GIT_AUTHOR_EMAIL: "alan@example.com",
+            GIT_COMMITTER_NAME: "Alan Test",
+            GIT_COMMITTER_EMAIL: "alan@example.com",
+        },
+    });
+    if (result.status !== 0) {
+        throw new Error((result.stderr || result.stdout || "git failed").trim());
+    }
+    return result.stdout.trim();
+}
+/** A bare "remote" plus a clone of it, so upstream tracking is real. */
+function makeClonedRepo() {
+    const root = mkdtempSync(join(tmpdir(), "alan-status-probe-"));
+    tempRoots.push(root);
+    const remotePath = join(root, "remote.git");
+    const seedPath = join(root, "seed");
+    runGit(root, ["init", "--bare", "-b", "main", remotePath]);
+    mkdirSync(seedPath, { recursive: true });
+    runGit(seedPath, ["init", "-b", "main"]);
+    writeFileSync(join(seedPath, "README.md"), "main\n");
+    runGit(seedPath, ["add", "README.md"]);
+    runGit(seedPath, ["commit", "-m", "initial"]);
+    runGit(seedPath, ["remote", "add", "origin", remotePath]);
+    runGit(seedPath, ["push", "-u", "origin", "main"]);
+    const projectPath = join(root, "project");
+    runGit(root, ["clone", remotePath, projectPath]);
+    return { root, remotePath, projectPath };
+}
+afterEach(() => {
+    while (tempRoots.length > 0) {
+        const root = tempRoots.pop();
+        if (root)
+            rmSync(root, { recursive: true, force: true });
+    }
+});
+describe("statusLocalWorkspace", () => {
+    it("reports a clean shared checkout with its upstream", () => {
+        const { projectPath } = makeClonedRepo();
+        expect(statusLocalWorkspace({ worktreePath: projectPath })).toMatchObject({
+            branch: "main",
+            dirty: false,
+            filesChanged: 0,
+            hasUpstream: true,
+            ahead: 0,
+            behind: 0,
+        });
+    });
+    it("counts dirty files without leaking their paths", () => {
+        const { projectPath } = makeClonedRepo();
+        writeFileSync(join(projectPath, "README.md"), "changed\n");
+        writeFileSync(join(projectPath, "secret-name.txt"), "new\n");
+        const status = statusLocalWorkspace({ worktreePath: projectPath });
+        expect(status).toMatchObject({ dirty: true, filesChanged: 2 });
+        expect(JSON.stringify(status)).not.toContain("secret-name");
+    });
+    it("reports ahead counts against the upstream", () => {
+        const { projectPath } = makeClonedRepo();
+        writeFileSync(join(projectPath, "next.md"), "next\n");
+        runGit(projectPath, ["add", "next.md"]);
+        runGit(projectPath, ["commit", "-m", "second"]);
+        expect(statusLocalWorkspace({ worktreePath: projectPath })).toMatchObject({
+            ahead: 1,
+            behind: 0,
+            hasUpstream: true,
+            dirty: false,
+        });
+    });
+    it("reports hasUpstream false for a branch with no tracking ref", () => {
+        const { projectPath } = makeClonedRepo();
+        runGit(projectPath, ["checkout", "-b", "alan/task-1"]);
+        expect(statusLocalWorkspace({ worktreePath: projectPath })).toMatchObject({
+            branch: "alan/task-1",
+            hasUpstream: false,
+            ahead: null,
+            behind: null,
+        });
+    });
+    it("resolves a nested folder up to its repository root", () => {
+        const { projectPath } = makeClonedRepo();
+        const nested = join(projectPath, "apps", "web");
+        mkdirSync(nested, { recursive: true });
+        expect(statusLocalWorkspace({ worktreePath: nested })).toMatchObject({
+            branch: "main",
+            hasUpstream: true,
+        });
+    });
+    it("probes a task worktree, not just the shared checkout", () => {
+        const { projectPath } = makeClonedRepo();
+        const worktreeRoot = join(dirname(projectPath), "project-alan-worktrees", "task-1");
+        mkdirSync(dirname(worktreeRoot), { recursive: true });
+        runGit(projectPath, ["worktree", "add", "-b", "alan/task-1", worktreeRoot]);
+        expect(statusLocalWorkspace({ worktreePath: worktreeRoot })).toMatchObject({
+            branch: "alan/task-1",
+            dirty: false,
+            hasUpstream: false,
+        });
+    });
+    it("throws for a folder outside any Git repository", () => {
+        const bare = mkdtempSync(join(tmpdir(), "alan-status-nogit-"));
+        tempRoots.push(bare);
+        expect(() => statusLocalWorkspace({ worktreePath: bare })).toThrow(/not inside a Git repository/);
+    });
+    it("requires a worktreePath", () => {
+        expect(() => statusLocalWorkspace({})).toThrow(/worktreePath is required/);
+    });
+});
+//# sourceMappingURL=status-local-workspace.test.js.map

package/dist/__tests__/status-local-workspace.test.js.map

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

package/dist/__tests__/suspension-detector.test.d.ts

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

package/dist/__tests__/suspension-detector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspension-detector.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/suspension-detector.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/suspension-detector.test.js

@@ -0,0 +1,112 @@
+import { describe, expect, it } from "vitest";
+import { SuspensionDetector } from "../suspension-detector.js";
+/**
+ * Drives the detector with a controllable clock and a manual tick, so the tests
+ * assert the gap arithmetic rather than real timer behavior.
+ */
+function harness(options = {}) {
+    const gaps = [];
+    let nowMs = 1_000_000;
+    let tick = null;
+    const detector = new SuspensionDetector({
+        onSuspensionDetected: (gapMs) => gaps.push(gapMs),
+        checkIntervalMs: options.checkIntervalMs ?? 15_000,
+        thresholdMs: options.thresholdMs ?? 60_000,
+        now: () => nowMs,
+        setIntervalFn: ((fn) => {
+            tick = fn;
+            return { unref() { } };
+        }),
+        clearIntervalFn: (() => {
+            tick = null;
+        }),
+    });
+    return {
+        detector,
+        gaps,
+        /** Advance the clock, then fire the scheduled tick. */
+        advanceAndTick(ms) {
+            nowMs += ms;
+            tick?.();
+        },
+    };
+}
+describe("SuspensionDetector", () => {
+    it("stays silent while ticks arrive on schedule", () => {
+        const h = harness();
+        h.detector.start();
+        for (let i = 0; i < 10; i += 1)
+            h.advanceAndTick(15_000);
+        expect(h.gaps).toEqual([]);
+    });
+    it("ignores ordinary timer jitter and event-loop congestion", () => {
+        const h = harness();
+        h.detector.start();
+        // 15s cadence running ~20s late: coalescing, not sleep.
+        h.advanceAndTick(35_000);
+        // Still well under the 60s threshold.
+        h.advanceAndTick(70_000);
+        expect(h.gaps).toEqual([]);
+    });
+    it("reports the frozen duration after a suspension", () => {
+        const h = harness();
+        h.detector.start();
+        // Machine slept ~10 minutes: one tick fires late by that much.
+        h.advanceAndTick(15_000 + 600_000);
+        expect(h.gaps).toEqual([600_000]);
+    });
+    it("reports each suspension separately and resumes normal operation", () => {
+        const h = harness();
+        h.detector.start();
+        h.advanceAndTick(15_000 + 300_000);
+        h.advanceAndTick(15_000); // back to normal
+        h.advanceAndTick(15_000 + 120_000);
+        expect(h.gaps).toEqual([300_000, 120_000]);
+    });
+    it("does not report a suspension spanning stop and restart", () => {
+        const h = harness();
+        h.detector.start();
+        h.detector.stop();
+        // Time passes while stopped, then the detector is restarted: the first tick
+        // after start() must measure from the restart, not from before the stop.
+        h.advanceAndTick(600_000);
+        h.detector.start();
+        h.advanceAndTick(15_000);
+        expect(h.gaps).toEqual([]);
+    });
+    it("keeps detecting after a reporting callback throws", () => {
+        let calls = 0;
+        let nowMs = 0;
+        let tick = null;
+        const detector = new SuspensionDetector({
+            onSuspensionDetected: () => {
+                calls += 1;
+                throw new Error("emit failed");
+            },
+            checkIntervalMs: 15_000,
+            thresholdMs: 60_000,
+            now: () => nowMs,
+            setIntervalFn: ((fn) => {
+                tick = fn;
+                return { unref() { } };
+            }),
+            clearIntervalFn: (() => { }),
+        });
+        detector.start();
+        nowMs += 315_000;
+        expect(() => tick?.()).not.toThrow();
+        nowMs += 315_000;
+        expect(() => tick?.()).not.toThrow();
+        expect(calls).toBe(2);
+    });
+    it("is idempotent across repeated start and stop", () => {
+        const h = harness();
+        h.detector.start();
+        h.detector.start();
+        expect(h.detector.isRunning()).toBe(true);
+        h.detector.stop();
+        h.detector.stop();
+        expect(h.detector.isRunning()).toBe(false);
+    });
+});
+//# sourceMappingURL=suspension-detector.test.js.map

package/dist/__tests__/suspension-detector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspension-detector.test.js","sourceRoot":"","sources":["../../src/__tests__/suspension-detector.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,SAAS,OAAO,CAAC,UAA8D,EAAE;IAC/E,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,SAAS,CAAC;IACtB,IAAI,IAAI,GAAwB,IAAI,CAAC;IAErC,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;QACtC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QACjD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,MAAM;QAClD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM;QAC1C,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK;QAChB,aAAa,EAAE,CAAC,CAAC,EAAc,EAAE,EAAE;YACjC,IAAI,GAAG,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,KAAI,CAAC,EAA+B,CAAC;QACrD,CAAC,CAAkC;QACnC,eAAe,EAAE,CAAC,GAAG,EAAE;YACrB,IAAI,GAAG,IAAI,CAAC;QACd,CAAC,CAAoC;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,uDAAuD;QACvD,cAAc,CAAC,EAAU;YACvB,KAAK,IAAI,EAAE,CAAC;YACZ,IAAI,EAAE,EAAE,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC;YAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEnB,wDAAwD;QACxD,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACzB,sCAAsC;QACtC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEnB,+DAA+D;QAC/D,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;QAEnC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEnB,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB;QAC3C,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;QAEnC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAElB,4EAA4E;QAC5E,yEAAyE;QACzE,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,IAAI,GAAwB,IAAI,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;YACtC,oBAAoB,EAAE,GAAG,EAAE;gBACzB,KAAK,IAAI,CAAC,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;YACjC,CAAC;YACD,eAAe,EAAE,MAAM;YACvB,WAAW,EAAE,MAAM;YACnB,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK;YAChB,aAAa,EAAE,CAAC,CAAC,EAAc,EAAE,EAAE;gBACjC,IAAI,GAAG,EAAE,CAAC;gBACV,OAAO,EAAE,KAAK,KAAI,CAAC,EAA+B,CAAC;YACrD,CAAC,CAAkC;YACnC,eAAe,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAoC;SAC/D,CAAC,CAAC;QACH,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEjB,KAAK,IAAI,OAAO,CAAC;QACjB,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,IAAI,OAAO,CAAC;QACjB,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAErC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1C,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/web-presenter-parent-events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web-presenter-parent-events.test.d.ts.map

package/dist/__tests__/web-presenter-parent-events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-presenter-parent-events.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/web-presenter-parent-events.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/web-presenter-parent-events.test.js

@@ -0,0 +1,130 @@
+import { describe, expect, it, vi } from "vitest";
+import { WebPresenter } from "../web-presenter.js";
+describe("WebPresenter parented subagent events", () => {
+    it("preserves parentToolUseId on text and thinking events", () => {
+        const emitEvent = vi.fn();
+        const presenter = new WebPresenter({ emitEvent }, "conversation-1");
+        presenter.onThinking("Inspecting", "agent-1");
+        presenter.onAssistantText("Found the parser.", "agent-1");
+        expect(emitEvent).toHaveBeenNthCalledWith(1, expect.objectContaining({
+            type: "thinking",
+            text: "Inspecting",
+            parentToolUseId: "agent-1",
+        }));
+        expect(emitEvent).toHaveBeenNthCalledWith(2, expect.objectContaining({
+            type: "text",
+            text: "Found the parser.",
+            parentToolUseId: "agent-1",
+        }));
+    });
+    it("emits a nonterminal CLI observation followed by one canonical successful completion", () => {
+        const emitEvent = vi.fn();
+        const close = vi.fn();
+        const presenter = new WebPresenter({ emitEvent, close }, "conversation-2");
+        presenter.setRunContext("run-2", "codex_app_server");
+        presenter.onError("Rate limited by the provider. Retrying automatically shortly.", true);
+        presenter.onComplete({
+            success: true,
+            summary: "Recovered",
+            filesModified: [],
+            planFilesCreated: [],
+            iterations: 1,
+        });
+        expect(emitEvent.mock.calls.map(([event]) => event.type)).toEqual([
+            "agent_problem_observed",
+            "error",
+            "agent_run_finished",
+            "query_complete",
+            "session_complete",
+        ]);
+        expect(emitEvent).not.toHaveBeenCalledWith(expect.objectContaining({ type: "session_error" }));
+        expect(close).toHaveBeenCalledTimes(1);
+    });
+    it("links an application failure to the canonical run finalizer", () => {
+        const emitEvent = vi.fn();
+        const close = vi.fn();
+        const presenter = new WebPresenter({ emitEvent, close }, "conversation-3");
+        presenter.setRunContext("run-3", "claude_cli");
+        const message = "Alan could not prepare the required tools for this run.";
+        presenter.onError(message, false);
+        presenter.onComplete({
+            success: false,
+            summary: message,
+            filesModified: [],
+            planFilesCreated: [],
+            iterations: 0,
+            error: message,
+        });
+        const events = emitEvent.mock.calls.map(([event]) => event);
+        const problem = events.find((event) => event.type === "application_problem")?.problem;
+        expect(problem).toMatchObject({ domain: "application" });
+        expect(events.find((event) => event.type === "agent_run_finished")).toMatchObject({
+            failureDomain: "application",
+            causeProblemId: problem?.id,
+        });
+        expect(events.map((event) => event.type)).toEqual([
+            "application_problem",
+            "error",
+            "agent_run_finished",
+            "query_complete",
+        ]);
+        expect(events).not.toContainEqual(expect.objectContaining({ type: "session_error" }));
+    });
+    it("preserves MCP-specific recovery semantics in application problems", () => {
+        const emitEvent = vi.fn();
+        const presenter = new WebPresenter({ emitEvent }, "conversation-mcp");
+        presenter.setRunContext("run-mcp", "codex_app_server");
+        presenter.onApplicationError({
+            code: "app.mcp.auth_invalid",
+            message: "Alan could not authenticate the tool connection for this run.",
+        });
+        expect(emitEvent).toHaveBeenNthCalledWith(1, expect.objectContaining({
+            type: "application_problem",
+            problem: expect.objectContaining({
+                domain: "application",
+                code: "app.mcp.auth_invalid",
+                // Not "automatic": nothing retries this on the user's behalf, and the
+                // legacy projection would otherwise tell the UI to render the run as
+                // self-recovering when it is already terminally failed.
+                recovery: {
+                    mode: "after_user_action",
+                    action: "start_new_attempt",
+                    safe: true,
+                },
+            }),
+        }));
+    });
+    it("upgrades an untyped failed completion to a terminal CLI problem", () => {
+        const emitEvent = vi.fn();
+        const close = vi.fn();
+        const presenter = new WebPresenter({ emitEvent, close }, "conversation-4");
+        presenter.setRunContext("run-4", "generic_cli");
+        const failedResult = {
+            success: false,
+            summary: "Process exited unexpectedly",
+            filesModified: [],
+            planFilesCreated: [],
+            iterations: 0,
+            error: "Process exited unexpectedly",
+        };
+        presenter.onComplete(failedResult);
+        presenter.onComplete(failedResult);
+        expect(emitEvent).toHaveBeenNthCalledWith(1, expect.objectContaining({
+            type: "agent_run_finished",
+            failureDomain: "agent_cli",
+            causeProblemId: expect.any(String),
+            result: expect.objectContaining({
+                problem: expect.objectContaining({
+                    domain: "agent_cli",
+                    lifecycle: expect.objectContaining({ finality: "terminal" }),
+                }),
+            }),
+        }));
+        expect(emitEvent.mock.calls.map(([event]) => event.type)).toEqual([
+            "agent_run_finished",
+            "query_complete",
+        ]);
+        expect(close).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=web-presenter-parent-events.test.js.map