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

package/lib/types/screens/Settings.js

@@ -0,0 +1,333 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Text, useInput, useTerminalSize } from '../ui.js';
+import { Divider } from '../components/design-system/Divider.js';
+import { HintLine } from '../components/design-system/HintLine.js';
+import { isMod, isPlainReturn } from '../utils/modifiers.js';
+import { truncateWidth } from '../sessions/format.js';
+import { getLang, t } from '../i18n.js';
+import { SettingsForm } from '../dsh-adapter/settingsEditor.js';
+/** Pick the provider-owned translation for the active language. */
+function pick(text, descriptions) {
+    return descriptions?.[getLang()] ?? text;
+}
+/** Compact one-line preview of a read-only namespace's resolved value. */
+function valuePreview(value, budget) {
+    let raw;
+    try {
+        raw = JSON.stringify(value) ?? 'undefined';
+    }
+    catch {
+        raw = String(value);
+    }
+    return truncateWidth(raw, Math.max(8, budget));
+}
+/**
+ * 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 function Settings({ channel, onClose, }) {
+    // Explicit terminal size (not flexGrow) — the same rule SessionBrowser's
+    // root follows inside the alternate screen's fixed-height box.
+    const { columns, rows } = useTerminalSize();
+    // channel caches the host — a fresh object per call would re-fire the
+    // host-keyed effects below on every render (an endless render loop).
+    const host = channel.settingsHost();
+    const [namespaces, setNamespaces] = React.useState(() => host?.listNamespaces() ?? []);
+    const [sections, setSections] = React.useState(() => channel.settingsSections());
+    const [mode, setMode] = React.useState('list');
+    const [editing, setEditing] = React.useState(null);
+    const [focusIndex, setFocusIndex] = React.useState(0);
+    const [notice, setNotice] = React.useState(undefined);
+    /** Configured status of every secret field's credential ref. */
+    const [secrets, setSecrets] = React.useState(new Map());
+    /** First line of the windowed entry list (focus-follow scrolling). */
+    const [windowStart, setWindowStart] = React.useState(0);
+    /** Repaint after a form mutation — staged drafts live in the (React-free)
+     *  SettingsForm, so editing one changes no React state by itself. */
+    const [, bump] = React.useReducer((count) => count + 1, 0);
+    /** Async save completions must not touch state after the screen closes. */
+    const mountedRef = React.useRef(true);
+    React.useEffect(() => () => {
+        mountedRef.current = false;
+    }, []);
+    React.useEffect(() => channel.subscribeSettingsSections(() => {
+        setSections(channel.settingsSections());
+    }), [channel]);
+    // One form per section namespace. A fresh namespace view replaces the form
+    // only while it holds no edits — replacing a dirty form would discard the
+    // drafts the user is still typing.
+    const formsRef = React.useRef(new Map());
+    const forms = new Map();
+    if (host !== undefined) {
+        for (const section of sections) {
+            const view = namespaces.find(entry => entry.ns === section.ns);
+            const kept = formsRef.current.get(section.ns);
+            const reuse = kept !== undefined && (kept.namespace === view || kept.shell().dirty);
+            const form = reuse ? kept : new SettingsForm(host, view, section.fields);
+            forms.set(section.ns, form);
+        }
+    }
+    formsRef.current = forms;
+    const refresh = () => {
+        setNamespaces(host?.listNamespaces() ?? []);
+    };
+    // Secret fields report only configured/unconfigured; resolve each ref once
+    // per section-list change (and after every save, which may have set one).
+    const [secretProbe, setSecretProbe] = React.useState(0);
+    React.useEffect(() => {
+        if (host === undefined)
+            return;
+        let stale = false;
+        const pending = sections.flatMap(section => section.fields
+            .filter((field) => field.secret !== undefined)
+            .map(async (field) => [`${section.ns}:${field.path.join('.')}`, await host.credentialConfigured(field.secret.ref)]));
+        void Promise.all(pending).then(entries => {
+            if (!stale && mountedRef.current)
+                setSecrets(new Map(entries));
+        });
+        return () => {
+            stale = true;
+        };
+        // 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 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);
+    const commitSave = (ns) => {
+        const form = forms.get(ns);
+        if (form === undefined || form.saving || !form.shell().dirty)
+            return;
+        void form.save().then(ok => {
+            if (!mountedRef.current)
+                return;
+            if (ok) {
+                setNotice({ text: t('settings-saved', { ns }), tone: 'success' });
+                refresh();
+                setSecretProbe(count => count + 1);
+            }
+            else {
+                setNotice({ text: t('settings-save-failed', { ns }), tone: 'error' });
+            }
+        });
+    };
+    /** Stage the next choice for a boolean/select field (Enter cycles). */
+    const cycleField = (ns, field) => {
+        const form = forms.get(ns);
+        if (form === undefined || !form.available || form.saving)
+            return;
+        const current = form.field(field).text;
+        if (field.kind === 'boolean') {
+            form.edit(field, current === 'true' ? 'false' : 'true');
+        }
+        else {
+            const options = field.options ?? [];
+            if (options.length === 0)
+                return;
+            const index = options.findIndex(option => option.value === current);
+            form.edit(field, options[(index + 1) % options.length]?.value ?? options[0]?.value ?? '');
+        }
+        setNotice(undefined);
+        bump();
+    };
+    useInput((input, key) => {
+        if (mode === 'edit' && editing !== null) {
+            if (isPlainReturn(key)) {
+                const form = forms.get(editing.ns);
+                form?.edit(editing.field, editing.draft);
+                bump();
+                setMode('list');
+                setEditing(null);
+            }
+            else if (key.escape) {
+                setMode('list');
+                setEditing(null);
+            }
+            else if (key.backspace || key.delete) {
+                setEditing(state => state === null ? null : { ...state, draft: state.draft.slice(0, -1) });
+            }
+            else if (!isMod(key) && !key.meta && !key.super && input && !key.return) {
+                // Only real characters reach the draft (see SessionBrowser's query).
+                const typed = input.replace(/\p{Cc}/gu, '');
+                if (typed.length > 0) {
+                    setEditing(state => state === null ? null : { ...state, draft: state.draft + typed });
+                }
+            }
+            return;
+        }
+        if (key.upArrow) {
+            setFocusIndex(Math.max(0, effFocus - 1));
+        }
+        else if (key.downArrow) {
+            setFocusIndex(Math.min(Math.max(0, focusable.length - 1), effFocus + 1));
+        }
+        else if (isPlainReturn(key) && focused !== undefined) {
+            // 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)
+                return;
+            if (focused.field.kind === 'boolean' || focused.field.kind === 'select') {
+                cycleField(focused.ns, focused.field);
+            }
+            else {
+                setEditing({ ns: focused.ns, field: focused.field, draft: focusedForm.field(focused.field).text });
+                setMode('edit');
+            }
+        }
+        else if (input === 's' && focused !== undefined) {
+            commitSave(focused.ns);
+        }
+        else if (input === 'd' && focused !== undefined) {
+            if (focusedForm?.saving)
+                return;
+            focusedForm?.discard();
+            setNotice(undefined);
+            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.
+            const dirty = [...forms.values()].filter(form => form.shell().dirty);
+            if (dirty.length > 0) {
+                if (dirty.some(form => form.saving))
+                    return;
+                for (const form of dirty)
+                    form.discard();
+                setNotice({ text: t('settings-discarded'), tone: 'success' });
+                bump();
+            }
+            else {
+                onClose();
+            }
+        }
+    });
+    const renderField = (section, field) => {
+        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 isEditing = isFocused && mode === 'edit' && editing !== null;
+        const label = pick(field.label, field.descriptions);
+        const hint = field.hint !== undefined ? pick(field.hint, field.hintDescriptions) : undefined;
+        let value;
+        if (field.secret !== undefined) {
+            const configured = secrets.get(`${ns}:${field.path.join('.')}`) === true;
+            if (isEditing) {
+                value = '•'.repeat(editing?.draft.length ?? 0) + '▌';
+            }
+            else if (state.text !== '') {
+                value = `${'•'.repeat(state.text.length)} ${t('settings-secret-staged')}`;
+            }
+            else {
+                value = configured ? t('settings-secret-set') : t('settings-secret-unset');
+            }
+        }
+        else if (isEditing) {
+            value = `${editing?.draft ?? ''}▌`;
+        }
+        else if (state.text === '') {
+            value = t('settings-field-empty');
+        }
+        else {
+            value = state.text;
+        }
+        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. ────
+    const entries = [];
+    let focusCursor = 0;
+    sections.forEach((section, sectionIndex) => {
+        const form = forms.get(section.ns);
+        const view = form?.namespace;
+        const shell = form?.shell();
+        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'), "]"] })] })] })),
+        });
+        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;
+            entries.push({
+                key: `field:${section.ns}:${field.path.join('.')}`,
+                lines: hasHint ? 2 : 1,
+                focus: index,
+                node: renderField(section, field),
+            });
+        }
+    });
+    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: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;
+    let focusedOffset = 0;
+    let focusedLines = 1;
+    for (const entry of entries) {
+        if (entry.focus === effFocus) {
+            focusedOffset = totalLines;
+            focusedLines = entry.lines;
+        }
+        totalLines += entry.lines;
+    }
+    // Chrome: title row, top rule, bottom rule, hint row, plus the notice.
+    const viewport = Math.max(1, rows - 4 - (notice === undefined ? 0 : 1));
+    React.useEffect(() => {
+        setWindowStart(start => {
+            if (focusedOffset < start)
+                return focusedOffset;
+            if (focusedOffset + focusedLines > start + viewport)
+                return focusedOffset + focusedLines - viewport;
+            return start;
+        });
+    }, [focusedOffset, focusedLines, viewport]);
+    let entryOffset = 0;
+    const visible = entries.filter(entry => {
+        const start = entryOffset;
+        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') }) })] }));
+}

package/lib/types/screens/StatusLine.js

@@ -105,7 +105,7 @@ export function StatusLine({ channel, selectionActive = false, helpOpen = false,
     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);
     }
-    return (_jsx(Box, { paddingX: 2, 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] })] }) }));
+    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] })] }) }));
 }
 function basename(path) {
     const parts = path.split(/[\\/]/);

package/lib/types/sessions/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/sessions/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,EAAE,cAK7B,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1F,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAA;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACtH,WAAW,CAuFb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAK9F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAKhG;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGhG;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAoBR;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAU1F"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/sessions/view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAEtE,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe,EAAE,cAK7B,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1F,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAA;IACpC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACtH,WAAW,CAmGb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAK9F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAKhG;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGhG;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAoBR;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAU1F"}

package/lib/types/sessions/view.js

@@ -85,7 +85,19 @@ export function buildView(sessions, filters, context) {
     const rows = [];
     let shown = 0;
     let lastProject;
-    for (const session of visible.sort((left, right) => right.updatedAt - left.updatedAt)) {
+    const ordered = visible.sort((left, right) => right.updatedAt - left.updatedAt);
+    if (filters.allProjects) {
+        // Order project groups by their newest visible session, then keep every
+        // session from that project together in MRU order. A global MRU sort alone
+        // can interleave A/B/A and emit the same project header more than once.
+        const projectOrder = new Map();
+        for (const session of ordered) {
+            if (!projectOrder.has(session.cwd))
+                projectOrder.set(session.cwd, projectOrder.size);
+        }
+        ordered.sort((left, right) => projectOrder.get(left.cwd) - projectOrder.get(right.cwd) || right.updatedAt - left.updatedAt);
+    }
+    for (const session of ordered) {
         // Group headers only earn their line when more than one project is in
         // play; inside a single project they would repeat the same path forever.
         if (filters.allProjects && session.cwd !== lastProject) {

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

@@ -0,0 +1,3 @@
+export * 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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-sections.d.ts","sourceRoot":"","sources":["../../src/settings-sections.ts"],"names":[],"mappings":"AAEA,cAAc,oCAAoC,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAA"}

package/lib/types/settings-sections.js

@@ -0,0 +1,4 @@
+// Re-export shim: the Cordis-backed implementation lives behind the adapter
+// boundary so UI consumers never import official @deepseek-ai/* packages.
+export * from './dsh-adapter/settings-sections.js';
+export { default } from './dsh-adapter/settings-sections.js';

package/lib/types/theme.d.ts

@@ -47,6 +47,18 @@ export type Theme = {
     diffRemovedDimmed: string;
     diffAddedWord: string;
     diffRemovedWord: string;
+    toolCardBackground: string;
+    toolCardBackgroundDim: string;
+    syntaxKeyword: string;
+    syntaxString: string;
+    syntaxComment: string;
+    syntaxNumber: string;
+    syntaxFunction: string;
+    syntaxType: string;
+    syntaxVariable: string;
+    syntaxOperator: string;
+    syntaxPunctuation: string;
+    syntaxConstant: string;
     red_FOR_SUBAGENTS_ONLY: string;
     blue_FOR_SUBAGENTS_ONLY: string;
     green_FOR_SUBAGENTS_ONLY: string;

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

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/theme.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/theme.ts"],"names":[],"mappings":"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"}

package/lib/types/theme.js

@@ -86,6 +86,18 @@ const darkTheme = {
     diffRemovedDimmed: rgb('#362B2C'),
     diffAddedWord: rgb('#57956B'),
     diffRemovedWord: rgb('#B26671'),
+    toolCardBackground: rgb('#242B3A'), // lighter blue-grey card surface
+    toolCardBackgroundDim: rgb('#1C2330'), // deeper blue substrate
+    syntaxKeyword: rgb('#8FA8E8'), // mist blue
+    syntaxString: rgb('#9FBF8F'), // soft sage
+    syntaxComment: rgb('#6B7280'), // neutral grey
+    syntaxNumber: rgb('#D9A97E'), // warm tan
+    syntaxFunction: rgb('#82B8C7'), // cyan blue
+    syntaxType: rgb('#B39DDB'), // soft violet
+    syntaxVariable: rgb('#C9D1D9'), // near-text
+    syntaxOperator: rgb('#93A1B0'), // blue grey
+    syntaxPunctuation: rgb('#7A8694'), // dim blue grey
+    syntaxConstant: rgb('#D98C9B'), // soft rose
     red_FOR_SUBAGENTS_ONLY: rgb('#D4685E'),
     blue_FOR_SUBAGENTS_ONLY: rgb('#7496D6'),
     green_FOR_SUBAGENTS_ONLY: rgb('#66B285'),
@@ -163,6 +175,18 @@ const lightTheme = {
     diffRemovedDimmed: rgb('#F5E6E4'),
     diffAddedWord: rgb('#A9D3B4'),
     diffRemovedWord: rgb('#E5B3AE'),
+    toolCardBackground: rgb('#E9EFF9'), // cool light blue card
+    toolCardBackgroundDim: rgb('#DEE7F4'), // deeper blue-tinted substrate
+    syntaxKeyword: rgb('#4A63A8'),
+    syntaxString: rgb('#4E7A4E'),
+    syntaxComment: rgb('#8A8F98'),
+    syntaxNumber: rgb('#A96B32'),
+    syntaxFunction: rgb('#3F7E8F'),
+    syntaxType: rgb('#7A5CA8'),
+    syntaxVariable: rgb('#343945'),
+    syntaxOperator: rgb('#5B6672'),
+    syntaxPunctuation: rgb('#9AA0A8'),
+    syntaxConstant: rgb('#B04A5A'),
     red_FOR_SUBAGENTS_ONLY: rgb('#BE5A52'),
     blue_FOR_SUBAGENTS_ONLY: rgb('#3F6CC4'),
     green_FOR_SUBAGENTS_ONLY: rgb('#4E9675'),
@@ -242,6 +266,18 @@ const darkAnsiTheme = {
     diffRemovedDimmed: 'ansi:red',
     diffAddedWord: 'ansi:greenBright',
     diffRemovedWord: 'ansi:redBright',
+    toolCardBackground: 'ansi:blackBright',
+    toolCardBackgroundDim: 'ansi:black',
+    syntaxKeyword: 'ansi:blueBright',
+    syntaxString: 'ansi:greenBright',
+    syntaxComment: 'ansi:blackBright',
+    syntaxNumber: 'ansi:yellowBright',
+    syntaxFunction: 'ansi:cyanBright',
+    syntaxType: 'ansi:magentaBright',
+    syntaxVariable: 'ansi:white',
+    syntaxOperator: 'ansi:white',
+    syntaxPunctuation: 'ansi:blackBright',
+    syntaxConstant: 'ansi:redBright',
     red_FOR_SUBAGENTS_ONLY: 'ansi:redBright',
     blue_FOR_SUBAGENTS_ONLY: 'ansi:blueBright',
     green_FOR_SUBAGENTS_ONLY: 'ansi:greenBright',

package/lib/types/update.d.ts

@@ -55,22 +55,36 @@ export declare function resolveTuiUpdateTarget(): Promise<TuiUpdateTarget>;
  * or blocks the interactive TUI.
  */
 export declare function checkForTuiUpdate(): Promise<TuiUpdateInfo | undefined>;
+/** Build the profile-manager command, preferring a preflight-pinned version. */
+export declare function tuiUpdatePluginArgs(profile: string, targetVersion?: string): string[];
+/**
+ * The pnpm Windows tmp-rename race signature (issue #225): pnpm swaps a
+ * package directory via a `<name>_tmp_<pid>` staging dir, and a file lock or
+ * AV scan makes the scandir/rename fail with ENOENT/EPERM/EBUSY. The failure
+ * is transient — the identical command succeeds on retry — but the crashed
+ * run leaves a half-updated profile (manifest pins the old version while the
+ * lockfile already carries the new snapshot), which presents as "update did
+ * nothing" (#209). Genuine resolution errors never carry the `_tmp_<pid>`
+ * token, so matching both keeps the retry from masking real failures.
+ */
+export declare function isTransientUpdateFailure(stderr: string): boolean;
 /**
  * Update the installed dsh-tui package and restart the same launcher while
  * preserving the active session. The TUI must already be unmounted before
  * this is called so pnpm output cannot corrupt the rendered terminal frame.
  *
- * `--latest` is required: `pnpm add` writes a caret range into the profile
- * manifest, and a plain `pnpm update` stays inside that range — with this
- * project's minor-per-release cadence the TUI would restart unchanged while
- * reporting success. The restart carries `DSH_TUI_UPDATED_FROM` so the new
- * process can warn when the version did not actually move (e.g. a mirror
- * registry still serving the old `latest`).
+ * When the preflight registry check resolved an exact target, pass that
+ * version to pnpm instead of resolving `latest` a second time. This avoids a
+ * stale mirror/dist-tag response between the check and install. If preflight
+ * failed, retain the `--latest` fallback: a plain `pnpm update` stays inside
+ * the manifest range and can restart unchanged across minor releases.
  *
  * @param sessionId - Session to resume in the replacement process.
  * @param profile - The dsh profile this TUI was launched with; updating any
  *   other profile would leave the running install untouched.
+ * @param targetVersion - Exact version returned by the preflight registry
+ *   check, or undefined when that check failed and pnpm should resolve latest.
  * @returns Exit codes for the update run and the replacement process.
  */
-export declare function updateTuiAndRestart(sessionId: string, profile: string): Promise<TuiUpdateResult>;
+export declare function updateTuiAndRestart(sessionId: string, profile: string, targetVersion?: string): Promise<TuiUpdateResult>;
 //# sourceMappingURL=update.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlD,OAAO,EAAE,UAAU,EAAE,CAAA;AAQrB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAiBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,MAAM,GAAG,SAAS,CAahG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzE;AA4BD;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CASvE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAG5E;AAgDD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAuBtG"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/update.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIlD,OAAO,EAAE,UAAU,EAAE,CAAA;AAQrB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAiBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,MAAM,GAAG,SAAS,CAahG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIzE;AA4BD;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CASvE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAG5E;AA6DD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CAgD1B"}