@zhijiewang/openharness 2.1.0 → 2.3.0

package/dist/renderer/index.js

@@ -3,15 +3,15 @@
  * Flushed messages flow to scrollback; live area is rewritten in-place
  * right after the scrollback content each frame (no absolute positioning gap).
  */
-import { CellGrid } from './cells.js';
-import { styleToSGR, syncWrite, hideCursor, showCursor } from './differ.js';
-import { rasterizeLive } from './layout.js';
-import { getTheme } from '../utils/theme-data.js';
-import { FG } from './colors.js';
-import { createSessionBrowser, browserUp, browserDown, browserSelectedId, browserLoadPreview, browserSearch } from './session-browser.js';
-import { summarizeToolArgs } from '../utils/tool-summary.js';
-import { extractDiffInfo } from './diff.js';
-import { startRawInput } from './input.js';
+import { getTheme } from "../utils/theme-data.js";
+import { summarizeToolArgs } from "../utils/tool-summary.js";
+import { CellGrid } from "./cells.js";
+import { FG } from "./colors.js";
+import { extractDiffInfo } from "./diff.js";
+import { hideCursor, showCursor, styleToSGR, syncWrite } from "./differ.js";
+import { startRawInput } from "./input.js";
+import { rasterizeLive } from "./layout.js";
+import { browserDown, browserLoadPreview, browserSearch, browserSelectedId, browserUp, createSessionBrowser, } from "./session-browser.js";
 export class TerminalRenderer {
     current;
     state;
@@ -39,15 +39,15 @@ export class TerminalRenderer {
         this.current = new CellGrid(w, h);
         this.state = {
             messages: [],
-            streamingText: '',
-            thinkingText: '',
+            streamingText: "",
+            thinkingText: "",
             toolCalls: new Map(),
-            inputText: '',
+            inputText: "",
             inputCursor: 0,
             companionLines: null,
-            companionColor: 'cyan',
-            statusHints: 'exit to quit',
-            statusLine: '',
+            companionColor: "cyan",
+            statusHints: "exit to quit",
+            statusLine: "",
             contextWarning: null,
             errorText: null,
             loading: false,
@@ -76,7 +76,7 @@ export class TerminalRenderer {
     start() {
         this.started = true;
         // Enable SGR mouse tracking (scroll wheel support)
-        process.stdout.write('\x1b[?1000h\x1b[?1006h');
+        process.stdout.write("\x1b[?1000h\x1b[?1006h");
         hideCursor();
         // Raw input
         this.stopInput = startRawInput((key) => {
@@ -97,7 +97,7 @@ export class TerminalRenderer {
         }, 500);
         // Terminal resize
         this.resizeHandler = () => this.handleResize();
-        process.stdout.on('resize', this.resizeHandler);
+        process.stdout.on("resize", this.resizeHandler);
         this.render();
     }
     stop() {
@@ -113,7 +113,7 @@ export class TerminalRenderer {
             this.renderTimer = null;
         }
         if (this.resizeHandler) {
-            process.stdout.off('resize', this.resizeHandler);
+            process.stdout.off("resize", this.resizeHandler);
             this.resizeHandler = null;
         }
         if (this.stopInput) {
@@ -124,10 +124,10 @@ export class TerminalRenderer {
             clearTimeout(t);
         this.notifyTimers.length = 0;
         // Restore terminal: disable mouse, show cursor, reset attributes
-        process.stdout.write('\x1b[?1006l\x1b[?1000l\x1b[0m');
+        process.stdout.write("\x1b[?1006l\x1b[?1000l\x1b[0m");
         showCursor();
         // Move past live area for clean shell prompt
-        process.stdout.write('\n');
+        process.stdout.write("\n");
     }
     // ── State updates ──
     setMessages(msgs) {
@@ -137,9 +137,18 @@ export class TerminalRenderer {
         this.state.messages = msgs;
         this.scheduleRender();
     }
-    setStreamingText(text) { this.state.streamingText = text; this.scheduleRender(); }
-    setThinkingText(text) { this.state.thinkingText = text; this.scheduleRender(); }
-    setError(text) { this.state.errorText = text; this.scheduleRender(); }
+    setStreamingText(text) {
+        this.state.streamingText = text;
+        this.scheduleRender();
+    }
+    setThinkingText(text) {
+        this.state.thinkingText = text;
+        this.scheduleRender();
+    }
+    setError(text) {
+        this.state.errorText = text;
+        this.scheduleRender();
+    }
     /** Show a toast notification above the input for 5 seconds */
     notify(text) {
         const entry = { text };
@@ -161,30 +170,67 @@ export class TerminalRenderer {
         this.state.manualScroll = Math.max(0, Math.min(this.state.manualScroll + delta, 500));
         this.scheduleRender();
     }
-    setLoading(loading) { this.state.loading = loading; this.scheduleRender(); }
-    setInputText(text) { this.state.inputText = text; this.scheduleRender(); }
-    setInputCursor(pos) { this.state.inputCursor = pos; this.scheduleRender(); }
+    setLoading(loading) {
+        this.state.loading = loading;
+        this.scheduleRender();
+    }
+    setInputText(text) {
+        this.state.inputText = text;
+        this.scheduleRender();
+    }
+    setInputCursor(pos) {
+        this.state.inputCursor = pos;
+        this.scheduleRender();
+    }
     setCompanion(lines, color) {
         this.state.companionLines = lines;
         this.state.companionColor = color;
         this.scheduleRender();
     }
-    setStatusHints(text) { this.state.statusHints = text; this.scheduleRender(); }
-    setBannerLines(lines) { this.state.bannerLines = lines; this.scheduleRender(); }
+    setStatusHints(text) {
+        this.state.statusHints = text;
+        this.scheduleRender();
+    }
+    setBannerLines(lines) {
+        this.state.bannerLines = lines;
+        this.scheduleRender();
+    }
     setAutocomplete(suggestions, index, descriptions) {
         this.state.autocomplete = suggestions;
         this.state.autocompleteDescriptions = descriptions ?? [];
         this.state.autocompleteIndex = index;
         this.scheduleRender();
     }
-    setStatusLine(text) { this.state.statusLine = text; this.scheduleRender(); }
-    setContextWarning(warning) { this.state.contextWarning = warning; this.scheduleRender(); }
-    setVimMode(mode) { this.state.vimMode = mode; this.scheduleRender(); }
-    setThinkingStartedAt(time) { this.state.thinkingStartedAt = time; }
-    getThinkingStartedAt() { return this.state.thinkingStartedAt; }
-    setLastThinkingSummary(summary) { this.state.lastThinkingSummary = summary; this.scheduleRender(); }
-    toggleThinkingExpanded() { this.state.thinkingExpanded = !this.state.thinkingExpanded; this.scheduleRender(); }
-    setTokenCount(count) { this.state.tokenCount = count; this.scheduleRender(); }
+    setStatusLine(text) {
+        this.state.statusLine = text;
+        this.scheduleRender();
+    }
+    setContextWarning(warning) {
+        this.state.contextWarning = warning;
+        this.scheduleRender();
+    }
+    setVimMode(mode) {
+        this.state.vimMode = mode;
+        this.scheduleRender();
+    }
+    setThinkingStartedAt(time) {
+        this.state.thinkingStartedAt = time;
+    }
+    getThinkingStartedAt() {
+        return this.state.thinkingStartedAt;
+    }
+    setLastThinkingSummary(summary) {
+        this.state.lastThinkingSummary = summary;
+        this.scheduleRender();
+    }
+    toggleThinkingExpanded() {
+        this.state.thinkingExpanded = !this.state.thinkingExpanded;
+        this.scheduleRender();
+    }
+    setTokenCount(count) {
+        this.state.tokenCount = count;
+        this.scheduleRender();
+    }
     toggleCodeBlockExpansion() {
         this.state.codeBlocksExpanded = !this.state.codeBlocksExpanded;
         this.scheduleRender();
@@ -205,10 +251,10 @@ export class TerminalRenderer {
         this.scheduleRender();
     }
     sessionBrowserUp() {
-        this.withSessionBrowser(sb => browserLoadPreview(browserUp(sb)));
+        this.withSessionBrowser((sb) => browserLoadPreview(browserUp(sb)));
     }
     sessionBrowserDown() {
-        this.withSessionBrowser(sb => browserLoadPreview(browserDown(sb)));
+        this.withSessionBrowser((sb) => browserLoadPreview(browserDown(sb)));
     }
     sessionBrowserSelect() {
         if (!this.state.sessionBrowser)
@@ -219,11 +265,11 @@ export class TerminalRenderer {
         return id;
     }
     sessionBrowserType(char) {
-        this.withSessionBrowser(sb => browserSearch(sb, sb.searchQuery + char));
+        this.withSessionBrowser((sb) => browserSearch(sb, sb.searchQuery + char));
     }
     sessionBrowserBackspace() {
         if (this.state.sessionBrowser && this.state.sessionBrowser.searchQuery.length > 0) {
-            this.withSessionBrowser(sb => browserSearch(sb, sb.searchQuery.slice(0, -1)));
+            this.withSessionBrowser((sb) => browserSearch(sb, sb.searchQuery.slice(0, -1)));
         }
     }
     isSessionBrowserOpen() {
@@ -233,12 +279,21 @@ export class TerminalRenderer {
         this.state.toolCalls.set(callId, info);
         this.scheduleRender();
     }
-    getToolCall(callId) { return this.state.toolCalls.get(callId); }
-    clearToolCalls() { this.state.toolCalls.clear(); this.flushedToolCallIds.clear(); this.scheduleRender(); }
-    collapseAllToolCalls() { this.state.expandedToolCalls.clear(); this.scheduleRender(); }
+    getToolCall(callId) {
+        return this.state.toolCalls.get(callId);
+    }
+    clearToolCalls() {
+        this.state.toolCalls.clear();
+        this.flushedToolCallIds.clear();
+        this.scheduleRender();
+    }
+    collapseAllToolCalls() {
+        this.state.expandedToolCalls.clear();
+        this.scheduleRender();
+    }
     /** Show a question prompt and wait for text answer */
     askQuestion(question, options) {
-        this.state.questionPrompt = { question, options: options ?? null, input: '', cursor: 0 };
+        this.state.questionPrompt = { question, options: options ?? null, input: "", cursor: 0 };
         this.scheduleRender();
         return new Promise((resolve) => {
             this.questionResolve = resolve;
@@ -257,14 +312,14 @@ export class TerminalRenderer {
     }
     /** Cycle to next tool call and toggle its expansion */
     cycleToolCallExpansion() {
-        const ids = [...this.state.toolCalls.keys()].filter(id => {
+        const ids = [...this.state.toolCalls.keys()].filter((id) => {
             const tc = this.state.toolCalls.get(id);
-            return tc && tc.status !== 'running' && tc.output;
+            return tc && tc.status !== "running" && tc.output;
         });
         if (ids.length === 0)
             return;
         const expanded = this.state.expandedToolCalls;
-        const currentIdx = ids.findIndex(id => expanded.has(id));
+        const currentIdx = ids.findIndex((id) => expanded.has(id));
         if (currentIdx >= 0) {
             expanded.delete(ids[currentIdx]);
             const nextIdx = currentIdx + 1;
@@ -280,7 +335,12 @@ export class TerminalRenderer {
     /** Show permission prompt and wait for Y/N response */
     askPermission(toolName, description, riskLevel) {
         this.permissionPrompt = { toolName, description, riskLevel };
-        this.state.permissionBox = { toolName, description, riskLevel, suggestion: summarizeToolArgs(toolName, description) };
+        this.state.permissionBox = {
+            toolName,
+            description,
+            riskLevel,
+            suggestion: summarizeToolArgs(toolName, description),
+        };
         this.state.permissionDiffInfo = extractDiffInfo(toolName, description);
         // Auto-show diffs for file-modifying tools
         const isFileTool = /^(Edit|Write|FileEdit|FileWrite)/i.test(toolName);
@@ -295,9 +355,7 @@ export class TerminalRenderer {
     clearLiveArea() {
         if (!this.started)
             return;
-        const cmd = this.lastLiveLines > 0
-            ? `\x1b[${this.lastLiveLines}A\r\x1b[J`
-            : '\r\x1b[J';
+        const cmd = this.lastLiveLines > 0 ? `\x1b[${this.lastLiveLines}A\r\x1b[J` : "\r\x1b[J";
         syncWrite(cmd);
         this.lastLiveLines = 0;
     }
@@ -313,7 +371,7 @@ export class TerminalRenderer {
         if (!this.permissionResolve)
             return false;
         const k = key.char.toLowerCase();
-        if (k === 'y' || k === 'n') {
+        if (k === "y" || k === "n") {
             const resolve = this.permissionResolve;
             this.permissionResolve = null;
             this.permissionPrompt = null;
@@ -321,9 +379,9 @@ export class TerminalRenderer {
             this.state.permissionDiffVisible = false;
             this.state.permissionDiffInfo = null;
             this.scheduleRender();
-            resolve(k === 'y');
+            resolve(k === "y");
         }
-        else if (k === 'd' && this.state.permissionDiffInfo) {
+        else if (k === "d" && this.state.permissionDiffInfo) {
             this.state.permissionDiffVisible = !this.state.permissionDiffVisible;
             this.scheduleRender();
         }
@@ -334,7 +392,7 @@ export class TerminalRenderer {
         if (!this.questionResolve || !this.state.questionPrompt)
             return false;
         const qp = this.state.questionPrompt;
-        if (key.name === 'return' && qp.input.trim()) {
+        if (key.name === "return" && qp.input.trim()) {
             const resolve = this.questionResolve;
             const answer = qp.input.trim();
             this.questionResolve = null;
@@ -342,26 +400,34 @@ export class TerminalRenderer {
             this.scheduleRender();
             resolve(answer);
         }
-        else if (key.name === 'backspace') {
+        else if (key.name === "backspace") {
             if (qp.cursor > 0) {
-                this.state.questionPrompt = { ...qp, input: qp.input.slice(0, qp.cursor - 1) + qp.input.slice(qp.cursor), cursor: qp.cursor - 1 };
+                this.state.questionPrompt = {
+                    ...qp,
+                    input: qp.input.slice(0, qp.cursor - 1) + qp.input.slice(qp.cursor),
+                    cursor: qp.cursor - 1,
+                };
                 this.scheduleRender();
             }
         }
-        else if (key.name === 'left') {
+        else if (key.name === "left") {
             if (qp.cursor > 0) {
                 this.state.questionPrompt = { ...qp, cursor: qp.cursor - 1 };
                 this.scheduleRender();
             }
         }
-        else if (key.name === 'right') {
+        else if (key.name === "right") {
             if (qp.cursor < qp.input.length) {
                 this.state.questionPrompt = { ...qp, cursor: qp.cursor + 1 };
                 this.scheduleRender();
             }
         }
         else if (key.char && key.char.length === 1 && !key.ctrl && !key.meta) {
-            this.state.questionPrompt = { ...qp, input: qp.input.slice(0, qp.cursor) + key.char + qp.input.slice(qp.cursor), cursor: qp.cursor + 1 };
+            this.state.questionPrompt = {
+                ...qp,
+                input: qp.input.slice(0, qp.cursor) + key.char + qp.input.slice(qp.cursor),
+                cursor: qp.cursor + 1,
+            };
             this.scheduleRender();
         }
         return true;
@@ -404,16 +470,16 @@ export class TerminalRenderer {
     /** Apply lightweight markdown styling to a line for scrollback output */
     styleMarkdownLine(line) {
         return line
-            .replace(/\*\*(.+?)\*\*/g, '\x1b[1m$1\x1b[0m') // bold → full reset after
-            .replace(/`([^`]+)`/g, '\x1b[2m$1\x1b[0m') // inline code → dim, full reset after
-            .replace(/^(#{1,3})\s+(.+)$/, '\x1b[1m\x1b[36m$1 $2\x1b[0m'); // headings → bold cyan
+            .replace(/\*\*(.+?)\*\*/g, "\x1b[1m$1\x1b[0m") // bold → full reset after
+            .replace(/`([^`]+)`/g, "\x1b[2m$1\x1b[0m") // inline code → dim, full reset after
+            .replace(/^(#{1,3})\s+(.+)$/, "\x1b[1m\x1b[36m$1 $2\x1b[0m"); // headings → bold cyan
     }
     /** Calculate the max text width for flushed scrollback output, reserving space for companion */
     flushTextWidth() {
         const maxWidth = process.stdout.columns ?? 80;
         if (!this.state.companionLines)
             return maxWidth;
-        const compWidth = Math.max(...this.state.companionLines.map(l => l.length), 0) + 2;
+        const compWidth = Math.max(...this.state.companionLines.map((l) => l.length), 0) + 2;
         return Math.max(40, maxWidth - compWidth);
     }
     /** Flush completed messages to terminal scrollback (native scrollbar) */
@@ -427,34 +493,38 @@ export class TerminalRenderer {
             if (this.state.loading && this.flushedMessageCount === messages.length - 1 && msg.meta?.isStreaming)
                 break;
             const t = getTheme();
-            const colorCode = msg.role === 'user' ? `\x1b[${FG(t.user)}m\x1b[1m` : msg.role === 'assistant' ? `\x1b[${FG(t.assistant)}m` : '\x1b[2m';
-            const prefixChar = msg.role === 'user' ? '❯ ' : msg.role === 'assistant' ? '◆ ' : '  ';
-            const lines = msg.content.split('\n');
+            const colorCode = msg.role === "user"
+                ? `\x1b[${FG(t.user)}m\x1b[1m`
+                : msg.role === "assistant"
+                    ? `\x1b[${FG(t.assistant)}m`
+                    : "\x1b[2m";
+            const prefixChar = msg.role === "user" ? "❯ " : msg.role === "assistant" ? "◆ " : "  ";
+            const lines = msg.content.split("\n");
             for (let i = 0; i < lines.length; i++) {
-                const styledLine = msg.role === 'assistant' ? this.styleMarkdownLine(lines[i]) : lines[i];
-                const linePrefix = i === 0 ? prefixChar : '  ';
+                const styledLine = msg.role === "assistant" ? this.styleMarkdownLine(lines[i]) : lines[i];
+                const linePrefix = i === 0 ? prefixChar : "  ";
                 const fullLine = linePrefix + styledLine;
-                process.stdout.write(colorCode + fullLine.slice(0, textWidth) + '\x1b[0m\n');
+                process.stdout.write(`${colorCode + fullLine.slice(0, textWidth)}\x1b[0m\n`);
             }
             // Divider after each message
-            process.stdout.write('\x1b[2m' + '─'.repeat(Math.min(60, textWidth)) + '\x1b[0m\n');
+            process.stdout.write(`\x1b[2m${"─".repeat(Math.min(60, textWidth))}\x1b[0m\n`);
             this.flushedMessageCount++;
             didFlush = true;
         }
         // Flush completed tool calls as single-line summaries (once each)
         if (didFlush) {
             for (const [callId, tc] of this.state.toolCalls) {
-                if (tc.status === 'running')
+                if (tc.status === "running")
                     continue;
                 if (this.flushedToolCallIds.has(callId))
                     continue;
                 this.flushedToolCallIds.add(callId);
                 const t = getTheme();
-                const icon = tc.status === 'done' ? `\x1b[${FG(t.success)}m✓` : `\x1b[${FG(t.error)}m✗`;
-                const summary = tc.resultSummary ? `  ${tc.resultSummary}` : '';
-                const elapsed = tc.startedAt ? ` · ${Math.floor((Date.now() - tc.startedAt) / 1000)}s` : '';
-                const toolLine = `${icon} ${tc.toolName}\x1b[0m \x1b[2m${tc.args ?? ''}${summary}${elapsed}\x1b[0m`;
-                process.stdout.write(toolLine.slice(0, textWidth) + '\n');
+                const icon = tc.status === "done" ? `\x1b[${FG(t.success)}m✓` : `\x1b[${FG(t.error)}m✗`;
+                const summary = tc.resultSummary ? `  ${tc.resultSummary}` : "";
+                const elapsed = tc.startedAt ? ` · ${Math.floor((Date.now() - tc.startedAt) / 1000)}s` : "";
+                const toolLine = `${icon} ${tc.toolName}\x1b[0m \x1b[2m${tc.args ?? ""}${summary}${elapsed}\x1b[0m`;
+                process.stdout.write(`${toolLine.slice(0, textWidth)}\n`);
             }
         }
     }
@@ -464,10 +534,10 @@ export class TerminalRenderer {
         for (let r = 0; r < grid.height; r++) {
             // Find last non-space cell to avoid writing trailing whitespace
             let lastCol = grid.width - 1;
-            while (lastCol >= 0 && grid.cells[r][lastCol].char === ' ' && !grid.cells[r][lastCol].style.bg) {
+            while (lastCol >= 0 && grid.cells[r][lastCol].char === " " && !grid.cells[r][lastCol].style.bg) {
                 lastCol--;
             }
-            let lastStyle = '';
+            let lastStyle = "";
             for (let c = 0; c <= lastCol; c++) {
                 const cell = grid.cells[r][c];
                 const sgr = styleToSGR(cell.style);
@@ -477,27 +547,27 @@ export class TerminalRenderer {
                 }
                 parts.push(cell.char);
             }
-            parts.push('\x1b[0m\x1b[K'); // reset + erase to end of line (clear stale content)
+            parts.push("\x1b[0m\x1b[K"); // reset + erase to end of line (clear stale content)
             if (r < grid.height - 1)
-                parts.push('\n');
+                parts.push("\n");
         }
-        return parts.join('');
+        return parts.join("");
     }
     render() {
         const w = process.stdout.columns ?? 80;
         const h = process.stdout.rows ?? 24;
         // 1. Build erase command: move UP to start of old live area, erase below.
-        let eraseCmd = '';
+        let eraseCmd = "";
         if (this.lastLiveLines > 0) {
             eraseCmd += `\x1b[${this.lastLiveLines}A`;
         }
-        eraseCmd += '\r\x1b[J';
+        eraseCmd += "\r\x1b[J";
         // 2. Flush completed messages to scrollback
         //    If nothing to flush, we combine erase + rewrite into a single
         //    atomic syncWrite to prevent any flickering.
         const hasFlush = this.hasPendingFlush();
         if (hasFlush) {
-            syncWrite('\x1b[?25l' + eraseCmd); // hide cursor + erase
+            syncWrite(`\x1b[?25l${eraseCmd}`); // hide cursor + erase
             this.flushMessages();
         }
         // 3. Calculate and render new live area
@@ -511,12 +581,12 @@ export class TerminalRenderer {
         //    position cursor, show cursor. Terminal paints this as a single frame.
         const liveOutput = this.renderGridToAnsi(this.current);
         const upFromEnd = liveHeight - 1 - cursor.cursorRow;
-        const cursorPos = (upFromEnd > 0 ? `\x1b[${upFromEnd}A` : '') +
-            `\x1b[${cursor.cursorCol + 1}G`;
-        syncWrite((hasFlush ? '' : '\x1b[?25l' + eraseCmd) + // hide + erase (if not already done)
-            liveOutput + '\r' + cursorPos +
-            '\x1b[?25h' // show cursor at final position
-        );
+        const cursorPos = `${upFromEnd > 0 ? `\x1b[${upFromEnd}A` : ""}\x1b[${cursor.cursorCol + 1}G`;
+        syncWrite((hasFlush ? "" : `\x1b[?25l${eraseCmd}`) + // hide + erase (if not already done)
+            liveOutput +
+            "\r" +
+            cursorPos +
+            "\x1b[?25h");
         this.lastLiveLines = cursor.cursorRow;
     }
     /** Check if there are messages pending flush (without flushing) */
@@ -536,7 +606,7 @@ export class TerminalRenderer {
             rows += this.state.bannerLines.length + 1;
         }
         if (this.state.loading && this.state.streamingText)
-            rows += Math.min(this.state.streamingText.split('\n').length, 10);
+            rows += Math.min(this.state.streamingText.split("\n").length, 10);
         if (this.state.thinkingText)
             rows += this.state.thinkingExpanded ? 10 : 1;
         if (!this.state.loading && this.state.lastThinkingSummary)
@@ -547,7 +617,7 @@ export class TerminalRenderer {
             rows += 1;
         for (const [, tc] of this.state.toolCalls) {
             rows += 2; // header + possible description/agent line
-            if (tc.status === 'running' && tc.liveOutput)
+            if (tc.status === "running" && tc.liveOutput)
                 rows += Math.min(tc.liveOutput.length, 3);
         }
         if (this.state.contextWarning)