@mifune/agro 0.18.0 → 0.19.0

package/README.md

@@ -105,7 +105,7 @@ with `AGRO_EXECUTION_TARGET=local` or `AGRO_EXECUTION_TARGET=docker-compose`.
 | `agro compose config` | Print the resolved compose configuration. |
 | `agro harness <list\|install\|status>` | Install and inspect agent CLI harnesses. `install` is the only door: it probes the running sandbox, installs into the persistent home volume, and reports. It reads and writes no `agro.json` field, and needs no rebuild. |
 | `agro tool <list\|install\|status>` | Install and inspect sandbox tooling that is not an agent CLI. `herdr`, `cloudflared`, `agent-browser`, `microsandbox`, and `tailscale` are `installable`; `gh` and the Docker CLI are `baked-in` and cannot be installed. Nothing installs at boot. A large download is confirmed first, and `--yes` accepts it. |
-| `agro gateway <args…>` | Manage a messaging client session (Slack bridge for `pi`/`hermes`). |
+| `agro gateway <args…>` | Manage a messaging client session (Slack bridge for `pi`/`hermes`, or the `openclaw` gateway). |
 | `agro --version` | Print the CLI version. |
 | `agro --help` | Show help; every subcommand also accepts `--help`. |
 

package/dist/agro.js

@@ -2251,7 +2251,7 @@ function resolveExecutionTarget(opts) {
 }
 
 // src/lib/version.ts
