@hasna/bridge 0.1.1 → 0.1.2

package/dist/lib/daemon.d.ts

@@ -0,0 +1,123 @@
+import type { BridgeConfig } from "../types.js";
+export type DaemonSupervisor = "process" | "launchd" | "systemd";
+export type DaemonSupervisorOption = DaemonSupervisor | "auto";
+export interface DaemonPaths {
+    dir: string;
+    lockDir: string;
+    metadataFile: string;
+    stdoutLog: string;
+    stderrLog: string;
+    launchdPlist: string;
+    systemdUnit: string;
+}
+export interface DaemonMetadata {
+    version: 1;
+    supervisor: "process";
+    pid: number;
+    pgid?: number;
+    startedAt: string;
+    identity: {
+        command: string;
+        cwd: string;
+        configPath: string;
+        statePath: string;
+        daemonDir: string;
+        bridgeHome: string;
+    };
+    command: string[];
+    cwd: string;
+    configPath: string;
+    statePath: string;
+    intervalMs: number;
+    serveJson: boolean;
+    daemonDir: string;
+    bridgeHome: string;
+    stdoutLog: string;
+    stderrLog: string;
+}
+export interface DaemonStatus {
+    running: boolean;
+    stale: boolean;
+    supervisor: DaemonSupervisor;
+    pid?: number;
+    startedAt?: string;
+    uptimeSeconds?: number;
+    detail?: string;
+    installedDetail?: string;
+    metadata?: DaemonMetadata;
+    paths: DaemonPaths;
+    installed: {
+        launchd: boolean;
+        systemd: boolean;
+    };
+    telegramApiBase: {
+        overridden: boolean;
+        origin: string;
+        pathname: string;
+        error?: string;
+    };
+}
+export interface DaemonStartOptions {
+    supervisor?: DaemonSupervisorOption;
+    daemonDir?: string;
+    configPath?: string;
+    statePath?: string;
+    intervalMs?: number;
+    serveJson?: boolean;
+}
+export interface DaemonStopOptions {
+    supervisor?: DaemonSupervisorOption;
+    daemonDir?: string;
+    timeoutMs?: number;
+    force?: boolean;
+}
+export interface DaemonInstallOptions {
+    supervisor?: DaemonSupervisorOption;
+    daemonDir?: string;
+    configPath?: string;
+    statePath?: string;
+    intervalMs?: number;
+    serveJson?: boolean;
+}
+export interface DaemonInstallResult {
+    supervisor: DaemonSupervisor;
+    path: string;
+    command: string[];
+    requiredEnv: string[];
+    warning?: string;
+}
+export declare function resolveSupervisor(supervisor?: DaemonSupervisorOption): DaemonSupervisor;
+export declare function defaultDaemonDir(): string;
+export declare function daemonPaths(daemonDir?: string): DaemonPaths;
+export declare function ensureDaemonDir(dir?: string): Promise<DaemonPaths>;
+export declare function requiredTelegramEnvVars(config: BridgeConfig): string[];
+export declare function daemonStatus(options?: {
+    daemonDir?: string;
+    supervisor?: DaemonSupervisorOption;
+}): Promise<DaemonStatus>;
+export declare function startProcessDaemon(options?: DaemonStartOptions): Promise<DaemonStatus>;
+export declare function stopProcessDaemon(options?: DaemonStopOptions): Promise<DaemonStatus>;
+export declare function restartProcessDaemon(options?: DaemonStartOptions & DaemonStopOptions): Promise<DaemonStatus>;
+export declare function renderLaunchdPlist(command: string[], paths: DaemonPaths): string;
+export declare function renderSystemdUnit(command: string[], paths: DaemonPaths): string;
+export declare function installDaemon(options?: DaemonInstallOptions): Promise<DaemonInstallResult>;
+export declare function startInstalledDaemon(options?: DaemonInstallOptions): Promise<DaemonInstallResult>;
+export declare function stopInstalledDaemon(options?: DaemonStopOptions): Promise<void>;
+export declare function restartInstalledDaemon(options?: DaemonInstallOptions & DaemonStopOptions): Promise<DaemonInstallResult | DaemonStatus>;
+export declare function uninstallDaemon(options?: {
+    supervisor?: DaemonSupervisorOption;
+    daemonDir?: string;
+}): Promise<{
+    supervisor: DaemonSupervisor;
+    removed: string[];
+}>;
+export declare function tailFile(path: string, lines: number): Promise<string>;
+export declare function daemonLogs(options?: {
+    daemonDir?: string;
+    lines?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+    paths: DaemonPaths;
+}>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/lib/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/lib/daemon.ts"],"names":[],"mappings":"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"}

package/dist/lib/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,aAAa,CAAC;AA0B7D,wBAAsB,MAAM,CAAC,UAAU,SAAsB,EAAE,SAAS,SAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCpH"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,aAAa,CAAC;AAsC7D,wBAAsB,MAAM,CAAC,UAAU,SAAsB,EAAE,SAAS,SAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+DpH"}

