agent-sh 0.2.0 → 0.3.1

package/dist/extensions/tui-renderer.js

@@ -10,82 +10,190 @@
  * silently dropped. Alternative renderers (web UI, logging, minimal)
  * can subscribe to the same events.
  */
-import { MarkdownRenderer } from "../utils/markdown.js";
+import { highlight } from "cli-highlight";
+import { MarkdownRenderer, wrapLine } from "../utils/markdown.js";
+import { createFencedBlockTransform } from "../utils/stream-transform.js";
 import { palette as p } from "../utils/palette.js";
-import { renderToolCall, renderToolResult, startSpinner, stopSpinner as stopToolSpinner, } from "../utils/tool-display.js";
+import { renderToolCall, createSpinner, renderSpinnerLine, } from "../utils/tool-display.js";
 import { renderDiff } from "../utils/diff-renderer.js";
 import { renderBoxFrame } from "../utils/box-frame.js";
-const MAX_COMMAND_OUTPUT_LINES = 30;
-export default function activate({ bus }) {
-    let spinner = null;
-    let renderer = null;
-    let commandOutputBuffer = "";
-    let commandOutputLineCount = 0;
-    let commandOutputOverflow = 0;
-    let lastCommand = "";
-    let isThinking = false;
-    let showThinkingText = false;
-    let lastTruncatedDiff = null;
+import { getSettings } from "../settings.js";
+import { StdoutWriter } from "../utils/output-writer.js";
+/** Encode a PNG buffer as a terminal inline image escape sequence. */
+function encodeImageForTerminal(data) {
+    const b64 = data.toString("base64");
+    if (process.env.TERM_PROGRAM === "iTerm.app" || process.env.TERM_PROGRAM === "WezTerm") {
+        return `\x1b]1337;File=inline=1;size=${data.length};preserveAspectRatio=1:${b64}\x07`;
+    }
+    if (process.env.KITTY_WINDOW_ID || process.env.TERM_PROGRAM === "ghostty") {
+        const chunks = [];
+        for (let i = 0; i < b64.length; i += 4096) {
+            const chunk = b64.slice(i, i + 4096);
+            const isLast = i + 4096 >= b64.length;
+            chunks.push(i === 0
+                ? `\x1b_Gf=100,t=d,a=T,m=${isLast ? 0 : 1};${chunk}\x1b\\`
+                : `\x1b_Gm=${isLast ? 0 : 1};${chunk}\x1b\\`);
+        }
+        return chunks.join("");
+    }
+    return null;
+}
+function createRenderState() {
+    return {
+        renderer: null,
+        hadToolCalls: false,
+        spinner: null,
+        spinnerLabel: "",
+        spinnerOpts: {},
+        spinnerInterval: null,
+        spinnerStartTime: 0,
+        lastCommand: "",
+        toolLineOpen: false,
+        currentToolKind: undefined,
+        commandOutputBuffer: "",
+        commandOutputLineCount: 0,
+        commandOutputOverflow: 0,
+        isThinking: false,
+        showThinkingText: false,
+        thinkingPending: false,
+        lastTruncatedDiff: null,
+    };
+}
+export default function activate(ctx) {
+    const { bus, getAcpClient, define } = ctx;
+    const writer = new StdoutWriter();
+    const s = createRenderState();
+    // ── Register fenced block transform (code blocks → ContentBlock) ──
+    // Nobody is special — tui-renderer uses the same primitive as any extension.
+    const fencedTransform = createFencedBlockTransform(bus, {
+        open: /^```(\w*)\s*$/,
+        close: /^```\s*$/,
+        transform(match, content) {
+            return { type: "code-block", language: match[1] || "", code: content };
+        },
+    });
     // ── Event subscriptions ─────────────────────────────────────
     bus.on("agent:query", (e) => {
+        s.spinnerStartTime = 0;
         showUserQuery(e.query);
         startAgentResponse();
         startThinkingSpinner();
     });
     bus.on("agent:thinking-chunk", (e) => {
-        if (!isThinking) {
-            isThinking = true;
-            stopCurrentSpinner();
-            if (showThinkingText) {
-                if (!renderer)
+        s.thinkingPending = true;
+        if (!s.isThinking) {
+            s.isThinking = true;
+            if (s.showThinkingText) {
+                stopCurrentSpinner();
+                if (!s.renderer)
                     startAgentResponse();
-                renderer.writeLine(`${p.dim}${p.bold}💭 Thinking${p.reset}`);
+                s.renderer.writeLine(`${p.dim}Thinking (ctrl+t to collapse)${p.reset}`);
+                drain();
             }
             else {
-                startThinkingSpinner("Thinking");
+                // Restart spinner with ctrl+t hint now that we know thinking is available
+                startThinkingSpinner();
             }
         }
-        if (showThinkingText && e.text) {
-            if (!renderer)
+        if (s.showThinkingText && e.text) {
+            s.thinkingPending = false;
+            if (!s.renderer)
                 startAgentResponse();
-            renderer.push(`${p.dim}${e.text}${p.reset}`);
-            flushOutput();
+            s.renderer.push(`${p.dim}${e.text}${p.reset}`);
+            drain();
+        }
+    });
+    bus.on("agent:response-chunk", (e) => {
+        if (e.blocks) {
+            // Inject spacing: append \n to text blocks that precede non-text blocks
+            const blocks = e.blocks;
+            for (let i = 0; i < blocks.length; i++) {
+                const block = blocks[i];
+                const next = blocks[i + 1];
+                if (block.type === "text" && next && next.type !== "text") {
+                    block.text += "\n";
+                }
+            }
+            for (const block of blocks) {
+                switch (block.type) {
+                    case "text":
+                        if (block.text)
+                            writeAgentText(block.text);
+                        break;
+                    case "code-block":
+                        writeCodeBlock(block.language, block.code);
+                        break;
+                    case "image":
+                        writeInlineImage(block.data);
+                        break;
+                    case "raw":
+                        flushForRaw();
+                        writer.write(block.escape);
+                        break;
+                }
+            }
+        }
+        else {
+            writeAgentText(e.text);
         }
     });
-    bus.on("agent:response-chunk", (e) => writeAgentText(e.text));
     bus.on("agent:response-done", () => {
-        isThinking = false;
+        s.isThinking = false;
         endAgentResponse();
     });
     bus.on("agent:tool-call", (e) => {
-        lastCommand = e.tool;
+        s.lastCommand = e.tool;
     });
     bus.on("agent:tool-started", (e) => {
+        fencedTransform.flush();
         stopCurrentSpinner();
-        showToolCall(e.title, lastCommand, e);
-        lastCommand = "";
+        s.currentToolKind = e.kind;
+        if (e.title === "user_shell") {
+            closeToolLine();
+            if (!s.renderer)
+                startAgentResponse();
+            s.renderer.flush();
+            const cmd = e.rawInput?.command || "";
+            s.renderer.writeLine(`${p.dim}▶ user_shell: ${cmd}${p.reset}`);
+            drain();
+            s.hadToolCalls = true;
+        }
+        else {
+            showToolCall(e.title, s.lastCommand, e);
+        }
+        s.lastCommand = "";
+    });
+    bus.on("agent:tool-completed", (e) => {
+        showToolComplete(e.exitCode);
+        s.currentToolKind = undefined;
+        s.spinnerStartTime = 0;
+        startThinkingSpinner();
     });
-    bus.on("agent:tool-completed", (e) => showToolComplete(e.exitCode));
     bus.on("agent:tool-output-chunk", (e) => writeCommandOutput(e.chunk));
     bus.on("agent:tool-output", () => flushCommandOutput());
     bus.on("agent:cancelled", () => {
-        isThinking = false;
+        s.isThinking = false;
         stopCurrentSpinner();
         showInfo("(cancelled)");
         endAgentResponse();
     });
+    bus.on("agent:processing-done", () => {
+        s.isThinking = false;
+        stopCurrentSpinner();
+        endAgentResponse();
+    });
     bus.on("agent:error", (e) => showError(e.message));
-    // Flush rendering state and show inline diff for file writes
     bus.on("permission:request", (e) => {
         stopCurrentSpinner();
         flushCommandOutput();
-        renderer?.flush();
+        if (s.renderer) {
+            s.renderer.flush();
+            drain();
+        }
         if (e.kind === "file-write" && e.metadata?.diff) {
             showFileDiff(e.title, e.metadata.diff);
         }
         else {
-            // Non-file permission (e.g. tool-call) — end response box
-            // so interactive extensions can render their own UI
             endAgentResponse();
         }
     });
@@ -98,38 +206,46 @@ export default function activate({ bus }) {
     bus.on("ui:info", (e) => showInfo(e.message));
     bus.on("ui:error", (e) => showError(e.message));
     // ── Rendering functions ─────────────────────────────────────
-    function flushOutput() {
-        if (process.stdout.writable) {
-            try {
-                process.stdout.write("");
-            }
-            catch { }
+    function drain() {
+        if (!s.renderer)
+            return;
+        for (const line of s.renderer.drainLines()) {
+            writer.write(line + "\n");
         }
     }
     function startAgentResponse() {
-        renderer = new MarkdownRenderer();
-        process.stdout.write("\n");
-        renderer.printTopBorder();
+        s.renderer = new MarkdownRenderer(writer.columns);
+        s.hadToolCalls = false;
+        s.renderer.printTopBorder();
+        drain();
+    }
+    function showCollapsedThinking() {
+        if (s.thinkingPending && !s.showThinkingText) {
+            if (!s.renderer)
+                startAgentResponse();
+            s.renderer.writeLine(`${p.muted}… thinking${p.reset}`);
+            s.thinkingPending = false;
+        }
     }
     function endAgentResponse() {
-        if (renderer) {
-            renderer.flush();
-            renderer.printBottomBorder();
-            renderer = null;
+        closeToolLine();
+        stopCurrentSpinner();
+        if (s.renderer) {
+            s.renderer.flush();
+            s.renderer.printBottomBorder();
+            drain();
+            s.renderer = null;
         }
     }
     function showUserQuery(query) {
-        const termW = process.stdout.columns || 80;
-        const boxW = Math.min(84, termW);
-        const contentW = boxW - 4; // inside box padding
-        // Wrap long queries to fit within box
+        const boxW = Math.min(84, writer.columns);
+        const contentW = boxW - 4;
         const lines = [];
         for (const raw of query.split("\n")) {
             if (raw.length <= contentW) {
                 lines.push(`${p.accent}${raw}${p.reset}`);
             }
             else {
-                // Simple word wrap
                 let remaining = raw;
                 while (remaining.length > contentW) {
                     let breakAt = remaining.lastIndexOf(" ", contentW);
@@ -148,101 +264,209 @@ export default function activate({ bus }) {
             borderColor: p.accent,
             title: `${p.accent}${p.bold}❯${p.reset}`,
         });
-        process.stdout.write("\n");
+        writer.write("\n");
         for (const line of framed) {
-            process.stdout.write(line + "\n");
+            writer.write(line + "\n");
         }
     }
     function writeAgentText(text) {
-        if (isThinking) {
-            isThinking = false;
-            if (showThinkingText && renderer) {
-                renderer.flush();
-                const termW = process.stdout.columns || 80;
-                const w = Math.min(80, termW);
-                renderer.writeLine(`${p.dim}${"─".repeat(w)}${p.reset}`);
+        closeToolLine();
+        const needsGap = s.hadToolCalls;
+        s.hadToolCalls = false;
+        if (s.isThinking) {
+            s.isThinking = false;
+            if (s.showThinkingText && s.renderer) {
+                s.renderer.flush();
+                const w = Math.min(80, writer.columns);
+                s.renderer.writeLine(`${p.dim}${"─".repeat(w)}${p.reset}`);
+                drain();
+            }
+        }
+        showCollapsedThinking();
+        stopCurrentSpinner();
+        if (!s.renderer)
+            startAgentResponse();
+        if (needsGap)
+            writer.write("\n");
+        s.renderer.push(text);
+        drain();
+    }
+    define("render:code-block", (language, code, width) => {
+        flushForRaw();
+        if (language) {
+            s.renderer.writeLine(`${p.dim}${language}${p.reset}`);
+        }
+        let highlighted;
+        if (!language) {
+            // No language specified — render as plain text to avoid false syntax detection
+            highlighted = code;
+        }
+        else {
+            try {
+                highlighted = highlight(code, { language });
+            }
+            catch {
+                highlighted = `${p.success}${code}${p.reset}`;
+            }
+        }
+        const contentWidth = Math.min(90, width - 2);
+        for (const line of highlighted.split("\n")) {
+            const indented = `  ${line}`;
+            const wrapped = wrapLine(indented, contentWidth);
+            for (const wl of wrapped) {
+                s.renderer.writeLine(wl);
             }
         }
+        drain();
+    });
+    function writeCodeBlock(language, code) {
+        ctx.call("render:code-block", language, code, writer.columns);
+    }
+    function flushForRaw() {
+        closeToolLine();
         stopCurrentSpinner();
-        if (!renderer)
+        if (!s.renderer)
             startAgentResponse();
-        renderer.push(text);
-        flushOutput();
+        s.renderer.flush();
+        drain();
+    }
+    define("render:image", (data) => {
+        flushForRaw();
+        const escape = encodeImageForTerminal(data);
+        if (escape) {
+            writer.write("  " + escape + "\n");
+        }
+    });
+    function writeInlineImage(data) {
+        ctx.call("render:image", data);
     }
     function showToolCall(title, command, extra) {
+        closeToolLine();
         stopCurrentSpinner();
-        if (!renderer)
+        if (!s.renderer)
             startAgentResponse();
-        renderer.flush();
-        const termW = process.stdout.columns || 80;
+        showCollapsedThinking();
+        s.renderer.flush();
+        drain();
         const lines = renderToolCall({
             title,
             command: command || undefined,
             kind: extra?.kind,
             locations: extra?.locations,
             rawInput: extra?.rawInput,
-        }, termW);
-        for (const line of lines) {
-            renderer.writeLine(line);
+        }, writer.columns);
+        for (let i = 0; i < lines.length - 1; i++) {
+            s.renderer.writeLine(lines[i]);
         }
-        // Reset output tracking for the new tool
-        commandOutputLineCount = 0;
-        commandOutputOverflow = 0;
+        drain();
+        if (lines.length > 0) {
+            writer.write(`  ${lines[lines.length - 1]}`);
+            s.toolLineOpen = true;
+        }
+        s.hadToolCalls = true;
+        s.commandOutputLineCount = 0;
+        s.commandOutputOverflow = 0;
     }
     function showToolComplete(exitCode) {
-        if (!renderer)
+        if (!s.renderer)
             return;
-        const termW = process.stdout.columns || 80;
-        const lines = renderToolResult({ exitCode }, termW);
-        for (const line of lines) {
-            renderer.writeLine(line);
+        const mark = exitCode === null
+            ? `${p.muted}(timed out)${p.reset}`
+            : exitCode === 0
+                ? `${p.success}✓${p.reset}`
+                : `${p.error}✗ exit ${exitCode}${p.reset}`;
+        if (s.toolLineOpen && s.commandOutputLineCount === 0) {
+            writer.write(` ${mark}\n`);
+            s.toolLineOpen = false;
         }
+        else {
+            closeToolLine();
+            flushCommandOutput();
+            s.renderer.writeLine(`  ${mark}`);
+            drain();
+        }
+    }
+    function hasThinkingMode() {
+        const mode = getAcpClient().getCurrentMode();
+        return !mode || mode.id !== "off";
     }
-    function startThinkingSpinner(label = "Thinking") {
+    function startThinkingSpinner() {
+        if (!s.spinnerStartTime)
+            s.spinnerStartTime = Date.now();
         stopCurrentSpinner();
-        spinner = startSpinner(label);
+        const thinking = hasThinkingMode();
+        s.spinnerLabel = thinking ? "Thinking" : "Working";
+        const hint = thinking
+            ? (s.showThinkingText ? "(ctrl+t to collapse)" : "(ctrl+t to expand)")
+            : "";
+        s.spinnerOpts = { hint: hint || undefined, startTime: s.spinnerStartTime };
+        s.spinner = createSpinner({ startTime: s.spinnerStartTime });
+        s.spinnerInterval = setInterval(() => {
+            if (s.spinner) {
+                const line = renderSpinnerLine(s.spinner, s.spinnerLabel, s.spinnerOpts);
+                writer.write(`\r  ${line}\x1b[K`);
+            }
+        }, 80);
     }
     function stopCurrentSpinner() {
-        if (spinner) {
-            stopToolSpinner(spinner);
-            spinner = null;
+        if (s.spinnerInterval) {
+            clearInterval(s.spinnerInterval);
+            s.spinnerInterval = null;
+        }
+        if (s.spinner) {
+            writer.write("\r\x1b[2K");
+            s.spinner = null;
+        }
+    }
+    function closeToolLine() {
+        if (s.toolLineOpen) {
+            writer.write("\n");
+            s.toolLineOpen = false;
         }
     }
     function writeCommandOutput(chunk) {
-        if (!renderer)
+        if (!s.renderer)
             return;
-        commandOutputBuffer += chunk;
-        const lines = commandOutputBuffer.split("\n");
-        commandOutputBuffer = lines.pop();
+        closeToolLine();
+        const maxLines = s.currentToolKind === "read"
+            ? getSettings().readOutputMaxLines
+            : getSettings().maxCommandOutputLines;
+        s.commandOutputBuffer += chunk;
+        const lines = s.commandOutputBuffer.split("\n");
+        s.commandOutputBuffer = lines.pop();
         for (const line of lines) {
-            if (commandOutputLineCount < MAX_COMMAND_OUTPUT_LINES) {
-                renderer.writeLine(`${p.dim}  ${line}${p.reset}`);
-                commandOutputLineCount++;
+            if (s.commandOutputLineCount < maxLines) {
+                s.renderer.writeLine(`${p.dim}  ${line}${p.reset}`);
+                s.commandOutputLineCount++;
             }
             else {
-                commandOutputOverflow++;
+                s.commandOutputOverflow++;
             }
         }
+        drain();
     }
     function flushCommandOutput() {
-        if (!renderer)
+        if (!s.renderer)
             return;
-        if (commandOutputBuffer) {
-            if (commandOutputLineCount < MAX_COMMAND_OUTPUT_LINES) {
-                renderer.writeLine(`${p.dim}  ${commandOutputBuffer}${p.reset}`);
-                commandOutputLineCount++;
+        const maxLines = s.currentToolKind === "read"
+            ? getSettings().readOutputMaxLines
+            : getSettings().maxCommandOutputLines;
+        if (s.commandOutputBuffer) {
+            if (s.commandOutputLineCount < maxLines) {
+                s.renderer.writeLine(`${p.dim}  ${s.commandOutputBuffer}${p.reset}`);
+                s.commandOutputLineCount++;
             }
             else {
-                commandOutputOverflow++;
+                s.commandOutputOverflow++;
             }
-            commandOutputBuffer = "";
+            s.commandOutputBuffer = "";
         }
-        if (commandOutputOverflow > 0) {
-            renderer.writeLine(`${p.dim}  … ${commandOutputOverflow} more lines${p.reset}`);
-            commandOutputOverflow = 0;
+        if (s.commandOutputOverflow > 0 && maxLines > 0) {
+            s.renderer.writeLine(`${p.dim}  … ${s.commandOutputOverflow} more lines${p.reset}`);
         }
+        s.commandOutputOverflow = 0;
+        drain();
     }
-    const DIFF_MAX_LINES = 20;
     function diffTitle(filePath, diff) {
         const stats = diff.isNewFile
             ? `${p.success}+${diff.added}${p.reset}`
@@ -252,23 +476,22 @@ export default function activate({ bus }) {
     function showFileDiff(filePath, diff) {
         if (diff.isIdentical)
             return;
-        const termW = process.stdout.columns || 80;
-        const boxW = Math.min(84, termW);
+        const boxW = Math.min(84, writer.columns);
         const contentW = boxW - 4;
         const diffLines = renderDiff(diff, {
             width: contentW,
             filePath,
-            maxLines: DIFF_MAX_LINES,
+            maxLines: getSettings().diffMaxLines,
             trueColor: true,
             mode: "unified",
         });
         const lastLine = diffLines[diffLines.length - 1] ?? "";
         const isTruncated = lastLine.includes("… ");
         if (isTruncated) {
-            lastTruncatedDiff = { filePath, diff, expanded: false };
+            s.lastTruncatedDiff = { filePath, diff, expanded: false };
         }
         else {
-            lastTruncatedDiff = null;
+            s.lastTruncatedDiff = null;
         }
         const body = diffLines.length > 1 ? ["", ...diffLines.slice(1), ""] : diffLines;
         const footer = isTruncated
@@ -281,16 +504,17 @@ export default function activate({ bus }) {
             title: diffTitle(filePath, diff),
             footer,
         });
-        if (!renderer)
+        if (!s.renderer)
             startAgentResponse();
         for (const line of framed) {
-            renderer.writeLine(line);
+            s.renderer.writeLine(line);
         }
+        drain();
     }
     function expandLastDiff() {
-        if (!lastTruncatedDiff)
+        if (!s.lastTruncatedDiff)
             return;
-        const entry = lastTruncatedDiff;
+        const entry = s.lastTruncatedDiff;
         entry.expanded = !entry.expanded;
         if (!entry.expanded) {
             showFileDiffCached(entry);
@@ -298,8 +522,7 @@ export default function activate({ bus }) {
         }
         if (!entry.expandedLines) {
             const { filePath, diff } = entry;
-            const termW = process.stdout.columns || 80;
-            const boxW = Math.min(120, termW);
+            const boxW = Math.min(120, writer.columns);
             const contentW = boxW - 4;
             const diffLines = renderDiff(diff, {
                 width: contentW,
@@ -316,20 +539,19 @@ export default function activate({ bus }) {
                 footer: [`  ${p.dim}ctrl+o to collapse${p.reset}`],
             });
         }
-        process.stdout.write("\n");
+        writer.write("\n");
         for (const line of entry.expandedLines) {
-            process.stdout.write(line + "\n");
+            writer.write(line + "\n");
         }
     }
     function showFileDiffCached(entry) {
         const { filePath, diff } = entry;
-        const termW = process.stdout.columns || 80;
-        const boxW = Math.min(84, termW);
+        const boxW = Math.min(84, writer.columns);
         const contentW = boxW - 4;
         const diffLines = renderDiff(diff, {
             width: contentW,
             filePath,
-            maxLines: DIFF_MAX_LINES,
+            maxLines: getSettings().diffMaxLines,
             trueColor: true,
             mode: "unified",
         });
@@ -341,20 +563,41 @@ export default function activate({ bus }) {
             title: diffTitle(filePath, diff),
             footer: [`  ${p.dim}ctrl+o to expand${p.reset}`],
         });
-        process.stdout.write("\n");
+        writer.write("\n");
         for (const line of framed) {
-            process.stdout.write(line + "\n");
+            writer.write(line + "\n");
         }
     }
     function toggleThinkingDisplay() {
-        showThinkingText = !showThinkingText;
-        const state = showThinkingText ? "on" : "off";
-        process.stdout.write(`\n${p.dim}Thinking display: ${state}${p.reset}\n`);
+        s.showThinkingText = !s.showThinkingText;
+        if (s.spinner) {
+            stopCurrentSpinner();
+            startThinkingSpinner();
+            return;
+        }
+        if (!s.isThinking)
+            return;
+        if (s.showThinkingText) {
+            stopCurrentSpinner();
+            if (!s.renderer)
+                startAgentResponse();
+            s.renderer.writeLine(`${p.dim}Thinking (ctrl+t to collapse)${p.reset}`);
+            drain();
+        }
+        else {
+            if (s.renderer) {
+                s.renderer.flush();
+                const w = Math.min(80, writer.columns);
+                s.renderer.writeLine(`${p.dim}${"─".repeat(w)}${p.reset}`);
+                drain();
+            }
+            startThinkingSpinner();
+        }
     }
     function showError(message) {
-        process.stdout.write(`\n${p.error}Error: ${message}${p.reset}\n`);
+        writer.write(`\n${p.error}Error: ${message}${p.reset}\n`);
     }
     function showInfo(message) {
-        process.stdout.write(`${p.muted}${message}${p.reset}\n`);
+        writer.write(`${p.muted}${message}${p.reset}\n`);
     }
 }