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

package/lib/types/components/MessageList.js

@@ -37,7 +37,7 @@ const DEFAULT_ROW_HEIGHT = 2;
 /** Cold-start estimate of the header block above the rows; corrected by the
  *  first layout measurement. */
 const DEFAULT_HEADER_LINES = 14;
-export function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, model, diffLayout = 'auto', showAll, onToggleAll, onLoadOlder, thinkingVisible = true, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, failureHintRowId, failureHint, }) {
+export function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, model, diffLayout = 'auto', thinkingFold = 'preview', showAll, onToggleAll, onLoadOlder, thinkingVisible = true, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, failureHintRowId, failureHint, }) {
     const hiddenCount = rows.length - MAX_RENDERED_ROWS;
     // The thinking filter runs BEFORE virtualization so window indices line up.
     const visibleRows = (showAll || hiddenCount <= 0
@@ -65,7 +65,7 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
         return undefined;
     };
     // --- layout virtualization ---------------------------------------------
-    const { columns } = useTerminalSize();
+    const { columns, rows: termRows } = useTerminalSize();
     // Measured row heights, remembered after a row unmounts so virtualization
     // can compute total content height. Bounded: row ids grow monotonically
     // and rows are never removed from the transcript (foldRows keeps the
@@ -75,6 +75,31 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
     const HEIGHTS_CACHE_MAX = 5000;
     const heightsRef = React.useRef(new Map());
     const localRefs = React.useRef(new Map());
+    /** Row ids that have been mounted (and therefore painted into the
+     *  terminal) at least once. The sticky window may skip a row ONLY after
+     *  this: an unpainted row above the window has no scrollback copy, so
+     *  skipping it would erase it from the user's history entirely — preset
+     *  history at boot (session resume) landed exactly there. Cleared when
+     *  the list head changes identity (rewind / new session / loadOlder
+     *  prepends restored rows that must paint again). */
+    const paintedOnceRef = React.useRef(new Set());
+    const paintedBaseRef = React.useRef(undefined);
+    /** Window-expansion hold: after the window WIDENS (new rows mounted),
+     *  refuse to tighten for a short hold so the mounted rows actually reach
+     *  the terminal. React commits within one ink frame coalesce — a render
+     *  that mounts rows followed by the measure-tick re-render that drops
+     *  them paints only the DROPPED layout, and never-mounted rows have no
+     *  scrollback copy (preset history at boot vanished — CI
+     *  repro-inline-scrollback). After the hold, tightening is visually
+     *  free: those rows sit in scrollback and the diff skips them. */
+    const lastStartRef = React.useRef(-1);
+    const holdUntilRef = React.useRef(0);
+    const listHeadId = visibleRows[0]?.id;
+    if (listHeadId !== undefined && paintedBaseRef.current !== undefined && listHeadId !== paintedBaseRef.current) {
+        paintedOnceRef.current = new Set();
+    }
+    if (listHeadId !== undefined)
+        paintedBaseRef.current = listHeadId;
     /** Content-space offset of visibleRows[0] (header + dividers), measured. */
     const baseRef = React.useRef(null);
     const measureQueuedRef = React.useRef(false);
@@ -128,6 +153,15 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
     // back to the real bottom: a self-sustaining ping-pong that blanks the
     // transcript mid-stream.
     if (sticky && visibleRows.length > 0) {
+        // Sticky (follow-bottom): the viewport shows the TAIL of the content —
+        // mount exactly the tail window the floor walk covers, not everything
+        // from the scrollTop scan. Main-screen ScrollBox reports its viewport
+        // as the CONTENT height (the terminal itself is the scroller), so both
+        // the scan and an unclamped floor walk mount EVERY row in long
+        // sessions — and React's commit traverses every fiber of every mounted
+        // row per frame (measured as the dominant long-session stall). The
+        // user only ever sees terminal rows: clamp the walk-back coverage to
+        // the TERMINAL viewport plus overscan.
         start = Math.min(start, visibleRows.length - 1);
         // Blank-band guard: sticky scrollTop tracks the renderer's FRESH Yoga
         // scrollHeight, while these offsets use per-row heights measured one to
@@ -135,15 +169,44 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
         // deeper through the underestimated offsets than the real viewport does,
         // unmounting rows that are still on screen (visible spacer band). Walk
         // backwards from the tail with the known heights and mount at least one
-        // viewport plus overscan of content above it, so the window can never
-        // open a gap inside what the user is looking at.
-        let covered = viewport + OVERSCAN_LINES;
+        // terminal viewport plus overscan of content above it, so the window
+        // can never open a gap inside what the user is looking at.
+        let covered = Math.min(viewport, termRows) + OVERSCAN_LINES;
         let floor = visibleRows.length - 1;
         while (floor > 0 && covered > 0) {
             covered -= heightOf(visibleRows[floor]);
             floor--;
         }
-        start = Math.min(start, floor + 1);
+        // The walk exhausted the whole list: every row is within coverage —
+        // floor+1 here would drop row 0 (its content then has no terminal copy
+        // anywhere; preset history lost its head — CI repro-inline-scrollback).
+        start = floor === 0 && covered > 0 ? 0 : floor + 1;
+        // Paint-at-least-once: extend the window over any row that has never
+        // been mounted. A row the window skips keeps only its terminal/scrollback
+        // copy — a row that was never painted has NO copy anywhere, so preset
+        // history (session resume, repro-inline-scrollback's #39 family) would
+        // vanish from the user's scrollback. Extending mounts everything above
+        // on the first frame (topPad 0, full paint), then the set fills and the
+        // window tightens to the tail.
+        const paintedOnce = paintedOnceRef.current;
+        for (let i = 0; i < start; i++) {
+            if (!paintedOnce.has(visibleRows[i].id)) {
+                start = i;
+                break;
+            }
+        }
+        // Expansion hold — AFTER the extension so it tracks the FINAL window:
+        // never tighten within the hold window after a widen. React commits
+        // inside one ink frame coalesce; a mount followed by the measure-tick
+        // re-render that drops the row paints only the DROPPED layout, and the
+        // row's painted-once mark (set at the first commit) is a lie.
+        if (lastStartRef.current >= 0 && start > lastStartRef.current && performance.now() < holdUntilRef.current) {
+            start = lastStartRef.current;
+        }
+        if (lastStartRef.current < 0 || start < lastStartRef.current) {
+            holdUntilRef.current = performance.now() + 120;
+        }
+        lastStartRef.current = start;
     }
     if (forceMountRowId !== undefined && forceMountRowId !== null) {
         const idx = visibleRows.findIndex(row => row.id === forceMountRowId);
@@ -152,6 +215,15 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
             end = Math.max(end, idx + 1);
         }
     }
