@beeos-ai/cli 1.0.9 → 1.0.11

package/dist/index.js

@@ -119,11 +119,26 @@ async function loadOrCreateConfig() {
     const raw = await p.readFile(path10);
     const parsed = TOML.parse(raw);
     const cfg2 = mergeWithDefaults(parsed);
-    return cfg2;
+    return applyEnvOverrides(cfg2);
   }
   const cfg = defaultConfig();
   await saveConfig(cfg);
-  return cfg;
+  return applyEnvOverrides(cfg);
+}
+function applyEnvOverrides(cfg) {
+  const env = globalThis.process?.env ?? {};
+  const apiUrl = env.BEEOS_API_URL?.trim();
+  const agwUrl = env.BEEOS_AGENT_GATEWAY_URL?.trim();
+  const dashUrl = env.BEEOS_DASHBOARD_URL?.trim();
+  return {
+    ...cfg,
+    platform: {
+      ...cfg.platform,
+      ...apiUrl ? { api_url: apiUrl } : {},
+      ...agwUrl ? { agent_gateway_url: agwUrl } : {},
+      ...dashUrl ? { dashboard_base_url: dashUrl } : {}
+    }
+  };
 }
 async function saveConfig(cfg) {
   const p = getPlatformAdapter();
@@ -4320,6 +4335,8 @@ var init_state = __esm({
 });
 
 // src/commands/device/attach.ts
+import { spawn as spawn2 } from "child_process";
+import readline from "readline";
 async function attach(options) {
   const cfg = await loadOrCreateConfig();
   const reporter = new CliReporter();
@@ -4403,7 +4420,7 @@ async function attach(options) {
       throw e;
     }
   });
-  await maybeNotifyFleetWithHint();
+  await maybeNotifyFleetWithHint(cfg);
 }
 async function attachAll(cfg, reporter, withVideo, options) {
   const devices = await deviceRuntime.listAdbDevices();
@@ -4478,7 +4495,7 @@ async function attachAll(cfg, reporter, withVideo, options) {
     await saveDeviceState(state);
     console.log(`Attached ${committed.length} device(s); supervision via device-agent fleet.`);
   });
