@deepseek-harness-tui/dsh-tui 0.8.8 → 0.9.1

package/lib/types/screens/StatusMetrics.js

@@ -8,8 +8,10 @@
  *    yellow ≥ 20, red below.
  */
 /** Context bar segments — DeepSeek blue family (dark-theme friendly: deep
- *  navy → brand blue, neutral grey free segment; labels adapt to width). */
-const USED_SEGMENTS = [
+ *  navy → brand blue, neutral grey free segment; labels adapt to width).
+ *  Exported for the hoverable JSX bar (ContextBarView), which re-derives
+ *  the same column split this module's ANSI path renders. */
+export const USED_SEGMENTS = [
     { key: 'system', color: '#22305F', labels: ['system', 'sys', 's'] }, // deep navy
     { key: 'prompt', color: '#2B3D78', labels: ['prompt', 'pr', 'p'] }, // navy
     { key: 'assistant', color: '#344A92', labels: ['assistant', 'ast', 'a'] }, // indigo
@@ -49,7 +51,9 @@ export function formatTokens(count) {
     return `${Math.round(value / 1000000)}M`;
 }
 // --- Context bar (pi-nano-context) ---
-function centeredText(text, width) {
+/** Center `text` in `width` cells (plain spaces, no ANSI). Exported for
+ *  ContextBarView's JSX used-segment labels. */
+export function centeredText(text, width) {
     const textWidth = plainWidth(text);
     if (textWidth > width)
         return ' '.repeat(width);
@@ -57,7 +61,9 @@ function centeredText(text, width) {
     const right = width - textWidth - left;
     return `${' '.repeat(left)}${text}${' '.repeat(right)}`;
 }
-function chooseLabel(labels, width) {
+/** Pick the longest label that fits `width` cells. Exported for
+ *  ContextBarView's JSX segments (same fallback ladder as the ANSI path). */
+export function chooseLabel(labels, width) {
     for (const label of labels) {
         if (plainWidth(label) <= width)
             return label;
@@ -81,7 +87,13 @@ function chooseRightAlignedText(options, width, blockedUntil) {
     }
     return '';
 }
-function renderFreeSegment(options, width, fill, text) {
+/**
+ * Compose the free segment's plain text: the `free` label centered, the
+ * usage readout right-aligned into whatever width remains. Shared by the
+ * ANSI string path (renderContextBar) and the hoverable JSX bar
+ * (ContextBarView) so both render pixel-identical content.
+ */
+export function composeFreeSegmentText(options, width) {
     if (width <= 0)
         return '';
     const content = Array.from({ length: width }, () => ' ');
@@ -100,7 +112,12 @@ function renderFreeSegment(options, width, fill, text) {
             content[labelStart + offset] = char;
         }
     }
-    return background(fill, foreground(text, content.join('')));
+    return content.join('');
+}
+function renderFreeSegment(options, width, fill, text) {
+    if (width <= 0)
+        return '';
+    return background(fill, foreground(text, composeFreeSegmentText(options, width)));
 }
 /** Largest-remainder column allocation (pi-nano-context). */
 function allocateProportionally(values, columns) {
@@ -123,8 +140,9 @@ function allocateProportionally(values, columns) {
     }
     return allocatedColumns;
 }
-/** Give every visible used segment at least one column before sharing the rest. */
-function allocateBarColumns(values, width) {
+/** Give every visible used segment at least one column before sharing the
+ *  rest. Exported for ContextBarView (hoverable JSX twin of the bar). */
+export function allocateBarColumns(values, width) {
     const visibleUsedSegments = USED_SEGMENTS
         .map((_, index) => index)
         .filter(index => (values[index] ?? 0) > 0);
@@ -161,6 +179,43 @@ export function renderContextBar(segments, usedTokens, contextWindow, width, col
     const free = formatTokens(contextWindow - usedTokens);
     return `${used}${renderFreeSegment([`ctx ${total} ${percent} ${free}`, `${total} ${percent} ${free}`, `${total} ${percent}`, percent], freeWidth, colors?.freeFill ?? FREE_SEGMENT_FILL, colors?.freeText ?? FREE_SEGMENT_TEXT)}`;
 }
+// --- Mini context bar (footer ctx-field hover) ---
+/** Context-pressure thresholds, shared with contextPressurePct's amber/red
+ *  footer convention (amber ≥ 80%, red ≥ 95%). */
+const PRESSURE_WARN = 80;
+const PRESSURE_DANGER = 95;
+/** Pressure-colored text: green below 80%, amber ≥ 80, red ≥ 95.
+ * @param pct - Context occupancy percent (0–100+).
+ * @param text - Text to color.
+ * @returns The ANSI 24-bit color-wrapped text.
+ */
+export function pressureColor(pct, text) {
+    const key = pct >= PRESSURE_DANGER ? 'error' : pct >= PRESSURE_WARN ? 'warning' : 'success';
+    return `\x1b[38;2;${colorHex(key)}m${text}\x1b[39m`;
+}
+/** Compact 1/8-cell context gauge for the footer's ctx field on hover:
+ *  `▕██████▋···▏`, fill proportional to context occupancy, colored by the
+ *  amber/red pressure thresholds. Same block ramp as the TPS gauge.
+ * @param usedTokens - Total context tokens in use.
+ * @param contextWindow - Context window size in tokens.
+ * @param width - Gauge width in terminal columns (fill cells, brackets excluded).
+ * @returns The ANSI gauge string, or '' for a non-positive window.
+ */
+export function renderMiniContextBar(usedTokens, contextWindow, width = 10) {
+    if (contextWindow <= 0 || width <= 0)
+        return '';
+    const pct = Math.min(100, Math.max(0, (usedTokens / contextWindow) * 100));
+    const frac = pct / 100;
+    const eighths = Math.round(frac * width * 8);
+    const full = Math.floor(eighths / 8);
+    const rem = eighths % 8;
+    let fill = '█'.repeat(Math.min(full, width));
+    if (full < width && rem > 0) {
+        fill += HBLOCKS[rem];
+    }
+    const track = TRACK.repeat(Math.max(0, width - fill.length));
+    return `▕${pressureColor(pct, fill)}${`\x1b[2m${track}\x1b[22m`}▏`;
+}
 // --- TPS gauge + sparkline (pi-tps-meter) ---
 const BLOCKS = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
 const HBLOCKS = [' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉'];

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

@@ -1 +1 @@
-{"version":3,"file":"TrajectoryScene.d.ts","sourceRoot":"","sources":["../../../src/screens/TrajectoryScene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,OAAO,EAML,KAAK,SAAS,EACf,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AA+BxD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,CAAA;AAEnD,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,KAAK,EACL,OAAO,GACR,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CAyYlB"}
+{"version":3,"file":"TrajectoryScene.d.ts","sourceRoot":"","sources":["../../../src/screens/TrajectoryScene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB,OAAO,EAML,KAAK,SAAS,EACf,MAAM,oCAAoC,CAAA;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AA+BxD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,CAAA;AAEnD,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,KAAK,EACL,OAAO,GACR,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB,sDAAsD;IACtD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CA2hBlB"}

package/lib/types/screens/TrajectoryScene.js

@@ -64,6 +64,11 @@ export function TrajectoryScene({ channel, build, onClose, }) {
     const [arrivalFrom, setArrivalFrom] = React.useState(Number.MAX_SAFE_INTEGER);
     /** Cursor pinned to the tail until the user scrolls away from it. */
     const [follow, setFollow] = React.useState(true);
+    /** Mouse hover states for the tab segments and the sort/projection label. */
+    const [hoverTab, setHoverTab] = React.useState(null);
+    const [hoverAxis, setHoverAxis] = React.useState(false);
+    /** Hover state for the header ✕ exit button. */
+    const [closeHovered, setCloseHovered] = React.useState(false);
     // ── projection ───────────────────────────────────────────────────────────
     const nodes = build.nodes;
     const query = React.useMemo(() => parseQuery(queryText), [queryText]);
@@ -147,6 +152,40 @@ export function TrajectoryScene({ channel, build, onClose, }) {
         setExpanded(false);
         setInspectScroll(0);
     }, [tick]);
+    /**
+     * Jump back to the timeline, positioned on a hotspot group's first member —
+     * the keyboard Enter path, shared with the mouse row click.
+     */
+    const jumpFromHotspot = React.useCallback((row) => {
+        switchView('timeline');
+        if (row !== undefined) {
+            const target = indexes.indexOf(row.firstIndex);
+            setCursor(target >= 0 ? target : 0);
+            setFollow(false);
+        }
+    }, [indexes, switchView]);
+    /** Mouse wheel over the content area: move the selection, not a viewport. */
+    const handleWheel = React.useCallback((event) => {
+        if (view === 'hotspot') {
+            const total = hotspotRows(agg).length;
+            const direction = event.deltaY >= 0 ? 1 : -1;
+            setHotCursor(previous => Math.max(0, Math.min(total - 1, previous + direction)));
+            return;
+        }
+        if (expanded) {
+            // Expanded inspector owns the wheel: same page step as j/k.
+            const direction = event.deltaY >= 0 ? 1 : -1;
+            setInspectScroll(previous => Math.max(0, previous + direction * Math.max(1, inspectorRows - 2)));
+            return;
+        }
+        move(event.deltaY);
+    }, [view, agg, expanded, inspectorRows, move]);
+    /** Jump the timeline cursor to a filtered index (keyboard jump semantics). */
+    const jumpTo = React.useCallback((index) => {
+        setInspectScroll(0);
+        setCursor(index);
+        setFollow(index >= filtered.length - 1);
+    }, [filtered.length]);
     // ── keys ─────────────────────────────────────────────────────────────────
     useInput((input, key) => {
         // The query line owns the keyboard while open, so a `q` typed into a
@@ -208,14 +247,7 @@ export function TrajectoryScene({ channel, build, onClose, }) {
             }
             if (key.return) {
                 // Jump back to the timeline, positioned on the group's first member.
-                const row = hotspotRows(agg)[hotCursor];
-                switchView('timeline');
-                if (row !== undefined) {
-                    const target = indexes.indexOf(row.firstIndex);
-                    setCursor(target >= 0 ? target : 0);
-                    setFollow(false);
-                }
-                return;
+                return jumpFromHotspot(hotspotRows(agg)[hotCursor]);
             }
             return;
         }
@@ -286,16 +318,42 @@ export function TrajectoryScene({ channel, build, onClose, }) {
         (totals.errors > 0 ? ` \u00b7 ${t('traj-errors', { n: totals.errors })}` : '') +
         (totals.retries > 0 ? ` \u00b7 ${t('traj-retries', { n: totals.retries })}` : '') +
         ` \u00b7 ${formatDuration(totals.spanMs)}`;
-    const headerLine = spread(`\u2726 ${t('traj-title')}  ${channel.sessionTitle ?? channel.cwd}`, totalsText, bandWidth);
-    const header = (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: "claude", bold: true, children: `\u2726 ${t('traj-title')}` }), _jsx(Text, { color: "subtle", children: headerLine.left.slice((`\u2726 ${t('traj-title')}`).length) }), _jsx(Text, { children: headerLine.gap }), _jsx(Text, { color: totals.errors > 0 ? 'error' : 'subtle', children: headerLine.right })] }) }));
+    // ✕ 退出按钮占 2 格（` ✕`）：预量测行给右端留出预算，按钮钉在末列
+    const CLOSE_WIDTH = 2;
+    const headerLine = spread(`\u2726 ${t('traj-title')}  ${channel.sessionTitle ?? channel.cwd}`, totalsText, bandWidth - CLOSE_WIDTH);
+    const header = (_jsxs(Box, { width: "100%", height: 1, flexShrink: 0, children: [_jsx(Box, { flexShrink: 0, width: bandWidth - CLOSE_WIDTH, children: _jsxs(Text, { children: [_jsx(Text, { color: "claude", bold: true, children: `\u2726 ${t('traj-title')}` }), _jsx(Text, { color: "subtle", children: headerLine.left.slice((`\u2726 ${t('traj-title')}`).length) }), _jsx(Text, { children: headerLine.gap }), _jsx(Text, { color: totals.errors > 0 ? 'error' : 'subtle', children: headerLine.right })] }) }), _jsx(Box, { flexShrink: 0, width: CLOSE_WIDTH, 
+                // 可点击退出（q/Esc 的鼠标等价）——hover 提亮给出可点指示
+                onClick: () => onClose(), onMouseEnter: () => setCloseHovered(true), onMouseLeave: () => setCloseHovered(false), children: _jsx(Text, { color: closeHovered ? 'text' : 'subtle', children: ' ✕' }) })] }));
     const axisLabel = view === 'hotspot' ? t(`traj-sort-${sort}`) : t(`traj-proj-${projection}`);
-    const tabsLeft = `${view === 'timeline' ? '\u25cf' : '\u25cb'} ${t('traj-tab-timeline')}  ` +
-        `${view === 'hotspot' ? '\u25cf' : '\u25cb'} ${t('traj-tab-hotspot')}`;
+    const tabTimelineText = `${view === 'timeline' ? '\u25cf' : '\u25cb'} ${t('traj-tab-timeline')}  `;
+    const tabHotspotText = `${view === 'hotspot' ? '\u25cf' : '\u25cb'} ${t('traj-tab-hotspot')}`;
     const queryText_ = queryOpen || !query.empty
         ? `   / ${queryText}${queryOpen ? '\u258c' : ''}  ${t('traj-matches', { n: filtered.length, total: nodes.length })}`
         : '';
+    const tabsLeft = tabTimelineText + tabHotspotText;
     const tabsLine = spread(tabsLeft + queryText_, axisLabel, bandWidth);
-    const tabs = (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: view === 'timeline' ? 'permission' : 'subtle', bold: view === 'timeline', children: tabsLine.left.slice(0, tabsLeft.length) }), _jsx(Text, { color: "suggestion", children: tabsLine.left.slice(tabsLeft.length) }), _jsx(Text, { children: tabsLine.gap }), _jsx(Text, { color: "subtle", children: tabsLine.right })] }) }));
+    // Segment truncation mirrors spread's left-clip: the query tail yields
+    // first, then the far tab label — the line stays exactly one row.
+    const leftRoom = stringWidth(tabsLine.left);
+    const hotspotShown = truncateWidth(tabHotspotText, Math.max(0, leftRoom - stringWidth(tabTimelineText)));
+    const queryShown = queryText_ === ''
+        ? ''
+        : truncateWidth(queryText_, Math.max(0, leftRoom - stringWidth(tabTimelineText) - stringWidth(hotspotShown)));
+    const tabs = (_jsxs(Box, { width: "100%", height: 1, flexShrink: 0, children: [_jsx(Box, { flexShrink: 0, width: stringWidth(tabTimelineText), onClick: () => switchView('timeline'), onMouseEnter: () => setHoverTab('timeline'), onMouseLeave: () => setHoverTab(previous => (previous === 'timeline' ? null : previous)), children: _jsx(Text, { color: view === 'timeline' ? 'permission' : hoverTab === 'timeline' ? 'text' : 'subtle', bold: view === 'timeline', children: tabTimelineText }) }), _jsx(Box, { flexShrink: 0, width: stringWidth(hotspotShown), onClick: () => switchView('hotspot'), onMouseEnter: () => setHoverTab('hotspot'), onMouseLeave: () => setHoverTab(previous => (previous === 'hotspot' ? null : previous)), children: _jsx(Text, { color: view === 'hotspot' ? 'permission' : hoverTab === 'hotspot' ? 'text' : 'subtle', bold: view === 'hotspot', children: hotspotShown }) }), queryShown !== '' && (_jsx(Box, { flexShrink: 0, width: stringWidth(queryShown), onClick: () => setQueryOpen(true), children: _jsx(Text, { color: "suggestion", children: queryShown }) })), _jsx(Box, { flexGrow: 1, flexShrink: 1, onClick: () => { if (!queryOpen)
+                    setQueryOpen(true); }, children: _jsx(Text, { children: tabsLine.gap }) }), _jsx(Box, { flexShrink: 0, 
+                // +1 slack: ink breaks a wrap line exactly AT the box width, so a
+                // wide-char-ending label (按耗时) at an exact fit loses its last
+                // glyph to a clipped second line (the truncateWidth doc's trap).
+                // The flexGrow gap absorbs the extra cell.
+                width: stringWidth(tabsLine.right) + 1, onClick: () => {
+                    if (view === 'hotspot') {
+                        setSort(previous => HOTSPOT_SORTS[(HOTSPOT_SORTS.indexOf(previous) + 1) % HOTSPOT_SORTS.length]);
+                    }
+                    else {
+                        setProjection(previous => WAVE_PROJECTIONS[(WAVE_PROJECTIONS.indexOf(previous) + 1) % WAVE_PROJECTIONS.length]);
+                    }
+                    setSwitchTick(tick);
+                }, onMouseEnter: () => setHoverAxis(true), onMouseLeave: () => setHoverAxis(false), children: _jsx(Text, { color: hoverAxis ? 'text' : 'subtle', children: tabsLine.right }) })] }));
     const hints = view === 'hotspot'
         ? t('traj-hint-hotspot')
         : queryOpen
