@zhin.js/adapter-telegram 5.0.1 → 5.0.3

package/lib/index.d.ts

@@ -1,18 +1,4 @@
-import { TelegramAdapter } from "./adapter.js";
-import { PageManager } from "@zhin.js/host-api";
-declare module "zhin.js" {
-    namespace Plugin {
-        interface Contexts {
-            web: PageManager;
-        }
-    }
-}
-declare module "zhin.js" {
-    interface Adapters {
-        telegram: TelegramAdapter;
-    }
-}
-export * from "./types.js";
-export { TelegramEndpoint } from "./endpoint.js";
-export { TelegramAdapter } from "./adapter.js";
-//# sourceMappingURL=index.d.ts.map
+export { TelegramEndpoint, type TelegramEndpointOptions, type TelegramFetch, } from './endpoint.js';
+export { botApiUrl, formatCallbackContent, formatInboundContent, formatOutboundActions, normalizeWebhookPath, resolveChannel, resolveTelegramConfig, senderDisplayName, type ResolvedTelegramConfig, type TelegramAdapterConfig, type TelegramCallbackQuery, type TelegramChat, type TelegramChatMember, type TelegramMessage, type TelegramOutboundAction, type TelegramUpdate, type TelegramUser, type TelegramWireSegment, } from './protocol.js';
+export { getTelegramAgentDeps, registerTelegramAgentEndpoint, setTelegramAgentDeps, type TelegramAgentDeps, type TelegramAgentEndpoint, } from './telegram-agent-deps.js';
+export { checkTelegramPlatformPermit, normalizeTelegramChatMember, platformPermit, registerTelegramPlatformPermitChecker, telegramGroupPermitResolver, } from './platform-permit.js';

package/lib/index.js

