@hunterzhu/pulse-cli 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,55 @@
+# @hunterzhu/pulse-cli
+
+**A neural-signal like AI assistant for coding, research and file tasks.**
+
+Pulse runs in your project folder, keeps conversations on your machine, and can resume unfinished work. Requires Node.js 22+.
+
+## Install
+
+Install the CLI globally so the `pulse` command is on your `PATH`:
+
+```bash
+npm install -g @hunterzhu/pulse-cli
+pulse --version
+```
+
+For a one-off run, use `npx @hunterzhu/pulse-cli`. Commands below assume a global installation.
+
+## Configure a model and API key
+
+Create a starter configuration:
+
+```bash
+pulse setup
+```
+
+The configuration lives at `~/.pulse/config.json` (Windows:
+`%USERPROFILE%\.pulse\config.json`). A fresh configuration includes the DeepSeek
+provider and `deepseek-chat` model. Set `activeModel` to `deepseek-chat`, or use
+`--model deepseek-chat` as below. The default `mock` model makes no API calls.
+
+Set the API key in your shell; the DeepSeek provider uses
+`apiKeyEnv: "DEEPSEEK_API_KEY"` to read it:
+
+```bash
+export DEEPSEEK_API_KEY="your-key"
+# Windows PowerShell: $env:DEEPSEEK_API_KEY="your-key"
+```
+
+## Usage
+
+```bash
+pulse --model deepseek-chat                        # interactive session
+pulse run "Summarize this project" --model deepseek-chat
+pulse sessions
+pulse resume <conversation-id> "Continue" --model deepseek-chat
+pulse doctor
+pulse --read-only
+```
+
+See `pulse --help` for all options.
+
+## Links
+
+- [Full CLI configuration guide](https://github.com/zhuhengtan/Pulse/blob/main/docs/cli-config.md)
+- [Source code and documentation](https://github.com/zhuhengtan/Pulse)

package/dist/bin.js

@@ -314,6 +314,7 @@ export async function hostOptions(parsed) {
         ...(configuredMaxTurns === undefined ? {} : { maxTurns: configuredMaxTurns }),
         ...(configuredAutoCompactPercent === undefined ? {} : { autoCompactPercent: Math.min(90, configuredAutoCompactPercent) }),
         ...(allowNetwork === undefined ? {} : { allowNetwork }),
+        ...(config.networkHosts === undefined ? {} : { networkHosts: config.networkHosts }),
         executionMode,
     };
 }

package/dist/commands/interactive.js

@@ -22,14 +22,20 @@ export async function runInteractive(options, conversationId, initialTask, versi
         // Keep Pulse in its own full-screen buffer so the shell's previous
         // command history does not become part of the chat workspace.
         alternateScreen: true,
+        // Ctrl+C is a selection-copy shortcut inside the chat. Exit explicitly
+        // through /exit so an accidental keypress cannot drop an active task.
+        exitOnCtrlC: false,
     });
     let interrupted = false;
