@hunterzhu/pulse-cli 0.3.0 → 0.4.1

package/README.md

@@ -1,5 +1,9 @@
 # @hunterzhu/pulse-cli
 
+[简体中文](https://github.com/zhuhengtan/Pulse/blob/main/packages/cli/README.zh-CN.md)
+
+[Changelog](https://github.com/zhuhengtan/Pulse/blob/main/CHANGELOG.en.md)
+
 **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+.
@@ -9,7 +13,7 @@ Pulse runs in your project folder, keeps conversations on your machine, and can
 Install the CLI globally so the `pulse` command is on your `PATH`:
 
 ```bash
-npm install -g @hunterzhu/pulse-cli
+npm install -g @hunterzhu/pulse-cli --foreground-scripts
 pulse --version
 ```
 
@@ -49,6 +53,10 @@ pulse --read-only
 
 See `pulse --help` for all options.
 
+## License
+
+This package is licensed under [PolyForm Noncommercial 1.0.0](./LICENSE). Commercial use requires separate permission. This is a source-available noncommercial license, not an OSI-approved open-source license.
+
 ## Links
 
 - [Full CLI configuration guide](https://github.com/zhuhengtan/Pulse/blob/main/docs/cli-config.md)

package/dist/bin.js

@@ -16,6 +16,7 @@ import { runServiceCommand } from './commands/service.js';
 import { runTemplateCommand } from './commands/template.js';
 import { runMcpDoctor } from './commands/mcp.js';
 import { isSameModulePath } from './utils/is-main-module.js';
+import { formatVersionOutput, shouldUseColor } from './presentation.js';
 const packageManifest = createRequire(import.meta.url)('../package.json');
 export const version = packageManifest.version;
 process.stdout.on('error', (error) => {
@@ -46,7 +47,6 @@ Options:
   --max-output-tokens <n>   maximum generated tokens (default 4096)
   --reasoning-effort <x>    low, medium, or high
   --max-turns <n>           maximum ReAct model/tool turns (default 32)
-  --execution-mode <mode>   serial (default) or parallel-read (up to three read-only lanes)
   --auto-compact-percent <n> compact automatically at this percent of the context window (1-90, default 90)
   --format <text|jsonl>     output format
   --resume                  enter the latest saved session
@@ -234,9 +234,6 @@ export async function hostOptions(parsed) {
             ? 'auto'
             : requestedApprovalMode === 'ask' ? 'ask' : config.approvalMode;
     const allowNetwork = parsed.options['no-network'] === true ? false : parsed.options['allow-network'] === true || process.env.PULSE_ALLOW_NETWORK === '1' ? true : config.allowNetwork;
-    const executionMode = option(parsed.options, 'execution-mode') ?? process.env.PULSE_EXECUTION_MODE ?? config.executionMode ?? 'serial';
-    if (executionMode !== 'serial' && executionMode !== 'parallel-read')
-        throw new Error('INVALID_EXECUTION_MODE: expected serial or parallel-read');
     const capabilitySettings = config.capabilities ?? {};
     const skillRoots = capabilitySettings.trustedSkillRoots ?? [];
     if (!Array.isArray(skillRoots) || skillRoots.some((root) => typeof root !== 'string' || !isAbsolute(expandHome(root) ?? root)))
@@ -305,7 +302,7 @@ export async function hostOptions(parsed) {
         ...(taskRouting === undefined ? {} : { taskRouting }),
         capabilityPacks,
         enabledCapabilityPacks,
-        capabilityConfig: { skills: skillNames },
+        capabilityConfig: capabilitySettings.skills === undefined ? {} : { skills: skillNames },
         activeProviderCode: providerName,
         activeModel: activeModelName,
         ...(mockResponse === undefined ? {} : { mockResponse }),
@@ -315,7 +312,6 @@ export async function hostOptions(parsed) {
         ...(configuredAutoCompactPercent === undefined ? {} : { autoCompactPercent: Math.min(90, configuredAutoCompactPercent) }),
         ...(allowNetwork === undefined ? {} : { allowNetwork }),
         ...(config.networkHosts === undefined ? {} : { networkHosts: config.networkHosts }),
-        executionMode,
     };
 }
 export async function main() {
@@ -325,7 +321,9 @@ export async function main() {
         return 0;
     }
     if (parsed.options.version || parsed.options.v) {
-        process.stdout.write(`${version}\n`);
+        process.stdout.write(formatVersionOutput(version, {
+            color: parsed.options['no-color'] !== true && shouldUseColor(process.env, process.stdout.isTTY === true),
+        }));
         return 0;
     }
     if (parsed.command === 'setup') {

package/dist/components/App.js

@@ -18,11 +18,14 @@ 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';
+import { skillSuggestions } from '../utils/slashCompletion.js';
 export function App({ hostOptions, conversationId: initialConversationId, initialTask, resumeOnStart = false, version, }) {
     const { exit } = useApp();
     const { stdout } = useStdout();
     const [terminalRows, setTerminalRows] = useState(stdout.rows || 24);
     useEffect(() => { const resize = () => setTerminalRows(stdout.rows || 24); stdout.on('resize', resize); return () => { stdout.off('resize', resize); }; }, [stdout]);
+    const [skillNames, setSkillNames] = useState([]);
+    const [skillError, setSkillError] = useState(null);
     const [mode, setMode] = useState('chat');
     const [mouseEnabled, setMouseEnabled] = useState(true);
     const [selectedText, setSelectedText] = useState('');
@@ -38,6 +41,11 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
     const startedTask = useRef(false);
     const startedResume = useRef(false);
     const { host, error: hostError, ready: hostReady } = useHost(hostOptions);
+    const refreshSkills = useCallback(() => {
+        if (host)
+            void host.listSkills().then(names => { setSkillNames(names); setSkillError(null); }, error => setSkillError(String(error)));
+    }, [host]);
+    useEffect(refreshSkills, [refreshSkills]);
     const { conversation, messages, addUserMessage, addAssistantMessage, clearMessages, switchConversation, newConversation, createConversation, error: conversationError, } = useConversation({ host, conversationId: initialConversationId });
     const { isRunning, error: runError, approvalRequest, askRequest, lanes, approvalSubmitting, sendMessage, resumeActive, approveAction, replyAsk, cancelRun, } = useRun({
         host,
@@ -127,7 +135,7 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
             await sendMessage(initialTask, target.id);
         })();
     }, [hostReady, conversation, initialTask, isRunning, addUserMessage, addAssistantMessage, createConversation, sendMessage]);
-    const { executeCommand, isSlashCommand } = useSlashCommands({
+    const { commands, executeCommand, isSlashCommand } = useSlashCommands({
         onMouse: (arg) => setMouseEnabled((current) => arg === 'off' ? false : arg === 'on' ? true : !current),
         onCopy: async () => {
             if (selectedText) {
@@ -455,6 +463,31 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
         if (isSlashCommand(text)) {
             const handled = await executeCommand(text);
             if (!handled) {
+                const token = text.split(/\s+/)[0].slice(1).replace(/^skill:/, '');
+                let currentSkills = skillNames;
+                try {
+                    if (host) {
+                        currentSkills = await host.listSkills();
+                        setSkillNames(currentSkills);
+                        setSkillError(null);
+                    }
+                }
+                catch (error) {
+                    setSkillError(String(error));
+                    return;
+                }
+                if (currentSkills.includes(token)) {
+                    if (isRunning) {
+                        addAssistantMessage({ id: `skill-busy-${Date.now()}`, role: 'system', text: '请等当前任务完成，或使用 /cancel 后再调用技能。', createdAt: new Date().toISOString() });
+                        return;
+                    }
+                    const target = conversation ?? await createConversation();
+                    if (!target)
+                        return;
+                    addUserMessage(text);
+                    await sendMessage(text, target.id);
+                    return;
+                }
                 addAssistantMessage({
                     id: `command-${Date.now()}`,
                     role: 'system',
@@ -470,7 +503,7 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
             addUserMessage(text);
             await sendMessage(text, target.id);
         }
-    }, [isSlashCommand, executeCommand, conversation, createConversation, addUserMessage, sendMessage]);
+    }, [isSlashCommand, executeCommand, conversation, createConversation, addUserMessage, sendMessage, skillNames, isRunning, addAssistantMessage, host]);
     useInput((input, key) => {
         if (isCopyShortcut(input, key)) {
             if (selectedText)
@@ -541,6 +574,6 @@ export function App({ hostOptions, conversationId: initialConversationId, initia
                 }, 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), onRememberInput: rememberUserInput, onNavigateHistory: navigateUserInputHistory, disabled: approvalSubmitting, focus: !approvalSubmitting, placeholder: isRunning ? '运行中也可以输入；/cancel 可取消当前运行...' : '输入消息或 /help...' }) }))] }));
+                } })) : askRequest ? (_jsx(AskPrompt, { request: askRequest, disabled: approvalSubmitting, onReply: (value) => void replyAsk(askRequest.effectId, value) }, askRequest.effectId)) : (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [skillError && _jsxs(Text, { color: "red", children: ["\u6280\u80FD\u7D22\u5F15\u5931\u8D25\uFF1A", skillError] }), _jsx(InputArea, { suggestions: [...commands, ...skillSuggestions(skillNames, commands.flatMap(command => [command, ...(command.aliases ?? []).map(name => ({ name, description: command.description }))]))], onSearchSkills: refreshSkills, 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

@@ -38,6 +38,7 @@ const COMMANDS = [
             { name: '/model [name]', desc: '切换模型' },
             { name: '/thinking [level]', desc: '设置模型思考深度 (low/medium/high/off)' },
             { name: '/compact', desc: '手动压缩历史；默认在上下文 90% 时自动压缩' },
+            { name: '/skill:名称 任务', desc: '按需加载技能；输入 / 搜索，↑↓ 选择，Tab 补全' },
             { name: '/config', desc: '查看当前运行时配置' },
         ],
     },

package/dist/components/InputArea.d.ts

@@ -1,4 +1,7 @@
+import { type SlashSuggestion } from '../utils/slashCompletion.js';
 interface Props {
+    suggestions?: SlashSuggestion[];
+    onSearchSkills?: () => void;
     onSubmit: (text: string) => void;
     onRememberInput: (text: string) => void;
     onNavigateHistory: (direction: 'up' | 'down', currentValue: string) => string | undefined;
@@ -6,5 +9,5 @@ interface Props {
     focus?: boolean;
     placeholder?: string;
 }
-export declare function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus, placeholder }: Props): import("react").JSX.Element;
+export declare function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus, placeholder, suggestions, onSearchSkills }: Props): import("react").JSX.Element;
 export {};

package/dist/components/InputArea.js

@@ -2,15 +2,44 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text, useInput } from 'ink';
 import TextInput from './TextInput.js';
 import { useState } from 'react';
+import { searchSlashSuggestions } from '../utils/slashCompletion.js';
 import { theme } from '../theme.js';
-export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus = true, placeholder }) {
+export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabled, focus = true, placeholder, suggestions = [], onSearchSkills }) {
     const [value, setValue] = useState('');
+    const [completionRevision, setCompletionRevision] = useState(0);
+    const [selected, setSelected] = useState(0);
+    const [dismissed, setDismissed] = useState(false);
+    const matches = dismissed ? [] : searchSlashSuggestions(value, suggestions);
+    const chosen = Math.min(selected, Math.max(0, matches.length - 1));
+    const changeValue = (next) => {
+        if (next.startsWith('/') && !value.startsWith('/'))
+            onSearchSkills?.();
+        setSelected(0);
+        setDismissed(false);
+        setValue(next);
+    };
     const [accumulatedLines, setAccumulatedLines] = useState([]);
     useInput((input, key) => {
         if (disabled || !focus)
             return;
         if (key.ctrl || key.meta || key.pageUp || key.pageDown)
             return;
+        if (matches.length && !accumulatedLines.length) {
+            if (key.escape) {
+                setDismissed(true);
+                return;
+            }
+            if (key.upArrow || key.downArrow) {
+                setSelected(Math.max(0, Math.min(matches.length - 1, chosen + (key.upArrow ? -1 : 1))));
+                return;
+            }
+            if (key.tab) {
+                setValue(`${matches[chosen].name} `);
+                setCompletionRevision(revision => revision + 1);
+                setSelected(0);
+                return;
+            }
+        }
         if (key.return) {
             if (key.shift) {
                 setAccumulatedLines((current) => [...current, value]);
@@ -35,7 +64,7 @@ export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabl
     const restoreInput = (text) => {
         const lines = text.split('\n');
         setAccumulatedLines(lines.slice(0, -1));
-        setValue(lines.at(-1) ?? '');
+        changeValue(lines.at(-1) ?? '');
     };
     const handleSubmit = (text) => {
         if (text.endsWith('\\')) {
@@ -56,5 +85,5 @@ export function InputArea({ onSubmit, onRememberInput, onNavigateHistory, disabl
     };
     const promptChar = accumulatedLines.length > 0 ? '…' : '›';
     const promptColor = disabled ? theme.dim : theme.primary;
-    return (_jsxs(Box, { flexDirection: "column", children: [accumulatedLines.map((line, idx) => (_jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), _jsx(Text, { children: line })] }, idx))), _jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), disabled ? (_jsx(Text, { color: theme.dim, children: placeholder || '处理中...' })) : (_jsx(TextInput, { focus: focus, value: value, onChange: setValue, placeholder: placeholder || '' }))] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [matches.length > 0 && accumulatedLines.length === 0 && (_jsxs(Box, { flexDirection: "column", children: [matches.slice(Math.max(0, chosen - 5), Math.max(0, chosen - 5) + 6).map(item => (_jsxs(Text, { color: item === matches[chosen] ? theme.primary : theme.dim, children: [item === matches[chosen] ? '› ' : '  ', item.name, "  ", item.description] }, item.name))), _jsxs(Text, { dimColor: true, children: ["\u2191\u2193 \u9009\u62E9 \u00B7 Tab \u8865\u5168 \u00B7 \u8F93\u5165\u4EFB\u52A1\u540E Enter \u53D1\u9001 \u00B7 Esc \u6536\u8D77\uFF08", matches.length, " \u9879\uFF09"] })] })), accumulatedLines.map((line, idx) => (_jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), _jsx(Text, { children: line })] }, idx))), _jsxs(Box, { children: [_jsxs(Text, { color: promptColor, children: [promptChar, " "] }), disabled ? (_jsx(Text, { color: theme.dim, children: placeholder || '处理中...' })) : (_jsx(TextInput, { focus: focus, value: value, onChange: changeValue, placeholder: placeholder || '' }, completionRevision))] })] }));
 }

