@jingyi0605/codingns 0.6.5 → 0.7.1

package/dist/server/modules/channels/channel-gateway-service.d.ts

@@ -0,0 +1,24 @@
+import type { ChannelAccount } from "../../types/domain.js";
+import type { ChannelBridgeService } from "./channel-bridge-service.js";
+import type { ChannelPlatformAdapterRegistry, ChannelWebhookRequestContext } from "./channel-platform-adapters.js";
+import type { ChannelDeliveryService } from "./channel-delivery-service.js";
+interface ChannelAccountRepository {
+    findById(id: string): ChannelAccount | null;
+}
+interface LoggerLike {
+    error(message: string, detail?: unknown): void;
+}
+export declare class ChannelGatewayService {
+    private readonly channelAccountRepository;
+    private readonly adapterRegistry;
+    private readonly channelBridgeService;
+    private readonly channelDeliveryService;
+    private readonly logger;
+    constructor(channelAccountRepository: ChannelAccountRepository, adapterRegistry: ChannelPlatformAdapterRegistry, channelBridgeService: Pick<ChannelBridgeService, "dispatchInboundText">, channelDeliveryService: Pick<ChannelDeliveryService, "deliverAssistantReply">, logger?: LoggerLike);
+    handlePublicWebhook(channelAccountId: string, request: ChannelWebhookRequestContext): Promise<{
+        statusCode: number;
+        body: Record<string, unknown> | string;
+    }>;
+    private requireWebhookAccount;
+}
+export {};

package/dist/server/modules/channels/channel-gateway-service.js

@@ -0,0 +1,56 @@
+import { AppError } from "../../shared/errors/app-error.js";
+export class ChannelGatewayService {
+    channelAccountRepository;
+    adapterRegistry;
+    channelBridgeService;
+    channelDeliveryService;
+    logger;
+    constructor(channelAccountRepository, adapterRegistry, channelBridgeService, channelDeliveryService, logger = console) {
+        this.channelAccountRepository = channelAccountRepository;
+        this.adapterRegistry = adapterRegistry;
+        this.channelBridgeService = channelBridgeService;
+        this.channelDeliveryService = channelDeliveryService;
+        this.logger = logger;
+    }
+    async handlePublicWebhook(channelAccountId, request) {
+        const account = this.requireWebhookAccount(channelAccountId);
+        const adapter = this.adapterRegistry.require(account.platformCode);
+        const parsed = await adapter.parseWebhook(account, request);
+        for (const inboundMessage of parsed.inboundMessages) {
+            const dispatch = await this.channelBridgeService.dispatchInboundText(account.id, inboundMessage);
+            if (dispatch.dispatch.mode === "duplicate") {
+                continue;
+            }
+            void this.channelDeliveryService.deliverAssistantReply(dispatch).catch((error) => {
+                this.logger.error("[channel-gateway] async delivery failed", {
+                    accountId: account.id,
+                    externalEventId: inboundMessage.externalEventId,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+            });
+        }
+        return {
+            statusCode: parsed.statusCode,
+            body: parsed.body
+        };
+    }
+    requireWebhookAccount(channelAccountId) {
+        const account = this.channelAccountRepository.findById(channelAccountId.trim());
+        if (!account) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "CHANNEL_ACCOUNT_NOT_FOUND",
+                detail: "目标通讯平台账号不存在"
+            });
+        }
+        if (account.connectionMode !== "webhook") {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "CHANNEL_WEBHOOK_UNSUPPORTED",
+                detail: "当前账号不是 webhook 模式"
+            });
+        }
+        return account;
+    }
+}
+//# sourceMappingURL=channel-gateway-service.js.map

