@bubblebrain-ai/bubble 0.0.37 → 0.0.38

package/dist/tui-ink/app.js

@@ -46,6 +46,9 @@ import { shouldContinueGoal, stopReasonNotice } from "../goal/engine.js";
 import { goalCompleteNotice, goalIndicatorLine, goalSummaryText } from "../goal/format.js";
 import { tokenUsageTotal } from "../goal/usage.js";
 import { formatInternalContextBlock } from "../agent/internal-reminder-sanitizer.js";
+import { MAX_ACTIVE_LOOPS, decideLoopFiring, formatInterval, formatLoopList, parseLoopCommand, } from "../loop/engine.js";
+import { TaskWakeCoalescer, findDanglingTaskStarts, formatTaskWakeSummary, isPidAlive, shouldFireTaskWake, taskEligibleForWake, } from "../tasks/wake.js";
+const TASK_WAKE_DEBOUNCE_MS = 2000;
 import { collectUsageStatsBundle, formatStatsPanelBody, rangeLabel } from "../stats/usage.js";
 import { GrokRuntimeError } from "../external-runtime/grok-errors.js";
 import { GROK_LOCAL_SLASH_COMMANDS, classifyGrokInput, isGrokLocalSlashCommand, } from "../external-runtime/grok-input-policy.js";
@@ -76,6 +79,32 @@ function buildTips(agent, registry, grokActive = false) {
     tips.push("Type / for commands and skills");
     return tips;
 }
