@vheins/opencode-9router 0.4.0 → 0.4.2

package/README.md

@@ -8,7 +8,8 @@ Mendaftarkan 9Router sebagai custom provider di OpenCode dengan auto-discovery m
 
 ```json
 {
-  "plugin": ["@vheins/opencode-9router"]
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@vheins/opencode-9router@latest"]
 }
 ```
 
@@ -21,10 +22,11 @@ Mendaftarkan 9Router sebagai custom provider di OpenCode dengan auto-discovery m
 ## Features
 
 - **Auto-discover models** — Models dari 9Router otomatis terdeteksi saat startup
-- **Configurable baseURL** — Atur Base URL langsung dari `/connect`, bukan dari opencode.json
+- **Configurable baseURL** — Atur Base URL via `/connect`, plugin options, atau environment variable
 - **Dynamic model list** — Semua model dari 9Router tersedia, termasuk combo kustom
 - **27+ fallback models** — Well-known models tersedia jika 9Router belum running
 - **OpenAI-compatible** — Menggunakan `@ai-sdk/openai-compatible`
+- **Type-safe** — Menggunakan `config` hook untuk registrasi provider yang sesuai dengan OpenCode config schema
 
 ## Installation
 
@@ -32,14 +34,18 @@ Mendaftarkan 9Router sebagai custom provider di OpenCode dengan auto-discovery m
 
 ```json
 {
-  "plugin": ["@vheins/opencode-9router"]
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@vheins/opencode-9router@latest"]
 }
 ```
 
+Tidak perlu mendefinisikan models atau provider secara manual — plugin mendaftarkan semuanya otomatis.
+
 ### Local file
 
 ```bash
 cp src/plugin.ts .opencode/plugins/9router-provider.ts
+cp src/constants.ts .opencode/plugins/constants.ts
 ```
 
 ## Usage
@@ -63,23 +69,24 @@ cp src/plugin.ts .opencode/plugins/9router-provider.ts
 
 ### Custom Base URL
 
-Jika 9Router berjalan di host/port berbeda, masukkan URL saat `/connect`:
+Jika 9Router berjalan di host/port berbeda, ada 3 cara konfigurasi:
 
-```
-Base URL: http://192.168.1.100:20128
-```
+#### Via `/connect` (recommended)
 
-Atau via plugin options:
+Masukkan URL custom saat diminta Base URL.
+
+#### Via plugin options
 
 ```json
 {
+  "$schema": "https://opencode.ai/config.json",
   "plugin": [
-    ["@vheins/opencode-9router", { "baseURL": "http://192.168.1.100:20128" }]
+    ["@vheins/opencode-9router@latest", { "baseURL": "http://192.168.1.100:20128" }]
   ]
 }
 ```
 
-Atau via environment variable:
+#### Via environment variable
 
 ```bash
 export ROUTER_BASE_URL=http://192.168.1.100:20128
@@ -106,14 +113,17 @@ export ROUTER_BASE_URL=http://192.168.1.100:20128
 ## How It Works
 
 ```
-opencode.json "plugin": ["@vheins/opencode-9router"]
+opencode.json "plugin": ["@vheins/opencode-9router@latest"]
   ↓
 Bun installs package from npm
   ↓
 Plugin loads at startup:
-  1. Try GET /v1/models from 9Router (3s timeout)
-  2. If OK → register live models
-  3. If fail → register 27 fallback models
+  1. Resolve baseURL (options > env > default)
+  2. Try GET /v1/models from 9Router (3s timeout)
+  3. If OK → register live models
+  4. If fail → register 27 fallback models
+  ↓
+config hook injects provider "9router" into OpenCode config
   ↓
 Provider "9router" appears in /models
   ↓
@@ -127,7 +137,14 @@ Auth loader overrides provider config with user's baseURL
 ```bash
 git clone https://github.com/vheins/opencode-9router
 cd opencode-9router
-bun install
+npm install
+npm run build
+```
+
+### Test
+
+```bash
+node test-minimal.mjs
 ```
 
 ### Publish
