harnery 0.40.0 → 0.42.0

package/dist/core/adapters/registry.js

@@ -1,6 +1,7 @@
 import { buildClaudeInvocation, claudeCodeSpawner, normalizeClaudeResult, } from "../workflow/spawn-claude.js";
 import { buildCodexInvocation, codexSpawner, normalizeCodexResult, } from "../workflow/spawn-codex.js";
 import { buildCursorInvocation, cursorSpawner, normalizeCursorResult, } from "../workflow/spawn-cursor.js";
+import { buildOpenCodeInvocation, normalizeOpenCodeResult, openCodeSpawner, } from "../workflow/spawn-opencode.js";
 import { BUILTIN_ADAPTER_IDS, BUILTIN_ADAPTER_PROFILES, } from "./profiles.js";
 const BUILTIN_ADAPTERS = {
     "claude-code": {
@@ -67,6 +68,38 @@ const BUILTIN_ADAPTERS = {
             },
         },
     },
+    opencode: {
+        profile: BUILTIN_ADAPTER_PROFILES.opencode,
+        spawn: openCodeSpawner,
+        buildInvocation: buildOpenCodeInvocation,
+        normalizeResult: normalizeOpenCodeResult,
+        fixture: {
+            // `opencode run --format json` streams NDJSON: a step-start line then one
+            // or more text parts, each carrying the same sessionID.
+            raw: {
+                stdout: [
+                    JSON.stringify({
+                        type: "step_start",
+                        sessionID: "opencode-bench-session",
+                        part: { type: "step-start" },
+                    }),
+                    JSON.stringify({
+                        type: "text",
+                        sessionID: "opencode-bench-session",
+                        part: { type: "text", text: "HARNERY_BENCH_OK" },
+                    }),
+                ].join("\n"),
+                stderr: "",
+                exitCode: 0,
+                durationMs: 11,
+            },
+            expected: {
+                ok: true,
+                text: "HARNERY_BENCH_OK",
+                sessionId: "opencode-bench-session",
+            },
+        },
+    },
 };
 /** Mutable registry for embedders, initialized empty unless adapters are
  * provided. Duplicate ids fail loud instead of silently replacing behavior. */

package/dist/core/adapters/types.d.ts

@@ -42,6 +42,15 @@ export interface AdapterProfile {
     /** How this adapter projects host filesystem policy into the vendor's own
      * sandbox (ADR 0039). Absent means it cannot project any of it. */
     sandboxProjection?: AdapterSandboxProjection;
+    /** Vendor-native arguments that launch a worker with no vendor sandbox
+     * (ADR 0192). Absent means the adapter has no distinguishable full-access
+     * mode, so a worker on it never qualifies for one. */
+    fullAccess?: AdapterFullAccessRendering;
+}
+/** How an adapter renders an unsandboxed launch (ADR 0192). The spawner emits
+ * exactly these arguments, so the declaration and the argv cannot drift. */
+export interface AdapterFullAccessRendering {
+    argv: readonly string[];
 }
 /** Fully planned child invocation. `resultFile` is used by adapters such as
  * Codex that deliver the authoritative final answer out-of-band. */

package/dist/core/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE/E;uDACuD;AACvD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAEpF,eAAO,MAAM,6BAA6B,2TAoBhC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,iBAAiB,CAAC;IAC3B;iFAC6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC;AAEtF;;;0DAG0D;AAC1D,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC,WAAW,GAAG,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9D,iEAAiE;IACjE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACxC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,mBAAmB,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C;uEACmE;IACnE,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC9C;AAED;oEACoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;0BAGsB;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;kFAG8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;wDAEwD;AACxD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACnF,eAAe,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,WAAW,CAAC;IACxD,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/types.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/canonical-emit.d.ts

@@ -9,7 +9,7 @@
  * a 15-second safety budget; loaded-host checks normally finish in a few
  * seconds and record the observation before the parent command exits.
  */