@@ -303,5 +361,14 @@ export function TrajectoryScene({ channel, build, onClose, }) {
             : expanded
                 ? t('traj-hint-expanded')
                 : t('traj-hint-timeline');
-    return (_jsxs(Box, { ref: ref, flexDirection: "column", width: "100%", paddingX: 1, children: [header, tabs, _jsx(WaveBand, { band: band, width: bandWidth, cursorColumn: columnOfIndex(band, indexes[clampedCursor] ?? 0), viewportStart: columnOfIndex(band, indexes[windowStart] ?? 0), viewportEnd: columnOfIndex(band, indexes[Math.min(filtered.length - 1, windowStart + ledgerRows - 1)] ?? 0), matches: matchColumns, tick: tick, alertTick: alertTick }), _jsx(Box, { height: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), view === 'timeline' ? (_jsxs(_Fragment, { children: [_jsx(Ledger, { rows: filtered, start: windowStart, height: ledgerRows, cursor: clampedCursor, width: columns - 4, tick: tick, arrivalTick: arrivalTick, arrivalFrom: arrivalFrom }), _jsx(Divider, { color: "permission", width: bandWidth }), _jsx(Inspector, { node: focused, detail: detail, height: inspectorRows, width: columns - 4, expanded: expanded, scroll: inspectScroll })] })) : (_jsx(HotspotView, { agg: agg, sort: sort, width: columns - 4, height: ledgerRows + inspectorRows + 1, cursor: hotCursor, tick: tick, switchTick: switchTick })), _jsx(Box, { height: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), _jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsxs(Text, { dimColor: true, italic: true, wrap: "truncate", children: [_jsx(HintLine, { text: hints }), totals.tokens.input > 0 ? (_jsx(Text, { color: "subtle", children: `   ${formatTokens(totals.tokens.input)}→${formatTokens(totals.tokens.output)}` })) : ('')] }) })] }));
+    return (_jsxs(Box, { ref: ref, flexDirection: "column", width: "100%", paddingX: 1, children: [header, tabs, _jsx(WaveBand, { band: band, width: bandWidth, cursorColumn: columnOfIndex(band, indexes[clampedCursor] ?? 0), viewportStart: columnOfIndex(band, indexes[windowStart] ?? 0), viewportEnd: columnOfIndex(band, indexes[Math.min(filtered.length - 1, windowStart + ledgerRows - 1)] ?? 0), matches: matchColumns, tick: tick, alertTick: alertTick, onColumnClick: column => {
+                    // 点击波形列（或标尺行）= 跳到该列最近事件；空列继承前驱的
+                    // firstIndex，空档区点击落在空档开始处。查询过滤掉的行不跳。
+                    const nodeIndex = band.buckets[column]?.firstIndex ?? -1;
+                    if (nodeIndex < 0)
+                        return;
+                    const target = indexes.indexOf(nodeIndex);
+                    if (target >= 0)
+                        jumpTo(target);
+                } }), _jsx(Box, { height: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), _jsx("ink-box", { style: { flexDirection: 'column', flexGrow: 1, flexShrink: 1, overflow: 'hidden', width: '100%' }, onWheel: handleWheel, children: view === 'timeline' ? (_jsxs(_Fragment, { children: [_jsx(Ledger, { rows: filtered, start: windowStart, height: ledgerRows, cursor: clampedCursor, width: columns - 4, tick: tick, arrivalTick: arrivalTick, arrivalFrom: arrivalFrom, onRowClick: index => jumpTo(index) }), _jsx(Divider, { color: "permission", width: bandWidth }), _jsx(Inspector, { node: focused, detail: detail, height: inspectorRows, width: columns - 4, expanded: expanded, scroll: inspectScroll })] })) : (_jsx(HotspotView, { agg: agg, sort: sort, width: columns - 4, height: ledgerRows + inspectorRows + 1, cursor: hotCursor, tick: tick, switchTick: switchTick, onRowClick: index => jumpFromHotspot(hotspotRows(agg)[index]) })) }), _jsx(Box, { height: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), _jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsxs(Text, { dimColor: true, italic: true, wrap: "truncate", children: [_jsx(HintLine, { text: hints }), totals.tokens.input > 0 ? (_jsx(Text, { color: "subtle", children: `   ${formatTokens(totals.tokens.input)}→${formatTokens(totals.tokens.output)}` })) : ('')] }) })] }));
 }

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

