pi-cockpit 0.8.0 → 0.9.1

package/README.md

@@ -2,7 +2,7 @@
 
 A responsive **agent cockpit** for [Pi](https://pi.dev): wide terminals get a docked Maestro operations sidebar, narrow terminals automatically fall back to the existing Todo and Agent widgets, and every layout keeps the Starship-style footer.
 
-It is the third plugin of the `pi-maestro-flow` project (alongside `pi-maestro-flow` and `pi-maestro-teammate`). It is installed and registered with `pi-maestro-flow`, but it also runs standalone. Current version: **0.8.0**.
+It is the third plugin of the `pi-maestro-flow` project (alongside `pi-maestro-flow` and `pi-maestro-teammate`). It is installed and registered with `pi-maestro-flow`, but it also runs standalone. Current version: **0.9.1**.
 
 The dock is a non-capturing top-right overlay. Cockpit reserves its columns by wrapping the active TUI renderer at runtime, so the Pi workspace reflows instead of rendering underneath it. No Pi source files are modified.
 
@@ -25,7 +25,7 @@ The dock is a non-capturing top-right overlay. Cockpit reserves its columns by w
 `pi-cockpit` comes automatically with the orchestration layer — installing `pi-maestro-flow` pulls `pi-cockpit` and registers it into `settings.packages` on postinstall, no manual setup required. To use it on its own:
 
 ```bash
-pi install npm:pi-cockpit     # standalone from npm
+pi install npm:pi-cockpit@0.9.1     # standalone from npm
 # or, for one run:
 pi -e ./packages/pi-cockpit
 ```
@@ -104,7 +104,7 @@ Cockpit has no package dependency on `pi-maestro-flow`. It observes optional pro
 - `title.showGit`: include the git branch tag (`git:main`, `git:detached`); read synchronously from `.git/HEAD`, so it costs no process spawn. Off by default.
 - `title.showMaestro`: include the Maestro workflow status tag (`wf:running`, `wf:done`). Off by default.
 - `title.maxLength`: hard cap on the composed title; the middle is ellided to keep the head and the working-state tail. Clamped to `20..200`; default `80`.
-- `title.generationModel`: `"provider/model"` (e.g. `"maestro-qwen/qwen3.8-max-preview"`) of a model registered with the `/api-manager` command (or any other provider pi resolves). When set, the session title is generated by that model over the first completed turn (user prompt + assistant reply) through its OpenAI-compatible endpoint, with a 10s timeout. Empty (default) uses the offline rule-based extractor instead. Generation is best-effort — on any failure the title silently falls back to the rule-based one.
+- `title.generationModel`: `"provider/model"` (e.g. `"maestro-qwen/qwen3.8-max-preview"`) of a model registered with the `/api-manager` command (or any other provider pi resolves). When set, the session title is generated by that model over the first completed turn (user prompt + assistant reply) through its OpenAI-compatible endpoint, with a 10s timeout. Empty (default) uses the offline rule-based extractor instead. Generation is best-effort — on any failure the title silently falls back to the rule-based one. Editable from the `/cockpit` settings overlay (`z` or cursor to the `title gen model` row, Enter, type, Enter to save; empty clears back to rule-based).
 
 The tab title is `frame + pi - <session> - <working state>`. The session part follows Claude Code's chain (`sessionTitle ?? agentTitle ?? haikuTitle ?? default`): the `/session name` title wins, otherwise the generated title, otherwise a short session id. The frame is Claude Code's title chrome: `⠂`/`⠐` braille spinner while a turn runs, static `✳` when idle; failure replaces it with `✗`. On quit, Cockpit clears the title so no stale tab label lingers (Claude Code's `CLEAR_TERMINAL_TITLE`).
 - `theme`: named theme override; empty string follows the Pi session theme.
@@ -112,6 +112,8 @@ The tab title is `frame + pi - <session> - <working state>`. The session part fo
 ## Commands
 
 - `/cockpit` — opens the settings overlay.
+- `/maestro-settings` — opens the unified settings shell (Cockpit, Flow, Teammate and integrations).
+- `Alt+J` — opens the background Bash jobs overlay (live status, command, cwd, duration, output tail).
 - `/cockpit sidebar` — reports the current sidebar mode, width, and density.
 - `/cockpit sidebar auto|on|off` — selects dock behavior.
 - `/cockpit sidebar resize` or `Ctrl+Shift+R` — enters temporary Resize mode. Left/Right adjusts one column, Shift+Left/Shift+Right adjusts four, Enter accepts, and Escape rolls back. Mouse reporting is active only during Resize mode.
@@ -120,7 +122,7 @@ The tab title is `frame + pi - <session> - <working state>`. The session part fo
 
 ## Sidebar compatibility
 
-The split-pane wrapper depends on Pi's current TUI renderer shape and is verified against Pi `0.82.1`. A render integration failure disables the split and retries the original renderer at full width.
+The split-pane wrapper depends on Pi's current TUI renderer shape and is verified against Pi `0.83.0`. A render integration failure disables the split and retries the original renderer at full width.
 
 Do not enable `pi-cockpit`'s dock and `pi-atelier@0.7.0`'s sidebar together. Both reserve columns by wrapping the same renderer, and `pi-atelier@0.7.0` does not participate in Cockpit's split-owner marker protocol. Use `"sidebar": { "mode": "off" }` when running Atelier.
 

package/package.json

@@ -1,75 +1,80 @@
 {
-  "name": "pi-cockpit",
-  "version": "0.8.0",
-  "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
-  "type": "module",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "tui",
-    "teammate",
-    "todo"
-  ],
-  "license": "MIT",
-  "files": [
-    "src/",
-    "themes/",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node --test --experimental-transform-types tests/config.test.ts tests/public-events.test.ts tests/maestro-store.test.ts tests/split-pane.test.ts tests/editor-bottom.test.ts tests/sidebar-render.test.ts tests/sidebar-controller.test.ts tests/viewport-stability.test.ts tests/quiet-tools.test.ts tests/agents-store.test.ts tests/bash-bg-store.test.ts tests/bash-bg-widget.test.ts tests/bash-bg-overlay.test.ts tests/todo-store.test.ts tests/render.test.ts tests/footer.test.ts tests/extension-status.test.ts tests/integration-contract.test.ts tests/stack-widget.test.ts tests/settings-view.test.ts tests/thinking-fold.test.ts tests/thinking-timer.test.ts tests/tick-policy.test.ts tests/ambient.test.ts tests/viewport.test.ts tests/theme-picker.test.ts tests/title-gen.test.ts tests/title-llm.test.ts tests/settings-registry.test.ts tests/settings-coordinator.test.ts tests/settings-locale.test.ts tests/settings-shell.test.ts tests/settings-cockpit-provider.test.ts tests/settings-cross-package.test.ts",
-    "typecheck": "tsc --noEmit"
-  },
-  "pi": {
-    "extensions": [
-      "./src/extension/index.ts"
-    ],
-    "themes": [
-      "./themes"
-    ]
-  },
-  "dependencies": {
-    "pi-maestro-settings-core": "0.1.0",
-    "proper-lockfile": "4.1.2"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-agent-core": "*",
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
-    "pi-maestro-teammate": "^1.6.0"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-agent-core": {
-      "optional": true
-    },
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "pi-maestro-teammate": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.83.0",
-    "@earendil-works/pi-ai": "0.83.0",
-    "@earendil-works/pi-coding-agent": "0.83.0",
-    "@earendil-works/pi-tui": "0.83.0",
-    "@types/node": "^22.0.0",
-    "pi-maestro-teammate": "1.6.0",
-    "typescript": "^5.5.0"
-  },
-  "main": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./v1/events": "./src/public/v1/events.ts",
-    "./src/*": "./src/*"
-  }
+	"name": "pi-cockpit",
+	"version": "0.9.1",
+	"description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
+	"type": "module",
+	"keywords": [
+		"pi-package",
+		"pi",
+		"pi-extension",
+		"tui",
+		"teammate",
+		"todo"
+	],
+	"license": "MIT",
+	"files": [
+		"src/",
+		"themes/",
+		"README.md"
+	],
+	"scripts": {
+		"test": "node --test --experimental-transform-types tests/config.test.ts tests/public-events.test.ts tests/maestro-store.test.ts tests/split-pane.test.ts tests/editor-bottom.test.ts tests/sidebar-render.test.ts tests/sidebar-controller.test.ts tests/viewport-stability.test.ts tests/quiet-tools.test.ts tests/edit-guard.test.ts tests/agents-store.test.ts tests/supervision-store.test.ts tests/bash-bg-store.test.ts tests/bash-bg-widget.test.ts tests/bash-bg-overlay.test.ts tests/todo-store.test.ts tests/render.test.ts tests/agent-scroll.test.ts tests/session-bar.test.ts tests/session-detail.test.ts tests/footer.test.ts tests/extension-status.test.ts tests/input-routing.test.ts tests/integration-contract.test.ts tests/stack-widget.test.ts tests/settings-view.test.ts tests/thinking-fold.test.ts tests/thinking-timer.test.ts tests/tick-policy.test.ts tests/ambient.test.ts tests/viewport.test.ts tests/theme-picker.test.ts tests/model-picker.test.ts tests/title-gen.test.ts tests/title-llm.test.ts tests/settings-registry.test.ts tests/settings-coordinator.test.ts tests/settings-locale.test.ts tests/settings-shell.test.ts tests/settings-cockpit-provider.test.ts tests/settings-cross-package.test.ts tests/ui-primitives.test.ts tests/settings-shell-secret.test.ts tests/settings-shell-listcrud.test.ts",
+		"typecheck": "tsc --noEmit"
+	},
+	"pi": {
+		"extensions": [
+			"./src/extension/index.ts"
+		],
+		"themes": [
+			"./themes"
+		]
+	},
+	"dependencies": {
+		"pi-maestro-settings-core": "0.1.0",
+		"proper-lockfile": "4.1.2"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-agent-core": "*",
+		"@earendil-works/pi-ai": "*",
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
+		"pi-maestro-teammate": "^1.6.0",
+		"typebox": "*"
+	},
+	"peerDependenciesMeta": {
+		"@earendil-works/pi-agent-core": {
+			"optional": true
+		},
+		"@earendil-works/pi-ai": {
+			"optional": true
+		},
+		"@earendil-works/pi-coding-agent": {
+			"optional": true
+		},
+		"@earendil-works/pi-tui": {
+			"optional": true
+		},
+		"pi-maestro-teammate": {
+			"optional": true
+		},
+		"typebox": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@earendil-works/pi-agent-core": "0.83.0",
+		"@earendil-works/pi-ai": "0.83.0",
+		"@earendil-works/pi-coding-agent": "0.83.0",
+		"@earendil-works/pi-tui": "0.83.0",
+		"@types/node": "^22.0.0",
+		"pi-maestro-teammate": "1.7.1",
+		"typebox": "1.3.7",
+		"typescript": "^5.5.0"
+	},
+	"main": "./src/index.ts",
+	"exports": {
+		".": "./src/index.ts",
+		"./v1/events": "./src/public/v1/events.ts",
+		"./src/*": "./src/*"
+	}
 }

