pi-cockpit 0.19.0 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cockpit",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
   "type": "module",
   "keywords": [
@@ -67,12 +67,12 @@
     }
   },
   "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",
+    "@earendil-works/pi-agent-core": "0.84.4",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
     "@types/node": "^22.0.0",
-    "pi-maestro-teammate": "2.2.0",
+    "pi-maestro-teammate": "2.3.0",
     "typebox": "1.3.7",
     "typescript": "^5.5.0"
   },

package/src/agent-bar.ts

@@ -15,6 +15,7 @@ import type { AgentRow } from "./types.ts";
 import { effectiveAgentStatus, isCliAgent, type AgentDisplayStatus } from "./agents-store.ts";
 import { visibleAgentRows } from "./stack-widget.ts";
 import { tuiT } from "./tui-i18n.ts";
+import { ownerDisplayToken } from "./window-autocomplete.ts";
 
 export const SESSION_BAR_WIDGET_KEY = "cockpit-session-bar";
 export const AGENT_BAR_WIDGET_KEY = SESSION_BAR_WIDGET_KEY;
@@ -37,12 +38,19 @@ export interface SessionBarDeps {
 	getCurrentSession?: () => { label: string; color: ThemeColor } | undefined;
 }
 
+export interface SessionBarHint {
+	text: string;
+	color?: ThemeColor;
+}
+
+export type SessionBarHintValue = string | SessionBarHint;
+
 export interface AgentBarDeps {
 	getEndpoints: () => readonly CockpitEndpoint[];
 	getState: () => SessionUiState;
 	getNow: () => number;
 	isMainRunning?: () => boolean;
-	getShortcutHint?: () => string | undefined;
+	getShortcutHint?: () => SessionBarHintValue | undefined;
 }
 
 export const AGENT_SESSION_COLORS = [
@@ -154,7 +162,7 @@ function endpointColor(endpoint: CockpitEndpoint, status: AgentBarStatus, now: n
 export interface AgentBarRenderOptions {
 	mainRunning?: boolean;
 	now?: number;
-	shortcutHint?: string;
+	shortcutHint?: SessionBarHintValue;
 }
 
 /** Chip-to-chip separator in the agent bar. */
@@ -231,11 +239,12 @@ export function renderSessionBarLine(
 	renderContent: (width: number) => string,
 	width: number,
 	theme: Theme,
-	shortcutHint?: string,
+	shortcutHint?: SessionBarHintValue,
 ): string {
 	const w = Math.max(1, width);
 	if (!shortcutHint) return renderContent(w);
-	const hint = theme.fg("dim", shortcutHint);
+	const hintSpec = typeof shortcutHint === "string" ? { text: shortcutHint, color: "dim" as const } : shortcutHint;
+	const hint = theme.fg(hintSpec.color ?? "dim", hintSpec.text);
 	const hintWidth = visibleWidth(hint);
 	const gap = 2;
 	if (w < hintWidth + gap + 8) return renderContent(w);
@@ -269,9 +278,10 @@ export function renderAgentBar(
 		const outcome = status === "done" || status === "failed" || status === "terminated" || status === "sleeping"
 			? endpoint.agentRow?.lastOutcome
 			: undefined;
+		const ownerId = endpoint.kind === "root" ? endpoint.registryEndpoint?.ownerId : undefined;
 		return {
 			id: endpoint.id,
-			label: endpoint.label,
+			label: ownerId ? ownerDisplayToken(endpoint.label, ownerId) : endpoint.label,
 			ordinal: endpoint.ordinal,
 			unread: state.endpoint(endpoint.id).unread,
 			endpoint,

package/src/ambient.ts

@@ -16,6 +16,7 @@ export interface AmbientState {
 	agents: readonly AgentRow[];
 	jobs: readonly BashBgJob[];
 	running: boolean;
+	waitingForInput?: boolean;
 	cwd?: string;
 	activeTool?: string;
 	workingStartedAt?: number;
@@ -54,17 +55,32 @@ function failedJobs(jobs: readonly BashBgJob[]): BashBgJob[] {
 	return jobs.filter((job) => job.status === "failed" || (job.exitCode !== null && job.exitCode !== 0));
 }
 
+export function nextUiPromptDepth(depth: number, event: "start" | "end"): number {
+	return event === "start" ? depth + 1 : Math.max(0, depth - 1);
+}
+
+export function shouldHideWorkingDuration(
+	mode: "regular" | "fullscreen" | undefined,
+	staticMode: boolean,
+): boolean {
+	// Pi's regular renderer shares scrollback between the transcript and status
+	// row, so a moving live timer can be preserved as transcript height changes.
+	return staticMode || mode !== "fullscreen";
+}
+
 /**
  * The streaming working line.
  *
- * Cockpit hides the host indicator and renders the active state with a live
- * elapsed value, matching the compact folded-thinking label.
+ * Cockpit hides the host indicator and renders the active state. Fullscreen may
+ * add a live elapsed value; the regular main screen keeps this row stable.
  */
 export function workingMessage(state: AmbientState, now = Date.now()): string | undefined {
-	const label = state.activeTool ?? (state.running ? tuiT("ambient.working") : undefined);
+	const label = state.waitingForInput
+		? tuiT("ambient.waitingForInput")
+		: state.activeTool ?? (state.running ? tuiT("ambient.working") : undefined);
 	if (!label) return undefined;
 	const sep = state.separator ?? " ";
-	const text = (state.hideLiveDuration || state.workingStartedAt === undefined)
+	const text = (state.waitingForInput || state.hideLiveDuration || state.workingStartedAt === undefined)
 		? label
 		: `${label}${sep}${formatThinkingDuration(now - state.workingStartedAt)}`;
 	return `\x1b[3m${text}\x1b[23m`;
@@ -100,6 +116,8 @@ export function titleFor(
 	let title: string;
 	if (broken > 0) {
 		title = `${marks.fail} ${base}${sep}${tuiT("ambient.failed", { count: broken })}`;
+	} else if (state.waitingForInput) {
+		title = `${prefix}${base}${sep}${tuiT("ambient.waitingForInput")}`;
 	} else if (state.running) {
 		const live = liveAgents(state.agents).length;
 		title = live > 0

package/src/endpoint-store.ts

@@ -507,7 +507,7 @@ export class EndpointStore {
 				id: `${MONITOR_CONTROL_ENDPOINT_PREFIX}${encodeURIComponent(root.id)}`,
 				logicalKey: `monitor-control:${root.ownerId}:${root.ownerNonce}`,
 				kind: "window",
-				label: "control",
+				label: `control·${root.ownerId.slice(0, 6)}`,
 				ordinal: Number.MIN_SAFE_INTEGER,
 				status: root.status,
 				contentRevision: revisionOf([root.contentRevision, controlActivityRevision]),

package/src/index.ts

@@ -5,7 +5,7 @@ import type { TUI } from "@earendil-works/pi-tui";
 import { ambientKeysShouldYield, capturingOverlayVisible } from "./capturing-overlay.ts";
 import { Key, decodeKittyPrintable, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { AgentReadStoreRouter, effectiveAgentStatus, type CompletePayload, type MessagePayload, type StartedPayload } from "./agents-store.ts";
-import { AmbientSurfaceCache, statusText, titleFor, workingMessage, type AmbientState } from "./ambient.ts";
+import { AmbientSurfaceCache, nextUiPromptDepth, shouldHideWorkingDuration, statusText, titleFor, workingMessage, type AmbientState } from "./ambient.ts";
 import { generateTitleWithModel } from "./title-llm.ts";
 import { suggestTitle } from "./title-gen.ts";
 import { BashBgStore } from "./bash-bg-store.ts";
@@ -56,6 +56,13 @@ import {
 import { SessionUiState } from "./session-ui-state.ts";
 import { nextSessionTabId } from "./session-tabs.ts";
 import { renderWindowBar, windowSessionColor } from "./window-bar.ts";
+import {
+	buildWindowAutocompleteTargets,
+	createWindowAutocompleteProvider,
+	ownerDisplayToken,
+	resolveWindowRouteInput,
+	type WindowAutocompleteTarget,
+} from "./window-autocomplete.ts";
 import { makeWindowThreadWidget } from "./window-thread-view.ts";
 import { agentPanelRows, panelRows } from "./viewport.ts";
 import { createZenBrowseController, type ZenBrowseController } from "./zen-browse.ts";
@@ -68,7 +75,7 @@ import {
 	buildZenTaskSheet,
 	type ZenSheetDocument,
 } from "./zen-sheet.ts";
-import { routeAgentInput } from "./input-routing.ts";
+import { isLegacyTodoOverlayInput, routeAgentInput } from "./input-routing.ts";
 import { activeThemeName, ThemePicker } from "./theme-picker.ts";
 import { ModelPicker, type ModelPickerEntry } from "./model-picker.ts";
 import { getUsageTotals, invalidateUsageCache, renderFooter, setUsageThrottle, type PaintTheme, type WidthUtils } from "./footer.ts";
@@ -383,6 +390,8 @@ export default function (pi: ExtensionAPI): void {
 	let sessionTheme: Theme | undefined;
 	// Fullscreen (alternate-screen fixed editor) controller, reload-gated.
 	let fullscreenController: FullscreenController | undefined;
+	/** Disposer for the legacy Alt+Shift+T compatibility hook (per applyUi). */
+	let todoOverlayShortcutDisposer: (() => void) | undefined;
 	/** Disposer for the session ←/→ navigation hook (per applyUi). */
 	let sessionBarNavDisposer: (() => void) | undefined;
 	/** Disposer for the agent-list Shift+↑/↓ scroll hook (per applyUi). */
@@ -394,6 +403,7 @@ export default function (pi: ExtensionAPI): void {
 	let surfaceState: CockpitSurfaceState = "disabled";
 	let running = false;
 	let runningStartedAt: number | undefined;
+	let uiPromptDepth = 0;
 	// Auto-generated session title from the first turn (the rule-based / LLM
 	// stand-in for Claude Code's Haiku title). Cleared per session.
 	let aiTitle: string | undefined;
@@ -496,10 +506,11 @@ export default function (pi: ExtensionAPI): void {
 				agents: agents.snapshot(),
 				jobs: bashBg.snapshot(),
 				running,
+				waitingForInput: uiPromptDepth > 0,
 				cwd: title.showCwd ? formatCwd(ctx.sessionManager.getCwd()) : undefined,
 				activeTool: activeTool?.name,
 				workingStartedAt: activeTool?.startedAt ?? runningStartedAt,
-				hideLiveDuration: config.staticMode,
+				hideLiveDuration: shouldHideWorkingDuration(capturedTui?.mode, config.staticMode),
 				separator: ` ${g.separator} `,
 			};
 			ambientSurfaces.setWorkingMessage((message) => ctx.ui.setWorkingMessage(message), workingMessage(state, now));
@@ -512,7 +523,7 @@ export default function (pi: ExtensionAPI): void {
 				state.maestroKnowledge = title.showMaestro
 					? maestroKnowledgeTag(maestro.snapshot()?.workflow?.knowledge)
 					: undefined;
-				state.frame = titleFrame(running);
+				state.frame = titleFrame(running && uiPromptDepth === 0);
 				ambientSurfaces.setTitle(
 					(value) => ctx.ui.setTitle(value),
 					titleFor(state, { ok: g.check, fail: g.cross }, g.separator, { maxLength: title.maxLength }),
@@ -883,6 +894,12 @@ export default function (pi: ExtensionAPI): void {
 		};
 	};
 
+	const selectedHashWindowTargets = new Map<string, WindowAutocompleteTarget>();
+	const windowAutocompleteTargets = () => buildWindowAutocompleteTargets(endpoints.snapshot(), {
+		current: tuiT("window.autocompleteCurrent"),
+		peer: tuiT("window.autocompletePeer"),
+	});
+
 	const publishInputTarget = (force = false): void => {
 		const target = sessionUi.mode === "window" ? selectedWindowInputTarget() : selectedAgentTarget();
 		const sigil = target && "sigil" in target ? target.sigil : "@";
@@ -1082,6 +1099,13 @@ export default function (pi: ExtensionAPI): void {
 		if (config.enabled) syncAgentWidgetPlacement(ctx, "belowEditor");
 	};
 
+	const sessionBarHint = () => {
+		if (sessionListOverlayActive()) return undefined;
+		return maestro.snapshot()?.artifact?.available
+			? { text: tuiT("artifact.hint"), color: "accent" as const }
+			: tuiT(sessionUi.mode === "agent" ? "session.agentListHint" : "session.listHint");
+	};
+
 	const installSessionBar = (ctx: ExtensionContext): void => {
 		ctx.ui.setWidget(
 			SESSION_BAR_WIDGET_KEY,
@@ -1093,7 +1117,7 @@ export default function (pi: ExtensionAPI): void {
 					getState: () => sessionUi,
 					getNow: () => nowSnapshot,
 					isMainRunning: () => running,
-					getShortcutHint: () => sessionListOverlayActive() ? undefined : tuiT("session.listHint"),
+					getShortcutHint: sessionBarHint,
 				})(tui, theme);
 				return {
 					render(width: number): string[] {
@@ -1104,7 +1128,7 @@ export default function (pi: ExtensionAPI): void {
 								sessionUi,
 								width,
 								theme,
-								{ shortcutHint: sessionListOverlayActive() ? undefined : tuiT("session.listHint") },
+								{ shortcutHint: sessionBarHint() },
 							)
 							: agentWidget.render(width);
 					},
@@ -1329,6 +1353,8 @@ export default function (pi: ExtensionAPI): void {
 		clearWidgets(ctx);
 		ctx.ui.setWidget(SESSION_BAR_WIDGET_KEY, undefined);
 		ctx.ui.setWidget(SESSION_DETAIL_WIDGET_KEY, undefined);
+		todoOverlayShortcutDisposer?.();
+		todoOverlayShortcutDisposer = undefined;
 		sessionBarNavDisposer?.();
 		sessionBarNavDisposer = undefined;
 		agentScrollDisposer?.();
@@ -1495,6 +1521,16 @@ export default function (pi: ExtensionAPI): void {
 		// window mode swaps in the window bar. Installed on every surface (dock
 		// and widgets), inserted last so it sits closest to the editor.
 		installSessionBar(ctx);
+		// Legacy terminals encode Alt+Shift+T as ESC + uppercase T, which the
+		// host shortcut matcher cannot distinguish without enhanced key reporting.
+		todoOverlayShortcutDisposer?.();
+		todoOverlayShortcutDisposer = ctx.ui.onTerminalInput((data) => {
+			if (!isLegacyTodoOverlayInput(data) || ambientKeysShouldYield(capturedTui)) return undefined;
+			void openTodoOverlay(ctx).catch((error) => {
+				ctx.ui.notify(error instanceof Error ? error.message : String(error), "warning");
+			});
+			return { consume: true };
+		});
 		// ←/→ cycles tabs only with an empty composer. Window mode additionally
 		// accepts Alt+←/→ so drafts can be switched without losing cursor arrows.
 		// A capturing modal overlay owns navigation while it is open.
@@ -1766,6 +1802,7 @@ export default function (pi: ExtensionAPI): void {
 	// --- session + agent lifecycle ---
 	pi.on("session_start", (_e, ctx) => {
 		lastCtx = ctx;
+		uiPromptDepth = 0;
 		ambientSurfaces.reset();
 		agentReads.bindSession(ctx.sessionManager.getSessionId());
 		agents = agentReads.current;
@@ -1804,6 +1841,12 @@ export default function (pi: ExtensionAPI): void {
 		});
 		settingsLocale.reload();
 		settingsRegistry.emitLocale(settingsLocale.locale);
+		selectedHashWindowTargets.clear();
+		ctx.ui.addAutocompleteProvider((current) => createWindowAutocompleteProvider(
+			current,
+			() => config.enabled ? windowAutocompleteTargets() : [],
+			(target) => selectedHashWindowTargets.set(target.token.toLocaleLowerCase("en"), target),
+		));
 		invalidateUsageCache();
 		// Quiet mode: register compact tool renderers and fold thinking blocks.
 		// Tools are normally registered at extension load time (above) so they
@@ -1898,6 +1941,7 @@ export default function (pi: ExtensionAPI): void {
 		lastCtx = undefined;
 		running = false;
 		runningStartedAt = undefined;
+		uiPromptDepth = 0;
 		activeTools.clear();
 		thinkingTimer.reset();
 		invalidateUsageCache();
@@ -1927,6 +1971,16 @@ export default function (pi: ExtensionAPI): void {
 		syncTick();
 		req();
 	});
+	pi.on("ui_prompt_start", () => {
+		uiPromptDepth = nextUiPromptDepth(uiPromptDepth, "start");
+		req();
+	});
+	pi.on("ui_prompt_end", () => {
+		const nextDepth = nextUiPromptDepth(uiPromptDepth, "end");
+		if (nextDepth === uiPromptDepth) return;
+		uiPromptDepth = nextDepth;
+		req();
+	});
 
 	// --- live elapsed for folded thinking rows ---
 	pi.on("message_start", (e) => {
@@ -1971,6 +2025,60 @@ export default function (pi: ExtensionAPI): void {
 		const hasImages = (e.images?.length ?? 0) > 0;
 		const interactiveText = e.source === "interactive" && e.text.trim().length > 0;
 		const isSynthetic = e.text.startsWith("/") || e.text.startsWith("!");
+		const hashWindowRoute = config.enabled && e.source === "interactive" && !isSynthetic
+			? resolveWindowRouteInput(e.text, windowAutocompleteTargets(), selectedHashWindowTargets)
+			: undefined;
+
+		if (hashWindowRoute) {
+			if (hashWindowRoute.code !== "resolved") {
+				ctx.ui.notify(tuiT(hashWindowRoute.code === "stale"
+					? "notice.windowTargetUnavailable"
+					: "notice.windowTargetAmbiguous"), "warning");
+				ctx.ui.setEditorText(e.text);
+				return { action: "handled" as const };
+			}
+			if (!hashWindowRoute.message) {
+				ctx.ui.notify(tuiT("notice.windowMessageRequired"), "warning");
+				ctx.ui.setEditorText(e.text);
+				return { action: "handled" as const };
+			}
+			if (hashWindowRoute.target.current) {
+				selectedHashWindowTargets.delete(hashWindowRoute.token);
+				if (!firstUserText) firstUserText = hashWindowRoute.message;
+				return { action: "transform" as const, text: hashWindowRoute.message };
+			}
+			if (hasImages) {
+				ctx.ui.notify(tuiT("notice.imagePeer"), "warning");
+				ctx.ui.setEditorText(e.text);
+				return { action: "handled" as const };
+			}
+			if (!registry) {
+				ctx.ui.notify(tuiT("notice.peerDeliveryUnavailable"), "warning");
+				ctx.ui.setEditorText(e.text);
+				return { action: "handled" as const };
+			}
+			const delivery = await (registry.send?.({
+				selector: hashWindowRoute.target.routeSelector,
+				message: hashWindowRoute.message,
+				mode: e.streamingBehavior === "steer" ? "steer" : "follow_up",
+				source: "user",
+			}) ?? registry.router?.route({
+				selector: hashWindowRoute.target.routeSelector,
+				message: hashWindowRoute.message,
+				mode: e.streamingBehavior === "steer" ? "steer" : "follow_up",
+				source: "user",
+			}));
+			if (!delivery?.delivered) {
+				ctx.ui.notify(tuiT("notice.peerMessageFailed", {
+					label: hashWindowRoute.target.label,
+					message: delivery?.error ?? tuiT("notice.deliveryRegistryUnavailable"),
+				}), "error");
+				ctx.ui.setEditorText(e.text);
+			} else {
+				selectedHashWindowTargets.delete(hashWindowRoute.token);
+			}
+			return { action: "handled" as const };
+		}
 
 		if (e.source === "interactive" && !hasImages && e.text.trim() === "monitor") {
 			if (!registry?.requestWindowMode) {
@@ -1981,7 +2089,7 @@ export default function (pi: ExtensionAPI): void {
 			return { action: "handled" as const };
 		}
 
-		if (sessionUi.mode === "window" && (interactiveText || hasImages) && !isSynthetic) {
+		if (config.enabled && sessionUi.mode === "window" && (interactiveText || hasImages) && !isSynthetic) {
 			const target = selectedWindowEndpoint();
 			if (!target) {
 				ctx.ui.notify(tuiT("notice.noMonitorWindow"), "warning");
@@ -2221,7 +2329,11 @@ export default function (pi: ExtensionAPI): void {
 				: "";
 			const detail = [current, tuiStatus(endpoint.status), agentCount].filter(Boolean).join(" · ");
 			const sigil = mode === "window" ? "#" : "@";
-			return `${sigil}${endpoint.label}${detail ? ` · ${detail}` : ""}`;
+			const showOwner = mode === "window" || endpoint.kind === "root";
+			const label = showOwner && endpoint.registryEndpoint
+				? ownerDisplayToken(endpoint.label, endpoint.registryEndpoint.ownerId)
+				: endpoint.label;
+			return `${sigil}${label}${detail ? ` · ${detail}` : ""}`;
 		});
 		let previewAgent = false;
 		enterCapturingOverlay();

package/src/input-routing.ts

@@ -34,6 +34,10 @@ export interface AgentInputRegistries {
 
 export type AgentInputRegistryProvider = MailboxHostRegistry | AgentInputRegistries;
 
+export function isLegacyTodoOverlayInput(data: string): boolean {
+	return data === "\x1bT";
+}
+
 function inputRegistries(provider: AgentInputRegistryProvider | undefined): AgentInputRegistries {
 	if (provider && "deliverAgentMessage" in provider) return { mailbox: provider };
 	return provider ?? {};

package/src/maestro-store.ts

@@ -1,6 +1,7 @@
 import { sanitizeExtensionStatusText } from "./extension-status.ts";
 import {
 	MAESTRO_UI_SNAPSHOT_VERSION,
+	type MaestroArtifactV1,
 	type MaestroGoalV1,
 	type MaestroModeV1,
 	type MaestroSwarmBestV1,
@@ -87,6 +88,8 @@ function parseSnapshot(value: unknown): MaestroUiSnapshotV1 | undefined {
 	}
 	const swarm = value.swarm === null ? null : parseSwarm(value.swarm);
 	if (swarm === undefined) return undefined;
+	const artifact = value.artifact === undefined ? undefined : parseArtifact(value.artifact);
+	if (value.artifact !== undefined && artifact === undefined) return undefined;
 	const mode = parseMode(value.mode);
 	if (mode === undefined) return undefined;
 	if (value.currentGoalId !== undefined && !isOpaqueId(value.currentGoalId)) return undefined;
@@ -98,6 +101,7 @@ function parseSnapshot(value: unknown): MaestroUiSnapshotV1 | undefined {
 		goals,
 		...(value.currentGoalId === undefined ? {} : { currentGoalId: value.currentGoalId }),
 		swarm,
+		...(artifact === undefined ? {} : { artifact }),
 		mode,
 	};
 }
@@ -239,6 +243,20 @@ function parseSwarmBest(value: unknown): MaestroSwarmBestV1 | undefined {
 	};
 }
 
+function parseArtifact(value: unknown): MaestroArtifactV1 | undefined {
+	if (!isRecord(value) || typeof value.available !== "boolean") return undefined;
+	if (value.planRevision !== undefined && !isNonNegativeInteger(value.planRevision)) return undefined;
+	const planStatus = value.planStatus === undefined ? undefined : displayString(value.planStatus);
+	if (value.planStatus !== undefined && planStatus === undefined) return undefined;
+	if (value.knowledgeSessionId !== undefined && !isOpaqueId(value.knowledgeSessionId)) return undefined;
+	return {
+		available: value.available,
+		...(value.planRevision === undefined ? {} : { planRevision: value.planRevision }),
+		...(planStatus === undefined ? {} : { planStatus }),
+		...(value.knowledgeSessionId === undefined ? {} : { knowledgeSessionId: value.knowledgeSessionId }),
+	};
+}
+
 function parseMode(value: unknown): MaestroModeV1 | undefined {
 	if (typeof value === "string") return sanitizeExtensionStatusText(value);
 	if (!isRecord(value)) return undefined;

package/src/public/v1/events.ts

@@ -138,6 +138,14 @@ export interface MaestroSwarmV1 {
 	updatedAt: number;
 }
 
+/** Session-bound documents exposed through `/artifact`. */
+export interface MaestroArtifactV1 {
+	available: boolean;
+	planRevision?: number;
+	planStatus?: string;
+	knowledgeSessionId?: string;
+}
+
 /**
  * The active Maestro projection. String values are deliberately open so adding
  * a producer mode does not require a protocol revision.
@@ -164,6 +172,8 @@ export interface MaestroUiStateSnapshotV1 extends MaestroUiEnvelopeV1 {
 	goals: MaestroGoalV1[];
 	currentGoalId?: string;
 	swarm: MaestroSwarmV1 | null;
+	/** Optional for compatibility with older Maestro producers. */
+	artifact?: MaestroArtifactV1;
 	mode: MaestroModeV1;
 }
 

package/src/render.ts

@@ -63,6 +63,8 @@ export interface RenderOpts {
 	 * owner overrides this with the always-available `/cockpit todo`.
 	 */
 	toggleHint?: string;
+	/** How the user opens the full Todo overlay. Cockpit registers this shortcut itself. */
+	detailsHint?: string;
 	/**
 	 * Compact agent mode prints its own roster count. When the widget already
 	 * renders an "Agents N running" header, that would be the same sentence twice
@@ -80,6 +82,7 @@ export interface RenderOpts {
 }
 
 export const DEFAULT_TOGGLE_HINT = altKey("T");
+export const DEFAULT_TODO_DETAILS_HINT = altKey("Shift+T");
 
 // One cell per task stops scaling once the plan outgrows the terminal, so beyond
 // that the bar switches to a proportional summary instead of eating the whole line.
@@ -469,6 +472,7 @@ export function renderTodos(
 	const ell = theme.fg("dim", g.ellipsis);
 	const expanded = opts.expanded !== false;
 	const toggleHint = opts.toggleHint ?? DEFAULT_TOGGLE_HINT;
+	const detailsHint = opts.detailsHint ?? DEFAULT_TODO_DETAILS_HINT;
 
 	if (mode === "compact") {
 		const total = items.length;
@@ -522,6 +526,13 @@ export function renderTodos(
 		const ntext = `${g.arrow} ${theme.fg(np.glyphColor, np.glyph)}${nactor ? ` ${theme.fg("mdLink", nactor)}` : ""} ${todoSubject(np, next.subject, theme)}`;
 		summarySegs.push({ text: ntext, priority: 20, clippable: false });
 	}
+	if (expanded) {
+		summarySegs.push({
+			text: theme.fg("dim", tuiT("widget.todo.details", { shortcut: detailsHint })),
+			priority: 35,
+			clippable: false,
+		});
+	}
 	summarySegs.push({
 		text: theme.fg("dim", `(${toggleHint} ${tuiT(expanded ? "widget.todo.collapse" : "widget.todo.expandAction")})`),
 		priority: 10,

package/src/stack-widget.ts

@@ -141,7 +141,7 @@ export function makeAgentWidget(deps: AgentWidgetDeps) {
 				// Focused-session priority: while a selected session's detail block is
 				// open, it owns the Agent height allowance and the roster collapses to
 				// this one-line summary. The per-agent rows stay reachable through the
-				// session-bar chips and the Alt+A overlay, so monitoring is preserved
+				// session bar and its Alt+R selection flow, so monitoring is preserved
 				// while the session content gains the released rows.
 				if (deps.hasSessionDetail?.()) return [headerLine];
 

package/src/tui-i18n.ts

@@ -68,6 +68,8 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"common.ruleBased": "(rule-based)",
 		"common.customRef": "custom ref…",
 		"session.listHint": `${altKey("R")} list`,
+		"session.agentListHint": `${altKey("R")} Agent`,
+		"artifact.hint": "/artifact",
 		"session.detailHint": `${altKey("R")} preview · ${altKey("E")} hide`,
 		"session.previewHint": "PgUp/PgDn scroll output",
 		"session.thinking": "thinking…",
@@ -76,6 +78,8 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"window.empty": "Windows · no peer sessions",
 		"window.title": "Windows",
 		"window.context": "context {percent}%",
+		"window.autocompleteCurrent": "current window",
+		"window.autocompletePeer": "peer window",
 		"window.currentCoordination": "Current session · monitor coordination",
 		"window.noMessages": "No messages in this window thread.",
 		"window.messages": "Messages",
@@ -151,6 +155,7 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"widget.agents.noun": "agents",
 		"widget.todo.title": "Todo",
 		"widget.todo.expand": "({shortcut} expand)",
+		"widget.todo.details": "{shortcut} full list",
 		"widget.todo.collapse": "collapse",
 		"widget.todo.expandAction": "expand",
 		"widget.agent.lastFailed": "last failed",
@@ -235,6 +240,7 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"sidebar.unavailable": "Cockpit sidebar unavailable",
 		"sidebar.requiresTui": "Cockpit sidebar requires TUI mode",
 		"ambient.working": "working",
+		"ambient.waitingForInput": "WAITING FOR INPUT",
 		"ambient.failed": "{count} failed",
 		"ambient.agents": "{count} agents",
 		"legacy.label.enabled": "enabled",
@@ -280,6 +286,9 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"notice.noMonitorWindow": "No monitor window is selected.",
 		"notice.monitorUnavailable": "Window monitor mode is unavailable in this session.",
 		"notice.imagePeer": "Image input cannot be routed to a peer window; reattach it in #control or after leaving monitor mode.",
+		"notice.windowMessageRequired": "Enter a message after the selected #window.",
+		"notice.windowTargetUnavailable": "The selected #window is no longer available; the message was not sent.",
+		"notice.windowTargetAmbiguous": "The selected #window is ambiguous; choose it again before sending.",
 		"notice.peerDeliveryUnavailable": "Peer window delivery is unavailable.",
 		"notice.peerMessageFailed": "Message to #{label} was not sent: {message}",
 		"notice.deliveryRegistryUnavailable": "delivery registry unavailable",
@@ -387,6 +396,8 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"common.ruleBased": "（规则生成）",
 		"common.customRef": "自定义引用…",
 		"session.listHint": `${altKey("R")} 列表`,
+		"session.agentListHint": `${altKey("R")} Agent`,
+		"artifact.hint": "/artifact",
 		"session.detailHint": `${altKey("R")} 预览 · ${altKey("E")} 隐藏`,
 		"session.previewHint": "PgUp/PgDn 滚动输出",
 		"session.thinking": "思考中…",
@@ -395,6 +406,8 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"window.empty": "窗口 · 没有对等会话",
 		"window.title": "窗口",
 		"window.context": "上下文 {percent}%",
+		"window.autocompleteCurrent": "当前窗口",
+		"window.autocompletePeer": "对等窗口",
 		"window.currentCoordination": "当前会话 · Monitor 协调",
 		"window.noMessages": "此窗口线程中没有消息。",
 		"window.messages": "消息",
@@ -470,6 +483,7 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"widget.agents.noun": "Agent",
 		"widget.todo.title": "Todo",
 		"widget.todo.expand": "（{shortcut} 展开）",
+		"widget.todo.details": "{shortcut} 详细列表",
 		"widget.todo.collapse": "收起",
 		"widget.todo.expandAction": "展开",
 		"widget.agent.lastFailed": "上次失败",
@@ -554,6 +568,7 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"sidebar.unavailable": "Cockpit 侧边栏不可用",
 		"sidebar.requiresTui": "Cockpit 侧边栏需要 TUI 模式",
 		"ambient.working": "工作中",
+		"ambient.waitingForInput": "等待输入",
 		"ambient.failed": "{count} 项失败",
 		"ambient.agents": "{count} 个 Agent",
 		"legacy.label.enabled": "启用",
@@ -599,6 +614,9 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"notice.noMonitorWindow": "未选择 Monitor 窗口。",
 		"notice.monitorUnavailable": "当前会话不支持窗口监控模式。",
 		"notice.imagePeer": "无法将图片路由到对等窗口；请在 #control 中或离开 Monitor 模式后重新附加。",
+		"notice.windowMessageRequired": "请在选中的 #窗口 后输入消息。",
+		"notice.windowTargetUnavailable": "选中的 #窗口 已不可用；消息未发送。",
+		"notice.windowTargetAmbiguous": "选中的 #窗口 存在歧义；请重新选择后再发送。",
 		"notice.peerDeliveryUnavailable": "对等窗口消息发送不可用。",
 		"notice.peerMessageFailed": "发送到 #{label} 的消息失败：{message}",
 		"notice.deliveryRegistryUnavailable": "发送注册表不可用",

package/src/viewport-stability.ts

@@ -44,6 +44,18 @@ function markerOf(fn: ApplyLineResets): ViewportStabilityMarker | undefined {
 	return (fn as ApplyLineResets & Record<symbol, ViewportStabilityMarker | undefined>)[VIEWPORT_STABILITY_MARKER];
 }
 
+const ANSI_ESCAPE = /\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\))/g;
+const TRAILING_DURATION = /(\s(?:·\s*)?)(?:\d+(?:\.\d+)?s|\d+m\d{1,2}s)$/;
+
+function differsOnlyByTrailingDuration(previous: string, next: string): boolean {
+	const previousPlain = previous.replace(ANSI_ESCAPE, "");
+	const nextPlain = next.replace(ANSI_ESCAPE, "");
+	if (previousPlain === nextPlain) return false;
+	if (!TRAILING_DURATION.test(previousPlain) || !TRAILING_DURATION.test(nextPlain)) return false;
+	return previousPlain.replace(TRAILING_DURATION, "$1<duration>")
+		=== nextPlain.replace(TRAILING_DURATION, "$1<duration>");
+}
+
 function isKittyImageLine(line: string | undefined): boolean {
 	return typeof line === "string" && line.includes("\x1b_G");
 }
@@ -98,12 +110,10 @@ function resolveApplyLineResetsSlot(internals: ViewportTuiInternals): ApplyLineR
 }
 
 /**
- * Mirrors pi-tui's viewport-safe diff behavior until the host ships it.
- *
- * pi-tui 0.82/0.83 clears the screen and scrollback whenever the first changed
- * line is above the visible viewport. For stable-height content, those lines
- * cannot be updated in terminal scrollback and should only advance the diff
- * baseline. Visible changes are then rendered normally from viewportTop.
+ * Prevents timer-only churn above the visible viewport from forcing a full
+ * redraw. The next frame keeps the terminal's actual hidden text, so the diff
+ * baseline remains truthful; status, content, layout and image changes retain
+ * pi-tui's native redraw path.
  */
 export function attachViewportStability(tui: TUI): ViewportStabilityPatch {
 	try {
@@ -120,24 +130,25 @@ export function attachViewportStability(tui: TUI): ViewportStabilityPatch {
 			const nextLines = original.call(this, lines);
 			const previousLines = this.previousLines;
 			const viewportTop = this.previousViewportTop;
-			const previousHeight = this.previousHeight;
-			const currentHeight = this.terminal?.rows;
 			if (
 				Array.isArray(previousLines)
-				&& Array.isArray(nextLines)
-				&& previousLines.length === nextLines.length
-				&& typeof viewportTop === "number"
-				&& Number.isFinite(viewportTop)
-				&& viewportTop > 0
-				&& typeof previousHeight === "number"
-				&& Number.isFinite(previousHeight)
-				&& previousHeight === currentHeight
+					&& previousLines.length === nextLines.length
+					&& typeof viewportTop === "number"
+					&& Number.isFinite(viewportTop)
+					&& viewportTop > 0
+					&& this.previousHeight === this.terminal?.rows
 			) {
 				const hiddenEnd = Math.min(previousLines.length, Math.trunc(viewportTop));
 				const hiddenHasKittyImage = previousLines.slice(0, hiddenEnd).some(isKittyImageLine)
 					|| nextLines.slice(0, hiddenEnd).some(isKittyImageLine);
 				if (!hiddenHasKittyImage) {
-					for (let index = 0; index < hiddenEnd; index++) previousLines[index] = nextLines[index];
+					for (let index = 0; index < hiddenEnd; index += 1) {
+						const previous = previousLines[index];
+						const next = nextLines[index];
+						if (previous !== undefined && next !== undefined && differsOnlyByTrailingDuration(previous, next)) {
+							nextLines[index] = previous;
+						}
+					}
 				}
 			}
 			return nextLines;

package/src/window-autocomplete.ts

@@ -0,0 +1,192 @@
+import type {
+	AutocompleteItem,
+	AutocompleteProvider,
+	AutocompleteSuggestions,
+} from "@earendil-works/pi-tui";
+import type { CockpitEndpoint, EndpointStoreSnapshot } from "./endpoint-store.ts";
+
+const OWNER_LABEL_LENGTH = 6;
+const MAX_WINDOW_SUGGESTIONS = 20;
+
+export interface WindowAutocompleteLabels {
+	current: string;
+	peer: string;
+}
+
+export interface WindowAutocompleteTarget {
+	token: string;
+	label: string;
+	description: string;
+	routeSelector: string;
+	ownerId: string;
+	ownerNonce: string;
+	current: boolean;
+}
+
+export type WindowRouteResolution = {
+	code: "resolved";
+	token: string;
+	target: WindowAutocompleteTarget;
+	message: string;
+} | {
+	code: "stale" | "ambiguous";
+	token: string;
+	message: string;
+};
+
+export function ownerDisplayToken(label: string, ownerId: string): string {
+	const normalized = label
+		.replace(/[\s#]+/g, "-")
+		.replace(/^-+|-+$/g, "") || "window";
+	const suffix = `·${ownerId.slice(0, OWNER_LABEL_LENGTH)}`;
+	return normalized.endsWith(suffix) ? normalized : `${normalized}${suffix}`;
+}
+
+function targetFromEndpoint(
+	endpoint: CockpitEndpoint,
+	current: boolean,
+	labels: WindowAutocompleteLabels,
+): WindowAutocompleteTarget | undefined {
+	const registryEndpoint = endpoint.registryEndpoint;
+	if (!registryEndpoint || registryEndpoint.kind !== "root") return undefined;
+	const ownerTarget = `owner:${registryEndpoint.ownerId}`;
+	const displayLabel = current ? "control" : endpoint.label;
+	return {
+		token: ownerDisplayToken(displayLabel, registryEndpoint.ownerId),
+		label: displayLabel,
+		description: [
+			current ? labels.current : labels.peer,
+			ownerTarget,
+			`incarnation:${registryEndpoint.ownerNonce}`,
+			registryEndpoint.sessionId ? `session:${registryEndpoint.sessionId}` : undefined,
+		].filter(Boolean).join(" · "),
+		routeSelector: endpoint.routeSelector,
+		ownerId: registryEndpoint.ownerId,
+		ownerNonce: registryEndpoint.ownerNonce,
+		current,
+	};
+}
+
+export function buildWindowAutocompleteTargets(
+	snapshot: EndpointStoreSnapshot,
+	labels: WindowAutocompleteLabels,
+): WindowAutocompleteTarget[] {
+	const currentRoot = snapshot.endpoints.find((endpoint) =>
+		endpoint.kind === "root" && endpoint.registryEndpoint?.scope === "local"
+	);
+	const targets: WindowAutocompleteTarget[] = [];
+	if (currentRoot) {
+		const current = targetFromEndpoint(currentRoot, true, labels);
+		if (current) targets.push(current);
+	}
+	for (const endpoint of snapshot.windows) {
+		if (endpoint.registryEndpoint?.scope !== "workspace-peer") continue;
+		const target = targetFromEndpoint(endpoint, false, labels);
+		if (target) targets.push(target);
+	}
+	return targets;
+}
+
+export function extractWindowCompletionQuery(textBeforeCursor: string): string | undefined {
+	return /^[ \t]*#([^\s#]*)$/.exec(textBeforeCursor)?.[1];
+}
+
+function matchingTargets(
+	targets: readonly WindowAutocompleteTarget[],
+	query: string,
+): WindowAutocompleteTarget[] {
+	const normalized = query.trim().toLocaleLowerCase("en");
+	if (!normalized) return targets.slice(0, MAX_WINDOW_SUGGESTIONS);
+	return targets.filter((target) => [
+		target.token,
+		target.label,
+		target.ownerId,
+		target.description,
+	].some((value) => value.toLocaleLowerCase("en").includes(normalized)))
+		.slice(0, MAX_WINDOW_SUGGESTIONS);
+}
+
+function completionItem(target: WindowAutocompleteTarget): AutocompleteItem {
+	return {
+		value: `#${target.token}`,
+		label: `#${target.token}`,
+		description: target.description,
+	};
+}
+
+export function createWindowAutocompleteProvider(
+	current: AutocompleteProvider,
+	getTargets: () => readonly WindowAutocompleteTarget[],
+	onSelect: (target: WindowAutocompleteTarget) => void,
+): AutocompleteProvider {
+	const suggestedTargets = new Map<string, WindowAutocompleteTarget>();
+	const suggestionKey = (item: AutocompleteItem): string => `${item.value}\0${item.description ?? ""}`;
+	return {
+		triggerCharacters: [...new Set([...(current.triggerCharacters ?? []), "#"])],
+		async getSuggestions(lines, cursorLine, cursorCol, options): Promise<AutocompleteSuggestions | null> {
+			if (cursorLine !== 0) return current.getSuggestions(lines, cursorLine, cursorCol, options);
+			const currentLine = lines[cursorLine] ?? "";
+			const query = extractWindowCompletionQuery(currentLine.slice(0, cursorCol));
+			if (query === undefined) return current.getSuggestions(lines, cursorLine, cursorCol, options);
+			const targets = matchingTargets(getTargets(), query);
+			if (targets.length === 0) return current.getSuggestions(lines, cursorLine, cursorCol, options);
+			const items = targets.map(completionItem);
+			for (let index = 0; index < items.length; index++) {
+				suggestedTargets.set(suggestionKey(items[index]!), targets[index]!);
+			}
+			return {
+				items,
+				prefix: `#${query}`,
+			};
+		},
+		applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+			const selected = suggestedTargets.get(suggestionKey(item));
+			const currentLine = lines[cursorLine] ?? "";
+			const beforePrefix = currentLine.slice(0, cursorCol - prefix.length);
+			if (!selected || !prefix.startsWith("#") || beforePrefix.trim()) {
+				return current.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
+			}
+			onSelect(selected);
+			const afterCursor = currentLine.slice(cursorCol);
+			const separator = afterCursor.length === 0 || !/^\s/.test(afterCursor) ? " " : "";
+			const nextLine = `${beforePrefix}${item.value}${separator}${afterCursor}`;
+			const nextLines = [...lines];
+			nextLines[cursorLine] = nextLine;
+			return {
+				lines: nextLines,
+				cursorLine,
+				cursorCol: beforePrefix.length + item.value.length + separator.length,
+			};
+		},
+		shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
+			return current.shouldTriggerFileCompletion?.(lines, cursorLine, cursorCol) ?? true;
+		},
+	};
+}
+
+export function resolveWindowRouteInput(
+	text: string,
+	targets: readonly WindowAutocompleteTarget[],
+	selectedTargets: ReadonlyMap<string, WindowAutocompleteTarget> = new Map(),
+): WindowRouteResolution | undefined {
+	const match = /^[ \t]*#([^\s#]+)(?:\s+([\s\S]*))?$/.exec(text);
+	if (!match) return undefined;
+	const rawToken = match[1]!;
+	const token = rawToken.toLocaleLowerCase("en");
+	const message = (match[2] ?? "").trim();
+	const selected = selectedTargets.get(token);
+	if (selected) {
+		const live = targets.filter((candidate) =>
+			candidate.routeSelector === selected.routeSelector
+			&& candidate.ownerId === selected.ownerId
+			&& candidate.ownerNonce === selected.ownerNonce
+		);
+		return live.length === 1
+			? { code: "resolved", token, target: live[0]!, message }
+			: { code: "stale", token: rawToken, message };
+	}
+	const matches = targets.filter((candidate) => candidate.token.toLocaleLowerCase("en") === token);
+	if (matches.length > 1) return { code: "ambiguous", token: rawToken, message };
+	if (matches.length === 0) return undefined;
+	return { code: "resolved", token, target: matches[0]!, message };
+}

package/src/window-bar.ts

@@ -3,18 +3,19 @@ import { truncateToWidth, type TUI } from "@earendil-works/pi-tui";
 import type { CockpitEndpoint } from "./endpoint-store.ts";
 import { isMonitorControlEndpoint } from "./endpoint-store.ts";
 import type { SessionUiState } from "./session-ui-state.ts";
-import { assignedAgentColor, renderSessionBarLine } from "./agent-bar.ts";
+import { assignedAgentColor, renderSessionBarLine, type SessionBarHintValue } from "./agent-bar.ts";
 import { tuiT } from "./tui-i18n.ts";
 import { formatUnreadCount, renderSessionTabLine, type SessionTab } from "./session-tabs.ts";
+import { ownerDisplayToken } from "./window-autocomplete.ts";
 
 export interface WindowBarDeps {
 	getWindows: () => readonly CockpitEndpoint[];
 	getState: () => SessionUiState;
-	getShortcutHint?: () => string | undefined;
+	getShortcutHint?: () => SessionBarHintValue | undefined;
 }
 
 export interface WindowBarRenderOptions {
-	shortcutHint?: string;
+	shortcutHint?: SessionBarHintValue;
 }
 
 interface WindowTab extends SessionTab {
@@ -36,7 +37,8 @@ function renderTab(tab: WindowTab, selected: boolean, theme: Theme): string {
 		? theme.fg("accent", "◆")
 		: theme.fg("muted", "○");
 	const unread = (tab.unread ?? 0) > 0 ? theme.fg("warning", ` ${formatUnreadCount(tab.unread ?? 0)}`) : "";
-	const label = `#${tab.label}`;
+	const ownerId = tab.endpoint.registryEndpoint?.ownerId;
+	const label = `#${ownerId ? ownerDisplayToken(tab.label, ownerId) : tab.label}`;
 	return selected
 		? `${marker} ${theme.fg(color, theme.bold(`▸ ${label}`))}${unread}`
 		: `${marker} ${theme.fg(color, label)}${unread}`;