@hunterzhu/pulse-cli 0.1.4 → 0.1.5

package/dist/hooks/useSlashCommands.js

@@ -0,0 +1,44 @@
+import { useMemo, useCallback } from 'react';
+export function useSlashCommands(deps) {
+    const commands = useMemo(() => [
+        { name: '/help', aliases: ['/h'], description: '显示帮助信息', execute: async () => deps.onHelp?.() },
+        { name: '/status', description: '查看状态', execute: async () => deps.onStatus?.() },
+        { name: '/tools', description: '列出可用工具', execute: async () => deps.onTools?.() },
+        { name: '/artifacts', description: '查看当前产物', execute: async () => deps.onArtifacts?.() },
+        { name: '/exit', description: '退出程序', execute: async () => deps.onExit?.() },
+        { name: '/quit', aliases: ['/q'], description: '退出程序', execute: async () => deps.onQuit?.() },
+        { name: '/new', description: '开启新会话', execute: async () => deps.onNew?.() },
+        { name: '/sessions', description: '查看所有会话', execute: async () => deps.onSessions?.() },
+        { name: '/delete', description: '删除会话 [id]', execute: async (args) => deps.onDelete?.(args) },
+        { name: '/export', description: '导出会话 [markdown|json]', execute: async (args) => deps.onExport?.(args) },
+        { name: '/clear', description: '清空当前屏幕', execute: async () => deps.onClear?.() },
+        { name: '/config', description: '查看配置', execute: async () => deps.onConfig?.() },
+        { name: '/model', description: '切换模型 [name]', execute: async (args) => deps.onModel?.(args) },
+        { name: '/compact', description: '调用模型压缩对话历史上下文', execute: async () => deps.onCompact?.() },
+        { name: '/verbose', description: '开启详细输出模式', execute: async () => deps.onVerbose?.() },
+        { name: '/quiet', description: '开启精简输出模式', execute: async () => deps.onQuiet?.() },
+        { name: '/thinking', description: '设置模型思考深度 [low|medium|high|off]', execute: async (args) => deps.onThinking?.(args) },
+    ], [deps]);
+    const isSlashCommand = useCallback((input) => {
+        return input.trim().startsWith('/');
+    }, []);
+    const executeCommand = useCallback(async (input) => {
+        const trimmed = input.trim();
+        if (!trimmed.startsWith('/'))
+            return false;
+        const parts = trimmed.split(' ');
+        const cmdName = parts[0]?.toLowerCase();
+        const args = parts.slice(1).join(' ').trim();
+        const command = commands.find((c) => c.name === cmdName || c.aliases?.includes(cmdName));
+        if (command) {
+            await command.execute(args);
+            return true;
+        }
+        return false;
+    }, [commands]);
+    return {
+        commands,
+        isSlashCommand,
+        executeCommand,
+    };
+}

package/dist/hooks/useTokenStats.d.ts

@@ -0,0 +1,7 @@
+import { TokenStatsData } from '../types.js';
+export declare function useTokenStats(): {
+    current: TokenStatsData | null;
+    cumulative: TokenStatsData;
+    recordRun: (stats: TokenStatsData) => void;
+    reset: () => void;
+};

package/dist/hooks/useTokenStats.js

@@ -0,0 +1,38 @@
+import { useState, useCallback } from 'react';
+export function useTokenStats() {
+    const [current, setCurrent] = useState(null);
+    const [cumulative, setCumulative] = useState({
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        durationMs: 0,
+        estimatedCost: 0
+    });
+    const recordRun = useCallback((stats) => {
+        setCurrent(stats);
+        // 累加本次 Run 的数据到总计中
+        setCumulative(prev => ({
+            inputTokens: prev.inputTokens + stats.inputTokens,
+            outputTokens: prev.outputTokens + stats.outputTokens,
+            totalTokens: prev.totalTokens + stats.totalTokens,
+            durationMs: prev.durationMs + stats.durationMs,
+            estimatedCost: (prev.estimatedCost || 0) + (stats.estimatedCost || 0)
+        }));
+    }, []);
+    const reset = useCallback(() => {
+        setCurrent(null);
+        setCumulative({
+            inputTokens: 0,
+            outputTokens: 0,
+            totalTokens: 0,
+            durationMs: 0,
+            estimatedCost: 0
+        });
+    }, []);
+    return {
+        current,
+        cumulative,
+        recordRun,
+        reset
+    };
+}

package/dist/theme.d.ts

