evolcore 0.0.21 → 0.0.23

package/dist/core/command/slash-handler.js

@@ -1,5 +1,4 @@
 import { hasModelSwitcher, hasPermissionController } from '../../agents/runner-types.js';
-import { getCodexEfforts } from '../../agents/codex-runner.js';
 import { normalizeBaseagent } from '../../agents/baseagent.js';
 import { buildEnvelope, isDeliveryTargetForChannel } from '../message/message-utils.js';
 import { resolvePaths, getPackageRoot, daemonControlDir } from '../../paths.js';
@@ -10,13 +9,14 @@ import path from 'path';
 import fs from 'fs';
 import { checkLatestVersion, getLocalVersion, isLinkedInstall, compareVersions } from '../../utils/npm-ops.js';
 import { loadDaemonConfig } from '../../config-store.js';
+import { remoteAccessService } from '../auth/remote-access-store.js';
 import { read as cfgRead, resolveEffective, routeFieldPath, write as cfgWrite, } from '../../config/config-manager.js';
 import { execAgentAction } from './agent-control.js';
 import { authorizeOperation, buildAuthSubject } from '../auth/auth-gateway.js';
 import { authorizationNextStep, formatAuthorizationDenial } from '../auth/authorization-denial.js';
 import { resolvePermissionMode, writeScope } from '../model/config-scope.js';
 import { formatPeerKey } from '../relation/peer-identity.js';
-import { modelMatches } from '../model/model-catalog.js';
+import { modelMatches, getCatalog, assertCatalogSelectable, resolveCatalogModel } from '../model/model-catalog.js';
 import { formatModelCheck, runModelCheck } from '../model/model-diagnostics.js';
 import { constrainResolvedModelForRole, filterModelsForRole, validateModelSelectionForRole } from '../model/model-permission.js';
 import { resolveRuntimeStringField } from '../role/runtime-policy.js';
