hyacinth-ai 0.9.6

package/dist/ui/slash-panel.js

@@ -0,0 +1,199 @@
+/**
+ * SlashSubPanel — 斜杠命令二级菜单浮层面板
+ *
+ * 当用户输入有 children 的斜杠命令（如 /model）时弹出，
+ * 使用 pi-tui SelectList 提供上下选择、回车确认、Esc 退出。
+ */
+import { Box, matchesKey, SelectList, Text } from '@earendil-works/pi-tui';
+export const DEFAULT_PANEL_THEME = {
+    title: (t) => `\x1b[1;36m${t}\x1b[0m`,
+    hint: (t) => `\x1b[2m${t}\x1b[0m`,
+    selectedPrefix: (t) => `\x1b[1;33m>\x1b[0m `,
+    selectedText: (t) => `\x1b[1;37m${t}\x1b[0m`,
+    description: (t) => `\x1b[2m${t}\x1b[0m`,
+    scrollInfo: (t) => `\x1b[2m${t}\x1b[0m`,
+    noMatch: (t) => `\x1b[2m${t}\x1b[0m`,
+};
+export class SlashSubPanel {
+    container;
+    selectList;
+    promptText;
+    resolved = null;
+    tui = null;
+    keyListenerId = null;
+    items;
+    parentCommand;
+    children;
+    parentName;
+    theme;
+    // ── Multi-level navigation ──────────────────────────────
+    parentPanel = null;
+    childPanel = null;
+    active = false;
+    fullPath;
+    constructor(parentCommand, theme = DEFAULT_PANEL_THEME, parentPanel = null, pathPrefix = '') {
+        this.parentCommand = parentCommand;
+        this.children = parentCommand.children ?? [];
+        this.parentName = parentCommand.name;
+        this.theme = theme;
+        this.parentPanel = parentPanel;
+        this.fullPath = pathPrefix ? `${pathPrefix}/${parentCommand.name}` : parentCommand.name;
+        this.items = this.buildItems(this.children);
+        const selectTheme = {
+            selectedPrefix: theme.selectedPrefix,
+            selectedText: theme.selectedText,
+            description: theme.description,
+            scrollInfo: theme.scrollInfo,
+            noMatch: theme.noMatch,
+        };
+        const maxVisible = Math.min(this.items.length, 10);
+        this.selectList = new SelectList(this.items, maxVisible, selectTheme);
+        this.promptText = new Text(theme.title(` ${this.fullPath}`) +
+            theme.hint(' — (\u2191\u2193 navigate, Enter/Space confirm, Esc back)'), 0, 0);
+        this.container = new Box(1, 1);
+        this.container.addChild(this.promptText);
+        this.container.addChild(this.selectList);
+    }
+    getContainer() {
+        return this.container;
+    }
+    getSelectList() {
+        return this.selectList;
+    }
+    buildItems(cmds) {
+        return cmds.map((c) => ({
+            value: `${this.fullPath}/${c.name}`,
+            label: c.args ? `/${this.fullPath} ${c.name} ${c.args}` : `/${this.fullPath} ${c.name}`,
+            description: c.description + (c.args ? ` ${c.args}` : ''),
+        }));
+    }
+    async show(tui, onResolve) {
+        // 动态子命令：面板打开时从 childrenProvider 生成
+        if (this.parentCommand.childrenProvider) {
+            const dynamic = await this.parentCommand.childrenProvider();
+            if (dynamic.length > 0) {
+                this.children = dynamic;
+                this.items = this.buildItems(dynamic);
+                // 重建 SelectList 以反映新 items
+                const maxVisible = Math.min(this.items.length, 10);
+                const selectTheme = {
+                    selectedPrefix: this.theme.selectedPrefix,
+                    selectedText: this.theme.selectedText,
+                    description: this.theme.description,
+                    scrollInfo: this.theme.scrollInfo,
+                    noMatch: this.theme.noMatch,
+                };
+                const oldList = this.selectList;
+                this.selectList = new SelectList(this.items, maxVisible, selectTheme);
+                this.container.removeChild(oldList);
+                this.container.addChild(this.selectList);
+            }
+        }
+        this.tui = tui;
+        this.resolved = onResolve;
+        this.active = true;
+        this.keyListenerId = `slashpanel_${Date.now()}`;
+        tui.showOverlay(this.container);
+        tui.requestRender();
+        tui.addInputListener((data) => {
+            if (!this.active || !this.resolved)
+                return undefined;
+            if (matchesKey(data, 'escape')) {
+                if (this.parentPanel) {
+                    // 3. Esc with parent: close self, restore parent panel
+                    this.close();
+                    this.parentPanel.restoreFromChild();
+                }
+                else {
+                    // 3. Esc without parent (root): dismiss with null
+                    this.dismiss(null);
+                }
+                return { consume: true };
+            }
+            if (matchesKey(data, 'up')) {
+                const item = this.selectList.getSelectedItem();
+                const idx = item ? this.items.findIndex((i) => i.value === item.value) : 0;
+                const newIdx = Math.max(0, idx - 1);
+                this.selectList.setSelectedIndex(newIdx);
+                tui.requestRender();
+                return { consume: true };
+            }
+            if (matchesKey(data, 'down')) {
+                const item = this.selectList.getSelectedItem();
+                const idx = item ? this.items.findIndex((i) => i.value === item.value) : -1;
+                const newIdx = Math.min(this.items.length - 1, idx + 1);
+                this.selectList.setSelectedIndex(newIdx);
+                tui.requestRender();
+                return { consume: true };
+            }
+            // 4. Space/Return/Enter activation
+            if (matchesKey(data, 'return') || matchesKey(data, 'enter') || matchesKey(data, 'space')) {
+                const selected = this.selectList.getSelectedItem();
+                if (selected) {
+                    const parts = selected.value.split('/');
+                    const childCmd = this.children.find((c) => c.name === parts[parts.length - 1]);
+                    if (childCmd) {
+                        if (childCmd.children && childCmd.children.length > 0) {
+                            // 1. Selected sub-command has children: open child panel
+                            this.openChild(childCmd);
+                        }
+                        else {
+                            // Leaf command: resolve
+                            this.dismiss({ path: selected.value, command: childCmd });
+                        }
+                    }
+                }
+                return { consume: true };
+            }
+            return { consume: true };
+        });
+    }
+    // ── Multi-level helpers ──────────────────────────────────
+    /** 1. Open a child panel for a sub-command that has its own children */
+    openChild(childCmd) {
+        this.active = false;
+        if (this.tui) {
+            this.tui.hideOverlay();
+        }
+        this.childPanel = new SlashSubPanel(childCmd, this.theme, this, this.fullPath);
+        this.childPanel.show(this.tui, (result) => {
+            this.childPanel = null;
+            if (result) {
+                // Child resolved with a final result → propagate upward
+                this.dismiss(result);
+            }
+            // If result is null, child was discarded via Esc → restoreFromChild already called
+        });
+    }
+    /** Restore this panel after a child panel was dismissed via Esc */
+    restoreFromChild() {
+        this.childPanel = null;
+        this.active = true;
+        if (this.tui) {
+            this.tui.showOverlay(this.container);
+            this.tui.requestRender();
+        }
+    }
+    /** Close this panel without resolving (used when Esc navigates up to parent) */
+    close() {
+        this.active = false;
+        this.resolved = null;
+        if (this.tui) {
+            this.tui.hideOverlay();
+        }
+    }
+    /** Terminal: resolve and clean up */
+    dismiss(result) {
+        this.active = false;
+        if (this.resolved) {
+            const cb = this.resolved;
+            this.resolved = null;
+            cb(result);
+        }
+        if (this.tui) {
+            this.tui.hideOverlay();
+            this.tui.requestRender();
+        }
+    }
+}
+//# sourceMappingURL=slash-panel.js.map

package/dist/ui/theme.d.ts

@@ -0,0 +1,120 @@
+import type { EditorTheme, MarkdownTheme, SelectListTheme } from '@earendil-works/pi-tui';
+export declare const lightMode: boolean;
+export declare const darkPalette: {
+    readonly text: "#E8E3D5";
+    readonly dim: "#7B7F87";
+    readonly accent: "#F6C453";
+    readonly accentSoft: "#F2A65A";
+    readonly border: "#3C414B";
+    readonly userBg: "#2B2F36";
+    readonly userText: "#F3EEE0";
+    readonly systemText: "#9BA3B2";
+    readonly toolPendingBg: "#1F2A2F";
+    readonly toolSuccessBg: "#1E2D23";
+    readonly toolErrorBg: "#2F1F1F";
+    readonly toolTitle: "#F6C453";
+    readonly toolOutput: "#E1DACB";
+    readonly quote: "#8CC8FF";
+    readonly quoteBorder: "#3B4D6B";
+    readonly code: "#F0C987";
+    readonly codeBlock: "#1E232A";
+    readonly codeBorder: "#343A45";
+    readonly link: "#7DD3A5";
+    readonly error: "#F97066";
+    readonly success: "#7DD3A5";
+};
+export declare const lightPalette: {
+    readonly text: "#1E1E1E";
+    readonly dim: "#5B6472";
+    readonly accent: "#B45309";
+    readonly accentSoft: "#C2410C";
+    readonly border: "#5B6472";
+    readonly userBg: "#F3F0E8";
+    readonly userText: "#1E1E1E";
+    readonly systemText: "#4B5563";
+    readonly toolPendingBg: "#EFF6FF";
+    readonly toolSuccessBg: "#ECFDF5";
+    readonly toolErrorBg: "#FEF2F2";
+    readonly toolTitle: "#B45309";
+    readonly toolOutput: "#374151";
+    readonly quote: "#1D4ED8";
+    readonly quoteBorder: "#2563EB";
+    readonly code: "#92400E";
+    readonly codeBlock: "#F9FAFB";
+    readonly codeBorder: "#92400E";
+    readonly link: "#047857";
+    readonly error: "#DC2626";
+    readonly success: "#047857";
+};
+export declare const palette: {
+    readonly text: "#E8E3D5";
+    readonly dim: "#7B7F87";
+    readonly accent: "#F6C453";
+    readonly accentSoft: "#F2A65A";
+    readonly border: "#3C414B";
+    readonly userBg: "#2B2F36";
+    readonly userText: "#F3EEE0";
+    readonly systemText: "#9BA3B2";
+    readonly toolPendingBg: "#1F2A2F";
+    readonly toolSuccessBg: "#1E2D23";
+    readonly toolErrorBg: "#2F1F1F";
+    readonly toolTitle: "#F6C453";
+    readonly toolOutput: "#E1DACB";
+    readonly quote: "#8CC8FF";
+    readonly quoteBorder: "#3B4D6B";
+    readonly code: "#F0C987";
+    readonly codeBlock: "#1E232A";
+    readonly codeBorder: "#343A45";
+    readonly link: "#7DD3A5";
+    readonly error: "#F97066";
+    readonly success: "#7DD3A5";
+} | {
+    readonly text: "#1E1E1E";
+    readonly dim: "#5B6472";
+    readonly accent: "#B45309";
+    readonly accentSoft: "#C2410C";
+    readonly border: "#5B6472";
+    readonly userBg: "#F3F0E8";
+    readonly userText: "#1E1E1E";
+    readonly systemText: "#4B5563";
+    readonly toolPendingBg: "#EFF6FF";
+    readonly toolSuccessBg: "#ECFDF5";
+    readonly toolErrorBg: "#FEF2F2";
+    readonly toolTitle: "#B45309";
+    readonly toolOutput: "#374151";
+    readonly quote: "#1D4ED8";
+    readonly quoteBorder: "#2563EB";
+    readonly code: "#92400E";
+    readonly codeBlock: "#F9FAFB";
+    readonly codeBorder: "#92400E";
+    readonly link: "#047857";
+    readonly error: "#DC2626";
+    readonly success: "#047857";
+};
+export declare const theme: {
+    fg: (text: string) => string;
+    assistantText: (text: string) => string;
+    dim: (text: string) => string;
+    accent: (text: string) => string;
+    accentSoft: (text: string) => string;
+    success: (text: string) => string;
+    error: (text: string) => string;
+    header: (text: string) => string;
+    system: (text: string) => string;
+    userBg: (text: string) => string;
+    userText: (text: string) => string;
+    toolTitle: (text: string) => string;
+    toolOutput: (text: string) => string;
+    toolPendingBg: (text: string) => string;
+    toolSuccessBg: (text: string) => string;
+    toolErrorBg: (text: string) => string;
+    border: (text: string) => string;
+    bold: (text: string) => string;
+    italic: (text: string) => string;
+    errorBright: (text: string) => string;
+    warning: (text: string) => string;
+};
+export declare const markdownTheme: MarkdownTheme;
+export declare const selectListTheme: SelectListTheme;
+export declare const editorTheme: EditorTheme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/ui/theme.js

