@lunaroute/cli 0.1.1 → 0.2.0

package/README.md

@@ -37,7 +37,7 @@ Prefer a script? `setup pi --extension` / `--models` pick a flow, `--yes` accept
 | `lunaroute login` | Authorize this device via the browser and store a routing key |
 | `lunaroute whoami` | Show the signed-in user and organization |
 | `lunaroute logout` | Remove stored credentials |
-| `lunaroute setup <harness>` | Configure `opencode` \| `pi` \| `claude-code` \| `copilot-cli` \| `generic`. pi setup is interactive (asks before writing); `--extension` / `--models` pick a flow, `--yes` accepts prompts, `--print` previews |
+| `lunaroute setup <harness>` | Configure `opencode` \| `pi` \| `openclaw` \| `claude-code` \| `copilot-cli` \| `generic`. pi setup is interactive (asks before writing); `--extension` / `--models` pick a flow, `--yes` accepts prompts, `--print` previews |
 | `lunaroute run <harness>` | Launch `claude` \| `claude-code` \| `codex` on LunaRoute for this session |
 | `lunaroute models` | List available LunaRoute models |
 | `lunaroute pricing` | Per-model pricing (credits per million tokens) |

package/dist/index.js

@@ -411,6 +411,9 @@ function configHome() {
 function opencodeConfigPath() {
   return join2(configHome(), "opencode", "opencode.json");
 }
+function openclawConfigPath() {
+  return join2(homedir2(), ".openclaw", "openclaw.json");
+}
 function piModelsPath() {
   return join2(homedir2(), ".pi", "agent", "models.json");
 }
@@ -441,7 +444,55 @@ function gitRepoRoot(cwd = process.cwd()) {
 }
 
 // src/setup/adapters/opencode.ts
-function buildPlan(ctx) {
+var EXTENSION = "@lunaroute/opencode-extension";
+var PROD_GATEWAY_HOST = "gw.lunaroute.com";
+function buildPlan(ctx, opts = {}) {
+  if (opts.extension) return extensionPlan(ctx);
+  return providerPlan(ctx);
+}
+function extensionPlan(ctx) {
+  return {
+    fileWrites: [
+      {
+        kind: "json",
+        path: opencodeConfigPath(),
+        merge: (existing) => {
+          const obj = existing ?? {};
+          const raw = obj.plugin;
+          const plugins = Array.isArray(raw) ? raw : typeof raw === "string" ? [raw] : [];
+          if (!plugins.includes(EXTENSION)) plugins.push(EXTENSION);
+          const next = { ...obj, plugin: plugins };
+          if (!isProdGateway(ctx.routingUrl)) {
+            const providers = objectOrEmpty(obj.provider);
+            const lr = objectOrEmpty(providers.lunaroute);
+            next.provider = {
+              ...providers,
+              lunaroute: { ...lr, options: { ...objectOrEmpty(lr.options), baseURL: `${ctx.routingUrl}/v1` } }
+            };
+          }
+          return next;
+        }
+      }
+    ],
+    // No env key: login happens in-app via /connect.
+    exports: [],
+    notes: [
+      "\nopencode: the extension installs on the next opencode start (npm plugins auto-install at startup).",
+      "Inside opencode: run /connect to log in, then /models to pick a LunaRoute model."
+    ]
+  };
+}
+function isProdGateway(url) {
+  try {
+    return new URL(url).host === PROD_GATEWAY_HOST;
+  } catch {
+    return false;
+  }
+}
+function objectOrEmpty(v) {
+  return typeof v === "object" && v !== null ? v : {};
+}
+function providerPlan(ctx) {
   const models = {};
   for (const m of ctx.models) models[m.id] = { name: m.id };
   const block = {
@@ -462,7 +513,7 @@ function buildPlan(ctx) {
         path: opencodeConfigPath(),
         merge: (existing) => {
           const obj = existing ?? {};
-          const existingProviders = typeof obj.provider === "object" && obj.provider !== null ? obj.provider : {};
+          const existingProviders = objectOrEmpty(obj.provider);
           const provider = { ...existingProviders, lunaroute: block };
           return { ...obj, provider };
         }
@@ -598,10 +649,94 @@ function buildPlan5(ctx) {
   };
 }
 
+// src/setup/routing-url.ts
+function validatedRoutingUrl(routingUrl) {
+  function fail(reason) {
+    throw new Error(
+      `routingUrl rejected (reason: ${reason}; <redacted URL>) \u2014 check --routing-url or the profile's routing URL`
+    );
+  }
+  if (!/^https?:\/\/[^/?#]/.test(routingUrl)) fail("invalid-url");
+  if (/[?#]/.test(routingUrl)) fail("query-or-fragment");
+  if (routingUrl !== routingUrl.trim()) fail("whitespace");
+  if (routingUrl.endsWith("/")) fail("trailing-slash");
+  let parsed;
+  try {
+    parsed = new URL(routingUrl);
+  } catch {
+    fail("invalid-url");
+  }
+  if (parsed.username !== "" || parsed.password !== "") fail("userinfo");
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") fail("invalid-url");
+  if (parsed.hostname === "") fail("invalid-url");
+  return routingUrl;
+}
+
+// src/setup/adapters/openclaw.ts
+function asRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v) ? v : {};
+}
+function buildPlan6(ctx) {
+  const base = validatedRoutingUrl(ctx.routingUrl);
+  const models = ctx.models.map((m) => ({ id: m.id, name: m.id }));
+  return {
+    fileWrites: [
+      {
+        kind: "json",
+        path: openclawConfigPath(),
+        merge: (existing) => {
+          const obj = asRecord(existing);
+          const modelsCfg = asRecord(obj.models);
+          const providers = asRecord(modelsCfg.providers);
+          const agents = asRecord(obj.agents);
+          const defaults = asRecord(agents.defaults);
+          const model = asRecord(defaults.model);
+          return {
+            ...obj,
+            models: {
+              ...modelsCfg,
+              mode: modelsCfg.mode ?? "merge",
+              providers: {
+                ...providers,
+                lunaroute: {
+                  baseUrl: `${base}/v1`,
+                  // OpenClaw interpolates the env var and sends it as
+                  // Authorization: Bearer lr_…; the edge authenticates the lr_
+                  // key and strips the header before forwarding upstream.
+                  apiKey: `\${${ctx.keyEnvVar}}`,
+                  api: "openai-completions",
+                  models
+                }
+              }
+            },
+            agents: {
+              ...agents,
+              defaults: {
+                ...defaults,
+                model: {
+                  ...model,
+                  // Preserve an existing primary model, like OpenClaw onboarding.
+                  primary: model.primary ?? `lunaroute/${ctx.models[0]?.id ?? "<model>"}`
+                }
+              }
+            }
+          };
+        }
+      }
+    ],
+    exports: [{ name: ctx.keyEnvVar, value: "__KEY__" }],
+    notes: [
+      `
+openclaw: restart the gateway, then \`openclaw models list\` and \`openclaw models set lunaroute/${ctx.models[0]?.id ?? "<model>"}\` (only if you have no default model already). If lunaroute/* models do not appear in \`openclaw models list\`, check that models.mode is merge \u2014 setup preserves whatever mode you have.`
+    ]
+  };
+}
+
 // src/commands/setup.ts
 var ADAPTERS = {
   opencode: buildPlan,
   pi: buildPlan2,
+  openclaw: buildPlan6,
   "claude-code": buildPlan3,
   "copilot-cli": buildPlan4,
   generic: buildPlan5
@@ -625,14 +760,24 @@ async function runSetup(harness, opts, deps = {
     console.error('Not logged in. Run "lunaroute login" first.');
     return 1;
   }
-  const routingUrl = opts.routingUrl || creds.routing_url;
-  if (!routingUrl) {
+  const routingUrlRaw = opts.routingUrl || creds.routing_url;
+  if (!routingUrlRaw) {
     console.error("No routing URL in profile; pass --routing-url.");
     return 1;
   }
+  let routingUrl;
+  try {
+    routingUrl = validatedRoutingUrl(routingUrlRaw.replace(/\/+$/, "").trim());
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : err);
+    return 1;
+  }
   if (harness === "pi" && !opts.print) {
     return runPiSetup(opts, deps);
   }
+  if (harness === "opencode") {
+    return runOpencodeSetup(creds, routingUrl, opts, deps);
+  }
   let models;
   try {
     models = await fetchModels(routingUrl);
@@ -646,8 +791,15 @@ async function runSetup(harness, opts, deps = {
     models,
     keyEnvVar: "LUNAROUTE_API_KEY"
   };
+  let plan;
   try {
-    const summary = await applyPlan(adapter(ctx), { print: opts.print, key: creds.routing_key });
+    plan = adapter(ctx);
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : err);
+    return 1;
+  }
+  try {
+    const summary = await applyPlan(plan, { print: opts.print, key: creds.routing_key });
     if (!opts.print && summary.written.length > 0) {
       console.log(`
 Wrote: ${summary.written.join(", ")}`);
@@ -699,6 +851,97 @@ async function runPiSetup(opts, deps) {
     return 1;
   }
 }
+async function runOpencodeSetup(creds, routingUrl, opts, deps) {
+  try {
+    if (opts.print) {
+      const plan = buildPlan(
+        { routingUrl, orgId: creds.org_id, models: [], keyEnvVar: "LUNAROUTE_API_KEY" },
+        { extension: true }
+      );
+      return applyAndReport(plan, creds.routing_key, false);
+    }
+    if (await deps.confirm(
+      "Install the LunaRoute OpenCode extension (recommended \u2014 /connect login, models auto-sync)?",
+      { yes: opts.yes }
+    )) {
+      const plan = buildPlan(
+        { routingUrl, orgId: creds.org_id, models: [], keyEnvVar: "LUNAROUTE_API_KEY" },
+        { extension: true }
+      );
+      const code = await applyAndReport(plan, creds.routing_key, !opts.print);
+      if (code !== 0) return code;
+      if (await deps.confirm("Start opencode now? (if it's already open, quit and reopen it to load the extension)", {
+        yes: opts.yes
+      })) {
+        return launchOpencode(deps.spawn);
+      }
+      console.log("\nStart opencode when ready \u2014 then run /connect to log in and /models to pick a LunaRoute model.");
+      return 0;
+    }
+    const write = await deps.confirm(
+      "Merge LunaRoute provider into opencode.json instead? (backup kept, other providers preserved)",
+      { yes: opts.yes }
+    );
+    return applyOpencodeProvider(creds, routingUrl, write);
+  } catch (err) {
+    if (err instanceof NonInteractiveTerminalError) {
+      console.error(
+        "No interactive terminal available. Re-run with --yes to accept prompts, or --print to preview without writing."
+      );
+      return 1;
+    }
+    console.error(err instanceof Error ? err.message : String(err));
+    return 1;
+  }
+}
+async function applyOpencodeProvider(creds, routingUrl, write) {
+  let models;
+  try {
+    models = await fetchModels(routingUrl);
+  } catch (err) {
+    console.error(`Could not fetch the model catalog: ${err instanceof Error ? err.message : err}`);
+    return 1;
+  }
+  const plan = buildPlan({
+    routingUrl,
+    orgId: creds.org_id,
+    models,
+    keyEnvVar: "LUNAROUTE_API_KEY"
+  });
+  return applyAndReport(plan, creds.routing_key, write);
+}
+async function applyAndReport(plan, key, write) {
+  try {
+    const summary = await applyPlan(plan, { print: !write, key });
+    if (write && summary.written.length > 0) {
+      console.log(`
+Wrote: ${summary.written.join(", ")}`);
+      if (summary.backedUp.length > 0) console.log(`  Backups: ${summary.backedUp.join(", ")}`);
+    }
+    return 0;
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    return 1;
+  }
+}
+async function launchOpencode(spawn3) {
+  return new Promise((resolve) => {
+    const child = spawn3("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);
+    });
+    child.on("exit", (code) => {
+      resolve(typeof code === "number" ? code : 1);
+    });
+  });
+}
 async function installPiExtension(spawn3) {
   for (const pkg of PI_INSTALL_PACKAGES) {
     const code = await new Promise((resolve) => {

package/package.json

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