oh-my-codex 0.20.3 → 0.21.0

package/dist/adapt/herdr/__tests__/seq-store.test.js

@@ -0,0 +1,54 @@
+import assert from "node:assert/strict";
+import { execFileSync } from "node:child_process";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execPath } from "node:process";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { nextSeq, readPersistedSeq, sanitizeSourceKey } from "../seq-store.js";
+let baseDir;
+const moduleHref = new URL("../seq-store.js", import.meta.url).href;
+beforeEach(async () => {
+    baseDir = await mkdtemp(join(tmpdir(), "omx-herdr-seq-"));
+});
+afterEach(async () => {
+    await rm(baseDir, { recursive: true, force: true });
+});
+describe("seq-store durable monotonic counter", () => {
+    it("is strictly increasing per source in-process", () => {
+        assert.deepEqual([
+            nextSeq("omx:runtime", { baseDir }),
+            nextSeq("omx:runtime", { baseDir }),
+            nextSeq("omx:runtime", { baseDir }),
+        ], [1, 2, 3]);
+    });
+    it("keeps separate streams per source", () => {
+        assert.equal(nextSeq("src-a", { baseDir }), 1);
+        assert.equal(nextSeq("src-b", { baseDir }), 1);
+        assert.equal(nextSeq("src-a", { baseDir }), 2);
+    });
+    it("continues (does not reset to 1) after a simulated restart", () => {
+        nextSeq("omx:runtime", { baseDir });
+        nextSeq("omx:runtime", { baseDir });
+        assert.equal(readPersistedSeq("omx:runtime", { baseDir }), 2);
+        assert.equal(nextSeq("omx:runtime", { baseDir }), 3);
+    });
+    it("sanitizes source ids into safe file stems", () => {
+        assert.equal(sanitizeSourceKey("omx:runtime"), "omx_runtime");
+        assert.equal(sanitizeSourceKey("../../etc/passwd"), ".._.._etc_passwd");
+        assert.equal(sanitizeSourceKey(""), "unknown-source");
+    });
+    it("produces unique, strictly-increasing seqs across concurrent processes", () => {
+        const N = 12;
+        const script = `import(${JSON.stringify(moduleHref)}).then((m) => { console.log(m.nextSeq("omx:runtime", { baseDir: ${JSON.stringify(baseDir)} })); });`;
+        const results = new Array(N).fill(0).map(() => Number(execFileSync(execPath, ["--input-type=module", "-e", script], {
+            encoding: "utf-8",
+        }).trim()));
+        const unique = new Set(results);
+        assert.equal(unique.size, N, `expected ${N} unique seqs, got ${[...unique].sort((a, b) => a - b).join(",")}`);
+        assert.equal(Math.max(...results), N);
+        assert.equal(Math.min(...results), 1);
+        assert.equal(readPersistedSeq("omx:runtime", { baseDir }), N);
+    });
+});
+//# sourceMappingURL=seq-store.test.js.map

package/dist/adapt/herdr/__tests__/seq-store.test.js.map

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

package/dist/adapt/herdr/__tests__/socket-live.test.d.ts

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

package/dist/adapt/herdr/__tests__/socket-live.test.d.ts.map

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

package/dist/adapt/herdr/__tests__/socket-live.test.js

