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

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

@@ -1,4 +1,6 @@
 import React from 'react';
+import type { Color } from '../ink/styles.js';
+import type { Theme } from '../theme.js';
 import type { LocalCommand } from '../commands.js';
 /**
  * The slash-command suggestion overlay, mirroring Claude Code's
@@ -23,7 +25,7 @@ export declare function CommandSuggestions({ commands, selectedIndex, columns, q
     columns: number;
     /** 原始 `/…` 输入；其最后一段 token 用于名字前缀高亮。 */
     query?: string;
-    accent?: 'promptBorder' | 'planMode';
+    accent?: keyof Theme | Color;
     /** 鼠标点击行（fullscreen）：上报过滤后列表的绝对索引（与键盘
      *  selectedIndex 同一索引空间），接受路径由 PromptInput 复用。 */
     onPick?: (index: number) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"CommandSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/CommandSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAMlD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,aAAa,EACb,OAAO,EACP,KAAU,EACV,MAAM,EACN,MAAM,EACN,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC,YAAY,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IACjE,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,cAAc,GAAG,UAAU,CAAA;IACpC;sDACkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;CACrC,GAAG,KAAK,CAAC,SAAS,CAmFlB"}
+{"version":3,"file":"CommandSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/CommandSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAMlD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,aAAa,EACb,OAAO,EACP,KAAU,EACV,MAAM,EACN,MAAM,EACN,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC,YAAY,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IACjE,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC5B;sDACkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;CACrC,GAAG,KAAK,CAAC,SAAS,CAmFlB"}

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

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { Color } from '../ink/styles.js';
+import { type ContextSegments } from '../screens/StatusMetrics.js';
+/**
+ * The hoverable JSX twin of `renderContextBar`: the same segmented context
+ * bar (same largest-remainder column split, same label fallback ladder,
+ * same free-segment readout), rendered as one Box per segment so each
+ * carries its own mouse handlers. Hovering a segment reports its key (or
+ * `free`) upward through `onHover`; the footer turns that into a detail
+ * readout on its supplemental row.
+ *
+ * Pixel parity with the ANSI path is the contract: this exists so the bar
+ * can react to the pointer, not to restyle it.
+ */
+export declare function ContextBarView({ segments, usedTokens, contextWindow, width, colors, onHover, }: {
+    /** Used tokens per content type. */
+    segments: ContextSegments;
+    /** Total used tokens, driving the usage readout. */
+    usedTokens: number;
+    /** The context window size in tokens. */
+    contextWindow: number;
+    /** Total bar width in terminal columns. */
+    width: number;
+    /** Theme overrides for the free segment (light theme passes its own). */
+    colors?: {
+        freeFill: Color;
+        freeText: Color;
+    };
+    /** Hover signal: a segment key (`system`…`tools`), `free`, or null on
+     *  leave. Absent handlers render a static bar (tests, headless embeds). */
+    onHover?: (segment: string | null) => void;
+}): React.ReactNode;
+//# sourceMappingURL=ContextBarView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBarView.d.ts","sourceRoot":"","sources":["../../../src/components/ContextBarView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAOL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAA;AAOpC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,UAAU,EACV,aAAa,EACb,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;IACD,oCAAoC;IACpC,QAAQ,EAAE,eAAe,CAAA;IACzB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAAA;IAC7C;+EAC2E;IAC3E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3C,GAAG,KAAK,CAAC,SAAS,CAgElB"}

package/lib/types/components/ContextBarView.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from '../ui.js';
+import { USED_SEGMENTS, allocateBarColumns, centeredText, chooseLabel, composeFreeSegmentText, formatTokens, } from '../screens/StatusMetrics.js';
+/** Free-segment colors, mirroring StatusMetrics' dark-theme defaults. */
+const FREE_FILL = '#E8E8E8';
+const FREE_TEXT = '#4A4A4A';
+const USED_TEXT = '#FFFFFF';
+/**
+ * The hoverable JSX twin of `renderContextBar`: the same segmented context
+ * bar (same largest-remainder column split, same label fallback ladder,
+ * same free-segment readout), rendered as one Box per segment so each
+ * carries its own mouse handlers. Hovering a segment reports its key (or
+ * `free`) upward through `onHover`; the footer turns that into a detail
+ * readout on its supplemental row.
+ *
+ * Pixel parity with the ANSI path is the contract: this exists so the bar
+ * can react to the pointer, not to restyle it.
+ */
+export function ContextBarView({ segments, usedTokens, contextWindow, width, colors, onHover, }) {
+    if (width <= 0 || contextWindow <= 0)
+        return null;
+    const freeTokens = Math.max(0, contextWindow - usedTokens);
+    const values = [...USED_SEGMENTS.map(segment => segments[segment.key]), freeTokens];
+    const columns = allocateBarColumns(values, width);
+    const percent = `${((usedTokens / contextWindow) * 100).toFixed(1)}%`;
+    const total = `${formatTokens(usedTokens)}/${formatTokens(contextWindow)}`;
+    const free = formatTokens(contextWindow - usedTokens);
+    const nodes = [];
+    for (const [index, segment] of USED_SEGMENTS.entries()) {
+        const segmentWidth = columns[index] ?? 0;
+        if (segmentWidth <= 0)
+            continue;
+        const label = chooseLabel(segment.labels, segmentWidth);
+        nodes.push(_jsx(Box, { width: segmentWidth, height: 1, flexShrink: 0, backgroundColor: segment.color, onMouseEnter: onHover === undefined ? undefined : () => onHover(segment.key), onMouseLeave: onHover === undefined ? undefined : () => onHover(null), children: _jsx(Text, { color: USED_TEXT, children: label.length > 0 ? centeredText(label, segmentWidth) : ' '.repeat(segmentWidth) }) }, segment.key));
+    }
+    const freeWidth = columns[USED_SEGMENTS.length] ?? 0;
+    if (freeWidth > 0) {
+        nodes.push(_jsx(Box, { width: freeWidth, height: 1, flexShrink: 0, backgroundColor: colors?.freeFill ?? FREE_FILL, onMouseEnter: onHover === undefined ? undefined : () => onHover('free'), onMouseLeave: onHover === undefined ? undefined : () => onHover(null), children: _jsx(Text, { color: colors?.freeText ?? FREE_TEXT, children: composeFreeSegmentText([
+                    `ctx ${total} ${percent} ${free}`,
+                    `${total} ${percent} ${free}`,
+                    `${total} ${percent}`,
+                    percent,
+                ], freeWidth) }) }, "free"));
+    }
+    return (_jsx(Box, { flexDirection: "row", flexShrink: 0, width: width, children: nodes }));
+}

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

@@ -22,7 +22,16 @@
 import React from 'react';
 import type { Color } from '../ink/styles.js';
 import type { Theme } from '../theme.js';