-    const onSignal = () => {
+    const onInterrupt = () => {
+        // Ignore SIGINT while the interactive app is active; /exit is the exit path.
+    };
+    const onTerminate = () => {
         interrupted = true;
         unmount();
     };
-    process.on('SIGINT', onSignal);
-    process.on('SIGTERM', onSignal);
+    process.on('SIGINT', onInterrupt);
+    process.on('SIGTERM', onTerminate);
     try {
         await waitUntilExit();
         return interrupted ? 130 : 0;
@@ -39,8 +45,8 @@ export async function runInteractive(options, conversationId, initialTask, versi
         return 1;
     }
     finally {
-        process.off('SIGINT', onSignal);
-        process.off('SIGTERM', onSignal);
+        process.off('SIGINT', onInterrupt);
+        process.off('SIGTERM', onTerminate);
         await closePendingHosts();
     }
 }

package/dist/components/App.js

@@ -16,6 +16,8 @@ import { useConversation } from '../hooks/useConversation.js';
 import { useRun } from '../hooks/useRun.js';
 import { useTokenStats } from '../hooks/useTokenStats.js';
 import { useSlashCommands } from '../hooks/useSlashCommands.js';
+import { copyToClipboard, isCopyShortcut } from '../utils/clipboard.js';
+import { emptyInputHistory, navigateInputHistory, rememberInput } from '../utils/inputHistory.js';
 export function App({ hostOptions, conversationId: initialConversationId, initialTask, resumeOnStart = false, version, }) {
     const { exit } = useApp();
     const { stdout } = useStdout();
@@ -23,6 +25,10 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
     useEffect(() => { const resize = () => setTerminalRows(stdout.rows || 24); stdout.on('resize', resize); return () => { stdout.off('resize', resize); }; }, [stdout]);
     const [mode, setMode] = useState('chat');
     const [mouseEnabled, setMouseEnabled] = useState(true);
+    const [selectedText, setSelectedText] = useState('');
+    const [inputHistory, setInputHistory] = useState(emptyInputHistory);
+    const inputHistoryRef = useRef(inputHistory);
+    inputHistoryRef.current = inputHistory;
     const [showThinking, setShowThinking] = useState(false);
     const [verbosity, setVerbosity] = useState('normal');
     const [sessionsList, setSessionsList] = useState([]);
@@ -33,12 +39,35 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
     const startedResume = useRef(false);
     const { host, error: hostError, ready: hostReady } = useHost(hostOptions);
     const { conversation, messages, addUserMessage, addAssistantMessage, clearMessages, switchConversation, newConversation, createConversation, error: conversationError, } = useConversation({ host, conversationId: initialConversationId });
-    const { isRunning, currentStep, error: runError, approvalRequest, askRequest, lanes, approvalSubmitting, sendMessage, resumeActive, approveAction, replyAsk, cancelRun, } = useRun({
+    const { isRunning, error: runError, approvalRequest, askRequest, lanes, approvalSubmitting, sendMessage, resumeActive, approveAction, replyAsk, cancelRun, } = useRun({
         host,
         conversationId: conversation?.id ?? null,
         addAssistantMessage,
     });
     const { cumulative } = useTokenStats();
+    const rememberUserInput = useCallback((text) => {
+        const next = rememberInput(inputHistoryRef.current, text);
+        inputHistoryRef.current = next;
+        setInputHistory(next);
+    }, []);
+    const navigateUserInputHistory = useCallback((direction, currentValue) => {
+        const result = navigateInputHistory(inputHistoryRef.current, direction, currentValue);
+        inputHistoryRef.current = result.state;
+        setInputHistory(result.state);
+        return result.value;
+    }, []);
+    useEffect(() => { setSelectedText(''); }, [conversation?.id]);
+    const copySelectedText = useCallback(async () => {
+        if (!selectedText)
+            return;
+        try {
+            await copyToClipboard(selectedText);
+            addAssistantMessage({ id: `copy-${Date.now()}`, role: 'system', text: `已复制选中的内容（${selectedText.length.toLocaleString()} 个字符）。`, createdAt: new Date().toISOString() });
+        }
+        catch {
+            addAssistantMessage({ id: `copy-${Date.now()}`, role: 'system', text: '复制失败：当前系统没有可用的剪贴板工具。', createdAt: new Date().toISOString() });
+        }
+    }, [selectedText, addAssistantMessage]);
     useEffect(() => {
         if (approvalRequest) {
             setApprovalChoiceFocused(true);
@@ -100,6 +129,25 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
     }, [hostReady, conversation, initialTask, isRunning, addUserMessage, addAssistantMessage, createConversation, sendMessage]);
     const { executeCommand, isSlashCommand } = useSlashCommands({
         onMouse: (arg) => setMouseEnabled((current) => arg === 'off' ? false : arg === 'on' ? true : !current),
+        onCopy: async () => {
+            if (selectedText) {
+                await copySelectedText();
+                return;
+            }
+            const latest = [...messages].reverse().find((message) => message.role === 'assistant' && message.text.trim() && message.streamStatus !== 'streaming' && message.streamStatus !== 'incomplete');
+            const payload = latest?.text || '';
+            if (!payload) {
+                addAssistantMessage({ id: `copy-${Date.now()}`, role: 'system', text: '请先拖动选择内容，或发送一条消息后再复制回复。', createdAt: new Date().toISOString() });
+                return;
+            }
+            try {
+                await copyToClipboard(payload);
+                addAssistantMessage({ id: `copy-${Date.now()}`, role: 'system', text: `已复制最近一条完整回复（${payload.length.toLocaleString()} 个字符）。`, createdAt: new Date().toISOString() });
+            }
+            catch {
+                addAssistantMessage({ id: `copy-${Date.now()}`, role: 'system', text: '复制失败：当前系统没有可用的剪贴板工具。可试试 /mouse off 后用终端选择文本。', createdAt: new Date().toISOString() });
+            }
+        },
         onHelp: () => setMode('help'),
         onSessions: async () => {
             await loadSessions();
@@ -156,7 +204,6 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
             }
         },
         onExit: () => exit(),
-        onQuit: () => exit(),
         onCancel: async () => {
             if (!isRunning) {
                 addAssistantMessage({
@@ -183,6 +230,7 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
                     maxTurns: hostOptions.maxTurns ?? 32,
                     autoCompactPercent: hostOptions.autoCompactPercent ?? 90,
                     allowNetwork: hostOptions.allowNetwork ?? false,
+                    networkHosts: hostOptions.networkHosts ?? [],
                 }, null, 2),
                 createdAt: new Date().toISOString(),
             });
@@ -424,8 +472,9 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
         }
     }, [isSlashCommand, executeCommand, conversation, createConversation, addUserMessage, sendMessage]);
     useInput((input, key) => {
-        if ((hostError || (conversationError && !conversation)) && (input === 'q' || key.escape)) {
-            exit();
+        if (isCopyShortcut(input, key)) {
+            if (selectedText)
+                void copySelectedText();
             return;
         }
         if (conversationError && !conversation && input === 'n') {
@@ -451,13 +500,13 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
         }
     });
     if (hostError) {
-        return (_jsxs(Box, { padding: 1, flexDirection: "column", children: [_jsxs(Text, { color: "red", children: ["Pulse \u521D\u59CB\u5316\u5931\u8D25\uFF1A", hostError] }), _jsx(Text, { dimColor: true, children: "\u8BF7\u68C0\u67E5\u5DE5\u4F5C\u76EE\u5F55\u3001\u914D\u7F6E\u6587\u4EF6\u548C\u6570\u636E\u76EE\u5F55\u6743\u9650\u540E\u91CD\u8BD5\u3002" }), _jsx(Text, { dimColor: true, children: "\u6309 q \u9000\u51FA\u3002" })] }));
+        return (_jsxs(Box, { padding: 1, flexDirection: "column", children: [_jsxs(Text, { color: "red", children: ["Pulse \u521D\u59CB\u5316\u5931\u8D25\uFF1A", hostError] }), _jsx(Text, { dimColor: true, children: "\u8BF7\u68C0\u67E5\u5DE5\u4F5C\u76EE\u5F55\u3001\u914D\u7F6E\u6587\u4EF6\u548C\u6570\u636E\u76EE\u5F55\u6743\u9650\u540E\u91CD\u8BD5\u3002" }), _jsx(Text, { dimColor: true, children: "\u8F93\u5165 /exit \u9000\u51FA\u3002" })] }));
     }
     if (!hostReady) {
         return (_jsx(Box, { padding: 1, children: _jsx(Spinner, { label: "\u6B63\u5728\u521D\u59CB\u5316 Pulse \u8FD0\u884C\u65F6..." }) }));
     }
     if (conversationError && !conversation) {
-        return (_jsxs(Box, { padding: 1, flexDirection: "column", children: [_jsxs(Text, { color: "red", children: ["\u4F1A\u8BDD\u52A0\u8F7D\u5931\u8D25\uFF1A", conversationError] }), _jsx(Text, { dimColor: true, children: "\u6309 n \u65B0\u5EFA\u4F1A\u8BDD\uFF0C\u6309 q \u9000\u51FA\u3002" })] }));
+        return (_jsxs(Box, { padding: 1, flexDirection: "column", children: [_jsxs(Text, { color: "red", children: ["\u4F1A\u8BDD\u52A0\u8F7D\u5931\u8D25\uFF1A", conversationError] }), _jsx(Text, { dimColor: true, children: "\u6309 n \u65B0\u5EFA\u4F1A\u8BDD\uFF0C\u8F93\u5165 /exit \u9000\u51FA\u3002" })] }));
     }
     if (mode === 'sessions') {
         return (_jsx(SessionList, { sessions: sessionsList, notice: sessionError, onSelect: (id) => {
@@ -485,13 +534,13 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
     const title = conversation?.summary.title ?? 'New conversation';
     const modelName = host?.getModel() || hostOptions.provider?.defaultModel || hostOptions.provider?.provider || 'default';
     const providerName = host?.getProvider() || hostOptions.activeProviderCode || hostOptions.provider?.provider || 'default';
-    return (_jsxs(Box, { flexDirection: "column", width: "100%", height: terminalRows, children: [_jsx(Header, { title: title, cwd: cwd, model: modelName, approvalMode: hostOptions.approvalMode ?? 'ask' }), messages.length === 0 && !isRunning && (_jsx(Welcome, { cwd: cwd, model: modelName, version: version })), messages.length > 0 && (_jsx(MessageList, { mouseEnabled: mouseEnabled, messages: messages, showThinking: showThinking, verbosity: verbosity, isRunning: isRunning })), runError && (_jsx(Box, { marginY: 1, children: _jsxs(Text, { color: "red", children: ["\u9519\u8BEF: ", runError] }) })), conversationError && (_jsx(Box, { marginY: 1, children: _jsxs(Text, { color: "red", children: ["\u4F1A\u8BDD\u6D88\u606F\u52A0\u8F7D\u5931\u8D25: ", conversationError] }) })), _jsx(StatusHud, { isRunning: isRunning, cwd: cwd, model: modelName, provider: providerName, approvalMode: hostOptions.approvalMode ?? 'ask', currentStep: currentStep, lanes: lanes }), approvalRequest ? (_jsx(ApprovalPrompt, { request: approvalRequest, inputMode: approvalInputMode, isFocused: approvalChoiceFocused && !approvalSubmitting, onApprove: () => {
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", height: terminalRows, children: [_jsx(Header, { title: title, cwd: cwd, model: modelName, approvalMode: hostOptions.approvalMode ?? 'ask' }), messages.length === 0 && !isRunning && (_jsx(Welcome, { cwd: cwd, model: modelName, version: version })), messages.length > 0 && (_jsx(MessageList, { mouseEnabled: mouseEnabled, messages: messages, showThinking: showThinking, verbosity: verbosity, isRunning: isRunning, onSelectionChange: setSelectedText })), runError && (_jsx(Box, { marginY: 1, children: _jsxs(Text, { color: "red", children: ["\u9519\u8BEF: ", runError] }) })), conversationError && (_jsx(Box, { marginY: 1, children: _jsxs(Text, { color: "red", children: ["\u4F1A\u8BDD\u6D88\u606F\u52A0\u8F7D\u5931\u8D25: ", conversationError] }) })), _jsx(StatusHud, { isRunning: isRunning, cwd: cwd, model: modelName, provider: providerName, approvalMode: hostOptions.approvalMode ?? 'ask', lanes: lanes }), approvalRequest ? (_jsx(ApprovalPrompt, { request: approvalRequest, inputMode: approvalInputMode, isFocused: approvalChoiceFocused && !approvalSubmitting, onApprove: () => {
                     void approveAction(approvalRequest.effectId, true);
                 }, onDeny: (reason) => {
                     void approveAction(approvalRequest.effectId, false, reason);
                 }, onInput: () => {
                     setApprovalChoiceFocused(false);
                     setApprovalInputMode(true);
-                } })) : askRequest ? (_jsx(AskPrompt, { request: askRequest, disabled: approvalSubmitting, onReply: (value) => void replyAsk(askRequest.effectId, value) }, askRequest.effectId)) : (_jsx(Box, { marginTop: 1, children: _jsx(InputArea, { onSubmit: (txt) => void handleSubmit(txt), disabled: approvalSubmitting, focus: !approvalSubmitting, placeholder: isRunning ? '运行中也可以输入；/cancel 可取消当前运行...' : '输入消息或 /help...' }) }))] }));
+                } })) : askRequest ? (_jsx(AskPrompt, { request: askRequest, disabled: approvalSubmitting, onReply: (value) => void replyAsk(askRequest.effectId, value) }, askRequest.effectId)) : (_jsx(Box, { marginTop: 1, children: _jsx(InputArea, { onSubmit: (txt) => void handleSubmit(txt), onRememberInput: rememberUserInput, onNavigateHistory: navigateUserInputHistory, disabled: approvalSubmitting, focus: !approvalSubmitting, placeholder: isRunning ? '运行中也可以输入；/cancel 可取消当前运行...' : '输入消息或 /help...' }) }))] }));
 }
 export default App;