-var AGRO_VERSION = true ? "0.18.0" : "0.0.0-dev";
+var AGRO_VERSION = true ? "0.19.0" : "0.0.0-dev";
 var OFFICIAL_IMAGE = "ghcr.io/mifunedev/agro";
 var RELEASE_VERSION = /^[0-9]+\.[0-9]+\.[0-9]+(?:-[a-z][a-z0-9]*\.[0-9]+)?$/;
 function parseReleaseVersion(value) {
@@ -3145,6 +3145,25 @@ var HARNESS_CATALOG = [
     docsPath: "docs/harnesses/opencode.md",
     kind: "installable"
   },
+  {
+    id: "openclaw",
+    title: "OpenClaw",
+    binary: "openclaw",
+    installArgv: [
+      "npm",
+      "--prefix",
+      HARNESS_PREFIX_TOKEN,
+      "install",
+      "-g",
+      "--allow-scripts=openclaw",
+      "openclaw@2026.9.9"
+    ],
+    installUser: "sandbox",
+    verifyArgv: ["openclaw", "--version"],
+    uninstallArgv: ["npm", "--prefix", HARNESS_PREFIX_TOKEN, "uninstall", "-g", "openclaw"],
+    docsPath: "docs/harnesses/openclaw.md",
+    kind: "installable"
+  },
   {
     id: "grok-build",
     title: "Grok Build",
@@ -3197,7 +3216,7 @@ var HARNESS_CATALOG = [
     installArgv: [
       "bash",
       "-lc",
-      `set -o pipefail; curl -fsSL https://antigravity.google/cli/install.sh | bash -s -- --dir "${HARNESS_PREFIX_TOKEN}/bin"`
+      `set -o pipefail; curl -fsSL https://antigravity.google/cli/install.sh | gzip -cdf | bash -s -- --dir "${HARNESS_PREFIX_TOKEN}/bin"`
     ],
     installUser: "sandbox",
     verifyArgv: ["agy", "--version"],
@@ -4740,8 +4759,15 @@ var PROBE_TIMEOUT_MS = 15e3;
 function isReachable(status) {
   return status === "ready" || status === "starting";
 }
-function targetFor(root, run, env) {
-  const name = configuredContainerName(root) ?? DEFAULT_CONTAINER_NAME;
+function registeredContainerName(cwd) {
+  try {
+    return configuredContainerName(resolveSandboxRoot(cwd === void 0 ? {} : { cwd }));
+  } catch {
+    return void 0;
+  }
+}
+function targetFor(root, cwd, run, env) {
+  const name = configuredContainerName(root) ?? registeredContainerName(cwd) ?? DEFAULT_CONTAINER_NAME;
   return resolveExecutionTarget({
     projectRoot: root,
     container: name,
@@ -4821,9 +4847,9 @@ function probeableHost(env, home) {
   if (!existsSync20(join16(root, ".git")) && !existsSync20(prefix)) return void 0;
   return { root, prefix };
 }
-async function collectStates(root, run, home, env, only) {
+async function collectStates(root, cwd, run, home, env, only) {
   const entries = only ? [...only] : [...HARNESS_CATALOG];
-  const target = targetFor(root, run, env);
+  const target = targetFor(root, cwd, run, env);
   const reachable = isReachable(await resolveTargetStatus(target));
   if (reachable) {
     const states2 = [];
@@ -4876,7 +4902,7 @@ INSTALLED is \`?\` \u2014 the sandbox is not running. Start it with \`${bin} san
 async function runHarnessList(opts, io) {
   const run = opts.run ?? spawnRunner;
   const root = resolveProjectRoot(opts.cwd);
-  const collected = await collectStates(root, run, homeOf(opts), opts.env);
+  const collected = await collectStates(root, opts.cwd, run, homeOf(opts), opts.env);
   if (opts.json) {
     io.stdout(`${JSON.stringify(collected.states, null, 2)}
 `);
@@ -4902,7 +4928,7 @@ async function runHarnessStatus(name, opts, io) {
     only = findHarness(name);
     if (!only) return unknownHarness(name, io, opts.bin);
   }
-  const collected = await collectStates(root, run, homeOf(opts), opts.env, only ? [only] : void 0);
+  const collected = await collectStates(root, opts.cwd, run, homeOf(opts), opts.env, only ? [only] : void 0);
   if (opts.json) {
     io.stdout(`${JSON.stringify(only ? collected.states[0] : collected.states, null, 2)}
 `);
@@ -4911,7 +4937,7 @@ async function runHarnessStatus(name, opts, io) {
   }
   return 0;
 }
-function hermesTargetRoot(target) {
+function sandboxTargetRoot(target) {
   return target.kind === "docker-compose" ? "/home/sandbox/harness" : target.workspace.targetRoot;
 }
 function shellPath(path4) {
@@ -4924,7 +4950,7 @@ function hermesLaunch(io, root) {
 function hermesEnv(root) {
   return { ...agroEnvPair("PROJECT_ROOT", root), HERMES_HOME: `${root}/.hermes` };
 }
-async function reconcileHermes(target, io, bin, user, root = hermesTargetRoot(target)) {
+async function reconcileHermes(target, io, bin, user, root = sandboxTargetRoot(target)) {
   const result = await target.exec({
     argv: remoteControlDirScript(root, "scripts/link-providers.sh", ["--init", "--hermes-only"]),
     env: hermesEnv(root),
@@ -4937,7 +4963,7 @@ async function reconcileHermes(target, io, bin, user, root = hermesTargetRoot(ta
   }
   return result.exitCode;
 }
-async function validateHermesHome(target, io, bin, user, inheritedHome, root = hermesTargetRoot(target)) {
+async function validateHermesHome(target, io, bin, user, inheritedHome, root = sandboxTargetRoot(target)) {
   const result = await target.exec({
     argv: remoteControlDirScript(root, "scripts/hermes-workspace.sh", [
       "check",
@@ -4955,7 +4981,7 @@ async function validateHermesHome(target, io, bin, user, inheritedHome, root = h
   }
   return result.exitCode;
 }
-async function configureHermes(target, io, bin, user, root = hermesTargetRoot(target)) {
+async function configureHermes(target, io, bin, user, root = sandboxTargetRoot(target)) {
   const result = await target.exec({
     argv: remoteControlDirScript(root, "scripts/hermes-workspace.sh", [
       "configure",
@@ -4974,6 +5000,55 @@ async function configureHermes(target, io, bin, user, root = hermesTargetRoot(ta
   }
   return result.exitCode;
 }
+function openclawStateDir(root) {
+  return `${root}/.openclaw`;
+}
+function shellWord(value) {
+  return /^[\w./-]+$/.test(value) ? value : shellPath(value);
+}
+function openclawLaunch(io, root) {
+  io.stdout(`Run OpenClaw in the AGRO workspace: OPENCLAW_STATE_DIR=${shellWord(openclawStateDir(root))} openclaw
+`);
+}
+function openclawEnv(root) {
+  return { ...agroEnvPair("PROJECT_ROOT", root), OPENCLAW_STATE_DIR: openclawStateDir(root) };
+}
+async function validateOpenclawState(target, io, bin, user, inheritedDir, root = sandboxTargetRoot(target)) {
+  const result = await target.exec({
+    argv: remoteControlDirScript(root, "scripts/openclaw-workspace.sh", [
+      "check",
+      root,
+      openclawStateDir(root),
+      inheritedDir ?? ""
+    ]),
+    env: openclawEnv(root),
+    ...user ? { user } : {},
+    stdio: "capture"
+  });
+  if (result.exitCode !== 0) {
+    io.stderr(result.stderr || `${bin} harness: could not validate the OpenClaw state directory; select OPENCLAW_STATE_DIR=${shellWord(openclawStateDir(root))} before retrying.
+`);
+  }
+  return result.exitCode;
+}
+async function configureOpenclaw(target, io, bin, user, root = sandboxTargetRoot(target)) {
+  const result = await target.exec({
+    argv: remoteControlDirScript(root, "scripts/openclaw-workspace.sh", [
+      "configure",
+      root,
+      openclawStateDir(root),
+      "openclaw"
+    ]),
+    env: openclawEnv(root),
+    ...user ? { user } : {},
+    stdio: "inherit"
+  });
+  if (result.exitCode !== 0) {
+    io.stderr(`${bin} harness: OpenClaw workspace configuration failed (exit ${result.exitCode}); no installation success reported.
+`);
+  }
+  return result.exitCode;
+}
 function unreachableReason(status) {
   return runtimeIsAbsent(status) ? "No container runtime is on PATH." : `The sandbox is not running (${status}).`;
 }
@@ -5050,10 +5125,15 @@ async function installOnHost(entry, opts, io, run, status) {
   const prefix = hostPrefix(home);
   const target = hostTargetFor(root, prefix, run, env);
   const hermes = entry.id === "hermes";
+  const openclaw = entry.id === "openclaw";
   if (hermes) {
     const code = await validateHermesHome(target, io, bin, void 0, env.HERMES_HOME, root);
     if (code !== 0) return code;
   }
+  if (openclaw) {
+    const code = await validateOpenclawState(target, io, bin, void 0, env.OPENCLAW_STATE_DIR, root);
+    if (code !== 0) return code;
+  }
   const linked = await target.exec({
     argv: remoteControlDirScript(root, "scripts/link-providers.sh", ["--init"]),
     env: agroEnvPair("PROJECT_ROOT", root),
@@ -5067,7 +5147,7 @@ Run: bash ${root}/.agro/scripts/link-providers.sh --init
     );
     return 1;
   }
-  const installEnv = hermes ? hermesEnv(root) : void 0;
+  const installEnv = hermes ? hermesEnv(root) : openclaw ? openclawEnv(root) : void 0;
   if (hermes) {
     const code = await reconcileHermes(target, io, bin, void 0, root);
     if (code !== 0) return code;
@@ -5080,11 +5160,16 @@ Run: bash ${root}/.agro/scripts/link-providers.sh --init
 `);
     return 1;
   }
-  if (await probeInstalled(target, entry, prefix, void 0, installEnv) === true && (hasReceipt || !hostBinaryUnderPrefix(entry, prefix))) {
+  const present = await probeInstalled(target, entry, prefix, void 0, installEnv) === true;
+  if (present && !hasReceipt && !hostBinaryUnderPrefix(entry, prefix)) {
     if (hermes) {
       const code = await configureHermes(target, io, bin, void 0, root);
       if (code !== 0) return code;
     }
+    if (openclaw) {
+      const code = await configureOpenclaw(target, io, bin, void 0, root);
+      if (code !== 0) return code;
+    }
     io.stdout(`${entry.id}: already installed (${entry.binary})
 `);
     try {
@@ -5095,9 +5180,10 @@ Run: bash ${root}/.agro/scripts/link-providers.sh --init
       return 1;
     }
     if (hermes) hermesLaunch(io, root);
+    if (openclaw) openclawLaunch(io, root);
     return 0;
   }
-  io.stdout(`installing ${entry.title} on the host\u2026
+  io.stdout(`${present && hasReceipt ? "updating" : "installing"} ${entry.title} on the host\u2026
 `);
   const r = await target.exec({
     argv: resolveInstallArgv(entry, prefix),
@@ -5120,6 +5206,10 @@ Run: bash ${root}/.agro/scripts/link-providers.sh --init
     const configured = await configureHermes(target, io, bin, void 0, root);
     if (configured !== 0) return configured;
   }
+  if (openclaw) {
+    const configured = await configureOpenclaw(target, io, bin, void 0, root);
+    if (configured !== 0) return configured;
+  }
   const receipt = {
     prefix,
     binary: entry.binary,
@@ -5150,6 +5240,7 @@ Run: bash ${root}/.agro/scripts/link-providers.sh --init
 `);
   }
   if (hermes) hermesLaunch(io, root);
+  else if (openclaw) openclawLaunch(io, root);
   else io.stdout(`Run ${entry.title} in the AGRO workspace: cd ${root} && ${harnessLaunchCommand(entry)}
 `);
   return 0;
@@ -5248,7 +5339,7 @@ async function runHarnessUninstall(name, opts, io) {
   const root = resolveProjectRoot(opts.cwd);
   const entry = findHarness(name);
   if (!entry) return unknownHarness(name, io, opts.bin);
-  const target = targetFor(root, run, opts.env);
+  const target = targetFor(root, opts.cwd, run, opts.env);
   if (!isReachable(await resolveTargetStatus(target))) {
     return await uninstallOnHost(entry, opts, io, run);
   }
@@ -5272,40 +5363,41 @@ async function runHarnessInstall(name, opts, io) {
   const env = opts.env ?? process.env;
   const projectRoot = agroEnvValue(env, "PROJECT_ROOT");
   const root = resolveProjectRoot(
-    name === "hermes" && runningInsideSandbox(env) && projectRoot !== void 0 ? projectRoot : opts.cwd
+    (name === "hermes" || name === "openclaw") && runningInsideSandbox(env) && projectRoot !== void 0 ? projectRoot : opts.cwd
   );
   const entry = findHarness(name);
   if (!entry) return unknownHarness(name, io, opts.bin);
-  const target = targetFor(root, run, opts.env);
+  const target = targetFor(root, opts.cwd, run, opts.env);
   const status = await resolveTargetStatus(target);
   if (!isReachable(status)) {
     return await installOnHost(entry, opts, io, run, status);
   }
   const hermes = entry.id === "hermes";
-  const installEnv = hermes ? hermesEnv(hermesTargetRoot(target)) : void 0;
+  const openclaw = entry.id === "openclaw";
+  const targetRoot = sandboxTargetRoot(target);
+  const installEnv = hermes ? hermesEnv(targetRoot) : openclaw ? openclawEnv(targetRoot) : void 0;
   if (hermes) {
     const checked = await validateHermesHome(target, io, opts.bin, "sandbox", env.HERMES_HOME);
     if (checked !== 0) return checked;
     const code = await reconcileHermes(target, io, opts.bin, "sandbox");
     if (code !== 0) return code;
   }
-  const already = await probeInstalled(target, entry, SANDBOX_HARNESS_PREFIX, "sandbox", installEnv);
-  if (already === true && await sandboxMarkerExists(target, entry)) {
-    if (hermes) {
-      const code = await configureHermes(target, io, opts.bin, "sandbox");
-      if (code !== 0) return code;
-    }
-    io.stdout(`${entry.id}: already installed (${entry.binary})
-`);
-    if (hermes) hermesLaunch(io, hermesTargetRoot(target));
-    return 0;
+  if (openclaw) {
+    const checked = await validateOpenclawState(target, io, opts.bin, "sandbox", env.OPENCLAW_STATE_DIR);
+    if (checked !== 0) return checked;
   }
+  const already = await probeInstalled(target, entry, SANDBOX_HARNESS_PREFIX, "sandbox", installEnv);
   if (already === null) {
     io.stderr("docker is required to install into the running sandbox but was not found on PATH\n");
     return 1;
   }
-  io.stdout(`installing ${entry.title} into the sandbox\u2026
+  if (already && await sandboxMarkerExists(target, entry)) {
+    io.stdout(`updating ${entry.title} in the sandbox\u2026
+`);
+  } else {
+    io.stdout(`installing ${entry.title} into the sandbox\u2026
 `);
+  }
   const r = await target.exec({
     argv: resolveInstallArgv(entry, SANDBOX_HARNESS_PREFIX),
     user: entry.installUser,
@@ -5328,6 +5420,10 @@ async function runHarnessInstall(name, opts, io) {
     const configured = await configureHermes(target, io, opts.bin, "sandbox");
     if (configured !== 0) return configured;
   }
+  if (openclaw) {
+    const configured = await configureOpenclaw(target, io, opts.bin, "sandbox");
+    if (configured !== 0) return configured;
+  }
   const marker = sandboxMarkerPath(entry);
   const marked = await target.exec({
     argv: ["sh", "-c", `mkdir -p "$(dirname "$1")" && : > "$1"`, "sh", marker],
@@ -5341,7 +5437,8 @@ async function runHarnessInstall(name, opts, io) {
   }
   io.stdout(`${entry.id}: installed \u2014 see ${sourceDocsUrl(entry.docsPath)} for authentication
 `);
-  if (hermes) hermesLaunch(io, hermesTargetRoot(target));
+  if (hermes) hermesLaunch(io, targetRoot);
+  if (openclaw) openclawLaunch(io, targetRoot);
   return 0;
 }
 
@@ -6605,7 +6702,7 @@ Usage:
   ${bin} workspace <args...>    Create and list host AGRO workspaces (create|list)
   ${bin} harness <args...>      Install and inspect agent CLI harnesses
   ${bin} tool <args...>         Install and inspect sandbox tooling
-  ${bin} gateway <args...>      Manage a messaging client session (pi|hermes)
+  ${bin} gateway <args...>      Manage a messaging client session (pi|hermes|openclaw)
   ${bin} --version              Print version
   ${bin} --help                 Show this help
 
@@ -6813,10 +6910,10 @@ function printGatewayHelp(bin = AGRO_PRODUCT.bin) {
   process.stdout.write(`${bin} gateway \u2014 Manage a messaging client session (Slack bridge)
 
 Usage:
-  ${bin} gateway <pi|hermes> [--attach]   start the client session (--attach after)
-  ${bin} gateway <pi|hermes> --restart    restart the session
-  ${bin} gateway <pi|hermes> --stop       stop the session
-  ${bin} gateway status                   show both sessions
+  ${bin} gateway <pi|hermes|openclaw> [--attach]   start the client session (--attach after)
+  ${bin} gateway <pi|hermes|openclaw> --restart    restart the session
+  ${bin} gateway <pi|hermes|openclaw> --stop       stop the session
+  ${bin} gateway status                            show all sessions
 
 Only a LEADING --help/-h is intercepted here; everything else passes through
 verbatim to the vendored ${stateNames(bin).controlDir}/scripts/gateway.sh with ${stateNames(bin).envPrefix}PROJECT_ROOT set to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mifune/agro",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "AGRO CLI — create and manage sandboxes for coding agents.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/mifunedev/agro#readme",
@@ -34,7 +34,7 @@
     "prepublishOnly": "npm run typecheck:build"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^24.0.0",
     "esbuild": "^0.28.1",
     "typescript": "^5.6.0"
   }