@zhijiewang/openharness 2.5.0 → 2.8.0

package/dist/renderer/layout.js

@@ -1,489 +1,15 @@
 /**
  * Layout engine — rasterizes application state into a CellGrid.
  * Split screen: messages area (top) + footer (bottom).
+ *
+ * Section renderers are in layout-sections.ts.
+ * This file contains types and the two main rasterization functions.
  */
-import { getTheme } from "../utils/theme-data.js";
-import { renderDiff } from "./diff.js";
-import { isImageOutput, renderImageInline } from "./image.js";
+import { computeCursorPosition, ensureStyles, getPromptText, renderAutocompleteSection, renderBannerSection, renderCompanionSection, renderContextWarningSection, renderErrorSection, renderInputSection, renderNotificationsSection, renderPermissionBoxSection, renderQuestionPromptSection, renderSpinnerSection, renderStatusLineSection, renderThinkingSection, renderThinkingSummarySection, renderToolCallsSection, S_ASSISTANT, S_BANNER, S_BANNER_DIM, S_BORDER, S_DIM, S_ERROR, S_TEXT, S_USER, } from "./layout-sections.js";
 import { measureMarkdown, renderMarkdown } from "./markdown.js";
 import { renderSessionBrowser } from "./session-browser.js";
-// ── Style constants ──
-const s = (fg, bold = false, dim = false) => ({ fg, bg: null, bold, dim, underline: false });
-const S_TEXT = s(null);
-const S_DIM = s(null, false, true);
-const S_BORDER = s(null, false, true);
-const S_BRIGHT = s(null);
-const S_BANNER = s("cyan");
-const S_BANNER_DIM = s(null, false, true);
-const S_AGENT = s("cyan", true);
-const S_KEY_GREEN = s("green", true);
-const S_KEY_RED = s("red", true);
-const S_KEY_CYAN = s("cyan", true);
-// Theme-dependent styles — lazily initialized on first rasterize() call
-let S_USER;
-let S_ASSISTANT;
-let S_ERROR;
-let S_YELLOW;
-let S_GREEN;
-let _stylesInit = false;
-/** Reset style cache — call after theme change */
-export function resetStyleCache() {
-    _stylesInit = false;
-}
-function ensureStyles() {
-    if (_stylesInit)
-        return;
-    _stylesInit = true;
-    const t = getTheme();
-    S_USER = s(t.user, true);
-    S_ASSISTANT = s(t.assistant, true);
-    S_ERROR = s(t.error);
-    S_YELLOW = s(t.tool);
-    S_GREEN = s(t.success);
-}
-const SPINNER_CHARS = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-// ── Shared rendering helpers ──
-// Each takes (state, grid, row, limit, ...options) and returns next row.
-function renderBannerSection(state, grid, r, limit, opts) {
-    if (!state.bannerLines)
-        return r;
-    const startLine = opts.compact ? Math.max(0, state.bannerLines.length - 2) : 0;
-    for (let i = startLine; i < state.bannerLines.length; i++) {
-        if (r >= limit)
-            break;
-        const line = state.bannerLines[i];
-        const isBannerArt = i < state.bannerLines.length - 2;
-        grid.writeText(r, 0, line, isBannerArt ? S_BANNER : S_BANNER_DIM);
-        r++;
-    }
-    if (r < limit)
-        r++; // blank line after banner
-    return r;
-}
-function renderThinkingSection(state, grid, r, limit) {
-    if (!state.thinkingText || r >= limit)
-        return r;
-    const w = grid.width;
-    if (state.thinkingExpanded) {
-        const thinkLines = state.thinkingText.split("\n").slice(-10);
-        const shimmerPos = state.spinnerFrame % 20;
-        for (const tLine of thinkLines) {
-            if (r >= limit)
-                break;
-            grid.writeText(r, 0, "💭 ", S_DIM);
-            const chars = [...tLine];
-            for (let ci = 0; ci < chars.length && ci + 3 < w; ci++) {
-                grid.setCell(r, 3 + ci, chars[ci], Math.abs(ci - shimmerPos) <= 2 ? S_BRIGHT : S_DIM);
-            }
-            r++;
-        }
-    }
-    else {
-        const lineCount = state.thinkingText.split("\n").length;
-        const elapsed = state.thinkingStartedAt ? Math.floor((Date.now() - state.thinkingStartedAt) / 1000) : 0;
-        const summary = `∴ Thinking${elapsed > 0 ? ` (${elapsed}s)` : ""} — ${lineCount} lines [Ctrl+O expand]`;
-        grid.writeText(r, 0, summary, S_DIM);
-        r++;
-    }
-    return r;
-}
-function renderThinkingSummarySection(state, grid, r, limit) {
-    if (state.loading || !state.lastThinkingSummary || r >= limit)
-        return r;
-    grid.writeText(r, 0, state.lastThinkingSummary, S_DIM);
-    return r + 1;
-}
-function renderSpinnerSection(state, grid, r, limit) {
-    if (!state.loading || state.streamingText || state.thinkingText || r >= limit)
-        return r;
-    const _w = grid.width;
-    const thinkText = "Thinking";
-    const elapsed = state.thinkingStartedAt ? Math.floor((Date.now() - state.thinkingStartedAt) / 1000) : 0;
-    const t = getTheme();
-    const baseColor = elapsed > 60 ? t.error : elapsed > 30 ? t.stall : t.primary;
-    const shimmerColor = elapsed > 60 ? t.stallShimmer : elapsed > 30 ? t.warning : t.primaryShimmer;
-    const baseStyle = { fg: baseColor, bg: null, bold: false, dim: false, underline: false };
-    grid.writeText(r, 0, "◆ ", { ...baseStyle, bold: true });
-    const shimmerPos = state.spinnerFrame % (thinkText.length + 6);
-    const shimmerStyle = { fg: shimmerColor, bg: null, bold: true, dim: false, underline: false };
-    for (let ci = 0; ci < thinkText.length; ci++) {
-        grid.setCell(r, 2 + ci, thinkText[ci], Math.abs(ci - shimmerPos) <= 1 ? shimmerStyle : baseStyle);
-    }
-    let suffix = "";
-    if (elapsed > 0)
-        suffix += ` ${elapsed}s`;
-    if (state.tokenCount > 0) {
-        const tokStr = state.tokenCount >= 1000 ? `${(state.tokenCount / 1000).toFixed(1)}K` : `${state.tokenCount}`;
-        suffix += ` | ${tokStr} tokens`;
-    }
-    suffix += "...";
-    grid.writeText(r, 2 + thinkText.length, suffix, S_DIM);
-    return r + 1;
-}
-function renderErrorSection(state, grid, r, limit) {
-    if (!state.errorText || r >= limit)
-        return r;
-    const w = grid.width;
-    grid.writeText(r, 0, "✗ ", S_ERROR);
-    grid.writeText(r, 2, state.errorText.slice(0, w - 4), S_ERROR);
-    return r + 1;
-}
-function renderToolCallsSection(state, grid, r, limit, opts) {
-    const w = grid.width;
-    for (const [callId, tc] of state.toolCalls) {
-        if (r >= limit)
-            break;
-        const isAgent = tc.isAgent || tc.toolName === "Agent" || tc.toolName === "ParallelAgents";
-        const icon = isAgent
-            ? tc.status === "running"
-                ? "⊕"
-                : tc.status === "done"
-                    ? "◈"
-                    : "◇"
-            : tc.status === "running"
-                ? SPINNER_CHARS[state.spinnerFrame % SPINNER_CHARS.length]
-                : tc.status === "done"
-                    ? "✓"
-                    : "✗";
-        const statusStyle = tc.status === "error" ? S_ERROR : tc.status === "done" ? S_GREEN : isAgent ? S_AGENT : S_YELLOW;
-        const nameStyle = isAgent ? S_AGENT : { ...S_YELLOW, bold: true };
-        const isExpanded = state.expandedToolCalls.has(callId);
-        const canExpand = tc.status !== "running" && tc.output;
-        // Collapse/expand indicator
-        if (canExpand) {
-            grid.writeText(r, 0, isExpanded ? "▼" : "▶", S_DIM);
-        }
-        grid.writeText(r, 2, `${icon} `, statusStyle);
-        grid.writeText(r, 4, tc.toolName, nameStyle);
-        let afterName = 4 + tc.toolName.length + 1;
-        if (tc.args) {
-            const maxArgs = w - afterName - 15;
-            if (maxArgs > 5) {
-                const argsText = tc.args.slice(0, maxArgs) + (tc.args.length > maxArgs ? "…" : "");
-                grid.writeText(r, afterName, argsText, S_DIM);
-                afterName += argsText.length + 1;
-            }
-        }
-        // Elapsed time for running tools
-        if (tc.status === "running" && tc.startedAt) {
-            const elapsed = Math.floor((Date.now() - tc.startedAt) / 1000);
-            if (elapsed > 0) {
-                const lineCount = tc.liveOutput?.length ?? 0;
-                const elapsedStr = lineCount > 0 ? `${elapsed}s · ${lineCount} lines` : `${elapsed}s`;
-                grid.writeText(r, Math.min(afterName, w - elapsedStr.length - 2), elapsedStr, S_DIM);
-            }
-        }
-        // Result summary for completed tools
-        if (tc.status !== "running" && tc.resultSummary) {
-            const elapsed = tc.startedAt ? Math.floor((Date.now() - tc.startedAt) / 1000) : 0;
-            const suffix = elapsed > 0 ? `${tc.resultSummary} · ${elapsed}s` : tc.resultSummary;
-            grid.writeText(r, Math.min(afterName, w - suffix.length - 2), suffix, S_DIM);
-        }
-        r++;
-        // Agent description line
-        if (isAgent && tc.agentDescription && r < limit) {
-            grid.writeText(r, 6, tc.agentDescription.slice(0, w - 8), S_DIM);
-            r++;
-        }
-        // Live streaming output while running
-        if (tc.status === "running" && tc.liveOutput && tc.liveOutput.length > 0) {
-            const overflow = tc.liveOutput.length > opts.maxLiveLines ? tc.liveOutput.length - opts.maxLiveLines : 0;
-            if (opts.showOverflow && overflow > 0 && r < limit) {
-                grid.writeText(r, 6, `… (${overflow} earlier lines)`, S_DIM);
-                r++;
-            }
-            const visible = overflow > 0 ? tc.liveOutput.slice(-opts.maxLiveLines) : tc.liveOutput;
-            for (const line of visible) {
-                if (r >= limit)
-                    break;
-                grid.writeText(r, 6, line.slice(0, w - 8), S_DIM);
-                r++;
-            }
-        }
-        // Final output — collapsed by default (only show when expanded via Tab)
-        if (tc.output && tc.status !== "running" && isExpanded && r < limit) {
-            // Image results: show inline placeholder
-            if (isImageOutput(tc.output)) {
-                const label = renderImageInline(tc.output);
-                grid.writeText(r, 6, label.slice(0, w - 8), S_DIM);
-                r++;
-                continue;
-            }
-            const outLines = tc.output.split("\n");
-            const maxOut = 20;
-            const showLines = outLines.slice(0, maxOut);
-            for (const line of showLines) {
-                if (r >= limit)
-                    break;
-                const lineStyle = tc.status === "error" ? S_ERROR : S_DIM;
-                grid.writeText(r, 6, line.slice(0, w - 8), lineStyle);
-                r++;
-            }
-            if (outLines.length > maxOut && r < limit) {
-                grid.writeText(r, 6, `… (${outLines.length} lines total)`, S_DIM);
-                r++;
-            }
-        }
-    }
-    return r;
-}
-function renderContextWarningSection(state, grid, r, limit) {
-    if (!state.contextWarning || r >= limit)
-        return r;
-    const warnStyle = {
-        fg: "yellow",
-        bg: null,
-        bold: state.contextWarning.critical,
-        dim: false,
-        underline: false,
-    };
-    grid.writeText(r, 0, state.contextWarning.text, warnStyle);
-    return r + 1;
-}
-function renderPermissionBoxSection(state, grid, nextRow, h, opts) {
-    if (!state.permissionBox || grid.width < 20)
-        return nextRow;
-    const w = grid.width;
-    const { toolName, description, riskLevel } = state.permissionBox;
-    const riskColor = riskLevel === "high" ? "red" : riskLevel === "medium" ? "yellow" : "green";
-    const riskStyle = { fg: riskColor, bg: null, bold: true, dim: false, underline: false };
-    if (opts.boxed) {
-        if (h - nextRow < 6)
-            return nextRow;
-        const riskDim = { fg: riskColor, bg: null, bold: false, dim: true, underline: false };
-        const boxWidth = Math.max(15, Math.min(w - 2, 70));
-        // Top border
-        grid.writeText(nextRow, 1, `╭${"─".repeat(boxWidth - 2)}╮`, riskDim);
-        nextRow++;
-        // Tool name + risk
-        grid.writeText(nextRow, 1, "│ ", riskDim);
-        grid.writeText(nextRow, 3, "⚠ ", riskStyle);
-        grid.writeText(nextRow, 5, toolName, { ...riskStyle });
-        grid.writeText(nextRow, 5 + toolName.length, ` ${riskLevel} risk`, S_DIM);
-        grid.writeText(nextRow, boxWidth, "│", riskDim);
-        nextRow++;
-        // Description (truncated)
-        const rawDesc = state.permissionBox.suggestion || description.slice(0, boxWidth - 6);
-        const descText = rawDesc.replace(/\|/g, " ").replace(/\\/g, "/");
-        grid.writeText(nextRow, 1, "│ ", riskDim);
-        grid.writeText(nextRow, 3, descText.slice(0, boxWidth - 4), S_DIM);
-        grid.writeText(nextRow, boxWidth, "│", riskDim);
-        nextRow++;
-        // Inline diff
-        if (state.permissionDiffVisible && state.permissionDiffInfo && nextRow + 3 < h) {
-            grid.writeText(nextRow, 1, "│", riskDim);
-            nextRow++;
-            const availDiffRows = Math.min(opts.maxDiffHeight, h - nextRow - 3);
-            const diffRows = renderDiff(grid, nextRow, 3, state.permissionDiffInfo, boxWidth - 2, availDiffRows);
-            for (let dr = 0; dr < diffRows; dr++) {
-                if (nextRow + dr < grid.height) {
-                    grid.setCell(nextRow + dr, 1, "│", riskDim);
-                    grid.setCell(nextRow + dr, boxWidth, "│", riskDim);
-                }
-            }
-            nextRow += diffRows;
-        }
-        // Action keys
-        grid.writeText(nextRow, 1, "│ ", riskDim);
-        let kc = 3;
-        grid.writeText(nextRow, kc, "Y", S_KEY_GREEN);
-        kc += 1;
-        grid.writeText(nextRow, kc, "es", S_DIM);
-        kc += 2;
-        grid.writeText(nextRow, kc, "  ", S_DIM);
-        kc += 2;
-        grid.writeText(nextRow, kc, "N", S_KEY_RED);
-        kc += 1;
-        grid.writeText(nextRow, kc, "o", S_DIM);
-        kc += 1;
-        if (state.permissionDiffInfo) {
-            grid.writeText(nextRow, kc, "  ", S_DIM);
-            kc += 2;
-            grid.writeText(nextRow, kc, "D", S_KEY_CYAN);
-            kc += 1;
-            grid.writeText(nextRow, kc, "iff", S_DIM);
-            kc += 3;
-        }
-        grid.writeText(nextRow, boxWidth, "│", riskDim);
-        nextRow++;
-        // Bottom border
-        grid.writeText(nextRow, 1, `╰${"─".repeat(boxWidth - 2)}╯`, riskDim);
-        nextRow++;
-    }
-    else {
-        // Compact mode (rasterizeLive)
-        if (h - nextRow < 4)
-            return nextRow;
-        grid.writeText(nextRow, 1, `⚠ ${toolName} (${riskLevel} risk)`, riskStyle);
-        nextRow++;
-        grid.writeText(nextRow, 1, "Y", S_KEY_GREEN);
-        grid.writeText(nextRow, 2, "es  ", S_DIM);
-        grid.writeText(nextRow, 6, "N", S_KEY_RED);
-        grid.writeText(nextRow, 7, "o", S_DIM);
-        if (state.permissionDiffInfo) {
-            grid.writeText(nextRow, 10, "D", S_KEY_CYAN);
-            grid.writeText(nextRow, 11, "iff", S_DIM);
-        }
-        nextRow++;
-        // Inline diff (when toggled)
-        if (state.permissionDiffVisible && state.permissionDiffInfo && nextRow + 3 < h) {
-            const availDiffRows = Math.min(15, h - nextRow - 3);
-            const diffRows = renderDiff(grid, nextRow, 3, state.permissionDiffInfo, Math.min(w - 2, 70), availDiffRows);
-            nextRow += diffRows;
-        }
-    }
-    return nextRow;
-}
-function renderQuestionPromptSection(state, grid, nextRow, h, opts) {
-    if (!state.questionPrompt || grid.width < 20)
-        return { nextRow, questionInputRow: -1 };
-    const w = grid.width;
-    const { question, options, input, cursor } = state.questionPrompt;
-    const qStyle = { fg: "yellow", bg: null, bold: false, dim: false, underline: false };
-    if (opts.boxed) {
-        const qBorder = { fg: "yellow", bg: null, bold: false, dim: true, underline: false };
-        const qBoxWidth = Math.max(15, Math.min(w - 2, 70));
-        grid.writeText(nextRow, 1, `╭${"─".repeat(qBoxWidth - 2)}╮`, qBorder);
-        nextRow++;
-        grid.writeText(nextRow, 1, "│ ", qBorder);
-        grid.writeText(nextRow, 3, `❓ ${question}`, qStyle);
-        grid.writeText(nextRow, qBoxWidth, "│", qBorder);
-        nextRow++;
-        if (options && options.length > 0) {
-            for (let oi = 0; oi < options.length; oi++) {
-                grid.writeText(nextRow, 1, "│ ", qBorder);
-                grid.writeText(nextRow, 5, `${oi + 1}. ${options[oi]}`, S_DIM);
-                grid.writeText(nextRow, qBoxWidth, "│", qBorder);
-                nextRow++;
-            }
-        }
-        const questionInputRow = nextRow;
-        grid.writeText(nextRow, 1, "│ ", qBorder);
-        grid.writeText(nextRow, 3, "❯ ", qStyle);
-        grid.writeText(nextRow, 5, input, S_TEXT);
-        grid.writeText(nextRow, qBoxWidth, "│", qBorder);
-        nextRow++;
-        grid.writeText(nextRow, 1, `╰${"─".repeat(qBoxWidth - 2)}╯`, qBorder);
-        nextRow++;
-        return { nextRow, questionInputRow };
-    }
-    else {
-        // Compact mode (rasterizeLive)
-        if (h - nextRow < 3)
-            return { nextRow, questionInputRow: -1 };
-        grid.writeText(nextRow, 1, `❓ ${question}`, S_TEXT);
-        nextRow++;
-        if (options) {
-            for (const opt of options) {
-                if (nextRow >= h)
-                    break;
-                grid.writeText(nextRow, 3, opt, S_DIM);
-                nextRow++;
-            }
-        }
-        const questionInputRow = nextRow;
-        grid.writeText(nextRow, 1, "❯ ", S_USER);
-        grid.writeText(nextRow, 3, input, S_TEXT);
-        nextRow++;
-        return { nextRow, questionInputRow };
-    }
-}
-function renderStatusLineSection(state, grid, nextRow, limit) {
-    if (!state.statusLine || nextRow >= limit)
-        return nextRow;
-    grid.writeText(nextRow, 0, state.statusLine, S_DIM);
-    return nextRow + 1;
-}
-function renderAutocompleteSection(state, grid, nextRow, limit, promptWidth) {
-    if (state.autocomplete.length === 0)
-        return nextRow;
-    const w = grid.width;
-    for (let ai = 0; ai < state.autocomplete.length; ai++) {
-        if (nextRow >= limit)
-            break;
-        const cmd = state.autocomplete[ai];
-        const desc = state.autocompleteDescriptions[ai] ?? "";
-        const selected = ai === state.autocompleteIndex;
-        const acStyle = selected ? s(getTheme().user, true) : s(null, false, true);
-        grid.writeText(nextRow, promptWidth, `/${cmd.padEnd(12)}`, acStyle);
-        if (desc && w > promptWidth + 15)
-            grid.writeText(nextRow, promptWidth + 13, desc.slice(0, w - promptWidth - 15), S_DIM);
-        nextRow++;
-    }
-    return nextRow;
-}
-function renderNotificationsSection(state, grid, nextRow, limit) {
-    if (!state.notifications || state.notifications.length === 0)
-        return nextRow;
-    for (const note of state.notifications.slice(-2)) {
-        if (nextRow >= limit)
-            break;
-        grid.writeText(nextRow, 0, `  ⚡ ${note.text}`, S_YELLOW);
-        nextRow++;
-    }
-    return nextRow;
-}
-function renderInputSection(state, grid, inputRow, limit, promptText, promptWidth) {
-    grid.writeText(inputRow, 0, promptText, S_USER);
-    const inputStart = promptWidth;
-    const inputLines = state.inputText.split("\n");
-    const maxInputLines = Math.min(inputLines.length, 5);
-    for (let li = 0; li < maxInputLines; li++) {
-        if (inputRow + li >= limit)
-            break;
-        if (li === 0) {
-            grid.writeText(inputRow, inputStart, inputLines[0], S_TEXT);
-        }
-        else {
-            grid.writeText(inputRow + li, inputStart, inputLines[li], S_TEXT);
-        }
-    }
-    // Line count indicator for multi-line input
-    if (inputLines.length > 1) {
-        const lineCountStr = ` [${inputLines.length} lines]`;
-        const lineCountCol = Math.min(inputStart + (inputLines[0]?.length ?? 0) + 1, grid.width - lineCountStr.length - 1);
-        if (lineCountCol > inputStart)
-            grid.writeText(inputRow, lineCountCol, lineCountStr, S_DIM);
-    }
-    const hintsRow = inputRow + maxInputLines;
-    if (hintsRow < limit) {
-        const hintsText = inputLines.length > 1 ? `${state.statusHints} | Alt+Enter newline` : state.statusHints;
-        grid.writeText(hintsRow, 0, hintsText, S_DIM);
-    }
-    return inputRow + maxInputLines + 1;
-}
-function renderCompanionSection(state, grid, anchorRow, limit, promptWidth) {
-    if (!state.companionLines || grid.width < 50)
-        return;
-    const w = grid.width;
-    const compWidth = Math.max(...state.companionLines.map((l) => l.length), 0);
-    const compStartCol = Math.max(0, w - compWidth - 1);
-    if (compStartCol <= promptWidth + 20)
-        return;
-    const compStyle = { fg: state.companionColor || "cyan", bg: null, bold: false, dim: false, underline: false };
-    for (let i = 0; i < state.companionLines.length; i++) {
-        const compRow = anchorRow + i;
-        if (compRow >= limit)
-            break;
-        grid.writeText(compRow, compStartCol, state.companionLines[i], compStyle);
-    }
-}
-function computeCursorPosition(state, inputRow, inputStart, questionInputRow) {
-    if (state.questionPrompt && questionInputRow >= 0) {
-        // In boxed mode cursor col is 5 (after "│ ❯ "), in compact mode it's 3 (after "❯ ")
-        return { cursorRow: questionInputRow, cursorCol: 5 + state.questionPrompt.cursor };
-    }
-    const textBeforeCursor = state.inputText.slice(0, state.inputCursor);
-    const cursorLines = textBeforeCursor.split("\n");
-    const cursorLineIdx = Math.min(cursorLines.length - 1, 4);
-    const cursorColInLine = cursorLines[cursorLines.length - 1].length;
-    return { cursorRow: inputRow + cursorLineIdx, cursorCol: inputStart + cursorColInLine };
-}
-function getPromptText(state) {
-    const vimIndicator = state.vimMode ? (state.vimMode === "normal" ? "[N] " : "[I] ") : "";
-    const promptText = `${vimIndicator}❯ `;
-    return { promptText, promptWidth: promptText.length };
-}
+// Re-export for consumers
+export { resetStyleCache } from "./layout-sections.js";
 // ── Main rasterization functions ──
 /**
  * Rasterize application state into the cell grid.
@@ -510,7 +36,7 @@ export function rasterize(state, grid) {
         contextWarningHeight;
     const footerHeight = Math.min(rawFooterHeight, Math.floor(h / 2));
     const msgAreaHeight = Math.max(1, h - footerHeight);
-    // ── Session browser overlay ──
+    // Session browser overlay
     if (state.sessionBrowser) {
         const browserRows = renderSessionBrowser(grid, 0, 0, state.sessionBrowser, w, msgAreaHeight);
         const footerStart = Math.min(browserRows, msgAreaHeight);
@@ -521,7 +47,7 @@ export function rasterize(state, grid) {
         grid.writeText(inputRow + 1, 0, "↑/↓ navigate | Enter resume | Esc cancel", S_DIM);
         return { cursorRow: inputRow, cursorCol: 2 };
     }
-    // ── Messages area (top) ──
+    // Messages area (top)
     const allContent = [];
     for (const msg of state.messages) {
         if (msg.role === "user") {
@@ -559,9 +85,9 @@ export function rasterize(state, grid) {
         allContent.push({ role: "error", content: state.errorText, style: S_ERROR, prefixStyle: S_ERROR, prefix: "✗ " });
     }
     const prefixLen = 2;
-    const contentWidth = w - 1; // reserve rightmost column for scrollbar
+    const contentWidth = w - 1;
     const textWidth = contentWidth - prefixLen;
-    // Pre-compute total height to handle scrolling
+    // Pre-compute total height for scrolling
     let totalRows = 0;
     if (state.bannerLines && h >= 30) {
         const compact = h < 40;
@@ -613,7 +139,7 @@ export function rasterize(state, grid) {
     let r = 0;
     let virtualR = 0;
     let contentIdx = 0;
-    // ── Banner ──
+    // Banner
     if (state.bannerLines && h >= 30) {
         const compact = h < 40;
         const startLine = compact ? Math.max(0, state.bannerLines.length - 2) : 0;
@@ -631,7 +157,7 @@ export function rasterize(state, grid) {
         }
         virtualR++;
     }
-    // ── Messages ──
+    // Messages
     for (const item of allContent) {
         if (r >= msgAreaHeight)
             break;
@@ -672,13 +198,13 @@ export function rasterize(state, grid) {
         virtualR += itemRows;
         contentIdx++;
     }
-    // ── Thinking, spinner, tool calls, context warning (shared helpers) ──
+    // Thinking, spinner, tool calls, context warning
     r = renderThinkingSection(state, grid, r, msgAreaHeight);
     r = renderThinkingSummarySection(state, grid, r, msgAreaHeight);
     r = renderSpinnerSection(state, grid, r, msgAreaHeight);
     r = renderToolCallsSection(state, grid, r, msgAreaHeight, { maxLiveLines: 5, showOverflow: true });
     r = renderContextWarningSection(state, grid, r, msgAreaHeight);
-    // ── Scrollbar ──
+    // Scrollbar
     if (hasScrollbar) {
         const S_TRACK = { fg: null, bg: null, bold: false, dim: true, underline: false };
         const S_THUMB = { fg: null, bg: null, bold: false, dim: false, underline: false };
@@ -687,7 +213,7 @@ export function rasterize(state, grid) {
             grid.setCell(sr, w - 1, isThumb ? "█" : "░", isThumb ? S_THUMB : S_TRACK);
         }
     }
-    // ── Footer ──
+    // Footer
     const footerStart = Math.min(r, msgAreaHeight);
     for (let c = 0; c < w; c++) {
         grid.setCell(footerStart, c, "─", S_BORDER);
@@ -707,7 +233,7 @@ export function rasterize(state, grid) {
         grid.writeText(footerStart, startCol, indicator, S_DIM);
     }
     let nextRow = footerStart + 1;
-    // ── Permission, question, status, autocomplete, notifications, input, companion (shared helpers) ──
+    // Permission, question, status, autocomplete, notifications, input, companion
     nextRow = renderPermissionBoxSection(state, grid, nextRow, h, { boxed: true, maxDiffHeight });
     const questionResult = renderQuestionPromptSection(state, grid, nextRow, h, { boxed: true });
     nextRow = questionResult.nextRow;
@@ -718,7 +244,7 @@ export function rasterize(state, grid) {
     nextRow = renderNotificationsSection(state, grid, nextRow, h);
     const inputRow = nextRow;
     renderInputSection(state, grid, inputRow, h, promptText, promptWidth);
-    // Companion (right-aligned in footer, skipped if it would overlap input)
+    // Companion (right-aligned in footer)
     if (state.companionLines && w >= 50) {
         const compWidth = Math.max(...state.companionLines.map((l) => l.length), 0);
         const compStartCol = Math.max(0, w - compWidth - 1);
@@ -743,7 +269,6 @@ export function rasterize(state, grid) {
     }
     return computeCursorPosition(state, inputRow, promptWidth, questionInputRow);
 }
-// extractSuggestion moved to shared utils/tool-summary.ts as summarizeToolArgs
 /**
  * Rasterize only the "live area" — streaming text, thinking, tool calls, and footer.
  * Used in hybrid mode where completed messages are flushed to terminal scrollback.
@@ -754,32 +279,32 @@ export function rasterizeLive(state, grid) {
     const w = grid.width;
     const h = grid.height;
     let r = 0;
-    // ── Banner (shown when no messages have been flushed yet) ──
+    // Banner (shown when no messages have been flushed yet)
     if (state.bannerLines && state.messages.length === 0 && !state.loading) {
         r = renderBannerSection(state, grid, r, h - 4, { compact: h < 15 });
     }
-    // ── Streaming text ──
+    // Streaming text
     if (state.loading && state.streamingText) {
         grid.writeText(r, 0, "◆ ", S_ASSISTANT);
         const rows = renderMarkdown(grid, r, 2, state.streamingText, w, state.codeBlocksExpanded, h);
         r += rows;
     }
-    // ── Thinking, spinner, error, tool calls, context warning (shared helpers) ──
+    // Thinking, spinner, error, tool calls, context warning
     r = renderThinkingSection(state, grid, r, h);
     r = renderThinkingSummarySection(state, grid, r, h);
     r = renderSpinnerSection(state, grid, r, h);
     r = renderErrorSection(state, grid, r, h);
     r = renderToolCallsSection(state, grid, r, h, { maxLiveLines: 3, showOverflow: false });
     r = renderContextWarningSection(state, grid, r, h);
-    // ── Footer border ──
+    // Footer border
     if (r < h) {
         for (let c = 0; c < w; c++)
             grid.setCell(r, c, "─", S_BORDER);
         r++;
     }
     let nextRow = r;
-    const borderRow = r - 1; // for companion anchoring
-    // ── Permission, question, status, autocomplete, notifications, input (shared helpers) ──
+    const borderRow = r - 1;
+    // Permission, question, status, autocomplete, notifications, input
     nextRow = renderPermissionBoxSection(state, grid, nextRow, h, { boxed: false, maxDiffHeight: 15 });
     const questionResult = renderQuestionPromptSection(state, grid, nextRow, h, { boxed: false });
     nextRow = questionResult.nextRow;
@@ -790,9 +315,9 @@ export function rasterizeLive(state, grid) {
     nextRow = renderNotificationsSection(state, grid, nextRow, h);
     const inputRow = nextRow;
     renderInputSection(state, grid, inputRow, h, promptText, promptWidth);
-    // ── Companion (right-aligned, anchored at footer border) ──
+    // Companion (right-aligned, anchored at footer border)
     renderCompanionSection(state, grid, borderRow, h, promptWidth);
-    // ── Cursor position ──
+    // Cursor position
     if (state.questionPrompt && questionInputRow >= 0) {
         return { cursorRow: questionInputRow, cursorCol: 3 + state.questionPrompt.cursor };
     }

package/dist/tools/TodoWriteTool/index.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import type { Tool } from "../../Tool.js";
+declare const inputSchema: z.ZodObject<{
+    todos: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<["pending", "in_progress", "completed"]>>;
+        priority: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        status: "completed" | "pending" | "in_progress";
+        id: string;
+        priority?: "low" | "medium" | "high" | undefined;
+    }, {
+        content: string;
+        id: string;
+        status?: "completed" | "pending" | "in_progress" | undefined;
+        priority?: "low" | "medium" | "high" | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    todos: {
+        content: string;
+        status: "completed" | "pending" | "in_progress";
+        id: string;
+        priority?: "low" | "medium" | "high" | undefined;
+    }[];
+}, {
+    todos: {
+        content: string;
+        id: string;
+        status?: "completed" | "pending" | "in_progress" | undefined;
+        priority?: "low" | "medium" | "high" | undefined;
+    }[];
+}>;
+export declare const TodoWriteTool: Tool<typeof inputSchema>;
+export {};
+//# sourceMappingURL=index.d.ts.map