@route_33/opencode 0.1.3 → 0.3.0

package/README.md

@@ -4,17 +4,31 @@ An opencode provider plugin for the [route33.ai](https://route33.ai) AI gateway:
 
 ## Install
 
-Add to the `plugin` array of your opencode config and restart opencode:
+```bash
+opencode plugin @route_33/opencode
+```
+
+The installer patches both configs: the server plugin into `opencode.json` and the key-setup wizard (TUI plugin) into `tui.json`. To install manually instead, declare both entries yourself:
 
-```json
+```jsonc
+// opencode.json — server plugin (model discovery, cost/limit enrichment, auth)
 {
-  "plugin": ["@route_33/opencode@^0.1"]
+  "plugin": ["@route_33/opencode@^0.2"]
 }
 ```
 
+```jsonc
+// tui.json — TUI plugin (the key-setup wizard)
+{
+  "plugin": ["@route_33/opencode@^0.2"]
+}
+```
+
+This plugin never writes your config: opencode has no TUI-plugin auto-discovery, so without a `tui.json` entry the wizard simply never appears — the server plugin works regardless.
+
 ## Auth
 
-Run `opencode auth login` and choose `route_33`, or set the `ROUTE33_API_KEY` environment variable. Without a key, the TUI wizard offers to save one: per-project inside a git workspace, global otherwise. A globally stored key applies only outside git workspaces — inside a workspace, keys resolve from the environment, the workspace config, or `.opencode/route33.key` (per-project keys are the metering boundary). `ROUTE33_BASE_URL` overrides the default gateway URL; `ROUTE33_TUI_PROMPT=0` disables the wizard.
+Run `opencode auth login` and choose `route_33`, or set the `ROUTE33_API_KEY` environment variable. Without a key, the TUI wizard offers to save one: per-project inside a git workspace, global otherwise. A globally stored key applies only outside git workspaces — inside a workspace, keys resolve from the environment, the workspace config, or `.opencode/route33.key` (per-project keys are the metering boundary). Skipping the project-key wizard snoozes it for 7 days — "Skip" for that workspace only, "Skip for all workspaces" everywhere (both live in opencode's TUI kv store; remove `project-key-prompt.dismissed-at*` from `~/.local/state/opencode/kv.json` to re-arm sooner). `ROUTE33_BASE_URL` overrides the default gateway URL; `ROUTE33_TUI_PROMPT=0` disables the wizard.
 
 ## License
 

package/dist/index.d.ts

@@ -10,6 +10,13 @@ import { Plugin } from '@opencode-ai/plugin';
  * validation — plus the `route_33` auth method and options loader.
  * Discovery runs once at startup; restart opencode after a key or config
  * change.
+ *
+ * The companion TUI plugin (`exports["./tui"]`, the key-setup wizard) is
+ * installed by the USER declaring it in `tui.json` — opencode has no TUI
+ * plugin auto-discovery, and this plugin never writes user config
+ * (upstream calls third-party tui.json mutation undesirable). The
+ * sanctioned install is `opencode plugin @route_33/opencode`, which
+ * patches both configs.
  */
 declare const Route33Plugin: Plugin;
 

package/dist/index.js

@@ -245,215 +245,6 @@ function buildRoute33Auth(env = process.env, worktree) {
   };
 }
 
-// src/bootstrap/ensure-tui-registration.ts
-import * as path8 from "path";
-
-// src/bootstrap/global-context.ts
-import * as os3 from "os";
-import * as path5 from "path";
-import { fileURLToPath } from "url";
-function isGlobalContext(worktree, moduleUrl) {
-  try {
-    if (moduleUrl === void 0) return false;
-    if (worktree === void 0) return true;
-    const root = path5.resolve(worktree);
-    if (root === "/") return true;
-    const modulePath = fileURLToPath(moduleUrl);
-    return !modulePath.startsWith(root + path5.sep);
-  } catch {
-    return false;
-  }
-}
-function usable5(value) {
-  const trimmed = value?.trim();
-  return trimmed === void 0 || trimmed === "" ? void 0 : trimmed;
-}
-function globalTuiJsonPath(env) {
-  const configHome = usable5(env.XDG_CONFIG_HOME) ?? path5.join(os3.homedir(), ".config");
-  return path5.join(configHome, "opencode", "tui.json");
-}
-
-// src/bootstrap/tui-json-upsert.ts
-import * as fs4 from "fs";
-import * as path7 from "path";
-import {
-  applyEdits,
-  modify,
-  parse as parseJsonc
-} from "jsonc-parser";
-
-// src/bootstrap/tui-spec-resolution.ts
-import * as fs3 from "fs";
-import * as os4 from "os";
-import * as path6 from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var NPM_TUI_SPEC = "@route_33/opencode";
-var DEAD_SUBPATH_TUI_SPEC = "@route_33/opencode/tui";
-var OLD_NPM_TUI_SPEC = "opencode-route33/tui";
-var TUI_BUNDLE_NAME = "route33-tui.js";
-var TUI_SCHEMA = "https://opencode.ai/tui.json";
-var SERVER_BUNDLE_NAME = "route33.js";
-var DIST_TUI_ENTRY_SUFFIX = "/opencode-route33/dist/tui/index.js";
-var SCOPED_DIST_TUI_ENTRY_SUFFIX = "/@route_33/opencode/dist/tui/index.js";
-var NPM_PACKAGE_DIR = path6.join("node_modules", "@route_33", "opencode");
-function fileExists(candidate) {
-  try {
-    return fs3.statSync(candidate).isFile();
-  } catch {
-    return false;
-  }
-}
-function npmSpecFromModulePath(selfPath) {
-  const segments = selfPath.split(path6.sep);
-  for (let i = 0; i < segments.length - 1; i++) {
-    const pkgDir = segments[i + 1];
-    if (segments[i] === "@route_33" && pkgDir !== void 0 && pkgDir.startsWith("opencode@")) {
-      const pin = pkgDir.slice("opencode@".length);
-      if (pin !== "") return `${NPM_TUI_SPEC}@${pin}`;
-    }
-  }
-  return selfPath.includes(`${NPM_PACKAGE_DIR}${path6.sep}`) ? NPM_TUI_SPEC : void 0;
-}
-function specFromModuleUrl(moduleUrl) {
-  try {
-    if (moduleUrl === void 0) return void 0;
-    const selfPath = fileURLToPath2(moduleUrl);
-    const dir = path6.dirname(selfPath);
-    if (path6.basename(selfPath) === SERVER_BUNDLE_NAME) {
-      const sibling = path6.join(dir, TUI_BUNDLE_NAME);
-      return fileExists(sibling) ? sibling : void 0;
-    }
-    if (path6.basename(selfPath) === "index.js" && path6.basename(dir) === "dist") {
-      const npmSpec = npmSpecFromModulePath(selfPath);
-      if (npmSpec !== void 0) return npmSpec;
-      const tuiEntry = path6.join(dir, "tui", "index.js");
-      return fileExists(tuiEntry) ? tuiEntry : void 0;
-    }
-    return void 0;
-  } catch {
-    return void 0;
-  }
-}
-function resolveTuiSpec(worktree, env, moduleUrl) {
-  const fromModule = specFromModuleUrl(moduleUrl);
-  if (fromModule !== void 0) return fromModule;
-  if (worktree !== void 0 && worktree.trim() !== "" && path6.resolve(worktree) !== "/") {
-    const local = path6.join(worktree, ".opencode", "plugins", TUI_BUNDLE_NAME);
-    if (fileExists(local)) return local;
-  }
-  const configHome = env.XDG_CONFIG_HOME?.trim() || path6.join(os4.homedir(), ".config");
-  const global = path6.join(configHome, "opencode", "plugins", TUI_BUNDLE_NAME);
-  if (fileExists(global)) return global;
-  return NPM_TUI_SPEC;
-}
-function isOurEntry(entry) {
-  return typeof entry === "string" && (entry === NPM_TUI_SPEC || entry.startsWith(`${NPM_TUI_SPEC}@`) || entry === DEAD_SUBPATH_TUI_SPEC || entry === OLD_NPM_TUI_SPEC || entry.endsWith(`/${TUI_BUNDLE_NAME}`) || entry.endsWith(DIST_TUI_ENTRY_SUFFIX) || entry.endsWith(SCOPED_DIST_TUI_ENTRY_SUFFIX));
-}
-
-// src/bootstrap/tui-json-upsert.ts
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function fileExists2(candidate) {
-  try {
-    return fs4.statSync(candidate).isFile();
-  } catch {
-    return false;
-  }
-}
-function upsertTuiSpec(file, spec) {
-  try {
-    if (!fileExists2(file)) {
-      fs4.mkdirSync(path7.dirname(file), { recursive: true });
-      fs4.writeFileSync(
-        file,
-        JSON.stringify({ $schema: TUI_SCHEMA, plugin: [spec] }, null, 2) + "\n",
-        "utf8"
-      );
-      return;
-    }
-    const text = fs4.readFileSync(file, "utf8");
-    const errors = [];
-    const parsed = parseJsonc(text, errors, {
-      allowTrailingComma: true,
-      allowEmptyContent: true
-    });
-    if (!isRecord3(parsed)) {
-      logger.warn(
-        `tui.json at ${file} did not parse to an object \u2014 skipping TUI registration`
-      );
-      return;
-    }
-    if (parsed.plugin !== void 0 && !Array.isArray(parsed.plugin)) {
-      logger.warn(
-        `tui.json at ${file} has a non-array "plugin" key \u2014 skipping TUI registration`
-      );
-      return;
-    }
-    const entries = Array.isArray(parsed.plugin) ? parsed.plugin : [];
-    const ourIndices = entries.flatMap(
-      (entry, index) => isOurEntry(entry) ? [index] : []
-    );
-    const firstOurs = ourIndices[0];
-    if (ourIndices.length === 1 && firstOurs !== void 0 && entries[firstOurs] === spec)
-      return;
-    const formattingOptions = { insertSpaces: true, tabSize: 2 };
-    let next = text;
-    if (!Array.isArray(parsed.plugin)) {
-      next = applyEdits(
-        next,
-        modify(next, ["plugin"], [spec], { formattingOptions })
-      );
-    } else if (firstOurs === void 0) {
-      next = applyEdits(
-        next,
-        modify(next, ["plugin", -1], spec, {
-          formattingOptions,
-          isArrayInsertion: true
-        })
-      );
-    } else {
-      if (entries[firstOurs] !== spec) {
-        next = applyEdits(
-          next,
-          modify(next, ["plugin", firstOurs], spec, { formattingOptions })
-        );
-      }
-      for (const index of ourIndices.slice(1).sort((a, b) => b - a)) {
-        next = applyEdits(
-          next,
-          modify(next, ["plugin", index], void 0, { formattingOptions })
-        );
-      }
-    }
-    if (next !== text) fs4.writeFileSync(file, next, "utf8");
-  } catch (error) {
-    logger.warn(
-      `could not register the route33 TUI plugin in tui.json: ${String(error)}`
-    );
-  }
-}
-
-// src/bootstrap/ensure-tui-registration.ts
-function ensureTuiRegistration(deps) {
-  try {
-    const { worktree, env } = deps;
-    if (env.ROUTE33_TUI_PROMPT === "0") return;
-    const usableWorktree = worktree !== void 0 && worktree.trim() !== "" && path8.resolve(worktree) !== "/" ? worktree : void 0;
-    const spec = resolveTuiSpec(usableWorktree, env, deps.moduleUrl);
-    if (usableWorktree !== void 0) {
-      upsertTuiSpec(path8.join(usableWorktree, ".opencode", "tui.json"), spec);
-    }
-    if (isGlobalContext(worktree, deps.moduleUrl)) {
-      upsertTuiSpec(globalTuiJsonPath(env), spec);
-    }
-  } catch (error) {
-    logger.warn(
-      `could not register the route33 TUI plugin in tui.json: ${String(error)}`
-    );
-  }
-}
-
 // src/config/live-auth-fetch.ts
 function buildLiveAuthFetch(resolveKeyNow, innerFetch) {
   return (input, init) => {
@@ -595,24 +386,24 @@ function hashKey(key) {
 }
 
 // src/catalog/catalog-cache/read-disk.ts
-import * as fs5 from "fs";
+import * as fs3 from "fs";
 
 // src/catalog/catalog-cache/cache-file-path.ts
-import * as path9 from "path";
+import * as path5 from "path";
 function cacheFilePath(keyHash, env) {
-  return path9.join(resolveCacheDir(env), `catalog-${keyHash}.json`);
+  return path5.join(resolveCacheDir(env), `catalog-${keyHash}.json`);
 }
 
 // src/catalog/catalog-cache/read-disk.ts
-function isRecord4(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readDisk(keyHash, env) {
   try {
     const parsed = JSON.parse(
-      fs5.readFileSync(cacheFilePath(keyHash, env), "utf8")
+      fs3.readFileSync(cacheFilePath(keyHash, env), "utf8")
     );
-    if (!isRecord4(parsed) || typeof parsed.fetchedAt !== "number" || !isRecord4(parsed.models))
+    if (!isRecord3(parsed) || typeof parsed.fetchedAt !== "number" || !isRecord3(parsed.models))
       return void 0;
     return {
       fetchedAt: parsed.fetchedAt,
@@ -654,15 +445,15 @@ function readStaleCatalog(opts) {
 }
 
 // src/catalog/catalog-cache/write-catalog.ts
-import * as fs6 from "fs";
+import * as fs4 from "fs";
 function writeCatalog(opts) {
   const { key, models, env = process.env, now = Date.now() } = opts;
   const keyHash = hashKey(key);
   const record = { fetchedAt: now, keyHash, models };
   memory.set(keyHash, record);
   try {
-    fs6.mkdirSync(resolveCacheDir(env), { recursive: true });
-    fs6.writeFileSync(cacheFilePath(keyHash, env), JSON.stringify(record));
+    fs4.mkdirSync(resolveCacheDir(env), { recursive: true });
+    fs4.writeFileSync(cacheFilePath(keyHash, env), JSON.stringify(record));
   } catch (error) {
     logger.warn(
       `could not persist catalog cache: ${error instanceof Error ? error.message : String(error)}`
@@ -686,7 +477,7 @@ var CatalogFetchError = class extends Error {
 var DEFAULT_FETCH_TIMEOUT_MS = 5e3;
 
 // src/catalog/extract-pricing.ts
-function isRecord5(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var OPENROUTER_KEYS = [
@@ -743,7 +534,7 @@ function extractModelsDevPricing(raw) {
   return cost;
 }
 function extractPricing(raw) {
-  if (!isRecord5(raw)) return void 0;
+  if (!isRecord4(raw)) return void 0;
   const hasOpenRouterKeys = OPENROUTER_KEYS.some((key) => key in raw);
   const hasModelsDevKeys = MODELS_DEV_KEYS.some((key) => key in raw);
   if (hasOpenRouterKeys && hasModelsDevKeys) return void 0;
@@ -774,12 +565,12 @@ function normalizeId(raw, env = process.env) {
 }
 
 // src/catalog/fetch-catalog.ts
-function isRecord6(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseEntries(payload) {
   if (Array.isArray(payload)) return payload;
-  if (isRecord6(payload) && Array.isArray(payload.data)) return payload.data;
+  if (isRecord5(payload) && Array.isArray(payload.data)) return payload.data;
   throw new CatalogFetchError(
     "parse",
     "response is neither {data:[\u2026]} nor a bare array"
@@ -788,13 +579,13 @@ function parseEntries(payload) {
 function toCatalogModels(entries, env) {
   const models = {};
   for (const entry of entries) {
-    if (!isRecord6(entry) || typeof entry.id !== "string") continue;
+    if (!isRecord5(entry) || typeof entry.id !== "string") continue;
     const slug2 = normalizeId(entry.id, env);
     if (!slug2 || models[slug2]) continue;
     const model = { id: slug2 };
     const displayName = typeof entry.display_name === "string" ? entry.display_name.trim() : "";
     if (displayName !== "") model.displayName = displayName;
-    if (isRecord6(entry.pricing) && extractPricing(entry.pricing) !== void 0)
+    if (isRecord5(entry.pricing) && extractPricing(entry.pricing) !== void 0)
       model.pricing = entry.pricing;
     models[slug2] = model;
   }
@@ -1203,11 +994,11 @@ function enrichModel(slug2, sources) {
 }
 
 // src/enrich/models-dev/load-models-dev.ts
-import * as fs7 from "fs";
-import * as path10 from "path";
+import * as fs5 from "fs";
+import * as path6 from "path";
 
 // src/enrich/models-dev/is-record.ts
-function isRecord7(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1226,7 +1017,7 @@ async function fetchLive(fetchImpl) {
       return void 0;
     }
     const body = await response.json();
-    return isRecord7(body) ? body : void 0;
+    return isRecord6(body) ? body : void 0;
   } catch (error) {
     logger.warn("models.dev fetch failed:", error);
     return void 0;
@@ -1243,7 +1034,7 @@ function num(value) {
 // src/enrich/models-dev/normalize-cost.ts
 var EXPRESSIBLE_TIER_SIZE = 2e5;
 function parseRateBlock(value) {
-  if (!isRecord7(value)) return void 0;
+  if (!isRecord6(value)) return void 0;
   const input = num(value.input);
   const output = num(value.output);
   if (input === void 0 || output === void 0) return void 0;
@@ -1256,7 +1047,7 @@ function parseRateBlock(value) {
 }
 function isExpressibleContextTier(tier) {
   const marker = tier.tier;
-  return isRecord7(marker) && marker.type === "context" && marker.size === EXPRESSIBLE_TIER_SIZE;
+  return isRecord6(marker) && marker.type === "context" && marker.size === EXPRESSIBLE_TIER_SIZE;
 }
 function maxRate(current, candidate) {
   const rate = num(candidate);
@@ -1264,7 +1055,7 @@ function maxRate(current, candidate) {
   return current === void 0 || rate > current ? rate : current;
 }
 function normalizeCost(raw) {
-  if (!isRecord7(raw)) return void 0;
+  if (!isRecord6(raw)) return void 0;
   const input = num(raw.input);
   const output = num(raw.output);
   if (input === void 0 || output === void 0) return void 0;
@@ -1275,7 +1066,7 @@ function normalizeCost(raw) {
   if (cacheWrite !== void 0) cost.cache_write = cacheWrite;
   const over200k = parseRateBlock(raw.context_over_200k);
   if (over200k) cost.context_over_200k = over200k;
-  const tiers = Array.isArray(raw.tiers) ? raw.tiers.filter(isRecord7) : [];
+  const tiers = Array.isArray(raw.tiers) ? raw.tiers.filter(isRecord6) : [];
   for (const tier of tiers) {
     if (isExpressibleContextTier(tier)) {
       if (cost.context_over_200k === void 0) {
@@ -1305,10 +1096,10 @@ function swapLast(value, from, to) {
   return index === -1 ? value : `${value.slice(0, index)}${to}${value.slice(index + 1)}`;
 }
 function probeCandidates(slug2) {
-  const sep3 = slug2.indexOf("/");
-  if (sep3 <= 0 || sep3 >= slug2.length - 1) return [];
-  const vendor = slug2.slice(0, sep3);
-  const model = slug2.slice(sep3 + 1);
+  const sep = slug2.indexOf("/");
+  if (sep <= 0 || sep >= slug2.length - 1) return [];
+  const vendor = slug2.slice(0, sep);
+  const model = slug2.slice(sep + 1);
   const vendors = [vendor];
   const alias = VENDOR_ALIASES[vendor];
   if (alias !== void 0 && alias !== vendor) vendors.push(alias);
@@ -1333,7 +1124,7 @@ function probeCandidates(slug2) {
 
 // src/enrich/models-dev/lookup.ts
 function normalizeLimit(raw) {
-  if (!isRecord7(raw)) return void 0;
+  if (!isRecord6(raw)) return void 0;
   const context = num(raw.context);
   const output = num(raw.output);
   if (context === void 0 || output === void 0) return void 0;
@@ -1362,9 +1153,9 @@ function buildLookup(model) {
 function lookupSlug(data, slug2) {
   for (const [providerKey, modelKey] of probeCandidates(slug2)) {
     const provider = data[providerKey];
-    if (!isRecord7(provider) || !isRecord7(provider.models)) continue;
+    if (!isRecord6(provider) || !isRecord6(provider.models)) continue;
     const model = provider.models[modelKey];
-    if (isRecord7(model)) return buildLookup(model);
+    if (isRecord6(model)) return buildLookup(model);
   }
   return void 0;
 }
@@ -1373,10 +1164,10 @@ function lookupSlug(data, slug2) {
 var CACHE_FILE = "models-dev.json";
 function readCache(cachePath) {
   try {
-    const parsed = JSON.parse(fs7.readFileSync(cachePath, "utf8"));
-    if (!isRecord7(parsed)) return void 0;
+    const parsed = JSON.parse(fs5.readFileSync(cachePath, "utf8"));
+    if (!isRecord6(parsed)) return void 0;
     const fetchedAt = num(parsed.fetchedAt);
-    if (fetchedAt === void 0 || !isRecord7(parsed.data)) return void 0;
+    if (fetchedAt === void 0 || !isRecord6(parsed.data)) return void 0;
     return { fetchedAt, data: parsed.data };
   } catch {
     return void 0;
@@ -1384,8 +1175,8 @@ function readCache(cachePath) {
 }
 function writeCache(cachePath, envelope) {
   try {
-    fs7.mkdirSync(path10.dirname(cachePath), { recursive: true });
-    fs7.writeFileSync(cachePath, JSON.stringify(envelope), "utf8");
+    fs5.mkdirSync(path6.dirname(cachePath), { recursive: true });
+    fs5.writeFileSync(cachePath, JSON.stringify(envelope), "utf8");
   } catch (error) {
     logger.warn("failed to write models.dev cache:", error);
   }
@@ -1398,7 +1189,7 @@ async function loadModelsDev(options = {}) {
   const cacheDir = options.cacheDir ?? resolveCacheDir();
   const ttlMs = options.ttlMs ?? MODELS_DEV_TTL_MS;
   const now = options.now ?? Date.now;
-  const cachePath = path10.join(cacheDir, CACHE_FILE);
+  const cachePath = path6.join(cacheDir, CACHE_FILE);
   const cached = readCache(cachePath);
   if (cached && now() - cached.fetchedAt < ttlMs)
     return makeSource("cache", cached.data);
@@ -1548,10 +1339,10 @@ function mergeConfig(cfg, blocks) {
 
 // src/config/collected-ref.ts
 function parseRef(ref, source) {
-  const sep3 = ref.indexOf("/");
-  if (sep3 <= 0 || sep3 >= ref.length - 1) return void 0;
-  const providerId = ref.slice(0, sep3);
-  const suffix = ref.slice(sep3 + 1);
+  const sep = ref.indexOf("/");
+  if (sep <= 0 || sep >= ref.length - 1) return void 0;
+  const providerId = ref.slice(0, sep);
+  const suffix = ref.slice(sep + 1);
   if (providerId === "route_33")
     return { providerId, modelKey: suffix, ref, source };
   if (providerId !== "route_33_anthropic") return void 0;
@@ -1581,34 +1372,34 @@ function collectCfgRefs(cfg) {
 }
 
 // src/config/collect-flavour-refs.ts
-import * as fs8 from "fs";
-import * as os5 from "os";
-import * as path11 from "path";
-import { parse as parseJsonc2 } from "jsonc-parser";
-function isRecord8(value) {
+import * as fs6 from "fs";
+import * as os3 from "os";
+import * as path7 from "path";
+import { parse as parseJsonc } from "jsonc-parser";
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function findFlavourPath(env, cwd) {
   const candidates = [];
   const configDir = env.OPENCODE_CONFIG_DIR?.trim();
-  if (configDir) candidates.push(path11.join(configDir, "oh-my-openagent.jsonc"));
-  candidates.push(path11.join(cwd, ".opencode", "oh-my-openagent.jsonc"));
-  const configHome = env.XDG_CONFIG_HOME?.trim() || path11.join(os5.homedir(), ".config");
-  candidates.push(path11.join(configHome, "opencode", "oh-my-openagent.jsonc"));
+  if (configDir) candidates.push(path7.join(configDir, "oh-my-openagent.jsonc"));
+  candidates.push(path7.join(cwd, ".opencode", "oh-my-openagent.jsonc"));
+  const configHome = env.XDG_CONFIG_HOME?.trim() || path7.join(os3.homedir(), ".config");
+  candidates.push(path7.join(configHome, "opencode", "oh-my-openagent.jsonc"));
   for (const candidate of candidates) {
     try {
-      if (fs8.existsSync(candidate)) return candidate;
+      if (fs6.existsSync(candidate)) return candidate;
     } catch {
     }
   }
   return void 0;
 }
 function collectSectionRefs(refs, section, label) {
-  if (!isRecord8(section)) return;
+  if (!isRecord7(section)) return;
   for (const [name, entry] of Object.entries(section)) {
-    if (!isRecord8(entry)) continue;
+    if (!isRecord7(entry)) continue;
     pushRef(refs, entry.model, `flavour ${label} "${name}"`);
-    if (label === "agent" && isRecord8(entry.ultrawork)) {
+    if (label === "agent" && isRecord7(entry.ultrawork)) {
       pushRef(
         refs,
         entry.ultrawork.model,
@@ -1622,8 +1413,8 @@ function collectFlavourRefs(env, cwd) {
   if (flavourPath === void 0) return [];
   const refs = [];
   try {
-    const parsed = parseJsonc2(fs8.readFileSync(flavourPath, "utf8"));
-    if (!isRecord8(parsed)) {
+    const parsed = parseJsonc(fs6.readFileSync(flavourPath, "utf8"));
+    if (!isRecord7(parsed)) {
       logger.warn(
         `flavour file ${flavourPath} did not parse to an object \u2014 skipping flavour ref validation`
       );
@@ -1802,11 +1593,6 @@ function createConfigHook(options = {}) {
 
 // src/index.ts
 var Route33Plugin = async (input, _options) => {
-  ensureTuiRegistration({
-    worktree: input?.worktree ?? input?.directory,
-    env: process.env,
-    moduleUrl: import.meta.url
-  });
   ensureWorkspaceKeyGitignore(input?.worktree ?? input?.directory);
   return {
     config: createConfigHook(),

package/dist/tui/index.js

@@ -155,7 +155,9 @@ var KEY_SELECT_TITLE = "route33.ai project key";
 var KEY_SELECT_ENTER_LABEL = "Enter a project key";
 var KEY_SELECT_ENTER_DESCRIPTION = "Per workspace on purpose \u2014 one shared key would lose the per-project metrics";
 var KEY_SELECT_SKIP_LABEL = "Skip";
-var KEY_SELECT_SKIP_DESCRIPTION = "Ask again in 7 days";
+var KEY_SELECT_SKIP_DESCRIPTION = "Ask again in 7 days \u2014 this workspace only";
+var KEY_SELECT_SKIP_ALL_LABEL = "Skip for all workspaces";
+var KEY_SELECT_SKIP_ALL_DESCRIPTION = "Ask again in 7 days \u2014 everywhere";
 var KEY_SELECT_PLACEHOLDER = "No route33.ai key found for this workspace yet.";
 var KEY_PROMPT_TITLE = "Paste your route33.ai project key";
 var KEY_SAVED_MESSAGE = "route33.ai project key saved to .opencode/route33.key \u2014 live immediately, no restart needed.";
@@ -211,8 +213,10 @@ async function runProjectKeyPromptFlow({
   dismissal,
   now = Date.now
 }) {
-  if (await ui.askChoice() === "skip") {
-    dismissal.dismiss(now());
+  const choice = await ui.askChoice();
+  if (choice === "skip" || choice === "skip-all") {
+    if (choice === "skip-all") dismissal.dismissGlobally(now());
+    else dismissal.dismiss(now());
     ui.close();
     return "skipped";
   }
@@ -262,6 +266,9 @@ async function runActivation(deps) {
   }
 }
 
+// src/tui/dismissal-store.ts
+import { resolve as resolve3 } from "path";
+
 // src/tui/dismissal-cooldown.ts
 var DISMISSAL_COOLDOWN_MS = 7 * 24 * 60 * 60 * 1e3;
 function isWithinCooldown(dismissedAt, now) {
@@ -279,15 +286,53 @@ function readDismissedAt(kv, key) {
     return void 0;
   }
 }
-function createDismissalStore(kv, key = PROJECT_KEY_PROMPT_DISMISSED_AT_KEY) {
+function readByWorkspace(kv, key) {
+  try {
+    const value = kv.get(key);
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+      return {};
+    }
+    const entries = {};
+    for (const [path5, at] of Object.entries(value)) {
+      if (typeof at === "number" && Number.isFinite(at)) entries[path5] = at;
+    }
+    return entries;
+  } catch {
+    return {};
+  }
+}
+function createDismissalStore(kv, key = PROJECT_KEY_PROMPT_DISMISSED_AT_KEY, worktree) {
+  const scoped = worktree !== void 0 ? resolve3(worktree) : void 0;
+  const byWorkspaceKey = `${key}.by-workspace`;
+  const dismissGlobally = (now) => {
+    try {
+      kv.set(key, now);
+    } catch {
+    }
+  };
   return {
-    isDismissed: (now) => isWithinCooldown(readDismissedAt(kv, key), now),
+    isDismissed: (now) => {
+      if (isWithinCooldown(readDismissedAt(kv, key), now)) return true;
+      if (scoped === void 0) return false;
+      return isWithinCooldown(readByWorkspace(kv, byWorkspaceKey)[scoped], now);
+    },
     dismiss: (now) => {
+      if (scoped === void 0) {
+        dismissGlobally(now);
+        return;
+      }
       try {
-        kv.set(key, now);
+        const entries = readByWorkspace(kv, byWorkspaceKey);
+        const pruned = {};
+        for (const [path5, at] of Object.entries(entries)) {
+          if (isWithinCooldown(at, now)) pruned[path5] = at;
+        }
+        pruned[scoped] = now;
+        kv.set(byWorkspaceKey, pruned);
       } catch {
       }
-    }
+    },
+    dismissGlobally
   };
 }
 
@@ -298,6 +343,8 @@ var PROJECT_COPY = {
   enterDescription: KEY_SELECT_ENTER_DESCRIPTION,
   skipLabel: KEY_SELECT_SKIP_LABEL,
   skipDescription: KEY_SELECT_SKIP_DESCRIPTION,
+  skipAllLabel: KEY_SELECT_SKIP_ALL_LABEL,
+  skipAllDescription: KEY_SELECT_SKIP_ALL_DESCRIPTION,
   selectPlaceholder: KEY_SELECT_PLACEHOLDER,
   promptTitle: KEY_PROMPT_TITLE
 };
@@ -314,12 +361,12 @@ var GLOBAL_COPY = {
 // src/tui/tui-api-adapter.ts
 var READY_POLL_INTERVAL_MS = 100;
 function askChoice(api, copy) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     let settled = false;
     const settle = (choice) => {
       if (settled) return;
       settled = true;
-      resolve3(choice);
+      resolve4(choice);
     };
     api.ui.dialog.replace(
       () => api.ui.DialogSelect({
@@ -335,10 +382,21 @@ function askChoice(api, copy) {
             title: copy.skipLabel,
             value: "skip",
             description: copy.skipDescription
-          }
+          },
+          // Only the project copy defines a skip-all scope; the global
+          // prompt's plain skip is global already.
+          ...copy.skipAllLabel !== void 0 ? [
+            {
+              title: copy.skipAllLabel,
+              value: "skip-all",
+              description: copy.skipAllDescription ?? ""
+            }
+          ] : []
         ],
         onSelect: (option) => {
-          settle(option.value === "enter" ? "enter" : "skip");
+          settle(
+            option.value === "enter" ? "enter" : option.value === "skip-all" ? "skip-all" : "skip"
+          );
         }
       }),
       () => {
@@ -348,12 +406,12 @@ function askChoice(api, copy) {
   });
 }
 function askKey(api, copy) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     let settled = false;
     const settle = (value) => {
       if (settled) return;
       settled = true;
-      resolve3(value);
+      resolve4(value);
     };
     api.ui.dialog.replace(
       () => api.ui.DialogPrompt({
@@ -375,20 +433,20 @@ function askKey(api, copy) {
   });
 }
 function waitUntilReady(api) {
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     if (api.state.ready) {
-      resolve3(true);
+      resolve4(true);
       return;
     }
     const timer = setInterval(() => {
       if (api.lifecycle.signal.aborted) {
         clearInterval(timer);
-        resolve3(false);
+        resolve4(false);
         return;
       }
       if (api.state.ready) {
         clearInterval(timer);
-        resolve3(true);
+        resolve4(true);
       }
     }, READY_POLL_INTERVAL_MS);
   });
@@ -448,7 +506,11 @@ async function activate(api) {
   await runActivation({
     ui,
     keyStore,
-    dismissal: createDismissalStore(kv),
+    dismissal: createDismissalStore(
+      kv,
+      PROJECT_KEY_PROMPT_DISMISSED_AT_KEY,
+      process.cwd()
+    ),
     globalUi,
     globalStore,
     globalDismissal: createDismissalStore(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@route_33/opencode",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "description": "opencode provider plugin for the route33.ai AI gateway — key-scoped model discovery, cost/limit enrichment, auth, and the key-setup wizard.",
@@ -19,6 +19,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./server": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
     "./tui": {
       "types": "./dist/tui/index.d.ts",
       "import": "./dist/tui/index.js"