@scira/cli 0.1.3 → 0.1.4

package/README.md

@@ -1,5 +1,7 @@
 # Scira CLI
 
+![Scira CLI](./docs/public/cli-demo.png)
+
 Terminal-native AI research and coding agent. Ask a question, get a grounded report with cited sources and verified claims — all stored locally and inspectable.
 
 **Documentation:** [docs site](./docs) (local: `cd docs && bun run dev`) · MDX sources in `docs/content/docs/`

package/dist/cli/commands/init.js

@@ -261,6 +261,7 @@ export async function initCommand() {
             model: defaultModelFor(llmProvider),
             lastModels: {},
             approvalMode: "suggest",
+            alwaysAllowLinks: false,
             runDirectory: ".scira/runs",
             maxSources: 20,
             citationPolicy: "strict",
@@ -345,6 +346,7 @@ export async function initCommand() {
         model,
         lastModels: { [llmProvider]: model, ...(existingConfig?.lastModels || {}) },
         approvalMode: approvalMode,
+        alwaysAllowLinks: existingConfig?.alwaysAllowLinks ?? false,
         search: {
             provider: searchProvider,
             maxResults: existingConfig?.search?.maxResults || 8,

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";
@@ -69,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([]);
@@ -204,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, 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();
@@ -279,11 +308,10 @@ 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, planModeRef, conversationRef, turnsRef, feedRef,
-        setBusy, setScrollOffset, refreshRun, recordUsage, setMode, setPlanMode, 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, fullModeRef, planModeRef, conversationRef, feedRef },
@@ -300,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;
@@ -310,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();
@@ -328,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;
     }
@@ -346,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 },
@@ -356,9 +406,9 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
     const activeUsage = usage[config.model];
     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, 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: !!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, planMode: planMode, 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

@@ -19,10 +19,12 @@ export function InputBar({ inputLines, cursorLine, cursorCol, showCursor, approv
     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(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));

package/dist/ui/ink/constants.js

@@ -3,9 +3,9 @@ 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", "/plan", "/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).",
@@ -24,6 +24,7 @@ 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 API key status and where to get missing keys.",
     "/stop": "Abort the currently running agent turn.",

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

@@ -12,8 +12,8 @@ import { markdownJoinerTransform } from "../../../utils/markdown-joiner.js";
 import { createSession, getSession, removeSession, attachSubscriber, sessionPushFeed, sessionSetBusy, sessionSetApproval, sessionFinishReasoning, sessionNotifyEscalate, sessionNotifyModeChange, mergeFeedToolResults, getSessionFeedBuffer, } from "../session-manager.js";
 export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullModeRef, planModeRef, conversationRef, turnsRef, feedRef, setBusy, setScrollOffset, refreshRun, recordUsage, setMode, setPlanMode, getSubscriber, }) {
     const bgManagersRef = useRef(new Map());
-    const runTurn = useCallback(async (prompt) => {
-        const runPath = currentRunPath;
+    const runTurn = useCallback(async (prompt, runPathOverride) => {
+        const runPath = runPathOverride ?? currentRunPath;
         if (!runPath)
             return;
         const workspacePath = resolveProjectRoot(runPath);

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

@@ -1,8 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo } from "react";
+import React, { useMemo } from "react";
 import { Text } from "ink";
+import Link from "ink-link";
 import { S_BAR, TOOL_ICONS, SPINNER_FRAMES } from "../constants.js";
-import { formatTime, fmtDuration, wrapText, hyperlink, displayWidth } from "../lib/utils.js";
+import { formatTime, fmtDuration, wrapText, computeLineLinks, displayWidth } from "../lib/utils.js";
 import { formatToolResultLines, formatToolResultPreview, feedToolItemId, isCollapsibleToolName, isToolItemCollapsed, } from "../lib/tool-result.js";
 import { markdownToSegLines } from "../lib/markdown.js";
 import { useTheme } from "./use-theme.js";
@@ -41,6 +42,17 @@ export function computeGroups(feed) {
     return { groupOf, groups };
 }
 const isGH = (item) => item._tag === "gh";
+function renderSegNodes(segs, theme, defaultColor) {
+    return segs.map((s, i) => {
+        const inner = (_jsx(Text, { color: s.url ? (s.color ?? theme.accent) : (s.color ?? defaultColor), bold: s.bold, italic: s.italic, underline: s.url ? true : s.underline, dimColor: s.dim, children: s.text }));
+        // For URL segments, emit an OSC 8 terminal hyperlink so the terminal itself makes the
+        // text clickable (Cmd/Ctrl-click). fallback={false} keeps the visible text unchanged so
+        // the pre-computed line widths still hold on terminals without hyperlink support.
+        return s.url
+            ? _jsx(Link, { url: s.url, fallback: false, children: inner }, i)
+            : React.cloneElement(inner, { key: i });
+    });
+}
 export function useFeedLines(feed, innerWidth, 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey, itemExpandState, hoveredLineIdx, config) {
@@ -50,6 +62,7 @@ reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey, itemExpandState,
         const lines = [];
         const toggleAtLine = new Map();
         const groupToggleAtLine = new Map();
+        const linkAtLine = new Map();
         let key = 0;
         const { groupOf, groups } = computeGroups(feed);
         const eff = [];
@@ -161,7 +174,12 @@ reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey, itemExpandState,
                         lines.push(_jsx(Text, { color: theme.textDim, children: S_BAR }, key++));
                         continue;
                     }
-                    lines.push(_jsxs(Text, { wrap: "truncate-end", children: [_jsxs(Text, { color: theme.textDim, children: [S_BAR, " "] }), row.map((s, i) => (_jsx(Text, { color: s.color ?? theme.textDim, bold: s.bold, italic: s.italic, underline: s.underline, dimColor: s.dim, children: hyperlink(s.text, s.url) }, i)))] }, key++));
+                    const prefix = `${S_BAR} `;
+                    const lineIdx = lines.length;
+                    const links = computeLineLinks(row, displayWidth(prefix));
+                    if (links.length > 0)
+                        linkAtLine.set(lineIdx, links);
+                    lines.push(_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: theme.textDim, children: prefix }), renderSegNodes(row, theme, theme.textDim)] }, key++));
                 }
             }
             else if (fi.kind === "user") {
@@ -193,7 +211,12 @@ reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey, itemExpandState,
                         lines.push(_jsx(Text, { color: theme.textDim, children: S_BAR }, key++));
                         continue;
                     }
