@aiwayds/pi-think-panel 0.1.0 → 0.2.0

package/README.md

@@ -34,18 +34,19 @@ quietly hides itself again.
 
 ## Layout / 布局
 
-Small panel (overlay A) floats top-left while the model is thinking: last 10
-lines, auto-following the newest content, chat stays clean:
+Small panel (overlay A) floats top-left while the model is thinking: last 5
+lines by default (configurable via `PI_THINK_PANEL_MAX_LINES`), auto-following
+the newest content, chat stays clean:
 
-> 小面板（overlay A）：模型思考时浮在左上角，显示最近 10 行，跟随最新内容，
-> 聊天区保持干净。
+> 小面板（overlay A）：模型思考时浮在左上角，默认显示最近 5 行（可通过
+> `PI_THINK_PANEL_MAX_LINES` 配置），跟随最新内容，聊天区保持干净。
 
 ```text
 ┌──────────────────────────────────────────────────────────────┐
 │ ╭─ Thinking…  ⌃O 展开 · ⌃H 隐藏 ────────────────────────╮    │
 │ │  reasoning line 1                                     │    │
 │ │  reasoning line 2                                     │    │
-│ │  … (last 10 lines, follows newest)                    │    │
+│ │  … (last 5 lines, follows newest)                     │    │
 │ ╰───────────────────────────────────────────────────────╯    │
 │                                                              │
 │  chat history stays clean — think text never floods it       │
@@ -116,13 +117,13 @@ Note: ctrl+o is normally reserved for the tools panel (app.tools.expand); this e
 
 ## What it does / 功能
 
-- Captures the model's thinking and shows the last 10 lines in a bordered panel above the input editor; ctrl+o opens a wider full-text view (80% width).
+- Captures the model's thinking and shows the last N lines (default 5, configurable via `PI_THINK_PANEL_MAX_LINES`) in a bordered panel above the input editor; ctrl+o opens a wider full-text view (80% width).
 - Auto-shows while the model is thinking (when thinking is enabled); when no thinking is happening it either hides (default `hide` mode) or keeps showing the last think text (`last` mode).
 - ctrl+h toggles the small panel on/off.
 - When `hideThinkingBlock` is not enabled in settings, the panel title row reminds you that think text is also visible in chat (press Ctrl+T to hide it there).
 - Completed think blocks are separated by a `------` divider in both views — including a trailing divider after the just-finished current block.
 
-> - 捕获模型思考内容，在输入框上方带边框面板显示最近 10 行；ctrl+o 打开更宽的全文视图（80% 宽）。
+> - 捕获模型思考内容，在输入框上方带边框面板显示最近 N 行（默认 5 行，可配置 `PI_THINK_PANEL_MAX_LINES`）；ctrl+o 打开更宽的全文视图（80% 宽）。
 > - 模型思考时自动显示（思考开启时）；无思考时按 `EMPTY_THINK_MODE` 隐藏（默认 `hide`）或保留最后内容（`last`）。
 > - ctrl+h 切换小面板显示/隐藏。
 > - 设置中 `hideThinkingBlock` 未开启时，标题行提示"聊天区也显示 think，可按 Ctrl+T 隐藏"。
@@ -142,6 +143,34 @@ const EMPTY_THINK_MODE: "last" | "hide" = "hide";
 
 Change it and run `/reload` in pi.
 
+Auto-hide delay and panel background are configurable via env vars:
+
+```bash
+export PI_THINK_PANEL_CLOSE_DELAY_MS=5000   # hide 5s after thinking ends (default 1000)
+export PI_THINK_PANEL_BG=toolSuccessBg     # panel background (theme bg color key)
+export PI_THINK_PANEL_MAX_LINES=5          # small-panel line count (default 5)
+export PI_THINK_PANEL_MIN_TERM_ROWS=12     # hide small panel below this terminal height (default MAX_LINES+6)
+```
+
+`PI_THINK_PANEL_MAX_LINES` sets how many of the latest think lines the small
+panel shows (positive integer, default 5).
+
+`PI_THINK_PANEL_MIN_TERM_ROWS` is the minimum terminal height (rows) for the
+small panel: below it the panel hides automatically (and reappears when the
+terminal grows again) — handy when the window is dragged short or the font is
+zoomed in. Default is MAX_LINES + 6.
+
+> `PI_THINK_PANEL_MAX_LINES` 设置小面板显示的最新思考行数（正整数，默认 5）。
+>
+> `PI_THINK_PANEL_MIN_TERM_ROWS` 是小面板可见所需的最小终端高度（行数）：低于
+> 它面板自动隐藏（终端恢复后自动重现）——窗口拖矮或字体放大时很有用。默认
+> MAX_LINES + 6。
+
+`PI_THINK_PANEL_BG` accepts one of pi's theme bg color keys: `selectedBg` /
+`userMessageBg` / `customMessageBg` / `toolPendingBg` / `toolSuccessBg`
+(default) / `toolErrorBg`. Set env vars before starting pi (or before
+`/reload`), then `/reload` to apply.
+
 ## Install / update / 安装与更新
 
 ```bash

