minimal-agent 0.5.3 → 0.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-agent",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "最小化 Agent 系统 —— 10 工具 + 插件系统 + workflow DSL + 自动压缩 + OpenAI 兼容 + Ink TUI；NodeNext + tsc 原地编译，dev 用 Bun .ts、install 用 Node .js（学习/教学用）",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Bill Wang <leiwang0359@gmail.com>",

package/src/loop.js

@@ -107,6 +107,9 @@ export async function* runQuery(userInput, options) {
                     else if (ev.field === 'reasoning_details' && ev.items) {
                         reasoningDetails.push(...ev.items);
                     }
+                    if (ev.delta) {
+                        yield { type: 'reasoning_delta', field: ev.field, delta: ev.delta };
+                    }
                 }
                 // ev.type === 'done' 时无需处理：循环自然结束
             }

package/src/prompts/system.js

@@ -34,6 +34,17 @@ export async function getSystemPrompt(cwd, tools) {
 
 # 思维与立场（核心：像专家一样独立思考）
 - **你是工程协作者，不是奉承者**。不无条件夸赞、不为附和而附和、不同意时直说。不用"很好的问题"、"你说得对"、"完全同意"这类前缀——直接答内容。
+- **先判断用户意图再行动**——这是最重要的第一步，区分以下三种情况：
+  - ✅ **明确执行（直接动手，不要犹豫）**：用户表述包含明确的行动指令。
+    动词特征：「修改/改/调整/修复/优化/更新/替换/删/移除/写/创建/实现/做/生成/新建/开发/执行/跑/运行/提交/部署/安装」
+    确认性指令也算：「对就这么改」「是的按这个方案实现」「好的麻烦改一下」
+  - ❌ **纯讨论（绝对不能动文件，只回答）**：用户只是提问、咨询、探讨、评估。
+    特征：问号结尾、「是不是/怎么样/为什么/好不好/能否/你觉得」、纯观点表达「我觉得...」「这里好像有...」
+    即使你发现明显问题，也只能给文字建议，**禁止调用 Edit/Write/MultiEdit/Bash 写操作等任何修改类工具**
+  - ❓ **模糊场景（仅一次确认，不要啰嗦）**：介于两者之间无法判断时。
+    例：「这个接口响应太慢了」「这个正则好像有问题」
+    只问一句：「你是需要我实际修改/修复，还是只是讨论这个问题？」—— 用户说改就立刻改，说讨论就停
+- **兜底原则**：宁可多问一次也不要擅自修改；但只要用户明确说要改，必须立刻执行，不要二次确认。
 - **基于证据，不基于揣测用户想听什么**。没读过的代码先 Read，没验证过的行为先验证，不凭印象答。回答前先问自己：这个判断有具体证据吗，还是我在猜？
 - **不知道就说不知道**。明确边界："这个版本号我不确定"、"这个 API 我没看过文档"、"这部分行为我没验证过"。胡编一个看起来对的答案，代价远高于承认不知道。
 - **明示 confidence 分层**。结论按确定度分层表达——"已 verify / 高度确信"、"基于代码合理推测"、"未验证猜测"——让用户基于你的不确定程度决策，不要把推测说成事实。

package/src/ui/App.js

@@ -8,7 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * ============================================================
  */
 import React from 'react';
-import { Box, Text } from 'ink';
+import { Box, Text, Static } from 'ink';
 import { saveContext } from '../context/persistContext.js';
 import { InputBox } from './InputBox.js';
 import { MessageList } from './MessageList.js';
@@ -33,5 +33,5 @@ export function App({ provider, initialHistory }) {
         await chat.clearHistory();
         process.stdout.write(CLEAR_SCREEN);
     }, [chat]);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: "minimal-agent" }), _jsx(Text, { color: "gray", children: `  · ${provider.name}/${provider.model} · /new 清空 · /compact 压缩 · /exit 退出 · Ctrl+C 中断` })] }), _jsx(MessageList, { history: chat.history, streamingText: chat.streamingText }), _jsx(ToolStatus, { status: chat.toolStatus, compacting: chat.compacting }), chat.error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["\u26A0 ", chat.error] }) })), chat.interrupted && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "yellow", children: "\u26A1 \u64CD\u4F5C\u88AB\u7528\u6237\u4E2D\u65AD\uFF0C\u7B49\u5F85\u65B0\u7684\u4EFB\u52A1\u8F93\u5165..." }) })), _jsx(InputBox, { onSubmit: chat.submit, disabled: chat.isLoading, onAbort: chat.abort, onClear: handleClear, onCompact: chat.compactNow }), _jsx(StatusLine, { provider: provider, history: chat.history, pluginProgress: chat.pluginProgress })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: [null], children: () => (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "cyan", bold: true, children: "minimal-agent" }), _jsx(Text, { color: "gray", children: `  · ${provider.name}/${provider.model} · /new 清空 · /compact 压缩 · /exit 退出 · Ctrl+C 中断` })] })) }), _jsx(MessageList, { history: chat.history, streamingText: chat.streamingText, streamingReasoning: chat.streamingReasoning }), _jsx(ToolStatus, { status: chat.toolStatus, compacting: chat.compacting }), chat.error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["\u26A0 ", chat.error] }) })), chat.interrupted && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "yellow", children: "\u26A1 \u64CD\u4F5C\u88AB\u7528\u6237\u4E2D\u65AD\uFF0C\u7B49\u5F85\u65B0\u7684\u4EFB\u52A1\u8F93\u5165..." }) })), _jsx(InputBox, { onSubmit: chat.submit, disabled: chat.isLoading, onAbort: chat.abort, onClear: handleClear, onCompact: chat.compactNow }), _jsx(Static, { items: [chat.history.length], children: () => (_jsx(StatusLine, { provider: provider, history: chat.history, pluginProgress: chat.pluginProgress })) })] }));
 }

