@deadragdoll/tellymcp 0.0.2 → 0.0.4

package/README-ru.md

@@ -1,6 +1,6 @@
 # TellyMCP
 
-[English](README.md) | [Русский](README-ru.md) | [Standalone Guide](STANDALONE.md) | [Standalone RU](STANDALONE-ru.md)
+[English](README.md) | [Русский](README-ru.md) | [Standalone Guide](STANDALONE.md) | [Standalone RU](STANDALONE-ru.md) | [Release Notes](VERSION.md)
 
 [![npm version](https://img.shields.io/npm/v/%40deadragdoll%2Ftellymcp)](https://www.npmjs.com/package/@deadragdoll/tellymcp)
 [![npm downloads](https://img.shields.io/npm/dm/%40deadragdoll%2Ftellymcp)](https://www.npmjs.com/package/@deadragdoll/tellymcp)

package/README.md

@@ -1,6 +1,6 @@
 # TellyMCP
 
-[English](README.md) | [Русский](README-ru.md) | [Standalone Guide](STANDALONE.md) | [Standalone RU](STANDALONE-ru.md)
+[English](README.md) | [Русский](README-ru.md) | [Standalone Guide](STANDALONE.md) | [Standalone RU](STANDALONE-ru.md) | [Release Notes](VERSION.md)
 
 [![npm version](https://img.shields.io/npm/v/%40deadragdoll%2Ftellymcp)](https://www.npmjs.com/package/@deadragdoll/tellymcp)
 [![npm downloads](https://img.shields.io/npm/dm/%40deadragdoll%2Ftellymcp)](https://www.npmjs.com/package/@deadragdoll/tellymcp)
@@ -60,6 +60,7 @@ Current tools:
 - a Telegram bot token from BotFather
 - for `gateway` / `both`: Postgres
 - optional for durable fanout on gateway: RabbitMQ
+- for `browser_*` tools: Playwright Chromium browser binaries
 
 ## tmux is strongly recommended
 
@@ -145,6 +146,12 @@ Typical local MCP endpoint in `client` mode:
 
 - `http://127.0.0.1:8787/mcp`
 
+If you plan to use `browser_*` tools, install Chromium once:
+
+```bash
+tellymcp browser install
+```
+
 Detailed step-by-step guide:
 
 - [STANDALONE.md](STANDALONE.md)
@@ -519,6 +526,8 @@ Recommended local dev settings:
 - `BROWSER_ADDRESS=http://localhost:5173`
 - start your SPA dev server on `0.0.0.0:5173`
 - open it through `browser_open`
+- install browser binaries once with `npx playwright install chromium`
+- install browser binaries once with `tellymcp browser install`
 
 Recommended Docker settings:
 

package/STANDALONE-ru.md

@@ -20,6 +20,7 @@
 2. `tmux`
 3. Redis
 4. Telegram bot token из BotFather
+5. опционально для `browser_*` tools: Playwright Chromium browser binaries
 
 Зачем это нужно:
 
@@ -46,6 +47,12 @@ redis-cli ping
 - `tmux -V` показывает версию
 - `redis-cli ping` возвращает `PONG`
 
+Если планируешь использовать browser automation tools, один раз выполни ещё:
+
+```bash
+tellymcp browser install
+```
+
 ## Шаг 2. Создать Telegram-бота
 
 В Telegram:
@@ -156,6 +163,7 @@ tellymcp doctor --env .env
 - `.env`
 - Redis
 - локальный MCP bind
+- Playwright Chromium, если browser tools включены
 
 ## Шаг 8. Запустить сервис
 

package/STANDALONE.md

@@ -20,6 +20,7 @@ Before installation, make sure you have:
 2. `tmux`
 3. Redis
 4. a Telegram bot token from BotFather
+5. optional for `browser_*` tools: Playwright Chromium browser binaries
 
 Why these matter:
 
@@ -46,6 +47,12 @@ Expected:
 - `tmux -V` prints a version
 - `redis-cli ping` returns `PONG`
 
+If you plan to use browser automation tools later, also run:
+
+```bash
+tellymcp browser install
+```
+
 ## Step 2. Create a Telegram bot
 
 In Telegram:
@@ -156,6 +163,7 @@ In standalone `client` mode it should verify:
 - `.env`
 - Redis
 - local MCP bind
+- Playwright Chromium when browser tools are enabled
 
 ## Step 8. Run the service
 

package/TOOLS.md

@@ -30,6 +30,12 @@ Browser tools:
 - `browser_screenshot`
 - `browser_close`
 
+Browser runtime rule:
+
+- Browser tools use Playwright Chromium.
+- If browser tools fail because the Playwright browser runtime is missing, install it with `tellymcp browser install`.
+- Do not stop at the installation error itself. Install the browser runtime first, then retry the browser tool.
+
 Collaboration tools:
 
 - `send_partner_note`
@@ -702,6 +708,9 @@ Input:
 
 Notes:
 
+- Browser tools require Playwright Chromium browser binaries.
+- If the runtime is missing, run `tellymcp browser install`, then retry `browser_open`.
+
 - the server always uses `TELEGRAM_INBOX_BATCH_SIZE`
 - the agent should not try to choose its own batch size
 

package/VERSION.md

@@ -0,0 +1,93 @@
+# TellyMCP Release Notes
+
+Public, user-facing release notes for published versions of `@deadragdoll/tellymcp`.
+
+For detailed engineering history, refactors, and internal development notes, see [CHANGELOG.md](CHANGELOG.md).
+
+## 0.0.3
+
+### Added
+- Standalone CLI workflow:
+  - `tellymcp init <client|gateway|both>`
+  - `tellymcp run`
+  - `tellymcp doctor`
+  - `tellymcp mcp --help`
+- Standalone and public installation guides:
+  - [STANDALONE.md](STANDALONE.md)
+  - [STANDALONE-ru.md](STANDALONE-ru.md)
+- Browser runtime helper:
+  - `tellymcp browser install`
+- Public README set for GitHub and npm:
+  - [README.md](README.md)
+  - [README-ru.md](README-ru.md)
+- Human-readable release notes in this file.
+
+### Changed
+- Default installation path is now npm-first:
+  - `npm install -g @deadragdoll/tellymcp`
+- Standalone client mode is documented first, before gateway/both deployment.
+- `tmux` is now documented as a strongly recommended prerequisite for the full experience:
+  - Live View
+  - nudges
+  - direct terminal control from Telegram
+- Environment examples were split into dedicated client and gateway variants.
+- Package build/publish flow now validates itself before packing/publishing.
+
+### Collaboration
+- Project collaboration works across local and remote sessions.
+- `Collab` now includes:
+  - `Broadcast`
+  - `History`
+  - `Delete`
+- `Ask` and `Share` semantics were clarified:
+  - `Ask` tells the selected session to do the work and reply back
+  - `Share` tells the current session to send something to the selected session
+
+### Live View
+- Telegram Mini App Live View supports:
+  - fullscreen/expand launch policy
+  - bottom toolbar layout
+  - `Esc`
+  - `Tab`
+  - `Ctrl+C`
+  - `Backspace`
+  - `Up`
+  - `Down`
+  - `Enter`
+- Live approval flow was added for remote project sessions.
+
+### Browser
+- Browser tools use Playwright Chromium.
+- Headless mode is the recommended default for remote and SSH-based environments.
+- `doctor` now helps detect missing browser runtime and connectivity issues.
+
+### Compatibility
+- Gateway and clients now compare:
+  - package version
+  - protocol version
+  - capabilities
+- `TOOLS.md` sync now detects outdated or missing local instructions and asks the session to refresh them.
+
+### Removed
+- Legacy Go/HTTP tmux proxy path was removed.
+- Direct product path is now local `tmux` only.
+
+## Next entry template
+
+Copy this block for the next published version:
+
+```md
+## x.y.z
+
+### Added
+- ...
+
+### Changed
+- ...
+
+### Fixed
+- ...
+
+### Removed
+- ...
+```

package/dist/cli.js

@@ -11,8 +11,10 @@ const node_net_1 = __importDefault(require("node:net"));
 const dotenv_1 = require("dotenv");
 const picocolors_1 = __importDefault(require("picocolors"));
 const ws_1 = __importDefault(require("ws"));
+const versionHandshake_1 = require("./services/features/telegram-mcp/src/shared/lib/version/versionHandshake");
 const distDir = __dirname;
 const packageRoot = node_path_1.default.resolve(distDir, "..");
+const cliPackageVersion = (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname);
 function getTmuxStatus() {
     const result = (0, node_child_process_1.spawnSync)("tmux", ["-V"], {
         encoding: "utf8",
@@ -27,7 +29,7 @@ function getTmuxStatus() {
     return { found: false };
 }
 function printBanner(title, subtitle) {
-    process.stdout.write(`${picocolors_1.default.bold(picocolors_1.default.cyan("TellyMCP"))} ${picocolors_1.default.dim(title)}\n`);
+    process.stdout.write(`${picocolors_1.default.bold(picocolors_1.default.cyan("TellyMCP"))} ${picocolors_1.default.bold(picocolors_1.default.white(`v${cliPackageVersion}`))} ${picocolors_1.default.dim(title)}\n`);
     if (subtitle) {
         process.stdout.write(`${picocolors_1.default.dim(subtitle)}\n`);
     }
@@ -50,6 +52,34 @@ function getTmuxInstallHints() {
         "Arch:          sudo pacman -S tmux",
     ];
 }
+async function getPlaywrightBrowserStatus(browserEnabled) {
+    if (!browserEnabled) {
+        return { enabled: false };
+    }
+    try {
+        const playwright = await import("playwright");
+        const executablePath = playwright.chromium.executablePath();
+        if (executablePath && (0, node_fs_1.existsSync)(executablePath)) {
+            return {
+                enabled: true,
+                installed: true,
+                executablePath,
+            };
+        }
+        return {
+            enabled: true,
+            installed: false,
+            message: "Chromium browser binaries are missing.",
+        };
+    }
+    catch (error) {
+        return {
+            enabled: true,
+            installed: false,
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
 function printHelp() {
     const tmux = getTmuxStatus();
     printBanner("CLI", "Telegram Human-in-the-Loop MCP server");
@@ -58,6 +88,7 @@ function printHelp() {
         "  tellymcp run [--env <file>]",
         "  tellymcp run --env=<file>",
         "  tellymcp doctor [--env <file>]",
+        "  tellymcp browser install",
         "  tellymcp mcp [--url <url>] [--bearer <token>] [--format claude|legacy]",
         "  tellymcp help",
     ]);
@@ -67,6 +98,7 @@ function printHelp() {
         "  tellymcp run",
         "  tellymcp run --env .env.client",
         "  tellymcp doctor --env .env.client",
+        "  tellymcp browser install",
         "  tellymcp mcp --help",
     ]);
     if (tmux.found) {
@@ -146,6 +178,17 @@ function printMcpHelp() {
         "  tellymcp mcp --url https://builder.undoo.ru/api/mcp --format legacy",
     ]);
 }
+function printBrowserHelp() {
+    printBanner("browser helper", "Manage Playwright browser binaries used by browser_* tools");
+    printSection("Usage", [
+        "  tellymcp browser install",
+    ]);
+    printSection("What this command does", [
+        "  Installs the bundled Playwright Chromium browser.",
+        "  Uses the Playwright dependency shipped with TellyMCP.",
+        "  Avoids generic npx warnings about missing local project dependencies.",
+    ]);
+}
 function fail(message) {
     process.stderr.write(`${message}\n`);
     process.exit(1);
@@ -439,6 +482,7 @@ async function runDoctor(args) {
     const gatewayWsUrl = parsed.GATEWAY_WS_URL?.trim();
     const publicWebappUrl = parsed.WEBAPP_PUBLIC_URL?.trim();
     const mcpBearerToken = parsed.MCP_HTTP_BEARER_TOKEN?.trim();
+    const browserEnabled = (parsed.BROWSER_ENABLED || "true").trim().toLowerCase() !== "false";
     const externalHealthUrl = deriveGatewayHealthUrlFromPublicUrl(publicGatewayUrl || "") ??
         deriveGatewayHealthUrlFromPublicUrl(publicWebappUrl || "");
     printSection("env", [
@@ -455,6 +499,19 @@ async function runDoctor(args) {
     ]);
     const checks = [];
     const capabilities = [];
+    const playwrightStatus = await getPlaywrightBrowserStatus(browserEnabled);
+    if (!playwrightStatus.enabled) {
+        checks.push(`${picocolors_1.default.dim("  SKIP")} playwright: browser tools are disabled`);
+        capabilities.push(`${picocolors_1.default.dim("  SKIP")} browser tools: disabled`);
+    }
+    else if (playwrightStatus.installed) {
+        checks.push(`${picocolors_1.default.green("  OK")} playwright chromium: ${playwrightStatus.executablePath}`);
+        capabilities.push(`${picocolors_1.default.green("  OK")} browser tools: available`);
+    }
+    else {
+        checks.push(`${picocolors_1.default.red("  ERROR")} playwright chromium: ${playwrightStatus.message}`);
+        capabilities.push(`${picocolors_1.default.red("  ERROR")} browser tools: browsers are not installed`);
+    }
     const redisHost = (parsed.REDIS_HOST || "127.0.0.1").trim();
     const redisPort = Number(parsed.REDIS_PORT || 6379);
     const redisCheck = await checkTcpPort(redisHost, redisPort);
@@ -560,6 +617,39 @@ async function runDoctor(args) {
     else {
         printSection("notes", [`${picocolors_1.default.green("  OK")} No obvious local config issues detected.`]);
     }
+    if (browserEnabled && (!playwrightStatus.enabled || !playwrightStatus.installed)) {
+        printSection("playwright", [
+            `${picocolors_1.default.yellow("  ACTION")} Install browser binaries before using browser_* tools:`,
+            "    tellymcp browser install",
+        ]);
+    }
+}
+function runBrowserCommand(args) {
+    const [subcommand] = args;
+    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        printBrowserHelp();
+        return;
+    }
+    if (subcommand !== "install") {
+        fail("Supported browser subcommands: install");
+    }
+    const cliPath = node_path_1.default.join(packageRoot, "node_modules", "playwright", "cli.js");
+    if (!(0, node_fs_1.existsSync)(cliPath)) {
+        fail(`Missing bundled Playwright CLI: ${cliPath}`);
+    }
+    printBanner("browser install", "Installing bundled Playwright Chromium");
+    const child = (0, node_child_process_1.spawn)(process.execPath, [cliPath, "install", "chromium"], {
+        cwd: process.cwd(),
+        stdio: "inherit",
+        env: process.env,
+    });
+    child.on("exit", (code, signal) => {
+        if (signal) {
+            process.kill(process.pid, signal);
+            return;
+        }
+        process.exit(code ?? 0);
+    });
 }
 function runRuntime(args) {
     const envPath = resolveRunEnvPath(args);
@@ -578,6 +668,7 @@ function runRuntime(args) {
     if (!(0, node_fs_1.existsSync)(servicesPath)) {
         fail(`Missing compiled services: ${servicesPath}`);
     }
+    printBanner("run", "Starting packaged runtime");
     const tmux = getTmuxStatus();
     if (tmux.found) {
         process.stdout.write(`${picocolors_1.default.green("tmux detected:")} ${tmux.version}\n`);
@@ -612,7 +703,7 @@ function runRuntime(args) {
 }
 async function main(argv) {
     const [rawCommand, firstArg, secondArg] = argv;
-    const command = rawCommand === "init" || rawCommand === "run" || rawCommand === "help" || rawCommand === "mcp" || rawCommand === "doctor"
+    const command = rawCommand === "init" || rawCommand === "run" || rawCommand === "help" || rawCommand === "mcp" || rawCommand === "doctor" || rawCommand === "browser"
         ? rawCommand
         : "help";
     if (command === "help" || !rawCommand || rawCommand === "--help" || rawCommand === "-h") {
@@ -631,6 +722,10 @@ async function main(argv) {
         await runDoctor(argv.slice(1));
         return;
     }
+    if (command === "browser") {
+        runBrowserCommand(argv.slice(1));
+        return;
+    }
     runRuntime(argv.slice(1));
 }
 void main(process.argv.slice(2));

package/dist/services/features/telegram-mcp/gateway-socket.service.js

@@ -554,7 +554,7 @@ const TelegramMcpGatewaySocketService = {
                     const action = typeof request.payload?.action === "string"
                         ? request.payload.action
                         : "";
-                    if (!["up", "down", "enter", "slash", "delete", "tab", "escape"].includes(action)) {
+                    if (!["up", "down", "enter", "slash", "delete", "tab", "escape", "interrupt"].includes(action)) {
                         throw new Error("Unsupported action");
                     }
                     const sessionId = request.local_session_id.trim();

package/dist/services/features/telegram-mcp/runtime.service.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TELEGRAM_MCP_RUNTIME_SERVICE_NAME = void 0;
 const runtime_1 = require("./src/app/bootstrap/runtime");
+const versionHandshake_1 = require("./src/shared/lib/version/versionHandshake");
 exports.TELEGRAM_MCP_RUNTIME_SERVICE_NAME = "telegramMcp.runtime";
 const TelegramMcpRuntimeService = {
     name: exports.TELEGRAM_MCP_RUNTIME_SERVICE_NAME,
@@ -17,11 +18,17 @@ const TelegramMcpRuntimeService = {
         },
     },
     async started() {
-        this.logger.info("Starting telegram_mcp runtime service");
+        this.logger.info("Starting telegram_mcp runtime service", {
+            packageVersion: (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname),
+            protocolVersion: versionHandshake_1.TELLYMCP_PROTOCOL_VERSION,
+        });
         this.runtime = await (0, runtime_1.createAppRuntime)({
             callBroker: (actionName, params, options) => this.broker.call(actionName, params, options),
         });
-        this.logger.info("telegram_mcp runtime service is ready");
+        this.logger.info("telegram_mcp runtime service is ready", {
+            packageVersion: (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname),
+            protocolVersion: versionHandshake_1.TELLYMCP_PROTOCOL_VERSION,
+        });
     },
     async stopped() {
         if (!this.runtime) {

package/dist/services/features/telegram-mcp/src/app/bootstrap/runtime.js

@@ -77,6 +77,8 @@ async function createAppRuntime(input) {
     logger.info("Telegram transport ready");
     await telegramTransport.recoverPendingInboxNudges();
     logger.info("Startup inbox nudge recovery completed");
+    await telegramTransport.sendStartupNotifications();
+    logger.info("Startup Telegram notifications completed");
     const gatewayHttpService = new gatewayHttpService_1.GatewayHttpService(config, input.callBroker);
     return {
         config,

package/dist/services/features/telegram-mcp/src/app/http.js

@@ -428,7 +428,7 @@ function createMcpHttpHandler(runtime, input) {
                     typeof Reflect.get(body, "action") === "string"
                     ? String(Reflect.get(body, "action"))
                     : "";
-                if (!["up", "down", "enter", "slash", "delete", "tab", "escape"].includes(action)) {
+                if (!["up", "down", "enter", "slash", "delete", "tab", "escape", "interrupt"].includes(action)) {
                     writeText(res, 400, "Unsupported action");
                     return;
                 }

package/dist/services/features/telegram-mcp/src/app/webapp/assets.js

@@ -168,6 +168,7 @@ const elements = {
   session: document.querySelector("[data-role=session]"),
   status: document.querySelector("[data-role=status]"),
   updated: document.querySelector("[data-role=updated]"),
+  interrupt: document.querySelector("[data-role=interrupt]"),
   esc: document.querySelector("[data-role=escape]"),
   tab: document.querySelector("[data-role=tab]"),
   slash: document.querySelector("[data-role=slash]"),
@@ -597,6 +598,10 @@ function startPolling() {
 }
 
 function bindUi() {
+  elements.interrupt.addEventListener("click", () => {
+    sendAction("interrupt").catch((error) => setStatus(error.message || String(error), true));
+  });
+
   elements.esc.addEventListener("click", () => {
     sendAction("escape").catch((error) => setStatus(error.message || String(error), true));
   });
@@ -664,6 +669,7 @@ async function main() {
       bootstrapPayload.session_label || bootstrapPayload.session_id;
 
     if (!bootstrapPayload.tmux_target) {
+      elements.interrupt.disabled = true;
       elements.esc.disabled = true;
       elements.tab.disabled = true;
       elements.slash.disabled = true;
@@ -704,6 +710,7 @@ function renderWebAppHtml(input) {
   <body>
     <div class="app">
       <div class="toolbar">
+        <button class="btn compact danger" data-role="interrupt" type="button">Ctrl+C</button>
         <button class="btn compact" data-role="escape" type="button">Esc</button>
         <button class="btn compact" data-role="tab" type="button">Tab</button>
         <button class="btn compact" data-role="slash" type="button">/</button>

package/dist/services/features/telegram-mcp/src/shared/integrations/telegram/transport.js

@@ -17,6 +17,7 @@ const collabSemantics_1 = require("./collabSemantics");
 const collabUi_1 = require("./collabUi");
 const proxyFetch_1 = require("./proxyFetch");
 const client_1 = require("../tmux/client");
+const versionHandshake_1 = require("../../lib/version/versionHandshake");
 const LOCAL_INDEX_FILE_NAME = "LOCAL_INDEX.md";
 function trimTrailingSlashes(value) {
     return value.replace(/\/+$/u, "");
@@ -25,6 +26,14 @@ function normalizeBasePath(value) {
     const trimmed = trimTrailingSlashes(value.trim());
     return trimmed.startsWith("/") ? trimmed || "/" : `/${trimmed || ""}`;
 }
+function joinHttpPath(prefix, suffix) {
+    const normalizedPrefix = prefix ? normalizeBasePath(prefix) : "";
+    const normalizedSuffix = normalizeBasePath(suffix);
+    if (!normalizedPrefix || normalizedPrefix === "/") {
+        return normalizedSuffix;
+    }
+    return `${normalizedPrefix}${normalizedSuffix}`.replace(/\/{2,}/gu, "/");
+}
 function resolveWebAppPublicBaseUrl(config) {
     if (!config.webapp.publicUrl) {
         return null;
@@ -755,6 +764,92 @@ class TelegramTransport {
             recoveredSessions: recoveredCount,
         });
     }
+    async sendStartupNotifications() {
+        const packageVersion = (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname);
+        const sessions = await this.sessionStore.listSessions();
+        const groupedRecipients = new Map();
+        for (const session of sessions) {
+            const binding = await this.bindingStore.getBinding(session.sessionId);
+            if (!binding) {
+                continue;
+            }
+            const key = `${binding.telegramChatId}:${binding.telegramUserId}`;
+            const current = groupedRecipients.get(key);
+            if (current) {
+                current.sessionIds.push(session.sessionId);
+                current.sessionLabels.push(session.label ?? session.sessionId);
+                continue;
+            }
+            groupedRecipients.set(key, {
+                binding: {
+                    telegramChatId: binding.telegramChatId,
+                    telegramUserId: binding.telegramUserId,
+                },
+                sessionIds: [session.sessionId],
+                sessionLabels: [session.label ?? session.sessionId],
+            });
+        }
+        if (groupedRecipients.size === 0) {
+            this.logger.info("Skipping startup notifications because no Telegram sessions are paired");
+            return;
+        }
+        const runtimePort = this.config.distributed.mode === "gateway" || this.config.distributed.mode === "both"
+            ? Number(process.env.PORT || this.config.mcp.httpPort)
+            : this.config.mcp.httpPort;
+        const rootPrefix = this.config.distributed.mode === "gateway" || this.config.distributed.mode === "both"
+            ? normalizeBasePath(process.env.ROOT_PREFIX || "/api")
+            : "";
+        const localMcpPath = this.config.distributed.mode === "gateway" || this.config.distributed.mode === "both"
+            ? joinHttpPath(rootPrefix, this.config.mcp.httpPath)
+            : this.config.mcp.httpPath;
+        const localWebappPath = this.config.distributed.mode === "gateway" || this.config.distributed.mode === "both"
+            ? joinHttpPath(rootPrefix, this.config.webapp.basePath)
+            : this.config.webapp.basePath;
+        const localMcpUrl = `http://${this.config.mcp.httpHost}:${runtimePort}${localMcpPath}`;
+        const localWebappUrl = `http://${this.config.mcp.httpHost}:${runtimePort}${localWebappPath}`;
+        for (const recipientGroup of groupedRecipients.values()) {
+            const primarySessionId = recipientGroup.sessionIds[0];
+            if (!primarySessionId) {
+                continue;
+            }
+            const uniqueSessionLabels = Array.from(new Set(recipientGroup.sessionLabels)).sort();
+            const startupMessage = [
+                "✅ TellyMCP запущен.",
+                `Версия: ${packageVersion}`,
+                `Протокол: ${versionHandshake_1.TELLYMCP_PROTOCOL_VERSION}`,
+                `Режим: ${this.config.distributed.mode}`,
+                ...(this.config.telegram.botUsername
+                    ? [`Бот: @${this.config.telegram.botUsername.replace(/^@/u, "")}`]
+                    : []),
+                `Сессии: ${uniqueSessionLabels.join(", ")}`,
+                `MCP: ${localMcpUrl}`,
+                ...(this.config.webapp.enabled ? [`WebApp: ${localWebappUrl}`] : []),
+                ...(this.config.distributed.gatewayPublicUrl
+                    ? [`Gateway: ${this.config.distributed.gatewayPublicUrl}`]
+                    : []),
+                ...(this.config.distributed.gatewayWsUrl
+                    ? [`Gateway WS: ${this.config.distributed.gatewayWsUrl}`]
+                    : []),
+                `Browser: ${this.config.browser.enabled ? (this.config.browser.headless ? "enabled, headless" : "enabled, headed") : "disabled"}`,
+                "Напиши /menu, чтобы открыть меню сессий.",
+            ].join("\n");
+            try {
+                await this.sendNotification({
+                    sessionId: primarySessionId,
+                    sessionLabel: "TellyMCP",
+                    recipient: recipientGroup.binding,
+                    message: startupMessage,
+                });
+            }
+            catch (error) {
+                this.logger.warn("Failed to deliver Telegram startup notification", {
+                    telegramChatId: recipientGroup.binding.telegramChatId,
+                    telegramUserId: recipientGroup.binding.telegramUserId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
     async sendRequest(input) {
         const text = (0, messageFormat_1.formatTelegramMessage)(input, {
             maxQuestionChars: this.config.telegram.maxQuestionChars,

package/dist/services/features/telegram-mcp/src/shared/integrations/tmux/client.js

@@ -253,7 +253,9 @@ async function sendAllowedTmuxAction(config, target, action) {
                         ? "Tab"
                         : action === "escape"
                             ? "Escape"
-                            : "Enter";
+                            : action === "interrupt"
+                                ? "C-c"
+                                : "Enter";
     await execFileAsync("tmux", buildTmuxArgs(config, ["send-keys", "-t", target, key]));
 }
 async function sendTmuxLiteralLine(config, target, text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deadragdoll/tellymcp",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "TellyMCP - Telegram Human-in-the-Loop MCP Server",
   "main": "dist/services/features/telegram-mcp/runtime.service.js",
   "bin": {
@@ -14,6 +14,7 @@
     "README-ru.md",
     "STANDALONE.md",
     "STANDALONE-ru.md",
+    "VERSION.md",
     "CHANGELOG.md",
     "TOOLS.md",
     ".env.example.client",
@@ -34,6 +35,8 @@
   },
   "scripts": {
     "postinstall": "node ./scripts/postinstall.js",
+    "prepack": "yarn build",
+    "prepublishOnly": "yarn build && yarn lint && yarn test",
     "mcp:local": "codex mcp add telegramHuman --url http://127.0.0.1:8787/mcp",
     "dev:gw": "TS_NODE_TRANSPILE_ONLY=1 TS_NODE_EXPERIMENTAL_RESOLVER=1 NODE_OPTIONS=--openssl-legacy-provider ts-node ./node_modules/moleculer/bin/moleculer-runner.js src/services --config src/moleculer.config.ts --envfile ./.env-dev --hot --mask \"**/*.service.ts\"",
     "dev:builder": "TS_NODE_TRANSPILE_ONLY=1 TS_NODE_EXPERIMENTAL_RESOLVER=1 NODE_OPTIONS=--openssl-legacy-provider ts-node ./node_modules/moleculer/bin/moleculer-runner.js src/services --config src/moleculer.config.ts --envfile ./.env-builder --hot --mask \"**/*.service.ts\"",

package/scripts/postinstall.js

@@ -53,6 +53,11 @@ if (tmux.found) {
   }
 }
 
+line();
+line(`${pc.yellow("INFO")} Browser tools need Playwright browser binaries.`);
+line("If you plan to use browser_* tools, run:");
+line(`  ${pc.bold("tellymcp browser install")}`);
+
 line();
 line(`Check your local setup: ${pc.bold("tellymcp doctor")}`);
 line(`General help: ${pc.bold("tellymcp help")}`);