@scira/cli 0.1.1 → 0.1.3

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/ui/ink/SciraApp.js

@@ -52,6 +52,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) => {
@@ -203,7 +206,7 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
     const { refreshSessions, refreshRun, openRun: openRunBase } = useSession({
         config, currentRunPath, conversationRef, feedRef, turnsRef, startedRef, runTurnRef,
         setSessions, setRunState, setCurrentRunPath, setInputText, setCursorPos,
-        setFeed, setUsage, setScrollOffset, setScreen, setMode,
+        setFeed, setUsage, setScrollOffset, setScreen, setMode, setPlanMode,
         setBusy, setApprovalPending, getSubscriber,
     });
     const openRun = useCallback(async (runPath, initialQuestion) => {
@@ -277,16 +280,16 @@ export function SciraApp({ runPath: initialRunPath, config: initialConfig }) {
         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,
+        config, currentRunPath, queuedPromptRef, fullModeRef, planModeRef, conversationRef, turnsRef, feedRef,
+        setBusy, setScrollOffset, refreshRun, recordUsage, setMode, setPlanMode, getSubscriber,
     });
     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 },
@@ -351,11 +354,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: !!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: [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", 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 })] }));
 }
 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,7 +17,7 @@ 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 }) {
     const theme = useTheme();
@@ -100,7 +100,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", "/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 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.",
@@ -24,13 +25,14 @@ export const COMMAND_DESCRIPTIONS = {
     "/provider": "Open the search provider selector.",
     "/theme": "Set UI theme: /theme dark · /theme light · /theme auto",
     "/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 +41,13 @@ export const TOOL_ICONS = {
     webSearch: "⌕",
     readUrl: "↗",
     listSkills: "★",
-    readSkill: "★"
+    readSkill: "★",
+    todo: "☐",
+    readWorkspaceFile: "▤",
+    writeWorkspaceFile: "✎",
+    editWorkspaceFile: "✎",
+    listWorkspaceDir: "▤",
+    grepWorkspace: "⌕"
 };
 export const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 export const HOME_TIPS = [

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, }) {
+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;
         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-keyboard.js

@@ -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;

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, runTurnRef, 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);
@@ -97,7 +99,7 @@ export function useSession(o) {
             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]);
+    }, [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))
@@ -161,9 +165,7 @@ export function useSettings({ config, setConfig, screen, pushFeed, setNotice })
             return `Theme set to ${arg}.`;
         }
         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(() => {
@@ -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";