@askdkc/dsh-cli 0.11.3

package/lib/types/components/design-system/ThemedText.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { Color, Styles } from '../../ink/styles.js';
+import type { DOMElement } from '../../ink/dom.js';
+import { type Theme } from '../../theme.js';
+/**
+ * Colors uncolored ThemedText in the subtree. Precedence: explicit `color` >
+ * this > dimColor. Message rows set it to `text` on hover.
+ */
+export declare const TextHoverColorContext: React.Context<keyof Theme | undefined>;
+export type Props = {
+    /**
+     * Change text color. Accepts a theme key or raw color value.
+     */
+    readonly color?: keyof Theme | Color;
+    /**
+     * Same as `color`, but for background.
+     */
+    readonly backgroundColor?: keyof Theme | Color;
+    /**
+     * Dim the color using the theme's inactive color.
+     * This is compatible with bold (unlike ANSI dim).
+     */
+    readonly dimColor?: boolean;
+    /**
+     * Make the text bold.
+     */
+    readonly bold?: boolean;
+    /**
+     * Make the text italic.
+     */
+    readonly italic?: boolean;
+    /**
+     * Make the text underlined.
+     */
+    readonly underline?: boolean;
+    /**
+     * Make the text crossed with a line.
+     */
+    readonly strikethrough?: boolean;
+    /**
+     * Inverse background and foreground colors.
+     */
+    readonly inverse?: boolean;
+    /**
+     * This property tells Ink to wrap or truncate text if its width is larger than container.
+     */
+    readonly wrap?: Styles['textWrap'];
+    /**
+     * Ref to the underlying ink-text DOMElement (e.g. useDeclaredCursor
+     * parking the native cursor on an inline caret cell).
+     */
+    readonly ref?: React.Ref<DOMElement>;
+    readonly children?: React.ReactNode;
+};
+/**
+ * Theme-aware Text component that resolves theme color keys to raw colors
+ * in the dsh-TUI visual language). This lets components use
+ * `color="subtle"`-style theme keys consistently.
+ */
+export default function ThemedText({ color, backgroundColor, dimColor, bold, italic, underline, strikethrough, inverse, wrap, ref, children, }: Props): React.ReactNode;
+//# sourceMappingURL=ThemedText.d.ts.map

package/lib/types/components/design-system/ThemedText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemedText.d.ts","sourceRoot":"","sources":["../../../../src/components/design-system/ThemedText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAGrD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,wCAEtB,CAAA;AAqBZ,MAAM,MAAM,KAAK,GAAG;IAClB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAEpC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAA;IAE9C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAElC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAEpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EACjC,KAAK,EACL,eAAe,EACf,QAAgB,EAChB,IAAY,EACZ,MAAc,EACd,SAAiB,EACjB,aAAqB,EACrB,OAAe,EACf,IAAa,EACb,GAAG,EACH,QAAQ,GACT,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA6BzB"}

package/lib/types/components/design-system/ThemedText.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import Text from '../../ink/components/Text.js';
+import { getTheme } from '../../theme.js';
+import { useTheme } from './ThemeProvider.js';
+/**
+ * Colors uncolored ThemedText in the subtree. Precedence: explicit `color` >
+ * this > dimColor. Message rows set it to `text` on hover.
+ */
+export const TextHoverColorContext = React.createContext(undefined);
+/** Resolves a color value that may be a theme key to a raw Color. */
+function resolveColor(color, theme) {
+    if (!color)
+        return undefined;
+    // Check if it's a raw color (starts with rgb(, #, ansi256(, or ansi:)
+    if (color.startsWith('rgb(') ||
+        color.startsWith('#') ||
+        color.startsWith('ansi256(') ||
+        color.startsWith('ansi:')) {
+        return color;
+    }
+    // It's a theme key - resolve it ('' means "no color" in that theme)
+    return theme[color] || undefined;
+}
+/**
+ * Theme-aware Text component that resolves theme color keys to raw colors
+ * in the dsh-TUI visual language). This lets components use
+ * `color="subtle"`-style theme keys consistently.
+ */
+export default function ThemedText({ color, backgroundColor, dimColor = false, bold = false, italic = false, underline = false, strikethrough = false, inverse = false, wrap = 'wrap', ref, children, }) {
+    const [themeName] = useTheme();
+    const theme = getTheme(themeName);
+    const hoverColor = React.useContext(TextHoverColorContext);
+    // Resolve theme keys to raw colors
+    const resolvedColor = !color && hoverColor
+        ? theme[hoverColor]
+        : dimColor
+            ? theme.inactive
+            : resolveColor(color, theme);
+    const resolvedBackgroundColor = resolveColor(backgroundColor, theme);
+    return (_jsx(Text, { ref: ref, color: resolvedColor, backgroundColor: resolvedBackgroundColor, bold: bold, italic: italic, underline: underline, strikethrough: strikethrough, inverse: inverse, wrap: wrap, children: children }));
+}

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

