@bondsmith/bondsmithd 0.1.1 → 0.1.2

package/README.md

@@ -37,7 +37,7 @@ Environment variables (all optional):
 ```
 PORT=4577                                    # defaults to 4577
 ALLOWED_ORIGINS=https://app.bondsmith.dev
-BONDSMITH_RELAY_URL=wss://relay.bondsmith.dev # defaults to a local-only address; set this for a real install
+BONDSMITH_RELAY_URL=ws://127.0.0.1:8787       # defaults to production; set this when developing bondsmithd against a local apps/relay
 ```
 
 `BONDSMITH_DEV_TUNNEL_TOKEN` also exists but only applies to the legacy direct-connection path
@@ -54,10 +54,11 @@ BONDSMITH_RELAY_URL=wss://relay.bondsmith.dev # defaults to a local-only address
 
 ## Production connectivity (current status)
 
-`bondsmithd` connects outbound to the Bondsmith relay by default (`BONDSMITH_RELAY_ENABLED=true`),
-which is what a production account actually uses — no dev-tunnel token involved. Point
-`BONDSMITH_RELAY_URL` at `wss://relay.bondsmith.dev` for a real install (see "Environment
-variables" above); it defaults to a local-only address for monorepo development.
+`bondsmithd` connects outbound to the Bondsmith relay by default (`BONDSMITH_RELAY_ENABLED=true`,
+`BONDSMITH_RELAY_URL=wss://relay.bondsmith.dev`), which is what a production account actually
+uses — no dev-tunnel token involved, no config needed for a real install. Override
+`BONDSMITH_RELAY_URL` to a local apps/relay instance (see "Environment variables" above) only when
+developing bondsmithd itself.
 
 The dev-tunnel-token requirement only applies to the legacy direct-connection path
 (`BONDSMITH_RELAY_ENABLED=false`), which still 404s the token-handoff route in production by

package/dist/index.js

@@ -508,18 +508,19 @@ var environmentSchema = z8.object({
   // install needs to touch.
   BONDSMITH_BIND_HOST: z8.string().min(1).default("127.0.0.1"),
   // BD-450/BD-483/BD-484: connect outbound to the Bondsmith relay instead of
-  // (or alongside) listening inbound. ON by default — local dev is meant to
-  // mirror production's actual topology (browser -> relay -> daemon), not
-  // diverge from it, so plain `pnpm --filter @bondsmith/bondsmithd dev`
-  // connects outbound to a locally-running apps/relay (its own `pnpm dev`
-  // on the default port below) exactly like a real deployment would.
-  // BONDSMITH_RELAY_URL defaults to that same local apps/relay instance for
-  // the same reason. The existing inbound listener is completely
-  // unaffected either way — it keeps running regardless, so direct-
-  // connection debugging (bypassing the relay entirely) is still possible
-  // by setting BONDSMITH_RELAY_ENABLED=false explicitly.
+  // (or alongside) listening inbound. ON by default. The existing inbound
+  // listener is completely unaffected either way — it keeps running
+  // regardless, so direct-connection debugging (bypassing the relay
+  // entirely) is still possible by setting BONDSMITH_RELAY_ENABLED=false
+  // explicitly.
   BONDSMITH_RELAY_ENABLED: z8.string().default("true").transform((value) => value === "true" || value === "1"),
-  BONDSMITH_RELAY_URL: z8.string().url().default("ws://127.0.0.1:8787")
+  // Defaults to production, mirroring BONDSMITH_API_URL above, so a real
+  // install works with zero config — a bare `bondsmithd` used to silently
+  // connect outbound to loopback (nothing listening there) with no error,
+  // looking healthy while never reaching relay at all. Override to a local
+  // apps/relay instance (its own `pnpm dev` default port) when developing
+  // bondsmithd itself against a local relay.
+  BONDSMITH_RELAY_URL: z8.string().url().default("wss://relay.bondsmith.dev")
 });
 function getDaemonConfig(env = process.env) {
   const parsed = environmentSchema.parse(env);
@@ -763,6 +764,27 @@ var TmuxNoServerRunningError = class extends Error {
     this.name = "TmuxNoServerRunningError";
   }
 };
+var TmuxNotFoundError = class extends Error {
+  constructor() {
+    super(
+      [
+        "bondsmithd requires tmux, and it was not found on PATH.",
+        "",
+        "Install it:",
+        "  macOS (Homebrew):     brew install tmux",
+        "  Debian/Ubuntu:        sudo apt-get install tmux",
+        "  Fedora/RHEL:          sudo dnf install tmux",
+        "  Arch:                 sudo pacman -S tmux",
+        "",
+        "If tmux is already installed, start bondsmithd from a normal interactive shell \u2014",
+        "not a LaunchAgent, Docker container, or other minimal-PATH context. Those often",
+        "don't inherit the PATH tmux was installed into (e.g. Homebrew's /opt/homebrew/bin",
+        "on Apple Silicon)."
+      ].join("\n")
+    );
+    this.name = "TmuxNotFoundError";
+  }
+};
 var SENSITIVE_ENV_KEYS = ["ANTHROPIC_API_KEY", "BONDSMITH_DEV_TUNNEL_TOKEN"];
 function filterSpawnEnv(env) {
   const filtered = { ...env };
@@ -770,8 +792,13 @@ function filterSpawnEnv(env) {
   return filtered;
 }
 async function runTmux(args, options) {
-  const { stdout } = await execFile("tmux", args, { ...options, encoding: "utf8" });
-  return stdout;
+  try {
+    const { stdout } = await execFile("tmux", args, { ...options, encoding: "utf8" });
+    return stdout;
+  } catch (error2) {
+    if (error2?.code === "ENOENT") throw new TmuxNotFoundError();
+    throw error2;
+  }
 }
 async function sendKeysLiteral(tmuxSessionName, text) {
   await runTmux(["send-keys", "-t", tmuxSessionName, "-l", text]);
@@ -2346,7 +2373,12 @@ var PtyAttachmentManager = class {
           cwd: process.env.HOME,
           env: filterSpawnEnv(process.env)
         });
-      } catch {
+      } catch (error2) {
+        if (error2?.code === "ENOENT") {
+          console.error(`
+${new TmuxNotFoundError().message}
+`);
+        }
         return false;
       }
       handle = { process: ptyProcess, refCount: 0, dataListeners: /* @__PURE__ */ new Set() };
@@ -2505,6 +2537,12 @@ async function discoverSessions() {
     return Promise.all(sessions.map((session) => enrichSessionWithGitMetadata(session)));
   } catch (error2) {
     if (error2 instanceof TmuxNoServerRunningError) return [];
+    if (error2 instanceof TmuxNotFoundError) {
+      console.error(`
+${error2.message}
+`);
+      process.exit(1);
+    }
     throw error2;
   }
 }
@@ -2568,6 +2606,9 @@ var SessionManager = class {
       const output = await listTmuxSessions("#{session_name}");
       liveSessionNames = new Set(output.split("\n").filter((name) => name.length > 0));
     } catch (error2) {
+      if (error2 instanceof TmuxNotFoundError) console.error(`
+${error2.message}
+`);
       if (!(error2 instanceof TmuxNoServerRunningError)) return;
     }
     await Promise.all(

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bondsmith/bondsmithd",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"private": false,
 	"description": "Local daemon for Bondsmith agent sessions — runs on the user's own machine, pairs with a Bondsmith account, and exposes tmux-backed terminal sessions to the Bondsmith web app over a signed WebSocket protocol.",
 	"homepage": "https://bondsmith.dev",