@agentunion/fastaun 0.5.9 → 0.5.11

package/dist/client/v2-e2ee.js

@@ -298,6 +298,10 @@ export class V2E2EECoordinator {
         this.pendingForwardCursors.clear();
         this.pendingForwardAcks.clear();
     }
+    hasPendingSenderIKWork() {
+        return this.senderIKSyncFetches.size > 0
+            || Boolean(this.client._v2SenderIKFetching?.size);
+    }
     pendingForwardCursor(ns, localAck) {
         if (!ns)
             return 0;
@@ -648,6 +652,7 @@ export class V2E2EECoordinator {
         finally {
             if (this.senderIKSyncFetches.get(fetchKey) === task)
                 this.senderIKSyncFetches.delete(fetchKey);
+            client._rpcPipeline?.requestPullDrainedCheck?.();
         }
     }
     scheduleSenderIKPending(args) {
@@ -679,6 +684,10 @@ export class V2E2EECoordinator {
     }
     async resolveSenderIKPending(fromAid, senderDeviceId, groupId, fetchKey) {
         const client = this.client;
+        const generation = Number(client._v2RuntimeGeneration ?? 0);
+        const pending = client._v2SenderIKPending;
+        const fetching = client._v2SenderIKFetching;
+        const generationIsCurrent = () => Number(client._v2RuntimeGeneration ?? 0) === generation;
         try {
             const session = client._v2Session;
             if (session && fromAid) {
@@ -718,18 +727,23 @@ export class V2E2EECoordinator {
                     await this.getV2SenderPubDer(fromAid, senderDeviceId);
                 }
             }
-            const pendingItems = [...client._v2SenderIKPending.entries()].filter(([, entry]) => entry.fromAid === fromAid && entry.senderDeviceId === senderDeviceId && entry.groupId === groupId);
+            if (!generationIsCurrent())
+                return;
+            const pendingItems = [...pending.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, true, true, true, retryStatus);
+                    plaintext = await client._decryptV2Message(entry.msg, false, true, true, true, retryStatus, false, 'pending_retry');
                 }
                 catch (exc) {
                     client._clientLog.warn(`V2 sender IK pending retry raised: key=${key} err=${formatE2EEError(exc)}`);
-                    client._v2SenderIKPending.delete(key);
+                    if (generationIsCurrent())
+                        pending.delete(key);
                     continue;
                 }
+                if (!generationIsCurrent())
+                    return;
                 if (plaintext === null) {
                     if (retryStatus.deferred) {
                         client._clientLog.warn(`V2 pending retry still missing key material: key=${key}`);
@@ -741,24 +755,33 @@ export class V2E2EECoordinator {
                     const safeEvent = this.safeUndecryptablePushEvent(entry.msg, isGroup);
                     safeEvent._decrypt_error = 'sender IK pending retry failed';
                     safeEvent._decrypt_stage = 'sender_ik_pending_retry';
-                    await client._publishAppEvent(eventName, safeEvent, 'pending_retry');
+                    try {
+                        await client._publishAppEvent(eventName, safeEvent, 'pending_retry');
+                    }
+                    finally {
+                        if (generationIsCurrent())
+                            pending.delete(key);
+                    }
                     continue;
                 }
-                client._v2SenderIKPending.delete(key);
+                pending.delete(key);
                 const seq = Number(entry.msg.seq ?? 0);
                 if (entry.groupId) {
                     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}`);
             }
         }
         finally {
-            client._v2SenderIKFetching.delete(fetchKey);
+            if (generationIsCurrent() && client._v2SenderIKFetching === fetching) {
+                fetching.delete(fetchKey);
+                client._rpcPipeline?.requestPullDrainedCheck?.();
+            }
         }
     }
     async buildV2P2PEnvelope(opts) {
@@ -924,9 +947,10 @@ export class V2E2EECoordinator {
             throw new ValidationError("message.send requires 'to'");
         if (!isJsonObject(payload))
             throw new ValidationError('message.send payload must be a dict for V2 encryption');
+        const messageId = String(opts?.messageId ?? '').trim() || `m-${crypto.randomUUID().replace(/-/g, '')}`;
         client._logMessageDebug('send-plaintext', 'message.send.v2', 'message.send', {
             to: toAid,
-            message_id: opts?.messageId ?? '',
+            message_id: messageId,
             payload,
         }, { payloadOverride: payload });
         const attempt = async (useCache) => {
@@ -934,7 +958,7 @@ export class V2E2EECoordinator {
             const envelope = await client._buildV2P2PEnvelope({
                 to: toAid,
                 payload,
-                messageId: opts?.messageId,
+                messageId,
                 timestamp: opts?.timestamp,
                 protectedHeaders: opts?.protectedHeaders,
                 context: opts?.context,
@@ -943,6 +967,7 @@ export class V2E2EECoordinator {
             const result = await client.call('message.send', {
                 to: toAid,
                 payload: envelope,
+                message_id: messageId,
                 encrypt: false,
                 _skip_send_result_envelope: true,
             });
@@ -954,7 +979,7 @@ export class V2E2EECoordinator {
             return client._delivery.attachSendResultEnvelope('message.send', {
                 to: toAid,
                 payload,
-                message_id: opts?.messageId,
+                message_id: messageId,
                 timestamp: opts?.timestamp,
                 protected_headers: opts?.protectedHeaders,
                 context: opts?.context,
@@ -969,7 +994,7 @@ export class V2E2EECoordinator {
                 return client._delivery.attachSendResultEnvelope('message.send', {
                     to: toAid,
                     payload,
-                    message_id: opts?.messageId,
+                    message_id: messageId,
                     timestamp: opts?.timestamp,
                     protected_headers: opts?.protectedHeaders,
                     context: opts?.context,
@@ -993,10 +1018,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 ?? ''),
@@ -1009,9 +1034,14 @@ 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 = await client._decryptV2Message(msg, false, !history);
+            plaintext = await client._decryptV2Message(msg, false, !history, true, true, undefined, false, source);
         }
         if (!plaintext) {
             if (history)
@@ -1022,7 +1052,7 @@ export class V2E2EECoordinator {
         if (publish) {
             const event = client._delivery.p2pAppEventForMessage(plaintext);
             if (orderedPublish) {
-                await client._delivery.publishOrderedMessage(event.event, client._aid ? `p2p:${client._aid}` : '', seq, event.payload);
+                await client._delivery.publishOrderedMessage(event.event, client._aid ? `p2p:${client._aid}` : '', seq, event.payload, source);
             }
             else {
                 await client._publishAppEvent(event.event, event.payload, source);
@@ -1036,35 +1066,57 @@ 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 = await client._decryptV2Message(msg, false, !history);
+            plaintext = await client._decryptV2Message(msg, false, !history, true, true, undefined, false, source);
             if (plaintext) {
                 plaintext.group_id = groupId;
                 plaintext.group_aid = groupAid;
@@ -1079,7 +1131,7 @@ export class V2E2EECoordinator {
         }
         if (publish) {
             if (orderedPublish) {
-                await client._delivery.publishOrderedMessage('group.message_created', `group:${groupId}`, seq, plaintext);
+                await client._delivery.publishOrderedMessage('group.message_created', `group:${groupId}`, seq, plaintext, source);
             }
             else {
                 await client._publishAppEvent('group.message_created', plaintext, source);
@@ -1104,6 +1156,8 @@ 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.syncStarted(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;
@@ -1128,6 +1182,15 @@ export class V2E2EECoordinator {
         const ack = ns ? client._seqTracker.getContiguousSeq(ns) : 0;
         if (previous && ack > previous.ack)
             await this.ackV2(ack);
+        if (ns)
+            client._delivery.syncProgress(ns, {
+                rawCount: page.messages.length,
+                pulledCount: decoded.length,
+                remaining: result.remaining,
+                hasMore: typeof result.has_more === 'boolean' ? result.has_more : undefined,
+                currentSeq: ack,
+                targetSeq: page.head,
+            });
         return { ...result, messages: decoded, raw_count: page.messages.length };
     }
     async historyV2Internal(params) {
@@ -1144,21 +1207,23 @@ export class V2E2EECoordinator {
         }
         return { ...result, messages: decoded };
     }
-    async pullV2(afterSeq = 0, limit = 50, 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.syncStarted(ns);
         if (opts?.windowMode === 'tail') {
             if (!opts.gateLocked) {
                 const key = `${ns}|tail|after=${afterSeq}|limit=${limit}`;
-                return (await client._runPullSerialized(key, () => this.pullV2(afterSeq, limit, { ...opts, gateLocked: true }), false));
+                return (await client._runPullSerialized(key, () => this.pullV2Impl(afterSeq, limit, { ...opts, gateLocked: true }), false));
             }
             const result = await this.pullV2TailInternal({ window_mode: 'tail', after_seq: afterSeq, limit });
             return (Array.isArray(result.messages) ? result.messages : []);
         }
         if (ns && !opts?.gateLocked) {
             const key = `${ns}|forward|after=${afterSeq}|force=${String(Boolean(opts?.force))}|limit=${limit}`;
-            return await client._runPullSerialized(key, async () => this.pullV2(afterSeq, limit, {
+            return await client._runPullSerialized(key, async () => this.pullV2Impl(afterSeq, limit, {
                 ...(opts ?? {}),
                 gateLocked: true,
                 scheduleFollowup: true,
@@ -1228,6 +1293,7 @@ export class V2E2EECoordinator {
             }
             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)
@@ -1235,11 +1301,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') {
+                    if (legacyPayload !== undefined && legacyPayload !== null
+                        && !['e2ee.encrypted', 'e2ee.group_encrypted', 'e2ee.p2p_encrypted'].includes(payloadType)) {
                         const v1Msg = {
                             message_id: String(msg.message_id ?? ''),
                             from: String(msg.from_aid ?? ''),
@@ -1261,6 +1328,25 @@ export class V2E2EECoordinator {
                         decrypted.push(v1Msg);
                         client._clientLog.debug(`message.v2.pull plaintext V1 delivered: seq=${seq}, ns=${ns || '<none>'}`);
                     }
+                    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)`);
                     }
@@ -1275,7 +1361,7 @@ export class V2E2EECoordinator {
                     client._v2Session.trackOldSPKMaxSeq(spkId, 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;
                 }
@@ -1337,7 +1423,7 @@ export class V2E2EECoordinator {
                     throw exc;
                 }
                 if (contigAdvanced)
-                    await client._drainOrderedMessages(ns, undefined, false, false);
+                    await client._drainOrderedMessages(ns, undefined, false, false, 'pull');
                 for (const fetch of deferredKeyFetches.values()) {
                     this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
                 }
@@ -1374,8 +1460,19 @@ export class V2E2EECoordinator {
                     this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
                 }
             }
+            if (ns)
+                client._delivery.syncProgress(ns, {
+                    rawCount: messages.length,
+                    pulledCount: decrypted.length - pageDecryptedBefore,
+                    remaining: result.remaining,
+                    hasMore: hasMoreField ? hasMore : undefined,
+                    currentSeq: client._seqTracker.getContiguousSeq(ns),
+                    targetSeq: serverHead,
+                });
             const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
             const rawCount = messages.length;
+            if (blockedSeq > 0)
+                break;
             const shouldContinue = shouldContinueForwardPage({
                 rawCount,
                 nextAfterSeq,
@@ -1409,6 +1506,19 @@ export class V2E2EECoordinator {
         client._clientLog.debug(`message.v2.pull done: requested_after_seq=${afterSeq}, pages=${pageCount}, decrypted=${decrypted.length}, ns=${ns || '<none>'}`);
         return decrypted;
     }
+    async pullV2(afterSeq = 0, limit = 50, opts) {
+        const ns = this.client._aid ? `p2p:${this.client._aid}` : '';
+        if (!ns)
+            return await this.pullV2Impl(afterSeq, limit, opts);
+        this.client._delivery.syncStarted(ns);
+        try {
+            return await this.pullV2Impl(afterSeq, limit, opts);
+        }
+        catch (error) {
+            this.client._delivery.onPullAborted?.();
+            throw error;
+        }
+    }
     async confirmForwardP2PAck(upToSeq) {
         const ns = this.client._aid ? `p2p:${this.client._aid}` : '';
         try {
@@ -1487,9 +1597,10 @@ export class V2E2EECoordinator {
         const groupAid = String(opts?.groupAid ?? '').trim();
         if (!isJsonObject(payload))
             throw new ValidationError('group.send payload must be a dict for V2 encryption');
+        const messageId = String(opts?.messageId ?? '').trim() || `m-${crypto.randomUUID().replace(/-/g, '')}`;
         client._logMessageDebug('send-plaintext', 'group.send.v2', 'group.send', withExplicitGroupAid({
             group_id: gid,
-            message_id: opts?.messageId ?? '',
+            message_id: messageId,
             payload,
         }, groupAid), { payloadOverride: payload });
         const attempt = async (useCache) => {
@@ -1497,7 +1608,7 @@ export class V2E2EECoordinator {
             const envelope = await client._buildV2GroupEnvelope({
                 groupId: gid,
                 payload,
-                messageId: opts?.messageId,
+                messageId,
                 timestamp: opts?.timestamp,
                 protectedHeaders: opts?.protectedHeaders,
                 context: opts?.context,
@@ -1529,7 +1640,7 @@ export class V2E2EECoordinator {
             return client._delivery.attachSendResultEnvelope('group.send', withExplicitGroupAid({
                 group_id: gid,
                 payload,
-                message_id: opts?.messageId,
+                message_id: messageId,
                 timestamp: opts?.timestamp,
                 protected_headers: opts?.protectedHeaders,
                 context: opts?.context,
@@ -1545,7 +1656,7 @@ export class V2E2EECoordinator {
                 return client._delivery.attachSendResultEnvelope('group.send', withExplicitGroupAid({
                     group_id: gid,
                     payload,
-                    message_id: opts?.messageId,
+                    message_id: messageId,
                     timestamp: opts?.timestamp,
                     protected_headers: opts?.protectedHeaders,
                     context: opts?.context,
@@ -1713,6 +1824,14 @@ 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.syncStarted(ns);
         const result = await client._callRawV2Rpc('group.v2.pull', withExplicitGroupAid({
             group_id: groupId,
             window_mode: 'tail',
@@ -1745,6 +1864,15 @@ export class V2E2EECoordinator {
         const ack = client._seqTracker.getContiguousSeq(ns);
         if (ack > previous.ack)
             await this.ackGroupV2(groupId, ack, groupAid);
+        if (ownsCursor)
+            client._delivery.syncProgress(ns, {
+                rawCount: page.messages.length,
+                pulledCount: decoded.length,
+                remaining: result.remaining,
+                hasMore: typeof result.has_more === 'boolean' ? result.has_more : undefined,
+                currentSeq: ack,
+                targetSeq: page.head,
+            });
         return { ...result, messages: decoded, raw_count: page.messages.length };
     }
     async historyGroupV2Internal(params) {
@@ -1780,7 +1908,7 @@ export class V2E2EECoordinator {
             force: params.force === true,
         });
     }
-    async pullGroupV2(groupId, afterSeq = 0, limit = 50, opts) {
+    async pullGroupV2Impl(groupId, afterSeq = 0, limit = 50, opts) {
         const client = this.client;
         await client._ensureV2SessionReady('group.pull');
         const gid = String(groupId ?? '').trim();
@@ -1788,15 +1916,18 @@ export class V2E2EECoordinator {
             throw new ValidationError('group.pull requires group_id');
         let groupAid = String(opts?.groupAid ?? '').trim();
         const ns = `group:${gid}`;
+        if (opts?.ownsCursor !== false)
+            client._delivery.syncStarted(ns);
         if (opts?.windowMode === 'tail') {
             if (!opts.gateLocked) {
                 const key = `${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',
@@ -1807,7 +1938,7 @@ export class V2E2EECoordinator {
         }
         if (!opts?.gateLocked) {
             const key = `${ns}|forward|after=${afterSeq}|force=${opts?.force === true}|limit=${limit}`;
-            return await client._runPullSerialized(key, async () => this.pullGroupV2(gid, afterSeq, limit, {
+            return await client._runPullSerialized(key, async () => this.pullGroupV2Impl(gid, afterSeq, limit, {
                 ...(opts ?? {}),
                 gateLocked: true,
                 scheduleFollowup: true,
@@ -1890,28 +2021,31 @@ export class V2E2EECoordinator {
             }
             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;
+                    const payloadType = payloadObj ? String(payloadObj.type ?? '').trim() : '';
                     // 群撤回 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 (!['e2ee.encrypted', 'e2ee.group_encrypted', 'e2ee.p2p_encrypted'].includes(payloadType)) {
                             let v1Msg = {
                                 message_id: String(msg.message_id ?? ''),
                                 from: String(msg.from_aid ?? ''),
@@ -1950,7 +2084,26 @@ export class V2E2EECoordinator {
                         client._clientLog.debug(`group.v2.pull plaintext V1 delivered: group=${gid}, seq=${seq}`);
                         continue;
                     }
-                    client._clientLog.debug(`group.v2.pull skipping V1 envelope group=${gid} seq=${seq} payload_type=${payloadObj ? String(payloadObj.type ?? '') : '<none>'} (V1 E2EE removed)`);
+                    if (payloadObj && ['e2ee.group_encrypted', 'e2ee.p2p_encrypted', 'e2ee.encrypted'].includes(payloadType)) {
+                        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;
+                            await client._publishPulledMessage('group.message_created', ns, seq, plaintext, false);
+                            decrypted.push(plaintext);
+                        }
+                    }
+                    else {
+                        client._clientLog.debug(`group.v2.pull skipping V1 envelope group=${gid} seq=${seq} payload_type=${payloadObj ? String(payloadObj.type ?? '') : '<none>'} (V1 E2EE removed)`);
+                    }
                     continue;
                 }
                 if (version !== 'v2') {
@@ -1958,7 +2111,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;
                 }
@@ -2020,7 +2173,7 @@ export class V2E2EECoordinator {
                     throw exc;
                 }
                 if (contigAdvanced)
-                    await client._drainOrderedMessages(ns, undefined, false, false);
+                    await client._drainOrderedMessages(ns, undefined, false, false, 'pull');
             }
             for (const fetch of deferredKeyFetches.values()) {
                 this.scheduleSenderIKFetch(fetch.fromAid, fetch.senderDeviceId, fetch.groupId);
@@ -2053,10 +2206,20 @@ export class V2E2EECoordinator {
                     lastAutoAckSeq = Math.max(lastAutoAckSeq, ackSeq);
                 }
             }
+            client._delivery.syncProgress(ns, {
+                rawCount: messages.length,
+                pulledCount: decrypted.length - pageDecryptedBefore,
+                remaining: result.remaining,
+                hasMore: hasMoreField ? hasMore : undefined,
+                currentSeq: client._seqTracker.getContiguousSeq(ns),
+                targetSeq: serverHead,
+            });
             const nextAfter = Math.max(pageMaxSeq, nextAfterSeq);
             if (!ownsCursor)
                 break;
             const rawCount = messages.length;
+            if (blockedSeq > 0)
+                break;
             const shouldContinue = shouldContinueForwardPage({
                 rawCount,
                 nextAfterSeq,
@@ -2090,6 +2253,20 @@ export class V2E2EECoordinator {
         client._clientLog.debug(`group.v2.pull done: group=${gid}, requested_after_seq=${afterSeq}, pages=${pageCount}, decrypted=${decrypted.length}, ns=${ns}`);
         return decrypted;
     }
+    async pullGroupV2(groupId, afterSeq = 0, limit = 50, opts) {
+        if (opts?.ownsCursor === false) {
+            return await this.pullGroupV2Impl(groupId, afterSeq, limit, opts);
+        }
+        const ns = `group:${String(groupId ?? '').trim()}`;
+        this.client._delivery.syncStarted(ns);
+        try {
+            return await this.pullGroupV2Impl(groupId, afterSeq, limit, opts);
+        }
+        catch (error) {
+            this.client._delivery.onPullAborted?.();
+            throw error;
+        }
+    }
     async confirmForwardGroupAck(groupId, upToSeq, groupAid) {
         const ns = `group:${String(groupId ?? '').trim()}`;
         try {
@@ -2649,7 +2826,7 @@ export class V2E2EECoordinator {
     async decryptV2PushMessage(data) {
         if (!isJsonObject(data))
             return null;
-        return await this.client._decryptV2Message(data, false, false, false, false);
+        return await this.client._decryptV2Message(data, false, false, false, false, undefined, false, 'inline_push');
     }
     handleGroupChangedSpk(data, groupId, action) {
         if (!this.client._v2Session || !groupId || !MEMBERSHIP_ACTIONS.has(action))