@agentunion/fastaun-browser 0.5.10 → 0.5.12

package/dist/client/v2-e2ee.js

@@ -67,11 +67,32 @@ function deduplicateForwardPageMessages(value, afterSeq) {
     }
     return [...bySeq.entries()].sort(([a], [b]) => a - b).map(([, row]) => row);
 }
-function shouldContinueForwardPage({ rawCount, nextAfterSeq, nextAfter, limit, hasMoreField, hasMore, serverHead, pendingAckSeq, }) {
+function contiguousPullSeq(afterSeq, seqs, proof) {
+    // Forward 原始页中的缺号视为服务端永久空号；页完成后按页内最大
+    // seq 推进 A，避免单页空洞阻塞后续 pull/ACK。
+    let contiguous = seqs.length > 0 ? Math.max(afterSeq, ...seqs) : afterSeq;
+    const serverProof = safeNonNegativeSeq(proof);
+    return serverProof !== null ? Math.max(contiguous, serverProof) : contiguous;
+}
+function deduplicatePulledResults(messages) {
+    const seen = new Set();
+    return messages.filter((message) => {
+        if (!isJsonObject(message))
+            return true;
+        const seq = safeNonNegativeSeq(message.seq);
+        if (seq === null || seq <= 0)
+            return true;
+        if (seen.has(seq))
+            return false;
+        seen.add(seq);
+        return true;
+    });
+}
+function shouldContinueForwardPage({ rawCount, nextAfterSeq, nextAfter, limit, hasMoreField, hasMore, serverHead, pendingAckSeq, observedUpper, }) {
     // 无新 seq 或游标未前进时必须停止，避免错误元数据造成循环。
     if (rawCount <= 0 || nextAfter <= nextAfterSeq)
         return false;
-    if (hasMore || serverHead > nextAfter || pendingAckSeq > 0)
+    if (hasMore || serverHead > nextAfter || pendingAckSeq > 0 || observedUpper > nextAfter)
         return true;
     // 仅旧服务缺失 has_more 时，以满页保留兼容续拉。
     return !hasMoreField && limit > 0 && rawCount >= limit;
@@ -889,7 +910,7 @@ export class V2E2EECoordinator {
                         client._clientLog.warn(`V2 sender IK pending group bootstrap failed group=${groupId}: ${String(formatE2EEError(exc))}`);
                     }
                 }
-                if (!session.getPeerIK(fromAid, senderDeviceId)) {
+                if (typeof session.getPeerIK === 'function' && !session.getPeerIK(fromAid, senderDeviceId)) {
                     await this.getV2SenderPubDer(fromAid, senderDeviceId);
                 }
             }
@@ -902,7 +923,7 @@ export class V2E2EECoordinator {
                 let plaintext = null;
                 const retryStatus = {};
                 try {
-                    plaintext = await client._decryptV2Message(entry.msg, false, true, true, true, retryStatus);
+                    plaintext = await client._decryptV2Message(entry.msg, false, true, true, true, retryStatus, false, 'pending_retry');
                 }
                 catch (exc) {
                     if (!generationCurrent())
@@ -930,12 +951,14 @@ export class V2E2EECoordinator {
                 client._v2SenderIKPending.delete(key);
                 const seq = Number(entry.msg.seq ?? 0);
                 if (entry.groupId) {
+                    if (client._delivery.isSelfSentGroupMessage?.(entry.msg))
+                        continue;
                     plaintext = normalizeGroupMentionMode(plaintext, entry.msg, entry.msg.envelope_json);
                     plaintext.group_id = entry.groupId;
-                    await client._publishPulledMessage('group.message_created', `group:${entry.groupId}`, seq, plaintext);
+                    await client._publishPulledMessage('group.message_created', `group:${entry.groupId}`, seq, plaintext, false, 'pending_retry');
                 }
                 else {
-                    await client._publishPulledMessage('message.received', `p2p:${client._aid ?? ''}`, seq, plaintext);
+                    await client._publishPulledMessage('message.received', `p2p:${client._aid ?? ''}`, seq, plaintext, false, 'pending_retry');
                 }
                 client._clientLog.debug(`V2 sender IK pending retry delivered: key=${key}`);
             }
@@ -1014,10 +1037,10 @@ export class V2E2EECoordinator {
         if (String(msg.version ?? '') === 'v1') {
             const legacy = isJsonObject(msg.legacy_v1)
                 ? msg.legacy_v1 : {};
-            const payload = legacy.payload;
+            const payload = legacy.payload !== undefined ? legacy.payload : msg.payload;
             const payloadType = isJsonObject(payload)
                 ? String(payload.type ?? '').trim() : '';
-            if (payload !== undefined && payload !== null && !['e2ee.encrypted', 'e2ee.group_encrypted'].includes(payloadType)) {
+            if (payload !== undefined && payload !== null && !['e2ee.encrypted', 'e2ee.group_encrypted', 'e2ee.p2p_encrypted'].includes(payloadType)) {
                 plaintext = {
                     message_id: String(msg.message_id ?? ''), from: String(msg.from_aid ?? ''),
                     to: String(legacy.to ?? client._aid ?? ''), seq, type: String(msg.type ?? ''),
@@ -1025,6 +1048,11 @@ export class V2E2EECoordinator {
                 };
                 attachGatewayProximity(plaintext, msg);
             }
+            else if (isJsonObject(payload)
+                && ['e2ee.p2p_encrypted', 'e2ee.encrypted'].includes(payloadType)) {
+                msg = { ...msg, envelope_json: JSON.stringify(payload) };
+                plaintext = await client._decryptV2Message(msg, false, !history, true, true, undefined, false, source);
+            }
         }
         else {
             plaintext = source === 'inline_push'
@@ -1054,26 +1082,48 @@ export class V2E2EECoordinator {
         let plaintext = null;
         if (String(msg.version ?? '') === 'v1') {
             const payload = msg.payload;
+            const recall = typeof client._delivery?.recallEventFromGroupMessage === 'function'
+                ? client._delivery.recallEventFromGroupMessage(msg)
+                : null;
+            if (recall) {
+                const recallPayload = {
+                    ...recall,
+                    group_id: groupId,
+                    group_aid: groupAid,
+                    seq,
+                };
+                if (publish) {
+                    if (orderedPublish) {
+                        await client._delivery.publishOrderedMessage('group.message_recalled', `group:${groupId}`, seq, recallPayload, source);
+                    }
+                    else {
+                        await client._publishAppEvent('group.message_recalled', recallPayload, source);
+                    }
+                }
+                return recallPayload;
+            }
             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;
             }
+            const payloadType = isJsonObject(payload)
+                ? String(payload.type ?? '').trim() : '';
             if (isJsonObject(payload)
-                && ['e2ee.encrypted', 'e2ee.group_encrypted'].includes(String(payload.type ?? ''))) {
-                if (history)
-                    return this.historyDecryptFailure(msg, 'unsupported legacy encrypted envelope');
-                client._clientLog.warn(`Group Tail 不支持的旧加密消息已跳过，连续性证明仍保留: group=${groupId}, seq=${seq}`);
-                return null;
+                && ['e2ee.group_encrypted', 'e2ee.p2p_encrypted', 'e2ee.encrypted'].includes(payloadType)) {
+                msg = { ...msg, envelope_json: JSON.stringify(payload) };
+                plaintext = await client._decryptV2Message(msg, false, !history, true, true, undefined, false, source);
+            }
+            else {
+                plaintext = {
+                    message_id: String(msg.message_id ?? ''), from: String(msg.from_aid ?? ''),
+                    group_id: groupId, group_aid: groupAid, seq, type: String(msg.type ?? ''),
+                    timestamp: msg.t_server, payload: payload, encrypted: false,
+                };
+                plaintext = normalizeGroupMentionMode(plaintext, msg, msg.envelope_json);
+                attachGatewayProximity(plaintext, msg);
             }
-            plaintext = {
-                message_id: String(msg.message_id ?? ''), from: String(msg.from_aid ?? ''),
-                group_id: groupId, group_aid: groupAid, seq, type: String(msg.type ?? ''),
-                timestamp: msg.t_server, payload: payload, encrypted: false,
-            };
-            plaintext = normalizeGroupMentionMode(plaintext, msg, msg.envelope_json);
-            attachGatewayProximity(plaintext, msg);
         }
         else {
             plaintext = source === 'inline_push'
@@ -1096,6 +1146,9 @@ export class V2E2EECoordinator {
             client._clientLog.warn(`Group Tail 单条消息解密失败，连续性证明仍保留: group=${groupId}, seq=${seq}`);
             return null;
         }
+        if (publish && !history && client._delivery.isSelfSentGroupMessage?.(msg)) {
+            return plaintext;
+        }
         if (publish) {
             if (orderedPublish) {
                 await client._delivery.publishOrderedMessage('group.message_created', `group:${groupId}`, seq, plaintext, source);
@@ -1112,14 +1165,6 @@ export class V2E2EECoordinator {
     async decodeInlineGroupMessage(msg, groupId, groupAid) {
         return await this.decodeGroupWindowMessage(msg, groupId, groupAid, false, false, 'inline_push');
     }
-    async applyTailFloor(ns, floor) {
-        const client = this.client;
-        if (!ns || floor <= 0 || client._seqTracker.getContiguousSeq(ns) >= floor)
-            return;
-        client._seqTracker.forceContiguousSeq(ns, floor);
-        client._persistSeq(ns);
-        await client._saveSeqTrackerState?.();
-    }
     async pullV2TailInternal(params, deferPublish = false) {
         const client = this.client;
         if (params.window_mode !== 'tail')
@@ -1129,10 +1174,9 @@ export class V2E2EECoordinator {
         const afterSeq = strictWindowSeq(params.after_seq ?? 0, 'after_seq');
         const limit = strictWindowLimit(params.limit ?? V2_PULL_DEFAULT_PAGE_LIMIT);
         const ns = client._aid ? `p2p:${client._aid}` : '';
+        if (ns)
+            client._delivery.onPullStarted?.(ns);
         const result = await client._callRawV2Rpc('message.v2.pull', { window_mode: 'tail', after_seq: afterSeq, limit, _rpc_foreground: true });
-        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, afterSeq, limit);
         if (ns) {
             client._seqTracker.commitTailWindow(ns, {
@@ -1148,8 +1192,9 @@ export class V2E2EECoordinator {
                 decoded.push(plaintext);
         }
         const ack = ns ? client._seqTracker.getContiguousSeq(ns) : 0;
-        if (previous && ack > previous.ack)
-            await this.ackV2(ack);
+        if (ns)
+            client._delivery.onPullPage?.(ns, decoded.length, result.has_more === true, page.head, typeof result.remaining === 'number' && Number.isSafeInteger(result.remaining) && result.remaining >= 0 ? result.remaining : null, page.messages.length, ack, page.head);
+        client._delivery.onPullWorkSettled?.();
         return { ...result, messages: decoded, raw_count: page.messages.length };
     }
     async historyV2Internal(params) {
@@ -1165,16 +1210,33 @@ export class V2E2EECoordinator {
         }
         return { ...result, messages: decoded };
     }
+    async runPullWithLifecycle(ns, operation) {
+        if (ns)
+            this.client._delivery.onPullStarted?.(ns);
+        try {
+            return await operation();
+        }
+        catch (error) {
+            this.client._delivery.onPullAborted?.();
+            throw error;
+        }
+    }
     async pullV2(afterSeq = 0, limit = 50, opts) {
+        const ns = this.client._aid ? `p2p:${this.client._aid}` : '';
+        return await this.runPullWithLifecycle(ns, () => this.pullV2Impl(afterSeq, limit, opts));
+    }
+    async pullV2Impl(afterSeq = 0, limit = 50, opts) {
         const client = this.client;
         await client._ensureV2SessionReady('message.pull');
         const ns = client._aid ? `p2p:${client._aid}` : '';
+        if (ns)
+            client._delivery.onPullStarted?.(ns);
         if (opts?.windowMode === 'tail') {
             if (!opts.gateLocked) {
                 const key = pullGateKeyForClient(client, 'message.v2.pull', {
                     window_mode: 'tail', after_seq: afterSeq, limit,
                 }, `${ns}|tail|after=${afterSeq}|limit=${limit}`);
-                return await client._runPullSerialized(key, () => this.pullV2(afterSeq, limit, {
+                return await client._runPullSerialized(key, () => this.pullV2Impl(afterSeq, limit, {
                     ...(opts ?? {}),
                     gateLocked: true,
                 }), false);
@@ -1186,7 +1248,7 @@ export class V2E2EECoordinator {
             const key = pullGateKeyForClient(client, 'message.v2.pull', {
                 after_seq: afterSeq, force: opts?.force === true, limit,
             }, `${ns}|forward|after=${afterSeq}|force=${String(Boolean(opts?.force))}|limit=${limit}`);
-            return await client._runPullSerialized(key, () => this.pullV2(afterSeq, limit, {
+            return await client._runPullSerialized(key, () => this.pullV2Impl(afterSeq, limit, {
                 ...(opts ?? {}),
                 gateLocked: true,
             }), true);
@@ -1248,8 +1310,10 @@ export class V2E2EECoordinator {
                 ? client._seqTracker.snapshotNamespace(ns)
                 : null;
             const pageMaxSeq = seqs.length > 0 ? Math.max(...seqs) : nextAfterSeq;
+            const pageContiguousSeq = contiguousPullSeq(pageContigBefore, seqs, result.contiguous_seq);
             const deferredKeyFetches = new Map();
             let blockedSeq = 0;
+            const pageDecryptedBefore = decrypted.length;
             for (const msg of messages) {
                 const seq = Number(msg.seq ?? 0);
                 if (!Number.isFinite(seq) || seq <= 0)
@@ -1257,12 +1321,12 @@ export class V2E2EECoordinator {
                 const version = String(msg.version ?? 'v2');
                 if (version === 'v1') {
                     const legacy = isJsonObject(msg.legacy_v1) ? msg.legacy_v1 : {};
-                    const legacyPayload = legacy.payload;
+                    const legacyPayload = legacy.payload !== undefined ? legacy.payload : msg.payload;
                     const payloadType = isJsonObject(legacyPayload)
                         ? String(legacyPayload.type ?? '').trim()
                         : '';
                     if (legacyPayload !== undefined && legacyPayload !== null
-                        && payloadType !== 'e2ee.encrypted' && payloadType !== 'e2ee.group_encrypted') {
+                        && !['e2ee.encrypted', 'e2ee.group_encrypted', 'e2ee.p2p_encrypted'].includes(payloadType)) {
                         const v1Msg = {
                             message_id: String(msg.message_id ?? ''),
                             from: String(msg.from_aid ?? ''),
@@ -1281,6 +1345,25 @@ export class V2E2EECoordinator {
                             await client._publishAppEvent(appEvent.event, appEvent.payload, 'pull');
                         decrypted.push(v1Msg);
                     }
+                    else if (isJsonObject(legacyPayload)
+                        && ['e2ee.p2p_encrypted', 'e2ee.encrypted'].includes(payloadType)) {
+                        const deferStatus = {};
+                        const plaintext = await client._decryptV2Message({ ...msg, envelope_json: JSON.stringify(legacyPayload) }, true, true, true, true, deferStatus, true, 'pull');
+                        if (deferStatus.deferred) {
+                            blockedSeq = blockedSeq > 0 ? Math.min(blockedSeq, seq) : seq;
+                            if (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) {
+                            if (ns)
+                                await client._publishPulledMessage('message.received', ns, seq, plaintext, false);
+                            else
+                                await client._publishAppEvent('message.received', plaintext, 'pull');
+                            decrypted.push(plaintext);
+                        }
+                    }
                     else {
                         client._clientLog.debug(`message.v2.pull skipping V1 envelope seq=${seq} payload_type=${payloadType || '<none>'} (V1 E2EE removed)`);
                     }
@@ -1295,7 +1378,7 @@ export class V2E2EECoordinator {
                     client._v2Session.trackOldSPKMaxSeq(msgSpkId, seq);
                 }
                 const deferStatus = {};
-                const plaintext = await client._decryptV2Message(msg, true, true, true, true, deferStatus, true);
+                const plaintext = await client._decryptV2Message(msg, true, true, true, true, deferStatus, true, 'pull');
                 if (deferStatus.deferred) {
                     blockedSeq = blockedSeq > 0 ? Math.min(blockedSeq, seq) : seq;
                 }
@@ -1323,7 +1406,7 @@ export class V2E2EECoordinator {
             const serverAckSeq = parsedServerAckSeq ?? 0;
             const retentionFloor = Math.max(0, Number(result.retention_floor_seq ?? 0));
             if (ns) {
-                const commitTarget = blockedSeq > 0 ? pageContigBefore : Math.max(pageContigBefore, Number.isFinite(retentionFloor) ? retentionFloor : 0, pageCount === 1 ? deferredServerCursor : 0, seqs.length > 0 ? pageMaxSeq : pageContigBefore);
+                const commitTarget = Math.max(pageContigBefore, Number.isFinite(retentionFloor) ? retentionFloor : 0, pageCount === 1 ? deferredServerCursor : 0, serverAckSeq, blockedSeq > 0 ? blockedSeq - 1 : pageContiguousSeq);
                 let ackSeq = pageContigBefore;
                 let contigAdvanced = false;
                 try {
@@ -1367,15 +1450,14 @@ export class V2E2EECoordinator {
                 const knownServerAckSeq = hasServerAckSeq
                     ? serverAckSeq
                     : (pageCount === 1 ? deferredServerCursor : 0);
-                const ackNeeded = blockedSeq <= 0
-                    && ackSeq > 0
+                const ackNeeded = ackSeq > 0
                     && ackSeq > lastAutoAckSeq
                     && ((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 nextAfter = Math.max(pageContiguousSeq, nextAfterSeq);
+                    const canContinuePage = blockedSeq <= 0 && messages.length > 0 && nextAfter > nextAfterSeq;
                     if (canContinuePage) {
                         pendingAckSeq = Math.max(pendingAckSeq, ackSeq);
                         lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
@@ -1386,7 +1468,9 @@ export class V2E2EECoordinator {
                     }
                 }
             }
-            const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
+            if (ns)
+                client._delivery.onPullPage?.(ns, decrypted.length - pageDecryptedBefore, hasMore, pageMaxSeq, typeof result.remaining === 'number' && Number.isSafeInteger(result.remaining) && result.remaining >= 0 ? result.remaining : null, messages.length, client._seqTracker.getContiguousSeq(ns), pageMaxSeq);
+            const nextAfter = Math.max(pageContiguousSeq, nextAfterSeq);
             const rawCount = messages.length;
             if (blockedSeq > 0)
                 break;
@@ -1399,6 +1483,8 @@ export class V2E2EECoordinator {
                 hasMore,
                 serverHead,
                 pendingAckSeq,
+                observedUpper: typeof client._seqTracker.getMaxSeenSeq === 'function'
+                    ? client._seqTracker.getMaxSeenSeq(ns) : nextAfter,
             });
             if (!shouldContinue)
                 break;
@@ -1421,7 +1507,8 @@ export class V2E2EECoordinator {
                 pendingAckSeq = 0;
             }
         }
-        return decrypted;
+        client._delivery.onPullWorkSettled?.();
+        return deduplicatePulledResults(decrypted);
     }
     async confirmForwardP2PAck(upToSeq, inlineGeneration) {
         const ns = this.client._aid ? `p2p:${this.client._aid}` : '';
@@ -1519,10 +1606,7 @@ export class V2E2EECoordinator {
             if (isJsonObject(result)) {
                 const seq = Number(result.seq ?? 0);
                 if (seq > 0) {
-                    const ns = `group:${gid}`;
-                    client._seqTracker.onMessageSeq(ns, seq);
-                    client._markPublishedSeq(ns, seq);
-                    await client._saveSeqTrackerState();
+                    client._markPublishedSeq(`group:${gid}`, seq);
                 }
             }
             return client._delivery.attachSendResultEnvelope('group.send', withExplicitGroupAid({
@@ -1543,10 +1627,7 @@ export class V2E2EECoordinator {
                 if (isJsonObject(result)) {
                     const seq = Number(result.seq ?? 0);
                     if (seq > 0) {
-                        const ns = `group:${gid}`;
-                        client._seqTracker.onMessageSeq(ns, seq);
-                        client._markPublishedSeq(ns, seq);
-                        await client._saveSeqTrackerState();
+                        client._markPublishedSeq(`group:${gid}`, seq);
                     }
                 }
                 return client._delivery.attachSendResultEnvelope('group.send', withExplicitGroupAid({
@@ -1574,15 +1655,20 @@ export class V2E2EECoordinator {
         const afterSeq = strictWindowSeq(params.after_seq ?? 0, 'after_seq');
         const limit = strictWindowLimit(params.limit ?? V2_PULL_DEFAULT_PAGE_LIMIT);
         const ns = `group:${groupId}`;
+        const cursorParams = isJsonObject(params._group_cursor_params)
+            ? params._group_cursor_params : params;
+        const requestDeviceId = String(cursorParams.device_id ?? '').trim();
+        const requestSlotId = String(cursorParams.slot_id ?? '').trim();
+        const ownsCursor = (!requestDeviceId || requestDeviceId === String(client._deviceId ?? ''))
+            && (!requestSlotId || requestSlotId === String(client._slotId ?? ''));
+        if (ownsCursor)
+            client._delivery.onPullStarted?.(ns);
         const result = await client._callRawV2Rpc('group.v2.pull', withExplicitGroupAid({
             group_id: groupId, window_mode: 'tail', after_seq: afterSeq, limit, _rpc_foreground: true,
         }, groupAid));
         const resultAid = String(result.group_aid ?? result.groupAid ?? '').trim();
         if (resultAid)
             groupAid = resultAid;
-        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, afterSeq, limit);
         client._seqTracker.commitTailWindow(ns, {
             windowStartSeq: page.windowStart, headSeq: page.head, coveredThroughSeq: page.head, pageLimit: limit,
@@ -1597,8 +1683,9 @@ export class V2E2EECoordinator {
                 decoded.push(plaintext);
         }
         const ack = client._seqTracker.getContiguousSeq(ns);
-        if (ack > previous.ack)
-            await this.ackGroupV2(groupId, ack, groupAid);
+        if (ownsCursor)
+            client._delivery.onPullPage?.(ns, decoded.length, result.has_more === true, page.head, typeof result.remaining === 'number' && Number.isSafeInteger(result.remaining) && result.remaining >= 0 ? result.remaining : null, page.messages.length, ack, page.head);
+        client._delivery.onPullWorkSettled?.();
         return { ...result, messages: decoded, raw_count: page.messages.length };
     }
     async historyGroupV2Internal(params) {
@@ -1631,6 +1718,13 @@ export class V2E2EECoordinator {
         });
     }
     async pullGroupV2(groupId, afterSeq = 0, limit = 50, opts) {
+        const lifecycleNs = `group:${String(groupId ?? '').trim()}`;
+        if (opts?.ownsCursor === false) {
+            return await this.pullGroupV2Impl(groupId, afterSeq, limit, opts);
+        }
+        return await this.runPullWithLifecycle(lifecycleNs, () => this.pullGroupV2Impl(groupId, afterSeq, limit, opts));
+    }
+    async pullGroupV2Impl(groupId, afterSeq = 0, limit = 50, opts) {
         const client = this.client;
         await client._ensureV2SessionReady('group.pull');
         const gid = String(groupId ?? '').trim();
@@ -1644,12 +1738,13 @@ export class V2E2EECoordinator {
                     group_id: gid, window_mode: 'tail', after_seq: afterSeq, limit,
                     _group_cursor_params: opts?.cursorParams,
                 }, `${ns}|tail|after=${afterSeq}|limit=${limit}`);
-                return await client._runPullSerialized(key, () => this.pullGroupV2(gid, afterSeq, limit, {
+                return await client._runPullSerialized(key, () => this.pullGroupV2Impl(gid, afterSeq, limit, {
                     ...(opts ?? {}),
                     gateLocked: true,
                 }), false);
             }
             const result = await this.pullGroupV2TailInternal({
+                ...(opts?.cursorParams ?? {}),
                 group_id: String(opts.wireGroupId ?? gid), group_aid: groupAid || undefined,
                 window_mode: 'tail', after_seq: afterSeq, limit,
             });
@@ -1660,7 +1755,7 @@ export class V2E2EECoordinator {
                 group_id: gid, after_seq: afterSeq, force: opts?.force === true, limit,
                 _group_cursor_params: opts?.cursorParams,
             }, `${ns}|forward|after=${afterSeq}|force=${String(Boolean(opts?.force))}|limit=${limit}`);
-            return await client._runPullSerialized(key, () => this.pullGroupV2(gid, afterSeq, limit, {
+            return await client._runPullSerialized(key, () => this.pullGroupV2Impl(gid, afterSeq, limit, {
                 ...(opts ?? {}),
                 gateLocked: true,
             }), true);
@@ -1669,6 +1764,8 @@ export class V2E2EECoordinator {
         const wireGroupId = String(opts?.wireGroupId ?? groupId ?? '').trim() || gid;
         const cursorParams = opts?.cursorParams ?? {};
         const ownsCursor = opts?.ownsCursor !== false;
+        if (ownsCursor)
+            client._delivery.onPullStarted?.(ns);
         let pullGateKey = ownsCursor
             ? pullGateKeyForClient(client, 'group.v2.pull', {
                 group_id: gid, after_seq: afterSeq, force: opts?.force === true, limit,
@@ -1735,30 +1832,34 @@ export class V2E2EECoordinator {
                 ? client._seqTracker.snapshotNamespace(ns)
                 : null;
             const pageMaxSeq = seqs.length > 0 ? Math.max(...seqs) : nextAfterSeq;
+            const pageContiguousSeq = contiguousPullSeq(pageContigBefore, seqs, result.contiguous_seq);
             const deferredKeyFetches = new Map();
             let blockedSeq = 0;
+            const pageDecryptedBefore = decrypted.length;
             for (const msg of messages) {
                 const seq = Number(msg.seq ?? 0);
                 if (!Number.isFinite(seq) || seq <= 0)
                     continue;
                 const version = String(msg.version ?? 'v2');
                 if (version === 'v1') {
-                    const payload = msg.payload;
+                    const legacy = isJsonObject(msg.legacy_v1) ? msg.legacy_v1 : {};
+                    const payload = msg.payload !== undefined ? msg.payload : legacy.payload;
                     const payloadObj = isJsonObject(payload) ? payload : null;
                     // 群撤回 tombstone（占位 / 通知）：归一化为 group.message_recalled 事件，仍占 seq。
-                    if (client._delivery.recallEventFromGroupMessage(msg)) {
+                    if (typeof client._delivery?.recallEventFromGroupMessage === 'function'
+                        && client._delivery.recallEventFromGroupMessage(msg)) {
                         await client._delivery.publishGroupRecallTombstone(gid, seq, {
                             ...msg,
                             group_id: gid,
                             group_aid: eventGroupAid,
-                        });
+                        }, 'pull');
                         client._markPublishedSeq(ns, seq);
                         client._clientLog.debug(`group.v2.pull recall tombstone delivered: group=${gid}, seq=${seq}`);
                         continue;
                     }
                     if (payloadObj) {
                         const payloadType = String(payloadObj.type ?? '').trim();
-                        if (payloadType !== 'e2ee.encrypted' && payloadType !== 'e2ee.group_encrypted') {
+                        if (payloadType !== 'e2ee.encrypted' && payloadType !== 'e2ee.group_encrypted' && payloadType !== 'e2ee.p2p_encrypted') {
                             let v1Msg = {
                                 message_id: String(msg.message_id ?? ''),
                                 from: String(msg.from_aid ?? ''),
@@ -1772,7 +1873,12 @@ export class V2E2EECoordinator {
                             };
                             v1Msg = normalizeGroupMentionMode(v1Msg, msg, msg.envelope_json);
                             attachGatewayProximity(v1Msg, msg);
-                            await client._publishPulledMessage('group.message_created', ns, seq, v1Msg, false);
+                            if (!client._delivery.isSelfSentGroupMessage?.(msg)) {
+                                await client._publishPulledMessage('group.message_created', ns, seq, v1Msg, false);
+                            }
+                            else {
+                                client._markPublishedSeq(ns, seq);
+                            }
                             decrypted.push(v1Msg);
                             continue;
                         }
@@ -1795,6 +1901,28 @@ export class V2E2EECoordinator {
                         decrypted.push(v1Msg);
                         continue;
                     }
+                    if (payloadObj && ['e2ee.group_encrypted', 'e2ee.p2p_encrypted', 'e2ee.encrypted'].includes(String(payloadObj.type ?? '').trim())) {
+                        const deferStatus = {};
+                        const plaintext = await client._decryptV2Message({ ...msg, envelope_json: JSON.stringify(payloadObj) }, true, true, true, true, deferStatus, true, 'pull');
+                        if (deferStatus.deferred) {
+                            blockedSeq = blockedSeq > 0 ? Math.min(blockedSeq, seq) : seq;
+                            if (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) {
+                            plaintext.group_id = gid;
+                            plaintext.group_aid = eventGroupAid;
+                            if (!client._delivery.isSelfSentGroupMessage?.(msg)) {
+                                await client._publishPulledMessage('group.message_created', ns, seq, plaintext, false);
+                            }
+                            else {
+                                client._markPublishedSeq(ns, seq);
+                            }
+                            decrypted.push(plaintext);
+                        }
+                    }
                     client._clientLog.debug(`group.v2.pull skipping V1 envelope group=${gid} seq=${seq} payload_type=${payloadObj ? String(payloadObj.type ?? '') : '<none>'} (V1 E2EE removed)`);
                     continue;
                 }
@@ -1803,7 +1931,7 @@ export class V2E2EECoordinator {
                     continue;
                 }
                 const deferStatus = {};
-                let plaintext = await client._decryptV2Message(msg, true, true, true, true, deferStatus, true);
+                let plaintext = await client._decryptV2Message(msg, true, true, true, true, deferStatus, true, 'pull');
                 if (deferStatus.deferred) {
                     blockedSeq = blockedSeq > 0 ? Math.min(blockedSeq, seq) : seq;
                 }
@@ -1820,7 +1948,12 @@ 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, false);
+                if (!client._delivery.isSelfSentGroupMessage?.(msg)) {
+                    await client._publishPulledMessage('group.message_created', ns, seq, plaintext, false);
+                }
+                else {
+                    client._markPublishedSeq(ns, seq);
+                }
                 decrypted.push(plaintext);
             }
             const hasServerCursor = cursor !== null && Object.prototype.hasOwnProperty.call(cursor, 'current_seq');
@@ -1829,7 +1962,7 @@ export class V2E2EECoordinator {
             const retentionFloor = Math.max(Number(result.retention_floor_message_seq ?? result.retention_floor_seq ?? 0), Number(cursor?.retention_floor_seq ?? 0));
             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 = blockedSeq > 0 ? pageContigBefore : Math.max(pageContigBefore, Number.isFinite(effectiveFloor) ? effectiveFloor : 0, ownsCursor && pageCount === 1 ? deferredServerCursor : 0, seqs.length > 0 ? pageMaxSeq : pageContigBefore);
+            const commitTarget = Math.max(pageContigBefore, Number.isFinite(effectiveFloor) ? effectiveFloor : 0, ownsCursor && pageCount === 1 ? deferredServerCursor : 0, cursorCurrentSeq, blockedSeq > 0 ? blockedSeq - 1 : pageContiguousSeq);
             let ackSeq = pageContigBefore;
             let contigAdvanced = false;
             if (ownsCursor) {
@@ -1867,6 +2000,7 @@ export class V2E2EECoordinator {
             for (const fetch of deferredKeyFetches.values()) {
                 this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
             }
+            client._delivery.onPullPage?.(ns, decrypted.length - pageDecryptedBefore, hasMore, pageMaxSeq, typeof result.remaining === 'number' && Number.isSafeInteger(result.remaining) && result.remaining >= 0 ? result.remaining : null, messages.length, client._seqTracker.getContiguousSeq(ns), pageMaxSeq);
             if (ownsCursor && parsedCursorCurrentSeq !== null && cursorCurrentSeq > ackSeq) {
                 this.recordForwardCursor(ns, cursorCurrentSeq, ackSeq);
             }
@@ -1875,16 +2009,15 @@ export class V2E2EECoordinator {
             const knownServerCursorSeq = hasServerCursor
                 ? cursorCurrentSeq
                 : (ownsCursor && pageCount === 1 ? deferredServerCursor : 0);
-            const ackNeeded = blockedSeq <= 0
-                && ackSeq > 0
+            const ackNeeded = ackSeq > 0
                 && ackSeq > lastAutoAckSeq
                 && ownsCursor
                 && ((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 nextAfter = Math.max(pageContiguousSeq, nextAfterSeq);
+                const canContinuePage = blockedSeq <= 0 && messages.length > 0 && nextAfter > nextAfterSeq && ownsCursor;
                 if (canContinuePage) {
                     pendingAckSeq = Math.max(pendingAckSeq, ackSeq);
                     lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
@@ -1894,7 +2027,7 @@ export class V2E2EECoordinator {
                     lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
                 }
             }
-            const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
+            const nextAfter = Math.max(pageContiguousSeq, nextAfterSeq);
             if (!ownsCursor)
                 break;
             const rawCount = messages.length;
@@ -1909,6 +2042,8 @@ export class V2E2EECoordinator {
                 hasMore,
                 serverHead,
                 pendingAckSeq,
+                observedUpper: typeof client._seqTracker.getMaxSeenSeq === 'function'
+                    ? client._seqTracker.getMaxSeenSeq(ns) : nextAfter,
             });
             if (!shouldContinue)
                 break;
@@ -1932,7 +2067,8 @@ export class V2E2EECoordinator {
                 pendingAckSeq = 0;
             }
         }
-        return decrypted;
+        client._delivery.onPullWorkSettled?.();
+        return deduplicatePulledResults(decrypted);
     }
     async confirmForwardGroupAck(groupId, upToSeq, groupAid) {
         const ns = `group:${String(groupId ?? '').trim()}`;
@@ -2486,7 +2622,7 @@ export class V2E2EECoordinator {
     async decryptV2PushMessage(data) {
         if (!isJsonObject(data))
             return null;
-        return await this.client._decryptV2Message(data);
+        return await this.client._decryptV2Message(data, false, false, false, false, undefined, false, 'inline_push');
     }
     async buildV2P2PEnvelope(opts) {
         const client = this.client;