opencode-telegram-bot 1.0.2 → 1.0.3

package/README.md

@@ -105,8 +105,30 @@ These are handled directly by the Telegram bot:
 | `/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 |
 | `/help` | Show available commands |
 
+### 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:
+
+- **Thinking/reasoning** -- shown as plain text with a 🧠 prefix, truncated to 500 characters
+- **Tool calls** -- shown as a compact one-line summary (e.g. `> read -- src/app.ts`)
+
+Verbose mode is per-chat and persists across bot restarts. Use `/verbose` again to turn it off.
+
+Example with verbose mode on:
+
+```
+🧠 Thinking: Let me analyze the authentication flow and check for potential issues...
+
+⚙️ grep -- pattern: "authenticate" in src/
+⚙️ read -- src/auth/handler.ts
+
+Here's what I found in the auth module...
+```
+
 ### Session Export
 
 The `/export` command builds a markdown file from the current session and saves it to the directory where OpenCode is running. The file is also sent back to you as a Telegram document.

package/dist/index.js

@@ -18588,12 +18588,19 @@ async function startTelegram(options) {
     const client = client_createOpencodeClient({ baseUrl: url });
     // Verify connection to the OpenCode server and fetch available commands
     const opencodeCommands = new Set();
+    let projectDirectory = "";
     try {
         const sessions = await client.session.list();
         if (sessions.error) {
             throw new Error(`Server returned error: ${JSON.stringify(sessions.error)}`);
         }
         console.log(`[Telegram] Connected to OpenCode server at ${url}`);
+        // Fetch the project directory (needed for SSE event subscription)
+        const pathResult = await client.path.get();
+        if (pathResult.data?.directory) {
+            projectDirectory = pathResult.data.directory;
+            console.log(`[Telegram] Project directory: ${projectDirectory}`);
+        }
         // Fetch available OpenCode commands
         const cmds = await client.command.list();
         if (cmds.data) {
@@ -18608,12 +18615,14 @@ async function startTelegram(options) {
     }
     // Telegram-only commands that should not be forwarded to OpenCode
     const telegramCommands = new Set([
-        "start", "help", "new", "sessions", "switch", "title", "delete", "export",
+        "start", "help", "new", "sessions", "switch", "title", "delete", "export", "verbose",
     ]);
     // 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)
     const knownSessionIds = new Set();
+    // Set of chatIds with verbose mode enabled
+    const chatVerboseMode = new Set();
     /**
      * Save the chat-to-session mapping and known session IDs to disk.
      */
@@ -18622,6 +18631,7 @@ async function startTelegram(options) {
             const data = {
                 active: Object.fromEntries(chatSessions),
                 known: [...knownSessionIds],
+                verbose: [...chatVerboseMode],
             };
             (0,external_node_fs_.writeFileSync)(SESSIONS_FILE, JSON.stringify(data, null, 2));
         }
@@ -18637,14 +18647,16 @@ async function startTelegram(options) {
         // Load from file (supports both old flat format and new {active, known} format)
         let storedActive = {};
         let storedKnown = [];
+        let storedVerbose = [];
         if ((0,external_node_fs_.existsSync)(SESSIONS_FILE)) {
             try {
                 const raw = (0,external_node_fs_.readFileSync)(SESSIONS_FILE, "utf-8");
                 const parsed = JSON.parse(raw);
                 if (parsed.active && typeof parsed.active === "object") {
-                    // New format: { active: {...}, known: [...] }
+                    // New format: { active: {...}, known: [...], verbose: [...] }
                     storedActive = parsed.active;
                     storedKnown = parsed.known || [];
+                    storedVerbose = parsed.verbose || [];
                 }
                 else {
                     // Old format: flat { chatId: sessionId }
@@ -18656,6 +18668,13 @@ async function startTelegram(options) {
                 console.warn("[Telegram] Failed to parse sessions file:", err);
             }
         }
+        // Restore verbose mode preferences
+        for (const chatId of storedVerbose) {
+            chatVerboseMode.add(chatId);
+        }
+        if (storedVerbose.length > 0) {
+            console.log(`[Telegram] Restored verbose mode for ${storedVerbose.length} chat(s)`);
+        }
         // Fetch all server sessions once for validation and fallback matching
         let serverSessions = [];
         try {
@@ -18758,6 +18777,52 @@ async function startTelegram(options) {
             console.warn("[Telegram] Failed to auto-title session:", err);
         }
     }
+    /**
+     * Build a one-line summary for a tool call, picking the most meaningful input field.
+     */
+    function summarizeTool(tool, input) {
+        if (!input)
+            return tool;
+        // Pick the most descriptive field based on common tool patterns
+        const summaryField = input.filePath || input.path || input.command || input.pattern ||
+            input.url || input.query || input.content || input.prompt ||
+            input.description || input.name;
+        if (summaryField && typeof summaryField === "string") {
+            return `${tool} -- ${truncate(summaryField, 80)}`;
+        }
+        // For tools with a glob/include pattern
+        if (input.include && typeof input.include === "string") {
+            return `${tool} -- ${truncate(input.include, 80)}`;
+        }
+        return tool;
+    }
+    /**
+     * Send a message to Telegram, with Markdown fallback.
+     * When disableLinkPreview is true, link previews are suppressed (useful for verbose messages).
+     */
+    async function sendTelegramMessage(chatId, text, disableLinkPreview = false) {
+        const options = {
+            parse_mode: "Markdown",
+        };
+        if (disableLinkPreview) {
+            options.link_preview_options = { is_disabled: true };
+        }
+        try {
+            await bot.telegram.sendMessage(chatId, text, options);
+        }
+        catch {
+            try {
+                const fallbackOptions = {};
+                if (disableLinkPreview) {
+                    fallbackOptions.link_preview_options = { is_disabled: true };
+                }
+                await bot.telegram.sendMessage(chatId, text, fallbackOptions);
+            }
+            catch (fallbackErr) {
+                console.error("[Telegram] Fallback error:", fallbackErr);
+            }
+        }
+    }
     /**
      * Extract text from response parts and send to Telegram chat.
      */
@@ -18781,20 +18846,145 @@ async function startTelegram(options) {
         // Send the response, splitting if needed (Telegram has a 4096 char limit)
         const chunks = splitMessage(responseText, 4096);
         for (const chunk of chunks) {
-            try {
-                await bot.telegram.sendMessage(chatId, chunk, {
-                    parse_mode: "Markdown",
-                });
-            }
-            catch {
+            await sendTelegramMessage(chatId, chunk);
+        }
+    }
+    /**
+     * Send a prompt with streaming: fires the prompt asynchronously, then listens
+     * to SSE events to stream thinking and tool call updates to Telegram in real-time.
+     * The final text response is sent when the session goes idle.
+     */
+    async function sendPromptStreaming(chatId, sessionId, promptBody, processingMsgId, verbose = false) {
+        // Subscribe to SSE events before sending the prompt so we don't miss anything
+        const abortController = new AbortController();
+        // Subscribe to SSE events before sending the prompt so we don't miss anything
+        const subscribeOptions = {
+            signal: abortController.signal,
+        };
+        if (projectDirectory) {
+            subscribeOptions.query = { directory: projectDirectory };
+        }
+        const { stream } = await client.event.subscribe(subscribeOptions);
+        // Fire the prompt asynchronously (returns immediately)
+        const asyncResult = await client.session.promptAsync({
+            path: { id: sessionId },
+            body: promptBody,
+        });
+        if (asyncResult.error) {
+            abortController.abort();
+            throw new Error(`Prompt failed: ${JSON.stringify(asyncResult.error)}`);
+        }
+        // Track state as events stream in
+        let finalText = "";
+        let processingMsgDeleted = false;
+        const sentToolIds = new Set();
+        const sentReasoningIds = new Set();
+        // Buffer the latest reasoning text -- we send it when a non-reasoning part arrives
+        // so we get the complete thinking block rather than a partial one
+        let pendingReasoning = null;
+        /**
+         * Delete the "processing" message once, right before sending the first real output.
+         */
+        async function deleteProcessingMsg() {
+            if (!processingMsgDeleted) {
+                processingMsgDeleted = true;
                 try {
-                    await bot.telegram.sendMessage(chatId, chunk);
+                    await bot.telegram.deleteMessage(chatId, processingMsgId);
+                }
+                catch {
+                    // Ignore
+                }
+            }
+        }
+        /**
+         * Flush any buffered reasoning to Telegram as a spoiler message.
+         */
+        async function flushReasoning() {
+            if (verbose && pendingReasoning && !sentReasoningIds.has(pendingReasoning.id)) {
+                sentReasoningIds.add(pendingReasoning.id);
+                await deleteProcessingMsg();
+                const truncated = truncate(pendingReasoning.text.replace(/\n/g, " "), 500);
+                await sendTelegramMessage(chatId, `\u{1F9E0} Thinking: ${truncated}`, true);
+            }
+            pendingReasoning = null;
+        }
+        try {
+            for await (const event of stream) {
+                const ev = event;
+                if (ev.type === "message.part.updated" && ev.properties) {
+                    const part = ev.properties.part;
+                    // Only process events for our session
+                    if (part.sessionID !== sessionId)
+                        continue;
+                    const partText = part.text;
+                    if (part.type === "reasoning" && part.id) {
+                        // Buffer reasoning -- keep updating with the latest full text
+                        if (partText) {
+                            pendingReasoning = { id: part.id, text: partText };
+                        }
+                    }
+                    else if (part.type === "tool" && part.id) {
+                        // A tool part arrived -- flush any pending reasoning first
+                        await flushReasoning();
+                        if (verbose) {
+                            const state = part.state;
+                            // Only send tool messages once they have a completed/error status
+                            if (state &&
+                                (state.status === "completed" || state.status === "error") &&
+                                !sentToolIds.has(part.id)) {
+                                sentToolIds.add(part.id);
+                                await deleteProcessingMsg();
+                                const tool = part.tool;
+                                const summary = summarizeTool(tool, state.input);
+                                let line = `\u{2699}\u{FE0F} ${summary}`;
+                                if (state.status === "error") {
+                                    line += ` \u{274C}`;
+                                }
+                                await sendTelegramMessage(chatId, line, true);
+                            }
+                        }
+                    }
+                    else if (part.type === "text") {
+                        // A text part arrived -- flush any pending reasoning first
+                        await flushReasoning();
+                        // Accumulate text for the final response (text parts carry the full text, not deltas)
+                        const text = part.text;
+                        if (text) {
+                            finalText = text;
+                        }
+                    }
                 }
-                catch (fallbackErr) {
-                    console.error("[Telegram] Fallback error:", fallbackErr);
+                else if (ev.type === "session.idle" && ev.properties) {
+                    const idleSessionId = ev.properties.sessionID;
+                    if (idleSessionId === sessionId) {
+                        // Flush any remaining reasoning before finishing
+                        await flushReasoning();
+                        break;
+                    }
+                }
+                else if (ev.type === "session.error" && ev.properties) {
+                    const errorSessionId = ev.properties.sessionID;
+                    if (errorSessionId === sessionId) {
+                        const error = ev.properties.error;
+                        const errorMsg = error?.data?.message || "Unknown error";
+                        throw new Error(`Session error: ${errorMsg}`);
+                    }
                 }
             }
         }
+        finally {
+            abortController.abort();
+        }
+        // Delete the processing message if it hasn't been deleted yet (non-verbose mode)
+        await deleteProcessingMsg();
+        // Send the final text response
+        if (!finalText) {
+            finalText = "The agent returned an empty response.";
+        }
+        const chunks = splitMessage(finalText, 4096);
+        for (const chunk of chunks) {
+            await sendTelegramMessage(chatId, chunk);
+        }
     }
     /**
      * Handle session errors - clear invalid sessions.
@@ -18847,6 +19037,8 @@ async function startTelegram(options) {
             "/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" +
+            "/verbose on|off - Set verbose mode explicitly\n" +
             "/help - Show this help message\n";
         if (opencodeCommands.size > 0) {
             msg +=
@@ -18866,6 +19058,8 @@ async function startTelegram(options) {
             "/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" +
+            "/verbose on|off - Set verbose mode explicitly\n" +
             "/help - Show this help message\n";
         if (opencodeCommands.size > 0) {
             msg +=
@@ -19025,6 +19219,32 @@ async function startTelegram(options) {
             await ctx.reply("Failed to delete session.");
         }
     });
+    // Handle /verbose command - toggle verbose mode for this chat
+    // Usage: /verbose, /verbose on, /verbose off
+    bot.command("verbose", (ctx) => {
+        const chatId = ctx.chat.id.toString();
+        const args = ctx.message.text.replace(/^\/verbose\s*/, "").trim().toLowerCase();
+        if (args === "on") {
+            chatVerboseMode.add(chatId);
+        }
+        else if (args === "off") {
+            chatVerboseMode.delete(chatId);
+        }
+        else {
+            if (chatVerboseMode.has(chatId)) {
+                chatVerboseMode.delete(chatId);
+            }
+            else {
+                chatVerboseMode.add(chatId);
+            }
+        }
+        saveSessions();
+        const enabled = chatVerboseMode.has(chatId);
+        console.log(`[Telegram] Verbose mode ${enabled ? "enabled" : "disabled"} for chat ${chatId}`);
+        ctx.reply(enabled
+            ? "Verbose mode enabled. Responses will include thinking and tool calls."
+            : "Verbose mode disabled. Responses will only show the assistant's text.");
+    });
     /**
      * Render a message part to markdown.
      * In default mode: only text and tool calls (name + input/output).
@@ -19316,15 +19536,8 @@ async function startTelegram(options) {
                 const modelID = modelParts.join("/");
                 promptBody.model = { providerID, modelID };
             }
-            const result = await client.session.prompt({
-                path: { id: sessionId },
-                body: promptBody,
-            });
-            if (result.error) {
-                throw new Error(`Prompt failed: ${JSON.stringify(result.error)}`);
-            }
-            const parts = (result.data?.parts || []);
-            await sendResponseToChat(ctx.chat.id, parts, processingMsg.message_id);
+            const verbose = chatVerboseMode.has(chatId);
+            await sendPromptStreaming(ctx.chat.id, sessionId, promptBody, processingMsg.message_id, verbose);
         }
         catch (err) {
             console.error("[Telegram] Error processing message:", err);

package/package.json

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