@tryarcanist/cli 0.1.207 → 0.1.209

package/dist/index.js

@@ -8,8 +8,9 @@ import { Command } from "commander";
 import { execFileSync, spawn } from "child_process";
 import { existsSync as existsSync2, rmSync } from "fs";
 import { mkdtemp, readFile, rm } from "fs/promises";
-import { tmpdir } from "os";
+import { homedir as homedir2, tmpdir } from "os";
 import { join as join2 } from "path";
+import { createInterface as createInterface2 } from "readline/promises";
 
 // src/api.ts
 import { createRequire } from "module";
@@ -648,7 +649,19 @@ var GROK_SUBSCRIPTION_CLI_CONFIG = {
   // "…"}} — so the credential fields live one level down and the token field
   // is named `key`. Token detection scans nested objects.
   tokenFields: ["access_token", "refresh_token", "key"],
-  installHint: "Install the Grok CLI (https://x.ai/cli), or point at it with --grok-path <path> or ARCANIST_GROK_BIN."
+  installHint: "Install the Grok CLI (https://x.ai/cli), or point at it with --grok-path <path> or ARCANIST_GROK_BIN.",
+  // Official Grok Build installer: installs `grok` (plus an `agent` alias)
+  // under ~/.grok/bin, symlinks into ~/.local/bin or /usr/local/bin when
+  // writable, and appends PATH exports to shell rc files itself.
+  installer: {
+    command: "curl -fsSL https://x.ai/cli/install.sh | bash",
+    binCandidates: (home) => [
+      join2(home, ".grok", "bin", "grok"),
+      join2(home, ".local", "bin", "grok"),
+      "/usr/local/bin/grok"
+    ],
+    postInstallNote: "Grok CLI installed. Restart your shell if `grok` is not found on PATH later."
+  }
 };
 var CURSOR_SUBSCRIPTION_CLI_CONFIG = {
   harness: "cursor",
@@ -679,6 +692,15 @@ var CURSOR_SUBSCRIPTION_CLI_CONFIG = {
       { service: "cursor-access-token", field: "accessToken", required: true },
       { service: "cursor-refresh-token", field: "refreshToken", required: false }
     ]
+  },
+  // Official Cursor CLI installer: installs to ~/.local/bin. Installers have
+  // shipped the binary as both `cursor-agent` and `agent` (the 2026-07
+  // installer's success message says `agent`), so probe both — unambiguous
+  // name first, since `agent` is also Grok's alias.
+  installer: {
+    command: "curl https://cursor.com/install -fsS | bash",
+    binCandidates: (home) => [join2(home, ".local", "bin", "cursor-agent"), join2(home, ".local", "bin", "agent")],
+    postInstallNote: 'Cursor CLI installed to ~/.local/bin. Add it to your PATH for future shells: export PATH="$HOME/.local/bin:$PATH"'
   }
 };
 function subscriptionBasePath(harness) {
@@ -687,6 +709,69 @@ function subscriptionBasePath(harness) {
 function resolveVendorBin(config, optionPath) {
   return optionPath?.trim() || process.env[config.binEnvVar]?.trim() || config.defaultBin;
 }
+var VendorBinaryMissingError = class extends CliError {
+  constructor(config, binPath) {
+    super("user", `Could not find the \`${binPath}\` executable.`, { hint: config.installHint });
+    this.name = "VendorBinaryMissingError";
+  }
+};
+function runVendorInstall(config, command) {
+  return new Promise((resolve2, reject) => {
+    const child = spawn("bash", ["-c", command], { stdio: ["inherit", 2, "inherit"] });
+    child.on("error", (err) => {
+      reject(
+        new CliError("user", `Failed to run the ${config.displayName} CLI installer: ${err.message}`, {
+          hint: config.installHint
+        })
+      );
+    });
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve2();
+        return;
+      }
+      reject(
+        new CliError("user", `The ${config.displayName} CLI installer exited with code ${code ?? "unknown"}.`, {
+          hint: config.installHint
+        })
+      );
+    });
+  });
+}
+async function offerVendorInstall(config, explicitBinPath) {
+  const installer = config.installer;
+  if (!installer || explicitBinPath) return null;
+  if (process.platform !== "linux" && process.platform !== "darwin") return null;
+  if (!process.stdin.isTTY || !process.stdout.isTTY) return null;
+  console.error(`Could not find the \`${config.defaultBin}\` executable.`);
+  console.error(`Install it now by running: ${installer.command}`);
+  const rl = createInterface2({ input: process.stdin, output: process.stderr });
+  let answer;
+  try {
+    answer = (await rl.question("Proceed? [y/N] ")).trim().toLowerCase();
+  } finally {
+    rl.close();
+  }
+  if (answer !== "y" && answer !== "yes") return null;
+  await runVendorInstall(config, installer.command);
+  for (const candidate of installer.binCandidates(homedir2())) {
+    if (existsSync2(candidate)) {
+      if (installer.postInstallNote) console.error(installer.postInstallNote);
+      return candidate;
+    }
+  }
+  return config.defaultBin;
+}
+async function runVendorLoginWithInstallOffer(config, binPath, tempHome, explicitBinPath) {
+  try {
+    await runVendorLogin(config, binPath, tempHome);
+  } catch (err) {
+    if (!(err instanceof VendorBinaryMissingError)) throw err;
+    const installedBin = await offerVendorInstall(config, explicitBinPath);
+    if (!installedBin) throw err;
+    await runVendorLogin(config, installedBin, tempHome);
+  }
+}
 function runVendorLogin(config, binPath, tempHome) {
   return new Promise((resolve2, reject) => {
     const child = spawn(binPath, config.loginArgs, {
@@ -695,7 +780,7 @@ function runVendorLogin(config, binPath, tempHome) {
     });
     child.on("error", (err) => {
       if (err.code === "ENOENT") {
-        reject(new CliError("user", `Could not find the \`${binPath}\` executable.`, { hint: config.installHint }));
+        reject(new VendorBinaryMissingError(config, binPath));
         return;
       }
       reject(new CliError("user", `Failed to launch \`${binPath} ${config.loginArgs.join(" ")}\`: ${err.message}`));
@@ -773,6 +858,7 @@ async function setSubscriptionEnabled(apiConfig, harness, enabled) {
 async function agentSubscriptionLoginCommand(config, options, command) {
   const { config: apiConfig } = resolveBusinessContext(command, options);
   const binPath = resolveVendorBin(config, options.binPath);
+  const explicitBinPath = Boolean(options.binPath?.trim() || process.env[config.binEnvVar]?.trim());
   let tempHome;
   const handleSigint = () => {
     if (tempHome) {
@@ -788,11 +874,11 @@ async function agentSubscriptionLoginCommand(config, options, command) {
     const captureViaKeychain = process.platform === "darwin" && config.darwinKeychain !== void 0;
     let authJson;
     if (captureViaKeychain) {
-      await runVendorLogin(config, binPath, null);
+      await runVendorLoginWithInstallOffer(config, binPath, null, explicitBinPath);
       authJson = readDarwinKeychainAuthJson(config);
     } else {
       tempHome = await mkdtemp(join2(tmpdir(), `arcanist-${config.harness}-`));
-      await runVendorLogin(config, binPath, tempHome);
+      await runVendorLoginWithInstallOffer(config, binPath, tempHome, explicitBinPath);
       authJson = await readLoginAuthJson(config, tempHome);
     }
     const state = await apiFetch(
@@ -821,7 +907,7 @@ async function agentSubscriptionLoginCommand(config, options, command) {
         console.log(`Run \`arcanist ${config.harness} use on\` to start using it.`);
       }
       console.log(
-        `Note: ${config.displayName} BYOS session execution is not live yet; the credential is stored for when it ships.`
+        `${config.displayName} sessions will use your subscription auth while the selector is on; run \`arcanist ${config.harness} use off\` to switch back.`
       );
       if (captureViaKeychain) {
         console.log(
@@ -899,18 +985,21 @@ var CODEX_AGENT_RUNTIME_BACKEND = "codex";
 var CLAUDE_CODE_AGENT_RUNTIME_BACKEND = "claude_code";
 var OPENCODE_AGENT_RUNTIME_BACKEND = "opencode";
 var CURSOR_AGENT_RUNTIME_BACKEND = "cursor";
+var GROK_AGENT_RUNTIME_BACKEND = "grok";
 var AGENT_RUNTIME_BACKENDS = [
   CODEX_AGENT_RUNTIME_BACKEND,
   CLAUDE_CODE_AGENT_RUNTIME_BACKEND,
   OPENCODE_AGENT_RUNTIME_BACKEND,
-  CURSOR_AGENT_RUNTIME_BACKEND
+  CURSOR_AGENT_RUNTIME_BACKEND,
+  GROK_AGENT_RUNTIME_BACKEND
 ];
 var AGENT_RUNTIME_BACKEND_NAMES = {
   [CODEX_AGENT_RUNTIME_BACKEND]: "Codex",
   [CLAUDE_CODE_AGENT_RUNTIME_BACKEND]: "Claude Code",
   // "opencode" is intentionally lowercase to match the project's brand name.
   [OPENCODE_AGENT_RUNTIME_BACKEND]: "opencode",
-  [CURSOR_AGENT_RUNTIME_BACKEND]: "Cursor"
+  [CURSOR_AGENT_RUNTIME_BACKEND]: "Cursor",
+  [GROK_AGENT_RUNTIME_BACKEND]: "Grok Build"
 };
 function isAgentRuntimeBackend(value) {
   return AGENT_RUNTIME_BACKENDS.includes(value);
@@ -963,12 +1052,17 @@ var XaiModel = {
 var CursorModel = {
   Composer25: "composer-2.5"
 };
+var GrokBuildModel = {
+  Grok45Byos: "grok-4.5-byos",
+  GrokComposer25Fast: "grok-composer-2.5-fast"
+};
 var MODEL_PROVIDERS_SET = /* @__PURE__ */ new Set([
   "openai",
   "anthropic",
   "baseten",
   "xai",
-  "cursor"
+  "cursor",
+  "grok"
 ]);
 var BACKEND_DESKTOP_IMAGE_FEEDBACK_CONFIGS = {
   [CODEX_AGENT_RUNTIME_BACKEND]: {
@@ -1419,6 +1513,42 @@ var MODEL_REGISTRY = [
     // so none is recorded.
     costTracked: false,
     sessionStart: { eligible: true, isDefault: true }
+  },
+  {
+    id: GrokBuildModel.Grok45Byos,
+    name: "Grok 4.5 (Subscription)",
+    provider: "grok",
+    backends: [GROK_AGENT_RUNTIME_BACKEND],
+    // Wire id `grok-4.5` (the CLI's subscription default) collides with the
+    // xai/opencode registry id, so the Arcanist id is suffixed and the wire id
+    // rides providerModelId. Billed through the user's Grok subscription via
+    // the Grok Build CLI (cli-chat-proxy.grok.com); Arcanist does not meter it
+    // (costTracked: false requires pricing to stay undefined). Context window
+    // verified 2026-07-15 against https://docs.x.ai/docs/models (grok-4.5,
+    // 500k). No reasoning config: the CLI's --reasoning-effort is documented
+    // for reasoning models only and grok-4.5 is classified no-reasoning per
+    // the xai registry entries above.
+    providerModelId: "grok-4.5",
+    contextWindow: 5e5,
+    costTracked: false,
+    sessionStart: { eligible: true, isDefault: true },
+    // Internal probe (ARC-1704): hidden from the public model picker;
+    // CLI/API-selectable by internal Arcanist businesses only.
+    visibility: "internal_probe"
+  },
+  {
+    id: GrokBuildModel.GrokComposer25Fast,
+    name: "Grok Composer 2.5 Fast",
+    provider: "grok",
+    backends: [GROK_AGENT_RUNTIME_BACKEND],
+    // Cursor's Composer 2.5 Fast served through Grok Build (verified in
+    // `grok models` 0.2.101 under a live subscription, 2026-07-15). Wire id
+    // matches the registry id, so no providerModelId. Context window is not
+    // published for Composer variants (cursor.com/docs/models), so none is
+    // recorded. Subscription-billed, not metered by Arcanist.
+    costTracked: false,
+    sessionStart: { eligible: true },
+    visibility: "internal_probe"
   }
 ];
 var MODEL_PROVIDER_NAMES = {
@@ -1426,7 +1556,8 @@ var MODEL_PROVIDER_NAMES = {
   anthropic: "Anthropic",
   baseten: "Baseten",
   xai: "xAI",
-  cursor: "Cursor"
+  cursor: "Cursor",
+  grok: "Grok Build"
 };
 function buildSessionStartModelIdsByBackend() {
   const byBackend = Object.fromEntries(AGENT_RUNTIME_BACKENDS.map((backend) => [backend, []]));
@@ -1466,7 +1597,8 @@ var VALID_SESSION_START_MODEL_IDS_BY_BACKEND = {
     SESSION_START_MODEL_IDS_BY_BACKEND[CLAUDE_CODE_AGENT_RUNTIME_BACKEND]
   ),
   [OPENCODE_AGENT_RUNTIME_BACKEND]: new Set(SESSION_START_MODEL_IDS_BY_BACKEND[OPENCODE_AGENT_RUNTIME_BACKEND]),
-  [CURSOR_AGENT_RUNTIME_BACKEND]: new Set(SESSION_START_MODEL_IDS_BY_BACKEND[CURSOR_AGENT_RUNTIME_BACKEND])
+  [CURSOR_AGENT_RUNTIME_BACKEND]: new Set(SESSION_START_MODEL_IDS_BY_BACKEND[CURSOR_AGENT_RUNTIME_BACKEND]),
+  [GROK_AGENT_RUNTIME_BACKEND]: new Set(SESSION_START_MODEL_IDS_BY_BACKEND[GROK_AGENT_RUNTIME_BACKEND])
 };
 var MODEL_CONTEXT_WINDOWS = {
   ...Object.fromEntries(
@@ -1935,6 +2067,7 @@ var PHASES = [
   "review_listening",
   "completed",
   "superseded",
+  "needs_you",
   "blocked",
   "failed",
   "stopped",
@@ -1943,6 +2076,7 @@ var PHASES = [
 var TERMINAL_PHASES_ARRAY = [
   "completed",
   "superseded",
+  "needs_you",
   "blocked",
   "failed",
   "stopped",
@@ -1956,7 +2090,7 @@ var CHILD_SLOT_RELEASE_PHASES = new Set(
   TERMINAL_PHASES_ARRAY.filter((phase) => phase !== "stopped")
 );
 var ARCHIVABLE_STALE_TERMINAL_PHASES_ARRAY = TERMINAL_PHASES_ARRAY.filter(
-  (phase) => phase !== "archived" && phase !== "blocked" && phase !== "stopped"
+  (phase) => phase !== "archived" && phase !== "needs_you" && phase !== "blocked" && phase !== "stopped"
 );
 function isTerminalPhase(phase, _sessionKind) {
   return TERMINAL_PHASES.has(phase);
@@ -6101,7 +6235,9 @@ grok.command("login").description("Authenticate a Grok (xAI) subscription and st
 Runs the Grok CLI device-authorization login locally under a temporary HOME, then uploads the
 resulting auth.json to Arcanist (encrypted, per user) and activates the selector. Your workspace
 must have Grok subscription auth enabled. The credential is never written to your default ~/.grok.
-Grok BYOS session execution is not live yet; the credential is stored for when it ships.
+While the selector is on, Grok Build sessions run on your subscription auth.
+If the grok CLI is not installed, you will be offered its official install script ([y/N] prompt,
+interactive terminals only).
 
 Examples:
   arcanist grok login
@@ -6125,8 +6261,10 @@ cursor.command("login").description("Authenticate a Cursor subscription and stor
 Runs the Cursor CLI login locally under a temporary HOME/CURSOR_CONFIG_DIR, then uploads the
 captured auth credential to Arcanist (encrypted, per user) and activates the selector. Your
 workspace must have Cursor subscription auth enabled. Cursor's login-token location is not
-formally documented; if capture fails, use a Cursor API key in Settings instead. Cursor BYOS
-session execution is not live yet; the credential is stored for when it ships.
+formally documented; if capture fails, use a Cursor API key in Settings instead. While the
+selector is on, Cursor sessions run on your subscription auth instead of a Cursor API key.
+If the cursor-agent CLI is not installed, you will be offered its official install script
+([y/N] prompt, interactive terminals only).
 
 Examples:
   arcanist cursor login

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryarcanist/cli",
-  "version": "0.1.207",
+  "version": "0.1.209",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {