// @ts-nocheck import { sequentialize } from "@grammyjs/runner"; import { apiThrottler } from "@grammyjs/transformer-throttler"; import type { ApiClientOptions } from "grammy"; import { Bot, webhookCallback } from "grammy"; import { resolveDefaultAgentId } from "../agents/agent-scope.js"; import { resolveTextChunkLimit } from "../auto-reply/chunk.js"; import { DEFAULT_GROUP_HISTORY_LIMIT, type HistoryEntry } from "../auto-reply/reply/history.js"; import { isNativeCommandsExplicitlyDisabled, resolveNativeCommandsEnabled, } from "../config/commands.js"; import type { ClawdbotConfig, ReplyToMode } from "../config/config.js"; import { loadConfig } from "../config/config.js"; import { resolveChannelGroupPolicy, resolveChannelGroupRequireMention, } from "../config/group-policy.js"; import { loadSessionStore, resolveStorePath } from "../config/sessions.js"; import { logVerbose, shouldLogVerbose } from "../globals.js"; import { getChildLogger } from "../logging.js"; import type { RuntimeEnv } from "../runtime.js"; import { resolveTelegramAccount } from "./accounts.js"; import { resolveTelegramForumThreadId, resolveTelegramStreamMode } from "./bot/helpers.js"; import type { TelegramContext, TelegramMessage } from "./bot/types.js"; import { registerTelegramHandlers } from "./bot-handlers.js"; import { createTelegramMessageProcessor } from "./bot-message.js"; import { registerTelegramNativeCommands } from "./bot-native-commands.js"; import { buildTelegramUpdateKey, createTelegramUpdateDedupe, resolveTelegramUpdateId, type TelegramUpdateKeyContext, } from "./bot-updates.js"; import { resolveTelegramFetch } from "./fetch.js"; export type TelegramBotOptions = { token: string; accountId?: string; runtime?: RuntimeEnv; requireMention?: boolean; allowFrom?: Array; groupAllowFrom?: Array; mediaMaxMb?: number; replyToMode?: ReplyToMode; proxyFetch?: typeof fetch; config?: ClawdbotConfig; updateOffset?: { lastUpdateId?: number | null; onUpdateId?: (updateId: number) => void | Promise; }; }; export function getTelegramSequentialKey(ctx: { chat?: { id?: number }; message?: TelegramMessage; update?: { message?: TelegramMessage; edited_message?: TelegramMessage; callback_query?: { message?: TelegramMessage }; }; }): string { const msg = ctx.message ?? ctx.update?.message ?? ctx.update?.edited_message ?? ctx.update?.callback_query?.message; const chatId = msg?.chat?.id ?? ctx.chat?.id; const isForum = (msg?.chat as { is_forum?: boolean } | undefined)?.is_forum; const threadId = resolveTelegramForumThreadId({ isForum, messageThreadId: msg?.message_thread_id, }); if (typeof chatId === "number") { return threadId != null ? `telegram:${chatId}:topic:${threadId}` : `telegram:${chatId}`; } return "telegram:unknown"; } export function createTelegramBot(opts: TelegramBotOptions) { const runtime: RuntimeEnv = opts.runtime ?? { log: console.log, error: console.error, exit: (code: number): never => { throw new Error(`exit ${code}`); }, }; const cfg = opts.config ?? loadConfig(); const account = resolveTelegramAccount({ cfg, accountId: opts.accountId, }); const telegramCfg = account.config; const fetchImpl = resolveTelegramFetch(opts.proxyFetch); const isBun = "Bun" in globalThis || Boolean(process?.versions?.bun); const shouldProvideFetch = Boolean(opts.proxyFetch) || isBun; const timeoutSeconds = typeof telegramCfg?.timeoutSeconds === "number" && Number.isFinite(telegramCfg.timeoutSeconds) ? Math.max(1, Math.floor(telegramCfg.timeoutSeconds)) : undefined; const client: ApiClientOptions | undefined = shouldProvideFetch || timeoutSeconds ? { ...(shouldProvideFetch && fetchImpl ? { fetch: fetchImpl as unknown as ApiClientOptions["fetch"] } : {}), ...(timeoutSeconds ? { timeoutSeconds } : {}), } : undefined; const bot = new Bot(opts.token, client ? { client } : undefined); bot.api.config.use(apiThrottler()); bot.use(sequentialize(getTelegramSequentialKey)); const recentUpdates = createTelegramUpdateDedupe(); let lastUpdateId = typeof opts.updateOffset?.lastUpdateId === "number" ? opts.updateOffset.lastUpdateId : null; const recordUpdateId = (ctx: TelegramUpdateKeyContext) => { const updateId = resolveTelegramUpdateId(ctx); if (typeof updateId !== "number") return; if (lastUpdateId !== null && updateId <= lastUpdateId) return; lastUpdateId = updateId; void opts.updateOffset?.onUpdateId?.(updateId); }; const shouldSkipUpdate = (ctx: TelegramUpdateKeyContext) => { const updateId = resolveTelegramUpdateId(ctx); if (typeof updateId === "number" && lastUpdateId !== null) { if (updateId <= lastUpdateId) return true; } const key = buildTelegramUpdateKey(ctx); const skipped = recentUpdates.check(key); if (skipped && key && shouldLogVerbose()) { logVerbose(`telegram dedupe: skipped ${key}`); } return skipped; }; bot.use(async (ctx, next) => { await next(); recordUpdateId(ctx); }); const historyLimit = Math.max( 0, telegramCfg.historyLimit ?? cfg.messages?.groupChat?.historyLimit ?? DEFAULT_GROUP_HISTORY_LIMIT, ); const groupHistories = new Map(); const textLimit = resolveTextChunkLimit(cfg, "telegram", account.accountId); const dmPolicy = telegramCfg.dmPolicy ?? "pairing"; const allowFrom = opts.allowFrom ?? telegramCfg.allowFrom; const groupAllowFrom = opts.groupAllowFrom ?? telegramCfg.groupAllowFrom ?? (telegramCfg.allowFrom && telegramCfg.allowFrom.length > 0 ? telegramCfg.allowFrom : undefined) ?? (opts.allowFrom && opts.allowFrom.length > 0 ? opts.allowFrom : undefined); const replyToMode = opts.replyToMode ?? telegramCfg.replyToMode ?? "first"; const streamMode = resolveTelegramStreamMode(telegramCfg); const nativeEnabled = resolveNativeCommandsEnabled({ providerId: "telegram", providerSetting: telegramCfg.commands?.native, globalSetting: cfg.commands?.native, }); const nativeDisabledExplicit = isNativeCommandsExplicitlyDisabled({ providerSetting: telegramCfg.commands?.native, globalSetting: cfg.commands?.native, }); const useAccessGroups = cfg.commands?.useAccessGroups !== false; const ackReactionScope = cfg.messages?.ackReactionScope ?? "group-mentions"; const mediaMaxBytes = (opts.mediaMaxMb ?? telegramCfg.mediaMaxMb ?? 5) * 1024 * 1024; const logger = getChildLogger({ module: "telegram-auto-reply" }); let botHasTopicsEnabled: boolean | undefined; const resolveBotTopicsEnabled = async (ctx?: TelegramContext) => { const fromCtx = ctx?.me as { has_topics_enabled?: boolean } | undefined; if (typeof fromCtx?.has_topics_enabled === "boolean") { botHasTopicsEnabled = fromCtx.has_topics_enabled; return botHasTopicsEnabled; } if (typeof botHasTopicsEnabled === "boolean") return botHasTopicsEnabled; try { const me = (await bot.api.getMe()) as { has_topics_enabled?: boolean }; botHasTopicsEnabled = Boolean(me?.has_topics_enabled); } catch (err) { logVerbose(`telegram getMe failed: ${String(err)}`); botHasTopicsEnabled = false; } return botHasTopicsEnabled; }; const resolveGroupPolicy = (chatId: string | number) => resolveChannelGroupPolicy({ cfg, channel: "telegram", accountId: account.accountId, groupId: String(chatId), }); const resolveGroupActivation = (params: { chatId: string | number; agentId?: string; messageThreadId?: number; sessionKey?: string; }) => { const agentId = params.agentId ?? resolveDefaultAgentId(cfg); const sessionKey = params.sessionKey ?? `agent:${agentId}:telegram:group:${buildTelegramGroupPeerId(params.chatId, params.messageThreadId)}`; const storePath = resolveStorePath(cfg.session?.store, { agentId }); try { const store = loadSessionStore(storePath); const entry = store[sessionKey]; if (entry?.groupActivation === "always") return false; if (entry?.groupActivation === "mention") return true; } catch (err) { logVerbose(`Failed to load session for activation check: ${String(err)}`); } return undefined; }; const resolveGroupRequireMention = (chatId: string | number) => resolveChannelGroupRequireMention({ cfg, channel: "telegram", accountId: account.accountId, groupId: String(chatId), requireMentionOverride: opts.requireMention, overrideOrder: "after-config", }); const resolveTelegramGroupConfig = (chatId: string | number, messageThreadId?: number) => { const groups = telegramCfg.groups; if (!groups) return { groupConfig: undefined, topicConfig: undefined }; const groupKey = String(chatId); const groupConfig = groups[groupKey] ?? groups["*"]; const topicConfig = messageThreadId != null ? groupConfig?.topics?.[String(messageThreadId)] : undefined; return { groupConfig, topicConfig }; }; const processMessage = createTelegramMessageProcessor({ bot, cfg, account, telegramCfg, historyLimit, groupHistories, dmPolicy, allowFrom, groupAllowFrom, ackReactionScope, logger, resolveGroupActivation, resolveGroupRequireMention, resolveTelegramGroupConfig, runtime, replyToMode, streamMode, textLimit, opts, resolveBotTopicsEnabled, }); registerTelegramNativeCommands({ bot, cfg, runtime, accountId: account.accountId, telegramCfg, allowFrom, groupAllowFrom, replyToMode, textLimit, useAccessGroups, nativeEnabled, nativeDisabledExplicit, resolveGroupPolicy, resolveTelegramGroupConfig, shouldSkipUpdate, opts, }); registerTelegramHandlers({ bot, opts, runtime, mediaMaxBytes, telegramCfg, groupAllowFrom, resolveGroupPolicy, resolveTelegramGroupConfig, shouldSkipUpdate, processMessage, logger, }); return bot; } export function createTelegramWebhookCallback(bot: Bot, path = "/telegram-webhook") { return { path, handler: webhookCallback(bot, "http") }; }