@scira/cli 0.1.2 → 0.1.4

package/dist/tools/workspace.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect } from "vitest";
+import { harnessBasename, isRunArtifactPath, resolveInsideRun, resolveProjectRoot, resolveToolPath } from "./workspace.js";
+const RUN = "/tmp/scira-test-run";
+const PROJECT = "/Users/me/my-app";
+const RUN_UNDER_SCIRA = `${PROJECT}/.scira/runs/2024-test-abc`;
+describe("resolveInsideRun", () => {
+    it("resolves a relative path inside the run dir", () => {
+        expect(resolveInsideRun(RUN, "notes.md")).toBe(`${RUN}/notes.md`);
+    });
+    it("resolves a nested relative path inside the run dir", () => {
+        expect(resolveInsideRun(RUN, "artifacts/output.txt")).toBe(`${RUN}/artifacts/output.txt`);
+    });
+    it("resolves an absolute path that is inside the run dir", () => {
+        expect(resolveInsideRun(RUN, `${RUN}/plan.md`)).toBe(`${RUN}/plan.md`);
+    });
+    it("throws for a path that escapes with ../", () => {
+        expect(() => resolveInsideRun(RUN, "../outside.txt")).toThrow("outside the run directory");
+    });
+    it("throws for a deep escape path", () => {
+        expect(() => resolveInsideRun(RUN, "a/../../outside.txt")).toThrow("outside the run directory");
+    });
+    it("throws for an absolute path outside the run dir", () => {
+        expect(() => resolveInsideRun(RUN, "/etc/passwd")).toThrow("outside the run directory");
+    });
+    it("throws for a home-dir escape", () => {
+        const home = `${process.env.HOME ?? "/root"}/evil.sh`;
+        expect(() => resolveInsideRun(RUN, home)).toThrow("outside the run directory");
+    });
+});
+describe("resolveProjectRoot", () => {
+    it("returns parent of .scira when run is under .scira/runs", () => {
+        expect(resolveProjectRoot(RUN_UNDER_SCIRA)).toBe(PROJECT);
+    });
+});
+describe("harnessBasename", () => {
+    it("strips run: and ./ prefixes", () => {
+        expect(harnessBasename("run:report.md")).toBe("report.md");
+        expect(harnessBasename("./plan.md")).toBe("plan.md");
+        expect(harnessBasename("notes.md")).toBe("notes.md");
+    });
+});
+describe("isRunArtifactPath", () => {
+    it("treats bare harness filenames as run artifacts", () => {
+        expect(isRunArtifactPath("plan.md")).toBe(true);
+        expect(isRunArtifactPath("notes.md")).toBe(true);
+        expect(isRunArtifactPath("src/foo.ts")).toBe(false);
+    });
+    it("does not treat nested paths as run artifacts by basename", () => {
+        expect(isRunArtifactPath("docs/notes.md")).toBe(false);
+        expect(isRunArtifactPath("src/plan.md")).toBe(false);
+    });
+    it("treats run: prefix as run artifact", () => {
+        expect(isRunArtifactPath("run:custom.md")).toBe(true);
+    });
+});
+describe("resolveToolPath", () => {
+    it("routes source paths to workspace", () => {
+        const resolved = resolveToolPath(RUN_UNDER_SCIRA, PROJECT, "src/index.ts");
+        expect(resolved.scope).toBe("workspace");
+        expect(resolved.abs).toBe(`${PROJECT}/src/index.ts`);
+    });
+    it("routes plan.md to run directory", () => {
+        const resolved = resolveToolPath(RUN_UNDER_SCIRA, PROJECT, "plan.md");
+        expect(resolved.scope).toBe("run");
+        expect(resolved.abs).toBe(`${RUN_UNDER_SCIRA}/plan.md`);
+    });
+    it("routes nested notes.md to workspace not run", () => {
+        const resolved = resolveToolPath(RUN_UNDER_SCIRA, PROJECT, "docs/notes.md");
+        expect(resolved.scope).toBe("workspace");
+        expect(resolved.abs).toBe(`${PROJECT}/docs/notes.md`);
+    });
+    it("blocks writes into .scira from workspace paths", () => {
+        expect(() => resolveToolPath(RUN_UNDER_SCIRA, PROJECT, ".scira/config.json")).toThrow("inside .scira");
+    });
+});

package/dist/tools/x-search.js

