oh-my-codex 0.20.3 → 0.21.0

package/dist/adapt/herdr/semantic.js

@@ -0,0 +1,170 @@
+/**
+ * Herdr semantic agent states, as documented by the official Herdr socket/CLI
+ * protocol (herdr.dev/docs/agents, /docs/socket-api). `state` is semantic: it
+ * drives Herdr waits, notifications, and workspace rollups. Display-only detail
+ * is carried separately as metadata tokens.
+ */
+export const HERDR_SEMANTIC_STATES = [
+    "working",
+    "blocked",
+    "idle",
+    "unknown",
+];
+/**
+ * OMX hook lifecycle events that map to Herdr `working`. These represent an
+ * active turn, an active workflow, or active workers/tasks.
+ */
+const WORKING_EVENTS = new Set([
+    "session-start",
+    "run.heartbeat",
+    "worker.assigned",
+    "worker.recovered",
+    "test-started",
+    "pre-tool-use",
+    "post-tool-use",
+]);
+/**
+ * OMX hook lifecycle events that map to Herdr `blocked`. These represent an
+ * approval, question, or user decision that OMX is waiting on.
+ */
+const BLOCKED_EVENTS = new Set([
+    "blocked",
+    "run.blocked_on_user",
+    "run.blocked_on_system",
+    "needs-input",
+    "handoff-needed",
+]);
+/**
+ * OMX hook lifecycle events that map to Herdr `idle`. These represent a turn,
+ * workflow, or session reaching a terminal or resting state. Herdr derives its
+ * own `done`/seen behavior from `idle`.
+ */
+const IDLE_EVENTS = new Set([
+    "turn-complete",
+    "finished",
+    "failed",
+    "stop",
+    "session-end",
+    "session-idle",
+]);
+/**
+ * OMX lifecycle events after which OMX should release `omx:runtime` authority so
+ * Herdr can safely return to its normal Codex screen detection. Only whole-
+ * session shutdown releases authority; per-run `finished`/`failed` map to `idle`
+ * without releasing, because a single run ending does not mean OMX has left the
+ * pane.
+ */
+const TERMINAL_EVENTS = new Set(["stop", "session-end"]);
+/**
+ * Map a single OMX hook lifecycle event to a Herdr semantic state. Unknown or
+ * unmapped events resolve to `unknown` rather than guessing, matching the issue
+ * requirement that reconciliation-uncertain state is reported as `unknown`.
+ */
+export function mapHookEventToHerdrState(event) {
+    const name = typeof event === "string" ? event : event.event;
+    if (BLOCKED_EVENTS.has(name)) {
+        return {
+            state: "blocked",
+            terminal: false,
+            reason: `OMX event '${name}' requires user/system attention.`,
+        };
+    }
+    if (WORKING_EVENTS.has(name)) {
+        return {
+            state: "working",
+            terminal: false,
+            reason: `OMX event '${name}' indicates active work.`,
+        };
+    }
+    if (IDLE_EVENTS.has(name)) {
+        return {
+            state: "idle",
+            terminal: TERMINAL_EVENTS.has(name),
+            reason: `OMX event '${name}' reached a terminal/resting state.`,
+        };
+    }
+    return {
+        state: "unknown",
+        terminal: false,
+        reason: `OMX event '${name}' has no authoritative Herdr mapping.`,
+    };
+}
+export function isTerminalHookEvent(event) {
+    const name = typeof event === "string" ? event : event.event;
+    return TERMINAL_EVENTS.has(name);
+}
+/**
+ * Roll up authoritative OMX Team worker/task state into a single Herdr semantic
+ * state, rather than relying on Herdr's pane-output inference.
+ *
+ * Precedence, per issue #3241:
+ *   1. `blocked` if the leader needs user input or an authoritative worker/task
+ *      is blocked on user action.
+ *   2. otherwise `working` while any worker/task is active.
+ *   3. otherwise `idle` when the run is terminal (or nothing is active).
+ */
+export function rollupTeamState(input) {
+    const counts = {
+        total: input.workers.length,
+        working: 0,
+        blocked: 0,
+        blockedOnUser: 0,
+        done: 0,
+        failed: 0,
+        idle: 0,
+        unknown: 0,
+    };
+    for (const worker of input.workers) {
+        switch (worker.state) {
+            case "working":
+                counts.working += 1;
+                break;
+            case "blocked":
+                counts.blocked += 1;
+                if (worker.blockedOnUser !== false)
+                    counts.blockedOnUser += 1;
+                break;
+            case "done":
+                counts.done += 1;
+                break;
+            case "failed":
+                counts.failed += 1;
+                break;
+            case "idle":
+                counts.idle += 1;
+                break;
+            default:
+                counts.unknown += 1;
+                break;
+        }
+    }
+    if (input.leaderBlockedOnUser) {
+        return {
+            state: "blocked",
+            reason: "Leader is blocked on user action.",
+            counts,
+        };
+    }
+    if (counts.blockedOnUser > 0) {
+        return {
+            state: "blocked",
+            reason: `${counts.blockedOnUser} worker/task blocked on user action.`,
+            counts,
+        };
+    }
+    if (counts.working > 0) {
+        return {
+            state: "working",
+            reason: `${counts.working} worker/task active.`,
+            counts,
+        };
+    }
+    return {
+        state: "idle",
+        reason: input.runTerminal
+            ? "Run reached a terminal state; no active workers."
+            : "No active or user-blocked workers.",
+        counts,
+    };
+}
+//# sourceMappingURL=semantic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../../src/adapt/herdr/semantic.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,SAAS;IACT,SAAS;IACT,MAAM;IACN,SAAS;CACA,CAAC;AAGX;;;GAGG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS;IACtC,eAAe;IACf,eAAe;IACf,iBAAiB;IACjB,kBAAkB;IAClB,cAAc;IACd,cAAc;IACd,eAAe;CACf,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS;IACtC,SAAS;IACT,qBAAqB;IACrB,uBAAuB;IACvB,aAAa;IACb,gBAAgB;CAChB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS;IACnC,eAAe;IACf,UAAU;IACV,QAAQ;IACR,MAAM;IACN,aAAa;IACb,cAAc;CACd,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAUjE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAiD;IAEjD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAE7D,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,cAAc,IAAI,mCAAmC;SAC7D,CAAC;IACH,CAAC;IACD,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,cAAc,IAAI,0BAA0B;SACpD,CAAC;IACH,CAAC;IACD,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO;YACN,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YACnC,MAAM,EAAE,cAAc,IAAI,qCAAqC;SAC/D,CAAC;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,cAAc,IAAI,uCAAuC;KACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,KAAiD;IAEjD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7D,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AA4CD;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAAuB;IACtD,MAAM,MAAM,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;QAC3B,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;KACV,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACpC,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,KAAK,SAAS;gBACb,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;gBACpB,MAAM;YACP,KAAK,SAAS;gBACb,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;gBACpB,IAAI,MAAM,CAAC,aAAa,KAAK,KAAK;oBAAE,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;gBAC9D,MAAM;YACP,KAAK,MAAM;gBACV,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;gBACjB,MAAM;YACP,KAAK,QAAQ;gBACZ,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;gBACnB,MAAM;YACP,KAAK,MAAM;gBACV,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;gBACjB,MAAM;YACP;gBACC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;gBACpB,MAAM;QACR,CAAC;IACF,CAAC;IAED,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC/B,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,mCAAmC;YAC3C,MAAM;SACN,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,sCAAsC;YACrE,MAAM;SACN,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,sBAAsB;YAC/C,MAAM;SACN,CAAC;IACH,CAAC;IAED,OAAO;QACN,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,KAAK,CAAC,WAAW;YACxB,CAAC,CAAC,kDAAkD;YACpD,CAAC,CAAC,oCAAoC;QACvC,MAAM;KACN,CAAC;AACH,CAAC"}

