@grinev/opencode-telegram-bot 0.10.0 → 0.11.0

package/dist/bot/commands/status.js

@@ -6,6 +6,8 @@ import { getAgentDisplayName } from "../../agent/types.js";
 import { fetchCurrentModel } from "../../model/manager.js";
 import { formatModelForDisplay } from "../../model/types.js";
 import { processManager } from "../../process/manager.js";
+import { keyboardManager } from "../../keyboard/manager.js";
+import { pinnedMessageManager } from "../../pinned/manager.js";
 import { logger } from "../../utils/logger.js";
 import { t } from "../../i18n/index.js";
 import { sendMessageWithMarkdownFallback } from "../utils/send-with-markdown-fallback.js";
@@ -59,16 +61,33 @@ export async function statusCommand(ctx) {
             message += `\n${t("status.session_not_selected")}\n`;
             message += t("status.session_hint");
         }
+        if (ctx.chat) {
+            if (!pinnedMessageManager.isInitialized()) {
+                pinnedMessageManager.initialize(ctx.api, ctx.chat.id);
+            }
+            // Fetch context limit if not yet loaded (e.g. fresh bot start)
+            if (pinnedMessageManager.getContextLimit() === 0) {
+                await pinnedMessageManager.refreshContextLimit();
+            }
+            keyboardManager.initialize(ctx.api, ctx.chat.id);
+        }
+        // Sync current context (tokens used + limit) into keyboard state
+        const contextInfo = pinnedMessageManager.getContextInfo();
+        if (contextInfo) {
+            keyboardManager.updateContext(contextInfo.tokensUsed, contextInfo.tokensLimit);
+        }
+        const keyboard = keyboardManager.getKeyboard();
         if (ctx.chat) {
             await sendMessageWithMarkdownFallback({
                 api: ctx.api,
                 chatId: ctx.chat.id,
                 text: message,
+                options: { reply_markup: keyboard },
                 parseMode: "Markdown",
             });
         }
         else {
-            await ctx.reply(message);
+            await ctx.reply(message, { reply_markup: keyboard });
         }
     }
     catch (error) {

package/dist/bot/handlers/agent.js

@@ -95,14 +95,24 @@ export async function buildAgentSelectionMenu(currentAgent) {
  * @param ctx grammY context
  */
 export async function showAgentSelectionMenu(ctx) {
-    const currentAgent = await fetchCurrentAgent();
-    const keyboard = await buildAgentSelectionMenu(currentAgent);
-    const text = currentAgent
-        ? t("agent.menu.current", { name: getAgentDisplayName(currentAgent) })
-        : t("agent.menu.select");
-    await replyWithInlineMenu(ctx, {
-        menuKind: "agent",
-        text,
-        keyboard,
-    });
+    try {
+        const currentAgent = await fetchCurrentAgent();
+        const keyboard = await buildAgentSelectionMenu(currentAgent);
+        if (keyboard.inline_keyboard.length === 0) {
+            await ctx.reply(t("agent.menu.empty"));
+            return;
+        }
+        const text = currentAgent
+            ? t("agent.menu.current", { name: getAgentDisplayName(currentAgent) })
+            : t("agent.menu.select");
+        await replyWithInlineMenu(ctx, {
+            menuKind: "agent",
+            text,
+            keyboard,
+        });
+    }
+    catch (err) {
+        logger.error("[AgentHandler] Error showing agent menu:", err);
+        await ctx.reply(t("agent.menu.error"));
+    }
 }

package/dist/bot/handlers/document.js

@@ -0,0 +1,65 @@
+import { config } from "../../config.js";
+import { processUserPrompt } from "./prompt.js";
+import { downloadTelegramFile, toDataUri, isTextMimeType, isFileSizeAllowed, } from "../utils/file-download.js";
+import { getModelCapabilities, supportsInput } from "../../model/capabilities.js";
+import { getStoredModel } from "../../model/manager.js";
+import { logger } from "../../utils/logger.js";
+import { t } from "../../i18n/index.js";
+export async function handleDocumentMessage(ctx, deps) {
+    const downloadFile = deps.downloadFile ?? downloadTelegramFile;
+    const getCapabilities = deps.getModelCapabilities ?? getModelCapabilities;
+    const getStored = deps.getStoredModel ?? getStoredModel;
+    const processPrompt = deps.processPrompt ?? processUserPrompt;
+    const doc = ctx.message?.document;
+    if (!doc) {
+        return;
+    }
+    const caption = ctx.message.caption || "";
+    const mimeType = doc.mime_type || "";
+    const filename = doc.file_name || "document";
+    try {
+        if (isTextMimeType(mimeType)) {
+            if (!isFileSizeAllowed(doc.file_size, config.files.maxFileSizeKb)) {
+                logger.warn(`[Document] Text file too large: ${filename} (${doc.file_size} bytes > ${config.files.maxFileSizeKb}KB)`);
+                await ctx.reply(t("bot.text_file_too_large", { maxSizeKb: String(config.files.maxFileSizeKb) }));
+                return;
+            }
+            await ctx.reply(t("bot.file_downloading"));
+            const downloadedFile = await downloadFile(ctx.api, doc.file_id);
+            const textContent = downloadedFile.buffer.toString("utf-8");
+            const promptWithFile = `--- Content of ${filename} ---\n${textContent}\n--- End of file ---\n\n${caption}`;
+            logger.info(`[Document] Sending text file (${downloadedFile.buffer.length} bytes, ${filename}) as prompt`);
+            await processPrompt(ctx, promptWithFile, deps);
+            return;
+        }
+        if (mimeType === "application/pdf") {
+            const storedModel = getStored();
+            const capabilities = await getCapabilities(storedModel.providerID, storedModel.modelID);
+            if (!supportsInput(capabilities, "pdf")) {
+                logger.warn(`[Document] Model ${storedModel.providerID}/${storedModel.modelID} doesn't support PDF input`);
+                await ctx.reply(t("bot.model_no_pdf"));
+                if (caption.trim().length > 0) {
+                    await processPrompt(ctx, caption, deps);
+                }
+                return;
+            }
+            await ctx.reply(t("bot.file_downloading"));
+            const downloadedFile = await downloadFile(ctx.api, doc.file_id);
+            const dataUri = toDataUri(downloadedFile.buffer, mimeType);
+            const filePart = {
+                type: "file",
+                mime: mimeType,
+                filename: filename,
+                url: dataUri,
+            };
+            logger.info(`[Document] Sending PDF (${downloadedFile.buffer.length} bytes, ${filename}) with prompt`);
+            await processPrompt(ctx, caption, deps, [filePart]);
+            return;
+        }
+        logger.debug(`[Document] Unsupported document MIME type: ${mimeType}, ignoring`);
+    }
+    catch (err) {
+        logger.error("[Document] Error handling document message:", err);
+        await ctx.reply(t("bot.file_download_error"));
+    }
+}

package/dist/bot/index.js

@@ -12,7 +12,7 @@ import { BOT_COMMANDS } from "./commands/definitions.js";
 import { startCommand } from "./commands/start.js";
 import { helpCommand } from "./commands/help.js";
 import { statusCommand } from "./commands/status.js";
-import { MODEL_BUTTON_TEXT_PATTERN, VARIANT_BUTTON_TEXT_PATTERN } from "./message-patterns.js";
+import { AGENT_MODE_BUTTON_TEXT_PATTERN, MODEL_BUTTON_TEXT_PATTERN, VARIANT_BUTTON_TEXT_PATTERN, } from "./message-patterns.js";
 import { sessionsCommand, handleSessionSelect } from "./commands/sessions.js";
 import { newCommand } from "./commands/new.js";
 import { projectsCommand, handleProjectSelect } from "./commands/projects.js";
@@ -20,6 +20,7 @@ import { stopCommand } from "./commands/stop.js";
 import { opencodeStartCommand } from "./commands/opencode-start.js";
 import { opencodeStopCommand } from "./commands/opencode-stop.js";
 import { renameCommand, handleRenameCancel, handleRenameTextAnswer } from "./commands/rename.js";
+import { commandsCommand, handleCommandsCallback, handleCommandTextArguments, } from "./commands/commands.js";
 import { handleQuestionCallback, showCurrentQuestion, handleQuestionTextAnswer, } from "./handlers/question.js";
 import { handlePermissionCallback, showPermissionRequest } from "./handlers/permission.js";
 import { handleAgentSelect, showAgentSelectionMenu } from "./handlers/agent.js";
@@ -43,6 +44,7 @@ import { pinnedMessageManager } from "../pinned/manager.js";
 import { t } from "../i18n/index.js";
 import { processUserPrompt } from "./handlers/prompt.js";
 import { handleVoiceMessage } from "./handlers/voice.js";
+import { handleDocumentMessage } from "./handlers/document.js";
 import { downloadTelegramFile, toDataUri } from "./utils/file-download.js";
 import { sendMessageWithMarkdownFallback } from "./utils/send-with-markdown-fallback.js";
 import { getModelCapabilities, supportsInput } from "../model/capabilities.js";
@@ -456,10 +458,15 @@ export function createBot() {
     bot.command("new", newCommand);
     bot.command("stop", stopCommand);
     bot.command("rename", renameCommand);
+    bot.command("commands", commandsCommand);
     bot.on("message:text", unknownCommandMiddleware);
     bot.on("callback_query:data", async (ctx) => {
         logger.debug(`[Bot] Received callback_query:data: ${ctx.callbackQuery?.data}`);
         logger.debug(`[Bot] Callback context: from=${ctx.from?.id}, chat=${ctx.chat?.id}`);
+        if (ctx.chat) {
+            botInstance = bot;
+            chatIdInstance = ctx.chat.id;
+        }
         try {
             const handledInlineCancel = await handleInlineMenuCancel(ctx);
             const handledSession = await handleSessionSelect(ctx);
@@ -471,7 +478,8 @@ export function createBot() {
             const handledVariant = await handleVariantSelect(ctx);
             const handledCompactConfirm = await handleCompactConfirm(ctx);
             const handledRenameCancel = await handleRenameCancel(ctx);
-            logger.debug(`[Bot] Callback handled: inlineCancel=${handledInlineCancel}, session=${handledSession}, project=${handledProject}, question=${handledQuestion}, permission=${handledPermission}, agent=${handledAgent}, model=${handledModel}, variant=${handledVariant}, compactConfirm=${handledCompactConfirm}, rename=${handledRenameCancel}`);
+            const handledCommands = await handleCommandsCallback(ctx, { bot, ensureEventSubscription });
+            logger.debug(`[Bot] Callback handled: inlineCancel=${handledInlineCancel}, session=${handledSession}, project=${handledProject}, question=${handledQuestion}, permission=${handledPermission}, agent=${handledAgent}, model=${handledModel}, variant=${handledVariant}, compactConfirm=${handledCompactConfirm}, rename=${handledRenameCancel}, commands=${handledCommands}`);
             if (!handledInlineCancel &&
                 !handledSession &&
                 !handledProject &&
@@ -481,7 +489,8 @@ export function createBot() {
                 !handledModel &&
                 !handledVariant &&
                 !handledCompactConfirm &&
-                !handledRenameCancel) {
+                !handledRenameCancel &&
+                !handledCommands) {
                 logger.debug("Unknown callback query:", ctx.callbackQuery?.data);
                 await ctx.answerCallbackQuery({ text: t("callback.unknown_command") });
             }
@@ -493,7 +502,7 @@ export function createBot() {
         }
     });
     // Handle Reply Keyboard button press (agent mode indicator)
-    bot.hears(/^(📋|🛠️|💬|🔍|📝|📄|📦|🤖) \w+ Mode$/, async (ctx) => {
+    bot.hears(AGENT_MODE_BUTTON_TEXT_PATTERN, async (ctx) => {
         logger.debug(`[Bot] Agent mode button pressed: ${ctx.message?.text}`);
         try {
             if (await blockMenuWhileInteractionActive(ctx)) {
@@ -645,11 +654,21 @@ export function createBot() {
             await ctx.reply(t("bot.photo_download_error"));
         }
     });
+    // Document message handler (PDF and text files)
+    bot.on("message:document", async (ctx) => {
+        logger.debug(`[Bot] Received document message, chatId=${ctx.chat.id}`);
+        botInstance = bot;
+        chatIdInstance = ctx.chat.id;
+        const deps = { bot, ensureEventSubscription };
+        await handleDocumentMessage(ctx, deps);
+    });
     bot.on("message:text", async (ctx) => {
         const text = ctx.message?.text;
         if (!text) {
             return;
         }
+        botInstance = bot;
+        chatIdInstance = ctx.chat.id;
         if (text.startsWith("/")) {
             return;
         }
@@ -661,9 +680,11 @@ export function createBot() {
         if (handledRename) {
             return;
         }
-        botInstance = bot;
-        chatIdInstance = ctx.chat.id;
         const promptDeps = { bot, ensureEventSubscription };
+        const handledCommandArgs = await handleCommandTextArguments(ctx, promptDeps);
+        if (handledCommandArgs) {
+            return;
+        }
         await processUserPrompt(ctx, text, promptDeps);
         logger.debug("[Bot] message:text handler completed (prompt sent in background)");
     });

package/dist/bot/message-patterns.js

@@ -1,3 +1,4 @@
-export const MODEL_BUTTON_TEXT_PATTERN = /^🤖\s.+$/;
+export const AGENT_MODE_BUTTON_TEXT_PATTERN = /^(📋|🛠️|💬|🔍|📝|📄|📦|🤖)\s.+\sMode$/;
+export const MODEL_BUTTON_TEXT_PATTERN = /^🤖\s(?!.*\sMode$)[\s\S]+$/;
 // Keep support for both legacy "💭" and current "💡" prefix.
 export const VARIANT_BUTTON_TEXT_PATTERN = /^(💡|💭)\s.+$/;

package/dist/bot/utils/file-download.js

@@ -73,3 +73,19 @@ export function formatFileSize(bytes) {
     }
     return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
 }
+const APPLICATION_TEXT_MIME_TYPES = new Set([
+    "application/json",
+    "application/xml",
+    "application/javascript",
+    "application/x-yaml",
+    "application/sql",
+]);
+export function isTextMimeType(mimeType) {
+    if (!mimeType) {
+        return false;
+    }
+    if (mimeType.startsWith("text/")) {
+        return true;
+    }
+    return APPLICATION_TEXT_MIME_TYPES.has(mimeType);
+}

package/dist/i18n/de.js

@@ -4,6 +4,7 @@ export const de = {
     "cmd.description.stop": "Aktuelle Aktion stoppen",
     "cmd.description.sessions": "Sitzungen auflisten",
     "cmd.description.projects": "Projekte auflisten",
+    "cmd.description.commands": "Benutzerdefinierte Befehle",
     "cmd.description.opencode_start": "OpenCode-Server starten",
     "cmd.description.opencode_stop": "OpenCode-Server stoppen",
     "cmd.description.help": "Hilfe",
@@ -48,6 +49,11 @@ export const de = {
     "bot.photo_model_no_image": "⚠️ Das aktuelle Modell unterstützt keine Bildeingabe. Sende nur Text.",
     "bot.photo_download_error": "🔴 Foto konnte nicht heruntergeladen werden",
     "bot.photo_no_caption": "💡 Tipp: Füge eine Bildunterschrift hinzu, um zu beschreiben, was du mit diesem Foto tun möchtest.",
+    "bot.file_downloading": "⏳ Lade Datei herunter...",
+    "bot.file_too_large": "⚠️ Datei ist zu groß (max. {maxSizeMb}MB)",
+    "bot.file_download_error": "🔴 Datei konnte nicht heruntergeladen werden",
+    "bot.model_no_pdf": "⚠️ Das aktuelle Modell unterstützt keine PDF-Eingabe. Sende nur Text.",
+    "bot.text_file_too_large": "⚠️ Textdatei ist zu groß (max. {maxSizeKb}KB)",
     "status.header_running": "🟢 **OpenCode-Server läuft**",
     "status.health.healthy": "OK",
     "status.health.unhealthy": "Nicht OK",
@@ -70,7 +76,11 @@ export const de = {
     "projects.empty": "📭 Keine Projekte gefunden.\n\nÖffne ein Verzeichnis in OpenCode und erstelle mindestens eine Sitzung, dann erscheint es hier.",
     "projects.select": "Projekt auswählen:",
     "projects.select_with_current": "Projekt auswählen:\n\nAktuell: 🏗 {project}",
+    "projects.page_indicator": "Seite {current}/{total}",
+    "projects.prev_page": "⬅️ Zurück",
+    "projects.next_page": "Weiter ➡️",
     "projects.fetch_error": "🔴 OpenCode-Server ist nicht verfügbar oder beim Laden der Projekte ist ein Fehler aufgetreten.",
+    "projects.page_load_error": "Diese Seite konnte nicht geladen werden. Bitte versuche es erneut.",
     "projects.selected": "✅ Projekt ausgewählt: {project}\n\n📋 Sitzung wurde zurückgesetzt. Nutze /sessions oder /new für dieses Projekt.",
     "projects.select_error": "🔴 Projekt konnte nicht ausgewählt werden.",
     "sessions.project_not_selected": "🏗 Projekt ist nicht ausgewählt.\n\nWähle zuerst ein Projekt mit /projects.",
@@ -120,6 +130,8 @@ export const de = {
     "agent.change_error_callback": "Modus konnte nicht geändert werden",
     "agent.menu.current": "Aktueller Modus: {name}\n\nModus auswählen:",
     "agent.menu.select": "Arbeitsmodus auswählen:",
+    "agent.menu.empty": "⚠️ Keine verfügbaren Agenten",
+    "agent.menu.error": "🔴 Agentenliste konnte nicht geladen werden",
     "model.changed_callback": "Modell geändert: {name}",
     "model.changed_message": "✅ Modell geändert zu: {name}",
     "model.change_error_callback": "Modell konnte nicht geändert werden",
@@ -232,6 +244,19 @@ export const de = {
     "rename.blocked.expected_name": "⚠️ Sende den neuen Sitzungsnamen als Text oder tippe in der Umbenennen-Nachricht auf Abbrechen.",
     "rename.blocked.command_not_allowed": "⚠️ Dieser Befehl ist nicht verfügbar, solange beim Umbenennen auf einen neuen Namen gewartet wird.",
     "rename.button.cancel": "❌ Abbrechen",
+    "commands.select": "Wähle einen OpenCode-Befehl:",
+    "commands.empty": "📭 Für dieses Projekt sind keine OpenCode-Befehle verfügbar.",
+    "commands.fetch_error": "🔴 OpenCode-Befehle konnten nicht geladen werden.",
+    "commands.no_description": "Keine Beschreibung",
+    "commands.button.execute": "✅ Ausführen",
+    "commands.button.cancel": "❌ Abbrechen",
+    "commands.confirm": "Bestätige die Ausführung des Befehls {command}. Für die Ausführung mit Argumenten sende die Argumente als Nachricht.",
+    "commands.inactive_callback": "Dieses Befehlsmenü ist inaktiv",
+    "commands.cancelled_callback": "Abgebrochen",
+    "commands.execute_callback": "Befehl wird ausgeführt...",
+    "commands.executing_prefix": "⚡ Befehl wird ausgeführt:",
+    "commands.arguments_empty": "⚠️ Argumente dürfen nicht leer sein. Sende Text oder tippe auf Ausführen.",
+    "commands.execute_error": "🔴 OpenCode-Befehl konnte nicht ausgeführt werden.",
     "cmd.description.rename": "Aktuelle Sitzung umbenennen",
     "cli.usage": "Verwendung:\n  opencode-telegram [start] [--mode sources|installed]\n  opencode-telegram status\n  opencode-telegram stop\n  opencode-telegram config\n\nHinweise:\n  - Ohne Befehl wird standardmäßig `start` verwendet\n  - `--mode` wird derzeit nur für `start` unterstützt",
     "cli.placeholder.status": "Befehl `status` ist derzeit ein Platzhalter. Echte Statusprüfungen werden in der Service-Schicht hinzugefügt (Phase 5).",

package/dist/i18n/en.js

@@ -4,6 +4,7 @@ export const en = {
     "cmd.description.stop": "Stop current action",
     "cmd.description.sessions": "List sessions",
     "cmd.description.projects": "List projects",
+    "cmd.description.commands": "Custom commands",
     "cmd.description.opencode_start": "Start OpenCode server",
     "cmd.description.opencode_stop": "Stop OpenCode server",
     "cmd.description.help": "Help",
@@ -48,6 +49,11 @@ export const en = {
     "bot.photo_model_no_image": "⚠️ Current model doesn't support image input. Sending text only.",
     "bot.photo_download_error": "🔴 Failed to download photo",
     "bot.photo_no_caption": "💡 Tip: Add a caption to describe what you want to do with this photo.",
+    "bot.file_downloading": "⏳ Downloading file...",
+    "bot.file_too_large": "⚠️ File is too large (max {maxSizeMb}MB)",
+    "bot.file_download_error": "🔴 Failed to download file",
+    "bot.model_no_pdf": "⚠️ Current model doesn't support PDF input. Sending text only.",
+    "bot.text_file_too_large": "⚠️ Text file is too large (max {maxSizeKb}KB)",
     "status.header_running": "🟢 **OpenCode Server is running**",
     "status.health.healthy": "Healthy",
     "status.health.unhealthy": "Unhealthy",
@@ -70,7 +76,11 @@ export const en = {
     "projects.empty": "📭 No projects found.\n\nOpen a directory in OpenCode and create at least one session, then it will appear here.",
     "projects.select": "Select a project:",
     "projects.select_with_current": "Select a project:\n\nCurrent: 🏗 {project}",
+    "projects.page_indicator": "Page {current}/{total}",
+    "projects.prev_page": "⬅️ Previous",
+    "projects.next_page": "Next ➡️",
     "projects.fetch_error": "🔴 OpenCode Server is unavailable or an error occurred while loading projects.",
+    "projects.page_load_error": "Cannot load this page. Please try again.",
     "projects.selected": "✅ Project selected: {project}\n\n📋 Session was reset. Use /sessions or /new for this project.",
     "projects.select_error": "🔴 Failed to select project.",
     "sessions.project_not_selected": "🏗 Project is not selected.\n\nFirst select a project with /projects.",
@@ -120,6 +130,8 @@ export const en = {
     "agent.change_error_callback": "Failed to change mode",
     "agent.menu.current": "Current mode: {name}\n\nSelect mode:",
     "agent.menu.select": "Select work mode:",
+    "agent.menu.empty": "⚠️ No available agents",
+    "agent.menu.error": "🔴 Failed to get agents list",
     "model.changed_callback": "Model changed: {name}",
     "model.changed_message": "✅ Model changed to: {name}",
     "model.change_error_callback": "Failed to change model",
@@ -232,6 +244,19 @@ export const en = {
     "rename.blocked.expected_name": "⚠️ Enter a new session name as text or tap Cancel in rename message.",
     "rename.blocked.command_not_allowed": "⚠️ This command is not available while rename is waiting for a new name.",
     "rename.button.cancel": "❌ Cancel",
+    "commands.select": "Choose an OpenCode command:",
+    "commands.empty": "📭 No OpenCode commands are available for this project.",
+    "commands.fetch_error": "🔴 Failed to load OpenCode commands.",
+    "commands.no_description": "No description",
+    "commands.button.execute": "✅ Execute",
+    "commands.button.cancel": "❌ Cancel",
+    "commands.confirm": "Confirm execution of command {command}. To run it with arguments, send the arguments as a message.",
+    "commands.inactive_callback": "This command menu is inactive",
+    "commands.cancelled_callback": "Cancelled",
+    "commands.execute_callback": "Executing command...",
+    "commands.executing_prefix": "⚡ Executing command:",
+    "commands.arguments_empty": "⚠️ Arguments cannot be empty. Send text or tap Execute.",
+    "commands.execute_error": "🔴 Failed to execute OpenCode command.",
     "cmd.description.rename": "Rename current session",
     "cli.usage": "Usage:\n  opencode-telegram [start] [--mode sources|installed]\n  opencode-telegram status\n  opencode-telegram stop\n  opencode-telegram config\n\nNotes:\n  - No command defaults to `start`\n  - `--mode` is currently supported for `start` only",
     "cli.placeholder.status": "Command `status` is currently a placeholder. Real status checks will be added in service layer (Phase 5).",

package/dist/i18n/es.js

@@ -4,6 +4,7 @@ export const es = {
     "cmd.description.stop": "Detener la acción actual",
     "cmd.description.sessions": "Listar sesiones",
     "cmd.description.projects": "Listar proyectos",
+    "cmd.description.commands": "Comandos personalizados",
     "cmd.description.opencode_start": "Iniciar servidor OpenCode",
     "cmd.description.opencode_stop": "Detener servidor OpenCode",
     "cmd.description.help": "Ayuda",
@@ -48,6 +49,11 @@ export const es = {
     "bot.photo_model_no_image": "⚠️ El modelo actual no admite entrada de imagen. Enviaré solo texto.",
     "bot.photo_download_error": "🔴 No se pudo descargar la foto",
     "bot.photo_no_caption": "💡 Consejo: agrega un pie de foto para describir que quieres hacer con esta foto.",
+    "bot.file_downloading": "⏳ Descargando archivo...",
+    "bot.file_too_large": "⚠️ El archivo es demasiado grande (max {maxSizeMb}MB)",
+    "bot.file_download_error": "🔴 No se pudo descargar el archivo",
+    "bot.model_no_pdf": "⚠️ El modelo actual no admite entrada PDF. Enviaré solo texto.",
+    "bot.text_file_too_large": "⚠️ El archivo de texto es demasiado grande (max {maxSizeKb}KB)",
     "status.header_running": "🟢 **OpenCode Server está en ejecución**",
     "status.health.healthy": "Saludable",
     "status.health.unhealthy": "No saludable",
@@ -70,7 +76,11 @@ export const es = {
     "projects.empty": "📭 No se encontraron proyectos.\n\nAbre un directorio en OpenCode y crea al menos una sesión; entonces aparecerá aquí.",
     "projects.select": "Selecciona un proyecto:",
     "projects.select_with_current": "Selecciona un proyecto:\n\nActual: 🏗 {project}",
+    "projects.page_indicator": "Página {current}/{total}",
+    "projects.prev_page": "⬅️ Anterior",
+    "projects.next_page": "Siguiente ➡️",
     "projects.fetch_error": "🔴 OpenCode Server no está disponible u ocurrió un error al cargar los proyectos.",
+    "projects.page_load_error": "No se puede cargar esta página. Inténtalo de nuevo.",
     "projects.selected": "✅ Proyecto seleccionado: {project}\n\n📋 La sesión se reinició. Usa /sessions o /new para este proyecto.",
     "projects.select_error": "🔴 No se pudo seleccionar el proyecto.",
     "sessions.project_not_selected": "🏗 No hay un proyecto seleccionado.\n\nPrimero selecciona un proyecto con /projects.",
@@ -120,6 +130,8 @@ export const es = {
     "agent.change_error_callback": "No se pudo cambiar el modo",
     "agent.menu.current": "Modo actual: {name}\n\nSelecciona el modo:",
     "agent.menu.select": "Selecciona el modo de trabajo:",
+    "agent.menu.empty": "⚠️ No hay agentes disponibles",
+    "agent.menu.error": "🔴 No se pudo obtener la lista de agentes",
     "model.changed_callback": "Modelo cambiado: {name}",
     "model.changed_message": "✅ Modelo cambiado a: {name}",
     "model.change_error_callback": "No se pudo cambiar el modelo",
@@ -232,6 +244,19 @@ export const es = {
     "rename.blocked.expected_name": "⚠️ Introduce el nuevo nombre de la sesión como texto o toca Cancelar en el mensaje de cambio de nombre.",
     "rename.blocked.command_not_allowed": "⚠️ Este comando no está disponible mientras el cambio de nombre espera un nuevo nombre.",
     "rename.button.cancel": "❌ Cancelar",
+    "commands.select": "Elige un comando de OpenCode:",
+    "commands.empty": "📭 No hay comandos de OpenCode disponibles para este proyecto.",
+    "commands.fetch_error": "🔴 No se pudieron cargar los comandos de OpenCode.",
+    "commands.no_description": "Sin descripción",
+    "commands.button.execute": "✅ Ejecutar",
+    "commands.button.cancel": "❌ Cancelar",
+    "commands.confirm": "Confirma la ejecución del comando {command}. Para ejecutarlo con argumentos, envía los argumentos como mensaje.",
+    "commands.inactive_callback": "Este menú de comandos está inactivo",
+    "commands.cancelled_callback": "Cancelado",
+    "commands.execute_callback": "Ejecutando comando...",
+    "commands.executing_prefix": "⚡ Ejecutando comando:",
+    "commands.arguments_empty": "⚠️ Los argumentos no pueden estar vacíos. Envía texto o toca Ejecutar.",
+    "commands.execute_error": "🔴 No se pudo ejecutar el comando de OpenCode.",
     "cmd.description.rename": "Renombrar la sesión actual",
     "cli.usage": "Uso:\n  opencode-telegram [start] [--mode sources|installed]\n  opencode-telegram status\n  opencode-telegram stop\n  opencode-telegram config\n\nNotas:\n  - Sin comando, el valor por defecto es `start`\n  - `--mode` actualmente solo se admite para `start`",
     "cli.placeholder.status": "El comando `status` es actualmente un marcador de posición. Las comprobaciones reales de estado se agregarán en la capa de servicio (Fase 5).",

package/dist/i18n/ru.js

@@ -4,6 +4,7 @@ export const ru = {
     "cmd.description.stop": "Прервать текущее действие",
     "cmd.description.sessions": "Список сессий",
     "cmd.description.projects": "Список проектов",
+    "cmd.description.commands": "Пользовательские команды",
     "cmd.description.opencode_start": "Запустить OpenCode сервер",
     "cmd.description.opencode_stop": "Остановить OpenCode сервер",
     "cmd.description.help": "Справка",
@@ -48,6 +49,11 @@ export const ru = {
     "bot.photo_model_no_image": "⚠️ Текущая модель не поддерживает изображения. Отправляю только текст.",
     "bot.photo_download_error": "🔴 Не удалось скачать фото",
     "bot.photo_no_caption": "💡 Совет: Добавьте подпись, чтобы описать, что делать с этим фото.",
+    "bot.file_downloading": "⏳ Скачиваю файл...",
+    "bot.file_too_large": "⚠️ Файл слишком большой (макс. {maxSizeMb}МБ)",
+    "bot.file_download_error": "🔴 Не удалось скачать файл",
+    "bot.model_no_pdf": "⚠️ Текущая модель не поддерживает PDF. Отправляю только текст.",
+    "bot.text_file_too_large": "⚠️ Текстовый файл слишком большой (макс. {maxSizeKb}КБ)",
     "status.header_running": "🟢 **OpenCode Server запущен**",
     "status.health.healthy": "Healthy",
     "status.health.unhealthy": "Unhealthy",
@@ -70,7 +76,11 @@ export const ru = {
     "projects.empty": "📭 Проектов нет.\n\nОткройте директорию в OpenCode и создайте хотя бы одну сессию, после этого она появится здесь.",
     "projects.select": "Выберите проект:",
     "projects.select_with_current": "Выберите проект:\n\nТекущий: 🏗 {project}",
+    "projects.page_indicator": "Страница {current}/{total}",
+    "projects.prev_page": "⬅️ Назад",
+    "projects.next_page": "Вперёд ➡️",
     "projects.fetch_error": "🔴 OpenCode Server недоступен или произошла ошибка при получении списка проектов.",
+    "projects.page_load_error": "Не удалось загрузить эту страницу. Попробуйте снова.",
     "projects.selected": "✅ Проект выбран: {project}\n\n📋 Сессия сброшена. Используйте /sessions или /new для работы с этим проектом.",
     "projects.select_error": "🔴 Ошибка при выборе проекта.",
     "sessions.project_not_selected": "🏗 Проект не выбран.\n\nСначала выберите проект командой /projects.",
@@ -120,6 +130,8 @@ export const ru = {
     "agent.change_error_callback": "Ошибка при смене режима",
     "agent.menu.current": "Текущий режим: {name}\n\nВыберите режим:",
     "agent.menu.select": "Выберите режим работы:",
+    "agent.menu.empty": "⚠️ Нет доступных агентов",
+    "agent.menu.error": "🔴 Не удалось получить список агентов",
     "model.changed_callback": "Модель изменена: {name}",
     "model.changed_message": "✅ Модель изменена на: {name}",
     "model.change_error_callback": "Ошибка при смене модели",
@@ -232,6 +244,19 @@ export const ru = {
     "rename.blocked.expected_name": "⚠️ Введите новое название текстом или нажмите Отмена в сообщении переименования.",
     "rename.blocked.command_not_allowed": "⚠️ Эта команда недоступна, пока ожидается новое название сессии.",
     "rename.button.cancel": "❌ Отмена",
+    "commands.select": "Выберите команду OpenCode:",
+    "commands.empty": "📭 Для этого проекта нет доступных команд OpenCode.",
+    "commands.fetch_error": "🔴 Не удалось загрузить список команд OpenCode.",
+    "commands.no_description": "Без описания",
+    "commands.button.execute": "✅ Выполнить",
+    "commands.button.cancel": "❌ Отмена",
+    "commands.confirm": "Подтвердите выполнение команды {command}. Для выполнения с аргументами отправьте аргументы отдельным сообщением.",
+    "commands.inactive_callback": "Это меню команд уже неактивно",
+    "commands.cancelled_callback": "Отменено",
+    "commands.execute_callback": "Запускаю команду...",
+    "commands.executing_prefix": "⚡ Выполнение команды:",
+    "commands.arguments_empty": "⚠️ Аргументы не могут быть пустыми. Отправьте текст или нажмите Выполнить.",
+    "commands.execute_error": "🔴 Не удалось выполнить команду OpenCode.",
     "cmd.description.rename": "Переименовать текущую сессию",
     "cli.usage": "Использование:\n  opencode-telegram [start] [--mode sources|installed]\n  opencode-telegram status\n  opencode-telegram stop\n  opencode-telegram config\n\nЗаметки:\n  - Без команды по умолчанию используется `start`\n  - `--mode` сейчас поддерживается только для `start`",
     "cli.placeholder.status": "Команда `status` пока работает как заглушка. Реальная проверка статуса появится на этапе service-слоя (Этап 5).",

package/dist/i18n/zh.js

@@ -4,6 +4,7 @@ export const zh = {
     "cmd.description.stop": "停止当前操作",
     "cmd.description.sessions": "列出会话",
     "cmd.description.projects": "列出项目",
+    "cmd.description.commands": "自定义命令",
     "cmd.description.opencode_start": "启动 OpenCode 服务器",
     "cmd.description.opencode_stop": "停止 OpenCode 服务器",
     "cmd.description.help": "帮助",
@@ -48,6 +49,11 @@ export const zh = {
     "bot.photo_model_no_image": "⚠️ 当前模型不支持图像输入。将仅发送文本。",
     "bot.photo_download_error": "🔴 下载照片失败",
     "bot.photo_no_caption": "💡 提示：添加说明文字以描述你希望对这张照片做什么。",
+    "bot.file_downloading": "⏳ 正在下载文件...",
+    "bot.file_too_large": "⚠️ 文件过大（最大 {maxSizeMb}MB）",
+    "bot.file_download_error": "🔴 下载文件失败",
+    "bot.model_no_pdf": "⚠️ 当前模型不支持PDF输入。将仅发送文本。",
+    "bot.text_file_too_large": "⚠️ 文本文件过大（最大 {maxSizeKb}KB）",
     "status.header_running": "🟢 **OpenCode 服务器正在运行**",
     "status.health.healthy": "健康",
     "status.health.unhealthy": "不健康",
@@ -70,7 +76,11 @@ export const zh = {
     "projects.empty": "📭 未找到项目。\n\n在 OpenCode 中打开一个目录并至少创建一个会话，然后它会出现在这里。",
     "projects.select": "请选择一个项目：",
     "projects.select_with_current": "请选择一个项目：\n\n当前：🏗 {project}",
+    "projects.page_indicator": "第 {current}/{total} 页",
+    "projects.prev_page": "⬅️ 上一页",
+    "projects.next_page": "下一页 ➡️",
     "projects.fetch_error": "🔴 OpenCode 服务器不可用，或加载项目时发生错误。",
+    "projects.page_load_error": "无法加载此页面。请重试。",
     "projects.selected": "✅ 已选择项目：{project}\n\n📋 会话已重置。请在此项目中使用 /sessions 或 /new。",
     "projects.select_error": "🔴 选择项目失败。",
     "sessions.project_not_selected": "🏗 未选择项目。\n\n请先使用 /projects 选择一个项目。",
@@ -120,6 +130,8 @@ export const zh = {
     "agent.change_error_callback": "切换模式失败",
     "agent.menu.current": "当前模式：{name}\n\n请选择模式：",
     "agent.menu.select": "请选择工作模式：",
+    "agent.menu.empty": "⚠️ 没有可用的代理",
+    "agent.menu.error": "🔴 获取代理列表失败",
     "model.changed_callback": "模型已更改：{name}",
     "model.changed_message": "✅ 模型已切换为：{name}",
     "model.change_error_callback": "切换模型失败",
@@ -232,6 +244,19 @@ export const zh = {
     "rename.blocked.expected_name": "⚠️ 请以文本输入新会话名称，或在重命名消息中点击取消。",
     "rename.blocked.command_not_allowed": "⚠️ 重命名等待新名称期间不可用此命令。",
     "rename.button.cancel": "❌ 取消",
+    "commands.select": "请选择一个 OpenCode 命令：",
+    "commands.empty": "📭 当前项目没有可用的 OpenCode 命令。",
+    "commands.fetch_error": "🔴 加载 OpenCode 命令失败。",
+    "commands.no_description": "无描述",
+    "commands.button.execute": "✅ 执行",
+    "commands.button.cancel": "❌ 取消",
+    "commands.confirm": "请确认执行命令 {command}。若需带参数执行，请发送一条包含参数的消息。",
+    "commands.inactive_callback": "该命令菜单已失效",
+    "commands.cancelled_callback": "已取消",
+    "commands.execute_callback": "正在执行命令...",
+    "commands.executing_prefix": "⚡ 执行命令:",
+    "commands.arguments_empty": "⚠️ 参数不能为空。请发送文本或点击执行。",
+    "commands.execute_error": "🔴 执行 OpenCode 命令失败。",
     "cmd.description.rename": "重命名当前会话",
     "cli.usage": "用法：\n  opencode-telegram [start] [--mode sources|installed]\n  opencode-telegram status\n  opencode-telegram stop\n  opencode-telegram config\n\n说明：\n  - 不带命令时默认执行 `start`\n  - `--mode` 目前仅支持 `start` 命令",
     "cli.placeholder.status": "命令 `status` 目前是占位符。真实状态检查将会在 service 层（阶段 5）添加。",

package/dist/model/types.js

@@ -8,12 +8,10 @@
  * @returns Formatted string "providerID/modelID"
  */
 export function formatModelForButton(providerID, modelID) {
-    const formatted = `${providerID}/${modelID}`;
-    // Limit to ~30 characters for button width (excluding emoji)
-    if (formatted.length > 30) {
-        return `🤖 ${formatted.substring(0, 27)}...`;
-    }
-    return `🤖 ${formatted}`;
+    // If model name is too long, we only truncate the model part
+    const displayModelId = modelID.length > 20 ? `${modelID.substring(0, 17)}...` : modelID;
+    const displayProviderId = providerID.length > 15 ? `${providerID.substring(0, 12)}...` : providerID;
+    return `🤖 ${displayProviderId}\n${displayModelId}`;
 }
 /**
  * Format model for display in messages (full format)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grinev/opencode-telegram-bot",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Telegram bot client for OpenCode to run and monitor coding tasks from chat.",
   "type": "module",
   "main": "./dist/index.js",