@deepseek-harness-tui/dsh-tui 0.9.0 → 0.9.2

package/lib/types/components/PromptInput.js

@@ -8,10 +8,12 @@ import { EffortChargeGlyph } from './EffortChargeGlyph.js';
 import { EffortInputBorder } from './EffortInputBorder.js';
 import { EffortTierBadge } from './EffortTierBadge.js';
 import { isLightThemeActive } from '../theme.js';
+import { sessionColorHex } from '../cc/sessionColors.js';
 import { useDeclaredCursor } from '../ink/hooks/use-declared-cursor.js';
 import { noteAuxNumber } from '../ink/geometry-trace.js';
 import instances from '../ink/instances.js';
 import { stringWidth } from '../ink/stringWidth.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
 import { getGraphemeSegmenter } from '../utils/intl.js';
 import { formatClipboardInsert, readClipboard } from '../utils/clipboard.js';
 import { editInExternalEditor } from '../utils/externalEditor.js';
@@ -20,11 +22,25 @@ import { appendHistory } from '../history.js';
 import { mentionAtCaret } from '../utils/mentions.js';
 import { preserveSelection } from '../utils/fileSuggestions.js';
 import { isMod } from '../utils/modifiers.js';
+import { actionMatches } from '../utils/keymap.js';
 import { CommandSuggestions } from './CommandSuggestions.js';
 import { FileSuggestions } from './FileSuggestions.js';
 import { HelpMenu } from './HelpMenu.js';
 import { OverlayAbove } from './OverlayAbove.js';
+import { SuggestionCard, cardContentWidth } from './SuggestionCard.js';
 const HISTORY_LIMIT = 50;
