@tulex-cli/tulex-code 0.1.1

package/dist/src/ui/components/Help.js

@@ -0,0 +1,236 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { Box, Text } from 'ink';
+import { theme } from '../semantic-colors.js';
+import {} from '../commands/types.js';
+import { t } from '../../i18n/index.js';
+import { formatSupportedModes, getCommandDisplayName, getCommandSourceBadge, getCommandSourceGroup, getCommandSubcommandNames, } from '../../services/commandMetadata.js';
+import { useKeypress } from '../hooks/useKeypress.js';
+const DEFAULT_WIDTH = 100;
+const KEY_COL_WIDTH = 20;
+const COMMAND_LIST_VISIBLE_LINES = 18;
+const TAB_DEFS = [
+    { tab: 'general', labelKey: 'general' },
+    { tab: 'commands', labelKey: 'commands' },
+    { tab: 'custom-commands', labelKey: 'custom-commands' },
+];
+const DOCS_URL = 'https://qwenlm.github.io/qwen-code-docs/';
+export const Help = ({ commands, width = DEFAULT_WIDTH, activeTab = 'general', onTabChange, onClose, isInteractive = false, }) => {
+    const safeWidth = Math.max(72, width);
+    const bodyWidth = safeWidth - 6;
+    const handleTabChange = useCallback((direction) => {
+        const currentIndex = TAB_DEFS.findIndex((tab) => tab.tab === activeTab);
+        const nextIndex = (currentIndex + direction + TAB_DEFS.length) % TAB_DEFS.length;
+        onTabChange?.(TAB_DEFS[nextIndex].tab);
+    }, [activeTab, onTabChange]);
+    useKeypress((key) => {
+        if (key.name === 'escape') {
+            onClose?.();
+            return;
+        }
+        if (key.name === 'tab') {
+            handleTabChange(key.shift ? -1 : 1);
+        }
+    }, { isActive: isInteractive });
+    return (_jsx(Box, { flexDirection: "column", width: safeWidth, children: _jsx(Box, { borderColor: theme.border.default, borderStyle: "single", width: safeWidth, children: _jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, width: safeWidth - 2, children: [_jsx(HelpTabs, { activeTab: activeTab }), _jsxs(Box, { marginTop: 1, children: [activeTab === 'general' && _jsx(GeneralHelp, { width: bodyWidth }), activeTab === 'commands' && (_jsx(CommandsHelp, { commands: commands, width: bodyWidth, customOnly: false, isInteractive: isInteractive })), activeTab === 'custom-commands' && (_jsx(CommandsHelp, { commands: commands, width: bodyWidth, customOnly: true, isInteractive: isInteractive }))] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.text.secondary, children: [t('For more help:'), " ", _jsx(Text, { underline: true, children: DOCS_URL })] }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { italic: true, color: theme.text.secondary, children: t('Tab/Shift+Tab to switch tabs  ·  Esc to cancel') }) })] }) }) }));
+};
+const HelpTabs = ({ activeTab }) => (_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { bold: true, color: theme.text.accent, children: "Qwen Code" }), _jsx(Text, { color: theme.text.secondary, children: " " }), TAB_DEFS.map(({ tab, labelKey }) => {
+            const active = tab === activeTab;
+            return (_jsx(Box, { marginLeft: 1, children: _jsx(Text, { color: active ? theme.background.primary : theme.text.primary, backgroundColor: active ? theme.text.accent : undefined, children: ` ${t(labelKey)} ` }) }, tab));
+        })] }));
+const GeneralHelp = ({ width }) => {
+    const shortcuts = [
+        ['@', t('Add files or folders as context')],
+        ['!', t('Run shell commands')],
+        ['/', t('Open command menu')],
+        ['Tab', t('Accept ghost text or completion')],
+        ['Esc Esc', t('Clear input or cancel operation')],
+        ['Ctrl+L', t('Clear the screen')],
+        [
+            process.platform === 'win32' ? 'Ctrl+Enter' : 'Ctrl+J',
+            t('Insert a newline'),
+        ],
+        [
+            process.platform === 'win32' ? 'Tab' : 'Shift+Tab',
+            t('Cycle approval modes'),
+        ],
+        ['Alt+←/→', t('Jump through words')],
+        ['↑/↓', t('Cycle prompt history')],
+    ];
+    const left = shortcuts.slice(0, Math.ceil(shortcuts.length / 2));
+    const right = shortcuts.slice(Math.ceil(shortcuts.length / 2));
+    const colWidth = Math.floor((width - 2) / 2);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: theme.text.primary, children: t('Qwen Code understands your codebase, makes edits with your permission, and executes commands right from your terminal.') }) }), _jsx(Text, { bold: true, color: theme.text.primary, children: t('Shortcuts') }), _jsxs(Box, { flexDirection: "row", gap: 2, children: [_jsx(Box, { flexDirection: "column", width: colWidth, children: left.map(([key, desc]) => (_jsx(ShortcutRow, { shortcutKey: key, desc: desc, width: colWidth }, key))) }), _jsx(Box, { flexDirection: "column", width: colWidth, children: right.map(([key, desc]) => (_jsx(ShortcutRow, { shortcutKey: key, desc: desc, width: colWidth }, key))) })] })] }));
+};
+const ShortcutRow = ({ shortcutKey, desc, width }) => (_jsxs(Box, { flexDirection: "row", width: width, children: [_jsx(Box, { width: KEY_COL_WIDTH, flexShrink: 0, children: _jsx(Text, { color: theme.text.accent, children: shortcutKey }) }), _jsx(Text, { color: theme.text.primary, wrap: "truncate", children: truncateText(desc, width - KEY_COL_WIDTH - 1) })] }));
+const CommandsHelp = ({ commands, width, customOnly, isInteractive }) => {
+    const groups = useMemo(() => groupCommands(commands, customOnly), [commands, customOnly]);
+    const lines = useMemo(() => renderCommandLines(groups, width), [groups, width]);
+    const maxScroll = Math.max(0, lines.length - COMMAND_LIST_VISIBLE_LINES);
+    const [scrollOffset, setScrollOffset] = useState(0);
+    useEffect(() => {
+        setScrollOffset(0);
+    }, [customOnly, commands]);
+    useEffect(() => {
+        setScrollOffset((offset) => Math.min(offset, maxScroll));
+    }, [maxScroll]);
+    useKeypress((key) => {
+        if (key.name === 'up') {
+            setScrollOffset((offset) => Math.max(0, offset - 1));
+        }
+        else if (key.name === 'down') {
+            setScrollOffset((offset) => Math.min(maxScroll, offset + 1));
+        }
+        else if (key.name === 'pageup') {
+            setScrollOffset((offset) => Math.max(0, offset - COMMAND_LIST_VISIBLE_LINES));
+        }
+        else if (key.name === 'pagedown') {
+            setScrollOffset((offset) => Math.min(maxScroll, offset + COMMAND_LIST_VISIBLE_LINES));
+        }
+    }, { isActive: isInteractive });
+    if (groups.length === 0) {
+        return (_jsx(Text, { color: theme.text.secondary, children: customOnly
+                ? t('No custom commands are currently available.')
+                : t('No commands are currently available.') }));
+    }
+    const visibleLines = lines.slice(scrollOffset, scrollOffset + COMMAND_LIST_VISIBLE_LINES);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: theme.text.primary, children: customOnly
+                        ? t('Browse custom, skill, plugin, and MCP commands:')
+                        : t('Browse built-in commands:') }) }), _jsx(Box, { flexDirection: "column", height: COMMAND_LIST_VISIBLE_LINES, children: visibleLines.map((line, index) => {
+                    const stableKey = line.type === 'blank'
+                        ? `blank:${index}`
+                        : `${line.type}:${line.text}:${index}`;
+                    return _jsx(CommandLine, { line: line }, stableKey);
+                }) }), maxScroll > 0 &&
+                (() => {
+                    const totalCommands = lines.filter((l) => l.type === 'signature').length;
+                    const visibleSignatures = visibleLines.filter((l) => l.type === 'signature');
+                    const firstCmd = visibleSignatures.length > 0
+                        ? visibleSignatures[0].commandIndex + 1
+                        : 0;
+                    const lastCmd = visibleSignatures.length > 0
+                        ? visibleSignatures[visibleSignatures.length - 1].commandIndex + 1
+                        : 0;
+                    const range = firstCmd === lastCmd ? `${firstCmd}` : `${firstCmd}-${lastCmd}`;
+                    return (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: theme.text.secondary, children: [t('Use ↑/↓ to scroll'), " ", `(${range}/${totalCommands})`] }) }));
+                })()] }));
+};
+const CommandLine = ({ line }) => {
+    switch (line.type) {
+        case 'group':
+            return (_jsxs(Text, { bold: true, color: theme.text.primary, children: [line.text, ' ', _jsx(Text, { color: theme.text.secondary, children: `(${line.count})` })] }));
+        case 'signature':
+            return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: theme.text.accent, children: [" ", line.text] }), line.meta && _jsxs(Text, { color: theme.text.secondary, children: [" ", line.meta] })] }));
+        case 'description':
+            return (_jsx(Box, { paddingLeft: 4, children: _jsx(Text, { color: theme.text.primary, wrap: "truncate", children: line.text }) }));
+        case 'subcommands':
+            return (_jsx(Box, { paddingLeft: 4, children: _jsx(Text, { color: theme.text.secondary, wrap: "truncate", children: line.text }) }));
+        case 'blank':
+            return _jsx(Text, { children: " " });
+        default:
+            return null;
+    }
+};
+function renderCommandLines(groups, width) {
+    const lines = [];
+    let commandIndex = 0;
+    groups.forEach((group, groupIndex) => {
+        lines.push({
+            type: 'group',
+            text: group.title,
+            count: group.commands.length,
+        });
+        group.commands.forEach((cmd) => {
+            const sigLine = getCommandSignatureLine(cmd, width);
+            lines.push({ ...sigLine, commandIndex: commandIndex++ });
+            const descriptionLine = getCommandDescriptionLine(cmd, width);
+            if (descriptionLine) {
+                lines.push(descriptionLine);
+            }
+            const subcommandsLine = getCommandSubcommandsLine(cmd, width);
+            if (subcommandsLine) {
+                lines.push(subcommandsLine);
+            }
+        });
+        if (groupIndex < groups.length - 1) {
+            lines.push({ type: 'blank' });
+        }
+    });
+    return lines;
+}
+function getCommandSignatureLine(command, width) {
+    const badge = getCommandSourceBadge(command);
+    const name = getCommandDisplayName(command, {
+        prefix: '/',
+        includeAliases: false,
+    });
+    const signature = [name, command.argumentHint].filter(Boolean).join(' ');
+    const meta = [
+        badge,
+        formatSupportedModes(command),
+        command.modelInvocable ? '[model]' : undefined,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    return {
+        type: 'signature',
+        text: truncateText(signature, Math.floor(width * 0.42)),
+        meta,
+        commandIndex: -1, // assigned by renderCommandLines
+    };
+}
+function getCommandDescriptionLine(command, width) {
+    if (!command.description) {
+        return null;
+    }
+    return {
+        type: 'description',
+        text: truncateText(command.description, Math.max(20, width - 4)),
+    };
+}
+function getCommandSubcommandsLine(command, width) {
+    const subcommands = getCommandSubcommandNames(command);
+    if (subcommands.length === 0) {
+        return null;
+    }
+    const descWidth = Math.max(20, width - 4);
+    return {
+        type: 'subcommands',
+        text: `${t('subcommands:')} ${truncateText(subcommands.join(', '), descWidth - 13)}`,
+    };
+}
+function groupCommands(commands, customOnly) {
+    const groups = new Map();
+    commands
+        .filter((cmd) => cmd.description && !cmd.hidden)
+        .forEach((cmd) => {
+        const group = getCommandSourceGroup(cmd);
+        if (customOnly ? group.key === 'built-in' : group.key !== 'built-in') {
+            return;
+        }
+        const existing = groups.get(group.key);
+        if (existing) {
+            existing.commands.push(cmd);
+        }
+        else {
+            groups.set(group.key, {
+                key: group.key,
+                title: group.title,
+                order: group.order,
+                commands: [cmd],
+            });
+        }
+    });
+    return Array.from(groups.values())
+        .sort((a, b) => a.order - b.order)
+        .map((group) => ({
+        ...group,
+        commands: group.commands.sort((a, b) => a.name.localeCompare(b.name)),
+    }));
+}
+function truncateText(text, maxLength) {
+    if (maxLength <= 1 || text.length <= maxLength)
+        return text;
+    return `${text.slice(0, maxLength - 1)}…`;
+}
+//# sourceMappingURL=Help.js.map

package/dist/src/ui/components/Help.js.map

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

package/dist/src/ui/components/Help.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/components/Help.test.js

@@ -0,0 +1,243 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/** @vitest-environment jsdom */
+import React, { act } from 'react';
+import { render } from 'ink-testing-library';
+import { describe, it, expect, vi } from 'vitest';
+import { Help } from './Help.js';
+import { CommandKind } from '../commands/types.js';
+const mockCommands = [
+    {
+        name: 'test',
+        description: 'A test command',
+        kind: CommandKind.BUILT_IN,
+        source: 'builtin-command',
+        sourceLabel: 'Built-in',
+        supportedModes: ['interactive'],
+        argumentHint: '[value]',
+        altNames: ['alias-one', 'alias-two'],
+    },
+    {
+        name: 'review',
+        description: 'Review changed code',
+        kind: CommandKind.SKILL,
+        source: 'bundled-skill',
+        sourceLabel: 'Skill',
+        supportedModes: ['interactive', 'non_interactive', 'acp'],
+        argumentHint: '[pr-number]',
+        modelInvocable: true,
+    },
+    {
+        name: 'custom',
+        description: 'A custom command',
+        kind: CommandKind.FILE,
+        source: 'skill-dir-command',
+        sourceLabel: 'Custom',
+        sourceDetail: 'custom',
+    },
+    {
+        name: 'plugin-cmd',
+        description: 'A plugin command',
+        kind: CommandKind.FILE,
+        source: 'plugin-command',
+        sourceLabel: 'Plugin: demo',
+    },
+    {
+        name: 'mcp-prompt',
+        description: 'An MCP prompt',
+        kind: CommandKind.MCP_PROMPT,
+        source: 'mcp-prompt',
+        sourceLabel: 'MCP: demo',
+    },
+    {
+        name: 'hidden',
+        description: 'A hidden command',
+        hidden: true,
+        kind: CommandKind.BUILT_IN,
+        source: 'builtin-command',
+    },
+    {
+        name: 'parent',
+        description: 'A parent command',
+        kind: CommandKind.BUILT_IN,
+        source: 'builtin-command',
+        sourceLabel: 'Built-in',
+        subCommands: [
+            {
+                name: 'visible-child',
+                description: 'A visible child command',
+                kind: CommandKind.BUILT_IN,
+            },
+            {
+                name: 'hidden-child',
+                description: 'A hidden child command',
+                hidden: true,
+                kind: CommandKind.BUILT_IN,
+            },
+        ],
+    },
+];
+const keypressSubscribers = new Set();
+vi.mock('../contexts/KeypressContext.js', () => ({
+    useKeypressContext: () => ({
+        subscribe: (handler) => {
+            keypressSubscribers.add(handler);
+        },
+        unsubscribe: (handler) => {
+            keypressSubscribers.delete(handler);
+        },
+    }),
+}));
+function sendKey(key) {
+    act(() => {
+        for (const handler of keypressSubscribers) {
+            handler(key);
+        }
+    });
+}
+const InteractiveHelpHarness = ({ onClose, commands = mockCommands, initialTab = 'general', }) => {
+    const [tab, setTab] = React.useState(initialTab);
+    return (_jsx(Help, { commands: commands, width: 130, activeTab: tab, onTabChange: setTab, onClose: onClose, isInteractive: true }));
+};
+describe('Help Component', () => {
+    it('renders Claude Code style tabs and the general page by default', () => {
+        const { lastFrame } = render(_jsx(Help, { commands: mockCommands, width: 100 }));
+        const output = lastFrame();
+        expect(output).toContain('Qwen Code');
+        expect(output).toContain('general');
+        expect(output).toContain('commands');
+        expect(output).toContain('custom-commands');
+        expect(output).toContain('Shortcuts');
+        expect(output).toContain('Esc to cancel');
+        expect(output).not.toContain('/help commands');
+    });
+    it('renders built-in commands in the commands tab without custom command clutter', () => {
+        const { lastFrame } = render(_jsx(Help, { commands: mockCommands, width: 110, activeTab: "commands" }));
+        const output = lastFrame();
+        expect(output).toContain('Built-in Commands');
+        expect(output).toContain('/test [value]');
+        expect(output).toContain('[interactive]');
+        expect(output).toContain('/parent');
+        expect(output).toContain('visible-child');
+        expect(output).not.toContain('hidden-child');
+        expect(output).not.toContain('/hidden');
+        expect(output).not.toContain('/custom');
+    });
+    it('renders custom, skill, plugin, and MCP commands in the custom tab', () => {
+        const { lastFrame } = render(_jsx(Help, { commands: mockCommands, width: 130, activeTab: "custom-commands" }));
+        const output = lastFrame();
+        expect(output).toContain('Bundled Skills');
+        expect(output).toContain('Custom Commands');
+        expect(output).toContain('Plugin Commands');
+        expect(output).toContain('MCP Commands');
+        expect(output).toContain('/review [pr-number]');
+        expect(output).toContain('[Skill]');
+        expect(output).toContain('[all]');
+        expect(output).toContain('[model]');
+        expect(output).toContain('/custom');
+        expect(output).toContain('[Custom]');
+        expect(output).toContain('/plugin-cmd');
+        expect(output).toContain('[Plugin]');
+        expect(output).toContain('/mcp-prompt');
+        expect(output).toContain('[MCP]');
+        expect(output).not.toContain('/test');
+    });
+    it('orders help commands alphabetically regardless of completionPriority', () => {
+        // Skill priority is scoped to the /skills listing; /help intentionally
+        // stays alphabetical so a high-priority skill can't push a built-in
+        // command around in the help view.
+        const commands = [
+            {
+                name: 'alpha',
+                description: 'Default priority skill',
+                kind: CommandKind.SKILL,
+                source: 'bundled-skill',
+                sourceLabel: 'Skill',
+            },
+            {
+                name: 'zeta',
+                description: 'High priority skill',
+                kind: CommandKind.SKILL,
+                source: 'bundled-skill',
+                sourceLabel: 'Skill',
+                completionPriority: 100,
+            },
+            {
+                name: 'beta',
+                description: 'Default priority skill',
+                kind: CommandKind.SKILL,
+                source: 'bundled-skill',
+                sourceLabel: 'Skill',
+            },
+        ];
+        const { lastFrame } = render(_jsx(Help, { commands: commands, width: 130, activeTab: "custom-commands" }));
+        const output = lastFrame() ?? '';
+        expect(output.indexOf('/alpha')).toBeLessThan(output.indexOf('/beta'));
+        expect(output.indexOf('/beta')).toBeLessThan(output.indexOf('/zeta'));
+    });
+    it('switches tabs with Tab and Shift+Tab when interactive', () => {
+        const onClose = vi.fn();
+        const { lastFrame } = render(_jsx(InteractiveHelpHarness, { onClose: onClose }));
+        expect(lastFrame()).toContain('Shortcuts');
+        sendKey({ name: 'tab' });
+        expect(lastFrame()).toContain('Built-in Commands');
+        sendKey({ name: 'tab' });
+        expect(lastFrame()).toContain('Custom Commands');
+        sendKey({ name: 'tab', shift: true });
+        expect(lastFrame()).toContain('Built-in Commands');
+    });
+    it('scrolls long command lists with the up and down keys', () => {
+        const manyCommands = Array.from({ length: 12 }, (_, index) => ({
+            name: `cmd-${String(index).padStart(2, '0')}`,
+            description: `Command ${index} description`,
+            kind: CommandKind.BUILT_IN,
+            source: 'builtin-command',
+            sourceLabel: 'Built-in',
+        }));
+        const { lastFrame } = render(_jsx(InteractiveHelpHarness, { onClose: vi.fn(), commands: manyCommands, initialTab: "commands" }));
+        expect(lastFrame()).toContain('/cmd-00');
+        expect(lastFrame()).not.toContain('/cmd-11');
+        expect(lastFrame()).toContain('Use ↑/↓ to scroll');
+        sendKey({ name: 'down' });
+        sendKey({ name: 'down' });
+        expect(lastFrame()).not.toContain('/cmd-00');
+        sendKey({ name: 'pagedown' });
+        expect(lastFrame()).toContain('/cmd-11');
+        sendKey({ name: 'pageup' });
+        expect(lastFrame()).toContain('/cmd-00');
+    });
+    it('resets scroll position when switching command tabs', () => {
+        const mixedCommands = [
+            ...Array.from({ length: 12 }, (_, index) => ({
+                name: `builtin-${String(index).padStart(2, '0')}`,
+                description: `Built-in ${index} description`,
+                kind: CommandKind.BUILT_IN,
+                source: 'builtin-command',
+                sourceLabel: 'Built-in',
+            })),
+            ...Array.from({ length: 12 }, (_, index) => ({
+                name: `skill-${String(index).padStart(2, '0')}`,
+                description: `Skill ${index} description`,
+                kind: CommandKind.SKILL,
+                source: 'bundled-skill',
+                sourceLabel: 'Skill',
+            })),
+        ];
+        const { lastFrame } = render(_jsx(InteractiveHelpHarness, { onClose: vi.fn(), commands: mixedCommands, initialTab: "commands" }));
+        sendKey({ name: 'pagedown' });
+        expect(lastFrame()).not.toContain('/builtin-00');
+        sendKey({ name: 'tab' });
+        expect(lastFrame()).toContain('/skill-00');
+    });
+    it('closes with Escape when interactive', () => {
+        const onClose = vi.fn();
+        render(_jsx(InteractiveHelpHarness, { onClose: onClose }));
+        sendKey({ name: 'escape' });
+        expect(onClose).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=Help.test.js.map

package/dist/src/ui/components/Help.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Help.test.js","sourceRoot":"","sources":["../../../../src/ui/components/Help.test.tsx"],"names":[],"mappings":"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"}

package/dist/src/ui/components/HistoryItemDisplay.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type React from 'react';
+import type { HistoryItem } from '../types.js';
+import { type MarkdownSourceCopyIndexOffsets } from '../utils/MarkdownDisplay.js';
+import type { SlashCommand } from '../commands/types.js';
+interface HistoryItemDisplayProps {
+    item: HistoryItem;
+    availableTerminalHeight?: number;
+    terminalWidth: number;
+    mainAreaWidth?: number;
+    isPending: boolean;
+    isFocused?: boolean;
+    commands?: readonly SlashCommand[];
+    activeShellPtyId?: number | null;
+    embeddedShellFocused?: boolean;
+    availableTerminalHeightGemini?: number;
+    /**
+     * When the item is a `tool_group`, an optional short LLM-generated label
+     * summarizing the batch. Replaces the generic "Tool × N" line in compact
+     * mode. Computed by the parent from `tool_use_summary` history items.
+     */
+    compactLabel?: string;
+    /**
+     * When the item is a `tool_use_summary`, true if a sibling tool_group has
+     * absorbed this label via its compact-mode header. The standalone `● <label>`
+     * line is suppressed in that case. False for force-expanded groups in
+     * compact mode (they render through the full ToolGroupMessage path and
+     * don't consume compactLabel, so the standalone line is the label's only
+     * path to the screen) and for all tool_use_summary items in full mode.
+     */
+    summaryAbsorbed?: boolean;
+    sourceCopyIndexOffsets?: MarkdownSourceCopyIndexOffsets;
+}
+declare const HistoryItemDisplayComponent: React.FC<HistoryItemDisplayProps>;
+export { HistoryItemDisplayComponent as HistoryItemDisplay };

package/dist/src/ui/components/HistoryItemDisplay.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { escapeAnsiCtrlCodes, sanitizeSensitiveText, } from '../utils/textUtils.js';
+import { UserMessage, UserShellMessage, AssistantMessage, AssistantMessageContent, ThinkMessage, ThinkMessageContent, } from './messages/ConversationMessages.js';
+import { ToolGroupMessage } from './messages/ToolGroupMessage.js';
+import { CompressionMessage } from './messages/CompressionMessage.js';
+import { SummaryMessage } from './messages/SummaryMessage.js';
+import { InfoMessage, WarningMessage, ErrorMessage, RetryCountdownMessage, SuccessMessage, AwayRecapMessage, } from './messages/StatusMessages.js';
+import { Box, Text } from 'ink';
+import { theme } from '../semantic-colors.js';
+import { MarkdownDisplay, } from '../utils/MarkdownDisplay.js';
+import { AboutBox } from './AboutBox.js';
+import { StatsDisplay } from './StatsDisplay.js';
+import { ModelStatsDisplay } from './ModelStatsDisplay.js';
+import { ToolStatsDisplay } from './ToolStatsDisplay.js';
+import { SessionSummaryDisplay } from './SessionSummaryDisplay.js';
+import { Help } from './Help.js';
+import { ExtensionsList } from './views/ExtensionsList.js';
+import { getMCPServerStatus } from '@tulex-cli/tulex-cli-core';
+import { SkillsList } from './views/SkillsList.js';
+import { ToolsList } from './views/ToolsList.js';
+import { McpStatus } from './views/McpStatus.js';
+import { ContextUsage } from './views/ContextUsage.js';
+import { DoctorReport } from './views/DoctorReport.js';
+import { ArenaAgentCard, ArenaSessionCard } from './arena/ArenaCards.js';
+import { InsightProgressMessage } from './messages/InsightProgressMessage.js';
+import { BtwMessage } from './messages/BtwMessage.js';
+import { MemorySavedMessage } from './messages/MemorySavedMessage.js';
+import { DiffStatsDisplay } from './messages/DiffStatsDisplay.js';
+import { GoalStatusMessage } from './messages/GoalStatusMessage.js';
+import { useCompactMode } from '../contexts/CompactModeContext.js';
+const HistoryItemDisplayComponent = ({ item, availableTerminalHeight, terminalWidth, mainAreaWidth, isPending, commands, isFocused = true, activeShellPtyId, embeddedShellFocused, availableTerminalHeightGemini, compactLabel, summaryAbsorbed = false, sourceCopyIndexOffsets, }) => {
+    const { compactMode } = useCompactMode();
+    const isHiddenInCompact = compactMode &&
+        (item.type === 'gemini_thought' ||
+            item.type === 'gemini_thought_content' ||
+            (item.type === 'tool_use_summary' && summaryAbsorbed));
+    const itemForDisplay = useMemo(() => escapeAnsiCtrlCodes(item), [item]);
+    const contentWidth = terminalWidth - 4;
+    const boxWidth = mainAreaWidth || contentWidth;
+    if (isHiddenInCompact)
+        return null;
+    const marginTop = item.type === 'gemini_content' || item.type === 'gemini_thought_content'
+        ? 0
+        : 1;
+    return (_jsxs(Box, { flexDirection: "column", marginTop: marginTop, marginLeft: 2, marginRight: 2, children: [itemForDisplay.type === 'user' && (_jsx(UserMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'notification' && (_jsx(InfoMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'user_shell' && (_jsx(UserShellMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'gemini' && (_jsx(AssistantMessage, { text: itemForDisplay.text, isPending: isPending, availableTerminalHeight: availableTerminalHeightGemini ?? availableTerminalHeight, contentWidth: contentWidth, sourceCopyIndexOffsets: sourceCopyIndexOffsets })), itemForDisplay.type === 'gemini_content' && (_jsx(AssistantMessageContent, { text: itemForDisplay.text, isPending: isPending, availableTerminalHeight: availableTerminalHeightGemini ?? availableTerminalHeight, contentWidth: contentWidth, sourceCopyIndexOffsets: sourceCopyIndexOffsets })), itemForDisplay.type === 'gemini_thought' && (_jsx(ThinkMessage, { text: itemForDisplay.text, isPending: isPending, availableTerminalHeight: availableTerminalHeightGemini ?? availableTerminalHeight, contentWidth: contentWidth })), itemForDisplay.type === 'gemini_thought_content' && (_jsx(ThinkMessageContent, { text: itemForDisplay.text, isPending: isPending, availableTerminalHeight: availableTerminalHeightGemini ?? availableTerminalHeight, contentWidth: contentWidth })), itemForDisplay.type === 'info' && (_jsx(InfoMessage, { text: itemForDisplay.text, linkUrl: itemForDisplay.linkUrl, linkText: itemForDisplay.linkText })), itemForDisplay.type === 'success' && (_jsx(SuccessMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'warning' && (_jsx(WarningMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'error' && (_jsx(ErrorMessage, { text: itemForDisplay.text, hint: itemForDisplay.hint })), itemForDisplay.type === 'retry_countdown' && (_jsx(RetryCountdownMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'about' && (_jsx(AboutBox, { ...itemForDisplay.systemInfo, width: boxWidth })), itemForDisplay.type === 'help' && commands && (_jsx(Help, { commands: commands, width: boxWidth })), itemForDisplay.type === 'stats' && (_jsx(StatsDisplay, { duration: itemForDisplay.duration, width: boxWidth })), itemForDisplay.type === 'diff_stats' && (_jsx(DiffStatsDisplay, { model: itemForDisplay.model })), itemForDisplay.type === 'model_stats' && (_jsx(ModelStatsDisplay, { width: boxWidth })), itemForDisplay.type === 'tool_stats' && (_jsx(ToolStatsDisplay, { width: boxWidth })), itemForDisplay.type === 'quit' && (_jsx(SessionSummaryDisplay, { duration: itemForDisplay.duration, width: boxWidth })), itemForDisplay.type === 'tool_group' && (_jsx(ToolGroupMessage, { toolCalls: itemForDisplay.tools, groupId: itemForDisplay.id, availableTerminalHeight: availableTerminalHeight, contentWidth: contentWidth, isFocused: isFocused, isPending: isPending, activeShellPtyId: activeShellPtyId, embeddedShellFocused: embeddedShellFocused, memoryWriteCount: itemForDisplay.memoryWriteCount, memoryReadCount: itemForDisplay.memoryReadCount, isUserInitiated: itemForDisplay.isUserInitiated, compactLabel: compactLabel })), itemForDisplay.type === 'tool_use_summary' &&
+                (!compactMode || !summaryAbsorbed) && (_jsx(Box, { paddingLeft: 1, children: _jsxs(Text, { dimColor: true, children: ["\u25CF ", itemForDisplay.summary] }) })), itemForDisplay.type === 'compression' && (_jsx(CompressionMessage, { compression: itemForDisplay.compression })), itemForDisplay.type === 'summary' && (_jsx(SummaryMessage, { summary: itemForDisplay.summary })), itemForDisplay.type === 'extensions_list' && _jsx(ExtensionsList, {}), itemForDisplay.type === 'tools_list' && (_jsx(ToolsList, { contentWidth: contentWidth, tools: itemForDisplay.tools, showDescriptions: itemForDisplay.showDescriptions })), itemForDisplay.type === 'skills_list' && (_jsx(SkillsList, { skills: itemForDisplay.skills })), itemForDisplay.type === 'mcp_status' && (_jsx(McpStatus, { ...itemForDisplay, serverStatus: getMCPServerStatus })), itemForDisplay.type === 'context_usage' && (_jsx(ContextUsage, { modelName: itemForDisplay.modelName, totalTokens: itemForDisplay.totalTokens, contextWindowSize: itemForDisplay.contextWindowSize, breakdown: itemForDisplay.breakdown, builtinTools: itemForDisplay.builtinTools, mcpTools: itemForDisplay.mcpTools, memoryFiles: itemForDisplay.memoryFiles, skills: itemForDisplay.skills, isEstimated: itemForDisplay.isEstimated, showDetails: itemForDisplay.showDetails })), itemForDisplay.type === 'doctor' && (_jsx(DoctorReport, { checks: itemForDisplay.checks, summary: itemForDisplay.summary, width: boxWidth })), itemForDisplay.type === 'arena_agent_complete' && (_jsx(ArenaAgentCard, { agent: itemForDisplay.agent, width: boxWidth })), itemForDisplay.type === 'arena_session_complete' && (_jsx(ArenaSessionCard, { sessionStatus: itemForDisplay.sessionStatus, task: itemForDisplay.task, totalDurationMs: itemForDisplay.totalDurationMs, agents: itemForDisplay.agents, width: boxWidth })), itemForDisplay.type === 'insight_progress' && (_jsx(InsightProgressMessage, { progress: itemForDisplay.progress })), itemForDisplay.type === 'btw' && itemForDisplay.btw && (_jsx(BtwMessage, { btw: itemForDisplay.btw, containerWidth: contentWidth })), itemForDisplay.type === 'user_prompt_submit_blocked' && (_jsx(Box, { flexDirection: "column", children: _jsx(Text, { color: theme.status.warning, children: `✕ UserPromptSubmit operation blocked by hook:\n${itemForDisplay.reason}\n\nOriginal prompt: ${sanitizeSensitiveText(itemForDisplay.originalPrompt)}` }) })), itemForDisplay.type === 'stop_hook_loop' && (_jsx(InfoMessage, { text: `Ran ${itemForDisplay.stopHookCount} stop hooks\n  ⎿  Stop hook error: ${itemForDisplay.reasons[itemForDisplay.reasons.length - 1]}` })), itemForDisplay.type === 'stop_hook_system_message' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.text.primary, children: " \u23BF Stop says:" }), _jsx(Box, { marginLeft: 4, flexDirection: "column", children: _jsx(MarkdownDisplay, { text: itemForDisplay.message, isPending: false, contentWidth: contentWidth - 4 }) })] })), itemForDisplay.type === 'memory_saved' && (_jsx(MemorySavedMessage, { item: itemForDisplay })), itemForDisplay.type === 'away_recap' && (_jsx(AwayRecapMessage, { text: itemForDisplay.text })), itemForDisplay.type === 'goal_status' && (_jsx(GoalStatusMessage, { kind: itemForDisplay.kind, condition: itemForDisplay.condition, iterations: itemForDisplay.iterations, durationMs: itemForDisplay.durationMs, lastReason: itemForDisplay.lastReason }))] }, itemForDisplay.id));
+};
+// Export alias for backward compatibility
+export { HistoryItemDisplayComponent as HistoryItemDisplay };
+//# sourceMappingURL=HistoryItemDisplay.js.map