pi-cc-extensions 0.9.11 → 1.0.0

package/extensions/renderer/tool/diff/diff-edit-render.ts

@@ -1,6 +1,7 @@
-import { Text, type Component } from "@earendil-works/pi-tui";
+import { Text, visibleWidth, type Component } from "@earendil-works/pi-tui";
 import type { EditToolDetails } from "@earendil-works/pi-coding-agent";
 import { sanitizeToolResultText } from "../../../utils/tool-result-sanitize.ts";
+import { showMoreHintText } from "../show-more-hint.ts";
 import {
 	getLineNumberWidth,
 	parseDiff,
@@ -20,6 +21,7 @@ import {
 import { renderDiffFrameLine, renderHeaderRows, renderSingleDiffRow } from "./diff-header.ts";
 import {
 	applyLineLimit,
+	clampDiffLineToWidth,
 	clampDiffLinesToWidth,
 	resolveDiffDisplayLimit,
 	resolveDiffProcessBudget,
@@ -40,6 +42,7 @@ import {
 	buildDiffSummaryText,
 	normalizeDiffRenderWidth,
 	resolveDiffPresentationMode,
+	styleDiffSummaryLine,
 } from "./diff-presentation.ts";
 
 function safeGetDiff(details: unknown): string {
@@ -81,6 +84,28 @@ export function countEditDiffStats(
 	}
 }
 
+/** Keep counts in the result row: the default-mode edit title does not include them. */
+function renderEditCollapsedSummaryLine(
+	stats: ParsedDiff["stats"],
+	width: number,
+	theme: DiffTheme,
+	hovered: boolean,
+): string {
+	const counts = `+${stats.added} -${stats.removed}`;
+	const hint = showMoreHintText();
+	const candidates = [
+		`↳ diff ${counts} · ${hint}`,
+		`↳ ${counts} · ${hint}`,
+		`${counts} · ${hint}`,
+		`↳ diff ${counts}`,
+		counts,
+		"diff",
+		"…",
+	];
+	const text = candidates.find((candidate) => visibleWidth(candidate) <= width) ?? "";
+	return clampDiffLineToWidth(styleDiffSummaryLine(text, stats, hint, theme, hovered), width);
+}
+
 export function renderEditDiffResult(
 	details: unknown,
 	options: DiffRenderOptions,
@@ -110,29 +135,41 @@ export function renderEditDiffResult(
 		return new Text(theme.fg("muted", "↳ no diff data"), 0, 0);
 	}
 
-	const splitRows = buildSplitRows(renderEntries);
-	const showHashlineAnchors =
-		options.expanded === true &&
-		renderEntries.some((entry) => entry.kind === "line" && !!entry.hashlineAnchorContent);
-	const lineNumberWidth = getLineNumberWidth(renderEntries, showHashlineAnchors);
 	const palette = resolveDiffPalette(theme);
 	// Rich diffs use ccstyle's self shell. Keep the panel transparent so the
 	// separator cannot leak toolSuccessBg across the entire new column.
 	const containerBgAnsi = undefined;
 	const language = resolveLanguageFromPath(options.filePath);
 	const cache = createDiffRenderCache();
-	const highlightLine = createCodeLineHighlighter(language, theme, renderEntries, () => {
-		cache.invalidate();
-		options.invalidate?.();
-	});
+	// Summary-only previews need parsed counts, not split rows or syntax highlighting.
+	// Keep detailed data lazy so a live setting change can still reveal the same diff.
+	function buildDetailedData() {
+		const showHashlineAnchors =
+			options.expanded === true &&
+			renderEntries.some((entry) => entry.kind === "line" && !!entry.hashlineAnchorContent);
+		return {
+			splitRows: buildSplitRows(renderEntries),
+			showHashlineAnchors,
+			lineNumberWidth: getLineNumberWidth(renderEntries, showHashlineAnchors),
+			highlightLine: createCodeLineHighlighter(language, theme, renderEntries, () => {
+				cache.invalidate();
+				options.invalidate?.();
+			}),
+		};
+	}
+	let detailedData: ReturnType<typeof buildDetailedData> | undefined;
 
 	return {
 		[RICH_DIFF_COMPONENT]: true,
-		/** 鼠标层只在真正的 remainder 行上提供展开入口。 */
+		/** Only the current summary/remainder row is an expand target, never diff body text. */
 		isCollapsedHintLine(plainLine: string): boolean {
 			const hint = cache.getHintLine();
 			return hint !== undefined && normalizeCollapsedHintLine(plainLine) === hint;
 		},
+		/** 正文首行（diff 头行/0 行摘要行）自带 +A -D：标题不再重复计数。 */
+		bodyShowsStats(): boolean {
+			return true;
+		},
 		render(width: number): string[] {
 			// Live config: panel can change indicator/wrap/limits after this component is created.
 			const live = resolveLiveDisplayConfig(config);
@@ -147,6 +184,20 @@ export function renderEditDiffResult(
 				return cached;
 			}
 
+			// Like write's zero-line preview, handle this before the normal body limiter.
+			if (!options.expanded && live.editDiffCollapsedLines === 0) {
+				const summary = renderEditCollapsedSummaryLine(parsed.stats, safeWidth, theme, hovered);
+				return cache.set(
+					safeWidth,
+					options.expanded,
+					mode,
+					configKey,
+					hovered,
+					[summary],
+					normalizeCollapsedHintLine(summary),
+				);
+			}
+
 			if (mode === "summary") {
 				return cache.set(
 					safeWidth,
@@ -166,6 +217,8 @@ export function renderEditDiffResult(
 				);
 			}
 
+			const { splitRows, showHashlineAnchors, lineNumberWidth, highlightLine } = (detailedData ??=
+				buildDetailedData());
 			const headerRows = renderHeaderRows(parsed.stats, mode, safeWidth, theme);
 			const displayLimit = resolveDiffDisplayLimit(options.expanded, live.editDiffCollapsedLines);
 			const processBudget = resolveDiffProcessBudget(displayLimit, wordWrap);

package/extensions/renderer/tool/diff/diff-presentation.ts

@@ -1,5 +1,6 @@
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { pluralize } from "./diff-text.ts";
+import type { DiffTheme } from "./diff-palette.ts";
 import type { ToolDisplayConfig } from "../../../config/config.ts";
 
 export interface DiffSummaryStats {
@@ -68,3 +69,43 @@ export function buildDiffSummaryText(stats: DiffSummaryStats, width: number): st
 
 	return truncateToWidth(summaryCandidates[summaryCandidates.length - 1] ?? "", safeWidth, "");
 }
+
+/**
+ * 折叠摘要行样式：整行 muted，`+A -D` 用 diff 头行同一套绿/红，hover 只把动作词提到 text。
+ * 0 行预览与多行预览共用这一套颜色：改折叠行数时同一处信息不变色。
+ */
+export function styleDiffSummaryLine(
+	text: string,
+	stats: Pick<DiffSummaryStats, "added" | "removed"> | undefined,
+	hint: string,
+	theme: DiffTheme,
+	hovered: boolean,
+): string {
+	const counts = stats ? `+${stats.added} -${stats.removed}` : "";
+	const countsIndex = counts ? text.indexOf(counts) : -1;
+	const hintIndex = hint ? text.lastIndexOf(hint) : -1;
+	if (countsIndex < 0 && hintIndex < 0) {
+		return theme.fg("muted", text);
+	}
+
+	const pieces: string[] = [];
+	let cursor = 0;
+	const pushMuted = (end: number) => {
+		const gap = text.slice(cursor, end);
+		if (gap) pieces.push(theme.fg("muted", gap));
+	};
+	if (countsIndex >= 0 && stats) {
+		pushMuted(countsIndex);
+		pieces.push(theme.fg("toolDiffAdded", `+${stats.added}`));
+		pieces.push(theme.fg("muted", " "));
+		pieces.push(theme.fg("toolDiffRemoved", `-${stats.removed}`));
+		cursor = countsIndex + counts.length;
+	}
+	if (hintIndex >= cursor) {
+		pushMuted(hintIndex);
+		pieces.push(theme.fg(hovered ? "text" : "muted", hint));
+		cursor = hintIndex + hint.length;
+	}
+	pushMuted(text.length);
+	return pieces.join("");
+}

package/extensions/renderer/tool/diff/diff-renderer.ts

@@ -20,4 +20,8 @@ export { shouldHighlightCodeBlock } from "./diff-highlight.ts";
 export type { DisplayConfigInput } from "./diff-component.ts";
 export { isRichDiffComponent } from "./diff-component.ts";
 export { countEditDiffStats, renderEditDiffResult } from "./diff-edit-render.ts";
-export { countWriteDiffStats, renderWriteDiffResult } from "./diff-write-render.ts";
+export {
+	countWriteDiffStats,
+	renderWriteDiffResult,
+	writeStatsInCollapsedBody,
+} from "./diff-write-render.ts";

package/extensions/renderer/tool/diff/diff-write-render.ts

@@ -1,4 +1,5 @@
 import { Text, truncateToWidth, visibleWidth, type Component } from "@earendil-works/pi-tui";
+import type { ToolDisplayConfig } from "../../../config/config.ts";
 import { sanitizeToolResultText } from "../../../utils/tool-result-sanitize.ts";
 import { showMoreHintText } from "../show-more-hint.ts";
 import { splitWriteContentLines } from "./diff-text.ts";
@@ -54,6 +55,7 @@ import {
 	buildDiffSummaryText,
 	normalizeDiffRenderWidth,
 	resolveDiffPresentationMode,
+	styleDiffSummaryLine,
 	type DiffPresentationMode,
 } from "./diff-presentation.ts";
 
@@ -290,13 +292,14 @@ function renderWriteOverwriteGuardRows(
 	return renderSingleDiffRow(buildWriteOverwriteGuardText(guard, width), "warning", width, theme);
 }
 
-/** Folded write with `writeDiffCollapsedLines: 0`: `↳ created · click to show more`. */
+/** Folded write with `writeDiffCollapsedLines: 0`: `↳ diff +A -D · created · click to show more`. */
 function renderWriteCollapsedHintLine(
 	wasOverwrite: boolean,
 	width: number,
 	theme: DiffTheme,
 	hovered: boolean,
 	headerLabel?: string,
+	stats?: { added: number; removed: number },
 ): string[] {
 	const safeWidth = normalizeDiffRenderWidth(width);
 	if (safeWidth === 0) {
@@ -304,7 +307,20 @@ function renderWriteCollapsedHintLine(
 	}
 	const actionLabel = headerLabel?.trim() || (wasOverwrite ? "overwritten" : "created");
 	const clickLabel = showMoreHintText();
-	const candidates = [`↳ ${actionLabel} · ${clickLabel}`, `↳ ${actionLabel}`, actionLabel, "…"];
+	const counts = stats ? `+${stats.added} -${stats.removed}` : "";
+	const candidates = stats
+		? [
+				`↳ diff ${counts} · ${actionLabel} · ${clickLabel}`,
+				`↳ diff ${counts} · ${clickLabel}`,
+				`↳ diff ${counts} · ${actionLabel}`,
+				`↳ diff ${counts}`,
+				`↳ ${counts} · ${clickLabel}`,
+				`↳ ${actionLabel} · ${clickLabel}`,
+				`↳ ${actionLabel}`,
+				actionLabel,
+				"…",
+			]
+		: [`↳ ${actionLabel} · ${clickLabel}`, `↳ ${actionLabel}`, actionLabel, "…"];
 	let text = candidates[candidates.length - 1] ?? "…";
 	for (const candidate of candidates) {
 		if (visibleWidth(candidate) <= safeWidth) {
@@ -315,16 +331,21 @@ function renderWriteCollapsedHintLine(
 	if (visibleWidth(text) > safeWidth) {
 		text = truncateToWidth(text, safeWidth, "");
 	}
-	const clickIndex = text.lastIndexOf(clickLabel);
-	const styled =
-		hovered && clickIndex >= 0
-			? theme.fg("muted", text.slice(0, clickIndex)) +
-				theme.fg("text", clickLabel) +
-				theme.fg("muted", text.slice(clickIndex + clickLabel.length))
-			: theme.fg("muted", text);
+	const styled = styleDiffSummaryLine(text, stats, clickLabel, theme, hovered);
 	return [clampDiffLineToWidth(styled, safeWidth)];
 }
 
+/**
+ * 折叠 0 行预览时计数由正文那行显示（`↳ diff +A -D · created · click to show more`），
+ * 标题不再重复。compact 与 default 两个模式的写标题共用这条口径。
+ */
+export function writeStatsInCollapsedBody(
+	expanded: boolean,
+	display: Pick<ToolDisplayConfig, "writeDiffCollapsedLines">,
+): boolean {
+	return !expanded && resolveWriteCollapsedLimit(display) === 0;
+}
+
 /**
  * write 变更行统计（compact 单行用）：复用当前 write diff 算法。
  * 新文件 = 全部新内容为 added；覆盖已有文件用 LCS 精确统计。
@@ -413,6 +434,10 @@ export function renderWriteDiffResult(
 			const hint = cache.getHintLine();
 			return hint !== undefined && normalizeCollapsedHintLine(plainLine) === hint;
 		},
+		/** 折叠 0 行预览时正文那行自带 +A -D：标题不再重复计数。 */
+		bodyShowsStats(): boolean {
+			return writeStatsInCollapsedBody(options.expanded, resolveLiveDisplayConfig(config));
+		},
 		render(width: number): string[] {
 			// Live config: panel can change indicator/wrap/limits after this component is created.
 			const live = resolveLiveDisplayConfig(config);
@@ -445,6 +470,7 @@ export function renderWriteDiffResult(
 					theme,
 					hovered,
 					options.headerLabel,
+					countWriteDiffStats(content, options.previousContent, options.fileExistedBeforeWrite),
 				);
 				return cache.set(
 					safeWidth,

package/extensions/renderer/tool/grouping.ts

@@ -8,6 +8,12 @@ import {
 } from "@earendil-works/pi-tui";
 import { config } from "../../config/config.ts";
 import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../../utils/tool-loading-icon.ts";
+import {
+	ASK_USER_QUESTION_TOOL_NAME,
+	askUserAnswerText,
+	askUserAnswers,
+	type AskUserAnswer,
+} from "./ask-user-question.ts";
 import {
 	CODEMODE_TOOL_NAME,
 	codemodeCalls,
@@ -23,10 +29,18 @@ import {
 	fitToolCallSummary,
 	humanizeToolLabel,
 	renderToolSummary,
+	SHELL_TOOL_NAMES,
 	toolCallSummary,
 	type ToolCallSummary,
 } from "./names.ts";
-import { toolViewportWidth } from "./result.ts";
+import {
+	collapsedResultSummary,
+	formatToolDuration,
+	headTruncateToWidth,
+	isLiveToolCall,
+	textFromResult,
+	toolViewportWidth,
+} from "./result.ts";
 import {
 	patchRegistry,
 	TOOL_GROUPING_GENERATION_KEY as GENERATION_KEY,
@@ -108,6 +122,12 @@ function statusIcon(value: ToolStatus): string {
 	return toolLoadingIcon();
 }
 
+/** 等待窗口或运行中的行：spinner 逐帧变化，分组卡要跟着跳帧。 */
+function isAnimatingTool(tool: any): boolean {
+	if (status(tool) !== "pending") return false;
+	return Boolean(tool?.executionStarted) || isLiveToolCall(tool?.toolCallId);
+}
+
 function scheduleGroupAnimation(patch: Patch): void {
 	if (patch.animationTimer || !patch.active) return;
 	patch.animationTimer = setTimeout(() => {
@@ -115,11 +135,7 @@ function scheduleGroupAnimation(patch: Patch): void {
 		if (!patch.active) return;
 		let needsRender = false;
 		for (const group of patch.groups) {
-			if (
-				(group.children as any[]).some(
-					(tool) => tool?.executionStarted && status(tool) === "pending",
-				)
-			) {
+			if ((group.children as any[]).some(isAnimatingTool)) {
 				group.invalidate();
 				// 分组卡不是 ToolExecutionComponent：它的 invalidate() 不会请求渲染，
 				// 不补这一步 spinner 只在别人渲染时才跳帧（并行工具下表现为卡顿/冻结）。
@@ -203,6 +219,39 @@ function toolSummary(tool: any): ToolCallSummary {
  * codemode 的折叠行：有结果就报该次调用的统计（与单卡汇总行同一套口径），
  * 免得一张卡里几行长代码预览互相看不出区别。还没结果时退回代码预览。
  */
+/**
+ * ask_user_question 的折叠行：有结果就报「问题 -> 回答」，
+ * 多题压成一行并标注剩余条数。还没结果时退回问题预览。
+ */
+function askUserResultSummary(tool: any): ToolCallSummary | undefined {
+	if (toolName(tool) !== ASK_USER_QUESTION_TOOL_NAME || !tool?.result) return undefined;
+	const answers = askUserAnswers(tool.result)
+		.map((answer: AskUserAnswer, index: number) => ({ answer, index }))
+		.sort((left, right) => {
+			const leftIndex = Number(left.answer.questionIndex);
+			const rightIndex = Number(right.answer.questionIndex);
+			const leftMissing = !Number.isFinite(leftIndex);
+			const rightMissing = !Number.isFinite(rightIndex);
+			if (leftMissing || rightMissing) {
+				if (leftMissing !== rightMissing) return leftMissing ? 1 : -1;
+				return left.index - right.index;
+			}
+			return leftIndex - rightIndex;
+		})
+		.map((entry) => entry.answer);
+	if (answers.length === 0) {
+		const label = tool.result?.details?.cancelled === true ? "Declined" : "Done";
+		return { main: `${toolTitle(tool)} ${label}`, detail: "" };
+	}
+	const first = answers[0]!;
+	const question = String(first.question ?? "").trim() || "Question";
+	const more = answers.length > 1 ? ` (+${answers.length - 1})` : "";
+	return {
+		main: `${toolTitle(tool)} ${question} -> ${askUserAnswerText(first)}${more}`,
+		detail: "",
+	};
+}
+
 function codemodeResultSummary(tool: any): ToolCallSummary | undefined {
 	if (toolName(tool) !== CODEMODE_TOOL_NAME || !tool?.result) return undefined;
 	const parts = codemodeSummaryParts(
@@ -213,10 +262,47 @@ function codemodeResultSummary(tool: any): ToolCallSummary | undefined {
 	return { main: `${toolTitle(tool)} ${parts.join(" · ")}`, detail: "" };
 }
 
+/**
+ * 组内 shell 行的尾巴：只报耗时（`· 12.4s`）。行数是冗余信息，展开就能看到；
+ * 失败另报错误首行，那条不该只在展开后可见。
+ * 耗时取 pi 记在结果上的 durationMs（单卡渲染上下文里的同一个值），运行中还拿不到就不报。
+ */
+function shellResultTail(
+	tool: any,
+	fg: (color: string, text: string) => string,
+	toolStatus: ToolStatus,
+): string {
+	if (!SHELL_TOOL_NAMES.has(toolName(tool)) || toolStatus === "pending" || !tool?.result) return "";
+	const isError = tool.result?.isError === true;
+	// 失败报错误首行（不该只在展开后可见）；成功只报耗时，行数是冗余信息。
+	const failure = isError
+		? collapsedResultSummary({
+				result: tool.result,
+				toolName: toolName(tool),
+				text: textFromResult(tool.result),
+				isError: true,
+			})
+		: "";
+	const durationMs = tool.result?.durationMs;
+	const duration =
+		typeof durationMs === "number" && Number.isFinite(durationMs) && durationMs >= 0
+			? formatToolDuration(durationMs)
+			: "";
+	const tail = [failure, duration].filter(Boolean).join(" · ");
+	return tail ? ` ${fg("dim", `· ${tail}`)}` : "";
+}
+
+/**
+ * 组头的工具列表：名称用与单组标题、子行同一套人性化写法，次数一律带上（各跑一次也报 ×1）。
+ * 同名（同显示标题）的合并成一项，避免 `MCP call×1, MCP call×1` 这种重复。
+ */
 function toolNameList(tools: any[]): string {
 	const counts = new Map<string, number>();
-	for (const tool of tools) counts.set(toolName(tool), (counts.get(toolName(tool)) ?? 0) + 1);
-	return [...counts].map(([name, count]) => `${name}${count > 1 ? `×${count}` : ""}`).join(", ");
+	for (const tool of tools) {
+		const label = toolTitle(tool);
+		counts.set(label, (counts.get(label) ?? 0) + 1);
+	}
+	return [...counts].map(([label, count]) => `${label}×${count}`).join(", ");
 }
 
 let nextGroupId = 1;
@@ -389,23 +475,23 @@ export class ToolGroupComponent extends Container {
 		const names = new Set(this.children.map(toolName));
 		const label = names.size === 1 ? toolTitle(this.children[0]) : "Multiple Tools";
 		const overall: ToolStatus = counts.error ? "error" : counts.pending ? "pending" : "success";
-		if (
-			(this.children as any[]).some((tool) => tool?.executionStarted && status(tool) === "pending")
-		)
-			scheduleGroupAnimation(this.patch);
+		if ((this.children as any[]).some(isAnimatingTool)) scheduleGroupAnimation(this.patch);
 		const overallColor = overall === "pending" ? "accent" : overall;
-		const nameList = names.size > 1 ? ` ${fg("dim", `· ${toolNameList(this.children)}`)}` : "";
 		// 圆点保持 dim；hover 只高亮可点击文字。
 		const hintText = this._expanded ? collapseHintText() : showMoreHintText();
 		const hint = `${fg("dim", "·")} ${fg(this.hintHovered ? "text" : "dim", hintText)}`;
-		const lines = [
-			"",
-			truncateToWidth(
-				` ${fg(overallColor, "●")} ${label}: ${countText}${nameList} ${hint}`,
-				toolViewportWidth(width),
-				"…",
-			),
-		];
+		const rowWidth = toolViewportWidth(width);
+		// 工具列表让位给展开提示：提示被截断的话，鼠标层要在行尾找 `click to show more`
+		// 就找不到，整张卡在窄宽度下点不开。名字截断后子行里仍能看全。
+		const head = ` ${fg(overallColor, "●")} ${label}: ${countText}`;
+		const tail = ` ${hint}`;
+		const listRoom = rowWidth - visibleWidth(head) - visibleWidth(tail) - 3;
+		// 连一个工具名都放不下就不放列表：退化成 `· …` 只会把行撑爆。
+		const nameList =
+			names.size > 1 && listRoom >= 4
+				? ` ${fg("dim", `· ${headTruncateToWidth(toolNameList(this.children), listRoom)}`)}`
+				: "";
+		const lines = ["", truncateToWidth(`${head}${nameList}${tail}`, rowWidth, "")];
 		const total = this.children.length;
 		const childPaints = this._expanded
 			? (this.children as any[]).map((tool) => tool.render?.(Math.max(1, width - 2)))
@@ -433,15 +519,20 @@ export class ToolGroupComponent extends Container {
 			const branch = index === total - 1 ? "└" : "├";
 			const continuation = index === total - 1 ? "  " : "│ ";
 			if (!this._expanded) {
-				const summary = codemodeResultSummary(tool) ?? toolSummary(tool);
+				const summary =
+					askUserResultSummary(tool) ?? codemodeResultSummary(tool) ?? toolSummary(tool);
 				const prefix = ` ${fg("dim", branch)} ${fg(color, statusIcon(toolStatus))} `;
 				const detail = fg("dim", summary.detail);
+				const result = shellResultTail(tool, fg, toolStatus);
 				// 与单工具卡标题同宽，宽屏右侧留白一致
 				const rowWidth = toolViewportWidth(width);
-				const mainWidth = Math.max(0, rowWidth - visibleWidth(prefix) - visibleWidth(detail));
+				const mainWidth = Math.max(
+					0,
+					rowWidth - visibleWidth(prefix) - visibleWidth(detail) - visibleWidth(result),
+				);
 				lines.push(
 					truncateToWidth(
-						`${prefix}${renderToolSummary(summary, mainWidth, fg)}${detail}`,
+						`${prefix}${renderToolSummary(summary, mainWidth, fg)}${detail}${result}`,
 						rowWidth,
 						"",
 					),

package/extensions/renderer/tool/names.ts

@@ -5,9 +5,9 @@ import { config } from "../../config/config.ts";
 import { oneLine } from "../../utils/format.ts";
 import { headTruncateToWidth } from "./result.ts";
 
-/** inputClip=0 时不设字符上限，交给渲染时的实际宽度截断。 */
+/** toolLabelClip=0 时不设字符上限，交给渲染时的实际宽度截断。 */
 function clipLimit(): number {
-	return config.inputClip > 0 ? config.inputClip : Number.POSITIVE_INFINITY;
+	return config.toolLabelClip > 0 ? config.toolLabelClip : Number.POSITIVE_INFINITY;
 }
 
 function clip(value: unknown): string {
@@ -157,7 +157,7 @@ function pathSummary(
 }
 
 /** 入参是 shell 命令的工具。 */
-const SHELL_TOOL_NAMES = new Set(["bash", "powershell", "pwsh", "sh", "zsh", "cmd"]);
+export const SHELL_TOOL_NAMES = new Set(["bash", "powershell", "pwsh", "sh", "zsh", "cmd"]);
 
 /** 内置检索工具：pattern 缺失（无效调用）时保留 "…" 占位。 */
 const SEARCH_TOOL_NAMES = new Set(["grep", "find"]);