pi-cockpit 0.12.0 → 0.14.0

package/node_modules/pi-maestro-settings-core/package.json

@@ -1,32 +1,32 @@
-{
-  "name": "pi-maestro-settings-core",
-  "version": "0.1.2",
-  "description": "Versioned Settings and i18n contracts shared by Pi Maestro plugins.",
-  "type": "module",
-  "engines": {
-    "node": ">=22.19.0"
-  },
-  "scripts": {
-    "test": "node --experimental-transform-types --test \"test/*.test.ts\"",
-    "typecheck": "tsc --noEmit -p tsconfig.json"
-  },
-  "main": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./v1": "./src/public/v1/index.ts",
-    "./v1/events": "./src/public/v1/events.ts",
-    "./v1/provider": "./src/public/v1/provider.ts",
-    "./v1/schema": "./src/public/v1/schema.ts",
-    "./v1/i18n": "./src/public/v1/i18n.ts"
-  },
-  "files": [
-    "src/**/*.ts"
-  ],
-  "keywords": [
-    "pi",
-    "maestro",
-    "settings",
-    "i18n"
-  ],
-  "license": "ISC"
-}
+{
+  "name": "pi-maestro-settings-core",
+  "version": "0.1.3",
+  "description": "Versioned Settings and i18n contracts shared by Pi Maestro plugins.",
+  "type": "module",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "test": "node --experimental-transform-types --test \"test/*.test.ts\"",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./v1": "./src/public/v1/index.ts",
+    "./v1/events": "./src/public/v1/events.ts",
+    "./v1/provider": "./src/public/v1/provider.ts",
+    "./v1/schema": "./src/public/v1/schema.ts",
+    "./v1/i18n": "./src/public/v1/i18n.ts"
+  },
+  "files": [
+    "src/**/*.ts"
+  ],
+  "keywords": [
+    "pi",
+    "maestro",
+    "settings",
+    "i18n"
+  ],
+  "license": "ISC"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cockpit",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
   "type": "module",
   "keywords": [
@@ -32,7 +32,7 @@
     ]
   },
   "dependencies": {
-    "pi-maestro-settings-core": "0.1.2",
+    "pi-maestro-settings-core": "0.1.3",
     "proper-lockfile": "4.1.2"
   },
   "bundledDependencies": [
@@ -72,7 +72,7 @@
     "@earendil-works/pi-coding-agent": "0.83.0",
     "@earendil-works/pi-tui": "0.83.0",
     "@types/node": "^22.0.0",
-    "pi-maestro-teammate": "1.10.0",
+    "pi-maestro-teammate": "1.12.0",
     "typebox": "1.3.7",
     "typescript": "^5.5.0"
   },

package/src/agent-bar.ts

@@ -8,11 +8,13 @@
 import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth, type TUI } from "@earendil-works/pi-tui";
 import type { CockpitEndpoint } from "./endpoint-store.ts";
+import { formatAgentMetric } from "./render.ts";
 import type { SessionUiState } from "./session-ui-state.ts";
 import { formatUnreadCount, type SessionTab } from "./session-tabs.ts";
 import type { AgentRow } from "./types.ts";
 import { effectiveAgentStatus, type AgentDisplayStatus } from "./agents-store.ts";
 import { visibleAgentRows } from "./stack-widget.ts";
+import { tuiT } from "./tui-i18n.ts";
 
 export const SESSION_BAR_WIDGET_KEY = "cockpit-session-bar";
 export const AGENT_BAR_WIDGET_KEY = SESSION_BAR_WIDGET_KEY;
@@ -88,12 +90,30 @@ export function statusColor(status: AgentDisplayStatus): ThemeColor {
 	}
 }
 
