@deepseek-harness-tui/dsh-tui 0.12.0 → 0.14.0

package/lib/types/screens/SessionSupervisor.js

@@ -19,7 +19,7 @@ import { DSH_TAB, useForeignSessions } from './sessionSupervisor/useForeignSessi
 import { ForeignSessionPanes } from './sessionSupervisor/ForeignSessionPanes.js';
 import { SourceTabs, layoutSourceTabs, sourceTabsWidth } from '../components/sessions/SourceTabs.js';
 import { stringWidth } from '../ink/stringWidth.js';
-import { SESSION_ROW_LINES, MENU_ACTIONS, MENU_WIDTH, MENU_HEIGHT, MENU_LABEL_KEYS, samePath, sessionMatchesQuery } from './sessionSupervisor/model.js';
+import { SESSION_ROW_LINES, MENU_WIDTH, MENU_LABEL_KEYS, menuActionsFor, samePath, sessionMatchesQuery } from './sessionSupervisor/model.js';
 export { sessionMatchesQuery };
 /**
  * The unified session screen — `/resume`, `/agentview`, `/home` and the 🏠
@@ -53,7 +53,9 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
     const { columns, rows } = useTerminalSize();
     const inset = React.useContext(PageInsetContext);
     const isTerminalFocused = useTerminalFocus();
-    const { entries, sessions, loading, refreshing, notice, setNotice, query, setQuery, holderOf, listedSessions, railEntries, countOf, railFocus, setRailFocus, setFocusSessionId, activePane, pins, menu, setMenu, rename, setRename, confirmRemove, setConfirmRemove, railRef, menuRef, queryRef, now, reload, selected, visibleSessions, sessionIndex, cardFocused, sessionAt, activateList, activateRail, railWidth, railVisible, sessionWidth, railEntryCapacity, sessionListHeight, noticeRows, persistPin, selectEntry, openSession, newSessionIn, renameEntry, removeEntry, stopSession, closeMenu, activateMenu, moveRail, moveSession, focusedSession, } = useSessionSupervisor({ channel, home, onOpenSession, onNewSession, onStopSession, liveStateOf, columns, rows });
+    const { dshBackend, archiveSessions, sessionRename, setSessionRename, confirmDelete, setConfirmDelete, renameSession, deleteSession, entries, sessions, loading, refreshing, notice, setNotice, query, setQuery, holderOf, listedSessions, railEntries, countOf, railFocus, setRailFocus, setFocusSessionId, activePane, pins, menu, setMenu, rename, setRename, confirmRemove, setConfirmRemove, railRef, menuRef, queryRef, now, reload, selected, visibleSessions, sessionIndex, cardFocused, sessionAt, activateList, activateRail, railWidth, railVisible, sessionWidth, railEntryCapacity, sessionListHeight, noticeRows, persistPin, selectEntry, openSession, newSessionIn, renameEntry, removeEntry, stopSession, closeMenu, activateMenu, moveRail, moveSession, focusedSession, } = useSessionSupervisor({ channel, home, onOpenSession, onNewSession, onStopSession, liveStateOf, columns, rows });
+    const menuEntry = menu === undefined ? undefined : railEntries.find(entry => samePath(entry.path, menu.path));
+    const menuActions = menuEntry === undefined ? [] : menuActionsFor(menuEntry);
     /**
      * The source tab: this screen's own sessions ({@link DSH_TAB}) or another
      * coding agent's, by agent id. Every open starts on DSH — the screen is
@@ -65,6 +67,9 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
     const [tabMenu, setTabMenu] = useState(undefined);
     const tabMenuRef = useRef(tabMenu);
     tabMenuRef.current = tabMenu;
+    /** The session-rename draft as the keyboard sees it (see the input handler). */
+    const sessionRenameRef = useRef(sessionRename);
+    sessionRenameRef.current = sessionRename;
     const foreign = useForeignSessions({ channel, tab, registry: entries, query, setNotice, onOpenSession });
     /**
      * Only sources with data get a tab, after DSH, in a fixed order: ranking
@@ -72,10 +77,15 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
      * each time this screen opens.
      */
     const tabs = useMemo(() => {
+        // Another backend's screen lists that backend's sessions: its one tab
+        // names it (foreign imports are a DSH feature and never probed there).
+        // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: headless hosts pass partial channels
+        if (!dshBackend)
+            return [{ id: DSH_TAB, label: channel.backendCapabilities?.backendLabel ?? DSH_TAB }];
         if (foreign.sources.length === 0)
             return [];
         return [{ id: DSH_TAB, label: 'DSH' }, ...foreign.sources.map(source => ({ id: source.agentId, label: source.label }))];
-    }, [foreign.sources]);
+    }, [foreign.sources, dshBackend, channel.backendCapabilities]);
     const activeSource = foreign.sources.find(source => source.agentId === tab);
     // A source that vanished on refresh takes its tab with it; land on DSH
     // rather than on a tab the strip no longer draws.
