@scira/cli 0.1.0

package/dist/ui/ink/components/home-screen.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { pkgVersion, relativeTime } from "../lib/utils.js";
+import { HOME_TIPS } from "../constants.js";
+/** Home screen body: branding card, browse modal, notice, and tip line.
+ *  Also (re)builds the mouse click/hover row maps as a render side-effect. */
+export function HomeScreen({ cols, rows, sessions, selectedIdx, hoveredIdx, heroHidden, notice, tipIndex, commandMenuHeight, sessionsModalOpen, sessionsModalIdx, inputText, clickMapRef, hoverMapRef, setSelectedIdx, setSessionsModalOpen, setSessionsModalIdx, setNotice, openRun, submitHome, exit, }) {
+    const cardW = Math.min(Math.max(52, cols - 4), 90);
+    const heroRows = heroHidden ? 0 : 2;
+    const cardH = heroHidden ? 0 : 10;
+    const bHeight = rows - 6 - commandMenuHeight;
+    const contentH = cardH + (notice ? 2 : 0) + 2;
+    const topGap = Math.max(0, Math.floor((bHeight - contentH) / 2));
+    const cardTop0 = 2 + topGap;
+    const newIdx = 0;
+    const quitIdx = 1;
+    const newActive = selectedIdx === newIdx || hoveredIdx === newIdx;
+    const quitActive = selectedIdx === quitIdx || hoveredIdx === quitIdx;
+    const clickMap = new Map();
+    const hoverMap = new Map();
+    const rowBase = cardTop0 + heroRows + 4;
+    if (sessionsModalOpen) {
+        const modalVisible = Math.max(5, rows - 12);
+        const half = Math.floor(modalVisible / 2);
+        const windowStart = Math.max(0, Math.min(sessionsModalIdx - half, Math.max(0, sessions.length - modalVisible)));
+        const windowEnd = Math.min(sessions.length, windowStart + modalVisible);
+        const modalTop = cardTop0;
+        const headerRows = 3;
+        const above = windowStart;
+        sessions.slice(windowStart, windowEnd).forEach((s, i) => {
+            const idx = windowStart + i;
+            const row = modalTop + headerRows + (above > 0 ? 1 : 0) + i;
+            clickMap.set(row, () => {
+                setSessionsModalIdx(idx);
+                setSessionsModalOpen(false);
+                void openRun(s.path);
+            });
+            hoverMap.set(row, idx);
+        });
+    }
+    else if (!heroHidden) {
+        clickMap.set(rowBase, () => {
+            setSelectedIdx(newIdx);
+            if (inputText.trim())
+                void submitHome(inputText);
+            else
+                setNotice("Type a question below to start a new research run.");
+        });
+        hoverMap.set(rowBase, newIdx);
+        clickMap.set(rowBase + 1, () => exit());
+        hoverMap.set(rowBase + 1, quitIdx);
+    }
+    clickMapRef.current = clickMap;
+    hoverMapRef.current = hoverMap;
+    return (_jsx(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "center", alignItems: "center", children: sessionsModalOpen ? (() => {
+            const modalVisible = Math.max(5, rows - 12);
+            const half = Math.floor(modalVisible / 2);
+            const windowStart = Math.max(0, Math.min(sessionsModalIdx - half, Math.max(0, sessions.length - modalVisible)));
+            const windowEnd = Math.min(sessions.length, windowStart + modalVisible);
+            const above = windowStart;
+            const below = sessions.length - windowEnd;
+            return (_jsxs(Box, { borderStyle: "round", borderColor: "#FFE0C2", width: cardW, flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { color: "#FFE0C2", bold: true, children: "All sessions" }), _jsx(Text, { color: "gray", dimColor: true, children: `${sessions.length} total  ·  ${sessionsModalIdx + 1}/${sessions.length}  ·  ↑↓ navigate · ⏎ open · esc close` }), _jsx(Box, { height: 1 }), above > 0 && _jsx(Text, { color: "gray", dimColor: true, children: `  ↑ ${above} more above` }), sessions.slice(windowStart, windowEnd).map((s, i) => {
+                        const idx = windowStart + i;
+                        const active = idx === sessionsModalIdx;
+                        const display = (s.title || s.goal || s.id).slice(0, cardW - 22);
+                        return (_jsxs(Box, { children: [_jsx(Text, { color: active ? "white" : "gray", children: active ? "❯ [ " : "  [ " }), _jsx(Text, { bold: active, color: active ? "white" : "gray", wrap: "truncate", children: display }), _jsx(Box, { flexGrow: 1 }), s.isFull && _jsx(Text, { color: s.reportDirty ? "yellow" : "green", dimColor: true, children: s.reportDirty ? "draft " : "ready " }), _jsx(Text, { color: "gray", dimColor: true, children: relativeTime(s.updatedAt) }), _jsx(Text, { color: active ? "white" : "gray", children: " ]" })] }, s.id));
+                    }), below > 0 && _jsx(Text, { color: "gray", dimColor: true, children: `  ↓ ${below} more below` })] }));
+        })() : heroHidden ? null : (_jsxs(Box, { flexDirection: "column", alignItems: "center", width: cardW, children: [_jsxs(Box, { borderStyle: "round", borderColor: "gray", width: cardW, flexDirection: "row", paddingX: 2, paddingY: 1, children: [_jsx(Box, { flexDirection: "column", justifyContent: "center", marginRight: 3, children: [" ·:::· ", "·:     ", " ·:::· ", "     ·:", " ·:::· "].map((line, i) => (_jsx(Text, { color: "#FFE0C2", dimColor: true, children: line }, i))) }), _jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Box, { gap: 2, marginBottom: 1, children: [_jsx(Text, { bold: true, color: "white", children: "scira" }), _jsx(Text, { color: "gray", dimColor: true, children: "research agent" }), _jsxs(Text, { color: "gray", dimColor: true, children: ["v", pkgVersion] })] }), _jsx(Text, { color: "white", children: "Research and coding agent with real sources and tools." }), _jsx(Text, { color: "gray", dimColor: true, children: "Type a question below to start, or use # to browse past sessions." }), _jsx(Box, { height: 1 }), _jsxs(Box, { children: [_jsx(Text, { bold: newActive, color: newActive ? "white" : "gray", children: "New research" }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: "gray", dimColor: true, children: "\u23CE enter" })] }), _jsxs(Box, { children: [_jsx(Text, { bold: quitActive, color: quitActive ? "white" : "gray", children: "Quit" }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: "gray", dimColor: true, children: "ctrl+d" })] })] })] }), notice ? (_jsx(Box, { paddingTop: 1, children: _jsx(Text, { color: "yellow", children: notice }) })) : null, _jsx(Box, { paddingTop: 2, children: _jsxs(Text, { color: "gray", dimColor: true, children: ["Tip:  ", HOME_TIPS[tipIndex % HOME_TIPS.length]] }) })] })) }));
+}

package/dist/ui/ink/components/overlays.js

@@ -0,0 +1,111 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { SPINNER_FRAMES, CHAT_COMMANDS, COMMAND_DESCRIPTIONS, MENU_VISIBLE } from "../constants.js";
+import { fmtTokens, wrapText } from "../lib/utils.js";
+import { LLM_PROVIDER_LABELS } from "../../../providers/llm/registry.js";
+export function TopBar({ screen, runState, fullMode, activeUsage, busy, frame, cwdDisplay }) {
+    return (_jsxs(Box, { paddingTop: 1, justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, minWidth: 0, marginRight: 2, children: _jsx(Text, { color: "gray", dimColor: true, wrap: "truncate-end", children: screen === "chat" ? (runState?.title || runState?.goal || cwdDisplay) : cwdDisplay }) }), screen === "chat" && (_jsxs(Box, { flexShrink: 0, gap: 1, children: [_jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsx(Text, { color: fullMode ? "magenta" : "#FFE0C2", children: fullMode ? "full" : "quick" }), activeUsage && (_jsx(Text, { color: "gray", dimColor: true, children: `↑${fmtTokens(activeUsage.input)} ↓${fmtTokens(activeUsage.output)}` })), fullMode && (_jsxs(Text, { color: "gray", dimColor: true, children: [`src:${runState?.sourceCount ?? 0}`, (runState?.claimCount ?? 0) > 0 ? ` · claims:${runState?.claimCount}` : ""] })), fullMode && (_jsx(Text, { color: runState?.reportDirty ? "yellow" : "green", dimColor: true, children: runState?.reportDirty ? "draft" : "ready" })), busy && _jsx(Text, { color: "#FFE0C2", children: SPINNER_FRAMES[frame % SPINNER_FRAMES.length] }), _jsx(Text, { color: "gray", dimColor: true, children: "|" })] }))] }));
+}
+export function InputBar({ inputLines, cursorLine, cursorCol, showCursor, approvalPending, busy, frame, boxWidth, modelName }) {
+    const accentColor = approvalPending ? "yellowBright" : busy ? "#C2AA93" : "gray";
+    const borderLabel = busy ? `${SPINNER_FRAMES[frame % SPINNER_FRAMES.length]} ${modelName}` : modelName;
+    const labelMax = Math.max(0, boxWidth - 6);
+    const label = borderLabel.length > labelMax ? borderLabel.slice(0, labelMax) : borderLabel;
+    const dashCount = Math.max(1, boxWidth - label.length - 5);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: accentColor, children: "╭" + "─".repeat(Math.max(0, boxWidth - 2)) + "╮" }), inputLines.map((line, i) => (_jsxs(Box, { width: boxWidth, children: [_jsx(Text, { color: accentColor, children: "│ " }), _jsx(Text, { color: i === 0 ? (approvalPending ? "yellowBright" : busy ? "#C2AA93" : "#FFE0C2") : accentColor, children: i === 0 ? "❯ " : "  " }), showCursor && i === cursorLine ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "white", children: line.slice(0, cursorCol) }), _jsx(Text, { color: "white", inverse: true, children: line[cursorCol] ?? " " }), _jsx(Text, { color: "white", children: line.slice(cursorCol + 1) })] })) : (_jsx(Text, { color: approvalPending ? "gray" : "white", children: line })), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: accentColor, children: " \u2502" })] }, i))), _jsxs(Box, { width: boxWidth, children: [_jsx(Text, { color: accentColor, children: "╰" + "─".repeat(dashCount) + " " }), _jsx(Text, { color: "#FFE0C2", children: label }), _jsx(Text, { color: accentColor, children: " ─╯" })] })] }));
+}
+export function HintLine({ screen, busy, scrollLabel, hasDoneGroups, hasFocusedGroup }) {
+    if (screen === "chat") {
+        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: "gray", dimColor: true, children: _jsx(Text, { bold: true, color: "#FFE0C2", children: "/HELP" }) }), _jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsx(Text, { color: "gray", dimColor: true, children: _jsx(Text, { bold: true, color: "#FFE0C2", children: "/REPORT" }) }), _jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsx(Text, { color: "gray", dimColor: true, children: _jsx(Text, { bold: true, color: "#FFE0C2", children: "/NEW" }) }), busy && (_jsxs(_Fragment, { children: [_jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsx(Text, { color: "gray", dimColor: true, children: _jsx(Text, { bold: true, color: "#FFE0C2", children: "/STOP" }) })] })), hasDoneGroups && !busy ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsx(Text, { color: "gray", dimColor: true, children: hasFocusedGroup
+                                ? _jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: "#FFE0C2", children: "C" }), " toggle \u00B7 ", _jsx(Text, { bold: true, color: "#FFE0C2", children: "ESC" }), " unfocus"] })
+                                : _jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: "#FFE0C2", children: "[ ]" }), " \u00B7 ", _jsx(Text, { bold: true, color: "#FFE0C2", children: "C" }), " groups"] }) })] })) : null, scrollLabel ? (_jsxs(_Fragment, { children: [_jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: "gray", dimColor: true, children: scrollLabel })] })) : null] }));
+    }
+    return (_jsxs(Box, { gap: 1, children: [_jsxs(Text, { color: "gray", dimColor: true, children: [_jsx(Text, { bold: true, color: "#FFE0C2", children: "\u2191\u2193" }), ":navigate"] }), _jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsxs(Text, { color: "gray", dimColor: true, children: [_jsx(Text, { bold: true, color: "#FFE0C2", children: "\u23CE" }), ":open"] }), _jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsxs(Text, { color: "gray", dimColor: true, children: [_jsx(Text, { bold: true, color: "#FFE0C2", children: "ESC" }), ":close"] }), _jsx(Text, { color: "gray", dimColor: true, children: "|" }), _jsxs(Text, { color: "gray", dimColor: true, children: [_jsx(Text, { bold: true, color: "#FFE0C2", children: "Q" }), ":quit"] })] }));
+}
+export function CommandMenuBox({ activeSuggestions, activeSuggestionKind, commandMenuIndex, innerWidth, sessions }) {
+    if (activeSuggestions.length === 0)
+        return null;
+    const total = activeSuggestions.length;
+    const clampedIdx = Math.min(Math.max(0, commandMenuIndex), total - 1);
+    const windowStart = Math.max(0, Math.min(clampedIdx - MENU_VISIBLE + 1, total - MENU_VISIBLE));
+    const visible = activeSuggestions.slice(windowStart, windowStart + MENU_VISIBLE);
+    const nameWidth = Math.min(40, Math.max(...visible.map((c) => c.length)));
+    const innerCols = Math.max(20, innerWidth - 4);
+    const descMax = Math.max(10, innerCols - nameWidth - 4);
+    const isFileMenu = activeSuggestionKind === "file";
+    const isSessionMenu = activeSuggestionKind === "session";
+    const baseHeader = isFileMenu ? "files  ↑↓ move · tab complete"
+        : isSessionMenu ? "sessions  ↑↓ move · ⏎ open"
+            : "commands  ↑↓ move · tab complete";
+    const header = total > MENU_VISIBLE ? `${baseHeader}  ·  ${clampedIdx + 1}/${total}` : baseHeader;
+    const sessionDesc = (label) => {
+        const s = sessions?.find((r) => (r.title ?? r.goal ?? r.id).replace(/\s+/gu, " ").trim() === label);
+        if (!s)
+            return "";
+        const bits = [s.isFull ? "full" : "quick"];
+        if (s.sourceCount > 0)
+            bits.push(`${s.sourceCount} src`);
+        if (s.claimCount > 0)
+            bits.push(`${s.claimCount} claims`);
+        return bits.join(" · ");
+    };
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, marginX: 1, children: [_jsxs(Text, { color: "gray", dimColor: true, children: [header, windowStart > 0 ? "  ↑" : "", windowStart + MENU_VISIBLE < total ? "  ↓" : ""] }), visible.map((item, i) => {
+                const gi = windowStart + i;
+                const active = gi === clampedIdx;
+                const name = isSessionMenu && item.length > nameWidth ? item.slice(0, Math.max(0, nameWidth - 1)) + "…" : item;
+                const label = isFileMenu ? `@${name}` : isSessionMenu ? `# ${name}` : name;
+                const desc = isFileMenu ? "Attach file as model context."
+                    : isSessionMenu ? sessionDesc(item)
+                        : COMMAND_DESCRIPTIONS[item] ?? "";
+                const trimmed = desc.length > descMax ? desc.slice(0, Math.max(0, descMax - 1)) + "…" : desc;
+                const namePad = " ".repeat(Math.max(1, nameWidth - name.length + 2));
+                return (_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: active ? "white" : "gray", bold: active, children: [active ? "❯ " : "  ", label] }), _jsxs(Text, { color: "gray", dimColor: true, children: [namePad, trimmed] })] }, `${item}-${gi}`));
+            })] }));
+}
+export function HelpBox({ open, innerWidth }) {
+    if (!open)
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, marginX: 1, children: [_jsxs(Text, { bold: true, color: "white", children: ["help ", _jsx(Text, { color: "gray", dimColor: true, children: "esc close" })] }), _jsx(Text, { color: "gray", dimColor: true, children: "─".repeat(Math.max(10, innerWidth - 6)) }), _jsx(Text, { color: "gray", dimColor: true, children: "scroll  \u2191/\u2193  k/j  u/d  pgup/pgdn" }), _jsx(Text, { color: "gray", dimColor: true, children: "autocomplete  / commands \u00B7 @ files \u00B7 # sessions" }), _jsx(Text, { color: "gray", dimColor: true, children: "─".repeat(Math.max(10, innerWidth - 6)) }), CHAT_COMMANDS.map((cmd) => (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: "#FFE0C2", children: cmd }), _jsx(Text, { color: "gray", dimColor: true, children: COMMAND_DESCRIPTIONS[cmd] })] }, cmd)))] }));
+}
+export function ApprovalBox({ toolName, description, innerWidth }) {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellowBright", paddingX: 1, marginX: 1, children: [_jsxs(Text, { bold: true, color: "yellowBright", children: ["\u26A0  ", toolName, _jsx(Text, { color: "gray", dimColor: true, children: "  y approve \u00B7 n reject" })] }), _jsx(Text, { color: "gray", dimColor: true, children: "─".repeat(Math.max(10, innerWidth - 6)) }), wrapText(description, Math.max(10, innerWidth - 4)).slice(0, 6).map((line, i) => {
+                const isAdded = line.startsWith("+ ");
+                const isRemoved = line.startsWith("- ");
+                return (_jsx(Text, { color: isAdded ? "green" : isRemoved ? "red" : "gray", wrap: "truncate", children: line }, i));
+            })] }));
+}
+export function MenuDialog({ menu, cols, rows }) {
+    if (!menu)
+        return null;
+    const DIALOG_W = Math.min(64, Math.max(40, cols - 4));
+    const DIALOG_ITEMS = 10;
+    const displayName = (item) => menu.type === "llm" ? LLM_PROVIDER_LABELS[item] ?? item : item;
+    const menuFiltered = !menu.loading
+        ? (menu.query
+            ? menu.items.filter((item) => item.toLowerCase().includes(menu.query.toLowerCase()) ||
+                displayName(item).toLowerCase().includes(menu.query.toLowerCase()))
+            : menu.items)
+        : [];
+    const menuStart = Math.min(Math.max(0, menu.index - Math.floor(DIALOG_ITEMS / 2)), Math.max(0, menuFiltered.length - DIALOG_ITEMS));
+    const dialogLeft = Math.max(0, Math.floor((cols - 4 - DIALOG_W) / 2));
+    const dialogH = 5 + (menu.loading ? 1 : Math.min(DIALOG_ITEMS, menuFiltered.length) + (menuStart > 0 ? 1 : 0) + (menuFiltered.length - (menuStart + DIALOG_ITEMS) > 0 ? 1 : 0));
+    const dialogTop = Math.max(1, Math.floor((rows - dialogH) / 2));
+    return (_jsxs(Box, { position: "absolute", marginLeft: dialogLeft, marginTop: dialogTop, width: DIALOG_W, flexDirection: "column", borderStyle: "round", borderColor: "#FFE0C2", backgroundColor: "#0d0d0d", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "white", children: [menu.type === "model" ? "Select model" : menu.type === "llm" ? "Select LLM provider" : "Select search provider", "  ", _jsx(Text, { color: "gray", dimColor: true, children: "\u2191\u2193 navigate \u00B7 \u23CE apply \u00B7 esc close" })] }), !menu.loading && (_jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsx(Text, { color: "#FFE0C2", children: "⌕ " }), _jsx(Text, { color: "white", children: menu.query }), !menu.query && _jsx(Text, { color: "gray", dimColor: true, children: "type to filter\u2026" })] }), _jsx(Text, { color: "gray", dimColor: true, children: "─".repeat(Math.max(4, DIALOG_W - 4)) })] })), menu.loading ? (_jsx(Text, { color: "gray", dimColor: true, children: "  loading models\u2026" })) : menuFiltered.length === 0 ? (_jsxs(Text, { color: "gray", dimColor: true, children: ["  no matches for \"", menu.query, "\""] })) : (_jsxs(_Fragment, { children: [menuStart > 0 && _jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2191 ", menuStart, " more"] }), menuFiltered.slice(menuStart, menuStart + DIALOG_ITEMS).map((item, i) => {
+                        const idx = menuStart + i;
+                        const active = idx === menu.index;
+                        return (_jsxs(Text, { color: active ? "#FFE0C2" : "gray", bold: active, wrap: "truncate", children: [active ? "❯ " : "  ", displayName(item), menu.type === "llm" ? _jsx(Text, { color: "gray", dimColor: true, children: "  " + item }) : null] }, item));
+                    }), menuFiltered.length - (menuStart + DIALOG_ITEMS) > 0 && (_jsxs(Text, { color: "gray", dimColor: true, children: ["  \u2193 ", menuFiltered.length - (menuStart + DIALOG_ITEMS), " more"] }))] }))] }));
+}
+export function McpDialog({ open, config, cols, rows }) {
+    if (!open)
+        return null;
+    const W = Math.min(92, Math.max(52, cols - 8));
+    const left = Math.max(0, Math.floor((cols - 4 - W) / 2));
+    const servers = config.mcp.servers;
+    const top = Math.max(1, Math.floor((rows - (8 + servers.length)) / 2));
+    const dt = config.mcp.chromeDevtools;
+    return (_jsxs(Box, { position: "absolute", marginLeft: left, marginTop: top, width: W, flexDirection: "column", borderStyle: "round", borderColor: "#FFE0C2", backgroundColor: "#0d0d0d", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "white", children: ["MCP servers ", _jsx(Text, { color: "gray", dimColor: true, children: "esc/q/enter close" })] }), _jsx(Text, { color: "gray", dimColor: true, children: "─".repeat(Math.max(4, W - 4)) }), _jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: dt.enabled ? "green" : "gray", children: dt.enabled ? "●" : "○" }), _jsx(Text, { color: "white", children: " chromeDevtools " }), _jsx(Text, { color: "#FFE0C2", children: "[stdio] " }), _jsx(Text, { color: "gray", dimColor: true, children: [dt.command, ...dt.args].join(" ") })] }), servers.length === 0 ? (_jsx(Text, { color: "gray", dimColor: true, children: "  no user-defined servers" })) : servers.map((s) => {
+                const target = s.transport === "stdio" ? [s.command, ...s.args].filter(Boolean).join(" ") : s.url ?? "(missing url)";
+                return (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: s.enabled ? "green" : "gray", children: s.enabled ? "●" : "○" }), _jsxs(Text, { color: "white", children: [" ", s.name, " "] }), _jsxs(Text, { color: "#FFE0C2", children: ["[", s.transport, "] "] }), _jsx(Text, { color: "gray", dimColor: true, children: target })] }, s.name));
+            }), _jsx(Text, { color: "gray", dimColor: true, children: "─".repeat(Math.max(4, W - 4)) }), _jsx(Text, { color: "gray", dimColor: true, children: "/mcp add http exa https://mcp.exa.ai/mcp" }), _jsx(Text, { color: "gray", dimColor: true, children: "/mcp enable <name> \u00B7 /mcp disable <name>" })] }));
+}