package/dist/server/modules/channels/channel-gateway-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-gateway-service.js","sourceRoot":"","sources":["../../../../src/modules/channels/channel-gateway-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAiB5D,MAAM,OAAO,qBAAqB;IAEb;IACA;IACA;IACA;IACA;IALnB,YACmB,wBAAkD,EAClD,eAA+C,EAC/C,oBAAuE,EACvE,sBAA6E,EAC7E,SAAqB,OAAO;QAJ5B,6BAAwB,GAAxB,wBAAwB,CAA0B;QAClD,oBAAe,GAAf,eAAe,CAAgC;QAC/C,yBAAoB,GAApB,oBAAoB,CAAmD;QACvE,2BAAsB,GAAtB,sBAAsB,CAAuD;QAC7E,WAAM,GAAN,MAAM,CAAsB;IAC5C,CAAC;IAEJ,KAAK,CAAC,mBAAmB,CACvB,gBAAwB,EACxB,OAAqC;QAKrC,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE5D,KAAK,MAAM,cAAc,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YACjG,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC3C,SAAS;YACX,CAAC;YAED,KAAK,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC/E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE;oBAC3D,SAAS,EAAE,OAAO,CAAC,EAAE;oBACrB,eAAe,EAAE,cAAc,CAAC,eAAe;oBAC/C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAAC,gBAAwB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,2BAA2B;gBACtC,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,6BAA6B;gBACxC,MAAM,EAAE,mBAAmB;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/server/modules/channels/channel-platform-adapters.d.ts

@@ -0,0 +1,46 @@
+import type { ChannelAccount, ChannelPlatformCode, ChannelThread } from "../../types/domain.js";
+import type { NormalizedChannelInboundMessage } from "./channel-bridge-service.js";
+import type { WechatClawRuntimeClient } from "./wechat-claw-runtime-client.js";
+export interface ChannelWebhookRequestContext {
+    method: string;
+    headers: Record<string, string | string[] | undefined>;
+    query: Record<string, unknown>;
+    body: unknown;
+}
+export interface ChannelWebhookParseResult {
+    statusCode: number;
+    body: Record<string, unknown> | string;
+    inboundMessages: NormalizedChannelInboundMessage[];
+}
+export interface ChannelPollResult {
+    inboundMessages: NormalizedChannelInboundMessage[];
+    runtimeStatePatch?: Record<string, unknown>;
+    detail?: string;
+}
+export interface ChannelSendTextResult {
+    status: "sent" | "skipped";
+    providerMessageRef: string | null;
+    detail?: string;
+    runtimeStatePatch?: Record<string, unknown>;
+}
+export interface ChannelProbeResult {
+    ok: boolean;
+    detail: string;
+    warnings: string[];
+}
+export interface ChannelPlatformAdapter {
+    readonly platformCode: ChannelPlatformCode;
+    parseWebhook(account: ChannelAccount, request: ChannelWebhookRequestContext): Promise<ChannelWebhookParseResult>;
+    poll(account: ChannelAccount): Promise<ChannelPollResult>;
+    sendText(account: ChannelAccount, thread: ChannelThread, text: string): Promise<ChannelSendTextResult>;
+    probe(account: ChannelAccount): Promise<ChannelProbeResult>;
+}
+export declare class ChannelPlatformAdapterRegistry {
+    private readonly adapters;
+    constructor(adapters: ChannelPlatformAdapter[]);
+    get(platformCode: ChannelPlatformCode): ChannelPlatformAdapter | null;
+    require(platformCode: ChannelPlatformCode): ChannelPlatformAdapter;
+}
+export declare function createDefaultChannelPlatformAdapterRegistry(options?: {
+    wechatClawRuntimeClient?: WechatClawRuntimeClient | null;
+}): ChannelPlatformAdapterRegistry;

package/dist/server/modules/channels/channel-platform-adapters.js

