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

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/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,23 @@ export type Theme = {
     diffRemovedDimmed: string;
     diffAddedWord: string;
     diffRemovedWord: string;
+    toolCardBackground: string;
+    toolCardBackgroundDim: string;
+    toolDotExec: string;
+    toolDotRead: string;
+    toolDotWrite: string;
+    toolDotWeb: string;
+    toolDotTask: 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,23 @@ 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
+    toolDotExec: rgb('#7FAE99'), // sage green — bash/pwsh
+    toolDotRead: rgb('#82B8C7'), // cyan blue — read/grep/glob
+    toolDotWrite: rgb('#B3A0D4'), // soft violet — edit/write
+    toolDotWeb: rgb('#7DA1DE'), // mist blue — web search/fetch
+    toolDotTask: rgb('#D194AE'), // mist rose — subagent/jobs
+    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 +180,23 @@ 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
+    toolDotExec: rgb('#4E7A4E'),
+    toolDotRead: rgb('#3F7E8F'),
+    toolDotWrite: rgb('#7A5CA8'),
+    toolDotWeb: rgb('#4A63A8'),
+    toolDotTask: rgb('#B04A5A'),
+    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 +276,23 @@ const darkAnsiTheme = {
     diffRemovedDimmed: 'ansi:red',
     diffAddedWord: 'ansi:greenBright',
     diffRemovedWord: 'ansi:redBright',
+    toolCardBackground: 'ansi:blackBright',
+    toolCardBackgroundDim: 'ansi:black',
+    toolDotExec: 'ansi:greenBright',
+    toolDotRead: 'ansi:cyanBright',
+    toolDotWrite: 'ansi:magentaBright',
+    toolDotWeb: 'ansi:blueBright',
+    toolDotTask: 'ansi:redBright',
+    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

@@ -9,6 +9,7 @@ export type TuiUpdateTarget = {
     kind: 'update';
     current: string;
     latest: string;
+    authoritative?: string;
 } | {
     kind: 'latest';
     current: string;
@@ -43,10 +44,29 @@ export declare function resolveDshProfileName(argv?: readonly string[]): string
 export declare function resolveRegistryBase(): string;
 /** True when `current` is a strictly newer valid version than `previous`. */
 export declare function isVersionNewer(current: string, previous: string): boolean;
+/**
+ * Versions whose compiled plugin hard-injects `tuiWorkspaces`
+ * ('0.7.0'–'0.7.1'; removed in 0.7.2). Installing one while the globally
+ * installed launcher copy predates the `dsh-tui-workspaces` patch row
+ * deadlocks boot forever at "pending (waiting for service: tuiWorkspaces)"
+ * (issues #183/#307) — and /update reaching such a target is exactly how
+ * stale-mirror installs stranded users. /update must refuse them.
+ * @param version - the candidate install target.
+ * @returns true for the known boot-deadlock version range.
+ */
+export declare function isBootDeadlockTarget(version: string): boolean;
 /**
  * Classify this install against a fresh registry lookup: an update is
  * available, the install is already latest, or the answer is unknown
  * (offline / registry error / unreadable own version).
+ *
+ * The configured registry decides the install target (pnpm must be able to
+ * fetch it), but when that registry is a mirror it can lag behind npmjs —
+ * issue #307's users were pinned onto stale versions this way. A
+ * best-effort npmjs.org check runs in parallel and surfaces as
+ * `authoritative` when it knows a strictly newer release, so callers can
+ * say "installing X now, official latest is Y" instead of silently
+ * upgrading to yesterday's version.
  */
 export declare function resolveTuiUpdateTarget(): Promise<TuiUpdateTarget>;
 /**

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;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"}
+{"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,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E;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;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AA4BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,eAAe,CAAC,CAcvE;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,CAuE1B"}

package/lib/types/update.js

@@ -3,7 +3,7 @@ import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { gt, valid } from 'semver';
+import { gte, gt, lt, valid } from 'semver';
 import { shellQuote } from './utils/shellQuote.js';
 // Re-exported for scripts/verify-update.mjs and the bin launcher, which reads
 // the compiled copy at lib/types/utils/shellQuote.js.
@@ -81,15 +81,29 @@ export function isVersionNewer(current, previous) {
     const b = valid(previous);
     return a !== null && b !== null && gt(a, b);
 }
+/**
+ * Versions whose compiled plugin hard-injects `tuiWorkspaces`
+ * ('0.7.0'–'0.7.1'; removed in 0.7.2). Installing one while the globally
+ * installed launcher copy predates the `dsh-tui-workspaces` patch row
+ * deadlocks boot forever at "pending (waiting for service: tuiWorkspaces)"
+ * (issues #183/#307) — and /update reaching such a target is exactly how
+ * stale-mirror installs stranded users. /update must refuse them.
+ * @param version - the candidate install target.
+ * @returns true for the known boot-deadlock version range.
+ */
+export function isBootDeadlockTarget(version) {
+    const v = valid(version);
+    return v !== null && gte(v, '0.7.0') && lt(v, '0.7.2');
+}
 function isRecord(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
-/** Fetch `latest` from the configured registry; undefined on any failure. */
-async function fetchLatestVersion() {
+/** Fetch `latest` from a registry; undefined on any failure. */
+async function fetchLatestVersion(registryBase) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), UPDATE_CHECK_TIMEOUT_MS);
     try {
-        const response = await fetch(`${resolveRegistryBase()}/${PACKAGE_NAME}/latest`, {
+        const response = await fetch(`${registryBase}/${PACKAGE_NAME}/latest`, {
             headers: { accept: 'application/json' },
             signal: controller.signal,
         });
@@ -112,18 +126,31 @@ async function fetchLatestVersion() {
  * Classify this install against a fresh registry lookup: an update is
  * available, the install is already latest, or the answer is unknown
  * (offline / registry error / unreadable own version).
+ *
+ * The configured registry decides the install target (pnpm must be able to
+ * fetch it), but when that registry is a mirror it can lag behind npmjs —
+ * issue #307's users were pinned onto stale versions this way. A
+ * best-effort npmjs.org check runs in parallel and surfaces as
+ * `authoritative` when it knows a strictly newer release, so callers can
+ * say "installing X now, official latest is Y" instead of silently
+ * upgrading to yesterday's version.
  */
 export async function resolveTuiUpdateTarget() {
     const current = installedTuiVersion();
     const currentVersion = current === undefined ? null : valid(current);
     if (currentVersion === null)
         return { kind: 'unknown' };
-    const latest = await fetchLatestVersion();
+    const registryBase = resolveRegistryBase();
+    const [latest, official] = await Promise.all([
+        fetchLatestVersion(registryBase),
+        registryBase === DEFAULT_REGISTRY ? undefined : fetchLatestVersion(DEFAULT_REGISTRY),
+    ]);
     if (latest === undefined)
         return { kind: 'unknown' };
     if (!gt(latest, currentVersion))
         return { kind: 'latest', current: currentVersion };
-    return { kind: 'update', current: currentVersion, latest };
+    const authoritative = official !== undefined && gt(official, latest) ? official : undefined;
+    return { kind: 'update', current: currentVersion, latest, ...(authoritative === undefined ? {} : { authoritative }) };
 }
 /**
  * Check npm for a newer published TUI version. Network and registry errors
@@ -217,6 +244,12 @@ export function isTransientUpdateFailure(stderr) {
  * @returns Exit codes for the update run and the replacement process.
  */
 export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
+    // Stamp the pre-update version BEFORE pnpm runs: it reads this package's
+    // manifest from disk, which the update replaces on the fly — a
+    // post-update read already sees the NEW version, and the restarted
+    // process then compares new-vs-new and false-alarms "version did not
+    // advance" on every successful update (issue #307's screenshots).
+    const updatedFrom = installedTuiVersion() ?? '';
     const dsh = process.platform === 'win32' ? 'dsh.cmd' : 'dsh';
     const updateArgs = tuiUpdatePluginArgs(profile, targetVersion);
     let updateStderr = '';
@@ -232,6 +265,20 @@ export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
     }
     if (updateCode !== 0)
         return { updateCode, restartCode: updateCode };
+    // A --latest fallback (preflight failed) on a stale mirror can still land
+    // on the 0.7.0–0.7.1 hard-inject range — restarting into it under an older
+    // global-launcher patch is the permanent boot deadlock of issues
+    // #183/#307. Refuse the restart when the version JUST moved there; a user
+    // who was already on it keeps their restart (their combo demonstrably
+    // boots) and gets the repair hint on the next /update instead.
+    const installedNow = installedTuiVersion();
+    if (installedNow !== undefined && installedNow !== updatedFrom && isBootDeadlockTarget(installedNow)) {
+        process.stderr.write(`dsh-tui: update landed on ${installedNow}, which can permanently deadlock boot under older launcher patches ` +
+            `(#183/#307) — NOT restarting into it. Repair with:\n` +
+            `  dsh plugin --profile ${profile} add ${PACKAGE_NAME}@latest\n` +
+            `(if the mirror has not synced the latest release yet, retry later)\n`);
+        return { updateCode: 1, restartCode: 1 };
+    }
     // Post-update verification (issue #225): pnpm can report success yet leave
     // the profile half-updated (manifest old / lockfile new). Verify against
     // the preflight target; a full `install` reconciles lockfile →
@@ -257,7 +304,7 @@ export async function updateTuiAndRestart(sessionId, profile, targetVersion) {
             // still-old TUI build reads only DSH_CC_RESUME_SESSION.
             DSH_TUI_RESUME_SESSION: sessionId,
             DSH_CC_RESUME_SESSION: sessionId,
-            [UPDATED_FROM_ENV]: installedTuiVersion() ?? '',
+            [UPDATED_FROM_ENV]: updatedFrom,
         },
     });
     return { updateCode, restartCode };