-import type { EventAdapterIdV3 } from "../events/v3/adapter-id.js";
+import { type EventAdapterIdV3 } from "../events/v3/adapter-id.js";
 import type { LiveCoordinationObservationV3 } from "../events/v3/live-observation.js";
 import type { Heartbeat } from "./state/heartbeat-reader.js";
 export type EventV3EmitObservation = LiveCoordinationObservationV3 | {

package/dist/core/agents/canonical-emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B;IACE,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAK/E;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,mBAAmB,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR"}
+{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,KAAK,gBAAgB,EAAgC,MAAM,4BAA4B,CAAC;AACjG,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC9B,6BAA6B,GAC7B;IACE,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,sBAAsB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CA4C5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAE/E;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,mBAAmB,GAAG,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3E,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR"}

package/dist/core/agents/canonical-emit.js

@@ -10,6 +10,7 @@
  * seconds and record the observation before the parent command exits.
  */
 import { spawnSync } from "node:child_process";
+import { eventAdapterIdV3FromPlatform } from "../events/v3/adapter-id.js";
 import { coordBinPath } from "./coord-bin.js";
 import { resolveCoordRoot } from "./coord-client.js";
 /**
@@ -74,13 +75,7 @@ export function emitEventV3(input) {
  * Normalize the heartbeat's `platform` field to the canonical Adapter type.
  */
 export function normalizeAdapter(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    if (platform === "openclaw")
-        return "openclaw";
-    return "claude-code";
+    return eventAdapterIdV3FromPlatform(platform, { context: "canonical-emit" });
 }
 /** Producer joins use the private native session ID, never its V3 fingerprint. */
 export function nativeSessionIdentity(row, fallback) {

package/dist/core/agents/cli.js

@@ -12,6 +12,8 @@ import { appendFile, mkdir } from "node:fs/promises";
 import { hostname } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { coordEnv } from "../../lib/env.js";
+import { normalizeAdapter, adapterFromPlatform as sharedAdapterFromPlatform } from "../adapter.js";
+import { resolveBinName } from "../config.js";
 import { closeProcessLoggers, legacyLogFields, processLogger } from "../storage/logger.js";
 import { acquireNoClobberLease } from "../workflow/workspaces/leases.js";
 function sharedDiagnostic(root, event, fields, error) {
@@ -152,13 +154,6 @@ async function handleProject(root, rest) {
     process.stdout.write(`${JSON.stringify(report, null, rest.includes("--json") ? 2 : 0)}\n`);
     return view.authority_safe ? 0 : 1;
 }
-function adapterFromPlatform(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    return "claude-code";
-}
 const coordinationRetryCell = new Int32Array(new SharedArrayBuffer(4));
 const COORDINATION_RETRY_ATTEMPTS = 240;
 const COORDINATION_RETRY_DELAY_MS = 25;
@@ -256,7 +251,7 @@ async function handleStateAction(root, action, rest) {
                                 coordRoot: root,
                                 owner,
                                 nativeSessionId: before?.session_id ?? owner,
-                                adapter: adapterFromPlatform(before?.platform),
+                                adapter: sharedAdapterFromPlatform(before?.platform, { context: "agent-coord" }),
                                 task,
                             });
                             break;
@@ -283,7 +278,21 @@ async function handleStateAction(root, action, rest) {
                     }
                 }
                 catch (error) {
-                    process.stderr.write(`agent-coord set-task: V3 authority refused (${error instanceof Error ? error.message : String(error)})\n`);
+                    const detail = error instanceof Error ? error.message : String(error);
+                    // A missing heartbeat usually means the session's generation ended
+                    // while its process lived on, so name the reopen command (ADR 0088).
+                    // A still-live generation whose authority the ledger withholds looks
+                    // the same here; name its diagnostics instead, since reopen cannot apply.
+                    const { describeLiveAuthorityBlockV3, liveAuthorityBlockHintV3, liveAuthorityBlockV3 } = await import("./state/live-coordination-view.js");
+                    const block = detail.includes("heartbeat_missing:")
+                        ? liveAuthorityBlockV3(root, owner)
+                        : null;
+                    const hint = block
+                        ? `; ${describeLiveAuthorityBlockV3(block)}; ${liveAuthorityBlockHintV3(resolveBinName(root))}`
+                        : detail.includes("heartbeat_missing:")
+                            ? `; run \`${resolveBinName(root)} agents lifecycle active\` to open a fresh generation for this continuing session`
+                            : "";
+                    process.stderr.write(`agent-coord set-task: V3 authority refused (${detail})${hint}\n`);
                     return 1;
                 }
                 if (!hb) {
@@ -313,7 +322,7 @@ async function handleStateAction(root, action, rest) {
                     coordRoot: root,
                     owner,
                     nativeSessionId: before?.session_id ?? owner,
-                    adapter: adapterFromPlatform(before?.platform),
+                    adapter: sharedAdapterFromPlatform(before?.platform, { context: "agent-coord" }),
                     operation: "released",
                     path,
                     access: "write",
@@ -371,11 +380,11 @@ async function handleStateAction(root, action, rest) {
                         coordRoot: root,
                         owner,
                         nativeSessionId: sessionId ?? owner,
-                        adapter: adapterFromPlatform(adapter),
+                        adapter: sharedAdapterFromPlatform(adapter, { context: "agent-coord" }),
                     });
                 }
                 const { repairLiveCoordinationHeartbeat } = await import("./state/live-coordination-writer.js");
-                hb = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, adapterFromPlatform(adapter), model);
+                hb = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, sharedAdapterFromPlatform(adapter, { context: "agent-coord" }), model);
             }
             catch (error) {
                 process.stderr.write(`agent-coord repair-coordination-cache: V3 route refused (${error instanceof Error ? error.message : String(error)})\n`);
@@ -397,7 +406,7 @@ async function handleStateAction(root, action, rest) {
                 liveCoordinationWriteModeV3(root);
                 const { liveInstanceIdV3 } = await import("../events/v3/live-routing.js");
                 const { repairLiveCoordinationHeartbeat } = await import("./state/live-coordination-writer.js");
-                const heartbeat = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, adapterFromPlatform(adapter));
+                const heartbeat = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, sharedAdapterFromPlatform(adapter, { context: "agent-coord" }));
                 if (!heartbeat) {
                     throw new Error("authoritative coordination cache could not be materialized");
                 }
