@diegoaltoworks/chatter 0.58.0 → 0.59.0

package/dist/channels/telegram/api.d.ts

@@ -117,6 +117,23 @@ export interface TelegramApi {
     }): Promise<void>;
     sendMedia(chatId: string, payload: unknown): Promise<void>;
     setMessageReaction(chatId: string, messageId: number, emoji: string): Promise<void>;
+    /**
+     * Registers `url` as this bot's webhook, switching Telegram from queuing
+     * updates for `getUpdates` to POSTing them there instead. `secretToken`,
+     * when given, is echoed back on every webhook POST as
+     * `X-Telegram-Bot-Api-Secret-Token` — see `./webhook`'s fail-closed check.
+     */
+    setWebhook(url: string, options?: {
+        secretToken?: string;
+    }): Promise<void>;
+    /**
+     * Clears the registered webhook so `getUpdates` starts working again: a
+     * registered webhook suppresses long-polling entirely, so switching a bot
+     * from webhook mode back to `createTelegramChannel` needs this called
+     * first — the channel itself never calls it, since it has no way to know
+     * a webhook was ever registered.
+     */
+    deleteWebhook(): Promise<void>;
 }
 export declare function createTelegramApi(config: TelegramApiConfig): TelegramApi;
 //# sourceMappingURL=api.d.ts.map

package/dist/channels/telegram/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/api.ts"],"names":[],"mappings":"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"}

package/dist/channels/telegram/channel.d.ts

@@ -10,7 +10,10 @@
  * per bot token. It is deliberately self-contained — `start(deps)` has
  * everything it needs, so there is no `customRoutes` wiring step (contrast
  * `./channels/whatsapp/inbound.ts`, whose transport and interpretation are
- * separate modules).
+ * separate modules). `./webhook` is the alternative transport for hosts that
+ * would rather receive updates over HTTPS than long-poll; the two share
+ * their update-handling logic via `./handler` so gate behaviour never
+ * diverges between them — see docs/telegram.md on choosing a mode.
  *
  * One caveat worth knowing before choosing this over a user-mode client: a bot
  * cannot start a conversation (the user must message it first), and in groups

package/dist/channels/telegram/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAqB,KAAK,WAAW,EAAuB,MAAM,OAAO,CAAC;AAOjF,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,0IAA0I;IAC1I,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iJAAiJ;IACjJ,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kIAAkI;IAClI,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kIAAkI;IAClI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;;WAIG;QACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,kBAAkB;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAoI5E"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/channel.ts"],"names":[],"mappings":"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"}

package/dist/channels/telegram/handler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The per-update handling logic shared by both Telegram transports: the
+ * long-poll loop (`./channel`, via `./poll`) and the webhook route
+ * (`./webhook`). Kept in one place so addressing, allowlist logging and
+ * pipeline dispatch are defined exactly once — a second copy would drift the
+ * moment one transport's gate behaviour changed and the other didn't.
+ */
+import type { Logger } from "../../core/logger";
+import type { InboundPipeline } from "../pipeline";
+import type { ChannelSender } from "../senders";
+import type { TelegramApi, TelegramUpdate } from "./api";
+import { type TelegramBotIdentity } from "./updates";
+export interface TelegramUpdateHandlerDeps {
+    api: TelegramApi;
+    me: TelegramBotIdentity;
+    pipeline: InboundPipeline;
+    /** Group chats eligible for a reply. Empty = every group. */
+    allowedChats: string[];
+    logger: Logger;
+    /** Log-line prefix, e.g. `Telegram[mybot]`. */
+    label: string;
+}
+/**
+ * One update -> one pipeline turn. Builds its own allowlist-log dedup set, so
+ * each transport instance gets its own "skipped chat" throttling rather than
+ * sharing (or fighting over) state with another.
+ */
+export declare function createTelegramUpdateHandler(deps: TelegramUpdateHandlerDeps): (update: TelegramUpdate) => Promise<void>;
+/** The `ChannelSender` every Telegram transport registers — text, media and reactions over the same `TelegramApi`, regardless of how updates arrive. */
+export declare function createTelegramSender(api: TelegramApi): ChannelSender;
+//# sourceMappingURL=handler.d.ts.map

package/dist/channels/telegram/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,KAAK,mBAAmB,EAAuC,MAAM,WAAW,CAAC;AAE1F,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,WAAW,CAAC;IACjB,EAAE,EAAE,mBAAmB,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,yBAAyB,GAC9B,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CA8B3C;AAED,wJAAwJ;AACxJ,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAOpE"}

package/dist/channels/telegram/index.d.ts

@@ -17,10 +17,17 @@
  * docs/telegram.md for configuration and docs/build-a-channel.md for the SPI
  * this implements.
  *
+ * `createTelegramWebhookRoute` is the alternative to `createTelegramChannel`:
+ * updates over an HTTPS webhook instead of long-polling, mounted via
+ * `ChatterConfig.customRoutes` — see docs/telegram.md for choosing between
+ * the two.
+ *
  * @packageDocumentation
  */
 export { createTelegramApi, redactToken, splitTelegramText, TELEGRAM_API_BASE, TELEGRAM_TEXT_LIMIT, type TelegramApi, type TelegramApiConfig, TelegramApiError, type TelegramChat, type TelegramMediaPayload, type TelegramMessage, type TelegramMessageEntity, type TelegramUpdate, type TelegramUser, toTelegramMediaRequest, } from "./api";
 export { createTelegramChannel, type TelegramChannelConfig } from "./channel";
+export { createTelegramSender, createTelegramUpdateHandler, type TelegramUpdateHandlerDeps, } from "./handler";
 export { type LongPollDeps, pollBackoffMs, retryDelayMs, runLongPoll } from "./poll";
 export { mentionsBot, messageEntities, messageText, nextOffset, type TelegramBotIdentity, telegramSenderKey, toChannelMessage, } from "./updates";
+export { createTelegramWebhookRoute, type TelegramWebhookConfig } from "./webhook";
 //# sourceMappingURL=index.d.ts.map

package/dist/channels/telegram/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrF,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrF,OAAO,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/channels/telegram/index.js

@@ -25,6 +25,9 @@ __export(index_exports, {
   TelegramApiError: () => TelegramApiError,
   createTelegramApi: () => createTelegramApi,
   createTelegramChannel: () => createTelegramChannel,
+  createTelegramSender: () => createTelegramSender,
+  createTelegramUpdateHandler: () => createTelegramUpdateHandler,
+  createTelegramWebhookRoute: () => createTelegramWebhookRoute,
   mentionsBot: () => mentionsBot,
   messageEntities: () => messageEntities,
   messageText: () => messageText,
@@ -188,6 +191,17 @@ function createTelegramApi(config) {
         message_id: messageId,
         reaction: [{ type: "emoji", emoji }]
       });
+    },
+    async setWebhook(url, options) {
+      await call("setWebhook", {
+        url,
+        // Only what this channel interprets — see the matching comment on getUpdates.
+        allowed_updates: ["message"],
+        ...options?.secretToken ? { secret_token: options.secretToken } : {}
+      });
+    },
+    async deleteWebhook() {
+      await call("deleteWebhook");
     }
   };
 }
@@ -208,56 +222,6 @@ function createConsoleLogger(level = "info") {
   };
 }
 
