Skip to content

Claude Code. Any Model. The most powerful AI coding agent now speaks every language.

feat(team): require magmux 0.15.0 and ship it in the npm packages

Jack Rudenko2e2e8361b230
diff --git a/.github/magmux.env b/.github/magmux.env
index e014b34e..fe74b9ae 100644
--- a/.github/magmux.env
+++ b/.github/magmux.env
@@ -3,8 +3,8 @@
# Bump the tag and all four checksums together, deliberately, after the pane suites
# pass against the new release. The sums are copied from the release's checksums.txt
# and verified independently of it: a replaced asset or a moved tag fails the download.
-MAGMUX_TAG=v0.14.0
-MAGMUX_SHA256_darwin_amd64=3ad723b3b2ea8ab55aff1df0a91d7cdb4eef2afc121e22fbdf76b31de1d49ded
-MAGMUX_SHA256_darwin_arm64=a00ebd3f0c2b9fab14b1bd1ca554aaa1f60bbdddbae4e6dd634d65fb5ffda9e3
-MAGMUX_SHA256_linux_amd64=4a37911687f781e312239f86f82e259c1937f69a249897d6ee386737be4b01d7
-MAGMUX_SHA256_linux_arm64=bb22ce371d136cde07a407965898ff9f6c1a46d93b19d05bd7f0cc511b9603b2
+MAGMUX_TAG=v0.15.0
+MAGMUX_SHA256_darwin_amd64=927ec2309973d1fd7c4aaf9ed59be25799445174b154304a6d663ab31161f148
+MAGMUX_SHA256_darwin_arm64=89a7bf7bc3208f1dc1bd9d5742390c650cf1aa00f4d74a8b4fa6f6bf8c7f0531
+MAGMUX_SHA256_linux_amd64=2971e527fd8f3ef37deed31bd59a2aeb14b1465334b5de94111bbaa641ac9ee6
+MAGMUX_SHA256_linux_arm64=24c506e91c2673d1d62d18bc3cb4542367652dd75cccd7ca55ea96584163918a
diff --git a/ai-docs/architecture/pane-session.md b/ai-docs/architecture/pane-session.md
index ff73cde3..b795d3de 100644
--- a/ai-docs/architecture/pane-session.md
+++ b/ai-docs/architecture/pane-session.md
@@ -608,8 +608,8 @@ reserves N panes before a run's spawn loop; each start consumes one, whether it
pane's life. `capture` and `capture_session` are memory reads. `aboveBoxChangedAt` moves only when a
row ABOVE the input box changes, so the status line ticking under the box never holds a quiet window
open. 4 fps (research recommended 2–4) halves boot, witness and settle latency at no idle cost.
-- `assertMagmuxAvailable` requires `magmux --version` ≥ 0.14.0 (cached per binary), and every
- connect re-checks `capabilities` (`protocol: 1`, version ≥ 0.14.0). claudish never substitutes print mode.
+- `assertMagmuxAvailable` requires `magmux --version` ≥ 0.15.0 (cached per binary), and every
+ connect re-checks `capabilities` (`protocol: 1`, version ≥ 0.15.0). claudish never substitutes print mode.
The release job bundles a pinned magmux and checks the pin against `MIN_MAGMUX_VERSION`.
- **Latent, outside this driver:** `team-grid.ts` (CLI `--grid`) does not pass `--sock-dir`, so an
inherited `MAGMUX_SOCK_DIR` would move its socket (F7).
diff --git a/docs/usage/magmux.md b/docs/usage/magmux.md
index e04dc5ef..2fbf9de8 100644
--- a/docs/usage/magmux.md
+++ b/docs/usage/magmux.md
@@ -60,7 +60,7 @@ has finished, and closes the pane when the slot or session ends.
**Requirements:**
-- **magmux 0.14.0 or newer.** The npm package bundles it on macOS and Linux; otherwise
+- **magmux 0.15.0 or newer.** The npm package bundles it on macOS and Linux; otherwise
`brew install MadAppGang/tap/magmux`. With an older magmux, or none, `team(mode:"run")`,
`create_session` and `claudish team` / `--team` refuse with `magmux_unavailable`; claudish
never substitutes print mode.
diff --git a/packages/cli/src/mcp-server.ts b/packages/cli/src/mcp-server.ts
index 2c9fc139..1b7ac4aa 100644
--- a/packages/cli/src/mcp-server.ts
+++ b/packages/cli/src/mcp-server.ts
@@ -459,7 +459,7 @@ export const NEXT_STEP: Record<FailureReason, string> = {
"the child never read all of its task file — check that its agent or tool flags allow " +
"Read and that the model can call tools; `what` says which lines were read",
child_exited: "read the evidence screen, then retry or drop the model",
- pane_lost: "magmux died — check `magmux --version` ≥ 0.14.0 and retry",
+ pane_lost: "magmux died — check `magmux --version` ≥ 0.15.0 and retry",
blocked:
"the child asked a question team cannot answer — make the prompt self-contained or use " +
"create_session",
@@ -1948,7 +1948,7 @@ function defineTools(sessionManager: SessionManager, nested: boolean): ToolDefin
"it in its own headless magmux pane. Returns at once with state STARTING; nothing is " +
"pushed while it runs: poll list_sessions (about once every 10 s) for its state, then " +
"call get_output once it is COMPLETED. With a prompt it is one-shot (it ends when that turn " +
- "settles); without one it is interactive and waits for send_input. Needs magmux >= 0.14.0 " +
+ "settles); without one it is interactive and waits for send_input. Needs magmux >= 0.15.0 " +
"(darwin and linux).",
inputSchema: {
type: "object",
diff --git a/packages/cli/src/pane/pane-launch.test.ts b/packages/cli/src/pane/pane-launch.test.ts
index d2b03baa..3fa3b082 100644
--- a/packages/cli/src/pane/pane-launch.test.ts
+++ b/packages/cli/src/pane/pane-launch.test.ts
@@ -274,26 +274,26 @@ describe("watcher argv and version gate", () => {
test("the magmux version probe never blocks the event loop; an old version is refused", async () => {
const dir = tmp();
const slow = join(dir, "magmux-slow");
- writeFileSync(slow, "#!/bin/sh\nsleep 0.6\necho 'magmux 0.14.0 (fake)'\n");
+ writeFileSync(slow, "#!/bin/sh\nsleep 0.6\necho 'magmux 0.15.0 (fake)'\n");
chmodSync(slow, 0o755);
let ticks = 0;
const timer = setInterval(() => ticks++, 50);
try {
- expect(await assertMagmuxAvailable(slow)).toEqual({ binary: slow, version: "0.14.0" });
+ expect(await assertMagmuxAvailable(slow)).toEqual({ binary: slow, version: "0.15.0" });
} finally {
clearInterval(timer);
}
expect(ticks).toBeGreaterThanOrEqual(5); // a synchronous probe would let none run
const old = join(dir, "magmux-old");
- writeFileSync(old, "#!/bin/sh\necho 'magmux 0.13.9'\n");
+ writeFileSync(old, "#!/bin/sh\necho 'magmux 0.14.0'\n");
chmodSync(old, 0o755);
- await expect(assertMagmuxAvailable(old)).rejects.toThrow(/panes need >= 0.14.0/);
+ await expect(assertMagmuxAvailable(old)).rejects.toThrow(/panes need >= 0.15.0/);
});
test("versionAtLeast", () => {
- expect(versionAtLeast("0.14.0", "0.14.0")).toBe(true);
- expect(versionAtLeast("0.15.2", "0.14.0")).toBe(true);
- expect(versionAtLeast("0.13.9", "0.14.0")).toBe(false);
- expect(versionAtLeast("1.0.0", "0.14.0")).toBe(true);
+ expect(versionAtLeast("0.15.0", "0.15.0")).toBe(true);
+ expect(versionAtLeast("0.15.2", "0.15.0")).toBe(true);
+ expect(versionAtLeast("0.14.9", "0.15.0")).toBe(false);
+ expect(versionAtLeast("1.0.0", "0.15.0")).toBe(true);
});
});
diff --git a/packages/cli/src/pane/pane-launch.ts b/packages/cli/src/pane/pane-launch.ts
index e2e9b8f0..057186af 100644
--- a/packages/cli/src/pane/pane-launch.ts
+++ b/packages/cli/src/pane/pane-launch.ts
@@ -484,7 +484,7 @@ export const KNOWN_CLAUDISH_FLAGS: readonly string[] = Object.keys(CLAUDISH_FLAG
/* ───────────────────────────── magmux binary ───────────────────────────── */
-export const MIN_MAGMUX_VERSION = "0.14.0";
+export const MIN_MAGMUX_VERSION = "0.15.0";
export class MagmuxUnavailableError extends Error {
readonly code = "magmux_unavailable";
@@ -505,7 +505,7 @@ export function versionAtLeast(v: string, min: string): boolean {
const magmuxCache = new Map<string, { binary: string; version: string }>();
const execFileAsync = promisify(execFile);
-/** The magmux binary and its version (≥ 0.14.0), cached per process. Never a `-p` fallback. */
+/** The magmux binary and its version (≥ 0.15.0), cached per process. Never a `-p` fallback. */
export async function assertMagmuxAvailable(
binary?: string
): Promise<{ binary: string; version: string }> {
diff --git a/packages/cli/src/pane/pane-registry.test.ts b/packages/cli/src/pane/pane-registry.test.ts
index aee014d3..71d498ab 100644
--- a/packages/cli/src/pane/pane-registry.test.ts
+++ b/packages/cli/src/pane/pane-registry.test.ts
@@ -433,7 +433,7 @@ describe.skipIf(!MAGMUX)(`pane registry, real magmux (${MAGMUX ? "" : NO_MAGMUX_
test("R3-M1: a magmux spawn failure reaps at once — record and dirs gone, no watcher, livePaneCount 0", async () => {
const t = env();
const fake = join(t.tmp, "magmux-fake");
- writeFileSync(fake, "#!/bin/sh\necho 'magmux 0.14.0 (fake)'\n");
+ writeFileSync(fake, "#!/bin/sh\necho 'magmux 0.15.0 (fake)'\n");
chmodSync(fake, 0o755);
await assertMagmuxAvailable(fake); // passes the version gate …
rmSync(fake);
diff --git a/packages/cli/src/team-cli.ts b/packages/cli/src/team-cli.ts
index 3080b32e..1644a8ac 100644
--- a/packages/cli/src/team-cli.ts
+++ b/packages/cli/src/team-cli.ts
@@ -88,7 +88,7 @@ Options (run / run-and-judge):
--timeout <secs> Grid modes only: magmux's own per-pane timeout (default: 300).
json mode has no deadline — nothing kills a working model.
json mode runs each model as an interactive pane in a headless
- magmux (>= 0.14.0; darwin and linux).
+ magmux (>= 0.15.0; darwin and linux).
--grid Show all models in a magmux grid with live output + status bar
--mode <m> run only: json (default, panes), default (the grid, as --grid)
or interactive (as --interactive)
diff --git a/packages/cli/src/team-orchestrator.ts b/packages/cli/src/team-orchestrator.ts
index 66d3b807..e6aebdb9 100644
--- a/packages/cli/src/team-orchestrator.ts
+++ b/packages/cli/src/team-orchestrator.ts
@@ -1139,7 +1139,7 @@ function assertValidRequirePattern(pattern: string | undefined): void {
/**
* The pre-spawn refusals of a team run, in the order the MCP `run` handler applies them
* BEFORE `setupSession` writes anything (§4.1): the caller's flags (D18), a prompt that
- * cannot be delivered with those flags (§2.3 rule 4), magmux present (≥ 0.14.0), no
+ * cannot be delivered with those flags (§2.3 rule 4), magmux present (≥ 0.15.0), no
* ACTIVE run at the path, and room under the per-user pane limit. Each throws an Error
* whose message starts with its code (`invalid_args:`, `magmux_unavailable:`,
* `pane_limit:`). `startModels` repeats them, so the CLI gets the same checks.