+/**
+ * Slash-command results arrive as plain strings; recognize the /model
+ * confirmations by shape so they render as accent-colored UI notices — the
+ * same treatment the picker path applies — instead of assistant prose.
+ */
+function slashResultNoticeKind(result) {
+    return /^(Grok m|M)odel switched to /.test(result) ? "ui_notice" : undefined;
+}
+/**
+ * True when a user message is nothing but harness-injected internal blocks
+ * (goal kicks, task wakes) — hidden live, so hidden on reconstruction too.
+ */
+export function isInternalBlockOnlyContent(content) {
+    if (typeof content !== "string")
+        return false;
+    const trimmed = content.trim();
+    return /^<bubble_internal_(?:context|reminder)\b/.test(trimmed)
+        && /<\/bubble_internal_(?:context|reminder)>$/.test(trimmed);
+}
+/** Status-row summary for running background tasks (design §2.5). */
+function taskRowSummary(tasks, nowTick) {
+    const first = tasks[0];
+    const label = first.description?.trim() || first.command.replace(/\s+/g, " ").slice(0, 32);
+    const elapsed = Math.max(0, Math.round((nowTick - first.startedAt) / 1000));
+    return `${label} ${elapsed}s`;
+}
 function friendlyCwd(cwd) {
     const home = os.homedir();
     if (cwd === home)
@@ -95,7 +124,7 @@ function truncate(value, max) {
         return value;
     return `${value.slice(0, Math.max(0, max - 1))}…`;
 }
-function reconstructDisplayMessages(agentMessages) {
+export function reconstructDisplayMessages(agentMessages) {
     const result = [];
     for (const m of agentMessages) {
         if (m.role === "system" || m.role === "tool")
@@ -103,6 +132,12 @@ function reconstructDisplayMessages(agentMessages) {
         if (m.role === "user") {
             if (m.isMeta)
                 continue; // <system-reminder> injections are not user-visible
+            // Harness-initiated kicks (goal continuations, task wakes) persist as
+            // user-role messages wrapped in internal blocks so the model keeps
+            // them across resume — but they were hidden live and must stay hidden
+            // when the transcript is rebuilt.
+            if (isInternalBlockOnlyContent(m.content))
+                continue;
             result.push({
                 key: nextDisplayMessageKey("user"),
                 role: "user",
@@ -222,8 +257,12 @@ export const INK_LOCAL_SLASH_COMMANDS = [
         name: "goal",
         description: "Set/manage an autonomous goal (/goal <objective>|clear|pause|resume|edit)",
     },
+    {
+        name: "loop",
+        description: "Run a prompt on a recurring interval (/loop 5m <prompt>|list|stop [id])",
+    },
 ];
-export function App({ agent, args, sessionManager: initialSessionManager, switchSession, createProvider, registry, skillRegistry, planHandlerRef, approvalHandlerRef, questionController, bashAllowlist, settingsManager, lspService, mcpManager, themeMode: initialThemeMode, themeOverrides, detectedTheme, onThemeModeChange, flushMemory, runMemoryCompaction, runMemorySummary, runMemoryRefresh, goalStore, bypassEnabled, updateNotice, updateNoticeRefresh, hookController, externalRuntime, onExit }) {
+export function App({ agent, args, sessionManager: initialSessionManager, switchSession, createProvider, registry, skillRegistry, planHandlerRef, approvalHandlerRef, questionController, bashAllowlist, settingsManager, lspService, mcpManager, themeMode: initialThemeMode, themeOverrides, detectedTheme, onThemeModeChange, flushMemory, runMemoryCompaction, runMemorySummary, runMemoryRefresh, goalStore, processManager, tasksAutoResume, promotionChannel, bypassEnabled, updateNotice, updateNoticeRefresh, hookController, externalRuntime, onExit }) {
     const [sessionManager, setSessionManager] = useState(initialSessionManager);
     const [externalRuntimeBinding, setExternalRuntimeBinding] = useState(() => initialSessionManager?.getMetadata().externalRuntime);
     const sessionManagerRef = useRef(sessionManager);
@@ -369,17 +408,23 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
     // 1Hz tick keeps the composer activity indicator animated while the agent is
     // running without churning renders at idle.
     const [nowTick, setNowTick] = useState(() => Date.now());
+    // Live background-task snapshot for the status row (design §2.5); refreshed
+    // by the manager subscription effect below.
+    const [taskSnapshot, setTaskSnapshot] = useState([]);
+    const runningTasks = useMemo(() => taskSnapshot.filter((task) => task.status === "running"), [taskSnapshot]);
     // Timestamp of when the current agent run started. Used only for the final
     // per-task duration summary.
     const runStartRef = useRef(null);
     // Mark the moment the run started; flips back to null in the finally block.
+    // Also ticks while background tasks run at idle so their elapsed counter
+    // keeps moving (design §2.5).
     useEffect(() => {
-        if (!isRunning)
+        if (!isRunning && runningTasks.length === 0)
             return;
         setNowTick(Date.now());
         const t = setInterval(() => setNowTick(Date.now()), 1000);
         return () => clearInterval(t);
-    }, [isRunning]);
+    }, [isRunning, runningTasks.length]);
     const userConfig = new UserConfig();
     const safeRegistry = registry ?? new ProviderRegistry(userConfig);
     const safeSkillRegistry = skillRegistry ?? new SkillRegistry({
@@ -592,6 +637,22 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
             setPickerMode("slash");
             return;
         }
+        // Ctrl+G: promote the running foreground bash command to a background
+        // task (design §2.5). A no-op when nothing promotable is running.
+        if (isCtrlLetterInput(input, key, "g") && !pickerMode && promotionChannel) {
+            const liveTools = [
+                ...streamingTools,
+                ...streamingParts.flatMap((part) => (part.type === "tools" ? part.toolCalls : [])),
+            ];
+            const candidate = [...liveTools].reverse().find((tool) => tool.name === "bash" && !tool.result && promotionChannel.hasPromotable(tool.id));
+            if (candidate) {
+                const taskId = promotionChannel.requestPromotion(candidate.id);
+                if (taskId) {
+                    addMessage("assistant", `Moved to background: ${taskId} — the command keeps running (Ctrl+G).`, "ui_notice");
+                }
+            }
+            return;
+        }
         if (key.ctrl && key.shift && input.toLowerCase() === "m" && !pickerMode) {
             if (externalSessionBound) {
                 addMessage("assistant", "MCP is unavailable in external runtime sessions (no Bubble workspace access).");
@@ -696,8 +757,8 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
         reprintTranscript();
         updateDisplayMessages(updater);
     }, [reprintTranscript, updateDisplayMessages]);
-    const addMessage = useCallback((role, content) => {
-        updateDisplayMessages((prev) => [...prev, withMessageKey({ role, content })]);
+    const addMessage = useCallback((role, content, syntheticKind) => {
+        updateDisplayMessages((prev) => [...prev, withMessageKey(syntheticKind ? { role, content, syntheticKind } : { role, content })]);
     }, [updateDisplayMessages]);
     // Reflow on terminal resize. ink 7.0.3 only clears its dynamic frame when the
     // terminal NARROWS (see its resized() handler); on widen / tmux split the
@@ -826,7 +887,7 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
                 manager.appendMarker("thinking_level_switch", selection.reasoningEffort);
                 refreshExternalRuntimeBinding(manager);
             }
-            addMessage("assistant", `Grok model switched to ${selection.modelId ?? parsed.modelId}${selection.reasoningEffort !== "off" ? ` (${selection.reasoningEffort})` : ""}.`);
+            addMessage("assistant", `Grok model switched to ${selection.modelId ?? parsed.modelId}${selection.reasoningEffort !== "off" ? ` (${selection.reasoningEffort})` : ""}.`, "ui_notice");
             closePicker();
         };
         void run().catch((error) => {
@@ -895,6 +956,8 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
         clearComposerDraft();
         sessionManagerRef.current = result.manager;
         setSessionManager(result.manager);
+        // Keep ownerSessionId on newly spawned tasks/servers accurate (§2.2c).
+        agent.setSessionID(result.manager.getSessionFile());
         const nextExternalBinding = result.manager.getMetadata().externalRuntime;
         externalRuntimeBindingRef.current = nextExternalBinding;
         setExternalRuntimeBinding(nextExternalBinding);
@@ -1019,7 +1082,7 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
             const effortNote = nextThinkingLevel && nextThinkingLevel !== "off"
                 ? (isThinkingToggle || isThinkingOnly ? " in thinking mode" : ` with ${nextThinkingLevel} effort`)
                 : "";
-            addMessage("assistant", `Model switched to ${displayModel(model)}${effortNote}.`);
+            addMessage("assistant", `Model switched to ${displayModel(model)}${effortNote}.`, "ui_notice");
             closePicker();
             return nextThinkingLevel;
         };
@@ -1079,7 +1142,7 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
             onExternalRuntimeChange: refreshExternalRuntimeBinding,
         });
         if (handled && result)
-            addMessage("assistant", result);
+            addMessage("assistant", result, slashResultNoticeKind(result));
     }, [
         addMessage,
         agent,
@@ -1224,6 +1287,9 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
             closePicker();
         });
     }, [addMessage, agent, closePicker, createProvider, keyProviderId, safeRegistry, transitionToNative]);
+    // /loop handler lives below handleSubmit (it needs addMessage only); the
+    // ref breaks the declaration cycle so handleSubmit can route to it.
+    const handleLoopCommandRef = useRef(null);
     const handleSubmit = useCallback(async (payload) => {
         const initialPayload = typeof payload === "string" ? { text: payload, images: [] } : payload;
         const input = initialPayload.text;
@@ -1904,6 +1970,13 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
                     }
                 }
             };
+            // Background-task wake (design §2.3b): an internal continuation, not a
+            // user message — hidden from the transcript (the ✦ notice row is the
+            // user-facing record) and wrapped as internal context for the model.
+            if (initialPayload.internal === "task_wake") {
+                await runAgentInput(input, "", [], { hidden: true });
+                return;
+            }
             // Slash commands and skill invocations drop any attached images —
             // they're meant for pure command routing.
             if (input.trimStart().startsWith("/")) {
@@ -1922,6 +1995,10 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
                         await handleGoalCommand(input);
                         return;
                     }
+                    if (/^\/loop(?:\s|$)/.test(input.trim())) {
+                        handleLoopCommandRef.current?.(input);
+                        return;
+                    }
                     const skillInvocation = parseSkillInvocation(input, safeSkillRegistry);
                     if (skillInvocation) {
                         await runAgentInput(skillInvocation.actualPrompt, displayInput);
@@ -1995,7 +2072,7 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
                             ]);
                         }
                         else {
-                            addMessage("assistant", result);
+                            addMessage("assistant", result, slashResultNoticeKind(result));
                         }
                     }
                     if (inject) {
@@ -2037,6 +2114,199 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
             }
         }
     }, [addMessage, agent, args.cwd, openPicker, openSessionPicker, openRewindPicker, openStatsPanel, createProvider, currentSessionFile, externalRuntime, externalRuntimeBinding, externalSessionBound, fillComposer, grokSessionBound, prepareSubmitDisplay, refreshExternalRuntimeBinding, safeRegistry, safeSkillRegistry, startFreshSession, transitionToNative, unsupportedExternalSessionBound, updateDisplayMessages, queueInput, submitSteer, requestExit, setStartingSubmit]);
