mocode-ai 1.6.0 → 1.6.2

package/dist/tools/tool-runtime.js

@@ -57,6 +57,38 @@ function terminalOutcome(status, code, output, startedAt, changedFiles = []) {
         durationMs: Date.now() - startedAt,
     };
 }
+/**
+ * 幂等工具的瞬时失败自动重试(retryable 契约的唯一消费点)。
+ *
+ * retryable 字段此前全项目零消费者:工具诚实地标了「这是瞬时失败」,却没人据此行动,
+ * 模型只能靠再发一轮 tool call 自救(浪费一个完整 LLM 往返 + 常忘记重试)。
+ * 现在 runtime 在**工具显式声明 idempotent** 时自动重发:
+ * - 只对 capabilities.idempotent=true 的工具(web_fetch/web_search 这类无副作用 GET)生效;
+ *   写/进程类工具永不自动重试 —— 重试语义由工具自己决定(如 edit_file 的 expected_hash 冲突)。
+ * - 只重试 status='error' 且 retryable=true 的结果:denied/aborted 是终态,重试无意义。
+ * - 退避 400ms/1200ms(最多 2 次):429 的 Retry-After 场景通常秒级窗口就够,
+ *   再长会把「工具调用」拖成用户可感知的卡顿;仍失败则把重试次数写进 output,模型可自行决策。
+ * - abort 敏感:等待期间用户 Ctrl+C 立即放弃,不空耗退避窗口。
+ */
+const RETRY_BACKOFF_MS = [400, 1200];
+function sleepWithSignal(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        // onAbort 先声明再被 timer 闭包引用:避免 TDZ 依赖「回调必然异步」这一前提。
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
 function isTransientExecutionError(error) {
     if (!error || typeof error !== 'object')
         return false;
@@ -179,12 +211,42 @@ export class ToolRuntime {
             if (sandboxError) {
                 return terminalOutcome('denied', 'SANDBOX_DENIED', sandboxError, startedAt);
             }
-            return await this.executeToolOnce(tool, args, signal, opts);
+            return await this.executeToolWithRetry(tool, args, signal, opts);
         }
         catch (error) {
             return executionErrorOutcome(name, error, startedAt, []);
         }
     }
+    /**
+     * 幂等工具的自动重试外壳:非幂等工具直接执行一次(与旧行为逐字节一致,零开销)。
+     * 只有 capabilities.idempotent=true 且结果 status='error' + retryable=true 才重发。
+     */
+    async executeToolWithRetry(tool, args, signal, opts) {
+        const capabilities = this.getToolCapabilities(tool);
+        if (!capabilities.idempotent)
+            return this.executeToolOnce(tool, args, signal, opts);
+        let outcome = await this.executeToolOnce(tool, args, signal, opts);
+        for (const backoff of RETRY_BACKOFF_MS) {
+            // 只对瞬时 error 重试;denied/aborted/success 都是终态。abort 后立即停,不空耗退避。
+            if (outcome.status !== 'error' || !outcome.retryable || signal?.aborted)
+                break;
+            // TIMEOUT 不自动重试:一次超时已经烧掉整个超时窗口(web_fetch 是 30s),再试两次最坏
+            // 让单次工具调用变成 90s —— 用户看到的是 spinner 长时间冻住。超时通常是目标主机真的慢,
+            // 重试收益低、体感代价高。retryable 标记仍保留,模型可自行判断是否再发一轮。
+            if (outcome.code === 'TIMEOUT')
+                break;
+            await sleepWithSignal(backoff, signal);
+            if (signal?.aborted)
+                break;
+            outcome = await this.executeToolOnce(tool, args, signal, opts);
+        }
+        // 重试用尽仍失败:把尝试次数写进 output,让模型知道「已经自动重试过了,别再无脑重发」。
+        // TIMEOUT 走的是「未自动重试」路径,不能谎称重试过。
+        if (outcome.status === 'error' && outcome.retryable && outcome.code !== 'TIMEOUT') {
+            outcome = { ...outcome, output: `${outcome.output}\n(runtime 已自动重试 ${RETRY_BACKOFF_MS.length} 次仍失败)` };
+        }
+        return outcome;
+    }
     /** 字符串兼容入口：现有调用方、TUI 和 LLM history 无需同步迁移。 */
     async executeTool(name, argsRaw, signal, opts) {
         return (await this.executeToolOutcome(name, argsRaw, signal, opts)).output;

package/dist/ui/render.js

@@ -2,6 +2,7 @@ import { stdout } from 'node:process';
 import { createRequire } from 'node:module';
 import { ui } from './theme.js';
 import { t } from '../i18n/index.js';
+import { IMAGE_READ_MARKER } from '../tools/constants.js';
 let VERSION = '0.0.0';
 try {
     VERSION = createRequire(import.meta.url)('../../package.json').version;
@@ -431,16 +432,33 @@ export function summarizeToolCall(name, argsRaw) {
             return truncateDisplay(argsRaw, 80);
     }
 }
+/** grep 每文件头的命中数:`foo.ts: 3 处匹配,行号 [...]`(与 builtins/grep.ts 的输出契约同源)。 */
+const GREP_HEADER_MATCH_COUNT = /:\s*(\d+)\s*处匹配/g;
 /** 工具结果的人可读一行预览(行数 / 匹配数 / 首行);喂回 LLM 的全文不变。 */
 export function summarizeToolResult(name, output) {
     const nonEmpty = output.split('\n').filter((l) => l.trim().length > 0);
     switch (name) {
         case 'read_file':
+            // 图片分支(read-file.ts IMAGE_READ_MARKER)不是「N 行」文本,单独说清楚,
+            // 否则用户看到「1 行」会以为读取失败或被截断。
+            if (output.startsWith(IMAGE_READ_MARKER))
+                return t('toolSummary.imageAttached');
             return nonEmpty.length ? t('toolSummary.lines', { count: nonEmpty.length }) : t('toolSummary.emptyFile');
         case 'glob':
             return nonEmpty.length ? t('toolSummary.files', { count: nonEmpty.length }) : t('toolSummary.noMatches');
-        case 'grep':
-            return nonEmpty.length ? t('toolSummary.matches', { count: nonEmpty.length }) : t('toolSummary.noMatches');
+        case 'grep': {
+            // 「无匹配」结果不含任何文件头:必须显式识别,否则会被当成 1 处匹配(nonEmpty 只有 1 行)。
+            if (!nonEmpty.length || nonEmpty[0].startsWith('无匹配'))
+                return t('toolSummary.noMatches');
+            // 带 context 时 body 行数 ≠ 命中数(邻居行 + `  --` 分隔都在里面),
+            // 按每文件头的真实命中数求和才对得上模型看到的「N 处匹配」。
+            let matches = 0;
+            GREP_HEADER_MATCH_COUNT.lastIndex = 0;
+            for (let m = GREP_HEADER_MATCH_COUNT.exec(output); m; m = GREP_HEADER_MATCH_COUNT.exec(output)) {
+                matches += Number(m[1]);
+            }
+            return matches > 0 ? t('toolSummary.matches', { count: matches }) : t('toolSummary.noMatches');
+        }
         case 'run_command':
             return truncateDisplay(nonEmpty[0] ?? '', 100) || t('toolSummary.noOutput');
         default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 25 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {