@tritard/waterbrother 0.16.9 → 0.16.11

package/README.md

@@ -31,6 +31,8 @@ It is Vercel-ready via `vercel.json` (clean URLs, no build step required).
   - asks for API key when the selected provider requires one
   - tries a live provider model list after credentials, shows when that live list is in use, then falls back to the built-in catalog
   - prompts for default model and agent profile
+  - can optionally configure Telegram during onboarding and offer to open the Telegram guide in your browser
+  - if Telegram is configured for startup, the TUI autostarts the background Telegram gateway on launch
 - Multi-provider chat integration through provider adapters and model registry
 - Vision command for local images: `waterbrother vision <image-path> <prompt>`
 - Authenticated GitHub repo reading for GitHub URLs, including private repos when `gh` is logged in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tritard/waterbrother",
-  "version": "0.16.9",
+  "version": "0.16.11",
   "description": "Waterbrother: bring-your-own-model coding CLI with local tools, sessions, operator modes, and approval controls",
   "type": "module",
   "bin": {
@@ -27,7 +27,7 @@
     "type": "git",
     "url": "git+https://github.com/PhillipHolland/waterbrother.git"
   },
-  "homepage": "https://github.com/PhillipHolland/waterbrother#readme",
+  "homepage": "https://waterbrother.app",
   "bugs": {
     "url": "https://github.com/PhillipHolland/waterbrother/issues"
   },

package/src/cli.js

@@ -1,4 +1,4 @@
-import { execFile } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";
 import process from "node:process";
@@ -10,7 +10,7 @@ import { getConfigPath, loadConfigLayers, resolveRuntimeConfig, saveConfig } fro
 import { createChatCompletion, createJsonCompletion, listModels } from "./model-client.js";
 import { buildChannelOnboardingPayload, getChannelStatuses, getGatewayStatus } from "./channels.js";
 import { runGatewayService } from "./gateway.js";
