pi-cc-extensions 0.8.67 → 0.8.69

package/README.en.md

@@ -61,16 +61,18 @@ Run `/reload` after installation.
   "editDiffCollapsedLines": 24,            // Edit collapse lines; beyond that shows the expand hint
   "writeDiffCollapsedLines": 0,            // write collapse lines; 0 = creation summary only
   "diffWordWrap": true,                    // wrap long diff lines
-  "expandedPreviewMaxLines": 40,           // max lines for expanded bodies
-  "toolInputNameLength": 100,             // tool summary path/command clip length
 
   // thinking
   "useSummaryTitlesAsThinkingTitle": true, // use latest summary as thinking title
   "previewLines": 3,                       // preview lines; 0 hides
   "animationIntervalMs": 90,               // title animation interval (ms)
-  "dimThinkingText": false,               // dim thinking body text
+  "dimThinkingText": false,                // dim thinking body text
 
   // ui
+  "expandedInputMaxLines": 5,              // expanded tool Input lines; overflow shows a footer hint
+  "expandedOutputMaxLines": 10,            // expanded tool Output lines; overflow shows a footer hint
+  "expandedPreviewMaxLines": 40,           // max lines for expanded diff/TaskList bodies
+  "inputClip": 100,                        // tool summary path/command clip length
   "showStartupHeader": true,               // startup header (logo + tips) toggle
   "scrollStepLines": 3,                    // fullscreen wheel scroll step
 
@@ -84,7 +86,7 @@ Run `/reload` after installation.
 }
 ```
 
-> **Fullscreen**: click `click to show more` to expand tool cards, thinking, Skill, and compact summaries. Double-click an expanded panel to collapse it.
+> **Fullscreen**: click `click to show more` to expand tool cards, thinking, Skill, and compact summaries. When expanded Input/Output exceeds the line cap, the footer `… +N more lines • click to show more` opens a full preview. Double-click an expanded panel to collapse it.
 >
 > **Tip**: set `markdown.mermaid` to `final` via `~/.pi/agent/settings.json` or the Mermaid diagrams option in `/settings`. Default `streaming` redraws per frame; `final` renders once at completion.
 

package/README.md

@@ -61,16 +61,18 @@ pi install git:github.com/minuque/pi-cc-extensions
   "editDiffCollapsedLines": 24,            // Edit 折叠行数，超出显示展开提示
   "writeDiffCollapsedLines": 0,            // write 折叠行数，0 仅显示创建摘要
   "diffWordWrap": true,                    // 长 diff 行换行
-  "expandedPreviewMaxLines": 40,           // 展开正文最大行数
-  "toolInputNameLength": 100,             // 工具摘要 path/command 折叠字符数
 
   // thinking
   "useSummaryTitlesAsThinkingTitle": true, // 用最新摘要作思考标题
   "previewLines": 3,                       // 预览行数，0 隐藏
   "animationIntervalMs": 90,               // 标题动画间隔（毫秒）
-  "dimThinkingText": false,               // thinking 正文用 dim 色
+  "dimThinkingText": false,                // thinking 正文用 dim 色
 
   // ui
+  "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
+  "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
+  "expandedPreviewMaxLines": 40,           // 展开 diff/TaskList 正文最大行数
+  "inputClip": 100,                        // 工具摘要 path/command 折叠字符数
   "showStartupHeader": true,               // 启动头（logo + tips）开关
   "scrollStepLines": 3,                    // fullscreen 滚轮步进
 
@@ -84,7 +86,7 @@ pi install git:github.com/minuque/pi-cc-extensions
 }
 ```
 
-> **Fullscreen**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要，双击展开面板收起。
+> **Fullscreen**：单击 `click to show more` 展开工具卡、思考、Skill 和 compact 摘要；展开后 Input/Output 超行时，末行 `… +N more lines • click to show more` 打开全量预览。双击展开面板收起。
 >
 > **建议**：`markdown.mermaid` 设为 `final`（`~/.pi/agent/settings.json` 或 `/settings` 面板的 Mermaid diagrams 选项）。默认 `streaming` 逐帧重绘，`final` 渲染最终版更稳定。
 

