@agentunion/fastaun 0.5.6 → 0.5.9

package/dist/client/v2-e2ee.js

@@ -18,6 +18,9 @@ function strictWindowSeq(value, field, positive = false) {
         throw new ValidationError(`${field} must be >= ${minimum}`);
     return value;
 }
+function safeNonNegativeSeq(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : null;
+}
 function strictWindowLimit(value) {
     const limit = strictWindowSeq(value, 'limit', true);
     if (limit > V2_PULL_MAX_PAGE_LIMIT)
@@ -50,19 +53,29 @@ function deduplicateForwardPageMessages(value, afterSeq) {
         if (!isJsonObject(raw))
             continue;
         const row = raw;
-        const seq = Number(row.seq ?? 0);
-        if (!Number.isSafeInteger(seq) || seq <= afterSeq || bySeq.has(seq))
+        const seq = safeNonNegativeSeq(row.seq);
+        if (seq === null || seq <= 0 || seq <= afterSeq || bySeq.has(seq))
             continue;
         bySeq.set(seq, row);
     }
     return [...bySeq.entries()].sort(([a], [b]) => a - b).map(([, row]) => row);
 }
-function validateTailPage(result, pageLimit) {
+function shouldContinueForwardPage({ rawCount, nextAfterSeq, nextAfter, limit, hasMoreField, hasMore, serverHead, pendingAckSeq, }) {
+    // 无新 seq 或游标未前进时必须停止，避免错误元数据造成循环。
+    if (rawCount <= 0 || nextAfter <= nextAfterSeq)
+        return false;
+    if (hasMore || serverHead > nextAfter || pendingAckSeq > 0)
+        return true;
+    // 仅旧服务缺失 has_more 时，以满页保留兼容续拉。
+    return !hasMoreField && limit > 0 && rawCount >= limit;
+}
+function validateTailPage(result, afterSeq, pageLimit) {
     if (!isJsonObject(result))
         throw new ValidationError('tail response must be an object');
     const row = result;
     if (row.window_mode !== 'tail')
         throw new ValidationError('tail response window_mode must equal tail');
+    strictWindowSeq(afterSeq, 'after_seq');
     const windowStart = strictWindowSeq(row.window_start_seq, 'window_start_seq');
     const head = strictWindowSeq(row.head_seq, 'head_seq');
     const covered = strictWindowSeq(row.covered_through_seq, 'covered_through_seq');
@@ -72,7 +85,21 @@ function validateTailPage(result, pageLimit) {
         throw new ValidationError('covered_through_seq must equal head_seq');
     if (head - windowStart + 1 > pageLimit)
         throw new ValidationError('tail proven window exceeds limit');
-    return { windowStart, head, messages: deduplicateWindowMessages(row.messages, windowStart, head, 'the proven tail window') };
+    let lowerSeq = windowStart;
+    if (head <= afterSeq) {
+        if (windowStart !== head)
+            throw new ValidationError('empty tail window must end at head_seq');
+        lowerSeq = head + 1;
+    }
+    else {
+        if (windowStart < afterSeq + 1)
+            throw new ValidationError('tail window_start_seq is below after_seq');
+        lowerSeq = Math.max(windowStart, afterSeq + 1);
+    }
+    const messages = deduplicateWindowMessages(row.messages, lowerSeq, head, 'the proven tail window');
+    if (head <= afterSeq && messages.length > 0)
+        throw new ValidationError('tail response must not include messages at or below after_seq');
+    return { windowStart, head, messages };
 }
 function validateHistoryPage(result, beforeSeq) {
     if (!isJsonObject(result))
@@ -257,12 +284,61 @@ export class V2E2EECoordinator {
     _initSessionPromise = null;
     targetSetCache = new Map();
     senderIKSyncFetches = new Map();
+    /** 服务端 ACK cursor 高于本地 A 时，延迟到下一次 Forward Pull 再恢复。 */
+    pendingForwardCursors = new Map();
+    /** 本地 A 已提交但服务端 ACK 尚未确认时，下一次 Forward Pull 必须继续推进。 */
+    pendingForwardAcks = new Map();
     constructor(runtime) {
         this.runtime = runtime;
     }
     get client() {
         return this.runtime.client;
     }
+    resetForwardCursorState() {
+        this.pendingForwardCursors.clear();
+        this.pendingForwardAcks.clear();
+    }
+    pendingForwardCursor(ns, localAck) {
+        if (!ns)
+            return 0;
+        const pending = this.pendingForwardCursors.get(ns) ?? 0;
+        if (pending <= localAck) {
+            if (pending > 0)
+                this.pendingForwardCursors.delete(ns);
+            return 0;
+        }
+        return pending;
+    }
+    recordForwardCursor(ns, cursor, localAck) {
+        if (!ns || !Number.isSafeInteger(cursor) || cursor <= localAck)
+            return;
+        this.pendingForwardCursors.set(ns, Math.max(this.pendingForwardCursors.get(ns) ?? 0, cursor));
+    }
+    clearForwardCursor(ns, committedAck) {
+        const pending = this.pendingForwardCursors.get(ns) ?? 0;
+        if (pending > 0 && committedAck >= pending)
+            this.pendingForwardCursors.delete(ns);
+    }
+    pendingForwardAck(ns, localAck) {
+        if (!ns)
+            return 0;
+        const pending = this.pendingForwardAcks.get(ns) ?? 0;
+        if (!Number.isSafeInteger(pending) || pending <= 0 || localAck <= 0 || pending > localAck) {
+            this.pendingForwardAcks.delete(ns);
+            return 0;
+        }
+        return pending;
+    }
+    recordForwardAck(ns, ackSeq) {
+        if (!ns || !Number.isSafeInteger(ackSeq) || ackSeq <= 0)
+            return;
+        this.pendingForwardAcks.set(ns, Math.max(this.pendingForwardAcks.get(ns) ?? 0, ackSeq));
+    }
+    clearForwardAck(ns, confirmedSeq) {
+        const pending = this.pendingForwardAcks.get(ns) ?? 0;
+        if (pending > 0 && confirmedSeq >= pending)
+            this.pendingForwardAcks.delete(ns);
+    }
     get bootstrapCache() {
         const client = this.client;
         if (!(client._v2BootstrapCache instanceof Map)) {
@@ -590,7 +666,8 @@ export class V2E2EECoordinator {
             createdAt: Date.now(),
         });
         client._clientLog.debug(`V2 decrypt pending sender IK: key=${messageKey} from=${fromAid} device=${senderDeviceId || '-'} group=${groupId || '<p2p>'} pending=${client._v2SenderIKPending.size}`);
-        this.scheduleSenderIKFetch(fromAid, senderDeviceId, groupId);
+        if (args.startFetch !== false)
+            this.scheduleSenderIKFetch(fromAid, senderDeviceId, groupId);
     }
     scheduleSenderIKFetch(fromAid, senderDeviceId, groupId) {
         const client = this.client;
@@ -644,8 +721,9 @@ export class V2E2EECoordinator {
             const pendingItems = [...client._v2SenderIKPending.entries()].filter(([, entry]) => entry.fromAid === fromAid && entry.senderDeviceId === senderDeviceId && entry.groupId === groupId);
             for (const [key, entry] of pendingItems) {
                 let plaintext = null;
+                const retryStatus = {};
                 try {
-                    plaintext = await client._decryptV2Message(entry.msg, false);
+                    plaintext = await client._decryptV2Message(entry.msg, false, true, true, true, retryStatus);
                 }
                 catch (exc) {
                     client._clientLog.warn(`V2 sender IK pending retry raised: key=${key} err=${formatE2EEError(exc)}`);
@@ -653,6 +731,10 @@ export class V2E2EECoordinator {
                     continue;
                 }
                 if (plaintext === null) {
+                    if (retryStatus.deferred) {
+                        client._clientLog.warn(`V2 pending retry still missing key material: key=${key}`);
+                        continue;
+                    }
                     client._clientLog.warn(`V2 sender IK pending retry still undecryptable: key=${key}`);
                     const isGroup = Boolean(entry.groupId);
                     const eventName = isGroup ? 'group.message_undecryptable' : 'message.undecryptable';
@@ -904,7 +986,7 @@ export class V2E2EECoordinator {
             history_error: { code: 'decrypt_failed', message: reason },
         };
     }
-    async decodeP2PWindowMessage(msg, publish, history, source) {
+    async decodeP2PWindowMessage(msg, publish, history, source, orderedPublish = false) {
         const client = this.client;
         const seq = strictWindowSeq(msg.seq, 'messages[].seq', true);
         let plaintext = null;
@@ -939,16 +1021,27 @@ export class V2E2EECoordinator {
         }
         if (publish) {
             const event = client._delivery.p2pAppEventForMessage(plaintext);
-            await client._publishAppEvent(event.event, event.payload, source);
+            if (orderedPublish) {
+                await client._delivery.publishOrderedMessage(event.event, client._aid ? `p2p:${client._aid}` : '', seq, event.payload);
+            }
+            else {
+                await client._publishAppEvent(event.event, event.payload, source);
+            }
         }
         return plaintext;
     }
-    async decodeGroupWindowMessage(msg, groupId, groupAid, publish, history, source) {
+    async decodeGroupWindowMessage(msg, groupId, groupAid, publish, history, source, orderedPublish = false) {
         const client = this.client;
         const seq = strictWindowSeq(msg.seq, 'messages[].seq', true);
         let plaintext = null;
         if (String(msg.version ?? '') === 'v1') {
             const payload = msg.payload;
+            if (payload === undefined || payload === null) {
+                if (history)
+                    return this.historyDecryptFailure(msg, 'legacy payload is missing');
+                client._clientLog.warn(`Group Tail 缺少 payload 的 V1 行已跳过，连续性证明仍保留: group=${groupId}, seq=${seq}`);
+                return null;
+            }
             if (isJsonObject(payload)
                 && ['e2ee.encrypted', 'e2ee.group_encrypted'].includes(String(payload.type ?? ''))) {
                 if (history)
@@ -984,8 +1077,14 @@ export class V2E2EECoordinator {
             client._clientLog.warn(`Group Tail 单条消息解密失败，连续性证明仍保留: group=${groupId}, seq=${seq}`);
             return null;
         }
-        if (publish)
-            await client._publishAppEvent('group.message_created', plaintext, source);
+        if (publish) {
+            if (orderedPublish) {
+                await client._delivery.publishOrderedMessage('group.message_created', `group:${groupId}`, seq, plaintext);
+            }
+            else {
+                await client._publishAppEvent('group.message_created', plaintext, source);
+            }
+        }
         return plaintext;
     }
     async applyTailFloor(ns, floor) {
@@ -994,9 +1093,9 @@ export class V2E2EECoordinator {
             return;
         client._seqTracker.forceContiguousSeq(ns, floor);
         client._persistSeq(ns);
-        client._saveSeqTrackerState?.();
+        await client._saveSeqTrackerState?.();
     }
-    async pullV2TailInternal(params) {
+    async pullV2TailInternal(params, deferPublish = false) {
         const client = this.client;
         if (params.window_mode !== 'tail')
             throw new ValidationError('window_mode must equal tail');
@@ -1009,7 +1108,7 @@ export class V2E2EECoordinator {
         const floor = Number(result.retention_floor_seq ?? 0);
         const previous = ns ? client._seqTracker.getSyncState(ns) : null;
         await this.applyTailFloor(ns, Number.isSafeInteger(floor) ? floor : 0);
-        const page = validateTailPage(result, limit);
+        const page = validateTailPage(result, afterSeq, limit);
         if (ns) {
             client._seqTracker.commitTailWindow(ns, {
                 windowStartSeq: page.windowStart,
@@ -1018,11 +1117,11 @@ export class V2E2EECoordinator {
                 pageLimit: limit,
             });
             client._persistSeq(ns);
-            client._saveSeqTrackerState?.();
+            await client._saveSeqTrackerState?.();
         }
         const decoded = [];
         for (const msg of page.messages) {
-            const plaintext = await this.decodeP2PWindowMessage(msg, true, false, 'tail');
+            const plaintext = await this.decodeP2PWindowMessage(msg, true, false, 'tail', deferPublish);
             if (plaintext)
                 decoded.push(plaintext);
         }
@@ -1067,13 +1166,18 @@ export class V2E2EECoordinator {
         }
         const decrypted = [];
         let nextAfterSeq = opts?.force ? afterSeq : (afterSeq || (ns ? client._seqTracker.getContiguousSeq(ns) : 0));
+        let pullGateKey = ns
+            ? `${ns}|forward|after=${afterSeq}|force=${String(Boolean(opts?.force))}|limit=${limit}`
+            : '';
+        const deferredServerCursor = ns ? this.pendingForwardCursor(ns, ns ? client._seqTracker.getContiguousSeq(ns) : 0) : 0;
+        const deferredForwardAck = ns ? this.pendingForwardAck(ns, client._seqTracker.getContiguousSeq(ns)) : 0;
         let pageCount = 0;
         let lastAutoAckSeq = 0;
-        let pendingAckSeq = 0;
+        let pendingAckSeq = deferredForwardAck;
         const maxPages = Math.max(1, Math.min(100, Math.trunc(Number(opts?.maxPages ?? 100) || 100)));
         while (pageCount < maxPages) {
             pageCount += 1;
-            const ackUpToSeq = opts?.skipAutoAck ? 0 : pendingAckSeq;
+            const ackUpToSeq = pendingAckSeq;
             const inlineAckGeneration = ackUpToSeq > 0
                 ? client._delivery.captureP2PInlineAckGeneration()
                 : null;
@@ -1085,15 +1189,29 @@ export class V2E2EECoordinator {
                 ...(ackUpToSeq > 0 ? { ack_up_to_seq: ackUpToSeq } : {}),
             });
             if (ackUpToSeq > 0) {
-                if (inlineAckGeneration !== null) {
-                    client._delivery.onP2PV2PullAckResult(result, ackUpToSeq, inlineAckGeneration);
+                const actualAckSeq = client._delivery.resolveP2PPullAckSeq(result, ackUpToSeq);
+                if (actualAckSeq >= ackUpToSeq) {
+                    if (inlineAckGeneration !== null) {
+                        client._delivery.onP2PV2PullAckResult(result, ackUpToSeq, inlineAckGeneration);
+                    }
+                    pendingAckSeq = 0;
+                    lastAutoAckSeq = Math.max(lastAutoAckSeq, ackUpToSeq);
+                    this.clearForwardAck(ns, ackUpToSeq);
+                }
+                else {
+                    client._clientLog.warn(`message.v2.pull piggyback ACK below target: requested=${ackUpToSeq}, actual=${actualAckSeq}; fallback terminal ACK`);
+                    await this.confirmForwardP2PAck(ackUpToSeq);
+                    pendingAckSeq = 0;
+                    lastAutoAckSeq = Math.max(lastAutoAckSeq, ackUpToSeq);
                 }
-                pendingAckSeq = 0;
-                lastAutoAckSeq = Math.max(lastAutoAckSeq, ackUpToSeq);
             }
             const pageMessages = (Array.isArray(result?.messages) ? result.messages : []);
             const messages = deduplicateForwardPageMessages(pageMessages, nextAfterSeq);
-            client._clientLog.debug(`message.v2.pull page response: page=${pageCount}, raw_count=${messages.length}, stale_count=${Math.max(0, pageMessages.length - messages.length)}, has_more=${String(result.has_more ?? '')}, server_ack_seq=${String(result.server_ack_seq ?? '')}`);
+            const cursor = isJsonObject(result.cursor) ? result.cursor : null;
+            const hasMoreField = Object.prototype.hasOwnProperty.call(result, 'has_more');
+            const hasMore = result.has_more === true;
+            const serverHead = safeNonNegativeSeq(cursor?.latest_seq) ?? 0;
+            client._clientLog.debug(`message.v2.pull page response: page=${pageCount}, raw_count=${messages.length}, stale_count=${Math.max(0, pageMessages.length - messages.length)}, has_more=${String(result.has_more ?? '')}, server_head=${serverHead}, server_ack_seq=${String(result.server_ack_seq ?? '')}`);
             for (const msg of messages) {
                 client._logMessageDebug('pull-raw', 'message.v2.pull', 'message.received', msg);
             }
@@ -1108,6 +1226,8 @@ export class V2E2EECoordinator {
             if (seqs.length > 0) {
                 pageMaxSeq = Math.max(...seqs);
             }
+            const deferredKeyFetches = new Map();
+            let blockedSeq = 0;
             for (const msg of messages) {
                 const seq = Number(msg.seq ?? 0);
                 if (!Number.isFinite(seq) || seq <= 0)
@@ -1133,7 +1253,7 @@ export class V2E2EECoordinator {
                         attachGatewayProximity(v1Msg, msg);
                         const appEvent = client._delivery.p2pAppEventForMessage(v1Msg);
                         if (ns) {
-                            await client._publishPulledMessage(appEvent.event, ns, seq, appEvent.payload);
+                            await client._publishPulledMessage(appEvent.event, ns, seq, appEvent.payload, false);
                         }
                         else {
                             await client._publishAppEvent(appEvent.event, appEvent.payload, 'pull');
@@ -1154,13 +1274,25 @@ export class V2E2EECoordinator {
                 if (spkId && client._v2Session && !client._v2Session.isCurrentSPK(spkId)) {
                     client._v2Session.trackOldSPKMaxSeq(spkId, seq);
                 }
-                const plaintext = await client._decryptV2Message(msg);
+                const deferStatus = {};
+                const plaintext = await client._decryptV2Message(msg, true, true, true, true, deferStatus, true);
+                if (deferStatus.deferred) {
+                    blockedSeq = blockedSeq > 0 ? Math.min(blockedSeq, seq) : seq;
+                }
+                if (deferStatus.deferred && deferStatus.fromAid) {
+                    const key = `${deferStatus.fromAid}\u0000${deferStatus.senderDeviceId ?? ''}\u0000${deferStatus.groupId ?? ''}`;
+                    deferredKeyFetches.set(key, {
+                        fromAid: deferStatus.fromAid,
+                        senderDeviceId: deferStatus.senderDeviceId ?? '',
+                        groupId: deferStatus.groupId ?? '',
+                    });
+                }
                 if (plaintext === null) {
                     client._clientLog.debug(`message.v2.pull decrypt returned null: seq=${seq}, ns=${ns || '<none>'}`);
                     continue;
                 }
                 if (ns) {
-                    await client._publishPulledMessage('message.received', ns, seq, plaintext);
+                    await client._publishPulledMessage('message.received', ns, seq, plaintext, false);
                 }
                 else {
                     await client._publishAppEvent('message.received', plaintext, 'pull');
@@ -1169,10 +1301,11 @@ export class V2E2EECoordinator {
                 client._logMessageDebug('decrypt-ok', 'message.v2.pull', 'message.received', plaintext);
             }
             const hasServerAckSeq = Object.prototype.hasOwnProperty.call(result, 'server_ack_seq');
-            const serverAckSeq = Number(result.server_ack_seq ?? 0);
+            const parsedServerAckSeq = hasServerAckSeq ? safeNonNegativeSeq(result.server_ack_seq) : null;
+            const serverAckSeq = parsedServerAckSeq ?? 0;
             const retentionFloor = Math.max(0, Number(result.retention_floor_seq ?? 0));
             if (ns) {
-                const commitTarget = Math.max(pageContigBefore, Number.isFinite(retentionFloor) ? retentionFloor : 0, seqs.length > 0 ? pageMaxSeq : pageContigBefore);
+                const commitTarget = Math.max(pageContigBefore, Number.isFinite(retentionFloor) ? retentionFloor : 0, pageCount === 1 ? deferredServerCursor : 0, blockedSeq > 0 ? blockedSeq - 1 : (seqs.length > 0 ? pageMaxSeq : pageContigBefore));
                 let ackSeq = pageContigBefore;
                 let contigAdvanced = false;
                 try {
@@ -1181,6 +1314,9 @@ export class V2E2EECoordinator {
                         if (retentionFloor > pageContigBefore) {
                             client._clientLog.info(`message.v2.pull retention-floor advance: ns=${ns} contiguous=${pageContigBefore} -> retention_floor_seq=${retentionFloor}`);
                         }
+                        if (deferredServerCursor > pageContigBefore && pageCount === 1) {
+                            client._clientLog.info(`message.v2.pull restore local A from deferred server ACK cursor: ns=${ns}, contiguous=${pageContigBefore} -> server_ack_seq=${deferredServerCursor}`);
+                        }
                         if (seqs.length > 0) {
                             client._clientLog.debug(`message.v2.pull force contiguous: ns=${ns}, page_max_seq=${pageMaxSeq}, previous=${pageContigBefore}`);
                         }
@@ -1188,10 +1324,9 @@ export class V2E2EECoordinator {
                     ackSeq = client._seqTracker.getContiguousSeq(ns);
                     contigAdvanced = ackSeq !== pageContigBefore;
                     if (contigAdvanced) {
-                        await client._drainOrderedMessages(ns, undefined, true);
-                        ackSeq = client._seqTracker.getContiguousSeq(ns);
-                        contigAdvanced = ackSeq !== pageContigBefore;
-                        client._commitSeqTrackerState(ns);
+                        await client._commitSeqTrackerState(ns);
+                        if (pageCount === 1 && deferredServerCursor > 0)
+                            this.clearForwardCursor(ns, ackSeq);
                     }
                 }
                 catch (exc) {
@@ -1201,14 +1336,27 @@ export class V2E2EECoordinator {
                     client._clientLog.error?.(`message.v2.pull Forward commit rolled back: ns=${ns} target=${commitTarget} error=${formatE2EEError(exc)}`);
                     throw exc;
                 }
-                const ackNeeded = pageMessages.length > 0
-                    && ackSeq > 0
+                if (contigAdvanced)
+                    await client._drainOrderedMessages(ns, undefined, false, false);
+                for (const fetch of deferredKeyFetches.values()) {
+                    this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
+                }
+                if (parsedServerAckSeq !== null && serverAckSeq > ackSeq) {
+                    this.recordForwardCursor(ns, serverAckSeq, ackSeq);
+                }
+                // 无本页服务端水位时，只有本页成功提交了比已知服务端更高的 A
+                // 才新增 ACK 义务。空页不能仅因本地已有 A 而重复 ACK。
+                const knownServerAckSeq = hasServerAckSeq
+                    ? serverAckSeq
+                    : (pageCount === 1 ? deferredServerCursor : 0);
+                const ackNeeded = ackSeq > 0
                     && ackSeq > lastAutoAckSeq
-                    && !opts?.skipAutoAck
-                    && (contigAdvanced || (hasServerAckSeq && ackSeq > serverAckSeq));
+                    && ((hasServerAckSeq && ackSeq > serverAckSeq)
+                        || (contigAdvanced && ackSeq > knownServerAckSeq));
                 if (ackNeeded) {
+                    this.recordForwardAck(ns, ackSeq);
                     const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
-                    const canContinuePage = messages.length > 0 && nextAfter > nextAfterSeq;
+                    const canContinuePage = blockedSeq <= 0 && messages.length > 0 && nextAfter > nextAfterSeq;
                     if (canContinuePage) {
                         pendingAckSeq = Math.max(pendingAckSeq, ackSeq);
                         lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
@@ -1216,18 +1364,35 @@ export class V2E2EECoordinator {
                     }
                     else {
                         client._clientLog.debug(`message.v2.pull sending terminal auto-ack: ns=${ns}, ack_seq=${ackSeq}, raw_count=${messages.length}`);
-                        await this.ackV2(ackSeq);
+                        await this.confirmForwardP2PAck(ackSeq);
                         lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
                     }
                 }
             }
+            if (!ns) {
+                for (const fetch of deferredKeyFetches.values()) {
+                    this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
+                }
+            }
             const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
             const rawCount = messages.length;
-            const canContinuePage = rawCount > 0 && nextAfter > nextAfterSeq;
-            const fullPage = canContinuePage && limit > 0 && rawCount >= limit;
-            const shouldContinue = canContinuePage && (fullPage || pendingAckSeq > 0);
+            const shouldContinue = shouldContinueForwardPage({
+                rawCount,
+                nextAfterSeq,
+                nextAfter,
+                limit,
+                hasMoreField,
+                hasMore,
+                serverHead,
+                pendingAckSeq,
+            });
             if (!shouldContinue)
                 break;
+            if (pullGateKey && opts?.gateLocked && client._rpcPipeline?.yieldPullGate) {
+                const nextKey = `${ns}|forward|after=${nextAfter}|force=${String(Boolean(opts?.force))}|limit=${limit}`;
+                await client._rpcPipeline.yieldPullGate(pullGateKey, nextKey, true);
+                pullGateKey = nextKey;
+            }
             const tailDelayMs = v2PullTailDelayMs(rawCount, limit);
             if (tailDelayMs > 0)
                 await v2Sleep(tailDelayMs);
@@ -1237,14 +1402,35 @@ export class V2E2EECoordinator {
             client._clientLog.warn(`message.v2.pull reached max_pages=${maxPages} after_seq=${nextAfterSeq}`);
             if (pendingAckSeq > 0) {
                 client._clientLog.debug(`message.v2.pull flushing pending auto-ack after max_pages: ns=${ns}, ack_seq=${pendingAckSeq}`);
-                await this.ackV2(pendingAckSeq);
+                await this.confirmForwardP2PAck(pendingAckSeq);
                 pendingAckSeq = 0;
             }
         }
         client._clientLog.debug(`message.v2.pull done: requested_after_seq=${afterSeq}, pages=${pageCount}, decrypted=${decrypted.length}, ns=${ns || '<none>'}`);
         return decrypted;
     }
+    async confirmForwardP2PAck(upToSeq) {
+        const ns = this.client._aid ? `p2p:${this.client._aid}` : '';
+        try {
+            const result = await this.ackV2ForForward(upToSeq);
+            const actualAckSeq = this.client._delivery.resolveForwardAckSeq(result, upToSeq);
+            if (actualAckSeq < upToSeq) {
+                throw new E2EEError(`message.v2.ack server ACK watermark ${actualAckSeq} is below requested ${upToSeq}`);
+            }
+            this.clearForwardAck(ns, upToSeq);
+        }
+        catch (exc) {
+            this.recordForwardAck(ns, upToSeq);
+            throw exc;
+        }
+    }
     async ackV2(upToSeq) {
+        return this.ackV2WithConfirmation(upToSeq, false);
+    }
+    async ackV2ForForward(upToSeq) {
+        return this.ackV2WithConfirmation(upToSeq, true);
+    }
+    async ackV2WithConfirmation(upToSeq, requireServerWatermark) {
         const client = this.client;
         const ns = client._aid ? `p2p:${client._aid}` : '';
         let seq = Number(upToSeq ?? (ns ? client._seqTracker.getContiguousSeq(ns) : 0));
@@ -1263,7 +1449,12 @@ export class V2E2EECoordinator {
         const result = isJsonObject(raw)
             ? { ...raw }
             : { result: raw };
-        const actualAckSeq = client._delivery.resolveActualAckSeq(result, seq);
+        const actualAckSeq = requireServerWatermark
+            ? client._delivery.resolveForwardAckSeq(result, seq)
+            : client._delivery.resolveActualAckSeq(result, seq);
+        if (requireServerWatermark && actualAckSeq < seq) {
+            throw new E2EEError(`message.v2.ack server ACK watermark ${actualAckSeq} is below requested ${seq}`);
+        }
         result.ack_seq = actualAckSeq;
         result.success = true;
         if (inlineAckGeneration !== null) {
@@ -1319,7 +1510,7 @@ export class V2E2EECoordinator {
             client._clientLog.debug(`group.v2.send ok: group=${gid}, use_cache=${useCache}, seq=${String((isJsonObject(result) ? result.seq : '') ?? '')}`);
             return result;
         };
-        const markSentSeq = (result) => {
+        const markSentSeq = async (result) => {
             if (!isJsonObject(result))
                 return;
             const obj = result;
@@ -1329,12 +1520,12 @@ export class V2E2EECoordinator {
             const ns = `group:${gid}`;
             client._seqTracker.onMessageSeq(ns, seq);
             client._markPublishedSeq(ns, seq);
-            client._saveSeqTrackerState();
+            await client._saveSeqTrackerState();
             client._clientLog.debug(`group.v2.send marked own seq: group=${gid}, ns=${ns}, seq=${seq}`);
         };
         try {
             const result = await attempt(true);
-            markSentSeq(result);
+            await markSentSeq(result);
             return client._delivery.attachSendResultEnvelope('group.send', withExplicitGroupAid({
                 group_id: gid,
                 payload,
@@ -1350,7 +1541,7 @@ export class V2E2EECoordinator {
                 client._clientLog.debug(`V2 group speculative send rejected (code=${String(excCode)}), refreshing bootstrap`);
                 this.deleteBootstrapCacheEntry(`group:${gid}`);
                 const result = await attempt(false);
-                markSentSeq(result);
+                await markSentSeq(result);
                 return client._delivery.attachSendResultEnvelope('group.send', withExplicitGroupAid({
                     group_id: gid,
                     payload,
@@ -1509,7 +1700,7 @@ export class V2E2EECoordinator {
         });
         return envelope;
     }
-    async pullGroupV2TailInternal(params) {
+    async pullGroupV2TailInternal(params, deferPublish = false) {
         const client = this.client;
         if (params.window_mode !== 'tail')
             throw new ValidationError('window_mode must equal tail');
@@ -1535,7 +1726,7 @@ export class V2E2EECoordinator {
         const floor = Number(result.retention_floor_message_seq ?? result.retention_floor_seq ?? 0);
         const previous = client._seqTracker.getSyncState(ns);
         await this.applyTailFloor(ns, Number.isSafeInteger(floor) ? floor : 0);
-        const page = validateTailPage(result, limit);
+        const page = validateTailPage(result, afterSeq, limit);
         client._seqTracker.commitTailWindow(ns, {
             windowStartSeq: page.windowStart,
             headSeq: page.head,
@@ -1543,10 +1734,11 @@ export class V2E2EECoordinator {
             pageLimit: limit,
         });
         client._persistSeq(ns);
-        client._saveSeqTrackerState?.();
+        await client._saveSeqTrackerState?.();
         const decoded = [];
         for (const msg of page.messages) {
-            const plaintext = await this.decodeGroupWindowMessage(msg, groupId, groupAid, true, false, 'tail');
+            client._logMessageDebug('tail-raw', 'group.v2.pull', 'group.message_created', msg);
+            const plaintext = await this.decodeGroupWindowMessage(msg, groupId, groupAid, true, false, 'tail', deferPublish);
             if (plaintext)
                 decoded.push(plaintext);
         }
@@ -1625,12 +1817,19 @@ export class V2E2EECoordinator {
         const wireGroupId = String(opts?.wireGroupId ?? groupId ?? '').trim() || gid;
         const cursorParams = opts?.cursorParams ?? {};
         const ownsCursor = opts?.ownsCursor !== false;
+        let pullGateKey = ownsCursor
+            ? `${ns}|forward|after=${afterSeq}|force=${String(Boolean(opts?.force))}|limit=${limit}`
+            : '';
         let nextAfterSeq = (opts?.explicitAfterSeq || opts?.force)
             ? afterSeq
             : (afterSeq || client._seqTracker.getContiguousSeq(ns));
+        const deferredServerCursor = ownsCursor
+            ? this.pendingForwardCursor(ns, client._seqTracker.getContiguousSeq(ns))
+            : 0;
+        const deferredForwardAck = ownsCursor ? this.pendingForwardAck(ns, client._seqTracker.getContiguousSeq(ns)) : 0;
         let pageCount = 0;
         let lastAutoAckSeq = 0;
-        let pendingAckSeq = 0;
+        let pendingAckSeq = deferredForwardAck;
         const maxPages = Math.max(1, Math.min(100, Math.trunc(Number(opts?.maxPages ?? 100) || 100)));
         while (pageCount < maxPages) {
             pageCount += 1;
@@ -1648,11 +1847,21 @@ export class V2E2EECoordinator {
                 ...(ackUpToSeq > 0 ? { ack_up_to_seq: ackUpToSeq } : {}),
             }, groupAid));
             if (ackUpToSeq > 0) {
-                if (inlineAckGeneration !== null) {
-                    client._delivery.onGroupV2PullAckResult(gid, result, ackUpToSeq, inlineAckGeneration);
+                const actualAckSeq = client._delivery.resolveGroupPullAckSeq(result, ackUpToSeq);
+                if (actualAckSeq >= ackUpToSeq) {
+                    if (inlineAckGeneration !== null) {
+                        client._delivery.onGroupV2PullAckResult(gid, result, ackUpToSeq, inlineAckGeneration);
+                    }
+                    pendingAckSeq = 0;
+                    lastAutoAckSeq = Math.max(lastAutoAckSeq, ackUpToSeq);
+                    this.clearForwardAck(ns, ackUpToSeq);
+                }
+                else {
+                    client._clientLog.warn(`group.v2.pull piggyback ACK below target: group=${gid}, requested=${ackUpToSeq}, actual=${actualAckSeq}; fallback terminal ACK`);
+                    await this.confirmForwardGroupAck(gid, ackUpToSeq, groupAid);
+                    pendingAckSeq = 0;
+                    lastAutoAckSeq = Math.max(lastAutoAckSeq, ackUpToSeq);
                 }
-                pendingAckSeq = 0;
-                lastAutoAckSeq = Math.max(lastAutoAckSeq, ackUpToSeq);
             }
             const resultGroupAid = String(result.group_aid ?? result.groupAid ?? '').trim();
             if (resultGroupAid)
@@ -1661,7 +1870,10 @@ export class V2E2EECoordinator {
             const pageMessages = (Array.isArray(result.messages) ? result.messages : []);
             const messages = deduplicateForwardPageMessages(pageMessages, nextAfterSeq);
             const cursor = isJsonObject(result.cursor) ? result.cursor : null;
-            client._clientLog.debug(`group.v2.pull page response: group=${gid}, page=${pageCount}, raw_count=${messages.length}, stale_count=${Math.max(0, pageMessages.length - messages.length)}, has_more=${String(result.has_more ?? '')}, cursor_current=${String(cursor?.current_seq ?? '')}`);
+            const hasMoreField = Object.prototype.hasOwnProperty.call(result, 'has_more');
+            const hasMore = result.has_more === true;
+            const serverHead = Math.max(safeNonNegativeSeq(result.latest_message_seq) ?? 0, safeNonNegativeSeq(cursor?.latest_seq) ?? 0);
+            client._clientLog.debug(`group.v2.pull page response: group=${gid}, page=${pageCount}, raw_count=${messages.length}, stale_count=${Math.max(0, pageMessages.length - messages.length)}, has_more=${String(result.has_more ?? '')}, server_head=${serverHead}, cursor_current=${String(cursor?.current_seq ?? '')}`);
             for (const msg of messages) {
                 client._logMessageDebug('pull-raw', 'group.v2.pull', 'group.message_created', msg);
             }
@@ -1676,6 +1888,8 @@ export class V2E2EECoordinator {
             if (seqs.length > 0) {
                 pageMaxSeq = Math.max(...seqs);
             }
+            const deferredKeyFetches = new Map();
+            let blockedSeq = 0;
             for (const msg of messages) {
                 const seq = Number(msg.seq ?? 0);
                 if (!Number.isFinite(seq) || seq <= 0)
@@ -1711,7 +1925,7 @@ export class V2E2EECoordinator {
                             };
                             v1Msg = normalizeGroupMentionMode(v1Msg, msg, msg.envelope_json);
                             attachGatewayProximity(v1Msg, msg);
-                            await client._publishPulledMessage('group.message_created', ns, seq, v1Msg);
+                            await client._publishPulledMessage('group.message_created', ns, seq, v1Msg, false);
                             decrypted.push(v1Msg);
                             client._clientLog.debug(`group.v2.pull plaintext V1 delivered: group=${gid}, seq=${seq}`);
                             continue;
@@ -1731,7 +1945,7 @@ export class V2E2EECoordinator {
                         };
                         v1Msg = normalizeGroupMentionMode(v1Msg, msg, msg.envelope_json);
                         attachGatewayProximity(v1Msg, msg);
-                        await client._publishPulledMessage('group.message_created', ns, seq, v1Msg);
+                        await client._publishPulledMessage('group.message_created', ns, seq, v1Msg, false);
                         decrypted.push(v1Msg);
                         client._clientLog.debug(`group.v2.pull plaintext V1 delivered: group=${gid}, seq=${seq}`);
                         continue;
@@ -1743,7 +1957,19 @@ export class V2E2EECoordinator {
                     client._clientLog.debug(`group.v2.pull skipping non-V2 row group=${gid} seq=${seq} version=${String(msg.version ?? '')}`);
                     continue;
                 }
-                let plaintext = await client._decryptV2Message(msg);
+                const deferStatus = {};
+                let plaintext = await client._decryptV2Message(msg, true, true, true, true, deferStatus, true);
+                if (deferStatus.deferred) {
+                    blockedSeq = blockedSeq > 0 ? Math.min(blockedSeq, seq) : seq;
+                }
+                if (deferStatus.deferred && deferStatus.fromAid) {
+                    const key = `${deferStatus.fromAid}\u0000${deferStatus.senderDeviceId ?? ''}\u0000${deferStatus.groupId ?? ''}`;
+                    deferredKeyFetches.set(key, {
+                        fromAid: deferStatus.fromAid,
+                        senderDeviceId: deferStatus.senderDeviceId ?? '',
+                        groupId: deferStatus.groupId ?? '',
+                    });
+                }
                 if (plaintext === null) {
                     client._clientLog.debug(`group.v2.pull decrypt returned null: group=${gid}, seq=${seq}`);
                     continue;
@@ -1751,52 +1977,71 @@ export class V2E2EECoordinator {
                 plaintext = normalizeGroupMentionMode(plaintext, msg, msg.envelope_json);
                 plaintext.group_id = gid;
                 plaintext.group_aid = eventGroupAid;
-                await client._publishPulledMessage('group.message_created', ns, seq, plaintext);
+                await client._publishPulledMessage('group.message_created', ns, seq, plaintext, false);
                 decrypted.push(plaintext);
                 client._logMessageDebug('decrypt-ok', 'group.v2.pull', 'group.message_created', plaintext);
             }
-            const cursorCurrentSeq = Number(cursor?.current_seq ?? 0);
             const hasServerCursor = cursor !== null && Object.prototype.hasOwnProperty.call(cursor, 'current_seq');
+            const parsedCursorCurrentSeq = hasServerCursor ? safeNonNegativeSeq(cursor?.current_seq) : null;
+            const cursorCurrentSeq = parsedCursorCurrentSeq ?? 0;
             const retentionFloor = Math.max(client._pullRetentionFloor(result, 'retention_floor_message_seq', 'retention_floor_message_seq'));
             const visibilityFloor = Math.max(0, Math.max(0, Number(result.earliest_available_message_seq ?? 1) - 1), Number(cursor?.join_seq ?? 0));
             const effectiveFloor = Math.max(retentionFloor, visibilityFloor);
-            const commitTarget = Math.max(pageContigBefore, effectiveFloor, seqs.length > 0 ? pageMaxSeq : pageContigBefore);
+            const commitTarget = Math.max(pageContigBefore, effectiveFloor, ownsCursor && pageCount === 1 ? deferredServerCursor : 0, blockedSeq > 0 ? blockedSeq - 1 : (seqs.length > 0 ? pageMaxSeq : pageContigBefore));
             let ackSeq = pageContigBefore;
             let contigAdvanced = false;
-            try {
-                if (commitTarget > pageContigBefore) {
-                    client._seqTracker.forceContiguousSeq(ns, commitTarget);
-                    if (effectiveFloor > pageContigBefore) {
-                        client._clientLog.info(`group.v2.pull floor advance: ns=${ns} contiguous=${pageContigBefore} -> effective_floor=${effectiveFloor} retention_floor=${retentionFloor} visibility_floor=${visibilityFloor}`);
-                    }
-                    if (seqs.length > 0) {
-                        client._clientLog.debug(`group.v2.pull force contiguous: group=${gid}, ns=${ns}, page_max_seq=${pageMaxSeq}, previous=${pageContigBefore}`);
+            if (ownsCursor) {
+                try {
+                    if (commitTarget > pageContigBefore) {
+                        client._seqTracker.forceContiguousSeq(ns, commitTarget);
+                        if (effectiveFloor > pageContigBefore) {
+                            client._clientLog.info(`group.v2.pull floor advance: ns=${ns} contiguous=${pageContigBefore} -> effective_floor=${effectiveFloor} retention_floor=${retentionFloor} visibility_floor=${visibilityFloor}`);
+                        }
+                        if (deferredServerCursor > pageContigBefore && pageCount === 1) {
+                            client._clientLog.info(`group.v2.pull restore local A from deferred server ACK cursor: group=${gid}, ns=${ns}, contiguous=${pageContigBefore} -> current_seq=${deferredServerCursor}`);
+                        }
+                        if (seqs.length > 0) {
+                            client._clientLog.debug(`group.v2.pull force contiguous: group=${gid}, ns=${ns}, page_max_seq=${pageMaxSeq}, previous=${pageContigBefore}`);
+                        }
                     }
-                }
-                ackSeq = client._seqTracker.getContiguousSeq(ns);
-                contigAdvanced = ackSeq !== pageContigBefore;
-                if (contigAdvanced) {
-                    await client._drainOrderedMessages(ns, undefined, true);
                     ackSeq = client._seqTracker.getContiguousSeq(ns);
                     contigAdvanced = ackSeq !== pageContigBefore;
-                    client._commitSeqTrackerState(ns);
+                    if (contigAdvanced) {
+                        await client._commitSeqTrackerState(ns);
+                        if (pageCount === 1 && deferredServerCursor > 0)
+                            this.clearForwardCursor(ns, ackSeq);
+                    }
                 }
-            }
-            catch (exc) {
-                if (typeof client._seqTracker.restoreNamespaceSnapshot === 'function') {
-                    client._seqTracker.restoreNamespaceSnapshot(ns, pageTrackerSnapshot);
+                catch (exc) {
+                    if (typeof client._seqTracker.restoreNamespaceSnapshot === 'function') {
+                        client._seqTracker.restoreNamespaceSnapshot(ns, pageTrackerSnapshot);
+                    }
+                    client._clientLog.error?.(`group.v2.pull Forward commit rolled back: group=${gid} ns=${ns} target=${commitTarget} error=${formatE2EEError(exc)}`);
+                    throw exc;
                 }
-                client._clientLog.error?.(`group.v2.pull Forward commit rolled back: group=${gid} ns=${ns} target=${commitTarget} error=${formatE2EEError(exc)}`);
-                throw exc;
+                if (contigAdvanced)
+                    await client._drainOrderedMessages(ns, undefined, false, false);
+            }
+            for (const fetch of deferredKeyFetches.values()) {
+                this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
             }
-            const ackNeeded = pageMessages.length > 0
-                && ackSeq > 0
+            if (ownsCursor && parsedCursorCurrentSeq !== null && cursorCurrentSeq > ackSeq) {
+                this.recordForwardCursor(ns, cursorCurrentSeq, ackSeq);
+            }
+            // 无本页 cursor.current_seq 时，只有本页成功提交了比已知 cursor
+            // 更高的 A 才新增 ACK 义务；空页不得因已有本地 A 重复确认。
+            const knownServerCursorSeq = hasServerCursor
+                ? cursorCurrentSeq
+                : (ownsCursor && pageCount === 1 ? deferredServerCursor : 0);
+            const ackNeeded = ackSeq > 0
                 && ackSeq > lastAutoAckSeq
                 && ownsCursor
-                && (contigAdvanced || (hasServerCursor && ackSeq > cursorCurrentSeq));
+                && ((hasServerCursor && ackSeq > cursorCurrentSeq)
+                    || (contigAdvanced && ackSeq > knownServerCursorSeq));
             if (ackNeeded) {
+                this.recordForwardAck(ns, ackSeq);
                 const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
-                const canContinuePage = messages.length > 0 && nextAfter > nextAfterSeq && ownsCursor;
+                const canContinuePage = blockedSeq <= 0 && messages.length > 0 && nextAfter > nextAfterSeq && ownsCursor;
                 if (canContinuePage) {
                     pendingAckSeq = Math.max(pendingAckSeq, ackSeq);
                     lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
@@ -1804,7 +2049,7 @@ export class V2E2EECoordinator {
                 }
                 else {
                     client._clientLog.debug(`group.v2.pull sending terminal auto-ack: group=${gid}, ns=${ns}, ack_seq=${ackSeq}, raw_count=${messages.length}`);
-                    await this.ackGroupV2(gid, ackSeq);
+                    await this.confirmForwardGroupAck(gid, ackSeq, groupAid);
                     lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
                 }
             }
@@ -1812,11 +2057,23 @@ export class V2E2EECoordinator {
             if (!ownsCursor)
                 break;
             const rawCount = messages.length;
-            const canContinuePage = rawCount > 0 && nextAfter > nextAfterSeq;
-            const fullPage = canContinuePage && limit > 0 && rawCount >= limit;
-            const shouldContinue = canContinuePage && (fullPage || pendingAckSeq > 0);
+            const shouldContinue = shouldContinueForwardPage({
+                rawCount,
+                nextAfterSeq,
+                nextAfter,
+                limit,
+                hasMoreField,
+                hasMore,
+                serverHead,
+                pendingAckSeq,
+            });
             if (!shouldContinue)
                 break;
+            if (pullGateKey && opts?.gateLocked && client._rpcPipeline?.yieldPullGate) {
+                const nextKey = `${ns}|forward|after=${nextAfter}|force=${String(Boolean(opts?.force))}|limit=${limit}`;
+                await client._rpcPipeline.yieldPullGate(pullGateKey, nextKey, true);
+                pullGateKey = nextKey;
+            }
             const tailDelayMs = v2PullTailDelayMs(rawCount, limit);
             if (tailDelayMs > 0)
                 await v2Sleep(tailDelayMs);
@@ -1826,14 +2083,35 @@ export class V2E2EECoordinator {
             client._clientLog.warn(`group.v2.pull reached max_pages=${maxPages} group=${gid} after_seq=${nextAfterSeq}`);
             if (pendingAckSeq > 0) {
                 client._clientLog.debug(`group.v2.pull flushing pending auto-ack after max_pages: group=${gid}, ns=${ns}, ack_seq=${pendingAckSeq}`);
-                await this.ackGroupV2(gid, pendingAckSeq);
+                await this.confirmForwardGroupAck(gid, pendingAckSeq, groupAid);
                 pendingAckSeq = 0;
             }
         }
         client._clientLog.debug(`group.v2.pull done: group=${gid}, requested_after_seq=${afterSeq}, pages=${pageCount}, decrypted=${decrypted.length}, ns=${ns}`);
         return decrypted;
     }
+    async confirmForwardGroupAck(groupId, upToSeq, groupAid) {
+        const ns = `group:${String(groupId ?? '').trim()}`;
+        try {
+            const result = await this.ackGroupV2ForForward(groupId, upToSeq, groupAid);
+            const actualAckSeq = this.client._delivery.resolveForwardAckSeq(result, upToSeq);
+            if (actualAckSeq < upToSeq) {
+                throw new E2EEError(`group.v2.ack server ACK watermark ${actualAckSeq} is below requested ${upToSeq}`);
+            }
+            this.clearForwardAck(ns, upToSeq);
+        }
+        catch (exc) {
+            this.recordForwardAck(ns, upToSeq);
+            throw exc;
+        }
+    }
     async ackGroupV2(groupId, upToSeq, groupAid) {
+        return this.ackGroupV2WithConfirmation(groupId, upToSeq, groupAid, false);
+    }
+    async ackGroupV2ForForward(groupId, upToSeq, groupAid) {
+        return this.ackGroupV2WithConfirmation(groupId, upToSeq, groupAid, true);
+    }
+    async ackGroupV2WithConfirmation(groupId, upToSeq, groupAid, requireServerWatermark) {
         const client = this.client;
         const gid = String(groupId ?? '').trim();
         if (!gid)
@@ -1852,7 +2130,12 @@ export class V2E2EECoordinator {
         const inlineAckGeneration = client._delivery.captureGroupInlineAckGeneration();
         client._clientLog.debug(`group.v2.ack send: group=${gid}, ns=${ns}, up_to_seq=${seq}`);
         const result = await client._callRawV2Rpc('group.v2.ack', withExplicitGroupAid({ group_id: gid, up_to_seq: seq }, explicitGroupAid));
-        const actualAckSeq = client._delivery.resolveActualAckSeq(result, seq);
+        const actualAckSeq = requireServerWatermark
+            ? client._delivery.resolveForwardAckSeq(result, seq)
+            : client._delivery.resolveActualAckSeq(result, seq);
+        if (requireServerWatermark && actualAckSeq < seq) {
+            throw new E2EEError(`group.v2.ack server ACK watermark ${actualAckSeq} is below requested ${seq}`);
+        }
         if (inlineAckGeneration !== null) {
             client._delivery.onGroupV2AckSucceeded(gid, actualAckSeq, inlineAckGeneration);
         }