evolclaw 3.3.0 → 3.4.0

package/dist/utils/npm-ops.js

@@ -8,7 +8,7 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { execFile } from 'child_process';
+import { execFile, execSync } from 'child_process';
 import { promisify } from 'util';
 import { getPackageRoot } from '../paths.js';
 import { isWindows } from './cross-platform.js';
@@ -92,6 +92,28 @@ export function getLocalVersion() {
     const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
     return pkg.version;
 }
+/**
+ * 解析全局安装包的已装版本（通过 `npm root -g` 定位全局 node_modules）。
+ * 用于 evolclaw-web 这类独立全局命令包——它们不在 evolclaw 的依赖树里。
+ * 未安装或查询失败返回 null。
+ */
+export function resolveGlobalPkg(pkgName) {
+    try {
+        // 命令完全静态（npm root -g，无用户输入），用 execSync 传完整命令字符串，
+        // 避免 "args 数组 + shell:true" 组合触发 Node DeprecationWarning，且无注入风险。
+        const npmCmd = isWindows ? 'npm.cmd' : 'npm';
+        const globalRoot = execSync(`${npmCmd} root -g`, {
+            encoding: 'utf-8', timeout: 10000,
+        }).trim();
+        const pkgPath = path.join(globalRoot, ...pkgName.split('/'), 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const data = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            return { version: data.version, path: pkgPath };
+        }
+    }
+    catch { /* not found */ }
+    return null;
+}
 /**
  * 查询 npm registry 上指定包的最新版本。
  * 使用 HTTP fetch 直接查 registry API，不依赖 npm CLI。
@@ -147,19 +169,20 @@ export async function tryUpgrade() {
     return { status: 'failed', from: localVer, to: remoteVer, error: lastError };
 }
 /**
- * AUN SDK 升级流程：检查 → 比较 → 安装
- * 仅在 SDK 已安装时检查升级，未安装则跳过。
+ * 通用全局包升级流程：检查 → 比较 → 安装（失败重试一次）。
+ * 仅在包已安装时检查升级，未安装则跳过（resolveFn 返回 null）。
+ * fastaun / evolclaw-web 等独立全局包共用此逻辑。
  */
