@deadragdoll/tellymcp 0.0.14 → 0.0.16

package/config/templates/env.both.template

@@ -19,8 +19,7 @@ REDIS_HOST=127.0.0.1
 REDIS_PORT=6379
 REDIS_DB=1
 
-MODE=reject
-PAIR_CODE_TTL_SECONDS=300
+TELEGRAM_REQUEST_MODE=reject
 
 MCP_HTTP_HOST=127.0.0.1
 MCP_HTTP_PORT=8787
@@ -47,7 +46,7 @@ DISTRIBUTED_MODE=both
 GATEWAY_PUBLIC_URL=
 GATEWAY_WS_URL=
 GATEWAY_WS_PATH=/api/gateway/ws
-GATEWAY_TOKEN=
+GATEWAY_SCOPE_TOKEN=
 GATEWAY_USER_UUID=
 GATEWAY_AUTH_TOKEN=
 
@@ -61,7 +60,7 @@ DB_PORT=5432
 DB_USER=
 DB_PASSWORD=
 DB_NAME=
-DB_SCHEME=mcp
+DB_SCHEMA=mcp
 
 # RMQ_HOST=127.0.0.1
 # RMQ_PORT=5672
@@ -113,4 +112,4 @@ BROWSER_SLOW_MO_MS=0
 LOG_LEVEL=info
 LOG_FILE_ENABLED=false
 LOG_FILE_PATH=.tellymcp/log.jsonl
-ENABLE_LOGFEED=0
+LOGFEED_ENABLED=0

package/config/templates/env.client.template

@@ -4,12 +4,8 @@
 # TELLYMCP_SESSION_ID=NEW
 # TELLYMCP_SESSION_LABEL=NEW
 
-REDIS_HOST=127.0.0.1
-REDIS_PORT=6379
-REDIS_DB=1
-
-MODE=reject
-PAIR_CODE_TTL_SECONDS=300
+# Client state is process-local. Redis is gateway-only.
+TELEGRAM_REQUEST_MODE=reject
 
 MCP_HTTP_HOST=127.0.0.1
 MCP_HTTP_PORT=8787
@@ -22,7 +18,7 @@ DISTRIBUTED_MODE=client
 GATEWAY_PUBLIC_URL=
 GATEWAY_WS_URL=
 GATEWAY_WS_PATH=/api/gateway/ws
-GATEWAY_TOKEN=
+GATEWAY_SCOPE_TOKEN=
 GATEWAY_USER_UUID=
 GATEWAY_AUTH_TOKEN=
 
@@ -44,15 +40,6 @@ TERMINAL_PROMPT_SCAN_INTERVAL_SECONDS=15
 TERMINAL_PROMPT_SCAN_COOLDOWN_SECONDS=120
 TERMINAL_PROMPT_SCAN_STRATEGY=strict
 TERMINAL_PROMPT_SCAN_MIN_SCORE=5
-WEBAPP_ENABLED=true
-WEBAPP_BASE_PATH=/webapp
-WEBAPP_PUBLIC_URL=
-WEBAPP_INITDATA_TTL_SECONDS=300
-WEBAPP_SESSION_TTL_SECONDS=900
-WEBAPP_LAUNCH_MODE=fullscreen
-WEBAPP_VISIBLE_SCREENS=10
-WEBAPP_ACTION_COOLDOWN_MS=150
-
 MCP_XCHANGE_DIR=.mcp-xchange
 
 BROWSER_ENABLED=true
@@ -76,4 +63,4 @@ NODE_ID=agent
 LOG_LEVEL=info
 LOG_FILE_ENABLED=false
 LOG_FILE_PATH=.tellymcp/log.jsonl
-ENABLE_LOGFEED=0
+LOGFEED_ENABLED=0

package/config/templates/env.gateway.template

@@ -15,8 +15,7 @@ REDIS_HOST=127.0.0.1
 REDIS_PORT=6379
 REDIS_DB=1
 
-MODE=reject
-PAIR_CODE_TTL_SECONDS=300
+TELEGRAM_REQUEST_MODE=reject
 
 MCP_HTTP_HOST=127.0.0.1
 MCP_HTTP_PORT=8787
