@deadragdoll/tellymcp 0.0.3 → 0.0.5

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)

package/VERSION.md

@@ -0,0 +1,115 @@
+# 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.
+- Telegram startup notice:
+  - version
+  - protocol
+  - mode
+  - paired sessions
+  - MCP/WebApp/Gateway endpoints
+- Live text input button:
+  - `[txt]`
+  - sends literal text to tmux without pressing `Enter`
+
+### 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.
+- CLI now shows package version directly in banners and startup output.
+
+### 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.
+- Live toolbar now includes:
+  - `/`
+  - `↑`
+  - `↓`
+  - `Enter`
+  - `⌫`
+  - `[txt]`
+  - `Tab`
+  - `Esc`
+  - `Ctrl+C`
+- `Ctrl+C` now asks for confirmation before sending an interrupt to the agent.
+- Mobile toolbar layout now wraps cleanly into two rows instead of collapsing into a centered stack.
+
+### 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`);
     }
@@ -666,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`);

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

@@ -554,15 +554,26 @@ const TelegramMcpGatewaySocketService = {
                     const action = typeof request.payload?.action === "string"
                         ? request.payload.action
                         : "";
-                    if (!["up", "down", "enter", "slash", "delete", "tab", "escape", "interrupt"].includes(action)) {
+                    const text = typeof request.payload?.text === "string"
+                        ? request.payload.text
+                        : "";
+                    if (!["up", "down", "enter", "slash", "delete", "tab", "escape", "interrupt", "text"].includes(action)) {
                         throw new Error("Unsupported action");
                     }
+                    if (action === "text" && (!text || text.length > 4000)) {
+                        throw new Error("Text payload is required and must be <= 4000 characters");
+                    }
                     const sessionId = request.local_session_id.trim();
                     const session = await runtime.sessionStore.getSession(sessionId);
                     if (!session?.tmuxTarget) {
                         throw new Error("tmux target is not configured for this session");
                     }
-                    await (0, tmux_1.sendAllowedTmuxAction)(runtime.config.tmux, session.tmuxTarget, action);
+                    if (action === "text") {
+                        await (0, tmux_1.sendTmuxLiteralText)(runtime.config.tmux, session.tmuxTarget, text);
+                    }
+                    else {
+                        await (0, tmux_1.sendAllowedTmuxAction)(runtime.config.tmux, session.tmuxTarget, action);
+                    }
                     return {
                         type: "live_response",
                         request_id: request.request_id,

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,10 +428,19 @@ function createMcpHttpHandler(runtime, input) {
                     typeof Reflect.get(body, "action") === "string"
                     ? String(Reflect.get(body, "action"))
                     : "";
-                if (!["up", "down", "enter", "slash", "delete", "tab", "escape", "interrupt"].includes(action)) {
+                const text = body &&
+                    typeof body === "object" &&
+                    typeof Reflect.get(body, "text") === "string"
+                    ? String(Reflect.get(body, "text"))
+                    : "";
+                if (!["up", "down", "enter", "slash", "delete", "tab", "escape", "interrupt", "text"].includes(action)) {
                     writeText(res, 400, "Unsupported action");
                     return;
                 }
+                if (action === "text" && (!text || text.length > 4000)) {
+                    writeText(res, 400, "Text payload is required and must be <= 4000 characters");
+                    return;
+                }
                 const nowMs = Date.now();
                 if (nowMs - webAppSession.lastActionAtMs <
                     runtime.config.webapp.actionCooldownMs) {
@@ -445,6 +454,7 @@ function createMcpHttpHandler(runtime, input) {
                             clientUuid: relayTarget.clientUuid,
                             localSessionId: relayTarget.localSessionId,
                             action: action,
+                            ...(action === "text" ? { text } : {}),
                         });
                         webAppSessions.touchAction(webAppSession.token, nowMs);
                         writeJson(res, 200, {
@@ -477,12 +487,18 @@ function createMcpHttpHandler(runtime, input) {
                     return;
                 }
                 try {
-                    await (0, tmux_1.sendAllowedTmuxAction)(runtime.config.tmux, session.tmuxTarget, action);
+                    if (action === "text") {
+                        await (0, tmux_1.sendTmuxLiteralText)(runtime.config.tmux, session.tmuxTarget, text);
+                    }
+                    else {
+                        await (0, tmux_1.sendAllowedTmuxAction)(runtime.config.tmux, session.tmuxTarget, action);
+                    }
                     webAppSessions.touchAction(webAppSession.token, nowMs);
                     runtime.logger.info("Telegram WebApp action sent to tmux", {
                         sessionId: webAppSession.sessionId,
                         telegramUserId: webAppSession.telegramUserId,
                         action,
+                        ...(action === "text" ? { textLength: text.length } : {}),
                     });
                     writeJson(res, 200, {
                         ok: true,

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

@@ -42,7 +42,7 @@ body {
   bottom: calc(42px + env(safe-area-inset-bottom, 0px));
   z-index: 30;
   display: flex;
-  justify-content: center;
+  justify-content: flex-start;
   flex-wrap: wrap;
   gap: 8px;
   padding: 10px 14px;
@@ -52,6 +52,11 @@ body {
   backdrop-filter: blur(14px);
 }
 
+.toolbar-spacer {
+  flex: 1 1 auto;
+  min-width: 12px;
+}
+
 .btn {
   appearance: none;
   border: 1px solid var(--border);
@@ -73,6 +78,28 @@ body {
 .btn:disabled { cursor: not-allowed; opacity: 0.55; }
 .btn.danger:hover { border-color: var(--danger); }
 
+.btn.danger {
+  border-color: rgba(255, 116, 116, 0.55);
+  background: linear-gradient(180deg, rgba(78, 18, 24, 0.96) 0%, rgba(50, 14, 18, 0.98) 100%);
+  color: #ffd7d7;
+  box-shadow: inset 0 0 0 1px rgba(255, 116, 116, 0.12);
+}
+
+.btn.danger:hover {
+  border-color: rgba(255, 116, 116, 0.9);
+}
+
+.btn.primary {
+  border-color: rgba(87, 193, 255, 0.45);
+  background: linear-gradient(180deg, rgba(17, 45, 66, 0.96) 0%, rgba(12, 33, 48, 0.98) 100%);
+  color: #d9f3ff;
+  box-shadow: inset 0 0 0 1px rgba(87, 193, 255, 0.1);
+}
+
+.btn.primary:hover {
+  border-color: rgba(87, 193, 255, 0.8);
+}
+
 .statusbar {
   position: fixed;
   left: 0;
@@ -138,6 +165,11 @@ body {
     padding: 8px 10px;
   }
 
+  .toolbar-spacer {
+    flex: 1 1 auto;
+    min-width: 12px;
+  }
+
   .btn.compact {
     min-width: 42px;
     padding: 8px 10px;
@@ -169,6 +201,7 @@ const elements = {
   status: document.querySelector("[data-role=status]"),
   updated: document.querySelector("[data-role=updated]"),
   interrupt: document.querySelector("[data-role=interrupt]"),
+  type: document.querySelector("[data-role=type]"),
   esc: document.querySelector("[data-role=escape]"),
   tab: document.querySelector("[data-role=tab]"),
   slash: document.querySelector("[data-role=slash]"),
@@ -571,6 +604,47 @@ async function sendAction(action) {
   }
 }
 
+async function sendTextInput(text) {
+  if (state.actionBusy || !state.token) {
+    return;
+  }
+
+  state.actionBusy = true;
+  try {
+    const response = await fetch(config.basePath + "/api/action", {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: "Bearer " + state.token,
+      },
+      body: JSON.stringify({ action: "text", text }),
+    });
+
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(text || "Failed to send text.");
+    }
+
+    setStatus("Text sent");
+    await refreshVisibleBuffer();
+  } finally {
+    state.actionBusy = false;
+  }
+}
+
+function confirmInterrupt() {
+  return new Promise((resolve) => {
+    if (tg && typeof tg.showConfirm === "function") {
+      tg.showConfirm("Send Ctrl+C to the tmux session? This can stop the running agent.", (ok) => {
+        resolve(Boolean(ok));
+      });
+      return;
+    }
+
+    resolve(window.confirm("Send Ctrl+C to the tmux session? This can stop the running agent."));
+  });
+}
+
 async function refreshVisibleBuffer() {
   const payload = await fetchVisibleBuffer();
   elements.terminal.innerHTML = renderAnsiToHtml(payload.content || "");
@@ -599,7 +673,22 @@ function startPolling() {
 
 function bindUi() {
   elements.interrupt.addEventListener("click", () => {
-    sendAction("interrupt").catch((error) => setStatus(error.message || String(error), true));
+    confirmInterrupt()
+      .then((ok) => {
+        if (!ok) {
+          return;
+        }
+        return sendAction("interrupt");
+      })
+      .catch((error) => setStatus(error.message || String(error), true));
+  });
+
+  elements.type.addEventListener("click", () => {
+    const value = window.prompt("Send text to tmux without Enter:", "");
+    if (value === null || value.length === 0) {
+      return;
+    }
+    sendTextInput(value).catch((error) => setStatus(error.message || String(error), true));
   });
 
   elements.esc.addEventListener("click", () => {
@@ -670,6 +759,7 @@ async function main() {
 
     if (!bootstrapPayload.tmux_target) {
       elements.interrupt.disabled = true;
+      elements.type.disabled = true;
       elements.esc.disabled = true;
       elements.tab.disabled = true;
       elements.slash.disabled = true;
@@ -710,14 +800,16 @@ 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>
-        <button class="btn compact" data-role="delete" type="button">⌫</button>
         <button class="btn compact" data-role="up" type="button">↑</button>
         <button class="btn compact" data-role="down" type="button">↓</button>
-        <button class="btn compact" data-role="enter" type="button">↵</button>
+        <button class="btn compact primary" data-role="enter" type="button">Enter</button>
+        <button class="btn compact" data-role="delete" type="button">⌫</button>
+        <button class="btn compact" data-role="type" type="button" title="Type text">🔤</button>
+        <button class="btn compact" data-role="tab" type="button">Tab</button>
+        <button class="btn compact" data-role="escape" type="button">Esc</button>
+        <span class="toolbar-spacer" aria-hidden="true"></span>
+        <button class="btn compact danger" data-role="interrupt" type="button">Ctrl+C</button>
       </div>
       <pre class="terminal" data-role="terminal">Waiting for tmux buffer…</pre>
       <div class="statusbar">

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

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sendAllowedTmuxAction = exports.isTmuxUnavailableError = exports.getTmuxWindowHeight = exports.captureVisibleTmuxPane = exports.captureTmuxPaneRange = void 0;
+exports.sendTmuxLiteralText = exports.sendAllowedTmuxAction = exports.isTmuxUnavailableError = exports.getTmuxWindowHeight = exports.captureVisibleTmuxPane = exports.captureTmuxPaneRange = void 0;
 var client_1 = require("../../shared/integrations/tmux/client");
 Object.defineProperty(exports, "captureTmuxPaneRange", { enumerable: true, get: function () { return client_1.captureTmuxPaneRange; } });
 Object.defineProperty(exports, "captureVisibleTmuxPane", { enumerable: true, get: function () { return client_1.captureVisibleTmuxPane; } });
 Object.defineProperty(exports, "getTmuxWindowHeight", { enumerable: true, get: function () { return client_1.getTmuxWindowHeight; } });
 Object.defineProperty(exports, "isTmuxUnavailableError", { enumerable: true, get: function () { return client_1.isTmuxUnavailableError; } });
 Object.defineProperty(exports, "sendAllowedTmuxAction", { enumerable: true, get: function () { return client_1.sendAllowedTmuxAction; } });
+Object.defineProperty(exports, "sendTmuxLiteralText", { enumerable: true, get: function () { return client_1.sendTmuxLiteralText; } });

package/dist/services/features/telegram-mcp/src/features/distributed-gateway/model/gatewayHttpService.js

@@ -173,6 +173,7 @@ class GatewayHttpService {
             requestType: "action",
             payload: {
                 action: input.action,
+                ...(input.action === "text" ? { text: input.text ?? "" } : {}),
             },
         }, { meta: { internal_call: true } });
         const response = unwrapLiveRelayResult(rawResponse);

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

@@ -14,6 +14,7 @@ exports.getTmuxWindowHeight = getTmuxWindowHeight;
 exports.captureTmuxPaneRange = captureTmuxPaneRange;
 exports.captureVisibleTmuxPane = captureVisibleTmuxPane;
 exports.sendAllowedTmuxAction = sendAllowedTmuxAction;
+exports.sendTmuxLiteralText = sendTmuxLiteralText;
 exports.sendTmuxLiteralLine = sendTmuxLiteralLine;
 const node_child_process_1 = require("node:child_process");
 const promises_1 = require("node:fs/promises");
@@ -258,8 +259,8 @@ async function sendAllowedTmuxAction(config, target, action) {
                                 : "Enter";
     await execFileAsync("tmux", buildTmuxArgs(config, ["send-keys", "-t", target, key]));
 }
-async function sendTmuxLiteralLine(config, target, text) {
-    const normalized = text.replace(/\r?\n/g, " ").trim();
+async function sendTmuxLiteralText(config, target, text) {
+    const normalized = text.replace(/\r?\n/g, " ");
     const bufferName = `telegram-mcp-${Date.now().toString(36)}`;
     if (normalized.length > 0) {
         try {
@@ -276,6 +277,11 @@ async function sendTmuxLiteralLine(config, target, text) {
         finally {
             await execFileAsync("tmux", buildTmuxArgs(config, ["delete-buffer", "-b", bufferName])).catch(() => undefined);
         }
+    }
+}
+async function sendTmuxLiteralLine(config, target, text) {
+    await sendTmuxLiteralText(config, target, text);
+    if (text.length > 0) {
         await delay(ENTER_AFTER_PASTE_DELAY_MS);
     }
     await execFileAsync("tmux", buildTmuxArgs(config, ["send-keys", "-t", target, SUBMIT_LINE_KEY]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deadragdoll/tellymcp",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "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",