oh-my-codex 0.20.3 → 0.21.0

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

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

package/dist/adapt/herdr/wiring.js

@@ -0,0 +1,62 @@
+import { reconcileStaleAuthority } from "./authority.js";
+import { HerdrBridge } from "./bridge.js";
+import { detectHerdrEnv } from "./transport.js";
+/**
+ * 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 async function reportHerdrLifecycleEvent(input) {
+    const env = input.bridgeOptions?.env ?? detectHerdrEnv();
+    if (!env.enabled) {
+        return { wired: false, reason: "herdr-not-detected" };
+    }
+    try {
+        // On session-start, reconcile any authority left behind by a crashed
+        // prior OMX process before we (re)assert state.
+        let reconciled;
+        if (input.event.event === "session-start") {
+            reconciled = reconcileStaleAuthority();
+        }
+        const sessionId = typeof input.event.session_id === "string"
+            ? input.event.session_id
+            : undefined;
+        const bridge = new HerdrBridge({
+            env,
+            sessionId,
+            ...input.bridgeOptions,
+        });
+        const outcome = await bridge.reportHookEvent(input.event, {
+            metadata: buildDisplayMetadata(input.event),
+        });
+        return {
+            wired: true,
+            reason: outcome.reason,
+            reconciledStaleAuthority: reconciled,
+            state: outcome.state,
+            released: outcome.released,
+        };
+    }
+    catch (error) {
+        // Failure isolation at the wiring boundary.
+        return {
+            wired: false,
+            reason: `herdr wiring threw: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/** Small, display-only metadata derived from the event (bounded/redacted downstream). */
+function buildDisplayMetadata(event) {
+    const tokens = {};
+    if (typeof event.mode === "string" && event.mode.length > 0) {
+        tokens.omx_mode = event.mode;
+    }
+    const phase = event.context?.phase;
+    if (typeof phase === "string" && phase.length > 0) {
+        tokens.phase = phase;
+    }
+    return Object.keys(tokens).length > 0 ? tokens : undefined;
+}
+//# sourceMappingURL=wiring.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wiring.js","sourceRoot":"","sources":["../../../src/adapt/herdr/wiring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiBhD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC9C,KAAuB;IAEvB,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,EAAE,GAAG,IAAI,cAAc,EAAE,CAAC;IACzD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,CAAC;QACJ,qEAAqE;QACrE,gDAAgD;QAChD,IAAI,UAA+B,CAAC;QACpC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;YAC3C,UAAU,GAAG,uBAAuB,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,SAAS,GACd,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,KAAK,QAAQ;YACzC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU;YACxB,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;YAC9B,GAAG;YACH,SAAS;YACT,GAAG,KAAK,CAAC,aAAa;SACtB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE;YACzD,QAAQ,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC;SAC3C,CAAC,CAAC;QACH,OAAO;YACN,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,wBAAwB,EAAE,UAAU;YACpC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC1B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,4CAA4C;QAC5C,OAAO;YACN,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACvF,CAAC;IACH,CAAC;AACF,CAAC;AAED,yFAAyF;AACzF,SAAS,oBAAoB,CAC5B,KAAwB;IAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC"}

package/dist/adapt/herdr.d.ts

