@scira/cli 0.1.2 → 0.1.4

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

@@ -2,17 +2,21 @@ import { useCallback, useRef } from "react";
 import { writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { createResearchAgent, createOneShotAgent } from "../../../agent/research-agent.js";
+import { createBackgroundTaskManager } from "../../../tools/background-tasks.js";
+import { resolveProjectRoot } from "../../../tools/workspace.js";
 import { generateWithGateway } from "../../../providers/llm/gateway.js";
 import { setRunTitle, summarizeRun } from "../../../storage/run-store.js";
 import { fmtDuration, fmtTokens, aggregateTurns, wantsFullResearch, summarizeToolInput } from "../lib/utils.js";
 import { promptWithFileMentions } from "../lib/file-mentions.js";
 import { markdownJoinerTransform } from "../../../utils/markdown-joiner.js";
 import { createSession, getSession, removeSession, attachSubscriber, sessionPushFeed, sessionSetBusy, sessionSetApproval, sessionFinishReasoning, sessionNotifyEscalate, sessionNotifyModeChange, mergeFeedToolResults, getSessionFeedBuffer, } from "../session-manager.js";
-export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullModeRef, conversationRef, turnsRef, feedRef, setBusy, setScrollOffset, refreshRun, recordUsage, setMode, getSubscriber, }) {
-    const runTurn = useCallback(async (prompt) => {
-        const runPath = currentRunPath;
+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, runPathOverride) => {
+        const runPath = runPathOverride ?? currentRunPath;
         if (!runPath)
             return;
+        const workspacePath = resolveProjectRoot(runPath);
         const existing = getSession(runPath);
         if (existing?.busy)
             return;
@@ -111,13 +115,24 @@ export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullMode
             let messages = [...conversationRef.current, { role: "user", content: mentioned.prompt }];
             let finalText = "";
             if (!fullModeRef.current && wantsFullResearch(prompt)) {
+                setPlanMode(false);
                 setMode(true);
                 fullModeRef.current = true;
                 sessionNotifyModeChange(runPath, true);
                 sessionPushFeed(runPath, { kind: "status", text: "Detected a research request — switching to the full research harness." });
             }
+            let bgManager = bgManagersRef.current.get(runPath);
+            if (!bgManager) {
+                bgManager = createBackgroundTaskManager(runPath, workspacePath);
+                bgManagersRef.current.set(runPath, bgManager);
+            }
+            const agentOptions = {
+                workspacePath,
+                getPlanMode: () => planModeRef.current && !fullModeRef.current,
+                backgroundTasks: bgManager
+            };
             if (fullModeRef.current) {
-                const bundle = await createResearchAgent(runPath, summary.goal, config, onApprovalRequired);
+                const bundle = await createResearchAgent(runPath, summary.goal, config, onApprovalRequired, agentOptions);
                 try {
                     finalText = await consume(await bundle.agent.stream({ messages, abortSignal: controller.signal, experimental_transform: markdownJoinerTransform() }));
                 }
@@ -127,7 +142,7 @@ export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullMode
             }
             else {
                 const escalate = { requested: false };
-                const oneShot = await createOneShotAgent(runPath, summary.goal, config, onApprovalRequired, () => { escalate.requested = true; });
+                const oneShot = await createOneShotAgent(runPath, summary.goal, config, onApprovalRequired, () => { escalate.requested = true; }, agentOptions);
                 try {
                     finalText = await consume(await oneShot.agent.stream({ messages, abortSignal: controller.signal, experimental_transform: markdownJoinerTransform() }));
                 }
@@ -135,6 +150,7 @@ export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullMode
                     await oneShot.close();
                 }
                 if (escalate.requested && !controller.signal.aborted) {
+                    setPlanMode(false);
                     setMode(true);
                     fullModeRef.current = true;
                     sessionNotifyEscalate(runPath);
@@ -145,7 +161,10 @@ export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullMode
                         { role: "assistant", content: finalText },
                         { role: "user", content: "Approved. Now run the full research harness: discover skills, write plan.md, gather and read grounded sources, extract and verify claims, write sources.jsonl and a complete report.md, then give a short summary." }
                     ];
-                    const full = await createResearchAgent(runPath, summary.goal, config, onApprovalRequired);
+                    const full = await createResearchAgent(runPath, summary.goal, config, onApprovalRequired, {
+                        ...agentOptions,
+                        getPlanMode: () => false
+                    });
                     try {
                         finalText = await consume(await full.agent.stream({ messages, abortSignal: controller.signal, experimental_transform: markdownJoinerTransform() }));
                     }
@@ -196,7 +215,7 @@ export function useAgentTurn({ config, currentRunPath, queuedPromptRef, fullMode
                 void runTurnRef.current(queued);
             }
         }
-    }, [config, currentRunPath, refreshRun, recordUsage, setMode, getSubscriber]);
+    }, [config, currentRunPath, refreshRun, recordUsage, setMode, setPlanMode, getSubscriber, fullModeRef, planModeRef]);
     const runTurnRef = useRef(runTurn);
     runTurnRef.current = runTurn;
     return { runTurn, runTurnRef };

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;
@@ -92,6 +92,9 @@ export function useKeyboard(o) {
     useInput((char, key) => {
         if (char && (char.includes("[<") || /^\d+;\d+;\d+[Mm]$/u.test(char)))
             return;
+        // OSC background-color query responses leak as stdin when terminals reply to theme probes.
+        if (char && (/\]11;rgb:/u.test(char) || /^11;rgb:/u.test(char)))
+            return;
         if (approvalPending) {
             if (char === "y" || char === "Y" || key.return) {
                 const p = approvalPending;
@@ -105,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, 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);
@@ -14,6 +14,8 @@ export function useSession(o) {
             setRunState(await summarizeRun(currentRunPath));
     }, [currentRunPath]);
     const openRun = useCallback(async (runPath, initialQuestion) => {
+        if (runPath !== currentRunPath)
+            setPlanMode(false);
         setCurrentRunPath(runPath);
         setInputText("");
         setCursorPos(0);
@@ -34,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");
@@ -53,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) {
@@ -66,7 +68,7 @@ export function useSession(o) {
                 startedRef.current = runPath;
                 setScrollOffset(0);
                 setScreen("chat");
-                return;
+                return undefined;
             }
         }
         conversationRef.current = [];
@@ -84,20 +86,19 @@ 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.");
-        })();
-    }, [config, setCurrentRunPath, setInputText, setCursorPos, setFeed, setUsage, setScrollOffset,
-        setScreen, setRunState, setMode, setBusy, setApprovalPending, getSubscriber]);
+        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