+/**
+ * Paste fold (CC-style collapse with a visible preview, no black box):
+ * a paste that leaves the input this big folds into a one-line chip
+ * showing the line/char count PLUS the first line of content. Hover peeks
+ * at the full text (window pinned to the head); clicking the chip — or
+ * the `▾` prefix on the first row while expanded — toggles the fold; Esc
+ * or any editing key unfolds first. Enter still submits the FULL text:
+ * folding never drops data.
+ */
+const FOLD_MIN_LINES = 6;
+const FOLD_MIN_CHARS = 600;
+const isBigInput = (text) => text.split('\n').length >= FOLD_MIN_LINES || text.length >= FOLD_MIN_CHARS;
 function clipboardImageMediaType(path) {
     if (/\.png$/iu.test(path))
         return 'image/png';
@@ -179,6 +195,30 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     const [themeName] = useTheme();
     const [value, setValue] = React.useState('');
     const [cursor, setCursor] = React.useState(0);
+    /**
+     * CC-style fold block: the [start, end) span of `value` that renders as
+     * a one-line chip while the text around it stays fully editable. Created
+     * by a big paste; only an EXPLICIT expand (chip/card click, Esc) or
+     * delete removes it — typing NEVER unfolds the block.
+     */
+    const [foldBlock, setFoldBlock] = React.useState(null);
+    /** Pointer over the input box (drives the hover peek card). */
+    const [hovered, setHovered] = React.useState(false);
+    /** 120ms grace so the pointer crossing the input border row from the
+     *  chip up onto the peek card never flickers the card. */
+    const hoverLeaveTimerRef = React.useRef(null);
+    const hoverEnter = React.useCallback(() => {
+        if (hoverLeaveTimerRef.current) {
+            clearTimeout(hoverLeaveTimerRef.current);
+            hoverLeaveTimerRef.current = null;
+        }
+        setHovered(true);
+    }, []);
+    const hoverLeave = React.useCallback(() => {
+        if (hoverLeaveTimerRef.current)
+            clearTimeout(hoverLeaveTimerRef.current);
+        hoverLeaveTimerRef.current = setTimeout(() => setHovered(false), 120);
+    }, []);
     const valueRef = React.useRef(value);
     const cursorRef = React.useRef(cursor);
     valueRef.current = value;
@@ -211,6 +251,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     React.useEffect(() => {
         if (fillText && fillText !== lastFill.current) {
             lastFill.current = fillText;
+            updateFoldBlock(null);
             setInput(fillText);
             onFillConsumed?.();
         }
@@ -218,9 +259,9 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     // Double-tap Esc to clear (CC semantics).
     const escPendingRef = React.useRef(false);
     const escTimerRef = React.useRef(null);
-    /** True while a Ctrl+V clipboard read is in flight (ignore repeat keys). */
+    /** True while a clipboard paste read is in flight (ignore repeat keys). */
     const clipboardBusyRef = React.useRef(false);
-    /** True while the external editor owns the terminal (Ctrl+G round-trip). */
+    /** True while the external editor owns the terminal (editor-key round-trip). */
     const editorBusyRef = React.useRef(false);
     /** Enter dedupe window: cmd pipelines can deliver one Enter as `\r`+`\n`. */
     const lastEnterAtRef = React.useRef(0);
@@ -228,6 +269,8 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         return () => {
             if (escTimerRef.current)
                 clearTimeout(escTimerRef.current);
+            if (hoverLeaveTimerRef.current)
+                clearTimeout(hoverLeaveTimerRef.current);
         };
     }, []);
     const { columns, rows: terminalRows } = useTerminalSize();
@@ -290,28 +333,77 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         !helpOpen &&
         !selectionActive &&
         fileEscRef.current !== mention?.start;
+    /** Fold-block state + a synchronous mirror (setInput reads the ref).
+     *  Creating a block also drags a caret that sits inside it out to the
+     *  block's end (the block is atomic; typing continues after it). */
+    const foldBlockRef = React.useRef(null);
+    const updateFoldBlock = (block) => {
+        foldBlockRef.current = block;
+        setFoldBlock(block);
+        if (block) {
+            const c = cursorRef.current;
+            if (c > block.start && c < block.end) {
+                cursorRef.current = block.end;
+                setCursor(block.end);
+            }
+        }
+    };
     const setInput = (next, cursorOffset = next.length) => {
-        valueRef.current = next;
+        const prev = valueRef.current;
+        const prevCursor = cursorRef.current;
+        const block = foldBlockRef.current;
         // Normalize onto a grapheme boundary (also clamps into range): every
         // caller passes a caret they believe is on a character edge — paste
         // merges, history fills, and IME composition can still hand back an
         // offset inside a surrogate pair or combining cluster.
-        cursorRef.current = normalizeCursorOffset(next, cursorOffset);
+        let offset = normalizeCursorOffset(next, cursorOffset);
+        if (block) {
+            // Fold block is atomic: the caret never lands INSIDE [start, end).
+            if (offset > block.start && offset < block.end) {
+                offset = offset - block.start < block.end - offset ? block.start : block.end;
+            }
+            // Every real edit happens AT the caret, so a block that starts at or
+            // after the caret shifts with the value delta; one fully past the
+            // caret is untouched. Whole-value replacements (fill/history/editor)
+            // clear the block explicitly at their call sites.
+            const delta = next.length - prev.length;
+            let start = block.start;
+            let end = block.end;
+            if (prevCursor <= block.start) {
+                start += delta;
+                end += delta;
+            }
+            start = Math.max(0, Math.min(start, next.length));
+            end = Math.max(start, Math.min(end, next.length));
+            if (start >= end)
+                updateFoldBlock(null);
+            else if (start !== block.start || end !== block.end)
+                updateFoldBlock({ start, end });
+        }
+        // The synchronous mirrors are what batch-dispatched events (one stdin
+        // read → several keys, no render in between) read on their next turn.
+        valueRef.current = next;
+        cursorRef.current = offset;
         setValue(next);
-        setCursor(cursorRef.current);
+        setCursor(offset);
     };
     /**
      * Accept the selected file suggestion: replace ONLY the mention token at
      * the caret (prefix/suffix text survives), quoting whitespace paths. A
      * directory inserts `@dir/` without a trailing space so completion
-     * continues into it; a file completes the token with a space.
+     * continues into it; a file completes the token with a space. A typed
+     * `#L12-14` suffix is NOT part of the replacement — completion ends at
+     * `pathEnd` so the line range survives acceptance (issue #359).
      */
     const acceptFile = (candidate) => {
         if (!mention)
             return;
         const file = candidate.path;
         const body = /\s/.test(file) ? `@"${file}"` : `@${file}`;
-        const insert = candidate.kind === 'directory' ? body : `${body} `;
+        // A typed `#L12-14` suffix rides along AFTER the completed body (before
+        // the trailing space) — quoting a whitespace path must not detach it.
+        const suffix = mention.pathEnd === undefined ? '' : value.slice(mention.pathEnd, mention.end);
+        const insert = candidate.kind === 'directory' ? `${body}${suffix}` : `${body}${suffix} `;
         const next = value.slice(0, mention.start) + insert + value.slice(mention.end);
         setInput(next, mention.start + insert.length);
         setFileSelected(0);
@@ -388,6 +480,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             return;
         }
         setInput(item.text);
+        updateFoldBlock(null);
         setSelectedCommand(0);
         setFileSelected(0);
         channel.notify(t('input-retracted'), { timeoutMs: 2000 });
@@ -449,13 +542,17 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         return handled;
     };
     /** Clipboard reads are asynchronous; insert against the latest render so
-     * typing while PowerShell owns the clipboard never gets overwritten. */
+     * typing while PowerShell owns the clipboard never gets overwritten.
+     * Returns the resulting value and the insertion offset so callers can
+     * apply the paste fold. */
     const insertClipboardAtCaret = (text) => {
         const current = valueRef.current;
         const position = cursorRef.current;
-        setInput(current.slice(0, position) + text + current.slice(position), position + text.length);
+        const next = current.slice(0, position) + text + current.slice(position);
+        setInput(next, position + text.length);
         setSelectedCommand(0);
         setFileSelected(0);
+        return { next, at: position };
     };
     /** Line index of the cursor; -1 when the cursor is at the very end. */
     const cursorLine = (text, cursorOffset) => {
@@ -481,6 +578,39 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         // the text/caret produced by the preceding event in that batch.
         const value = valueRef.current;
         const cursor = cursorRef.current;
+        // Fold block (CC-style): Esc expands it — it must NEVER clear text
+        // that LOOKS like one line; Backspace at the block's tail / Delete at
+        // its head deletes the WHOLE block in one key; ←/→ jump over the
+        // atomic block. Typing NEVER expands it — the caret lives outside the
+        // block and edits land in the visible text around it.
+        const block = foldBlockRef.current;
+        // Line-level moves/edits (↑/↓/Home/End/Ctrl+A/E/U/K/W) treat the
+        // block as an atomic row: boundaries that would land inside it are
+        // clamped to its edges.
+        const clampRowStart = (pos) => block && cursor >= block.end ? Math.max(pos, block.end) : pos;
+        const clampRowEnd = (pos) => block && cursor <= block.start ? Math.min(pos, block.start) : pos;
+        if (block) {
+            if (key.escape) {
+                updateFoldBlock(null);
+                return;
+            }
+            if ((key.backspace && cursor === block.end) || (key.delete && cursor === block.start)) {
+                const next = value.slice(0, block.start) + value.slice(block.end);
+                updateFoldBlock(null);
+                setInput(next, block.start);
+                setSelectedCommand(0);
+                setFileSelected(0);
+                return;
+            }
+            if (key.leftArrow && cursor === block.end) {
+                setInput(value, block.start);
+                return;
+            }
+            if (key.rightArrow && cursor === block.start) {
+                setInput(value, block.end);
+                return;
+            }
+        }
         // Grapheme boundaries of the current text: every caret move / delete
         // below snaps onto one of these offsets (never mid-cluster).
         const bounds = graphemeBoundaries(value);
@@ -497,13 +627,20 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         // verbatim at the caret. Paste content may contain newlines — that is
         // NOT Enter — so this branch runs before the whole-line submit rule.
         if (event?.isPasted && input.length > 0) {
-            insertAtCaret(input.replace(/\r\n/g, '\n').replace(/\r/g, '\n'));
+            const text = input.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+            insertAtCaret(text);
+            // A big paste becomes a CC-style fold block right away (hover peeks
+            // at it); an existing block is replaced by the new paste's span.
+            if (isBigInput(text))
+                updateFoldBlock({ start: cursor, end: cursor + text.length });
             return;
         }
-        // Ctrl+V / Cmd+V: raw mode hands the key to the app, so the clipboard is
-        // read here — text, file paths when the file manager copied files, or an
-        // exported temp-file path when the clipboard holds a raw image.
-        if (isMod(key) && input === 'v') {
+        // Clipboard paste (default Ctrl+V / Cmd+V, plus the Alt+V alias for
+        // terminals that intercept Ctrl+V — combos are user-remappable via
+        // /settings): raw mode hands the key to the app, so the clipboard is
+        // read here — text, file paths when the file manager copied files, or
+        // an exported temp-file path when the clipboard holds a raw image.
+        if (actionMatches('paste', input, key)) {
             if (clipboardBusyRef.current)
                 return;
             // Match insertAtCaret's overlay/selection dismissal up front: the
@@ -547,7 +684,11 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 // Insert against the LIVE input state: the read above resolved
                 // asynchronously and the user may have typed while waiting.
                 const text = formatClipboardInsert(content);
-                insertClipboardAtCaret(text);
+                const { at } = insertClipboardAtCaret(text);
+                // Same fold as bracketed paste: big clipboard text becomes a
+                // fold block covering exactly the pasted span.
+                if (isBigInput(text))
+                    updateFoldBlock({ start: at, end: at + text.length });
             })
                 .catch(() => {
                 channel.notify(t('input-clipboard-read-failed'), { color: 'warning' });
@@ -559,27 +700,30 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             });
             return;
         }
