pi-cc-extensions 0.5.6 → 0.7.0

package/README.md

@@ -4,7 +4,7 @@
 
 <p align="center">
   <a href="#安装"><img alt="Pi package" src="https://img.shields.io/badge/Pi-package-58B7FF?style=flat-square"></a>
-  <a href="./package.json"><img alt="Version 0.2.0" src="https://img.shields.io/badge/version-0.2.0-66E3C4?style=flat-square"></a>
+  <a href="./package.json"><img alt="Version 0.5.6" src="https://img.shields.io/badge/version-0.5.6-66E3C4?style=flat-square"></a>
   <a href="#兼容性"><img alt="Node.js 22.19 or newer" src="https://img.shields.io/badge/Node.js-%E2%89%A522.19-66E3C4?style=flat-square"></a>
   <a href="./extensions"><img alt="TypeScript extensions" src="https://img.shields.io/badge/TypeScript-extensions-3178C6?style=flat-square"></a>
 </p>
@@ -15,10 +15,15 @@
 
 ---
 
-## 截图
+## 界面预览
 
 <table>
   <tr>
+    <td width="50%" align="center">
+      <img src="./assets/readme/fixed-editor-navigation.webp" width="100%" alt="Pi fixed-editor 中的工具结果、回到底部按钮与 Ctrl+End 快捷键">
+      <br>
+      <sub><b>固定编辑器工作流</b><br>工具结果摘要、折叠展开与键盘导航</sub>
+    </td>
     <td width="50%" align="center">
       <img src="./assets/readme/session-reference.webp" width="100%" alt="在 Pi 中通过 @ 补全选择历史 Session">
       <br>
@@ -54,10 +59,10 @@
 常用命令：
 
 ```text
-/ccstyle             # 切换开关
+/ccstyle             # 打开交互式配置面板
+/ccstyle on          # 开启
+/ccstyle off         # 关闭
 /ccstyle status      # 查看状态
-/ccstyle compact     # 紧凑摘要
-/ccstyle minimal     # 最小化输出
 ```
 
 ### 上下文窗口查看
@@ -82,6 +87,16 @@
 
 Session 模糊查询默认显示 5 个候选；若已加载 `pi-subagents`，也可直接引用现有 SubAgent。一次提示词可以引用多个 Session；扩展会自动去重，并限制注入规模以避免上下文无限膨胀。更多细节见 [`extensions/session-reference/README.md`](./extensions/session-reference/README.md)。
 
+### SubAgent `@` 补全
+
+`extensions/agent-autocomplete.ts` 将 `~/.pi/agent/agents/*.md` 中定义的 SubAgent 接入 `@` 补全：
+
+1. 在提示词中输入 `@agent-name`。
+2. 从补全列表中选择 SubAgent。
+3. 提交后自动注入委托指令；提示词中提到的每个 SubAgent 都会分别交由 Agent 工具处理。
+
+该补全不会占用 `@session:` 的历史 Session 引用语法；修改 SubAgent 定义后执行 `/reload` 即可重新加载。
+
 ## 安装
 
 从 npm 安装（推荐）：
@@ -100,7 +115,7 @@ pi install git:github.com/minuque/pi-cc-extensions
 
 ```text
 /context
-/ccstyle status
+/ccstyle on
 ```
 
 ## 本地开发
@@ -126,20 +141,3 @@ pi install /absolute/path/to/pi-cc-extensions
 
 - Node.js `>=22.19.0`
 - 作为 Pi package 加载，入口由根目录 `package.json` 的 `pi.extensions` 显式声明
-
-## 发布
-
-发布前检查：
-
-```bash
-npm test
-npm pack --dry-run
-```
-
-使用 npm 发布。未指定 tag 时使用 `latest`：
-
-```bash
-npm run release
-npm run release -- --tag next
-npm run release -- --tag beta
-```

package/extensions/claude-code-style.ts