package/extensions/pi-think-panel.ts

@@ -9,6 +9,8 @@
  *     auto-following new content as it streams in (a live "details" view);
  *     anchored left so it stays clear of a right-side terminal sidebar.
  * Both overlays are nonCapturing so keyboard focus stays in the editor.
+ * Panel background color is configurable via PI_THINK_PANEL_BG (one of pi's
+ * theme bg keys, default toolSuccessBg).
  *
  * Keys (ctx.ui.onTerminalInput — ctrl+o / escape / x are reserved keys):
  *   ctrl+o  toggle between overlay A (small) and overlay B (full text);
@@ -16,9 +18,10 @@
  *   ctrl+h  toggle overlay A (small panel) on/off (consumed while B is closed)
  * Closing B is another ctrl+o press (back to A); esc and x are never
  * consumed, so typing and stream-abort keep working.
- * Overlay A is visible while the agent is thinking and auto-hides 10s after
- * thinking ends / the turn settles (EMPTY_THINK_MODE "hide", unless manually opened via
- * ctrl+o). If hideThinkingBlock is not enabled in settings, the title shows
+ * Overlay A is visible while the agent is thinking and auto-hides
+ * CLOSE_DELAY_MS (default 1s) after thinking ends / the turn settles
+ * (EMPTY_THINK_MODE "hide", unless manually opened via ctrl+o). If
+ * hideThinkingBlock is not enabled in settings, the title shows
  * a reminder that think text is also visible in chat (Ctrl+T hides it).
  * Never writes user settings.
  */
@@ -38,13 +41,71 @@ import * as path from "path";
 // whitespace; tweak then /reload.
 const PANEL_WIDTH_PCT = "90%";
 // How many lines of think text overlay A shows (history tail + current block).
