@deadragdoll/tellymcp 0.0.14 → 0.0.15

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

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfig = loadConfig;
 const node_fs_1 = require("node:fs");
 const z = __importStar(require("zod/v4"));
+const environmentContract_1 = require("./environmentContract");
 const emptyStringToUndefined = (value) => {
     if (typeof value !== "string") {
         return value;
@@ -79,13 +80,12 @@ const envSchema = z.object({
         .optional()
         .transform((value) => value === "true"),
     DEBUG_LANGUAGE: z.preprocess(emptyStringToUndefined, 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(),
+    REDIS_HOST: z.string().min(1).default("127.0.0.1"),
+    REDIS_PORT: z.coerce.number().int().positive().default(6379),
+    REDIS_DB: z.coerce.number().int().nonnegative().default(1),
     REDIS_USERNAME: optionalNonEmptyString,
     REDIS_PASSWORD: optionalNonEmptyString,
-    MODE: z.enum(["queue", "reject"]).default("queue"),
-    PAIR_CODE_TTL_SECONDS: z.coerce.number().int().positive().default(600),
+    TELEGRAM_REQUEST_MODE: z.enum(["queue", "reject"]).default("queue"),
     PROJECT_NAME: optionalNonEmptyString,
     TELLYMCP_SESSION_ID: optionalNonEmptyString,
     TELLYMCP_SESSION_LABEL: optionalNonEmptyString,
@@ -117,24 +117,16 @@ const envSchema = z.object({
         .string()
         .optional()
         .transform((value) => value === "true"),
-    MCP_VFS_SCOPE: z.string().min(1).default("mcp"),
     DISTRIBUTED_MODE: z.enum(["client", "gateway", "both"]).default("client"),
     GATEWAY_PUBLIC_URL: optionalUrlString,
-    GATEWAY_BIND_HOST: z.string().min(1).default("127.0.0.1"),
-    GATEWAY_BIND_PORT: z.coerce.number().int().positive().default(8790),
     GATEWAY_WS_URL: optionalUrlString,
     GATEWAY_WS_PATH: z
         .string()
         .min(1)
         .default(`${(process.env.ROOT_PREFIX || "/api").replace(/\/+$/u, "")}/gateway/ws`),
-    GATEWAY_TOKEN: optionalNonEmptyString,
+    GATEWAY_SCOPE_TOKEN: optionalNonEmptyString,
     GATEWAY_USER_UUID: optionalNonEmptyString,
     GATEWAY_AUTH_TOKEN: optionalNonEmptyString,
-    GATEWAY_DATABASE_URL: optionalNonEmptyString,
-    GATEWAY_S3_ENDPOINT: optionalNonEmptyString,
-    GATEWAY_S3_BUCKET: optionalNonEmptyString,
-    GATEWAY_S3_ACCESS_KEY: optionalNonEmptyString,
-    GATEWAY_S3_SECRET_KEY: optionalNonEmptyString,
     RMQ_HOST: optionalNonEmptyString,
     RMQ_PORT: z.coerce.number().int().positive().optional(),
     RMQ_USER: optionalNonEmptyString,
@@ -256,6 +248,7 @@ function loadConfig() {
     else if ((0, node_fs_1.existsSync)(".env")) {
         process.loadEnvFile(".env");
     }
+    (0, environmentContract_1.assertNoLegacyEnvironmentVariables)(process.env);
     const parsed = envSchema.parse(process.env);
     if (parsed.DISTRIBUTED_MODE !== "client" &&
         !parsed.TELEGRAM_BOT_TOKEN?.trim()) {
@@ -403,13 +396,11 @@ function loadConfig() {
             ...(parsed.REDIS_USERNAME ? { username: parsed.REDIS_USERNAME } : {}),
             ...(parsed.REDIS_PASSWORD ? { password: parsed.REDIS_PASSWORD } : {}),
         },
-        mode: parsed.MODE,
-        pairCodeTtlSeconds: parsed.PAIR_CODE_TTL_SECONDS,
+        mode: parsed.TELEGRAM_REQUEST_MODE,
         mcp: {
             httpHost: parsed.MCP_HTTP_HOST,
             httpPort: parsed.MCP_HTTP_PORT,
             httpPath: parsed.MCP_HTTP_PATH,
-            vfsScope: parsed.MCP_VFS_SCOPE,
             ...(parsed.MCP_HTTP_BEARER_TOKEN
                 ? { bearerToken: parsed.MCP_HTTP_BEARER_TOKEN }
                 : {}),
@@ -451,14 +442,12 @@ function loadConfig() {
             ...(parsed.GATEWAY_PUBLIC_URL
                 ? { gatewayPublicUrl: parsed.GATEWAY_PUBLIC_URL }
                 : {}),
-            gatewayBindHost: parsed.GATEWAY_BIND_HOST,
-            gatewayBindPort: parsed.GATEWAY_BIND_PORT,
             ...(parsed.GATEWAY_WS_URL
                 ? { gatewayWsUrl: parsed.GATEWAY_WS_URL }
                 : {}),
             gatewayWsPath: parsed.GATEWAY_WS_PATH,
-            ...(parsed.GATEWAY_TOKEN
-                ? { gatewayToken: parsed.GATEWAY_TOKEN }
+            ...(parsed.GATEWAY_SCOPE_TOKEN
+                ? { gatewayScopeToken: parsed.GATEWAY_SCOPE_TOKEN }
                 : {}),
             ...(parsed.GATEWAY_USER_UUID
                 ? { gatewayUserUuid: parsed.GATEWAY_USER_UUID }
@@ -466,21 +455,6 @@ function loadConfig() {
             ...(parsed.GATEWAY_AUTH_TOKEN
                 ? { gatewayAuthToken: parsed.GATEWAY_AUTH_TOKEN }
                 : {}),
-            ...(parsed.GATEWAY_DATABASE_URL
-                ? { gatewayDatabaseUrl: parsed.GATEWAY_DATABASE_URL }
-                : {}),
-            ...(parsed.GATEWAY_S3_ENDPOINT
-                ? { gatewayS3Endpoint: parsed.GATEWAY_S3_ENDPOINT }
-                : {}),
-            ...(parsed.GATEWAY_S3_BUCKET
-                ? { gatewayS3Bucket: parsed.GATEWAY_S3_BUCKET }
-                : {}),
-            ...(parsed.GATEWAY_S3_ACCESS_KEY
-                ? { gatewayS3AccessKey: parsed.GATEWAY_S3_ACCESS_KEY }
-                : {}),
-            ...(parsed.GATEWAY_S3_SECRET_KEY
-                ? { gatewayS3SecretKey: parsed.GATEWAY_S3_SECRET_KEY }
-                : {}),
             ...(parsed.RMQ_HOST
                 ? {
                     rmq: {

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

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REMOVED_ENV_KEYS = exports.LEGACY_ENV_RENAMES = void 0;
+exports.getTmuxReplacement = getTmuxReplacement;
+exports.assertNoLegacyEnvironmentVariables = assertNoLegacyEnvironmentVariables;
+exports.LEGACY_ENV_RENAMES = {
+    MODE: "TELEGRAM_REQUEST_MODE",
+    GATEWAY_TOKEN: "GATEWAY_SCOPE_TOKEN",
+    DB_SCHEME: "DB_SCHEMA",
+    ENABLE_LOGFEED: "LOGFEED_ENABLED",
+};
+exports.REMOVED_ENV_KEYS = [
+    "APP_NAME",
+    "BROWSER_ATTACH_TOKEN",
+    "GATEWAY_BIND_HOST",
+    "GATEWAY_BIND_PORT",
+    "GATEWAY_DATABASE_URL",
+    "GATEWAY_S3_ACCESS_KEY",
+    "GATEWAY_S3_BUCKET",
+    "GATEWAY_S3_ENDPOINT",
+    "GATEWAY_S3_SECRET_KEY",
+    "MAX_BODY_SIZE",
+    "MCP_VFS_SCOPE",
+    "PAIR_CODE_TTL_SECONDS",
+    "SESSION_SECRET",
+    "TELEGRAM_INBOX_BATCH_SIZE",
+    "TERMINAL_TRANSPORT",
+    "TOKEN_BINDING_SECRET",
+    "WEBAPP_POLL_INTERVAL_MS",
+];
+function getTmuxReplacement(name) {
+    if (!name.startsWith("TMUX_")) {
+        return null;
+    }
+    if (name === "TMUX_SOCKET_PATH") {
+        return null;
+    }
+    return `TERMINAL_${name.slice("TMUX_".length)}`;
+}
+function assertNoLegacyEnvironmentVariables(environment) {
+    const issues = [];
+    for (const [legacyName, replacement] of Object.entries(exports.LEGACY_ENV_RENAMES)) {
+        const value = environment[legacyName];
+        if (value !== undefined) {
+            // MODE is also set by tools such as Vite. Only the two former TellyMCP
+            // queue-policy values identify it as our legacy setting.
+            if (legacyName === "MODE" && value !== "queue" && value !== "reject") {
+                continue;
+            }
+            issues.push(`${legacyName} -> ${replacement}`);
+        }
+    }
+    for (const name of exports.REMOVED_ENV_KEYS) {
+        if (environment[name] !== undefined) {
+            issues.push(`${name} (remove)`);
+        }
+    }
+    for (const tmuxName of Object.keys(environment).filter((name) => name.startsWith("TMUX_"))) {
+        const replacement = getTmuxReplacement(tmuxName);
+        issues.push(replacement ? `${tmuxName} -> ${replacement}` : `${tmuxName} (remove)`);
+    }
+    if (issues.length > 0) {
+        throw new Error(`Environment migration is required: ${issues.sort().join(", ")}. ` +
+            "Run: tellymcp migrate-env <input.env> > .migrated-env");
+    }
+}

package/dist/services/features/telegram-mcp/src/entities/request/model/schema.js

@@ -33,8 +33,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.browserWaitForInputSchema = exports.browserInjectScriptOutputSchema = exports.browserInjectScriptInputSchema = exports.browserPressOutputSchema = exports.browserPressInputSchema = exports.browserFillOutputSchema = exports.browserFillInputSchema = exports.browserClickOutputSchema = exports.browserClickInputSchema = exports.browserReloadOutputSchema = exports.browserReloadInputSchema = exports.browserRecordingStatusOutputSchema = exports.browserRecordingStatusInputSchema = exports.browserRecordingStopOutputSchema = exports.browserRecordingStopInputSchema = exports.browserRecordingStartOutputSchema = exports.browserRecordingStartInputSchema = exports.browserDetachTabOutputSchema = exports.browserDetachTabInputSchema = exports.browserAttachTabOutputSchema = exports.browserAttachTabInputSchema = exports.browserAttachActiveTabInputSchema = exports.browserListTabsOutputSchema = exports.browserListTabsInputSchema = exports.browserListAttachedInstancesOutputSchema = exports.browserListAttachedInstancesInputSchema = exports.browserOpenOutputSchema = exports.browserOpenInputSchema = exports.clearSessionContextOutputSchema = exports.clearSessionContextInputSchema = exports.getSessionContextOutputSchema = exports.getSessionContextInputSchema = exports.setSessionContextOutputSchema = exports.renameSessionOutputSchema = exports.renameSessionInputSchema = exports.setSessionContextInputSchema = exports.refreshToolsMarkdownOutputSchema = exports.refreshToolsMarkdownInputSchema = exports.listGatewaySessionsOutputSchema = exports.listGatewaySessionsInputSchema = exports.getFileListOutputSchema = exports.getFileListInputSchema = exports.getFileOutputSchema = exports.getFileInputSchema = exports.sendFileToTelegramOutputSchema = exports.sendFileToTelegramInputSchema = exports.notifyTelegramOutputSchema = exports.notifyTelegramInputSchema = exports.askUserTelegramOutputSchema = exports.askUserTelegramInputSchema = void 0;
-exports.markXchangeRecordReadOutputSchema = exports.markXchangeRecordReadInputSchema = exports.getXchangeRecordOutputSchema = exports.getXchangeRecordInputSchema = exports.listXchangeRecordsOutputSchema = exports.listXchangeRecordsInputSchema = exports.sendPartnerNoteOutputSchema = exports.sendPartnerFileInputSchema = exports.sendPartnerNoteInputSchema = exports.browserCloseOutputSchema = exports.browserCloseInputSchema = exports.browserScreenshotOutputSchema = exports.browserScreenshotInputSchema = exports.browserComputedStyleOutputSchema = exports.browserComputedStyleInputSchema = exports.browserDomOutputSchema = exports.browserDomInputSchema = exports.browserClearLogsOutputSchema = exports.browserClearLogsInputSchema = exports.browserNetworkFailuresOutputSchema = exports.browserNetworkFailuresInputSchema = exports.browserErrorsOutputSchema = exports.browserErrorsInputSchema = exports.browserConsoleOutputSchema = exports.browserConsoleInputSchema = exports.browserWaitForUrlOutputSchema = exports.browserWaitForUrlInputSchema = exports.browserWaitForOutputSchema = void 0;
+exports.browserInjectScriptInputSchema = exports.browserPressOutputSchema = exports.browserPressInputSchema = exports.browserFillOutputSchema = exports.browserFillInputSchema = exports.browserClickOutputSchema = exports.browserClickInputSchema = exports.browserReloadOutputSchema = exports.browserReloadInputSchema = exports.browserRecordingStatusOutputSchema = exports.browserRecordingStatusInputSchema = exports.browserRecordingStopOutputSchema = exports.browserRecordingStopInputSchema = exports.browserRecordingStartOutputSchema = exports.browserRecordingStartInputSchema = exports.browserDetachTabOutputSchema = exports.browserDetachTabInputSchema = exports.browserAttachTabOutputSchema = exports.browserAttachTabInputSchema = exports.browserAttachActiveTabInputSchema = exports.browserListTabsOutputSchema = exports.browserListTabsInputSchema = exports.browserListAttachedInstancesOutputSchema = exports.browserListAttachedInstancesInputSchema = exports.browserOpenOutputSchema = exports.browserOpenInputSchema = exports.clearSessionContextOutputSchema = exports.clearSessionContextInputSchema = exports.getRuntimeDiagnosticsOutputSchema = exports.getRuntimeDiagnosticsInputSchema = exports.getSessionContextOutputSchema = exports.getSessionContextInputSchema = exports.setSessionContextOutputSchema = exports.renameSessionOutputSchema = exports.renameSessionInputSchema = exports.setSessionContextInputSchema = exports.refreshToolsMarkdownOutputSchema = exports.refreshToolsMarkdownInputSchema = exports.listGatewaySessionsOutputSchema = exports.listGatewaySessionsInputSchema = exports.getFileListOutputSchema = exports.getFileListInputSchema = exports.getFileOutputSchema = exports.getFileInputSchema = exports.sendFileToTelegramOutputSchema = exports.sendFileToTelegramInputSchema = exports.notifyTelegramOutputSchema = exports.notifyTelegramInputSchema = exports.askUserTelegramOutputSchema = exports.askUserTelegramInputSchema = void 0;
+exports.markXchangeRecordReadOutputSchema = exports.markXchangeRecordReadInputSchema = exports.getXchangeRecordOutputSchema = exports.getXchangeRecordInputSchema = exports.listXchangeRecordsOutputSchema = exports.listXchangeRecordsInputSchema = exports.sendPartnerNoteOutputSchema = exports.sendPartnerFileInputSchema = exports.sendPartnerNoteInputSchema = exports.browserCloseOutputSchema = exports.browserCloseInputSchema = exports.browserScreenshotOutputSchema = exports.browserScreenshotInputSchema = exports.browserComputedStyleOutputSchema = exports.browserComputedStyleInputSchema = exports.browserDomOutputSchema = exports.browserDomInputSchema = exports.browserClearLogsOutputSchema = exports.browserClearLogsInputSchema = exports.browserNetworkFailuresOutputSchema = exports.browserNetworkFailuresInputSchema = exports.browserErrorsOutputSchema = exports.browserErrorsInputSchema = exports.browserConsoleOutputSchema = exports.browserConsoleInputSchema = exports.browserWaitForUrlOutputSchema = exports.browserWaitForUrlInputSchema = exports.browserWaitForOutputSchema = exports.browserWaitForInputSchema = exports.browserInjectScriptOutputSchema = void 0;
 const z = __importStar(require("zod/v4"));
 const bodyLimits_1 = require("../../../shared/lib/bodyLimits");
 const bodyStringSchema = z.string().max(bodyLimits_1.MAX_BODY_SIZE_BYTES);
@@ -224,6 +224,32 @@ exports.getSessionContextOutputSchema = z.object({
     })
         .optional(),
 });
+const runtimeDiagnosticCheckSchema = z.object({
+    status: z.enum(["ok", "warn", "error"]),
+    message: z.string(),
+});
+exports.getRuntimeDiagnosticsInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+});
+exports.getRuntimeDiagnosticsOutputSchema = z.object({
+    status: z.enum(["ok", "degraded"]),
+    checked_at: z.string(),
+    session_id: z.string(),
+    runtime: z.object({
+        mode: z.enum(["client", "gateway", "both"]),
+        package_version: z.string(),
+        protocol_version: z.string(),
+        node_id: z.string().optional(),
+    }),
+    checks: z.object({
+        configuration: runtimeDiagnosticCheckSchema,
+        redis: runtimeDiagnosticCheckSchema,
+        session_store: runtimeDiagnosticCheckSchema,
+        terminal: runtimeDiagnosticCheckSchema,
+        gateway_configuration: runtimeDiagnosticCheckSchema,
+        relay: runtimeDiagnosticCheckSchema,
+    }),
+});
 exports.clearSessionContextInputSchema = z.object({
     session_id: z.string().trim().min(1).optional(),
 });

package/dist/services/features/telegram-mcp/src/features/browser/model/browserService.js

@@ -1752,8 +1752,8 @@ for (const __tellyKey of Object.getOwnPropertyNames(window)) {
             ...(this.config.distributed.gatewayAuthToken
                 ? { gatewayAuthToken: this.config.distributed.gatewayAuthToken }
                 : {}),
-            ...(this.config.distributed.gatewayToken
-                ? { gatewayToken: this.config.distributed.gatewayToken }
+            ...(this.config.distributed.gatewayScopeToken
+                ? { gatewayScopeToken: this.config.distributed.gatewayScopeToken }
                 : {}),
             ...(this.config.project.name
                 ? { projectName: this.config.project.name }

package/dist/services/features/telegram-mcp/src/features/collaboration/model/gatewaySessionsService.js

@@ -7,16 +7,16 @@ class GatewaySessionsService {
     maintenanceStore;
     gatewayPublicUrl;
     gatewayAuthToken;
-    gatewayToken;
+    gatewayScopeToken;
     gatewayUserUuid;
     projectName;
     botUsername;
-    constructor(logger, maintenanceStore, gatewayPublicUrl, gatewayAuthToken, gatewayToken, gatewayUserUuid, projectName, botUsername) {
+    constructor(logger, maintenanceStore, gatewayPublicUrl, gatewayAuthToken, gatewayScopeToken, gatewayUserUuid, projectName, botUsername) {
         this.logger = logger;
         this.maintenanceStore = maintenanceStore;
         this.gatewayPublicUrl = gatewayPublicUrl;
         this.gatewayAuthToken = gatewayAuthToken;
-        this.gatewayToken = gatewayToken;
+        this.gatewayScopeToken = gatewayScopeToken;
         this.gatewayUserUuid = gatewayUserUuid;
         this.projectName = projectName;
         this.botUsername = botUsername;
@@ -31,7 +31,7 @@ class GatewaySessionsService {
             ...(this.gatewayAuthToken
                 ? { gatewayAuthToken: this.gatewayAuthToken }
                 : {}),
-            ...(this.gatewayToken ? { gatewayToken: this.gatewayToken } : {}),
+            ...(this.gatewayScopeToken ? { gatewayScopeToken: this.gatewayScopeToken } : {}),
             ...(this.gatewayUserUuid ? { gatewayUserUuid: this.gatewayUserUuid } : {}),
             ...(this.projectName ? { projectName: this.projectName } : {}),
             ...(this.botUsername ? { botUsername: this.botUsername } : {}),
@@ -46,7 +46,7 @@ class GatewaySessionsService {
                 ...(input.client_uuid?.trim()
                     ? { client_uuid: input.client_uuid.trim() }
                     : {}),
-                ...(this.gatewayToken ? { gateway_token: this.gatewayToken } : {}),
+                ...(this.gatewayScopeToken ? { gateway_token: this.gatewayScopeToken } : {}),
                 ...(this.gatewayUserUuid
                     ? { owner_user_uuid: this.gatewayUserUuid }
                     : {}),

package/dist/services/features/telegram-mcp/src/features/distributed-client/model/gatewayClientAccess.js

@@ -68,7 +68,7 @@ async function ensureGatewayClientUuid(input) {
                 input.botUsername ||
                 "tellymcp client",
             ...(input.botUsername ? { bot_username: input.botUsername } : {}),
-            ...(input.gatewayToken ? { gateway_token: input.gatewayToken } : {}),
+            ...(input.gatewayScopeToken ? { gateway_token: input.gatewayScopeToken } : {}),
             ...(input.gatewayUserUuid ? { owner_user_uuid: input.gatewayUserUuid } : {}),
             meta: {
                 ...(namespace ? { namespace } : {}),

package/dist/services/features/telegram-mcp/src/features/distributed-client/model/gatewayCollaborationBackend.js

@@ -7,16 +7,16 @@ class GatewayCollaborationBackend {
     maintenanceStore;
     gatewayPublicUrl;
     gatewayAuthToken;
-    gatewayToken;
+    gatewayScopeToken;
     gatewayUserUuid;
     projectName;
     botUsername;
-    constructor(logger, maintenanceStore, gatewayPublicUrl, gatewayAuthToken, gatewayToken, gatewayUserUuid, projectName, botUsername) {
+    constructor(logger, maintenanceStore, gatewayPublicUrl, gatewayAuthToken, gatewayScopeToken, gatewayUserUuid, projectName, botUsername) {
         this.logger = logger;
         this.maintenanceStore = maintenanceStore;
         this.gatewayPublicUrl = gatewayPublicUrl;
         this.gatewayAuthToken = gatewayAuthToken;
-        this.gatewayToken = gatewayToken;
+        this.gatewayScopeToken = gatewayScopeToken;
         this.gatewayUserUuid = gatewayUserUuid;
         this.projectName = projectName;
         this.botUsername = botUsername;
@@ -33,7 +33,7 @@ class GatewayCollaborationBackend {
             ...(this.gatewayAuthToken
                 ? { gatewayAuthToken: this.gatewayAuthToken }
                 : {}),
-            ...(this.gatewayToken ? { gatewayToken: this.gatewayToken } : {}),
+            ...(this.gatewayScopeToken ? { gatewayScopeToken: this.gatewayScopeToken } : {}),
             ...(this.gatewayUserUuid ? { gatewayUserUuid: this.gatewayUserUuid } : {}),
             ...(this.projectName ? { projectName: this.projectName } : {}),
             ...(this.botUsername ? { botUsername: this.botUsername } : {}),

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

@@ -241,7 +241,6 @@ class GatewayHttpService {
                 service: "tellymcp-gateway",
                 mode: this.config.distributed.mode,
                 databaseConfigured: Boolean(process.env.DB_HOST && process.env.DB_NAME),
-                s3Configured: Boolean(this.config.distributed.gatewayS3Bucket),
             });
             return true;
         }

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

@@ -9,6 +9,7 @@ function isBackendErrorLike(value) {
         typeof value.code === "string");
 }
 function formatBackendErrorLike(value) {
+    const truncate = (text, maxLength = 2_000) => text.length > maxLength ? `${text.slice(0, maxLength - 3)}...` : text;
     const details = [];
     if (typeof value.code === "string" && value.code.trim()) {
         details.push(`code=${value.code.trim()}`);
@@ -18,14 +19,14 @@ function formatBackendErrorLike(value) {
     }
     if (value.data !== undefined) {
         try {
-            details.push(`data=${JSON.stringify(value.data)}`);
+            details.push(`data=${truncate(JSON.stringify(value.data))}`);
         }
         catch {
-            details.push(`data=${String(value.data)}`);
+            details.push(`data=${truncate(String(value.data))}`);
         }
     }
     const base = typeof value.message === "string" && value.message.trim()
-        ? value.message.trim()
+        ? truncate(value.message.trim())
         : `${value.name ?? "BackendError"} (${value.code})`;
     return details.length > 0 ? `${base}\n${details.join("\n")}` : base;
 }

package/dist/services/features/telegram-mcp/src/features/notify/model/notifyService.js

@@ -325,8 +325,8 @@ class NotifyService {
             ...(this._config.distributed.gatewayAuthToken
                 ? { gatewayAuthToken: this._config.distributed.gatewayAuthToken }
                 : {}),
-            ...(this._config.distributed.gatewayToken
-                ? { gatewayToken: this._config.distributed.gatewayToken }
+            ...(this._config.distributed.gatewayScopeToken
+                ? { gatewayScopeToken: this._config.distributed.gatewayScopeToken }
                 : {}),
             ...(this._config.project.name
                 ? { projectName: this._config.project.name }
@@ -382,8 +382,8 @@ class NotifyService {
             ...(this._config.distributed.gatewayAuthToken
                 ? { gatewayAuthToken: this._config.distributed.gatewayAuthToken }
                 : {}),
-            ...(this._config.distributed.gatewayToken
-                ? { gatewayToken: this._config.distributed.gatewayToken }
+            ...(this._config.distributed.gatewayScopeToken
+                ? { gatewayScopeToken: this._config.distributed.gatewayScopeToken }
                 : {}),
             ...(this._config.project.name
                 ? { projectName: this._config.project.name }

package/dist/services/features/telegram-mcp/src/features/session-context/model/getRuntimeDiagnosticsTool.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetRuntimeDiagnosticsTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+class GetRuntimeDiagnosticsTool {
+    sessionContextService;
+    constructor(sessionContextService) {
+        this.sessionContextService = sessionContextService;
+    }
+    register(server) {
+        server.registerTool("get_runtime_diagnostics", {
+            title: "Get Runtime Diagnostics",
+            description: "Run safe, read-only health checks for a selected console: environment schema, package/protocol version, runtime state store, PTY state, gateway configuration, and gateway-to-client relay. Redis is probed only for gateway runtimes. Secrets and raw connection strings are never returned. In gateway mode, pass session_id exactly as returned by list_gateway_sessions.",
+            inputSchema: schema_1.getRuntimeDiagnosticsInputSchema,
+            outputSchema: schema_1.getRuntimeDiagnosticsOutputSchema,
+        }, async (args) => {
+            const output = await this.sessionContextService.getRuntimeDiagnostics(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(output, null, 2),
+                    },
+                ],
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.GetRuntimeDiagnosticsTool = GetRuntimeDiagnosticsTool;

package/dist/services/features/telegram-mcp/src/features/session-context/model/sessionContextService.js

@@ -9,16 +9,174 @@ class SessionContextService {
     logger;
     projectIdentityResolver;
     remoteConsoleInvoker;
-    constructor(sessionStore, bindingStore, logger, projectIdentityResolver, remoteConsoleInvoker) {
+    runtimeDiagnostics;
+    constructor(sessionStore, bindingStore, logger, projectIdentityResolver, remoteConsoleInvoker, runtimeDiagnostics) {
         this.sessionStore = sessionStore;
         this.bindingStore = bindingStore;
         this.logger = logger;
         this.projectIdentityResolver = projectIdentityResolver;
         this.remoteConsoleInvoker = remoteConsoleInvoker;
+        this.runtimeDiagnostics = runtimeDiagnostics;
+    }
+    getRemoteConsoleInvoker() {
+        return this.runtimeDiagnostics?.mode === "client"
+            ? undefined
+            : this.remoteConsoleInvoker;
+    }
+    formatDiagnosticError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const redacted = (0, redactSecrets_1.redactSecrets)(message).replace(/\s+/gu, " ").trim();
+        return redacted.length > 500
+            ? `${redacted.slice(0, 497)}...`
+            : redacted || "Unknown error";
+    }
+    finalizeDiagnostics(output) {
+        const degraded = Object.values(output.checks).some((check) => check.status !== "ok");
+        return {
+            ...output,
+            status: degraded ? "degraded" : "ok",
+        };
+    }
+    async collectLocalDiagnostics(sessionId) {
+        const runtime = this.runtimeDiagnostics;
+        let session = null;
+        let sessionStoreCheck;
+        try {
+            session = await this.sessionStore.getSession(sessionId);
+            await this.bindingStore.getBinding(sessionId);
+            sessionStoreCheck = {
+                status: "ok",
+                message: session
+                    ? "Session and route stores are readable; session metadata exists."
+                    : "Session and route stores are readable; no saved metadata exists for this id.",
+            };
+        }
+        catch (error) {
+            sessionStoreCheck = {
+                status: "error",
+                message: `Session store check failed: ${this.formatDiagnosticError(error)}`,
+            };
+        }
+        let redisCheck;
+        if (runtime?.mode === "client") {
+            redisCheck = {
+                status: "ok",
+                message: "Redis is not required in client mode; process-local state is active.",
+            };
+        }
+        else if (!runtime?.pingRedis) {
+            redisCheck = {
+                status: "warn",
+                message: "Runtime Redis probe is unavailable.",
+            };
+        }
+        else {
+            try {
+                const reply = await runtime.pingRedis();
+                redisCheck = {
+                    status: reply.trim().toUpperCase() === "PONG" ? "ok" : "warn",
+                    message: `Redis probe returned ${reply.trim() || "an empty response"}.`,
+                };
+            }
+            catch (error) {
+                redisCheck = {
+                    status: "error",
+                    message: `Redis probe failed: ${this.formatDiagnosticError(error)}`,
+                };
+            }
+        }
+        const mode = runtime?.mode ?? "client";
+        const gatewayConfigured = Boolean(runtime?.gatewayWsUrlConfigured);
+        const gatewayConfiguration = mode === "gateway"
+            ? {
+                status: "ok",
+                message: "Gateway runtime does not require an outbound gateway WebSocket URL.",
+            }
+            : gatewayConfigured
+                ? {
+                    status: "ok",
+                    message: runtime?.gatewayAuthConfigured
+                        ? "Gateway WebSocket URL and authentication are configured."
+                        : "Gateway WebSocket URL is configured; authentication is not configured.",
+                }
+                : {
+                    status: "error",
+                    message: "Gateway WebSocket URL is not configured for this client runtime.",
+                };
+        return this.finalizeDiagnostics({
+            checked_at: new Date().toISOString(),
+            session_id: sessionId,
+            runtime: {
+                mode,
+                package_version: runtime?.packageVersion ?? "unknown",
+                protocol_version: runtime?.protocolVersion ?? "unknown",
+                ...(runtime?.nodeId ? { node_id: runtime.nodeId } : {}),
+            },
+            checks: {
+                configuration: runtime
+                    ? {
+                        status: "ok",
+                        message: "Normalized environment schema was accepted at startup.",
+                    }
+                    : {
+                        status: "warn",
+                        message: "Runtime configuration metadata is unavailable.",
+                    },
+                redis: redisCheck,
+                session_store: sessionStoreCheck,
+                terminal: session?.terminalTarget
+                    ? {
+                        status: "ok",
+                        message: "A PTY terminal target is configured for this session.",
+                    }
+                    : {
+                        status: "warn",
+                        message: "No PTY terminal target is configured for this session.",
+                    },
+                gateway_configuration: gatewayConfiguration,
+                relay: {
+                    status: "ok",
+                    message: "Local diagnostic action completed.",
+                },
+            },
+        });
+    }
+    async getRuntimeDiagnostics(input) {
+        const resolved = this.projectIdentityResolver.resolveSessionDefaults(input);
+        const remoteConsoleInvoker = this.getRemoteConsoleInvoker();
+        if (!remoteConsoleInvoker) {
+            return await this.collectLocalDiagnostics(resolved.sessionId);
+        }
+        try {
+            const remote = await remoteConsoleInvoker.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.getRuntimeDiagnosticsRemote", input);
+            return this.finalizeDiagnostics({
+                ...remote,
+                checks: {
+                    ...remote.checks,
+                    relay: {
+                        status: "ok",
+                        message: "Gateway-to-client relay completed successfully.",
+                    },
+                },
+            });
+        }
+        catch (error) {
+            const local = await this.collectLocalDiagnostics(resolved.sessionId);
+            return this.finalizeDiagnostics({
+                ...local,
+                checks: {
+                    ...local.checks,
+                    relay: {
+                        status: "error",
+                        message: `Gateway-to-client relay failed: ${this.formatDiagnosticError(error)}`,
+                    },
+                },
+            });
+        }
     }
     async setContext(input) {
         const resolved = this.projectIdentityResolver.resolveSessionDefaults(input);
-        const remote = await this.remoteConsoleInvoker?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.setContextRemote", input);
+        const remote = await this.getRemoteConsoleInvoker()?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.setContextRemote", input);
         if (remote) {
             return remote;
         }
@@ -62,7 +220,9 @@ class SessionContextService {
                 : existing?.risks
                     ? { risks: existing.risks }
                     : {}),
-            ...(existing?.terminalTarget ? { terminalTarget: existing.terminalTarget } : {}),
+            ...(existing?.terminalTarget
+                ? { terminalTarget: existing.terminalTarget }
+                : {}),
             ...(existing?.lastTerminalNudgeAt
                 ? { lastTerminalNudgeAt: existing.lastTerminalNudgeAt }
                 : {}),
@@ -98,7 +258,7 @@ class SessionContextService {
     }
     async renameSession(input) {
         const resolved = this.projectIdentityResolver.resolveSessionDefaults(input);
-        const remote = await this.remoteConsoleInvoker?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.renameSessionRemote", input);
+        const remote = await this.getRemoteConsoleInvoker()?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.renameSessionRemote", input);
         if (remote) {
             return remote;
         }
@@ -120,7 +280,9 @@ class SessionContextService {
             ...(existing?.files ? { files: existing.files } : {}),
             ...(existing?.decisions ? { decisions: existing.decisions } : {}),
             ...(existing?.risks ? { risks: existing.risks } : {}),
-            ...(existing?.terminalTarget ? { terminalTarget: existing.terminalTarget } : {}),
+            ...(existing?.terminalTarget
+                ? { terminalTarget: existing.terminalTarget }
+                : {}),
             ...(existing?.lastTerminalNudgeAt
                 ? { lastTerminalNudgeAt: existing.lastTerminalNudgeAt }
                 : {}),
@@ -151,7 +313,7 @@ class SessionContextService {
     }
     async getContext(input) {
         const resolved = this.projectIdentityResolver.resolveSessionDefaults(input);
-        const remote = await this.remoteConsoleInvoker?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.getContextRemote", input);
+        const remote = await this.getRemoteConsoleInvoker()?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.getContextRemote", input);
         if (remote) {
             return remote;
         }
@@ -224,7 +386,7 @@ class SessionContextService {
     }
     async clearContext(input) {
         const resolved = this.projectIdentityResolver.resolveSessionDefaults(input);
-        const remote = await this.remoteConsoleInvoker?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.clearContextRemote", input);
+        const remote = await this.getRemoteConsoleInvoker()?.invokeForRelaySession(resolved.sessionId, "telegramMcp.sessionContext.clearContextRemote", input);
         if (remote) {
             return remote;
         }