@@ -0,0 +1,19 @@
+import type { AdaptBootstrapMetadata, AdaptCapabilityReport, AdaptEnvelope, AdaptProbeReport, AdaptRuntimeObservation, AdaptStatusReport } from "./contracts.js";
+import { type HerdrEnv } from "./herdr/transport.js";
+export interface HerdrEvidence {
+    env: HerdrEnv;
+    transport: "socket" | "cli" | "none";
+}
+/**
+ * Herdr evidence is environment-based: OMX only bridges to Herdr when it is
+ * running inside a Herdr-managed pane (HERDR_ENV=1 + HERDR_PANE_ID). Socket
+ * transport is preferred when HERDR_SOCKET_PATH is exported.
+ */
+export declare function collectHerdrEvidence(env?: NodeJS.ProcessEnv): HerdrEvidence;
+export declare function buildHerdrCapabilityOverrides(capabilities: AdaptCapabilityReport[], evidence: HerdrEvidence): AdaptCapabilityReport[];
+export declare function buildHerdrRuntimeObservation(evidence: HerdrEvidence): AdaptRuntimeObservation;
+export declare function buildHerdrBootstrapMetadata(): AdaptBootstrapMetadata;
+export declare function applyHerdrEnvelope(envelope: AdaptEnvelope, evidence: HerdrEvidence): AdaptEnvelope;
+export declare function applyHerdrProbe(report: AdaptProbeReport, evidence: HerdrEvidence): AdaptProbeReport;
+export declare function applyHerdrStatus(report: AdaptStatusReport, evidence: HerdrEvidence): AdaptStatusReport;
+//# sourceMappingURL=herdr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"herdr.d.ts","sourceRoot":"","sources":["../../src/adapt/herdr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,QAAQ,CAAC;IACd,SAAS,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,aAAa,CAQf;AAED,wBAAgB,6BAA6B,CAC5C,YAAY,EAAE,qBAAqB,EAAE,EACrC,QAAQ,EAAE,aAAa,GACrB,qBAAqB,EAAE,CAsBzB;AAED,wBAAgB,4BAA4B,CAC3C,QAAQ,EAAE,aAAa,GACrB,uBAAuB,CAwBzB;AAED,wBAAgB,2BAA2B,IAAI,sBAAsB,CAmBpE;AAED,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,GACrB,aAAa,CAOf;AAED,wBAAgB,eAAe,CAC9B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,aAAa,GACrB,gBAAgB,CAalB;AAED,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,aAAa,GACrB,iBAAiB,CAUnB"}

package/dist/adapt/herdr.js

