harnery 0.45.2 → 0.46.0

package/dist/commands/presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA2BnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA8KjF"}
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA6BnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA6NjF"}

package/dist/commands/presence.js

@@ -1,7 +1,9 @@
 import { monorepoRoot } from "../core/agents/coord-client.js";
 import { emitEventV3, nativeSessionIdentity, normalizeAdapter, resolveOwner, } from "../core/agents/index.js";
 import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-view.js";
+import { peerInbox } from "../core/inbox/peer-messages.js";
 import { fetchPresence, publishPresence, readRemoteMachines, relayDaemonStatus, runRelayDaemon, } from "../core/presence/index.js";
+import { importMail, mailStatus, publishMail } from "../core/presence/mail.js";
 import { ageSeconds, applyDetection, clearPresence, formatAge, presenceFilePath, readPresence, writePresence, } from "../lib/presence.js";
 /**
  * `presence`: two related surfaces under one name.
@@ -98,6 +100,44 @@ export function registerPresenceCommand(program, emit) {
         }
         emit.data(r);
     });
+    cmd
+        .command("mail")
+        .description("Show cross-machine peer messages (ADR 0222): this machine's unacknowledged outbox, " +
+        "acknowledgements it is publishing, and delivered/expired counts. --sync fetches, " +
+        "imports, and publishes first (synchronous; errors report).")
+        .option("--sync", "Fetch peers' refs, import mail addressed here, and publish this machine's ref")
+        .option("--json", "JSON output")
+        .action((opts) => {
+        const root = requireRoot(emit);
+        let sync;
+        if (opts.sync) {
+            const fetched = fetchPresence(root, { force: true, sync: true });
+            if (fetched.status === "error") {
+                emit.error({ code: "fetch_failed", message: fetched.error });
+                process.exit(1);
+            }
+            const imported = importMail(root, peerInbox(root), { publish: false });
+            const published = publishMail(root, { sync: true });
+            if (published.status === "error") {
+                emit.error({ code: "publish_failed", message: published.error });
+                process.exit(1);
+            }
+            sync = { imported, published };
+        }
+        const status = mailStatus(root);
+        if (opts.json)
+            emit.config({ format: "json" });
+        if (opts.json || !process.stdout.isTTY) {
+            emit.data({ ...status, ...(sync ? { sync } : {}) });
+            return;
+        }
+        emit.text(`${status.machine}: ${status.outbox.length} waiting for acknowledgement, ` +
+            `${status.acks} acknowledgements published, ${status.delivered} delivered, ` +
+            `${status.expired} expired\n`);
+        for (const m of status.outbox) {
+            emit.text(`  ${m.message_id} to agent-${m.recipient} on ${m.to_machine} (queued ${m.queued_at})\n`);
+        }
+    });
     cmd
         .command("relay-daemon")
         .description("Run the relay client daemon in the foreground (normally spawned detached by the hooks " +

package/dist/commands/qa-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qa-run.d.ts","sourceRoot":"","sources":["../../src/commands/qa-run.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA8B1E,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAqB/C,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAodN"}
+{"version":3,"file":"qa-run.d.ts","sourceRoot":"","sources":["../../src/commands/qa-run.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA+B1E,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAqB/C,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAodN"}

package/dist/commands/qa-run.js

@@ -11,6 +11,7 @@ import { artifactsRoot } from "../core/artifacts/index.js";
 import { resolveBinName, reviewPackAutoCleanEnabled } from "../core/config.js";
 import { createManagedQaOutParent, managedQaReviewGuidance, resolveQaRepoRoot, } from "../core/qa-artifacts.js";
 import { acquireAdmission, admissionBaseDir, admissionStatus } from "../lib/admission.js";
+import { PAGE_REVIEW_MAX_TILE_BUDGET } from "../lib/browser/page-review-contracts.js";
 import { deleteExpiredPacks, PAGE_REVIEW_DEFAULT_RETENTION_MINUTES, } from "../lib/browser/page-review-pack.js";
 import { QA_RUN_JOB_FILENAME, QA_RUN_RESULT_FILENAME, QA_RUN_STATUS_FILENAME, runQaMatrix, } from "../lib/browser/qa-run.js";
 import { QA_RUN_JOB_SCHEMA_VERSION, QA_RUN_STATUS_SCHEMA_VERSION, validateQaRunJob, } from "../lib/browser/qa-run-contracts.js";
@@ -35,7 +36,7 @@ export function registerQaRunCommand(program, emit, context) {
         "always run serially; the judge pool is policy.critique_pool / --pool.")
         .option("--pool <n>", "Vision calls in flight during the judge stage, across every context (1-16; default: " +
         "the provider's own concurrency). Sets policy.critique_pool.")
-        .option("--tile-budget <n>", "Maximum native tiles across the complete review pack (8-400; default 96).")
+        .option("--tile-budget <n>", `Maximum native tiles across the complete review pack (8-${PAGE_REVIEW_MAX_TILE_BUDGET}; default 96).`)
         .option("--accept-dispositions", "Apply fully reviewed prior decisions only to identical findings on identical native tiles.")
         .option("--allow-metered", "Permit the critique provider's metered-API fallback. Default: subscription-backed " +
         "headless harnesses only — exhaustion becomes an incomplete blocker, never a metered call.")
@@ -129,10 +130,10 @@ export function registerQaRunCommand(program, emit, context) {
         const policy = { ...validation.job.policy };
         if (opts.tileBudget !== undefined) {
             const n = Number(opts.tileBudget);
-            if (!Number.isInteger(n) || n < 8 || n > 400) {
+            if (!Number.isInteger(n) || n < 8 || n > PAGE_REVIEW_MAX_TILE_BUDGET) {
                 emit.error({
                     code: "qa_run_invalid_tile_budget",
-                    message: "--tile-budget must be an integer between 8 and 400",
+                    message: `--tile-budget must be an integer between 8 and ${PAGE_REVIEW_MAX_TILE_BUDGET}`,
                 });
                 process.exitCode = 1;
                 return;

package/dist/commands/review-pack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-pack.d.ts","sourceRoot":"","sources":["../../src/commands/review-pack.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAkV1E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAugCN"}
+{"version":3,"file":"review-pack.d.ts","sourceRoot":"","sources":["../../src/commands/review-pack.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAmV1E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CA0iCN"}

package/dist/commands/review-pack.js

@@ -11,7 +11,8 @@ import { readLiveCoordinationRow } from "../core/agents/state/live-coordination-
 import { artifactsRoot } from "../core/artifacts/index.js";
 import { resolveBinName, reviewPackAutoCleanEnabled } from "../core/config.js";
 import { createManagedQaOutParent, resolveQaRepoRoot } from "../core/qa-artifacts.js";
-import { DEFAULT_CRITIQUE_RUBRIC } from "../lib/browser/critique.js";
+import { DEFAULT_CRITIQUE_RUBRIC, formatCritiqueUsage } from "../lib/browser/critique.js";
+import { PAGE_REVIEW_MAX_TILE_BUDGET } from "../lib/browser/page-review-contracts.js";
 import { persistPackReviewDecisions } from "../lib/browser/page-review-evidence.js";
 import { judgePageReviewPack, toCritiqueRecords } from "../lib/browser/page-review-judge.js";
 import { aggregateMachineOutcome, deleteExpiredPacks, expandedTileFilename, finalizePageReviewPack, findPackTile, findPageReviewPacks, isPackDeletable, listPackContexts, machineFindingTargets, PAGE_REVIEW_DEFAULT_RETENTION_MINUTES, PAGE_REVIEW_DISPOSITIONS, PAGE_REVIEW_FINDING_CATEGORIES, PAGE_REVIEW_FINDING_SEVERITIES, PAGE_REVIEW_SUBAGENT_MODELS, PAGE_REVIEW_VERDICT_SCHEMA, packPaths, readPackContext, readPackFindings, readPackInspectionPlan, readPackManifest, readPackVerdict, resolvePackVerdict, validateFindingsDocument, writePackFindings, } from "../lib/browser/page-review-pack.js";
@@ -205,7 +206,9 @@ export function registerReviewPackCommand(program, emit, context) {
         .option("--context <spec>", "Rendering context <viewport>[:<theme>[:<state>]] (repeatable; default desktop and " +
         "mobile in light and dark).", (value, previous = []) => [...previous, value], [])
         .option("--scope <selector>", "Also tile one screenshot per element matching <selector> (repeatable).", (value, previous = []) => [...previous, value], [])
-        .option("--max-tiles <n>", "Native tile cap per context, including required top and bottom bands.")
+        .option("--max-tiles <n>", "Native tile cap per context, including required top and bottom bands (default 24). " +
+        `The whole pack never exceeds ${PAGE_REVIEW_MAX_TILE_BUDGET} tiles, so the cap is ` +
+        "lowered when the contexts would need more.")
         .option("--concurrency <n>", "Concurrent capture browsers (1-8; default 2).", "2")
         .option("--timeout <ms>", "Per-capture timeout in milliseconds (default 120000).", "120000")
         .option("--retain <minutes>", `Minutes the pack lives before the whole directory is deleted (1-43200; default ` +
@@ -231,6 +234,23 @@ export function registerReviewPackCommand(program, emit, context) {
             process.exitCode = 1;
             return;
         }
+        const requestedMaxTiles = Number(opts.maxTiles ?? "24");
+        if (!Number.isInteger(requestedMaxTiles) ||
+            requestedMaxTiles < 1 ||
+            requestedMaxTiles > PAGE_REVIEW_MAX_TILE_BUDGET) {
+            emit.error({
+                code: "review_pack_invalid_max_tiles",
+                message: `--max-tiles must be an integer between 1 and ${PAGE_REVIEW_MAX_TILE_BUDGET}`,
+            });
+            process.exitCode = 1;
+            return;
+        }
+        // The judge refuses a pack above the ceiling, so share it across contexts here.
+        const perContextMaxTiles = Math.max(2, Math.min(requestedMaxTiles, Math.floor(PAGE_REVIEW_MAX_TILE_BUDGET / contexts.length)));
+        if (perContextMaxTiles < requestedMaxTiles) {
+            emit.log(`review-pack: ${contexts.length} contexts share the ${PAGE_REVIEW_MAX_TILE_BUDGET}-tile ceiling; ` +
+                `capping each at ${perContextMaxTiles} tiles`, "warn");
+        }
         const concurrency = Math.max(1, Math.min(8, Number.parseInt(opts.concurrency ?? "2", 10) || 2));
         const timeoutMs = Math.max(1000, Number.parseInt(opts.timeout ?? "120000", 10) || 120_000);
         const repoRoot = resolveQaRepoRoot(context);
@@ -291,7 +311,8 @@ export function registerReviewPackCommand(program, emit, context) {
                     "--qa-state",
                     ctx.state,
                     ...(opts.scope ?? []).flatMap((selector) => ["--review-pack-scope", selector]),
-                    ...(opts.maxTiles !== undefined ? ["--check-critique-max-tiles", opts.maxTiles] : []),
+                    "--check-critique-max-tiles",
+                    String(perContextMaxTiles),
                 ];
                 emit.log(`capture ${ctx.id}`, "info");
                 const res = await defaultQaRunExec(argv, { timeoutMs, env });
@@ -434,8 +455,12 @@ export function registerReviewPackCommand(program, emit, context) {
         else
             process.env[QA_RUN_HEADLESS_ONLY_ENV] = prior;
         const merged = new Map((manifest.critique ?? []).map((row) => [row.context_id, row]));
-        for (const row of toCritiqueRecords(result))
-            merged.set(row.context_id, row);
+        for (const row of toCritiqueRecords(result)) {
+            // Re-judging never changes the captured coverage, so a signoff's
+            // sampled acceptance (ADR 0224) still applies.
+            const prior = merged.get(row.context_id)?.coverage_mode;
+            merged.set(row.context_id, prior ? { ...row, coverage_mode: prior } : row);
+        }
         const judgedRecords = new Map(result.contexts.map((row) => [row.context_id, row.record]));
         finalizePageReviewPack({
             packDir,
@@ -461,7 +486,9 @@ export function registerReviewPackCommand(program, emit, context) {
                 ` · ${high} high / ${row.findings.length - high} other finding(s)` +
                 (row.error ? ` · ${row.error}` : ""), row.outcome === "pass" ? "info" : "warn");
         }
-        emit.log(`judge: ${result.outcome} · pool ${result.pool.concurrency} · ${result.tiles_reviewed} tile(s) in ${result.pool.wall_time_ms}ms · ${packPaths(packDir).review}`, result.outcome === "pass" ? "info" : "warn");
+        emit.log(`judge: ${result.outcome} · pool ${result.pool.concurrency} · ${result.tiles_reviewed} tile(s) in ${result.pool.wall_time_ms}ms` +
+            (result.usage ? ` · ${formatCritiqueUsage(result.usage)}` : "") +
+            ` · ${packPaths(packDir).review}`, result.outcome === "pass" ? "info" : "warn");
         if (opts.json)
             emit.data(result);
         if (result.outcome === "fail")

package/dist/core/agents/index.d.ts

@@ -10,5 +10,6 @@ export * from "./canonical-emit.js";
 export * from "./coord-client.js";
 export * from "./live-observation-v3.js";
 export * from "./session-events.js";
+export { type AgentParentReference, type AgentParentReferenceOptions, type AgentParentSubject, resolveAgentParentReference, } from "./state/parent-reference.js";
 export * from "./state/session-state.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AACrC,cAAc,0BAA0B,CAAC"}

package/dist/core/agents/index.js

@@ -10,4 +10,5 @@ export * from "./canonical-emit.js";
 export * from "./coord-client.js";
 export * from "./live-observation-v3.js";
 export * from "./session-events.js";
+export { resolveAgentParentReference, } from "./state/parent-reference.js";
 export * from "./state/session-state.js";

package/dist/core/agents/live-authority-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-authority-v3.d.ts","sourceRoot":"","sources":["../../../src/core/agents/live-authority-v3.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"live-authority-v3.d.ts","sourceRoot":"","sources":["../../../src/core/agents/live-authority-v3.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/live-authority-v3.js

@@ -6,7 +6,7 @@ import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from
 import { fingerprintContextV3 } from "../events/v3/fingerprint-keys.js";
 import { LIVE_HOOK_V3_PRODUCER_ID, liveInstanceIdV3, livePlatformV3, resolveLiveEventLedgerRouteV3, } from "../events/v3/live-routing.js";
 import { recordCoordinationAuthorityV3, } from "../events/v3/producers/coordination-recorder.js";
-import { listHookProducerStateRecordsV3, readHookProducerStateV3, readTerminalHookProducerStateV3, recordHookSignalV3, } from "../events/v3/producers/recorder.js";
+import { readHookProducerStateV3, readTerminalHookProducerStateV3, recordHookSignalV3, scanHookProducerStateRecordsV3, } from "../events/v3/producers/recorder.js";
 import { canonicalClaimPath } from "./claim-path.js";
 import { acquireClaim, readHeartbeat, releaseClaim, setIdentityCache, setLifecycleCache, setTask, } from "./state/heartbeat-writer.js";
 import { liveCoordinationAdapterV3, readLiveCoordinationRow, } from "./state/live-coordination-view.js";
@@ -139,14 +139,21 @@ function readSessionProducerStatesForBootstrap(coordRoot, nativeSessionId) {
     }
 }
 function readInstanceProducerStatesForBootstrap(coordRoot, instanceId) {
+    let scan;
     try {
-        return listHookProducerStateRecordsV3(coordRoot, { includeTerminal: true })
-            .map((record) => record.state)
-            .filter((state) => state.instance_id === instanceId);
+        scan = scanHookProducerStateRecordsV3(coordRoot, { includeTerminal: true });
     }
     catch {
         throw new LiveCoordinationAuthorityV3Error("producer_state_unsafe");
     }
+    // Another session's invalid file does not block this one; this instance's
+    // own invalid file still fails closed.
+    if (scan.invalid.some((file) => file.instance_id === instanceId)) {
+        throw new LiveCoordinationAuthorityV3Error("producer_state_unsafe");
+    }
+    return scan.records
+        .map((record) => record.state)
+        .filter((state) => state.instance_id === instanceId);
 }
 function terminalGenerationForSession(view, instanceId, sessionId) {
     return Object.values(view.terminal_generations).some((generation) => generation.instance_id === instanceId && generation.session_id === sessionId);

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

@@ -6,7 +6,6 @@
  * Outputs a Claude Code SessionStart hookSpecificOutput.additionalContext
  * string.
  */