+    // --- Background tasks: markers, notices, auto-resume (design §2.3b) ---
+    // Owner SessionManager captured at spawn so markers always land in the
+    // owner session's jsonl, regardless of what is bound when the task ends.
+    const taskOwnerSessionsRef = useRef(new Map());
+    // Completions for non-current sessions, held until switch-back (§2.2c).
+    const pendingTaskCompletionsRef = useRef(new Map());
+    const taskWakeCoalescerRef = useRef(null);
+    const announceTaskCompletion = useCallback((task) => {
+        const elapsed = Math.round(((task.endedAt ?? Date.now()) - task.startedAt) / 1000);
+        addMessage("assistant", `Background task ${task.id}${task.description ? ` (${task.description})` : ""} ${task.status}${task.exitCode != null ? ` — exit ${task.exitCode}` : ""} in ${elapsed}s.`, "ui_notice");
+    }, [addMessage]);
+    const fireTaskWake = useCallback((tasks) => {
+        if (!processManager)
+            return;
+        // Gate at FIRE time (after the debounce): a turn that started meanwhile
+        // or queued user input suppresses the wake — the state-change reminder
+        // carries the completion into the next turn instead.
+        if (!shouldFireTaskWake({
+            autoResume: tasksAutoResume !== false,
+            turnRunning: !!activeAbortRef.current,
+            queuedInputs: queuedInputsRef.current.length,
+            exiting: exitRequestedRef.current,
+        })) {
+            return;
+        }
+        const summary = formatTaskWakeSummary(tasks, (id) => processManager.taskOutputTail(id, 2000));
+        for (const task of tasks)
+            processManager.markTaskDelivered(task.id);
+        void handleSubmit({
+            text: formatInternalContextBlock("task-finished", summary),
+            images: [],
+            internal: "task_wake",
+        });
+    }, [handleSubmit, processManager, tasksAutoResume]);
+    const refreshTaskSnapshot = useCallback(() => {
+        if (!processManager)
+            return;
+        setTaskSnapshot(processManager.listTasks(sessionManagerRef.current?.getSessionFile()));
+    }, [processManager]);
+    useEffect(() => {
+        refreshTaskSnapshot();
+    }, [refreshTaskSnapshot, sessionManager]);
+    useEffect(() => {
+        if (!processManager)
+            return;
+        taskWakeCoalescerRef.current = new TaskWakeCoalescer(TASK_WAKE_DEBOUNCE_MS, fireTaskWake);
+        const unsubSnapshot = processManager.onChange(() => refreshTaskSnapshot());
+        const unsubChange = processManager.onChange((task) => {
+            if (task.status !== "running" || taskOwnerSessionsRef.current.has(task.id))
+                return;
+            const owner = sessionManagerRef.current;
+            if (!owner || task.ownerSessionId !== owner.getSessionFile())
+                return;
+            taskOwnerSessionsRef.current.set(task.id, owner);
+            owner.appendMarker("task_started", JSON.stringify({
+                id: task.id,
+                pid: task.pid,
+                startedAt: task.startedAt,
+                command: task.command,
+                description: task.description,
+            }));
+        });
+        const unsubFinish = processManager.onTaskFinished((task) => {
+            taskOwnerSessionsRef.current.get(task.id)?.appendMarker(task.status === "killed" ? "task_killed" : "task_finished", JSON.stringify({ id: task.id, status: task.status, exitCode: task.exitCode ?? null, endedAt: task.endedAt }));
+            const currentFile = sessionManagerRef.current?.getSessionFile();
+            if (task.ownerSessionId !== currentFile) {
+                if (taskEligibleForWake(task) && task.ownerSessionId) {
+                    const held = pendingTaskCompletionsRef.current.get(task.ownerSessionId) ?? [];
+                    held.push(task);
+                    pendingTaskCompletionsRef.current.set(task.ownerSessionId, held);
+                }
+                return;
+            }
+            announceTaskCompletion(task);
+            if (taskEligibleForWake(task))
+                taskWakeCoalescerRef.current?.add(task);
+        });
+        return () => {
+            unsubSnapshot();
+            unsubChange();
+            unsubFinish();
+            taskWakeCoalescerRef.current?.cancel();
+            taskWakeCoalescerRef.current = null;
+        };
+    }, [announceTaskCompletion, fireTaskWake, processManager, refreshTaskSnapshot]);
+    // Switch-back sweep: completions held for this session fire now (§2.2c).
+    useEffect(() => {
+        if (!processManager)
+            return;
+        const file = sessionManager?.getSessionFile();
+        if (!file)
+            return;
+        const held = pendingTaskCompletionsRef.current.get(file);
+        if (!held?.length)
+            return;
+        pendingTaskCompletionsRef.current.delete(file);
+        for (const task of held) {
+            announceTaskCompletion(task);
+            taskWakeCoalescerRef.current?.add(task);
+        }
+    }, [announceTaskCompletion, processManager, sessionManager]);
+    // Resume-time orphan report: dangling task_started markers from a previous
+    // process, probed for liveness (§2.2c). Runs once per mount.
+    const orphanProbeDoneRef = useRef(false);
+    useEffect(() => {
+        if (!processManager || orphanProbeDoneRef.current)
+            return;
+        orphanProbeDoneRef.current = true;
+        const manager = sessionManagerRef.current;
+        if (!manager)
+            return;
+        let entries;
+        try {
+            entries = manager.getEntries();
+        }
+        catch {
+            return;
+        }
+        for (const orphan of findDanglingTaskStarts(entries)) {
+            const alive = isPidAlive(orphan.pid);
+            addMessage("assistant", alive
+                ? `Background task ${orphan.id}${orphan.description ? ` (${orphan.description})` : ""} from a previous process is still running (pid ${orphan.pid}). Kill it manually if unwanted: kill ${orphan.pid}`
+                : `Background task ${orphan.id}${orphan.description ? ` (${orphan.description})` : ""} was orphaned by a previous process and is no longer running.`, "ui_notice");
+        }
+    }, [addMessage, processManager]);
+    // --- /loop: recurring prompts (design §2.6) ---
+    const loopsRef = useRef([]);
+    const nextLoopIdRef = useRef(1);
+    const handleSubmitRef = useRef(handleSubmit);
+    handleSubmitRef.current = handleSubmit;
+    const handleLoopCommand = useCallback((raw) => {
+        const parsed = parseLoopCommand(raw);
+        if (parsed.action === "help" || parsed.error) {
+            addMessage("assistant", parsed.error ?? "Usage: /loop <interval> <prompt> (e.g. /loop 5m check CI status). Also: /loop list, /loop stop [id].");
+            return;
+        }
+        if (parsed.action === "list") {
+            addMessage("assistant", formatLoopList(loopsRef.current, Date.now()));
+            return;
+        }
+        if (parsed.action === "stop") {
+            if (parsed.stopId === undefined) {
+                const count = loopsRef.current.length;
+                loopsRef.current = [];
+                addMessage("assistant", count > 0 ? `Stopped ${count} loop${count === 1 ? "" : "s"}.` : "No active loops.");
+                return;
+            }
+            const before = loopsRef.current.length;
+            loopsRef.current = loopsRef.current.filter((loop) => loop.id !== parsed.stopId);
+            addMessage("assistant", loopsRef.current.length < before ? `Stopped loop #${parsed.stopId}.` : `No loop #${parsed.stopId}.`);
+            return;
+        }
+        if (loopsRef.current.length >= MAX_ACTIVE_LOOPS) {
+            addMessage("assistant", `Loop limit reached (${MAX_ACTIVE_LOOPS}). Stop one with /loop stop [id] first.`);
+            return;
+        }
+        const loop = {
+            id: nextLoopIdRef.current++,
+            prompt: parsed.prompt,
+            intervalMs: parsed.intervalMs,
+            // Fires immediately on creation (next idle tick), then repeats.
+            nextFireAt: Date.now(),
+            fires: 0,
+        };
+        loopsRef.current = [...loopsRef.current, loop];
+        addMessage("assistant", `Loop #${loop.id} set: every ${formatInterval(loop.intervalMs)} — ${loop.prompt}\nSession-scoped; /loop stop ${loop.id} to cancel.`, "ui_notice");
+    }, [addMessage]);
+    handleLoopCommandRef.current = handleLoopCommand;
+    useEffect(() => {
+        const timer = setInterval(() => {
+            if (loopsRef.current.length === 0 || exitRequestedRef.current)
+                return;
+            const now = Date.now();
+            for (const loop of loopsRef.current) {
+                const decision = decideLoopFiring(loop, now, !!activeAbortRef.current);
+                if (decision === "wait")
+                    continue;
+                loop.nextFireAt = now + loop.intervalMs;
+                if (decision === "defer") {
+                    // Defer-not-stack (design §2.6): the previous turn is still running.
+                    addMessage("assistant", `Loop #${loop.id} skipped this interval (a turn is still running); next in ${formatInterval(loop.intervalMs)}.`, "ui_notice");
+                    continue;
+                }
+                loop.fires += 1;
+                void handleSubmitRef.current({
+                    text: loop.prompt,
+                    displayText: `⟳ loop #${loop.id}: ${loop.prompt}`,
+                    images: [],
+                });
+            }
+        }, 1000);
+        return () => clearInterval(timer);
+    }, [addMessage]);
     // Drain the queue once the run ends and no modal needs the user first.
     // The placeholder row is removed right before resubmitting — handleSubmit
     // renders the message again as a regular user row.