@@ -1,462 +1,4 @@
-/**
- * Telegram 适配器入口：类型扩展、导出、注册
- */
-import path from "node:path";
-import { usePlugin, createSceneManagementTools } from "zhin.js";
-import { TelegramAdapter } from "./adapter.js";
-import { platformPermit, registerTelegramPlatformPermitChecker, telegramGroupPermitResolver, } from "./platform-permit.js";
-export * from "./types.js";
-export { TelegramEndpoint } from "./endpoint.js";
-export { TelegramAdapter } from "./adapter.js";
-const plugin = usePlugin();
-const { provide, useContext } = plugin;
-provide({
-    name: "telegram",
-    description: "Telegram Endpoint Adapter",
-    mounted: async (p) => {
-        const adapter = new TelegramAdapter(p);
-        await adapter.start();
-        return adapter;
-    },
-    dispose: async (adapter) => {
-        await adapter.stop();
-    },
-});
-useContext('tool', 'telegram', (toolService, telegram) => {
-    const disposers = [];
-    disposers.push(registerTelegramPlatformPermitChecker());
-    const sceneTools = createSceneManagementTools(telegram, 'telegram', { permitResolver: telegramGroupPermitResolver, registerChecker: false });
-    disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
-    disposers.push(toolService.addTool({
-        name: 'telegram_pin_message',
-        description: '置顶 Telegram 群组消息',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                message_id: { type: 'string', description: '消息 ID' },
-            },
-            required: ['endpoint_id', 'chat_id', 'message_id'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        permissions: [platformPermit('pin_messages')],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const success = await endpoint.pinMessage(Number(args.chat_id), Number(args.message_id));
-            return { success, message: success ? '消息已置顶' : '操作失败' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_unpin_message',
-        description: '取消置顶 Telegram 群组消息',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                message_id: { type: 'string', description: '消息 ID（可选，不提供则取消所有置顶）' },
-            },
-            required: ['endpoint_id', 'chat_id'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        permissions: [platformPermit('pin_messages')],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const success = await endpoint.unpinMessage(Number(args.chat_id), args.message_id ? Number(args.message_id) : undefined);
-            return { success, message: success ? '已取消置顶' : '操作失败' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_list_admins',
-        description: '获取 Telegram 群组管理员列表',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-            },
-            required: ['endpoint_id', 'chat_id'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const admins = await endpoint.getChatAdmins(Number(args.chat_id));
-            return {
-                admins: admins.map((a) => ({
-                    user_id: a.user.id,
-                    username: a.user.username,
-                    first_name: a.user.first_name,
-                    status: a.status,
-                })),
-                count: admins.length,
-            };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_member_count',
-        description: '获取 Telegram 群组成员数量',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-            },
-            required: ['endpoint_id', 'chat_id'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const count = await endpoint.getChatMemberCount(Number(args.chat_id));
-            return { count, message: `群组共有 ${count} 名成员` };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_create_invite',
-        description: '创建 Telegram 群组邀请链接',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-            },
-            required: ['endpoint_id', 'chat_id'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        permissions: [platformPermit('chat_administrator')],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const link = await endpoint.createInviteLink(Number(args.chat_id));
-            return { invite_link: link, message: `邀请链接: ${link}` };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_send_poll',
-        description: '在 Telegram 群组中发起投票',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                question: { type: 'string', description: '投票问题' },
-                options: { type: 'string', description: '选项 JSON 数组，如 ["A","B","C"]' },
-                is_anonymous: { type: 'boolean', description: '是否匿名投票，默认 true' },
-                allows_multiple: { type: 'boolean', description: '是否允许多选，默认 false' },
-            },
-            required: ['endpoint_id', 'chat_id', 'question', 'options'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            let optList;
-            try {
-                optList = JSON.parse(args.options);
-            }
-            catch {
-                return { success: false, message: 'options 格式错误，应为 JSON 数组' };
-            }
-            if (!Array.isArray(optList) || optList.length < 2) {
-                return { success: false, message: '至少需要 2 个选项' };
-            }
-            const result = await endpoint.sendPoll(Number(args.chat_id), args.question, optList, args.is_anonymous ?? true, args.allows_multiple ?? false);
-            return { success: true, message_id: result.message_id, message: '投票已发送' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_react',
-        description: '对 Telegram 消息添加表情反应',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                message_id: { type: 'string', description: '消息 ID' },
-                reaction: { type: 'string', description: '反应表情（如 👍、❤️、🔥）' },
-            },
-            required: ['endpoint_id', 'chat_id', 'message_id', 'reaction'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const success = await endpoint.setMessageReaction(Number(args.chat_id), Number(args.message_id), args.reaction);
-            return { success, message: success ? `已添加反应 ${args.reaction}` : '操作失败' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_send_sticker',
-        description: '发送 Telegram 贴纸',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                sticker: { type: 'string', description: '贴纸 file_id 或 URL' },
-            },
-            required: ['endpoint_id', 'chat_id', 'sticker'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const result = await endpoint.sendStickerMessage(Number(args.chat_id), args.sticker);
-            return { success: true, message_id: result.message_id, message: '贴纸已发送' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_set_permissions',
-        description: '设置 Telegram 群组的默认成员权限',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                can_send_messages: { type: 'boolean', description: '是否可以发消息' },
-                can_send_photos: { type: 'boolean', description: '是否可以发图片' },
-                can_send_videos: { type: 'boolean', description: '是否可以发视频' },
-                can_send_polls: { type: 'boolean', description: '是否可以发投票' },
-                can_send_other_messages: { type: 'boolean', description: '是否可以发贴纸/GIF等' },
-                can_add_web_page_previews: { type: 'boolean', description: '是否可以添加网页预览' },
-                can_change_info: { type: 'boolean', description: '是否可以改群信息' },
-                can_invite_users: { type: 'boolean', description: '是否可以邀请用户' },
-                can_pin_messages: { type: 'boolean', description: '是否可以置顶消息' },
-            },
-            required: ['endpoint_id', 'chat_id'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        permissions: [platformPermit('manage_chat')],
-        execute: async (args) => {
-            const { endpoint: endpointId, chat_id, ...perms } = args;
-            const endpoint = telegram.endpoints.get(endpointId);
-            if (!endpoint)
-                throw new Error(`Endpoint ${endpointId} 不存在`);
-            const permissions = {};
-            for (const [k, v] of Object.entries(perms)) {
-                if (typeof v === 'boolean')
-                    permissions[k] = v;
-            }
-            const success = await endpoint.setChatPermissionsAll(Number(chat_id), permissions);
-            return { success, message: success ? '群权限已更新' : '操作失败' };
-        },
-    }, plugin.name));
-    disposers.push(toolService.addTool({
-        name: 'telegram_set_description',
-        description: '设置 Telegram 群组描述',
-        parameters: {
-            type: 'object',
-            properties: {
-                endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-                chat_id: { type: 'string', description: '聊天 ID' },
-                description: { type: 'string', description: '群描述文字' },
-            },
-            required: ['endpoint_id', 'chat_id', 'description'],
-        },
-        platforms: ['telegram'],
-        tags: ['telegram'],
-        execute: async (args) => {
-            const endpoint = telegram.endpoints.get(args.endpoint_id);
-            if (!endpoint)
-                throw new Error(`Endpoint ${args.endpoint_id} 不存在`);
-            const success = await endpoint.setChatDescription(Number(args.chat_id), args.description);
-            return { success, message: success ? '群描述已更新' : '操作失败' };
-        },
-    }, plugin.name));
-    return () => disposers.forEach(d => d());
-});
-// ── Web 控制台 ─────────────────────────────────────────────────────────
-useContext("web", (pageManager) => {
-    pageManager.addEntry({
-        id: "telegram",
-        development: path.resolve(import.meta.dirname, "../client/index.tsx"),
-        production: path.resolve(import.meta.dirname, "../dist/index.js"),
-        meta: { name: "Telegram" },
-    });
-});
-useContext("router", "telegram", (router, telegram) => {
-    router.get("/api/telegram/endpoints", async (ctx) => {
-        try {
-            const endpoints = Array.from(telegram.endpoints.values());
-            const result = endpoints.map((endpoint) => {
-                try {
-                    return {
-                        name: endpoint.$config.name,
-                        connected: endpoint.$connected || false,
-                        mode: endpoint.$config.polling !== false ? "polling" : "webhook",
-                        status: endpoint.$connected ? "online" : "offline",
-                        botInfo: endpoint.botInfo ? { username: endpoint.botInfo.username, firstName: endpoint.botInfo.first_name } : null,
-                    };
-                }
-                catch {
-                    return { name: endpoint.$config.name, connected: false, mode: "unknown", status: "error", botInfo: null };
-                }
-            });
-            ctx.body = { success: true, data: result };
-        }
-        catch {
-            ctx.status = 500;
-            ctx.body = { success: false, error: "获取 Endpoint 数据失败" };
-        }
-    });
-    // Endpoint 连接/断开
-    router.post("/api/telegram/endpoints/:name/connect", async (ctx) => {
-        try {
-            const endpoint = telegram.endpoints.get(ctx.params.name);
-            if (!endpoint) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Endpoint 不存在" };
-                return;
-            }
-            if (endpoint.$connected) {
-                ctx.body = { success: true, message: "已经在线" };
-                return;
-            }
-            await endpoint.$connect();
-            ctx.body = { success: true, message: "连接成功" };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e instanceof Error ? e.message : "连接失败" };
-        }
-    });
-    router.post("/api/telegram/endpoints/:name/disconnect", async (ctx) => {
-        try {
-            const endpoint = telegram.endpoints.get(ctx.params.name);
-            if (!endpoint) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Endpoint 不存在" };
-                return;
-            }
-            if (!endpoint.$connected) {
-                ctx.body = { success: true, message: "已经离线" };
-                return;
-            }
-            await endpoint.$disconnect();
-            ctx.body = { success: true, message: "已断开" };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e instanceof Error ? e.message : "断开失败" };
-        }
-    });
-    // 快捷操作：创建邀请链接
-    router.post("/api/telegram/endpoints/:name/invite", async (ctx) => {
-        try {
-            const endpoint = telegram.endpoints.get(ctx.params.name);
-            if (!endpoint) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Endpoint 不存在" };
-                return;
-            }
-            if (!endpoint.$connected) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "Endpoint 未连接" };
-                return;
-            }
-            const { chat_id } = ctx.request.body || {};
-            if (!chat_id) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "缺少 chat_id" };
-                return;
-            }
-            const link = await endpoint.createInviteLink(Number(chat_id));
-            ctx.body = { success: true, data: { invite_link: link } };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e instanceof Error ? e.message : "创建邀请链接失败" };
-        }
-    });
-    // 快捷操作：发起投票
-    router.post("/api/telegram/endpoints/:name/poll", async (ctx) => {
-        try {
-            const endpoint = telegram.endpoints.get(ctx.params.name);
-            if (!endpoint) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Endpoint 不存在" };
-                return;
-            }
-            if (!endpoint.$connected) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "Endpoint 未连接" };
-                return;
-            }
-            const { chat_id, question, options, is_anonymous, allows_multiple } = ctx.request.body || {};
-            if (!chat_id || !question || !options?.length) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "缺少 chat_id, question 或 options" };
-                return;
-            }
-            if (options.length < 2) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "至少需要 2 个选项" };
-                return;
-            }
-            const result = await endpoint.sendPoll(Number(chat_id), question, options, is_anonymous ?? true, allows_multiple ?? false);
-            ctx.body = { success: true, data: { message_id: result.message_id } };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e instanceof Error ? e.message : "发起投票失败" };
-        }
-    });
-    // 快捷操作：获取群管理员
-    router.get("/api/telegram/endpoints/:name/admins", async (ctx) => {
-        try {
-            const endpoint = telegram.endpoints.get(ctx.params.name);
-            if (!endpoint) {
-                ctx.status = 404;
-                ctx.body = { success: false, error: "Endpoint 不存在" };
-                return;
-            }
-            if (!endpoint.$connected) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "Endpoint 未连接" };
-                return;
-            }
-            const chat_id = ctx.query.chat_id;
-            if (!chat_id) {
-                ctx.status = 400;
-                ctx.body = { success: false, error: "缺少 chat_id" };
-                return;
-            }
-            const admins = await endpoint.getChatAdmins(Number(chat_id));
-            ctx.body = {
-                success: true,
-                data: admins.map((a) => ({
-                    user_id: a.user.id,
-                    username: a.user.username,
-                    first_name: a.user.first_name,
-                    status: a.status,
-                })),
-            };
-        }
-        catch (e) {
-            ctx.status = 500;
-            ctx.body = { success: false, error: e instanceof Error ? e.message : "获取管理员失败" };
-        }
-    });
-});
-//# sourceMappingURL=index.js.map
+export { TelegramEndpoint, } from './endpoint.js';
+export { botApiUrl, formatCallbackContent, formatInboundContent, formatOutboundActions, normalizeWebhookPath, resolveChannel, resolveTelegramConfig, senderDisplayName, } from './protocol.js';
+export { getTelegramAgentDeps, registerTelegramAgentEndpoint, setTelegramAgentDeps, } from './telegram-agent-deps.js';
+export { checkTelegramPlatformPermit, normalizeTelegramChatMember, platformPermit, registerTelegramPlatformPermitChecker, telegramGroupPermitResolver, } from './platform-permit.js';