-const MAX_LINES = 10;
-// Auto-hide delay (ms) after thinking ends / the turn settles.
-const CLOSE_DELAY_MS = 10000;
+// Configurable via PI_THINK_PANEL_MAX_LINES (lines, default 5). Invalid
+// values fall back to the default. Read at module load — /reload to apply.
+const MAX_LINES = readMaxLines();
+
+function readMaxLines(): number {
+	const raw = process.env.PI_THINK_PANEL_MAX_LINES;
+	if (raw === undefined) return 5;
+	const n = Number(raw);
+	return Number.isInteger(n) && n > 0 ? n : 5;
+}
+// Min terminal rows for overlay A. When the terminal is resized shorter
+// than this (window dragged down / font zoomed in), the TUI's visible()
+// callback hides the small panel; it reappears automatically once the
+// terminal is tall enough again. Defaults to panel height + margin
+// (MAX_LINES + 6); override via PI_THINK_PANEL_MIN_TERM_ROWS.
+const MIN_TERM_ROWS = readMinTermRows();
+
+function readMinTermRows(): number {
+	const raw = process.env.PI_THINK_PANEL_MIN_TERM_ROWS;
+	if (raw === undefined) return MAX_LINES + 6;
+	const n = Number(raw);
+	return Number.isInteger(n) && n > 0 ? n : MAX_LINES + 6;
+}
+// Auto-hide delay (ms) after thinking ends / the turn settles. Configurable
+// via PI_THINK_PANEL_CLOSE_DELAY_MS (milliseconds, default 1000). Invalid
+// values fall back to the default. Read at module load — /reload to apply.
+const CLOSE_DELAY_MS = readCloseDelayMs();
+
+function readCloseDelayMs(): number {
+	const raw = process.env.PI_THINK_PANEL_CLOSE_DELAY_MS;
+	if (raw === undefined) return 1000;
+	const ms = Number(raw);
+	return Number.isFinite(ms) && ms >= 0 ? Math.floor(ms) : 1000;
+}
+
+// Background color for both overlays — one of pi's theme bg color keys
+// (see ThemeBg in pi-coding-agent: selectedBg / userMessageBg /
+// customMessageBg / toolPendingBg / toolSuccessBg / toolErrorBg).
+// Configurable via PI_THINK_PANEL_BG; default "toolSuccessBg". Read at
+// module load — /reload to apply.
+const PANEL_BG = readPanelBg();
+
+const THEME_BG_COLORS = [
+	"selectedBg",
+	"userMessageBg",
+	"customMessageBg",
+	"toolPendingBg",
+	"toolSuccessBg",
+	"toolErrorBg",
+] as const;
+type PanelBg = (typeof THEME_BG_COLORS)[number];
+
+function readPanelBg(): PanelBg {
+	const raw = process.env.PI_THINK_PANEL_BG;
+	if (
+		raw !== undefined &&
+		(THEME_BG_COLORS as readonly string[]).includes(raw)
+	)
+		return raw as PanelBg;
+	return "toolSuccessBg";
+}
 
 // What to do when no thinking is happening: "last" keeps overlay A visible
-// with the last think text; "hide" (default) auto-hides it 10s after the turn
-// settles. Change this and /reload to apply.
+// with the last think text; "hide" (default) auto-hides it CLOSE_DELAY_MS
+// after the turn settles. Change this and /reload to apply.
 const EMPTY_THINK_MODE: "last" | "hide" = "hide";
 
 // Layout published by pi-sidebar-panel via globalThis (same process, jiti's
