@deepseek-harness-tui/dsh-tui 0.8.8 → 0.9.1

package/lib/types/screens/Chat.js

@@ -1,12 +1,22 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React from 'react';
-import { t, getLang, setLang, isLang, writeLangPref, subscribeLang } from '../i18n.js';
+import { t, getLang, setLang, isLang, writeLangPref, readLangPref, subscribeLang, LANGS } from '../i18n.js';
+import { readThemePref } from '../themePrefs.js';
+import { readPresetPref } from '../presetPrefs.js';
+import { readModelPref } from '../modelPrefs.js';
+import { readActivityFrames } from '../activityPrefs.js';
+import { envThemeOverride } from '../components/design-system/ThemeProvider.js';
+import { hasPath } from '../dsh-adapter/settingsEditor.js';
+import { planReload } from '../reload.js';
 import { AlternateScreen, Box, Text, useInput, ScrollBox, useTheme, useTerminalSize } from '../ui.js';
 import * as tuiKit from '../ui.js';
 import { POINTER } from '../cc/figures.js';
-import { isMod, isPlainReturnInput, modLabel } from '../utils/modifiers.js';
+import { isPlainReturnInput, modLabel } from '../utils/modifiers.js';
+import { actionMatches } from '../utils/keymap.js';
 import { formatTokens } from '../cc/format.js';
 import { homeDir } from '../utils/paths.js';
+import { deriveModelGroups, modelPickerLanding, recentCatalogModels, RECENTS_GROUP_PROVIDER, } from '../modelGroups.js';
+import { readModelRecents, recordModelUse } from '../modelRecents.js';
 import { sessionCwdMatches } from '../dsh-adapter/channel.js';
 import { TuiDialogStore } from '../dsh-adapter/dialogs.js';
 import { TuiStatusStore } from '../dsh-adapter/status.js';
@@ -22,9 +32,13 @@ import { useCopyOnSelect } from '../ink/hooks/use-copy-on-select.js';
 import { useSelection } from '../ink/hooks/use-selection.js';
 import { NoSelect } from '../ink/components/NoSelect.js';
 import { LogoHeader, MessageList } from '../components/MessageList.js';
+import { TimelineRail } from '../components/TimelineRail.js';
+import { ScrollbarGutter } from '../components/ScrollbarGutter.js';
+import { normalizeScrollGutter } from '../tuiDisplayPrefs.js';
 import { OverlayAbove } from '../components/OverlayAbove.js';
 import { PromptInput } from '../components/PromptInput.js';
 import { GoalTodoPanel } from '../components/GoalTodoPanel.js';
+import { AutoRecapRow } from '../components/AutoRecapRow.js';
 import { LoadedContextPanel } from '../components/LoadedContextPanel.js';
 import { StatusLine } from './StatusLine.js';
 import { WorkingSpinner, useThinkingStatus } from '../components/WorkingSpinner.js';
@@ -33,12 +47,18 @@ import { ModelPicker } from '../components/ModelPicker.js';
 import { PluginSceneBoundary } from '../components/PluginSceneBoundary.js';
 import { SkillsPicker, SkillsPickerLoading } from '../components/SkillsPicker.js';
 import { SessionBrowser } from './SessionBrowser.js';
+import { SessionTree } from './SessionTree.js';
 import { Settings } from './Settings.js';
 import { WorkspacePicker } from '../components/WorkspacePicker.js';
+import { WorkspaceMenuPicker } from '../components/WorkspaceMenuPicker.js';
 import { WorkspaceFlowPicker } from '../components/WorkspaceFlowPicker.js';
 import { ActivityPicker } from '../components/ActivityPicker.js';
+import { ColorPicker } from '../components/ColorPicker.js';
 import { EffortSlider } from '../components/EffortSlider.js';
 import { PresetPicker } from '../components/PresetPicker.js';
+import { PermissionsPicker, PERMISSION_PRESET_IDS } from '../components/PermissionsPicker.js';
+import { PlanPicker } from '../components/PlanPicker.js';
+import { LangPicker } from '../components/LangPicker.js';
 import { ThemePicker, getThemeOptions } from '../components/ThemePicker.js';
 import { AUTO_THEME_NAME, getAutoThemeBase } from '../theme.js';
 import { FRAME_PRESETS, PRESET_NAMES } from '../components/activityFrames.js';
@@ -46,9 +66,15 @@ import { ThinkingToggle } from '../components/ThinkingToggle.js';
 import { HistorySearchDialog } from '../components/HistorySearchDialog.js';
 import { RewindPicker } from '../components/RewindPicker.js';
 import { BtwPanel } from '../components/BtwPanel.js';
+import { RecapPanel } from '../components/RecapPanel.js';
+import { isValidSessionColor, SESSION_COLOR_NAMES } from '../cc/sessionColors.js';
 import { TipsPanel } from '../components/TipsPanel.js';
 import { SubagentDashboard } from '../components/SubagentDashboard.js';
 import { SubagentDetailScene } from '../components/SubagentDetailScene.js';
+import { FileActionsPanel, FILE_ACTION_COUNT } from '../components/FileActionsPanel.js';
+import { openExternal, openFile, revealInFileManager } from '../utils/openExternal.js';
+import { fileUrlToPath, parseFileLinkUrl, resolveTargetPath } from '../utils/fileTarget.js';
+import { statSync } from 'node:fs';
 import { setClipboard } from '../ink/termio/osc.js';
 import { TerminalWriteContext } from '../ink/useTerminalNotification.js';
 import instances from '../ink/instances.js';
@@ -61,6 +87,7 @@ import { LoadingState } from '../components/design-system/LoadingState.js';
 import { Pane } from '../components/design-system/Pane.js';
 import { loadHistory } from '../history.js';
 import { formatLoadedContextReport } from '../utils/loaded-context.js';
+import { NO_OVERLAY, chatOverlayReducer, dialogOverlayVisible, wrapIndex, } from './chatOverlay.js';
 /** Shared empty snapshot for hosts whose channel has no event log. */
 const NO_EVENTS = [];
 /** Row kinds the message-selection cursor can land on. */
@@ -113,8 +140,11 @@ function searchableText(row) {
 }
 /**
  * Main chat screen in the Claude Code layout: a scrollable transcript
- * (with the current turn's prompt pinned above the viewport while scrolled
- * up), transient notifications, the working spinner, the bordered prompt
+ * (with the user message the viewport is showing pinned above the transcript
+ * while scrolled up, and a 1-column minimap scrollbar with one node per
+ * user message — the current message's node is highlighted, clicking a node
+ * jumps to it), transient notifications, the working spinner, the bordered
+ * prompt
  * input (with slash-command overlay) and the status line pinned at the
  * bottom.
  *
@@ -137,7 +167,7 @@ let fallbackApprovalStore;
  */
 let fallbackDialogStore;
 let fallbackStatusStore;
-export function Chat({ channel, questionStore, approvalStore, extensionDialogs, extensionStatus, extensionShortcuts, onExit, onUpdate, fullscreen = false, trajectorySeen: trajectorySeenProp, }) {
+export function Chat({ channel, questionStore, approvalStore, extensionDialogs, extensionStatus, extensionShortcuts, onExit, onUpdate, onRestart, fullscreen = false, trajectorySeen: trajectorySeenProp, }) {
     const writeRaw = React.useContext(TerminalWriteContext);
     // Re-render whenever the channel mutates; rows/status are read fresh below.
     React.useSyncExternalStore(channel.subscribe, () => channel.version);
@@ -188,70 +218,110 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     const [expanded, setExpanded] = React.useState(false);
     const [helpOpen, setHelpOpen] = React.useState(false);
     const [handle, setHandle] = React.useState(null);
+    /**
+     * Conversation timeline snapshot (reported by MessageList): one entry
+     * per user turn plus the viewport-derived navigation targets. The
+     * ACTIVE turn — the one whose content owns the viewport top row — pins
+     * the sticky prompt header AND highlights the transcript rail's tick,
+     * from one report so the two can never disagree; upId/downId drive the
+     * rail's ▲/▼. Null activeId while pinned to the bottom only when there
+     * are no turns (header hidden there anyway).
+     */
+    const [timeline, setTimeline] = React.useState({
+        turns: [],
+        activeId: null,
+        upId: null,
+        downId: null,
+    });
     const [selectionActive, setSelectionActive] = React.useState(false);
     const [selectedId, setSelectedId] = React.useState(null);
     const [expandedRows, setExpandedRows] = React.useState(() => new Set());
-    const [modelPickerOpen, setModelPickerOpen] = React.useState(false);
+    /** 流式 reasoning 行的用户折叠（点击/进入折叠态）。与 expandedRows 分开：
+     *  流式默认展开，用户点一下 = 折叠（preview ticker 或单行头）；落定后
+     *  默认折叠，此集合不再参与——两种默认互不翻转。 */
+    const [streamFoldedRows, setStreamFoldedRows] = React.useState(() => new Set());
+    /**
+     * The transient-dialog layer (every picker/dialog `<OverlayAbove>` hosts,
+     * plus /tips) as ONE value: mutual exclusion between the panels is
+     * structural instead of emerging from "an open picker makes the prompt
+     * inert". Transitions live in the pure reducer (chatOverlay.ts), which
+     * scripts/verify-chat-overlay.ts pins without a renderer. Async data the
+     * pickers show (model list, preset roster, …) stays in the caches below —
+     * it persists across open/close so a reopened picker paints the previous
+     * list while the fresh one loads, exactly as the boolean era did.
+     */
+    const [overlay, dispatchOverlay] = React.useReducer(chatOverlayReducer, NO_OVERLAY);
     const [models, setModels] = React.useState([]);
-    const [modelIndex, setModelIndex] = React.useState(0);
+    /** Provider display identities for the /model group level; refreshed alongside `models`. */
+    const [providerInfos, setProviderInfos] = React.useState([]);
+    /** /model 最近使用分组：成功切换即记录（去重置顶，上限 10），重启保留。 */
+    const [modelRecents, setModelRecents] = React.useState(() => readModelRecents());
+    /** Two-level /model: the drilled-in provider route; undefined = group level.
+     *  Reset on open; stale ids resolve back to the group level via `activeModelGroup`. */
+    const [modelGroup, setModelGroup] = React.useState(undefined);
+    /** True while the picker sits in the single-provider fast path (drilled in
+     *  at open, the group level never shown): Esc closes directly and no back
+     *  hint renders — a pinned recents pseudo-group must not fake a two-level
+     *  walk the user never saw (issue #527 regression: repro-picker-windowing). */
+    const [modelPickerDirect, setModelPickerDirect] = React.useState(false);
+    /** Group rows over the current catalog, first-appearance (registry) order,
+     *  with the pinned recents pseudo-group first when any entry is catalogued. */
+    const modelGroups = React.useMemo(() => deriveModelGroups(models, providerInfos, modelRecents), [models, providerInfos, modelRecents]);
+    /** The drilled-in group, but only while it still exists in the catalog. */
+    const activeModelGroup = modelGroup !== undefined && modelGroups.some(group => group.provider === modelGroup)
+        ? modelGroup
+        : undefined;
+    const groupModels = React.useMemo(() => {
+        if (activeModelGroup === undefined)
+            return [];
+        if (activeModelGroup === RECENTS_GROUP_PROVIDER)
+            return recentCatalogModels(modelRecents, models);
+        return models.filter(model => model.provider === activeModelGroup);
+    }, [models, modelRecents, activeModelGroup]);
+    /** Switch + record: every successful switch feeds the /model recents group
+     *  (picker Enter/click, `/model provider/id`, the wizard's live switch,
+     *  and /reload's applied model all ride this one path). */
+    const switchModelRecorded = (provider, id, name) => {
+        if (name !== undefined)
+            channel.notify(t('model-switching', { name }));
+        return channel.switchModel(provider, id).then((ok) => {
+            if (!ok)
+                return ok;
+            if (name !== undefined)
+                channel.notify(t('model-switched', { name }));
+            setModelRecents(recordModelUse({ provider, id }));
+            return ok;
+        });
+    };
     /** `/skills` 技能目录（issue #204）：null = 注册表快照在途。 */
-    const [skillsPickerOpen, setSkillsPickerOpen] = React.useState(false);
     const [skillsList, setSkillsList] = React.useState(null);
-    const [skillsIndex, setSkillsIndex] = React.useState(0);
     /** `/resume` opens the session browser, a screen rather than a panel. It
      *  owns its own selection, filters and keyboard — Chat only opens it. */
     const [browserOpen, setBrowserOpen] = React.useState(false);
+    /** `/tree` opens the session family tree (pi's Session Tree): every rewind
+     *  fork stitched back onto the message it diverged from, hover previews,
+     *  and per-node rewind/fork/adopt actions. Like the browser, a screen. */
+    const [treeOpen, setTreeOpen] = React.useState(false);
     /** `/settings` opens the plugin settings screen (issue #165) — like the
      *  browser, a screen rather than a panel: it owns its own focus, staged
      *  drafts and keyboard; Chat only opens it. */
     const [settingsOpen, setSettingsOpen] = React.useState(false);
-    const [workspacePickerOpen, setWorkspacePickerOpen] = React.useState(false);
     const [workspaceTargets, setWorkspaceTargets] = React.useState([]);
-    const [workspaceIndex, setWorkspaceIndex] = React.useState(0);
-    const [workspaceFlow, setWorkspaceFlow] = React.useState(null);
-    const [workspaceFlowIndex, setWorkspaceFlowIndex] = React.useState(0);
-    const [workspaceFlowBusy, setWorkspaceFlowBusy] = React.useState(false);
-    const [workspaceFlowInput, setWorkspaceFlowInput] = React.useState(null);
     const workspaceFlowRequestRef = React.useRef(0);
     const workspaceFlowAbortRef = React.useRef(null);
-    /** `/activity` indicator picker (pi extension's interactive select). */
-    const [activityPickerOpen, setActivityPickerOpen] = React.useState(false);
-    const [activityIndex, setActivityIndex] = React.useState(0);
-    /** `/preset` agent-preset picker (issue #8): roster list loads async. */
-    const [presetPickerOpen, setPresetPickerOpen] = React.useState(false);
+    /** `/preset` agent-preset roster (issue #8): loads async, persists. */
     const [presetOptions, setPresetOptions] = React.useState([]);
-    const [presetIndex, setPresetIndex] = React.useState(0);
-    /** `/effort` rheostat slider: adapter levels load async, focus moves ←/→. */
-    const [effortSliderOpen, setEffortSliderOpen] = React.useState(false);
+    /** `/effort` adapter levels: load async before the slider opens. */
     const [effortOptions, setEffortOptions] = React.useState([]);
-    const [effortIndex, setEffortIndex] = React.useState(0);
-    /** `/theme` color-theme picker (built-ins + ~/.dsh-tui/themes user themes). */
-    const [themePickerOpen, setThemePickerOpen] = React.useState(false);
-    const [themeIndex, setThemeIndex] = React.useState(0);
     const [themeName, setTheme] = useTheme();
     const { rows: terminalRows } = useTerminalSize();
     const [showAllMessages, setShowAllMessages] = React.useState(false);
+    /** Fold state for the GoalTodoPanel todo section (ctrl/cmd+q or click). */
+    const [todoCollapsed, setTodoCollapsed] = React.useState(false);
     const [thinkingVisible, setThinkingVisible] = React.useState(true);
-    const [thinkingOpen, setThinkingOpen] = React.useState(false);
-    const [thinkingFocus, setThinkingFocus] = React.useState(0);
-    /** ctrl+r history search dialog (ported from CC's HistorySearchDialog). */
-    const [historyOpen, setHistoryOpen] = React.useState(false);
-    const [historyQuery, setHistoryQuery] = React.useState('');
-    const [historyCursor, setHistoryCursor] = React.useState(0);
-    const [historyFocus, setHistoryFocus] = React.useState(0);
+    /** ctrl+r history-search entries (loaded on open, persists). */
     const [historyEntries, setHistoryEntries] = React.useState([]);
     const [historyFill, setHistoryFill] = React.useState(null);
-    /** Double-Esc rewind picker (CC rewind): open state + focused row + confirm. */
-    const [rewindOpen, setRewindOpen] = React.useState(false);
-    const [rewindIndex, setRewindIndex] = React.useState(0);
-    const [rewindConfirm, setRewindConfirm] = React.useState(null);
-    /** Plugin rewind modes (tui/rewind-prompt seam): extra choices offered in
-     *  the confirm pane; null = the plain conversation-only confirm. */
-    const [rewindModes, setRewindModes] = React.useState(null);
-    const [rewindModeIndex, setRewindModeIndex] = React.useState(0);
-    /** True while the tui/rewind-prompt decision is in flight (a plugin may be
-     *  showing its own dialog); keys except Esc are swallowed meanwhile. */
-    const [rewindBusy, setRewindBusy] = React.useState(false);
     /** Monotonic token: only the latest rewind decision may land (a slow
      *  plugin answering after the user moved on must not open a confirm for
      *  a row they are no longer looking at). */
@@ -265,8 +335,68 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         btwAbortRef.current = null;
         setBtw(null);
     };
-    /** /tips usage-tips overlay: pure UI state, no session side effects. */
-    const [tipsOpen, setTipsOpen] = React.useState(false);
+    /** /recap overlay (pi-recap semantics): pure UI state like /btw — the
+     *  summary never enters the transcript or session log; applying the
+     *  proposed title goes through the normal /rename path. `auto` marks the
+     *  recapOnOpen-triggered run (rendered as the dim AutoRecapRow until
+     *  expanded); `expanded` lifts an auto recap into the full RecapPanel;
+     *  `rowsAtTrigger` is the last user-row id when the auto run started —
+     *  a newer user row (the user starts a new message) retires the recap. */
+    const [recap, setRecap] = React.useState(null);
+    const recapAbortRef = React.useRef(null);
+    const closeRecap = () => {
+        recapAbortRef.current?.abort();
+        recapAbortRef.current = null;
+        setRecap(null);
+    };
+    // Auto-recap (`dsh-tui.recapOnOpen`): every time the session switches
+    // (mount = open/resume, rewind/fork included), summarize its tail into
+    // the dim AutoRecapRow. Failures stay silent in auto mode — `/recap`
+    // surfaces them; the summary never enters the transcript or session log.
+    const autoRecapSessionId = channel.agentId;
+    React.useEffect(() => {
+        // A session switch retires the previous recap outright — an old
+        // session's 回顾 has no place above a new conversation.
+        setRecap(null);
+        if (!channel.autoRecapOnOpen)
+            return;
+        // No conversation yet (/new): nothing to recap, don't even fire.
+        if (!channel.rows.some(row => row.kind === 'user' || row.kind === 'assistant'))
+            return;
+        recapAbortRef.current?.abort();
+        const controller = new AbortController();
+        recapAbortRef.current = controller;
+        const lastUserId = channel.rows.filter(row => row.kind === 'user').at(-1)?.id ?? -1;
+        setRecap({ raw: '', summary: '', error: undefined, done: false, titleApplied: false, auto: true, expanded: false, rowsAtTrigger: lastUserId });
+        void channel.recapRecent({
+            signal: controller.signal,
+            onText: delta => setRecap(prev => (prev ? { ...prev, raw: prev.raw + delta } : prev)),
+        }).then(result => {
+            if (controller.signal.aborted)
+                return;
+            setRecap(prev => {
+                if (prev === null || !prev.auto)
+                    return prev;
+                // Auto mode stays quiet on failure (no activity / llm missing / error).
+                if (result.summary === null)
+                    return null;
+                return { ...prev, summary: result.summary, title: result.title, error: result.error, done: true };
+            });
+        });
+        return () => controller.abort();
+    }, [autoRecapSessionId]);
+    // The user starts a new message → the auto recap has served its purpose
+    // (catching them up) and bows out. A newer user row is the signal; the
+    // assistant's own streamed rows don't count.
+    const lastUserRowId = channel.rows.filter(row => row.kind === 'user').at(-1)?.id ?? -1;
+    React.useEffect(() => {
+        if (recap !== null &&
+            recap.auto &&
+            recap.rowsAtTrigger !== undefined &&
+            lastUserRowId > recap.rowsAtTrigger) {
+            closeRecap();
+        }
+    }, [lastUserRowId, recap]);
     /** Subagent dashboard (Ctrl+A): displays active/completed subagents. */
     const [subagentDashboardOpen, setSubagentDashboardOpen] = React.useState(false);
     /** Detail view for a specific subagent (opened from dashboard). */
@@ -277,6 +407,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      */
     const [logoNonce, setLogoNonce] = React.useState(0);
     React.useEffect(() => () => btwAbortRef.current?.abort(), []);
+    React.useEffect(() => () => recapAbortRef.current?.abort(), []);
     /**
      * The trajectory scene (issue #80 evolution). Unlike every other overlay
      * here it is not a panel but a whole screen: while open, Chat renders the
@@ -321,8 +452,72 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         ink?.invalidatePrevFrame();
         ink?.reanchorViewport();
     }, []);
-    /** `/` transcript search (less-style incsearch, ported from CC's REPL). */
-    const [searchOpen, setSearchOpen] = React.useState(false);
+    /**
+     * Click-to-act targets: the Ink instance's hyperlink-open callback (wired
+     * in the effect below) resolves every clickable target the transcript
+     * renders — http(s) links open the browser, `dsh-file:`/`file://` paths
+     * open the file-action menu. `dsh-file:` payloads are RAW display paths
+     * (possibly relative), so they resolve against the CURRENT channel cwd
+     * at click time (read through a ref so this callback keeps a stable
+     * identity — it is threaded into memoized row components).
+     */
+    const cwdRef = React.useRef(channel.cwd);
+    React.useEffect(() => {
+        cwdRef.current = channel.cwd;
+    }, [channel.cwd]);
+    const openFileActions = React.useCallback((rawPath) => {
+        const resolved = resolveTargetPath(rawPath, cwdRef.current);
+        // Whether the target is a directory decides the first menu row's label
+        // ("open file" vs "open folder"). Missing paths count as files.
+        let isDir = false;
+        try {
+            isDir = statSync(resolved).isDirectory();
+        }
+        catch {
+            isDir = false;
+        }
+        dispatchOverlay({ type: 'open', overlay: { kind: 'file-actions', path: resolved, index: 0, isDir } });
+    }, []);
+    /** Run one file-action menu row: 0 = open file, 1 = reveal in file
+     *  manager, 2 = copy absolute path. */
+    const runFileAction = React.useCallback((index, path) => {
+        if (index === 0)
+            openFile(path);
+        else if (index === 1)
+            revealInFileManager(path);
+        else
+            void setClipboard(path);
+    }, []);
+    const handleOpenTarget = React.useCallback((url) => {
+        const rawPath = parseFileLinkUrl(url);
+        if (rawPath !== undefined) {
+            openFileActions(rawPath);
+            return;
+        }
+        const filePath = fileUrlToPath(url);
+        if (filePath !== undefined) {
+            openFileActions(filePath);
+            return;
+        }
+        openExternal(url);
+    }, [openFileActions]);
+    // Wire the click-to-open callback into the Ink instance (the field is
+    // otherwise never set — clicking links was a no-op). Re-wired whenever
+    // the handler changes (cwd moves), cleared on unmount.
+    React.useEffect(() => {
+        const ink = instances.get(process.stdout) ?? instances.values().next().value;
+        if (ink)
+            ink.onHyperlinkClick = handleOpenTarget;
+        return () => {
+            const current = instances.get(process.stdout) ?? instances.values().next().value;
+            if (current)
+                current.onHyperlinkClick = undefined;
+        };
+    }, [handleOpenTarget]);
+    /** `/` transcript search (less-style incsearch, ported from CC's REPL).
+     *  Only the bar's open/closed mode lives in `overlay`; the query and match
+     *  counters persist past the bar closing so n/N keep walking the matches. */
+    const searchActive = overlay.kind === 'search';
     const [searchQuery, setSearchQuery] = React.useState('');
     const [searchCursor, setSearchCursor] = React.useState(0);
     const [searchCount, setSearchCount] = React.useState(0);
@@ -353,7 +548,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 : -1;
         }
     }, [isSticky, channel.rows]);
