evolcore 0.0.2 → 0.0.4

package/dist/ipc.js

@@ -8,6 +8,8 @@ import { HANDOFF_QUERY_MAX_LIMIT, HANDOFF_STATES } from './core/handoff/types.js
 import { resolvePaths } from './paths.js';
 import { getProcessStartTime, isSameOrOlderProcess } from './utils/process-introspect.js';
 import { classifyProcessTree, ProcessTreeSampler } from './utils/process-tree-stats.js';
+import { readSystemMemoryUsage } from './utils/system-memory.js';
+import { hashCurrentDelegatedCommand } from './core/auth/agent-delegation.js';
 const isWindows = process.platform === 'win32';
 const isNamedPipe = (p) => isWindows && p.startsWith('\\\\.\\pipe\\');
 export function summarizeMonitorAgents(agents, aids) {
@@ -45,7 +47,12 @@ export class IpcServer {
     handoffTraceExecutor;
     bindExecutor;
     configOperationExecutor;
+    contactOperationExecutor;
     dingtalkContactBindExecutor;
+    feishuContactBindExecutor;
+    qqbotContactBindExecutor;
+    wecomContactBindExecutor;
+    wechatContactBindExecutor;
     // CPU 占用追踪：IPC handler 是一次性同步调用，无法在响应里做 200ms 异步采样，
     // 故用后台 1s interval 累积 process.cpuUsage() 增量，handler 直接读最近值。
     // procCpuPercent = 本 daemon 进程占单核的百分比（可 >100% 仅当多核，已 clamp 到 100）；
@@ -75,6 +82,9 @@ export class IpcServer {
     setConfigOperationExecutor(executor) {
         this.configOperationExecutor = executor;
     }
+    setContactOperationExecutor(executor) {
+        this.contactOperationExecutor = executor;
+    }
     /** Inject AUN AID state aggregator for aun-aids IPC handler */
     setAunAidProvider(provider) {
         this.aunAidProvider = provider;
@@ -136,6 +146,22 @@ export class IpcServer {
     setDingtalkContactBindExecutor(executor) {
         this.dingtalkContactBindExecutor = executor;
     }
+    /** Inject Feishu contact binding-code executor. */
+    setFeishuContactBindExecutor(executor) {
+        this.feishuContactBindExecutor = executor;
+    }
+    /** Inject QQ contact binding-code executor. */
+    setQQBotContactBindExecutor(executor) {
+        this.qqbotContactBindExecutor = executor;
+    }
+    /** Inject WeCom contact binding-code executor. */
+    setWecomContactBindExecutor(executor) {
+        this.wecomContactBindExecutor = executor;
+    }
+    /** Inject WeChat contact binding-code executor. */
+    setWechatContactBindExecutor(executor) {
+        this.wechatContactBindExecutor = executor;
+    }
     /** Start the 1s background CPU sampling loop (for monitor-snapshot). Call after start(). */
     startCpuTracking() {
         if (this.cpuTimer)
@@ -315,12 +341,72 @@ export class IpcServer {
                 if (!this.dingtalkContactBindExecutor) {
                     return { ok: false, error: 'dingtalk contact bind executor not configured' };
                 }
+                if (this.dingtalkContactBindExecutor.isChannelReady
+                    && !this.dingtalkContactBindExecutor.isChannelReady(cmd.channelName)) {
+                    return { ok: false, error: 'channel instance is not connected' };
+                }
                 return this.dingtalkContactBindExecutor.register({
                     selfAid: cmd.selfAid,
                     channelName: cmd.channelName,
                     primaryId: cmd.primaryId,
                 });
             }
+            case 'feishu.contact-bind.register': {
+                if (!this.feishuContactBindExecutor) {
+                    return { ok: false, error: 'feishu contact bind executor not configured' };
+                }
+                if (this.feishuContactBindExecutor.isChannelReady
+                    && !this.feishuContactBindExecutor.isChannelReady(cmd.channelName)) {
+                    return { ok: false, error: 'channel instance is not connected' };
+                }
+                return this.feishuContactBindExecutor.register({
+                    selfAid: cmd.selfAid,
+                    channelName: cmd.channelName,
+                    primaryId: cmd.primaryId,
+                });
+            }
+            case 'qqbot.contact-bind.register': {
+                if (!this.qqbotContactBindExecutor) {
+                    return { ok: false, error: 'qqbot contact bind executor not configured' };
+                }
+                if (this.qqbotContactBindExecutor.isChannelReady
+                    && !this.qqbotContactBindExecutor.isChannelReady(cmd.channelName)) {
+                    return { ok: false, error: 'channel instance is not connected' };
+                }
+                return this.qqbotContactBindExecutor.register({
+                    selfAid: cmd.selfAid,
+                    channelName: cmd.channelName,
+                    primaryId: cmd.primaryId,
+                });
+            }
+            case 'wecom.contact-bind.register': {
+                if (!this.wecomContactBindExecutor) {
+                    return { ok: false, error: 'wecom contact bind executor not configured' };
+                }
+                if (this.wecomContactBindExecutor.isChannelReady
+                    && !this.wecomContactBindExecutor.isChannelReady(cmd.channelName)) {
+                    return { ok: false, error: 'channel instance is not connected' };
+                }
+                return this.wecomContactBindExecutor.register({
+                    selfAid: cmd.selfAid,
+                    channelName: cmd.channelName,
+                    primaryId: cmd.primaryId,
+                });
+            }
+            case 'wechat.contact-bind.register': {
+                if (!this.wechatContactBindExecutor) {
+                    return { ok: false, error: 'wechat contact bind executor not configured' };
+                }
+                if (this.wechatContactBindExecutor.isChannelReady
+                    && !this.wechatContactBindExecutor.isChannelReady(cmd.channelName)) {
+                    return { ok: false, error: 'channel instance is not connected' };
+                }
+                return this.wechatContactBindExecutor.register({
+                    selfAid: cmd.selfAid,
+                    channelName: cmd.channelName,
+                    primaryId: cmd.primaryId,
+                });
+            }
             case 'aun-aids': {
                 const aids = this.aunAidProvider ? this.aunAidProvider() : [];
                 return { ok: true, aids };
@@ -437,6 +523,7 @@ export class IpcServer {
                         originSessionId: typeof cmd.originSessionId === 'string' ? cmd.originSessionId : undefined,
                         originMessageId: typeof cmd.originMessageId === 'string' ? cmd.originMessageId : undefined,
                         delegationToken: typeof cmd.delegationToken === 'string' ? cmd.delegationToken : undefined,
+                        delegationCommandHash: typeof cmd.delegationCommandHash === 'string' ? cmd.delegationCommandHash : undefined,
                         log,
                     });
                 }
@@ -455,6 +542,7 @@ export class IpcServer {
                         handoffId: typeof cmd.handoffId === 'string' ? cmd.handoffId : undefined,
                         content: cmd.content,
                         delegationToken: typeof cmd.delegationToken === 'string' ? cmd.delegationToken : undefined,
+                        delegationCommandHash: typeof cmd.delegationCommandHash === 'string' ? cmd.delegationCommandHash : undefined,
                     });
                 }
                 catch (e) {
@@ -513,7 +601,7 @@ export class IpcServer {
                 const { cmd: slashCmd, sessionId } = cmd;
                 if (!slashCmd || !sessionId)
                     return { ok: false, error: 'missing cmd or sessionId' };
-                return await this.commandExecutor(slashCmd, sessionId, typeof cmd.delegationToken === 'string' ? cmd.delegationToken : undefined);
+                return await this.commandExecutor(slashCmd, sessionId, typeof cmd.delegationToken === 'string' ? cmd.delegationToken : undefined, typeof cmd.delegationCommandHash === 'string' ? cmd.delegationCommandHash : undefined);
             }
             case 'config.op': {
                 if (!this.configOperationExecutor)
@@ -525,7 +613,19 @@ export class IpcServer {
                 if (delegationToken !== undefined && typeof delegationToken !== 'string') {
                     return { ok: false, code: 'INVALID_DELEGATION', error: 'delegationToken must be a string' };
                 }
-                return await this.configOperationExecutor(argv, sessionId, delegationToken);
+                return await this.configOperationExecutor(argv, sessionId, delegationToken, typeof cmd.delegationCommandHash === 'string' ? cmd.delegationCommandHash : undefined);
+            }
+            case 'contact.op': {
+                if (!this.contactOperationExecutor)
+                    return { ok: false, code: 'NOT_CONFIGURED', error: 'contact.op not configured' };
+                const { argv, sessionId, delegationToken } = cmd;
+                if (!Array.isArray(argv) || argv.some(value => typeof value !== 'string') || !sessionId) {
+                    return { ok: false, code: 'INVALID_REQUEST', error: 'missing argv or sessionId' };
+                }
+                if (delegationToken !== undefined && typeof delegationToken !== 'string') {
+                    return { ok: false, code: 'INVALID_DELEGATION', error: 'delegationToken must be a string' };
+                }
+                return await this.contactOperationExecutor(argv, sessionId, delegationToken, typeof cmd.delegationCommandHash === 'string' ? cmd.delegationCommandHash : undefined);
             }
             case 'trigger.list':
             case 'trigger.show':
@@ -581,6 +681,10 @@ export class IpcServer {
                         return { ok: false, error: `Agent "${name}" not found` };
                     if (!this.agentRegistry.reload)
                         return { ok: false, error: 'EvolAgentRegistry.reload not available' };
+                    // 'kits' 组（manifest / fragment / schema / 角色模板）走 on-reload 策略，平时不查盘：
+                    // reload 是它唯一的刷新时机，必须先清再 reload，否则重载出来的 agent 仍用旧模板。
+                    const { invalidateKitCache } = await import('./eck/kit-renderer.js');
+                    invalidateKitCache();
                     await this.agentRegistry.reload(name, hooks);
                     return { ok: true, result: `Agent "${name}" reloaded` };
                 }
@@ -633,8 +737,7 @@ export class IpcServer {
             case 'monitor-snapshot': {
                 // watch web Monitor 页用：进程级 + 系统级运行指标 + 全局 stats + per-agent 汇总。
                 const mem = process.memoryUsage();
-                const totalMem = os.totalmem();
-                const freeMem = os.freemem();
+                const systemMemory = readSystemMemoryUsage();
                 const aids = this.aunAidProvider ? this.aunAidProvider() : [];
                 const aidStats = this.aunAidStatsProvider ? this.aunAidStatsProvider() : [];
                 const statsMap = new Map(aidStats.map((s) => [s.aid, s]));
@@ -686,9 +789,7 @@ export class IpcServer {
                         processTree: processTreeDetails,
                         // 系统级：整机
                         system: {
-                            memTotal: totalMem,
-                            memUsed: totalMem - freeMem,
-                            memFree: freeMem,
+                            ...systemMemory,
                             cpuPercent: Math.round(this.sysCpuPercent * 10) / 10,
                             loadAvg: os.loadavg(), // [1m, 5m, 15m]（Windows 恒 0）
                         },
@@ -716,6 +817,11 @@ export class IpcServer {
  * Returns null if the service is not running or the socket is unreachable.
  */
 export function ipcQuery(socketPath, cmd, timeoutMs = 3000) {
+    const delegationCommandHash = typeof cmd.delegationToken === 'string'
+        && typeof cmd.delegationCommandHash !== 'string'
+        ? hashCurrentDelegatedCommand()
+        : undefined;
+    const request = delegationCommandHash ? { ...cmd, delegationCommandHash } : cmd;
     return new Promise((resolve) => {
         const conn = net.connect(socketPath);
         let buf = '';
@@ -724,7 +830,7 @@ export function ipcQuery(socketPath, cmd, timeoutMs = 3000) {
             resolve(null);
         }, timeoutMs);
         conn.on('connect', () => {
-            conn.write(JSON.stringify(cmd) + '\n');
+            conn.write(JSON.stringify(request) + '\n');
         });
         conn.on('data', (data) => {
             buf += data.toString();

package/dist/paths.js

@@ -86,6 +86,9 @@ export function agentConfig(aid) {
 export function agentContactConfig(aid) {
     return path.join(agentDir(aid), 'contact.json');
 }
+export function agentContactOperations(aid) {
+    return path.join(agentDir(aid), 'contact-operations.jsonl');
+}
 export function agentPersonalDir(aid) {
     return path.join(agentDir(aid), 'personal');
 }

package/dist/response-system/config-resolver.js

@@ -0,0 +1,29 @@
+import { ResponseModeResolver } from './resolver.js';
+/** Extract mode-specific factory defaults from the registered mode schema. */
+export function responseModeSchemaDefaults(mode) {
+    const properties = mode.configSchema?.properties;
+    if (!properties)
+        return {};
+    const defaults = {};
+    for (const [key, spec] of Object.entries(properties)) {
+        if (spec && typeof spec === 'object' && 'default' in spec) {
+            defaults[key] = spec.default;
+        }
+    }
+    return defaults;
+}
+/**
+ * Resolve the selected mode and assemble its effective parameter bucket.
+ * Response processing and pre-processing consumers such as Session Renew must
+ * share this function so they cannot select different mode configurations.
+ */
+export function resolveEffectiveResponseModeConfig(registry, config, resolvedChatMode) {
+    const resolved = new ResponseModeResolver(registry).resolve(config.responseMode);
+    const modeSpecificParams = config.responseModeParams?.[resolved.mode.id] ?? {};
+    const modeConfig = {
+        ...responseModeSchemaDefaults(resolved.mode),
+        ...(resolvedChatMode !== undefined ? { chatmode: resolvedChatMode } : {}),
+        ...modeSpecificParams,
+    };
+    return { ...resolved, modeConfig };
+}

package/dist/response-system/coordinator.js

@@ -13,33 +13,13 @@
  *   - 响应模式成为「响应决策的源头」，下游 message-processor 的执行流程原样保留
  *   - 异常不降级（D6）：解析/决策失败时回落到安全默认，记 WARN
  */
-import { ResponseModeResolver } from './resolver.js';
 import { ResponseModeContextBuilder } from './context-builder.js';
-/**
- * 从模式的 configSchema 提取特有参数出厂默认值：`properties[key].default`。
- *
- * 模式 schema 是模式特有参数「候选值 + 默认值」的唯一事实源（architecture §五）。
- * 宿主组装 modeConfig 时先铺这层默认，再叠用户显式配置——默认来源收敛到 schema，
- * flow 不再硬编码 `?? true` 之类的默认。chatMode 无 default（宿主强制注入），跳过。
- */
-function schemaDefaults(mode) {
-    const props = mode.configSchema?.properties;
-    if (!props)
-        return {};
-    const out = {};
-    for (const [key, spec] of Object.entries(props)) {
-        if (spec && typeof spec === 'object' && 'default' in spec)
-            out[key] = spec.default;
-    }
-    return out;
-}
+import { resolveEffectiveResponseModeConfig } from './config-resolver.js';
 export class ResponseModeCoordinator {
     registry;
-    resolver;
     contextBuilder = new ResponseModeContextBuilder();
     constructor(registry) {
         this.registry = registry;
-        this.resolver = new ResponseModeResolver(registry);
     }
     /**
      * 解析会话该用哪个响应模式 + 构建 context（不调 handleInbound）。
@@ -54,12 +34,11 @@ export class ResponseModeCoordinator {
      */
     resolveMode(responseModeId, resolvedChatMode, responseModeParams, contextDeps) {
         try {
-            const resolved = this.resolver.resolve(responseModeId);
-            const mode = resolved.mode;
-            // 模式特有参数：先铺 schema 出厂默认，再叠用户显式桶（responseModeParams[modeId]，显式值优先）；
-            // chatmode 由宿主解析后强制注入（小写，与配置层 chatmode 字典一致）。
-            const modeSpecificParams = responseModeParams?.[mode.id] ?? {};
-            const modeConfig = { ...schemaDefaults(mode), chatmode: resolvedChatMode, ...modeSpecificParams };
+            const resolved = resolveEffectiveResponseModeConfig(this.registry, {
+                responseMode: responseModeId,
+                responseModeParams,
+            }, resolvedChatMode);
+            const { mode, modeConfig } = resolved;
             contextDeps.logger.debug('[ResponseSystem] resolveMode mode=' + mode.id + ' source=' + resolved.source + ' chatmode=' + (modeConfig.chatmode ?? 'none'));
             const context = this.contextBuilder.build(mode.id, { ...contextDeps, modeConfig });
             return { mode, context, source: resolved.source };
@@ -78,11 +57,8 @@ export class ResponseModeCoordinator {
     async resolveInbound(message, deps, resolvedChatMode) {
         try {
             // 解析模式：标量 responseMode（合并后）> 注册表首选。chatMode 不参与选模式。
-            const resolved = this.resolver.resolve(deps.agentConfig.responseMode);
-            const mode = resolved.mode;
-            // 先铺 schema 出厂默认，再叠用户显式桶（显式值优先），chatmode 强制注入。
-            const modeSpecificParams = deps.agentConfig.responseModeParams?.[mode.id] ?? {};
-            const modeConfig = { ...schemaDefaults(mode), chatmode: resolvedChatMode, ...modeSpecificParams };
+            const resolved = resolveEffectiveResponseModeConfig(this.registry, deps.agentConfig, resolvedChatMode);
+            const { mode, modeConfig } = resolved;
             deps.contextDeps.logger.debug('[ResponseSystem] resolveInbound mode=' + mode.id + ' source=' + resolved.source + ' chatmode=' + (modeConfig.chatmode ?? 'none'));
             const context = this.contextBuilder.build(mode.id, {
                 ...deps.contextDeps,

package/dist/response-system/engines/v1/proactive-flow.js

@@ -19,7 +19,7 @@ function isHumanFacingMessage(message) {
 }
 function buildState(message, cfg) {
     // 默认值不在此硬编码：候选/出厂默认由模式 schema 声明，宿主组装 modeConfig 时注入
-    // （coordinator.schemaDefaults）。此处只读注入后的布尔——键缺失即视为关闭。
+    // （responseModeSchemaDefaults）。此处只读注入后的布尔——键缺失即视为关闭。
     const preTool1stMsgChk = cfg.pre_tool_1stmsgchk === true;
     const toolUseReminder = cfg.tool_use_reminder === true;
     const humanFacing = isHumanFacingMessage(message);

package/dist/response-system/index.js

@@ -4,3 +4,4 @@
  * 统一导出响应系统的所有公共接口
  */
 export { hasAuxiliarySession, hasThreadTracking, hasWorkflow, hasBatchProcessing, hasStatePersistence, } from './extensions.js';
+export { resolveEffectiveResponseModeConfig, responseModeSchemaDefaults, } from './config-resolver.js';

package/dist/response-system/modes/single-session/index.js

@@ -2,12 +2,15 @@ import { FIFOQueue } from '../../queues/fifo-queue.js';
 import { flowForChatMode } from '../../engines/v1/index.js';
 import { loadSchema } from '../../../config/schema-registry.js';
 /**
- * 模式桶 schema —— 候选值与默认值的**唯一事实源**，从 kits/schemas/single-session.schema.1.json
+ * 模式桶 schema —— 候选值与默认值的**唯一事实源**，从当前 single-session schema
  * 读取（随包分发、config schema 子命令可展示、write 时桶专项校验共用同一份）。
- * `default` 即运行时出厂默认，由宿主组装 modeConfig 时提取注入（coordinator.schemaDefaults），
+ * `default` 即运行时出厂默认，由共享 config resolver 组装 modeConfig 时提取注入，
  * flow 不再硬编码默认。chatMode 无 default——由宿主按 chatmode 场景表解析后强制注入。
+ *
+ * 每次现取而非模块初始化时定格：`loadSchema` 自己走 FileCache（读是缓存命中），
+ * 定格反而会绕过 invalidateKitCache——schema 改了、registry 已换新，本模式却仍
+ * 用旧默认值。
  */
-const CONFIG_SCHEMA = loadSchema('single-session').raw;
 /**
  * 单会话响应模式（architecture.md §4.1）—— 合并原 interactive / proactive。
  *
@@ -21,7 +24,7 @@ export class SingleSessionMode {
     description = '单会话直接响应，按 chatMode 决定投递方式。';
     type = 'builtin';
     applicableScenes = ['private', 'group'];
-    configSchema = CONFIG_SCHEMA;
+    get configSchema() { return loadSchema('single-session').raw; }
     queue = new FIFOQueue();
     context;
     async initialize(context) {

package/dist/stats/billing.js

@@ -11,14 +11,20 @@ let _priceCacheTs = 0;
 const PRICE_CACHE_TTL = 5 * 60 * 1000;
 /**
  * 从包路径 + 用户路径合并读取 JSONL 文件。
- * 包路径（$PACKAGE_ROOT/data/stats/）为基线，用户路径（$EVOLCORE_HOME/data/stats/）为追加/覆盖。
+ * 包基线随构建产物发布在 dist/utils，源码运行时回退到 src/utils；
+ * 用户路径（$EVOLCORE_HOME/data/stats/）为追加/覆盖。
  * 两层合并（append），用户层行追加在包层之后——查价时 effective_from 越大越优先，天然正确。
  */
 function _loadJsonlMerged(evolcoreHome, filename) {
     const results = [];
     // 1. 包路径（基线）
-    const pkgFile = path.join(getPackageRoot(), 'data', 'stats', filename);
-    if (fs.existsSync(pkgFile)) {
+    const packageRoot = getPackageRoot();
+    const pkgFile = [
+        path.join(packageRoot, 'dist', 'utils', filename),
+        path.join(packageRoot, 'src', 'utils', filename),
+        path.join(packageRoot, 'data', 'stats', filename),
+    ].find(candidate => fs.existsSync(candidate));
+    if (pkgFile) {
         try {
             const lines = fs.readFileSync(pkgFile, 'utf-8').split('\n').filter(Boolean);
             for (const l of lines)
@@ -28,7 +34,7 @@ function _loadJsonlMerged(evolcoreHome, filename) {
     }
     // 2. 用户路径（追加/覆盖）
     const userFile = path.join(evolcoreHome, 'data', 'stats', filename);
-    if (fs.existsSync(userFile)) {
+    if (fs.existsSync(userFile) && (!pkgFile || path.resolve(userFile) !== path.resolve(pkgFile))) {
         try {
             const lines = fs.readFileSync(userFile, 'utf-8').split('\n').filter(Boolean);
             for (const l of lines)
@@ -81,10 +87,16 @@ export function resolvePriceRow(evolcoreHome, model, ts) {
 export const BILLING_FNS = {
     // 通用 per-token（Claude / OpenAI 兼容 / Kimi / MiniMax）
     per_token_v1: (e, p) => {
-        const r = (p.price_input ?? 0) * e.input_tokens / 1e6
-            + (p.price_output ?? 0) * e.output_tokens / 1e6
-            + (p.price_cache_creation ?? 0) * e.cache_creation_tokens / 1e6
-            + (p.price_cache_read ?? 0) * e.cache_read_tokens / 1e6;
+        const tiers = Array.isArray(p.tiers)
+            ? p.tiers
+            : [];
+        const promptTokens = e.input_tokens + e.cache_creation_tokens + e.cache_read_tokens;
+        const tier = tiers.find(t => t.up_to_input_tokens == null || promptTokens <= t.up_to_input_tokens);
+        const price = tier ?? p;
+        const r = (price.price_input ?? 0) * e.input_tokens / 1e6
+            + (price.price_output ?? 0) * e.output_tokens / 1e6
+            + (price.price_cache_creation ?? 0) * e.cache_creation_tokens / 1e6
+            + (price.price_cache_read ?? 0) * e.cache_read_tokens / 1e6;
         return p.currency === 'CNY' ? { cny: r } : { usd: r };
     },
     // DeepSeek cache_hit / cache_miss 口径

package/dist/trigger/manager.js

@@ -72,6 +72,9 @@ export class TriggerDefinitionManager {
             ...(origin ? { origin } : {}),
         }, { now: Date.now() });
         this.assertAgent(updated);
+        if (existing.execution.baseagent !== updated.execution.baseagent) {
+            throw new Error('execution.baseagent is immutable; create a new Trigger to use another baseagent');
+        }
         updated.createdAt = existing.createdAt;
         updated.updatedAt = Date.now();
         this.assertUnique(updated, triggerId);