@agentunion/fastaun-browser 0.5.20 → 0.5.21

package/dist/client/rpc-pipeline.d.ts

@@ -13,6 +13,8 @@ export declare class RpcPipeline {
     private pullInvalidationWait;
     constructor(runtime: ClientRuntime);
     call(method: string, params?: RpcParams): Promise<RpcResult>;
+    private _callWithSent;
+    private _call;
     private callImpl;
     private callImplInner;
     preflight(method: string, params?: RpcParams): RpcPreflightResult;
@@ -50,7 +52,8 @@ export declare class RpcPipeline {
     isPullNamespaceCurrent(namespace: string): boolean;
     invalidatePulls(): Promise<void>;
     private pullInvalidationInProgress;
-    runPullSerialized<T>(key: string, operation: () => Promise<T> | T, background?: boolean): Promise<T>;
+    runPullNamespaceSerialized<T>(key: string, operation: () => Promise<T> | T, background?: boolean): Promise<T>;
+    runPullSerialized<T>(key: string, operation: () => Promise<T> | T, background?: boolean, namespaceOnly?: boolean): Promise<T>;
     private executePullOperation;
     private throwIfPullInvalidated;
     yieldPullGate(key: string, nextKey?: string, background?: boolean): Promise<void>;

package/dist/client/rpc-pipeline.d.ts.map

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

package/dist/client/rpc-pipeline.js

@@ -1,4 +1,4 @@
-import { normalizeSlotId, slotIsolationKey } from '../config.js';
+import { _INTERNAL_MESSAGE_FLOW_LIMITS, normalizeSlotId, slotIsolationKey } from '../config.js';
 import { ClientSignatureError, ConnectionError, PermissionError, TimeoutError, ValidationError } from '../errors.js';
 import { parseCertMetadata, verifySignatureWithCert } from '../cert-utils.js';
 import { orgRequestParams, validateOrgRequestJSON } from '../org-protocol.js';
@@ -36,6 +36,7 @@ const SIGNED_METHODS = new Set([
     'message.v2.put_peer_pk', 'message.v2.bootstrap',
     'message.v2.group_bootstrap', 'message.v2.pull', 'message.history',
     'message.v2.ack',
+    'message.peers',
     'group.send',
     'group.v2.put_group_pk', 'group.v2.bootstrap',
     'group.v2.send', 'group.v2.pull', 'group.history', 'group.v2.ack',
@@ -134,7 +135,6 @@ async function signingCertFingerprint(certPem) {
 }
 const PULL_GATE_STALE_MS = 35_000;
 const PULL_GATE_OPERATION_TIMEOUT_MS = 35_000;
-const PULL_GATE_MAX_ACTIVE = 4;
 function sameIdentityAdmissionRejection(error, original) {
     const errorCode = Number(error?.code);
     const originalCode = Number(original?.code);
@@ -186,6 +186,9 @@ function hasMatchingV2Session(client) {
         return true;
     return session.aid === client._aid && session.deviceId === client._deviceId;
 }
+function isP2pNamespace(namespace) {
+    return namespace.startsWith('p2p:') || namespace.startsWith('p2p.peer.v1/');
+}
 function isTransientV2PullFallbackError(error) {
     const text = (error instanceof Error ? error.message : String(error)).toLowerCase();
     return text.includes('no_service') || text.includes('service plane unavailable');
@@ -200,6 +203,12 @@ export class RpcPipeline {
         this.runtime = runtime;
     }
     async call(method, params) {
+        return this._call(method, params);
+    }
+    async _callWithSent(method, params, onSent) {
+        return this._call(method, params, onSent);
+    }
+    async _call(method, params, onSent) {
         const client = this.runtime.client;
         const tStart = Date.now();
         const volatileCursor = method === 'message.pull'
@@ -207,7 +216,7 @@ export class RpcPipeline {
             : '';
         client._clientLog.debug(`call enter: method=${method}`);
         try {
-            const result = await this.callImpl(method, params);
+            const result = await this.callImpl(method, params, onSent);
             client._clientLog.debug(`call exit: elapsed=${Date.now() - tStart}ms method=${method}`);
             return result;
         }
@@ -217,7 +226,7 @@ export class RpcPipeline {
                 const retryParams = { ...(params ?? {}) };
                 delete retryParams.after_volatile_cursor;
                 delete retryParams.client_signature;
-                const result = await this.callImpl(method, retryParams);
+                const result = await this.callImpl(method, retryParams, onSent);
                 client._clientLog.debug(`call exit: elapsed=${Date.now() - tStart}ms method=${method}`);
                 return result;
             }
@@ -225,11 +234,21 @@ export class RpcPipeline {
             throw err;
         }
     }
-    async callImpl(method, params) {
+    async callImpl(method, params, onSent) {
         const client = this.runtime.client;
         const preflight = this.preflight(method, params);
         const p = preflight.params;
         const rpcBackground = preflight.rpcBackground;
+        if (client._p2pPeerPullEnabled) {
+            if (method === 'message.peers')
+                return await client._delivery.peers(p, rpcBackground);
+            if (method === 'message.pull' || method === 'message.v2.pull')
+                return await client._delivery.pullPeers(p, rpcBackground);
+            if (method === 'message.history')
+                return await client._v2E2EE.historyPeerV2(p);
+            if (method === 'message.ack' || method === 'message.v2.ack')
+                return await client._v2E2EE.ackPeerV2(p);
+        }
         const runWithRpcPriority = async (operation) => {
             if (!rpcBackground)
                 return await operation();
@@ -249,6 +268,7 @@ export class RpcPipeline {
                     messageId: String(p.message_id ?? '') || undefined,
                     timestamp: p.timestamp,
                     ttl: p.ttl,
+                    needRender: p.need_render !== false,
                     deviceId: String(p.device_id ?? '').trim() || String(p.to_device_id ?? '').trim() || undefined,
                     protectedHeaders: client._protectedHeadersFromParams(p),
                     context: isJsonObject(p.context) ? p.context : undefined,
@@ -266,6 +286,7 @@ export class RpcPipeline {
                     groupAid: String(p.group_aid ?? '').trim() || undefined,
                     messageId: String(p.message_id ?? '') || undefined,
                     timestamp: p.timestamp,
+                    needRender: p.need_render !== false,
                     protectedHeaders: client._protectedHeadersFromParams(p),
                     context: isJsonObject(p.context) ? p.context : undefined,
                 });
@@ -292,11 +313,15 @@ export class RpcPipeline {
         }
         const pullGateKey = this.pullGateKeyForCall(method, p);
         if (pullGateKey) {
-            return await this.runPullSerialized(pullGateKey, async () => await this.callImplInner(method, p, skipSendResultEnvelope, deferGroupReadyPostprocess, this.pullScopeKey(pullGateKey)), rpcBackground && this.pullGateBackgroundForCall(method, p));
+            if (method === 'group.history' || method === 'group.pull' || method === 'group.v2.pull') {
+                p._rpc_background = rpcBackground;
+                return await this.runPullNamespaceSerialized(pullGateKey, async () => await this.callImplInner(method, p, skipSendResultEnvelope, deferGroupReadyPostprocess, this.pullScopeKey(pullGateKey), onSent), rpcBackground && this.pullGateBackgroundForCall(method, p));
+            }
+            return await this.runPullSerialized(pullGateKey, async () => await this.callImplInner(method, p, skipSendResultEnvelope, deferGroupReadyPostprocess, this.pullScopeKey(pullGateKey), onSent), rpcBackground && this.pullGateBackgroundForCall(method, p));
         }
-        return await runWithRpcPriority(() => this.callImplInner(method, p, skipSendResultEnvelope, deferGroupReadyPostprocess));
+        return await runWithRpcPriority(() => this.callImplInner(method, p, skipSendResultEnvelope, deferGroupReadyPostprocess, undefined, onSent));
     }
-    async callImplInner(method, p, skipSendResultEnvelope = false, deferGroupReadyPostprocess = false, pullNamespace = '') {
+    async callImplInner(method, p, skipSendResultEnvelope = false, deferGroupReadyPostprocess = false, pullNamespace = '', onSent) {
         const client = this.runtime.client;
         if (method === 'message.v2.pull' || (method === 'message.pull' && hasMatchingV2Session(client))) {
             try {
@@ -340,12 +365,13 @@ export class RpcPipeline {
             await client._ensureV2SessionReady('group.pull');
             client._clientLog.debug(`call route: ${method} -> V2 pull`);
             if (p.window_mode === 'tail')
-                return await client._v2E2EE.pullGroupV2TailInternal(p);
+                return await client._v2E2EE.pullGroupV2TailInternal(p, false, true);
             const hasExplicitAfterSeq = 'after_seq' in p || 'after_message_seq' in p;
             const cursorParams = this.explicitGroupCursorParams(p);
             const ownsCursor = Object.keys(cursorParams).length === 0 || this.groupCursorTargetsCurrentInstance(cursorParams);
             const pullOpts = {
                 gateLocked: true,
+                background: p._rpc_background === true,
             };
             if (hasExplicitAfterSeq)
                 pullOpts.explicitAfterSeq = true;
@@ -378,16 +404,24 @@ export class RpcPipeline {
             }
             return await client._ackGroupV2((p.group_id ?? p.group_aid), (p.seq ?? p.msg_seq ?? p.up_to_seq), p.group_aid);
         }
+        const rpcBackground = p._rpc_foreground === true ? false
+            : (typeof p._rpc_background === 'boolean' ? p._rpc_background : client._backgroundRpcDepth > 0);
+        delete p._rpc_background;
+        delete p._rpc_foreground;
         await this.applyClientSignature(method, p);
         const callTimeout = NON_IDEMPOTENT_METHODS.has(method) ? NON_IDEMPOTENT_TIMEOUT : undefined;
-        const rpcBackground = client._backgroundRpcDepth > 0;
         const invokeTransport = () => {
-            const request = callTimeout
-                ? client._transport.call(method, p, callTimeout, undefined, rpcBackground)
-                : client._transport.call(method, p, undefined, undefined, rpcBackground);
+            const request = onSent
+                ? client._transport['_callWithSent'](method, p, onSent, callTimeout, undefined, rpcBackground)
+                : callTimeout
+                    ? client._transport.call(method, p, callTimeout, undefined, rpcBackground)
+                    : client._transport.call(method, p, undefined, undefined, rpcBackground);
             return this.bindActivePullCancellation(method, p, request);
         };
-        let result = await this.transportCallWithIdentityRecovery(invokeTransport, method, p);
+        const invoke = () => this.transportCallWithIdentityRecovery(invokeTransport, method, p);
+        let result = method === 'group.pull'
+            ? await this.runPullSerialized(this.pullGateKeyForCall(method, p), invoke, rpcBackground)
+            : await invoke();
         const sendResultModeSource = result;
         result = await this.postprocessResult(method, p, result, {
             skipGroupState: deferGroupReadyPostprocess,
@@ -408,7 +442,8 @@ export class RpcPipeline {
         }
         const p = { ...(params ?? {}) };
         this.mergeInstanceProtectedHeaders(method, p);
-        const rpcBackground = Boolean(p._rpc_background) || client._backgroundRpcDepth > 0;
+        const rpcBackground = Boolean(p._rpc_background)
+            || (!['message.peers', 'message.pull', 'message.v2.pull', 'group.pull', 'group.v2.pull', 'group.pull_events'].includes(method) && client._backgroundRpcDepth > 0);
         delete p._rpc_background;
         if (method === 'message.send' || method === 'group.send') {
             this.normalizeOutboundMessagePayload(p, method);
@@ -521,7 +556,7 @@ export class RpcPipeline {
         }
         params.device_id = client._deviceId;
         params.slot_id = client._slotId;
-        if ((method === 'message.pull' || method === 'message.v2.pull') && params.after_volatile_cursor === undefined) {
+        if (!client._p2pPeerPullEnabled && (method === 'message.pull' || method === 'message.v2.pull') && params.after_volatile_cursor === undefined) {
             const volatileCursor = client._delivery.volatilePullCursor();
             if (volatileCursor)
                 params.after_volatile_cursor = volatileCursor;
@@ -618,12 +653,18 @@ export class RpcPipeline {
         if (method === 'message.pull' || method === 'message.v2.pull' || method === 'message.history') {
             if (!client._aid)
                 return '';
+            const sender = String(params.sender_aid ?? params.peer_aid ?? '').trim();
+            if (client._p2pPeerPullEnabled && !sender)
+                return '';
+            const peerNamespace = sender && (client._p2pPeerPullEnabled || params.cursor_scope === 'peer')
+                ? `p2p.peer.v1/${btoa(String.fromCharCode(...new TextEncoder().encode(sender))).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')}`
+                : '';
             const mode = method === 'message.history' ? 'history' : params.window_mode === 'tail' ? 'tail' : 'forward';
             const cursor = mode === 'history'
                 ? `before=${String(params.before_seq)}`
                 : `after=${String(params.after_seq ?? 0)}`;
             const limit = mode === 'forward' ? (Number(params.limit ?? 50) || 50) : params.limit;
-            return `p2p:${client._aid}|mode=${mode}|cursor=${cursor}|volatile=${String(params.after_volatile_cursor ?? '')}|force=${String(Boolean(params.force))}|limit=${String(limit)}`;
+            return `${peerNamespace || `p2p:${client._aid}`}|mode=${mode}|cursor=${cursor}|volatile=${String(params.after_volatile_cursor ?? '')}|force=${String(Boolean(params.force))}|limit=${String(limit)}`;
         }
         if (method === 'group.pull' || method === 'group.v2.pull' || method === 'group.history') {
             const gid = String(params.group_id ?? params.group_aid ?? '').trim();
@@ -660,14 +701,15 @@ export class RpcPipeline {
         void key;
         return 'pull';
     }
-    pullGateState(key) {
-        const name = this.pullGateName(key);
+    pullGateState(key, namespaceOnly = false) {
+        const name = namespaceOnly ? 'pull-namespace' : this.pullGateName(key);
         let state = this.pullGateStates.get(name);
         if (!state) {
-            state = { activeByNamespace: new Map(), foreground: [], background: [], byKey: new Map(), lifecycle: new Map(), watchdog: null };
+            state = { networkLimited: !namespaceOnly, activeByNamespace: new Map(), foreground: [], background: [], byKey: new Map(), lifecycle: new Map(), watchdog: null, backgroundPeerDispatches: 0 };
             this.pullGateStates.set(name, state);
         }
-        this.startPullGateWatchdog(state, name);
+        if (state.networkLimited)
+            this.startPullGateWatchdog(state, name);
         return state;
     }
     pullGateOperationTimeoutMs() {
@@ -751,30 +793,29 @@ export class RpcPipeline {
     }
     hasPendingRealtimePull(ns) {
         const normalized = String(ns ?? '').trim();
-        if (!normalized || (!normalized.startsWith('p2p:') && !normalized.startsWith('group:')))
+        if (!normalized || (!isP2pNamespace(normalized) && !normalized.startsWith('group:')))
             return false;
         if (this.isPullResponseProcessing(normalized))
             return true;
-        const state = this.pullGateStates.get(this.pullGateName(normalized));
-        if (!state)
-            return false;
         const matches = (job) => {
             if (!job)
                 return false;
             return this.realtimePullNamespace(job.key) === normalized;
         };
-        return [...state.activeByNamespace.values()].some(matches)
+        return [...this.pullGateStates.values()].some((state) => [...state.activeByNamespace.values()].some(matches)
             || state.foreground.some(matches)
-            || state.background.some(matches);
+            || state.background.some(matches));
     }
     hasPullActivity(namespace, includePending = true) {
         const ns = String(namespace ?? '').trim();
-        if ((!ns.startsWith('p2p:') && !ns.startsWith('group:'))
+        if ((!isP2pNamespace(ns) && !ns.startsWith('group:') && !ns.startsWith('group_event:'))
             || this.inlineRealtimeScopes.has(ns))
             return true;
         const client = this.runtime.client;
         if ((client._pullResponseKeys?.get?.(ns) ?? 0) > 0)
             return true;
+        if (isP2pNamespace(ns) && client._v2E2EE?.hasPeerPageActivity?.(ns))
+            return true;
         const pendingP2p = client._pendingP2pPullUpper;
         const pendingGroup = client._pendingGroupPullUpper;
         if (includePending && ((pendingP2p?.get(ns) ?? 0) > 0 || (pendingGroup?.get(ns) ?? 0) > 0
@@ -782,7 +823,7 @@ export class RpcPipeline {
             return true;
         for (const marker of client._gapFillDone ?? []) {
             const value = String(marker ?? '').trim();
-            if (ns.startsWith('p2p:') && (value.startsWith('p2p_pull:') || value.startsWith('p2p_pull_retry:')))
+            if (isP2pNamespace(ns) && (value.startsWith(`p2p_pull:${ns}`) || value.startsWith(`p2p_pull_retry:${ns}`)))
                 return true;
             if (ns.startsWith('group:') && value.startsWith(`group_pull:${ns}`))
                 return true;
@@ -791,11 +832,9 @@ export class RpcPipeline {
             if (gate?.inflight && this.pullScopeKey(key) === ns)
                 return true;
         }
-        const state = this.pullGateStates.get(this.pullGateName(ns));
-        if (!state)
-            return false;
         const matches = (job) => job !== null && job.namespace === ns;
-        return [...state.activeByNamespace.values()].some(matches) || state.foreground.some(matches) || state.background.some(matches);
+        return [...this.pullGateStates.values()].some((state) => [...state.activeByNamespace.values()].some(matches)
+            || state.foreground.some(matches) || state.background.some(matches));
     }
     hasAnyPullActivity() {
         if (this.pullWorkTokens.size > 0)
@@ -825,7 +864,7 @@ export class RpcPipeline {
     }
     async tryRunInlineRealtime(ns, seq, operation) {
         const normalized = String(ns ?? '').trim();
-        if ((!normalized.startsWith('p2p:') && !normalized.startsWith('group:'))
+        if ((!isP2pNamespace(normalized) && !normalized.startsWith('group:'))
             || !Number.isSafeInteger(seq) || seq <= 0 || typeof operation !== 'function') {
             return { acquired: false };
         }
@@ -877,9 +916,11 @@ export class RpcPipeline {
             this.inlineRealtimeScopes.delete(normalized);
             if (state.activeByNamespace.get(normalized) === guard)
                 state.activeByNamespace.delete(normalized);
-            this.drainPullGate(state);
+            for (const queuedState of this.pullGateStates.values()) {
+                this.drainPullGate(queuedState);
+                this.armQueuedPullTimers(queuedState);
+            }
             this.runtime.client._delivery?.onPullGateIdle?.(normalized);
-            this.armQueuedPullTimers(state);
         }
     }
     tryAcquirePullGate(key) {
@@ -918,8 +959,10 @@ export class RpcPipeline {
         const ns = this.pullScopeKey(namespace);
         if (!ns)
             return true;
-        const active = this.pullGateStates.get(this.pullGateName(ns))?.activeByNamespace.get(ns);
-        return !active || active.namespace !== ns || (!active.timedOut && !active.invalidated);
+        return [...this.pullGateStates.values()].every((state) => {
+            const active = state.activeByNamespace.get(ns);
+            return !active || active.namespace !== ns || (!active.timedOut && !active.invalidated);
+        });
     }
     invalidatePulls() {
         if (this.pullInvalidationWait)
@@ -971,7 +1014,10 @@ export class RpcPipeline {
     pullInvalidationInProgress() {
         return this.pullInvalidationWait !== null;
     }
-    async runPullSerialized(key, operation, background = false) {
+    async runPullNamespaceSerialized(key, operation, background = false) {
+        return await this.runPullSerialized(key, operation, background, true);
+    }
+    async runPullSerialized(key, operation, background = false, namespaceOnly = false) {
         if (this.pullInvalidationInProgress()) {
             throw new Error('pull invalidated');
         }
@@ -989,7 +1035,7 @@ export class RpcPipeline {
                 releasePullWork();
             }
         }
-        const state = this.pullGateState(key);
+        const state = this.pullGateState(key, namespaceOnly);
         const namespace = this.pullScopeKey(key);
         const candidate = state.byKey.get(key);
         const existing = candidate && !candidate.timedOut && !candidate.invalidated ? candidate : null;
@@ -1025,7 +1071,8 @@ export class RpcPipeline {
         (background ? state.background : state.foreground).push(job);
         state.byKey.set(key, job);
         this.drainPullGate(state);
-        this.checkPullGate(state, this.pullGateName(key));
+        if (state.networkLimited)
+            this.checkPullGate(state, this.pullGateName(key));
         return await promise;
     }
     async executePullOperation(operation, background) {
@@ -1082,17 +1129,37 @@ export class RpcPipeline {
         state.lifecycle.set(ns, lifecycle);
     }
     drainPullGate(state) {
+        const peerForward = (job) => job.background && job.namespace.startsWith('p2p.peer.v1/')
+            && job.key.includes('|peer=background|') && job.key.includes('|tail=false|') && job.key.includes('|force=false|');
+        const priority = (job) => peerForward(job)
+            ? this.runtime.client._delivery?.peerBackgroundPullPriority?.(job.namespace) : undefined;
         const takeRunnable = (queue) => {
-            const index = queue.findIndex((candidate) => (!this.inlineRealtimeScopes.has(candidate.namespace)
+            let index = queue.findIndex((candidate) => (!this.inlineRealtimeScopes.has(candidate.namespace)
                 && !state.activeByNamespace.has(candidate.namespace)));
+            if (index >= 0 && queue === state.background && peerForward(queue[index])
+                && (state.backgroundPeerDispatches + 1) % _INTERNAL_MESSAGE_FLOW_LIMITS.pullMaxInflight !== 0) {
+                let best = priority(queue[index]);
+                if (best !== undefined)
+                    for (let next = index + 1; next < queue.length; next += 1) {
+                        const hint = priority(queue[next]);
+                        if (hint === undefined)
+                            break;
+                        if (!this.inlineRealtimeScopes.has(queue[next].namespace) && !state.activeByNamespace.has(queue[next].namespace) && hint < best) {
+                            index = next;
+                            best = hint;
+                        }
+                    }
+            }
             return index >= 0 ? queue.splice(index, 1)[0] : undefined;
         };
-        while (state.activeByNamespace.size < PULL_GATE_MAX_ACTIVE) {
+        while (state.activeByNamespace.size < _INTERNAL_MESSAGE_FLOW_LIMITS.pullMaxInflight) {
             const foregroundJob = takeRunnable(state.foreground);
             const foregroundDrained = foregroundJob !== undefined && state.foreground.length === 0;
             const job = foregroundJob ?? takeRunnable(state.background);
             if (!job)
                 break;
+            if (peerForward(job))
+                state.backgroundPeerDispatches = (state.backgroundPeerDispatches + 1) % _INTERNAL_MESSAGE_FLOW_LIMITS.pullMaxInflight;
             state.activeByNamespace.set(job.namespace, job);
             this.runtime.client._delivery?.onPullStarted?.(job.namespace);
             if (foregroundDrained)
@@ -1112,7 +1179,7 @@ export class RpcPipeline {
             }
             job.running = true;
             let failed = false;
-            void this.executePullOperation(job.operation, job.background).then((value) => { if (!job.timedOut && !job.invalidated)
+            void this.executePullOperation(job.operation, state.networkLimited && job.background).then((value) => { if (!job.timedOut && !job.invalidated)
                 job.resolve(value); }, (error) => {
                 failed = true;
                 if (!job.timedOut && !job.invalidated)
@@ -1139,8 +1206,10 @@ export class RpcPipeline {
     async rawCall(method, params, options) {
         const client = this.runtime.client;
         const payload = { ...(params ?? {}) };
-        const rpcBackground = Boolean(payload._rpc_background) || client._backgroundRpcDepth > 0 || options?.background === true;
+        const rpcBackground = options?.background ?? (!Boolean(payload._rpc_foreground)
+            && (Boolean(payload._rpc_background) || client._backgroundRpcDepth > 0));
         delete payload._rpc_background;
+        delete payload._rpc_foreground;
         const signed = options?.signed ?? true;
         if (signed || method.startsWith('org.')) {
             await this.applyClientSignature(method, payload);
@@ -1158,9 +1227,14 @@ export class RpcPipeline {
                 request = client._transport.call(method, payload);
             return this.bindActivePullCancellation(method, payload, request, options?.pullGateKey ?? '');
         };
-        const result = await this.transportCallWithIdentityRecovery(invokeTransport, method, payload);
-        this.throwIfPullInvalidated(this.pullScopeKey(options?.pullGateKey || this.pullGateKeyForCall(method, payload)));
-        return result;
+        try {
+            const result = await this.transportCallWithIdentityRecovery(invokeTransport, method, payload);
+            this.throwIfPullInvalidated(this.pullScopeKey(options?.pullGateKey || this.pullGateKeyForCall(method, payload)));
+            return result;
+        }
+        finally {
+            client._delivery?.requestBackgroundPullRecovery?.();
+        }
     }
     async transportCallWithIdentityRecovery(operation, method, params) {
         try {