-        // Help is modal for modified keys and every Enter variant. Ctrl+V above
-        // is the intentional exception: paste closes Help and inserts visibly.
+        // Help is modal for modified keys and every Enter variant. The paste
+        // branch above is the intentional exception: paste closes Help and
+        // inserts visibly.
         // Swallow here before editor/submit/interrupt branches can mutate hidden
         // composer or working-turn state; plain typing still dismisses Help below.
         if (helpOpen && !key.escape && (key.ctrl || key.meta || key.super || key.return || input.includes('\n') || input.includes('\r'))) {
             event.stopImmediatePropagation();
             return;
         }
-        // Ctrl+G: edit the current draft in $VISUAL/$EDITOR (issue #123,
-        // readline's edit-and-execute-command). The draft is written to a temp
-        // file, the terminal is handed to the editor (Ink's alt-screen handoff),
-        // and the saved text replaces the input when it differs. The util maps
-        // every failure to an outcome, but the catch/finally here is the hard
-        // guarantee: a rejected promise must never kill the process, and the
-        // busy flag must always clear or Ctrl+G stays locked forever.
-        if (key.ctrl && input === 'g') {
+        // Ctrl+G (remappable via /settings): edit the current draft in
+        // $VISUAL/$EDITOR (issue #123, readline's edit-and-execute-command). The
+        // draft is written to a temp file, the terminal is handed to the editor
+        // (Ink's alt-screen handoff), and the saved text replaces the input when
+        // it differs. The util maps every failure to an outcome, but the
+        // catch/finally here is the hard guarantee: a rejected promise must
+        // never kill the process, and the busy flag must always clear or the
+        // editor key stays locked forever.
+        if (actionMatches('editor', input, key)) {
             editorBusyRef.current = true;
             void (async () => {
                 try {
                     const outcome = await editInExternalEditor(value);
                     if (outcome.kind === 'edited') {
+                        updateFoldBlock(null);
                         setInput(outcome.text);
                         setSelectedCommand(0);
                         setFileSelected(0);
@@ -724,8 +868,10 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         }
         if (key.tab && overlayOpen) {
             const command = suggestions[selectedCommand];
-            if (command)
+            if (command) {
+                updateFoldBlock(null);
                 setInput(command.replacement);
+            }
             return;
         }
         // Tab while the model is working = queue for AFTER the turn (followup),
@@ -779,6 +925,22 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 setFileSelected(index => index <= 0 ? fileMatches.length - 1 : index - 1);
                 return;
             }
+            // With a fold block the caret in the tail walks the TAIL's lines
+            // (the block is one atomic row); the first tail line steps over the
+            // block to its head.
+            if (block && cursor >= block.end) {
+                const tailCursor = cursor - block.end;
+                const line = cursorLine(tail, tailCursor);
+                if (line > 0) {
+                    const upToLineStart = tail.lastIndexOf('\n', tailCursor - 1);
+                    const prevLineStart = upToLineStart === -1 ? 0 : tail.lastIndexOf('\n', upToLineStart - 1) + 1;
+                    const prevLine = tail.slice(prevLineStart, upToLineStart);
+                    setInput(value, block.end + prevLineStart + Math.min(cursorColumn(tail, tailCursor), prevLine.length));
+                    return;
+                }
+                setInput(value, block.start);
+                return;
+            }
             const line = cursorLine(value, cursor);
             if (line > 0) {
                 // Move to the previous line, clamping to its length.
@@ -802,6 +964,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 historyIndex.current = Math.max(0, historyIndex.current - 1);
             }
             const entry = history.current[historyIndex.current] ?? '';
+            updateFoldBlock(null);
             setInput(entry);
             return;
         }
@@ -810,6 +973,36 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 setFileSelected(index => index >= fileMatches.length - 1 ? 0 : index + 1);
                 return;
             }
+            // Mirror of the tail-side ↑ walk: with a fold block the caret walks
+            // the TAIL's lines; past its last line it falls through to the
+            // overlay/history handling below.
+            if (block && cursor >= block.end) {
+                const tailCursor = cursor - block.end;
+                const line = cursorLine(tail, tailCursor);
+                const lines = tail.split('\n');
+                if (line < lines.length - 1) {
+                    const nextLineStart = tail.indexOf('\n', tailCursor) + 1;
+                    const nextLineEnd = tail.indexOf('\n', nextLineStart);
+                    const nextLine = tail.slice(nextLineStart, nextLineEnd === -1 ? tail.length : nextLineEnd);
+                    setInput(value, block.end + nextLineStart + Math.min(cursorColumn(tail, tailCursor), nextLine.length));
+                    return;
+                }
+            }
+            else if (block && cursor <= block.start) {
+                // Head side: walk the HEAD's lines; its last line steps over the
+                // block to the tail (never into history for a multi-row input).
+                const line = cursorLine(head, cursor);
+                const lines = head.split('\n');
+                if (line < lines.length - 1) {
+                    const nextLineStart = head.indexOf('\n', cursor) + 1;
+                    const nextLineEnd = head.indexOf('\n', nextLineStart);
+                    const nextLine = head.slice(nextLineStart, nextLineEnd === -1 ? head.length : nextLineEnd);
+                    setInput(value, nextLineStart + Math.min(cursorColumn(head, cursor), nextLine.length));
+                    return;
+                }
+                setInput(value, block.end);
+                return;
+            }
             const line = cursorLine(value, cursor);
             const lines = value.split('\n');
             if (line < lines.length - 1) {
@@ -827,6 +1020,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 return;
             if (historyIndex.current >= history.current.length - 1) {
                 historyIndex.current = -1;
+                updateFoldBlock(null);
                 setInput(historyDraft.current);
             }
             else {
@@ -871,43 +1065,44 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             return;
         }
         if (key.home) {
-            // Start of the current line.
-            const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
+            // Start of the current line (the block is one atomic row).
+            const lineStart = clampRowStart(value.lastIndexOf('\n', cursor - 1) + 1);
             setInput(value, lineStart);
             return;
         }
         if (key.end) {
             // End of the current line.
             const nextLine = value.indexOf('\n', cursor);
-            setInput(value, nextLine === -1 ? value.length : nextLine);
+            setInput(value, nextLine === -1 ? value.length : clampRowEnd(nextLine));
             return;
         }
         if (isMod(key) && input === 'a') {
-            const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
+            const lineStart = clampRowStart(value.lastIndexOf('\n', cursor - 1) + 1);
             setInput(value, lineStart);
             return;
         }
         if (isMod(key) && input === 'e') {
             const nextLine = value.indexOf('\n', cursor);
-            setInput(value, nextLine === -1 ? value.length : nextLine);
+            setInput(value, nextLine === -1 ? value.length : clampRowEnd(nextLine));
             return;
         }
         if (isMod(key) && input === 'u') {
-            // Delete to start of line.
-            const lineStart = value.lastIndexOf('\n', cursor - 1) + 1;
+            // Delete to start of line (never into the block).
+            const lineStart = clampRowStart(value.lastIndexOf('\n', cursor - 1) + 1);
             setInput(value.slice(0, lineStart) + value.slice(cursor), lineStart);
             return;
         }
         if (isMod(key) && input === 'k') {
-            // Delete to end of line.
+            // Delete to end of line (never into the block).
             const nextLine = value.indexOf('\n', cursor);
-            const end = nextLine === -1 ? value.length : nextLine;
+            const end = nextLine === -1 ? value.length : clampRowEnd(nextLine);
             setInput(value.slice(0, cursor) + value.slice(end), cursor);
             return;
         }
         if (isMod(key) && input === 'w') {
             // Delete the word before the cursor (CC/readline behavior): skip
-            // trailing whitespace, then the whitespace-delimited word.
+            // trailing whitespace, then the whitespace-delimited word. The
+            // deletion start never crosses into the block.
             const before = value.slice(0, cursor);
             let end = before.length;
             while (end > 0 && /\s/.test(before[end - 1]))
@@ -915,7 +1110,8 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
             let start = end;
             while (start > 0 && !/\s/.test(before[start - 1]))
                 start--;
-            setInput(value.slice(0, start) + value.slice(cursor), start);
+            const clipped = clampRowStart(start);
+            setInput(value.slice(0, clipped) + value.slice(cursor), clipped);
             return;
         }
         if (key.escape) {
@@ -948,8 +1144,17 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                 return;
             }
             // A single Esc clears the current input (if any); the double-tap
-            // path below handles rewind/clear on an already-empty input.
+            // path below handles rewind/clear on an already-empty input. A BIG
+            // input folds into a block instead (Esc = the fold toggle; the
+            // expand → fold → expand cycle is lossless, and clearing a big draft
+            // stays reachable via the block-delete Backspace or Ctrl+C).
             if (value.length > 0) {
+                if (isBigInput(value)) {
+                    updateFoldBlock({ start: 0, end: value.length });
+                    setSelectedCommand(0);
+                    setFileSelected(0);
+                    return;
+                }
                 setInput('', 0);
                 setSelectedCommand(0);
                 setFileSelected(0);
@@ -998,8 +1203,33 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     // single column — a fixed floor of 10 would wrap far too early and park
     // the declared cursor past the value box's actual width.
     const inputWidth = Math.max(1, columns - 3);
-    const visualLines = wrapToWidth(value, inputWidth);
-    const caretVisualLine = wrapToWidth(value.slice(0, cursor), inputWidth).length - 1;
+    const block = foldBlock;
+    // Fold-block model: the value renders as [head rows][chip row][tail rows]
+    // — the block is ONE atomic visual row regardless of its text size; text
+    // before/after it stays fully editable and never unfolds it.
+    const foldText = block ? value.slice(block.start, block.end) : value;
+    const head = block ? value.slice(0, block.start) : '';
+    const tail = block ? value.slice(block.end) : '';
+    const headRows = block ? wrapToWidth(head, inputWidth) : [];
+    const tailRows = block ? wrapToWidth(tail, inputWidth) : [];
+    const chipRow = block ? headRows.length : -1;
+    const visualLines = block
+        ? [...headRows, '', ...tailRows]
+        : wrapToWidth(value, inputWidth);
+    const caretVisualLine = block
+        ? cursor <= block.start
+            ? wrapToWidth(value.slice(0, cursor), inputWidth).length - 1
+            : headRows.length + 1 + wrapToWidth(value.slice(block.end, cursor), inputWidth).length - 1
+        : wrapToWidth(value.slice(0, cursor), inputWidth).length - 1;
+    // Fold stats describe the BLOCK (or the whole input when expanded and
+    // the ▾ prefix offers a manual whole-input fold). The chip shows the
+    // block's own line/char count + first-line preview — the preview text
+    // around it is unaffected.
+    const big = isBigInput(foldText);
+    const stats = big
+        ? t('input-fold-stats', { lines: foldText.split('\n').length, chars: foldText.length })
+        : '';
+    const peekOpen = block !== null && hovered && !selectionActive;
     const windowStart = Math.max(0, Math.min(caretVisualLine - MAX_VISIBLE_LINES + 1, visualLines.length - MAX_VISIBLE_LINES));
     const visibleLines = visualLines.slice(windowStart, windowStart + MAX_VISIBLE_LINES);
     // Caret position in the caret's visual row, in two units:
@@ -1009,35 +1239,75 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
     //   cursor mid-character and Windows Terminal would paint the IME
     //   preedit (pinyin) over the surrounding text).
     const caretCharCol = () => {
-        const before = value.slice(0, cursor);
+        const before = block && cursor >= block.end ? value.slice(block.end, cursor) : value.slice(0, cursor);
         const rows = wrapToWidth(before, inputWidth);
         const last = rows[rows.length - 1] ?? '';
         return last.length;
     };
     const caretVisualCol = () => {
-        const before = value.slice(0, cursor);
+        const before = block && cursor >= block.end ? value.slice(block.end, cursor) : value.slice(0, cursor);
         const rows = wrapToWidth(before, inputWidth);
         const last = rows[rows.length - 1] ?? '';
         return stringWidth(last);
     };
+    // Folded chip content: block stats + first-line preview + hover hint,
+    // all pre-truncated to the input width (the row is one line, always).
+    const foldBadge = `▸ ${stats}`;
+    const foldHint = t('input-fold-hover');
+    const foldPreviewWidth = inputWidth - stringWidth(foldBadge) - stringWidth(` · ${foldHint}`) - 6;
+    const foldPreview = foldPreviewWidth >= 8
+        ? truncateToWidth(foldText.split('\n')[0] ?? '', foldPreviewWidth)
+        : '';
+    // Expanded-state fold affordance: a `▾` prefix at the start of the FIRST
+    // row (only while the window is at the top and no block exists); its
+    // cells fold the whole input into a block again on click.
+    const prefixLabel = `▾ ${stats} · `;
+    const prefixCols = !block && big && windowStart === 0 ? stringWidth(prefixLabel) : 0;
     const rendered = visibleLines.map((line, index) => {
         const absoluteLine = windowStart + index;
+        if (block && absoluteLine === chipRow) {
+            // The fold block's atomic chip row: click expands it; hover pops the
+            // peek card. The row is one line no matter how big the block is.
+            return (_jsxs(Box, { flexDirection: "row", onClick: (event) => {
+                    event.stopImmediatePropagation();
+                    updateFoldBlock(null);
+                }, onMouseEnter: hoverEnter, onMouseLeave: hoverLeave, children: [_jsx(Text, { dimColor: true, children: foldBadge }), foldPreview !== '' && _jsx(Text, { dimColor: true, children: " \u00B7 " }), foldPreview !== '' && _jsx(Text, { wrap: "truncate-end", children: foldPreview }), _jsx(Text, { dimColor: true, children: ` · ${foldHint}` })] }, `fold-${absoluteLine}`));
+        }
+        const withPrefix = absoluteLine === 0 && prefixCols > 0;
+        const text = withPrefix ? truncateToWidth(line, inputWidth - prefixCols) : line;
+        const prefix = withPrefix ? _jsx(Text, { dimColor: true, children: prefixLabel }) : null;
         if (absoluteLine !== caretVisualLine) {
-            return (_jsx(Text, { wrap: "truncate-end", children: line }, absoluteLine));
+            return (_jsxs(Text, { wrap: "truncate-end", children: [prefix, text] }, absoluteLine));
         }
         // Caret row: invert the grapheme cluster at the caret column (solid
         // block). `col` is a cluster boundary by construction (the cursor is
         // normalized onto boundaries and wrapping only breaks between
         // graphemes), so [col, next boundary) covers the WHOLE cluster — a
         // surrogate pair or ZWJ emoji inverts as one glyph, never two broken
-        // halves.
-        const col = caretCharCol();
-        const clusterEnd = nextGraphemeBoundary(graphemeBoundaries(line), col);
-        const before = line.slice(0, col);
-        const at = clusterEnd > col ? line.slice(col, clusterEnd) : ' ';
-        const after = line.slice(clusterEnd);
-        return (_jsxs(Text, { wrap: "truncate-end", children: [before, _jsx(Text, { inverse: true, children: at }), after] }, absoluteLine));
+        // halves. Clamped into the prefix-shortened row text so the block
+        // caret never renders under the fold prefix.
+        const col = Math.min(caretCharCol(), text.length);
+        const clusterEnd = nextGraphemeBoundary(graphemeBoundaries(text), col);
+        const before = text.slice(0, col);
+        const at = clusterEnd > col ? text.slice(col, clusterEnd) : ' ';
+        const after = text.slice(clusterEnd);
+        return (_jsxs(Text, { wrap: "truncate-end", children: [prefix, before, _jsx(Text, { inverse: true, children: at }), after] }, absoluteLine));
     });
+    // Peek card content: the BLOCK's text wrapped to the card's inner width,
+    // capped at PEEK_MAX_ROWS visual rows (a preview — click to expand and
+    // edit the real input). The footer reports the clipped remainder.
+    const PEEK_MAX_ROWS = 10;
+    const peekVisualLines = [];
+    for (const line of foldText.split('\n')) {
+        for (const row of wrapToWidth(line, cardContentWidth(columns))) {
+            if (peekVisualLines.length >= PEEK_MAX_ROWS)
+                break;
+            peekVisualLines.push(row);
+        }
+        if (peekVisualLines.length >= PEEK_MAX_ROWS)
+            break;
+    }
+    const peekClipped = peekVisualLines.length >= PEEK_MAX_ROWS;
     // Composer height shrink: clearing multi-line text (Enter/Esc/Ctrl+C/
     // Backspace) collapses the input area within one commit, shifting the
     // status line up and the whole chrome with it. The renderer's
@@ -1070,7 +1340,7 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
         // Clamp the declared column to the wrap width: a grapheme wider than
         // the last remaining column (emoji at width 1) can push the visual
         // column past inputWidth, and the park must stay inside the value box.
-        column: Math.min(caretVisualCol(), inputWidth),
+        column: Math.min(caretVisualCol() + (caretVisualLine === 0 && prefixCols > 0 ? prefixCols : 0), inputWidth),
         active: !selectionActive,
     });
     /**
@@ -1078,22 +1348,55 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
      * row/column relative to the box) to a UTF-16 cursor offset via the same
      * grapheme walk the renderer wraps with — exact under CJK widths, wrapped
      * rows and multi-codepoint clusters. Clicks land on the boundary nearest
-     * the clicked cell (mid-grapheme snaps to its start).
+     * the clicked cell (mid-grapheme snaps to its start). With a fold block,
+     * clicks map into the head/tail text (the chip row has its own expand
+     * onClick); without one, the fold prefix's cells fold the whole input.
      */
     const handleValueClick = React.useCallback((e) => {
         const clickedVisual = windowStart + e.localRow;
         const clamped = Math.max(0, Math.min(clickedVisual, visualLines.length - 1));
-        setCursor(clickToCursorOffset(value, inputWidth, clamped, e.localCol));
-    }, [windowStart, visualLines.length, value, inputWidth]);
+        if (block) {
+            if (clamped === chipRow)
+                return;
+            if (clamped < chipRow) {
+                setCursor(clickToCursorOffset(head, inputWidth, clamped, e.localCol));
+            }
+            else {
+                setCursor(block.end + clickToCursorOffset(tail, inputWidth, clamped - chipRow - 1, e.localCol));
+            }
+            return;
+        }
+        if (clamped === 0 && prefixCols > 0 && e.localCol < prefixCols) {
+            updateFoldBlock({ start: 0, end: value.length });
+            return;
+        }
+        const col = clamped === 0 && prefixCols > 0 ? Math.max(0, e.localCol - prefixCols) : e.localCol;
+        setCursor(clickToCursorOffset(value, clamped === 0 && prefixCols > 0 ? inputWidth - prefixCols : inputWidth, clamped, col));
+    }, [windowStart, visualLines.length, value, inputWidth, prefixCols, block, chipRow, head, tail]);
     // 浮层整体挂载条件：与内部面板可见条件精确同值。关闭时必须把整个
     // absolute 浮层移除——渲染器的 absolute-removed 检测只看被移除节点自身
     // 的 style.position，常驻浮层 + 移除普通子节点不会触发 blit 解毒，被
     // 覆盖的转录行会留空（见 Chat.tsx dialogOverlayOpen 注释）。
