@lunaroute/cli 0.2.0 → 0.2.1

package/dist/index.js

@@ -3,6 +3,9 @@
 // src/index.ts
 import { Command, InvalidArgumentError, Option } from "commander";
 
+// package.json
+var version = "0.2.1";
+
 // src/login.ts
 import { createServer } from "http";
 import { hostname } from "os";
@@ -588,21 +591,24 @@ function buildPlan3(ctx) {
       { name: ctx.keyEnvVar, value: "__KEY__" },
       // Point at the routing root; Claude Code appends /v1/messages itself.
       { name: "ANTHROPIC_BASE_URL", value: ctx.routingUrl },
-      // Claude Code sends ANTHROPIC_API_KEY as the native x-api-key header. The
-      // routing edge recognizes the lr_ prefix, authenticates it, and strips the
-      // header before forwarding upstream — so the key never leaks and never
-      // sits in the URL path.
-      { name: "ANTHROPIC_API_KEY", value: `$${ctx.keyEnvVar}` },
+      // Claude Code sends ANTHROPIC_AUTH_TOKEN as `Authorization: Bearer`. The
+      // routing edge recognizes the lr_ prefix, authenticates it, and strips
+      // the header before forwarding upstream — so the key never leaks and
+      // never sits in the URL path. Bearer also outranks a stored claude.ai
+      // subscription OAuth login; ANTHROPIC_API_KEY does not (unapproved env
+      // keys are ignored and the OAuth token 401s through the gateway, kata
+      // 009h).
+      { name: "ANTHROPIC_AUTH_TOKEN", value: `$${ctx.keyEnvVar}` },
       { name: "ANTHROPIC_MODEL", value: firstModel }
     ],
     notes: [
       "\nClaude Code: add the exports above to your shell profile, then restart Claude Code.",
       `Change ANTHROPIC_MODEL to any of: ${ctx.models.map((m) => m.id).join(", ")}`,
-      "(Auth travels in the native x-api-key header via ANTHROPIC_API_KEY.)",
-      "If your Claude Code build requires a bearer token instead, set ANTHROPIC_AUTH_TOKEN=$LUNAROUTE_API_KEY \u2014 LunaRoute also authenticates lr_ keys sent as Authorization: Bearer.",
+      "(Auth travels in the Authorization: Bearer header via ANTHROPIC_AUTH_TOKEN.)",
+      "If your Claude Code build predates ANTHROPIC_AUTH_TOKEN support, set ANTHROPIC_API_KEY=$LUNAROUTE_API_KEY instead \u2014 LunaRoute also authenticates lr_ keys sent as x-api-key. Bearer wins whenever both are set.",
       "To set these in ~/.claude/settings.json instead, note its env values are literal \u2014 the key would be baked into the file rather than read from $LUNAROUTE_API_KEY.",
       "If Claude Code hangs or keeps retrying when connecting, your key is likely wrong \u2014 it retries auth errors silently. Debug with the curl below, which fails fast with the real error:",
-      `  curl ${ctx.routingUrl}/v1/messages -H "x-api-key: $${ctx.keyEnvVar}" -H "content-type: application/json" -d '{"model":"${firstModel}","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'`
+      `  curl ${ctx.routingUrl}/v1/messages -H "Authorization: Bearer $${ctx.keyEnvVar}" -H "content-type: application/json" -d '{"model":"${firstModel}","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'`
     ]
   };
 }
