@jacobbd/relay-ai 0.2.2 → 0.2.3

package/AGENTS.md

@@ -150,9 +150,9 @@ In all cases `process.env['OPENCODE_API_KEY']` is set immediately so the key is
 - `--restore` globs `models-*.json` (CLI) and `app-models-*.json` (App); the new files are `models-favorites.json` and `app-models-favorites.json`.
 - Zen/Go favorites are skipped in Codex (use Claude or Desktop gateway).
 
-## Release status (v0.2.0)
+## Release status (v0.2.3)
 
-Current version is **v0.2.0** — native provider registry (`relay-ai providers`), registry-first launch, import key validation, and Phase 1.3 dead-code cleanup. Prior work includes the SDK adapter from the pre-0.2 lineage (see CHANGELOG `[0.3.0]`).
+Current version is **v0.2.3** — native provider registry, agent boot flags (`--provider` / `--model`), `relay-ai --ai`, Codex favorites catalog, and OpenCode cloud provider setup in `relay-ai providers add`.
 
 **Known limitations (by design):**
 - Cost display in Codex is always inaccurate for non-Anthropic models.

package/CHANGELOG.md

@@ -2,10 +2,13 @@
 
 ## [Unreleased]
 
+## [0.2.3] - 2026-06-15
+
 ### Added
 - **Cross-surface favorites catalog** — Codex CLI (`relay-ai codex`) and Codex App (`relay-ai codex-app`) use `relay-ai models` favorites for mid-session model switching.
 - Server wizard defaults to favorites-only catalog when favorites are configured.
 - Provider labels in gateway model picker when using favorites-only mode.
+- **OpenCode Zen / Go in `relay-ai providers add`** — dedicated cloud API key path; template search for "opencode" offers the correct add flow.
 
 ## [0.2.0] - 2026-06-10
 

package/dist/cli.js

@@ -76,7 +76,7 @@ function classifyModelFormat(modelId, providerNpm) {
   if (lower.startsWith("gemini-")) return "unsupported";
   return "openai";
 }
