@mcowger/opencode-plexus 1.1.1 → 1.2.0

package/README.md

@@ -116,7 +116,11 @@ Run inside OpenCode:
 /connect
 ```
 
-Select **Plexus** and enter your base URL and API key. Models are discovered through OpenCode's provider hook and cached for fast startup on subsequent sessions.
+Select **Plexus** and enter your base URL and API key. OpenCode has no live model-discovery hook for custom providers, so the model list is seeded from the on-disk cache at startup. Run `/plexus-refresh` to force a live fetch from Plexus and rewrite the cache, then restart OpenCode to pick up the refreshed list:
+
+```
+/plexus-refresh
+```
 
 You may enter either the Plexus root URL or the `/v1` API base URL:
 
@@ -197,7 +201,7 @@ packages/
       plugin.ts         # Plugin export: config hook, provider hook, auth handler
       mapper.ts         # PlexusApiModel → OpenCode ConfigModel
       cache.ts          # model cache I/O
-      config-store.ts   # resolveConfig, persistToGlobalConfig
+      config-store.ts   # resolveConfig, readStoredAuth
       log.ts            # logger via OpenCode SDK
       constants.ts      # provider ID, env var names, timeouts
       url.ts            # URL helpers (trimURL, apiBase, modelsUrl)
@@ -228,7 +232,7 @@ Models with a falsy `id` are skipped. Missing metadata falls back to safe defaul
 ## Adapter behavior
 
 - **pi** refreshes on session start and through `/plexus refresh`. It accepts either root URLs or URLs ending in `/v1` and normalizes them before calling Plexus.
-- **OpenCode** seeds the provider from cache or a placeholder model during config loading, then performs live discovery through the `provider.models` hook. If Plexus is slow or unavailable, OpenCode uses the cache and lets the refresh continue in the background.
+- **OpenCode** seeds the provider from the on-disk cache (or a placeholder model) once, during config loading — OpenCode's `provider.models` hook never fires for custom providers, so there is no live discovery at startup. Run `/plexus-refresh` to force a live fetch and rewrite the cache; because OpenCode has no way to hot-reload a custom provider's model list mid-session, a restart is required afterward to see the refreshed models in the picker.
 - OpenCode models retain their upstream model ID, SDK dialect, release date, and reasoning metadata so OpenCode can generate its native GPT, Claude, Gemini, and OpenAI-compatible variants and apply its current request transforms. DeepSeek models also preserve `reasoning_content` across tool-call turns.
 - OpenCode uses a 250K-token context window when Plexus supplies no context metadata; its output fallback remains 20% of that window.
 - Both adapters convert Plexus's per-token base and tier rates to the per-million-token units expected by their host.

package/dist/index.js

@@ -13,6 +13,7 @@ var MODELS_FETCH_TIMEOUT_MS = 1e4;
 var REFRESH_TTL_MS = 60000;
 var CONFIG_HOOK_REFRESH_BUDGET_MS = 3000;
 var PLACEHOLDER_MODEL_ID = "plexus-unconfigured";
+var PLEXUS_REFRESH_COMMAND = "plexus-refresh";
 
 // ../plexus-models/src/convert.ts
 var REASONING_PARAMS = new Set(["reasoning", "include_reasoning", "reasoning_effort"]);
@@ -103,13 +104,23 @@ function fallbackDir() {
 function getDir() {
   return fallbackDir();
 }
+function filterCachedModels(models) {
+  return Object.fromEntries(Object.entries(models).filter(([, model]) => isChatModel({
+    id: model.id,
+    name: model.name,
+    architecture: {
+      input_modalities: model.modalities.input,
+      output_modalities: model.modalities.output
+    }
+  })));
+}
 async function readCachedModels(_client) {
   try {
     const dir = getDir();
     const content = await readFile(join(dir, CACHE_FILE), "utf8");
     const parsed = JSON.parse(content);
     if (parsed && typeof parsed.models === "object" && !Array.isArray(parsed.models)) {
-      return parsed.models;
+      return filterCachedModels(parsed.models);
     }
     return null;
   } catch {
@@ -130,6 +141,11 @@ async function writeCache(_client, models, raw) {
   } catch {}
 }
 
+// src/config-store.ts
+import { readFile as readFile2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+
 // src/url.ts
 function trimURL(s) {
   return s.trim().replace(/\/+$/, "");
@@ -155,6 +171,21 @@ function modelsUrl(baseURL) {
 var ENV_VAR_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var ENV_VAR_NAME_PREFIX_RE = /^[A-Za-z_][A-Za-z0-9_]*/;
 var AUTH_METADATA_BASE_URL = "plexusBaseURL";
+async function readStoredAuth() {
+  const dataHome = process.env.XDG_DATA_HOME || join2(homedir2(), ".local", "share");
+  const file = join2(dataHome, "opencode", "auth.json");
+  try {
+    const content = await readFile2(file, "utf8");
+    const parsed = JSON.parse(content);
+    const entry = parsed[PLEXUS_PROVIDER_ID];
+    if (typeof entry === "object" && entry !== null && entry.type === "api" && typeof entry.key === "string") {
+      return entry;
+    }
+    return;
+  } catch {
+    return;
+  }
+}
 function resolveConfigTemplate(value) {
   let result = "";
   let index = 0;
@@ -466,8 +497,8 @@ function raceWithTimeout(promise, timeoutMs) {
     });
   });
 }
-function refreshModels(client, baseURL, log, apiKey) {
-  if (lastRefresh && Date.now() - lastRefresh.at < REFRESH_TTL_MS) {
+function refreshModels(client, baseURL, log, apiKey, force = false) {
+  if (!force && lastRefresh && Date.now() - lastRefresh.at < REFRESH_TTL_MS) {
     log.info(`Using in-memory plexus model cache (${Object.keys(lastRefresh.models).length} models)`);
     return Promise.resolve(lastRefresh.models);
   }
@@ -530,10 +561,15 @@ var PlexusProviderPlugin = async (ctx) => {
       const mergedOptions = merged["options"];
       delete mergedOptions["baseURL"];
       if (baseURL) {
-        log.info("Plexus baseURL configured; live discovery delegated to provider.models hook");
+        log.info("Plexus baseURL configured; run /plexus-refresh to force a live model refresh");
       } else {
         log.info("Plexus baseURL not configured; skipping live refresh");
       }
+      cfg.command ??= {};
+      cfg.command[PLEXUS_REFRESH_COMMAND] ??= {
+        template: "Refreshing Plexus models from the live server...",
+        description: "Force a live refresh of Plexus models and rewrite the on-disk cache"
+      };
       try {
         const mergedModels = merged["models"];
         for (const id of ["gemini-3.5-flash", "claude-haiku-4-5", "small-fast"]) {
@@ -574,6 +610,28 @@ var PlexusProviderPlugin = async (ctx) => {
         return cached ? toRuntimeModels(cached, provider) : {};
       }
     },
+    "command.execute.before": async (input, output) => {
+      if (input.command !== PLEXUS_REFRESH_COMMAND)
+        return;
+      const configResponse = await client.config.get();
+      const provider = configResponse.data?.provider?.[PLEXUS_PROVIDER_ID];
+      const storedAuth = await readStoredAuth();
+      const { baseURL, apiKey } = resolveConfig(provider, storedAuth?.metadata);
+      const key = storedAuth?.key ?? apiKey;
+      const textPart = (text) => ({ type: "text", text, synthetic: true });
+      if (!baseURL) {
+        output.parts = [textPart("Plexus refresh failed: no baseURL configured. Run /connect first.")];
+        return;
+      }
+      try {
+        const models = await refreshModels(client, baseURL, log, key, true);
+        output.parts = [
+          textPart(`Plexus models refreshed: ${Object.keys(models).length} models fetched from ${baseURL} and cached. Restart OpenCode to pick up the new model list.`)
+        ];
+      } catch (e) {
+        output.parts = [textPart(`Plexus refresh failed: ${String(e)}. Existing cache left untouched.`)];
+      }
+    },
     auth: {
       provider: PLEXUS_PROVIDER_ID,
       async loader(getAuth, providerInfo) {
@@ -637,6 +695,7 @@ export {
   buildModels,
   REFRESH_TTL_MS,
   PlexusProviderPlugin,
+  PLEXUS_REFRESH_COMMAND,
   PLEXUS_PROVIDER_NAME,
   PLEXUS_PROVIDER_ID,
   PLEXUS_PLUGIN_ID,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mcowger/opencode-plexus",
-	"version": "1.1.1",
+	"version": "1.2.0",
 	"description": "OpenCode plugin: Plexus provider with dynamic model discovery",
 	"type": "module",
 	"module": "./dist/index.js",