@deepseek-harness-tui/dsh-tui 0.7.2 → 0.8.0

package/lib/types/screens/Chat.js

@@ -2,6 +2,7 @@ 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 { 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 { formatTokens } from '../cc/format.js';
@@ -26,7 +27,10 @@ import { StatusLine } from './StatusLine.js';
 import { WorkingSpinner, useThinkingStatus } from '../components/WorkingSpinner.js';
 import { ActivityLine, contextPressurePct } from '../components/ActivityLine.js';
 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 { Settings } from './Settings.js';
 import { WorkspacePicker } from '../components/WorkspacePicker.js';
 import { WorkspaceFlowPicker } from '../components/WorkspaceFlowPicker.js';
 import { ActivityPicker } from '../components/ActivityPicker.js';
@@ -152,9 +156,17 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     const [modelPickerOpen, setModelPickerOpen] = React.useState(false);
     const [models, setModels] = React.useState([]);
     const [modelIndex, setModelIndex] = React.useState(0);
+    /** `/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);
+    /** `/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);
@@ -243,6 +255,14 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     }, []);
     /** Startup context panel: expanded by header click or Ctrl+T. */
     const [loadedContextOpen, setLoadedContextOpen] = React.useState(false);
+    /**
+     * Whether the startup context panel is on screen. Derived once and read by
+     * BOTH the Ctrl+T handler and the render below: the key's meaning depends on
+     * the panel being visible, so a second copy of this condition is a place for
+     * the two to disagree — which is how the key came to advertise one thing and
+     * do another in the first place.
+     */
+    const loadedContextVisible = channel.rows.length === 0 && channel.loadedContext !== undefined;
     /** `/` transcript search (less-style incsearch, ported from CC's REPL). */
     const [searchOpen, setSearchOpen] = React.useState(false);
     const [searchQuery, setSearchQuery] = React.useState('');
@@ -306,10 +326,17 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     // Spinner timing refs, fed from channel state each render (the spinner
     // only mounts while working, so values are stable for the mount).
     const responseLengthRef = React.useRef(0);
+    const uploadTokensRef = React.useRef(0);
     const loadingStartTimeRef = React.useRef(0);
     const totalPausedMsRef = React.useRef(0);
     const pauseStartTimeRef = React.useRef(null);
     responseLengthRef.current = channel.responseChars;
+    // Most recent request's real upload (input + cache read/write occupy the
+    // wire exactly like the context window); 0 until the first usage event.
+    const lastUploadTokens = channel.lastUsage === undefined
+        ? 0
+        : channel.lastUsage.input + channel.lastUsage.cacheRead + channel.lastUsage.cacheWrite;
+    uploadTokensRef.current = lastUploadTokens;
     loadingStartTimeRef.current = channel.turnStart;
     const thinkingStatus = useThinkingStatus(channel.spinnerMode === 'thinking');
     // Terminal tab title (ported from CC's AnimatedTerminalTitle): the session
@@ -620,6 +647,23 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                     setModelIndex(index >= 0 ? index : 0);
                 });
                 return true;