-var VERSION = "0.2.2";
+var VERSION = "0.2.3";
 
 // src/provider-factory.ts
 var RESPONSES_ONLY_PREFIXES = [
@@ -3099,6 +3099,17 @@ function zenRegistryStub(subscriptionFilter) {
     addedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
+function goRegistryStub() {
+  return {
+    id: "go",
+    templateId: "go",
+    name: "OpenCode Go",
+    enabled: true,
+    authRef: "keyring:global:opencode",
+    api: {},
+    addedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
 
 // src/registry/convert.ts
 function modelToCached(model) {
@@ -3836,6 +3847,14 @@ function filterTemplates(templates, query) {
     (t) => t.id.toLowerCase().includes(q) || t.name.toLowerCase().includes(q) || t.npm.toLowerCase().includes(q)
   );
 }
+function matchesOpenCodeCloudSearch(query) {
+  const q = query.trim().toLowerCase();
+  if (!q) return false;
+  if (q.includes("opencode") || q.includes("open code")) return true;
+  if (q === "zen" || q === "go") return true;
+  if (q.includes("zen ") || q.startsWith("zen/") || q.endsWith(" zen")) return true;
+  return false;
+}
 
 // src/registry/resolve-template.ts
 var TEMPLATE_ID_ALIASES = {
@@ -7071,6 +7090,24 @@ async function removeProviderFromRegistry(id, opts) {
     credentialDeleted
   };
 }
+function addZenRegistryStub(opts) {
+  const registry = loadRegistry();
+  if (registry.providers.some((p19) => p19.id === "zen")) {
+    return { added: false, reason: "OpenCode Zen is already configured." };
+  }
+  registry.providers.push(zenRegistryStub(opts?.subscriptionFilter));
+  saveRegistry(registry);
+  return { added: true };
+}
+function addGoRegistryStub() {
+  const registry = loadRegistry();
+  if (registry.providers.some((p19) => p19.id === "go")) {
+    return { added: false, reason: "OpenCode Go is already configured." };
+  }
+  registry.providers.push(goRegistryStub());
+  saveRegistry(registry);
+  return { added: true };
+}
 function toggleProviderEnabled(id) {
   const registry = loadRegistry();
   const provider = registry.providers.find((p19) => p19.id === id);
@@ -7687,8 +7724,24 @@ async function pickTemplateFromCatalog() {
       placeholder: "e.g. groq, mistral, openrouter"
     });
     if (p10.isCancel(searchInput)) continue;
-    const matched = filterTemplates(templates, String(searchInput));
+    const query = String(searchInput);
+    const matched = filterTemplates(templates, query);
     if (matched.length === 0) {
+      if (matchesOpenCodeCloudSearch(query)) {
+        p10.log.info(
+          "OpenCode Zen / Go are cloud backends \u2014 not in the Groq/Mistral template list."
+        );
+        const addCloud = await p10.confirm({
+          message: "Add OpenCode Zen / Go with your OpenCode API key?",
+          initialValue: true
+        });
+        if (p10.isCancel(addCloud)) continue;
+        if (addCloud) {
+          await runOpenCodeCloudAddFlow();
+          return null;
+        }
+        continue;
+      }
       p10.log.warn("No providers match \u2014 try a different search");
       continue;
     }
@@ -7758,6 +7811,66 @@ async function runTemplateAddFlow() {
   logConnected(template.name, result.modelCount ?? 0);
   return 0;
 }
+async function runOpenCodeCloudAddFlow() {
+  const registry = loadRegistry();
+  const hasZen = registry.providers.some((pr) => pr.id === "zen");
+  const hasGo = registry.providers.some((pr) => pr.id === "go");
+  if (hasZen && hasGo) {
+    p10.log.info("OpenCode Zen and Go are already configured.");
+    return 0;
+  }
+  printPanel(pc10.cyan("OpenCode cloud"), [
+    `${pc10.white("Get an API key at:")} ${fmtUrl("https://opencode.ai/auth")}`,
+    `${pc10.dim("Uses OpenCode Zen / Go cloud models \u2014 not the same as importing from the OpenCode CLI.")}`
+  ]);
+  const existingKey = await readGlobalOpencodeCredential();
+  if (!existingKey) {
+    const apiKey = await resolveOrCollectApiKey(false, false);
+    if (!apiKey) {
+      p10.cancel("Cancelled.");
+      return 0;
+    }
+  }
+  await migrateGlobalOpencodeCredential();
+  let pick;
+  if (!hasZen && !hasGo) {
+    const choice = await p10.select({
+      message: "Which OpenCode cloud backend?",
+      options: [
+        { value: "zen", label: "OpenCode Zen", hint: "Free + paid models" },
+        { value: "go", label: "OpenCode Go", hint: "Paid models" },
+        { value: "both", label: "Both Zen and Go", hint: "Same API key" }
+      ]
+    });
+    if (p10.isCancel(choice)) {
+      p10.cancel("Cancelled.");
+      return 0;
+    }
+    pick = choice;
+  } else if (!hasZen) {
+    pick = "zen";
+  } else {
+    pick = "go";
+  }
+  const added = [];
+  if ((pick === "zen" || pick === "both") && !hasZen) {
+    const zen = addZenRegistryStub();
+    if (zen.added) added.push("OpenCode Zen");
+    else if (zen.reason) p10.log.warn(zen.reason);
+  }
+  if ((pick === "go" || pick === "both") && !hasGo) {
+    const go = addGoRegistryStub();
+    if (go.added) added.push("OpenCode Go");
+    else if (go.reason) p10.log.warn(go.reason);
+  }
+  if (added.length === 0) {
+    p10.log.info("Nothing new to add.");
+    return 0;
+  }
+  p10.log.success(`Added ${added.join(" and ")}.`);
+  p10.log.info("Run relay-ai providers refresh-models to cache model lists.");
+  return 0;
+}
 async function runCustomEndpointAddFlow() {
   const kindChoice = await p10.select({
     message: "Custom server type",
@@ -7819,7 +7932,16 @@ async function runProvidersAdd() {
   const registry = loadRegistry();
   const hasOpencode = findOpencodeBinary() !== null;
   const options = [
-    { value: "import", label: "Bring settings from OpenCode", hint: hasOpencode ? "One-time import" : "Requires OpenCode CLI" }
+    {
+      value: "opencode-cloud",
+      label: "OpenCode Zen / Go (cloud API key)",
+      hint: "Key from opencode.ai/auth \u2014 not in the Groq/Mistral list"
+    },
+    {
+      value: "import",
+      label: "Bring settings from OpenCode CLI",
+      hint: hasOpencode ? "Import Groq, OpenAI, etc. from your OpenCode config" : "Requires OpenCode CLI"
+    }
   ];
   const addableTemplates = listAddableTemplates(registry.providers.map((p19) => p19.id));
   if (addableTemplates.length > 0) {
@@ -7839,6 +7961,9 @@ async function runProvidersAdd() {
     p10.cancel("Cancelled.");
     return 0;
   }
+  if (choice === "opencode-cloud") {
+    return runOpenCodeCloudAddFlow();
+  }
   if (choice === "import") {
     if (!hasOpencode) {
       p10.log.error("OpenCode CLI not found. Install from https://opencode.ai");
@@ -7956,7 +8081,7 @@ async function runProvidersHub() {
       options.push({ value: "refresh-all", label: "\u21BA Refresh all models", hint: "Update model lists for all providers" });
     }
     if (hasOpencode) {
-      options.push({ value: "import", label: "\u2192 Bring settings from OpenCode", hint: "One-time import" });
+      options.push({ value: "import", label: "\u2192 Bring settings from OpenCode CLI", hint: "One-time import" });
     }
     options.push({ value: "done", label: "Done", hint: "" });
     const choice = await p10.select({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jacobbd/relay-ai",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "publishConfig": {
     "access": "public"
   },