opencode-telegram-bot 1.0.4 → 1.0.6

package/README.md

@@ -99,17 +99,14 @@ These are handled directly by the Telegram bot:
 |---|---|
 | `/start` | Welcome message |
 | `/new` | Start a new conversation |
-| `/sessions` | List all sessions with their IDs |
-| `/switch <id>` | Switch to a different session (prefix match supported) |
+| `/sessions` | List sessions with inline buttons |
 | `/title <text>` | Rename the current session |
-| `/delete <id>` | Delete a session from the server |
 | `/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 |
 | `/model default` | Reset to the default model |
 | `/usage` | Show token and cost usage for this session |
 | `/help` | Show available commands |
@@ -141,13 +138,11 @@ Use `/model` to search and switch models without typing long names:
 ```
 You:  /model sonnet
 Bot:  Models matching "sonnet":
-      1. claude-sonnet-4-5 (google-vertex-anthropic)
-      2. claude-sonnet-4 (anthropic)
+      Tap a model to select.
 
-      Use /model <number> to select.
-
-You:  /model 1
+You:  [tap "claude-sonnet-4-5 (google-vertex-anthropic)"]
 Bot:  Switched to claude-sonnet-4-5 (google-vertex-anthropic)
+
 ```
 
 Other commands:
@@ -190,6 +185,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.
@@ -212,9 +214,8 @@ Bot:  [agent response about tests - new session auto-titled "Fix the broken test
 
 You:  /sessions
 Bot:  Your sessions:
-       [active] Fix the broken tests - 2 min ago (abc12345)
-       Auth refactoring - 1 hour ago (def67890)
-      Use /switch <id> to switch sessions.
+      Current session: Fix the broken tests
+      Tap a session to switch or delete.
 
 You:  /switch def6
 Bot:  Switched to session: Auth refactoring (def67890)

package/dist/app.d.ts

@@ -36,6 +36,7 @@ interface TelegramBot {
     help: (fn: (ctx: any) => void | Promise<void>) => void;
     command: (command: string, fn: (ctx: any) => void | Promise<void>) => void;
     on: (event: string, fn: (ctx: any) => void | Promise<void>) => void;
+    action: (trigger: string | RegExp, fn: (ctx: any) => void | Promise<void>) => void;
     launch: () => Promise<void>;
     stop: (reason?: string) => void;
     telegram: {
@@ -45,6 +46,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,64 @@ 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;
+    }
+    function getChatIdFromContext(ctx) {
+        const direct = ctx.chat?.id;
+        if (direct)
+            return direct.toString();
+        const fromCallback = ctx.callbackQuery?.message?.chat?.id;
+        if (fromCallback)
+            return fromCallback.toString();
+        return null;
+    }
+    async function answerAndEdit(ctx, text) {
+        if (typeof ctx.answerCbQuery === "function") {
+            await ctx.answerCbQuery();
+        }
+        if (typeof ctx.editMessageText === "function") {
+            await ctx.editMessageText(text);
+            return;
+        }
+        await ctx.reply(text);
+    }
+    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 +19058,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.
      */
@@ -19048,9 +19140,7 @@ async function startTelegram(options) {
             "Bot commands:\n" +
             "/new - Start a new conversation\n" +
             "/sessions - List your sessions\n" +
-            "/switch <number> - Switch to a different session\n" +
             "/title <text> - Rename the current session\n" +
-            "/delete <number> - Delete a session\n" +
             "/export - Export the current session as a markdown file\n" +
             "/export full - Export with all details (thinking, costs, steps)\n" +
             "/verbose - Toggle verbose mode (show thinking and tool calls)\n" +
@@ -19071,9 +19161,7 @@ async function startTelegram(options) {
             "Bot commands:\n" +
             "/new - Start a new conversation\n" +
             "/sessions - List your sessions\n" +
-            "/switch <number> - Switch to a different session\n" +
             "/title <text> - Rename the current session\n" +
-            "/delete <number> - Delete a session\n" +
             "/export - Export the current session as a markdown file\n" +
             "/export full - Export with all details (thinking, costs, steps)\n" +
             "/verbose - Toggle verbose mode (show thinking and tool calls)\n" +
@@ -19109,16 +19197,9 @@ async function startTelegram(options) {
             .sort((a, b) => b.time.updated - a.time.updated);
     }
     /**
-     * Resolve a user argument to a session. Accepts either a numeric index
-     * (1-based, as shown by /sessions) or a session ID / prefix.
+     * Resolve a user argument to a session ID / prefix.
      */
     function resolveSession(sessions, arg) {
-        // Try numeric index first
-        const num = parseInt(arg, 10);
-        if (!isNaN(num) && String(num) === arg && num >= 1 && num <= sessions.length) {
-            return sessions[num - 1];
-        }
-        // Fall back to ID / prefix match
         return sessions.find((s) => s.id === arg || s.id.startsWith(arg));
     }
     // Handle /sessions command - list Telegram bot sessions only
@@ -19131,28 +19212,48 @@ async function startTelegram(options) {
                 await ctx.reply("No sessions found.");
                 return;
             }
-            let msg = "Your sessions:\n\n";
-            sessions.forEach((session, i) => {
-                const isActive = session.id === activeSessionId;
-                const age = formatAge(session.time.updated);
-                const marker = isActive ? " [active]" : "";
-                msg += `${i + 1}. ${session.title} - ${age}${marker}\n`;
+            const activeSession = sessions.find((session) => session.id === activeSessionId);
+            const msgLines = ["Your sessions:"];
+            if (activeSession) {
+                msgLines.push(`Current session: ${activeSession.title}`);
+            }
+            const otherSessions = sessions.filter((session) => session.id !== activeSessionId);
+            if (otherSessions.length === 0) {
+                msgLines.push("This is your only session.");
+                await ctx.reply(msgLines.join("\n"));
+                return;
+            }
+            msgLines.push("Tap a session to switch or delete.");
+            const keyboard = [];
+            otherSessions.forEach((session) => {
+                keyboard.push([
+                    {
+                        text: session.title,
+                        callback_data: `switch:${session.id}`,
+                    },
+                    {
+                        text: "Delete",
+                        callback_data: `delete:${session.id}`,
+                    },
+                ]);
+            });
+            await ctx.reply(msgLines.join("\n"), {
+                reply_markup: {
+                    inline_keyboard: keyboard,
+                },
             });
-            msg += `\nUse /switch <number> to switch sessions.`;
-            msg += `\nUse /delete <number> to delete a session.`;
-            await ctx.reply(msg);
         }
         catch (err) {
             console.error("[Telegram] Error listing sessions:", err);
             await ctx.reply("Failed to list sessions.");
         }
     });
-    // Handle /switch <number> command - switch to a different session
+    // Handle /switch <id> command - switch to a different session
     bot.command("switch", async (ctx) => {
         const chatId = ctx.chat.id.toString();
         const args = ctx.message.text.replace(/^\/switch\s*/, "").trim();
         if (!args) {
-            await ctx.reply("Usage: /switch <number>\n\nUse /sessions to see available sessions.");
+            await ctx.reply("Usage: /switch <session id>\n\nUse /sessions to see available sessions.");
             return;
         }
         try {
@@ -19201,12 +19302,12 @@ async function startTelegram(options) {
             await ctx.reply("Failed to rename session.");
         }
     });
-    // Handle /delete <number> command - delete a session
+    // Handle /delete <id> command - delete a session
     bot.command("delete", async (ctx) => {
         const chatId = ctx.chat.id.toString();
         const args = ctx.message.text.replace(/^\/delete\s*/, "").trim();
         if (!args) {
-            await ctx.reply("Usage: /delete <number>\n\nUse /sessions to see available sessions.");
+            await ctx.reply("Usage: /delete <session id>\n\nUse /sessions to see available sessions.");
             return;
         }
         try {
@@ -19240,6 +19341,61 @@ async function startTelegram(options) {
             await ctx.reply("Failed to delete session.");
         }
     });
+    bot.action(/^switch:(.+)$/, async (ctx) => {
+        const chatId = getChatIdFromContext(ctx);
+        const sessionId = ctx.match?.[1];
+        if (!chatId || !sessionId)
+            return;
+        try {
+            const sessions = await getKnownSessions();
+            const match = sessions.find((session) => session.id === sessionId);
+            if (!match) {
+                await answerAndEdit(ctx, "Session not found. Use /sessions to refresh.");
+                return;
+            }
+            chatSessions.set(chatId, match.id);
+            saveSessions();
+            console.log(`[Telegram] Switched chat ${chatId} to session ${match.id}`);
+            await answerAndEdit(ctx, `Switched to session: ${match.title}`);
+        }
+        catch (err) {
+            console.error("[Telegram] Error switching session:", err);
+            await answerAndEdit(ctx, "Failed to switch session.");
+        }
+    });
+    bot.action(/^delete:(.+)$/, async (ctx) => {
+        const chatId = getChatIdFromContext(ctx);
+        const sessionId = ctx.match?.[1];
+        if (!chatId || !sessionId)
+            return;
+        try {
+            const sessions = await getKnownSessions();
+            const match = sessions.find((session) => session.id === sessionId);
+            if (!match) {
+                await answerAndEdit(ctx, "Session not found. Use /sessions to refresh.");
+                return;
+            }
+            const activeSessionId = chatSessions.get(chatId);
+            if (match.id === activeSessionId) {
+                await answerAndEdit(ctx, "Cannot delete the active session. Use /new or /switch first, then delete it.");
+                return;
+            }
+            const result = await client.session.delete({
+                path: { id: match.id },
+            });
+            if (result.error) {
+                throw new Error(JSON.stringify(result.error));
+            }
+            knownSessionIds.delete(match.id);
+            saveSessions();
+            console.log(`[Telegram] Deleted session ${match.id}`);
+            await answerAndEdit(ctx, `Deleted session: ${match.title}`);
+        }
+        catch (err) {
+            console.error("[Telegram] Error deleting session:", err);
+            await answerAndEdit(ctx, "Failed to delete session.");
+        }
+    });
     // Handle /verbose command - toggle verbose mode for this chat
     // Usage: /verbose, /verbose on, /verbose off
     bot.command("verbose", (ctx) => {
@@ -19295,7 +19451,7 @@ async function startTelegram(options) {
         return results;
     }
     // Handle /model command
-    // Usage: /model, /model <keyword>, /model <number>, /model default
+    // Usage: /model, /model <keyword>, /model default
     bot.command("model", async (ctx) => {
         const chatId = ctx.chat.id.toString();
         const args = ctx.message.text.replace(/^\/model\s*/, "").trim();
@@ -19312,24 +19468,6 @@ async function startTelegram(options) {
             await ctx.reply("Model reset to the default model.");
             return;
         }
-        const asNumber = Number.parseInt(args, 10);
-        if (!Number.isNaN(asNumber) && String(asNumber) === args) {
-            const results = chatModelSearchResults.get(chatId) || [];
-            if (results.length === 0) {
-                await ctx.reply("No recent search results. Use /model <keyword> first.");
-                return;
-            }
-            if (asNumber < 1 || asNumber > results.length) {
-                await ctx.reply("Invalid selection. Use /model <number> from the latest search results.");
-                return;
-            }
-            const selection = results[asNumber - 1];
-            const value = `${selection.providerID}/${selection.modelID}`;
-            chatModelOverride.set(chatId, value);
-            saveSessions();
-            await ctx.reply(`Switched to ${selection.displayName}`);
-            return;
-        }
         try {
             const results = await searchModels(args);
             if (results.length === 0) {
@@ -19338,21 +19476,60 @@ async function startTelegram(options) {
             }
             const limited = results.slice(0, 10);
             chatModelSearchResults.set(chatId, limited);
-            let msg = `Models matching "${args}":\n\n`;
-            for (const [index, item] of limited.entries()) {
-                msg += `${index + 1}. ${item.displayName}\n`;
-            }
+            let msg = `Models matching "${args}":`;
             if (results.length > limited.length) {
                 msg += `\nFound ${results.length} models. Refine your search to narrow the list.`;
             }
-            msg += "\nUse /model <number> to select.";
-            await ctx.reply(msg);
+            msg += "\nTap a model to select.";
+            const keyboard = limited.map((item, index) => [
+                {
+                    text: item.displayName,
+                    callback_data: `model:${index + 1}`,
+                },
+            ]);
+            keyboard.push([
+                { text: "Reset to default", callback_data: "model_default" },
+            ]);
+            await ctx.reply(msg, {
+                reply_markup: {
+                    inline_keyboard: keyboard,
+                },
+            });
         }
         catch (err) {
             console.error("[Telegram] Error searching models:", err);
             await ctx.reply("Failed to list models. Try again later.");
         }
     });
+    bot.action(/^model:(\d+)$/, async (ctx) => {
+        const chatId = getChatIdFromContext(ctx);
+        const indexText = ctx.match?.[1];
+        if (!chatId || !indexText)
+            return;
+        const selectionIndex = Number.parseInt(indexText, 10);
+        const results = chatModelSearchResults.get(chatId) || [];
+        if (results.length === 0) {
+            await answerAndEdit(ctx, "No recent search results. Use /model <keyword> first.");
+            return;
+        }
+        if (selectionIndex < 1 || selectionIndex > results.length) {
+            await answerAndEdit(ctx, "Invalid selection. Use the latest model search results.");
+            return;
+        }
+        const selection = results[selectionIndex - 1];
+        const value = `${selection.providerID}/${selection.modelID}`;
+        chatModelOverride.set(chatId, value);
+        saveSessions();
+        await answerAndEdit(ctx, `Switched to ${selection.displayName}`);
+    });
+    bot.action("model_default", async (ctx) => {
+        const chatId = getChatIdFromContext(ctx);
+        if (!chatId)
+            return;
+        chatModelOverride.delete(chatId);
+        saveSessions();
+        await answerAndEdit(ctx, "Model reset to the default model.");
+    });
     // Handle /usage command - show token and cost usage for current session
     bot.command("usage", async (ctx) => {
         const chatId = ctx.chat.id.toString();
@@ -19404,6 +19581,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 +19880,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);
         }
@@ -19721,22 +19908,6 @@ async function startTelegram(options) {
     }
     return bot;
 }
-/**
- * Format a Unix timestamp (seconds) into a human-readable relative time.
- */
-function formatAge(timestamp) {
-    const now = Date.now() / 1000;
-    const diff = now - timestamp;
-    if (diff < 60)
-        return "just now";
-    if (diff < 3600)
-        return `${Math.floor(diff / 60)} min ago`;
-    if (diff < 86400)
-        return `${Math.floor(diff / 3600)} hours ago`;
-    if (diff < 604800)
-        return `${Math.floor(diff / 86400)} days ago`;
-    return `${Math.floor(diff / 604800)} weeks ago`;
-}
 /**
  * Truncate text to a maximum length, appending "..." if truncated.
  */

package/package.json

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