-// src/channels/gates.ts
-function matches(re, text) {
-  return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
-}
-function isBlockedByAllowlist(msg, config) {
-  return !msg.fromBot && msg.text.trim().length > 0 && !msg.isDirectMessage && config.allowedChats.length > 0 && !config.allowedChats.includes(msg.chatId);
-}
-function decideChannelAction(msg, config) {
-  if (msg.fromBot || !msg.text.trim()) return "ignore";
-  if (!msg.isDirectMessage) {
-    if (isBlockedByAllowlist(msg, config)) return "ignore";
-    if (config.muteRegex && matches(config.muteRegex, msg.text)) return "mute";
-    if (config.unmuteRegex && matches(config.unmuteRegex, msg.text)) return "unmute";
-    if (config.mutedChats.has(msg.chatId)) return "ignore";
-    return msg.mentionsBot || msg.isReplyToBot ? "reply" : "ignore";
-  }
-  return "reply";
-}
-function createSlidingWindowRateLimiter(maxPerWindow, windowMs, now = Date.now) {
-  const log = /* @__PURE__ */ new Map();
-  let lastSweep = now();
-  function sweep(current) {
-    if (current - lastSweep < windowMs) return;
-    lastSweep = current;
-    const cutoff = current - windowMs;
-    for (const [key, entries] of log) {
-      if (!entries.some((t) => t > cutoff)) log.delete(key);
-    }
-  }
-  function allow(key) {
-    const current = now();
-    sweep(current);
-    const cutoff = current - windowMs;
-    const entries = (log.get(key) ?? []).filter((t) => t > cutoff);
-    if (entries.length >= maxPerWindow) {
-      if (entries.length > 0) log.set(key, entries);
-      else log.delete(key);
-      return false;
-    }
-    entries.push(current);
-    log.set(key, entries);
-    return true;
-  }
-  allow.size = () => log.size;
-  return allow;
-}
-function underReplyRateLimit(msg, limiters) {
-  return msg.isDirectMessage ? limiters.dm(msg.chatId) : limiters.group(msg.chatId);
-}
-
 // src/core/guardrails.ts
 function detectLeakage(text) {
   const flags = [
@@ -429,6 +393,56 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/channels/gates.ts
+function matches(re, text) {
+  return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
+}
+function isBlockedByAllowlist(msg, config) {
+  return !msg.fromBot && msg.text.trim().length > 0 && !msg.isDirectMessage && config.allowedChats.length > 0 && !config.allowedChats.includes(msg.chatId);
+}
+function decideChannelAction(msg, config) {
+  if (msg.fromBot || !msg.text.trim()) return "ignore";
+  if (!msg.isDirectMessage) {
+    if (isBlockedByAllowlist(msg, config)) return "ignore";
+    if (config.muteRegex && matches(config.muteRegex, msg.text)) return "mute";
+    if (config.unmuteRegex && matches(config.unmuteRegex, msg.text)) return "unmute";
+    if (config.mutedChats.has(msg.chatId)) return "ignore";
+    return msg.mentionsBot || msg.isReplyToBot ? "reply" : "ignore";
+  }
+  return "reply";
+}
+function createSlidingWindowRateLimiter(maxPerWindow, windowMs, now = Date.now) {
+  const log = /* @__PURE__ */ new Map();
+  let lastSweep = now();
+  function sweep(current) {
+    if (current - lastSweep < windowMs) return;
+    lastSweep = current;
+    const cutoff = current - windowMs;
+    for (const [key, entries] of log) {
+      if (!entries.some((t) => t > cutoff)) log.delete(key);
+    }
+  }
+  function allow(key) {
+    const current = now();
+    sweep(current);
+    const cutoff = current - windowMs;
+    const entries = (log.get(key) ?? []).filter((t) => t > cutoff);
+    if (entries.length >= maxPerWindow) {
+      if (entries.length > 0) log.set(key, entries);
+      else log.delete(key);
+      return false;
+    }
+    entries.push(current);
+    log.set(key, entries);
+    return true;
+  }
+  allow.size = () => log.size;
+  return allow;
+}
+function underReplyRateLimit(msg, limiters) {
+  return msg.isDirectMessage ? limiters.dm(msg.chatId) : limiters.group(msg.chatId);
+}
+
 // src/channels/pipeline.ts
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
@@ -581,6 +595,41 @@ function telegramSenderKey(senderId) {
   return `tg:${senderId}`;
 }
 
+// src/channels/telegram/handler.ts
+function createTelegramUpdateHandler(deps) {
+  const { api, me, pipeline, allowedChats, logger, label } = deps;
+  const loggedUnallowedChats = /* @__PURE__ */ new Set();
+  return async function handleUpdate(update) {
+    const message = update.message;
+    const msg = toChannelMessage(update, me);
+    if (!msg || !message) return;
+    if (isBlockedByAllowlist(msg, { allowedChats })) {
+      if (!loggedUnallowedChats.has(msg.chatId)) {
+        loggedUnallowedChats.add(msg.chatId);
+        logger.warn(`${label}: skipped chat ${msg.chatId} - not in allowedChats`);
+      }
+    }
+    const reply = {
+      // Threaded onto the incoming message: in a busy group an untethered
+      // answer reads as a non-sequitur.
+      sendAnswer: (chatId, text) => api.sendMessage(chatId, text, { replyToMessageId: message.message_id }),
+      sendGateReply: (chatId, text) => api.sendMessage(chatId, text)
+    };
+    await pipeline(msg, {
+      reply,
+      conversationId: msg.chatId,
+      sender: telegramSenderKey(msg.senderId)
+    });
+  };
+}
+function createTelegramSender(api) {
+  return {
+    sendText: (chatId, text) => api.sendMessage(chatId, text),
+    sendMedia: (chatId, payload) => api.sendMedia(chatId, payload),
+    sendReaction: (chatId, messageRef, emoji) => api.setMessageReaction(chatId, Number(messageRef), emoji)
+  };
+}
+
 // src/channels/telegram/poll.ts
 var BASE_DELAY_MS = 1e3;
 var MAX_DELAY_MS = 6e4;
@@ -651,12 +700,7 @@ function createTelegramChannel(config) {
       });
       const me = await api.getMe();
       const label = `Telegram[${me.username ?? me.id}]`;
-      const sender = {
-        sendText: (chatId, text) => api.sendMessage(chatId, text),
-        sendMedia: (chatId, payload) => api.sendMedia(chatId, payload),
-        sendReaction: (chatId, messageRef, emoji) => api.setMessageReaction(chatId, Number(messageRef), emoji)
-      };
-      deps.senders.register(channelName, sender);
+      deps.senders.register(channelName, createTelegramSender(api));
       senders = deps.senders;
       registered = true;
       const pipeline = createInboundPipeline(
@@ -683,29 +727,14 @@ function createTelegramChannel(config) {
           logger: log
         }
       );
-      const loggedUnallowedChats = /* @__PURE__ */ new Set();
-      async function handleUpdate(update) {
-        const message = update.message;
-        const msg = toChannelMessage(update, me);
-        if (!msg || !message) return;
-        if (isBlockedByAllowlist(msg, { allowedChats })) {
-          if (!loggedUnallowedChats.has(msg.chatId)) {
-            loggedUnallowedChats.add(msg.chatId);
-            log.warn(`${label}: skipped chat ${msg.chatId} - not in allowedChats`);
-          }
-        }
-        const reply = {
-          // Threaded onto the incoming message: in a busy group an untethered
-          // answer reads as a non-sequitur.
-          sendAnswer: (chatId, text) => api.sendMessage(chatId, text, { replyToMessageId: message.message_id }),
-          sendGateReply: (chatId, text) => api.sendMessage(chatId, text)
-        };
-        await pipeline(msg, {
-          reply,
-          conversationId: msg.chatId,
-          sender: telegramSenderKey(msg.senderId)
-        });
-      }
+      const handleUpdate = createTelegramUpdateHandler({
+        api,
+        me,
+        pipeline,
+        allowedChats,
+        logger: log,
+        label
+      });
       abort = new AbortController();
       const signal = abort.signal;
       void runLongPoll({
@@ -730,6 +759,196 @@ function createTelegramChannel(config) {
     }
   };
 }
+
+// src/channels/telegram/webhook.ts
+var import_node_crypto = require("node:crypto");
+
+// node_modules/hono/dist/http-exception.js
+var HTTPException = class extends Error {
+  res;
+  status;
+  /**
+   * Creates an instance of `HTTPException`.
+   * @param status - HTTP status code for the exception. Defaults to 500.
+   * @param options - Additional options for the exception.
+   */
+  constructor(status = 500, options) {
+    super(options?.message, { cause: options?.cause });
+    this.res = options?.res;
+    this.status = status;
+  }
+  /**
+   * Returns the response object associated with the exception.
+   * If a response object is not provided, a new response is created with the error message and status code.
+   * @returns The response object.
+   */
+  getResponse() {
+    if (this.res) {
+      const newResponse = new Response(this.res.body, {
+        status: this.status,
+        headers: this.res.headers
+      });
+      return newResponse;
+    }
+    return new Response(this.message, {
+      status: this.status
+    });
+  }
+};
+
+// node_modules/hono/dist/middleware/body-limit/index.js
+var ERROR_MESSAGE = "Payload Too Large";
+var bodyLimit = (options) => {
+  const onError = options.onError || (() => {
+    const res = new Response(ERROR_MESSAGE, {
+      status: 413
+    });
+    throw new HTTPException(413, { res });
+  });
+  const maxSize = options.maxSize;
+  return async function bodyLimit2(c, next) {
+    if (!c.req.raw.body) {
+      return next();
+    }
+    const hasTransferEncoding = c.req.raw.headers.has("transfer-encoding");
+    const hasContentLength = c.req.raw.headers.has("content-length");
+    if (hasContentLength && !hasTransferEncoding) {
+      const contentLength = parseInt(c.req.raw.headers.get("content-length") || "0", 10);
+      return contentLength > maxSize ? onError(c) : next();
+    }
+    let size = 0;
+    const chunks = [];
+    const rawReader = c.req.raw.body.getReader();
+    for (; ; ) {
+      const { done, value } = await rawReader.read();
+      if (done) {
+        break;
+      }
+      size += value.length;
+      if (size > maxSize) {
+        return onError(c);
+      }
+      chunks.push(value);
+    }
+    const requestInit = {
+      body: new ReadableStream({
+        start(controller) {
+          for (const chunk of chunks) {
+            controller.enqueue(chunk);
+          }
+          controller.close();
+        }
+      }),
+      duplex: "half"
+    };
+    c.req.raw = new Request(c.req.raw, requestInit);
+    return next();
+  };
+};
+
+// src/middleware/bodyLimit.ts
+var DEFAULT_MAX_REQUEST_BYTES = 262144;
+function chatBodyLimit(maxSize = DEFAULT_MAX_REQUEST_BYTES, toError = (message) => ({ error: message })) {
+  return bodyLimit({
+    maxSize,
+    onError: (c) => c.json(toError("Request body too large"), 413)
+  });
+}
+
+// src/channels/telegram/webhook.ts
+var SECRET_TOKEN_HEADER = "x-telegram-bot-api-secret-token";
+function secureCompare(a, b) {
+  const bufA = Buffer.from(a);
+  const bufB = Buffer.from(b);
+  return bufA.length === bufB.length && (0, import_node_crypto.timingSafeEqual)(bufA, bufB);
+}
+var SECRET_TOKEN_PATTERN = /^[A-Za-z0-9_-]{1,256}$/;
+function createTelegramWebhookRoute(config) {
+  const webhookSecret = config.webhookSecret;
+  if (!webhookSecret?.trim()) {
+    throw new Error("Telegram webhook requires webhookSecret (it fails closed without one)");
+  }
+  if (!SECRET_TOKEN_PATTERN.test(webhookSecret)) {
+    throw new Error(
+      "Telegram webhookSecret must match /^[A-Za-z0-9_-]{1,256}$/ (Telegram's own secret_token charset)"
+    );
+  }
+  const channelName = config.name ?? "telegram";
+  const allowedChats = config.allowedChats ?? [];
+  const path = config.path ?? "/webhooks/telegram";
+  return async (app, deps) => {
+    const log = config.logger ?? deps.logger ?? createConsoleLogger();
+    const api = config.api ?? createTelegramApi({
+      botToken: config.botToken,
+      fetch: config.fetch,
+      baseUrl: config.apiBaseUrl
+    });
+    const me = await api.getMe();
+    const label = `Telegram[${me.username ?? me.id}] (webhook)`;
+    deps.senders.register(channelName, createTelegramSender(api));
+    const pipeline = createInboundPipeline(
+      { client: deps.client, store: deps.store, prompts: deps.prompts },
+      {
+        channel: channelName,
+        answerFn: config.answerFn ?? deps.config.answerFn,
+        bucketsFor: config.bucketsFor ?? deps.config.bucketsFor,
+        rewriteQuery: config.rewriteQuery ?? deps.config.rewriteQuery,
+        rerankContext: config.rerankContext ?? deps.config.rerankContext,
+        transformReply: config.transformReply ?? deps.config.transformReply,
+        model: config.model,
+        channelHint: config.channelHint ?? "Channel: Telegram.",
+        personaResolver: config.personaResolver,
+        history: config.history,
+        allowedChats,
+        muteRegex: config.muteRegex,
+        unmuteRegex: config.unmuteRegex,
+        muteReply: config.muteReply,
+        unmuteReply: config.unmuteReply,
+        dmRateLimit: config.dmRateLimit,
+        groupRateLimit: config.groupRateLimit,
+        now: config.now,
+        logger: log
+      }
+    );
+    const handleUpdate = createTelegramUpdateHandler({
+      api,
+      me,
+      pipeline,
+      allowedChats,
+      logger: log,
+      label
+    });
+    app.post(
+      path,
+      chatBodyLimit(deps.config.server?.maxRequestBytes),
+      // Reject oversized bodies first
+      async (c) => {
+        const provided = c.req.header(SECRET_TOKEN_HEADER);
+        if (!provided || !secureCompare(provided, webhookSecret)) {
+          log.warn(`${label}: rejected webhook POST - missing or invalid secret token`);
+          return c.text("", 403);
+        }
+        let body;
+        try {
+          body = await c.req.json();
+        } catch {
+          return c.text("", 400);
+        }
+        if (typeof body !== "object" || body === null) {
+          return c.text("", 400);
+        }
+        const update = body;
+        try {
+          await handleUpdate(update);
+        } catch (error) {
+          log.warn(`${label}: update handling failed:`, error);
+        }
+        return c.text("", 200);
+      }
+    );
+    log.info(`${label}: webhook mounted at ${path} as @${me.username ?? me.id}`);
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TELEGRAM_API_BASE,
@@ -737,6 +956,9 @@ function createTelegramChannel(config) {
   TelegramApiError,
   createTelegramApi,
   createTelegramChannel,
+  createTelegramSender,
+  createTelegramUpdateHandler,
+  createTelegramWebhookRoute,
   mentionsBot,
   messageEntities,
   messageText,

package/dist/channels/telegram/index.mjs

@@ -146,6 +146,17 @@ function createTelegramApi(config) {
         message_id: messageId,
         reaction: [{ type: "emoji", emoji }]
       });
+    },
+    async setWebhook(url, options) {
+      await call("setWebhook", {
+        url,
+        // Only what this channel interprets — see the matching comment on getUpdates.
+        allowed_updates: ["message"],
+        ...options?.secretToken ? { secret_token: options.secretToken } : {}
+      });
+    },
+    async deleteWebhook() {
+      await call("deleteWebhook");
     }
   };
 }