@@ -0,0 +1,26 @@
+/**
+ * 焦点居中的列表窗口：长列表只渲染焦点附近的一段，保证焦点行始终可见。
+ * 瞬态面板走 OverlayAbove 零高度浮层后，超高部分会被 overflow 裁掉且焦点
+ * 可能落在被裁区（P1 审查实证：30 行终端 30 个模型时焦点在索引 0 完全不
+ * 可见），窗口化是硬要求。
+ *
+ * 按**行**而非项数预算：ListItem 带 description 时占两行（正文 + 描述），
+ * 容器还可能有 gap 空行——只数项数会把焦点裁出屏外（二次审查实证：每项
+ * 一行描述时索引 0 仍不可见）。调用方须保证每项行高固定（ListItem 对字符
+ * 串内容 truncate + 压平换行后恒为 1 + (description ? 1 : 0) 行）。
+ *
+ * 扩展策略：从焦点项出发向两侧交替扩张，优先补累计行数较少的一侧（焦点
+ * 大致居中）；任一侧再加会超预算或已到边界时停。焦点项本身超过 maxRows
+ * 时仍单独返回焦点项——焦点可见性优先于预算。
+ *
+ * @param heights - 每项的固定行高（≥1）。
+ * @param focusIndex - 键盘焦点项下标（越界自动 clamp）。
+ * @param maxRows - 列表区可用行数（终端高减去浮层预留与面板框架行）。
+ * @param gap - 相邻项之间的空行数（容器 gap，如 HistorySearchDialog 的 1）。
+ * @returns [start, end) 切片区间。
+ */
+export declare function listWindow(heights: readonly number[], focusIndex: number, maxRows: number, gap?: number): {
+    start: number;
+    end: number;
+};
+//# sourceMappingURL=listWindow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listWindow.d.ts","sourceRoot":"","sources":["../../../src/components/listWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,GAAG,SAAI,GACN;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAsBhC"}

package/lib/types/components/listWindow.js

@@ -0,0 +1,47 @@
+/**
+ * 焦点居中的列表窗口：长列表只渲染焦点附近的一段，保证焦点行始终可见。
+ * 瞬态面板走 OverlayAbove 零高度浮层后，超高部分会被 overflow 裁掉且焦点
+ * 可能落在被裁区（P1 审查实证：30 行终端 30 个模型时焦点在索引 0 完全不
+ * 可见），窗口化是硬要求。
+ *
+ * 按**行**而非项数预算：ListItem 带 description 时占两行（正文 + 描述），
+ * 容器还可能有 gap 空行——只数项数会把焦点裁出屏外（二次审查实证：每项
+ * 一行描述时索引 0 仍不可见）。调用方须保证每项行高固定（ListItem 对字符
+ * 串内容 truncate + 压平换行后恒为 1 + (description ? 1 : 0) 行）。
+ *
+ * 扩展策略：从焦点项出发向两侧交替扩张，优先补累计行数较少的一侧（焦点
+ * 大致居中）；任一侧再加会超预算或已到边界时停。焦点项本身超过 maxRows
+ * 时仍单独返回焦点项——焦点可见性优先于预算。
+ *
+ * @param heights - 每项的固定行高（≥1）。
+ * @param focusIndex - 键盘焦点项下标（越界自动 clamp）。
+ * @param maxRows - 列表区可用行数（终端高减去浮层预留与面板框架行）。
+ * @param gap - 相邻项之间的空行数（容器 gap，如 HistorySearchDialog 的 1）。
+ * @returns [start, end) 切片区间。
+ */
+export function listWindow(heights, focusIndex, maxRows, gap = 0) {
+    if (heights.length === 0)
+        return { start: 0, end: 0 };
+    const focus = Math.min(Math.max(focusIndex, 0), heights.length - 1);
+    let start = focus;
+    let end = focus + 1;
+    let upUsed = 0;
+    let downUsed = 0;
+    for (;;) {
+        const up = start > 0 ? gap + heights[start - 1] : Number.POSITIVE_INFINITY;
+        const down = end < heights.length ? gap + heights[end] : Number.POSITIVE_INFINITY;
+        const used = heights[focus] + upUsed + downUsed;
+        const canUp = used + up <= maxRows;
+        const canDown = used + down <= maxRows;
+        if (!canUp && !canDown)
+            return { start, end };
+        if (canUp && (!canDown || upUsed <= downUsed)) {
+            start -= 1;
+            upUsed += up;
+        }
+        else {
+            end += 1;
+            downUsed += down;
+        }
+    }
+}

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

