evolcore 0.0.23 → 0.0.25

package/dist/core/command/menu-protocol.js

@@ -25,8 +25,11 @@ export function buildMenuClientProtectedHeaders(input) {
             ...(input.remoteAccessToken || input.ecwebToken ? { auth_method: 'remote-access-token', remote_access_token: input.remoteAccessToken ?? input.ecwebToken } : {}),
         };
     }
+    const appClientVersion = input.clientVersion?.trim();
     return {
+        ...(clientName === 'Evol App' ? { client_name: clientName } : {}),
         ...(input.evolVersion ? { evol_version: input.evolVersion } : {}),
+        ...(clientName === 'Evol App' && appClientVersion ? { client_version: appClientVersion } : {}),
         ...(input.remoteAccessToken || input.ecwebToken ? { auth_method: 'remote-access-token', remote_access_token: input.remoteAccessToken ?? input.ecwebToken } : {}),
     };
 }
@@ -40,7 +43,7 @@ export function parseMenuClientProtectedHeaders(value) {
         normalized[key.trim().toLowerCase()] = raw;
     }
     const result = {};
-    if (normalized.client_name === 'evol' || normalized.client_name === 'ec-menu-client')
+    if (normalized.client_name === 'evol' || normalized.client_name === 'Evol App' || normalized.client_name === 'ec-menu-client')
         result.client_name = normalized.client_name;
     else if (normalized.client_name !== undefined)
         result.client_name = normalized.client_name;
@@ -71,7 +74,7 @@ export function evaluateMenuClientCompatibility(input) {
         }
         return null;
     }