@@ -166,56 +177,6 @@ function createConsoleLogger(level = "info") {
   };
 }
 
-// src/channels/gates.ts
-function matches(re, text) {
-  return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
-}
-function isBlockedByAllowlist(msg, config) {
-  return !msg.fromBot && msg.text.trim().length > 0 && !msg.isDirectMessage && config.allowedChats.length > 0 && !config.allowedChats.includes(msg.chatId);
-}
-function decideChannelAction(msg, config) {
-  if (msg.fromBot || !msg.text.trim()) return "ignore";
-  if (!msg.isDirectMessage) {
-    if (isBlockedByAllowlist(msg, config)) return "ignore";
-    if (config.muteRegex && matches(config.muteRegex, msg.text)) return "mute";
-    if (config.unmuteRegex && matches(config.unmuteRegex, msg.text)) return "unmute";
-    if (config.mutedChats.has(msg.chatId)) return "ignore";
-    return msg.mentionsBot || msg.isReplyToBot ? "reply" : "ignore";
-  }
-  return "reply";
-}
-function createSlidingWindowRateLimiter(maxPerWindow, windowMs, now = Date.now) {
-  const log = /* @__PURE__ */ new Map();
-  let lastSweep = now();
-  function sweep(current) {
-    if (current - lastSweep < windowMs) return;
-    lastSweep = current;
-    const cutoff = current - windowMs;
-    for (const [key, entries] of log) {
-      if (!entries.some((t) => t > cutoff)) log.delete(key);
-    }
-  }
-  function allow(key) {
-    const current = now();
-    sweep(current);
-    const cutoff = current - windowMs;
-    const entries = (log.get(key) ?? []).filter((t) => t > cutoff);
-    if (entries.length >= maxPerWindow) {
-      if (entries.length > 0) log.set(key, entries);
-      else log.delete(key);
-      return false;
-    }
-    entries.push(current);
-    log.set(key, entries);
-    return true;
-  }
-  allow.size = () => log.size;
-  return allow;
-}
-function underReplyRateLimit(msg, limiters) {
-  return msg.isDirectMessage ? limiters.dm(msg.chatId) : limiters.group(msg.chatId);
-}
-
 // src/core/guardrails.ts
 function detectLeakage(text) {
   const flags = [
@@ -387,6 +348,56 @@ ${ctx.join("\n\n")}`
   return { system, messages, context: ctx };
 }
 
+// src/channels/gates.ts
+function matches(re, text) {
+  return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
+}
+function isBlockedByAllowlist(msg, config) {
+  return !msg.fromBot && msg.text.trim().length > 0 && !msg.isDirectMessage && config.allowedChats.length > 0 && !config.allowedChats.includes(msg.chatId);
+}
+function decideChannelAction(msg, config) {
+  if (msg.fromBot || !msg.text.trim()) return "ignore";
+  if (!msg.isDirectMessage) {
+    if (isBlockedByAllowlist(msg, config)) return "ignore";
+    if (config.muteRegex && matches(config.muteRegex, msg.text)) return "mute";
+    if (config.unmuteRegex && matches(config.unmuteRegex, msg.text)) return "unmute";
+    if (config.mutedChats.has(msg.chatId)) return "ignore";
+    return msg.mentionsBot || msg.isReplyToBot ? "reply" : "ignore";
+  }
+  return "reply";
+}
+function createSlidingWindowRateLimiter(maxPerWindow, windowMs, now = Date.now) {
+  const log = /* @__PURE__ */ new Map();
+  let lastSweep = now();
+  function sweep(current) {
+    if (current - lastSweep < windowMs) return;
+    lastSweep = current;
+    const cutoff = current - windowMs;
+    for (const [key, entries] of log) {
+      if (!entries.some((t) => t > cutoff)) log.delete(key);
+    }
+  }
+  function allow(key) {
+    const current = now();
+    sweep(current);
+    const cutoff = current - windowMs;
+    const entries = (log.get(key) ?? []).filter((t) => t > cutoff);
+    if (entries.length >= maxPerWindow) {
+      if (entries.length > 0) log.set(key, entries);
+      else log.delete(key);
+      return false;
+    }
+    entries.push(current);
+    log.set(key, entries);
+    return true;
+  }
+  allow.size = () => log.size;
+  return allow;
+}
+function underReplyRateLimit(msg, limiters) {
+  return msg.isDirectMessage ? limiters.dm(msg.chatId) : limiters.group(msg.chatId);
+}
+
 // src/channels/pipeline.ts
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
@@ -539,6 +550,41 @@ function telegramSenderKey(senderId) {
   return `tg:${senderId}`;
 }
 
+// src/channels/telegram/handler.ts
+function createTelegramUpdateHandler(deps) {
+  const { api, me, pipeline, allowedChats, logger, label } = deps;
+  const loggedUnallowedChats = /* @__PURE__ */ new Set();
+  return async function handleUpdate(update) {
+    const message = update.message;
+    const msg = toChannelMessage(update, me);
+    if (!msg || !message) return;
+    if (isBlockedByAllowlist(msg, { allowedChats })) {
+      if (!loggedUnallowedChats.has(msg.chatId)) {
+        loggedUnallowedChats.add(msg.chatId);
+        logger.warn(`${label}: skipped chat ${msg.chatId} - not in allowedChats`);
+      }
+    }
+    const reply = {
+      // Threaded onto the incoming message: in a busy group an untethered
+      // answer reads as a non-sequitur.
+      sendAnswer: (chatId, text) => api.sendMessage(chatId, text, { replyToMessageId: message.message_id }),
+      sendGateReply: (chatId, text) => api.sendMessage(chatId, text)
+    };
+    await pipeline(msg, {
+      reply,
+      conversationId: msg.chatId,
+      sender: telegramSenderKey(msg.senderId)
+    });
+  };
+}
+function createTelegramSender(api) {
+  return {
+    sendText: (chatId, text) => api.sendMessage(chatId, text),
+    sendMedia: (chatId, payload) => api.sendMedia(chatId, payload),
+    sendReaction: (chatId, messageRef, emoji) => api.setMessageReaction(chatId, Number(messageRef), emoji)
+  };
+}
+
 // src/channels/telegram/poll.ts
 var BASE_DELAY_MS = 1e3;
 var MAX_DELAY_MS = 6e4;
@@ -609,12 +655,7 @@ function createTelegramChannel(config) {
       });
       const me = await api.getMe();
       const label = `Telegram[${me.username ?? me.id}]`;
-      const sender = {
-        sendText: (chatId, text) => api.sendMessage(chatId, text),
-        sendMedia: (chatId, payload) => api.sendMedia(chatId, payload),
-        sendReaction: (chatId, messageRef, emoji) => api.setMessageReaction(chatId, Number(messageRef), emoji)
-      };
-      deps.senders.register(channelName, sender);
+      deps.senders.register(channelName, createTelegramSender(api));
       senders = deps.senders;
       registered = true;
       const pipeline = createInboundPipeline(
@@ -641,29 +682,14 @@ function createTelegramChannel(config) {
           logger: log
         }
       );
-      const loggedUnallowedChats = /* @__PURE__ */ new Set();
-      async function handleUpdate(update) {
-        const message = update.message;
-        const msg = toChannelMessage(update, me);
-        if (!msg || !message) return;
-        if (isBlockedByAllowlist(msg, { allowedChats })) {
-          if (!loggedUnallowedChats.has(msg.chatId)) {
-            loggedUnallowedChats.add(msg.chatId);
-            log.warn(`${label}: skipped chat ${msg.chatId} - not in allowedChats`);
-          }
-        }
-        const reply = {
-          // Threaded onto the incoming message: in a busy group an untethered
-          // answer reads as a non-sequitur.
-          sendAnswer: (chatId, text) => api.sendMessage(chatId, text, { replyToMessageId: message.message_id }),
-          sendGateReply: (chatId, text) => api.sendMessage(chatId, text)
-        };
-        await pipeline(msg, {
-          reply,
-          conversationId: msg.chatId,
-          sender: telegramSenderKey(msg.senderId)
-        });
-      }
+      const handleUpdate = createTelegramUpdateHandler({
+        api,
+        me,
+        pipeline,
+        allowedChats,
+        logger: log,
+        label
+      });
       abort = new AbortController();
       const signal = abort.signal;
       void runLongPoll({
@@ -688,12 +714,205 @@ function createTelegramChannel(config) {
     }
   };
 }
+
+// src/channels/telegram/webhook.ts
+import { timingSafeEqual } from "node:crypto";
+
+// node_modules/hono/dist/http-exception.js
+var HTTPException = class extends Error {
+  res;
+  status;
+  /**
+   * Creates an instance of `HTTPException`.
+   * @param status - HTTP status code for the exception. Defaults to 500.
+   * @param options - Additional options for the exception.
+   */
+  constructor(status = 500, options) {
+    super(options?.message, { cause: options?.cause });
+    this.res = options?.res;
+    this.status = status;
+  }
+  /**
+   * Returns the response object associated with the exception.
+   * If a response object is not provided, a new response is created with the error message and status code.
+   * @returns The response object.
+   */
+  getResponse() {
+    if (this.res) {
+      const newResponse = new Response(this.res.body, {
+        status: this.status,
+        headers: this.res.headers
+      });
+      return newResponse;
+    }
+    return new Response(this.message, {
+      status: this.status
+    });
+  }
+};
+
+// node_modules/hono/dist/middleware/body-limit/index.js
+var ERROR_MESSAGE = "Payload Too Large";
+var bodyLimit = (options) => {
+  const onError = options.onError || (() => {
+    const res = new Response(ERROR_MESSAGE, {
+      status: 413
+    });
+    throw new HTTPException(413, { res });
+  });
+  const maxSize = options.maxSize;
+  return async function bodyLimit2(c, next) {
+    if (!c.req.raw.body) {
+      return next();
+    }
+    const hasTransferEncoding = c.req.raw.headers.has("transfer-encoding");
+    const hasContentLength = c.req.raw.headers.has("content-length");
+    if (hasContentLength && !hasTransferEncoding) {
+      const contentLength = parseInt(c.req.raw.headers.get("content-length") || "0", 10);
+      return contentLength > maxSize ? onError(c) : next();
+    }
+    let size = 0;
+    const chunks = [];
+    const rawReader = c.req.raw.body.getReader();
+    for (; ; ) {
+      const { done, value } = await rawReader.read();
+      if (done) {
+        break;
+      }
+      size += value.length;
+      if (size > maxSize) {
+        return onError(c);
+      }
+      chunks.push(value);
+    }
+    const requestInit = {
+      body: new ReadableStream({
+        start(controller) {
+          for (const chunk of chunks) {
+            controller.enqueue(chunk);
+          }
+          controller.close();
+        }
+      }),
+      duplex: "half"
+    };
+    c.req.raw = new Request(c.req.raw, requestInit);
+    return next();
+  };
+};
+
+// src/middleware/bodyLimit.ts
+var DEFAULT_MAX_REQUEST_BYTES = 262144;
+function chatBodyLimit(maxSize = DEFAULT_MAX_REQUEST_BYTES, toError = (message) => ({ error: message })) {
+  return bodyLimit({
+    maxSize,
+    onError: (c) => c.json(toError("Request body too large"), 413)
+  });
+}
+
+// src/channels/telegram/webhook.ts
+var SECRET_TOKEN_HEADER = "x-telegram-bot-api-secret-token";
+function secureCompare(a, b) {
+  const bufA = Buffer.from(a);
+  const bufB = Buffer.from(b);
+  return bufA.length === bufB.length && timingSafeEqual(bufA, bufB);
+}
+var SECRET_TOKEN_PATTERN = /^[A-Za-z0-9_-]{1,256}$/;
+function createTelegramWebhookRoute(config) {
+  const webhookSecret = config.webhookSecret;
+  if (!webhookSecret?.trim()) {
+    throw new Error("Telegram webhook requires webhookSecret (it fails closed without one)");
+  }
+  if (!SECRET_TOKEN_PATTERN.test(webhookSecret)) {
+    throw new Error(
+      "Telegram webhookSecret must match /^[A-Za-z0-9_-]{1,256}$/ (Telegram's own secret_token charset)"
+    );
+  }
+  const channelName = config.name ?? "telegram";
+  const allowedChats = config.allowedChats ?? [];
+  const path = config.path ?? "/webhooks/telegram";
+  return async (app, deps) => {
+    const log = config.logger ?? deps.logger ?? createConsoleLogger();
+    const api = config.api ?? createTelegramApi({
+      botToken: config.botToken,
+      fetch: config.fetch,
+      baseUrl: config.apiBaseUrl
+    });
+    const me = await api.getMe();
+    const label = `Telegram[${me.username ?? me.id}] (webhook)`;
+    deps.senders.register(channelName, createTelegramSender(api));
+    const pipeline = createInboundPipeline(
+      { client: deps.client, store: deps.store, prompts: deps.prompts },
+      {
+        channel: channelName,
+        answerFn: config.answerFn ?? deps.config.answerFn,
+        bucketsFor: config.bucketsFor ?? deps.config.bucketsFor,
+        rewriteQuery: config.rewriteQuery ?? deps.config.rewriteQuery,
+        rerankContext: config.rerankContext ?? deps.config.rerankContext,
+        transformReply: config.transformReply ?? deps.config.transformReply,
+        model: config.model,
+        channelHint: config.channelHint ?? "Channel: Telegram.",
+        personaResolver: config.personaResolver,
+        history: config.history,
+        allowedChats,
+        muteRegex: config.muteRegex,
+        unmuteRegex: config.unmuteRegex,
+        muteReply: config.muteReply,
+        unmuteReply: config.unmuteReply,
+        dmRateLimit: config.dmRateLimit,
+        groupRateLimit: config.groupRateLimit,
+        now: config.now,
+        logger: log
+      }
+    );
+    const handleUpdate = createTelegramUpdateHandler({
+      api,
+      me,
+      pipeline,
+      allowedChats,
+      logger: log,
+      label
+    });
+    app.post(
+      path,
+      chatBodyLimit(deps.config.server?.maxRequestBytes),
+      // Reject oversized bodies first
+      async (c) => {
+        const provided = c.req.header(SECRET_TOKEN_HEADER);
+        if (!provided || !secureCompare(provided, webhookSecret)) {
+          log.warn(`${label}: rejected webhook POST - missing or invalid secret token`);
+          return c.text("", 403);
+        }
+        let body;
+        try {
+          body = await c.req.json();
+        } catch {
+          return c.text("", 400);
+        }
+        if (typeof body !== "object" || body === null) {
+          return c.text("", 400);
+        }
+        const update = body;
+        try {
+          await handleUpdate(update);
+        } catch (error) {
+          log.warn(`${label}: update handling failed:`, error);
+        }
+        return c.text("", 200);
+      }
+    );
+    log.info(`${label}: webhook mounted at ${path} as @${me.username ?? me.id}`);
+  };
+}
 export {
   TELEGRAM_API_BASE,
   TELEGRAM_TEXT_LIMIT,
   TelegramApiError,
   createTelegramApi,
   createTelegramChannel,
+  createTelegramSender,
+  createTelegramUpdateHandler,
+  createTelegramWebhookRoute,
   mentionsBot,
   messageEntities,
   messageText,

package/dist/channels/telegram/webhook.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Telegram Bot API transport: a `CustomRoutes` mount that receives updates
+ * over HTTPS instead of long-polling `getUpdates` (see `./channel` for that
+ * transport). Update handling is identical between the two — both build on
+ * `./handler`'s shared `createTelegramUpdateHandler`/`createTelegramSender` —
+ * so choosing one over the other is purely an infrastructure decision: a
+ * webhook needs a publicly reachable HTTPS endpoint and no open connection,
+ * long-polling needs neither but holds one request open at a time. See
+ * docs/telegram.md for the full comparison and `TelegramApi.setWebhook` for
+ * registering the URL with Telegram once this route is mounted.
+ *
+ * ```ts
+ * await createServer({
+ *   ...,
+ *   customRoutes: createTelegramWebhookRoute({
+ *     botToken: process.env.TELEGRAM_BOT_TOKEN as string,
+ *     webhookSecret: process.env.TELEGRAM_WEBHOOK_SECRET as string,
+ *   }),
+ * });
+ * ```
+ */
+import type { AnswerFn, TransformReply } from "../../core/answer";
+import type { BucketsFor } from "../../core/buckets";
+import { type Logger } from "../../core/logger";
+import type { RerankContext, RewriteQuery } from "../../core/pipeline";
+import type { HistoryStore } from "../../history/types";
+import type { CustomRoutes } from "../../types";
+import { type TelegramApi } from "./api";
+export interface TelegramWebhookConfig {
+    /** From @BotFather. A credential — pass it from the environment, never commit it. */
+    botToken: string;
+    /**
+     * Shared secret Telegram is told about via `setWebhook({ secretToken })`
+     * and then echoes back on every POST as `X-Telegram-Bot-Api-Secret-Token`.
+     * Required: without one there is no way to tell a genuine Telegram POST
+     * from a forged one, so this fails closed by construction — a missing or
+     * blank value throws rather than falling back to accepting every request.
+     */
+    webhookSecret: string;
+    /** Where the route is mounted. @default "/webhooks/telegram" */
+    path?: string;
+    /** Channel and sender-registry name. Override to run more than one bot in one process. @default "telegram" */
+    name?: string;
+    /** Group chats eligible for a reply. Empty (default) = every group. Has no effect on DMs, which always reply. */
+    allowedChats?: string[];
+    answerFn?: AnswerFn;
+    bucketsFor?: BucketsFor;
+    rewriteQuery?: RewriteQuery;
+    rerankContext?: RerankContext;
+    transformReply?: TransformReply;
+    model?: string;
+    /** Extra system-prompt section describing the delivery channel; passed through to `prepareChat`. @default "Channel: Telegram." */
+    channelHint?: string;
+    /** A throw/rejection is treated as "no persona" for that turn. `sender` is the namespaced `tg:<id>` key. */
+    personaResolver?: (ctx: {
+        sender: string;
+        text: string;
+    }) => string | undefined | Promise<string | undefined>;
+    /** Off by default — the channel stays single-turn until a store is configured. */
+    history?: {
+        store: HistoryStore;
+        /** Most recent turns to load per reply. @default 20 */
+        limit?: number;
+        historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
+    };
+    muteRegex?: RegExp;
+    unmuteRegex?: RegExp;
+    muteReply?: string;
+    unmuteReply?: string;
+    dmRateLimit?: {
+        max: number;
+        windowMs: number;
+    };
+    groupRateLimit?: {
+        max: number;
+        windowMs: number;
+    };
+    now?: () => number;
+    /** Overridable for tests and for hosts routing through a proxy; defaults to `globalThis.fetch`. */
+    fetch?: typeof fetch;
+    /** Self-hosted Bot API server origin. */
+    apiBaseUrl?: string;
+    /** Overridable for tests, which fake the Bot API instead of calling it; defaults to a `fetch` client over {@link TelegramWebhookConfig.botToken}. */
+    api?: TelegramApi;
+    logger?: Logger;
+}
+/**
+ * Builds a `CustomRoutes` mount that receives Telegram updates over HTTPS.
+ * Throws synchronously if `webhookSecret` is missing, blank, or outside the
+ * charset Telegram accepts for it — before the route ever exists, rather
+ * than mounting an endpoint that would silently accept everything or reject
+ * every request.
+ */
+export declare function createTelegramWebhookRoute(config: TelegramWebhookConfig): CustomRoutes;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/channels/telegram/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAqB,KAAK,WAAW,EAAuB,MAAM,OAAO,CAAC;AAMjF,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kIAAkI;IAClI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,YAAY,CAkHtF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.58.0",
+  "version": "0.59.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",