oh-my-codex 0.20.3 → 0.20.5

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":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACxB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CAS7E;AAQD,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAChC,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACrE,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxE;AAED,KAAK,UAAU,GAAG,CACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,KACnC,IAAI,CAAC;AAEV,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAkBvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAU1E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQxF;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qEAAqE;IACrE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,YAAY,OAAO,GAAE,mBAAwB,EAS5C;IAED,yDAAyD;IACzD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEnE;IAED,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEtE;IAED,OAAO,CAAC,GAAG;CAyBX;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,KAClB,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAC1D,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,OAAO,CAAK;IAEpB,YAAY,OAAO,EAAE,sBAAsB,EAS1C;IAED,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAenE;IAED,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAMtE;YAEa,IAAI;CA2ClB"}

package/dist/adapt/herdr/transport.js

@@ -0,0 +1,260 @@
+import { execFile } from "node:child_process";
+import { statSync } from "node:fs";
+import { createConnection } from "node:net";
+import { isAbsolute } from "node:path";
+export function detectHerdrEnv(env = process.env) {
+    const paneId = nonEmpty(env.HERDR_PANE_ID);
+    const enabled = env.HERDR_ENV === "1" && paneId !== null;
+    return {
+        enabled,
+        paneId,
+        socketPath: nonEmpty(env.HERDR_SOCKET_PATH),
+        binPath: nonEmpty(env.HERDR_BIN_PATH),
+    };
+}
+function nonEmpty(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/** Build argv for `herdr pane report-agent` (no shell; execFile argv array). */
+export function buildReportAgentArgs(report) {
+    const args = [
+        "pane",
+        "report-agent",
+        report.paneId,
+        "--source",
+        report.source,
+        "--agent",
+        report.agent,
+        "--state",
+        report.state,
+        "--seq",
+        String(report.seq),
+    ];
+    if (report.message !== undefined && report.message.length > 0) {
+        args.push("--message", report.message);
+    }
+    return args;
+}
+export function buildReleaseAgentArgs(report) {
+    return [
+        "pane",
+        "release-agent",
+        report.paneId,
+        "--source",
+        report.source,
+        "--seq",
+        String(report.seq),
+    ];
+}
+/**
+ * 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 function resolveTrustedHerdrBin(binPath) {
+    const candidate = typeof binPath === "string" ? binPath.trim() : "";
+    if (candidate.length === 0 || !isAbsolute(candidate))
+        return null;
+    try {
+        return statSync(candidate).isFile() ? candidate : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Argv-safe CLI transport. Requires a trust-pinned absolute Herdr binary; never
+ * shells out and never falls back to a PATH-resolved `herdr`.
+ */
+export class CliHerdrTransport {
+    kind = "cli";
+    bin;
+    execFileFn;
+    constructor(options = {}) {
+        this.bin = resolveTrustedHerdrBin(options.binPath);
+        this.execFileFn =
+            options.execFileFn ??
+                ((file, args, cb) => {
+                    execFile(file, args, { timeout: options.timeoutMs ?? 5000 }, (err) => cb(err));
+                });
+    }
+    /** True only when a trust-pinned binary is available. */
+    get available() {
+        return this.bin !== null;
+    }
+    reportAgent(report) {
+        return this.run(buildReportAgentArgs(report), "report-agent");
+    }
+    releaseAgent(report) {
+        return this.run(buildReleaseAgentArgs(report), "release-agent");
+    }
+    run(args, op) {
+        return new Promise((resolve) => {
+            if (!this.bin) {
+                resolve({
+                    ok: false,
+                    transport: "cli",
+                    detail: `herdr ${op} skipped`,
+                    error: "no trust-pinned herdr binary (HERDR_BIN_PATH must be an absolute existing file)",
+                });
+                return;
+            }
+            this.execFileFn(this.bin, args, (error) => {
+                if (error) {
+                    resolve({
+                        ok: false,
+                        transport: "cli",
+                        detail: `herdr ${op} failed`,
+                        error: error.message,
+                    });
+                    return;
+                }
+                resolve({ ok: true, transport: "cli", detail: `herdr ${op} ok` });
+            });
+        });
+    }
+}
+const DEFAULT_MAX_FRAME_BYTES = 256 * 1024;
+/**
+ * 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 class SocketHerdrTransport {
+    kind = "socket";
+    socketPath;
+    exchange;
+    counter = 0;
+    constructor(options) {
+        this.socketPath = options.socketPath;
+        this.exchange =
+            options.exchange ??
+                ((socketPath, request) => ndjsonExchange(socketPath, request, {
+                    timeoutMs: options.timeoutMs ?? 5000,
+                    maxFrameBytes: options.maxFrameBytes ?? DEFAULT_MAX_FRAME_BYTES,
+                }));
+    }
+    reportAgent(report) {
+        const params = {
+            pane_id: report.paneId,
+            source: report.source,
+            agent: report.agent,
+            state: report.state,
+            seq: report.seq,
+        };
+        if (report.message !== undefined && report.message.length > 0) {
+            params.message = report.message;
+        }
+        if (report.metadata && Object.keys(report.metadata).length > 0) {
+            params.tokens = report.metadata;
+        }
+        return this.send("pane.report_agent", params, "report-agent");
+    }
+    releaseAgent(report) {
+        return this.send("pane.release_agent", { pane_id: report.paneId, source: report.source, seq: report.seq }, "release-agent");
+    }
+    async send(method, params, op) {
+        this.counter += 1;
+        const request = {
+            id: `omx-${op}-${process.pid}-${this.counter}`,
+            method,
+            params,
+        };
+        try {
+            const response = await this.exchange(this.socketPath, request);
+            if (response.id !== undefined && response.id !== request.id) {
+                return {
+                    ok: false,
+                    transport: "socket",
+                    detail: `${method} response id mismatch`,
+                    error: `expected ${request.id}, got ${response.id}`,
+                };
+            }
+            if (response.error !== undefined) {
+                const message = typeof response.error === "string"
+                    ? response.error
+                    : (response.error.message ?? response.error.code ?? "herdr error");
+                return {
+                    ok: false,
+                    transport: "socket",
+                    detail: `${method} rejected`,
+                    error: message,
+                };
+            }
+            return { ok: true, transport: "socket", detail: `${method} accepted` };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                transport: "socket",
+                detail: `${method} failed`,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+/**
+ * Real Unix-socket NDJSON request/response: write one request line, then read
+ * reply lines with a bounded buffer, parse each NDJSON line, and resolve on the
+ * first line whose `id` matches (or the first parseable object when the reply
+ * carries no id). Enforces a total-buffer cap (backpressure/oversized-frame
+ * guard) and a hard timeout.
+ */
+function ndjsonExchange(socketPath, request, options) {
+    return new Promise((resolve, reject) => {
+        const socket = createConnection(socketPath);
+        let settled = false;
+        let buffer = "";
+        const done = (err, value) => {
+            if (settled)
+                return;
+            settled = true;
+            socket.destroy();
+            if (err)
+                reject(err);
+            else
+                resolve(value ?? {});
+        };
+        socket.setTimeout(options.timeoutMs, () => done(new Error("herdr socket timeout")));
+        socket.on("error", (err) => done(err));
+        socket.on("close", () => done(new Error("herdr socket closed before reply")));
+        socket.on("connect", () => {
+            socket.write(`${JSON.stringify(request)}\n`, (err) => {
+                if (err)
+                    done(err);
+            });
+        });
+        socket.on("data", (chunk) => {
+            buffer += chunk.toString("utf-8");
+            if (Buffer.byteLength(buffer, "utf-8") > options.maxFrameBytes) {
+                done(new Error("herdr response exceeded max frame bytes"));
+                return;
+            }
+            let newlineIndex = buffer.indexOf("\n");
+            while (newlineIndex !== -1) {
+                const line = buffer.slice(0, newlineIndex).trim();
+                buffer = buffer.slice(newlineIndex + 1);
+                if (line.length > 0) {
+                    let parsed = null;
+                    try {
+                        parsed = JSON.parse(line);
+                    }
+                    catch {
+                        parsed = null;
+                    }
+                    if (parsed && (parsed.id === undefined || parsed.id === request.id)) {
+                        done(undefined, parsed);
+                        return;
+                    }
+                }
+                newlineIndex = buffer.indexOf("\n");
+            }
+        });
+    });
+}
+//# sourceMappingURL=transport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/adapt/herdr/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAgBvC,MAAM,UAAU,cAAc,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,KAAK,GAAG,IAAI,MAAM,KAAK,IAAI,CAAC;IACzD,OAAO;QACN,OAAO;QACP,MAAM;QACN,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC3C,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;KACrC,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAqCD,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC5D,MAAM,IAAI,GAAG;QACZ,MAAM;QACN,cAAc;QACd,MAAM,CAAC,MAAM;QACb,UAAU;QACV,MAAM,CAAC,MAAM;QACb,SAAS;QACT,MAAM,CAAC,KAAK;QACZ,SAAS;QACT,MAAM,CAAC,KAAK;QACZ,OAAO;QACP,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;KAClB,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA0B;IAC/D,OAAO;QACN,MAAM;QACN,eAAe;QACf,MAAM,CAAC,MAAM;QACb,UAAU;QACV,MAAM,CAAC,MAAM;QACb,OAAO;QACP,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;KAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAkC;IACxE,MAAM,SAAS,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,CAAC;QACJ,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AASD;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,IAAI,GAAG,KAAc,CAAC;IACd,GAAG,CAAgB;IACnB,UAAU,CAAa;IAExC,YAAY,OAAO,GAAwB,EAAE;QAC5C,IAAI,CAAC,GAAG,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU;YACd,OAAO,CAAC,UAAU;gBAClB,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE;oBACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CACpE,EAAE,CAAC,GAAG,CAAC,CACP,CAAC;gBACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,MAAwB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,YAAY,CAAC,MAA0B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC;IACjE,CAAC;IAEO,GAAG,CAAC,IAAc,EAAE,EAAU;QACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACf,OAAO,CAAC;oBACP,EAAE,EAAE,KAAK;oBACT,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,SAAS,EAAE,UAAU;oBAC7B,KAAK,EAAE,iFAAiF;iBACxF,CAAC,CAAC;gBACH,OAAO;YACR,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;gBACzC,IAAI,KAAK,EAAE,CAAC;oBACX,OAAO,CAAC;wBACP,EAAE,EAAE,KAAK;wBACT,SAAS,EAAE,KAAK;wBAChB,MAAM,EAAE,SAAS,EAAE,SAAS;wBAC5B,KAAK,EAAE,KAAK,CAAC,OAAO;qBACpB,CAAC,CAAC;oBACH,OAAO;gBACR,CAAC;gBACD,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAgCD,MAAM,uBAAuB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACvB,IAAI,GAAG,QAAiB,CAAC;IACjB,UAAU,CAAS;IACnB,QAAQ,CAAiB;IAClC,OAAO,GAAG,CAAC,CAAC;IAEpB,YAAY,OAA+B;QAC1C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ;YACZ,OAAO,CAAC,QAAQ;gBAChB,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CACxB,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE;oBACnC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;oBACpC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,uBAAuB;iBAC/D,CAAC,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CAAC,MAAwB;QACnC,MAAM,MAAM,GAA4B;YACvC,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;SACf,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/D,CAAC;IAED,YAAY,CAAC,MAA0B;QACtC,OAAO,IAAI,CAAC,IAAI,CACf,oBAAoB,EACpB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,EAClE,eAAe,CACf,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CACjB,MAAc,EACd,MAA+B,EAC/B,EAAU;QAEV,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,MAAM,OAAO,GAAkB;YAC9B,EAAE,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE;YAC9C,MAAM;YACN,MAAM;SACN,CAAC;QACF,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;gBAC7D,OAAO;oBACN,EAAE,EAAE,KAAK;oBACT,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,GAAG,MAAM,uBAAuB;oBACxC,KAAK,EAAE,YAAY,OAAO,CAAC,EAAE,SAAS,QAAQ,CAAC,EAAE,EAAE;iBACnD,CAAC;YACH,CAAC;YACD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,OAAO,GACZ,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;oBACjC,CAAC,CAAC,QAAQ,CAAC,KAAK;oBAChB,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,aAAa,CAAC,CAAC;gBACrE,OAAO;oBACN,EAAE,EAAE,KAAK;oBACT,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,GAAG,MAAM,WAAW;oBAC5B,KAAK,EAAE,OAAO;iBACd,CAAC;YACH,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE,GAAG,MAAM,SAAS;gBAC1B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;QACH,CAAC;IACF,CAAC;CACD;AAOD;;;;;;GAMG;AACH,SAAS,cAAc,CACtB,UAAkB,EAClB,OAAsB,EACtB,OAA8B;IAE9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,KAAsB,EAAE,EAAE;YACpD,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CACzC,IAAI,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CACvC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACpD,IAAI,GAAG;oBAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACnC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;gBAChE,IAAI,CAAC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;gBAC3D,OAAO;YACR,CAAC;YACD,IAAI,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,IAAI,MAAM,GAA0B,IAAI,CAAC;oBACzC,IAAI,CAAC;wBACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;oBAC7C,CAAC;oBAAC,MAAM,CAAC;wBACR,MAAM,GAAG,IAAI,CAAC;oBACf,CAAC;oBACD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;wBACrE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;wBACxB,OAAO;oBACR,CAAC;gBACF,CAAC;gBACD,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { HookEventEnvelope } from "../../hooks/extensibility/types.js";
+import { type HerdrBridgeOptions } from "./bridge.js";
+export interface HerdrWiringInput {
+    cwd: string;
+    event: HookEventEnvelope;
+    /** Test injection for the bridge (env/transport/seq/etc.). */
+    bridgeOptions?: HerdrBridgeOptions;
+}
+export interface HerdrWiringResult {
+    wired: boolean;
+    reason: string;
+    reconciledStaleAuthority?: boolean;
+    state?: string;
+    released?: boolean;
+}
+/**
+ * Production entry point that reports a canonical OMX lifecycle event to the
+ * containing Herdr pane. Called from `dispatchHookEvent` (the single seam every
+ * native/derived/team/notify dispatch path funnels through). Best-effort and
+ * non-blocking: any failure is swallowed and never affects the OMX run, and it
+ * is a complete no-op outside a Herdr pane.
+ */
+export declare function reportHerdrLifecycleEvent(input: HerdrWiringInput): Promise<HerdrWiringResult>;
+//# sourceMappingURL=wiring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wiring.d.ts","sourceRoot":"","sources":["../../../src/adapt/herdr/wiring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGnE,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,iBAAiB,CAAC;IACzB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAwC5B"}