@aiaiai-pt/martha-cli 0.53.1 → 0.54.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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"

package/dist/index.js

@@ -11129,7 +11129,7 @@ init_config();
 init_errors();
 
 // src/version.ts
-var CLI_VERSION = "0.53.1";
+var CLI_VERSION = "0.54.0";
 
 // src/commands/sessions.ts
 function relativeTime(iso) {
@@ -14785,6 +14785,28 @@ function buzzAppCandidates(platform, env2, home) {
   ];
 }
 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(`
 `);
@@ -14844,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) => {
@@ -14889,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");
@@ -15222,21 +15254,25 @@ function registerChannelCommands(program2) {
       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.1",
+  "version": "0.54.0",
   "description": "Terminal-first client for the Martha AI platform",
   "homepage": "https://docs.martha.nomadriver.co",
   "repository": {