package/dist/adapt/herdr/seq-store.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Durable, atomic, per-source monotonic sequence store for Herdr reports.
+ *
+ * Herdr accepts but ignores a report whose `seq <= last accepted seq for the
+ * same source`. Hooks run as short-lived processes, so an in-memory counter
+ * resets to 1 on every process/restart and would (a) let legitimate new reports
+ * be rejected as stale after a restart and (b) fail to prevent stale reports
+ * across concurrent processes. This store persists the counter under
+ * `.omx/adapters/herdr/seq/<sanitized-source>.json` and serializes concurrent
+ * increments with an atomic mkdir lock, so seq is strictly increasing per source
+ * across processes and restarts.
+ */
+export interface SeqStoreOptions {
+    /** Base `.omx/adapters/herdr` dir; defaults to the resolved OMX adapters dir. */
+    baseDir?: string;
+    /** Max time to wait for the lock before giving up (best-effort). */
+    lockTimeoutMs?: number;
+    /** Consider a held lock stale after this age (crash recovery). */
+    lockStaleMs?: number;
+}
+/** Filesystem-safe, collision-resistant file stem for a source id. */
+export declare function sanitizeSourceKey(source: string): string;
+/**
+ * Atomically read-increment-persist the per-source counter and return the new
+ * seq. Strictly increasing and unique per source across concurrent processes
+ * and restarts. Falls back to a time-derived seq only if the lock cannot be
+ * acquired, so a report is never dropped and never regresses below the last
+ * persisted value.
+ */
+export declare function nextSeq(source: string, options?: SeqStoreOptions): number;
+export declare function readPersistedSeq(source: string, options?: SeqStoreOptions): number;
+//# sourceMappingURL=seq-store.d.ts.map

