@codeyam-editor/codeyam-editor 0.1.14-staging.ge9fdd0f → 0.1.15-staging.g8a9ebd4

package/npm/agent-cli-install.js

@@ -0,0 +1,102 @@
+'use strict';
+// How each build agent's CLI gets installed on a fleet VM, and the in-container
+// install script that does it. Pure — no I/O; npm/cloud.js runs the script over
+// SSH (ensureAgentCliInstalled) and owns the gates around it. Split out of
+// cloud.js so the install dimension is one concern with one test file.
+//
+// Two install kinds, mirroring the Rust `CliInstall::{Npm, Script}` split in
+// BuildAgentProvider::cli_spec() (crates/types/src/config/harness.rs):
+//   npm    — a global npm package (claude, codex, gemini)
+//   script — the agent's own install command, run verbatim (muse)
+
+// Muse is not on npm: it installs through Meta's curl launcher into
+// `~/.local/bin`. Mirrors `MUSE_INSTALL_COMMAND` in
+// crates/types/src/config/harness.rs (the spike-verified command — the launcher
+// download answers unauthenticated, so a VM needs no sign-in to install).
+// Cross-reference: keep the two strings identical.
+const MUSE_INSTALL_COMMAND =
+  'mkdir -p "$HOME/.local/bin" && curl -fsSL https://api.meta.ai/muse-launcher.sh -o "$HOME/.local/bin/muse" && chmod +x "$HOME/.local/bin/muse" && MUSE_LAUNCHER_INSTALL=1 "$HOME/.local/bin/muse"';
+
+const AGENT_CLI_INSTALLS = {
+  claude: { kind: "npm", package: "@anthropic-ai/claude-code" },
+  codex: { kind: "npm", package: "@openai/codex" },
+  gemini: { kind: "npm", package: "@google/gemini-cli" },
+  muse: { kind: "script", command: MUSE_INSTALL_COMMAND },
+};
+
+/** Map an agent name to how its CLI is installed — `{ kind: "npm", package }`
+ *  or `{ kind: "script", command }`. Throws on unknown agents so adding an
+ *  agent is a one-entry change in `AGENT_CLI_INSTALLS`. */
+function agentCliInstall(agent) {
+  if (!Object.prototype.hasOwnProperty.call(AGENT_CLI_INSTALLS, agent)) {
+    throw new Error(
+      `Unknown agent: ${agent}. Supported: ${Object.keys(AGENT_CLI_INSTALLS).join(", ")}`,
+    );
+  }
+  return AGENT_CLI_INSTALLS[agent];
+}
+
+/** The bash script that installs `agent`'s CLI inside the editor container,
+ *  dispatched on its install kind (see `agentCliInstall`). Pure — returns the
+ *  script text. Both kinds short-circuit when the binary already resolves. A
+ *  script install must end with a binary that runs and reports a version, so a
+ *  launcher that downloaded but cannot execute fails provisioning loudly (with
+ *  the install output attached by runFatalSshStep) instead of rostering a VM
+ *  whose CLI was never usable. */
+function buildAgentCliInstallScript(agent, install) {
+  const header = [
+    "#!/usr/bin/env bash",
+    "set -euo pipefail",
+    `BINARY="${agent}"`,
+    "",
+  ];
+  if (install.kind === "script") {
+    return [
+      ...header,
+      "if command -v \"$BINARY\" >/dev/null 2>&1 || [ -x \"$HOME/.local/bin/$BINARY\" ]; then",
+      "  echo \"  ✓ $BINARY already installed\"",
+      "  exit 0",
+      "fi",
+      "",
+      "echo \"Installing $BINARY via its install script in container...\"",
+      install.command,
+      "RESOLVED=$(command -v \"$BINARY\" 2>/dev/null || echo \"$HOME/.local/bin/$BINARY\")",
+      "if [ ! -x \"$RESOLVED\" ]; then",
+      "  echo \"  ✗ $BINARY install script finished but no $BINARY binary was found (looked on PATH and in $HOME/.local/bin)\" >&2",
+      "  exit 1",
+      "fi",
+      "\"$RESOLVED\" --version",
+      "echo \"  ✓ Successfully installed $BINARY at $RESOLVED\"",
+    ].join("\n");
+  }
+  return [
+    ...header,
+    `PACKAGE="${install.package}"`,
+    `AGENT="${agent}"`,
+    "",
+    "if command -v \"$BINARY\" >/dev/null 2>&1; then",
+    "  echo \"  ✓ $BINARY already installed on PATH\"",
+    "  exit 0",
+    "fi",
+    "",
+    "echo \"Installing $PACKAGE globally in container...\"",
+    "if [ \"$AGENT\" = \"claude\" ]; then",
+    "  rm -rf /usr/lib/node_modules/@anthropic-ai/.claude-code-*",
+    "  npm install -g \"$PACKAGE\"",
+    "  RESOLVED=$(find /usr/lib/node_modules/@anthropic-ai -name claude -type f -path '*linux-x64*' 2>/dev/null | head -1)",
+    "  if [ -n \"$RESOLVED\" ]; then",
+    "    ln -sf \"$RESOLVED\" /usr/local/bin/claude",
+    "  fi",
+    "else",
+    "  npm install -g \"$PACKAGE\"",
+    "fi",
+    "echo \"  ✓ Successfully installed $BINARY\"",
+  ].join("\n");
+}
+
+module.exports = {
+  MUSE_INSTALL_COMMAND,
+  AGENT_CLI_INSTALLS,
+  agentCliInstall,
+  buildAgentCliInstallScript,
+};