@lunaroute/cli 0.2.2 → 0.2.4

package/dist/index.js

@@ -4,7 +4,7 @@
 import { Command, InvalidArgumentError, Option } from "commander";
 
 // package.json
-var version = "0.2.2";
+var version = "0.2.4";
 
 // src/login.ts
 import { createServer } from "http";
@@ -359,10 +359,16 @@ function logout(profile) {
 }
 
 // src/catalog.ts
-async function fetchModels(routingUrl) {
+async function fetchModels(routingUrl, key) {
   const url = `${routingUrl}/v1/models`;
-  const res = await fetch(url, { method: "GET" });
+  const headers = key ? { Authorization: `Bearer ${key}` } : {};
+  const res = await fetch(url, { method: "GET", headers });
   if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error(
+        key ? `the routing service rejected that key (HTTP 401) \u2014 check that you copied the whole lr_ key` : `the routing service requires a key for /v1/models (HTTP 401) \u2014 run "lunaroute login" or pass --key`
+      );
+    }
     throw new Error(`failed to fetch models: HTTP ${res.status} from ${url}`);
   }
   const body = await res.json();
@@ -536,8 +542,31 @@ async function promptInput(question, opts = {}) {
   return value === "" && opts.default !== void 0 ? opts.default : value;
 }
 
-// src/commands/setup.ts
-import { spawn } from "child_process";
+// src/spawn.ts
+import { spawn as nodeSpawn } from "child_process";
+import { spawn as crossSpawn } from "cross-spawn";
+function makeRealSpawn(platform = process.platform) {
+  if (platform === "win32") {
+    return (command, args, env) => crossSpawn(command, args, { stdio: "inherit", env });
+  }
+  return (command, args, env) => nodeSpawn(command, args, { stdio: "inherit", env });
+}
+function describeSpawnError(command, installHint, err) {
+  const code = err?.code;
+  if (code === "ENOENT") {
+    return {
+      message: `Error: "${command}" not found on PATH. ${installHint} (exit 127)`,
+      exitCode: 127
+    };
+  }
+  if (code === "EINVAL") {
+    return {
+      message: `Error: "${command}" could not be launched \u2014 Node on Windows refuses to execute npm .cmd shims directly (EINVAL). The tool is likely installed; try running it manually. (exit 126)`,
+      exitCode: 126
+    };
+  }
+  return { message: err instanceof Error ? err.message : String(err), exitCode: 1 };
+}
 
 // src/setup/paths.ts
 import { execSync } from "child_process";
@@ -885,7 +914,7 @@ var ADAPTERS = {
 var PI_INSTALL_PACKAGES = ["npm:@lunaroute/pi-extension", "npm:pi-mcp-adapter"];
 async function runSetup(harness, opts, deps = {
   confirm,
-  spawn: (command, args) => spawn(command, args, { stdio: "inherit" }),
+  spawn: makeRealSpawn(),
   runLogin
 }) {
   if (harness === "pi" && opts.extension && opts.models) {
@@ -899,8 +928,25 @@ async function runSetup(harness, opts, deps = {
     );
     return 1;
   }
-  const stored = loadProfile(opts.profile);
+  let stored = loadProfile(opts.profile);
   const settings = resolveSettings(opts.profile);
+  if (opts.key) {
+    if (!LR_KEY_RE.test(opts.key)) {
+      console.error(
+        "Invalid key: a LunaRoute routing key starts with lr_ (copy the whole key from the dashboard)."
+      );
+      return 1;
+    }
+    saveProfile(opts.profile, {
+      api_url: settings.api_url,
+      routing_url: opts.routingUrl || settings.routing_url,
+      front_url: settings.front_url,
+      org_id: stored?.org_id ?? "",
+      user_email: stored?.user_email ?? "",
+      routing_key: opts.key
+    });
+    stored = loadProfile(opts.profile);
+  }
   const routingUrlRaw = opts.routingUrl || stored?.routing_url || settings.routing_url;
   if (!routingUrlRaw) {
     console.error("No routing URL in profile; pass --routing-url.");
@@ -926,10 +972,12 @@ async function runSetup(harness, opts, deps = {
   }
   let models;
   try {
-    models = await fetchModels(routingUrl);
+    models = await fetchModels(routingUrl, creds.routing_key);
   } catch (err) {
-    console.error(`Could not fetch the model catalog: ${err instanceof Error ? err.message : err}`);
-    return 1;
+    console.error(
+      `Could not fetch the model catalog (${err instanceof Error ? err.message : err}) \u2014 continuing; model ids show as <model> until it answers.`
+    );
+    models = [];
   }
   const ctx = {
     routingUrl,
@@ -958,6 +1006,7 @@ Wrote: ${summary.written.join(", ")}`);
   }
 }
 var NOT_LOGGED_IN = 'Not logged in. Run "lunaroute login" first.';
+var LR_KEY_RE = /^lr_[A-Za-z0-9_-]{8,128}$/;
 var OPENCODE_LOGIN_HINT = "Or re-run and choose the extension \u2014 it logs in via /connect inside opencode.";
 var PI_LOGIN_HINT = "Or re-run and choose the extension \u2014 login happens via /login lunaroute inside pi.";
 async function requireCreds(opts, deps, stored, hint) {
@@ -991,6 +1040,38 @@ async function requireCreds(opts, deps, stored, hint) {
 }
 async function runPiSetup(opts, stored, routingUrl, deps) {
   try {
+    if (opts.key) {
+      const creds2 = await requireCreds(opts, deps, stored);
+      if (!creds2) return 1;
+      let models = [];
+      let modelsSynced = true;
+      try {
+        models = await fetchModels(routingUrl, creds2.routing_key);
+      } catch (err) {
+        modelsSynced = false;
+        console.warn(
+          `Note: ${err instanceof Error ? err.message : err}`
+        );
+        console.warn(
+          "Writing the provider block with no models. Your organization has no models enabled yet \u2014 contact hello@lunaroute.com to get them turned on, then re-run this command to sync them."
+        );
+      }
+      const plan = buildPlan2({
+        routingUrl,
+        orgId: creds2.org_id,
+        models,
+        keyEnvVar: "LUNAROUTE_API_KEY"
+      });
+      const write = await deps.confirm(
+        "Merge LunaRoute provider into ~/.pi/agent/models.json (backup kept, other providers preserved)?",
+        { yes: opts.yes }
+      );
+      const code = await applyAndReport(plan, creds2.routing_key, write);
+      if (code === 0 && modelsSynced) {
+        console.log("\nDone. Start pi \u2014 it is signed in. Pick a model with /model.");
+      }
+      return code;
+    }
     if (opts.extension) {
       const ok = await deps.confirm(
         "Install the LunaRoute Pi extension + MCP adapter via 'pi install'?",
@@ -1075,23 +1156,20 @@ function hermesConfigSetArgs(routingUrl, key) {
     ["config", "set", "LUNAROUTE_API_KEY", key]
   ];
 }
-async function runHermesConfigSets(spawn3, routingUrl, key) {
+async function runHermesConfigSets(spawn, routingUrl, key) {
   const commands = hermesConfigSetArgs(routingUrl, key);
   const setKeys = commands.map((c) => c[2]);
   for (let i = 0; i < commands.length; i++) {
     const code = await new Promise((resolve) => {
-      const child = spawn3("hermes", commands[i]);
+      const child = spawn("hermes", commands[i]);
       child.on("error", (err) => {
-        const e = err;
-        if (e?.code === "ENOENT") {
-          console.error(
-            `Error: "hermes" not found on PATH. Install Hermes Agent first: https://hermes-agent.nousresearch.com (exit 127)`
-          );
-          resolve(127);
-          return;
-        }
-        console.error(err instanceof Error ? err.message : String(err));
-        resolve(1);
+        const { message, exitCode } = describeSpawnError(
+          "hermes",
+          "Install Hermes Agent first: https://hermes-agent.nousresearch.com",
+          err
+        );
+        console.error(message);
+        resolve(exitCode);
       });
       child.on("exit", (code2) => {
         resolve(typeof code2 === "number" ? code2 : 1);
@@ -1158,7 +1236,7 @@ async function runOpencodeSetup(stored, settings, routingUrl, opts, deps) {
 async function applyOpencodeProvider(creds, routingUrl, write) {
   let models;
   try {
-    models = await fetchModels(routingUrl);
+    models = await fetchModels(routingUrl, creds.routing_key);
   } catch (err) {
     console.error(`Could not fetch the model catalog: ${err instanceof Error ? err.message : err}`);
     return 1;
@@ -1185,18 +1263,17 @@ Wrote: ${summary.written.join(", ")}`);
     return 1;
   }
 }
-async function launchOpencode(spawn3) {
+async function launchOpencode(spawn) {
   return new Promise((resolve) => {
-    const child = spawn3("opencode", []);
+    const child = spawn("opencode", []);
     child.on("error", (err) => {
-      const e = err;
-      if (e?.code === "ENOENT") {
-        console.error(`Error: "opencode" not found on PATH. Install OpenCode first: https://opencode.ai (exit 127)`);
-        resolve(127);
-        return;
-      }
-      console.error(err instanceof Error ? err.message : String(err));
-      resolve(1);
+      const { message, exitCode } = describeSpawnError(
+        "opencode",
+        "Install OpenCode first: https://opencode.ai",
+        err
+      );
+      console.error(message);
+      resolve(exitCode);
     });
     child.on("exit", (code) => {
       resolve(typeof code === "number" ? code : 1);
@@ -1208,14 +1285,13 @@ async function installPiExtension(deps, opts) {
     const code = await new Promise((resolve) => {
       const child = deps.spawn("pi", ["install", pkg]);
       child.on("error", (err) => {
-        const e = err;
-        if (e?.code === "ENOENT") {
-          console.error(`Error: "pi" not found on PATH. Install pi first: https://pi.dev (exit 127)`);
-          resolve(127);
-          return;
-        }
-        console.error(err instanceof Error ? err.message : String(err));
-        resolve(1);
+        const { message, exitCode } = describeSpawnError(
+          "pi",
+          "Install pi first: https://pi.dev",
+          err
+        );
+        console.error(message);
+        resolve(exitCode);
       });
       child.on("exit", (code2) => {
         resolve(typeof code2 === "number" ? code2 : 1);
@@ -1237,18 +1313,17 @@ async function installPiExtension(deps, opts) {
   console.log("  2. /model \u2014 pick a lunaroute/* model (models auto-sync from /v1/models).");
   return 0;
 }
-async function launchPi(spawn3) {
+async function launchPi(spawn) {
   return new Promise((resolve) => {
-    const child = spawn3("pi", []);
+    const child = spawn("pi", []);
     child.on("error", (err) => {
-      const e = err;
-      if (e?.code === "ENOENT") {
-        console.error(`Error: "pi" not found on PATH. Install pi first: https://pi.dev (exit 127)`);
-        resolve(127);
-        return;
-      }
-      console.error(err instanceof Error ? err.message : String(err));
-      resolve(1);
+      const { message, exitCode } = describeSpawnError(
+        "pi",
+        "Install pi first: https://pi.dev",
+        err
+      );
+      console.error(message);
+      resolve(exitCode);
     });
     child.on("exit", (code) => {
       resolve(typeof code === "number" ? code : 1);
@@ -1258,7 +1333,7 @@ async function launchPi(spawn3) {
 async function applyPiModels(creds, routingUrl, write) {
   let models;
   try {
-    models = await fetchModels(routingUrl);
+    models = await fetchModels(routingUrl, creds.routing_key);
   } catch (err) {
     console.error(`Could not fetch the model catalog: ${err instanceof Error ? err.message : err}`);
     return 1;
@@ -1299,6 +1374,8 @@ async function runModels(profile, opts) {
   }
   if (opts.json) {
     console.log(JSON.stringify(ids, null, 2));
+  } else if (ids.length === 0) {
+    console.log("// no models enabled for your org yet \u2014 contact hello@lunaroute.com to get models enabled");
   } else {
     for (const id of ids) console.log(id);
   }
@@ -1333,6 +1410,10 @@ async function runPricing(profile, opts) {
     console.log(JSON.stringify(rows, null, 2));
     return 0;
   }
+  if (rows.length === 0) {
+    console.log("// no models enabled for your org yet \u2014 contact hello@lunaroute.com to get models enabled");
+    return 0;
+  }
   const cell = (n) => n === void 0 ? "\u2014" : String(n);
   const table = renderTable(
     ["MODEL", "INPUT (cr/M)", "OUTPUT (cr/M)", "CACHED (cr/M)"],
@@ -1367,6 +1448,9 @@ async function runUsage(profile, opts) {
   console.log(
     `Wallet: available ${w.available_credits}  (balance ${w.balance_credits}, reserved ${w.reserved_credits})`
   );
+  if (w.available_credits === 0) {
+    console.log("// wallet is empty \u2014 add credits in the dashboard \u2192 Billing");
+  }
   console.log("");
   const table = renderTable(
     ["TIME", "MODEL", "IN", "OUT", "CACHED", "\u0394CREDITS", "BALANCE"],
@@ -1791,9 +1875,6 @@ async function runSkillInstall(profile, opts) {
   return 0;
 }
 
-// src/commands/run.ts
-import { spawn as spawn2 } from "child_process";
-
 // src/run/adapters/claudeCode.ts
 function buildRunSpec(ctx) {
   return {
@@ -1840,7 +1921,7 @@ var INSTALL_HINT = {
   codex: "Install Codex: https://github.com/openai/codex#install"
 };
 var realDeps = {
-  spawn: (command, args, env) => spawn2(command, args, { env, stdio: "inherit" }),
+  spawn: makeRealSpawn(),
   fetchModels
 };
 async function runRun(harness, opts, deps = realDeps) {
@@ -1858,7 +1939,7 @@ async function runRun(harness, opts, deps = realDeps) {
   if (!model) {
     let models;
     try {
-      models = await deps.fetchModels(creds.routing_url);
+      models = await deps.fetchModels(creds.routing_url, creds.routing_key);
     } catch (err) {
       console.error(`Could not fetch the model catalog: ${err instanceof Error ? err.message : err}`);
       return 1;
@@ -1880,16 +1961,9 @@ async function runRun(harness, opts, deps = realDeps) {
   const child = deps.spawn(spec.command, args, env);
   return new Promise((resolve) => {
     child.on("error", (err) => {
-      const e = err;
-      if (e?.code === "ENOENT") {
-        console.error(
-          `Error: "${spec.command}" not found on PATH. ${INSTALL_HINT[harness]} (exit 127)`
-        );
-        resolve(127);
-        return;
-      }
-      console.error(err instanceof Error ? err.message : String(err));
-      resolve(1);
+      const { message, exitCode } = describeSpawnError(spec.command, INSTALL_HINT[harness], err);
+      console.error(message);
+      resolve(exitCode);
     });
     child.on("exit", (code) => {
       resolve(typeof code === "number" ? code : 1);
@@ -1898,6 +1972,14 @@ async function runRun(harness, opts, deps = realDeps) {
 }
 
 // src/index.ts
+var MIN_NODE_MAJOR = 20;
+var nodeMajor = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+if (nodeMajor < MIN_NODE_MAJOR) {
+  console.error(
+    `LunaRoute CLI requires Node.js ${MIN_NODE_MAJOR}+ \u2014 you're running ${process.versions.node}. Upgrade from https://nodejs.org/en/download and try again.`
+  );
+  process.exit(1);
+}
 var program = new Command();
 program.name("lunaroute").description("LunaRoute CLI \u2014 configure coding harnesses and manage your account.").version(version).option("-p, --profile <name>", "credential profile to use", "default");
 program.command("login").description("Authorize this device via the browser and store a routing key.").action(async () => {
@@ -1909,14 +1991,15 @@ program.command("whoami").description("Show the signed-in user and organization.
 program.command("logout").description("Remove stored credentials for the active profile.").action(() => {
   logout(program.opts().profile);
 });
-program.command("setup <harness>").description("Configure a coding harness (opencode | pi | hermes | claude-code | copilot-cli | openclaw | generic).").option("--print", "print the config instead of writing files", false).option("--routing-url <url>", "override the routing base URL").option("--yes", "accept all confirmation prompts without a TTY (for scripts)", false).option("--extension", "pi only: jump straight to installing the Pi extension + MCP adapter").option("--models", "pi only: jump straight to writing the models.json provider block").action(async (harness, opts) => {
+program.command("setup <harness>").description("Configure a coding harness (opencode | pi | hermes | claude-code | copilot-cli | openclaw | generic).").option("--print", "print the config instead of writing files", false).option("--routing-url <url>", "override the routing base URL").option("--yes", "accept all confirmation prompts without a TTY (for scripts)", false).option("--extension", "pi only: jump straight to installing the Pi extension + MCP adapter").option("--models", "pi only: jump straight to writing the models.json provider block").option("--key <key>", "a LunaRoute routing key (lr_\u2026), e.g. from the dashboard's onboarding page \u2014 stores it and skips the browser login").action(async (harness, opts) => {
   const code = await runSetup(harness, {
     profile: program.opts().profile,
     print: opts.print,
     routingUrl: opts.routingUrl,
     yes: opts.yes,
     extension: opts.extension,
-    models: opts.models
+    models: opts.models,
+    key: opts.key
   });
   if (code !== 0) process.exit(code);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunaroute/cli",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "LunaRoute CLI — configure coding harnesses and manage your LunaRoute account.",
   "repository": {
     "type": "git",
@@ -30,10 +30,12 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "commander": "^15.0.0",
+    "cross-spawn": "^7.0.6",
     "open": "^11.0.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
     "@types/node": "^26.2.0",
     "tsup": "^8.3.0",
     "tsx": "^4.23.12",