@inceptionstack/roundhouse 0.3.14 → 0.3.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inceptionstack/roundhouse",
-  "version": "0.3.14",
+  "version": "0.3.15",
   "type": "module",
   "description": "Multi-platform chat gateway that routes messages through a configured AI agent",
   "license": "MIT",

package/src/cli/doctor/checks/telegram.ts

@@ -0,0 +1,126 @@
+/**
+ * Telegram connectivity checks
+ */
+
+import { readFile } from "node:fs/promises";
+import type { DoctorCheck } from "../types";
+import { parseEnvFile } from "../../env-file";
+
+/** Resolve the bot token from env or .env file */
+async function resolveToken(ctx: { env: NodeJS.ProcessEnv; envFilePath: string }): Promise<string | null> {
+  let token = ctx.env.TELEGRAM_BOT_TOKEN;
+  if (!token) {
+    try {
+      const entries = parseEnvFile(await readFile(ctx.envFilePath, "utf8"));
+      const raw = entries.get("TELEGRAM_BOT_TOKEN");
+      if (raw) token = raw.replace(/^["']|["']$/g, "");
+    } catch {}
+  }
+  return token || null;
+}
+
+export const telegramChecks: DoctorCheck[] = [
+  {
+    id: "telegram-configured", category: "network", name: "Telegram adapter configured",
+    async run(ctx) {
+      const base = { id: "telegram-configured", category: "network" as const, name: "Telegram adapter configured" };
+      try {
+        const raw = await readFile(ctx.configPath, "utf8");
+        const cfg = JSON.parse(raw);
+        if (cfg.chat?.adapters?.telegram) {
+          const mode = cfg.chat.adapters.telegram.mode ?? "polling";
+          return { ...base, status: "pass", summary: `mode: ${mode}` };
+        }
+        return { ...base, status: "info", summary: "not configured (no telegram adapter in config)" };
+      } catch {
+        return { ...base, status: "info", summary: "skipped (no config file)" };
+      }
+    },
+  },
+
+  {
+    id: "telegram-api", category: "network", name: "Telegram API reachable",
+    async run(ctx) {
+      const base = { id: "telegram-api", category: "network" as const, name: "Telegram API reachable" };
+      const token = await resolveToken(ctx);
+      if (!token) {
+        return { ...base, status: "info", summary: "skipped (no token)" };
+      }
+
+      try {
+        const res = await fetch(`https://api.telegram.org/bot${token}/getMe`, {
+          signal: AbortSignal.timeout(10000),
+        });
+        if (res.ok) {
+          const data = await res.json() as any;
+          return { ...base, status: "pass", summary: `@${data.result?.username ?? "unknown"}` };
+        }
+        if (res.status === 401) {
+          return { ...base, status: "fail", summary: "401 Unauthorized — token is invalid or revoked" };
+        }
+        return { ...base, status: "fail", summary: `API returned ${res.status}` };
+      } catch (err) {
+        return {
+          ...base, status: "fail", summary: "cannot reach api.telegram.org",
+          details: [(err as Error).message],
+        };
+      }
+    },
+  },
+
+  {
+    id: "telegram-webhook", category: "network", name: "Telegram webhook status",
+    async run(ctx) {
+      const base = { id: "telegram-webhook", category: "network" as const, name: "Telegram webhook status" };
+      const token = await resolveToken(ctx);
+      if (!token) {
+        return { ...base, status: "info", summary: "skipped (no token)" };
+      }
+
+      // Check what mode is configured
+      let configuredMode = "polling";
+      try {
+        const raw = await readFile(ctx.configPath, "utf8");
+        const cfg = JSON.parse(raw);
+        configuredMode = cfg.chat?.adapters?.telegram?.mode ?? "polling";
+      } catch {}
+
+      try {
+        const res = await fetch(`https://api.telegram.org/bot${token}/getWebhookInfo`, {
+          signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+          return { ...base, status: "warn", summary: `getWebhookInfo returned ${res.status}` };
+        }
+        const data = await res.json() as any;
+        const webhookUrl = data.result?.url;
+        const pendingUpdates = data.result?.pending_update_count ?? 0;
+
+        if (configuredMode === "polling") {
+          if (webhookUrl) {
+            return {
+              ...base, status: "warn", summary: `webhook set but mode is polling`,
+              details: [
+                `Webhook URL: ${webhookUrl}`,
+                "Polling won't receive updates while a webhook is active.",
+                "The gateway will clear this on startup, but if it fails to start, messages are lost.",
+              ],
+            };
+          }
+          return { ...base, status: "pass", summary: `no webhook (polling mode), ${pendingUpdates} pending updates` };
+        } else {
+          // webhook mode
+          if (!webhookUrl) {
+            return { ...base, status: "warn", summary: "webhook mode configured but no webhook set" };
+          }
+          return { ...base, status: "pass", summary: `webhook: ${webhookUrl}, ${pendingUpdates} pending` };
+        }
+      } catch (err) {
+        return {
+          ...base, status: "warn", summary: "cannot check webhook status",
+          details: [(err as Error).message],
+        };
+      }
+    },
+  },
+];

package/src/cli/doctor/runner.ts

@@ -13,6 +13,7 @@ import { agentChecks } from "./checks/agent";
 import { systemdChecks } from "./checks/systemd";
 import { diskChecks } from "./checks/disk";
 import { sttChecks } from "./checks/stt";
+import { telegramChecks } from "./checks/telegram";
 
 /** Create a DoctorContext with sensible defaults */
 export async function createDoctorContext(overrides: Partial<DoctorContext> = {}): Promise<DoctorContext> {
@@ -34,6 +35,7 @@ const ALL_CHECKS: DoctorCheck[] = [
   ...configChecks,
   ...credentialChecks,
   ...agentChecks,
+  ...telegramChecks,
   ...sttChecks,
   ...diskChecks,
   ...systemdChecks,

package/src/cli/setup.ts

@@ -136,7 +136,7 @@ export function parseSetupArgs(argv: string[]): SetupOptions {
     notifyChatIds: [],
     systemd: platform() === "linux",
     voice: true,
-    psst: true,
+    psst: false,
     nonInteractive: false,
     force: false,
     dryRun: false,
@@ -159,7 +159,7 @@ export function parseSetupArgs(argv: string[]): SetupOptions {
       case "--notify-chat": opts.notifyChatIds.push(parseInt(next(), 10)); break;
       case "--no-systemd": opts.systemd = false; break;
       case "--no-voice": opts.voice = false; break;
-      case "--no-psst": opts.psst = false; break;
+      case "--with-psst": opts.psst = true; break;
       case "--non-interactive": opts.nonInteractive = true; break;
       case "--force": opts.force = true; break;
       case "--dry-run": opts.dryRun = true; break;
@@ -446,7 +446,7 @@ async function stepInstallPackages(opts: SetupOptions): Promise<void> {
 async function stepStoreSecrets(opts: SetupOptions, botInfo: BotInfo): Promise<void> {
   if (!opts.psst) {
     step("⑥", "Storing secrets...");
-    ok("Skipped (--no-psst)");
+    ok("Skipped (default — use --with-psst to enable)");
     return;
   }
 
@@ -963,7 +963,7 @@ Channel:
 Service:
   --no-systemd               Skip systemd install
   --no-voice                 Disable voice/STT
-  --no-psst                  Skip psst, use plaintext env file
+  --with-psst                Use psst vault for secrets (default: .env file)
 
 Behavior:
   --non-interactive          No pairing, no prompts