@@ -0,0 +1,142 @@
+import { generateText, tool, stepCountIs } from "ai";
+import { xai } from "@ai-sdk/xai";
+import { z } from "zod";
+import { getTweet } from "react-tweet/api";
+import { logEvent } from "../storage/run-store.js";
+const XSEARCH_MODEL = "grok-4.20-0309-non-reasoning";
+function sanitizeHandle(h) {
+    return h.replace(/^@+/u, "").trim();
+}
+function toYMD(d) {
+    return d.toISOString().slice(0, 10);
+}
+function extractTweetId(url) {
+    return url.match(/status\/(\d+)/u)?.[1] ?? null;
+}
+function canonicalLink(id, fallback) {
+    return id ? `https://x.com/i/status/${id}` : fallback;
+}
+export function createXSearchTool(runPath) {
+    return tool({
+        description: "Search X (formerly Twitter) for recent posts. Best for current events, public reactions, announcements, breaking news, and real-time opinions. Searches the last 7 days by default. Use 1–3 targeted queries per call.",
+        inputSchema: z
+            .object({
+            queries: z
+                .array(z.string())
+                .min(1)
+                .max(5)
+                .describe("Search queries for X posts. 1–3 targeted queries recommended."),
+            startDate: z
+                .string()
+                .optional()
+                .describe("Start date YYYY-MM-DD (default: 7 days ago)."),
+            endDate: z
+                .string()
+                .optional()
+                .describe("End date YYYY-MM-DD (default: today)."),
+            includeXHandles: z
+                .array(z.string())
+                .max(10)
+                .optional()
+                .describe("Only include posts from these X handles (max 10). Cannot be combined with excludeXHandles."),
+            excludeXHandles: z
+                .array(z.string())
+                .max(10)
+                .optional()
+                .describe("Exclude posts from these X handles (max 10). Cannot be combined with includeXHandles."),
+        })
+            .refine((data) => {
+            const hasInclude = data.includeXHandles && data.includeXHandles.length > 0;
+            const hasExclude = data.excludeXHandles && data.excludeXHandles.length > 0;
+            return !(hasInclude && hasExclude);
+        }, { message: "Cannot specify both includeXHandles and excludeXHandles", path: ["includeXHandles"] }),
+        execute: async ({ queries, startDate, endDate, includeXHandles, excludeXHandles }) => {
+            await logEvent(runPath, "tool.xSearch", { queries });
+            const today = new Date();
+            const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+            const effectiveStart = startDate?.trim() || toYMD(sevenDaysAgo);
+            const effectiveEnd = endDate?.trim() || toYMD(today);
+            const dateRange = `${effectiveStart} to ${effectiveEnd}`;
+            const normalizedInclude = includeXHandles?.map(sanitizeHandle).filter(Boolean);
+            const normalizedExclude = excludeXHandles?.map(sanitizeHandle).filter(Boolean);
+            const results = await Promise.all(queries.map(async (query) => {
+                try {
+                    const searchConfig = {
+                        fromDate: effectiveStart,
+                        toDate: effectiveEnd,
+                    };
+                    if (normalizedInclude?.length)
+                        searchConfig.allowedXHandles = normalizedInclude;
+                    if (normalizedExclude?.length)
+                        searchConfig.excludedXHandles = normalizedExclude;
+                    const { sources } = await generateText({
+                        model: xai.responses(XSEARCH_MODEL),
+                        system: "Run the x_search tool for the given query and stop immediately. Do not output any text.",
+                        messages: [{ role: "user", content: query }],
+                        maxOutputTokens: 5,
+                        stopWhen: stepCountIs(1),
+                        tools: { x_search: xai.tools.xSearch(searchConfig) },
+                    });
+                    const citations = (Array.isArray(sources) ? sources : []);
+                    // Deduplicate citation URLs within this query before fetching
+                    const seenIds = new Set();
+                    const uniqueCitations = citations.filter((c) => {
+                        if (c.sourceType !== "url" || !c.url)
+                            return false;
+                        const id = extractTweetId(c.url) ?? c.url;
+                        if (seenIds.has(id))
+                            return false;
+                        seenIds.add(id);
+                        return true;
+                    });
+                    // Hydrate each citation URL with full tweet content
+                    const posts = (await Promise.all(uniqueCitations.map(async (c) => {
+                        const rawUrl = c.url;
+                        const tweetId = extractTweetId(rawUrl);
+                        try {
+                            if (!tweetId)
+                                return { url: rawUrl };
+                            const data = await getTweet(tweetId);
+                            if (!data)
+                                return { url: canonicalLink(tweetId, rawUrl), id: tweetId };
+                            const handle = data.user?.screen_name ?? undefined;
+                            return {
+                                url: handle
+                                    ? `https://x.com/${handle}/status/${tweetId}`
+                                    : canonicalLink(tweetId, rawUrl),
+                                id: tweetId,
+                                handle,
+                                text: data.text,
+                            };
+                        }
+                        catch {
+                            return { url: canonicalLink(tweetId, rawUrl), id: tweetId ?? undefined };
+                        }
+                    }))).filter((p) => p !== null);
+                    return { query, dateRange, posts };
+                }
+                catch (error) {
+                    return { query, dateRange, posts: [], error: String(error) };
+                }
+            }));
+            // Cross-query dedup by tweet ID or URL
+            const seenKeys = new Set();
+            const deduped = results.map((r) => ({
+                ...r,
+                posts: r.posts.filter((p) => {
+                    const key = p.id ?? p.url;
+                    if (seenKeys.has(key))
+                        return false;
+                    seenKeys.add(key);
+                    return true;
+                }),
+            }));
+            const allFailed = deduped.every((r) => r.posts.length === 0 && r.error);
+            if (allFailed) {
+                const errors = deduped.map((r) => r.error).filter(Boolean).join(" | ");
+                throw new Error(`X search failed: ${errors}`);
+            }
+            return JSON.stringify(deduped, null, 2);
+        },
+    });
+}

package/dist/types/index.js

@@ -8,6 +8,7 @@ export const SciraConfigSchema = z.object({
     // last selected model per LLM provider, restored when switching back
     lastModels: z.record(z.string(), z.string()).default({}),
     approvalMode: ApprovalModeSchema.default("suggest"),
+    alwaysAllowLinks: z.boolean().default(false),
     runDirectory: z.string().default(".scira/runs"),
     maxSources: z.number().int().min(1).max(100).default(20),
     citationPolicy: z.enum(["strict", "balanced"]).default("strict"),

package/dist/types/schema.test.js

@@ -51,6 +51,7 @@ describe("SciraConfigSchema", () => {
         const config = SciraConfigSchema.parse({});
         expect(config.llmProvider).toBe("gateway");
         expect(config.approvalMode).toBe("suggest");
+        expect(config.alwaysAllowLinks).toBe(false);
         expect(config.runDirectory).toBe(".scira/runs");
         expect(config.maxSources).toBe(20);
     });

package/dist/ui/ink/SciraApp.js

@@ -2,13 +2,14 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React, { useCallback, useMemo, useRef, useState } from "react";
 import { Box, useApp, useStdout, useStdin } from "ink";
 import { CHAT_COMMANDS, MENU_VISIBLE } from "./constants.js";
-import { CWD_DISPLAY, wrapText, wrapInputWithCursor, loadInputHistory, saveInputHistory } from "./lib/utils.js";
+import { CWD_DISPLAY, wrapText, wrapInputWithCursor, loadInputHistory, saveInputHistory, linkAtMouseColumn, openExternalUrl } from "./lib/utils.js";
 import { deleteRun } from "../../storage/run-store.js";
+import { saveGlobalConfig } from "../../config/load-config.js";
 import { useMountEffect, TipCycler, AnimationTick, MouseTracker } from "./components/effects.js";
 import { useFeedLines, computeGroups } from "./hooks/use-feed-lines.js";
 import { feedToolItemId, isToolItemCollapsed } from "./lib/tool-result.js";
 import { useAgentTurn } from "./hooks/use-agent-turn.js";
-import { TopBar, InputBar, HintLine, CommandMenuBox, HelpBox, ApprovalBox, MenuDialog, McpDialog, buildMcpDialogRows } from "./components/overlays.js";
+import { TopBar, InputBar, HintLine, CommandMenuBox, HelpBox, ApprovalBox, LinkOpenBox, MenuDialog, McpDialog, buildMcpDialogRows } from "./components/overlays.js";
 import { useMcpActions } from "./hooks/use-mcp-actions.js";
 import { useKeyboard } from "./hooks/use-keyboard.js";
 import { HomeScreen } from "./components/home-screen.js";
@@ -52,6 +53,9 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
     const fullModeRef = useRef(false);
     const [fullMode, setFullModeState] = useState(false);
     const setMode = useCallback((full) => { fullModeRef.current = full; setFullModeState(full); }, []);
+    const planModeRef = useRef(false);
+    const [planMode, setPlanModeState] = useState(false);
+    const setPlanMode = useCallback((active) => { planModeRef.current = active; setPlanModeState(active); }, []);
     const [usage, setUsage] = useState({});
     const turnsRef = useRef([]);
     const recordUsage = useCallback((model, u) => {
@@ -66,6 +70,27 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
         });
     }, []);
     const [approvalPending, setApprovalPending] = useState(null);