package/lib/platform-permit.d.ts

@@ -1,7 +1,7 @@
 /**
  * Telegram platform permit — ChatMember 状态 + 细粒度权限
  */
-import type { Message } from 'zhin.js';
+import { type Message } from '@zhin.js/core';
 export declare function platformPermit(perm: string): string;
 export declare function telegramGroupPermitResolver(logicalPerm: string): string;
 export declare function normalizeTelegramChatMember(member: {
@@ -16,4 +16,3 @@ export declare function normalizeTelegramChatMember(member: {
 };
 export declare function checkTelegramPlatformPermit(perm: string, message: Message<any>): boolean;
 export declare function registerTelegramPlatformPermitChecker(): () => void;
-//# sourceMappingURL=platform-permit.d.ts.map

package/lib/platform-permit.js

@@ -1,4 +1,7 @@
-import { registerPlatformPermitChecker } from 'zhin.js';
+/**
+ * Telegram platform permit — ChatMember 状态 + 细粒度权限
+ */
+import { registerPlatformPermitChecker } from '@zhin.js/core';
 const ADAPTER = 'telegram';
 export function platformPermit(perm) {
     return `platform(${ADAPTER},${perm})`;
@@ -56,4 +59,3 @@ export function checkTelegramPlatformPermit(perm, message) {
 export function registerTelegramPlatformPermitChecker() {
     return registerPlatformPermitChecker(ADAPTER, checkTelegramPlatformPermit);
 }
-//# sourceMappingURL=platform-permit.js.map

package/lib/polling.d.ts

@@ -0,0 +1,9 @@
+import type { TelegramUpdate } from './protocol.js';
+export interface TelegramPollingHost {
+    readonly allowedUpdates: readonly string[];
+    callApi<T>(method: string, params?: Record<string, unknown>, signal?: AbortSignal): Promise<T>;
+    getUpdateOffset(): number;
+    setUpdateOffset(offset: number): void;
+    handleUpdate(update: TelegramUpdate): void;
+}
+export declare function runTelegramPollLoop(host: TelegramPollingHost, abortSignal: AbortSignal): Promise<void>;

package/lib/polling.js

@@ -0,0 +1,52 @@
+/**
+ * Telegram long-polling loop for getUpdates.
+ */
+import { formatCompact, getLogger } from '@zhin.js/logger';
+const logger = getLogger('telegram');
+const RETRY_DELAY_MS = 2_000;
+const BACKOFF_DELAY_MS = 10_000;
+const MAX_CONSECUTIVE_FAILURES = 5;
+const DEFAULT_POLL_TIMEOUT_SEC = 30;
+export async function runTelegramPollLoop(host, abortSignal) {
+    let consecutiveFailures = 0;
+    while (!abortSignal.aborted) {
+        try {
+            const updates = await host.callApi('getUpdates', {
+                offset: host.getUpdateOffset() || undefined,
+                timeout: DEFAULT_POLL_TIMEOUT_SEC,
+                allowed_updates: host.allowedUpdates,
+            }, abortSignal);
+            consecutiveFailures = 0;
+            for (const update of updates) {
+                host.setUpdateOffset(update.update_id + 1);
+                host.handleUpdate(update);
+            }
+        }
+        catch (err) {
+            if (abortSignal.aborted)
+                return;
+            consecutiveFailures += 1;
+            logger.error(formatCompact({
+                op: 'poll',
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+            }));
+            await sleep(consecutiveFailures >= MAX_CONSECUTIVE_FAILURES ? BACKOFF_DELAY_MS : RETRY_DELAY_MS, abortSignal);
+            if (consecutiveFailures >= MAX_CONSECUTIVE_FAILURES)
+                consecutiveFailures = 0;
+        }
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}