-export declare function EffortInputBorder({ effort, levels, columns, onLight, idleColor, children, }: {
+/** A static chip on the top border row (the session label, CC-style). */
+export interface InputBorderLabel {
+    /** Visible text (already width-truncated by the caller). */
+    text: string;
+    /** Chip background (theme token or raw color). */
+    color: keyof Theme | Color;
+    /** Chip foreground (theme token or raw color). */
+    ink: keyof Theme | Color;
+}
+export declare function EffortInputBorder({ effort, levels, columns, onLight, idleColor, topRightLabel, children, }: {
     /** 当前思考强度档 id；`undefined` 表示路线未声明。 */
     effort: string | undefined;
     /** 当前路线的档位表（低→高，末位为最高档）；未知时传 `undefined`。 */
@@ -31,6 +40,8 @@ export declare function EffortInputBorder({ effort, levels, columns, onLight, id
     onLight: boolean;
     /** 静止边框色（主题 token 名，如 'promptBorder' / 'planMode'）。 */
     idleColor: keyof Theme | Color;
+    /** 顶边框右侧的静态标签 chip（会话名标签）；undefined = 不显示。 */
+    topRightLabel?: InputBorderLabel;
     children: React.ReactNode;
 }): React.ReactNode;
 //# sourceMappingURL=EffortInputBorder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EffortInputBorder.d.ts","sourceRoot":"","sources":["../../../src/components/EffortInputBorder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAA8D,MAAM,OAAO,CAAA;AAGlF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAgCxC,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,QAAQ,GACT,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,SAAS,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,GAAG,KAAK,CAAC,SAAS,CA0DlB"}
+{"version":3,"file":"EffortInputBorder.d.ts","sourceRoot":"","sources":["../../../src/components/EffortInputBorder.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAA8D,MAAM,OAAO,CAAA;AAGlF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAKxC,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,KAAK,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC1B,kDAAkD;IAClD,GAAG,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;CACzB;AAiDD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,aAAa,EACb,QAAQ,GACT,EAAE;IACD,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,SAAS,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC9B,8CAA8C;IAC9C,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,GAAG,KAAK,CAAC,SAAS,CA0DlB"}

package/lib/types/components/EffortInputBorder.js

@@ -23,12 +23,29 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useContext, useEffect, useReducer, useState } from 'react';
 import { Box, Text } from '../ui.js';
 import { ClockContext } from '../ink/components/ClockContext.js';
+import { stringWidth } from '../ink/stringWidth.js';
 import { IGNITION_TIMELINE, ignitionLineColors } from '../trajectory/effortIgnition.js';
-/** 边框行（顶/底共用同一色段序列——同步变色）。 */
-function BorderRow({ left, right, runs, idleColor, }) {
-    return (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: idleColor, children: left }), runs.map((run, i) => (_jsx(Text, { color: run.color, children: run.glyph }, i))), _jsx(Text, { color: idleColor, children: right })] }) }));
+/** 边框行（顶/底共用同一色段序列——同步变色）。顶行可在右圆角前插入
+ *  一个静态标签 chip（会话名），占用的列数从色段序列里扣掉，行宽不变。 */
+function BorderRow({ left, right, runs, idleColor, label, }) {
+    const labelWidth = label === undefined ? 0 : stringWidth(` ${label.text} `);
+    // chip 与右圆角之间的留白（边框线格数）：视觉上不让标签贴死 ╮。
+    const labelGap = label === undefined ? 0 : 2;
+    // 裁剪色段序列到剩余列数（label 行与底行的列数一致，总宽不变）。
+    // 色段保留左侧部分，右侧让位给 chip + 留白（右上角布局）。
+    let budget = Math.max(0, runs.reduce((sum, run) => sum + run.glyph.length, 0) - labelWidth - labelGap);
+    const clipped = [];
+    for (const run of runs) {
+        if (budget <= 0)
+            break;
+        const take = Math.min(run.glyph.length, budget);
+        if (take > 0)
+            clipped.push({ glyph: run.glyph.slice(0, take), color: run.color });
+        budget -= take;
+    }
+    return (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: idleColor, children: left }), clipped.map((run, i) => (_jsx(Text, { color: run.color, children: run.glyph }, i))), label !== undefined && (_jsx(Text, { backgroundColor: label.color, color: label.ink, children: ` ${label.text} ` })), label !== undefined && _jsx(Text, { color: idleColor, children: '─'.repeat(labelGap) }), _jsx(Text, { color: idleColor, children: right })] }) }));
 }
