@deepseek-harness-tui/dsh-tui 0.7.3 → 0.8.1

package/lib/types/screens/Chat.js

@@ -2,15 +2,19 @@ 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';
 import { homeDir } from '../utils/paths.js';
 import { sessionCwdMatches } from '../dsh-adapter/channel.js';
+import { TuiDialogStore } from '../dsh-adapter/dialogs.js';
+import { TuiStatusStore } from '../dsh-adapter/status.js';
 import { runProviderWizard } from '../dsh-adapter/providerWizard.js';
 import { ApprovalStore } from '../dsh-adapter/approvals.js';
 import { AskUserQuestionPanel } from '../components/questions/AskUserQuestionPanel.js';
 import { ApprovalPanel } from '../components/approvals/ApprovalPanel.js';
+import { ExtensionDialog } from '../components/ExtensionDialog.js';
 import { useSearchHighlight } from '../ink/hooks/use-search-highlight.js';
 import { useTerminalTitle } from '../ink/hooks/use-terminal-title.js';
 import { useTerminalFocus } from '../ink/hooks/use-terminal-focus.js';
@@ -26,7 +30,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';
@@ -49,6 +56,7 @@ import { readTrajectorySeen, writeTrajectorySeen } from '../trajectoryPrefs.js';
 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';
 /** Shared empty snapshot for hosts whose channel has no event log. */
 const NO_EVENTS = [];
 /** Row kinds the message-selection cursor can land on. */
@@ -117,7 +125,15 @@ function searchableText(row) {
  * snapshot stays null and the approval panel never mounts.
  */
 let fallbackApprovalStore;
-export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate, fullscreen = false, trajectorySeen: trajectorySeenProp, }) {
+/**
+ * Shared inert extension stores for hosts that render Chat without the
+ * dsh-tui-extensions row (headless verify scripts, bare embeds). Never
+ * written, so the dialog panel and the plugin status line never mount and
+ * no shortcut ever matches.
+ */
+let fallbackDialogStore;
+let fallbackStatusStore;
+export function Chat({ channel, questionStore, approvalStore, extensionDialogs, extensionStatus, extensionShortcuts, onExit, onUpdate, fullscreen = false, trajectorySeen: trajectorySeenProp, }) {
     // Re-render whenever the channel mutates; rows/status are read fresh below.
     React.useSyncExternalStore(channel.subscribe, () => channel.version);
     // Re-render on language switches so the whole UI hot-swaps its strings.
@@ -131,6 +147,30 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     // approvalStore share one inert instance that never holds an ask.
     const approvals = approvalStore ?? (fallbackApprovalStore ??= new ApprovalStore());
     const approvalSnapshot = React.useSyncExternalStore(listener => approvals.subscribe(listener), () => approvals.getSnapshot());
+    // The pending managed plugin dialog (tuiDialogs seam): a plugin's
+    // select/confirm/input request parks here until the panel settles it.
+    // Priority sits right below the approval panel (a gated tool outranks a
+    // plugin's question) and above the questionnaire. Hosts without the
+    // extensions row share one inert store that never holds a dialog.
+    const dialogs = extensionDialogs ?? (fallbackDialogStore ??= new TuiDialogStore());
+    const dialogSnapshot = React.useSyncExternalStore(listener => dialogs.subscribe(listener), () => dialogs.getSnapshot());
+    // Plugin status-line contributions (tuiStatus seam): keyed texts joined
+    // into one line above the prompt.
+    const statusContributions = extensionStatus ?? (fallbackStatusStore ??= new TuiStatusStore());
+    const statusEntries = React.useSyncExternalStore(listener => statusContributions.subscribe(listener), () => statusContributions.getSnapshot());
+    // Shortcut handler failures surface as toasts (the registry also logs
+    // them); the hook is re-pointed on every mount so a stale closure never
+    // outlives its channel.
+    React.useEffect(() => {
+        if (extensionShortcuts === undefined)
+            return;
+        extensionShortcuts.onError = combo => {
+            channel.notify(t('ext-shortcut-failed', { combo }), { color: 'error', timeoutMs: 4000 });
+        };
+        return () => {
+            extensionShortcuts.onError = undefined;
+        };
+    }, [extensionShortcuts, channel]);
     // When a questionnaire batch completes, fold a Q&A summary into the
     // transcript (the tool card itself is hidden from the message list).
     const questionOpenRef = React.useRef(questionSnapshot !== null);
@@ -152,9 +192,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);
@@ -197,6 +245,17 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
     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). */
+    const rewindRequestRef = React.useRef(0);
     /** /btw side-question overlay (CC): pure UI state — the answer never
      *  enters the transcript or the session log. */
     const [btw, setBtw] = React.useState(null);
@@ -241,15 +300,7 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
         });
         setSceneOpen(true);
     }, []);
-    /** 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.
-     */
+    /** The startup summary gives way to transcript rows after the first local command or message. */
     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);
@@ -623,6 +674,16 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 setHelpOpen(false);
                 openScene();
                 return true;
