@grinev/opencode-telegram-bot 0.18.0 → 0.19.0

package/dist/i18n/de.js

@@ -10,6 +10,7 @@ export const de = {
     "cmd.description.tasklist": "Geplante Aufgaben anzeigen",
     "cmd.description.commands": "Benutzerdefinierte Befehle",
     "cmd.description.skills": "Skill-Katalog",
+    "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "OpenCode-Server starten",
     "cmd.description.opencode_stop": "OpenCode-Server stoppen",
     "cmd.description.help": "Hilfe",
@@ -364,6 +365,24 @@ export const de = {
     "skills.button.next_page": "Weiter ➡️",
     "skills.page_empty_callback": "Keine Skills auf dieser Seite",
     "skills.page_load_error_callback": "Diese Seite konnte nicht geladen werden. Bitte versuche es erneut.",
+    "mcps.select": "MCP servers:",
+    "mcps.empty": "📭 No MCP servers configured.",
+    "mcps.fetch_error": "🔴 Failed to load MCP servers.",
+    "mcps.toggle_error": "🔴 Failed to toggle MCP server.",
+    "mcps.enabling": "Enabling...",
+    "mcps.disabling": "Disabling...",
+    "mcps.status.connected": "🟢 Connected",
+    "mcps.status.disabled": "🔴 Disabled",
+    "mcps.status.failed": "⚠️ Failed",
+    "mcps.status.needs_auth": "🔒 Needs auth",
+    "mcps.status.needs_client_registration": "🔒 Needs registration",
+    "mcps.detail.title": "Server: {name}",
+    "mcps.detail.status": "Status: {status}",
+    "mcps.detail.error": "Error: {error}",
+    "mcps.button.enable": "🟢 Enable",
+    "mcps.button.disable": "🔴 Disable",
+    "mcps.button.back": "⬅️ Back",
+    "mcps.auth_required": "This server requires authorization and cannot be enabled from the bot.",
     "cmd.description.rename": "Aktuelle Sitzung umbenennen",
     "legacy.models.fetch_error": "🔴 Modellliste konnte nicht geladen werden. Prüfe den Serverstatus mit /status.",
     "legacy.models.empty": "📋 Keine verfügbaren Modelle. Konfiguriere Provider in OpenCode.",

package/dist/i18n/en.js

@@ -10,6 +10,7 @@ export const en = {
     "cmd.description.tasklist": "List scheduled tasks",
     "cmd.description.commands": "Custom commands",
     "cmd.description.skills": "Skills catalog",
+    "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "Start OpenCode server",
     "cmd.description.opencode_stop": "Stop OpenCode server",
     "cmd.description.help": "Help",
@@ -364,6 +365,24 @@ export const en = {
     "skills.button.next_page": "Next ➡️",
     "skills.page_empty_callback": "No skills on this page",
     "skills.page_load_error_callback": "Cannot load this page. Please try again.",
+    "mcps.select": "MCP servers:",
+    "mcps.empty": "📭 No MCP servers configured.",
+    "mcps.fetch_error": "🔴 Failed to load MCP servers.",
+    "mcps.toggle_error": "🔴 Failed to toggle MCP server.",
+    "mcps.enabling": "Enabling...",
+    "mcps.disabling": "Disabling...",
+    "mcps.status.connected": "🟢 Connected",
+    "mcps.status.disabled": "🔴 Disabled",
+    "mcps.status.failed": "⚠️ Failed",
+    "mcps.status.needs_auth": "🔒 Needs auth",
+    "mcps.status.needs_client_registration": "🔒 Needs registration",
+    "mcps.detail.title": "Server: {name}",
+    "mcps.detail.status": "Status: {status}",
+    "mcps.detail.error": "Error: {error}",
+    "mcps.button.enable": "🟢 Enable",
+    "mcps.button.disable": "🔴 Disable",
+    "mcps.button.back": "⬅️ Back",
+    "mcps.auth_required": "This server requires authorization and cannot be enabled from the bot.",
     "cmd.description.rename": "Rename current session",
     "legacy.models.fetch_error": "🔴 Failed to get models list. Check server status with /status.",
     "legacy.models.empty": "📋 No available models. Configure providers in OpenCode.",

package/dist/i18n/es.js

@@ -10,6 +10,7 @@ export const es = {
     "cmd.description.tasklist": "Ver tareas programadas",
     "cmd.description.commands": "Comandos personalizados",
     "cmd.description.skills": "Catálogo de skills",
+    "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "Iniciar servidor OpenCode",
     "cmd.description.opencode_stop": "Detener servidor OpenCode",
     "cmd.description.help": "Ayuda",
@@ -364,6 +365,24 @@ export const es = {
     "skills.button.next_page": "Siguiente ➡️",
     "skills.page_empty_callback": "No hay skills en esta página",
     "skills.page_load_error_callback": "No se pudo cargar esta página. Por favor, inténtalo de nuevo.",
+    "mcps.select": "MCP servers:",
+    "mcps.empty": "📭 No MCP servers configured.",
+    "mcps.fetch_error": "🔴 Failed to load MCP servers.",
+    "mcps.toggle_error": "🔴 Failed to toggle MCP server.",
+    "mcps.enabling": "Enabling...",
+    "mcps.disabling": "Disabling...",
+    "mcps.status.connected": "🟢 Connected",
+    "mcps.status.disabled": "🔴 Disabled",
+    "mcps.status.failed": "⚠️ Failed",
+    "mcps.status.needs_auth": "🔒 Needs auth",
+    "mcps.status.needs_client_registration": "🔒 Needs registration",
+    "mcps.detail.title": "Server: {name}",
+    "mcps.detail.status": "Status: {status}",
+    "mcps.detail.error": "Error: {error}",
+    "mcps.button.enable": "🟢 Enable",
+    "mcps.button.disable": "🔴 Disable",
+    "mcps.button.back": "⬅️ Back",
+    "mcps.auth_required": "This server requires authorization and cannot be enabled from the bot.",
     "cmd.description.rename": "Renombrar la sesión actual",
     "legacy.models.fetch_error": "🔴 No se pudo obtener la lista de modelos. Revisa el estado del servidor con /status.",
     "legacy.models.empty": "📋 No hay modelos disponibles. Configura los proveedores en OpenCode.",

package/dist/i18n/fr.js

@@ -10,6 +10,7 @@ export const fr = {
     "cmd.description.tasklist": "Afficher les tâches planifiées",
     "cmd.description.commands": "Commandes personnalisées",
     "cmd.description.skills": "Catalogue de skills",
+    "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.help": "Aide",
@@ -364,6 +365,24 @@ export const fr = {
     "skills.button.next_page": "Suivant ➡️",
     "skills.page_empty_callback": "Aucun skill sur cette page",
     "skills.page_load_error_callback": "Impossible de charger cette page. Veuillez réessayer.",
+    "mcps.select": "MCP servers:",
+    "mcps.empty": "📭 No MCP servers configured.",
+    "mcps.fetch_error": "🔴 Failed to load MCP servers.",
+    "mcps.toggle_error": "🔴 Failed to toggle MCP server.",
+    "mcps.enabling": "Enabling...",
+    "mcps.disabling": "Disabling...",
+    "mcps.status.connected": "🟢 Connected",
+    "mcps.status.disabled": "🔴 Disabled",
+    "mcps.status.failed": "⚠️ Failed",
+    "mcps.status.needs_auth": "🔒 Needs auth",
+    "mcps.status.needs_client_registration": "🔒 Needs registration",
+    "mcps.detail.title": "Server: {name}",
+    "mcps.detail.status": "Status: {status}",
+    "mcps.detail.error": "Error: {error}",
+    "mcps.button.enable": "🟢 Enable",
+    "mcps.button.disable": "🔴 Disable",
+    "mcps.button.back": "⬅️ Back",
+    "mcps.auth_required": "This server requires authorization and cannot be enabled from the bot.",
     "cmd.description.rename": "Renommer la session actuelle",
     "legacy.models.fetch_error": "🔴 Impossible de récupérer la liste des modèles. Vérifiez l'état du serveur avec /status.",
     "legacy.models.empty": "📋 Aucun modèle disponible. Configurez les fournisseurs dans OpenCode.",

package/dist/i18n/ru.js

@@ -10,6 +10,7 @@ export const ru = {
     "cmd.description.tasklist": "Список задач по расписанию",
     "cmd.description.commands": "Пользовательские команды",
     "cmd.description.skills": "Каталог скиллов",
+    "cmd.description.mcps": "MCP серверы",
     "cmd.description.opencode_start": "Запустить OpenCode сервер",
     "cmd.description.opencode_stop": "Остановить OpenCode сервер",
     "cmd.description.help": "Справка",
@@ -364,6 +365,24 @@ export const ru = {
     "skills.button.next_page": "Вперёд ➡️",
     "skills.page_empty_callback": "На этой странице нет скиллов",
     "skills.page_load_error_callback": "Не удалось загрузить эту страницу. Пожалуйста, попробуйте снова.",
+    "mcps.select": "MCP серверы:",
+    "mcps.empty": "📭 MCP серверы не настроены.",
+    "mcps.fetch_error": "🔴 Не удалось загрузить MCP серверы.",
+    "mcps.toggle_error": "🔴 Не удалось переключить MCP сервер.",
+    "mcps.enabling": "Включаю...",
+    "mcps.disabling": "Выключаю...",
+    "mcps.status.connected": "🟢 Подключен",
+    "mcps.status.disabled": "🔴 Отключен",
+    "mcps.status.failed": "⚠️ Ошибка",
+    "mcps.status.needs_auth": "🔒 Требуется авторизация",
+    "mcps.status.needs_client_registration": "🔒 Требуется регистрация",
+    "mcps.detail.title": "Сервер: {name}",
+    "mcps.detail.status": "Статус: {status}",
+    "mcps.detail.error": "Ошибка: {error}",
+    "mcps.button.enable": "🟢 Включить",
+    "mcps.button.disable": "🔴 Выключить",
+    "mcps.button.back": "⬅️ Назад",
+    "mcps.auth_required": "Этот сервер требует авторизации и не может быть включен из бота.",
     "cmd.description.rename": "Переименовать текущую сессию",
     "legacy.models.fetch_error": "🔴 Не удалось получить список моделей. Проверьте статус сервера /status.",
     "legacy.models.empty": "📋 Нет доступных моделей. Настройте провайдеры через OpenCode.",

package/dist/i18n/zh.js

@@ -10,6 +10,7 @@ export const zh = {
     "cmd.description.tasklist": "查看定时任务",
     "cmd.description.commands": "自定义命令",
     "cmd.description.skills": "技能目录",
+    "cmd.description.mcps": "MCP servers",
     "cmd.description.opencode_start": "启动 OpenCode 服务器",
     "cmd.description.opencode_stop": "停止 OpenCode 服务器",
     "cmd.description.help": "帮助",
@@ -364,6 +365,24 @@ export const zh = {
     "skills.button.next_page": "下一页 ➡️",
     "skills.page_empty_callback": "这一页没有技能",
     "skills.page_load_error_callback": "无法加载此页面。请重试。",
+    "mcps.select": "MCP servers:",
+    "mcps.empty": "📭 No MCP servers configured.",
+    "mcps.fetch_error": "🔴 Failed to load MCP servers.",
+    "mcps.toggle_error": "🔴 Failed to toggle MCP server.",
+    "mcps.enabling": "Enabling...",
+    "mcps.disabling": "Disabling...",
+    "mcps.status.connected": "🟢 Connected",
+    "mcps.status.disabled": "🔴 Disabled",
+    "mcps.status.failed": "⚠️ Failed",
+    "mcps.status.needs_auth": "🔒 Needs auth",
+    "mcps.status.needs_client_registration": "🔒 Needs registration",
+    "mcps.detail.title": "Server: {name}",
+    "mcps.detail.status": "Status: {status}",
+    "mcps.detail.error": "Error: {error}",
+    "mcps.button.enable": "🟢 Enable",
+    "mcps.button.disable": "🔴 Disable",
+    "mcps.button.back": "⬅️ Back",
+    "mcps.auth_required": "This server requires authorization and cannot be enabled from the bot.",
     "cmd.description.rename": "重命名当前会话",
     "legacy.models.fetch_error": "🔴 获取模型列表失败。请使用 /status 检查服务器状态。",
     "legacy.models.empty": "📋 没有可用模型。请在 OpenCode 中配置 providers。",

package/dist/opencode/auto-restart.js

@@ -0,0 +1,92 @@
+import { config } from "../config.js";
+import { logger } from "../utils/logger.js";
+import { opencodeClient } from "./client.js";
+import { resolveLocalOpencodeTarget, startLocalOpencodeServer, } from "./process.js";
+const SERVER_READY_TIMEOUT_MS = 10000;
+const SERVER_READY_POLL_INTERVAL_MS = 500;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function isOpencodeServerHealthy() {
+    try {
+        const { data, error } = await opencodeClient.global.health();
+        return !error && data?.healthy === true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForOpencodeServerReady(timeoutMs) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < timeoutMs) {
+        if (await isOpencodeServerHealthy()) {
+            return true;
+        }
+        await sleep(SERVER_READY_POLL_INTERVAL_MS);
+    }
+    return false;
+}
+export class OpencodeAutoRestartService {
+    timer = null;
+    localTarget = null;
+    started = false;
+    checkInProgress = false;
+    async start() {
+        if (this.started || !config.opencode.autoRestartEnabled) {
+            return;
+        }
+        const localTarget = resolveLocalOpencodeTarget(config.opencode.apiUrl);
+        if (!localTarget) {
+            logger.warn(`[OpenCodeAutoRestart] Disabled because OPENCODE_API_URL is not local: ${config.opencode.apiUrl}`);
+            return;
+        }
+        this.started = true;
+        this.localTarget = localTarget;
+        logger.info(`[OpenCodeAutoRestart] Enabled: port=${localTarget.port}, intervalSec=${config.opencode.monitorIntervalSec}`);
+        await this.checkAndRestart("startup");
+        this.timer = setInterval(() => {
+            void this.checkAndRestart("interval");
+        }, config.opencode.monitorIntervalSec * 1000);
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.started = false;
+        this.localTarget = null;
+    }
+    async checkAndRestart(reason) {
+        if (this.checkInProgress || !this.localTarget) {
+            return;
+        }
+        this.checkInProgress = true;
+        try {
+            if (await isOpencodeServerHealthy()) {
+                logger.debug(`[OpenCodeAutoRestart] Health-check succeeded: reason=${reason}`);
+                return;
+            }
+            logger.warn(`[OpenCodeAutoRestart] OpenCode server is unavailable, starting local server: reason=${reason}, port=${this.localTarget.port}`);
+            const childProcess = startLocalOpencodeServer(this.localTarget);
+            childProcess.once("error", (error) => {
+                logger.error("[OpenCodeAutoRestart] OpenCode server process failed to start", error);
+            });
+            const pid = childProcess.pid;
+            childProcess.unref();
+            const ready = await waitForOpencodeServerReady(SERVER_READY_TIMEOUT_MS);
+            if (!ready) {
+                logger.warn(`[OpenCodeAutoRestart] OpenCode server was started but did not become ready: pid=${pid ?? "unknown"}, port=${this.localTarget.port}`);
+                return;
+            }
+            logger.info(`[OpenCodeAutoRestart] OpenCode server recovered: pid=${pid ?? "unknown"}, port=${this.localTarget.port}`);
+        }
+        catch (error) {
+            logger.error("[OpenCodeAutoRestart] Failed to check or restart OpenCode server", error);
+        }
+        finally {
+            this.checkInProgress = false;
+        }
+    }
+}
+export const opencodeAutoRestartService = new OpencodeAutoRestartService();

package/dist/opencode/process.js

@@ -1,4 +1,4 @@
-import { exec } from "node:child_process";
+import { exec, spawn } from "node:child_process";
 import { promisify } from "node:util";
 const execAsync = promisify(exec);
 const DEFAULT_OPENCODE_PORT = 4096;
@@ -25,6 +25,23 @@ export function resolveLocalOpencodeTarget(apiUrl) {
         return null;
     }
 }
+export function createOpencodeServeSpawnCommand(target) {
+    const isWindows = process.platform === "win32";
+    const port = target.port.toString();
+    return {
+        command: isWindows ? "cmd.exe" : "opencode",
+        args: isWindows ? ["/c", "opencode", "serve", "--port", port] : ["serve", "--port", port],
+        windowsHide: isWindows,
+    };
+}
+export function startLocalOpencodeServer(target) {
+    const spawnCommand = createOpencodeServeSpawnCommand(target);
+    return spawn(spawnCommand.command, spawnCommand.args, {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: spawnCommand.windowsHide,
+    });
+}
 function parsePid(value) {
     const pid = Number.parseInt(value.trim(), 10);
     return Number.isInteger(pid) && pid > 0 ? pid : null;

package/dist/pinned/manager.js

@@ -77,6 +77,27 @@ class PinnedMessageManager {
         // Load existing diffs from API (for session restoration)
         await this.loadDiffsFromApi(sessionId);
     }
+    /**
+     * Restore in-memory state for a persisted pinned message without creating a new Telegram message.
+     */
+    async restoreExistingSession(sessionId, sessionTitle) {
+        logger.info(`[PinnedManager] Restoring existing pinned message for session: ${sessionId}`);
+        this.state.sessionId = sessionId;
+        this.state.sessionTitle = sessionTitle || t("pinned.default_session_title");
+        this.state.attachActive = false;
+        this.state.attachBusy = false;
+        this.state.changedFiles = [];
+        this.lastRenderedMessageText = null;
+        this.pendingUpdate = false;
+        this.pendingForceUpdate = false;
+        await this.refreshProjectMetadata();
+        await this.fetchContextLimit();
+        if (this.onKeyboardUpdateCallback && this.state.tokensLimit > 0) {
+            this.onKeyboardUpdateCallback(this.state.tokensUsed, this.state.tokensLimit);
+        }
+        await this.updatePinnedMessage(true);
+        await this.loadDiffsFromApi(sessionId);
+    }
     /**
      * Called when session title is updated (after first message)
      */

package/dist/summary/aggregator.js

@@ -24,6 +24,17 @@ function countDiffChangesFromText(text) {
     }
     return { additions, deletions };
 }
+function normalizeSnapshotValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeSnapshotValue(item));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entryValue]) => [key, normalizeSnapshotValue(entryValue)]));
+    }
+    return value;
+}
 class SummaryAggregator {
     currentSessionId = null;
     textMessageStates = new Map();
@@ -65,6 +76,7 @@ class SummaryAggregator {
     pendingSubagentCardIdsByParent = new Map();
     pendingChildSessionIdsByParent = new Map();
     fallbackSubagentCardIdsByParent = new Map();
+    lastSubagentSnapshot = "";
     setBotAndChatId(bot, chatId) {
         this.bot = bot;
         this.chatId = chatId;
@@ -239,6 +251,7 @@ class SummaryAggregator {
         this.pendingSubagentCardIdsByParent.clear();
         this.pendingChildSessionIdsByParent.clear();
         this.fallbackSubagentCardIdsByParent.clear();
+        this.lastSubagentSnapshot = "";
         this.messageCount = 0;
         this.lastUpdated = 0;
         if (this.onClearedCallback) {
@@ -312,6 +325,28 @@ class SummaryAggregator {
             terminalMessage: state.terminalMessage,
             updatedAt: state.updatedAt,
         }));
+        const snapshot = JSON.stringify(subagents.map((subagent) => ({
+            cardId: subagent.cardId,
+            sessionId: subagent.sessionId,
+            parentSessionId: subagent.parentSessionId,
+            agent: subagent.agent,
+            description: subagent.description,
+            prompt: subagent.prompt,
+            command: subagent.command,
+            status: subagent.status,
+            providerID: subagent.providerID,
+            modelID: subagent.modelID,
+            tokens: subagent.tokens,
+            cost: subagent.cost,
+            currentTool: subagent.currentTool,
+            currentToolInput: normalizeSnapshotValue(subagent.currentToolInput),
+            currentToolTitle: subagent.currentToolTitle,
+            terminalMessage: subagent.terminalMessage,
+        })));
+        if (snapshot === this.lastSubagentSnapshot) {
+            return;
+        }
+        this.lastSubagentSnapshot = snapshot;
         this.onSubagentCallback(this.currentSessionId, subagents);
     }
     createSubagentState(parentSessionId, sessionId, cardId = `subagent-${parentSessionId}-${Date.now()}-${this.subagentOrder.length}`) {

package/dist/summary/formatter.js

@@ -1,9 +1,9 @@
 import * as path from "path";
-import { convert } from "telegram-markdown-v2";
 import { config } from "../config.js";
 import { logger } from "../utils/logger.js";
 import { t } from "../i18n/index.js";
 import { getCurrentProject } from "../settings/manager.js";
+import { convertToTelegramMarkdownV2 } from "./markdown-to-telegram-v2.js";
 import { normalizeMarkdownForTelegramRendering } from "../telegram/render/markdown-normalizer.js";
 const TELEGRAM_MESSAGE_LIMIT = 4096;
 const MARKDOWN_V2_RESERVED_CHARS = /([_\*\[\]\(\)~`>#+\-=|{}.!\\])/g;
@@ -90,7 +90,7 @@ export function escapePlainTextForTelegramMarkdownV2(text) {
 function formatMarkdownForTelegram(text) {
     try {
         const preprocessed = normalizeMarkdownForTelegramRendering(text);
-        return escapeMarkdownV2PipesOutsideCode(convert(preprocessed, "keep"));
+        return escapeMarkdownV2PipesOutsideCode(convertToTelegramMarkdownV2(preprocessed));
     }
     catch (error) {
         logger.warn("[Formatter] Failed to convert markdown summary, falling back to raw text", error);

package/dist/summary/markdown-to-telegram-v2.js

@@ -0,0 +1,99 @@
+import { parseTelegramBlocks } from "../telegram/render/block-parser.js";
+import { normalizeMarkdownForTelegramRendering } from "../telegram/render/markdown-normalizer.js";
+/**
+ * Escapes characters reserved in Telegram MarkdownV2.
+ * These must be escaped everywhere except when used as syntactic delimiters
+ * we intentionally emit (e.g. the surrounding * of bold).
+ */
+function escapeMarkdownV2(text) {
+    return text.replace(/([_*[\]()~`>#+\-=|{}.!\\])/g, "\\$1");
+}
+function escapeMarkdownV2Code(text) {
+    return text.replace(/([`\\])/g, "\\$1");
+}
+function escapeMarkdownV2LinkUrl(text) {
+    return text.replace(/([)\\])/g, "\\$1");
+}
+function renderInlineNodes(nodes) {
+    return nodes
+        .map((node) => {
+        switch (node.type) {
+            case "text":
+                return escapeMarkdownV2(node.text);
+            case "bold":
+                return `*${renderInlineNodes(node.children)}*`;
+            case "italic":
+                return `_${renderInlineNodes(node.children)}_`;
+            case "strike":
+                return `~${renderInlineNodes(node.children)}~`;
+            case "code":
+                return `\`${escapeMarkdownV2Code(node.text)}\``;
+            case "link":
+                return `[${renderInlineNodes(node.text)}](${escapeMarkdownV2LinkUrl(node.url)})`;
+            case "underline":
+                return `__${renderInlineNodes(node.children)}__`;
+            case "spoiler":
+                return `||${renderInlineNodes(node.children)}||`;
+            default:
+                return escapeMarkdownV2(String(node));
+        }
+    })
+        .join("");
+}
+function renderBlock(block) {
+    switch (block.type) {
+        case "paragraph":
+            return renderInlineNodes(block.inlines);
+        case "heading": {
+            const content = renderInlineNodes(block.inlines);
+            return `*${content}*`;
+        }
+        case "blockquote":
+            return block.lines
+                .map((line) => renderInlineNodes(line)
+                .split("\n")
+                .map((part) => `> ${part}`)
+                .join("\n"))
+                .join("\n");
+        case "list":
+            return block.items
+                .map((item, index) => {
+                const prefix = block.ordered ? `${index + 1}\\. ` : "\\- ";
+                const body = renderInlineNodes(item);
+                return `${prefix}${body}`;
+            })
+                .join("\n");
+        case "code":
+            return `\`\`\`${escapeMarkdownV2Code(block.language ?? "")}\n${escapeMarkdownV2Code(block.text)}\n\`\`\``;
+        case "table": {
+            if (block.rows.length === 0) {
+                return "";
+            }
+            const header = `\\| ${block.rows[0].map(escapeMarkdownV2).join(" \\| ")} \\|`;
+            const separator = `\\| ${block.rows[0].map(() => "\\-\\-\\-").join(" \\| ")} \\|`;
+            const body = block.rows
+                .slice(1)
+                .map((row) => `\\| ${row.map(escapeMarkdownV2).join(" \\| ")} \\|`);
+            return [header, separator, ...body].join("\n");
+        }
+        case "rule":
+            return "---";
+        case "plain":
+            return escapeMarkdownV2(block.text);
+    }
+}
+/**
+ * Converts standard Markdown into Telegram MarkdownV2.
+ *
+ * Uses the project's existing block parser (unified/remark) so that
+ * headings, lists, tables, code blocks, etc. are handled consistently
+ * with the entity-based Telegram renderer.
+ */
+export function convertToTelegramMarkdownV2(markdown) {
+    const normalized = normalizeMarkdownForTelegramRendering(markdown);
+    const blocks = parseTelegramBlocks(normalized);
+    if (blocks.length === 0) {
+        return "";
+    }
+    return blocks.map(renderBlock).join("\n\n");
+}

package/dist/summary/subagent-formatter.js

@@ -1,10 +1,31 @@
 import { formatModelDisplayName } from "../pinned/format.js";
 import { t } from "../i18n/index.js";
 import { formatCompactToolInfo } from "./formatter.js";
+function shouldPreferInputDetails(tool, input) {
+    if (!input) {
+        return false;
+    }
+    switch (tool) {
+        case "read":
+        case "edit":
+        case "write":
+        case "apply_patch":
+            return typeof input.path === "string" || typeof input.filePath === "string";
+        case "bash":
+            return typeof input.command === "string";
+        case "grep":
+        case "glob":
+            return typeof input.pattern === "string";
+    }
+    return ["query", "url", "name", "prompt", "text"].some((field) => typeof input[field] === "string");
+}
 function formatToolStep(subagent) {
     if (!subagent.currentTool) {
         return "";
     }
+    const toolTitle = shouldPreferInputDetails(subagent.currentTool, subagent.currentToolInput)
+        ? undefined
+        : subagent.currentToolTitle;
     const toolInfo = {
         sessionId: subagent.sessionId ?? subagent.parentSessionId,
         messageId: subagent.cardId,
@@ -13,12 +34,12 @@ function formatToolStep(subagent) {
         state: {
             status: "running",
             input: subagent.currentToolInput ?? {},
-            title: subagent.currentToolTitle,
+            title: toolTitle,
             metadata: {},
             time: { start: subagent.updatedAt },
         },
         input: subagent.currentToolInput,
-        title: subagent.currentToolTitle,
+        title: toolTitle,
         metadata: {},
         hasFileAttachment: false,
     };

package/dist/telegram/render/inline-renderer.js

@@ -32,6 +32,18 @@ function pushEntity(state, entity) {
     }
     state.entities.push(entity);
 }
+function isTelegramTextLinkUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return ["http:", "https:", "tg:", "mailto:"].includes(parsed.protocol);
+    }
+    catch {
+        return false;
+    }
+}
+function isLocalReferenceUrl(url) {
+    return url.startsWith("#") || url.startsWith("/") || url.startsWith("./") || url.startsWith("../");
+}
 function renderIntoState(state, nodes) {
     for (const node of nodes) {
         switch (node.type) {
@@ -81,6 +93,12 @@ function renderIntoState(state, nodes) {
             case "link": {
                 const offset = state.text.length;
                 renderIntoState(state, node.text);
+                if (!isTelegramTextLinkUrl(node.url)) {
+                    if (isLocalReferenceUrl(node.url)) {
+                        appendText(state, ` (${node.url})`);
+                        break;
+                    }
+                }
                 pushEntity(state, {
                     type: "text_link",
                     offset,