package/dist/lib/telegram.d.ts

@@ -17,6 +17,12 @@ export interface TelegramUpdate {
         date?: number;
     };
 }
+export interface TelegramApiBaseInfo {
+    overridden: boolean;
+    origin: string;
+    pathname: string;
+}
+export declare function telegramApiBaseInfo(): TelegramApiBaseInfo;
 export declare function telegramToken(channel: TelegramChannelConfig): string;
 export declare function telegramChatAllowed(channel: TelegramChannelConfig, chatId: string | undefined): boolean;
 export declare function sendTelegramMessage(token: string, chatId: string, text: string): Promise<unknown>;

package/dist/lib/telegram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/lib/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAChE,IAAI,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvE,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAKpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIvG;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASvG;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,CAa5G"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/lib/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAChE,IAAI,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvE,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAID,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAgB,mBAAmB,IAAI,mBAAmB,CAOzD;AAUD,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAKpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIvG;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASvG;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GACzD,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,CAa5G"}

package/dist/mcp/index.js

@@ -4225,8 +4225,9 @@ async function loadConfig(configPath = defaultConfigPath()) {
     throw err;
   }
 }
-// src/lib/doctor.ts
-import { stat } from "fs/promises";
+// src/lib/daemon.ts
+import { chmod as chmod2, mkdir as mkdir2, readFile as readFile2, rename, rm, rmdir, stat, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname2, join as join3, resolve } from "path";
 
 // src/lib/state.ts
 import { dirname, join as join2 } from "path";
@@ -4234,18 +4235,261 @@ function defaultStatePath() {
   return process.env["BRIDGE_STATE"] || join2(bridgeHome(), "state.json");
 }
 
-// src/lib/doctor.ts
+// src/lib/telegram.ts
+var DEFAULT_TELEGRAM_API_BASE = "https://api.telegram.org";
+function telegramApiBase() {
+  const raw = process.env["BRIDGE_TELEGRAM_API_BASE"] || DEFAULT_TELEGRAM_API_BASE;
+  const parsed = new URL(raw);
+  if (!["http:", "https:"].includes(parsed.protocol)) {
+    throw new Error("BRIDGE_TELEGRAM_API_BASE must use http or https");
+  }
+  if (parsed.username || parsed.password) {
+    throw new Error("BRIDGE_TELEGRAM_API_BASE must not contain credentials");
+  }
+  if (parsed.search || parsed.hash) {
+    throw new Error("BRIDGE_TELEGRAM_API_BASE must not contain query strings or fragments");
+  }
+  return parsed;
+}
+function telegramApiBaseInfo() {
+  const parsed = telegramApiBase();
+  return {
+    overridden: parsed.href.replace(/\/$/, "") !== DEFAULT_TELEGRAM_API_BASE,
+    origin: parsed.origin,
+    pathname: parsed.pathname
+  };
+}
+function telegramMethodUrl(token, method) {
+  const base = telegramApiBase();
+  const prefix = base.pathname.replace(/\/$/, "");
+  base.pathname = `${prefix}/bot${token}/${method}`;
+  base.search = "";
+  return base.toString();
+}
+function telegramToken(channel) {
+  const envName = channel.botTokenEnv || "TELEGRAM_BOT_TOKEN";
+  const token = process.env[envName];
+  if (!token)
+    throw new Error(`Missing Telegram bot token env var: ${envName}`);
+  return token;
+}
+function telegramChatAllowed(channel, chatId) {
+  if (channel.allowAllChats)
+    return true;
+  if (!channel.allowedChatIds?.length)
+    return false;
+  return Boolean(chatId && channel.allowedChatIds.includes(chatId));
+}
+async function sendTelegramMessage(token, chatId, text) {
+  const response = await fetch(telegramMethodUrl(token, "sendMessage"), {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ chat_id: chatId, text })
+  });
+  const body = await response.json().catch(() => {
+    return;
+  });
+  if (!response.ok)
+    throw new Error(`Telegram sendMessage failed (${response.status}): ${JSON.stringify(body)}`);
+  return body;
+}
+
+// src/lib/daemon.ts
 function isNotFound(err) {
   return Boolean(err && typeof err === "object" && "code" in err && err.code === "ENOENT");
 }