package/dist/ui/ink/constants.js

@@ -0,0 +1,56 @@
+export const USER_BAND_BG = "#1c1c1c";
+export const S_BAR = "│";
+export const MENU_VISIBLE = 8;
+export const FILE_MENTION_MAX_CHARS = 20000;
+export const FILE_MENTION_SKIP = new Set([".git", "node_modules", "dist", ".scira"]);
+export const PROVIDERS = ["parallel", "exa", "firecrawl"];
+export const CHAT_COMMANDS = ["/help", "/new", "/rerun", "/report", "/sources", "/claims", "/why", "/mcp", "/copy", "/usage", "/rename", "/model", "/llm", "/provider", "/key", "/keys", "/stop", "/back", "/quit"];
+export const COMMAND_DESCRIPTIONS = {
+    "/help": "Show command and keyboard shortcuts.",
+    "/new": "Go to the home screen to start a new research run.",
+    "/rerun": "Run the research agent again for this run.",
+    "/report": "Show the generated report.md in the timeline.",
+    "/sources": "List the run's gathered sources with links.",
+    "/claims": "List all claims with id, confidence, status, and text.",
+    "/why": "Show full detail for a claim: /why <claim-id>",
+    "/mcp": "Manage MCP servers: /mcp list · /mcp enable/disable <name> · /mcp add <type> <name> <cmd|url>",
+    "/copy": "Copy the last answer (or report) to the clipboard.",
+    "/usage": "Show token usage per model for this session.",
+    "/rename": "Set a title for this session, e.g. /rename SpaceX IPO analysis",
+    "/model": "Open the model selector dropup.",
+    "/llm": "Switch the LLM provider (gateway, xai, workers-ai).",
+    "/provider": "Open the search provider selector.",
+    "/key": "Save an API key, e.g. /key EXA_API_KEY ...",
+    "/keys": "Show which required API keys are set.",
+    "/stop": "Abort the currently running agent turn.",
+    "/back": "Return to the sessions list.",
+    "/quit": "Quit the TUI."
+};
+export const TOOL_ICONS = {
+    bash: "$",
+    writeFile: "✎",
+    editFile: "✎",
+    readFile: "▤",
+    createClaim: "◎",
+    verifyClaim: "✓",
+    webSearch: "⌕",
+    readUrl: "↗",
+    listSkills: "★",
+    readSkill: "★"
+};
+export const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+export const HOME_TIPS = [
+    "Type a question and press ⏎ to start a new research run.",
+    "Say \"deep research …\" or \"compare …\" to trigger the full research harness.",
+    "↑↓ navigate · ⏎ open · type to start a new run.",
+    "/model · /provider · /key NAME value  to configure.",
+    "Browse all sessions to find older runs.",
+    "ready / draft badges show full-research runs and their report state."
+];
+export const FULL_MODE_TRIGGERS = [
+    "deep research", "deep dive", "deep-dive", "do research", "research about",
+    "research on", "in depth", "in-depth", "comprehensive", "thorough",
+    "detailed report", "full report", "write a report", "literature review",
+    "investigate", "analyze", "analyse", "analysis of", "compare", "comparison",
+    "pros and cons", "state of the art", "survey of", "everything about"
+];