@@ -0,0 +1,27 @@
+/** Pulse CLI Cyan/Blue 主题色定义 */
+export declare const theme: {
+    /** 主色调 - 标题、边框 */
+    readonly primary: "#06b6d4";
+    /** 强调色 - 关键操作 */
+    readonly accent: "#3b82f6";
+    /** 用户消息 */
+    readonly user: "#22d3ee";
+    /** 工具调用 */
+    readonly tool: "#a78bfa";
+    /** 思考过程 - 暗淡 */
+    readonly thinking: "#6b7280";
+    /** 成功 */
+    readonly success: "#22c55e";
+    /** 警告/审批 */
+    readonly warning: "#f59e0b";
+    /** 错误 */
+    readonly error: "#ef4444";
+    /** Token 统计 */
+    readonly stats: "#94a3b8";
+    /** 暗淡文本 */
+    readonly dim: "#64748b";
+    /** 边框 */
+    readonly border: "#334155";
+    /** 代码背景标签 */
+    readonly codeLang: "#475569";
+};

package/dist/theme.js

@@ -0,0 +1,27 @@
+/** Pulse CLI Cyan/Blue 主题色定义 */
+export const theme = {
+    /** 主色调 - 标题、边框 */
+    primary: '#06b6d4',
+    /** 强调色 - 关键操作 */
+    accent: '#3b82f6',
+    /** 用户消息 */
+    user: '#22d3ee',
+    /** 工具调用 */
+    tool: '#a78bfa',
+    /** 思考过程 - 暗淡 */
+    thinking: '#6b7280',
+    /** 成功 */
+    success: '#22c55e',
+    /** 警告/审批 */
+    warning: '#f59e0b',
+    /** 错误 */
+    error: '#ef4444',
+    /** Token 统计 */
+    stats: '#94a3b8',
+    /** 暗淡文本 */
+    dim: '#64748b',
+    /** 边框 */
+    border: '#334155',
+    /** 代码背景标签 */
+    codeLang: '#475569',
+};

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+import type { ConversationSummary, ArtifactSummary, AssistantEvent, RunHandle } from '@hunterzhu/pulse-server';
+export type { ConversationSummary, ArtifactSummary, AssistantEvent, RunHandle };
+/** 输出详细程度 */
+export type Verbosity = 'verbose' | 'normal' | 'quiet';
+/** Slash 命令定义 */
+export interface SlashCommand {
+    name: string;
+    aliases?: string[] | undefined;
+    description: string;
+    execute: (args: string) => void | Promise<void>;
+}
+/** 消息角色 */
+export type MessageRole = 'user' | 'assistant' | 'system';
+/** 显示用消息 */
+export interface DisplayMessage {
+    id: string;
+    role: MessageRole;
+    text: string;
+    runId?: string | undefined;
+    createdAt: string;
+    /** 工具调用事件 */
+    toolCalls?: ToolCallDisplay[] | undefined;
+    /** 思考过程 */
+    thinking?: string | undefined;
+    /** Token 统计 */
+    tokenStats?: TokenStatsData | undefined;
+}
+/** 工具调用展示数据 */
+export interface ToolCallDisplay {
+    id: string;
+    name: string;
+    arguments?: Record<string, unknown> | undefined;
+    result?: unknown;
+    status: 'running' | 'succeeded' | 'failed';
+    durationMs?: number | undefined;
+}
+/** Token 统计数据 */
+export interface TokenStatsData {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    durationMs: number;
+    estimatedCost?: number | undefined;
+}
+/** 审批请求数据 */
+export interface ApprovalRequest {
+    effectId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    prompt: string;
+    digest?: string | undefined;
+    tools?: Array<{
+        name: string;
+        toolCallId?: string;
+        input: Record<string, unknown>;
+    }> | undefined;
+}
+/** 应用状态模式 */
+export type AppMode = 'chat' | 'sessions' | 'help' | 'config';
+/** 解析后的命令行参数 */
+export interface ParsedArgs {
+    command: string;
+    positionals: string[];
+    options: Record<string, string | boolean>;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/ansi.d.ts

@@ -0,0 +1,5 @@
+export declare function stripAnsi(text: string): string;
+/** Remove terminal control sequences from untrusted text before display. */
+export declare function stripTerminalControls(text: string): string;
+export declare function terminalWidth(): number;
+export declare function horizontalLine(width?: number): string;

package/dist/utils/ansi.js

@@ -0,0 +1,20 @@
+import process from 'node:process';
+const completeOsc = /\u001B\][\s\S]*?(?:\u0007|\u001B\\)/g;
+const incompleteOsc = /\u001B\][\s\S]*$/g;
+const csi = /[\u001B\u009B][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+const otherEscape = /\u001B[@-_]/g;
+const unsafeControls = /[\u0000-\u0008\u000B\u000C\u000E-\u001A\u001C-\u001F\u007F]/g;
+export function stripAnsi(text) {
+    return text.replace(csi, '');
+}
+/** Remove terminal control sequences from untrusted text before display. */
+export function stripTerminalControls(text) {
+    return text.replace(completeOsc, '').replace(incompleteOsc, '').replace(csi, '').replace(otherEscape, '').replace(unsafeControls, '');
+}
+export function terminalWidth() {
+    return process.stdout.columns || 80;
+}
+export function horizontalLine(width) {
+    const w = width || terminalWidth();
+    return '─'.repeat(Math.max(1, w));
+}

package/dist/utils/approval.d.ts

@@ -0,0 +1,10 @@
+export interface ApprovalToolInput {
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ApprovalToolPreview {
+    name: string;
+    body: string;
+    truncated: boolean;
+}
+export declare function describeApprovalTool(tool: ApprovalToolInput): ApprovalToolPreview;

package/dist/utils/approval.js

@@ -0,0 +1,50 @@
+import { stripTerminalControls } from './ansi.js';
+const previewLimit = 1_000;
+function clip(value) {
+    const clean = stripTerminalControls(value);
+    if (clean.length <= previewLimit)
+        return { text: clean, truncated: false };
+    const hidden = clean.length - previewLimit;
+    return {
+        truncated: true,
+        text: `${clean.slice(0, previewLimit)}\n… 还有 ${hidden} 个字符未显示。批准会执行完整内容（共 ${clean.length} 个字符）。`,
+    };
+}
+function textField(input, key) {
+    const value = input[key];
+    return typeof value === 'string' ? value : value === undefined ? '' : JSON.stringify(value);
+}
+export function describeApprovalTool(tool) {
+    if (tool.name === 'fs.write') {
+        const content = clip(textField(tool.input, 'content'));
+        const path = stripTerminalControls(textField(tool.input, 'path'));
+        return {
+            name: tool.name,
+            truncated: content.truncated,
+            body: `路径: ${path}\n内容（${textField(tool.input, 'content').length} 个字符）:\n${content.text}`,
+        };
+    }
+    if (tool.name === 'fs.apply_patch') {
+        const find = clip(textField(tool.input, 'find'));
+        const replace = clip(textField(tool.input, 'replace'));
+        const path = stripTerminalControls(textField(tool.input, 'path'));
+        const all = tool.input.all === true ? '全部匹配' : '第一处匹配';
+        return {
+            name: tool.name,
+            truncated: find.truncated || replace.truncated,
+            body: `路径: ${path}\n范围: ${all}\n- ${find.text}\n+ ${replace.text}`,
+        };
+    }
+    if (tool.name === 'shell.exec') {
+        const command = stripTerminalControls(textField(tool.input, 'command'));
+        const args = Array.isArray(tool.input.args) ? tool.input.args.map((arg) => stripTerminalControls(String(arg))) : [];
+        const cwd = stripTerminalControls(textField(tool.input, 'cwd') || '.');
+        return {
+            name: tool.name,
+            truncated: false,
+            body: `命令: ${command}\n参数: ${args.join(' ') || '（无）'}\n目录: ${cwd}`,
+        };
+    }
+    const serialized = clip(JSON.stringify(tool.input, null, 2));
+    return { name: tool.name, truncated: serialized.truncated, body: serialized.text };
+}

package/dist/utils/format.d.ts

@@ -0,0 +1,6 @@
+export declare function formatBytes(bytes: number): string;
+export declare function formatDuration(ms: number): string;
+export declare function formatRelativeTime(iso: string): string;
+export declare function formatTokenCount(count: number): string;
+export declare function formatCost(cost: number): string;
+export declare function truncate(text: string, maxLen: number): string;

package/dist/utils/format.js

@@ -0,0 +1,51 @@
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const m = Math.floor(s / 60);
+    const remainingS = s % 60;
+    if (m < 60)
+        return `${m}m ${remainingS}s`;
+    const h = Math.floor(m / 60);
+    const remainingM = m % 60;
+    return `${h}h ${remainingM}m`;
+}
+export function formatRelativeTime(iso) {
+    const date = new Date(iso);
+    const now = new Date();
+    const diffInSeconds = Math.floor((now.getTime() - date.getTime()) / 1000);
+    if (diffInSeconds < 60)
+        return '刚刚';
+    if (diffInSeconds < 3600)
+        return `${Math.floor(diffInSeconds / 60)} 分钟前`;
+    if (diffInSeconds < 86400)
+        return `${Math.floor(diffInSeconds / 3600)} 小时前`;
+    if (diffInSeconds < 172800)
+        return '昨天';
+    return `${Math.floor(diffInSeconds / 86400)} 天前`;
+}
+export function formatTokenCount(count) {
+    return count.toLocaleString();
+}
+export function formatCost(cost) {
+    if (cost === 0)
+        return '$0.00';
+    if (cost < 0.0001)
+        return `<$0.0001`;
+    return `~$${cost.toFixed(4).replace(/0+$/, '').replace(/\.$/, '')}`;
+}
+export function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 3) + '...';
+}

package/dist/utils/highlight.d.ts

@@ -0,0 +1 @@
+export declare function highlightCode(code: string, language?: string): string;

package/dist/utils/highlight.js

@@ -0,0 +1,80 @@
+import hljs from 'highlight.js';
+import chalk from 'chalk';
+const themeColors = {
+    keyword: chalk.cyan,
+    string: chalk.green,
+    comment: chalk.gray,
+    number: chalk.yellow,
+    title: chalk.blue,
+    function: chalk.blue,
+    built_in: chalk.magenta,
+    literal: chalk.yellow,
+    meta: chalk.dim,
+    type: chalk.blueBright,
+    symbol: chalk.magentaBright,
+    regexp: chalk.red,
+    attr: chalk.cyanBright,
+    attribute: chalk.yellowBright,
+    addition: chalk.green,
+    deletion: chalk.red,
+    doctag: chalk.cyan,
+    name: chalk.blue,
+    selector: chalk.magenta,
+    quote: chalk.gray,
+    template_variable: chalk.redBright,
+    variable: chalk.redBright,
+};
+export function highlightCode(code, language) {
+    let highlighted;
+    try {
+        if (language && hljs.getLanguage(language)) {
+            highlighted = hljs.highlight(code, { language }).value;
+        }
+        else {
+            highlighted = hljs.highlightAuto(code).value;
+        }
+    }
+    catch {
+        return code;
+    }
+    const result = highlighted
+        .replace(/&/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;/g, "'");
+    const stack = [];
+    const parts = [];
+    const regex = /(<span class="hljs-[^"]+">|<\/span>)/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = regex.exec(result)) !== null) {
+        const textBefore = result.substring(lastIndex, match.index);
+        if (textBefore) {
+            parts.push(applyStackColor(textBefore, stack));
+        }
+        const tag = match[0];
+        if (tag === '</span>') {
+            stack.pop();
+        }
+        else {
+            const clsMatch = /hljs-([^"]+)/.exec(tag);
+            if (clsMatch && clsMatch[1]) {
+                stack.push(clsMatch[1]);
+            }
+        }
+        lastIndex = regex.lastIndex;
+    }
+    const textRemaining = result.substring(lastIndex);
+    if (textRemaining) {
+        parts.push(applyStackColor(textRemaining, stack));
+    }
+    return parts.join('');
+}
+function applyStackColor(text, stack) {
+    if (stack.length === 0)
+        return text;
+    const cls = stack[stack.length - 1];
+    const colorFn = themeColors[cls] || chalk.reset;
+    return colorFn(text);
+}

package/dist/utils/markdown.d.ts

@@ -0,0 +1 @@
+export declare function renderMarkdownToAnsi(markdown: string): string;

package/dist/utils/markdown.js

@@ -0,0 +1,138 @@
+import { marked } from 'marked';
+import chalk from 'chalk';
+import { theme } from '../theme.js';
+import { highlightCode } from './highlight.js';
+import { terminalWidth, horizontalLine, stripTerminalControls } from './ansi.js';
+export function renderMarkdownToAnsi(markdown) {
+    const tokens = marked.lexer(stripTerminalControls(markdown));
+    return renderTokens(tokens).trim();
+}
+function renderTokens(tokens) {
+    return tokens.map(token => renderToken(token)).join('');
+}
+function renderToken(token) {
+    switch (token.type) {
+        case 'heading': {
+            const t = token;
+            const text = renderTokens(t.tokens);
+            const boldText = chalk.bold(text);
+            let coloredText = boldText;
+            switch (t.depth) {
+                case 1:
+                    coloredText = chalk.hex(theme.primary)(boldText);
+                    break;
+                case 2:
+                    coloredText = chalk.hex(theme.accent)(boldText);
+                    break;
+                case 3:
+                    coloredText = chalk.hex(theme.user)(boldText);
+                    break;
+                case 4:
+                    coloredText = chalk.hex(theme.tool)(boldText);
+                    break;
+                default:
+                    coloredText = chalk.hex(theme.primary)(boldText);
+                    break;
+            }
+            return `\n${coloredText}\n`;
+        }
+        case 'paragraph': {
+            const t = token;
+            return `${renderTokens(t.tokens)}\n\n`;
+        }
+        case 'code': {
+            const t = token;
+            const lang = t.lang || '';
+            const highlighted = highlightCode(t.text, lang);
+            const width = terminalWidth();
+            const topBorder = chalk.hex(theme.border)(`╭${'─'.repeat(Math.max(1, width - 2))}╮`);
+            const bottomBorder = chalk.hex(theme.border)(`╰${'─'.repeat(Math.max(1, width - 2))}╯`);
+            const lines = highlighted.split('\n');
+            const content = lines.map(line => `${chalk.hex(theme.border)('│')} ${line}`).join('\n');
+            let header = '';
+            if (lang) {
+                header = chalk.hex(theme.codeLang)(` ${lang} \n`);
+            }
+            return `\n${topBorder}\n${header}${content}\n${bottomBorder}\n\n`;
+        }
+        case 'codespan': {
+            const t = token;
+            return chalk.bgGray.white(` ${t.text} `);
+        }
+        case 'strong': {
+            const t = token;
+            return chalk.bold(renderTokens(t.tokens));
+        }
+        case 'em': {
+            const t = token;
+            return chalk.italic(renderTokens(t.tokens));
+        }
+        case 'del': {
+            const t = token;
+            return chalk.strikethrough(renderTokens(t.tokens));
+        }
+        case 'list': {
+            const t = token;
+            return t.items.map((item, index) => {
+                const startNum = typeof t.start === 'number' ? t.start : Number(t.start || 1);
+                const prefix = t.ordered ? `${startNum + index}. ` : '• ';
+                return `  ${chalk.hex(theme.primary)(prefix)}${renderTokens(item.tokens).trim()}\n`;
+            }).join('') + '\n';
+        }
+        case 'blockquote': {
+            const t = token;
+            const text = renderTokens(t.tokens).trim();
+            const lines = text.split('\n');
+            const quoted = lines.map(line => `${chalk.hex(theme.dim)('│')} ${chalk.hex(theme.dim)(line)}`).join('\n');
+            return `\n${quoted}\n\n`;
+        }
+        case 'hr': {
+            return `\n${chalk.hex(theme.border)(horizontalLine())}\n\n`;
+        }
+        case 'link': {
+            const t = token;
+            const text = renderTokens(t.tokens);
+            return chalk.blue.underline(text) + chalk.dim(` (${t.href})`);
+        }
+        case 'table': {
+            const t = token;
+            let tableOut = '\n';
+            const drawRow = (row) => {
+                return '| ' + row.map(cell => renderTokens(cell)).join(' | ') + ' |\n';
+            };
+            tableOut += drawRow(t.header.map(h => h.tokens));
+            tableOut += '|' + t.header.map(() => '---').join('|') + '|\n';
+            for (const row of t.rows) {
+                tableOut += drawRow(row.map(c => c.tokens));
+            }
+            return tableOut + '\n';
+        }
+        case 'space': {
+            return '';
+        }
+        case 'text': {
+            const t = token;
+            if (t.tokens && t.tokens.length > 0) {
+                return renderTokens(t.tokens);
+            }
+            return t.text;
+        }
+        case 'br': {
+            return '\n';
+        }
+        case 'escape': {
+            const t = token;
+            return t.text;
+        }
+        case 'image': {
+            const t = token;
+            return chalk.dim(`[图片: ${t.text}]`);
+        }
+        default: {
+            if ('raw' in token) {
+                return token.raw;
+            }
+            return '';
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "repository": {
     "type": "git",
     "url": "https://github.com/zhuhengtan/Pulse"
@@ -19,6 +19,17 @@
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.1.4"
+    "@hunterzhu/pulse-server": "0.1.5",
+    "ink": "^7.1.1",
+    "react": "^19.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-select-input": "^6.2.0",
+    "ink-text-input": "^6.0.0",
+    "marked": "^14.0.0",
+    "highlight.js": "^11.10.0",
+    "chalk": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0"
   }
 }