harnery 0.37.0 → 0.38.0

package/dist/core/agents/qa-signal.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Per-session page-QA signal: the pointer that lets `agents status` report a
+ * verdict with the runner's own clock instead of leaving an operator to read
+ * session age as if it were QA time.
+ *
+ * The problem this closes: a status box showing `session 58m` invites the
+ * reading "page QA took 58 minutes". Session age measures the agent, not the
+ * run. So the runner's wall time is recorded here and rendered beside the
+ * verdict, and admission-queue wait is carried as a separate number because
+ * `wall_time_ms.total` is runner stages only and never includes the queue
+ * (see QaRunResult.wall_time_ms in the toolkit contracts).
+ *
+ * Layering: the qa-run matrix runner is toolkit tier (`src/lib/browser/**`)
+ * and must not import `src/core`, so the runner cannot write this pointer
+ * itself. The command layer owns the write and calls `recordQaSignal()` after
+ * a run finishes. Core importing toolkit *types* is the permitted direction.
+ *
+ * Storage: `<coordRoot>/.harnery/qa/<instance-id>.json`, one file per session
+ * generation, atomic temp+rename so a concurrent status read never sees a
+ * torn write. Last run wins; each run directory remains the authoritative
+ * record of the run itself.
+ *
+ * Every function here is best-effort by contract. A missing, unreadable,
+ * malformed, or partial pointer yields null rather than throwing: the status
+ * box must render even when QA state is broken.
+ */
+import type { QaRunEvidenceSource, QaRunResult, QaRunVerdict } from "../../lib/browser/qa-run-contracts.js";
+export declare const QA_SIGNAL_SCHEMA_VERSION: 1;
+/** Pointers older than this render as `stale (<age>)` and nothing else: an
+ * age-of-day-old verdict says nothing about the page as it stands now, and
+ * showing its timings beside a current session invites the same conflation
+ * this signal exists to prevent. */
+export declare const QA_SIGNAL_STALE_AFTER_MS: number;
+/** Timings split the way the result contract splits them: `total` is runner
+ * stages only, `queue` is admission wait before any browser work and is never
+ * part of `total`. */
+export interface QaSignalWallTime {
+    total: number;
+    queue?: number;
+}
+export interface QaSignalPointer {
+    schema_version: typeof QA_SIGNAL_SCHEMA_VERSION;
+    run_id: string;
+    verdict: QaRunVerdict;
+    evidence_source: QaRunEvidenceSource;
+    /** ISO-8601 UTC instant the run completed. */
+    completed_at: string;
+    /** Absolute run directory holding the authoritative result document. */
+    out_dir: string;
+    wall_time_ms: QaSignalWallTime;
+    target: string;
+}
+/**
+ * Absolute path of one session's QA pointer. Throws on an instance id that
+ * could escape the directory; callers in this module treat that as "no
+ * pointer" rather than propagating it.
+ */
+export declare function qaSignalPath(coordRoot: string, instanceId: string): string;
+export interface QaSignalTarget {
+    /** Defaults to the resolved coordination root. */
+    coordRoot?: string | null;
+    /** Defaults to the current session's instance id. */
+    instanceId?: string | null;
+}
+/**
+ * Write the pointer for one completed run. Returns what was written, or null
+ * when the session/root could not be resolved or the write failed — a QA run
+ * must never fail because its status breadcrumb could not be recorded.
+ */
+export declare function recordQaSignal(result: QaRunResult, target?: QaSignalTarget): QaSignalPointer | null;
+/** Read one session's pointer. Null when absent, unreadable, or malformed. */
+export declare function readQaSignal(target?: QaSignalTarget): QaSignalPointer | null;
+/**
+ * Validate an untrusted pointer document. Fail-closed: a partial document —
+ * the shape a torn write or a schema change produces — is not a pointer, and
+ * renders no row at all rather than a half-true one.
+ */
+export declare function parseQaSignal(document: unknown): QaSignalPointer | null;
+/**
+ * Coarse single-unit age, matching the status box's existing age vocabulary
+ * (`4m`, `3h`, `2d`). Deliberately coarser than the duration formatter: an
+ * operator reads age to judge relevance, not to compare timings.
+ */
+export declare function formatQaSignalAge(ms: number): string;
+/**
+ * Duration in the units an operator compares runs by. Seconds stay seconds up
+ * to two minutes so a 90-second run reads `90s` rather than being rounded into
+ * a minute bucket that hides the difference between fast runs.
+ */
+export declare function formatQaSignalDuration(ms: number): string;
+/**
+ * Render the status-box `qa` value, or null when there is nothing honest to
+ * say. Three shapes:
+ *   - fresh runner evidence: `passed 4m ago · 90s runner (2m queued)`
+ *   - fresh manual evidence: `manual 12m ago · not a pass`
+ *   - anything over the staleness horizon: `stale (2d)`
+ *
+ * Manual evidence never reports a verdict or a runner clock: nothing
+ * re-executable ran, so the contract caps it below a pass and there is no
+ * runner time to attribute.
+ */
+export declare function formatQaSignalRow(pointer: QaSignalPointer | null, now?: number): string | null;
+/**
+ * The whole status-box contribution in one best-effort call: read this
+ * session's pointer and render its row. Null means render no `qa` row.
+ */
+export declare function qaSignalStatusRow(target?: QaSignalTarget, now?: number): {
+    value: string;
+    pointer: QaSignalPointer;
+} | null;
+//# sourceMappingURL=qa-signal.d.ts.map