-export function EffortInputBorder({ effort, levels, columns, onLight, idleColor, children, }) {
+export function EffortInputBorder({ effort, levels, columns, onLight, idleColor, topRightLabel, children, }) {
     const clock = useContext(ClockContext);
     const [overlay, setOverlay] = useState(null);
     const [prevEffort, setPrevEffort] = useState(effort);
@@ -69,5 +86,5 @@ export function EffortInputBorder({ effort, levels, columns, onLight, idleColor,
         else
             runs.push({ glyph: '─', color });
     }
-    return (_jsxs(Box, { flexDirection: "column", alignItems: "flex-start", justifyContent: "flex-start", width: "100%", flexShrink: 0, children: [_jsx(BorderRow, { left: "\u256D", right: "\u256E", runs: runs, idleColor: idleColor }), _jsx(Box, { flexShrink: 0, children: children }), _jsx(BorderRow, { left: "\u2570", right: "\u256F", runs: runs, idleColor: idleColor })] }));
+    return (_jsxs(Box, { flexDirection: "column", alignItems: "flex-start", justifyContent: "flex-start", width: "100%", flexShrink: 0, children: [_jsx(BorderRow, { left: "\u256D", right: "\u256E", runs: runs, idleColor: idleColor, label: topRightLabel }), _jsx(Box, { flexShrink: 0, children: children }), _jsx(BorderRow, { left: "\u2570", right: "\u256F", runs: runs, idleColor: idleColor })] }));
 }

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

@@ -0,0 +1,22 @@
+import React from 'react';
+/**
+ * Click-to-act file menu (fullscreen): opened by clicking a file path in
+ * the transcript (tool cards, markdown code spans / plain text, file://
+ * links). Rows: open the target, reveal it in the file manager, copy its
+ * absolute path. The path shown is already resolved to an absolute path by
+ * the caller (Chat.tsx resolves against the channel cwd at click time).
+ * When the target is a directory, the first row reads "open folder" — the
+ * same action (default handler), just honest about what it opens.
+ */
+export declare const FILE_ACTION_COUNT = 3;
+export declare function FileActionsPanel({ path, isDir, focusIndex, onPick, }: {
+    /** Absolute path the actions operate on (caller-resolved). */
+    path: string;
+    /** Whether the target exists on disk and is a directory. */
+    isDir: boolean;
+    /** Index of the keyboard-focused row. */
+    focusIndex: number;
+    /** Mouse pick (fullscreen): clicked row's absolute index. */
+    onPick?: (index: number) => void;
+}): React.ReactNode;
+//# sourceMappingURL=FileActionsPanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileActionsPanel.d.ts","sourceRoot":"","sources":["../../../src/components/FileActionsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAKlC,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,UAAU,EACV,MAAM,GACP,EAAE;IACD,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAA;IACd,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CAiClB"}

package/lib/types/components/FileActionsPanel.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { t } from '../i18n.js';
+import { Box, Text } from '../ui.js';
+import { Pane } from './design-system/Pane.js';
+import { Select } from './Select.js';
+import { HintLine } from './design-system/HintLine.js';
+import { truncateToWidth } from '../ink/truncateToWidth.js';
+/**
+ * Click-to-act file menu (fullscreen): opened by clicking a file path in
+ * the transcript (tool cards, markdown code spans / plain text, file://
+ * links). Rows: open the target, reveal it in the file manager, copy its
+ * absolute path. The path shown is already resolved to an absolute path by
+ * the caller (Chat.tsx resolves against the channel cwd at click time).
+ * When the target is a directory, the first row reads "open folder" — the
+ * same action (default handler), just honest about what it opens.
+ */
+export const FILE_ACTION_COUNT = 3;
+/** How many terminal cells of the path fit next to the title. */
+const PATH_DISPLAY_BUDGET = 48;
+export function FileActionsPanel({ path, isDir, focusIndex, onPick, }) {
+    const options = React.useMemo(() => [
+        { value: 'open', label: t(isDir ? 'file-actions-open-dir' : 'file-actions-open') },
+        { value: 'reveal', label: t('file-actions-reveal') },
+        { value: 'copy', label: t('file-actions-copy') },
+    ], [isDir]);
+    return (_jsx(Pane, { color: "permission", children: _jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", marginBottom: 1, children: [_jsx(Text, { color: "remember", bold: true, children: t('file-actions-title') }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [' ', truncateToWidth(path, PATH_DISPLAY_BUDGET)] })] }), _jsx(Select, { options: options, focusIndex: focusIndex, selectedValue: undefined, visibleOptionCount: FILE_ACTION_COUNT, onPick: onPick ? index => onPick(index) : undefined }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-confirm-exit') }) })] }) }));
+}

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

@@ -1,4 +1,6 @@
 import React from 'react';
+import type { Color } from '../ink/styles.js';
+import type { Theme } from '../theme.js';
 import type { FileCandidate } from '../utils/fileSuggestions.js';
 /**
  * The `@` file-completion overlay in CC's suggestion style, wrapped in the
@@ -23,7 +25,7 @@ export declare function FileSuggestions({ files, selectedIndex, columns, query,
     columns: number;
     /** `@` 触发 token 里已输入的查询（`mention.query`），用于名字前缀高亮。 */
     query?: string;
-    accent?: 'promptBorder' | 'planMode';
+    accent?: keyof Theme | Color;
     /** 鼠标点击行（fullscreen）：上报过滤后列表的绝对索引（与键盘
      *  selectedIndex 同一索引空间），接受路径由 PromptInput 复用。 */
     onPick?: (index: number) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"FileSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/FileSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAKhE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,aAAa,EACb,OAAO,EACP,KAAU,EACV,MAAM,EACN,MAAM,EACN,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,cAAc,GAAG,UAAU,CAAA;IACpC;sDACkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;CACrC,GAAG,KAAK,CAAC,SAAS,CAgFlB"}
+{"version":3,"file":"FileSuggestions.d.ts","sourceRoot":"","sources":["../../../src/components/FileSuggestions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAKhE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,aAAa,EACb,OAAO,EACP,KAAU,EACV,MAAM,EACN,MAAM,EACN,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAC5B;sDACkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;CACrC,GAAG,KAAK,CAAC,SAAS,CAgFlB"}

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

@@ -4,7 +4,7 @@ import type { ChatRow } from '../dsh-adapter/channel.js';
 import type { DOMElement } from '../ink/dom.js';
 import { type TimelineSnapshot } from '../ink/timeline-rail.js';
 import type { ToolBackground } from '../tuiDisplayPrefs.js';
-export declare function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamFoldedRows, onToggleStreamFold, model, diffLayout, thinkingFold, toolBackground, activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible, historyPaintEnabled, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, }: {
+export declare function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamFoldedRows, onToggleStreamFold, model, diffLayout, thinkingFold, toolBackground, activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible, historyPaintEnabled, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, onOpenFile, }: {
     rows: readonly ChatRow[];
     expanded: boolean;
     expandedRows: ReadonlySet<number>;
@@ -82,6 +82,8 @@ export declare function MessageList({ rows, expanded, expandedRows, selectedId,
     failureHint?: string;
     /** 打开子代理详情场景（transcript 内点击子代理卡）。 */
     onOpenSubagent?: (agentId: string) => void;
+    /** 点击工具卡内的文件路径（打开文件操作菜单）。 */
+    onOpenFile?: (path: string) => void;
 }): React.JSX.Element;
 /**
  * The header block pinned above the transcript: the DeepSeek pixel whale

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

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

package/lib/types/components/MessageList.js

@@ -115,7 +115,7 @@ function signatureParts(row, columns, expanded, expandedRows, streamFolded, thin
     }
     return signatureScratch;
 }
-export function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamFoldedRows = NO_STREAM_FOLDED, onToggleStreamFold = NOOP_TOGGLE_STREAM_FOLD, model, diffLayout = 'auto', thinkingFold = 'preview', toolBackground = 'none', activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible = true, historyPaintEnabled = true, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, }) {
+export function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamFoldedRows = NO_STREAM_FOLDED, onToggleStreamFold = NOOP_TOGGLE_STREAM_FOLD, model, diffLayout = 'auto', thinkingFold = 'preview', toolBackground = 'none', activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible = true, historyPaintEnabled = true, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, onOpenFile, }) {
     const hiddenCount = rows.length - MAX_RENDERED_ROWS;
     // The thinking filter runs BEFORE virtualization so window indices line up.
     //
@@ -164,15 +164,22 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
         // that is STILL STREAMING keeps its place even with empty text — the
         // live dot is the "model is answering" affordance and content may yet
         // arrive.
+        // The emptiness test must match what RENDERING shows: the `⏵`
+        // self-narration line (dsh-working-activity narrate contract) is
+        // stripped at render (stripNarration below), so a narration-only step —
+        // thinking, `⏵ …` line, straight to a tool call — has non-empty raw
+        // text but RENDERS as that same lone `●`. Test the stripped text, or
+        // the raw-text check lets the dot through forever.
+        const rendersEmptyAssistant = (row) => row.kind === 'assistant' && row.streaming !== true && stripNarration(row.text ?? '').trim() === '';
         let hasEmptyAssistant = false;
         for (const row of sliced) {
-            if (row.kind === 'assistant' && row.streaming !== true && (row.text ?? '').trim() === '') {
+            if (rendersEmptyAssistant(row)) {
                 hasEmptyAssistant = true;
                 break;
             }
         }
         const out = hasEmptyAssistant
-            ? sliced.filter(row => !(row.kind === 'assistant' && row.streaming !== true && (row.text ?? '').trim() === '') &&
+            ? sliced.filter(row => !rendersEmptyAssistant(row) &&
                 (thinkingVisible || row.kind !== 'reasoning'))
             : thinkingVisible
                 ? sliced
@@ -821,7 +828,7 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
                 const addMargin = margins.get(row.id) === true;
                 const tool = row.tool;
                 const subagent = row.kind === 'subagent' ? row.subagent : undefined;
-                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, toolBackground: toolBackground, activityFrames: activityFrames, 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, subagent: subagent, onToggleRow: onToggleRow, onToggleStreamFold: onToggleStreamFold, streamFolded: streamFoldedRows.has(row.id), onOpenSubagent: onOpenSubagent, 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, toolBackground: toolBackground, activityFrames: activityFrames, 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, subagent: subagent, onToggleRow: onToggleRow, onToggleStreamFold: onToggleStreamFold, streamFolded: streamFoldedRows.has(row.id), onOpenSubagent: onOpenSubagent, onOpenFile: onOpenFile, setRowRef: setRowRef }, row.id));
             }), bottomPad > 0 && _jsx(Box, { height: bottomPad, flexShrink: 0 })] }));
 }
 /** Load-earlier / show-previous divider row with a mouse hover tint — the
@@ -830,7 +837,7 @@ function ClickableDivider({ title, onClick }) {
     const [hovered, setHovered] = useState(false);
     return (_jsx(Box, { marginTop: 1, onClick: onClick, onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), backgroundColor: hovered ? 'userMessageBackgroundHover' : undefined, children: _jsx(Divider, { title: title }) }));
 }
-function TranscriptRow({ rowId, kind, text, executionTarget, streaming, durationMs, time, addMargin, isSelected, isExpanded, expanded, model, diffLayout, thinkingFold, toolBackground, activityFrames, background, toolCallId, toolName, toolArgsText, toolArgsFull, toolStatus, toolResultText, toolResultFull, toolErrorText, toolFootnote, toolCallView, toolResultView, toolStartedAt, toolDurationMs, subagent, onToggleRow, onToggleStreamFold, streamFolded, onOpenSubagent, setRowRef, }) {
+function TranscriptRow({ rowId, kind, text, executionTarget, streaming, durationMs, time, addMargin, isSelected, isExpanded, expanded, model, diffLayout, thinkingFold, toolBackground, activityFrames, background, toolCallId, toolName, toolArgsText, toolArgsFull, toolStatus, toolResultText, toolResultFull, toolErrorText, toolFootnote, toolCallView, toolResultView, toolStartedAt, toolDurationMs, subagent, onToggleRow, onToggleStreamFold, streamFolded, onOpenSubagent, onOpenFile, setRowRef, }) {
     const ref = React.useCallback((el) => {
         setRowRef(rowId, el);
     }, [setRowRef, rowId]);
@@ -895,7 +902,7 @@ function TranscriptRow({ rowId, kind, text, executionTarget, streaming, duration
                 startedAt: toolStartedAt,
                 durationMs: toolDurationMs,
             };
-            return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(AssistantToolUseMessage, { tool: tool, addMargin: addMargin, verbose: isExpanded || expanded, isSelected: isSelected, isExpanded: isExpanded, footnote: toolFootnote, diffLayout: diffLayout, toolBackground: toolBackground, onClick: foldOnClick }) }));
+            return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(AssistantToolUseMessage, { tool: tool, addMargin: addMargin, verbose: isExpanded || expanded, isSelected: isSelected, isExpanded: isExpanded, footnote: toolFootnote, diffLayout: diffLayout, toolBackground: toolBackground, onClick: foldOnClick, onOpenFile: onOpenFile }) }));
         }
         case 'notice':
             return (_jsx(Box, { marginTop: 1, ref: ref, children: _jsx(Divider, { title: ` ${text} ` }) }));

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

@@ -1,20 +1,42 @@
 import React from 'react';
 import type { LlmModelInfo } from '../dsh-adapter/types.js';
+import type { ModelGroupRow } from '../modelGroups.js';
 /**
  * Model picker in the CC ModelPicker style: a permission-colored Pane with
- * the model list as Select rows (❯ focus pointer, ✓ on the active model,
+ * the rows as Select entries (❯ focus pointer, ✓ on the active row,
  * descriptions), plus the Enter/Esc hint line. The DSH agent's model is
  * fixed at creation time, so a selection notifies "restart to apply".
  *
+ * Two levels: the top level lists **provider groups** (registry display
+ * name + model count, ✓ on the current provider's row) and drills in with
+ * Enter; the second level lists that group's models and switches with
+ * Enter — the same live-fork path the flat picker always had. A
+ * single-group catalog skips the top level entirely (showBack=false, plain
+ * confirm/exit hint), so single-provider setups keep the pre-grouping UX.
+ *
  * 长列表按焦点窗口化（Select 同款）：picker 经 OverlayAbove 浮层挂载后有
  * maxHeight 裁剪，全量渲染会让焦点行被裁掉（看不到焦点按 Enter）。
  */
-export declare function ModelPicker({ models, focusIndex, currentModel, onPick, }: {
+export declare function ModelPicker(props: {
+    /** Top level: provider groups; Enter/click drills into one. */
+    groups: readonly ModelGroupRow[];
+    focusIndex: number;
+    /** Current route key — its group row carries the ✓ marker. */
+    currentProvider: string;
+    onPick?: (index: number) => void;
+} | {
+    /** Second level (or single-group fast path): one provider's models —
+     *  or the mixed-provider recents list (`showProviderPrefix`). */
     models: readonly LlmModelInfo[];
+    /** The group's display label as this pane's title (default: "Model"). */
+    groupLabel?: string;
+    /** Multi-group catalogs show the back hint; the fast path keeps the plain one. */
+    showBack: boolean;
+    /** Prefix each row with its provider (the recents group mixes providers). */
+    showProviderPrefix?: boolean;
     focusIndex: number;
+    /** `provider/model` of the current model — its row carries the ✓ marker. */
     currentModel: string;
-    /** Mouse pick (fullscreen): reports the clicked row's absolute index —
-     *  Chat applies it with the same code path as the keyboard Enter. */
     onPick?: (index: number) => void;
 }): React.ReactNode;
 //# sourceMappingURL=ModelPicker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ModelPicker.d.ts","sourceRoot":"","sources":["../../../src/components/ModelPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAM3D;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,UAAU,EACV,YAAY,EACZ,MAAM,GACP,EAAE;IACD,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB;yEACqE;IACrE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CAwClB"}
+{"version":3,"file":"ModelPicker.d.ts","sourceRoot":"","sources":["../../../src/components/ModelPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAOtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAC7B;IACA,+DAA+D;IAC/D,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GACC;IACA;qEACiE;IACjE,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CA4DpB"}

package/lib/types/components/ModelPicker.js

@@ -1,27 +1,47 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { t } from '../i18n.js';
 import { Box, Text, useTerminalSize } from '../ui.js';
+import { RECENTS_GROUP_PROVIDER, RECENTS_LABEL_PLACEHOLDER } from '../modelGroups.js';
 import { Pane } from './design-system/Pane.js';
 import { ListItem } from './design-system/ListItem.js';
 import { HintLine } from './design-system/HintLine.js';
 import { listWindow } from './listWindow.js';
 /**
  * Model picker in the CC ModelPicker style: a permission-colored Pane with
- * the model list as Select rows (❯ focus pointer, ✓ on the active model,
+ * the rows as Select entries (❯ focus pointer, ✓ on the active row,
  * descriptions), plus the Enter/Esc hint line. The DSH agent's model is
  * fixed at creation time, so a selection notifies "restart to apply".
  *
+ * Two levels: the top level lists **provider groups** (registry display
+ * name + model count, ✓ on the current provider's row) and drills in with
+ * Enter; the second level lists that group's models and switches with
+ * Enter — the same live-fork path the flat picker always had. A
+ * single-group catalog skips the top level entirely (showBack=false, plain
+ * confirm/exit hint), so single-provider setups keep the pre-grouping UX.
+ *
  * 长列表按焦点窗口化（Select 同款）：picker 经 OverlayAbove 浮层挂载后有
  * maxHeight 裁剪，全量渲染会让焦点行被裁掉（看不到焦点按 Enter）。
  */
-export function ModelPicker({ models, focusIndex, currentModel, onPick, }) {
+export function ModelPicker(props) {
+    const inGroups = 'groups' in props;
     const { rows: terminalRows } = useTerminalSize();
+    // Captured before the map: union narrowing does not survive into closures.
+    const onPick = props.onPick;
     // 焦点窗口化按行预算：ListItem 带 description 时占 2 行（正文+描述，均
     // truncate 成单行），只数项数会把焦点裁出浮层（二次审查实证）。
     // 框架行：浮层预留 8 + Pane 2 + 标题 2 + 页脚 1 + 挂载包裹 marginTop 1 = 14。
-    const { start, end } = listWindow(models.map(m => (m.description ? 2 : 1)), focusIndex, Math.max(terminalRows - 14, 2));
-    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: t('picker-title-model') }) }), models.slice(start, end).map((model, index) => {
+    const rowHeights = inGroups
+        ? props.groups.map(() => 2)
+        : props.models.map(m => (m.description ? 2 : 1));
+    const rows = inGroups ? props.groups : props.models;
+    const { start, end } = listWindow(rowHeights, props.focusIndex, Math.max(terminalRows - 14, 2));
+    const hint = inGroups
+        ? t('hint-model-groups')
+        : props.showBack ? t('hint-model-back') : t('hint-confirm-exit');
+    return (_jsxs(Pane, { color: "permission", children: [_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "remember", bold: true, children: inGroups || props.groupLabel === undefined ? t('picker-title-model') : props.groupLabel }) }), rows.slice(start, end).map((row, index) => {
                         const absoluteIndex = start + index;
-                        return (_jsxs(ListItem, { isFocused: absoluteIndex === focusIndex, isSelected: `${model.provider}/${model.id}` === currentModel, description: model.description, showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < models.length, onClick: onPick ? () => onPick(absoluteIndex) : undefined, children: [model.provider, " / ", model.name] }, `${model.provider}/${model.id}`));
-                    })] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: t('hint-confirm-exit') }) })] }));
+                        return inGroups ? (_jsx(ListItem, { isFocused: absoluteIndex === props.focusIndex, isSelected: row.provider === props.currentProvider, description: t('picker-group-count', { count: row.count }), showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < rows.length, onClick: onPick ? () => onPick(absoluteIndex) : undefined, children: row.label === RECENTS_LABEL_PLACEHOLDER && row.provider === RECENTS_GROUP_PROVIDER
+                                ? t('picker-group-recent')
+                                : row.label }, row.provider)) : (_jsx(ListItem, { isFocused: absoluteIndex === props.focusIndex, isSelected: `${row.provider}/${row.id}` === props.currentModel, description: row.description, showScrollUp: absoluteIndex === start && start > 0, showScrollDown: absoluteIndex === end - 1 && end < rows.length, onClick: onPick ? () => onPick(absoluteIndex) : undefined, children: props.showProviderPrefix === true ? `${row.provider} / ${row.name}` : row.name }, `${row.provider}/${row.id}`));
+                    })] }), _jsx(Text, { dimColor: true, italic: true, children: _jsx(HintLine, { text: hint }) })] }));
 }

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;AAiBzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAmIxD;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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,qBAolClB"}
+{"version":3,"file":"PromptInput.d.ts","sourceRoot":"","sources":["../../../src/components/PromptInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAmBzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAmJxD;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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,qBAi8ClB"}