pi-cc-extensions 0.8.49 → 0.8.50

package/extensions/feature/agent-summary.ts

@@ -0,0 +1,34 @@
+/**
+ * Agent 回合摘要展示：agent_end 时把本回合工具统计写入会话条目，
+ * 由 entry renderer 渲染为 markdown 引用块 `> [!TIP] *斜体内容*`。
+ *
+ * 统计复用 utils/agent-summary.ts（口径同旧 compact-style，ea64df0 删除）。
+ * appendEntry 不进 LLM 上下文，只显示在聊天区。
+ * 引用块文字色取主题 mdQuote（cc 主题下为 muted 灰），内容用 *斜体* 语法。
+ */
+
+import { Markdown } from "@earendil-works/pi-tui";
+import { getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import {
+	bindAgentSummary,
+	summaryMarkdown,
+	type AgentSummaryData,
+} from "../utils/agent-summary.ts";
+
+export const AGENT_SUMMARY_ENTRY_TYPE = "agent-summary";
+
+export default function (pi: ExtensionAPI): void {
+	pi.registerEntryRenderer<AgentSummaryData>(
+		AGENT_SUMMARY_ENTRY_TYPE,
+		(entry, _options, _theme) => {
+			const line = summaryMarkdown(entry.data, true);
+			if (!line) return undefined;
+			return new Markdown(line, 1, 0, getMarkdownTheme());
+		},
+	);
+
+	bindAgentSummary(pi, (data) => {
+		pi.appendEntry(AGENT_SUMMARY_ENTRY_TYPE, data);
+	});
+}

package/extensions/index.ts

@@ -1,7 +1,11 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import agentAutocomplete from "./feature/agent-autocomplete.ts";
+import agentSummary from "./feature/agent-summary.ts";
 import claudeCodeStyle, { getCompactThinkingConfig } from "./renderer/index.ts";
-import { installCompactThinking, type CompactThinkingController } from "./feature/compact-thinking.ts";
+import {
+	installCompactThinking,
+	type CompactThinkingController,
+} from "./feature/compact-thinking.ts";
 import context from "./feature/context.ts";
 import markdownEnhance from "./feature/markdown-enhance.ts";
 import piAliases from "./feature/pi-aliases.ts";
@@ -25,4 +29,5 @@ export default function (pi: ExtensionAPI): void {
 	context(pi);
 	sessionReference(pi);
 	agentAutocomplete(pi);
+	agentSummary(pi);
 }

package/extensions/renderer/index.ts

@@ -32,6 +32,7 @@ import {
 	clearAllAnimations,
 	countLines,
 	hasExpandableDetail,
+	headTruncateToWidth,
 	isToolExpanded,
 	middleTruncateToWidth,
 	oneLine,
@@ -53,6 +54,12 @@ import {
 	renderRichToolResult,
 	WriteExecutionMetadataStore,
 } from "./tool-diff/index.ts";
+import {
+	getMessageDisplayTheme,
+	installMessageDisplayRendering,
+	refreshMessageDisplays,
+	setMessageDisplayTheme,
+} from "./message-display.ts";
 
 /**
  * Claude Code Style for pi — 装配入口（拆分后位于 ccstyle/index.ts）。
@@ -66,6 +73,7 @@ const ANSI_FG_RESET = "\x1b[39m";
 
 function refreshCurrentTranscript(ctx?: any, toolGrouping?: ToolGroupingHooks): void {
 	toolGrouping?.refresh(toolMouseTui);
+	refreshMessageDisplays(toolMouseTui);
 	toolMouseTui?.requestRender?.(true);
 	ctx?.ui?.requestRender?.(true);
 }
@@ -133,10 +141,11 @@ function singleToolCallSummary(
 	const name = toolName.toLowerCase();
 	const value = (fallback: string, ...keys: string[]) => {
 		const found = keys.map((key) => args[key]).find((item) => typeof item === "string" && item);
-		return `${title} ${oneLine(found || fallback, Infinity)}`;
+		// 与多 tool 摘要对齐：从头截断，上限 96 字符（tool-grouping oneLine 默认值）。
+		return `${title} ${oneLine(found || fallback, 96)}`;
 	};
 	if (AGENT_FAMILY_TOOL_NAMES.has(toolName) && args.agent_id) {
-		return { main: `${title} ${oneLine(args.agent_id, Infinity)}`, detail: "" };
+		return { main: `${title} ${oneLine(args.agent_id, 96)}`, detail: "" };
 	}
 	// Agents still uses the ccstyle wrapper; Agent keeps its dedicated renderer.
 	if (name === "agents") {
@@ -177,7 +186,7 @@ function singleToolCallSummary(
 			args.limit !== undefined ? `limit=${args.limit}` : "",
 		].filter(Boolean);
 		return {
-			main: `${title}${args.path ? ` ${oneLine(args.path, Infinity)}` : ""}`,
+			main: `${title}${args.path ? ` ${oneLine(args.path, 96)}` : ""}`,
 			detail: details.length ? ` (${details.join(", ")})` : "",
 		};
 	}
@@ -197,7 +206,7 @@ function singleToolCallSummary(
 	return {
 		main:
 			preferred !== undefined && preferred !== null && typeof preferred !== "object"
-				? `${title} ${oneLine(preferred, Infinity)}`
+				? `${title} ${oneLine(preferred, 96)}`
 				: title,
 		detail: "",
 	};
@@ -317,7 +326,8 @@ function createCcstyleTool(
 					const callWidth = Math.max(0, viewportWidth - visibleWidth(icon) - 2);
 					const mainWidth = Math.max(0, callWidth - visibleWidth(summary.detail));
 					cachedWidth = width;
-					cachedLine = ` ${icon} ${theme.fg("toolTitle", middleTruncateToWidth(summary.main, mainWidth))}${theme.fg("dim", summary.detail)}`;
+					// 纯文本先截断再着色（省略号不带 ANSI，避免 reset 破坏卡片背景）；从头截断，与多 tool 一致
+					cachedLine = ` ${icon} ${theme.fg("toolTitle", headTruncateToWidth(summary.main, mainWidth))}${theme.fg("dim", summary.detail)}`;
 					return [truncateToWidth(cachedLine, viewportWidth, "")];
 				},
 				invalidate() {},
@@ -738,6 +748,50 @@ function deactivateGlobalToolRendering(patch: GlobalToolRenderPatch): void {
 
 const GLOBAL_COMPACTION_RENDER_PATCH = Symbol.for("pi.ccstyle.compaction-render-patch");
 
+const TOOL_EXPANDED_BACKGROUND_PATCH = Symbol.for("pi.ccstyle.tool-expanded-background-patch");
+
+type ToolExpandedBackgroundPatch = {
+	active: boolean;
+	prototype: any;
+	installed: (...args: any[]) => void;
+	original: (...args: any[]) => void;
+	dispose: () => void;
+};
+
+/** 展开面板背景统一为 user message 背景色；折叠行保持原生状态色（由 original 重设）。 */
+function installToolExpandedBackground(): () => void {
+	const host = globalThis as any;
+	const previous = host[TOOL_EXPANDED_BACKGROUND_PATCH] as ToolExpandedBackgroundPatch | undefined;
+	if (previous) previous.dispose();
+	const prototype = ToolExecutionComponent.prototype;
+	const original = prototype.updateDisplay;
+	const patch: ToolExpandedBackgroundPatch = {
+		active: true,
+		prototype,
+		installed: function (this: any) {
+			original.call(this);
+			if (!patch.active || config.mode !== "on" || !this.expanded) return;
+			const theme = getMessageDisplayTheme();
+			if (!theme?.bg) return;
+			const box = this.contentBox;
+			if (box?.setBgFn) box.setBgFn((text: string) => theme.bg("userMessageBg", text));
+		},
+		original,
+		dispose: () => {
+			patch.active = false;
+			if (prototype.updateDisplay === patch.installed) {
+				prototype.updateDisplay = original;
+			}
+			if (host[TOOL_EXPANDED_BACKGROUND_PATCH] === patch) {
+				delete host[TOOL_EXPANDED_BACKGROUND_PATCH];
+			}
+		},
+	};
+	prototype.updateDisplay = patch.installed;
+	host[TOOL_EXPANDED_BACKGROUND_PATCH] = patch;
+	return patch.dispose;
+}
+
 type LegacyCompactionRenderPatch = {
 	enabled?: () => boolean;
 };
@@ -763,6 +817,8 @@ export default function (
 		| {
 				globalToolRendering: GlobalToolRenderPatch;
 				toolGrouping: ToolGroupingHooks;
+				disposeMessageDisplay: () => void;
+				disposeToolExpandedBackground: () => void;
 		  }
 		| undefined;
 	const ensureTuiInstallation = (ctx: any) => {
@@ -772,8 +828,15 @@ export default function (
 		if (installation) return installation;
 		const globalToolRendering = installGlobalToolRendering(writeExecutionMetadata);
 		const toolGrouping = installToolGrouping(() => config.mode === "on");
+		const disposeMessageDisplay = installMessageDisplayRendering();
+		const disposeToolExpandedBackground = installToolExpandedBackground();
 		deactivateLegacyCompactionRendering();
-		installation = { globalToolRendering, toolGrouping };
+		installation = {
+			globalToolRendering,
+			toolGrouping,
+			disposeMessageDisplay,
+			disposeToolExpandedBackground,
+		};
 		return installation;
 	};
 
@@ -828,6 +891,7 @@ export default function (
 		if (ctx?.mode === "tui" && ctx?.hasUI) installToolMouseInteraction(ctx, mouseOwner);
 		if (!hooks) return;
 		hooks.toolGrouping.setTheme(ctx.ui.theme);
+		setMessageDisplayTheme(ctx.ui.theme);
 		ctx.ui.setStatus("ccstyle", undefined);
 		scheduleSessionRender(() => hooks.toolGrouping.refresh(toolMouseTui));
 	});
@@ -839,6 +903,7 @@ export default function (
 		if (ctx?.mode === "tui" && ctx?.hasUI) installToolMouseInteraction(ctx, mouseOwner);
 		if (!hooks) return;
 		hooks.toolGrouping.setTheme(ctx.ui.theme);
+		setMessageDisplayTheme(ctx.ui.theme);
 		scheduleSessionRender(() => hooks.toolGrouping.refresh(toolMouseTui));
 	});
 
@@ -860,6 +925,8 @@ export default function (
 			return;
 		deactivateGlobalToolRendering(current.globalToolRendering);
 		current.toolGrouping.shutdown();
+		current.disposeMessageDisplay();
+		current.disposeToolExpandedBackground();
 		deactivateLegacyCompactionRendering();
 		clearAllAnimations();
 		installation = undefined;
@@ -880,6 +947,7 @@ export {
 	ExpandedToolResultText,
 	formatExpandHint,
 	formatToolInputArgs,
+	headTruncateToWidth,
 	middleTruncateToWidth,
 	outputLineCount,
 	renderCollapsedToolResult,

package/extensions/renderer/message-display.ts

@@ -0,0 +1,163 @@
+import {
+	BranchSummaryMessageComponent,
+	CompactionSummaryMessageComponent,
+	SkillInvocationMessageComponent,
+} from "@earendil-works/pi-coding-agent";
+import { Markdown, Spacer, Text } from "@earendil-works/pi-tui";
+import { config } from "../config/config.ts";
+import { showMoreHintText } from "./show-more-hint.ts";
+
+/**
+ * 接管三个消息组件（`<skill>` 块、压缩摘要、分支摘要），ccstyle on 时渲染为
+ * 与工具调用一致的单行风格（● Title · hint），off 时回退原生。
+ *
+ * 三者结构同构：Box + markdownTheme + updateDisplay，构造/setExpanded/invalidate
+ * 三条路径都经过 updateDisplay，patch 一处即可全覆盖。它们不走
+ * ToolExecutionComponent，无法复用其原型 patch，这里单独统一管理。
+ */
+
+const MESSAGE_DISPLAY_PATCH = Symbol.for("pi.ccstyle.message-display-patch");
+
+// 与 renderer/index.ts renderCall 的成功勾一致：亮绿 ✓（truecolor ANSI）。
+const BRIGHT_GREEN = "\x1b[38;2;80;220;100m";
+const ANSI_FG_RESET = "\x1b[39m";
+
+/** 事件上下文中同步的最新主题（与 toolGrouping.setTheme 同一来源）。 */
+let displayTheme: any;
+
+export function setMessageDisplayTheme(theme: any): void {
+	displayTheme = theme;
+}
+
+/** 供工具展开面板背景等共享同一主题来源（ctx.ui.theme）。 */
+export function getMessageDisplayTheme(): any {
+	return displayTheme;
+}
+
+type DisplayKind = {
+	title(component: any): string;
+	body(component: any): string;
+};
+
+const SKILL_KIND: DisplayKind = {
+	title: (component) => `Skill ${String(component.skillBlock?.name ?? "skill")}`,
+	body: (component) => String(component.skillBlock?.content ?? ""),
+};
+
+const COMPACTION_KIND: DisplayKind = {
+	title: (component) => `Compacted from ${Number(component.message?.tokensBefore ?? 0).toLocaleString()} tokens`,
+	body: (component) => String(component.message?.summary ?? ""),
+};
+
+const BRANCH_KIND: DisplayKind = {
+	title: () => "Branch summary",
+	body: (component) => String(component.message?.summary ?? ""),
+};
+
+function renderCcstyle(component: any, kind: DisplayKind): void {
+	const theme = displayTheme;
+	if (!theme) return; // 主题未就绪时保留原生渲染
+	if (component.bgFn) component.setBgFn?.(undefined); // 与工具调用一致，去掉灰底
+	component.clear();
+	const icon = `${BRIGHT_GREEN}✓${ANSI_FG_RESET}`; // 已完成消息，等同工具成功态
+	const title = theme.fg("toolTitle", kind.title(component));
+	if (!component.expanded) {
+		const hint = theme.fg("dim", ` • ${showMoreHintText()}`);
+		component.addChild(new Text(`${icon} ${title}${hint}`, 0, 0));
+		return;
+	}
+	component.addChild(new Text(`${icon} ${title}`, 0, 0));
+	component.addChild(new Spacer(1));
+	component.addChild(
+		new Markdown(kind.body(component), 0, 0, component.markdownTheme, {
+			color: (text: string) => theme.fg("customMessageText", text),
+		}),
+	);
+}
+
+type PatchEntry = { prototype: any; installed: (...args: any[]) => void; original: (...args: any[]) => void };
+
+/** patch 三个消息组件的 updateDisplay，返回统一 dispose（/reload 链安全）。 */
+export function installMessageDisplayRendering(): () => void {
+	const host = globalThis as any;
+	const previous = host[MESSAGE_DISPLAY_PATCH];
+	if (previous) previous.dispose();
+	const patch: { active: boolean; entries: PatchEntry[]; dispose: () => void } = {
+		active: true,
+		entries: [],
+		dispose: () => {},
+	};
+	const installOne = (ComponentClass: any, kind: DisplayKind): void => {
+		const prototype = ComponentClass.prototype;
+		const original = prototype.updateDisplay;
+		const installed = function (this: any) {
+			if (patch.active && config.mode === "on") {
+				try {
+					renderCcstyle(this, kind);
+					return;
+				} catch {
+					// 渲染失败回退原生
+				}
+			}
+			original.call(this);
+		};
+		prototype.updateDisplay = installed;
+		patch.entries.push({ prototype, installed, original });
+	};
+	installOne(SkillInvocationMessageComponent, SKILL_KIND);
+	installOne(CompactionSummaryMessageComponent, COMPACTION_KIND);
+	installOne(BranchSummaryMessageComponent, BRANCH_KIND);
+	patch.dispose = () => {
+		patch.active = false;
+		for (const entry of patch.entries) {
+			if (entry.prototype.updateDisplay === entry.installed) {
+				entry.prototype.updateDisplay = entry.original;
+			}
+		}
+		if (host[MESSAGE_DISPLAY_PATCH] === patch) delete host[MESSAGE_DISPLAY_PATCH];
+	};
+	host[MESSAGE_DISPLAY_PATCH] = patch;
+	return patch.dispose;
+}
+
+/** 三个消息组件共享的结构特征；CustomMessageComponent 用 rebuild 无 updateDisplay，不命中。 */
+function isMessageDisplayComponent(value: any): boolean {
+	return Boolean(
+		value &&
+			typeof value === "object" &&
+			typeof value.markdownTheme === "object" &&
+			typeof value.setExpanded === "function" &&
+			typeof value.updateDisplay === "function" &&
+			typeof value.clear === "function",
+	);
+}
+
+/** 遍历当前 transcript，让已挂载的消息组件按当前 mode 重渲染（/ccstyle on|off 切换）。 */
+export function refreshMessageDisplays(root: any): void {
+	const seen = new Set<any>();
+	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;
+		}
+		if (isMessageDisplayComponent(value)) {
+			value.invalidate?.();
+			return;
+		}
+		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(root);
+}

package/extensions/renderer/tool-grouping.ts

@@ -387,12 +387,8 @@ export class ToolGroupComponent extends Container {
 			}
 		}
 		if (this._expanded) {
-			const backgroundSlot =
-				overall === "error"
-					? "toolErrorBg"
-					: overall === "pending"
-						? "toolPendingBg"
-						: "toolSuccessBg";
+			// 展开面板统一用 user message 背景色（ccstyle 约定），不按状态区分。
+			const backgroundSlot = "userMessageBg";
 			for (const line of expandedLines) {
 				lines.push(paddedBackgroundRow(theme, backgroundSlot, line, width));
 			}

package/extensions/renderer/tool-result.ts

@@ -520,6 +520,18 @@ export function renderCollapsedToolResultToWidth(
 	);
 }
 
+/** 从头截断到宽度（保留开头、省略尾部），不插入 ANSI reset（背景卡片下安全）。 */
+export function headTruncateToWidth(text: string, width: number): string {
+	if (visibleWidth(text) <= width) return text;
+	if (width <= 1) return "…";
+	let left = "";
+	for (const char of Array.from(text)) {
+		if (visibleWidth(left + "…" + char) > width) break;
+		left += char;
+	}
+	return `${left}…`;
+}
+
 /** 截断到宽度时保留首尾内容（渲染折叠行与工具标题用）。 */
 export function middleTruncateToWidth(text: string, width: number): string {
 	if (visibleWidth(text) <= width) return text;

package/extensions/utils/agent-summary.ts

@@ -0,0 +1,175 @@
+/**
+ * Agent 回合摘要：统计一次 agent 运行的工具使用并格式化成摘要文本。
+ *
+ * 统计口径参考已删除的 compact-style（ea64df0 "sunset fixed-editor and compact
+ * mode"）：read 按文件去重、edit/write 按文件去重、bash 计命令数、其余工具计数、
+ * 失败计数、回合耗时。与旧实现一致，`read`/`edit`/`write` 只认精确的工具名
+ * （MCP 风格 `server__read` 归入 other）。
+ *
+ * 呈现：`summaryLine` 输出纯文本（旧格式），`summaryMarkdown` 输出 Markdown
+ * 增强版——加粗统计词，box 模式包 `> [!TIP]` 提示框（由 markdown-enhance 渲染
+ * 成带图标的表格框），供当前 Markdown 渲染管线使用。
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+/** 工具分类，与旧 compact-style 统计口径一致。 */
+export type AgentToolCategory = "read" | "edit" | "bash" | "other";
+
+/** 一次 agent 回合的统计快照。 */
+export type AgentSummaryData = {
+	reads: number;
+	edits: number;
+	commands: number;
+	others: number;
+	failed: number;
+	durationMs: number;
+};
+
+export function classifyTool(toolName: string): AgentToolCategory {
+	const base = toolName.split(".").pop() ?? toolName;
+	if (base === "read") return "read";
+	if (base === "edit" || base === "write") return "edit";
+	if (base === "bash") return "bash";
+	return "other";
+}
+
+function nonEmptyString(value: unknown): value is string {
+	return typeof value === "string" && value.length > 0;
+}
+
+/** 累积一次 agent 回合的工具统计；agent_start 时新建实例。 */
+export class AgentRunSummary {
+	toolCount = 0;
+	readFiles = new Set<string>();
+	editFiles = new Set<string>();
+	commandCount = 0;
+	otherCount = 0;
+	failedCount = 0;
+
+	readonly startedAt: number;
+
+	constructor(startedAt = Date.now()) {
+		this.startedAt = startedAt;
+	}
+
+	/** tool_execution_start 时调用。 */
+	recordToolStart(toolName: string, args?: Record<string, unknown> | null): void {
+		this.toolCount++;
+		const path = args?.path ?? args?.file_path;
+		switch (classifyTool(toolName)) {
+			case "read":
+				if (nonEmptyString(path)) this.readFiles.add(path);
+				break;
+			case "edit":
+				if (nonEmptyString(path)) this.editFiles.add(path);
+				break;
+			case "bash":
+				this.commandCount++;
+				break;
+			default:
+				this.otherCount++;
+		}
+	}
+
+	/** tool_execution_end 时调用；isError 为 true 计入失败。 */
+	recordToolResult(isError: boolean): void {
+		if (isError) this.failedCount++;
+	}
+
+	snapshot(now = Date.now()): AgentSummaryData {
+		return {
+			reads: this.readFiles.size,
+			edits: this.editFiles.size,
+			commands: this.commandCount,
+			others: this.otherCount,
+			failed: this.failedCount,
+			durationMs: now - this.startedAt,
+		};
+	}
+}
+
+/** 毫秒 → "1h 2m 3s"/"2m 3s"/"3s"；低于 1 秒返回 ""（省略）。 */
+export function formatDuration(ms: number): string {
+	const totalSec = Math.floor(ms / 1000);
+	if (totalSec < 1) return "";
+	const hours = Math.floor(totalSec / 3600);
+	const minutes = Math.floor((totalSec % 3600) / 60);
+	const seconds = totalSec % 60;
+	if (hours > 0) return `${hours}h ${minutes}m ${seconds}s`;
+	if (minutes > 0) return `${minutes}m ${seconds}s`;
+	return `${seconds}s`;
+}
+
+const plural = (count: number) => (count === 1 ? "" : "s");
+
+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.failed) parts.push(`${data.failed} failed`);
+	return parts;
+}
+
+/** 纯文本摘要行（旧 compact-style 格式）："Read 3 files, edited 2 files · 42s"。 */
+export function summaryLine(data: AgentSummaryData): string {
+	const parts = summaryParts(data);
+	if (parts.length === 0) return "";
+	const text = parts.join(", ");
+	const capitalized = text[0].toUpperCase() + text.slice(1);
+	const duration = formatDuration(data.durationMs);
+	return duration ? `${capitalized} · ${duration}` : capitalized;
+}
+
+/**
+ * Markdown 摘要行。
+ * `box` 为 true：markdown 引用块 `> *斜体内容*`（渲染为引用，主题 mdQuote=muted 即灰色，
+ * 内容斜体）。entry renderer 场景直接用。
+ * `box` 为 false：整体加粗单行。
+ */
+export function summaryMarkdown(data: AgentSummaryData, box = false): string {
+	const parts = summaryParts(data);
+	if (parts.length === 0) return "";
+	// 仅首段动词大写（与纯文本版“句首大写”一致）
+	const capitalizeFirst = (part: string, first: boolean) => {
+		const verb = part.match(/^[a-z]+/)?.[0] ?? "";
+		return first && verb ? verb[0].toUpperCase() + verb.slice(1) + part.slice(verb.length) : part;
+	};
+	const text = parts.map((part, index) => capitalizeFirst(part, index === 0)).join(", ");
+	const duration = formatDuration(data.durationMs);
+	const line = duration ? `${text} · ${duration}` : text;
+	return box ? `> *${line}*` : `**${line}**`;
+}
+
+/**
+ * 绑定 pi 事件到摘要统计：
+ * - agent_start 重置统计
+ * - tool_execution_start / tool_execution_end 累计
+ * - agent_end 时回调快照（工具数 < minToolCount 不回调：单工具行本身已是摘要）
+ *
+ * 返回取消函数：清除当前统计引用（pi.on 不支持解绑，取消后不再产生回调）。
+ */
+export function bindAgentSummary(
+	pi: ExtensionAPI,
+	onSummary: (data: AgentSummaryData) => void,
+	minToolCount = 2,
+): () => void {
+	let summary = new AgentRunSummary();
+	pi.on("agent_start", async () => {
+		summary = new AgentRunSummary();
+	});
+	pi.on("tool_execution_start", async (event) => {
+		summary.recordToolStart(event.toolName, event.args);
+	});
+	pi.on("tool_execution_end", async (event) => {
+		summary.recordToolResult(event.isError === true);
+	});
+	pi.on("agent_end", async () => {
+		if (summary.toolCount >= minToolCount) onSummary(summary.snapshot());
+	});
+	return () => {
+		summary = new AgentRunSummary();
+	};
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.8.49",
+	"version": "0.8.50",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
 	"type": "module",