+    // The newest failed tool call carries the trajectory footnote
+    // (failureHint). Virtualization must not unmount it: before the window
+    // clamp the row was always mounted, now keep mounting it explicitly while
+    // the hint is live (verify-trace-scene's footnote check).
+    if (failureHintRowId !== undefined && failureHintRowId !== null) {
+        const idx = visibleRows.findIndex(row => row.id === failureHintRowId);
+        if (idx !== -1)
+            start = Math.min(start, idx);
+    }
     const topPad = offsets[start] ?? 0;
     const mountedBottom = end < visibleRows.length ? offsets[end] : total;
     const bottomPad = total - mountedBottom;
@@ -185,6 +257,12 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
     // mounted coverage so burst scrolls never show blank spacer.
     React.useLayoutEffect(() => {
         let changed = false;
+        // Mounted ⇒ painted: record rows eligible for window skipping.
+        const paintedOnce = paintedOnceRef.current;
+        for (const id of localRefs.current.keys()) {
+            if (!paintedOnce.has(id))
+                paintedOnce.add(id);
+        }
         for (const [id, el] of localRefs.current) {
             const h = el.yogaNode?.getComputedHeight();
             if (h !== undefined && h > 0 && heightsRef.current.get(id) !== h) {
@@ -256,10 +334,10 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
                 // spacing; only the very first row of the whole list has none.
                 const addMargin = margins.get(row.id) === true;
                 const tool = row.tool;
-                return (_jsx(MemoRow, { rowId: row.id, kind: row.kind, text: row.text, executionTarget: row.executionTarget, streaming: row.streaming === true, durationMs: row.durationMs, time: row.time, addMargin: addMargin, isSelected: selectedId === row.id, isExpanded: expandedRows.has(row.id), expanded: expanded, model: model, diffLayout: diffLayout, background: rowBackground(row.id), toolCallId: tool?.callId, toolName: tool?.name, toolArgsText: tool?.argsText, toolArgsFull: tool?.argsFull, toolStatus: tool?.status, toolResultText: tool?.resultText, toolResultFull: tool?.resultFull, toolErrorText: tool?.errorText, toolFootnote: failureHintRowId === row.id ? failureHint : undefined, toolCallView: tool?.callView, toolResultView: tool?.resultView, toolStartedAt: tool?.startedAt, toolDurationMs: tool?.durationMs, nowSec: tool?.status === 'running' ? nowSec : undefined, onToggleRow: onToggleRow, setRowRef: setRowRef }, row.id));
+                return (_jsx(MemoRow, { rowId: row.id, kind: row.kind, text: row.text, executionTarget: row.executionTarget, streaming: row.streaming === true, durationMs: row.durationMs, time: row.time, addMargin: addMargin, isSelected: selectedId === row.id, isExpanded: expandedRows.has(row.id), expanded: expanded, model: model, diffLayout: diffLayout, thinkingFold: thinkingFold, background: rowBackground(row.id), toolCallId: tool?.callId, toolName: tool?.name, toolArgsText: tool?.argsText, toolArgsFull: tool?.argsFull, toolStatus: tool?.status, toolResultText: tool?.resultText, toolResultFull: tool?.resultFull, toolErrorText: tool?.errorText, toolFootnote: failureHintRowId === row.id ? failureHint : undefined, toolCallView: tool?.callView, toolResultView: tool?.resultView, toolStartedAt: tool?.startedAt, toolDurationMs: tool?.durationMs, nowSec: tool?.status === 'running' ? nowSec : undefined, onToggleRow: onToggleRow, setRowRef: setRowRef }, row.id));
             }), bottomPad > 0 && _jsx(Box, { height: bottomPad, flexShrink: 0 })] }));
 }