+            case 'context': {
+                setHelpOpen(false);
+                const context = channel.loadedContext;
+                if (context === undefined) {
+                    channel.notify(t('context-unavailable'), { color: 'warning' });
+                    return true;
+                }
+                channel.pushLocal('/context', formatLoadedContextReport(context));
+                return true;
+            }
             case 'help':
                 setHelpOpen(true);
                 return true;
@@ -635,6 +696,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/
@@ -788,6 +866,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 = [
@@ -805,6 +890,13 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 setHelpOpen(false);
                 channel.pushLocal('/doctor', channel.doctorInfo());
                 return true;
+            case 'plugins':
+                // Plugin diagnostics (C-070): trust banner first, then descriptor /
+                // grant matrix / ledger tail — or validate+negotiate for
+                // `/plugins check <path>` (rawInput carries the subcommand).
+                setHelpOpen(false);
+                channel.pushLocal('/plugins', channel.pluginsInfo(rawInput));
+                return true;
             case 'export': {
                 const target = channel.exportSession();
                 channel.notify(target === null
@@ -888,13 +980,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) {
@@ -1019,11 +1104,32 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
         }
         setRewindIndex(0);
         setRewindConfirm(null);
+        setRewindModes(null);
+        setRewindBusy(false);
+        rewindRequestRef.current += 1;
         setRewindOpen(true);
     };
+    /**
+     * Enter on a rewind candidate: ask the plugins first (tui/rewind-prompt).
+     * A veto keeps the list open; offered modes turn the confirm pane into a
+     * choice list; "no opinion" lands on the plain confirm as before.
+     */
+    const requestRewindConfirm = async (row) => {
+        const token = ++rewindRequestRef.current;
+        setRewindBusy(true);
+        const decision = await channel.promptRewind(row);
+        if (token !== rewindRequestRef.current)
+            return;
+        setRewindBusy(false);
+        if (decision === 'cancel')
+            return;
+        setRewindConfirm(row);
+        setRewindModes(decision?.modes ?? null);
+        setRewindModeIndex(0);
+    };
     /** Execute the confirmed rewind; the message comes back into the input. */
-    const performRewind = async (row) => {
-        const text = await channel.rewindTo(row);
+    const performRewind = async (row, mode = null) => {
+        const text = await channel.rewindTo(row, mode);
         if (text !== null) {
             // CC puts the restored message back in the prompt for re-editing.
             setHistoryFill(text);
@@ -1202,10 +1308,21 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
         // search box, which Chat would otherwise route into the prompt.
         if (browserOpen)
             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).
-        if (questionSnapshot !== null || approvalSnapshot !== null)
+        // 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 / managed plugin dialog 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).
+        if (questionSnapshot !== null || approvalSnapshot !== null || dialogSnapshot !== null)
             return;
         const returnCandidate = isPlainReturnInput(input, key);
         const returnNow = Date.now();
@@ -1457,6 +1574,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));
@@ -1599,7 +1740,40 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
             return;
         }
         if (rewindOpen) {
+            // 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 (key.escape) {
+                    rewindRequestRef.current += 1;
+                    setRewindBusy(false);
+                }
+                return;
+            }
             if (rewindConfirm !== null) {
+                if (rewindModes !== 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));
+                    }
+                    else if (plainReturn) {
+                        const row = rewindConfirm;
+                        const mode = rewindModeIndex === 0 ? null : (rewindModes[rewindModeIndex - 1]?.id ?? null);
+                        setRewindOpen(false);
+                        setRewindConfirm(null);
+                        setRewindModes(null);
+                        void performRewind(row, mode);
+                    }
+                    else if (key.escape) {
+                        setRewindConfirm(null);
+                        setRewindModes(null);
+                    }
+                    return;
+                }
                 // Confirmation state: Enter rewinds, Esc backs out to the list.
                 if (plainReturn) {
                     const row = rewindConfirm;
@@ -1621,34 +1795,17 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                 const row = rewindRows[rewindIndex];
                 // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: out-of-range index on an empty list
                 if (row)
-                    setRewindConfirm(row);
+                    void requestRewindConfirm(row);
             }
             else if (key.escape) {
                 setRewindOpen(false);
                 setRewindConfirm(null);
+                setRewindModes(null);
             }
             return;
         }
         if (isMod(key) && input === 't') {
-            // 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;
-            }
+            // Ctrl+T has one stable meaning; loaded-context details live at /context.
             openScene();
             return;
         }
@@ -1740,10 +1897,45 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
         else if (plainReturn && showPill) {
             handle?.scrollToBottom();
         }
+        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
+            // registry additionally refuses the prompt editor's own combos at
+            // registration, so a plugin can never shadow anything. The handler
+            // runs fire-and-forget; its errors arrive via the onError hook
+            // (wired to the toast below).
+            event.stopImmediatePropagation();
+        }
     });
     // 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
@@ -1754,8 +1946,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.
@@ -1776,7 +1975,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;
@@ -1787,7 +1986,7 @@ 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 }), 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, 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 })), _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 !== '' &&
@@ -1796,7 +1995,7 @@ export function Chat({ channel, questionStore, approvalStore, onExit, onUpdate,
                                 // 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: () => {
+                                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)) : 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 });
@@ -1806,7 +2005,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, modes: rewindModes, modeIndex: rewindModeIndex, busy: rewindBusy }) })), 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/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"}