@@ -2,11 +2,12 @@ import { useCallback, useRef, useState } from "react";
 import { saveGlobalConfig } from "../../../config/load-config.js";
 import { setEnvKey, isManagedEnvKey, MANAGED_ENV_KEYS } from "../../../config/env-store.js";
 import { detectEnv } from "../../../providers/llm/readiness.js";
+import { formatKeysStatus } from "../../../config/env-guide.js";
 import { listModels } from "../../../providers/llm/models.js";
 import { LLM_PROVIDERS, LLM_PROVIDER_LABELS, defaultModelFor } from "../../../providers/llm/registry.js";
 import { PROVIDERS } from "../constants.js";
 import { prettifyModelId } from "../lib/utils.js";
-import { detectTerminalTheme } from "../theme.js";
+import { detectTerminalTheme, resolveRenderingAppearance } from "../theme.js";
 import { useMountEffect } from "../components/effects.js";
 export function useSettings({ config, setConfig, screen, pushFeed, setNotice }) {
     const [menu, setMenu] = useState(null);
@@ -143,14 +144,17 @@ export function useSettings({ config, setConfig, screen, pushFeed, setNotice })
             if (!isManagedEnvKey(name))
                 return `Unknown key "${name}". Managed keys: ${MANAGED_ENV_KEYS.join(", ")}`;
             await setEnvKey(name, value);
-            return `${name} saved to ~/.scira/.env and active for this session.`;
+            return `${name} saved to ~/.scira/.env and active for this session. Use .scira/.env in a project to scope keys to that repo.`;
         }
         if (cmd === "/theme") {
             if (!arg) {
-                const resolved = config.theme === "auto" ? detectTerminalTheme() : config.theme;
+                const terminal = detectTerminalTheme();
+                const resolved = resolveRenderingAppearance(config.theme, terminal);
                 const mode = config.theme === "auto"
-                    ? "follows terminal picker"
-                    : "locked — run /theme auto to sync with picker";
+                    ? "follows terminal"
+                    : config.theme !== resolved
+                        ? `locked ${config.theme}, but terminal is ${terminal} — rendering ${resolved}`
+                        : `locked ${config.theme}`;
                 return `Current theme: ${config.theme} (rendering ${resolved})\n${mode}\nOptions: dark, light, auto`;
             }
             if (!["dark", "light", "auto"].includes(arg))
@@ -160,10 +164,28 @@ 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 detectEnv(config.search.provider, config.llmProvider)
-                .map((c) => `${c.present ? "set    " : "missing"} ${c.name}${c.required ? " (required)" : ""}`)
-                .join("\n");
+            return formatKeysStatus(detectEnv(config.search.provider, config.llmProvider));
         }
         return null;
     }, [config, resolveModelName, setConfig, applyLlmProvider]);

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