@@ -0,0 +1,154 @@
+import chalk from 'chalk';
+const DARK_TEXT = '#E8E3D5';
+const LIGHT_TEXT = '#1E1E1E';
+const XTERM_LEVELS = [0, 95, 135, 175, 215, 255];
+function channelToSrgb(value) {
+    const normalized = value / 255;
+    return normalized <= 0.03928 ? normalized / 12.92 : ((normalized + 0.055) / 1.055) ** 2.4;
+}
+function relativeLuminanceRgb(r, g, b) {
+    return 0.2126 * channelToSrgb(r) + 0.7152 * channelToSrgb(g) + 0.0722 * channelToSrgb(b);
+}
+function relativeLuminanceHex(hex) {
+    return relativeLuminanceRgb(Number.parseInt(hex.slice(1, 3), 16), Number.parseInt(hex.slice(3, 5), 16), Number.parseInt(hex.slice(5, 7), 16));
+}
+function contrastRatio(background, foregroundHex) {
+    const foreground = relativeLuminanceHex(foregroundHex);
+    const lighter = Math.max(background, foreground);
+    const darker = Math.min(background, foreground);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+function pickHigherContrastText(r, g, b) {
+    const background = relativeLuminanceRgb(r, g, b);
+    return contrastRatio(background, LIGHT_TEXT) >= contrastRatio(background, DARK_TEXT);
+}
+function isLightBackground() {
+    const explicit = process.env.AGENT_THEME;
+    if (explicit === 'light')
+        return true;
+    if (explicit === 'dark')
+        return false;
+    const colorfgbg = process.env.COLORFGBG;
+    if (colorfgbg && colorfgbg.length <= 64) {
+        const sep = colorfgbg.lastIndexOf(';');
+        const bg = Number.parseInt(sep >= 0 ? colorfgbg.slice(sep + 1) : colorfgbg, 10);
+        if (bg >= 0 && bg <= 255) {
+            if (bg <= 15)
+                return bg === 7 || bg === 15;
+            if (bg >= 232)
+                return bg >= 244;
+            const cubeIndex = bg - 16;
+            const bVal = XTERM_LEVELS[cubeIndex % 6];
+            const gVal = XTERM_LEVELS[Math.floor(cubeIndex / 6) % 6];
+            const rVal = XTERM_LEVELS[Math.floor(cubeIndex / 36)];
+            return pickHigherContrastText(rVal, gVal, bVal);
+        }
+    }
+    return false;
+}
+export const lightMode = isLightBackground();
+export const darkPalette = {
+    text: '#E8E3D5',
+    dim: '#7B7F87',
+    accent: '#F6C453',
+    accentSoft: '#F2A65A',
+    border: '#3C414B',
+    userBg: '#2B2F36',
+    userText: '#F3EEE0',
+    systemText: '#9BA3B2',
+    toolPendingBg: '#1F2A2F',
+    toolSuccessBg: '#1E2D23',
+    toolErrorBg: '#2F1F1F',
+    toolTitle: '#F6C453',
+    toolOutput: '#E1DACB',
+    quote: '#8CC8FF',
+    quoteBorder: '#3B4D6B',
+    code: '#F0C987',
+    codeBlock: '#1E232A',
+    codeBorder: '#343A45',
+    link: '#7DD3A5',
+    error: '#F97066',
+    success: '#7DD3A5',
+};
+export const lightPalette = {
+    text: '#1E1E1E',
+    dim: '#5B6472',
+    accent: '#B45309',
+    accentSoft: '#C2410C',
+    border: '#5B6472',
+    userBg: '#F3F0E8',
+    userText: '#1E1E1E',
+    systemText: '#4B5563',
+    toolPendingBg: '#EFF6FF',
+    toolSuccessBg: '#ECFDF5',
+    toolErrorBg: '#FEF2F2',
+    toolTitle: '#B45309',
+    toolOutput: '#374151',
+    quote: '#1D4ED8',
+    quoteBorder: '#2563EB',
+    code: '#92400E',
+    codeBlock: '#F9FAFB',
+    codeBorder: '#92400E',
+    link: '#047857',
+    error: '#DC2626',
+    success: '#047857',
+};
+export const palette = lightMode ? lightPalette : darkPalette;
+const fg = (hex) => (text) => chalk.hex(hex)(text);
+const bg = (hex) => (text) => chalk.bgHex(hex)(text);
+function highlightCode(code) {
+    return code.split('\n').map((line) => fg(palette.code)(line));
+}
+export const theme = {
+    fg: fg(palette.text),
+    assistantText: (text) => text,
+    dim: fg(palette.dim),
+    accent: fg(palette.accent),
+    accentSoft: fg(palette.accentSoft),
+    success: fg(palette.success),
+    error: fg(palette.error),
+    header: (text) => chalk.bold(fg(palette.accent)(text)),
+    system: fg(palette.systemText),
+    userBg: bg(palette.userBg),
+    userText: fg(palette.userText),
+    toolTitle: fg(palette.toolTitle),
+    toolOutput: fg(palette.toolOutput),
+    toolPendingBg: bg(palette.toolPendingBg),
+    toolSuccessBg: bg(palette.toolSuccessBg),
+    toolErrorBg: bg(palette.toolErrorBg),
+    border: fg(palette.border),
+    bold: (text) => chalk.bold(text),
+    italic: (text) => chalk.italic(text),
+    errorBright: fg(palette.error),
+    warning: fg(palette.accentSoft),
+};
+export const markdownTheme = {
+    heading: (text) => chalk.bold(fg(palette.accent)(text)),
+    link: (text) => fg(palette.link)(text),
+    linkUrl: (text) => chalk.dim(text),
+    code: (text) => fg(palette.code)(text),
+    codeBlock: (text) => fg(palette.code)(text),
+    codeBlockBorder: (text) => fg(palette.codeBorder)(text),
+    quote: (text) => fg(palette.quote)(text),
+    quoteBorder: (text) => fg(palette.quoteBorder)(text),
+    hr: (text) => fg(palette.border)(text),
+    listBullet: (text) => fg(palette.accentSoft)(text),
+    bold: (text) => chalk.bold(text),
+    italic: (text) => chalk.italic(text),
+    strikethrough: (text) => chalk.strikethrough(text),
+    underline: (text) => chalk.underline(text),
+    highlightCode,
+};
+const baseSelectListTheme = {
+    selectedPrefix: (text) => fg(palette.accent)(text),
+    selectedText: (text) => chalk.bold(fg(palette.accent)(text)),
+    description: (text) => fg(palette.dim)(text),
+    scrollInfo: (text) => fg(palette.dim)(text),
+    noMatch: (text) => fg(palette.dim)(text),
+};
+export const selectListTheme = baseSelectListTheme;
+export const editorTheme = {
+    borderColor: (text) => fg(palette.border)(text),
+    selectList: selectListTheme,
+};
+//# sourceMappingURL=theme.js.map

package/dist/ui/tool-display.d.ts

@@ -0,0 +1,13 @@
+type ToolDisplay = {
+    name: string;
+    emoji: string;
+    label: string;
+    detail?: string;
+};
+export declare function resolveToolDisplay(params: {
+    name?: string;
+    args?: unknown;
+}): ToolDisplay;
+export declare function formatToolSummary(display: ToolDisplay): string;
+export {};
+//# sourceMappingURL=tool-display.d.ts.map

package/dist/ui/tool-display.js

@@ -0,0 +1,85 @@
+const TOOL_DISPLAY = {
+    read: { emoji: '\u{1F4D6}', label: 'Read', detailKeys: ['path', 'file_path'] },
+    write: { emoji: '\u270D\uFE0F', label: 'Write', detailKeys: ['path', 'file_path'] },
+    edit: { emoji: '\u{1F4DD}', label: 'Edit', detailKeys: ['path', 'file_path'] },
+    multi_edit: { emoji: '\u{1F4DD}\u2702\uFE0F', label: 'Multi-Edit', detailKeys: ['pattern'] },
+    bash: { emoji: '\u{1F6E0}\uFE0F', label: 'Bash', detailKeys: ['command'] },
+    glob: { emoji: '\u{1F50D}', label: 'Glob', detailKeys: ['pattern'] },
+    grep: { emoji: '\u{1F50E}', label: 'Grep', detailKeys: ['pattern'] },
+    git: { emoji: '\u{1F418}', label: 'Git', detailKeys: ['action'] },
+    web_search: { emoji: '\u{1F310}', label: 'Web Search', detailKeys: ['query'] },
+    web_fetch: { emoji: '\u{1F4C4}', label: 'Web Fetch', detailKeys: ['url'] },
+    use_skill: { emoji: '\u{1F9E0}', label: 'Use Skill', detailKeys: ['name'] },
+    delegate_to_agent: { emoji: '\u{1F916}', label: 'Delegate', detailKeys: ['task', 'agent_id'] },
+    get_config: { emoji: '\u2699\uFE0F', label: 'Get Config', detailKeys: ['key'] },
+    update_config: { emoji: '\u2699\uFE0F', label: 'Update Config', detailKeys: ['key'] },
+    config_schema: { emoji: '\u{1F4CB}', label: 'Config Schema', detailKeys: [] },
+    reset_config: { emoji: '\u{1F504}', label: 'Reset Config', detailKeys: [] },
+    switch_provider: { emoji: '\u{1F50C}', label: 'Switch Provider', detailKeys: ['provider'] },
+    list_providers: { emoji: '\u{1F4CB}', label: 'List Providers', detailKeys: [] },
+    provider_info: { emoji: '\u2139\uFE0F', label: 'Provider Info', detailKeys: [] },
+    switch_to_auto_route: { emoji: '\u{1F500}', label: 'Auto Route', detailKeys: [] },
+    toggle_tool: { emoji: '\u{1F527}', label: 'Toggle Tool', detailKeys: ['tool'] },
+    list_tools: { emoji: '\u{1F4CB}', label: 'List Tools', detailKeys: [] },
+    toggle_skill: { emoji: '\u{1F527}', label: 'Toggle Skill', detailKeys: ['skill'] },
+    list_skills: { emoji: '\u{1F4CB}', label: 'List Skills', detailKeys: [] },
+    toggle_sub_agent: { emoji: '\u{1F527}', label: 'Toggle Sub Agent', detailKeys: ['agent_id'] },
+    list_sub_agents: { emoji: '\u{1F4CB}', label: 'List Sub Agents', detailKeys: [] },
+    spawn_sub_agent: { emoji: '\u{1F916}', label: 'Spawn Sub Agent', detailKeys: ['task'] },
+    create_sub_agent: { emoji: '\u{1F916}', label: 'Create Sub Agent', detailKeys: ['name'] },
+    interrupt: { emoji: '\u23F8\uFE0F', label: 'Interrupt', detailKeys: [] },
+    session_stats: { emoji: '\u{1F4CA}', label: 'Session Stats', detailKeys: [] },
+    allow_tool: { emoji: '\u2705', label: 'Allow Tool', detailKeys: ['tool'] },
+    disallow_tool: { emoji: '\u274C', label: 'Disallow Tool', detailKeys: ['tool'] },
+    list_allowlist: { emoji: '\u{1F4CB}', label: 'Allowlist', detailKeys: [] },
+    add_task: { emoji: '\u2795', label: 'Add Task', detailKeys: ['name'] },
+    remove_task: { emoji: '\u2796', label: 'Remove Task', detailKeys: ['name'] },
+    list_tasks: { emoji: '\u{1F4CB}', label: 'List Tasks', detailKeys: [] },
+    toggle_task: { emoji: '\u{1F527}', label: 'Toggle Task', detailKeys: ['name'] },
+    companion_mode: { emoji: '\u{1F48C}', label: 'Companion Mode', detailKeys: ['action'] },
+    reset_companion_session: { emoji: '\u{1F4AD}', label: 'Reset Memory', detailKeys: [] },
+};
+const FALLBACK_EMOJI = '\u{1F9E9}';
+function normalizeToolName(name) {
+    return (name ?? 'tool').trim();
+}
+function resolveDetail(args, spec) {
+    if (!args || typeof args !== 'object')
+        return undefined;
+    const record = args;
+    const keys = spec?.detailKeys;
+    if (!keys || keys.length === 0)
+        return undefined;
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value !== 'string')
+            continue;
+        const trimmed = value.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.length > 80)
+            return trimmed.slice(0, 77) + '...';
+        return trimmed;
+    }
+    return undefined;
+}
+export function resolveToolDisplay(params) {
+    const name = normalizeToolName(params.name);
+    const key = name.toLowerCase();
+    const spec = TOOL_DISPLAY[key];
+    return {
+        name,
+        emoji: spec?.emoji ?? FALLBACK_EMOJI,
+        label: spec?.label ?? name,
+        detail: resolveDetail(params.args, spec),
+    };
+}
+export function formatToolSummary(display) {
+    if (display.detail && display.name === 'bash') {
+        return `${display.emoji} ${display.detail}`;
+    }
+    return display.detail
+        ? `${display.emoji} ${display.label}: ${display.detail}`
+        : `${display.emoji} ${display.label}`;
+}
+//# sourceMappingURL=tool-display.js.map