@@ -0,0 +1,115 @@
+import { detectHerdrEnv } from "./herdr/transport.js";
+/**
+ * Herdr evidence is environment-based: OMX only bridges to Herdr when it is
+ * running inside a Herdr-managed pane (HERDR_ENV=1 + HERDR_PANE_ID). Socket
+ * transport is preferred when HERDR_SOCKET_PATH is exported.
+ */
+export function collectHerdrEvidence(env = process.env) {
+    const detected = detectHerdrEnv(env);
+    const transport = !detected.enabled
+        ? "none"
+        : detected.socketPath
+            ? "socket"
+            : "cli";
+    return { env: detected, transport };
+}
+export function buildHerdrCapabilityOverrides(capabilities, evidence) {
+    return capabilities.map((capability) => {
+        if (capability.id === "herdr-env-detection") {
+            return {
+                ...capability,
+                status: evidence.env.enabled ? "ready" : "stub",
+                summary: evidence.env.enabled
+                    ? `Herdr pane detected (pane ${evidence.env.paneId}); ${evidence.transport} transport selected.`
+                    : "Herdr pane environment (HERDR_ENV=1 + HERDR_PANE_ID) is not present; the bridge stays inert.",
+            };
+        }
+        if (capability.id === "lifecycle-status-bridge") {
+            return {
+                ...capability,
+                status: evidence.env.enabled ? "ready" : "stub",
+                summary: evidence.env.enabled
+                    ? "OMX lifecycle/team state can be reported as Herdr semantic state with monotonic seq ordering and authority release."
+                    : "Lifecycle/status bridge is available but idle until OMX runs inside a Herdr pane.",
+            };
+        }
+        return capability;
+    });
+}
+export function buildHerdrRuntimeObservation(evidence) {
+    if (!evidence.env.enabled) {
+        return {
+            state: "not-detected",
+            detail: "OMX is not running inside a Herdr pane; set HERDR_ENV=1 and HERDR_PANE_ID (Herdr exports these automatically) to enable the bridge.",
+            evidence: {
+                herdrEnv: false,
+                paneId: evidence.env.paneId,
+                socketPath: evidence.env.socketPath,
+            },
+        };
+    }
+    return {
+        state: "detected",
+        detail: `Herdr pane ${evidence.env.paneId} detected; ${evidence.transport} transport will be used for best-effort, non-blocking reports.`,
+        evidence: {
+            herdrEnv: true,
+            paneId: evidence.env.paneId,
+            socketPath: evidence.env.socketPath,
+            binPath: evidence.env.binPath,
+            transport: evidence.transport,
+        },
+    };
+}
+export function buildHerdrBootstrapMetadata() {
+    return {
+        summary: "Herdr bootstrap maps OMX lifecycle/team state into Herdr semantic states (working/blocked/idle/unknown) via the documented pane.report_agent / pane.release_agent surfaces. Phase 2 runtime backend is out of scope.",
+        eventBridge: [
+            "session-start / run.heartbeat / worker.assigned -> working",
+            "blocked / run.blocked_on_user / needs-input -> blocked",
+            "turn-complete / finished / failed / session-end -> idle (+ release authority)",
+            "unmapped/uncertain -> unknown",
+        ],
+        commands: [
+            'herdr pane report-agent "$HERDR_PANE_ID" --source omx:runtime --agent codex --state working --seq <n>',
+            'herdr pane release-agent "$HERDR_PANE_ID" --source omx:runtime --seq <n>',
+        ],
+        nextSteps: [
+            "Run OMX inside a Herdr pane; the bridge is opt-in and inert otherwise.",
+            "A Herdr socket/CLI failure never fails the OMX run (best-effort, non-blocking).",
+        ],
+    };
+}
+export function applyHerdrEnvelope(envelope, evidence) {
+    return {
+        ...envelope,
+        capabilities: buildHerdrCapabilityOverrides(envelope.capabilities, evidence),
+        targetRuntime: buildHerdrRuntimeObservation(evidence),
+        bootstrap: buildHerdrBootstrapMetadata(),
+    };
+}
+export function applyHerdrProbe(report, evidence) {
+    return {
+        ...report,
+        summary: evidence.env.enabled
+            ? "Herdr probe detected a live Herdr pane; the opt-in lifecycle/status bridge is ready."
+            : "Herdr probe found no Herdr pane; the bridge stays inert until OMX runs inside Herdr.",
+        capabilities: buildHerdrCapabilityOverrides(report.capabilities, evidence),
+        targetRuntime: buildHerdrRuntimeObservation(evidence),
+        nextSteps: [
+            "Run omx adapt herdr init --write to materialize OMX-owned adapter artifacts.",
+            "Launch OMX inside a Herdr pane to activate the opt-in bridge.",
+        ],
+    };
+}
+export function applyHerdrStatus(report, evidence) {
+    const targetRuntime = buildHerdrRuntimeObservation(evidence);
+    return {
+        ...report,
+        summary: evidence.env.enabled
+            ? "Herdr adapter is active inside a detected Herdr pane."
+            : "Herdr adapter is available but inert; no Herdr pane is currently detected.",
+        capabilities: buildHerdrCapabilityOverrides(report.capabilities, evidence),
+        targetRuntime,
+    };
+}
+//# sourceMappingURL=herdr.js.map

package/dist/adapt/herdr.js.map

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

package/dist/adapt/index.d.ts