-  await maybeNotifyFleetWithHint();
+  await maybeNotifyFleetWithHint(cfg);
 }
 function commitAttachResults(state, commits) {
   const committed = [];
@@ -4572,9 +4589,70 @@ async function installService(mgr, spec) {
   maybePrintFallbackBanner(mgr.kind);
   await mgr.install(spec);
 }
-async function maybeNotifyFleetWithHint() {
+async function maybeNotifyFleetWithHint(cfg) {
   const outcome = await notifyFleetReloadBestEffort();
-  if (outcome === "not_running") printFleetNotRunningHint();
+  if (outcome !== "not_running") return;
+  if (!shouldOfferFleetEnable()) {
+    printFleetNotRunningHint();
+    return;
+  }
+  console.log("");
+  console.log("device-agent fleet is not running yet. Until you start");
+  console.log("it, the device is recorded in ~/.beeos/devices.json but");
+  console.log("no process is supervising the per-device agent.");
+  console.log("");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await new Promise((resolve) => {
+    rl.question("Enable fleet now (registers a launchd service)? [Y/n]: ", (a) => {
+      rl.close();
+      resolve(a);
+    });
+  });
+  const yes = answer.trim() === "" || /^y(es)?$/i.test(answer.trim());
+  if (!yes) {
+    printFleetNotRunningHint();
+    return;
+  }
+  const ok = await runDeviceAgentFleetEnable(cfg);
+  if (!ok) {
+    console.error("");
+    console.error("fleet enable did not complete cleanly. Re-run manually:");
+    console.error("  device-agent fleet enable --agent-gateway-url <URL>");
+    console.error("");
+    printFleetNotRunningHint();
+    return;
+  }
+  console.log("");
+  console.log("fleet enabled \u2014 supervised processes should come up within a few seconds.");
+  console.log("Check status with:  device-agent fleet devices");
+}
+function shouldOfferFleetEnable(inputs = {
+  platform: process.platform,
+  stdinIsTTY: process.stdin.isTTY,
+  stdoutIsTTY: process.stdout.isTTY,
+  env: process.env
+}) {
+  if (inputs.platform !== "darwin") return false;
+  if (inputs.env.BEEOS_NO_FLEET_AUTOSTART === "1") return false;
+  if (!inputs.stdinIsTTY) return false;
+  if (!inputs.stdoutIsTTY) return false;
+  return true;
+}
+async function runDeviceAgentFleetEnable(cfg) {
+  const agentGatewayUrl = resolveAgentGatewayUrl(cfg);
+  return new Promise((resolve) => {
+    try {
+      const child = spawn2(
+        "device-agent",
+        ["fleet", "enable", "--agent-gateway-url", agentGatewayUrl],
+        { stdio: "inherit" }
+      );
+      child.once("close", (code) => resolve(code === 0));
+      child.once("error", () => resolve(false));
+    } catch {
+      resolve(false);
+    }
+  });
 }
 async function registerVideoBridge(_mgr, reporter, params) {
   if (!params.withVideo) return { mode: "none" };
@@ -5373,7 +5451,7 @@ init_device2();
 
 // src/commands/init.ts
 init_dist();
-import readline from "readline";
+import readline2 from "readline";
 
 // src/commands/doctor.ts
 init_dist();
@@ -5818,7 +5896,7 @@ function printNextSteps() {
   console.log("");
 }
 function prompt(question) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
     rl.question(question, (answer) => {
       rl.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeos-ai/cli",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "type": "module",
   "description": "BeeOS CLI — run AI agents from your desktop",
   "bin": {

package/scripts/install.ps1

@@ -9,6 +9,31 @@
     `-Device` is passed. Heavier deps (Python, uv, adb, scrcpy/vnc bridges)
     are installed lazily by the CLI itself.
 
+    Staging / dev-loop env vars (CLI >= 1.0.10). All four are inherited by
+    the spawned `beeos init` / `beeos device attach` child via the normal
+    process env passthrough — no extra Set-Item / -PassThru is needed. CLI
+    >= 1.0.10 reads them via the loadOrCreateConfig env-overrides layer;
+    older CLIs only honor BEEOS_API_URL (telemetry) +
+    BEEOS_AGENT_GATEWAY_URL (runtime).
+
+      $env:BEEOS_API_URL              Public API base; both this script
+                                       (telemetry) and the CLI runtime use
+                                       this.
+      $env:BEEOS_AGENT_GATEWAY_URL    Agent Gateway base (Ed25519-signed
+                                       bootstrap requests).
+      $env:BEEOS_DASHBOARD_URL        Dashboard base (OAuth + bind redirect).
+      $env:BEEOS_DEVICE_AGENT_VERSION Pin @beeos-ai/device-agent semver.
+      $env:BEEOS_MCP_SERVER_VERSION   Pin @beeos-ai/device-mcp-server semver.
+      $env:BEEOS_USE_NPX = "1"        Power-user escape hatch: use `npx`
+                                       for a throwaway install. `beeos`
+                                       will NOT persist on PATH after
+                                       the script exits. Default
+                                       behaviour (since CLI 1.0.11) is
+                                       always `npm install -g` so the
+                                       CLI plus the device-agent suite
+                                       are both globally available for
+                                       follow-up commands.
+
 .EXAMPLE
     # One-liner (PowerShell 5+):
     irm https://beeos.ai/install.ps1 | iex
@@ -20,6 +45,15 @@
 .EXAMPLE
     # Jump straight into device attach instead of init:
     .\install.ps1 -Device
+
+.EXAMPLE
+    # Bare-metal one-shot staging install (CLI >= 1.0.11):
+    $env:BEEOS_API_URL              = "https://public-api-staging.beeos.ai"
+    $env:BEEOS_AGENT_GATEWAY_URL    = "https://agent-gw-staging.beeos.ai"
+    $env:BEEOS_DASHBOARD_URL        = "https://beeos-staging-web.vercel.app"
+    $env:BEEOS_DEVICE_AGENT_VERSION = "0.4.2"
+    $env:BEEOS_MCP_SERVER_VERSION   = "0.2.3"
+    irm https://beeos.ai/install.ps1 | iex
 #>
 param(
     [string]$Version = "latest",
@@ -308,32 +342,41 @@ function Invoke-BeeosCli {
         [string[]]$ExtraArgs
     )
 
-    $npxPath = Get-Command npx -ErrorAction SilentlyContinue
     $args = @($Subcommand)
     if ($ExtraArgs) { $args += $ExtraArgs }
 
-    if ($npxPath) {
-        # Temporary / npx path: deliberately do NOT install the device-agent
-        # suite globally. The user opted into the throwaway-install flow, so
-        # we honor that — if they later run `beeos device attach`,
-        # ensureDeviceAgent will guide them through a global install at that
-        # point.
+    # ALWAYS install globally. Pre-1.0.11 we branched into `npx --yes`
+    # when available, which gave irm|iex users a throwaway install but
+    # silently broke their next step (`beeos device attach`) because
+    # `beeos` was not on PATH after the script exited. Power users who
+    # explicitly want the old throwaway behaviour can set
+    # `$env:BEEOS_USE_NPX = "1"`.
+    $npxPath = Get-Command npx -ErrorAction SilentlyContinue
+    if ($env:BEEOS_USE_NPX -eq "1" -and $npxPath) {
+        Write-BeeWarn "BEEOS_USE_NPX=1 — using throwaway npx install (beeos won't persist on PATH)."
         & npx --yes $CliPackage @args
-    } else {
-        Write-BeeWarn "npx not found, installing globally..."
-        & npm install -g $CliPackage
-        if ($LASTEXITCODE -ne 0) {
-            Write-BeeError "npm install -g $CliPackage failed."
-            Write-BeeError ""
-            Write-BeeError "Common fixes:"
-            Write-BeeError "  - EEXIST on beeos from another package:"
-            Write-BeeError "      npm uninstall -g beeos    # then re-run installer"
-            Write-BeeError "  - EACCES / permission error: run PowerShell as Administrator"
-            exit 1
-        }
-        Install-DeviceAgentSuite
-        & beeos @args
+        return
+    }
+
+    $npmPath = Get-Command npm -ErrorAction SilentlyContinue
+    if (-not $npmPath) {
+        Write-BeeError "npm not found — install Node.js first (this script tries that for you)."
+        exit 1
+    }
+
+    Write-BeeInfo "Installing $CliPackage globally..."
+    & npm install -g $CliPackage
+    if ($LASTEXITCODE -ne 0) {
+        Write-BeeError "npm install -g $CliPackage failed."
+        Write-BeeError ""
+        Write-BeeError "Common fixes:"
+        Write-BeeError "  - EEXIST on beeos from another package:"
+        Write-BeeError "      npm uninstall -g beeos    # then re-run installer"
+        Write-BeeError "  - EACCES / permission error: run PowerShell as Administrator"
+        exit 1
     }
+    Install-DeviceAgentSuite
+    & beeos @args
 }
 
 # ── Main ─────────────────────────────────────────────────────

package/scripts/install.sh

@@ -15,6 +15,38 @@
 #      upgrade / rebind / skip before re-running the bind flow.
 #   4. Dispatch into `beeos init` (default) or `beeos device attach` when
 #      `--device` is passed.
+#
+# ── Staging / dev-loop env vars (CLI ≥ 1.0.10) ──────────────────────
+# All four are inherited by the spawned `beeos init` / `beeos device
+# attach` child via the normal `exec` env passthrough — there is no
+# extra `export` needed. CLI ≥ 1.0.10 reads them via the `loadOrCreate
+# Config` env-overrides layer; older CLIs only honor BEEOS_API_URL
+# (telemetry) + BEEOS_AGENT_GATEWAY_URL (runtime).
+#
+#   BEEOS_API_URL              Public API base; both the script (telemetry)
+#                              and the CLI runtime use this.
+#   BEEOS_AGENT_GATEWAY_URL    Agent Gateway base (Ed25519-signed
+#                              bootstrap requests).
+#   BEEOS_DASHBOARD_URL        Dashboard base (OAuth + bind redirect).
+#   BEEOS_DEVICE_AGENT_VERSION Pin @beeos-ai/device-agent semver.
+#   BEEOS_MCP_SERVER_VERSION   Pin @beeos-ai/device-mcp-server semver.
+#   BEEOS_USE_NPX=1            (Power-user escape hatch) Use `npx` for a
+#                              throwaway install. `beeos` will NOT
+#                              persist on PATH after the script exits.
+#                              Default behaviour (since CLI 1.0.11) is
+#                              always `npm install -g` so the CLI plus
+#                              the device-agent suite are both globally
+#                              available for follow-up commands.
+#
+# Example: bare-metal one-shot staging install, including device-agent
+# version pin and OAuth landing on the staging dashboard:
+#
+#   BEEOS_API_URL=https://public-api-staging.beeos.ai \
+#   BEEOS_AGENT_GATEWAY_URL=https://agent-gw-staging.beeos.ai \
+#   BEEOS_DASHBOARD_URL=https://beeos-staging-web.vercel.app \
+#   BEEOS_DEVICE_AGENT_VERSION=0.4.2 \
+#   BEEOS_MCP_SERVER_VERSION=0.2.3 \
+#     curl -fsSL https://beeos.ai/install | bash -s -- --version 1.0.11
 
 set -euo pipefail
 
@@ -470,28 +502,44 @@ run_cli() {
     stdin_src="/dev/tty"
   fi
 
-  if command -v npx &>/dev/null; then
-    # Temporary / npx path: deliberately do NOT install the device-agent
-    # suite globally. The user opted into the throwaway-install flow, so
-    # we honor that — if they later run `beeos device attach`,
-    # ensureDeviceAgent will guide them through a global install at that
-    # point.
+  # ALWAYS install globally. We previously branched to `npx --yes` when
+  # available so curl|bash users got a throwaway install, but that
+  # silently broke the post-install UX:
+  #   - `beeos` was not on PATH after the script exited, so the user's
+  #     next step (`beeos device attach`) failed with `command not found`
+  #     and the obvious recovery (re-run the one-liner) hit the
+  #     "existing install" prompt because some state in ~/.beeos
+  #     persisted, leaving the user stuck.
+  #   - The device-agent suite was deliberately skipped on the npx
+  #     branch, so even if the user re-ran via `npm i -g`, the very
+  #     next `beeos device attach` had to bootstrap device-agent
+  #     itself.
+  # Power users who explicitly want the old throwaway behaviour can set
+  # `BEEOS_USE_NPX=1`. Default is global install.
+  if [[ "${BEEOS_USE_NPX:-}" == "1" ]] && command -v npx &>/dev/null; then
+    warn "BEEOS_USE_NPX=1 — using throwaway npx install (beeos won't persist on PATH)."
     exec npx --yes "$CLI_PACKAGE" "$subcmd" "$@" <"$stdin_src"
-  else
-    warn "npx not found, installing globally..."
-    if ! npm install -g "$CLI_PACKAGE"; then
-      error "npm install -g ${CLI_PACKAGE} failed."
-      error ""
-      error "Common fixes:"
-      error "  - EEXIST on /bin/beeos from another package:"
-      error "      npm uninstall -g beeos    # then re-run installer"
-      error "  - EACCES permission error:"
-      error "      use a node version manager (nvm / fnm) or sudo"
-      exit 1
-    fi
-    install_device_agent_suite
-    exec beeos "$subcmd" "$@" <"$stdin_src"
   fi
+
+  if ! command -v npm &>/dev/null; then
+    error "npm not found — install Node.js first (this script tries that for you;"
+    error "see ${BEEOS_INSTALL_LOG} for why auto-install bailed out)."
+    exit 1
+  fi
+
+  info "Installing ${CLI_PACKAGE} globally..."
+  if ! npm install -g "$CLI_PACKAGE"; then
+    error "npm install -g ${CLI_PACKAGE} failed."
+    error ""
+    error "Common fixes:"
+    error "  - EEXIST on /bin/beeos from another package:"
+    error "      npm uninstall -g beeos    # then re-run installer"
+    error "  - EACCES permission error:"
+    error "      use a node version manager (nvm / fnm) or sudo"
+    exit 1
+  fi
+  install_device_agent_suite
+  exec beeos "$subcmd" "$@" <"$stdin_src"
 }
 
 main() {