@subrouter/opencode 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OpenCode plugin that registers the `subrouter` provider.
+ *
+ * The config hook injects a custom provider whose npm field points at this
+ * package's provider module (file:// URL, so opencode never installs anything).
+ * Each subrouter preset becomes a model: pick `subrouter/default` (or any
+ * preset created with `subrouter preset create`) in opencode.
+ *
+ * NOTE: only plugin initializer functions may be exported from this module.
+ * OpenCode calls every export as a plugin.
+ */
+import type { Plugin } from '@opencode-ai/plugin';
+export declare const subrouterPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAQjD,eAAO,MAAM,eAAe,EAAE,MA+B7B,CAAA"}

package/dist/index.js

@@ -0,0 +1,46 @@
+/**
+ * OpenCode plugin that registers the `subrouter` provider.
+ *
+ * The config hook injects a custom provider whose npm field points at this
+ * package's provider module (file:// URL, so opencode never installs anything).
+ * Each subrouter preset becomes a model: pick `subrouter/default` (or any
+ * preset created with `subrouter preset create`) in opencode.
+ *
+ * NOTE: only plugin initializer functions may be exported from this module.
+ * OpenCode calls every export as a plugin.
+ */
+import { DEFAULT_PRESET_NAME, loadPresets } from '@subrouter/cli';
+function providerEntryUrl() {
+    const isDev = import.meta.url.endsWith('.ts');
+    return new URL(isDev ? './provider.ts' : './provider.js', import.meta.url).href;
+}
+export const subrouterPlugin = async () => {
+    return {
+        config: async (config) => {
+            const presets = await loadPresets().catch(() => {
+                return { version: 1, presets: {} };
+            });
+            const names = new Set([DEFAULT_PRESET_NAME, ...Object.keys(presets.presets)]);
+            const models = Object.fromEntries([...names].map((name) => [
+                name,
+                {
+                    name: `subrouter ${name}`,
+                    tool_call: true,
+                    attachment: false,
+                    reasoning: false,
+                    cost: { input: 0, output: 0, cache_read: 0, cache_write: 0 },
+                    limit: { context: 200_000, output: 64_000 },
+                },
+            ]));
+            config.provider = {
+                ...config.provider,
+                subrouter: {
+                    name: 'Subrouter',
+                    npm: providerEntryUrl(),
+                    models,
+                    options: {},
+                },
+            };
+        },
+    };
+};

package/dist/opencode-e2e.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * End-to-end test: a real opencode server drives the subrouter provider.
+ *
+ * No real API requests. Fake HTTP servers play the provider endpoints:
+ * anthropic always answers 429 (rate limited), the opencode zen mock streams
+ * a canned completion. The test prompts opencode with model subrouter/default
+ * and asserts the reply came from the fallback provider, proving the cycling
+ * works through the whole opencode -> provider -> router pipeline.
+ *
+ * Requires built dist (pnpm build) because opencode loads dist/provider.js.
+ */
+export {};
+//# sourceMappingURL=opencode-e2e.test.d.ts.map

package/dist/opencode-e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-e2e.test.d.ts","sourceRoot":"","sources":["../src/opencode-e2e.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/opencode-e2e.test.js