package/dist/ui/tool-execution.d.ts

@@ -0,0 +1,22 @@
+import { Container } from '@earendil-works/pi-tui';
+export declare class ToolExecutionComponent extends Container {
+    private box;
+    private header;
+    private argsLine;
+    private output;
+    private toolName;
+    private args;
+    private result?;
+    private expanded;
+    private isError;
+    private isPartial;
+    constructor(toolName: string, args: unknown);
+    setArgs(args: unknown): void;
+    setExpanded(expanded: boolean): void;
+    setResult(result: string | undefined, opts?: {
+        isError?: boolean;
+    }): void;
+    setPartialResult(result: string | undefined): void;
+    private refresh;
+}
+//# sourceMappingURL=tool-execution.d.ts.map

package/dist/ui/tool-execution.js

@@ -0,0 +1,87 @@
+import { Box, Container, Markdown, Spacer, Text } from '@earendil-works/pi-tui';
+import { markdownTheme, theme } from './theme.js';
+import { resolveToolDisplay, formatToolSummary } from './tool-display.js';
+import { sanitizeRenderableText } from './tui-formatters.js';
+const PREVIEW_LINES = 12;
+function formatArgs(toolName, args) {
+    const display = resolveToolDisplay({ name: toolName, args });
+    const summary = formatToolSummary(display);
+    return sanitizeRenderableText(summary);
+}
+function extractText(result) {
+    if (!result)
+        return '';
+    return sanitizeRenderableText(result);
+}
+export class ToolExecutionComponent extends Container {
+    box;
+    header;
+    argsLine;
+    output;
+    toolName;
+    args;
+    result;
+    expanded = false;
+    isError = false;
+    isPartial = true;
+    constructor(toolName, args) {
+        super();
+        this.toolName = toolName;
+        this.args = args;
+        this.box = new Box(1, 1, (line) => theme.toolPendingBg(line));
+        this.header = new Text('', 0, 0);
+        this.argsLine = new Text('', 0, 0);
+        this.output = new Markdown('', 0, 0, markdownTheme, {
+            color: (line) => theme.toolOutput(line),
+        });
+        this.addChild(new Spacer(1));
+        this.addChild(this.box);
+        this.box.addChild(this.header);
+        this.box.addChild(this.argsLine);
+        this.box.addChild(this.output);
+        this.refresh();
+    }
+    setArgs(args) {
+        this.args = args;
+        this.refresh();
+    }
+    setExpanded(expanded) {
+        this.expanded = expanded;
+        this.refresh();
+    }
+    setResult(result, opts) {
+        this.result = result;
+        this.isPartial = false;
+        this.isError = Boolean(opts?.isError);
+        this.refresh();
+    }
+    setPartialResult(result) {
+        this.result = result;
+        this.isPartial = true;
+        this.refresh();
+    }
+    refresh() {
+        const bg = this.isPartial
+            ? theme.toolPendingBg
+            : this.isError
+                ? theme.toolErrorBg
+                : theme.toolSuccessBg;
+        this.box.setBgFn((line) => bg(line));
+        const display = resolveToolDisplay({ name: this.toolName, args: this.args });
+        const title = `${display.emoji} ${display.label}${this.isPartial ? ' (running)' : ''}`;
+        this.header.setText(theme.toolTitle(theme.bold(title)));
+        const argLine = formatArgs(this.toolName, this.args);
+        this.argsLine.setText(argLine ? theme.dim(argLine) : theme.dim(' '));
+        const raw = extractText(this.result);
+        const text = raw || (this.isPartial ? '\u2026' : '');
+        if (!this.expanded && text) {
+            const lines = text.split('\n');
+            const preview = lines.length > PREVIEW_LINES ? `${lines.slice(0, PREVIEW_LINES).join('\n')}\n\u2026` : text;
+            this.output.setText(preview);
+        }
+        else {
+            this.output.setText(text);
+        }
+    }
+}
+//# sourceMappingURL=tool-execution.js.map

package/dist/ui/tui-formatters.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeRenderableText(text: string): string;
+//# sourceMappingURL=tui-formatters.d.ts.map