@@ -2097,13 +2367,22 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
     const showThinkingLabel = Boolean(thinkingLevel)
         && thinkingLevel !== "off"
         && (isThinkingToggle || isThinkingOnly || availableThinkingLevels.length > 2);
-    const welcomeBannerNode = showWelcome ? (_jsx(WelcomeBanner, { terminalColumns: terminalColumns, tips: buildTips(agent, safeRegistry, grokSessionBound), updateNotice: currentUpdateNotice, cwd: friendlyCwd(args.cwd), sessionLabel: sessionBasename(currentSessionFile()), providerId: grokSessionBound ? "grok" : externalSessionBound ? undefined : agent.providerId || safeRegistry.getDefault()?.id, modelId: grokSessionBound ? externalRuntimeBinding?.modelId : externalSessionBound ? undefined : agent.apiModel, modelLabel: externalSessionBound
-            ? (grokSessionBound
-                ? `Grok Subscription${externalRuntimeBinding?.modelId ? ` · ${externalRuntimeBinding.modelId}` : ""}`
-                : "Unsupported external runtime · recovery-only mode")
-            : agent.model ? displayModel(agent.model) : undefined, thinkingLabel: grokSessionBound
-            ? externalRuntimeBinding?.reasoningEffort
-            : !externalSessionBound && showThinkingLabel ? thinkingLevel : undefined })) : null;
+    // The banner's model row stays live until the first settled row commits it
+    // into <Static> scrollback (so a /model switch on the fresh launch screen
+    // updates in place); after that the accent-colored transcript notices carry
+    // model changes. External runtimes surface theirs via the footer runtimeLabel.
+    const bannerTips = buildTips(agent, safeRegistry, grokSessionBound);
+    const bannerProviderId = grokSessionBound ? "grok" : externalSessionBound ? undefined : agent.providerId || safeRegistry.getDefault()?.id;
+    const bannerModelId = grokSessionBound ? externalRuntimeBinding?.modelId : externalSessionBound ? undefined : agent.apiModel;
+    const bannerModelLabel = externalSessionBound
+        ? (grokSessionBound
+            ? `Grok Subscription${externalRuntimeBinding?.modelId ? ` · ${externalRuntimeBinding.modelId}` : ""}`
+            : "Unsupported external runtime · recovery-only mode")
+        : agent.model ? displayModel(agent.model) : undefined;
+    const bannerThinkingLabel = grokSessionBound
+        ? externalRuntimeBinding?.reasoningEffort
+        : !externalSessionBound && showThinkingLabel ? thinkingLevel : undefined;
+    const welcomeBannerNode = showWelcome ? (_jsx(WelcomeBanner, { terminalColumns: terminalColumns, tips: bannerTips, updateNotice: currentUpdateNotice, cwd: friendlyCwd(args.cwd), sessionLabel: sessionBasename(currentSessionFile()), providerId: bannerProviderId, modelId: bannerModelId, modelLabel: bannerModelLabel, thinkingLabel: bannerThinkingLabel })) : null;
     const commandPaletteItems = useMemo(() => buildCommandPaletteItems(safeSkillRegistry, externalSessionBound), [externalSessionBound, safeSkillRegistry]);
     const mcpReconnectItems = useMemo(() => buildMcpReconnectItems(mcpManager), [mcpManager]);
     // No fixed-height frame: settled rows flow into the terminal's native