+    const [linkPending, setLinkPending] = useState(null);
+    const confirmLinkOpen = useCallback(() => {
+        setLinkPending((pending) => {
+            if (pending)
+                void openExternalUrl(pending.url);
+            return null;
+        });
+    }, []);
+    const enableAlwaysAllowLinks = useCallback(() => {
+        setLinkPending((pending) => {
+            if (pending) {
+                void (async () => {
+                    const next = { ...config, alwaysAllowLinks: true };
+                    setConfig(next);
+                    await saveGlobalConfig(next);
+                    void openExternalUrl(pending.url);
+                })();
+            }
+            return null;
+        });
+    }, [config, setConfig]);
     const [inputText, setInputText] = useState("");
     const [cursorPos, setCursorPos] = useState(0);
     const [inputHistory, setInputHistory] = useState([]);
@@ -201,15 +226,22 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
     }), [pushFeed, appendText, appendReasoning, finishReasoning, markToolDone, setBusy, setApprovalPending, setMode]);
     const runTurnRef = useRef(async () => { });
     const { refreshSessions, refreshRun, openRun: openRunBase } = useSession({
-        config, currentRunPath, conversationRef, feedRef, turnsRef, startedRef, runTurnRef,
+        config, currentRunPath, conversationRef, feedRef, turnsRef, startedRef,
         setSessions, setRunState, setCurrentRunPath, setInputText, setCursorPos,
-        setFeed, setUsage, setScrollOffset, setScreen, setMode,
+        setFeed, setUsage, setScrollOffset, setScreen, setMode, setPlanMode,
         setBusy, setApprovalPending, getSubscriber,
     });