@@ -11,4 +11,8 @@ export declare function buildAdaptDoctorReport(cwd: string, target: AdaptTarget,
 export declare function buildAdaptDoctorReportForTarget(cwd: string, target: AdaptTarget, now?: Date): Promise<AdaptDoctorReport>;
 export declare function initAdaptFoundation(cwd: string, target: AdaptTarget, write?: boolean, now?: Date): AdaptInitResult;
 export declare function initAdaptFoundationForTarget(cwd: string, target: AdaptTarget, write?: boolean, now?: Date): Promise<AdaptInitResult>;
+export { HerdrBridge, createHerdrBridge, HERDR_BRIDGE_SOURCE, HERDR_BRIDGE_AGENT, type HerdrBridgeOptions, type HerdrBridgeOutcome, } from "./herdr/bridge.js";
+export { reportHerdrLifecycleEvent, type HerdrWiringInput, type HerdrWiringResult, } from "./herdr/wiring.js";
+export { mapTeamStateToRollup, type TeamStateInput, type TeamWorkerStateInput, } from "./herdr/team-map.js";
+export { detectHerdrEnv, type HerdrEnv, } from "./herdr/transport.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapt/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapt/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAGN,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,gBAAgB,CAAC;AA6BxB,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAuBrE;AAED,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,aAAa,CAwBf;AAED,wBAAsB,2BAA2B,CAChD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,gBAAgB,CAoClB;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,iBAAiB,CA2CnB;AAED,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,iBAAiB,CAAC,CAO5B;AAED,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,iBAAiB,CAmDnB;AAED,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,iBAAiB,CAAC,CA4C5B;AAED,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,KAAK,UAAQ,EACb,GAAG,OAAa,GACd,eAAe,CAmEjB;AAED,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,KAAK,UAAQ,EACb,GAAG,OAAa,GACd,OAAO,CAAC,eAAe,CAAC,CAoB1B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapt/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAGN,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,gBAAgB,CAAC;AAqCxB,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAuBrE;AAED,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,aAAa,CAwBf;AAED,wBAAsB,2BAA2B,CAChD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,aAAa,CAAC,CAUxB;AAED,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,gBAAgB,CAoClB;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,gBAAgB,CAAC,CAU3B;AAED,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,iBAAiB,CA2CnB;AAED,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,iBAAiB,CAmDnB;AAED,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,GAAG,OAAa,GACd,OAAO,CAAC,iBAAiB,CAAC,CAkE5B;AAED,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,KAAK,UAAQ,EACb,GAAG,OAAa,GACd,eAAe,CAmEjB;AAED,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,KAAK,UAAQ,EACb,GAAG,OAAa,GACd,OAAO,CAAC,eAAe,CAAC,CAsC1B;AAGD,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,cAAc,EACd,KAAK,QAAQ,GACb,MAAM,sBAAsB,CAAC"}

package/dist/adapt/index.js

@@ -3,6 +3,7 @@ import { join } from "node:path";
 import { readLatestPlanningArtifacts } from "../planning/artifacts.js";
 import { ADAPT_SCHEMA_VERSION, } from "./contracts.js";
 import { applyHermesEnvelope, applyHermesProbe, applyHermesStatus, buildHermesBootstrapMetadata, buildHermesRuntimeObservation, collectHermesEvidence, } from "./hermes.js";
+import { applyHerdrEnvelope, applyHerdrProbe, applyHerdrStatus, buildHerdrBootstrapMetadata, buildHerdrRuntimeObservation, collectHerdrEvidence, } from "./herdr.js";
 import { buildOpenClawDoctorReport, buildOpenClawEnvelope, buildOpenClawProbeReport, buildOpenClawStatusReport, initOpenClawFoundation, } from "./openclaw.js";
 import { resolveAdaptPaths } from "./paths.js";
 import { getAdaptTargetDescriptor, listAdaptTargets } from "./registry.js";
