@grinev/opencode-telegram-bot 0.19.3 → 0.20.0

package/dist/bot/utils/switch-project.js

@@ -4,27 +4,19 @@ import { summaryAggregator } from "../../summary/aggregator.js";
 import { pinnedMessageManager } from "../../pinned/manager.js";
 import { keyboardManager } from "../../keyboard/manager.js";
 import { detachAttachedSession } from "../../attach/service.js";
+import { stopEventListening } from "../../opencode/events.js";
+import { backgroundSessionTracker } from "../../background-session/tracker.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";
 import { createMainKeyboard } from "./keyboard.js";
 import { logger } from "../../utils/logger.js";
-/**
- * Shared logic for switching the active project.
- *
- * Called by both `/projects` (selecting an existing project) and `/open`
- * (browsing and adding a new directory). Performs the full state transition:
- * persists the project, clears the session, resets the pinned message and
- * keyboard, and returns a fresh reply keyboard for the caller to attach to
- * its confirmation message.
- *
- * @param ctx       grammY callback context (used for `ctx.chat` / `ctx.api`)
- * @param project   the project to switch to
- * @param reason    short tag for `clearAllInteractionState` (e.g. "project_switched")
- */
-export async function switchToProject(ctx, project, reason) {
+import { config } from "../../config.js";
+export async function switchToProject(ctx, project, reason, options = {}) {
     detachAttachedSession(reason);
+    stopEventListening();
+    backgroundSessionTracker.clear();
     setCurrentProject(project);
     clearSession();
     summaryAggregator.clear();
@@ -46,5 +38,8 @@ export async function switchToProject(ctx, project, reason) {
     const contextInfo = { tokensUsed: 0, tokensLimit: contextLimit };
     const variantName = formatVariantForButton(currentModel.variant || "default");
     keyboardManager.updateAgent(currentAgent);
+    if (config.bot.trackBackgroundSessions && options.ensureEventSubscription) {
+        await options.ensureEventSubscription(project.worktree);
+    }
     return createMainKeyboard(currentAgent, currentModel, contextInfo, variantName);
 }

package/dist/config.js

@@ -94,6 +94,7 @@ export const config = {
         hideThinkingMessages: getOptionalBooleanEnvVar("HIDE_THINKING_MESSAGES", false),
         hideToolCallMessages: getOptionalBooleanEnvVar("HIDE_TOOL_CALL_MESSAGES", false),
         hideToolFileMessages: getOptionalBooleanEnvVar("HIDE_TOOL_FILE_MESSAGES", false),
+        trackBackgroundSessions: getOptionalBooleanEnvVar("TRACK_BACKGROUND_SESSIONS", true),
         messageFormatMode: getOptionalMessageFormatModeEnvVar("MESSAGE_FORMAT_MODE", "markdown"),
     },
     files: {

package/dist/i18n/de.js

@@ -2,6 +2,7 @@ export const de = {
     "cmd.description.status": "Server- und Sitzungsstatus",
     "cmd.description.new": "Neue Sitzung erstellen",
     "cmd.description.stop": "Aktuelle Aktion stoppen",
+    "cmd.description.detach": "Von aktueller Sitzung trennen",
     "cmd.description.sessions": "Sitzungen auflisten",
     "cmd.description.tts": "Audioantworten umschalten",
     "cmd.description.projects": "Projekte auflisten",
@@ -13,6 +14,7 @@ export const de = {
     "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "OpenCode-Server starten",
     "cmd.description.opencode_stop": "OpenCode-Server stoppen",
+    "cmd.description.ls": "Verzeichnisinhalt auflisten",
     "cmd.description.help": "Hilfe",
     "callback.unknown_command": "Unbekannter Befehl",
     "callback.processing_error": "Verarbeitungsfehler",
@@ -50,6 +52,11 @@ export const de = {
     "bot.session_error": "🔴 OpenCode meldete einen Fehler: {message}",
     "bot.session_retry": "🔁 {message}\n\nDer Provider liefert bei wiederholten Versuchen immer wieder denselben Fehler. Mit /abort abbrechen.",
     "bot.external_user_input": "Externe Benutzereingabe",
+    "background.session_fallback": "Sitzung {id}",
+    "background.assistant_response": "🔔 Assistent hat in einer Hintergrundsitzung geantwortet: {session}",
+    "background.question_asked": "❓ Hintergrundsitzung benötigt eine Antwort: {session}",
+    "background.permission_asked": "🔐 Hintergrundsitzung hat Berechtigungen angefordert: {session}",
+    "background.open_session_button": "Sitzung öffnen",
     "bot.unknown_command": "⚠️ Unbekannter Befehl: {command}. Nutze /help, um verfügbare Befehle zu sehen.",
     "bot.photo_downloading": "⏳ Lade Foto herunter...",
     "bot.photo_too_large": "⚠️ Foto ist zu groß (max. {maxSizeMb}MB)",
@@ -126,6 +133,10 @@ export const de = {
     "attach.restored_permissions": "Ausstehende Berechtigungsanfragen wiederhergestellt: {count}.",
     "attach.disconnect_hint": "Zum Trennen einfach zu einer anderen Sitzung oder einem anderen Projekt wechseln.",
     "attach.error": "🔴 Verbindung mit der aktuellen Sitzung fehlgeschlagen.",
+    "detach.project_not_selected": "🏗 Projekt ist nicht ausgewählt.\n\nWähle zuerst ein Projekt mit /projects.",
+    "detach.no_active_session": "ℹ️ Der Bot ist bereits von allen Sitzungen getrennt.",
+    "detach.success": "✅ Von Sitzung getrennt: {title}\n\nDie OpenCode-Sitzung wurde nicht gestoppt. Falls sie noch läuft, läuft sie separat weiter. Um sie später zu prüfen, wähle sie erneut über /sessions aus.",
+    "detach.error": "🔴 Trennen von der aktuellen Sitzung fehlgeschlagen.",
     "new.project_not_selected": "🏗 Projekt ist nicht ausgewählt.\n\nWähle zuerst ein Projekt mit /projects.",
     "new.created": "✅ Neue Sitzung erstellt: {title}",
     "new.create_error": "🔴 OpenCode-Server ist nicht verfügbar oder beim Erstellen der Sitzung ist ein Fehler aufgetreten.",
@@ -350,6 +361,14 @@ export const de = {
     "commands.button.next_page": "Weiter ➡️",
     "commands.page_empty_callback": "Keine Befehle auf dieser Seite",
     "commands.page_load_error_callback": "Diese Seite konnte nicht geladen werden. Bitte versuche es erneut.",
+    "commands.download.no_roots": "Es sind keine erlaubten Browser-Wurzeln konfiguriert.",
+    "commands.download.downloading": "Datei wird heruntergeladen...",
+    "commands.download.not_found": "Datei nicht gefunden",
+    "commands.download.not_file": "Pfad ist keine Datei",
+    "commands.download.file_too_large": "Datei ist zu groß",
+    "commands.download.size": "Größe",
+    "commands.download.modified": "Geändert",
+    "commands.download.error": "Datei konnte nicht heruntergeladen werden.",
     "skills.select": "Wähle einen OpenCode-Skill:",
     "skills.empty": "📭 Für dieses Projekt sind keine OpenCode-Skills verfügbar.",
     "skills.fetch_error": "🔴 OpenCode-Skills konnten nicht geladen werden.",
@@ -424,4 +443,11 @@ export const de = {
     "open.no_subfolders": "📭 Keine Unterordner",
     "open.subfolder_count": "{count} Unterordner",
     "open.subfolders_count": "{count} Unterordner",
+    "ls.access_denied": "⛔ Zugriff verweigert: Pfad liegt außerhalb des aktuellen Projekts",
+    "ls.scan_error": "🔴 Verzeichnis kann nicht aufgelistet werden",
+    "ls.header": "Verzeichnisinhalt",
+    "ls.total": "Gesamt: {count} Einträge",
+    "ls.file.header": "Dateidetails",
+    "ls.file.download": "📥 Herunterladen",
+    "ls.file.back": "⬅️ Zurück",
 };

package/dist/i18n/en.js

@@ -2,6 +2,7 @@ export const en = {
     "cmd.description.status": "Server and session status",
     "cmd.description.new": "Create a new session",
     "cmd.description.stop": "Stop current action",
+    "cmd.description.detach": "Detach from current session",
     "cmd.description.sessions": "List sessions",
     "cmd.description.tts": "Toggle audio replies",
     "cmd.description.projects": "List projects",
@@ -13,6 +14,7 @@ export const en = {
     "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "Start OpenCode server",
     "cmd.description.opencode_stop": "Stop OpenCode server",
+    "cmd.description.ls": "List directory contents",
     "cmd.description.help": "Help",
     "callback.unknown_command": "Unknown command",
     "callback.processing_error": "Processing error",
@@ -50,6 +52,11 @@ export const en = {
     "bot.session_error": "🔴 OpenCode returned an error: {message}",
     "bot.session_retry": "🔁 {message}\n\nProvider keeps returning the same error on repeated retries. Use /abort to abort.",
     "bot.external_user_input": "External user input",
+    "background.session_fallback": "session {id}",
+    "background.assistant_response": "🔔 Assistant replied in background session: {session}",
+    "background.question_asked": "❓ Background session needs an answer: {session}",
+    "background.permission_asked": "🔐 Background session requested permissions: {session}",
+    "background.open_session_button": "Open session",
     "bot.unknown_command": "⚠️ Unknown command: {command}. Use /help to see available commands.",
     "bot.photo_downloading": "⏳ Downloading photo...",
     "bot.photo_too_large": "⚠️ Photo is too large (max {maxSizeMb}MB)",
@@ -126,6 +133,10 @@ export const en = {
     "attach.restored_permissions": "Recovered pending permission requests: {count}.",
     "attach.disconnect_hint": "To disconnect, switch to another session or project.",
     "attach.error": "🔴 Failed to attach to the current session.",
+    "detach.project_not_selected": "🏗 Project is not selected.\n\nFirst select a project with /projects.",
+    "detach.no_active_session": "ℹ️ Bot is already detached from any session.",
+    "detach.success": "✅ Detached from session: {title}\n\nThe OpenCode session was not stopped. If it is still running, it will continue separately. To check it later, select it again via /sessions.",
+    "detach.error": "🔴 Failed to detach from the current session.",
     "new.project_not_selected": "🏗 Project is not selected.\n\nFirst select a project with /projects.",
     "new.created": "✅ New session created: {title}",
     "new.create_error": "🔴 OpenCode Server is unavailable or an error occurred while creating session.",
@@ -350,6 +361,14 @@ export const en = {
     "commands.button.next_page": "Next ➡️",
     "commands.page_empty_callback": "No commands on this page",
     "commands.page_load_error_callback": "Cannot load this page. Please try again.",
+    "commands.download.no_roots": "No allowed browser roots are configured.",
+    "commands.download.downloading": "Downloading file...",
+    "commands.download.not_found": "File not found",
+    "commands.download.not_file": "Path is not a file",
+    "commands.download.file_too_large": "File is too large",
+    "commands.download.size": "Size",
+    "commands.download.modified": "Modified",
+    "commands.download.error": "Failed to download file.",
     "skills.select": "Choose an OpenCode skill:",
     "skills.empty": "📭 No OpenCode skills are available for this project.",
     "skills.fetch_error": "🔴 Failed to load OpenCode skills.",
@@ -424,4 +443,11 @@ export const en = {
     "open.no_subfolders": "📭 No subfolders",
     "open.subfolder_count": "{count} subfolder",
     "open.subfolders_count": "{count} subfolders",
+    "ls.access_denied": "⛔ Access denied: path is outside the current project",
+    "ls.scan_error": "🔴 Cannot list directory",
+    "ls.header": "Directory Listing",
+    "ls.total": "Total: {count} items",
+    "ls.file.header": "File Details",
+    "ls.file.download": "📥 Download",
+    "ls.file.back": "⬅️ Back",
 };

package/dist/i18n/es.js

@@ -2,6 +2,7 @@ export const es = {
     "cmd.description.status": "Estado del servidor y de la sesión",
     "cmd.description.new": "Crear una sesión nueva",
     "cmd.description.stop": "Detener la acción actual",
+    "cmd.description.detach": "Desconectar de la sesión actual",
     "cmd.description.sessions": "Listar sesiones",
     "cmd.description.tts": "Alternar respuestas de audio",
     "cmd.description.projects": "Listar proyectos",
@@ -13,6 +14,7 @@ export const es = {
     "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "Iniciar servidor OpenCode",
     "cmd.description.opencode_stop": "Detener servidor OpenCode",
+    "cmd.description.ls": "Listar contenidos del directorio",
     "cmd.description.help": "Ayuda",
     "callback.unknown_command": "Comando desconocido",
     "callback.processing_error": "Error de procesamiento",
@@ -50,6 +52,11 @@ export const es = {
     "bot.session_error": "🔴 OpenCode devolvió un error: {message}",
     "bot.session_retry": "🔁 {message}\n\nEl proveedor devuelve el mismo error en intentos repetidos. Usa /abort para detenerlo.",
     "bot.external_user_input": "Entrada externa del usuario",
+    "background.session_fallback": "sesión {id}",
+    "background.assistant_response": "🔔 El asistente respondió en una sesión en segundo plano: {session}",
+    "background.question_asked": "❓ Una sesión en segundo plano necesita una respuesta: {session}",
+    "background.permission_asked": "🔐 Una sesión en segundo plano solicitó permisos: {session}",
+    "background.open_session_button": "Abrir sesión",
     "bot.unknown_command": "⚠️ Comando desconocido: {command}. Usa /help para ver los comandos disponibles.",
     "bot.photo_downloading": "⏳ Descargando foto...",
     "bot.photo_too_large": "⚠️ La foto es demasiado grande (max {maxSizeMb}MB)",
@@ -126,6 +133,10 @@ export const es = {
     "attach.restored_permissions": "Se restauraron solicitudes de permiso pendientes: {count}.",
     "attach.disconnect_hint": "Para desconectarte, cambia a otra sesión o proyecto.",
     "attach.error": "🔴 No se pudo conectar a la sesión actual.",
+    "detach.project_not_selected": "🏗 No hay un proyecto seleccionado.\n\nPrimero selecciona un proyecto con /projects.",
+    "detach.no_active_session": "ℹ️ El bot ya no está conectado a ninguna sesión.",
+    "detach.success": "✅ Desconectado de la sesión: {title}\n\nLa sesión de OpenCode no se detuvo. Si todavía está en ejecución, continuará por separado. Para revisarla más tarde, selecciónala de nuevo con /sessions.",
+    "detach.error": "🔴 No se pudo desconectar de la sesión actual.",
     "new.project_not_selected": "🏗 No hay un proyecto seleccionado.\n\nPrimero selecciona un proyecto con /projects.",
     "new.created": "✅ Sesión nueva creada: {title}",
     "new.create_error": "🔴 OpenCode Server no está disponible u ocurrió un error al crear la sesión.",
@@ -350,6 +361,14 @@ export const es = {
     "commands.button.next_page": "Siguiente ➡️",
     "commands.page_empty_callback": "No hay comandos en esta página",
     "commands.page_load_error_callback": "No se pudo cargar esta página. Por favor, inténtalo de nuevo.",
+    "commands.download.no_roots": "No hay raíces de navegación permitidas configuradas.",
+    "commands.download.downloading": "Descargando archivo...",
+    "commands.download.not_found": "Archivo no encontrado",
+    "commands.download.not_file": "La ruta no es un archivo",
+    "commands.download.file_too_large": "El archivo es demasiado grande",
+    "commands.download.size": "Tamaño",
+    "commands.download.modified": "Modificado",
+    "commands.download.error": "No se pudo descargar el archivo.",
     "skills.select": "Elige un skill de OpenCode:",
     "skills.empty": "📭 No hay skills de OpenCode disponibles para este proyecto.",
     "skills.fetch_error": "🔴 No se pudieron cargar los skills de OpenCode.",
@@ -424,4 +443,11 @@ export const es = {
     "open.no_subfolders": "📭 Sin subcarpetas",
     "open.subfolder_count": "{count} subcarpeta",
     "open.subfolders_count": "{count} subcarpetas",
+    "ls.access_denied": "⛔ Acceso denegado: la ruta está fuera del proyecto actual",
+    "ls.scan_error": "🔴 No se puede listar el directorio",
+    "ls.header": "Listado del directorio",
+    "ls.total": "Total: {count} elementos",
+    "ls.file.header": "Detalles del archivo",
+    "ls.file.download": "📥 Descargar",
+    "ls.file.back": "⬅️ Volver",
 };

package/dist/i18n/fr.js

@@ -2,6 +2,7 @@ export const fr = {
     "cmd.description.status": "Statut du serveur et de la session",
     "cmd.description.new": "Créer une nouvelle session",
     "cmd.description.stop": "Arrêter l'action en cours",
+    "cmd.description.detach": "Se détacher de la session actuelle",
     "cmd.description.sessions": "Lister les sessions",
     "cmd.description.tts": "Basculer les réponses audio",
     "cmd.description.projects": "Lister les projets",
@@ -13,6 +14,7 @@ export const fr = {
     "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "Démarrer le serveur OpenCode",
     "cmd.description.opencode_stop": "Arrêter le serveur OpenCode",
+    "cmd.description.ls": "Lister le contenu du répertoire",
     "cmd.description.help": "Aide",
     "callback.unknown_command": "Commande inconnue",
     "callback.processing_error": "Erreur de traitement",
@@ -50,6 +52,11 @@ export const fr = {
     "bot.session_error": "🔴 OpenCode a renvoyé une erreur : {message}",
     "bot.session_retry": "🔁 {message}\n\nLe fournisseur renvoie la même erreur à chaque nouvelle tentative. Utilisez /abort pour arrêter.",
     "bot.external_user_input": "Entrée utilisateur externe",
+    "background.session_fallback": "session {id}",
+    "background.assistant_response": "🔔 L'assistant a répondu dans une session en arrière-plan : {session}",
+    "background.question_asked": "❓ Une session en arrière-plan attend une réponse : {session}",
+    "background.permission_asked": "🔐 Une session en arrière-plan a demandé des autorisations : {session}",
+    "background.open_session_button": "Ouvrir la session",
     "bot.unknown_command": "⚠️ Commande inconnue : {command}. Utilisez /help pour voir les commandes disponibles.",
     "bot.photo_downloading": "⏳ Téléchargement de la photo...",
     "bot.photo_too_large": "⚠️ La photo est trop volumineuse (max {maxSizeMb}MB)",
@@ -126,6 +133,10 @@ export const fr = {
     "attach.restored_permissions": "Demandes de permission en attente restaurées : {count}.",
     "attach.disconnect_hint": "Pour vous déconnecter, passez simplement à une autre session ou à un autre projet.",
     "attach.error": "🔴 Impossible de se connecter à la session actuelle.",
+    "detach.project_not_selected": "🏗 Aucun projet n'est sélectionné.\n\nSélectionnez d'abord un projet avec /projects.",
+    "detach.no_active_session": "ℹ️ Le bot n'est déjà attaché à aucune session.",
+    "detach.success": "✅ Détaché de la session : {title}\n\nLa session OpenCode n'a pas été arrêtée. Si elle est toujours en cours, elle continuera séparément. Pour la consulter plus tard, sélectionnez-la à nouveau via /sessions.",
+    "detach.error": "🔴 Impossible de se détacher de la session actuelle.",
     "new.project_not_selected": "🏗 Aucun projet n'est sélectionné.\n\nSélectionnez d'abord un projet avec /projects.",
     "new.created": "✅ Nouvelle session créée : {title}",
     "new.create_error": "🔴 Le serveur OpenCode est indisponible ou une erreur s'est produite lors de la création de la session.",
@@ -350,6 +361,14 @@ export const fr = {
     "commands.button.next_page": "Suivant ➡️",
     "commands.page_empty_callback": "Aucune commande sur cette page",
     "commands.page_load_error_callback": "Impossible de charger cette page. Veuillez réessayer.",
+    "commands.download.no_roots": "Aucune racine de navigation autorisée n'est configurée.",
+    "commands.download.downloading": "Téléchargement du fichier...",
+    "commands.download.not_found": "Fichier introuvable",
+    "commands.download.not_file": "Le chemin n'est pas un fichier",
+    "commands.download.file_too_large": "Le fichier est trop volumineux",
+    "commands.download.size": "Taille",
+    "commands.download.modified": "Modifié",
+    "commands.download.error": "Impossible de télécharger le fichier.",
     "skills.select": "Choisissez un skill OpenCode :",
     "skills.empty": "📭 Aucun skill OpenCode n'est disponible pour ce projet.",
     "skills.fetch_error": "🔴 Impossible de charger les skills OpenCode.",
@@ -424,4 +443,11 @@ export const fr = {
     "open.no_subfolders": "📭 Aucun sous-dossier",
     "open.subfolder_count": "{count} sous-dossier",
     "open.subfolders_count": "{count} sous-dossiers",
+    "ls.access_denied": "⛔ Accès refusé : le chemin est en dehors du projet actuel",
+    "ls.scan_error": "🔴 Impossible de lister le répertoire",
+    "ls.header": "Liste du répertoire",
+    "ls.total": "Total : {count} éléments",
+    "ls.file.header": "Détails du fichier",
+    "ls.file.download": "📥 Télécharger",
+    "ls.file.back": "⬅️ Retour",
 };

package/dist/i18n/ru.js

@@ -2,6 +2,7 @@ export const ru = {
     "cmd.description.status": "Статус сервера и сессии",
     "cmd.description.new": "Создать новую сессию",
     "cmd.description.stop": "Прервать текущее действие",
+    "cmd.description.detach": "Отсоединиться от текущей сессии",
     "cmd.description.sessions": "Список сессий",
     "cmd.description.tts": "Переключить аудиоответы",
     "cmd.description.projects": "Список проектов",
@@ -13,6 +14,7 @@ export const ru = {
     "cmd.description.mcps": "MCP серверы",
     "cmd.description.opencode_start": "Запустить OpenCode сервер",
     "cmd.description.opencode_stop": "Остановить OpenCode сервер",
+    "cmd.description.ls": "Список содержимого каталога",
     "cmd.description.help": "Справка",
     "callback.unknown_command": "Неизвестная команда",
     "callback.processing_error": "Ошибка обработки",
@@ -50,6 +52,11 @@ export const ru = {
     "bot.session_error": "🔴 OpenCode вернул ошибку: {message}",
     "bot.session_retry": "🔁 {message}\n\nПровайдер возвращает одну и ту же ошибку при повторных запросах. Используйте /abort для остановки.",
     "bot.external_user_input": "Внешний ввод пользователя",
+    "background.session_fallback": "сессия {id}",
+    "background.assistant_response": "🔔 В фоновой сессии пришёл ответ ассистента: {session}",
+    "background.question_asked": "❓ В фоновой сессии нужен ответ: {session}",
+    "background.permission_asked": "🔐 В фоновой сессии запрошены права: {session}",
+    "background.open_session_button": "Открыть сессию",
     "bot.unknown_command": "⚠️ Неизвестная команда: {command}. Используйте /help для списка команд.",
     "bot.photo_downloading": "⏳ Скачиваю фото...",
     "bot.photo_too_large": "⚠️ Фото слишком большое (макс. {maxSizeMb}МБ)",
@@ -126,6 +133,10 @@ export const ru = {
     "attach.restored_permissions": "Восстановил ожидающие запросы разрешений: {count}.",
     "attach.disconnect_hint": "Чтобы отключиться, переключитесь на другую сессию или проект.",
     "attach.error": "🔴 Не удалось подключиться к текущей сессии.",
+    "detach.project_not_selected": "🏗 Проект не выбран.\n\nСначала выберите проект командой /projects.",
+    "detach.no_active_session": "ℹ️ Бот уже не привязан ни к одной сессии.",
+    "detach.success": "✅ Отсоединился от сессии: {title}\n\nOpenCode-сессия не остановлена. Если она еще выполняется, выполнение продолжится отдельно. Чтобы проверить ее позже, снова выберите эту сессию через /sessions.",
+    "detach.error": "🔴 Не удалось отсоединиться от текущей сессии.",
     "new.project_not_selected": "🏗 Проект не выбран.\n\nСначала выберите проект командой /projects.",
     "new.created": "✅ Создана новая сессия: {title}",
     "new.create_error": "🔴 OpenCode Server недоступен или произошла ошибка при создании сессии.",
@@ -350,6 +361,14 @@ export const ru = {
     "commands.button.next_page": "Вперёд ➡️",
     "commands.page_empty_callback": "На этой странице нет команд",
     "commands.page_load_error_callback": "Не удалось загрузить эту страницу. Пожалуйста, попробуйте снова.",
+    "commands.download.no_roots": "Не настроены разрешённые корневые каталоги для просмотра.",
+    "commands.download.downloading": "Скачиваю файл...",
+    "commands.download.not_found": "Файл не найден",
+    "commands.download.not_file": "Путь не является файлом",
+    "commands.download.file_too_large": "Файл слишком большой",
+    "commands.download.size": "Размер",
+    "commands.download.modified": "Изменён",
+    "commands.download.error": "Не удалось скачать файл.",
     "skills.select": "Выберите скилл OpenCode:",
     "skills.empty": "📭 Для этого проекта нет доступных скиллов OpenCode.",
     "skills.fetch_error": "🔴 Не удалось загрузить список скиллов OpenCode.",
@@ -424,4 +443,11 @@ export const ru = {
     "open.no_subfolders": "📭 Нет подпапок",
     "open.subfolder_count": "{count} подпапка",
     "open.subfolders_count": "{count} подпапок",
+    "ls.access_denied": "⛔ Доступ запрещён: путь находится за пределами текущего проекта",
+    "ls.scan_error": "🔴 Не удается перечислить каталог",
+    "ls.header": "Список каталога",
+    "ls.total": "Всего: {count} элементов",
+    "ls.file.header": "Сведения о файле",
+    "ls.file.download": "📥 Скачать",
+    "ls.file.back": "⬅️ Назад",
 };

package/dist/i18n/zh.js

@@ -2,6 +2,7 @@ export const zh = {
     "cmd.description.status": "服务器和会话状态",
     "cmd.description.new": "创建新会话",
     "cmd.description.stop": "停止当前操作",
+    "cmd.description.detach": "从当前会话分离",
     "cmd.description.sessions": "列出会话",
     "cmd.description.tts": "切换语音回复",
     "cmd.description.projects": "列出项目",
@@ -13,6 +14,7 @@ export const zh = {
     "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "启动 OpenCode 服务器",
     "cmd.description.opencode_stop": "停止 OpenCode 服务器",
+    "cmd.description.ls": "列出目录内容",
     "cmd.description.help": "帮助",
     "callback.unknown_command": "未知命令",
     "callback.processing_error": "处理错误",
@@ -50,6 +52,11 @@ export const zh = {
     "bot.session_error": "🔴 OpenCode 返回错误：{message}",
     "bot.session_retry": "🔁 {message}\n\n提供方在重复重试时持续返回同一错误。使用 /abort 可停止。",
     "bot.external_user_input": "外部用户输入",
+    "background.session_fallback": "会话 {id}",
+    "background.assistant_response": "🔔 助手已在后台会话中回复：{session}",
+    "background.question_asked": "❓ 后台会话需要回答：{session}",
+    "background.permission_asked": "🔐 后台会话请求了权限：{session}",
+    "background.open_session_button": "打开会话",
     "bot.unknown_command": "⚠️ 未知命令：{command}。使用 /help 查看可用命令。",
     "bot.photo_downloading": "⏳ 正在下载照片...",
     "bot.photo_too_large": "⚠️ 照片过大（最大 {maxSizeMb}MB）",
@@ -126,6 +133,10 @@ export const zh = {
     "attach.restored_permissions": "已恢复待处理权限请求：{count}。",
     "attach.disconnect_hint": "如需断开连接，只需切换到其他会话或项目。",
     "attach.error": "🔴 无法连接到当前会话。",
+    "detach.project_not_selected": "🏗 未选择项目。\n\n请先使用 /projects 选择一个项目。",
+    "detach.no_active_session": "ℹ️ 机器人当前未附加到任何会话。",
+    "detach.success": "✅ 已从会话分离：{title}\n\nOpenCode 会话未停止。如果它仍在运行，将继续独立执行。稍后可通过 /sessions 重新选择它来查看。",
+    "detach.error": "🔴 无法从当前会话分离。",
     "new.project_not_selected": "🏗 未选择项目。\n\n请先使用 /projects 选择一个项目。",
     "new.created": "✅ 新会话已创建：{title}",
     "new.create_error": "🔴 OpenCode 服务器不可用，或创建会话时发生错误。",
@@ -350,6 +361,14 @@ export const zh = {
     "commands.button.next_page": "下一页 ➡️",
     "commands.page_empty_callback": "这一页没有命令",
     "commands.page_load_error_callback": "无法加载此页面。请重试。",
+    "commands.download.no_roots": "未配置允许浏览的根目录。",
+    "commands.download.downloading": "正在下载文件...",
+    "commands.download.not_found": "未找到文件",
+    "commands.download.not_file": "该路径不是文件",
+    "commands.download.file_too_large": "文件过大",
+    "commands.download.size": "大小",
+    "commands.download.modified": "修改时间",
+    "commands.download.error": "下载文件失败。",
     "skills.select": "请选择一个 OpenCode 技能：",
     "skills.empty": "📭 当前项目没有可用的 OpenCode 技能。",
     "skills.fetch_error": "🔴 加载 OpenCode 技能失败。",
@@ -424,4 +443,11 @@ export const zh = {
     "open.no_subfolders": "📭 无子文件夹",
     "open.subfolder_count": "{count} 个子文件夹",
     "open.subfolders_count": "{count} 个子文件夹",
+    "ls.access_denied": "⛔ 访问被拒绝：路径在当前项目之外",
+    "ls.scan_error": "🔴 无法列出目录",
+    "ls.header": "目录列表",
+    "ls.total": "总计：{count} 个项目",
+    "ls.file.header": "文件详情",
+    "ls.file.download": "📥 下载",
+    "ls.file.back": "⬅️ 返回",
 };

package/dist/interaction/busy.js

@@ -1,4 +1,4 @@
-export const BUSY_ALLOWED_COMMANDS = ["/abort", "/status", "/help"];
+export const BUSY_ALLOWED_COMMANDS = ["/abort", "/detach", "/status", "/help"];
 const BUSY_ALLOWED_COMMAND_SET = new Set(BUSY_ALLOWED_COMMANDS);
 export function isBusyAllowedCommand(command) {
     return Boolean(command && BUSY_ALLOWED_COMMAND_SET.has(command));

package/dist/interaction/manager.js

@@ -1,5 +1,5 @@
 import { logger } from "../utils/logger.js";
-export const DEFAULT_ALLOWED_INTERACTION_COMMANDS = ["/help", "/status", "/abort"];
+export const DEFAULT_ALLOWED_INTERACTION_COMMANDS = ["/help", "/status", "/abort", "/detach"];
 function normalizeCommand(command) {
     const trimmed = command.trim().toLowerCase();
     if (!trimmed) {

package/dist/scheduled-task/executor.js

@@ -2,6 +2,7 @@ import { config } from "../config.js";
 import { t } from "../i18n/index.js";
 import { opencodeClient } from "../opencode/client.js";
 import { logger } from "../utils/logger.js";
+import { cleanupScheduledTaskSessionIgnores, registerScheduledTaskSessionIgnore, } from "./session-ignore.js";
 export const SCHEDULED_TASK_AGENT = "build";
 const SCHEDULED_TASK_SESSION_TITLE = "Scheduled task run";
 const EXECUTION_POLL_INTERVAL_MS = 2000;
@@ -298,6 +299,7 @@ export async function executeScheduledTask(task) {
     let sessionId = null;
     let deleteTemporarySession = true;
     try {
+        await cleanupScheduledTaskSessionIgnores();
         const { data: session, error: createError } = await opencodeClient.session.create({
             directory: task.projectWorktree,
             title: SCHEDULED_TASK_SESSION_TITLE,
@@ -306,6 +308,7 @@ export async function executeScheduledTask(task) {
             throw createError || new Error("Failed to create temporary scheduled task session");
         }
         sessionId = session.id;
+        await registerScheduledTaskSessionIgnore(session.id);
         const promptOptions = {
             sessionID: session.id,
             directory: session.directory,

package/dist/scheduled-task/runtime.js

@@ -7,6 +7,7 @@ import { sendBotText } from "../bot/utils/telegram-text.js";
 import { formatAssistantRunFooter } from "../bot/utils/assistant-run-footer.js";
 import { executeScheduledTask, SCHEDULED_TASK_AGENT } from "./executor.js";
 import { foregroundSessionState } from "./foreground-state.js";
+import { cleanupScheduledTaskSessionIgnores } from "./session-ignore.js";
 import { computeNextRunAt, isTaskDue } from "./next-run.js";
 import { getScheduledTask, listScheduledTasks, removeScheduledTask, replaceScheduledTasks, updateScheduledTask, } from "./store.js";
 const MAX_TIMER_DELAY_MS = 2_147_483_647;
@@ -96,6 +97,7 @@ export class ScheduledTaskRuntime {
             return;
         }
         this.initialized = true;
+        await cleanupScheduledTaskSessionIgnores();
         await this.recoverTasksOnStartup();
         await this.flushDeferredDeliveries();
     }

package/dist/scheduled-task/schedule-parser.js

@@ -1,5 +1,6 @@
 import { opencodeClient } from "../opencode/client.js";
 import { logger } from "../utils/logger.js";
+import { cleanupScheduledTaskSessionIgnores, registerScheduledTaskSessionIgnore, } from "./session-ignore.js";
 const SCHEDULE_PARSE_SESSION_TITLE = "Scheduled task schedule parser";
 function getLocalTimezone() {
     return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
@@ -133,6 +134,8 @@ export async function parseTaskSchedule(scheduleText, directory) {
     const timezone = getLocalTimezone();
     let sessionId = null;
     try {
+        logger.debug(`[ScheduledTaskScheduleParser] Parsing schedule: directory=${trimmedDirectory}, textLength=${trimmedScheduleText.length}`);
+        await cleanupScheduledTaskSessionIgnores();
         const { data: session, error: createError } = await opencodeClient.session.create({
             directory: trimmedDirectory,
             title: SCHEDULE_PARSE_SESSION_TITLE,
@@ -141,6 +144,8 @@ export async function parseTaskSchedule(scheduleText, directory) {
             throw createError || new Error("Failed to create temporary schedule parser session");
         }
         sessionId = session.id;
+        await registerScheduledTaskSessionIgnore(session.id);
+        logger.debug(`[ScheduledTaskScheduleParser] Created temporary session: sessionId=${session.id}`);
         const { data: response, error: promptError } = await opencodeClient.session.prompt({
             sessionID: session.id,
             directory: session.directory,
@@ -151,6 +156,7 @@ export async function parseTaskSchedule(scheduleText, directory) {
             throw promptError || new Error("Failed to parse schedule");
         }
         const responseText = collectResponseText(response.parts);
+        logger.debug(`[ScheduledTaskScheduleParser] Received parser response: sessionId=${session.id}, textLength=${responseText.length}`);
         if (!responseText) {
             throw new Error("Schedule parser returned an empty response");
         }

package/dist/scheduled-task/session-ignore.js

@@ -0,0 +1,53 @@
+import { getScheduledTaskSessionIgnores, setScheduledTaskSessionIgnores, } from "../settings/manager.js";
+const SCHEDULED_TASK_SESSION_IGNORE_TTL_MS = 24 * 60 * 60 * 1000;
+let mutationQueue = Promise.resolve();
+function isFreshIgnore(ignore, nowMs) {
+    const createdAtMs = Date.parse(ignore.createdAt);
+    return !Number.isNaN(createdAtMs) && nowMs - createdAtMs < SCHEDULED_TASK_SESSION_IGNORE_TTL_MS;
+}
+function pruneExpiredIgnores(ignores, nowMs) {
+    return ignores.filter((ignore) => isFreshIgnore(ignore, nowMs));
+}
+async function mutateIgnores(mutator) {
+    const runMutation = async () => {
+        const currentIgnores = getScheduledTaskSessionIgnores();
+        const { ignores, result } = mutator(currentIgnores);
+        await setScheduledTaskSessionIgnores(ignores);
+        return result;
+    };
+    const mutationPromise = mutationQueue.then(runMutation, runMutation);
+    mutationQueue = mutationPromise.catch(() => undefined);
+    return mutationPromise;
+}
+export function isScheduledTaskSessionIgnored(sessionId, now = new Date()) {
+    const nowMs = now.getTime();
+    return getScheduledTaskSessionIgnores().some((ignore) => ignore.sessionId === sessionId && isFreshIgnore(ignore, nowMs));
+}
+export async function registerScheduledTaskSessionIgnore(sessionId, createdAt = new Date()) {
+    await mutateIgnores((ignores) => {
+        const nowMs = createdAt.getTime();
+        const nextIgnores = pruneExpiredIgnores(ignores, nowMs).filter((ignore) => ignore.sessionId !== sessionId);
+        return {
+            ignores: [...nextIgnores, { sessionId, createdAt: createdAt.toISOString() }],
+            result: undefined,
+        };
+    });
+}
+export async function removeScheduledTaskSessionIgnore(sessionId) {
+    await mutateIgnores((ignores) => ({
+        ignores: ignores.filter((ignore) => ignore.sessionId !== sessionId),
+        result: undefined,
+    }));
+}
+export async function cleanupScheduledTaskSessionIgnores(now = new Date()) {
+    return mutateIgnores((ignores) => {
+        const nextIgnores = pruneExpiredIgnores(ignores, now.getTime());
+        return {
+            ignores: nextIgnores,
+            result: ignores.length - nextIgnores.length,
+        };
+    });
+}
+export function __resetScheduledTaskSessionIgnoreForTests() {
+    mutationQueue = Promise.resolve();
+}

package/dist/settings/manager.js

@@ -5,6 +5,9 @@ import { logger } from "../utils/logger.js";
 function cloneScheduledTasks(tasks) {
     return tasks?.map((task) => cloneScheduledTask(task));
 }
+function cloneScheduledTaskSessionIgnores(ignores) {
+    return ignores?.map((ignore) => ({ ...ignore }));
+}
 function getSettingsFilePath() {
     return getRuntimePaths().settingsFilePath;
 }
@@ -121,6 +124,13 @@ export function setScheduledTasks(tasks) {
     currentSettings.scheduledTasks = cloneScheduledTasks(tasks);
     return writeSettingsFile(currentSettings);
 }
+export function getScheduledTaskSessionIgnores() {
+    return cloneScheduledTaskSessionIgnores(currentSettings.scheduledTaskSessionIgnores) ?? [];
+}
+export function setScheduledTaskSessionIgnores(ignores) {
+    currentSettings.scheduledTaskSessionIgnores = cloneScheduledTaskSessionIgnores(ignores);
+    return writeSettingsFile(currentSettings);
+}
 export function __resetSettingsForTests() {
     currentSettings = {};
     settingsWriteQueue = Promise.resolve();
@@ -138,6 +148,8 @@ export async function loadSettings() {
     }
     currentSettings = loadedSettings;
     currentSettings.scheduledTasks = cloneScheduledTasks(loadedSettings.scheduledTasks) ?? [];
+    currentSettings.scheduledTaskSessionIgnores =
+        cloneScheduledTaskSessionIgnores(loadedSettings.scheduledTaskSessionIgnores) ?? [];
     if (requiresRewrite) {
         void writeSettingsFile(currentSettings);
     }

package/package.json

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