@herbertgao/pi-extensions 2026.9.19 → 2026.10.0

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/{show-more-hint.ts → tool/show-more-hint.ts}

@@ -36,3 +36,13 @@ export function expandShortcutText(): string {
 export function showMoreHintText(): string {
 	return isToolTuiFullscreen() ? "click to show more" : `${expandShortcutText()} to show more`;
 }
+
+/** 展开卡的收起提示，与折叠态 showMoreHintText 同一位置对称。 */
+export function collapseHintText(): string {
+	return isToolTuiFullscreen() ? "↑ Collapse" : `${expandShortcutText()} to collapse`;
+}
+
+/** 该行是否带展开态收起提示（用于展开卡的 hint hover 命中）。 */
+export function isCollapseHintLine(plainLine: string): boolean {
+	return plainLine.includes(collapseHintText());
+}

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

@@ -1,5 +1,7 @@
 import type { AssistantMessage } from "@earendil-works/pi-ai";
 import { AssistantMessageComponent, ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
+import { walkComponentTree } from "../utils/component-tree.ts";
+import { COMPACT_MODE_PATCH_KEY, patchRegistry } from "../utils/patch-keys.ts";
 
 // pi-coding-agent 类型声明中 AssistantMessageComponent 仅能以 value 形式使用，
 // updateContent/lastMessage 用结构化类型访问。
@@ -37,8 +39,6 @@ export function refreshTranscriptComponent(value: unknown): boolean {
  * 遍历 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
@@ -48,8 +48,10 @@ const COMPACT_MODE_PATCH_KEY = Symbol.for("pi.ccstyle.compact-mode-patch");
  */
 function assertCompactModeOutermost(): void {
 	try {
-		const patch = (globalThis as any)[COMPACT_MODE_PATCH_KEY];
-		if (typeof patch?.assertAssistantOwnership === "function") {
+		const patch = patchRegistry.get<{ assertAssistantOwnership?: () => void }>(
+			COMPACT_MODE_PATCH_KEY,
+		);
+		if (patch && typeof patch.assertAssistantOwnership === "function") {
 			patch.assertAssistantOwnership();
 		}
 	} catch {
@@ -61,31 +63,11 @@ 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;
-		}
+	walkComponentTree(tui, (value: any) => {
 		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/ansi-color.ts

@@ -0,0 +1,44 @@
+/** ANSI 16 色 → RGB（标准 xterm 色序）。 */
+const ANSI_16_RGB: readonly [number, number, number][] = [
+	[0, 0, 0],
+	[128, 0, 0],
+	[0, 128, 0],
+	[128, 128, 0],
+	[0, 0, 128],
+	[128, 0, 128],
+	[0, 128, 128],
+	[192, 192, 192],
+	[128, 128, 128],
+	[255, 0, 0],
+	[0, 255, 0],
+	[255, 255, 0],
+	[0, 0, 255],
+	[255, 0, 255],
+	[0, 255, 255],
+	[255, 255, 255],
+];
+
+/** ANSI 16 色码（0-15）→ RGB；越界回退白。 */
+export function ansi16ToRgb(index: number): [number, number, number] {
+	return ANSI_16_RGB[index] ?? [255, 255, 255];
+}
+
+/** ANSI 256 色码 → RGB（0-15 标准色 + 232-255 灰阶 + 16-231 六阶立方体）。 */
+export function ansi256ToRgb(code: number): [number, number, number] {
+	// SGR 正则可解析任意位数字，入口先规范：取整并钳制到合法区间，
+	// 否则灰阶分支对 code > 255 会算出超出 0-255 的非法 RGB。
+	if (!Number.isFinite(code)) return [0, 0, 0];
+	code = Math.min(255, Math.max(0, Math.trunc(code)));
+	if (code < 16) return ansi16ToRgb(code);
+	if (code >= 232) {
+		const gray = 8 + (code - 232) * 10;
+		return [gray, gray, gray];
+	}
+	const cubeIndex = code - 16;
+	const levels = [0, 95, 135, 175, 215, 255];
+	return [
+		levels[Math.floor(cubeIndex / 36)]!,
+		levels[Math.floor((cubeIndex % 36) / 6)]!,
+		levels[cubeIndex % 6]!,
+	];
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/ansi-text.ts

@@ -0,0 +1,77 @@
+/**
+ * 顶层共享的 ANSI/终端控制序列处理。
+ *
+ * 收敛原先散落在 renderer/grouping.ts / renderer/mouse/packets.ts /
+ * renderer/compact-mode.ts 的重复剥离逻辑，供 renderer 与 feature 共用。
+ */
+
+/** 单个 CSI 序列（颜色、光标等 SGR/CUP/ED 等）。 */
+const CSI_SEQUENCE_RE = /\x1b\[[0-?]*[ -/]*[@-~]/g;
+/** OSC 序列（如 \x1b]8;;url\x07 或 ST 结尾）。 */
+const OSC_SEQUENCE_RE = /\x1b\][^\x07]*(?:\x07|\x1b\\)/g;
+/** compact-mode 原有 hasVisibleText 用的更严格 OSC（内容不允许内嵌 ESC）。 */
+const OSC_SEQUENCE_STRICT_RE = /\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
+
+/** 剥离一行内所有 CSI 序列。 */
+export function stripAnsi(line: string): string {
+	return line.replace(CSI_SEQUENCE_RE, "");
+}
+
+/** 仅剥离终端序列、保留原布局（换行/空白不动），用于命中区间计算。 */
+export function stripTerminalSequencesPreservingLayout(value: string): string {
+	return value.replace(OSC_SEQUENCE_RE, "").replace(CSI_SEQUENCE_RE, "");
+}
+
+/** 剥离终端序列并折叠空白（用于纯文本比较）。 */
+export function stripTerminalSequences(value: string): string {
+	return stripTerminalSequencesPreservingLayout(value).replace(/\s+/g, " ").trim();
+}
+
+/** 去掉行内所有 CSI/OSC 序列后是否仍有可见文本（判断工具卡首尾内容行）。 */
+export function hasVisibleText(line: string): boolean {
+	// OSC 用更严格的变体：内容内嵌 ESC 时不吞并后续文本，保持 compact-mode 原有语义。
+	return line.replace(CSI_SEQUENCE_RE, "").replace(OSC_SEQUENCE_STRICT_RE, "").trim().length > 0;
+}
+
+/** 剥离背景色 ANSI（用于重新铺背景行）。 */
+export function stripBackgroundAnsi(line: string): string {
+	return line.replace(/\x1b\[(?:4[0-9]|10[0-7]|48(?:(?:;|:)[0-9]+)+|49)m/g, "");
+}
+
+/** 剥离行首状态图标（展开组内工具首行复用）。 */
+export function stripLeadingStatusIcon(line: string): string {
+	return line.replace(
+		// 行首图标：ccstyle 用 `·`，pi 原生输出里还有 `•`，两种都要剥
+		/^((?:\x1b\[[0-9;]*m|[ \t]|[├└│─])*)(?:\x1b\[[0-9;]*m)*(?:[✓✗●○■⬤•·])(?:\x1b\[[0-9;]*m)*\s+/,
+		"$1",
+	);
+}
+
+/** 终端序列零宽（不计入 plain 下标），与 stripAnsi/stripTerminalSequencesPreservingLayout 一致。 */
+const ANY_SEQUENCE_RE = new RegExp(`${CSI_SEQUENCE_RE.source}|${OSC_SEQUENCE_RE.source}`, "g");
+
+/** 只保留 [start, end) 之外的字符（base 为 text 首字符在 plain 串中的下标）。 */
+function keepOutsideRange(text: string, base: number, start: number, end: number): string {
+	if (base + text.length <= start || base >= end) return text;
+	return text.slice(0, Math.max(0, start - base)) + text.slice(Math.max(0, end - base));
+}
+
+/**
+ * 删除 plain 区间 [start, end) 的字符，保留其余字符的 ANSI 样式。
+ * 区间内的终端序列原样保留，因此区间后的字符（如收尾括号）沿用前文颜色，
+ * 不会像截断后拼纯文本那样掉回终端默认前景色。
+ */
+export function removeStyledRange(styled: string, start: number, end: number): string {
+	if (end <= start) return styled;
+	let plain = 0;
+	let cursor = 0;
+	let out = "";
+	for (const match of styled.matchAll(ANY_SEQUENCE_RE)) {
+		const text = styled.slice(cursor, match.index);
+		out += keepOutsideRange(text, plain, start, end);
+		plain += text.length;
+		out += match[0];
+		cursor = match.index + match[0].length;
+	}
+	return out + keepOutsideRange(styled.slice(cursor), plain, start, end);
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/component-tree.ts

@@ -0,0 +1,34 @@
+/**
+ * 组件树递归遍历共享实现。
+ *
+ * 收敛原先散落在 renderer 的 compact-mode / message-display / transcript-refresh /
+ * grouping / mouse/packets 的「children + getMountedRoots + seen 防环」同款遍历。
+ *
+ * visitor 在每个非数组对象节点上调用一次；返回 `false` 表示不再下钻该节点的
+ * children 与 mounted roots（对应各处原有的提前 return 语义）。
+ */
+export function walkComponentTree(root: any, visitor: (value: any) => boolean | void): 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 (visitor(value) === false) 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 {
+			// renderer 切换中的惰性 Proxy 可能暂时没有 mounted roots。
+		}
+	};
+	visit(root);
+}

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

@@ -0,0 +1,28 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { sanitizeToolResultText } from "./tool-result-sanitize.ts";
+
+/** 毫秒 → "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`;
+}
+
+/** 文本单行化：去换行空白，超宽截断加省略号。 */
+export function oneLine(value: unknown, max = 96): string {
+	const text = sanitizeToolResultText(String(value ?? ""), 4096)
+		.replace(/\s+/g, " ")
+		.trim();
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+
+/** 把一行文本补齐到固定可见宽度，超宽时截断并追加省略号。 */
+export function padLine(text: string, width: number): string {
+	const truncated = truncateToWidth(text, width, "…");
+	return truncated + " ".repeat(Math.max(0, width - visibleWidth(truncated)));
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/fullscreen-detect.ts

@@ -1,3 +1,6 @@
+import { TuiMainScreen } from "@earendil-works/pi-tui";
+import { MAIN_SCREEN_DO_RENDER_PATCH, patchRegistry } from "./patch-keys.ts";
+
 /**
  * 官方 0.84+ 的 tui 引用是惰性 Proxy（createInteractiveTuiReference）：
  * 函数属性每次 get 都返回新包装，执行时才解析到当前实现。
@@ -9,3 +12,51 @@ export function isLazyProxyTui(tui: any): boolean {
 	const probe = tui.requestRender;
 	return typeof probe === "function" && probe !== tui.requestRender;
 }
+
+type MainScreenDoRenderPatch = {
+	active: boolean;
+	original: (lines: string[]) => string[];
+	installed: (lines: string[]) => string[];
+};
+
+/**
+ * regular（TuiMainScreen）模式的 doRender 走差分绘制：一旦第一个变化行落在
+ * previousViewportTop 之上（终端写不进 scrollback 的区域），只能
+ * fullRender(true)——\x1b[2J\x1b[H\x1b[3J 清屏并清掉整段 scrollback。
+ * compact 直播式回合的摘要行动画与流式正文渲染在回合工具卡/diff 面板上方；
+ * diff 面板一落地把下方内容撑过屏高，之后每帧重绘都命中该分支：scrollback
+ * 被反复清空，滚动条回弹、视口钉住，直到输出结束才恢复。
+ *
+ * 视口上方的行本就无法重写，只剩「清回滚重打」与「scrollback 保留旧文本」
+ * 两条路。这里选后者：applyLineResets 是差分比较前最后一个拿到整帧的环节，
+ * 把 previousLines 的视口上方前缀直接对齐新帧，差分只看到可写区域，照常增量
+ * 绘制。代价仅是 scrollback 里那几行停留在最后一次实际写入的内容。
+ */
+export function installMainScreenDoRenderPatch(): void {
+	const prototype = TuiMainScreen.prototype as any;
+	if (typeof prototype?.applyLineResets !== "function") return;
+	const previous = patchRegistry.get<MainScreenDoRenderPatch>(MAIN_SCREEN_DO_RENDER_PATCH);
+	if (previous) previous.active = false;
+	const original =
+		previous && prototype.applyLineResets === previous.installed
+			? previous.original
+			: prototype.applyLineResets;
+	const patch: MainScreenDoRenderPatch = {
+		active: true,
+		original,
+		installed(this: any, lines: string[]) {
+			const result = original.call(this, lines);
+			if (!patch.active) return result;
+			const prev = this.previousLines;
+			if (!Array.isArray(prev)) return result;
+			const top = Math.min(
+				Math.max(0, Math.floor(Number(this.previousViewportTop) || 0)),
+				result.length,
+			);
+			for (let i = 0; i < top; i++) prev[i] = result[i];
+			return result;
+		},
+	};
+	prototype.applyLineResets = patch.installed;
+	patchRegistry.install(MAIN_SCREEN_DO_RENDER_PATCH, patch);
+}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/patch-keys.ts

@@ -0,0 +1,124 @@
+/**
+ * ccstyle 补丁所有权与跨模块协调键的单一来源（single source of truth）。
+ *
+ * 全部使用 Symbol.for（全局注册表）：/reload 后新模块实例拿到的是同一个 symbol，
+ * 这是跨 reload 识别/让渡补丁所有权的关键。切勿把这些 Symbol.for 改成模块局部 Symbol。
+ *
+ * 两类用途：
+ * 1. globalThis 槽位：安装补丁时写 host[KEY] = patch，dispose 时按所有权判断还原。
+ * 2. 实例/函数标记：把补丁包装器或组件实例标记在某个 symbol 属性上，供跨模块识别。
+ *
+ * PatchRegistry 把第 1 类的读写收口为带所有权语义的 install/dispose 生命周期；
+ * 底层仍是 globalThis[symbol]，因此外部（含测试）直接读 globalThis 槽不受影响。
+ */
+
+// ── compact / compact-thinking 协调 ──
+export const COMPACT_MODE_PATCH_KEY = Symbol.for("pi.ccstyle.compact-mode-patch");
+export const COMPACT_THINKING_PATCH_KEY = Symbol.for("pi.ccstyle.compact-thinking-update");
+export const PROTOTYPE_ORIGINAL_KEY = Symbol.for("pi.ccstyle.prototype-original");
+export const COMPACT_THINKING_OWNER = Symbol.for("pi.ccstyle.compact-thinking-owner");
+
+// ── assistant 展开状态（实例标记） ──
+export const ASSISTANT_SET_EXPANDED_KEY = Symbol.for("pi.ccstyle.compact-assistant-set-expanded");
+export const ASSISTANT_TOGGLE_ROUND_KEY = Symbol.for("pi.ccstyle.compact-assistant-toggle-round");
+export const ASSISTANT_REENTRY_KEY = Symbol.for("pi.ccstyle.compact-assistant-reentry");
+
+// ── 工具渲染补丁 ──
+export const GLOBAL_TOOL_RENDER_PATCH = Symbol.for("pi.ccstyle.global-tool-render-patch");
+export const COMPONENT_TOOL_RENDER_MODE = Symbol.for("pi.ccstyle.component-tool-render-mode");
+export const TOOL_EXPANDED_BACKGROUND_PATCH = Symbol.for(
+	"pi.ccstyle.tool-expanded-background-patch",
+);
+// write 归属：注册期确认一次，渲染期据此决定是否提供 rich diff。
+export const WRITE_OWNERSHIP_SLOT = Symbol.for("pi.ccstyle.write-ownership");
+
+// ── 消息组件补丁 ──
+export const MESSAGE_DISPLAY_PATCH = Symbol.for("pi.ccstyle.message-display-patch");
+
+// ── 工具分组 ──
+export const TOOL_GROUPING_PATCH_KEY = Symbol.for("pi.ccstyle.tool-grouping-patch");
+export const TOOL_GROUPING_PARENT_KEY = Symbol.for("pi.ccstyle.tool-grouping-parent");
+export const TOOL_GROUPING_GENERATION_KEY = Symbol.for("pi.ccstyle.tool-grouping-generation");
+
+// ── regular 主屏渲染补丁 ──
+export const MAIN_SCREEN_DO_RENDER_PATCH = Symbol.for("pi.ccstyle.main-screen-do-render-patch");
+
+// ── 鼠标交互 ──
+export const TOOL_MOUSE_OWNER_KEY = Symbol.for("pi.ccstyle.tool-mouse-owner");
+export const TOOL_MOUSE_TUI_SLOT = Symbol.for("pi.ccstyle.tool-mouse-tui");
+export const SCROLL_BUTTON_STATE_SLOT = Symbol.for("pi.ccstyle.scroll-button-state");
+export const OFFICIAL_SCROLL_TO_END_KEY = Symbol.for("pi.ccstyle.official-scroll-to-end");
+export const FLUSH_DOCKED_BASH_PATCH = Symbol.for("pi.ccstyle.flush-docked-bash-patch");
+export const EARLY_STARTUP_HEADER_PATCH = Symbol.for("pi.ccstyle.early-startup-header-patch");
+export const EARLY_STARTUP_HEADER_SWAP_KEY = Symbol.for("pi.ccstyle.early-startup-header-swap");
+export const TOOL_HOVER_STATE_KEY = Symbol.for("pi.ccstyle.tool-hover-state");
+
+// ── rich diff 组件标记 ──
+export const RICH_DIFF_COMPONENT = Symbol.for("pi.ccstyle.rich-diff-component");
+
+// ── PatchRegistry：所有权生命周期统一收口 ──
+
+/**
+ * host 上的补丁槽位读写器。把散落各处的
+ * `host[KEY] = patch` / `if (host[KEY] === patch) delete host[KEY]` 收口为
+ * 带所有权语义的 install/dispose 生命周期：
+ *
+ * - install：覆盖写入并返回被替换的旧值（不自动让旧值失效——部分安装器
+ *   需要先读旧补丁以链接下游方法，由调用方决定如何 inactivate）。
+ * - dispose：所有权守卫删除——仅当槽位仍 === 该值才删除，防止 /reload 后
+ *   旧模块误删新模块的补丁。
+ * - owns：判断槽位是否仍由某值持有（恒等比较）。
+ * - ensure：惰性状态槽（??= 语义），用于无所有权的跨模块共享状态。
+ */
+export class PatchRegistry {
+	readonly host: Record<PropertyKey, unknown>;
+
+	constructor(
+		host: Record<PropertyKey, unknown> = globalThis as unknown as Record<PropertyKey, unknown>,
+	) {
+		this.host = host;
+	}
+
+	/** 读取槽位当前值。 */
+	get<T = unknown>(key: symbol): T | undefined {
+		return this.host[key] as T | undefined;
+	}
+
+	/** 是否仍由 value 持有（恒等比较）。 */
+	owns(key: symbol, value: unknown): boolean {
+		return this.host[key] === value;
+	}
+
+	/** 覆盖写入并返回被替换的旧值；不自动让旧值失效。 */
+	install<T = unknown>(key: symbol, value: T): T | undefined {
+		const previous = this.host[key] as T | undefined;
+		this.host[key] = value;
+		return previous;
+	}
+
+	/** 所有权守卫删除：仅当槽位仍 === value 时删除。返回是否删除。 */
+	dispose(key: symbol, value: unknown): boolean {
+		if (!this.owns(key, value)) return false;
+		delete this.host[key];
+		return true;
+	}
+
+	/** 惰性槽位：无值（null/undefined）时用 init() 初始化并缓存。 */
+	ensure<T>(key: symbol, init: () => T): T {
+		const current = this.host[key];
+		if (current !== null && current !== undefined) return current as T;
+		const value = init();
+		this.host[key] = value;
+		return value;
+	}
+
+	/** 无条件删除槽位（不判断所有权）。返回是否实际删除了键。 */
+	delete(key: symbol): boolean {
+		if (!(key in this.host)) return false;
+		delete this.host[key];
+		return true;
+	}
+}
+
+/** 全局单例：host 固定为 globalThis，跨 /reload 与 jiti 重载稳定。 */
+export const patchRegistry = new PatchRegistry();

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/sgr-mouse.ts

@@ -0,0 +1,70 @@
+/**
+ * SGR 鼠标协议解析（共享）。
+ *
+ * 收敛 feature/_util.ts 的单包解析与 renderer/mouse/packets.ts 的批量解析。
+ */
+
+/** SGR 鼠标协议包（code;col;row + M/m 终结符）。 */
+export type SgrMousePacket = {
+	code: number;
+	col: number;
+	row: number;
+	final: "M" | "m";
+};
+
+/** 解析单个完整 SGR 鼠标包（整段数据必须恰好是一个包）。 */
+export function parseSgrMousePacket(data: string): SgrMousePacket | null {
+	const match = data.match(/^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/);
+	if (!match) return null;
+	return {
+		code: Number(match[1]),
+		col: Number(match[2]),
+		row: Number(match[3]),
+		final: match[4] as "M" | "m",
+	};
+}
+
+/**
+ * 解析整段终端输入为 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 = mouseBaseButton(packet.code);
+	return packet.final === "M" && baseButton === 0 && (packet.code & 32) === 0;
+}
+
+/** 是否为左键松开。 */
+export function isSgrLeftRelease(packet: SgrMousePacket): boolean {
+	const baseButton = mouseBaseButton(packet.code);
+	return packet.final === "m" && baseButton === 0 && (packet.code & 32) === 0;
+}
+
+/** 无按键按住的指针移动（DECSET 1003 的 35）。左键拖动（32，文本选区）不是 hover。 */
+export function isSgrIdleMotion(packet: SgrMousePacket): boolean {
+	return packet.final === "M" && (packet.code & 32) !== 0 && mouseBaseButton(packet.code) === 3;
+}
+
+/** 剥离修饰键位（4/8/16/32：shift/meta/ctrl/motion），得到基础按键码。 */
+export function mouseBaseButton(code: number): number {
+	return code & ~(4 | 8 | 16 | 32);
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-cc-extensions",
-  "version": "0.9.7",
+  "version": "0.11.0",
   "license": "MIT",
   "description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
   "type": "module",
@@ -36,12 +36,14 @@
       "./themes/cc-dark.json",
       "./themes/cc-light.json"
     ],
-    "image": "https://raw.githubusercontent.com/HerbertGao/pi-extensions/master/packages/pi-cc-extensions/assets/readme/welcome.webp",
-    "video": "https://github.com/user-attachments/assets/debf76ea-a9dc-4f34-977f-aae344a9a7f8"
+    "image": "https://raw.githubusercontent.com/HerbertGao/pi-extensions/master/packages/pi-cc-extensions/assets/readme/preview.webp",
+    "video": "https://github.com/minuque/pi-cc-extensions/releases/download/v0.9.4/demo.mp4"
   },
   "scripts": {
-    "test": "node --test tests/**/*.test.ts",
-    "typecheck": "node scripts/typecheck.mjs",
+    "test": "node scripts/test.mjs",
+    "coverage": "node scripts/test.mjs --experimental-test-coverage --test-coverage-include=extensions/**/*.ts",
+    "docs:tool-render": "node --experimental-strip-types scripts/generate-tool-render-examples.ts",
+    "typecheck": "tsc --noEmit",
     "format": "biome format --write .",
     "format:check": "biome format ."
   },
@@ -69,9 +71,9 @@
   },
   "x-upstream": {
     "package": "pi-cc-extensions",
-    "version": "0.8.71",
-    "reviewedVersion": "0.9.9",
+    "version": "0.9.10",
+    "reviewedVersion": "0.9.10",
     "repository": "https://github.com/minuque/pi-cc-extensions",
-    "commit": "e43e0041b59f5d7f03be9b9d103a5f9e954e4c11"
+    "commit": "2b72669cafefe0771b2e3e63b0db5c478314d2d4"
   }
 }

package/node_modules/@herbertgao/pi-subagents/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.18.5
+
+### Patch Changes
+
+- [#258](https://github.com/HerbertGao/pi-extensions/pull/258) [`4f505b1`](https://github.com/HerbertGao/pi-extensions/commit/4f505b1456c5ea766121ee915f14ad29e48973e7) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Keep Pi 1.x tool-call capabilities when starting a mentioned agent through a conversation clone, while preserving attribution to the main session.
+
 ## 0.18.4
 
 ### Patch Changes

package/node_modules/@herbertgao/pi-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-subagents",
-  "version": "0.18.4",
+  "version": "0.18.5",
   "description": "Claude Code-style autonomous subagents and workflow orchestration for Pi, with HerbertGao-maintained UI extensions.",
   "keywords": [
     "agent",

package/node_modules/@herbertgao/pi-subagents/src/mention-clone.ts

@@ -108,7 +108,7 @@ export async function runMentionClone(
   let spawned = false
   const cloneAgentTool: ToolDefinition = {
     ...agentTool,
-    execute: (_cloneToolCallId, params, signal, onUpdate, _cloneCtx) => {
+    execute: (_cloneToolCallId, params, signal, onUpdate, cloneCtx) => {
       // One spawn per mention. The clone has a single tool and every reason to
       // stop after using it, but a model that decides to "also" launch a second
       // agent would do it where nobody can see and nobody asked.
@@ -138,7 +138,8 @@ export async function runMentionClone(
         } as typeof params,
         signal,
         onUpdate,
-        ctx,
+        // Keep Pi's tool-call capabilities, but attribute the spawn to the main session.
+        { ...ctx, tools: cloneCtx.tools, executeTool: cloneCtx.executeTool },
       )
     },
   }

package/node_modules/@herbertgao/sol-pi/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+We welcome external pull requests that improve token efficiency and reduce token cost through Pi-compatible extensions.
+
+## Pull Request Requirements
+
+Your PR should:
+
+- Implement a Pi-compatible extension using Pi's public extension APIs, without modifying Pi's core.
+- Be tested before submission, with relevant automated tests and reproducible validation steps.
+- Clearly explain how the extension reduces token cost or improves token efficiency, including local measurements where available.
+- Document its configuration, expected behavior, and any trade-offs. Efficiency improvements will be evaluated alongside correctness and task performance.
+
+## Benchmarking and Reports
+
+Our team will help benchmark submitted extensions to evaluate token usage, model cost, and task performance.
+
+We will publish updated benchmark reports on a regular reporting cycle, sharing evaluated changes, results, and any observed trade-offs.
+
+## Contributor Recognition
+
+Authors of accepted PRs will be credited as Contributors in the project documentation and the relevant benchmark reports.