pi-pretty-tui 0.2.7 → 0.2.8

package/README.md

@@ -37,6 +37,10 @@ Displayed custom messages without their own renderer use one generic accent-colo
 
 Pi's direct internal `showStatus()` feedback is transient: it appears only in the status line above the editor, a newer status replaces it, and a ten-second timer removes it. It never enters the transcript or activity timeline and is cleared on reload. In clean mode, `Ctrl+T` and `Ctrl+O` only show short hints to click the corresponding disclosure; neither changes visibility or Pi's Thinking setting. In full and compact modes, both shortcuts keep Pi's native behaviour.
 
+## Error presentation
+
+In clean mode, standalone errors keep their original title and complete text in a compact `✕ Error · reason` layout. Consecutive errors with exactly the same source type, title, and full text share one visible row with a dim `×2` / `×3` count. Other transcript components break the run; errors carrying thought/tool/visible-response content are not folded. This is UI-only: session records and original message components remain unchanged. Long errors wrap without an added preview truncation; full/compact modes keep native presentation.
+
 ## Codemode and nested tools
 
 In clean mode, tools that call other tools through Pi's nested execution API keep their own parent node. Expand the activity group to see each internal call, its status, compact arguments, duration, and result summary. Click an internal call to inspect its arguments and text result independently. Click its expanded body to collapse just that call. Script and script-output bodies also collapse their own sections when clicked. Tool calls use a `●` marker: dim while running, success-colored when successful, and error-colored when failed. Tool names use bold theme text. `[Script]` and `[Script output]` are separate disclosures; the nested parent title is informational and clicking it does not expand or collapse details. Use each section or child to expand and collapse its own details; `Ctrl+O` only shows a hint in clean mode. Extensions can still use Pi's `setToolsExpanded()` API for global control; local disclosures remain usable afterward, and another global API call resets the local overrides. Calls retain their start order even when they finish in parallel. A handled child failure remains marked as failed even if the script succeeds.

package/README.zh-CN.md

@@ -37,6 +37,10 @@ Pi 可能会提示内置工具被覆盖。这是正常现象：pi-pretty-tui 会
 
 Pi 内部直接调用 `showStatus()` 产生的反馈属于临时 UI 状态：它只显示在编辑器上方，新状态替换旧状态，并由十秒 timer 自动清除；它不会进入 transcript 或活动时间线，reload 时也会清除。在 clean 模式下，`Ctrl+T` 和 `Ctrl+O` 都只显示点击对应节点的简短提示，不改变内容可见性或 Pi 的 Thinking 设置。在 full 和 compact 模式下，两者保留 Pi 的原生行为。
 
+## 错误展示
+
+clean 模式下，独立错误保留原始标题和完整内容，以紧凑的 `✕ Error · 原因` 展示。来源类型、标题及完整内容完全一致的相邻错误合为一条可见行，并使用暗色 `×2` / `×3` 标识次数。其他 transcript 组件会打断计数；包含思考、工具或可见回答的错误不参与合并。合并仅影响 UI，不删除或修改会话记录及原始消息组件。长错误完整换行，不增加预览截断；full/compact 模式保留原生展示。
+
 ## Codemode 与嵌套工具
 
 clean 模式下，通过 Pi 嵌套执行 API 调用其他工具的工具保留自己的父节点。展开活动组后，会显示各内部调用的状态、紧凑参数、耗时和结果摘要；点击某个内部调用，可以独立展开其参数和文本结果；点击展开后的正文可收起该调用，脚本和脚本输出正文也可点击收起各自区块。工具统一使用 `●` 圆点：运行中为主题暗色，成功与失败分别为主题成功色与错误色；工具名使用正文色加粗。`[Script]` 和 `[Script output]` 分别控制脚本与汇总输出；嵌套父工具标题仅用于展示，点击不会展开或折叠详情。各区块或子调用通过自己的入口独立展开/收起，`Ctrl+O` 在 clean 模式下只显示提示。扩展仍可通过 Pi 的 `setToolsExpanded()` API 全局控制，之后也可局部展开/收起；再次调用全局 API 会重置局部状态。并行调用按照启动顺序排列，不会随完成顺序跳动。即使脚本捕获错误后成功，失败的子调用仍会明确标记。

package/extensions/index.ts

@@ -100,6 +100,32 @@ export default function prettyTui(pi: ExtensionAPI) {
   const mouseClickHitTests = new WeakMap<object, (event: any) => boolean>();
   let currentTui: any;
   let currentPromptEditor: any;
+  let errorChatContainer: any;
+  const runtimeErrorDescriptors = new WeakMap<object, { source: string; title: string; content: string }>();
+  const errorDescriptor = (component: any) => {
+    const runtime = runtimeErrorDescriptors.get(component);
+    if (runtime) return runtime;
+    if (!(component instanceof AssistantMessageComponent)) return undefined;
+    const message = (component as any).lastMessage;
+    if (message?.stopReason !== "error" || (message.content ?? []).some((item: any) =>
+      item.type === "toolCall" || item.type === "thinking" || item.type === "text" && item.text?.length)) return undefined;
+    return { source: "assistant:error", title: "Error", content: String(message.errorMessage ?? "") };
+  };
+  const errorRun = (component: any) => {
+    const children: any[] = errorChatContainer?.children ?? [];
+    const index = children.indexOf(component);
+    const descriptor = errorDescriptor(component);
+    const same = (other: any) => {
+      const value = errorDescriptor(other);
+      return descriptor && value && value.source === descriptor.source &&
+        value.title === descriptor.title && value.content === descriptor.content;
+    };
+    if (index < 0 || !descriptor) return { hidden: false, count: 1, compact: false };
+    let count = 1;
+    while (index + count < children.length && same(children[index + count])) count++;
+    return { hidden: index > 0 && Boolean(same(children[index - 1])), count,
+      compact: index > 0 && Boolean(errorDescriptor(children[index - 1])) };
+  };
   const runningColor = (theme: any, text: string): string =>
     typeof currentPromptEditor?.borderColor === "function"
       ? currentPromptEditor.borderColor(text)
@@ -553,7 +579,31 @@ export default function prettyTui(pi: ExtensionAPI) {
     );
   };
 
