evolclaw 3.1.11 → 3.3.0

package/dist/channels/aun.js

@@ -5,12 +5,13 @@ import path from 'path';
 import os from 'os';
 import { logger, localTimestamp } from '../utils/logger.js';
 import { LogWriter } from '../utils/log-writer.js';
-import { normalizeChannelInstances, getChannelShowActivities } from '../utils/channel-helpers.js';
+import { resolveShowActivities, showActivitiesPolicy } from '../core/channel-loader.js';
 import { resolvePaths, getPackageRoot, agentMdPath as agentMdPathFn, agentDir as agentDirPath, resolveRoot } from '../paths.js';
 import { saveToUploads, sanitizeFileName, bufferToInboundImage } from '../utils/media-cache.js';
 import { appendAidEvent } from '../utils/instance-registry.js';
-import { appendMessageLog, buildOutboundEntry } from '../core/message/message-log.js';
+import { appendMessageLog, buildOutboundEntry, buildInboundEntry } from '../core/message/message-log.js';
 import { chatDirPath } from '../core/session/session-fs-store.js';
+import { appendHintAdd, appendHintRemove, parseInjectRequest } from '../core/message/pending-hints.js';
 import { appendAidLifecycle } from '../aun/aid/identity.js';
 import { getAidStore, loadClient, SLOT } from '../aun/aid/store.js';
 import { loadAgent, saveAgent } from '../config-store.js';
@@ -58,6 +59,38 @@ function getEvolclawVersion() {
     }
     return _cachedVersion;
 }