-                    lines.push(_jsxs(Text, { color: theme.textDim, italic: true, wrap: "truncate-end", children: [_jsx(Text, { color: theme.textDim, children: "│ " }), segLine.map((s, i) => (_jsx(Text, { color: theme.textDim, bold: s.bold, italic: s.italic ?? true, underline: s.underline, children: hyperlink(s.text, s.url) }, i)))] }, key++));
+                    const prefix = "│ ";
+                    const lineIdx = lines.length;
+                    const links = computeLineLinks(segLine, displayWidth(prefix));
+                    if (links.length > 0)
+                        linkAtLine.set(lineIdx, links);
+                    lines.push(_jsxs(Text, { color: theme.textDim, italic: true, wrap: "truncate-end", children: [_jsx(Text, { color: theme.textDim, children: prefix }), renderSegNodes(segLine, theme, theme.textDim)] }, key++));
                 }
             }
             else {
@@ -202,11 +225,15 @@ reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey, itemExpandState,
                         lines.push(_jsx(Text, { children: " " }, key++));
                         continue;
                     }
-                    lines.push(_jsx(Text, { wrap: "truncate-end", children: segLine.map((s, i) => (_jsx(Text, { color: s.color ?? theme.text, bold: s.bold, italic: s.italic, underline: s.underline, dimColor: s.dim, children: hyperlink(s.text, s.url) }, i))) }, key++));
+                    const lineIdx = lines.length;
+                    const links = computeLineLinks(segLine, 0);
+                    if (links.length > 0)
+                        linkAtLine.set(lineIdx, links);
+                    lines.push(_jsx(Text, { wrap: "truncate-end", children: renderSegNodes(segLine, theme, theme.text) }, key++));
                 }
             }
         });
-        return { lines, toggleAtLine, groupToggleAtLine };
+        return { lines, toggleAtLine, groupToggleAtLine, linkAtLine };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [feed, innerWidth, reasoningTick, spinnerFrame, collapsedGroups, focusedGroupKey, itemExpandState, hoveredLineIdx, config, theme]);
 }

package/dist/ui/ink/hooks/use-keyboard.js

