@grinev/opencode-telegram-bot 0.11.0 → 0.11.2

package/README.md

@@ -35,6 +35,8 @@ Languages: English (`en`), Deutsch (`de`), Español (`es`), Русский (`ru`
 - **Security** — strict user ID whitelist; no one else can access your bot, even if they find it
 - **Localization** — UI localization is supported for multiple languages (`BOT_LOCALE`)
 
+Planned features currently in development are listed in [Current Task List](PRODUCT.md#current-task-list).
+
 ## Prerequisites
 
 - **Node.js 20+** — [download](https://nodejs.org)
@@ -71,7 +73,7 @@ npx @grinev/opencode-telegram-bot
 
 > Quick start is for npm usage. You do not need to clone this repository. If you run this command from the source directory (repository root), it may fail with `opencode-telegram: not found`. To run from sources, use the [Development](#development) section.
 
-On first launch, an interactive wizard will guide you through the configuration — it asks for interface language first, then your bot token, user ID, and OpenCode API URL. After that, you're ready to go. Open your bot in Telegram and start sending tasks.
+On first launch, an interactive wizard will guide you through the configuration — it asks for interface language first, then your bot token, user ID, OpenCode API URL, and optional OpenCode server credentials (username/password). After that, you're ready to go. Open your bot in Telegram and start sending tasks.
 
 #### Alternative: Global Install
 
@@ -100,7 +102,7 @@ opencode-telegram config
 | ----------------- | ------------------------------------------------------- |
 | `/status`         | Server health, current project, session, and model info |
 | `/new`            | Create a new session                                    |
-| `/stop`           | Abort the current task                                  |
+| `/abort`          | Abort the current task                                  |
 | `/sessions`       | Browse and switch between recent sessions               |
 | `/projects`       | Switch between OpenCode projects                        |
 | `/rename`         | Rename the current session                              |

package/dist/app/start-bot-app.js

@@ -4,7 +4,9 @@ import { config } from "../config.js";
 import { loadSettings } from "../settings/manager.js";
 import { processManager } from "../process/manager.js";
 import { warmupSessionDirectoryCache } from "../session/cache-manager.js";
+import { reconcileStoredModelSelection } from "../model/manager.js";
 import { getRuntimeMode } from "../runtime/mode.js";
+import { getRuntimePaths } from "../runtime/paths.js";
 import { logger } from "../utils/logger.js";
 async function getBotVersion() {
     try {
@@ -20,12 +22,15 @@ async function getBotVersion() {
 }
 export async function startBotApp() {
     const mode = getRuntimeMode();
+    const runtimePaths = getRuntimePaths();
     const version = await getBotVersion();
     logger.info(`Starting OpenCode Telegram Bot v${version}...`);
+    logger.info(`Config loaded from ${runtimePaths.envFilePath}`);
     logger.info(`Allowed User ID: ${config.telegram.allowedUserId}`);
     logger.debug(`[Runtime] Application start mode: ${mode}`);
     await loadSettings();
     await processManager.initialize();
+    await reconcileStoredModelSelection();
     await warmupSessionDirectoryCache();
     const bot = createBot();
     const webhookInfo = await bot.api.getWebhookInfo();

package/dist/bot/commands/{stop.js → abort.js}

@@ -6,10 +6,10 @@ import { summaryAggregator } from "../../summary/aggregator.js";
 import { logger } from "../../utils/logger.js";
 import { t } from "../../i18n/index.js";
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-function stopLocalStreaming() {
+function abortLocalStreaming() {
     stopEventListening();
     summaryAggregator.clear();
-    clearAllInteractionState("stop_command");
+    clearAllInteractionState("abort_command");
 }
 async function pollSessionStatus(sessionId, directory, maxWaitMs = 5000) {
     const startedAt = Date.now();
@@ -33,21 +33,34 @@ async function pollSessionStatus(sessionId, directory, maxWaitMs = 5000) {
             await sleep(pollIntervalMs);
         }
         catch (error) {
-            logger.warn("[Stop] Failed to poll session status:", error);
+            logger.warn("[Abort] Failed to poll session status:", error);
             break;
         }
     }
     return "busy";
 }
-export async function stopCommand(ctx) {
+export async function abortCurrentOperation(ctx, options = {}) {
+    const notifyUser = options.notifyUser ?? true;
     try {
-        stopLocalStreaming();
+        abortLocalStreaming();
         const currentSession = getCurrentSession();
         if (!currentSession) {
-            await ctx.reply(t("stop.no_active_session"));
+            if (notifyUser) {
+                await ctx.reply(t("stop.no_active_session"));
+            }
             return;
         }
-        const waitingMessage = await ctx.reply(t("stop.in_progress"));
+        let waitingMessageId = null;
+        let chatId = null;
+        if (notifyUser) {
+            const waitingMessage = await ctx.reply(t("stop.in_progress"));
+            waitingMessageId = waitingMessage.message_id;
+            chatId = ctx.chat?.id ?? null;
+            if (!chatId) {
+                logger.warn("[Abort] Chat context is missing while aborting active session");
+                return;
+            }
+        }
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), 5000);
         try {
@@ -57,35 +70,50 @@ export async function stopCommand(ctx) {
             }, { signal: controller.signal });
             clearTimeout(timeoutId);
             if (abortError) {
-                logger.warn("[Stop] Abort request failed:", abortError);
-                await ctx.api.editMessageText(ctx.chat.id, waitingMessage.message_id, t("stop.warn_unconfirmed"));
+                logger.warn("[Abort] Abort request failed:", abortError);
+                if (notifyUser && chatId !== null && waitingMessageId !== null) {
+                    await ctx.api.editMessageText(chatId, waitingMessageId, t("stop.warn_unconfirmed"));
+                }
                 return;
             }
             if (abortResult !== true) {
-                await ctx.api.editMessageText(ctx.chat.id, waitingMessage.message_id, t("stop.warn_maybe_finished"));
+                if (notifyUser && chatId !== null && waitingMessageId !== null) {
+                    await ctx.api.editMessageText(chatId, waitingMessageId, t("stop.warn_maybe_finished"));
+                }
                 return;
             }
             const finalStatus = await pollSessionStatus(currentSession.id, currentSession.directory, 5000);
             if (finalStatus === "idle" || finalStatus === "not-found") {
-                await ctx.api.editMessageText(ctx.chat.id, waitingMessage.message_id, t("stop.success"));
+                if (notifyUser && chatId !== null && waitingMessageId !== null) {
+                    await ctx.api.editMessageText(chatId, waitingMessageId, t("stop.success"));
+                }
             }
             else {
-                await ctx.api.editMessageText(ctx.chat.id, waitingMessage.message_id, t("stop.warn_still_busy"));
+                if (notifyUser && chatId !== null && waitingMessageId !== null) {
+                    await ctx.api.editMessageText(chatId, waitingMessageId, t("stop.warn_still_busy"));
+                }
             }
         }
         catch (error) {
             clearTimeout(timeoutId);
             if (error instanceof Error && error.name === "AbortError") {
-                await ctx.api.editMessageText(ctx.chat.id, waitingMessage.message_id, t("stop.warn_timeout"));
+                if (notifyUser && chatId !== null && waitingMessageId !== null) {
+                    await ctx.api.editMessageText(chatId, waitingMessageId, t("stop.warn_timeout"));
+                }
             }
             else {
-                logger.error("[Stop] Error while aborting session:", error);
-                await ctx.api.editMessageText(ctx.chat.id, waitingMessage.message_id, t("stop.warn_local_only"));
+                logger.error("[Abort] Error while aborting session:", error);
+                if (notifyUser && chatId !== null && waitingMessageId !== null) {
+                    await ctx.api.editMessageText(chatId, waitingMessageId, t("stop.warn_local_only"));
+                }
             }
         }
     }
     catch (error) {
-        logger.error("[Stop] Unexpected error:", error);
+        logger.error("[Abort] Unexpected error:", error);
         await ctx.reply(t("stop.error"));
     }
 }
+export async function abortCommand(ctx) {
+    await abortCurrentOperation(ctx);
+}

package/dist/bot/commands/definitions.js

@@ -6,7 +6,7 @@ import { t } from "../../i18n/index.js";
 const COMMAND_DEFINITIONS = [
     { command: "status", descriptionKey: "cmd.description.status" },
     { command: "new", descriptionKey: "cmd.description.new" },
-    { command: "stop", descriptionKey: "cmd.description.stop" },
+    { command: "abort", descriptionKey: "cmd.description.stop" },
     { command: "sessions", descriptionKey: "cmd.description.sessions" },
     { command: "projects", descriptionKey: "cmd.description.projects" },
     { command: "rename", descriptionKey: "cmd.description.rename" },

package/dist/bot/commands/start.js

@@ -4,6 +4,9 @@ import { getStoredModel } from "../../model/manager.js";
 import { formatVariantForButton } from "../../variant/manager.js";
 import { pinnedMessageManager } from "../../pinned/manager.js";
 import { keyboardManager } from "../../keyboard/manager.js";
+import { clearSession } from "../../session/manager.js";
+import { clearProject } from "../../settings/manager.js";
+import { abortCurrentOperation } from "./abort.js";
 import { t } from "../../i18n/index.js";
 export async function startCommand(ctx) {
     if (ctx.chat) {
@@ -12,6 +15,11 @@ export async function startCommand(ctx) {
         }
         keyboardManager.initialize(ctx.api, ctx.chat.id);
     }
+    await abortCurrentOperation(ctx, { notifyUser: false });
+    clearSession();
+    clearProject();
+    keyboardManager.clearContext();
+    await pinnedMessageManager.clear();
     if (pinnedMessageManager.getContextLimit() === 0) {
         await pinnedMessageManager.refreshContextLimit();
     }

package/dist/bot/commands/status.js

@@ -4,7 +4,6 @@ import { getCurrentProject } from "../../settings/manager.js";
 import { fetchCurrentAgent } from "../../agent/manager.js";
 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";
@@ -42,7 +41,7 @@ export async function statusCommand(ctx) {
         message += `${t("status.line.mode", { mode: agentDisplay })}\n`;
         // Add model information
         const currentModel = fetchCurrentModel();
-        const modelDisplay = formatModelForDisplay(currentModel.providerID, currentModel.modelID);
+        const modelDisplay = `🤖 ${currentModel.providerID}/${currentModel.modelID}`;
         message += `${t("status.line.model", { model: modelDisplay })}\n`;
         const currentProject = getCurrentProject();
         if (currentProject) {

package/dist/bot/index.js

@@ -16,7 +16,7 @@ import { AGENT_MODE_BUTTON_TEXT_PATTERN, MODEL_BUTTON_TEXT_PATTERN, VARIANT_BUTT
 import { sessionsCommand, handleSessionSelect } from "./commands/sessions.js";
 import { newCommand } from "./commands/new.js";
 import { projectsCommand, handleProjectSelect } from "./commands/projects.js";
-import { stopCommand } from "./commands/stop.js";
+import { abortCommand } from "./commands/abort.js";
 import { opencodeStartCommand } from "./commands/opencode-start.js";
 import { opencodeStopCommand } from "./commands/opencode-stop.js";
 import { renameCommand, handleRenameCancel, handleRenameTextAnswer } from "./commands/rename.js";
@@ -122,7 +122,7 @@ async function ensureCommandsInitialized(ctx, next) {
             },
         });
         commandsInitialized = true;
-        logger.info(`[Bot] Commands initialized for authorized user (chat_id=${ctx.chat.id})`);
+        logger.debug(`[Bot] Commands initialized for authorized user (chat_id=${ctx.chat.id})`);
     }
     catch (err) {
         logger.error("[Bot] Failed to set commands:", err);
@@ -385,7 +385,7 @@ async function ensureEventSubscription(directory) {
 export function createBot() {
     clearAllInteractionState("bot_startup");
     toolMessageBatcher.setIntervalSeconds(config.bot.serviceMessagesIntervalSec);
-    logger.info(`[ToolBatcher] Service messages interval: ${config.bot.serviceMessagesIntervalSec}s`);
+    logger.debug(`[ToolBatcher] Service messages interval: ${config.bot.serviceMessagesIntervalSec}s`);
     const botOptions = {};
     if (config.telegram.proxyUrl) {
         const proxyUrl = config.telegram.proxyUrl;
@@ -456,7 +456,7 @@ export function createBot() {
     bot.command("projects", projectsCommand);
     bot.command("sessions", sessionsCommand);
     bot.command("new", newCommand);
-    bot.command("stop", stopCommand);
+    bot.command("abort", abortCommand);
     bot.command("rename", renameCommand);
     bot.command("commands", commandsCommand);
     bot.on("message:text", unknownCommandMiddleware);
@@ -584,7 +584,7 @@ export function createBot() {
         },
         onSuccess: (result) => {
             if (result.success) {
-                logger.info("[Bot] Cleared global commands (default and all_private_chats scopes)");
+                logger.debug("[Bot] Cleared global commands (default and all_private_chats scopes)");
                 return;
             }
             logger.warn("[Bot] Could not clear global commands:", result.error);

package/dist/config.js

@@ -2,7 +2,7 @@ import dotenv from "dotenv";
 import { getRuntimePaths } from "./runtime/paths.js";
 import { normalizeLocale } from "./i18n/index.js";
 const runtimePaths = getRuntimePaths();
-dotenv.config({ path: runtimePaths.envFilePath });
+dotenv.config({ path: runtimePaths.envFilePath, quiet: true });
 function getEnvVar(key, required = true) {
     const value = process.env[key];
     if (required && !value) {

package/dist/i18n/de.js

@@ -38,11 +38,11 @@ export const de = {
     "bot.creating_session": "🔄 Erstelle eine neue Sitzung...",
     "bot.create_session_error": "🔴 Sitzung konnte nicht erstellt werden. Versuche /new oder prüfe den Serverstatus mit /status.",
     "bot.session_created": "✅ Sitzung erstellt: {title}",
-    "bot.session_busy": "⏳ Agent führt bereits eine Aufgabe aus. Warte auf Abschluss oder nutze /stop, um den aktuellen Lauf zu unterbrechen.",
+    "bot.session_busy": "⏳ Agent führt bereits eine Aufgabe aus. Warte auf Abschluss oder nutze /abort, um den aktuellen Lauf zu unterbrechen.",
     "bot.session_reset_project_mismatch": "⚠️ Die aktive Sitzung passt nicht zum ausgewählten Projekt und wurde daher zurückgesetzt. Nutze /sessions zur Auswahl oder /new, um eine neue Sitzung zu erstellen.",
     "bot.prompt_send_error": "Anfrage konnte nicht an OpenCode gesendet werden.",
     "bot.session_error": "🔴 OpenCode meldete einen Fehler: {message}",
-    "bot.session_retry": "🔁 {message}\n\nDer Provider liefert bei wiederholten Versuchen immer wieder denselben Fehler. Mit /stop abbrechen.",
+    "bot.session_retry": "🔁 {message}\n\nDer Provider liefert bei wiederholten Versuchen immer wieder denselben Fehler. Mit /abort abbrechen.",
     "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)",
@@ -59,18 +59,18 @@ export const de = {
     "status.health.unhealthy": "Nicht OK",
     "status.line.health": "Status: {health}",
     "status.line.version": "Version: {version}",
-    "status.line.managed_yes": "Vom Bot verwaltet: Ja",
-    "status.line.managed_no": "Vom Bot verwaltet: Nein",
+    "status.line.managed_yes": "Vom Bot gestartet: Ja",
+    "status.line.managed_no": "Vom Bot gestartet: Nein",
     "status.line.pid": "PID: {pid}",
     "status.line.uptime_sec": "Betriebszeit: {seconds} s",
     "status.line.mode": "Modus: {mode}",
     "status.line.model": "Modell: {model}",
     "status.agent_not_set": "nicht gesetzt",
-    "status.project_selected": "🏗 Projekt: {project}",
-    "status.project_not_selected": "🏗 Projekt: nicht ausgewählt",
+    "status.project_selected": "Projekt: {project}",
+    "status.project_not_selected": "Projekt: nicht ausgewählt",
     "status.project_hint": "Nutze /projects, um ein Projekt auszuwahlen",
-    "status.session_selected": "📋 Aktuelle Sitzung: {title}",
-    "status.session_not_selected": "📋 Aktuelle Sitzung: nicht ausgewählt",
+    "status.session_selected": "Aktuelle Sitzung: {title}",
+    "status.session_not_selected": "Aktuelle Sitzung: nicht ausgewählt",
     "status.session_hint": "Nutze /sessions zur Auswahl oder /new zum Erstellen",
     "status.server_unavailable": "🔴 OpenCode-Server ist nicht verfügbar\n\nNutze /opencode_start, um den Server zu starten.",
     "projects.empty": "📭 Keine Projekte gefunden.\n\nÖffne ein Verzeichnis in OpenCode und erstelle mindestens eine Sitzung, dann erscheint es hier.",
@@ -105,13 +105,13 @@ export const de = {
     "new.create_error": "🔴 OpenCode-Server ist nicht verfügbar oder beim Erstellen der Sitzung ist ein Fehler aufgetreten.",
     "stop.no_active_session": "🛑 Agent wurde nicht gestartet\n\nErstelle eine Sitzung mit /new oder wähle eine über /sessions aus.",
     "stop.in_progress": "🛑 Event-Stream gestoppt, sende Abbruchsignal...\n\nWarte darauf, dass der Agent stoppt.",
-    "stop.warn_unconfirmed": "⚠️ Event-Stream gestoppt, aber der Server hat den Abbruch nicht bestätigt.\n\nPrüfe /status und versuche /stop in ein paar Sekunden erneut.",
+    "stop.warn_unconfirmed": "⚠️ Event-Stream gestoppt, aber der Server hat den Abbruch nicht bestätigt.\n\nPrüfe /status und versuche /abort in ein paar Sekunden erneut.",
     "stop.warn_maybe_finished": "⚠️ Event-Stream gestoppt, aber der Agent konnte bereits fertig sein.",
     "stop.success": "✅ Agent-Aktion unterbrochen. Von diesem Lauf werden keine weiteren Nachrichten gesendet.",
     "stop.warn_still_busy": "⚠️ Signal gesendet, aber der Agent ist noch beschäftigt.\n\nDer Event-Stream ist bereits deaktiviert, daher werden keine Zwischenmeldungen gesendet.",
-    "stop.warn_timeout": "⚠️ Timeout beim Abbruch.\n\nDer Event-Stream ist bereits deaktiviert, versuche /stop in ein paar Sekunden erneut.",
+    "stop.warn_timeout": "⚠️ Timeout beim Abbruch.\n\nDer Event-Stream ist bereits deaktiviert, versuche /abort in ein paar Sekunden erneut.",
     "stop.warn_local_only": "⚠️ Event-Stream lokal gestoppt, aber serverseitiger Abbruch ist fehlgeschlagen.",
-    "stop.error": "🔴 Aktion konnte nicht gestoppt werden.\n\nEvent-Stream ist gestoppt, versuche /stop erneut.",
+    "stop.error": "🔴 Aktion konnte nicht gestoppt werden.\n\nEvent-Stream ist gestoppt, versuche /abort erneut.",
     "opencode_start.already_running_managed": "⚠️ OpenCode-Server läuft bereits\n\nPID: {pid}\nBetriebszeit: {seconds} Sekunden",
     "opencode_start.already_running_external": "✅ OpenCode-Server läuft bereits als externer Prozess\n\nVersion: {version}\n\nDieser Server wurde nicht vom Bot gestartet, daher kann /opencode-stop ihn nicht stoppen.",
     "opencode_start.starting": "🔄 Starte OpenCode-Server...",
@@ -228,6 +228,8 @@ export const de = {
     "runtime.wizard.ask_user_id": "Gib deine Telegram User ID ein (du bekommst sie bei @userinfobot).\n> ",
     "runtime.wizard.user_id_invalid": "Gib eine positive ganze Zahl ein (> 0).\n",
     "runtime.wizard.ask_api_url": "OpenCode API URL eingeben (optional).\nEnter drücken für Standard: {defaultUrl}\n> ",
+    "runtime.wizard.ask_server_username": "OpenCode-Server-Benutzername eingeben (optional).\nEnter drücken für Standard: {defaultUsername}\n> ",
+    "runtime.wizard.ask_server_password": "OpenCode-Server-Passwort eingeben (optional).\nEnter drücken, um es leer zu lassen.\n> ",
     "runtime.wizard.api_url_invalid": "Gib eine gültige URL (http/https) ein oder drücke Enter für Standard.\n",
     "runtime.wizard.start": "OpenCode Telegram Bot Einrichtung.\n",
     "runtime.wizard.saved": "Konfiguration gespeichert:\n- {envPath}\n- {settingsPath}\n",

package/dist/i18n/en.js

@@ -38,11 +38,11 @@ export const en = {
     "bot.creating_session": "🔄 Creating a new session...",
     "bot.create_session_error": "🔴 Failed to create session. Try /new or check server status with /status.",
     "bot.session_created": "✅ Session created: {title}",
-    "bot.session_busy": "⏳ Agent is already running a task. Wait for completion or use /stop to interrupt current run.",
+    "bot.session_busy": "⏳ Agent is already running a task. Wait for completion or use /abort to interrupt current run.",
     "bot.session_reset_project_mismatch": "⚠️ Active session does not match the selected project, so it was reset. Use /sessions to pick one or /new to create a new session.",
     "bot.prompt_send_error": "Failed to send request to OpenCode.",
     "bot.session_error": "🔴 OpenCode returned an error: {message}",
-    "bot.session_retry": "🔁 {message}\n\nProvider keeps returning the same error on repeated retries. Use /stop to abort.",
+    "bot.session_retry": "🔁 {message}\n\nProvider keeps returning the same error on repeated retries. Use /abort to abort.",
     "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)",
@@ -59,18 +59,18 @@ export const en = {
     "status.health.unhealthy": "Unhealthy",
     "status.line.health": "Status: {health}",
     "status.line.version": "Version: {version}",
-    "status.line.managed_yes": "Managed by bot: Yes",
-    "status.line.managed_no": "Managed by bot: No",
+    "status.line.managed_yes": "Started by bot: Yes",
+    "status.line.managed_no": "Started by bot: No",
     "status.line.pid": "PID: {pid}",
     "status.line.uptime_sec": "Uptime: {seconds} sec",
     "status.line.mode": "Mode: {mode}",
     "status.line.model": "Model: {model}",
     "status.agent_not_set": "not set",
-    "status.project_selected": "🏗 Project: {project}",
-    "status.project_not_selected": "🏗 Project: not selected",
+    "status.project_selected": "Project: {project}",
+    "status.project_not_selected": "Project: not selected",
     "status.project_hint": "Use /projects to select a project",
-    "status.session_selected": "📋 Current session: {title}",
-    "status.session_not_selected": "📋 Current session: not selected",
+    "status.session_selected": "Current session: {title}",
+    "status.session_not_selected": "Current session: not selected",
     "status.session_hint": "Use /sessions to select one or /new to create one",
     "status.server_unavailable": "🔴 OpenCode Server is unavailable\n\nUse /opencode_start to start the server.",
     "projects.empty": "📭 No projects found.\n\nOpen a directory in OpenCode and create at least one session, then it will appear here.",
@@ -105,13 +105,13 @@ export const en = {
     "new.create_error": "🔴 OpenCode Server is unavailable or an error occurred while creating session.",
     "stop.no_active_session": "🛑 Agent was not started\n\nCreate a session with /new or select one via /sessions.",
     "stop.in_progress": "🛑 Event stream stopped, sending abort signal...\n\nWaiting for agent to stop.",
-    "stop.warn_unconfirmed": "⚠️ Event stream stopped, but server did not confirm abort.\n\nCheck /status and retry /stop in a few seconds.",
+    "stop.warn_unconfirmed": "⚠️ Event stream stopped, but server did not confirm abort.\n\nCheck /status and retry /abort in a few seconds.",
     "stop.warn_maybe_finished": "⚠️ Event stream stopped, but the agent may have already finished.",
     "stop.success": "✅ Agent action interrupted. No more messages from this run will be sent.",
     "stop.warn_still_busy": "⚠️ Signal sent, but agent is still busy.\n\nEvent stream is already disabled, so no intermediate messages will be sent.",
-    "stop.warn_timeout": "⚠️ Abort request timeout.\n\nEvent stream is already disabled, retry /stop in a few seconds.",
+    "stop.warn_timeout": "⚠️ Abort request timeout.\n\nEvent stream is already disabled, retry /abort in a few seconds.",
     "stop.warn_local_only": "⚠️ Event stream stopped locally, but server-side abort failed.",
-    "stop.error": "🔴 Failed to stop action.\n\nEvent stream is stopped, try /stop again.",
+    "stop.error": "🔴 Failed to stop action.\n\nEvent stream is stopped, try /abort again.",
     "opencode_start.already_running_managed": "⚠️ OpenCode Server is already running\n\nPID: {pid}\nUptime: {seconds} seconds",
     "opencode_start.already_running_external": "✅ OpenCode Server is already running as an external process\n\nVersion: {version}\n\nThis server was not started by bot, so /opencode-stop cannot stop it.",
     "opencode_start.starting": "🔄 Starting OpenCode Server...",
@@ -228,6 +228,8 @@ export const en = {
     "runtime.wizard.ask_user_id": "Enter your Telegram User ID (you can get it from @userinfobot).\n> ",
     "runtime.wizard.user_id_invalid": "Enter a positive integer (> 0).\n",
     "runtime.wizard.ask_api_url": "Enter OpenCode API URL (optional).\nPress Enter to use default: {defaultUrl}\n> ",
+    "runtime.wizard.ask_server_username": "Enter OpenCode server username (optional).\nPress Enter to use default: {defaultUsername}\n> ",
+    "runtime.wizard.ask_server_password": "Enter OpenCode server password (optional).\nPress Enter to keep it empty.\n> ",
     "runtime.wizard.api_url_invalid": "Enter a valid URL (http/https) or press Enter for default.\n",
     "runtime.wizard.start": "OpenCode Telegram Bot setup.\n",
     "runtime.wizard.saved": "Configuration saved:\n- {envPath}\n- {settingsPath}\n",

package/dist/i18n/es.js

@@ -38,11 +38,11 @@ export const es = {
     "bot.creating_session": "🔄 Creando una sesión nueva...",
     "bot.create_session_error": "🔴 No se pudo crear la sesión. Prueba /new o revisa el estado del servidor con /status.",
     "bot.session_created": "✅ Sesión creada: {title}",
-    "bot.session_busy": "⏳ El agente ya está ejecutando una tarea. Espera a que termine o usa /stop para interrumpir la ejecución actual.",
+    "bot.session_busy": "⏳ El agente ya está ejecutando una tarea. Espera a que termine o usa /abort para interrumpir la ejecución actual.",
     "bot.session_reset_project_mismatch": "⚠️ La sesión activa no coincide con el proyecto seleccionado, así que se reinició. Usa /sessions para elegir una o /new para crear una nueva.",
     "bot.prompt_send_error": "No se pudo enviar la solicitud a OpenCode.",
     "bot.session_error": "🔴 OpenCode devolvió un error: {message}",
-    "bot.session_retry": "🔁 {message}\n\nEl proveedor devuelve el mismo error en intentos repetidos. Usa /stop para detenerlo.",
+    "bot.session_retry": "🔁 {message}\n\nEl proveedor devuelve el mismo error en intentos repetidos. Usa /abort para detenerlo.",
     "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)",
@@ -59,18 +59,18 @@ export const es = {
     "status.health.unhealthy": "No saludable",
     "status.line.health": "Estado: {health}",
     "status.line.version": "Versión: {version}",
-    "status.line.managed_yes": "Administrado por el bot: Sí",
-    "status.line.managed_no": "Administrado por el bot: No",
+    "status.line.managed_yes": "Iniciado por el bot: Sí",
+    "status.line.managed_no": "Iniciado por el bot: No",
     "status.line.pid": "PID: {pid}",
     "status.line.uptime_sec": "Tiempo activo: {seconds} s",
     "status.line.mode": "Modo: {mode}",
     "status.line.model": "Modelo: {model}",
     "status.agent_not_set": "no configurado",
-    "status.project_selected": "🏗 Proyecto: {project}",
-    "status.project_not_selected": "🏗 Proyecto: no seleccionado",
+    "status.project_selected": "Proyecto: {project}",
+    "status.project_not_selected": "Proyecto: no seleccionado",
     "status.project_hint": "Usa /projects para seleccionar un proyecto",
-    "status.session_selected": "📋 Sesión actual: {title}",
-    "status.session_not_selected": "📋 Sesión actual: no seleccionada",
+    "status.session_selected": "Sesión actual: {title}",
+    "status.session_not_selected": "Sesión actual: no seleccionada",
     "status.session_hint": "Usa /sessions para elegir una o /new para crear una",
     "status.server_unavailable": "🔴 OpenCode Server no está disponible\n\nUsa /opencode_start para iniciar el servidor.",
     "projects.empty": "📭 No se encontraron proyectos.\n\nAbre un directorio en OpenCode y crea al menos una sesión; entonces aparecerá aquí.",
@@ -105,13 +105,13 @@ export const es = {
     "new.create_error": "🔴 OpenCode Server no está disponible u ocurrió un error al crear la sesión.",
     "stop.no_active_session": "🛑 El agente no se inició\n\nCrea una sesión con /new o selecciona una con /sessions.",
     "stop.in_progress": "🛑 Flujo de eventos detenido; enviando señal de aborto...\n\nEsperando a que el agente se detenga.",
-    "stop.warn_unconfirmed": "⚠️ Flujo de eventos detenido, pero el servidor no confirmó el aborto.\n\nRevisa /status y vuelve a intentar /stop en unos segundos.",
+    "stop.warn_unconfirmed": "⚠️ Flujo de eventos detenido, pero el servidor no confirmó el aborto.\n\nRevisa /status y vuelve a intentar /abort en unos segundos.",
     "stop.warn_maybe_finished": "⚠️ Flujo de eventos detenido, pero el agente podría haber terminado ya.",
     "stop.success": "✅ Acción del agente interrumpida. No se enviarán más mensajes de esta ejecución.",
     "stop.warn_still_busy": "⚠️ Señal enviada, pero el agente sigue ocupado.\n\nEl flujo de eventos ya está deshabilitado, así que no se enviarán mensajes intermedios.",
-    "stop.warn_timeout": "⚠️ Tiempo de espera agotado al solicitar el aborto.\n\nEl flujo de eventos ya está deshabilitado; vuelve a intentar /stop en unos segundos.",
+    "stop.warn_timeout": "⚠️ Tiempo de espera agotado al solicitar el aborto.\n\nEl flujo de eventos ya está deshabilitado; vuelve a intentar /abort en unos segundos.",
     "stop.warn_local_only": "⚠️ Flujo de eventos detenido localmente, pero el aborto en el servidor falló.",
-    "stop.error": "🔴 No se pudo detener la acción.\n\nEl flujo de eventos está detenido; prueba /stop otra vez.",
+    "stop.error": "🔴 No se pudo detener la acción.\n\nEl flujo de eventos está detenido; prueba /abort otra vez.",
     "opencode_start.already_running_managed": "⚠️ OpenCode Server ya está en ejecución\n\nPID: {pid}\nTiempo activo: {seconds} segundos",
     "opencode_start.already_running_external": "✅ OpenCode Server ya está en ejecución como un proceso externo\n\nVersión: {version}\n\nEste servidor no fue iniciado por el bot, por lo que /opencode-stop no puede detenerlo.",
     "opencode_start.starting": "🔄 Iniciando OpenCode Server...",
@@ -228,6 +228,8 @@ export const es = {
     "runtime.wizard.ask_user_id": "Introduce tu Telegram User ID (puedes obtenerlo de @userinfobot).\n> ",
     "runtime.wizard.user_id_invalid": "Introduce un entero positivo (> 0).\n",
     "runtime.wizard.ask_api_url": "Introduce la URL de la API de OpenCode (opcional).\nPulsa Enter para usar el valor por defecto: {defaultUrl}\n> ",
+    "runtime.wizard.ask_server_username": "Introduce el nombre de usuario del servidor OpenCode (opcional).\nPulsa Enter para usar el valor por defecto: {defaultUsername}\n> ",
+    "runtime.wizard.ask_server_password": "Introduce la contrasena del servidor OpenCode (opcional).\nPulsa Enter para dejarla vacia.\n> ",
     "runtime.wizard.api_url_invalid": "Introduce una URL válida (http/https) o pulsa Enter para usar el valor por defecto.\n",
     "runtime.wizard.start": "Configuración de OpenCode Telegram Bot.\n",
     "runtime.wizard.saved": "Configuración guardada:\n- {envPath}\n- {settingsPath}\n",

package/dist/i18n/ru.js

@@ -38,11 +38,11 @@ export const ru = {
     "bot.creating_session": "🔄 Создаю новую сессию...",
     "bot.create_session_error": "🔴 Не удалось создать сессию. Попробуйте команду /new или проверьте статус сервера /status.",
     "bot.session_created": "✅ Сессия создана: {title}",
-    "bot.session_busy": "⏳ Агент уже выполняет задачу. Дождитесь завершения или используйте /stop, чтобы прервать текущий запуск.",
+    "bot.session_busy": "⏳ Агент уже выполняет задачу. Дождитесь завершения или используйте /abort, чтобы прервать текущий запуск.",
     "bot.session_reset_project_mismatch": "⚠️ Активная сессия не соответствует выбранному проекту, поэтому была сброшена. Используйте /sessions для выбора или /new для создания новой сессии.",
     "bot.prompt_send_error": "Не удалось отправить запрос в OpenCode.",
     "bot.session_error": "🔴 OpenCode вернул ошибку: {message}",
-    "bot.session_retry": "🔁 {message}\n\nПровайдер возвращает одну и ту же ошибку при повторных запросах. Используйте /stop для остановки.",
+    "bot.session_retry": "🔁 {message}\n\nПровайдер возвращает одну и ту же ошибку при повторных запросах. Используйте /abort для остановки.",
     "bot.unknown_command": "⚠️ Неизвестная команда: {command}. Используйте /help для списка команд.",
     "bot.photo_downloading": "⏳ Скачиваю фото...",
     "bot.photo_too_large": "⚠️ Фото слишком большое (макс. {maxSizeMb}МБ)",
@@ -59,18 +59,18 @@ export const ru = {
     "status.health.unhealthy": "Unhealthy",
     "status.line.health": "Статус: {health}",
     "status.line.version": "Версия: {version}",
-    "status.line.managed_yes": "Управляется ботом: Да",
-    "status.line.managed_no": "Управляется ботом: Нет",
+    "status.line.managed_yes": "Запущен ботом: Да",
+    "status.line.managed_no": "Запущен ботом: Нет",
     "status.line.pid": "PID: {pid}",
     "status.line.uptime_sec": "Uptime: {seconds} сек",
     "status.line.mode": "Режим: {mode}",
     "status.line.model": "Модель: {model}",
     "status.agent_not_set": "не установлен",
-    "status.project_selected": "🏗 Проект: {project}",
-    "status.project_not_selected": "🏗 Проект: не выбран",
+    "status.project_selected": "Проект: {project}",
+    "status.project_not_selected": "Проект: не выбран",
     "status.project_hint": "Используйте /projects для выбора проекта",
-    "status.session_selected": "📋 Текущая сессия: {title}",
-    "status.session_not_selected": "📋 Текущая сессия: не выбрана",
+    "status.session_selected": "Текущая сессия: {title}",
+    "status.session_not_selected": "Текущая сессия: не выбрана",
     "status.session_hint": "Используйте /sessions для выбора или /new для создания",
     "status.server_unavailable": "🔴 OpenCode Server недоступен\n\nИспользуйте /opencode_start для запуска сервера.",
     "projects.empty": "📭 Проектов нет.\n\nОткройте директорию в OpenCode и создайте хотя бы одну сессию, после этого она появится здесь.",
@@ -105,13 +105,13 @@ export const ru = {
     "new.create_error": "🔴 OpenCode Server недоступен или произошла ошибка при создании сессии.",
     "stop.no_active_session": "🛑 Агент не был запущен\n\nСначала создайте сессию командой /new или выберите существующую через /sessions.",
     "stop.in_progress": "🛑 Отключил поток событий и отправляю сигнал прерывания...\n\nОжидание остановки агента.",
-    "stop.warn_unconfirmed": "⚠️ Поток событий остановлен, но сервер не подтвердил прерывание.\n\nПроверьте /status и повторите /stop через пару секунд.",
+    "stop.warn_unconfirmed": "⚠️ Поток событий остановлен, но сервер не подтвердил прерывание.\n\nПроверьте /status и повторите /abort через пару секунд.",
     "stop.warn_maybe_finished": "⚠️ Поток событий остановлен, но агент мог уже завершиться к моменту запроса.",
     "stop.success": "✅ Действие агента прервано. Новые сообщения от текущего запуска больше не придут.",
     "stop.warn_still_busy": "⚠️ Сигнал отправлен, но агент еще busy.\n\nПоток событий уже отключен, поэтому бот не будет присылать промежуточные сообщения.",
-    "stop.warn_timeout": "⚠️ Таймаут запроса на прерывание.\n\nПоток событий уже отключен, повторите /stop через пару секунд.",
+    "stop.warn_timeout": "⚠️ Таймаут запроса на прерывание.\n\nПоток событий уже отключен, повторите /abort через пару секунд.",
     "stop.warn_local_only": "⚠️ Поток событий остановлен локально, но при прерывании на сервере произошла ошибка.",
-    "stop.error": "🔴 Ошибка при прерывании действия.\n\nПоток событий остановлен, попробуйте /stop еще раз.",
+    "stop.error": "🔴 Ошибка при прерывании действия.\n\nПоток событий остановлен, попробуйте /abort еще раз.",
     "opencode_start.already_running_managed": "⚠️ OpenCode Server уже запущен\n\nPID: {pid}\nUptime: {seconds} секунд",
     "opencode_start.already_running_external": "✅ OpenCode Server уже запущен внешним процессом\n\nВерсия: {version}\n\nЭтот сервер не был запущен через бота, поэтому команда /opencode-stop не сможет его остановить.",
     "opencode_start.starting": "🔄 Запускаю OpenCode Server...",
@@ -208,14 +208,14 @@ export const ru = {
     "keyboard.variant": "💭 {name}",
     "keyboard.variant_default": "💡 Default",
     "keyboard.updated": "⌨️ Клавиатура обновлена",
-    "pinned.default_session_title": "new session",
-    "pinned.unknown": "Unknown",
-    "pinned.line.project": "Project: {project}",
-    "pinned.line.model": "Model: {model}",
-    "pinned.line.context": "Context: {used} / {limit} ({percent}%)",
-    "pinned.files.title": "Files ({count}):",
+    "pinned.default_session_title": "новая сессия",
+    "pinned.unknown": "Неизвестно",
+    "pinned.line.project": "Проект: {project}",
+    "pinned.line.model": "Модель: {model}",
+    "pinned.line.context": "Контекст: {used} / {limit} ({percent}%)",
+    "pinned.files.title": "Файлы ({count}):",
     "pinned.files.item": "  {path}{diff}",
-    "pinned.files.more": "  ... and {count} more",
+    "pinned.files.more": "  ... и еще {count}",
     "tool.todo.overflow": "*(ещё {count} задач)*",
     "tool.file_header.write": "Write File/Path: {path}\n============================================================\n\n",
     "tool.file_header.edit": "Edit File/Path: {path}\n============================================================\n\n",
@@ -228,6 +228,8 @@ export const ru = {
     "runtime.wizard.ask_user_id": "Введите ваш Telegram User ID (можно узнать у @userinfobot).\n> ",
     "runtime.wizard.user_id_invalid": "Введите положительное целое число (> 0).\n",
     "runtime.wizard.ask_api_url": "Введите URL OpenCode API (опционально).\nНажмите Enter для значения по умолчанию: {defaultUrl}\n> ",
+    "runtime.wizard.ask_server_username": "Введите логин OpenCode сервера (опционально).\nНажмите Enter для значения по умолчанию: {defaultUsername}\n> ",
+    "runtime.wizard.ask_server_password": "Введите пароль OpenCode сервера (опционально).\nНажмите Enter, чтобы оставить пустым.\n> ",
     "runtime.wizard.api_url_invalid": "Введите корректный URL (http/https) или нажмите Enter для значения по умолчанию.\n",
     "runtime.wizard.start": "Настройка OpenCode Telegram Bot.\n",
     "runtime.wizard.saved": "Конфигурация сохранена:\n- {envPath}\n- {settingsPath}\n",

package/dist/i18n/zh.js

@@ -38,11 +38,11 @@ export const zh = {
     "bot.creating_session": "🔄 正在创建新会话...",
     "bot.create_session_error": "🔴 创建会话失败。请重试 /new，或使用 /status 检查服务器状态。",
     "bot.session_created": "✅ 会话已创建：{title}",
-    "bot.session_busy": "⏳ 代理正在执行任务。请等待完成，或使用 /stop 中断当前运行。",
+    "bot.session_busy": "⏳ 代理正在执行任务。请等待完成，或使用 /abort 中断当前运行。",
     "bot.session_reset_project_mismatch": "⚠️ 活动会话与所选项目不匹配，因此已重置。使用 /sessions 选择一个会话，或 /new 创建新会话。",
     "bot.prompt_send_error": "向 OpenCode 发送请求失败。",
     "bot.session_error": "🔴 OpenCode 返回错误：{message}",
-    "bot.session_retry": "🔁 {message}\n\n提供方在重复重试时持续返回同一错误。使用 /stop 可停止。",
+    "bot.session_retry": "🔁 {message}\n\n提供方在重复重试时持续返回同一错误。使用 /abort 可停止。",
     "bot.unknown_command": "⚠️ 未知命令：{command}。使用 /help 查看可用命令。",
     "bot.photo_downloading": "⏳ 正在下载照片...",
     "bot.photo_too_large": "⚠️ 照片过大（最大 {maxSizeMb}MB）",
@@ -59,18 +59,18 @@ export const zh = {
     "status.health.unhealthy": "不健康",
     "status.line.health": "状态：{health}",
     "status.line.version": "版本：{version}",
-    "status.line.managed_yes": "由机器人管理：是",
-    "status.line.managed_no": "由机器人管理：否",
+    "status.line.managed_yes": "由机器人启动：是",
+    "status.line.managed_no": "由机器人启动：否",
     "status.line.pid": "PID：{pid}",
     "status.line.uptime_sec": "运行时间：{seconds} 秒",
     "status.line.mode": "模式：{mode}",
     "status.line.model": "模型：{model}",
     "status.agent_not_set": "未设置",
-    "status.project_selected": "🏗 项目：{project}",
-    "status.project_not_selected": "🏗 项目：未选择",
+    "status.project_selected": "项目：{project}",
+    "status.project_not_selected": "项目：未选择",
     "status.project_hint": "使用 /projects 选择项目",
-    "status.session_selected": "📋 当前会话：{title}",
-    "status.session_not_selected": "📋 当前会话：未选择",
+    "status.session_selected": "当前会话：{title}",
+    "status.session_not_selected": "当前会话：未选择",
     "status.session_hint": "使用 /sessions 选择一个会话，或 /new 创建",
     "status.server_unavailable": "🔴 OpenCode 服务器不可用\n\n使用 /opencode_start 启动服务器。",
     "projects.empty": "📭 未找到项目。\n\n在 OpenCode 中打开一个目录并至少创建一个会话，然后它会出现在这里。",
@@ -105,13 +105,13 @@ export const zh = {
     "new.create_error": "🔴 OpenCode 服务器不可用，或创建会话时发生错误。",
     "stop.no_active_session": "🛑 代理尚未启动\n\n使用 /new 创建会话，或通过 /sessions 选择一个。",
     "stop.in_progress": "🛑 已停止事件流，正在发送中止信号...\n\n等待代理停止。",
-    "stop.warn_unconfirmed": "⚠️ 事件流已停止，但服务器未确认中止。\n\n检查 /status，并在几秒后重试 /stop。",
+    "stop.warn_unconfirmed": "⚠️ 事件流已停止，但服务器未确认中止。\n\n检查 /status，并在几秒后重试 /abort。",
     "stop.warn_maybe_finished": "⚠️ 事件流已停止，但代理可能已完成。",
     "stop.success": "✅ 代理操作已中断。本次运行的后续消息将不再发送。",
     "stop.warn_still_busy": "⚠️ 信号已发送，但代理仍在忙。\n\n事件流已禁用，因此不会发送中间消息。",
-    "stop.warn_timeout": "⚠️ 中止请求超时。\n\n事件流已禁用，请在几秒后重试 /stop。",
+    "stop.warn_timeout": "⚠️ 中止请求超时。\n\n事件流已禁用，请在几秒后重试 /abort。",
     "stop.warn_local_only": "⚠️ 已在本地停止事件流，但服务器端中止失败。",
-    "stop.error": "🔴 停止操作失败。\n\n事件流已停止，请再次尝试 /stop。",
+    "stop.error": "🔴 停止操作失败。\n\n事件流已停止，请再次尝试 /abort。",
     "opencode_start.already_running_managed": "⚠️ OpenCode 服务器已在运行\n\nPID：{pid}\n运行时间：{seconds} 秒",
     "opencode_start.already_running_external": "✅ OpenCode 服务器正作为外部进程运行\n\n版本：{version}\n\n该服务器不是由机器人启动，因此 /opencode-stop 无法停止它。",
     "opencode_start.starting": "🔄 正在启动 OpenCode 服务器...",
@@ -228,6 +228,8 @@ export const zh = {
     "runtime.wizard.ask_user_id": "请输入你的 Telegram User ID（可从 @userinfobot 获取）。\n> ",
     "runtime.wizard.user_id_invalid": "请输入一个正整数（> 0）。\n",
     "runtime.wizard.ask_api_url": "请输入 OpenCode API URL（可选）。\n按 Enter 使用默认值：{defaultUrl}\n> ",
+    "runtime.wizard.ask_server_username": "请输入 OpenCode 服务器用户名（可选）。\n按 Enter 使用默认值：{defaultUsername}\n> ",
+    "runtime.wizard.ask_server_password": "请输入 OpenCode 服务器密码（可选）。\n按 Enter 保持为空。\n> ",
     "runtime.wizard.api_url_invalid": "请输入有效 URL（http/https），或按 Enter 使用默认值。\n",
     "runtime.wizard.start": "OpenCode Telegram Bot 设置。\n",
     "runtime.wizard.saved": "配置已保存：\n- {envPath}\n- {settingsPath}\n",

package/dist/interaction/guard.js

@@ -73,6 +73,9 @@ export function resolveInteractionGuardDecision(ctx) {
         return createBlockDecision(inputType, state, "expired", command);
     }
     if (inputType === "command") {
+        if (command === "/start") {
+            return createAllowDecision(inputType, state, command);
+        }
         if (command && state.allowedCommands.includes(command)) {
             return createAllowDecision(inputType, state, command);
         }

package/dist/interaction/manager.js

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

package/dist/model/manager.js

@@ -1,7 +1,15 @@
 import { getCurrentModel, setCurrentModel } from "../settings/manager.js";
 import { config } from "../config.js";
+import { opencodeClient } from "../opencode/client.js";
 import { logger } from "../utils/logger.js";
 import path from "node:path";
+const MODEL_CATALOG_CACHE_TTL_MS = 10 * 60 * 1000;
+let cachedValidModelKeys = null;
+let modelCatalogCacheExpiresAt = 0;
+let modelCatalogFetchInFlight = null;
+function getModelKey(providerID, modelID) {
+    return `${providerID}/${modelID}`;
+}
 function getEnvDefaultModel() {
     const providerID = config.opencode.model.provider;
     const modelID = config.opencode.model.modelId;
@@ -20,6 +28,58 @@ function dedupeModels(models) {
     }
     return Array.from(unique.values());
 }
+function filterModelsByCatalog(models, validModelKeys) {
+    if (!validModelKeys) {
+        return models;
+    }
+    return models.filter((model) => validModelKeys.has(getModelKey(model.providerID, model.modelID)));
+}
+async function getValidModelKeys() {
+    if (cachedValidModelKeys && Date.now() < modelCatalogCacheExpiresAt) {
+        logger.debug(`[ModelManager] Model catalog cache hit: models=${cachedValidModelKeys.size}, ttlMs=${modelCatalogCacheExpiresAt - Date.now()}`);
+        return cachedValidModelKeys;
+    }
+    if (modelCatalogFetchInFlight) {
+        logger.debug("[ModelManager] Awaiting in-flight model catalog refresh");
+        return modelCatalogFetchInFlight;
+    }
+    modelCatalogFetchInFlight = (async () => {
+        try {
+            logger.debug("[ModelManager] Refreshing model catalog from OpenCode API");
+            const response = await opencodeClient.config.providers();
+            if (response.error || !response.data) {
+                logger.warn("[ModelManager] Failed to refresh model catalog:", response.error);
+                if (cachedValidModelKeys) {
+                    logger.warn("[ModelManager] Using stale model catalog cache after refresh failure");
+                    return cachedValidModelKeys;
+                }
+                return null;
+            }
+            const validModelKeys = new Set();
+            for (const provider of response.data.providers) {
+                for (const modelID of Object.keys(provider.models)) {
+                    validModelKeys.add(getModelKey(provider.id, modelID));
+                }
+            }
+            cachedValidModelKeys = validModelKeys;
+            modelCatalogCacheExpiresAt = Date.now() + MODEL_CATALOG_CACHE_TTL_MS;
+            logger.debug(`[ModelManager] Model catalog refreshed: providers=${response.data.providers.length}, models=${validModelKeys.size}`);
+            return cachedValidModelKeys;
+        }
+        catch (err) {
+            logger.warn("[ModelManager] Error refreshing model catalog:", err);
+            if (cachedValidModelKeys) {
+                logger.warn("[ModelManager] Using stale model catalog cache after refresh exception");
+                return cachedValidModelKeys;
+            }
+            return null;
+        }
+        finally {
+            modelCatalogFetchInFlight = null;
+        }
+    })();
+    return modelCatalogFetchInFlight;
+}
 function normalizeFavoriteModels(state) {
     if (!Array.isArray(state.favorite)) {
         return [];
@@ -68,17 +128,27 @@ export async function getModelSelectionLists() {
         const content = await fs.readFile(stateFilePath, "utf-8");
         const state = JSON.parse(content);
         const rawFavorites = normalizeFavoriteModels(state);
+        const rawRecent = normalizeRecentModels(state);
+        const shouldValidateWithCatalog = rawFavorites.length > 0 || rawRecent.length > 0;
+        const validModelKeys = shouldValidateWithCatalog ? await getValidModelKeys() : null;
+        const validatedFavorites = filterModelsByCatalog(rawFavorites, validModelKeys);
+        const validatedRecent = filterModelsByCatalog(rawRecent, validModelKeys);
         const favorites = envDefaultModel
-            ? dedupeModels([...rawFavorites, envDefaultModel])
-            : rawFavorites;
+            ? dedupeModels([...validatedFavorites, envDefaultModel])
+            : validatedFavorites;
         if (rawFavorites.length === 0 && envDefaultModel) {
             logger.info(`[ModelManager] No favorites in ${stateFilePath}, using config model as favorite`);
         }
         if (favorites.length === 0) {
             logger.warn(`[ModelManager] No favorites in ${stateFilePath}`);
         }
-        const favoriteKeys = new Set(favorites.map((model) => `${model.providerID}/${model.modelID}`));
-        const recent = dedupeModels(normalizeRecentModels(state)).filter((model) => !favoriteKeys.has(`${model.providerID}/${model.modelID}`));
+        const filteredOutFavorites = rawFavorites.length - validatedFavorites.length;
+        const filteredOutRecent = rawRecent.length - validatedRecent.length;
+        if (filteredOutFavorites > 0 || filteredOutRecent > 0) {
+            logger.info(`[ModelManager] Filtered unavailable models from OpenCode state: favoritesRemoved=${filteredOutFavorites}, recentRemoved=${filteredOutRecent}`);
+        }
+        const favoriteKeys = new Set(favorites.map((model) => getModelKey(model.providerID, model.modelID)));
+        const recent = dedupeModels(validatedRecent).filter((model) => !favoriteKeys.has(getModelKey(model.providerID, model.modelID)));
         logger.debug(`[ModelManager] Loaded model selection lists from ${stateFilePath}: favorites=${favorites.length}, recent=${recent.length}`);
         return { favorites, recent };
     }
@@ -97,6 +167,42 @@ export async function getModelSelectionLists() {
         };
     }
 }
+/**
+ * Validate stored selected model against OpenCode providers catalog.
+ * If selected model is unavailable, fallback to env default model.
+ */
+export async function reconcileStoredModelSelection() {
+    const currentModel = getCurrentModel();
+    if (!currentModel?.providerID || !currentModel.modelID) {
+        return;
+    }
+    const validModelKeys = await getValidModelKeys();
+    if (!validModelKeys) {
+        logger.warn("[ModelManager] Skipping stored model validation: model catalog unavailable");
+        return;
+    }
+    const currentModelKey = getModelKey(currentModel.providerID, currentModel.modelID);
+    if (validModelKeys.has(currentModelKey)) {
+        return;
+    }
+    const envDefaultModel = getEnvDefaultModel();
+    if (!envDefaultModel) {
+        logger.warn(`[ModelManager] Stored model ${currentModelKey} is unavailable and env default model is missing`);
+        return;
+    }
+    const fallbackKey = getModelKey(envDefaultModel.providerID, envDefaultModel.modelID);
+    logger.warn(`[ModelManager] Stored model ${currentModelKey} is unavailable, falling back to ${fallbackKey}`);
+    setCurrentModel({
+        providerID: envDefaultModel.providerID,
+        modelID: envDefaultModel.modelID,
+        variant: "default",
+    });
+}
+export function __resetModelCatalogCacheForTests() {
+    cachedValidModelKeys = null;
+    modelCatalogCacheExpiresAt = 0;
+    modelCatalogFetchInFlight = null;
+}
 /**
  * Get list of favorite models from OpenCode local state file
  * Falls back to env default model if file is unavailable or empty

package/dist/pinned/manager.js

@@ -128,7 +128,7 @@ class PinnedMessageManager {
      */
     async onMessageComplete(tokens) {
         // Ensure context limit is available even if session was restored
-        // without a fresh onSessionChange call (for example after /stop + continue).
+        // without a fresh onSessionChange call (for example after /abort + continue).
         if (this.getContextLimit() === 0) {
             await this.fetchContextLimit();
         }

package/dist/runtime/bootstrap.js

@@ -7,6 +7,7 @@ import dotenv from "dotenv";
 import { getRuntimePaths } from "./paths.js";
 import { getLocale, getLocaleOptions, resolveSupportedLocale, setRuntimeLocale, t, } from "../i18n/index.js";
 const DEFAULT_API_URL = "http://localhost:4096";
+const DEFAULT_SERVER_USERNAME = "opencode";
 const FALLBACK_MODEL_PROVIDER = "opencode";
 const FALLBACK_MODEL_ID = "big-pickle";
 function isPositiveInteger(value) {
@@ -64,6 +65,8 @@ export function buildEnvFileContent(existingContent, values) {
         ["TELEGRAM_BOT_TOKEN", values.TELEGRAM_BOT_TOKEN],
         ["TELEGRAM_ALLOWED_USER_ID", values.TELEGRAM_ALLOWED_USER_ID],
         ["OPENCODE_API_URL", values.OPENCODE_API_URL],
+        ["OPENCODE_SERVER_USERNAME", values.OPENCODE_SERVER_USERNAME],
+        ["OPENCODE_SERVER_PASSWORD", values.OPENCODE_SERVER_PASSWORD],
         ["OPENCODE_MODEL_PROVIDER", values.OPENCODE_MODEL_PROVIDER],
         ["OPENCODE_MODEL_ID", values.OPENCODE_MODEL_ID],
     ];
@@ -242,6 +245,23 @@ async function askApiUrl() {
         return apiUrl;
     }
 }
+async function askServerUsername() {
+    const prompt = t("runtime.wizard.ask_server_username", {
+        defaultUsername: DEFAULT_SERVER_USERNAME,
+    });
+    const username = await askVisible(prompt);
+    if (!username) {
+        return DEFAULT_SERVER_USERNAME;
+    }
+    return username;
+}
+async function askServerPassword() {
+    const password = await askHidden(t("runtime.wizard.ask_server_password"));
+    if (!password) {
+        return undefined;
+    }
+    return password;
+}
 async function collectWizardValues() {
     const locale = await askLocale();
     setRuntimeLocale(locale);
@@ -258,12 +278,16 @@ async function collectWizardValues() {
     const token = await askToken();
     const allowedUserId = await askAllowedUserId();
     const apiUrl = await askApiUrl();
+    const serverUsername = await askServerUsername();
+    const serverPassword = await askServerPassword();
     process.stdout.write("\n");
     return {
         locale,
         token,
         allowedUserId,
         apiUrl,
+        serverUsername,
+        serverPassword,
     };
 }
 function ensureInteractiveTty() {
@@ -294,6 +318,8 @@ async function runWizardAndPersist(runtimePaths) {
         TELEGRAM_BOT_TOKEN: wizardValues.token,
         TELEGRAM_ALLOWED_USER_ID: wizardValues.allowedUserId,
         OPENCODE_API_URL: wizardValues.apiUrl,
+        OPENCODE_SERVER_USERNAME: wizardValues.serverUsername,
+        OPENCODE_SERVER_PASSWORD: wizardValues.serverPassword,
         OPENCODE_MODEL_PROVIDER: provider,
         OPENCODE_MODEL_ID: modelId,
     };

package/package.json

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