mocode-ai 1.7.5 → 1.7.6

package/dist/agent/run-coordinator.js

@@ -11,7 +11,7 @@ import { defaultAgentRuntimeContext } from './runtime-context.js';
 import { runModelTurn } from './model-turn.js';
 import { runToolTurn } from './tool-turn.js';
 import { createTurnLifecycle } from './turn-lifecycle.js';
-import { parseArgs, argumentErrorHint, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, deniedOutcome, readDiffContext, pushToolResult, } from './tool-helpers.js';
+import { parseArgs, argumentErrorHint, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, deniedOutcome, readDiffContext, pushToolResult, unregisteredToolOutcome, } from './tool-helpers.js';
 import { contextState, summarizeToolArguments } from '../session/index.js';
 import { createReadDedup } from '../tools/read-dedup.js';
 import { createBudgetScheduler } from '../session/scheduler.js';
@@ -424,10 +424,14 @@ export async function runAgentCoreLegacy(opts, historyManager, stages) {
                                             const tc = calls[index];
                                             const outcome = {
                                                 status: 'denied',
-                                                code: 'TOOL_DISABLED',
+                                                code: isToolDeniedForStep(tc.name) && !ctx.toolRuntime.findTool(tc.name)
+                                                    ? 'UNKNOWN_TOOL'
+                                                    : 'TOOL_DISABLED',
                                                 retryable: false,
                                                 output: isToolDeniedForStep(tc.name)
-                                                    ? `错误:当前 tool policy snapshot 不允许调用 ${tc.name}。`
+                                                    ? !ctx.toolRuntime.findTool(tc.name)
+                                                        ? unregisteredToolOutcome(tc.name, ctx.toolRuntime).output
+                                                        : `错误:当前 tool policy snapshot 不允许调用 ${tc.name}。`
                                                     : `错误:add_tool_groups 不能与写/执行工具 ${tc.name} 同批执行，本 step 已跳过该调用（其余只读调用与扩容已正常处理）；请在下一 step 重试 ${tc.name}。`,
                                                 changedFiles: [],
                                                 durationMs: 0,
@@ -526,10 +530,14 @@ export async function runAgentCoreLegacy(opts, historyManager, stages) {
                                     const currentCall = calls[i];
                                     if (isToolDeniedForStep(currentCall.name)) {
                                         hooks.onToolHeader?.(currentCall);
-                                        const error = t('task.disabled');
+                                        // registry 中根本不存在的名字(模型幻觉/拼写错误)给专门纠错提示,
+                                        // 不再复用 task.disabled 的 /subagent 误导文案;已注册但本步不允许才用 gate 文案。
+                                        const error = !ctx.toolRuntime.findTool(currentCall.name)
+                                            ? unregisteredToolOutcome(currentCall.name, ctx.toolRuntime).output
+                                            : t('task.disabled');
                                         const outcome = {
                                             status: 'denied',
-                                            code: 'TOOL_DISABLED',
+                                            code: !ctx.toolRuntime.findTool(currentCall.name) ? 'UNKNOWN_TOOL' : 'TOOL_DISABLED',
                                             retryable: false,
                                             output: error,
                                             changedFiles: [],

package/dist/agent/stages/history-manager.js

@@ -5,11 +5,19 @@ function replaceMessages(backing, messages) {
     backing.push(...replacement);
 }
 function assistantMessage(turn) {
+    const hasToolCalls = turn.toolCalls.length > 0;
     const message = {
         role: 'assistant',
-        content: turn.content,
+        // 无 tool_calls 时 content 不能是 null:那是 OpenAI 自己吐 tool_call 时的规范形状,
+        // 纯文本轮次写 null 会被严格 OpenAI 兼容网关整请求 400(实测 speedbear:
+        // "messages[N].content 不能为 null … 无文本请传空字符串"),且消息一旦落进 history
+        // 就每轮重发 → 整个会话永久中毒,换个会话同模型却正常。来源是 SSE 流中途结束
+        // (网关掐断)时 SDK 不抛错、content 停在 null 而 tool_calls 为空,框架仍当
+        // 「agent 完成了这一轮」写盘。构造点在此收敛,transport 边界另有兜底
+        // (src/llm/message-shape.ts)负责让存量中毒会话自愈。
+        content: !hasToolCalls && turn.content === null ? '' : turn.content,
     };
-    if (turn.toolCalls.length > 0) {
+    if (hasToolCalls) {
         // thoughtSignature 不是 OpenAI 字段，是 mocode 给 Gemini/Vertex 透传用的；
         // 挂在 tool_call 上随 history 落盘/回灌，Vertex encoder 会读回它。
         message.tool_calls = turn.toolCalls.map((call) => ({

package/dist/agent/stages/tool-dispatcher.js

@@ -7,7 +7,7 @@ import { summarizeToolArguments } from '../../session/index.js';
 import { getPlanDisabledTools } from '../../tools/constants.js';
 import { defaultToolRuntime } from '../../tools/registry.js';
 import { validateToolArguments } from '../../tools/validation.js';
-import { deniedOutcome, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, parseArgs, readDiffContext, } from '../tool-helpers.js';
+import { deniedOutcome, isParallelTool, isParallelOrchestrationCall, isResourceLockedCall, parseArgs, readDiffContext, unregisteredToolOutcome, } from '../tool-helpers.js';
 const DEFAULT_DEPENDENCIES = {
     toolRuntime: defaultToolRuntime,
     checkPermission: defaultCheckPermission,
@@ -119,10 +119,12 @@ class LegacyCompatibleToolDispatcher {
                     const call = calls[index];
                     const outcome = {
                         status: 'denied',
-                        code: 'TOOL_DISABLED',
+                        code: request.isDenied(call.name) && !toolRuntime.findTool(call.name) ? 'UNKNOWN_TOOL' : 'TOOL_DISABLED',
                         retryable: false,
                         output: request.isDenied(call.name)
-                            ? `错误:当前 tool policy snapshot 不允许调用 ${call.name}。`
+                            ? !toolRuntime.findTool(call.name)
+                                ? unregisteredToolOutcome(call.name, toolRuntime).output
+                                : `错误:当前 tool policy snapshot 不允许调用 ${call.name}。`
                             : `错误:add_tool_groups 不能与写/执行工具 ${call.name} 同批执行，本 step 已跳过该调用（其余只读调用与扩容已正常处理）；请在下一 step 重试 ${call.name}。`,
                         changedFiles: [],
                         durationMs: 0,
@@ -213,10 +215,12 @@ class LegacyCompatibleToolDispatcher {
             const current = calls[index];
             if (request.isDenied(current.name)) {
                 request.onEvent({ type: 'header', call: current });
-                const output = t('task.disabled');
+                // registry 中不存在的名字(幻觉/拼写错误)给纠错提示,不误导用户去开 /subagent。
+                const unregistered = !toolRuntime.findTool(current.name);
+                const output = unregistered ? unregisteredToolOutcome(current.name, toolRuntime).output : t('task.disabled');
                 const outcome = {
                     status: 'denied',
-                    code: 'TOOL_DISABLED',
+                    code: unregistered ? 'UNKNOWN_TOOL' : 'TOOL_DISABLED',
                     retryable: false,
                     output,
                     changedFiles: [],

package/dist/agent/tool-helpers.js

@@ -16,6 +16,7 @@ import { capToolResultForHistory } from '../session/compact.js';
 import { recordArtifact, knownEditTargets } from '../context/index.js';
 import { isToolResultSuccess } from '../context/utils.js';
 import { appendGuiAction } from '../session/gui-actions.js';
+import { t } from '../i18n/index.js';
 /** 解析工具 arguments JSON;非法或空返 null(调用方据此降级到普通 preview)。 */
 export function parseArgs(raw) {
     try {
@@ -76,6 +77,52 @@ export function deniedOutcome(name) {
         output: `错误:用户拒绝了工具 ${name} 的执行。`,
     };
 }
+/** 编辑距离(Levenshtein);名字很短时用上限截断避免 O(n²) 浪费。 */
+function editDistance(a, b, max = 4) {
+    if (Math.abs(a.length - b.length) > max)
+        return max + 1;
+    const prev = new Array(b.length + 1);
+    const curr = new Array(b.length + 1);
+    for (let j = 0; j <= b.length; j++)
+        prev[j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        curr[0] = i;
+        let rowMin = curr[0];
+        for (let j = 1; j <= b.length; j++) {
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+            if (curr[j] < rowMin)
+                rowMin = curr[j];
+        }
+        if (rowMin > max)
+            return max + 1;
+        for (let j = 0; j <= b.length; j++)
+            prev[j] = curr[j];
+    }
+    return prev[b.length];
+}
+/**
+ * 未注册工具名(模型幻觉/拼写错误)的专门 denied 结果。
+ * isToolDeniedForStep 对不在 allowedToolNames 里的一切名字(含 registry 中不存在的)都返回
+ * true,旧路径一律复用 task.disabled 文案,误导用户去开 /subagent。此 helper 先查 registry:
+ * 名字根本不存在时给出「未注册 + 相近候选」的纠错提示;存在但本步不允许时才回落 gate 文案。
+ */
+export function unregisteredToolOutcome(name, toolRuntime) {
+    const registered = toolRuntime.tools.map((tool) => tool.name);
+    const ranked = registered
+        .map((candidate) => ({
+        candidate,
+        distance: editDistance(name.toLowerCase(), candidate.toLowerCase()),
+    }))
+        .sort((x, y) => x.distance - y.distance);
+    const close = ranked.filter((entry) => entry.distance <= 3).slice(0, 3);
+    const suggestions = close.length > 0 ? close.map((entry) => entry.candidate).join(', ') : t('toolError.noCloseMatch');
+    return {
+        status: 'denied',
+        code: 'UNKNOWN_TOOL',
+        retryable: false,
+        output: t('toolError.unregistered', { name, suggestions }),
+    };
+}
 /** mutation 执行前读旧内容供 diff:write_file 取整文件旧内容(不存在→null=新建),
  * edit_file 取 old_string 起始行号(供 diff 显示真实文件行号)。读不到则 diff 退化为相对行号。
  * 非 mutation 或参数非法返 { preWriteOld: null, editStartLine: 1 }。失败不阻断。 */

package/dist/i18n/index.js

@@ -241,6 +241,8 @@ const zhCN = {
     'toolSummary.noOutput': '(无输出)',
     'toolSummary.imageAttached': '图片已作为视觉输入附加',
     'toolError.unknown': '错误:未知工具 "{name}"',
+    'toolError.unregistered': '错误:工具 "{name}" 未注册（不在本会话可用工具列表中，可能是拼写错误或模型幻觉出的名称）。相近的已注册工具:{suggestions}。请只调用 tools 列表中存在的名称，不要自造工具名。',
+    'toolError.noCloseMatch': '无相近的已注册工具名',
     'toolError.invalidJson': '错误:工具 {name} 的 arguments 不是合法 JSON: {arguments}',
     'toolError.execution': '错误:工具 {name} 执行失败: {message}',
     'command.outputTruncated': '...(输出已截断 {count} 字符，保留开头与结尾)...',
@@ -624,6 +626,8 @@ const en = {
     'toolSummary.noOutput': '(no output)',
     'toolSummary.imageAttached': 'Image attached as visual input',
     'toolError.unknown': 'Error: unknown tool "{name}"',
+    'toolError.unregistered': 'Error: tool "{name}" is not registered (it is not in this session\'s available tool list — likely a misspelling or a model-hallucinated name). Closest registered tools: {suggestions}. Only call names that appear in the tools list; never invent tool names.',
+    'toolError.noCloseMatch': 'no close match among registered tools',
     'toolError.invalidJson': 'Error: arguments for tool {name} are not valid JSON: {arguments}',
     'toolError.execution': 'Error: tool {name} failed: {message}',
     'command.outputTruncated': '...(output truncated by {count} characters; keeping the beginning and end)...',

package/dist/llm/index.js

@@ -5,6 +5,7 @@ import { getPlanDisabledTools, getProfileDisabledTools } from '../tools/constant
 import { imageSizeFromDataUrl } from '../attachments/image.js';
 import { ThinkTagFilter } from './think-filter.js';
 import { sanitizeToolSchemas } from './tool-schema.js';
+import { sanitizeAssistantContent } from './message-shape.js';
 import { isMarkedStreamInterrupted } from './stream-interrupt.js';
 import { defaultAnthropicFetch, anthropicChatOnce } from './providers/anthropic.js';
 import { vertexChatOnce } from './providers/vertex.js';
@@ -676,7 +677,7 @@ async function chatOnce(messages, handlers, signal, toolsOverride, runtime = def
         });
     const stream = await create({
         model: runtime.getModel(),
-        messages: normalizeImageDetail(messages),
+        messages: sanitizeAssistantContent(normalizeImageDetail(messages)),
         stream: true,
         // 空工具表(如摘要请求)不发 tools 字段——部分网关拒绝空数组。
         ...(activeTools.length > 0

package/dist/llm/message-shape.js

@@ -0,0 +1,42 @@
+/**
+ * 把「无文本、无 tool_calls」的 assistant 消息的 `content: null` 改写成空字符串。
+ *
+ * 背景:`content: null` 在 assistant 消息上**只在携带 tool_calls 时合法**(那是 OpenAI 自己
+ * 吐 tool_call 时的规范形状)。纯文本轮次写成 null 会被严格 OpenAI 兼容网关整请求拒绝。
+ * speedbear(https://speedbear.redbearai.com/api/v1)实测:
+ *   `{"error_code":"REQUEST_VALIDATION_FAILED",
+ *     "detail":"messages[12].content 不能为 null(assistant 消息仅在携带 tool_calls/
+ *               function_call 时允许省略 content;无文本请传空字符串 \"\")"}`
+ * 且形状探针逐条确认:`null`+tool_calls → 200;`content:[]` → 200;缺 content 字段 → 200;
+ * `content:""` → 200;连续 user 消息 → 200。**只有「null 且无 tool_calls」这一种被拒。**
+ *
+ * 在 agent 侧的表现极具迷惑性——「某个会话从某一轮起每一步都 400、换个会话同模型却正常」:
+ * 毒消息一旦写进 history 就会每轮重发,而它是**合法 JSON、合法 OpenAI 类型**,肉眼 review
+ * 抓不到;`/resume` 也救不回来(毒在落盘文件里)。更隐蔽的是它的来源:SSE 流中途结束
+ * (网关超时/上游掐断)时 SDK 不抛错,`content` 停在 null、tool_calls 为空,
+ * 框架把它当「agent 完成了这一轮」照写 history——于是一步正常的历史被永久污染。
+ *
+ * 与 `sanitizeToolSchemas`(剔 uniqueItems)同源同策:**放 transport 边界而非只修构造点**——
+ * 已经被旧版本写进 session.json 的中毒会话、外部注入的历史、resume 续接的会话都能自愈,
+ * 只修构造点救不了存量。构造点(`agent/stages/history-manager.ts`)同步收敛,保证新历史
+ * 不再生产这种形状,两层各司其职。
+ *
+ * 无需改写时返回**原数组引用**——history 参与前缀缓存,逐字节稳定才能命中;
+ * 每次新建对象会击穿缓存(同 `sanitizeToolSchemas` 的返回值约定)。
+ */
+export function sanitizeAssistantContent(messages) {
+    let changed = false;
+    const next = messages.map((message) => {
+        if (message.role !== 'assistant')
+            return message;
+        const raw = message;
+        // 带 tool_calls 时 null 是规范形状(OpenAI 自己就这么吐),原样保留。
+        if (Array.isArray(raw.tool_calls) && raw.tool_calls.length > 0)
+            return message;
+        if (raw.content !== null)
+            return message;
+        changed = true;
+        return { ...message, content: '' };
+    });
+    return changed ? next : messages;
+}

package/package.json

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