@@ -7,8 +7,8 @@ import { detachSubscriber, abortSession } from "../session-manager.js";
 import { saveGlobalMcpConfig } from "../../../config/load-config.js";
 export function useSubmit(o) {
     const { config, currentRunPath, sessions, selectedIdx, busy, usage, pendingRerun } = o.state;
-    const { queuedPromptRef, conversationRef, feedRef } = o.refs;
-    const { setApprovalPending, setInputText, setCursorPos, setInputHistory, setHistoryIndex, setHelpOpen, setNotice, setBusy, setScreen, setFeed, setRunState, setPendingRerun, setMode, setConfig, setMcpOpen, setHeroHidden, } = o.setters;
+    const { queuedPromptRef, fullModeRef, planModeRef, conversationRef, feedRef } = o.refs;
+    const { setApprovalPending, setInputText, setCursorPos, setInputHistory, setHistoryIndex, setHelpOpen, setNotice, setBusy, setScreen, setFeed, setRunState, setPendingRerun, setMode, setPlanMode, setConfig, setMcpOpen, setHeroHidden, } = o.setters;
     const { pushFeed, refreshSessions, openRun, openMenu, handleSettings, runTurn, exit } = o.actions;
     const rerunConfirmRef = useRef(false);
     const abortTurn = useCallback(() => {
@@ -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));
@@ -339,12 +339,23 @@ export function useSubmit(o) {
             })();
             return;
         }
+        if (text === "/plan") {
+            if (fullModeRef.current) {
+                pushFeed({ kind: "status", text: "Plan mode applies to coding/quick turns only. It is disabled during full research." });
+                return;
+            }
+            const next = !planModeRef.current;
+            setPlanMode(next);
+            pushFeed({ kind: "status", text: next ? "Plan mode on. Agent will explore and plan before making changes." : "Plan mode off. Agent can execute changes." });
+            return;
+        }
         if (text === "/rerun") {
             if (busy)
                 return;
             if (rerunConfirmRef.current) {
                 rerunConfirmRef.current = false;
                 conversationRef.current = [];
+                setPlanMode(false);
                 setMode(true); // explicit deep re-run uses the full harness
                 setFeed([{ kind: "status", text: "Re-running research…" }]);
                 void runTurn("Re-run the research from scratch. Plan, gather grounded sources, and rewrite report.md, then summarize.");

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

@@ -1 +1 @@
-export { ThemeProvider, useTheme } from "../theme-context.js";
+export { ThemeProvider, useTheme, useTerminalAppearance, useRenderingAppearance, } from "../theme-context.js";

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

@@ -2,13 +2,16 @@ 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",
     "readSkill",
     "bash",
     "runWorkspaceCommand",
+    "todo",
     "grepWorkspace",
+    "xSearch",
 ]);
 export function feedToolItemId(feedIndex, toolCallId) {
     return toolCallId ?? `feed-${feedIndex}`;
@@ -80,9 +83,15 @@ function searchHitToMarkdown(hit) {
 }
 function webSearchQueriesMarkdown(groups) {
     const queries = groups.map((g) => g.query?.trim()).filter((q) => Boolean(q));
-    if (queries.length === 0)
-        return "";
-    return `## Queries\n\n${queries.map((q, i) => `${i + 1}. ${q}`).join("\n")}`;
+    const errors = groups.map((g) => g.error?.trim()).filter((e) => Boolean(e));
+    const parts = [];
+    if (queries.length > 0) {
+        parts.push(`## Queries\n\n${queries.map((q, i) => `${i + 1}. ${q}`).join("\n")}`);
+    }
+    if (errors.length > 0) {
+        parts.push(`## Errors\n\n${errors.map((e, i) => `${i + 1}. ${e}`).join("\n")}`);
+    }
+    return parts.join("\n\n");
 }
 function webSearchSourcesMarkdown(hits) {
     if (hits.length === 0)
@@ -199,10 +208,57 @@ function formatGrep(result, width, theme) {
         return plainLines(row, width, { color: theme.textDim });
     });
 }