package/dist/core/agents/qa-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-signal.d.ts","sourceRoot":"","sources":["../../../src/core/agents/qa-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,YAAY,EACb,MAAM,uCAAuC,CAAC;AAG/C,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAEnD;;;oCAGoC;AACpC,eAAO,MAAM,wBAAwB,QAAsB,CAAC;AAE5D;;sBAEsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,wBAAwB,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,eAAe,EAAE,mBAAmB,CAAC;IACrC,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU1E;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AASD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,GAAE,cAAmB,GAC1B,eAAe,GAAG,IAAI,CA4BxB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,MAAM,GAAE,cAAmB,GAAG,eAAe,GAAG,IAAI,CAUhF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CA6BvE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,GAAG,IAAI,EAC/B,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,IAAI,CAcf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,cAAmB,EAC3B,GAAG,GAAE,MAAmB,GACvB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAAG,IAAI,CASpD"}

package/dist/core/agents/qa-signal.js

@@ -0,0 +1,231 @@
+/**
+ * Per-session page-QA signal: the pointer that lets `agents status` report a
+ * verdict with the runner's own clock instead of leaving an operator to read
+ * session age as if it were QA time.
+ *
+ * The problem this closes: a status box showing `session 58m` invites the
+ * reading "page QA took 58 minutes". Session age measures the agent, not the
+ * run. So the runner's wall time is recorded here and rendered beside the
+ * verdict, and admission-queue wait is carried as a separate number because
+ * `wall_time_ms.total` is runner stages only and never includes the queue
+ * (see QaRunResult.wall_time_ms in the toolkit contracts).
+ *
+ * Layering: the qa-run matrix runner is toolkit tier (`src/lib/browser/**`)
+ * and must not import `src/core`, so the runner cannot write this pointer
+ * itself. The command layer owns the write and calls `recordQaSignal()` after
+ * a run finishes. Core importing toolkit *types* is the permitted direction.
+ *
+ * Storage: `<coordRoot>/.harnery/qa/<instance-id>.json`, one file per session
+ * generation, atomic temp+rename so a concurrent status read never sees a
+ * torn write. Last run wins; each run directory remains the authoritative
+ * record of the run itself.
+ *
+ * Every function here is best-effort by contract. A missing, unreadable,
+ * malformed, or partial pointer yields null rather than throwing: the status
+ * box must render even when QA state is broken.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { resolveCoordRoot, resolveOwner } from "./coord-client.js";
+export const QA_SIGNAL_SCHEMA_VERSION = 1;
+/** Pointers older than this render as `stale (<age>)` and nothing else: an
+ * age-of-day-old verdict says nothing about the page as it stands now, and
+ * showing its timings beside a current session invites the same conflation
+ * this signal exists to prevent. */
+export const QA_SIGNAL_STALE_AFTER_MS = 24 * 60 * 60 * 1000;
+const INSTANCE_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+const VERDICTS = ["passed", "failed", "incomplete"];
+const EVIDENCE_SOURCES = ["runner", "manual"];
+/**
+ * Absolute path of one session's QA pointer. Throws on an instance id that
+ * could escape the directory; callers in this module treat that as "no
+ * pointer" rather than propagating it.
+ */
+export function qaSignalPath(coordRoot, instanceId) {
+    if (!INSTANCE_ID_PATTERN.test(instanceId)) {
+        throw new Error("instance_id must be 1-128 ASCII letters, digits, hyphens, or underscores");
+    }
+    const directory = resolve(coordRoot, ".harnery", "qa");
+    const candidate = resolve(directory, `${instanceId}.json`);
+    if (!candidate.startsWith(`${directory}/`)) {
+        throw new Error("resolved qa signal path escapes the qa directory");
+    }
+    return candidate;
+}
+function resolveTarget(target) {
+    const coordRoot = target.coordRoot ?? resolveCoordRoot();
+    const instanceId = target.instanceId ?? resolveOwner();
+    if (!coordRoot || !instanceId)
+        return null;
+    return { coordRoot, instanceId };
+}
+/**
+ * Write the pointer for one completed run. Returns what was written, or null
+ * when the session/root could not be resolved or the write failed — a QA run
+ * must never fail because its status breadcrumb could not be recorded.
+ */
+export function recordQaSignal(result, target = {}) {
+    try {
+        const resolved = resolveTarget(target);
+        if (!resolved)
+            return null;
+        const pointer = {
+            schema_version: QA_SIGNAL_SCHEMA_VERSION,
+            run_id: result.run.run_id,
+            verdict: result.verdict,
+            evidence_source: result.evidence_source,
+            completed_at: result.run.completed_at,
+            out_dir: result.run.out_dir,
+            wall_time_ms: {
+                total: result.wall_time_ms.total,
+                ...(typeof result.wall_time_ms.queue === "number"
+                    ? { queue: result.wall_time_ms.queue }
+                    : {}),
+            },
+            target: result.target,
+        };
+        const path = qaSignalPath(resolved.coordRoot, resolved.instanceId);
+        mkdirSync(resolve(path, ".."), { recursive: true });
+        const tmp = `${path}.tmp.${process.pid}`;
+        writeFileSync(tmp, `${JSON.stringify(pointer, null, 2)}\n`, "utf8");
+        renameSync(tmp, path);
+        return pointer;
+    }
+    catch {
+        return null;
+    }
+}
+/** Read one session's pointer. Null when absent, unreadable, or malformed. */
+export function readQaSignal(target = {}) {
+    try {
+        const resolved = resolveTarget(target);
+        if (!resolved)
+            return null;
+        const path = qaSignalPath(resolved.coordRoot, resolved.instanceId);
+        if (!existsSync(path))
+            return null;
+        return parseQaSignal(JSON.parse(readFileSync(path, "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate an untrusted pointer document. Fail-closed: a partial document —
+ * the shape a torn write or a schema change produces — is not a pointer, and
+ * renders no row at all rather than a half-true one.
+ */
+export function parseQaSignal(document) {
+    if (!document || typeof document !== "object" || Array.isArray(document))
+        return null;
+    const value = document;
+    if (value.schema_version !== QA_SIGNAL_SCHEMA_VERSION)
+        return null;
+    if (typeof value.run_id !== "string" || value.run_id.length === 0)
+        return null;
+    if (!VERDICTS.includes(value.verdict))
+        return null;
+    if (!EVIDENCE_SOURCES.includes(value.evidence_source))
+        return null;
+    if (typeof value.completed_at !== "string" || Number.isNaN(Date.parse(value.completed_at))) {
+        return null;
+    }
+    if (typeof value.out_dir !== "string" || value.out_dir.length === 0)
+        return null;
+    if (typeof value.target !== "string" || value.target.length === 0)
+        return null;
+    const wall = value.wall_time_ms;
+    if (!wall || typeof wall !== "object" || Array.isArray(wall))
+        return null;
+    const { total, queue } = wall;
+    if (typeof total !== "number" || !Number.isFinite(total) || total < 0)
+        return null;
+    if (queue !== undefined && (typeof queue !== "number" || !Number.isFinite(queue) || queue < 0)) {
+        return null;
+    }
+    return {
+        schema_version: QA_SIGNAL_SCHEMA_VERSION,
+        run_id: value.run_id,
+        verdict: value.verdict,
+        evidence_source: value.evidence_source,
+        completed_at: value.completed_at,
+        out_dir: value.out_dir,
+        wall_time_ms: { total, ...(typeof queue === "number" ? { queue } : {}) },
+        target: value.target,
+    };
+}
+/**
+ * Coarse single-unit age, matching the status box's existing age vocabulary
+ * (`4m`, `3h`, `2d`). Deliberately coarser than the duration formatter: an
+ * operator reads age to judge relevance, not to compare timings.
+ */
+export function formatQaSignalAge(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)}h`;
+    return `${Math.floor(seconds / 86400)}d`;
+}
+/**
+ * Duration in the units an operator compares runs by. Seconds stay seconds up
+ * to two minutes so a 90-second run reads `90s` rather than being rounded into
+ * a minute bucket that hides the difference between fast runs.
+ */
+export function formatQaSignalDuration(ms) {
+    const value = Math.max(0, ms);
+    if (value < 120_000)
+        return `${Math.round(value / 1000)}s`;
+    if (value < 3_600_000)
+        return `${Math.round(value / 60_000)}m`;
+    const hours = Math.floor(value / 3_600_000);
+    const minutes = Math.round((value % 3_600_000) / 60_000);
+    return minutes > 0 ? `${hours}h ${minutes}m` : `${hours}h`;
+}
+/**
+ * Render the status-box `qa` value, or null when there is nothing honest to
+ * say. Three shapes:
+ *   - fresh runner evidence: `passed 4m ago · 90s runner (2m queued)`
+ *   - fresh manual evidence: `manual 12m ago · not a pass`
+ *   - anything over the staleness horizon: `stale (2d)`
+ *
+ * Manual evidence never reports a verdict or a runner clock: nothing
+ * re-executable ran, so the contract caps it below a pass and there is no
+ * runner time to attribute.
+ */
+export function formatQaSignalRow(pointer, now = Date.now()) {
+    if (!pointer)
+        return null;
+    const completedAt = Date.parse(pointer.completed_at);
+    if (Number.isNaN(completedAt))
+        return null;
+    const ageMs = Math.max(0, now - completedAt);
+    const age = formatQaSignalAge(ageMs);
+    if (ageMs > QA_SIGNAL_STALE_AFTER_MS)
+        return `stale (${age})`;
+    if (pointer.evidence_source === "manual")
+        return `manual ${age} ago · not a pass`;
+    const runner = `${formatQaSignalDuration(pointer.wall_time_ms.total)} runner`;
+    const queued = typeof pointer.wall_time_ms.queue === "number" && pointer.wall_time_ms.queue > 0
+        ? ` (${formatQaSignalDuration(pointer.wall_time_ms.queue)} queued)`
+        : "";
+    return `${pointer.verdict} ${age} ago · ${runner}${queued}`;
+}
+/**
+ * The whole status-box contribution in one best-effort call: read this
+ * session's pointer and render its row. Null means render no `qa` row.
+ */
+export function qaSignalStatusRow(target = {}, now = Date.now()) {
+    try {
+        const pointer = readQaSignal(target);
+        const value = formatQaSignalRow(pointer, now);
+        if (!pointer || !value)
+            return null;
+        return { value, pointer };
+    }
+    catch {
+        return null;
+    }
+}

package/dist/core/agents/session-name-display.d.ts

@@ -7,9 +7,29 @@
 export interface SessionNameDisplayState {
     suggested_session_name?: string;
     session_name_seen_for?: string;
+    session_name_display_requested_for?: string;
 }
 export declare const SESSION_NAME_DISPLAY_NOTE = "Next, before any prose or another tool call, send suggested_session_name verbatim by itself in a fenced code block.";
 export declare function sessionNameDisplayPending(row: SessionNameDisplayState | null | undefined): string | null;
+/**
+ * Every title whose exact display satisfies the current latch.
+ *
+ * The pending title always counts. The title the agent was last instructed to
+ * display also counts, because the harness — not the agent — is what changed
+ * the target after asking. Accepting it costs nothing the operator can see: a
+ * clean one-line block did open that reply. Refusing it left Cursor sessions
+ * permanently latched, since no Cursor surface can re-open a missed window.
+ */
+export declare function sessionNameDisplayAcceptedNames(row: SessionNameDisplayState | null | undefined): string[];
+/**
+ * Match assistant text against any accepted title and report which one closed
+ * the latch, so a drifted display can be stamped against the pending title and
+ * logged as drift rather than silently discarded.
+ */
+export declare function matchSessionNameDisplay(row: SessionNameDisplayState | null | undefined, text: string | undefined, startsWithBlock?: (text: string, expectedName: string) => boolean): {
+    pending: string;
+    displayed: string;
+} | null;
 export declare function sessionNameDisplayBlock(name: string): string;
 export declare function sessionNameDisplayInstruction(name: string): string;
 export declare function sessionNameDisplayRecoveryInstruction(name: string, binName: string): string;
@@ -26,11 +46,6 @@ export declare function sessionNameDisplayRecoveryInstruction(name: string, binN
  * activating the display ritual.
  */
 export declare function toolResponseMintedSessionName(response: unknown, name: string): boolean;
-/**
- * Accept the exact unlabelled block Harnery requests. `text` and `plaintext`
- * are tolerated for older prompts, but the code block may contain only the
- * suggested name and must be the first non-whitespace user-facing content.
- */
 export declare function assistantTextStartsWithSessionNameBlock(text: string, name: string): boolean;
 /**
  * The display latch must not block the two coordination commands that can

package/dist/core/agents/session-name-display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-name-display.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-name-display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,yBAAyB,wHACiF,CAAC;AAExH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,GAAG,IAAI,CAIf;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlE;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtF;AAgDD;;;;GAIG;AACH,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAK3F;AAUD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAmBT"}
+{"version":3,"file":"session-name-display.d.ts","sourceRoot":"","sources":["../../../src/core/agents/session-name-display.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kCAAkC,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED,eAAO,MAAM,yBAAyB,wHACiF,CAAC;AAExH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,GAAG,IAAI,CAIf;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAC9C,MAAM,EAAE,CAKV;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,EAC/C,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,eAAe,GAAE,CACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,KACjB,OAAiD,GACrD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO/C;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlE;AAED,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtF;AAqFD,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI3F;AAUD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAmBT"}

package/dist/core/agents/session-name-display.js

@@ -11,6 +11,37 @@ export function sessionNameDisplayPending(row) {
         return null;
     return name;
 }
+/**
+ * Every title whose exact display satisfies the current latch.
+ *
+ * The pending title always counts. The title the agent was last instructed to
+ * display also counts, because the harness — not the agent — is what changed
+ * the target after asking. Accepting it costs nothing the operator can see: a
+ * clean one-line block did open that reply. Refusing it left Cursor sessions
+ * permanently latched, since no Cursor surface can re-open a missed window.
+ */
+export function sessionNameDisplayAcceptedNames(row) {
+    const pending = sessionNameDisplayPending(row);
+    if (!pending)
+        return [];
+    const requested = row?.session_name_display_requested_for;
+    return requested && requested !== pending ? [pending, requested] : [pending];
+}
+/**
+ * Match assistant text against any accepted title and report which one closed
+ * the latch, so a drifted display can be stamped against the pending title and
+ * logged as drift rather than silently discarded.
+ */
+export function matchSessionNameDisplay(row, text, startsWithBlock = assistantTextStartsWithSessionNameBlock) {
+    if (!text)
+        return null;
+    const accepted = sessionNameDisplayAcceptedNames(row);
+    const pending = accepted[0];
+    if (!pending)
+        return null;
+    const displayed = accepted.find((candidate) => startsWithBlock(text, candidate));
+    return displayed ? { pending, displayed } : null;
+}
 export function sessionNameDisplayBlock(name) {
     return `\`\`\`\n${name}\n\`\`\``;
 }
@@ -62,10 +93,16 @@ function responseContainsSessionNameMint(value, name, seen, depth) {
                 }
             }
             catch {
-                // Wrapper prose and partial JSON are not authoritative mint evidence.
+                // Fall through to the textual check below.
             }
         }
-        return false;
+        // The mint command's stdout often reaches the transcript mangled: cut
+        // short by `cut`/`head -c`, or with a tail-truncated first line. Whole-JSON
+        // parsing then fails even though the name and the mint flag are both
+        // legible, and a session that did mint can never latch. Accept the text
+        // when the exact quoted name sits under its key AND a mint flag is true;
+        // ordinary status output carries the name without any flag.
+        return textCarriesSessionNameMint(value, name);
     }
     if (typeof value !== "object")
         return false;