+            case 'skills':
+                // issue #204: 列出当前 agent 的完整技能目录（名称 + 来源 + 简述），
+                // Enter 把可直调技能以 `/name ` 填回输入行（completion-only 分发的
+                // 同一路径）。注册表读取走 channel（快照 scoped 到 live agent）。
+                setHelpOpen(false);
+                setSkillsList(null);
+                setSkillsIndex(0);
+                setSkillsPickerOpen(true);
+                void channel.listSkills().then((list) => {
+                    if (list === undefined) {
+                        setSkillsPickerOpen(false);
+                        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/
@@ -773,6 +817,13 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 channel.pushLocal('/cost', lines);
                 return true;
             }
+            case 'settings': {
+                // Plugin settings screen (issue #165): opens immediately; the screen
+                // reads sections + namespaces from the channel itself.
+                setHelpOpen(false);
+                setSettingsOpen(true);
+                return true;
+            }
             case 'config': {
                 const userHome = process.env.USERPROFILE ?? '';
                 const lines = [
@@ -814,14 +865,28 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 });
                 return true;
             case 'login': {
-                const key = process.env.DEEPSEEK_API_KEY;
-                const lines = [
-                    `${t('login-api-key', { key: key ? key.slice(0, 6) + '…' + key.slice(-4) : t('login-key-missing') })}`,
-                    `${t('login-base-url', { url: process.env.DEEPSEEK_BASE_URL ?? t('login-official-endpoint') })}`,
-                    t('login-source-hint'),
-                ];
                 setHelpOpen(false);
-                channel.pushLocal('/login', lines);
+                void channel.describeCredential('DEEPSEEK_API_KEY')
+                    .catch(() => undefined)
+                    .then(status => {
+                    const keyStatus = status === undefined
+                        ? t('login-credentials-unavailable')
+                        : status.configured
+                            ? t('login-key-configured', { ref: 'DEEPSEEK_API_KEY' })
+                            : t('login-key-missing');
+                    channel.pushLocal('/login', [
+                        t('login-api-key', { status: keyStatus }),
+                        ...(status === undefined
+                            ? []
+                            : [
+                                t('login-credential-source', { source: status.source ?? t('login-source-none') }),
+                                t('login-credential-storage', {
+                                    mode: t(status.writable ? 'login-storage-writable' : 'login-storage-read-only'),
+                                }),
+                            ]),
+                        t('login-base-url', { url: process.env.DEEPSEEK_BASE_URL ?? t('login-official-endpoint') }),
+                    ]);
+                });
                 return true;
             }
             case 'logout':
@@ -859,13 +924,6 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 setHelpOpen(false);
                 channel.pushLocal('/mcp', channel.mcpStatus());
                 return true;
-            case 'memory':
-                setHelpOpen(false);
-                channel.pushLocal('/memory', [
-                    t('memory-none'),
-                    t('memory-hint'),
-                ]);
-                return true;
             case 'update':
                 setHelpOpen(false);
                 if (onUpdate === undefined) {
@@ -1173,6 +1231,16 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
         // search box, which Chat would otherwise route into the prompt.
         if (browserOpen)
             return;
+        // Same for the settings screen: plain letters (s save / d discard) and
+        // the field draft editor belong to it alone.
+        if (settingsOpen)
+            return;
+        // A plugin scene (dsh-tui-scenes) or the trajectory scene owns the whole
+        // screen while open: every key belongs to it. Unguarded, an Esc meant to
+        // CLOSE the scene also reached the chat:cancel branch below whenever a
+        // turn was in flight — closing the view and killing the turn in one key.
+        if (sceneOpen || channel.pluginScene !== undefined)
+            return;
         // The questionnaire / approval panel owns the keyboard while one is
         // pending (the panel's own useInput handles ↑/↓/Space/Tab/Enter/Esc;
         // the prompt input is unmounted, so nothing else should see these keys).
@@ -1428,6 +1496,30 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
             }
             return;
         }
+        if (skillsPickerOpen) {
+            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));
+            }
+            else if (plainReturn) {
+                const skill = list[skillsIndex];
+                setSkillsPickerOpen(false);
+                // 可直调技能 Enter 填入 `/name `——与 / 菜单选中技能同一条
+                // completion-only 分发路径；模型专用技能（userInvocable=false）只关闭。
+                // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty list
+                if (skill?.userInvocable)
+                    setHistoryFill(`/${skill.name} `);
+            }
+            else if (key.escape) {
+                setSkillsPickerOpen(false);
+            }
+            return;
+        }
         if (activityPickerOpen) {
             if (key.upArrow) {
                 setActivityIndex(index => (index <= 0 ? PRESET_NAMES.length - 1 : index - 1));
@@ -1538,10 +1630,22 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 }
             }
             else if (key.leftArrow) {
-                setHistoryCursor(cursor => Math.max(0, cursor - 1));
+                // 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;
+                });
             }
             else if (key.rightArrow) {
-                setHistoryCursor(cursor => Math.min(historyQuery.length, cursor + 1));
+                setHistoryCursor(cursor => {
+                    if (cursor >= historyQuery.length)
+                        return historyQuery.length;
+                    const ch = [...historyQuery.slice(cursor)][0];
+                    return cursor + ch.length;
+                });
             }
             else if (key.home) {
                 setHistoryCursor(0);
@@ -1589,11 +1693,25 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
             return;
         }
         if (isMod(key) && input === 't') {
-            // Ctrl+T opens the trajectory scene (issue #80 evolution). It used to
-            // toggle the startup loaded-context panel — which only ever renders
-            // before the first message (see the render below), so the binding was
-            // dead for the whole rest of a session. The panel keeps its header
-            // click-to-toggle; the key now has a meaning that always applies.
+            // Ctrl+T means "expand what is in front of you", and the two things it
+            // can expand never share the screen.
+            //
+            // The startup loaded-context panel renders only while the transcript is
+            // empty (see the render below) — and that is exactly the window where
+            // the trajectory has nothing in it yet, since the trajectory is folded
+            // from the session's own events. So the panel wins while it is up, and
+            // the scene takes over for the rest of the session.
+            //
+            // Claiming the key outright for the scene was wrong even though the
+            // panel binding looked dead: the panel prints its own `（Ctrl+T 展开）`
+            // hint, so the key still had a visible promise attached to it, and the
+            // scene it opened instead was necessarily empty at that moment. That
+            // left the panel reachable only by clicking its header, which is not a
+            // keyboard path at all.
+            if (loadedContextVisible) {
+                setLoadedContextOpen(previous => !previous);
+                return;
+            }
             openScene();
             return;
         }