@@ -11,7 +11,7 @@ function completeCommandWithArgSuffix(selected, inputText, acceptActiveSuggestio
 export function useKeyboard(o) {
     const { screen, setNotice, exit } = o;
     const { text: inputText, setText: setInputText, cursorPos, setCursorPos, history: inputHistory, historyIndex, setHistoryIndex } = o.input;
-    const { approvalPending, setApprovalPending, menu, setMenu, applyMenuSelection, helpOpen, setHelpOpen, mcpOpen, setMcpOpen, mcpRowIdx, setMcpRowIdx, mcpRowCount, toggleMcpRow, removeMcpRow, } = o.dialogs;
+    const { approvalPending, setApprovalPending, linkPending, setLinkPending, onConfirmLink, onAlwaysAllowLinks, menu, setMenu, applyMenuSelection, helpOpen, setHelpOpen, mcpOpen, setMcpOpen, mcpRowIdx, setMcpRowIdx, mcpRowCount, toggleMcpRow, removeMcpRow, } = o.dialogs;
     const { activeSuggestions, activeSuggestionKind, commandMenuIndex, setCommandMenuIndex, acceptActiveSuggestion } = o.suggestions;
     const { setScrollOffset, contentRows, maxScrollOffset, pendingRerun, setPendingRerun, busy, stopTurn, submitChat, toggleAllGroups, toggleFocusedGroup, focusPrevGroup, focusNextGroup, unfocusGroup, hasFocusedGroup } = o.chat;
     const { sessionsModalOpen, setSessionsModalOpen, sessionsModalIdx, setSessionsModalIdx, sessions, deleteSession, selectedIdx, setSelectedIdx, setHeroHidden, openRun, submitHome } = o.home;
@@ -108,6 +108,18 @@ export function useKeyboard(o) {
             }
             return;
         }
+        if (linkPending) {
+            if (char === "a" || char === "A") {
+                onAlwaysAllowLinks();
+            }
+            else if (char === "y" || char === "Y" || key.return) {
+                onConfirmLink();
+            }
+            else if (char === "n" || char === "N" || key.escape) {
+                setLinkPending(null);
+            }
+            return;
+        }
         if (menu) {
             if (key.escape) {
                 setMenu(null);

package/dist/ui/ink/hooks/use-session.js

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { listRuns, summarizeRun } from "../../../storage/run-store.js";
 import { getSession, attachSubscriber } from "../session-manager.js";
 export function useSession(o) {
-    const { config, currentRunPath, conversationRef, feedRef, turnsRef, startedRef, runTurnRef, setSessions, setRunState, setCurrentRunPath, setInputText, setCursorPos, setFeed, setUsage, setScrollOffset, setScreen, setMode, setPlanMode, setBusy, setApprovalPending, getSubscriber, } = o;
+    const { config, currentRunPath, conversationRef, feedRef, turnsRef, startedRef, setSessions, setRunState, setCurrentRunPath, setInputText, setCursorPos, setFeed, setUsage, setScrollOffset, setScreen, setMode, setPlanMode, setBusy, setApprovalPending, getSubscriber, } = o;
     const refreshSessions = useCallback(async () => {
         const runs = await listRuns(config);
         setSessions(runs);
@@ -36,7 +36,7 @@ export function useSession(o) {
                 setApprovalPending(live.approvalPending);
             const resumedState = await summarizeRun(runPath).catch(() => null);
             setRunState(resumedState);
-            return;
+            return undefined;
         }
         try {
             const raw = await readFile(join(runPath, "convo.json"), "utf8");
@@ -55,7 +55,7 @@ export function useSession(o) {
                 const resumedState = await summarizeRun(runPath).catch(() => null);
                 setRunState(resumedState);
                 setMode((resumedState?.claimCount ?? 0) > 0 || (resumedState?.sourceCount ?? 0) > 0);
-                return;
+                return undefined;
             }
         }
         catch (e) {
@@ -68,7 +68,7 @@ export function useSession(o) {
                 startedRef.current = runPath;
                 setScrollOffset(0);
                 setScreen("chat");
-                return;
+                return undefined;
             }
         }
         conversationRef.current = [];
@@ -86,19 +86,18 @@ export function useSession(o) {
                 return mcpCount > 0 ? [`${mcpCount} mcp`] : [];
             })(),
         ].join("  ·  ");
-        const freshFeed = initialQuestion
-            ? [{ kind: "user", text: initialQuestion, ts: Date.now() }, { kind: "status", text: startStatus }]
+        const summary = await summarizeRun(runPath).catch(() => null);
+        const prompt = initialQuestion ?? summary?.goal;
+        const freshFeed = prompt
+            ? [{ kind: "user", text: prompt, ts: Date.now() }, { kind: "status", text: startStatus }]
             : [{ kind: "status", text: startStatus }];
         setFeed(freshFeed);
         feedRef.current = freshFeed;
         setScrollOffset(0);
         setScreen("chat");
-        void (async () => {
-            await summarizeRun(runPath).then(setRunState).catch(() => { });
-            // Attach subscriber BEFORE starting the turn so no items are emitted without a listener.
-            attachSubscriber(runPath, getSubscriber());
-            await runTurnRef.current("Answer my question concisely using web search. If it genuinely needs deep, multi-source, verifiable research, call requestFullResearch to ask me to approve the full research harness.");
-        })();
+        if (summary)
+            setRunState(summary);
+        return prompt ? { startPrompt: prompt } : undefined;
     }, [config, currentRunPath, setCurrentRunPath, setInputText, setCursorPos, setFeed, setUsage, setScrollOffset,
         setScreen, setRunState, setMode, setPlanMode, setBusy, setApprovalPending, getSubscriber]);
     return { refreshSessions, refreshRun, openRun };

package/dist/ui/ink/hooks/use-settings.js

@@ -164,6 +164,26 @@ export function useSettings({ config, setConfig, screen, pushFeed, setNotice })
             await saveGlobalConfig(next);
             return `Theme set to ${arg}.`;
         }
+        if (cmd === "/links") {
+            if (!arg) {
+                return config.alwaysAllowLinks
+                    ? "Links open without confirmation. Use /links ask to require confirmation again."
+                    : "Links ask before opening. Use /links always to skip confirmation.";
+            }
+            if (arg === "always") {
+                const next = { ...config, alwaysAllowLinks: true };
+                setConfig(next);
+                await saveGlobalConfig(next);
+                return "Links will open on click without confirmation.";
+            }
+            if (arg === "ask") {
+                const next = { ...config, alwaysAllowLinks: false };
+                setConfig(next);
+                await saveGlobalConfig(next);
+                return "Links will ask for confirmation before opening.";
+            }
+            return `Unknown /links option "${arg}". Options: always, ask`;
+        }
         if (cmd === "/keys") {
             return formatKeysStatus(detectEnv(config.search.provider, config.llmProvider));
         }

package/dist/ui/ink/hooks/use-submit.js

@@ -77,7 +77,7 @@ export function useSubmit(o) {
             const run = await createRun(text, config);
             await refreshSessions();
             setBusy(false);
-            void openRun(run.path, text);
+            await openRun(run.path, text);
         }
         catch (error) {
             setNotice(error instanceof Error ? error.message : String(error));

package/dist/ui/ink/lib/tool-result.js

@@ -2,6 +2,7 @@ import { markdownToSegLines } from "./markdown.js";
 import { wrapText } from "./utils.js";
 /** Tools that start collapsed in the timeline (long output). */
 export const DEFAULT_COLLAPSED_TOOLS = new Set([
+    "webSearch",
     "readUrl",
     "readFile",
     "readWorkspaceFile",

package/dist/ui/ink/lib/tool-result.test.js

@@ -50,11 +50,11 @@ describe("formatToolResultLines", () => {
         expect(formatToolResultLines("readUrl", "https://example.com", result, "done", 80, DARK_THEME, false)).toEqual([]);
         expect(formatToolResultPreview("readUrl", "https://example.com", result, "done")).toContain("Example");
     });
-    it("defaults readUrl collapsed and webSearch expanded", () => {
+    it("defaults readUrl and webSearch collapsed", () => {
         expect(defaultCollapsedToolName("readUrl")).toBe(true);
-        expect(defaultCollapsedToolName("webSearch")).toBe(false);
+        expect(defaultCollapsedToolName("webSearch")).toBe(true);
         expect(isToolItemCollapsed("id", "readUrl", "done", new Map())).toBe(true);
-        expect(isToolItemCollapsed("id", "webSearch", "done", new Map())).toBe(false);
+        expect(isToolItemCollapsed("id", "webSearch", "done", new Map())).toBe(true);
         expect(isToolItemCollapsed("id", "readUrl", "done", new Map([["id", true]]))).toBe(false);
     });
 });

package/dist/ui/ink/lib/utils.js

@@ -142,11 +142,73 @@ export function relativeTime(ms) {
         return `${weeks}w ago`;
     return new Date(ms).toLocaleDateString();
 }
-/** Wrap text in an OSC 8 terminal hyperlink (clickable in supported terminals). */
+function colorToAnsi(color) {
+    if (!color)
+        return [];
+    const hex = /^#([0-9a-f]{6})$/i.exec(color);
+    if (hex) {
+        const n = hex[1];
+        return [38, 2, parseInt(n.slice(0, 2), 16), parseInt(n.slice(2, 4), 16), parseInt(n.slice(4, 6), 16)];
+    }
+    const ansi256 = /^ansi256\((\d+)\)$/i.exec(color);
+    if (ansi256)
+        return [38, 5, parseInt(ansi256[1], 10)];
+    const named = {
+        red: 31, green: 32, yellow: 33, blue: 34, magenta: 35, cyan: 36,
+        gray: 90, white: 97, black: 30,
+    };
+    const code = named[color.toLowerCase()];
+    return code ? [code] : [];
+}
+/** OSC 8 link with inline ANSI styling — avoids Ink Text props breaking the escape sequence. */
+export function ansiHyperlink(text, url, style) {
+    const params = [];
+    if (style?.bold)
+        params.push(1);
+    if (style?.dim)
+        params.push(2);
+    if (style?.italic)
+        params.push(3);
+    if (style?.underline !== false)
+        params.push(4);
+    params.push(...colorToAnsi(style?.color));
+    const styled = params.length > 0 ? `\x1b[${params.join(";")}m${text}\x1b[0m` : text;
+    return `\x1b]8;;${url}\x1b\\${styled}\x1b]8;;\x1b\\`;
+}
 export function hyperlink(text, url) {
     if (!url)
         return text;
-    return `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
+    return ansiHyperlink(text, url, { underline: true });
+}
+export function computeLineLinks(segs, prefixCols = 0) {
+    const links = [];
+    let col = prefixCols;
+    for (const s of segs) {
+        const w = displayWidth(s.text);
+        if (s.url && w > 0)
+            links.push({ start: col, end: col + w - 1, url: s.url });
+        col += w;
+    }
+    return links;
+}
+/** Match an SGR mouse column (1-based) against link regions from computeLineLinks. */
+export function linkAtMouseColumn(links, x) {
+    for (const l of links) {
+        if (x >= l.start + 1 && x <= l.end + 1)
+            return l.url;
+    }
+    return undefined;
+}
+/** Open a URL in the system browser. */
+export function openExternalUrl(url) {
+    return new Promise((res) => {
+        const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+        const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+        child.on("error", () => res(false));
+        child.on("close", (code) => res(code === 0));
+        child.unref();
+    });
 }
 /** True if the prompt clearly asks for full, report-grade research. */
 export function wantsFullResearch(prompt) {

package/dist/ui/ink/lib/utils.test.js

@@ -1,5 +1,22 @@
 import { describe, expect, it } from "vitest";
-import { summarizeToolInput, summarizeToolOutput } from "./utils.js";
+import { summarizeToolInput, summarizeToolOutput, ansiHyperlink, computeLineLinks, linkAtMouseColumn } from "./utils.js";
+describe("hyperlink helpers", () => {
+    it("wraps OSC 8 around styled link text", () => {
+        const out = ansiHyperlink("docs", "https://example.com", { color: "#FFE0C2", underline: true });
+        expect(out).toContain("\x1b]8;;https://example.com\x1b\\");
+        expect(out).toContain("docs");
+        expect(out).toContain("\x1b]8;;\x1b\\");
+    });
+    it("maps mouse column to link url", () => {
+        const links = computeLineLinks([
+            { text: "see " },
+            { text: "docs", url: "https://example.com" },
+        ], 2);
+        expect(links).toEqual([{ start: 6, end: 9, url: "https://example.com" }]);
+        expect(linkAtMouseColumn(links, 7)).toBe("https://example.com");
+        expect(linkAtMouseColumn(links, 3)).toBeUndefined();
+    });
+});
 describe("summarizeToolInput", () => {
     it("formats webSearch queries", () => {
         expect(summarizeToolInput("webSearch", { queries: ["a", "b", "c"] })).toBe("a · b +1");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scira/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Scira — terminal-native AI research agent with grounded sources, verified claims, and local run storage.",
   "license": "MIT",
   "type": "module",
@@ -51,6 +51,7 @@
     "exa-js": "^2.13.0",
     "files-sdk": "^1.8.0",
     "ink": "^7.0.5",
+    "ink-link": "^5.0.0",
     "jsdom": "^29.1.1",
     "parallel-web": "^1.1.0",
     "picospinner": "^3.0.0",