-import { DEFAULT_PENDING_PAIRING_TTL_MINUTES, loadGatewayState, prunePendingPairings, saveGatewayState } from "./gateway-state.js";
+import { DEFAULT_PENDING_PAIRING_TTL_MINUTES, loadGatewayProcessInfo, loadGatewayState, prunePendingPairings, saveGatewayProcessInfo, saveGatewayState } from "./gateway-state.js";
 import {
   getDefaultDesignModelForProvider,
   getDefaultModelForProvider,
@@ -60,6 +60,7 @@ import { parseCharterFromGoal, runExperimentLoop, formatExperimentSummary, gitRe
 
 const execFileAsync = promisify(execFile);
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const DOCS_BASE_URL = String(process.env.WATERBROTHER_DOCS_BASE_URL || "https://waterbrother.app").trim().replace(/\/+$/, "");
 
 
 const MODEL_CATALOG = listLocalModels();
@@ -2702,6 +2703,67 @@ async function maybeOpenConsoleUrl(provider) {
   return maybeOpenUrl(url);
 }
 
+function getDocsUrl(pathname = "") {
+  const path = `/${String(pathname || "").trim().replace(/^\/+/, "")}`;
+  return `${DOCS_BASE_URL}${path}`;
+}
+
+function isProcessAlive(pid) {
+  const value = Number(pid);
+  if (!Number.isFinite(value) || value <= 0) return false;
+  try {
+    process.kill(Math.floor(value), 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function maybeAutostartGateway(runtime, { cwd, io = console } = {}) {
+  if (process.env.WATERBROTHER_GATEWAY_CHILD === "1") {
+    return { attempted: false, started: false, reason: "gateway-child" };
+  }
+
+  const gateway = runtime?.gateway || {};
+  const startupChannels = Array.isArray(gateway.startupChannels)
+    ? gateway.startupChannels.map((value) => String(value || "").trim().toLowerCase()).filter(Boolean)
+    : [];
+
+  if (!gateway.enabled || !startupChannels.includes("telegram")) {
+    return { attempted: false, started: false, reason: "not-configured" };
+  }
+
+  const telegram = runtime?.channels?.telegram || {};
+  if (!telegram.enabled || !String(telegram.botToken || "").trim()) {
+    return { attempted: false, started: false, reason: "telegram-not-ready" };
+  }
+
+  const processInfo = await loadGatewayProcessInfo("telegram");
+  if (isProcessAlive(processInfo.pid)) {
+    return { attempted: true, started: false, reason: "already-running", pid: processInfo.pid };
+  }
+
+  const child = spawn(process.execPath, [BIN_PATH, "gateway", "run", "telegram", "--skip-onboarding"], {
+    cwd,
+    detached: true,
+    stdio: "ignore",
+    env: {
+      ...process.env,
+      WATERBROTHER_GATEWAY_CHILD: "1"
+    }
+  });
+  child.unref();
+
+  await saveGatewayProcessInfo("telegram", {
+    pid: child.pid,
+    startedAt: new Date().toISOString(),
+    command: "gateway run telegram --skip-onboarding"
+  });
+
+  io.log?.(dim(`telegram gateway autostarted in background (pid ${child.pid})`));
+  return { attempted: true, started: true, pid: child.pid };
+}
+
 async function chooseFromInteractiveMenu({ title, options, defaultIndex = 0 }) {
   if (!process.stdin.isTTY || !process.stdout.isTTY || options.length === 0) {
     return options[Math.max(0, Math.min(defaultIndex, options.length - 1))] || null;
@@ -3002,6 +3064,79 @@ async function runOnboardingWizard(config, { cwd }) {
     allowRemote: providerSpec?.supportsRemoteModelList !== false
   });
   next.agentProfile = await chooseAgentProfileInteractive(next.agentProfile || 'coder');
+  const configureTelegram = await promptYesNo("Enable Telegram remote control now?", {
+    input: process.stdin,
+    output: process.stdout
+  });
+  if (configureTelegram) {
+    const alreadyHaveToken = await promptYesNo("Do you already have a Telegram BotFather token?", {
+      input: process.stdin,
+      output: process.stdout
+    });
+    if (!alreadyHaveToken) {
+      console.log("Create a bot with @BotFather, copy the token, then come back here.");
+      console.log(dim(`Guide: ${getDocsUrl("/onboarding/telegram")}`));
+      const openGuide = await promptYesNo("Open the Telegram setup guide in your browser?", {
+        input: process.stdin,
+        output: process.stdout
+      });
+      if (openGuide) {
+        const opened = await maybeOpenUrl(getDocsUrl("/onboarding/telegram"));
+        if (!opened) {
+          console.log(dim(`Could not open browser automatically. Visit ${getDocsUrl("/onboarding/telegram")}`));
+        }
+      }
+    }
+
+    const existingToken = String(next.channels?.telegram?.botToken || "").trim();
+    let telegramToken = existingToken;
+    if (telegramToken) {
+      const keepExistingTelegramToken = await promptYesNo(`Use saved Telegram bot token (${formatApiKeyHint(telegramToken)})?`, {
+        input: process.stdin,
+        output: process.stdout
+      });
+      if (!keepExistingTelegramToken) {
+        telegramToken = "";
+      }
+    }
+
+    while (!telegramToken) {
+      const enteredTelegramToken = (await promptLine("Paste Telegram bot token (Enter to skip for now): ")).trim();
+      if (!enteredTelegramToken) break;
+      telegramToken = enteredTelegramToken;
+    }
+
+    if (telegramToken) {
+      const channels = next.channels && typeof next.channels === "object" ? { ...next.channels } : {};
+      const telegram = channels.telegram && typeof channels.telegram === "object" ? { ...channels.telegram } : {};
+      channels.telegram = {
+        ...telegram,
+        enabled: true,
+        botToken: telegramToken,
+        pairingMode: telegram.pairingMode || "manual",
+        allowedUserIds: Array.isArray(telegram.allowedUserIds) ? telegram.allowedUserIds : [],
+        pairingExpiryMinutes: Number.isFinite(Number(telegram.pairingExpiryMinutes)) ? Math.max(1, Math.floor(Number(telegram.pairingExpiryMinutes))) : 720
+      };
+      next.channels = channels;
+
+      const gateway = next.gateway && typeof next.gateway === "object" ? { ...next.gateway } : {};
+      const startupChannels = new Set(Array.isArray(gateway.startupChannels) ? gateway.startupChannels.map((value) => String(value || "").trim()).filter(Boolean) : []);
+      startupChannels.add("telegram");
+      next.gateway = {
+        ...gateway,
+        enabled: true,
+        controlMode: gateway.controlMode === "group" ? "group" : "single-user",
+        startupChannels: [...startupChannels],
+        requirePairing: gateway.requirePairing !== false
+      };
+
+      console.log(green("Telegram configured for DM-first pairing."));
+      console.log(dim("When you launch the Waterbrother TUI, the Telegram gateway will now autostart in the background."));
+      console.log(dim("You can still run `waterbrother gateway run telegram` manually if you want a dedicated gateway process."));
+    } else {
+      console.log(dim("Skipping Telegram setup for now. You can always run `waterbrother onboarding telegram` later."));
+    }
+  }
   if (!next.approvalMode) next.approvalMode = 'on-request';
   if (!next.designModel) next.designModel = getDefaultDesignModelForProvider(next.provider);
   if (next.traceMode === undefined) next.traceMode = 'on';
@@ -6398,6 +6533,7 @@ Be concrete about surfaces — name actual pages/flows. Choose the best stack fo
     }
   }
 
+  await maybeAutostartGateway(context.runtime, { cwd: context.cwd });
   printInteractiveHeader({ runtime: context.runtime, agent, cwd: context.cwd });
   console.log("Interactive mode. Type /exit to quit, /help for commands.");
   if (process.stdout.isTTY) {

package/src/gateway-state.js

@@ -9,6 +9,10 @@ function gatewayStatePath(serviceId) {
   return path.join(GATEWAY_DIR, `${String(serviceId || "").trim().toLowerCase()}.json`);
 }
 
+function gatewayProcessPath(serviceId) {
+  return path.join(GATEWAY_DIR, `${String(serviceId || "").trim().toLowerCase()}.process.json`);
+}
+
 function normalizeGatewayState(parsed = {}) {
   return {
     offset: Number.isFinite(Number(parsed?.offset)) ? Math.max(0, Math.floor(Number(parsed.offset))) : 0,
@@ -68,3 +72,36 @@ export async function saveGatewayState(serviceId, state) {
   await fs.rename(tmpPath, filePath);
   return next;
 }
+
+export async function loadGatewayProcessInfo(serviceId) {
+  await ensureGatewayStateDir();
+  const filePath = gatewayProcessPath(serviceId);
+  try {
+    const raw = await fs.readFile(filePath, "utf8");
+    const parsed = JSON.parse(raw);
+    return {
+      pid: Number.isFinite(Number(parsed?.pid)) ? Math.floor(Number(parsed.pid)) : 0,
+      startedAt: String(parsed?.startedAt || "").trim(),
+      command: String(parsed?.command || "").trim()
+    };
+  } catch (error) {
+    if (error?.code === "ENOENT") {
+      return { pid: 0, startedAt: "", command: "" };
+    }
+    throw error;
+  }
+}
+
+export async function saveGatewayProcessInfo(serviceId, info = {}) {
+  await ensureGatewayStateDir();
+  const filePath = gatewayProcessPath(serviceId);
+  const next = {
+    pid: Number.isFinite(Number(info?.pid)) ? Math.floor(Number(info.pid)) : 0,
+    startedAt: String(info?.startedAt || "").trim(),
+    command: String(info?.command || "").trim()
+  };
+  const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+  await fs.writeFile(tmpPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+  await fs.rename(tmpPath, filePath);
+  return next;
+}