@deepseek-harness-tui/dsh-tui 0.14.1 → 0.16.0

package/lib/types/components/PromptInput.js

@@ -3,18 +3,17 @@ import React from 'react';
 // 粘贴/清洗语义已抽到 utils/inputPaste.ts（方案 B：PromptInput 与 Launchpad 共享；
 // 行为逐字节不变，只是搬了家）。
 import { sanitizeEditableText, sanitizePastedText } from '../utils/inputPaste.js';
-import { constants as fsConstants } from 'node:fs';
-import { open, unlink } from 'node:fs/promises';
+import { unlink } from 'node:fs/promises';
 import { basename, resolve } from 'node:path';
 import { t } from '../i18n.js';
-import { kernelDisplayName } from './kernelCatalog.js';
 import { Box, Text, useInput, useTerminalSize, useTheme } from '../ui.js';
+import { COMPOSER_IMAGE_TOKEN, imageTokenSpans, imageTokenAround, snapOffImageToken, expandImageTokenRange } from './composerImageTokens.js';
 import { EffortChargeGlyph } from './EffortChargeGlyph.js';
 import { EffortInputBorder } from './EffortInputBorder.js';
 import { EffortTierBadge } from './EffortTierBadge.js';
 import { cursorGlyphColor, getTheme } from '../theme.js';
 import { sessionColorHex } from '../terminal-utils/sessionColors.js';
-import { useDeclaredCursor } from '../ink/hooks/use-declared-cursor.js';
+import { useDeclaredCursor, useNativeCursor } from '../ink/hooks/use-declared-cursor.js';
 import { TerminalWriteContext } from '../ink/useTerminalNotification.js';
 import { setClipboard } from '../ink/termio/osc.js';
 import { noteAuxNumber } from '../ink/geometry-trace.js';
@@ -24,10 +23,10 @@ import { truncateToWidth } from '../ink/truncateToWidth.js';
 import { getGraphemeSegmenter } from '../utils/intl.js';
 import { draftWordRangeAt, isDraftWordBoundary } from '../utils/draftWordBoundary.js';
 import { formatClipboardInsert, readClipboard } from '../utils/clipboard.js';
-import { imagePathMediaType, parsePastedImagePath, stageClipboardFilePaths } from '../utils/pastedImagePath.js';
+import { imagePathMediaType, parsePastedImagePath, readBoundedRegularFile, stageClipboardFilePaths } from '../utils/pastedImagePath.js';
 import { editInExternalEditor } from '../utils/externalEditor.js';
 import { setPromptEditorNode, EditorButton } from './PromptEditor.js';
-import { isHiddenCommandName, isUnavailableLocalCommand, parseCommandName, workingHoldOf } from '../commands.js';
+import { isBootSafeCommand, isHiddenCommandName, isUnavailableLocalCommand, parseCommandName, workingHoldOf } from '../commands.js';
 import { appendHistory, HISTORY_LIMIT, historyProjectKey, loadHistoryOldestFirst } from '../history.js';
 import { mentionAtCaret } from '../utils/mentions.js';
 import { preserveSelection } from '../utils/fileSuggestions.js';
