@tritard/waterbrother 0.16.10 → 0.16.12

package/README.md

@@ -32,6 +32,7 @@ It is Vercel-ready via `vercel.json` (clean URLs, no build step required).
   - 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.10",
+  "version": "0.16.12",
   "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,7 +60,8 @@ 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.ai").trim().replace(/\/+$/, "");
+const BIN_PATH = path.join(PACKAGE_ROOT, "bin", "waterbrother.js");
+const DOCS_BASE_URL = String(process.env.WATERBROTHER_DOCS_BASE_URL || "https://waterbrother.app").trim().replace(/\/+$/, "");
 
 
 const MODEL_CATALOG = listLocalModels();
@@ -2708,6 +2709,62 @@ function getDocsUrl(pathname = "") {
   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;
@@ -3075,7 +3132,8 @@ async function runOnboardingWizard(config, { cwd }) {
       };
 
       console.log(green("Telegram configured for DM-first pairing."));
-      console.log(dim("After onboarding, run `waterbrother gateway run telegram`, DM the bot once, then approve the pending pairing locally."));
+      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."));
     }
@@ -6476,6 +6534,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;
+}