pi-one-ui 0.1.1

package/extensions/tools/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/extensions/tools/ansi-text.ts

@@ -0,0 +1,52 @@
+/**
+ * 顶层共享的 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(
+    /^((?:\x1b\[[0-9;]*m|[ \t]|[├└│─])*)(?:\x1b\[[0-9;]*m)*(?:[✓✗●○■⬤•·])(?:\x1b\[[0-9;]*m)*\s+/,
+    "$1",
+  );
+}

package/extensions/tools/component-tree.ts

@@ -0,0 +1,37 @@
+/**
+ * 组件树递归遍历共享实现。
+ *
+ * 收敛原先散落在 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/extensions/tools/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/extensions/tools/fullscreen-detect.ts

@@ -0,0 +1,11 @@
+/**
+ * 官方 0.84+ 的 tui 引用是惰性 Proxy（createInteractiveTuiReference）：
+ * 函数属性每次 get 都返回新包装，执行时才解析到当前实现。
+ * 通过它捕获 doRender/render/handleInput 会解析到自身形成无限递归，
+ * 因此检测到惰性 Proxy 时必须跳过所有"捕获后包装"类 patch。
+ */
+export function isLazyProxyTui(tui: any): boolean {
+  if (!tui || typeof tui !== "object") return false;
+  const probe = tui.requestRender;
+  return typeof probe === "function" && probe !== tui.requestRender;
+}

package/extensions/tools/patch-keys.ts

@@ -0,0 +1,158 @@
+/**
+ * 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 展开状态（实例标记；description 供旧模块按 symbol.description 清理） ──
+export const ASSISTANT_SET_EXPANDED_DESCRIPTION =
+  "pi.ccstyle.compact-assistant-set-expanded";
+export const ASSISTANT_TOGGLE_ROUND_DESCRIPTION =
+  "pi.ccstyle.compact-assistant-toggle-round";
+export const ASSISTANT_REENTRY_DESCRIPTION =
+  "pi.ccstyle.compact-assistant-reentry";
+export const ASSISTANT_SET_EXPANDED_KEY = Symbol.for(
+  ASSISTANT_SET_EXPANDED_DESCRIPTION,
+);
+export const ASSISTANT_TOGGLE_ROUND_KEY = Symbol.for(
+  ASSISTANT_TOGGLE_ROUND_DESCRIPTION,
+);
+export const ASSISTANT_REENTRY_KEY = Symbol.for(ASSISTANT_REENTRY_DESCRIPTION);
+
+// ── 工具渲染补丁 ──
+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",
+);
+
+// ── 消息组件补丁 ──
+export const MESSAGE_DISPLAY_PATCH = Symbol.for(
+  "pi.ccstyle.message-display-patch",
+);
+
+// ── 压缩渲染补丁（/reload 残留 deactivate 用） ──
+export const GLOBAL_COMPACTION_RENDER_PATCH = Symbol.for(
+  "pi.ccstyle.compaction-render-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",
+);
+
+// ── 鼠标交互 ──
+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 FLUSH_DOCKED_BASH_PATCH = Symbol.for(
+  "pi.ccstyle.flush-docked-bash-patch",
+);
+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/extensions/tools/sgr-mouse.ts

@@ -0,0 +1,59 @@
+/**
+ * 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;
+}
+
+/** 剥离修饰键位（4/8/16/32：shift/meta/ctrl/motion），得到基础按键码。 */
+export function mouseBaseButton(code: number): number {
+  return code & ~(4 | 8 | 16 | 32);
+}

package/extensions/tools/tool-loading-icon.ts

@@ -0,0 +1,20 @@
+export const TOOL_LOADING_INTERVAL_MS = 80;
+
+const BRAILLE_LOADING_FRAMES = [
+  "⠋",
+  "⠙",
+  "⠹",
+  "⠸",
+  "⠼",
+  "⠴",
+  "⠦",
+  "⠧",
+  "⠇",
+  "⠏",
+];
+
+export function toolLoadingIcon(now = Date.now()): string {
+  return BRAILLE_LOADING_FRAMES[
+    Math.floor(now / TOOL_LOADING_INTERVAL_MS) % BRAILLE_LOADING_FRAMES.length
+  ]!;
+}