@@ -0,0 +1,315 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { createWechatClawRuntimeRequiredError, WECHAT_CLAW_RUNTIME_REQUIRED_DETAIL } from "./wechat-claw-runtime-boundary.js";
+export class ChannelPlatformAdapterRegistry {
+    adapters = new Map();
+    constructor(adapters) {
+        for (const adapter of adapters) {
+            this.adapters.set(adapter.platformCode, adapter);
+        }
+    }
+    get(platformCode) {
+        return this.adapters.get(platformCode) ?? null;
+    }
+    require(platformCode) {
+        const adapter = this.get(platformCode);
+        if (!adapter) {
+            throw new AppError({
+                statusCode: 500,
+                errorCode: "CHANNEL_PLATFORM_ADAPTER_NOT_FOUND",
+                detail: `平台 ${platformCode} 的适配器未注册`
+            });
+        }
+        return adapter;
+    }
+}
+export function createDefaultChannelPlatformAdapterRegistry(options = {}) {
+    return new ChannelPlatformAdapterRegistry([
+        new WechatClawChannelAdapter(options.wechatClawRuntimeClient ?? null),
+        new TelegramChannelAdapter()
+    ]);
+}
+class WechatClawChannelAdapter {
+    runtimeClient;
+    platformCode = "wechat-claw";
+    constructor(runtimeClient) {
+        this.runtimeClient = runtimeClient;
+    }
+    async parseWebhook(_account, _request) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "CHANNEL_WEBHOOK_UNSUPPORTED",
+            detail: "个人微信（claw）第一阶段只支持 polling，不支持 webhook"
+        });
+    }
+    async poll(account) {
+        const result = await this.requireRuntimeClient().poll(account);
+        return {
+            inboundMessages: result.inboundMessages.map((message) => ({
+                externalEventId: message.externalEventId,
+                externalConversationKey: message.externalConversationKey,
+                externalUserId: message.externalUserId,
+                externalThreadKey: message.externalThreadKey,
+                text: message.text,
+                senderDisplayName: message.senderDisplayName,
+                rawPayload: message.rawPayload,
+                transportContext: message.transportContext
+            })),
+            detail: result.detail
+        };
+    }
+    async sendText(account, thread, text) {
+        const result = await this.requireRuntimeClient().sendText(account, thread, text);
+        return {
+            status: result.status,
+            providerMessageRef: result.providerMessageRef,
+            detail: result.detail ?? undefined
+        };
+    }
+    async probe(account) {
+        if (!this.runtimeClient) {
+            return {
+                ok: false,
+                detail: WECHAT_CLAW_RUNTIME_REQUIRED_DETAIL,
+                warnings: []
+            };
+        }
+        const result = await this.runtimeClient.probe(account);
+        return {
+            ok: result.ok,
+            detail: result.detail,
+            warnings: result.warnings
+        };
+    }
+    requireRuntimeClient() {
+        if (!this.runtimeClient) {
+            throw createWechatClawRuntimeRequiredError();
+        }
+        return this.runtimeClient;
+    }
+}
+class TelegramChannelAdapter {
+    platformCode = "telegram";
+    async parseWebhook(_account, _request) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "CHANNEL_WEBHOOK_UNSUPPORTED",
+            detail: "Telegram 第一阶段只支持 polling，不支持 webhook"
+        });
+    }
+    async poll(account) {
+        const botToken = readRequiredConfiguredText(account.config, "botToken");
+        const offset = Number.parseInt(readBodyText(account.runtimeState, "telegramUpdateOffset") ?? "0", 10) || 0;
+        const response = await fetchJson(buildTelegramApiUrl(botToken, "getUpdates"), {
+            method: "POST",
+            body: JSON.stringify({
+                offset,
+                timeout: 0,
+                allowed_updates: ["message"]
+            }),
+            headers: {
+                "content-type": "application/json"
+            }
+        });
+        const payload = ensureTelegramOk(response, "Telegram getUpdates");
+        const updates = Array.isArray(payload.result) ? payload.result : [];
+        const inboundMessages = updates.flatMap((update) => {
+            const item = ensurePlainObject(update, "telegram update");
+            const message = ensurePlainObject(item.message, "telegram message");
+            const text = readBodyText(message, "text");
+            if (!text) {
+                return [];
+            }
+            const chatId = String(readNestedNumber(message, ["chat", "id"]) ?? invalidWebhook("Telegram 缺少 chat.id"));
+            const messageThreadId = readBodyText(message, "message_thread_id");
+            return [{
+                    externalEventId: String(item.update_id ?? createSyntheticEventId("telegram")),
+                    externalConversationKey: buildTelegramConversationKey(chatId, messageThreadId),
+                    externalUserId: readNestedNumber(message, ["from", "id"])?.toString() ?? null,
+                    externalThreadKey: messageThreadId,
+                    text,
+                    senderDisplayName: readNestedText(message, ["from", "username"])
+                        ?? readNestedText(message, ["from", "first_name"]),
+                    rawPayload: item,
+                    transportContext: {
+                        chatId,
+                        messageId: readBodyText(message, "message_id"),
+                        messageThreadId
+                    }
+                }];
+        });
+        const maxUpdateId = updates
+            .map((update) => Number(ensurePlainObject(update, "telegram update").update_id ?? 0))
+            .filter((value) => Number.isFinite(value))
+            .reduce((current, value) => Math.max(current, value), offset - 1);
+        return {
+            inboundMessages,
+            runtimeStatePatch: maxUpdateId >= offset
+                ? {
+                    telegramUpdateOffset: String(maxUpdateId + 1)
+                }
+                : undefined,
+            detail: `拉取到 ${inboundMessages.length} 条 Telegram 文本消息`
+        };
+    }
+    async sendText(account, thread, text) {
+        const botToken = readRequiredConfiguredText(account.config, "botToken");
+        const chatId = readRuntimeTransportText(thread.lastTransportContext, "chatId")
+            ?? parseTelegramConversationChatId(thread.externalConversationKey);
+        const messageThreadId = thread.externalThreadKey
+            ?? readRuntimeTransportText(thread.lastTransportContext, "messageThreadId");
+        const response = await fetchJson(buildTelegramApiUrl(botToken, "sendMessage"), {
+            method: "POST",
+            headers: {
+                "content-type": "application/json"
+            },
+            body: JSON.stringify({
+                chat_id: chatId,
+                text,
+                ...(messageThreadId ? { message_thread_id: Number(messageThreadId) } : {})
+            })
+        });
+        const payload = ensureTelegramOk(response, "Telegram sendMessage");
+        return {
+            status: "sent",
+            providerMessageRef: readNestedNumber(payload.result, ["message_id"])?.toString() ?? null
+        };
+    }
+    async probe(account) {
+        const botToken = readConfiguredText(account.config, "botToken");
+        if (!botToken) {
+            return {
+                ok: false,
+                detail: "缺少 botToken，Telegram 账号还不能工作。",
+                warnings: []
+            };
+        }
+        const response = await fetchJson(buildTelegramApiUrl(botToken, "getMe"));
+        const payload = ensureTelegramOk(response, "Telegram getMe");
+        return {
+            ok: true,
+            detail: `Telegram Bot 可用：${readNestedText(payload.result, ["username"]) ?? "unknown"}`,
+            warnings: []
+        };
+    }
+}
+function buildTelegramConversationKey(chatId, messageThreadId) {
+    return messageThreadId ? `${chatId}:thread:${messageThreadId}` : chatId;
+}
+function parseTelegramConversationChatId(conversationKey) {
+    return conversationKey.includes(":thread:")
+        ? conversationKey.split(":thread:")[0] ?? conversationKey
+        : conversationKey;
+}
+function ensureTelegramOk(response, label) {
+    const payload = ensurePlainObject(response, label);
+    if (payload.ok !== true) {
+        throw new AppError({
+            statusCode: 502,
+            errorCode: "CHANNEL_PLATFORM_REQUEST_FAILED",
+            detail: `${label} 失败：${readBodyText(payload, "description") ?? "unknown error"}`
+        });
+    }
+    return payload;
+}
+function buildTelegramApiUrl(botToken, method) {
+    return `https://api.telegram.org/bot${encodeURIComponent(botToken)}/${method}`;
+}
+function ensurePlainObject(value, field) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: `${field} 必须是对象`
+        });
+    }
+    return value;
+}
+function readBodyText(source, key) {
+    if (!source || typeof source !== "object" || Array.isArray(source)) {
+        return null;
+    }
+    const value = source[key];
+    if (typeof value === "string") {
+        const normalized = value.trim();
+        return normalized.length > 0 ? normalized : null;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return null;
+}
+function readNestedText(source, path) {
+    let current = source;
+    for (const key of path) {
+        if (!current || typeof current !== "object" || Array.isArray(current)) {
+            return null;
+        }
+        current = current[key];
+    }
+    if (typeof current === "string") {
+        const normalized = current.trim();
+        return normalized.length > 0 ? normalized : null;
+    }
+    if (typeof current === "number" && Number.isFinite(current)) {
+        return String(current);
+    }
+    return null;
+}
+function readNestedNumber(source, path) {
+    const text = readNestedText(source, path);
+    if (!text) {
+        return null;
+    }
+    const parsed = Number(text);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function readConfiguredText(config, key) {
+    return readBodyText(config, key);
+}
+function readRequiredConfiguredText(config, key) {
+    return readConfiguredText(config, key) ?? invalidConfig(`${key} 不能为空`);
+}
+function readRuntimeTransportText(transportContext, key) {
+    return readBodyText(transportContext, key);
+}
+function createSyntheticEventId(prefix) {
+    return `${prefix}:${Date.now()}:${Math.random().toString(16).slice(2, 10)}`;
+}
+function invalidWebhook(detail) {
+    throw new AppError({
+        statusCode: 400,
+        errorCode: "CHANNEL_WEBHOOK_INVALID",
+        detail
+    });
+}
+function invalidConfig(detail) {
+    throw new AppError({
+        statusCode: 400,
+        errorCode: "INVALID_INPUT",
+        detail
+    });
+}
+async function fetchJson(url, init) {
+    const response = await fetch(url, init);
+    const text = await response.text();
+    const payload = text ? safeJsonParse(text) : null;
+    if (!response.ok) {
+        throw new AppError({
+            statusCode: 502,
+            errorCode: "CHANNEL_PLATFORM_REQUEST_FAILED",
+            detail: `请求 ${url} 失败：${response.status} ${response.statusText}`
+        });
+    }
+    return payload;
+}
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {
+            raw: text
+        };
+    }
+}
+//# sourceMappingURL=channel-platform-adapters.js.map