@@ -26,8 +26,9 @@ import { normalizePermissionMode as normalizePermissionModeContract, PUBLIC_PERM
 import { isManagementRole } from '../../config/builtin-roles.js';
 import { isSystemControlChannel } from '../system-channels.js';
 import { spawnDetachedNode } from '../../utils/cross-platform.js';
+import { inspectDataMigrationRequirement } from '../data-migration.js';
 import { guardIdleCommand, guardKnownCommand, guardRoleCommand, guardThreadCommand, isRecognizedSlashCommand, normalizeSlashContent, probeSessionActivity, } from './slash-gate.js';
-const allEfforts = ['low', 'medium', 'high', 'xhigh', 'max'];
+const allEfforts = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
 const PERMISSION_MODE_KEYS = PUBLIC_PERMISSION_MODES;
 function defaultSlashChatmode(field) {
     return field === 'private' ? 'interactive' : 'proactive';
@@ -126,12 +127,8 @@ function resolveSlashRelationTarget(params) {
         role: params.role,
     };
 }
-function getAvailableEfforts(agent, model) {
-    if (agent.name === 'claude')
-        return allEfforts;
-    if (agent.name === 'codex')
-        return getCodexEfforts(model);
-    return [];
+async function getAvailableEfforts(agent, model) {
+    return (await agent.getAvailableEfforts?.(model) ?? []);
 }
 function modelDisplayLabel(agent, model) {
     const full = agent.resolveModelId?.(model);
@@ -486,7 +483,8 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
     const isProcessLevelSlash = normalizedContent === '/restart'
         || normalizedContent === '/upgrade'
         || normalizedContent === '/reload'
-        || normalizedContent.startsWith('/reload ');
+        || normalizedContent.startsWith('/reload ')
+        || normalizedContent === '/pair';
     const roleGuard = guardRoleCommand(normalizedContent, activeChatType, isAdmin || (isDaemonOwner && isProcessLevelSlash));
     if (roleGuard)
         return roleGuard;
@@ -634,7 +632,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         const appendProcessCommands = (lines) => {
             if (!isDaemonOwner)
                 return;
-            lines.push('', '🛠️ 进程级运维：', '  /restart - 重启服务', '  /upgrade - 检查版本更新', '  /reload [aid] - 热重载 Agent 配置', '  /fa <提示词> - 单次使用宿主级 fullaccess 执行（别名: /fullaccess）');
+            lines.push('', '🛠️ 进程级运维：', '  /restart - 重启服务', '  /upgrade - 检查版本更新', '  /reload [aid] - 热重载 Agent 配置', '  /fa <提示词> - 单次使用宿主级 fullaccess 执行（别名: /fullaccess）', '  /pair - 获取远程控制配对码');
         };
         if (!isAdmin && activeChatType === 'group') {
             const lines = [
@@ -774,6 +772,23 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         ];
         return { kind: 'command.result', text: lines.join('\n') };
     }
+    // /pair is also recognized on an Agent channel so it cannot fall through
+    // into model input. The daemon control channel has its own fast path; this
+    // branch preserves the same daemon-owner boundary for ordinary AUN chats.
+    if (normalizedContent === '/pair') {
+        if (!isDaemonOwner) {
+            return {
+                kind: 'command.error',
+                text: '❌ /pair 仅限 daemon-owner 使用；请向 daemon 控制 AID 发送 /pair。',
+            };
+        }
+        const pair = remoteAccessService.getPairingCode(userId);
+        const mins = Math.max(0, Math.round((pair.expiresAt - Date.now()) / 60000));
+        return {
+            kind: 'command.result',
+            text: `远程控制配对码：${pair.code}（约 ${mins} 分钟内有效）\n可用于 ECWeb 登录或远程 Menu 客户端授权`,
+        };
+    }
     // /evolhelp 命令：返回 JSON 格式的命令列表（供程序解析）
     if (normalizedContent === '/evolhelp') {
         const cmds = [];
@@ -834,6 +849,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             cmds.push({ command: '/restart', description: '重启服务', category: '运维', roles: ['daemon-owner'] });
             cmds.push({ command: '/upgrade', description: '检查版本更新', category: '运维', roles: ['daemon-owner'] });
             cmds.push({ command: '/reload', args: '[aid]', description: '热重载 Agent 配置', category: '运维', roles: ['daemon-owner'] });
+            cmds.push({ command: '/pair', description: '获取远程控制配对码', category: '运维', roles: ['daemon-owner'] });
         }
         if (!isDaemonOwner && isAdmin) {
             cmds.push({ command: '/reload', description: '热重载当前 Agent 配置', category: '运维', roles: ['admin', 'owner'] });
@@ -1259,12 +1275,14 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             catch { }
             const configuredModel = modelConfig.model;
             const configuredEffort = modelConfig.effort;
-            const rawModels = hasModelSwitcher(modelAgent) ? await modelAgent.listModels() : [];
+            const catalog = await getCatalog(modelSelector.self, fallbackBaseagent);
+            assertCatalogSelectable(catalog);
+            const rawModels = catalog.models.map(m => m.id);
             const models = hasModelSwitcher(modelAgent)
-                ? filterModelsForRole(identity.role, fallbackBaseagent, rawModels, modelAgent.resolveModelId?.bind(modelAgent))
+                ? filterModelsForRole(identity.role, fallbackBaseagent, rawModels, model => resolveCatalogModel(catalog, model), modelSelector.self)
                 : rawModels;
             const currentModel = hasModelSwitcher(modelAgent) ? (configuredModel || modelAgent.getModel()) : modelAgent.name;
-            const efforts = getAvailableEfforts(modelAgent, currentModel);
+            const efforts = await getAvailableEfforts(modelAgent, currentModel);
             const currentEffort = configuredEffort ?? modelAgent.getEffort?.() ?? 'auto';
             const canReadModelList = await canReadSlashModelList({
                 subject: authSubject,
@@ -1289,7 +1307,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                         kind: 'command-card',
                         title: '🤖 切换模型',
                         buttons: models.map((m) => {
-                            const display = modelDisplayLabel(modelAgent, m);
+                            const display = modelDisplayLabel(modelAgent, m) + (catalog.models.find(e => e.id === m)?.verification === 'unverified' ? ' [unverified]' : '');
                             return {
                                 label: modelMatches(modelAgent, m, currentModel) ? `✓ ${display}` : display,
                                 command: `/model ${m}`,
@@ -1306,6 +1324,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 return { kind: 'command.result', text: cardResult };
             }
             // 降级：文本
+            const catalogHint = `[${catalog.source}/${catalog.freshness}] ${catalog.diagnostics.map(d => d.message).join('; ')}`;
             const modelList = models.map((m) => `  ${modelMatches(modelAgent, m, currentModel) ? '✓' : ' '} ${modelDisplayLabel(modelAgent, m)}`).join('\n');
             const effortHint = efforts.length > 0
                 ? `\n推理强度: ${currentEffort === 'auto' ? 'auto (SDK默认)' : currentEffort}  (使用 /effort 调整)`
@@ -1321,8 +1340,8 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 const usage = !args && isAdmin ? '\n\n用法: /model <模型>' : '';
                 return {
                     kind: 'command.result',
-                    text: `当前模型: ${modelDisplayLabel(modelAgent, currentModel)}${effortHint}\n\n可用模型：\n${modelList}${usage}`,
-                    ...(args === 'list' ? { structured: { ok: true, model: currentModel, effort: currentEffort, baseagent: fallbackBaseagent, models } } : {}),
+                    text: `当前模型: ${modelDisplayLabel(modelAgent, currentModel)}${effortHint}${rawModels.includes(currentModel) ? '' : ' [当前配置，未列入目录]'}\n${catalogHint}\n\n可用模型：\n${modelList}${usage}`,
+                    ...(args === 'list' ? { structured: { ok: true, model: currentModel, effort: currentEffort, baseagent: fallbackBaseagent, models, revision: catalog.revision, source: catalog.source, freshness: catalog.freshness, diagnostics: catalog.diagnostics } } : {}),
                 };
             }
             return { kind: 'command.result', text: `当前模型: ${modelDisplayLabel(modelAgent, currentModel)}${effortHint}` };
@@ -1383,7 +1402,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         catch { }
         const models = hasModelSwitcher(modelAgent) ? await modelAgent.listModels() : [];
         const allowedModels = hasModelSwitcher(modelAgent)
-            ? filterModelsForRole(identity.role, fallbackBaseagent, models, modelAgent.resolveModelId?.bind(modelAgent))
+            ? filterModelsForRole(identity.role, fallbackBaseagent, models, modelAgent.resolveModelId?.bind(modelAgent), selfAID ?? this.resolveSelfAID(channel))
             : models;
         const parts = args.split(/\s+/);
         let newModel;
@@ -1391,7 +1410,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         if (parts.length === 1) {
             const arg = parts[0];
             const currentModel = hasModelSwitcher(modelAgent) ? (configuredModel || modelAgent.getModel()) : modelAgent.name;
-            const efforts = getAvailableEfforts(modelAgent, currentModel);
+            const efforts = await getAvailableEfforts(modelAgent, currentModel);
             // effort 相关参数统一转发到 /effort
             if (efforts.includes(arg) || arg === 'auto') {
                 const delegated = await this.handle(`/effort ${arg}`, channel, channelId, undefined, userId, threadId);
@@ -1424,7 +1443,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             if (!models.includes(modelArg)) {
                 return { kind: 'command.error', text: `❌ 无效的模型ID: ${modelArgRaw}` };
             }
-            const targetEfforts = getAvailableEfforts(modelAgent, modelArg);
+            const targetEfforts = await getAvailableEfforts(modelAgent, modelArg);
             if (targetEfforts.length === 0) {
                 return { kind: 'command.error', text: `⚠️ ${modelArg} 不支持推理强度设置` };
             }
@@ -1582,7 +1601,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             const configuredModel = modelConfig.model;
             const configuredEffort = modelConfig.effort;
             const currentModel = hasModelSwitcher(effortAgent) ? (configuredModel || effortAgent.getModel()) : effortAgent.name;
-            const efforts = getAvailableEfforts(effortAgent, currentModel);
+            const efforts = await getAvailableEfforts(effortAgent, currentModel);
             const currentEffort = configuredEffort ?? effortAgent.getEffort?.() ?? 'auto';
             if (efforts.length === 0) {
                 return { kind: 'command.error', text: '⚠️ 当前模型不支持推理强度设置' };
@@ -1644,7 +1663,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         const configuredModel = modelConfig.model;
         const configuredEffort = modelConfig.effort;
         const currentModel = hasModelSwitcher(effortAgent) ? (configuredModel || effortAgent.getModel()) : effortAgent.name;
-        const efforts = getAvailableEfforts(effortAgent, currentModel);
+        const efforts = await getAvailableEfforts(effortAgent, currentModel);
         const currentEffort = configuredEffort ?? effortAgent.getEffort?.() ?? 'auto';
         if (efforts.length === 0) {
             return { kind: 'command.error', text: '⚠️ 当前模型不支持推理强度设置' };
@@ -2142,15 +2161,15 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
     // 才会在新的 TurnLease 中懒创建并绑定新 backend。
     if (normalizedContent === '/renew' || /^\/renew\s/.test(normalizedContent)) {
         if (normalizedContent !== '/renew') {
-            return { kind: 'command.error', text: '❌ /renew 不接受参数，请直接使用 /renew' };
+            return { kind: 'system.error', text: '❌ /renew 不接受参数，请直接使用 /renew', subtype: 'session.renew.invalid_arguments', recoverable: true };
         }
         if (!threadId) {
-            return { kind: 'command.error', text: '⚠️ /renew 仅支持话题会话' };
+            return { kind: 'system.error', text: '⚠️ /renew 仅支持话题会话', subtype: 'session.renew.unsupported', recoverable: true };
         }
         // Card callbacks use synthetic message IDs on several adapters. They are
         // suitable for UI correlation, but not for the durable inbound claim.
         if (source === 'card-trigger') {
-            return { kind: 'command.error', text: '⚠️ /renew 仅支持携带原生消息 ID 的普通消息' };
+            return { kind: 'system.error', text: '⚠️ /renew 仅支持携带原生消息 ID 的普通消息', subtype: 'session.renew.invalid_source', recoverable: true };
         }
         let renewSession;
         try {
@@ -2160,19 +2179,19 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         }
         catch (error) {
             logger.warn(`[CommandHandler] /renew topic lookup failed: thread=${threadId}: ${error instanceof Error ? error.message : String(error)}`);
-            return { kind: 'command.error', text: '⚠️ 当前会话状态未知，无法安全轮换，请稍后再试' };
+            return { kind: 'system.error', text: '⚠️ 当前会话状态未知，无法安全轮换，请稍后再试', subtype: 'session.renew.state_unknown', recoverable: true };
         }
         if (!renewSession) {
-            return { kind: 'command.error', text: '❌ 找不到当前话题会话' };
+            return { kind: 'system.error', text: '❌ 找不到当前话题会话', subtype: 'session.renew.session_missing', recoverable: true };
         }
         const inboundMessageId = messageId?.trim();
         if (!inboundMessageId) {
-            return { kind: 'command.error', text: '❌ /renew 缺少稳定的消息 ID，当前渠道不支持安全重试' };
+            return { kind: 'system.error', text: '❌ /renew 缺少稳定的消息 ID，当前渠道不支持安全重试', subtype: 'session.renew.message_id_missing', recoverable: true };
         }
         if (typeof this.sessionManager.rotateTopicBackend !== 'function'
             || typeof this.messageQueue.withSessionBarrier !== 'function'
             || typeof this.messageQueue.claimInbound !== 'function') {
-            return { kind: 'command.error', text: '❌ 当前运行环境不支持安全 backend 轮换' };
+            return { kind: 'system.error', text: '❌ 当前运行环境不支持安全 backend 轮换', subtype: 'session.renew.unavailable', recoverable: true };
         }
         try {
             const outcome = await this.messageQueue.withSessionBarrier(renewSession.id, async (snapshot) => {
@@ -2211,33 +2230,36 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 };
             });
             if (outcome.kind === 'missing') {
-                return { kind: 'command.error', text: '❌ 当前话题会话已不存在或归属已变化' };
+                return { kind: 'system.error', text: '❌ 当前话题会话已不存在或归属已变化', subtype: 'session.renew.session_changed', recoverable: true };
             }
             if (outcome.kind === 'claim_failed') {
-                return { kind: 'command.error', text: '❌ 当前渠道无法安全记录该请求，未执行 backend 轮换' };
+                return { kind: 'system.error', text: '❌ 当前渠道无法安全记录该请求，未执行 backend 轮换', subtype: 'session.renew.claim_failed', recoverable: true };
             }
             if (outcome.kind === 'duplicate') {
-                return { kind: 'command.result', text: 'ℹ️ 该请求已接收过，不再重复执行' };
+                return { kind: 'system.notice', text: 'ℹ️ 该请求已接收过，不再重复执行', subtype: 'session.renew.duplicate' };
             }
             if (outcome.kind === 'busy' || outcome.kind === 'unknown') {
                 return {
-                    kind: 'command.error',
+                    kind: 'system.error',
                     text: outcome.kind === 'busy'
                         ? '⚠️ 当前会话忙碌，无法安全轮换，请稍后再试'
                         : '⚠️ 当前会话状态未知，无法安全轮换，请稍后再试',
+                    subtype: outcome.kind === 'busy' ? 'session.renew.busy' : 'session.renew.state_unknown',
+                    recoverable: true,
                 };
             }
             if (outcome.kind !== 'rotated') {
-                return { kind: 'command.error', text: '⚠️ 当前会话状态未知，无法安全轮换，请稍后再试' };
+                return { kind: 'system.error', text: '⚠️ 当前会话状态未知，无法安全轮换，请稍后再试', subtype: 'session.renew.state_unknown', recoverable: true };
             }
             return {
-                kind: 'command.result',
+                kind: 'system.notice',
                 text: `✅ backend 已切换${outcome.wasBound ? '' : '（当前未绑定 backend）'}；下一条消息将初始化新 backend（阶段一不携带历史摘要）`,
+                subtype: 'session.renewed',
             };
         }
         catch (error) {
             logger.error(`[CommandHandler] /renew failed: session=${renewSession.id}: ${error instanceof Error ? error.message : String(error)}`);
-            return { kind: 'command.error', text: `❌ backend 轮换失败：${error instanceof Error ? error.message : String(error)}` };
+            return { kind: 'system.error', text: `❌ backend 轮换失败：${error instanceof Error ? error.message : String(error)}`, subtype: 'session.renew.failed', recoverable: true };
         }
     }
     // /compact 命令：手动压缩会话上下文
@@ -2451,13 +2473,17 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         if (sessionName) {
             const existing = await this.sessionManager.getSessionByName(channel, channelId, sessionName);
             if (existing) {
-                return { kind: 'command.error', text: `❌ 会话名称 "${sessionName}" 已存在，请使用其他名称` };
+                return { kind: 'system.error', text: `❌ 会话名称 "${sessionName}" 已存在，请使用其他名称`, subtype: 'session.new.name_conflict', recoverable: true };
             }
         }
         await interruptPausedSessionBeforeReplacement(session || activeSession);
         const projectPath = this.getEffectiveDefaultPath(channel);
         if (sendMessage && session) {
-            await sendMessage(channelId, `⏳ 正在创建新会话${sessionName ? `: ${sessionName}` : ''}...`, this.getReplyContext(session));
+            await sendMessage(channelId, `⏳ 正在创建新会话${sessionName ? `: ${sessionName}` : ''}...`, this.getReplyContext(session), {
+                kind: 'system.notice',
+                text: `⏳ 正在创建新会话${sessionName ? `: ${sessionName}` : ''}...`,
+                subtype: 'session.creating',
+            });
         }
         const newSessionBaseagent = this.agentRegistry?.resolveByChannel(channel)?.baseagent || this.parseDefaultBaseagent();
         const previousMetadata = session?.metadata || activeSession?.metadata || {};
@@ -2494,6 +2520,8 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         if (session && previousAgent) {
             // Reset agent backend state so the new
             // session starts with a fresh conversation history
+            // Clearing is a pure backend lifecycle operation; model selection is
+            // resolved only when the new session performs its next turn.
             await previousAgent.clearSession(session.id, session.agentSessionId || '', session.projectPath);
             await previousAgent.closeSession(session.id);
         }
@@ -2524,7 +2552,11 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             ?? newRunner.getEffort?.()
             ?? newAgent?.effort;
         const backendBits = [newBaseagent, backendModel, backendEffort].filter(Boolean).join(' · ');
-        return { kind: 'command.result', text: `✓ 已创建新会话${sessionName ? `: ${sessionName}` : ''}\n  项目: ${this.getProjectName(projectPath)}\n  后端: ${backendBits}\n  之前的对话历史已保留，可通过 /s 查看${handoffDiscardWarning ? `\n${handoffDiscardWarning}` : ''}` };
+        return {
+            kind: 'system.notice',
+            text: `✓ 已创建新会话${sessionName ? `: ${sessionName}` : ''}\n  项目: ${this.getProjectName(projectPath)}\n  后端: ${backendBits}\n  之前的对话历史已保留，可通过 /s 查看${handoffDiscardWarning ? `\n${handoffDiscardWarning}` : ''}`,
+            subtype: 'session.created',
+        };
     }
     // /check 命令：检查 EvolAgent 实例健康（visitor/member 可用，详情仅 admin）
     if (normalizedContent === '/check' || normalizedContent.startsWith('/check ')) {
@@ -2773,7 +2805,6 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             const count = this.messageCache.getCount(s.id);
             return `${s.projectPath} 有 ${count} 条新消息`;
         });
-        // 执行重启逻辑（共用于卡片回调和文本确认）
         const executeRestart = async () => {
             const suppressRealRestart = shouldSuppressRealRestart();
             let restartReplyContext = replyContext;
@@ -2814,6 +2845,11 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 logger.warn(`[System] Refusing restart without a valid explicit delivery route: channel=${channel} channelId=${channelId}`);
                 return false;
             }
+            const migrationRequirement = inspectDataMigrationRequirement(resolvePaths().root);
+            if (migrationRequirement.required) {
+                logger.warn(`[System] Refusing restart while data migration is pending: operations=${migrationRequirement.operationCount}`);
+                return { code: 'DATA_MIGRATION_REQUIRED', operationCount: migrationRequirement.operationCount };
+            }
             const restartInfo = {
                 channel,
                 channelId,
@@ -2892,6 +2928,13 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             }
         }
         const restarted = await executeRestart();
+        if (typeof restarted === 'object' && restarted.code === 'DATA_MIGRATION_REQUIRED') {
+            return {
+                kind: 'command.error',
+                text: `❌ 待处理的用户数据迁移（${restarted.operationCount} 项）阻止重启。请先运行 ec data migrate --dry-run，然后运行 ec data migrate --apply。`,
+                reason: restarted.code,
+            };
+        }
         if (!restarted) {
             return { kind: 'command.error', text: '❌ 无法确定重启通知的出站路由，请从可信会话上下文重试' };
         }

package/dist/core/data-migration.js

@@ -768,7 +768,17 @@ export function planDataMigration(root) {
     }
     catch { }
     const contactAudit = path.join(root, 'data', 'contact-book-audit.jsonl');
-    if (fs.existsSync(contactAudit)) {
+    // The legacy audit file may be provisioned as an empty placeholder (for
+    // example by a protected-path sandbox). An empty source has nothing to
+    // partition and must not block daemon startup.
+    let hasContactAuditRecords = false;
+    try {
+        const stat = fs.statSync(contactAudit);
+        hasContactAuditRecords = stat.isFile()
+            && fs.readFileSync(contactAudit, 'utf8').trim().length > 0;
+    }
+    catch { }
+    if (hasContactAuditRecords) {
         const operationId = nextId('contact-audit');
         operations.push({ id: operationId, kind: 'contact-audit-partition', source: contactAudit, staging: path.join(stagingDir, operationId), status: 'planned' });
     }

package/dist/core/event-catalog.js

@@ -246,6 +246,8 @@ const CATALOG = [
         description: 'agent 任务开始',
         fields: [
             { path: 'sessionId', type: 'string' },
+            { path: 'taskId', type: 'string', optional: true },
+            { path: 'generation', type: 'number', optional: true },
             { path: 'agentName', type: 'string', optional: true },
             { path: 'encrypt', type: 'boolean', optional: true },
             { path: 'chatmode', type: 'string', optional: true },
@@ -269,6 +271,8 @@ const CATALOG = [
         description: 'agent 任务完成',
         fields: [
             { path: 'sessionId', type: 'string' },
+            { path: 'taskId', type: 'string', optional: true },
+            { path: 'generation', type: 'number', optional: true },
             { path: 'channel', type: 'string' },
             { path: 'channelName', type: 'string', optional: true },
             { path: 'channelId', type: 'string' },
@@ -287,6 +291,8 @@ const CATALOG = [
         description: 'agent 任务失败',
         fields: [
             { path: 'sessionId', type: 'string' },
+            { path: 'taskId', type: 'string', optional: true },
+            { path: 'generation', type: 'number', optional: true },
             { path: 'error', type: 'string' },
             { path: 'errorType', type: 'string' },
             { path: 'terminalReason', type: 'string', optional: true },
@@ -300,6 +306,8 @@ const CATALOG = [
         description: 'agent 任务被中断',
         fields: [
             { path: 'sessionId', type: 'string' },
+            { path: 'taskId', type: 'string', optional: true },
+            { path: 'generation', type: 'number', optional: true },
             { path: 'reason', type: 'string', optional: true },
             { path: 'agentName', type: 'string', optional: true },
         ],
@@ -339,13 +347,17 @@ const CATALOG = [
             { path: 'eventPhase', type: 'string' },
             { path: 'isError', type: 'boolean', optional: true },
             { path: 'errorCode', type: 'string', optional: true },
+            { path: 'classificationMissing', type: 'boolean', optional: true },
             { path: 'agentName', type: 'string', optional: true },
             { path: 'callId', type: 'string', optional: true },
             { path: 'correlationId', type: 'string', optional: true },
+            { path: 'requestId', type: 'string', optional: true },
             { path: 'agentAid', type: 'string', optional: true },
             { path: 'permissionMode', type: 'string', optional: true },
             { path: 'decision', type: 'string' },
             { path: 'decisionSource', type: 'string' },
+            { path: 'policyCode', type: 'string', optional: true },
+            { path: 'reason', type: 'string', optional: true },
             { path: 'executed', type: 'boolean' },
             { path: 'executionState', type: 'string' },
             { path: 'timestamp', type: 'number', optional: true },
@@ -399,6 +411,21 @@ const CATALOG = [
         description: 'runner 开始压缩',
         fields: [{ path: 'sessionId', type: 'string' }],
     },
+    {
+        type: 'runner:proactive-reminder',
+        namespace: 'runner',
+        name: 'proactive-reminder',
+        description: '主动模式提醒已生成并请求注入模型上下文',
+        fields: [
+            { path: 'sessionId', type: 'string' },
+            { path: 'kind', type: 'string' },
+            { path: 'text', type: 'string' },
+            { path: 'queueLength', type: 'number', optional: true },
+            { path: 'toolCount', type: 'number', optional: true },
+            { path: 'injection', type: 'string' },
+            { path: 'timestamp', type: 'number', optional: true },
+        ],
+    },
     {
         type: 'runner:compact-complete',
         namespace: 'runner',
@@ -690,6 +717,11 @@ const CATALOG = [
             { path: 'runId', type: 'string' },
             { path: 'originTriggerId', type: 'string' },
             { path: 'reason', type: 'string' },
+            { path: 'reasonCode', type: 'string', optional: true },
+            { path: 'decisionSource', type: 'string', optional: true },
+            { path: 'executionState', type: 'string', optional: true },
+            { path: 'generation', type: 'number', optional: true },
+            { path: 'currentGeneration', type: 'number', optional: true },
             { path: 'targetChannel', type: 'string' },
             { path: 'targetChannelId', type: 'string' },
             { path: 'fireTime', type: 'number', optional: true },

package/dist/core/handoff/runtime.js

@@ -266,8 +266,8 @@ export class HandoffRuntime {
             }
         }
     }
-    buildPromptItem(message) {
-        return this.buildPromptItems(message)[0] ?? null;
+    buildPromptItem(message, fallbackPeerRole) {
+        return this.buildPromptItems(message, fallbackPeerRole)[0] ?? null;
     }
     isDiscardedDelivery(message) {
         const delivery = message.handoffDelivery;
@@ -277,7 +277,7 @@ export class HandoffRuntime {
         const ids = delivery.handoffIds?.length ? delivery.handoffIds : [delivery.handoffId];
         return ids.length > 0 && ids.every(handoffId => this.store.get(selfAid, handoffId)?.state === 'discarded');
     }
-    buildPromptItems(message) {
+    buildPromptItems(message, fallbackPeerRole) {
         const delivery = message.handoffDelivery;
         const selfAid = message.selfAID;
         if (!delivery || !selfAid)
@@ -310,8 +310,18 @@ export class HandoffRuntime {
                     peerId: message.peerId,
                     peerName: message.peerName,
                     peerType: message.peerType,
+                    peerRole: message.batchRole ?? message.resolvedIdentity?.role ?? fallbackPeerRole,
+                    sameDevice: message.sameDevice,
+                    sameNetwork: message.sameNetwork,
+                    sameEgressIp: message.sameEgressIp,
+                    encrypted: message.encrypted,
                     content: message.content,
                     timestamp: message.timestamp,
+                    receivedAt: message.receivedAt,
+                    gatewaySeq: message.gatewaySeq,
+                    images: message.images,
+                    mentions: message.mentions,
+                    mentionAids: message.mentionAids,
                     causation: message.causation,
                     handoff: {
                         kind: 'response_to_origin',
@@ -348,8 +358,18 @@ export class HandoffRuntime {
                 peerId: message.peerId,
                 peerName: message.peerName,
                 peerType: message.peerType,
+                peerRole: message.batchRole ?? message.resolvedIdentity?.role ?? fallbackPeerRole,
+                sameDevice: message.sameDevice,
+                sameNetwork: message.sameNetwork,
+                sameEgressIp: message.sameEgressIp,
+                encrypted: message.encrypted,
                 content: message.content,
                 timestamp: message.timestamp,
+                receivedAt: message.receivedAt,
+                gatewaySeq: message.gatewaySeq,
+                images: message.images,
+                mentions: message.mentions,
+                mentionAids: message.mentionAids,
                 causation: message.causation,
                 handoff: {
                     kind: 'request_to_target',

package/dist/core/message/im-renderer.js

@@ -1,5 +1,5 @@
 import { logger } from '../../utils/logger.js';
-import { summarizeToolInput } from '../../utils/tool-summary.js';
+import { summarizeToolInput, toolInputForDisplay } from '../../utils/tool-summary.js';
 import { getErrorMessage, isContextTooLongText } from '../../utils/error-utils.js';
 import { DEFAULT_FLUSH_DELAY_MS } from '../../types.js';
 export class IMRenderer {
@@ -34,6 +34,9 @@ export class IMRenderer {
             const correlatedEvent = event.type === 'tool_use' || event.type === 'tool_result'
                 ? { ...event, correlationId: event.correlationId ?? event.callId }
                 : event;
+            const permissionMode = typeof this.opts.permissionMode === 'function'
+                ? this.opts.permissionMode()
+                : this.opts.permissionMode;
             logger.event({
                 source: 'runner',
                 taskId: this.opts.envelope.taskId,
@@ -41,6 +44,7 @@ export class IMRenderer {
                 channelId: this.opts.envelope.channelId,
                 agentAid: this.opts.agentAid,
                 agentName: this.opts.envelope.agentName,
+                ...(permissionMode ? { permissionMode } : {}),
                 ...(correlatedEvent.type === 'tool_use' || correlatedEvent.type === 'tool_result'
                     ? { correlationId: correlatedEvent.correlationId, toolName: correlatedEvent.name }
                     : {}),
@@ -184,7 +188,7 @@ export class IMRenderer {
             kind: 'tool_call',
             call_id: callId || this.synthCallId(),
             name,
-            arguments: input,
+            arguments: toolInputForDisplay(name, input),
             text: descText,
         });
         this.messageTimestamps.push(Date.now());
@@ -568,7 +572,7 @@ export class IMRenderer {
                     text: desc,
                 };
                 if (event.input !== undefined)
-                    item.arguments = event.input;
+                    item.arguments = toolInputForDisplay(event.name, event.input);
                 return item;
             }
             case 'tool_result':