@@ -132,45 +131,9 @@ function extendDeleteRun(last, backward, removed) {
 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;
-const COMPOSER_IMAGE_TOKEN = /\[Image #\d+\]/gu;
 /** Format label for one image media type, matching the image preview card's
  *  title (`JPEG`, `PNG`, `WEBP`, `GIF`). */
 const mediaTypeLabel = (mediaType) => mediaType.replace(/^image\//u, '').replace(/\+xml$/u, '').toUpperCase();
-/** Every `[Image #N]` in `text`, in order. */
-function imageTokenSpans(text) {
-    const spans = [];
-    for (const match of text.matchAll(COMPOSER_IMAGE_TOKEN)) {
-        const start = match.index ?? 0;
-        spans.push({ start, end: start + match[0].length, token: match[0] });
-    }
-    return spans;
-}
-/** The span whose interior (exclusive of both edges) contains `offset`. */
-function imageTokenAround(spans, offset) {
-    return spans.find(span => span.start < offset && offset < span.end);
-}
-/**
- * A caret never rests inside a staged token: an offset in a span's interior
- * moves to the edge `prefer` names — `'start'` (the token becomes the caret
- * cluster), `'end'`, or whichever is nearer.
- */
-function snapOffImageToken(spans, offset, prefer) {
-    const span = imageTokenAround(spans, offset);
-    if (span === undefined)
-        return offset;
-    if (prefer === 'start')
-        return span.start;
-    if (prefer === 'end')
-        return span.end;
-    return offset - span.start < span.end - offset ? span.start : span.end;
-}
-/** Expand a deletion or selection to include every staged token it touches. */
-function expandImageTokenRange(spans, start, end) {
-    return {
-        start: snapOffImageToken(spans, start, 'start'),
-        end: snapOffImageToken(spans, end, 'end'),
-    };
-}
 /** Capabilities referenced by `text`, in first occurrence order. A raw token
  * restored from disk/history has no sidecar entry and therefore stays inert. */
 export function composerImageRefsForText(text, stagedByToken) {
@@ -187,36 +150,6 @@ export function composerImageRefsForText(text, stagedByToken) {
     }
     return refs;
 }
-/** Read one regular file through one descriptor, bounded to `maxBytes + 1`.
- * The extra byte detects a file that grows after fstat; a short read detects
- * shrinkage. This avoids stat(path) → readFile(path)'s path-swap TOCTOU and
- * never allocates from an untrusted size before the profile limit is checked. */
-async function readBoundedRegularFile(path, maxBytes) {
-    // O_NONBLOCK keeps a pasted FIFO/device path from parking the UI before
-    // fstat can reject it; regular-file reads are unchanged.
-    const file = await open(path, fsConstants.O_RDONLY | fsConstants.O_NONBLOCK);
-    try {
-        const info = await file.stat();
-        if (!info.isFile())
-            throw new Error(`${basename(path)} is not a regular file`);
-        if (info.size > maxBytes)
-            throw new Error(`image exceeds this profile's per-image size limit`);
-        const data = Buffer.allocUnsafe(info.size + 1);
-        let offset = 0;
-        while (offset < data.byteLength) {
-            const { bytesRead } = await file.read(data, offset, data.byteLength - offset, offset);
-            if (bytesRead === 0)
-                break;
-            offset += bytesRead;
-        }
-        if (offset !== info.size)
-            throw new Error(`${basename(path)} changed while it was being read`);
-        return data.subarray(0, offset);
-    }
-    finally {
-        await file.close();
-    }
-}
 /** Index of the word boundary at or before `cursor` (readline alt+b). */
 function wordBoundaryLeft(text, cursor) {
     let index = cursor;
@@ -394,11 +327,11 @@ const DOUBLE_CLICK_MS = 500;
 /**
  * dsh-TUI prompt input: rounded border box (top+bottom borders
  * only), `❯ ` prompt char (dimmed while a turn is working), the text with a
- * block cursor at the cursor position, and above it the slash-command /
+ * native cursor at the editing position, and above it the slash-command /
  * file-completion suggestion card (SuggestionCard: rounded panel with the
  * selected row behind a `❯` pointer in the theme's `suggestion` color).
  *
- * Empty input: a solid block caret on a blank cell and nothing else — no
+ * Empty input: a caret on a reserved blank cell and nothing else — no
  * placeholder text, so the terminal-painted IME preedit (pinyin) at the
  * parked cursor can never be overlaid on anything.
  *
@@ -421,21 +354,13 @@ const DOUBLE_CLICK_MS = 500;
  * working) interrupts the turn and delivers them right away; Ctrl+Enter
  * aborts the turn and sends the current input immediately.
  */
-export function PromptInput({ channel, toastSuppressed, suspended = false, draftCache, helpOpen, onToggleHelp, onRunCommand, selectionActive, fillText, onFillConsumed, onRewindRequest, onBackgroundRequest, onOpenSessions, backgroundAgentsNeedingInput, controllerRef, onCaretImage, caretPreviewOpen = false, onDismissCaretPreview, now = Date.now, }) {
+export function PromptInput({ channel, toastSuppressed, suspended = false, cursorParking = true, draftCache, helpOpen, onToggleHelp, onRunCommand, selectionActive, fillText, onFillConsumed, onRewindRequest, onBackgroundRequest, onOpenSessions, backendLabel, backgroundAgentsNeedingInput, controllerRef, onCaretImage, caretPreviewOpen = false, onDismissCaretPreview, now = Date.now, }) {
     const [themeName] = useTheme();
+    const nativeCursor = useNativeCursor();
     /**
-     * Caret fill. The face is self-drawn (the native cursor is hidden), and it
-     * used to be `inverse` only — i.e. always the ink color, which a theme whose
-     * input surface is already ink-adjacent cannot make readable. `cursor` names
-     * the block fill, and the glyph on it is whichever ink contrasts with that
-     * fill (cursorGlyphColor) — `inverseText` alone cannot serve a light caret;
-     * empty keeps the inverse-video caret for palettes that predate the key.
-     *
-     * A palette a legacy runtime resolver returns can be missing the key
-     * altogether (normalizeThemePalette hands such a palette back untouched), so
-     * the undefined case normalizes here — ONE place, both consumers below read
-     * `''` and take the inverse path. Without it the caret renders with no
-     * background at all (the native cursor is hidden: the caret disappears).
+     * Painted caret fill for static snapshots and atomic image-token focus.
+     * Ordinary TTY editing uses the terminal's own cursor. A legacy palette
+     * may omit `cursor`; normalize that case to the inverse-video fallback.
      */
     const cursorTheme = getTheme(themeName);
     const cursorColor = cursorTheme.cursor ?? '';
@@ -1029,6 +954,7 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
     // index space: `suggestions` stays the only list selection, Enter dispatch and
     // clicks read, and the default selection stays the first normal-region row.
     // The region is marked by colour only — it costs no display row.
+    const completionInput = value;
     const completions = value.startsWith('/') ? channel.commandCompletions(value) : [];
     const holdOf = (commandLine) => workingHoldOf(commandLine, channel.commandList.find(command => command.name === commandLine.replace(/^\//, '').split(/[\t ]/u)[0])?.skill === true) !== undefined;
     const normalCompletions = channel.working
@@ -1651,6 +1577,10 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
         clearDeliveredDraft();
         channel.notify(t('input-interrupt-immediate'), { timeoutMs: 2500 });
     };
+    /** The startup phase's refusal (see `ChannelUi.ready`). */
+    const notifyNotReady = () => {
+        channel.notify(t('startup-not-ready', { backend: backendLabel ?? channel.backendCapabilities.backendId }), { color: 'warning', timeoutMs: 2500 });
+    };
     /**
      * Execute a slash command (built-in, plugin-registered, or hidden) when
      * the input resolves to one: the name parses as the first token so
@@ -1665,6 +1595,12 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
         const parsed = parseCommandName(text);
         if (parsed === undefined)
             return false;
+        // Not ready (`ChannelUi.ready`): only boot-safe commands run; the rest
+        // are refused before dispatch so the draft stays. The one chokepoint.
+        if (channel.ready === false && !isBootSafeCommand(parsed.name)) {
+            notifyNotReady();
+            return true;
+        }
         const command = channel.commandList.find(entry => entry.name === parsed.name);
         // A built-in the bound backend does not serve is hidden from the menu and
         // Tab, and a typed one must neither run nor reach the model as text. A
@@ -1672,7 +1608,7 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
         // oxlint-disable-next-line typescript/no-unnecessary-condition -- partial embedder channels omit the snapshot
         const capabilities = channel.backendCapabilities;
         if (command === undefined && isUnavailableLocalCommand(parsed.name, capabilities)) {
-            channel.notify(t('cmd-unavailable-backend', { cmd: parsed.name, backend: capabilities === undefined ? '' : kernelDisplayName(capabilities.backendId) }), {
+            channel.notify(t('cmd-unavailable-backend', { cmd: parsed.name, backend: capabilities === undefined ? '' : backendLabel ?? capabilities.backendId }), {
                 color: 'warning',
                 timeoutMs: 4000,
             });
@@ -1774,7 +1710,10 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
             editDocked(dockSelectedRef.current);
             return;
         }
-        if (overlayOpen) {
+        // A preceding edit in this stdin batch has already updated valueRef, but
+        // the completion rows still belong to the last render. Submit the current
+        // draft through the ordinary path instead of accepting a stale row.
+        if (overlayOpen && value === completionInput) {
             const command = suggestions[selectedCommand];
             if (command) {
                 tryRunCommand(command.commandLine);
@@ -1790,6 +1729,13 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
                 return;
             }
         }
+        // Not ready: refuse before any path that clears the draft.
+        if (channel.ready === false && value.trim() !== '') {
+            if (tryRunCommand(value))
+                return;
+            notifyNotReady();
+            return;
+        }
         // A docked queue (Esc parked it) owns a bare Enter on an EMPTY draft
         // (Claude Code parity: "…or Enter to send them now"). A draft in
         // progress keeps the ordinary submit path and the dock stays parked —
@@ -2380,6 +2326,9 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
                 return;
             }
             const line = (value + input).trim();
+            // Not ready: the line becomes the draft first, so a refused command keeps it.
+            if (channel.ready === false)
+                setInput(line);
             if (line.startsWith('/')) {
                 const matches = channel.commandCompletions(line);
                 if (matches.length === 1) {
@@ -2387,8 +2336,13 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
                     return;
                 }
             }
-            if (!tryRunCommand(line))
-                submitText(line);
+            if (tryRunCommand(line))
+                return;
+            if (channel.ready === false) {
+                notifyNotReady();
+                return;
+            }
+            submitText(line);
             return;
         }
         if (key.return && isMod(key)) {
@@ -2477,7 +2431,7 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
         }
         if (key.tab && overlayOpen) {
             const command = suggestions[selectedCommand];
-            if (command) {
+            if (command && value === completionInput) {
                 updateFoldBlock(null);
                 setInput(command.replacement, command.replacement.length, 'step');
             }
@@ -3327,18 +3281,10 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
         : visualLineRanges(value, inputWidth);
     /**
      * Highlight runs for one rendered row, shared by the inline prompt and the
-     * expanded editor: the selection's intersection (if any) and the caret
-     * cluster on the caret's row. Without a palette `cursor` both are inverse
-     * runs and overlapping intervals merge, so a caret inside the selection
-     * stays one continuous highlight. The caret row inverts the WHOLE cluster at
-     * the caret column (solid block) — [col, next boundary) covers a surrogate
-     * pair or ZWJ emoji as one glyph; at the text end it shows a blank inverse
-     * cell like the empty-input caret (appended after everything, so a selection
-     * ending there cannot swallow it).
-     *
-     * A palette that sets `cursor` splits the caret off the selection: the
-     * caret is then its own kind (painted with `caretCell`) instead of merging
-     * into the selection's inverse run.
+     * expanded editor: selection and image-token focus stay painted. A native
+     * caret leaves ordinary glyphs unchanged; snapshots paint the whole caret
+     * grapheme using the theme fill or inverse video. The trailing blank is
+     * retained in both modes so the terminal has a cell for an end-of-line caret.
      */
     const rowHighlightPieces = (text, absoluteLine) => {
         const [rowStart] = lineRanges[absoluteLine] ?? [0, 0];
@@ -3370,8 +3316,10 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
             const clusterEnd = tokenAtCaret !== undefined
                 ? Math.min(tokenAtCaret.end - rowStart, text.length)
                 : nextGraphemeBoundary(graphemeBoundaries(text), col);
-            if (clusterEnd > col)
-                fill(col, clusterEnd, caretKind);
+            if (clusterEnd > col) {
+                if (!nativeCursor || tokenAtCaret !== undefined)
+                    fill(col, clusterEnd, caretKind);
+            }
             else
                 endBlankCaret = col === text.length;
         }
@@ -3391,7 +3339,7 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
             pos = end;
         }
         if (endBlankCaret) {
-            pieces.push({ text: ' ', inverse: caretKind === INVERSE, chip: false, caret: caretKind === CARET });
+            pieces.push({ text: ' ', inverse: !nativeCursor && caretKind === INVERSE, chip: false, caret: !nativeCursor && caretKind === CARET });
         }
         return pieces;
     };
@@ -3501,16 +3449,12 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
         // (padding + gutter included), so those columns ride along and the
         // clamp grows with them.
         //
-        // The declared column is relative to the VALUE BOX, and `caretVisualCol`
-        // is already measured in that box's cell space: the text box IS the text
-        // run, so nothing that renders before it — the session entry, the `❯ `
-        // glyph, the fold prefix — shifts a cell inside it. Adding any of those
-        // back double-counts them and parks the hardware cursor to the RIGHT of
-        // the inverted caret cell (a 2-column miss shows up as a displaced IME
-        // preedit target). Only the expanded editor declares against a wider box
-        // (gutter + padding), so only that branch adds columns.
-        column: Math.min(caretVisualCol + (expanded ? editorGutterCols + 1 : 0), expanded ? editorGutterCols + 1 + inputWidth : inputWidth),
-        active: !suspended && !selectionActive,
+        // Session entry and `❯ ` sit outside the value box. The inline fold
+        // prefix is inside its first row; the expanded editor instead includes
+        // a gutter and padding. Add only the columns inside the declared node.
+        column: Math.min(caretVisualCol + (expanded ? editorGutterCols + 1 : caretVisualLine === 0 ? prefixCols : 0), expanded ? editorGutterCols + 1 + inputWidth : inputWidth),
+        active: cursorParking && !suspended && !selectionActive && caretVisualLine >= windowStart && caretVisualLine < windowStart + visibleLines.length,
+        visible: nativeCursor,
     });
     /**
      * Map a pointer position relative to the value box to a UTF-16 offset
@@ -3794,8 +3738,8 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
     // ── 全屏草稿编辑节点 ────────────────────────────────────────────────
     // 每次渲染构造新鲜闭包（value/caret/handlers），经 module store 发布给
     // Chat 根部末尾的 PromptEditorLayer（树序最后 → 盖住全部后绘兄弟）。
-    // useInsertionEffect 发布：sink 的同步重渲染发生在 layout 阶段之前，
-    // useDeclaredCursor（layout effect）读到的新 ref 已指向编辑区 Box。
+    // useInsertionEffect 发布：sink 经 store 独立提交，useDeclaredCursor
+    // 在 layout effect 与 ref 挂载时声明，编辑区稍后挂载也能接管光标。
     // 点击/拖拽坐标以内容区为原点（localCol 去掉行号槽宽度）。
     const editorNode = editorVisible ? (_jsxs(Box, { flexDirection: "column", width: "100%", height: "100%", borderStyle: "round", borderColor: promptAccent, backgroundColor: "toolCardBackground", children: [_jsxs(Box, { flexDirection: "row", flexShrink: 0, paddingLeft: 1, paddingRight: 1, children: [_jsx(Text, { bold: true, color: promptAccent, children: `✎ ${t('input-expand-editor-title')}` }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { dimColor: true, children: t('input-fold-stats', {
                             lines: value.split('\n').length,
@@ -3869,7 +3813,7 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
                         onPick: (index) => {
                             const command = suggestions[index];
                             if (command)
-                                tryRunCommand(command.commandLine);
+                                tryRunCommand(valueRef.current === completionInput ? command.commandLine : valueRef.current);
                         }, 
                         // 滚轮 = 移动选中行（与 ↑/↓ 同路径，窗口跟随）
                         onWheelStep: (step) => {
@@ -3886,7 +3830,7 @@ export function PromptInput({ channel, toastSuppressed, suspended = false, draft
                                 setHomeHovered(true);
                             }, onMouseLeave: () => {
                                 setHomeHovered(false);
-                            }, children: _jsx(Text, { dimColor: !homeHovered, bold: homeHovered, color: homeHovered ? promptAccent : undefined, children: HOME_BUTTON_TEXT }) })), _jsx(EffortChargeGlyph, { effort: channel.reasoningEffort, levels: channel.effortLevels, working: channel.working }), vimEnabled && (_jsxs(Text, { bold: true, color: vimInsert ? 'success' : 'warning', children: [vimInsert ? 'INSERT' : 'NORMAL', " "] })), _jsx(Box, { ref: expanded ? undefined : valueBoxRef, flexGrow: 1, flexShrink: 1, onClick: handleValueClick, onDragStart: handleDragStart, onDragMove: handleDragMove, onDragEnd: handleDragEnd, children: value.length === 0 ? (_jsxs(_Fragment, { children: [caretCell('empty', ' '), _jsx(EffortTierBadge, { effort: channel.reasoningEffort, levels: channel.effortLevels, columns: columns, leadingColumns: 3 + homeButtonCols })] })) : (_jsx(Box, { flexDirection: "column", children: rendered })) }), expandEnabled && (_jsx(Box, { flexShrink: 0, onClick: (event) => {
+                            }, children: _jsx(Text, { dimColor: !homeHovered, bold: homeHovered, color: homeHovered ? promptAccent : undefined, children: HOME_BUTTON_TEXT }) })), _jsx(EffortChargeGlyph, { effort: channel.reasoningEffort, levels: channel.effortLevels, working: channel.working }), vimEnabled && (_jsxs(Text, { bold: true, color: vimInsert ? 'success' : 'warning', children: [vimInsert ? 'INSERT' : 'NORMAL', " "] })), _jsx(Box, { ref: expanded ? undefined : valueBoxRef, flexGrow: 1, flexShrink: 1, onClick: handleValueClick, onDragStart: handleDragStart, onDragMove: handleDragMove, onDragEnd: handleDragEnd, children: value.length === 0 ? (_jsxs(_Fragment, { children: [nativeCursor ? _jsx(Text, { children: ' ' }) : caretCell('empty', ' '), _jsx(EffortTierBadge, { effort: channel.reasoningEffort, levels: channel.effortLevels, columns: columns, leadingColumns: 3 + homeButtonCols })] })) : (_jsx(Box, { flexDirection: "column", children: rendered })) }), expandEnabled && (_jsx(Box, { flexShrink: 0, onClick: (event) => {
                                 event.stopImmediatePropagation();
                                 toggleExpand();
                             }, onMouseEnter: () => {

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

@@ -1,6 +1,6 @@
 import React from 'react';
 /**
- * The SDK install wizard (the kernel picker's dim Claude row, Enter): one
+ * The SDK install wizard (the kernel picker's installable row, Enter): one
  * pane, one step machine. The phase lives in Chat — it is async process
  * state, which stays out of the overlay union by design (chatOverlay.ts
  * note 3); this component renders it and never touches useInput, exactly
@@ -14,12 +14,14 @@ export type SdkInstallPhase = {
     readonly dir: string;
     readonly version: string;
     readonly specifier: string;
+    readonly foundCli?: string;
 } | {
     readonly kind: 'checking';
 } | {
     readonly kind: 'running';
 } | {
     readonly kind: 'done';
+    readonly rebuiltStore?: boolean;
 } | {
     readonly kind: 'failed';
     readonly exitCode: number;

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

@@ -1 +1 @@
-{"version":3,"file":"SdkInstallWizard.d.ts","sourceRoot":"","sources":["../../../src/components/SdkInstallWizard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpK;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7G;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAA;CAAE,CAAA;AAUhF,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CA2DvF"}
+{"version":3,"file":"SdkInstallWizard.d.ts","sourceRoot":"","sources":["../../../src/components/SdkInstallWizard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpI;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpK;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7G;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAA;CAAE,CAAA;AAiBhF,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAkEvF"}

package/lib/types/components/SdkInstallWizard.js

@@ -10,8 +10,15 @@ const TAIL_LINES = 6;
 function manualLine(dir, specifier) {
     return `cd ${dir} && pnpm add ${specifier}`;
 }
+/** Detection's first line is install guidance; only its optional note belongs
+ *  in the confirmation pane. */
+function noteAfterGuidance(hint) {
+    const note = hint?.split('\n').slice(1).join('\n').trim();
+    return note === undefined || note === '' ? undefined : note;
+}
 export function SdkInstallWizard({ phase }) {
-    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('sdk-install-title') }) }), phase.kind === 'confirm' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-confirm-what', { version: phase.version }) }), _jsx(Text, { children: t('sdk-install-confirm-where', { dir: phase.dir }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: t('sdk-install-confirm-note') }) })] })), (phase.kind === 'checking' || phase.kind === 'running') && (_jsx(Box, { flexDirection: "column", children: _jsx(LoadingState, { message: phase.kind === 'checking' ? t('sdk-install-checking') : t('sdk-install-running'), subtitle: phase.kind === 'running' ? t('sdk-install-running-sub') : undefined }) })), phase.kind === 'done' && _jsx(Text, { children: t('sdk-install-done') }), phase.kind === 'failed' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-failed', { code: String(phase.exitCode) }) }), _jsx(Text, { dimColor: true, children: t('sdk-install-manual', { command: manualLine(phase.dir, phase.specifier) }) }), phase.tail.slice(-TAIL_LINES).map((line, index) => (_jsx(Text, { dimColor: true, wrap: "truncate-end", children: line }, index)))] })), phase.kind === 'pnpm-missing' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-pnpm-missing') }), _jsx(Text, { dimColor: true, children: t('sdk-install-manual', { command: manualLine(phase.dir, phase.specifier) }) })] })), phase.kind === 'cancelled' && _jsx(Text, { children: t('sdk-install-cancelled') }), phase.kind === 'no-target' && (_jsx(Text, { children: t(phase.reason === 'standalone' ? 'sdk-install-no-target-standalone' : 'sdk-install-no-target-no-profile') }))] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: phase.kind === 'confirm' ? t('sdk-install-confirm-hint')
+    const cliNote = phase.kind === 'confirm' ? noteAfterGuidance(phase.foundCli) : undefined;
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('sdk-install-title') }) }), phase.kind === 'confirm' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-confirm-what', { specifier: phase.specifier, version: phase.version }) }), _jsx(Text, { children: t('sdk-install-confirm-where', { dir: phase.dir }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: t('sdk-install-confirm-note') }), cliNote !== undefined && _jsx(Text, { dimColor: true, children: cliNote })] })] })), (phase.kind === 'checking' || phase.kind === 'running') && (_jsx(Box, { flexDirection: "column", children: _jsx(LoadingState, { message: phase.kind === 'checking' ? t('sdk-install-checking') : t('sdk-install-running'), subtitle: phase.kind === 'running' ? t('sdk-install-running-sub') : undefined }) })), phase.kind === 'done' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-done') }), phase.rebuiltStore === true && _jsx(Text, { dimColor: true, children: t('sdk-install-rebuilt') })] })), phase.kind === 'failed' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-failed', { code: String(phase.exitCode) }) }), _jsx(Text, { dimColor: true, children: t('sdk-install-manual', { command: manualLine(phase.dir, phase.specifier) }) }), phase.tail.slice(-TAIL_LINES).map((line, index) => (_jsx(Text, { dimColor: true, wrap: "truncate-end", children: line }, index)))] })), phase.kind === 'pnpm-missing' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: t('sdk-install-pnpm-missing') }), _jsx(Text, { dimColor: true, children: t('sdk-install-manual', { command: manualLine(phase.dir, phase.specifier) }) })] })), phase.kind === 'cancelled' && _jsx(Text, { children: t('sdk-install-cancelled') }), phase.kind === 'no-target' && (_jsx(Text, { children: t(phase.reason === 'standalone' ? 'sdk-install-no-target-standalone' : 'sdk-install-no-target-no-profile') }))] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: phase.kind === 'confirm' ? t('sdk-install-confirm-hint')
                         : phase.kind === 'done' ? t('sdk-install-done-hint')
                             : phase.kind === 'failed' ? t('sdk-install-failed-hint')
                                 : t('sdk-install-exit-hint') }) })] }));

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