-export async function tryUpgradeAunSdk(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG) {
+export async function tryUpgradeGlobalPkg(resolveInstalled, pkgName) {
     if (isLinkedInstall()) {
         return { status: 'skipped' };
     }
-    const installed = resolveAunCoreSdkPkg();
+    const installed = resolveInstalled();
     if (!installed) {
-        return { status: 'skipped' }; // SDK not installed, skip
+        return { status: 'skipped' }; // not installed, skip
     }
     const localVer = installed.version;
-    const remoteVer = await checkLatestVersion(AUN_CORE_SDK_PKG);
+    const remoteVer = await checkLatestVersion(pkgName);
     if (!remoteVer) {
         return { status: 'skipped', error: 'Failed to check remote version' };
     }
@@ -169,7 +192,7 @@ export async function tryUpgradeAunSdk(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG) {
     let lastError;
     for (let attempt = 0; attempt < 2; attempt++) {
         try {
-            await npmInstallGlobal(`${AUN_CORE_SDK_PKG}@latest`);
+            await npmInstallGlobal(`${pkgName}@latest`);
             return { status: 'upgraded', from: localVer, to: remoteVer };
         }
         catch (e) {
@@ -178,3 +201,10 @@ export async function tryUpgradeAunSdk(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG) {
     }
     return { status: 'failed', from: localVer, to: remoteVer, error: lastError };
 }
+/**
+ * AUN SDK 升级流程：检查 → 比较 → 安装
+ * 仅在 SDK 已安装时检查升级，未安装则跳过。
+ */
+export async function tryUpgradeAunSdk(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG) {
+    return tryUpgradeGlobalPkg(resolveAunCoreSdkPkg, AUN_CORE_SDK_PKG);
+}

package/dist/utils/stats.js

@@ -2,6 +2,8 @@ import fs from 'fs';
 import path from 'path';
 export class StatsCollector {
     events = [];
+    recentErrors = [];
+    MAX_RECENT_ERRORS = 50;
     startTime;
     HOUR_MS = 3_600_000;
     constructor(eventBus) {
@@ -17,7 +19,12 @@ export class StatsCollector {
         });
         eventBus.subscribe('task:error', (event) => {
             const e = event;
-            this.recordEvent({ type: 'error', timestamp: Date.now(), errorType: e.errorType, agentName: e.agentName });
+            const ts = Date.now();
+            this.recordEvent({ type: 'error', timestamp: ts, errorType: e.errorType, agentName: e.agentName });
+            this.recordRecentError({
+                ts, kind: 'task', agentName: e.agentName, errorType: e.errorType,
+                message: this.truncate(e.error),
+            });
         });
         eventBus.subscribe('task:interrupted', (event) => {
             const e = event;
@@ -26,10 +33,26 @@ export class StatsCollector {
         eventBus.subscribe('tool:result', (event) => {
             const e = event;
             if (e.isError) {
-                this.recordEvent({ type: 'tool-error', timestamp: Date.now(), toolName: e.toolName, agentName: e.agentName });
+                const ts = Date.now();
+                this.recordEvent({ type: 'tool-error', timestamp: ts, toolName: e.toolName, agentName: e.agentName });
+                this.recordRecentError({
+                    ts, kind: 'tool', agentName: e.agentName, toolName: e.toolName,
+                });
             }
         });
     }
+    truncate(s) {
+        if (!s)
+            return undefined;
+        const oneLine = String(s).replace(/\s+/g, ' ').trim();
+        return oneLine.length > 200 ? oneLine.slice(0, 200) + '…' : oneLine;
+    }
+    recordRecentError(err) {
+        this.recentErrors.unshift(err); // 新在前
+        if (this.recentErrors.length > this.MAX_RECENT_ERRORS) {
+            this.recentErrors.length = this.MAX_RECENT_ERRORS;
+        }
+    }
     recordEvent(record) {
         this.events.push(record);
     }
@@ -84,6 +107,10 @@ export class StatsCollector {
                     break;
             }
         }
+        // 最近错误：按 agent 过滤（与上面一致），取前 20 条
+        const recentErrors = (agentName === undefined
+            ? this.recentErrors
+            : this.recentErrors.filter(e => (e.agentName ?? '<unknown>') === agentName)).slice(0, 20);
         return {
             uptimeMs: now - this.startTime,
             lastHour: {
@@ -95,7 +122,8 @@ export class StatsCollector {
                 toolErrorsByName,
                 interrupts,
                 avgResponseMs: durationCount > 0 ? totalDuration / durationCount : 0
-            }
+            },
+            recentErrors,
         };
     }
 }
@@ -130,6 +158,14 @@ export class AidStatsCollector {
             if (e.sessionId)
                 this.sessionToAgent.delete(e.sessionId);
         });
+        // 用户主动打断（新消息/​/stop/​撤回）：任务有自己的生命周期收尾，不计为 error
+        eventBus.subscribe('task:interrupted', (event) => {
+            const e = event;
+            if (e.agentName)
+                this.onTaskEnd(e.agentName, 'interrupted');
+            if (e.sessionId)
+                this.sessionToAgent.delete(e.sessionId);
+        });
         // thought.put 次数 + 最后一次 thought 文本
         // 注意：thought.put 是 fire-and-forget async，可能在 task:completed 之后才到达，
         // 所以同时累加到 currentTask（task 进行中）或 lastTaskEnd（task 已结束但 thought 属于它）
@@ -194,7 +230,10 @@ export class AidStatsCollector {
                 lastSentTo: null,
                 lastSentEncrypt: null,
                 lastSentChatmode: null,
+                lastReceivedKind: null,
+                lastSentKind: null,
                 uniquePeers: new Set(),
+                recentMessages: [],
                 currentTaskStartAt: null,
                 currentTaskReplyCount: 0,
                 currentTaskThoughtPutCount: 0,
@@ -326,7 +365,7 @@ export class AidStatsCollector {
         const entry = this.getOrCreate(aid);
         entry.selfName = name;
     }
-    recordInbound(aid, fromPeer, byteLength, text, isSystem = false, encrypt, chatmode) {
+    recordInbound(aid, fromPeer, byteLength, text, isSystem = false, encrypt, chatmode, kind = 'send') {
         const entry = this.getOrCreate(aid);
         if (isSystem) {
             entry.systemReceived++;
@@ -341,6 +380,13 @@ export class AidStatsCollector {
                 entry.lastReceivedEncrypt = encrypt;
             if (chatmode)
                 entry.lastReceivedChatmode = chatmode;
+            entry.lastReceivedKind = kind;
+            // ring buffer：最近 10 轮
+            if (text) {
+                entry.recentMessages.unshift({ dir: 'in', peer: fromPeer, text: text.slice(0, 100), ts: Date.now(), kind, encrypt: encrypt ?? null, chatmode: chatmode ?? null });
+                if (entry.recentMessages.length > 10)
+                    entry.recentMessages.pop();
+            }
         }
         entry.bytesReceived += byteLength;
         entry.uniquePeers.add(fromPeer);
@@ -351,7 +397,7 @@ export class AidStatsCollector {
             bytes: byteLength, encrypted: encrypt, chatmode,
         });
     }
-    recordOutbound(aid, toPeer, byteLength, text, isSystem = false, encrypt, chatmode) {
+    recordOutbound(aid, toPeer, byteLength, text, isSystem = false, encrypt, chatmode, kind = 'send') {
         const entry = this.getOrCreate(aid);
         if (isSystem) {
             entry.systemSent++;
@@ -366,6 +412,13 @@ export class AidStatsCollector {
                 entry.lastSentEncrypt = encrypt;
             if (chatmode)
                 entry.lastSentChatmode = chatmode;
+            entry.lastSentKind = kind;
+            // ring buffer：最近 10 轮
+            if (text) {
+                entry.recentMessages.unshift({ dir: 'out', peer: toPeer, text: text.slice(0, 100), ts: Date.now(), kind, encrypt: encrypt ?? null, chatmode: chatmode ?? null });
+                if (entry.recentMessages.length > 10)
+                    entry.recentMessages.pop();
+            }
             // 累计当前 task 的回复数
             if (entry.currentTaskStartAt != null) {
                 entry.currentTaskReplyCount++;
@@ -389,7 +442,7 @@ export class AidStatsCollector {
         for (const entry of this.entries.values()) {
             const queueStats = this.queueStatsProvider
                 ? this.queueStatsProvider(entry.aid)
-                : { processing: 0, queued: 0 };
+                : { processing: 0, queued: 0, muted: false };
             out.push({
                 aid: entry.aid,
                 selfName: entry.selfName,
@@ -409,9 +462,13 @@ export class AidStatsCollector {
                 lastSentTo: entry.lastSentTo,
                 lastSentEncrypt: entry.lastSentEncrypt,
                 lastSentChatmode: entry.lastSentChatmode,
+                lastReceivedKind: entry.lastReceivedKind,
+                lastSentKind: entry.lastSentKind,
                 uniquePeerCount: entry.uniquePeers.size,
                 processing: queueStats.processing,
                 queued: queueStats.queued,
+                muted: queueStats.muted,
+                recentMessages: entry.recentMessages,
                 lastTaskEnd: entry.lastTaskEnd,
             });
         }

package/kits/eck_manifest.json

@@ -100,18 +100,6 @@
       "when": { "var": "clientType", "neq": null },
       "description": "客户端环境文档"
     },
-    {
-      "id": "response-depth",
-      "type": "file",
-      "file": "$KITS_FRAGMENTS/response-depth.md",
-      "order": 45,
-      "needsInjection": true,
-      "when": { "and": [
-        { "var": "chatType", "eq": "group" },
-        { "var": "responseDepth", "in": ["lightweight", "deep"] }
-      ]},
-      "description": "群聊响应深度指引（lightweight/deep 时注入）"
-    },
     {
       "id": "channel-layer",
       "type": "file",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Lightweight AI Agent gateway connecting Claude Agent SDK to messaging channels (Feishu, ACP) with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -33,8 +33,7 @@
   },
   "dependencies": {
     "@agentunion/fastaun": "^0.4.13",
-    "@anthropic-ai/claude-agent-sdk": "^0.3.156",
-    "@anthropic-ai/sdk": "^0.100.1",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.170",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "cron-parser": "^5.5.0",
     "dotenv": "^17.4.2",