parallel-codex-tui 0.3.1 → 0.4.0

package/dist/tui/App.js

@@ -7,6 +7,7 @@ import { copyTextToClipboard } from "../core/clipboard.js";
 import { readJson } from "../core/file-store.js";
 import { CONFIGURABLE_ROLES, configuredRoleSelection } from "../core/role-configuration.js";
 import { WorkerStatusSchema } from "../domain/schemas.js";
+import { isSupervisorDetachedError } from "../supervisor/client.js";
 import { effectiveWorkerWatchdog, formatRoutePendingStatus, formatRoutePendingSummaryStatus, formatRouteStatus, formatRouteSummaryStatus, formatStatusLine, formatWorkerRuntimeStatus } from "./status-line.js";
 import { applyChatInputChunk, insertChatPaste } from "./chat-input.js";
 import { chatRequestHistory, navigateChatDraftHistory } from "./chat-history.js";
@@ -62,6 +63,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const [inputCursor, setInputCursor] = useState(0);
     const [inputReady, setInputReady] = useState(false);
     const [terminalSize, setTerminalSize] = useState(readTerminalSize);
+    const [, setBackgroundRunRevision] = useState(0);
     const [messages, setMessages] = useState(() => [...initialMessages]);
     const [taskResultExpanded, setTaskResultExpanded] = useState(() => (Boolean(initialTaskId) && latestTaskResultMessageIndex(initialMessages, initialTaskId) >= 0));
     const [busy, setBusy] = useState(false);
@@ -119,6 +121,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const [taskSessionsError, setTaskSessionsError] = useState(null);
     const [taskSessionsNotice, setTaskSessionsNotice] = useState(null);
     const [taskSessionsIncludeArchived, setTaskSessionsIncludeArchived] = useState(false);
+    const [taskSessionQuery, setTaskSessionQuery] = useState("");
     const [taskSessionAction, setTaskSessionAction] = useState(null);
     const [taskSessionDetails, setTaskSessionDetails] = useState(null);
     const [taskSessionDetailSelectedWorkerIndex, setTaskSessionDetailSelectedWorkerIndex] = useState(0);
@@ -147,6 +150,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const copyTextByViewRef = useRef({ chat: "", worker: "" });
     const messagesRef = useRef([...initialMessages]);
     const activeRunControllerRef = useRef(null);
+    const backgroundRestoreStartedRef = useRef(false);
     const activeTaskIdRef = useRef(initialTaskId);
     const nativeInputRef = useRef(nativeInput);
     const inputRef = useRef(input);
@@ -174,6 +178,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     const mainConversationActionRef = useRef(mainConversationAction);
     const taskSessionsLoadingRef = useRef(taskSessionsLoading);
     const taskSessionsIncludeArchivedRef = useRef(taskSessionsIncludeArchived);
+    const taskSessionQueryRef = useRef("");
     const taskSessionActionRef = useRef(taskSessionAction);
     const taskSessionDetailsRef = useRef(null);
     const taskSessionDetailSelectedWorkerIndexRef = useRef(0);
@@ -268,6 +273,8 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         && !busy
         && canRetryTask
         && selectedBoardFeature?.state !== "approved";
+    const backgroundRunAttached = orchestrator.backgroundRunAttached?.() ?? false;
+    const backgroundRunControllable = orchestrator.backgroundRunControllable?.() ?? backgroundRunAttached;
     const visibleStatus = statusLineWithWorkerRefs(status, workers);
     const visibleRouteStatus = routePending
         ? formatRoutePendingStatus(routePending, routeElapsedMs)
@@ -288,6 +295,9 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             : roleConfigurationSnapshot.future
         : configuredRoleSelection(config);
     const roleConfigurationHasOverride = roleConfigurationScopeHasOverride(roleConfigurationSnapshot, roleConfigurationScope);
+    useEffect(() => orchestrator.subscribeBackgroundRunState?.(() => {
+        setBackgroundRunRevision((current) => current + 1);
+    }), [orchestrator]);
     useEffect(() => {
         inputRef.current = input;
     }, [input]);
@@ -453,6 +463,9 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     useEffect(() => {
         taskSessionsIncludeArchivedRef.current = taskSessionsIncludeArchived;
     }, [taskSessionsIncludeArchived]);
+    useEffect(() => {
+        taskSessionQueryRef.current = taskSessionQuery;
+    }, [taskSessionQuery]);
     useEffect(() => {
         taskSessionActionRef.current = taskSessionAction;
     }, [taskSessionAction]);