@@ -0,0 +1,20 @@
+import React from 'react';
+type Props = {
+    text: string;
+    /** Adds the top margin between messages. */
+    marginTopOnTurn: boolean;
+    /** Message-selection mode highlight. */
+    isSelected?: boolean;
+    /** Row expanded on its own (persistent hover-grey background). */
+    isExpanded?: boolean;
+};
+/**
+ * Assistant text message: bullet + markdown body.
+ *
+ * Deliberately not clickable: the transcript is reading material and the
+ * mouse's job there is text selection (user feedback — row hover tints and
+ * fold toggling were noise, not affordance).
+ */
+export declare function AssistantTextMessage({ text, marginTopOnTurn, isSelected, isExpanded, }: Props): React.ReactNode;
+export {};
+//# sourceMappingURL=AssistantTextMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantTextMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantTextMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,eAAe,EACf,UAAkB,EAClB,UAAkB,GACnB,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA0BzB"}

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

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, NoSelect, Text } from '../../ui.js';
+import { BLACK_CIRCLE } from '../../terminal-utils/figures.js';
+import { Markdown } from '../Markdown.js';
+/**
+ * Assistant text message: bullet + markdown body.
+ *
+ * Deliberately not clickable: the transcript is reading material and the
+ * mouse's job there is text selection (user feedback — row hover tints and
+ * fold toggling were noise, not affordance).
+ */
+export function AssistantTextMessage({ text, marginTopOnTurn, isSelected = false, isExpanded = false, }) {
+    return (_jsx(Box, { alignItems: "flex-start", flexDirection: "row", justifyContent: "space-between", marginTop: marginTopOnTurn ? 1 : 0, width: "100%", backgroundColor: isSelected
+            ? 'messageActionsBackground'
+            : isExpanded
+                ? 'userMessageBackgroundHover'
+                : undefined, children: _jsxs(Box, { flexDirection: "row", children: [_jsx(NoSelect, { fromLeftEdge: true, minWidth: 2, children: _jsx(Text, { color: isSelected ? 'suggestion' : 'text', children: BLACK_CIRCLE }) }), _jsx(Box, { flexDirection: "column", children: _jsx(Markdown, { children: text }) })] }) }));
+}

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

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { ClickEvent } from '../../ink/events/click-event.js';
+type Props = {
+    thinking: string;
+    /** The FULL un-revealed text (reasoning rows under smooth streaming):
+     *  `thinking` carries the revealed slice the expanded body paints, while
+     *  the live preview ticker must follow the newest ARRIVED content — never
+     *  a lagging reveal. Falls back to `thinking`. */
+    textFull?: string;
+    /** Adds the top margin between messages. */
+    marginTopOnTurn: boolean;
+    /** Show the full text (Ctrl+O, per-row expansion, or live click toggle). */
+    verbose: boolean;
+    /** True while the reasoning block is still streaming — the leading anchor
+     *  becomes a rotating braille spinner (Kimi Code style) and settles back
+     *  to the anchor once the step ends. */
+    streaming?: boolean;
+    /** Streaming compact mode (thinkingFold=preview): a 3-row live ticker of
+     *  the model's latest reasoning lines instead of the full block —
+     *  kimicode-style constant height; the block never resizes mid-stream. */
+    preview?: boolean;
+    /** Thinking wall-clock duration once the reasoning block settled (ms). */
+    durationMs?: number;
+    /** Message-selection mode highlight. */
+    isSelected?: boolean;
+    onClick?(event: ClickEvent): void;
+};
+/**
+ * Thinking block: settled rows fold to `⚓ Thinking` plus the localized
+ * ctrl+o expand hint (hint-expand-ctrl-o);
+ * streaming rows switch between a three-line preview and the full reasoning
+ * text on click. The live leading mark is a rotating braille spinner
+ * (`⠋⠙⠹…`, Kimi Code style), settling back to the static anchor (`⚓`). When
+ * the channel records the reasoning duration, the label carries it
+ * (`⚓ Thinking · 12s …`) — dsh-tui's take on making thinking time visible in
+ * the transcript.
+ */
+export declare function AssistantThinkingMessage({ thinking, textFull, marginTopOnTurn, verbose, streaming, preview, durationMs, isSelected, onClick, }: Props): React.ReactNode;
+export {};
+//# sourceMappingURL=AssistantThinkingMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantThinkingMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantThinkingMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAUjE,KAAK,KAAK,GAAG;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB;;;sDAGkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAA;IAChB;;4CAEwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;8EAE0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CAClC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,OAAO,EACP,SAAiB,EACjB,OAAe,EACf,UAAU,EACV,UAAkB,EAClB,OAAO,GACR,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAuIzB"}

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

