evolcore 0.0.10 → 0.0.12

package/dist/core/message/message-bridge.js

@@ -8,7 +8,7 @@ import { formatChannelKey, tryParseChannelKey } from '../channel-loader.js';
 import { agentDir, resolvePaths } from '../../paths.js';
 import { listStaticAgentAdmins, listStaticAgentOwners, resolvePeerRoleDetail, } from '../../config/peer-role-resolver.js';
 import { resolveContactView, resolvePeerDisplayLabel, resolvePrincipal } from '../../config/contact-book.js';
-import { findContactRequestNote, expirePendingContactRequests, reviewContactRequest, submitContactRequest, } from '../../config/contact-request-service.js';
+import { findContactRequestNote, expirePendingContactRequests, reviewContactRequest, submitContactRequest, contactRequestSubmissionProtocolResult, queryOwnContactRequestStatus, } from '../../config/contact-request-service.js';
 import { isValidAid } from '../../aun/aid/validation.js';
 import { PeerIdentityCache } from '../relation/peer-identity.js';
 import { handlePendingDingtalkContactBindMessage, registerPendingDingtalkContactBind } from '../../channels/dingtalk.js';
@@ -17,8 +17,8 @@ import { handlePendingQQBotContactBindMessage, registerPendingQQBotContactBind }
 import { handlePendingWecomContactBindMessage, registerPendingWecomContactBind } from '../../channels/wecom.js';
 import { handlePendingWechatContactBindMessage, registerPendingWechatContactBind } from '../../channels/wechat.js';
 import { authorizeAccess, buildAuthSubject } from '../auth/auth-gateway.js';
-import { MenuDiagnosticLimiter, MenuRequestDeduper, hasValidMenuId, menuFailure, menuPayloadFingerprint, menuSuccess, normalizeMenuError, parseMenuControl, validateMenuRequest, } from '../command/menu-protocol.js';
-import { evaluateEvolMenuVersionGate, evolMenuResponseTransportMetadata, isAunMenuTokenRequired } from '../command/evol-menu-version-gate.js';
+import { MenuDiagnosticLimiter, MenuRequestDeduper, hasValidMenuId, menuFailure, menuPayloadFingerprint, menuSuccess, normalizeMenuError, parseMenuControl, validateMenuRequest, evaluateEvolMenuVersionGate, evolMenuResponseTransportMetadata, isAunMenuTokenRequired, menuCommandForName, } from '../command/menu-protocol.js';
+import { resolveExplicitMenuExecutionContext, validateMenuCatalogArgs, validateMenuValueBatchArgs } from '../command/menu-catalog.js';
 import { MenuTokenStore } from '../command/menu-token-store.js';
 import { SessionRenewService } from '../session/session-renew.js';
 import { createRootCausation, deriveCausation, normalizeCausation } from '../causation/context.js';
@@ -306,42 +306,171 @@ export class MessageBridge {
                 return true;
             }
         }