@@ -0,0 +1,237 @@
+/**
+ * The chat screen's transient-dialog layer (the pickers, dialogs and panels
+ * that float above the prompt in `<OverlayAbove>`, plus /tips) as one
+ * explicit state machine.
+ *
+ * Previously this layer lived in ~28 sibling `useState` booleans+indices in
+ * Chat.tsx, with mutual exclusion emerging from "an open picker makes the
+ * prompt inert, so no second open command can be typed", and with two
+ * hand-maintained OR-aggregates (`promptSelectionActive`,
+ * `dialogOverlayOpen`) whose comments warned they must stay exactly in sync
+ * with the per-panel render conditions. A single discriminated union makes
+ * the exclusion structural — one variable can only hold one variant — and
+ * turns both aggregates into derivations that cannot drift.
+ *
+ * Design constraints, in order:
+ *   1. Behavior-preserving: every keyboard path, open/close side effect and
+ *      async-callback landing keeps its observable behavior. The one
+ *      deliberate change: an async OPEN landing while another overlay is up
+ *      (e.g. `/effort`'s listEfforts resolving after the user opened
+ *      `/model`) now REPLACES it instead of stacking two panels — the
+ *      stacked rendering was an unreachable-by-keyboard race, not a feature.
+ *   2. Pure and total: the reducer is a plain function, unit-tested by
+ *      scripts/verify-chat-overlay.ts without a renderer. Actions that no
+ *      longer apply (an async result landing after the overlay changed) are
+ *      ignored rather than writing orphan state.
+ *   3. Async data caches (model list, preset roster, …) stay OUTSIDE the
+ *      union in Chat.tsx: they persist across open/close so a reopened
+ *      picker can paint the previous list while the fresh one loads,
+ *      exactly as before.
+ */
+import type { ChatRow } from '../dsh-adapter/channel.js';
+import type { TuiRewindMode } from '../dsh-adapter/extension-events.js';
+import type { TuiWorkspaceCommandResult } from '../workspaces.js';
+/** The `kind: 'choices'` result a workspace command can return. */
+export type WorkspaceFlowChoices = Extract<TuiWorkspaceCommandResult, {
+    kind: 'choices';
+}>;
+/** Text-entry sub-state of the workspace flow (Tab into a choice's input). */
+export type WorkspaceFlowInput = {
+    choiceId: string;
+    value: string;
+    cursor: number;
+    placeholder?: string;
+};
+export type ChatOverlay = {
+    kind: 'none';
+} | {
+    kind: 'thinking';
+    focus: number;
+} | {
+    kind: 'workspace-picker';
+    index: number;
+} | {
+    kind: 'workspace-menu';
+    index: number;
+} | {
+    kind: 'workspace-flow';
+    flow: WorkspaceFlowChoices;
+    index: number;
+    busy: boolean;
+    input: WorkspaceFlowInput | null;
+} | {
+    kind: 'model';
+    index: number;
+} | {
+    kind: 'skills';
+    index: number;
+} | {
+    kind: 'activity';
+    index: number;
+} | {
+    kind: 'color';
+    index: number;
+} | {
+    kind: 'effort';
+    index: number;
+} | {
+    kind: 'preset';
+    index: number;
+} | {
+    kind: 'theme';
+    index: number;
+} | {
+    kind: 'permission';
+    index: number;
+} | {
+    kind: 'plan';
+    index: number;
+} | {
+    kind: 'lang';
+    index: number;
+} | {
+    kind: 'history';
+    query: string;
+    cursor: number;
+    focus: number;
+} | {
+    kind: 'rewind';
+    index: number;
+    confirm: ChatRow | null;
+    modes: readonly TuiRewindMode[] | null;
+    modeIndex: number;
+    busy: boolean;
+} | {
+    kind: 'search';
+} | {
+    kind: 'tips';
+}
+/**
+ * Click-to-act file menu: opened by clicking a file path in the
+ * transcript (tool cards, markdown code spans / plain text, file://
+ * links). `index` is the focused action row (0 = open, 1 = reveal in
+ * file manager, 2 = copy absolute path). `isDir` tells the panel whether
+ * the target is a directory (first row reads "open folder").
+ */
+ | {
+    kind: 'file-actions';
+    path: string;
+    index: number;
+    isDir: boolean;
+};
+export declare const NO_OVERLAY: ChatOverlay;
+export type ChatOverlayAction = 
+/** Open a variant, replacing whatever is up (including `none`). */
+{
+    type: 'open';
+    overlay: ChatOverlay;
+}
+/** Close unconditionally (only dispatched from the open overlay's own keys). */
+ | {
+    type: 'close';
+}
+/** Close only if the given kind is still up — the safe form for async
+ *  callbacks (a loader failing after the user already moved on). */
+ | {
+    type: 'close-if';
+    kind: ChatOverlay['kind'];
+}
+/**
+ * Open only while the current kind is one of `when` — the safe form for an
+ * OPEN that arrives from an async callback (`/effort`'s level list, the
+ * workspace target list, a workspace command's choices). A user who opened
+ * something else during the round trip keeps what they opened; the stale
+ * open is dropped. Synchronous opens keep using plain `open`.
+ */
+ | {
+    type: 'open-if';
+    overlay: ChatOverlay;
+    when: readonly ChatOverlay['kind'][];
+}
+/**
+ * Move the focused row by one with wrap-around, over a list of `count`
+ * entries. On `rewind` this targets whichever cursor the sub-state focuses
+ * (mode list when a plugin offered modes, else the candidate list). A
+ * `count <= 0` move is a no-op (an empty list has no focus to move).
+ */
+ | {
+    type: 'move';
+    delta: 1 | -1;
+    count: number;
+}
+/** Set the focused row to an absolute index — an async loader landing
+ *  with the authoritative focus (model list / preset roster), or a mouse
+ *  click on a row of a panel that stays open (effort slider, workspace
+ *  flow). Ignored unless that panel is still up. */
+ | {
+    type: 'set-index';
+    kind: 'model' | 'preset' | 'effort' | 'workspace-flow' | 'rewind' | 'file-actions';
+    index: number;
+}
+/** Edit the history-search draft (query text, caret, focused match). */
+ | {
+    type: 'history-edit';
+    query?: string;
+    cursor?: number;
+    focus?: number;
+}
+/** Workspace flow: an action is running (keys except Esc are swallowed). */
+ | {
+    type: 'flow-busy';
+    busy: boolean;
+}
+/** Workspace flow: enter (object) or leave (null) the text-input state. */
+ | {
+    type: 'flow-input';
+    input: WorkspaceFlowInput | null;
+}
+/** Workspace flow: edit the text-input draft in place. */
+ | {
+    type: 'flow-input-edit';
+    value: string;
+    cursor: number;
+}
+/** Rewind: the plugin decision round-trip started / was abandoned. */
+ | {
+    type: 'rewind-busy';
+    busy: boolean;
+}
+/** Rewind: the plugin decision landed — show the confirm pane (modes turn
+ *  it into a choice list). Stale decisions are dropped by the caller's
+ *  request token before dispatch; a changed overlay drops them here. */
+ | {
+    type: 'rewind-decision';
+    confirm: ChatRow;
+    modes: readonly TuiRewindMode[] | null;
+}
+/** Rewind: Esc from the confirm/modes pane back to the candidate list. */
+ | {
+    type: 'rewind-back';
+};
+/**
+ * One-step wrap-around cursor move — the single source of the wrapping rule
+ * every list overlay uses (Chat.tsx's effort slider reads it too, to apply
+ * the newly focused level in the same keystroke that dispatches the move).
+ */
+export declare function wrapIndex(index: number, delta: 1 | -1, count: number): number;
+export declare function chatOverlayReducer(state: ChatOverlay, action: ChatOverlayAction): ChatOverlay;
+/**
+ * Whether the `<OverlayAbove>` wrapper mounts. Mounting is all-or-nothing:
+ * the renderer's removed-absolute-node blit detection only fires when the
+ * removed subtree itself is `position: absolute` (dom.ts
+ * collectRemovedRects), so the whole overlay must leave the tree when its
+ * last panel closes — see the mount-site comment in Chat.tsx.
+ *
+ * The per-kind data gates mirror the per-panel render conditions verbatim:
+ * a picker whose async list has not landed (or came back trivially small)
+ * paints nothing, so the wrapper must not mount for it either. `tips`
+ * returns true even though the panel renders in the prompt slot rather than
+ * inside the overlay — preserved verbatim from the boolean-era aggregate
+ * (the empty absolute wrapper is zero-size and paints nothing).
+ */
+export declare function dialogOverlayVisible(overlay: ChatOverlay, gates: {
+    workspaceTargetCount: number;
+    effortOptionCount: number;
+    presetOptionCount: number;
+}): boolean;
+//# sourceMappingURL=chatOverlay.d.ts.map

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

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