package/src/ui/MessageList.js

@@ -1,8 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 const MAX_TOOL_PREVIEW_LINES = 3;
-export function MessageList({ history, streamingText }) {
-    return (_jsxs(Box, { flexDirection: "column", children: [history.map((m, i) => (_jsx(MessageRow, { message: m }, i))), streamingText.length > 0 && (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { children: streamingText }), _jsx(Text, { color: "gray", children: " \u258D" })] }))] }));
+export function MessageList({ history, streamingText, streamingReasoning }) {
+    return (_jsxs(Box, { flexDirection: "column", children: [history.map((m, i) => (_jsx(MessageRow, { message: m }, i))), streamingReasoning.length > 0 && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "gray", dimColor: true, children: ["\uD83D\uDCA1 ", streamingReasoning.length > 300
+                            ? `...(${Math.round(streamingReasoning.length / 1000)}K字)${streamingReasoning.slice(-200)}`
+                            : streamingReasoning] }) })), streamingText.length > 0 && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: streamingText }) }))] }));
 }
 function MessageRow({ message }) {
     switch (message.role) {

package/src/ui/hooks/useChat.js

@@ -29,6 +29,7 @@ export function useChat(args) {
     const [version, setVersion] = useState(0);
     const bump = useCallback(() => setVersion((v) => v + 1), []);
     const [streamingText, setStreamingText] = useState('');
+    const [streamingReasoning, setStreamingReasoning] = useState('');
     const [toolStatus, setToolStatus] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
@@ -55,6 +56,49 @@ export function useChat(args) {
         setPluginProgress(null);
         const ac = new AbortController();
         abortRef.current = ac;
+        let streamBuf = '';
+        let reasoningBuf = '';
+        let streamTimer = null;
+        const throttledSetStreamingText = (value) => {
+            streamBuf = typeof value === 'function' ? value(streamBuf) : value;
+            if (!streamTimer) {
+                streamTimer = setInterval(() => {
+                    if (streamBuf.length > 0) {
+                        setStreamingText(streamBuf);
+                    }
+                    if (reasoningBuf.length > 0) {
+                        setStreamingReasoning(reasoningBuf);
+                    }
+                }, 200);
+            }
+        };
+        const throttledSetStreamingReasoning = (value) => {
+            reasoningBuf = typeof value === 'function' ? value(reasoningBuf) : value;
+            if (!streamTimer) {
+                streamTimer = setInterval(() => {
+                    if (streamBuf.length > 0) {
+                        setStreamingText(streamBuf);
+                    }
+                    if (reasoningBuf.length > 0) {
+                        setStreamingReasoning(reasoningBuf);
+                    }
+                }, 200);
+            }
+        };
+        const flushStream = () => {
+            if (streamTimer) {
+                clearInterval(streamTimer);
+                streamTimer = null;
+            }
+            if (streamBuf.length > 0) {
+                setStreamingText(streamBuf);
+                streamBuf = '';
+            }
+            if (reasoningBuf.length > 0) {
+                setStreamingReasoning(reasoningBuf);
+                reasoningBuf = '';
+            }
+        };
         try {
             for await (const ev of runWithPlugins(trimmed, {
                 provider: args.provider,
@@ -62,7 +106,8 @@ export function useChat(args) {
                 signal: ac.signal,
             })) {
                 handleEvent(ev, {
-                    setStreamingText,
+                    setStreamingText: throttledSetStreamingText,
+                    setStreamingReasoning: throttledSetStreamingReasoning,
                     setToolStatus,
                     setCompacting,
                     setError,
@@ -76,8 +121,10 @@ export function useChat(args) {
             setError(`未捕获异常：${e.message}`);
         }
         finally {
+            flushStream();
             setIsLoading(false);
             setStreamingText('');
+            setStreamingReasoning('');
             setToolStatus(null);
             setCompacting(false);
             setPluginProgress(null);
@@ -104,6 +151,7 @@ export function useChat(args) {
         // 允许新 session 再次触发反应式压缩自救
         resetReactiveCompactState();
         setStreamingText('');
+        setStreamingReasoning('');
         setToolStatus(null);
         setError(null);
         setInterrupted(false);
@@ -156,6 +204,7 @@ export function useChat(args) {
     return {
         history,
         streamingText,
+        streamingReasoning,
         toolStatus,
         isLoading,
         error,
@@ -179,11 +228,16 @@ function handleEvent(ev, setters) {
     const e = ev;
     switch (e.type) {
         case 'text':
-            setters.setStreamingText((prev) => prev + e.delta);
+            setters.setStreamingText(prev => prev + e.delta);
+            break;
+        case 'reasoning_delta':
+            if (e.delta) {
+                setters.setStreamingReasoning(prev => prev + e.delta);
+            }
             break;
         case 'assistant_message':
-            // history 已被 runQuery 直接 push，这里只刷一下视图 + 清流式 buffer
-            setters.setStreamingText(() => '');
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.bump();
             break;
         case 'tool_start':
@@ -199,10 +253,8 @@ function handleEvent(ev, setters) {
             setters.bump();
             break;
         case 'compact_start':
-            // reactive 自救场景：LLM 失败前可能已经 yield 过部分 text delta，
-            // 压缩前清掉残留 streamingText，避免重发后新文本追加在旧 buffer 后面。
-            // autoCompact 场景下 streamingText 本来就是空，这里 no-op。
-            setters.setStreamingText(() => '');
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.setCompacting(true);
             setters.bump();
             break;
@@ -215,10 +267,14 @@ function handleEvent(ev, setters) {
             break;
         case 'interrupted':
             setters.setInterrupted(true);
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.bump();
             break;
         case 'error':
             setters.setError(e.error);
+            setters.setStreamingText('');
+            setters.setStreamingReasoning('');
             setters.bump();
             break;
         case 'plugin_progress':