@@ -82,17 +119,40 @@ function responseContainsSessionNameMint(value, name, seen, depth) {
     }
     return Object.values(row).some((item) => responseContainsSessionNameMint(item, name, seen, depth + 1));
 }
+const MINT_FLAG_PATTERN = /"(?:first_of_session|name_reminted|session_name_retry)"\s*:\s*true\b/;
+function textCarriesSessionNameMint(text, name) {
+    const quotedName = JSON.stringify(name);
+    const keyIndex = text.indexOf('"suggested_session_name"');
+    if (keyIndex < 0)
+        return false;
+    const afterKey = text.slice(keyIndex + '"suggested_session_name"'.length);
+    const valueMatch = /^\s*:\s*("(?:[^"\\]|\\.)*")/.exec(afterKey);
+    if (!valueMatch || valueMatch[1] !== quotedName)
+        return false;
+    return MINT_FLAG_PATTERN.test(text);
+}
 /**
- * Accept the exact unlabelled block Harnery requests. `text` and `plaintext`
- * are tolerated for older prompts, but the code block may contain only the
- * suggested name and must be the first non-whitespace user-facing content.
+ * A leading fenced block whose only line is the suggested name.
+ *
+ * What the contract protects is what the operator sees: the reply opens with a
+ * code block containing exactly the title, so it renders as one clean
+ * copy-pasteable line. The fence's info string changes none of that, so any
+ * single-word language tag passes. Restricting it to `text`/`plaintext` meant a
+ * model that wrote ```txt or ```markdown produced a display the operator could
+ * read perfectly while the latch refused to close — and since nothing else can
+ * close a Cursor latch, that mismatch stranded the whole session.
+ *
+ * Still exact in every load-bearing way: the block is the first user-facing
+ * content, holds one line, and that line equals the name. The backreference
+ * requires the closing fence to match the opening run, so a longer fence cannot
+ * be closed by a shorter one.
  */
