opencode-telegram-bot 1.0.9 → 1.0.10

package/README.md

@@ -115,7 +115,21 @@ 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`).
+### 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
 
@@ -250,6 +264,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,30 @@
 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>;
     };
 }
 interface StartOptions {
@@ -32,12 +37,15 @@ 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>;