package/dist/adapt/herdr/seq-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seq-store.d.ts","sourceRoot":"","sources":["../../../src/adapt/herdr/seq-store.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,eAAe;IAC/B,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AA2ED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CA8B7E;AAUD,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC3B,MAAM,CAER"}

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

@@ -0,0 +1,126 @@
+import { mkdirSync, readFileSync, renameSync, rmdirSync, statSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { omxAdaptersDir } from "../../utils/paths.js";
+const DEFAULT_LOCK_TIMEOUT_MS = 2000;
+const DEFAULT_LOCK_STALE_MS = 10_000;
+const MAX_SEQ = Number.MAX_SAFE_INTEGER;
+function herdrSeqDir(baseDir) {
+    return join(baseDir ?? join(omxAdaptersDir(), "herdr"), "seq");
+}
+/** Filesystem-safe, collision-resistant file stem for a source id. */
+export function sanitizeSourceKey(source) {
+    const cleaned = source.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 80);
+    return cleaned.length > 0 ? cleaned : "unknown-source";
+}
+function counterPath(baseDir, source) {
+    return join(herdrSeqDir(baseDir), `${sanitizeSourceKey(source)}.json`);
+}
+function lockPath(baseDir, source) {
+    return join(herdrSeqDir(baseDir), `${sanitizeSourceKey(source)}.lock`);
+}
+function readCounter(path) {
+    try {
+        const raw = readFileSync(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        const value = typeof parsed.seq === "number" ? parsed.seq : 0;
+        return Number.isFinite(value) && value >= 0 ? Math.floor(value) : 0;
+    }
+    catch {
+        // Missing or corrupt counter: restart from 0 (first seq will be 1).
+        return 0;
+    }
+}
+function writeCounterAtomic(path, seq) {
+    const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+    writeFileSync(tmp, `${JSON.stringify({ seq, updated_at: new Date().toISOString() })}\n`, "utf-8");
+    renameSync(tmp, path);
+}
+function acquireLock(lock, timeoutMs, staleMs) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            mkdirSync(lock, { recursive: false });
+            return true;
+        }
+        catch {
+            // Lock held: break it if stale, otherwise spin until the deadline.
+            try {
+                const age = Date.now() - statSync(lock).mtimeMs;
+                if (age > staleMs) {
+                    try {
+                        rmdirSync(lock);
+                    }
+                    catch {
+                        // another process broke it first; retry
+                    }
+                    continue;
+                }
+            }
+            catch {
+                // lock vanished between mkdir and stat; retry
+            }
+            if (Date.now() >= deadline)
+                return false;
+            busyWait(5);
+        }
+    }
+}
+function releaseLock(lock) {
+    try {
+        rmdirSync(lock);
+    }
+    catch {
+        // already released
+    }
+}
+/** Small synchronous sleep so the lock loop stays sync (hooks call this inline). */
+function busyWait(ms) {
+    const until = Date.now() + ms;
+    while (Date.now() < until) {
+        // intentional short spin; ms is tiny (single-digit)
+    }
+}
+/**
+ * Atomically read-increment-persist the per-source counter and return the new
+ * seq. Strictly increasing and unique per source across concurrent processes
+ * and restarts. Falls back to a time-derived seq only if the lock cannot be
+ * acquired, so a report is never dropped and never regresses below the last
+ * persisted value.
+ */
+export function nextSeq(source, options = {}) {
+    const dir = herdrSeqDir(options.baseDir);
+    try {
+        mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        // If we cannot even create the dir, fall back to a time-derived seq.
+        return timeDerivedSeq();
+    }
+    const path = counterPath(options.baseDir, source);
+    const lock = lockPath(options.baseDir, source);
+    const acquired = acquireLock(lock, options.lockTimeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS, options.lockStaleMs ?? DEFAULT_LOCK_STALE_MS);
+    if (!acquired) {
+        // Best-effort: never block the OMX run on lock contention.
+        return timeDerivedSeq(readCounter(path));
+    }
+    try {
+        const current = readCounter(path);
+        const next = current >= MAX_SEQ ? current : current + 1;
+        writeCounterAtomic(path, next);
+        return next;
+    }
+    finally {
+        releaseLock(lock);
+    }
+}
+/**
+ * Monotonic-ish fallback derived from wall clock, floored above any known
+ * persisted value so it cannot regress below the last accepted seq.
+ */
+function timeDerivedSeq(floor = 0) {
+    return Math.max(floor + 1, Date.now());
+}
+export function readPersistedSeq(source, options = {}) {
+    return readCounter(counterPath(options.baseDir, source));
+}
+//# sourceMappingURL=seq-store.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { HerdrRollupInput } from "./semantic.js";
+/**
+ * Minimal authoritative Team-state shape consumed by the Herdr rollup. This
+ * intentionally mirrors the real OMX Team state surfaces
+ * (`WorkerStatus.state` from `src/team/state.ts` and the leader attention flag
+ * `leader_attention_pending` from the team leader-attention state) rather than
+ * inventing a bespoke shape.
+ */
+export interface TeamWorkerStateInput {
+    id: string;
+    /** WorkerStatus.state from src/team/state.ts */
+    state: "idle" | "working" | "blocked" | "done" | "failed" | "draining" | "unknown";
+    /** WorkerStatus.reason, used to detect user-blocking. */
+    reason?: string;
+}
+export interface TeamStateInput {
+    /** leader_attention_pending from the team leader-attention state. */
+    leaderAttentionPending?: boolean;
+    workers: TeamWorkerStateInput[];
+    runTerminal?: boolean;
+}
+/**
+ * Map real authoritative Team state into the Herdr rollup input. The leader
+ * attention flag is the authoritative user-block signal; a worker marked
+ * `blocked` only counts as user-blocking when its reason indicates a user
+ * decision, so a system-blocked worker does not force the whole pane to look
+ * blocked.
+ */
+export declare function mapTeamStateToRollup(state: TeamStateInput): HerdrRollupInput;
+//# sourceMappingURL=team-map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-map.d.ts","sourceRoot":"","sources":["../../../src/adapt/herdr/team-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACnF,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAsBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAa5E"}

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