-function chip(label: string, active: boolean, color: ThemeColor, theme: Theme, unread = 0): string {
+function chip(
+	label: string,
+	active: boolean,
+	color: ThemeColor,
+	theme: Theme,
+	unread = 0,
+	activity?: string,
+	attention = false,
+	outcome?: { status: "completed" | "failed" | "terminated"; message?: string },
+): string {
 	const text = `@${label}`;
 	const badge = unread > 0 ? theme.fg("warning", ` •${formatUnreadCount(unread)}`) : "";
+	const activitySuffix = activity ? theme.fg("dim", ` · ${activity}`) : "";
+	const attentionPrefix = attention ? theme.fg("error", "!") : "";
+	const outcomeSuffix = outcome
+		? outcome.status === "failed"
+			? theme.fg("error", ` ✗${outcome.message ? ` ${outcome.message}` : ""}`)
+			: outcome.status === "terminated"
+				? theme.fg("warning", " ✗")
+				: theme.fg("success", " ✓")
+		: "";
 	return active
-		? `${theme.fg(color, "▸")} ${theme.fg(color, theme.bold(text))}${badge}`
-		: `${theme.fg(color, text)}${badge}`;
+		? `${attentionPrefix}${theme.fg(color, "▸")} ${theme.fg(color, theme.bold(text))}${outcomeSuffix}${activitySuffix}${badge}`
+		: `${attentionPrefix}${theme.fg(color, text)}${outcomeSuffix}${activitySuffix}${badge}`;
 }
 
 export type AgentBarStatus = AgentDisplayStatus | "idle";
@@ -102,6 +122,12 @@ interface AgentBarTab extends SessionTab {
 	endpoint: CockpitEndpoint;
 	status: AgentBarStatus;
 	color: ThemeColor;
+	/** Current tool name while the agent is live; shown after the chip label. */
+	activity?: string;
+	/** Stalled state beyond the color channel: a leading error `!`. */
+	attention?: boolean;
+	/** Terminal outcome badge: ✓ completed, ✗ failed (with reason) or terminated. */
+	outcome?: { status: "completed" | "failed" | "terminated"; message?: string };
 }
 
 function endpointStatus(endpoint: CockpitEndpoint, now: number, mainRunning: boolean): AgentBarStatus {
@@ -140,7 +166,18 @@ const CHIP_SEPARATOR = "  ";
 function renderAgentChipLine(tabs: AgentBarTab[], selectedId: string, width: number, theme: Theme): string {
 	const w = Math.max(1, width);
 	const selectedIndex = Math.max(0, tabs.findIndex((tab) => tab.id === selectedId));
-	const chips = tabs.map((tab) => chip(tab.label, tab.id === selectedId, tab.color, theme, tab.unread));
+	const chips = tabs.map((tab) => chip(
+		tab.label,
+		tab.id === selectedId,
+		tab.color,
+		theme,
+		tab.unread,
+		tab.activity,
+		tab.attention,
+		tab.outcome
+			? { status: tab.outcome.status, message: tab.outcome.message ? truncateToWidth(tab.outcome.message, 24, "…") : undefined }
+			: undefined,
+	));
 	const chipWidths = chips.map((text) => visibleWidth(text));
 	const sepWidth = visibleWidth(CHIP_SEPARATOR);
 	const totalWidth = chipWidths.reduce((sum, chipWidth) => sum + chipWidth + sepWidth, 0) - sepWidth;
@@ -223,6 +260,10 @@ export function renderAgentBar(
 	const tabs: AgentBarTab[] = endpoints.map((endpoint) => {
 		const selected = endpoint.id === selectedId;
 		const status = endpointStatus(endpoint, now, options.mainRunning === true);
+		const live = status === "running" || status === "retrying";
+		const outcome = status === "done" || status === "failed" || status === "terminated" || status === "sleeping"
+			? endpoint.agentRow?.lastOutcome
+			: undefined;
 		return {
 			id: endpoint.id,
 			label: endpoint.label,
@@ -231,10 +272,30 @@ export function renderAgentBar(
 			endpoint,
 			status,
 			color: endpointColor(endpoint, status, now, selected),
+			...(live && endpoint.agentRow?.activeTool
+				? {
+					activity: endpoint.agentRow.activeToolArgs
+						? `${endpoint.agentRow.activeTool} ${endpoint.agentRow.activeToolArgs}`
+						: endpoint.agentRow.activeTool,
+				}
+				: {}),
+			...(status === "stalled" ? { attention: true } : {}),
+			...(outcome ? { outcome } : {}),
 		};
 	});
+	// Selected-session metrics summary, appended only when the chip line leaves
+	// room for it: telemetry must never squeeze the chips that carry identity.
+	const selectedRow = tabs.find((tab) => tab.id === selectedId)?.endpoint.agentRow;
+	const metricParts: string[] = [];
+	if (selectedRow?.toolCount !== undefined) metricParts.push(tuiT("common.tools", { count: selectedRow.toolCount }));
+	if (selectedRow?.tokens !== undefined) metricParts.push(tuiT("widget.agent.tokens", { count: formatAgentMetric(selectedRow.tokens) }));
+	const metrics = metricParts.length > 0 ? theme.fg("muted", ` · ${metricParts.join(" · ")}`) : "";
 	return [renderSessionBarLine(
-		(availableWidth) => renderAgentChipLine(tabs, selectedId, availableWidth, theme),
+		(availableWidth) => {
+			const chipsLine = renderAgentChipLine(tabs, selectedId, availableWidth, theme);
+			if (!metrics || visibleWidth(chipsLine) + visibleWidth(metrics) > availableWidth) return chipsLine;
+			return chipsLine + metrics;
+		},
 		width,
 		theme,
 		options.shortcutHint,

package/src/agent-overlay.ts

@@ -3,6 +3,8 @@ import {
 	Key,
 	type Component,
 	type Focusable,
+	decodeKittyPrintable,
+	fuzzyFilter,
 	matchesKey,
 	truncateToWidth,
 	visibleWidth,
@@ -36,10 +38,148 @@ export interface AgentOverlayParams {
 
 const CARD_CHROME_ROWS = 5;
 const COMMAND_ACK_MS = 1_500;
+const MAX_STEER_DRAFT_CHARS = 4_096;
+const BRACKETED_PASTE_START = "\x1b[200~";
+const BRACKETED_PASTE_END = "\x1b[201~";
+const MAX_BUFFERED_PASTE_CHARS = 1_048_576;
+const graphemeSegmenter = typeof Intl.Segmenter === "function"
+	? new Intl.Segmenter(undefined, { granularity: "grapheme" })
+	: undefined;
 
-/** Plain letters reserved for command keys stay out of the draft. */
-function isDraftInput(data: string): boolean {
-	return data.length === 1 && data >= " ";
+/** Match the repository's single-line input cleanup without importing across packages. */
+function sanitizeDraftInput(data: string): string {
+	return data.normalize("NFC").replace(/\r\n?|\n|\t/g, " ").replace(/[\x00-\x1f\x7f-\x9f]/g, "");
+}
+
+function printableDraftInput(data: string): string {
+	const kittyPrintable = decodeKittyPrintable(data);
+	if (kittyPrintable !== undefined) return kittyPrintable;
+	// Escape/CSI-prefixed terminal input is a key sequence, not pasted text.
+	if (data.includes("\x1b") || data.includes("\x9b")) return "";
+	return sanitizeDraftInput(data);
+}
+
+function appendDraftInput(draft: string, data: string, paste = false): string {
+	const printable = paste ? sanitizeDraftInput(data) : printableDraftInput(data);
+	const remaining = MAX_STEER_DRAFT_CHARS - draft.length;
+	if (!printable || remaining <= 0) return draft;
+	if (printable.length <= remaining) return draft + printable;
+
+	let end = 0;
+	for (const segment of draftSegments(printable)) {
+		if (segment.end > remaining) break;
+		end = segment.end;
+	}
+	return draft + printable.slice(0, end);
+}
+
+interface DraftInputToken {
+	kind: "input" | "paste";
+	text: string;
+}
+
+class BracketedPasteDecoder {
+	private pasting = false;
+	private buffer = "";
+	private pending = "";
+
+	isPasting(): boolean {
+		return this.pasting;
+	}
+
+	hasPending(): boolean {
+		return this.pending.length > 0;
+	}
+
+	flushPending(): DraftInputToken[] {
+		if (!this.pending) return [];
+		const pending = this.pending;
+		this.pending = "";
+		if (this.pasting) {
+			this.appendPaste(pending);
+			return [];
+		}
+		return [{ kind: "input", text: pending }];
+	}
+
+	feed(data: string): DraftInputToken[] {
+		const tokens: DraftInputToken[] = [];
+		let rest = this.pending + data;
+		this.pending = "";
+		while (rest) {
+			if (!this.pasting) {
+				const start = rest.indexOf(BRACKETED_PASTE_START);
+				if (start < 0) {
+					const partial = partialMarkerSuffix(rest, BRACKETED_PASTE_START);
+					const input = rest.slice(0, rest.length - partial.length);
+					if (input) tokens.push({ kind: "input", text: input });
+					this.pending = partial;
+					break;
+				}
+				if (start > 0) tokens.push({ kind: "input", text: rest.slice(0, start) });
+				this.pasting = true;
+				rest = rest.slice(start + BRACKETED_PASTE_START.length);
+				continue;
+			}
+
+			const end = rest.indexOf(BRACKETED_PASTE_END);
+			if (end < 0) {
+				const partial = partialMarkerSuffix(rest, BRACKETED_PASTE_END);
+				this.appendPaste(rest.slice(0, rest.length - partial.length));
+				this.pending = partial;
+				break;
+			}
+			this.appendPaste(rest.slice(0, end));
+			tokens.push({ kind: "paste", text: this.buffer });
+			this.buffer = "";
+			this.pasting = false;
+			rest = rest.slice(end + BRACKETED_PASTE_END.length);
+		}
+		return tokens;
+	}
+
+	private appendPaste(value: string): void {
+		const remaining = MAX_BUFFERED_PASTE_CHARS - this.buffer.length;
+		if (remaining > 0) this.buffer += value.slice(0, remaining);
+	}
+}
+
+function partialMarkerSuffix(value: string, marker: string): string {
+	const limit = Math.min(value.length, marker.length - 1);
+	for (let length = limit; length >= 1; length--) {
+		const suffix = value.slice(-length);
+		if (marker.startsWith(suffix)) return suffix;
+	}
+	return "";
+}
+
+function removeLastDraftGrapheme(draft: string): string {
+	const segments = draftSegments(draft);
+	return segments.length === 0 ? draft : draft.slice(0, segments[segments.length - 1].start);
+}
+
+function draftSegments(value: string): Array<{ start: number; end: number }> {
+	if (graphemeSegmenter) {
+		const parts = [...graphemeSegmenter.segment(value)];
+		return parts.map((part, index) => ({ start: part.index, end: parts[index + 1]?.index ?? value.length }));
+	}
+
+	const segments: Array<{ start: number; end: number }> = [];
+	let start = 0;
+	for (const char of value) {
+		const end = start + char.length;
+		segments.push({ start, end });
+		start = end;
+	}
+	return segments;
+}
+
+/** Printable text for the search query: single chars, paste and CJK alike. */
+function isSearchInput(data: string): boolean {
+	return data.length > 0 && [...data].every((ch) => {
+		const code = ch.codePointAt(0)!;
+		return code >= 0x20 && code !== 0x7f && !(code >= 0x80 && code <= 0x9f);
+	});
 }
 
 export class AgentOverlay implements Component, Focusable {
@@ -48,9 +188,14 @@ export class AgentOverlay implements Component, Focusable {
 	private outputScroll: AgentScrollState = { offset: 0, following: true };
 	private detailWidth = 80;
 	private detailRows = 8;
-	private compose: { targetId: string; draft: string } | null = null;
+	private compose: { targetId: string; draft: string; input: BracketedPasteDecoder } | null = null;
+	/** Active `/` search mode; the query string may be empty while searching. */
+	private searching = false;
+	/** Current search query; empty string means no filtering. */
+	private search = "";
 	private lastAck: { text: string; at: number; error?: boolean } | null = null;
 	private ackTimer: ReturnType<typeof setTimeout> | undefined;
+	private pasteFlushTimer: ReturnType<typeof setTimeout> | undefined;
 
 	constructor(private readonly params: AgentOverlayParams) {
 		this.selectedId = params.getViewingId();
@@ -59,36 +204,65 @@ export class AgentOverlay implements Component, Focusable {
 	invalidate(): void {}
 	dispose(): void {
 		if (this.ackTimer) clearTimeout(this.ackTimer);
+		if (this.pasteFlushTimer) clearTimeout(this.pasteFlushTimer);
 		this.ackTimer = undefined;
+		this.pasteFlushTimer = undefined;
 	}
 
 	handleInput(data: string): void {
 		if (this.compose) {
+			const input = this.compose.input;
+			if (this.pasteFlushTimer) clearTimeout(this.pasteFlushTimer);
+			this.pasteFlushTimer = undefined;
+			for (const token of input.feed(data)) this.handleComposeToken(token);
+			if (this.compose?.input === input && input.hasPending() && !input.isPasting()) {
+				this.pasteFlushTimer = setTimeout(() => {
+					this.pasteFlushTimer = undefined;
+					if (this.compose?.input !== input) return;
+					for (const token of input.flushPending()) this.handleComposeToken(token);
+					this.params.requestRender();
+				}, 16);
+				this.pasteFlushTimer.unref?.();
+			}
+			this.params.requestRender();
+			return;
+		}
+		const printableInput = decodeKittyPrintable(data);
+		const commandInput = printableInput ?? data;
+		if (this.searching) {
+			// Search mode: printable characters extend the query, backspace trims
+			// it. Esc exits and clears; Enter locks the filter so the roster
+			// commands (↑↓ / i / s) apply to the narrowed set.
 			if (matchesKey(data, Key.escape)) {
-				this.compose = null;
+				this.searching = false;
+				this.search = "";
 			} else if (data === "\r" || data === "\n") {
-				const targetId = this.compose.targetId;
-				const draft = this.compose.draft.trim();
-				this.compose = null;
-				// The compose target is frozen: the steer must never silently
-				// re-target another agent because the roster selection moved.
-				const target = this.entries().find((entry) => entry.row.correlationId === targetId)?.row;
-				if (!target) {
-					this.ack(tuiT("overlay.agents.aborted", { agent: this.agentName(targetId) }), true);
-				} else if (draft) {
-					this.params.onCommand(targetId, "steer", draft);
-					this.ack(`steer @${target.name || target.role || target.agent || targetId}: ${draft}`);
-				}
+				this.searching = false;
 			} else if (data === "\x7f" || data === "\x08") {
-				this.compose.draft = this.compose.draft.slice(0, -1);
-			} else if (isDraftInput(data)) {
-				this.compose.draft += data;
+				this.search = this.search.slice(0, -1);
+			} else if (isSearchInput(commandInput)) {
+				this.search += commandInput;
 			}
+			this.reconcileSelection(this.entries().map((entry) => entry.row));
+			this.params.requestRender();
+			return;
+		}
+		if (commandInput === "/") {
+			this.searching = true;
+			this.search = "";
 			this.params.requestRender();
 			return;
 		}
 		if (matchesKey(data, Key.escape)) {
-			this.params.close();
+			// A locked filter (Enter left a non-empty query) is cleared by the
+			// first Esc, the second one closes the overlay.
+			if (this.search !== "") {
+				this.search = "";
+				this.reconcileSelection(this.entries().map((entry) => entry.row));
+			} else {
+				this.params.close();
+			}
+			this.params.requestRender();
 			return;
 		}
 		if (matchesKey(data, Key.up)) {
@@ -115,21 +289,53 @@ export class AgentOverlay implements Component, Focusable {
 			this.scrollOutput(Math.max(1, this.detailRows - 2));
 			return;
 		}
-		if (data === "i" && this.selectedId) {
+		if (commandInput === "i" && this.selectedId) {
 			// Interrupt (打断): abort the current turn/tool; the agent stays alive
 			// and is told to report and continue.
 			this.params.onCommand(this.selectedId, "interrupt");
 			this.ack(`interrupt @${this.agentName(this.selectedId)}`);
 			return;
 		}
-		if (data === "s" && this.selectedId) {
+		if (commandInput === "s" && this.selectedId) {
 			// Steer (引导): interrupt + inject the drafted message. The target is
 			// frozen at compose time so later roster changes cannot re-target it.
-			this.compose = { targetId: this.selectedId, draft: "" };
+			this.compose = { targetId: this.selectedId, draft: "", input: new BracketedPasteDecoder() };
 			this.params.requestRender();
 		}
 	}
 
+	private handleComposeToken(token: DraftInputToken): void {
+		if (!this.compose) return;
+		if (token.kind === "paste") {
+			this.compose.draft = appendDraftInput(this.compose.draft, token.text, true);
+			return;
+		}
+		if (matchesKey(token.text, Key.escape)) {
+			this.compose = null;
+			return;
+		}
+		if (token.text === "\r" || token.text === "\n") {
+			const targetId = this.compose.targetId;
+			const draft = this.compose.draft.trim();
+			this.compose = null;
+			// The compose target is frozen: the steer must never silently
+			// re-target another agent because the roster selection moved.
+			const target = this.unfilteredEntries().find((entry) => entry.row.correlationId === targetId)?.row;
+			if (!target) {
+				this.ack(tuiT("overlay.agents.aborted", { agent: this.agentName(targetId) }), true);
+			} else if (draft) {
+				this.params.onCommand(targetId, "steer", draft);
+				this.ack(`steer @${target.name || target.role || target.agent || targetId}: ${draft}`);
+			}
+			return;
+		}
+		if (token.text === "\x7f" || token.text === "\x08") {
+			this.compose.draft = removeLastDraftGrapheme(this.compose.draft);
+			return;
+		}
+		this.compose.draft = appendDraftInput(this.compose.draft, token.text);
+	}
+
 	private ack(text: string, error = false): void {
 		this.lastAck = { text, at: Date.now(), ...(error ? { error: true } : {}) };
 		if (this.ackTimer) clearTimeout(this.ackTimer);
@@ -143,7 +349,7 @@ export class AgentOverlay implements Component, Focusable {
 	}
 
 	private agentName(correlationId: string): string {
-		const row = this.entries().find((entry) => entry.row.correlationId === correlationId)?.row;
+		const row = this.unfilteredEntries().find((entry) => entry.row.correlationId === correlationId)?.row;
 		return row?.name || row?.role || row?.agent || correlationId.slice(0, 8);
 	}
 
@@ -158,6 +364,9 @@ export class AgentOverlay implements Component, Focusable {
 				const target = this.agentName(this.compose.targetId);
 				return [fit(`steer @${target}: ${this.compose.draft}_ · Enter · Esc`, safeWidth)];
 			}
+			if (this.searching || this.search.trim() !== "") {
+				return [fit(`${tuiT("overlay.agents.searchPrompt")} ${this.search}_ (${entries.length}) · Esc`, safeWidth)];
+			}
 			const selected = entries.find((entry) => entry.row.correlationId === this.selectedId)?.row;
 			const title = tuiT("overlay.agents.title");
 			return [fit(
@@ -206,12 +415,28 @@ export class AgentOverlay implements Component, Focusable {
 	}
 
 	private entries() {
+		const entries = this.unfilteredEntries();
+		const query = this.search.trim();
+		if (!query) return entries;
+		// A search flattens the tree: the query already broke the hierarchy, so
+		// keeping dangling branch glyphs would only add noise to the results.
+		return fuzzyFilter(entries, query, (entry) =>
+			`${entry.row.name ?? ""} ${entry.row.role} ${entry.row.agent} ${entry.row.task}`,
+		).map((entry) => ({ ...entry, prefix: "" }));
+	}
+
+	private unfilteredEntries() {
 		return buildAgentTree(visibleAgentRows([...this.params.getAgents()]), this.params.glyphs);
 	}
 
 	private agentLines(width: number, maxRows: number): string[] {
 		const entries = this.entries();
-		if (entries.length === 0) return [this.params.theme.fg("dim", fit(tuiT("overlay.agents.noAgents"), width))];
+		if (entries.length === 0) {
+			return [this.params.theme.fg("dim", fit(
+				this.searching || this.search.trim() !== "" ? tuiT("overlay.agents.noMatches") : tuiT("overlay.agents.noAgents"),
+				width,
+			))];
+		}
 		const selected = Math.max(0, entries.findIndex((entry) => entry.row.correlationId === this.selectedId));
 		const start = visibleStart(selected, entries.length, maxRows);
 		return entries.slice(start, start + maxRows).map(({ row, prefix }) => {
@@ -246,6 +471,11 @@ export class AgentOverlay implements Component, Focusable {
 			const target = this.agentName(this.compose.targetId);
 			return fit(`steer @${target}: ${this.compose.draft}_`, width);
 		}
+		if (this.searching || this.search.trim() !== "") {
+			const entries = this.entries();
+			const total = buildAgentTree(visibleAgentRows([...this.params.getAgents()]), this.params.glyphs).length;
+			return fit(`${this.params.theme.fg("accent", tuiT("overlay.agents.searchPrompt"))} ${this.search}_ (${entries.length}/${total})`, width);
+		}
 		const rows = this.entries().map((entry) => entry.row);
 		const statuses = rows.map((row) => effectiveAgentStatus(row));
 		const active = statuses.filter((status) => status === "running" || status === "retrying").length;
@@ -266,7 +496,10 @@ export class AgentOverlay implements Component, Focusable {
 		if (this.compose) {
 			return this.params.theme.fg("dim", fit(tuiT("overlay.agents.composeHelp"), width));
 		}
-		return this.params.theme.fg("dim", fit(tuiT("overlay.agents.help"), width));
+		if (this.searching || this.search.trim() !== "") {
+			return this.params.theme.fg("dim", fit(tuiT("overlay.agents.searchHelp"), width));
+		}
+		return this.params.theme.fg("dim", fit(`${tuiT("overlay.agents.help")} · ${tuiT("overlay.agents.searchHint")}`, width));
 	}
 
 	private rule(width: number): string {

package/src/agents-store.ts

@@ -63,7 +63,7 @@ export type MessagePayload = Partial<Omit<
 	"progress" | "recentTools" | "isSend" | "isInteraction"
 >> & {
 	progress?: ProgressPayload[];
-	recentTools?: Array<string | { name?: string; status?: string }>;
+	recentTools?: Array<string | { name?: string; status?: string; argsPreview?: string }>;
 	isSend?: boolean;
 	isInteraction?: boolean;
 	/** Compatibility with pre-v1 progress deltas; discriminated send events are ignored. */
@@ -164,21 +164,30 @@ function terminalTime(
 	return row.finishedAt ?? now;
 }
 
-function latestTool(tools: Array<string | { name?: string; status?: string }> | undefined): string | undefined {
+function latestTool(tools: Array<string | { name?: string; status?: string; argsPreview?: string }> | undefined): { name: string; argsPreview?: string } | undefined {
 	if (!tools?.length) return undefined;
 	const tool = tools.find((candidate) => typeof candidate === "object" && candidate?.status === "running")
 		?? tools.at(-1);
 	if (!tool) return undefined;
-	if (typeof tool === "string") return truncateStatusText(tool);
+	if (typeof tool === "string") {
+		const name = truncateStatusText(tool);
+		return name ? { name } : undefined;
+	}
 	const name = tool?.name?.trim();
 	if (!name) return undefined;
 	const status = tool.status?.trim();
 	// The active tool is by definition the one in flight, so "bash (running)"
 	// only repeats the row's own live state. Keep the suffix only for
 	// anomalies (failed/error) that the row state does not already convey.
-	return truncateStatusText(
+	const displayName = truncateStatusText(
 		status && status !== "completed" && status !== "running" ? `${name} (${status})` : name,
 	);
+	return {
+		name: displayName,
+		...(typeof tool.argsPreview === "string" && tool.argsPreview.trim()
+			? { argsPreview: truncateText(tool.argsPreview, 140) }
+			: {}),
+	};
 }
 
 // Self-accumulating roster. The teammate extension only broadcasts deltas
@@ -326,8 +335,14 @@ export class AgentsStore {
 		if (typeof tail === "string" && tail.length > 0) row.tail = truncateSessionContent(tail);
 		if (p.recentTools) {
 			const tool = latestTool(p.recentTools);
-			if (tool) row.activeTool = tool;
-			else delete row.activeTool;
+			if (tool) {
+				row.activeTool = tool.name;
+				if (tool.argsPreview) row.activeToolArgs = tool.argsPreview;
+				else delete row.activeToolArgs;
+			} else {
+				delete row.activeTool;
+				delete row.activeToolArgs;
+			}
 		}
 		if (typeof p.toolCount === "number") row.toolCount = p.toolCount;
 		if (typeof p.tokens === "number") row.tokens = p.tokens;
@@ -524,8 +539,14 @@ export class AgentsStore {
 		row.lastActivityAt = normalizeStartedAt(p.lastActivityAt, now);
 		if (p.recentTools) {
 			const tool = latestTool(p.recentTools);
-			if (tool) row.activeTool = tool;
-			else delete row.activeTool;
+			if (tool) {
+				row.activeTool = tool.name;
+				if (tool.argsPreview) row.activeToolArgs = tool.argsPreview;
+				else delete row.activeToolArgs;
+			} else {
+				delete row.activeTool;
+				delete row.activeToolArgs;
+			}
 		}
 		if (typeof p.toolCount === "number") row.toolCount = p.toolCount;
 		if (typeof p.tokens === "number") row.tokens = p.tokens;

package/src/session-detail.ts

@@ -143,7 +143,10 @@ export function renderSessionDetail(
 		})}`));
 	}
 	if (row.activeTool) {
-		body.push(truncateToWidth(theme.fg("dim", `  ${theme.fg("warning", "→")} ${row.activeTool}`), w, "…"));
+		const toolLine = row.activeToolArgs
+			? `  ${theme.fg("warning", "→")} ${row.activeTool} ${theme.fg("dim", truncateToWidth(row.activeToolArgs, Math.max(1, w - 12), "…"))}`
+			: `  ${theme.fg("warning", "→")} ${row.activeTool}`;
+		body.push(truncateToWidth(toolLine, w, "…"));
 	}
 	if (row.error) {
 		body.push(theme.fg("error", `  ✗ ${truncateToWidth(row.error, Math.max(1, w - 4), "…")}`));

package/src/tui-i18n.ts

@@ -87,6 +87,10 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"overlay.agents.aborted": "steer aborted: @{agent} is gone",
 		"overlay.agents.help": "Esc close · ↑↓ agent · Home/End jump · PgUp/PgDn output · i interrupt · s steer",
 		"overlay.agents.composeHelp": "Enter send · Esc cancel",
+		"overlay.agents.searchHint": "/ search",
+		"overlay.agents.searchPrompt": "search:",
+		"overlay.agents.noMatches": "No matching agents",
+		"overlay.agents.searchHelp": "Esc clear · ↑↓ agent",
 		"overlay.jobs.title": "Background jobs",
 		"overlay.jobs.empty": "{mark} no background jobs{separator}use bash_bg action=start",
 		"overlay.jobs.refreshing": "refreshing…",
@@ -332,6 +336,10 @@ export const COCKPIT_TUI_CATALOGS: TranslationCatalogs = {
 		"overlay.agents.aborted": "引导已取消：@{agent} 已离开",
 		"overlay.agents.help": "Esc 关闭 · ↑↓ Agent · Home/End 跳转 · PgUp/PgDn 输出 · i 打断 · s 引导",
 		"overlay.agents.composeHelp": "Enter 发送 · Esc 取消",
+		"overlay.agents.searchHint": "/ 搜索",
+		"overlay.agents.searchPrompt": "搜索：",
+		"overlay.agents.noMatches": "没有匹配的 Agent",
+		"overlay.agents.searchHelp": "Esc 清除 · ↑↓ Agent",
 		"overlay.jobs.title": "后台任务",
 		"overlay.jobs.empty": "{mark} 没有后台任务{separator}使用 bash_bg action=start",
 		"overlay.jobs.refreshing": "刷新中…",

package/src/types.ts

@@ -63,11 +63,14 @@ export interface AgentRow {
 	cacheWriteTokens?: number;
 	/** Latest provider/runtime diagnostic from the authoritative progress snapshot. */
 	error?: string;
+	/** Current tool name while running, from the progress snapshot's recent tools. */
+	activeTool?: string;
+	/** Redacted one-line argument summary of the current tool call. */
+	activeToolArgs?: string;
 	requestedModel?: string;
 	resolvedModel?: string;
 	attemptedModels?: string[];
 	taskStatus?: string;
-	activeTool?: string;
 	taskIndex?: number;
 	dependencies?: number[];
 	/** Set only on a failed row that outlived its completion, so it can be pruned. */