@@ -0,0 +1,84 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import chalk from 'chalk';
+import { Box, Text } from '../../ui.js';
+import { t } from '../../i18n.js';
+import { StreamingMarkdown } from '../StreamingMarkdown.js';
+import { formatDuration } from '../../terminal-utils/format.js';
+import { THINKING_SPINNER_FRAMES, THINKING_SPINNER_INTERVAL_MS, THINKING_SETTLED_MARKER, } from '../../terminal-utils/figures.js';
+import { BRAND, ICE } from '../shimmer.js';
+import { interpolateColor } from '../Spinner/spinnerUtils.js';
+import { isMinimalMode } from '../../minimalMode.js';
+/** Preview body rows — a FIXED row count (kimicode-style constant-height
+ *  ticker). Ink's truncate slices the whole string across newlines as one
+ *  logical line, so a single joined Text collapses to 1-2 rows whenever
+ *  the combined width passes the terminal width, then bounces back as
+ *  lines shift. One Text per row, each truncated to the width and padded
+ *  to exactly this many rows, keeps the block height stream-independent. */
+const PREVIEW_ROWS = 3;
+/**
+ * Thinking block: settled rows fold to `⚓ Thinking` plus the localized
+ * ctrl+o expand hint (hint-expand-ctrl-o);
+ * streaming rows switch between a three-line preview and the full reasoning
+ * text on click. The live leading mark is a rotating braille spinner
+ * (`⠋⠙⠹…`, Kimi Code style), settling back to the static anchor (`⚓`). When
+ * the channel records the reasoning duration, the label carries it
+ * (`⚓ Thinking · 12s …`) — dsh-tui's take on making thinking time visible in
+ * the transcript.
+ */
+export function AssistantThinkingMessage({ thinking, textFull, marginTopOnTurn, verbose, streaming = false, preview = false, durationMs, isSelected = false, onClick, }) {
+    if (!thinking)
+        return null;
+    // The preview ticker tracks the newest ARRIVED line (smooth streaming must
+    // not lag it behind the reveal); the expanded body below paints `thinking`
+    // — the revealed slice under smooth streaming, the full text otherwise.
+    const tickerText = textFull ?? thinking;
+    // Spinner frame (80ms cadence, only while the reasoning is still
+    // streaming — same pattern as BtwPanel's answering spinner).
+    const [frame, setFrame] = React.useState(0);
+    React.useEffect(() => {
+        if (!streaming)
+            return;
+        const interval = setInterval(() => setFrame(f => f + 1), THINKING_SPINNER_INTERVAL_MS);
+        return () => clearInterval(interval);
+    }, [streaming]);
+    const duration = durationMs !== undefined && durationMs >= 1000
+        ? ` · ${formatDuration(durationMs)}`
+        : '';
+    // Kimi Code style blue pulse: the streaming glyph breathes along the
+    // header's brand→ice ladder, one sine period per ~7 frames (≈0.56s) —
+    // lively without strobing. Minimal mode drops the color (plain glyph);
+    // settled always keeps the plain dim anchor.
+    const label = `${t('thinking-label')}${duration}${streaming ? '…' : ` ${t('hint-expand-ctrl-o')}`}`;
+    const minimal = isMinimalMode();
+    const pulse = (Math.sin(frame * 0.9) + 1) / 2;
+    const pulseColor = interpolateColor(BRAND, ICE, pulse);
+    const frameText = THINKING_SPINNER_FRAMES[frame % THINKING_SPINNER_FRAMES.length];
+    // Hover 轻指示：可点击折叠时折叠头从 dim 提亮为正常色（不刷整行背景，
+    // 转录视觉保持安静）。
+    const [hovered, setHovered] = React.useState(false);
+    const hoverProps = onClick !== undefined
+        ? { onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false) }
+        : {};
+    const header = streaming ? (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { children: minimal ? frameText : chalk.rgb(pulseColor.r, pulseColor.g, pulseColor.b).bold(frameText) }), _jsx(Text, { dimColor: !hovered, color: hovered ? 'text' : undefined, italic: true, children: ` ${label}` })] })) : (_jsx(Text, { italic: true, dimColor: !hovered, color: hovered ? 'text' : undefined, children: `${minimal ? '*' : THINKING_SETTLED_MARKER} ${label}` }));
+    if (preview) {
+        // Live ticker: the model's last few reasoning lines, dimmed, one Text
+        // per row so each truncates to the width independently, padded to a
+        // constant PREVIEW_ROWS-tall block that follows the stream. The folded
+        // summary takes over when the step settles. The LAST row truncates
+        // from the start (leading ellipsis) so the newest tokens — which grow
+        // at the line's end — stay visible while the line is longer than the
+        // width.
+        const lines = tickerText.split('\n');
+        const visible = lines.slice(-PREVIEW_ROWS);
+        const clipped = lines.length > visible.length;
+        // Pad with single spaces — an empty-string Text renders with zero
+        // height in ink, so '' padding would not hold the row open.
+        const rows = Array.from({ length: PREVIEW_ROWS }, (_, i) => visible[i] ?? ' ');
+        return (_jsxs(Box, { flexDirection: "column", marginTop: marginTopOnTurn ? 1 : 0, backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, ...hoverProps, children: [header, _jsx(Box, { flexDirection: "column", paddingLeft: 2, height: PREVIEW_ROWS, flexShrink: 0, overflow: "hidden", children: rows.map((line, i) => (_jsxs(Box, { flexDirection: "row", height: 1, children: [_jsx(Text, { dimColor: true, italic: true, children: '│ ' }), _jsx(Box, { flexDirection: "row", flexGrow: 1, children: _jsx(Text, { dimColor: true, italic: true, wrap: i === rows.length - 1 ? 'truncate-start' : 'truncate', children: i === 0 && clipped ? `…${line}` : line }) })] }, i))) })] }));
+    }
+    if (!verbose) {
+        return (_jsx(Box, { marginTop: marginTopOnTurn ? 1 : 0, backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, ...hoverProps, children: header }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, marginTop: marginTopOnTurn ? 1 : 0, width: "100%", backgroundColor: isSelected ? 'messageActionsBackground' : undefined, onClick: onClick, ...hoverProps, children: [header, _jsx(Box, { paddingLeft: 2, children: _jsx(StreamingMarkdown, { dimColor: true, children: thinking }) })] }));
+}

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

