@grinev/opencode-telegram-bot 0.14.0 → 0.15.0

package/.env.example

@@ -46,6 +46,14 @@ OPENCODE_MODEL_ID=big-pickle
 # Maximum number of scheduled tasks allowed at once (default: 10)
 # TASK_LIMIT=10
 
+# Stream update throttle in milliseconds for assistant/tool message edits (default: 500)
+# Higher value = fewer Telegram edit requests, lower value = more real-time updates
+# RESPONSE_STREAM_THROTTLE_MS=500
+
+# Maximum displayed length for bash tool commands in Telegram summaries (default: 128)
+# Longer commands are truncated with "..."
+# BASH_TOOL_DISPLAY_MAX_LENGTH=128
+
 # Bot locale: supported locale code (default: en)
 # Supported locales: en, de, es, fr, ru, zh
 # BOT_LOCALE=en
@@ -73,3 +81,11 @@ OPENCODE_MODEL_ID=big-pickle
 # STT_API_KEY=
 # STT_MODEL=
 # STT_LANGUAGE=
+
+# Text-to-Speech credentials (optional)
+# TTS reply behavior is controlled globally with /tts and persisted in settings.json.
+# Set both TTS_API_URL and TTS_API_KEY to enable audio replies.
+# TTS_API_URL=
+# TTS_API_KEY=
+# TTS_MODEL=gpt-4o-mini-tts
+# TTS_VOICE=alloy

package/README.md

@@ -31,7 +31,7 @@ Languages: English (`en`), Deutsch (`de`), Español (`es`), Français (`fr`), Р
 - **Subagent activity** — watch live subagent progress in chat, including the current task, agent, model, and active tool step
 - **Custom Commands** — run OpenCode custom commands (and built-ins like `init`/`review`) from an inline menu with confirmation
 - **Interactive Q&A** — answer agent questions and approve permissions via inline buttons
