evolcore 0.0.25 → 0.0.26

package/dist/utils/error-dict.json

@@ -1,160 +1,160 @@
-{
-  "rules": [
-    {
-      "id": "context-too-long-cn",
-      "match": "上下文过长",
-      "action": "stop",
-      "type": "context_too_long",
-      "message": "⚠️ 上下文过长，请手动输入 /compact 压缩上下文"
-    },
-    {
-      "id": "context-too-long-en",
-      "match": "context too long",
-      "action": "stop",
-      "type": "context_too_long",
-      "message": "⚠️ 上下文过长，请手动输入 /compact 压缩上下文"
-    },
-    {
-      "id": "prompt-too-long",
-      "match": "prompt is too long",
-      "action": "stop",
-      "type": "context_too_long",
-      "message": "⚠️ 输入过长，请精简提问或使用 /compact 压缩上下文"
-    },
-    {
-      "id": "invalid-api-key",
-      "match": "invalid api key",
-      "action": "stop",
-      "type": "auth_error",
-      "message": "❌ API Key 无效，请检查密钥配置。使用 /status 查看当前配置"
-    },
-    {
-      "id": "key-not-found",
-      "match": "key_not_found",
-      "action": "stop",
-      "type": "auth_error",
-      "message": "❌ API Key 未找到，请检查密钥配置"
-    },
-    {
-      "id": "api-key-verifier-too-many-connections",
-      "match": "error 1040 (08004): too many connections",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ API 服务繁忙，请稍后重试"
-    },
-    {
-      "id": "credit-query-timeout",
-      "match": "积分查询超时",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ 积分查询超时，请稍后重试"
-    },
-    {
-      "id": "capacity-pool-switching-cn",
-      "match": "算力池切换",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ 当前算力池切换中，请稍后重试"
-    },
-    {
-      "id": "retry-attempt-stalled",
-      "match": "retry_attempt_stalled",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ API 重试调用长时间无响应"
-    },
-    {
-      "id": "selected-model-at-capacity",
-      "match": "selected model is at capacity",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ 当前模型繁忙，请稍后重试"
-    },
-    {
-      "id": "api-error-400",
-      "match": "api error: 400",
-      "action": "stop",
-      "type": "api_error",
-      "message": "❌ 请求格式错误，请检查输入内容"
-    },
-    {
-      "id": "model-not-supported-403",
-      "match": "api error: 403 不支持该模型",
-      "action": "stop",
-      "type": "model_unavailable",
-      "message": "❌ 当前模型不受支持，请正确配置模型后重试"
-    },
-    {
-      "id": "api-error-403",
-      "match": "api error: 403",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ API 访问受限，请稍后重试"
-    },
-    {
-      "id": "api-error-429",
-      "match": "api error: 429",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ 请求过于频繁，请稍后重试"
-    },
-    {
-      "id": "api-error-500",
-      "match": "api error: 500",
-      "action": "retry",
-      "type": "api_error",
-      "message": "❌ API 服务暂时不可用，请稍后重试"
-    },
-    {
-      "id": "api-error-502",
-      "match": "api error: 502",
-      "action": "retry",
-      "type": "api_error"
-    },
-    {
-      "id": "api-error-503",
-      "match": "api error: 503",
-      "action": "retry",
-      "type": "api_error"
-    },
-    {
-      "id": "api-error-504",
-      "match": "api error: 504",
-      "action": "retry",
-      "type": "api_error"
-    },
-    {
-      "id": "not-valid-json",
-      "match": "is not valid json",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ API 返回异常响应，请稍后重试"
-    },
-    {
-      "id": "json-parse-error",
-      "match": "json parse error",
-      "action": "retry",
-      "type": "api_error",
-      "message": "⚠️ API 返回 JSON 解析异常，请稍后重试"
-    },
-    {
-      "id": "feishu-permission",
-      "match": "im:resource",
-      "action": "stop",
-      "type": "unknown",
-      "message": "❌ 权限不足，请联系管理员配置应用权限"
-    },
-    {
-      "id": "stream-error",
-      "match": "stream",
-      "action": "retry",
-      "type": "stream_error"
-    },
-    {
-      "id": "request-aborted",
-      "match": "request was aborted",
-      "action": "ignore",
-      "type": "stream_error"
-    }
-  ]
-}
+{
+  "rules": [
+    {
+      "id": "context-too-long-cn",
+      "match": "上下文过长",
+      "action": "stop",
+      "type": "context_too_long",
+      "message": "⚠️ 上下文过长，请手动输入 /compact 压缩上下文"
+    },
+    {
+      "id": "context-too-long-en",
+      "match": "context too long",
+      "action": "stop",
+      "type": "context_too_long",
+      "message": "⚠️ 上下文过长，请手动输入 /compact 压缩上下文"
+    },
+    {
+      "id": "prompt-too-long",
+      "match": "prompt is too long",
+      "action": "stop",
+      "type": "context_too_long",
+      "message": "⚠️ 输入过长，请精简提问或使用 /compact 压缩上下文"
+    },
+    {
+      "id": "invalid-api-key",
+      "match": "invalid api key",
+      "action": "stop",
+      "type": "auth_error",
+      "message": "❌ API Key 无效，请检查密钥配置。使用 /status 查看当前配置"
+    },
+    {
+      "id": "key-not-found",
+      "match": "key_not_found",
+      "action": "stop",
+      "type": "auth_error",
+      "message": "❌ API Key 未找到，请检查密钥配置"
+    },
+    {
+      "id": "api-key-verifier-too-many-connections",
+      "match": "error 1040 (08004): too many connections",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ API 服务繁忙，请稍后重试"
+    },
+    {
+      "id": "credit-query-timeout",
+      "match": "积分查询超时",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ 积分查询超时，请稍后重试"
+    },
+    {
+      "id": "capacity-pool-switching-cn",
+      "match": "算力池切换",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ 当前算力池切换中，请稍后重试"
+    },
+    {
+      "id": "retry-attempt-stalled",
+      "match": "retry_attempt_stalled",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ API 重试调用长时间无响应"
+    },
+    {
+      "id": "selected-model-at-capacity",
+      "match": "selected model is at capacity",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ 当前模型繁忙，请稍后重试"
+    },
+    {
+      "id": "api-error-400",
+      "match": "api error: 400",
+      "action": "stop",
+      "type": "api_error",
+      "message": "❌ 请求格式错误，请检查输入内容"
+    },
+    {
+      "id": "model-not-supported-403",
+      "match": "api error: 403 不支持该模型",
+      "action": "stop",
+      "type": "model_unavailable",
+      "message": "❌ 当前模型不受支持，请正确配置模型后重试"
+    },
+    {
+      "id": "api-error-403",
+      "match": "api error: 403",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ API 访问受限，请稍后重试"
+    },
+    {
+      "id": "api-error-429",
+      "match": "api error: 429",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ 请求过于频繁，请稍后重试"
+    },
+    {
+      "id": "api-error-500",
+      "match": "api error: 500",
+      "action": "retry",
+      "type": "api_error",
+      "message": "❌ API 服务暂时不可用，请稍后重试"
+    },
+    {
+      "id": "api-error-502",
+      "match": "api error: 502",
+      "action": "retry",
+      "type": "api_error"
+    },
+    {
+      "id": "api-error-503",
+      "match": "api error: 503",
+      "action": "retry",
+      "type": "api_error"
+    },
+    {
+      "id": "api-error-504",
+      "match": "api error: 504",
+      "action": "retry",
+      "type": "api_error"
+    },
+    {
+      "id": "not-valid-json",
+      "match": "is not valid json",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ API 返回异常响应，请稍后重试"
+    },
+    {
+      "id": "json-parse-error",
+      "match": "json parse error",
+      "action": "retry",
+      "type": "api_error",
+      "message": "⚠️ API 返回 JSON 解析异常，请稍后重试"
+    },
+    {
+      "id": "feishu-permission",
+      "match": "im:resource",
+      "action": "stop",
+      "type": "unknown",
+      "message": "❌ 权限不足，请联系管理员配置应用权限"
+    },
+    {
+      "id": "stream-error",
+      "match": "stream",
+      "action": "retry",
+      "type": "stream_error"
+    },
+    {
+      "id": "request-aborted",
+      "match": "request was aborted",
+      "action": "ignore",
+      "type": "stream_error"
+    }
+  ]
+}