-    if (clientName !== 'evol') {
+    if (clientName !== 'evol' && clientName !== 'Evol App') {
         return { code: 'INVALID_CLIENT', message: `Unsupported Menu client: ${String(clientName)}` };
     }
     return evaluateEvolMenuVersionGate(input);
@@ -104,6 +107,7 @@ export const MENU_NAME_COMMANDS = Object.freeze({
     session: '/session',
     topic: '/topic',
     baseagent: '/baseagent',
+    'baseagent-models': '/baseagent-models',
     model: '/model',
     effort: '/effort',
     chatmode: '/chatmode',
@@ -116,6 +120,7 @@ export const MENU_NAME_COMMANDS = Object.freeze({
     system: '/system',
     cli: '/cli',
     agent: '/agent',
+    aid: '/aid',
     trigger: '/trigger',
     file: '/file',
     gateway: '/gateway',

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

@@ -119,10 +119,8 @@ export function guardThreadCommand(content, threadId) {
     const threadBlocked = ['/new', '/slist', '/s', '/session', '/fork', '/del', '/repair'];
     const hasCommandArgument = (command) => new RegExp(`^${command.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?:\\s|$)`).test(content);
     const isBlocked = threadBlocked.some(hasCommandArgument);
-    const isBaseagentSwitch = /^\/baseagent\s/.test(content);
-    const isBaseAliasSwitch = /^\/base\s/.test(content);
     const isRewindMutation = /^\/rewind\s/.test(content);
-    if (!isBlocked && !isBaseagentSwitch && !isBaseAliasSwitch && !isRewindMutation)
+    if (!isBlocked && !isRewindMutation)
         return undefined;
     return { kind: 'command.error', text: '⚠️ 话题中不支持此命令' };
 }

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

@@ -25,7 +25,8 @@ import { chatmodeFieldForPeer, resolveChatModeForField } from '../message/peer-m
 import { normalizePermissionMode as normalizePermissionModeContract, PUBLIC_PERMISSION_MODES } from '../permission/mode.js';
 import { isManagementRole } from '../../config/builtin-roles.js';
 import { isSystemControlChannel } from '../system-channels.js';
-import { spawnDetachedNode } from '../../utils/cross-platform.js';
+import { launchMonitorAndConfirm, resolveMonitorLaunch, cleanupMonitorStage } from '../../utils/cross-platform.js';
+import { scanInstances } from '../../utils/instance-registry.js';
 import { inspectDataMigrationRequirement } from '../data-migration.js';
 import { guardIdleCommand, guardKnownCommand, guardRoleCommand, guardThreadCommand, isRecognizedSlashCommand, normalizeSlashContent, probeSessionActivity, } from './slash-gate.js';
 const allEfforts = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
@@ -1063,11 +1064,12 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             const activeBaseagent = owningAgent?.baseagent || this.parseDefaultBaseagent();
             // 尝试发送 CommandCard 卡片
             if (this.interactionRouter && available.length > 1) {
+                const baseagentSession = await getExistingSessionForCommand();
                 const interaction = {
                     type: 'interaction',
                     id: `agent-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
                     channelId,
-                    sessionId: activeSession?.id || `agent-${Date.now()}`,
+                    sessionId: baseagentSession?.id || `agent-${Date.now()}`,
                     initiatorId: userId,
                     kind: {
                         kind: 'command-card',
@@ -1080,7 +1082,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                         })),
                     },
                 };
-                const replyCtx = activeSession ? this.getReplyContext(activeSession) : undefined;
+                const replyCtx = baseagentSession ? this.getReplyContext(baseagentSession) : replyContext;
                 const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isOwner });
                 if (cardResult === null)
                     return null;
@@ -1100,29 +1102,79 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         if (!owningAgent) {
             return { kind: 'command.error', text: '❌ 当前 channel 无绑定 agent，无法设置 active_baseagent' };
         }
-        await interruptPausedSessionBeforeReplacement(await getExistingSessionForCommand());
-        const previousDefaultBaseagent = owningAgent.baseagent || this.parseDefaultBaseagent();
+        const currentSession = await getExistingSessionForCommand();
+        const previousBaseagent = owningAgent.baseagent || this.parseDefaultBaseagent();
+        if (currentSession?.threadId) {
+            const rotation = await withIdleTopicBackend(currentSession.id, currentSession.threadId, async (current) => {
+                try {
+                    owningAgent.setActiveBaseagent(args);
+                }
+                catch (error) {
+                    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+                }
+                try {
+                    const result = await this.sessionManager.rotateTopicBackend({
+                        sessionId: current.id,
+                        expectedThreadId: current.threadId,
+                        baseagent: args,
+                    });
+                    return { ok: true, result };
+                }
+                catch (error) {
+                    try {
+                        owningAgent.setActiveBaseagent(previousBaseagent);
+                    }
+                    catch { }
+                    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+                }
+            }, currentSession);
+            if (!rotation.ok) {
+                if (rotation.reason === 'busy')
+                    return { kind: 'command.error', text: '⚠️ 当前话题会话忙碌，无法切换 baseagent，请稍后再试' };
+                if (rotation.reason === 'unknown')
+                    return { kind: 'command.error', text: '⚠️ 当前话题会话状态未知，无法安全切换 baseagent，请稍后再试' };
+                return { kind: 'command.error', text: `❌ baseagent 切换失败：${rotation.reason === 'missing' ? '当前话题会话不存在' : '状态未知'}` };
+            }
+            if (!rotation.value.ok)
+                return { kind: 'command.error', text: `❌ baseagent 切换失败：${rotation.value.error}` };
+            this.eventBus.publish({ type: 'agent:baseagent-changed', aid: owningAgent.aid, baseagent: args, previousBaseagent, scope: 'agent', timestamp: Date.now() });
+            return {
+                kind: 'system.notice',
+                text: `✓ 当前话题已切换 Baseagent: ${previousBaseagent} → ${args}\n  话题会话 ID 保持不变: ${currentSession.id}`,
+                subtype: 'session.created',
+            };
+        }
+        await interruptPausedSessionBeforeReplacement(currentSession);
         try {
             owningAgent.setActiveBaseagent(args);
         }
         catch (error) {
             return { kind: 'command.error', text: `❌ ${error instanceof Error ? error.message : String(error)}` };
         }
-        this.eventBus.publish({
-            type: 'agent:baseagent-changed',
-            aid: owningAgent.aid,
-            baseagent: args,
-            previousBaseagent: previousDefaultBaseagent,
-            scope: 'agent',
-            timestamp: Date.now(),
-        });
-        const projectName = this.getProjectName(owningAgent.projectPath);
-        const agentSwitchResponse = [
-            `✓ 已设置 Baseagent: ${args}`,
-            `  Agent: ${owningAgent.name}`,
-            `  项目: ${projectName}`,
-        ].join('\n');
-        return { kind: 'command.result', text: agentSwitchResponse };
+        let newSession;
+        try {
+            newSession = await this.sessionManager.createNewSession(channel, channelId, owningAgent.projectPath, undefined, args, currentSession?.metadata, { previousBaseagent, baseagentChanged: previousBaseagent !== args });
+        }
+        catch (error) {
+            try {
+                owningAgent.setActiveBaseagent(previousBaseagent);
+            }
+            catch { }
+            return { kind: 'command.error', text: `❌ 创建新会话失败：${error instanceof Error ? error.message : String(error)}` };
+        }
+        if (currentSession) {
+            const previousAgent = getActiveAgentIfAvailable();
+            if (previousAgent) {
+                await previousAgent.clearSession(currentSession.id, currentSession.agentSessionId || '', currentSession.projectPath);
+                await previousAgent.closeSession(currentSession.id);
+            }
+        }
+        this.eventBus.publish({ type: 'agent:baseagent-changed', aid: owningAgent.aid, baseagent: args, previousBaseagent, scope: 'agent', timestamp: Date.now() });
+        return {
+            kind: 'system.notice',
+            text: `✓ 已切换 Baseagent: ${previousBaseagent} → ${args}\n  已创建新的主会话: ${newSession.id}\n  之前的对话历史已保留，可通过 /s 查看`,
+            subtype: 'session.created',
+        };
     }
     // /model 命令：查看或切换模型/推理强度
     if (normalizedContent.startsWith('/model')) {
@@ -1317,7 +1369,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                         }),
                     },
                 };
-                const replyCtx = modelSession ? this.getReplyContext(modelSession) : undefined;
+                const replyCtx = modelSession ? this.getReplyContext(modelSession) : replyContext;
                 const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isAdmin });
                 if (cardResult === null)
                     return null;
@@ -1626,7 +1678,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                         })),
                     },
                 };
-                const replyCtx = effortSession ? this.getReplyContext(effortSession) : undefined;
+                const replyCtx = effortSession ? this.getReplyContext(effortSession) : replyContext;
                 const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isAdmin });
                 if (cardResult === null)
                     return null;
@@ -1879,7 +1931,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                         })),
                     },
                 };
-                const replyCtx = replyContext ?? (activitySession ? this.getReplyContext(activitySession) : undefined);
+                // A topic session's persisted route is authoritative; an inbound
+                // replyContext may be a stale/main-session snapshot (notably for card
+                // callbacks), so prefer the resolved session context whenever present.
+                const replyCtx = activitySession ? this.getReplyContext(activitySession) : replyContext;
                 const cardResult = await this.sendCommandCard({ channel, channelId, interaction, replyCtx, canWrite: isOwner });
                 if (cardResult === null)
                     return null;
@@ -1947,7 +2002,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                     })),
                 },
             };
-            const replyCtx = existingChatmodeSession ? this.getReplyContext(existingChatmodeSession) : undefined;
+            const replyCtx = existingChatmodeSession ? this.getReplyContext(existingChatmodeSession) : replyContext;
             const cardResult = await this.sendCommandCard({
                 channel,
                 channelId,
@@ -2253,7 +2308,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             }
             return {
                 kind: 'system.notice',
-                text: `✅ backend 已切换${outcome.wasBound ? '' : '（当前未绑定 backend）'}；下一条消息将初始化新 backend（阶段一不携带历史摘要）`,
+                text: '已切换到新会话。下一条消息将在新会话中处理。',
                 subtype: 'session.renewed',
             };
         }
@@ -2290,7 +2345,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             // The runner instance's model is only the final fallback; without this
             // override Claude's /compact command could resume with a stale agent
             // default (for example glm-5.3) while the turn itself used gpt-5.6-sol.
-            const compactBaseagentRaw = session.baseagent || currentSessionAgent.name;
+            const compactBaseagentRaw = session.baseagent;
+            if (!compactBaseagentRaw) {
+                return { kind: 'command.error', text: '❌ 当前会话缺少 baseagent 绑定，拒绝隐式切换' };
+            }
             const compactBaseagentNormalized = normalizeBaseagent(compactBaseagentRaw);
             const compactBaseagent = compactBaseagentNormalized.canonical === 'unknown'
                 ? compactBaseagentRaw
@@ -2610,7 +2668,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 groups.set(type, []);
             groups.get(type).push({ name, status });
         }
-        if (!isAdmin && !isDaemonOwner) {
+        // ECWeb 的系统控制面需要结构化健康数据（尤其是 daemon.aun.connected）。
+        // 这里不能把全局 system 通道降级成仅文本摘要，否则前端会因缺少
+        // daemonStatusProvider 返回值而把已连接的控制 AID 显示为 disconnect。
+        if (!isAdmin && !isDaemonOwner && !isGlobalCheckChannel) {
             // visitor/member: 仅显示实例通道摘要
             const total = [...groups.values()].flat().length;
             const healthy = [...groups.values()].flat().filter(i => i.status.includes('✓')).length;
@@ -2763,6 +2824,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         // 进程级操作：必须是 daemon owner（daemon.json.owners），与 menu 协议 /system restart 一致。
         // agent-channel 的 owner/admin 角色不足以重启整个 daemon。
         const restartSelfAid = this.agentRegistry?.resolveByChannel(channel)?.aid;
+        const commandSession = await getExistingSessionForCommand();
         const authDenied = await authorizeIntent({
             intent: {
                 operation: 'system.restart',
@@ -2772,7 +2834,7 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 dangerous: true,
             },
             identity,
-            session: activeSession,
+            session: commandSession ?? activeSession,
             channel,
             channelId,
             userId,
@@ -2784,7 +2846,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         const selfAid = this.agentRegistry?.resolveByChannel(channel)?.aid;
         // 排除当前会话（如果存在）。如果 activeSession 不存在，说明还没建立会话，
         // 此时检查所有任务；如果有其他会话在处理，仍然阻塞重启。
-        const excludeKey = activeSession?.id;
+        // A topic command owns its topic session even when the channel's active
+        // session remains the main conversation.  Exclude that exact queue key
+        // from the busy check so the current topic cannot block its own restart.
+        const excludeKey = commandSession?.id ?? activeSession?.id;
         const busyInfo = getAgentBusyInfo(this, selfAid, excludeKey);
         if (busyInfo && busyInfo.count > 0) {
             // busyInfo.count > 0 说明【除当前会话外】还有其他会话的任务在执行
@@ -2809,10 +2874,14 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
             const suppressRealRestart = shouldSuppressRealRestart();
             let restartReplyContext = replyContext;
             try {
-                if (!restartReplyContext?.delivery && threadId) {
+                // A topic's persisted session context is authoritative for card
+                // callbacks and for inbound messages that only carry a partial route.
+                // Do not let a stale/main-session replyContext win merely because it
+                // happens to contain a delivery target.
+                if (threadId) {
                     const threadSession = await this.sessionManager.getThreadSession(channel, channelId, threadId);
                     if (threadSession)
-                        restartReplyContext = this.getReplyContext(threadSession);
+                        restartReplyContext = { ...(replyContext ?? {}), ...(this.getReplyContext(threadSession) ?? {}), threadId };
                 }
                 else if (!restartReplyContext?.delivery && activeSession) {
                     restartReplyContext = this.getReplyContext(activeSession);
@@ -2854,16 +2923,39 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 channel,
                 channelId,
                 timestamp: Date.now(),
+                ...(restartReplyContext?.threadId ? { threadId: restartReplyContext.threadId } : {}),
                 ...(restartReplyContext?.delivery ? { delivery: restartReplyContext.delivery } : {}),
                 ...(restartReplyContext?.replyToMessageId ? { rootId: restartReplyContext.replyToMessageId } : {}),
             };
             if (!suppressRealRestart) {
+                // 这条路径上 daemon 会在下面 kill 掉自己，所以必须先确认 monitor 真的活起来：
+                // 只查文件存在不够 —— 开发仓下 monitor 走 tsx，源码语法错误会让它加载即退出；
+                // 安装包下 monitor 先复制到 stage 再启动，避免升级替换掉自己脚下的文件。
+                const monitorEntry = resolveMonitorLaunch(getPackageRoot(), path.join(resolvePaths().root, 'data', 'monitor-stage'));
+                if (monitorEntry.note)
+                    logger.info(`[System] ${monitorEntry.note}`);
+                if (!fs.existsSync(monitorEntry.entry)) {
+                    logger.error(`[System] Refusing restart: restart-monitor entry not found: ${monitorEntry.entry}`);
+                    return { code: 'RESTART_ENTRY_MISSING', entry: monitorEntry.entry };
+                }
                 const controlDir = daemonControlDir();
                 fs.mkdirSync(controlDir, { recursive: true });
                 fs.writeFileSync(path.join(controlDir, 'restart-pending.json'), JSON.stringify(restartInfo));
-                spawnDetachedNode([path.join(getPackageRoot(), 'dist', 'cli', 'index.js'), 'restart-monitor'], {
-                    EVOLCORE_HOME: resolvePaths().root,
-                });
+                const confirmation = await launchMonitorAndConfirm([...monitorEntry.args, 'restart-monitor'], { EVOLCORE_HOME: resolvePaths().root, ...monitorEntry.env }, pid => scanInstances().restartMonitors.some(m => m.alive && m.record.pid === pid), pid => scanInstances().restartMonitors.some(m => m.alive && m.record.pid !== pid));
+                if (!confirmation.ok) {
+                    // 没有看门狗就不要停服务：撤掉回执文件，让本进程继续跑。
+                    if (monitorEntry.stageDir)
+                        cleanupMonitorStage(monitorEntry.stageDir);
+                    try {
+                        fs.rmSync(path.join(controlDir, 'restart-pending.json'), { force: true });
+                    }
+                    catch { }
+                    logger.error(`[System] Refusing restart: restart-monitor did not come up (${confirmation.reason})`);
+                    for (const line of (confirmation.stderrTail ?? '').split(/\r?\n/).filter(Boolean).slice(-8)) {
+                        logger.error(`[System]   | ${line}`);
+                    }
+                    return { code: 'RESTART_MONITOR_DEAD', reason: confirmation.reason ?? 'unknown' };
+                }
             }
             else {
                 logger.info('[System] Suppressed real restart in test runtime');
@@ -2894,15 +2986,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                     logger.error('[System] Failed to send restart notification:', err);
                 }
             }
-            // 发 SIGTERM 而非直接 process.exit(0)，让 index.ts 的 shutdown() 先
-            // 正常关闭所有 channel（包括 Feishu WebSocket close frame），
-            // 避免 Feishu 服务端因连接异常断开而重推未 ack 的消息给新进程。
-            if (!suppressRealRestart) {
-                setTimeout(() => {
-                    logger.info('[System] Restarting by user command...');
-                    process.kill(process.pid, 'SIGTERM');
-                }, 1000);
-            }
+            // restart-monitor owns the old daemon shutdown and the replacement
+            // startup. Do not kill this process here: the monitor may have exited
+            // after a read-only migration check, in which case the current service
+            // must remain available.
             return true;
         };
         // 文本确认流程
@@ -2931,7 +3018,21 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         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。`,
+                text: `❌ 待处理的用户数据迁移（${restarted.operationCount} 项）阻止重启；本次仅检查，未停止当前服务。请先运行 ec data migrate --dry-run，然后运行 ec data migrate --apply。`,
+                reason: restarted.code,
+            };
+        }
+        if (typeof restarted === 'object' && restarted.code === 'RESTART_ENTRY_MISSING') {
+            return {
+                kind: 'command.error',
+                text: `❌ 重启已中止：找不到 restart-monitor 入口 ${restarted.entry}。服务未重启，当前进程继续运行。请先执行 npm run build 重建产物。`,
+                reason: restarted.code,
+            };
+        }
+        if (typeof restarted === 'object' && restarted.code === 'RESTART_MONITOR_DEAD') {
+            return {
+                kind: 'command.error',
+                text: `❌ 重启已中止：看门狗进程未能启动（${restarted.reason}）。服务未停止，仍在运行当前版本。开发仓下这通常是源码语法错误导致 tsx 无法加载，请执行 npx tsc --noEmit 检查。`,
                 reason: restarted.code,
             };
         }
@@ -3099,11 +3200,11 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 ? { delivery: { chatType: 'private' } }
                 : sendSession
                     ? this.getReplyContext(sendSession)
-                    : chatType === 'group'
+                    : replyContext ?? (chatType === 'group'
                         ? { delivery: { chatType: 'group', groupId: channelId } }
                         : chatType === 'private'
                             ? { delivery: { chatType: 'private' } }
-                            : undefined;
+                            : undefined);
             await targetAdapter.send(buildEnvelope({ channel: targetAdapter.channelName, channelId: targetChannelId, replyContext: replyCtx }), { kind: 'result.file', filePath: realPath });
             const sizeStr = stat.size < 1024 ? `${stat.size} B`
                 : stat.size < 1024 * 1024 ? `${(stat.size / 1024).toFixed(1)} KB`
@@ -3122,10 +3223,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
     // /slist cli  — 仅 CLI 会话（未导入的）
     if (normalizedContent === '/slist' || normalizedContent === '/slist cli') {
         if (!session) {
-            return { kind: 'command.error', text: `❌ 当前没有活跃会话
-
-请先执行以下操作之一：
-1. 发送任意消息 - 自动创建新会话
+            return { kind: 'command.error', text: `❌ 当前没有活跃会话
+
+请先执行以下操作之一：
+1. 发送任意消息 - 自动创建新会话
 2. /new [名称] - 创建命名会话` };
         }
         const showCliOnly = normalizedContent === '/slist cli';
@@ -3329,7 +3430,12 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
                 projectPaths.unshift(session.projectPath);
             }
             for (const projectPath of projectPaths) {
-                const currentBaseagent = session?.baseagent || this.primaryRunnerKey;
+                const currentBaseagent = session?.baseagent
+                    ?? this.agentRegistry?.resolveByChannel(channel)?.baseagent
+                    ?? (this.agentMap?.size === 1 ? this.parseDefaultBaseagent() : undefined);
+                if (!currentBaseagent) {
+                    return { kind: 'command.error', text: '❌ 无法确定当前会话的 baseagent，拒绝导入 CLI 会话' };
+                }
                 const cliSessions = currentBaseagent === 'ecagent'
                     ? await this.sessionManager.listImportableCliSessions(projectPath, currentBaseagent, selfAID ?? session?.selfAID)
                     : await this.sessionManager.listImportableCliSessions(projectPath, currentBaseagent);
@@ -3391,11 +3497,11 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         if (!newName)
             return { kind: 'command.result', text: '用法: /name <新名称> 或 /rename <新名称>' };
         if (!session) {
-            return { kind: 'command.error', text: `❌ 当前没有活跃会话
-
-请先执行以下操作之一：
-1. 发送任意消息 - 自动创建新会话
-2. /new [名称] - 创建命名会话
+            return { kind: 'command.error', text: `❌ 当前没有活跃会话
+
+请先执行以下操作之一：
+1. 发送任意消息 - 自动创建新会话
+2. /new [名称] - 创建命名会话
 3. /session <名称> - 切换到已有会话` };
         }
         const existing = await this.sessionManager.getSessionByName(channel, channelId, newName);
@@ -3504,7 +3610,10 @@ export async function handleSlashCommand(content, channel, channelId, sendMessag
         const session = await getExistingSessionForCommand();
         if (!session)
             return { kind: 'command.error', text: '❌ 当前没有活跃会话' };
-        const rewindBaseagent = session.baseagent ?? session.agentId;
+        const rewindBaseagent = session.baseagent;
+        if (!rewindBaseagent) {
+            return { kind: 'command.error', text: '❌ 当前会话缺少 baseagent 绑定，拒绝隐式切换' };
+        }
         const rewindAgent = this.getAgent(channel, rewindBaseagent);
         if (!session.agentSessionId) {
             return { kind: 'command.error', text: '❌ 当前会话无历史记录\n\n请先发送一条消息，然后再使用 /rewind' };

package/dist/core/data-migration.js

@@ -752,21 +752,11 @@ export function planDataMigration(root) {
         }
     }
     catch { }
-    const legacyOutbox = path.join(root, 'data', 'outbox');
-    try {
-        for (const entry of fs.readdirSync(legacyOutbox, { withFileTypes: true })) {
-            if (!entry.isFile() || !entry.name.endsWith('.jsonl'))
-                continue;
-            const aid = entry.name.slice(0, -'.jsonl'.length);
-            if (!aids.has(aid)) {
-                warnings.push(`Unresolved outbox owner retained: ${entry.name}`);
-                continue;
-            }
-            const operationId = nextId('outbox');
-            addCopy(operations, operationId, path.join(legacyOutbox, entry.name), path.join(root, 'agents', aid, 'data', 'outbox.jsonl'), stageFor(operationId));
-        }
-    }
-    catch { }
+    // Outbox layouts are imported lazily by src/aun/outbox.ts when a queue is
+    // first read or written. They are append-only delivery state, so including
+    // them in the maintenance migration would unnecessarily block startup and
+    // could race a live connector. Keep the explicit migration reserved for
+    // data that needs operator review or an exclusive maintenance window.
     const contactAudit = path.join(root, 'data', 'contact-book-audit.jsonl');
     // The legacy audit file may be provisioned as an empty placeholder (for
     // example by a protected-path sandbox). An empty source has nothing to

package/dist/core/event-catalog.js

@@ -89,6 +89,9 @@ const CATALOG = [
             { path: 'name', type: 'string', optional: true },
             { path: 'chatType', type: 'string', optional: true },
             { path: 'threadId', type: 'string', optional: true },
+            { path: 'baseagent', type: 'string', optional: true },
+            { path: 'previousBaseagent', type: 'string', optional: true },
+            { path: 'baseagentChanged', type: 'boolean', optional: true },
             { path: 'cause', type: 'string', optional: true },
             { path: 'sourceSessionId', type: 'string', optional: true },
             { path: 'renewSource', type: 'string', optional: true },
@@ -793,6 +796,11 @@ const CATALOG = [
         fields: [
             { path: 'aid', type: 'string' },
             { path: 'avatar', type: 'string' },
+            { path: 'sha256', type: 'string', optional: true },
+            { path: 'mime', type: 'string', optional: true },
+            { path: 'width', type: 'number', optional: true },
+            { path: 'height', type: 'number', optional: true },
+            { path: 'aspectRatio', type: 'number', optional: true },
             { path: 'timestamp', type: 'number', optional: true },
         ],
     },

package/dist/core/evolagent.js

@@ -275,9 +275,9 @@ export class EvolAgent {
         return `agent-files:${this.aid}`;
     }
     /**
-     * 读取 personal/persona.md 内容。走 fileCache（mtime 门控）：persona 没有任何
-     * 写入命令、由 agent 自己带外改写，与 working memory 同样改了即应生效，故每次读
-     * stat 比对、变了自动重读。文件不存在返回 null。
+     * 读取 personal/persona.md 内容。走 fileCache（mtime 门控）：persona 可由
+     * `ec agent persona` 或 agent 自己更新，与 working memory 一样改了即应生效，
+     * 故每次读 stat 比对、变了自动重读。文件不存在返回 null。
      */
     getPersona() {
         const personaPath = path.join(agentPersonalDir(this.aid), 'persona.md');

package/dist/core/handoff/runtime.js

@@ -118,6 +118,7 @@ export class HandoffRuntime {
                 targetSessionId: target.id,
                 payload: input.payload,
                 encrypt: input.encrypt,
+                contextOnly: input.contextOnly,
                 delivery: targetChatType === 'group'
                     ? { chatType: 'group', groupId: input.to }
                     : { chatType: 'private' },
@@ -131,7 +132,8 @@ export class HandoffRuntime {
             status: 'started',
             refs: { handoffId: handoff.handoff_id, sessionId: origin.id, messageId: input.originMessageId },
         });
-        await this.dispatcher.drain(input.selfAid, target.id);
+        if (!input.contextOnly)
+            await this.dispatcher.drain(input.selfAid, target.id);
         const dispatched = this.store.get(input.selfAid, handoff.handoff_id) ?? handoff;
         const replacedSessionId = [origin.id, target.id].find(sessionId => ((this.sessionDiscardSequence.get(this.sessionKey(input.selfAid, sessionId)) ?? 0) > operationSequence));
         if (dispatched.state === 'discarded' || replacedSessionId) {

package/dist/core/handoff/store.js

@@ -122,6 +122,7 @@ export class HandoffStore {
             request: {
                 payload: clonePayload(input.payload),
                 encrypt: input.encrypt,
+                ...(input.contextOnly ? { contextOnly: true } : {}),
                 ...(input.delivery ? { delivery: input.delivery } : {}),
             },
             ...(input.originAuthorization
@@ -129,7 +130,12 @@ export class HandoffStore {
                 : {}),
             causation: normalizeCausation(input.causation),
             return_policy: input.returnPolicy ?? 'required',
-            state: 'queued',
+            // Local-only requests are already available for the next target-session
+            // turn and must never enter the outbound dispatch queue.  Keep them in
+            // target_sent while waiting for the target turn to bind the context;
+            // target_context_pending is reserved for a context-only handoff after
+            // it has been consumed by a returnPolicy=none target turn.
+            state: input.contextOnly ? 'target_sent' : 'queued',
             target_message_id: null,
             response_message_id: null,
             consumed_at: null,

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

@@ -227,25 +227,32 @@ export class IMRenderer {
             durationMs: opts.durationMs,
         });
     }
-    /** 发送不进入 activity/thought 历史的非终态 warning status。 */
-    async sendWarningStatus(message, subtype, details) {
+    /** 发送不进入 activity/thought 历史、也不代表执行活跃的任务级 notice。 */
+    async sendStatusNotice(message, severity = 'info', subtype, details) {
         const payload = {
-            kind: 'status.progress',
+            kind: 'status.notice',
             metadata: {
-                activityType: 'progress',
                 message,
-                severity: 'warn',
+                severity,
                 ...(subtype !== undefined && { subtype }),
                 ...(details?.missingItems !== undefined && { missingItems: details.missingItems }),
+                ...(details?.idleSec !== undefined && { idleSec: details.idleSec }),
+                ...(details?.totalEvents !== undefined && { totalEvents: details.totalEvents }),
+                ...(details?.totalToolCalls !== undefined && { totalToolCalls: details.totalToolCalls }),
+                ...(details?.lastToolName !== undefined && { lastToolName: details.lastToolName }),
             },
         };
         try {
             await this.opts.send(payload);
         }
         catch (error) {
-            logger.warn(`[IMRenderer] warning status send failed: ${error instanceof Error ? error.message : String(error)}`);
+            logger.warn(`[IMRenderer] status notice send failed: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    /** 兼容旧调用方：发送 warning 级别的任务 notice。 */
+    async sendWarningStatus(message, subtype, details) {
+        return this.sendStatusNotice(message, 'warn', subtype, details);
+    }
     /** 添加任务生命周期边界事件，复用 activity.batch 投影路径。 */
     addLifecycle(phase, metadata, text) {
         const item = {