@@ -0,0 +1,207 @@
+/**
+ * End-to-end test: a real opencode server drives the subrouter provider.
+ *
+ * No real API requests. Fake HTTP servers play the provider endpoints:
+ * anthropic always answers 429 (rate limited), the opencode zen mock streams
+ * a canned completion. The test prompts opencode with model subrouter/default
+ * and asserts the reply came from the fallback provider, proving the cycling
+ * works through the whole opencode -> provider -> router pipeline.
+ *
+ * Requires built dist (pnpm build) because opencode loads dist/provider.js.
+ */
+import { createOpencodeClient } from '@opencode-ai/sdk';
+import { createOpencodeServer } from '@opencode-ai/sdk/server';
+import { createServer } from 'node:http';
+import { mkdtemp, rm, writeFile, mkdir } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { afterAll, beforeAll, describe, expect, test } from 'vitest';
+async function startMockServer(handler) {
+    const requests = [];
+    const server = createServer((req, res) => {
+        let body = '';
+        req.on('data', (chunk) => {
+            body += String(chunk);
+        });
+        req.on('end', () => {
+            requests.push(req.url ?? '');
+            handler({ path: req.url ?? '', body }, res);
+        });
+    });
+    await new Promise((resolve) => {
+        server.listen(0, '127.0.0.1', () => {
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === 'string')
+        throw new Error('no address');
+    return {
+        url: `http://127.0.0.1:${address.port}`,
+        requests,
+        close: async () => {
+            await new Promise((resolve) => {
+                server.close(() => {
+                    resolve();
+                });
+            });
+        },
+    };
+}
+function sseChunk(data) {
+    return `data: ${JSON.stringify(data)}\n\n`;
+}
+let home;
+let projectDir;
+let anthropicMock;
+let zenMock;
+let server;
+const savedEnv = {};
+beforeAll(async () => {
+    home = await mkdtemp(path.join(tmpdir(), 'subrouter-e2e-'));
+    projectDir = path.join(home, 'project');
+    await mkdir(projectDir, { recursive: true });
+    // Fake anthropic: always rate limited
+    anthropicMock = await startMockServer((_request, res) => {
+        res.writeHead(429, { 'content-type': 'application/json' });
+        res.end(JSON.stringify({ type: 'error', error: { type: 'rate_limit_error', message: 'rate limited' } }));
+    });
+    // Fake opencode zen: streams a canned completion
+    zenMock = await startMockServer(({ body }, res) => {
+        const streaming = body.includes('"stream":true');
+        if (!streaming) {
+            res.writeHead(200, { 'content-type': 'application/json' });
+            res.end(JSON.stringify({
+                id: 'chatcmpl-1',
+                object: 'chat.completion',
+                created: 1,
+                model: 'fake-model',
+                choices: [
+                    { index: 0, message: { role: 'assistant', content: 'hello from fallback' }, finish_reason: 'stop' },
+                ],
+                usage: { prompt_tokens: 1, completion_tokens: 2, total_tokens: 3 },
+            }));
+            return;
+        }
+        res.writeHead(200, { 'content-type': 'text/event-stream' });
+        res.write(sseChunk({
+            id: '1',
+            object: 'chat.completion.chunk',
+            created: 1,
+            model: 'fake-model',
+            choices: [
+                { index: 0, delta: { role: 'assistant', content: 'hello from fallback' }, finish_reason: null },
+            ],
+        }));
+        res.write(sseChunk({
+            id: '1',
+            object: 'chat.completion.chunk',
+            created: 1,
+            model: 'fake-model',
+            choices: [{ index: 0, delta: {}, finish_reason: 'stop' }],
+            usage: { prompt_tokens: 1, completion_tokens: 2, total_tokens: 3 },
+        }));
+        res.write('data: [DONE]\n\n');
+        res.end();
+    });
+    // Subrouter state: one rate-limited anthropic account + one zen key
+    const subrouterHome = path.join(home, 'subrouter');
+    await mkdir(subrouterHome, { recursive: true });
+    await writeFile(path.join(subrouterHome, 'accounts.json'), JSON.stringify({
+        version: 1,
+        providers: {
+            anthropic: {
+                activeIndex: 0,
+                accounts: [
+                    {
+                        type: 'oauth',
+                        refresh: 'fake-refresh',
+                        access: 'fake-access',
+                        expires: Date.now() + 1_000_000_000,
+                        email: 'a@x.com',
+                        addedAt: 1,
+                        lastUsed: 1,
+                    },
+                ],
+            },
+            opencode: {
+                activeIndex: 0,
+                accounts: [{ type: 'api', key: 'zen-key', addedAt: 1, lastUsed: 1 }],
+            },
+        },
+    }));
+    for (const [key, value] of Object.entries({
+        SUBROUTER_HOME: subrouterHome,
+        SUBROUTER_ANTHROPIC_BASE_URL: `${anthropicMock.url}/v1`,
+        SUBROUTER_OPENCODE_BASE_URL: `${zenMock.url}/v1`,
+        // Isolate opencode from the user's real global config and auth
+        XDG_CONFIG_HOME: path.join(home, 'xdg-config'),
+        XDG_DATA_HOME: path.join(home, 'xdg-data'),
+        XDG_CACHE_HOME: path.join(home, 'xdg-cache'),
+        XDG_STATE_HOME: path.join(home, 'xdg-state'),
+    })) {
+        savedEnv[key] = process.env[key];
+        process.env[key] = value;
+    }
+    const providerEntry = pathToFileURL(path.join(import.meta.dirname, '..', 'dist', 'provider.js')).href;
+    server = await createOpencodeServer({
+        port: 0,
+        timeout: 60_000,
+        config: {
+            provider: {
+                subrouter: {
+                    name: 'Subrouter',
+                    npm: providerEntry,
+                    models: {
+                        default: {
+                            name: 'subrouter default',
+                            tool_call: true,
+                            cost: { input: 0, output: 0, cache_read: 0, cache_write: 0 },
+                            limit: { context: 200_000, output: 64_000 },
+                        },
+                    },
+                },
+            },
+        },
+    });
+}, 120_000);
+afterAll(async () => {
+    server?.close();
+    await anthropicMock?.close();
+    await zenMock?.close();
+    for (const [key, value] of Object.entries(savedEnv)) {
+        if (value === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = value;
+    }
+    await rm(home, { recursive: true, force: true });
+});
+describe('opencode + subrouter provider', () => {
+    test('rate-limited provider is cycled to the fallback through opencode', async () => {
+        const client = createOpencodeClient({ baseUrl: server.url });
+        const session = await client.session.create({
+            query: { directory: projectDir },
+            body: { title: 'subrouter e2e' },
+        });
+        expect(session.data).toBeTruthy();
+        const result = await client.session.prompt({
+            path: { id: session.data.id },
+            query: { directory: projectDir },
+            body: {
+                model: { providerID: 'subrouter', modelID: 'default' },
+                parts: [{ type: 'text', text: 'say hi' }],
+            },
+        });
+        const parts = result.data?.parts ?? [];
+        const texts = parts
+            .filter((part) => part.type === 'text')
+            .map((part) => part.text)
+            .join('\n');
+        expect(texts).toContain('hello from fallback');
+        // The anthropic mock was tried first and rate limited
+        expect(anthropicMock.requests.length).toBeGreaterThan(0);
+        expect(zenMock.requests.length).toBeGreaterThan(0);
+    }, 120_000);
+});

package/dist/plugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.test.d.ts.map

package/dist/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../src/plugin.test.ts"],"names":[],"mappings":""}

package/dist/plugin.test.js

@@ -0,0 +1,26 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, expect, test } from 'vitest';
+import { subrouterPlugin } from "./index.js";
+let home;
+beforeEach(async () => {
+    home = await mkdtemp(path.join(tmpdir(), 'subrouter-plugin-'));
+    process.env.SUBROUTER_HOME = home;
+});
+afterEach(async () => {
+    delete process.env.SUBROUTER_HOME;
+    await rm(home, { recursive: true, force: true });
+});
+test('config hook registers the subrouter provider with preset models', async () => {
+    await writeFile(path.join(home, 'presets.json'), JSON.stringify({ version: 1, presets: { work: ['anthropic/claude-opus-4-6'] } }));
+    const hooks = await subrouterPlugin({});
+    const config = {};
+    await hooks.config?.(config);
+    const provider = config.provider?.subrouter;
+    expect(provider).toBeTruthy();
+    expect(provider.npm.startsWith('file://')).toBe(true);
+    expect(provider.npm.endsWith('provider.ts') || provider.npm.endsWith('provider.js')).toBe(true);
+    expect(Object.keys(provider.models).sort()).toEqual(['default', 'work']);
+    expect(provider.models.default.cost).toEqual({ input: 0, output: 0, cache_read: 0, cache_write: 0 });
+});

package/dist/provider.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Provider entry loaded by opencode via `provider.subrouter.npm` (file:// URL).
+ * OpenCode imports this module, calls the first export starting with `create`,
+ * then `sdk.languageModel(modelId)` where modelId is a subrouter preset name.
+ */
+export { createSubrouter } from '@subrouter/cli';
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/provider.js

@@ -0,0 +1,6 @@
+/**
+ * Provider entry loaded by opencode via `provider.subrouter.npm` (file:// URL).
+ * OpenCode imports this module, calls the first export starting with `create`,
+ * then `sdk.languageModel(modelId)` where modelId is a subrouter preset name.
+ */
+export { createSubrouter } from '@subrouter/cli';

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@subrouter/opencode",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "OpenCode plugin that registers the subrouter provider: cycle through your personal AI subscriptions when one hits rate limits.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/remorses/subrouter.git",
+    "directory": "opencode"
+  },
+  "homepage": "https://github.com/remorses/subrouter",
+  "bugs": "https://github.com/remorses/subrouter/issues",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "ai",
+    "router",
+    "subscriptions"
+  ],
+  "files": [
+    "src",
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "default": "./dist/provider.js"
+    },
+    "./src": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./src/*": {
+      "types": "./src/*.ts",
+      "default": "./src/*.ts"
+    }
+  },
+  "dependencies": {
+    "errore": "^0.14.1",
+    "@subrouter/cli": "^0.1.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.18.23",
+    "@opencode-ai/sdk": "^1.18.23",
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.0.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,52 @@
+/**
+ * OpenCode plugin that registers the `subrouter` provider.
+ *
+ * The config hook injects a custom provider whose npm field points at this
+ * package's provider module (file:// URL, so opencode never installs anything).
+ * Each subrouter preset becomes a model: pick `subrouter/default` (or any
+ * preset created with `subrouter preset create`) in opencode.
+ *
+ * NOTE: only plugin initializer functions may be exported from this module.
+ * OpenCode calls every export as a plugin.
+ */
+
+import type { Plugin } from '@opencode-ai/plugin'
+import { DEFAULT_PRESET_NAME, loadPresets } from '@subrouter/cli'
+
+function providerEntryUrl() {
+  const isDev = import.meta.url.endsWith('.ts')
+  return new URL(isDev ? './provider.ts' : './provider.js', import.meta.url).href
+}
+
+export const subrouterPlugin: Plugin = async () => {
+  return {
+    config: async (config) => {
+      const presets = await loadPresets().catch(() => {
+        return { version: 1 as const, presets: {} }
+      })
+      const names = new Set([DEFAULT_PRESET_NAME, ...Object.keys(presets.presets)])
+      const models = Object.fromEntries(
+        [...names].map((name) => [
+          name,
+          {
+            name: `subrouter ${name}`,
+            tool_call: true,
+            attachment: false,
+            reasoning: false,
+            cost: { input: 0, output: 0, cache_read: 0, cache_write: 0 },
+            limit: { context: 200_000, output: 64_000 },
+          },
+        ]),
+      )
+      config.provider = {
+        ...config.provider,
+        subrouter: {
+          name: 'Subrouter',
+          npm: providerEntryUrl(),
+          models,
+          options: {},
+        },
+      }
+    },
+  }
+}

package/src/opencode-e2e.test.ts

@@ -0,0 +1,240 @@
+/**
+ * End-to-end test: a real opencode server drives the subrouter provider.
+ *
+ * No real API requests. Fake HTTP servers play the provider endpoints:
+ * anthropic always answers 429 (rate limited), the opencode zen mock streams
+ * a canned completion. The test prompts opencode with model subrouter/default
+ * and asserts the reply came from the fallback provider, proving the cycling
+ * works through the whole opencode -> provider -> router pipeline.
+ *
+ * Requires built dist (pnpm build) because opencode loads dist/provider.js.
+ */
+
+import { createOpencodeClient } from '@opencode-ai/sdk'
+import { createOpencodeServer } from '@opencode-ai/sdk/server'
+import { createServer, type Server } from 'node:http'
+import { mkdtemp, rm, writeFile, mkdir } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { afterAll, beforeAll, describe, expect, test } from 'vitest'
+
+type MockServer = {
+  url: string
+  requests: string[]
+  close: () => Promise<void>
+}
+
+async function startMockServer(
+  handler: (args: { path: string; body: string }, res: import('node:http').ServerResponse) => void,
+): Promise<MockServer> {
+  const requests: string[] = []
+  const server: Server = createServer((req, res) => {
+    let body = ''
+    req.on('data', (chunk) => {
+      body += String(chunk)
+    })
+    req.on('end', () => {
+      requests.push(req.url ?? '')
+      handler({ path: req.url ?? '', body }, res)
+    })
+  })
+  await new Promise<void>((resolve) => {
+    server.listen(0, '127.0.0.1', () => {
+      resolve()
+    })
+  })
+  const address = server.address()
+  if (!address || typeof address === 'string') throw new Error('no address')
+  return {
+    url: `http://127.0.0.1:${address.port}`,
+    requests,
+    close: async () => {
+      await new Promise<void>((resolve) => {
+        server.close(() => {
+          resolve()
+        })
+      })
+    },
+  }
+}
+
+function sseChunk(data: unknown) {
+  return `data: ${JSON.stringify(data)}\n\n`
+}
+
+let home: string
+let projectDir: string
+let anthropicMock: MockServer
+let zenMock: MockServer
+let server: { url: string; close: () => void }
+const savedEnv: Record<string, string | undefined> = {}
+
+beforeAll(async () => {
+  home = await mkdtemp(path.join(tmpdir(), 'subrouter-e2e-'))
+  projectDir = path.join(home, 'project')
+  await mkdir(projectDir, { recursive: true })
+
+  // Fake anthropic: always rate limited
+  anthropicMock = await startMockServer((_request, res) => {
+    res.writeHead(429, { 'content-type': 'application/json' })
+    res.end(JSON.stringify({ type: 'error', error: { type: 'rate_limit_error', message: 'rate limited' } }))
+  })
+
+  // Fake opencode zen: streams a canned completion
+  zenMock = await startMockServer(({ body }, res) => {
+    const streaming = body.includes('"stream":true')
+    if (!streaming) {
+      res.writeHead(200, { 'content-type': 'application/json' })
+      res.end(
+        JSON.stringify({
+          id: 'chatcmpl-1',
+          object: 'chat.completion',
+          created: 1,
+          model: 'fake-model',
+          choices: [
+            { index: 0, message: { role: 'assistant', content: 'hello from fallback' }, finish_reason: 'stop' },
+          ],
+          usage: { prompt_tokens: 1, completion_tokens: 2, total_tokens: 3 },
+        }),
+      )
+      return
+    }
+    res.writeHead(200, { 'content-type': 'text/event-stream' })
+    res.write(
+      sseChunk({
+        id: '1',
+        object: 'chat.completion.chunk',
+        created: 1,
+        model: 'fake-model',
+        choices: [
+          { index: 0, delta: { role: 'assistant', content: 'hello from fallback' }, finish_reason: null },
+        ],
+      }),
+    )
+    res.write(
+      sseChunk({
+        id: '1',
+        object: 'chat.completion.chunk',
+        created: 1,
+        model: 'fake-model',
+        choices: [{ index: 0, delta: {}, finish_reason: 'stop' }],
+        usage: { prompt_tokens: 1, completion_tokens: 2, total_tokens: 3 },
+      }),
+    )
+    res.write('data: [DONE]\n\n')
+    res.end()
+  })
+
+  // Subrouter state: one rate-limited anthropic account + one zen key
+  const subrouterHome = path.join(home, 'subrouter')
+  await mkdir(subrouterHome, { recursive: true })
+  await writeFile(
+    path.join(subrouterHome, 'accounts.json'),
+    JSON.stringify({
+      version: 1,
+      providers: {
+        anthropic: {
+          activeIndex: 0,
+          accounts: [
+            {
+              type: 'oauth',
+              refresh: 'fake-refresh',
+              access: 'fake-access',
+              expires: Date.now() + 1_000_000_000,
+              email: 'a@x.com',
+              addedAt: 1,
+              lastUsed: 1,
+            },
+          ],
+        },
+        opencode: {
+          activeIndex: 0,
+          accounts: [{ type: 'api', key: 'zen-key', addedAt: 1, lastUsed: 1 }],
+        },
+      },
+    }),
+  )
+
+  for (const [key, value] of Object.entries({
+    SUBROUTER_HOME: subrouterHome,
+    SUBROUTER_ANTHROPIC_BASE_URL: `${anthropicMock.url}/v1`,
+    SUBROUTER_OPENCODE_BASE_URL: `${zenMock.url}/v1`,
+    // Isolate opencode from the user's real global config and auth
+    XDG_CONFIG_HOME: path.join(home, 'xdg-config'),
+    XDG_DATA_HOME: path.join(home, 'xdg-data'),
+    XDG_CACHE_HOME: path.join(home, 'xdg-cache'),
+    XDG_STATE_HOME: path.join(home, 'xdg-state'),
+  })) {
+    savedEnv[key] = process.env[key]
+    process.env[key] = value
+  }
+
+  const providerEntry = pathToFileURL(
+    path.join(import.meta.dirname, '..', 'dist', 'provider.js'),
+  ).href
+
+  server = await createOpencodeServer({
+    port: 0,
+    timeout: 60_000,
+    config: {
+      provider: {
+        subrouter: {
+          name: 'Subrouter',
+          npm: providerEntry,
+          models: {
+            default: {
+              name: 'subrouter default',
+              tool_call: true,
+              cost: { input: 0, output: 0, cache_read: 0, cache_write: 0 },
+              limit: { context: 200_000, output: 64_000 },
+            },
+          },
+        },
+      },
+    },
+  })
+}, 120_000)
+
+afterAll(async () => {
+  server?.close()
+  await anthropicMock?.close()
+  await zenMock?.close()
+  for (const [key, value] of Object.entries(savedEnv)) {
+    if (value === undefined) delete process.env[key]
+    else process.env[key] = value
+  }
+  await rm(home, { recursive: true, force: true })
+})
+
+describe('opencode + subrouter provider', () => {
+  test('rate-limited provider is cycled to the fallback through opencode', async () => {
+    const client = createOpencodeClient({ baseUrl: server.url })
+
+    const session = await client.session.create({
+      query: { directory: projectDir },
+      body: { title: 'subrouter e2e' },
+    })
+    expect(session.data).toBeTruthy()
+
+    const result = await client.session.prompt({
+      path: { id: session.data!.id },
+      query: { directory: projectDir },
+      body: {
+        model: { providerID: 'subrouter', modelID: 'default' },
+        parts: [{ type: 'text', text: 'say hi' }],
+      },
+    })
+
+    const parts = result.data?.parts ?? []
+    const texts = parts
+      .filter((part) => part.type === 'text')
+      .map((part) => (part as { text: string }).text)
+      .join('\n')
+    expect(texts).toContain('hello from fallback')
+
+    // The anthropic mock was tried first and rate limited
+    expect(anthropicMock.requests.length).toBeGreaterThan(0)
+    expect(zenMock.requests.length).toBeGreaterThan(0)
+  }, 120_000)
+})

package/src/plugin.test.ts

@@ -0,0 +1,36 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import path from 'node:path'
+import { afterEach, beforeEach, expect, test } from 'vitest'
+import type { PluginInput } from '@opencode-ai/plugin'
+import { subrouterPlugin } from './index.ts'
+
+let home: string
+
+beforeEach(async () => {
+  home = await mkdtemp(path.join(tmpdir(), 'subrouter-plugin-'))
+  process.env.SUBROUTER_HOME = home
+})
+
+afterEach(async () => {
+  delete process.env.SUBROUTER_HOME
+  await rm(home, { recursive: true, force: true })
+})
+
+test('config hook registers the subrouter provider with preset models', async () => {
+  await writeFile(
+    path.join(home, 'presets.json'),
+    JSON.stringify({ version: 1, presets: { work: ['anthropic/claude-opus-4-6'] } }),
+  )
+
+  const hooks = await subrouterPlugin({} as PluginInput)
+  const config: Record<string, any> = {}
+  await hooks.config?.(config as any)
+
+  const provider = config.provider?.subrouter
+  expect(provider).toBeTruthy()
+  expect(provider.npm.startsWith('file://')).toBe(true)
+  expect(provider.npm.endsWith('provider.ts') || provider.npm.endsWith('provider.js')).toBe(true)
+  expect(Object.keys(provider.models).sort()).toEqual(['default', 'work'])
+  expect(provider.models.default.cost).toEqual({ input: 0, output: 0, cache_read: 0, cache_write: 0 })
+})

package/src/provider.ts

@@ -0,0 +1,7 @@
+/**
+ * Provider entry loaded by opencode via `provider.subrouter.npm` (file:// URL).
+ * OpenCode imports this module, calls the first export starting with `create`,
+ * then `sdk.languageModel(modelId)` where modelId is a subrouter preset name.
+ */
+
+export { createSubrouter } from '@subrouter/cli'