@@ -43,7 +42,7 @@ DISTRIBUTED_MODE=gateway
 GATEWAY_PUBLIC_URL=
 GATEWAY_WS_URL=
 GATEWAY_WS_PATH=/api/gateway/ws
-GATEWAY_TOKEN=
+GATEWAY_SCOPE_TOKEN=
 GATEWAY_AUTH_TOKEN=
 
 ROOT_PREFIX=/api
@@ -56,7 +55,7 @@ DB_PORT=5432
 DB_USER=
 DB_PASSWORD=
 DB_NAME=
-DB_SCHEME=mcp
+DB_SCHEMA=mcp
 
 # RMQ_HOST=127.0.0.1
 # RMQ_PORT=5672
@@ -76,36 +75,12 @@ WEBAPP_ACTION_COOLDOWN_MS=150
 
 MCP_XCHANGE_DIR=.mcp-xchange
 
-TERMINAL_SHELL=bash
-TERMINAL_COLS=120
-TERMINAL_ROWS=40
-TERMINAL_SCROLLBACK_LINES=4000
-
-TERMINAL_NUDGE_ENABLED=true
-TERMINAL_NUDGE_DEBOUNCE_SECONDS=10
-TERMINAL_NUDGE_COOLDOWN_SECONDS=30
-TERMINAL_NUDGE_MESSAGE=получи newest telegram_message через list_xchange_records/get_xchange_record, выполни запрос и ответь человеку через notify_telegram; не останавливайся на анализе
-TERMINAL_PARTNER_NUDGE_MESSAGE=получи newest partner_note через list_xchange_records/get_xchange_record, выполни задачу в текущей консоли и обязательно отправь результат через send_partner_note или send_partner_file; только потом mark_xchange_record_read
-TERMINAL_PARTNER_REPLY_NUDGE_MESSAGE=получи newest partner_note через list_xchange_records/get_xchange_record; если newest note имеет kind=reply или не требует ответа, не отправляй новый send_partner_note/send_partner_file без явного нового запроса. Если этот reply завершает задачу от человека, сразу отправь финальный результат в Telegram через notify_telegram или send_file_to_telegram; только потом mark_xchange_record_read
-TERMINAL_CAPTURE_MODE=visible
-TERMINAL_CAPTURE_LINES=300
 TERMINAL_PROMPT_SCAN_ENABLED=false
 TERMINAL_PROMPT_SCAN_INTERVAL_SECONDS=15
 TERMINAL_PROMPT_SCAN_COOLDOWN_SECONDS=120
 TERMINAL_PROMPT_SCAN_STRATEGY=strict
 TERMINAL_PROMPT_SCAN_MIN_SCORE=5
-BROWSER_ENABLED=false
-BROWSER_HEADLESS=false
-BROWSER_DEVTOOLS=false
-# BROWSER_ADDRESS=http://localhost:5173
-BROWSER_TIMEOUT_MS=20000
-BROWSER_MAX_EVENTS=200
-BROWSER_WAIT_UNTIL=load
-# BROWSER_EXECUTABLE_PATH=
-# BROWSER_CHANNEL=chrome
-BROWSER_SLOW_MO_MS=0
-
 LOG_LEVEL=info
 LOG_FILE_ENABLED=false
 LOG_FILE_PATH=.tellymcp/log.jsonl
-ENABLE_LOGFEED=0
+LOGFEED_ENABLED=0

package/dist/cli.js

@@ -16,10 +16,45 @@ const ws_1 = __importDefault(require("ws"));
 const codexPluginInstaller_1 = require("./codexPluginInstaller");
 const versionHandshake_1 = require("./services/features/telegram-mcp/src/shared/lib/version/versionHandshake");
 const projectIdentity_1 = require("./services/features/telegram-mcp/src/shared/lib/project-identity/projectIdentity");
-const foregroundTerminalRuntime_1 = require("./services/features/telegram-mcp/src/features/foreground-terminal/model/foregroundTerminalRuntime");
+const envMigration_1 = require("./envMigration");
+const configureServer_1 = require("./configureServer");
 const distDir = __dirname;
 const packageRoot = node_path_1.default.resolve(distDir, "..");
 const cliPackageVersion = (0, versionHandshake_1.getTellyMcpPackageVersion)(__dirname);