@@ -408,7 +417,7 @@ async function handleStateAction(root, action, rest) {
                     observed_current_state_digest: coordinationAuthorityStateDigestV3(heartbeat),
                     approval_record_id: approvalRecordId,
                 });
-                const repaired = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, adapterFromPlatform(adapter));
+                const repaired = repairLiveCoordinationHeartbeat(root, owner, sessionId ?? owner, sharedAdapterFromPlatform(adapter, { context: "agent-coord" }));
                 process.stdout.write(`${JSON.stringify({
                     instance_id: owner,
                     receipt,
@@ -777,7 +786,7 @@ async function handleEmitEvent(root, rest) {
     const eventType = args.type;
     const instanceId = args.owner;
     const sessionId = args.session;
-    const adapter = args.adapter;
+    const adapter = normalizeAdapter(args.adapter) ?? undefined;
     const dataJson = args["data-stdin"] === "true" ? await readStdin() : "";
     if (!eventType || !instanceId || !sessionId || !adapter || !dataJson) {
         process.stderr.write("agent-coord emit-event --type <V3_TYPE> --owner <id> --session <id> --adapter <h> --data-stdin\n");
@@ -945,7 +954,7 @@ async function handleGitHook(fallbackRoot, rest) {
                             owner,
                             subject: hit.instance_id,
                             nativeSessionId: hit.session_id ?? owner,
-                            adapter: adapterFromPlatform(hit.platform),
+                            adapter: sharedAdapterFromPlatform(hit.platform, { context: "agent-coord" }),
                             operation: "released",
                             path,
                             access: "write",

package/dist/core/agents/coord-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CA+B7E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAeD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAiED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CxD;AAgCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CAsEA;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB5C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC/C,CAyBA;AAqBD,sFAAsF;AACtF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAuCD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAmB9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE"}
+{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAWhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAI5E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOhF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CA+B7E;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAeD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAiED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CxD;AAgCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,CAAC;CAC5F,CAsEA;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsB5C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAC/C,CAyBA;AAyBD,sFAAsF;AACtF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAuCD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAmB9C;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpE"}

package/dist/core/agents/coord-client.js

@@ -506,6 +506,10 @@ const SESSION_ID_ENV_VARS = [
     "CURSOR_CONVERSATION_ID",
     "CODEX_SESSION_ID",
     "CODEX_THREAD_ID",
+    // OpenCode exports no session id into the tool shell; the Harnery OpenCode
+    // plugin stamps this via shell.hook("create.before") so a coord CLI run as a
+    // Bash tool recovers its identity.
+    "OPENCODE_SESSION_ID",
 ];
 /** Read normalized candidates from the first non-empty adapter session-id env var. */
 /**
@@ -607,9 +611,10 @@ export function resolveSingleActiveOwner(root) {
 }
 function adapterCandidatesFromEnv() {
     const value = process.env.HARNERY_AGENT_COORD_PLATFORM?.trim();
-    if (value === "claude-code" || value === "codex" || value === "cursor")
+    if (value === "claude-code" || value === "codex" || value === "cursor" || value === "opencode") {
         return [value];
-    return ["claude-code", "codex", "cursor"];
+    }
+    return ["claude-code", "codex", "cursor", "opencode"];
 }
 function nativeOwnerForV3Instance(root, instanceId) {
     const activeDir = resolve(root, ".harnery", "active");

package/dist/core/agents/render/session-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAyC,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM1E,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAoB3F,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;+BAC2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAwF7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,IAAI,CAUN;AAkID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBvD;AA0DD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAiDlF;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iBAAW,CAAC"}
+{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAyC,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM1E,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAoB3F,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;+BAC2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAyF7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,IAAI,CAUN;AAkID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBvD;AA0DD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAiDlF;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iBAAW,CAAC"}

package/dist/core/agents/render/session-context.js

@@ -93,6 +93,8 @@ export function renderSessionContext(opts) {
                 bits.push(`missing: ${d.missing.map((m) => m.subcommand).join(", ")}`);
             if (d.orphans.length > 0)
                 bits.push(`orphaned: ${d.orphans.join(", ")}`);
+            if (d.stale.length > 0)
+                bits.push(`outdated: ${d.stale.map((m) => m.subcommand).join(", ")}`);
             return `  - ${d.settingsFile} — ${bits.join("; ")}`;
         });
         messages.push(`Harnery hook wiring is out of date${verPart}: an upgrade changed the hook set but the adapter ` +

package/dist/core/agents/rules/claim-conflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claim-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/claim-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,aAAa,CA4GjF"}
+{"version":3,"file":"claim-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/claim-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,aAAa,CA4GjF"}

package/dist/core/agents/rules/claim-conflict.js

@@ -16,6 +16,7 @@
 import { spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
+import { adapterFromPlatform as sharedAdapterFromPlatform } from "../../adapter.js";
 import { recordLiveClaimChangeV3 } from "../live-authority-v3.js";
 import { readLiveCoordinationRows } from "../state/live-coordination-view.js";
 const FRESHNESS_SECS = 600;
@@ -211,7 +212,7 @@ function acquireClaimThroughLedger(coordRoot, req) {
             coordRoot,
             owner: req.instance_id,
             nativeSessionId: req.session_id ?? owner?.session_id ?? req.instance_id,
-            adapter: adapterFromPlatform(owner?.platform),
+            adapter: sharedAdapterFromPlatform(owner?.platform, { context: "claim-conflict" }),
             operation: "acquired",
             path: req.path,
             access: "write",
@@ -230,7 +231,7 @@ function releaseClaimThroughLedger(coordRoot, subjectInstanceId, relPath, actor)
             owner: actor.instance_id,
             subject: subjectInstanceId,
             nativeSessionId: actor.session_id ?? owner?.session_id ?? actor.instance_id,
-            adapter: adapterFromPlatform(owner?.platform),
+            adapter: sharedAdapterFromPlatform(owner?.platform, { context: "claim-conflict" }),
             operation: "released",
             path: relPath,
             access: "write",
@@ -241,13 +242,6 @@ function releaseClaimThroughLedger(coordRoot, subjectInstanceId, relPath, actor)
         return false;
     }
 }
-function adapterFromPlatform(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    return "claude-code";
-}
 function authorityUnavailable(path, operation) {
     return {
         allow: false,

package/dist/core/agents/rules/commit-conflict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/commit-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAoBH,UAAU,QAAQ;IAChB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;wEACoE;IACpE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,mBAAmB,CAgIhG"}
+{"version":3,"file":"commit-conflict.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/commit-conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAqBH,UAAU,QAAQ;IAChB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;wEACoE;IACpE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,mBAAmB,CAgIhG"}

package/dist/core/agents/rules/commit-conflict.js

@@ -22,6 +22,7 @@
 import { spawnSync } from "node:child_process";
 import { appendFileSync, existsSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
+import { adapterFromPlatform as sharedAdapterFromPlatform } from "../../adapter.js";
 import { coordFreshnessSeconds } from "../../config.js";
 import { resolveOwner } from "../../hooks/resolve/owner.js";
 import { recordLiveClaimChangeV3 } from "../live-authority-v3.js";
@@ -153,7 +154,7 @@ function retainBlockedStagedPaths(coordRoot, instanceId, sessionId, stagedPaths,
                 coordRoot,
                 owner: instanceId,
                 nativeSessionId: self.session_id ?? sessionId,
-                adapter: adapterFromPlatform(self.platform),
+                adapter: sharedAdapterFromPlatform(self.platform, { context: "commit-conflict" }),
                 operation: "acquired",
                 path,
                 access: "write",
@@ -165,13 +166,6 @@ function retainBlockedStagedPaths(coordRoot, instanceId, sessionId, stagedPaths,
         }
     }
 }
-function adapterFromPlatform(platform) {
-    if (platform === "cursor")
-        return "cursor";
-    if (platform === "codex")
-        return "codex";
-    return "claude-code";
-}
 function findOverlap(staged, files, coordRoot, stagedIsGitlink) {
     for (const claimed of files) {
         if (claimed === staged)

package/dist/core/agents/rules/stop-hook.d.ts

@@ -22,6 +22,8 @@ export interface StopHookRequest {
     };
     stop_hook_active?: boolean;
     status_box_present_strict?: boolean;
+    /** Current observation overrides an older failed terminal during remediation. */
+    session_name_observation_unavailable?: boolean;
     bypass?: boolean;
     workflow_child?: boolean;
 }

package/dist/core/agents/rules/stop-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stop-hook.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAM3D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAInE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CA6BvF;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,aAAa,CAiIf"}
+{"version":3,"file":"stop-hook.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/rules/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAM3D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,iFAAiF;IACjF,oCAAoC,CAAC,EAAE,OAAO,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAInE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,aAAa,CA6BvF;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,aAAa,CAiIf"}

package/dist/core/agents/rules/stop-hook.js

@@ -123,7 +123,7 @@ export function evaluateStopHookV3Events(coordRoot, req, events) {
         pending.push(rule33Block(coordRoot, req.session_id));
     // Claude Code can prove session-name presentation from assistant-only text.
     // Cursor cannot expose that text and Codex returned observe-only above.
-    if (req.adapter !== "cursor") {
+    if (req.adapter !== "cursor" && !req.session_name_observation_unavailable) {
         const naming = turnTerminals
             .map((event) => observedNaming(event.payload.ritual?.session_name))
             .filter((value) => value !== undefined);

package/dist/core/agents/session-events.d.ts

@@ -21,9 +21,13 @@ export declare function newCmdId(): string;
  * Path: `.harnery/.last-intent.<instance_id>` next to the agent's heartbeat.
  */
 export declare function readLastIntent(instanceId?: string): string | null;
+/** Count the non-empty lines in one output chunk; a single event may carry many. */
+export declare function countOutputLines(text: string): number;
 /**
- * Record a command event in V3. Best-effort, never throws into the caller;
- * telemetry must not break or slow a command.
+ * Start/completion use the durable V3 recorder. Output only updates bounded
+ * per-stream counters and hashes; summaries flush before completion or at
+ * process exit. A forced kill can lose unflushed summaries (ADR 0188).
+ * Best-effort: telemetry never throws into the caller.
  */
 export declare function writeSessionEvent(type: SessionEventType, fields?: Record<string, unknown>): void;
 /** Trim long values to keep individual events small. */

package/dist/core/agents/session-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-events.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,yBAAyB,GAAG,mBAAmB,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AAsID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,IAAI,CAEN;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"session-events.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,yBAAyB,GAAG,mBAAmB,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AA4GD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAgED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,IAAI,CAkDN;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAGxD"}

package/dist/core/agents/session-events.js

@@ -3,7 +3,7 @@
  *
  * `writeSessionEvent` records command spans in the canonical V3 ledger.
  */
-import { randomBytes } from "node:crypto";
+import { createHash, randomBytes } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 // Kept dependency-light: vendored verbatim into a downstream consumer, so no coordEnv import.
@@ -55,19 +55,30 @@ export function readLastIntent(instanceId) {
         return null;
     }
 }
-const outputSequence = new Map();
+const pendingCommands = new Map();
+let exitFlushInstalled = false;
+function commandKey(fields) {
+    return typeof fields.instance_id === "string" && typeof fields.cmd_id === "string"
+        ? JSON.stringify([fields.instance_id, fields.cmd_id])
+        : undefined;
+}
+function flushCommandOutput(command) {
+    for (const summary of command.streams.values()) {
+        recordCommandObservation("command.output_observed", command.fields, command.coordRoot, summary);
+    }
+    command.streams.clear();
+}
 /** Emit a command/narration event to the canonical stream. Swallows every
  * error and skips when identity can't be resolved: telemetry must never break
  * or slow down a command. */
-function recordCommandObservation(type, fields) {
+function recordCommandObservation(type, fields, coordRoot, summary) {
     const instanceId = typeof fields.instance_id === "string" ? fields.instance_id : undefined;
     if (!instanceId)
-        return;
+        return false;
     try {
-        const coordRoot = coordinationRootPath();
         const route = resolveLiveEventLedgerRouteV3(coordRoot);
         if (route.state === "blocked")
-            return;
+            return false;
         const liveInstanceId = liveInstanceIdV3(instanceId);
         const hook = readHookProducerStateByInstanceV3(coordRoot, liveInstanceId);
         if (!hook) {
@@ -76,11 +87,11 @@ function recordCommandObservation(type, fields) {
                 instance_id: instanceId,
                 reason: "hook_generation_not_found",
             });
-            return;
+            return false;
         }
-        const command = commandSignalAndObservation(type, fields);
+        const command = commandSignalAndObservation(type, fields, summary);
         if (!command)
-            return;
+            return false;
         const result = recordCommandSignalV3({
             coordRoot,
             mode: route.mode,
@@ -98,7 +109,7 @@ function recordCommandObservation(type, fields) {
             const expectedLifecycleReopenGap = result.reason === "turn_not_started" &&
                 hook.session_start_derivation === "approved_lifecycle_reopen";
             if (expectedLifecycleReopenGap)
-                return;
+                return false;
             writeProducerDiagnosticV3(coordRoot, "command_emit_unjoinable", {
                 type,
                 instance_id: instanceId,
@@ -114,11 +125,11 @@ function recordCommandObservation(type, fields) {
                 result_state: result.state,
             });
         }
+        return result.state === "recorded" || result.state === "already_recorded";
     }
     catch (error) {
         // Telemetry must never break the command, but the loss is preserved.
         try {
-            const coordRoot = coordinationRootPath();
             writeProducerDiagnosticV3(coordRoot, "command_emit_failed", {
                 type,
                 instance_id: instanceId,
@@ -128,14 +139,24 @@ function recordCommandObservation(type, fields) {
         catch {
             /* diagnostics are best-effort */
         }
+        return false;
     }
 }
-function commandSignalAndObservation(type, fields) {
+/** Count the non-empty lines in one output chunk; a single event may carry many. */
+export function countOutputLines(text) {
+    if (!text)
+        return 0;
+    let count = 0;
+    for (const line of text.split("\n"))
+        if (line.length > 0)
+            count += 1;
+    return count;
+}
+function commandSignalAndObservation(type, fields, summary) {
     const commandId = typeof fields.cmd_id === "string" ? fields.cmd_id : undefined;
     if (!commandId)
         return undefined;
     if (type === "command.started") {
-        outputSequence.set(commandId, 0);
         const command = typeof fields.cmd === "string" ? fields.cmd : "";
         const executable = command.trim().split(/\s+/, 1)[0] || "unknown";
         return {
@@ -154,23 +175,26 @@ function commandSignalAndObservation(type, fields) {
         };
     }
     if (type === "command.output_observed") {
-        const sequence = (outputSequence.get(commandId) ?? 0) + 1;
-        outputSequence.set(commandId, sequence);
-        const line = typeof fields.line === "string" ? fields.line : "";
-        const stream = fields.stream === "stdout" || fields.stream === "stderr" ? fields.stream : "combined";
+        if (!summary)
+            return undefined;
         return {
             signal: "command.output_observed",
             observation: {
                 native_command_id: commandId,
-                native_observation_id: `${commandId}:output:${sequence}`,
-                stream,
-                output: line,
-                output_bytes: Buffer.byteLength(line, "utf8"),
-                output_lines: line ? 1 : 0,
+                native_observation_id: `${commandId}:output-summary:${summary.stream}`,
+                stream: summary.stream,
+                // The normalizer HMACs this bounded descriptor with the generation key.
+                // Neither raw output nor its unkeyed digest is written to the ledger.
+                output: {
+                    format: "harnery-output-chunks-v1",
+                    chunks: summary.chunks,
+                    sha256: summary.hash.digest("hex"),
+                },
+                output_bytes: summary.bytes,
+                output_lines: summary.lines,
             },
         };
     }
-    outputSequence.delete(commandId);
     const exitCode = typeof fields.exit === "number" && Number.isSafeInteger(fields.exit) ? fields.exit : undefined;
     return {
         signal: "command.completed",
@@ -186,11 +210,66 @@ function commandSignalAndObservation(type, fields) {
     };
 }
 /**
- * Record a command event in V3. Best-effort, never throws into the caller;
- * telemetry must not break or slow a command.
+ * Start/completion use the durable V3 recorder. Output only updates bounded
+ * per-stream counters and hashes; summaries flush before completion or at
+ * process exit. A forced kill can lose unflushed summaries (ADR 0188).
+ * Best-effort: telemetry never throws into the caller.
  */
 export function writeSessionEvent(type, fields = {}) {
-    recordCommandObservation(type, fields);
+    try {
+        const key = commandKey(fields);
+        if (!key)
+            return;
+        if (type === "command.output_observed") {
+            const command = pendingCommands.get(key);
+            if (!command)
+                return;
+            const stream = fields.stream === "stdout" || fields.stream === "stderr" ? fields.stream : "combined";
+            let summary = command.streams.get(stream);
+            if (!summary) {
+                summary = { stream, bytes: 0, lines: 0, chunks: 0, hash: createHash("sha256") };
+                command.streams.set(stream, summary);
+            }
+            const line = typeof fields.line === "string" ? fields.line : "";
+            const normalized = line.normalize("NFC");
+            // Length framing preserves chunk boundaries, including empty chunks.
+            summary.hash.update(`${Buffer.byteLength(normalized, "utf8")}:`).update(normalized);
+            summary.bytes += Buffer.byteLength(line, "utf8");
+            summary.lines += countOutputLines(line);
+            summary.chunks += 1;
+            return;
+        }
+        const command = pendingCommands.get(key);
+        const coordRoot = command?.coordRoot ?? coordinationRootPath();
+        if (type === "command.completed") {
+            pendingCommands.delete(key);
+            if (command)
+                flushCommandOutput(command);
+            recordCommandObservation(type, fields, coordRoot);
+        }
+        else if (recordCommandObservation(type, fields, coordRoot) && !command) {
+            pendingCommands.set(key, {
+                coordRoot,
+                fields: {
+                    instance_id: fields.instance_id,
+                    cmd_id: fields.cmd_id,
+                    bridge: fields.bridge,
+                },
+                streams: new Map(),
+            });
+            if (!exitFlushInstalled) {
+                exitFlushInstalled = true;
+                process.once("exit", () => {
+                    for (const pending of pendingCommands.values())
+                        flushCommandOutput(pending);
+                    pendingCommands.clear();
+                });
+            }
+        }
+    }
+    catch {
+        // Root resolution and in-memory bookkeeping must not break the command.
+    }
 }
 /** Trim long values to keep individual events small. */
 export function clampField(v, max = 1024) {