@agentunion/fastaun-browser 0.4.8 → 0.4.10

package/dist/client.js

@@ -81,6 +81,7 @@ const DEFAULT_SESSION_OPTIONS = {
 const RECONNECT_MIN_BASE_DELAY_SECONDS = 1.0;
 const RECONNECT_MAX_BASE_DELAY_SECONDS = 64.0;
 const TOKEN_REFRESH_CHECK_INTERVAL_MS = 30_000;
+const MAX_NOTIFY_PAYLOAD_SIZE = 64 * 1024;
 // 心跳间隔下/上限（秒）。0 = 关闭心跳；负值视为 0；其余值 clamp 到 [10, 600]。
 // 服务端通过 hello.heartbeat_interval 与 meta.ping pong 中的同名字段下发。
 const HEARTBEAT_MIN_INTERVAL_SECONDS = 10;
@@ -102,7 +103,7 @@ const NON_IDEMPOTENT_METHODS = new Set([
     'group.kick', 'group.remove_member', 'group.leave', 'group.dissolve',
     'group.update_name', 'group.update_avatar', 'group.update_announcement',
     'group.update_settings',
-    'storage.upload', 'storage.complete_upload', 'storage.delete',
+    'storage.create_upload_session', 'storage.complete_upload', 'storage.delete_object',
     'auth.create_aid', 'auth.renew_cert', 'auth.rekey',
     'message.thought.put', 'group.thought.put',
     'group.add_member',
@@ -146,7 +147,6 @@ function reconnectSleepDelaySeconds(baseDelay, maxBaseDelay) {
 }
 /** 对端证书缓存 TTL（秒） */
 const PEER_CERT_CACHE_TTL = 3600;
-const PEER_PREKEYS_CACHE_TTL = 3600;
 /**
  * 将 WebSocket URL 转为对应的 HTTP URL
  */
@@ -508,6 +508,8 @@ export class AUNClient {
     _pendingOrderedMsgs = new Map();
     /** Lazy group sync：首次发送群消息前自动拉取历史 */
     _groupSynced = new Set();
+    /** 群撤回去重：group_id|sorted(message_ids)|recalled_at -> 时间戳，保证应用层只回调一次 */
+    _groupRecallSeen = new Map();
     /** 在线未读 hint 队列：同一 group 只保留最后一条，延迟 drain 降低登录瞬时拉取压力。 */
     _onlineUnreadHintQueue = new Map();
     _onlineUnreadHintTimer = null;
@@ -661,6 +663,10 @@ export class AUNClient {
         this._dispatcher.subscribe('_raw.group.message_created', (data) => {
             this._onRawGroupMessageCreated(data);
         });
+        // 群组消息撤回推送：在线 push 通道，与 pull 双 tombstone 兜底互补（SDK 去重只回调一次）
+        this._dispatcher.subscribe('_raw.group.message_recalled', (data) => {
+            this._safeAsync(this._onRawGroupMessageRecalled(data));
+        });
         // 群组变更事件：验签 + 透传 + gap 检测
         this._dispatcher.subscribe('_raw.group.changed', (data) => {
             this._onRawGroupChanged(data);
@@ -928,66 +934,11 @@ export class AUNClient {
     }
     /** 断开连接但保留本地状态，可再次 connect */
     async disconnect() {
-        const tStart = Date.now();
-        this._clientLog.debug(`disconnect enter: state=${this._state}`);
-        if (this._closing) {
-            this._clientLog.debug(`disconnect exit: elapsed=${Date.now() - tStart}ms reason=closing`);
-            return;
-        }
-        if (![
-            ConnectionState.AUTHENTICATED,
-            ConnectionState.CONNECTING,
-            ConnectionState.READY,
-            ConnectionState.RETRY_BACKOFF,
-            ConnectionState.RECONNECTING,
-            ConnectionState.CONNECTION_FAILED,
-        ].includes(this.state)) {
-            this._clientLog.debug(`disconnect exit: elapsed=${Date.now() - tStart}ms reason=not_connected`);
-            return;
-        }
-        this._saveSeqTrackerState();
-        this._stopBackgroundTasks();
-        if (this._reconnectAbort) {
-            this._reconnectAbort.abort();
-            this._reconnectAbort = null;
-            this._reconnectActive = false;
-        }
-        await this._transport.close();
-        this._state = 'standby';
-        await this._dispatcher.publish('state_change', { state: this._publicState(this._state) });
-        this._clientLog.debug(`disconnect exit: elapsed=${Date.now() - tStart}ms`);
+        return this._lifecycle.disconnect();
     }
     /** 关闭连接 */
     async close() {
-        const tStart = Date.now();
-        this._clientLog.debug(`close enter: state=${this._state}`);
-        this._closing = true;
-        this._saveSeqTrackerState();
-        this._stopBackgroundTasks();
-        // 取消进行中的重连
-        if (this._reconnectAbort) {
-            this._reconnectAbort.abort();
-            this._reconnectAbort = null;
-            this._reconnectActive = false;
-        }
-        if (this._state === 'idle' || this._state === 'closed') {
-            this._state = 'closed';
-            this._resetSeqTrackingState();
-            this._clientLog.debug(`close exit: elapsed=${Date.now() - tStart}ms reason=already_idle`);
-            return;
-        }
-        // 关闭前通知服务端主动退出（best-effort，失败不阻塞）
-        try {
-            await this._transport.call('auth.logout', {});
-        }
-        catch {
-            // auth.logout 失败不影响关闭流程
-        }
-        await this._transport.close();
-        this._state = 'closed';
-        await this._dispatcher.publish('state_change', { state: this._publicState(this._state) });
-        this._resetSeqTrackingState();
-        this._clientLog.debug(`close exit: elapsed=${Date.now() - tStart}ms`);
+        return this._lifecycle.close();
     }
     // ── RPC ───────────────────────────────────────────
     /**
@@ -997,136 +948,91 @@ export class AUNClient {
      * 自动解密 message.pull/group.pull、Group E2EE 生命周期编排。
      */
     async call(method, params) {
-        const tStart = Date.now();
-        this._clientLog.debug(`call enter: method=${method}`);
-        try {
-            const result = await this._callImpl(method, params);
-            this._clientLog.debug(`call exit: elapsed=${Date.now() - tStart}ms method=${method}`);
-            return result;
-        }
-        catch (err) {
-            this._clientLog.debug(`call exit (error): elapsed=${Date.now() - tStart}ms method=${method} err=${err instanceof Error ? err.message : String(err)}`);
-            throw err;
-        }
+        return await this._rpcPipeline.call(method, params);
     }
-    async _callImpl(method, params) {
-        const p = this._rpcPipeline.preflight(method, params).params;
-        // 自动加密：message.send 默认加密（encrypt 默认 true）— V2-only
-        if (method === 'message.send') {
-            const encrypt = p.encrypt !== undefined ? p.encrypt : true;
-            delete p.encrypt;
-            if (encrypt) {
-                await this._ensureV2SessionReady('message.send', 'V2 session not initialized; encrypted message.send requires V2 (V1 E2EE removed)');
-                this._clientLog.debug('call route: message.send → V2 encrypted send');
-                return await this._sendV2(String(p.to ?? ''), p.payload ?? {}, {
-                    messageId: String(p.message_id ?? '') || undefined,
-                    timestamp: p.timestamp,
-                    protectedHeaders: this._protectedHeadersFromParams(p),
-                    context: isJsonObject(p.context) ? p.context : undefined,
-                });
-            }
-            // encrypt=false：明文走通用 RPC 路径；protected_headers/headers 是信封元数据，加密与否都保留
-            this._maybeAppendEchoTraceSend(p);
-        }
-        // 自动加密：group.send 默认加密（encrypt 默认 true）— V2-only
-        if (method === 'group.send') {
-            const encrypt = p.encrypt !== undefined ? p.encrypt : true;
-            delete p.encrypt;
-            if (encrypt) {
-                await this._ensureV2SessionReady('group.send', 'V2 session not initialized; encrypted group.send requires V2 (V1 E2EE removed)');
-                this._clientLog.debug('call route: group.send → V2 encrypted send');
-                return await this._sendGroupV2(String(p.group_id ?? ''), p.payload ?? {}, {
-                    messageId: String(p.message_id ?? '') || undefined,
-                    timestamp: p.timestamp,
-                    protectedHeaders: this._protectedHeadersFromParams(p),
-                    context: isJsonObject(p.context) ? p.context : undefined,
-                });
-            }
-            this._maybeAppendEchoTraceSend(p);
-        }
-        if (method === 'group.thought.put') {
-            const encrypt = p.encrypt !== undefined ? p.encrypt : true;
-            delete p.encrypt;
-            if (encrypt) {
-                await this._ensureV2SessionReady('group.thought.put', 'V2 session not initialized; encrypted group.thought.put requires V2 (V1 E2EE removed)');
-                this._clientLog.debug('call route: group.thought.put → V2 encrypted put');
-                return this._putGroupThoughtEncryptedV2(p);
-            }
+    static _notifyParamsSizeOk(params) {
+        return new TextEncoder().encode(JSON.stringify(params)).length <= MAX_NOTIFY_PAYLOAD_SIZE;
+    }
+    static _validateNotifyEventMethod(method) {
+        const normalized = String(method ?? '').trim();
+        if (!normalized.startsWith('event/app.') || normalized.length <= 'event/app.'.length) {
+            throw new ValidationError('routed notify method must be event/app.*');
         }
-        if (method === 'message.thought.put') {
-            const encrypt = p.encrypt !== undefined ? p.encrypt : true;
-            delete p.encrypt;
-            if (encrypt) {
-                await this._ensureV2SessionReady('message.thought.put', 'V2 session not initialized; encrypted message.thought.put requires V2 (V1 E2EE removed)');
-                this._clientLog.debug('call route: message.thought.put → V2 encrypted put');
-                return this._putMessageThoughtEncryptedV2(p);
-            }
+        return normalized;
+    }
+    static _normalizeNotifyTtl(value) {
+        if (value === undefined || value === null)
+            return undefined;
+        const ttl = Number(value);
+        if (!Number.isInteger(ttl)) {
+            throw new ValidationError('ttl_ms must be an integer');
         }
-        // Pull Gate：序列化同一 key 的 pull 操作，防止并发重复拉取
-        const pullGateKey = this._pullGateKeyForCall(method, p);
-        if (pullGateKey) {
-            return await this._runPullSerialized(pullGateKey, async () => {
-                return await this._callImplInner(method, p);
-            });
+        if (ttl < 0 || ttl > 60000) {
+            throw new ValidationError('ttl_ms must be between 0 and 60000');
         }
-        return await this._callImplInner(method, p);
+        return ttl;
     }
     /**
-     * _callImpl 的内层：pull gate 之后的实际 RPC 分发逻辑。
-     * 拆分出来以便 pull gate 包裹整个操作。
+     * 发送轻量在线通知，不走离线存储、seq/pull 或 ack。
      */
-    async _callImplInner(method, p) {
-        // message.pull：V2-only，按需初始化后走 V2 pull
-        if (method === 'message.pull') {
-            await this._ensureV2SessionReady('message.pull');
-            this._clientLog.debug('call route: message.pull → V2 pull');
-            const messages = await this._pullV2(Number(p.after_seq ?? 0) || 0, Number(p.limit ?? 50) || 50, { force: p.force === true });
-            return { messages };
-        }
-        // message.ack：V2-only，按需初始化后走 V2 ack
-        if (method === 'message.ack') {
-            await this._ensureV2SessionReady('message.ack');
-            this._clientLog.debug('call route: message.ack → V2 ack');
-            return await this._ackV2(Number(p.seq ?? p.up_to_seq ?? 0) || undefined);
-        }
-        // group.pull：V2-only，按需初始化后走 V2 pull
-        if (method === 'group.pull' && p.group_id) {
-            await this._ensureV2SessionReady('group.pull');
-            this._clientLog.debug('call route: group.pull → V2 pull');
-            const hasExplicitAfterSeq = 'after_seq' in p || 'after_message_seq' in p;
-            const cursorParams = this._explicitGroupCursorParams(p);
-            const ownsCursor = Object.keys(cursorParams).length === 0 || this._groupCursorTargetsCurrentInstance(cursorParams);
-            const pullOpts = {};
-            if (hasExplicitAfterSeq)
-                pullOpts.explicitAfterSeq = true;
-            if (Object.keys(cursorParams).length > 0)
-                pullOpts.cursorParams = cursorParams;
-            if (!ownsCursor)
-                pullOpts.ownsCursor = false;
-            const messages = await this._pullGroupV2(String(p.group_id), Number(p.after_seq ?? p.after_message_seq ?? 0) || 0, Number(p.limit ?? 50) || 50, Object.keys(pullOpts).length > 0 ? pullOpts : undefined);
-            return { messages };
-        }
-        // group.ack_messages：V2-only，按需初始化后走 V2 ack
-        if (method === 'group.ack_messages' && p.group_id) {
-            await this._ensureV2SessionReady('group.ack_messages');
-            this._clientLog.debug('call route: group.ack_messages → V2 ack');
-            const cursorParams = this._explicitGroupCursorParams(p);
-            const ownsCursor = Object.keys(cursorParams).length === 0 || this._groupCursorTargetsCurrentInstance(cursorParams);
-            if (!ownsCursor) {
-                return await this._rawGroupAckMessages(p);
+    async notify(method, params, options = {}) {
+        if (params !== undefined && params !== null && !isJsonObject(params)) {
+            throw new ValidationError('notify params must be an object');
+        }
+        const payload = { ...(params ?? {}) };
+        if (!AUNClient._notifyParamsSizeOk(payload)) {
+            throw new ValidationError('notify payload is too large');
+        }
+        const targetAid = String(options.to ?? '').trim();
+        const targetGroupId = String(options.group_id ?? options.groupId ?? '').trim();
+        const targetDeviceId = String(options.device_id ?? options.deviceId ?? '').trim();
+        const targetSlotId = String(options.slot_id ?? options.slotId ?? '').trim();
+        const ttl = AUNClient._normalizeNotifyTtl(options.ttl_ms ?? options.ttlMs);
+        if (targetAid && targetGroupId) {
+            throw new ValidationError('notify() cannot set both to and group_id');
+        }
+        if (targetSlotId && !targetDeviceId) {
+            throw new ValidationError('slot_id requires device_id for notify target');
+        }
+        if (targetAid) {
+            const eventMethod = AUNClient._validateNotifyEventMethod(method);
+            const target = { type: 'aid', aid: targetAid };
+            if (targetDeviceId)
+                target.device_id = targetDeviceId;
+            if (targetSlotId)
+                target.slot_id = targetSlotId;
+            const routeParams = {
+                target,
+                deliver: { method: eventMethod, params: payload },
+            };
+            if (ttl !== undefined)
+                routeParams.ttl_ms = ttl;
+            await this._transport.notify('notification/route', routeParams);
+            return;
+        }
+        if (targetGroupId) {
+            const eventMethod = AUNClient._validateNotifyEventMethod(method);
+            const normalizedGroupId = normalizeGroupId(targetGroupId);
+            if (!normalizedGroupId) {
+                throw new ValidationError('group_id is required for group notify');
             }
-            return await this._ackGroupV2(String(p.group_id), Number(p.seq ?? p.msg_seq ?? p.up_to_seq ?? 0) || undefined);
-        }
-        // 关键操作自动附加客户端签名
-        await this._rpcPipeline.applyClientSignature(method, p);
-        // P1-23: 非幂等方法使用更长超时
-        const callTimeout = NON_IDEMPOTENT_METHODS.has(method) ? NON_IDEMPOTENT_TIMEOUT : undefined;
-        let result = callTimeout
-            ? await this._transport.call(method, p, callTimeout)
-            : await this._transport.call(method, p);
-        result = await this._rpcPipeline.postprocessResult(method, p, result);
-        // ── Group E2EE 自动编排已移除（V2-only：由 group.v2.bootstrap 驱动）────────
-        return result;
+            const routeParams = {
+                group_id: normalizedGroupId,
+                deliver: { method: eventMethod, params: payload },
+            };
+            if (ttl !== undefined)
+                routeParams.ttl_ms = ttl;
+            await this._transport.notify('notification/group.route', routeParams);
+            return;
+        }
+        if (targetDeviceId || targetSlotId) {
+            throw new ValidationError('device_id and slot_id require to');
+        }
+        const directMethod = String(method ?? '').trim();
+        if (!directMethod.startsWith('notification/')) {
+            throw new ValidationError('direct notify method must start with notification/');
+        }
+        await this._transport.notify(directMethod, payload);
     }
     async _callRawV2Rpc(method, params) {
         const p = { ...(params ?? {}) };
@@ -1170,55 +1076,30 @@ export class AUNClient {
     _onRawMessageReceived(data) {
         this._delivery.onRawMessageReceived(data);
     }
-    /** 实际处理推送消息的异步任务（V2-only：明文消息直接透传，V2 加密消息走 _onV2PushNotification） */
-    async _processAndPublishMessage(data) {
-        return this._delivery.processAndPublishMessage(data);
-    }
     /** 处理群组消息推送：re-publish（V2 加密消息走 V2 push 路径） */
     _onRawGroupMessageCreated(data) {
         return this._delivery.onRawGroupMessageCreated(data);
     }
+    async _onRawGroupMessageRecalled(data) {
+        return this._delivery.onRawGroupMessageRecalled(data);
+    }
     /** 处理 V2 群消息通知：主动 pull V2 envelope，由 pullGroupV2 解密并发布。 */
     async _onRawGroupV2MessageCreated(data) {
         return this._delivery.onRawGroupV2MessageCreated(data);
     }
-    /**
-     * 处理群组推送消息的异步任务（V2-only：明文消息直接透传）。
-     *
-     * 带 payload 的事件（消息推送）：直接 re-publish。
-     * 不带 payload 的事件（通知）：自动 pull 最新消息。
-     */
-    async _processAndPublishGroupMessage(data) {
-        return this._delivery.processAndPublishGroupMessage(data);
-    }
     async _publishEncryptedPushMessage(normalEvent, undecryptableEvent, ns, seq, msg, group) {
         return await this._v2E2EE.publishEncryptedPushMessage(normalEvent, undecryptableEvent, ns, seq, msg, group);
     }
     async _decryptV2PushMessage(data) {
         return await this._v2E2EE.decryptV2PushMessage(data);
     }
-    /** 后台补齐群消息空洞 */
-    async _fillGroupGap(groupId) {
-        return this._delivery.fillGroupGap(groupId);
-    }
-    /** 后台补齐群事件空洞 */
-    async _fillGroupEventGap(groupId) {
-        return this._delivery.fillGroupEventGap(groupId);
-    }
     /** 后台补齐 P2P 消息空洞 */
     async _fillP2pGap() {
         return this._delivery.fillP2pGap();
     }
-    /** 只按硬上限裁剪 published guard，不能按 contiguousSeq 清理。 */
-    _prunePushedSeqs(ns) {
-        this._delivery.prunePushedSeqs(ns);
-    }
     _markPublishedSeq(ns, seq) {
         this._delivery.markPublishedSeq(ns, seq);
     }
-    _attachCurrentInstanceContext(payload) {
-        return this._delivery.attachCurrentInstanceContext(payload);
-    }
     async _publishAppEvent(event, payload) {
         await this._delivery.publishAppEvent(event, payload);
     }
@@ -1261,9 +1142,6 @@ export class AUNClient {
         const trace = `${this._echoTimestamp()} [AUN-SDK.receive] aid=${this._aid ?? '-'} conn_uptime=${uptime}s`;
         msg.payload = { ...payload, text: payload.text + '\n' + trace };
     }
-    _messageTargetsCurrentInstance(message) {
-        return this._delivery.messageTargetsCurrentInstance(message);
-    }
     async _drainOrderedMessages(ns, beforeSeq) {
         await this._delivery.drainOrderedMessages(ns, beforeSeq);
     }
@@ -1420,82 +1298,6 @@ export class AUNClient {
         const digest = await crypto.subtle.digest('SHA-256', certBytes);
         return 'sha256:' + Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, '0')).join('');
     }
-    /**
-     * 从 X.509 DER 证书中提取 SubjectPublicKeyInfo 并计算其 SHA-256 指纹。
-     * 返回 "sha256:<hex>"，提取失败返回空串。
-     * 用于 H7 指纹校验（DER 证书指纹 OR SPKI 指纹任一匹配）。
-     */
-    async _spkiFingerprint(certPem) {
-        try {
-            const der = new Uint8Array(pemToArrayBuffer(certPem));
-            // X.509: Certificate ::= SEQUENCE { tbsCertificate, signatureAlgorithm, signatureValue }
-            // tbsCertificate ::= SEQUENCE { version?, serialNumber, signature, issuer, validity, subject, subjectPublicKeyInfo, ... }
-            // 逐级解析 SEQUENCE 并定位 SPKI (第 7 个或第 6 个子元素，取决于 version 是否 [0] explicit)。
-            const readLen = (buf, pos) => {
-                const first = buf[pos];
-                if (first < 0x80)
-                    return { len: first, next: pos + 1 };
-                const n = first & 0x7f;
-                let len = 0;
-                for (let i = 0; i < n; i++)
-                    len = (len << 8) | buf[pos + 1 + i];
-                return { len, next: pos + 1 + n };
-            };
-            // 外层 SEQUENCE
-            if (der[0] !== 0x30)
-                return '';
-            const outer = readLen(der, 1);
-            // tbsCertificate SEQUENCE 起点
-            const tbsStart = outer.next;
-            if (der[tbsStart] !== 0x30)
-                return '';
-            const tbsLen = readLen(der, tbsStart + 1);
-            let p = tbsLen.next;
-            const tbsEnd = tbsLen.next + tbsLen.len;
-            // 跳过 [0] EXPLICIT Version（可选）
-            if (der[p] === 0xa0) {
-                const lv = readLen(der, p + 1);
-                p = lv.next + lv.len;
-            }
-            // 跳过 serialNumber (INTEGER)
-            if (der[p] !== 0x02)
-                return '';
-            let lv = readLen(der, p + 1);
-            p = lv.next + lv.len;
-            // 跳过 signature (SEQUENCE)
-            if (der[p] !== 0x30)
-                return '';
-            lv = readLen(der, p + 1);
-            p = lv.next + lv.len;
-            // 跳过 issuer (SEQUENCE)
-            if (der[p] !== 0x30)
-                return '';
-            lv = readLen(der, p + 1);
-            p = lv.next + lv.len;
-            // 跳过 validity (SEQUENCE)
-            if (der[p] !== 0x30)
-                return '';
-            lv = readLen(der, p + 1);
-            p = lv.next + lv.len;
-            // 跳过 subject (SEQUENCE)
-            if (der[p] !== 0x30)
-                return '';
-            lv = readLen(der, p + 1);
-            p = lv.next + lv.len;
-            // subjectPublicKeyInfo (SEQUENCE) — 连同 tag+length+value 全部即 SPKI DER
-            if (der[p] !== 0x30 || p >= tbsEnd)
-                return '';
-            const spkiStart = p;
-            const spkiLV = readLen(der, p + 1);
-            const spkiEnd = spkiLV.next + spkiLV.len;
-            const spkiDer = der.subarray(spkiStart, spkiEnd);
-            const digest = await crypto.subtle.digest('SHA-256', spkiDer);
-            return 'sha256:' + Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, '0')).join('');
-        }
-        catch {
-            return '';
-        }
-    }
     async _decryptGroupThoughts(result) {
         return await this._v2E2EE.decryptGroupThoughts(result);
     }
@@ -2046,12 +1848,6 @@ export class AUNClient {
     _validateMessageRecipient(toAid) {
         this._rpcPipeline.validateMessageRecipient(toAid);
     }
-    _validateOutboundCall(method, params) {
-        this._rpcPipeline.validateOutboundCall(method, params);
-    }
-    _injectMessageCursorContext(method, params) {
-        this._rpcPipeline.injectMessageCursorContext(method, params);
-    }
     // ── 内部：断线重连 ────────────────────────────────
     /** 不重连 close code 集合：认证失败/权限错误/被踢等，重连无意义 */
     static _NO_RECONNECT_CODES = new Set([4001, 4003, 4008, 4009, 4010, 4011, 4012, 4013, 4014, 4015]);
@@ -2454,9 +2250,6 @@ export class AUNClient {
     _scheduleV2SenderIKPending(args) {
         return this._v2E2EE.scheduleSenderIKPending(args);
     }
-    async _resolveV2SenderIKPending(fromAid, senderDeviceId, groupId, fetchKey) {
-        return await this._v2E2EE.resolveSenderIKPending(fromAid, senderDeviceId, groupId, fetchKey);
-    }
     /**
      * V2 P2P 加密发送（推测性：用缓存 bootstrap 直接发，失败刷新重试一次）。
      *
@@ -2826,9 +2619,6 @@ export class AUNClient {
             && (!slotId || slotId === (this._slotId ?? ''));
     }
     // ── Pull Gate（序列化同一 key 的并发 pull）──────────────────
-    _pullGateKeyForCall(method, params) {
-        return this._rpcPipeline.pullGateKeyForCall(method, params);
-    }
     async _runPullSerialized(key, operation) {
         return await this._rpcPipeline.runPullSerialized(key, operation);
     }