package/dist/components/HelpView.js

@@ -6,11 +6,12 @@ const COMMANDS = [
         category: 'General',
         commands: [
             { name: '/mouse on|off', desc: '开关滚轮/触控板滚动；关闭后可原生选择文本' },
+            { name: '/copy', desc: '复制当前选区或最近一条完整回复' },
             { name: '/help', desc: '显示帮助信息' },
             { name: '/status', desc: '查看会话状态' },
             { name: '/tools', desc: '列出可用工具' },
             { name: '/artifacts', desc: '查看当前产物列表' },
-            { name: '/exit, /quit', desc: '退出 CLI' },
+            { name: '/exit', desc: '退出 CLI' },
             { name: '/cancel, /stop', desc: '取消当前运行并保留会话' },
         ],
     },

package/dist/components/InputArea.d.ts

@@ -1,8 +1,10 @@
 interface Props {
     onSubmit: (text: string) => void;
+    onRememberInput: (text: string) => void;
+    onNavigateHistory: (direction: 'up' | 'down', currentValue: string) => string | undefined;
     disabled?: boolean;
     focus?: boolean;
     placeholder?: string;
 }
-export declare function InputArea({ onSubmit, disabled, focus, placeholder }: Props): import("react").JSX.Element;
+export declare function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus, placeholder }: Props): import("react").JSX.Element;
 export {};

package/dist/components/InputArea.js

@@ -3,11 +3,9 @@ import { Box, Text, useInput } from 'ink';
 import TextInput from './TextInput.js';
 import { useState } from 'react';
 import { theme } from '../theme.js';