@@ -0,0 +1,37 @@
+const USER_BLOCK_REASON = /(user|input|approval|permission|decision|confirm|review)/i;
+function mapWorkerState(state) {
+    switch (state) {
+        case "draining":
+            // Winding down but still active work; treat as working for rollup.
+            return "working";
+        case "idle":
+        case "working":
+        case "blocked":
+        case "done":
+        case "failed":
+            return state;
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Map real authoritative Team state into the Herdr rollup input. The leader
+ * attention flag is the authoritative user-block signal; a worker marked
+ * `blocked` only counts as user-blocking when its reason indicates a user
+ * decision, so a system-blocked worker does not force the whole pane to look
+ * blocked.
+ */
+export function mapTeamStateToRollup(state) {
+    return {
+        leaderBlockedOnUser: state.leaderAttentionPending === true,
+        runTerminal: state.runTerminal,
+        workers: state.workers.map((worker) => ({
+            id: worker.id,
+            state: mapWorkerState(worker.state),
+            blockedOnUser: worker.state === "blocked"
+                ? USER_BLOCK_REASON.test(worker.reason ?? "")
+                : undefined,
+        })),
+    };
+}
+//# sourceMappingURL=team-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-map.js","sourceRoot":"","sources":["../../../src/adapt/herdr/team-map.ts"],"names":[],"mappings":"AAwBA,MAAM,iBAAiB,GAAG,2DAA2D,CAAC;AAEtF,SAAS,cAAc,CACtB,KAAoC;IAEpC,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,UAAU;YACd,mEAAmE;YACnE,OAAO,SAAS,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACZ,OAAO,KAAK,CAAC;QACd;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACzD,OAAO;QACN,mBAAmB,EAAE,KAAK,CAAC,sBAAsB,KAAK,IAAI;QAC1D,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC;YACnC,aAAa,EACZ,MAAM,CAAC,KAAK,KAAK,SAAS;gBACzB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC7C,CAAC,CAAC,SAAS;SACb,CAAC,CAAC;KACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,115 @@
+import type { HerdrSemanticState } from "./semantic.js";
+/**
+ * Herdr pane environment exported into managed pane processes:
+ *   HERDR_ENV=1, HERDR_PANE_ID, HERDR_SOCKET_PATH, HERDR_BIN_PATH.
+ * See herdr.dev/docs/socket-api.
+ */
+export interface HerdrEnv {
+    /** True only when OMX is running inside a Herdr-managed pane. */
+    enabled: boolean;
+    paneId: string | null;
+    socketPath: string | null;
+    binPath: string | null;
+}
+export declare function detectHerdrEnv(env?: NodeJS.ProcessEnv): HerdrEnv;
+export interface HerdrAgentReport {
+    paneId: string;
+    source: string;
+    agent: string;
+    state: HerdrSemanticState;
+    message?: string;
+    seq: number;
+    metadata?: Record<string, string>;
+}
+export interface HerdrReleaseReport {
+    paneId: string;
+    source: string;
+    seq: number;
+}
+export interface HerdrTransportResult {
+    ok: boolean;
+    transport: "cli" | "socket";
+    detail: string;
+    error?: string;
+}
+export interface HerdrTransport {
+    readonly kind: "cli" | "socket";
+    reportAgent(report: HerdrAgentReport): Promise<HerdrTransportResult>;
+    releaseAgent(report: HerdrReleaseReport): Promise<HerdrTransportResult>;
+}
+type ExecFileFn = (file: string, args: string[], callback: (error: Error | null) => void) => void;
+/** Build argv for `herdr pane report-agent` (no shell; execFile argv array). */
+export declare function buildReportAgentArgs(report: HerdrAgentReport): string[];
+export declare function buildReleaseAgentArgs(report: HerdrReleaseReport): string[];
+/**
+ * Trust-pin the Herdr binary: only an absolute path to an existing regular file
+ * is accepted. A bare `herdr` (PATH-resolved) is never used, to avoid PATH
+ * hijack. Returns the trusted absolute path or null.
+ */
+export declare function resolveTrustedHerdrBin(binPath: string | null | undefined): string | null;
+export interface CliTransportOptions {
+    binPath?: string | null;
+    /** Injectable for tests; defaults to node:child_process execFile. */
+    execFileFn?: ExecFileFn;
+    timeoutMs?: number;
+}
+/**
+ * Argv-safe CLI transport. Requires a trust-pinned absolute Herdr binary; never
+ * shells out and never falls back to a PATH-resolved `herdr`.
+ */
+export declare class CliHerdrTransport implements HerdrTransport {
+    readonly kind: "cli";
+    private readonly bin;
+    private readonly execFileFn;
+    constructor(options?: CliTransportOptions);
+    /** True only when a trust-pinned binary is available. */
+    get available(): boolean;
+    reportAgent(report: HerdrAgentReport): Promise<HerdrTransportResult>;
+    releaseAgent(report: HerdrReleaseReport): Promise<HerdrTransportResult>;
+    private run;
+}
+export interface SocketRequest {
+    id: string;
+    method: string;
+    params: Record<string, unknown>;
+}
+export interface SocketResponse {
+    id?: string;
+    result?: unknown;
+    error?: {
+        code?: string;
+        message?: string;
+    } | string;
+}
+/**
+ * Send one request and await the correlated response. Implementations must only
+ * resolve `ok` when Herdr accepted the request (a matching `{id,result}`),
+ * reject on `{id,error}`, and enforce bounded framing/timeout/backpressure.
+ */
+export type SocketExchange = (socketPath: string, request: SocketRequest) => Promise<SocketResponse>;
+export interface SocketTransportOptions {
+    socketPath: string;
+    /** Injectable request/response exchange; defaults to a real Unix-socket NDJSON round-trip. */
+    exchange?: SocketExchange;
+    timeoutMs?: number;
+    maxFrameBytes?: number;
+}
+/**
+ * Raw Herdr socket transport with request/response correlation. Herdr uses
+ * newline-delimited JSON over a local Unix domain socket; method names use dot
+ * notation (pane.report_agent, pane.release_agent). Success is only reported
+ * when a correlated `{id,result}` reply is received (Herdr acceptance), not when
+ * bytes flush.
+ */
+export declare class SocketHerdrTransport implements HerdrTransport {
+    readonly kind: "socket";
+    private readonly socketPath;
+    private readonly exchange;
+    private counter;
+    constructor(options: SocketTransportOptions);
+    reportAgent(report: HerdrAgentReport): Promise<HerdrTransportResult>;
+    releaseAgent(report: HerdrReleaseReport): Promise<HerdrTransportResult>;
+    private send;
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

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

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