@grinev/opencode-telegram-bot 0.22.2 → 0.22.3

package/dist/bot/handlers/voice-handler.js

@@ -7,6 +7,7 @@ import { config } from "../../config.js";
 import { getTtsMode } from "../../app/stores/settings-store.js";
 import { isSttConfigured, transcribeAudio, } from "../../app/services/stt-service.js";
 import { processUserPrompt } from "./prompt.js";
+import { flushPendingPrompt } from "./message-merger.js";
 import { logger } from "../../utils/logger.js";
 import { t } from "../../i18n/index.js";
 import { buildTelegramFileUrl } from "../../app/services/file-download-service.js";
@@ -131,6 +132,7 @@ export async function handleVoiceMessage(ctx, deps) {
         logger.warn("[Voice] Received voice/audio message with no file_id");
         return;
     }
+    flushPendingPrompt(ctx.chat.id);
     // Check if STT is configured
     if (!sttConfigured()) {
         await ctx.reply(t("stt.not_configured"));

package/dist/bot/menus/permission-menu.js

@@ -67,8 +67,31 @@ export function syncPermissionInteractionState(metadata = {}) {
 /**
  * Show permission request message with inline buttons
  */
-export async function showPermissionRequest(bot, chatId, request) {
+export async function showPermissionRequest(bot, chatId, request, generation = permissionManager.getGeneration()) {
     logger.debug(`[PermissionHandler] Showing permission request: ${request.permission}`);
+    if (generation !== permissionManager.getGeneration() ||
+        permissionManager.isResolved(request.id)) {
+        logger.debug(`[PermissionHandler] Skipping stale or already resolved request: ${request.id}`);
+        return;
+    }
+    const grouped = permissionManager.addEquivalentRequest(request, generation);
+    if (grouped) {
+        // Re-render the visible prompt so the user can see the answer will apply
+        // to more than one pending request.
+        await bot
+            .editMessageText(chatId, grouped.messageId, formatPermissionText(grouped.request, grouped.count), { reply_markup: buildPermissionKeyboard() })
+            .catch((err) => {
+            logger.warn("[PermissionHandler] Failed to update grouped permission message:", err);
+        });
+        syncPermissionInteractionState({
+            requestID: request.id,
+            messageId: grouped.messageId,
+            deduplicated: true,
+            groupedCount: grouped.count,
+        });
+        summaryAggregator.stopTypingIndicator();
+        return;
+    }
     const text = formatPermissionText(request);
     const keyboard = buildPermissionKeyboard();
     try {
@@ -76,7 +99,12 @@ export async function showPermissionRequest(bot, chatId, request) {
             reply_markup: keyboard,
         });
         logger.debug(`[PermissionHandler] Message sent, messageId=${message.message_id}`);
-        permissionManager.startPermission(request, message.message_id);
+        if (!permissionManager.startPermission(request, message.message_id, generation)) {
+            await bot.deleteMessage(chatId, message.message_id).catch((err) => {
+                logger.warn(`[PermissionHandler] Failed to delete stale permission message:`, err);
+            });
+            return;
+        }
         syncPermissionInteractionState({
             requestID: request.id,
             messageId: message.message_id,
@@ -91,7 +119,7 @@ export async function showPermissionRequest(bot, chatId, request) {
 /**
  * Format permission request text
  */
-function formatPermissionText(request) {
+function formatPermissionText(request, groupedCount = 1) {
     const emoji = PERMISSION_EMOJIS[request.permission] || "🔐";
     const nameKey = PERMISSION_NAME_KEYS[request.permission];
     const name = nameKey ? t(nameKey) : request.permission;
@@ -102,6 +130,9 @@ function formatPermissionText(request) {
             text += `• ${pattern}\n`;
         });
     }
+    if (groupedCount > 1) {
+        text += t("permission.grouped_count", { count: groupedCount });
+    }
     return text;
 }
 /**

package/dist/bot/pinned/pinned-message-manager.js

@@ -137,9 +137,10 @@ class PinnedMessageManager {
                 }
                 return;
             }
-            // Get the maximum context size and total cost from session history
+            // Get the latest measured context size and total cost from session history
             // Context = input + cache.read (cache.read contains previously cached context)
-            let maxContextSize = 0;
+            let latestContextSize = 0;
+            let latestContextCreated = Number.NEGATIVE_INFINITY;
             let totalCost = 0;
             logger.debug(`[PinnedManager] Processing ${messagesData.length} messages from history`);
             messagesData.forEach(({ info }) => {
@@ -155,15 +156,16 @@ class PinnedMessageManager {
                     const contextSize = input + cacheRead;
                     const cost = assistantInfo.cost || 0;
                     logger.debug(`[PinnedManager] Assistant message: input=${input}, cache.read=${cacheRead}, total=${contextSize}, cost=$${cost.toFixed(2)}`);
-                    // Keep track of maximum context size (peak usage in session)
-                    if (contextSize > maxContextSize) {
-                        maxContextSize = contextSize;
+                    const created = assistantInfo.time?.created ?? 0;
+                    if (contextSize > 0 && created >= latestContextCreated) {
+                        latestContextSize = contextSize;
+                        latestContextCreated = created;
                     }
                     // Accumulate total session cost
                     totalCost += cost;
                 }
             });
-            this.state.tokensUsed = maxContextSize;
+            this.state.tokensUsed = latestContextSize;
             this.state.cost = totalCost;
             this.state.sessionId = sessionId;
             logger.info(`[PinnedManager] Loaded context from history: ${this.state.tokensUsed} tokens, cost: $${this.state.cost.toFixed(2)}`);

package/dist/bot/routers/command-router.js

@@ -22,6 +22,7 @@ import { helpCommand } from "../commands/help-command.js";
 import { statusCommand } from "../commands/status-command.js";
 import { BOT_COMMANDS } from "../commands/definitions.js";
 import { logger } from "../../utils/logger.js";
+import { flushPendingPrompt } from "../handlers/message-merger.js";
 let commandsInitialized = false;
 export async function ensureCommandsInitialized(ctx, next) {
     if (commandsInitialized || !ctx.from || ctx.from.id !== config.telegram.allowedUserId) {
@@ -49,6 +50,12 @@ export async function ensureCommandsInitialized(ctx, next) {
     await next();
 }
 export function registerCommandRouter(bot, deps) {
+    bot.use(async (ctx, next) => {
+        if (ctx.chat && ctx.message?.text?.startsWith("/")) {
+            flushPendingPrompt(ctx.chat.id);
+        }
+        await next();
+    });
     bot.command("start", startCommand);
     bot.command("help", helpCommand);
     bot.command("status", statusCommand);

package/dist/bot/routers/message-router.js

@@ -1,3 +1,4 @@
+import { config } from "../../config.js";
 import { interactionManager } from "../../app/managers/interaction-manager.js";
 import { questionManager } from "../../app/managers/question-manager.js";
 import { t } from "../../i18n/index.js";
@@ -14,7 +15,7 @@ import { AGENT_MODE_BUTTON_TEXT_PATTERN, MODEL_BUTTON_TEXT_PATTERN, VARIANT_BUTT
 import { handleDocumentMessage } from "../handlers/document-handler.js";
 import { createMediaGroupAttachmentMiddleware } from "../handlers/media-group-handler.js";
 import { handlePhotoMessage } from "../handlers/photo-handler.js";
-import { processUserPrompt } from "../handlers/prompt.js";
+import { queuePromptForMerging } from "../handlers/message-merger.js";
 import { handleCatalogTextArguments } from "../handlers/text-message-handler.js";
 import { handleVoiceMessage } from "../handlers/voice-handler.js";
 import { unknownCommandMiddleware } from "../middleware/unknown-command.js";
@@ -144,7 +145,7 @@ export function registerMessageRouter(bot, deps) {
         if (handledCatalogTextArgs) {
             return;
         }
-        await processUserPrompt(ctx, text, promptDeps);
-        logger.debug("[Bot] message:text handler completed (prompt sent in background)");
+        queuePromptForMerging(ctx, text, promptDeps, config.bot.messageMergeWindowMs);
+        logger.debug(`[Bot] message:text handler completed (merge window=${config.bot.messageMergeWindowMs}ms)`);
     });
 }

package/dist/bot/services/event-subscription-service.js

@@ -38,9 +38,10 @@ import { deliverExternalUserInputNotification } from "../messages/external-user-
 import { backgroundSessionTracker, } from "../../app/managers/background-session-manager.js";
 import { buildBackgroundSessionOpenKeyboard } from "../menus/session-selection-menu.js";
 import { questionManager } from "../../app/managers/question-manager.js";
+import { permissionManager } from "../../app/managers/permission-manager.js";
 import { showCurrentQuestion } from "../menus/question-menu.js";
-import { showPermissionRequest } from "../menus/permission-menu.js";
-import { clearAllInteractionState } from "../../app/managers/interaction-manager.js";
+import { showPermissionRequest, syncPermissionInteractionState } from "../menus/permission-menu.js";
+import { clearAllInteractionState, interactionManager, } from "../../app/managers/interaction-manager.js";
 import { stopEventListening, subscribeToEvents } from "../../opencode/events.js";
 const TELEGRAM_DOCUMENT_CAPTION_MAX_LENGTH = 1024;
 const RESPONSE_STREAM_THROTTLE_MS = config.bot.responseStreamThrottleMs;
@@ -522,6 +523,7 @@ class EventSubscriptionService {
             clearAllInteractionState("question_error");
         });
         summaryAggregator.setOnPermission(async (request) => {
+            const generation = permissionManager.getGeneration();
             if (!this.botInstance || !this.chatIdInstance) {
                 logger.error("Bot or chat ID not available for showing permission request");
                 return;
@@ -540,7 +542,24 @@ class EventSubscriptionService {
                 this.toolCallStreamer.flushSession(request.sessionID, "permission_asked"),
             ]);
             logger.info(`[Bot] Received permission request from agent: type=${request.permission}, requestID=${request.id}, subagent=${isSubagent}`);
-            await showPermissionRequest(this.botInstance.api, this.chatIdInstance, request);
+            await showPermissionRequest(this.botInstance.api, this.chatIdInstance, request, generation);
+        });
+        summaryAggregator.setOnPermissionReplied(async (_sessionId, requestID) => {
+            const messageIds = permissionManager.resolveRequest(requestID);
+            const interaction = interactionManager.getSnapshot();
+            if (!permissionManager.isActive() || !interaction || interaction.kind === "permission") {
+                syncPermissionInteractionState({ resolvedRequestID: requestID });
+            }
+            if (this.botInstance && this.chatIdInstance) {
+                const api = this.botInstance.api;
+                const chatId = this.chatIdInstance;
+                await Promise.all(messageIds.map((messageId) => api.deleteMessage(chatId, messageId).catch((err) => {
+                    logger.warn(`[Bot] Failed to delete resolved permission message ${messageId}:`, err);
+                })));
+            }
+            if (messageIds.length > 0) {
+                logger.info(`[Bot] Cleared resolved permission prompt: requestID=${requestID}, messages=${messageIds.length}`);
+            }
         });
         summaryAggregator.setOnThinking(async (update) => {
             if (!this.botInstance || !this.chatIdInstance) {

package/dist/config.js

@@ -21,6 +21,18 @@ function getOptionalPositiveIntEnvVar(key, defaultValue) {
     }
     return parsedValue;
 }
+// Like getOptionalPositiveIntEnvVar, but also accepts 0 (used to disable a feature).
+function getOptionalNonNegativeIntEnvVar(key, defaultValue) {
+    const value = getEnvVar(key, false);
+    if (!value) {
+        return defaultValue;
+    }
+    const parsedValue = Number.parseInt(value, 10);
+    if (Number.isNaN(parsedValue) || parsedValue < 0) {
+        return defaultValue;
+    }
+    return parsedValue;
+}
 function getOptionalLocaleEnvVar(key, defaultValue) {
     const value = getEnvVar(key, false);
     return normalizeLocale(value, defaultValue);
@@ -145,6 +157,9 @@ export const config = {
         locale: getOptionalLocaleEnvVar("BOT_LOCALE", "en"),
         trackBackgroundSessions: getOptionalBooleanEnvVar("TRACK_BACKGROUND_SESSIONS", true),
         messageFormatMode: getOptionalMessageFormatModeEnvVar("MESSAGE_FORMAT_MODE", "markdown"),
+        // Buffer near-limit text for this window so Telegram-split chunks can be merged.
+        // Short messages are processed immediately; 0 disables merging entirely.
+        messageMergeWindowMs: getOptionalNonNegativeIntEnvVar("MESSAGE_MERGE_WINDOW_MS", 1500),
         initialSettingsPreset: parseInitialSettingsPreset(),
     },
     files: {
@@ -163,6 +178,10 @@ export const config = {
         // "json" = base64 audio in an `input_audio` JSON body (e.g. OpenRouter).
         requestFormat: getOptionalSttRequestFormatEnvVar("STT_REQUEST_FORMAT", "multipart"),
     },
+    docExtractor: {
+        apiUrl: getEnvVar("DOC_EXTRACTOR_URL", false),
+        apiKey: getEnvVar("DOC_EXTRACTOR_API_KEY", false),
+    },
     tts: (() => {
         const provider = getOptionalTtsProviderEnvVar("TTS_PROVIDER", "openai");
         const defaultVoice = provider === "google"

package/dist/i18n/ar.js

@@ -88,10 +88,11 @@ export const ar = {
     "bot.files_downloading": "⏳ جارٍ تنزيل الملفات...",
     "bot.file_too_large": "⚠️ حجم الملف أكبر من الحد المسموح ({maxSizeMb}MB)",
     "bot.file_download_error": "🔴 تعذر تنزيل الملف",
-    "bot.file_type_unsupported": "⚠️ نوع الملف غير مدعوم. أرسل صورة أو ملف PDF أو ملفًا نصيًا أو برمجيًا.",
+    "bot.file_type_unsupported": "⚠️ نوع الملف غير مدعوم. أرسل صورة أو مستندًا (PDF، DOCX، PPTX) أو ملفًا نصيًا أو برمجيًا.",
     "bot.media_group_not_processed": "⚠️ تعذر معالجة ملف أو أكثر في هذه المجموعة. لم يتم إرسال أي ملف إلى OpenCode.",
     "bot.media_group_download_error": "🔴 تعذر تنزيل أحد الملفات. لم يتم إرسال أي ملف إلى OpenCode.",
     "bot.model_no_pdf": "⚠️ النموذج الحالي لا يدعم ملفات PDF. سيتم إرسال النص فقط.",
+    "bot.document_extraction_error": "🔴 فشل استخراج نص المستند.",
     "bot.text_file_too_large": "⚠️ حجم الملف النصي أكبر من الحد المسموح ({maxSizeKb}KB)",
     "status.header_running": "🟢 خادم OpenCode يعمل",
     "status.health.healthy": "يعمل بشكل طبيعي",
@@ -277,6 +278,7 @@ export const ar = {
     "permission.blocked.expected_reply": "⚠️ أجب عن طلب الصلاحية أولًا باستخدام الأزرار أعلاه.",
     "permission.blocked.command_not_allowed": "⚠️ لا يمكن استخدام هذا الأمر قبل الرد على طلب الصلاحية.",
     "permission.header": "{emoji} طلب صلاحية: {name}\n\n",
+    "permission.grouped_count": "\n⚠️ يوجد {count} طلبات متطابقة قيد الانتظار — سيُطبَّق ردك عليها جميعًا.\n",
     "permission.button.allow": "✅ سماح لمرة واحدة",
     "permission.button.always": "🔓 سماح دائم",
     "permission.button.reject": "❌ رفض",

package/dist/i18n/de.js

@@ -79,10 +79,11 @@ export const de = {
     "bot.files_downloading": "⏳ Lade Dateien herunter...",
     "bot.file_too_large": "⚠️ Datei ist zu groß (max. {maxSizeMb}MB)",
     "bot.file_download_error": "🔴 Datei konnte nicht heruntergeladen werden",
-    "bot.file_type_unsupported": "⚠️ Dieser Dateityp wird nicht unterstützt. Sende ein Bild, PDF oder eine Text-/Code-Datei.",
+    "bot.file_type_unsupported": "⚠️ Dieser Dateityp wird nicht unterstützt. Sende ein Bild, Dokument (PDF, DOCX, PPTX) oder eine Text-/Code-Datei.",
     "bot.media_group_not_processed": "⚠️ Eine oder mehrere Dateien in diesem Album können nicht verarbeitet werden. Es wurde nichts an OpenCode gesendet.",
     "bot.media_group_download_error": "🔴 Eine der Dateien konnte nicht heruntergeladen werden. Es wurde nichts an OpenCode gesendet.",
     "bot.model_no_pdf": "⚠️ Das aktuelle Modell unterstützt keine PDF-Eingabe. Sende nur Text.",
+    "bot.document_extraction_error": "🔴 Dokumenttext konnte nicht extrahiert werden.",
     "bot.text_file_too_large": "⚠️ Textdatei ist zu groß (max. {maxSizeKb}KB)",
     "status.header_running": "🟢 OpenCode-Server läuft",
     "status.health.healthy": "OK",
@@ -268,6 +269,7 @@ export const de = {
     "permission.blocked.expected_reply": "⚠️ Bitte beantworte zuerst die Berechtigungsanfrage mit den Buttons oben.",
     "permission.blocked.command_not_allowed": "⚠️ Dieser Befehl ist erst verfügbar, wenn du die Berechtigungsanfrage beantwortet hast.",
     "permission.header": "{emoji} Berechtigungsanfrage: {name}\n\n",
+    "permission.grouped_count": "\n⚠️ {count} identische Anfragen ausstehend – deine Antwort gilt für alle.\n",
     "permission.button.allow": "✅ Einmal erlauben",
     "permission.button.always": "🔓 Immer erlauben",
     "permission.button.reject": "❌ Ablehnen",

package/dist/i18n/en.js

@@ -79,10 +79,11 @@ export const en = {
     "bot.files_downloading": "⏳ Downloading files...",
     "bot.file_too_large": "⚠️ File is too large (max {maxSizeMb}MB)",
     "bot.file_download_error": "🔴 Failed to download file",
-    "bot.file_type_unsupported": "⚠️ This file type is not supported. Send an image, PDF, or text/code file.",
+    "bot.file_type_unsupported": "⚠️ This file type is not supported. Send an image, document (PDF, DOCX, PPTX), or text/code file.",
     "bot.media_group_not_processed": "⚠️ One or more files in this album cannot be processed. Nothing was sent to OpenCode.",
     "bot.media_group_download_error": "🔴 Failed to download one of the files. Nothing was sent to OpenCode.",
     "bot.model_no_pdf": "⚠️ Current model doesn't support PDF input. Sending text only.",
+    "bot.document_extraction_error": "🔴 Failed to extract document text.",
     "bot.text_file_too_large": "⚠️ Text file is too large (max {maxSizeKb}KB)",
     "status.header_running": "🟢 OpenCode Server is running",
     "status.health.healthy": "Healthy",
@@ -268,6 +269,7 @@ export const en = {
     "permission.blocked.expected_reply": "⚠️ Please answer the permission request first using the buttons above.",
     "permission.blocked.command_not_allowed": "⚠️ This command is not available until you answer the permission request.",
     "permission.header": "{emoji} Permission request: {name}\n\n",
+    "permission.grouped_count": "\n⚠️ {count} identical requests pending — your answer applies to all of them.\n",
     "permission.button.allow": "✅ Allow once",
     "permission.button.always": "🔓 Allow always",
     "permission.button.reject": "❌ Reject",

package/dist/i18n/es.js

@@ -79,10 +79,11 @@ export const es = {
     "bot.files_downloading": "⏳ Descargando archivos...",
     "bot.file_too_large": "⚠️ El archivo es demasiado grande (max {maxSizeMb}MB)",
     "bot.file_download_error": "🔴 No se pudo descargar el archivo",
-    "bot.file_type_unsupported": "⚠️ Este tipo de archivo no es compatible. Envía una imagen, PDF o archivo de texto/código.",
+    "bot.file_type_unsupported": "⚠️ Este tipo de archivo no es compatible. Envía una imagen, documento (PDF, DOCX, PPTX) o archivo de texto/código.",
     "bot.media_group_not_processed": "⚠️ Uno o más archivos de este álbum no se pueden procesar. No se envió nada a OpenCode.",
     "bot.media_group_download_error": "🔴 No se pudo descargar uno de los archivos. No se envió nada a OpenCode.",
     "bot.model_no_pdf": "⚠️ El modelo actual no admite entrada PDF. Enviaré solo texto.",
+    "bot.document_extraction_error": "🔴 No se pudo extraer el texto del documento.",
     "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",
@@ -268,6 +269,7 @@ export const es = {
     "permission.blocked.expected_reply": "⚠️ Primero responde a la solicitud de permisos usando los botones de arriba.",
     "permission.blocked.command_not_allowed": "⚠️ Este comando no está disponible hasta que respondas a la solicitud de permisos.",
     "permission.header": "{emoji} Solicitud de permisos: {name}\n\n",
+    "permission.grouped_count": "\n⚠️ {count} solicitudes idénticas pendientes: tu respuesta se aplica a todas.\n",
     "permission.button.allow": "✅ Permitir una vez",
     "permission.button.always": "🔓 Permitir siempre",
     "permission.button.reject": "❌ Rechazar",

package/dist/i18n/fr.js

@@ -79,10 +79,11 @@ export const fr = {
     "bot.files_downloading": "⏳ Téléchargement des fichiers...",
     "bot.file_too_large": "⚠️ Le fichier est trop volumineux (max {maxSizeMb}MB)",
     "bot.file_download_error": "🔴 Impossible de télécharger le fichier",
-    "bot.file_type_unsupported": "⚠️ Ce type de fichier n'est pas pris en charge. Envoyez une image, un PDF ou un fichier texte/code.",
+    "bot.file_type_unsupported": "⚠️ Ce type de fichier n'est pas pris en charge. Envoyez une image, un document (PDF, DOCX, PPTX) ou un fichier texte/code.",
     "bot.media_group_not_processed": "⚠️ Un ou plusieurs fichiers de cet album ne peuvent pas être traités. Rien n'a été envoyé à OpenCode.",
     "bot.media_group_download_error": "🔴 Impossible de télécharger l'un des fichiers. Rien n'a été envoyé à OpenCode.",
     "bot.model_no_pdf": "⚠️ Le modèle actuel ne prend pas en charge les PDF. Envoi du texte uniquement.",
+    "bot.document_extraction_error": "🔴 Échec de l'extraction du texte du document.",
     "bot.text_file_too_large": "⚠️ Le fichier texte est trop volumineux (max {maxSizeKb}KB)",
     "status.header_running": "🟢 Le serveur OpenCode est en cours d'exécution",
     "status.health.healthy": "Sain",
@@ -268,6 +269,7 @@ export const fr = {
     "permission.blocked.expected_reply": "⚠️ Veuillez d'abord répondre à la demande d'autorisation avec les boutons ci-dessus.",
     "permission.blocked.command_not_allowed": "⚠️ Cette commande n'est pas disponible tant que vous n'avez pas répondu à la demande d'autorisation.",
     "permission.header": "{emoji} Demande d'autorisation : {name}\n\n",
+    "permission.grouped_count": "\n⚠️ {count} demandes identiques en attente — votre réponse s'applique à toutes.\n",
     "permission.button.allow": "✅ Autoriser une fois",
     "permission.button.always": "🔓 Toujours autoriser",
     "permission.button.reject": "❌ Refuser",

package/dist/i18n/ru.js

@@ -79,10 +79,11 @@ export const ru = {
     "bot.files_downloading": "⏳ Скачиваю файлы...",
     "bot.file_too_large": "⚠️ Файл слишком большой (макс. {maxSizeMb}МБ)",
     "bot.file_download_error": "🔴 Не удалось скачать файл",
-    "bot.file_type_unsupported": "⚠️ Этот тип файла не поддерживается. Отправьте изображение, PDF или текстовый/кодовый файл.",
+    "bot.file_type_unsupported": "⚠️ Этот тип файла не поддерживается. Отправьте изображение, документ (PDF, DOCX, PPTX) или текстовый/кодовый файл.",
     "bot.media_group_not_processed": "⚠️ Один или несколько файлов в альбоме нельзя обработать. В OpenCode ничего не отправлено.",
     "bot.media_group_download_error": "🔴 Не удалось скачать один из файлов. В OpenCode ничего не отправлено.",
     "bot.model_no_pdf": "⚠️ Текущая модель не поддерживает PDF. Отправляю только текст.",
+    "bot.document_extraction_error": "🔴 Не удалось извлечь текст из документа.",
     "bot.text_file_too_large": "⚠️ Текстовый файл слишком большой (макс. {maxSizeKb}КБ)",
     "status.header_running": "🟢 OpenCode Server запущен",
     "status.health.healthy": "Healthy",
@@ -268,6 +269,7 @@ export const ru = {
     "permission.blocked.expected_reply": "⚠️ Сначала ответьте на запрос разрешения кнопками выше.",
     "permission.blocked.command_not_allowed": "⚠️ Эта команда недоступна, пока вы не ответите на запрос разрешения.",
     "permission.header": "{emoji} Запрос разрешения: {name}\n\n",
+    "permission.grouped_count": "\n⚠️ Ожидают {count} одинаковых запроса — ваш ответ применится ко всем.\n",
     "permission.button.allow": "✅ Разрешить один раз",
     "permission.button.always": "🔓 Разрешить всегда",
     "permission.button.reject": "❌ Отклонить",

package/dist/i18n/zh.js

@@ -79,10 +79,11 @@ export const zh = {
     "bot.files_downloading": "⏳ 正在下载文件...",
     "bot.file_too_large": "⚠️ 文件过大（最大 {maxSizeMb}MB）",
     "bot.file_download_error": "🔴 下载文件失败",
-    "bot.file_type_unsupported": "⚠️ 不支持此文件类型。请发送图片、PDF 或文本/代码文件。",
+    "bot.file_type_unsupported": "⚠️ 不支持此文件类型。请发送图片、文档（PDF、DOCX、PPTX）或文本/代码文件。",
     "bot.media_group_not_processed": "⚠️ 此相册中有一个或多个文件无法处理。未向 OpenCode 发送任何内容。",
     "bot.media_group_download_error": "🔴 无法下载其中一个文件。未向 OpenCode 发送任何内容。",
     "bot.model_no_pdf": "⚠️ 当前模型不支持PDF输入。将仅发送文本。",
+    "bot.document_extraction_error": "🔴 文档文本提取失败。",
     "bot.text_file_too_large": "⚠️ 文本文件过大（最大 {maxSizeKb}KB）",
     "status.header_running": "🟢 OpenCode 服务器正在运行",
     "status.health.healthy": "健康",
@@ -268,6 +269,7 @@ export const zh = {
     "permission.blocked.expected_reply": "⚠️ 请先使用上方按钮回答权限请求。",
     "permission.blocked.command_not_allowed": "⚠️ 在你回答权限请求之前不可用此命令。",
     "permission.header": "{emoji} 权限请求：{name}\n\n",
+    "permission.grouped_count": "\n⚠️ 有 {count} 个相同的请求待处理，你的回答将同时应用于全部。\n",
     "permission.button.allow": "✅ 允许一次",
     "permission.button.always": "🔓 始终允许",
     "permission.button.reject": "❌ 拒绝",

package/dist/opencode/events.js

@@ -12,6 +12,7 @@ let isListening = false;
 let activeDirectory = null;
 let streamAbortController = null;
 let listenerGeneration = 0;
+let consecutiveTimeouts = 0;
 function getReconnectDelayMs(attempt) {
     const exponentialDelay = RECONNECT_BASE_DELAY_MS * Math.pow(2, Math.max(0, attempt - 1));
     return Math.min(exponentialDelay, RECONNECT_MAX_DELAY_MS);
@@ -179,6 +180,7 @@ export async function subscribeToEvents(directory, callback) {
                     }
                 }
                 reconnectAttempt = 0;
+                consecutiveTimeouts = 0;
                 eventStream = subscription.stream;
                 let usefulEventCount = 0;
                 try {
@@ -246,6 +248,7 @@ export async function subscribeToEvents(directory, callback) {
                     continue;
                 }
                 reconnectAttempt++;
+                consecutiveTimeouts = 0;
                 const reconnectDelay = getReconnectDelayMs(reconnectAttempt);
                 logger.warn(`Event stream ended for ${directory}, reconnecting in ${reconnectDelay}ms (attempt=${reconnectAttempt})`);
                 const shouldContinue = await waitWithAbort(reconnectDelay, controller.signal);
@@ -265,9 +268,13 @@ export async function subscribeToEvents(directory, callback) {
                     throw error;
                 }
                 reconnectAttempt++;
+                consecutiveTimeouts++;
                 const reconnectDelay = getReconnectDelayMs(reconnectAttempt);
                 if (isEventStreamIdleTimeoutError(error)) {
-                    logger.warn(`Event stream idle timeout for ${directory}, reconnecting in ${reconnectDelay}ms (attempt=${reconnectAttempt})`);
+                    const timeoutWarning = consecutiveTimeouts >= 5
+                        ? ` (${consecutiveTimeouts} consecutive timeouts — OpenCode server may be unreachable)`
+                        : "";
+                    logger.warn(`Event stream idle timeout for ${directory}, reconnecting in ${reconnectDelay}ms (attempt=${reconnectAttempt})${timeoutWarning}`);
                 }
                 else if (isExpectedOpencodeUnavailableError(error)) {
                     logger.warn(`Event stream unavailable for ${directory}, reconnecting in ${reconnectDelay}ms (attempt=${reconnectAttempt})`);

package/dist/runtime/bootstrap.js

@@ -408,11 +408,14 @@ function ensureInteractiveTty() {
 }
 async function validateExistingEnv(envFilePath) {
     const content = await readEnvFileIfExists(envFilePath);
-    if (content === null) {
-        return { isValid: false, reason: "Missing .env" };
+    const effectiveValues = content === null ? {} : dotenv.parse(content);
+    for (const key of WIZARD_ENV_KEYS) {
+        const processValue = process.env[key];
+        if (processValue !== undefined) {
+            effectiveValues[key] = processValue;
+        }
     }
-    const parsed = dotenv.parse(content);
-    return validateRuntimeEnvValues(parsed);
+    return validateRuntimeEnvValues(effectiveValues);
 }
 async function runWizardAndPersist(runtimePaths) {
     ensureInteractiveTty();

package/dist/runtime/service/manager.js

@@ -5,6 +5,7 @@ import { exec, spawn } from "node:child_process";
 import { promisify } from "node:util";
 import { getRuntimePaths } from "../paths.js";
 import { buildServiceChildEnv } from "./env.js";
+import { logger } from "../../utils/logger.js";
 const execAsync = promisify(exec);
 const SERVICE_STATE_FILE_NAME = "bot-service.json";
 const PROCESS_EXIT_POLL_MS = 100;
@@ -66,6 +67,32 @@ function isProcessAlive(pid) {
         return false;
     }
 }
+async function getProcessCreationTime(pid) {
+    try {
+        if (process.platform === "win32") {
+            const { stdout } = await execAsync(`powershell -NoProfile -Command "Get-WmiObject Win32_Process -Filter 'ProcessId=${pid}' | Select-Object -ExpandProperty CreationDate"`);
+            const dateStr = stdout.trim().split(/\r?\n/).find((l) => l.trim().length > 0)?.trim();
+            if (!dateStr) {
+                return null;
+            }
+            const match = dateStr.match(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/);
+            if (!match) {
+                return null;
+            }
+            return new Date(`${match[1]}-${match[2]}-${match[3]}T${match[4]}:${match[5]}:${match[6]}`);
+        }
+        const { stdout } = await execAsync(`ps -o lstart= -p ${pid}`);
+        const dateStr = stdout.trim();
+        if (!dateStr) {
+            return null;
+        }
+        const timestamp = Date.parse(dateStr);
+        return Number.isNaN(timestamp) ? null : new Date(timestamp);
+    }
+    catch {
+        return null;
+    }
+}
 async function waitForProcessExit(pid, timeoutMs) {
     const startTime = Date.now();
     while (Date.now() - startTime < timeoutMs) {
@@ -128,6 +155,22 @@ export async function getBotServiceStatus() {
         };
     }
     if (!isProcessAlive(service.pid)) {
+        logger.info(`[Manager] Stale daemon state cleaned up: PID=${service.pid} no longer exists`);
+        await clearServiceStateFile(stateFilePath);
+        return {
+            status: "stopped",
+            service: null,
+            cleanupReason: "stale",
+        };
+    }
+    const processCreationTime = await getProcessCreationTime(service.pid);
+    const storedStartedAtMs = Date.parse(service.startedAt);
+    if (processCreationTime &&
+        !Number.isNaN(storedStartedAtMs) &&
+        processCreationTime.getTime() > storedStartedAtMs) {
+        logger.warn(`[Manager] Stale daemon state detected: PID=${service.pid} exists but was created ` +
+            `at ${processCreationTime.toISOString()} (daemon started at ${service.startedAt}). ` +
+            `The original process died and the PID was reused.`);
         await clearServiceStateFile(stateFilePath);
         return {
             status: "stopped",
@@ -143,7 +186,11 @@ export async function getBotServiceStatus() {
 }
 export async function startBotDaemon(mode) {
     const currentStatus = await getBotServiceStatus();
+    const cleanupInfo = currentStatus.cleanupReason
+        ? ` (previous state: ${currentStatus.cleanupReason})`
+        : "";
     if (currentStatus.status === "running" && currentStatus.service) {
+        logger.info(`[Manager] Daemon start rejected: already running (PID=${currentStatus.service.pid})${cleanupInfo}`);
         return {
             success: false,
             service: currentStatus.service,
@@ -181,6 +228,7 @@ export async function startBotDaemon(mode) {
             mode: "daemon",
         };
         await writeFileAtomically(stateFilePath, `${JSON.stringify(serviceState, null, 2)}\n`);
+        logger.info(`[Manager] Daemon started: PID=${childProcess.pid}, log=${logFilePath}${cleanupInfo}`);
         return {
             success: true,
             service: serviceState,
@@ -188,12 +236,14 @@ export async function startBotDaemon(mode) {
         };
     }
     catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`[Manager] Daemon start failed: ${errorMessage}${cleanupInfo}`);
         await clearServiceStateFile(stateFilePath);
         return {
             success: false,
             service: null,
             cleanupReason: currentStatus.cleanupReason,
-            error: error instanceof Error ? error.message : String(error),
+            error: errorMessage,
         };
     }
     finally {
@@ -203,6 +253,7 @@ export async function startBotDaemon(mode) {
 export async function stopBotDaemon(timeoutMs = DEFAULT_STOP_TIMEOUT_MS) {
     const currentStatus = await getBotServiceStatus();
     if (currentStatus.status !== "running" || !currentStatus.service) {
+        logger.info(`[Manager] Daemon stop skipped: not running (reason=${currentStatus.cleanupReason ?? "none"})`);
         return {
             success: true,
             service: null,
@@ -211,6 +262,7 @@ export async function stopBotDaemon(timeoutMs = DEFAULT_STOP_TIMEOUT_MS) {
         };
     }
     const { pid } = currentStatus.service;
+    logger.info(`[Manager] Stopping daemon: PID=${pid}`);
     try {
         if (process.platform === "win32") {
             await stopWindowsProcess(pid, timeoutMs);
@@ -219,6 +271,7 @@ export async function stopBotDaemon(timeoutMs = DEFAULT_STOP_TIMEOUT_MS) {
             await stopUnixProcess(pid, timeoutMs);
         }
         if (isProcessAlive(pid)) {
+            logger.warn(`[Manager] Daemon stop failed: process PID=${pid} still alive after ${timeoutMs}ms`);
             return {
                 success: false,
                 service: currentStatus.service,
@@ -227,6 +280,7 @@ export async function stopBotDaemon(timeoutMs = DEFAULT_STOP_TIMEOUT_MS) {
             };
         }
         await clearServiceStateFile();
+        logger.info(`[Manager] Daemon stopped: PID=${pid}`);
         return {
             success: true,
             service: currentStatus.service,
@@ -234,11 +288,13 @@ export async function stopBotDaemon(timeoutMs = DEFAULT_STOP_TIMEOUT_MS) {
         };
     }
     catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`[Manager] Daemon stop error: ${errorMessage}`);
         return {
             success: false,
             service: currentStatus.service,
             cleanupReason: currentStatus.cleanupReason,
-            error: error instanceof Error ? error.message : String(error),
+            error: errorMessage,
         };
     }
 }

package/package.json

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