@pentoshi/clai 2.0.27 → 2.0.29

package/dist/repl.js

@@ -1,4 +1,4 @@
-import { clearLine, cursorTo, emitKeypressEvents, moveCursor, } from "node:readline";
+import { clearLine, cursorTo, emitKeypressEvents, moveCursor } from "node:readline";
 import { stdin as input, stdout as output } from "node:process";
 import chalk from "chalk";
 import { confirm } from "@inquirer/prompts";
@@ -11,9 +11,9 @@ import { getConfig, getProviderModel, setDefaultMode, setProviderModel, setThink
 import { listSessions, saveSession, clearAllHistory, getSession, } from "./store/history.js";
 import { assertProvider, defaultModels, getProviderInfoText } from "./llm/provider.js";
 import { getProvider, providerAuth } from "./llm/router.js";
-import { nvidiaFallbackModels } from "./llm/nvidia.js";
 import { runUpdate, checkForUpdateSilent, getCurrentVersion, } from "./commands/update.js";
-import { renderBanner, renderSessionInfo, renderSuggestions, renderModeSwitch, renderProviderSwitch, PROMPT, } from "./ui/banner.js";
+import { renderModeSwitch, renderProviderSwitch, PROMPT, } from "./ui/banner.js";
+import { renderIntroCard } from "./ui/intro-card.js";
 import { clearThinking, createThinkingStreamParser, getLastThinking, rememberThinkingFromText, renderAllThinking, renderThinkingSummary, renderThinkingToggleMessage, } from "./ui/thinking.js";
 import { createMarkdownStreamWriter, renderMarkdown } from "./ui/markdown.js";
 import { startThinkingSpinner } from "./ui/spinner.js";
@@ -24,280 +24,34 @@ import { renderPlanDocument, renderPlanChecklist } from "./ui/plan-pane.js";
 import { safeCwd, cwdIsBroken, recoverCwd } from "./os/cwd.js";
 import { compactMessages, estimateMessagesTokens, } from "./agent/context-manager.js";
 import { isCtrlC, isCtrlO, isCtrlP, isCtrlT, isEscape } from "./ui/keys.js";
-import { getMentionQuery, findFileSuggestions, expandMentions, loadImageAttachments, imageAttachmentPaths, } from "./ui/mentions.js";
+import { expandMentions, loadImageAttachments, imageAttachmentPaths, } from "./ui/mentions.js";
 import { imageOcr } from "./tools/image.js";
-/** Shared command catalogue used by both the classic REPL and the Ink TUI. */
-export const slashCommands = [
-    { command: "/ask", description: "switch to ask mode" },
-    { command: "/agent", description: "switch to agent mode" },
-    {
-        command: "/model",
-        usage: "[name|#]",
-        description: "open searchable picker (type/↑/↓ + Enter), or pass a name/number",
-    },
-    {
-        command: "/provider",
-        usage: "[name]",
-        description: "switch provider or open picker",
-    },
-    {
-        command: "/use",
-        usage: "<provider>",
-        description: "alias for /provider <name>",
-    },
-    { command: "/set", usage: "[provider] [key]", description: "store API key or open picker" },
-    { command: "/unset", usage: "[provider]", description: "remove key or open picker" },
-    { command: "/keys", description: "list configured providers" },
-    {
-        command: "/info",
-        usage: "[provider]",
-        description: "show info for the active or specified provider",
-    },
-    {
-        command: "/search",
-        usage: "[provider]",
-        description: "switch web.search provider or open picker",
-    },
-    {
-        command: "/search-provider",
-        usage: "[provider]",
-        description: "alias for /search",
-    },
-    {
-        command: "/mouse",
-        usage: "[on|off]",
-        description: "toggle touchpad transcript scrolling vs native selection",
-    },
-    {
-        command: "/variants",
-        usage: "[on|off|none|minimal|low|medium|high|xhigh]",
-        description: "toggle thinking/effort (interactive picker if no arg)",
-    },
-    {
-        command: "/reasoning",
-        usage: "[on|off|none|minimal|low|medium|high|xhigh]",
-        description: "alias for /variants",
-    },
-    { command: "/clear", description: "clear context" },
-    {
-        command: "/new",
-        description: "start a fresh session (clear context, no history carryover)",
-    },
-    {
-        command: "/history",
-        description: "browse & resume past sessions (interactive picker)",
-    },
-    { command: "/save", usage: "<name>", description: "save session" },
-    { command: "/reset", description: "clear all saved history" },
-    { command: "/cwd", usage: "<path>", description: "change working directory" },
-    {
-        command: "/allow",
-        usage: "<tool>|list",
-        description: "allow a tool for this session (not persisted)",
-    },
-    {
-        command: "/disallow",
-        usage: "<tool>",
-        description: "revoke a session allow",
-    },
-    { command: "/think", description: "show thinking from last response" },
-    { command: "/thinking", description: "alias for /think" },
-    {
-        command: "/output",
-        usage: "[last|<id>|list]",
-        description: "open full tool output (Ctrl+O); q closes the pager",
-    },
-    {
-        command: "/freeonly",
-        usage: "[on|off]",
-        description: "skip paid providers when fallback is enabled",
-    },
-    {
-        command: "/fallback",
-        usage: "[on|off]",
-        description: "try other configured providers after a failure (off by default)",
-    },
-    { command: "/compact", description: "compact session history now" },
-    { command: "/context", description: "show estimated context size" },
-    {
-        command: "/plan",
-        description: "view the current session plan (also Ctrl+P)",
-    },
-    {
-        command: "/implement",
-        description: "approve the current plan and have clai execute it",
-    },
-    {
-        command: "/discard",
-        description: "discard the current plan so later messages ignore it",
-    },
-    {
-        command: "/scope",
-        usage: "[show|clear|new|add <targets>]",
-        description: "manage pentest engagement scope",
-    },
-    {
-        command: "/privacy",
-        usage: "[status|clear-history|clear-logs|clear-artifacts|clear-all|on|off]",
-        description: "control retention and private mode (in-memory only)",
-    },
-    { command: "/update", description: "check for updates" },
-    {
-        command: "/clean",
-        description: "clear screen and reset chat (fresh start)",
-    },
-    { command: "/exit", description: "quit" },
-    { command: "/quit", description: "alias for /exit" },
-    { command: "/help", description: "list commands" },
-];
-// ── Well-known models per provider (refreshed May 2026) ───────────────────
-/** Curated model choices used by both frontends. */
-export const knownModels = {
-    groq: [
-        "openai/gpt-oss-20b",
-        "openai/gpt-oss-120b",
-        "openai/gpt-oss-safeguard-20b",
-        "qwen/qwen3-32b",
-        "llama-3.3-70b-versatile",
-        "llama-3.1-8b-instant",
-        "meta-llama/llama-4-scout-17b-16e-instruct",
-        "groq/compound-mini",
-        "groq/compound",
-    ],
-    gemini: [
-        "gemini-3.5-flash",
-        "gemini-3.1-pro-preview",
-        "gemini-3-flash-preview",
-        "gemini-3.1-flash-lite",
-        "gemini-3-pro-preview",
-        "gemini-2.5-pro",
-        "gemini-2.5-flash",
-        "gemini-2.5-flash-lite",
-        "gemini-2.0-flash",
-        "gemini-2.0-flash-lite",
-    ],
-    openrouter: [
-        "meta-llama/llama-3.3-70b-instruct:free",
-        "deepseek/deepseek-v4-flash:free",
-        "openai/gpt-oss-20b:free",
-        "qwen/qwen3-coder:free",
-        "qwen/qwen3-next-80b-a3b-instruct:free",
-        "google/gemma-4-31b-it:free",
-        "nvidia/nemotron-3-nano-30b-a3b:free",
-        "z-ai/glm-4.5-air:free",
-        "moonshotai/kimi-k2.6",
-        "meta-llama/llama-4-maverick",
-        "google/gemini-2.5-flash",
-    ],
-    openai: [
-        "gpt-5.5",
-        "gpt-5.5-pro",
-        "gpt-5.4",
-        "gpt-5.4-pro",
-        "gpt-5.4-mini",
-        "gpt-5.4-nano",
-        "gpt-rosalind",
-        "gpt-realtime-2",
-        "openai/gpt-oss-20b",
-        "openai/gpt-oss-120b",
-        "gpt-5",
-        "gpt-5-mini",
-        "gpt-5-nano",
-        "gpt-4o-mini",
-        "gpt-4o",
-    ],
-    anthropic: [
-        "claude-opus-4-7",
-        "claude-sonnet-4-6",
-        "claude-haiku-4-5",
-        "claude-opus-4-6",
-        "claude-sonnet-4-5",
-        "claude-3-5-sonnet-latest",
-        "claude-3-5-haiku-latest",
-    ],
-    nvidia: nvidiaFallbackModels,
-    ollama: [
-        "llama3.3:70b",
-        "llama3.2:3b",
-        "llama3.1:8b",
-        "qwen2.5:7b",
-        "qwen2.5-coder:7b",
-        "deepseek-r1:7b",
-        "mistral:7b",
-        "gemma3:9b",
-        "phi4:14b",
-        "codellama:7b",
-    ],
-    agentrouter: [
-        "claude-opus-4-6",
-        "claude-opus-4-7",
-        "claude-opus-4-8",
-        "glm-5.2",
-        "gpt-5.5",
-    ],
-    kimchi: [
-        "kimi-k2.6",
-        "minimax-m2.7",
-        "nemotron-3-super-fp4",
-    ],
-    "aws-mantle": [],
-    bynara: [
-        // Free tier models
-        "mimo-v2.5-free",
-        "mimo-v2.5-pro-free",
-        "mistral-large",
-        "mistral-medium-3-5",
-        // Pay-as-you-go / subscription models (from https://router.bynara.id/pricing)
-        "mimo-v2.5",
-        "mimo-v2.5-pro",
-        "mimo-v2.5-hermes",
-        "mimo-v2.5-pro-hermes",
-        "mimo-v2.5-pro-ultraspeed",
-        "claude-opus-4.7",
-        "claude-opus-4.8",
-        "claude-sonnet-4.6",
-        "claude-sonnet-4.5",
-        "claude-haiku-4.5",
-        "deepseek-v4-flash",
-        "deepseek-v4-pro",
-        "gemini-3-flash",
-        "gemini-3.1-pro",
-        "gemini-3.5-flash",
-        "gemini-2.5-flash",
-        "glm-5.1",
-        "glm-5.2",
-        "gpt-5.4",
-        "gpt-5.5",
-        "kimi-k2.6",
-        "kimi-k2.7-code",
-        "minimax-m3",
-        "qwen-3.7-max",
-        "qwen-3.7-plus",
-        "qwen-3.7-plus-1m",
-        "bynara-max",
-    ],
-};
-export function getKnownModels(provider) {
-    return [...(knownModels[provider] ?? [])];
-}
-// ── Abort controller for streaming cancellation ─────────────────────────────
-let currentAbortController = null;
-class AbortRunError extends Error {
-    constructor() {
-        super("Aborted.");
-        this.name = "AbortRunError";
-    }
-}
+import { readPromptLine, stripAnsi, isPrintableSequence, } from "./repl/prompt-line.js";
+import { slashCommands, knownModels, looksLikeSlashCommand, slashCommandLabel, } from "./repl/slash-commands.js";
+// Re-exported so existing imports of these names from "./repl.js" keep
+// working unchanged — the command catalogue, model lists, and the line
+// editor now live in their own modules under "./repl/".
+export { slashCommands, knownModels, getKnownModels, looksLikeSlashCommand, getSlashCommandSuggestions, isKnownSlashCommand, } from "./repl/slash-commands.js";
+export { renderSlashCommandMenu, renderFileMentionMenu, } from "./repl/prompt-line.js";
 function splitCommand(line) {
     return (line
         .match(/(?:[^\s"]+|"[^"]*")+/g)
         ?.map((part) => part.replace(/^"|"$/g, "")) ?? []);
 }
-function stripAnsi(text) {
-    return text.replace(/\x1b\[[0-9;]*m/g, "");
+function isAbortLikeError(error) {
+    if (!error)
+        return false;
+    if (typeof error === "object") {
+        const err = error;
+        if (err.name === "AbortError")
+            return true;
+        if (err.code === "ABORT_ERR")
+            return true;
+        if (typeof err.message === "string" && /abort/i.test(err.message))
+            return true;
+    }
+    return false;
 }
-/** Set of known slash-command names (without the leading "/"). */
-const knownSlashNames = new Set(slashCommands.map((c) => c.command.slice(1).toLowerCase()));
 /**
  * Build an OCR text layer for attached images. Some providers/proxies accept
  * multimodal `image_url` parts but silently ignore the bytes upstream — the
@@ -335,622 +89,13 @@ async function buildImageOcrGrounding(line, baseDir) {
         sections.join("\n\n") +
         "\n</image-ocr>");
 }
-/**
- * Decide whether a line that starts with "/" is actually a slash command
- * versus an absolute filesystem path the user typed or drag-dropped (e.g.
- * `/Users/me/Desktop/Screenshot.png`). A real command is "/" + a single
- * known command word (optionally followed by arguments). An absolute path
- * has extra "/" segments in its first token and won't match a known command,
- * so we route it to the normal prompt path where expandMentions() turns it
- * into a file attachment.
- */
-export function looksLikeSlashCommand(line) {
-    if (!line.startsWith("/") || line.length < 2)
-        return false;
-    // First whitespace-delimited token, minus the leading slash.
-    const firstToken = line.slice(1).split(/\s/)[0] ?? "";
-    // A path-like first token (contains another "/" or a backslash escape, or
-    // looks like a filename with an extension) is never a command.
-    if (firstToken.includes("/") || firstToken.includes("\\"))
-        return false;
-    const name = firstToken.toLowerCase();
-    // Exact match against a known command, or a unique prefix of one (so
-    // partial typing like "/imp" still routes to the command handler, which
-    // already resolves abbreviations). Unknown words like a single-segment
-    // path token still fall through to handleSlash's "unknown command" help,
-    // which is the historical behavior for genuine typos.
-    if (knownSlashNames.has(name))
-        return true;
-    // Only treat as a (mistyped) command when it has no path/extension shape.
-    // "Users" alone (from "/Users") would be caught above by the "/" check,
-    // so here we accept bare alpha words as command attempts.
-    return /^[a-z][a-z0-9-]*$/i.test(firstToken);
-}
-function isAbortLikeError(error) {
-    if (!error)
-        return false;
-    if (typeof error === "object") {
-        const err = error;
-        if (err.name === "AbortError")
-            return true;
-        if (err.code === "ABORT_ERR")
-            return true;
-        if (typeof err.message === "string" && /abort/i.test(err.message))
-            return true;
-    }
-    return false;
-}
-function slashCommandLabel(command) {
-    return command.usage
-        ? `${command.command} ${command.usage}`
-        : command.command;
-}
-function slashCommandFilter(line) {
-    // Show the menu immediately on '/' so the user can see available commands,
-    // but let Enter submit a raw '/' unless they explicitly navigate the menu.
-    if (!line.startsWith("/") || line.length < 1 || /\s/.test(line))
-        return null;
-    // Don't show the command menu for an absolute path the user is typing or
-    // drag-dropped (e.g. "/Users/me/file.png"): a path's first token has more
-    // "/" or backslash escapes in it. Those go to the normal prompt path.
-    const firstToken = line.slice(1).split(/\s/)[0] ?? "";
-    if (firstToken.includes("/") || firstToken.includes("\\"))
-        return null;
-    return line.slice(1).toLowerCase();
-}
-export function getSlashCommandSuggestions(line) {
-    const filter = slashCommandFilter(line);
-    if (filter === null)
-        return [];
-    return slashCommands.filter((command) => command.command.slice(1).toLowerCase().startsWith(filter));
-}
-export function isKnownSlashCommand(command) {
-    const normalized = command.trim().split(/\s+/, 1)[0]?.toLowerCase();
-    return slashCommands.some((item) => item.command === normalized);
-}
-function fitPlain(text, maxWidth) {
-    if (maxWidth <= 0)
-        return "";
-    if (text.length <= maxWidth)
-        return text;
-    if (maxWidth === 1)
-        return "…";
-    return `${text.slice(0, maxWidth - 1)}…`;
-}
-export function renderSlashCommandMenu(line, suggestions, selectedIndex) {
-    const cols = terminalColumns();
-    // Stay one column short to avoid terminal autowrap when the cursor lands in
-    // the final column. refresh() depends on each menu item occupying one row.
-    const maxWidth = Math.max(1, cols - 1);
-    if (suggestions.length === 0) {
-        return [chalk.dim(fitPlain(`  no commands matching ${line}`, maxWidth))];
-    }
-    // Cap visible items to leave room in the terminal
-    const termRows = process.stdout.rows || 24;
-    const maxVisible = Math.max(5, termRows - 4);
-    const visible = suggestions.slice(0, maxVisible);
-    const maxCommandLength = Math.max(...visible.map((command) => slashCommandLabel(command).length));
-    const items = visible.map((command, index) => {
-        const markerPlain = index === selectedIndex ? "›" : " ";
-        const marker = index === selectedIndex ? chalk.magenta("›") : " ";
-        const prefix = `  ${markerPlain} `;
-        const labelBudget = Math.max(1, maxWidth - prefix.length);
-        const labelWidth = Math.min(maxCommandLength + 2, labelBudget);
-        const label = fitPlain(slashCommandLabel(command), labelWidth).padEnd(labelWidth);
-        const descWidth = Math.max(0, maxWidth - prefix.length - label.length);
-        const desc = fitPlain(command.description, descWidth);
-        return `  ${marker} ${chalk.cyan(label)}${chalk.dim(desc)}`;
-    });
-    if (suggestions.length > maxVisible) {
-        items.push(chalk.dim(fitPlain(`  … ${suggestions.length - maxVisible} more`, maxWidth)));
-    }
-    return items;
-}
-export function renderFileMentionMenu(query, suggestions, selectedIndex) {
-    const cols = terminalColumns();
-    const maxWidth = Math.max(1, cols - 1);
-    if (suggestions.length === 0) {
-        return [chalk.dim(fitPlain(`  no files matching @${query}`, maxWidth))];
-    }
-    const termRows = process.stdout.rows || 24;
-    const maxVisible = Math.max(5, termRows - 4);
-    const visible = suggestions.slice(0, maxVisible);
-    const items = visible.map((suggestion, index) => {
-        const markerPlain = index === selectedIndex ? "›" : " ";
-        const marker = index === selectedIndex ? chalk.magenta("›") : " ";
-        const prefix = `  ${markerPlain} `;
-        const labelBudget = Math.max(1, maxWidth - prefix.length);
-        const label = fitPlain(suggestion.label, labelBudget);
-        const colored = suggestion.isDir ? chalk.cyan(label) : chalk.white(label);
-        return `  ${marker} ${colored}`;
-    });
-    if (suggestions.length > maxVisible) {
-        items.push(chalk.dim(fitPlain(`  … ${suggestions.length - maxVisible} more`, maxWidth)));
-    }
-    return items;
-}
-function isPrintableSequence(sequence) {
-    return sequence !== undefined && /^[^\x00-\x1f\x7f]+$/u.test(sequence);
-}
-function terminalColumns() {
-    return Math.max(1, process.stdout.columns || 80);
-}
-function promptCursorPosition(line, cursor, columns) {
-    const cols = Math.max(1, columns);
-    const promptCols = promptColumnsForRender();
-    // Walk the buffer up to the cursor, advancing visual row/col. Newlines
-    // (from a multi-line paste) move to the next row at column 0; otherwise we
-    // wrap when a row fills. The prompt only offsets the very first row.
-    let row = 0;
-    let col = promptCols < cols ? promptCols : 0;
-    const end = Math.max(0, Math.min(cursor, line.length));
-    for (let i = 0; i < end; i += 1) {
-        if (line[i] === "\n") {
-            row += 1;
-            col = 0;
-            continue;
-        }
-        col += 1;
-        if (col >= cols) {
-            row += 1;
-            col = 0;
-        }
-    }
-    return { row, col };
-}
-function promptColumnsForRender() {
-    return stripAnsi(PROMPT).length;
-}
-function buildPromptRows(line, columns, includeCursorRow) {
-    const cols = Math.max(1, columns);
-    const promptCols = promptColumnsForRender();
-    const rows = [];
-    // Split on explicit newlines first (multi-line paste), then wrap each
-    // logical line by the terminal width. Only the first logical line carries
-    // the prompt prefix; continuation lines start at column 0.
-    const logicalLines = line.split("\n");
-    logicalLines.forEach((logical, li) => {
-        const prefix = li === 0 ? PROMPT : "";
-        const prefixCols = li === 0 ? promptCols : 0;
-        if (prefixCols >= cols) {
-            rows.push(prefix);
-            for (let i = 0; i < logical.length; i += cols) {
-                rows.push(logical.slice(i, i + cols));
-            }
-        }
-        else {
-            const firstRowCapacity = cols - prefixCols;
-            rows.push(prefix + logical.slice(0, firstRowCapacity));
-            for (let i = firstRowCapacity; i < logical.length; i += cols) {
-                rows.push(logical.slice(i, i + cols));
-            }
-        }
-    });
-    if (includeCursorRow) {
-        // Pad so the row the cursor will sit on exists even at exact width
-        // boundaries or after a trailing newline.
-        const cursorRows = promptCursorPosition(line, line.length, cols).row + 1;
-        while (rows.length < cursorRows)
-            rows.push("");
+// Abort controller for streaming cancellation
+let currentAbortController = null;
+class AbortRunError extends Error {
+    constructor() {
+        super("Aborted.");
+        this.name = "AbortRunError";
     }
-    return rows;
-}
-async function readPromptLine(options) {
-    return new Promise((resolve) => {
-        let line = "";
-        let cursor = 0;
-        let selectedIndex = 0;
-        let menuNavigated = false;
-        let dismissedSlashLine = null;
-        let mentionDismissed = false;
-        let historyIndex = null;
-        let historyDraft = "";
-        let lastCtrlCAt = 0;
-        // Bracketed-paste state. When the terminal wraps a paste in
-        // paste-start/paste-end markers, we buffer the whole paste (including
-        // its embedded newlines) and insert it as literal text — so a multi-line
-        // prompt is captured in full instead of the first newline submitting and
-        // dropping the rest.
-        let pasting = false;
-        let pasteBuffer = "";
-        // Track which row (relative to prompt start) the cursor is on.
-        // Needed to move back up to prompt start when text wraps across rows.
-        let promptCursorRow = 0;
-        const getMenuState = () => {
-            const filter = slashCommandFilter(line);
-            if (filter === null || dismissedSlashLine === line) {
-                return { visible: false, suggestions: [] };
-            }
-            const suggestions = getSlashCommandSuggestions(line);
-            if (selectedIndex >= suggestions.length)
-                selectedIndex = 0;
-            return { visible: true, suggestions };
-        };
-        // File @-mention autocomplete: active when the cursor sits inside an
-        // `@partial/path` token. Mutually exclusive with the slash menu (slash
-        // requires the line to start with "/" and contain no whitespace).
-        const getMentionState = () => {
-            if (mentionDismissed || line.startsWith("/")) {
-                return { visible: false, query: "", start: 0, suggestions: [] };
-            }
-            const q = getMentionQuery(line, cursor);
-            if (!q)
-                return { visible: false, query: "", start: 0, suggestions: [] };
-            const suggestions = findFileSuggestions(q.query);
-            if (suggestions.length === 0) {
-                return { visible: false, query: q.query, start: q.start, suggestions };
-            }
-            if (selectedIndex >= suggestions.length)
-                selectedIndex = 0;
-            return { visible: true, query: q.query, start: q.start, suggestions };
-        };
-        const applyMention = (suggestion, start) => {
-            const before = line.slice(0, start);
-            const after = line.slice(cursor);
-            let insert = `@${suggestion.value}`;
-            let newCursor = before.length + insert.length;
-            if (!suggestion.isDir) {
-                // Completed a file — add a trailing space and close the menu so the
-                // user can keep typing their request.
-                insert += " ";
-                newCursor = before.length + insert.length;
-                mentionDismissed = true;
-            }
-            else {
-                // Completed a directory — keep the menu open so the user drills in.
-                mentionDismissed = false;
-            }
-            line = before + insert + after;
-            cursor = newCursor;
-            selectedIndex = 0;
-            menuNavigated = false;
-            refresh();
-        };
-        const refresh = () => {
-            const cols = terminalColumns();
-            const menu = getMenuState();
-            const mention = menu.visible
-                ? {
-                    visible: false,
-                    query: "",
-                    start: 0,
-                    suggestions: [],
-                }
-                : getMentionState();
-            const menuLines = menu.visible
-                ? renderSlashCommandMenu(line, menu.suggestions, selectedIndex)
-                : mention.visible
-                    ? renderFileMentionMenu(mention.query, mention.suggestions, selectedIndex)
-                    : [];
-            const promptRows = buildPromptRows(line, cols, true);
-            const target = promptCursorPosition(line, cursor, cols);
-            const blockRows = [...promptRows, ...menuLines];
-            // Always redraw the whole prompt block from its anchor. Partial row
-            // clearing is fragile once terminal autowrap, slash menus, and cursor
-            // movement mix; clearing to the end of screen leaves no stale wrapped
-            // prompt/menu rows behind and keeps the cursor anchor stable.
-            if (promptCursorRow > 0) {
-                moveCursor(output, 0, -promptCursorRow);
-            }
-            cursorTo(output, 0);
-            output.write("\x1b[J");
-            output.write(blockRows.join("\n"));
-            const currentRow = Math.max(0, blockRows.length - 1);
-            const rowDelta = target.row - currentRow;
-            if (rowDelta !== 0) {
-                moveCursor(output, 0, rowDelta);
-            }
-            cursorTo(output, target.col);
-            promptCursorRow = target.row;
-        };
-        const editLine = (nextLine, nextCursor) => {
-            line = nextLine;
-            cursor = Math.max(0, Math.min(nextCursor, line.length));
-            selectedIndex = 0;
-            menuNavigated = false;
-            dismissedSlashLine = null;
-            mentionDismissed = false;
-            historyIndex = null;
-            refresh();
-        };
-        // Insert literal text (e.g. a multi-line paste) at the cursor, preserving
-        // newlines so the full pasted prompt is kept and later submitted intact.
-        const insertText = (text) => {
-            const normalized = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-            if (!normalized)
-                return;
-            line = line.slice(0, cursor) + normalized + line.slice(cursor);
-            cursor += normalized.length;
-            selectedIndex = 0;
-            menuNavigated = false;
-            dismissedSlashLine = null;
-            mentionDismissed = false;
-            historyIndex = null;
-            refresh();
-        };
-        const cleanup = (restoreInput = false) => {
-            input.off("keypress", handleKeypress);
-            // Leave bracketed-paste mode so the terminal isn't left in a special
-            // state during tool execution or after exit.
-            if (input.isTTY)
-                output.write("\x1b[?2004l");
-            if (restoreInput) {
-                input.pause();
-                if (input.isTTY)
-                    input.setRawMode(false);
-            }
-        };
-        const clearPromptDisplay = () => {
-            // Move back to prompt start
-            if (promptCursorRow > 0) {
-                moveCursor(output, 0, -promptCursorRow);
-            }
-            cursorTo(output, 0);
-            output.write("\x1b[J");
-            promptCursorRow = 0;
-        };
-        const submit = (submittedLine) => {
-            line = submittedLine;
-            cursor = line.length;
-            // Move back to prompt start
-            if (promptCursorRow > 0) {
-                moveCursor(output, 0, -promptCursorRow);
-            }
-            cursorTo(output, 0);
-            output.write("\x1b[J");
-            // Write final prompt using the same wrapping rules as refresh(), then
-            // move to the next line. Do not include the extra cursor-only row used
-            // for interactive editing at exact terminal-width boundaries.
-            output.write(buildPromptRows(line, terminalColumns(), false).join("\n"));
-            output.write("\n");
-            promptCursorRow = 0;
-            cleanup();
-            resolve(submittedLine);
-        };
-        function handleKeypress(sequence, key) {
-            // The alt-screen pager owns the terminal while open; ignore everything
-            // here so the user's navigation keys don't bleed into the input line.
-            if (isPagerActive())
-                return;
-            // ── Bracketed paste ───────────────────────────────────────────────
-            // The terminal brackets a paste with paste-start / paste-end markers.
-            // Buffer everything in between (including embedded newlines) and insert
-            // it literally, so a long multi-line prompt is captured in full and the
-            // first newline does not submit early.
-            if (key?.name === "paste-start") {
-                pasting = true;
-                pasteBuffer = "";
-                return;
-            }
-            if (key?.name === "paste-end") {
-                pasting = false;
-                const pasted = pasteBuffer;
-                pasteBuffer = "";
-                if (pasted)
-                    insertText(pasted);
-                return;
-            }
-            if (pasting) {
-                if (key?.name === "return" || key?.name === "enter") {
-                    pasteBuffer += "\n";
-                }
-                else if (key?.name === "tab") {
-                    pasteBuffer += "\t";
-                }
-                else if (isPrintableSequence(sequence)) {
-                    pasteBuffer += sequence;
-                }
-                return;
-            }
-            const menu = getMenuState();
-            const mention = menu.visible
-                ? {
-                    visible: false,
-                    query: "",
-                    start: 0,
-                    suggestions: [],
-                }
-                : getMentionState();
-            // Cmd+C on macOS terminals is handled by the OS (it never reaches us),
-            // but some Linux terminals forward Meta+C. Treat that as a no-op so
-            // selecting + copying never breaks the REPL.
-            if (key.meta && !key.ctrl && key.name === "c")
-                return;
-            if (isCtrlC(key)) {
-                // First press: clear the current line. Second press within 1s: exit.
-                // This mirrors bash / Claude Code and avoids killing the REPL by
-                // accident when users habitually press Ctrl+C to copy in some
-                // terminals.
-                const now = Date.now();
-                if (line.length > 0) {
-                    editLine("", 0);
-                    lastCtrlCAt = now;
-                    return;
-                }
-                if (now - lastCtrlCAt < 1_000) {
-                    cleanup(true);
-                    output.write("\n");
-                    process.exit(0);
-                }
-                lastCtrlCAt = now;
-                output.write("\n");
-                output.write(chalk.dim("  (press Ctrl+C again to exit)\n"));
-                output.write(PROMPT);
-                return;
-            }
-            if (isCtrlT(key)) {
-                options.onThinkingShortcut();
-                refresh();
-                return;
-            }
-            if (isCtrlO(key)) {
-                clearPromptDisplay();
-                output.write("\n");
-                void options.onOutputShortcut().finally(refresh);
-                return;
-            }
-            if (isCtrlP(key)) {
-                clearPromptDisplay();
-                output.write("\n");
-                void options.onPlanShortcut().finally(refresh);
-                return;
-            }
-            if (key.name === "return" || key.name === "enter") {
-                if (mention.visible && mention.suggestions.length > 0) {
-                    applyMention(mention.suggestions[selectedIndex] ?? mention.suggestions[0], mention.start);
-                    return;
-                }
-                const useSelection = menu.visible && (line !== "/" || menuNavigated);
-                const selectedCommand = useSelection
-                    ? menu.suggestions[selectedIndex]
-                    : undefined;
-                submit(selectedCommand?.command ?? line);
-                return;
-            }
-            if (key.name === "tab") {
-                if (mention.visible && mention.suggestions.length > 0) {
-                    applyMention(mention.suggestions[selectedIndex] ?? mention.suggestions[0], mention.start);
-                    return;
-                }
-                if (menu.visible && menu.suggestions.length > 0) {
-                    const target = menu.suggestions[selectedIndex] ?? menu.suggestions[0];
-                    editLine(target.command, target.command.length);
-                }
-                return;
-            }
-            if (isEscape(key)) {
-                if (mention.visible) {
-                    mentionDismissed = true;
-                    refresh();
-                    return;
-                }
-                if (menu.visible) {
-                    dismissedSlashLine = line;
-                    refresh();
-                }
-                return;
-            }
-            if (key.name === "up") {
-                if (mention.visible && mention.suggestions.length > 0) {
-                    selectedIndex =
-                        (selectedIndex - 1 + mention.suggestions.length) %
-                            mention.suggestions.length;
-                    menuNavigated = true;
-                    refresh();
-                    return;
-                }
-                if (menu.visible && menu.suggestions.length > 0) {
-                    selectedIndex =
-                        (selectedIndex - 1 + menu.suggestions.length) %
-                            menu.suggestions.length;
-                    menuNavigated = true;
-                    refresh();
-                    return;
-                }
-                if (options.history.length > 0) {
-                    if (historyIndex === null) {
-                        historyDraft = line;
-                        historyIndex = options.history.length - 1;
-                    }
-                    else {
-                        historyIndex = Math.max(0, historyIndex - 1);
-                    }
-                    line = options.history[historyIndex] ?? "";
-                    cursor = line.length;
-                    selectedIndex = 0;
-                    dismissedSlashLine = null;
-                    refresh();
-                }
-                return;
-            }
-            if (key.name === "down") {
-                if (mention.visible && mention.suggestions.length > 0) {
-                    selectedIndex = (selectedIndex + 1) % mention.suggestions.length;
-                    menuNavigated = true;
-                    refresh();
-                    return;
-                }
-                if (menu.visible && menu.suggestions.length > 0) {
-                    selectedIndex = (selectedIndex + 1) % menu.suggestions.length;
-                    menuNavigated = true;
-                    refresh();
-                    return;
-                }
-                if (historyIndex !== null) {
-                    if (historyIndex < options.history.length - 1) {
-                        historyIndex += 1;
-                        line = options.history[historyIndex] ?? "";
-                    }
-                    else {
-                        historyIndex = null;
-                        line = historyDraft;
-                    }
-                    cursor = line.length;
-                    selectedIndex = 0;
-                    dismissedSlashLine = null;
-                    refresh();
-                }
-                return;
-            }
-            if (key.name === "left") {
-                if (cursor > 0) {
-                    cursor -= 1;
-                    refresh();
-                }
-                return;
-            }
-            if (key.name === "right") {
-                if (cursor < line.length) {
-                    cursor += 1;
-                    refresh();
-                }
-                return;
-            }
-            if (key.name === "home" || (key.ctrl && key.name === "a")) {
-                cursor = 0;
-                refresh();
-                return;
-            }
-            if (key.name === "end" || (key.ctrl && key.name === "e")) {
-                cursor = line.length;
-                refresh();
-                return;
-            }
-            if (key.name === "backspace") {
-                if (cursor > 0) {
-                    editLine(line.slice(0, cursor - 1) + line.slice(cursor), cursor - 1);
-                }
-                return;
-            }
-            if (key.name === "delete") {
-                if (cursor < line.length) {
-                    editLine(line.slice(0, cursor) + line.slice(cursor + 1), cursor);
-                }
-                return;
-            }
-            if (key.ctrl && key.name === "u") {
-                editLine(line.slice(cursor), 0);
-                return;
-            }
-            if (key.ctrl && key.name === "k") {
-                editLine(line.slice(0, cursor), cursor);
-                return;
-            }
-            if (isPrintableSequence(sequence) && !key.ctrl && !key.meta) {
-                editLine(line.slice(0, cursor) + sequence + line.slice(cursor), cursor + sequence.length);
-            }
-        }
-        output.write(PROMPT);
-        if (input.isTTY) {
-            input.setRawMode(true);
-            // Enable bracketed paste so multi-line pastes arrive as one chunk
-            // (wrapped in paste-start/paste-end) instead of submitting at the
-            // first embedded newline.
-            output.write("\x1b[?2004h");
-        }
-        input.resume();
-        input.on("keypress", handleKeypress);
-    });
 }
 // Build a concise, width-bounded spinner label for ask-mode research so the
 // user sees what's being searched/fetched without the line overflowing.
@@ -2051,16 +1196,15 @@ async function handleSlash(line, state) {
             clearThinking();
             // Clear the entire screen and move cursor to top
             process.stdout.write("\x1b[2J\x1b[3J\x1b[H");
-            // Re-render the startup banner
-            console.log(renderBanner(getCurrentVersion()));
-            console.log(renderSessionInfo({
+            // Re-render the startup intro card
+            console.log(renderIntroCard({
+                version: getCurrentVersion(),
                 workdir: safeCwd(),
                 model: state.model,
                 provider: state.provider,
                 mode: state.mode,
             }));
-            console.log(renderSuggestions());
-            console.log(chalk.dim("  ESC abort  │  Ctrl+C clears input  │  @ to attach files  │  Ctrl+T thinking  │  Ctrl+O tool output  │  Ctrl+P plan (q to close)\n"));
+            console.log();
             return true;
         }
         case "/update":
@@ -2111,7 +1255,7 @@ export async function startRepl(options = {}) {
     };
     process.on("unhandledRejection", handleUnhandledRejection);
     process.on("uncaughtException", handleUncaughtException);
-    // ── ESC / Ctrl+C abort; Ctrl+T toggles hidden thinking ──────────────────
+    // ESC / Ctrl+C abort; Ctrl+T toggles hidden thinking
     if (process.stdin.isTTY) {
         process.stdin.setRawMode(false);
     }
@@ -2243,16 +1387,15 @@ export async function startRepl(options = {}) {
         console.log(chalk.dim("\n  (press Ctrl+C again to exit)"));
     };
     process.on("SIGINT", handleSigint);
-    // ── Startup banner ──────────────────────────────────────────────────────
-    console.log(renderBanner(getCurrentVersion()));
-    console.log(renderSessionInfo({
+    // Startup intro card
+    console.log(renderIntroCard({
+        version: getCurrentVersion(),
         workdir: safeCwd(),
         model: state.model,
         provider: state.provider,
         mode: state.mode,
     }));
-    console.log(renderSuggestions());
-    console.log(chalk.dim("  ESC abort  │  Ctrl+C clears input  │  @ to attach files  │  Ctrl+T thinking  │  Ctrl+O tool output  │  Ctrl+P plan (q to close)\n"));
+    console.log();
     // Hint thinking-capable users that the toggle exists. We default it to
     // off for speed, since on NIM many models route through a much slower
     // chat-template path when reasoning is enabled.
@@ -2279,7 +1422,7 @@ export async function startRepl(options = {}) {
             isReadingPrompt = false;
             if (!line)
                 continue;
-            // ── /implement — approve the active plan and execute it ──────────
+            // /implement — approve the active plan and execute it
             // Handled here (not in handleSlash) because it must trigger a full
             // agent run with the plan marked approved, not just print something.
             let implementApproved = false;
@@ -2310,7 +1453,7 @@ export async function startRepl(options = {}) {
                         "Do NOT call web.search — you already know everything needed. " +
                         "Run real commands (installs, servers, verification) — do not claim anything ran without a successful tool call.";
             }
-            // ── Continuation detection ──────────────────────────────────────────
+            // Continuation detection
             // When the user types "continue" after the agent paused at a step limit,
             // augment the bare keyword with rich resumption context so the model
             // picks up from where it left off instead of restarting.