mocode-ai 1.5.2 → 1.5.3

package/dist/agent/index.js

@@ -382,6 +382,8 @@ runtimeOrContext = defaultRuntime) {
         },
         onStepStart: () => spinner.start(t('agent.thinking')),
         onChatDone: () => spinner.stop(),
+        // 退避重试要在状态行可见:否则用户面对的是几十秒到几分钟的静止 spinner,与卡死无异。
+        onModelRetry: (r) => spinner.start(t('agent.retrying', { seconds: Math.max(1, Math.round(r.waitMs / 1000)), attempt: r.attempt })),
         // 流式实时用量 → 底栏 context 进度条左侧 chip;轮末由 repl 清空。
         onLiveUsage: (u) => layout.setLiveUsage(u),
         onTextEnd: () => {

package/dist/agent/model-turn.js

@@ -1,4 +1,20 @@
 import { estimatePromptTokens, estimateTokens, isContextLengthError, } from '../llm/index.js';
+/**
+ * 沿 cause 链(≤3 层)取第一个 errno,供 trace 取证。
+ * undici 把底层 errno 挂在 cause 上(`TypeError: fetch failed` → cause `read ECONNRESET`),
+ * openai SDK 再包一层 APIConnectionError 后,顶层 code 恒为 undefined;不留这一项,
+ * 事后只能看到一个 'Error',无法区分 DNS 失败 / 连接被拒 / TLS 握手失败。
+ */
+function traceCauseCode(err) {
+    let cur = err;
+    for (let depth = 0; depth <= 3 && cur && typeof cur === 'object'; depth++) {
+        const e = cur;
+        if (typeof e.code === 'string')
+            return e.code;
+        cur = e.cause;
+    }
+    return undefined;
+}
 /** Executes context preparation plus exactly one model step, including the single overflow retry path. */
 export async function runModelTurn(input) {
     const { opts, ctx, history, historyManager, runtimeContextState, scheduler, contextTrimmer, modelRunner, activeTools, runPolicy, step, cacheState, turnLifecycle, cancellationLifecycle, rebuildHistoryIndexes, } = input;
@@ -112,28 +128,44 @@ export async function runModelTurn(input) {
         onText,
         onToolCall,
         onProgress: reportLive,
-        onRetry: (retry) => emitTrace('model_retry', {
-            model: requestModel,
-            provider,
-            attempt: retry.attempt,
-            nextAttempt: retry.nextAttempt,
-            waitMs: retry.waitMs,
-            code: retry.code,
-        }),
+        onRetry: (retry) => {
+            emitTrace('model_retry', {
+                model: requestModel,
+                provider,
+                attempt: retry.attempt,
+                nextAttempt: retry.nextAttempt,
+                waitMs: retry.waitMs,
+                code: retry.code,
+            });
+            // 退避最长可到 30s、最坏累计数分钟。只写 trace 的话用户看到的就是「卡住不动」,
+            // 与「直接报错终止」一样不可解释 —— 所以同时转达给宿主做可见反馈。
+            hooks.onModelRetry?.(retry);
+        },
     };
     const runChatOnce = async () => {
         try {
             return await modelRunner.run({ history: requestHistory, handlers: chatHandlers, tools: activeTools }, signal);
         }
         catch (error) {
-            const errorValue = error && typeof error === 'object' ? error : undefined;
+            const errorValue = error && typeof error === 'object'
+                ? error
+                : undefined;
             emitTrace('model_end', {
                 model: requestModel,
                 provider,
                 status: signal?.aborted ? 'aborted' : 'error',
                 code: typeof errorValue?.status === 'number'
                     ? `HTTP_${errorValue.status}`
-                    : (errorValue?.code ?? errorValue?.name ?? 'MODEL_ERROR'),
+                    : // 构造器名优先于 `name`:SDK 的 APIError 家族 err.name 恒为 'Error'(无信息量),
+                        // 构造器名才分得出 APIConnectionError(建连失败)/ APIError(流内报错)。
+                        (errorValue?.code ??
+                            error?.constructor?.name ??
+                            errorValue?.name ??
+                            'MODEL_ERROR'),
+                // 取证用:错误文案与 cause 链上的 errno。没有这两项时,trace 只留一个 'Error',
+                // 事后无法判断到底是 DNS 失败、连接被拒还是 TLS 握手失败(实测踩过)。
+                message: typeof errorValue?.message === 'string' ? errorValue.message.slice(0, 300) : undefined,
+                causeCode: traceCauseCode(error),
                 durationMs: Date.now() - modelStartedAt,
             });
             throw error;

package/dist/i18n/index.js

@@ -190,6 +190,7 @@ const zhCN = {
     'agent.thinking': '思考中',
     'agent.generating': '生成 {tool}',
     'agent.executing': '执行 {tool}',
+    'agent.retrying': '连接异常，{seconds}s 后重试（第 {attempt} 次）',
     'agent.noReply': '(无回复)',
     'agent.maxSteps': '达到最大步数({count})，本轮停止。',
     'agent.aborted': '(已中断)',
@@ -519,6 +520,7 @@ const en = {
     'agent.thinking': 'Thinking',
     'agent.generating': 'Generating {tool}',
     'agent.executing': 'Running {tool}',
+    'agent.retrying': 'Connection lost, retrying in {seconds}s (attempt {attempt})',
     'agent.noReply': '(no reply)',
     'agent.maxSteps': 'Maximum steps reached ({count}); this turn has stopped.',
     'agent.aborted': '(aborted)',

package/dist/llm/index.js

@@ -107,7 +107,9 @@ export function isRetryableError(err, signal) {
     if (!err || typeof err !== 'object')
         return false;
     const e = err;
-    if (e.name === 'AbortError' || e.name === 'APIUserAbortError')
+    // SDK 的 APIError 家族不设 this.name(见下),判类别一律用构造器名。
+    const ctor = e.constructor?.name ?? '';
+    if (e.name === 'AbortError' || e.name === 'APIUserAbortError' || ctor === 'APIUserAbortError')
         return false;
     // OpenAI SDK APIError 走 status 分支(覆盖 4xx/5xx/429)
     const status = e.status;
@@ -118,23 +120,26 @@ export function isRetryableError(err, signal) {
             return true;
         return false;
     }
-    // Node 网络错 code(APIConnectionError 内部也会带一个)
-    const code = e.code;
-    if (code === 'ETIMEDOUT' ||
-        code === 'ECONNRESET' ||
-        code === 'ENOTFOUND' ||
-        code === 'EAI_AGAIN' ||
-        code === 'ECONNREFUSED' ||
-        code === 'EPIPE') {
+    // 证书 / 协议层不匹配是**永久性**错误,重试只会白等满退避(10 次≈两分钟)。
+    // 必须先于下面的宽兜底判定:fetch failed / cause 里的证书错文案都会被宽兜底捞走。
+    if (causeChainFrames(err).some((f) => (!!f.code && FATAL_TRANSPORT_CODE.test(f.code)) || (!!f.message && FATAL_TRANSPORT_MESSAGE.test(f.message))))
+        return false;
+    // Node 网络错 errno:顶层没有就沿 cause 链找(undici 把 errno 藏在 cause 里)。
+    if (causeChainFrames(err).some((f) => !!f.code && RETRYABLE_ERRNO.has(f.code)))
         return true;
-    }
-    // OpenAI SDK 的网络错类(无 status)
-    if (e.name === 'APIConnectionError' || e.name === 'APIConnectionTimeoutError')
+    // OpenAI SDK 的网络错类(无 status)。必须用**构造器名**:SDK 的 APIError 家族只做
+    // `super(message)`,从不设 this.name(`err.name` 恒为 'Error')—— 旧代码这里写
+    // `e.name === 'APIConnectionError'` 是永不命中的死分支,于是建连失败(DNS / 连接被拒 /
+    // TLS 握手 / 半路断流)一次即抛、整轮 run 直接终止(trace 里 model_end.code 只剩 'Error')。
+    if (ctor === 'APIConnectionError' || ctor === 'APIConnectionTimeoutError')
         return true;
-    // 兜底:错误信息里出现 timeout 字样(部分代理把错误折叠成普通 Error)
-    if (typeof e.message === 'string' && /\btime(d|ed)?\s*out\b|ETIMEDOUT/i.test(e.message)) {
+    // 兜底:文案。部分代理把错误折叠成普通 Error;SDK 的 APIConnectionError 默认文案就是
+    // 'Connection error.'(负载里没有任何细节,`code` 也为 undefined,只能靠文案兜)。
+    const msg = typeof e.message === 'string' ? e.message : '';
+    if (/\btime(d|ed)?\s*out\b|ETIMEDOUT/i.test(msg))
+        return true;
+    if (/^connection error\.?$/i.test(msg.trim()) || /\bfetch failed\b/i.test(msg))
         return true;
-    }
     return false;
 }
 /**
@@ -161,16 +166,54 @@ const STREAM_BREAK_CODES = new Set([
     'ERR_SOCKET_CONNECTION_TIMEOUT',
 ]);
 const STREAM_BREAK_MESSAGE = /premature close|other side closed|socket hang up|\bterminated\b|stream (?:closed|ended) (?:prematurely|unexpectedly)|econnreset|econnaborted/i;
-/** 沿 cause 链(≤3 层)找「连接被掐断」的信号;命中即认为响应流非正常结束。 */
-function hasStreamBreakSignal(err, depth = 0) {
-    if (!err || typeof err !== 'object' || depth > 3)
-        return false;
-    const e = err;
-    if (typeof e.code === 'string' && STREAM_BREAK_CODES.has(e.code))
-        return true;
-    if (typeof e.message === 'string' && STREAM_BREAK_MESSAGE.test(e.message))
-        return true;
-    return hasStreamBreakSignal(e.cause, depth + 1);
+/**
+ * 「连接层」可重试 errno。与 STREAM_BREAK_CODES 的区别:这些在**建连/发请求**阶段就失败
+ * (DNS 解析、拒绝连接、路由不可达、连接超时),压根没有响应流可言,但处置一样 —— 重试。
+ * 旧实现只在顶层 `err.code` 上查,而 undici 把 errno 埋在 cause 里,永远查不到。
+ */
+const RETRYABLE_ERRNO = new Set([
+    'ETIMEDOUT',
+    'ECONNRESET',
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ECONNREFUSED',
+    'EPIPE',
+    'ECONNABORTED',
+    'ENETUNREACH',
+    'EHOSTUNREACH',
+    'ERR_SOCKET_CONNECTION_TIMEOUT',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_SOCKET',
+]);
+/** 证书 / TLS 协议不匹配:重试必然再错,判死以免白等退避。 */
+const FATAL_TRANSPORT_CODE = /^(?:ERR_SSL|ERR_TLS|ERR_OSSL|UNABLE_TO_VERIFY|DEPTH_ZERO|SELF_SIGNED|CERT_|EPROTO)/;
+const FATAL_TRANSPORT_MESSAGE = /certificate|self[- ]signed|\bEPROTO\b|wrong version number|unsupported protocol/i;
+/**
+ * 沿错误自身与 cause 链(≤3 层)收集每层的 code / message。
+ *
+ * 为什么必须看 cause:undici 把底层 errno 挂在 cause 上(`TypeError: fetch failed` →
+ * cause `Error: read ECONNRESET`,code 在 cause 里),openai SDK 又把那次 fetch 失败再包一层
+ * `APIConnectionError({ cause })`(`core.mjs` 的 catch 分支)。只看顶层 `err.code` / `err.message`
+ * 永远是 undefined / 'Connection error.' —— 这正是这类故障长期无法被识别、无法重试的根因。
+ */
+function causeChainFrames(err) {
+    const frames = [];
+    let cur = err;
+    for (let depth = 0; depth <= 3; depth++) {
+        if (!cur || typeof cur !== 'object')
+            break;
+        const e = cur;
+        frames.push({
+            code: typeof e.code === 'string' ? e.code : undefined,
+            message: typeof e.message === 'string' ? e.message : undefined,
+        });
+        cur = e.cause;
+    }
+    return frames;
+}
+/** 错误链(含 cause)上是否存在「连接被掐断」的信号。 */
+function hasStreamBreakSignal(err) {
+    return causeChainFrames(err).some((f) => (!!f.code && STREAM_BREAK_CODES.has(f.code)) || (!!f.message && STREAM_BREAK_MESSAGE.test(f.message)));
 }
 /**
  * 判定「服务端在响应流中途报错 / 流被中途掐断」——HTTP 层已建连并开始流式返回(状态码 200),
@@ -186,8 +229,9 @@ function hasStreamBreakSignal(err, depth = 0) {
  * 这三类都不沾 → 被当成「不可重试的客户端请求错」一次即抛,整轮 run 直接终止。但它们的真实语义
  * 是「服务端/链路在生成到一半时挂了」,属瞬时故障,重试是正确处置(已实测同一会话更大 prompt 可成功)。
  *
- * 只认 APIError 本身,不认子类:APIConnectionError / APIConnectionTimeoutError 已由
- * isRetryableError 的 name 分支覆盖,而 APIUserAbortError 是用户中断、绝不能重试。
+ * 只认 APIError 本身,不认子类:APIConnectionError / APIConnectionTimeoutError 是**建连阶段**
+ * 失败,归 isRetryableError 的构造器名分支(它有 10 次 HTTP 层预算,更合适);而 APIUserAbortError
+ * 是用户中断,绝不能重试。
  * 判据用构造器名而非 instanceof:同进程若存在 openai 的多份模块实例(ESM/CJS 混载),
  * instanceof 会失配。
  *
@@ -424,7 +468,9 @@ function retryErrorCode(error) {
     const value = error;
     if (typeof value.status === 'number')
         return `HTTP_${value.status}`;
-    return value.code ?? value.name ?? 'RETRYABLE_ERROR';
+    // 优先构造器名:SDK 的 APIError 家族 `err.name` 恒为 'Error'(无信息量),
+    // 构造器名才区分得出是 APIConnectionError(建连失败)还是流内 APIError。
+    return value.code ?? value.constructor?.name ?? value.name ?? 'RETRYABLE_ERROR';
 }
 /** Bind chat dispatch, retries and built-in providers to one explicit runtime. */
 export function createChatTransport(runtime) {

package/package.json

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