-export function InputArea({ onSubmit, disabled, focus = true, placeholder }) {
+export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus = true, placeholder }) {
     const [value, setValue] = useState('');
     const [accumulatedLines, setAccumulatedLines] = useState([]);
-    const [history, setHistory] = useState([]);
-    const [historyIndex, setHistoryIndex] = useState(-1);
     useInput((input, key) => {
         if (disabled || !focus)
             return;
@@ -24,24 +22,21 @@ export function InputArea({ onSubmit, disabled, focus = true, placeholder }) {
             return;
         }
         if (key.upArrow) {
-            if (historyIndex < history.length - 1) {
-                const nextIndex = historyIndex + 1;
-                setHistoryIndex(nextIndex);
-                setValue(history[history.length - 1 - nextIndex] || '');
-            }
+            const previous = onNavigateHistory('up', [...accumulatedLines, value].join('\n'));
+            if (previous !== undefined)
+                restoreInput(previous);
         }
         else if (key.downArrow) {
-            if (historyIndex > 0) {
-                const nextIndex = historyIndex - 1;
-                setHistoryIndex(nextIndex);
-                setValue(history[history.length - 1 - nextIndex] || '');
-            }
-            else if (historyIndex === 0) {
-                setHistoryIndex(-1);
-                setValue('');
-            }
+            const next = onNavigateHistory('down', [...accumulatedLines, value].join('\n'));
+            if (next !== undefined)
+                restoreInput(next);
         }
     });
+    const restoreInput = (text) => {
+        const lines = text.split('\n');
+        setAccumulatedLines(lines.slice(0, -1));
+        setValue(lines.at(-1) ?? '');
+    };
     const handleSubmit = (text) => {
         if (text.endsWith('\\')) {
             const newLine = text.slice(0, -1);
@@ -52,10 +47,8 @@ export function InputArea({ onSubmit, disabled, focus = true, placeholder }) {
             const finalLines = [...accumulatedLines, text];
             const fullText = finalLines.join('\n');
             if (fullText.trim()) {
-                const newHistory = [...history, fullText].slice(-50);
-                setHistory(newHistory);
+                onRememberInput(fullText);
             }
-            setHistoryIndex(-1);
             setAccumulatedLines([]);
             setValue('');
             onSubmit(fullText);

package/dist/components/MessageList.d.ts

@@ -5,6 +5,7 @@ interface Props {
     showThinking?: boolean | undefined;
     verbosity?: Verbosity | undefined;
     isRunning?: boolean | undefined;
+    onSelectionChange?: ((text: string) => void) | undefined;
 }
-export declare function MessageList({ mouseEnabled, messages, showThinking, verbosity, isRunning }: Props): import("react").JSX.Element;
+export declare function MessageList({ mouseEnabled, messages, showThinking, verbosity, isRunning, onSelectionChange }: Props): import("react").JSX.Element;
 export {};

package/dist/components/MessageList.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { MessageViewport } from './MessageViewport.js';
-export function MessageList({ mouseEnabled = true, messages, showThinking, verbosity = 'normal', isRunning = false }) {
-    return _jsx(MessageViewport, { mouseEnabled: mouseEnabled, messages: messages, ...(showThinking === undefined ? {} : { showThinking }), verbosity: verbosity, isRunning: isRunning });
+export function MessageList({ mouseEnabled = true, messages, showThinking, verbosity = 'normal', isRunning = false, onSelectionChange }) {
+    return _jsx(MessageViewport, { mouseEnabled: mouseEnabled, messages: messages, ...(showThinking === undefined ? {} : { showThinking }), verbosity: verbosity, isRunning: isRunning, ...(onSelectionChange === undefined ? {} : { onSelectionChange }) });
 }

package/dist/components/MessageViewport.d.ts

@@ -5,6 +5,7 @@ interface Props {
     showThinking?: boolean;
     verbosity?: Verbosity;
     isRunning?: boolean;
+    onSelectionChange?: (text: string) => void;
 }
-export declare function MessageViewport({ messages, verbosity, mouseEnabled }: Props): import("react").JSX.Element;
+export declare function MessageViewport({ messages, verbosity, mouseEnabled, onSelectionChange }: Props): import("react").JSX.Element;
 export {};

package/dist/components/MessageViewport.js

@@ -4,7 +4,9 @@ import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import { mouseEvent, enableMouse, disableMouse } from '../utils/mouse.js';
 import { theme } from '../theme.js';
 import { transcriptLines, scrollAction } from '../utils/transcript.js';
-export function MessageViewport({ messages, verbosity = 'normal', mouseEnabled = true }) {
+import { selectedLine, selectedText } from '../utils/selection.js';
+import { copyToClipboard } from '../utils/clipboard.js';
+export function MessageViewport({ messages, verbosity = 'normal', mouseEnabled = true, onSelectionChange }) {
     const { stdout } = useStdout();
     useEffect(() => {
         if (!mouseEnabled || !stdout.isTTY)
@@ -15,6 +17,10 @@ export function MessageViewport({ messages, verbosity = 'normal', mouseEnabled =
     const box = useRef(null);
     const [size, setSize] = useState({ width: stdout.columns || 80, height: 12 });
     const [start, setStart] = useState(null);
+    const [selection, setSelection] = useState();
+    const selectionRef = useRef(undefined);
+    const selecting = useRef(false);
+    const selectionAnchor = useRef(undefined);
     useLayoutEffect(() => {
         if (!box.current)
             return;
@@ -26,14 +32,68 @@ export function MessageViewport({ messages, verbosity = 'normal', mouseEnabled =
     const page = Math.max(1, size.height - 1);
     const bottom = Math.max(0, lines.length - page);
     const first = start === null ? bottom : Math.min(start, bottom);
+    const pointAt = (x, y) => {
+        if (!box.current)
+            return undefined;
+        const layout = measureElement(box.current);
+        const localY = y - layout.y;
+        if (localY < 0 || localY >= page)
+            return undefined;
+        return { line: Math.max(0, Math.min(lines.length - 1, first + localY)), column: Math.max(0, x - layout.x) };
+    };
+    const publishSelection = (next) => {
+        selectionRef.current = next;
+        setSelection(next);
+        onSelectionChange?.(next ? selectedText(lines, next) : '');
+    };
     useInput((input, key) => {
         const mouse = mouseEvent(input);
         if (mouse) {
-            if (mouseEnabled && mouse.wheel)
+            if (mouseEnabled && mouse.phase === 'wheel')
                 setStart((previous) => {
                     const next = Math.max(0, Math.min(bottom, (previous === null ? bottom : Math.min(previous, bottom)) + mouse.wheel));
                     return next === bottom ? null : next;
                 });
+            const isLeftButton = (mouse.button & 3) === 0;
+            if (mouseEnabled && isLeftButton && mouse.phase === 'press') {
+                const point = pointAt(mouse.x, mouse.y);
+                if (point) {
+                    selecting.current = true;
+                    selectionAnchor.current = point;
+                    publishSelection({ start: point, end: point });
+                }
+            }
+            else if (mouseEnabled && selecting.current && mouse.phase === 'drag') {
+                const layout = box.current ? measureElement(box.current) : undefined;
+                if (layout && mouse.y < layout.y)
+                    setStart((previous) => Math.max(0, (previous === null ? bottom : previous) - 1));
+                if (layout && mouse.y >= layout.y + page)
+                    setStart((previous) => Math.min(bottom, (previous === null ? bottom : previous) + 1));
+                const localY = layout ? Math.max(0, Math.min(page - 1, mouse.y - layout.y)) : mouse.y;
+                const point = pointAt(mouse.x, (layout?.y ?? 0) + localY);
+                if (point && selectionAnchor.current)
+                    publishSelection({ start: selectionAnchor.current, end: point });
+            }
+            else if (selecting.current && mouse.phase === 'release') {
+                selecting.current = false;
+                const completed = selectionRef.current;
+                if (selectionAnchor.current && completed && completed.start.line === completed.end.line && completed.start.column === completed.end.column) {
+                    selectionAnchor.current = undefined;
+                    publishSelection(undefined);
+                }
+                else if (completed) {
+                    // Terminal emulators reserve Command+C before the CLI can see it.
+                    // Sync the custom selection on mouse release so the standard copy
+                    // shortcut always finds the selected text in the system clipboard.
+                    void copyToClipboard(selectedText(lines, completed)).catch(() => { });
+                }
+            }
+            return;
+        }
+        if (key.escape && selection) {
+            selecting.current = false;
+            selectionAnchor.current = undefined;
+            publishSelection(undefined);
             return;
         }
         const action = scrollAction(input, key);
@@ -46,5 +106,5 @@ export function MessageViewport({ messages, verbosity = 'normal', mouseEnabled =
         if (action === 'bottom')
             setStart(null);
     });
-    return (_jsxs(Box, { ref: box, flexDirection: "column", flexGrow: 1, flexShrink: 1, flexBasis: 0, minHeight: 3, overflow: "hidden", children: [_jsx(Box, { flexDirection: "column", height: page, overflow: "hidden", children: _jsx(Text, { children: lines.slice(first, first + page).join('\n') }) }), _jsx(Text, { color: theme.dim, children: start === null ? (mouseEnabled ? '滚轮 / 双指滚动 · Ctrl+G 回到底部' : 'Ctrl+P 上翻 · Ctrl+N 下翻') : `历史 ${first + 1}–${Math.min(lines.length, first + page)}/${lines.length} · 滚动浏览 · Ctrl+G 回到底部` })] }));
+    return (_jsxs(Box, { ref: box, flexDirection: "column", flexGrow: 1, flexShrink: 1, flexBasis: 0, minHeight: 3, overflow: "hidden", children: [_jsx(Box, { flexDirection: "column", height: page, overflow: "hidden", children: _jsx(Text, { children: lines.slice(first, first + page).map((line, index) => selectedLine(line, first + index, selection)).join('\n') }) }), _jsx(Text, { color: theme.dim, children: selection ? '已选中 · 松开鼠标已复制 · Ctrl+C / /copy 复制 · Esc 取消选择' : start === null ? (mouseEnabled ? '滚轮 / 双指滚动 · 拖动选择后自动复制 · Ctrl+C 复制选区 · /copy 复制回复 · Ctrl+G 回到底部' : 'Ctrl+P 上翻 · Ctrl+N 下翻 · 终端可原生选择文字') : `历史 ${first + 1}–${Math.min(lines.length, first + page)}/${lines.length} · 滚动浏览 · 拖动选择后自动复制 · Ctrl+C / /copy 复制 · Ctrl+G 回到底部` })] }));
 }

package/dist/components/StatusHud.d.ts

@@ -5,8 +5,7 @@ interface Props {
     model: string;
     provider: string;
     approvalMode: 'read-only' | 'ask' | 'auto';
-    currentStep?: string | null;
     lanes: LaneDisplay[];
 }
-export declare function StatusHud({ isRunning, approvalMode, currentStep, lanes }: Props): import("react").JSX.Element;
+export declare function StatusHud({ isRunning, approvalMode, lanes }: Props): import("react").JSX.Element;
 export {};

package/dist/components/StatusHud.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { Spinner } from './Spinner.js';
 import { theme } from '../theme.js';
-export function StatusHud({ isRunning, approvalMode, currentStep, lanes }) {
+export function StatusHud({ isRunning, approvalMode, lanes }) {
     const active = lanes.filter((lane) => !['succeeded', 'failed', 'cancelled'].includes(lane.status));
-    return _jsxs(Box, { flexShrink: 0, gap: 1, children: [isRunning && _jsx(Spinner, {}), _jsxs(Text, { color: theme.dim, wrap: "truncate-end", children: [isRunning ? currentStep || '正在执行' : '就绪', " \u00B7 ", approvalMode === 'auto' ? '自动审批' : approvalMode === 'read-only' ? '只读' : '操作前询问', active.length > 1 ? ` · ${active.length} 个子任务` : '', " \u00B7 /help \u5E2E\u52A9 \u00B7 /verbose \u8BE6\u60C5"] })] });
+    return _jsxs(Box, { flexShrink: 0, gap: 1, children: [isRunning && _jsx(Spinner, {}), _jsxs(Text, { color: theme.dim, wrap: "truncate-end", children: [isRunning ? '任务进行中 · 详细进度显示在对话里 · /cancel 停止' : '就绪', " \u00B7 ", approvalMode === 'auto' ? '自动审批' : approvalMode === 'read-only' ? '只读' : '操作前询问', active.length > 1 ? ` · ${active.length} 个子任务` : '', " \u00B7 /help \u5E2E\u52A9 \u00B7 /exit \u9000\u51FA"] })] });
 }

package/dist/config.d.ts

@@ -74,6 +74,8 @@ export interface PulseCliConfig {
     maxTurns?: number;
     /** Percent of maxContextTokens that triggers automatic history compaction. Clamped to 1–90. */
     autoCompactPercent?: number;
+    /** Explicit network destinations; workspace configuration cannot grant these. */
+    networkHosts?: string[];
     allowNetwork?: boolean;
 }
 export declare const defaultPulseConfig: PulseCliConfig;

package/dist/hooks/useConversation.d.ts

@@ -8,7 +8,9 @@ export declare function useConversation({ host, conversationId, }: {
     messages: DisplayMessage[];
     error: string | null;
     addUserMessage: (text: string) => void;
-    addAssistantMessage: (msg: DisplayMessage) => void;
+    addAssistantMessage: (msg: DisplayMessage, options?: {
+        moveToEnd?: boolean;
+    }) => void;
     clearMessages: () => void;
     switchConversation: (id: string) => Promise<void>;
     newConversation: () => Promise<ConversationHandle | null>;

package/dist/hooks/useConversation.js

@@ -63,10 +63,12 @@ export function useConversation({ host, conversationId, }) {
         };
         setMessages((prev) => [...prev, newMessage]);
     }, []);
-    const addAssistantMessage = useCallback((msg) => {
+    const addAssistantMessage = useCallback((msg, options) => {
         setMessages((prev) => {
             const index = prev.findIndex((m) => m.id === msg.id);
             if (index >= 0) {
+                if (options?.moveToEnd)
+                    return [...prev.filter((m) => m.id !== msg.id), msg];
                 const next = [...prev];
                 next[index] = msg;
                 return next;

package/dist/hooks/useRun.d.ts

@@ -4,7 +4,9 @@ export declare function describeFactStatus(data: unknown): string;
 export declare function useRun({ host, conversationId, addAssistantMessage, }: {
     host: LocalHost | null;
     conversationId: string | null;
-    addAssistantMessage: (msg: DisplayMessage) => void;
+    addAssistantMessage: (msg: DisplayMessage, options?: {
+        moveToEnd?: boolean;
+    }) => void;
 }): {
     isRunning: boolean;
     currentStep: string | null;

package/dist/hooks/useRun.js

@@ -50,11 +50,30 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
             id: run.id,
             role: 'assistant',
             text: '',
+            streamStatus: 'streaming',
             createdAt: new Date().toISOString(),
             toolCalls: [],
             runId: run.id,
         };
         let assistantStarted = false;
+        let streamedEffectId;
+        let streamedAttemptId;
+        let lastProgressText = '';
+        const addProgress = (key, text) => {
+            if (!text || text === lastProgressText)
+                return;
+            lastProgressText = text;
+            addAssistantMessage({
+                // One live activity cell is updated in place, like Codex/Claude's
+                // active-turn transcript, instead of appending every snapshot.
+                id: `run-activity-${run.id}`,
+                role: 'system',
+                text,
+                createdAt: new Date().toISOString(),
+                runId: run.id,
+            }, key === 'finished' ? { moveToEnd: true } : undefined);
+        };
+        addProgress('received', '已收到任务，正在理解需求并安排步骤…');
         const ensureAssistant = () => {
             if (assistantStarted)
                 return;
@@ -68,6 +87,16 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                     : {};
                 const text = typeof data.text === 'string' ? data.text : '';
                 if (text) {
+                    if (data.kind === 'task_progress') {
+                        const tasks = Array.isArray(data.tasks) ? data.tasks : [];
+                        const visibleText = tasks.length === 0 ? '正在理解需求并规划执行步骤…' : text;
+                        setCurrentStep(visibleText);
+                        const active = tasks.find((task) => task && typeof task === 'object' && ['running', 'verifying'].includes(String(task.status)));
+                        const stageKey = active ? `${String(active.id)}:${String(active.status)}:${String(active.goal)}` : visibleText.replace(/\s*[·|]\s*(阶段调用|stage calls)\s*\d+.*$/i, '');
+                        const stageText = visibleText.replace(/\s*[·|]\s*(阶段调用|stage calls)\s*\d+.*$/i, '');
+                        addProgress(`stage:${stageKey}`, stageText);
+                        continue;
+                    }
                     addAssistantMessage({
                         id: `notice-${run.id}-${event.seq}`,
                         role: 'system',
@@ -77,10 +106,37 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                 }
                 continue;
             }
-            ensureAssistant();
+            if (event.type !== 'complete' && event.type !== 'error')
+                ensureAssistant();
             switch (event.type) {
+                case 'delta': {
+                    const delta = event.data && typeof event.data === 'object' && !Array.isArray(event.data)
+                        ? event.data
+                        : {};
+                    const effectId = typeof delta.effectId === 'string' ? delta.effectId : undefined;
+                    const attemptId = typeof delta.attemptId === 'string' ? delta.attemptId : undefined;
+                    const text = typeof delta.text === 'string' ? delta.text : '';
+                    if (!text)
+                        break;
+                    if (effectId !== streamedEffectId || attemptId !== streamedAttemptId) {
+                        assistantMessage.text = '';
+                        streamedEffectId = effectId;
+                        streamedAttemptId = attemptId;
+                    }
+                    assistantMessage.text += text;
+                    assistantMessage.streamStatus = 'streaming';
+                    addAssistantMessage({ ...assistantMessage, toolCalls: assistantMessage.toolCalls?.map((call) => ({ ...call })) });
+                    setCurrentStep('正在生成回复…');
+                    break;
+                }
                 case 'text':
-                    assistantMessage.text += String(event.data ?? '');
+                    if (streamedEffectId !== undefined)
+                        assistantMessage.text = String(event.data ?? '');
+                    else
+                        assistantMessage.text += String(event.data ?? '');
+                    streamedEffectId = undefined;
+                    streamedAttemptId = undefined;
+                    assistantMessage.streamStatus = 'complete';
                     addAssistantMessage({ ...assistantMessage, toolCalls: assistantMessage.toolCalls?.map((call) => ({ ...call })) });
                     break;
                 case 'observation': {
@@ -102,6 +158,8 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                             ? calls.map((call, callIndex) => callIndex === index ? { ...call, ...nextCall } : call)
                             : [...calls, nextCall];
                         addAssistantMessage({ ...assistantMessage, toolCalls: assistantMessage.toolCalls.map((call) => ({ ...call })) });
+                        setCurrentStep(nextCall.status === 'succeeded' ? `已完成 ${nextCall.name}，正在整理结果…` : nextCall.status === 'failed' ? `${nextCall.name} 未成功，正在处理错误…` : `正在执行 ${nextCall.name}…`);
+                        addProgress(`tool-result:${id}:${nextCall.status}`, `${nextCall.status === 'succeeded' ? '已完成' : nextCall.status === 'cancelled' ? '已取消' : '执行失败'} · ${nextCall.name}`);
                     }
                     break;
                 }
@@ -135,6 +193,7 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                             ...(typeof input.defaultValue === 'string' ? { defaultValue: input.defaultValue } : {}),
                         });
                         setCurrentStep('等待你的回答...');
+                        addProgress(`waiting:${effectId}`, '等待你的回答…');
                         break;
                     }
                     setAskRequest(null);
@@ -162,6 +221,7 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                         ...(tools.length ? { tools } : {}),
                     });
                     setCurrentStep('等待用户审批...');
+                    addProgress(`approval:${effectId}`, `等待审批 · ${tools.map((tool) => tool.name).join('、') || '系统操作'}`);
                     break;
                 }
                 case 'fact':
@@ -181,6 +241,29 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                                         ...(typeof item.activity === 'string' ? { activity: item.activity } : {}),
                                     }];
                             }));
+                            const activeLanes = fact.lanes.filter((lane) => typeof lane.status === 'string' && !['succeeded', 'failed', 'cancelled'].includes(lane.status));
+                            const active = activeLanes.find((lane) => lane.activityKind === 'tool') ?? activeLanes[0];
+                            if (active && typeof active.goal === 'string') {
+                                const toolName = active.activityKind === 'tool' && typeof active.activity === 'string' ? active.activity : undefined;
+                                const activity = toolName ? `正在调用工具 · ${toolName}` : typeof active.activity === 'string'
+                                    ? active.activity === 'llm' ? '正在分析需求和已有证据…' : '正在处理任务…'
+                                    : '正在处理任务…';
+                                setCurrentStep(`${activity}：${active.goal}`);
+                                const activityId = toolName
+                                    ? (typeof active.activityEffectId === 'string' ? active.activityEffectId : active.id)
+                                    : active.activity === 'llm' ? 'analysis' : `${active.id}:${active.status}`;
+                                addProgress(`activity:${activityId}`, activity);
+                                if (toolName && typeof active.activityToolCallId === 'string') {
+                                    const id = active.activityToolCallId;
+                                    const calls = assistantMessage.toolCalls ?? [];
+                                    const index = calls.findIndex((call) => call.id === id);
+                                    const nextCall = { id, name: toolName, status: 'running', arguments: {} };
+                                    assistantMessage.toolCalls = index >= 0
+                                        ? calls.map((call, callIndex) => callIndex === index ? { ...call, ...nextCall } : call)
+                                        : [...calls, nextCall];
+                                    addAssistantMessage({ ...assistantMessage, toolCalls: assistantMessage.toolCalls.map((call) => ({ ...call })) });
+                                }
+                            }
                             break;
                         }
                     }
@@ -189,6 +272,11 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                         setCurrentStep(describeFactStatus(event.data));
                     break;
                 case 'error':
+                    addProgress('finished', '运行遇到错误。');
+                    if (assistantStarted && assistantMessage.text) {
+                        assistantMessage.streamStatus = 'incomplete';
+                        addAssistantMessage({ ...assistantMessage, toolCalls: assistantMessage.toolCalls?.map((call) => ({ ...call })) });
+                    }
                     setError(String(event.data ?? '发生未知错误'));
                     setIsRunning(false);
                     setCurrentStep(null);
@@ -197,22 +285,32 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                     setLanes([]);
                     break;
                 case 'complete':
+                    addProgress('finished', event.data && typeof event.data === 'object' && !Array.isArray(event.data) && event.data.status === 'succeeded' ? '任务处理完成。' : '任务已结束。');
                     setIsRunning(false);
                     setCurrentStep(null);
                     setApprovalRequest(null);
                     setAskRequest(null);
                     if (event.data && typeof event.data === 'object' && !Array.isArray(event.data)) {
                         const completion = event.data;
+                        const accepted = completion.status === 'succeeded' && (!completion.taskOutcome || (typeof completion.taskOutcome === 'object' && completion.taskOutcome !== null && completion.taskOutcome.status === 'accepted'));
+                        if (assistantStarted && assistantMessage.text) {
+                            assistantMessage.streamStatus = accepted ? 'complete' : 'incomplete';
+                            addAssistantMessage({ ...assistantMessage, toolCalls: assistantMessage.toolCalls?.map((call) => ({ ...call })) });
+                        }
                         const usage = completion.usage && typeof completion.usage === 'object' && !Array.isArray(completion.usage)
                             ? completion.usage
                             : undefined;
                         if (usage) {
                             const input = typeof usage.inputTokens === 'number' ? usage.inputTokens.toLocaleString() : '未知';
                             const output = typeof usage.outputTokens === 'number' ? usage.outputTokens.toLocaleString() : '未知';
+                            const reasoning = typeof usage.reasoningTokens === 'number' ? usage.reasoningTokens.toLocaleString() : '未知';
+                            const visibleChars = typeof usage.visibleOutputChars === 'number' ? usage.visibleOutputChars.toLocaleString() : '未知';
+                            const modelCalls = typeof usage.modelCalls === 'number' ? usage.modelCalls.toLocaleString() : '未知';
+                            const truncations = typeof usage.truncationEvents === 'number' ? usage.truncationEvents.toLocaleString() : '未知';
                             const costs = Array.isArray(usage.providerCosts) ? usage.providerCosts.filter((item) => Boolean(item && typeof item === 'object' && typeof item.currency === 'string' && typeof item.amount === 'number')) : [];
                             const estimate = usage.estimatedCost && typeof usage.estimatedCost === 'object' ? usage.estimatedCost : undefined;
                             const costLabel = costs.length ? costs.map((item) => `${item.amount} ${item.currency}`).join(', ') : estimate && typeof estimate.amount === 'number' ? `估算 ${estimate.amount} ${String(estimate.currency)} (价格 ${String(estimate.pricingVersion)})` : '费用未知';
-                            addAssistantMessage({ id: `run-usage-${run.id}`, role: 'system', text: `用量：输入 ${input} · 输出 ${output} · ${costLabel}${usage.completeness === 'partial' ? ' · 数据不完整' : ''}`, createdAt: new Date().toISOString(), runId: run.id });
+                            addAssistantMessage({ id: `run-usage-${run.id}`, role: 'system', text: `用量：输入 ${input} · 输出 ${output} · 思考 ${reasoning} · 可见字符 ${visibleChars} · 模型调用 ${modelCalls} · 截断 ${truncations} · ${costLabel}${usage.completeness === 'partial' ? ' · 数据不完整' : ''}`, createdAt: new Date().toISOString(), runId: run.id });
                         }
                         const taskOutcome = completion.taskOutcome && typeof completion.taskOutcome === 'object' && !Array.isArray(completion.taskOutcome)
                             ? completion.taskOutcome
@@ -270,7 +368,7 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
         }
         setIsRunning(true);
         setError(null);
-        setCurrentStep('思考中...');
+        setCurrentStep('正在理解你的需求并安排执行步骤…');
         try {
             const run = await host.sendMessage(activeConversationId, { text });
             await consumeRun(run);
@@ -288,7 +386,7 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
             return;
         setIsRunning(true);
         setError(null);
-        setCurrentStep('正在恢复未完成的运行...');
+        setCurrentStep('正在恢复任务进度…');
         try {
             const run = await host.resumeRun(activeConversationId);
             await consumeRun(run);

package/dist/hooks/useSlashCommands.d.ts

@@ -1,12 +1,12 @@
 import type { SlashCommand } from '../types.js';
 export interface SlashCommandDependencies {
     onMouse?: (args: string) => void | Promise<void>;
+    onCopy?: () => void | Promise<void>;
     onHelp?: () => void | Promise<void>;
     onStatus?: () => void | Promise<void>;
     onTools?: () => void | Promise<void>;
     onArtifacts?: () => void | Promise<void>;
     onExit?: () => void | Promise<void>;
-    onQuit?: () => void | Promise<void>;
     onCancel?: () => void | Promise<void>;
     onNew?: () => void | Promise<void>;
     onResume?: () => void | Promise<void>;

package/dist/hooks/useSlashCommands.js

@@ -2,12 +2,12 @@ import { useMemo, useCallback } from 'react';
 export function useSlashCommands(deps) {
     const commands = useMemo(() => [
         { name: '/mouse', description: '滚轮和触控板滚动 [on|off]', execute: async (args) => deps.onMouse?.(args) },
+        { name: '/copy', description: '复制选区或最近一条完整回复', execute: async () => deps.onCopy?.() },
         { 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: '/cancel', aliases: ['/stop'], description: '取消当前运行（保留会话）', execute: async () => deps.onCancel?.() },
         { name: '/new', description: '开启新会话', execute: async () => deps.onNew?.() },
         { name: '/resume', description: '恢复上一次会话或未完成运行', execute: async () => deps.onResume?.() },

package/dist/types.d.ts

@@ -16,6 +16,7 @@ export interface DisplayMessage {
     id: string;
     role: MessageRole;
     text: string;
+    streamStatus?: 'streaming' | 'complete' | 'incomplete' | undefined;
     runId?: string | undefined;
     createdAt: string;
     /** 工具调用事件 */

package/dist/utils/clipboard.d.ts

@@ -0,0 +1,14 @@
+interface ClipboardCommand {
+    file: string;
+    args: string[];
+}
+export declare function isCopyShortcut(input: string, key: {
+    ctrl?: boolean;
+    meta?: boolean;
+}): boolean;
+export declare function clipboardCommands(platform?: NodeJS.Platform): ClipboardCommand[];
+/** Remove characters that look blank but become troublesome when pasted. */
+export declare function sanitizeClipboardText(text: string): string;
+/** Copy the complete plain-text payload through the host OS clipboard utility. */
+export declare function copyToClipboard(text: string): Promise<void>;
+export {};

package/dist/utils/clipboard.js

@@ -0,0 +1,49 @@
+import { spawn } from 'node:child_process';
+import { stripTerminalControls } from './ansi.js';
+export function isCopyShortcut(input, key) {
+    const value = input.toLowerCase();
+    return (key.meta === true && value === 'c') || (key.ctrl === true && (value === 'c' || input === '\u0003'));
+}
+export function clipboardCommands(platform = process.platform) {
+    if (platform === 'darwin')
+        return [{ file: 'pbcopy', args: [] }];
+    if (platform === 'win32')
+        return [{ file: 'clip.exe', args: [] }];
+    if (platform === 'linux')
+        return [{ file: 'wl-copy', args: [] }, { file: 'xclip', args: ['-selection', 'clipboard'] }];
+    return [];
+}
+/** Remove characters that look blank but become troublesome when pasted. */
+export function sanitizeClipboardText(text) {
+    return stripTerminalControls(text)
+        .replace(/\r\n?/g, '\n')
+        .replace(/[\u00A0\u202F]/g, ' ')
+        .replace(/[\u00AD\u200B\u2060\uFEFF]/g, '');
+}
+/** Copy the complete plain-text payload through the host OS clipboard utility. */
+export async function copyToClipboard(text) {
+    const cleanText = sanitizeClipboardText(text);
+    const commands = clipboardCommands();
+    if (!commands.length)
+        throw new Error('CLIPBOARD_UNSUPPORTED');
+    let lastError;
+    for (const command of commands) {
+        try {
+            await new Promise((resolve, reject) => {
+                const child = spawn(command.file, command.args, { stdio: ['pipe', 'ignore', 'pipe'] });
+                let stderr = '';
+                child.stderr.setEncoding('utf8');
+                child.stderr.on('data', (chunk) => { stderr += chunk; });
+                child.once('error', reject);
+                child.once('close', (code) => code === 0 ? resolve() : reject(new Error(stderr.trim() || `${command.file} exited with ${code}`)));
+                child.stdin.once('error', reject);
+                child.stdin.end(cleanText);
+            });
+            return;
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    throw Object.assign(new Error('CLIPBOARD_UNAVAILABLE'), { cause: lastError });
+}

package/dist/utils/inputHistory.d.ts

@@ -0,0 +1,11 @@
+export interface InputHistoryState {
+    entries: string[];
+    position: number | null;
+    draft: string;
+}
+export declare const emptyInputHistory: () => InputHistoryState;
+export declare function rememberInput(state: InputHistoryState, value: string): InputHistoryState;
+export declare function navigateInputHistory(state: InputHistoryState, direction: 'up' | 'down', currentValue: string): {
+    state: InputHistoryState;
+    value?: string;
+};

package/dist/utils/inputHistory.js

@@ -0,0 +1,24 @@
+export const emptyInputHistory = () => ({ entries: [], position: null, draft: '' });
+export function rememberInput(state, value) {
+    if (!value.trim())
+        return { ...state, position: null, draft: '' };
+    return { entries: [...state.entries, value].slice(-50), position: null, draft: '' };
+}
+export function navigateInputHistory(state, direction, currentValue) {
+    if (!state.entries.length)
+        return { state };
+    if (direction === 'up') {
+        const position = state.position === null
+            ? state.entries.length - 1
+            : Math.max(0, state.position - 1);
+        const draft = state.position === null ? currentValue : state.draft;
+        return { state: { ...state, position, draft }, value: state.entries[position] };
+    }
+    if (state.position === null)
+        return { state };
+    if (state.position < state.entries.length - 1) {
+        const position = state.position + 1;
+        return { state: { ...state, position }, value: state.entries[position] };
+    }
+    return { state: { ...state, position: null, draft: '' }, value: state.draft };
+}

package/dist/utils/mouse.d.ts

@@ -1,6 +1,11 @@
-/** SGR mouse reporting. Ink removes the first ESC before delivering unknown keys. */
-export declare function mouseEvent(input: string): {
+export interface TerminalMouseEvent {
+    x: number;
+    y: number;
+    button: number;
+    phase: 'press' | 'drag' | 'release' | 'wheel';
     wheel: number;
-} | undefined;
-export declare const enableMouse = "\u001B[?1000h\u001B[?1006h";
-export declare const disableMouse = "\u001B[?1006l\u001B[?1000l";
+}
+/** SGR mouse reporting. Ink removes the first ESC before delivering unknown keys. */
+export declare function mouseEvent(input: string): TerminalMouseEvent | undefined;
+export declare const enableMouse = "\u001B[?1002h\u001B[?1006h";
+export declare const disableMouse = "\u001B[?1006l\u001B[?1002l";

package/dist/utils/mouse.js

@@ -1,11 +1,21 @@
 /** SGR mouse reporting. Ink removes the first ESC before delivering unknown keys. */
 export function mouseEvent(input) {
-    const match = /^(?:\x1b)?\[<(\d+);\d+;\d+([Mm])$/.exec(input);
+    const match = /^(?:\x1b)?\[<(\d+);(\d+);(\d+)([Mm])$/.exec(input);
     if (!match)
         return undefined;
     const button = Number(match[1]);
+    const x = Number(match[2]) - 1;
+    const y = Number(match[3]) - 1;
+    const final = match[4];
     const base = button & ~28; // Shift, Alt and Ctrl modifiers do not change direction.
-    return { wheel: match[2] === 'M' && base === 64 ? -3 : match[2] === 'M' && base === 65 ? 3 : 0 };
+    if (base === 64 || base === 65)
+        return { x, y, button, phase: 'wheel', wheel: base === 64 ? -3 : 3 };
+    if (final === 'm' || (button & 3) === 3)
+        return { x, y, button, phase: 'release', wheel: 0 };
+    if ((button & 32) !== 0)
+        return { x, y, button, phase: 'drag', wheel: 0 };
+    return { x, y, button, phase: 'press', wheel: 0 };
 }
-export const enableMouse = '\x1b[?1000h\x1b[?1006h';
-export const disableMouse = '\x1b[?1006l\x1b[?1000l';
+// Button-event tracking reports press/release/drag while retaining wheel events.
+export const enableMouse = '\x1b[?1002h\x1b[?1006h';
+export const disableMouse = '\x1b[?1006l\x1b[?1002l';

package/dist/utils/selection.d.ts

@@ -0,0 +1,13 @@
+export interface TextPoint {
+    line: number;
+    column: number;
+}
+export interface TextSelection {
+    start: TextPoint;
+    end: TextPoint;
+}
+export declare function orderedSelection(selection: TextSelection): TextSelection;
+/** Returns the visible text rows in selection order, with terminal styling removed. */
+export declare function selectedText(lines: readonly string[], selection: TextSelection): string;
+/** Adds a calm, high-contrast selection without terminal reverse-video. */
+export declare function selectedLine(line: string, lineIndex: number, selection?: TextSelection): string;

package/dist/utils/selection.js

@@ -0,0 +1,107 @@
+import { stripTerminalControls } from './ansi.js';
+import chalk from 'chalk';
+function pointOrder(a, b) {
+    return a.line - b.line || a.column - b.column;
+}
+export function orderedSelection(selection) {
+    return pointOrder(selection.start, selection.end) <= 0
+        ? selection
+        : { start: selection.end, end: selection.start };
+}
+function isCombining(character) {
+    return /[\p{Mark}\u200D\uFE0E\uFE0F]/u.test(character);
+}
+function isWide(codePoint) {
+    return codePoint >= 0x1100 && (codePoint <= 0x115f || codePoint === 0x2329 || codePoint === 0x232a ||
+        (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+        (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+        (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+        (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+        (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||
+        (codePoint >= 0x20000 && codePoint <= 0x3fffd));
+}
+function width(character) {
+    if (isCombining(character))
+        return 0;
+    const codePoint = character.codePointAt(0) ?? 0;
+    return isWide(codePoint) ? 2 : 1;
+}
+function indexAtColumn(text, column) {
+    let cells = 0;
+    let index = 0;
+    for (const character of text) {
+        const next = cells + width(character);
+        if (column < next)
+            return index;
+        cells = next;
+        index += character.length;
+    }
+    return text.length;
+}
+function indexAfterCellAtColumn(text, column) {
+    let cells = 0;
+    let index = 0;
+    for (const character of text) {
+        const next = cells + width(character);
+        if (column < next)
+            return index + character.length;
+        cells = next;
+        index += character.length;
+    }
+    return text.length;
+}
+function rawOffsetAtVisibleIndex(raw, target) {
+    const control = /^(?:\u001B\][\s\S]*?(?:\u0007|\u001B\\)|[\u001B\u009B][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001B[@-_])/u;
+    let offset = 0;
+    let visible = 0;
+    while (offset < raw.length) {
+        if (visible >= target)
+            return offset;
+        const remaining = raw.slice(offset);
+        const escape = control.exec(remaining);
+        if (escape) {
+            offset += escape[0].length;
+            continue;
+        }
+        const codePoint = raw.codePointAt(offset);
+        const character = String.fromCodePoint(codePoint);
+        if (!/[\u0000-\u001f\u007f-\u009f]/u.test(character))
+            visible += character.length;
+        offset += character.length;
+    }
+    return raw.length;
+}
+/** Returns the visible text rows in selection order, with terminal styling removed. */
+export function selectedText(lines, selection) {
+    const ordered = orderedSelection(selection);
+    const firstLine = Math.max(0, Math.min(lines.length - 1, ordered.start.line));
+    const lastLine = Math.max(firstLine, Math.min(lines.length - 1, ordered.end.line));
+    const result = [];
+    for (let line = firstLine; line <= lastLine; line++) {
+        const plain = stripTerminalControls(lines[line] ?? '');
+        const from = line === firstLine ? ordered.start.column : 0;
+        const start = indexAtColumn(plain, from);
+        const end = line === lastLine ? indexAfterCellAtColumn(plain, ordered.end.column) : plain.length;
+        result.push(plain.slice(Math.min(start, end), Math.max(start, end)));
+    }
+    return result.join('\n');
+}
+/** Adds a calm, high-contrast selection without terminal reverse-video. */
+export function selectedLine(line, lineIndex, selection) {
+    if (!selection)
+        return line;
+    const plain = stripTerminalControls(line);
+    const ordered = orderedSelection(selection);
+    if (lineIndex < ordered.start.line || lineIndex > ordered.end.line)
+        return line;
+    const from = lineIndex === ordered.start.line ? ordered.start.column : 0;
+    const start = indexAtColumn(plain, from);
+    const end = lineIndex === ordered.end.line ? indexAfterCellAtColumn(plain, ordered.end.column) : plain.length;
+    const mark = chalk.bgHex('#DDF4F1').hex('#173B3A');
+    const rawStart = rawOffsetAtVisibleIndex(line, start);
+    const rawEnd = rawOffsetAtVisibleIndex(line, end);
+    return `${line.slice(0, rawStart)}${mark(plain.slice(start, end))}${line.slice(rawEnd)}`;
+}

package/dist/utils/transcript.js

@@ -6,25 +6,58 @@ import { renderMarkdownToAnsi } from './markdown.js';
 export function transcriptLines(messages, width, verbosity = 'normal') {
     const blocks = messages.map((message) => {
         const text = stripTerminalControls(message.text);
-        if (message.role === 'user')
-            return chalk.cyan(`你 › ${text}`);
+        const contentWidth = Math.max(8, width - 2);
         if (message.role === 'system')
-            return chalk.dim(text);
+            return { id: message.id, role: message.role, lines: wrapAnsi(chalk.dim(`· ${text}`), Math.max(8, width), { hard: true, trim: true }).split('\n') };
+        if (message.role === 'user') {
+            const body = wrapAnsi(text, contentWidth, { hard: true, trim: false }).split('\n');
+            return { id: message.id, role: message.role, lines: [chalk.blue.bold('❯ 你发来'), ...body.map((line) => `  ${line}`)] };
+        }
         const parts = [];
         const tools = message.toolCalls ?? [];
         if (verbosity !== 'quiet' && tools.length) {
             const failed = tools.filter((tool) => tool.status === 'failed' || tool.status === 'cancelled');
             parts.push(chalk.dim(`工具 · ${tools.filter((tool) => tool.status === 'succeeded').length}/${tools.length} 已完成${failed.length ? ` · ${failed.length} 未成功` : ''}`));
-            for (const tool of verbosity === 'verbose' ? tools : failed) {
-                const detail = `${tool.name} · ${tool.status}${verbosity === 'verbose' ? `\n${JSON.stringify(tool.arguments ?? {}, null, 2)}` : ''}${tool.result === undefined ? '' : `\n${typeof tool.result === 'string' ? tool.result : JSON.stringify(tool.result, null, 2)}`}`;
-                parts.push(chalk.dim(stripTerminalControls(detail)));
+            const statusLabel = { running: '正在调用', succeeded: '已完成', failed: '失败', cancelled: '已取消' };
+            if (verbosity === 'verbose') {
+                for (const tool of tools) {
+                    const detail = `${tool.name} · ${statusLabel[tool.status]}\n${JSON.stringify(tool.arguments ?? {}, null, 2)}${tool.result === undefined ? '' : `\n${typeof tool.result === 'string' ? tool.result : JSON.stringify(tool.result, null, 2)}`}`;
+                    parts.push(chalk.dim(stripTerminalControls(detail)));
+                }
+            }
+            else {
+                const groups = new Map();
+                for (const tool of tools) {
+                    const result = tool.result && typeof tool.result === 'object' && !Array.isArray(tool.result) ? tool.result : undefined;
+                    const error = tool.status === 'failed' || tool.status === 'cancelled'
+                        ? [result?.code, result?.message].filter((value) => typeof value === 'string').at(-1)
+                        : undefined;
+                    const key = `${tool.name}\0${tool.status}\0${error ?? ''}`;
+                    const group = groups.get(key);
+                    if (group)
+                        group.count++;
+                    else
+                        groups.set(key, { name: tool.name, status: tool.status, count: 1, ...(error ? { error } : {}) });
+                }
+                for (const group of groups.values()) {
+                    parts.push(chalk.dim(`${group.name}${group.count > 1 ? ` × ${group.count}` : ''} · ${statusLabel[group.status]}${group.error ? ` · ${group.error}` : ''}`));
+                }
             }
         }
         if (text)
-            parts.push(chalk.cyan.bold('Pulse'), renderMarkdownToAnsi(text));
-        return parts.join('\n');
-    }).filter(Boolean);
-    return wrapAnsi(blocks.join('\n\n'), Math.max(8, width), { hard: true, trim: false }).split('\n');
+            parts.push(renderMarkdownToAnsi(text));
+        const body = wrapAnsi(parts.join('\n'), contentWidth, { hard: true, trim: false }).split('\n');
+        const streamLabel = message.streamStatus === 'streaming' ? chalk.yellow(' · 正在生成') : message.streamStatus === 'incomplete' ? chalk.red(' · 未完成') : '';
+        return { id: message.id, role: message.role, lines: [chalk.cyan.bold('Pulse') + streamLabel, ...body.map((line) => `  ${line}`)] };
+    }).filter((block) => block.lines.length > 0);
+    return blocks.flatMap((block, index) => {
+        if (index === blocks.length - 1)
+            return block.lines;
+        const next = blocks[index + 1];
+        const isLiveActivity = (item) => item.role === 'system' && item.id.startsWith('run-activity-');
+        const separator = isLiveActivity(block) || isLiveActivity(next) ? [] : [''];
+        return [...block.lines, ...separator];
+    });
 }
 export function scrollAction(input, key) {
     if (key.pageUp || (key.ctrl && input === 'p'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A local-first AI task assistant for coding, research, and file workflows.",
   "keywords": [
     "ai",
@@ -35,7 +35,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.2.0",
+    "@hunterzhu/pulse-server": "0.3.0",
     "chalk": "^5.4.1",
     "highlight.js": "^11.10.0",
     "ink": "^7.1.1",

package/scripts/postinstall.mjs

@@ -1,11 +1,58 @@
 import { ensurePulseUserConfig, defaultPulseConfigPath } from '../dist/config.js'
 
+// Install-time welcome screen. Colors stay off for piped or captured install
+// logs and can be forced with FORCE_COLOR for debugging.
+const colorEnabled =
+  process.env.NO_COLOR === undefined &&
+  process.env.FORCE_COLOR !== '0' &&
+  (process.stdout.isTTY === true || process.env.FORCE_COLOR !== undefined)
+
+const paint = (code) => (text) => (colorEnabled ? `\u001b[${code}m${text}\u001b[0m` : text)
+const cyan = paint('36')
+const bold = paint('1')
+const dim = paint('2')
+
+const banner = [
+  '██████╗ ██╗   ██╗██╗     ███████╗███████╗',
+  '██╔══██╗██║   ██║██║     ██╔════╝██╔════╝',
+  '██████╔╝██║   ██║██║     ███████╗█████╗  ',
+  '██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  ',
+  '██║     ╚██████╔╝███████╗███████║███████╗',
+  '╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝',
+].map((line) => cyan(line)).join('\n')
+
+function printWelcome({ configPath, error } = {}) {
+  const lines = [
+    '',
+    banner,
+    '',
+    `  ${bold('Pulse')} - a neural-signal like AI assistant for coding, research and file tasks.`,
+    '',
+    `  ${dim('Get started:')}`,
+    `    ${cyan('cd project_dir')}`,
+    `    ${cyan('pulse')}`,
+    '',
+  ]
+
+  if (configPath) {
+    // Print the fully resolved absolute path on its own, uncolored line so it
+    // can be copied straight out of the terminal without ANSI escape codes.
+    lines.push(`  ${dim('Config ready at')}`)
+    lines.push(`    ${configPath}`)
+  } else {
+    lines.push(`  ${dim('Config not created:')} ${error}`)
+    lines.push(`  ${dim('Run "pulse setup" later to create it.')}`)
+  }
+
+  lines.push('')
+  console.log(lines.join('\n'))
+}
+
 try {
   const configPath = defaultPulseConfigPath()
   await ensurePulseUserConfig(configPath)
-  console.log(`Pulse config is ready at ${configPath}`)
+  printWelcome({ configPath })
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error)
-  console.warn(`Pulse could not create its default config: ${message}`)
-  console.warn('Run "pulse setup" later to create it.')
+  printWelcome({ error: message })
 }