-    const showPill = !isSticky && unseenCount > 0;
+    // The pill shows whenever the view is off the bottom (one-click return
+    // home): with unseen rows it counts them, otherwise it is the plain
+    // "return to bottom" affordance (Enter/End/click all land it).
+    const showPill = !isSticky;
     // Idle Ctrl+C: first press arms an exit, second press exits (CC's
     // double-press semantics, simplified). Under Windows ConPTY the key
     // arrives as stdin data (key.ctrl && input === 'c') — the useInput
@@ -423,26 +621,30 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     useTerminalTitle(`${titlePrefix} 🐋 ${channel.sessionTitle}`);
     const handleWorkspaceResult = (result) => {
         workspaceFlowAbortRef.current = null;
-        setWorkspaceFlowBusy(false);
-        setWorkspaceFlowInput(null);
         if (result.kind === 'target') {
-            setWorkspaceFlow(null);
+            dispatchOverlay({ type: 'close-if', kind: 'workspace-flow' });
             void channel.switchWorkspace(result.target);
             return;
         }
         if (result.choices.length === 0) {
-            setWorkspaceFlow(null);
+            dispatchOverlay({ type: 'close-if', kind: 'workspace-flow' });
             channel.notify(t('workspace-command-empty'));
             return;
         }
-        setWorkspaceFlow(result);
-        setWorkspaceFlowIndex(0);
+        // open-if: 'workspace-flow' stays allowed so an in-flow action can
+        // transition to its next stage; a picker the user opened after leaving
+        // the menu wins over a late command result.
+        dispatchOverlay({
+            type: 'open-if',
+            overlay: { kind: 'workspace-flow', flow: result, index: 0, busy: false, input: null },
+            when: ['none', 'workspace-flow'],
+        });
     };
     const runWorkspaceFlowAction = (action) => {
         const request = ++workspaceFlowRequestRef.current;
         const controller = new AbortController();
         workspaceFlowAbortRef.current = controller;
-        setWorkspaceFlowBusy(true);
+        dispatchOverlay({ type: 'flow-busy', busy: true });
         void Promise.resolve()
             .then(() => action(controller.signal))
             .then((result) => {
@@ -453,10 +655,25 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             if (request !== workspaceFlowRequestRef.current)
                 return;
             workspaceFlowAbortRef.current = null;
-            setWorkspaceFlowBusy(false);
+            dispatchOverlay({ type: 'flow-busy', busy: false });
             channel.notify(t('workspace-command-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
         });
     };
+    /** Bare `/workspace` menu rows: built-in subcommands first, then the
+     *  dynamically registered extensions (same reserved-name filter the Tab
+     *  completion applies). Recomputed per render — the extension list is
+     *  live. */
+    const workspaceMenuOptions = [
+        { id: 'resume', label: 'resume', description: t('workspace-menu-resume-desc') },
+        { id: 'rename', label: 'rename', description: t('workspace-menu-rename-desc') },
+        { id: 'open', label: 'open', description: t('workspace-menu-open-desc') },
+        // Optional call: verify/repro scripts and embedders stub the channel
+        // without the workspace-commands API — render must not throw for them
+        // (a thrown render unmounts the whole Ink root).
+        ...(channel.workspaceCommands?.() ?? [])
+            .filter(command => !['resume', 'rename', 'open'].includes(command.name.toLowerCase()))
+            .map(command => ({ id: command.name, label: command.name, description: command.description })),
+    ];
     const openWorkspaceTarget = (reference) => {
         void channel.resolveWorkspace(reference).then((target) => {
             if (target === undefined) {
@@ -475,12 +692,45 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 return;
             }
             setWorkspaceTargets(targets);
-            setWorkspaceIndex(Math.max(0, targets.findIndex(target => target.cwd === channel.cwd)));
-            setWorkspacePickerOpen(true);
+            // open-if: the listing is async — whatever the user opened meanwhile wins.
+            dispatchOverlay({
+                type: 'open-if',
+                overlay: {
+                    kind: 'workspace-picker',
+                    index: Math.max(0, targets.findIndex(target => target.cwd === channel.cwd)),
+                },
+                when: ['none'],
+            });
         }).catch((error) => {
             channel.notify(t('workspace-list-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error' });
         });
     };
+    /**
+     * Run one /workspace menu row (Enter path, shared with the mouse click):
+     * built-ins dispatch locally, extension commands go through the channel.
+     */
+    const runWorkspaceMenuOption = (option) => {
+        dispatchOverlay({ type: 'close-if', kind: 'workspace-menu' });
+        if (option === undefined)
+            return;
+        if (option.id === 'resume') {
+            openWorkspaceResume();
+        }
+        else if (option.id === 'rename') {
+            channel.notify(t('workspace-rename-usage'));
+        }
+        else if (option.id === 'open') {
+            channel.notify(t('workspace-open-usage'));
+        }
+        else {
+            void channel.runWorkspaceCommand(option.id, '').then((result) => {
+                if (result !== undefined)
+                    handleWorkspaceResult(result);
+            }).catch((error) => {
+                channel.notify(t('workspace-command-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            });
+        }
+    };
     /**
      * Dispatch a slash command; false lets the input flow to the model.
      * Built-in names run the local switch; anything registered by a DSH
@@ -488,6 +738,41 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      * result text lands as a notification. `rawInput` carries the text after
      * the command name (`/plan off` → ` off`).
      */
+    /** Localized display name of a sandbox mode id (`read-only` /
+     *  `workspace-write` / `danger-full-access`), for `/permission status`. */
+    const permissionPresetName = (id) => {
+        switch (id) {
+            case 'read-only': return t('permission-preset-readonly');
+            case 'workspace-write': return t('permission-preset-workspace-write');
+            case 'danger-full-access': return t('permission-preset-full-access');
+            default: return id ?? '—';
+        }
+    };
+    /** Hot-swap the UI language (`/lang <id>` and the LangPicker both land
+     *  here): persist to ~/.dsh-tui/lang.json and mirror into the dsh-tui
+     *  settings namespace when it is served (best effort). */
+    const applyLang = (lang) => {
+        const ok = writeLangPref(lang);
+        setLang(lang);
+        const settingsHost = channel.settingsHost();
+        const tuiView = settingsHost?.listNamespaces().find(entry => entry.ns === 'dsh-tui');
+        if (settingsHost !== undefined && tuiView !== undefined) {
+            void settingsHost
+                .write('dsh-tui', [{ op: 'set', path: ['lang'], value: lang }], tuiView.revision)
+                .catch(() => { });
+        }
+        channel.notify(ok ? t('lang-switched', { lang }) : t('lang-switch-failed', { lang }), { color: ok ? 'success' : 'error' });
+    };
+    /** Localized label of one /reload surface, for the change report. */
+    const reloadKindLabel = (kind) => {
+        switch (kind) {
+            case 'theme': return t('reload-kind-theme');
+            case 'lang': return t('reload-kind-lang');
+            case 'preset': return t('reload-kind-preset');
+            case 'model': return t('reload-kind-model');
+            case 'activity': return t('reload-kind-activity');
+        }
+    };
     const runCommand = (name, rawInput = '') => {
         switch (name) {
             case 'activity': {
@@ -524,8 +809,13 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     return true;
                 }
                 setHelpOpen(false);
-                setActivityIndex(Math.max(0, PRESET_NAMES.indexOf(channel.activityFrames ?? 'random')));
-                setActivityPickerOpen(true);
+                dispatchOverlay({
+                    type: 'open',
+                    overlay: {
+                        kind: 'activity',
+                        index: Math.max(0, PRESET_NAMES.indexOf(channel.activityFrames ?? 'random')),
+                    },
+                });
                 return true;
             }
             case 'preset': {
@@ -552,16 +842,26 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     return true;
                 }
                 setHelpOpen(false);
-                setPresetPickerOpen(true);
+                // The picker opens immediately over the cached roster (no loading
+                // pane — deliberate contrast with /model); the fresh list lands with
+                // the authoritative focus. Both loader writes are kind-guarded, so a
+                // picker the user already left is not resurrected or re-focused.
+                dispatchOverlay({
+                    type: 'open',
+                    overlay: {
+                        kind: 'preset',
+                        index: Math.max(0, presetOptions.findIndex(preset => preset.id === channel.agentPreset)),
+                    },
+                });
                 void channel.listPresets().then((list) => {
                     if (list.length === 0) {
-                        setPresetPickerOpen(false);
+                        dispatchOverlay({ type: 'close-if', kind: 'preset' });
                         channel.notify(t('preset-roster-unmounted'), { color: 'warning' });
                         return;
                     }
                     setPresetOptions(list);
                     const index = list.findIndex(preset => preset.id === channel.agentPreset);
-                    setPresetIndex(index >= 0 ? index : 0);
+                    dispatchOverlay({ type: 'set-index', kind: 'preset', index: index >= 0 ? index : 0 });
                 });
                 return true;
             }
@@ -592,16 +892,22 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     setEffortOptions(efforts);
                     const current = channel.reasoningEffort ?? defaultEffort;
                     const index = efforts.findIndex(effort => effort.id === current);
-                    setEffortIndex(index >= 0 ? index : 0);
-                    setEffortSliderOpen(true);
+                    // open-if: a picker the user opened during the round trip wins
+                    // over this late-arriving slider.
+                    dispatchOverlay({
+                        type: 'open-if',
+                        overlay: { kind: 'effort', index: index >= 0 ? index : 0 },
+                        when: ['none'],
+                    });
                 });
                 return true;
             }
             case 'lang': {
                 // `/lang` shows the current UI language, `/lang en|zh` switches
-                // (hot-swap, persisted to ~/.dsh-tui/lang.json). Precedence on next
-                // launch: DSH_TUI_LANG > settings.yaml `dsh-tui.lang` > cordis.yml
-                // `lang` > the persisted choice.
+                // (hot-swap, persisted to ~/.dsh-tui/lang.json), bare `/lang` opens
+                // the en/zh picker. Precedence on next launch: DSH_TUI_LANG >
+                // settings.yaml `dsh-tui.lang` > cordis.yml `lang` > the persisted
+                // choice.
                 const parts = rawInput.trim().split(/\s+/).filter(Boolean);
                 if (parts[0] === 'status') {
                     setHelpOpen(false);
@@ -615,19 +921,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 if (parts.length > 0) {
                     setHelpOpen(false);
                     if (isLang(parts[0])) {
-                        const ok = writeLangPref(parts[0]);
-                        setLang(parts[0]);
-                        // Mirror into the dsh-tui settings namespace when it is served,
-                        // so /settings and the next boot see the same last-write-wins
-                        // choice (best effort; lang.json stays the fallback).
-                        const settingsHost = channel.settingsHost();
-                        const tuiView = settingsHost?.listNamespaces().find(entry => entry.ns === 'dsh-tui');
-                        if (settingsHost !== undefined && tuiView !== undefined) {
-                            void settingsHost
-                                .write('dsh-tui', [{ op: 'set', path: ['lang'], value: parts[0] }], tuiView.revision)
-                                .catch(() => { });
-                        }
-                        channel.notify(ok ? t('lang-switched', { lang: parts[0] }) : t('lang-switch-failed', { lang: parts[0] }), { color: ok ? 'success' : 'error' });
+                        applyLang(parts[0]);
                     }
                     else {
                         channel.notify(t('lang-unknown', { lang: parts[0] }), { color: 'error' });
@@ -635,11 +929,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     return true;
                 }
                 setHelpOpen(false);
-                channel.pushLocal('/lang', [
-                    t('lang-current', { lang: getLang() }),
-                    t('lang-switch-hint'),
-                    t('lang-persist-hint'),
-                ]);
+                dispatchOverlay({
+                    type: 'open',
+                    overlay: { kind: 'lang', index: getLang() === 'zh' ? 0 : 1 },
+                });
                 return true;
             }
             case 'theme': {
@@ -672,15 +965,59 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     return true;
                 }
                 setHelpOpen(false);
-                setThemeIndex(Math.max(0, getThemeOptions().findIndex(option => option.value === themeName)));
-                setThemePickerOpen(true);
+                dispatchOverlay({
+                    type: 'open',
+                    overlay: {
+                        kind: 'theme',
+                        index: Math.max(0, getThemeOptions().findIndex(option => option.value === themeName)),
+                    },
+                });
+                return true;
+            }
+            case 'color': {
+                // `/color`（CC accent，按会话持久化）：无参打开调色板选择器，
+                // `/color <name>` 直接设置，`/color status` 显示当前，`/color
+                // reset` 清除回主题默认。颜色经 `session/color` 事件按会话保存
+                // ——resume/rewind 后仍是这个会话自己的颜色（见 channel.ts）。
+                setHelpOpen(false);
+                const parts = rawInput.trim().split(/\s+/).filter(Boolean);
+                if (parts.length === 0) {
+                    dispatchOverlay({
+                        type: 'open',
+                        overlay: {
+                            kind: 'color',
+                            index: Math.max(0, SESSION_COLOR_NAMES.indexOf(channel.sessionColor)),
+                        },
+                    });
+                    return true;
+                }
+                if (parts[0] === 'status') {
+                    channel.pushLocal('/color', [
+                        channel.sessionColor === ''
+                            ? t('color-current-none')
+                            : t('color-current', { name: channel.sessionColor }),
+                        t('color-usage', { list: SESSION_COLOR_NAMES.join('/') }),
+                    ]);
+                    return true;
+                }
+                if (parts[0] === 'reset') {
+                    channel.setSessionColor('');
+                    channel.notify(t('color-reset'));
+                    return true;
+                }
+                const colorName = parts[0].toLowerCase();
+                if (!isValidSessionColor(colorName)) {
+                    channel.notify(t('color-unknown', { name: colorName, list: SESSION_COLOR_NAMES.join(' · ') }), { color: 'error' });
+                    return true;
+                }
+                channel.setSessionColor(colorName);
+                channel.notify(t('color-set', { name: colorName }), { color: 'success' });
                 return true;
             }
             case 'new': {
                 // One-shot `/new` (issue #25): the old session stays persisted and
                 // is recoverable via /resume, so discarding the live view is
-                // non-destructive — no CC-style "press /new again" confirmation.
-                setHelpOpen(false);
+                // non-destructive — no CC-style "press /new again" confirmation.        setHelpOpen(false)
                 void channel.newSession().then((ok) => {
                     if (!ok)
                         return;
@@ -735,32 +1072,102 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             case 'help':
                 setHelpOpen(true);
                 return true;
-            case 'model':
+            case 'model': {
+                // `/model <provider/model>` switches directly (same live-fork path
+                // as the picker's Enter), bare `/model` opens the picker.
+                const parts = rawInput.trim().split(/\s+/).filter(Boolean);
+                if (parts.length > 0) {
+                    setHelpOpen(false);
+                    const spec = parts[0];
+                    const slash = spec.indexOf('/');
+                    const provider = slash >= 0 ? spec.slice(0, slash) : undefined;
+                    const id = slash >= 0 ? spec.slice(slash + 1) : spec;
+                    if (provider === undefined || id.length === 0 || provider.length === 0) {
+                        channel.notify(t('model-usage'), { color: 'warning' });
+                        return true;
+                    }
+                    void channel.listModels().then((list) => {
+                        const model = list.find(m => m.provider === provider && m.id === id);
+                        if (model === undefined) {
+                            channel.notify(t('model-unknown', { spec }), { color: 'error', timeoutMs: 8000 });
+                            return;
+                        }
+                        void switchModelRecorded(provider, id, model.name);
+                    });
+                    return true;
+                }
                 setHelpOpen(false);
-                setModelPickerOpen(true);
+                // Opens over the cached catalog (empty cache shows the loading
+                // pane); the fresh list lands with the authoritative focus, and the
+                // kind-guarded set-index cannot re-focus a picker the user left.
+                // Seed-on-open: the model in use IS a use — recording it here means
+                // the recents group exists before the first post-update switch, and
+                // switching A→B keeps A in the list (the file records what was
+                // used, not only switches made after the file appeared).
+                let recentsNow = modelRecents;
+                if (channel.provider !== '' && channel.model !== ''
+                    && !recentsNow.some(ref => ref.provider === channel.provider && ref.id === channel.model)) {
+                    recentsNow = recordModelUse({ provider: channel.provider, id: channel.model });
+                    setModelRecents(recentsNow);
+                }
+                // Two-level landing: recents (when catalogued) focus their pinned
+                // row; else multi-provider catalogs focus the current provider's
+                // group row; a single-provider catalog without a meaningful recents
+                // list drills straight into its model list (pre-grouping UX).
+                {
+                    const landing = modelPickerLanding(models, channel.provider, channel.model, recentsNow);
+                    setModelGroup(landing.group);
+                    setModelPickerDirect(landing.group !== undefined);
+                    dispatchOverlay({ type: 'open', overlay: { kind: 'model', index: landing.index } });
+                }
                 void channel.listModels().then((list) => {
                     setModels(list);
-                    const index = list.findIndex(model => model.provider === channel.provider && model.id === channel.model);
-                    setModelIndex(index >= 0 ? index : 0);
+                    const landing = modelPickerLanding(list, channel.provider, channel.model, recentsNow);
+                    setModelGroup(landing.group);
+                    setModelPickerDirect(landing.group !== undefined);
+                    dispatchOverlay({ type: 'set-index', kind: 'model', index: landing.index });
                 });
+                void channel.listProviders().then(setProviderInfos).catch(() => setProviderInfos([]));
                 return true;
-            case 'skills':
+            }
+            case 'skills': {
                 // issue #204: 列出当前 agent 的完整技能目录（名称 + 来源 + 简述），
                 // Enter 把可直调技能以 `/name ` 填回输入行（completion-only 分发的
                 // 同一路径）。注册表读取走 channel（快照 scoped 到 live agent）。
+                // `/skills <name>` 直达同一个填回动作，跳过选择器。
+                const parts = rawInput.trim().split(/\s+/).filter(Boolean);
+                if (parts.length > 0) {
+                    setHelpOpen(false);
+                    void channel.listSkills().then((list) => {
+                        if (list === undefined) {
+                            channel.notify(t('skills-load-failed'), { color: 'error' });
+                            return;
+                        }
+                        const skill = list.find(s => s.name === parts[0]);
+                        if (skill === undefined) {
+                            channel.notify(t('skills-unknown', { name: parts[0] }), { color: 'error' });
+                            return;
+                        }
+                        if (skill.userInvocable)
+                            setHistoryFill(`/${skill.name} `);
+                        else
+                            channel.notify(t('skills-not-invocable', { name: parts[0] }), { color: 'warning' });
+                    });
+                    return true;
+                }
                 setHelpOpen(false);
                 setSkillsList(null);
-                setSkillsIndex(0);
-                setSkillsPickerOpen(true);
+                dispatchOverlay({ type: 'open', overlay: { kind: 'skills', index: 0 } });
                 void channel.listSkills().then((list) => {
                     if (list === undefined) {
-                        setSkillsPickerOpen(false);
+                        dispatchOverlay({ type: 'close-if', kind: 'skills' });
                         channel.notify(t('skills-load-failed'), { color: 'error' });
                         return;
                     }
                     setSkillsList(list);
                 });
                 return true;
+            }
             case 'provider': {
                 // Interactive add-provider wizard (/provider): drives the shared
                 // question panel, persists profile + key via the channel's settings/
@@ -777,7 +1184,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     notify: (text, options) => channel.notify(text, options),
                     pushLocal: (title, lines) => channel.pushLocal(title, lines),
                     working: () => channel.working,
-                    switchModel: (provider, model) => channel.switchModel(provider, model),
+                    switchModel: (provider, model) => switchModelRecorded(provider, model),
                 }).catch(() => {
                     // The wizard notifies on every handled failure; this only swallows
                     // an unexpected reject so it never surfaces as an unhandled promise.
@@ -786,8 +1193,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             case 'thinking':
                 setHelpOpen(false);
-                setThinkingOpen(true);
-                setThinkingFocus(thinkingVisible ? 0 : 1);
+                dispatchOverlay({
+                    type: 'open',
+                    overlay: { kind: 'thinking', focus: thinkingVisible ? 0 : 1 },
+                });
                 return true;
             case 'tokens': {
                 const usage = t('tokens-usage', { in: formatTokens(channel.tokens.input), out: formatTokens(channel.tokens.output) });
@@ -815,10 +1224,9 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 const subcommand = (separator < 0 ? trimmed : trimmed.slice(0, separator)).toLowerCase();
                 const input = separator < 0 ? '' : trimmed.slice(separator).trim();
                 if (subcommand === '') {
-                    const extensions = channel.workspaceCommands()
-                        .map(command => ` | ${command.name}`)
-                        .join('');
-                    channel.pushLocal('/workspace', [t('workspace-command-usage', { commands: extensions })]);
+                    // Bare `/workspace` opens the action menu (resume / rename / open
+                    // plus any registered extensions) instead of a text usage line.
+                    dispatchOverlay({ type: 'open', overlay: { kind: 'workspace-menu', index: 0 } });
                 }
                 else if (subcommand === 'resume') {
                     openWorkspaceResume();
@@ -869,6 +1277,21 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 setHelpOpen(false);
                 openRewind();
                 return true;
+            case 'tree': {
+                // The session family tree (pi's Session Tree): every fork branch
+                // stitched back, hover previews, per-node rewind/fork/adopt.
+                setHelpOpen(false);
+                setTreeOpen(true);
+                return true;
+            }
+            case 'fork': {
+                // Tip fork (kimi-code semantics): a persisted copy of the whole
+                // conversation the user enters via /resume — the live session and
+                // its running turn stay untouched.
+                setHelpOpen(false);
+                void channel.forkSession();
+                return true;
+            }
             case 'exit':
             case 'quit':
             case 'q':
@@ -972,12 +1395,16 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 setHelpOpen(false);
                 void channel.describeCredential('DEEPSEEK_API_KEY')
                     .catch(() => undefined)
-                    .then(status => {
+                    .then(async (status) => {
                     const keyStatus = status === undefined
                         ? t('login-credentials-unavailable')
                         : status.configured
                             ? t('login-key-configured', { ref: 'DEEPSEEK_API_KEY' })
                             : t('login-key-missing');
+                    // OAuth account states ride along only while a dsh-auth-style
+                    // plugin is mounted; absent it the lines below are exactly the
+                    // pre-plugin set.
+                    const oauth = await channel.oauthProviderStatuses().catch(() => undefined);
                     channel.pushLocal('/login', [
                         t('login-api-key', { status: keyStatus }),
                         ...(status === undefined
@@ -989,6 +1416,20 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                                 }),
                             ]),
                         t('login-base-url', { url: process.env.DEEPSEEK_BASE_URL ?? t('login-official-endpoint') }),
+                        ...(oauth === undefined
+                            ? []
+                            : [
+                                t('login-oauth-heading'),
+                                ...oauth.map(row => t('login-oauth-row', {
+                                    provider: row.provider,
+                                    state: row.signedIn
+                                        ? t('login-oauth-in', { time: new Date(row.expiresAt ?? 0).toISOString() })
+                                        : row.expired
+                                            ? t('login-oauth-expired')
+                                            : t('login-oauth-signed-out'),
+                                })),
+                                t('login-oauth-hint'),
+                            ]),
                     ]);
                 });
                 return true;
@@ -996,25 +1437,87 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             case 'logout':
                 channel.notify(t('login-logout-hint'));
                 return true;
-            case 'permissions':
-                setHelpOpen(false);
-                channel.pushLocal('/permissions', [
-                    t('permissions-policy-hint'),
-                    t('permissions-approval-hint'),
-                    // /permission comes from the dsh-base permission-presets row via the
-                    // commands registry; only advertise it when this composition
-                    // actually mounted it (the bare cordis.yml leaf has no
-                    // permission-presets, so the command does not exist there).
-                    ...(channel.commandList.some(command => command.name === 'permission')
-                        ? [t('permissions-preset-hint')]
-                        : []),
-                ]);
-                return true;
+            case 'permission': {
+                // The command itself is registered by dsh-sandbox-policy (dsh-base
+                // permission-presets row): bare `/permission` opens the preset
+                // picker (read-only / workspace-write / danger-full-access) and
+                // Enter dispatches `/permission <preset>` through the same
+                // external-command path a hand-typed argument takes. `/permission
+                // status` prints the policy explainer (absorbed from the removed
+                // `/permissions` command); other arguments pass through verbatim.
+                // When the row is not mounted the default external path (or the
+                // model, when nothing is registered) wins.
+                const mounted = channel.commandList.some(command => command.external && command.name === 'permission');
+                const parts = rawInput.trim().split(/\s+/).filter(Boolean);
+                if (mounted && parts[0] === 'status') {
+                    setHelpOpen(false);
+                    channel.pushLocal('/permission', [
+                        t('permission-current', { name: permissionPresetName(channel.mode.sandbox) }),
+                        t('permission-policy-hint'),
+                        t('permission-approval-hint'),
+                        t('permission-root-hint', { cwd: channel.cwd }),
+                        t('permission-path-hint'),
+                    ]);
+                    return true;
+                }
+                if (mounted && parts.length === 0) {
+                    setHelpOpen(false);
+                    const index = PERMISSION_PRESET_IDS.indexOf(channel.mode.sandbox ?? '');
+                    dispatchOverlay({
+                        type: 'open',
+                        overlay: { kind: 'permission', index: index >= 0 ? index : 1 },
+                    });
+                    return true;
+                }
+                if (mounted) {
+                    setHelpOpen(false);
+                    void channel.runExternalCommand('permission', rawInput).then((text) => {
+                        if (text !== undefined && text !== '') {
+                            channel.notify(text);
+                        }
+                        else if (text === undefined) {
+                            channel.notify(t('command-not-found', { name: 'permission' }), { color: 'error' });
+                        }
+                    });
+                    return true;
+                }
+                return false;
+            }
+            case 'plan': {
+                // Registered by dsh-plan-mode: bare `/plan` opens an on/off picker
+                // marked with the current state instead of toggling blindly; Enter
+                // dispatches `/plan` or `/plan off`. Arguments pass through verbatim
+                // (`/plan off`), and an unmounted row falls back to the default
+                // external path.
+                const mounted = channel.commandList.some(command => command.external && command.name === 'plan');
+                const parts = rawInput.trim().split(/\s+/).filter(Boolean);
+                if (mounted && parts.length === 0) {
+                    setHelpOpen(false);
+                    dispatchOverlay({
+                        type: 'open',
+                        overlay: { kind: 'plan', index: channel.mode.plan === true ? 0 : 1 },
+                    });
+                    return true;
+                }
+                if (mounted) {
+                    setHelpOpen(false);
+                    void channel.runExternalCommand('plan', rawInput).then((text) => {
+                        if (text !== undefined && text !== '') {
+                            channel.notify(text);
+                        }
+                        else if (text === undefined) {
+                            channel.notify(t('command-not-found', { name: 'plan' }), { color: 'error' });
+                        }
+                    });
+                    return true;
+                }
+                return false;
+            }
             case 'add-dir':
                 setHelpOpen(false);
                 channel.pushLocal('/add-dir', [
-                    t('permissions-root-hint', { cwd: channel.cwd }),
-                    t('permissions-path-hint'),
+                    t('permission-root-hint', { cwd: channel.cwd }),
+                    t('permission-path-hint'),
                 ]);
                 return true;
             case 'hooks':
@@ -1041,6 +1544,100 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     onUpdate();
                 }
                 return true;
+            case 'reload': {
+                // pi-style soft reload: re-read the persisted preference files
+                // (~/.dsh-tui/{theme,lang,agent-preset,model,working-activity}.json)
+                // and re-apply live, honoring the boot-time precedence (env >
+                // cordis.yml > settings user layer > pref). The dsh-tui settings
+                // namespace is NOT re-read here — its watch applies edits live and
+                // the platform watcher hot-reloads settings.yaml itself. What no
+                // reload can re-read (cordis.yml root config, frozen fullscreen,
+                // newly built code) is listed in the footer and served by /restart.
+                setHelpOpen(false);
+                const tuiNamespace = channel.settingsHost()
+                    ?.listNamespaces()
+                    .find(entry => entry.ns === 'dsh-tui');
+                const plan = planReload({
+                    envTheme: envThemeOverride(),
+                    envLang: isLang(process.env.DSH_TUI_LANG) ? process.env.DSH_TUI_LANG : undefined,
+                    themePref: readThemePref(),
+                    currentTheme: themeName,
+                    langPref: readLangPref(),
+                    currentLang: getLang(),
+                    langOverriddenBySettings: tuiNamespace !== undefined && hasPath(tuiNamespace.user, ['lang']),
+                    configuredLang: channel.configuredLang,
+                    configuredPreset: channel.configuredPreset,
+                    presetPref: readPresetPref(),
+                    currentPreset: channel.agentPreset,
+                    configuredModel: {
+                        provider: channel.configuredProvider,
+                        model: channel.configuredModel,
+                    },
+                    modelPref: readModelPref(),
+                    currentModel: { provider: channel.provider, model: channel.model },
+                    configuredActivity: channel.configuredActivityFrames,
+                    activityPref: readActivityFrames(),
+                    currentActivity: channel.activityFrames,
+                });
+                for (const item of plan.apply) {
+                    switch (item.kind) {
+                        case 'theme':
+                            setTheme(item.to);
+                            break;
+                        case 'lang':
+                            applyLang(item.to);
+                            break;
+                        case 'preset':
+                            void channel.switchPreset(item.to);
+                            break;
+                        case 'model':
+                            if (item.route !== undefined) {
+                                void switchModelRecorded(item.route.provider, item.route.model);
+                            }
+                            break;
+                        case 'activity':
+                            channel.setActivityFrames(item.to);
+                            break;
+                    }
+                }
+                const lines = [t('reload-header')];
+                for (const item of plan.apply) {
+                    lines.push(t('reload-applied', {
+                        kind: reloadKindLabel(item.kind),
+                        from: item.from,
+                        to: item.to,
+                    }));
+                }
+                for (const kind of plan.unchanged) {
+                    lines.push(t('reload-unchanged', { kind: reloadKindLabel(kind) }));
+                }
+                for (const skip of plan.skipped) {
+                    const key = skip.reason === 'env-wins'
+                        ? 'reload-skipped-env'
+                        : skip.reason === 'config-wins' ? 'reload-skipped-config' : 'reload-skipped-invalid';
+                    lines.push(t(key, { kind: reloadKindLabel(skip.kind) }));
+                }
+                lines.push(t('reload-footer'));
+                channel.pushLocal('/reload', lines);
+                return true;
+            }
+            case 'restart':
+                // pi-style reload tail: /reload cannot re-read boot-time-only state
+                // (cordis.yml root config, frozen fullscreen layout, newly built
+                // code), so /restart respawns the process with the original argv and
+                // resumes this session — the /update handoff minus the pnpm step.
+                setHelpOpen(false);
+                if (onRestart === undefined) {
+                    channel.notify(t('restart-unavailable'), { color: 'warning' });
+                }
+                else if (channel.working) {
+                    channel.notify(t('update-working'), { color: 'warning' });
+                }
+                else {
+                    channel.notify(t('restart-starting'));
+                    onRestart();
+                }
+                return true;
             case 'vim':
                 channel.notify(t('vim-not-implemented'));
                 return true;
@@ -1051,6 +1648,33 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     t('terminal-paste-hint', { mod: modLabel }),
                 ]);
                 return true;
+            case 'recap': {
+                // `/recap`（pi-recap 语义）：对会话最近活动做一次无工具单轮
+                // 调用，生成一行摘要 + 建议标题。摘要是纯 UI 状态（不进 transcript
+                // 也不进 session log）；建议标题经「应用」按钮走 /rename 路径。
+                setHelpOpen(false);
+                recapAbortRef.current?.abort();
+                const controller = new AbortController();
+                recapAbortRef.current = controller;
+                setRecap({ raw: '', summary: '', error: undefined, done: false, titleApplied: false, auto: false, expanded: true });
+                void channel.recapRecent({
+                    signal: controller.signal,
+                    onText: delta => setRecap(prev => (prev ? { ...prev, raw: prev.raw + delta } : prev)),
+                }).then(result => {
+                    if (controller.signal.aborted)
+                        return;
+                    setRecap(prev => (prev
+                        ? {
+                            ...prev,
+                            summary: result.summary ?? prev.raw,
+                            title: result.title,
+                            error: result.error,
+                            done: true,
+                        }
+                        : prev));
+                });
+                return true;
+            }
             case 'btw': {
                 // CC /btw：单轮无工具侧问，overlay 态纯 UI，不打断主回合、不写
                 // 会话历史。空参数只提示用法。
@@ -1088,7 +1712,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             case 'tips':
                 setHelpOpen(false);
-                setTipsOpen(true);
+                dispatchOverlay({ type: 'open', overlay: { kind: 'tips' } });
                 return true;
             case 'connect':
                 setHelpOpen(false);
@@ -1142,6 +1766,9 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         ? channel.rows.filter(row => SELECTABLE_KINDS.has(row.kind))
         : NO_ROWS;
     // ctrl+r history search: substring match on the query, newest first.
+    // The draft lives in the overlay variant; the derived '' while closed
+    // keeps the memo inputs stable (nothing renders the matches then).
+    const historyQuery = overlay.kind === 'history' ? overlay.query : '';
     const historyMatches = React.useMemo(() => {
         const q = historyQuery.trim().toLowerCase();
         return q ? historyEntries.filter(e => e.text.toLowerCase().includes(q)) : historyEntries;
@@ -1150,15 +1777,15 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // selectable user turns; steering side-questions are excluded). Computed
     // per render while the picker is open — `channel.rows` is a live in-place
     // array (see selectableRows).
-    const rewindRows = rewindOpen
+    const rewindRows = overlay.kind === 'rewind'
         ? channel.rows
             .filter(row => row.kind === 'user' && row.label === undefined)
             .reverse()
         : NO_ROWS;
     /** Open the rewind picker (from PromptInput's double-Esc on an empty input). */
     const openRewind = () => {
-        // rewindOpen is still false this render, so rewindRows is empty — scan
-        // directly instead of reading the gated list.
+        // The overlay is not 'rewind' yet this render, so rewindRows is empty —
+        // scan directly instead of reading the gated list.
         const candidates = channel.rows
             .filter(row => row.kind === 'user' && row.label === undefined)
             .reverse();
@@ -1166,12 +1793,11 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             channel.notify(t('rewind-none'));
             return;
         }
-        setRewindIndex(0);
-        setRewindConfirm(null);
-        setRewindModes(null);
-        setRewindBusy(false);
         rewindRequestRef.current += 1;
-        setRewindOpen(true);
+        dispatchOverlay({
+            type: 'open',
+            overlay: { kind: 'rewind', index: 0, confirm: null, modes: null, modeIndex: 0, busy: false },
+        });
     };
     /**
      * Enter on a rewind candidate: ask the plugins first (tui/rewind-prompt).
@@ -1180,16 +1806,15 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
      */
     const requestRewindConfirm = async (row) => {
         const token = ++rewindRequestRef.current;
-        setRewindBusy(true);
+        dispatchOverlay({ type: 'rewind-busy', busy: true });
         const decision = await channel.promptRewind(row);
         if (token !== rewindRequestRef.current)
             return;
-        setRewindBusy(false);
-        if (decision === 'cancel')
+        if (decision === 'cancel') {
+            dispatchOverlay({ type: 'rewind-busy', busy: false });
             return;
-        setRewindConfirm(row);
-        setRewindModes(decision?.modes ?? null);
-        setRewindModeIndex(0);
+        }
+        dispatchOverlay({ type: 'rewind-decision', confirm: row, modes: decision?.modes ?? null });
     };
     /** Execute the confirmed rewind; the message comes back into the input. */
     const performRewind = async (row, mode = null) => {
@@ -1277,13 +1902,31 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         }
         setForceMountRowId(rowId);
     };
+    /**
+     * Reveal-and-seek for a row folded behind the recent-rows window (the
+     * rail's tick for an old turn, the doc's revealAndSeekRow): expand the
+     * fold first, then the ordinary seek takes over — the completion effect
+     * below force-mounts the row and scrollToElement lands it once its ref
+     * (and Yoga top) exist. The fold toggle is idempotent, so calling this
+     * for an already-revealed row is harmless.
+     */
+    const revealAndSeekRow = (rowId) => {
+        if (!showAllMessages)
+            setShowAllMessages(true);
+        seekRow(rowId);
+    };
     React.useLayoutEffect(() => {
         if (forceMountRowId === null)
             return;
         const el = rowRefsRef.current.get(forceMountRowId);
         if (el) {
             handle?.scrollToElement(el);
-            setForceMountRowId(null);
+            // Clear deferred to a macrotask: clearing here would let React's
+            // synchronous re-render narrow the virtualization window and unmount
+            // the row BEFORE the renderer's deferred pass reads its Yoga top
+            // (scrollAnchor processing runs in a microtask) — the seek would
+            // silently no-op (detached anchor element).
+            setTimeout(() => setForceMountRowId(null), 0);
         }
     });
     // `/` transcript search: rows whose searchable text contains the query.
@@ -1300,7 +1943,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
     // Incsearch: highlight all matches (screen-space overlay) and keep the
     // current match row in view as the query changes (CC semantics).
     React.useEffect(() => {
-        if (!searchOpen)
+        if (!searchActive)
             return;
         setHighlight(searchQuery);
         const count = searchMatches.length;
@@ -1312,10 +1955,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         if (target) {
             seekRow(target.row.id);
         }
-    }, [searchQuery, searchOpen]);
+    }, [searchQuery, searchActive]);
     // n/N navigation: move the current match into view.
     React.useEffect(() => {
-        if (!searchOpen)
+        if (!searchActive)
             return;
         const target = searchMatches[searchCurrent];
         // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty/filtered list
@@ -1352,6 +1995,16 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             return next;
         });
     }, []);
+    const toggleStreamFolded = React.useCallback((rowId) => {
+        setStreamFoldedRows((previous) => {
+            const next = new Set(previous);
+            if (next.has(rowId))
+                next.delete(rowId);
+            else
+                next.add(rowId);
+            return next;
+        });
+    }, []);
     const registerRowRef = React.useCallback((rowId, el) => {
         if (el)
             rowRefsRef.current.set(rowId, el);
@@ -1372,6 +2025,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // search box, which Chat would otherwise route into the prompt.
         if (browserOpen)
             return;
+        // Same for the session tree: plain letters drive its search, clicks and
+        // Enter drive its action menu.
+        if (treeOpen)
+            return;
         // Same for the settings screen: plain letters (s save / d discard) and
         // the field draft editor belong to it alone.
         if (settingsOpen)
@@ -1388,13 +2045,30 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // Mouse wheel scrolls the transcript even while a question/approval/
         // dialog panel is open — those panels own arrow/Enter/Esc keys, but the
         // transcript above them should still be scrollable in fullscreen mode.
-        // Help is different: its own ScrollBox owns wheel input, so Chat must
-        // yield before stopping propagation or both covered layers would move.
+        //
+        // Wheel routing is position-first: events landing over a ScrollBox
+        // (transcript, help, subagent panels…) are consumed by that box in
+        // App's input batch (onWheelAt) and never reach this branch. What
+        // arrives here is the fallback: wheel over non-scroll areas (prompt,
+        // status bar) or over floating overlays.
+        //   - Help stays yielded: PromptInput's help ScrollBox handles the
+        //     remaining global wheel while help is open (both covered layers
+        //     must not move).
+        //   - Pickers/dialogs are modal: wheel that fell through over them
+        //     must NOT scroll the transcript behind (the audit's
+        //     pass-through gap), so yield like the keyboard guards above.
         // Events only arrive with mouse tracking on; inline mode never sees
         // them, so this is a no-op there.
         if (key.wheelUp || key.wheelDown) {
             if (helpOpen)
                 return;
+            // Any open transient dialog is modal to the wheel; the one exception
+            // mirrors the render gate — a workspace picker whose target list has
+            // not landed paints nothing, so wheel-through keeps scrolling.
+            const overlayModal = overlay.kind !== 'none' &&
+                (overlay.kind !== 'workspace-picker' || workspaceTargets.length > 0);
+            if (overlayModal)
+                return;
             handle?.scrollBy(key.wheelUp ? -3 : 3);
             event.stopImmediatePropagation();
             return;
@@ -1424,11 +2098,11 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             event.stopImmediatePropagation();
             return;
         }
-        if (searchOpen) {
+        if (overlay.kind === 'search') {
             // Transcript search bar (less-style): edit the query, Enter commits
             // (query persists for n/N), Esc/ctrl+c cancels back to the anchor.
             if (key.escape || (key.ctrl && input === 'c')) {
-                setSearchOpen(false);
+                dispatchOverlay({ type: 'close' });
                 setHighlight('');
                 handle?.scrollTo(searchAnchorRef.current);
             }
@@ -1436,7 +2110,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 // Enter commits; 0-match junk queries don't persist (CC behavior).
                 if (searchCount === 0)
                     setSearchQuery('');
-                setSearchOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             else if (key.backspace) {
                 if (searchCursor > 0) {
@@ -1482,41 +2156,41 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             event.stopImmediatePropagation();
             return;
         }
-        if (thinkingOpen) {
+        if (overlay.kind === 'thinking') {
             if (key.upArrow || key.downArrow) {
-                setThinkingFocus(index => (index === 0 ? 1 : 0));
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: 2 });
             }
             else if (plainReturn) {
-                const visible = thinkingFocus === 0;
+                const visible = overlay.focus === 0;
                 setThinkingVisible(visible);
-                setThinkingOpen(false);
+                dispatchOverlay({ type: 'close' });
                 channel.notify(t('thinking-toggled', { state: visible ? t('thinking-on') : t('thinking-off') }));
             }
             else if (key.escape) {
-                setThinkingOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (workspaceFlow !== null) {
+        if (overlay.kind === 'workspace-flow') {
+            const { flow, busy, input: flowInput } = overlay;
             if (key.escape) {
-                if (workspaceFlowInput !== null && !workspaceFlowBusy) {
-                    setWorkspaceFlowInput(null);
+                if (flowInput !== null && !busy) {
+                    dispatchOverlay({ type: 'flow-input', input: null });
                     return;
                 }
                 workspaceFlowAbortRef.current?.abort();
                 workspaceFlowAbortRef.current = null;
                 workspaceFlowRequestRef.current += 1;
-                setWorkspaceFlowBusy(false);
-                setWorkspaceFlow(null);
+                dispatchOverlay({ type: 'close' });
                 return;
             }
-            if (workspaceFlowBusy)
+            if (busy)
                 return;
-            if (workspaceFlowInput !== null) {
-                const choice = workspaceFlow.choices.find(candidate => candidate.id === workspaceFlowInput.choiceId);
+            if (flowInput !== null) {
+                const choice = flow.choices.find(candidate => candidate.id === flowInput.choiceId);
                 const editor = choice?.input;
                 if (plainReturn) {
-                    const value = workspaceFlowInput.value.trim();
+                    const value = flowInput.value.trim();
                     if (value.length === 0) {
                         channel.notify(t('workspace-flow-input-empty'), { color: 'warning' });
                     }
@@ -1524,127 +2198,158 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                         runWorkspaceFlowAction(signal => editor.submit(value, signal));
                     }
                 }
-                else if (key.backspace && workspaceFlowInput.cursor > 0) {
-                    setWorkspaceFlowInput(current => current === null ? null : {
-                        ...current,
-                        value: current.value.slice(0, current.cursor - 1) + current.value.slice(current.cursor),
-                        cursor: current.cursor - 1,
+                else if (key.backspace && flowInput.cursor > 0) {
+                    dispatchOverlay({
+                        type: 'flow-input-edit',
+                        value: flowInput.value.slice(0, flowInput.cursor - 1) + flowInput.value.slice(flowInput.cursor),
+                        cursor: flowInput.cursor - 1,
                     });
                 }
-                else if (key.delete && workspaceFlowInput.cursor < workspaceFlowInput.value.length) {
-                    setWorkspaceFlowInput(current => current === null ? null : {
-                        ...current,
-                        value: current.value.slice(0, current.cursor) + current.value.slice(current.cursor + 1),
+                else if (key.delete && flowInput.cursor < flowInput.value.length) {
+                    dispatchOverlay({
+                        type: 'flow-input-edit',
+                        value: flowInput.value.slice(0, flowInput.cursor) + flowInput.value.slice(flowInput.cursor + 1),
+                        cursor: flowInput.cursor,
                     });
                 }
                 else if (key.leftArrow) {
-                    setWorkspaceFlowInput(current => current === null ? null : {
-                        ...current,
-                        cursor: Math.max(0, current.cursor - 1),
+                    dispatchOverlay({
+                        type: 'flow-input-edit',
+                        value: flowInput.value,
+                        cursor: Math.max(0, flowInput.cursor - 1),
                     });
                 }
                 else if (key.rightArrow) {
-                    setWorkspaceFlowInput(current => current === null ? null : {
-                        ...current,
-                        cursor: Math.min(current.value.length, current.cursor + 1),
+                    dispatchOverlay({
+                        type: 'flow-input-edit',
+                        value: flowInput.value,
+                        cursor: Math.min(flowInput.value.length, flowInput.cursor + 1),
                     });
                 }
                 else if (input.length > 0 && !key.ctrl && !key.meta && !key.super && !key.tab) {
-                    setWorkspaceFlowInput(current => current === null ? null : {
-                        ...current,
-                        value: current.value.slice(0, current.cursor) + input + current.value.slice(current.cursor),
-                        cursor: current.cursor + input.length,
+                    dispatchOverlay({
+                        type: 'flow-input-edit',
+                        value: flowInput.value.slice(0, flowInput.cursor) + input + flowInput.value.slice(flowInput.cursor),
+                        cursor: flowInput.cursor + input.length,
                     });
                 }
                 return;
             }
-            if (key.upArrow) {
-                setWorkspaceFlowIndex(index => (index <= 0 ? workspaceFlow.choices.length - 1 : index - 1));
-            }
-            else if (key.downArrow) {
-                setWorkspaceFlowIndex(index => (index >= workspaceFlow.choices.length - 1 ? 0 : index + 1));
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: flow.choices.length });
             }
             else if (key.tab && !key.shift) {
-                const choice = workspaceFlow.choices[workspaceFlowIndex];
+                const choice = flow.choices[overlay.index];
                 if (choice?.input !== undefined) {
                     const value = choice.input.initialValue ?? '';
-                    setWorkspaceFlowInput({
+                    const flowInputNext = {
                         choiceId: choice.id,
                         value,
                         cursor: value.length,
                         ...(choice.input.placeholder === undefined ? {} : { placeholder: choice.input.placeholder }),
-                    });
+                    };
+                    dispatchOverlay({ type: 'flow-input', input: flowInputNext });
                 }
             }
             else if (plainReturn) {
-                const choice = workspaceFlow.choices[workspaceFlowIndex];
+                const choice = flow.choices[overlay.index];
                 if (choice !== undefined) {
                     runWorkspaceFlowAction(signal => choice.choose(signal));
                 }
             }
             return;
         }
-        if (workspacePickerOpen) {
-            if (key.upArrow) {
-                setWorkspaceIndex(index => (index <= 0 ? workspaceTargets.length - 1 : index - 1));
-            }
-            else if (key.downArrow) {
-                setWorkspaceIndex(index => (index >= workspaceTargets.length - 1 ? 0 : index + 1));
+        if (overlay.kind === 'workspace-picker') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: workspaceTargets.length });
             }
             else if (plainReturn) {
-                const target = workspaceTargets[workspaceIndex];
-                setWorkspacePickerOpen(false);
+                const target = workspaceTargets[overlay.index];
+                dispatchOverlay({ type: 'close' });
                 if (target !== undefined)
                     void channel.switchWorkspace(target);
             }
             else if (key.escape) {
-                setWorkspacePickerOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (modelPickerOpen) {
-            if (key.upArrow) {
-                setModelIndex(index => (index <= 0 ? models.length - 1 : index - 1));
+        if (overlay.kind === 'workspace-menu') {
+            const menu = workspaceMenuOptions;
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: menu.length });
             }
-            else if (key.downArrow) {
-                setModelIndex(index => (index >= models.length - 1 ? 0 : index + 1));
+            else if (plainReturn) {
+                const option = menu[overlay.index];
+                runWorkspaceMenuOption(option);
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'model') {
+            // Two-level picker: group rows at the top (Enter drills in), one
+            // provider's models below (Enter switches, the same live-fork path as
+            // the flat picker always had). Esc/⌫ climbs one level and only closes
+            // at the top; a single-group catalog never shows the group level, so
+            // Esc there closes directly.
+            const rowCount = activeModelGroup === undefined ? modelGroups.length : groupModels.length;
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: rowCount });
             }
             else if (plainReturn) {
-                const model = models[modelIndex];
+                if (activeModelGroup === undefined) {
+                    const group = modelGroups[overlay.index];
+                    if (!group) {
+                        dispatchOverlay({ type: 'close' });
+                        return;
+                    }
+                    setModelGroup(group.provider);
+                    // The recents group opens on its most-recent entry; a provider
+                    // group on its current model when it owns one, else its first row.
+                    if (group.provider === RECENTS_GROUP_PROVIDER) {
+                        dispatchOverlay({ type: 'set-index', kind: 'model', index: 0 });
+                        return;
+                    }
+                    const landing = modelPickerLanding(models.filter(model => model.provider === group.provider), channel.provider, channel.model);
+                    dispatchOverlay({ type: 'set-index', kind: 'model', index: landing.index });
+                    return;
+                }
+                const model = groupModels[overlay.index];
                 // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty list
                 if (model) {
                     // Enter switches the live model right away: the conversation is
                     // forked at its end and continued with an agent routed to the new
-                    // model (history replays unchanged).
-                    setModelPickerOpen(false);
-                    channel.notify(t('model-switching', { name: model.name }));
-                    void channel.switchModel(model.provider, model.id).then((ok) => {
-                        if (ok)
-                            channel.notify(t('model-switched', { name: model.name }));
-                    });
+                    // model (history replays unchanged) — and feeds the recents group.
+                    dispatchOverlay({ type: 'close' });
+                    void switchModelRecorded(model.provider, model.id, model.name);
                 }
                 else {
-                    setModelPickerOpen(false);
+                    dispatchOverlay({ type: 'close' });
                 }
             }
-            else if (key.escape) {
-                setModelPickerOpen(false);
+            else if (key.escape || key.backspace) {
+                if (activeModelGroup !== undefined && modelGroups.length > 1 && !modelPickerDirect) {
+                    setModelGroup(undefined);
+                    const groupIndex = Math.max(0, modelGroups.findIndex(group => group.provider === activeModelGroup));
+                    dispatchOverlay({ type: 'set-index', kind: 'model', index: groupIndex });
+                }
+                else {
+                    dispatchOverlay({ type: 'close' });
+                }
             }
             return;
         }
-        if (skillsPickerOpen) {
+        if (overlay.kind === 'skills') {
             const list = skillsList ?? [];
-            if (key.upArrow) {
-                if (list.length > 0)
-                    setSkillsIndex(index => (index <= 0 ? list.length - 1 : index - 1));
-            }
-            else if (key.downArrow) {
-                if (list.length > 0)
-                    setSkillsIndex(index => (index >= list.length - 1 ? 0 : index + 1));
+            if (key.upArrow || key.downArrow) {
+                // count 0 (snapshot still loading) is a no-op inside the reducer.
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: list.length });
             }
             else if (plainReturn) {
-                const skill = list[skillsIndex];
-                setSkillsPickerOpen(false);
+                const skill = list[overlay.index];
+                dispatchOverlay({ type: 'close' });
                 // 可直调技能 Enter 填入 `/name `——与 / 菜单选中技能同一条
                 // completion-only 分发路径；模型专用技能（userInvocable=false）只关闭。
                 // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty list
@@ -1652,239 +2357,313 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                     setHistoryFill(`/${skill.name} `);
             }
             else if (key.escape) {
-                setSkillsPickerOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (activityPickerOpen) {
-            if (key.upArrow) {
-                setActivityIndex(index => (index <= 0 ? PRESET_NAMES.length - 1 : index - 1));
-            }
-            else if (key.downArrow) {
-                setActivityIndex(index => (index >= PRESET_NAMES.length - 1 ? 0 : index + 1));
+        if (overlay.kind === 'activity') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: PRESET_NAMES.length });
             }
             else if (plainReturn) {
-                const name = PRESET_NAMES[activityIndex];
-                setActivityPickerOpen(false);
+                const name = PRESET_NAMES[overlay.index];
+                dispatchOverlay({ type: 'close' });
                 if (name)
                     channel.setActivityFrames(name);
             }
             else if (key.escape) {
-                setActivityPickerOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (effortSliderOpen) {
+        if (overlay.kind === 'color') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: SESSION_COLOR_NAMES.length });
+            }
+            else if (plainReturn) {
+                const name = SESSION_COLOR_NAMES[overlay.index];
+                dispatchOverlay({ type: 'close' });
+                if (name) {
+                    channel.setSessionColor(name);
+                    channel.notify(t('color-set', { name }), { color: 'success' });
+                }
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'effort') {
             if (key.leftArrow || key.rightArrow) {
                 const delta = key.leftArrow ? -1 : 1;
-                const next = (effortIndex + delta + effortOptions.length) % effortOptions.length;
-                setEffortIndex(next);
+                // The same wrap rule the reducer applies — computed here too so the
+                // newly focused level is applied in this very keystroke.
+                const next = wrapIndex(overlay.index, delta, effortOptions.length);
+                dispatchOverlay({ type: 'move', delta, count: effortOptions.length });
                 const option = effortOptions[next];
                 // Live-apply: the slider IS the control; Esc does not revert.
                 if (option)
                     void channel.setEffort(option.id);
             }
             else if (plainReturn || key.escape) {
-                setEffortSliderOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (presetPickerOpen) {
-            if (key.upArrow) {
-                setPresetIndex(index => (index <= 0 ? presetOptions.length - 1 : index - 1));
-            }
-            else if (key.downArrow) {
-                setPresetIndex(index => (index >= presetOptions.length - 1 ? 0 : index + 1));
+        if (overlay.kind === 'preset') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: presetOptions.length });
             }
             else if (plainReturn) {
-                const option = presetOptions[presetIndex];
-                setPresetPickerOpen(false);
+                const option = presetOptions[overlay.index];
+                dispatchOverlay({ type: 'close' });
                 if (option)
                     void channel.switchPreset(option.id);
             }
             else if (key.escape) {
-                setPresetPickerOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (themePickerOpen) {
-            const options = getThemeOptions();
-            if (key.upArrow) {
-                setThemeIndex(index => (index <= 0 ? options.length - 1 : index - 1));
+        if (overlay.kind === 'permission') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: PERMISSION_PRESET_IDS.length });
             }
-            else if (key.downArrow) {
-                setThemeIndex(index => (index >= options.length - 1 ? 0 : index + 1));
+            else if (plainReturn) {
+                const id = PERMISSION_PRESET_IDS[overlay.index];
+                dispatchOverlay({ type: 'close' });
+                if (id !== undefined) {
+                    void channel.runExternalCommand('permission', ` ${id}`).then((text) => {
+                        if (text !== undefined && text !== '')
+                            channel.notify(text);
+                    });
+                }
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'plan') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: 2 });
+            }
+            else if (plainReturn) {
+                const on = overlay.index === 0;
+                dispatchOverlay({ type: 'close' });
+                void channel.runExternalCommand('plan', on ? '' : ' off').then((text) => {
+                    if (text !== undefined && text !== '')
+                        channel.notify(text);
+                });
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'lang') {
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: 2 });
+            }
+            else if (plainReturn) {
+                const lang = LANGS[overlay.index];
+                dispatchOverlay({ type: 'close' });
+                if (lang !== undefined)
+                    applyLang(lang);
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (overlay.kind === 'theme') {
+            const options = getThemeOptions();
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: options.length });
             }
             else if (plainReturn) {
-                setThemePickerOpen(false);
-                const name = options[themeIndex]?.value;
+                dispatchOverlay({ type: 'close' });
+                const name = options[overlay.index]?.value;
                 if (name !== undefined) {
                     const ok = setTheme(name);
                     channel.notify(ok ? t('theme-switched-saved', { name }) : t('theme-switch-failed', { name }), { color: ok ? 'success' : 'error' });
                 }
             }
             else if (key.escape) {
-                setThemePickerOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (historyOpen) {
+        if (overlay.kind === 'history') {
+            const { query, cursor, focus } = overlay;
             if (key.escape) {
-                setHistoryOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             else if (key.ctrl && (input === 'c' || input === 'd')) {
                 // CC's history search cancels on ctrl+c/ctrl+d too.
-                setHistoryOpen(false);
+                dispatchOverlay({ type: 'close' });
             }
             else if (plainReturn) {
-                const entry = historyMatches[historyFocus];
+                const entry = historyMatches[focus];
                 // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty match list
                 if (entry) {
                     setHistoryFill(entry.text);
-                    setHistoryOpen(false);
+                    dispatchOverlay({ type: 'close' });
                 }
             }
             else if (key.upArrow) {
-                setHistoryFocus(index => historyMatches.length === 0 ? 0 : (index <= 0 ? historyMatches.length - 1 : index - 1));
+                if (historyMatches.length > 0) {
+                    dispatchOverlay({ type: 'move', delta: -1, count: historyMatches.length });
+                }
             }
-            else if (key.downArrow || (isMod(key) && input === 'r')) {
-                // CC's historySearch:next — ↓ and repeat ctrl+r walk to the next match.
-                setHistoryFocus(index => historyMatches.length === 0 ? 0 : (index >= historyMatches.length - 1 ? 0 : index + 1));
+            else if (key.downArrow || actionMatches('history', input, key)) {
+                // CC's historySearch:next — ↓ and the history key (default Ctrl+R)
+                // walk to the next match.
+                if (historyMatches.length > 0) {
+                    dispatchOverlay({ type: 'move', delta: 1, count: historyMatches.length });
+                }
             }
             else if (key.backspace) {
-                if (historyCursor > 0) {
-                    const next = historyQuery.slice(0, historyCursor - 1) + historyQuery.slice(historyCursor);
-                    setHistoryQuery(next);
-                    setHistoryCursor(historyCursor - 1);
-                    setHistoryFocus(0);
+                if (cursor > 0) {
+                    dispatchOverlay({
+                        type: 'history-edit',
+                        query: query.slice(0, cursor - 1) + query.slice(cursor),
+                        cursor: cursor - 1,
+                        focus: 0,
+                    });
                 }
             }
             else if (key.delete) {
-                if (historyCursor < historyQuery.length) {
-                    setHistoryQuery(historyQuery.slice(0, historyCursor) + historyQuery.slice(historyCursor + 1));
-                    setHistoryFocus(0);
+                if (cursor < query.length) {
+                    dispatchOverlay({
+                        type: 'history-edit',
+                        query: query.slice(0, cursor) + query.slice(cursor + 1),
+                        focus: 0,
+                    });
                 }
             }
             else if (key.leftArrow) {
                 // Step by code point, not UTF-16 unit: an emoji is two units, and
                 // a mid-pair caret offset would split it in the SearchBox render.
-                setHistoryCursor(cursor => {
-                    if (cursor <= 0)
-                        return 0;
-                    const ch = [...historyQuery.slice(0, cursor)].pop();
-                    return cursor - ch.length;
-                });
+                if (cursor > 0) {
+                    const ch = [...query.slice(0, cursor)].pop();
+                    dispatchOverlay({ type: 'history-edit', cursor: cursor - ch.length });
+                }
             }
             else if (key.rightArrow) {
-                setHistoryCursor(cursor => {
-                    if (cursor >= historyQuery.length)
-                        return historyQuery.length;
-                    const ch = [...historyQuery.slice(cursor)][0];
-                    return cursor + ch.length;
-                });
+                if (cursor < query.length) {
+                    const ch = [...query.slice(cursor)][0];
+                    dispatchOverlay({ type: 'history-edit', cursor: cursor + ch.length });
+                }
             }
             else if (key.home) {
-                setHistoryCursor(0);
+                dispatchOverlay({ type: 'history-edit', cursor: 0 });
             }
             else if (key.end) {
-                setHistoryCursor(historyQuery.length);
+                dispatchOverlay({ type: 'history-edit', cursor: query.length });
             }
             else if (!key.ctrl && !key.meta && !key.super && input) {
-                const next = historyQuery.slice(0, historyCursor) + input + historyQuery.slice(historyCursor);
-                setHistoryQuery(next);
-                setHistoryCursor(historyCursor + input.length);
-                setHistoryFocus(0);
+                dispatchOverlay({
+                    type: 'history-edit',
+                    query: query.slice(0, cursor) + input + query.slice(cursor),
+                    cursor: cursor + input.length,
+                    focus: 0,
+                });
             }
             return;
         }
-        if (rewindOpen) {
+        if (overlay.kind === 'rewind') {
             // While the plugin decision is in flight the picker is read-only;
             // Esc abandons the wait (the stale answer is dropped by the token).
-            if (rewindBusy) {
+            if (overlay.busy) {
                 if (key.escape) {
                     rewindRequestRef.current += 1;
-                    setRewindBusy(false);
+                    dispatchOverlay({ type: 'rewind-busy', busy: false });
                 }
                 return;
             }
-            if (rewindConfirm !== null) {
-                if (rewindModes !== null) {
+            if (overlay.confirm !== null) {
+                const row = overlay.confirm;
+                if (overlay.modes !== null) {
                     // Plugin offered modes: the confirm pane is a choice list —
                     // option 0 is always the built-in conversation-only rewind.
-                    const optionCount = rewindModes.length + 1;
-                    if (key.upArrow) {
-                        setRewindModeIndex(index => (index <= 0 ? optionCount - 1 : index - 1));
-                    }
-                    else if (key.downArrow) {
-                        setRewindModeIndex(index => (index >= optionCount - 1 ? 0 : index + 1));
+                    const optionCount = overlay.modes.length + 1;
+                    if (key.upArrow || key.downArrow) {
+                        dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: optionCount });
                     }
                     else if (plainReturn) {
-                        const row = rewindConfirm;
-                        const mode = rewindModeIndex === 0 ? null : (rewindModes[rewindModeIndex - 1]?.id ?? null);
-                        setRewindOpen(false);
-                        setRewindConfirm(null);
-                        setRewindModes(null);
+                        const mode = overlay.modeIndex === 0 ? null : (overlay.modes[overlay.modeIndex - 1]?.id ?? null);
+                        dispatchOverlay({ type: 'close' });
                         void performRewind(row, mode);
                     }
                     else if (key.escape) {
-                        setRewindConfirm(null);
-                        setRewindModes(null);
+                        dispatchOverlay({ type: 'rewind-back' });
                     }
                     return;
                 }
                 // Confirmation state: Enter rewinds, Esc backs out to the list.
                 if (plainReturn) {
-                    const row = rewindConfirm;
-                    setRewindOpen(false);
-                    setRewindConfirm(null);
+                    dispatchOverlay({ type: 'close' });
                     void performRewind(row);
                 }
                 else if (key.escape) {
-                    setRewindConfirm(null);
+                    dispatchOverlay({ type: 'rewind-back' });
                 }
             }
-            else if (key.upArrow) {
-                setRewindIndex(index => (index <= 0 ? rewindRows.length - 1 : index - 1));
-            }
-            else if (key.downArrow) {
-                setRewindIndex(index => (index >= rewindRows.length - 1 ? 0 : index + 1));
+            else if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: rewindRows.length });
             }
             else if (plainReturn) {
-                const row = rewindRows[rewindIndex];
+                const row = rewindRows[overlay.index];
                 // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty list
                 if (row)
                     void requestRewindConfirm(row);
             }
             else if (key.escape) {
-                setRewindOpen(false);
-                setRewindConfirm(null);
-                setRewindModes(null);
+                dispatchOverlay({ type: 'close' });
             }
             return;
         }
-        if (isMod(key) && input === 't') {
-            // Ctrl+T opens the trajectory scene at any point in the session.
+        if (overlay.kind === 'file-actions') {
+            // Click-to-act file menu: ↑/↓ move, Enter runs the focused action,
+            // Esc closes.
+            if (key.upArrow || key.downArrow) {
+                dispatchOverlay({ type: 'move', delta: key.upArrow ? -1 : 1, count: FILE_ACTION_COUNT });
+            }
+            else if (plainReturn) {
+                const path = overlay.path;
+                dispatchOverlay({ type: 'close' });
+                runFileAction(overlay.index, path);
+            }
+            else if (key.escape) {
+                dispatchOverlay({ type: 'close' });
+            }
+            return;
+        }
+        if (actionMatches('trajectory', input, key)) {
+            // The trajectory scene key (default Ctrl+T) opens it at any point in
+            // the session.
             openScene();
             return;
         }
-        if (isMod(key) && input === 'a') {
-            // Ctrl+A opens the subagent dashboard.
+        if (actionMatches('dashboard', input, key)) {
+            // The subagent dashboard key (default Ctrl+A) opens the dashboard.
             setSubagentDashboardOpen(true);
             return;
         }
-        if (isMod(key) && input === 'p' && loadedContextVisible) {
-            // Ctrl+P toggles the startup loaded-context panel while it is on
-            // screen (transcript still empty); once rows take over and the
-            // panel disappears the key has nothing left to do.
+        if (actionMatches('contextPanel', input, key) && loadedContextVisible) {
+            // The loaded-context panel key (default Ctrl+P) toggles the startup
+            // panel while it is on screen (transcript still empty); once rows take
+            // over and the panel disappears the key has nothing left to do.
             toggleLoadedContext();
             return;
         }
-        if (isMod(key) && input === 'r' && !helpOpen) {
-            setHistoryQuery('');
-            setHistoryCursor(0);
-            setHistoryFocus(0);
+        if (actionMatches('history', input, key) && !helpOpen) {
             setHistoryEntries(loadHistory());
-            setHistoryOpen(true);
+            dispatchOverlay({
+                type: 'open',
+                overlay: { kind: 'history', query: '', cursor: 0, focus: 0 },
+            });
             return;
         }
         if (key.shift && key.upArrow && !selectionActive && !helpOpen) {
@@ -1921,11 +2700,12 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }
             event.stopImmediatePropagation();
         }
-        else if (isMod(key) && input === 'o' && !helpOpen) {
-            // Leaving transcript mode (Ctrl+O) — search was already handled above.
-            // Help is modal: toggling this state behind the overlay is invisible,
-            // then the next `/` unexpectedly opens transcript search instead of
-            // slash-command completion after Help closes.
+        else if (actionMatches('transcript', input, key) && !helpOpen) {
+            // Leaving transcript mode (default Ctrl+O) — search was already
+            // handled above. Help is modal: toggling this state behind the
+            // overlay is invisible, then the next `/` unexpectedly opens
+            // transcript search instead of slash-command completion after Help
+            // closes.
             setExpanded(previous => !previous);
             // The toggle rewrites every thinking row's layout at once. The
             // ordinary scroll-based diff pushes rows into terminal scrollback on
@@ -1947,7 +2727,7 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 setSearchCursor(0);
                 setSearchCurrent(0);
                 setSearchCount(0);
-                setSearchOpen(true);
+                dispatchOverlay({ type: 'open', overlay: { kind: 'search' } });
                 event.stopImmediatePropagation();
             }
         }
@@ -1970,16 +2750,34 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                 requestExit();
             }
         }
-        else if (isMod(key) && input === 'l') {
-            // CC's app:redraw — clear the physical terminal and repaint.
+        else if (actionMatches('redraw', input, key)) {
+            // CC's app:redraw (default Ctrl+L) — clear the physical terminal and
+            // repaint.
             instances.get(process.stdout)?.forceRedraw();
         }
-        else if (isMod(key) && input === 'e') {
+        else if (actionMatches('showAll', input, key)) {
             setShowAllMessages(previous => !previous);
         }
-        else if (plainReturn && showPill) {
+        else if (actionMatches('todoFold', input, key)) {
+            // Fold/unfold the GoalTodoPanel todo section (default Ctrl+Q) — works
+            // mid-turn too: the collapsed line keeps the done/total count and the
+            // live task preview, so long todo lists stop crowding the prompt.
+            setTodoCollapsed(previous => !previous);
+        }
+        else if (plainReturn && !isSticky) {
+            // Enter while scrolled up returns to the bottom (CC's pill: the
+            // affordance now exists whenever the view is off the bottom, not
+            // only with unseen rows).
             handle?.scrollToBottom();
         }
+        else if (key.end && !isSticky) {
+            // End = jump to bottom, less/vim semantics. Global on the chat
+            // screen (search/history overlays consume their own End first —
+            // cursor-to-line-end there). At the bottom already: no-op, so the
+            // key stays harmless in muscle memory.
+            handle?.scrollToBottom();
+            event.stopImmediatePropagation();
+        }
         else if (extensionShortcuts !== undefined && extensionShortcuts.dispatch(input, key)) {
             // Plugin shortcut (tuiShortcuts seam): matched only after every
             // built-in global binding above declined — locals always win, and the
@@ -2029,6 +2827,16 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         // hosts are already in it and must not nest a second one.
         return fullscreen ? browser : _jsx(AlternateScreen, { children: browser });
     }
+    // The session tree follows the browser's rule exactly: it REPLACES the
+    // conversation (an early return after every hook above has run), so there
+    // is no transcript underneath to be repainted or bled through. The dropped
+    // turn's prompt returns through the same fill path a rewind picker uses.
+    if (treeOpen) {
+        const tree = (_jsx(SessionTree, { channel: channel, currentSessionId: channel.agentId, onClose: () => setTreeOpen(false), onRestoreText: (text) => {
+                setHistoryFill(text);
+            } }));
+        return fullscreen ? tree : _jsx(AlternateScreen, { children: tree });
+    }
     // The settings screen follows the browser's rule exactly: it REPLACES the
     // conversation (an early return after every hook above has run), so there
     // is no transcript underneath to be repainted or bled through.
@@ -2061,10 +2869,10 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
             }, onClose: () => setSubagentDashboardOpen(false) }));
         return fullscreen ? dashboard : _jsx(AlternateScreen, { children: dashboard });
     }
-    /** Prompt input is inert while a modal dialog owns the keyboard. */
-    const promptSelectionActive = selectionActive || modelPickerOpen || skillsPickerOpen || workspacePickerOpen || workspaceFlow !== null || activityPickerOpen ||
-        effortSliderOpen || presetPickerOpen || themePickerOpen || thinkingOpen || historyOpen || rewindOpen || searchOpen ||
-        btw !== null || tipsOpen;
+    /** Prompt input is inert while a modal dialog owns the keyboard. The
+     *  overlay union covers every picker/dialog and /tips in one check;
+     *  message-selection mode and the /btw panel live outside it. */
+    const promptSelectionActive = selectionActive || overlay.kind !== 'none' || btw !== null;
     // The trajectory scene replaces the conversation for as long as it is open.
     // Rendering it INSTEAD of (not above) the transcript is what makes it a
     // screen rather than an overlay: it owns the full viewport, and the
@@ -2077,24 +2885,60 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
         const scene = _jsx(TrajectoryScene, { channel: channel, build: trajectory, onClose: closeScene });
         return fullscreen ? scene : _jsx(AlternateScreen, { children: scene });
     }
-    // 浮层整体挂载条件：必须与内部各面板的可见条件精确同值。关闭时把
-    // 整个 absolute 浮层从树里移除——渲染器的"移除 absolute 节点"检测只看
-    // 被移除子树自身的 style.position（dom.ts collectRemovedRects），若浮层
-    // 常驻、只移除其普通子节点，blit 解毒不触发，被覆盖的转录行会在
-    // blit-skip 后留空（Esc 关 picker 一片空白的根因）。
-    const dialogOverlayOpen = thinkingOpen || (workspacePickerOpen && workspaceTargets.length > 0) || workspaceFlow !== null ||
-        modelPickerOpen || skillsPickerOpen ||
-        activityPickerOpen || (effortSliderOpen && effortOptions.length > 1) ||
-        (presetPickerOpen && presetOptions.length > 0) || themePickerOpen || historyOpen ||
-        rewindOpen || searchOpen || tipsOpen;
-    return (_jsxs(Box, { ref: wakeTickRef, flexDirection: "column", flexGrow: 1, width: "100%", children: [!isSticky && channel.lastUserText && (_jsx(StickyPromptHeader, { text: channel.lastUserText, onClick: () => {
-                    // Click jumps back to the pinned prompt (CC's StickyPromptHeader).
-                    const lastUser = [...channel.rows].reverse().find(row => row.kind === 'user');
-                    if (lastUser)
-                        seekRow(lastUser.id);
+    // 浮层整体挂载条件：与内部各面板的可见条件同值（数据门在
+    // dialogOverlayVisible 里逐面板镜像）。关闭时把整个 absolute 浮层从树里
+    // 移除——渲染器的"移除 absolute 节点"检测只看被移除子树自身的
+    // style.position（dom.ts collectRemovedRects），若浮层常驻、只移除其
+    // 普通子节点，blit 解毒不触发，被覆盖的转录行会在 blit-skip 后留空
+    // （Esc 关 picker 一片空白的根因）。
+    const dialogOverlayOpen = dialogOverlayVisible(overlay, {
+        workspaceTargetCount: workspaceTargets.length,
+        effortOptionCount: effortOptions.length,
+        presetOptionCount: presetOptions.length,
+    });
+    // The sticky header pins the turn owning the viewport top row
+    // (timeline.activeId, reported by MessageList) — scrolled up to an old
+    // turn, it carries THAT turn's prompt, not the latest one.
+    // channel.rows is a live in-place array, so the lookup is per-render.
+    const anchorUserRowId = timeline.activeId;
+    const anchorUserText = anchorUserRowId === null
+        ? null
+        : channel.rows.find(row => row.id === anchorUserRowId)?.text ?? null;
+    return (_jsxs(Box, { ref: wakeTickRef, flexDirection: "column", flexGrow: 1, width: "100%", children: [!isSticky && anchorUserText && (_jsx(StickyPromptHeader, { text: anchorUserText, onClick: () => {
+                    // Click snaps the pinned prompt to the viewport top (CC's
+                    // StickyPromptHeader). Jump by the SAME content coordinate the
+                    // rail's tick uses (timeline turn top = the prompt TEXT top):
+                    // the element-based seek lands the row wrapper's margin at the
+                    // top instead — one row shy of the text top the anchor rule
+                    // compares against — and the header would flip to the previous
+                    // turn immediately after the click.
+                    const turn = timeline.turns.find(t => t.id === anchorUserRowId);
+                    if (turn)
+                        handle?.scrollTo(turn.top);
+                    else if (anchorUserRowId !== null)
+                        seekRow(anchorUserRowId);
                     else
                         handle?.scrollToBottom();
-                } })), _jsxs(ScrollBox, { ref: setHandle, flexDirection: "column", flexGrow: 1, flexShrink: 1, stickyScroll: true, children: [_jsx(LogoHeader, { model: channel.model, effort: channel.reasoningEffort, cwd: channel.displayCwd, whale: channel.whale }, logoNonce), loadedContextVisible && (_jsx(LoadedContextPanel, { context: channel.loadedContext, open: loadedContextOpen, onToggle: toggleLoadedContext })), _jsx(MessageList, { rows: channel.rows, failureHintRowId: failureHintRowId, failureHint: t('traj-hint-failure', { key: `${modLabel}t` }), expanded: expanded, expandedRows: expandedRows, selectedId: selectionActive ? selectedId : null, onToggleRow: toggleRowExpanded, model: channel.model, diffLayout: channel.diffLayout, thinkingFold: channel.thinkingFold, toolBackground: channel.toolBackground, activityFrames: channel.activityFrames, showAll: showAllMessages, thinkingVisible: thinkingVisible, onToggleAll: () => { setShowAllMessages(previous => !previous); }, onLoadOlder: () => channel.loadOlder(), registerRowRef: registerRowRef, scrollHandle: handle, forceMountRowId: forceMountRowId, newSinceRowId: isSticky ? null : lastSeenRowIdRef.current, onUnseenCount: setUnseenCount })] }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [showPill && (_jsx(NewMessagesPill, { count: unseenCount, onClick: () => handle?.scrollToBottom() })), channel.working &&
+                } })), _jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, width: "100%", children: [_jsxs(ScrollBox, { ref: setHandle, flexDirection: "column", flexGrow: 1, flexShrink: 1, stickyScroll: true, children: [_jsx(LogoHeader, { model: channel.model, effort: channel.reasoningEffort, cwd: channel.displayCwd, whale: channel.whale, 
+                                // Resuming a long session skips the ~3.4s opening animation: it
+                                // keeps firing low-frequency React commits that compete with the
+                                // transcript mount batches (and the first wheel events) for the
+                                // frame budget right when the user wants to read history. Fresh
+                                // sessions keep the full intro; restored ones settle instantly.
+                                skipIntro: channel.rows.length > 30 }, logoNonce), loadedContextVisible && (_jsx(LoadedContextPanel, { context: channel.loadedContext, open: loadedContextOpen, onToggle: toggleLoadedContext })), _jsx(MessageList, { rows: channel.rows, failureHintRowId: failureHintRowId, failureHint: t('traj-hint-failure', { key: `${modLabel}t` }), expanded: expanded, expandedRows: expandedRows, selectedId: selectionActive ? selectedId : null, onToggleRow: toggleRowExpanded, streamFoldedRows: streamFoldedRows, onToggleStreamFold: toggleStreamFolded, model: channel.model, diffLayout: channel.diffLayout, thinkingFold: channel.thinkingFold, toolBackground: channel.toolBackground, activityFrames: channel.activityFrames, showAll: showAllMessages, thinkingVisible: thinkingVisible, historyPaintEnabled: !fullscreen, onToggleAll: () => { setShowAllMessages(previous => !previous); }, onLoadOlder: () => channel.loadOlder(), registerRowRef: registerRowRef, scrollHandle: handle, forceMountRowId: forceMountRowId, newSinceRowId: isSticky ? null : lastSeenRowIdRef.current, onUnseenCount: setUnseenCount, onTimeline: setTimeline, onOpenSubagent: (agentId) => setSubagentDetailId(agentId), onOpenFile: openFileActions })] }), (() => {
+                        // Gutter mode (settings `dsh-tui.scrollGutter`): the timeline
+                        // rail (default), the proportional scrollbar, or nothing. The
+                        // slot keeps its 2 columns in both rendered modes (Qwen's
+                        // permanent-gutter rule — an appearing/disappearing gutter
+                        // changes the transcript width and rewraps everything).
+                        const gutter = normalizeScrollGutter(channel.scrollGutter);
+                        if (gutter === 'hidden')
+                            return null;
+                        if (gutter === 'scrollbar') {
+                            return _jsx(ScrollbarGutter, { handle: handle, terminalWidth: terminalColumns });
+                        }
+                        return (_jsx(TimelineRail, { handle: handle, turns: timeline.turns, activeId: timeline.activeId, upId: timeline.upId, downId: timeline.downId, terminalWidth: terminalColumns, hoverEnabled: !promptSelectionActive, onRevealTurn: revealAndSeekRow }));
+                    })()] }), _jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [showPill && (_jsx(NewMessagesPill, { count: unseenCount, onClick: () => handle?.scrollToBottom() })), channel.working &&
                         (channel.activityEnabled &&
                             !channel.minimal &&
                             channel.workingActivity !== undefined &&
@@ -2104,22 +2948,182 @@ export function Chat({ channel, questionStore, approvalStore, extensionDialogs,
                                 // the animated chars/4 estimate, matching the classic
                                 // spinner's counter (the suffix used raw chars before,
                                 // inflating the reading next to a real upload number).
-                                suffix: `${lastUploadTokens > 0 ? ` · ↑ ${formatTokens(lastUploadTokens)}` : ''} · ↓ ${formatTokens(Math.round(channel.responseChars / 4))} tokens` }) })) : (_jsx(WorkingSpinner, { mode: channel.spinnerMode, hasActiveTools: channel.activeToolCount > 0, responseLengthRef: responseLengthRef, uploadTokensRef: uploadTokensRef, loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, thinkingStatus: thinkingStatus }))), _jsx(GoalTodoPanel, { channel: channel }), statusEntries.length > 0 && (_jsx(Text, { dimColor: true, wrap: "truncate", children: statusEntries.map(entry => entry.text).join(' · ') })), approvalSnapshot !== null ? (_jsx(ApprovalPanel, { approval: approvalSnapshot, onDecide: outcome => approvals.decide(outcome) }, approvalSnapshot.key)) : dialogSnapshot !== null ? (_jsx(ExtensionDialog, { dialog: dialogSnapshot, onDecide: value => dialogs.decide(dialogSnapshot.key, value), onCancel: () => dialogs.cancel(dialogSnapshot.key) }, dialogSnapshot.key)) : tipsOpen ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(TipsPanel, { onClose: () => setTipsOpen(false) }) })) : btw !== null ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(BtwPanel, { question: btw.question, answer: btw.answer, error: btw.error, streaming: !btw.done, onClose: closeBtw, onCopy: () => {
+                                suffix: `${lastUploadTokens > 0 ? ` · ↑ ${formatTokens(lastUploadTokens)}` : ''} · ↓ ${formatTokens(Math.round(channel.responseChars / 4))} tokens` }) })) : (_jsx(WorkingSpinner, { mode: channel.spinnerMode, hasActiveTools: channel.activeToolCount > 0, responseLengthRef: responseLengthRef, uploadTokensRef: uploadTokensRef, loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, thinkingStatus: thinkingStatus }))), _jsx(GoalTodoPanel, { channel: channel, collapsed: todoCollapsed, onToggle: () => setTodoCollapsed(previous => !previous) }), recap !== null && recap.auto && !recap.expanded && (_jsx(AutoRecapRow, { summary: recap.summary, streaming: !recap.done, onExpand: () => setRecap(prev => (prev ? { ...prev, expanded: true } : prev)), onDismiss: () => closeRecap() })), statusEntries.length > 0 && (_jsx(Text, { dimColor: true, wrap: "truncate", children: statusEntries.map(entry => entry.text).join(' · ') })), approvalSnapshot !== null ? (_jsx(ApprovalPanel, { approval: approvalSnapshot, onDecide: outcome => approvals.decide(outcome) }, approvalSnapshot.key)) : dialogSnapshot !== null ? (_jsx(ExtensionDialog, { dialog: dialogSnapshot, onDecide: value => dialogs.decide(dialogSnapshot.key, value), onCancel: () => dialogs.cancel(dialogSnapshot.key) }, dialogSnapshot.key)) : overlay.kind === 'tips' ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(TipsPanel, { onClose: () => dispatchOverlay({ type: 'close-if', kind: 'tips' }) }) })) : recap !== null && (!recap.auto || recap.expanded) ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RecapPanel, { summary: recap.summary, title: recap.title, error: recap.error, streaming: !recap.done, titleApplied: recap.titleApplied, onClose: () => {
+                                // An expanded auto recap collapses back to its dim row;
+                                // a manual /recap closes outright.
+                                if (recap.auto) {
+                                    setRecap(prev => (prev ? { ...prev, expanded: false } : prev));
+                                }
+                                else {
+                                    closeRecap();
+                                }
+                            }, onCopy: () => {
+                                void setClipboard(recap.summary ?? '').then(raw => { if (raw)
+                                    writeRaw?.(raw); });
+                                channel.notify(t('copied-chars', { n: (recap.summary ?? '').length }), { timeoutMs: 1500 });
+                            }, onApplyTitle: () => {
+                                if (recap.title === undefined || recap.titleApplied)
+                                    return;
+                                channel.renameSession(recap.title);
+                                setRecap(prev => (prev ? { ...prev, titleApplied: true } : prev));
+                                channel.notify(t('recap-title-applied-notify', { title: recap.title }), { color: 'success' });
+                            } }) })) : btw !== null ? (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(BtwPanel, { question: btw.question, answer: btw.answer, error: btw.error, streaming: !btw.done, onClose: closeBtw, onCopy: () => {
                                 void setClipboard(btw.answer ?? '').then(raw => { if (raw)
                                     writeRaw?.(raw); });
                                 channel.notify(t('copied-chars', { n: (btw.answer ?? '').length }), { timeoutMs: 1500 });
-                            } }) })) : questionSnapshot !== null ? (_jsx(AskUserQuestionPanel, { question: questionSnapshot.question, position: questionSnapshot.position, total: questionSnapshot.total, answered: questionSnapshot.answered, onAnswer: selection => questionStore.answerCurrent(selection), onCancel: () => questionStore.cancelCurrent() }, questionSnapshot.key)) : (_jsx(PromptInput, { channel: channel, helpOpen: helpOpen, onToggleHelp: () => { setHelpOpen(previous => !previous); }, onRunCommand: runCommand, selectionActive: promptSelectionActive, fillText: historyFill, onFillConsumed: () => { setHistoryFill(null); }, onRewindRequest: openRewind, controllerRef: promptControllerRef })), _jsx(StatusLine, { channel: channel, selectionActive: selectionActive, helpOpen: helpOpen, wake: wakeBand === undefined
+                            } }) })) : questionSnapshot !== null ? (_jsx(AskUserQuestionPanel, { question: questionSnapshot.question, position: questionSnapshot.position, total: questionSnapshot.total, answered: questionSnapshot.answered, initialDraft: questionSnapshot.draft, onAnswer: selection => questionStore.answerCurrent(selection), onCancel: () => questionStore.cancelCurrent(), onBack: questionSnapshot.canGoBack
+                            ? draft => questionStore.backCurrent(draft)
+                            : undefined }, questionSnapshot.key)) : (_jsx(PromptInput, { channel: channel, helpOpen: helpOpen, onToggleHelp: () => { setHelpOpen(previous => !previous); }, onRunCommand: runCommand, selectionActive: promptSelectionActive, fillText: historyFill, onFillConsumed: () => { setHistoryFill(null); }, onRewindRequest: openRewind, controllerRef: promptControllerRef })), _jsx(StatusLine, { channel: channel, selectionActive: selectionActive, helpOpen: helpOpen, wake: wakeBand === undefined
                             ? undefined
                             : {
                                 band: wakeBand,
                                 hint: trajectorySeen ? undefined : `${modLabel}t`,
                                 tick: Math.floor(wakeTime / 120),
-                            } }), dialogOverlayOpen && (_jsxs(OverlayAbove, { maxHeight: Math.max(terminalRows - 8, 8), children: [thinkingOpen && (_jsx(ThinkingToggle, { currentValue: thinkingVisible, focusIndex: thinkingFocus })), workspacePickerOpen && workspaceTargets.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspacePicker, { targets: workspaceTargets, focusIndex: workspaceIndex, currentCwd: channel.cwd }) })), workspaceFlow !== null && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceFlowPicker, { title: workspaceFlow.title, choices: workspaceFlow.choices, focusIndex: workspaceFlowIndex, busy: workspaceFlowBusy, input: workspaceFlowInput }) })), modelPickerOpen && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: models.length === 0 ? (_jsx(ModelPickerLoading, {})) : (_jsx(ModelPicker, { models: models, focusIndex: modelIndex, currentModel: `${channel.provider}/${channel.model}` })) })), skillsPickerOpen && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: skillsList === null ? (_jsx(SkillsPickerLoading, {})) : (_jsx(SkillsPicker, { skills: skillsList, focusIndex: skillsIndex })) })), activityPickerOpen && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ActivityPicker, { focusIndex: activityIndex, currentPreset: channel.activityFrames }) })), effortSliderOpen && effortOptions.length > 1 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(EffortSlider, { options: effortOptions, focusIndex: effortIndex, currentId: channel.reasoningEffort }) })), presetPickerOpen && presetOptions.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PresetPicker, { presets: presetOptions, focusIndex: presetIndex, currentPreset: channel.agentPreset }) })), themePickerOpen && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ThemePicker, { focusIndex: themeIndex, currentTheme: themeName }) })), historyOpen && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(HistorySearchDialog, { query: historyQuery, cursorOffset: historyCursor, matches: historyMatches, focusIndex: historyFocus }) })), rewindOpen && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RewindPicker, { rows: rewindRows, focusIndex: rewindIndex, confirmRow: rewindConfirm, modes: rewindModes, modeIndex: rewindModeIndex, busy: rewindBusy }) })), searchOpen && _jsx(TranscriptSearchBar, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }));
+                            } }), dialogOverlayOpen && (_jsxs(OverlayAbove, { maxHeight: Math.max(terminalRows - 8, 1), children: [overlay.kind === 'thinking' && (_jsx(ThinkingToggle, { currentValue: thinkingVisible, focusIndex: overlay.focus, onPick: (index) => {
+                                    // 点击行 = 设焦点 + 应用（与 Enter 同一条路径）
+                                    const visible = index === 0;
+                                    setThinkingVisible(visible);
+                                    dispatchOverlay({ type: 'close' });
+                                    channel.notify(t('thinking-toggled', { state: visible ? t('thinking-on') : t('thinking-off') }));
+                                } })), overlay.kind === 'workspace-picker' && workspaceTargets.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspacePicker, { targets: workspaceTargets, focusIndex: overlay.index, currentCwd: channel.cwd, onPick: (index) => {
+                                        // 点击行 = 切换该行目标（与 Enter 同一条路径）
+                                        const target = workspaceTargets[index];
+                                        dispatchOverlay({ type: 'close' });
+                                        if (target !== undefined)
+                                            void channel.switchWorkspace(target);
+                                    } }) })), overlay.kind === 'workspace-menu' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceMenuPicker, { options: workspaceMenuOptions, focusIndex: overlay.index, onPick: (index) => {
+                                        // 点击行 = 执行该行（与 Enter 同一条路径）
+                                        runWorkspaceMenuOption(workspaceMenuOptions[index]);
+                                    } }) })), overlay.kind === 'workspace-flow' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(WorkspaceFlowPicker, { title: overlay.flow.title, choices: overlay.flow.choices, focusIndex: overlay.index, busy: overlay.busy, input: overlay.input, onPick: (index) => {
+                                        // 点击行 = 设焦点 + 执行分支（与 Enter 同一条路径）；
+                                        // busy/输入态在组件侧禁点
+                                        const choice = overlay.flow.choices[index];
+                                        if (choice === undefined)
+                                            return;
+                                        dispatchOverlay({ type: 'set-index', kind: 'workspace-flow', index });
+                                        runWorkspaceFlowAction(signal => choice.choose(signal));
+                                    } }) })), overlay.kind === 'model' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: models.length === 0 ? (_jsx(ModelPickerLoading, {})) : activeModelGroup === undefined ? (_jsx(ModelPicker, { groups: modelGroups, focusIndex: overlay.index, currentProvider: channel.provider, onPick: (index) => {
+                                        // 点击分组行 = 进入该组（与 Enter 同一条路径）
+                                        const group = modelGroups[index];
+                                        if (!group)
+                                            return;
+                                        setModelGroup(group.provider);
+                                        if (group.provider === RECENTS_GROUP_PROVIDER) {
+                                            dispatchOverlay({ type: 'set-index', kind: 'model', index: 0 });
+                                            return;
+                                        }
+                                        const landing = modelPickerLanding(models.filter(model => model.provider === group.provider), channel.provider, channel.model);
+                                        dispatchOverlay({ type: 'set-index', kind: 'model', index: landing.index });
+                                    } })) : (_jsx(ModelPicker, { models: groupModels, groupLabel: activeModelGroup === RECENTS_GROUP_PROVIDER
+                                        ? t('picker-group-recent')
+                                        : modelGroups.find(group => group.provider === activeModelGroup)?.label, showBack: modelGroups.length > 1 && !modelPickerDirect, showProviderPrefix: activeModelGroup === RECENTS_GROUP_PROVIDER, focusIndex: overlay.index, currentModel: `${channel.provider}/${channel.model}`, onPick: (index) => {
+                                        // 点击行 = 应用该行模型（与 Enter 同一条路径）
+                                        const model = groupModels[index];
+                                        if (!model)
+                                            return;
+                                        dispatchOverlay({ type: 'close' });
+                                        void switchModelRecorded(model.provider, model.id, model.name);
+                                    } })) })), overlay.kind === 'skills' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: skillsList === null ? (_jsx(SkillsPickerLoading, {})) : (_jsx(SkillsPicker, { skills: skillsList, focusIndex: overlay.index, onPick: (index) => {
+                                        const skill = skillsList[index];
+                                        if (!skill)
+                                            return;
+                                        dispatchOverlay({ type: 'close' });
+                                        if (skill.userInvocable)
+                                            setHistoryFill(`/${skill.name} `);
+                                    } })) })), overlay.kind === 'activity' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ActivityPicker, { focusIndex: overlay.index, currentPreset: channel.activityFrames, onPick: (index) => {
+                                        dispatchOverlay({ type: 'close' });
+                                        const name = PRESET_NAMES[index];
+                                        if (name)
+                                            channel.setActivityFrames(name);
+                                    } }) })), overlay.kind === 'color' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ColorPicker, { focusIndex: overlay.index, currentColor: channel.sessionColor, onPick: (index) => {
+                                        dispatchOverlay({ type: 'close' });
+                                        const name = SESSION_COLOR_NAMES[index];
+                                        if (name) {
+                                            channel.setSessionColor(name);
+                                            channel.notify(t('color-set', { name }), { color: 'success' });
+                                        }
+                                    } }) })), overlay.kind === 'effort' && effortOptions.length > 1 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(EffortSlider, { options: effortOptions, focusIndex: overlay.index, currentId: channel.reasoningEffort, 
+                                    // 点击档位 = 移到该档并即时应用（与 ←/→ 同语义）
+                                    onPick: (index) => {
+                                        dispatchOverlay({ type: 'set-index', kind: 'effort', index });
+                                        const option = effortOptions[index];
+                                        if (option)
+                                            void channel.setEffort(option.id);
+                                    } }) })), overlay.kind === 'preset' && presetOptions.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PresetPicker, { presets: presetOptions, focusIndex: overlay.index, currentPreset: channel.agentPreset, onPick: (index) => {
+                                        dispatchOverlay({ type: 'close' });
+                                        const option = presetOptions[index];
+                                        if (option)
+                                            void channel.switchPreset(option.id);
+                                    } }) })), overlay.kind === 'permission' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PermissionsPicker, { focusIndex: overlay.index, currentMode: channel.mode.sandbox, cwd: channel.cwd, onPick: (index) => {
+                                        dispatchOverlay({ type: 'close' });
+                                        const id = PERMISSION_PRESET_IDS[index];
+                                        if (id !== undefined) {
+                                            void channel.runExternalCommand('permission', ` ${id}`).then((text) => {
+                                                if (text !== undefined && text !== '')
+                                                    channel.notify(text);
+                                            });
+                                        }
+                                    } }) })), overlay.kind === 'plan' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(PlanPicker, { focusIndex: overlay.index, currentOn: channel.mode.plan === true, onPick: (index) => {
+                                        dispatchOverlay({ type: 'close' });
+                                        const on = index === 0;
+                                        void channel.runExternalCommand('plan', on ? '' : ' off').then((text) => {
+                                            if (text !== undefined && text !== '')
+                                                channel.notify(text);
+                                        });
+                                    } }) })), overlay.kind === 'lang' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(LangPicker, { focusIndex: overlay.index, currentLang: getLang(), onPick: (index) => {
+                                        const lang = LANGS[index];
+                                        if (lang === undefined)
+                                            return;
+                                        dispatchOverlay({ type: 'close' });
+                                        applyLang(lang);
+                                    } }) })), overlay.kind === 'theme' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ThemePicker, { focusIndex: overlay.index, currentTheme: themeName, onPick: (index) => {
+                                        dispatchOverlay({ type: 'close' });
+                                        const name = getThemeOptions()[index]?.value;
+                                        if (name !== undefined) {
+                                            const ok = setTheme(name);
+                                            channel.notify(ok ? t('theme-switched-saved', { name }) : t('theme-switch-failed', { name }), { color: ok ? 'success' : 'error' });
+                                        }
+                                    } }) })), overlay.kind === 'history' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(HistorySearchDialog, { query: overlay.query, cursorOffset: overlay.cursor, matches: historyMatches, focusIndex: overlay.focus, onPick: (index) => {
+                                        // 点击行 = 填入该历史命令（与 Enter 同路径）
+                                        const entry = historyMatches[index];
+                                        if (entry) {
+                                            setHistoryFill(entry.text);
+                                            dispatchOverlay({ type: 'close' });
+                                        }
+                                    } }) })), overlay.kind === 'rewind' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(RewindPicker, { rows: rewindRows, focusIndex: overlay.index, confirmRow: overlay.confirm, modes: overlay.modes, modeIndex: overlay.modeIndex, busy: overlay.busy, onPickRow: (index) => {
+                                        // 列表页点击只选中：进入确认态保留键盘 Enter 显式触发
+                                        dispatchOverlay({ type: 'set-index', kind: 'rewind', index });
+                                    }, onConfirm: () => {
+                                        // 确认页即显式确认层，点击直接执行（与 Enter 同路径）
+                                        const row = overlay.confirm;
+                                        if (row === null)
+                                            return;
+                                        dispatchOverlay({ type: 'close' });
+                                        void performRewind(row);
+                                    }, onPickMode: (index) => {
+                                        // 模式列表点击直接执行该模式（与 Enter 同路径）
+                                        const row = overlay.confirm;
+                                        if (row === null)
+                                            return;
+                                        // 模式页仅当 modes 非空才渲染，这里空安全取值
+                                        const mode = index === 0 ? null : (overlay.modes?.[index - 1]?.id ?? null);
+                                        dispatchOverlay({ type: 'close' });
+                                        void performRewind(row, mode);
+                                    } }) })), overlay.kind === 'file-actions' && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(FileActionsPanel, { path: overlay.path, isDir: overlay.isDir, focusIndex: overlay.index, onPick: (index) => {
+                                        // 点击行直接执行该动作（与 Enter 同路径）
+                                        const path = overlay.path;
+                                        dispatchOverlay({ type: 'close' });
+                                        runFileAction(index, path);
+                                    } }) })), overlay.kind === 'search' && _jsx(TranscriptSearchBar, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }));
 }
 /**
  * The pinned prompt header shown above the ScrollBox while the user has
  * scrolled up (mirroring Claude Code's FullscreenLayout.StickyPromptHeader).
- * Fixed at 1 row so the ScrollBox never shifts when the text changes.
+ * Pins the user message the transcript viewport is currently showing — the
+ * topmost visible user message, or the nearest one above when only assistant
+ * content fills the view — so it tracks which turn the user is reading
+ * instead of always carrying the latest prompt. Fixed at 1 row so the
+ * ScrollBox never shifts when the text changes.
  */
 function StickyPromptHeader({ text, onClick, }) {
     return (_jsx(Box, { flexShrink: 0, width: "100%", height: 1, paddingRight: 1, onClick: onClick, children: _jsxs(Text, { color: "briefLabelYou", bold: true, wrap: "truncate-end", children: [POINTER, " ", text] }) }));
@@ -2127,7 +3131,9 @@ function StickyPromptHeader({ text, onClick, }) {
 /** The `↓ N new messages` pill shown while scrolled up with new content. */
 function NewMessagesPill({ count, onClick, }) {
     const [hover, setHover] = React.useState(false);
-    return (_jsx(Box, { paddingX: 2, paddingTop: 1, children: _jsx(Box, { backgroundColor: hover ? 'userMessageBackgroundHover' : 'background', onClick: onClick, onMouseEnter: () => { setHover(true); }, onMouseLeave: () => { setHover(false); }, children: _jsxs(Text, { color: "inverseText", bold: true, children: [' ', "\u2193 ", t(count === 1 ? 'new-message' : 'new-messages', { n: count }), ' '] }) }) }));
+    return (_jsx(Box, { paddingX: 2, paddingTop: 1, children: _jsx(Box, { backgroundColor: hover ? 'userMessageBackgroundHover' : 'background', onClick: onClick, onMouseEnter: () => { setHover(true); }, onMouseLeave: () => { setHover(false); }, children: _jsxs(Text, { color: "inverseText", bold: true, children: [' ', count > 0
+                        ? t(count === 1 ? 'new-message' : 'new-messages', { n: count })
+                        : t('back-to-bottom'), ' '] }) }) }));
 }
 /** /model while the provider catalog is still loading (CC's LoadingState). */
 function ModelPickerLoading() {