@@ -1689,6 +1807,32 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     // Working-activity line (spinner slot): context-pressure prefix shares the
     // StatusLine thresholds (amber ≥ 80, red ≥ 95).
     const activityWarnPct = contextPressurePct(channel.lastUsage, channel.contextWindow);
+    // A plugin scene (dsh-tui-scenes) takes the whole terminal the same way
+    // the trajectory scene does, and sits at the TOP of this return chain:
+    // an open() landing while the session browser or the trajectory scene is
+    // up must still take the screen (and the keyboard, via the useInput guard
+    // above), not queue silently behind them. Closing the plugin scene lands
+    // back on whatever screen was up before, so these early returns read as a
+    // stack. The component comes from the registry, so its identity is stable
+    // across renders and its hook state survives re-renders; it receives the
+    // TUI's own React + ui kit because a plugin importing its own React copy
+    // would die on the first hook call under this reconciler.
+    // The scene is third-party code, so it renders inside a boundary: a render
+    // crash reports to the transcript and closes the scene instead of taking
+    // the whole TUI down through ink's app-level boundary.
+    const pluginScene = channel.pluginScene;
+    if (pluginScene !== undefined) {
+        const node = (_jsx(PluginSceneBoundary, { id: pluginScene.id, onError: (id, error) => {
+                channel.notify(t('plugin-scene-crashed', { id, err: error.message }), { color: 'error' });
+                channel.closePluginScene();
+            }, children: React.createElement(pluginScene.component, {
+                React,
+                ui: tuiKit,
+                channel,
+                close: () => channel.closePluginScene(),
+            }) }));
+        return fullscreen ? node : _jsx(AlternateScreen, { children: node });
+    }
     // The browser is a screen, not an overlay: it REPLACES the conversation
     // rather than floating above it. Rendering it as an early return (after
     // every hook above has run) is what makes that literal — there is no
@@ -1699,8 +1843,15 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
         // hosts are already in it and must not nest a second one.
         return fullscreen ? browser : _jsx(AlternateScreen, { children: browser });
     }
+    // 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.
+    if (settingsOpen) {
+        const screen = _jsx(Settings, { channel: channel, onClose: () => setSettingsOpen(false) });
+        return fullscreen ? screen : _jsx(AlternateScreen, { children: screen });
+    }
     /** Prompt input is inert while a modal dialog owns the keyboard. */
-    const promptSelectionActive = selectionActive || modelPickerOpen || workspacePickerOpen || workspaceFlow !== null || activityPickerOpen ||
+    const promptSelectionActive = selectionActive || modelPickerOpen || skillsPickerOpen || workspacePickerOpen || workspaceFlow !== null || activityPickerOpen ||
         effortSliderOpen || presetPickerOpen || themePickerOpen || thinkingOpen || historyOpen || rewindOpen || searchOpen ||
         btw !== null;
     // The trajectory scene replaces the conversation for as long as it is open.
@@ -1721,7 +1872,7 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     // 常驻、只移除其普通子节点，blit 解毒不触发，被覆盖的转录行会在
     // blit-skip 后留空（Esc 关 picker 一片空白的根因）。
     const dialogOverlayOpen = thinkingOpen || (workspacePickerOpen && workspaceTargets.length > 0) || workspaceFlow !== null ||
-        modelPickerOpen ||
+        modelPickerOpen || skillsPickerOpen ||
         activityPickerOpen || (effortSliderOpen && effortOptions.length > 1) ||
         (presetPickerOpen && presetOptions.length > 0) || themePickerOpen || historyOpen ||
         rewindOpen || searchOpen;