+const LEADING_SESSION_NAME_BLOCK = /^(`{3,})[ \t]*[A-Za-z0-9_.+#-]*[ \t]*\n([^\n]*)\n\1[ \t]*(?:\n|$)/;
 export function assistantTextStartsWithSessionNameBlock(text, name) {
     if (!text || !name)
         return false;
     const normalized = text.replace(/\r\n?/g, "\n").trimStart();
-    const match = /^```(?:text|plaintext)?[ \t]*\n([^\n]*)\n```(?:[ \t]*(?:\n|$))/.exec(normalized);
-    return match?.[1] === name;
+    return LEADING_SESSION_NAME_BLOCK.exec(normalized)?.[2] === name;
 }
 /**
  * A trailing stream redirect to `/dev/null` or another descriptor. Agents append

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

@@ -29,6 +29,13 @@ export interface Heartbeat {
     session_name_seen_at?: string;
     /** The specific suggested name proven present by the sighting stamp. */
     session_name_seen_for?: string;
+    /**
+     * The suggested name the agent was last actually instructed to display.
+     * Usually identical to `suggested_session_name`; it differs only when the
+     * title changed after the instruction went out, and a display of it still
+     * counts so that drift cannot strand the latch.
+     */
+    session_name_display_requested_for?: string;
     last_status_at?: string;
     current_turn_id?: string;
     parent_instance_id?: string;

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

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

@@ -44,6 +44,17 @@ export declare function buildLifecycleSuggestedName(currentSessionName: string |
  * different suggested name, a bare "already seen" stamp would suppress the scan
  * forever and leave the Stop-hook naming rule permanently unsatisfiable. */
 export declare function stampSessionNameSeen(coordRoot: string, instanceId: string, name?: string): Heartbeat | null;
+/**
+ * Remember which title the agent was actually asked to display.
+ *
+ * The gate can only ask for a display through the PostToolUse instruction, and
+ * the title it names can change afterwards (an assigned-name rewrite of an
+ * `Agent unknown - ...` suggestion, a lifecycle re-mint, a rebuilt cache that
+ * re-minted from the current task). Without this record the agent's correct
+ * display of the title it was handed matches nothing, the latch never closes,
+ * and on Cursor no later surface can repair it.
+ */
+export declare function stampSessionNameRequested(coordRoot: string, instanceId: string, name: string): Heartbeat | null;
 export declare function releaseClaim(coordRoot: string, instanceId: string, path: string): Heartbeat | null;
 /** Materialize one V3 write-claim authority transition into the heartbeat cache. */
 export declare function acquireClaim(coordRoot: string, instanceId: string, path: string): Heartbeat | null;

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

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,uBAAuB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAatE,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,MAAM,GAC5B,SAAS,GAAG,IAAI,CAQlB;AAeD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoB7F;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAOlB;AAED;;;;6BAI6B;AAC7B,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,GAAG,UAAU,GAAG,WAAuB,GACrD,SAAS,GAAG,IAAI,CAelB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,IAAI,CAOf;AAED;;;;4EAI4E;AAC5E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAMlB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAQlB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAWlB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,eAAe,EAAE,CA6BnB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASrF;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBnF"}
+{"version":3,"file":"heartbeat-writer.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,uBAAuB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAatE,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,MAAM,GAC5B,SAAS,GAAG,IAAI,CAQlB;AAeD,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoB7F;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,SAAS,GAAG,IAAI,CAOlB;AAED;;;;6BAI6B;AAC7B,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,GAAG,UAAU,GAAG,WAAuB,GACrD,SAAS,GAAG,IAAI,CAelB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EAAE,GACzB;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKvD;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,IAAI,CAOf;AAED;;;;4EAI4E;AAC5E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAMlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAOlB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAQlB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAWlB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,eAAe,EAAE,CA6BnB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASrF;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAiBnF"}

package/dist/core/agents/state/heartbeat-writer.js

@@ -128,6 +128,23 @@ export function stampSessionNameSeen(coordRoot, instanceId, name) {
         ...(name ? { session_name_seen_for: name } : {}),
     }));
 }
+/**
+ * Remember which title the agent was actually asked to display.
+ *
+ * The gate can only ask for a display through the PostToolUse instruction, and
+ * the title it names can change afterwards (an assigned-name rewrite of an
+ * `Agent unknown - ...` suggestion, a lifecycle re-mint, a rebuilt cache that
+ * re-minted from the current task). Without this record the agent's correct
+ * display of the title it was handed matches nothing, the latch never closes,
+ * and on Cursor no later surface can repair it.
+ */
+export function stampSessionNameRequested(coordRoot, instanceId, name) {
+    if (!name)
+        return null;
+    return mutate(coordRoot, instanceId, (hb) => hb.session_name_display_requested_for === name
+        ? hb
+        : { ...hb, session_name_display_requested_for: name });
+}
 export function releaseClaim(coordRoot, instanceId, path) {
     const target = canonicalClaimPath(coordRoot, path);
     return mutate(coordRoot, instanceId, (hb) => ({

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,CAqD5B;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,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"}

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

@@ -133,6 +133,7 @@ export function projectHeartbeatV3(coordRoot, generation, cache, nativeInstanceI
         suggested_session_name: cache?.suggested_session_name,
         session_name_seen_at: cache?.session_name_seen_at,
         session_name_seen_for: cache?.session_name_seen_for,
+        session_name_display_requested_for: cache?.session_name_display_requested_for,
         workflow_run_id: generation.run_id,
         workflow_agent_id: generation.workflow_agent_id,
         parent_instance_id: parent ? nativeInstanceIdV3(parent.instance_id) : undefined,

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

@@ -59,6 +59,11 @@ function materializeLiveCoordinationHeartbeat(coordRoot, nativeInstanceId, nativ
             ...(current.session_name_seen_at
                 ? { session_name_seen_at: current.session_name_seen_at }
                 : {}),
+            ...(current.session_name_display_requested_for
+                ? {
+                    session_name_display_requested_for: current.session_name_display_requested_for,
+                }
+                : {}),
         }
         : {};
     const materialized = {

package/dist/core/artifacts/constants.d.ts

@@ -1,5 +1,5 @@
 /** Read-only artifact layout constants safe for browser-side server modules. */
 export declare const ARTIFACTS_DIR = ".harnery/artifacts";
 export declare const ARTIFACT_MANIFEST = ".harnery-artifact.json";
-export declare const ARTIFACT_SCHEMA_VERSION: 1;
+export declare const ARTIFACT_SCHEMA_VERSION: 2;
 //# sourceMappingURL=constants.d.ts.map

package/dist/core/artifacts/constants.js

@@ -1,4 +1,4 @@
 /** Read-only artifact layout constants safe for browser-side server modules. */
 export const ARTIFACTS_DIR = ".harnery/artifacts";
 export const ARTIFACT_MANIFEST = ".harnery-artifact.json";
-export const ARTIFACT_SCHEMA_VERSION = 1;
+export const ARTIFACT_SCHEMA_VERSION = 2;