@agentunion/fastaun-browser 0.5.8 → 0.5.10

package/dist/transport.d.ts

@@ -1,6 +1,7 @@
 import { EventDispatcher } from './events.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;
 /**
  * JSON-RPC 2.0 传输层 — 基于浏览器原生 WebSocket。
  *
@@ -33,6 +34,8 @@ export declare class RPCTransport {
     private _metaObserver;
     private _traceMode;
     private _traceObserver;
+    private _actorTail;
+    private _actorBusy;
     constructor(opts: {
         eventDispatcher: EventDispatcher;
         timeout?: number;
@@ -55,7 +58,7 @@ export declare class RPCTransport {
     /** 设置 trace 模式：off / log / diag */
     setTraceMode(mode: string): void;
     /** 注册 trace observer；observer(traceInfo) 在每次 RPC/事件携带 _trace 时调用。 */
-    setTraceObserver(observer: ((traceInfo: Record<string, unknown>) => void) | null): void;
+    setTraceObserver(observer: ((traceInfo: Record<string, unknown>) => void | Promise<void>) | null): void;
     /** 获取连接时收到的 challenge */
     get challenge(): RpcMessage | null;
     /** 串行化 WebSocket 的清理与握手安装，不持有到 challenge 返回。 */
@@ -65,8 +68,10 @@ export declare class RPCTransport {
      * 等待首条消息，若为 challenge 则返回，否则进入消息路由。
      */
     connect(url: string): Promise<RpcMessage | null>;
+    private _connectImpl;
     /** 关闭连接 */
     close(): Promise<void>;
+    private _closeImpl;
     /** 已持有连接建立串行权时关闭当前 WebSocket。 */
     private _closeUnlocked;
     /**
@@ -74,9 +79,13 @@ export declare class RPCTransport {
      * 返回 result 字段的值；若有 error 字段则抛出映射后的错误。
      */
     call(method: string, params?: RpcParams | null, timeout?: number, trace?: string, background?: boolean): Promise<RpcResult>;
+    private _callImpl;
     /** 发送 JSON-RPC 2.0 Notification，不分配 id，也不等待响应。 */
     notify(method: string, params?: RpcParams | null): Promise<void>;
+    private _notifyImpl;
     private _enqueueSend;
+    private _enqueueActor;
+    private _enqueueActorStart;
     private _sendText;
     private _sendFailureError;
     private _waitForCloseCodeIfClosing;

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

@@ -7,6 +7,164 @@ const MAX_BACKGROUND_RPC_INFLIGHT = 8;
 const _noopLog = { error: () => { }, warn: () => { }, info: () => { }, debug: () => { } };
 /** RPC 请求递增计数器，避免 Date.now() 高并发碰撞 */
 let _rpcIdCounter = 0;
+const WORKER_WEBSOCKET_SOURCE = `
+let socket = null;
+self.onmessage = (event) => {
+  const command = event.data || {};
+  if (command.type === 'connect') {
+    try {
+      socket = new WebSocket(command.url);
+      socket.onopen = () => self.postMessage({ type: 'open' });
+      socket.onmessage = (message) => self.postMessage({ type: 'message', data: message.data });
+      socket.onerror = () => self.postMessage({ type: 'error', message: 'websocket error' });
+      socket.onclose = (close) => self.postMessage({
+        type: 'close', code: close.code, reason: close.reason || '', wasClean: close.wasClean === true,
+      });
+    } catch (error) {
+      self.postMessage({ type: 'error', message: error instanceof Error ? error.message : String(error) });
+    }
+    return;
+  }
+  if (command.type === 'send') {
+    try {
+      if (!socket || socket.readyState !== WebSocket.OPEN) throw new Error('websocket is not open');
+      socket.send(command.data);
+      self.postMessage({ type: 'send_result', id: command.id, ok: true });
+    } catch (error) {
+      self.postMessage({
+        type: 'send_result', id: command.id, ok: false,
+        error: error instanceof Error ? error.message : String(error),
+      });
+    }
+    return;
+  }
+  if (command.type === 'close' && socket) socket.close(command.code, command.reason);
+};
+`;
+class WorkerWebSocketProxy {
+    static CONNECTING = 0;
+    static OPEN = 1;
+    static CLOSING = 2;
+    static CLOSED = 3;
+    readyState = WorkerWebSocketProxy.CONNECTING;
+    onopen = null;
+    onmessage = null;
+    onerror = null;
+    onclose = null;
+    _worker;
+    _workerUrl;
+    _listeners = new Map();
+    _pendingSends = new Map();
+    _sendSeq = 0;
+    constructor(url) {
+        this._workerUrl = URL.createObjectURL(new Blob([WORKER_WEBSOCKET_SOURCE], { type: 'text/javascript' }));
+        try {
+            this._worker = new Worker(this._workerUrl);
+        }
+        catch (error) {
+            URL.revokeObjectURL(this._workerUrl);
+            throw error;
+        }
+        this._worker.onmessage = (event) => this._handleWorkerMessage(event.data);
+        this._worker.onerror = (event) => this._emitError(event.message || 'websocket worker error');
+        this._worker.postMessage({ type: 'connect', url });
+    }
+    send(data) {
+        if (this.readyState !== WorkerWebSocketProxy.OPEN)
+            return Promise.reject(new Error('websocket is not open'));
+        const id = ++this._sendSeq;
+        return new Promise((resolve, reject) => {
+            this._pendingSends.set(id, { resolve, reject });
+            try {
+                this._worker.postMessage({ type: 'send', id, data });
+            }
+            catch (error) {
+                this._pendingSends.delete(id);
+                reject(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    }
+    close(code, reason) {
+        if (this.readyState === WorkerWebSocketProxy.CLOSED)
+            return;
+        this.readyState = WorkerWebSocketProxy.CLOSING;
+        this._worker.postMessage({ type: 'close', code, reason });
+    }
+    addEventListener(type, listener) {
+        const callback = typeof listener === 'function' ? listener : (event) => listener.handleEvent(event);
+        const listeners = this._listeners.get(type) ?? new Set();
+        listeners.add(callback);
+        this._listeners.set(type, listeners);
+    }
+    removeEventListener(type, listener) {
+        if (typeof listener === 'function')
+            this._listeners.get(type)?.delete(listener);
+    }
+    _handleWorkerMessage(reply) {
+        if (reply.type === 'send_result' && reply.id !== undefined) {
+            const pending = this._pendingSends.get(reply.id);
+            if (!pending)
+                return;
+            this._pendingSends.delete(reply.id);
+            if (reply.ok)
+                pending.resolve();
+            else
+                pending.reject(new Error(reply.error || 'websocket send failed'));
+            return;
+        }
+        if (reply.type === 'open') {
+            this.readyState = WorkerWebSocketProxy.OPEN;
+            const event = new Event('open');
+            this.onopen?.(event);
+            this._emit('open', event);
+            return;
+        }
+        if (reply.type === 'message') {
+            const event = new MessageEvent('message', { data: reply.data });
+            this.onmessage?.(event);
+            this._emit('message', event);
+            return;
+        }
+        if (reply.type === 'error') {
+            this._emitError(reply.message || 'websocket worker error');
+            return;
+        }
+        if (reply.type === 'close') {
+            this.readyState = WorkerWebSocketProxy.CLOSED;
+            for (const pending of this._pendingSends.values())
+                pending.reject(new Error('websocket closed'));
+            this._pendingSends.clear();
+            const event = new CloseEvent('close', {
+                code: reply.code ?? 1006, reason: reply.reason ?? '', wasClean: reply.wasClean === true,
+            });
+            this.onclose?.(event);
+            this._emit('close', event);
+            this._worker.terminate();
+            URL.revokeObjectURL(this._workerUrl);
+        }
+    }
+    _emitError(message) {
+        const event = new ErrorEvent('error', { message });
+        this.onerror?.(event);
+        this._emit('error', event);
+    }
+    _emit(type, event) {
+        for (const listener of [...(this._listeners.get(type) ?? [])])
+            listener(event);
+    }
+}
+export function createTransportWebSocket(url) {
+    if (typeof Worker === 'function' && typeof Blob === 'function' && typeof URL !== 'undefined'
+        && typeof URL.createObjectURL === 'function' && typeof URL.revokeObjectURL === 'function') {
+        try {
+            return new WorkerWebSocketProxy(url);
+        }
+        catch {
+            // Worker/CSP 不可用时保持原生 WebSocket 路径。
+        }
+    }
+    return new WebSocket(url);
+}
 // ── Trace 树状展示 ─────────────────────────────────────────────
 const TRACE_SPAN_DETAIL_FIELDS = [
     'method', 'route', 'namespace', 'instance_id', 'aid', 'caller_aid',
@@ -260,6 +418,10 @@ export class RPCTransport {
     _traceMode = 'off';
     // Trace observer：observer(traceInfo) 在每次 RPC/事件携带 _trace 时调用
     _traceObserver = null;
+    // 每个 transport 实例一个轻量级网络 actor。命令只在此处启动网络操作，
+    // 不等待 RPC 响应，避免应用回调中的 send 反向占住收包路径。
+    _actorTail = Promise.resolve();
+    _actorBusy = false;
     constructor(opts) {
         this._dispatcher = opts.eventDispatcher;
         this._timeout = opts.timeout ?? 10;
@@ -287,18 +449,21 @@ export class RPCTransport {
     setMetaObserver(observer) {
         this._metaObserver = observer;
     }
-    async _notifyMetaObserver(message) {
-        if (this._metaObserver === null)
+    _notifyMetaObserver(message) {
+        const observer = this._metaObserver;
+        if (observer === null)
             return;
         const meta = message._meta;
         if (!isJsonObject(meta))
             return;
-        try {
-            await this._metaObserver(meta);
-        }
-        catch (exc) {
-            this._log.debug(`meta_observer raised: ${String(exc)}`);
-        }
+        this._dispatcher.enqueueTask(async () => {
+            try {
+                await observer(meta);
+            }
+            catch (exc) {
+                this._log.debug(`meta_observer raised: ${String(exc)}`);
+            }
+        });
     }
     /** 设置 trace 模式：off / log / diag */
     setTraceMode(mode) {
@@ -335,7 +500,10 @@ export class RPCTransport {
      * 连接到 WebSocket URL。
      * 等待首条消息，若为 challenge 则返回，否则进入消息路由。
      */
-    async connect(url) {
+    connect(url) {
+        return this._enqueueActorStart(() => this._connectImpl(url));
+    }
+    async _connectImpl(url) {
         const tStart = Date.now();
         this._log.debug(`connect enter: url=${url}`);
         const setup = await this._withConnectionSetup(async () => {
@@ -345,7 +513,7 @@ export class RPCTransport {
             this._lastCloseCode = null;
             this._lastCloseReason = '';
             const handshake = new Promise((resolve, reject) => {
-                const ws = new WebSocket(url);
+                const ws = createTransportWebSocket(url);
                 this._ws = ws;
                 this._closed = false;
                 let initialResolved = false;
@@ -489,7 +657,10 @@ export class RPCTransport {
         return setup.handshake;
     }
     /** 关闭连接 */
-    async close() {
+    close() {
+        return this._enqueueActor(() => this._closeImpl());
+    }
+    async _closeImpl() {
         await this._withConnectionSetup(() => this._closeUnlocked());
     }
     /** 已持有连接建立串行权时关闭当前 WebSocket。 */
@@ -566,7 +737,10 @@ export class RPCTransport {
      * 发起 JSON-RPC 2.0 调用。
      * 返回 result 字段的值；若有 error 字段则抛出映射后的错误。
      */
-    async call(method, params, timeout, trace, background = false) {
+    call(method, params, timeout, trace, background = false) {
+        return this._enqueueActorStart(() => this._callImpl(method, params, timeout, trace, background), () => new TimeoutError(`rpc cancelled: ${method}`, { retryable: true }));
+    }
+    _callImpl(method, params, timeout, trace, background = false) {
         if (this._closed || !this._ws) {
             throw this._notConnectedError();
         }
@@ -612,7 +786,7 @@ export class RPCTransport {
                 this._drainRpcQueue();
             }, effectiveTimeout);
             const pending = {
-                resolve: async (response) => {
+                resolve: (response) => {
                     clearTimeout(timer);
                     const elapsed = Date.now() - tStart;
                     if (response.error !== undefined) {
@@ -631,7 +805,7 @@ export class RPCTransport {
                         if (traceId) {
                             this._log.info(`[trace=${traceId}] rpc_recv method=${method} rpc_id=${rpcId} duration_ms=${elapsed} status=ok`);
                         }
-                        await this._notifyMetaObserver(response);
+                        this._notifyMetaObserver(response);
                         // 处理 success 路径的 _trace
                         const respTrace = response._trace;
                         if (respTrace && typeof respTrace === 'object' && !Array.isArray(respTrace)) {
@@ -671,7 +845,10 @@ export class RPCTransport {
         return Object.assign(promise, { cancel: () => cancelRpc?.() });
     }
     /** 发送 JSON-RPC 2.0 Notification，不分配 id，也不等待响应。 */
-    async notify(method, params) {
+    notify(method, params) {
+        return this._enqueueActorStart(() => this._notifyImpl(method, params));
+    }
+    async _notifyImpl(method, params) {
         if (this._closed || !this._ws) {
             throw this._notConnectedError();
         }
@@ -699,6 +876,63 @@ export class RPCTransport {
         this._sendChain = run.catch(() => { });
         return run;
     }
+    _enqueueActor(operation) {
+        this._actorBusy = true;
+        const run = this._actorTail.then(async () => {
+            return await operation();
+        }, async () => {
+            return await operation();
+        });
+        const tail = run.then(() => undefined, () => undefined);
+        this._actorTail = tail;
+        void tail.then(() => {
+            if (this._actorTail === tail)
+                this._actorBusy = false;
+        });
+        return run;
+    }
+    _enqueueActorStart(operation, cancellationError) {
+        let resolveResult;
+        let rejectResult;
+        const result = new Promise((resolve, reject) => { resolveResult = resolve; rejectResult = reject; });
+        let cancel;
+        let cancelRequested = false;
+        const launch = () => {
+            if (cancelRequested)
+                return;
+            try {
+                const inner = operation();
+                cancel = inner.cancel;
+                inner.then(resolveResult, rejectResult);
+            }
+            catch (err) {
+                rejectResult(err);
+            }
+        };
+        if (this._actorBusy) {
+            const gate = this._actorTail.then(launch, launch);
+            const tail = gate.then(() => undefined, () => undefined);
+            this._actorTail = tail;
+            void tail.then(() => {
+                if (this._actorTail === tail)
+                    this._actorBusy = false;
+            });
+        }
+        else {
+            launch();
+        }
+        return Object.assign(result, {
+            cancel: () => {
+                if (cancelRequested)
+                    return;
+                cancelRequested = true;
+                if (cancel)
+                    cancel();
+                else
+                    rejectResult(cancellationError?.() ?? new TimeoutError('rpc cancelled', { retryable: true }));
+            },
+        });
+    }
     _sendText(payload, context, beforeSend) {
         return this._enqueueSend(async () => {
             if (beforeSend && !beforeSend()) {
@@ -709,7 +943,7 @@ export class RPCTransport {
             }
             const ws = this._ws;
             try {
-                ws.send(payload);
+                await Promise.resolve(ws.send(payload));
             }
             catch (err) {
                 throw await this._sendFailureError(context, err, ws);
@@ -841,7 +1075,15 @@ export class RPCTransport {
             const enriched = { ...respTrace, spans };
             this._log.info(traceDisplay(method, status, elapsedMs, respTrace, spans));
             if (this._traceObserver !== null) {
-                this._traceObserver({ type: 'rpc', method, trace: enriched, status, duration_ms: elapsedMs });
+                const observer = this._traceObserver;
+                this._dispatcher.enqueueTask(async () => {
+                    try {
+                        await observer({ type: 'rpc', method, trace: enriched, status, duration_ms: elapsedMs });
+                    }
+                    catch (err) {
+                        this._log.debug(`trace observer raised: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                });
             }
         }
         catch (err) {
@@ -887,10 +1129,18 @@ export class RPCTransport {
         // 非主动关闭时触发断线回调
         if (!wasClosed) {
             const error = new ConnectionError(`websocket closed: code=${event.code} reason=${event.reason}`);
-            this._dispatcher.publish('connection.error', { error });
             if (this._onDisconnect) {
-                this._onDisconnect(error, event.code).catch(exc => this._log.warn('[aun_core.transport] disconnect callback exception:', exc));
+                const onDisconnect = this._onDisconnect;
+                this._dispatcher.enqueueTask(async () => {
+                    try {
+                        await onDisconnect(error, event.code);
+                    }
+                    catch (exc) {
+                        this._log.warn('[aun_core.transport] disconnect callback exception:', exc);
+                    }
+                });
             }
+            this._dispatcher.enqueue('connection.error', { error });
         }
     }
     _notConnectedError() {
@@ -922,7 +1172,7 @@ export class RPCTransport {
         if (method === 'challenge') {
             this._challenge = message;
             this._log.debug('challenge received');
-            this._dispatcher.publish('connection.challenge', message.params ?? {});
+            this._dispatcher.enqueue('connection.challenge', message.params ?? {});
             return;
         }
         // 事件推送
@@ -930,7 +1180,7 @@ export class RPCTransport {
             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)}`);
-            void this._notifyMetaObserver(message);
+            this._notifyMetaObserver(message);
             // 提取事件中的 _trace 并回调 observer，然后从 params 中剥离
             const params = (message.params ?? {});
             if ('_trace' in params) {
@@ -938,10 +1188,14 @@ export class RPCTransport {
                 delete params._trace;
                 if (eventTrace && typeof eventTrace === 'object' && !Array.isArray(eventTrace)) {
                     if (this._traceObserver !== null) {
-                        try {
-                            this._traceObserver({ type: 'event', event: sdkEvent, trace: eventTrace });
-                        }
-                        catch { /* observer 抛错被吞 */ }
+                        const observer = this._traceObserver;
+                        const tracePayload = eventTrace;
+                        this._dispatcher.enqueueTask(async () => {
+                            try {
+                                await observer({ type: 'event', event: sdkEvent, trace: tracePayload });
+                            }
+                            catch { /* observer 抛错被吞 */ }
+                        });
                     }
                     const traceObj = eventTrace;
                     this._log.info(`[trace=${String(traceObj.trace_id ?? '')}] event_recv event=${sdkEvent}`);
@@ -949,16 +1203,16 @@ export class RPCTransport {
             }
             // 发布为 _raw.{event}，由 AUNClient 处理后再发布用户可见的事件
             if (sdkEvent.startsWith('app.')) {
-                this._dispatcher.publish(sdkEvent, params);
+                this._dispatcher.enqueue(sdkEvent, params);
                 return;
             }
-            this._dispatcher.publish(`_raw.${sdkEvent}`, params);
+            this._dispatcher.enqueue(`_raw.${sdkEvent}`, params);
             return;
         }
         // 其他通知
-        void this._notifyMetaObserver(message);
+        this._notifyMetaObserver(message);
         this._log.debug(`notification recv: method=${method || '<no-method>'}`);
-        this._dispatcher.publish('notification', message);
+        this._dispatcher.enqueue('notification', message);
     }
     _decodeMessage(raw) {
         if (isJsonObject(raw)) {