@aiaiai-pt/martha-cli 0.53.0 → 0.54.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to `@aiaiai-pt/martha-cli`. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project adheres to semver — `0.x` releases may include breaking changes between minor versions.
 
+## [0.54.0] — 2026-08-03
+
+### Added — `channels` uses the Buzz binaries Desktop already ships
+
+- `buzz` and `buzz-acp` are now resolved from the user's PATH **or** from Buzz
+  Desktop's own bundle (`Buzz.app/Contents/MacOS` and the platform
+  equivalents), and `connect` prepends that directory to the harness's PATH so
+  `acp-serve --post-reply` can reach `buzz` to deliver. Desktop ships both as
+  Tauri sidecars and does exactly this for the agents it spawns itself
+  (`runtime/path.rs`); doing the same means a machine with Buzz Desktop
+  installed needs nothing on PATH and nothing built. Telling someone to
+  `cargo build` a binary sitting in their Applications folder was a
+  prerequisite we invented.
+- The two checks now read `buzz-acp` / `buzz CLI` rather than `… on PATH`,
+  since PATH is no longer the only place they can come from, and the detail
+  says which copy is in use. When neither has it, the fix leads with installing
+  Buzz Desktop and keeps the build-from-source path as the alternative.
+
+## [0.53.1] — 2026-08-03
+
+### Fixed — `channels install-harness` told a Buzz-less machine to "launch Buzz once"
+
+- The command registers Martha as a runtime *inside* Buzz Desktop, so with no
+  Desktop on the machine there is nothing to register with. It correctly
+  refused and wrote nothing, but the remedy assumed the app was installed and
+  merely unopened. It now probes for the application itself and says which of
+  the two situations it is: **not installed** (with the release link, and a
+  pointer to `martha channels connect buzz`, which needs no Desktop at all) or
+  **installed but never launched** (open it once). Both still name the exact
+  app-data paths so `--app-data` stays actionable.
+
 ## [0.53.0] — 2026-08-02
 
 ### Added — `martha channels`: connect an agent to a channel from either side (#1140)

package/dist/index.js

