evolcore 0.0.1 → 0.0.2

package/dist/cli/queue-command.js

@@ -0,0 +1,126 @@
+import { resolvePaths } from '../paths.js';
+import { ipcQuery } from '../ipc.js';
+import { isHelpFlag } from './help.js';
+export async function cmdQueue(args) {
+    if (args.length === 0 || isHelpFlag(args[0])) {
+        console.log(`用法: ec queue --agent <aid> [选项]
+
+查询与操作 EvolAgent 的消息队列。
+
+查询:
+  --agent <aid>           必填，目标 agent（如 mybot.agentid.pub）
+  --showid                显示 messageId
+  --full                  显示完整消息内容（不截断）
+  --format json           以 JSON 格式输出
+
+操作:
+  --clear                 清空该 agent 的所有待处理消息
+  --cancel <messageId>    取消指定消息
+  --interrupt --sessionkey <key>  打断指定 session 的处理中任务
+
+示例:
+  ec queue --agent mybot.agentid.pub
+  ec queue --agent mybot.agentid.pub --showid
+  ec queue --agent mybot.agentid.pub --clear
+  ec queue --agent mybot.agentid.pub --cancel msg_d4e5f6
+  ec queue --agent mybot.agentid.pub --interrupt --sessionkey feishu#oc_abc123#main`);
+        process.exit(0);
+    }
+    // 解析参数
+    const agentIdx = args.indexOf('--agent');
+    if (agentIdx === -1 || agentIdx + 1 >= args.length) {
+        console.error('❌ 缺少 --agent <aid> 参数');
+        process.exit(1);
+    }
+    const agent = args[agentIdx + 1];
+    const showId = args.includes('--showid');
+    const full = args.includes('--full');
+    const formatJson = args.includes('--format json');
+    const clear = args.includes('--clear');
+    const cancelIdx = args.indexOf('--cancel');
+    const cancelMsgId = cancelIdx >= 0 && cancelIdx + 1 < args.length ? args[cancelIdx + 1] : undefined;
+    const interrupt = args.includes('--interrupt');
+    const sessionKeyIdx = args.indexOf('--sessionkey');
+    const sessionKey = sessionKeyIdx >= 0 && sessionKeyIdx + 1 < args.length ? args[sessionKeyIdx + 1] : undefined;
+    // 构建 IPC 请求
+    const action = clear ? 'clear'
+        : cancelMsgId ? 'cancel'
+            : interrupt ? 'interrupt'
+                : undefined;
+    const socketPath = resolvePaths().socket;
+    const result = await ipcQuery(socketPath, {
+        type: 'queue-snapshot',
+        agent,
+        action,
+        messageId: cancelMsgId,
+        sessionKey,
+    });
+    if (!result) {
+        console.error('错误: 无法连接 evolcore 服务');
+        process.exit(1);
+    }
+    const r = result;
+    // 操作结果
+    if (action) {
+        if (r.ok) {
+            if (action === 'clear')
+                console.log(`✅ 已清空 ${r.cleared ?? 0} 条待处理消息`);
+            else if (action === 'cancel')
+                console.log(`✅ 已取消消息`);
+            else if (action === 'interrupt')
+                console.log(`✅ 已打断处理中任务`);
+        }
+        else {
+            console.error(r.error || '执行失败');
+            process.exit(1);
+        }
+        return;
+    }
+    // 查询结果
+    const items = r.items || [];
+    if (formatJson) {
+        console.log(JSON.stringify({ items }, null, 2));
+        return;
+    }
+    console.log(renderQueueItemsCli(items, showId, full, agent));
+}
+function renderQueueItemsCli(items, showId, full, aid) {
+    const lines = [`${aid} — 队列 (${items.length} 条)`, ''];
+    if (items.length === 0) {
+        lines.push('(无队列消息)');
+        return lines.join('\n');
+    }
+    // 计算列宽
+    const maxSessionKeyLen = Math.max(...items.map(i => i.sessionKey.length));
+    const maxIdLen = showId ? Math.max(...items.map(i => i.messageId?.length ?? 0)) : 0;
+    const maxNameLen = Math.max(...items.map(i => (i.peerName ? `[${i.peerName}]`.length : 0)));
+    const elapsedColWidth = 5;
+    for (const item of items) {
+        const parts = [' '];
+        // 状态列
+        const status = item.status === 'active' ? '[active]' : '[pending]';
+        parts.push(` ${status.padEnd(10)} `);
+        // sessionKey 列
+        parts.push(` ${item.sessionKey.padEnd(maxSessionKeyLen)}  `);
+        // messageId 列（可选）
+        if (showId) {
+            parts.push(` ${(item.messageId || '').padEnd(maxIdLen)}  `);
+        }
+        // 发送者列
+        if (item.peerName) {
+            parts.push(` [${item.peerName}]`.padEnd(maxNameLen + 2) + '  ');
+        }
+        // 时长列
+        let elapsed = '—';
+        if (item.elapsedMs != null) {
+            const sec = Math.round(item.elapsedMs / 1000);
+            elapsed = sec >= 60 ? `${Math.floor(sec / 60)}m${sec % 60}s` : `${sec}s`;
+        }
+        parts.push(` ${elapsed.padEnd(elapsedColWidth)}  `);
+        // 内容列
+        const content = full ? item.preview.replace(/\.\.\.$/, '') : item.preview;
+        parts.push(`"${content}"`);
+        lines.push(parts.join(''));
+    }
+    return lines.join('\n');
+}