package/extensions/tools/tool-result-sanitize.ts

@@ -0,0 +1,27 @@
+const UNSAFE_TERMINAL_ESCAPE = new RegExp(
+  "(?:\\u001B\\]|\\u009D)[\\s\\S]*?(?:\\u0007|\\u001B\\x5C|\\u009C)" +
+    "|(?:\\u001B[PX^_]|\\u0090)[\\s\\S]*?(?:\\u001B\\x5C|\\u009C)" +
+    "|(?:\\u001B\\[|\\u009B)[0-?]*[ -/]*[@-~]" +
+    "|\\u001B[@-_]",
+  "g",
+);
+
+/**
+ * Prevent captured terminal control responses from being replayed by tool renderers.
+ * Optional `maxChars` trims the input first so preview/one-line paths never scan multi-MB outputs.
+ */
+export function sanitizeToolResultText(
+  value: string,
+  maxChars?: number,
+): string {
+  const source =
+    typeof maxChars === "number" && maxChars >= 0 && value.length > maxChars
+      ? value.slice(0, maxChars)
+      : value;
+  return source
+    .replace(UNSAFE_TERMINAL_ESCAPE, "")
+    .replace(/\x1B/g, "")
+    .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F]/g, "")
+    .replace(/\r\n/g, "\n")
+    .replace(/\r/g, "\n");
+}

package/extensions/transcript/index.ts

@@ -0,0 +1,65 @@
+import type {
+  ExtensionAPI,
+  ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { config } from "../app/config/renderer.ts";
+
+// shell
+import piAliases from "../features/shell/aliases.ts";
+import { installFlushDockedBash } from "../features/shell/flush-docked-bash.ts";
+import piStartupHeader from "../features/shell/startup-header.ts";
+import workingMessage from "../features/shell/working-message.ts";
+
+// feature
+import agentAutocomplete from "../features/reference/subagent.ts";
+import agentSummary from "../features/agent-summary/index.ts";
+import context from "../features/context.ts";
+import sessionReference from "../features/reference/index.ts";
+import { installCompactThinking } from "../features/compact-thinking.ts";
+
+// renderer
+import registerTranscriptRenderer, {
+  getCompactThinkingConfig,
+} from "./renderer/index.ts";
+import markdownEnhance from "./renderer/markdown-enhance.ts";
+
+export type TranscriptRuntimeController = {
+  setMode: (mode: "on" | "compact" | "off", ctx: ExtensionContext) => void;
+  updateConfig: (
+    partial: Partial<typeof config>,
+    ctx: ExtensionContext,
+  ) => void;
+};
+
+export type TranscriptExtensionOptions = {
+  /** Expose live transcript refresh to the unified settings panel. */
+  onRuntimeController?: (controller: TranscriptRuntimeController) => void;
+};
+
+export default function (
+  pi: ExtensionAPI,
+  options: TranscriptExtensionOptions = {},
+): void {
+  // shell chrome
+  if (config.enableAliases) piAliases(pi);
+  installFlushDockedBash();
+  piStartupHeader(pi);
+  if (config.enableWorkingMessage) workingMessage(pi);
+
+  // render stack：thinking controller 直接交给 style 作 query
+  markdownEnhance(pi);
+  registerTranscriptRenderer(
+    pi,
+    undefined,
+    installCompactThinking(pi, getCompactThinkingConfig()),
+    {
+      onRuntimeController: options.onRuntimeController,
+    },
+  );
+
+  // features
+  if (config.enableContextCommand) context(pi);
+  if (config.enableSessionReference) sessionReference(pi);
+  if (config.enableSubagentAutocomplete) agentAutocomplete(pi);
+  if (config.enableAgentSummary) agentSummary(pi);
+}