package/dist/server/modules/channels/channel-platform-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-platform-adapters.js","sourceRoot":"","sources":["../../../../src/modules/channels/channel-platform-adapters.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/channels/channel-platform-catalog.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlatformCapability, ChannelPlatformCode } from "../../types/domain.js";
+export declare function listChannelPlatformCapabilities(): ChannelPlatformCapability[];
+export declare function getChannelPlatformCapability(platformCode: ChannelPlatformCode): ChannelPlatformCapability | null;

package/dist/server/modules/channels/channel-platform-catalog.js

@@ -0,0 +1,42 @@
+const CHANNEL_PLATFORM_CAPABILITIES = [
+    {
+        code: "wechat-claw",
+        displayName: "个人微信（claw）",
+        supportedConnectionModes: ["polling"],
+        multiSessionSupportLevel: "limited",
+        stageOneLimitations: [
+            "官方标准接法是把 openclaw-weixin 插件挂到 Gateway 运行时里，不是让 Host 直接承担微信收发。",
+            "当前仓库还没有接好这层官方运行时，所以个人微信（claw）账号先只保留平台位和管理位，不再伪装成已经支持扫码绑定、轮询和回发。"
+        ]
+    },
+    {
+        code: "telegram",
+        displayName: "Telegram",
+        supportedConnectionModes: ["polling"],
+        multiSessionSupportLevel: "supported",
+        stageOneLimitations: [
+            "第一阶段先打通文本消息，不承诺文件和复杂交互。",
+            "Telegram forum topic 已按 message_thread_id 区分 Butler control session，普通 chat 仍按 chat_id 映射。",
+            "当前已经接入手动 poll 和后台轮询任务，后续再补更完整的消息类型支持。"
+        ]
+    }
+];
+const CHANNEL_PLATFORM_CAPABILITY_MAP = new Map(CHANNEL_PLATFORM_CAPABILITIES.map((platform) => [platform.code, platform]));
+export function listChannelPlatformCapabilities() {
+    return CHANNEL_PLATFORM_CAPABILITIES.map((platform) => ({
+        ...platform,
+        supportedConnectionModes: [...platform.supportedConnectionModes],
+        stageOneLimitations: [...platform.stageOneLimitations]
+    }));
+}
+export function getChannelPlatformCapability(platformCode) {
+    const capability = CHANNEL_PLATFORM_CAPABILITY_MAP.get(platformCode);
+    return capability
+        ? {
+            ...capability,
+            supportedConnectionModes: [...capability.supportedConnectionModes],
+            stageOneLimitations: [...capability.stageOneLimitations]
+        }
+        : null;
+}
+//# sourceMappingURL=channel-platform-catalog.js.map