+    const { runTurn } = useAgentTurn({
+        config, currentRunPath, queuedPromptRef, fullModeRef, planModeRef, conversationRef, turnsRef, feedRef,
+        setBusy, setScrollOffset, refreshRun, recordUsage, setMode, setPlanMode, getSubscriber,
+    });
+    runTurnRef.current = runTurn;
     const openRun = useCallback(async (runPath, initialQuestion) => {
         setPendingRerun(false);
-        await openRunBase(runPath, initialQuestion);
-    }, [openRunBase, setPendingRerun]);
+        const start = await openRunBase(runPath, initialQuestion);
+        if (start)
+            await runTurn(start.startPrompt, runPath);
+    }, [openRunBase, runTurn, setPendingRerun]);
     useMountEffect(() => {
         if (!initialRunPath)
             void refreshSessions();
@@ -276,17 +308,16 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
     React.useEffect(() => {
         setMcpRowIdx((i) => Math.min(i, Math.max(0, mcpRowCount - 1)));
     }, [mcpRowCount]);
-    const { runTurn } = useAgentTurn({
-        config, currentRunPath, queuedPromptRef, fullModeRef, conversationRef, turnsRef, feedRef,
-        setBusy, setScrollOffset, refreshRun, recordUsage, setMode, getSubscriber,
+    useMountEffect(() => {
+        if (initialRunPath)
+            void openRun(initialRunPath);
     });
-    runTurnRef.current = runTurn;
     const { submitHome, submitChat, stopTurn } = useSubmit({
         state: { config, currentRunPath, sessions, selectedIdx, busy, usage, pendingRerun },
-        refs: { queuedPromptRef, conversationRef, feedRef },
+        refs: { queuedPromptRef, fullModeRef, planModeRef, conversationRef, feedRef },
         setters: {
             setApprovalPending, setInputText, setCursorPos, setInputHistory, setHistoryIndex, setHelpOpen,
-            setNotice, setBusy, setScreen, setFeed, setRunState, setPendingRerun, setMode, setConfig, setMcpOpen,
+            setNotice, setBusy, setScreen, setFeed, setRunState, setPendingRerun, setMode, setPlanMode, setConfig, setMcpOpen,
             setHeroHidden,
         },
         actions: { pushFeed, refreshSessions, openRun, openMenu, handleSettings, runTurn, exit },
@@ -297,8 +328,9 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
     const innerWidth = Math.max(20, cols - 4);
     const boxWidth = Math.max(20, cols - 4);
     const textWidth = Math.max(1, boxWidth - 6);
-    const rawInputText = approvalPending ? "waiting for approval\u2026" : inputText;
-    const showCursor = !busy && !approvalPending;
+    const inputBlocked = !!approvalPending || !!linkPending;
+    const rawInputText = approvalPending ? "waiting for approval\u2026" : linkPending ? "open link? a/y/n" : inputText;
+    const showCursor = !busy && !inputBlocked;
     const caret = Math.max(0, Math.min(cursorPos, inputText.length));
     const { lines: inputLines, cursorLine, cursorCol } = wrapInputWithCursor(rawInputText, textWidth, showCursor ? caret : -1);
     const commandMenuHeight = activeSuggestions.length > 0 ? Math.min(MENU_VISIBLE, activeSuggestions.length) + 3 : 0;
@@ -307,15 +339,20 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
         ? Math.min(5, wrapText(approvalPending.description, Math.max(10, innerWidth - 4)).length)
         : 0;
     const approvalHeight = approvalPending ? approvalPreviewLines + 5 : 0;
-    const menuHeight = commandMenuHeight + helpHeight + approvalHeight;
+    const linkPreviewLines = linkPending
+        ? Math.min(4, wrapText(linkPending.url, Math.max(10, innerWidth - 4)).length)
+        : 0;
+    const linkHeight = linkPending ? linkPreviewLines + 5 : 0;
+    const menuHeight = commandMenuHeight + helpHeight + approvalHeight + linkHeight;
     const feedRows = Math.max(3, rows - 6 - inputLines.length - menuHeight);
     const hasRunningTool = feed.some((it) => it.kind === "tool" && it.status === "running");
-    const { lines: feedLines, toggleAtLine, groupToggleAtLine } = useFeedLines(feed, innerWidth, reasoningTick, hasRunningTool ? frame : 0, collapsedGroups, focusedGroupKey, itemExpandState, hoveredIdx, config);
+    const { lines: feedLines, toggleAtLine, groupToggleAtLine, linkAtLine } = useFeedLines(feed, innerWidth, reasoningTick, hasRunningTool ? frame : 0, collapsedGroups, focusedGroupKey, itemExpandState, hoveredIdx, config);
     const contentRows = Math.max(1, feedRows);
     const maxScrollOffset = Math.max(0, feedLines.length - contentRows);
     wheelStateRef.current = { screen, maxScrollOffset };
     const clampedOffset = Math.min(scrollOffset, maxScrollOffset);
     const startIdx = Math.max(0, feedLines.length - contentRows - clampedOffset);
+    const hasLinkHover = hoveredIdx !== null && (linkAtLine.get(hoveredIdx)?.length ?? 0) > 0;
     const feedStartRow = 3;
     if (screen === "chat") {
         const clickMap = new Map();
@@ -325,11 +362,25 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
             if (vis < 0 || vis >= contentRows)
                 return;
             const row = feedStartRow + vis;
-            clickMap.set(row, onClick);
+            const prev = clickMap.get(row);
+            clickMap.set(row, prev ? (x) => { prev(x); onClick(x); } : onClick);
             hoverMap.set(row, lineIdx);
         };
         toggleAtLine.forEach((id, lineIdx) => registerLine(lineIdx, () => toggleToolItem(id)));
         groupToggleAtLine.forEach((groupKey, lineIdx) => registerLine(lineIdx, () => toggleGroup(groupKey)));
+        linkAtLine.forEach((links, lineIdx) => {
+            registerLine(lineIdx, (x) => {
+                if (approvalPending)
+                    return;
+                const url = linkAtMouseColumn(links, x);
+                if (!url)
+                    return;
+                if (config.alwaysAllowLinks)
+                    void openExternalUrl(url);
+                else
+                    setLinkPending({ url });
+            });
+        });
         clickMapRef.current = clickMap;
         hoverMapRef.current = hoverMap;
     }
@@ -343,7 +394,9 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
         exit,
         input: { text: inputText, setText: setInputText, cursorPos, setCursorPos, history: inputHistory, historyIndex, setHistoryIndex },
         dialogs: {
-            approvalPending, setApprovalPending, menu, setMenu, applyMenuSelection, helpOpen, setHelpOpen,
+            approvalPending, setApprovalPending, linkPending, setLinkPending,
+            onConfirmLink: confirmLinkOpen, onAlwaysAllowLinks: enableAlwaysAllowLinks,
+            menu, setMenu, applyMenuSelection, helpOpen, setHelpOpen,
             mcpOpen, setMcpOpen, mcpRowIdx, setMcpRowIdx, mcpRowCount, toggleMcpRow, removeMcpRow,
         },
         suggestions: { activeSuggestions, activeSuggestionKind, commandMenuIndex, setCommandMenuIndex, acceptActiveSuggestion },
@@ -351,11 +404,11 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
         home: { sessionsModalOpen, setSessionsModalOpen, sessionsModalIdx, setSessionsModalIdx, sessions, deleteSession, selectedIdx, setSelectedIdx, setHeroHidden, openRun, submitHome },
     });
     const activeUsage = usage[config.model];
-    const themed = (node) => (_jsx(ThemeProvider, { config: config, stdin: stdin, stdout: stdout, children: node }));
+    const themed = (node) => (_jsx(ThemeProvider, { config: config, children: node }));
     if (screen === "home") {
-        return themed(_jsxs(Box, { flexDirection: "column", width: cols, height: rows, paddingX: 2, children: [_jsx(TipCycler, { setTipIndex: setTipIndex }), (!sessionsModalOpen || mcpOpen) && stdout !== undefined && stdin !== undefined && (_jsx(MouseTracker, { stdout: stdout, stdin: stdin, onData: handleMouseData, onUnmount: () => setHoveredIdx(null) })), busy && _jsx(AnimationTick, { setBlink: setBlink, setFrame: setFrame, setReasoningTick: setReasoningTick }), _jsx(TopBar, { screen: screen, runState: runState, fullMode: fullMode, activeUsage: activeUsage, busy: busy, frame: frame, cwdDisplay: CWD_DISPLAY, config: config }), _jsx(HomeScreen, { cols: cols, rows: rows, sessions: sessions, selectedIdx: selectedIdx, hoveredIdx: hoveredIdx, heroHidden: heroHidden, notice: notice, tipIndex: tipIndex, commandMenuHeight: commandMenuHeight, mcpOpen: mcpOpen, sessionsModalOpen: sessionsModalOpen, sessionsModalIdx: sessionsModalIdx, inputText: inputText, config: config, modelName: modelName, clickMapRef: clickMapRef, hoverMapRef: hoverMapRef, setSelectedIdx: setSelectedIdx, setSessionsModalOpen: setSessionsModalOpen, setSessionsModalIdx: setSessionsModalIdx, setNotice: setNotice, openRun: openRun, submitHome: submitHome, exit: exit }), _jsxs(Box, { flexDirection: "column", paddingBottom: 1, children: [_jsx(CommandMenuBox, { activeSuggestions: activeSuggestions, activeSuggestionKind: activeSuggestionKind, commandMenuIndex: commandMenuIndex, innerWidth: innerWidth, sessions: sessions, config: config }), _jsx(InputBar, { inputLines: inputLines, cursorLine: cursorLine, cursorCol: cursorCol, showCursor: showCursor, approvalPending: !!approvalPending, busy: busy, frame: frame, boxWidth: boxWidth, modelName: modelName, config: config }), _jsx(HintLine, { screen: screen, busy: busy, config: config })] }), _jsx(MenuDialog, { menu: menu, cols: cols, rows: rows, config: config }), _jsx(McpDialog, { open: mcpOpen, config: config, cols: cols, rows: rows, selectedIdx: mcpRowIdx, hoveredIdx: hoveredIdx, onToggle: handleMcpToggle, onRemove: handleMcpRemove, clickMapRef: clickMapRef, hoverMapRef: hoverMapRef })] }));
+        return themed(_jsxs(Box, { flexDirection: "column", width: cols, height: rows, paddingX: 2, children: [_jsx(TipCycler, { setTipIndex: setTipIndex }), (!sessionsModalOpen || mcpOpen) && stdout !== undefined && stdin !== undefined && (_jsx(MouseTracker, { stdout: stdout, stdin: stdin, onData: handleMouseData, onUnmount: () => setHoveredIdx(null) })), busy && _jsx(AnimationTick, { setBlink: setBlink, setFrame: setFrame, setReasoningTick: setReasoningTick }), _jsx(TopBar, { screen: screen, runState: runState, fullMode: fullMode, planMode: planMode, activeUsage: activeUsage, busy: busy, frame: frame, cwdDisplay: CWD_DISPLAY, config: config }), _jsx(HomeScreen, { cols: cols, rows: rows, sessions: sessions, selectedIdx: selectedIdx, hoveredIdx: hoveredIdx, heroHidden: heroHidden, notice: notice, tipIndex: tipIndex, commandMenuHeight: commandMenuHeight, mcpOpen: mcpOpen, sessionsModalOpen: sessionsModalOpen, sessionsModalIdx: sessionsModalIdx, inputText: inputText, config: config, modelName: modelName, clickMapRef: clickMapRef, hoverMapRef: hoverMapRef, setSelectedIdx: setSelectedIdx, setSessionsModalOpen: setSessionsModalOpen, setSessionsModalIdx: setSessionsModalIdx, setNotice: setNotice, openRun: openRun, submitHome: submitHome, exit: exit }), _jsxs(Box, { flexDirection: "column", paddingBottom: 1, children: [_jsx(CommandMenuBox, { activeSuggestions: activeSuggestions, activeSuggestionKind: activeSuggestionKind, commandMenuIndex: commandMenuIndex, innerWidth: innerWidth, sessions: sessions, config: config }), _jsx(InputBar, { inputLines: inputLines, cursorLine: cursorLine, cursorCol: cursorCol, showCursor: showCursor, approvalPending: inputBlocked, busy: busy, frame: frame, boxWidth: boxWidth, modelName: modelName, config: config }), _jsx(HintLine, { screen: screen, busy: busy, config: config })] }), _jsx(MenuDialog, { menu: menu, cols: cols, rows: rows, config: config }), _jsx(McpDialog, { open: mcpOpen, config: config, cols: cols, rows: rows, selectedIdx: mcpRowIdx, hoveredIdx: hoveredIdx, onToggle: handleMcpToggle, onRemove: handleMcpRemove, clickMapRef: clickMapRef, hoverMapRef: hoverMapRef })] }));
     }
-    return themed(_jsxs(Box, { flexDirection: "column", width: cols, height: rows, paddingX: 2, children: [stdout !== undefined && stdin !== undefined && (_jsx(MouseTracker, { stdout: stdout, stdin: stdin, onData: handleMouseData, onUnmount: () => setHoveredIdx(null) })), busy && _jsx(AnimationTick, { setBlink: setBlink, setFrame: setFrame, setReasoningTick: setReasoningTick }), _jsx(TopBar, { screen: screen, runState: runState, fullMode: fullMode, activeUsage: activeUsage, busy: busy, frame: frame, cwdDisplay: CWD_DISPLAY, config: config }), _jsx(Box, { flexDirection: "column", flexGrow: 1, paddingTop: 1, overflow: "hidden", children: visibleLines }), _jsxs(ChatInputChrome, { children: [_jsx(CommandMenuBox, { activeSuggestions: activeSuggestions, activeSuggestionKind: activeSuggestionKind, commandMenuIndex: commandMenuIndex, innerWidth: innerWidth, sessions: sessions, config: config }), _jsx(HelpBox, { open: helpOpen, innerWidth: innerWidth, config: config }), approvalPending && _jsx(ApprovalBox, { toolName: approvalPending.toolName, description: approvalPending.description, innerWidth: innerWidth, config: config }), _jsx(InputBar, { inputLines: inputLines, cursorLine: cursorLine, cursorCol: cursorCol, showCursor: showCursor, approvalPending: !!approvalPending, busy: busy, frame: frame, boxWidth: boxWidth, modelName: modelName, config: config }), _jsx(HintLine, { screen: screen, busy: busy, scrollLabel: scrollLabel, hasDoneGroups: doneGroupKeys.length > 0, hasFocusedGroup: focusedGroupKey !== null, config: config })] }), _jsx(MenuDialog, { menu: menu, cols: cols, rows: rows, config: config }), _jsx(McpDialog, { open: mcpOpen, config: config, cols: cols, rows: rows, selectedIdx: mcpRowIdx, hoveredIdx: hoveredIdx, onToggle: handleMcpToggle, onRemove: handleMcpRemove, clickMapRef: clickMapRef, hoverMapRef: hoverMapRef })] }));
+    return themed(_jsxs(Box, { flexDirection: "column", width: cols, height: rows, paddingX: 2, children: [stdout !== undefined && stdin !== undefined && (_jsx(MouseTracker, { stdout: stdout, stdin: stdin, onData: handleMouseData, onUnmount: () => setHoveredIdx(null) })), busy && _jsx(AnimationTick, { setBlink: setBlink, setFrame: setFrame, setReasoningTick: setReasoningTick }), _jsx(TopBar, { screen: screen, runState: runState, fullMode: fullMode, planMode: planMode, activeUsage: activeUsage, busy: busy, frame: frame, cwdDisplay: CWD_DISPLAY, config: config }), _jsx(Box, { flexDirection: "column", height: contentRows, flexShrink: 0, justifyContent: "flex-end", paddingTop: 1, overflow: "hidden", children: visibleLines }), _jsxs(ChatInputChrome, { children: [_jsx(CommandMenuBox, { activeSuggestions: activeSuggestions, activeSuggestionKind: activeSuggestionKind, commandMenuIndex: commandMenuIndex, innerWidth: innerWidth, sessions: sessions, config: config }), _jsx(HelpBox, { open: helpOpen, innerWidth: innerWidth, config: config }), approvalPending && _jsx(ApprovalBox, { toolName: approvalPending.toolName, description: approvalPending.description, innerWidth: innerWidth, config: config }), linkPending && _jsx(LinkOpenBox, { url: linkPending.url, innerWidth: innerWidth, config: config }), _jsx(InputBar, { inputLines: inputLines, cursorLine: cursorLine, cursorCol: cursorCol, showCursor: showCursor, approvalPending: inputBlocked, busy: busy, frame: frame, boxWidth: boxWidth, modelName: modelName, config: config }), _jsx(HintLine, { screen: screen, busy: busy, scrollLabel: scrollLabel, hasDoneGroups: doneGroupKeys.length > 0, hasFocusedGroup: focusedGroupKey !== null, hasLinkHover: hasLinkHover || !!linkPending, alwaysAllowLinks: config.alwaysAllowLinks, config: config })] }), _jsx(MenuDialog, { menu: menu, cols: cols, rows: rows, config: config }), _jsx(McpDialog, { open: mcpOpen, config: config, cols: cols, rows: rows, selectedIdx: mcpRowIdx, hoveredIdx: hoveredIdx, onToggle: handleMcpToggle, onRemove: handleMcpRemove, clickMapRef: clickMapRef, hoverMapRef: hoverMapRef })] }));
 }
 function ChatInputChrome({ children }) {
     const theme = useTheme();

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

@@ -4,9 +4,9 @@ import { SPINNER_FRAMES, CHAT_COMMANDS, COMMAND_DESCRIPTIONS, MENU_VISIBLE } fro
 import { fmtTokens, wrapText } from "../lib/utils.js";
 import { LLM_PROVIDER_LABELS } from "../../../providers/llm/registry.js";
 import { useTheme } from "../hooks/use-theme.js";
-export function TopBar({ screen, runState, fullMode, activeUsage, busy, frame, cwdDisplay, config }) {
+export function TopBar({ screen, runState, fullMode, planMode, activeUsage, busy, frame, cwdDisplay, config }) {
     const theme = useTheme();
-    return (_jsxs(Box, { paddingTop: 1, justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, minWidth: 0, marginRight: 2, children: _jsx(Text, { color: theme.textDim, wrap: "truncate-end", children: screen === "chat" ? (runState?.title || runState?.goal || cwdDisplay) : cwdDisplay }) }), screen === "chat" && (_jsxs(Box, { flexShrink: 0, gap: 1, children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: fullMode ? "magenta" : theme.accent, children: fullMode ? "full" : "quick" }), activeUsage && (_jsx(Text, { color: theme.textDim, children: `↑${fmtTokens(activeUsage.input)} ↓${fmtTokens(activeUsage.output)}` })), fullMode && (_jsxs(Text, { color: theme.textDim, children: [`src:${runState?.sourceCount ?? 0}`, (runState?.claimCount ?? 0) > 0 ? ` · claims:${runState?.claimCount}` : ""] })), fullMode && (_jsx(Text, { color: runState?.reportDirty ? theme.warning : theme.success, children: runState?.reportDirty ? "draft" : "ready" })), busy && _jsx(Text, { color: theme.accent, children: SPINNER_FRAMES[frame % SPINNER_FRAMES.length] }), _jsx(Text, { color: theme.textDim, children: "|" })] }))] }));
+    return (_jsxs(Box, { paddingTop: 1, justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, minWidth: 0, marginRight: 2, children: _jsx(Text, { color: theme.textDim, wrap: "truncate-end", children: screen === "chat" ? (runState?.title || runState?.goal || cwdDisplay) : cwdDisplay }) }), screen === "chat" && (_jsxs(Box, { flexShrink: 0, gap: 1, children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: fullMode ? "magenta" : theme.accent, children: fullMode ? "full" : "quick" }), planMode && _jsx(Text, { color: "cyan", children: "plan" }), activeUsage && (_jsx(Text, { color: theme.textDim, children: `↑${fmtTokens(activeUsage.input)} ↓${fmtTokens(activeUsage.output)}` })), fullMode && (_jsxs(Text, { color: theme.textDim, children: [`src:${runState?.sourceCount ?? 0}`, (runState?.claimCount ?? 0) > 0 ? ` · claims:${runState?.claimCount}` : ""] })), fullMode && (_jsx(Text, { color: runState?.reportDirty ? theme.warning : theme.success, children: runState?.reportDirty ? "draft" : "ready" })), busy && _jsx(Text, { color: theme.accent, children: SPINNER_FRAMES[frame % SPINNER_FRAMES.length] }), _jsx(Text, { color: theme.textDim, children: "|" })] }))] }));
 }
 export function InputBar({ inputLines, cursorLine, cursorCol, showCursor, approvalPending, busy, frame, boxWidth, modelName, config }) {
     const theme = useTheme();
@@ -17,12 +17,14 @@ export function InputBar({ inputLines, cursorLine, cursorCol, showCursor, approv
     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: borderColor, children: "╭" + "─".repeat(Math.max(0, boxWidth - 2)) + "╮" }), inputLines.map((line, i) => (_jsxs(Box, { width: boxWidth, children: [_jsx(Text, { color: borderColor, children: "│ " }), _jsx(Text, { color: i === 0 ? promptColor : borderColor, children: i === 0 ? "❯ " : "  " }), _jsx(Text, { color: inputColor, wrap: "truncate", children: showCursor && i === cursorLine ? (_jsxs(_Fragment, { children: [line.slice(0, cursorCol), _jsx(Text, { backgroundColor: theme.cursorBackground, color: theme.cursorForeground, children: line[cursorCol] ?? " " }), line.slice(cursorCol + 1)] })) : (line) }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: borderColor, children: " \u2502" })] }, i))), _jsxs(Box, { width: boxWidth, children: [_jsx(Text, { color: borderColor, children: "╰" + "─".repeat(dashCount) + " " }), _jsx(Text, { color: theme.accent, children: label }), _jsx(Text, { color: borderColor, children: " ─╯" })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: borderColor, children: "╭" + "─".repeat(Math.max(0, boxWidth - 2)) + "╮" }), inputLines.map((line, i) => (_jsxs(Box, { width: boxWidth, children: [_jsx(Text, { color: borderColor, children: "│ " }), _jsx(Text, { color: i === 0 ? promptColor : borderColor, children: i === 0 ? "❯ " : "  " }), _jsx(Box, { flexGrow: 1, minWidth: 0, children: showCursor && i === cursorLine ? (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: inputColor, children: line.slice(0, cursorCol) }), _jsx(Text, { backgroundColor: theme.cursorBackground, color: theme.cursorForeground, children: line[cursorCol] ?? " " }), _jsx(Text, { color: inputColor, children: line.slice(cursorCol + 1) })] })) : (_jsx(Text, { color: inputColor, wrap: "truncate", children: line })) }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: borderColor, children: " \u2502" })] }, i))), _jsxs(Box, { width: boxWidth, children: [_jsx(Text, { color: borderColor, children: "╰" + "─".repeat(dashCount) + " " }), _jsx(Text, { color: theme.accent, children: label }), _jsx(Text, { color: borderColor, children: " ─╯" })] })] }));
 }
