@tangle-network/agent-runtime 2.3.11 → 3.0.1

package/dist/{top-web-DK6lTMHG.js → top-web-DRfER2jW.js}

@@ -1,7 +1,7 @@
-import { Ki as recordValue, L as FileSpawnJournal, d as legacySupervisorRunsRoot, dn as FileObserverJournal, g as safeWorkerFile, i as nodeStreamFile, n as ROOT_STREAM_FILE, qt as FileResultBlobStore, v as supervisorRunsRoot, z as spawnJournalRecordEvents } from "./scope-DRaBilEX.js";
+import { Jn as harnessTranscriptArtifact, L as FileSpawnJournal, Xi as recordValue, _r as runAbortable, d as legacySupervisorRunsRoot, dn as FileObserverJournal, g as safeWorkerFile, gr as linkAbort, i as nodeStreamFile, n as ROOT_STREAM_FILE, qt as FileResultBlobStore, v as supervisorRunsRoot, z as spawnJournalRecordEvents } from "./scope-BeI3tmVX.js";
 import { r as parseCommittedJsonLines } from "./jsonl-file-BBP9Dz9w.js";
-import { h as rootCoordinationOwner, v as FileCoordinationLog } from "./run-cancellation-BxoFCpJ_.js";
-import { d as projectPursuit, o as readFailureRecord, s as readSettleRecord, t as discoverDurableSupervisionRun } from "./supervision-discovery-Da5zebY2.js";
+import { h as rootCoordinationOwner, v as FileCoordinationLog } from "./run-cancellation-BTjyVpVW.js";
+import { d as projectPursuit, o as readFailureRecord, s as readSettleRecord, t as discoverDurableSupervisionRun } from "./supervision-discovery-CyvJVbTM.js";
 import { createRequire } from "node:module";
 import { isRecord } from "@tangle-network/agent-core";
 import { createHash } from "node:crypto";
@@ -10,71 +10,296 @@ import { basename, dirname, extname, join, resolve, sep } from "node:path";
 import { readFile, realpath, stat } from "node:fs/promises";
 import { createServer } from "node:http";
 import { StringDecoder } from "node:string_decoder";
