oira666_pi-subagent 0.2.19 → 0.2.21

package/render.ts

@@ -1,463 +1,471 @@
-/**
- * TUI rendering for subagent tool calls and results.
- */
-
-import * as os from "node:os";
-import { Container, Spacer, Text } from "@mariozechner/pi-tui";
-import {
-	type LiveLogEntry,
-	type NestedSubagentResult,
-	type SingleResult,
-	type SubagentDetails,
-	type UsageStats,
-	aggregateUsage,
-	getDisplayItems,
-	getFinalOutput,
-	getNestedSubagentResults,
-	isResultError,
-	isSubagentDetails,
-} from "./types.js";
-
-const OUTPUT_PREVIEW_LINE_COUNT = 6;
-
-type ThemeFg = (color: string, text: string) => string;
-type NodeStatus = "running" | "success" | "error";
-
-interface TreeNode {
-	label: string;
-	status: NodeStatus;
-	meta?: string;
-	task?: string;
-	outputPreview?: string[];
-	liveActivity?: LiveLogEntry[];
-	children: TreeNode[];
-}
-
-
-interface TreeCounts {
-	total: number;
-	running: number;
-	success: number;
-	error: number;
-	finished: number;
-}
-
-interface PendingSubagentCall {
-	toolCallId: string;
-	tasks: Array<{ agent: string; task?: string; cwd?: string }>;
-}
-
-// ---------------------------------------------------------------------------
-// Formatting helpers
-// ---------------------------------------------------------------------------
-
-function formatTokens(count: number): string {
-	if (count < 1000) return count.toString();
-	if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
-	if (count < 1000000) return `${Math.round(count / 1000)}k`;
-	return `${(count / 1000000).toFixed(1)}M`;
-}
-
-function formatUsage(usage: Partial<UsageStats>, model?: string): string {
-	const parts: string[] = [];
-	const totalTokens =
-		(usage.input || 0) +
-		(usage.output || 0) +
-		(usage.cacheRead || 0) +
-		(usage.cacheWrite || 0);
-	if (usage.turns) parts.push(`${usage.turns} turn${usage.turns > 1 ? "s" : ""}`);
-	if (totalTokens > 0) parts.push(`tok:${formatTokens(totalTokens)}`);
-	if (usage.input) parts.push(`in:${formatTokens(usage.input)}`);
-	if (usage.output) parts.push(`out:${formatTokens(usage.output)}`);
-	if (usage.cacheRead) parts.push(`cacheR:${formatTokens(usage.cacheRead)}`);
-	if (usage.cacheWrite) parts.push(`cacheW:${formatTokens(usage.cacheWrite)}`);
-	if (usage.cost) parts.push(`$${usage.cost.toFixed(4)}`);
-	if (usage.contextTokens && usage.contextTokens > 0) parts.push(`ctx:${formatTokens(usage.contextTokens)}`);
-	if (model) parts.push(model);
-	return parts.join(" • ");
-}
-
-function truncate(text: string, maxLen: number): string {
-	return text.length > maxLen ? `${text.slice(0, maxLen)}...` : text;
-}
-
-function splitOutputLines(text: string): string[] {
-	const lines = text.replace(/\r\n?/g, "\n").split("\n");
-	if (lines.length > 1 && lines[lines.length - 1] === "") lines.pop();
-	return lines;
-}
-
-function lastNonEmptyLines(text: string, limit: number): string[] {
-	return splitOutputLines(text)
-		.map((line) => line.trimEnd())
-		.filter((line) => line.trim().length > 0)
-		.slice(-limit);
-}
-
-function statusEmoji(status: NodeStatus, theme: { fg: ThemeFg }): string {
-	switch (status) {
-		case "running":
-			return theme.fg("warning", "⏳");
-		case "error":
-			return theme.fg("error", "❌");
-		default:
-			return theme.fg("success", "✅");
-	}
-}
-
-function statusFromResult(result: SingleResult): NodeStatus {
-	if (result.exitCode === -1) return "running";
-	return isResultError(result) ? "error" : "success";
-}
-
-function countNodes(nodes: TreeNode[]): TreeCounts {
-	const counts: TreeCounts = {
-		total: 0,
-		running: 0,
-		success: 0,
-		error: 0,
-		finished: 0,
-	};
-
-	const visit = (node: TreeNode) => {
-		counts.total++;
-		if (node.status === "running") counts.running++;
-		if (node.status === "success") counts.success++;
-		if (node.status === "error") counts.error++;
-		if (node.status !== "running") counts.finished++;
-		for (const child of node.children) visit(child);
-	};
-
-	for (const node of nodes) visit(node);
-	return counts;
-}
-
-function hasNestedChildren(nodes: TreeNode[]): boolean {
-	return nodes.some((node) => node.children.length > 0 || hasNestedChildren(node.children));
-}
-
-function extractPendingSubagentCalls(messages: SingleResult["messages"]): PendingSubagentCall[] {
-	const calls: PendingSubagentCall[] = [];
-	for (let messageIndex = 0; messageIndex < messages.length; messageIndex++) {
-		const message = messages[messageIndex] as any;
-		if (message.role !== "assistant" || !Array.isArray(message.content)) continue;
-		for (let partIndex = 0; partIndex < message.content.length; partIndex++) {
-			const part = message.content[partIndex] as any;
-			if (part?.type !== "toolCall" || part?.name !== "subagent") continue;
-			const args = part.arguments && typeof part.arguments === "object" ? part.arguments : {};
-			const tasks = Array.isArray((args as any).tasks)
-				? (args as any).tasks
-						.filter((task: any) => task && typeof task.agent === "string")
-						.map((task: any) => ({
-							agent: task.agent,
-							task: typeof task.task === "string" ? task.task : undefined,
-							cwd: typeof task.cwd === "string" ? task.cwd : undefined,
-						}))
-				: [];
-			calls.push({
-				toolCallId:
-					typeof part.toolCallId === "string"
-						? part.toolCallId
-						: typeof part.id === "string"
-							? part.id
-							: `${messageIndex}:${partIndex}`,
-				tasks,
-			});
-		}
-	}
-	return calls;
-}
-
-function buildPendingNodes(call: PendingSubagentCall): TreeNode[] {
-	return call.tasks.map((task) => ({
-		label: task.agent,
-		status: "running",
-		task: task.task,
-		children: [],
-	}));
-}
-
-function buildNodesFromNestedResult(nested: NestedSubagentResult): TreeNode[] {
-	return nested.details.results.map((result) => buildResultNode(result));
-}
-
-function subagentCallSignature(call: PendingSubagentCall): string {
-	return JSON.stringify(call.tasks.map((task) => ({ agent: task.agent, task: task.task ?? "", cwd: task.cwd ?? "" })));
-}
-
-function nestedResultIsHealthy(nested: NestedSubagentResult | undefined): boolean {
-	if (!nested || nested.isError) return false;
-	return nested.details.results.every((result) => !isResultError(result));
-}
-
-function buildNestedChildren(result: SingleResult): TreeNode[] {
-	const parentIsRunning = result.exitCode === -1;
-	const completedByToolCallId = new Map<string, NestedSubagentResult>();
-	for (const nested of getNestedSubagentResults(result.messages)) {
-		completedByToolCallId.set(nested.toolCallId, nested);
-	}
-
-	const calls = extractPendingSubagentCalls(result.messages);
-	const laterResumeBySignature = new Map<string, number>();
-	calls.forEach((call, index) => {
-		const completed = completedByToolCallId.get(call.toolCallId);
-		// A resumed call has the same task signature as the interrupted call but a
-		// newer toolCallId. Prefer that newer running/successful tree over the old
-		// synthetic/aborted result so resumed nested subagents render in-place.
-		if (!completed || nestedResultIsHealthy(completed)) {
-			laterResumeBySignature.set(subagentCallSignature(call), index);
-		}
-	});
-
-	const nodes: TreeNode[] = [];
-	calls.forEach((call, index) => {
-		const completed = completedByToolCallId.get(call.toolCallId);
-		const newerEquivalent = laterResumeBySignature.get(subagentCallSignature(call));
-		if (
-			newerEquivalent !== undefined &&
-			newerEquivalent > index &&
-			(!completed || completed.isError || !nestedResultIsHealthy(completed))
-		) {
-			return;
-		}
-
-		if (completed && isSubagentDetails(completed.details)) {
-			nodes.push(...buildNodesFromNestedResult(completed));
-			return;
-		}
-		// Unmatched subagent tool calls are useful while the parent is still
-		// running (they show live pending children). Once the parent finished,
-		// unmatched calls are stale history from an interrupted/resumed session and
-		// must not keep the whole tree in a perpetual "running" state.
-		if (parentIsRunning) nodes.push(...buildPendingNodes(call));
-	});
-	return nodes;
-}
-
-function formatToolArgPreview(toolName: string, args: Record<string, unknown>): string {
-	const shorten = (p: string) => {
-		const home = os.homedir();
-		return p.startsWith(home) ? `~${p.slice(home.length)}` : p;
-	};
-	const truncateTo = (s: string, n: number) =>
-		s.length > n ? s.slice(0, n) + "\u2026" : s;
-
-	switch (toolName) {
-		case "bash": {
-			const cmd = (args.command as string) || "";
-			return truncateTo(cmd.replace(/\s+/g, " "), 52);
-		}
-		case "read":
-		case "write":
-		case "edit":
-			return shorten(truncateTo((args.path ?? args.file_path ?? "") as string, 52));
-		case "grep":
-			return truncateTo(`/${args.pattern}/`, 30) +
-				   (args.path ? ` in ${shorten(args.path as string)}` : "");
-		case "find":
-			return truncateTo((args.pattern ?? "*") as string, 30) +
-				   (args.path ? ` in ${shorten(args.path as string)}` : "");
-		case "subagent": {
-			const tasks = (args.tasks as any[]) ?? [];
-			return tasks.map((t: any) => t.agent).join(", ");
-		}
-		default:
-			return "";
-	}
-}
-
-function formatLiveLogEntry(
-	entry: LiveLogEntry,
-	theme: { fg: ThemeFg },
-): string {
-	switch (entry.kind) {
-		case "turn_start":
-			return theme.fg("muted", "\u27f3") + " " + theme.fg("dim", "thinking\u2026");
-
-		case "turn_end": {
-			const tokens = entry.inputTokens || entry.outputTokens
-				? " " + theme.fg("dim",
-					`\u2191${formatTokens(entry.inputTokens)} \u2193${formatTokens(entry.outputTokens)}`)
-				: "";
-			return (
-				theme.fg("success", "\u2713") +
-				" " +
-				theme.fg("muted", `turn ${entry.turn}`) +
-				tokens
-			);
-		}
-
-		case "tool_start": {
-			const argPreview = formatToolArgPreview(entry.toolName, entry.args);
-			return (
-				theme.fg("muted", "\u2192") +
-				" " +
-				theme.fg("accent", entry.toolName) +
-				(argPreview ? "  " + theme.fg("dim", argPreview) : "")
-			);
-		}
-
-		case "tool_end":
-			return (
-				theme.fg("success", "\u2713") +
-				" " +
-				theme.fg("accent", entry.toolName)
-			);
-	}
-}
-
-function buildLeafPreview(result: SingleResult): string[] | undefined {
-	const items = getDisplayItems(result.messages);
-	const lines: string[] = [];
-	for (const item of items) {
-		if (item.type === "text") {
-			lines.push(...lastNonEmptyLines(item.text, OUTPUT_PREVIEW_LINE_COUNT));
-		}
-	}
-	const finalOutput = getFinalOutput(result.messages);
-	if (finalOutput) lines.push(...lastNonEmptyLines(finalOutput, OUTPUT_PREVIEW_LINE_COUNT));
-	const unique = lines.filter((line, index) => line && lines.indexOf(line) === index);
-	return unique.length > 0 ? unique.slice(-OUTPUT_PREVIEW_LINE_COUNT) : undefined;
-}
-
-function buildResultNode(result: SingleResult): TreeNode {
-	const status = statusFromResult(result);
-	const usage = formatUsage(result.usage, result.model);
-	const metaParts: string[] = [result.agentSource];
-	if (usage) metaParts.push(usage);
-	if (status === "error") {
-		const errorText = result.errorMessage || result.stderr || result.stopReason;
-		if (errorText) metaParts.push(truncate(errorText.replace(/\s+/g, " "), 120));
-	}
-
-	const children = buildNestedChildren(result);
-	const isRunning = status === "running";
-	return {
-		label: result.agent,
-		status,
-		meta: metaParts.join(" • "),
-		task: result.task,
-		liveActivity: isRunning && result.liveLog?.length > 0 ? result.liveLog : undefined,
-		outputPreview: !isRunning && children.length === 0 ? buildLeafPreview(result) : undefined,
-		children,
-	};
-}
-
-function buildTopLevelNodes(details: SubagentDetails): TreeNode[] {
-	return details.results.map((result) => buildResultNode(result));
-}
-
-function renderTreeLines(
-	nodes: TreeNode[],
-	theme: { fg: ThemeFg },
-	showOutputPreview: boolean,
-	depth = 0,
-): string[] {
-	const lines: string[] = [];
-
-	for (const node of nodes) {
-		const indent = "  ".repeat(depth);
-		let line = `${indent}${statusEmoji(node.status, theme)} ${theme.fg("accent", node.label)}`;
-		if (node.meta) line += ` ${theme.fg("dim", node.meta)}`;
-		lines.push(line);
-
-		if (showOutputPreview && node.outputPreview && node.outputPreview.length > 0) {
-			for (const outputLine of node.outputPreview) {
-				lines.push(`${indent}  ${theme.fg("toolOutput", outputLine)}`);
-			}
-		}
-
-		if (showOutputPreview && node.liveActivity && node.liveActivity.length > 0) {
-			for (const entry of node.liveActivity) {
-				lines.push(`${indent}  ${formatLiveLogEntry(entry, theme)}`);
-			}
-		}
-
-		if (node.children.length > 0) {
-			lines.push(...renderTreeLines(node.children, theme, false, depth + 1));
-		}
-	}
-
-	return lines;
-}
-
-function topLevelSummary(details: SubagentDetails, counts: TreeCounts): string {
-	// aggregatedUsage includes own agents + all their nested descendants;
-	// fall back to summing only direct results for old serialised data lacking the field.
-	const totalUsage = formatUsage(
-		details.aggregatedUsage ?? aggregateUsage(details.results),
-	);
-	const parts = [
-		`${counts.running} running`,
-		`${counts.finished}/${counts.total} finished`,
-		`${counts.success} ok`,
-		`${counts.error} error`,
-	];
-	if (totalUsage) parts.push(totalUsage);
-	return parts.join(" • ");
-}
-
-// ---------------------------------------------------------------------------
-// renderCall — shown while the tool is being invoked
-// ---------------------------------------------------------------------------
-
-export function renderCall(
-	args: Record<string, any>,
-	theme: { fg: ThemeFg; bold: (s: string) => string },
-	context?: { isPartial?: boolean; isError?: boolean },
-): Text {
-	const tasks = Array.isArray(args.tasks) ? args.tasks : [];
-	const count = tasks.length;
-	const icon = context?.isPartial === false
-		? context.isError
-			? theme.fg("error", "❌")
-			: theme.fg("success", "✅")
-		: theme.fg("warning", "⏳");
-	let text = `${theme.fg("toolTitle", theme.bold("subagent "))}${theme.fg("accent", `${count} task${count === 1 ? "" : "s"}`)}`;
-	for (const task of tasks.slice(0, 6)) {
-		const agent = typeof task?.agent === "string" ? task.agent : "...";
-		const preview = typeof task?.task === "string" ? ` ${truncate(task.task, 56)}` : "";
-		text += `\n  ${icon} ${theme.fg("accent", agent)}${theme.fg("dim", preview)}`;
-	}
-	if (tasks.length > 6) text += `\n  ${theme.fg("muted", `... +${tasks.length - 6} more`)}`;
-	return new Text(text, 0, 0);
-}
-
-// ---------------------------------------------------------------------------
-// renderResult — shown after the tool completes / streams updates
-// ---------------------------------------------------------------------------
-
-export function renderResult(
-	result: { content: Array<{ type: string; text?: string }>; details?: unknown },
-	_expanded: boolean,
-	theme: { fg: ThemeFg; bold: (s: string) => string },
-): Container | Text {
-	const details = result.details as SubagentDetails | undefined;
-	if (!details || details.results.length === 0) {
-		const first = result.content[0];
-		return new Text(first?.type === "text" && first.text ? first.text : "(no output)", 0, 0);
-	}
-
-	const nodes = buildTopLevelNodes(details);
-	const counts = countNodes(nodes);
-	const showOutputPreview = !hasNestedChildren(nodes);
-	const icon = counts.running > 0
-		? theme.fg("warning", "⏳")
-		: counts.error > 0
-			? theme.fg("error", "❌")
-			: theme.fg("success", "✅");
-
-	const container = new Container();
-	container.addChild(
-		new Text(
-			`${icon} ${theme.fg("toolTitle", theme.bold("subagent tree "))}${theme.fg("dim", topLevelSummary(details, counts))}`,
-			0,
-			0,
-		),
-	);
-
-	container.addChild(new Spacer(1));
-	container.addChild(new Text(renderTreeLines(nodes, theme, showOutputPreview).join("\n"), 0, 0));
-
-	return container;
-}
+/**
+ * TUI rendering for subagent tool calls and results.
+ */
+
+import * as os from "node:os";
+import { Container, Spacer, Text } from "@mariozechner/pi-tui";
+import {
+	type LiveLogEntry,
+	type NestedSubagentResult,
+	type SingleResult,
+	type SubagentDetails,
+	type UsageStats,
+	aggregateUsage,
+	getDisplayItems,
+	getFinalOutput,
+	getNestedSubagentResults,
+	isResultError,
+	isSubagentDetails,
+} from "./types.js";
+
+const OUTPUT_PREVIEW_LINE_COUNT = 6;
+
+let broadcastNumberingActive = false;
+
+export function setBroadcastNumberingActive(active: boolean): void {
+	broadcastNumberingActive = active;
+}
+
+type ThemeFg = (color: string, text: string) => string;
+type NodeStatus = "running" | "success" | "error";
+
+interface TreeNode {
+	label: string;
+	status: NodeStatus;
+	meta?: string;
+	task?: string;
+	outputPreview?: string[];
+	liveActivity?: LiveLogEntry[];
+	children: TreeNode[];
+}
+
+
+interface TreeCounts {
+	total: number;
+	running: number;
+	success: number;
+	error: number;
+	finished: number;
+}
+
+interface PendingSubagentCall {
+	toolCallId: string;
+	tasks: Array<{ agent: string; task?: string }>;
+}
+
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+
+function formatTokens(count: number): string {
+	if (count < 1000) return count.toString();
+	if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
+	if (count < 1000000) return `${Math.round(count / 1000)}k`;
+	return `${(count / 1000000).toFixed(1)}M`;
+}
+
+function formatUsage(usage: Partial<UsageStats>, model?: string): string {
+	const parts: string[] = [];
+	const totalTokens =
+		(usage.input || 0) +
+		(usage.output || 0) +
+		(usage.cacheRead || 0) +
+		(usage.cacheWrite || 0);
+	if (usage.turns) parts.push(`${usage.turns} turn${usage.turns > 1 ? "s" : ""}`);
+	if (totalTokens > 0) parts.push(`tok:${formatTokens(totalTokens)}`);
+	if (usage.input) parts.push(`in:${formatTokens(usage.input)}`);
+	if (usage.output) parts.push(`out:${formatTokens(usage.output)}`);
+	if (usage.cacheRead) parts.push(`cacheR:${formatTokens(usage.cacheRead)}`);
+	if (usage.cacheWrite) parts.push(`cacheW:${formatTokens(usage.cacheWrite)}`);
+	if (usage.cost) parts.push(`$${usage.cost.toFixed(4)}`);
+	if (usage.contextTokens && usage.contextTokens > 0) parts.push(`ctx:${formatTokens(usage.contextTokens)}`);
+	if (model) parts.push(model);
+	return parts.join(" • ");
+}
+
+function truncate(text: string, maxLen: number): string {
+	return text.length > maxLen ? `${text.slice(0, maxLen)}...` : text;
+}
+
+function splitOutputLines(text: string): string[] {
+	const lines = text.replace(/\r\n?/g, "\n").split("\n");
+	if (lines.length > 1 && lines[lines.length - 1] === "") lines.pop();
+	return lines;
+}
+
+function lastNonEmptyLines(text: string, limit: number): string[] {
+	return splitOutputLines(text)
+		.map((line) => line.trimEnd())
+		.filter((line) => line.trim().length > 0)
+		.slice(-limit);
+}
+
+function statusEmoji(status: NodeStatus, theme: { fg: ThemeFg }): string {
+	switch (status) {
+		case "running":
+			return theme.fg("warning", "⏳");
+		case "error":
+			return theme.fg("error", "❌");
+		default:
+			return theme.fg("success", "✅");
+	}
+}
+
+function statusFromResult(result: SingleResult): NodeStatus {
+	if (result.exitCode === -1) return "running";
+	return isResultError(result) ? "error" : "success";
+}
+
+function countNodes(nodes: TreeNode[]): TreeCounts {
+	const counts: TreeCounts = {
+		total: 0,
+		running: 0,
+		success: 0,
+		error: 0,
+		finished: 0,
+	};
+
+	const visit = (node: TreeNode) => {
+		counts.total++;
+		if (node.status === "running") counts.running++;
+		if (node.status === "success") counts.success++;
+		if (node.status === "error") counts.error++;
+		if (node.status !== "running") counts.finished++;
+		for (const child of node.children) visit(child);
+	};
+
+	for (const node of nodes) visit(node);
+	return counts;
+}
+
+function hasNestedChildren(nodes: TreeNode[]): boolean {
+	return nodes.some((node) => node.children.length > 0 || hasNestedChildren(node.children));
+}
+
+function extractPendingSubagentCalls(messages: SingleResult["messages"]): PendingSubagentCall[] {
+	const calls: PendingSubagentCall[] = [];
+	for (let messageIndex = 0; messageIndex < messages.length; messageIndex++) {
+		const message = messages[messageIndex] as any;
+		if (message.role !== "assistant" || !Array.isArray(message.content)) continue;
+		for (let partIndex = 0; partIndex < message.content.length; partIndex++) {
+			const part = message.content[partIndex] as any;
+			if (part?.type !== "toolCall" || part?.name !== "subagent") continue;
+			const args = part.arguments && typeof part.arguments === "object" ? part.arguments : {};
+			const tasks = Array.isArray((args as any).tasks)
+				? (args as any).tasks
+						.filter((task: any) => task && typeof task.agent === "string")
+						.map((task: any) => ({
+							agent: task.agent,
+							task: typeof task.task === "string" ? task.task : undefined,
+						}))
+				: [];
+			calls.push({
+				toolCallId:
+					typeof part.toolCallId === "string"
+						? part.toolCallId
+						: typeof part.id === "string"
+							? part.id
+							: `${messageIndex}:${partIndex}`,
+				tasks,
+			});
+		}
+	}
+	return calls;
+}
+
+function buildPendingNodes(call: PendingSubagentCall): TreeNode[] {
+	return call.tasks.map((task) => ({
+		label: task.agent,
+		status: "running",
+		task: task.task,
+		children: [],
+	}));
+}
+
+function buildNodesFromNestedResult(nested: NestedSubagentResult): TreeNode[] {
+	return nested.details.results.map((result) => buildResultNode(result));
+}
+
+function subagentCallSignature(call: PendingSubagentCall): string {
+	return JSON.stringify(call.tasks.map((task) => ({ agent: task.agent, task: task.task ?? "" })));
+}
+
+function nestedResultIsHealthy(nested: NestedSubagentResult | undefined): boolean {
+	if (!nested || nested.isError) return false;
+	return nested.details.results.every((result) => !isResultError(result));
+}
+
+function buildNestedChildren(result: SingleResult): TreeNode[] {
+	const parentIsRunning = result.exitCode === -1;
+	const completedByToolCallId = new Map<string, NestedSubagentResult>();
+	for (const nested of getNestedSubagentResults(result.messages)) {
+		completedByToolCallId.set(nested.toolCallId, nested);
+	}
+
+	const calls = extractPendingSubagentCalls(result.messages);
+	const laterResumeBySignature = new Map<string, number>();
+	calls.forEach((call, index) => {
+		const completed = completedByToolCallId.get(call.toolCallId);
+		// A resumed call has the same task signature as the interrupted call but a
+		// newer toolCallId. Prefer that newer running/successful tree over the old
+		// synthetic/aborted result so resumed nested subagents render in-place.
+		if (!completed || nestedResultIsHealthy(completed)) {
+			laterResumeBySignature.set(subagentCallSignature(call), index);
+		}
+	});
+
+	const nodes: TreeNode[] = [];
+	calls.forEach((call, index) => {
+		const completed = completedByToolCallId.get(call.toolCallId);
+		const newerEquivalent = laterResumeBySignature.get(subagentCallSignature(call));
+		if (
+			newerEquivalent !== undefined &&
+			newerEquivalent > index &&
+			(!completed || completed.isError || !nestedResultIsHealthy(completed))
+		) {
+			return;
+		}
+
+		if (completed && isSubagentDetails(completed.details)) {
+			nodes.push(...buildNodesFromNestedResult(completed));
+			return;
+		}
+		// Unmatched subagent tool calls are useful while the parent is still
+		// running (they show live pending children). Once the parent finished,
+		// unmatched calls are stale history from an interrupted/resumed session and
+		// must not keep the whole tree in a perpetual "running" state.
+		if (parentIsRunning) nodes.push(...buildPendingNodes(call));
+	});
+	return nodes;
+}
+
+function formatToolArgPreview(toolName: string, args: Record<string, unknown>): string {
+	const shorten = (p: string) => {
+		const home = os.homedir();
+		return p.startsWith(home) ? `~${p.slice(home.length)}` : p;
+	};
+	const truncateTo = (s: string, n: number) =>
+		s.length > n ? s.slice(0, n) + "\u2026" : s;
+
+	switch (toolName) {
+		case "bash": {
+			const cmd = (args.command as string) || "";
+			return truncateTo(cmd.replace(/\s+/g, " "), 52);
+		}
+		case "read":
+		case "write":
+		case "edit":
+			return shorten(truncateTo((args.path ?? args.file_path ?? "") as string, 52));
+		case "grep":
+			return truncateTo(`/${args.pattern}/`, 30) +
+				   (args.path ? ` in ${shorten(args.path as string)}` : "");
+		case "find":
+			return truncateTo((args.pattern ?? "*") as string, 30) +
+				   (args.path ? ` in ${shorten(args.path as string)}` : "");
+		case "subagent": {
+			const tasks = (args.tasks as any[]) ?? [];
+			return tasks.map((t: any) => t.agent).join(", ");
+		}
+		default:
+			return "";
+	}
+}
+
+function formatLiveLogEntry(
+	entry: LiveLogEntry,
+	theme: { fg: ThemeFg },
+): string {
+	switch (entry.kind) {
+		case "turn_start":
+			return theme.fg("muted", "\u27f3") + " " + theme.fg("dim", "thinking\u2026");
+
+		case "turn_end": {
+			const tokens = entry.inputTokens || entry.outputTokens
+				? " " + theme.fg("dim",
+					`\u2191${formatTokens(entry.inputTokens)} \u2193${formatTokens(entry.outputTokens)}`)
+				: "";
+			return (
+				theme.fg("success", "\u2713") +
+				" " +
+				theme.fg("muted", `turn ${entry.turn}`) +
+				tokens
+			);
+		}
+
+		case "tool_start": {
+			const argPreview = formatToolArgPreview(entry.toolName, entry.args);
+			return (
+				theme.fg("muted", "\u2192") +
+				" " +
+				theme.fg("accent", entry.toolName) +
+				(argPreview ? "  " + theme.fg("dim", argPreview) : "")
+			);
+		}
+
+		case "tool_end":
+			return (
+				theme.fg("success", "\u2713") +
+				" " +
+				theme.fg("accent", entry.toolName)
+			);
+	}
+}
+
+function buildLeafPreview(result: SingleResult): string[] | undefined {
+	const items = getDisplayItems(result.messages);
+	const lines: string[] = [];
+	for (const item of items) {
+		if (item.type === "text") {
+			lines.push(...lastNonEmptyLines(item.text, OUTPUT_PREVIEW_LINE_COUNT));
+		}
+	}
+	const finalOutput = getFinalOutput(result.messages);
+	if (finalOutput) lines.push(...lastNonEmptyLines(finalOutput, OUTPUT_PREVIEW_LINE_COUNT));
+	const unique = lines.filter((line, index) => line && lines.indexOf(line) === index);
+	return unique.length > 0 ? unique.slice(-OUTPUT_PREVIEW_LINE_COUNT) : undefined;
+}
+
+function buildResultNode(result: SingleResult): TreeNode {
+	const status = statusFromResult(result);
+	const usage = formatUsage(result.usage, result.model);
+	const metaParts: string[] = [result.agentSource];
+	if (usage) metaParts.push(usage);
+	if (status === "error") {
+		const errorText = result.errorMessage || result.stderr || result.stopReason;
+		if (errorText) metaParts.push(truncate(errorText.replace(/\s+/g, " "), 120));
+	}
+
+	const children = buildNestedChildren(result);
+	const isRunning = status === "running";
+	return {
+		label: result.agent,
+		status,
+		meta: metaParts.join(" • "),
+		task: result.task,
+		liveActivity: isRunning && result.liveLog?.length > 0 ? result.liveLog : undefined,
+		outputPreview: !isRunning && children.length === 0 ? buildLeafPreview(result) : undefined,
+		children,
+	};
+}
+
+function buildTopLevelNodes(details: SubagentDetails): TreeNode[] {
+	return details.results.map((result) => buildResultNode(result));
+}
+
+function renderTreeLines(
+	nodes: TreeNode[],
+	theme: { fg: ThemeFg },
+	showOutputPreview: boolean,
+	depth = 0,
+	prefix = "",
+): string[] {
+	const lines: string[] = [];
+
+	nodes.forEach((node, index) => {
+		const indent = "  ".repeat(depth);
+		const number = prefix ? `${prefix}.${index + 1}` : `${index + 1}`;
+		const numberPrefix = broadcastNumberingActive ? `${number}. ` : "";
+		let line = `${indent}${numberPrefix}${statusEmoji(node.status, theme)} ${theme.fg("accent", node.label)}`;
+		if (node.meta) line += ` ${theme.fg("dim", node.meta)}`;
+		lines.push(line);
+
+		if (showOutputPreview && node.outputPreview && node.outputPreview.length > 0) {
+			for (const outputLine of node.outputPreview) {
+				lines.push(`${indent}  ${theme.fg("toolOutput", outputLine)}`);
+			}
+		}
+
+		if (showOutputPreview && node.liveActivity && node.liveActivity.length > 0) {
+			for (const entry of node.liveActivity) {
+				lines.push(`${indent}  ${formatLiveLogEntry(entry, theme)}`);
+			}
+		}
+
+		if (node.children.length > 0) {
+			lines.push(...renderTreeLines(node.children, theme, false, depth + 1, number));
+		}
+	});
+
+	return lines;
+}
+
+function topLevelSummary(details: SubagentDetails, counts: TreeCounts): string {
+	// aggregatedUsage includes own agents + all their nested descendants;
+	// fall back to summing only direct results for old serialised data lacking the field.
+	const totalUsage = formatUsage(
+		details.aggregatedUsage ?? aggregateUsage(details.results),
+	);
+	const parts = [
+		`${counts.running} running`,
+		`${counts.finished}/${counts.total} finished`,
+		`${counts.success} ok`,
+		`${counts.error} error`,
+	];
+	if (totalUsage) parts.push(totalUsage);
+	return parts.join(" • ");
+}
+
+// ---------------------------------------------------------------------------
+// renderCall — shown while the tool is being invoked
+// ---------------------------------------------------------------------------
+
+export function renderCall(
+	args: Record<string, any>,
+	theme: { fg: ThemeFg; bold: (s: string) => string },
+	context?: { isPartial?: boolean; isError?: boolean },
+): Text {
+	const tasks = Array.isArray(args.tasks) ? args.tasks : [];
+	const count = tasks.length;
+	const icon = context?.isPartial === false
+		? context.isError
+			? theme.fg("error", "❌")
+			: theme.fg("success", "✅")
+		: theme.fg("warning", "⏳");
+	let text = `${theme.fg("toolTitle", theme.bold("subagent "))}${theme.fg("accent", `${count} task${count === 1 ? "" : "s"}`)}`;
+	for (const task of tasks.slice(0, 6)) {
+		const agent = typeof task?.agent === "string" ? task.agent : "...";
+		const preview = typeof task?.task === "string" ? ` ${truncate(task.task, 56)}` : "";
+		text += `\n  ${icon} ${theme.fg("accent", agent)}${theme.fg("dim", preview)}`;
+	}
+	if (tasks.length > 6) text += `\n  ${theme.fg("muted", `... +${tasks.length - 6} more`)}`;
+	return new Text(text, 0, 0);
+}
+
+// ---------------------------------------------------------------------------
+// renderResult — shown after the tool completes / streams updates
+// ---------------------------------------------------------------------------
+
+export function renderResult(
+	result: { content: Array<{ type: string; text?: string }>; details?: unknown },
+	_expanded: boolean,
+	theme: { fg: ThemeFg; bold: (s: string) => string },
+): Container | Text {
+	const details = result.details as SubagentDetails | undefined;
+	if (!details || details.results.length === 0) {
+		const first = result.content[0];
+		return new Text(first?.type === "text" && first.text ? first.text : "(no output)", 0, 0);
+	}
+
+	const nodes = buildTopLevelNodes(details);
+	const counts = countNodes(nodes);
+	const showOutputPreview = !hasNestedChildren(nodes);
+	const icon = counts.running > 0
+		? theme.fg("warning", "⏳")
+		: counts.error > 0
+			? theme.fg("error", "❌")
+			: theme.fg("success", "✅");
+
+	const container = new Container();
+	container.addChild(
+		new Text(
+			`${icon} ${theme.fg("toolTitle", theme.bold("subagent tree "))}${theme.fg("dim", topLevelSummary(details, counts))}`,
+			0,
+			0,
+		),
+	);
+
+	container.addChild(new Spacer(1));
+	container.addChild(new Text(renderTreeLines(nodes, theme, showOutputPreview).join("\n"), 0, 0));
+
+	return container;
+}