evolclaw 2.8.1 → 2.8.2

package/dist/core/reload-hooks.js

@@ -0,0 +1,87 @@
+/**
+ * Reload Hooks
+ *
+ * Extracted from index.ts main() for testability. Builds the ReloadHooks
+ * implementation used by AgentRegistry.reload() to drain/disconnect/start
+ * channels during a hot reload.
+ */
+import { logger } from '../utils/logger.js';
+export function buildReloadHooks(deps) {
+    const { channelLoader, channelInstances, registerChannelInstance, messageQueue } = deps;
+    const drainDelayMs = deps.drainDelayMs ?? 500;
+    const drainTimeoutMs = deps.drainTimeoutMs ?? 30000;
+    return {
+        async drainChannel(channelName) {
+            logger.info(`[Reload] Draining channel: ${channelName}`);
+            if (messageQueue) {
+                // Real drain: poll until empty or timeout
+                const pollMs = 100;
+                const start = Date.now();
+                while (messageQueue.isChannelProcessing(channelName)) {
+                    if (Date.now() - start > drainTimeoutMs) {
+                        logger.warn(`[Reload] Drain timeout (${drainTimeoutMs}ms) for channel: ${channelName}, proceeding anyway`);
+                        return;
+                    }
+                    await new Promise(r => setTimeout(r, pollMs));
+                }
+                logger.info(`[Reload] Drain complete: ${channelName}`);
+            }
+            else if (drainDelayMs > 0) {
+                await new Promise(r => setTimeout(r, drainDelayMs));
+            }
+        },
+        async disconnectChannel(channelName) {
+            const inst = channelInstances.find(i => i.adapter.channelName === channelName);
+            if (!inst) {
+                logger.warn(`[Reload] Channel ${channelName} not found, skipping disconnect`);
+                return;
+            }
+            try {
+                await inst.disconnect();
+                const idx = channelInstances.indexOf(inst);
+                if (idx >= 0)
+                    channelInstances.splice(idx, 1);
+                logger.info(`[Reload] Disconnected channel: ${channelName}`);
+            }
+            catch (e) {
+                logger.error(`[Reload] Failed to disconnect ${channelName}: ${e}`);
+                throw e;
+            }
+        },
+        async startChannel(agent, channelName) {
+            const channels = agent.config.channels;
+            let channelType = null;
+            for (const [type, raw] of Object.entries(channels)) {
+                const instances = Array.isArray(raw) ? raw : [raw];
+                for (const inst of instances) {
+                    const name = inst.name ?? type;
+                    if (name === channelName) {
+                        channelType = type;
+                        break;
+                    }
+                }
+                if (channelType)
+                    break;
+            }
+            if (!channelType) {
+                const msg = `[Reload] Channel ${channelName} not found in agent ${agent.name} config`;
+                logger.error(msg);
+                throw new Error(msg);
+            }
+            const partialConfig = {
+                agents: agent.config.agents,
+                channels: { [channelType]: channels[channelType] },
+                projects: agent.config.projects,
+            };
+            const newInstances = await channelLoader.createAll(partialConfig);
+            const newInst = newInstances.find(i => i.adapter.channelName === channelName);
+            if (!newInst) {
+                throw new Error(`[Reload] Failed to create instance ${channelName}`);
+            }
+            registerChannelInstance(newInst);
+            await newInst.connect();
+            channelInstances.push(newInst);
+            logger.info(`[Reload] Started channel: ${channelName}`);
+        },
+    };
+}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { ClaudeSessionFileAdapter } from './core/session/adapters/claude-session-file-adapter.js';
 import { CodexSessionFileAdapter } from './core/session/adapters/codex-session-file-adapter.js';
 import { GeminiSessionFileAdapter } from './core/session/adapters/gemini-session-file-adapter.js';
-import { loadConfig, ensureDataDirs, resolvePaths, resolveAnthropicConfig, isOwner, isAdmin, validateConfigIntegrity, validateChannelInstanceNames, getOwner, getDefaultSessionMode } from './config.js';
+import { loadConfig, ensureDataDirs, resolvePaths, resolveAnthropicConfig, isOwner, isAdmin, validateConfigIntegrity, validateChannelInstanceNames, getOwner, getDefaultSessionMode, setOwner as setOwnerInGlobalConfig, setChannelShowActivities as setShowActivitiesInGlobalConfig } from './config.js';
 import { SessionManager } from './core/session/session-manager.js';
 import { ClaudeAgentPlugin } from './agents/claude-runner.js';
 import { CodexAgentPlugin } from './agents/codex-runner.js';
