opencode-telegram-bot 1.0.4 → 1.0.5

package/README.md

@@ -106,7 +106,7 @@ These are handled directly by the Telegram bot:
 | `/export` | Export the current session as a markdown file |
 | `/export full` | Export with all details (thinking, costs, steps) |
 | `/verbose` | Toggle verbose mode (show thinking and tool calls in chat) |
-| `/verbose on|off` | Explicitly enable/disable verbose mode |
+| `/verbose on\|off` | Explicitly enable/disable verbose mode |
 | `/model` | Show current model and usage hints |
 | `/model <keyword>` | Search models by keyword |
 | `/model <number>` | Switch to a model from the last search |
@@ -190,6 +190,13 @@ If you type an unknown command, the bot will reply with the list of available co
 
 Any other text message is forwarded to the OpenCode agent as a prompt. Follow-up messages go into the same session, so the agent has full conversation context. Use `/new` when you want a fresh conversation.
 
+### Files and Images
+
+You can send files or images to the bot. They are forwarded to OpenCode as file parts (with optional caption text). Text-based files (including markdown) are sent as text instead of file parts for better model compatibility. Supported types:
+
+- Photos sent via Telegram
+- Documents (PDFs, images, etc.)
+
 ## Session Management
 
 Sessions are never deleted automatically. You can have multiple sessions and switch between them.

package/dist/app.d.ts

@@ -45,6 +45,9 @@ interface TelegramBot {
             source: Buffer;
             filename: string;
         }) => Promise<void>;
+        getFileLink: (fileId: string) => Promise<{
+            toString(): string;
+        }>;
     };
 }
 export declare function startTelegram(options: StartOptions): Promise<TelegramBot>;

package/dist/index.js

@@ -18791,6 +18791,45 @@ async function startTelegram(options) {
             console.warn("[Telegram] Failed to auto-title session:", err);
         }
     }
+    function buildPromptBody(chatId, parts) {
+        const promptBody = { parts };
+        const modelOverride = chatModelOverride.get(chatId) || model;
+        if (modelOverride) {
+            const [providerID, ...modelParts] = modelOverride.split("/");
+            const modelID = modelParts.join("/");
+            promptBody.model = { providerID, modelID };
+        }
+        return promptBody;
+    }
+    async function getTelegramFileUrl(fileId) {
+        const link = await bot.telegram.getFileLink(fileId);
+        return link.toString();
+    }
+    function isTextMime(mime) {
+        const normalized = mime.toLowerCase();
+        return (normalized.startsWith("text/") ||
+            normalized === "application/json" ||
+            normalized === "application/xml" ||
+            normalized === "application/yaml" ||
+            normalized === "application/x-yaml" ||
+            normalized === "application/markdown");
+    }
+    async function fetchTelegramFileText(fileId, maxBytes = 200_000) {
+        const url = await getTelegramFileUrl(fileId);
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch file: ${response.status}`);
+        }
+        const contentLength = response.headers.get("content-length");
+        if (contentLength && Number(contentLength) > maxBytes) {
+            throw new Error("File is too large to send as text.");
+        }
+        const buffer = await response.arrayBuffer();
+        if (buffer.byteLength > maxBytes) {
+            throw new Error("File is too large to send as text.");
+        }
+        return new TextDecoder("utf-8").decode(buffer);
+    }
     /**
      * Build a one-line summary for a tool call, picking the most meaningful input field.
      */
@@ -19000,6 +19039,40 @@ async function startTelegram(options) {
             await sendTelegramMessage(chatId, chunk);
         }
     }
+    async function handleFileMessage(ctx, fileId, mime, filename, caption) {
+        const chatId = ctx.chat.id.toString();
+        try {
+            const processingMsg = await ctx.reply("Processing your request...");
+            const sessionId = await getOrCreateSession(chatId);
+            const titleText = caption || filename || "File upload";
+            await autoTitleSession(sessionId, titleText);
+            const parts = [];
+            if (caption) {
+                parts.push({ type: "text", text: caption });
+            }
+            const normalizedMime = mime.toLowerCase();
+            if (isTextMime(normalizedMime)) {
+                const textContent = await fetchTelegramFileText(fileId);
+                const header = filename ? `File: ${filename}` : "File";
+                parts.push({
+                    type: "text",
+                    text: `${header}\n\n${textContent}`,
+                });
+            }
+            else {
+                const url = await getTelegramFileUrl(fileId);
+                parts.push({ type: "file", mime: normalizedMime, filename, url });
+            }
+            const promptBody = buildPromptBody(chatId, parts);
+            const verbose = chatVerboseMode.has(chatId);
+            await sendPromptStreaming(ctx.chat.id, sessionId, promptBody, processingMsg.message_id, verbose);
+        }
+        catch (err) {
+            console.error("[Telegram] Error processing file message:", err);
+            await handleSessionError(chatId);
+            await ctx.reply("Sorry, there was an error processing your request. Try again or use /new to start a fresh session.");
+        }
+    }
     /**
      * Handle session errors - clear invalid sessions.
      */
@@ -19404,6 +19477,23 @@ async function startTelegram(options) {
             await ctx.reply("Failed to fetch usage. Try again later.");
         }
     });
+    // Handle photo messages (images)
+    bot.on("photo", async (ctx) => {
+        const photos = ctx.message.photo;
+        if (!photos || photos.length === 0)
+            return;
+        const largest = photos[photos.length - 1];
+        const caption = ctx.message.caption;
+        await handleFileMessage(ctx, largest.file_id, "image/jpeg", "photo.jpg", caption);
+    });
+    // Handle document messages (files)
+    bot.on("document", async (ctx) => {
+        const doc = ctx.message.document;
+        if (!doc)
+            return;
+        const caption = ctx.message.caption;
+        await handleFileMessage(ctx, doc.file_id, doc.mime_type || "application/octet-stream", doc.file_name, caption);
+    });
     /**
      * Render a message part to markdown.
      * In default mode: only text and tool calls (name + input/output).
@@ -19686,16 +19776,9 @@ async function startTelegram(options) {
             const sessionId = await getOrCreateSession(chatId);
             // Auto-title if this is the first message in a new session
             await autoTitleSession(sessionId, userText);
-            // Build the prompt body
-            const promptBody = {
-                parts: [{ type: "text", text: userText }],
-            };
-            const modelOverride = chatModelOverride.get(chatId) || model;
-            if (modelOverride) {
-                const [providerID, ...modelParts] = modelOverride.split("/");
-                const modelID = modelParts.join("/");
-                promptBody.model = { providerID, modelID };
-            }
+            const promptBody = buildPromptBody(chatId, [
+                { type: "text", text: userText },
+            ]);
             const verbose = chatVerboseMode.has(chatId);
             await sendPromptStreaming(ctx.chat.id, sessionId, promptBody, processingMsg.message_id, verbose);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-telegram-bot",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "description": "Telegram bot that forwards messages to an OpenCode agent",
   "main": "./dist/index.js",