-export function HintLine({ screen, busy, scrollLabel, hasDoneGroups, hasFocusedGroup, config }) {
+export function HintLine({ screen, busy, scrollLabel, hasDoneGroups, hasFocusedGroup, hasLinkHover, alwaysAllowLinks, config }) {
     const theme = useTheme();
     if (screen === "chat") {
-        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/HELP" }) }), _jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/REPORT" }) }), _jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/NEW" }) }), busy && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/STOP" }) })] })), hasDoneGroups && !busy ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: hasFocusedGroup
+        return (_jsxs(Box, { gap: 1, children: [_jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/HELP" }) }), _jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/REPORT" }) }), _jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/NEW" }) }), hasLinkHover && !busy ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: alwaysAllowLinks
+                                ? "click link to open"
+                                : _jsxs(_Fragment, { children: ["click link \u00B7 ", _jsx(Text, { bold: true, color: theme.accent, children: "a" }), " always \u00B7 ", _jsx(Text, { bold: true, color: theme.accent, children: "y" }), " open \u00B7 ", _jsx(Text, { bold: true, color: theme.accent, children: "n" }), " cancel"] }) })] })) : null, busy && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: _jsx(Text, { bold: true, color: theme.accent, children: "/STOP" }) })] })), hasDoneGroups && !busy ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textDim, children: "|" }), _jsx(Text, { color: theme.textDim, children: hasFocusedGroup
                                 ? _jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "C" }), " toggle \u00B7 ", _jsx(Text, { bold: true, color: theme.accent, children: "ESC" }), " unfocus"] })
                                 : _jsxs(_Fragment, { children: [_jsx(Text, { bold: true, color: theme.accent, children: "[ ]" }), " \u00B7 ", _jsx(Text, { bold: true, color: theme.accent, children: "C" }), " groups"] }) })] })) : null, scrollLabel ? (_jsxs(_Fragment, { children: [_jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: theme.textDim, children: scrollLabel })] })) : null] }));
     }