package/dist/server/modules/channels/channel-platform-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-platform-catalog.js","sourceRoot":"","sources":["../../../../src/modules/channels/channel-platform-catalog.ts"],"names":[],"mappings":"AAEA,MAAM,6BAA6B,GAAyC;IAC1E;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,YAAY;QACzB,wBAAwB,EAAE,CAAC,SAAS,CAAC;QACrC,wBAAwB,EAAE,SAAS;QACnC,mBAAmB,EAAE;YACnB,+DAA+D;YAC/D,iEAAiE;SAClE;KACF;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,UAAU;QACvB,wBAAwB,EAAE,CAAC,SAAS,CAAC;QACrC,wBAAwB,EAAE,WAAW;QACrC,mBAAmB,EAAE;YACnB,yBAAyB;YACzB,4FAA4F;YAC5F,uCAAuC;SACxC;KACF;CACO,CAAC;AAEX,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAC7C,6BAA6B,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAC3E,CAAC;AAEF,MAAM,UAAU,+BAA+B;IAC7C,OAAO,6BAA6B,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACtD,GAAG,QAAQ;QACX,wBAAwB,EAAE,CAAC,GAAG,QAAQ,CAAC,wBAAwB,CAAC;QAChE,mBAAmB,EAAE,CAAC,GAAG,QAAQ,CAAC,mBAAmB,CAAC;KACvD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,YAAiC;IAEjC,MAAM,UAAU,GAAG,+BAA+B,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAErE,OAAO,UAAU;QACf,CAAC,CAAC;YACE,GAAG,UAAU;YACb,wBAAwB,EAAE,CAAC,GAAG,UAAU,CAAC,wBAAwB,CAAC;YAClE,mBAAmB,EAAE,CAAC,GAAG,UAAU,CAAC,mBAAmB,CAAC;SACzD;QACH,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/server/modules/channels/channel-polling-scheduler.d.ts