package/dist/cli/response.js

@@ -0,0 +1,345 @@
+/**
+ * `ec response` —— 响应模式管理命令集。
+ *
+ * 查看/切换/配置会话的响应模式。作用域由 --self/--peer 决定。
+ *
+ * 三级作用域（越具体越优先：关系 > agent > 全局）：
+ *   (无)             → 全局   defaults.json
+ *   --self           → agent  config.json
+ *   --self --peer    → 关系   relations/<peerKey>/config.json
+ *
+ * 改某作用域后，对应范围所有会话的下一条消息即时生效。
+ * 设计见 docs/response-system/command-reference.md。
+ */
+import { isHelpFlag, wantsHelp, getArgValue } from './help.js';
+import { readField, writeField, determineFieldScope, normalizePeer, ModelScopeError, } from '../core/model/field-scope.js';
+import { readFieldWithSource, resolveAgentConfig, ConfigTarget } from '../config/config-manager.js';
+import { ResponseModeRegistry } from '../response-system/registry.js';
+import { registerBuiltinModes } from '../response-system/modes/index.js';
+const RESPONSE_MODE_FIELD = 'responseMode';
+const RESPONSE_MODE_PARAMS_FIELD = 'responseModeParams';
+/**
+ * CLI 侧的响应模式清单 = 真实注册表（registerBuiltinModes 纯函数、无 daemon 依赖）。
+ * 保证 ec response list/info/set 看到的与运行时实际注册的一致。
+ */
+function buildRegistry() {
+    const reg = new ResponseModeRegistry();
+    registerBuiltinModes(reg);
+    return reg;
+}
+/** 从模式实例提取展示用元数据（供 list/info 输出）。 */
+function modeMeta(m) {
+    return {
+        id: m.id,
+        displayName: m.displayName,
+        description: m.description,
+        applicableScenes: m.applicableScenes,
+        type: m.type,
+        configSchema: m.configSchema,
+    };
+}
+function emit(formatJson, payload, textFn) {
+    if (formatJson) {
+        console.log(JSON.stringify(payload, null, 2));
+    }
+    else {
+        console.log(textFn());
+    }
+}
+function fail(formatJson, code, message) {
+    if (formatJson) {
+        console.log(JSON.stringify({ ok: false, code, error: message }, null, 2));
+    }
+    else {
+        console.error(`❌ ${message} (${code})`);
+    }
+    process.exit(1);
+}
+/** 解析 --self / --peer 为作用域选择器 */
+function parseSelector(args, formatJson) {
+    const self = getArgValue(args, '--self');
+    const peerRaw = getArgValue(args, '--peer');
+    let peerKey;
+    if (peerRaw !== undefined) {
+        try {
+            peerKey = normalizePeer(peerRaw);
+        }
+        catch (e) {
+            if (e instanceof ModelScopeError)
+                fail(formatJson, e.code, e.message);
+            throw e;
+        }
+    }
+    if (peerKey && !self) {
+        fail(formatJson, 'PEER_WITHOUT_SELF', '--peer 必须配合 --self 使用');
+    }
+    return { self, peerKey };
+}
+/**
+ * 写操作的作用域解析：要求至少 agent 级（--self）。
+ * responseMode 是行为参数，不落 defaults（与 model 命令一致，全局作用域已退场）。
+ */
+function parseWriteSelector(args, formatJson) {
+    const sel = parseSelector(args, formatJson);
+    if (!sel.self) {
+        fail(formatJson, 'SELF_REQUIRED', 'responseMode 从 agent 级起：写操作必须提供 --self（全局默认不承载行为参数）');
+    }
+    return sel;
+}
+/** 统一捕获写入异常（ConfigError / ModelScopeError），显示友好错误 */
+function safeWrite(formatJson, fn) {
+    try {
+        fn();
+    }
+    catch (e) {
+        const code = e?.code ?? 'WRITE_FAILED';
+        const msg = e?.message ?? String(e);
+        fail(formatJson, code, msg);
+    }
+}
+/**
+ * 解析**生效**的 responseMode（标量，合并链 relation > agent > defaults）。
+ *
+ * 与运行时 ResponseModeResolver、`ec config get responseMode` 同源：都走合并链，而不是
+ * 只读当前作用域的单个文件。返回命中的值 + 来源层（未命中任何层返回空对象）。
+ */
+function resolveResponseMode(sel) {
+    const hit = readFieldWithSource(RESPONSE_MODE_FIELD, sel, { cache: true });
+    return hit ? { mode: hit.value, source: hit.source.target } : {};
+}
+/**
+ * 解析**生效**的 responseModeParams（字典，按模式 id 分桶 dict 合并链）。
+ * 复用 ConfigManager 的合并（唯一合并点），与运行时一致。
+ */
+function resolveResponseModeParams(sel) {
+    const merged = resolveAgentConfig(sel, { cache: true });
+    return merged.responseModeParams;
+}
+/** 中文展示用的来源标签 */
+function sourceLabel(target) {
+    switch (target) {
+        case ConfigTarget.Relation: return '关系级';
+        case ConfigTarget.Agent: return 'agent 级';
+        case ConfigTarget.Defaults: return '全局默认';
+        default: return String(target);
+    }
+}
+const HELP = `用法: ec response <command> [options]
+
+Commands:
+  list                列出所有响应模式（内置 + 元数据）
+  current             显示当前作用域生效的模式 + 参数
+  info <mode-id>      查看单个模式详情（场景/配置参数）
+  set <mode-id>       设置响应模式
+  reset               清除指定作用域的 responseMode 设置
+  config <mode-id>    查看指定模式的配置参数
+  config set <k> <v>  修改模式配置参数（--mode 指定模式）
+
+作用域（由参数决定，越具体越优先：关系 > agent）:
+  --self <aid>                   agent级   → config.json
+  --self <aid> --peer <X>        关系级    → relations/<peerKey>/config.json
+
+Options:
+  --self <aid>        本端 AID
+  --peer <X>          对端：channelType#channelId 或裸 aid（裸 aid 视为 aun#<aid>）
+  --mode <id>         模式 id（config set 专用）
+  --format json       输出 JSON
+  --help, -h          各子命令均支持
+
+示例:
+  ec response list
+  ec response current --self bot.agentid.pub
+  ec response info dual-session
+  ec response set single-session --self bot.agentid.pub
+  ec response set workflow --self bot.agentid.pub --peer aun#team.group.com
+  ec response config dual-session --self bot.agentid.pub
+  ec response config set debounceMs 5000 --mode dual-session --self bot.agentid.pub
+  ec response reset --self bot.agentid.pub --peer alice.agentid.pub`;
+// ── list ────────────────────────────────────────────────────────────────
+function cmdList(args, formatJson) {
+    if (wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    const reg = buildRegistry();
+    const preferred = reg.getPreferredId();
+    const modes = reg.list().map(modeMeta);
+    emit(formatJson, { ok: true, modes, preferred }, () => {
+        const lines = ['已注册响应模式:'];
+        for (const m of modes) {
+            const scenes = m.applicableScenes.join(', ');
+            const star = m.id === preferred ? ' ★首选' : '';
+            lines.push(`  ${m.id.padEnd(20)} ${m.displayName.padEnd(14)} [${scenes}]${star}`);
+            lines.push(`  ${' '.repeat(20)} ${m.description}`);
+        }
+        return lines.join('\n');
+    });
+}
+// ── current ─────────────────────────────────────────────────────────────
+function cmdCurrent(args, formatJson) {
+    if (wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    const sel = parseSelector(args, formatJson);
+    const scope = determineFieldScope(sel);
+    // 生效值走合并链（relation > agent > defaults），与运行时 resolver / `ec config get` 一致。
+    // 无任何层设值时，回落注册表首选——这才是运行时真正生效的模式。
+    const { mode: configuredMode, source } = resolveResponseMode(sel);
+    const preferred = buildRegistry().getPreferredId();
+    const effectiveMode = configuredMode ?? preferred;
+    const params = resolveResponseModeParams(sel);
+    emit(formatJson, {
+        ok: true,
+        scope,
+        responseMode: effectiveMode ?? null,
+        source: configuredMode ? 'config' : 'preferred',
+        sourceTarget: source ?? null,
+        responseModeParams: params ?? null,
+    }, () => {
+        const lines = [`响应模式配置（作用域: ${scope}）:`];
+        if (configuredMode) {
+            lines.push(`  当前模式: ${configuredMode}（来源: ${source ? sourceLabel(source) : '配置'}）`);
+        }
+        else {
+            lines.push(`  当前模式: ${effectiveMode ?? '(无)'}（来源: 注册表首选，各层均未设置）`);
+        }
+        if (params && Object.keys(params).length) {
+            lines.push('  模式参数:');
+            for (const [modeId, cfg] of Object.entries(params)) {
+                lines.push(`    ${modeId}: ${JSON.stringify(cfg)}`);
+            }
+        }
+        return lines.join('\n');
+    });
+}
+// ── info ────────────────────────────────────────────────────────────────
+function cmdInfo(args, formatJson) {
+    if (wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    const id = args.find(a => !a.startsWith('--') && a !== 'info');
+    if (!id)
+        fail(formatJson, 'MISSING_ID', 'info 需要模式 id');
+    const mode = buildRegistry().get(id);
+    if (!mode)
+        fail(formatJson, 'UNKNOWN_MODE', `未知模式: ${id}`);
+    const meta = modeMeta(mode);
+    emit(formatJson, { ok: true, mode: meta }, () => {
+        const lines = [
+            `模式: ${meta.id}`,
+            `显示名: ${meta.displayName}`,
+            `类型: ${meta.type}`,
+            `描述: ${meta.description}`,
+            `适用场景: ${meta.applicableScenes.join(', ')}`,
+        ];
+        const props = meta.configSchema?.properties;
+        if (props && Object.keys(props).length) {
+            lines.push('配置参数:');
+            for (const [k, v] of Object.entries(props)) {
+                const def = v.default !== undefined ? ` 默认: ${JSON.stringify(v.default)}` : '';
+                lines.push(`  ${k.padEnd(22)} (${v.type}) ${v.description ?? ''}${def}`);
+            }
+        }
+        return lines.join('\n');
+    });
+}
+// ── set ─────────────────────────────────────────────────────────────────
+function cmdSet(args, formatJson) {
+    if (wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    const id = args.find(a => !a.startsWith('--') && a !== 'set');
+    if (!id)
+        fail(formatJson, 'MISSING_ID', 'set 需要模式 id');
+    if (!buildRegistry().has(id))
+        fail(formatJson, 'UNKNOWN_MODE', `未知模式: ${id}`);
+    const sel = parseWriteSelector(args, formatJson);
+    const scope = determineFieldScope(sel);
+    safeWrite(formatJson, () => writeField(scope, sel, RESPONSE_MODE_FIELD, id));
+    emit(formatJson, { ok: true, scope, mode: id }, () => `✓ 已设置响应模式为 ${id}（作用域: ${scope}）`);
+}
+// ── reset ───────────────────────────────────────────────────────────────
+function cmdReset(args, formatJson) {
+    if (wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    const sel = parseWriteSelector(args, formatJson);
+    const scope = determineFieldScope(sel);
+    safeWrite(formatJson, () => {
+        writeField(scope, sel, RESPONSE_MODE_FIELD, undefined);
+        writeField(scope, sel, RESPONSE_MODE_PARAMS_FIELD, undefined);
+    });
+    emit(formatJson, { ok: true, scope }, () => `✓ 已清除响应模式配置（作用域: ${scope}）`);
+}
+// ── config ──────────────────────────────────────────────────────────────
+function cmdConfig(args, formatJson) {
+    if (wantsHelp(args)) {
+        console.log(HELP);
+        return;
+    }
+    // config set <key> <value>
+    if (args[1] === 'set') {
+        return cmdConfigSet(args, formatJson);
+    }
+    // config [<mode-id>]：查看**生效**模式配置（合并链，与运行时一致）
+    const modeId = args.find(a => !a.startsWith('--') && a !== 'config');
+    const sel = parseSelector(args, formatJson);
+    const params = resolveResponseModeParams(sel) ?? {};
+    if (modeId) {
+        emit(formatJson, { ok: true, mode: modeId, config: params[modeId] ?? {} }, () => `${modeId} 配置: ${JSON.stringify(params[modeId] ?? {}, null, 2)}`);
+    }
+    else {
+        emit(formatJson, { ok: true, responseModeParams: params }, () => `所有模式配置: ${JSON.stringify(params, null, 2)}`);
+    }
+}
+function cmdConfigSet(args, formatJson) {
+    // args: ['config', 'set', '<key>', '<value>', ...flags]
+    const key = args[2];
+    const rawValue = args[3];
+    const modeId = getArgValue(args, '--mode');
+    if (!modeId)
+        fail(formatJson, 'MISSING_MODE', 'config set 需要 --mode <id>');
+    if (!key || rawValue === undefined)
+        fail(formatJson, 'MISSING_KV', 'config set 需要 <key> <value>');
+    if (!buildRegistry().has(modeId))
+        fail(formatJson, 'UNKNOWN_MODE', `未知模式: ${modeId}`);
+    // 值解析：尝试 JSON（数字/布尔/数组），失败则当字符串
+    let value = rawValue;
+    try {
+        value = JSON.parse(rawValue);
+    }
+    catch { /* keep string */ }
+    const sel = parseWriteSelector(args, formatJson);
+    const scope = determineFieldScope(sel);
+    // 写路径是 read-modify-write：只读**目标层自身**的桶，绝不能读合并链——否则会把
+    // 继承来的父层参数一并写进本层文件，污染覆盖关系。
+    const params = (readField(scope, sel, RESPONSE_MODE_PARAMS_FIELD) || {});
+    if (!params[modeId])
+        params[modeId] = {};
+    params[modeId][key] = value;
+    safeWrite(formatJson, () => writeField(scope, sel, RESPONSE_MODE_PARAMS_FIELD, params));
+    emit(formatJson, { ok: true, scope, mode: modeId, key, value }, () => `✓ 已设置 ${modeId}.${key} = ${JSON.stringify(value)}（作用域: ${scope}）`);
+}
+// ── dispatch ──────────────────────────────────────────────────────────────
+export async function cmdResponse(args) {
+    const sub = args[0];
+    const formatJson = getArgValue(args, '--format') === 'json';
+    if (!sub || isHelpFlag(sub)) {
+        console.log(HELP);
+        return;
+    }
+    switch (sub) {
+        case 'list': return cmdList(args, formatJson);
+        case 'current': return cmdCurrent(args, formatJson);
+        case 'info': return cmdInfo(args, formatJson);
+        case 'set': return cmdSet(args, formatJson);
+        case 'reset': return cmdReset(args, formatJson);
+        case 'config': return cmdConfig(args, formatJson);
+        default:
+            fail(formatJson, 'UNKNOWN_SUBCOMMAND', `未知子命令: ${sub}（response --help 查看用法）`);
+    }
+}