@@ -11129,7 +11129,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.53.0";
+var CLI_VERSION = "0.54.0";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -14770,6 +14770,62 @@ function buzzAppDataCandidates(platform, env2, home) {
 function chooseAppDataDir(candidates, exists) {
   return candidates.find((c) => exists(c.dir)) ?? null;
 }
+function buzzAppCandidates(platform, env2, home) {
+  if (platform === "darwin") {
+    return ["/Applications/Buzz.app", join3(home, "Applications", "Buzz.app")];
+  }
+  if (platform === "win32") {
+    const base = env2.LOCALAPPDATA ?? join3(home, "AppData", "Local");
+    return [join3(base, "Programs", "Buzz")];
+  }
+  return [
+    "/opt/Buzz",
+    "/usr/bin/buzz-desktop",
+    join3(home, ".local", "bin", "buzz-desktop")
+  ];
+}
+var BUZZ_RELEASES_URL = "https://github.com/block/buzz/releases/latest";
+function buzzSidecarDirs(platform, env2, home) {
+  if (platform === "darwin") {
+    return buzzAppCandidates(platform, env2, home).map((app) => join3(app, "Contents", "MacOS"));
+  }
+  if (platform === "win32") {
+    return buzzAppCandidates(platform, env2, home);
+  }
+  return ["/opt/Buzz"];
+}
+function resolveBuzzBinary(bin, opts) {
+  const onPath = resolveOnPath(bin, opts.env, opts.platform, opts.isExecutable);
+  if (onPath)
+    return { path: onPath, source: "path" };
+  if (bin.includes("/") || bin.includes("\\"))
+    return null;
+  for (const dir of buzzSidecarDirs(opts.platform, opts.env, opts.home)) {
+    const candidate = join3(dir, bin);
+    if (opts.isExecutable(candidate))
+      return { path: candidate, source: "desktop" };
+  }
+  return null;
+}
+function missingAppDataMessage(candidates, appInstalled) {
+  const looked = candidates.map((c) => `  ${c.dir}  (${c.build})`).join(`
+`);
+  if (appInstalled) {
+    return `Buzz Desktop is installed but has never been launched — it creates its ` + `data directory on first run.
+
+Looked for:
+${looked}
+` + `Open Buzz Desktop once, then re-run this. Or pass --app-data <dir>.`;
+  }
+  return `Buzz Desktop is not installed on this machine. This command registers ` + `Martha as a runtime INSIDE Desktop, so there is nothing to register with.
+
+` + `Looked for:
+${looked}
+` + `Install it: ${BUZZ_RELEASES_URL}
+
+` + `If you do not want Desktop at all, you do not need this command — run the ` + `adapter yourself instead:
+  martha channels connect buzz --agent <name> --relay <url>`;
+}
 var DEFAULT_BUZZ_KINDS = "9,46010,40007,7";
 function buzzAcpEnv(opts) {
   const env2 = {
@@ -14810,6 +14866,14 @@ function executableOnDisk(p) {
 function which(bin) {
   return resolveOnPath(bin, process.env, process.platform, executableOnDisk);
 }
+function whichBuzz(bin) {
+  return resolveBuzzBinary(bin, {
+    platform: process.platform,
+    env: process.env,
+    home: homedir(),
+    isExecutable: executableOnDisk
+  });
+}
 function runBin(bin, args, env2) {
   return new Promise((resolve2) => {
     execFile2(bin, args, { env: env2, timeout: 15000, maxBuffer: 4 * 1024 * 1024 }, (err, stdout, stderr) => {
@@ -14855,20 +14919,22 @@ async function preflightBuzz(ctx, opts) {
       fix: supported ? undefined : "upgrade the CLI that is FIRST on PATH: npm i -g @aiaiai-pt/martha-cli@latest (or point --martha-bin at the right one)"
     });
   }
-  const acpPath = which(opts.buzzAcpBin);
+  const resolveBin = opts.resolveBin ?? whichBuzz;
+  const acp = resolveBin(opts.buzzAcpBin);
   checks.push({
-    ok: !!acpPath,
-    label: "buzz-acp on PATH",
-    detail: acpPath ?? `'${opts.buzzAcpBin}' not found`,
-    fix: acpPath ? undefined : "build it from block/buzz: cargo build -p buzz-acp, then put target/debug on PATH (or pass --buzz-acp-bin)"
+    ok: !!acp,
+    label: "buzz-acp",
+    detail: acp ? acp.source === "desktop" ? `${acp.path} (bundled with Buzz Desktop)` : acp.path : `'${opts.buzzAcpBin}' not found on PATH or in Buzz Desktop`,
+    fix: acp ? undefined : `install Buzz Desktop (${BUZZ_RELEASES_URL}) — it ships this binary — or build it: cargo build -p buzz-acp (or pass --buzz-acp-bin)`
   });
-  const buzzPath = which(opts.buzzBin);
+  const buzz = resolveBin(opts.buzzBin);
   checks.push({
-    ok: !!buzzPath,
-    label: "buzz CLI on PATH",
-    detail: buzzPath ?? `'${opts.buzzBin}' not found`,
-    fix: buzzPath ? undefined : "build it from block/buzz: cargo build -p buzz-cli — acp-serve --post-reply shells it to deliver the answer"
+    ok: !!buzz,
+    label: "buzz CLI",
+    detail: buzz ? buzz.source === "desktop" ? `${buzz.path} (bundled with Buzz Desktop)` : buzz.path : `'${opts.buzzBin}' not found on PATH or in Buzz Desktop`,
+    fix: buzz ? undefined : `install Buzz Desktop (${BUZZ_RELEASES_URL}) — it ships this binary — or build it: cargo build -p buzz-cli. acp-serve --post-reply shells it to deliver the answer`
   });
+  const buzzPath = buzz?.path ?? null;
   let whoami = null;
   try {
     whoami = await ctx.api.get("/api/tasks/whoami");
@@ -15116,10 +15182,8 @@ function registerChannelCommands(program2) {
     const chosen = opts.appData ? { build: "release", dir: String(opts.appData) } : chooseAppDataDir(buzzAppDataCandidates(process.platform, process.env, homedir()), (d) => existsSync(d));
     if (!chosen) {
       const candidates = buzzAppDataCandidates(process.platform, process.env, homedir());
-      throw new CLIError("No Buzz Desktop app-data directory found.", 3 /* NotFound */, `Looked for:
-${candidates.map((c) => `  ${c.dir}  (${c.build})`).join(`
-`)}
-Launch Buzz Desktop once so it creates one, or pass --app-data <dir>.`);
+      const appInstalled = buzzAppCandidates(process.platform, process.env, homedir()).some((p) => existsSync(p));
+      throw new CLIError(appInstalled ? "Buzz Desktop has no data directory yet." : "Buzz Desktop is not installed.", 3 /* NotFound */, missingAppDataMessage(candidates, appInstalled));
     }
     const dir = join3(chosen.dir, "custom_harnesses");
     const file = join3(dir, `${def.id}.json`);
@@ -15190,21 +15254,25 @@ Launch Buzz Desktop once so it creates one, or pass --app-data <dir>.`);
       process.exitCode = 1 /* Error */;
       return;
     }
-    const acp = which(opts.buzzAcpBin);
+    const acp = whichBuzz(opts.buzzAcpBin);
+    const childPath = [
+      ...buzzSidecarDirs(process.platform, process.env, homedir()).filter((d) => existsSync(d)),
+      process.env.PATH ?? ""
+    ].filter(Boolean).join(process.platform === "win32" ? ";" : ":");
     if (opts.dryRun) {
       console.log(source_default.bold(`Would launch:
 `));
       for (const [k, v] of Object.entries(env2))
         console.log(`  ${k}=${v}`);
-      console.log(`  ${acp}
+      console.log(`  ${acp.path}
 `);
       return;
     }
     console.log(source_default.bold(`
 Connecting '${opts.agent}' to ${opts.relay} …
 `));
-    const child = spawn3(acp, [], {
-      env: { ...process.env, ...env2 },
+    const child = spawn3(acp.path, [], {
+      env: { ...process.env, PATH: childPath, ...env2 },
       stdio: "inherit"
     });
     await new Promise((resolve2) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiaiai-pt/martha-cli",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "description": "Terminal-first client for the Martha AI platform",
   "homepage": "https://docs.martha.nomadriver.co",
   "repository": {