@deepseek-harness-tui/dsh-tui 0.8.3 → 0.8.5

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;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"}
+{"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;AA+CxD;;;;;;;;;;;;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,CA0ZlB"}

package/lib/types/screens/Settings.js

@@ -46,6 +46,7 @@ export function Settings({ channel, onClose, }) {
     const [sections, setSections] = React.useState(() => channel.settingsSections());
     const [mode, setMode] = React.useState('list');
     const [editing, setEditing] = React.useState(null);
+    const [activeGroup, setActiveGroup] = React.useState(null);
     const [focusIndex, setFocusIndex] = React.useState(0);
     const [notice, setNotice] = React.useState(undefined);
     /** Configured status of every secret field's credential ref. */
@@ -100,8 +101,26 @@ export function Settings({ channel, onClose, }) {
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [host, sections, secretProbe]);
-    /** Focusable rows in display order: every field of every section. */
-    const focusable = sections.flatMap(section => section.fields.map(field => ({ ns: section.ns, field })));
+    const activeSection = activeGroup === null ? undefined : sections.find(section => section.ns === activeGroup.ns);
+    const activeGroupSpec = activeSection?.groups?.find(group => group.id === activeGroup?.id);
+    React.useEffect(() => {
+        if (activeGroup !== null && activeGroupSpec === undefined) {
+            setActiveGroup(null);
+            setFocusIndex(0);
+            setWindowStart(0);
+        }
+    }, [activeGroup, activeGroupSpec]);
+    /** 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 }))
+        : sections.flatMap(section => [
+            ...section.fields
+                .filter(field => field.group === undefined)
+                .map(field => ({ kind: 'field', ns: section.ns, field })),
+            ...(section.groups ?? []).map(group => ({ kind: 'group', ns: section.ns, group })),
+        ]);
     const effFocus = Math.min(focusIndex, Math.max(0, focusable.length - 1));
     const focused = focusable.length === 0 ? undefined : focusable[effFocus];
     const focusedForm = focused === undefined ? undefined : forms.get(focused.ns);
@@ -173,6 +192,12 @@ export function Settings({ channel, onClose, }) {
             setFocusIndex(Math.min(Math.max(0, focusable.length - 1), effFocus + 1));
         }
         else if (isPlainReturn(key) && focused !== undefined) {
+            if (focused.kind === 'group') {
+                setActiveGroup({ ns: focused.ns, id: focused.group.id });
+                setFocusIndex(0);
+                setWindowStart(0);
+                return;
+            }
             // A save in flight owns the section's drafts; starting an edit mid-write
             // is exactly the lost-draft race the staged model exists to prevent.
             if (focusedForm === undefined || !focusedForm.available || focusedForm.saving)
@@ -196,11 +221,17 @@ export function Settings({ channel, onClose, }) {
             bump();
         }
         else if (key.escape) {
-            // Esc backs out one layer at a time: staged drafts first — ANY dirty
-            // section, not just the focused one, so leaving never silently drops
-            // an edit made two sections ago — the screen second. A save in flight
-            // cannot be undone from here; let it settle instead of discarding
-            // around it.
+            if (activeGroupSpec !== undefined) {
+                // Group navigation never settles drafts; the root page owns discard/exit.
+                setActiveGroup(null);
+                setFocusIndex(0);
+                setWindowStart(0);
+                return;
+            }
+            // At the root, Esc backs out one layer at a time: staged drafts first —
+            // ANY dirty section, not just the focused one — then the screen itself.
+            // A save in flight cannot be undone from here; let it settle instead of
+            // discarding around it.
             const dirty = [...forms.values()].filter(form => form.shell().dirty);
             if (dirty.length > 0) {
                 if (dirty.some(form => form.saving))
@@ -219,7 +250,7 @@ export function Settings({ channel, onClose, }) {
         const ns = section.ns;
         const form = forms.get(ns);
         const state = form?.field(field) ?? { text: '', overridden: false, invalid: false };
-        const isFocused = focused !== undefined && focused.ns === ns && focused.field === field;
+        const isFocused = focused?.kind === 'field' && focused.ns === ns && focused.field === field;
         const isEditing = isFocused && mode === 'edit' && editing !== null;
         const label = pick(field.label, field.descriptions);
         const hint = field.hint !== undefined ? pick(field.hint, field.hintDescriptions) : undefined;
@@ -248,58 +279,82 @@ export function Settings({ channel, onClose, }) {
         return (_jsxs(Box, { children: [_jsx(Text, { color: isFocused ? 'suggestion' : undefined, children: isFocused ? '❯ ' : '  ' }), _jsx(Text, { bold: isFocused, children: label }), _jsx(Box, { flexGrow: 1 }), state.invalid && _jsxs(Text, { color: "error", children: [t('settings-field-invalid'), " "] }), state.overridden && _jsxs(Text, { dimColor: true, children: ["[", t('settings-badge-override'), "] "] }), form?.isStaged(field) === true && !isEditing && _jsx(Text, { color: "suggestion", children: "* " }), _jsx(Text, { color: isEditing || isFocused ? 'suggestion' : undefined, dimColor: !isFocused && !isEditing && state.text === '', children: value }), hint !== undefined && isFocused && (_jsxs(Text, { dimColor: true, children: ['\n    ', hint] }))] }));
     };
     // ── Layout: a flat entry list with accounted line heights, windowed so the
-    // focused field is always on screen no matter how long the list gets. ────
+    // focused row is always on screen no matter how long the current page gets. ─
     const entries = [];
     let focusCursor = 0;
-    sections.forEach((section, sectionIndex) => {
-        const form = forms.get(section.ns);
-        const view = form?.namespace;
-        const shell = form?.shell();
+    const addField = (section, field) => {
+        const isFocused = focused?.kind === 'field' && focused.ns === section.ns && focused.field === field;
+        const index = focusCursor;
+        focusCursor += 1;
         entries.push({
-            key: `section:${section.ns}`,
-            lines: sectionIndex === 0 ? 1 : 2,
-            node: (_jsxs(Box, { flexDirection: "column", children: [sectionIndex > 0 && _jsx(Text, { children: " " }), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "permission", children: pick(section.title, section.descriptions) }), _jsxs(Text, { dimColor: true, children: [" (", section.ns, ")"] }), view?.applies === 'restart' && _jsxs(Text, { color: "warning", children: [" [", t('settings-badge-restart'), "]"] }), view === undefined && _jsxs(Text, { color: "warning", children: [" [", t('settings-section-unavailable'), "]"] }), shell?.dirty === true && _jsxs(Text, { color: "suggestion", children: [" [", t('settings-badge-dirty'), "]"] }), shell?.saving === true && _jsxs(Text, { dimColor: true, children: [" [", t('settings-badge-saving'), "]"] }), shell?.failed === true && _jsxs(Text, { color: "error", children: [" [", t('settings-badge-failed'), "]"] })] })] })),
+            key: `field:${section.ns}:${field.path.join('.')}`,
+            lines: field.hint !== undefined && isFocused ? 2 : 1,
+            focus: index,
+            node: renderField(section, field),
         });
-        for (const field of section.fields) {
-            const isFocused = focused !== undefined && focused.ns === section.ns && focused.field === field;
-            const hasHint = field.hint !== undefined && isFocused;
-            const index = focusCursor;
-            focusCursor += 1;
+    };
+    if (activeSection !== undefined && activeGroupSpec !== undefined) {
+        const groupFields = activeSection.fields.filter(field => field.group === activeGroupSpec.id);
+        for (const field of groupFields)
+            addField(activeSection, field);
+        if (groupFields.length === 0) {
+            entries.push({ key: 'group:empty', lines: 1, node: _jsx(Text, { dimColor: true, children: t('settings-group-empty') }) });
+        }
+    }
+    else {
+        sections.forEach((section, sectionIndex) => {
+            const form = forms.get(section.ns);
+            const view = form?.namespace;
+            const shell = form?.shell();
             entries.push({
-                key: `field:${section.ns}:${field.path.join('.')}`,
-                lines: hasHint ? 2 : 1,
-                focus: index,
-                node: renderField(section, field),
+                key: `section:${section.ns}`,
+                lines: sectionIndex === 0 ? 1 : 2,
+                node: (_jsxs(Box, { flexDirection: "column", children: [sectionIndex > 0 && _jsx(Text, { children: " " }), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "permission", children: pick(section.title, section.descriptions) }), _jsxs(Text, { dimColor: true, children: [" (", section.ns, ")"] }), view?.applies === 'restart' && _jsxs(Text, { color: "warning", children: [" [", t('settings-badge-restart'), "]"] }), view === undefined && _jsxs(Text, { color: "warning", children: [" [", t('settings-section-unavailable'), "]"] }), shell?.dirty === true && _jsxs(Text, { color: "suggestion", children: [" [", t('settings-badge-dirty'), "]"] }), shell?.saving === true && _jsxs(Text, { dimColor: true, children: [" [", t('settings-badge-saving'), "]"] }), shell?.failed === true && _jsxs(Text, { color: "error", children: [" [", t('settings-badge-failed'), "]"] })] })] })),
             });
-        }
-    });
-    const registeredNs = new Set(sections.map(section => section.ns));
-    const readonlyNamespaces = namespaces.filter(entry => !registeredNs.has(entry.ns));
-    if (readonlyNamespaces.length > 0) {
-        entries.push({
-            key: 'readonly:heading',
-            lines: 2,
-            node: (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsx(Text, { bold: true, dimColor: true, children: t('settings-readonly-heading') })] })),
+            for (const field of section.fields) {
+                if (field.group === undefined)
+                    addField(section, field);
+            }
+            for (const group of section.groups ?? []) {
+                const isFocused = focused?.kind === 'group' && focused.ns === section.ns && focused.group === group;
+                const index = focusCursor;
+                focusCursor += 1;
+                entries.push({
+                    key: `group:${section.ns}:${group.id}`,
+                    lines: 1,
+                    focus: index,
+                    node: (_jsxs(Box, { children: [_jsx(Text, { color: isFocused ? 'suggestion' : undefined, children: isFocused ? '❯ ' : '  ' }), _jsx(Text, { bold: isFocused, children: pick(group.title, group.descriptions) }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: isFocused ? 'suggestion' : undefined, children: "\u203A" })] })),
+                });
+            }
         });
-        for (const entry of readonlyNamespaces) {
+        const registeredNs = new Set(sections.map(section => section.ns));
+        const readonlyNamespaces = namespaces.filter(entry => !registeredNs.has(entry.ns));
+        if (readonlyNamespaces.length > 0) {
+            entries.push({
+                key: 'readonly:heading',
+                lines: 2,
+                node: (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: " " }), _jsx(Text, { bold: true, dimColor: true, children: t('settings-readonly-heading') })] })),
+            });
+            for (const entry of readonlyNamespaces) {
+                entries.push({
+                    key: `readonly:${entry.ns}`,
+                    lines: 1,
+                    node: (_jsxs(Box, { children: [_jsxs(Text, { children: ['  ', entry.ns] }), entry.applies === 'restart' && _jsxs(Text, { color: "warning", children: [" [", t('settings-badge-restart'), "]"] }), _jsxs(Text, { dimColor: true, children: ['  ', valuePreview(entry.value, 60)] })] })),
+                });
+            }
             entries.push({
-                key: `readonly:${entry.ns}`,
+                key: 'readonly:hint',
                 lines: 1,
-                node: (_jsxs(Box, { children: [_jsxs(Text, { children: ['  ', entry.ns] }), entry.applies === 'restart' && _jsxs(Text, { color: "warning", children: [" [", t('settings-badge-restart'), "]"] }), _jsxs(Text, { dimColor: true, children: ['  ', valuePreview(entry.value, 60)] })] })),
+                node: _jsxs(Text, { dimColor: true, children: ['  ', t('settings-readonly-hint', { path: '~/.dsh/settings.yaml' })] }),
+            });
+        }
+        if (sections.length === 0 && readonlyNamespaces.length === 0) {
+            entries.push({
+                key: 'empty',
+                lines: 1,
+                node: _jsx(Text, { dimColor: true, children: t('settings-empty') }),
             });
         }
-        entries.push({
-            key: 'readonly:hint',
-            lines: 1,
-            node: _jsxs(Text, { dimColor: true, children: ['  ', t('settings-readonly-hint', { path: '~/.dsh/settings.yaml' })] }),
-        });
-    }
-    if (sections.length === 0 && readonlyNamespaces.length === 0) {
-        entries.push({
-            key: 'empty',
-            lines: 1,
-            node: _jsx(Text, { dimColor: true, children: t('settings-empty') }),
-        });
     }
     // Focus-follow window: keep the focused entry fully inside the viewport.
     let totalLines = 0;
@@ -329,5 +384,9 @@ export function Settings({ channel, onClose, }) {
         entryOffset += entry.lines;
         return start >= windowStart && start + entry.lines <= windowStart + viewport;
     });
-    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: t('settings-title') }), _jsx(Box, { flexGrow: 1 }), host === undefined && _jsx(Text, { color: "warning", children: t('settings-unavailable') })] }), _jsx(Divider, {}), visible.map(entry => (_jsx(React.Fragment, { children: entry.node }, entry.key))), _jsx(Box, { flexGrow: 1 }), notice !== undefined && (_jsx(Text, { color: notice.tone === 'error' ? 'error' : 'success', children: notice.text })), _jsx(Divider, {}), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: mode === 'edit' ? t('settings-hint-edit') : t('settings-hint-list') }) })] }));
+    const title = activeSection !== undefined && activeGroupSpec !== undefined
+        ? `${t('settings-title')} › ${pick(activeSection.title, activeSection.descriptions)} › ${pick(activeGroupSpec.title, activeGroupSpec.descriptions)}`
+        : t('settings-title');
+    const navigationHint = activeGroupSpec === undefined ? t('settings-hint-list') : t('settings-hint-group');
+    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: title }), _jsx(Box, { flexGrow: 1 }), host === undefined && _jsx(Text, { color: "warning", children: t('settings-unavailable') })] }), _jsx(Divider, {}), visible.map(entry => (_jsx(React.Fragment, { children: entry.node }, entry.key))), _jsx(Box, { flexGrow: 1 }), notice !== undefined && (_jsx(Text, { color: notice.tone === 'error' ? 'error' : 'success', children: notice.text })), _jsx(Divider, {}), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: mode === 'edit' ? t('settings-hint-edit') : navigationHint }) })] }));
 }

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

@@ -28,4 +28,12 @@ export declare function StatusLine({ channel, selectionActive, helpOpen, wake, }
         tick: number;
     };
 }): React.JSX.Element;
+type UsageSnapshot = {
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+};
+/** Return the prompt-cache hit rate, or nothing when usage is unavailable. */
+export declare function formatCacheHitRate(usage: UsageSnapshot | undefined): string | undefined;
+export {};
 //# sourceMappingURL=StatusLine.d.ts.map

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,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAQvD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAuB,EACvB,QAAgB,EAChB,IAAI,GACL,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACvD,qBA2MA"}
+{"version":3,"file":"StatusLine.d.ts","sourceRoot":"","sources":["../../../src/screens/StatusLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAQvD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,eAAuB,EACvB,QAAgB,EAChB,IAAI,GACL,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACvD,qBAsPA;AAED,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvF"}

package/lib/types/screens/StatusLine.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text, useTerminalSize, useTheme } from '../ui.js';
 import { formatTokens } from '../cc/format.js';
 import { t } from '../i18n.js';
+import { formatContextUsage, normalizeStatusBar } from '../tuiDisplayPrefs.js';
 import { Byline } from '../components/design-system/Byline.js';
 import { ActivityLine, contextPressurePct } from '../components/ActivityLine.js';
 import { modeDisplayName } from '../sessionModes.js';
@@ -18,30 +19,32 @@ import { renderContextBar, renderTpsGauge, renderTpsSparkline, speedColor, } fro
 export function StatusLine({ channel, selectionActive = false, helpOpen = false, wake, }) {
     const { columns } = useTerminalSize();
     const [themeName] = useTheme();
+    const statusBar = normalizeStatusBar(channel.statusBar);
     const usage = channel.lastUsage;
+    const contextUsed = usage === undefined
+        ? undefined
+        : usage.input + usage.cacheRead + usage.cacheWrite;
     const contextParts = [];
-    // Session-mode marker (Shift+Tab cycle): hidden on the unmarked base
-    // mode (index 0); sage while a plan-declaring mode is in force.
-    if (channel.modeIndex > 0) {
-        contextParts.push(_jsx(Text, { color: channel.mode.plan === true ? 'planMode' : 'warning', children: modeDisplayName(channel.mode) }, "mode"));
-    }
-    if (channel.reasoningEffort !== undefined) {
+    if (statusBar.thinking && channel.reasoningEffort !== undefined) {
         contextParts.push(_jsx(Text, { color: "inactiveShimmer", children: channel.reasoningEffort }, "effort"));
     }
-    if (usage !== undefined && usage.cacheRead > 0) {
-        // Cache hit rate of the context fed to the model (read / total), one
-        // decimal — the absolute read count lives in the context bar's system
-        // segment, the rate is the glanceable health signal.
-        const total = usage.input + usage.cacheRead + usage.cacheWrite;
-        const rate = total > 0 ? (usage.cacheRead / total) * 100 : 0;
-        contextParts.push(_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: t('status-cache-label') }), _jsxs(Text, { color: "inactiveShimmer", children: [rate.toFixed(1), "%"] })] }, "cache"));
+    if (statusBar.mode && channel.modeIndex > 0) {
+        contextParts.push(_jsx(Text, { color: channel.mode.plan === true ? 'planMode' : 'warning', children: modeDisplayName(channel.mode) }, "mode"));
+    }
+    const formattedContext = statusBar.contextUsage
+        ? formatContextUsage(contextUsed, channel.contextWindow, statusBar.compact)
+        : undefined;
+    const contextUsagePart = formattedContext === undefined
+        ? undefined
+        : (_jsxs(Text, { color: "inactiveShimmer", children: [_jsx(Text, { dimColor: true, children: "ctx " }), formattedContext] }, "context"));
+    if (statusBar.cache) {
+        const cacheRate = formatCacheHitRate(usage);
+        if (cacheRate !== undefined) {
+            contextParts.push(_jsxs(Text, { color: "inactiveShimmer", children: [_jsx(Text, { dimColor: true, children: t('status-cache-label') }), cacheRate] }, "cache"));
+        }
     }