+import { once } from "node:events";
 // src/tui/top-transcript.ts
 /** Read selected history on demand, leaving the live topology snapshot bounded and fast. */
 async function transcriptHistory(worker, runDir, node) {
+	return readTopAgentHistory(worker, runDir ? new FileResultBlobStore(join(runDir, "blobs")) : void 0, node);
+}
+/** Task, result and progress use the same projection for file-backed and SQL-backed runs. */
+async function readTopAgentHistory(worker, blobs, node) {
 	const rows = [];
-	const identity = node?.identity;
-	if (runDir && typeof identity?.taskDigest === "string" && worker.startedAt) {
-		const task = await new FileResultBlobStore(join(runDir, "blobs")).get(identity.taskDigest);
-		if (task !== void 0) rows.unshift({
+	const identity = recordValue(node?.identity ?? worker.identity);
+	if (blobs && typeof identity?.taskDigest === "string" && worker.startedAt) {
+		const task = await blobs.get(identity.taskDigest);
+		if (task !== void 0) rows.push({
 			at: worker.startedAt,
 			event: {
 				kind: "notice",
 				provenance: "delegated-input",
-				source: `parent ${node?.parentId ?? "run caller"}; task ${identity.taskDigest}${typeof identity.profileDigest === "string" ? `; profile ${identity.profileDigest}` : ""}; Runtime FileResultBlobStore`,
-				text: typeof task === "string" ? task : JSON.stringify(task, null, 2)
+				source: `parent ${worker.parent ?? node?.parentId ?? "run caller"}; task ${identity.taskDigest}; profile ${identity.profileDigest}`,
+				text: `Request from ${worker.parent ?? node?.parentId ?? "run caller"}\n${typeof task === "string" ? task : JSON.stringify(task, null, 2)}`
 			}
 		});
 	}
-	if (!worker.eventFile) {
-		const retained = runDir ? await retainedTranscriptLines(worker, runDir) : [];
-		const native = transcriptRows(retained.length ? {
-			...worker,
-			liveTail: retained
-		} : worker);
-		if (!native.length && worker.startedAt) rows.push({
-			at: worker.startedAt,
-			event: {
-				kind: "notice",
-				provenance: "capture-unavailable",
-				text: "Native conversation was not captured for this agent.",
-				source: "Runtime recorded capture"
+	const progress = transcriptTail(worker);
+	if (worker.startedAt) rows.push({
+		at: worker.startedAt,
+		event: {
+			kind: "notice",
+			provenance: "capture-unavailable",
+			text: "Full conversation capture has not been verified in this progress tail.",
+			source: "Runtime progress evidence"
+		}
+	});
+	const outRef = node?.outRef ?? worker.outRef;
+	const result = blobs && outRef && worker.endedAt ? await blobs.get(outRef) : void 0;
+	if (result !== void 0) progress.push({
+		at: worker.endedAt,
+		event: {
+			kind: "notice",
+			provenance: "recorded-result",
+			source: `result ${outRef}; Runtime ResultBlobStore`,
+			text: typeof result === "string" ? result : JSON.stringify(result, null, 2)
+		}
+	});
+	return [...rows, ...progress];
+}
+/** Resolve ordinary Runtime transcript evidence, never a product-specific capture registry. */
+async function readTopAgentInspection({ worker, runId, blobs, readSessions, artifacts, signal }) {
+	const evidence = worker.harnessTranscript;
+	const files = {
+		scope: "none",
+		complete: true,
+		reason: "Transcript evidence does not include a workspace inventory",
+		entries: []
+	};
+	if (!evidence || evidence.status !== "available") return {
+		coverage: {
+			status: "missing",
+			source: "Runtime transcript receipt",
+			reason: evidence?.reason ?? "No transcript receipt was recorded"
+		},
+		files
+	};
+	const metadata = await harnessTranscriptArtifact(evidence, blobs, {
+		content: false,
+		signal
+	});
+	if (!metadata) throw new Error("Available transcript receipt has no metadata");
+	const binding = inspectionBinding(metadata, worker, runId);
+	if (binding.mismatch.length) return {
+		coverage: {
+			status: "missing",
+			source: "Runtime transcript receipt",
+			code: "source-mismatch",
+			reason: binding.mismatch.join("; ")
+		},
+		files
+	};
+	const artifact = await harnessTranscriptArtifact(evidence, blobs, {
+		artifacts,
+		signal
+	});
+	if (!artifact) throw new Error("Available transcript receipt has no artifact");
+	const projection = harnessSessionRows(await readSessions(artifact, signal));
+	const reasons = [
+		...binding.missing,
+		...evidence.missing ?? [],
+		...artifact.skipped.map((file) => `${file.path}: ${file.reason}`),
+		...projection.gaps.map((gap) => `${gap.sessionId}/${gap.recordId}: ${gap.reason}`)
+	];
+	const complete = evidence.coverageComplete === true && reasons.length === 0 && projection.rows.length > 0;
+	return {
+		coverage: {
+			status: complete ? "complete" : "partial",
+			source: `${artifact.harness} Runtime transcript`,
+			ref: `urn:${evidence.transcriptRef}`,
+			...binding.missing.length ? { code: "source-unbound" } : {},
+			...!complete ? { reason: reasons.join("; ") || "Source completeness was not attested" } : {}
+		},
+		rows: projection.rows,
+		files
+	};
+}
+/** Verify the receipt belongs to the selected node before resolving any native/archive bytes. */
+function inspectionBinding(metadata, worker, runId) {
+	const mismatch = [], missing = [];
+	if (metadata.binding !== void 0 && !recordValue(metadata.binding)) mismatch.push("Capture Bridge binding is malformed");
+	if (metadata.source && metadata.binding) mismatch.push("Capture has conflicting source bindings");
+	const source = metadata.source ?? metadata.binding;
+	if (!source) return {
+		mismatch,
+		missing: ["Capture has no recorded node binding"]
+	};
+	const node = recordValue(source.node);
+	if (!node) {
+		if (source.node !== void 0) mismatch.push("Capture node binding is malformed");
+		else missing.push("Capture has no recorded node identity");
+	} else {
+		for (const [key, expected] of [
+			["rootId", runId],
+			["nodeId", worker.id],
+			["parentId", worker.parent]
+		]) if (expected !== void 0 && node[key] !== expected) mismatch.push(`Capture ${key} does not match selected node`);
+		const attempt = worker.executionBindings?.at(-1)?.attemptId;
+		if (typeof node.attemptId !== "string" || !node.attemptId) mismatch.push("Capture attempt identity is malformed");
+		else if (attempt && node.attemptId !== attempt) mismatch.push("Capture attempt does not match selected node");
+		else if (!attempt) missing.push("Selected node has no recorded execution attempt");
+		const identity = recordValue(node.identity);
+		for (const key of ["profileDigest", "taskDigest"]) {
+			const expected = worker.identity?.[key];
+			if (expected && identity?.[key] === void 0) missing.push(`Capture has no recorded ${key}`);
+			else if (expected && identity?.[key] !== expected) mismatch.push(`Capture ${key} does not match selected node`);
+		}
+	}
+	const materialization = worker.materialization;
+	if (materialization?.status !== "known") missing.push("Selected node has no known materialization");
+	else {
+		if (source.profileDigest !== materialization.effectiveProfileDigest) mismatch.push("Capture profile does not match selected materialization");
+		const execution = materialization.execution;
+		const kind = metadata.source ? "environment" : "session";
+		const id = metadata.source?.environmentId ?? metadata.binding?.sessionId;
+		if (execution.kind !== kind || execution.id !== id) mismatch.push("Capture execution does not match selected materialization");
+	}
+	if (metadata.binding && (metadata.binding.kind !== "bridge" || !metadata.binding.nativeSessionId || !metadata.binding.sessionId)) mismatch.push("Capture Bridge binding is malformed");
+	return {
+		mismatch,
+		missing
+	};
+}
+/** One selected-agent mapping for filesystem and API transports; no execution or I/O. */
+function topAgentWorker(run, workerId) {
+	const child = run.workers.find((worker) => worker.id === workerId);
+	if (child || run.id !== workerId) return child;
+	return {
+		id: run.id,
+		label: "root",
+		status: run.status === "cancelled" ? "cancelled" : ["done", "succeeded"].includes(run.status) ? "done" : ["down", "failed"].includes(run.status) ? "down" : "running",
+		startedAt: run.startedAt,
+		endedAt: run.completedAt,
+		latencyMs: run.totals.latencyMs,
+		spend: run.driverSpend,
+		metered: {
+			iterations: 0,
+			tokensInput: 0,
+			tokensOutput: 0,
+			usd: 0,
+			ms: 0
+		},
+		liveTail: run.progressTail
+	};
+}
+/** Metadata keeps full recorded context while the conversation can show compact attribution. */
+function topAgentMetadata(inspection, recorded) {
+	const { rows, ...metadata } = inspection ?? { coverage: {
+		status: "missing",
+		source: "Runtime",
+		reason: "Verified conversation inspection was not provided"
+	} };
+	return {
+		...metadata,
+		context: [
+			...metadata.context ?? [],
+			...recorded.filter((row) => row.event.provenance === "delegated-input"),
+			...(rows ?? []).filter((row) => row.event.provenance === "system-instructions")
+		]
+	};
+}
+/** Project selected conversation rows into ordered reset and row frames. */
+function createTopAgentStream(generation) {
+	let representation;
+	let initiatingInput;
+	const seen = /* @__PURE__ */ new Set();
+	let lastSeq = 0;
+	return {
+		reset: { generation },
+		frame({ recorded, inspection, alive, includeContext }) {
+			initiatingInput = recorded.find((row) => row.event.provenance === "delegated-input") ?? initiatingInput;
+			const input = initiatingInput?.event.text;
+			const task = input?.includes("\n") ? input.slice(input.indexOf("\n") + 1) : void 0;
+			const hasNativePrompt = !!task && !!inspection?.rows?.some((row) => row.event.kind === "user" && row.event.actor !== "injected" && row.event.text === task);
+			const shownInput = initiatingInput && hasNativePrompt && !includeContext ? {
+				...initiatingInput,
+				event: {
+					...initiatingInput.event,
+					text: input.slice(0, input.indexOf("\n")),
+					provenance: "recorded-sender"
+				}
+			} : initiatingInput;
+			const next = inspection?.rows?.length ? `capture:${inspection.coverage.ref ?? inspection.coverage.source}:${hasNativePrompt}` : "progress";
+			const frames = [];
+			if (representation !== void 0 && representation !== next) {
+				seen.clear();
+				lastSeq = 0;
+				generation += 1;
+				frames.push({
+					event: "reset",
+					data: { generation }
+				});
 			}
-		});
-		const result = runDir && node?.outRef && worker.endedAt ? await new FileResultBlobStore(join(runDir, "blobs")).get(node.outRef) : void 0;
-		if (result !== void 0) native.push({
-			at: worker.endedAt,
-			event: {
-				kind: "notice",
-				provenance: "recorded-result",
-				source: `result ${node.outRef}; Runtime FileResultBlobStore`,
-				text: typeof result === "string" ? result : JSON.stringify(result, null, 2)
+			representation = next;
+			const events = (inspection?.rows?.length ? [
+				...shownInput ? [shownInput] : [],
+				...recorded.filter((row) => inspection.coverage.status !== "complete" && row.event.provenance === "recorded-result"),
+				...inspection.rows.filter((row) => includeContext || row.event.provenance !== "system-instructions")
+			] : recorded).flatMap((row) => {
+				const key = "id" in row && typeof row.id === "string" ? row.id : createHash("sha256").update(JSON.stringify(row)).digest("hex");
+				if (seen.has(key)) return [];
+				seen.add(key);
+				if (next === "progress" && seen.size > 2e3) seen.delete(seen.values().next().value);
+				return [{
+					...row,
+					seq: ++lastSeq
+				}];
+			});
+			for (let offset = 0; offset < Math.max(events.length, 1); offset += 100) {
+				const batch = events.slice(offset, offset + 100);
+				frames.push({
+					event: "rows",
+					data: {
+						generation,
+						events: batch,
+						lastSeq: batch.at(-1)?.seq ?? lastSeq,
+						alive,
+						window: inspection?.coverage.status === "complete" ? "verified-native" : "recorded-tail",
+						...inspection ? { coverage: inspection.coverage } : {}
+					}
+				});
 			}
-		});
-		return [...rows, ...native];
-	}
-	return [...rows, ...transcriptRows({ liveTail: readTranscriptTail(worker.eventFile) })];
+			return frames;
+		}
+	};
 }
-/**
-* A settled worker's retained Router conversation as progress lines, for an executor that ran its
-* tool loop in process and so streamed nothing. The messages carry no times; each takes the
-* worker's settlement time. Other harnesses' session files have their own formats and stay unread.
-*/
-async function retainedTranscriptLines(worker, runDir) {
-	const at = worker.endedAt;
-	if (worker.transcript?.harness !== "router" || at === void 0) return [];
-	return ((await new FileResultBlobStore(join(runDir, "blobs")).get(worker.transcript.ref))?.files ?? []).flatMap((file) => (typeof file.content === "string" ? file.content.split("\n") : []).flatMap((text) => {
-		try {
-			const message = recordValue(JSON.parse(text));
-			return message?.role === "assistant" || message?.role === "tool" ? [JSON.stringify({
-				at,
-				message
-			})] : [];
-		} catch {
-			return [];
+/** Router records are Runtime's canonical ToolLoopMessageRecord, not a native file heuristic. */
+async function retainedRouterInspection(worker, runDir) {
+	const evidence = worker.harnessTranscript;
+	if (!runDir || evidence?.status !== "available" || evidence.harness !== "router" || !worker.endedAt) return void 0;
+	const artifact = await harnessTranscriptArtifact(evidence, new FileResultBlobStore(join(runDir, "blobs")));
+	if (!artifact || !("files" in artifact)) return void 0;
+	const rows = artifact.files.flatMap((file) => "content" in file ? file.content.split("\n").filter(Boolean).map((line) => recordValue(JSON.parse(line))).filter((row) => row && typeof row.role === "string") : []).flatMap((message, index) => transcriptRows({ liveTail: [JSON.stringify({
+		at: worker.endedAt,
+		message
+	})] }).map((row, part) => ({
+		...row,
+		id: JSON.stringify([
+			evidence.transcriptRef,
+			index,
+			part
+		]),
+		sessionId: `router:${worker.id}`,
+		part,
+		event: {
+			...row.event,
+			provenance: "router-transcript",
+			source: "Message time unknown; shown at captured settlement time"
+		}
+	})));
+	return {
+		coverage: {
+			status: "partial",
+			source: "Runtime Router conversation, displayed at recorded settlement time",
+			reason: "Per-message times were not captured",
+			ref: `urn:${evidence.transcriptRef}`
+		},
+		rows,
+		files: {
+			scope: "none",
+			complete: true,
+			reason: "This in-process conversation has no sandbox workspace inventory",
+			entries: []
 		}
-	}));
+	};
 }
 /** Present the recorded tail through sandbox-ui's existing agent-stream contract. */
 function transcriptRows(worker) {
@@ -106,12 +331,17 @@ function transcriptRows(worker) {
 				...event,
 				kind
 			});
-			continue;
 		}
+		if (event?.kind) continue;
+		const legacy = (event) => push({
+			...event,
+			provenance: "unverified-progress",
+			source: "Legacy progress only; full capture is unverified"
+		});
 		const message = recordValue(value?.message);
 		if (!message) continue;
 		if (message.role === "tool") {
-			push({
+			legacy({
 				kind: "tool-result",
 				toolCallId: String(message.tool_call_id),
 				result: message.content
@@ -120,7 +350,7 @@ function transcriptRows(worker) {
 		}
 		for (const item of Array.isArray(message.tool_calls) ? message.tool_calls : []) {
 			const call = recordValue(item), fn = recordValue(call?.function);
-			if (call && fn) push({
+			if (call && fn) legacy({
 				kind: "tool-call",
 				toolCallId: String(call.id),
 				toolName: String(fn.name),
@@ -133,21 +363,21 @@ function transcriptRows(worker) {
 		}] : Array.isArray(message.content) ? message.content : [];
 		for (const part of parts) {
 			if (!recordValue(part)) continue;
-			if (part.type === "text" && typeof part.text === "string") push({
+			if (part.type === "text" && typeof part.text === "string" && part.text.length > 0) legacy({
 				kind: message.role === "user" ? "user" : "text",
 				text: part.text
 			});
-			else if (part.type === "thinking" && typeof part.thinking === "string") push({
+			else if (part.type === "thinking" && typeof part.thinking === "string") legacy({
 				kind: "reasoning",
 				text: part.thinking
 			});
-			else if (part.type === "tool_use") push({
+			else if (part.type === "tool_use") legacy({
 				kind: "tool-call",
 				toolCallId: String(part.id),
 				toolName: String(part.name),
 				args: part.input
 			});
-			else if (part.type === "tool_result") push({
+			else if (part.type === "tool_result") legacy({
 				kind: "tool-result",
 				toolCallId: String(part.tool_use_id),
 				result: part.content
@@ -176,6 +406,9 @@ const activityKinds = /* @__PURE__ */ new Set([
 	"interaction",
 	"child_task"
 ]);
+function recordedActivity(line) {
+	return transcriptRows({ liveTail: [line] }).find((row) => activityKinds.has(row.event.kind));
+}
 /** Read appended UTF-8 bytes once; complete EOF JSON follows the durable reader contract. */
 function readRecordedEvents(file, maxLines = 8) {
 	const fd = openSync(file, "r");
@@ -215,7 +448,7 @@ function readRecordedEvents(file, maxLines = 8) {
 				if (!line.trim()) continue;
 				lines.push(line);
 				if (lines.length > 200) lines.shift();
-				const activity = transcriptRows({ liveTail: [line] }).find((row) => activityKinds.has(row.event.kind));
+				const activity = recordedActivity(line);
 				if (activity) cursor.times.push(Date.parse(activity.at));
 			}
 		}
@@ -225,7 +458,7 @@ function readRecordedEvents(file, maxLines = 8) {
 			JSON.parse(cursor.pending);
 			pending = [cursor.pending];
 		} catch {}
-		const final = transcriptRows({ liveTail: pending }).find((row) => activityKinds.has(row.event.kind));
+		const final = pending.length ? recordedActivity(pending[0]) : void 0;
 		const times = (final ? [...cursor.times, Date.parse(final.at)] : cursor.times).sort((a, b) => a - b);
 		const gaps = times.slice(1).map((at, i) => at - times[i]).sort((a, b) => a - b);
 		const mid = Math.floor(gaps.length / 2);
@@ -283,6 +516,110 @@ function readWorkerEventTails(dir) {
 		diagnostics
 	};
 }
+/** One ordered projection for every strict native reader, with explicit unrenderable evidence. */
+function harnessSessionRows(sessions) {
+	const rows = [];
+	const gaps = [];
+	for (const session of sessions) {
+		const emitted = /* @__PURE__ */ new Set();
+		const push = (recordId, part, value, event) => {
+			if (!value || !Number.isFinite(Date.parse(value))) {
+				gaps.push({
+					sessionId: session.nativeSessionId,
+					recordId,
+					reason: "Native record has no valid recorded time"
+				});
+				return;
+			}
+			rows.push({
+				id: JSON.stringify([
+					session.nativeSessionId,
+					event.kind,
+					recordId,
+					part
+				]),
+				sessionId: session.nativeSessionId,
+				part,
+				at: new Date(value).toISOString(),
+				event: event.actor === "injected" ? {
+					...event,
+					provenance: "system-instructions"
+				} : event
+			});
+		};
+		const tool = (id, result, at, recordId = id, part = 0, actor) => {
+			const call = session.toolCalls.find((item) => item.id === id);
+			if (!call || result && !call.result) {
+				gaps.push({
+					sessionId: session.nativeSessionId,
+					recordId: id,
+					reason: "Referenced tool evidence is missing"
+				});
+				return;
+			}
+			const key = `${result ? "result" : "call"}:${id}`;
+			if (emitted.has(key)) return;
+			emitted.add(key);
+			const toolCallId = `${session.nativeSessionId}:${id}`;
+			push(recordId, part, at ?? (result ? call.endedAt : call.startedAt), result ? {
+				kind: "tool-result",
+				toolCallId,
+				result: call.result?.output ?? call.result?.text,
+				actor,
+				...actor ? { source: `Native actor ${actor}` } : {}
+			} : {
+				kind: "tool-call",
+				toolCallId,
+				toolName: call.name,
+				args: call.input ?? call.inputText,
+				actor,
+				...actor ? { source: `Native actor ${actor}` } : {}
+			});
+		};
+		for (const message of session.messages) for (const [part, value] of message.parts.entries()) if (value.type === "tool-call" || value.type === "tool-result") tool(value.toolCallId ?? "", value.type === "tool-result", message.at, message.id, part, message.actor);
+		else if ((value.type === "text" || value.type === "reasoning") && value.text) push(message.id, part, message.at, {
+			kind: value.type === "reasoning" ? "reasoning" : message.role === "user" ? "user" : message.role === "assistant" ? "text" : "notice",
+			text: value.text,
+			actor: message.actor,
+			...message.actor ? { source: `Native actor ${message.actor}` } : {},
+			...![
+				"user",
+				"assistant",
+				"tool"
+			].includes(message.role) ? {
+				provenance: "system-instructions",
+				source: message.role
+			} : {}
+		});
+		else if (value.type !== "text" && value.type !== "reasoning") gaps.push({
+			sessionId: session.nativeSessionId,
+			recordId: message.id,
+			reason: `Native ${value.type} content is retained but not projected inline`
+		});
+		for (const call of session.toolCalls) {
+			if (!emitted.has(`call:${call.id}`)) {
+				gaps.push({
+					sessionId: session.nativeSessionId,
+					recordId: call.id,
+					reason: "Tool call has no ordered message-part reference"
+				});
+				tool(call.id, false);
+			}
+			if (call.result && !emitted.has(`result:${call.id}`)) {
+				gaps.push({
+					sessionId: session.nativeSessionId,
+					recordId: call.id,
+					reason: "Tool result has no ordered message-part reference"
+				});
+				tool(call.id, true);
+			}
+		}
+	}
+	return {
+		rows: rows.sort((a, b) => a.at.localeCompare(b.at)),
+		gaps
+	};
+}
 // src/tui/workflow-journal.ts
 /** Native workflows have no Runtime accounting. Translate recorded lifecycle only. */
 function workflowJournal(runDir, text) {
@@ -437,6 +774,7 @@ function loadTopSnapshot(rootDir, input = Date.now()) {
 	supervisors.sort((a, b) => String(b.startedAt ?? "").localeCompare(String(a.startedAt ?? "")));
 	return topSnapshot(root, now, supervisors, diagnostics, discovered);
 }
+/** Combine supervisor projections and source diagnostics into one snapshot. */
 function topSnapshot(root, now, supervisors, diagnostics = [], discovered = 1, pursuit) {
 	return {
 		root,
@@ -602,13 +940,14 @@ function retainedTranscript(event) {
 function recordedReason(event) {
 	return isRecord(event) && typeof event.reason === "string" ? event.reason : void 0;
 }
+/** Project committed lifecycle and spend evidence into one supervisor view. */
 function buildSupervisorView(state, stateDir, events, progressTail, now, workerEventTails = /* @__PURE__ */ new Map(), accounting) {
 	const workers = /* @__PURE__ */ new Map();
 	let driverSpend = emptySpend;
 	const journalRootId = events.find((event) => event.kind === "spawned" && !event.parent && event.label === "root")?.id;
 	const isRoot = (id) => id === state.id || id === journalRootId;
 	const terminal = accounting ? void 0 : events.filter((event) => isRoot(event.id) && (event.kind === "settled" || event.kind === "cancelled")).at(-1);
-	const rootReason = recordedReason(terminal);
+	const rootReason = recordedReason(terminal) ?? state.reason;
 	for (const event of events) {
 		if (isRoot(event.id) || event.kind === "spawned" && !event.parent && event.label === "root") {
 			if (event.kind === "metered" && event.accountingOnly !== true) driverSpend = addSpend(driverSpend, parseSpend(event.spend));
@@ -616,20 +955,33 @@ function buildSupervisorView(state, stateDir, events, progressTail, now, workerE
 		}
 		const worker = ensureWorker(workers, event.id);
 		if (event.kind === "spawned") {
+			for (const key of [
+				"endedAt",
+				"outRef",
+				"harnessTranscript",
+				"transcript",
+				"reason",
+				"infra",
+				"verdict"
+			]) delete worker[key];
 			worker.label = event.label ?? worker.label;
+			if (event.identity) worker.identity = event.identity;
 			if (event.parent) worker.parent = event.parent;
 			if (event.runtime) worker.runtime = event.runtime;
 			worker.status = "running";
 			if (event.at) worker.startedAt = event.at;
 			const budget = parseBudget(event.budget);
 			if (budget) worker.budget = budget;
-		} else if (event.kind === "settled" || event.kind === "cancelled") {
+		} else if (event.kind === "materialized" || event.kind === "seat-materialized") worker.materialization = event.receipt;
+		else if (event.kind === "execution-bound") worker.executionBindings = [...worker.executionBindings ?? [], event.binding];
+		else if (event.kind === "settled" || event.kind === "cancelled") {
 			if (event.at) worker.endedAt = event.at;
 			const reason = recordedReason(event);
 			if (reason !== void 0) worker.reason = reason;
 			if (event.kind === "settled") {
 				worker.status = event.status === "down" ? "down" : "done";
 				if (event.outRef) worker.outRef = event.outRef;
+				if (event.harnessTranscript) worker.harnessTranscript = event.harnessTranscript;
 				const transcript = retainedTranscript(event);
 				if (transcript) worker.transcript = transcript;
 				if (event.infra !== void 0) worker.infra = event.infra;
@@ -641,7 +993,7 @@ function buildSupervisorView(state, stateDir, events, progressTail, now, workerE
 				worker.metered = emptySpend;
 			}
 		} else if (event.kind === "progress") worker.metered = parseSpend(event.spend);
-		else if (event.accountingOnly !== true) worker.metered = addSpend(worker.metered, parseSpend(event.spend));
+		else if (event.kind === "metered" && event.accountingOnly !== true) worker.metered = addSpend(worker.metered, parseSpend(event.spend));
 	}
 	if (accounting) {
 		driverSpend = observerSpend(accounting.totals.exclusiveByNode[accounting.runId]);
@@ -892,13 +1244,17 @@ function isSupervisorState(value) {
 		"workspaceDir"
 	].every((key) => typeof value[key] === "string") && typeof value.budget === "number";
 }
+/** Validate supported journal lifecycle and accounting event shapes. */
 function isSpawnEvent(value) {
 	return isRecord(value) && typeof value.id === "string" && typeof value.kind === "string" && [
 		"spawned",
 		"settled",
 		"cancelled",
 		"metered",
-		"progress"
+		"progress",
+		"materialized",
+		"seat-materialized",
+		"execution-bound"
 	].includes(value.kind);
 }
 function isDirectory(path) {
@@ -919,7 +1275,122 @@ function parseTime(value) {
 function sum(values) {
 	return values.reduce((total, value) => total + value, 0);
 }
+// src/tui/top-web-agent.ts
+const SOURCE_READ_TIMEOUT_MS = 3e4;
+/** Selected reads share the web server's origin, method and lifecycle boundary. */
+async function serveTopAgent({ request, response, path, base, roots, snapshots, transcripts, source, readSessions }) {
+	const [, , , , rootIndex, runId, workerId] = path.split("/").map(decodeURIComponent);
+	const root = roots[Number(rootIndex)];
+	const run = root && snapshots.get(root)?.supervisors.find((entry) => entry.id === runId);
+	const safeId = (id) => !!id && /^[a-z0-9_.:-]+$/i.test(id) && id !== "." && id !== "..";
+	if (!safeId(runId) || !safeId(workerId) || !run || !run.workers.some((entry) => entry.id === workerId) && run.id !== workerId) {
+		response.writeHead(404).end();
+		return;
+	}
+	const own = root && existsSync(resolve(root, runId, "observer.jsonl")) ? resolve(root, runId) : void 0;
+	const runDir = own ?? root;
+	const pursuit = own ? (await loadTopSnapshot(root, { runDir: own })).pursuit : root ? snapshots.get(root)?.pursuit : void 0;
+	const worker = () => {
+		const run = root ? snapshots.get(root)?.supervisors.find((run) => run.id === runId) : void 0;
+		const node = run && topAgentWorker(run, workerId);
+		return node && node.id === run?.id && existsSync(resolve(runDir, "root-stream.jsonl")) ? {
+			...node,
+			eventFile: resolve(runDir, "root-stream.jsonl")
+		} : node;
+	};
+	if (!worker()) {
+		response.writeHead(404).end();
+		return;
+	}
+	const controller = new AbortController();
+	response.on("close", () => controller.abort());
+	const readSource = async () => {
+		const deadline = new AbortController();
+		const linked = linkAbort(controller.signal, deadline.signal);
+		const timer = setTimeout(() => deadline.abort("Inspection source read exceeded its deadline"), SOURCE_READ_TIMEOUT_MS);
+		timer.unref();
+		try {
+			const result = await runAbortable(() => source ? source({
+				root: runDir,
+				runId,
+				workerId,
+				signal: linked.signal
+			}) : readSessions ? readTopAgentInspection({
+				worker: worker(),
+				runId,
+				blobs: new FileResultBlobStore(join(runDir, "blobs")),
+				readSessions,
+				signal: linked.signal
+			}) : retainedRouterInspection(worker(), runDir), linked.signal, "Inspection read stopped");
+			return result?.coverage.status === "complete" && !result.rows?.length ? {
+				...result,
+				coverage: {
+					...result.coverage,
+					status: "partial",
+					reason: "No verified native conversation rows were supplied"
+				}
+			} : result;
+		} finally {
+			clearTimeout(timer);
+			linked.release();
+		}
+	};
+	let history = await transcriptHistory(worker(), runDir, pursuit?.nodes.find((node) => node.runId === runId && node.id === workerId));
+	if (!path.endsWith("/stream")) {
+		const inspection = await readSource();
+		response.writeHead(200, { "Content-Type": "application/json" });
+		response.end(request.method === "HEAD" ? void 0 : JSON.stringify(topAgentMetadata(inspection, history ?? [])));
+		return;
+	}
+	response.writeHead(200, {
+		"Content-Type": "text/event-stream",
+		"X-Accel-Buffering": "no"
+	});
+	response.flushHeaders();
+	if (request.method === "HEAD") {
+		response.end();
+		return;
+	}
+	const stream = createTopAgentStream(Date.now());
+	response.write(`event: reset\ndata: ${JSON.stringify(stream.reset)}\n\n`);
+	let updating = false;
+	const update = () => {
+		if (updating || response.destroyed || response.writableEnded) return;
+		updating = true;
+		(async () => {
+			const node = worker();
+			if (!node || response.writableLength > 1048576) {
+				response.destroy();
+				return;
+			}
+			const inspection = await readSource();
+			const recorded = history ?? transcriptTail(node);
+			history = void 0;
+			const alive = node.status === "running";
+			const frames = stream.frame({
+				recorded,
+				inspection,
+				alive,
+				includeContext: new URL(request.url ?? "/", base).searchParams.get("context") === "1"
+			});
+			for (const frame of frames) if (!response.write(`event: ${frame.event}\ndata: ${JSON.stringify(frame.data)}\n\n`)) await once(response, "drain", { signal: controller.signal });
+			if (!alive) {
+				response.write("event: end\ndata: {}\n\n");
+				response.end();
+			}
+		})().catch(() => {
+			if (!response.destroyed) response.end("event: unavailable\ndata: {}\n\n");
+		}).finally(() => {
+			updating = false;
+		});
+	};
+	transcripts.add(update);
+	response.on("close", () => transcripts.delete(update));
+	update();
+}
 // src/tui/top-web.ts
+/** Interval for reconciling missed filesystem notifications in the live viewer. */
+const TOP_SNAPSHOT_RECONCILE_MS = 500;
 /** Read-only web transport over the same snapshots as the terminal. No execution or writes. */
 async function serveTopWeb(options) {
 	if (!options.roots.length) throw new Error("At least one --root is required");
@@ -1035,87 +1506,18 @@ async function serveTopWeb(options) {
 					snapshots: [...snapshots.values()]
 				});
 				response.on("close", () => clients.delete(response));
-			} else if (/^\/api\/top\/agents\/\d+\/[^/]+\/[^/]+\/stream$/.test(path)) {
-				const [, , , , rootIndex, runId, workerId] = path.split("/").map(decodeURIComponent);
-				const root = roots[Number(rootIndex)];
-				const own = root && existsSync(resolve(root, runId, "observer.jsonl")) ? resolve(root, runId) : void 0;
-				const runDir = own ?? root;
-				const pursuit = own ? (await loadTopSnapshot(root, { runDir: own })).pursuit : root ? snapshots.get(root)?.pursuit : void 0;
-				const worker = () => {
-					const run = root ? snapshots.get(root)?.supervisors.find((run) => run.id === runId) : void 0;
-					const node = run?.workers.find((node) => node.id === workerId);
-					if (node || !run || run.id !== workerId) return node;
-					return {
-						id: run.id,
-						label: "root",
-						...runDir && existsSync(resolve(runDir, "root-stream.jsonl")) ? { eventFile: resolve(runDir, "root-stream.jsonl") } : {},
-						status: run.status === "cancelled" ? "cancelled" : run.status === "done" ? "done" : run.status === "down" ? "down" : "running",
-						startedAt: run.startedAt,
-						endedAt: run.completedAt,
-						latencyMs: run.totals.latencyMs,
-						spend: run.driverSpend,
-						metered: {
-							iterations: 0,
-							tokensInput: 0,
-							tokensOutput: 0,
-							usd: 0,
-							ms: 0
-						},
-						liveTail: run.progressTail
-					};
-				};
-				if (!worker()) {
-					response.writeHead(404).end();
-					return;
-				}
-				let history = await transcriptHistory(worker(), runDir, pursuit?.nodes.find((node) => node.runId === runId && node.id === workerId));
-				response.writeHead(200, {
-					"Content-Type": "text/event-stream",
-					"X-Accel-Buffering": "no"
-				});
-				response.flushHeaders();
-				if (request.method === "HEAD") {
-					response.end();
-					return;
-				}
-				const generation = Date.now();
-				response.write(`event: reset\ndata: ${JSON.stringify({ generation })}\n\n`);
-				const seen = /* @__PURE__ */ new Set();
-				let lastSeq = 0;
-				const update = () => {
-					const node = worker();
-					if (!node || response.writableLength > 1048576) {
-						response.destroy();
-						return;
-					}
-					const events = (history ?? transcriptTail(node)).flatMap((row) => {
-						const key = createHash("sha256").update(JSON.stringify(row)).digest("hex");
-						if (seen.has(key)) return [];
-						seen.add(key);
-						if (seen.size > 2e3) seen.delete(seen.values().next().value);
-						return [{
-							...row,
-							seq: ++lastSeq
-						}];
-					});
-					history = void 0;
-					const alive = node.status === "running";
-					response.write(`event: rows\ndata: ${JSON.stringify({
-						generation,
-						events,
-						lastSeq,
-						alive,
-						window: "recorded-tail"
-					})}\n\n`);
-					if (!alive) {
-						response.write("event: end\ndata: {}\n\n");
-						response.end();
-					}
-				};
-				transcripts.add(update);
-				response.on("close", () => transcripts.delete(update));
-				update();
-			} else if (path === "/api/top") {
+			} else if (/^\/api\/top\/agents\/\d+\/[^/]+\/[^/]+(?:\/stream)?$/.test(path)) await serveTopAgent({
+				request,
+				response,
+				path,
+				base,
+				roots,
+				snapshots,
+				transcripts,
+				source: options.source,
+				readSessions: options.readSessions
+			});
+			else if (path === "/api/top") {
 				response.writeHead(200, { "Content-Type": "application/json" });
 				response.end(JSON.stringify({
 					sequence,
@@ -1230,6 +1632,6 @@ async function loadRunsRoot(root) {
 		loaded: supervisors.length
 	};
 }
-export { numberValue as a, totalSpend as c, loadTopSnapshot as i, serveTopWeb as n, parseSpend as o, aggregateSnapshot as r, parseTime as s, runTopWeb as t };
+export { topAgentMetadata as _, buildSupervisorView as a, numberValue as c, topSnapshot as d, totalSpend as f, readTopAgentInspection as g, readTopAgentHistory as h, aggregateSnapshot as i, parseSpend as l, harnessSessionRows as m, runTopWeb as n, isSpawnEvent as o, createTopAgentStream as p, serveTopWeb as r, loadTopSnapshot as s, TOP_SNAPSHOT_RECONCILE_MS as t, parseTime as u, topAgentWorker as v };
 
-//# sourceMappingURL=top-web-DK6lTMHG.js.map
+//# sourceMappingURL=top-web-DRfER2jW.js.map