harnery 0.38.0 → 0.40.0

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

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { EVENT_ADAPTER_IDS_V3 } from "../events/v3/adapter-id.js";
 import { canonicalJsonV3, normalizeNativeIdV3, sha256V3 } from "../events/v3/canonical.js";
 import { readEventV3ControlState } from "../events/v3/control.js";
 import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "../events/v3/coordination-view.js";
@@ -131,9 +132,7 @@ function readAuthoritySafeViewForBootstrap(coordRoot) {
 }
 function readSessionProducerStatesForBootstrap(coordRoot, nativeSessionId) {
     try {
-        return ["claude-code", "codex", "cursor"]
-            .map((adapter) => readHookProducerStateV3(coordRoot, adapter, nativeSessionId))
-            .filter((state) => state !== undefined);
+        return EVENT_ADAPTER_IDS_V3.map((adapter) => readHookProducerStateV3(coordRoot, adapter, nativeSessionId)).filter((state) => state !== undefined);
     }
     catch {
         throw new LiveCoordinationAuthorityV3Error("producer_state_unsafe");
@@ -270,6 +269,9 @@ export function reopenLiveCoordinationGenerationV3(input) {
     if (!terminalView || terminalView.instance_id !== instanceId) {
         throw new LiveCoordinationAuthorityV3Error("terminal_generation_authority_missing");
     }
+    if (terminal.adapter === "openclaw") {
+        throw new LiveCoordinationAuthorityV3Error("lifecycle_not_human_facing");
+    }
     if (terminalView.parent_generation_id || terminalView.delegation_id || terminalView.workflow_id) {
         throw new LiveCoordinationAuthorityV3Error("lifecycle_not_human_facing");
     }

package/dist/core/agents/live-lifecycle-v3.d.ts

@@ -1,4 +1,4 @@
-import type { Adapter } from "../adapter.js";
+import type { EventAdapterIdV3 } from "../events/v3/adapter-id.js";
 import type { EventV3 } from "../events/v3/contract.js";
 export type LiveLifecycleObservationV3Result = {
     state: "recorded";
@@ -8,7 +8,7 @@ interface LiveLifecycleObservationBaseV3 {
     coordRoot: string;
     owner: string;
     nativeSessionId: string;
-    adapter: Adapter;
+    adapter: EventAdapterIdV3;
     observedAt?: string;
 }
 export declare function recordLiveSweepObservationV3(input: LiveLifecycleObservationBaseV3 & {

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

@@ -1 +1 @@
-{"version":3,"file":"live-lifecycle-v3.d.ts","sourceRoot":"","sources":["../../../src/core/agents/live-lifecycle-v3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAaxD,MAAM,MAAM,gCAAgC,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAErF,UAAU,8BAA8B;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,8BAA8B,GAAG;IACtC,WAAW,EAAE,iBAAiB,GAAG,QAAQ,GAAG,uBAAuB,GAAG,mBAAmB,CAAC;IAC1F,KAAK,EAAE,MAAM,CAAC;CACf,GACA,gCAAgC,CAOlC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,8BAA8B,GACpC,gCAAgC,CAQlC"}
+{"version":3,"file":"live-lifecycle-v3.d.ts","sourceRoot":"","sources":["../../../src/core/agents/live-lifecycle-v3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAaxD,MAAM,MAAM,gCAAgC,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAErF,UAAU,8BAA8B;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,8BAA8B,GAAG;IACtC,WAAW,EAAE,iBAAiB,GAAG,QAAQ,GAAG,uBAAuB,GAAG,mBAAmB,CAAC;IAC1F,KAAK,EAAE,MAAM,CAAC;CACf,GACA,gCAAgC,CAOlC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,8BAA8B,GACpC,gCAAgC,CAQlC"}

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

@@ -49,11 +49,6 @@ export interface PromptContextOpts {
     /** When true, append the non-deduplicated Codex status-footer reminder.
      * The caller enables this only for human-facing Codex sessions. */
     statusFooterNudge?: boolean;
-    /** Adapter id this prompt is being rendered for. Gates the mailbox drain:
-     * an adapter that cannot receive UserPromptSubmit context must not consume
-     * messages here, or they are removed from the queue and never shown. When
-     * omitted, delivery is attempted (the default route can receive). */
-    adapter?: string;
     /** Adapter id whose Stop hook ENFORCES the end-of-turn ritual (task_set +
      * status check). When set, append a fresh per-prompt reminder of that
      * contract so the model satisfies it before ending the turn instead of
@@ -70,4 +65,11 @@ export interface PromptContextOpts {
  * councils are pending, matching the bash behavior).
  */
 export declare function renderPromptContext(opts: PromptContextOpts): string;
+/**
+ * Prompts receive the published assessment, and only when it changes in a way
+ * that changes what an agent should do. The dedupe key is scope, state, and
+ * recommended action, so a moving number or a different contributor does not
+ * re-emit the same advice.
+ */
+export declare function resourceWarningIfChanged(coordRoot: string, instanceId: string): string;
 //# sourceMappingURL=prompt-context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AA+CH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;8EAC0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;kFAC8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;kFAC8E;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;uEACmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;yEAGqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;wBAIoB;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAqFnE"}
+{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAgDH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;8EAC0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;kFAC8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;kFAC8E;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;uEACmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;wBAIoB;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAkFnE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA6CtF"}

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

@@ -37,10 +37,11 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, w
 import { join } from "node:path";
 import { coordEnv } from "../../../lib/env.js";
 import { endOfTurnStatusCommand, hostPromptReminder, resolveBinName } from "../../config.js";
-import { canReceiveContext } from "../../hooks/adapter/output.js";
 import { readRemoteMachines } from "../../presence/index.js";
+import { readResourceStatus } from "../../resources/status.js";
 import { drainMailbox, formatMailboxDelivery } from "../mailbox.js";
 import { sessionNameDisplayBlock, sessionNameDisplayPending } from "../session-name-display.js";
+import { heartbeatPath } from "../state/heartbeat-reader.js";
 import { readLiveCoordinationRow, readLiveCoordinationRows, } from "../state/live-coordination-view.js";
 import { formatPendingCouncils, recordDeliveredMessages } from "./session-context.js";
 /**
@@ -52,7 +53,7 @@ import { formatPendingCouncils, recordDeliveredMessages } from "./session-contex
  * councils are pending, matching the bash behavior).
  */
 export function renderPromptContext(opts) {
-    const { coordRoot, instanceId, sessionId, agentName, sessionNameNudge, taskNudge, hostPromptReminder: promptReminderEnabled, statusFooterNudge, turnRitualNudge, adapter, } = opts;
+    const { coordRoot, instanceId, sessionId, agentName, sessionNameNudge, taskNudge, hostPromptReminder: promptReminderEnabled, statusFooterNudge, turnRitualNudge, } = opts;
     const sections = [];
     // The hook route does not pass --name, so resolve it from the heartbeat.
     // Every name-addressed section below (messages, councils) is silently
@@ -62,12 +63,7 @@ export function renderPromptContext(opts) {
     // exactly once, and it is the one section here that carries new information
     // from another agent rather than a reminder.
     //
-    // Draining is gated on the adapter being able to receive this event's
-    // context. Cursor cannot, so draining there would empty the queue into output
-    // that is discarded; those sessions get their messages at SessionStart, which
-    // Cursor does deliver.
-    const canDeliverHere = !adapter || canReceiveContext(adapter, "UserPromptSubmit");
-    if (resolvedName && canDeliverHere) {
+    if (resolvedName) {
         const delivered = drainMailbox(coordRoot, resolvedName);
         if (delivered.length > 0) {
             recordDeliveredMessages(instanceId, delivered);
@@ -78,6 +74,9 @@ export function renderPromptContext(opts) {
     const peerTable = computePeerTableIfChanged(coordRoot, instanceId, sessionId);
     if (peerTable)
         sections.push(peerTable);
+    const resources = resourceWarningIfChanged(coordRoot, instanceId);
+    if (resources)
+        sections.push(resources);
     // 3. Council pending with hash dedup.
     if (resolvedName) {
         const councilMsg = computeCouncilPendingIfChanged(coordRoot, instanceId, resolvedName);
@@ -123,6 +122,62 @@ export function renderPromptContext(opts) {
     }
     return sections.join("\n\n");
 }
+/**
+ * Prompts receive the published assessment, and only when it changes in a way
+ * that changes what an agent should do. The dedupe key is scope, state, and
+ * recommended action, so a moving number or a different contributor does not
+ * re-emit the same advice.
+ */
+export function resourceWarningIfChanged(coordRoot, instanceId) {
+    try {
+        heartbeatPath(coordRoot, instanceId);
+        const status = readResourceStatus(coordRoot);
+        const assessment = status.assessment;
+        const hashFile = join(coordRoot, ".harnery", `.last-resource-hash.${instanceId}`);
+        const previous = safeRead(hashFile);
+        // Existing users without an observer should retain ordinary coordination.
+        if (status.assessment_capability.reason_code === "pressure_record_missing" && !previous) {
+            return "";
+        }
+        const key = `${assessment.scope}:${assessment.state}:${assessment.recommended_action}`;
+        if (previous === key)
+            return "";
+        writeHashFile(hashFile, key);
+        const warning = assessment.state === "elevated" || assessment.state === "critical";
+        const wasWarning = !!previous && (previous.includes(":elevated:") || previous.includes(":critical:"));
+        if (!warning && !wasWarning)
+            return "";
+        const lines = [`Resource update: ${assessment.summary}`];
+        if (assessment.state === "unknown") {
+            lines.push("Resource headroom cannot be measured right now, so continue normal coordination and judge heavy work yourself.");
+        }
+        else if (!warning && wasWarning) {
+            lines.push("The previously reported resource warning has cleared.");
+        }
+        for (const item of assessment.guidance) {
+            lines.push(`${WORKLOAD_LABEL[item.workload_class]}: ${item.summary}`);
+        }
+        const owners = assessment.contributors
+            .filter((row) => row.attribution_confidence === "exact" && row.owner_id)
+            .slice(0, 3)
+            .map((row) => `${row.owner_kind ?? "owner"} ${row.owner_id}`);
+        if (owners.length) {
+            lines.push(`Measured owners of the contended resource: ${owners.join(", ")}. That says who is holding it, not what the machine as a whole can take.`);
+        }
+        lines.push(`Read \`${resolveBinName(coordRoot)} resources status --json\` for the evidence behind this.`);
+        return lines.join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+/** How an agent recognizes the work each guidance entry is about. */
+const WORKLOAD_LABEL = {
+    lightweight: "Reads and small edits",
+    "cpu-heavy": "Builds and test runs",
+    "memory-heavy": "Browser captures and page QA",
+    "storage-heavy": "Large writes and exports",
+};
 function renderHostPromptReminder(coordRoot, selfInstanceId) {
     const hb = readLiveCoordinationRow(coordRoot, selfInstanceId);
     if (!hb || hb.kind === "subagent" || hb.kind === "transient" || hb.workflow_run_id)

package/dist/core/agents/session-finalizer-v3.d.ts

@@ -1,9 +1,9 @@
-import type { Adapter } from "../adapter.js";
+import type { EventAdapterIdV3 } from "../events/v3/adapter-id.js";
 import type { EventV3 } from "../events/v3/contract.js";
 import { type SessionFinalizationRequestV3 } from "./session-finalization-state-v3.js";
 export { listSessionFinalizationRequestsV3, type SessionFinalizationRequestV3, type SessionFinalizationTriggerV3, } from "./session-finalization-state-v3.js";
 export interface SessionArchiveObservationV3 {
-    adapter: Adapter;
+    adapter: EventAdapterIdV3;
     native_session_id: string;
     archived: boolean;
     observed_at: string;

package/dist/core/agents/session-finalizer-v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-finalizer-v3.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-finalizer-v3.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAmBxD,OAAO,EAIL,KAAK,4BAA4B,EAIlC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,iCAAiC,EACjC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,oCAAoC,CAAC;AAK5C,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qCAAqC;IACpD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,oBAAoB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,OAAO,MAAM,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,gCAAiC,SAAQ,yBAAyB;CAAG;AAEtF,MAAM,MAAM,iCAAiC,GACzC,UAAU,CAAC,OAAO,oBAAoB,CAAC,GACvC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,wBAAwB,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,4BAA4B,CAAA;CAAE,GAC1D;IACE,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,4BAA4B,CAAC;IACtC,oIAAoI;IACpI,OAAO,EAAE;QACP,aAAa,EAAE,QAAQ,MAAM,EAAE,EAAE,CAAC;QAClC,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,OAAO,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB;;;;;;;;;;;;;;;;;EA6BpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,iCAAiC,CA8DnC;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;EAiC5E;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qCAA0C,GAClD,oCAAoC,CAmOtC"}
+{"version":3,"file":"session-finalizer-v3.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-finalizer-v3.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAmBxD,OAAO,EAIL,KAAK,4BAA4B,EAIlC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,iCAAiC,EACjC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,oCAAoC,CAAC;AAK5C,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qCAAqC;IACpD,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,oBAAoB,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,OAAO,MAAM,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,gCAAiC,SAAQ,yBAAyB;CAAG;AAEtF,MAAM,MAAM,iCAAiC,GACzC,UAAU,CAAC,OAAO,oBAAoB,CAAC,GACvC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,wBAAwB,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,4BAA4B,CAAA;CAAE,GAC1D;IACE,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,4BAA4B,CAAC;IACtC,oIAAoI;IACpI,OAAO,EAAE;QACP,aAAa,EAAE,QAAQ,MAAM,EAAE,EAAE,CAAC;QAClC,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAEN,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,OAAO,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB;;;;;;;;;;;;;;;;;EA6BpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,iCAAiC,CA8DnC;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;EAiC5E;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qCAA0C,GAClD,oCAAoC,CAmOtC"}

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

@@ -1,4 +1,4 @@
-import type { Adapter } from "../../adapter.js";
+import { type EventAdapterIdV3 } from "../../events/v3/adapter-id.js";
 import { type CoordinationGenerationViewV3 } from "../../events/v3/coordination-view.js";
 import { type Heartbeat } from "./heartbeat-reader.js";
 /**
@@ -21,9 +21,9 @@ export declare function readLiveCoordinationRow(coordRoot: string, nativeInstanc
  * V3 generation is stronger evidence than a missing or stale heartbeat, so
  * callers must never substitute another adapter when this function succeeds.
  */
-export declare function liveCoordinationAdapterV3(coordRoot: string, nativeInstanceId: string): Adapter | null;
+export declare function liveCoordinationAdapterV3(coordRoot: string, nativeInstanceId: string): EventAdapterIdV3 | null;
 export declare function isCurrentV3HeartbeatCache(cache: Heartbeat | null | undefined, generation: CoordinationGenerationViewV3): cache is Heartbeat;
 export declare function projectHeartbeatV3(coordRoot: string, generation: CoordinationGenerationViewV3, cache: Heartbeat | undefined, nativeInstanceId: string | undefined, parent?: CoordinationGenerationViewV3): V3HeartbeatMaterialization;
 export declare function observedAdapterV3(generation: CoordinationGenerationViewV3): string | undefined;
-export declare function isAdapterV3(value: string | undefined): value is Adapter;
+export declare function isAdapterV3(value: string | undefined): value is EventAdapterIdV3;
 //# sourceMappingURL=live-coordination-view.d.ts.map

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,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,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,OAAO,GAAG,IAAI,CAWhB;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,CAsD5B;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,4BAA4B,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,OAAO,CAEvE"}
+{"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,CAsD5B;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"}

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

@@ -1,5 +1,6 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { EVENT_ADAPTER_IDS_V3 } from "../../events/v3/adapter-id.js";
 import { readCoordinationViewV3, requireAuthoritySafeCoordinationViewV3, } from "../../events/v3/coordination-view.js";
 import { liveInstanceIdV3, nativeInstanceIdV3, observeLiveEventLedgerRouteV3, } from "../../events/v3/live-route-observer.js";
 import { readHeartbeat } from "./heartbeat-reader.js";
@@ -148,7 +149,7 @@ export function observedAdapterV3(generation) {
     return observation.state === "observed" ? observation.value.id : undefined;
 }
 export function isAdapterV3(value) {
-    return value === "claude-code" || value === "cursor" || value === "codex";
+    return EVENT_ADAPTER_IDS_V3.includes(value ?? "");
 }
 function observedModel(generation) {
     const observation = generation.runtime_attestation.model;

package/dist/core/agents/state/names.d.ts

@@ -25,10 +25,17 @@
  * new binding instead of rewriting history; readers therefore resolve from the
  * end of the file. Older one-row histories retain their original behavior.
  *   3. Else: new assignment, consume a counter slot.
+ *
+ * Live-name skip: the pool holds 260 names and a busy repo consumes ~100 a
+ * day, so the counter wraps roughly every three days while sessions that
+ * resume under a stable instance_id keep a name for far longer. A counter-only
+ * pick therefore hands a live agent's name to a new one (observed 2026-09-06:
+ * two concurrent "Maya" agents, their pool slots exactly 520 apart). Assignment
+ * now probes forward past any name a fresh heartbeat still holds.
  */
 /** All 260 names. */
 export declare const COORD_NAMES: readonly ["Anna", "Bob", "Carmen", "Dorian", "Erika", "Fred", "Gemma", "Hank", "Imelda", "Jerry", "Karen", "Lorenzo", "Mindy", "Nate", "Odette", "Peter", "Quinn", "Rafael", "Sara", "Tony", "Ursula", "Vinson", "Whitney", "Xander", "Yara", "Zane", "Alex", "Bertha", "Carlos", "Dalia", "Ernesto", "Francine", "Gordon", "Helene", "Isaias", "Joyce", "Kirk", "Lucia", "Milton", "Nadine", "Oscar", "Patty", "Quentin", "Rebekah", "Sean", "Tammy", "Ulrik", "Valerie", "Wallace", "Xanthe", "Yusuf", "Zara", "Adelaide", "Bruno", "Cora", "Damon", "Edna", "Felix", "Greta", "Hugo", "Ines", "Jasper", "Kaia", "Larry", "Maxine", "Nicholas", "Olive", "Paxton", "Querida", "Roman", "Stella", "Tobias", "Una", "Virgil", "Willow", "Xavier", "Yolanda", "Zephyr", "Aaron", "Beatrice", "Cyrus", "Delia", "Elias", "Florence", "Galileo", "Hester", "Ian", "Jenna", "Klaus", "Linda", "Marco", "Nora", "Otto", "Paulette", "Quill", "Renee", "Sebastian", "Theresa", "Umberto", "Vera", "Walter", "Xena", "Yves", "Zoe", "Anita", "Beau", "Celeste", "Dexter", "Edith", "Fitz", "Gloria", "Hadley", "Iris", "Jude", "Kira", "Leo", "Maya", "Nash", "Olga", "Phillip", "Quetzal", "Royce", "Sage", "Trent", "Uma", "Vincent", "Wynne", "Xerxes", "Yvette", "Zoltan", "Andre", "Bonnie", "Caleb", "Daphne", "Ezra", "Fiona", "Gibson", "Holly", "Ivan", "Juno", "Knox", "Lila", "Mason", "Nila", "Owen", "Petra", "Quincy", "Rosa", "Sterling", "Talia", "Uri", "Violet", "Wesley", "Ximena", "Yuri", "Zelda", "Astrid", "Boris", "Cassidy", "Davis", "Esme", "Forrest", "Genevieve", "Henry", "Imogen", "Joaquin", "Kestrel", "Luther", "Margot", "Nigel", "Ophelia", "Percy", "Quenby", "Reagan", "Sienna", "Truman", "Undine", "Voss", "Wren", "Xan", "Yael", "Zia", "Arthur", "Bianca", "Cody", "Dahlia", "Evander", "Fern", "Gustavo", "Harriet", "Ira", "Josephine", "Kendrick", "Lainey", "Miles", "Naomi", "Orion", "Pearl", "Quark", "Rylie", "Saul", "Tessa", "Ulysses", "Vesper", "Wyatt", "Xiomara", "Yancy", "Zinnia", "Amelia", "Barnaby", "Calliope", "Drake", "Estelle", "Foster", "Greer", "Hollis", "Irene", "Jericho", "Klara", "Logan", "Mavis", "Nico", "Oakley", "Pascal", "Quito", "Rhett", "Scout", "Theron", "Unity", "Vance", "Winifred", "Xola", "Yvonne", "Zev", "Atticus", "Brenda", "Crispin", "Dolores", "Eustace", "Felicity", "Granger", "Hazel", "Idris", "Jovi", "Kasper", "Lyric", "Magnus", "Noor", "Otis", "Phoebe", "Querubin", "Rosalind", "Silas", "Tatum", "Upton", "Vivian", "Wendell", "Xuxa", "Yann", "Zora"];
-export type NameKind = "session" | "subagent" | "transient";
+export type NameKind = "session" | "subagent" | "transient" | "workflow-child";
 export interface NameHistoryRow {
     instance_id: string;
     name: string;
@@ -74,12 +81,38 @@ export interface NameAssumptionResult {
  * this auditable and retry-safe without mutating prior assignment history.
  */
 export declare function recordNameAssumption(coordRoot: string, instanceId: string, name: string, agentId: string, kind?: NameKind): NameAssumptionResult;
+/**
+ * Names a live agent currently holds, read from the generation-bound heartbeat
+ * cache (`.harnery/active/<instance>.json`).
+ *
+ * Deliberately reads the cache directly rather than the V3 coordination view:
+ * that view imports `resolveName` from this module, so depending on it here
+ * would build an import cycle. The cache is the same set the view materializes
+ * from and is pruned as sessions end, so it answers "is this name taken right
+ * now" without one.
+ *
+ * Both error directions are safe for the caller. A stale row that slips past
+ * the freshness window costs one skipped pool slot; a live agent missing from
+ * the cache just restores the old counter-only behavior for that assignment.
+ */
+export declare function readLiveNames(coordRoot: string, opts: {
+    freshnessSecs: number;
+    nowMs?: number;
+}): Set<string>;
 /**
  * Assign a name to <instanceId> with the given <kind>. Counter-consuming when
  * the owner is new. Idempotent: returns existing name on resume.
+ *
+ * Slot choice probes forward from the counter and takes the first name no live
+ * agent holds, then advances the counter past every slot it skipped so the skip
+ * is durable rather than re-probed on the next assignment. A full lap without a
+ * free name means all 260 are genuinely live, so the raw counter slot is used:
+ * a duplicate name beats refusing to name an agent at all.
  */
-export declare function assignName(coordRoot: string, instanceId: string, kind: NameKind, opts?: {
+export declare function assignName(coordRoot: string, instanceId: string, kind: NameKind, opts: {
+    freshnessSecs: number;
     forkedFrom?: string;
+    nowMs?: number;
 }): string;
 /** One step of recorded fork lineage: the latest row for <instanceId> that
  * carries `forked_from` (latest-row-wins, matching resolveName). */

package/dist/core/agents/state/names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,qBAAqB;AACrB,eAAO,MAAM,WAAW,85EA+Qd,CAAC;AAMX,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;2DAEuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsCD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4B5D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAoB,GACzB,oBAAoB,CAoBtB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,MAAM,CA0BR;AAED;oEACoE;AACpE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAUrD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAYrD"}
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAYH,qBAAqB;AACrB,eAAO,MAAM,WAAW,85EA+Qd,CAAC;AAMX,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;2DAEuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsCD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4B5D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAoB,GACzB,oBAAoB,CAoBtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,GAAG,CAAC,MAAM,CAAC,CA4Bb;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,MAAM,CA4CR;AAED;oEACoE;AACpE,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAUrD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAYrD"}

package/dist/core/agents/state/names.js

@@ -25,8 +25,15 @@
  * new binding instead of rewriting history; readers therefore resolve from the
  * end of the file. Older one-row histories retain their original behavior.
  *   3. Else: new assignment, consume a counter slot.
+ *
+ * Live-name skip: the pool holds 260 names and a busy repo consumes ~100 a
+ * day, so the counter wraps roughly every three days while sessions that
+ * resume under a stable instance_id keep a name for far longer. A counter-only
+ * pick therefore hands a live agent's name to a new one (observed 2026-09-06:
+ * two concurrent "Maya" agents, their pool slots exactly 520 apart). Assignment
+ * now probes forward past any name a fresh heartbeat still holds.
  */
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
 import { dirname, join } from "node:path";
 /** All 260 names. */
 export const COORD_NAMES = [
@@ -393,9 +400,62 @@ export function recordNameAssumption(coordRoot, instanceId, name, agentId, kind
     });
     return { changed: true, previous, current };
 }
+/**
+ * Names a live agent currently holds, read from the generation-bound heartbeat
+ * cache (`.harnery/active/<instance>.json`).
+ *
+ * Deliberately reads the cache directly rather than the V3 coordination view:
+ * that view imports `resolveName` from this module, so depending on it here
+ * would build an import cycle. The cache is the same set the view materializes
+ * from and is pruned as sessions end, so it answers "is this name taken right
+ * now" without one.
+ *
+ * Both error directions are safe for the caller. A stale row that slips past
+ * the freshness window costs one skipped pool slot; a live agent missing from
+ * the cache just restores the old counter-only behavior for that assignment.
+ */
+export function readLiveNames(coordRoot, opts) {
+    const live = new Set();
+    const dir = join(coordRoot, ".harnery", "active");
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return live; // No cache yet (fresh checkout) → nothing is live.
+    }
+    const nowMs = opts.nowMs ?? Date.now();
+    const cutoffMs = nowMs - opts.freshnessSecs * 1000;
+    for (const entry of entries) {
+        if (!entry.endsWith(".json"))
+            continue;
+        let row;
+        try {
+            row = JSON.parse(readFileSync(join(dir, entry), "utf8"));
+        }
+        catch {
+            continue; // A torn or half-written row cannot prove a name is held.
+        }
+        if (typeof row.name !== "string" || row.name.length === 0)
+            continue;
+        if (typeof row.last_heartbeat !== "string")
+            continue;
+        const beatMs = Date.parse(row.last_heartbeat);
+        if (!Number.isFinite(beatMs) || beatMs < cutoffMs)
+            continue;
+        live.add(row.name);
+    }
+    return live;
+}
 /**
  * Assign a name to <instanceId> with the given <kind>. Counter-consuming when
  * the owner is new. Idempotent: returns existing name on resume.
+ *
+ * Slot choice probes forward from the counter and takes the first name no live
+ * agent holds, then advances the counter past every slot it skipped so the skip
+ * is durable rather than re-probed on the next assignment. A full lap without a
+ * free name means all 260 are genuinely live, so the raw counter slot is used:
+ * a duplicate name beats refusing to name an agent at all.
  */
 export function assignName(coordRoot, instanceId, kind, opts) {
     // Check 1: existing history row → original name. A resume re-enters here,
@@ -404,7 +464,14 @@ export function assignName(coordRoot, instanceId, kind, opts) {
     const existing = resolveName(coordRoot, instanceId);
     if (existing)
         return existing.name;
-    // New owner: consume a counter slot.
+    // New owner: consume a counter slot. The live set is gathered BEFORE the
+    // counter read on purpose. Counter read-modify-write is already unlocked, so
+    // concurrent assignments can collide on one slot; doing the directory scan
+    // first keeps that window exactly as narrow as it was before the skip existed.
+    const live = readLiveNames(coordRoot, {
+        freshnessSecs: opts.freshnessSecs,
+        ...(opts.nowMs !== undefined ? { nowMs: opts.nowMs } : {}),
+    });
     const cPath = counterPath(coordRoot);
     let counter = 0;
     if (existsSync(cPath)) {
@@ -412,9 +479,17 @@ export function assignName(coordRoot, instanceId, kind, opts) {
         if (/^\d+$/.test(raw))
             counter = Number.parseInt(raw, 10);
     }
-    const name = COORD_NAMES[counter % 260];
-    atomicWrite(cPath, String(counter + 1));
-    const forkedFrom = opts?.forkedFrom;
+    let chosen = counter;
+    for (let probe = 0; probe < 260; probe++) {
+        const candidate = COORD_NAMES[(counter + probe) % 260];
+        if (!live.has(candidate)) {
+            chosen = counter + probe;
+            break;
+        }
+    }
+    const name = COORD_NAMES[chosen % 260];
+    atomicWrite(cPath, String(chosen + 1));
+    const forkedFrom = opts.forkedFrom;
     appendHistory(coordRoot, {
         instance_id: instanceId,
         name,

package/dist/core/agents/state/stale-sweep.d.ts

@@ -1,5 +1,5 @@
 /**
- * Stale-sweep: prune dead heartbeats + orphaned pid-map + .last-peer-hash
+ * Stale-sweep: prune dead heartbeats + orphaned pid-map + prompt hash
  * files.
  *
  * Runs after session.started to clean up crashed-peer detritus before the new
@@ -13,5 +13,6 @@ export declare function staleSweep(coordRoot: string): {
     heartbeatsRemoved: string[];
     pidmapsRemoved: number;
     peerHashesRemoved: number;
+    resourceHashesRemoved: number;
 };
 //# sourceMappingURL=stale-sweep.d.ts.map

package/dist/core/agents/state/stale-sweep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stale-sweep.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/stale-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuEH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CA8IA"}
+{"version":3,"file":"stale-sweep.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/stale-sweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyEH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAyJA"}

package/dist/core/agents/state/stale-sweep.js

@@ -1,5 +1,5 @@
 /**
- * Stale-sweep: prune dead heartbeats + orphaned pid-map + .last-peer-hash
+ * Stale-sweep: prune dead heartbeats + orphaned pid-map + prompt hash
  * files.
  *
  * Runs after session.started to clean up crashed-peer detritus before the new
@@ -20,6 +20,8 @@ function adapterFromPlatform(platform) {
         return "cursor";
     if (platform === "codex")
         return "codex";
+    if (platform === "openclaw")
+        return "openclaw";
     return "claude-code";
 }
 /**
@@ -72,6 +74,7 @@ export function staleSweep(coordRoot) {
     const heartbeatsRemoved = [];
     let pidmapsRemoved = 0;
     let peerHashesRemoved = 0;
+    let resourceHashesRemoved = 0;
     const freshness = coordFreshnessSeconds(coordRoot);
     const nowSec = Math.floor(Date.now() / 1000);
     const cutoff = nowSec - freshness;
@@ -173,17 +176,31 @@ export function staleSweep(coordRoot) {
             }
         }
     }
-    // 3. Prune .last-peer-hash files for dead owners.
+    // 3. Prune prompt hashes for dead owners. Resource hashes retain their own
+    // count so existing peer-hash telemetry keeps its original meaning.
     const agentsDir = join(coordRoot, ".harnery");
     if (existsSync(agentsDir)) {
         for (const f of readdirSync(agentsDir)) {
-            if (!f.startsWith(".last-peer-hash."))
+            const resourceHash = f.startsWith(".last-resource-hash.");
+            const prefix = resourceHash ? ".last-resource-hash." : ".last-peer-hash.";
+            if (!f.startsWith(prefix))
                 continue;
-            const owner = f.slice(".last-peer-hash.".length);
+            const owner = f.slice(prefix.length);
+            if (resourceHash) {
+                // Ignore atomic-write temporary files and preserve hashes when a
+                // retained heartbeat's liveness could not be determined safely.
+                if (!/^[A-Za-z0-9_-]{1,128}$/.test(owner))
+                    continue;
+                if (existsSync(join(d, `${owner}.json`)))
+                    continue;
+            }
             if (!liveInstanceIds.has(owner)) {
                 try {
                     unlinkSync(join(agentsDir, f));
-                    peerHashesRemoved += 1;
+                    if (resourceHash)
+                        resourceHashesRemoved += 1;
+                    else
+                        peerHashesRemoved += 1;
                 }
                 catch {
                     /* swallow */
@@ -191,5 +208,5 @@ export function staleSweep(coordRoot) {
             }
         }
     }
-    return { heartbeatsRemoved, pidmapsRemoved, peerHashesRemoved };
+    return { heartbeatsRemoved, pidmapsRemoved, peerHashesRemoved, resourceHashesRemoved };
 }

package/dist/core/agents/turn-elapsed.d.ts

@@ -0,0 +1,51 @@
+/**
+ * How long the current turn has been running, for the closing status box.
+ *
+ * The box already reports `session`, which is cumulative and says nothing
+ * about the work just done: a 9-minute session hides whether this turn took
+ * twelve seconds or eight minutes. `turn` measures from the operator's prompt
+ * (`turn.started`) to the moment the box renders, so the operator reads the
+ * cost of the turn they are about to be handed.
+ *
+ * Every read here is best-effort by contract. A missing ledger, an
+ * unvalidated one, or no `turn.started` for this owner renders no row rather
+ * than failing the status command.
+ */
+import type { EventV3 } from "../events/v3/contract.js";
+export interface TurnElapsed {
+    /** Seconds from the turn's start to its terminal, or to `now` while open. */
+    secs: number;
+    /** True once a `turn.completed` closed the turn this measures. */
+    complete: boolean;
+    /** Stop-hook restarts folded into this measurement. */
+    remediation_restarts: number;
+}
+/**
+ * Measure the newest turn for `instanceId` from an already-read event stream.
+ *
+ * A Stop-hook bounce ends one `turn.started` and opens another carrying
+ * `stop_remediation`. The operator experiences those as one turn, so the walk
+ * back over remediation restarts reports elapsed time since their prompt, not
+ * since the last retry. The walk stays inside one generation: a resumed
+ * session must not absorb the previous generation's turn into its own.
+ */
+export declare function resolveTurnElapsed(events: readonly EventV3[], instanceId: string, now?: number): TurnElapsed | null;
+/**
+ * Render a turn duration for the box. Seconds stay visible below an hour
+ * because most turns land there and a bare `4m` cannot be compared with the
+ * turn before it.
+ */
+export declare function formatTurnElapsed(secs: number): string;
+export interface TurnElapsedTarget {
+    coordRoot: string;
+    instanceId: string;
+}
+/**
+ * The whole status-box contribution in one best-effort call: read the ledger
+ * and render this session's `turn` row. Null means render no row.
+ */
+export declare function turnElapsedStatusRow(target: TurnElapsedTarget, now?: number): {
+    value: string;
+    elapsed: TurnElapsed;
+} | null;
+//# sourceMappingURL=turn-elapsed.d.ts.map

package/dist/core/agents/turn-elapsed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-elapsed.d.ts","sourceRoot":"","sources":["../../../src/core/agents/turn-elapsed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAOxD,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAWD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAmB,GACvB,WAAW,GAAG,IAAI,CA0CpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,GAAG,GAAE,MAAmB,GACvB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAchD"}