evolcore 0.0.31 → 0.0.33

package/dist/cli/model.js

@@ -19,10 +19,8 @@ import { resolvePaths } from '../paths.js';
 import { ipcQuery } from '../ipc.js';
 import { parsePeerKey } from '../core/relation/peer-identity.js';
 import { resolvePeerRoleDetail } from '../config/peer-role-resolver.js';
-import { getFieldPermission } from '../config/roles.js';
 import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { formatModelCheck, runModelCheck } from '../core/model/model-diagnostics.js';
-import { validateRuntimeStringFieldOverride } from '../core/role/runtime-policy.js';
 const ALL_EFFORTS = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'auto'];
 const SCOPE_LABEL = {
     global: '全局', agent: 'agent级', role: '角色级', relation: '关系级',
@@ -45,29 +43,21 @@ function fail(formatJson, code, message, data) {
     }
     process.exit(1);
 }
-function isManagedSessionEnv(args) {
-    void args;
-    return !!process.env.EVOLCORE_SESSION_ID;
-}
-function isManagedTargetedWriteEnv(args) {
-    return !!process.env.EVOLCORE_SESSION_ID
-        && !isManagedSessionEnv(args);
-}
-async function runCtlCommand(cmd, formatJson, timeoutMs = 10_000) {
+async function runManagedCliOperation(args, formatJson, timeoutMs = 10_000) {
     const sessionId = process.env.EVOLCORE_SESSION_ID;
     if (!sessionId)
         fail(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID 未设置');
-    const result = await ipcQuery(resolvePaths().socket, {
-        type: 'ctl',
-        cmd,
-        sessionId,
-        delegationToken: readDelegationCredential(),
+    const delegationToken = readDelegationCredential();
+    if (!delegationToken)
+        fail(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} 未设置`);
+    const response = await ipcQuery(resolvePaths().socket, {
+        type: 'ctl', argv: args, sessionId, delegationToken,
     }, timeoutMs);
-    if (!result)
+    if (!response)
         fail(formatJson, 'DAEMON_UNAVAILABLE', '无法连接 evolcore 服务');
-    if (!result.ok)
-        fail(formatJson, 'CTL_FAILED', result.error || 'ctl 执行失败');
-    return { text: String(result.result || ''), data: result.data };
+    if (!response.ok)
+        fail(formatJson, response.code || 'CTL_FAILED', response.error || '命令执行失败');
+    printCtlResult({ text: response.result || '', data: response.data }, formatJson);
 }
 function printCtlResult(result, formatJson) {
     if (formatJson) {
@@ -76,56 +66,6 @@ function printCtlResult(result, formatJson) {
     }
     console.log(result.text);
 }
-async function runManagedConfigOperation(args, formatJson) {
-    const sessionId = process.env.EVOLCORE_SESSION_ID;
-    if (!sessionId)
-        fail(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID 未设置');
-    const delegationToken = readDelegationCredential();
-    if (!delegationToken) {
-        fail(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} 未设置`);
-    }
-    let response;
-    try {
-        response = await ipcQuery(resolvePaths().socket, {
-            type: 'config.op',
-            argv: ['config', ...args],
-            sessionId,
-            delegationToken,
-        }, 10_000);
-    }
-    catch {
-        response = null;
-    }
-    if (!response)
-        fail(formatJson, 'DAEMON_UNAVAILABLE', '无法连接 evolcore 服务');
-    if (!response.ok || !response.result?.ok) {
-        fail(formatJson, response.code || 'CONFIG_AUTH_FAILED', response.error || 'config 操作失败', response.data);
-    }
-}
-function configSelectorArgs(sel) {
-    const args = ['--self', sel.self];
-    if (sel.peerKey)
-        args.push('--peer', sel.peerKey);
-    return args;
-}
-async function setManagedModelField(sel, field, value, formatJson) {
-    const subcommand = value === null ? ['unset', field] : ['set', field, value];
-    await runManagedConfigOperation([...subcommand, ...configSelectorArgs(sel)], formatJson);
-}
-function preflightManagedFieldOverride(sel, role, field, value, formatJson) {
-    if (!role)
-        return;
-    const policy = getFieldPermission(role, field, sel.self);
-    if (policy?.allowOverride === false) {
-        fail(formatJson, 'ROLE_OVERRIDE_DISABLED', `Role ${role} cannot override ${field}`);
-    }
-    if (value === null)
-        return;
-    const decision = validateRuntimeStringFieldOverride({ selfAid: sel.self, role, field, value });
-    if (!decision.ok) {
-        fail(formatJson, decision.code || 'ROLE_VALUE_NOT_ALLOWED', decision.message || `Value ${value} is not allowed for ${field}`);
-    }
-}
 /**
  * 解析 --self / --peer 为作用域选择器。
  */
@@ -286,11 +226,6 @@ async function cmdList(args, formatJson) {
         console.log(HELP);
         return;
     }
-    if (isManagedSessionEnv(args)) {
-        const out = await runCtlCommand('/model list', formatJson);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const role = explicitOrDerivedRole(args, sel);
     const effectiveSel = selectorWithRole(sel, role);
@@ -337,11 +272,6 @@ async function cmdCurrent(args, formatJson) {
         console.log(HELP);
         return;
     }
-    if (isManagedSessionEnv(args)) {
-        const out = await runCtlCommand('/model current', formatJson);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const ba = activeBaseagent(sel.self);
     const role = explicitOrDerivedRole(args, sel);
@@ -372,11 +302,6 @@ async function cmdInfo(args, formatJson) {
     const modelId = args[1] && !args[1].startsWith('--') ? args[1] : undefined;
     if (!modelId)
         fail(formatJson, 'MISSING_MODEL_ID', 'info 需要 <model-id>');
-    if (isManagedSessionEnv(args)) {
-        const out = await runCtlCommand(`/model info ${modelId}`, formatJson);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const self = getArgValue(args, '--self');
     const info = await getModelInfo(modelId, self);
@@ -424,12 +349,6 @@ async function cmdUse(args, formatJson) {
     const modelId = args[1] && !args[1].startsWith('--') ? args[1] : undefined;
     if (!modelId)
         fail(formatJson, 'MISSING_MODEL_ID', 'use 需要 <model-id>');
-    if (isManagedSessionEnv(args)) {
-        const effort = getArgValue(args, '--effort');
-        const out = await runCtlCommand(`/model ${modelId}${effort ? ` ${effort}` : ''}`, formatJson);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const role = explicitOrDerivedRole(args, sel);
     const scope = determineWriteScope(sel, formatJson);
@@ -457,19 +376,6 @@ async function cmdUse(args, formatJson) {
         fail(formatJson, 'INVALID_EFFORT', `当前模型目录未声明支持推理强度: ${effort}`);
     }
     const effortVal = effort === 'auto' ? null : (effort ?? undefined);
-    if (isManagedTargetedWriteEnv(args)) {
-        if (effortVal !== undefined) {
-            const effortKey = 'effort';
-            preflightManagedFieldOverride(sel, role, `baseagents.${ba}.${effortKey}`, effortVal, formatJson);
-        }
-        await setManagedModelField(sel, `baseagents.${ba}.model`, modelId, formatJson);
-        if (effortVal !== undefined) {
-            const effortKey = 'effort';
-            await setManagedModelField(sel, `baseagents.${ba}.${effortKey}`, effortVal, formatJson);
-        }
-        describeWrite(scope, sel, modelId, effort ?? null, formatJson);
-        return;
-    }
     try {
         writeScope(scope, sel, ba, { model: modelId, effort: effortVal });
     }
@@ -491,11 +397,6 @@ async function cmdEffort(args, formatJson) {
     if (!ALL_EFFORTS.includes(level)) {
         fail(formatJson, 'INVALID_EFFORT', `无效推理强度: ${level}（${ALL_EFFORTS.join('/')})`);
     }
-    if (isManagedSessionEnv(args)) {
-        const out = await runCtlCommand(`/effort ${level}`, formatJson);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const scope = determineWriteScope(sel, formatJson);
     const ba = activeBaseagent(sel.self);
@@ -507,13 +408,6 @@ async function cmdEffort(args, formatJson) {
         if (!model || !catalogEfforts(cat, model, ba).includes(val))
             fail(formatJson, 'INVALID_EFFORT', `当前模型目录未声明支持推理强度: ${val}`);
     }
-    if (isManagedTargetedWriteEnv(args)) {
-        const effortKey = 'effort';
-        preflightManagedFieldOverride(sel, explicitOrDerivedRole(args, sel), `baseagents.${ba}.${effortKey}`, val, formatJson);
-        await setManagedModelField(sel, `baseagents.${ba}.${effortKey}`, val, formatJson);
-        describeWrite(scope, sel, null, level, formatJson);
-        return;
-    }
     try {
         writeScope(scope, sel, ba, { effort: val });
     }
@@ -529,26 +423,9 @@ async function cmdReset(args, formatJson) {
         console.log(HELP);
         return;
     }
-    if (isManagedSessionEnv(args)) {
-        const out = await runCtlCommand('/model reset', formatJson);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const scope = determineWriteScope(sel, formatJson);
     const ba = activeBaseagent(sel.self);
-    if (isManagedTargetedWriteEnv(args)) {
-        const effortKey = 'effort';
-        const role = explicitOrDerivedRole(args, sel);
-        preflightManagedFieldOverride(sel, role, `baseagents.${ba}.model`, null, formatJson);
-        preflightManagedFieldOverride(sel, role, `baseagents.${ba}.${effortKey}`, null, formatJson);
-        await setManagedModelField(sel, `baseagents.${ba}.model`, null, formatJson);
-        await setManagedModelField(sel, `baseagents.${ba}.${effortKey}`, null, formatJson);
-        emit(formatJson, {
-            ok: true, scope, self: sel.self ?? null, peerKey: sel.peerKey ?? null,
-        }, () => `✓ 已清除 ${SCOPE_LABEL[scope]} 设置，回落上一级（该范围所有会话下条消息生效）`);
-        return;
-    }
     try {
         clearScope(scope, sel, ba);
     }
@@ -568,11 +445,6 @@ async function cmdCheck(args, formatJson) {
         console.log(HELP);
         return;
     }
-    if (isManagedSessionEnv(args)) {
-        const out = await runCtlCommand('/model check', formatJson, 60_000);
-        printCtlResult(out, formatJson);
-        return;
-    }
     const sel = parseSelector(args, formatJson);
     const role = explicitOrDerivedRole(args, sel);
     const ba = activeBaseagent(sel.self);
@@ -609,5 +481,9 @@ export async function cmdModel(args) {
         && (getArgValue(args, '--self') || getArgValue(args, '--peer') || getArgValue(args, '--role'))) {
         fail(formatJson, 'NOT_ALLOWED', 'Managed model commands cannot select --self, --peer, or --role; they always use the authenticated current relation');
     }
+    if (process.env.EVOLCORE_SESSION_ID) {
+        await runManagedCliOperation(['model', ...args], formatJson, sub === 'check' ? 60_000 : 10_000);
+        return;
+    }
     await dispatch(sub, args, formatJson);
 }

package/dist/cli/queue-command.js

@@ -2,7 +2,9 @@ import { resolvePaths } from '../paths.js';
 import { ipcQuery } from '../ipc.js';
 import { readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
+import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
 export async function cmdQueue(args) {
+    args = canonicalizeEvolcoreCommandArgv(['ec', 'queue', ...args]).slice(2);
     if (args.length === 0 || isHelpFlag(args[0]) || wantsHelp(args)) {
         console.log(`用法: ec queue --agent <aid> [选项]
 
@@ -91,6 +93,7 @@ JSON 时间字段:
     const managed = process.env.EVOLCORE_SESSION_ID;
     const result = await ipcQuery(socketPath, managed ? {
         type: 'queue.op',
+        argv: ['queue', ...args],
         agent,
         action,
         messageId: cancelMsgId,
@@ -147,6 +150,54 @@ function parseQueueTime(value, flag) {
     }
     return parsed;
 }
+export function parseQueueOperationArgv(argv) {
+    if (argv[0] !== 'queue')
+        throw new Error('Expected a queue command');
+    const flags = new Map();
+    const booleanFlags = new Set(['--clear', '--interrupt', '--showid', '--full']);
+    const valueFlags = new Set(['--agent', '--cancel', '--sessionkey', '--after', '--before', '--format']);
+    for (let index = 1; index < argv.length; index++) {
+        const flag = argv[index];
+        if (booleanFlags.has(flag)) {
+            flags.set(flag, 'true');
+        }
+        else if (valueFlags.has(flag) && argv[index + 1] && !argv[index + 1].startsWith('--')) {
+            if (!flags.has(flag))
+                flags.set(flag, argv[index + 1]);
+            index++;
+        }
+        else {
+            throw new Error(`Invalid queue option: ${flag}`);
+        }
+    }
+    const agent = flags.get('--agent');
+    if (!agent)
+        throw new Error('--agent is required');
+    if (flags.has('--format') && flags.get('--format') !== 'json')
+        throw new Error('--format only supports json');
+    if (['--clear', '--cancel', '--interrupt'].filter(flag => flags.has(flag)).length > 1)
+        throw new Error('Queue actions are mutually exclusive');
+    const time = (flag) => {
+        const value = flags.get(flag);
+        if (value === undefined)
+            return undefined;
+        const parsed = /^\d+$/.test(value) ? Number(value) : Date.parse(value);
+        if (!Number.isFinite(parsed))
+            throw new Error(`Invalid ${flag}`);
+        return parsed;
+    };
+    const after = time('--after');
+    const before = time('--before');
+    if (after !== undefined && before !== undefined && after >= before)
+        throw new Error('--after must precede --before');
+    if (flags.has('--interrupt') && !flags.get('--sessionkey'))
+        throw new Error('--interrupt requires --sessionkey');
+    return {
+        agent,
+        action: flags.has('--clear') ? 'clear' : flags.has('--cancel') ? 'cancel' : flags.has('--interrupt') ? 'interrupt' : undefined,
+        messageId: flags.get('--cancel'), sessionKey: flags.get('--sessionkey'), after, before,
+    };
+}
 function renderQueueItemsCli(items, showId, full, aid) {
     const lines = [`${aid} — 队列 (${items.length} 条)`, ''];
     if (items.length === 0) {

package/dist/cli/response.js

@@ -57,7 +57,7 @@ function fail(formatJson, code, message) {
     }
     process.exit(1);
 }
-async function managedConfig(fieldArgs, formatJson) {
+async function runManagedResponse(args, formatJson) {
     const sessionId = process.env.EVOLCORE_SESSION_ID;
     const delegationToken = readDelegationCredential();
     if (!sessionId)
@@ -65,62 +65,13 @@ async function managedConfig(fieldArgs, formatJson) {
     if (!delegationToken)
         fail(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set`);
     const response = await ipcQuery(resolvePaths().socket, {
-        type: 'config.op',
-        argv: ['config', ...fieldArgs],
-        sessionId,
-        delegationToken,
+        type: 'ctl', argv: ['response', ...args], sessionId, delegationToken,
     }, 10_000);
     if (!response)
         fail(formatJson, 'DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
-    if (!response.ok || !response.result?.ok) {
-        fail(formatJson, response.code || 'CONFIG_AUTH_FAILED', response.error || 'response config operation failed');
-    }
-    return response.result;
-}
-async function runManagedResponse(args, formatJson) {
-    if (getArgValue(args, '--self') || getArgValue(args, '--peer')) {
-        fail(formatJson, 'NOT_ALLOWED', 'Managed response commands always use the authenticated current relation');
-    }
-    const sub = args[0];
-    if (sub === 'set') {
-        const id = args[1];
-        if (!id)
-            fail(formatJson, 'MISSING_ID', 'set requires a mode id');
-        if (!buildRegistry().has(id))
-            fail(formatJson, 'UNKNOWN_MODE', `Unknown mode: ${id}`);
-        await managedConfig(['set', RESPONSE_MODE_FIELD, id], formatJson);
-        return emit(formatJson, { ok: true, scope: 'relation', mode: id }, () => `✓ 已设置响应模式为 ${id}（作用域: relation）`);
-    }
-    if (sub === 'reset') {
-        await managedConfig(['unset', RESPONSE_MODE_FIELD], formatJson);
-        return emit(formatJson, { ok: true, scope: 'relation' }, () => '✓ 已清除当前关系的响应模式设置');
-    }
-    if (sub === 'current') {
-        const modeResult = await managedConfig(['get', RESPONSE_MODE_FIELD], formatJson);
-        const paramsResult = await managedConfig(['get', RESPONSE_MODE_PARAMS_FIELD], formatJson);
-        const configuredMode = typeof modeResult.value === 'string' ? modeResult.value : undefined;
-        const mode = configuredMode ?? buildRegistry().getPreferredId();
-        return emit(formatJson, {
-            ok: true,
-            scope: 'relation',
-            responseMode: mode ?? null,
-            source: configuredMode ? 'config' : 'preferred',
-            sourceTarget: modeResult.source?.target ?? null,
-            responseModeParams: paramsResult.value ?? null,
-        }, () => `当前响应模式: ${mode ?? '(无)'}`);
-    }
-    if (sub === 'config') {
-        if (args[1] === 'set') {
-            fail(formatJson, 'NOT_ALLOWED', 'responseModeParams cannot be modified as an opaque object from a managed task');
-        }
-        const result = await managedConfig(['get', RESPONSE_MODE_PARAMS_FIELD], formatJson);
-        const params = result.value ?? {};
-        const modeId = args[1] && !args[1].startsWith('--') ? args[1] : undefined;
-        if (modeId)
-            return emit(formatJson, { ok: true, mode: modeId, config: params[modeId] ?? {} }, () => `${modeId} 配置: ${JSON.stringify(params[modeId] ?? {}, null, 2)}`);
-        return emit(formatJson, { ok: true, responseModeParams: params }, () => `所有模式配置: ${JSON.stringify(params, null, 2)}`);
-    }
-    fail(formatJson, 'NOT_ALLOWED', `response ${sub} is not available in a managed task`);
+    if (!response.ok)
+        fail(formatJson, response.code || 'CTL_FAILED', response.error || 'response operation failed');
+    emit(formatJson, response.data ?? { ok: true, result: response.result }, () => response.result || 'ok');
 }
 /** 解析 --self / --peer 为作用域选择器 */
 function parseSelector(args, formatJson) {

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;
+    }
+}