package/dist/config.d.ts

@@ -47,7 +47,7 @@ export interface PulseCliMcpServer {
 export interface PulseCliCapabilities {
     /** IDs must be explicitly enabled; workspace config cannot enable host extensions. */
     enabled?: string[];
-    /** Names of host-installed skills to load as untrusted instructions. */
+    /** Optional discovery allow-list of skill directory names; omitted discovers all. Bodies load only on invocation. */
     skills?: string[];
     /** Additional absolute roots explicitly trusted by the user for installed skills. */
     trustedSkillRoots?: string[];
@@ -69,8 +69,6 @@ export interface PulseCliConfig {
     taskRouting?: Partial<Record<PulseModelTask, string[]>>;
     capabilities?: PulseCliCapabilities;
     approvalMode?: 'read-only' | 'ask' | 'auto';
-    /** Parallelism is opt-in and only exposes tools explicitly classified read-only. */
-    executionMode?: 'serial' | 'parallel-read';
     maxTurns?: number;
     /** Percent of maxContextTokens that triggers automatic history compaction. Clamped to 1–90. */
     autoCompactPercent?: number;

package/dist/config.js

@@ -24,7 +24,6 @@ export const defaultPulseConfig = {
     },
     activeModel: 'mock',
     approvalMode: 'ask',
-    executionMode: 'serial',
     maxTurns: 32,
     autoCompactPercent: 90,
     allowNetwork: false,

package/dist/hooks/useRun.js

@@ -39,8 +39,14 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
     const [isRunning, setIsRunning] = useState(false);
     const [currentStep, setCurrentStep] = useState(null);
     const [error, setError] = useState(null);
-    const [approvalRequest, setApprovalRequest] = useState(null);
-    const [askRequest, setAskRequest] = useState(null);
+    const [pendingInteractions, setPendingInteractions] = useState([]);
+    const enqueueInteraction = useCallback((item) => {
+        setPendingInteractions((current) => current.some((entry) => entry.request.effectId === item.request.effectId) ? current : [...current, item]);
+    }, []);
+    const removeInteraction = useCallback((effectId) => setPendingInteractions((current) => current.filter((entry) => entry.request.effectId !== effectId)), []);
+    const activeInteraction = pendingInteractions[0];
+    const approvalRequest = activeInteraction?.kind === 'approval' ? activeInteraction.request : null;
+    const askRequest = activeInteraction?.kind === 'ask' ? activeInteraction.request : null;
     const [approvalSubmitting, setApprovalSubmitting] = useState(false);
     const [lanes, setLanes] = useState([]);
     const runRef = useRef(null);
@@ -180,23 +186,21 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                                 return typeof item.label === 'string' && typeof item.value === 'string' ? [{ label: item.label, value: item.value }] : [];
                             })
                             : undefined;
-                        setApprovalRequest(null);
-                        setAskRequest({
-                            effectId,
-                            toolName: typeof input.toolName === 'string' ? input.toolName : `ask.${input.type}`,
-                            type: input.type,
-                            prompt: typeof input.prompt === 'string' ? input.prompt : '请输入你的回答。',
-                            ...(options && options.length ? { options } : {}),
-                            ...(typeof input.min === 'number' ? { min: input.min } : {}),
-                            ...(typeof input.max === 'number' ? { max: input.max } : {}),
-                            ...(typeof input.placeholder === 'string' ? { placeholder: input.placeholder } : {}),
-                            ...(typeof input.defaultValue === 'string' ? { defaultValue: input.defaultValue } : {}),
-                        });
+                        enqueueInteraction({ kind: 'ask', request: {
+                                effectId,
+                                toolName: typeof input.toolName === 'string' ? input.toolName : `ask.${input.type}`,
+                                type: input.type,
+                                prompt: typeof input.prompt === 'string' ? input.prompt : '请输入你的回答。',
+                                ...(options && options.length ? { options } : {}),
+                                ...(typeof input.min === 'number' ? { min: input.min } : {}),
+                                ...(typeof input.max === 'number' ? { max: input.max } : {}),
+                                ...(typeof input.placeholder === 'string' ? { placeholder: input.placeholder } : {}),
+                                ...(typeof input.defaultValue === 'string' ? { defaultValue: input.defaultValue } : {}),
+                            } });
                         setCurrentStep('等待你的回答...');
                         addProgress(`waiting:${effectId}`, '等待你的回答…');
                         break;
                     }