@@ -0,0 +1,104 @@
+import assert from "node:assert/strict";
+import { createServer } from "node:net";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { SocketHerdrTransport } from "../transport.js";
+let dir;
+let servers = [];
+beforeEach(async () => {
+    dir = await mkdtemp(join(tmpdir(), "omx-herdr-sock-"));
+    servers = [];
+});
+afterEach(async () => {
+    for (const s of servers)
+        await new Promise((r) => s.close(() => r()));
+    await rm(dir, { recursive: true, force: true });
+});
+function listen(handler) {
+    const path = join(dir, `h-${servers.length}.sock`);
+    const server = createServer((socket) => {
+        let buf = "";
+        socket.on("data", (chunk) => {
+            buf += chunk.toString("utf-8");
+            const nl = buf.indexOf("\n");
+            if (nl !== -1) {
+                const line = buf.slice(0, nl);
+                handler(line, (data) => socket.write(data));
+            }
+        });
+    });
+    servers.push(server);
+    return new Promise((resolve) => server.listen(path, () => resolve(path)));
+}
+describe("SocketHerdrTransport live Unix-socket round-trip", () => {
+    it("reports ok on a correlated success reply", async () => {
+        const socketPath = await listen((line, reply) => {
+            const req = JSON.parse(line);
+            assert.equal(req.method, "pane.report_agent");
+            assert.equal(req.params.seq, 3);
+            reply(`${JSON.stringify({ id: req.id, result: { type: "pane_info" } })}\n`);
+        });
+        const transport = new SocketHerdrTransport({ socketPath, timeoutMs: 2000 });
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "working",
+            seq: 3,
+        });
+        assert.equal(result.ok, true);
+        assert.match(result.detail, /accepted/);
+    });
+    it("reports NOT ok when the server returns an error reply", async () => {
+        const socketPath = await listen((line, reply) => {
+            const req = JSON.parse(line);
+            reply(`${JSON.stringify({ id: req.id, error: { message: "stale seq" } })}\n`);
+        });
+        const transport = new SocketHerdrTransport({ socketPath, timeoutMs: 2000 });
+        const result = await transport.releaseAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            seq: 1,
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.error ?? "", /stale seq/);
+    });
+    it("reports NOT ok when the server never replies (timeout)", async () => {
+        const socketPath = await listen(() => {
+            /* swallow: never reply */
+        });
+        const transport = new SocketHerdrTransport({ socketPath, timeoutMs: 150 });
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "idle",
+            seq: 1,
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.error ?? "", /timeout/);
+    });
+    it("reports NOT ok when the reply exceeds the max frame size", async () => {
+        const socketPath = await listen((_line, reply) => {
+            // Flood bytes with no newline to trip the bounded-frame guard.
+            reply("x".repeat(5000));
+        });
+        const transport = new SocketHerdrTransport({
+            socketPath,
+            timeoutMs: 2000,
+            maxFrameBytes: 1024,
+        });
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "idle",
+            seq: 1,
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.error ?? "", /max frame/);
+    });
+});
+//# sourceMappingURL=socket-live.test.js.map

package/dist/adapt/herdr/__tests__/socket-live.test.js.map

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

package/dist/adapt/herdr/__tests__/team-map.test.d.ts

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

package/dist/adapt/herdr/__tests__/team-map.test.d.ts.map

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

package/dist/adapt/herdr/__tests__/team-map.test.js

@@ -0,0 +1,46 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { rollupTeamState } from "../semantic.js";
+import { mapTeamStateToRollup } from "../team-map.js";
+describe("mapTeamStateToRollup", () => {
+    it("maps leader attention to a user-blocking rollup", () => {
+        const input = mapTeamStateToRollup({
+            leaderAttentionPending: true,
+            workers: [{ id: "w1", state: "working" }],
+        });
+        assert.equal(input.leaderBlockedOnUser, true);
+        assert.equal(rollupTeamState(input).state, "blocked");
+    });
+    it("treats a system-blocked worker as non-user-blocking", () => {
+        const input = mapTeamStateToRollup({
+            workers: [
+                { id: "w1", state: "working" },
+                { id: "w2", state: "blocked", reason: "waiting on network" },
+            ],
+        });
+        assert.equal(rollupTeamState(input).state, "working");
+    });
+    it("treats a user-reason blocked worker as user-blocking", () => {
+        const input = mapTeamStateToRollup({
+            workers: [{ id: "w2", state: "blocked", reason: "needs user approval" }],
+        });
+        assert.equal(rollupTeamState(input).state, "blocked");
+    });
+    it("maps draining to working (still active)", () => {
+        const input = mapTeamStateToRollup({
+            workers: [{ id: "w1", state: "draining" }],
+        });
+        assert.equal(rollupTeamState(input).state, "working");
+    });
+    it("is idle when all workers are terminal", () => {
+        const input = mapTeamStateToRollup({
+            runTerminal: true,
+            workers: [
+                { id: "w1", state: "done" },
+                { id: "w2", state: "failed" },
+            ],
+        });
+        assert.equal(rollupTeamState(input).state, "idle");
+    });
+});
+//# sourceMappingURL=team-map.test.js.map