@@ -141,10 +158,10 @@ npm publish --access public
 
 ```
 opencode-9router/
-  index.ts            # Re-exports
   src/
     plugin.ts         # Main plugin logic
     constants.ts      # Models, defaults, prefixes
+  dist/               # Compiled output (generated)
   package.json        # npm package config
   tsconfig.json       # TypeScript config
   README.md           # This file

package/dist/plugin.js

@@ -1,4 +1,4 @@
-import { PLUGIN_NAME, PROVIDER_DISPLAY_NAME, DEFAULT_BASE_URL, DEFAULT_API_PATH, FALLBACK_MODELS, KNOWN_PROVIDER_PREFIXES, } from "./constants.js";
+import { PLUGIN_NAME, PROVIDER_DISPLAY_NAME, DEFAULT_BASE_URL, DEFAULT_API_PATH, KNOWN_PROVIDER_PREFIXES, } from "./constants.js";
 function formatModelName(modelId) {
     for (const [prefix, provider] of Object.entries(KNOWN_PROVIDER_PREFIXES)) {
         if (modelId.startsWith(prefix)) {
@@ -7,8 +7,24 @@ function formatModelName(modelId) {
     }
     return modelId;
 }
+function normalizeBaseURL(url) {
+    return url.replace(/\/+$/, "");
+}
+function resolveBaseURL(options) {
+    if (options?.baseURL && typeof options.baseURL === "string") {
+        return normalizeBaseURL(options.baseURL);
+    }
+    const envURL = globalThis.process;
+    if (envURL?.env?.ROUTER_BASE_URL) {
+        return normalizeBaseURL(envURL.env.ROUTER_BASE_URL);
+    }
+    return DEFAULT_BASE_URL;
+}
+function ensureAPIPath(baseURL) {
+    return baseURL.endsWith(DEFAULT_API_PATH) ? baseURL : `${baseURL}${DEFAULT_API_PATH}`;
+}
 async function discoverModels(baseURL) {
-    const apiURL = `${baseURL}${DEFAULT_API_PATH}`;
+    const apiURL = ensureAPIPath(baseURL);
     try {
         const response = await fetch(`${apiURL}/models`, {
             signal: AbortSignal.timeout(3000),
@@ -29,36 +45,37 @@ async function discoverModels(baseURL) {
         return null;
     }
 }
-export const NineRouterPlugin = async ({ client }) => {
-    const configuredBaseURL = DEFAULT_BASE_URL;
+export const NineRouterPlugin = async ({ client }, options) => {
+    const configuredBaseURL = resolveBaseURL(options);
     const discovered = await discoverModels(configuredBaseURL);
-    const models = discovered ?? FALLBACK_MODELS;
     if (!discovered && client?.app?.log) {
         await client.app.log({
             body: {
                 service: "9router-provider",
-                level: "warn",
-                message: `9Router not reachable at ${configuredBaseURL}. Using well-known model list. Start 9Router and restart opencode to auto-discover models.`,
+                level: "error",
+                message: `9Router not reachable at ${configuredBaseURL}. Please check if 9Router is running and accessible.`,
             },
         });
     }
     return {
-        provider: {
-            [PLUGIN_NAME]: {
+        config: async (config) => {
+            config.provider ??= {};
+            config.provider[PLUGIN_NAME] = {
                 npm: "@ai-sdk/openai-compatible",
                 name: PROVIDER_DISPLAY_NAME,
                 options: {
-                    baseURL: `${configuredBaseURL}${DEFAULT_API_PATH}`,
+                    baseURL: ensureAPIPath(configuredBaseURL),
                 },
-                models,
-            },
+                models: discovered ?? {},
+            };
         },
         auth: {
             provider: PLUGIN_NAME,
             async loader(getAuth) {
                 const auth = await getAuth();
                 if (auth && typeof auth === "object" && "baseURL" in auth) {
-                    return { baseURL: `${String(auth.baseURL)}${DEFAULT_API_PATH}` };
+                    const userURL = normalizeBaseURL(String(auth.baseURL));
+                    return { baseURL: ensureAPIPath(userURL) };
                 }
                 return {};
             },
@@ -71,12 +88,6 @@ export const NineRouterPlugin = async ({ client }) => {
                             type: "text",
                             message: `${PROVIDER_DISPLAY_NAME} Base URL (default: ${DEFAULT_BASE_URL})`,
                             key: "baseURL",
-                            default: DEFAULT_BASE_URL,
-                        },
-                        {
-                            type: "text",
-                            message: `${PROVIDER_DISPLAY_NAME} API Key (from Dashboard → Endpoints)`,
-                            key: "apiKey",
                         },
                     ],
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vheins/opencode-9router",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "OpenCode plugin provider for 9Router — FREE AI Router & Token Saver. 40+ providers, 100+ models.",
   "author": "vheins",
   "keywords": [