+/**
+ * 把 AUNChannel 投递的 opts 映射成渠道无关的 InboundMessage。
+ *
+ * registerBridge 适配回调用它替代手抄字段——历史上手抄漏掉了
+ * sameDevice/sameNetwork/sameEgressIp，proximity 在此被吞，eck-debug 永远 false。
+ * 抽成纯函数后可单测锁字段，杜绝再漏。
+ */
+export function aunOptsToInbound(opts, channel, channelType) {
+    return {
+        channel,
+        channelType,
+        channelId: opts.channelId,
+        selfAID: opts.selfAID,
+        groupId: opts.groupId,
+        content: opts.content,
+        chatType: opts.chatType || 'private',
+        peerId: opts.peerId || '',
+        peerName: opts.peerName,
+        peerType: opts.peerType,
+        sameDevice: opts.sameDevice,
+        sameNetwork: opts.sameNetwork,
+        sameEgressIp: opts.sameEgressIp,
+        messageId: opts.messageId,
+        mentions: opts.mentions,
+        mentionAids: opts.mentionAids,
+        threadId: opts.threadId,
+        replyContext: opts.replyContext,
+        source: opts.source,
+        images: opts.images,
+        dispatchMode: opts.dispatchMode,
+    };
+}
 export class AUNChannel {
     config;
     client = null;
@@ -84,14 +117,16 @@ export class AUNChannel {
         // 便于 jq 过滤：`jq 'select(.task_id == "task-xxx")'`
         const d = (data && typeof data === 'object') ? data : {};
         const payload = d.payload ?? {};
+        // 入站事件（IN）路由字段在 d.envelope.*（SDK 0.5.*）；出站 params（OUT）字段在顶层。两者兼顾。
+        const env = (d.envelope && typeof d.envelope === 'object') ? d.envelope : {};
         const topContext = {
             self_aid: this._aid ?? this.config.aid,
         };
         // peer / group 识别
-        const peerAid = d.to ?? d.from ?? d.sender_aid ?? payload.to;
+        const peerAid = env.to ?? env.from ?? d.to ?? d.from ?? d.sender_aid ?? payload.to;
         if (peerAid)
             topContext.peer_aid = peerAid;
-        const groupId = d.group_id ?? payload.group_id;
+        const groupId = env.group_id ?? d.group_id ?? payload.group_id;
         if (groupId)
             topContext.group_id = groupId;
         // task_id / chatmode（message.send / thought.put / status 都可能有）
@@ -144,6 +179,7 @@ export class AUNChannel {
      *  - 数字群号：{group_no}.{issuer}（如 11117.agentid.pub）
      *  - 兼容旧格式：grp_xxx、g-xxx.agentid.pub
      */
+    /** 判断 channelId 是否群组 ID（public：plugin adapter 闭包需调用） */
     isGroupId(id) {
         return (id.startsWith('group.') && id.includes('/'))
             || /^\d+\./.test(id)
@@ -184,23 +220,19 @@ export class AUNChannel {
                 if (cardInfo) {
                     const actionValue = typeof obj.value === 'string' ? obj.value
                         : typeof obj.action_value === 'string' ? obj.action_value : text;
+                    // 卡片点击者身份：只信认证信封（senderAid 参数，由调用方从 msg.from / msg.sender_aid 提取）。
+                    // payload 自报字段（from / sender_aid / user_id）不可信，可被客户端伪造，不读取。
+                    // 两类卡片共用：CommandCard → 伪入站消息的 peerId，ActionInteraction → operatorId。
+                    const cardClickerAid = senderAid || channelId || '';
                     if (cardInfo.isCommandCard) {
                         // CommandCard：action_value 是完整 slash 命令，构造伪入站消息
                         this.cardMessageIdMap.delete(cardMsgId);
                         if (this.messageHandler && actionValue.startsWith('/')) {
                             const chatType = channelId ? (this.isGroupId(channelId) ? 'group' : 'private') : 'private';
-                            // 卡片点击者身份：优先 payload.from / payload.sender_aid / payload.user_id，
-                            // 再 fallback 到外层 senderAid，最后用 cardInfo 中记录的原始命令发起者
-                            const cardClickerAid = (typeof obj.from === 'string' && obj.from)
-                                || (typeof obj.sender_aid === 'string' && obj.sender_aid)
-                                || (typeof obj.user_id === 'string' && obj.user_id)
-                                || senderAid
-                                || cardInfo.initiatorAid
-                                || channelId || '';
-                            // Initiator 校验：群聊中仅卡片发起者可操作（与飞书行为对齐）
-                            if (cardInfo.initiatorAid && cardClickerAid
-                                && cardClickerAid !== cardInfo.initiatorAid
-                                && !this.isGroupId(cardClickerAid)) {
+                            // Initiator 校验：仅群聊需要（私聊信道一对一，点击者恒为对端 = initiator）。
+                            // 身份只信认证信封提取的 cardClickerAid，非 payload 自报。
+                            if (chatType === 'group' && cardInfo.initiatorAid && cardClickerAid
+                                && cardClickerAid !== cardInfo.initiatorAid) {
                                 logger.info(`${this.logPrefix()} CommandCard rejected: clicker=${cardClickerAid} initiator=${cardInfo.initiatorAid} mid=${cardMsgId}`);
                                 return '';
                             }
@@ -225,6 +257,7 @@ export class AUNChannel {
                                 id: cardInfo.requestId,
                                 action: actionValue,
                                 values: { text, action_label: obj.label ?? obj.action_label, behavior: obj.behavior },
+                                operatorId: cardClickerAid || undefined,
                             });
                         }
                     }
@@ -427,6 +460,7 @@ export class AUNChannel {
     _selfName; // 本地 agent.md 中的 name，首次 connect 时读取
     _chatId = ''; // aid:device_id:slot_id — 多实例回声过滤
     seenMessages = new Map();
+    groupNameCache = new Map(); // groupId → 群显示名（进程内缓存，群名极少变）
     peerInfoCache = new Map();
     messageSeqMap = new Map(); // messageId → seq (for ack)
     sentCount = new Map(); // channelId → 已发消息计数（用于判断最终回复）
@@ -445,6 +479,8 @@ export class AUNChannel {
     static MENU_REQUEST_TYPES = new Set([
         'menu.list', 'menu.query', 'menu.options', 'menu.update', 'menu.action',
     ]);
+    /** 观察者插话请求类型（owner → agent.AID）。详见 docs/observer-insert-design.md。 */
+    static INJECT_REQUEST_TYPE = 'observer.inject';
     // Reconnect state
     // SDK 自己跑无限指数退避（1s → 5min）；TS 层只在 SDK 够不到的两类场景下接管：
     //  1. flap：短命 connected 反复出现（SDK 不记忆跨轮 base delay，会从 1s 重新开始）
@@ -591,13 +627,17 @@ export class AUNChannel {
             logger.debug(`${this.logPrefix()}[DIAG] message.received: kind=${kind} keys=${keys}`);
             this.handleIncomingPrivateMessage(data);
         });
-        client.on('group.message_created', (data) => {
-            this.trace('IN', 'group.message_created', data);
-            const gid = (data && typeof data === 'object') ? data.group_id ?? '' : '';
-            const sender = (data && typeof data === 'object') ? data.sender_aid ?? '' : '';
-            logger.debug(`${this.logPrefix()}[DIAG] group.message_created: group_id=${gid} sender=${sender}`);
-            this.handleIncomingGroupMessage(data);
-        });
+        // pureIdentity（控制 AID）：协议层不接群消息，不注册 group 创建监听
+        if (!this.config.pureIdentity) {
+            client.on('group.message_created', (data) => {
+                this.trace('IN', 'group.message_created', data);
+                const env = (data && typeof data === 'object') ? data.envelope ?? {} : {};
+                const gid = env.group_id ?? '';
+                const sender = env.from ?? '';
+                logger.debug(`${this.logPrefix()}[DIAG] group.message_created: group_id=${gid} sender=${sender}`);
+                this.handleIncomingGroupMessage(data);
+            });
+        }
         client.on('connection.state', (data) => {
             // trace is handled inside handleConnectionState with throttling
             this.handleConnectionState(data);
@@ -624,13 +664,36 @@ export class AUNChannel {
         client.on('message.undecryptable', (data) => {
             this.trace('IN', 'message.undecryptable', data);
             const d = data;
-            logger.warn(`${this.logPrefix()} Message undecryptable: from=${d.from} mid=${d.message_id} err=${d._decrypt_error}`);
-        });
-        client.on('group.message_undecryptable', (data) => {
-            this.trace('IN', 'group.message_undecryptable', data);
-            const d = data;
-            logger.warn(`${this.logPrefix()} Group message undecryptable: group=${d.group_id} from=${d.from} mid=${d.message_id} err=${d._decrypt_error}`);
+            const env = (d.envelope && typeof d.envelope === 'object') ? d.envelope : {};
+            logger.warn(`${this.logPrefix()} Message undecryptable: from=${env.from} mid=${d.message_id} err=${d._decrypt_error}`);
         });
+        // pureIdentity（控制 AID）：不注册 group 解密失败监听
+        if (!this.config.pureIdentity) {
+            client.on('group.message_undecryptable', (data) => {
+                this.trace('IN', 'group.message_undecryptable', data);
+                const d = data;
+                const env = (d.envelope && typeof d.envelope === 'object') ? d.envelope : {};
+                logger.warn(`${this.logPrefix()} Group message undecryptable: group=${env.group_id} from=${env.from} mid=${d.message_id} err=${d._decrypt_error}`);
+            });
+            // 群消息撤回（SDK 0.4.10 在线 push 通道）：与私聊 message.recalled 同构，
+            // 逐个 message_id 交给 recallHandler → msgBridge.cancel（排队中删除 / 处理中中断）。
+            client.on('group.message_recalled', (data) => {
+                this.trace('IN', 'group.message_recalled', data);
+                if (data && typeof data === 'object') {
+                    const d = data;
+                    const env = (d.envelope && typeof d.envelope === 'object') ? d.envelope : {};
+                    const ids = d.message_ids;
+                    if (Array.isArray(ids)) {
+                        for (const id of ids) {
+                            if (typeof id === 'string') {
+                                logger.info(`${this.logPrefix()} Group message recalled: group=${env.group_id ?? ''} mid=${id}`);
+                                this.recallHandler?.(id);
+                            }
+                        }
+                    }
+                }
+            });
+        }
         // Authenticate（拿权威 gateway 用于日志/状态；connect 内部也会复用 token）
         try {
             logger.info(`${this.logPrefix()} Authenticating as ${aidName}...`);
@@ -676,7 +739,8 @@ export class AUNChannel {
             this._aid = this.client.aid ?? undefined;
             const deviceId = this.client._device_id ?? '';
             this._chatId = this._aid ? `${this._aid}:${deviceId}:` : '';
-            this._selfName = this.loadSelfName(aidName);
+            // pureIdentity（控制 AID）：无 agent.md，跳过自身 agent.md 拉取，省一次 404
+            this._selfName = this.config.pureIdentity ? undefined : this.loadSelfName(aidName);
             if (this._selfName && this.aidStatsCollector)
                 this.aidStatsCollector.setSelfName(this.config.aid, this._selfName);
             this.connected = true;
@@ -697,7 +761,10 @@ export class AUNChannel {
             appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'connected', aid: this.config.aid, gateway: this.gatewayUrl });
             appendAidLifecycle({ ts: Date.now(), iso: new Date().toISOString(), event: 'connected', aid: this.config.aid, gateway: this.gatewayUrl });
             // Send welcome message to owner after first connection
-            await this.sendWelcomeMessage();
+            // pureIdentity（控制 AID）：跳过 evolagent onboarding（根除 warn 噪声 + 永不 agentmdPut）
+            if (!this.config.pureIdentity) {
+                await this.sendWelcomeMessage();
+            }
         }
         catch (e) {
             this.trace('OUT', 'client.connect.error', { error: String(e) });
@@ -962,12 +1029,23 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         if (!data || typeof data !== 'object')
             return;
         const msg = data;
-        const fromAid = msg.from ?? '';
+        // SDK 0.5.* 移除了顶层 from/to/group_id/encrypted 等别名，统一从 msg.envelope.* 读取。
+        // message_id / seq / payload / same_* 等仍是顶层独立字段，不在 envelope 内。
+        const env = (msg.envelope && typeof msg.envelope === 'object') ? msg.envelope : {};
+        const fromAid = env.from ?? '';
         const payload = msg.payload ?? '';
-        const text = this.extractTextPayload(payload, fromAid);
+        const text = this.extractTextPayload(payload, fromAid, fromAid);
         const threadId = typeof payload === 'object' && payload !== null ? payload.thread_id : undefined;
         const messageId = msg.message_id ?? '';
         const seq = msg.seq;
+        // Observer forward (inbound)：在所有过滤之前转发原始明文 payload。
+        // forwardInbound 内部排除 self-echo 与 from-owner。
+        // 显式排除 observer.inject：它是 owner 对本 agent 的控制消息，不应镜像给观察者
+        // （即便日后 from-owner 排除规则调整，也不会泄漏）。
+        const inboundType = (payload && typeof payload === 'object') ? payload.type : undefined;
+        if (inboundType !== AUNChannel.INJECT_REQUEST_TYPE) {
+            this.forwardInbound(msg);
+        }
         // 回声过滤：自己发出的消息会被 gateway fanout 回来，
         // 只有 from_aid == self 且 chat_id 不匹配时才丢弃（说明是其它实例发的）
         const msgChatId = typeof payload === 'object' && payload !== null && payload.chat_id;
@@ -977,7 +1055,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             return;
         }
         // 记录入站消息加密状态，透传到出站 ReplyContext
-        const msgEncrypted = !!(msg.e2ee);
+        const msgEncrypted = !!env.encrypted;
         if (!msgEncrypted)
             this.plaintextRecv++;
         // Detect @mentions
@@ -1013,6 +1091,13 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             });
             return;
         }
+        // observer.inject：owner 插话。鉴权 from∈owners 后，以 target.channel_id 选 agent↔对端 会话，
+        // observer 插话（v0.3）：只落盘到 pending-hints，不进 Agent、不回 owner。详见 docs/observer-insert-design.md。
+        if (p2pPayloadType === AUNChannel.INJECT_REQUEST_TYPE) {
+            this.acknowledgeImmediately(messageId, seq);
+            this.handleObserverInject(fromAid, payload, displayName, peerIdentity.type);
+            return;
+        }
         // payload 类型白名单：信号类消息（status / event / thought 等）不进 Agent
         if (p2pPayloadType && !AUNChannel.PROACTIVE_ALLOW_TYPES.has(p2pPayloadType)) {
             this.acknowledgeImmediately(messageId, seq);
@@ -1049,13 +1134,19 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         if (!data || typeof data !== 'object')
             return;
         const msg = data;
-        const groupId = msg.group_id ?? '';
-        const senderAid = msg.sender_aid ?? '';
+        // SDK 0.5.* 移除了顶层 from/sender_aid/group_id/encrypted 等别名，统一从 msg.envelope.* 读取。
+        // message_id / seq / payload / same_* / dispatch_mode 等仍是顶层独立字段，不在 envelope 内。
+        const env = (msg.envelope && typeof msg.envelope === 'object') ? msg.envelope : {};
+        const groupId = env.group_id ?? '';
+        const senderAid = env.from ?? '';
         const payload = msg.payload ?? '';
         const text = this.extractTextPayload(payload, groupId, senderAid);
         const threadId = typeof payload === 'object' && payload !== null ? payload.thread_id : undefined;
         const messageId = msg.message_id ?? '';
         const seq = msg.seq;
+        // Observer forward (inbound)：群聊消息在所有过滤之前转发原始明文 payload。
+        // forwardInbound 内部排除 self-echo 与 from-owner。
+        this.forwardInbound(msg);
         // Extract structured mentions from payload (e.g. payload.mentions: ["evolai.agentid.pub"])
         const payloadMentions = Array.isArray(payload?.mentions)
             ? payload.mentions.filter((m) => typeof m === 'string')
@@ -1077,7 +1168,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             const hasEvolClawTrace = /\[EvolClaw\.(receive|reply|agent)\]/.test(text);
             if (/echo/i.test(firstLineFast) && firstLineFast.trim().length <= 10 && !hasEvolClawTrace) {
                 this.acknowledgeImmediately(messageId, seq);
-                const msgEncryptedFast = !!(msg.e2ee);
+                const msgEncryptedFast = !!env.encrypted;
                 const msgChatmodeFast = (payload && typeof payload === 'object') ? payload.chatmode : undefined;
                 const peerInfo = this.peerInfoCached(senderAid);
                 const shortAid = this.getShortAid(senderAid);
@@ -1128,7 +1219,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             }
         }
         // 记录入站消息加密状态，透传到出站 ReplyContext
-        const msgEncrypted = !!(msg.e2ee);
+        const msgEncrypted = !!env.encrypted;
         if (!msgEncrypted)
             this.plaintextRecv++;
         // dispatch_mode: 本地设置优先，fallback 到服务器参数
@@ -1216,6 +1307,12 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         logger.info(`${this.logPrefix()} Group dispatched: group=${groupId} sender=${shortAid}(${displayName}) mode=${dispatchMode} mid=${messageId} chatmode=${msgChatmode ?? 'none'} text=${finalText.slice(0, 60)}`);
         appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_in', aid: this.config.aid, from: senderAid, msgId: messageId, kind: 'text', len: finalText.length, groupId });
         this.aidStatsCollector?.recordInbound(this.config.aid, senderAid, Buffer.byteLength(finalText, 'utf-8'), finalText, payloadType === 'event', msgEncrypted, msgChatmode);
+        // 渲染用完整 @ 列表：结构化 payload.mentions + 正文 @aid 兜底，去重（含 self / "all"）。
+        // 与上面用于过滤/回复的精简 mentions 独立——这份不丢任何被 @ 的 AID。
+        const renderMentionAids = Array.from(new Set([
+            ...payloadMentions,
+            ...this.extractMentionAidsFromText(text),
+        ]));
         this.dispatchMessage({
             channelId: groupId,
             groupId,
@@ -1231,7 +1328,9 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             seq,
             threadId,
             mentions,
+            mentionAids: renderMentionAids.length > 0 ? renderMentionAids : undefined,
             replyContext: this.buildGroupReplyContext(threadId, senderAid, msgEncrypted, messageId, msgChatmode),
+            dispatchMode,
             images: inboundImages.length > 0 ? inboundImages : undefined,
         });
     }
@@ -1301,50 +1400,191 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             messageId: event.messageId,
             threadId: event.threadId,
             mentions: mentionObjects,
+            mentionAids: event.mentionAids,
             replyContext,
+            source: event.source,
+            dispatchMode: event.dispatchMode,
             images: event.images,
         }).catch(err => {
             logger.error(`${this.logPrefix()} Message handler error:`, err);
         });
-        // Observer forward: inbound
-        this.forwardToOwners('inbound', {
-            from: event.userId || event.channelId || '',
-            to: this.config.aid,
-            seq: event.seq,
-            payload: { type: 'text', text: event.text },
-        });
     }
+    // ── 观察者模式（Observer Mode） ──────────────────────────────
+    //
+    // observable=true 时，Agent 收发的每条 AUN 消息（原始信封 + 解密后明文
+    // payload）镜像一份给 owners[]。入站在所有过滤之前转发；出站在真实发送
+    // 成功后转发。外层一律明文。详见 docs/observer-mode-design.md。
+    // observable / owners 不在此处缓存——由 daemon 注入 resolver，从 EvolAgent 的
+    // in-memory merged config（启动/重启/热重载时统一更新的唯一缓存）读取，避免重复缓存。
+    observerConfigResolver;
+    /** 注入观察者配置读取器（daemon 侧从 EvolAgent merged config 读）。 */
+    setObserverConfigResolver(fn) {
+        this.observerConfigResolver = fn;
+    }
+    /** 读取 observable 开关 + owners；无 resolver（如未接入 daemon）时视为关闭。 */
+    getObserverConfig() {
+        return this.observerConfigResolver?.() ?? { observable: false, owners: [] };
+    }
+    /**
+     * 入站转发：到达本 AID 的消息全部转发，排除 self-echo。
+     * 若消息发送方本身是 owner，则不转发给该 owner，但仍转发给其他 owner。
+     * 调用点须在所有过滤逻辑之前，payload 为 SDK 解密后的明文。
+     */
     /**
-     * 观察者模式转发：将消息副本以 observer.forward 格式发给所有 owners。
-     * 仅在 AgentConfig.observable === true 时执行；owners 为空或无法加载配置时静默跳过。
+     * 入站转发：把对端发来的消息原样转发给 owner。
+     * data 为 SDK message.received / group.message_created 回调的整个对象，
+     * 不拆解、不重组——SDK 信封结构变化不影响此处。
      */
-    forwardToOwners(direction, original) {
+    forwardInbound(data) {
         if (!this.connected || !this.client)
             return;
-        const agentConfig = loadAgent(this.config.aid);
-        if (!agentConfig?.observable)
+        const { observable, owners } = this.getObserverConfig();
+        if (!observable || owners.length === 0)
             return;
-        const owners = agentConfig.owners ?? [];
-        if (owners.length === 0)
+        const env = (data?.envelope && typeof data.envelope === 'object') ? data.envelope : {};
+        const from = env.from ?? '';
+        if (this._aid && from === this._aid)
+            return; // self-echo：已在出站转过
+        // 排除来源 owner（不把"owner A 发来的"再转回 A），但仍转给其他 owner。
+        const recipientOwners = owners.filter(o => o !== from);
+        if (recipientOwners.length === 0)
             return;
+        this.emitForward('inbound', data, recipientOwners);
+    }
+    /**
+     * 出站转发：Agent 经 AUN 真实发出的消息原样转发给 owner。
+     * result 为 SDK message.send / group.send 的 SendResult（已 attach envelope + payload）。
+     * 若对端本身是 owner，排除该 owner（不把"回复 A"转发给 A 自己）。
+     */
+    forwardOutbound(result) {
+        if (!this.connected || !this.client)
+            return;
+        const { observable, owners } = this.getObserverConfig();
+        if (!observable || owners.length === 0)
+            return;
+        const env = (result?.envelope && typeof result.envelope === 'object') ? result.envelope : {};
+        const to = env.to ?? env.group_id ?? '';
+        // 过滤：若对端本身是 owner，不转发给该 owner（避免"回复你"转给你自己）；
+        // 但仍转发给其他 owner。
+        const recipientOwners = owners.filter(o => o !== to);
+        if (recipientOwners.length === 0)
+            return;
+        this.emitForward('outbound', result, recipientOwners);
+    }
+    /**
+     * 实际投递 observer.forward 给每个 owner，外层一律明文。
+     * original 为 SDK 给到的原始对象（入站回调 data / 出站 SendResult），整体透传，
+     * 不挑字段、不改字段——SDK 加任何字段都会自动一并转发给 owner。
+     */
+    emitForward(direction, original, owners) {
         const forwardPayload = {
             type: 'observer.forward',
             direction,
             agent_aid: this.config.aid,
-            original: {
-                from: original.from,
-                to: original.to,
-                ...(original.seq != null ? { seq: original.seq } : {}),
-                timestamp: Date.now(),
-                payload: original.payload,
-            },
+            original,
         };
         for (const ownerAid of owners) {
-            const encrypt = this.shouldEncrypt(ownerAid);
-            this.callAndTrace('message.send', { to: ownerAid, payload: forwardPayload, encrypt })
+            this.callAndTrace('message.send', { to: ownerAid, payload: forwardPayload, encrypt: false })
                 .catch(e => logger.debug(`${this.logPrefix()} observer.forward to ${ownerAid} failed: ${e}`));
         }
     }
+    // ── 观察者插话（Observer Insert，v0.3 待用上下文提示） ──────────────
+    //
+    // owner 经 message.send 给 agent 自身 AID 发 observer.inject（payload 为对象）。
+    // 鉴权 from∈owners 后，把提示【只落盘】到 agent↔对端 会话的 pending-hints.jsonl
+    // （不 dispatch、不跑 LLM、不回 owner）；下一条对端消息到达时由 message-processor
+    // 回放消费、注入渲染层。action=add 加提示 / remove 撤销。
+    // 详见 docs/observer-insert-design.md 第一部分。
+    /** 回 observer.inject.ack 给 owner（明文）。accepted 在成功写盘之后发出。 */
+    emitInjectAck(ownerAid, injectId, data, error) {
+        if (!this.connected || !this.client)
+            return;
+        const ackPayload = { type: 'observer.inject.ack' };
+        if (injectId)
+            ackPayload.id = injectId;
+        if (data)
+            ackPayload.data = data;
+        if (error)
+            ackPayload.error = error;
+        this.callAndTrace('message.send', { to: ownerAid, payload: ackPayload, encrypt: false })
+            .catch(e => logger.debug(`${this.logPrefix()} observer.inject.ack to ${ownerAid} failed: ${e}`));
+    }
+    /** 处理 observer.inject：鉴权 + 校验 + 只落盘到 pending-hints（不触发处理、不回 owner）。 */
+    handleObserverInject(fromAid, payload, displayName, peerType) {
+        void peerType;
+        const { owners } = this.getObserverConfig();
+        const ts = Date.now();
+        const req = parseInjectRequest(payload, fromAid, owners, ts);
+        if (req.kind === 'reject') {
+            logger.warn(`${this.logPrefix()} observer.inject rejected: ${this.getShortAid(fromAid)} ${req.code}`);
+            this.emitInjectAck(fromAid, req.injectId, { status: 'rejected', action: req.action }, { code: req.code, message: req.message });
+            return;
+        }
+        const selfAID = this.config.aid;
+        const sessionsDir = resolvePaths().sessionsDir;
+        let ok;
+        if (req.kind === 'remove') {
+            ok = appendHintRemove(sessionsDir, 'aun', req.channelId, selfAID, { targetId: req.targetId, threadId: req.threadId, ts });
+        }
+        else {
+            ok = appendHintAdd(sessionsDir, 'aun', req.channelId, selfAID, { id: req.id, text: req.text, threadId: req.threadId, ownerAid: req.ownerAid, ts });
+        }
+        if (!ok) {
+            this.emitInjectAck(fromAid, req.injectId, { status: 'rejected', action: req.kind }, { code: 'STORE_FAILED', message: '提示落盘失败' });
+            return;
+        }
+        logger.info(`${this.logPrefix()} observer.inject ${req.kind} stored: from=${this.getShortAid(fromAid)}(${displayName}) target=${req.channelId} chatType=${req.chatType} thread=${req.threadId ?? 'main'}${req.kind === 'add' ? ` textLen=${req.text.length}` : `${req.targetId ? ` targetId=${req.targetId}` : ' (clear-all)'}`}`);
+        this.emitInjectAck(fromAid, req.injectId, { status: 'accepted', action: req.kind });
+        // 记录到 watch（被观察的 agent↔对端 会话），带 owner-inject 标记区分对端真实消息。
+        // v0.3：只记"提示已添加/已撤销"，不触发处理、不产生 agent→owner 回应。
+        const watchText = req.kind === 'remove' ? `[撤销提示]${req.targetId ? ` id=${req.targetId}` : '（全部）'}` : req.text;
+        const synthId = `inject-${req.injectId || ts}`;
+        this.recordInjectWatch('in', fromAid, req.channelId, req.chatType, synthId, watchText);
+    }
+    /**
+     * 把 observer 插话 / 对插话的回应记录到 watch（被观察的 agent↔对端 会话），
+     * 带 source='owner-inject' 标记，与对端真实消息区分。
+     * 写三处：messages.jsonl（watch msg）、appendAidEvent（watch aid 事件流）、aidStatsCollector（统计）。
+     * @param dir 'in'=owner→agent 插话；'out'=agent→owner 对插话的回应
+     * @param peerChannelId 被观察会话的对端（agent↔对端），日志落点 = sessions/aun/<self>/<peerChannelId>/
+     */
+    recordInjectWatch(dir, ownerAid, peerChannelId, chatType, msgId, text) {
+        try {
+            const selfAID = this.config.aid;
+            const isGroup = chatType === 'group';
+            const chatDir = chatDirPath(resolvePaths().sessionsDir, 'aun', peerChannelId, selfAID);
+            const entry = dir === 'in'
+                ? buildInboundEntry({
+                    from: ownerAid, to: selfAID, chatType,
+                    groupId: isGroup ? peerChannelId : null, msgId, content: text,
+                    permMode: 'owner', source: 'owner-inject',
+                })
+                : buildOutboundEntry({
+                    from: selfAID, to: ownerAid, chatType,
+                    groupId: isGroup ? peerChannelId : null, msgId, content: text,
+                    source: 'owner-inject',
+                });
+            appendMessageLog(chatDir, entry);
+        }
+        catch (e) {
+            logger.debug(`${this.logPrefix()} recordInjectWatch(msg) failed: ${e}`);
+        }
+        // watch aid：事件流 + 统计（标 inject，便于过滤）
+        try {
+            const len = Buffer.byteLength(text, 'utf-8');
+            if (dir === 'in') {
+                appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_in', aid: this.config.aid, from: ownerAid, msgId, kind: 'text', len, inject: true });
+                this.aidStatsCollector?.recordInbound(this.config.aid, ownerAid, len, text, false, false, 'inject');
+            }
+            else {
+                appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_out', aid: this.config.aid, to: ownerAid, msgId, kind: 'text', len, inject: true });
+                this.aidStatsCollector?.recordOutbound(this.config.aid, ownerAid, len, text, false, false, 'inject');
+            }
+        }
+        catch (e) {
+            logger.debug(`${this.logPrefix()} recordInjectWatch(aid) failed: ${e}`);
+        }
+    }
     handleEcho(event) {
         const ts = () => {
             const d = new Date();
@@ -1820,12 +2060,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_out', aid: this.config.aid, to: channelId, msgId: mid, kind: 'text', len: finalText.length, groupId: channelId });
                     this.aidStatsCollector?.recordOutbound(this.config.aid, channelId, Buffer.byteLength(finalText, 'utf-8'), finalText, false, encrypt, context?.metadata?.chatmode);
                     this.appendOutboundJsonl(channelId, finalText, mid, encrypt, context, true, 'text', source);
-                    // Observer forward: outbound (group)
-                    this.forwardToOwners('outbound', {
-                        from: this.config.aid,
-                        to: channelId,
-                        payload: { type: 'text', text: finalText },
-                    });
+                    // Observer forward: outbound (group) — 原样转发 SDK SendResult（含 envelope + payload）
+                    this.forwardOutbound(result);
                 }
             }
             else {
@@ -1839,12 +2075,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     appendAidEvent({ ts: Date.now(), iso: new Date().toISOString(), event: 'message_out', aid: this.config.aid, to: targetAid, msgId: result.message_id, kind: 'text', len: finalText.length });
                     this.aidStatsCollector?.recordOutbound(this.config.aid, targetAid, Buffer.byteLength(finalText, 'utf-8'), finalText, false, encrypt, context?.metadata?.chatmode);
                     this.appendOutboundJsonl(targetAid, finalText, result.message_id, encrypt, context, false, 'text', source);
-                    // Observer forward: outbound (private)
-                    this.forwardToOwners('outbound', {
-                        from: this.config.aid,
-                        to: targetAid,
-                        payload: { type: 'text', text: finalText },
-                    });
+                    // Observer forward: outbound (private) — 原样转发 SDK SendResult（含 envelope + payload）
+                    this.forwardOutbound(result);
                 }
             }
             return true;
@@ -1862,6 +2094,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                         if (!result || !result.message_id) {
                             logger.warn(`${this.logPrefix()} group.send fallback returned no message_id: ${JSON.stringify(result)}`);
                         }
+                        this.forwardOutbound(result);
                     }
                     else {
                         this.trace('OUT', 'message.send.fallback', params);
@@ -1870,6 +2103,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                         if (!result || !result.message_id) {
                             logger.warn(`${this.logPrefix()} message.send fallback returned no message_id: ${JSON.stringify(result)}`);
                         }
+                        this.forwardOutbound(result);
                     }
                     return true;
                 }
@@ -1965,6 +2199,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 const tid = putRes?.thought_id;
                 logger.info(`${this.logPrefix()} thought.put ok group=${targetId} task=${taskId} stage=${stage} encrypt=${encrypt} tid=${tid ?? '?'}`);
                 this.eventBus?.publish?.({ type: 'message:thought-put', agentName: this.config.aid, channelId, taskId, text: thoughtText });
+                this.forwardOutbound(putRes);
                 if (thoughtText) {
                     this.aidStatsCollector?.recordOutbound(this.config.aid, channelId, Buffer.byteLength(thoughtText, 'utf-8'), thoughtText, false, encrypt, context?.metadata?.chatmode ?? 'proactive');
                     this.appendOutboundJsonl(channelId, thoughtText, tid ?? `thought-${Date.now()}`, encrypt, context, true, 'thought', 'daemon');
@@ -1976,6 +2211,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 const tid = putRes?.thought_id;
                 logger.info(`${this.logPrefix()} thought.put ok p2p=${this.peerLabel(targetId)} task=${taskId} stage=${stage} encrypt=${encrypt} tid=${tid ?? '?'}`);
                 this.eventBus?.publish?.({ type: 'message:thought-put', agentName: this.config.aid, channelId, taskId, text: thoughtText });
+                this.forwardOutbound(putRes);
                 if (thoughtText) {
                     this.aidStatsCollector?.recordOutbound(this.config.aid, targetId, Buffer.byteLength(thoughtText, 'utf-8'), thoughtText, false, encrypt, context?.metadata?.chatmode ?? 'proactive');
                     this.appendOutboundJsonl(channelId, thoughtText, tid ?? `thought-${Date.now()}`, encrypt, context, false, 'thought', 'daemon');
@@ -2012,12 +2248,14 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 const result = await this.callAndTrace('group.send', params);
                 const mid = result?.message?.message_id ?? result?.message_id ?? null;
                 logger.info(`${this.logPrefix()} group.send (${payload.type}) ok: group=${channelId} mid=${mid} encrypt=${encrypt}`);
+                this.forwardOutbound(result);
                 return mid;
             }
             else {
                 params.to = targetAid;
                 const result = await this.callAndTrace('message.send', params);
                 logger.info(`${this.logPrefix()} message.send (${payload.type}) ok: to=${this.peerLabel(targetAid)} mid=${result?.message_id} encrypt=${encrypt}`);
+                this.forwardOutbound(result);
                 return result?.message_id ?? null;
             }
         }
@@ -2134,11 +2372,13 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 ? !!(context.metadata.encrypted)
                 : this.shouldEncrypt(encryptTarget);
             const params = { payload: filePayload, encrypt };
+            let sendResult = null;
             try {
                 if (isGroup) {
                     params.group_id = channelId;
                     this.trace('OUT', 'group.send.file', params);
                     const result = await this.client.call('group.send', params);
+                    sendResult = result;
                     const fileMid = result?.message?.message_id ?? result?.message_id;
                     this.trace('OUT', 'group.send.file.ok', { message_id: fileMid });
                     if (!fileMid) {
@@ -2149,6 +2389,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     params.to = fileTargetAid;
                     this.trace('OUT', 'message.send.file', params);
                     const result = await this.client.call('message.send', params);
+                    sendResult = result;
                     this.trace('OUT', 'message.send.file.ok', { message_id: result?.message_id });
                     if (!result || !result.message_id) {
                         logger.warn(`${this.logPrefix()} message.send.file returned no message_id: ${JSON.stringify(result)}`);
@@ -2167,6 +2408,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     if (isGroup) {
                         this.trace('OUT', 'group.send.file.fallback', params);
                         const result = await this.client.call('group.send', params);
+                        sendResult = result;
                         const fbMid = result?.message?.message_id ?? result?.message_id;
                         this.trace('OUT', 'group.send.file.fallback.ok', { message_id: fbMid });
                         if (!fbMid) {
@@ -2176,6 +2418,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                     else {
                         this.trace('OUT', 'message.send.file.fallback', params);
                         const result = await this.client.call('message.send', params);
+                        sendResult = result;
                         this.trace('OUT', 'message.send.file.fallback.ok', { message_id: result?.message_id });
                         if (!result || !result.message_id) {
                             logger.warn(`${this.logPrefix()} message.send.file fallback returned no message_id: ${JSON.stringify(result)}`);
@@ -2187,6 +2430,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 }
             }
             logger.info(`${this.logPrefix()} File sent: ${filename} (${formatSize(stat.size)}) → ${channelId}`);
+            if (sendResult)
+                this.forwardOutbound(sendResult);
             return true;
         }
         catch (e) {
@@ -2276,7 +2521,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             const c = this.client;
             if (!c) {
                 logger.debug(`${this.logPrefix()} ${label} skipped: client gone`);
-                return Promise.resolve();
+                return Promise.resolve(null);
             }
             const encrypt = computeEncrypt();
             const params = { payload, encrypt };
@@ -2285,23 +2530,28 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             else
                 params.to = statusTargetAid;
             this.trace('OUT', `${method}.task_${label}`, params);
-            return c.call(method, params).catch(e => {
+            return c.call(method, params).catch((e) => {
                 if (encrypt && e instanceof E2EEError) {
                     this.peerE2ee.set(encryptTarget, { ok: false, ts: Date.now() });
                     logger.warn(`${this.logPrefix()} E2EE task_${label} send failed to ${channelId}, retrying plaintext`);
                     const c2 = this.client;
                     if (!c2)
-                        return;
+                        return null;
                     const fallbackParams = { ...params, encrypt: false };
-                    return c2.call(method, fallbackParams).catch(e2 => {
+                    return c2.call(method, fallbackParams).catch((e2) => {
                         logger.debug(`${this.logPrefix()} task_${label} fallback failed: ${e2}`);
+                        return null;
                     });
                 }
                 logger.debug(`${this.logPrefix()} task_${label} failed: ${e}`);
+                return null;
             });
         };
         const method = isGroup ? 'group.send' : 'message.send';
-        sendOne(method, statusPayload, 'status');
+        sendOne(method, statusPayload, 'status').then(result => {
+            if (result)
+                this.forwardOutbound(result);
+        }).catch(() => { });
         this.aidStatsCollector?.recordOutbound(this.config.aid, channelId, JSON.stringify(statusPayload).length, undefined, true);
         // 群聊显示 group id 简称，P2P 显示 peer label；从 context.metadata 读取 chatmode
         const targetLabel = this.isGroupId(channelId) ? channelId : this.peerLabel(channelId);
@@ -2499,267 +2749,230 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         const result = await agentmdSync(aid, { store: this.store ?? undefined });
         return result.content ?? '';
     }
+    /**
+     * 取群显示名（group.get → group.name），进程内缓存。
+     * 走长连接 callAndTrace，失败/未连接返回 undefined —— 绝不抛出阻塞消息处理。
+     */
+    async getGroupName(groupId) {
+        if (!groupId)
+            return undefined;
+        const cached = this.groupNameCache.get(groupId);
+        if (cached !== undefined)
+            return cached || undefined;
+        if (!this.client)
+            return undefined;
+        try {
+            const result = await this.callAndTrace('group.get', { group_id: groupId });
+            const name = result?.group?.name;
+            if (typeof name === 'string' && name) {
+                this.groupNameCache.set(groupId, name);
+                return name;
+            }
+            this.groupNameCache.set(groupId, ''); // 负缓存：避免反复 RPC（空串视为无名）
+            return undefined;
+        }
+        catch {
+            return undefined; // 不写缓存，下次仍可重试
+        }
+    }
 }
 // Plugin implementation
 export class AUNChannelPlugin {
     name = 'aun';
-    isEnabled(config) {
-        const raw = config.channels?.aun;
-        if (!raw)
-            return false;
-        if (Array.isArray(raw)) {
-            return raw.some(inst => inst.enabled !== false && !!inst.aid);
-        }
-        return raw.enabled !== false && !!raw.aid;
-    }
-    async createChannels(config) {
-        const instances = normalizeChannelInstances(config.channels?.aun, 'aun');
-        const result = [];
-        for (const inst of instances) {
-            if (inst.enabled === false || !inst.aid)
-                continue;
-            const channel = new AUNChannel({
-                aid: inst.aid,
-                keystorePath: inst.keystorePath,
-                gatewayUrl: inst.gatewayUrl,
-                accessToken: inst.accessToken,
-                flushDelay: inst.flushDelay,
-                owner: inst.owner,
-                agentName: inst.agentName,
-                channelName: inst.name,
-                aunTrace: config.debug?.aunTrace,
-                aunSdkLog: config.debug?.aunSdkLog,
-            });
-            const adapter = {
-                channelName: inst.name,
-                channelKey: inst.name, // channelName 实际上就是 channelKey
-                capabilities: { file: true, image: true, interaction: true, markdown: true, thought: true, status: true, thread: true },
-                send: async (envelope, payload) => {
-                    const ctx = envelope.replyContext;
-                    const channelId = envelope.channelId;
-                    switch (payload.kind) {
-                        case 'result.text':
-                        case 'command.result':
-                        case 'command.error':
-                        case 'system.notice':
-                        case 'system.error':
-                        case 'result.error': {
-                            const sendCtx = { ...(ctx ?? {}) };
-                            if (payload.kind === 'result.text' && payload.isFinal)
-                                sendCtx.title = '✅ 最终回复:';
-                            await channel.sendMessage(channelId, payload.text, sendCtx);
-                            return;
+    async createInstance(inst, ctx) {
+        // AUN aid is the agent's own AID; loader injects it as inst.aid, ctx.agentName is the source of truth.
+        const aid = inst.aid ?? ctx.agentName;
+        if (inst.enabled === false || !aid)
+            return null;
+        const channel = new AUNChannel({
+            aid,
+            keystorePath: inst.keystorePath,
+            gatewayUrl: inst.gatewayUrl,
+            accessToken: inst.accessToken,
+            flushDelay: inst.flushDelay,
+            owner: inst.owner ?? inst.owners?.[0],
+            agentName: ctx.agentName,
+            channelName: inst.name,
+            aunTrace: ctx.debug?.aunTrace,
+            aunSdkLog: ctx.debug?.aunSdkLog,
+        });
+        const mode = resolveShowActivities(inst);
+        const adapter = {
+            channelName: inst.name,
+            channelKey: inst.name, // channelName 实际上就是 channelKey
+            capabilities: { file: true, image: true, interaction: true, markdown: true, thought: true, status: true, thread: true },
+            send: async (envelope, payload) => {
+                const replyCtx = envelope.replyContext;
+                const channelId = envelope.channelId;
+                switch (payload.kind) {
+                    case 'result.text':
+                    case 'command.result':
+                    case 'command.error':
+                    case 'system.notice':
+                    case 'system.error':
+                    case 'result.error': {
+                        const sendCtx = { ...(replyCtx ?? {}) };
+                        if (payload.kind === 'result.text' && payload.isFinal)
+                            sendCtx.title = '✅ 最终回复:';
+                        await channel.sendMessage(channelId, payload.text, sendCtx);
+                        return;
+                    }
+                    case 'result.file':
+                        await channel.sendFile(channelId, payload.filePath, replyCtx);
+                        return;
+                    case 'result.image': {
+                        const buf = payload.data;
+                        const b64 = buf.toString('base64');
+                        await channel.sendStructured(channelId, {
+                            type: 'image', alt: payload.alt, data_base64: b64, mime_type: payload.mimeType,
+                        }, replyCtx);
+                        return;
+                    }
+                    case 'activity.batch': {
+                        const aunPayload = {
+                            type: 'thought',
+                            items: payload.items,
+                            client_context: { task_id: envelope.taskId, chatmode: envelope.chatmode, agent_name: envelope.agentName },
+                        };
+                        if (replyCtx?.threadId)
+                            aunPayload.thread_id = replyCtx.threadId;
+                        if (envelope.chatmode === 'proactive') {
+                            await channel.sendThought(channelId, envelope.taskId, aunPayload, replyCtx);
                         }
-                        case 'result.file':
-                            await channel.sendFile(channelId, payload.filePath, ctx);
-                            return;
-                        case 'result.image': {
-                            // AUN 支持 image，走 sendStructured 发 type=image payload
-                            const buf = payload.data;
-                            const b64 = buf.toString('base64');
-                            await channel.sendStructured(channelId, {
-                                type: 'image',
-                                alt: payload.alt,
-                                data_base64: b64,
-                                mime_type: payload.mimeType,
-                            }, ctx);
-                            return;
+                        else {
+                            await channel.sendStructured(channelId, aunPayload, replyCtx);
                         }
-                        case 'activity.batch': {
-                            const aunPayload = {
-                                type: 'thought',
-                                items: payload.items,
-                                client_context: { task_id: envelope.taskId, chatmode: envelope.chatmode, agent_name: envelope.agentName },
+                        return;
+                    }
+                    case 'status.progress':
+                        channel.sendProcessingStatus(channelId, 'progress', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'status.started':
+                        channel.sendProcessingStatus(channelId, 'start', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'status.queued':
+                        channel.sendProcessingStatus(channelId, 'queued', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'status.completed':
+                        channel.sendProcessingStatus(channelId, 'done', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'status.interrupted':
+                        channel.sendProcessingStatus(channelId, 'interrupted', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'status.error':
+                        channel.sendProcessingStatus(channelId, 'error', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'status.timeout':
+                        channel.sendProcessingStatus(channelId, 'timeout', envelope.sessionId ?? envelope.taskId, envelope.taskId, replyCtx, payload.metadata);
+                        return;
+                    case 'interaction': {
+                        const req = payload.interaction;
+                        if (req.kind.kind === 'action') {
+                            const action = req.kind;
+                            const aunCard = {
+                                type: 'action_card',
+                                title: action.title,
+                                actions: action.buttons.map(btn => ({
+                                    label: btn.label, value: btn.key, style: btn.style ?? 'default', behavior: 'reply',
+                                })),
                             };
-                            if (ctx?.threadId)
-                                aunPayload.thread_id = ctx.threadId;
-                            if (envelope.chatmode === 'proactive') {
-                                await channel.sendThought(channelId, envelope.taskId, aunPayload, ctx);
+                            if (action.body)
+                                aunCard.description = action.body;
+                            if (req.initiatorId && channel.isGroupId(channelId))
+                                aunCard.initiator = req.initiatorId;
+                            if (replyCtx?.threadId)
+                                aunCard.thread_id = replyCtx.threadId;
+                            const msgId = await channel.sendStructured(channelId, aunCard, replyCtx);
+                            if (msgId) {
+                                channel.cardMessageIdMap.set(msgId, { requestId: req.id, isCommandCard: false, initiatorAid: req.initiatorId });
+                                setTimeout(() => channel.cardMessageIdMap.delete(msgId), 20 * 60 * 1000);
                             }
-                            else {
-                                // interactive 模式不发 thought.put，只写入消息历史
-                                await channel.sendStructured(channelId, aunPayload, ctx);
-                            }
-                            return;
                         }
-                        case 'status.progress':
-                            channel.sendProcessingStatus(channelId, 'progress', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'status.started':
-                            channel.sendProcessingStatus(channelId, 'start', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'status.queued':
-                            channel.sendProcessingStatus(channelId, 'queued', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'status.completed':
-                            channel.sendProcessingStatus(channelId, 'done', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'status.interrupted':
-                            channel.sendProcessingStatus(channelId, 'interrupted', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'status.error':
-                            channel.sendProcessingStatus(channelId, 'error', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'status.timeout':
-                            channel.sendProcessingStatus(channelId, 'timeout', envelope.sessionId ?? envelope.taskId, envelope.taskId, ctx, payload.metadata);
-                            return;
-                        case 'interaction': {
-                            const req = payload.interaction;
-                            if (req.kind.kind === 'action') {
-                                const action = req.kind;
-                                const aunCard = {
-                                    type: 'action_card',
-                                    title: action.title,
-                                    actions: action.buttons.map(btn => ({
-                                        label: btn.label,
-                                        value: btn.key,
-                                        style: btn.style ?? 'default',
-                                        behavior: 'reply',
-                                    })),
-                                };
-                                if (action.body)
-                                    aunCard.description = action.body;
-                                if (ctx?.threadId)
-                                    aunCard.thread_id = ctx.threadId;
-                                const msgId = await channel.sendStructured(channelId, aunCard, ctx);
-                                if (msgId) {
-                                    channel.cardMessageIdMap.set(msgId, { requestId: req.id, isCommandCard: false });
-                                    setTimeout(() => channel.cardMessageIdMap.delete(msgId), 20 * 60 * 1000);
-                                }
-                            }
-                            else if (req.kind.kind === 'command-card') {
-                                const card = req.kind;
-                                const aunCard = {
-                                    type: 'action_card',
-                                    title: card.title,
-                                    actions: card.buttons.map(btn => ({
-                                        label: btn.label,
-                                        value: btn.command,
-                                        style: btn.style ?? 'default',
-                                        behavior: 'reply',
-                                    })),
-                                };
-                                if (card.body)
-                                    aunCard.description = card.body;
-                                if (ctx?.threadId)
-                                    aunCard.thread_id = ctx.threadId;
-                                const msgId = await channel.sendStructured(channelId, aunCard, ctx);
-                                if (msgId) {
-                                    channel.cardMessageIdMap.set(msgId, { requestId: req.id, isCommandCard: true, initiatorAid: req.initiatorId });
-                                    setTimeout(() => channel.cardMessageIdMap.delete(msgId), 20 * 60 * 1000);
-                                }
-                            }
-                            else if (payload.fallbackText) {
-                                await channel.sendMessage(channelId, payload.fallbackText, ctx);
+                        else if (req.kind.kind === 'command-card') {
+                            const card = req.kind;
+                            const aunCard = {
+                                type: 'action_card',
+                                title: card.title,
+                                actions: card.buttons.map(btn => ({
+                                    label: btn.label, value: btn.command, style: btn.style ?? 'default', behavior: 'reply',
+                                })),
+                            };
+                            if (card.body)
+                                aunCard.description = card.body;
+                            if (replyCtx?.threadId)
+                                aunCard.thread_id = replyCtx.threadId;
+                            const msgId = await channel.sendStructured(channelId, aunCard, replyCtx);
+                            if (msgId) {
+                                channel.cardMessageIdMap.set(msgId, { requestId: req.id, isCommandCard: true, initiatorAid: req.initiatorId });
+                                setTimeout(() => channel.cardMessageIdMap.delete(msgId), 20 * 60 * 1000);
                             }
-                            return;
                         }
-                        case 'custom': {
-                            const text = typeof payload.payload === 'string' ? payload.payload : JSON.stringify(payload.payload);
-                            channel.sendCustomPayload(channelId, text);
-                            return;
+                        else if (payload.fallbackText) {
+                            await channel.sendMessage(channelId, payload.fallbackText, replyCtx);
                         }
-                        default:
-                            logger.warn(`[AUN] Unhandled payload kind: ${payload.kind}`);
+                        return;
                     }
-                }, acknowledge: (messageId) => { channel.acknowledge(messageId); return Promise.resolve(); }, onInteraction: (cb) => { channel.interactionCallback = cb; }, uploadAgentMd: (content) => channel.uploadAgentMd(content),
-                downloadAgentMd: (aid) => channel.downloadAgentMd(aid), _selfAid: () => channel.getStatus().aid,
-                _selfName: () => channel.getSelfName(),
-            };
-            const policy = {
-                canSwitchProject: (chatType, identity) => identity === 'owner' || identity === 'admin',
-                canListProjects: (chatType, identity) => identity === 'owner' || identity === 'admin',
-                canCreateSession: (chatType, identity) => true,
-                canDeleteSession: (chatType, identity) => true,
-                canImportCliSession: (chatType, identity) => identity === 'owner' || identity === 'admin',
-                messagePrefix: (chatType, peerName) => (chatType === 'group' && peerName) ? `[${peerName}] ` : '',
-                showMiddleResult: (chatType, identity) => {
-                    const mode = getChannelShowActivities(config, inst.name);
-                    if (mode === 'none')
-                        return false;
-                    if (mode === 'dm-only')
-                        return chatType === 'private';
-                    if (mode === 'owner-dm-only')
-                        return chatType === 'private' && identity === 'owner';
-                    return true;
-                },
-                showIdleMonitor: (chatType, identity) => {
-                    const mode = getChannelShowActivities(config, inst.name);
-                    if (mode === 'none')
-                        return false;
-                    if (mode === 'dm-only')
-                        return chatType === 'private';
-                    if (mode === 'owner-dm-only')
-                        return chatType === 'private' && identity === 'owner';
-                    return true;
-                },
-                accumulateErrors: (chatType, identity) => true,
-            };
-            const options = {
-                flushDelay: inst.flushDelay ?? 3,
-                fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g,
-            };
-            result.push({
-                channelType: 'aun',
-                adapter,
-                channel,
-                policy,
-                options,
-                connect: () => channel.connect(),
-                disconnect: () => channel.disconnect(),
-                onProjectPathRequest: (channelId) => Promise.resolve(config.projects?.defaultPath || process.cwd()),
-                registerBridge(bridge, channelType) {
-                    bridge.register(adapter.channelName, (handler) => channel.onMessage(async (opts) => {
-                        handler({
-                            channel: adapter.channelName,
-                            channelType,
-                            channelId: opts.channelId,
-                            selfAID: opts.selfAID,
-                            groupId: opts.groupId,
-                            content: opts.content,
-                            chatType: opts.chatType || 'private',
-                            peerId: opts.peerId || '',
-                            peerName: opts.peerName,
-                            peerType: opts.peerType,
-                            messageId: opts.messageId,
-                            mentions: opts.mentions,
-                            threadId: opts.threadId,
-                            replyContext: opts.replyContext,
-                            source: opts.source,
-                            images: opts.images,
-                        });
-                    }), (channelId, text, replyContext) => channel.sendMessage(channelId, text, replyContext), adapter, channelType);
-                },
-                registerHooks(ctx) {
-                    channel.setEventBus(ctx.eventBus);
-                    if (channel.setOnChannelDown) {
-                        channel.setOnChannelDown(() => {
-                            ctx.eventBus.publish({
-                                type: 'channel:error',
-                                channel: 'aun',
-                                channelName: adapter.channelName,
-                                status: 'auth_error',
-                                message: `⚠️ AUN 渠道 ${adapter.channelName} 断连，自动重试已用尽。\n使用 /check rty aun 手动重连`,
-                                timestamp: Date.now(),
-                            });
-                        });
+                    case 'custom': {
+                        const text = typeof payload.payload === 'string' ? payload.payload : JSON.stringify(payload.payload);
+                        channel.sendCustomPayload(channelId, text);
+                        return;
                     }
-                    if (typeof channel.setDispatchModeResolver === 'function') {
-                        channel.setDispatchModeResolver(async (channelId) => {
-                            const session = await ctx.sessionManager.getActiveSession(adapter.channelName, channelId);
-                            return session?.metadata?.dispatchMode;
+                    default:
+                        logger.warn(`[AUN] Unhandled payload kind: ${payload.kind}`);
+                }
+            },
+            acknowledge: (messageId) => { channel.acknowledge(messageId); return Promise.resolve(); },
+            onInteraction: (cb) => { channel.interactionCallback = cb; },
+            uploadAgentMd: (content) => channel.uploadAgentMd(content),
+            downloadAgentMd: (aid) => channel.downloadAgentMd(aid),
+            getGroupName: (groupId) => channel.getGroupName(groupId),
+            _selfAid: () => channel.getStatus().aid,
+            _selfName: () => channel.getSelfName(),
+        };
+        const policy = {
+            canSwitchProject: (_, identity) => identity === 'owner' || identity === 'admin',
+            canListProjects: (_, identity) => identity === 'owner' || identity === 'admin',
+            canCreateSession: () => true,
+            canDeleteSession: () => true,
+            canImportCliSession: (_, identity) => identity === 'owner' || identity === 'admin',
+            messagePrefix: (chatType, peerName) => (chatType === 'group' && peerName) ? `[${peerName}] ` : '',
+            showMiddleResult: (chatType, identity) => showActivitiesPolicy(mode, chatType, identity),
+            showIdleMonitor: (chatType, identity) => showActivitiesPolicy(mode, chatType, identity),
+            accumulateErrors: () => true,
+        };
+        return {
+            channelType: 'aun', adapter, channel,
+            policy,
+            options: { flushDelay: inst.flushDelay ?? 3, fileMarkerPattern: /\[SEND_FILE:(?:(\w+):)?([^\]]+)\]/g },
+            connect: () => channel.connect(),
+            disconnect: () => channel.disconnect(),
+            onProjectPathRequest: () => Promise.resolve(ctx.defaultProjectPath),
+            registerBridge(bridge, channelType) {
+                bridge.register(adapter.channelName, (handler) => channel.onMessage(async (opts) => {
+                    handler(aunOptsToInbound(opts, adapter.channelName, channelType));
+                }), (channelId, text, replyContext) => channel.sendMessage(channelId, text, replyContext), adapter, channelType);
+            },
+            registerHooks(hookCtx) {
+                channel.setEventBus(hookCtx.eventBus);
+                if (channel.setOnChannelDown) {
+                    channel.setOnChannelDown(() => {
+                        hookCtx.eventBus.publish({
+                            type: 'channel:error',
+                            channel: 'aun',
+                            channelName: adapter.channelName,
+                            status: 'auth_error',
+                            message: `⚠️ AUN 渠道 ${adapter.channelName} 断连，自动重试已用尽。\n使用 /check rty aun 手动重连`,
+                            timestamp: Date.now(),
                         });
-                    }
-                },
-            });
-        }
-        return result;
-    }
-    async createChannel(config) {
-        const instances = await this.createChannels(config);
-        if (instances.length === 0) {
-            throw new Error('AUN config missing (aid required, e.g. "mybot.agentid.pub")');
-        }
-        return instances[0];
+                    });
+                }
+                if (typeof channel.setDispatchModeResolver === 'function') {
+                    channel.setDispatchModeResolver(async (channelId) => {
+                        const session = await hookCtx.sessionManager.getActiveSession(adapter.channelName, channelId);
+                        return session?.metadata?.dispatchMode;
+                    });
+                }
+            },
+        };
     }
 }