@@ -9,10 +9,11 @@ import {
 	createWriteToolDefinition,
 	generateDiffString,
 	keyHint,
+	getSettingsListTheme,
 	renderDiff,
 	ToolExecutionComponent,
 } from "@earendil-works/pi-coding-agent";
-import { Text, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import { Container, SettingsList, Text, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
 import { homedir } from "node:os";
@@ -26,22 +27,17 @@ import { join, resolve } from "node:path";
  * expand only that tool.
  *
  * Dynamic commands:
- *   /ccstyle              toggle on/off
+ *   /ccstyle              open interactive settings
  *   /ccstyle on           enable
  *   /ccstyle off          disable
  *   /ccstyle status       show current state
- *   /ccstyle minimal      hide most tool output in collapsed view
- *   /ccstyle compact      show short summaries in collapsed view
  *
  * Shortcut:
  *   ctrl+shift+o          toggle on/off
  */
 
-type StyleMode = "compact" | "minimal";
-
 type Config = {
 	enabled: boolean;
-	mode: StyleMode;
 };
 
 const CONFIG_PATH = join(homedir(), ".pi", "agent", "claude-code-style.json");
@@ -54,13 +50,12 @@ function loadConfig(): Config {
 			const parsed = JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Partial<Config>;
 			return {
 				enabled: parsed.enabled ?? true,
-				mode: parsed.mode === "minimal" ? "minimal" : "compact",
 			};
 		}
 	} catch {
 		// Ignore bad config and fall back to defaults.
 	}
-	return { enabled: true, mode: "compact" };
+	return { enabled: true };
 }
 
 function saveConfig() {
@@ -331,6 +326,7 @@ let scrollButtonWidget: any = null;
 let pendingScrollMessages = 0;
 let assistantMessageActive = false;
 let scrollButtonSyncScheduled = false;
+let resumeRenderTimer: ReturnType<typeof setTimeout> | null = null;
 
 function parseSgrMousePackets(data: string): SgrMousePacket[] | null {
 	const pattern = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
@@ -592,15 +588,14 @@ function hideScrollButton(tui: any): void {
 }
 
 function scheduleScrollButtonSync(tui: any, data: string): void {
-	if (!scrollButtonVisible || !isScrollNavigationInput(data) || scrollButtonSyncScheduled) return;
+	if (!isScrollNavigationInput(data) || scrollButtonSyncScheduled) return;
 	scrollButtonSyncScheduled = true;
 	const previousLines = tui.previousLines;
 	const check = (attempt: number) => {
 		scrollButtonSyncScheduled = false;
-		if (toolMouseTui !== tui || !scrollButtonVisible) return;
-		// Pi renders on its own frame timer. Do not inspect the old visible window
-		// before Zentui has applied the new scroll offset, or PageUp at bottom would
-		// immediately hide the button it just requested.
+		if (toolMouseTui !== tui) return;
+		// Pi renders on its own frame timer. Inspect the resulting viewport before
+		// showing the button so empty or non-scrollable transcripts never flash it.
 		const rendered = tui.previousLines !== previousLines;
 		if (!rendered && attempt < 4) {
 			scrollButtonSyncScheduled = true;
@@ -610,35 +605,20 @@ function scheduleScrollButtonSync(tui: any, data: string): void {
 			}
 			return;
 		}
-		if (isFixedEditorAtBottom(tui)) hideScrollButton(tui);
+		const nextVisible = !isFixedEditorAtBottom(tui);
+		if (!nextVisible) pendingScrollMessages = 0;
+		if (nextVisible !== scrollButtonVisible) {
+			scrollButtonVisible = nextVisible;
+			tui.requestRender?.();
+		}
 	};
 	process.nextTick(() => check(0));
 }
 
 function updateScrollButtonFromInput(tui: any, data: string): void {
 	if (!isFixedEditorTui(tui)) return;
-
-	let movedUp = matchesKey(data, "pageUp") || ZENTUI_PAGE_UP_INPUT.test(data);
-	const packets = parseSgrMousePackets(data);
-	if (packets) {
-		movedUp = packets.some((packet) => {
-			const baseButton = packet.code & ~(4 | 8 | 16 | 32);
-			return packet.final === "M" && baseButton === 64;
-		});
-	}
-
-	const jumpedBottom =
-		matchesKey(data, "enter")
-		|| matchesKey(data, "return")
-		|| isScrollBottomInput(data);
-	if (jumpedBottom) {
+	if (matchesKey(data, "enter") || matchesKey(data, "return") || isScrollBottomInput(data)) {
 		hideScrollButton(tui);
-		return;
-	}
-	const nextVisible = movedUp ? true : scrollButtonVisible;
-	if (nextVisible !== scrollButtonVisible) {
-		scrollButtonVisible = nextVisible;
-		tui.requestRender?.();
 	}
 }
 
@@ -842,6 +822,8 @@ function patchToolMouseInputCapture(tui: any): void {
 		const data = args[0];
 		if (typeof data === "string") {
 			updateScrollButtonFromInput(this, data);
+			// Capture the current viewport before Pi/Zentui applies the scroll input.
+			scheduleScrollButtonSync(this, data);
 			if (isFixedEditorTui(this) && isScrollBottomInput(data) && jumpToBottomWithoutSubmit(this)) return;
 			const packets = parseSgrMousePackets(data);
 			if (packets) {
@@ -906,6 +888,10 @@ function handleToolMouseInput(data: string): { consume: true } | undefined {
 }
 
 function teardownToolMouseInteraction(): void {
+	if (resumeRenderTimer) {
+		clearTimeout(resumeRenderTimer);
+		resumeRenderTimer = null;
+	}
 	toolMouseInputUnsubscribe?.();
 	toolMouseInputUnsubscribe = null;
 	try {
@@ -948,6 +934,19 @@ function installToolMouseInteraction(ctx: any): void {
 	toolMouseInputUnsubscribe = ctx.ui.onTerminalInput(handleToolMouseInput);
 }
 
+function scheduleResumeRender(): void {
+	const tui = toolMouseTui;
+	if (!tui || typeof tui.requestRender !== "function") return;
+	if (resumeRenderTimer) clearTimeout(resumeRenderTimer);
+	// /resume rebuilds the transcript while later session_start handlers may still
+	// replace UI components. Repaint after that turn so the restored messages are
+	// not left hidden until the next editor input event.
+	resumeRenderTimer = setTimeout(() => {
+		resumeRenderTimer = null;
+		if (toolMouseTui === tui) tui.requestRender(true);
+	}, 0);
+}
+
 // Bright green for success icon (truecolor ANSI escape)
 const BRIGHT_GREEN = "\x1b[38;2;80;220;100m";
 const ANSI_RESET = "\x1b[0m";
@@ -1096,12 +1095,49 @@ function renderFileDiffPreview(_toolName: string, _args: any, theme: any, contex
 	return renderDiffPreview(state.ccstyleDiffPreview, theme, isToolExpanded(undefined, context));
 }
 
-function statusText() {
-	return config.enabled ? `CC ${config.mode}` : "CC off";
+function applyEnabledState(enabled: boolean, ctx: any): void {
+	config.enabled = enabled;
+	saveConfig();
+	ctx.ui.notify(`Claude Code style: ${enabled ? "on" : "off"}`, "info");
 }
 
-function updateStatus(ctx: any) {
-	ctx.ui.setStatus("ccstyle", statusText());
+async function showCcstylePanel(ctx: any): Promise<void> {
+	if (ctx?.mode !== "tui" || !ctx?.hasUI || typeof ctx.ui?.custom !== "function") {
+		ctx.ui?.notify?.("/ccstyle requires TUI mode", "warning");
+		return;
+	}
+
+	await ctx.ui.custom((tui: any, theme: any, _keybindings: any, done: (value?: void) => void) => {
+		const container = new Container();
+		container.addChild(new Text(theme.fg("accent", theme.bold("Claude Code Style")), 1, 1));
+		const settingsList = new SettingsList(
+			[{
+				id: "enabled",
+				label: "Output style",
+				description: "Use compact Claude Code-like tool rendering",
+				currentValue: config.enabled ? "on" : "off",
+				values: ["on", "off"],
+			}],
+			3,
+			getSettingsListTheme(),
+			(id: string, newValue: string) => {
+				if (id !== "enabled" || (newValue !== "on" && newValue !== "off")) return;
+				applyEnabledState(newValue === "on", ctx);
+				settingsList.updateValue(id, newValue);
+				tui.requestRender();
+			},
+			() => done(),
+		);
+		container.addChild(settingsList);
+		return {
+			render: (width: number) => container.render(width),
+			invalidate: () => container.invalidate(),
+			handleInput(data: string) {
+				settingsList.handleInput?.(data);
+				tui.requestRender();
+			},
+		};
+	});
 }
 
 function renderDefault(tool: any, slot: "renderCall" | "renderResult", args: any[], fallback = "") {
@@ -1207,14 +1243,7 @@ function createCcstyleTool(originalTool: any): any {
 			const expanded = isToolExpanded(options, context);
 
 			const text = textFromResult(result);
-			let rendered = "";
-			if (config.mode === "minimal" && !expanded) {
-				rendered = "";
-			} else if (!expanded) {
-				rendered = text ? oneLine(text, 96) : "Done";
-			} else {
-				rendered = text;
-			}
+			const rendered = !expanded ? (text ? oneLine(text, 96) : "Done") : text;
 
 			const hint = !expanded && hasExpandableResult(text) ? expandHint(theme) : "";
 			if (expanded) return renderExpandedToolResult(rendered, theme, isError);
@@ -1509,35 +1538,25 @@ export default function (pi: ExtensionAPI) {
 			const topLevel = [
 				{ value: "on", label: "on", description: "Enable Claude Code style" },
 				{ value: "off", label: "off", description: "Disable Claude Code style" },
-				{ value: "status", label: "status", description: "Show current toggle and mode" },
-				{ value: "minimal", label: "minimal", description: "Hide most tool output in collapsed view" },
-				{ value: "compact", label: "compact", description: "Show short summaries in collapsed view" },
+				{ value: "status", label: "status", description: "Show current state" },
 			];
 			return topLevel.filter((item) => item.value.startsWith(prefix));
 		},
 		handler: async (args, ctx) => {
 			const arg = args.trim().toLowerCase();
-			if (arg === "on" || arg === "enable") config.enabled = true;
-			else if (arg === "off" || arg === "disable") config.enabled = false;
-			else if (arg === "minimal") {
-				config.enabled = true;
-				config.mode = "minimal";
-			} else if (arg === "compact") {
-				config.enabled = true;
-				config.mode = "compact";
-			} else if (arg === "status") {
-				updateStatus(ctx);
-				ctx.ui.notify(
-					`Claude Code style: ${config.enabled ? "on" : "off"}, mode=${config.mode}`,
-					"info",
-				);
+			if (!arg) {
+				await showCcstylePanel(ctx);
 				return;
-			} else {
-				config.enabled = !config.enabled;
 			}
-			saveConfig();
-			updateStatus(ctx);
-			ctx.ui.notify(`Claude Code style: ${config.enabled ? "on" : "off"}, mode=${config.mode}`, "info");
+			if (arg === "on" || arg === "off") {
+				applyEnabledState(arg === "on", ctx);
+				return;
+			}
+			if (arg === "status") {
+				ctx.ui.notify(`Claude Code style: ${config.enabled ? "on" : "off"}`, "info");
+				return;
+			}
+			ctx.ui.notify("Usage: /ccstyle [on|off|status]", "warning");
 		},
 	});
 
@@ -1546,17 +1565,17 @@ export default function (pi: ExtensionAPI) {
 		handler: async (ctx) => {
 			config.enabled = !config.enabled;
 			saveConfig();
-			updateStatus(ctx);
 			ctx.ui.notify(`Claude Code style: ${config.enabled ? "on" : "off"}`, "info");
 		},
 	});
 
-	pi.on("session_start", async (_event, ctx) => {
+	pi.on("session_start", async (event, ctx) => {
 		diffPreviewByCall.clear();
 		pendingScrollMessages = 0;
 		assistantMessageActive = false;
-		updateStatus(ctx);
+		ctx.ui.setStatus("ccstyle", undefined);
 		installToolMouseInteraction(ctx);
+		if (event?.reason === "resume") scheduleResumeRender();
 	});
 
 	pi.on("message_start", async (event) => {
@@ -1584,7 +1603,6 @@ export default function (pi: ExtensionAPI) {
 		call: (args) => fileAction(args, "Read"),
 		result: (result, { expanded }) => {
 			const text = textFromResult(result);
-			if (config.mode === "minimal" && !expanded) return "";
 			if (!expanded) return `${countLines(text)} lines read`;
 			return text;
 		},
@@ -1594,7 +1612,6 @@ export default function (pi: ExtensionAPI) {
 		call: (args) => `Bash(${oneLine(args?.command, 86) || "..."})`,
 		result: (result, { expanded }) => {
 			const text = textFromResult(result).trim();
-			if (config.mode === "minimal" && !expanded) return "";
 			if (!expanded) return summarizeBash(text);
 			return text;
 		},
@@ -1606,7 +1623,6 @@ export default function (pi: ExtensionAPI) {
 		diffAfterResult: true,
 		result: (result, { expanded }, _theme, context) => {
 			const text = textFromResult(result).trim();
-			if (config.mode === "minimal" && !expanded) return "";
 			return summarizeDiffStats(context?.state?.ccstyleDiffPreview) ?? summarizeEdit(text);
 		},
 	});
@@ -1621,7 +1637,6 @@ export default function (pi: ExtensionAPI) {
 		diffAfterResult: true,
 		result: (result, { expanded }, _theme, context) => {
 			const text = textFromResult(result).trim();
-			if (config.mode === "minimal" && !expanded) return "";
 			return summarizeDiffStats(context?.state?.ccstyleDiffPreview) ?? (text ? oneLine(text, 96) : "Written");
 		},
 	});
@@ -1630,7 +1645,6 @@ export default function (pi: ExtensionAPI) {
 		call: (args) => `Find(${args?.pattern || "..."}${args?.path ? ` in ${shortenPath(args.path)}` : ""})`,
 		result: (result, { expanded }) => {
 			const text = textFromResult(result).trim();
-			if (config.mode === "minimal" && !expanded) return "";
 			if (!expanded) return `${countLines(text)} files`;
 			return text;
 		},
@@ -1640,7 +1654,6 @@ export default function (pi: ExtensionAPI) {
 		call: (args) => `Grep(${args?.pattern ? `/${oneLine(args.pattern, 48)}/` : "..."})`,
 		result: (result, { expanded }) => {
 			const text = textFromResult(result).trim();
-			if (config.mode === "minimal" && !expanded) return "";
 			if (!expanded) {
 				const matches = countLines(text);
 				const files = parsePathCount(text);
@@ -1654,7 +1667,6 @@ export default function (pi: ExtensionAPI) {
 		call: (args) => `List(${shortenPath(args?.path || ".")})`,
 		result: (result, { expanded }) => {
 			const text = textFromResult(result).trim();
-			if (config.mode === "minimal" && !expanded) return "";
 			if (!expanded) return `${countLines(text)} entries`;
 			return text;
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cc-extensions",
-  "version": "0.5.6",
+  "version": "0.7.0",
   "description": "Personal extensions for the Pi coding agent",
   "type": "module",
   "keywords": [