-    const floatersOpen = helpOpen || channel.pending.length > 0 || fileOverlayOpen || overlayOpen;
+    const floatersOpen = helpOpen || channel.pending.length > 0 || fileOverlayOpen || overlayOpen || peekOpen;
     // 补全卡片边框与输入框 idle 边框同色（plan 模式下整套面板一起变 sage 绿）。
-    const promptAccent = channel.mode.plan === true ? 'planMode' : 'promptBorder';
+    // `/color` 会话强调色优先于主题 promptBorder（plan 模式仍整体走 sage 绿）。
+    // `?? ''` 防御最小 mock channel（只声明用到的字段的回归脚本）。
+    const sessionAccent = sessionColorHex(channel.sessionColor ?? '');
+    const promptAccent = channel.mode.plan === true ? 'planMode' : (sessionAccent ?? 'promptBorder');
+    // 顶边框右侧的会话名标签（CC 风格 chip）：色随强调色；超宽截断，宽度
+    // 随终端列数伸缩但不超过 28 显示单元。默认关闭——`/settings` 的
+    // 「会话名标签」开关（dsh-tui.promptSessionLabel）开启后显示。
+    const sessionTitle = channel.sessionTitle ?? '';
+    const topRightLabel = channel.promptSessionLabel === true && sessionTitle !== ''
+        ? {
+            text: truncateToWidth(sessionTitle, Math.max(8, Math.min(28, columns - 8))),
+            color: channel.mode.plan === true ? 'planMode' : (sessionAccent ?? 'claude'),
+            ink: 'inverseText',
+        }
+        : undefined;
     return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [floatersOpen && (_jsxs(OverlayAbove, { maxHeight: Math.max(terminalRows - 6, 1), children: [helpOpen && (_jsx(Box, { marginBottom: 1, children: _jsx(HelpMenu, { commands: channel.commandList, viewportHeight: helpViewportHeight, viewportWidth: columns, scrollRef: helpScrollRef, onCommandPick: (name) => {
                                 // 点击命令行 = 填入 /name 并关闭帮助（Tab 补全的鼠标等价）
+                                updateFoldBlock(null);
                                 setInput(`/${name} `);
                                 onToggleHelp();
                             } }) })), !helpOpen && channel.pending.length > 0 && (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, paddingBottom: 1, children: [channel.pending.some(item => item.placement === 'steer') && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["\u26A1 ", t('input-pending-steer-label')] }), channel.pending
@@ -1120,7 +1423,12 @@ export function PromptInput({ channel, helpOpen, onToggleHelp, onRunCommand, sel
                         // 滚轮 = 移动选中行（与 ↑/↓ 同路径，窗口跟随）
                         onWheelStep: (step) => {
                             setSelectedCommand(i => Math.max(0, Math.min(suggestions.length - 1, i + step)));
-                        } }))] })), lastNotification && (_jsx(Box, { position: "absolute", marginTop: -1, height: 1, width: "100%", paddingLeft: 2, paddingRight: 1, flexDirection: "column", justifyContent: "flex-end", overflow: "hidden", children: _jsx(Box, { justifyContent: "flex-end", children: _jsx(Text, { color: lastNotification.color, dimColor: !lastNotification.color, wrap: "truncate", children: lastNotification.text }) }) })), _jsx(EffortInputBorder, { effort: channel.reasoningEffort, levels: channel.effortLevels, columns: columns, onLight: isLightThemeActive(themeName), idleColor: promptAccent, children: _jsxs(Box, { flexDirection: "row", alignItems: "flex-start", width: "100%", children: [_jsx(EffortChargeGlyph, { effort: channel.reasoningEffort, levels: channel.effortLevels, working: channel.working }), _jsx(Box, { ref: valueBoxRef, flexGrow: 1, flexShrink: 1, onClick: handleValueClick, children: value.length === 0 ? (_jsxs(_Fragment, { children: [_jsx(Text, { inverse: true, children: " " }), _jsx(EffortTierBadge, { effort: channel.reasoningEffort, levels: channel.effortLevels, onLight: isLightThemeActive(themeName), columns: columns, leadingColumns: 3 })] })) : (_jsx(Box, { flexDirection: "column", children: rendered })) })] }) })] }));
+                        } })), peekOpen && (_jsx(Box, { onMouseEnter: hoverEnter, onMouseLeave: hoverLeave, children: _jsx(SuggestionCard, { title: stats, columns: columns, accent: promptAccent, footer: peekClipped
+                                ? t('input-fold-peek-footer', { lines: foldText.split('\n').length })
+                                : undefined, rows: peekVisualLines.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, index))), onRowPick: () => {
+                                updateFoldBlock(null);
+                                setHovered(false);
+                            } }) }))] })), lastNotification && (_jsx(Box, { position: "absolute", marginTop: -1, height: 1, width: "100%", paddingLeft: 2, paddingRight: 1, flexDirection: "column", justifyContent: "flex-end", overflow: "hidden", children: _jsx(Box, { justifyContent: "flex-end", children: _jsx(Text, { color: lastNotification.color, dimColor: !lastNotification.color, wrap: "truncate", children: lastNotification.text }) }) })), _jsx(EffortInputBorder, { effort: channel.reasoningEffort, levels: channel.effortLevels, columns: columns, onLight: isLightThemeActive(themeName), idleColor: promptAccent, topRightLabel: topRightLabel, children: _jsxs(Box, { flexDirection: "row", alignItems: "flex-start", width: "100%", children: [_jsx(EffortChargeGlyph, { effort: channel.reasoningEffort, levels: channel.effortLevels, working: channel.working }), _jsx(Box, { ref: valueBoxRef, flexGrow: 1, flexShrink: 1, onClick: handleValueClick, children: value.length === 0 ? (_jsxs(_Fragment, { children: [_jsx(Text, { inverse: true, children: " " }), _jsx(EffortTierBadge, { effort: channel.reasoningEffort, levels: channel.effortLevels, onLight: isLightThemeActive(themeName), columns: columns, leadingColumns: 3 })] })) : (_jsx(Box, { flexDirection: "column", children: rendered })) })] }) })] }));
 }
 /**
  * Hard-wrap text into visual rows of at most `width` columns (CJK-aware via