@agentunion/fastaun-browser 0.4.12 → 0.5.0

package/dist/client.d.ts

@@ -1,6 +1,10 @@
 import { type AUNConfig } from './config.js';
 import { type EventHandler, type Subscription } from './events.js';
 import { GatewayDiscovery } from './discovery.js';
+import { AIDStore } from './aid-store.js';
+import { GroupFacade, MessageFacade, StreamFacade } from './facades.js';
+import { StorageVFS } from './storage/vfs.js';
+import { CollabClient } from './collab/client.js';
 import { ConnectionState, type JsonObject, type RpcParams, type RpcResult } from './types.js';
 import { AID } from './aid.js';
 export interface ConnectionOptions {
@@ -29,6 +33,12 @@ export interface NotifyOptions {
     ttl_ms?: number;
     ttlMs?: number;
 }
+export interface BindGroupAidOptions {
+    aidStore?: AIDStore;
+}
+export interface CompleteGroupTransferOptions {
+    aidStore?: AIDStore;
+}
 /**
  * AUN Core SDK 客户端 — 浏览器版本。
  *
@@ -115,6 +125,7 @@ export declare class AUNClient {
     private _onlineUnreadHintIntervalMs;
     /** gap fill 来源标记：true 表示当前正在补洞（pull 触发），false 表示非补洞 */
     private _gapFillActive;
+    private _backgroundRpcDepth;
     private _pullGates;
     private _reconnectActive;
     private _reconnectAbort;
@@ -146,8 +157,23 @@ export declare class AUNClient {
     private _delivery;
     private _v2E2EE;
     private _groupState;
+    private _storage?;
+    private _collab?;
+    private _messageFacade?;
+    private _groupFacade?;
+    private _streamFacade?;
     constructor(aid?: AID);
     get aid(): string | null;
+    /** AUN Storage VFS 入口 */
+    get storage(): StorageVFS;
+    /** AUN collab 协作层入口 */
+    get collab(): CollabClient;
+    /** Message RPC facade 入口 */
+    get message(): MessageFacade;
+    /** Group RPC facade 入口 */
+    get group(): GroupFacade;
+    /** Stream RPC facade 入口 */
+    get stream(): StreamFacade;
     private _observeAgentMdFromEnvelope;
     /** transport 的 meta observer：吸收 gateway 注入的 _meta 字段。失败不影响业务。 */
     private _observeRpcMeta;
@@ -203,6 +229,10 @@ export declare class AUNClient {
      * 自动解密 message.pull/group.pull、Group E2EE 生命周期编排。
      */
     call(method: string, params?: RpcParams): Promise<RpcResult>;
+    createGroup(params?: RpcParams): Promise<RpcResult>;
+    bindGroupAid(params?: RpcParams, options?: BindGroupAidOptions): Promise<RpcResult>;
+    startGroupTransfer(params?: RpcParams, options?: CompleteGroupTransferOptions): Promise<RpcResult>;
+    completeGroupTransfer(params?: RpcParams, options?: CompleteGroupTransferOptions): Promise<RpcResult>;
     private static _notifyParamsSizeOk;
     private static _validateNotifyEventMethod;
     private static _normalizeNotifyTtl;
@@ -448,6 +478,7 @@ export declare class AUNClient {
     private _safeAsync;
     private _explicitGroupCursorParams;
     private _groupCursorTargetsCurrentInstance;
+    private _withBackgroundRpc;
     private _runPullSerialized;
     /** 可取消的 sleep */
     private _sleep;

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -8,6 +8,7 @@ import { createConfig, getDeviceId, normalizeSlotId } from './config.js';
 import { EventDispatcher } from './events.js';
 import { normalizeGroupId } from './group-id.js';
 import { GatewayDiscovery } from './discovery.js';
+import { AIDStore } from './aid-store.js';
 import { RPCTransport } from './transport.js';
 import { AuthFlow } from './auth.js';
 import { SeqTracker } from './seq-tracker.js';
@@ -17,6 +18,9 @@ import { IdentityRuntimeManager } from './client/identity.js';
 import { LifecycleController } from './client/lifecycle.js';
 import { PeerDirectory } from './client/peers.js';
 import { RpcPipeline } from './client/rpc-pipeline.js';
+import { GroupFacade, MessageFacade, StreamFacade } from './facades.js';
+import { StorageVFS } from './storage/vfs.js';
+import { CollabClient } from './collab/client.js';
 import { V2E2EECoordinator } from './client/v2-e2ee.js';
 import { GroupStateCoordinator } from './client/group-state.js';
 import { CryptoProvider, base64ToUint8, pemToArrayBuffer, ecdsaVerifyDer, importCertPublicKeyEcdsa, } from './crypto.js';
@@ -110,18 +114,25 @@ const NON_IDEMPOTENT_METHODS = new Set([
     'storage.create_folder', 'storage.rename_folder', 'storage.move_folder',
     'storage.delete_folder', 'storage.move_object', 'storage.copy_object',
     'storage.batch_delete', 'storage.set_object_meta', 'storage.append_object',
+    'storage.set_acl', 'storage.remove_acl', 'storage.set_visibility',
+    'storage.issue_token', 'storage.revoke_token',
+    'storage.create_symlink', 'storage.atomic_repoint',
+    'storage.rename_symlink', 'storage.delete_symlink',
+    'storage.fs.mkdir', 'storage.fs.remove', 'storage.fs.rename', 'storage.fs.copy',
+    'storage.fs.mount', 'storage.fs.approve', 'storage.fs.reject', 'storage.fs.unmount',
+    'storage.fs.invalidate_membership',
+    'storage.volume.create', 'storage.volume.renew', 'storage.volume.expire_due',
     'auth.create_aid', 'auth.renew_cert', 'auth.rekey',
     'message.thought.put', 'group.thought.put',
-    'group.add_member',
-    'group.resources.put', 'group.resources.create_folder',
-    'group.resources.rename', 'group.resources.move',
-    'group.resources.mount_object', 'group.resources.update',
-    'group.resources.delete', 'group.resources.cleanup_by_storage_ref',
-    'group.resources.request_add', 'group.resources.request_mount_object',
-    'group.resources.direct_add', 'group.resources.approve_request',
-    'group.resources.reject_request', 'group.resources.unmount',
-    'group.resources.get_access',
-    'group.resources.resolve_access_ticket',
+    'group.add_member', 'group.bind_group_aid', 'group.complete_transfer',
+    'group.fs.mkdir', 'group.fs.rm', 'group.fs.cp', 'group.fs.mv',
+    'group.fs.mount', 'group.fs.umount',
+    'group.fs.check_upload', 'group.fs.create_upload_session',
+    'group.fs.complete_upload', 'group.fs.create_download_ticket',
+    'collab.create', 'collab.commit', 'collab.clone',
+    'collab.prune', 'collab.unregister',
+    'collab.tag.create', 'collab.tag.restore',
+    'collab.tag.rm', 'collab.tag.prune',
 ]);
 /** 需要客户端签名的关键方法。运行时逻辑已迁入 RpcPipeline，此处保留给源码审计测试。 */
 const SIGNED_METHODS = new Set([
@@ -138,20 +149,17 @@ const SIGNED_METHODS = new Set([
     'group.leave', 'group.remove_member', 'group.update_rules',
     'group.update', 'group.update_announcement',
     'group.update_join_requirements', 'group.set_role',
-    'group.transfer_owner', 'group.review_join_request',
+    'group.transfer_owner', 'group.bind_group_aid', 'group.complete_transfer',
+    'group.review_join_request',
     'group.batch_review_join_request',
     'group.request_join', 'group.use_invite_code',
     'group.thought.put',
     'message.thought.put',
     'group.set_settings',
-    'group.resources.put', 'group.resources.create_folder',
-    'group.resources.rename', 'group.resources.move',
-    'group.resources.mount_object', 'group.resources.update',
-    'group.resources.delete', 'group.resources.cleanup_by_storage_ref',
-    'group.resources.request_add', 'group.resources.request_mount_object',
-    'group.resources.direct_add', 'group.resources.approve_request',
-    'group.resources.reject_request', 'group.resources.unmount',
-    'group.resources.get_access', 'group.resources.resolve_access_ticket',
+    'group.fs.mkdir', 'group.fs.rm', 'group.fs.cp', 'group.fs.mv',
+    'group.fs.mount', 'group.fs.umount',
+    'group.fs.check_upload', 'group.fs.create_upload_session',
+    'group.fs.complete_upload', 'group.fs.create_download_ticket',
     'storage.put_object', 'storage.delete_object',
     'storage.create_share_link', 'storage.revoke_share_link',
     'storage.get_by_share',
@@ -159,6 +167,19 @@ const SIGNED_METHODS = new Set([
     'storage.create_folder', 'storage.rename_folder', 'storage.move_folder',
     'storage.delete_folder', 'storage.move_object', 'storage.copy_object',
     'storage.batch_delete', 'storage.set_object_meta', 'storage.append_object',
+    'storage.set_acl', 'storage.remove_acl', 'storage.set_visibility',
+    'storage.check_access',
+    'storage.issue_token', 'storage.revoke_token',
+    'storage.create_symlink', 'storage.atomic_repoint',
+    'storage.rename_symlink', 'storage.delete_symlink',
+    'storage.fs.mkdir', 'storage.fs.remove', 'storage.fs.rename', 'storage.fs.copy',
+    'storage.fs.mount', 'storage.fs.approve', 'storage.fs.reject', 'storage.fs.unmount',
+    'storage.fs.invalidate_membership',
+    'storage.volume.create', 'storage.volume.renew', 'storage.volume.expire_due',
+    'collab.create', 'collab.commit', 'collab.clone',
+    'collab.prune', 'collab.unregister',
+    'collab.tag.create', 'collab.tag.restore',
+    'collab.tag.rm', 'collab.tag.prune',
     'group.commit_state',
     'group.ban', 'group.unban',
     'group.dissolve', 'group.suspend', 'group.resume',
@@ -344,6 +365,22 @@ function _v2ConcatBytes(...parts) {
 function formatCaughtError(error) {
     return error instanceof Error ? error : String(error);
 }
+const RELOGIN_REFRESH_ERRORS = new Set([
+    'missing refresh_token',
+    'invalid_or_expired_refresh_token',
+    'refresh not supported',
+]);
+function authErrorRequiresRelogin(error) {
+    const data = error.data;
+    if (isJsonObject(data)) {
+        if (data.relogin_required === true)
+            return true;
+        const code = String(data.error ?? '').trim().toLowerCase();
+        if (RELOGIN_REFRESH_ERRORS.has(code))
+            return true;
+    }
+    return RELOGIN_REFRESH_ERRORS.has(error.message.trim().toLowerCase());
+}
 function v2E2eeMeta(envelope) {
     const suite = String(envelope.suite ?? '');
     const modeSuite = String(envelope.suite ?? 'unknown');
@@ -544,6 +581,7 @@ export class AUNClient {
     _onlineUnreadHintIntervalMs = 50;
     /** gap fill 来源标记：true 表示当前正在补洞（pull 触发），false 表示非补洞 */
     _gapFillActive = false;
+    _backgroundRpcDepth = 0;
     // Pull Gate：序列化同一 key 的并发 pull 操作，防止重复拉取
     _pullGates = new Map();
     // 重连相关
@@ -579,6 +617,11 @@ export class AUNClient {
     _delivery;
     _v2E2EE;
     _groupState;
+    _storage;
+    _collab;
+    _messageFacade;
+    _groupFacade;
+    _streamFacade;
     constructor(aid) {
         if (aid !== null && aid !== undefined && !isAIDObject(aid)) {
             throw new ValidationError('AUNClient only accepts an AID object or no argument');
@@ -735,6 +778,36 @@ export class AUNClient {
     get aid() {
         return this._aid;
     }
+    /** AUN Storage VFS 入口 */
+    get storage() {
+        if (!this._storage)
+            this._storage = new StorageVFS(this);
+        return this._storage;
+    }
+    /** AUN collab 协作层入口 */
+    get collab() {
+        if (!this._collab)
+            this._collab = new CollabClient(this);
+        return this._collab;
+    }
+    /** Message RPC facade 入口 */
+    get message() {
+        if (!this._messageFacade)
+            this._messageFacade = new MessageFacade(this);
+        return this._messageFacade;
+    }
+    /** Group RPC facade 入口 */
+    get group() {
+        if (!this._groupFacade)
+            this._groupFacade = new GroupFacade(this);
+        return this._groupFacade;
+    }
+    /** Stream RPC facade 入口 */
+    get stream() {
+        if (!this._streamFacade)
+            this._streamFacade = new StreamFacade(this);
+        return this._streamFacade;
+    }
     async _observeAgentMdFromEnvelope(envelope) {
         await this._agentMdManager.observeEnvelope(envelope);
     }
@@ -976,6 +1049,200 @@ export class AUNClient {
     async call(method, params) {
         return await this._rpcPipeline.call(method, params);
     }
+    async createGroup(params = {}) {
+        if (!isJsonObject(params)) {
+            throw new ValidationError('createGroup params must be an object');
+        }
+        const payload = { ...params };
+        const groupName = String(payload.group_name ?? payload.groupName ?? '').trim();
+        if (!groupName) {
+            return await this.call('group.create', payload);
+        }
+        const keyPair = await new CryptoProvider().generateIdentity();
+        payload.public_key = keyPair.public_key_der_b64;
+        payload.curve = keyPair.curve;
+        const result = await this.call('group.create', payload);
+        const resultMap = isJsonObject(result) ? result : {};
+        const group = isJsonObject(resultMap.group) ? resultMap.group : {};
+        const aidCert = isJsonObject(resultMap.aid_cert) ? resultMap.aid_cert : {};
+        const groupAid = String(group.group_aid ?? resultMap.group_aid ?? '').trim();
+        const certPem = String(aidCert.cert ?? aidCert.cert_pem ?? resultMap.cert ?? resultMap.cert_pem ?? '').trim();
+        if (!groupAid || !certPem) {
+            throw new ValidationError('group.create named group response missing group.group_aid or aid_cert.cert');
+        }
+        const store = new AIDStore({
+            aunPath: this.configModel.aunPath,
+            encryptionSeed: this.configModel.seedPassword ?? '',
+            slotId: this._slotId,
+            rootCaPem: this.configModel.rootCaPem,
+            verifySsl: this.configModel.verifySsl,
+        });
+        try {
+            const imported = await store.importGroupIdentity(groupAid, {
+                private_key_pem: keyPair.private_key_pem,
+                public_key_der_b64: keyPair.public_key_der_b64,
+                curve: keyPair.curve,
+                cert_pem: certPem,
+            });
+            if (!imported.ok) {
+                throw new ValidationError(imported.error.message);
+            }
+        }
+        finally {
+            store.close();
+        }
+        return result;
+    }
+    async bindGroupAid(params = {}, options = {}) {
+        if (!isJsonObject(params)) {
+            throw new ValidationError('bindGroupAid params must be an object');
+        }
+        const store = options.aidStore;
+        if (!store) {
+            throw new ValidationError('bindGroupAid requires aidStore');
+        }
+        const keyPair = await new CryptoProvider().generateIdentity();
+        const payload = { ...params };
+        payload.public_key = keyPair.public_key_der_b64;
+        payload.curve = keyPair.curve;
+        const result = await this.call('group.bind_group_aid', payload);
+        const resultMap = isJsonObject(result) ? result : {};
+        const group = isJsonObject(resultMap.group) ? resultMap.group : {};
+        const aidCert = isJsonObject(resultMap.aid_cert) ? resultMap.aid_cert : {};
+        const groupAid = String(group.group_aid ?? resultMap.group_aid ?? '').trim();
+        const certPem = String(aidCert.cert ?? aidCert.cert_pem ?? resultMap.cert ?? resultMap.cert_pem ?? '').trim();
+        if (!groupAid || !certPem) {
+            throw new ValidationError('group.bind_group_aid response missing group.group_aid or aid_cert.cert');
+        }
+        const imported = await store.importGroupIdentity(groupAid, {
+            private_key_pem: keyPair.private_key_pem,
+            public_key_der_b64: keyPair.public_key_der_b64,
+            curve: keyPair.curve,
+            cert_pem: certPem,
+        });
+        if (!imported.ok) {
+            throw new ValidationError(imported.error.message);
+        }
+        return result;
+    }
+    async startGroupTransfer(params = {}, options = {}) {
+        if (!isJsonObject(params)) {
+            throw new ValidationError('startGroupTransfer params must be an object');
+        }
+        const store = options.aidStore;
+        if (!store) {
+            throw new ValidationError('startGroupTransfer requires aidStore');
+        }
+        const groupId = String(params.group_id ?? '').trim();
+        const newOwner = String(params.new_owner ?? '').trim();
+        if (!groupId || !newOwner) {
+            throw new ValidationError('startGroupTransfer requires group_id and new_owner');
+        }
+        let groupAid = String(params.group_aid ?? '').trim();
+        if (!groupAid) {
+            const info = await this.call('group.get', { group_id: groupId });
+            const infoMap = isJsonObject(info) ? info : {};
+            const grp = isJsonObject(infoMap.group) ? infoMap.group : infoMap;
+            groupAid = String(grp.group_aid ?? '').trim();
+        }
+        if (!groupAid) {
+            throw new ValidationError('startGroupTransfer: unable to determine group_aid');
+        }
+        const loaded = await store.load(groupAid);
+        if (!loaded.ok || !loaded.data) {
+            throw new ValidationError(`startGroupTransfer: group_aid identity not found: ${groupAid}`);
+        }
+        const aidObj = loaded.data.aid;
+        if (!aidObj.isPrivateKeyValid() || !aidObj.privateKeyPem) {
+            throw new ValidationError(`startGroupTransfer: group_aid private key not found: ${groupAid}`);
+        }
+        const nonce = globalThis.crypto.randomUUID().replace(/-/g, '');
+        const issuedMs = Date.now();
+        const canonical = [
+            'aun-group-owner-transfer-v1',
+            groupId.toLowerCase(),
+            groupAid.toLowerCase(),
+            newOwner.toLowerCase(),
+            nonce,
+            String(issuedMs),
+        ].join('|');
+        const signed = await aidObj.sign(canonical);
+        if (!signed.ok) {
+            throw new ValidationError(`startGroupTransfer: sign failed: ${signed.error.message}`);
+        }
+        const payload = { ...params, group_aid: groupAid };
+        payload.transfer_auth = { nonce, issued_ms: issuedMs, signature: signed.data.signature };
+        return await this.call('group.transfer_owner', payload);
+    }
+    async completeGroupTransfer(params = {}, options = {}) {
+        if (!isJsonObject(params)) {
+            throw new ValidationError('completeGroupTransfer params must be an object');
+        }
+        const store = options.aidStore;
+        if (!store) {
+            throw new ValidationError('completeGroupTransfer requires aidStore');
+        }
+        const keyPair = await new CryptoProvider().generateIdentity();
+        const payload = { ...params };
+        const groupId = String(params.group_id ?? '').trim();
+        if (!groupId) {
+            throw new ValidationError('completeGroupTransfer requires group_id');
+        }
+        let groupAid = String(params.group_aid ?? '').trim();
+        if (!groupAid) {
+            const info = await this.call('group.get', { group_id: groupId });
+            const infoMap = isJsonObject(info) ? info : {};
+            const grp = isJsonObject(infoMap.group) ? infoMap.group : infoMap;
+            groupAid = String(grp.group_aid ?? '').trim();
+        }
+        if (!groupAid) {
+            throw new ValidationError('completeGroupTransfer: unable to determine group_aid');
+        }
+        const current = this.currentAid;
+        const newOwner = String(current?.aid ?? '').trim();
+        if (!current || !newOwner || !current.isPrivateKeyValid()) {
+            throw new ValidationError('completeGroupTransfer requires current new-owner AID with private key');
+        }
+        const nonce = globalThis.crypto.randomUUID().replace(/-/g, '');
+        const issuedMs = Date.now();
+        const publicKeyHash = bytesToHex(new Uint8Array(await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(keyPair.public_key_der_b64))));
+        const canonical = [
+            'aun-group-owner-transfer-accept-v1',
+            groupId.toLowerCase(),
+            groupAid.toLowerCase(),
+            newOwner.toLowerCase(),
+            publicKeyHash,
+            nonce,
+            String(issuedMs),
+        ].join('|');
+        const signed = await current.sign(canonical);
+        if (!signed.ok) {
+            throw new ValidationError(`completeGroupTransfer: accept sign failed: ${signed.error.message}`);
+        }
+        payload.group_aid = groupAid;
+        payload.public_key = keyPair.public_key_der_b64;
+        payload.curve = keyPair.curve;
+        payload.transfer_accept = { nonce, issued_ms: issuedMs, signature: signed.data.signature };
+        const result = await this.call('group.complete_transfer', payload);
+        const resultMap = isJsonObject(result) ? result : {};
+        const group = isJsonObject(resultMap.group) ? resultMap.group : {};
+        const aidCert = isJsonObject(resultMap.aid_cert) ? resultMap.aid_cert : {};
+        const returnedGroupAid = String(group.group_aid ?? resultMap.group_aid ?? '').trim();
+        const certPem = String(aidCert.cert ?? aidCert.cert_pem ?? resultMap.cert ?? resultMap.cert_pem ?? '').trim();
+        if (!returnedGroupAid || !certPem) {
+            throw new ValidationError('group.complete_transfer response missing group.group_aid or aid_cert.cert');
+        }
+        const imported = await store.importGroupIdentity(returnedGroupAid, {
+            private_key_pem: keyPair.private_key_pem,
+            public_key_der_b64: keyPair.public_key_der_b64,
+            curve: keyPair.curve,
+            cert_pem: certPem,
+        });
+        if (!imported.ok) {
+            throw new ValidationError(imported.error.message);
+        }
+        return result;
+    }
     static _notifyParamsSizeOk(params) {
         return new TextEncoder().encode(JSON.stringify(params)).length <= MAX_NOTIFY_PAYLOAD_SIZE;
     }
@@ -1062,6 +1329,8 @@ export class AUNClient {
     }
     async _callRawV2Rpc(method, params) {
         const p = { ...(params ?? {}) };
+        const rpcBackground = Boolean(p._rpc_background) || this._backgroundRpcDepth > 0;
+        delete p._rpc_background;
         delete p._pull_gate_locked;
         delete p._skip_auto_ack;
         delete p.skip_auto_ack;
@@ -1075,7 +1344,7 @@ export class AUNClient {
         if (method.startsWith('group.') && p.slot_id === undefined) {
             p.slot_id = this._slotId;
         }
-        return await this._rpcPipeline.rawCall(method, p);
+        return await this._rpcPipeline.rawCall(method, p, { background: rpcBackground });
     }
     // ── 事件 ──────────────────────────────────────────
     /**
@@ -1845,16 +2114,28 @@ export class AUNClient {
                 }
                 catch (exc) {
                     if (exc instanceof AuthError) {
+                        if (authErrorRequiresRelogin(exc)) {
+                            this._clientLog.warn(`token refresh requires relogin, stopping refresh loop and triggering reconnect: ${exc.message}`);
+                            await this._dispatcher.publish('token.refresh_exhausted', {
+                                aid: this._identity?.aid ?? null,
+                                consecutive_failures: 1,
+                                last_error: String(exc),
+                                relogin_required: true,
+                            });
+                            this._tokenRefreshFailures = 0;
+                            await this._handleTransportDisconnect(new Error('token refresh relogin required, triggering reconnect'));
+                            return;
+                        }
                         this._tokenRefreshFailures++;
                         if (this._tokenRefreshFailures >= 3) {
-                            this._clientLog.warn(`token refreshconsecutivefailed ${this._tokenRefreshFailures}  , stop refresh loop and trigger reconnect`);
-                            this._dispatcher.publish('token.refresh_exhausted', {
+                            this._clientLog.warn(`token refresh failed ${this._tokenRefreshFailures} consecutive times, stopping refresh loop and triggering reconnect`);
+                            await this._dispatcher.publish('token.refresh_exhausted', {
                                 aid: this._identity?.aid ?? null,
                                 consecutive_failures: this._tokenRefreshFailures,
                                 last_error: String(exc),
                             });
                             this._tokenRefreshFailures = 0;
-                            this._handleTransportDisconnect(new Error('token refresh exhausted, triggering reconnect'));
+                            await this._handleTransportDisconnect(new Error('token refresh exhausted, triggering reconnect'));
                             return;
                         }
                         this._clientLog.warn(`token refresh failed (${this._tokenRefreshFailures}/3), next retry: ${String(exc)}`);
@@ -2660,6 +2941,15 @@ export class AUNClient {
             && (!slotId || slotId === (this._slotId ?? ''));
     }
     // ── Pull Gate（序列化同一 key 的并发 pull）──────────────────
+    async _withBackgroundRpc(operation) {
+        this._backgroundRpcDepth += 1;
+        try {
+            return await operation();
+        }
+        finally {
+            this._backgroundRpcDepth = Math.max(0, this._backgroundRpcDepth - 1);
+        }
+    }
     async _runPullSerialized(key, operation) {
         return await this._rpcPipeline.runPullSerialized(key, operation);
     }