@deadragdoll/tellymcp 0.0.3 → 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)

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`);
     }
@@ -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/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/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/package.json

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