package/dist/adapt/herdr/__tests__/team-map.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-map.test.js","sourceRoot":"","sources":["../../../../src/adapt/herdr/__tests__/team-map.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAG,oBAAoB,CAAC;YAClC,sBAAsB,EAAE,IAAI;YAC5B,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SACzC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG,oBAAoB,CAAC;YAClC,OAAO,EAAE;gBACR,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;gBAC9B,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE;aAC5D;SACD,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAG,oBAAoB,CAAC;YAClC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;SACxE,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAG,oBAAoB,CAAC;YAClC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;SAC1C,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAChD,MAAM,KAAK,GAAG,oBAAoB,CAAC;YAClC,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE;gBACR,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC3B,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;aAC7B;SACD,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/adapt/herdr/__tests__/transport.test.d.ts

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

package/dist/adapt/herdr/__tests__/transport.test.d.ts.map

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

package/dist/adapt/herdr/__tests__/transport.test.js

@@ -0,0 +1,160 @@
+import assert from "node:assert/strict";
+import { execPath } from "node:process";
+import { describe, it } from "node:test";
+import { CliHerdrTransport, SocketHerdrTransport, buildReleaseAgentArgs, buildReportAgentArgs, detectHerdrEnv, resolveTrustedHerdrBin, } from "../transport.js";
+describe("herdr env detection", () => {
+    it("is enabled only when HERDR_ENV=1 and a pane id are present", () => {
+        assert.equal(detectHerdrEnv({ HERDR_ENV: "1", HERDR_PANE_ID: "w1:p1" }).enabled, true);
+        assert.equal(detectHerdrEnv({ HERDR_PANE_ID: "w1:p1" }).enabled, false);
+        assert.equal(detectHerdrEnv({ HERDR_ENV: "1" }).enabled, false);
+        assert.equal(detectHerdrEnv({ HERDR_ENV: "1", HERDR_PANE_ID: "  " }).enabled, false);
+    });
+});
+describe("herdr CLI argv builders", () => {
+    it("builds shell-free, ordered report-agent argv with seq", () => {
+        assert.deepEqual(buildReportAgentArgs({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "working",
+            message: "team: 3 workers active",
+            seq: 7,
+        }), [
+            "pane", "report-agent", "w1:p1", "--source", "omx:runtime",
+            "--agent", "codex", "--state", "working", "--seq", "7",
+            "--message", "team: 3 workers active",
+        ]);
+    });
+    it("keeps injection-prone text as one argv token and omits empty message", () => {
+        const args = buildReportAgentArgs({
+            paneId: "w1:p1; rm -rf /",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "idle",
+            seq: 1,
+        });
+        assert.equal(args[2], "w1:p1; rm -rf /");
+        assert.ok(!args.includes("--message"));
+    });
+    it("builds release-agent argv with seq", () => {
+        assert.deepEqual(buildReleaseAgentArgs({ paneId: "w1:p1", source: "omx:runtime", seq: 9 }), ["pane", "release-agent", "w1:p1", "--source", "omx:runtime", "--seq", "9"]);
+    });
+});
+describe("trust-pinned CLI resolution", () => {
+    it("accepts only an absolute existing file", () => {
+        assert.equal(resolveTrustedHerdrBin(execPath), execPath); // node binary is absolute+exists
+        assert.equal(resolveTrustedHerdrBin("herdr"), null); // bare PATH name rejected
+        assert.equal(resolveTrustedHerdrBin("/nonexistent/herdr"), null);
+        assert.equal(resolveTrustedHerdrBin(undefined), null);
+    });
+    it("does not execFile when no trusted binary is available", async () => {
+        let called = false;
+        const transport = new CliHerdrTransport({
+            binPath: "herdr",
+            execFileFn: (_f, _a, cb) => {
+                called = true;
+                cb(null);
+            },
+        });
+        assert.equal(transport.available, false);
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "working",
+            seq: 1,
+        });
+        assert.equal(result.ok, false);
+        assert.equal(called, false);
+        assert.match(result.error ?? "", /trust-pinned/);
+    });
+    it("invokes execFile with a trusted absolute binary", async () => {
+        const calls = [];
+        const transport = new CliHerdrTransport({
+            binPath: execPath,
+            execFileFn: (_f, args, cb) => {
+                calls.push(args);
+                cb(null);
+            },
+        });
+        assert.equal(transport.available, true);
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "working",
+            seq: 1,
+        });
+        assert.equal(result.ok, true);
+        assert.equal(calls[0][1], "report-agent");
+    });
+});
+describe("SocketHerdrTransport request/response correlation", () => {
+    function transportWith(exchange) {
+        return new SocketHerdrTransport({ socketPath: "/tmp/h.sock", exchange });
+    }
+    it("reports ok only on a correlated success reply and sends dot-notation + seq", async () => {
+        const seen = [];
+        const transport = transportWith(async (_p, req) => {
+            seen.push(req);
+            return { id: req.id, result: { type: "pane_info" } };
+        });
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "blocked",
+            message: "needs input",
+            seq: 4,
+            metadata: { summary: "review" },
+        });
+        assert.equal(result.ok, true);
+        assert.equal(seen[0].method, "pane.report_agent");
+        assert.equal(seen[0].params.seq, 4);
+        assert.equal(seen[0].params.message, "needs input");
+        assert.deepEqual(seen[0].params.tokens, { summary: "review" });
+    });
+    it("reports NOT ok when Herdr returns an error reply", async () => {
+        const transport = transportWith(async (_p, req) => ({
+            id: req.id,
+            error: { code: "not_found", message: "pane not found" },
+        }));
+        const result = await transport.releaseAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            seq: 5,
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.error ?? "", /pane not found/);
+    });
+    it("reports NOT ok on id mismatch", async () => {
+        const transport = transportWith(async () => ({
+            id: "someone-else",
+            result: {},
+        }));
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "idle",
+            seq: 1,
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.detail, /mismatch/);
+    });
+    it("captures exchange errors (timeout/backpressure) without throwing", async () => {
+        const transport = transportWith(async () => {
+            throw new Error("herdr socket timeout");
+        });
+        const result = await transport.reportAgent({
+            paneId: "w1:p1",
+            source: "omx:runtime",
+            agent: "codex",
+            state: "idle",
+            seq: 1,
+        });
+        assert.equal(result.ok, false);
+        assert.match(result.error ?? "", /timeout/);
+    });
+});
+//# sourceMappingURL=transport.test.js.map