-function TranscriptRow({ rowId, kind, text, executionTarget, streaming, durationMs, time, addMargin, isSelected, isExpanded, expanded, model, diffLayout, background, toolCallId, toolName, toolArgsText, toolArgsFull, toolStatus, toolResultText, toolResultFull, toolErrorText, toolFootnote, toolCallView, toolResultView, toolStartedAt, toolDurationMs, onToggleRow, setRowRef, }) {
+function TranscriptRow({ rowId, kind, text, executionTarget, streaming, durationMs, time, addMargin, isSelected, isExpanded, expanded, model, diffLayout, thinkingFold, background, toolCallId, toolName, toolArgsText, toolArgsFull, toolStatus, toolResultText, toolResultFull, toolErrorText, toolFootnote, toolCallView, toolResultView, toolStartedAt, toolDurationMs, onToggleRow, setRowRef, }) {
     const ref = React.useCallback((el) => {
         setRowRef(rowId, el);
     }, [setRowRef, rowId]);
@@ -272,7 +350,10 @@ function TranscriptRow({ rowId, kind, text, executionTarget, streaming, duration
         case 'assistant':
             return streaming ? (_jsxs(Box, { alignItems: "flex-start", flexDirection: "row", marginTop: addMargin ? 1 : 0, width: "100%", backgroundColor: background, children: [_jsx(Box, { minWidth: 2, children: _jsx(Text, { color: "text", children: "\u25CF" }) }), _jsx(Box, { flexDirection: "column", children: _jsx(StreamingMarkdown, { children: stripNarration(text) }) })] })) : (_jsxs(Box, { width: "100%", flexDirection: "column", backgroundColor: background, ref: ref, children: [expanded && (_jsx(Box, { flexDirection: "row", justifyContent: "flex-end", gap: 1, marginTop: 1, children: _jsx(MessageMetadata, { timestamp: time, model: model }) })), _jsx(AssistantTextMessage, { text: stripNarration(text), addMargin: addMargin, isSelected: isSelected, isExpanded: isExpanded, onClick: onClick })] }));
         case 'reasoning':
-            return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(AssistantThinkingMessage, { thinking: text, addMargin: addMargin, 
+            return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(AssistantThinkingMessage, { thinking: text, addMargin: addMargin, preview: streaming &&
+                        thinkingFold === 'preview' &&
+                        !expanded &&
+                        !isExpanded, 
                     // Streaming reasoning shows expanded live, then folds
                     // automatically once the turn settles (unless Ctrl+O or a
                     // single-row expansion keeps it open).

package/lib/types/components/PromptInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PromptInput.d.ts","sourceRoot":"","sources":["../../../src/components/PromptInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAkDxD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,OAAO,CAAA;IAClB,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,IAAI,IAAI,CAAA;IACpB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,IAAI,IAAI,CAAA;IACvB,8EAA8E;IAC9E,eAAe,CAAC,IAAI,IAAI,CAAA;IACxB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,GACd,EAAE,gBAAgB,qBAg5BlB"}
+{"version":3,"file":"PromptInput.d.ts","sourceRoot":"","sources":["../../../src/components/PromptInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAkDxD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,OAAO,CAAA;IAClB,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,IAAI,IAAI,CAAA;IACpB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACrD,6EAA6E;IAC7E,eAAe,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,IAAI,IAAI,CAAA;IACvB,8EAA8E;IAC9E,eAAe,CAAC,IAAI,IAAI,CAAA;IACxB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,cAAc,EACd,eAAe,EACf,aAAa,GACd,EAAE,gBAAgB,qBA65BlB"}

package/lib/types/components/PromptInput.js

@@ -116,6 +116,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     const [selectedCommand, setSelectedCommand] = React.useState(0);
     const history = React.useRef([]);
     const historyIndex = React.useRef(-1);
+    const historyDraft = React.useRef('');
     // ctrl+r history fill: replace the input when a new fill arrives, then
     // tell the caller to clear it.
     const lastFill = React.useRef(null);
@@ -528,11 +529,17 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             if (!tryRunCommand(value))
                 submitText(value);
         };
+        // Ctrl+J is the only portable multiline fallback when a terminal cannot
+        // report modifiers on Enter. The parser names its bare LF `enter`, while
+        // the physical Enter key arrives as CR (`return`).
+        if (input === '\n' && event?.keypress.name === 'enter') {
+            insertAtCaret('\n');
+            return;
+        }
         // Whole-line input from Windows ConPTY pipelines (cmd batch -> node):
-        // the trailing CR/LF marks a complete line to submit. A bare Enter
-        // arrives as `\r`/`\n`/`\r\n` — treat it as Enter, NOT a direct
-        // submit. Only real multi-char piped lines keep the legacy
-        // direct-submit path.
+        // the trailing CR/LF marks a complete line to submit. A bare CR/CRLF is
+        // Enter, while real multi-char piped lines keep the legacy direct-submit
+        // path.
         if (input.includes('\n') || input.includes('\r')) {
             if (/^[\r\n]+$/.test(input)) {
                 handleEnter();
@@ -622,9 +629,13 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             }
             if (history.current.length === 0)
                 return;
-            historyIndex.current = historyIndex.current < 0
-                ? history.current.length - 1
-                : Math.max(0, historyIndex.current - 1);
+            if (historyIndex.current < 0) {
+                historyDraft.current = value;
+                historyIndex.current = history.current.length - 1;
+            }
+            else {
+                historyIndex.current = Math.max(0, historyIndex.current - 1);
+            }
             const entry = history.current[historyIndex.current] ?? '';
             setInput(entry);
             return;
@@ -649,11 +660,14 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             }
             if (historyIndex.current < 0)
                 return;
-            historyIndex.current += 1;
-            const entry = historyIndex.current >= history.current.length
-                ? ''
-                : (history.current[historyIndex.current] ?? '');
-            setInput(entry);
+            if (historyIndex.current >= history.current.length - 1) {
+                historyIndex.current = -1;
+                setInput(historyDraft.current);
+            }
+            else {
+                historyIndex.current += 1;
+                setInput(history.current[historyIndex.current] ?? '');
+            }
             return;
         }
         if (isMod(key) && key.leftArrow) {

package/lib/types/components/StreamingMarkdown.d.ts

@@ -1,12 +1,6 @@
 import React from 'react';
-/**
- * Renders markdown during streaming by splitting at the last top-level block
- * boundary: everything before is stable (memoized, never re-parsed), only the
- * final block is re-parsed per delta, mirroring Claude Code's
- * `StreamingMarkdown.tsx`). marked.lexer() correctly handles unclosed code
- * fences as a single token, so block boundaries are always safe.
- */
-export declare function StreamingMarkdown({ children, }: {
+export declare function StreamingMarkdown({ children, dimColor, }: {
     children: string;
+    dimColor?: boolean;
 }): React.ReactNode;
 //# sourceMappingURL=StreamingMarkdown.d.ts.map

package/lib/types/components/StreamingMarkdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StreamingMarkdown.d.ts","sourceRoot":"","sources":["../../../src/components/StreamingMarkdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,KAAK,CAAC,SAAS,CAoClB"}
+{"version":3,"file":"StreamingMarkdown.d.ts","sourceRoot":"","sources":["../../../src/components/StreamingMarkdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAmDzB,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,QAAgB,GACjB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,KAAK,CAAC,SAAS,CA0ClB"}

package/lib/types/components/StreamingMarkdown.js

@@ -3,6 +3,7 @@ import React from 'react';
 import { marked } from 'marked';
 import Box from '../ink/components/Box.js';
 import { stripPromptXMLTags } from '../cc/markdown.js';
+import { t } from '../i18n.js';
 import { Markdown } from './Markdown.js';
 /**
  * Renders markdown during streaming by splitting at the last top-level block
@@ -11,15 +12,56 @@ import { Markdown } from './Markdown.js';
  * `StreamingMarkdown.tsx`). marked.lexer() correctly handles unclosed code
  * fences as a single token, so block boundaries are always safe.
  */
-export function StreamingMarkdown({ children, }) {
-    const stablePrefixRef = React.useRef('');
+/**
+ * Tail budget for the unstable suffix during streaming. The sticky view only
+ * ever shows the last viewport of rows, but the suffix Text is re-wrapped
+ * every frame — an unbounded suffix (a single huge paragraph with no block
+ * boundary to advance the prefix) made that O(total) per frame. The suffix
+ * is clipped to this many characters (preferring a paragraph boundary),
+ * with a leading marker naming the dropped amount; settling renders the
+ * full text once through the non-streaming path.
+ *
+ * The cut point is STICKY (advances only when the suffix outgrows budget +
+ * step): a cut that slid every frame would break append-only growth, and
+ * the layout layer's incremental wrap would fall back to a full re-wrap of
+ * the whole tail on every token.
+ */
+const SUFFIX_TAIL_BUDGET = 3584;
+const SUFFIX_BOUNDARY_LOOKBACK = 2048;
+const SUFFIX_CUT_STEP = 1024;
+function clipSuffixTail(suffix, cut) {
+    const total = suffix.length;
+    if (total <= SUFFIX_TAIL_BUDGET) {
+        cut.current = 0;
+        return suffix;
+    }
+    // Advance the sticky cut only once the suffix outgrew the budget by a
+    // full step, preferring a paragraph boundary inside the lookback window.
+    if (total - cut.current > SUFFIX_TAIL_BUDGET + SUFFIX_CUT_STEP) {
+        const windowStart = total - SUFFIX_TAIL_BUDGET;
+        const boundary = suffix.lastIndexOf('\n\n', windowStart + SUFFIX_BOUNDARY_LOOKBACK);
+        cut.current = boundary !== -1 && boundary >= windowStart - SUFFIX_BOUNDARY_LOOKBACK
+            ? boundary + 2
+            : windowStart;
+    }
+    const dropped = cut.current;
+    return `${t('streaming-folded', { count: dropped })}\n\n${suffix.slice(cut.current)}`;
+}
+export function StreamingMarkdown({ children, dimColor = false, }) {
+    // The stable prefix is kept as ONE string identity across renders: a
+    // fresh substring per render would break Markdown's React.memo and
+    // re-layout the entire finished transcript tail on every token. The
+    // identity only changes when a new block boundary advances the prefix.
+    const prefixRef = React.useRef('');
+    const cutRef = React.useRef(0);
     const stripped = stripPromptXMLTags(children);
     // Reset if text was replaced (defensive; normally unmount handles this)
-    if (!stripped.startsWith(stablePrefixRef.current)) {
-        stablePrefixRef.current = '';
+    if (!stripped.startsWith(prefixRef.current)) {
+        prefixRef.current = '';
+        cutRef.current = 0;
     }
     // Lex only from current boundary — O(unstable length), not O(full text)
-    const boundary = stablePrefixRef.current.length;
+    const boundary = prefixRef.current.length;
     const tokens = marked.lexer(stripped.substring(boundary));
     // Last non-space token is the growing block; everything before is final
     let lastContentIdx = tokens.length - 1;
@@ -31,9 +73,9 @@ export function StreamingMarkdown({ children, }) {
         advance += tokens[i].raw.length;
     }
     if (advance > 0) {
-        stablePrefixRef.current = stripped.substring(0, boundary + advance);
+        prefixRef.current = stripped.substring(0, boundary + advance);
     }
-    const stablePrefix = stablePrefixRef.current;
-    const unstableSuffix = stripped.substring(stablePrefix.length);
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [stablePrefix && _jsx(Markdown, { children: stablePrefix }), unstableSuffix && _jsx(Markdown, { cacheTokens: false, children: unstableSuffix })] }));
+    const stablePrefix = prefixRef.current;
+    const unstableSuffix = clipSuffixTail(stripped.substring(stablePrefix.length), cutRef);
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [stablePrefix && _jsx(Markdown, { dimColor: dimColor, children: stablePrefix }), unstableSuffix && _jsx(Markdown, { dimColor: dimColor, cacheTokens: false, children: unstableSuffix })] }));
 }

package/lib/types/components/activityFrames.d.ts

@@ -13,7 +13,7 @@ export interface FramePreset {
 /** Named working-activity frame presets, keyed by preset name (`claude`, `moon`, `sand`, ...). */
 export declare const FRAME_PRESETS: Record<string, FramePreset>;
 /** The pi extension's default preset. */
-export declare const DEFAULT_PRESET = "moon";
+export declare const DEFAULT_PRESET = "moon8";
 /** Every selectable preset name, `random` first (the pi selector order). */
 export declare const PRESET_NAMES: readonly string[];
 /**

package/lib/types/components/activityFrames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activityFrames.d.ts","sourceRoot":"","sources":["../../../src/components/activityFrames.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,kGAAkG;AAClG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA6CrD,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,cAAc,SAAS,CAAA;AAEpC,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA8C,CAAA;AAExF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CASnE"}
+{"version":3,"file":"activityFrames.d.ts","sourceRoot":"","sources":["../../../src/components/activityFrames.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,kGAAkG;AAClG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAgDrD,CAAA;AAED,yCAAyC;AACzC,eAAO,MAAM,cAAc,UAAU,CAAA;AAErC,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA8C,CAAA;AAExF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CASnE"}

package/lib/types/components/activityFrames.js

@@ -32,6 +32,9 @@ export const FRAME_PRESETS = {
     },
     hamburger: { frames: ['☱', '☲', '☴'], intervalMs: 220 },
     moon: { frames: ['◐', '◓', '◑', '◒'], intervalMs: 240 },
+    // kimi-code MoonLoader 同款：8 帧 emoji 月相，120ms 一帧，比半圆版更丝滑。
+    // 不带 \uFE0E：保留彩色 emoji 渲染（Windows Terminal 等现代终端效果最佳）。
+    moon8: { frames: ['🌑', '🌒', '🌓', '🌔', '🌕', '🌖', '🌗', '🌘'], intervalMs: 120 },
     comet: {
         frames: ['●    ', ' ●   ', '  ●  ', '   ● ', '    ●', '   ● ', '  ●  ', ' ●   '],
         intervalMs: 160,
@@ -55,7 +58,7 @@ export const FRAME_PRESETS = {
     toggle: { frames: ['⊶', '⊷'], intervalMs: 300 },
 };
 /** The pi extension's default preset. */
-export const DEFAULT_PRESET = 'moon';
+export const DEFAULT_PRESET = 'moon8';
 /** Every selectable preset name, `random` first (the pi selector order). */
 export const PRESET_NAMES = ['random', ...Object.keys(FRAME_PRESETS)];
 /**

package/lib/types/components/messages/AssistantThinkingMessage.d.ts

@@ -5,6 +5,10 @@ type Props = {
     addMargin: boolean;
     /** True when Ctrl+O transcript/verbose mode is on — show the full text. */
     verbose: boolean;
+    /** Streaming compact mode (thinkingFold=preview): a 3-row live ticker of
+     *  the model's latest reasoning lines instead of the full block —
+     *  kimicode-style constant height; the block never resizes mid-stream. */
+    preview?: boolean;
     /** Thinking wall-clock duration once the reasoning block settled (ms). */
     durationMs?: number;
     /** Message-selection mode highlight. */
@@ -18,6 +22,6 @@ type Props = {
  * reasoning duration, the label carries it (`∴ Thinking · 12s …`) — dsh-tui's
  * take on making thinking time visible in the transcript.
  */
-export declare function AssistantThinkingMessage({ thinking, addMargin, verbose, durationMs, isSelected, onClick, }: Props): React.ReactNode;
+export declare function AssistantThinkingMessage({ thinking, addMargin, verbose, preview, durationMs, isSelected, onClick, }: Props): React.ReactNode;
 export {};
 //# sourceMappingURL=AssistantThinkingMessage.d.ts.map

package/lib/types/components/messages/AssistantThinkingMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantThinkingMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantThinkingMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,IAAI,IAAI,CAAA;CACjB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,UAAkB,EAClB,OAAO,GACR,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAuCzB"}
+{"version":3,"file":"AssistantThinkingMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantThinkingMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAA;IAChB;;8EAE0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,IAAI,IAAI,CAAA;CACjB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAe,EACf,UAAU,EACV,UAAkB,EAClB,OAAO,GACR,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAqFzB"}

package/lib/types/components/messages/AssistantThinkingMessage.js

@@ -1,8 +1,15 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from '../../ui.js';
 import { t } from '../../i18n.js';
-import { Markdown } from '../Markdown.js';
+import { StreamingMarkdown } from '../StreamingMarkdown.js';
 import { formatDuration } from '../../cc/format.js';
+/** Preview body rows — a FIXED row count (kimicode-style constant-height
+ *  ticker). Ink's truncate slices the whole string across newlines as one
+ *  logical line, so a single joined Text collapses to 1-2 rows whenever
+ *  the combined width passes the terminal width, then bounces back as
+ *  lines shift. One Text per row, each truncated to the width and padded
+ *  to exactly this many rows, keeps the block height stream-independent. */
+const PREVIEW_ROWS = 3;
 /**
  * Thinking block: folded `∴ Thinking (ctrl+o to expand)`, expanded shows the
  * full reasoning text indented under `∴ Thinking…`, mirroring Claude Code's
@@ -10,14 +17,30 @@ import { formatDuration } from '../../cc/format.js';
  * reasoning duration, the label carries it (`∴ Thinking · 12s …`) — dsh-tui's
  * take on making thinking time visible in the transcript.
  */
-export function AssistantThinkingMessage({ thinking, addMargin, verbose, durationMs, isSelected = false, onClick, }) {
+export function AssistantThinkingMessage({ thinking, addMargin, verbose, preview = false, durationMs, isSelected = false, onClick, }) {
     if (!thinking)
         return null;
     const duration = durationMs !== undefined && durationMs >= 1000
         ? ` · ${formatDuration(durationMs)}`
         : '';
+    if (preview) {
+        // Live ticker: the model's last few reasoning lines, dimmed, one Text
+        // per row so each truncates to the width independently, padded to a
+        // constant PREVIEW_ROWS-tall block that follows the stream. The folded
+        // summary takes over when the step settles. The LAST row truncates
+        // from the start (leading ellipsis) so the newest tokens — which grow
+        // at the line's end — stay visible while the line is longer than the
+        // width.
+        const lines = thinking.split('\n');
+        const visible = lines.slice(-PREVIEW_ROWS);
+        const clipped = lines.length > visible.length;
+        // Pad with single spaces — an empty-string Text renders with zero
+        // height in ink, so '' padding would not hold the row open.
+        const rows = Array.from({ length: PREVIEW_ROWS }, (_, i) => visible[i] ?? ' ');
+        return (_jsxs(Box, { flexDirection: "column", marginTop: addMargin ? 1 : 0, backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, children: [_jsxs(Text, { dimColor: true, italic: true, children: ["\u2234 ", t('thinking-label'), duration, "\u2026"] }), _jsx(Box, { flexDirection: "column", paddingLeft: 2, children: rows.map((line, i) => (_jsx(Text, { dimColor: true, italic: true, wrap: i === rows.length - 1 ? 'truncate-start' : 'truncate', children: i === 0 && clipped ? `…${line}` : line }, i))) })] }));
+    }
     if (!verbose) {
         return (_jsx(Box, { marginTop: addMargin ? 1 : 0, backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, children: _jsxs(Text, { dimColor: true, italic: true, children: ["\u2234 ", t('thinking-label'), duration, " ", t('hint-expand-ctrl-o')] }) }));
     }
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, marginTop: addMargin ? 1 : 0, width: "100%", backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, children: [_jsxs(Text, { dimColor: true, italic: true, children: ["\u2234 ", t('thinking-label'), duration, "\u2026"] }), _jsx(Box, { paddingLeft: 2, children: _jsx(Markdown, { dimColor: true, children: thinking }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, marginTop: addMargin ? 1 : 0, width: "100%", backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, children: [_jsxs(Text, { dimColor: true, italic: true, children: ["\u2234 ", t('thinking-label'), duration, "\u2026"] }), _jsx(Box, { paddingLeft: 2, children: _jsx(StreamingMarkdown, { dimColor: true, children: thinking }) })] }));
 }

package/lib/types/components/messages/AssistantToolUseMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAKvG,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;CAC1C,CAAA;AAyMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,SAAS,EACT,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,QAAQ,EACR,UAAmB,GACpB,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAqIzB"}
+{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAKvG,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;CAC1C,CAAA;AAqND;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,SAAS,EACT,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,QAAQ,EACR,UAAmB,GACpB,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAqIzB"}

package/lib/types/components/messages/AssistantToolUseMessage.js

@@ -145,9 +145,20 @@ function capLines(lines, max, verbose) {
  *  (`Edit /path`, `Read /path (1 - 100)`) with the first word bold. The
  *  result view's title replaces the call view's only when present — a
  *  settled terminal card carries output but no title of its own. */
+/** Header args display budget: the parenthesized summary is a pointer, not
+ * the payload — full args live in the verbose/expanded body. A streaming
+ * tool call's args can grow to hundreds of KB, and wrapping that in the
+ * header Text every frame was the dominant long-output stall (string-width
+ * via wrap-ansi, 60%+ of CPU in profiles). */
+const HEADER_ARGS_BUDGET = 480;
+function clipHeaderArgs(args) {
+    if (args.length <= HEADER_ARGS_BUDGET)
+        return args;
+    return `${args.slice(0, HEADER_ARGS_BUDGET)}…`;
+}
 function HeaderTitle({ name, title, isTerminal, displayArgs }) {
     if (title === undefined) {
-        return (_jsxs(_Fragment, { children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: true, wrap: "truncate-end", children: name }) }), displayArgs !== '' && (_jsx(Box, { flexWrap: "nowrap", children: _jsxs(Text, { children: ["(", displayArgs, ")"] }) }))] }));
+        return (_jsxs(_Fragment, { children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: true, wrap: "truncate-end", children: name }) }), displayArgs !== '' && (_jsx(Box, { flexWrap: "nowrap", children: _jsxs(Text, { children: ["(", clipHeaderArgs(displayArgs), ")"] }) }))] }));
     }
     if (isTerminal) {
         return (_jsxs(_Fragment, { children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { bold: true, wrap: "truncate-end", children: name }) }), _jsx(Box, { flexWrap: "nowrap", children: _jsxs(Text, { children: ["(", title, ")"] }) })] }));

package/lib/types/dsh-adapter/channel.d.ts

@@ -10,9 +10,9 @@ import { type SessionModeSpec } from '../sessionModes.js';
 import type { SpinnerMode } from '../components/Spinner/spinnerMode.js';
 import { type ActivityState } from 'dsh-working-activity/status';
 import { type TuiWorkspaceCommand, type TuiWorkspaceCommandResult, type TuiWorkspaceTarget } from './workspaces.js';
-import type { TuiSettingsSection } from './settings-sections.js';
+import { type TuiSettingsSection } from './settings-sections.js';
 import type { SettingsHost } from './settingsEditor.js';
-import type { TuiSceneDescriptor } from './scenes.js';
+import { type TuiSceneDescriptor } from './scenes.js';
 import type { TuiRewindMode } from './extension-events.js';
 type ChannelImageBlock = Extract<ContentBlock, {
     type: 'image';
@@ -193,6 +193,23 @@ export interface ChannelGoal {
         message: string;
     };
 }
+/** The observable outcome of adopting a persisted session. */
+export type ResumeResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: 'working';
+} | {
+    readonly ok: false;
+    readonly reason: 'unavailable';
+} | {
+    readonly ok: false;
+    readonly reason: 'cancelled';
+} | {
+    readonly ok: false;
+    readonly reason: 'failed';
+    readonly error: string;
+};
 /** Secret-free credential metadata for configuration and status surfaces. */
 export interface CredentialStatus {
     configured: boolean;
@@ -320,6 +337,9 @@ export interface Channel {
     readonly activityFrames: string | undefined;
     /** Edit/Write diff presentation preference (`auto`/`split`/`unified`). */
     readonly diffLayout: 'auto' | 'split' | 'unified';
+    /** Thinking-block display (`preview` = 2-3 line live stream + fold per
+     *  step; `full` = expanded until turn end). */
+    readonly thinkingFold: 'preview' | 'full';
     /** Whether the in-process working-activity line is shown (config.activity). */
     readonly activityEnabled: boolean;
     /** Whether the segmented context bar row shows in the status footer
@@ -434,7 +454,7 @@ export interface Channel {
         modes: readonly TuiRewindMode[];
     } | 'cancel' | null>;
     /** Switch the live agent to a persisted session, replaying its history. */
-    resumeTo(sessionId: string): Promise<boolean>;
+    resumeTo(sessionId: string): Promise<ResumeResult>;
     /** Start a fresh conversation (`/new`): a brand-new agent + session, the
      *  transcript cleared, the resume marker forgotten. */
     newSession(): Promise<boolean>;
@@ -662,8 +682,12 @@ export interface ChannelState {
     activityFrames: string | undefined;
     /** Diff presentation preference (see the public Channel type). */
     diffLayout: 'auto' | 'split' | 'unified';
+    /** Thinking-block display (see the public Channel type). */
+    thinkingFold: 'preview' | 'full';
     /** Apply a diff-layout change (see the public Channel type). */
     setDiffLayout(layout: 'auto' | 'split' | 'unified'): void;
+    /** Apply a thinking-display change (see the public Channel type). */
+    setThinkingFold(mode: 'preview' | 'full'): void;
     /** Working-activity display switch (see the public Channel type). */
     activityEnabled: boolean;
     /** Context bar row switch (see the public Channel type). */
@@ -725,7 +749,7 @@ export interface ChannelState {
         modes: readonly TuiRewindMode[];
     } | 'cancel' | null>;
     /** Switch the live agent to a persisted session, replaying its history. */
-    resumeTo(sessionId: string): Promise<boolean>;
+    resumeTo(sessionId: string): Promise<ResumeResult>;
     /** Start a fresh conversation (`/new`). */
     newSession(): Promise<boolean>;
     listWorkspaces(): Promise<readonly TuiWorkspaceTarget[]>;
@@ -837,6 +861,9 @@ export declare function createChannel(ctx: Context, initialAgent: Agent, options
     /** Edit/Write diff presentation; default `auto` (side-by-side ≥110
      *  columns, unified below). */
     diffLayout?: 'auto' | 'split' | 'unified';
+    /** Thinking-block display; default `preview` (2-3 line live preview,
+     *  fold per step) — `full` keeps thinking expanded until turn end. */
+    thinkingFold?: 'preview' | 'full';
     /** Show the segmented context bar row in the status footer; default on
      *  (cordis.yml `contextBar: false` hides it, issue #29). */
     contextBar?: boolean;