oh-my-codex 0.20.3 → 0.20.5

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"}

package/dist/adapt/herdr/authority.js

@@ -0,0 +1,71 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { omxAdaptersDir } from "../../utils/paths.js";
+function authorityPath(baseDir) {
+    return join(baseDir ?? join(omxAdaptersDir(), "herdr"), "authority.json");
+}
+export function readAuthority(options = {}) {
+    try {
+        return JSON.parse(readFileSync(authorityPath(options.baseDir), "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeAuthorityAtomic(record, baseDir) {
+    const path = authorityPath(baseDir);
+    mkdirSync(join(baseDir ?? join(omxAdaptersDir(), "herdr")), {
+        recursive: true,
+    });
+    const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+    writeFileSync(tmp, `${JSON.stringify(record, null, 2)}\n`, "utf-8");
+    renameSync(tmp, path);
+}
+export function recordAuthority(record, options = {}) {
+    const now = new Date().toISOString();
+    const existing = readAuthority(options);
+    writeAuthorityAtomic({
+        ...record,
+        acquired_at: record.acquired_at ?? existing?.acquired_at ?? now,
+        updated_at: now,
+    }, options.baseDir);
+}
+export function clearAuthority(options = {}) {
+    const path = authorityPath(options.baseDir);
+    if (existsSync(path)) {
+        try {
+            rmSync(path);
+        }
+        catch {
+            // best-effort
+        }
+    }
+}
+const defaultPidAlive = (pid) => {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // ESRCH => no such process; EPERM => exists but not ours (treat as alive)
+        return error.code === "EPERM";
+    }
+};
+/**
+ * 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 function reconcileStaleAuthority(options = {}) {
+    const record = readAuthority(options);
+    if (!record)
+        return false;
+    const alive = (options.pidAlive ?? defaultPidAlive)(record.owner_pid);
+    if (alive)
+        return false;
+    clearAuthority(options);
+    return true;
+}
+//# sourceMappingURL=authority.js.map

package/dist/adapt/herdr/authority.js.map

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

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

@@ -0,0 +1,84 @@
+import type { HookEventEnvelope, HookEventName } from "../../hooks/extensibility/types.js";
+import { type HerdrRollupInput, type HerdrSemanticState } from "./semantic.js";
+import { type HerdrEnv, type HerdrTransport, type HerdrTransportResult } from "./transport.js";
+export declare const HERDR_BRIDGE_SOURCE = "omx:runtime";
+export declare const HERDR_BRIDGE_AGENT = "codex";
+export interface HerdrBridgeOptions {
+    env?: HerdrEnv;
+    transport?: HerdrTransport;
+    source?: string;
+    agent?: string;
+    /** Injectable seq provider; defaults to the durable cross-process store. */
+    seqFn?: (source: string) => number;
+    /** Base dir for the durable seq/authority stores (tests). */
+    stateBaseDir?: string;
+    /**
+     * Returns true when an OMX workflow other than this one remains active, so
+     * release must be suppressed. Defaults to "nothing else active".
+     */
+    workflowActiveFn?: () => boolean;
+    /** Best-effort logger; never throws into the OMX run. */
+    logger?: (message: string, meta?: Record<string, unknown>) => void;
+    /** Session id recorded on the authority record for crash reconciliation. */
+    sessionId?: string;
+}
+export interface HerdrBridgeOutcome {
+    attempted: boolean;
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    state?: HerdrSemanticState;
+    seq?: number;
+    released?: boolean;
+    transport?: HerdrTransportResult;
+}
+/**
+ * Opt-in, best-effort OMX -> Herdr lifecycle/status bridge.
+ *
+ * - No behavior change outside a detected Herdr pane.
+ * - Ordered: seq comes from a durable cross-process per-source store, so stale
+ *   reports cannot win across concurrent hook processes or restarts.
+ * - Non-blocking / failure-isolated: transport errors are captured and returned,
+ *   never thrown.
+ * - Release is gated on remaining active workflows and records/clears authority
+ *   for crash reconciliation.
+ */
+export declare class HerdrBridge {
+    private readonly env;
+    private readonly transport;
+    private readonly source;
+    private readonly agent;
+    private readonly seqFn;
+    private readonly workflowActiveFn;
+    private readonly stateBaseDir?;
+    private readonly sessionId?;
+    private readonly logger?;
+    private released;
+    private authorityRecorded;
+    constructor(options?: HerdrBridgeOptions);
+    get enabled(): boolean;
+    private nextSeq;
+    private skip;
+    reportState(state: HerdrSemanticState, options?: {
+        message?: string;
+        metadata?: Record<string, string>;
+    }): Promise<HerdrBridgeOutcome>;
+    reportHookEvent(event: HookEventEnvelope | HookEventName | string, options?: {
+        message?: string;
+        metadata?: Record<string, string>;
+    }): Promise<HerdrBridgeOutcome>;
+    reportTeamRollup(input: HerdrRollupInput, options?: {
+        metadata?: Record<string, string>;
+    }): Promise<HerdrBridgeOutcome>;
+    /**
+     * Release `omx:runtime` authority. Suppressed while another OMX workflow
+     * remains active (a single terminal event must not release authority for
+     * still-running workflows). Clears the authority record on release.
+     */
+    release(): Promise<HerdrBridgeOutcome>;
+    private ensureAuthorityRecorded;
+    private clearAuthorityRecord;
+    private log;
+}
+export declare function createHerdrBridge(options?: HerdrBridgeOptions): HerdrBridge;
+//# sourceMappingURL=bridge.d.ts.map

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

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