@@ -23,10 +23,12 @@ import { PermissionGateway } from './core/permission.js';
 import { InteractionRouter } from './core/interaction-router.js';
 import { ChannelLoader } from './core/channel-loader.js';
 import { AgentLoader } from './core/agent-loader.js';
+import { EvolAgentRegistry } from './core/evolagent-registry.js';
+import { buildReloadHooks } from './utils/reload-hooks.js';
 import { IpcServer } from './ipc.js';
 import { logger, setLogLevel } from './utils/logger.js';
-import { detectDuplicates } from './utils/channel-fingerprint.js';
-import { loadPromptTemplates } from './prompts/templates.js';
+import { detectDuplicates } from './core/evolagent-registry.js';
+import { loadPromptTemplates } from './agents/templates.js';
 import path from 'path';
 import fs from 'fs';
 async function main() {
@@ -82,13 +84,45 @@ async function main() {
     if (anthropic.baseUrl) {
         logger.info(`✓ Using custom API base URL: ${anthropic.baseUrl}`);
     }
+    // EvolAgent Registry
+    const agentRegistry = new EvolAgentRegistry(paths.agentsDir, {
+        setOwner: (channelName, userId) => {
+            setOwnerInGlobalConfig(config, channelName, userId);
+        },
+        setShowActivities: (channelName, mode) => {
+            setShowActivitiesInGlobalConfig(config, channelName, mode);
+        },
+    });
+    agentRegistry.loadAll(config);
+    const agentInfos = agentRegistry.list();
+    const evolagentCount = agentInfos.filter(i => !i.isDefault).length;
+    if (evolagentCount > 0) {
+        logger.info(`✓ Loaded ${evolagentCount} evolagent(s)`);
+        for (const info of agentInfos) {
+            if (info.isDefault)
+                continue;
+            if (info.status === 'error') {
+                logger.error(`  ✗ [${info.name}] ${info.error}`);
+            }
+            else if (info.status === 'disabled') {
+                logger.info(`  ○ [${info.name}] disabled`);
+            }
+            else {
+                logger.info(`  ● [${info.name}] ${info.baseagent} @ ${path.basename(info.projectPath)}`);
+            }
+        }
+    }
+    // Store for IPC access (T10 will wire this)
+    // M4: removed dead globalThis.__evolclaw_agentRegistry assignment
     // 创建事件总线
     const eventBus = new EventBus();
     logger.info('✓ Event bus initialized');
     // 统计收集器（近 1 小时滚动统计）
     const statsCollector = new StatsCollector(eventBus);
     // 初始化数据库（带 ownerResolver）
-    const sessionManager = new SessionManager(undefined, eventBus, (channel, userId) => isOwner(config, channel, userId), (channel, userId) => isAdmin(config, channel, userId));
+    // Registry-first: agent-owned channels resolve via EvolAgent.isOwner/isAdmin,
+    // default-agent channels fall back to global config (evolclaw.json).
+    const sessionManager = new SessionManager(undefined, eventBus, (channel, userId) => agentRegistry.isOwner(channel, userId, (ch, uid) => isOwner(config, ch, uid)), (channel, userId) => agentRegistry.isAdmin(channel, userId, (ch, uid) => isAdmin(config, ch, uid)));
     // sessionMode 解析：全局 chatmode 配置 > 默认 'interactive'
     sessionManager.setSessionModeResolver((_channel, chatType) => {
         return getDefaultSessionMode(config, chatType);
@@ -143,8 +177,48 @@ async function main() {
     channelLoader.register(new DingtalkChannelPlugin());
     channelLoader.register(new QQBotChannelPlugin());
     channelLoader.register(new WecomChannelPlugin());
-    const channelInstances = await channelLoader.createAll(config);
-    logger.info(`✓ Created ${channelInstances.length} channel instance(s)`);
+    // Create channel instances: default (from evolclaw.json) + each evolagent
+    const defaultInstances = await channelLoader.createAll(config);
+    const evolagentInstances = [];
+    for (const agent of agentRegistry.runnableAgents()) {
+        // Rewrite channel instance names with agent prefix to avoid collisions
+        // with DefaultAgent and other EvolAgents.
+        // Rule (EvolAgent only):
+        //   - explicit name → `${agent.name}-${type}-${name}`
+        //   - omitted name  → `${agent.name}-${type}`
+        const rewrittenChannels = {};
+        for (const [type, raw] of Object.entries(agent.config.channels || {})) {
+            if (type === 'defaultChannel') {
+                rewrittenChannels[type] = raw;
+                continue;
+            }
+            const instances = Array.isArray(raw) ? raw : [raw];
+            const rewritten = instances.map((inst) => {
+                if (!inst || typeof inst !== 'object')
+                    return inst;
+                const effName = agent.effectiveChannelName(type, inst.name);
+                return { ...inst, name: effName };
+            });
+            // Preserve original shape (array vs single object)
+            rewrittenChannels[type] = Array.isArray(raw) ? rewritten : rewritten[0];
+        }
+        const agentConfig = {
+            agents: agent.config.agents,
+            channels: rewrittenChannels,
+            projects: agent.config.projects,
+        };
+        try {
+            const instances = await channelLoader.createAll(agentConfig);
+            evolagentInstances.push(...instances);
+        }
+        catch (e) {
+            logger.error(`[EvolAgent] Failed to create channels for ${agent.name}: ${e}`);
+            agent.status = 'error';
+            agent.error = `Channel creation failed: ${e}`;
+        }
+    }
+    const channelInstances = [...defaultInstances, ...evolagentInstances];
+    logger.info(`✓ Created ${channelInstances.length} channel instance(s)${evolagentInstances.length > 0 ? ` (${defaultInstances.length} default + ${evolagentInstances.length} agent)` : ''}`);
     // 启动迁移：将 sessions.channel 从 channelType 回填为实例名
     sessionManager.migrateChannelToInstanceName();
     // 创建命令处理器
@@ -166,6 +240,13 @@ async function main() {
     }, defaultAgent);
     // 回填 processor 和 messageQueue 的引用
     cmdHandler.setProcessor(processor);
+    // Inject EvolAgentRegistry (methods added by T6/T7)
+    if (processor.setAgentRegistry) {
+        processor.setAgentRegistry(agentRegistry);
+    }
+    if (cmdHandler.setAgentRegistry) {
+        cmdHandler.setAgentRegistry(agentRegistry);
+    }
     // 设置交互路由器
     processor.setInteractionRouter(interactionRouter);
     // 设置 compact 开始回调（对所有支持的 agent）
@@ -203,12 +284,18 @@ async function main() {
     };
     // ── MessageBridge：Channel ↔ Core 消息桥梁 ──
     const msgBridge = new MessageBridge(config, sessionManager, processor, messageQueue, cmdHandler, eventBus);
+    msgBridge.setAgentRegistry(agentRegistry);
     // ── Channel instance registration (shared by startup and hot-load) ──
     function registerChannelInstance(inst) {
         // 1. 项目路径提供器
         if (inst.onProjectPathRequest && inst.channel.onProjectPathRequest) {
             inst.channel.onProjectPathRequest(async (channelId) => {
-                const session = await sessionManager.getOrCreateSession(inst.adapter.channelName, channelId, config.projects?.defaultPath || process.cwd(), undefined, undefined, undefined, undefined);
+                // Effective default path: agent's projectPath if agent-owned, else global
+                const owningAgent = agentRegistry.resolveByChannel(inst.adapter.channelName);
+                const effectiveDefault = (owningAgent && !owningAgent.isDefault)
+                    ? owningAgent.projectPath
+                    : (config.projects?.defaultPath || process.cwd());
+                const session = await sessionManager.getOrCreateSession(inst.adapter.channelName, channelId, effectiveDefault, undefined, undefined, undefined, undefined);
                 return path.isAbsolute(session.projectPath)
                     ? session.projectPath
                     : path.resolve(process.cwd(), session.projectPath);
@@ -350,6 +437,18 @@ async function main() {
     }
     // ── 连接所有渠道 ──
     const connected = await channelLoader.connectAll(channelInstances);
+    // Bind connected adapters to their owning agents
+    // I1: only mark 'running' if a channel actually connected for that agent
+    const connectedSet = new Set(connected);
+    for (const inst of channelInstances) {
+        const agent = agentRegistry.resolveByChannel(inst.adapter.channelName);
+        if (!agent || agent.status === 'error')
+            continue;
+        agent.channels.set(inst.adapter.channelName, inst.adapter);
+        if (agent.status === 'stopped' && connectedSet.has(inst.adapter.channelName)) {
+            agent.status = 'running';
+        }
+    }
     // 预填充 Feishu 已知 thread_id（重启后避免误判话题创建）
     for (const inst of channelInstances) {
         const channelType = inst.channelType || inst.adapter.channelName;
@@ -384,7 +483,7 @@ async function main() {
                 continue; // 跳过同类型通道
             if (notified.has(otherType))
                 continue; // 同类型已通知过
-            const ownerId = getOwner(config, other.adapter.channelName);
+            const ownerId = agentRegistry.getOwner(other.adapter.channelName) ?? getOwner(config, other.adapter.channelName);
             if (!ownerId)
                 continue;
             notified.add(otherType);
@@ -499,6 +598,18 @@ async function main() {
             },
         };
     }, async (cmd, sessionId) => cmdHandler.handleCtl(cmd, sessionId));
+    // M3: direct call (not cast) — wire EvolAgentRegistry into IPC for evolagent.* handlers
+    ipcServer.setAgentRegistry(agentRegistry);
+    // ── Reload hooks: enable agentRegistry.reload() to drain/disconnect/restart channels ──
+    const reloadHooks = buildReloadHooks({
+        channelLoader,
+        channelInstances,
+        registerChannelInstance,
+        messageQueue,
+    });
+    // Make reload hooks accessible to IPC handler & ctl handler (both run in this process)
+    globalThis.__evolclaw_reloadHooks = reloadHooks;
+    // I3: start IPC server LAST, after all hook setup, to eliminate race window
     ipcServer.start();
     // 运行时配置文件监控
     const configPath = resolvePaths().config;

package/dist/ipc.js

@@ -8,11 +8,16 @@ export class IpcServer {
     getStatus;
     commandExecutor;
     server = null;
+    agentRegistry;
     constructor(socketPath, getStatus, commandExecutor) {
         this.socketPath = socketPath;
         this.getStatus = getStatus;
         this.commandExecutor = commandExecutor;
     }
+    /** Inject EvolAgentRegistry for evolagent.* IPC handlers */
+    setAgentRegistry(registry) {
+        this.agentRegistry = registry;
+    }
     start() {
         // Remove stale socket file (Unix only — named pipes auto-cleanup on process exit)
         if (!isNamedPipe(this.socketPath)) {
@@ -82,6 +87,48 @@ export class IpcServer {
                     return { ok: false, error: 'missing cmd or sessionId' };
                 return await this.commandExecutor(slashCmd, sessionId);
             }
+            case 'evolagent.list': {
+                if (!this.agentRegistry)
+                    return { ok: false, error: 'EvolAgentRegistry not available' };
+                return { ok: true, agents: this.agentRegistry.list() };
+            }
+            case 'evolagent.show': {
+                if (!this.agentRegistry)
+                    return { ok: false, error: 'EvolAgentRegistry not available' };
+                const name = cmd.name;
+                if (!name || typeof name !== 'string')
+                    return { ok: false, error: 'missing name' };
+                const agent = this.agentRegistry.get(name);
+                if (!agent)
+                    return { ok: false, error: `Agent "${name}" not found` };
+                const info = this.agentRegistry.list().find((i) => i.name === name);
+                // I7: null-guard list().find() result
+                if (!info)
+                    return { ok: false, error: `Agent "${name}" found but info missing (race?)` };
+                return { ok: true, agent: info };
+            }
+            case 'evolagent.reload': {
+                if (!this.agentRegistry)
+                    return { ok: false, error: 'EvolAgentRegistry not available' };
+                const name = cmd.name;
+                if (!name || typeof name !== 'string')
+                    return { ok: false, error: 'missing name' };
+                const hooks = globalThis.__evolclaw_reloadHooks;
+                if (!hooks)
+                    return { ok: false, error: 'Reload hooks not initialized' };
+                try {
+                    const a = this.agentRegistry.get(name);
+                    if (!a)
+                        return { ok: false, error: `Agent "${name}" not found` };
+                    if (!this.agentRegistry.reload)
+                        return { ok: false, error: 'EvolAgentRegistry.reload not available' };
+                    await this.agentRegistry.reload(name, hooks);
+                    return { ok: true, result: `Agent "${name}" reloaded` };
+                }
+                catch (e) {
+                    return { ok: false, error: e?.message || String(e) };
+                }
+            }
             default:
                 return { error: `unknown command: ${cmd.type}` };
         }

package/dist/types.js

@@ -3,3 +3,5 @@
 // Array form: `name` is required to distinguish instances.
 /** Default permission mode applied to new sessions. Change here to affect all roles. */
 export const DEFAULT_PERMISSION_MODE = 'bypass';
+/** Reserved agent name used for DefaultAgent (no agent.json file). */
+export const DEFAULT_AGENT_NAME = '[default]';

package/dist/utils/reload-hooks.js

@@ -0,0 +1,87 @@
+/**
+ * Reload Hooks
+ *
+ * Extracted from index.ts main() for testability. Builds the ReloadHooks
+ * implementation used by EvolAgentRegistry.reload() to drain/disconnect/start
+ * channels during a hot reload.
+ */
+import { logger } from './logger.js';
+export function buildReloadHooks(deps) {
+    const { channelLoader, channelInstances, registerChannelInstance, messageQueue } = deps;
+    const drainDelayMs = deps.drainDelayMs ?? 500;
+    const drainTimeoutMs = deps.drainTimeoutMs ?? 30000;
+    return {
+        async drainChannel(channelName) {
+            logger.info(`[Reload] Draining channel: ${channelName}`);
+            if (messageQueue) {
+                // Real drain: poll until empty or timeout
+                const pollMs = 100;
+                const start = Date.now();
+                while (messageQueue.isChannelProcessing(channelName)) {
+                    if (Date.now() - start > drainTimeoutMs) {
+                        logger.warn(`[Reload] Drain timeout (${drainTimeoutMs}ms) for channel: ${channelName}, proceeding anyway`);
+                        return;
+                    }
+                    await new Promise(r => setTimeout(r, pollMs));
+                }
+                logger.info(`[Reload] Drain complete: ${channelName}`);
+            }
+            else if (drainDelayMs > 0) {
+                await new Promise(r => setTimeout(r, drainDelayMs));
+            }
+        },
+        async disconnectChannel(channelName) {
+            const inst = channelInstances.find(i => i.adapter.channelName === channelName);
+            if (!inst) {
+                logger.warn(`[Reload] Channel ${channelName} not found, skipping disconnect`);
+                return;
+            }
+            try {
+                await inst.disconnect();
+                const idx = channelInstances.indexOf(inst);
+                if (idx >= 0)
+                    channelInstances.splice(idx, 1);
+                logger.info(`[Reload] Disconnected channel: ${channelName}`);
+            }
+            catch (e) {
+                logger.error(`[Reload] Failed to disconnect ${channelName}: ${e}`);
+                throw e;
+            }
+        },
+        async startChannel(agent, channelName) {
+            const channels = agent.config.channels;
+            let channelType = null;
+            for (const [type, raw] of Object.entries(channels)) {
+                const instances = Array.isArray(raw) ? raw : [raw];
+                for (const inst of instances) {
+                    const name = inst.name ?? type;
+                    if (name === channelName) {
+                        channelType = type;
+                        break;
+                    }
+                }
+                if (channelType)
+                    break;
+            }
+            if (!channelType) {
+                const msg = `[Reload] Channel ${channelName} not found in agent ${agent.name} config`;
+                logger.error(msg);
+                throw new Error(msg);
+            }
+            const partialConfig = {
+                agents: agent.config.agents,
+                channels: { [channelType]: channels[channelType] },
+                projects: agent.config.projects,
+            };
+            const newInstances = await channelLoader.createAll(partialConfig);
+            const newInst = newInstances.find(i => i.adapter.channelName === channelName);
+            if (!newInst) {
+                throw new Error(`[Reload] Failed to create instance ${channelName}`);
+            }
+            registerChannelInstance(newInst);
+            await newInst.connect();
+            channelInstances.push(newInst);
+            logger.info(`[Reload] Started channel: ${channelName}`);
+        },
+    };
+}

package/dist/utils/rich-content-renderer.js

@@ -226,3 +226,36 @@ export async function closeBrowser() {
         browserInstance = null;
     }
 }
+// ── Markdown → Plain Text ───────────────────────────────────────────────────
+// 用于不渲染 markdown 的渠道（微信、QQ）将 Agent 输出降级为纯文本。
+export function markdownToPlainText(text) {
+    let result = text;
+    // Code blocks: strip fences, keep content
+    result = result.replace(/```[^\n]*\n?([\s\S]*?)```/g, (_, code) => code.trim());
+    // Images: remove entirely
+    result = result.replace(/!\[[^\]]*\]\([^)]*\)/g, '');
+    // Links: keep display text only
+    result = result.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1');
+    // Tables: remove separator rows
+    result = result.replace(/^\|[\s:|-]+\|$/gm, '');
+    result = result.replace(/^\|(.+)\|$/gm, (_, inner) => inner.split('|').map(cell => cell.trim()).join('  '));
+    // Bold/italic
+    result = result.replace(/\*\*(.+?)\*\*/g, '$1');
+    result = result.replace(/\*(.+?)\*/g, '$1');
+    result = result.replace(/__(.+?)__/g, '$1');
+    result = result.replace(/_(.+?)_/g, '$1');
+    // Strikethrough
+    result = result.replace(/~~(.+?)~~/g, '$1');
+    // Inline code
+    result = result.replace(/`([^`]+)`/g, '$1');
+    // Headers
+    result = result.replace(/^#{1,6}\s+/gm, '');
+    // Blockquotes
+    result = result.replace(/^>\s?/gm, '');
+    // Horizontal rules
+    result = result.replace(/^[-*_]{3,}$/gm, '');
+    // List markers
+    result = result.replace(/^(\s*)[-*+]\s/gm, '$1');
+    result = result.replace(/^(\s*)\d+\.\s/gm, '$1');
+    return result.trim();
+}

package/dist/utils/stats-collector.js

@@ -7,23 +7,24 @@ export class StatsCollector {
         // 订阅相关事件
         eventBus.subscribe('message:received', (event) => {
             const e = event;
-            this.recordEvent({ type: 'received', timestamp: e.timestamp || Date.now() });
+            this.recordEvent({ type: 'received', timestamp: e.timestamp || Date.now(), agentName: e.agentName });
         });
         eventBus.subscribe('message:completed', (event) => {
             const e = event;
-            this.recordEvent({ type: 'completed', timestamp: e.timestamp || Date.now(), durationMs: e.durationMs });
+            this.recordEvent({ type: 'completed', timestamp: e.timestamp || Date.now(), durationMs: e.durationMs, agentName: e.agentName });
         });
         eventBus.subscribe('message:error', (event) => {
             const e = event;
-            this.recordEvent({ type: 'error', timestamp: Date.now(), errorType: e.errorType });
+            this.recordEvent({ type: 'error', timestamp: Date.now(), errorType: e.errorType, agentName: e.agentName });
         });
-        eventBus.subscribe('message:interrupted', (_event) => {
-            this.recordEvent({ type: 'interrupted', timestamp: Date.now() });
+        eventBus.subscribe('message:interrupted', (event) => {
+            const e = event;
+            this.recordEvent({ type: 'interrupted', timestamp: Date.now(), agentName: e.agentName });
         });
         eventBus.subscribe('tool:result', (event) => {
             const e = event;
             if (e.isError) {
-                this.recordEvent({ type: 'tool-error', timestamp: Date.now(), toolName: e.toolName });
+                this.recordEvent({ type: 'tool-error', timestamp: Date.now(), toolName: e.toolName, agentName: e.agentName });
             }
         });
     }
@@ -31,14 +32,18 @@ export class StatsCollector {
         this.events.push(record);
     }
     /**
-     * 获取统计快照（自动裁剪 >1h 的事件）
+     * 获取统计快照。可选 agentName 过滤：未传则全局；传入则只统计该 agent。
+     * 自动裁剪 >1h 的事件。
      */
-    getSnapshot() {
+    getSnapshot(agentName) {
         const now = Date.now();
         const cutoff = now - this.HOUR_MS;
         // 裁剪过期事件
         this.events = this.events.filter(e => e.timestamp >= cutoff);
-        // 聚合统计
+        // 聚合统计（可按 agent 过滤）
+        const filtered = agentName === undefined
+            ? this.events
+            : this.events.filter(e => (e.agentName ?? '[default]') === agentName);
         let received = 0;
         let completed = 0;
         let errors = 0;
@@ -48,7 +53,7 @@ export class StatsCollector {
         let interrupts = 0;
         let totalDuration = 0;
         let durationCount = 0;
-        for (const event of this.events) {
+        for (const event of filtered) {
             switch (event.type) {
                 case 'received':
                     received++;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "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",