opencode-router 0.11.128 → 0.11.129

package/dist/telegram.js

@@ -1,4 +1,6 @@
-import { Bot } from "grammy";
+import { Bot, InputFile } from "grammy";
+import { classifyDeliveryError, withDeliveryRetry } from "./delivery.js";
+import { chunkText } from "./text.js";
 const MAX_TEXT_LENGTH = 4096;
 const TELEGRAM_CHAT_ID_PATTERN = /^-?\d+$/;
 export function isTelegramPeerId(peerId) {
@@ -13,14 +15,156 @@ export function parseTelegramPeerId(peerId) {
         return null;
     return parsed;
 }
-export function createTelegramAdapter(identity, config, logger, onMessage) {
+function invalidTelegramPeerIdError() {
+    const error = new Error("Telegram peerId must be a numeric chat_id. Usernames like @name are not valid direct targets.");
+    error.status = 400;
+    return error;
+}
+export function createTelegramAdapter(identity, config, logger, onMessage, mediaStore, deps = {}) {
     const token = identity.token?.trim() ?? "";
     if (!token) {
         throw new Error("Telegram token is required for Telegram adapter");
     }
     const log = logger.child({ channel: "telegram", identityId: identity.id });
     log.debug({ tokenPresent: true }, "telegram adapter init");
-    const bot = new Bot(token);
+    const BotImpl = deps.Bot ?? Bot;
+    const bot = new BotImpl(token);
+    const truncateCaption = (value) => {
+        const text = (value ?? "").trim();
+        if (!text)
+            return undefined;
+        return text.length <= 1024 ? text : text.slice(0, 1024);
+    };
+    const extractMediaCandidates = (message) => {
+        const candidates = [];
+        if (Array.isArray(message?.photo) && message.photo.length > 0) {
+            const largest = message.photo[message.photo.length - 1];
+            if (largest?.file_id) {
+                candidates.push({
+                    kind: "image",
+                    fileId: String(largest.file_id),
+                    fileUniqueId: typeof largest.file_unique_id === "string" ? largest.file_unique_id : undefined,
+                    filename: typeof largest.file_unique_id === "string"
+                        ? `photo-${largest.file_unique_id}.jpg`
+                        : `photo-${String(largest.file_id)}.jpg`,
+                    mimeType: "image/jpeg",
+                    sizeBytes: typeof largest.file_size === "number" ? largest.file_size : undefined,
+                });
+            }
+        }
+        if (message?.document?.file_id) {
+            const document = message.document;
+            const mimeType = typeof document.mime_type === "string" ? document.mime_type : undefined;
+            const normalizedKind = typeof mimeType === "string" && mimeType.startsWith("image/")
+                ? "image"
+                : typeof mimeType === "string" && mimeType.startsWith("audio/")
+                    ? "audio"
+                    : "file";
+            candidates.push({
+                kind: normalizedKind,
+                fileId: String(document.file_id),
+                fileUniqueId: typeof document.file_unique_id === "string" ? document.file_unique_id : undefined,
+                filename: typeof document.file_name === "string" ? document.file_name : undefined,
+                mimeType,
+                sizeBytes: typeof document.file_size === "number" ? document.file_size : undefined,
+            });
+        }
+        if (message?.audio?.file_id) {
+            const audio = message.audio;
+            candidates.push({
+                kind: "audio",
+                fileId: String(audio.file_id),
+                fileUniqueId: typeof audio.file_unique_id === "string" ? audio.file_unique_id : undefined,
+                filename: typeof audio.file_name === "string" ? audio.file_name : undefined,
+                mimeType: typeof audio.mime_type === "string" ? audio.mime_type : undefined,
+                sizeBytes: typeof audio.file_size === "number" ? audio.file_size : undefined,
+            });
+        }
+        if (message?.voice?.file_id) {
+            const voice = message.voice;
+            candidates.push({
+                kind: "audio",
+                fileId: String(voice.file_id),
+                fileUniqueId: typeof voice.file_unique_id === "string" ? voice.file_unique_id : undefined,
+                filename: typeof voice.file_unique_id === "string"
+                    ? `voice-${voice.file_unique_id}.ogg`
+                    : `voice-${String(voice.file_id)}.ogg`,
+                mimeType: "audio/ogg",
+                sizeBytes: typeof voice.file_size === "number" ? voice.file_size : undefined,
+            });
+        }
+        return candidates;
+    };
+    const downloadCandidate = async (chatId, candidate) => {
+        if (!mediaStore) {
+            return {
+                type: "media",
+                media: {
+                    id: candidate.fileUniqueId || candidate.fileId,
+                    kind: candidate.kind,
+                    source: "telegram",
+                    status: "failed",
+                    providerFileId: candidate.fileId,
+                    ...(candidate.fileUniqueId ? { providerFileUniqueId: candidate.fileUniqueId } : {}),
+                    ...(candidate.filename ? { filename: candidate.filename } : {}),
+                    ...(candidate.mimeType ? { mimeType: candidate.mimeType } : {}),
+                    ...(typeof candidate.sizeBytes === "number" ? { sizeBytes: candidate.sizeBytes } : {}),
+                    error: "media store unavailable",
+                },
+            };
+        }
+        try {
+            const file = await withDeliveryRetry("telegram.getFile", () => bot.api.getFile(candidate.fileId), { logger: log });
+            const filePath = typeof file?.file_path === "string" ? String(file.file_path) : "";
+            if (!filePath) {
+                throw new Error(`Telegram file path missing for file_id ${candidate.fileId}`);
+            }
+            const url = `https://api.telegram.org/file/bot${token}/${filePath}`;
+            const stored = await withDeliveryRetry("telegram.download", () => mediaStore.downloadInbound({
+                channel: "telegram",
+                identityId: identity.id,
+                peerId: chatId,
+                kind: candidate.kind,
+                url,
+                ...(candidate.filename ? { filename: candidate.filename } : {}),
+                ...(candidate.mimeType ? { mimeType: candidate.mimeType } : {}),
+            }), { logger: log });
+            return {
+                type: "media",
+                media: {
+                    id: candidate.fileUniqueId || candidate.fileId,
+                    kind: candidate.kind,
+                    source: "telegram",
+                    status: "ready",
+                    filePath: stored.filePath,
+                    filename: stored.filename,
+                    ...(stored.mimeType ? { mimeType: stored.mimeType } : {}),
+                    sizeBytes: stored.sizeBytes,
+                    providerFileId: candidate.fileId,
+                    ...(candidate.fileUniqueId ? { providerFileUniqueId: candidate.fileUniqueId } : {}),
+                    providerUrl: url,
+                },
+            };
+        }
+        catch (error) {
+            const classified = classifyDeliveryError(error);
+            return {
+                type: "media",
+                media: {
+                    id: candidate.fileUniqueId || candidate.fileId,
+                    kind: candidate.kind,
+                    source: "telegram",
+                    status: "failed",
+                    providerFileId: candidate.fileId,
+                    ...(candidate.fileUniqueId ? { providerFileUniqueId: candidate.fileUniqueId } : {}),
+                    ...(candidate.filename ? { filename: candidate.filename } : {}),
+                    ...(candidate.mimeType ? { mimeType: candidate.mimeType } : {}),
+                    ...(typeof candidate.sizeBytes === "number" ? { sizeBytes: candidate.sizeBytes } : {}),
+                    error: `${classified.code}: ${classified.message}`,
+                },
+            };
+        }
+    };
     bot.catch((err) => {
         log.error({ error: err.error }, "telegram bot error");
     });
@@ -28,6 +172,8 @@ export function createTelegramAdapter(identity, config, logger, onMessage) {
         const msg = ctx.message;
         if (!msg?.chat)
             return;
+        const mediaCandidates = extractMediaCandidates(msg);
+        const hasMedia = mediaCandidates.length > 0;
         const chatType = msg.chat.type;
         const isGroup = chatType === "group" || chatType === "supergroup" || chatType === "channel";
         // In groups, check if groups are enabled
@@ -36,8 +182,6 @@ export function createTelegramAdapter(identity, config, logger, onMessage) {
             return;
         }
         let text = msg.text ?? msg.caption ?? "";
-        if (!text.trim())
-            return;
         // In groups, only respond if the bot is @mentioned
         if (isGroup) {
             const botUsername = ctx.me?.username;
@@ -52,18 +196,41 @@ export function createTelegramAdapter(identity, config, logger, onMessage) {
             }
             // Strip the @mention from the message
             text = text.replace(mentionPattern, "").trim();
-            if (!text) {
+            if (!text && !hasMedia) {
                 log.debug({ chatId: msg.chat.id }, "telegram message ignored (empty after removing mention)");
                 return;
             }
         }
-        log.debug({ chatId: msg.chat.id, chatType, isGroup, length: text.length, preview: text.slice(0, 120) }, "telegram message received");
+        if (!text.trim() && !hasMedia) {
+            return;
+        }
+        const parts = [];
+        if (text.trim()) {
+            parts.push({ type: "text", text: text.trim() });
+        }
+        for (const candidate of mediaCandidates) {
+            const part = await downloadCandidate(String(msg.chat.id), candidate);
+            if ((msg.caption ?? "").trim() && part.type === "media") {
+                parts.push({ ...part, caption: msg.caption?.trim() });
+            }
+            else {
+                parts.push(part);
+            }
+        }
+        const textForPrompt = parts
+            .filter((part) => part.type === "text")
+            .map((part) => part.text)
+            .join("\n")
+            .trim();
+        const preview = textForPrompt || `${parts.filter((part) => part.type === "media").length} media attachment(s)`;
+        log.debug({ chatId: msg.chat.id, chatType, isGroup, length: textForPrompt.length, preview: preview.slice(0, 120) }, "telegram message received");
         try {
             await onMessage({
                 channel: "telegram",
                 identityId: identity.id,
                 peerId: String(msg.chat.id),
-                text,
+                text: textForPrompt,
+                parts,
                 raw: msg,
             });
         }
@@ -71,6 +238,60 @@ export function createTelegramAdapter(identity, config, logger, onMessage) {
             log.error({ error, peerId: msg.chat.id }, "telegram inbound handler failed");
         }
     });
+    const sendMessageInternal = async (peerId, message) => {
+        const chatId = parseTelegramPeerId(peerId);
+        if (chatId === null) {
+            throw invalidTelegramPeerIdError();
+        }
+        const partResults = [];
+        let sentParts = 0;
+        for (let index = 0; index < message.parts.length; index += 1) {
+            const part = message.parts[index];
+            try {
+                if (part.type === "text") {
+                    const chunks = chunkText(part.text, MAX_TEXT_LENGTH);
+                    for (const chunk of chunks) {
+                        await withDeliveryRetry("telegram.sendMessage", () => bot.api.sendMessage(chatId, chunk), {
+                            logger: log,
+                        });
+                    }
+                }
+                else if (part.type === "image") {
+                    await withDeliveryRetry("telegram.sendPhoto", () => bot.api.sendPhoto(chatId, new InputFile(part.filePath, part.filename), {
+                        ...(truncateCaption(part.caption) ? { caption: truncateCaption(part.caption) } : {}),
+                    }), { logger: log });
+                }
+                else if (part.type === "audio") {
+                    await withDeliveryRetry("telegram.sendAudio", () => bot.api.sendAudio(chatId, new InputFile(part.filePath, part.filename), {
+                        ...(truncateCaption(part.caption) ? { caption: truncateCaption(part.caption) } : {}),
+                    }), { logger: log });
+                }
+                else {
+                    await withDeliveryRetry("telegram.sendDocument", () => bot.api.sendDocument(chatId, new InputFile(part.filePath, part.filename), {
+                        ...(truncateCaption(part.caption) ? { caption: truncateCaption(part.caption) } : {}),
+                    }), { logger: log });
+                }
+                sentParts += 1;
+                partResults.push({ index, type: part.type, sent: true });
+            }
+            catch (error) {
+                const classified = classifyDeliveryError(error);
+                partResults.push({
+                    index,
+                    type: part.type,
+                    sent: false,
+                    error: classified.message,
+                    code: classified.code,
+                    retryable: classified.retryable,
+                });
+            }
+        }
+        return {
+            attemptedParts: message.parts.length,
+            sentParts,
+            partResults,
+        };
+    };
     return {
         name: "telegram",
         identityId: identity.id,
@@ -84,14 +305,17 @@ export function createTelegramAdapter(identity, config, logger, onMessage) {
             bot.stop();
             log.info("telegram adapter stopped");
         },
+        async sendMessage(peerId, message) {
+            return sendMessageInternal(peerId, message);
+        },
         async sendText(peerId, text) {
-            const chatId = parseTelegramPeerId(peerId);
-            if (chatId === null) {
-                const error = new Error("Telegram peerId must be a numeric chat_id. Usernames like @name are not valid direct targets.");
-                error.status = 400;
-                throw error;
+            const result = await sendMessageInternal(peerId, {
+                parts: [{ type: "text", text }],
+            });
+            if (result.sentParts === 0) {
+                const firstError = result.partResults.find((part) => !part.sent)?.error;
+                throw new Error(firstError || "Failed to deliver Telegram text message");
             }
-            await bot.api.sendMessage(chatId, text);
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-router",
-  "version": "0.11.128",
+  "version": "0.11.129",
   "description": "opencode-router: Slack + Telegram bridge + directory routing for a running opencode server",
   "private": false,
   "type": "module",