@@ -0,0 +1,72 @@
+import React from 'react';
+import type { ToolRow } from '../../dsh-adapter/channel.js';
+import type { ToolBackground } from '../../tuiDisplayPrefs.js';
+import type { Theme } from '../../theme.js';
+import type { ClickEvent } from '../../ink/events/click-event.js';
+type Props = {
+    tool: ToolRow;
+    /** Adds the top margin between messages. */
+    marginTopOnTurn: boolean;
+    /** Ctrl+O verbose: show full args/result instead of previews. */
+    verbose: boolean;
+    /** Message-selection mode highlight. */
+    isSelected?: boolean;
+    /** Row expanded on its own (persistent hover-grey background). */
+    isExpanded?: boolean;
+    /**
+     * Mouse click (fullscreen): toggles the row's expansion — same action as
+     * clicking other transcript rows. Also makes the localized ctrl+o expand
+     * hint (lines-folded-expand) actionable with the mouse.
+     */
+    onClick?(event: ClickEvent): void;
+    /**
+     * Trajectory pointer, rendered as one more `⎿` line under a failed call.
+     *
+     * It appears on the NEWEST unseen failure only, so a session with a dozen
+     * failed calls still shows exactly one pointer — the moment of failure is
+     * where the trajectory is worth mentioning, and mentioning it twelve times
+     * is worth less than mentioning it once.
+     */
+    footnote?: string;
+    /** Diff presentation preference; `auto` picks by terminal width. */
+    diffLayout?: 'auto' | 'split' | 'unified';
+    /** Background treatment for the ordinary, unselected tool card surface. */
+    toolBackground?: ToolBackground;
+    /**
+     * Click-to-act (fullscreen): opens the file-action menu for the tool's
+     * file path. When provided, the path in the card header (and diff path
+     * rows) renders underlined and clickable; the click stops propagation so
+     * the row's own fold-toggle does not fire.
+     */
+    onOpenFile?: (path: string) => void;
+    /**
+     * Terminal-card header folding (settings `dsh-tui.foldTerminalCommand`):
+     * collapsed cards keep the command title's first source line plus a
+     * `+N lines` hint; verbose/expanded cards render the full title.
+     */
+    foldTerminalCommand?: boolean;
+    /**
+     * Smooth streaming reveal (settings `dsh-tui.smoothStreaming`): the card
+     * BODY (diff hunks / write content — model-authored prose, not tool
+     * output) paints through an even ~30fps line reveal when it first appears,
+     * instead of one jarring block. Only the pending CALL view animates; the
+     * settled result view paints complete (real output is progress, not
+     * prose), and so do replayed cards.
+     */
+    smoothReveal?: boolean;
+    /** Live-arrived row (channel `fresh`): gates reveal participation —
+     *  replayed cards must paint complete. */
+    fresh?: boolean;
+    /** Reveal version supplied by MessageList to avoid one store subscriber per card. */
+    revealVersion?: number;
+};
+export declare function toolNameColor(raw: string): keyof Theme;
+/**
+ * Tool-call card: `● Edit /path` header with a blinking status dot, then the
+ * structured body under a `  ⎿  ` gutter — diff hunks in red/green, terminal
+ * output, read content — instead of the raw result dump. The channel captures
+ * the structured views per call.
+ */
+export declare function AssistantToolUseMessage({ tool, marginTopOnTurn, verbose, isSelected, isExpanded, onClick, footnote, diffLayout, toolBackground, onOpenFile, foldTerminalCommand, smoothReveal, fresh, revealVersion, }: Props): React.ReactNode;
+export {};
+//# sourceMappingURL=AssistantToolUseMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantToolUseMessage.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/AssistantToolUseMessage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAA8C,OAAO,EAAE,MAAM,8BAA8B,CAAA;AASvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAIjE,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,OAAO,CAAA;IACb,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAA;IACxB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;8CAC0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AA2FD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,CAKtD;AAsVD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,eAAe,EACf,OAAO,EACP,UAAkB,EAClB,UAAkB,EAClB,OAAO,EACP,QAAQ,EACR,UAAmB,EACnB,cAAuB,EACvB,UAAU,EACV,mBAA2B,EAC3B,YAAoB,EACpB,KAAa,EACb,aAAa,GACd,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CA2PzB"}