package/dist/adapt/herdr/__tests__/transport.test.js.map

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

package/dist/adapt/herdr/__tests__/wiring.test.d.ts

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

package/dist/adapt/herdr/__tests__/wiring.test.d.ts.map

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

package/dist/adapt/herdr/__tests__/wiring.test.js

@@ -0,0 +1,118 @@
+import assert from "node:assert/strict";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { buildNativeHookEvent } from "../../../hooks/extensibility/events.js";
+import { reportHerdrLifecycleEvent } from "../wiring.js";
+class RecordingTransport {
+    kind = "cli";
+    calls = [];
+    async reportAgent(r) {
+        this.calls.push({ op: "report", state: r.state, seq: r.seq });
+        return { ok: true, transport: "cli", detail: "ok" };
+    }
+    async releaseAgent(r) {
+        this.calls.push({ op: "release", seq: r.seq });
+        return { ok: true, transport: "cli", detail: "ok" };
+    }
+}
+let baseDir;
+let seq;
+beforeEach(async () => {
+    baseDir = await mkdtemp(join(tmpdir(), "omx-herdr-wiring-"));
+    seq = 0;
+});
+afterEach(async () => {
+    await rm(baseDir, { recursive: true, force: true });
+});
+const enabledEnv = {
+    enabled: true,
+    paneId: "w1:p1",
+    socketPath: null,
+    binPath: null,
+};
+describe("reportHerdrLifecycleEvent", () => {
+    it("is a no-op outside a Herdr pane", async () => {
+        const transport = new RecordingTransport();
+        const result = await reportHerdrLifecycleEvent({
+            cwd: baseDir,
+            event: buildNativeHookEvent("session-start"),
+            bridgeOptions: {
+                env: { enabled: false, paneId: null, socketPath: null, binPath: null },
+                transport,
+            },
+        });
+        assert.equal(result.wired, false);
+        assert.equal(result.reason, "herdr-not-detected");
+        assert.equal(transport.calls.length, 0);
+    });
+    it("reports a working transition for a working event", async () => {
+        const transport = new RecordingTransport();
+        const result = await reportHerdrLifecycleEvent({
+            cwd: baseDir,
+            event: buildNativeHookEvent("run.heartbeat"),
+            bridgeOptions: {
+                env: enabledEnv,
+                transport,
+                seqFn: () => ++seq,
+                stateBaseDir: baseDir,
+            },
+        });
+        assert.equal(result.wired, true);
+        assert.equal(result.state, "working");
+        assert.equal(transport.calls[0].op, "report");
+    });
+    it("reports blocked for a needs-input event", async () => {
+        const transport = new RecordingTransport();
+        const result = await reportHerdrLifecycleEvent({
+            cwd: baseDir,
+            event: buildNativeHookEvent("needs-input"),
+            bridgeOptions: {
+                env: enabledEnv,
+                transport,
+                seqFn: () => ++seq,
+                stateBaseDir: baseDir,
+            },
+        });
+        assert.equal(result.state, "blocked");
+    });
+    it("releases authority on whole-session shutdown", async () => {
+        const transport = new RecordingTransport();
+        const result = await reportHerdrLifecycleEvent({
+            cwd: baseDir,
+            event: buildNativeHookEvent("session-end"),
+            bridgeOptions: {
+                env: enabledEnv,
+                transport,
+                seqFn: () => ++seq,
+                stateBaseDir: baseDir,
+            },
+        });
+        assert.equal(result.state, "idle");
+        assert.equal(result.released, true);
+        assert.ok(transport.calls.some((c) => c.op === "release"));
+    });
+    it("never throws even if reporting fails internally", async () => {
+        const throwing = {
+            kind: "cli",
+            reportAgent: async () => {
+                throw new Error("kaboom");
+            },
+            releaseAgent: async () => ({ ok: true, transport: "cli", detail: "ok" }),
+        };
+        const result = await reportHerdrLifecycleEvent({
+            cwd: baseDir,
+            event: buildNativeHookEvent("run.heartbeat"),
+            bridgeOptions: {
+                env: enabledEnv,
+                transport: throwing,
+                seqFn: () => ++seq,
+                stateBaseDir: baseDir,
+            },
+        });
+        // The bridge captures the throw; wiring still returns wired:true with a failed report.
+        assert.equal(result.wired, true);
+    });
+});
+//# sourceMappingURL=wiring.test.js.map