-- **Voice prompts** — send voice/audio messages, transcribe them via a Whisper-compatible API, then forward recognized text to OpenCode
+- **Voice prompts** — send voice/audio messages, transcribe them via a Whisper-compatible API, and optionally enable spoken replies with `/tts`
 - **File attachments** — send images, PDF documents, and any text-based files to OpenCode (code, logs, configs etc.)
 - **Scheduled tasks** — schedule prompts to run later or on a recurring interval; see [Scheduled Tasks](#scheduled-tasks)
 - **Context control** — compact context when it gets too large, right from the chat
@@ -109,6 +109,7 @@ opencode-telegram config
 | `/abort`          | Abort the current task                                  |
 | `/sessions`       | Browse and switch between recent sessions               |
 | `/projects`       | Switch between OpenCode projects                        |
+| `/tts`            | Toggle audio replies                                    |
 | `/rename`         | Rename the current session                              |
 | `/commands`       | Browse and run custom commands                          |
 | `/task`           | Create a scheduled task                                 |
@@ -147,30 +148,37 @@ When installed via npm, the configuration wizard handles the initial setup. The
 - **Windows:** `%APPDATA%\opencode-telegram-bot\.env`
 - **Linux:** `~/.config/opencode-telegram-bot/.env`
 
-| Variable                   | Description                                                                      | Required | Default                  |
-| -------------------------- | -------------------------------------------------------------------------------- | :------: | ------------------------ |
-| `TELEGRAM_BOT_TOKEN`       | Bot token from @BotFather                                                        |   Yes    | —                        |
-| `TELEGRAM_ALLOWED_USER_ID` | Your numeric Telegram user ID                                                    |   Yes    | —                        |
-| `TELEGRAM_PROXY_URL`       | Proxy URL for Telegram API (SOCKS5/HTTP)                                         |    No    | —                        |
-| `OPENCODE_API_URL`         | OpenCode server URL                                                              |    No    | `http://localhost:4096`  |
-| `OPENCODE_SERVER_USERNAME` | Server auth username                                                             |    No    | `opencode`               |
-| `OPENCODE_SERVER_PASSWORD` | Server auth password                                                             |    No    | —                        |
-| `OPENCODE_MODEL_PROVIDER`  | Default model provider                                                           |   Yes    | `opencode`               |
-| `OPENCODE_MODEL_ID`        | Default model ID                                                                 |   Yes    | `big-pickle`             |
-| `BOT_LOCALE`               | Bot UI language (supported locale code, e.g. `en`, `de`, `es`, `fr`, `ru`, `zh`) |    No    | `en`                     |
-| `SESSIONS_LIST_LIMIT`      | Sessions per page in `/sessions`                                                 |    No    | `10`                     |
-| `PROJECTS_LIST_LIMIT`      | Projects per page in `/projects`                                                 |    No    | `10`                     |
-| `COMMANDS_LIST_LIMIT`      | Commands per page in `/commands`                                                 |    No    | `10`                     |
-| `TASK_LIMIT`               | Maximum number of scheduled tasks that can exist at once                         |    No    | `10`                     |
-| `HIDE_THINKING_MESSAGES`   | Hide `💭 Thinking...` service messages                                           |    No    | `false`                  |
-| `HIDE_TOOL_CALL_MESSAGES`  | Hide tool-call service messages (`💻 bash ...`, `📖 read ...`, etc.)             |    No    | `false`                  |
-| `MESSAGE_FORMAT_MODE`      | Assistant reply formatting mode: `markdown` (Telegram MarkdownV2) or `raw`       |    No    | `markdown`               |
-| `CODE_FILE_MAX_SIZE_KB`    | Max file size (KB) to send as document                                           |    No    | `100`                    |
-| `STT_API_URL`              | Whisper-compatible API base URL (enables voice/audio transcription)              |    No    | —                        |
-| `STT_API_KEY`              | API key for your STT provider                                                    |    No    | —                        |
-| `STT_MODEL`                | STT model name passed to `/audio/transcriptions`                                 |    No    | `whisper-large-v3-turbo` |
-| `STT_LANGUAGE`             | Optional language hint (empty = provider auto-detect)                            |    No    | —                        |
-| `LOG_LEVEL`                | Log level (`debug`, `info`, `warn`, `error`)                                     |    No    | `info`                   |
+| Variable                        | Description                                                                                                  | Required | Default                  |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------ | :------: | ------------------------ |
+| `TELEGRAM_BOT_TOKEN`            | Bot token from @BotFather                                                                                    |   Yes    | —                        |
+| `TELEGRAM_ALLOWED_USER_ID`      | Your numeric Telegram user ID                                                                                |   Yes    | —                        |
+| `TELEGRAM_PROXY_URL`            | Proxy URL for Telegram API (SOCKS5/HTTP)                                                                     |    No    | —                        |
+| `OPENCODE_API_URL`              | OpenCode server URL                                                                                          |    No    | `http://localhost:4096`  |
+| `OPENCODE_SERVER_USERNAME`      | Server auth username                                                                                         |    No    | `opencode`               |
+| `OPENCODE_SERVER_PASSWORD`      | Server auth password                                                                                         |    No    | —                        |
+| `OPENCODE_MODEL_PROVIDER`       | Default model provider                                                                                       |   Yes    | `opencode`               |
+| `OPENCODE_MODEL_ID`             | Default model ID                                                                                             |   Yes    | `big-pickle`             |
+| `BOT_LOCALE`                    | Bot UI language (supported locale code, e.g. `en`, `de`, `es`, `fr`, `ru`, `zh`)                             |    No    | `en`                     |
+| `SESSIONS_LIST_LIMIT`           | Sessions per page in `/sessions`                                                                             |    No    | `10`                     |
+| `PROJECTS_LIST_LIMIT`           | Projects per page in `/projects`                                                                             |    No    | `10`                     |
+| `COMMANDS_LIST_LIMIT`           | Commands per page in `/commands`                                                                             |    No    | `10`                     |
+| `TASK_LIMIT`                    | Maximum number of scheduled tasks that can exist at once                                                     |    No    | `10`                     |
+| `BASH_TOOL_DISPLAY_MAX_LENGTH`  | Maximum displayed length for `bash` tool commands in Telegram summaries; longer commands are truncated       |    No    | `128`                    |
+| `SERVICE_MESSAGES_INTERVAL_SEC` | Service messages interval (thinking + tool calls); keep `>=2` to avoid Telegram rate limits, `0` = immediate |    No    | `5`                      |
+| `HIDE_THINKING_MESSAGES`        | Hide `💭 Thinking...` service messages                                                                       |    No    | `false`                  |
+| `HIDE_TOOL_CALL_MESSAGES`       | Hide tool-call service messages (`💻 bash ...`, `📖 read ...`, etc.)                                         |    No    | `false`                  |
+| `RESPONSE_STREAMING`            | Stream assistant replies while they are generated across one or more Telegram messages                       |    No    | `true`                   |
+| `MESSAGE_FORMAT_MODE`           | Assistant reply formatting mode: `markdown` (Telegram MarkdownV2) or `raw`                                   |    No    | `markdown`               |
+| `CODE_FILE_MAX_SIZE_KB`         | Max file size (KB) to send as document                                                                       |    No    | `100`                    |
+| `STT_API_URL`                   | Whisper-compatible API base URL (enables voice/audio transcription)                                          |    No    | —                        |
+| `STT_API_KEY`                   | API key for your STT provider                                                                                |    No    | —                        |
+| `STT_MODEL`                     | STT model name passed to `/audio/transcriptions`                                                             |    No    | `whisper-large-v3-turbo` |
+| `STT_LANGUAGE`                  | Optional language hint (empty = provider auto-detect)                                                        |    No    | —                        |
+| `TTS_API_URL`                   | TTS API base URL                                                                                             |    No    | —                        |
+| `TTS_API_KEY`                   | TTS API key                                                                                                  |    No    | —                        |
+| `TTS_MODEL`                     | TTS model name passed to `/audio/speech`                                                                     |    No    | `gpt-4o-mini-tts`        |
+| `TTS_VOICE`                     | OpenAI-compatible TTS voice name                                                                             |    No    | `alloy`                  |
+| `LOG_LEVEL`                     | Log level (`debug`, `info`, `warn`, `error`)                                                                 |    No    | `info`                   |
 
 > **Keep your `.env` file private.** It contains your bot token. Never commit it to version control.
 
@@ -183,6 +191,17 @@ If `STT_API_URL` and `STT_API_KEY` are set, the bot will:
 3. Show recognized text in chat
 4. Send the recognized text to OpenCode as a normal prompt
 
+If TTS credentials are configured, you can toggle spoken replies globally with `/tts`. The preference is stored in `settings.json` and persists across restarts.
+
+TTS configuration example:
+
+```env
+TTS_API_URL=https://api.openai.com/v1
+TTS_API_KEY=your-tts-api-key
+TTS_MODEL=gpt-4o-mini-tts
+TTS_VOICE=alloy
+```
+
 Supported provider examples (Whisper-compatible):
 
 - **OpenAI**

package/dist/agent/manager.js

@@ -29,6 +29,31 @@ export async function getAvailableAgents() {
     }
 }
 const DEFAULT_AGENT = "build";