-    // TPS readout sits right after the model so a crowded footer truncates
-    // the trailing fields (tokens/think/cache), never the speedometer. One
-    // number only: the live value (gauge while streaming, sparkline of past
-    // turns once samples exist) — no μ/p95 clutter.
     const tpsParts = [];
-    if (channel.tps !== undefined) {
+    if (statusBar.tps && channel.tps !== undefined) {
         if (channel.working && channel.tpsSamples.length === 0) {
             tpsParts.push(_jsxs(Text, { children: [renderTpsGauge(channel.tps, channel.tps), ' ', _jsxs(Text, { dimColor: true, children: [Math.round(channel.tps), " tps"] })] }, "tps"));
         }
@@ -55,57 +58,77 @@ export function StatusLine({ channel, selectionActive = false, helpOpen = false,
             tpsParts.push(_jsxs(Text, { dimColor: true, children: [Math.round(channel.tps), " t/s"] }, "tps"));
         }
     }
-    // Left group: every field sits at soft white (inactiveShimmer) instead of
-    // the previous uniform dim grey — readable against dark terminals.
     const leftParts = [
-        _jsx(Text, { color: "inactiveShimmer", children: channel.model }, "model"),
+        ...(statusBar.model
+            ? [_jsx(Text, { color: "inactiveShimmer", children: channel.model }, "model")]
+            : []),
         ...tpsParts,
         ...contextParts,
-        _jsxs(Text, { color: "inactiveShimmer", children: [formatTokens(channel.tokens.input), "\u2192", formatTokens(channel.tokens.output)] }, "tokens"),
+        ...(statusBar.tokens
+            ? [
+                _jsxs(Text, { color: "inactiveShimmer", children: [formatTokens(channel.tokens.input), "\u2192", formatTokens(channel.tokens.output)] }, "tokens"),
+            ]
+            : []),
     ];
-    // Right group: git branch in muted steel blue, cwd a soft white, the
-    // session title dimmest (it truncates first anyway).
     const rightParts = [
-        ...(channel.gitBranch
+        ...(statusBar.gitBranch && channel.gitBranch
             ? [
                 _jsx(Text, { color: "professionalBlue", children: channel.gitBranch }, "git"),
             ]
             : []),
-        _jsx(Text, { color: "inactiveShimmer", children: basename(channel.displayCwd) }, "cwd"),
-        ...(channel.sessionTitle
+        ...(statusBar.cwd
+            ? [
+                _jsx(Text, { color: "inactiveShimmer", children: statusBar.compact ? basename(channel.displayCwd) : channel.displayCwd }, "cwd"),
+            ]
+            : []),
+        ...(statusBar.sessionTitle && channel.sessionTitle
             ? [
                 _jsx(Text, { dimColor: true, children: channel.sessionTitle }, "title"),
             ]
             : []),
     ];
-    // Row 3: the mode hint — and, while idle, the working-activity turn
-    // summary (the live working line itself moves to the spinner slot above
-    // the input while a turn runs, so the two never duplicate).
     const hint = selectionActive
-        ? 'esc to return to input'
+        ? t('statusline-hint-select')
         : channel.working
-            ? 'esc to interrupt'
-            : !helpOpen
-                ? '? for shortcuts'
+            ? t('statusline-hint-working')
+            : statusBar.shortcutHint && !helpOpen
+                ? t('statusline-hint-shortcuts')
                 : '';
     const activity = channel.workingActivity;
-    const showActivity = !channel.working &&
+    const showActivity = statusBar.activity &&
+        !channel.working &&
         activity !== undefined &&
         activity.line !== '' &&
         activity.phase !== 'idle';
+    const showTrajectory = statusBar.trajectory && wake !== undefined;
     const barWidth = columns - 4;
     let bar = null;
-    // Theme-aware free segment: the light palette's near-white fill (#E8E8E8)
-    // reads as a glaring white band on dark terminals — swap it for a deep
-    // blue-gray there while keeping the light palette as-is (dark-ansi carries
-    // `ansi:` color names, so map by theme name rather than palette tokens).
     const barColors = themeName === 'light'
         ? undefined
         : { freeFill: '#2E3440', freeText: '#8D95A6' };
-    if (channel.contextBarEnabled && barWidth >= 14 && channel.contextWindow !== undefined) {
-        bar = renderContextBar(channel.contextSegments, usage !== undefined ? usage.input + usage.cacheRead + usage.cacheWrite : 0, channel.contextWindow, barWidth, barColors);
+    if (statusBar.contextBar &&
+        channel.contextBarEnabled &&
+        barWidth >= 14 &&
+        usage !== undefined &&
+        channel.contextWindow !== undefined) {
+        bar = renderContextBar(channel.contextSegments, contextUsed ?? 0, channel.contextWindow, barWidth, barColors);
     }
-    return (_jsx(Box, { paddingX: 1, width: columns, flexShrink: 0, children: _jsxs(Box, { flexDirection: "column", width: "100%", children: [bar ? _jsx(Text, { children: bar }) : null, _jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Text, { wrap: "truncate", children: _jsx(Byline, { children: leftParts }) }), _jsx(Box, { justifyContent: "flex-end", flexShrink: 2, children: _jsx(Text, { wrap: "truncate", children: _jsx(Byline, { children: rightParts }) }) })] }), _jsxs(Box, { height: 1, overflow: "hidden", flexDirection: "row", justifyContent: "space-between", gap: 2, children: [showActivity && activity !== undefined ? (_jsx(ActivityLine, { activity: activity, activityFrames: channel.activityFrames, warnPct: contextPressurePct(usage, channel.contextWindow), warnDanger: (contextPressurePct(usage, channel.contextWindow) ?? 0) >= 95 })) : hint ? (_jsx(Text, { color: "inactiveShimmer", children: hint })) : null, showActivity && hint ? (_jsx(Text, { color: "inactiveShimmer", wrap: "truncate", children: hint })) : null, wake !== undefined ? (_jsx(MiniWake, { band: wake.band, hint: wake.hint, tick: wake.tick })) : null] })] }) }));
+    const compactLeftParts = [...leftParts, ...rightParts];
+    const fullLeftParts = contextUsagePart === undefined
+        ? leftParts
+        : [...leftParts, contextUsagePart];
+    const hasStatusFields = compactLeftParts.length > 0 || contextUsagePart !== undefined;
+    const showSupplementalRow = hint !== '' || showActivity || showTrajectory;
+    return (_jsx(Box, { paddingX: 1, width: columns, flexShrink: 0, children: _jsxs(Box, { flexDirection: "column", width: "100%", children: [bar ? _jsx(Text, { children: bar }) : null, hasStatusFields ? statusBar.compact ? (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { wrap: "truncate", children: _jsx(Byline, { children: compactLeftParts }) }) }), contextUsagePart ? (_jsx(Box, { flexShrink: 0, children: _jsx(Text, { wrap: "truncate", children: _jsx(Byline, { children: [contextUsagePart] }) }) })) : null] })) : (_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { wrap: "truncate", children: _jsx(Byline, { children: fullLeftParts }) }) }), _jsx(Box, { justifyContent: "flex-end", flexShrink: 2, children: _jsx(Text, { wrap: "truncate", children: _jsx(Byline, { children: rightParts }) }) })] })) : null, showSupplementalRow ? _jsxs(Box, { height: 1, overflow: "hidden", flexDirection: "row", justifyContent: "space-between", gap: 2, children: [_jsxs(Box, { flexDirection: "row", flexGrow: 1, justifyContent: showActivity && hint ? 'space-between' : 'flex-start', gap: 2, children: [showActivity && activity !== undefined ? (_jsx(ActivityLine, { activity: activity, activityFrames: channel.activityFrames, warnPct: contextPressurePct(usage, channel.contextWindow), warnDanger: (contextPressurePct(usage, channel.contextWindow) ?? 0) >= 95 })) : hint ? (_jsx(Text, { color: "inactiveShimmer", children: hint })) : null, showActivity && hint ? (_jsx(Text, { color: "inactiveShimmer", wrap: "truncate", children: hint })) : null] }), showTrajectory && wake !== undefined ? (_jsx(MiniWake, { band: wake.band, hint: wake.hint, tick: wake.tick })) : null] }) : null] }) }));
+}
+/** Return the prompt-cache hit rate, or nothing when usage is unavailable. */
+export function formatCacheHitRate(usage) {
+    if (usage === undefined)
+        return undefined;
+    const total = usage.input + usage.cacheRead + usage.cacheWrite;
+    if (!Number.isFinite(total) || total <= 0)
+        return undefined;
+    return `${((usage.cacheRead / total) * 100).toFixed(1)}%`;
 }
 function basename(path) {
     const parts = path.split(/[\\/]/);

package/lib/types/settings-sections.d.ts

@@ -1,4 +1,4 @@
 export { name, TuiSettingsSectionsRuntime } from './dsh-adapter/settings-sections.js';
-export type { TuiSettingsFieldKind, TuiSettingsFieldOption, TuiSettingsFieldWrite, TuiSettingsField, TuiSettingsSection, } from './dsh-adapter/settings-sections.js';
+export type { TuiSettingsFieldKind, TuiSettingsFieldOption, TuiSettingsGroup, TuiSettingsFieldWrite, TuiSettingsField, TuiSettingsSection, } from './dsh-adapter/settings-sections.js';
 export { default } from './dsh-adapter/settings-sections.js';
 //# sourceMappingURL=settings-sections.d.ts.map

package/lib/types/settings-sections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-sections.d.ts","sourceRoot":"","sources":["../../src/settings-sections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAA;AACrF,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAA"}
+{"version":3,"file":"settings-sections.d.ts","sourceRoot":"","sources":["../../src/settings-sections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAA;AACrF,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAA"}

package/lib/types/tips.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 精简 Tips 池 —— 启动首屏轮换（LogoV2）与 `/tips` 命令面板共用。
+ *
+ * 设计约定：
+ * - 每条 tip 一句话，中文 ≤ 约 60 字符、英文 ≤ 约 100 字符，首屏单行可读
+ *   （窄终端自动截断）；
+ * - 文案只讲"用户能立刻用上"的操作，不讲实现细节；
+ * - id 稳定（面板按 id 去重/排序），group 用于 `/tips` 面板分组展示；
+ * - 与 docs/user-guide.md 同源：文档是详版，这里是精版，覆盖全部功能面。
+ */
+export type TipGroup = 'keys' | 'commands' | 'workflow' | 'display' | 'pitfalls';
+export interface Tip {
+    id: string;
+    group: TipGroup;
+    zh: string;
+    en: string;
+}
+export declare const TIP_GROUP_LABELS: Record<TipGroup, {
+    zh: string;
+    en: string;
+}>;
+export declare const TIPS: readonly Tip[];
+/**
+ * 启动随机轮换选择：每次启动随机取一条，让首屏每次都有新鲜感。
+ * random 可注入以便测试固定（默认 Math.random）。
+ */
+export declare function pickRandomTip(random?: () => number): Tip;
+/** 按分组取 tips（/tips 面板展示用，保持 TIPS 内顺序）。 */
+export declare function tipsByGroup(group: TipGroup): Tip[];
+//# sourceMappingURL=tips.d.ts.map

package/lib/types/tips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../../src/tips.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAA;AAEhF,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,QAAQ,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;CACX;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAMzE,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,SAAS,GAAG,EAsiB9B,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAM,MAAoB,GAAG,GAAG,CAErE;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,EAAE,CAElD"}