+        return false;
+    }
+    async handleContactRequestProtocol(input) {
+        const { context, msg, content, owningAgent, adapter, sendReply } = input;
         const requestMatch = /^\s*\/request(?:\s+([\s\S]*?))?\s*$/i.exec(content);
-        if (!requestMatch)
+        let protocolType;
+        let protocolPayload;
+        try {
+            const parsed = JSON.parse(content);
+            protocolPayload = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+                ? parsed
+                : undefined;
+            protocolType = protocolPayload?.type === 'contact.request.query'
+                ? 'query'
+                : protocolPayload?.type === 'contact.request.submit' ? 'submit' : undefined;
+        }
+        catch { /* slash command */ }
+        if (!requestMatch && !protocolType)
             return false;
-        if (context.channelType !== 'aun') {
-            await this.sendAdmissionControlReply(context, msg, sendReply, '联系人申请仅支持 AUN 私聊。');
+        // Slash commands keep their human-facing response semantics. Structured
+        // App requests use contact.request.response and never fall through to the
+        // normal command/session pipeline.
+        if (requestMatch) {
+            // Blacklist remains the first gate even though slash controls are
+            // recognized before ordinary admission. Let the normal blocked path
+            // decide whether an agent/bot/service gets a limited rejection.
+            if (context.contactStatus === 'blocked')
+                return false;
+            if (context.channelType !== 'aun') {
+                await this.sendAdmissionControlReply(context, msg, sendReply, '联系人申请仅支持 AUN 私聊。');
+                return true;
+            }
+            if (context.chatType !== 'private') {
+                await this.sendAdmissionControlReply(context, msg, sendReply, '联系人申请仅支持 AUN 私聊。');
+                return true;
+            }
+            if (!context.primaryId || context.principal?.principalStatus !== 'native_aid') {
+                await this.sendAdmissionControlReply(context, msg, sendReply, '无法验证当前 AUN 身份，未提交联系人申请。');
+                return true;
+            }
+            try {
+                const submission = await submitContactRequest({
+                    selfAid: context.selfAid,
+                    applicantAid: context.primaryId,
+                    note: requestMatch[1],
+                    sourceChannelKey: context.channelKey,
+                });
+                if ((submission.code === 'submitted' || submission.code === 'resubmitted') && submission.requestId) {
+                    void this.deliverContactReviewCard(context.selfAid, context.primaryId, submission, owningAgent)
+                        .catch(error => logger.warn(`[MessageBridge] Contact review delivery failed: ${error instanceof Error ? error.message : String(error)}`));
+                }
+                await this.sendAdmissionControlReply(context, msg, sendReply, this.contactRequestReply(submission));
+            }
+            catch (error) {
+                logger.warn(`[MessageBridge] Contact request submission failed: ${error instanceof Error ? error.message : String(error)}`);
+                await this.sendAdmissionControlReply(context, msg, sendReply, '当前无法受理联系人申请，请稍后再试。');
+            }
             return true;
         }
-        if (context.chatType !== 'private') {
-            await this.sendAdmissionControlReply(context, msg, sendReply, '联系人申请仅支持 AUN 私聊。');
+        // The structured protocol is AUN-only. For a blocked external alias,
+        // return false so the existing blacklist response/silence policy applies;
+        // never emit a custom payload through a non-AUN adapter.
+        if (context.contactStatus === 'blocked' && context.channelType !== 'aun')
+            return false;
+        if (context.channelType !== 'aun')
+            return true;
+        if (context.chatType !== 'private')
+            return true;
+        if (context.principal?.principalStatus !== 'native_aid' || !context.primaryId) {
+            await this.sendContactRequestProtocolResponse(adapter, msg, {
+                status: 'NOT_ALLOWED', requestId: null, expiresAt: null,
+            }, owningAgent?.name);
             return true;
         }
-        if (!context.primaryId) {
-            await this.sendAdmissionControlReply(context, msg, sendReply, '无法验证当前 AUN 身份，未提交联系人申请。');
+        if (context.contactStatus === 'blocked') {
+            await this.sendContactRequestProtocolResponse(adapter, msg, {
+                status: 'NOT_ALLOWED', requestId: null, expiresAt: null,
+            }, owningAgent?.name);
             return true;
         }
         let result;
-        try {
-            result = await submitContactRequest({
-                selfAid: context.selfAid,
-                applicantAid: context.primaryId,
-                note: requestMatch[1],
-                sourceChannelKey: context.channelKey,
-            });
-        }
-        catch (error) {
-            logger.warn(`[MessageBridge] Contact request submission failed: self=${context.selfAid} applicant=${context.primaryId} error=${error instanceof Error ? error.message : String(error)}`);
-            await this.sendAdmissionControlReply(context, msg, sendReply, '当前无法受理联系人申请，请稍后再试。');
-            return true;
+        if (protocolType === 'query') {
+            try {
+                result = await queryOwnContactRequestStatus({
+                    selfAid: context.selfAid,
+                    applicantAid: context.primaryId,
+                    requestId: protocolPayload && Object.prototype.hasOwnProperty.call(protocolPayload, 'request_id')
+                        ? protocolPayload.request_id
+                        : undefined,
+                });
+            }
+            catch (error) {
+                logger.warn(`[MessageBridge] Contact request query failed: ${error instanceof Error ? error.message : String(error)}`);
+                result = { status: 'NOT_ALLOWED', requestId: null, expiresAt: null };
+            }
         }
-        if ((result.code === 'submitted' || result.code === 'resubmitted') && result.requestId) {
-            void this.deliverContactReviewCard(context.selfAid, context.primaryId, result, owningAgent)
-                .catch(error => logger.warn(`[MessageBridge] Contact review delivery failed: self=${context.selfAid} applicant=${context.primaryId} error=${error instanceof Error ? error.message : String(error)}`));
+        else {
+            try {
+                if (protocolPayload && Object.prototype.hasOwnProperty.call(protocolPayload, 'note')
+                    && typeof protocolPayload?.note !== 'string') {
+                    await this.sendContactRequestProtocolResponse(adapter, msg, {
+                        status: 'NOT_ALLOWED', requestId: null, expiresAt: null,
+                    }, owningAgent?.name);
+                    return true;
+                }
+                const submission = await submitContactRequest({
+                    selfAid: context.selfAid,
+                    applicantAid: context.primaryId,
+                    note: typeof protocolPayload?.note === 'string' ? protocolPayload.note : undefined,
+                    sourceChannelKey: context.channelKey,
+                });
+                result = contactRequestSubmissionProtocolResult(submission);
+                if ((submission.code === 'submitted' || submission.code === 'resubmitted') && submission.requestId) {
+                    void this.deliverContactReviewCard(context.selfAid, context.primaryId, submission, owningAgent)
+                        .catch(error => logger.warn(`[MessageBridge] Contact review delivery failed: ${error instanceof Error ? error.message : String(error)}`));
+                }
+            }
+            catch (error) {
+                logger.warn(`[MessageBridge] Contact request submission failed: ${error instanceof Error ? error.message : String(error)}`);
+                result = { status: 'NOT_ALLOWED', requestId: null, expiresAt: null };
+            }
         }
-        await this.sendAdmissionControlReply(context, msg, sendReply, this.contactRequestReply(result));
+        await this.sendContactRequestProtocolResponse(adapter, msg, result, owningAgent?.name);
         return true;
     }
+    contactRequestReply(result) {
+        switch (result.code) {
+            case 'submitted': return '联系人申请已提交，等待管理员审核。';
+            case 'resubmitted': return '联系人申请已更新，等待管理员审核。';
+            case 'already-contact': return '你已经是联系人。';
+            case 'owner': return '你已经是 Owner。';
+            case 'blocked': return CONTACT_REJECTION_NOTICE;
+            case 'rate-limited': return '联系人申请过于频繁，请稍后再试。';
+            case 'capacity': return '当前申请较多，请稍后再试。';
+            case 'no-owner': return '当前无法受理联系人申请。';
+            case 'invalid-applicant': return '无法验证当前 AUN 身份，未提交联系人申请。';
+            case 'invalid-note': return '申请说明不能超过 500 个字符。';
+        }
+    }
+    async sendContactRequestProtocolResponse(adapter, msg, result, agentName) {
+        if (!adapter?.send)
+            return;
+        await adapter.send(buildEnvelope({
+            taskId: `contact-request-${randomBytes(4).toString('hex')}`,
+            channel: adapter.channelName,
+            channelId: msg.channelId,
+            agentName: agentName ?? '<unknown>',
+            replyContext: {
+                ...(msg.replyContext ?? {}),
+                metadata: {
+                    ...(msg.replyContext?.metadata ?? {}),
+                    ...evolMenuResponseTransportMetadata(),
+                },
+            },
+        }), {
+            kind: 'custom',
+            channelType: 'aun',
+            payload: {
+                type: 'contact.request.response',
+                status: result.status,
+                request_id: result.requestId,
+                expires_at: result.expiresAt,
+            },
+        });
+    }
     async sendAdmissionControlReply(context, msg, sendReply, text) {
         if (!text || !consumeAdmissionReplyBudget(context))
             return false;
@@ -360,20 +489,6 @@ export class MessageBridge {
         }
         return '当前不接受陌生人消息。联系人申请仅支持 AUN 私聊。';
     }
-    contactRequestReply(result) {
-        switch (result.code) {
-            case 'submitted': return '联系人申请已提交，等待管理员审核。';
-            case 'resubmitted': return '联系人申请已更新，等待管理员审核。';
-            case 'already-contact': return '你已经是联系人。';
-            case 'owner': return '你已经是 Owner。';
-            case 'blocked': return CONTACT_REJECTION_NOTICE;
-            case 'rate-limited': return '联系人申请过于频繁，请稍后再试。';
-            case 'capacity': return '当前申请较多，请稍后再试。';
-            case 'no-owner': return '当前无法受理联系人申请。';
-            case 'invalid-applicant': return '无法验证当前 AUN 身份，未提交联系人申请。';
-            case 'invalid-note': return '申请说明不能超过 500 个字符。';
-        }
-    }
     async deliverContactReviewCard(selfAid, applicantAid, submission, owningAgent) {
         if (!this.interactionRouter || !submission.requestId || !submission.expiresAt || !submission.submittedAt) {
             return false;
@@ -463,7 +578,7 @@ export class MessageBridge {
             }
             if (reviewed.code === 'approved' || reviewed.code === 'rejected' || reviewed.code === 'blocked') {
                 try {
-                    await this.notifyContactApplicant(route.adapter, applicantAid, reviewed.code, owningAgent?.name);
+                    await this.notifyContactApplicant(route.adapter, applicantAid, reviewed.code, submission.requestId, submission.expiresAt, owningAgent?.name);
                 }
                 catch (error) {
                     logger.warn(`[MessageBridge] Contact applicant notification failed: request=${submission.requestId} error=${error instanceof Error ? error.message : String(error)}`);
@@ -502,11 +617,22 @@ export class MessageBridge {
                                 : '当前无审核权限。';
         await adapter.send(buildEnvelope({ channel: adapter.channelName, channelId: ownerAid, agentName: agentName ?? '<unknown>' }), { kind: 'system.notice', text, subtype: 'contact-review' });
     }
-    async notifyContactApplicant(adapter, applicantAid, code, agentName) {
-        const text = code === 'approved' ? '你的联系人申请已通过。'
-            : code === 'rejected' ? '你的联系人申请未通过。'
-                : '你的联系人申请未通过。';
-        await adapter.send(buildEnvelope({ channel: adapter.channelName, channelId: applicantAid, agentName: agentName ?? '<unknown>' }), { kind: 'system.notice', text, subtype: 'contact-request-result' });
+    async notifyContactApplicant(adapter, applicantAid, code, requestId, expiresAt, agentName) {
+        await adapter.send(buildEnvelope({
+            channel: adapter.channelName,
+            channelId: applicantAid,
+            agentName: agentName ?? '<unknown>',
+            replyContext: { metadata: evolMenuResponseTransportMetadata() },
+        }), {
+            kind: 'custom',
+            channelType: 'aun',
+            payload: {
+                type: 'contact.request.response',
+                status: code === 'approved' ? 'APPROVED' : code === 'rejected' ? 'REJECTED' : 'NOT_ALLOWED',
+                request_id: requestId,
+                expires_at: expiresAt,
+            },
+        });
     }
     getDebouncer(channelName, channelType) {
         let d = this.debouncers.get(channelName);
@@ -582,6 +708,16 @@ export class MessageBridge {
                     actorId,
                     trustedHandoffEcho,
                 });
+                if (!trustedHandoffEcho && await this.handleContactRequestProtocol({
+                    context: admissionPreflight.context,
+                    msg,
+                    content,
+                    owningAgent,
+                    adapter,
+                    sendReply,
+                })) {
+                    return;
+                }
                 if (!admissionPreflight.allow) {
                     const requestCommand = /^\s*\/request(?:\s|$)/i.test(content);
                     if (admissionPreflight.reason === 'blocked' && admissionPreflight.context.primaryId) {
@@ -760,7 +896,7 @@ export class MessageBridge {
                         channelKey,
                         channelType: msg.channelType || effectiveChannelType,
                         channelId: msg.channelId,
-                        recipientId: actorId,
+                        recipientId: roleDetail.actor.principalId || actorId,
                         recipientName: msg.peerName,
                         source: 'inbound',
                     });
@@ -900,7 +1036,7 @@ export class MessageBridge {
                     source: msg.source,
                     boundSessionId: session.id,
                     resolvedIdentity: identity,
-                    dispatchMode: msg.dispatchMode,
+                    mentionMode: msg.mentionMode,
                     causation: inboundCausation,
                 };
                 recordCausationSpan(inboundCausation, 'message.inbound', {
@@ -1027,28 +1163,6 @@ export class MessageBridge {
         });
     }
     // ── Menu Protocol ──
-    static MENU_NAME_MAP = {
-        pwd: '/pwd',
-        session: '/session',
-        topic: '/topic',
-        baseagent: '/baseagent',
-        model: '/model',
-        effort: '/effort',
-        chatmode: '/chatmode',
-        mentionmode: '/mentionmode',
-        group: '/group',
-        permission: '/perm',
-        activity: '/activity',
-        observable: '/observable',
-        system: '/system',
-        cli: '/cli',
-        agent: '/agent',
-        trigger: '/trigger',
-        file: '/file',
-        capability: '/capability',
-        role: '/role',
-        connect: '/connect',
-    };
     extractTopicName(msg) {
         const raw = msg.topicName
             ?? msg.replyContext?.title
@@ -1077,7 +1191,7 @@ export class MessageBridge {
     resolveCmd(name, cmd) {
         if (cmd)
             return cmd;
-        const mapped = MessageBridge.MENU_NAME_MAP[name];
+        const mapped = menuCommandForName(name);
         if (!mapped)
             throw { code: 'NOT_SUPPORTED', message: `Unsupported menu name: ${name}` };
         return mapped;
@@ -1152,29 +1266,73 @@ export class MessageBridge {
             const args = request.args;
             switch (request.type) {
                 case 'menu.list':
+                    if (args?.view === 'catalog') {
+                        validateMenuCatalogArgs(args);
+                        const data = await this.cmdHandler.getMenuCatalog(channel, msg.channelId, authSubject, args.context, msg.isControlChannel ? 'control' : 'agent');
+                        return menuSuccess(header, data);
+                    }
+                    if (args?.view !== undefined) {
+                        return menuFailure(header, { code: 'NOT_SUPPORTED', message: `Unsupported menu.list view: ${String(args.view)}` });
+                    }
                     return menuSuccess(header, this.cmdHandler.getMenuItems(identity.role, msg.chatType || 'private', msg.isControlChannel ? 'control' : 'agent', authSubject));
                 case 'menu.query': {
-                    const result = await this.cmdHandler.execMenuQuery(this.resolveCmd(name, cmd), channel, msg.channelId, msg.peerId, args, msg.chatType, msg.isControlChannel ?? false, identity, authSubject);
+                    if (name === 'menu' && args?.view === 'values') {
+                        validateMenuValueBatchArgs(args);
+                        const data = await this.cmdHandler.execMenuValueBatch(channel, msg.channelId, authSubject, args, args.context, msg.isControlChannel ? 'control' : 'agent');
+                        return menuSuccess(header, data);
+                    }
+                    if (name === 'menu') {
+                        return menuFailure(header, { code: 'NOT_SUPPORTED', message: `Unsupported menu.query view: ${String(args?.view)}` });
+                    }
+                    const execution = await resolveExplicitMenuExecutionContext({
+                        subject: authSubject,
+                        channelType: authSubject.channelType,
+                        channelScope: msg.isControlChannel ? 'control' : 'agent',
+                        channelId: msg.channelId,
+                        args,
+                    });
+                    const result = await this.cmdHandler.execMenuQuery(this.resolveCmd(name, cmd), channel, execution.channelId, execution.subject.actorId, execution.args, execution.subject.chatType, execution.subject.fromControlChannel, execution.subject.identity, execution.subject);
                     if ('error' in result)
                         throw result;
                     return menuSuccess(header, result.data);
                 }
                 case 'menu.options': {
-                    let optionArgs = args;
+                    const execution = await resolveExplicitMenuExecutionContext({
+                        subject: authSubject,
+                        channelType: authSubject.channelType,
+                        channelScope: msg.isControlChannel ? 'control' : 'agent',
+                        channelId: msg.channelId,
+                        args,
+                    });
+                    let optionArgs = execution.args;
                     if ((name === 'topic' || cmd === '/topic') && args?.mode === 'fork-turns' && msg.threadId && !args?.sourceThreadId) {
-                        optionArgs = { ...(args ?? {}), sourceThreadId: msg.threadId };
+                        optionArgs = { ...(execution.args ?? {}), sourceThreadId: msg.threadId };
                     }
-                    const data = await this.cmdHandler.getSubMenuItems(this.resolveCmd(name, cmd), channel, msg.channelId, msg.peerId, optionArgs, identity, msg.chatType, msg.isControlChannel ?? false, authSubject) ?? [];
+                    const data = await this.cmdHandler.getSubMenuItems(this.resolveCmd(name, cmd), channel, execution.channelId, execution.subject.actorId, optionArgs, execution.subject.identity, execution.subject.chatType, execution.subject.fromControlChannel, execution.subject) ?? [];
                     return menuSuccess(header, data);
                 }
                 case 'menu.update': {
-                    const result = await this.cmdHandler.execMenuUpdate(this.resolveCmd(name, cmd), request.value, channel, msg.channelId, msg.peerId, identity, msg.isControlChannel ?? false, args, authSubject);
+                    const execution = await resolveExplicitMenuExecutionContext({
+                        subject: authSubject,
+                        channelType: authSubject.channelType,
+                        channelScope: msg.isControlChannel ? 'control' : 'agent',
+                        channelId: msg.channelId,
+                        args,
+                    });
+                    const result = await this.cmdHandler.execMenuUpdate(this.resolveCmd(name, cmd), request.value, channel, execution.channelId, execution.subject.actorId, execution.subject.identity, execution.subject.fromControlChannel, execution.args, execution.subject);
                     if ('error' in result)
                         throw result;
                     return menuSuccess(header, result.data);
                 }
                 case 'menu.action': {
-                    let actionArgs = args;
+                    const execution = await resolveExplicitMenuExecutionContext({
+                        subject: authSubject,
+                        channelType: authSubject.channelType,
+                        channelScope: msg.isControlChannel ? 'control' : 'agent',
+                        channelId: msg.channelId,
+                        args,
+                    });
+                    let actionArgs = execution.args;
                     if ((name === 'topic' || cmd === '/topic') && request.action === 'fork' && msg.threadId) {
                         if (typeof args?.targetThreadId === 'string' && args.targetThreadId !== msg.threadId) {
                             return menuFailure(header, {
@@ -1182,11 +1340,11 @@ export class MessageBridge {
                                 message: 'args.targetThreadId 必须与消息 thread_id 一致',
                             });
                         }
-                        actionArgs = { ...(args ?? {}), targetThreadId: msg.threadId };
+                        actionArgs = { ...(execution.args ?? {}), targetThreadId: msg.threadId };
                     }
                     const resolvedCmd = this.resolveCmd(name, cmd);
                     const isFileFetch = resolvedCmd.trim().split(' ')[0] === '/file' && request.action === 'fetch';
-                    const result = await this.cmdHandler.execMenuAction(resolvedCmd, request.action, actionArgs, channel, msg.channelId, msg.peerId, identity, msg.chatType, header.id, msg.isControlChannel ?? false, authSubject, 'menu', msg.replyContext, isFileFetch ? registerAfterResponse : undefined);
+                    const result = await this.cmdHandler.execMenuAction(resolvedCmd, request.action, actionArgs, channel, execution.channelId, execution.subject.actorId, execution.subject.identity, execution.subject.chatType, header.id, execution.subject.fromControlChannel, execution.subject, 'menu', msg.replyContext, isFileFetch ? registerAfterResponse : undefined);
                     if ('error' in result)
                         throw result;
                     return menuSuccess(header, result.data);

package/dist/core/message/message-log.js

@@ -3,6 +3,7 @@ import path from 'path';
 import { appendJsonl, chatDirPath } from '../session/session-fs-store.js';
 import { logger } from '../../utils/logger.js';
 const TRANSIENT_PROTOCOL_TYPE_PREFIXES = [
+    'contact.request.',
     'menu.',
     'status.',
     'event.',
@@ -229,6 +230,27 @@ function formatTimestampMs(epochMs) {
 export function messageLogPath(chatDir) {
     return path.join(chatDir, MESSAGE_LOG_FILE);
 }
+export function hasMessageLogOperation(chatDir, operationId) {
+    const file = messageLogPath(chatDir);
+    if (!fs.existsSync(file))
+        return false;
+    try {
+        return fs.readFileSync(file, 'utf-8').split('\n').some(line => {
+            if (!line.trim())
+                return false;
+            try {
+                const entry = JSON.parse(line);
+                return entry?.dir === 'out' && entry.operationId === operationId;
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    catch {
+        return false;
+    }
+}
 export function resolveChatDir(sessionsDir, channelType, channelId, selfAID) {
     return chatDirPath(sessionsDir, channelType, channelId, selfAID);
 }
@@ -323,6 +345,7 @@ export function buildOutboundEntry(opts) {
         transport: opts.transport,
         peerType: opts.peerType,
         source: opts.source ?? 'daemon',
+        operationId: opts.operationId,
         handoff_trace: opts.handoff_trace,
     };
 }

package/dist/core/message/message-queue.js

@@ -1075,6 +1075,7 @@ export class MessageQueue {
                     content: m.content, timestamp: m.timestamp,
                     causation: m.causation,
                     images: m.images && m.images.length > 0 ? m.images : undefined,
+                    mentions: m.mentions && m.mentions.length > 0 ? m.mentions : undefined,
                     mentionAids: m.mentionAids && m.mentionAids.length > 0 ? m.mentionAids : undefined,
                 });
             }
@@ -1361,9 +1362,9 @@ export class MessageQueue {
     isAgentMuted(agentName) {
         return this.mutedAgents.has(agentName);
     }
-    /** 中断指定 agent 所有正在处理中的会话。 */
-    interruptByAgent(agentName) {
+    beginAgentInterrupt(agentName) {
         let interrupted = 0;
+        const barriers = [];
         for (const [queueKey, name] of this.processingAgent) {
             if ((name || DEFAULT_AGENT_NAME) === agentName) {
                 interrupted++;
@@ -1378,11 +1379,26 @@ export class MessageQueue {
                     causation: this.activeBatches.get(queueKey)?.message.causation,
                 });
                 if (this.interruptCallback) {
-                    void this.triggerInterrupt(queueKey, sessionKey, activeState?.baseagent, name, 'stop');
+                    barriers.push(this.triggerInterrupt(queueKey, sessionKey, activeState?.baseagent, name, 'stop'));
                 }
             }
         }
-        return interrupted;
+        return {
+            count: interrupted,
+            barrier: Promise.allSettled(barriers).then(() => undefined),
+        };
+    }
+    /** 中断指定 agent 所有正在处理中的会话。 */
+    interruptByAgent(agentName) {
+        const interruption = this.beginAgentInterrupt(agentName);
+        void interruption.barrier;
+        return interruption.count;
+    }
+    /** 中断指定 agent 的会话，并等待 runner 中断屏障完成。 */
+    async interruptByAgentAndWait(agentName) {
+        const interruption = this.beginAgentInterrupt(agentName);
+        await interruption.barrier;
+        return interruption.count;
     }
     // ── Queue query/management methods ──
     /**