evolclaw 2.0.0

package/dist/utils/stream-idle-monitor.js

@@ -0,0 +1,103 @@
+/**
+ * 事件流空闲监控器
+ * 记录事件流执行上下文，分级响应空闲状态
+ */
+// 分级倍率
+const NOTIFY_MULTIPLIER = 1; // 1× idleMs
+const WARN_MULTIPLIER = 2.5; // 2.5× idleMs
+const KILL_MULTIPLIER = 5; // 5× idleMs
+export class StreamIdleMonitor {
+    state;
+    triggeredLevels = new Set();
+    idleMs;
+    constructor(idleMs) {
+        this.idleMs = idleMs;
+        this.state = {
+            lastEventType: '',
+            lastEventTime: Date.now(),
+            lastToolName: undefined,
+            lastToolStartTime: undefined,
+            totalEvents: 0,
+            totalToolCalls: 0,
+            hasReceivedText: false,
+        };
+    }
+    /**
+     * 记录 SDK 事件，更新状态并重置空闲计时
+     */
+    recordEvent(type, toolName) {
+        this.state.lastEventType = type;
+        this.state.lastEventTime = Date.now();
+        this.state.totalEvents++;
+        if (toolName) {
+            this.state.lastToolName = toolName;
+            this.state.lastToolStartTime = Date.now();
+            this.state.totalToolCalls++;
+        }
+        if (type === 'text_delta' || type === 'result') {
+            this.state.hasReceivedText = true;
+        }
+        // 收到新事件，重置已触发级别
+        this.triggeredLevels.clear();
+    }
+    /**
+     * 检查空闲状态，返回 null（未空闲）或分级结果
+     */
+    check() {
+        const now = Date.now();
+        const idleDuration = now - this.state.lastEventTime;
+        const notifyThreshold = this.idleMs * NOTIFY_MULTIPLIER;
+        const warnThreshold = this.idleMs * WARN_MULTIPLIER;
+        const killThreshold = this.idleMs * KILL_MULTIPLIER;
+        // Check from lowest to highest — return first untriggered level
+        if (idleDuration >= notifyThreshold && !this.triggeredLevels.has('notify')) {
+            this.triggeredLevels.add('notify');
+            return {
+                action: 'notify',
+                idleSec: Math.round(idleDuration / 1000),
+                state: { ...this.state },
+                message: this.buildMessage('notify', idleDuration),
+            };
+        }
+        if (idleDuration >= warnThreshold && !this.triggeredLevels.has('warn')) {
+            this.triggeredLevels.add('warn');
+            return {
+                action: 'warn',
+                idleSec: Math.round(idleDuration / 1000),
+                state: { ...this.state },
+                message: this.buildMessage('warn', idleDuration),
+            };
+        }
+        if (idleDuration >= killThreshold && !this.triggeredLevels.has('kill')) {
+            this.triggeredLevels.add('kill');
+            return {
+                action: 'kill',
+                idleSec: Math.round(idleDuration / 1000),
+                state: { ...this.state },
+                message: this.buildMessage('kill', idleDuration),
+            };
+        }
+        return null;
+    }
+    /**
+     * 获取当前执行状态快照
+     */
+    getState() {
+        return { ...this.state };
+    }
+    buildMessage(action, idleDuration) {
+        const idleSec = Math.round(idleDuration / 1000);
+        const lastToolInfo = this.state.lastToolName
+            ? `🔧 ${this.state.lastToolName}`
+            : '无工具调用';
+        const timeSinceLastEvent = idleSec;
+        if (action === 'kill') {
+            return `🛑 执行超时（${idleSec}秒无响应），已自动中断\n\n执行状态：\n- 已处理 ${this.state.totalEvents} 个事件，${this.state.totalToolCalls} 次工具调用\n- 最后活动：${lastToolInfo}（${timeSinceLastEvent}秒前）`;
+        }
+        if (action === 'warn') {
+            return `⚠️ 执行监控：已 ${idleSec} 秒无输出\n\n执行状态：\n- 已处理 ${this.state.totalEvents} 个事件，${this.state.totalToolCalls} 次工具调用\n- 最后活动：${lastToolInfo}（${timeSinceLastEvent}秒前）\n\n如果持续无响应，将在 ${Math.round((this.idleMs * KILL_MULTIPLIER - idleDuration) / 1000)} 秒后自动中断。\n使用 /stop 可立即中断当前任务。`;
+        }
+        // notify
+        return `🔍 执行监控：已 ${idleSec} 秒无输出\n\n执行状态：\n- 已处理 ${this.state.totalEvents} 个事件，${this.state.totalToolCalls} 次工具调用\n- 最后活动：${lastToolInfo}（${timeSinceLastEvent}秒前）\n\n仍在运行中。使用 /stop 可中断当前任务。`;
+    }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "evolclaw",
+  "version": "2.0.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",
+  "bin": {
+    "evolclaw": "./bin/evolclaw"
+  },
+  "files": [
+    "dist/",
+    "!dist/experimental/",
+    "bin/",
+    "data/evolclaw.sample.json"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:hooks": "tsx test-sdk-hooks.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.77",
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "dotenv": "^16.6.1",
+    "image-type": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.9"
+  }
+}