@yinan_chen/pi-claude-code-ui 0.0.0-stage → 0.2.1

package/src/claude-view.ts

@@ -0,0 +1,775 @@
+/** Pi-specific transcript adapter. All private component fields are isolated here. */
+import { Box, Container, Markdown, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { getMarkdownTheme, keyText } from "@earendil-works/pi-coding-agent";
+import { BUILTIN_NAMES, PROCESS_TOOL_NAMES, bold, canExpandTool, expandHint, failedTool, fg, fit, headerOf, isBlank, isImageLine, oneLine, paintBackground, paintTool, prefixed, prefixZones, targetOf, type ToolAppearance, type ToolView } from "./claude-tools.ts";
+import { animateRunningSummary } from "./running-effect.ts";
+
+export interface ClaudeConfig extends ToolAppearance {
+	detailsBackground: string;
+	/** 直播 thinking 尾窗，未封口时仅保留尾部屏幕行。 */
+	liveThinking: boolean;
+	thinkingTailLines: number;
+	/** 封口自动折叠的收拢动画时长（ms）；0 = 直接折。 */
+	foldAnimMs: number;
+	/** Skill 调用块样式："native" = pi 原生 `[skill] name` 折叠行；"claude" = `● Skill(name)` + `⎿ Loaded skill`。默认 native（一南 2026-10-05）。 */
+	skillRendering: "native" | "claude";
+}
+interface Part {
+	key: string;
+	kind: "thought" | "text" | "tool" | "other";
+	owner: any;
+	node?: any;
+	run?: number;
+	streaming?: boolean;
+}
+interface Stage { key: string; parts: Part[]; sealed: boolean; }
+interface Clock { active?: number; started?: number; elapsed: Map<number, number>; lengths: number[]; }
+const SLOT = "__leanTidyClaude";
+const ORIGINAL_RENDER = Symbol.for("lean-tidy/claude-original-render");
+const partId = (o: any): string => o.__claudeId ??= `message-${(globalThis as any).__leanTidyPartId = ((globalThis as any).__leanTidyPartId ?? 0) + 1}`;
+const isTool = (c: any): boolean => !!c && typeof c.updateDisplay === "function" && typeof c.toolName === "string";
+const isAssistant = (c: any): boolean => !!c && typeof c.updateContent === "function" && typeof c.setHideThinkingBlock === "function";
+const isSpacer = (c: any): boolean => !!c && typeof c.setLines === "function" && "lines" in c;
+const isThoughtRegion = (c: any): boolean => !!c && "child" in c && typeof c.onMouse === "function";
+const isSkill = (c: any): boolean => !!c?.skillBlock;
+const isUserMessage = (c: any): boolean => typeof c?.rebuild === "function" && typeof c?.text === "string";
+const SGR_RE = /\x1b\[([0-9;]*)m/g;
+/**
+ * 原位消息泡是浅底深字，但 Pi 的 Markdown theme 与深色助手区共用：代码块、链接等
+ * 会自行写入 Markdown/syntax 前景色，并覆盖外层 userMessageText。逐个保留粗体/斜体等
+ * 装饰和背景，只把所有“改变/重置前景色”的 SGR 归一到 userMessageText。
+ */
+function userMessageForeground(line: string, activeTheme: any): string {
+	if (isImageLine(line)) return line;
+	let target = "";
+	try { target = activeTheme?.getFgAnsi?.("userMessageText") ?? ""; } catch {}
+	if (!target) return fg(activeTheme, "userMessageText", line);
+	const normalized = line.replace(SGR_RE, (sequence, body: string) => {
+		const params = body === "" ? [0] : body.split(";").map((value) => value === "" ? 0 : Number(value));
+		if (params.some((value) => !Number.isFinite(value))) return sequence;
+		const kept: number[] = [];
+		let touchesForeground = false;
+		for (let i = 0; i < params.length; i++) {
+			const code = params[i];
+			if (code === 0) {
+				kept.push(code);
+				touchesForeground = true;
+			} else if (code === 39 || (code >= 30 && code <= 37) || (code >= 90 && code <= 97)) {
+				touchesForeground = true;
+			} else if (code === 38) {
+				touchesForeground = true;
+				if (params[i + 1] === 5 && i + 2 < params.length) i += 2;
+				else if (params[i + 1] === 2 && i + 4 < params.length) i += 4;
+			} else kept.push(code);
+		}
+		if (!touchesForeground) return sequence;
+		return `${kept.length ? `\x1b[${kept.join(";")}m` : ""}${target}`;
+	});
+	return `${target}${normalized}\x1b[39m`;
+}
+const blankTrim = (lines: string[]): string[] => {
+	if (lines.some(isImageLine)) return lines; // Image height is protocol data, never whitespace.
+	let a = 0, b = lines.length;
+	while (a < b && isBlank(lines[a])) a++;
+	while (b > a && isBlank(lines[b - 1])) b--;
+	return lines.slice(a, b);
+};
+const duration = (ms: number): string => {
+	const s = Math.max(1, Math.round(ms / 1000));
+	return s < 60 ? `${s}s` : `${Math.floor(s / 60)}m ${s % 60}s`;
+};
+const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/** Foreign 工具（codemode/MCP 等）折叠态 body 的物理行预算（2026-09-30 一南：3→0→1→0；codemode 有 calls 时动态放宽、pending 控件豁免，见 foreignBody）。 */
+const FOREIGN_PREVIEW_ROWS = 0;
+const spinnerGlyph = (): string => SPINNER[Math.floor(Date.now() / 200) % SPINNER.length];
+function thoughtRuns(message: any): string[] {
+	const out: string[] = []; let last = false;
+	for (const c of message?.content ?? []) {
+		if (c.type === "thinking") {
+			const s = String(c.thinking ?? "");
+			if (last) out[out.length - 1] += s;
+			else { out.push(s); last = true; }
+		} else last = false;
+	}
+	return out.filter((s) => s.trim());
+}
+function lastThought(message: any): boolean {
+	const content = [...(message?.content ?? [])].reverse();
+	const last = content.find((c: any) => c.type === "thinking" ? String(c.thinking ?? "").trim() : c.type === "text" ? String(c.text ?? "").trim() : true);
+	return last?.type === "thinking";
+}
+
+export function createClaudeView(
+	config: ClaudeConfig,
+	getTheme: () => any,
+	report: (s: string) => void,
+	renderRichDiff?: (tool: any, expanded: boolean, theme: any, invalidate: () => void) => { render(width: number): string[] } | undefined,
+) {
+	let disabled = false, inFlight = false, mode: any;
+	let timer: ReturnType<typeof setInterval> | undefined;
+	let clock: Clock = { elapsed: new Map(), lengths: [] };
+	let currentMessage: any;
+	let clockByMessage = new WeakMap<object, Map<number, number>>();
+	const clockByStamp: Map<string, Map<number, number>> = ((globalThis as any).__leanTidyThinkingTimes ??= new Map());
+	const open = new Map<string, boolean>();
+	/** 未封口阶段的 sticky 撑开（一南 2026-09-30 报的横跳 bug）：一旦因直播 thinking 撑开，
+	 *  就记住直到封口转变——thinking 间歇（工具执行中）不再折回，连续工具轮次的摘要行
+	 *  不再反复展开/折叠。封口转变时清掉、随收拢动画折一次；ctrl+o/ctrl+T/新会话一并清。 */
+	const stageAutoOpen = new Set<string>();
+	const chatContainers = new Set<any>();
+	const renderedTools = new WeakMap<object, { key: unknown[]; lines: string[]; layout: any }>();
+	// Rich diff components cache their row layout and optional async highlighting. Keep one
+	// per tool/result/expansion so re-rendering the transcript does not restart that work.
+	const richDiffs = new WeakMap<object, { args: unknown; result: unknown; themeKey: unknown; expanded: boolean; component: { render(width: number): string[] } }>();
+	const renderedThoughts = new WeakMap<object, Map<number, { text: string; theme: string; node: any }>>();
+	const toolOverrides = new Map<string, boolean>();
+	/** 直播尾窗：点过「显示全部」的 thinking run（按 part key，本 run 内不再截尾；session_start 清空）。 */
+	const tailOff = new Set<string>();
+	/** 上一帧各 stage 封口与否（首帧 undefined 不起动画）与展开态可见行数（收拢动画的行数依据）。 */
+	const stagePrevSealed = new Map<string, boolean>();
+	const stageRows = new Map<string, number>();
+	/** 封口收拢动画：封口那刻捕获的成员行（冻结）+ 冻结文案 + 起点；进度按墙钟推进。 */
+	const stageAnim = new Map<string, { startedAt: number; lines: string[]; label: string }>();
+	const tokenKey = (): string => ["text", "muted", "dim", "success", "error", "thinkingText", "toolOutput", "toolDiffAdded", "toolDiffRemoved"].map((k) => fg(theme(), k, "x")).join("") + (theme()?.name ?? "");
+	const stamp = (m: any): string | undefined => typeof m?.timestamp === "number" ? `${m.timestamp}:${m.provider ?? ""}:${m.model ?? ""}` : undefined;
+	const theme = () => getTheme();
+	const redraw = () => mode?.ui?.requestRender?.();
+	const effectiveExpanded = (tool: any): boolean => toolOverrides.get(tool.toolCallId) ?? (tool.__claudeForcedDetail === true || !!tool.expanded);
+	function clockSnapshot(message: any): void {
+		if (!message || typeof message !== "object") return;
+		const values = new Map(clock.elapsed);
+		if (clock.active !== undefined && clock.started !== undefined) values.set(clock.active, Date.now() - clock.started);
+		clockByMessage.set(message, values);
+		const s = stamp(message);
+		if (s) {
+			clockByStamp.set(s, values);
+			if (clockByStamp.size > 2048) clockByStamp.delete(clockByStamp.keys().next().value!);
+		}
+	}
+	function finishThinking(): void {
+		if (clock.active !== undefined && clock.started !== undefined) clock.elapsed.set(clock.active, Date.now() - clock.started);
+		clock.active = undefined; clock.started = undefined;
+		clockSnapshot(currentMessage);
+	}
+	function observe(event: any): void {
+		const m = event?.message;
+		if (m?.role !== "assistant") return;
+		if (event.type === "message_start") { finishThinking(); clock = { elapsed: new Map(), lengths: [] }; }
+		currentMessage = m;
+		const runs = thoughtRuns(m), lengths = runs.map((s) => s.length);
+		const run = runs.length - 1;
+		const grew = run >= 0 && lengths[run] > (clock.lengths[run] ?? 0);
+		const active = event.type !== "message_end" && run >= 0 && (lastThought(m) || grew);
+		if (active && clock.active !== run && !clock.elapsed.has(run)) { finishThinking(); clock.active = run; clock.started = Date.now(); }
+		if (!active) finishThinking();
+		clock.lengths = lengths; clockSnapshot(m);
+	}
+	function msOf(p: Part): number | undefined {
+		const message = p.owner.lastMessage;
+		const values = clockByMessage.get(message) ?? (stamp(message) ? clockByStamp.get(stamp(message)!) : undefined);
+		return values?.get(p.run ?? 0);
+	}
+	function pulse(): void {
+		if (currentMessage && clock.active !== undefined) clockSnapshot(currentMessage);
+		redraw();
+	}
+	function setRunning(value: boolean): void {
+		inFlight = value;
+		if (value && !timer) { timer = setInterval(pulse, 250); timer.unref?.(); }
+		if (!value && timer) { clearInterval(timer); timer = undefined; }
+	}
+	function partsOf(child: any): Part[] {
+		if (!isAssistant(child)) return [{ key: isTool(child) ? `tool:${child.toolCallId}` : partId(child), kind: isTool(child) ? "tool" : "other", owner: child }];
+		const cc = child.contentContainer;
+		if (!Array.isArray(cc?.children) || !(child.thinkingVisibilityOverrides instanceof Map)) throw new Error("Assistant component shape changed");
+		let run = 0, pos = 0;
+		const parts: Part[] = [];
+		for (const node of cc.children) {
+			if (isSpacer(node)) continue;
+			if (isThoughtRegion(node)) {
+				parts.push({ key: `${partId(child)}:thinking:${run}`, kind: "thought", owner: child, node, run: run++, streaming: child.isStreaming });
+			} else parts.push({ key: `${partId(child)}:text:${pos++}`, kind: "text", owner: child, node });
+		}
+		return parts;
+	}
+	/**
+	 * 直播尾窗的 thinking 块：头行（⠹ spinner/∴ + Thinking 扫光 · 藏行数 · 点击全显，或未截尾时只报行数）
+	 * + 尾部 cap-1 行（统一 3 列缩进，∴ 只在头行）。窗口高度恒为 thinkingTailLines，越过边界不跳行。
+	 */
+	function windowedThought(p: Part, width: number): { head: string; body: string[] } {
+		const pad = Math.max(0, Math.min(3, width - 1));
+		const originallyHidden = p.owner.thinkingVisibilityOverrides?.get(p.run) ?? p.owner.hideThinkingBlock;
+		// Pi's hidden-thinking node contains only "Thinking...". For the transient
+		// live tail, render the actual streamed text without persisting a visibility
+		// override; the user's hidden setting still applies after the stage seals.
+		const source = originallyHidden ? (thoughtRuns(p.owner.lastMessage)[p.run ?? 0] ?? "") : "";
+		const node = originallyHidden && source
+			? new Markdown(source, 0, 0, p.owner.markdownTheme ?? getMarkdownTheme(), {
+				color: (value: string) => fg(theme(), "thinkingText", value), italic: true,
+			})
+			: p.node.child;
+		const previous = node.paddingX;
+		let raw: string[];
+		try {
+			if (typeof previous === "number") node.paddingX = 0;
+			raw = blankTrim(node.render(Math.max(1, width - pad)));
+		} finally {
+			if (typeof previous === "number") node.paddingX = previous;
+		}
+		const cap = Math.max(1, config.thinkingTailLines);
+		const hidden = Math.max(0, raw.length - cap + 1);
+		const live = !!p.streaming && inFlight;
+		const spinning = live && clock.active === p.run;
+		const glyph = spinning ? fg(theme(), "accent", spinnerGlyph()) : fg(theme(), "thinkingText", "∴");
+		const word = live ? animateRunningSummary("Thinking", theme(), Math.floor(Date.now() / 90)) : fg(theme(), "thinkingText", "Thinking");
+		const meta = fg(theme(), "dim", hidden > 0 ? `${hidden} earlier ${hidden === 1 ? "line" : "lines"} · click to show all` : `${raw.length} ${raw.length === 1 ? "line" : "lines"}`);
+		const head = fit(` ${glyph} ${word} · ${meta}`, width);
+		const gutter = truncateToWidth("   ", pad, "");
+		const body = raw.slice(hidden).map((l: string) => (isImageLine(l) ? l : fit(gutter + l, width)));
+		return { head, body };
+	}
+	function nativePart(p: Part, width: number, forceThought = false): { lines: string[]; component: any } {
+		if (p.kind === "tool" || p.kind === "other") {
+			const owner = p.owner;
+			const before = owner.__claudeForcedDetail;
+			if (forceThought && p.kind === "tool") owner.__claudeForcedDetail = true;
+			try { return { lines: owner.render(width), component: owner }; }
+			finally { owner.__claudeForcedDetail = before; }
+		}
+		const isThought = p.kind === "thought";
+		const hidden = p.owner.thinkingVisibilityOverrides?.get(p.run) ?? p.owner.hideThinkingBlock;
+		if (isThought && hidden && !forceThought) return { lines: [], component: {} };
+		const pad = Math.max(0, Math.min(3, width - 1));
+		let node = isThought ? p.node.child : p.node;
+		if (isThought && forceThought && !("defaultTextStyle" in node)) {
+			const text = thoughtRuns(p.owner.lastMessage)[p.run ?? 0] ?? "", fingerprint = tokenKey();
+			let byRun = renderedThoughts.get(p.owner);
+			if (!byRun) { byRun = new Map(); renderedThoughts.set(p.owner, byRun); }
+			let cached = byRun.get(p.run ?? 0);
+			if (!cached || cached.text !== text || cached.theme !== fingerprint) {
+				cached = { text, theme: fingerprint, node: new Markdown(text, 0, 0, p.owner.markdownTheme ?? getMarkdownTheme(), { color: (s: string) => fg(theme(), "thinkingText", s), italic: true }) };
+				byRun.set(p.run ?? 0, cached);
+			}
+			node = cached.node;
+		}
+		const previous = node.paddingX;
+		let raw: string[];
+		try { if (typeof previous === "number") node.paddingX = 0; raw = blankTrim(node.render(Math.max(1, width - pad))); }
+		finally { if (typeof previous === "number") node.paddingX = previous; }
+		const prefix = isThought ? ` ${fg(theme(), "thinkingText", "∴")} ` : ` ${fg(theme(), "text", "●")} `;
+		const lines = raw.map((l, i) => isImageLine(l) ? l : fit(truncateToWidth(i ? "   " : prefix, pad, "") + l, width));
+		const component = {
+			handleMouse(e: any) {
+				if (e.x < pad) {
+					if (isThought && e.type === "click" && e.button === "left") {
+						p.owner.thinkingVisibilityOverrides.set(p.run, true); p.owner.updateContent(p.owner.lastMessage); redraw(); return { handled: true };
+					}
+					return undefined;
+				}
+				return node.handleMouse?.({ ...e, x: e.x - pad, width: Math.max(1, width - pad) });
+			},
+		};
+		return { lines, component };
+	}
+	function toolView(self: any): ToolView {
+		return { name: self.toolName, args: self.args ?? {}, result: self.result, partial: !!self.isPartial, started: !!self.executionStarted, expanded: effectiveExpanded(self), cwd: self.cwd };
+	}
+	function toggleTool(self: any): any {
+		return { handleMouse(e: any) {
+			if (e.type !== "click" || e.button !== "left" || !canExpandTool(toolView(self))) return undefined;
+			const next = !(self.__claudeRenderedExpanded ?? effectiveExpanded(self));
+			toolOverrides.set(self.toolCallId, next); self.setExpanded(next); redraw();
+			return { handled: true };
+		} };
+	}
+	function foreignBody(self: any, width: number, expanded: boolean): { lines: string[]; entries: any[] } | undefined {
+		const shell = self.getRenderShell?.() === "self" ? self.selfRenderContainer : self.contentBox;
+		// codemode 的脚本（call 组件）平时由头行参数提示代言；展开时才随结果一起渲染。
+		const withCall = self.toolName === "codemode" && expanded && self.result;
+		const nativeChildren: any[] = Array.isArray(shell?.children)
+			? (self.result ? shell.children.slice(withCall ? 0 : 1) : shell.children.slice(0, 1))
+			: [];
+		if (!nativeChildren.length) return undefined;
+		const indent = Math.min(6, Math.max(0, width - 1)), bodyWidth = Math.max(1, width - indent);
+		const lines: string[] = [], entries: any[] = [];
+		// pending（无 result）的 call 组件是待交互控件（确认按钮等），折叠它会死锁：
+		// 用户必须先看到并点它，工具才会有 result。故预算只约束已结算的 body。
+		let rowsLeft = expanded || !self.result ? Infinity : FOREIGN_PREVIEW_ROWS, hidden = 0;
+		// codemode（一南 2026-09-30）：折叠预算随嵌套调用数放宽——pi renderResult 的 calls 段
+		// （✓/✗ 行、"... (N earlier calls)"、费用汇总）整段显示，仅其后的 stdout 段折叠进 hint。
+		const cmCalls = self.toolName === "codemode" && self.result && Array.isArray(self.result?.details?.calls)
+			? self.result.details.calls.length
+			: 0;
+		for (const native of nativeChildren) {
+			if (!native || typeof native.render !== "function") continue;
+			// pi 的 renderResult 以 "\n" 开头分段；剥掉首尾空行，别让 ⎿ 拐角行空挂。
+			let raw: string[] = blankTrim(native.render(bodyWidth));
+			if (cmCalls > 0 && rowsLeft !== Infinity) {
+				// calls 段与 stdout 段以一个分段空行相隔（pi renderResult 用 join("\n\n") 分段）。
+				const sep = raw.findIndex(isBlank);
+				const callRows = sep === -1 ? raw.length : sep;
+				if (callRows > rowsLeft) rowsLeft = callRows;
+			}
+			if (raw.length > rowsLeft) { hidden += raw.length - rowsLeft; raw = raw.slice(0, Math.max(0, rowsLeft)); }
+			rowsLeft -= raw.length;
+			const start = lines.length;
+			for (let i = 0; i < raw.length; i++) lines.push(isImageLine(raw[i]) ? raw[i] : fit(truncateToWidth(start + i === 0 ? `   ${fg(theme(), "dim", "⎿")}  ` : "      ", indent, "") + raw[i], width));
+			const proxy = {
+				handleMouse(e: any) {
+					if (e.x < indent) return undefined;
+					const local = { ...e, x: e.x - indent, width: bodyWidth, height: raw.length };
+					const result = native.handleMouse?.(local);
+					if (result && (result.handled || result.capture || result.focus || "target" in result)) {
+						// pi 的 MouseRegion 在 click 时会自行 toggle self.expanded；把我们的 override
+						// 对齐到 toggle 后的新状态，避免视图展开态与组件渲染态脱钩（混合视图 bug）。
+						toolOverrides.set(self.toolCallId, !!self.expanded);
+						if ("target" in result) return result;
+						return { ...result, handled: true, ...(result.focus ? { focusTarget: native } : {}), target: { component: native, originX: e.screenX - local.x, originY: e.screenY - local.y, width: bodyWidth, height: raw.length } };
+					}
+					// The native component left this click unhandled: toggle the entry so
+					// content clicks expand/collapse foreign tools too. Controls that do
+					// handle the event (buttons, capture, focus) always win.
+					if (e.type === "click" && e.button === "left" && !isImageLine(raw[e.y] ?? "")) {
+						return toggleTool(self).handleMouse(e);
+					}
+					return undefined;
+				},
+			};
+			entries.push({ component: proxy, height: raw.length });
+		}
+		if (hidden > 0) {
+			// 截断点常停在段落分隔空行上（pi 的 renderResult 用 "\n\n" 分段）：
+			// 把已显示行尾部的空行并入 hidden，让提示行紧跟内容行。
+			while (lines.length && isBlank(lines.at(-1)!)) {
+				lines.pop();
+				hidden++;
+				const last = entries.at(-1);
+				if (last && --last.height <= 0) entries.pop();
+			}
+			const more = prefixed(fg(theme(), "dim", `… +${hidden} lines`) + expandHint(theme()), width, `   ${fg(theme(), "dim", "⎿")}  `, "      ");
+			lines.push(...more);
+			entries.push({ component: toggleTool(self), height: more.length });
+		}
+		return lines.length ? { lines, entries } : undefined;
+	}
+	function renderTool(self: any, orig: Function, width: number): string[] {
+		if (disabled) return orig.call(self, width);
+		if (typeof self.setExpanded !== "function" || !Array.isArray(self.imageComponents)) throw new Error("Tool component shape changed");
+		if (self.hideComponent && !self.result && !self.isPartial) return [];
+		const v = toolView(self), t = theme();
+		self.__claudeRenderedExpanded = v.expanded;
+		const useNative = !BUILTIN_NAMES.has(v.name) && !!(self.resultRendererComponent ?? self.callRendererComponent);
+		const cacheKey = [width, self.args, self.result, self.isPartial, self.executionStarted, v.expanded, self.showImages, self.imageWidthCells, self.imageComponents, tokenKey(), config.bashPreviewLines, config.codePreviewLines, config.errorPreviewLines];
+		const cached = renderedTools.get(self);
+		if (!useNative && cached && cacheKey.every((x, i) => x === cached.key[i])) { self.mouseLayout = cached.layout; return cached.lines; }
+		let lines: string[], entries: any[];
+		if (useNative) {
+			const head = headerOf(v, t, width), body = foreignBody(self, width, v.expanded);
+			lines = [...head, ...(body?.lines ?? [])];
+			entries = [{ component: toggleTool(self), height: head.length }, ...(body?.entries ?? [])];
+			if (v.partial && !body?.lines.length) {
+				const pending = prefixed(fg(t, "dim", v.started ? "Running…" : "Waiting…"), width, `   ${fg(t, "dim", "⎿")}  `, "      ");
+				lines.push(...pending); entries.push({ component: {}, height: pending.length });
+			}
+		} else {
+			const painted = paintTool(v, t, width, config);
+			lines = painted.lines;
+			if ((v.name === "edit" || v.name === "write") && v.result && !failedTool(v) && renderRichDiff) {
+				const previous = richDiffs.get(self);
+				const same = previous && previous.args === self.args && previous.result === self.result
+					&& previous.themeKey === cacheKey[9] && previous.expanded === v.expanded;
+				const rich = same ? previous.component : renderRichDiff(self, v.expanded, t, () => {
+					renderedTools.delete(self);
+					redraw();
+				});
+				if (rich) {
+					if (!same) richDiffs.set(self, { args: self.args, result: self.result, themeKey: cacheKey[9], expanded: v.expanded, component: rich });
+					try {
+						const bodyWidth = Math.max(1, width - 6);
+						const detail = rich.render(bodyWidth);
+						// The vendored renderer limits body rows and supplies its own remainder hint.
+						// Do not also slice by codePreviewLines: that counts the diff header/frame
+						// against the body and hides almost every changed row.
+						const prefix = `   ${fg(t, "dim", "⎿")}  `;
+						// The rich edit header already reports +N/-M; do not repeat
+						// paintTool's "Added N lines, removed M lines" summary above it.
+						const introRows = painted.headerHeight + (v.name === "edit" ? 0 : 1);
+						lines = [...painted.lines.slice(0, introRows),
+							...detail.map((line, i) => fit((i === 0 ? prefix : "      ") + line, width))];
+					} catch {
+							// Keep the existing edit/write renderer as a fail-open fallback.
+					}
+				}
+			}
+			// The whole painted body folds back on click; image protocol rows stay inert.
+			entries = [];
+			let start = 0;
+			const flush = (end: number) => { if (end > start) entries.push({ component: toggleTool(self), height: end - start }); };
+			for (let i = 0; i < lines.length; i++) {
+				if (isImageLine(lines[i])) { flush(i); entries.push({ component: {}, height: 1 }); start = i + 1; }
+			}
+			flush(lines.length);
+		}
+		for (const img of self.imageComponents ?? []) {
+			const raw = img.render(width); lines.push(...raw); entries.push({ component: {}, height: raw.length });
+		}
+		self.mouseLayout = { width, children: entries };
+		if (!useNative) renderedTools.set(self, { key: cacheKey, lines, layout: self.mouseLayout });
+		return lines;
+	}
+	function isMember(p: Part): boolean { return p.kind === "thought" || p.kind === "tool" && PROCESS_TOOL_NAMES.has(p.owner.toolName); }
+	function stageSummary(stage: Stage, active: boolean): string {
+		const counts = new Map<string, number>(); let ms = 0, measured = false, thought = false, errors = 0;
+		for (const p of stage.parts) {
+			if (p.kind === "thought") { thought = true; const n = msOf(p); if (n !== undefined) { ms += n; measured = true; } continue; }
+			const v = toolView(p.owner);
+			counts.set(v.name, (counts.get(v.name) ?? 0) + 1);
+			if (v.result?.isError) errors++;
+		}
+		const labels: Record<string, [string, string, string, string?]> = {
+			read: ["reading", "read", "file"], ls: ["listing", "listed", "directory", "directories"], bash: ["running", "ran", "shell command"], powershell: ["running", "ran", "PowerShell command"], grep: ["searching", "searched", "pattern"], find: ["searching", "searched", "file pattern"], write: ["writing", "wrote", "file"], edit: ["editing", "edited", "file"],
+		};
+		const items: string[] = [];
+		if (thought && (!active || counts.size === 0)) items.push(measured ? `thought for ${bold(theme(), duration(ms))}` : active ? "thinking" : "thought");
+		for (const [name, n] of counts) {
+			const l = labels[name] ?? ["using", "used", name];
+			items.push(`${l[active ? 0 : 1]} ${bold(theme(), String(n))} ${n === 1 ? l[2] : l[3] ?? l[2] + "s"}`);
+		}
+		if (errors) items.push(fg(theme(), "error", `${errors} failed`));
+		let s = items.join(", "); if (s) s = s[0].toUpperCase() + s.slice(1);
+		return s + (active ? "…" : "");
+	}
+	function renderChat(container: any, width: number): string[] {
+		if (disabled) return Container.prototype.render.call(container, width);
+		// Pi emits SkillInvocation before the user message it accompanies; the
+		// transcript shows the user's prompt first and the skill right below it.
+		const ordered: any[] = [];
+		const raw = container.children.filter((c: any) => !isSpacer(c));
+		for (let i = 0; i < raw.length; i++) {
+			if (i + 1 < raw.length && isSkill(raw[i]) && isUserMessage(raw[i + 1])) {
+				ordered.push(raw[i + 1], raw[i]);
+				i++;
+				continue;
+			}
+			ordered.push(raw[i]);
+		}
+		const parts: Part[] = [];
+		for (const child of ordered) parts.push(...partsOf(child));
+		const units: (Part | Stage)[] = []; let current: Stage | undefined;
+		for (const p of parts) {
+			if (isMember(p)) { if (!current) { current = { key: p.key, parts: [], sealed: false }; units.push(current); } current.parts.push(p); }
+			else { if (current) current.sealed = true; current = undefined; units.push(p); }
+		}
+		const lines: string[] = [], layout: any[] = [];
+		/** 块间呼吸（一南 2026-09-26 二次修订，全面取代 2026-09-21 零空行原则）：每个非空块
+		 *  渲染前垫一行，块内部结构不变。同一逻辑块的两截（尾窗头行+正文、收拢动画捕获行）
+		 *  传 pad=false 紧贴；首块前不垫、块尾自空行不叠加。 */
+		const append = (raw: string[], component: any, background = false, pad = true) => {
+			if (!raw.length) { layout.push({ component, height: 0 }); return; }
+			if (pad && lines.length && lines[lines.length - 1].trim() !== "") {
+				lines.push("");
+			layout.push({ component: {}, height: 1 });
+			}
+			lines.push(...(background ? raw.map((l) => paintBackground(l, width, theme(), config.detailsBackground)) : raw));
+			layout.push({ component, height: raw.length });
+		};
+		for (const unit of units) {
+			if (!("parts" in unit)) {
+				const out = nativePart(unit, width);
+				append(out.lines, out.component);
+				continue;
+			}
+			const stage = unit;
+			const tools = stage.parts.filter((p) => p.kind === "tool");
+			const pending = tools.some((p) => p.owner.isPartial);
+			const active = pending || (!stage.sealed && inFlight);
+			// 展开来源两分；灰底（detailsBackground）只跟「封口后的展开」走（一南 2026-09-21，Q12 修订）：
+			//   manualDefault —— 持久意图：ctrl+o（成员工具 expanded）、ctrl+T（__claudeReveal，
+			//     见 modeUpdateThinkingVisibility）。未封口阶段无灰；封口后保持展开并转灰。
+			//   runtimeOpen —— 直播撑开（sticky，见 stageAutoOpen）：阶段未封口且 thinking 可见，
+			//     一旦成立记忆到封口（2026-09-30 修复横跳）。封口前的点击展开同属运行时
+			//     视图（无灰），封口转变时随 open 一起清掉、走收拢动画折回。全局"显示 thinking"
+			//     （hideThinkingBlock=false）不是保持展开的理由（一南 2026-09-20 报的 bug）；
+			//     撑开封口阶段的只有 ctrl+T 那一刻打的标。
+			let manualDefault = false;
+			const liveNow = stage.parts.some((p) => {
+				if (p.kind === "tool") {
+					if (p.owner.expanded) manualDefault = true;
+					return false;
+				}
+				if (p.owner.__claudeReveal === true) {
+					manualDefault = true;
+					return false;
+				}
+				// Hidden thinking opens only when an actual thinking message is streaming.
+				// A historical/settled hidden block, or a pending turn without any
+				// thinking text, must keep its existing compact summary behavior.
+				const hidden = p.owner.thinkingVisibilityOverrides?.get(p.run) ?? p.owner.hideThinkingBlock;
+				return !stage.sealed && (!hidden || (config.liveThinking && inFlight && p.streaming && !!thoughtRuns(p.owner.lastMessage)[p.run ?? 0]?.trim()));
+			});
+			// ── sticky 撑开（一南 2026-09-30）：本帧有可见/直播 thinking 即记入 stageAutoOpen，
+			//    未封口期间持续生效——streaming 停了也不折回，封口转变才随 open 一起清、走
+			//    收拢动画折一次。用户点击（open，含手动折叠）优先级仍在 sticky 之上。
+			if (liveNow && !stage.sealed) stageAutoOpen.add(stage.key);
+			// ── 封口转变（Q12）：未封口期间点的 open=true 属运行时视图，随封口折回（清掉再走
+			//    收拢动画）；ctrl+o/ctrl+T 撑住的不折、封口后转灰。历史首帧（undefined）不算转变。
+			const prevSealed = stagePrevSealed.get(stage.key);
+			stagePrevSealed.set(stage.key, stage.sealed);
+			const sealedNow = stage.sealed && prevSealed === false;
+			if (sealedNow) {
+				if (open.get(stage.key) === true) open.delete(stage.key);
+				stageAutoOpen.delete(stage.key);
+			}
+			const openOverride = open.get(stage.key);
+			const runtimeOpen = !stage.sealed && stageAutoOpen.has(stage.key);
+			const expanded = openOverride ?? (manualDefault || runtimeOpen);
+			// 灰底条件：封口后的展开——封口后点的 open=true，或封口时仍在的持久意图（ctrl+o/ctrl+T）。
+			// 未封口期间的一切展开（自动撑开、点击撑开）都是运行时视图，不上灰。
+			const manual = stage.sealed && (openOverride === true || (openOverride === undefined && manualDefault));
+			const toggle = { handleMouse(e: any) { if (e.type !== "click" || e.button !== "left") return undefined; open.set(stage.key, !expanded); stageAnim.delete(stage.key); redraw(); return { handled: true }; } };
+			// 直播尾窗（一南 2026-09-21，语义对齐 legacy）：未封口阶段的 thinking 成员按
+			// thinkingTailLines 截尾滚动；头行恒占 1 行（点它 = 本 run 全显不回截尾，新 run 重新截尾）。
+			// 历史/回合结束后的未封口滞留阶段同按窗口处理——否则 settle 一刻尾窗会弹回全文。
+			const windowOn = !stage.sealed && config.liveThinking && config.thinkingTailLines > 0;
+			// ── 封口收拢动画：只在「运行时展开 → 封口」的转变上起一次（一南 Q5/Q6）。ctrl+o/ctrl+T
+			// 撑住的、历史首帧、foldAnimMs=0、上一帧没有可见行 ⇒ 都不起。
+			if (sealedNow && openOverride === undefined && !manualDefault) {
+				if (config.foldAnimMs > 0 && (stageRows.get(stage.key) ?? 0) > 0) {
+					// 捕获封口那刻的可见成员行（thinking 按尾窗语义冻结），文案冻结在封口起点。
+					const captureWindow = config.liveThinking && config.thinkingTailLines > 0;
+					const capture: string[] = [];
+					for (const p of stage.parts) {
+						if (captureWindow && p.kind === "thought" && !tailOff.has(p.key)) {
+							const w = windowedThought(p, width);
+							capture.push(w.head, ...w.body);
+							continue;
+						}
+						const out = nativePart(p, width, p.kind === "thought" || !!mode?.toolOutputExpanded);
+						capture.push(...out.lines);
+					}
+					if (capture.length) {
+						stageAnim.set(stage.key, { startedAt: Date.now(), lines: capture, label: stageSummary(stage, false) });
+						for (let i = 1; i <= 3; i++) {
+							const tick = setTimeout(() => { if (stageAnim.has(stage.key)) redraw(); }, Math.round((config.foldAnimMs * i) / 3));
+							(tick as any).unref?.();
+						}
+					}
+				}
+			}
+			stageRows.delete(stage.key);
+			if (expanded) {
+				let total = 0;
+				for (const p of stage.parts) {
+					const force = open.get(stage.key) === true || !!mode?.toolOutputExpanded;
+					const w = windowOn && p.kind === "thought" && !tailOff.has(p.key) ? windowedThought(p, width) : undefined;
+					if (w) {
+						const headToggle = { handleMouse(e: any) { if (e.type !== "click" || e.button !== "left") return undefined; tailOff.add(p.key); redraw(); return { handled: true }; } };
+						append([w.head], headToggle, manual);
+						total += 1;
+						if (w.body.length) {
+							const bodyToggle = { handleMouse(e: any) { if (e.type !== "click" || e.button !== "left" || isImageLine(w.body[e.y] ?? "")) return undefined; return toggle.handleMouse(e); } };
+							append(w.body, bodyToggle, manual, false);
+							total += w.body.length;
+						}
+						continue;
+					}
+					const out = nativePart(p, width, force || p.kind === "thought");
+					if (!out.lines.length) continue;
+					const blockToggle = {
+						handleMouse(e: any) {
+							if (e.type !== "click" || e.button !== "left" || isImageLine(out.lines[e.y] ?? "")) return undefined;
+							return toggle.handleMouse(e);
+						},
+					};
+					append(out.lines, blockToggle, manual);
+					total += out.lines.length;
+				}
+				stageRows.set(stage.key, total);
+				continue;
+			}
+			// ── 收拢动画帧：summary 行（文案冻结）+ 捕获成员行从下往上收到 0；进度按墙钟，
+			// 帧晚到只少收几次、不会卡半截。点任意行 = 取消动画、按点击语义即时落定（一南 Q7）。
+			const anim = stageAnim.get(stage.key);
+			if (anim && anim.lines.length) {
+				const t = (Date.now() - anim.startedAt) / config.foldAnimMs;
+				const k = t >= 1 ? 0 : Math.max(1, Math.round(anim.lines.length * (1 - t)));
+				if (k > 0) {
+					append(prefixed(fg(theme(), "muted", anim.label), width, ` ${fg(theme(), "muted", " ")} `, "   "), toggle);
+					const restToggle = { handleMouse(e: any) { if (e.type !== "click" || e.button !== "left" || isImageLine(anim.lines[e.y] ?? "")) return undefined; return toggle.handleMouse(e); } };
+					append(anim.lines.slice(0, k), restToggle, false, false);
+					continue;
+				}
+				stageAnim.delete(stage.key);
+			}
+			// Pure live thinking is already represented in the existing working indicator.
+			if (active && tools.length === 0) continue;
+			const dot = active ? (Math.floor(Date.now() / 500) % 2 ? "●" : " ") : " ";
+			const label = stageSummary(stage, active);
+			const animatedLabel = active ? animateRunningSummary(label, theme(), Math.floor(Date.now() / 90)) : fg(theme(), "muted", label);
+			const rows = prefixed(animatedLabel, width, ` ${fg(theme(), "muted", dot)} `, "   ");
+			if (active && tools.length) {
+				const focus = [...tools].reverse().find((p) => p.owner.isPartial) ?? tools.at(-1)!;
+				const v = toolView(focus.owner), target = targetOf(v.name, v.args, v.cwd).text;
+				if (target) rows.push(...prefixed(fg(theme(), "muted", (v.name === "bash" || v.name === "powershell" ? "$ " : "") + target), width, `   ${fg(theme(), "dim", "⎿")}  `, "      ").slice(0, 2));
+			}
+			append(rows, toggle);
+			// Failures stay folded like the rest: the summary counts them ("N failed")
+			// and the full error is only visible in the expanded detail region.
+		}
+		container.mouseLayout = { width, children: layout };
+		return prefixZones(lines.map((l) => fit(l, width)));
+	}
+	function hookMode(next: any): void {
+		mode = next;
+		const cc = mode?.chatContainer;
+		if (!cc || !Array.isArray(cc.children)) return;
+		if (disabled) return;
+		if (cc.__tidyNoSpacers) {
+			// Retire the previous profile's instance hooks on a live /reload.
+			if (cc.addChild?.name === "leanTidyAddChild") cc.addChild = Container.prototype.addChild;
+			for (const child of cc.children) if (isSpacer(child) && child.lines === 0) child.setLines(1);
+			delete cc.__tidyNoSpacers;
+		}
+		chatContainers.add(cc);
+		if (!cc.__claudeChatWrapped) {
+			cc.__claudeChatWrapped = true;
+			cc[ORIGINAL_RENDER] = cc.render?.name === "leanTidyChatRender" ? Container.prototype.render : cc.render;
+			chatContainers.add(cc);
+			cc.render = function (width: number) {
+				const current = (globalThis as any)[SLOT];
+				const fallback = this[ORIGINAL_RENDER] ?? Container.prototype.render;
+				if (!current || !current.enabled()) return fallback.call(this, width);
+				try { return current.renderChat(this, width); }
+				catch (e) { current.fail(e); return fallback.call(this, width); }
+			};
+		}
+	}
+	function renderAssistant(self: any, orig: Function, width: number): string[] {
+		if (disabled) return orig.call(self, width);
+		// 同一条消息内部的成员紧邻（零空行）。
+		const lines: string[] = [], layout: any[] = [];
+		for (const part of partsOf(self)) {
+			const out = nativePart(part, width);
+			lines.push(...out.lines); layout.push({ component: out.component, height: out.lines.length });
+		}
+		self.mouseLayout = { width, children: layout };
+		return prefixZones(lines);
+	}
+	function renderGeneric(self: any, orig: Function, width: number): string[] {
+		if (disabled) return orig.call(self, width);
+		// User Markdown is rendered without its full-width Box. Preserve its transforms and theme.
+		// pi ≤0.99 把 Markdown 包在 Box 里（children[0].children[0]）；1.0.0 修「每行保留两份
+		// 全宽副本」时删掉了 Box，Markdown 直接落在 children[0]（user-message.js rebuild）。
+		// 两种形状都取最内层那个 Markdown；Markdown 自身无 children，?? 回退不会误取。
+		const userMarkdown = self.children?.[0]?.children?.[0] ?? self.children?.[0];
+		if (typeof self.rebuild === "function" && typeof self.text === "string" && typeof userMarkdown?.render === "function") {
+			const markdown = userMarkdown;
+			const pad = Math.min(3, Math.max(0, width - 1));
+			// pi 1.0.0 的 Markdown 自带 paddingX（旧版缩进在已删除的 Box 上）；❯ 前缀自己提供
+			// 缩进，渲染前临时置零（同 thinking 节点的手法），否则 ❯ 后会出现双空格。
+			// Markdown.render 的行缓存不含 paddingX，恢复后 invalidate 防止零缩进结果
+			// 污染后续原生渲染。
+			const previousPad = markdown.paddingX;
+			let raw: string[];
+			try { if (typeof previousPad === "number") markdown.paddingX = 0; raw = blankTrim(markdown.render(Math.max(1, width - pad))); }
+			finally { if (typeof previousPad === "number") { markdown.paddingX = previousPad; markdown.invalidate?.(); } }
+			const lines = raw.map((l: string, i: number) => isImageLine(l) ? l : fit((i ? "   " : " ❯ ").slice(0, pad) + l, width));
+			const activeTheme = theme();
+			const themed = lines.map((l: string) => paintBackground(userMessageForeground(l, activeTheme), width, activeTheme, "userMessageBg"));
+			if (themed.length) { themed[0] = "\x1b]133;A\x07" + themed[0]; themed[themed.length - 1] = "\x1b]133;B\x07\x1b]133;C\x07" + themed[themed.length - 1]; }
+			self.mouseLayout = { width, children: [{ component: {}, height: themed.length }] };
+			return themed;
+		}
+		if (self.skillBlock) {
+			// skillRendering=native：回退 pi 原生渲染，但去掉 Box(1,1) 上下各一行整宽紫底 padding 空行
+			// （一南 2026-10-05）。只 trim 首尾纯背景空行；内容行（左内边距 + customMessageBg 底色）原样保留。
+			if (config.skillRendering !== "claude") {
+				const raw: string[] = orig.call(self, width);
+				const blankRow = (l: string) => l.replace(/\x1b\[[0-9;]*m/g, "").trim() === "";
+				let top = 0, bottom = raw.length;
+				while (top < bottom && blankRow(raw[top])) top++;
+				while (bottom > top && blankRow(raw[bottom - 1])) bottom--;
+				const trimmed = raw.slice(top, bottom);
+				// 顶部 padding 行删掉后点击会错位 top 行：实例级补一层 y+top 再交还原生 Box.handleMouse
+				// （其内部做 contentY = y - paddingY 的映射，x 与内部 mouseLayout 分发照旧）。own property
+				// 覆盖原型方法，hasOwnProperty 防止 /reload 反复包茧。
+				if (trimmed.length !== raw.length && !Object.prototype.hasOwnProperty.call(self, "handleMouse")) {
+					self.handleMouse = (event: any) =>
+						Box.prototype.handleMouse.call(self, { ...event, y: (event?.y ?? 0) + top });
+				}
+				return trimmed;
+			}
+			const name = oneLine(self.skillBlock.name), lines = [` ${fg(theme(), "success", "●")} ${bold(theme(), "Skill")}(${name})`];
+			lines.push(...prefixed(fg(theme(), "muted", "Loaded skill") + (self.expanded ? "" : ` (${keyText("app.tools.expand")} to expand)`), width, `   ${fg(theme(), "dim", "⎿")}  `, "      "));
+			if (self.expanded) {
+				const md = new Markdown(self.skillBlock.content ?? "", 0, 0, self.markdownTheme ?? getMarkdownTheme());
+				for (const l of md.render(Math.max(1, width - 3))) lines.push(fit("   " + l, width));
+			}
+			self.mouseLayout = { width, children: [{ component: { handleMouse(e: any) { if (e.y !== 0 || e.type !== "click" || e.button !== "left") return undefined; self.setExpanded(!self.expanded); redraw(); return { handled: true }; } }, height: lines.length }] };
+			return lines.map((l) => fit(l, width));
+		}
+		return orig.call(self, width); // Custom entries and images keep native structure.
+	}
+	function fail(error: unknown): void {
+		if (disabled) return;
+		disabled = true; setRunning(false);
+		for (const cc of chatContainers) { cc.render = cc[ORIGINAL_RENDER] ?? Container.prototype.render; delete cc[ORIGINAL_RENDER]; delete cc.__claudeChatWrapped; }
+		for (const cc of chatContainers) for (const child of cc.children ?? []) {
+			if (isAssistant(child) && child.contentContainer?.__leanTidyFilteredContainer) { child.contentContainer.render = Container.prototype.render; delete child.contentContainer.__leanTidyFilteredContainer; }
+		}
+		report(`Claude display disabled: ${error instanceof Error ? error.message : String(error)}. Native display restored; /reload after updating Pi compatibility.`);
+		redraw();
+	}
+	function dispose(): void {
+		setRunning(false);
+		finishThinking();
+	}
+	const api = {
+		enabled: () => !disabled,
+		fail, hookMode, renderChat, dispose,
+		toolExecRender: (self: any, orig: Function, width: number) => renderTool(self, orig, width),
+		toolExecHandleMouse: (self: any, orig: Function, event: any) => disabled ? orig.call(self, event) : Container.prototype.handleMouse.call(self, event),
+		assistantRender: renderAssistant,
+		assistantUpdateContent(self: any, orig: Function, message: any, streaming?: boolean) {
+			if (disabled) return orig.call(self, message, streaming);
+			// Retire the previous profile's live overrides when entering the new renderer.
+			if (!self.__claudeAssistant) { self.__claudeAssistant = true; if (self.__tidyLiveRun !== undefined) self.thinkingVisibilityOverrides?.delete(self.__tidyLiveRun); self.__tidyLiveRun = undefined; self.__tidyFold = undefined; }
+			return orig.call(self, message, streaming);
+		},
+		genericRender: renderGeneric,
+		modeRenderInitial(self: any, orig: Function, ...args: any[]) { hookMode(self); return orig.apply(self, args); },
+		modeAddMessage(self: any, orig: Function, ...args: any[]) { hookMode(self); return orig.apply(self, args); },
+		modeSetToolsExpanded(self: any, orig: Function, expanded: boolean) {
+			if (disabled) return orig.call(self, expanded);
+			open.clear(); toolOverrides.clear(); stageAnim.clear(); stageAutoOpen.clear(); const result = orig.call(self, expanded);
+			self.hideThinkingBlock = !expanded; self.updateThinkingBlockVisibility(); redraw(); return result;
+		},
+		modeUpdateThinkingVisibility(self: any, orig: Function) {
+			if (disabled) return orig.call(self);
+			open.clear();
+			stageAnim.clear();
+			stageAutoOpen.clear();
+			// Ctrl+T / 设置切换：显示 → 给现存组件打标，让已封口的阶段也把 thinking 展开；
+			// 隐藏 → 清标回到自动折叠。只影响切换那一刻已有的组件，新阶段照常走生命周期。
+			const reveal = !self.hideThinkingBlock;
+			for (const cc of chatContainers) for (const child of cc.children ?? []) {
+				if (!isAssistant(child) && !isTool(child)) continue;
+				if (reveal) child.__claudeReveal = true;
+				else delete child.__claudeReveal;
+			}
+			return orig.call(self);
+		},
+		modeHandleEvent(self: any, orig: Function, event: any, ...rest: any[]) {
+			hookMode(self); return orig.call(self, event, ...rest);
+		},
+		onEvent(event: any) { if (!disabled) observe(event); },
+		onAgentStart() { if (disabled) return; clock = { elapsed: new Map(), lengths: [] }; currentMessage = undefined; setRunning(true); },
+		onSettled() { finishThinking(); setRunning(false); currentMessage = undefined; redraw(); },
+		onSession() { clock = { elapsed: new Map(), lengths: [] }; currentMessage = undefined; clockByMessage = new WeakMap(); open.clear(); stageAutoOpen.clear(); toolOverrides.clear(); tailOff.clear(); stagePrevSealed.clear(); stageRows.clear(); stageAnim.clear(); for (const cc of chatContainers) for (const child of cc.children ?? []) if (child?.__claudeReveal) delete child.__claudeReveal; setRunning(false); },
+		exportTimings() { return [...clockByStamp].map(([key, elapsed]) => ({ key, elapsed: [...elapsed] })); },
+		restoreTimings(entries: any[]) { for (const entry of entries) if (typeof entry?.key === "string" && Array.isArray(entry.elapsed)) clockByStamp.set(entry.key, new Map(entry.elapsed.filter((p: any) => Array.isArray(p) && Number.isInteger(p[0]) && Number.isFinite(p[1]) && p[1] >= 0))); },
+		latestTiming() { const key = stamp(currentMessage); return key && clockByStamp.has(key) ? { key, elapsed: [...clockByStamp.get(key)!] } : undefined; },
+		state() { return { inFlight, disabled, timer: !!timer }; },
+	};
+	return api;
+}