package/src/agent-scroll.ts

@@ -0,0 +1,64 @@
+/**
+ * Agent-list scroll window.
+ *
+ * The below-input agent list is bounded by the terminal height. It follows the
+ * newest activity by default (auto-scroll as agents stream); Shift+↑/Shift+↓
+ * (with an empty composer, via a cockpit terminal-input hook) scroll up/down
+ * through the whole roster. Scrolling up pauses follow; reaching the bottom
+ * resumes it. Pure state math, no UI dependencies.
+ */
+
+import { panelRows } from "./viewport.ts";
+
+export interface AgentScrollState {
+	/** Window start over the activity-ordered roster. */
+	offset: number;
+	/** When true the window tracks the newest rows (auto-scroll). */
+	following: boolean;
+}
+
+/** Window start for a state; follow pins the window to the newest rows. */
+export function scrollWindowStart(total: number, budget: number, state: AgentScrollState): number {
+	if (total <= budget) return 0;
+	if (state.following) return total - budget;
+	return Math.max(0, Math.min(state.offset, total - budget));
+}
+
+/** Move the window by `delta` rows; reaching the bottom resumes follow. */
+export function scrollBy(
+	state: AgentScrollState,
+	delta: number,
+	total: number,
+	budget: number,
+): AgentScrollState {
+	if (total <= budget) return { offset: 0, following: true };
+	const start = scrollWindowStart(total, budget, state);
+	const next = Math.max(0, Math.min(start + delta, total - budget));
+	return { offset: next, following: next >= total - budget };
+}
+
+/** Tail-following window: newest rows first. */
+export function followWindow(total: number, budget: number): AgentScrollState {
+	return { offset: Math.max(0, total - budget), following: true };
+}
+
+/**
+ * How many agent rows the panel may render. Mirrors the roster widget's own
+ * budget: a width cap (6 wide / 3 narrow) plus one marker row, bounded by the
+ * terminal-height panel share.
+ */
+export function agentListWindowRows(
+	terminalColumns: number | undefined,
+	terminalRows: number | undefined,
+	total?: number,
+): number {
+	const widthCap = (terminalColumns ?? 80) < 40 ? 3 : 6;
+	const panel = panelRows(terminalRows);
+	const panelBudget = Math.min(widthCap + 1, panel ?? widthCap + 1);
+	const bodyBudget = Math.max(1, panelBudget - 1); // roster header owns one row
+	// One combined overflow marker is paid from the body budget, preserving at
+	// least one actual agent row even in the minimum three-row panel.
+	return total !== undefined && total > bodyBudget
+		? Math.max(1, bodyBudget - 1)
+		: bodyBudget;
+}