package/extensions/config/config.ts

@@ -5,9 +5,6 @@ import { join } from "node:path";
 
 export type CompactStyleMode = "on" | "compact" | "off";
 
-// ── diff 显示配置：作为配置 schema 的一部分由 config 层拥有 ──
-// renderer（diff）从 config 导入并 re-export，避免 config → renderer 的反向依赖。
-
 export type DiffViewMode = "auto" | "split" | "unified";
 export type DiffIndicatorMode = "bars" | "classic" | "none";
 
@@ -52,7 +49,9 @@ export type Config = {
 	writeDiffCollapsedLines: number;
 	diffWordWrap: boolean;
 	expandedPreviewMaxLines: number;
-	toolInputNameLength: number;
+	expandedInputMaxLines: number;
+	expandedOutputMaxLines: number;
+	inputClip: number;
 	useSummaryTitlesAsThinkingTitle: boolean;
 	previewLines: number;
 	animationIntervalMs: number;
@@ -78,8 +77,12 @@ export const DIFF_COLLAPSED_LINES_VALUES = ["12", "24", "36", "48", "80", "120"]
 export const WRITE_DIFF_COLLAPSED_LINES_VALUES = ["0", "4", "8", "12", "24", "36"];
 /** Presets for expanded body height — keep low options first so cycling stays TUI-friendly. */
 export const EXPANDED_PREVIEW_MAX_LINES_VALUES = ["40", "60", "80", "120", "200", "500", "2000"];
+/** 展开工具卡 Input 可见行数预设。 */
+export const EXPANDED_INPUT_MAX_LINES_VALUES = ["5", "10", "20", "40", "80"];
+/** 展开工具卡 Output 可见行数预设。 */
+export const EXPANDED_OUTPUT_MAX_LINES_VALUES = ["10", "20", "40", "80", "120"];
 /** 工具摘要里 path/command 等输入的折叠字符数。 */
-export const TOOL_INPUT_NAME_LENGTH_VALUES = ["40", "60", "80", "100", "120", "160"];
+export const INPUT_CLIP_VALUES = ["40", "60", "80", "100", "120", "160"];
 export const THINKING_PREVIEW_LINES_VALUES = ["0", "1", "3", "5", "10"];
 export const THINKING_ANIMATION_INTERVAL_VALUES = ["40", "60", "90", "120", "180"];
 /** fullscreen 滚轮步进行数预设。 */
@@ -107,7 +110,9 @@ export const DEFAULT_CONFIG: Config = {
 	writeDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.writeDiffCollapsedLines,
 	diffWordWrap: DEFAULT_TOOL_DISPLAY_CONFIG.diffWordWrap,
 	expandedPreviewMaxLines: DEFAULT_TOOL_DISPLAY_CONFIG.expandedPreviewMaxLines,
-	toolInputNameLength: 100,
+	expandedInputMaxLines: 5,
+	expandedOutputMaxLines: 10,
+	inputClip: 100,
 	useSummaryTitlesAsThinkingTitle: true,
 	previewLines: 3,
 	animationIntervalMs: 90,
@@ -141,16 +146,7 @@ export function pickPositiveNumber(value: unknown, fallback: number, min = 1): n
 
 export function normalizeConfig(input: unknown): Config {
 	const source = (input && typeof input === "object" ? input : {}) as Record<string, unknown>;
-	const mode = source.mode;
-	// 旧 `enabled: boolean` 配置迁移；compact 已恢复为受支持模式，不再回退 on。
-	const migratedMode: CompactStyleMode =
-		mode === "on" || mode === "compact" || mode === "off"
-			? mode
-			: typeof source.enabled === "boolean"
-				? source.enabled
-					? "on"
-					: "off"
-				: "on";
+	const mode = pickEnum(source.mode, ["on", "compact", "off"], DEFAULT_CONFIG.mode);
 	const excludeRenderers = Array.isArray(source.excludeRenderers)
 		? [
 				...new Set(
@@ -161,7 +157,7 @@ export function normalizeConfig(input: unknown): Config {
 			]
 		: [];
 	return {
-		mode: migratedMode,
+		mode,
 		excludeRenderers,
 		diffViewMode: pickEnum(source.diffViewMode, DIFF_VIEW_MODES, DEFAULT_CONFIG.diffViewMode),
 		diffIndicatorMode: pickEnum(
@@ -176,7 +172,7 @@ export function normalizeConfig(input: unknown): Config {
 			300,
 		),
 		editDiffCollapsedLines: pickPositiveInt(
-			source.editDiffCollapsedLines ?? source.diffCollapsedLines,
+			source.editDiffCollapsedLines,
 			DEFAULT_CONFIG.editDiffCollapsedLines,
 			1,
 			500,
@@ -194,12 +190,19 @@ export function normalizeConfig(input: unknown): Config {
 			10,
 			50_000,
 		),
-		toolInputNameLength: pickPositiveInt(
-			source.toolInputNameLength,
-			DEFAULT_CONFIG.toolInputNameLength,
-			8,
-			500,
+		expandedInputMaxLines: pickPositiveInt(
+			source.expandedInputMaxLines,
+			DEFAULT_CONFIG.expandedInputMaxLines,
+			1,
+			5_000,
+		),
+		expandedOutputMaxLines: pickPositiveInt(
+			source.expandedOutputMaxLines,
+			DEFAULT_CONFIG.expandedOutputMaxLines,
+			1,
+			5_000,
 		),
+		inputClip: pickPositiveInt(source.inputClip, DEFAULT_CONFIG.inputClip, 8, 500),
 		useSummaryTitlesAsThinkingTitle: source.useSummaryTitlesAsThinkingTitle !== false,
 		previewLines: pickPositiveInt(
 			source.previewLines,
@@ -258,7 +261,9 @@ export function formatConfigStatus(source: Config = config): string {
 		`writeCollapsed=${source.writeDiffCollapsedLines}`,
 		`diffWordWrap=${source.diffWordWrap ? "on" : "off"}`,
 		`expandedMax=${source.expandedPreviewMaxLines}`,
-		`toolInputName=${source.toolInputNameLength}`,
+		`expandedInput=${source.expandedInputMaxLines}`,
+		`expandedOutput=${source.expandedOutputMaxLines}`,
+		`inputClip=${source.inputClip}`,
 		`thinkingTitle=${source.useSummaryTitlesAsThinkingTitle ? "summary" : "default"}`,
 		`thinkingPreview=${source.previewLines}`,
 		`thinkingAnimation=${source.animationIntervalMs}ms`,
@@ -282,20 +287,7 @@ function loadConfig(): Config {
 		const source = existsSync(CONFIG_PATH)
 			? (JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Record<string, unknown>)
 			: {};
-		const normalized = normalizeConfig(source);
-		if (
-			typeof source.enabled === "boolean" &&
-			source.mode !== "on" &&
-			source.mode !== "compact" &&
-			source.mode !== "off"
-		) {
-			try {
-				writeFileSync(CONFIG_PATH, JSON.stringify(normalized, null, 2));
-			} catch {
-				// A read-only config still uses the migrated in-memory value.
-			}
-		}
-		return normalized;
+		return normalizeConfig(source);
 	} catch {
 		// Ignore bad config and fall back to defaults.
 	}

package/extensions/config/panel.ts

@@ -17,6 +17,8 @@ import {
 	DIFF_SPLIT_MIN_WIDTH_VALUES,
 	DIFF_VIEW_MODES,
 	EXCLUDE_RENDERER_CANDIDATES,
+	EXPANDED_INPUT_MAX_LINES_VALUES,
+	EXPANDED_OUTPUT_MAX_LINES_VALUES,
 	EXPANDED_PREVIEW_MAX_LINES_VALUES,
 	formatExcludeRenderers,
 	getCompactThinkingConfig,
@@ -25,7 +27,7 @@ import {
 	SCROLL_STEP_LINES_VALUES,
 	THINKING_ANIMATION_INTERVAL_VALUES,
 	THINKING_PREVIEW_LINES_VALUES,
-	TOOL_INPUT_NAME_LENGTH_VALUES,
+	INPUT_CLIP_VALUES,
 	WRITE_DIFF_COLLAPSED_LINES_VALUES,
 	updateConfig,
 	type CompactStyleMode,
@@ -264,15 +266,15 @@ export async function showCcstylePanel(
 				);
 			},
 		};
-		const toolInputNameSetting = {
-			id: "toolInputNameLength",
+		const inputClipSetting = {
+			id: "inputClip",
 			label: "Input clip",
 			description:
 				"Max characters for path/command/name in single and grouped tool summaries. Enter to type a custom value.",
-			currentValue: String(config.toolInputNameLength),
-			values: [...TOOL_INPUT_NAME_LENGTH_VALUES],
+			currentValue: String(config.inputClip),
+			values: [...INPUT_CLIP_VALUES],
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
-				buildNumberInputSubmenu(theme, toolInputNameSetting, closeSubmenu),
+				buildNumberInputSubmenu(theme, inputClipSetting, closeSubmenu),
 		};
 		const diffViewSetting = {
 			id: "diffViewMode",
@@ -327,11 +329,31 @@ export async function showCcstylePanel(
 			currentValue: config.diffWordWrap ? "on" : "off",
 			values: ["on", "off"],
 		};
+		const expandedInputSetting = {
+			id: "expandedInputMaxLines",
+			label: "Expanded input lines",
+			description:
+				"Max Input section lines in an expanded tool card. Overflow shows click to show more. Default 5.",
+			currentValue: String(config.expandedInputMaxLines),
+			values: [...EXPANDED_INPUT_MAX_LINES_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, expandedInputSetting, closeSubmenu),
+		};
+		const expandedOutputSetting = {
+			id: "expandedOutputMaxLines",
+			label: "Expanded output lines",
+			description:
+				"Max Output section lines in an expanded tool card. Overflow shows click to show more. Default 10.",
+			currentValue: String(config.expandedOutputMaxLines),
+			values: [...EXPANDED_OUTPUT_MAX_LINES_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, expandedOutputSetting, closeSubmenu),
+		};
 		const expandedMaxSetting = {
 			id: "expandedPreviewMaxLines",
 			label: "Expanded max lines",
 			description:
-				"Max Output/diff body lines when expanded. Default 40 keeps the TUI compact; raise for large dumps.",
+				"Max diff/TaskList body lines when expanded. Tool Input/Output use the two settings above.",
 			currentValue: String(config.expandedPreviewMaxLines),
 			values: [...EXPANDED_PREVIEW_MAX_LINES_VALUES],
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
@@ -452,11 +474,11 @@ export async function showCcstylePanel(
 				return;
 			}
 			switch (id) {
-				case "toolInputNameLength":
+				case "inputClip":
 					updateConfig({
-						toolInputNameLength: pickPositiveInt(value, DEFAULT_CONFIG.toolInputNameLength, 8, 500),
+						inputClip: pickPositiveInt(value, DEFAULT_CONFIG.inputClip, 8, 500),
 					});
-					toolInputNameSetting.currentValue = String(config.toolInputNameLength);
+					inputClipSetting.currentValue = String(config.inputClip);
 					break;
 				case "mode": {
 					// 选项值带 Experimental 标记，选择后还原为真实 mode 值。
@@ -512,6 +534,28 @@ export async function showCcstylePanel(
 						? "Long diff lines wrap within the panel width."
 						: "Long diff lines are truncated to the panel width.";
 					break;
+				case "expandedInputMaxLines":
+					updateConfig({
+						expandedInputMaxLines: pickPositiveInt(
+							value,
+							DEFAULT_CONFIG.expandedInputMaxLines,
+							1,
+							5_000,
+						),
+					});
+					expandedInputSetting.currentValue = String(config.expandedInputMaxLines);
+					break;
+				case "expandedOutputMaxLines":
+					updateConfig({
+						expandedOutputMaxLines: pickPositiveInt(
+							value,
+							DEFAULT_CONFIG.expandedOutputMaxLines,
+							1,
+							5_000,
+						),
+					});
+					expandedOutputSetting.currentValue = String(config.expandedOutputMaxLines);
+					break;
 				case "expandedPreviewMaxLines":
 					updateConfig({
 						expandedPreviewMaxLines: pickPositiveInt(
@@ -580,8 +624,6 @@ export async function showCcstylePanel(
 					diffCollapsedSetting,
 					writeDiffCollapsedSetting,
 					diffWordWrapSetting,
-					expandedMaxSetting,
-					toolInputNameSetting,
 				],
 			},
 			{
@@ -597,7 +639,14 @@ export async function showCcstylePanel(
 			{
 				id: "ui",
 				label: "UI",
-				items: [startupHeaderSetting, scrollStepSetting],
+				items: [
+					expandedInputSetting,
+					expandedOutputSetting,
+					expandedMaxSetting,
+					inputClipSetting,
+					startupHeaderSetting,
+					scrollStepSetting,
+				],
 			},
 			{
 				id: "feature",

package/extensions/feature/agent-summary/core.ts

@@ -2,7 +2,7 @@
  * Agent 回合摘要：统计一次 agent 运行的工具使用并格式化成摘要文本。
  *
  * 分类：bash / read / edit / write / other（精确工具名；MCP 风格名归 other）。
- * 计数：bash 按调用次数；read/edit/write 按非空 path/file_path 去重；other 按调用次数。
+ * 计数：bash/powershell 按调用次数；read/edit/write 按非空 path/file_path 去重；other 按调用次数。
  * 失败单独累计；另记回合耗时。
  *
  * 呈现：`summaryLine` 纯文本，`summaryMarkdown` Markdown（可 box 引用块）。
@@ -10,7 +10,6 @@
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { formatDuration } from "../../utils/format.ts";
-export { formatDuration };
 
 /** 工具分类。 */
 export type AgentToolCategory = "bash" | "read" | "edit" | "write" | "other";
@@ -28,7 +27,7 @@ export type AgentSummaryData = {
 
 export function classifyTool(toolName: string): AgentToolCategory {
 	const base = toolName.split(".").pop() ?? toolName;
-	if (base === "bash") return "bash";
+	if (base === "bash" || base === "powershell") return "bash";
 	if (base === "read") return "read";
 	if (base === "edit") return "edit";
 	if (base === "write") return "write";
@@ -114,24 +113,8 @@ function summaryParts(data: AgentSummaryData): string[] {
 	return parts;
 }
 
-/** 纯文本摘要行：句首大写 + 可选耗时。 */
-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：引用块 `> *斜体*`；false：整体加粗。
- * `colors`：仅数字染色（success / failed）。
- */
 export function summaryMarkdown(
 	data: AgentSummaryData,
-	box = false,
 	colors: { success: string; failed: string } = { success: "", failed: "" },
 ): string {
 	const parts = summaryParts(data);
@@ -148,7 +131,7 @@ export function summaryMarkdown(
 		.join(", ");
 	const duration = formatDuration(data.durationMs);
 	const line = duration ? `${text} · ${duration}` : text;
-	return box ? `> *${line}*` : `**${line}**`;
+	return `> *${line}*`;
 }
 
 /**
@@ -160,8 +143,7 @@ export function summaryMarkdown(
 export function bindAgentSummary(
 	pi: ExtensionAPI,
 	onSummary: (data: AgentSummaryData) => void,
-	minToolCount = 2,
-): () => void {
+): void {
 	let summary = new AgentRunSummary();
 	pi.on("agent_start", async () => {
 		summary = new AgentRunSummary();
@@ -173,9 +155,6 @@ export function bindAgentSummary(
 		summary.recordToolResult(event.isError === true);
 	});
 	pi.on("agent_end", async () => {
-		if (summary.toolCount >= minToolCount) onSummary(summary.snapshot());
+		if (summary.toolCount >= 2) onSummary(summary.snapshot());
 	});
-	return () => {
-		summary = new AgentRunSummary();
-	};
 }

package/extensions/feature/agent-summary/index.ts

@@ -2,7 +2,7 @@
  * Agent 回合摘要展示：agent_end 时把本回合工具统计写入会话条目，
  * 由 entry renderer 渲染为 markdown 引用块 `> [!TIP] *斜体内容*`。
  *
- * 统计复用 ./core.ts（bash/read/edit/write/other）。
+ * 统计复用 ./core.ts（bash|powershell/read/edit/write/other）。
  * appendEntry 不进 LLM 上下文，只显示在聊天区。
  * 引用块文字色取主题 mdQuote（cc 主题下为 muted 灰），内容用 *斜体* 语法。
  */
@@ -16,7 +16,7 @@ export const AGENT_SUMMARY_ENTRY_TYPE = "agent-summary";
 
 export default function (pi: ExtensionAPI): void {
 	pi.registerEntryRenderer(AGENT_SUMMARY_ENTRY_TYPE, (entry, _options, theme) => {
-		const line = summaryMarkdown(entry.data as AgentSummaryData, true, {
+		const line = summaryMarkdown(entry.data as AgentSummaryData, {
 			success: theme.getFgAnsi("success"),
 			failed: theme.getFgAnsi("error"),
 		});

package/extensions/feature/compact-thinking.ts

@@ -31,9 +31,6 @@ import {
 	patchRegistry,
 	PROTOTYPE_ORIGINAL_KEY,
 } from "../utils/patch-keys.ts";
-// 保持导出兼容：渲染函数已并入 renderer/compact-mode.ts，这里 re-export。
-export { animateCompactThinkingText, formatThoughtDuration, styleCompactThinkingText };
-
 // pi-tui 类型声明中 TUI 的 re-export 解析失败，本地用最小结构化类型（只用到 requestRender）。
 type RenderTui = { requestRender(force?: boolean): void };
 

package/extensions/feature/context.ts

@@ -184,6 +184,7 @@ export async function showTextPreview(
 							else if (button === 65) scrollTo(scrollOffset + 3);
 						}
 					},
+
 					render(width: number) {
 						const inner = Math.max(1, width - 2);
 						const escWidth = visibleWidth("[esc]");

package/extensions/feature/reference/index.ts

@@ -26,8 +26,6 @@ const MAX_SESSION_SUGGESTIONS = 3;
 const MAX_FILE_SUGGESTIONS = 7;
 const MAX_REFERENCED_SESSIONS = 5;
 const MENTION_PATTERN = /(?:^|[\t ])@([^\s@]*)$/;
-const SUBAGENT_MANAGER_KEY = Symbol.for("pi-subagents:manager");
-
 // ── In-process subagent record tracker ──────────────────────────────
 // pi-subagents does not expose a global manager; we track records
 // ourselves by listening to the events it emits.
@@ -53,17 +51,6 @@ type SessionReference = {
 	messages?: unknown[];
 };
 
-type SubagentRecord = {
-	id: string;
-	description?: string;
-	startedAt?: number;
-	completedAt?: number;
-};
-
-type SubagentManager = {
-	getRecord(id: string): SubagentRecord | undefined;
-};
-
 // Local subagent record tracking (pi-subagents does not expose a global manager).
 const liveSubagentRecords = new Map<string, SubagentLiveRecord>();
 /** Cap retained completed/live records so long-lived pi processes cannot grow unbounded. */
@@ -120,28 +107,6 @@ function trackSubagentFromEvent(data: unknown): void {
 	pruneLiveSubagentRecords();
 }
 
-function getSubagentManager(): SubagentManager | undefined {
-	// Try the global manager first (future-proof), fall back to local records.
-	const manager = (globalThis as Record<PropertyKey, unknown>)[SUBAGENT_MANAGER_KEY] as
-		| SubagentManager
-		| undefined;
-	if (manager && typeof manager.getRecord === "function") return manager;
-	// If no global manager, use our local tracking.
-	if (liveSubagentRecords.size === 0) return undefined;
-	return {
-		getRecord(id: string): SubagentRecord | undefined {
-			const record = liveSubagentRecords.get(id);
-			if (!record) return undefined;
-			return {
-				id: record.runId,
-				description: record.agent || undefined,
-				startedAt: record.startedAt,
-				completedAt: record.completedAt,
-			};
-		},
-	};
-}
-
 function extractMentionQuery(textBeforeCursor: string): string | undefined {
 	return textBeforeCursor.match(MENTION_PATTERN)?.[1];
 }
@@ -281,31 +246,20 @@ function liveSubagentReferences(
 	agentIds: Set<string>,
 	currentSessionId: string,
 ): SessionReference[] {
-	const manager = getSubagentManager();
-	if (!manager) return [];
-
 	const references: SessionReference[] = [];
 	for (const agentId of agentIds) {
-		const record = manager.getRecord(agentId);
-		if (!record) continue;
-
-		// Try the global manager's live session first (future-proof).
-		const liveRecord = liveSubagentRecords.get(agentId);
-		const sessionId = liveRecord?.sessionId ?? record.id;
-		if (!sessionId || sessionId === currentSessionId) continue;
-
-		const name = record.description?.trim() || liveRecord?.agent || undefined;
-		const modifiedAt = record.completedAt ?? record.startedAt ?? Date.now();
+		const record = liveSubagentRecords.get(agentId);
+		if (!record || record.sessionId === currentSessionId) continue;
 		references.push({
 			kind: "subagent",
-			referenceIds: [sessionId, agentId],
+			referenceIds: [record.sessionId, agentId],
 			info: {
-				id: sessionId,
-				name,
-				cwd: liveRecord?.cwd ?? "",
+				id: record.sessionId,
+				name: record.agent || undefined,
+				cwd: record.cwd,
 				firstMessage: "",
 				messageCount: 0,
-				modified: new Date(modifiedAt),
+				modified: new Date(record.completedAt ?? record.startedAt),
 			},
 		});
 	}

package/extensions/feature/reference/session.ts

@@ -1,8 +1,7 @@
 export const SESSION_REFERENCE_CUSTOM_TYPE = "session-reference";
 export const SESSION_REFERENCE_PREFIX = "@session:";
 
-const SESSION_REFERENCE_PATTERN =
-	/(?:^|\s)@session:(?:\[([^\]]+)\]|([A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?))(?![\w.\]-])/g;
+const SESSION_REFERENCE_PATTERN = /(?:^|\s)@session:\[([^\]]+)](?![\w-])/g;
 const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f]/g;
 
 export interface ReferenceSessionInfo {
@@ -31,13 +30,12 @@ export const DEFAULT_REFERENCE_LIMITS: ReferenceLimits = {
 	maxTotalBytes: 48_000,
 };
 
-/** 提取 @session:[name]（组 1）或旧格式 @session:id（组 2），返回 name 或 id。 */
 export function extractSessionReferenceIds(text: string): string[] {
 	const ids: string[] = [];
 	const seen = new Set<string>();
 
 	for (const match of text.matchAll(SESSION_REFERENCE_PATTERN)) {
-		const id = (match[1] ?? match[2])?.trim();
+		const id = match[1]?.trim();
 		if (id && !seen.has(id)) {
 			seen.add(id);
 			ids.push(id);
@@ -250,13 +248,3 @@ export function buildReferenceContentFromSections(
 	].join("\n");
 	return truncateUtf8([header, ...sections].join("\n\n"), maxTotalBytes);
 }
-
-export function buildReferenceContent(
-	sources: ReferenceSource[],
-	limits: ReferenceLimits = DEFAULT_REFERENCE_LIMITS,
-): string {
-	return buildReferenceContentFromSections(
-		sources.map((source) => formatReferenceSession(source, limits)),
-		limits.maxTotalBytes,
-	);
-}

package/extensions/feature/shell/flush-docked-bash.ts

@@ -0,0 +1,36 @@
+/**
+ * fullscreen 下 ! / !! 在 agent 仍 streaming 时挂到 dock（pendingMessages）。
+ * 官方只在下次普通 submit 才 flushPendingBashComponents，命令结束后卡钉在输入框上方。
+ * 在 handleBashCommand 收尾补一次 flush。
+ */
+import { InteractiveMode } from "@earendil-works/pi-coding-agent";
+import { FLUSH_DOCKED_BASH_PATCH, patchRegistry } from "../../utils/patch-keys.ts";
+
+type Patch = {
+	active: boolean;
+	prototype: any;
+	original: (...args: any[]) => unknown;
+	installed: (...args: any[]) => unknown;
+};
+
+export function installFlushDockedBash(): void {
+	const prototype = InteractiveMode.prototype as any;
+	const previous = patchRegistry.get<Patch>(FLUSH_DOCKED_BASH_PATCH);
+	if (previous) previous.active = false;
+	const original =
+		previous && prototype.handleBashCommand === previous.installed
+			? previous.original
+			: prototype.handleBashCommand;
+	const patch: Patch = {
+		active: true,
+		prototype,
+		original,
+		installed: async function (this: any, ...args: any[]) {
+			const result = await original.apply(this, args);
+			if (patch.active) this.flushPendingBashComponents();
+			return result;
+		},
+	};
+	prototype.handleBashCommand = patch.installed;
+	patchRegistry.install(FLUSH_DOCKED_BASH_PATCH, patch);
+}

package/extensions/feature/shell/startup-header.ts

@@ -3,6 +3,7 @@ import { getKeybindings } from "@earendil-works/pi-tui";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { config } from "../../config/config.ts";
 import { ansi16ToRgb, ansi256ToRgb } from "../../utils/ansi-color.ts";
+import { stripAnsi } from "../../utils/ansi-text.ts";
 type Rgb = [number, number, number];
 type StyledPart = {
 	raw: string;
@@ -10,8 +11,6 @@ type StyledPart = {
 };
 
 const ANSI_RESET = "\x1b[0m";
-const ANSI_PATTERN =
-	/[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g;
 
 // 官方 install.sh 静态 logo（4 行原样，短行补尾随空格统一到 8 列）+ 底部空行补到 5 行，
 // 与右侧 tips 行数等高；着色保持现状（accent 渐变）
@@ -40,10 +39,6 @@ const PALETTE_SPAN = 0.25;
 // 行间相位偏移：小步累加 → 整体左上暗→右下亮的对角渐变
 const LOGO_ROW_PHASE_STEP = 0.08;
 
-function stripAnsi(text: string): string {
-	return text.replace(ANSI_PATTERN, "");
-}
-
 function getVisibleLength(text: string): number {
 	return [...stripAnsi(text)].length;
 }

package/extensions/index.ts

@@ -3,6 +3,7 @@ import { config } from "./config/config.ts";
 
 // shell
 import piAliases from "./feature/shell/aliases.ts";
+import { installFlushDockedBash } from "./feature/shell/flush-docked-bash.ts";
 import piStartupHeader from "./feature/shell/startup-header.ts";
 import workingMessage from "./feature/shell/working-message.ts";
 
@@ -20,6 +21,7 @@ import markdownEnhance from "./renderer/markdown-enhance.ts";
 export default function (pi: ExtensionAPI): void {
 	// shell chrome
 	if (config.enableAliases) piAliases(pi);
+	installFlushDockedBash();
 	piStartupHeader(pi);
 	if (config.enableWorkingMessage) workingMessage(pi);