@@ -1,17 +1,16 @@
 import React from 'react';
+import { type ImageTokenSpan } from './composerImageTokens.js';
 /**
- * A single-line search input in a round-bordered box: `⌕ ` prefix, block
- * cursor at `cursorOffset` (theme cursor fill, or inverse cell when unset).
- * When empty and focused, the caret is a block **on the first
- * character of the placeholder** (opencode style, 2026-10 第七版) — it never
- * occupies a cell of its own, so text never shifts; the terminal-painted IME
- * preedit (pinyin) still lands at the declared native cursor next to it.
+ * A single-line search input in a round-bordered box: `⌕ ` prefix and a native
+ * cursor at `cursorOffset`. Static snapshots retain the theme-painted caret.
+ * When empty with a left-aligned placeholder, the caret sits on its first
+ * character; text stays in place and IME preedit uses the same native anchor.
  *
  * The query row is strictly single-line: an overlong query is windowed
  * around the caret (horizontal scroll) instead of wrapping, so the native
  * cursor declaration below stays exact for any query length.
  */
-export declare function SearchBox({ query, placeholder, isFocused, isTerminalFocused, prefix, width, cursorOffset, borderless, caretBlink, placeholderAlign, }: {
+export declare function SearchBox({ query, placeholder, isFocused, isTerminalFocused, prefix, width, cursorOffset, borderless, caretBlink, declareCursor, placeholderAlign, imageSpans, }: {
     query: string;
     placeholder?: string;
     isFocused: boolean;
@@ -20,21 +19,20 @@ export declare function SearchBox({ query, placeholder, isFocused, isTerminalFoc
     width?: number | string;
     cursorOffset?: number;
     borderless?: boolean;
+    /** Capability-backed image chips, sharing the chat composer's atomic geometry. */
+    imageSpans?: readonly ImageTokenSpan[];
     /**
      * 空输入 + 焦点态那一行里占位文案的对齐（2026-10 落地页第四版新增）：
-     * `right`（缺省，历史行为）贴框右缘；`left` 紧跟 `前缀 + 块状光标` 之后。
+     * `right`（缺省，历史行为）贴框右缘；`left` 紧跟前缀。
      * 共享组件——聊天页/选择器不传此 prop，渲染与从前逐字节一致。
      */
     placeholderAlign?: 'left' | 'right';
     /**
-     * 光标闪烁相位（true = 光标样式、false = 常规）。落地页传入（约 550ms 一相位）；
-     * 缺省 true 恒显示光标——其它使用方（选择器搜索等）保持不闪。
-     *
-     * 契约（第七版修订）：光标是**压在当前字符身上的块**（主题 cursor 填充，
-     * 未声明时用 inverse；行尾时为空格），绝不另起一格、绝不吃掉字符；闪烁是
-     * **纯样式切换**（光标 ↔ 常规），
-     * 不增删任何字符——无头回归读的是视口纯文本，断言不会随相位抖动。
+     * 无原生光标的呈现环境使用的闪烁相位（仅切换样式，不增删字符）。
+     * TTY 光标的闪烁与动画由终端配置控制。
      */
     caretBlink?: boolean;
+    /** Keep the live field styled while another region owns the native caret. */
+    declareCursor?: boolean;
 }): React.ReactNode;
 //# sourceMappingURL=SearchBox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SearchBox.d.ts","sourceRoot":"","sources":["../../../src/components/SearchBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAA;AA4D7E;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,MAAY,EACZ,KAAK,EACL,YAAY,EACZ,UAAkB,EAClB,UAAiB,EACjB,gBAA0B,GAC3B,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CAkIlB"}
+{"version":3,"file":"SearchBox.d.ts","sourceRoot":"","sources":["../../../src/components/SearchBox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAW7E,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAA;AA0DjF;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,MAAY,EACZ,KAAK,EACL,YAAY,EACZ,UAAkB,EAClB,UAAiB,EACjB,aAAoB,EACpB,gBAA0B,EAC1B,UAAe,GAChB,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kFAAkF;IAClF,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IACtC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,GAAG,KAAK,CAAC,SAAS,CAoJlB"}