@@ -61,6 +62,9 @@ export function buildAdaptEnvelope(cwd, target, now = new Date()) {
 }
 export async function buildAdaptEnvelopeForTarget(cwd, target, now = new Date()) {
     const envelope = buildAdaptEnvelope(cwd, target, now);
+    if (target === "herdr") {
+        return applyHerdrEnvelope(envelope, collectHerdrEvidence());
+    }
     if (target !== "hermes") {
         return envelope;
     }
@@ -97,6 +101,9 @@ export function buildAdaptProbeReport(cwd, target, now = new Date()) {
 }
 export async function buildAdaptProbeReportForTarget(cwd, target, now = new Date()) {
     const report = buildAdaptProbeReport(cwd, target, now);
+    if (target === "herdr") {
+        return applyHerdrProbe(report, collectHerdrEvidence());
+    }
     if (target !== "hermes") {
         return report;
     }
@@ -139,6 +146,9 @@ export function buildAdaptStatusReport(cwd, target, now = new Date()) {
 }
 export async function buildAdaptStatusReportForTarget(cwd, target, now = new Date()) {
     const report = buildAdaptStatusReport(cwd, target, now);
+    if (target === "herdr") {
+        return applyHerdrStatus(report, collectHerdrEvidence());
+    }
     if (target !== "hermes") {
         return report;
     }
@@ -187,6 +197,24 @@ export function buildAdaptDoctorReport(cwd, target, now = new Date()) {
 }
 export async function buildAdaptDoctorReportForTarget(cwd, target, now = new Date()) {
     const report = buildAdaptDoctorReport(cwd, target, now);
+    if (target === "herdr") {
+        const evidence = collectHerdrEvidence();
+        const runtime = buildHerdrRuntimeObservation(evidence);
+        const bootstrap = buildHerdrBootstrapMetadata();
+        const issues = report.issues.filter((issue) => issue.code !== "target_specific_logic_deferred");
+        if (!evidence.env.enabled) {
+            issues.push({
+                code: "herdr_pane_not_detected",
+                message: "No Herdr pane detected (HERDR_ENV=1 + HERDR_PANE_ID absent); the opt-in bridge is inert.",
+            });
+        }
+        return {
+            ...report,
+            summary: "Herdr doctor reports Herdr pane detection plus OMX-owned adapter readiness; the bridge is opt-in and best-effort.",
+            issues,
+            nextSteps: [...bootstrap.nextSteps, `Herdr runtime: ${runtime.detail}`],
+        };
+    }
     if (target !== "hermes") {
         return report;
     }
@@ -273,6 +301,20 @@ export function initAdaptFoundation(cwd, target, write = false, now = new Date()
 }
 export async function initAdaptFoundationForTarget(cwd, target, write = false, now = new Date()) {
     const result = initAdaptFoundation(cwd, target, write, now);
+    if (target === "herdr") {
+        const evidence = collectHerdrEvidence();
+        const envelope = applyHerdrEnvelope(result.envelope, evidence);
+        if (write) {
+            writeFileSync(envelope.adapterPaths.envelopePath, `${JSON.stringify(envelope, null, 2)}\n`, "utf-8");
+        }
+        return {
+            ...result,
+            envelope,
+            summary: write
+                ? "Herdr adapter metadata was written under OMX-owned paths with Herdr pane detection evidence."
+                : "Herdr adapter metadata preview includes Herdr pane detection evidence; rerun with --write to materialize it.",
+        };
+    }
     if (target !== "hermes") {
         return result;
     }
@@ -290,4 +332,10 @@ export async function initAdaptFoundationForTarget(cwd, target, write = false, n
             : "Hermes adapter metadata preview includes external ACP/gateway/session-store evidence; rerun with --write to materialize it.",
     };
 }
+// Herdr lifecycle/status bridge (issue #3241, Phase 1) — reusable runtime bridge
+// plus the production wiring entry point invoked from the hook dispatcher.
+export { HerdrBridge, createHerdrBridge, HERDR_BRIDGE_SOURCE, HERDR_BRIDGE_AGENT, } from "./herdr/bridge.js";
+export { reportHerdrLifecycleEvent, } from "./herdr/wiring.js";
+export { mapTeamStateToRollup, } from "./herdr/team-map.js";
+export { detectHerdrEnv, } from "./herdr/transport.js";
 //# sourceMappingURL=index.js.map