@@ -0,0 +1,31 @@
+import { type SchedulerMetrics } from "../tasks/scheduler-metrics.js";
+import type { ChannelPollingService } from "./channel-polling-service.js";
+interface LoggerLike {
+    error(message: string, detail?: unknown): void;
+}
+export declare class ChannelPollingScheduler {
+    private readonly channelPollingService;
+    private readonly intervalMs;
+    private readonly maxIntervalMs;
+    private readonly now;
+    private readonly logger;
+    private readonly schedulerMetrics;
+    private timer;
+    private ticking;
+    private started;
+    private disposed;
+    private idleStreak;
+    constructor(channelPollingService: Pick<ChannelPollingService, "runDuePolls">, options?: {
+        intervalMs?: number;
+        maxIntervalMs?: number;
+        now?: () => string;
+        logger?: LoggerLike;
+        schedulerMetrics?: SchedulerMetrics;
+    });
+    start(): void;
+    dispose(): Promise<void>;
+    runOnce(): Promise<void>;
+    private scheduleNext;
+    private tick;
+}
+export {};

package/dist/server/modules/channels/channel-polling-scheduler.js

@@ -0,0 +1,93 @@
+import { nowIso } from "../../shared/utils/time.js";
+import { resolveAdaptiveSchedulerDelayMs } from "../tasks/scheduler-metrics.js";
+const DEFAULT_INTERVAL_MS = 15_000;
+export class ChannelPollingScheduler {
+    channelPollingService;
+    intervalMs;
+    maxIntervalMs;
+    now;
+    logger;
+    schedulerMetrics;
+    timer = null;
+    ticking = false;
+    started = false;
+    disposed = false;
+    idleStreak = 0;
+    constructor(channelPollingService, options = {}) {
+        this.channelPollingService = channelPollingService;
+        this.intervalMs = Math.max(5_000, options.intervalMs ?? DEFAULT_INTERVAL_MS);
+        this.maxIntervalMs = Math.max(this.intervalMs, options.maxIntervalMs ?? this.intervalMs * 8);
+        this.now = options.now ?? nowIso;
+        this.logger = options.logger ?? console;
+        this.schedulerMetrics = options.schedulerMetrics ?? null;
+    }
+    start() {
+        if (this.timer || this.disposed) {
+            return;
+        }
+        this.started = true;
+        this.scheduleNext(0);
+    }
+    async dispose() {
+        this.started = false;
+        this.disposed = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        while (this.ticking) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    async runOnce() {
+        await this.tick(false);
+    }
+    scheduleNext(delayMs) {
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.tick();
+        }, delayMs);
+        this.timer.unref?.();
+    }
+    async tick(shouldScheduleNext = true) {
+        if (this.ticking) {
+            return;
+        }
+        this.ticking = true;
+        const tickStartedAt = Date.now();
+        const referenceAt = this.now();
+        let result = null;
+        let errorCount = 0;
+        try {
+            result = await this.channelPollingService.runDuePolls(referenceAt);
+        }
+        catch (error) {
+            errorCount = 1;
+            this.logger.error("[channel-polling-scheduler] tick failed", {
+                error: error instanceof Error ? error.message : String(error),
+                referenceAt
+            });
+        }
+        finally {
+            this.ticking = false;
+            const idle = result?.idle ?? true;
+            const taskCount = result?.dueAccountCount ?? 0;
+            this.idleStreak = idle ? this.idleStreak + 1 : 0;
+            const nextDelayMs = resolveAdaptiveSchedulerDelayMs(this.intervalMs, this.maxIntervalMs, this.idleStreak);
+            this.schedulerMetrics?.recordTick({
+                schedulerName: "channel_account_polling",
+                referenceAt,
+                durationMs: Date.now() - tickStartedAt,
+                taskCount,
+                idle,
+                errorCount,
+                nextDelayMs,
+                idleStreak: this.idleStreak
+            });
+            if (shouldScheduleNext && this.started && !this.disposed && this.timer === null) {
+                this.scheduleNext(nextDelayMs);
+            }
+        }
+    }
+}
+//# sourceMappingURL=channel-polling-scheduler.js.map

package/dist/server/modules/channels/channel-polling-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-polling-scheduler.js","sourceRoot":"","sources":["../../../../src/modules/channels/channel-polling-scheduler.ts"],"names":[],"mappings":"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"}