@vheins/opencode-9router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vheins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# @vheins/opencode-9router
+
+OpenCode plugin provider for [9Router](https://github.com/decolua/9router) — FREE AI Router & Token Saver. 40+ providers, 100+ models.
+
+Mendaftarkan 9Router sebagai custom provider di OpenCode dengan auto-discovery models dan konfigurasi baseURL via `/connect`.
+
+## Quick Start
+
+```json
+{
+  "plugin": ["@vheins/opencode-9router"]
+}
+```
+
+1. Tambahkan plugin ke `opencode.json`
+2. Restart OpenCode
+3. `/connect` → pilih **Connect to 9Router**
+4. Masukkan Base URL (default: `http://localhost:20128`) dan API Key
+5. `/models` → pilih model 9Router
+
+## Features
+
+- **Auto-discover models** — Models dari 9Router otomatis terdeteksi saat startup
+- **Configurable baseURL** — Atur Base URL langsung dari `/connect`, bukan dari opencode.json
+- **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`
+
+## Installation
+
+### From npm (recommended)
+
+```json
+{
+  "plugin": ["@vheins/opencode-9router"]
+}
+```
+
+### Local file
+
+```bash
+cp src/plugin.ts .opencode/plugins/9router-provider.ts
+```
+
+## Usage
+
+### 1. Connect via `/connect`
+
+```
+/connect
+  → Select: Connect to 9Router
+  → Base URL: http://localhost:20128  (customize if needed)
+  → API Key: [paste from 9Router Dashboard → Endpoints]
+```
+
+### 2. Select model
+
+```
+/models
+  → Find 9Router provider
+  → Pick any model (e.g., kr/claude-sonnet-4.5, cc/claude-opus-4-7)
+```
+
+### Custom Base URL
+
+Jika 9Router berjalan di host/port berbeda, masukkan URL saat `/connect`:
+
+```
+Base URL: http://192.168.1.100:20128
+```
+
+Atau via plugin options:
+
+```json
+{
+  "plugin": [
+    ["@vheins/opencode-9router", { "baseURL": "http://192.168.1.100:20128" }]
+  ]
+}
+```
+
+Atau via environment variable:
+
+```bash
+export ROUTER_BASE_URL=http://192.168.1.100:20128
+```
+
+## Model Prefixes
+
+| Prefix | Provider | Tier |
+|--------|----------|------|
+| `cc/` | Claude Code | Subscription |
+| `cx/` | Codex | Subscription |
+| `gh/` | GitHub Copilot | Subscription |
+| `cu/` | Cursor IDE | Subscription |
+| `kr/` | Kiro AI | **FREE** |
+| `oc/` | OpenCode Free | **FREE** |
+| `vertex/` | Vertex AI | $300 credits |
+| `glm/` | GLM | $0.6/1M |
+| `minimax/` | MiniMax | $0.2/1M |
+| `kimi/` | Kimi | $9/mo flat |
+| `openrouter/` | OpenRouter | API key |
+| `deepseek/` | DeepSeek | API key |
+| `groq/` | Groq | API key |
+
+## How It Works
+
+```
+opencode.json "plugin": ["@vheins/opencode-9router"]
+  ↓
+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
+  ↓
+Provider "9router" appears in /models
+  ↓
+User runs /connect → enters baseURL + API key
+  ↓
+Auth loader overrides provider config with user's baseURL
+```
+
+## Development
+
+```bash
+git clone https://github.com/vheins/opencode-9router
+cd opencode-9router
+bun install
+```
+
+### Publish
+
+```bash
+npm login
+npm publish --access public
+```
+
+## Files
+
+```
+opencode-9router/
+  index.ts            # Re-exports
+  src/
+    plugin.ts         # Main plugin logic
+    constants.ts      # Models, defaults, prefixes
+  package.json        # npm package config
+  tsconfig.json       # TypeScript config
+  README.md           # This file
+  LICENSE             # MIT
+```
+
+## Links
+
+- [OpenCode Plugin Docs](https://opencode.ai/docs/plugins/)
+- [OpenCode Custom Provider](https://opencode.ai/docs/providers/#custom-provider)
+- [9Router GitHub](https://github.com/decolua/9router)
+- [9Router Website](https://9router.com)

package/index.ts

@@ -0,0 +1 @@
+export { default } from "./src/plugin";

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@vheins/opencode-9router",
+  "module": "index.ts",
+  "version": "0.1.0",
+  "description": "OpenCode plugin provider for 9Router — FREE AI Router & Token Saver. 40+ providers, 100+ models.",
+  "author": "vheins",
+  "keywords": [
+    "opencode",
+    "9router",
+    "ai-router",
+    "llm",
+    "provider",
+    "openai-compatible",
+    "token-saver",
+    "plugin"
+  ],
+  "repository": "https://github.com/vheins/opencode-9router",
+  "files": [
+    "index.ts",
+    "src"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@opencode-ai/sdk": "^1.0.182",
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.0.182"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,80 @@
+export const PLUGIN_NAME = "9router";
+export const PROVIDER_DISPLAY_NAME = "9Router";
+export const DEFAULT_BASE_URL = "http://localhost:20128";
+export const DEFAULT_API_PATH = "/v1";
+
+/**
+ * Well-known 9Router models used as fallback when the API is unreachable.
+ * Covers the most common providers and tiers routed through 9Router.
+ */
+export const FALLBACK_MODELS: Record<string, { name: string }> = {
+  // --- Claude Code (Subscription) ---
+  "cc/claude-opus-4-7": { name: "Claude Opus 4.7 (Claude Code)" },
+  "cc/claude-opus-4-6": { name: "Claude Opus 4.6 (Claude Code)" },
+  "cc/claude-sonnet-4-6": { name: "Claude Sonnet 4.6 (Claude Code)" },
+  "cc/claude-haiku-4-5-20251001": { name: "Claude Haiku 4.5 (Claude Code)" },
+
+  // --- OpenCode / Codex (Subscription) ---
+  "cx/gpt-5.5": { name: "GPT-5.5 (Codex)" },
+  "cx/gpt-5.4": { name: "GPT-5.4 (Codex)" },
+
+  // --- GitHub Copilot (Subscription) ---
+  "gh/gpt-5.4": { name: "GPT-5.4 (Copilot)" },
+  "gh/claude-sonnet-4.6": { name: "Claude Sonnet 4.6 (Copilot)" },
+
+  // --- Kiro AI (FREE) ---
+  "kr/claude-sonnet-4.5": { name: "Claude Sonnet 4.5 (Kiro Free)" },
+  "kr/claude-haiku-4.5": { name: "Claude Haiku 4.5 (Kiro Free)" },
+  "kr/glm-5": { name: "GLM-5 (Kiro Free)" },
+  "kr/MiniMax-M2.5": { name: "MiniMax M2.5 (Kiro Free)" },
+  "kr/qwen3-coder-next": { name: "Qwen3 Coder Next (Kiro Free)" },
+  "kr/deepseek-3.2": { name: "DeepSeek 3.2 (Kiro Free)" },
+
+  // --- OpenCode Free (FREE) ---
+  "oc/auto": { name: "OpenCode Free (Auto)" },
+
+  // --- Vertex AI ($300 credits) ---
+  "vertex/gemini-3.1-pro-preview": { name: "Gemini 3.1 Pro (Vertex)" },
+  "vertex/gemini-3-flash-preview": { name: "Gemini 3 Flash (Vertex)" },
+
+  // --- GLM (Cheap, $0.6/1M) ---
+  "glm/glm-5.1": { name: "GLM-5.1" },
+  "glm/glm-5": { name: "GLM-5" },
+  "glm/glm-4.7": { name: "GLM-4.7" },
+
+  // --- MiniMax (Cheapest, $0.2/1M) ---
+  "minimax/MiniMax-M2.7": { name: "MiniMax M2.7" },
+  "minimax/MiniMax-M2.5": { name: "MiniMax M2.5" },
+
+  // --- Kimi ($9/mo flat) ---
+  "kimi/kimi-k2.5": { name: "Kimi K2.5" },
+  "kimi/kimi-k2.5-thinking": { name: "Kimi K2.5 (Thinking)" },
+
+  // --- Cursor (Subscription) ---
+  "cu/claude-4.6-opus-max": { name: "Claude 4.6 Opus Max (Cursor)" },
+
+  // --- Standard Key Providers ---
+  "deepseek/deepseek-chat": { name: "DeepSeek Chat" },
+  "groq/llama-4.5-70b": { name: "Llama 4.5 70B (Groq)" },
+};
+
+/** Known provider prefixes in 9Router model IDs for human-readable naming. */
+export const KNOWN_PROVIDER_PREFIXES: Record<string, string> = {
+  "cc/": "Claude Code",
+  "cx/": "Codex",
+  "gh/": "GitHub Copilot",
+  "kr/": "Kiro AI",
+  "oc/": "OpenCode Free",
+  "vertex/": "Vertex AI",
+  "vertex-partner/": "Vertex Partner",
+  "glm/": "GLM",
+  "minimax/": "MiniMax",
+  "kimi/": "Kimi",
+  "cu/": "Cursor",
+  "gc/": "Gemini CLI",
+  "if/": "iFlow",
+  "qw/": "Qwen",
+  "openrouter/": "OpenRouter",
+  "deepseek/": "DeepSeek",
+  "groq/": "Groq",
+};

package/src/plugin.ts

@@ -0,0 +1,111 @@
+import type { Plugin, PluginInput } from "@opencode-ai/plugin";
+import type { Auth } from "@opencode-ai/sdk";
+import {
+  PLUGIN_NAME,
+  PROVIDER_DISPLAY_NAME,
+  DEFAULT_BASE_URL,
+  DEFAULT_API_PATH,
+  FALLBACK_MODELS,
+  KNOWN_PROVIDER_PREFIXES,
+} from "./constants";
+
+function formatModelName(modelId: string): string {
+  for (const [prefix, provider] of Object.entries(KNOWN_PROVIDER_PREFIXES)) {
+    if (modelId.startsWith(prefix)) {
+      return `${modelId.slice(prefix.length)} (${provider})`;
+    }
+  }
+  return modelId;
+}
+
+async function discoverModels(
+  baseURL: string,
+): Promise<Record<string, { name: string }> | null> {
+  const apiURL = `${baseURL}${DEFAULT_API_PATH}`;
+  try {
+    const response = await fetch(`${apiURL}/models`, {
+      signal: AbortSignal.timeout(3000),
+    });
+    if (!response.ok) return null;
+
+    const data = (await response.json()) as {
+      data?: Array<{ id: string }>;
+    };
+    if (!data.data || !Array.isArray(data.data) || data.data.length === 0) {
+      return null;
+    }
+
+    const models: Record<string, { name: string }> = {};
+    for (const model of data.data) {
+      models[model.id] = { name: formatModelName(model.id) };
+    }
+    return models;
+  } catch {
+    return null;
+  }
+}
+
+const plugin: Plugin = async ({ client }: PluginInput, options?: { baseURL?: string }) => {
+  const configuredBaseURL = options?.baseURL ?? DEFAULT_BASE_URL;
+
+  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.`,
+      },
+    });
+  }
+
+  return {
+    // provider hook: auto-registers 9Router with models — NO manual opencode.json config needed
+    provider: {
+      [PLUGIN_NAME]: {
+        npm: "@ai-sdk/openai-compatible",
+        name: PROVIDER_DISPLAY_NAME,
+        options: {
+          baseURL: `${configuredBaseURL}${DEFAULT_API_PATH}`,
+        },
+        models,
+      },
+    },
+
+    // auth hook: enables /connect flow with configurable baseURL + API key
+    auth: {
+      provider: PLUGIN_NAME,
+      async loader(getAuth: () => Promise<Auth>, _provider: unknown) {
+        const auth = await getAuth();
+        // If user set custom baseURL via /connect, override the provider default
+        if (auth && typeof auth === "object" && "baseURL" in auth) {
+          return { baseURL: `${String(auth.baseURL)}${DEFAULT_API_PATH}` };
+        }
+        return {};
+      },
+      methods: [
+        {
+          label: `Connect to ${PROVIDER_DISPLAY_NAME}`,
+          type: "api",
+          prompts: [
+            {
+              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",
+            },
+          ],
+        },
+      ],
+    },
+  };
+};
+
+export default plugin;