package/lib/types/screens/chatOverlay.js

@@ -0,0 +1,116 @@
+export const NO_OVERLAY = { kind: 'none' };
+/**
+ * One-step wrap-around cursor move — the single source of the wrapping rule
+ * every list overlay uses (Chat.tsx's effort slider reads it too, to apply
+ * the newly focused level in the same keystroke that dispatches the move).
+ */
+export function wrapIndex(index, delta, count) {
+    return delta === -1
+        ? (index <= 0 ? count - 1 : index - 1)
+        : (index >= count - 1 ? 0 : index + 1);
+}
+export function chatOverlayReducer(state, action) {
+    switch (action.type) {
+        case 'open':
+            return action.overlay;
+        case 'close':
+            return NO_OVERLAY;
+        case 'close-if':
+            return state.kind === action.kind ? NO_OVERLAY : state;
+        case 'open-if':
+            return action.when.includes(state.kind) ? action.overlay : state;
+        case 'move': {
+            if (action.count <= 0)
+                return state;
+            if (state.kind === 'rewind') {
+                // The confirm pane with plugin modes has its own cursor; the plain
+                // confirm pane has none (Enter/Esc only — a move must not disturb
+                // the list index behind it).
+                if (state.confirm !== null) {
+                    return state.modes !== null
+                        ? { ...state, modeIndex: wrapIndex(state.modeIndex, action.delta, action.count) }
+                        : state;
+                }
+                return { ...state, index: wrapIndex(state.index, action.delta, action.count) };
+            }
+            if (state.kind === 'thinking') {
+                return { ...state, focus: wrapIndex(state.focus, action.delta, action.count) };
+            }
+            if (state.kind === 'workspace-picker'
+                || state.kind === 'workspace-menu'
+                || state.kind === 'workspace-flow'
+                || state.kind === 'model'
+                || state.kind === 'skills'
+                || state.kind === 'activity'
+                || state.kind === 'color'
+                || state.kind === 'effort'
+                || state.kind === 'preset'
+                || state.kind === 'theme'
+                || state.kind === 'permission'
+                || state.kind === 'plan'
+                || state.kind === 'lang'
+                || state.kind === 'file-actions') {
+                return { ...state, index: wrapIndex(state.index, action.delta, action.count) };
+            }
+            if (state.kind === 'history') {
+                return { ...state, focus: wrapIndex(state.focus, action.delta, action.count) };
+            }
+            return state;
+        }
+        case 'set-index':
+            return state.kind === action.kind ? { ...state, index: action.index } : state;
+        case 'history-edit':
+            return state.kind === 'history'
+                ? {
+                    ...state,
+                    ...(action.query === undefined ? {} : { query: action.query }),
+                    ...(action.cursor === undefined ? {} : { cursor: action.cursor }),
+                    ...(action.focus === undefined ? {} : { focus: action.focus }),
+                }
+                : state;
+        case 'flow-busy':
+            return state.kind === 'workspace-flow' ? { ...state, busy: action.busy } : state;
+        case 'flow-input':
+            return state.kind === 'workspace-flow' ? { ...state, input: action.input } : state;
+        case 'flow-input-edit':
+            return state.kind === 'workspace-flow' && state.input !== null
+                ? { ...state, input: { ...state.input, value: action.value, cursor: action.cursor } }
+                : state;
+        case 'rewind-busy':
+            return state.kind === 'rewind' ? { ...state, busy: action.busy } : state;
+        case 'rewind-decision':
+            return state.kind === 'rewind'
+                ? { ...state, busy: false, confirm: action.confirm, modes: action.modes, modeIndex: 0 }
+                : state;
+        case 'rewind-back':
+            return state.kind === 'rewind' ? { ...state, confirm: null, modes: null } : state;
+    }
+}
+/**
+ * Whether the `<OverlayAbove>` wrapper mounts. Mounting is all-or-nothing:
+ * the renderer's removed-absolute-node blit detection only fires when the
+ * removed subtree itself is `position: absolute` (dom.ts
+ * collectRemovedRects), so the whole overlay must leave the tree when its
+ * last panel closes — see the mount-site comment in Chat.tsx.
+ *
+ * The per-kind data gates mirror the per-panel render conditions verbatim:
+ * a picker whose async list has not landed (or came back trivially small)
+ * paints nothing, so the wrapper must not mount for it either. `tips`
+ * returns true even though the panel renders in the prompt slot rather than
+ * inside the overlay — preserved verbatim from the boolean-era aggregate
+ * (the empty absolute wrapper is zero-size and paints nothing).
+ */
+export function dialogOverlayVisible(overlay, gates) {
+    switch (overlay.kind) {
+        case 'none':
+            return false;
+        case 'workspace-picker':
+            return gates.workspaceTargetCount > 0;
+        case 'effort':
+            return gates.effortOptionCount > 1;
+        case 'preset':
+            return gates.presetOptionCount > 0;
+        default:
+            return true;
+    }
+}

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

@@ -1 +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,EAwjB9B,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"}
+{"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,EA8mB9B,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"}