opencode-telegram-bot 1.0.6 → 1.0.7

package/README.md

@@ -111,6 +111,8 @@ These are handled directly by the Telegram bot:
 | `/usage` | Show token and cost usage for this session |
 | `/help` | Show available commands |
 
+The bot also registers these commands in Telegram's command menu (the `/` button), plus any OpenCode server commands discovered at startup (excluding hidden ones like `/init` and `/review`).
+
 ### Verbose Mode
 
 By default, the bot only shows the assistant's final text response. Use `/verbose` to toggle verbose mode (or `/verbose on|off` to set it explicitly), which also displays:
@@ -217,17 +219,14 @@ Bot:  Your sessions:
       Current session: Fix the broken tests
       Tap a session to switch or delete.
 
-You:  /switch def6
-Bot:  Switched to session: Auth refactoring (def67890)
-
 You:  What were we working on?
 Bot:  [agent responds with context from the auth refactoring session]
 
-You:  /delete abc1
-Bot:  Deleted session: Fix the broken tests (abc12345)
+You:  [tap "Auth refactoring"]
+Bot:  Switched to session: Auth refactoring
 ```
 
-The `/sessions` list only shows sessions created by the Telegram bot, not sessions from other OpenCode clients (like the TUI). You cannot delete the currently active session -- use `/new` or `/switch` first.
+The `/sessions` list only shows sessions created by the Telegram bot, not sessions from other OpenCode clients (like the TUI). You cannot delete the currently active session -- use `/new` first.
 
 ## Session Persistence
 

package/dist/app.d.ts

@@ -49,6 +49,10 @@ interface TelegramBot {
         getFileLink: (fileId: string) => Promise<{
             toString(): string;
         }>;
+        setMyCommands: (commands: Array<{
+            command: string;
+            description: string;
+        }>) => Promise<unknown>;
     };
 }
 export declare function startTelegram(options: StartOptions): Promise<TelegramBot>;

package/dist/index.js

@@ -18589,6 +18589,9 @@ async function startTelegram(options) {
     const client = options.client || client_createOpencodeClient({ baseUrl: url });
     // Verify connection to the OpenCode server and fetch available commands
     const opencodeCommands = new Set();
+    const opencodeCommandMenu = [];
+    const hiddenOpenCodeCommands = new Set(["init", "review", "reviews"]);
+    const isHiddenOpenCodeCommand = (name) => hiddenOpenCodeCommands.has(name.toLowerCase());
     let projectDirectory = "";
     try {
         const sessions = await client.session.list();
@@ -18606,7 +18609,16 @@ async function startTelegram(options) {
         const cmds = await client.command.list();
         if (cmds.data) {
             for (const cmd of cmds.data) {
-                opencodeCommands.add(cmd.name);
+                const name = cmd.name;
+                if (!name)
+                    continue;
+                opencodeCommands.add(name);
+                if (!isHiddenOpenCodeCommand(name)) {
+                    opencodeCommandMenu.push({
+                        command: name,
+                        description: cmd.description || "OpenCode command",
+                    });
+                }
             }
             console.log(`[Telegram] Available OpenCode commands: ${[...opencodeCommands].join(", ")}`);
         }
@@ -18618,6 +18630,17 @@ async function startTelegram(options) {
     const telegramCommands = new Set([
         "start", "help", "new", "sessions", "switch", "title", "delete", "export", "verbose", "model", "usage",
     ]);
+    const telegramCommandMenu = [
+        { command: "new", description: "Start a new conversation" },
+        { command: "sessions", description: "List your sessions" },
+        { command: "title", description: "Rename a session (/title <text>)" },
+        { command: "export", description: "Export session (/export full for details)" },
+        { command: "verbose", description: "Toggle verbose mode" },
+        { command: "model", description: "Search models (/model <keyword>)" },
+        { command: "usage", description: "Show token and cost usage" },
+        { command: "help", description: "Show available commands" },
+    ];
+    const getVisibleOpenCodeCommands = () => [...opencodeCommands].filter((command) => !isHiddenOpenCodeCommand(command));
     // Map of chatId -> sessionId for the active session per chat
     const chatSessions = new Map();
     // Set of all session IDs ever created/used by this bot (for filtering)
@@ -19119,6 +19142,25 @@ async function startTelegram(options) {
     const bot = options.botFactory
         ? options.botFactory(token)
         : new lib.Telegraf(token);
+    async function registerCommandMenu() {
+        const combined = [...telegramCommandMenu, ...opencodeCommandMenu];
+        const seen = new Set();
+        const commands = [];
+        for (const entry of combined) {
+            if (!entry.command || seen.has(entry.command))
+                continue;
+            seen.add(entry.command);
+            commands.push(entry);
+        }
+        if (commands.length === 0)
+            return;
+        try {
+            await bot.telegram.setMyCommands(commands);
+        }
+        catch (err) {
+            console.warn("[Telegram] Failed to register command menu:", err);
+        }
+    }
     // Middleware to check if the user is authorized
     bot.use((ctx, next) => {
         if (!authorizedUserId) {
@@ -19134,24 +19176,26 @@ async function startTelegram(options) {
             return;
         }
     });
+    await registerCommandMenu();
     // Handle /start command
     bot.start((ctx) => {
         let msg = "Hello! I'm your OpenCode bot. Send me a message and I'll forward it to the OpenCode agent.\n\n" +
             "Bot commands:\n" +
             "/new - Start a new conversation\n" +
-            "/sessions - List your sessions\n" +
+            "/sessions - List your sessions (buttons)\n" +
             "/title <text> - Rename the current 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" +
             "/verbose on|off - Set verbose mode explicitly\n" +
-            "/model - Show or search available models\n" +
+            "/model <keyword> - Search available models\n" +
             "/usage - Show token and cost usage for this session\n" +
             "/help - Show this help message\n";
-        if (opencodeCommands.size > 0) {
+        const visibleOpenCodeCommands = getVisibleOpenCodeCommands();
+        if (visibleOpenCodeCommands.length > 0) {
             msg +=
                 "\nOpenCode commands are also available:\n" +
-                    [...opencodeCommands].map((c) => `/${c}`).join(", ");
+                    visibleOpenCodeCommands.map((c) => `/${c}`).join(", ");
         }
         ctx.reply(msg);
     });
@@ -19160,19 +19204,20 @@ async function startTelegram(options) {
         let msg = "Send me any message and I'll process it using OpenCode.\n\n" +
             "Bot commands:\n" +
             "/new - Start a new conversation\n" +
-            "/sessions - List your sessions\n" +
+            "/sessions - List your sessions (buttons)\n" +
             "/title <text> - Rename the current 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" +
             "/verbose on|off - Set verbose mode explicitly\n" +
-            "/model - Show or search available models\n" +
+            "/model <keyword> - Search available models\n" +
             "/usage - Show token and cost usage for this session\n" +
             "/help - Show this help message\n";
-        if (opencodeCommands.size > 0) {
+        const visibleOpenCodeCommands = getVisibleOpenCodeCommands();
+        if (visibleOpenCodeCommands.length > 0) {
             msg +=
                 "\nOpenCode commands:\n" +
-                    [...opencodeCommands].map((c) => `/${c}`).join(", ");
+                    visibleOpenCodeCommands.map((c) => `/${c}`).join(", ");
         }
         ctx.reply(msg);
     });
@@ -19842,7 +19887,9 @@ async function startTelegram(options) {
             }
             // Check if it's a known OpenCode command
             if (!opencodeCommands.has(commandName)) {
-                const available = [...opencodeCommands].map((c) => `/${c}`).join(", ");
+                const available = getVisibleOpenCodeCommands()
+                    .map((c) => `/${c}`)
+                    .join(", ");
                 await ctx.reply(`Unknown command: /${commandName}\n\n` +
                     `Available OpenCode commands: ${available || "none"}\n` +
                     `Bot commands: /new, /help`);

package/package.json

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