+function currentPlatformSupervisor() {
+  if (process.platform === "darwin")
+    return "launchd";
+  if (process.platform === "linux")
+    return "systemd";
+  return "process";
+}
+function resolveSupervisor(supervisor = "process") {
+  return supervisor === "auto" ? currentPlatformSupervisor() : supervisor;
+}
+function defaultDaemonDir() {
+  return join3(bridgeHome(), "daemon");
+}
+function daemonPaths(daemonDir = defaultDaemonDir()) {
+  const dir = resolve(daemonDir);
+  return {
+    dir,
+    lockDir: join3(dir, "lock"),
+    metadataFile: join3(dir, "bridge-daemon.json"),
+    stdoutLog: join3(dir, "bridge.out.log"),
+    stderrLog: join3(dir, "bridge.err.log"),
+    launchdPlist: join3(process.env["HOME"] || process.cwd(), "Library", "LaunchAgents", "com.hasna.bridge.plist"),
+    systemdUnit: join3(process.env["HOME"] || process.cwd(), ".config", "systemd", "user", "hasna-bridge.service")
+  };
+}
+async function fileExists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch (err) {
+    if (isNotFound(err))
+      return false;
+    throw err;
+  }
+}
+async function readMetadata(paths) {
+  try {
+    return JSON.parse(await readFile2(paths.metadataFile, "utf-8"));
+  } catch (err) {
+    if (isNotFound(err))
+      return;
+    throw err;
+  }
+}
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function processCommand(pid) {
+  const proc = Bun.spawn(["ps", "-p", String(pid), "-o", "command="], {
+    stdout: "pipe",
+    stderr: "ignore"
+  });
+  if (await proc.exited !== 0)
+    return;
+  return (await new Response(proc.stdout).text()).trim();
+}
+async function processPgid(pid) {
+  const proc = Bun.spawn(["ps", "-p", String(pid), "-o", "pgid="], {
+    stdout: "pipe",
+    stderr: "ignore"
+  });
+  if (await proc.exited !== 0)
+    return;
+  const parsed = Number.parseInt((await new Response(proc.stdout).text()).trim(), 10);
+  return Number.isInteger(parsed) ? parsed : undefined;
+}
+async function processMatches(metadata) {
+  if (!pidAlive(metadata.pid))
+    return false;
+  const command = await processCommand(metadata.pid);
+  if (!command)
+    return false;
+  if (!metadata.pgid)
+    return false;
+  const pgid = await processPgid(metadata.pid);
+  if (pgid !== metadata.pgid)
+    return false;
+  const requiredArgs = [
+    metadata.command[1],
+    "serve",
+    "--config",
+    metadata.configPath,
+    "--state",
+    metadata.statePath,
+    "--interval",
+    String(metadata.intervalMs)
+  ].filter((arg) => Boolean(arg));
+  if (metadata.serveJson)
+    requiredArgs.push("--json");
+  return requiredArgs.every((arg) => command.includes(arg));
+}
+function safeTelegramApiBaseInfo() {
+  try {
+    return telegramApiBaseInfo();
+  } catch (err) {
+    return {
+      overridden: true,
+      origin: "",
+      pathname: "",
+      error: err instanceof Error ? err.message : String(err)
+    };
+  }
+}
+async function runCapture(command) {
+  const proc = Bun.spawn(command, { stdout: "pipe", stderr: "pipe" });
+  const [exitCode, stdout, stderr] = await Promise.all([
+    proc.exited,
+    new Response(proc.stdout).text(),
+    new Response(proc.stderr).text()
+  ]);
+  return { exitCode, stdout, stderr };
+}
+async function installedSupervisorStatus(supervisor, paths) {
+  if (supervisor === "launchd") {
+    if (!await fileExists(paths.launchdPlist))
+      return { running: false, detail: "launchd plist not installed" };
+    const uid = typeof process.getuid === "function" ? process.getuid() : undefined;
+    if (uid === undefined)
+      return { running: false, detail: "launchd status requires a numeric uid" };
+    const result = await runCapture(["launchctl", "print", `gui/${uid}/com.hasna.bridge`]);
+    if (result.exitCode !== 0)
+      return { running: false, detail: result.stderr.trim() || result.stdout.trim() || "launchd service not loaded" };
+    const running = /state\s*=\s*running/.test(result.stdout);
+    return { running, detail: running ? "launchd running" : "launchd loaded but not running" };
+  }
+  if (supervisor === "systemd") {
+    if (!await fileExists(paths.systemdUnit))
+      return { running: false, detail: "systemd unit not installed" };
+    const result = await runCapture(["systemctl", "--user", "is-active", "hasna-bridge.service"]);
+    const state = result.stdout.trim() || result.stderr.trim() || "unknown";
+    return { running: result.exitCode === 0 && state === "active", detail: `systemd ${state}` };
+  }
+  return { running: false, detail: "process supervisor has no installed status" };
+}
+async function daemonStatus(options = {}) {
+  const supervisor = resolveSupervisor(options.supervisor);
+  const paths = daemonPaths(options.daemonDir);
+  const metadata = await readMetadata(paths);
+  const live = metadata ? await processMatches(metadata) : false;
+  const stale = Boolean(metadata && !live);
+  const startedAt = metadata?.startedAt;
+  const uptimeSeconds = live && startedAt ? Math.max(0, Math.floor((Date.now() - Date.parse(startedAt)) / 1000)) : undefined;
+  const installed = {
+    launchd: await fileExists(paths.launchdPlist),
+    systemd: await fileExists(paths.systemdUnit)
+  };
+  const installedRuntime = supervisor === "process" ? undefined : await installedSupervisorStatus(supervisor, paths);
+  return {
+    running: installedRuntime ? installedRuntime.running : live,
+    stale: installedRuntime ? false : stale,
+    supervisor,
+    pid: metadata?.pid,
+    startedAt,
+    uptimeSeconds,
+    detail: installedRuntime?.detail || (stale ? "stale process metadata" : live ? "running" : "not running"),
+    installedDetail: installedRuntime?.detail,
+    metadata,
+    paths,
+    installed,
+    telegramApiBase: safeTelegramApiBaseInfo()
+  };
+}
+// src/lib/doctor.ts
+import { stat as stat2 } from "fs/promises";
+function isNotFound2(err) {
+  return Boolean(err && typeof err === "object" && "code" in err && err.code === "ENOENT");
+}
 async function privateFileCheck(name, path) {
   try {
-    const info = await stat(path);
+    const info = await stat2(path);
     const mode = info.mode & 511;
     const ok = (mode & 63) === 0;
     return { name, ok, detail: `${path} mode=${mode.toString(8)}` };
   } catch (err) {
-    if (isNotFound(err))
+    if (isNotFound2(err))
+      return { name, ok: true, detail: `not created yet: ${path}` };
+    return { name, ok: false, detail: `${path}: ${err instanceof Error ? err.message : String(err)}` };
+  }
+}
+async function privateDirCheck(name, path) {
+  try {
+    const info = await stat2(path);
+    const mode = info.mode & 511;
+    const ok = (mode & 63) === 0;
+    return { name, ok, detail: `${path} mode=${mode.toString(8)}` };
+  } catch (err) {
+    if (isNotFound2(err))
       return { name, ok: true, detail: `not created yet: ${path}` };
     return { name, ok: false, detail: `${path}: ${err instanceof Error ? err.message : String(err)}` };
   }
@@ -4259,9 +4503,32 @@ async function commandExists(command) {
 }
 async function doctor(configPath = defaultConfigPath(), statePath = defaultStatePath()) {
   const checks = [];
-  let config = await loadConfig(configPath);
+  const config = await loadConfig(configPath);
+  const daemon = await daemonStatus();
+  const paths = daemonPaths();
   checks.push(await privateFileCheck("config", configPath));
   checks.push(await privateFileCheck("state", statePath));
+  checks.push(await privateDirCheck("daemon-dir", paths.dir));
+  checks.push(await privateFileCheck("daemon-metadata", paths.metadataFile));
+  checks.push({
+    name: "daemon-status",
+    ok: !daemon.stale,
+    detail: daemon.running ? `running pid=${daemon.pid}` : daemon.stale ? `stale pid=${daemon.pid}` : "not running"
+  });
+  try {
+    const apiBase = telegramApiBaseInfo();
+    checks.push({
+      name: "telegram-api-base",
+      ok: true,
+      detail: apiBase.overridden ? `overridden: ${apiBase.origin}${apiBase.pathname}` : apiBase.origin
+    });
+  } catch (err) {
+    checks.push({
+      name: "telegram-api-base",
+      ok: false,
+      detail: err instanceof Error ? err.message : String(err)
+    });
+  }
   for (const command of ["bridge", "codewith", "claude", "aicopilot"]) {
     checks.push({
       name: `command:${command}`,
@@ -4292,35 +4559,6 @@ async function doctor(configPath = defaultConfigPath(), statePath = defaultState
   }
   return { ok: checks.every((check) => check.ok), configPath, checks };
 }
-// src/lib/telegram.ts
-function telegramToken(channel) {
-  const envName = channel.botTokenEnv || "TELEGRAM_BOT_TOKEN";
-  const token = process.env[envName];
-  if (!token)
-    throw new Error(`Missing Telegram bot token env var: ${envName}`);
-  return token;
-}
-function telegramChatAllowed(channel, chatId) {
-  if (channel.allowAllChats)
-    return true;
-  if (!channel.allowedChatIds?.length)
-    return false;
-  return Boolean(chatId && channel.allowedChatIds.includes(chatId));
-}
-async function sendTelegramMessage(token, chatId, text) {
-  const response = await fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify({ chat_id: chatId, text })
-  });
-  const body = await response.json().catch(() => {
-    return;
-  });
-  if (!response.ok)
-    throw new Error(`Telegram sendMessage failed (${response.status}): ${JSON.stringify(body)}`);
-  return body;
-}
-
 // src/lib/router.ts
 function matchingRoutes(config, message) {
   const channel = config.channels[message.channelId];

package/docs/architecture.md

@@ -49,3 +49,34 @@ secrets are not exposed through `bridge_config`.
 
 Long-poll offsets are persisted in a private state file so process restarts do
 not replay already-seen updates and re-run agents.
+
+`BRIDGE_TELEGRAM_API_BASE` can override the Telegram API origin for local tests.
+The override accepts only `http` or `https` URLs without credentials. It is not
+intended for normal production use because bot tokens are part of Telegram API
+request paths.
+
+## Daemon Model
+
+The foreground runtime remains `bridge serve`. Daemon commands are lifecycle
+wrappers around that same runtime:
+
+- `bridge daemon start` uses a local process supervisor by default.
+- `bridge daemon status` reads private metadata and verifies the recorded
+  process still looks like `bridge serve`.
+- `bridge daemon stop` terminates the process group and removes stale metadata.
+- `bridge daemon logs` reads private stdout/stderr logs.
+- `bridge daemon install` writes user `launchd` or user `systemd` files.
+
+The process supervisor is the quickest local testing path because it inherits
+the shell environment, including Telegram token env vars. Installed launchd and
+systemd services do not store token values by default; operators must make token
+env vars available through their service manager.
+
+Daemon files live under `~/.hasna/bridge/daemon` by default. The directory is
+`0700`; metadata and log files are `0600`. Logs are considered sensitive because
+they can contain prompts, Telegram text, agent stdout/stderr, and routing
+errors.
+
+`bridge serve` handles per-channel poll errors without exiting in long-running
+mode. `serve --once` still fails fast so health checks and tests can catch
+misconfiguration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/bridge",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Agent messaging bridge for Telegram and other channels",
   "type": "module",
   "main": "dist/index.js",