@@ -103,6 +113,46 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
     }, [tabs, tab, switchTab]);
     useInput((input, key) => {
         // Modal layers own the keyboard, in the same order they render.
+        // The draft is read through a ref: keystrokes that arrive in one batch
+        // (typing, then Enter) must commit everything typed, not the last render.
+        const renaming = sessionRenameRef.current;
+        if (renaming !== undefined) {
+            const update = (next) => {
+                sessionRenameRef.current = next;
+                setSessionRename(next);
+            };
+            if (key.escape) {
+                update(undefined);
+                return;
+            }
+            if (isPlainReturn(key)) {
+                update(undefined);
+                renameSession(renaming.id, renaming.draft);
+                return;
+            }
+            if (key.backspace || key.delete) {
+                update({ ...renaming, draft: renaming.draft.slice(0, -1) });
+                return;
+            }
+            if (!isMod(key) && !key.meta && input && !key.return) {
+                const typed = input.replace(/[\r\n]+/gu, '');
+                if (typed !== '')
+                    update({ ...renaming, draft: renaming.draft + typed });
+            }
+            return;
+        }
+        if (confirmDelete !== undefined) {
+            if (isPlainReturn(key)) {
+                const target = listedSessions.find(candidate => candidate.id === confirmDelete);
+                setConfirmDelete(undefined);
+                if (target !== undefined)
+                    deleteSession(target);
+            }
+            else if (key.escape) {
+                setConfirmDelete(undefined);
+            }
+            return;
+        }
         if (rename !== undefined) {
             if (key.escape) {
                 setRename(undefined);
@@ -137,23 +187,25 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
             return;
         }
         if (menuRef.current !== undefined) {
+            const current = menuRef.current;
+            const entry = railEntries.find(candidate => samePath(candidate.path, current.path));
+            if (entry === undefined) {
+                closeMenu();
+                return;
+            }
+            const actionCount = menuActionsFor(entry).length;
             if (key.upArrow) {
-                const current = menuRef.current;
-                const next = { ...current, item: (current.item + MENU_ACTIONS.length - 1) % MENU_ACTIONS.length };
+                const next = { ...current, item: (current.item + actionCount - 1) % actionCount };
                 menuRef.current = next;
                 setMenu(next);
             }
             else if (key.downArrow) {
-                const current = menuRef.current;
-                const next = { ...current, item: (current.item + 1) % MENU_ACTIONS.length };
+                const next = { ...current, item: (current.item + 1) % actionCount };
                 menuRef.current = next;
                 setMenu(next);
             }
             else if (isPlainReturn(key)) {
-                const current = menuRef.current;
-                const entry = railEntries.find(candidate => samePath(candidate.path, current.path));
-                if (entry !== undefined)
-                    activateMenu(entry, current.item);
+                activateMenu(entry, current.item);
             }
             else {
                 closeMenu();
@@ -258,6 +310,21 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
                 stopSession(focusedSession);
             return;
         }
+        // Another backend's stored sessions are renamed / deleted through its
+        // catalog (the DSH screen keeps its keys exactly as they were).
+        if (!dshBackend && isMod(key) && input === 'r') {
+            if (activePane === 'list' && focusedSession !== undefined) {
+                const next = { id: focusedSession.id, draft: focusedSession.title.text };
+                sessionRenameRef.current = next;
+                setSessionRename(next);
+            }
+            return;
+        }
+        if (!dshBackend && isMod(key) && input === 'd') {
+            if (activePane === 'list' && focusedSession !== undefined)
+                setConfirmDelete(focusedSession.id);
+            return;
+        }
         if (isPlainReturn(key)) {
             // Enter means "the thing the active column is showing": its action menu
             // for a workspace, that session for the session list. Ctrl/Cmd+Enter keeps
@@ -363,7 +430,8 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
     const tabBudget = columns - stringWidth(titleText) - (showSubtitle ? stringWidth(subtitleText) : 0) - HEADER_GAPS;
     const tabLayout = layoutSourceTabs(tabs, tab, tabBudget);
     const tabMenuWidth = Math.max(12, ...tabLayout.hidden.map(hidden => stringWidth(hidden.label) + 6));
-    const withTabHint = (text) => (tabs.length === 0 ? text : `${text} · ${t('supervisor-hint-tabs')}`);
+    const withTabHint = (text) => (tabs.length < 2 ? text : `${text} · ${t('supervisor-hint-tabs')}`);
+    const listHint = dshBackend ? t('supervisor-hint-list') : t(archiveSessions ? 'supervisor-hint-list-archive' : 'supervisor-hint-list-backend');
     const railHint = rename !== undefined
         ? t('home-hint-rename')
         : confirmRemove !== undefined
@@ -372,7 +440,7 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
                 ? t('home-hint-menu')
                 : activePane === 'rail'
                     ? withTabHint(t('home-hint-list'))
-                    : withTabHint(t('supervisor-hint-list'));
+                    : withTabHint(listHint);
     const railWindowTopIndex = railWindowTop(railFocus, railEntries.length, railEntryCapacity);
     const visibleRailRows = railEntries.slice(railWindowTopIndex, railWindowTopIndex + railEntryCapacity);
     /** Content-local anchor for a keyboard-opened menu (screen coords minus inset). */
@@ -399,9 +467,11 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
                                 setTabMenu(next);
                             } }) }))] }), _jsx(Divider, { bleed: true }), tab !== DSH_TAB && (_jsx(ForeignSessionPanes, { model: foreign, sourceLabel: activeSource?.label ?? tab, home: home, now: now, query: query, notice: notice, railVisible: railVisible, railWidth: railWidth, railEntryCapacity: railEntryCapacity, sessionWidth: sessionWidth, rows: rows, isTerminalFocused: isTerminalFocused })), tab === DSH_TAB && (_jsxs(Box, { flexDirection: "row", flexGrow: 1, flexShrink: 1, overflow: "hidden", children: [railVisible && (_jsxs("ink-box", { style: { flexDirection: 'column', width: railWidth, height: '100%', flexShrink: 0, overflow: 'hidden' }, onClick: activateRail, onMouseEnter: activateRail, onWheel: (event) => {
                             moveRail(event.deltaY >= 0 ? 1 : -1);
-                        }, children: [_jsx(Box, { height: 1, flexShrink: 0, overflow: "hidden", paddingX: 1, children: _jsx(Text, { dimColor: true, children: truncateWidth(t('home-section-workspaces', { n: railEntries.length }), railWidth - 2) }) }), !loading && railEntries.length === 0 && (_jsx(Box, { paddingX: 1, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate-end", children: truncateWidth(t('home-no-workspaces'), railWidth - 2) }) })), visibleRailRows.map((entry) => {
+                        }, children: [_jsx(Box, { height: 1, flexShrink: 0, overflow: "hidden", paddingX: 1, children: _jsx(Text, { dimColor: true, children: truncateWidth(railEntries.length === entries.length
+                                        ? t('home-section-workspaces', { n: entries.length })
+                                        : t('supervisor-workspace-groups', { registered: entries.length, history: railEntries.length - entries.length }), railWidth - 2) }) }), !loading && railEntries.length === 0 && (_jsx(Box, { paddingX: 1, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate-end", children: truncateWidth(t('home-no-workspaces'), railWidth - 2) }) })), visibleRailRows.map((entry) => {
                                 const absolute = railEntries.indexOf(entry);
-                                return (_jsx(HomeWorkspaceRow, { title: entry.title, path: entry.path, home: home, sessionCount: countOf(entry), present: entry.present, selected: selected !== undefined && selected.id === entry.id, focused: activePane === 'rail' && railFocus === absolute, width: railWidth, onSelect: (event) => {
+                                return (_jsx(HomeWorkspaceRow, { title: entry.title, path: entry.path, home: home, sessionCount: countOf(entry), historyOnly: entry.from === 'unregistered', present: entry.present, selected: selected !== undefined && selected.id === entry.id, focused: activePane === 'rail' && railFocus === absolute, width: railWidth, onSelect: (event) => {
                                         event.stopImmediatePropagation();
                                         railRef.current = absolute;
                                         setRailFocus(absolute);
@@ -439,11 +509,11 @@ export function SessionSupervisor({ channel, home, onClose, onOpenSession, onNew
                                                 menuRef.current = next;
                                                 setMenu(next);
                                             } }, session.id));
-                                    })] }), _jsx(Box, { flexShrink: 0, flexDirection: "column", height: noticeRows.length, overflow: "hidden", children: noticeRows.map((line, index) => (_jsx(Text, { color: notice?.tone === 'error' ? 'error' : 'success', children: ` ${line}` }, index))) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: filtered ? t('supervisor-hint-filter') : withTabHint(t('supervisor-hint-list')) }) }) })] })] })), rename !== undefined && (_jsx(Box, { height: 1, flexShrink: 0, children: _jsx(SearchBox, { query: rename.draft, isFocused: true, isTerminalFocused: isTerminalFocused, placeholder: t('home-rename-placeholder'), prefix: "\u270E", borderless: true, width: "100%" }) })), confirmRemove !== undefined && (_jsx(Box, { flexShrink: 0, paddingX: 1, onClick: () => {
+                                    })] }), _jsx(Box, { flexShrink: 0, flexDirection: "column", height: noticeRows.length, overflow: "hidden", children: noticeRows.map((line, index) => (_jsx(Text, { color: notice?.tone === 'error' ? 'error' : 'success', children: ` ${line}` }, index))) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: sessionRename !== undefined ? t('supervisor-hint-session-rename') : filtered ? t('supervisor-hint-filter') : withTabHint(listHint) }) }) })] })] })), sessionRename !== undefined && (_jsx(Box, { height: 1, flexShrink: 0, children: _jsx(SearchBox, { query: sessionRename.draft, isFocused: true, isTerminalFocused: isTerminalFocused, placeholder: t('home-rename-placeholder'), prefix: "\u270E", borderless: true, width: "100%" }) })), confirmDelete !== undefined && (_jsx(Box, { flexShrink: 0, paddingX: 1, children: _jsx(Text, { color: "error", children: truncateWidth(` ${t(archiveSessions ? 'supervisor-archive-confirm' : 'supervisor-delete-confirm', { name: listedSessions.find(candidate => candidate.id === confirmDelete)?.title.text ?? confirmDelete })}`, columns - 3) }) })), rename !== undefined && (_jsx(Box, { height: 1, flexShrink: 0, children: _jsx(SearchBox, { query: rename.draft, isFocused: true, isTerminalFocused: isTerminalFocused, placeholder: t('home-rename-placeholder'), prefix: "\u270E", borderless: true, width: "100%" }) })), confirmRemove !== undefined && (_jsx(Box, { flexShrink: 0, paddingX: 1, onClick: () => {
                     const path = confirmRemove;
                     setConfirmRemove(undefined);
                     removeEntry(path);
-                }, children: _jsx(Text, { color: "error", children: truncateWidth(` ${t('home-remove-title', { name: railEntries.find(entry => samePath(entry.path, confirmRemove))?.title ?? confirmRemove })} · ${t('home-remove-detail')}`, columns - 3) }) })), menu !== undefined && (_jsx(Box, { position: "absolute", left: Math.max(0, Math.min(menu.col - inset.x + 1, Math.max(0, columns - MENU_WIDTH))), top: Math.max(0, Math.min(menu.row - inset.y + 1, Math.max(0, rows - MENU_HEIGHT))), width: MENU_WIDTH, height: MENU_HEIGHT, flexDirection: "column", flexShrink: 0, borderStyle: "round", borderColor: "permission", backgroundColor: "toolCardBackground", children: MENU_ACTIONS.map((action, index) => (_jsx(Box, { height: 1, flexShrink: 0, backgroundColor: index === menu.item ? 'userMessageBackgroundHover' : undefined, onMouseEnter: () => setMenu(current => (current === undefined ? current : { ...current, item: index })), onClick: (event) => {
+                }, children: _jsx(Text, { color: "error", children: truncateWidth(` ${t('home-remove-title', { name: railEntries.find(entry => samePath(entry.path, confirmRemove))?.title ?? confirmRemove })} · ${t('home-remove-detail')}`, columns - 3) }) })), menu !== undefined && menuEntry !== undefined && (_jsx(Box, { position: "absolute", left: Math.max(0, Math.min(menu.col - inset.x + 1, Math.max(0, columns - MENU_WIDTH))), top: Math.max(0, Math.min(menu.row - inset.y + 1, Math.max(0, rows - (menuActions.length + 2)))), width: MENU_WIDTH, height: menuActions.length + 2, flexDirection: "column", flexShrink: 0, borderStyle: "round", borderColor: "permission", backgroundColor: "toolCardBackground", children: menuActions.map((action, index) => (_jsx(Box, { height: 1, flexShrink: 0, backgroundColor: index === menu.item ? 'userMessageBackgroundHover' : undefined, onMouseEnter: () => setMenu(current => (current === undefined ? current : { ...current, item: index })), onClick: (event) => {
                         event.stopImmediatePropagation();
                         const entry = railEntries.find(candidate => samePath(candidate.path, menu.path));
                         if (entry !== undefined)

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

@@ -1 +1 @@
-{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../../src/screens/Settings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAkS3E;;;;;;;;;;;;;;GAcG;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,CAikBlB"}
+{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../../src/screens/Settings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAgZ3E;;;;;;;;;;;;;;GAcG;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,CA0uBlB"}

package/lib/types/screens/Settings.js

@@ -9,6 +9,49 @@ import { stringWidth } from '../ink/stringWidth.js';
 import { POINTER, TICK, MULTIPLICATION_X } from '../terminal-utils/figures.js';
 import { getLang, t } from '../i18n.js';
 import { SettingsForm } from '../dsh-adapter/settingsEditor.js';
+import { panelStore } from '../components/sidePanel/PanelStore.js';
+import { registerBuiltinPanels } from '../components/sidePanel/builtinPanels.js';
+import { SIDE_PANEL_ID_PATTERN } from '../tuiDisplayPrefs.js';
+// The panel picker enumerates the live registry: builtin panels register on
+// import (same idempotent call SidePanelColumn makes), plugins come and go
+// through ctx.tuiPanels while the screen is open.
+registerBuiltinPanels();
+/**
+ * The sidePanel.panels field renders as a checkbox multi-select over the live
+ * panel registry instead of a raw text row (its stored value stays the exact
+ * comma-separated id string — schema and persistence contract unchanged).
+ * Scoped to the TUI's own namespace so a plugin section that happens to carry
+ * the same path keeps the generic field rendering.
+ */
+function isPanelListField(ns, field) {
+    return ns === 'dsh-tui' && field.path.join('.') === 'sidePanel.panels';
+}
+/**
+ * Enabled panel ids in PanelBar order from the field's draft text — the same
+ * grammar the store normalizes (lowercase tokens, deduped, order preserved),
+ * so the checkboxes can never disagree with what the PanelBar will show.
+ */
+function panelIdsFromText(text) {
+    const seen = new Set();
+    for (const token of text.split(',')) {
+        const id = token.trim().toLowerCase();
+        if (id !== '' && SIDE_PANEL_ID_PATTERN.test(id))
+            seen.add(id);
+    }
+    return [...seen];
+}
+/** One-line descriptions for the builtin picker rows (plugin rows show their
+ * plugin id; unclaimed rows show the waiting hint). */
+const PANEL_DESCRIPTION_KEYS = {
+    todo: 'panel-desc-todo',
+    info: 'panel-desc-info',
+    trajectory: 'panel-desc-trajectory',
+    jobs: 'panel-desc-jobs',
+    agents: 'panel-desc-agents',
+    workspace: 'panel-desc-workspace',
+    btw: 'panel-desc-btw',
+    companion: 'panel-desc-companion',
+};
 function rootRowsFor(section) {
     const rows = section.fields
         .filter(field => field.group === undefined)
@@ -56,6 +99,28 @@ function FieldRow({ label, kind, value, selectLabel, focused, editing, invalid,
     const booleanChip = kind === 'boolean' && (value === 'true' || value === 'false');
     return (_jsxs(Box, { flexDirection: "row", height: 1, flexShrink: 0, overflow: "hidden", onClick: onClick, onMouseEnter: onMouseEnter, children: [_jsx(Text, { color: focused ? 'suggestion' : undefined, children: focused ? padTo(POINTER, 2) : '  ' }), _jsx(Text, { bold: focused, children: label }), _jsx(Box, { flexGrow: 1 }), invalid && _jsxs(Text, { color: "error", children: [t('settings-field-invalid'), " "] }), staged && !editing && _jsx(Text, { color: "suggestion", children: "* " }), booleanChip ? (_jsx(Text, { color: value === 'true' ? 'success' : 'inactive', children: value === 'true' ? `[${padTo(TICK, 2)}]` : '[  ]' })) : selectLabel !== undefined ? (_jsxs(Text, { children: [_jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: '‹ ' }), _jsx(Text, { color: focused ? 'suggestion' : undefined, children: selectLabel }), _jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: ' ›' })] })) : (_jsx(Text, { color: editing || focused ? 'suggestion' : undefined, dimColor: !focused && !editing && value === '', children: value }))] }));
 }
+/**
+ * One checkbox row of the sidePanel.panels picker: `❯ [✓] ≡ Todo  描述…`.
+ * Checked derives from the stored comma string; the registry supplies icon,
+ * title and the one-line description. Always exactly one line — title and
+ * description are truncated against the card width (CardTop's ladder: drop
+ * the description first, then clamp the title) so focusing never reflows.
+ */
+function PanelToggleRow({ checked, icon, title, description, focused, columns, onClick, onMouseEnter, }) {
+    // Content column: card borders (2) + CardRow padding (2); fixed prefix:
+    // pointer gutter (2) + checkbox (4) + icon + space (2).
+    const available = Math.max(12, columns - 4 - 8);
+    let titleText = title;
+    if (stringWidth(titleText) > available - 8)
+        titleText = truncateWidth(titleText, Math.max(4, available - 8));
+    const descBudget = available - stringWidth(titleText) - 2;
+    const descText = description === '' || descBudget < 6 ? '' : truncateWidth(description, descBudget);
+    return (_jsxs(Box, { flexDirection: "row", height: 1, flexShrink: 0, overflow: "hidden", onClick: onClick, onMouseEnter: onMouseEnter, children: [_jsx(Text, { color: focused ? 'suggestion' : undefined, children: focused ? padTo(POINTER, 2) : '  ' }), _jsx(Text, { color: checked ? 'success' : 'inactive', children: checked ? `[${padTo(TICK, 2)}] ` : '[  ] ' }), _jsxs(Text, { bold: focused, children: [icon, " "] }), _jsx(Text, { bold: focused, children: titleText }), descText !== '' && _jsx(Text, { dimColor: true, children: `  ${descText}` })] }));
+}
+/** The picker's non-focusable title row — the inline-group header style. */
+function PanelListHeaderRow({ title }) {
+    return (_jsx(Box, { flexDirection: "row", height: 1, flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { dimColor: true, children: ['  ', title] }) }));
+}
 /** A group navigation row — opens the group's subpage on Enter/click. */
 function GroupRow({ title, focused, onClick, onMouseEnter, }) {
     return (_jsxs(Box, { flexDirection: "row", height: 1, flexShrink: 0, overflow: "hidden", onClick: onClick, onMouseEnter: onMouseEnter, children: [_jsx(Text, { color: focused ? 'suggestion' : undefined, children: focused ? padTo(POINTER, 2) : '  ' }), _jsx(Text, { bold: focused, children: title }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: '›' })] }));
@@ -198,14 +263,46 @@ export function Settings({ channel, onClose, }) {
             setWindowStart(0);
         }
     }, [activeGroup, activeGroupSpec]);
+    /** Live panel registry: builtin + plugin:panel entries, re-rendered on
+     *  register/unregister (a plugin landing mid-session adds its row on the
+     *  open screen — the list is never a frozen snapshot). */
+    const panelEntries = React.useSyncExternalStore(panelStore.subscribe, () => panelStore.list());
+    /**
+     * Checkbox rows of one picker field, in display order: every registered
+     * panel (registry order — builtins by `order`, then plugins), then the
+     * well-formed ids nothing claims yet as checked placeholder rows (the
+     * extension story: tick a future id now, the plugin claims it later), then
+     * the advanced raw-text row.
+     */
+    const panelPickerRows = (ns, field) => {
+        const ids = panelIdsFromText(forms.get(ns)?.field(field).text ?? '');
+        const claimed = new Set(panelEntries.map(entry => entry.definition.id));
+        const rows = panelEntries.map(entry => ({ id: entry.definition.id, checked: ids.includes(entry.definition.id) }));
+        for (const id of ids) {
+            if (!claimed.has(id))
+                rows.push({ id, checked: true });
+        }
+        return rows;
+    };
+    /** Focusable entries one field contributes — a picker field fans out into
+     *  its checkbox rows plus the advanced row, in the exact order the renderer
+     *  below lays them out (the focus list and the layout share this order). */
+    const fieldEntries = (ns, field) => {
+        if (!isPanelListField(ns, field))
+            return [{ kind: 'field', ns, field }];
+        return [
+            ...panelPickerRows(ns, field).map(row => ({ kind: 'panelToggle', ns, field, panelId: row.id })),
+            { kind: 'panelAdvanced', ns, field },
+        ];
+    };
     /** Focusable rows in display order for the current page. */
     const focusable = activeSection !== undefined && activeGroupSpec !== undefined
         ? activeSection.fields
             .filter(field => field.group === activeGroupSpec.id)
-            .map(field => ({ kind: 'field', ns: activeSection.ns, field }))
+            .flatMap(field => fieldEntries(activeSection.ns, field))
         : sections.flatMap(section => rootRowsFor(section).flatMap((row) => {
             if (row.kind === 'field')
-                return [{ kind: 'field', ns: section.ns, field: row.field }];
+                return fieldEntries(section.ns, row.field);
             if (row.kind === 'page')
                 return [{ kind: 'group', ns: section.ns, group: row.group }];
             return [];
@@ -279,10 +376,35 @@ export function Settings({ channel, onClose, }) {
         bump();
         saveSoon(ns);
     };
+    /**
+     * Tick/untick one panel id. The stored string keeps its exact semantics:
+     * ids already present keep their relative order (PanelBar order is user
+     * data), a new tick appends at the end, unticking removes. An empty
+     * selection is refused — the persisted string cannot represent it (the
+     * store would fall back to the default and silently re-enable panels) — so
+     * the toggle says so instead of writing a lie.
+     */
+    const togglePanel = (ns, field, panelId) => {
+        const form = forms.get(ns);
+        if (form === undefined || !form.available)
+            return;
+        const current = panelIdsFromText(form.field(field).text);
+        const next = current.includes(panelId)
+            ? current.filter(id => id !== panelId)
+            : [...current, panelId];
+        if (next.length === 0) {
+            setNotice({ text: t('settings-panels-min-one'), tone: 'error' });
+            return;
+        }
+        form.edit(field, next.join(','));
+        bump();
+        saveSoon(ns);
+    };
     /**
      * Activate one focusable entry — the keyboard Enter path, shared with the
-     * mouse click. Groups open their subpage; boolean/select fields cycle their
-     * value; text/secret fields enter the edit mode.
+     * mouse click. Groups open their subpage; picker checkbox rows toggle their
+     * panel; boolean/select fields cycle their value; text/secret fields (and
+     * the picker's advanced row) enter the edit mode.
      */
     const activateEntry = (entry) => {
         if (entry.kind === 'group') {
@@ -291,10 +413,14 @@ export function Settings({ channel, onClose, }) {
             setWindowStart(0);
             return;
         }
+        if (entry.kind === 'panelToggle') {
+            togglePanel(entry.ns, entry.field, entry.panelId);
+            return;
+        }
         const form = forms.get(entry.ns);
         if (form === undefined || !form.available)
             return;
-        if (entry.field.kind === 'boolean' || entry.field.kind === 'select') {
+        if (entry.kind === 'field' && (entry.field.kind === 'boolean' || entry.field.kind === 'select')) {
             cycleField(entry.ns, entry.field);
         }
         else {
@@ -458,7 +584,85 @@ export function Settings({ channel, onClose, }) {
             badges.push({ text: t('settings-badge-failed'), color: 'error' });
         return badges;
     };
+    /**
+     * The picker field's block: a dim title row, one checkbox row per panel
+     * (registry order), the unclaimed placeholders, and the advanced raw-text
+     * row. Rows stay one line each, so the focus-follow windowing below needs
+     * no special casing.
+     */
+    const addPanelPicker = (section, field) => {
+        const ns = section.ns;
+        const form = forms.get(ns);
+        const state = form?.field(field) ?? { text: '', overridden: false, invalid: false };
+        const registered = new Map(panelEntries.map(entry => [entry.definition.id, entry]));
+        entries.push({
+            key: `panel-header:${ns}:${field.path.join('.')}`,
+            lines: 1,
+            node: _jsx(CardRow, { children: _jsx(PanelListHeaderRow, { title: pick(field.label, field.descriptions) }) }),
+        });
+        for (const row of panelPickerRows(ns, field)) {
+            const index = focusCursor;
+            focusCursor += 1;
+            const isFocused = focused?.kind === 'panelToggle' && focused.ns === ns && focused.field === field && focused.panelId === row.id;
+            const rowEvents = mode === 'edit'
+                ? undefined
+                : {
+                    onClick: () => {
+                        setFocusIndex(index);
+                        togglePanel(ns, field, row.id);
+                    },
+                    onMouseEnter: () => {
+                        setFocusIndex(index);
+                    },
+                };
+            const definition = registered.get(row.id)?.definition;
+            const title = definition === undefined
+                ? row.id
+                : definition.titleKey !== undefined
+                    ? t(definition.titleKey)
+                    : definition.title ?? row.id;
+            const descriptionKey = PANEL_DESCRIPTION_KEYS[row.id];
+            const description = definition === undefined
+                ? t('settings-panels-unclaimed')
+                : definition.source === 'plugin'
+                    ? t('settings-panels-plugin', { plugin: definition.pluginId ?? definition.id })
+                    : descriptionKey !== undefined ? t(descriptionKey) : '';
+            entries.push({
+                key: `panel-toggle:${ns}:${row.id}`,
+                lines: 1,
+                focus: index,
+                node: (_jsx(CardRow, { highlight: isFocused, children: _jsx(PanelToggleRow, { checked: row.checked, icon: definition?.icon ?? '·', title: title, description: description, focused: isFocused, columns: columns, onClick: rowEvents?.onClick, onMouseEnter: rowEvents?.onMouseEnter }) })),
+            });
+        }
+        // The advanced escape hatch: the same row/edit/invalid conventions as a
+        // text field, seeded with the current raw list (order edits live here).
+        const advIndex = focusCursor;
+        focusCursor += 1;
+        const advFocused = focused?.kind === 'panelAdvanced' && focused.ns === ns && focused.field === field;
+        const advEditing = advFocused && mode === 'edit' && editing !== null;
+        const advEvents = mode === 'edit'
+            ? undefined
+            : {
+                onClick: () => {
+                    setFocusIndex(advIndex);
+                    activateEntry({ kind: 'panelAdvanced', ns, field });
+                },
+                onMouseEnter: () => {
+                    setFocusIndex(advIndex);
+                },
+            };
+        entries.push({
+            key: `panel-advanced:${ns}:${field.path.join('.')}`,
+            lines: 1,
+            focus: advIndex,
+            node: (_jsx(CardRow, { highlight: advFocused, children: _jsx(FieldRow, { label: t('settings-panels-advanced'), kind: "text", value: advEditing ? `${editing?.draft ?? ''}▌` : state.text === '' ? t('settings-field-empty') : state.text, selectLabel: undefined, focused: advFocused, editing: advEditing, invalid: state.invalid, staged: form?.isStaged(field) === true, onClick: advEvents?.onClick, onMouseEnter: advEvents?.onMouseEnter }) })),
+        });
+    };
     const addField = (section, field) => {
+        if (isPanelListField(section.ns, field)) {
+            addPanelPicker(section, field);
+            return;
+        }
         const index = focusCursor;
         focusCursor += 1;
         const isFocused = focused?.kind === 'field' && focused.ns === section.ns && focused.field === field;
@@ -599,13 +803,13 @@ export function Settings({ channel, onClose, }) {
     // The bottom help bar: the focused field's hint on the left (truncated
     // first), the navigation keys pinned to the right — a truncated hint still
     // reads, a truncated shortcut hint hides the keys nobody can guess.
-    const focusedHint = focused?.kind === 'field' && focused.field.hint !== undefined
+    const focusedHint = focused !== undefined && focused.kind !== 'group' && focused.field.hint !== undefined
         ? pick(focused.field.hint, focused.field.hintDescriptions)
         : undefined;
     // A field whose user layer carries a value (settings.yaml) is "customized"
     // — worth knowing, too noisy to badge every row with. It rides the help
     // bar instead: focus the field and the suffix appears next to its hint.
-    const focusedCustomized = focused?.kind === 'field'
+    const focusedCustomized = focused !== undefined && focused.kind !== 'group'
         ? forms.get(focused.ns)?.field(focused.field).overridden === true
         : false;
     const keysLine = mode === 'edit' ? t('settings-hint-edit') : navigationHint;

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

@@ -1,11 +1,48 @@
 import React from 'react';
 import { type ActivityLineValue } from '../components/ActivityLine.js';
 import type { ChannelUi as Channel } from '../adapter/channel/ui-policy.js';
+/** 同上：partial channel 字面量可能早于 mainCost/subagentCost 字段（R4 兼容）。 */
+/** A reported session cost: `$0.0123` for USD (sub-dollar keeps 4 places,
+ *  a session often costs cents), `12.34 EUR` for any other currency. */
+export declare function formatCostReport(report: {
+    readonly currency: string;
+    readonly amount: number;
+}): string;
 import type { WaveBand } from '../dsh-adapter/types.js';
-export declare function StatusLine({ channel, selectionActive, helpOpen, wake, activity: projectedActivity, }: {
+export declare function StatusLine({ channel, selectionActive, helpOpen, backendMode, modelPicker, effortPicker, wake, activity: projectedActivity, }: {
     channel: Channel;
     selectionActive?: boolean;
     helpOpen?: boolean;
+    /** The backend's OWN permission mode (the typed `modes` capability):
+     *  `id` is the backend mode id (default / acceptEdits / plan /
+     *  bypassPermissions / dontAsk / auto …), `name` the label the backend
+     *  gives it, `onOpen` opens the same /permission picker the command does.
+     *  Present: the mode segment always shows — the base mode included, the
+     *  user asked to SEE the current permission level — and both its colour
+     *  and its text come from the backend, never from the DSH mode atoms.
+     *  It also ignores the `statusBar.mode` field switch (see the gate
+     *  below: a safety readout outranks a decoration preference); the minimal
+     *  UI is the only thing it yields to. Absent (DSH, or a backend without
+     *  modes): rendering stays byte-identical to the modeMarked rule below. */
+    backendMode?: {
+        readonly id: string;
+        readonly name: string;
+        readonly onOpen: () => void;
+    };
+    /** The model segment's click target: the same /model picker the command
+     *  opens. Present only when the backend serves a model catalog
+     *  (backendCapabilities.models — DSH and the Claude backend both do);
+     *  absent = the segment renders exactly as before, and its hover detail
+     *  keeps the pure route readout without the click affordance line. */
+    modelPicker?: {
+        readonly onOpen: () => void;
+    };
+    /** Same contract for the think-level segment and /effort: present only
+     *  when the backend serves the effort capability. The hover id rides
+     *  with it — the segment's whole detail line IS the affordance. */
+    effortPicker?: {
+        readonly onOpen: () => void;
+    };
     /** Activity value published by the working-activity plugin for this session.
      *  Preferred over the channel's own copy when the composition provides it. */
     activity?: ActivityLineValue;
@@ -32,6 +69,8 @@ type UsageSnapshot = {
     input: number;
     cacheRead: number;
     cacheWrite: number;
+    /** Sampling wall-clock (the producing message's event time). */
+    at: number;
 };
 /** Return the prompt-cache hit rate, or nothing when usage is unavailable. */
 export declare function formatCacheHitRate(usage: UsageSnapshot | undefined): string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"StatusLine.d.ts","sourceRoot":"","sources":["../../../src/screens/StatusLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAOxG,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAqB3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAqHvD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAuB,EACvB,QAAgB,EAChB,IAAI,EACJ,QAAQ,EAAE,iBAAiB,GAC5B,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,QAAQ,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,8DAA8D;QAC9D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;QACnB,2DAA2D;QAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,qBA+aA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AA0LD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EACL;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,SAAS,GACZ,MAAM,GAAG,SAAS,CAIpB"}
+{"version":3,"file":"StatusLine.d.ts","sourceRoot":"","sources":["../../../src/screens/StatusLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AASxG,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC3E,kEAAkE;AAClE;wEACwE;AACxE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKvG;AAuBD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AA4HvD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAuB,EACvB,QAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,QAAQ,EAAE,iBAAiB,GAC5B,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;;;+EAU2E;IAC3E,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAC5B,CAAA;IACD;;;;0EAIsE;IACtE,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAC5B,CAAA;IACD;;uEAEmE;IACnE,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAC5B,CAAA;IACD;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,QAAQ,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,8DAA8D;QAC9D,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;QACnB,2DAA2D;QAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,qBAifA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAgSD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EACL;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,SAAS,GACZ,MAAM,GAAG,SAAS,CAIpB"}