opencode-telegram-bot 1.0.9 → 1.1.0

package/README.md

@@ -112,10 +112,26 @@ These are handled directly by the Telegram bot:
 | `/model` | Show current model and usage hints |
 | `/model <keyword>` | Search models by keyword |
 | `/model default` | Reset to the default model |
+| `/agent` | Show current agent and switch (plan, build, ...) |
+| `/agent <name>` | Switch directly to a named agent |
 | `/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`).
+### Interactive Questions
+
+When the OpenCode agent asks a question (e.g. to clarify intent or pick from options), the bot forwards it to Telegram as **inline keyboard buttons**. Tap an option to answer, or tap **Dismiss** to reject the question.
+
+If the bot restarts while a question is pending, it automatically re-sends the question buttons on startup so the session is not left stuck.
+
+```
+Agent: Which area do you want to focus on?
+       [Code review]  [Bug fix]  [New feature]  [Dismiss]
+
+You:   [tap "Bug fix"]
+Bot:   Answered: Bug fix
+```
+
+The bot also registers these commands in Telegram's command menu (the `/` button), plus any OpenCode server commands discovered at startup.
 
 ### Verbose Mode
 
@@ -163,6 +179,33 @@ Other commands:
 - `/model` shows the current model and usage hints
 - `/model default` resets to the server default
 
+### Agent Switching
+
+OpenCode supports multiple agents: **build** (default, full edit access), **plan** (read-only analysis), and others. Use `/agent` to see and switch between them:
+
+```
+You:  /agent
+Bot:  Current agent: build
+
+      Available agents:
+      - build (active) -- The default agent
+      - plan -- Plan mode. Disallows all edit tools.
+      - general -- General-purpose agent
+      - explore -- Codebase explorer
+
+      [build]  [plan]  [general]  [explore]
+
+You:  [tap "plan"]
+      (button message is deleted)
+Bot:  Agent: plan | Model: claude-opus-4 | Verbose: off     [pinned]
+```
+
+### Pinned Status Message
+
+A pinned message at the top of the chat shows the current agent, model, and verbose mode. It updates automatically when any of these change — via `/agent`, `/model`, or `/verbose`. The pinned message is the only confirmation; no separate reply is sent.
+
+Agent, model, and verbose selections are per-chat and persist across bot restarts.
+
 ## Usage
 
 Use `/usage` to see the current session's token counts and estimated cost:
@@ -250,6 +293,15 @@ Sessions survive bot restarts. The bot saves the chat-to-session mapping to `ses
 
 This means you can restart the bot (or even delete `sessions.json`) and it will reconnect to existing sessions automatically.
 
+## Resilience
+
+The bot is designed to survive restarts and failures:
+
+- **Drop pending updates** -- On startup, stale Telegram updates are discarded so old button clicks and messages from a previous run are not replayed.
+- **Pending question recovery** -- If the bot restarts while the agent is waiting for a question answer, the question is re-sent to Telegram on startup so the session can be unblocked.
+- **Global error handler** -- Unhandled errors in Telegram update handlers are logged instead of crashing the process.
+- **Handler timeout** -- Telegraf's handler timeout is set to 10 minutes (up from 90 seconds) to accommodate long-running LLM responses.
+
 ## Environment Variables
 
 | Variable | Required | Description |

package/dist/app.d.ts

@@ -1,25 +1,33 @@
 interface OpencodeClientLike {
     session: {
-        list: (options?: any) => Promise<any>;
-        create: (options: any) => Promise<any>;
-        update: (options: any) => Promise<any>;
-        delete: (options: any) => Promise<any>;
-        get: (options: any) => Promise<any>;
-        messages: (options: any) => Promise<any>;
-        command: (options: any) => Promise<any>;
-        promptAsync: (options: any) => Promise<any>;
+        list: (params?: any, options?: any) => Promise<any>;
+        create: (params: any, options?: any) => Promise<any>;
+        update: (params: any, options?: any) => Promise<any>;
+        delete: (params: any, options?: any) => Promise<any>;
+        get: (params: any, options?: any) => Promise<any>;
+        messages: (params: any, options?: any) => Promise<any>;
+        command: (params: any, options?: any) => Promise<any>;
+        promptAsync: (params: any, options?: any) => Promise<any>;
     };
     command: {
-        list: (options?: any) => Promise<any>;
+        list: (params?: any, options?: any) => Promise<any>;
     };
     provider: {
-        list: (options?: any) => Promise<any>;
+        list: (params?: any, options?: any) => Promise<any>;
     };
     path: {
-        get: (options?: any) => Promise<any>;
+        get: (params?: any, options?: any) => Promise<any>;
     };
     event: {
-        subscribe: (options?: any) => Promise<any>;
+        subscribe: (params?: any, options?: any) => Promise<any>;
+    };
+    question: {
+        list: (params?: any, options?: any) => Promise<any>;
+        reply: (params: any, options?: any) => Promise<any>;
+        reject: (params: any, options?: any) => Promise<any>;
+    };
+    app: {
+        agents: (params?: any, options?: any) => Promise<any>;
     };
 }
 interface StartOptions {
@@ -32,15 +40,18 @@ interface StartOptions {
 }
 interface TelegramBot {
     use: (fn: (ctx: any, next: () => Promise<void>) => Promise<void> | void) => void;
+    catch: (fn: (err: unknown, ctx: any) => void) => void;
     start: (fn: (ctx: any) => void | Promise<void>) => void;
     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>;
+    launch: (options?: {
+        dropPendingUpdates?: boolean;
+    }) => Promise<void>;
     stop: (reason?: string) => void;
     telegram: {
-        sendMessage: (chatId: number, text: string, options?: Record<string, unknown>) => Promise<void>;
+        sendMessage: (chatId: number, text: string, options?: Record<string, unknown>) => Promise<any>;
         deleteMessage: (chatId: number, messageId: number) => Promise<void>;
         sendDocument: (chatId: number, file: {
             source: Buffer;
@@ -53,6 +64,9 @@ interface TelegramBot {
             command: string;
             description: string;
         }>) => Promise<unknown>;
+        pinChatMessage: (chatId: number, messageId: number, extra?: Record<string, unknown>) => Promise<void>;
+        unpinChatMessage: (chatId: number, messageId?: number) => Promise<void>;
+        editMessageText: (chatId: number | undefined, messageId: number | undefined, inlineMessageId: string | undefined, text: string, extra?: Record<string, unknown>) => Promise<void>;
     };
 }
 export declare function startTelegram(options: StartOptions): Promise<TelegramBot>;