package/src/agents-store.ts

@@ -7,7 +7,9 @@ import type { AgentProgressSnapshot } from "pi-maestro-teammate/v1/types";
 import { sanitizeExtensionStatusText } from "./extension-status.ts";
 import type { AgentRow, AgentStatus } from "./types.ts";
 
-const TAIL_MAX = 48;
+const STATUS_TEXT_MAX = 48;
+/** Selected-session output kept for the expandable fixed detail region. */
+export const SESSION_CONTENT_MAX = 2_048;
 
 // Every string here originates in an LLM-authored teammate event. A raw newline
 // would split one widget row into several physical terminal rows and a raw escape
@@ -18,10 +20,18 @@ function clean(raw: string | undefined): string {
 	return raw === undefined ? "" : sanitizeExtensionStatusText(raw);
 }
 
-function truncateTail(raw: string): string {
+function truncateText(raw: string, max: number): string {
 	const flat = clean(raw);
 	if (flat.length === 0) return "";
-	return flat.length > TAIL_MAX ? flat.slice(0, TAIL_MAX - 1) + "…" : flat;
+	return flat.length > max ? flat.slice(0, max - 1) + "…" : flat;
+}
+
+function truncateStatusText(raw: string): string {
+	return truncateText(raw, STATUS_TEXT_MAX);
+}
+
+function truncateSessionContent(raw: string): string {
+	return truncateText(raw, SESSION_CONTENT_MAX);
 }
 
 // Store inputs are compatibility-relaxed projections of the versioned public
@@ -47,29 +57,11 @@ export type MessagePayload = Partial<Omit<
 export type CompletePayload = Pick<TeammateCompleteEvent, "correlationId" | "exitCode">
 	& Partial<Pick<TeammateCompleteEvent, "durationMs" | "wakeable" | "cancelled">>;
 
-/**
- * How long a failed agent stays on screen after it completes.
- *
- * Long enough to read the role and the tail that explains it; short enough that
- * the panel still empties itself without the user clearing anything.
- */
-export const FAILED_LINGER_MS = 30_000;
-
-/**
- * How long a sleeping (wakeable) row stays visible after completion.
- *
- * Matches the native widget's idle-hide window so both surfaces agree on
- * when an idle agent stops occupying screen space.
- */
-export const SLEEPING_LINGER_MS = 60_000;
-
-/**
- * How long a terminated (cancelled/aborted) row stays on screen after it ends.
- *
- * Shorter than a failure: cancellation is expected, but the user should still
- * see the × long enough to read which agent was taken down.
- */
-export const TERMINATED_LINGER_MS = 15_000;
+export const AGENT_LINGER_MS = 60_000;
+/** Compatibility exports: every terminal state now uses one visible window. */
+export const FAILED_LINGER_MS = AGENT_LINGER_MS;
+export const SLEEPING_LINGER_MS = AGENT_LINGER_MS;
+export const TERMINATED_LINGER_MS = AGENT_LINGER_MS;
 
 /**
  * How long a completed agent's tombstone suppresses self-healing.
@@ -158,11 +150,11 @@ function latestTool(tools: Array<string | { name?: string; status?: string }> |
 	const tool = tools.find((candidate) => typeof candidate === "object" && candidate?.status === "running")
 		?? tools.at(-1);
 	if (!tool) return undefined;
-	if (typeof tool === "string") return truncateTail(tool);
+	if (typeof tool === "string") return truncateStatusText(tool);
 	const name = tool?.name?.trim();
 	if (!name) return undefined;
 	const status = tool.status?.trim();
-	return truncateTail(status && status !== "completed" ? `${name} (${status})` : name);
+	return truncateStatusText(status && status !== "completed" ? `${name} (${status})` : name);
 }
 
 // Self-accumulating roster. The teammate extension only broadcasts deltas
@@ -175,6 +167,8 @@ export class AgentsStore {
 	private readonly roster = new Map<string, AgentRow>();
 	/** correlationId -> completion time; suppresses post-complete self-healing. */
 	private readonly completedAt = new Map<string, number>();
+	/** correlationId of the agent currently shown in teammate's viewing view. */
+	private viewingId: string | undefined;
 
 	private isTombstoned(id: string | undefined, now: number): boolean {
 		if (id === undefined) return false;
@@ -198,6 +192,29 @@ export class AgentsStore {
 		// tombstoned.
 		this.completedAt.delete(id);
 		const prev = this.roster.get(id);
+		const prevIsTerminal = prev?.status === "done"
+			|| prev?.status === "failed"
+			|| prev?.status === "terminated"
+			|| prev?.status === "sleeping";
+		const nextStatus = p.status === undefined
+			? prevIsTerminal ? "running" : prev?.status ?? "running"
+			: mapAgentStatus(p.status);
+		if ((clean(p.agent) || prev?.agent || "").startsWith("graph(") && nextStatus === "running") {
+			// Restarting a graph is authoritative for its retained descendants too;
+			// their next progress snapshot may reuse the same correlation ids.
+			const pending = [id];
+			const visited = new Set<string>();
+			while (pending.length > 0) {
+				const parent = pending.pop()!;
+				if (visited.has(parent)) continue;
+				visited.add(parent);
+				for (const candidate of this.roster.values()) {
+					if (candidate.parentCorrelationId !== parent) continue;
+					this.completedAt.delete(candidate.correlationId);
+					pending.push(candidate.correlationId);
+				}
+			}
+		}
 		const row: AgentRow = {
 			...prev,
 			correlationId: id,
@@ -205,12 +222,12 @@ export class AgentsStore {
 			name: p.name === undefined ? prev?.name : clean(p.name),
 			role: deriveRole(p.agent, p.name),
 			task: prev?.task ?? clean(p.name),
-			status: p.status === undefined ? prev?.status ?? "running" : mapAgentStatus(p.status),
+			status: nextStatus,
 			phase: typeof p.phase === "string" ? clean(p.phase) : prev?.phase,
 			lastOutcome: p.lastOutcome
 				? {
 					status: p.lastOutcome.status,
-					...(p.lastOutcome.message ? { message: truncateTail(p.lastOutcome.message) } : {}),
+					...(p.lastOutcome.message ? { message: truncateStatusText(p.lastOutcome.message) } : {}),
 					settledAt: p.lastOutcome.settledAt,
 				}
 				: prev?.lastOutcome,
@@ -227,12 +244,16 @@ export class AgentsStore {
 			row.turnStartedAt = now;
 			delete row.finishedAt;
 			delete row.failedAt;
+			delete row.resultReadyAt;
 		} else if (row.status === "sleeping") {
 			row.finishedAt = row.lastOutcome?.settledAt ?? prev?.finishedAt ?? now;
 		} else if (row.status !== "done" && row.status !== "failed" && row.status !== "terminated") {
 			delete row.finishedAt;
 		}
 		this.roster.set(id, row);
+		if (row.status === "done" || row.status === "failed" || row.status === "terminated" || row.status === "sleeping") {
+			this.completedAt.set(id, row.finishedAt ?? now);
+		}
 	}
 
 	applyMessage(p: MessagePayload, now = Date.now()): void {
@@ -269,13 +290,16 @@ export class AgentsStore {
 					? { spawnedBy: p.correlationId }
 					: {}),
 			}, now);
+			// This same delta is the authoritative content for the self-healed row;
+			// a provisional sleeping seed must not tombstone itself before ingestion.
+			this.completedAt.delete(targetId);
 		}
 		const row = this.roster.get(targetId);
-		if (!row) return;
+		if (!row || this.isTombstoned(targetId, now)) return;
 		const progressActivity = p.progress?.find((progress) => progress.correlationId === targetId)?.lastActivityAt;
 		row.lastActivityAt = normalizeStartedAt(p.lastActivityAt ?? progressActivity, now);
 		const tail = p.lastMessage ?? p.message;
-		if (typeof tail === "string" && tail.length > 0) row.tail = truncateTail(tail);
+		if (typeof tail === "string" && tail.length > 0) row.tail = truncateSessionContent(tail);
 		if (p.recentTools) {
 			const tool = latestTool(p.recentTools);
 			if (tool) row.activeTool = tool;
@@ -287,7 +311,7 @@ export class AgentsStore {
 		if (typeof p.outputTokens === "number") row.outputTokens = p.outputTokens;
 		if (typeof p.cacheReadTokens === "number") row.cacheReadTokens = p.cacheReadTokens;
 		if (typeof p.cacheWriteTokens === "number") row.cacheWriteTokens = p.cacheWriteTokens;
-		if (typeof p.error === "string") row.error = truncateTail(p.error);
+		if (typeof p.error === "string") row.error = truncateStatusText(p.error);
 		if (typeof p.requestedModel === "string") row.requestedModel = clean(p.requestedModel);
 		if (typeof p.resolvedModel === "string") row.resolvedModel = clean(p.resolvedModel);
 		if (Array.isArray(p.attemptedModels)) {
@@ -298,6 +322,10 @@ export class AgentsStore {
 			row.status = mapAgentStatus(p.status);
 			if (row.status === "done" || row.status === "failed" || row.status === "terminated") {
 				row.finishedAt ??= now;
+				this.completedAt.set(targetId, now);
+			} else if (row.status === "sleeping") {
+				row.finishedAt ??= now;
+				this.completedAt.set(targetId, now);
 			} else {
 				delete row.finishedAt;
 			}
@@ -319,10 +347,11 @@ export class AgentsStore {
 			for (const row of this.roster.values()) {
 				if (row.parentCorrelationId === id) pending.push(row.correlationId);
 			}
-			// A failed agent used to be deleted the moment its result arrived, so the
-			// only evidence of the failure disappeared in the same frame it appeared.
-			// Successes still vanish immediately — the work has simply moved on.
+			// Every terminal row remains visible for one minute. Tombstone it now so
+			// late progress cannot regress the retained row back to running; an
+			// explicit started event clears the tombstone for a genuine new turn.
 			const row = this.roster.get(id);
+			this.completedAt.set(id, now);
 			const cancelledById = id === p.correlationId && p.cancelled === true;
 			const failedByExitCode = id === p.correlationId
 				&& Number.isFinite(p.exitCode)
@@ -365,27 +394,30 @@ export class AgentsStore {
 				row.failedAt = now;
 				row.lastActivityAt = now;
 				delete row.activeTool;
-			} else {
-				this.roster.delete(id);
-				// Tombstone even when the row never existed: a `complete` that beats
-				// the first delta must still suppress the self-heal that follows.
-				this.completedAt.set(id, now);
+			} else if (row) {
+				row.status = "done";
+				row.taskStatus = "completed";
+				row.finishedAt = terminalTime(row, id === p.correlationId ? p : {}, now);
+				row.lastOutcome = { status: "completed", settledAt: row.finishedAt };
+				row.lastActivityAt = now;
+				delete row.activeTool;
+				delete row.failedAt;
 			}
 		}
 	}
 
-	/** Drop failed, terminated or expired sleeping rows that have had their time on screen. Returns true if any went. */
+	/** Drop terminal rows after their shared one-minute visible window. */
 	prune(now = Date.now()): boolean {
 		let changed = false;
 		for (const [id, row] of this.roster) {
-			if (row.failedAt !== undefined && now - row.failedAt >= FAILED_LINGER_MS) {
-				this.roster.delete(id);
-				changed = true;
-			} else if (row.status === "terminated" && row.finishedAt !== undefined && now - row.finishedAt >= TERMINATED_LINGER_MS) {
-				this.roster.delete(id);
-				changed = true;
-			} else if (row.status === "sleeping" && row.finishedAt !== undefined && now - row.finishedAt >= SLEEPING_LINGER_MS) {
+			const terminal = row.status === "done"
+				|| row.status === "failed"
+				|| row.status === "terminated"
+				|| row.status === "sleeping";
+			const settledAt = this.completedAt.get(id);
+			if (terminal && settledAt !== undefined && now - settledAt >= AGENT_LINGER_MS) {
 				this.roster.delete(id);
+				if (this.viewingId === id) this.viewingId = undefined;
 				changed = true;
 			}
 		}
@@ -395,17 +427,27 @@ export class AgentsStore {
 		return changed;
 	}
 
-	/** True while a failed, terminated or sleeping row is still counting down, so the redraw loop must run. */
+	/** True while a terminal row is counting down, so the redraw loop can expire it. */
 	hasLingering(): boolean {
 		for (const row of this.roster.values()) {
-			if (row.failedAt !== undefined) return true;
-			if (row.status === "terminated") return true;
-			if (row.status === "sleeping") return true;
+			if (row.status === "done"
+				|| row.status === "failed"
+				|| row.status === "terminated"
+				|| row.status === "sleeping") return true;
+		}
+		return false;
+	}
+
+	/** True while any agent (foreground or background) is still running, so elapsed/stall repaints keep the loop alive. */
+	hasActive(): boolean {
+		for (const row of this.roster.values()) {
+			if (row.status === "running") return true;
 		}
 		return false;
 	}
 
 	private applyProgress(parentCorrelationId: string, p: ProgressPayload, now: number): void {
+		if (this.isTombstoned(p.correlationId, now)) return;
 		if (!this.roster.has(p.correlationId)
 			&& this.canMaterialize(p.correlationId, parentCorrelationId, now)) {
 			// Self-heal: see applyMessage. A graph child whose `started` delta was
@@ -440,6 +482,10 @@ export class AgentsStore {
 			row.status = mapAgentStatus(p.status);
 			if (row.status === "done" || row.status === "failed" || row.status === "terminated") {
 				row.finishedAt = terminalTime(row, p, now);
+				this.completedAt.set(p.correlationId, now);
+			} else if (row.status === "sleeping") {
+				row.finishedAt = terminalTime(row, p, now);
+				this.completedAt.set(p.correlationId, now);
 			} else {
 				delete row.finishedAt;
 			}
@@ -464,7 +510,7 @@ export class AgentsStore {
 		row.cacheReadTokens = p.cacheReadTokens;
 		row.cacheWriteTokens = p.cacheWriteTokens;
 		if (p.error === undefined) delete row.error;
-		else row.error = truncateTail(p.error);
+		else row.error = truncateStatusText(p.error);
 		if (p.requestedModel === undefined) delete row.requestedModel;
 		else row.requestedModel = clean(p.requestedModel);
 		if (p.resolvedModel === undefined) delete row.resolvedModel;
@@ -472,7 +518,7 @@ export class AgentsStore {
 		if (p.attemptedModels === undefined) delete row.attemptedModels;
 		else row.attemptedModels = p.attemptedModels.map((model) => clean(model)).filter(Boolean);
 		if (typeof p.lastMessage === "string" && p.lastMessage.length > 0) {
-			row.tail = truncateTail(p.lastMessage);
+			row.tail = truncateSessionContent(p.lastMessage);
 		}
 	}
 
@@ -483,7 +529,19 @@ export class AgentsStore {
 		return [...this.roster.values()].sort((a, b) => {
 			const activity = b.lastActivityAt - a.lastActivityAt;
 			return activity || a.correlationId.localeCompare(b.correlationId);
-		});
+		}).map((row) =>
+			row.correlationId === this.viewingId ? { ...row, viewing: true } : row,
+		);
+	}
+
+	/** Mark which agent the teammate viewing view currently shows. */
+	setViewingAgent(correlationId: string | undefined): void {
+		this.viewingId = correlationId;
+	}
+
+	/** Correlation id of the agent currently shown in the viewing view. */
+	getViewingAgent(): string | undefined {
+		return this.viewingId;
 	}
 
 	get size(): number {
@@ -497,5 +555,6 @@ export class AgentsStore {
 	clear(): void {
 		this.roster.clear();
 		this.completedAt.clear();
+		this.viewingId = undefined;
 	}
 }