@@ -751,8 +757,10 @@ async function runSetup(harness, opts, deps = {
     return 1;
   }
   const adapter = ADAPTERS[harness];
-  if (!adapter) {
-    console.error(`Unknown harness "${harness}". Choose one of: ${Object.keys(ADAPTERS).join(", ")}.`);
+  if (!adapter && harness !== "hermes") {
+    console.error(
+      `Unknown harness "${harness}". Choose one of: ${[...Object.keys(ADAPTERS), "hermes"].join(", ")}.`
+    );
     return 1;
   }
   const creds = loadProfile(opts.profile);
@@ -778,6 +786,9 @@ async function runSetup(harness, opts, deps = {
   if (harness === "opencode") {
     return runOpencodeSetup(creds, routingUrl, opts, deps);
   }
+  if (harness === "hermes") {
+    return runHermesSetup(creds, routingUrl, opts, deps);
+  }
   let models;
   try {
     models = await fetchModels(routingUrl);
@@ -851,6 +862,78 @@ async function runPiSetup(opts, deps) {
     return 1;
   }
 }
+async function runHermesSetup(creds, routingUrl, opts, deps) {
+  const commands = hermesConfigSetArgs(routingUrl, creds.routing_key);
+  try {
+    if (opts.print) {
+      console.log("\n# would run:");
+      for (const args of commands) console.log(`  hermes ${args.join(" ")}`);
+      console.log(
+        "\nThen start hermes and run /model custom:lunaroute:<model> to pick a LunaRoute model (models auto-discover from /v1/models)."
+      );
+      return 0;
+    }
+    if (await deps.confirm("Configure LunaRoute for Hermes via 'hermes config set'? (recommended \u2014 models auto-discover)", {
+      yes: opts.yes
+    })) {
+      return runHermesConfigSets(deps.spawn, routingUrl, creds.routing_key);
+    }
+    console.log("Skipped. Re-run with --yes, or configure manually:");
+    for (const args of commands) console.log(`  hermes ${args.join(" ")}`);
+    console.log("\nThen start hermes and run /model custom:lunaroute:<model> to pick a LunaRoute model.");
+    return 0;
+  } catch (err) {
+    if (err instanceof NonInteractiveTerminalError) {
+      console.error("No interactive terminal available. Re-run with --yes to accept prompts, or --print to preview.");
+      return 1;
+    }
+    console.error(err instanceof Error ? err.message : String(err));
+    return 1;
+  }
+}
+function hermesConfigSetArgs(routingUrl, key) {
+  return [
+    ["config", "set", "providers.lunaroute.api", `${routingUrl}/v1`],
+    ["config", "set", "providers.lunaroute.key_env", "LUNAROUTE_API_KEY"],
+    ["config", "set", "providers.lunaroute.transport", "chat_completions"],
+    ["config", "set", "LUNAROUTE_API_KEY", key]
+  ];
+}
+async function runHermesConfigSets(spawn3, 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]);
+      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);
+      });
+      child.on("exit", (code2) => {
+        resolve(typeof code2 === "number" ? code2 : 1);
+      });
+    });
+    if (code !== 0) {
+      const done = setKeys.slice(0, i);
+      console.error(
+        `'hermes config set ${setKeys[i]}' failed (exit ${code}). Set so far: ${done.length ? done.join(", ") : "nothing"}. Re-run 'lunaroute setup hermes' to retry (all steps are idempotent).`
+      );
+      return code || 1;
+    }
+  }
+  console.log("\nConfigured. Start hermes (or restart it if already running), then:");
+  console.log("  /model custom:lunaroute:<model>   # switch to a LunaRoute model (models auto-discover from /v1/models)");
+  console.log("  hermes model                      # interactive provider/model picker");
+  return 0;
+}
 async function runOpencodeSetup(creds, routingUrl, opts, deps) {
   try {
     if (opts.print) {
@@ -1305,7 +1388,7 @@ async function runMcp(profile) {
     read: (p) => readMemory(ctx, p),
     resolveProjectId
   };
-  const server = new McpServer({ name: "lunaroute-memory", version: "0.1.0" });
+  const server = new McpServer({ name: "lunaroute-memory", version });
   server.registerTool(
     "search",
     {
@@ -1440,7 +1523,7 @@ function buildRunSpec(ctx) {
     args: [],
     env: {
       ANTHROPIC_BASE_URL: ctx.routingUrl,
-      ANTHROPIC_API_KEY: ctx.apiKey,
+      ANTHROPIC_AUTH_TOKEN: ctx.apiKey,
       ANTHROPIC_MODEL: ctx.model,
       // Pins the Haiku/background model so Claude Code's background tasks
       // (titles, summaries, compaction) route through LunaRoute instead of
@@ -1538,7 +1621,7 @@ async function runRun(harness, opts, deps = realDeps) {
 
 // src/index.ts
 var program = new Command();
-program.name("lunaroute").description("LunaRoute CLI \u2014 configure coding harnesses and manage your account.").version("0.1.0").option("-p, --profile <name>", "credential profile to use", "default");
+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 () => {
   await login(program.opts().profile);
 });
@@ -1548,7 +1631,7 @@ 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 | claude-code | copilot-cli | 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").action(async (harness, opts) => {
   const code = await runSetup(harness, {
     profile: program.opts().profile,
     print: opts.print,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunaroute/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "LunaRoute CLI — configure coding harnesses and manage your LunaRoute account.",
   "repository": {
     "type": "git",