@deadragdoll/tellymcp 0.0.9 → 0.0.10

package/.env.example.client

@@ -4,6 +4,8 @@
 TELEGRAM_BOT_TOKEN=
 # Username бота, с @ или без.
 TELEGRAM_BOT_USERNAME=
+# Принудительный язык UI для отладки локализации: en или ru.
+# DEBUG_LANGUAGE=ru
 # Необязательная подпись проекта/сессии в prompt и note.
 PROJECT_NAME=
 

package/.env.example.gateway

@@ -4,6 +4,8 @@
 TELEGRAM_BOT_TOKEN=
 # Username бота, с @ или без.
 TELEGRAM_BOT_USERNAME=
+# Принудительный язык UI для отладки локализации: en или ru.
+# DEBUG_LANGUAGE=ru
 # Необязательная подпись проекта/сессии.
 PROJECT_NAME=
 

package/VERSION.md

@@ -4,6 +4,32 @@ Public, user-facing release notes for published versions of `@deadragdoll/tellym
 
 For detailed engineering history, refactors, and internal development notes, see [CHANGELOG.md](CHANGELOG.md).
 
+## 0.0.10
+
+### Added
+- Telegram UI localization for the bot layer:
+  - English and Russian catalogs for user-facing bot screens
+  - locale resolution from Telegram profile with persisted user preference
+  - `DEBUG_LANGUAGE=en|ru` override for fast testing without changing the Telegram profile
+
+### Changed
+- Localization scope is now explicit:
+  - Telegram bot UI is localized
+  - MCP tools, logs, `TOOLS.md`, and the Live Mini App remain canonical English by design
+- Telegram menus, callbacks, project/collaboration screens, startup notices, and operational bot notices now render through a shared translation layer instead of ad hoc inline strings
+
+### Fixed
+- Builder startup is more robust:
+  - runtime-dependent services now wait for full runtime readiness instead of racing broker registration
+  - this avoids `telegram_mcp runtime is not initialized yet` failures during `yarn dev:builder`
+- Locale resolution is safe for partial test mocks and startup paths
+- Telegram UI text is now consistent across:
+  - main menus
+  - inbox/session flows
+  - project/collab flows
+  - live approval prompts
+  - tmux and operational bot notices
+
 ## 0.0.9
 
 ### Added

package/config/templates/env.both.template

@@ -2,6 +2,7 @@
 
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_BOT_USERNAME=
+# DEBUG_LANGUAGE=ru
 PROJECT_NAME=
 
 REDIS_HOST=127.0.0.1

package/config/templates/env.client.template

@@ -2,6 +2,7 @@
 
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_BOT_USERNAME=
+# DEBUG_LANGUAGE=ru
 PROJECT_NAME=
 
 REDIS_HOST=127.0.0.1

package/config/templates/env.gateway.template

@@ -2,6 +2,7 @@
 
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_BOT_USERNAME=
+# DEBUG_LANGUAGE=ru
 PROJECT_NAME=
 
 REDIS_HOST=127.0.0.1

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

@@ -24,7 +24,7 @@ const TelegramMcpApprovalService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp approval service");
         this.approvalOrchestrator = new orchestrator_1.HumanApprovalOrchestrator(runtime.config, runtime.stateStore, runtime.stateStore, runtime.stateStore, runtime.telegramTransport, runtime.logger, runtime.projectIdentityResolver);
         this.logger.info("telegram_mcp approval service is ready");

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

@@ -24,7 +24,7 @@ const TelegramMcpBrowserService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp browser service");
         this.browserService = new browserService_1.BrowserService(runtime.config, runtime.stateStore, runtime.stateStore, runtime.stateStore, runtime.objectStore, runtime.telegramTransport, runtime.logger, runtime.projectIdentityResolver);
         this.logger.info("telegram_mcp browser service is ready");

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

@@ -34,7 +34,7 @@ const TelegramMcpCollaborationService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp collaboration service");
         const localBackend = new localCollaborationBackend_1.LocalCollaborationBackend(runtime.config, runtime.stateStore, runtime.stateStore, runtime.stateStore, runtime.stateStore, runtime.objectStore, runtime.telegramTransport, runtime.logger);
         runtime.gatewayHttpService.setPartnerNoteRelayHandler(async (input) => {

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

@@ -276,10 +276,11 @@ const TelegramMcpGatewayRmqService = {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
         this.runtimeService = runtimeService;
+        const runtime = await runtimeService.waitUntilReady();
         if (!this.isEnabled?.()) {
             this.logger.info("Gateway RMQ is disabled", {
-                distributedMode: runtimeService.getRuntime().config.distributed.mode,
-                rmqConfigured: Boolean(runtimeService.getRuntime().config.distributed.rmq?.host),
+                distributedMode: runtime.config.distributed.mode,
+                rmqConfigured: Boolean(runtime.config.distributed.rmq?.host),
             });
             return;
         }

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

@@ -1455,8 +1455,14 @@ const TelegramMcpGatewaySocketService = {
         },
     },
     async started() {
-        const runtime = this.getRuntimeOrThrow?.();
-        const mode = runtime?.config.distributed.mode;
+        await this.broker.waitForServices([runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME]);
+        const runtimeService = this.broker.getLocalService(runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME);
+        if (!runtimeService) {
+            throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
+        }
+        this.runtimeService = runtimeService;
+        const runtime = await runtimeService.waitUntilReady();
+        const mode = runtime.config.distributed.mode;
         const gatewayEnabled = mode === "gateway" || mode === "both";
         const clientEnabled = mode === "client" || mode === "both";
         if (gatewayEnabled) {

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

@@ -24,7 +24,7 @@ const TelegramMcpInboxService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp inbox service");
         this.inboxService = new inboxService_1.InboxService(runtime.config, runtime.stateStore, runtime.stateStore, runtime.logger, runtime.projectIdentityResolver);
         this.logger.info("telegram_mcp inbox service is ready");

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

@@ -52,7 +52,7 @@ const TelegramMcpHttpService = {
         if (!mcpServerService) {
             throw new Error(`Local Moleculer service '${mcp_server_service_1.TELEGRAM_MCP_MCP_SERVER_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp HTTP service");
         this.httpHandler = (0, http_1.createMcpHttpHandler)(runtime, {
             createMcpServer: () => mcpServerService.createServer(),

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

@@ -24,7 +24,7 @@ const TelegramMcpNotifyService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp notify service");
         this.notifyService = new notifyService_1.NotifyService(runtime.config, runtime.stateStore, runtime.stateStore, runtime.telegramTransport, runtime.logger, runtime.projectIdentityResolver);
         this.logger.info("telegram_mcp notify service is ready");

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

@@ -24,7 +24,7 @@ const TelegramMcpPairService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp pair service");
         this.pairSessionService = new generatePairCode_1.PairSessionService(runtime.config, runtime.stateStore, runtime.stateStore, runtime.stateStore, runtime.logger, runtime.projectIdentityResolver);
         this.logger.info("telegram_mcp pair service is ready");

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

@@ -8,6 +8,10 @@ const TelegramMcpRuntimeService = {
     name: exports.TELEGRAM_MCP_RUNTIME_SERVICE_NAME,
     created() {
         this.runtime = null;
+        this.readyPromise = new Promise((resolve, reject) => {
+            this.resolveReady = resolve;
+            this.rejectReady = reject;
+        });
     },
     methods: {
         getRuntime() {
@@ -16,19 +20,35 @@ const TelegramMcpRuntimeService = {
             }
             return this.runtime;
         },
+        waitUntilReady() {
+            if (this.runtime) {
+                return Promise.resolve(this.runtime);
+            }
+            if (!this.readyPromise) {
+                return Promise.reject(new Error("telegram_mcp runtime readiness promise is unavailable"));
+            }
+            return this.readyPromise;
+        },
     },
     async started() {
         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", {
-            packageVersion: (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname),
-            protocolVersion: versionHandshake_1.TELLYMCP_PROTOCOL_VERSION,
-        });
+        try {
+            this.runtime = await (0, runtime_1.createAppRuntime)({
+                callBroker: (actionName, params, options) => this.broker.call(actionName, params, options),
+            });
+            this.resolveReady?.(this.runtime);
+            this.logger.info("telegram_mcp runtime service is ready", {
+                packageVersion: (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname),
+                protocolVersion: versionHandshake_1.TELLYMCP_PROTOCOL_VERSION,
+            });
+        }
+        catch (error) {
+            this.rejectReady?.(error);
+            throw error;
+        }
     },
     async stopped() {
         if (!this.runtime) {

package/dist/services/features/telegram-mcp/session-context.service.js

@@ -24,7 +24,7 @@ const TelegramMcpSessionContextService = {
         if (!runtimeService) {
             throw new Error(`Local Moleculer service '${runtime_service_1.TELEGRAM_MCP_RUNTIME_SERVICE_NAME}' is unavailable`);
         }
-        const runtime = runtimeService.getRuntime();
+        const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp session-context service");
         this.sessionContextService = new sessionContextService_1.SessionContextService(runtime.stateStore, runtime.stateStore, runtime.logger, runtime.projectIdentityResolver);
         this.logger.info("telegram_mcp session-context service is ready");

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

@@ -72,7 +72,7 @@ async function createAppRuntime(input) {
     const objectStore = new minioExchangeStore_1.MinioExchangeStore(input.callBroker, stateStore, config.tmux, config.exchange.dir, config.mcp.vfsScope, logger, config.distributed.mode, config.distributed.gatewayPublicUrl, config.distributed.gatewayAuthToken);
     await stateStore.resetRuntimeState();
     logger.info("Runtime pending state reset");
-    const telegramTransport = new transport_1.TelegramTransport(config, stateStore, stateStore, stateStore, stateStore, stateStore, stateStore, objectStore, webAppLaunchRegistry, logger);
+    const telegramTransport = new transport_1.TelegramTransport(config, stateStore, stateStore, stateStore, stateStore, stateStore, stateStore, stateStore, objectStore, webAppLaunchRegistry, logger);
     await telegramTransport.start();
     logger.info("Telegram transport ready");
     await telegramTransport.recoverPendingInboxNudges();
@@ -89,6 +89,7 @@ async function createAppRuntime(input) {
         sessionStore: stateStore,
         bindingStore: stateStore,
         inboxStore: stateStore,
+        localeStore: stateStore,
         xchangeFileMetaStore: stateStore,
         maintenanceStore: stateStore,
         objectStore,

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

@@ -59,6 +59,7 @@ const envSchema = z.object({
         .int()
         .positive()
         .default(300),
+    DEBUG_LANGUAGE: z.enum(["en", "ru"]).optional(),
     REDIS_HOST: z.string().min(1),
     REDIS_PORT: z.coerce.number().int().positive(),
     REDIS_DB: z.coerce.number().int().nonnegative(),
@@ -205,6 +206,9 @@ function loadConfig() {
             ...(parsed.TELEGRAM_BOT_USERNAME
                 ? { botUsername: parsed.TELEGRAM_BOT_USERNAME }
                 : {}),
+            ...(parsed.DEBUG_LANGUAGE
+                ? { debugLanguage: parsed.DEBUG_LANGUAGE }
+                : {}),
             pollIntervalMs: parsed.TELEGRAM_POLL_INTERVAL_MS,
             defaultTimeoutSeconds: parsed.TELEGRAM_DEFAULT_TIMEOUT_SECONDS,
             maxContextChars: parsed.TELEGRAM_MAX_CONTEXT_CHARS,

package/dist/services/features/telegram-mcp/src/shared/i18n/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeLocale = normalizeLocale;
+exports.translate = translate;
+const i18next_1 = require("i18next");
+const en_1 = require("./resources/en");
+const ru_1 = require("./resources/ru");
+const instance = (0, i18next_1.createInstance)();
+void instance.init({
+    lng: "en",
+    fallbackLng: "en",
+    ns: ["common", "menu"],
+    defaultNS: "common",
+    initAsync: false,
+    interpolation: {
+        escapeValue: false,
+    },
+    returnNull: false,
+    returnEmptyString: false,
+    resources: {
+        en: {
+            common: en_1.enCommon,
+            menu: en_1.enMenu,
+        },
+        ru: {
+            common: ru_1.ruCommon,
+            menu: ru_1.ruMenu,
+        },
+    },
+});
+function normalizeLocale(input) {
+    const normalized = input?.trim().toLowerCase() ?? "";
+    if (normalized === "ru" || normalized.startsWith("ru-")) {
+        return "ru";
+    }
+    if (normalized === "en" || normalized.startsWith("en-")) {
+        return "en";
+    }
+    return "en";
+}
+function translate(locale, key, options) {
+    return instance.t(key, {
+        lng: normalizeLocale(locale),
+        ...(options ?? {}),
+    });
+}