+function pickFallbackAgent(agents) {
+    const defaultAgent = agents.find((agent) => agent.name === DEFAULT_AGENT);
+    if (defaultAgent) {
+        return defaultAgent.name;
+    }
+    return agents[0]?.name ?? DEFAULT_AGENT;
+}
+export async function resolveProjectAgent(preferredAgent) {
+    const requestedAgent = preferredAgent ?? getCurrentAgent() ?? DEFAULT_AGENT;
+    const project = getCurrentProject();
+    if (!project) {
+        return requestedAgent;
+    }
+    const agents = await getAvailableAgents();
+    if (agents.length === 0) {
+        return requestedAgent;
+    }
+    if (agents.some((agent) => agent.name === requestedAgent)) {
+        return requestedAgent;
+    }
+    const fallbackAgent = pickFallbackAgent(agents);
+    logger.warn(`[AgentManager] Agent "${requestedAgent}" is not available for project ${project.worktree}. Falling back to "${fallbackAgent}".`);
+    setCurrentAgent(fallbackAgent);
+    return fallbackAgent;
+}
 /**
  * Get current agent from last session message or settings.
  * Falls back to "build" if nothing is stored.
@@ -38,10 +63,13 @@ export async function fetchCurrentAgent() {
     const storedAgent = getCurrentAgent();
     const session = getCurrentSession();
     const project = getCurrentProject();
-    if (!session || !project) {
-        // No active session, return stored agent from settings
+    if (!project) {
+        // No active project, return stored agent from settings
         return storedAgent ?? DEFAULT_AGENT;
     }
+    if (!session) {
+        return resolveProjectAgent(storedAgent ?? DEFAULT_AGENT);
+    }
     try {
         const { data: messages, error } = await opencodeClient.session.messages({
             sessionID: session.id,
@@ -50,7 +78,7 @@ export async function fetchCurrentAgent() {
         });
         if (error || !messages || messages.length === 0) {
             logger.debug("[AgentManager] No messages found, using stored agent");
-            return storedAgent ?? DEFAULT_AGENT;
+            return resolveProjectAgent(storedAgent ?? DEFAULT_AGENT);
         }
         const lastAgent = messages[0].info.agent;
         logger.debug(`[AgentManager] Current agent from session: ${lastAgent}`);
@@ -58,17 +86,17 @@ export async function fetchCurrentAgent() {
         // Session messages may contain stale agent until next prompt is sent.
         if (storedAgent && lastAgent !== storedAgent) {
             logger.debug(`[AgentManager] Using stored agent "${storedAgent}" instead of session agent "${lastAgent}"`);
-            return storedAgent;
+            return resolveProjectAgent(storedAgent);
         }
         // No stored agent yet: sync from session history
         if (lastAgent && lastAgent !== storedAgent) {
             setCurrentAgent(lastAgent);
         }
-        return lastAgent || storedAgent || DEFAULT_AGENT;
+        return resolveProjectAgent(lastAgent || storedAgent || DEFAULT_AGENT);
     }
     catch (err) {
         logger.error("[AgentManager] Error fetching current agent:", err);
-        return storedAgent ?? DEFAULT_AGENT;
+        return resolveProjectAgent(storedAgent ?? DEFAULT_AGENT);
     }
 }
 /**

package/dist/agent/types.js

@@ -22,5 +22,11 @@ export function getAgentEmoji(agentName) {
 export function getAgentDisplayName(agentName) {
     const emoji = getAgentEmoji(agentName);
     const capitalizedName = agentName.charAt(0).toUpperCase() + agentName.slice(1);
-    return `${emoji} ${capitalizedName} Mode`;
+    return `${emoji} ${capitalizedName}`;
+}
+/**
+ * Get reply keyboard label for agent button.
+ */
+export function getAgentButtonLabel(agentName) {
+    return `${getAgentDisplayName(agentName)} Agent`;
 }