@@ -56,7 +58,7 @@ export function CommandMenuBox({ activeSuggestions, activeSuggestionKind, comman
             bits.push(`${s.claimCount} claims`);
         return bits.join(" · ");
     };
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.border, paddingX: 1, marginX: 1, children: [_jsxs(Text, { color: theme.textDim, children: [header, windowStart > 0 ? "  ↑" : "", windowStart + MENU_VISIBLE < total ? "  ↓" : ""] }), visible.map((item, i) => {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.border, paddingX: 1, children: [_jsxs(Text, { color: theme.textDim, 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;
@@ -73,11 +75,15 @@ export function HelpBox({ open, innerWidth, config }) {
     const theme = useTheme();
     if (!open)
         return null;
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.border, paddingX: 1, marginX: 1, children: [_jsxs(Text, { bold: true, color: theme.text, children: ["help ", _jsx(Text, { color: theme.textDim, children: "esc close" })] }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(10, innerWidth - 6)) }), _jsx(Text, { color: theme.textDim, children: "scroll  \u2191/\u2193  k/j  u/d  pgup/pgdn" }), _jsx(Text, { color: theme.textDim, children: "autocomplete  / commands \u00B7 @ files \u00B7 # sessions" }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(10, innerWidth - 6)) }), CHAT_COMMANDS.map((cmd) => (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: theme.accent, children: cmd }), _jsx(Text, { color: theme.textDim, children: COMMAND_DESCRIPTIONS[cmd] })] }, cmd)))] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.border, paddingX: 1, children: [_jsxs(Text, { bold: true, color: theme.text, children: ["help ", _jsx(Text, { color: theme.textDim, children: "esc close" })] }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(10, innerWidth - 6)) }), _jsx(Text, { color: theme.textDim, children: "scroll  \u2191/\u2193  k/j  u/d  pgup/pgdn" }), _jsx(Text, { color: theme.textDim, children: "autocomplete  / commands \u00B7 @ files \u00B7 # sessions" }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(10, innerWidth - 6)) }), CHAT_COMMANDS.map((cmd) => (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: theme.accent, children: cmd }), _jsx(Text, { color: theme.textDim, children: COMMAND_DESCRIPTIONS[cmd] })] }, cmd)))] }));
+}
+export function LinkOpenBox({ url, innerWidth, config }) {
+    const theme = useTheme();
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [_jsxs(Text, { bold: true, color: theme.accent, children: ["\u2197 Open in browser?", _jsx(Text, { color: theme.textDim, children: "  a always \u00B7 y open \u00B7 n cancel" })] }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(10, innerWidth - 6)) }), wrapText(url, Math.max(10, innerWidth - 4)).slice(0, 4).map((line, i) => (_jsx(Text, { color: theme.text, wrap: "truncate", children: line }, i)))] }));
 }
 export function ApprovalBox({ toolName, description, innerWidth, config }) {
     const theme = useTheme();
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.warning, paddingX: 1, marginX: 1, children: [_jsxs(Text, { bold: true, color: theme.warning, children: ["\u26A0  ", toolName, _jsx(Text, { color: theme.textDim, children: "  y approve \u00B7 n reject" })] }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(10, innerWidth - 6)) }), wrapText(description, Math.max(10, innerWidth - 4)).slice(0, 6).map((line, i) => {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.warning, paddingX: 1, children: [_jsxs(Text, { bold: true, color: theme.warning, children: ["\u26A0  ", toolName, _jsx(Text, { color: theme.textDim, children: "  y approve \u00B7 n reject" })] }), _jsx(Text, { color: theme.textDim, 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 ? theme.success : isRemoved ? theme.error : theme.textDim, wrap: "truncate", children: line }, i));
@@ -100,7 +106,7 @@ export function MenuDialog({ menu, cols, rows, config }) {
     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: theme.accent, paddingX: 1, children: [_jsxs(Text, { bold: true, color: theme.text, children: [menu.type === "model" ? "Select model" : menu.type === "llm" ? "Select LLM provider" : "Select search provider", "  ", _jsx(Text, { color: theme.textDim, children: "\u2191\u2193 navigate \u00B7 \u23CE apply \u00B7 esc close" })] }), !menu.loading && (_jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, children: "⌕ " }), _jsx(Text, { color: theme.text, children: menu.query }), !menu.query && _jsx(Text, { color: theme.textDim, children: "type to filter\u2026" })] }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(4, DIALOG_W - 4)) })] })), menu.loading ? (_jsx(Text, { color: theme.textDim, children: "  loading models\u2026" })) : menuFiltered.length === 0 ? (_jsxs(Text, { color: theme.textDim, children: ["  no matches for \"", menu.query, "\""] })) : (_jsxs(_Fragment, { children: [menuStart > 0 && _jsxs(Text, { color: theme.textDim, children: ["  \u2191 ", menuStart, " more"] }), menuFiltered.slice(menuStart, menuStart + DIALOG_ITEMS).map((item, i) => {
+    return (_jsxs(Box, { position: "absolute", marginLeft: dialogLeft, marginTop: dialogTop, width: DIALOG_W, flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [_jsxs(Text, { bold: true, color: theme.text, children: [menu.type === "model" ? "Select model" : menu.type === "llm" ? "Select LLM provider" : "Select search provider", "  ", _jsx(Text, { color: theme.textDim, children: "\u2191\u2193 navigate \u00B7 \u23CE apply \u00B7 esc close" })] }), !menu.loading && (_jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, children: "⌕ " }), _jsx(Text, { color: theme.inputText, children: menu.query }), !menu.query && _jsx(Text, { color: theme.textDim, children: "type to filter\u2026" })] }), _jsx(Text, { color: theme.textDim, children: "─".repeat(Math.max(4, DIALOG_W - 4)) })] })), menu.loading ? (_jsx(Text, { color: theme.textDim, children: "  loading models\u2026" })) : menuFiltered.length === 0 ? (_jsxs(Text, { color: theme.textDim, children: ["  no matches for \"", menu.query, "\""] })) : (_jsxs(_Fragment, { children: [menuStart > 0 && _jsxs(Text, { color: theme.textDim, 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 ? theme.accent : theme.textDim, bold: active, wrap: "truncate", children: [active ? "❯ " : "  ", displayName(item), menu.type === "llm" ? _jsx(Text, { color: theme.textDim, children: "  " + item }) : null] }, item));

package/dist/ui/ink/constants.js

@@ -3,13 +3,14 @@ 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", "/home", "/new", "/rerun", "/report", "/sources", "/claims", "/why", "/mcp", "/copy", "/usage", "/rename", "/model", "/llm", "/provider", "/theme", "/key", "/keys", "/stop", "/back", "/quit"];
+export const CHAT_COMMANDS = ["/help", "/home", "/new", "/plan", "/rerun", "/report", "/sources", "/claims", "/why", "/mcp", "/copy", "/usage", "/rename", "/model", "/llm", "/provider", "/theme", "/links", "/key", "/keys", "/stop", "/back", "/quit"];
 /** Slash commands that take an argument; ⏎ from the menu appends a space instead of running. */
-export const COMMANDS_NEEDING_ARGS = new Set(["/theme", "/key", "/rename", "/why"]);
+export const COMMANDS_NEEDING_ARGS = new Set(["/theme", "/key", "/rename", "/why", "/links"]);
 export const COMMAND_DESCRIPTIONS = {
     "/help": "Show command and keyboard shortcuts.",
     "/home": "Go to the home screen (or show the welcome card on home).",
     "/new": "Go to the home screen to start a new research run.",
+    "/plan": "Toggle plan mode (explore and plan before making changes).",
     "/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.",
@@ -23,14 +24,16 @@ export const COMMAND_DESCRIPTIONS = {
     "/llm": "Switch the LLM provider (gateway, xai, workers-ai).",
     "/provider": "Open the search provider selector.",
     "/theme": "Set UI theme: /theme dark · /theme light · /theme auto",
+    "/links": "Link opens: /links always · /links ask",
     "/key": "Save an API key, e.g. /key EXA_API_KEY ...",
-    "/keys": "Show which required API keys are set.",
+    "/keys": "Show API key status and where to get missing keys.",
     "/stop": "Abort the currently running agent turn.",
     "/back": "Return to the sessions list.",
     "/quit": "Quit the TUI."
 };
 export const TOOL_ICONS = {
     bash: "$",
+    runBash: "$",
     writeFile: "✎",
     editFile: "✎",
     readFile: "▤",
@@ -39,7 +42,13 @@ export const TOOL_ICONS = {
     webSearch: "⌕",
     readUrl: "↗",
     listSkills: "★",
-    readSkill: "★"
+    readSkill: "★",
+    todo: "☐",
+    readWorkspaceFile: "▤",
+    writeWorkspaceFile: "✎",
+    editWorkspaceFile: "✎",
+    listWorkspaceDir: "▤",
+    grepWorkspace: "⌕"
 };
 export const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 export const HOME_TIPS = [