+function xPostToMarkdown(p) {
+    const label = p.handle ? `@${p.handle}` : p.url;
+    let line = `- [${label}](${p.url})`;
+    if (p.text) {
+        const snippet = p.text.replace(/\s+/gu, " ").trim();
+        if (snippet)
+            line += `\n  *${snippet}*`;
+    }
+    return line;
+}
+function xSearchPostsMarkdown(groups) {
+    const queries = groups.map((g) => g.query?.trim()).filter((q) => Boolean(q));
+    const errors = groups.map((g) => g.error?.trim()).filter((e) => Boolean(e));
+    const allPosts = groups.flatMap((g) => g.posts ?? []);
+    const dateRange = groups[0]?.dateRange;
+    const parts = [];
+    if (queries.length > 0) {
+        parts.push(`## Queries\n\n${queries.map((q, i) => `${i + 1}. ${q}`).join("\n")}`);
+    }
+    if (dateRange) {
+        parts.push(`*${dateRange}*`);
+    }
+    if (errors.length > 0) {
+        parts.push(`## Errors\n\n${errors.map((e, i) => `${i + 1}. ${e}`).join("\n")}`);
+    }
+    if (allPosts.length > 0) {
+        const postLines = allPosts.map(xPostToMarkdown).join("\n\n");
+        parts.push(`## Posts (${allPosts.length})\n\n${postLines}`);
+    }
+    return parts.join("\n\n");
+}
+function formatXSearch(result, width, theme) {
+    try {
+        const groups = JSON.parse(result);
+        if (!Array.isArray(groups))
+            return plainLines(result, width, { color: theme.textDim });
+        const md = xSearchPostsMarkdown(groups);
+        if (!md.trim())
+            return plainLines(result, width, { color: theme.textDim });
+        return markdownToSegLines(md, width, theme);
+    }
+    catch {
+        return plainLines(result, width, { color: theme.textDim });
+    }
+}
 function formatBody(name, result, width, theme) {
     switch (name) {
         case "webSearch":
             return formatWebSearch(result, width, theme);
+        case "xSearch":
+            return formatXSearch(result, width, theme);
         case "readUrl":
             return formatReadUrl(result, width, theme);
         case "listSkills":
@@ -262,6 +318,18 @@ export function formatToolResultPreview(name, inputSummary, result, status) {
         }
         catch { /* fall through */ }
     }
+    if (name === "xSearch") {
+        try {
+            const groups = JSON.parse(result);
+            if (Array.isArray(groups)) {
+                const queries = groups.map((g) => g.query?.trim()).filter(Boolean);
+                const total = groups.reduce((n, g) => n + (g.posts?.length ?? 0), 0);
+                const q = queries.length > 0 ? queries.slice(0, 2).join(" · ") + (queries.length > 2 ? ` +${queries.length - 2}` : "") : input;
+                return q ? `${q} · ${total} posts` : `${total} posts`;
+            }
+        }
+        catch { /* fall through */ }
+    }
     if (name === "readFile" || name === "readWorkspaceFile") {
         const lines = result.split("\n").length;
         return input ? `${input} · ${lines} lines` : `${lines} lines`;
@@ -280,12 +348,12 @@ export function formatToolResultLines(name, inputSummary, result, status, conten
     const width = Math.max(16, contentWidth);
     const lines = [];
     const input = inputSummary.replace(/\s+/gu, " ").trim();
-    const skipInput = name === "webSearch" && status === "done" && Boolean(result?.trim());
+    const skipInput = (name === "webSearch" || name === "xSearch") && status === "done" && Boolean(result?.trim());
     if (input && !skipInput) {
         if (name === "bash" || name === "runWorkspaceCommand") {
             lines.push([seg("$ ", { color: theme.accent }), seg(input, { color: theme.text })]);
         }
-        else if (name === "webSearch") {
+        else if (name === "webSearch" || name === "xSearch") {
             lines.push(...markdownToSegLines(webSearchRunningMarkdown(input), width, theme));
         }
         else if (name === "readUrl") {

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);
     });
 });