+function nativePtyRecoveryLines() {
+    return [
+        ...(process.platform === "linux"
+            ? [
+                "Install native build prerequisites (Debian/Ubuntu): sudo apt install -y python3 make g++",
+            ]
+            : []),
+        "Ensure npm lifecycle scripts are enabled: npm config set ignore-scripts false",
+        "Remove the broken global package: npm uninstall -g @deadragdoll/tellymcp",
+        "Reinstall and compile native dependencies: npm install -g @deadragdoll/tellymcp@latest --foreground-scripts",
+    ];
+}
+async function checkNativePtyRuntime() {
+    try {
+        const nodePty = await import("node-pty");
+        if (typeof nodePty.spawn !== "function") {
+            return {
+                available: false,
+                message: "node-pty loaded without a spawn function.",
+            };
+        }
+        return { available: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            available: false,
+            message: message.split("\n", 1)[0] || "node-pty failed to load.",
+        };
+    }
+}
+function isForegroundPtyClientMode(parsed) {
+    return (parsed.DISTRIBUTED_MODE || "client").trim() === "client";
+}
 function printBanner(title, subtitle) {
     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) {
@@ -66,6 +101,8 @@ function printHelp() {
     printBanner("CLI", "Telegram control plane for MCP-connected coding agents");
     printSection("Usage", [
         "  tellymcp init <client|gateway|both> [directory]",
+        "  tellymcp configure [--no-open]",
+        "  tellymcp migrate-env <input.env> > .migrated-env",
         "  tellymcp run [--env <file>]",
         "  tellymcp run --env=<file>",
         "  tellymcp run --env .env-client -s backendDev",
@@ -84,6 +121,8 @@ function printHelp() {
     printSection("Examples", [
         "  tellymcp init client",
         "  tellymcp init gateway ./gateway-node",
+        "  tellymcp configure",
+        "  tellymcp migrate-env ./old.env > ./new.env",
         "  tellymcp run",
         "  tellymcp run --env .env.client",
         "  tellymcp run --env .env-client -s backendDev",
@@ -99,7 +138,7 @@ function printHelp() {
         "  tellymcp oauth key",
     ]);
     printSection("terminal", [
-        `${picocolors_1.default.green("  OK")} built-in PTY runtime`,
+        "  built-in PTY runtime (validated by tellymcp doctor and tellymcp run)",
         "  Live view, session nudges and browser flows use the built-in terminal runtime.",
     ]);
 }
@@ -110,7 +149,9 @@ function formatMarkerEnvPath(envPath, cwd) {
     const resolvedCwd = node_path_1.default.resolve(cwd);
     const resolvedEnvPath = node_path_1.default.resolve(envPath);
     const relativePath = node_path_1.default.relative(resolvedCwd, resolvedEnvPath);
-    return relativePath && !relativePath.startsWith("..") && !node_path_1.default.isAbsolute(relativePath)
+    return relativePath &&
+        !relativePath.startsWith("..") &&
+        !node_path_1.default.isAbsolute(relativePath)
         ? relativePath
         : resolvedEnvPath;
 }
@@ -157,7 +198,7 @@ function loadCliEnv(args) {
     const sessionOverride = explicitSessionOverride ?? marker?.localSessionId ?? null;
     const sessionLabelOverride = explicitSessionOverride
         ? explicitSessionOverride
-        : marker?.sessionLabel ?? sessionOverride ?? null;
+        : (marker?.sessionLabel ?? sessionOverride ?? null);
     if (!(0, node_fs_1.existsSync)(envPath)) {
         fail(`Missing env file: ${envPath}`);
     }
@@ -263,9 +304,7 @@ function runOAuthCommand(args) {
 }
 function printBrowserHelp() {
     printBanner("browser helper", "Manage Playwright browser binaries used by browser_* tools");
-    printSection("Usage", [
-        "  tellymcp browser install",
-    ]);
+    printSection("Usage", ["  tellymcp browser install"]);
     printSection("What this command does", [
         "  Installs the bundled Playwright Chromium browser.",
         "  Uses the Playwright dependency shipped with TellyMCP.",
@@ -323,12 +362,67 @@ function loadTemplate(mode) {
             : "env.both.template";
     const templatePath = node_path_1.default.join(packageRoot, templateName);
     const nestedTemplatePath = node_path_1.default.join(packageRoot, "config", "templates", templateName);
-    const resolvedTemplatePath = (0, node_fs_1.existsSync)(templatePath) ? templatePath : nestedTemplatePath;
+    const resolvedTemplatePath = (0, node_fs_1.existsSync)(templatePath)
+        ? templatePath
+        : nestedTemplatePath;
     if (!(0, node_fs_1.existsSync)(resolvedTemplatePath)) {
         fail(`Missing packaged template: ${templateName}`);
     }
     return (0, node_fs_1.readFileSync)(resolvedTemplatePath, "utf8");
 }
+async function runConfigure(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        printBanner("configure", "Local web configurator for a TellyMCP dotenv file");
+        printSection("Usage", [
+            "  tellymcp configure [--no-open]",
+            "  tellymcp configure [--port 8790] [--no-open]",
+        ]);
+        printSection("Safety", [
+            "  The configurator binds only to 127.0.0.1 on a random free port.",
+            "  Its URL contains a one-time access token.",
+            "  The browser downloads .env-client or .env-gateway after validation.",
+        ]);
+        return;
+    }
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (value === "--no-open" || value?.startsWith("--port=")) {
+            continue;
+        }
+        if (value === "--port") {
+            index += 1;
+            continue;
+        }
+        fail("configure does not accept a role or output path; choose Client or Gateway in the browser wizard.");
+    }
+    const portArg = readFlagValue(args, "--port");
+    const port = portArg === null ? 0 : Number(portArg);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        fail("--port must be an integer between 0 and 65535.");
+    }
+    printBanner("configure", "Choose Client or Gateway in the local browser wizard");
+    await (0, configureServer_1.startConfigureServer)({
+        templates: {
+            client: loadTemplate("client"),
+            gateway: loadTemplate("gateway"),
+        },
+        port,
+        open: !args.includes("--no-open"),
+        onListening(url) {
+            printSection("Configurator", [
+                `  ${picocolors_1.default.green("OPEN")} ${url}`,
+                "  Keep this terminal open until the file is saved.",
+                "  Press Ctrl+C to cancel.",
+            ]);
+        },
+        onDownloaded(filename) {
+            printSection("Download", [
+                `  ${picocolors_1.default.green("OK")} ${filename} sent to the browser`,
+                `  next: chmod 600 ${filename}`,
+            ]);
+        },
+    });
+}
 function initWorkspace(mode, directoryArg) {
     const targetDir = node_path_1.default.resolve(directoryArg ?? process.cwd());
     (0, node_fs_1.mkdirSync)(targetDir, { recursive: true });
@@ -354,6 +448,40 @@ function initWorkspace(mode, directoryArg) {
         "  3. tellymcp run",
     ]);
 }
+function runMigrateEnv(args) {
+    const [inputArg, extraArg] = args;
+    if (!inputArg || extraArg || inputArg === "--help" || inputArg === "-h") {
+        printBanner("migrate-env", "Normalize a legacy TellyMCP environment file");
+        printSection("Usage", [
+            "  tellymcp migrate-env <input.env> > .migrated-env",
+            "  The role is read from DISTRIBUTED_MODE or inferred from gateway-only keys.",
+            "  Normalized dotenv is written to stdout; migration notes go to stderr.",
+        ]);
+        if (!inputArg || inputArg === "--help" || inputArg === "-h") {
+            return;
+        }
+        fail("migrate-env expects exactly one input env file.");
+    }
+    const inputPath = node_path_1.default.resolve(process.cwd(), inputArg);
+    if (!(0, node_fs_1.existsSync)(inputPath)) {
+        fail(`Missing input env file: ${inputPath}`);
+    }
+    const result = (0, envMigration_1.migrateEnvironmentContent)((0, node_fs_1.readFileSync)(inputPath, "utf8"));
+    process.stdout.write(result.content);
+    const notes = [
+        `migrate-env: role=${result.role}`,
+        `migrate-env: kept ${result.keptKeys.length} keys from ${inputPath}`,
+    ];
+    if (result.renamedKeys.length > 0) {
+        notes.push(`migrate-env: renamed ${result.renamedKeys
+            .map(({ from, to }) => `${from}->${to}`)
+            .join(", ")}`);
+    }
+    if (result.droppedKeys.length > 0) {
+        notes.push(`migrate-env: dropped ${result.droppedKeys.join(", ")}`);
+    }
+    process.stderr.write(`${notes.join("\n")}\n`);
+}
 function resolveRunEnvPath(args) {
     const [firstArg, secondArg] = args;
     const marker = getSessionMarkerForCwd(process.cwd());
@@ -424,9 +552,7 @@ function readFlagValue(args, flagName) {
     return null;
 }
 function printMcpConfig(args) {
-    if (args.length === 0 ||
-        args.includes("--help") ||
-        args.includes("-h")) {
+    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
         printMcpHelp();
         return;
     }
@@ -522,14 +648,13 @@ async function checkWebSocketUrl(url, timeoutMs = 3000) {
             }
             settled = true;
             clearTimeout(timer);
-            socket.removeAllListeners();
-            try {
+            resolve({ ok, message });
+            if (socket.readyState === ws_1.default.OPEN) {
                 socket.close();
             }
-            catch {
-                // ignore
+            else if (socket.readyState === ws_1.default.CONNECTING) {
+                socket.terminate();
             }
-            resolve({ ok, message });
         };
         const socket = new ws_1.default(url);
         const timer = setTimeout(() => {
@@ -542,23 +667,31 @@ async function checkWebSocketUrl(url, timeoutMs = 3000) {
         socket.once("unexpected-response", (_req, response) => {
             finish(false, `${url} returned HTTP ${response.statusCode ?? "unknown"} during WebSocket upgrade`);
         });
-        socket.once("error", (error) => {
+        socket.on("error", (error) => {
             finish(false, `${url} failed: ${error.message}`);
         });
         socket.once("close", (code) => {
             if (!opened) {
                 finish(false, `${url} closed before open (code ${code})`);
             }
+            socket.removeAllListeners();
         });
     });
 }
 async function runDoctor(args) {
     const { envPath, parsed } = loadCliEnv(args);
+    const nativePtyStatus = await checkNativePtyRuntime();
     printBanner("doctor", "Local installation diagnostics");
     printSection("terminal", [
-        `${picocolors_1.default.green("  OK")} built-in PTY runtime`,
+        nativePtyStatus.available
+            ? `${picocolors_1.default.green("  OK")} built-in PTY runtime: native module loaded`
+            : `${picocolors_1.default.red("  ERROR")} built-in PTY runtime: ${nativePtyStatus.message}`,
+        `  platform: ${process.platform}-${process.arch}, Node ${process.versions.node}`,
         `  shell: ${parsed.TERMINAL_SHELL?.trim() || process.env.SHELL || "bash"}`,
         `  size:  ${parsed.TERMINAL_COLS?.trim() || "120"}x${parsed.TERMINAL_ROWS?.trim() || "40"}`,
+        ...(!nativePtyStatus.available
+            ? nativePtyRecoveryLines().map((line) => `${picocolors_1.default.yellow("  ACTION")} ${line}`)
+            : []),
     ]);
     const mode = (parsed.DISTRIBUTED_MODE || "client").trim();
     const httpHost = (parsed.MCP_HTTP_HOST || "0.0.0.0").trim();
@@ -617,10 +750,15 @@ async function runDoctor(args) {
         checks.push(`${picocolors_1.default.red("  ERROR")} playwright chromium: ${playwrightStatus.message}`);
         capabilities.push(`${picocolors_1.default.red("  ERROR")} browser tools: browsers are not installed`);
     }
-    const redisHost = (parsed.REDIS_HOST || "127.0.0.1").trim();
-    const redisPort = Number(parsed.REDIS_PORT || 6379);
-    const redisCheck = await checkTcpPort(redisHost, redisPort);
-    checks.push(`${redisCheck.ok ? picocolors_1.default.green("  OK") : picocolors_1.default.red("  ERROR")} redis: ${redisCheck.message}`);
+    if (mode === "client") {
+        checks.push(`${picocolors_1.default.green("  OK")} local state: process-local (Redis is not required)`);
+    }
+    else {
+        const redisHost = (parsed.REDIS_HOST || "127.0.0.1").trim();
+        const redisPort = Number(parsed.REDIS_PORT || 6379);
+        const redisCheck = await checkTcpPort(redisHost, redisPort);
+        checks.push(`${redisCheck.ok ? picocolors_1.default.green("  OK") : picocolors_1.default.red("  ERROR")} redis: ${redisCheck.message}`);
+    }
     if (mode === "client") {
         const gatewayPublicUrl = parsed.GATEWAY_PUBLIC_URL?.trim();
         if (gatewayPublicUrl) {
@@ -720,9 +858,12 @@ async function runDoctor(args) {
         printSection("notes", notes);
     }
     else {
-        printSection("notes", [`${picocolors_1.default.green("  OK")} No obvious local config issues detected.`]);
+        printSection("notes", [
+            `${picocolors_1.default.green("  OK")} No obvious local config issues detected.`,
+        ]);
     }
-    if (browserEnabled && (!playwrightStatus.enabled || !playwrightStatus.installed)) {
+    if (browserEnabled &&
+        (!playwrightStatus.enabled || !playwrightStatus.installed)) {
         printSection("playwright", [
             `${picocolors_1.default.yellow("  ACTION")} Install browser binaries before using browser_* tools:`,
             "    tellymcp browser install",
@@ -742,7 +883,9 @@ function normalizeExtensionFlavor(rawValue) {
     return null;
 }
 function getBundledExtensionDir(flavor) {
-    return node_path_1.default.join(packageRoot, "packages", flavor === "firefox" ? "firefox-attach-extension" : "chrome-attach-extension", "dist");
+    return node_path_1.default.join(packageRoot, "packages", flavor === "firefox"
+        ? "firefox-attach-extension"
+        : "chrome-attach-extension", "dist");
 }
 function getDefaultExtensionTargetDir(flavor) {
     return node_path_1.default.resolve(process.cwd(), flavor === "firefox" ? "tellymcp-firefox-attach" : "tellymcp-chrome-attach");
@@ -783,7 +926,7 @@ async function runSystemPrune(args) {
     const dbUser = parsed.DB_USER?.trim();
     const dbPassword = parsed.DB_PASSWORD?.trim();
     const dbName = parsed.DB_NAME?.trim();
-    const dbSchema = (parsed.DB_SCHEME || "mcp").trim();
+    const dbSchema = (parsed.DB_SCHEMA || "mcp").trim();
     const xchangeDir = node_path_1.default.resolve(process.cwd(), parsed.MCP_XCHANGE_DIR || ".mcp-xchange");
     const sessionMarkerPath = node_path_1.default.resolve(process.cwd(), ".mcpsession.json");
     const sqliteDbPath = node_path_1.default.join(xchangeDir, "xchange.sqlite3");
@@ -791,35 +934,39 @@ async function runSystemPrune(args) {
     printSection("Target", [
         `  env: ${envPath}`,
         `  mode: ${mode}`,
-        `  redis: ${redisHost}:${redisPort}/${redisDb}`,
+        ...(mode === "client"
+            ? [`  state: process-local (Redis skipped)`]
+            : [`  redis: ${redisHost}:${redisPort}/${redisDb}`]),
         ...(dbHost && dbUser && dbName
             ? [`  postgres: ${dbHost}:${dbPort}/${dbName} schema ${dbSchema}`]
             : [`  postgres: ${picocolors_1.default.dim("skipped (not configured)")}`]),
         `  xchange dir: ${xchangeDir}`,
         `  session marker: ${sessionMarkerPath}`,
     ]);
-    const redis = new ioredis_1.default({
-        host: redisHost,
-        port: redisPort,
-        db: redisDb,
-        ...(redisUsername ? { username: redisUsername } : {}),
-        ...(redisPassword ? { password: redisPassword } : {}),
-        maxRetriesPerRequest: 1,
-        enableReadyCheck: true,
-    });
     let deletedRedisKeys = 0;
-    try {
-        let cursor = "0";
-        do {
-            const [nextCursor, keys] = await redis.scan(cursor, "MATCH", "telegram-mcp:*", "COUNT", 500);
-            cursor = nextCursor;
-            if (keys.length > 0) {
-                deletedRedisKeys += await redis.del(...keys);
-            }
-        } while (cursor !== "0");
-    }
-    finally {
-        redis.disconnect();
+    if (mode !== "client") {
+        const redis = new ioredis_1.default({
+            host: redisHost,
+            port: redisPort,
+            db: redisDb,
+            ...(redisUsername ? { username: redisUsername } : {}),
+            ...(redisPassword ? { password: redisPassword } : {}),
+            maxRetriesPerRequest: 1,
+            enableReadyCheck: true,
+        });
+        try {
+            let cursor = "0";
+            do {
+                const [nextCursor, keys] = await redis.scan(cursor, "MATCH", "telegram-mcp:*", "COUNT", 500);
+                cursor = nextCursor;
+                if (keys.length > 0) {
+                    deletedRedisKeys += await redis.del(...keys);
+                }
+            } while (cursor !== "0");
+        }
+        finally {
+            redis.disconnect();
+        }
     }
     let truncatedTables = [];
     if (dbHost && dbUser && dbName) {
@@ -1013,8 +1160,19 @@ async function runRuntime(args) {
         sessionId: parsed.TELLYMCP_SESSION_ID,
         sessionLabel: parsed.TELLYMCP_SESSION_LABEL,
     });
-    if ((0, foregroundTerminalRuntime_1.isForegroundPtyClientMode)(parsed)) {
-        await (0, foregroundTerminalRuntime_1.runForegroundPtyRuntime)({
+    const nativePtyStatus = await checkNativePtyRuntime();
+    if (!nativePtyStatus.available) {
+        fail([
+            `Built-in PTY runtime is unavailable on ${process.platform}-${process.arch} with Node ${process.versions.node}.`,
+            nativePtyStatus.message,
+            "",
+            ...nativePtyRecoveryLines(),
+            "Then rerun: tellymcp doctor --env <file>",
+        ].join("\n"));
+    }
+    if (isForegroundPtyClientMode(parsed)) {
+        const { runForegroundPtyRuntime } = await import("./services/features/telegram-mcp/src/features/foreground-terminal/model/foregroundTerminalRuntime.js");
+        await runForegroundPtyRuntime({
             envPath,
             packageRoot,
             printBanner,
@@ -1068,11 +1226,24 @@ async function runRuntime(args) {
 }
 async function main(argv) {
     const [rawCommand, firstArg, secondArg] = argv;
-    const command = rawCommand === "init" || rawCommand === "run" || rawCommand === "help" || rawCommand === "mcp" || rawCommand === "oauth" || rawCommand === "doctor" || rawCommand === "browser" || rawCommand === "system-prune"
-        || rawCommand === "codex-plugin" || rawCommand === "extension"
+    const command = rawCommand === "init" ||
+        rawCommand === "configure" ||
+        rawCommand === "migrate-env" ||
+        rawCommand === "run" ||
+        rawCommand === "help" ||
+        rawCommand === "mcp" ||
+        rawCommand === "oauth" ||
+        rawCommand === "doctor" ||
+        rawCommand === "browser" ||
+        rawCommand === "system-prune" ||
+        rawCommand === "codex-plugin" ||
+        rawCommand === "extension"
         ? rawCommand
         : "help";
-    if (command === "help" || !rawCommand || rawCommand === "--help" || rawCommand === "-h") {
+    if (command === "help" ||
+        !rawCommand ||
+        rawCommand === "--help" ||
+        rawCommand === "-h") {
         printHelp();
         return;
     }
@@ -1080,6 +1251,14 @@ async function main(argv) {
         initWorkspace(ensureMode(firstArg), secondArg);
         return;
     }
+    if (command === "configure") {
+        await runConfigure(argv.slice(1));
+        return;
+    }
+    if (command === "migrate-env") {
+        runMigrateEnv(argv.slice(1));
+        return;
+    }
     if (command === "mcp") {
         printMcpConfig(argv.slice(1));
         return;