@herbertgao/pi-extensions 2026.8.1 → 2026.8.2

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/mouse-layout.ts

@@ -0,0 +1,160 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { isCompactAssistantComponent } from "./compact-mode.ts";
+import { ToolGroupComponent } from "./tool-grouping.ts";
+import {
+	isToolExecutionComponent,
+	stripTerminalSequencesPreservingLayout,
+} from "./mouse-packets.ts";
+import { scrollButtonWidget } from "./mouse-scroll.ts";
+
+export type ComponentRowHit = {
+	component: any;
+	row: number;
+	/** 内部工具命中时所属的展开 group；普通卡点击仍折叠整个 group。 */
+	group?: ToolGroupComponent;
+};
+
+/** 深度渲染组件树（容器 render 隐藏时回退 children）。 */
+export function renderComponentTree(component: any, width: number): string[] {
+	if (!component || typeof component !== "object") return [];
+	try {
+		const lines = component.render?.(width);
+		if (Array.isArray(lines) && lines.length > 0) return lines;
+	} catch {
+		// Fall through to children for hidden container renderers.
+	}
+	if (!Array.isArray(component.children)) return [];
+	return component.children.flatMap((child: any) => renderComponentTree(child, width));
+}
+
+/** 行内 [click to show more] 提示的命中列区间（1-based，含两端）。 */
+export function collapsedHintHitbox(line: string): { startCol: number; endCol: number } | null {
+	const plain = stripTerminalSequencesPreservingLayout(line);
+	const match = /(\([^()\n]* \/ click\)|click to show more|to show more)(?=\)?\s*$)/.exec(plain);
+	if (!match?.[1]) return null;
+	const startCol = visibleWidth(plain.slice(0, match.index)) + 1;
+	return { startCol, endCol: startCol + visibleWidth(match[1]) - 1 };
+}
+
+/** 布局树点查询：返回 (x,y) 处最深含行 leaf box（屏幕行 → 组件局部行）。 */
+export function fullscreenLeafAt(
+	layout: any,
+	x: number,
+	y: number,
+): { box: any; localRow: number } | null {
+	const root = layout?.root;
+	if (!root) return null;
+	let best: { box: any; localRow: number } | null = null;
+	let bestDepth = -1;
+	const visit = (box: any, depth: number) => {
+		if (!box) return;
+		const clip = box.clip;
+		if (!clip || x < clip.x || x >= clip.x + clip.width || y < clip.y || y >= clip.y + clip.height)
+			return;
+		const isLeaf = !Array.isArray(box.children) || box.children.length === 0;
+		if (
+			isLeaf &&
+			y >= box.rect.y &&
+			y < box.rect.y + Math.max(1, box.rect.height) &&
+			depth > bestDepth
+		) {
+			best = { box, localRow: Math.max(0, y - box.rect.y) };
+			bestDepth = depth;
+		}
+		for (const child of box.children ?? []) visit(child, depth + 1);
+	};
+	visit(root, 0);
+	return best;
+}
+
+/** leaf 自身不带 scrollView；内容宽度由最近的 scroll 祖先决定。 */
+export function fullscreenContentWidth(box: any, terminalWidth: number): number {
+	for (let current = box; current; current = current.parent) {
+		if (typeof current.scrollView?.getContentWidth === "function") {
+			return Math.max(1, current.scrollView.getContentWidth(terminalWidth));
+		}
+	}
+	return terminalWidth;
+}
+
+/** 点击列是否为官方滚动条列（放行官方拖动）。 */
+export function isScrollbarColumnAt(layout: any, x: number): boolean {
+	let hit = false;
+	const visit = (box: any) => {
+		if (hit || !box) return;
+		if (box.scrollView?.isScrollbarVisible && x === box.rect.x + box.rect.width - 1) {
+			hit = true;
+			return;
+		}
+		for (const child of box.children ?? []) visit(child);
+	};
+	visit(layout?.root);
+	return hit;
+}
+
+/**
+ * 布局 leaf box 的组件通常是容器（documentContainer/dock 容器等），工具卡与
+ * widget 在其 children 内。按局部行遍历组件树，定位实际命中的子组件。
+ */
+export function componentAtLocalRow(
+	component: any,
+	localRow: number,
+	width: number,
+): ComponentRowHit | null {
+	if (component instanceof ToolGroupComponent) {
+		// 展开的 group：头两行（空行 + 头行）归 group，其余行映射到内部工具。
+		const child = component.childAtRow(localRow, width);
+		return child ? { ...child, group: component } : { component, row: localRow };
+	}
+	if (isToolExecutionComponent(component)) {
+		return { component, row: localRow };
+	}
+	if (isCompactAssistantComponent(component)) {
+		// compact 摘要行整体作为可展开卡片（折叠摘要 / 展开内容）。
+		return { component, row: localRow };
+	}
+	if (component === scrollButtonWidget) {
+		return { component, row: localRow };
+	}
+	if (!Array.isArray(component.children)) return null;
+	let offset = 0;
+	for (const child of component.children) {
+		let lines: string[] = [];
+		try {
+			const rendered = child.render?.(width);
+			if (Array.isArray(rendered)) lines = rendered.map((line) => String(line));
+		} catch {
+			lines = [];
+		}
+		if (localRow < offset + lines.length) {
+			return (
+				componentAtLocalRow(child, localRow - offset, width) ?? {
+					component: child,
+					row: localRow - offset,
+				}
+			);
+		}
+		offset += lines.length;
+	}
+	return null;
+}
+
+/** fullscreen single-expand：group 作为整体，不继续递归其内部工具。 */
+export function collectFullscreenToolCards(
+	component: any,
+	out: any[],
+	seen = new Set<any>(),
+): void {
+	if (!component || typeof component !== "object" || seen.has(component)) return;
+	seen.add(component);
+	if (
+		isToolExecutionComponent(component) ||
+		component instanceof ToolGroupComponent ||
+		isCompactAssistantComponent(component)
+	) {
+		out.push(component);
+		return;
+	}
+	if (!Array.isArray(component.children)) return;
+	for (const child of component.children) collectFullscreenToolCards(child, out, seen);
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/mouse-packets.ts

@@ -0,0 +1,143 @@
+import type { ExpandedToolIoView, ToolIoSection } from "./tool-result.ts";
+
+/** SGR 鼠标协议包（code;col;row + M/m 终结符）。 */
+export type SgrMousePacket = {
+	code: number;
+	col: number;
+	row: number;
+	final: "M" | "m";
+};
+
+/** Final painted placement of one outermost tool/group row after parent layout. */
+export type FrameToolPlacement = {
+	component: any;
+	componentRow: number;
+	lineIndex: number;
+	/** Marker-stripped final line text as painted after parent layout. */
+	finalLine: string;
+	view?: ExpandedToolIoView;
+	section?: ToolIoSection;
+};
+
+/** Zero-width APC row marker (like pi CURSOR_MARKER); stripped before terminal output. */
+const TOOL_FRAME_MARKER_RE = /\x1b_cc:t(\d+):(\d+)\x07/g;
+const TOOL_VIEW_MARKER_RE = /\x1b_cc:v(\d+):([io])\x07/g;
+export const toolFrameMarker = (id: number, row: number) => `\x1b_cc:t${id}:${row}\x07`;
+
+/**
+ * 解析整段终端输入为 SGR 鼠标包序列；数据必须完全由连续 SGR 包组成
+ * （夹杂其他字节返回 null，交由常规输入链处理）。
+ */
+export function parseSgrMousePackets(data: string): SgrMousePacket[] | null {
+	const pattern = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
+	const packets: SgrMousePacket[] = [];
+	let offset = 0;
+
+	for (const match of data.matchAll(pattern)) {
+		if (match.index !== offset) return null;
+		offset = match.index + match[0].length;
+		packets.push({
+			code: Number(match[1]),
+			col: Number(match[2]),
+			row: Number(match[3]),
+			final: match[4] as "M" | "m",
+		});
+	}
+
+	return packets.length > 0 && offset === data.length ? packets : null;
+}
+
+/** 是否为左键按下（排除修饰键、32 表示 motion 事件）。 */
+export function isSgrLeftPress(packet: SgrMousePacket): boolean {
+	const baseButton = packet.code & ~(4 | 8 | 16 | 32);
+	return packet.final === "M" && baseButton === 0 && (packet.code & 32) === 0;
+}
+
+/** 仅剥离终端序列、保留原布局（换行/空白不动），用于命中区间计算。 */
+export function stripTerminalSequencesPreservingLayout(value: string): string {
+	return value
+		.replace(/\x1b\][^\x07]*(?:\x07|\x1b\\)/g, "")
+		.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "");
+}
+
+/** 剥离终端序列并折叠空白（用于纯文本比较）。 */
+export function stripTerminalSequences(value: string): string {
+	return stripTerminalSequencesPreservingLayout(value).replace(/\s+/g, " ").trim();
+}
+
+/** 工具执行组件识别（toolCallId + setExpanded + render）。 */
+export function isToolExecutionComponent(value: any): boolean {
+	return Boolean(
+		value &&
+			typeof value === "object" &&
+			typeof value.toolCallId === "string" &&
+			typeof value.setExpanded === "function" &&
+			typeof value.render === "function",
+	);
+}
+
+/** 深度收集组件树中的工具执行组件（含 getMountedRoots 分支）。 */
+export function collectToolComponents(component: any, tools: any[], seen = new Set<any>()): void {
+	if (!component || typeof component !== "object" || seen.has(component)) return;
+	seen.add(component);
+	if (isToolExecutionComponent(component)) {
+		tools.push(component);
+		return;
+	}
+	if (Array.isArray(component.children)) {
+		for (const child of component.children) collectToolComponents(child, tools, seen);
+	}
+	try {
+		const mounted = component.getMountedRoots?.();
+		if (Array.isArray(mounted)) {
+			for (const root of mounted) collectToolComponents(root, tools, seen);
+		}
+	} catch {
+		// renderer 切换中的惰性 Proxy 可能暂时没有 mounted roots。
+	}
+}
+
+/** 剥离一行中的零宽帧/视图 marker。 */
+export function stripToolFrameMarkers(line: string): string {
+	return line.replace(TOOL_FRAME_MARKER_RE, "").replace(TOOL_VIEW_MARKER_RE, "");
+}
+
+/**
+ * 从渲染行中提取工具帧 placement（component/componentRow/lineIndex/finalLine
+ * 及其所属视图与 section），同时返回剥离 marker 后的行。
+ */
+export function extractToolFramePlacements(
+	lines: string[],
+	idToComponent: Map<number, any>,
+	idToView: Map<number, ExpandedToolIoView>,
+): { lines: string[]; placements: FrameToolPlacement[] } {
+	const placements: FrameToolPlacement[] = [];
+	const cleaned = lines.map((line, lineIndex) => {
+		const toolMatches = [...line.matchAll(TOOL_FRAME_MARKER_RE)];
+		const viewMatches = [...line.matchAll(TOOL_VIEW_MARKER_RE)];
+		const finalLine = stripToolFrameMarkers(line);
+		let view: ExpandedToolIoView | undefined;
+		let section: ToolIoSection | undefined;
+		for (const match of viewMatches) {
+			const candidate = idToView.get(Number(match[1]));
+			if (!candidate) continue;
+			view = candidate;
+			section = match[2] === "i" ? "input" : "output";
+			break;
+		}
+		for (const match of toolMatches) {
+			const component = idToComponent.get(Number(match[1]));
+			if (!component) continue;
+			placements.push({
+				component,
+				componentRow: Number(match[2]),
+				lineIndex,
+				finalLine,
+				view,
+				section,
+			});
+		}
+		return finalLine;
+	});
+	return { lines: cleaned, placements };
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/mouse-scroll.ts

@@ -0,0 +1,184 @@
+import {
+	getKeybindings,
+	matchesKey,
+	truncateToWidth,
+	visibleWidth,
+	type Keybinding,
+} from "@earendil-works/pi-tui";
+import { config } from "../config/config.ts";
+import { isLazyProxyTui } from "../utils/fullscreen-detect.ts";
+import { parseSgrMousePackets } from "./mouse-packets.ts";
+
+const ZENTUI_PAGE_UP_INPUT = /^\x1b\[5;9(?::[12])?~$|^\x1b\[57421;9(?::[12])?u$|^\x1b\[1;6A$/;
+const ZENTUI_PAGE_DOWN_INPUT = /^\x1b\[6;9(?::[12])?~$|^\x1b\[57422;9(?::[12])?u$|^\x1b\[1;6B$/;
+const SCROLL_BOTTOM_SHORTCUT = "ctrl+end";
+
+/**
+ * 当前安装的 tui 宿主。宿主放本模块（滚动按钮/调度依赖它），
+ * 由 mouse-interaction 经 setToolMouseTui 维护；跨模块一律经绑定/setter 访问。
+ */
+export let toolMouseTui: any = null;
+export function setToolMouseTui(tui: any): void {
+	toolMouseTui = tui;
+}
+
+export let scrollButtonVisible = false;
+export let scrollButtonHovered = false;
+export let scrollButtonWidget: any = null;
+let scrollButtonSyncScheduled = false;
+
+export function setScrollButtonVisible(visible: boolean): void {
+	scrollButtonVisible = visible;
+}
+
+/** 返回是否发生变化（调用方据此决定是否需要重渲染）。 */
+export function setScrollButtonHovered(hovered: boolean): boolean {
+	if (hovered === scrollButtonHovered) return false;
+	scrollButtonHovered = hovered;
+	return true;
+}
+
+export function setScrollButtonWidget(widget: any): void {
+	scrollButtonWidget = widget;
+}
+
+/** teardown 全量清零（visible/hovered/widget/sync 调度）。 */
+export function resetScrollButtonState(): void {
+	scrollButtonVisible = false;
+	scrollButtonHovered = false;
+	scrollButtonWidget = null;
+	scrollButtonSyncScheduled = false;
+}
+
+export function toolMouseInteractionActive(): boolean {
+	if (config.mode === "off") return false;
+	if (isLazyProxyTui(toolMouseTui)) return true;
+	return true;
+}
+
+/** 惰性 Proxy 官方 fullscreen（TuiAltScreen）判定。 */
+export function fullscreenLazyTui(tui: any): boolean {
+	return isLazyProxyTui(tui) && tui.mode === "fullscreen";
+}
+
+/** 官方 fullscreen：是否已跟随 transcript 底部（按钮隐藏条件）。 */
+export function isFullscreenAtBottom(tui: any): boolean {
+	const following = tui.isFollowingOutput ?? tui.getPrimaryScrollView?.()?.isFollowingEnd ?? true;
+	return Boolean(following);
+}
+
+function formatShortcut(shortcut: string): string {
+	return shortcut
+		.split("+")
+		.map((part) =>
+			part.length <= 1 ? part.toUpperCase() : `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`,
+		)
+		.join("+");
+}
+
+export function isScrollBottomInput(data: string): boolean {
+	return matchesKey(data, SCROLL_BOTTOM_SHORTCUT);
+}
+
+function wheelDirection(data: string): "up" | "down" | null {
+	const packets = parseSgrMousePackets(data);
+	for (const packet of packets ?? []) {
+		if (packet.final !== "M") continue;
+		const baseButton = packet.code & ~(4 | 8 | 16 | 32);
+		if (baseButton === 64) return "up";
+		if (baseButton === 65) return "down";
+	}
+	return null;
+}
+
+function isScrollNavigationInput(data: string): boolean {
+	if (
+		matchesKey(data, "pageUp") ||
+		matchesKey(data, "pageDown") ||
+		ZENTUI_PAGE_UP_INPUT.test(data) ||
+		ZENTUI_PAGE_DOWN_INPUT.test(data) ||
+		// 官方 fullscreen viewport 的可滚动键（half-page/prompt/top/bottom）。
+		[
+			"tui.altScreen.pageUp",
+			"tui.altScreen.pageDown",
+			"tui.altScreen.halfPageUp",
+			"tui.altScreen.halfPageDown",
+			"tui.altScreen.previousPrompt",
+			"tui.altScreen.nextPrompt",
+			"tui.altScreen.top",
+			"tui.altScreen.bottom",
+		].some((key) => getKeybindings().matches(data, key as Keybinding))
+	) {
+		return true;
+	}
+	const packets = parseSgrMousePackets(data);
+	return Boolean(
+		packets?.some((packet) => {
+			const baseButton = packet.code & ~(4 | 8 | 16 | 32);
+			return packet.final === "M" && (baseButton === 64 || baseButton === 65);
+		}),
+	);
+}
+
+function isAtTranscriptBottom(tui: any): boolean {
+	// 惰性 Proxy fullscreen：官方 viewport 以 isFollowingOutput 判定是否在底部。
+	if (fullscreenLazyTui(tui)) return isFullscreenAtBottom(tui);
+	return true;
+}
+
+export function hideScrollButton(tui: any): void {
+	const changed = scrollButtonVisible || scrollButtonHovered;
+	scrollButtonVisible = false;
+	scrollButtonHovered = false;
+	if (changed) tui.requestRender?.();
+}
+
+export function scheduleScrollButtonSync(tui: any, data: string): void {
+	if (
+		!fullscreenLazyTui(tui) ||
+		!toolMouseInteractionActive() ||
+		!isScrollNavigationInput(data) ||
+		scrollButtonSyncScheduled
+	)
+		return;
+	scrollButtonSyncScheduled = true;
+	const previousLines = tui.previousLines;
+	const check = (attempt: number) => {
+		scrollButtonSyncScheduled = false;
+		if (toolMouseTui !== tui) return;
+		// Pi renders on its own frame timer. Inspect the resulting viewport before
+		// showing the button so empty or non-scrollable transcripts never flash it.
+		const rendered = tui.previousLines !== previousLines;
+		// fullscreen 下 isFollowingOutput 是即时状态，无需等待官方帧渲染。
+		if (!rendered && attempt < 4 && !fullscreenLazyTui(tui)) {
+			scrollButtonSyncScheduled = true;
+			const timer = setTimeout(() => check(attempt + 1), 16);
+			if (typeof timer === "object" && timer !== null && "unref" in timer) {
+				(timer as { unref: () => void }).unref();
+			}
+			return;
+		}
+		const nextVisible = !isAtTranscriptBottom(tui);
+		if (nextVisible !== scrollButtonVisible) {
+			scrollButtonVisible = nextVisible;
+			tui.requestRender?.();
+		}
+	};
+	process.nextTick(() => check(0));
+}
+
+export function updateScrollButtonFromInput(tui: any, data: string): void {
+	if (!fullscreenLazyTui(tui) || !toolMouseInteractionActive()) return;
+	if (matchesKey(data, "enter") || matchesKey(data, "return")) hideScrollButton(tui);
+}
+
+export function renderScrollButton(width: number, theme: any): string[] {
+	if (!scrollButtonVisible || !fullscreenLazyTui(toolMouseTui)) return [];
+	const shortcut = formatShortcut(SCROLL_BOTTOM_SHORTCUT);
+	const label = theme.fg(
+		scrollButtonHovered ? "text" : "accent",
+		`[ ↓ Back to bottom · ${shortcut} ]`,
+	);
+	const leftPad = Math.max(0, Math.floor((width - visibleWidth(label)) / 2));
+	return [`${" ".repeat(leftPad)}${truncateToWidth(label, width, "…")}`];
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/tool-diff/diff-renderer.ts

@@ -2653,7 +2653,7 @@ export function renderEditDiffResult(
 			return cache.set(safeWidth, options.expanded, mode, configKey, hovered, clampedLines);
 		},
 		invalidate: cache.invalidate,
-	};
+	} as Component;
 }
 
 function renderWriteHeader(
@@ -3079,5 +3079,5 @@ export function renderWriteDiffResult(
 			return cache.set(safeWidth, options.expanded, mode, configKey, hovered, finalLines);
 		},
 		invalidate: cache.invalidate,
-	};
+	} as Component;
 }

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/tool-grouping.ts

@@ -1,5 +1,11 @@
 import { AssistantMessageComponent, ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
-import { Container, Spacer, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import {
+	Container,
+	Spacer,
+	truncateToWidth,
+	visibleWidth,
+	type Component,
+} from "@earendil-works/pi-tui";
 import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../utils/tool-loading-icon.ts";
 import { sanitizeToolResultText } from "../utils/tool-result-sanitize.ts";
 import { showMoreHintText } from "./show-more-hint.ts";
@@ -285,7 +291,8 @@ export class ToolGroupComponent extends Container {
 
 	setExpanded(expanded: boolean): void {
 		this._expanded = expanded;
-		for (const tool of this.children) tool.setExpanded?.(expanded);
+		for (const tool of this.children)
+			(tool as Component & { setExpanded?: (expanded: boolean) => void }).setExpanded?.(expanded);
 	}
 
 	setHintHovered(hovered: boolean): void {

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/transcript-refresh.ts

@@ -0,0 +1,91 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import { AssistantMessageComponent, ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
+
+// pi-coding-agent 类型声明中 AssistantMessageComponent 仅能以 value 形式使用，
+// updateContent/lastMessage 用结构化类型访问。
+type TranscriptComponentInternals = {
+	lastMessage?: AssistantMessage;
+	updateContent(message: AssistantMessage): void;
+	invalidate?(): void;
+};
+
+/**
+ * 重绘单个已构造的组件：assistant 用最新消息重渲染（compact thinking），
+ * tool 强制 updateDisplay（其内容可能仍在旧 shell 容器中）。
+ * 不吞异常——由调用方决定如何处理失败。
+ */
+export function refreshTranscriptComponent(value: unknown): boolean {
+	if (!value || typeof value !== "object") return false;
+	if (value instanceof AssistantMessageComponent) {
+		const self = value as unknown as TranscriptComponentInternals;
+		if (self.lastMessage) self.updateContent(self.lastMessage);
+		else self.invalidate?.();
+		return true;
+	}
+	if (value instanceof ToolExecutionComponent) {
+		// updateDisplay 是私有方法，但它是 resume 后让内容回到正确
+		// shell 容器的唯一入口（原型链已含全局工具渲染补丁）。
+		(value as unknown as { updateDisplay(): void }).updateDisplay();
+		return true;
+	}
+	return false;
+}
+
+/**
+ * 扫描挂载树，重绘所有已构造的 assistant/tool 组件。
+ * 用于 reload/resume/compaction 后"pi 用原始原型重建、补丁事后才装"的场景。
+ * 遍历 value.children 与 value.getMountedRoots?.()（seen 集合防环），
+ * 单个组件失败用 try/catch 隔离，不影响其余组件。
+ */
+// compact-mode 把补丁暴露在此 Symbol 上（见 compact-mode.ts），避免循环依赖。
+const COMPACT_MODE_PATCH_KEY = Symbol.for("pi.ccstyle.compact-mode-patch");
+
+/**
+ * 补丁链序不变量：compact 模式下 compact-mode 必须位于 compact-thinking
+ * 外层（round 摘要才能聚合工具统计）。resume/reload 后若无新消息，
+ * message_update 触发的重新认领不会执行，这里在任何重绘前先断言一次。
+ * 断言幂等：链序已正确时无操作；mode=on 时也安全（外层走 pass-through）。
+ */
+function assertCompactModeOutermost(): void {
+	try {
+		const patch = (globalThis as any)[COMPACT_MODE_PATCH_KEY];
+		if (typeof patch?.assertAssistantOwnership === "function") {
+			patch.assertAssistantOwnership();
+		}
+	} catch {
+		// 无 compact-mode 补丁或断言失败时跳过，扫描仍会执行。
+	}
+}
+
+export function refreshMountedTranscript(tui?: unknown): void {
+	if (!tui || typeof (tui as any).getMountedRoots !== "function") return;
+	// 先修正链序再重绘：扫描触发 updateContent 时 compact-mode 已在外层。
+	assertCompactModeOutermost();
+	const seen = new Set<object>();
+	const visit = (value: any): void => {
+		if (!value || typeof value !== "object" || seen.has(value)) return;
+		seen.add(value);
+		if (Array.isArray(value)) {
+			for (const child of value) visit(child);
+			return;
+		}
+		try {
+			refreshTranscriptComponent(value);
+		} catch {
+			// 单个组件失败不阻断其余组件；后续 session_tree/重绘再试。
+		}
+		const children = value.children;
+		if (Array.isArray(children)) {
+			for (const child of children) visit(child);
+		}
+		try {
+			const mounted = value.getMountedRoots?.();
+			if (Array.isArray(mounted)) {
+				for (const root of mounted) visit(root);
+			}
+		} catch {
+			// 惰性 Proxy / 未挂载容器没有 mounted roots。
+		}
+	};
+	visit(tui);
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/agent-summary.ts

@@ -107,8 +107,8 @@ function summaryParts(data: AgentSummaryData): string[] {
 	const parts: string[] = [];
 	if (data.reads) parts.push(`read ${data.reads} file${plural(data.reads)}`);
 	if (data.edits) parts.push(`edited ${data.edits} file${plural(data.edits)}`);
-	if (data.commands) parts.push(`ran ${data.commands} command${plural(data.commands)}`);
 	if (data.others) parts.push(`${data.others} other tool${plural(data.others)}`);
+	if (data.commands) parts.push(`ran ${data.commands} command${plural(data.commands)}`);
 	if (data.failed) parts.push(`${data.failed} failed`);
 	return parts;
 }

package/node_modules/@herbertgao/pi-cc-extensions/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@herbertgao/pi-cc-extensions",
-	"version": "0.8.51",
+	"version": "0.8.52",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
 	"type": "module",
@@ -69,8 +69,8 @@
 	},
 	"x-upstream": {
 		"package": "pi-cc-extensions",
-		"version": "0.8.51",
+		"version": "0.8.53",
 		"repository": "https://github.com/minuque/pi-cc-extensions",
-		"commit": "b94bb6b2be2c32fc0857e6c7f8048faad3580835"
+		"commit": "a7aaf6d4136af44a1ef7ac4993d5754fe084c921"
 	}
 }

package/node_modules/@herbertgao/pi-cc-extensions/themes/cc-dark.json

@@ -41,6 +41,7 @@
 		"text": "text",
 		"thinkingText": "muted",
 		"selectedBg": "selectedBg",
+		"scrollbarThumb": "selectedBg",
 		"userMessageBg": "userMessageBg",
 		"userMessageText": "text",
 		"customMessageBg": "customMessageBg",

package/node_modules/@herbertgao/pi-cc-extensions/themes/cc-light.json

@@ -53,9 +53,9 @@
 		"toolTitle": "accentBright",
 		"toolOutput": "muted",
 		"mdHeading": "accentBright",
-		"mdLink": "blue",
+		"mdLink": "cyan",
 		"mdLinkUrl": "muted",
-		"mdCode": "purple",
+		"mdCode": "accentBright",
 		"mdCodeBlock": "text",
 		"mdCodeBlockBorder": "border",
 		"mdQuote": "muted",