@@ -2164,7 +2443,7 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
                         }, onCancel: closePicker }) })), pickerMode === "mcp-reconnect" && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(McpReconnectPicker, { items: mcpReconnectItems, terminalColumns: mainWidth, terminalRows: terminalRows, onSelect: (item) => {
                             closePicker();
                             void handleSubmit(item.command);
-                        }, onCancel: closePicker }) })), pickerMode === "session" && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(SessionPicker, { currentCwd: args.cwd, currentSessions: SessionManager.summarizeSessionsForCwd(args.cwd), allSessions: SessionManager.listAllSessions(), onSelect: handleSessionSelect, onCancel: closePicker }) })), pickerMode === "agents" && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(SubagentInspector, { groups: subagentGroups, onCancel: closePicker }) })), pickerMode === "rewind" && sessionManager && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(RewindPicker, { sessionManager: sessionManager, terminalColumns: mainWidth, terminalRows: terminalRows, onSelect: (command) => {
+                        }, onCancel: closePicker }) })), pickerMode === "session" && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(SessionPicker, { currentCwd: args.cwd, currentSessions: SessionManager.summarizeSessionsForCwd(args.cwd), allSessions: SessionManager.listAllSessions(), onSelect: handleSessionSelect, onCancel: closePicker }) })), pickerMode === "agents" && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(SubagentInspector, { groups: subagentGroups, onCancel: closePicker, tasks: taskSnapshot, onKillTask: (taskId) => { void processManager?.killTask(taskId); } }) })), pickerMode === "rewind" && sessionManager && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(RewindPicker, { sessionManager: sessionManager, terminalColumns: mainWidth, terminalRows: terminalRows, onSelect: (command) => {
                             closePicker();
                             void handleSubmit(command);
                         }, onCancel: closePicker }) })), pickerMode === "feishu-setup" && (_jsx(Box, { paddingX: 1, flexShrink: 0, children: _jsx(FeishuSetupPicker, { onComplete: (summary) => {
@@ -2213,7 +2492,16 @@ export function App({ agent, args, sessionManager: initialSessionManager, switch
                         : 0, flexShrink: 0, backgroundColor: palette.background, children: _jsx(WaitingIndicator, { tools: streamingTools, hasStreamingText: streamingContent.length > 0, hasStreamingReasoning: streamingReasoning.length > 0, streamedChars: streamingContent.length + streamingReasoning.length, nowTick: nowTick, pendingSteerCount: pendingSteerCount, queuedCount: queuedCount }) })), !isExiting && !pickerMode && !statsPanel && (_jsx(Box, { paddingBottom: 1, flexShrink: 0, backgroundColor: palette.background, children: _jsx(InputBox, { onSubmit: handleSubmit, onQueue: isRunning ? queueInput : undefined, onArrowDownAtBottom: () => {
                             if (subagentMembers.length > 0 && !pickerMode)
                                 setSubagentEntryFocused(true);
-                        }, disabled: !!pendingPlan || !!pendingApproval || !!pendingQuestion || !!pendingFeedback || !!statsPanel || subagentEntryFocused, cursorResetEpoch: cursorResetEpoch, draftText: composerDraft?.text, draftEpoch: composerDraft?.epoch, onDraftApplied: clearComposerDraft, skillRegistry: externalSessionBound ? undefined : safeSkillRegistry, localSlashCommands: externalSessionBound ? [] : [...INK_LOCAL_SLASH_COMMANDS], allowedSlashCommands: unsupportedExternalSessionBound ? GROK_LOCAL_SLASH_COMMANDS : undefined, allowWorkspaceMentions: !unsupportedExternalSessionBound, allowImageAttachments: !externalSessionBound, terminalColumns: mainWidth, cwd: args.cwd, sessionFile: currentSessionFile(), nextImageLabelStart: nextImageDisplayLabelStartRef.current }) })), !isExiting && !pickerMode && !statsPanel && !pendingPlan && !pendingApproval && !pendingQuestion && !pendingFeedback && subagentMembers.length > 0 && (_jsxs(Box, { paddingX: 1, flexShrink: 0, children: [_jsx(Text, { bold: subagentEntryFocused, color: subagentEntryFocused ? palette.accent : palette.toolName, children: subagentEntryFocused ? "> ↳ " : "  ↳ " }), _jsxs(Text, { color: subagentEntryFocused ? palette.accent : palette.muted, children: [subagentMembers.length, " subagent", subagentMembers.length === 1 ? "" : "s", " \u00B7 ", subagentSummary(subagentMembers), " \u00B7 "] }), _jsx(Text, { color: palette.accent, children: subagentEntryFocused ? "Enter open · Esc back" : "↓ to inspect traces" })] })), !isExiting && (_jsx(Box, { flexShrink: 0, children: _jsx(FooterBar, { data: buildFooterData({
+                        }, disabled: !!pendingPlan || !!pendingApproval || !!pendingQuestion || !!pendingFeedback || !!statsPanel || subagentEntryFocused, cursorResetEpoch: cursorResetEpoch, draftText: composerDraft?.text, draftEpoch: composerDraft?.epoch, onDraftApplied: clearComposerDraft, skillRegistry: externalSessionBound ? undefined : safeSkillRegistry, localSlashCommands: externalSessionBound ? [] : [...INK_LOCAL_SLASH_COMMANDS], allowedSlashCommands: unsupportedExternalSessionBound ? GROK_LOCAL_SLASH_COMMANDS : undefined, allowWorkspaceMentions: !unsupportedExternalSessionBound, allowImageAttachments: !externalSessionBound, terminalColumns: mainWidth, cwd: args.cwd, sessionFile: currentSessionFile(), nextImageLabelStart: nextImageDisplayLabelStartRef.current }) })), !isExiting && !pickerMode && !statsPanel && !pendingPlan && !pendingApproval && !pendingQuestion && !pendingFeedback && (subagentMembers.length > 0 || runningTasks.length > 0) && (_jsxs(Box, { paddingX: 1, flexShrink: 0, children: [_jsx(Text, { bold: subagentEntryFocused, color: subagentEntryFocused ? palette.accent : palette.toolName, children: subagentEntryFocused ? "> ↳ " : "  ↳ " }), _jsxs(Text, { color: subagentEntryFocused ? palette.accent : palette.muted, children: [[
+                                    subagentMembers.length > 0
+                                        ? `${subagentMembers.length} subagent${subagentMembers.length === 1 ? "" : "s"} · ${subagentSummary(subagentMembers)}`
+                                        : undefined,
+                                    runningTasks.length > 0
+                                        ? `${runningTasks.length} task${runningTasks.length === 1 ? "" : "s"} · ${taskRowSummary(runningTasks, nowTick)}`
+                                        : undefined,
+                                ].filter(Boolean).join(" · "), " \u00B7 "] }), subagentMembers.length > 0
+                            ? _jsx(Text, { color: palette.accent, children: subagentEntryFocused ? "Enter open · Esc back" : "↓ to inspect traces" })
+                            : _jsx(Text, { color: palette.accent, children: "task_output to check \u00B7 kill_task to stop" })] })), !isExiting && (_jsx(Box, { flexShrink: 0, children: _jsx(FooterBar, { data: buildFooterData({
                             mode: permissionMode,
                             goalLine: externalSessionBound ? undefined : goalLine,
                             runtimeLabel: externalSessionBound

package/dist/tui-ink/approval/approval-dialog.js

@@ -29,7 +29,7 @@ export function ApprovalDialog({ request, onDecision, onAllowBashPrefix, }) {
     const onCancel = () => onDecision({ action: "reject" });
     const title = dialogTitle(request);
     const question = dialogQuestion(request);
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, marginY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: title }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RequestPreview, { request: request }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: question }) }), _jsx(Box, { marginTop: 1, children: _jsx(ApprovalSelect, { options: options, onSubmit: onSubmit, onCancel: onCancel, hint: "\u2191\u2193 choose \u00B7 Enter select \u00B7 Tab add feedback \u00B7 Esc reject" }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, marginY: 1, children: [_jsx(Text, { color: theme.accent, bold: true, children: title }), (request.type === "edit" || request.type === "write") && request.outsideWorkspace && (_jsx(Text, { color: theme.warning, bold: true, children: "\u26A0 This path is outside the workspace" })), _jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RequestPreview, { request: request }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: question }) }), _jsx(Box, { marginTop: 1, children: _jsx(ApprovalSelect, { options: options, onSubmit: onSubmit, onCancel: onCancel, hint: "\u2191\u2193 choose \u00B7 Enter select \u00B7 Tab add feedback \u00B7 Esc reject" }) })] }));
 }
 function buildOptions(request) {
     if (request.type === "bash") {
@@ -108,7 +108,7 @@ function basename(p) {
 function RequestPreview({ request }) {
     switch (request.type) {
         case "bash":
-            return _jsx(BashPreview, { command: request.command, cwd: request.cwd });
+            return _jsx(BashPreview, { command: request.command, cwd: request.cwd, background: request.background });
         case "edit":
             return _jsx(DiffView, { diff: request.diff });
         case "patch":
@@ -155,10 +155,10 @@ function AgentProfilePreview({ path, promptPreview }) {
     const theme = useTheme();
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.muted, children: compressHome(path) }), _jsx(Text, { children: promptPreview }), _jsx(Text, { color: theme.warning, children: "This prompt comes from the repository's .bubble/agents and will drive a subagent." })] }));
 }
-function BashPreview({ command, cwd }) {
+function BashPreview({ command, cwd, background }) {
     const theme = useTheme();
     const danger = classifyBashDanger(command);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "$ " }), _jsx(Text, { children: command })] }), _jsxs(Text, { color: theme.muted, children: ["cwd: ", compressHome(cwd)] }), danger && (_jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: theme.warning, bold: true, children: ["\u26A0 ", danger.pattern, ":"] }), _jsxs(Text, { color: theme.warning, children: [" ", danger.message] })] }))] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.muted, children: "$ " }), _jsx(Text, { children: command })] }), _jsxs(Text, { color: theme.muted, children: ["cwd: ", compressHome(cwd)] }), background && (_jsx(Text, { color: theme.warning, children: "runs in background \u2014 keeps running after this turn ends" })), danger && (_jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: theme.warning, bold: true, children: ["\u26A0 ", danger.pattern, ":"] }), _jsxs(Text, { color: theme.warning, children: [" ", danger.message] })] }))] }));
 }
 const MAX_WRITE_PREVIEW_LINES = 20;
 function WritePreview({ path, content }) {

package/dist/tui-ink/display-history.d.ts

@@ -12,7 +12,7 @@ export interface DisplayMessage {
     reasoning?: string;
     toolCalls?: DisplayToolCall[];
     parts?: DisplayMessagePart[];
-    syntheticKind?: "ui_summary" | "ui_compact_summary" | "ui_interrupt";
+    syntheticKind?: "ui_summary" | "ui_compact_summary" | "ui_interrupt" | "ui_notice";
     /** Markdown body shown inside a `ui_compact_summary` card. */
     compactionSummary?: string;
     hiddenCount?: number;

package/dist/tui-ink/footer.d.ts

@@ -5,9 +5,9 @@ export interface FooterData {
     runtimeLabel?: string;
 }
 /**
- * Bottom status line. Path / provider / model moved into the welcome banner;
- * the footer only surfaces the permission-mode badge, so it renders nothing
- * (zero rows) in the default mode.
+ * Bottom status line. Path / provider / model live in the welcome banner and
+ * the model-switch transcript notices; the footer only surfaces the
+ * permission-mode badge, so it renders nothing (zero rows) in the default mode.
  */
 export declare function FooterBar({ data }: {
     data: FooterData;

package/dist/tui-ink/footer.js

@@ -3,9 +3,9 @@ import { Box, Text } from "ink";
 import { useTheme } from "./theme.js";
 import { PERMISSION_MODE_INFO } from "../permission/mode.js";
 /**
- * Bottom status line. Path / provider / model moved into the welcome banner;
- * the footer only surfaces the permission-mode badge, so it renders nothing
- * (zero rows) in the default mode.
+ * Bottom status line. Path / provider / model live in the welcome banner and
+ * the model-switch transcript notices; the footer only surfaces the
+ * permission-mode badge, so it renders nothing (zero rows) in the default mode.
  */
 export function FooterBar({ data }) {
     const showMode = !!data.mode && data.mode !== "default";

package/dist/tui-ink/input-box.d.ts

@@ -11,6 +11,12 @@ export interface SubmitPayload {
     images: ImageAttachment[];
     /** First UI-only [Image #N] label reserved for this submitted payload. */
     imageDisplayStart?: number;
+    /**
+     * Harness-initiated submission (background-tasks design §2.3b): runs
+     * hidden with the text wrapped as internal context, never rendered as a
+     * user row. Only the TUI wake path sets this.
+     */
+    internal?: "task_wake";
 }
 interface InputBoxProps {
     onSubmit: (payload: SubmitPayload) => void;

package/dist/tui-ink/markdown.d.ts

@@ -79,17 +79,25 @@ export declare function wrapInlineSegments(segments: MarkdownInlineSegment[], ma
  * reset handles the rare case where `content` is replaced wholesale (e.g.,
  * the user re-enters a turn).
  */
-export declare function StreamingMarkdown({ content, maxWidth, }: {
+export declare function StreamingMarkdown({ content, maxWidth, flushTop, }: {
     content: string;
     maxWidth?: number;
+    /** See MarkdownContent: applies to the true document start only. */
+    flushTop?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 export declare function splitListItem(line: string): {
     prefix: string;
     content: string;
     indent: number;
 } | null;
-export declare function MarkdownContent({ content, maxWidth, }: {
+export declare function MarkdownContent({ content, maxWidth, flushTop, }: {
     content: string;
     maxWidth?: number;
+    /**
+     * Suppress the FIRST block's top margin. Set when this document renders
+     * beside an inline marker (the timeline "●  " gutter): a leading heading /
+     * code block / table would otherwise start one row below the marker.
+     */
+    flushTop?: boolean;
 }): import("react/jsx-runtime").JSX.Element;
 export {};