-  const renderPendingActivityUpdate = (member: ActivityMember, width: number): string[] => {
+  const renderStandaloneError = (member: ActivityMember, width: number, component?: any): string[] => {
+    const run = component ? errorRun(component) : { hidden: false, count: 1, compact: false };
+    if (run.hidden) return [];
+    const theme = defaultActivityTheme();
+    const style = activityUpdateStyle(member, theme);
+    const original = component ? errorDescriptor(component) : undefined;
+    const title = stripTerminalSequences(original?.title ?? member.updateTitle ?? "Error");
+    const content = stripTerminalSequences(original?.content || member.updateContent || "");
+    const heading = style.icon + style.title(title);
+    const prefix = heading + (content ? theme.fg("dim", " · ") : "");
+    const text = prefix + theme.fg("muted", content) + (run.count > 1 ? theme.fg("dim", ` ×${run.count}`) : "");
+    // Wrap rather than truncate; all original detail lines remain accessible.
+    const continuation = " ".repeat(Math.min(visibleWidth(prefix), Math.max(0, Math.floor(width / 3))));
+    const rows: string[] = [];
+    for (const line of text.split("\n")) {
+      const wrapped = wrapTextWithAnsi(line, Math.max(1, width - visibleWidth(continuation)));
+      rows.push(...wrapped.map((row, index) => (rows.length || index ? continuation : "") + row));
+    }
+    return [...(run.compact ? [] : [""]), ...rows.map((line) => truncateToWidth(line, Math.max(1, width), ""))];
+  };
+
+  const renderPendingActivityUpdate = (member: ActivityMember, width: number, component?: any): string[] => {
+    if (member.updateSeverity === "error" && member.updateTitle !== "Response truncated") {
+      return renderStandaloneError(member, width, component);
+    }
     const theme = defaultActivityTheme();
     const title = truncateToWidth(member.updateTitle ?? "Update", Math.max(1, width - 2), "…");
     const style = activityUpdateStyle(member, theme);
@@ -572,8 +622,9 @@ export default function prettyTui(pi: ExtensionAPI) {
     group: ActivityGroup,
     member: ActivityMember,
     width: number,
+    component?: any,
   ): string[] => {
-    if (!activityGroupCollapsible(group)) return renderPendingActivityUpdate(member, width);
+    if (!activityGroupCollapsible(group)) return renderPendingActivityUpdate(member, width, component);
     const position = activityMemberPosition(group, member);
     if (!activityGroupRevealed(group)) {
       return position.first
@@ -1242,7 +1293,7 @@ export default function prettyTui(pi: ExtensionAPI) {
         const terminalGroup = activityTimeline.groupForMember(terminalMember.id);
         if (!terminalGroup) return originalRender.call(this, width);
         activityUpdateComponents.set(terminalMember.id, this);
-        return renderActivityUpdateProjection(terminalGroup, terminalMember, width);
+        return renderActivityUpdateProjection(terminalGroup, terminalMember, width, this);
       }
 
       const key = assistantMessageKey(message);
@@ -1507,10 +1558,14 @@ export default function prettyTui(pi: ExtensionAPI) {
     const group = activityTimeline.groupForMember(member.id);
     if (!group || !mode.chatContainer?.addChild) return false;
     const component: Component = {
-      render: (width: number) => renderActivityUpdateProjection(group, member, width),
+      render: (width: number) => renderActivityUpdateProjection(group, member, width, component),
       invalidate() {},
       handleMouse: (event: any) => handleActivityUpdateMouse(group, member, event),
     } as Component;
+    if (severity === "error") runtimeErrorDescriptors.set(component, {
+      source: "runtime:error", title, content,
+    });
+    errorChatContainer = mode.chatContainer;
     activityUpdateComponents.set(member.id, component);
     mode.chatContainer.addChild(component);
     mode.ui?.requestRender?.();
@@ -1569,6 +1624,7 @@ export default function prettyTui(pi: ExtensionAPI) {
 
     const patchedRenderSessionEntries = function (this: any, entries: any[], options?: any) {
       currentTui = this.ui;
+      errorChatContainer = this.chatContainer;
       fullscreenTui = currentTui?.mode === "fullscreen";
       // buildContextEntries() prepends the latest compaction for model context,
       // while Pi's live compaction UI appends it chronologically. Keep reloads
@@ -1674,6 +1730,7 @@ export default function prettyTui(pi: ExtensionAPI) {
     // calling sites, rather than depend on private chat-container children or
     // instanceof checks (these can be wrapped or come from another module).
     const patchedAddMessageToChat = function (this: any, message: any, ...args: any[]) {
+      errorChatContainer = this.chatContainer;
       if (message?.role === "assistant") cacheMessageContexts.set(this, message);
       else cacheMessageContexts.delete(this);
       return originalAddMessageToChat.call(this, message, ...args);
@@ -1874,6 +1931,7 @@ export default function prettyTui(pi: ExtensionAPI) {
 
     pi.on("session_shutdown", () => {
       fullscreenTui = false;
+      errorChatContainer = undefined;
       currentTui = undefined;
       clearLatestActivityStatus();
       currentExtensionUi = undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-pretty-tui",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "A beautiful, polished TUI for the Pi coding agent",
   "license": "MIT",
   "author": "Kainan Yang <ykn0309@whu.edu.cn>",