-                    setAskRequest(null);
                     const tools = Array.isArray(input.tools)
                         ? input.tools.flatMap((tool) => {
                             if (!tool || typeof tool !== 'object' || Array.isArray(tool))
@@ -212,14 +216,14 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                         })
                         : [];
                     const firstTool = tools[0];
-                    setApprovalRequest({
-                        effectId,
-                        toolName: tools.length === 1 ? firstTool.name : `${tools.length || 1} 个系统操作`,
-                        toolArgs: firstTool?.input ?? {},
-                        prompt: typeof input.prompt === 'string' ? input.prompt : '是否批准执行？',
-                        ...(typeof input.digest === 'string' ? { digest: input.digest } : {}),
-                        ...(tools.length ? { tools } : {}),
-                    });
+                    enqueueInteraction({ kind: 'approval', request: {
+                            effectId,
+                            toolName: tools.length === 1 ? firstTool.name : `${tools.length || 1} 个系统操作`,
+                            toolArgs: firstTool?.input ?? {},
+                            prompt: typeof input.prompt === 'string' ? input.prompt : '是否批准执行？',
+                            ...(typeof input.digest === 'string' ? { digest: input.digest } : {}),
+                            ...(tools.length ? { tools } : {}),
+                        } });
                     setCurrentStep('等待用户审批...');
                     addProgress(`approval:${effectId}`, `等待审批 · ${tools.map((tool) => tool.name).join('、') || '系统操作'}`);
                     break;
