evolcore 0.0.32 → 0.0.33

package/dist/cli/session-command.js

@@ -0,0 +1,194 @@
+import path from 'path';
+import fs from 'fs';
+import { resolvePaths, resolveRoot } from '../paths.js';
+import { scanChatDirs, readLastJsonlLine, } from '../core/session/session-fs-store.js';
+const HELP_TEXT = `
+ec session <command> [options]
+
+本地会话文件查询（不经过 daemon，直接读 $EVOLCORE_HOME/agents/ 下的 session 存档）。
+
+命令:
+  find <sessionId>          按 ec 会话 id（meta_YYYYMMDD_<ts>）定位 session 文件，
+                            输出 agentSessionId 与所在位置等元数据
+  help                      显示本帮助
+
+选项:
+  --format json             以 JSON 格式输出（默认按人类可读格式）
+
+说明:
+  meta_<ts> 这个 id 只含时间戳，不含路径信息。物理布局是
+  agents/<selfAid>/sessions/<channelSessionKey>/，主会话的 meta 文件在目录根，
+  话题会话的在 _threads/ 子目录。find 通过文件名扫描全量 chat 目录定位，
+  同一 id 理论上可命中多处（不同 agent/对端），全部列出。
+`.trim();
+function argValue(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+function hasFlag(args, flag) {
+    return args.includes(flag);
+}
+/**
+ * 在单个 chat 目录中查找指定 meta 文件名。
+ * 主会话 meta 位于目录根；话题会话 meta 位于 _threads/ 下。
+ */
+function findMetaInChatDir(chatDir, metaFileName) {
+    const hits = [];
+    for (const dir of [chatDir, path.join(chatDir, '_threads')]) {
+        try {
+            const entries = fs.readdirSync(dir);
+            if (entries.includes(metaFileName))
+                hits.push(path.join(dir, metaFileName));
+        }
+        catch { /* 目录不存在，跳过 */ }
+    }
+    return hits;
+}
+/** 在 _trash 中查找（话题删除后 session 文件移入 _trash）。 */
+function findMetaInTrash(chatDir, metaFileName) {
+    const trashDir = path.join(chatDir, '_trash');
+    const hits = [];
+    try {
+        for (const entry of fs.readdirSync(trashDir)) {
+            if (entry === metaFileName || entry === `${metaFileName}.jsonl`) {
+                hits.push(path.join(trashDir, entry));
+            }
+        }
+    }
+    catch { /* 目录不存在，跳过 */ }
+    return hits;
+}
+async function cmdFind(args) {
+    const jsonFormat = hasFlag(args, '--format') && argValue(args, '--format') === 'json'
+        || hasFlag(args, '--json');
+    // 位置参数已在调用处剥掉子命令，第一个非 flag 参数即 sessionId
+    const rawId = args.find(a => !a.startsWith('-'));
+    if (!rawId) {
+        console.error('用法: ec session find <sessionId> [--format json]');
+        process.exitCode = 1;
+        return;
+    }
+    // 允许传入带或不带 .jsonl 后缀的 id
+    const sessionId = rawId.endsWith('.jsonl') ? rawId.slice(0, -'.jsonl'.length) : rawId;
+    if (!sessionId.startsWith('meta_')) {
+        console.error(`✗ ec 会话 id 应以 meta_ 开头（如 meta_20261012_1791789158257），收到: ${rawId}`);
+        process.exitCode = 1;
+        return;
+    }
+    const metaFileName = `${sessionId}.jsonl`;
+    const p = resolvePaths();
+    const chatDirs = scanChatDirs(p.sessionsDir);
+    const found = [];
+    for (const chat of chatDirs) {
+        const locations = [
+            ...findMetaInChatDir(chat.dirPath, metaFileName),
+            ...findMetaInTrash(chat.dirPath, metaFileName),
+        ];
+        for (const metaFile of locations) {
+            const meta = readLastJsonlLine(metaFile);
+            if (!meta)
+                continue;
+            found.push({
+                sessionId: meta.id || sessionId,
+                metaFile,
+                sessionKey: meta.sessionKey,
+                agentSessionId: meta.agentSessionId ?? null,
+                baseagent: meta.baseagent ?? null,
+                threadId: meta.threadId ?? null,
+                name: meta.name ?? null,
+                chatType: meta.chatType ?? null,
+                channelId: meta.channelId ?? chat.channelId,
+                selfAID: chat.selfAID,
+                projectPath: meta.projectPath ?? null,
+                updatedAt: meta.updatedAt,
+                updatedAtStr: meta.updatedAtStr,
+                createdAtStr: meta.createdAtStr,
+            });
+        }
+    }
+    // 兜底：active.json 的 id 字段也可能匹配（active 是 meta 的最新版快照）
+    if (found.length === 0) {
+        for (const chat of chatDirs) {
+            const activeFile = path.join(chat.dirPath, 'active.json');
+            const active = readJsonFileSafe(activeFile);
+            if (active && active.id === sessionId) {
+                found.push({
+                    sessionId,
+                    metaFile: activeFile,
+                    sessionKey: active.sessionKey,
+                    agentSessionId: active.agentSessionId ?? null,
+                    baseagent: active.baseagent ?? null,
+                    threadId: active.threadId ?? null,
+                    name: active.name ?? null,
+                    chatType: active.chatType ?? null,
+                    channelId: active.channelId ?? chat.channelId,
+                    selfAID: chat.selfAID,
+                    projectPath: active.projectPath ?? null,
+                    updatedAt: active.updatedAt,
+                    updatedAtStr: active.updatedAtStr,
+                    createdAtStr: active.createdAtStr,
+                });
+            }
+        }
+    }
+    if (found.length === 0) {
+        if (jsonFormat) {
+            console.log(JSON.stringify({ ok: false, sessionId, found: [] }, null, 2));
+        }
+        else {
+            console.error(`✗ 未找到会话 ${sessionId}（已扫描 ${resolveRoot()} 下 ${chatDirs.length} 个 chat 目录）`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (jsonFormat) {
+        console.log(JSON.stringify({ ok: true, sessionId, found }, null, 2));
+        return;
+    }
+    for (const f of found) {
+        console.log(`ec 会话 id: ${f.sessionId}`);
+        console.log(`  agentSessionId: ${f.agentSessionId ?? '(空)'}`);
+        console.log(`  baseagent: ${f.baseagent ?? '(未知)'}`);
+        console.log(`  threadId: ${f.threadId ? f.threadId : '(主会话)'}`);
+        if (f.name)
+            console.log(`  名称: ${f.name}`);
+        if (f.chatType)
+            console.log(`  类型: ${f.chatType === 'group' ? '群聊' : '单聊'}`);
+        console.log(`  对端: ${f.channelId ?? ''}`);
+        console.log(`  本端 AID: ${f.selfAID ?? ''}`);
+        if (f.projectPath)
+            console.log(`  项目: ${f.projectPath}`);
+        if (f.updatedAtStr)
+            console.log(`  最近更新: ${f.updatedAtStr}`);
+        console.log(`  meta 文件: ${f.metaFile}`);
+        if (f.metaFile.includes('_trash'))
+            console.log(`  ⚠ 该话题已删除（文件在 _trash 中）`);
+        console.log('');
+    }
+}
+// readJsonFile 在 session-fs-store 中未导出别名导入成本高，这里本地实现同语义
+function readJsonFileSafe(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function runSessionCommand(args) {
+    const sub = args[0];
+    if (!sub || sub === 'help' || hasFlag(args, '--help') || hasFlag(args, '-h')) {
+        console.log(HELP_TEXT);
+        return;
+    }
+    switch (sub) {
+        case 'find':
+            await cmdFind(args.slice(1));
+            break;
+        default:
+            console.error(`✗ 未知子命令: ${sub}`);
+            console.log(HELP_TEXT);
+            process.exitCode = 1;
+    }
+}

package/dist/cli/skill-command.js

@@ -13,12 +13,35 @@
  * 两个入口（这里的 spawn 与模型侧直接 node脚本）环境变量一致，
  * 脚本自己读 EVOLCORE_TASK_RUNTIME_CONTEXT 即可得到相同判据；
  * 若在 CLI 层再判一遍，只是多一处会与脚本漂移的实现。
+ *
+ * 例外：`refresh` 不进脚本，直接走 daemon IPC（skill.refresh）——索引由 daemon
+ * 内的 index-generator 生成，鉴权也在 daemon 里做。其余子命令后续逐个迁到 IPC，
+ * 见 docs/skills/skill-refresh-ipc-implementation-plan.md。
  */
 import path from 'path';
 import { spawn } from 'child_process';
-import { getPackageRoot, agentDir } from '../paths.js';
-import { authorizeLocalCommand, readTaskRuntimeContextFromEnv, TASK_RUNTIME_CONTEXT_ENV } from './task-context.js';
+import { getPackageRoot, agentDir, resolvePaths } from '../paths.js';
+import { readTaskRuntimeContextFromEnv } from './task-context.js';
+import { ipcQuery } from '../ipc.js';
+import { readDelegationCredential } from '../core/auth/agent-delegation.js';
+import { authorizeLocalCommand, TASK_RUNTIME_CONTEXT_ENV } from './task-context.js';
+import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
+const REFRESH_USAGE = `用法: ec skill refresh <aid> [--json]
+
+重建指定 Agent 的技能索引文件（$AGENT_DIR/skills/.index-builtin.md / .index-local.md）。
+由 daemon 生成，daemon 未运行时无法执行。
+
+权限:
+  托管任务内  只能刷新当前 Agent，需要 owner 或 admin 角色
+  宿主终端    可刷新任意 Agent
+
+示例:
+  ec skill refresh alice.agentid.pub`;
 export async function cmdSkill(args) {
+    if (args[0] === 'refresh') {
+        await cmdSkillRefresh(args.slice(1));
+        return;
+    }
     const script = path.join(getPackageRoot(), 'kits', 'skills', 'ec-skill', 'scripts', 'cli.mjs');
     // 脚本在包外运行，拿不到主程序的路径工具，这里把 Agent 目录显式传进去，
     // 让它能定位 Agent 级 skills/ 与 .switches.json。
@@ -45,3 +68,56 @@ export async function cmdSkill(args) {
     if (code !== 0)
         process.exitCode = code;
 }
+async function cmdSkillRefresh(args) {
+    const asJson = args.includes('--json');
+    const positional = args.filter(a => !a.startsWith('--'));
+    if (args.includes('--help') || args.includes('-h') || positional.length === 0) {
+        console.log(REFRESH_USAGE);
+        if (positional.length === 0 && !args.includes('--help') && !args.includes('-h'))
+            process.exitCode = 1;
+        return;
+    }
+    const aid = positional[0];
+    const argv = canonicalizeEvolcoreCommandArgv(['ec', 'skill', 'refresh', ...args]).slice(1);
+    // 托管任务带会话与委托令牌；宿主终端两者都不带，由 ipcQuery 自动附上本机 control token。
+    const sessionId = process.env.EVOLCORE_SESSION_ID;
+    const delegationToken = sessionId ? readDelegationCredential() : undefined;
+    if (sessionId && !delegationToken) {
+        console.error('❌ 刷新失败 (DELEGATION_REQUIRED): 当前任务缺少委托令牌');
+        process.exitCode = 1;
+        return;
+    }
+    let response;
+    try {
+        response = await ipcQuery(resolvePaths().socket, {
+            type: 'skill.refresh',
+            aid,
+            argv,
+            ...(sessionId ? { sessionId, delegationToken } : {}),
+        }, 30_000, { throwOnError: true });
+    }
+    catch (e) {
+        console.error(`❌ 刷新失败 (DAEMON_UNAVAILABLE): ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (asJson) {
+        console.log(JSON.stringify(response ?? { ok: false, code: 'DAEMON_UNAVAILABLE' }, null, 2));
+        if (!response?.ok)
+            process.exitCode = 1;
+        return;
+    }
+    if (!response?.ok) {
+        const code = response?.code ?? (response ? 'FAILED' : 'DAEMON_UNAVAILABLE');
+        console.error(`❌ 刷新失败 (${code}): ${response?.error ?? '无法连接 evolcore daemon'}`);
+        if (response?.data?.nextStep)
+            console.error(`   ${response.data.nextStep}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`✓ 已重建 ${aid} 的技能索引`);
+    if (response.result) {
+        console.log(`  内置: ${response.result.builtinIndexPath}`);
+        console.log(`  本机: ${response.result.localIndexPath}`);
+    }
+}

package/dist/cli/task-context.js

@@ -31,6 +31,7 @@ function normalizeTaskRuntimeContext(value) {
         messageId: optionalString(value.messageId),
         baseagent: optionalString(value.baseagent),
         channel: optionalString(value.channel),
+        channelKey: optionalString(value.channelKey),
         channelId: optionalString(value.channelId),
         chatType: optionalString(value.chatType),
         selfAid: optionalString(value.selfAid),