package/dist/utils/error-utils.js

@@ -4,6 +4,14 @@ import { getPackageRoot, resolvePaths } from '../paths.js';
 import { logger } from './logger.js';
 import { isSandboxInitializationFailure } from '../core/permission/sandbox-runtime.js';
 export const CLAUDE_STARTUP_ARGUMENTS_TOO_LONG = 'claude_startup_arguments_too_long';
+/** A completed provider response exhausted its output budget, rather than a transport failure. */
+export function isOutputTokenLimitError(error) {
+    const record = error && typeof error === 'object' ? error : undefined;
+    const message = String(record?.message ?? error ?? '');
+    return record?.code === 'max_output_tokens'
+        || /^\s*max_output_tokens\s*$/i.test(message)
+        || /\breason["']?\s*[:=]\s*["']?max_output_tokens\b/i.test(message);
+}
 /** Identify a Claude process-start failure without treating ordinary tool errors as startup failures. */
 export function isClaudeStartupArgumentsTooLong(error) {
     const code = error && typeof error === 'object' && 'code' in error
@@ -36,6 +44,7 @@ export var ErrorType;
     ErrorType["AUTH_ERROR"] = "auth_error";
     ErrorType["FILE_CORRUPT"] = "file_corrupt";
     ErrorType["STREAM_ERROR"] = "stream_error";
+    ErrorType["MAX_OUTPUT_TOKENS"] = "max_output_tokens";
     ErrorType["CONTEXT_TOO_LONG"] = "context_too_long";
     ErrorType["MODEL_UNAVAILABLE"] = "model_unavailable";
     ErrorType["SESSION_UNAVAILABLE"] = "session_unavailable";
@@ -78,6 +87,7 @@ const NON_INFRA_SUBTYPES = new Set([
     'stop',
 ]);
 const NON_INFRA_TERMINAL_REASONS = new Set([
+    'max_output_tokens',
     'rapid_refill_breaker',
     'tool_deferred',
     'stop_hook_prevented',
@@ -279,6 +289,9 @@ function hasRetryableHttpStatus(text) {
 }
 export function classifyError(error) {
     const msg = (error?.message || '').toLowerCase();
+    // The broad dictionary rule for "stream" must not hide a provider budget limit.
+    if (isOutputTokenLimitError(error))
+        return ErrorType.MAX_OUTPUT_TOKENS;
     if (error?.code === 'TOPIC_BACKEND_UNAVAILABLE') {
         return ErrorType.SESSION_UNAVAILABLE;
     }
@@ -333,6 +346,9 @@ export function classifyError(error) {
  * 注意：401 认证错误不可重试（API Key 无效不会因重试恢复）
  */
 export function isRetryableError(error) {
+    // Replaying the same request does not increase its output budget.
+    if (isOutputTokenLimitError(error))
+        return false;
     const msg = error?.message || String(error);
     const lower = msg.toLowerCase();
     // 字典优先 — 命中则直接返回
@@ -350,6 +366,11 @@ export function isRetryableError(error) {
     return false;
 }
 export function getErrorMessage(error, terminalReason, includeEmoji = true) {
+    if (terminalReason === 'max_output_tokens' || isOutputTokenLimitError(error)) {
+        const prefix = includeEmoji ? '⚠️ ' : '';
+        return `${prefix}模型响应达到输出上限（max_output_tokens），本轮未完成。`
+            + '请降低推理强度或提高模型服务的输出预算，然后在原会话发送“继续，先核对已完成操作，只完成剩余工作”；无需重发原任务。';
+    }
     if (isClaudeStartupArgumentsTooLong(error)) {
         const prefix = includeEmoji ? '⚠️ ' : '';
         return `${prefix}当前 Claude 启动参数过长，任务未执行`;

package/dist/utils/evolcore-version.js

@@ -1,7 +1,11 @@
+import crypto from 'node:crypto';
 import fs from 'fs';
 import path from 'path';
 import { getPackageRoot } from '../paths.js';
 let cachedVersion;
+let cachedFlavor;
+let cachedStartStamp;
+let cachedStartedAtIso;
 export function readInstalledEvolcoreVersion() {
     if (cachedVersion !== undefined)
         return cachedVersion;
@@ -16,6 +20,131 @@ export function readInstalledEvolcoreVersion() {
     cachedVersion = version;
     return version;
 }
+/**
+ * 区分源码仓库运行与全局安装包。`package.json` 的 `files` 白名单不含 `src/`，
+ * 所以 `src/index.ts` 的存在性可以稳定区分两者：同一个版本号在 dev 下跑的是
+ * 未发布的工作副本，排查时必须能看出来。
+ */
+export function readEvolcoreRuntimeFlavor() {
+    if (cachedFlavor !== undefined)
+        return cachedFlavor;
+    let flavor;
+    try {
+        flavor = fs.existsSync(path.join(getPackageRoot(), 'src', 'index.ts')) ? 'dev' : 'install';
+    }
+    catch {
+        flavor = 'install';
+    }
+    cachedFlavor = flavor;
+    return flavor;
+}
+function pad2(n) {
+    return String(n).padStart(2, '0');
+}
+/**
+ * 本进程启动时刻。用 `process.uptime()` 反推而非模块加载时的 `Date.now()`：
+ * 后者受 import 链耗时影响，且本模块可能被惰性加载。无 syscall，只算一次。
+ */
+function resolveStartedAt() {
+    return new Date(Date.now() - Math.round(process.uptime() * 1000));
+}
+/** 本进程启动时刻的 ISO 串，供结构化字段使用。 */
+export function readEvolcoreStartedAtIso() {
+    if (cachedStartedAtIso !== undefined)
+        return cachedStartedAtIso;
+    cachedStartedAtIso = resolveStartedAt().toISOString();
+    return cachedStartedAtIso;
+}
+/**
+ * 错误标记里的启动时刻，`MMDD-HHMM` 本地时间。
+ *
+ * 用本地时间而非 UTC：读的人是对着自己的墙上时钟判断"这进程是我改完之后起的吗"。
+ * 精度到分钟——秒级对判断重启无意义，只会占长度。
+ */
+export function readEvolcoreStartStamp() {
+    if (cachedStartStamp !== undefined)
+        return cachedStartStamp;
+    const d = resolveStartedAt();
+    cachedStartStamp = `${pad2(d.getMonth() + 1)}${pad2(d.getDate())}-${pad2(d.getHours())}${pad2(d.getMinutes())}`;
+    return cachedStartStamp;
+}
+/**
+ * 用户可见错误文案的版本标记，形如 `[EC 0.0.24 dev 0915-1230]`。
+ *
+ * 带启动时刻是因为版本号不足以定位问题：dev 模式下同一个 `0.0.24` 可能是任意一份
+ * 工作副本，改完代码不重启就仍在跑旧代码——启动时刻能直接把这种情况暴露出来。
+ */
+export function evolcoreErrorTag() {
+    return `[EC ${readInstalledEvolcoreVersion()} ${readEvolcoreRuntimeFlavor()} ${readEvolcoreStartStamp()}]`;
+}
+const ERROR_TAG_PATTERN = /\[EC\s+[^\]]*\]/;
+/**
+ * 前导 emoji / 变体选择符 / 空白：标记要插在它们之后。U+FE0F 单独列出，
+ * 它跟在 emoji 之后且不属于 Extended_Pictographic，漏掉会把 `⚠️` 拆开。
+ */
+const LEADING_DECORATION = /^(?:\p{Extended_Pictographic}|️|\s)+/u;
+/**
+ * 给用户可见的错误文案打版本标记。标记走前缀而非后缀：渠道前端会截断长文案
+ * （错误卡片只显示前两行），后缀会被直接截掉。
+ *
+ * 幂等，且在整串任意位置发现既有标记就跳过——错误文案会被
+ * `formatRetryableErrorFinalMessage` 之类的包装器嵌进 `原因：…` 中段，
+ * 只检查开头会导致同一个错误被打两次标。
+ */
+export function tagErrorTextWithEvolcoreVersion(text) {
+    if (typeof text !== 'string' || !text.trim())
+        return text;
+    if (ERROR_TAG_PATTERN.test(text))
+        return text;
+    const decoration = text.match(LEADING_DECORATION)?.[0] ?? '';
+    return `${decoration}${evolcoreErrorTag()} ${text.slice(decoration.length)}`;
+}
 export function _resetInstalledEvolcoreVersionForTests() {
     cachedVersion = undefined;
+    cachedFlavor = undefined;
+    cachedStartStamp = undefined;
+    cachedStartedAtIso = undefined;
+}
+function collectFiles(root, current = root, out = []) {
+    let entries;
+    try {
+        entries = fs.readdirSync(current, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        const full = path.join(current, entry.name);
+        if (entry.isDirectory())
+            collectFiles(root, full, out);
+        else if (entry.isFile())
+            out.push(path.relative(root, full));
+    }
+    return out;
+}
+/** Hash the complete compiled tree so a changed dependency module changes the ID too. */
+export function computeBuildId(distDir) {
+    if (!fs.existsSync(distDir))
+        return null;
+    try {
+        const hash = crypto.createHash('sha256');
+        for (const relative of collectFiles(distDir)) {
+            const full = path.join(distDir, relative);
+            hash.update(relative.replaceAll(path.sep, '/'));
+            hash.update('\0');
+            hash.update(fs.readFileSync(full));
+            hash.update('\0');
+        }
+        return `sha256:${hash.digest('hex').slice(0, 24)}`;
+    }
+    catch {
+        return null;
+    }
+}
+export function readBuildIdentity(distDir, version) {
+    return {
+        id: computeBuildId(distDir),
+        entry: path.join(distDir, 'index.js'),
+        ...(version ? { version } : {}),
+    };
 }

package/dist/utils/logger.js

@@ -152,7 +152,9 @@ export function normalizeStructuredLog(data) {
 export function localTimestamp() {
     const d = new Date();
     const pad = (n) => String(n).padStart(2, '0');
-    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${String(d.getMilliseconds()).padStart(3, '0')}`;
+    const offset = -d.getTimezoneOffset();
+    const zone = `${offset >= 0 ? '+' : '-'}${pad(Math.floor(Math.abs(offset) / 60))}:${pad(Math.abs(offset) % 60)}`;
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${String(d.getMilliseconds()).padStart(3, '0')}${zone}`;
 }
 function log(level, ...args) {
     if (!shouldLog(level))

package/dist/utils/macos-autostart.js

@@ -51,28 +51,28 @@ function createPlist(runtimeRoot) {
     const args = [process.execPath, '--no-warnings=ExperimentalWarning', cliEntry, 'start']
         .map(value => `    <string>${xmlLiteral(value)}</string>`)
         .join('\n');
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>${xmlLiteral(MACOS_AUTOSTART_LABEL)}</string>
-  <key>ProgramArguments</key>
-  <array>
-${args}
-  </array>
-  <key>EnvironmentVariables</key>
-  <dict>
-${environmentXml}
-  </dict>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>${xmlLiteral(path.join(absoluteRoot, 'logs', 'autostart.stdout.log'))}</string>
-  <key>StandardErrorPath</key>
-  <string>${xmlLiteral(path.join(absoluteRoot, 'logs', 'autostart.stderr.log'))}</string>
-</dict>
-</plist>
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${xmlLiteral(MACOS_AUTOSTART_LABEL)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${args}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+${environmentXml}
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${xmlLiteral(path.join(absoluteRoot, 'logs', 'autostart.stdout.log'))}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlLiteral(path.join(absoluteRoot, 'logs', 'autostart.stderr.log'))}</string>
+</dict>
+</plist>
 `;
 }
 function restorePlist(file, previous) {