-import { statSync } from "node:fs";
 export interface RenderOpts {
     coordRoot: string;
     instanceId: string;
@@ -43,9 +42,4 @@ export declare function checkWiring(coordRoot: string): string[];
  * (or "" when no councils await input).
  */
 export declare function formatPendingCouncils(coordRoot: string, agentName: string): string;
-/**
- * Suppress unused import warning when statSync isn't used in this file
- * (kept exported for future renderers, e.g. heartbeat-freshness coloring).
- */
-export declare const _ensureStatSyncImported: typeof statSync;
 //# sourceMappingURL=session-context.d.ts.map

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;AAyB1E,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;IACvB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA8F7D;AA6LD;;;;;;;;;;;;;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;AA4BH,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;IACvB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA8F7D;AA6LD;;;;;;;;;;;;;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"}

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

@@ -7,7 +7,7 @@
  * string.
  */
 import { spawnSync } from "node:child_process";
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { resolveBinName, resolveHooksSetupHint } from "../../config.js";
 import { harneryVersion, loadAdapterWiring } from "../../hooks/adapter/wiring.js";
@@ -389,8 +389,3 @@ export function formatPendingCouncils(coordRoot, agentName) {
     }
     return `Councils waiting on your input (${pending.length} open): ${list}. Run \`${bin} agents council list --mine\` to see all of them, then \`${bin} agents council show <id>\` for any brief.`;
 }
-/**
- * Suppress unused import warning when statSync isn't used in this file
- * (kept exported for future renderers, e.g. heartbeat-freshness coloring).
- */
-export const _ensureStatSyncImported = statSync;

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;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"}
+{"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;AAyHD,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,CAoDN;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,MAAM,CAGxD"}

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

@@ -62,16 +62,21 @@ function commandKey(fields) {
         ? JSON.stringify([fields.instance_id, fields.cmd_id])
         : undefined;
 }
-function flushCommandOutput(command) {
+/**
+ * `deferDrain` stages each summary durably in the spool without appending it,
+ * for a caller that writes the completion next: that write drains every staged
+ * row under one lease and one witness advance instead of one per row.
+ */
+function flushCommandOutput(command, deferDrain = false) {
     for (const summary of command.streams.values()) {
-        recordCommandObservation("command.output_observed", command.fields, command.coordRoot, summary);
+        recordCommandObservation("command.output_observed", command.fields, command.coordRoot, summary, deferDrain);
     }
     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, coordRoot, summary) {
+function recordCommandObservation(type, fields, coordRoot, summary, deferDrain = false) {
     const instanceId = typeof fields.instance_id === "string" ? fields.instance_id : undefined;
     if (!instanceId)
         return false;
@@ -104,6 +109,7 @@ function recordCommandObservation(type, fields, coordRoot, summary) {
             platform: livePlatformV3(),
             ...(fields.bridge === "codex-wsl" ? { bridge: "codex-wsl" } : {}),
             monotonic_ns: process.hrtime.bigint().toString(),
+            ...(deferDrain ? { writerOptions: { deferDrain: true } } : {}),
         });
         if (result.state === "generation_unavailable") {
             const expectedLifecycleReopenGap = result.reason === "turn_not_started" &&
@@ -243,8 +249,10 @@ export function writeSessionEvent(type, fields = {}) {
         const coordRoot = command?.coordRoot ?? coordinationRootPath();
         if (type === "command.completed") {
             pendingCommands.delete(key);
+            // The completion below drains the staged summaries with itself. If it
+            // never writes, the rows stay durable in the spool for the next drain.
             if (command)
-                flushCommandOutput(command);
+                flushCommandOutput(command, true);
             recordCommandObservation(type, fields, coordRoot);
         }
         else if (recordCommandObservation(type, fields, coordRoot) && !command) {

package/dist/core/agents/state/heartbeat-reader.d.ts

@@ -1,4 +1,5 @@
 /** Read-only access to the generation-bound heartbeat cache. */
+import type { AgentParentReference } from "./parent-reference-contract.js";
 import type { AgentActivity, TaskState } from "./session-state.js";
 export interface Heartbeat {
     schema_version?: number;
@@ -46,6 +47,8 @@ export interface Heartbeat {
     last_status_at?: string;
     current_turn_id?: string;
     parent_instance_id?: string;
+    /** Read-only display/recipient evidence; never a claim or lifecycle authority input. */
+    parent_reference?: AgentParentReference;
     workflow_run_id?: string;
     workflow_agent_id?: string;
     /** Disposable-cache bindings that prove a row belongs to the current V3 generation. */

package/dist/core/agents/state/heartbeat-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-reader.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-reader.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAIhE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C;;;;;OAKG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,cAAc,CAAC,EAAE,QAAQ,MAAM,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,MAAM,EAAE,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU3E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQrF"}
+{"version":3,"file":"heartbeat-reader.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-reader.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAIhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C;;;;;OAKG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,cAAc,CAAC,EAAE,QAAQ,MAAM,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,MAAM,EAAE,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU3E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQrF"}

package/dist/core/agents/state/live-coordination-view.d.ts

@@ -1,5 +1,5 @@
 import { type EventAdapterIdV3 } from "../../events/v3/adapter-id.js";
-import { type CoordinationGenerationViewV3 } from "../../events/v3/coordination-view.js";
+import { type CoordinationGenerationViewV3, type CoordinationViewV3 } from "../../events/v3/coordination-view.js";
 import { type Heartbeat } from "./heartbeat-reader.js";
 /**
  * Heartbeat files are disposable V3 caches. These bindings prevent a stale
@@ -12,6 +12,8 @@ export interface V3HeartbeatMaterialization extends Heartbeat {
     v3_projection_event_id: string;
     v3_task_state: "set" | "cleared";
 }
+/** Index exact generations; a current replacement never erases its terminal predecessor. */
+export declare function indexCoordinationGenerationsV3(view: CoordinationViewV3): ReadonlyMap<string, CoordinationGenerationViewV3>;
 /** Read the live coordination rows through the hard-cut ledger route. */
 export declare function readLiveCoordinationRows(coordRoot: string): V3HeartbeatMaterialization[];
 /** Read one current row from the authority-safe V3 projection. */

package/dist/core/agents/state/live-coordination-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-coordination-view.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/live-coordination-view.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EACL,KAAK,4BAA4B,EAIlC,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,SAAS;IAC3D,cAAc,EAAE,CAAC,CAAC;IAClB,cAAc,EAAE,QAAQ,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,OAAO,MAAM,EAAE,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;CAClC;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,EAAE,CA2BxF;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,0BAA0B,GAAG,IAAI,CAuBnC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,GAAG,IAAI,CAWzB;AA8BD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,EAAE,4BAA4B,GACvC,KAAK,IAAI,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,4BAA4B,EACxC,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,CAAC,EAAE,4BAA4B,GACpC,0BAA0B,CAuD5B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,4BAA4B,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,gBAAgB,CAEhF;AAWD,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC/B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,oBAAoB,GAAG,IAAI,CA2B7B;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAiBhF;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKhE"}
+{"version":3,"file":"live-coordination-view.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/live-coordination-view.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EAGxB,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,uBAAuB,CAAC;AAGtE;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,SAAS;IAC3D,cAAc,EAAE,CAAC,CAAC;IAClB,cAAc,EAAE,QAAQ,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,OAAO,MAAM,EAAE,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC;CAClC;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,kBAAkB,GACvB,WAAW,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAMnD;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,0BAA0B,EAAE,CAyBxF;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,0BAA0B,GAAG,IAAI,CAqBnC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,GAAG,IAAI,CAWzB;AA8BD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,UAAU,EAAE,4BAA4B,GACvC,KAAK,IAAI,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,4BAA4B,EACxC,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,CAAC,EAAE,4BAA4B,GACpC,0BAA0B,CAuD5B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,4BAA4B,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,gBAAgB,CAEhF;AAWD,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC/B,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,oBAAoB,GAAG,IAAI,CA2B7B;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAiBhF;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKhE"}

package/dist/core/agents/state/live-coordination-view.js

@@ -5,6 +5,10 @@ import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from
 import { liveInstanceIdV3, nativeInstanceIdV3, observeLiveEventLedgerRouteV3, } from "../../events/v3/live-route-observer.js";
 import { readHeartbeat } from "./heartbeat-reader.js";
 import { resolveName } from "./names.js";
+/** Index exact generations; a current replacement never erases its terminal predecessor. */
+export function indexCoordinationGenerationsV3(view) {
+    return new Map([...Object.values(view.terminal_generations), ...Object.values(view.instances)].map((generation) => [generation.generation_id, generation]));
+}
 /** Read the live coordination rows through the hard-cut ledger route. */
 export function readLiveCoordinationRows(coordRoot) {
     const route = observeLiveEventLedgerRouteV3(coordRoot);
@@ -18,7 +22,7 @@ export function readLiveCoordinationRows(coordRoot) {
         return [];
     }
     const caches = readV3Caches(coordRoot);
-    const byGeneration = new Map(Object.values(view.instances).map((generation) => [generation.generation_id, generation]));
+    const byGeneration = indexCoordinationGenerationsV3(view);
     return Object.values(view.instances)
         .filter((generation) => generation.authority_eligible)
         .map((generation) => {
@@ -40,7 +44,7 @@ export function readLiveCoordinationRow(coordRoot, nativeInstanceId) {
             return null;
         const cache = readHeartbeat(coordRoot, nativeInstanceId);
         const parent = generation.parent_generation_id
-            ? Object.values(view.instances).find((candidate) => candidate.generation_id === generation.parent_generation_id)
+            ? indexCoordinationGenerationsV3(view).get(generation.parent_generation_id)
             : undefined;
         return projectHeartbeatV3(coordRoot, generation, isCurrentV3HeartbeatCache(cache, generation) ? cache : undefined, nativeInstanceId, parent);
     }

package/dist/core/agents/state/parent-reference-contract.d.ts

@@ -0,0 +1,16 @@
+export type AgentParentReference = {
+    state: "verified";
+    relationship: "delegated-child" | "native-child";
+    parent_instance_id: string;
+    parent_v3_instance_id: string;
+    parent_generation_id: string | null;
+    parent_session_id: string | null;
+    parent_name: string | null;
+    source: "v3-session-link" | "native-session-metadata";
+    source_witness?: string;
+    addressable: boolean;
+} | {
+    state: "none" | "unknown" | "conflict";
+    reason: string;
+};
+//# sourceMappingURL=parent-reference-contract.d.ts.map

package/dist/core/agents/state/parent-reference-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-reference-contract.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/parent-reference-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,iBAAiB,GAAG,cAAc,CAAC;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,iBAAiB,GAAG,yBAAyB,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB,GACD;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/core/agents/state/parent-reference-contract.js

@@ -0,0 +1 @@
+export {};

package/dist/core/agents/state/parent-reference.d.ts

@@ -0,0 +1,18 @@
+import type { CoordinationViewV3 } from "../../events/v3/coordination-view.js";
+import { type NativeParentObservation, type NativeParentRequest } from "../../hooks/adapter/native-parent.js";
+import type { AgentParentReference } from "./parent-reference-contract.js";
+export type { AgentParentReference } from "./parent-reference-contract.js";
+export interface AgentParentSubject {
+    instance_id: string;
+    generation_id?: string;
+    v3_generation_id?: string;
+    platform?: string;
+    native_session_id?: string;
+}
+export interface AgentParentReferenceOptions {
+    view?: CoordinationViewV3;
+    readNativeParent?: (request: NativeParentRequest) => NativeParentObservation;
+}
+/** Display/recipient evidence only. Never use native evidence as a claim or lifecycle waiver. */
+export declare function resolveAgentParentReference(coordRoot: string, child: AgentParentSubject, options?: AgentParentReferenceOptions): AgentParentReference;
+//# sourceMappingURL=parent-reference.d.ts.map

package/dist/core/agents/state/parent-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-reference.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/parent-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAEzB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,uBAAuB,CAAC;CAC9E;AAED,iGAAiG;AACjG,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAyEtB"}

package/dist/core/agents/state/parent-reference.js

@@ -0,0 +1,119 @@
+import { readCoordinationViewV3 } from "../../events/v3/coordination-view.js";
+import { liveInstanceIdV3, nativeInstanceIdV3 } from "../../events/v3/live-route-observer.js";
+import { readNativeParentReference, } from "../../hooks/adapter/native-parent.js";
+import { resolveName } from "./names.js";
+/** Display/recipient evidence only. Never use native evidence as a claim or lifecycle waiver. */
+export function resolveAgentParentReference(coordRoot, child, options = {}) {
+    try {
+        const view = options.view ?? readCoordinationViewV3(coordRoot);
+        if (!view.source_complete || !view.authority_safe)
+            return unknown("parent_authority_unsafe");
+        if (child.generation_id &&
+            child.v3_generation_id &&
+            child.generation_id !== child.v3_generation_id) {
+            return unknown("child_generation_mismatch");
+        }
+        const instance = liveInstanceIdV3(child.instance_id);
+        const generationId = child.generation_id ?? child.v3_generation_id;
+        const generations = [
+            ...Object.values(view.instances),
+            ...Object.values(view.terminal_generations),
+        ];
+        const generation = generationId
+            ? generations.find((row) => row.generation_id === generationId && row.instance_id === instance)
+            : view.instances[instance];
+        if (!generation)
+            return unknown("child_generation_unavailable");
+        if (!safe(view, generation))
+            return unknown("child_authority_unsafe");
+        const canonical = generation.parent_generation_id
+            ? generations.find((row) => row.generation_id === generation.parent_generation_id)
+            : undefined;
+        if (generation.parent_generation_id && !canonical)
+            return unknown("parent_generation_unavailable");
+        if (canonical && cyclic(generations, generation)) {
+            return { state: "conflict", reason: "parent_lineage_cycle" };
+        }
+        const adapter = generation.runtime_attestation.adapter;
+        const platform = adapter.state === "observed" ? adapter.value.id : child.platform;
+        const nativeId = child.native_session_id ?? nativeInstanceIdV3(instance);
+        const native = platform === "codex" && liveInstanceIdV3(nativeId) === instance
+            ? (options.readNativeParent ?? readNativeParentReference)({
+                adapter: platform,
+                native_session_id: nativeId,
+            })
+            : { state: "unknown", reason: "native_child_identity_unavailable" };
+        if (canonical) {
+            if (native.state === "none" ||
+                (native.state === "observed" &&
+                    liveInstanceIdV3(native.parent_session_id) !== canonical.instance_id)) {
+                return { state: "conflict", reason: "parent_sources_disagree" };
+            }
+            return reference(coordRoot, view, canonical.instance_id, canonical, "v3-session-link");
+        }
+        if (native.state === "observed") {
+            const parentInstance = liveInstanceIdV3(native.parent_session_id);
+            if (parentInstance === instance)
+                return { state: "conflict", reason: "parent_self_reference" };
+            const parent = recipientGeneration(view, parentInstance);
+            if (parent && cyclic(generations, generation, parent)) {
+                return { state: "conflict", reason: "parent_lineage_cycle" };
+            }
+            return reference(coordRoot, view, parentInstance, parent, "native-session-metadata", native.source_witness);
+        }
+        return { state: native.state, reason: native.reason };
+    }
+    catch {
+        return unknown("parent_reference_unavailable");
+    }
+}
+function reference(root, view, instance, parent, source, witness) {
+    const native = nativeInstanceIdV3(instance);
+    const name = resolveName(root, native)?.name ?? null;
+    const recipient = recipientGeneration(view, instance);
+    return {
+        state: "verified",
+        relationship: source === "v3-session-link" ? "delegated-child" : "native-child",
+        parent_instance_id: native,
+        parent_v3_instance_id: instance,
+        parent_generation_id: parent?.generation_id ?? null,
+        parent_session_id: parent?.session_id ?? null,
+        parent_name: name,
+        source,
+        ...(witness ? { source_witness: witness } : {}),
+        addressable: Boolean(parent && recipient?.generation_id === parent.generation_id && safe(view, parent) && name),
+    };
+}
+function recipientGeneration(view, instance) {
+    return (view.instances[instance] ??
+        Object.values(view.terminal_generations)
+            .filter((row) => row.instance_id === instance)
+            .sort((a, b) => b.source_position.segment_ordinal - a.source_position.segment_ordinal ||
+            b.source_position.byte_offset - a.source_position.byte_offset)[0]);
+}
+function safe(view, generation) {
+    return !(view.diagnostics_by_generation[generation.generation_id] ?? []).some((d) => d.authority_blocking);
+}
+function cyclic(generations, child, first) {
+    const seen = new Set([child.generation_id]);
+    let cursor = first ?? child;
+    for (let depth = 0; depth <= generations.length; depth++) {
+        if (cursor !== child) {
+            if (seen.has(cursor.generation_id) || cursor.instance_id === child.instance_id)
+                return true;
+            seen.add(cursor.generation_id);
+        }
+        if (!cursor.parent_generation_id)
+            return false;
+        const next = generations.find((g) => g.generation_id === cursor.parent_generation_id);
+        if (!next)
+            return false;
+        if (seen.has(next.generation_id))
+            return true;
+        cursor = next;
+    }
+    return true;
+}
+function unknown(reason) {
+    return { state: "unknown", reason };
+}