package/dist/adapt/herdr/__tests__/wiring.test.js.map

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

package/dist/adapt/herdr/authority.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tracks whether OMX currently holds Herdr `omx:runtime` authority for a pane,
+ * so release only fires when no OMX workflow remains active, and so a stale
+ * authority left by a crashed process can be reconciled on the next
+ * session-start.
+ */
+export interface AuthorityRecord {
+    pane_id: string;
+    source: string;
+    owner_pid: number;
+    session_id?: string;
+    acquired_at: string;
+    updated_at: string;
+}
+export interface AuthorityStoreOptions {
+    baseDir?: string;
+}
+export declare function readAuthority(options?: AuthorityStoreOptions): AuthorityRecord | null;
+export declare function recordAuthority(record: Omit<AuthorityRecord, "acquired_at" | "updated_at"> & Partial<Pick<AuthorityRecord, "acquired_at">>, options?: AuthorityStoreOptions): void;
+export declare function clearAuthority(options?: AuthorityStoreOptions): void;
+/**
+ * A liveness probe for the current owner process. Injectable for tests; the
+ * default checks whether the recorded pid is alive via `process.kill(pid, 0)`.
+ */
+export type PidLivenessProbe = (pid: number) => boolean;
+/**
+ * Crash reconciliation: if an authority record exists but its owner process is
+ * no longer alive, clear it so Herdr returns to normal screen detection. Call
+ * on session-start. Returns true when a stale record was cleared.
+ */
+export declare function reconcileStaleAuthority(options?: AuthorityStoreOptions & {
+    pidAlive?: PidLivenessProbe;
+}): boolean;
+//# sourceMappingURL=authority.d.ts.map

package/dist/adapt/herdr/authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../../src/adapt/herdr/authority.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,aAAa,CAC5B,OAAO,GAAE,qBAA0B,GACjC,eAAe,GAAG,IAAI,CAQxB;AAYD,wBAAgB,eAAe,CAC9B,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,YAAY,CAAC,GAC1D,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,EAC9C,OAAO,GAAE,qBAA0B,GACjC,IAAI,CAWN;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,IAAI,CASxE;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAaxD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,GAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,EAAE,gBAAgB,CAAA;CAAO,GACnE,OAAO,CAOT"}