package/dist/bot/commands/commands.js

@@ -5,7 +5,7 @@ import { clearSession, getCurrentSession, setCurrentSession, } from "../../sessi
 import { ingestSessionInfoForCache } from "../../session/cache-manager.js";
 import { interactionManager } from "../../interaction/manager.js";
 import { summaryAggregator } from "../../summary/aggregator.js";
-import { getStoredAgent } from "../../agent/manager.js";
+import { getStoredAgent, resolveProjectAgent } from "../../agent/manager.js";
 import { getStoredModel } from "../../model/manager.js";
 import { safeBackgroundTask } from "../../utils/safe-background-task.js";
 import { logger } from "../../utils/logger.js";
@@ -279,7 +279,7 @@ async function executeCommand(ctx, deps, params) {
         await ctx.reply(t("bot.session_busy"));
         return;
     }
-    const currentAgent = getStoredAgent();
+    const currentAgent = await resolveProjectAgent(getStoredAgent());
     const storedModel = getStoredModel();
     const model = storedModel.providerID && storedModel.modelID
         ? `${storedModel.providerID}/${storedModel.modelID}`

package/dist/bot/commands/definitions.js

@@ -8,6 +8,7 @@ const COMMAND_DEFINITIONS = [
     { command: "new", descriptionKey: "cmd.description.new" },
     { command: "abort", descriptionKey: "cmd.description.stop" },
     { command: "sessions", descriptionKey: "cmd.description.sessions" },
+    { command: "tts", descriptionKey: "cmd.description.tts" },
     { command: "projects", descriptionKey: "cmd.description.projects" },
     { command: "task", descriptionKey: "cmd.description.task" },
     { command: "tasklist", descriptionKey: "cmd.description.tasklist" },

package/dist/bot/commands/new.js

@@ -6,7 +6,7 @@ import { clearAllInteractionState } from "../../interaction/cleanup.js";
 import { summaryAggregator } from "../../summary/aggregator.js";
 import { pinnedMessageManager } from "../../pinned/manager.js";
 import { keyboardManager } from "../../keyboard/manager.js";
-import { getStoredAgent } from "../../agent/manager.js";
+import { getStoredAgent, resolveProjectAgent } from "../../agent/manager.js";
 import { getStoredModel } from "../../model/manager.js";
 import { formatVariantForButton } from "../../variant/manager.js";
 import { createMainKeyboard } from "../utils/keyboard.js";
@@ -54,10 +54,11 @@ export async function newCommand(ctx) {
             logger.error("[Bot] Error creating pinned message:", err);
         }
         // Get current state for keyboard
-        const currentAgent = getStoredAgent();
+        const currentAgent = await resolveProjectAgent(getStoredAgent());
         const currentModel = getStoredModel();
         const contextInfo = pinnedMessageManager.getContextInfo();
         const variantName = formatVariantForButton(currentModel.variant || "default");
+        keyboardManager.updateAgent(currentAgent);
         const keyboard = createMainKeyboard(currentAgent, currentModel, contextInfo ?? undefined, variantName);
         await ctx.reply(t("new.created", { title: session.title }), {
             reply_markup: keyboard,

package/dist/bot/commands/projects.js

@@ -6,7 +6,7 @@ import { clearSession } from "../../session/manager.js";
 import { summaryAggregator } from "../../summary/aggregator.js";
 import { pinnedMessageManager } from "../../pinned/manager.js";
 import { keyboardManager } from "../../keyboard/manager.js";
-import { getStoredAgent } from "../../agent/manager.js";
+import { getStoredAgent, resolveProjectAgent } from "../../agent/manager.js";
 import { getStoredModel } from "../../model/manager.js";
 import { formatVariantForButton } from "../../variant/manager.js";
 import { clearAllInteractionState } from "../../interaction/cleanup.js";
@@ -201,10 +201,11 @@ export async function handleProjectSelect(ctx) {
         // Reset context to 0 (no session selected) with current model's limit
         keyboardManager.updateContext(0, contextLimit);
         // Get current state for keyboard (with context = 0)
-        const currentAgent = getStoredAgent();
+        const currentAgent = await resolveProjectAgent(getStoredAgent());
         const currentModel = getStoredModel();
         const contextInfo = { tokensUsed: 0, tokensLimit: contextLimit };
         const variantName = formatVariantForButton(currentModel.variant || "default");
+        keyboardManager.updateAgent(currentAgent);
         const keyboard = createMainKeyboard(currentAgent, currentModel, contextInfo, variantName);
         const projectName = selectedProject.name || selectedProject.worktree;
         await ctx.answerCallbackQuery();

package/dist/bot/commands/sessions.js

@@ -1,5 +1,6 @@
 import { InlineKeyboard } from "grammy";
 import { opencodeClient } from "../../opencode/client.js";
+import { resolveProjectAgent } from "../../agent/manager.js";
 import { setCurrentSession } from "../../session/manager.js";
 import { getCurrentProject } from "../../settings/manager.js";
 import { clearAllInteractionState } from "../../interaction/cleanup.js";
@@ -214,6 +215,8 @@ export async function handleSessionSelect(ctx) {
         }
         if (ctx.chat) {
             const chatId = ctx.chat.id;
+            const currentAgent = await resolveProjectAgent();
+            keyboardManager.updateAgent(currentAgent);
             // Update keyboard with loaded context (callback executes async via setImmediate, so update manually)
             const contextInfo = pinnedMessageManager.getContextInfo();
             if (contextInfo) {

package/dist/bot/commands/status.js

@@ -1,6 +1,6 @@
 import { opencodeClient } from "../../opencode/client.js";
 import { getCurrentSession } from "../../session/manager.js";
-import { getCurrentProject } from "../../settings/manager.js";
+import { getCurrentProject, isTtsEnabled } from "../../settings/manager.js";
 import { fetchCurrentAgent } from "../../agent/manager.js";
 import { getAgentDisplayName } from "../../agent/types.js";
 import { fetchCurrentModel } from "../../model/manager.js";
@@ -22,6 +22,9 @@ export async function statusCommand(ctx) {
         if (data.version) {
             message += `${t("status.line.version", { version: data.version })}\n`;
         }
+        message += `${t("status.line.tts", {
+            tts: isTtsEnabled() ? t("status.tts.on") : t("status.tts.off"),
+        })}\n`;
         // Add process management information
         if (processManager.isRunning()) {
             const uptime = processManager.getUptime();
@@ -33,7 +36,7 @@ export async function statusCommand(ctx) {
         else {
             message += `${t("status.line.managed_no")}\n`;
         }
-        // Add agent mode information
+        // Add agent information
         const currentAgent = await fetchCurrentAgent();
         const agentDisplay = currentAgent
             ? getAgentDisplayName(currentAgent)

package/dist/bot/commands/tts.js

@@ -0,0 +1,13 @@
+import { isTtsConfigured } from "../../tts/client.js";
+import { isTtsEnabled, setTtsEnabled } from "../../settings/manager.js";
+import { t } from "../../i18n/index.js";
+export async function ttsCommand(ctx) {
+    const enabled = !isTtsEnabled();
+    if (enabled && !isTtsConfigured()) {
+        await ctx.reply(t("tts.not_configured"));
+        return;
+    }
+    setTtsEnabled(enabled);
+    const message = enabled ? t("tts.enabled") : t("tts.disabled");
+    await ctx.reply(message);
+}

package/dist/bot/handlers/agent.js

@@ -1,6 +1,6 @@
 import { InlineKeyboard } from "grammy";
 import { selectAgent, getAvailableAgents, fetchCurrentAgent } from "../../agent/manager.js";
-import { getAgentDisplayName, getAgentEmoji } from "../../agent/types.js";
+import { getAgentDisplayName } from "../../agent/types.js";
 import { getStoredModel } from "../../model/manager.js";
 import { formatVariantForButton } from "../../variant/manager.js";
 import { logger } from "../../utils/logger.js";
@@ -81,11 +81,10 @@ export async function buildAgentSelectionMenu(currentAgent) {
     }
     // Add button for each agent
     agents.forEach((agent) => {
-        const emoji = getAgentEmoji(agent.name);
         const isActive = agent.name === currentAgent;
         const label = isActive
-            ? `✅ ${emoji} ${agent.name.toUpperCase()}`
-            : `${emoji} ${agent.name.charAt(0).toUpperCase() + agent.name.slice(1)}`;
+            ? `✅ ${getAgentDisplayName(agent.name)}`
+            : getAgentDisplayName(agent.name);
         keyboard.text(label, `agent:${agent.name}`).row();
     });
     return keyboard;

package/dist/bot/handlers/model.js

@@ -4,7 +4,7 @@ import { formatModelForDisplay } from "../../model/types.js";
 import { formatVariantForButton } from "../../variant/manager.js";
 import { logger } from "../../utils/logger.js";
 import { createMainKeyboard } from "../utils/keyboard.js";
-import { getStoredAgent } from "../../agent/manager.js";
+import { getStoredAgent, resolveProjectAgent } from "../../agent/manager.js";
 import { pinnedMessageManager } from "../../pinned/manager.js";
 import { keyboardManager } from "../../keyboard/manager.js";
 import { clearActiveInlineMenu, ensureActiveInlineMenu, replyWithInlineMenu, } from "./inline-menu.js";
@@ -61,11 +61,12 @@ export async function handleModelSelect(ctx) {
         // Refresh context limit for new model
         await pinnedMessageManager.refreshContextLimit();
         // Update Reply Keyboard with new model and context
-        const currentAgent = getStoredAgent();
+        const currentAgent = await resolveProjectAgent(getStoredAgent());
         const contextInfo = pinnedMessageManager.getContextInfo() ??
             (pinnedMessageManager.getContextLimit() > 0
                 ? { tokensUsed: 0, tokensLimit: pinnedMessageManager.getContextLimit() }
                 : null);
+        keyboardManager.updateAgent(currentAgent);
         if (contextInfo) {
             keyboardManager.updateContext(contextInfo.tokensUsed, contextInfo.tokensLimit);
         }

package/dist/bot/handlers/prompt.js

@@ -1,8 +1,8 @@
 import { opencodeClient } from "../../opencode/client.js";
 import { clearSession, getCurrentSession, setCurrentSession } from "../../session/manager.js";
 import { ingestSessionInfoForCache } from "../../session/cache-manager.js";
-import { getCurrentProject } from "../../settings/manager.js";
-import { getStoredAgent } from "../../agent/manager.js";
+import { getCurrentProject, isTtsEnabled } from "../../settings/manager.js";
+import { getStoredAgent, resolveProjectAgent } from "../../agent/manager.js";
 import { getStoredModel } from "../../model/manager.js";
 import { formatVariantForButton } from "../../variant/manager.js";
 import { createMainKeyboard } from "../utils/keyboard.js";
@@ -20,12 +20,24 @@ import { foregroundSessionState } from "../../scheduled-task/foreground-state.js
 /** Module-level references for async callbacks that don't have ctx. */
 let botInstance = null;
 let chatIdInstance = null;
+const promptResponseModes = new Map();
 export function getPromptBotInstance() {
     return botInstance;
 }
 export function getPromptChatId() {
     return chatIdInstance;
 }
+export function setPromptResponseMode(sessionId, responseMode) {
+    promptResponseModes.set(sessionId, responseMode);
+}
+export function clearPromptResponseMode(sessionId) {
+    promptResponseModes.delete(sessionId);
+}
+export function consumePromptResponseMode(sessionId) {
+    const responseMode = promptResponseModes.get(sessionId) ?? null;
+    promptResponseModes.delete(sessionId);
+    return responseMode;
+}
 async function isSessionBusy(sessionId, directory) {
     try {
         const { data, error } = await opencodeClient.session.status({ directory });
@@ -72,8 +84,9 @@ async function resetMismatchedSessionContext() {
  * @param fileParts - Optional file parts (for photo/document attachments)
  * @returns true if the prompt was dispatched, false if it was blocked/failed early.
  */
-export async function processUserPrompt(ctx, text, deps, fileParts = []) {
+export async function processUserPrompt(ctx, text, deps, fileParts = [], options = {}) {
     const { bot, ensureEventSubscription } = deps;
+    const responseMode = options.responseMode ?? (isTtsEnabled() ? "text_and_tts" : "text_only");
     const currentProject = getCurrentProject();
     if (!currentProject) {
         await ctx.reply(t("bot.project_not_selected"));
@@ -118,10 +131,11 @@ export async function processUserPrompt(ctx, text, deps, fileParts = []) {
         catch (err) {
             logger.error("[Bot] Error creating pinned message for new session:", err);
         }
-        const currentAgent = getStoredAgent();
+        const currentAgent = await resolveProjectAgent(getStoredAgent());
         const currentModel = getStoredModel();
         const contextInfo = pinnedMessageManager.getContextInfo();
         const variantName = formatVariantForButton(currentModel.variant || "default");
+        keyboardManager.updateAgent(currentAgent);
         const keyboard = createMainKeyboard(currentAgent, currentModel, contextInfo ?? undefined, variantName);
         await ctx.reply(t("bot.session_created", { title: session.title }), {
             reply_markup: keyboard,
@@ -149,7 +163,7 @@ export async function processUserPrompt(ctx, text, deps, fileParts = []) {
         return false;
     }
     try {
-        const currentAgent = getStoredAgent();
+        const currentAgent = await resolveProjectAgent(getStoredAgent());
         const storedModel = getStoredModel();
         // Build parts array with text and files
         const parts = [];
@@ -195,6 +209,7 @@ export async function processUserPrompt(ctx, text, deps, fileParts = []) {
         };
         logger.info(`[Bot] Calling session.prompt (fire-and-forget) with agent=${currentAgent}, fileCount=${fileParts.length}...`);
         foregroundSessionState.markBusy(currentSession.id);
+        setPromptResponseMode(currentSession.id, responseMode);
         // CRITICAL: DO NOT wait for session.prompt to complete.
         // If we wait, the handler will not finish and grammY will not call getUpdates,
         // which blocks receiving button callback_query updates.
@@ -205,6 +220,7 @@ export async function processUserPrompt(ctx, text, deps, fileParts = []) {
             onSuccess: ({ error }) => {
                 if (error) {
                     foregroundSessionState.markIdle(currentSession.id);
+                    clearPromptResponseMode(currentSession.id);
                     const details = formatErrorDetails(error, 6000);
                     logger.error("[Bot] OpenCode API returned an error for session.prompt", promptErrorLogContext);
                     logger.error("[Bot] session.prompt error details:", details);
@@ -217,6 +233,7 @@ export async function processUserPrompt(ctx, text, deps, fileParts = []) {
             },
             onError: (error) => {
                 foregroundSessionState.markIdle(currentSession.id);
+                clearPromptResponseMode(currentSession.id);
                 const details = formatErrorDetails(error, 6000);
                 logger.error("[Bot] session.prompt background task failed", promptErrorLogContext);
                 logger.error("[Bot] session.prompt background failure details:", details);

package/dist/bot/handlers/variant.js

@@ -1,7 +1,7 @@
 import { InlineKeyboard } from "grammy";
 import { getAvailableVariants, getCurrentVariant, setCurrentVariant, formatVariantForDisplay, formatVariantForButton, } from "../../variant/manager.js";
 import { getStoredModel } from "../../model/manager.js";
-import { getStoredAgent } from "../../agent/manager.js";
+import { getStoredAgent, resolveProjectAgent } from "../../agent/manager.js";
 import { logger } from "../../utils/logger.js";
 import { keyboardManager } from "../../keyboard/manager.js";
 import { pinnedMessageManager } from "../../pinned/manager.js";
@@ -47,11 +47,12 @@ export async function handleVariantSelect(ctx) {
         keyboardManager.updateModel(updatedModel);
         keyboardManager.updateVariant(variantId);
         // Build keyboard with correct context info
-        const currentAgent = getStoredAgent();
+        const currentAgent = await resolveProjectAgent(getStoredAgent());
         const contextInfo = pinnedMessageManager.getContextInfo() ??
             (pinnedMessageManager.getContextLimit() > 0
                 ? { tokensUsed: 0, tokensLimit: pinnedMessageManager.getContextLimit() }
                 : null);
+        keyboardManager.updateAgent(currentAgent);
         if (contextInfo) {
             keyboardManager.updateContext(contextInfo.tokensUsed, contextInfo.tokensLimit);
         }