@@ -628,6 +641,70 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             active = false;
         };
     }, [activeTaskId, initialTaskId, initialWorkers, orchestrator]);
+    useEffect(() => {
+        if (!orchestrator.restorePendingRun || backgroundRestoreStartedRef.current) {
+            return;
+        }
+        backgroundRestoreStartedRef.current = true;
+        const controller = new AbortController();
+        activeRunControllerRef.current = controller;
+        let active = true;
+        async function restoreBackgroundRun() {
+            busyRef.current = true;
+            setBusy(true);
+            try {
+                const result = await orchestrator.restorePendingRun?.({
+                    cwd,
+                    ...createRunCallbacks(controller, { announceRoute: false })
+                });
+                if (!active || !result) {
+                    return;
+                }
+                const taskId = result.taskId ?? activeTaskIdRef.current;
+                activeTaskIdRef.current = taskId;
+                setActiveTaskId(taskId);
+                setActiveMode(taskId ? "complex" : result.mode);
+                setCanRetryTask(taskId ? await orchestrator.canRetryTask(taskId) : false);
+                await refreshRoleConfigurationState(taskId);
+                if (!messagesRef.current.some((message) => message.from === "system" && message.text === result.summary && message.taskId === (taskId ?? undefined))) {
+                    await appendVisibleMessage({ from: "system", text: result.summary }, taskId ?? undefined, { persist: false });
+                }
+                if (result.mode === "complex" && parseTaskResultSummary(result.summary)) {
+                    setTaskResultExpanded(true);
+                }
+                await orchestrator.acknowledgeBackgroundRun?.();
+            }
+            catch (error) {
+                if (!active || isSupervisorDetachedError(error)) {
+                    return;
+                }
+                const taskId = activeTaskIdRef.current;
+                const text = isAbortError(error)
+                    ? "cancelled · request stopped"
+                    : error instanceof Error ? error.message : String(error);
+                if (!messagesRef.current.some((message) => message.from === "system" && message.text === text && message.taskId === (taskId ?? undefined))) {
+                    await appendVisibleMessage({ from: "system", text }, taskId ?? undefined, { persist: false });
+                }
+                await orchestrator.acknowledgeBackgroundRun?.();
+                setCanRetryTask(taskId ? await orchestrator.canRetryTask(taskId) : false);
+            }
+            finally {
+                if (activeRunControllerRef.current === controller) {
+                    activeRunControllerRef.current = null;
+                }
+                if (active) {
+                    setRoutePending(null);
+                    setRouteAnnouncement(null);
+                    busyRef.current = false;
+                    setBusy(false);
+                }
+            }
+        }
+        void restoreBackgroundRun();
+        return () => {
+            active = false;
+        };
+    }, [cwd, orchestrator]);
     useEffect(() => {
         if (workers.length === 0 || !status) {
             return;
@@ -763,8 +840,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         process.stdout.write("\x1b[?2004h\x1b[?1006l\x1b[?1003l\x1b[?1002l\x1b[?1000l");
         const commitChatInputUpdate = (update, previousValue, previousCursor) => {
             if (update.exit) {
-                activeRunControllerRef.current?.abort();
-                exitRef.current();
+                requestAppExit();
                 return false;
             }
             if (busyRef.current) {
@@ -877,8 +953,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "chat" && routeFallbackPromptRef.current) {
                 const fallbackChunks = tokenizeRawInput(chunk);
                 if (fallbackChunks.some((fallbackChunk) => isExitShortcut(fallbackChunk, {}))) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 if (fallbackChunks.some((fallbackChunk) => isStatusDetailsShortcut(fallbackChunk, {}))) {
@@ -928,8 +1003,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "roles") {
                 const roleChunks = tokenizeRawInput(chunk);
                 if (roleChunks.some((roleChunk) => isExitShortcut(roleChunk, {}))) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 if (roleChunks.some((roleChunk) => isStatusDetailsShortcut(roleChunk, {}))) {
@@ -1044,8 +1118,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             }
             if (currentView === "status") {
                 if (isExitShortcut(chunk, {})) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 if (isStatusDetailsShortcut(chunk, {}) || chunk === "\x1b") {
@@ -1063,8 +1136,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             }
             if (currentView === "sessions") {
                 if (isExitShortcut(chunk, {})) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 if (taskSessionDetailsRef.current) {
@@ -1246,10 +1318,38 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 const sessionAction = taskSessionActionRef.current;
                 if (sessionAction) {
                     if (chunk === "\x1b") {
+                        if (sessionAction.type === "search") {
+                            const preferred = taskSessionsRef.current[selectedTaskSessionIndexRef.current]?.id ?? null;
+                            updateTaskSessionAction(null);
+                            setTaskSessionsError(null);
+                            void refreshTaskSessionsRef.current(preferred, sessionAction.previousQuery);
+                            return;
+                        }
                         updateTaskSessionAction(null);
                         setTaskSessionsError(null);
                         return;
                     }
+                    if (sessionAction.type === "search") {
+                        const update = applyChatInputChunk(sessionAction.value, chunk, sessionAction.cursor);
+                        const preferred = taskSessionsRef.current[selectedTaskSessionIndexRef.current]?.id ?? null;
+                        if (update.submit !== null) {
+                            updateTaskSessionAction(null);
+                            setTaskSessionsError(null);
+                            void refreshTaskSessionsRef.current(preferred, update.submit);
+                        }
+                        else {
+                            updateTaskSessionAction({
+                                ...sessionAction,
+                                value: update.value,
+                                cursor: update.cursor
+                            });
+                            if (update.value !== sessionAction.value) {
+                                setTaskSessionsError(null);
+                                void refreshTaskSessionsRef.current(preferred, update.value);
+                            }
+                        }
+                        return;
+                    }
                     if (taskSessionsLoadingRef.current) {
                         return;
                     }
@@ -1286,6 +1386,17 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 if (taskSessionsLoadingRef.current) {
                     return;
                 }
+                if (isWorkerSearchShortcut(chunk, {})) {
+                    updateTaskSessionAction({
+                        type: "search",
+                        value: taskSessionQueryRef.current,
+                        cursor: Array.from(taskSessionQueryRef.current).length,
+                        previousQuery: taskSessionQueryRef.current
+                    });
+                    setTaskSessionsError(null);
+                    setTaskSessionsNotice(null);
+                    return;
+                }
                 if (isRouterDiagnosticsShortcut(chunk, {})) {
                     void openRouterDiagnosticsRef.current();
                     return;
@@ -1303,6 +1414,11 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                     return;
                 }
                 const selectedSession = taskSessionsRef.current[selectedTaskSessionIndexRef.current];
+                if ((chunk === "x" || chunk === "X") && taskSessionQueryRef.current.trim()) {
+                    void refreshTaskSessionsRef.current(selectedSession?.id ?? null, "");
+                    setTaskSessionsNotice("Task search cleared");
+                    return;
+                }
                 if (chunk === "r" || chunk === "R") {
                     if (selectedSession) {
                         updateTaskSessionAction({
@@ -1373,8 +1489,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "features") {
                 const featureChunks = tokenizeRawInput(chunk);
                 if (featureChunks.some((featureChunk) => isExitShortcut(featureChunk, {}))) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 const pendingCancel = featureCancelPromptRef.current;
@@ -1526,8 +1641,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "collaboration") {
                 const timelineChunks = tokenizeRawInput(chunk);
                 if (timelineChunks.some((timelineChunk) => isExitShortcut(timelineChunk, {}))) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 for (const timelineChunk of timelineChunks) {
@@ -1617,8 +1731,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             }
             if (currentView === "workers") {
                 if (isExitShortcut(chunk, {})) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 if (isWorkerOverviewShortcut(chunk, {}) || chunk === "\x1b") {
@@ -1681,8 +1794,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "router") {
                 const routerChunks = tokenizeRawInput(chunk);
                 if (routerChunks.some((routerChunk) => isExitShortcut(routerChunk, {}))) {
-                    activeRunControllerRef.current?.abort();
-                    exitRef.current();
+                    requestAppExit();
                     return;
                 }
                 for (const routerChunk of routerChunks) {
@@ -1719,8 +1831,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             if (currentView === "worker") {
                 for (const workerChunk of tokenizeRawInput(chunk)) {
                     if (isExitShortcut(workerChunk, {})) {
-                        activeRunControllerRef.current?.abort();
-                        exitRef.current();
+                        requestAppExit();
                         return;
                     }
                     if (workerSearchRef.current.open) {
@@ -1975,6 +2086,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             nativeAttachRequestSequenceRef.current += 1;
             nativeAttachRef.current?.process.kill();
             nativeAttachRef.current = null;
+            orchestrator.detachBackgroundRuns?.();
             activeRunControllerRef.current?.abort();
             collaborationLoadSequenceRef.current += 1;
             routerLoadSequenceRef.current += 1;
@@ -1990,8 +2102,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             return;
         }
         const shutdown = () => {
-            activeRunControllerRef.current?.abort();
-            exitRef.current();
+            requestAppExit();
         };
         if (shutdownSignal.aborted) {
             shutdown();
@@ -2000,6 +2111,11 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         shutdownSignal.addEventListener("abort", shutdown, { once: true });
         return () => shutdownSignal.removeEventListener("abort", shutdown);
     }, [shutdownSignal]);
+    function requestAppExit() {
+        orchestrator.detachBackgroundRuns?.();
+        activeRunControllerRef.current?.abort();
+        exitRef.current();
+    }
     async function copyVisibleView() {
         const payload = visibleClipboardPayload(viewRef.current);
         if (!payload?.text.trim()) {
@@ -2147,8 +2263,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     useInput((inputKey, key) => {
         if (view === "worker") {
             if (isExitShortcut(inputKey, key)) {
-                activeRunControllerRef.current?.abort();
-                exitRef.current();
+                requestAppExit();
                 return;
             }
             if (isNewConversationShortcut(inputKey, key) && !busy) {
@@ -2370,14 +2485,14 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     function settleRouteFallbackChoice(choice) {
         routeFallbackResolverRef.current?.(choice);
     }
-    async function appendVisibleMessage(message, taskId) {
+    async function appendVisibleMessage(message, taskId, options = {}) {
         const visibleMessage = taskId ? { ...message, taskId } : message;
         setMessages((current) => {
             const next = [...current, visibleMessage];
             messagesRef.current = next;
             return next;
         });
-        if (!persistChatMessage) {
+        if (!persistChatMessage || options.persist === false) {
             return;
         }
         try {
@@ -2464,13 +2579,17 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 : false);
             await refreshRoleConfigurationState(nextMemory.activeTaskId);
             setRouteAnnouncement(null);
-            await appendVisibleMessage({ from: "system", text: result.summary }, nextMemory.activeTaskId ?? undefined);
+            await appendVisibleMessage({ from: "system", text: result.summary }, nextMemory.activeTaskId ?? undefined, { persist: !orchestrator.persistsRunResults });
+            await orchestrator.acknowledgeBackgroundRun?.();
             if (result.mode === "complex" && parseTaskResultSummary(result.summary)) {
                 setTaskResultExpanded(true);
             }
         }
         catch (error) {
             setRouteAnnouncement(null);
+            if (isSupervisorDetachedError(error)) {
+                return;
+            }
             const retryTaskId = activeTaskIdRef.current;
             if (retryTaskId) {
                 setCanRetryTask(await orchestrator.canRetryTask(retryTaskId));
@@ -2479,7 +2598,8 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             await appendVisibleMessage({
                 from: "system",
                 text: isAbortError(error) ? "cancelled · request stopped" : error instanceof Error ? error.message : String(error)
-            }, retryTaskId ?? undefined);
+            }, retryTaskId ?? undefined, { persist: !orchestrator.persistsRunResults });
+            await orchestrator.acknowledgeBackgroundRun?.();
         }
         finally {
             if (activeRunControllerRef.current === controller) {
@@ -2525,19 +2645,24 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
             setCanRetryTask(false);
             await refreshRoleConfigurationState(taskId);
             setRouteAnnouncement(null);
-            await appendVisibleMessage({ from: "system", text: result.summary }, taskId);
+            await appendVisibleMessage({ from: "system", text: result.summary }, taskId, { persist: !orchestrator.persistsRunResults });
+            await orchestrator.acknowledgeBackgroundRun?.();
             if (parseTaskResultSummary(result.summary)) {
                 setTaskResultExpanded(true);
             }
         }
         catch (error) {
             setRouteAnnouncement(null);
+            if (isSupervisorDetachedError(error)) {
+                return;
+            }
             setCanRetryTask(await orchestrator.canRetryTask(taskId));
             await refreshRoleConfigurationState(taskId);
             await appendVisibleMessage({
                 from: "system",
                 text: isAbortError(error) ? "cancelled · retry stopped" : error instanceof Error ? error.message : String(error)
-            }, taskId);
+            }, taskId, { persist: !orchestrator.persistsRunResults });
+            await orchestrator.acknowledgeBackgroundRun?.();
         }
         finally {
             if (activeRunControllerRef.current === controller) {
@@ -2656,11 +2781,16 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
         setTaskSessionDetailNotice(null);
         updateTaskSessionAction(null);
         updateMainConversationAction(null);
+        taskSessionQueryRef.current = "";
+        setTaskSessionQuery("");
         sessionCenterModeRef.current = "tasks";
         setSessionCenterMode("tasks");
         await refreshTaskSessions(activeTaskIdRef.current);
     }
-    async function refreshTaskSessions(preferredTaskId = null) {
+    async function refreshTaskSessions(preferredTaskId = null, query = taskSessionQueryRef.current) {
+        const normalizedQuery = query.replace(/[\u0000-\u001f\u007f]/g, " ").slice(0, 1000);
+        taskSessionQueryRef.current = normalizedQuery;
+        setTaskSessionQuery(normalizedQuery);
         taskSessionsLoadingRef.current = true;
         setTaskSessionsLoading(true);
         const sequence = taskSessionsLoadSequenceRef.current + 1;
@@ -2670,7 +2800,8 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 throw new Error("Task sessions are unavailable");
             }
             const tasks = await loadTaskSessions({
-                includeArchived: taskSessionsIncludeArchivedRef.current
+                includeArchived: taskSessionsIncludeArchivedRef.current,
+                ...(normalizedQuery.trim() ? { query: normalizedQuery } : {})
             });
             if (taskSessionsLoadSequenceRef.current !== sequence) {
                 return;
@@ -3519,7 +3650,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
     if (view === "workspace") {
         return (_jsx(Box, { flexDirection: "column", height: terminalSize.rows, children: _jsx(WorkspacePicker, { cwd: cwd, choices: workspaceChoices, terminalHeight: terminalSize.rows, terminalWidth: terminalWidth, onCancel: closeWorkspacePicker, onSelect: (workspace) => void selectWorkspace(workspace) }) }));
     }
-    return (_jsx(AppShell, { view: view, cwd: cwd, taskId: activeTaskId, statusText: [visibleTaskStatus, visibleRouteSummary, configChange?.compact].filter(Boolean).join(" | "), contentHeight: contentHeight, showStatusBar: config.ui.showStatusBar, input: _jsx(InputBar, { mode: view === "worker" && workerSearch.open ? "worker-search" : view, ready: inputReady, busy: busy, routeFallback: Boolean(routeFallbackPrompt), collaborationDetail: collaborationDetailOpen, collaborationUnresolved: collaborationUnresolvedOnly, collaborationBack: collaborationReturnViewRef.current, featureCanCancel: featureCanCancel, featureCanPause: featureCanCancel, featureCanReassign: featureCanReassign, featureCancelConfirm: featureCancelPrompt?.action === "cancel", featurePauseConfirm: featureCancelPrompt?.action === "pause", featureAssignment: Boolean(featureAssignmentPrompt), featureEditingModel: featureAssignmentPrompt?.modelEdit ?? null, taskSessionAction: sessionCenterMode === "conversations"
+    return (_jsx(AppShell, { view: view, cwd: cwd, taskId: activeTaskId, busy: busy, detachable: backgroundRunAttached, controllable: backgroundRunControllable, statusText: [visibleTaskStatus, visibleRouteSummary, configChange?.compact].filter(Boolean).join(" | "), contentHeight: contentHeight, showStatusBar: config.ui.showStatusBar, input: _jsx(InputBar, { mode: view === "worker" && workerSearch.open ? "worker-search" : view, ready: inputReady, busy: busy, busyDetachable: backgroundRunAttached, busyControllable: backgroundRunControllable, routeFallback: Boolean(routeFallbackPrompt), collaborationDetail: collaborationDetailOpen, collaborationUnresolved: collaborationUnresolvedOnly, collaborationBack: collaborationReturnViewRef.current, featureCanCancel: featureCanCancel, featureCanPause: featureCanCancel, featureCanReassign: featureCanReassign, featureCancelConfirm: featureCancelPrompt?.action === "cancel", featurePauseConfirm: featureCancelPrompt?.action === "pause", featureAssignment: Boolean(featureAssignmentPrompt), featureEditingModel: featureAssignmentPrompt?.modelEdit ?? null, taskSessionAction: sessionCenterMode === "conversations"
                 ? mainConversationAction?.type === "rename"
                     ? { type: "rename", value: mainConversationAction.value, cursor: mainConversationAction.cursor }
                     : mainConversationAction?.type === "delete"
@@ -3529,9 +3660,11 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                     ? { type: "rename", value: taskSessionAction.value, cursor: taskSessionAction.cursor }
                     : taskSessionAction?.type === "delete"
                         ? { type: "delete", title: taskSessionAction.title }
-                        : null, taskSessionsIncludeArchived: sessionCenterMode === "conversations"
+                        : taskSessionAction?.type === "search"
+                            ? { type: "search", value: taskSessionAction.value, cursor: taskSessionAction.cursor }
+                            : null, taskSessionsIncludeArchived: sessionCenterMode === "conversations"
                 ? mainConversationsIncludeArchived
-                : taskSessionsIncludeArchived, mainConversationSessions: sessionCenterMode === "conversations" && !taskSessionDetails, taskSessionDetail: Boolean(taskSessionDetails), taskSessionDetailHasNative: taskSessionDetailHasNative, taskSessionDetailCanFork: taskSessionDetailCanFork, canRetry: canRetryTask, hasWorkers: workers.length > 0, hasActiveTask: Boolean(activeTaskId), hasTaskResult: hasTaskResult, taskResultExpanded: taskResultExpanded, chatScrollOffset: chatScrollOffset, chatMaxScrollOffset: chatMaxScrollOffset, nativeClosed: view === "native" && nativeAttach?.closedCode !== null, searchMatchIndex: workerSearch.matchIndex, searchMatchCount: workerNavigationTargets.searchOffsets.length, clipboardNotice: clipboardNotice, roleScope: roleConfigurationScope, roleEditingModel: roleModelEdit, roleCanApply: roleConfigurationScope !== "task" || Boolean(activeTaskId), roleSaving: roleConfigurationSaving, roleHasOverride: roleConfigurationHasOverride, value: workerSearch.open && view === "worker"
+                : taskSessionsIncludeArchived, taskSessionQuery: taskSessionQuery, mainConversationSessions: sessionCenterMode === "conversations" && !taskSessionDetails, taskSessionDetail: Boolean(taskSessionDetails), taskSessionDetailHasNative: taskSessionDetailHasNative, taskSessionDetailCanFork: taskSessionDetailCanFork, canRetry: canRetryTask, hasWorkers: workers.length > 0, hasActiveTask: Boolean(activeTaskId), hasTaskResult: hasTaskResult, taskResultExpanded: taskResultExpanded, chatScrollOffset: chatScrollOffset, chatMaxScrollOffset: chatMaxScrollOffset, nativeClosed: view === "native" && nativeAttach?.closedCode !== null, searchMatchIndex: workerSearch.matchIndex, searchMatchCount: workerNavigationTargets.searchOffsets.length, clipboardNotice: clipboardNotice, roleScope: roleConfigurationScope, roleEditingModel: roleModelEdit, roleCanApply: roleConfigurationScope !== "task" || Boolean(activeTaskId), roleSaving: roleConfigurationSaving, roleHasOverride: roleConfigurationHasOverride, value: workerSearch.open && view === "worker"
                 ? workerSearch.query
                 : view === "native" || view === "router" || view === "workers" || view === "features" || view === "sessions" || view === "collaboration" || view === "status" || view === "roles" ? "" : input, cursor: workerSearch.open && view === "worker"
                 ? workerSearch.cursor
@@ -3539,7 +3672,7 @@ export function App({ config, orchestrator, cwd, initialTaskId = null, initialRo
                 ? { type: "rename", title: mainConversationAction.title }
                 : mainConversationAction?.type === "delete"
                     ? { type: "delete", title: mainConversationAction.title }
-                    : null, loading: taskSessionsLoading, error: taskSessionsError, height: contentHeight, terminalWidth: terminalWidth })) : (_jsx(TaskSessionsView, { tasks: taskSessions, activeTaskId: activeTaskId, selectedIndex: selectedTaskSessionIndex, includeArchived: taskSessionsIncludeArchived, notice: taskSessionsNotice, action: taskSessionAction?.type === "rename"
+                    : null, loading: taskSessionsLoading, error: taskSessionsError, height: contentHeight, terminalWidth: terminalWidth })) : (_jsx(TaskSessionsView, { tasks: taskSessions, activeTaskId: activeTaskId, selectedIndex: selectedTaskSessionIndex, includeArchived: taskSessionsIncludeArchived, query: taskSessionQuery, notice: taskSessionsNotice, action: taskSessionAction?.type === "rename"
                 ? { type: "rename", title: taskSessionAction.title }
                 : taskSessionAction?.type === "delete"
                     ? { type: "delete", title: taskSessionAction.title }

package/dist/tui/AppShell.js

@@ -6,8 +6,8 @@ import { compactEndByDisplayWidth, displayWidth } from "./display-width.js";
 import { TUI_THEME } from "./theme.js";
 const APP_HEADER_ROOMY_SEPARATOR = " · ";
 const APP_HEADER_COMPACT_SEPARATOR = "  ";
-export function AppShell({ view, cwd, taskId, statusText, contentHeight = 20, terminalWidth = process.stdout.columns || 120, showStatusBar = true, children, input, error = null }) {
-    const header = headerParts({ view, cwd, taskId, terminalWidth });
+export function AppShell({ view, cwd, taskId, statusText, contentHeight = 20, terminalWidth = process.stdout.columns || 120, showStatusBar = true, busy = false, detachable = false, controllable = true, children, input, error = null }) {
+    const header = headerParts({ view, cwd, taskId, terminalWidth, busy, detachable, controllable });
     const headerSegments = headerDisplaySegments(header);
     const headerSeparatorText = headerSeparator(terminalWidth);
     const headerLeadingWidth = terminalWidth > 1 ? 1 : 0;
@@ -186,7 +186,11 @@ function headerParts(input) {
         view: nano ? "" : input.terminalWidth <= 24 && input.view === "native" ? "nat" : narrow ? shortViewLabel(input.view) : viewLabel(input.view),
         task: showTask ? ultraNarrow ? ultraCompactTaskId(task) : narrow ? task : `#${task}` : "",
         project: tiny || ultraNarrow ? "" : compactHeaderProject(input.cwd, veryNarrow ? 10 : narrow ? 16 : 40),
-        shortcut: narrow ? shortShortcutHint(input.view) : shortcutHint(input.view)
+        shortcut: input.busy && input.detachable
+            ? input.controllable
+                ? narrow ? "^C detach" : "Esc stop · ^C detach"
+                : narrow ? "^C detach" : "observe · ^C detach"
+            : narrow ? shortShortcutHint(input.view) : shortcutHint(input.view)
     }, contentWidth, separator);
 }
 function fitHeaderParts(parts, contentWidth, separator) {

package/dist/tui/InputBar.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { Box, Text } from "ink";
 import { compactEndByDisplayWidth, compactTailByDisplayWidth, displayWidth } from "./display-width.js";
 import { TUI_THEME } from "./theme.js";
-export function InputBar({ mode, ready = true, busy = false, routeFallback = false, collaborationDetail = false, collaborationUnresolved = false, collaborationBack = "workers", featureCanCancel = false, featureCanPause = false, featureCanReassign = false, featureCancelConfirm = false, featurePauseConfirm = false, featureAssignment = false, featureEditingModel = null, taskSessionAction = null, taskSessionsIncludeArchived = false, mainConversationSessions = false, taskSessionDetail = false, taskSessionDetailHasNative = false, taskSessionDetailCanFork = false, canRetry = false, hasWorkers = false, hasActiveTask = false, hasTaskResult = false, taskResultExpanded = false, chatScrollOffset = 0, chatMaxScrollOffset = 0, nativeClosed = false, searchMatchIndex = 0, searchMatchCount = 0, clipboardNotice = null, roleScope = "next", roleEditingModel = null, roleCanApply = true, roleSaving = false, roleHasOverride = false, value, cursor, terminalWidth: providedTerminalWidth, onChange, onSubmit }) {
+export function InputBar({ mode, ready = true, busy = false, busyDetachable = false, busyControllable = true, routeFallback = false, collaborationDetail = false, collaborationUnresolved = false, collaborationBack = "workers", featureCanCancel = false, featureCanPause = false, featureCanReassign = false, featureCancelConfirm = false, featurePauseConfirm = false, featureAssignment = false, featureEditingModel = null, taskSessionAction = null, taskSessionsIncludeArchived = false, taskSessionQuery = "", mainConversationSessions = false, taskSessionDetail = false, taskSessionDetailHasNative = false, taskSessionDetailCanFork = false, canRetry = false, hasWorkers = false, hasActiveTask = false, hasTaskResult = false, taskResultExpanded = false, chatScrollOffset = 0, chatMaxScrollOffset = 0, nativeClosed = false, searchMatchIndex = 0, searchMatchCount = 0, clipboardNotice = null, roleScope = "next", roleEditingModel = null, roleCanApply = true, roleSaving = false, roleHasOverride = false, value, cursor, terminalWidth: providedTerminalWidth, onChange, onSubmit }) {
     const terminalWidth = providedTerminalWidth ?? process.stdout.columns ?? 120;
     const fillRail = providedTerminalWidth !== undefined || typeof process.stdout.columns === "number";
     if (clipboardNotice) {
@@ -42,6 +42,13 @@ export function InputBar({ mode, ready = true, busy = false, routeFallback = fal
         return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(`${hints.label}${hints.detail}`), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: hints.label }), hints.detail ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.muted, children: hints.detail }) : null] }));
     }
     if (mode === "sessions") {
+        if (taskSessionAction?.type === "search") {
+            const prefix = terminalWidth < 12 ? "/ " : "find > ";
+            const valueWidth = Math.max(1, terminalWidth - displayWidth(prefix) - 3);
+            const display = chatInputDisplayParts(taskSessionAction.value, taskSessionAction.cursor, valueWidth);
+            const textWidth = displayWidth(`${prefix}${display.before}|${display.after}`);
+            return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: textWidth, fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: prefix }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: display.before }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: "|" }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: display.after })] }));
+        }
         if (taskSessionAction?.type === "rename") {
             const prefix = terminalWidth < 12 ? "> " : "rename > ";
             const valueWidth = Math.max(1, terminalWidth - displayWidth(prefix) - 3);
@@ -61,7 +68,7 @@ export function InputBar({ mode, ready = true, busy = false, routeFallback = fal
             const hints = mainConversationSessionsInputHints(terminalWidth, taskSessionsIncludeArchived);
             return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(`${hints.label}${hints.detail}`), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: hints.label }), hints.detail ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.muted, children: hints.detail }) : null] }));
         }
-        const hints = taskSessionsInputHints(terminalWidth, taskSessionsIncludeArchived);
+        const hints = taskSessionsInputHints(terminalWidth, taskSessionsIncludeArchived, Boolean(taskSessionQuery.trim()));
         return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(`${hints.label}${hints.detail}`), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.accent, bold: true, children: hints.label }), hints.detail ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.muted, children: hints.detail }) : null] }));
     }
     if (mode === "collaboration") {
@@ -106,7 +113,7 @@ export function InputBar({ mode, ready = true, busy = false, routeFallback = fal
         const hints = routeFallbackInputHints(terminalWidth);
         return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(`${hints.label}${hints.detail}`), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.warning, bold: true, children: hints.label }), hints.detail ? _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.text, children: hints.detail }) : null] }));
     }
-    const busyText = chatBusyDisplayValue(terminalWidth);
+    const busyText = chatBusyDisplayValue(terminalWidth, busyDetachable, busyControllable);
     const prompt = busy ? "run" : ">";
     if (busy) {
         return (_jsxs(InputRail, { terminalWidth: terminalWidth, textWidth: displayWidth(busyText ? `${prompt} ${busyText}` : prompt), fill: fillRail, children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.warning, bold: true, children: prompt }), busyText ? (_jsxs(_Fragment, { children: [_jsx(Text, { backgroundColor: TUI_THEME.rail, children: " " }), _jsx(Text, { backgroundColor: TUI_THEME.rail, color: TUI_THEME.warning, children: busyText })] })) : null] }));
@@ -363,13 +370,19 @@ function selectChatPlaceholder(terminalWidth, candidates) {
 function chatPlaceholderValueWidth(terminalWidth) {
     return Math.max(1, terminalWidth - (terminalWidth >= 10 ? 6 : 4));
 }
-export function chatBusyDisplayValue(terminalWidth) {
+export function chatBusyDisplayValue(terminalWidth, detachable = false, controllable = true) {
     if (terminalWidth < 14) {
         return "";
     }
     if (terminalWidth < 22) {
         return "busy";
     }
+    if (detachable && !controllable) {
+        return terminalWidth >= 34 ? "observing · ^C detach" : "^C detach";
+    }
+    if (terminalWidth >= 48 && detachable) {
+        return "working · Esc stop · ^C detach";
+    }
     if (terminalWidth >= 34) {
         return "working · Esc stop";
     }
@@ -596,10 +609,11 @@ function collaborationDetailInputHints(width) {
         { label: "e", detail: "" }
     ]);
 }
-function taskSessionsInputHints(width, includeArchived) {
+function taskSessionsInputHints(width, includeArchived, hasQuery) {
     const archivedAction = includeArchived ? "H hide archived" : "H archived";
+    const searchAction = hasQuery ? "^F edit · X clear" : "^F find";
     return selectInputHints(width, [
-        { label: "sessions", detail: ` · Up/Dn select · Enter restore · C conversations · I inspect · R rename · A archive · D delete · E export · ${archivedAction} · Esc back` },
+        { label: "sessions", detail: ` · Up/Dn select · Enter restore · C conversations · I inspect · R rename · A archive · D delete · E export · ${archivedAction} · Esc back · ${searchAction}` },
         { label: "sessions", detail: " · Up/Dn select · Enter restore · C conversations · I inspect · R rename · A archive · D delete · E export · Esc back" },
         { label: "sessions", detail: " · Up/Dn select · Enter restore · C chats · I inspect · R rename · A archive · D delete · Esc back" },
         { label: "sessions", detail: " · Up/Dn select · Enter restore · C chats · I inspect · R rename · A archive · Esc back" },