@agentunion/fastaun-browser 0.5.14 → 0.5.16

package/dist/logger.js

@@ -14,6 +14,24 @@
  *   占位符仅支持 %s（按 args 顺序替换，多余的 args 拼到末尾）
  * - error error level supports Error as last param: logger.error('msg', err)
  */
+import { normalizeGroupAid } from './group-id.js';
+export function trafficLogContext(direction, data) {
+    const params = data && typeof data === 'object' && !Array.isArray(data) ? data : {};
+    const target = params.target && typeof params.target === 'object' ? params.target : {};
+    const notify = params._notify && typeof params._notify === 'object' ? params._notify : {};
+    const text = (value) => typeof value === 'string' ? value.trim() : '';
+    const group = text(params.group_aid) || text(params.group_id) || text(target.group_aid) || text(target.group_id);
+    const groupAid = normalizeGroupAid(group);
+    const peerAid = group
+        ? (groupAid.includes('.') && !groupAid.includes('/') ? groupAid : '')
+        : direction === 'outbound'
+            ? text(target.aid) || text(params.to) || text(params.to_aid) || text(params.peer_aid)
+            : text(notify.from_aid) || text(params.from_aid) || text(params.sender_aid) || text(params.from);
+    return { direction, peerAid };
+}
+export function withLogContext(logger, context) {
+    return logger.withContext?.(context) ?? logger;
+}
 const LEVEL_ORDER = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
 function formatMessage(template, args) {
     if (args.length === 0)
@@ -51,13 +69,15 @@ export class AUNLogger {
         this._aunPath = String(opts.aunPath || '-');
         this._minLevel = this._debug ? LEVEL_ORDER.DEBUG : LEVEL_ORDER.INFO;
     }
-    for(module) {
+    for(module, context) {
+        const snapshot = context ? { ...context, aid: context.aid ?? this._aid ?? '' } : undefined;
         return {
-            error: (msg, ...args) => this._emit('ERROR', module, msg, args),
-            warn: (msg, ...args) => this._emit('WARN', module, msg, args),
-            info: (msg, ...args) => this._emit('INFO', module, msg, args),
-            debug: (msg, ...args) => this._emit('DEBUG', module, msg, args),
+            error: (msg, ...args) => this._emit('ERROR', module, msg, args, snapshot),
+            warn: (msg, ...args) => this._emit('WARN', module, msg, args, snapshot),
+            info: (msg, ...args) => this._emit('INFO', module, msg, args, snapshot),
+            debug: (msg, ...args) => this._emit('DEBUG', module, msg, args, snapshot),
             isDebugEnabled: () => this.isDebugEnabled(),
+            withContext: (next) => this.for(module, { ...next, aid: next.aid ?? snapshot?.aid }),
         };
     }
     isDebugEnabled() {
@@ -72,14 +92,16 @@ export class AUNLogger {
     close() {
         // 浏览器环境无文件清理，no-op
     }
-    _emit(level, module, msg, args) {
+    _emit(level, module, msg, args, context) {
         if (LEVEL_ORDER[level] < this._minLevel)
             return;
         if (level === 'DEBUG' && !this._debug)
             return;
         const { date, time, ms } = this._now();
         const head = `[${date} ${time}.${ms}][${level}][${module}][aun_path=${this._aunPath || '-'}][device_id=${this._deviceId || '-'}]`;
-        const aidPart = this._aid ? ` [${this._aid}]` : '';
+        const aidPart = context
+            ? ` [${context.aid || '-'} ${context.direction === 'outbound' ? '->' : '<-'} ${context.peerAid || '-'}]`
+            : this._aid ? ` [${this._aid}]` : '';
         const formatted = formatMessage(msg, args);
         const line = `${head}${aidPart} ${formatted}`;
         // 取最后一个 Error 实例附加到控制台输出，便于浏览器展开 stack

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/result.d.ts

@@ -2,7 +2,6 @@
 export interface ErrorInfo {
     code: string;
     message: string;
-    cause?: unknown;
 }
 /** 统一结果类型：成功时 ok=true + data，失败时 ok=false + error */
 export type Result<T> = {
@@ -15,5 +14,5 @@ export type Result<T> = {
 /** 构造成功结果 */
 export declare function resultOk<T>(data: T): Result<T>;
 /** 构造失败结果 */
-export declare function resultErr(code: string, message: string, cause?: unknown): Result<never>;
+export declare function resultErr(code: string, message: string, _cause?: unknown): Result<never>;
 //# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAEA,WAAW;AACX,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpC,aAAa;AACb,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAE9C;AAED,aAAa;AACb,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAEvF"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAEA,WAAW;AACX,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpC,aAAa;AACb,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAE9C;AAED,aAAa;AACb,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAExF"}

package/dist/result.js

@@ -4,7 +4,7 @@ export function resultOk(data) {
     return { ok: true, data };
 }
 /** 构造失败结果 */
-export function resultErr(code, message, cause) {
-    return { ok: false, error: { code, message, ...(cause !== undefined ? { cause } : {}) } };
+export function resultErr(code, message, _cause) {
+    return { ok: false, error: { code, message } };
 }
 //# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAcrD,aAAa;AACb,MAAM,UAAU,QAAQ,CAAI,IAAO;IACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,aAAa;AACb,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,KAAe;IACtE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAarD,aAAa;AACb,MAAM,UAAU,QAAQ,CAAI,IAAO;IACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,aAAa;AACb,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,MAAgB;IACvE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AACjD,CAAC"}

package/dist/transport.d.ts

@@ -1,5 +1,5 @@
 import { EventDispatcher } from './events.js';
-import type { ModuleLogger } from './logger.js';
+import { type ModuleLogger } from './logger.js';
 import { type JsonObject, type RpcMessage, type RpcParams, type RpcResult } from './types.js';
 export declare function createTransportWebSocket(url: string): WebSocket;
 /**
@@ -17,6 +17,7 @@ export declare class RPCTransport {
     private _timeout;
     private _connectTimeout;
     private _onDisconnect;
+    private _onDisconnectIsProtocol;
     private _ws;
     private _closed;
     private _lastCloseCode;
@@ -32,6 +33,7 @@ export declare class RPCTransport {
     private _drainingRpcQueue;
     private _sendChain;
     private _metaObserver;
+    private _metaObserverIsProtocol;
     private _traceMode;
     private _traceObserver;
     private _actorTail;
@@ -41,6 +43,7 @@ export declare class RPCTransport {
         timeout?: number;
         onDisconnect?: ((error: Error | null, closeCode?: number) => Promise<void>) | null;
     });
+    setProtocolDisconnectCallback(callback: ((error: Error | null, closeCode?: number) => Promise<void>) | null): void;
     /** 设置默认超时（秒） */
     setTimeout(timeout: number): void;
     /** 设置 WebSocket 建连及 challenge 超时（秒）。 */
@@ -54,6 +57,7 @@ export declare class RPCTransport {
      * 不影响 RPC result 返回。
      */
     setMetaObserver(observer: ((meta: JsonObject) => void | Promise<void>) | null): void;
+    setProtocolMetaObserver(observer: ((meta: JsonObject) => void | Promise<void>) | null): void;
     private _notifyMetaObserver;
     /** 设置 trace 模式：off / log / diag */
     setTraceMode(mode: string): void;

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/transport.js

@@ -1,4 +1,5 @@
 // ── RPC Transport（浏览器原生 WebSocket）──────────────────
+import { trafficLogContext, withLogContext } from './logger.js';
 import { ConnectionError, SerializationError, TimeoutError, ValidationError, mapRemoteError, } from './errors.js';
 import { isJsonObject } from './types.js';
 const MAX_WS_PAYLOAD_SIZE = 1_000_000;
@@ -544,6 +545,7 @@ export class RPCTransport {
     _timeout;
     _connectTimeout;
     _onDisconnect;
+    _onDisconnectIsProtocol = false;
     _ws = null;
     _closed = true;
     _lastCloseCode = null;
@@ -561,6 +563,7 @@ export class RPCTransport {
     // Gateway 在 RPC envelope 注入 _meta 字段（与 result 同级），由 client 层 observer 接收。
     // 注入失败 / 字段缺失时 observer 不会被调用，不影响业务路径。
     _metaObserver = null;
+    _metaObserverIsProtocol = false;
     // Trace 模式：off / log / diag
     _traceMode = 'off';
     // Trace observer：observer(traceInfo) 在每次 RPC/事件携带 _trace 时调用
@@ -571,10 +574,14 @@ export class RPCTransport {
     _actorBusy = false;
     constructor(opts) {
         this._dispatcher = opts.eventDispatcher;
-        this._timeout = opts.timeout ?? 10;
+        this._timeout = opts.timeout ?? 35;
         this._connectTimeout = opts.timeout ?? 10;
         this._onDisconnect = opts.onDisconnect ?? null;
     }
+    setProtocolDisconnectCallback(callback) {
+        this._onDisconnect = callback;
+        this._onDisconnectIsProtocol = true;
+    }
     /** 设置默认超时（秒） */
     setTimeout(timeout) {
         this._timeout = timeout;
@@ -595,6 +602,11 @@ export class RPCTransport {
      */
     setMetaObserver(observer) {
         this._metaObserver = observer;
+        this._metaObserverIsProtocol = false;
+    }
+    setProtocolMetaObserver(observer) {
+        this._metaObserver = observer;
+        this._metaObserverIsProtocol = true;
     }
     _notifyMetaObserver(message) {
         const observer = this._metaObserver;
@@ -603,14 +615,18 @@ export class RPCTransport {
         const meta = message._meta;
         if (!isJsonObject(meta))
             return;
-        this._dispatcher.enqueueTask(async () => {
+        const task = async () => {
             try {
                 await observer(meta);
             }
             catch (exc) {
                 this._log.debug(`meta_observer raised: ${String(exc)}`);
             }
-        });
+        };
+        if (this._metaObserverIsProtocol)
+            this._dispatcher.enqueueProtocolTask(task);
+        else
+            this._dispatcher.enqueueTask(task);
     }
     /** 设置 trace 模式：off / log / diag */
     setTraceMode(mode) {
@@ -902,6 +918,9 @@ export class RPCTransport {
         const localParams = sendParams;
         const backgroundRpc = background || localParams._rpc_background === true;
         delete localParams._rpc_background;
+        const requestContext = trafficLogContext('outbound', sendParams);
+        const requestLog = withLogContext(this._log, requestContext);
+        const responseLog = withLogContext(requestLog, { direction: 'inbound', peerAid: requestContext.peerAid });
         if (effectiveTraceMode !== 'off') {
             // 浏览器环境使用 crypto.randomUUID 或 Math.random 生成 trace_id
             traceId = typeof crypto !== 'undefined' && crypto.randomUUID
@@ -912,7 +931,7 @@ export class RPCTransport {
                 tracePayload.spans = [{ node: 'sdk', ts: tStart, action: 'send' }];
             }
             localParams._trace = tracePayload;
-            this._log.info(`[trace=${traceId}] rpc_send method=${method} rpc_id=${rpcId}`);
+            requestLog.info(`[trace=${traceId}] rpc_send method=${method} rpc_id=${rpcId}`);
         }
         const payload = JSON.stringify({
             jsonrpc: '2.0',
@@ -928,7 +947,7 @@ export class RPCTransport {
         const promise = new Promise((resolve, reject) => {
             const timer = globalThis.setTimeout(() => {
                 this._removeRpc(rpcId, pending);
-                this._log.warn(`RPC timeout: method=${method}, id=${rpcId}, elapsed=${Date.now() - tStart}ms, timeout=${effectiveTimeout}ms`);
+                requestLog.warn(`RPC timeout: method=${method}, id=${rpcId}, elapsed=${Date.now() - tStart}ms, timeout=${effectiveTimeout}ms`);
                 reject(new TimeoutError(`rpc timeout: ${method}`, { retryable: true }));
                 this._drainRpcQueue();
             }, effectiveTimeout);
@@ -937,31 +956,31 @@ export class RPCTransport {
                     clearTimeout(timer);
                     const elapsed = Date.now() - tStart;
                     if (response.error !== undefined) {
-                        this._log.debug(`RPC error response: method=${method}, id=${rpcId}, elapsed=${elapsed}ms, error=${JSON.stringify(response.error)}`);
+                        responseLog.debug(`RPC error response: method=${method}, id=${rpcId}, elapsed=${elapsed}ms, error=${JSON.stringify(response.error)}`);
                         if (traceId) {
-                            this._log.info(`[trace=${traceId}] rpc_recv method=${method} rpc_id=${rpcId} duration_ms=${elapsed} status=error`);
+                            responseLog.info(`[trace=${traceId}] rpc_recv method=${method} rpc_id=${rpcId} duration_ms=${elapsed} status=error`);
                         }
                         const respTrace = response._trace;
                         if (respTrace && typeof respTrace === 'object' && !Array.isArray(respTrace)) {
-                            this._handleResponseTrace(method, 'error', elapsed, respTrace);
+                            this._handleResponseTrace(method, 'error', elapsed, respTrace, responseLog);
                         }
                         reject(mapRemoteError(response.error));
                     }
                     else if (response.result !== undefined) {
-                        this._log.debug(`RPC response ok: method=${method}, id=${rpcId}, elapsed=${elapsed}ms ${summarizeDict(response.result, DIAG_RESULT_FIELDS)}`);
+                        responseLog.debug(`RPC response ok: method=${method}, id=${rpcId}, elapsed=${elapsed}ms ${summarizeDict(response.result, DIAG_RESULT_FIELDS)}`);
                         if (traceId) {
-                            this._log.info(`[trace=${traceId}] rpc_recv method=${method} rpc_id=${rpcId} duration_ms=${elapsed} status=ok`);
+                            responseLog.info(`[trace=${traceId}] rpc_recv method=${method} rpc_id=${rpcId} duration_ms=${elapsed} status=ok`);
                         }
                         this._notifyMetaObserver(response);
                         // 处理 success 路径的 _trace
                         const respTrace = response._trace;
                         if (respTrace && typeof respTrace === 'object' && !Array.isArray(respTrace)) {
-                            this._handleResponseTrace(method, 'ok', elapsed, respTrace);
+                            this._handleResponseTrace(method, 'ok', elapsed, respTrace, responseLog);
                         }
                         resolve(response.result);
                     }
                     else {
-                        this._log.warn(`RPC response missing result or error: method=${method}, id=${rpcId}, elapsed=${elapsed}ms`);
+                        responseLog.warn(`RPC response missing result or error: method=${method}, id=${rpcId}, elapsed=${elapsed}ms`);
                         reject(new SerializationError(`rpc response missing result and error: ${method}`));
                     }
                 },
@@ -979,12 +998,12 @@ export class RPCTransport {
             // 入队并触发 drain
             if (backgroundRpc) {
                 this._backgroundRpcQueue.push({
-                    rpcId, method, payload, pending, tStart, timeoutMs: effectiveTimeout, background: true,
+                    rpcId, method, payload, pending, tStart, timeoutMs: effectiveTimeout, background: true, logger: requestLog,
                 });
             }
             else {
                 this._rpcQueue.push({
-                    rpcId, method, payload, pending, tStart, timeoutMs: effectiveTimeout, background: false,
+                    rpcId, method, payload, pending, tStart, timeoutMs: effectiveTimeout, background: false, logger: requestLog,
                 });
             }
             this._drainRpcQueue();
@@ -1015,8 +1034,9 @@ export class RPCTransport {
         if (payloadSize > MAX_WS_PAYLOAD_SIZE) {
             throw new ValidationError('payload is too large');
         }
+        const notifyLog = withLogContext(this._log, trafficLogContext('outbound', params ?? {}));
         await this._sendText(payload, `notification ${normalizedMethod}`);
-        this._log.debug(`notification sent: method=${normalizedMethod}, size=${payloadSize}`);
+        notifyLog.debug(`notification sent: method=${normalizedMethod}, size=${payloadSize}`);
     }
     _enqueueSend(task) {
         const run = this._sendChain.then(() => Promise.resolve(task()), () => Promise.resolve(task()));
@@ -1182,7 +1202,7 @@ export class RPCTransport {
                 const elapsed = Date.now() - entry.tStart;
                 if (elapsed >= entry.timeoutMs) {
                     clearTimeout(entry.pending.timer);
-                    this._log.warn(`RPC queue timeout: method=${entry.method}, id=${entry.rpcId}, elapsed=${elapsed}ms, timeout=${entry.timeoutMs}ms`);
+                    entry.logger.warn(`RPC queue timeout: method=${entry.method}, id=${entry.rpcId}, elapsed=${elapsed}ms, timeout=${entry.timeoutMs}ms`);
                     entry.pending.reject(new TimeoutError(`rpc timeout before send: ${entry.method}`, { retryable: true }));
                     continue;
                 }
@@ -1191,12 +1211,12 @@ export class RPCTransport {
                     this._pendingBackground.add(entry.rpcId);
                 }
                 this._sendText(entry.payload, `rpc ${entry.method}`, () => this._pending.get(entry.rpcId) === entry.pending).then(() => {
-                    this._log.debug(`RPC request sent: method=${entry.method}, id=${entry.rpcId}, background=${entry.background}`);
+                    entry.logger.debug(`RPC request sent: method=${entry.method}, id=${entry.rpcId}, background=${entry.background}`);
                 }).catch((err) => {
                     if (this._pending.get(entry.rpcId) !== entry.pending)
                         return;
                     this._removeRpc(entry.rpcId, entry.pending);
-                    this._log.error(`RPC send failed: method=${entry.method}, id=${entry.rpcId}, error=${String(err)}`, err instanceof Error ? err : undefined);
+                    entry.logger.error(`RPC send failed: method=${entry.method}, id=${entry.rpcId}, error=${String(err)}`, err instanceof Error ? err : undefined);
                     entry.pending.reject(err instanceof ConnectionError
                         ? err
                         : new ConnectionError(`failed to send rpc ${entry.method}: ${err instanceof Error ? err.message : String(err)}`));
@@ -1209,7 +1229,7 @@ export class RPCTransport {
         }
     }
     /** 处理 RPC 响应中的 _trace 字段：追加 sdk.recv span，格式化输出，通知 observer */
-    _handleResponseTrace(method, status, elapsedMs, respTrace) {
+    _handleResponseTrace(method, status, elapsedMs, respTrace, logger = this._log) {
         try {
             const sdkRecvSpan = {
                 node: 'sdk',
@@ -1220,7 +1240,7 @@ export class RPCTransport {
             const existingSpans = Array.isArray(respTrace.spans) ? respTrace.spans : [];
             const spans = [...existingSpans, sdkRecvSpan];
             const enriched = { ...respTrace, spans };
-            this._log.info(traceDisplay(method, status, elapsedMs, respTrace, spans));
+            logger.info(traceDisplay(method, status, elapsedMs, respTrace, spans));
             if (this._traceObserver !== null) {
                 const observer = this._traceObserver;
                 this._dispatcher.enqueueTask(async () => {
@@ -1234,7 +1254,7 @@ export class RPCTransport {
             }
         }
         catch (err) {
-            this._log.debug(`trace handling raised: ${err instanceof Error ? err.message : String(err)}`);
+            logger.debug(`trace handling raised: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
     // ── 内部消息处理 ──────────────────────────────────
@@ -1278,16 +1298,20 @@ export class RPCTransport {
             const error = new ConnectionError(`websocket closed: code=${event.code} reason=${event.reason}`);
             if (this._onDisconnect) {
                 const onDisconnect = this._onDisconnect;
-                this._dispatcher.enqueueTask(async () => {
+                const task = async () => {
                     try {
                         await onDisconnect(error, event.code);
                     }
                     catch (exc) {
                         this._log.warn('[aun_core.transport] disconnect callback exception:', exc);
                     }
-                });
+                };
+                if (this._onDisconnectIsProtocol)
+                    this._dispatcher.enqueueProtocolTask(task);
+                else
+                    this._dispatcher.enqueueTask(task);
             }
-            this._dispatcher.enqueue('connection.error', { error });
+            this._dispatcher.enqueueProtocol('connection.error', { error });
         }
     }
     _notConnectedError() {
@@ -1310,7 +1334,7 @@ export class RPCTransport {
             }
             else {
                 // H23: 未知 id 多数是超时后到达的慢响应；打 warn 便于排查，避免被完全吞掉
-                this._log.warn('[aun_core.transport] recv unknown rpc response (maybe arrived after timeout): id=' + rpcId);
+                withLogContext(this._log, { direction: 'inbound', peerAid: '' }).warn('[aun_core.transport] recv unknown rpc response (maybe arrived after timeout): id=' + rpcId);
             }
             return;
         }
@@ -1318,15 +1342,16 @@ export class RPCTransport {
         // challenge 消息
         if (method === 'challenge') {
             this._challenge = message;
-            this._log.debug('challenge received');
-            this._dispatcher.enqueue('connection.challenge', message.params ?? {});
+            withLogContext(this._log, trafficLogContext('inbound', message.params ?? message)).debug('challenge received');
+            this._dispatcher.enqueueProtocol('connection.challenge', message.params ?? {});
             return;
         }
         // 事件推送
         if (method.startsWith('event/')) {
             const protocolEvent = method.slice(6);
             const sdkEvent = EVENT_NAME_MAP[protocolEvent] ?? protocolEvent;
-            this._log.debug(`event recv: event=${sdkEvent} ${summarizeDict(message.params, DIAG_RESULT_FIELDS)}`);
+            const eventLog = withLogContext(this._log, trafficLogContext('inbound', message.params ?? message));
+            eventLog.debug(`event recv: event=${sdkEvent} ${summarizeDict(message.params, DIAG_RESULT_FIELDS)}`);
             this._notifyMetaObserver(message);
             // 提取事件中的 _trace 并回调 observer，然后从 params 中剥离
             const params = (message.params ?? {});
@@ -1345,7 +1370,7 @@ export class RPCTransport {
                         });
                     }
                     const traceObj = eventTrace;
-                    this._log.info(`[trace=${String(traceObj.trace_id ?? '')}] event_recv event=${sdkEvent}`);
+                    eventLog.info(`[trace=${String(traceObj.trace_id ?? '')}] event_recv event=${sdkEvent}`);
                 }
             }
             // 发布为 _raw.{event}，由 AUNClient 处理后再发布用户可见的事件
@@ -1353,13 +1378,13 @@ export class RPCTransport {
                 this._dispatcher.enqueue(sdkEvent, params);
                 return;
             }
-            this._dispatcher.enqueue(`_raw.${sdkEvent}`, params);
+            this._dispatcher.enqueueProtocol(`_raw.${sdkEvent}`, params);
             return;
         }
         // 其他通知
         this._notifyMetaObserver(message);
-        this._log.debug(`notification recv: method=${method || '<no-method>'}`);
-        this._dispatcher.enqueue('notification', message);
+        withLogContext(this._log, trafficLogContext('inbound', message.params ?? {})).debug(`notification recv: method=${method || '<no-method>'}`);
+        this._dispatcher.enqueueProtocol('notification', message);
     }
     _decodeMessage(raw) {
         if (isJsonObject(raw)) {