@@ -1732,11 +1883,16 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                         seekRow(lastUser.id);
                     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 }), channel.rows.length === 0 && channel.loadedContext !== undefined && (_jsx(LoadedContextPanel, { context: channel.loadedContext, open: loadedContextOpen, onToggle: () => { setLoadedContextOpen(previous => !previous); } })), _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, 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(ScrollBox, { ref: setHandle, flexDirection: "column", flexGrow: 1, flexShrink: 1, stickyScroll: true, children: [_jsx(LogoHeader, { model: channel.model, effort: channel.reasoningEffort, cwd: channel.displayCwd }), loadedContextVisible && (_jsx(LoadedContextPanel, { context: channel.loadedContext, open: loadedContextOpen, onToggle: () => { setLoadedContextOpen(previous => !previous); } })), _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, 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 &&
                         (channel.activityEnabled &&
                             channel.workingActivity !== undefined &&
                             channel.workingActivity.line !== '' &&
-                            channel.workingActivity.phase !== 'idle' ? (_jsx(Box, { marginTop: 1, children: _jsx(ActivityLine, { activity: channel.workingActivity, activityFrames: channel.activityFrames, warnPct: activityWarnPct, warnDanger: activityWarnPct !== undefined && activityWarnPct >= 95, suffix: ` · ↓ ${channel.responseChars} tokens` }) })) : (_jsx(WorkingSpinner, { mode: channel.spinnerMode, hasActiveTools: channel.activeToolCount > 0, responseLengthRef: responseLengthRef, loadingStartTimeRef: loadingStartTimeRef, totalPausedMsRef: totalPausedMsRef, pauseStartTimeRef: pauseStartTimeRef, thinkingStatus: thinkingStatus }))), _jsx(GoalTodoPanel, { channel: channel }), approvalSnapshot !== null ? (_jsx(ApprovalPanel, { approval: approvalSnapshot, onDecide: outcome => approvals.decide(outcome) }, approvalSnapshot.key)) : 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: () => {
+                            channel.workingActivity.phase !== 'idle' ? (_jsx(Box, { marginTop: 1, children: _jsx(ActivityLine, { activity: channel.workingActivity, activityFrames: channel.activityFrames, warnPct: activityWarnPct, warnDanger: activityWarnPct !== undefined && activityWarnPct >= 95, 
+                                // Upload = real tokens of the last request; download =
+                                // 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 }), approvalSnapshot !== null ? (_jsx(ApprovalPanel, { approval: approvalSnapshot, onDecide: outcome => approvals.decide(outcome) }, approvalSnapshot.key)) : 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)
                                     process.stdout.write(raw); });
                                 channel.notify(t('copied-chars', { n: (btw.answer ?? '').length }), { timeoutMs: 1500 });
@@ -1746,7 +1902,7 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                                 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, confirmationPending: thinkingConfirm })), 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}` })) })), 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 }) })), searchOpen && _jsx(TranscriptSearchBar, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }));
+                            } }), dialogOverlayOpen && (_jsxs(OverlayAbove, { maxHeight: Math.max(terminalRows - 8, 8), children: [thinkingOpen && (_jsx(ThinkingToggle, { currentValue: thinkingVisible, focusIndex: thinkingFocus, confirmationPending: thinkingConfirm })), 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 }) })), searchOpen && _jsx(TranscriptSearchBar, { query: searchQuery, cursorOffset: searchCursor, count: searchCount, current: searchCurrent })] }))] })] }));
 }
 /**
  * The pinned prompt header shown above the ScrollBox while the user has

package/lib/types/screens/SessionBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionBrowser.d.ts","sourceRoot":"","sources":["../../../src/screens/SessionBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAsBzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAoDxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,IAAI,EACJ,WAAW,EACX,OAAO,GACR,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CAydlB"}
+{"version":3,"file":"SessionBrowser.d.ts","sourceRoot":"","sources":["../../../src/screens/SessionBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAsBzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAoDxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,IAAI,EACJ,WAAW,EACX,OAAO,GACR,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAC9C,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CAselB"}

package/lib/types/screens/SessionBrowser.js

@@ -112,6 +112,10 @@ export function SessionBrowser({ channel, home, sameProject, onClose, }) {
     const [previewOpen, setPreviewOpen] = React.useState(false);
     const [preview, setPreview] = React.useState([]);
     const [previewLoading, setPreviewLoading] = React.useState(false);
+    // React batches every parsed key from one stdin chunk. Lock actions in a
+    // ref so a repeated Enter cannot start the same async operation twice
+    // before the mode change is rendered.
+    const actionPendingRef = React.useRef(false);
     // One clock per render pass: every relative time on screen must agree, and
     // re-reading it per row would let two rows a millisecond apart round to
     // different minutes.
@@ -237,9 +241,17 @@ export function SessionBrowser({ channel, home, sameProject, onClose, }) {
         setFilters(current => ({ ...current, ...update(current) }));
         topRef.current = 0;
     };
+    const runAction = (action) => {
+        if (actionPendingRef.current)
+            return;
+        actionPendingRef.current = true;
+        void action().finally(() => {
+            actionPendingRef.current = false;
+        });
+    };
     /** Run one mutation, report it, and re-list — reporting a failure either way. */
     const mutate = (action, done, failed) => {
-        void (async () => {
+        runAction(async () => {
             let ok = false;
             let reason;
             try {
@@ -250,7 +262,7 @@ export function SessionBrowser({ channel, home, sameProject, onClose, }) {
             }
             report(ok ? done : reason === undefined ? failed : `${failed} · ${reason}`, ok ? 'info' : 'error');
             await reload();
-        })();
+        });
     };
     const runDelete = (target) => mutate(() => channel.deleteSession(target.id), t('resume-deleted', { name: target.title.text }), t('resume-delete-failed', { name: target.title.text }));
     const runRename = (target, title) => mutate(() => channel.renameSessionTo(target.id, title), t('rename-done', { title }), t('resume-rename-failed', { name: target.title.text }));
@@ -259,7 +271,7 @@ export function SessionBrowser({ channel, home, sameProject, onClose, }) {
         // below, and deleting from a list that moved under us would be a
         // destructive action aimed at whatever happens to be there now.
         const ids = [...view.emptyIds];
-        void (async () => {
+        runAction(async () => {
             let removed = 0;
             for (const id of ids) {
                 try {
@@ -272,9 +284,11 @@ export function SessionBrowser({ channel, home, sameProject, onClose, }) {
             }
             report(t('session-cleaned', { n: removed }), 'info');
             await reload();
-        })();
+        });
     };
     useInput((input, key) => {
+        if (actionPendingRef.current)
+            return;
         // A notice describes what the LAST action did; the next keystroke makes it
         // stale, so it goes as soon as the user acts again.
         if (notice !== undefined)
@@ -338,19 +352,20 @@ export function SessionBrowser({ channel, home, sameProject, onClose, }) {
             // that explanation to the conversation the user is not looking at, and
             // leave them staring at an unchanged transcript wondering what Enter
             // did. `resumeTo` reports its own reasons; this only has to stay put.
-            void channel
-                .resumeTo(target.id)
-                .then((ok) => {
-                if (ok) {
-                    channel.notify(t('resume-resumed'));
-                    onClose();
+            runAction(async () => {
+                try {
+                    const ok = await channel.resumeTo(target.id);
+                    if (ok) {
+                        channel.notify(t('resume-resumed'));
+                        onClose();
+                    }
+                    else {
+                        setNotice({ text: t('session-resume-refused'), tone: 'error' });
+                    }
                 }
-                else {
-                    setNotice({ text: t('session-resume-refused'), tone: 'error' });
+                catch (error) {
+                    setNotice({ text: t('session-resume-failed', { err: message(error) }), tone: 'error' });
                 }
-            })
-                .catch((error) => {
-                setNotice({ text: t('session-resume-failed', { err: message(error) }), tone: 'error' });
             });
         }
         else if (key.escape) {

package/lib/types/screens/Settings.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { Channel } from '../dsh-adapter/channel.js';
+/**
+ * The settings screen — `/settings` as a screen of its own (issue #165).
+ *
+ * The TUI owns only presentation here: plugin-declared sections from the
+ * `tuiSettingsSections` seam render as editable forms; every write goes back
+ * through the dsh settings service (revision-fenced `mutate` path ops) or the
+ * credentials seam (secret fields, blank-until-typed). Namespaces no plugin
+ * declared a section for stay read-only with a YAML hint — the same fallback
+ * the web front door gives namespaces without a card.
+ *
+ * Edits are staged, never settled live: typing changes a draft, and only the
+ * explicit save writes the durable document (see settingsEditor.ts for why).
+ */
+export declare function Settings({ channel, onClose, }: {
+    channel: Channel;
+    onClose: () => void;
+}): React.ReactNode;
+//# sourceMappingURL=Settings.d.ts.map

package/lib/types/screens/Settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../../src/screens/Settings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AA2CxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,OAAO,GACR,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CA0VlB"}