package/dist/ui/ink/hooks/use-agent-turn.js

@@ -0,0 +1,186 @@
+import { useCallback, useRef } from "react";
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createResearchAgent, createOneShotAgent } from "../../../agent/research-agent.js";
+import { generateWithGateway } from "../../../providers/llm/gateway.js";
+import { setRunTitle, summarizeRun } from "../../../storage/run-store.js";
+import { fmtDuration, fmtTokens, aggregateTurns, wantsFullResearch, summarizeToolInput } from "../lib/utils.js";
+import { promptWithFileMentions } from "../lib/file-mentions.js";
+import { markdownJoinerTransform } from "../../../utils/markdown-joiner.js";
+import { createSession, getSession, removeSession, attachSubscriber, sessionPushFeed, sessionSetBusy, sessionSetApproval, sessionFinishReasoning, sessionNotifyEscalate, sessionNotifyModeChange, } from "../session-manager.js";
+export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullModeRef, conversationRef, turnsRef, feedRef, setBusy, setScrollOffset, refreshRun, recordUsage, setMode, getSubscriber, }) {
+    const runTurn = useCallback(async (prompt) => {
+        const runPath = currentRunPath;
+        if (!runPath)
+            return;
+        const existing = getSession(runPath);
+        if (existing?.busy)
+            return;
+        const session = createSession(runPath);
+        // Always re-attach subscriber so follow-up turns have a live listener.
+        attachSubscriber(runPath, getSubscriber());
+        const controller = new AbortController();
+        session.abort = controller;
+        setBusy(true);
+        setScrollOffset(0);
+        sessionSetBusy(runPath, true);
+        const modelId = config.model;
+        const turnStartedAt = Date.now();
+        const turnUsage = { input: 0, output: 0, total: 0 };
+        let summary;
+        try {
+            summary = await summarizeRun(runPath);
+            if (summary && !summary.title && conversationRef.current.length === 0) {
+                void (async () => {
+                    try {
+                        const title = await generateWithGateway(config, `Summarize this research topic into a very short title (3-5 words). Output ONLY the title, nothing else.\n\nTopic: ${summary.goal}`);
+                        const cleanTitle = title.trim().replace(/^["']+|["']+$/gu, "").slice(0, 60);
+                        if (cleanTitle)
+                            await setRunTitle(runPath, cleanTitle);
+                    }
+                    catch { /* non-fatal */ }
+                })();
+            }
+            const onApprovalRequired = (toolName, description) => new Promise((resolve) => sessionSetApproval(runPath, { toolName, description, resolve }));
+            const consume = async (result) => {
+                for await (const part of result.fullStream) {
+                    if (part.type !== "reasoning-delta" && part.type !== "reasoning-start")
+                        sessionFinishReasoning(runPath);
+                    switch (part.type) {
+                        case "text-delta":
+                            sessionPushFeed(runPath, { kind: "text", text: part.text });
+                            break;
+                        case "reasoning-delta":
+                            sessionPushFeed(runPath, { kind: "reasoning", text: part.text });
+                            break;
+                        case "reasoning-end":
+                            sessionFinishReasoning(runPath);
+                            break;
+                        case "tool-call":
+                            sessionPushFeed(runPath, { kind: "tool", name: part.toolName, toolCallId: part.toolCallId, summary: summarizeToolInput(part.toolName, part.input), status: "running" });
+                            break;
+                        case "tool-result": {
+                            const toolResultId = part.toolCallId;
+                            const resultText = String(part.output).slice(0, 200);
+                            sessionPushFeed(runPath, { kind: "tool", name: "", toolCallId: toolResultId, summary: resultText, status: "done", result: resultText });
+                            void refreshRun();
+                            break;
+                        }
+                        case "tool-error": {
+                            const toolErrId = part.toolCallId ?? "";
+                            const errText = String(part.error).slice(0, 200);
+                            sessionPushFeed(runPath, { kind: "tool", name: "", toolCallId: toolErrId, summary: errText, status: "error", result: errText });
+                            break;
+                        }
+                        case "error":
+                            sessionPushFeed(runPath, { kind: "status", text: `Error: ${String(part.error)}` });
+                            break;
+                        default: break;
+                    }
+                }
+                sessionFinishReasoning(runPath);
+                try {
+                    const u = await result.totalUsage;
+                    recordUsage(modelId, u);
+                    turnUsage.input += u.inputTokens ?? 0;
+                    turnUsage.output += u.outputTokens ?? 0;
+                    turnUsage.total += u.totalTokens ?? (u.inputTokens ?? 0) + (u.outputTokens ?? 0);
+                }
+                catch { /* usage is best-effort */ }
+                return result.text;
+            };
+            const mentioned = await promptWithFileMentions(prompt);
+            if (mentioned.files.length > 0)
+                sessionPushFeed(runPath, { kind: "status", text: `Attached ${mentioned.files.map((f) => `@${f}`).join(", ")}.` });
+            let messages = [...conversationRef.current, { role: "user", content: mentioned.prompt }];
+            let finalText = "";
+            if (!fullModeRef.current && wantsFullResearch(prompt)) {
+                setMode(true);
+                fullModeRef.current = true;
+                sessionNotifyModeChange(runPath, true);
+                sessionPushFeed(runPath, { kind: "status", text: "Detected a research request — switching to the full research harness." });
+            }
+            if (fullModeRef.current) {
+                const bundle = await createResearchAgent(runPath, summary.goal, config, onApprovalRequired);
+                try {
+                    finalText = await consume(await bundle.agent.stream({ messages, abortSignal: controller.signal, experimental_transform: markdownJoinerTransform() }));
+                }
+                finally {
+                    await bundle.close();
+                }
+            }
+            else {
+                const escalate = { requested: false };
+                const oneShot = await createOneShotAgent(runPath, summary.goal, config, onApprovalRequired, () => { escalate.requested = true; });
+                try {
+                    finalText = await consume(await oneShot.agent.stream({ messages, abortSignal: controller.signal, experimental_transform: markdownJoinerTransform() }));
+                }
+                finally {
+                    await oneShot.close();
+                }
+                if (escalate.requested && !controller.signal.aborted) {
+                    setMode(true);
+                    fullModeRef.current = true;
+                    sessionNotifyEscalate(runPath);
+                    sessionNotifyModeChange(runPath, true);
+                    sessionPushFeed(runPath, { kind: "status", text: "Escalated to the full research harness." });
+                    messages = [
+                        ...messages,
+                        { role: "assistant", content: finalText },
+                        { role: "user", content: "Approved. Now run the full research harness: discover skills, write plan.md, gather and read grounded sources, extract and verify claims, write sources.jsonl and a complete report.md, then give a short summary." }
+                    ];
+                    const full = await createResearchAgent(runPath, summary.goal, config, onApprovalRequired);
+                    try {
+                        finalText = await consume(await full.agent.stream({ messages, abortSignal: controller.signal, experimental_transform: markdownJoinerTransform() }));
+                    }
+                    finally {
+                        await full.close();
+                    }
+                }
+            }
+            conversationRef.current = [...messages, { role: "assistant", content: finalText }];
+            await refreshRun();
+        }
+        catch (error) {
+            if (!controller.signal.aborted) {
+                sessionPushFeed(runPath, { kind: "status", text: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        finally {
+            session.abort = null;
+            setBusy(false);
+            sessionSetBusy(runPath, false);
+            sessionSetApproval(runPath, null);
+            const elapsedMs = Date.now() - turnStartedAt;
+            const parts = [];
+            if (turnUsage.input > 0)
+                parts.push(`↑${fmtTokens(turnUsage.input)}`);
+            if (turnUsage.output > 0)
+                parts.push(`↓${fmtTokens(turnUsage.output)}`);
+            parts.push(`◌ ${fmtDuration(elapsedMs)}`);
+            if (controller.signal.aborted)
+                parts.push("stopped");
+            sessionPushFeed(runPath, { kind: "status", text: parts.join(" · ") });
+            if (turnUsage.input + turnUsage.output + turnUsage.total > 0) {
+                turnsRef.current = [...turnsRef.current, { model: modelId, input: turnUsage.input, output: turnUsage.output, total: turnUsage.total, ts: Date.now() }];
+            }
+            const snapshot = feedRef.current
+                .filter((item) => !(item.kind === "status" && item.text === "This will wipe the conversation history. Press /rerun again to confirm."))
+                .map((item) => item.kind === "tool" && item.status === "running" ? { ...item, status: "error" } : item);
+            try {
+                await writeFile(join(runPath, "convo.json"), JSON.stringify({ feed: snapshot, messages: conversationRef.current, usage: aggregateTurns(turnsRef.current) }, null, 2));
+            }
+            catch { /* non-fatal */ }
+            removeSession(runPath);
+            const queued = queuedPromptRef.current;
+            if (queued && !controller.signal.aborted) {
+                queuedPromptRef.current = null;
+                sessionPushFeed(runPath, { kind: "user", text: queued, ts: Date.now() });
+                void runTurnRef.current(queued);
+            }
+        }
+    }, [config, currentRunPath, refreshRun, recordUsage, setMode, getSubscriber]);
+    const runTurnRef = useRef(runTurn);
+    runTurnRef.current = runTurn;
+    return { runTurn, runTurnRef };
+}

package/dist/ui/ink/hooks/use-feed-lines.js

@@ -0,0 +1,186 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { Text } from "ink";
+import { S_BAR, TOOL_ICONS, USER_BAND_BG, SPINNER_FRAMES } from "../constants.js";
+import { formatTime, fmtDuration, wrapText, hyperlink, displayWidth } from "../lib/utils.js";
+import { markdownToSegLines } from "../lib/markdown.js";
+export function computeGroups(feed) {
+    const groupOf = new Array(feed.length).fill(-1);
+    const groups = new Map();
+    let gs = -1;
+    for (let i = 0; i < feed.length; i++) {
+        const k = feed[i].kind;
+        if (k === "tool" || k === "reasoning") {
+            if (gs === -1) {
+                gs = i;
+                groups.set(gs, { toolNames: [], itemCount: 0, active: false, end: i });
+            }
+            const g = groups.get(gs);
+            g.end = i;
+            g.itemCount++;
+            groupOf[i] = gs;
+            if (k === "tool") {
+                const it = feed[i];
+                if (!g.toolNames.includes(it.name))
+                    g.toolNames.push(it.name);
+                if (it.status === "running")
+                    g.active = true;
+            }
+            else {
+                const it = feed[i];
+                if (it.durationMs === undefined)
+                    g.active = true;
+            }
+        }
+        else {
+            gs = -1;
+        }
+    }
+    return { groupOf, groups };
+}
+const isGH = (item) => "_tag" in item;
+export function useFeedLines(feed, innerWidth, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey) {
+    return useMemo(() => {
+        const lines = [];
+        let key = 0;
+        const { groupOf, groups } = computeGroups(feed);
+        const eff = [];
+        for (let i = 0; i < feed.length; i++) {
+            const gs = groupOf[i];
+            if (gs !== -1) {
+                const info = groups.get(gs);
+                const collapsed = !info.active && collapsedGroups.has(gs);
+                if (gs === i) {
+                    eff.push({ _tag: "gh", info, key: gs, collapsed, focused: focusedGroupKey === gs });
+                    if (!collapsed)
+                        eff.push(feed[i]);
+                }
+                else if (!collapsed) {
+                    eff.push(feed[i]);
+                }
+            }
+            else {
+                eff.push(feed[i]);
+            }
+        }
+        eff.forEach((item, ei) => {
+            const currKind = isGH(item) ? "gh" : item.kind;
+            if (ei === 0 && currKind === "user") {
+                lines.push(_jsx(Text, { children: " " }, key++));
+            }
+            if (ei > 0) {
+                const prev = eff[ei - 1];
+                const prevGH = isGH(prev);
+                const currGH = isGH(item);
+                const prevKind = prevGH ? "gh" : prev.kind;
+                const currKind = currGH ? "gh" : item.kind;
+                const prevTool = prevKind === "tool" || prevKind === "reasoning";
+                const currTool = currKind === "tool" || currKind === "reasoning";
+                if (currKind === "gh") {
+                    if (prevTool) {
+                        lines.push(_jsx(Text, { color: "gray", dimColor: true, children: S_BAR }, key++));
+                        lines.push(_jsx(Text, { children: " " }, key++));
+                    }
+                    else if (prevKind !== "gh") {
+                        lines.push(_jsx(Text, { children: " " }, key++));
+                    }
+                }
+                else if (prevKind === "gh") {
+                    if (prev.collapsed) {
+                        if (currKind !== "user")
+                            lines.push(_jsx(Text, { children: " " }, key++));
+                    }
+                }
+                else if (prevTool && currTool) {
+                    if (!(prevKind === "reasoning" && currKind === "reasoning")) {
+                        lines.push(_jsx(Text, { color: "gray", dimColor: true, children: S_BAR }, key++));
+                    }
+                }
+                else if (prevTool) {
+                    if (currKind !== "user")
+                        lines.push(_jsx(Text, { children: " " }, key++));
+                }
+                else if (currTool) {
+                    lines.push(_jsx(Text, { children: " " }, key++));
+                }
+                else if (prevKind === "status" && currKind === "status") {
+                }
+                else if (currKind === "user") {
+                    if (prevKind !== "user") {
+                        lines.push(_jsx(Text, { children: " " }, key++));
+                        lines.push(_jsx(Text, { children: " " }, key++));
+                    }
+                }
+                else {
+                    lines.push(_jsx(Text, { children: " " }, key++));
+                }
+            }
+            if (isGH(item)) {
+                const { info, collapsed, focused } = item;
+                const icon = info.active ? "◎" : collapsed ? "▶" : "▼";
+                const hc = focused ? "#FFE0C2" : "gray";
+                const names = info.toolNames.slice(0, 5).join(", ") + (info.toolNames.length > 5 ? ", …" : "");
+                lines.push(_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: info.active ? "#FFE0C2" : hc, bold: info.active || focused, children: [icon, " "] }), _jsxs(Text, { color: info.active ? "white" : hc, bold: info.active || focused, dimColor: !info.active && !focused, children: [info.itemCount, " step", info.itemCount !== 1 ? "s" : ""] }), (collapsed || info.active) && names ? (_jsxs(Text, { color: "gray", dimColor: true, children: ["  ", names] })) : null, focused && !collapsed && !info.active ? (_jsx(Text, { color: "gray", dimColor: true, children: "  [c] collapse · [esc] unfocus" })) : null] }, key++));
+                return;
+            }
+            const fi = item;
+            if (fi.kind === "tool") {
+                const toolIcon = fi.status === "running"
+                    ? SPINNER_FRAMES[spinnerFrame % SPINNER_FRAMES.length]
+                    : TOOL_ICONS[fi.name] ?? "·";
+                const symColor = "#CFB59D";
+                const nameColor = fi.status === "running" ? "white" : "gray";
+                const summaryLine = fi.summary.replace(/\s+/gu, " ").trim();
+                const toolSummary = summaryLine.length > innerWidth - fi.name.length - 6
+                    ? summaryLine.slice(0, Math.max(0, innerWidth - fi.name.length - 7)) + "…"
+                    : summaryLine;
+                lines.push(_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: symColor, bold: fi.status === "running", children: toolIcon }), _jsxs(Text, { color: nameColor, bold: fi.status === "running", dimColor: fi.status === "done", children: [" ", fi.name] }), _jsxs(Text, { color: "gray", dimColor: true, children: ["  ", toolSummary] })] }, key++));
+            }
+            else if (fi.kind === "user") {
+                const bandW = innerWidth;
+                const time = formatTime(fi.ts);
+                const rightPad = time ? time.length + 1 : 0;
+                const wrapped = wrapText(fi.text, Math.max(10, bandW - 4 - rightPad));
+                const blank = " ".repeat(bandW);
+                lines.push(_jsx(Text, { backgroundColor: USER_BAND_BG, children: blank }, key++));
+                wrapped.forEach((l, idx) => {
+                    const isFirst = idx === 0;
+                    const prefix = isFirst ? "  ❯ " : "    ";
+                    const left = prefix + l;
+                    const pad = Math.max(1, bandW - displayWidth(left) - (isFirst ? rightPad : 0));
+                    lines.push(_jsxs(Text, { backgroundColor: USER_BAND_BG, wrap: "truncate", children: [_jsx(Text, { color: isFirst ? "#FFE0C2" : "white", children: prefix }), _jsx(Text, { color: "white", children: l }), _jsx(Text, { children: " ".repeat(pad) }), isFirst && time ? _jsx(Text, { color: "gray", dimColor: true, children: time + " " }) : null] }, key++));
+                });
+                lines.push(_jsx(Text, { backgroundColor: USER_BAND_BG, children: blank }, key++));
+            }
+            else if (fi.kind === "status") {
+                lines.push(_jsxs(Text, { color: "gray", dimColor: true, wrap: "truncate", children: ["  · ", fi.text] }, key++));
+            }
+            else if (fi.kind === "reasoning") {
+                const isOpen = fi.durationMs === undefined;
+                const elapsedMs = fi.durationMs ?? (fi.startedAt ? Date.now() - fi.startedAt : 0);
+                const titleText = isOpen ? `Thinking… ${fmtDuration(elapsedMs)}` : `Thought for ${fmtDuration(elapsedMs)}`;
+                lines.push(_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: "gray", dimColor: true, children: "\u25CC " }), _jsx(Text, { color: "gray", bold: isOpen, dimColor: !isOpen, children: titleText })] }, key++));
+                for (const segLine of markdownToSegLines(fi.text, innerWidth - 4)) {
+                    if (segLine.length === 0) {
+                        lines.push(_jsx(Text, { color: "gray", dimColor: true, children: S_BAR }, key++));
+                        continue;
+                    }
+                    lines.push(_jsxs(Text, { color: "gray", dimColor: true, italic: true, wrap: "truncate-end", children: [_jsx(Text, { color: "gray", dimColor: true, children: "│ " }), segLine.map((s, i) => (_jsx(Text, { color: "gray", bold: s.bold, italic: s.italic ?? true, underline: s.underline, dimColor: true, children: hyperlink(s.text, s.url) }, i)))] }, key++));
+                }
+            }
+            else {
+                for (const segLine of markdownToSegLines(fi.text, innerWidth - 2)) {
+                    if (segLine.length === 0) {
+                        lines.push(_jsx(Text, { children: " " }, key++));
+                        continue;
+                    }
+                    lines.push(_jsx(Text, { wrap: "truncate-end", children: segLine.map((s, i) => (_jsx(Text, { color: s.color ?? "white", bold: s.bold, italic: s.italic, underline: s.underline, dimColor: s.dim, children: hyperlink(s.text, s.url) }, i))) }, key++));
+                }
+            }
+        });
+        return lines;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [feed, innerWidth, reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey]);
+}