@@ -182,51 +243,51 @@ function titleLine(theme: Theme, hint: string): string {
 /** Overlay A (top-center panel): last MAX_LINES lines, no inner separator. */
 function renderTopPanel(theme: Theme, width: number): string[] {
 	const innerW = Math.max(1, width - 2);
+	const bg = (s: string) => theme.bg(PANEL_BG, s);
 	const border = (s: string) => theme.fg("border", s);
 	const pad = (s: string) => truncateToWidth(s, innerW, "...", true);
+	// Rows are exactly `width` visible chars (pad=true + 2 border cols), so bg
+	// covers the full panel area including padding and borders.
+	const row = (s: string) => bg(border("│") + pad(s) + border("│"));
 	// Think lines use the chat code-block color (mdCodeBlock) + 2-space indent,
 	// matching pi's markdown code-block idiom so think text reads as code.
 	const code = (s: string) => theme.fg("mdCodeBlock", s);
 	const rows: string[] = [];
-	rows.push(border("┌" + "─".repeat(innerW) + "┐"));
-	rows.push(
-		border("│") + pad(titleLine(theme, " ⌃O 展开 · ⌃H 隐藏")) + border("│"),
-	);
+	rows.push(bg(border("┌" + "─".repeat(innerW) + "┐")));
+	rows.push(row(titleLine(theme, " ⌃O 展开 · ⌃H 隐藏")));
 	const text = fullThinkText();
 	const lines = text ? text.split(/\r?\n/).slice(-MAX_LINES) : [];
 	if (lines.length === 0) {
-		rows.push(
-			border("│") + pad(theme.fg("dim", " (no thinking yet)")) + border("│"),
-		);
+		rows.push(row(theme.fg("dim", " (no thinking yet)")));
 	} else {
 		for (const l of lines)
 			rows.push(
-				border("│") +
-					pad(l === "------" ? theme.fg("dim", "  ------") : code("  " + l)) +
-					border("│"),
+				row(l === "------" ? theme.fg("dim", "  ------") : code("  " + l)),
 			);
 	}
-	rows.push(border("└" + "─".repeat(innerW) + "┘"));
+	rows.push(bg(border("└" + "─".repeat(innerW) + "┘")));
 	return rows;
 }
 
 /** Overlay B (centered full-text): every line, capped so the hint stays visible. */
 function renderFullPanel(theme: Theme, width: number): string[] {
 	const innerW = Math.max(1, width - 2);
+	const bg = (s: string) => theme.bg(PANEL_BG, s);
 	const border = (s: string) => theme.fg("border", s);
 	const pad = (s: string) => truncateToWidth(s, innerW, "...", true);
+	// Rows are exactly `width` visible chars (pad=true + 2 border cols), so bg
+	// covers the full panel area including padding and borders.
+	const row = (s: string) => bg(border("│") + pad(s) + border("│"));
 	// Think lines use the chat code-block color (mdCodeBlock) + 2-space indent,
 	// matching pi's markdown code-block idiom so think text reads as code.
 	const code = (s: string) => theme.fg("mdCodeBlock", s);
 	const rows: string[] = [];
-	rows.push(border("┌" + "─".repeat(innerW) + "┐"));
-	rows.push(border("│") + pad(titleLine(theme, "  ⌃O 收起")) + border("│"));
+	rows.push(bg(border("┌" + "─".repeat(innerW) + "┐")));
+	rows.push(row(titleLine(theme, "  ⌃O 收起")));
 	const text = fullThinkText();
 	const lines = text ? text.split(/\r?\n/) : [];
 	if (lines.length === 0) {
-		rows.push(
-			border("│") + pad(theme.fg("dim", " (no thinking yet)")) + border("│"),
-		);
+		rows.push(row(theme.fg("dim", " (no thinking yet)")));
 	} else {
 		// maxHeight is 90% of terminal rows — cap the body so the hint (and the
 		// bottom border) are not hard-truncated by the TUI. Show the TAIL so the
@@ -236,18 +297,14 @@ function renderFullPanel(theme: Theme, width: number): string[] {
 		const maxBody = Math.max(2, Math.floor(termRows * 0.9) - 4);
 		const shown = lines.length > maxBody ? lines.slice(-maxBody) : lines;
 		if (lines.length > maxBody) {
-			rows.push(
-				border("│") + pad(theme.fg("dim", " …(更早内容已省略)")) + border("│"),
-			);
+			rows.push(row(theme.fg("dim", " …(更早内容已省略)")));
 		}
 		for (const l of shown)
 			rows.push(
-				border("│") +
-					pad(l === "------" ? theme.fg("dim", "  ------") : code("  " + l)) +
-					border("│"),
+				row(l === "------" ? theme.fg("dim", "  ------") : code("  " + l)),
 			);
 	}
-	rows.push(border("└" + "─".repeat(innerW) + "┘"));
+	rows.push(bg(border("└" + "─".repeat(innerW) + "┘")));
 	return rows;
 }
 
@@ -459,6 +516,8 @@ export default function (pi: ExtensionAPI): void {
 					anchor: "top-left",
 					offsetX: 1,
 					offsetY: 1,
+					// Terminal too short → hide the panel (auto-restores on resize).
+					visible: (_cols, rows) => rows >= MIN_TERM_ROWS,
 					width: mountedAWidth,
 					nonCapturing: true,
 				},
@@ -538,6 +597,7 @@ export default function (pi: ExtensionAPI): void {
 					anchor: "top-left",
 					offsetX: 1,
 					offsetY: 1,
+					visible: (_cols, rows) => rows >= MIN_TERM_ROWS,
 					width,
 					nonCapturing: true,
 				},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/pi-think-panel",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "pi-coding-agent extension — toggleable floating 'think' content panel showing live reasoning, ctrl+o for full-text view",
   "keywords": [
     "pi-package",
@@ -13,6 +13,9 @@
   "license": "MIT",
   "author": "fan56",
   "main": "extensions/pi-think-panel.ts",
+  "pi": {
+    "extensions": ["extensions/pi-think-panel.ts"]
+  },
   "files": [
     "extensions",
     "README.md",