@@ -280,16 +284,14 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                     setError(String(event.data ?? '发生未知错误'));
                     setIsRunning(false);
                     setCurrentStep(null);
-                    setApprovalRequest(null);
-                    setAskRequest(null);
+                    setPendingInteractions([]);
                     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);
+                    setPendingInteractions([]);
                     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'));
@@ -343,12 +345,11 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
                     break;
             }
         }
-    }, [addAssistantMessage]);
+    }, [addAssistantMessage, enqueueInteraction]);
     const finishRun = useCallback(() => {
         setIsRunning(false);
         setCurrentStep(null);
-        setApprovalRequest(null);
-        setAskRequest(null);
+        setPendingInteractions([]);
         runRef.current = null;
     }, []);
     const sendMessage = useCallback(async (text, targetConversationId) => {
@@ -409,7 +410,7 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
         setApprovalSubmitting(true);
         try {
             await runRef.current.reply(effectId, { approved, ...(approved ? {} : { reason: reason || '拒绝执行' }) });
-            setApprovalRequest(null);
+            removeInteraction(effectId);
             setCurrentStep('审批已提交，正在继续...');
             setError(null);
         }
@@ -420,14 +421,14 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
         finally {
             setApprovalSubmitting(false);
         }
-    }, [approvalSubmitting]);
+    }, [approvalSubmitting, removeInteraction]);
     const replyAsk = useCallback(async (effectId, value) => {
         if (!effectId || !runRef.current || approvalSubmitting)
             return;
         setApprovalSubmitting(true);
         try {
             await runRef.current.reply(effectId, value);
-            setAskRequest(null);
+            removeInteraction(effectId);
             setCurrentStep('回答已提交，正在继续...');
             setError(null);
         }
@@ -438,7 +439,7 @@ export function useRun({ host, conversationId, addAssistantMessage, }) {
         finally {
             setApprovalSubmitting(false);
         }
-    }, [approvalSubmitting]);
+    }, [approvalSubmitting, removeInteraction]);
     const cancelRun = useCallback(async () => {
         if (runRef.current) {
             await runRef.current.cancel('USER_CANCELLED');

package/dist/presentation.d.ts

@@ -0,0 +1,11 @@
+export interface PresentationOptions {
+    color?: boolean;
+}
+export declare function shouldUseColor(env: NodeJS.ProcessEnv, isTTY: boolean): boolean;
+export declare function formatVersionOutput(version: string, options?: PresentationOptions): string;
+export interface InstallWelcomeOptions extends PresentationOptions {
+    version: string;
+    configPath?: string;
+    error?: string;
+}
+export declare function formatInstallWelcome(options: InstallWelcomeOptions): string;

package/dist/presentation.js

@@ -0,0 +1,64 @@
+import { releaseHighlights } from './release-highlights.generated.js';
+const bannerLines = [
+    '██████╗ ██╗   ██╗██╗     ███████╗███████╗',
+    '██╔══██╗██║   ██║██║     ██╔════╝██╔════╝',
+    '██████╔╝██║   ██║██║     ███████╗█████╗  ',
+    '██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  ',
+    '██║     ╚██████╔╝███████╗███████║███████╗',
+    '╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝',
+];
+function paint(code, enabled, value) {
+    return enabled ? `\u001b[${code}m${value}\u001b[0m` : value;
+}
+export function shouldUseColor(env, isTTY) {
+    return env.NO_COLOR === undefined && env.FORCE_COLOR !== '0' && (isTTY || env.FORCE_COLOR !== undefined);
+}
+function banner(color) {
+    return bannerLines.map((line) => paint('36', color, line)).join('\n');
+}
+export function formatVersionOutput(version, options = {}) {
+    const color = options.color === true;
+    const highlights = releaseHighlights[version];
+    const lines = [
+        banner(color),
+        '',
+        `  ${paint('1', color, 'Pulse')} ${paint('2', color, `v${version}`)}`,
+        '',
+        `  ${paint('1', color, '本版本亮点 / What’s new in this version')}`,
+    ];
+    if (highlights?.length) {
+        for (const item of highlights)
+            lines.push(`  • ${item.zh}`, `    ${item.en}`);
+    }
+    else {
+        lines.push('  暂无此版本的更新亮点记录。', '  No release highlights are available for this version yet.');
+    }
+    lines.push('');
+    return `${lines.join('\n')}\n`;
+}
+export function formatInstallWelcome(options) {
+    const { color = false, version, configPath, error } = options;
+    const cyan = (value) => paint('36', color, value);
+    const dim = (value) => paint('2', color, value);
+    const lines = [
+        '',
+        banner(color),
+        '',
+        `  ${paint('1', color, 'Pulse')} v${version} — 面向编程、研究与文件工作的 AI 助手`,
+        `  ${paint('1', color, 'Pulse')} — an AI assistant for coding, research, and file tasks`,
+        '',
+        `  ${paint('1', color, '开始使用 / Get started:')}`,
+        `    ${cyan('cd project_dir')}`,
+        `    ${cyan('pulse')}`,
+        '',
+    ];
+    if (configPath) {
+        lines.push(`  ${dim('配置已就绪 / Configuration ready at:')}`, `    ${configPath}`);
+    }
+    else {
+        lines.push(`  ${dim('配置创建失败 / Configuration could not be created:')} ${error ?? 'Unknown error'}`);
+        lines.push(`  ${dim('稍后运行 "pulse setup" 创建配置。 / Run "pulse setup" later to create it.')}`);
+    }
+    lines.push('');
+    return `${lines.join('\n')}\n`;
+}

package/dist/release-highlights.generated.d.ts

@@ -0,0 +1,4 @@
+export declare const releaseHighlights: Record<string, Array<{
+    zh: string;
+    en: string;
+}>>;

package/dist/release-highlights.generated.js

@@ -0,0 +1,117 @@
+// Generated from CHANGELOG.md and CHANGELOG.en.md by scripts/release/sync-cli-highlights.mjs. Do not edit manually.
+export const releaseHighlights = {
+    "0.4.1": [
+        {
+            "zh": "新增按需发现与调用 Skill 的能力，减少无关指令进入任务上下文。",
+            "en": "Added on-demand Skill discovery and invocation to keep unrelated instructions out of task context."
+        },
+        {
+            "zh": "美化安装欢迎界面和版本页，提供中英双语介绍及版本亮点。",
+            "en": "Polished the installation welcome screen and version page with bilingual product information and release highlights."
+        },
+        {
+            "zh": "提供中英文分离的更新日志和双语用户文档，并校验版本亮点来源。",
+            "en": "Added separate Chinese and English changelogs and bilingual user documentation, with validation for version highlights."
+        },
+        {
+            "zh": "为全部五个 npm 包采用 PolyForm Noncommercial 1.0.0，并随包提供许可证说明。",
+            "en": "Licensed all five npm packages under PolyForm Noncommercial 1.0.0 and included package-level license notices."
+        }
+    ],
+    "0.4.0": [
+        {
+            "zh": "默认使用异步并行 event loop，让模型请求、工具调用等副作用并发推进。",
+            "en": "Uses an asynchronous, parallel event loop by default so model requests, tool calls, and other effects can progress concurrently."
+        }
+    ],
+    "0.3.0": [
+        {
+            "zh": "增强 CLI 交互体验，支持内容选择与复制、推理用量归因、任务进度流式展示和可恢复会话。",
+            "en": "Improved CLI interaction with text selection and copying, reasoning-usage attribution, streamed task progress, and resumable sessions."
+        }
+    ],
+    "0.2.1": [
+        {
+            "zh": "增加安装后的欢迎界面，并完善跨平台本地与云端 CI 验证入口。",
+            "en": "Added the post-install welcome screen and improved the shared cross-platform local and cloud CI entry point."
+        }
+    ],
+    "0.2.0": [
+        {
+            "zh": "扩展 CLI 与 Host 能力，完善会话恢复、人机协作、工具调用和 Windows 沙箱及发布验证。",
+            "en": "Expanded CLI and Host capabilities with resumable sessions, human interaction, tool calls, and improved Windows sandbox and release validation."
+        }
+    ],
+    "0.1.11": [
+        {
+            "zh": "修复 Windows 下打包 CLI 入口加载问题，并改进跨平台安装与发布验证。",
+            "en": "Fixed loading the packaged CLI entry point on Windows and improved cross-platform installation and release validation."
+        }
+    ],
+    "0.1.10": [
+        {
+            "zh": "维护性版本发布；未单独记录用户可见更新。",
+            "en": "Maintenance release; no separate user-facing changes were recorded."
+        }
+    ],
+    "0.1.9": [
+        {
+            "zh": "维护性版本发布；未单独记录用户可见更新。",
+            "en": "Maintenance release; no separate user-facing changes were recorded."
+        }
+    ],
+    "0.1.8": [
+        {
+            "zh": "增加 npm 安装后的首次配置初始化流程。",
+            "en": "Added first-run configuration initialization after npm installation."
+        }
+    ],
+    "0.1.7": [
+        {
+            "zh": "增加完整屏幕 CLI 工作区、模型配置与会话交互能力。",
+            "en": "Added a full-screen CLI workspace, model configuration, and interactive session capabilities."
+        }
+    ],
+    "0.1.6": [
+        {
+            "zh": "增加人类输入仲裁和主动 CLI 交互，并强化上下文、持久化与流式工具调用。",
+            "en": "Added human-input arbitration and active CLI interaction, while strengthening context, persistence, and streamed tool calls."
+        }
+    ],
+    "0.1.5": [
+        {
+            "zh": "改进 Provider 工具名称兼容性。",
+            "en": "Improved compatibility of tool names across providers."
+        }
+    ],
+    "0.1.4": [
+        {
+            "zh": "修复 Provider 安全工具名称的适配问题。",
+            "en": "Fixed adapter handling for provider-safe tool names."
+        }
+    ],
+    "0.1.3": [
+        {
+            "zh": "完善 CLI 工具暴露、用户文件目录和 Provider 错误反馈。",
+            "en": "Improved CLI tool exposure, user-file locations, and provider error reporting."
+        }
+    ],
+    "0.1.2": [
+        {
+            "zh": "修复 CLI 显示已安装包版本的问题。",
+            "en": "Fixed CLI reporting of the installed package version."
+        }
+    ],
+    "0.1.1": [
+        {
+            "zh": "完善首次运行配置创建及基础 npm 工作区使用体验。",
+            "en": "Improved first-run configuration setup and basic npm workspace usage."
+        }
+    ],
+    "0.1.0": [
+        {
+            "zh": "建立 Pulse CLI 初始 npm 发布包和仓库发布元数据。",
+            "en": "Established the initial Pulse CLI npm package and repository release metadata."
+        }
+    ]
+};

package/dist/utils/slashCompletion.d.ts

@@ -0,0 +1,6 @@
+export interface SlashSuggestion {
+    name: string;
+    description: string;
+}
+export declare function skillSuggestions(names: readonly string[], commands: readonly SlashSuggestion[]): SlashSuggestion[];
+export declare function searchSlashSuggestions(value: string, items: readonly SlashSuggestion[]): SlashSuggestion[];

package/dist/utils/slashCompletion.js

@@ -0,0 +1,11 @@
+export function skillSuggestions(names, commands) {
+    const reserved = new Set(commands.map(item => item.name.toLowerCase()));
+    return names.map(name => ({ name: reserved.has(`/${name}`.toLowerCase()) ? `/skill:${name}` : `/${name}`, description: '技能 · 提交时加载' }));
+}
+export function searchSlashSuggestions(value, items) {
+    if (!/^\/\S*$/.test(value))
+        return [];
+    const query = value.slice(1).toLowerCase();
+    return items.filter(item => item.name.slice(1).toLowerCase().includes(query))
+        .sort((a, b) => Number(b.name.slice(1).toLowerCase().startsWith(query)) - Number(a.name.slice(1).toLowerCase().startsWith(query)) || a.name.localeCompare(b.name));
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@hunterzhu/pulse-cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "A local-first AI task assistant for coding, research, and file workflows.",
+  "license": "PolyForm-Noncommercial-1.0.0",
   "keywords": [
     "ai",
     "agent",
@@ -27,7 +28,7 @@
     "scripts"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "pnpm --dir ../.. changelog:sync && tsc -p tsconfig.json",
     "postinstall": "node ./scripts/postinstall.mjs"
   },
   "publishConfig": {
@@ -35,7 +36,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@hunterzhu/pulse-server": "0.3.0",
+    "@hunterzhu/pulse-server": "0.4.1",
     "chalk": "^5.4.1",
     "highlight.js": "^11.10.0",
     "ink": "^7.1.1",

package/scripts/postinstall.mjs

@@ -1,58 +1,15 @@
+import { createRequire } from 'node:module'
 import { ensurePulseUserConfig, defaultPulseConfigPath } from '../dist/config.js'
+import { formatInstallWelcome, shouldUseColor } from '../dist/presentation.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'))
-}
+const { version } = createRequire(import.meta.url)('../package.json')
+const color = shouldUseColor(process.env, process.stdout.isTTY === true)
 
 try {
   const configPath = defaultPulseConfigPath()
   await ensurePulseUserConfig(configPath)
-  printWelcome({ configPath })
+  process.stdout.write(formatInstallWelcome({ version, configPath, color }))
 } catch (error) {
   const message = error instanceof Error ? error.message : String(error)
-  printWelcome({ error: message })
+  process.stdout.write(formatInstallWelcome({ version, error: message, color }))
 }