@darknesskiller/opencode-cliproxyapi 0.2.1 → 0.3.1

package/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this project follows [Semantic Versioning](https://semver.org/).
 
+## [0.3.1] - Unreleased
+
+### Fixed
+
+- Image attachments now reach discovered Claude, Gemini, and GPT models.
+  OpenCode only forwards image parts to models that declare image input, and
+  the plugin previously declared it only for `*-image-*` generation models, so
+  other models received a `Cannot read "<file>"` placeholder instead. V1 now
+  sets `modalities: { input: ["text", "image"], output: ["text"] }` and V2
+  sets the matching `capabilities.input`, both from one shared policy.
+  Text-only `gpt-oss-*` models are no longer marked as attachment-capable.
+
+## [0.3.0] - 2026-10-05
+
+### Added
+
+- OpenCode v2 support. The package now default-exports a definition object with
+  `id`, `setup`, and `server`: OpenCode v2 loads it through `setup(ctx)` and
+  registers the provider with `ctx.provider.transform` (discovered catalog,
+  `@opencode/ai/providers/*` driver package, `baseURL`/`apiKey` settings),
+  while OpenCode v1 (1.18.29 and newer) keeps calling `server(ctx)`.
+  Anthropic-endpoint models are routed through
+  `@opencode/ai/providers/anthropic` via the per-model `package` field, and
+  v2 variants list exactly the effort levels the server reported.
+- `index.ts` at the repository root so a local checkout can be used as the
+  plugin path without a build step.
+
 ## [0.2.1] - 2026-09-09
 
 ### Fixed
@@ -63,7 +90,8 @@ and this project follows [Semantic Versioning](https://semver.org/).
 - Automatic model names and capability hints in OpenCode's model picker.
 - Local plugin and npm package installation flows.
 
-[Unreleased]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.2.1...HEAD
+[Unreleased]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.2.1...v0.3.0
 [0.2.1]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.1.2...v0.2.0
 [0.1.2]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.1.1...v0.1.2

package/README.md

@@ -173,6 +173,50 @@ can be customized:
 }
 ```
 
+### OpenCode v2
+
+OpenCode v2 replaced the `plugin` array with `plugins` and no longer runs v1
+plugin code. This package ships a dual entrypoint: v2 calls `setup(ctx)` and
+v1 (1.18.29 and newer) calls `server(ctx)`, so one configuration works on both.
+
+```jsonc
+// OpenCode v2 (~/.config/opencode/opencode.jsonc)
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": [
+    {
+      "package": "@darknesskiller/opencode-cliproxyapi",
+      "options": {
+        "baseURL": "http://your-server:8317",
+        "apiKey": "your-cli-proxy-api-key"
+      }
+    }
+  ]
+}
+```
+
+On v2 the plugin registers the provider itself: it publishes the discovered
+catalog through `ctx.provider.transform`, selects
+`@opencode/ai/providers/openai-compatible` (or `@opencode/ai/providers/openai`
+with `protocol: "responses"`), and routes Anthropic-endpoint models through
+`@opencode/ai/providers/anthropic`. Every option in the table above works
+unchanged inside the plugin entry's `options`.
+
+To run a checkout instead of the published package, point `package` at the
+repository directory (OpenCode resolves its root `index.ts`) and use the local
+path:
+
+```jsonc
+{
+  "plugins": [
+    {
+      "package": "/path/to/opencode-cliproxyapi",
+      "options": { "baseURL": "http://your-server:8317" }
+    }
+  ]
+}
+```
+
 ## Troubleshooting
 
 ### `Missing API key`
@@ -196,6 +240,28 @@ Then restart OpenCode and run:
 opencode models cliproxyapi
 ```
 
+### The model says it cannot read an attached image
+
+CLIProxyAPI's `/v1/models` only reports model ids, so image input is inferred
+from the model family: discovered models whose id starts with `claude`,
+`gemini`, or `gpt` (except text-only `gpt-oss-*`) accept images, and
+`*-image-*` models are treated as image generators. New releases in those
+families are covered automatically. On OpenCode v1, declare the modalities of
+a vision model outside these families under the provider's `models` in
+`opencode.json`; user entries override the discovered metadata:
+
+```jsonc
+{
+  "provider": {
+    "cliproxyapi": {
+      "models": {
+        "your-vision-model": { "attachment": true, "modalities": { "input": ["text", "image"], "output": ["text"] } }
+      }
+    }
+  }
+}
+```
+
 ### Environment configuration works in one terminal but not another
 
 Move the connection to the recommended global OpenCode config, or add the

package/dist/index.d.ts

@@ -1,8 +1,14 @@
 import type { Plugin } from "@opencode-ai/plugin";
+import { setup } from "./plugin-v2.js";
 export declare const CLIProxyAPIPlugin: Plugin;
+/**
+ * Dual V1/V2 entry point. OpenCode V2 calls `setup(ctx)`; V1 (1.18.29 and
+ * newer) calls `server(ctx)` for the classic hooks object.
+ */
 declare const _default: {
     id: string;
     server: Plugin;
+    setup: typeof setup;
 };
 export default _default;
 export { discoverModelProtocols, discoverModels, discoverReasoningEfforts, normalizeBaseURL, parseCatalog, parseModelProtocolCatalog, parseReasoningEffortCatalog, } from "./catalog.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAA+B,MAAM,qBAAqB,CAAA;AAmCtF,eAAO,MAAM,iBAAiB,EAAE,MA8E/B,CAAA;;;;;AAED,wBAGwB;AACxB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAgB,MAAM,qBAAqB,CAAA;AAwBvE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAWtC,eAAO,MAAM,iBAAiB,EAAE,MAiE/B,CAAA;AAED;;;GAGG;;;;;;AACH,wBAIkD;AAClD,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -103,12 +103,185 @@ function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-// src/index.ts
+// src/shared.ts
 var DEFAULT_BASE_URL = "http://localhost:8317/v1";
 var DEFAULT_PROVIDER_ID = "cliproxyapi";
 var DEFAULT_PROVIDER_NAME = "CLIProxyAPI";
 var DEFAULT_DISCOVERY_TIMEOUT_MS = 1e4;
 var DEFAULT_MODEL_METADATA_URL = "https://models.dev/api.json";
+var V1_CHAT_PACKAGE = "@ai-sdk/openai-compatible";
+var V1_RESPONSES_PACKAGE = "@ai-sdk/openai";
+var V1_ANTHROPIC_PACKAGE = "@ai-sdk/anthropic";
+var V2_CHAT_PACKAGE = "@opencode/ai/providers/openai-compatible";
+var V2_RESPONSES_PACKAGE = "@opencode/ai/providers/openai";
+var V2_ANTHROPIC_PACKAGE = "@opencode/ai/providers/anthropic";
+function readOptions(input) {
+  if (!input)
+    return {};
+  return {
+    baseURL: stringOption(input.baseURL),
+    apiKey: stringOption(input.apiKey),
+    providerID: stringOption(input.providerID),
+    providerName: stringOption(input.providerName),
+    protocol: input.protocol === "responses" ? "responses" : input.protocol === "chat" ? "chat" : undefined,
+    modelMetadataURL: input.modelMetadataURL === false ? false : stringOption(input.modelMetadataURL),
+    discoveryTimeoutMs: typeof input.discoveryTimeoutMs === "number" && input.discoveryTimeoutMs > 0 ? input.discoveryTimeoutMs : undefined
+  };
+}
+function stringOption(value) {
+  return typeof value === "string" && value.trim() !== "" ? value : undefined;
+}
+function displayName(modelID) {
+  return modelID.split("-").map((part) => {
+    const lower = part.toLowerCase();
+    if (lower === "gpt")
+      return "GPT";
+    if (lower === "oss")
+      return "OSS";
+    if (lower === "codex")
+      return "Codex";
+    return part.charAt(0).toUpperCase() + part.slice(1);
+  }).join(" ");
+}
+function isImageModel(modelID) {
+  return /(?:^|-)image(?:-|$)/i.test(modelID);
+}
+function isReasoningModel(modelID, efforts) {
+  if (efforts?.levels.length)
+    return efforts.levels.some((level) => level !== "none");
+  return /thinking|reasoning|codex|gpt-(?:5|oss)/i.test(modelID);
+}
+function supportsAttachments(modelID) {
+  return /^(?:claude|gemini|gpt)/i.test(modelID) && !/^gpt-oss(?:-|$)/i.test(modelID);
+}
+function modelModalities(modelID) {
+  const imageOutput = isImageModel(modelID);
+  return {
+    input: imageOutput || supportsAttachments(modelID) ? ["text", "image"] : ["text"],
+    output: imageOutput ? ["image"] : ["text"]
+  };
+}
+function resolveModelNpm(catalog, providerID, modelID) {
+  const provider = catalog[providerID];
+  return provider?.models[modelID] ?? provider?.npm;
+}
+function isAnthropicRouted(model, protocolCatalog) {
+  return model.ownedBy !== undefined && resolveModelNpm(protocolCatalog, model.ownedBy, model.id) === V1_ANTHROPIC_PACKAGE;
+}
+function supportedEffortLevels(model, input) {
+  const efforts = input.effortCatalog[model.id];
+  if (!efforts)
+    return;
+  if (isAnthropicRouted(model, input.protocolCatalog))
+    return;
+  const levels = efforts.levels.filter((level) => level !== "none");
+  return levels.length > 0 ? levels : undefined;
+}
+async function discoverCatalog(input) {
+  const [catalog, protocolDiscovery, effortDiscovery] = await Promise.all([
+    discoverModels({ baseURL: input.baseURL, apiKey: input.apiKey, timeoutMs: input.timeoutMs }),
+    discoverProtocols({ url: input.modelMetadataURL, timeoutMs: input.timeoutMs }),
+    discoverEffortLevels({ baseURL: input.baseURL, apiKey: input.apiKey, timeoutMs: input.timeoutMs })
+  ]);
+  return {
+    catalog,
+    protocolCatalog: protocolDiscovery.catalog,
+    effortCatalog: effortDiscovery.catalog,
+    errors: [protocolDiscovery.error, effortDiscovery.error].filter((error) => error !== undefined)
+  };
+}
+function discoverProtocols(input) {
+  if (input.url === false)
+    return Promise.resolve({ catalog: {} });
+  return discoverModelProtocols({
+    url: input.url,
+    timeoutMs: input.timeoutMs
+  }).then((catalog) => ({ catalog })).catch((error) => ({
+    catalog: {},
+    error: error instanceof Error ? error.message : String(error)
+  }));
+}
+function discoverEffortLevels(input) {
+  return discoverReasoningEfforts(input).then((catalog) => ({ catalog })).catch((error) => ({
+    catalog: {},
+    error: error instanceof Error ? error.message : String(error)
+  }));
+}
+
+// src/plugin-v2.ts
+var DEFAULT_CONTEXT_LIMIT = 128000;
+var DEFAULT_OUTPUT_LIMIT = 4096;
+function toV2Model(model, input) {
+  const image = isImageModel(model.id);
+  const modalities = modelModalities(model.id);
+  const levels = supportedEffortLevels(model, input.discovery);
+  const anthropic = isAnthropicRouted(model, input.discovery.protocolCatalog);
+  return {
+    id: model.id,
+    modelID: model.id,
+    providerID: input.providerID,
+    name: displayName(model.id),
+    ...anthropic ? { package: V2_ANTHROPIC_PACKAGE } : {},
+    capabilities: {
+      tools: !image,
+      input: modalities.input,
+      output: modalities.output
+    },
+    variants: (levels ?? []).map((level) => ({
+      id: level,
+      settings: { reasoningEffort: level }
+    })),
+    time: { released: 0 },
+    cost: [{ input: 0, output: 0, cache: { read: 0, write: 0 } }],
+    status: "active",
+    enabled: true,
+    limit: { context: DEFAULT_CONTEXT_LIMIT, output: DEFAULT_OUTPUT_LIMIT }
+  };
+}
+function toV2Models(input) {
+  return input.discovery.catalog.map((model) => toV2Model(model, { providerID: input.providerID, discovery: input.discovery }));
+}
+async function setup(ctx) {
+  const options = readOptions(ctx.options);
+  const providerID = options.providerID ?? DEFAULT_PROVIDER_ID;
+  const baseURL = normalizeBaseURL(options.baseURL ?? process.env.CLIPROXY_BASE_URL ?? DEFAULT_BASE_URL);
+  const apiKey = options.apiKey ?? process.env.CLIPROXY_API_KEY;
+  const timeoutMs = options.discoveryTimeoutMs ?? DEFAULT_DISCOVERY_TIMEOUT_MS;
+  const modelMetadataURL = options.modelMetadataURL ?? DEFAULT_MODEL_METADATA_URL;
+  const discovery = await discoverCatalog({ baseURL, apiKey, modelMetadataURL, timeoutMs });
+  for (const error of discovery.errors) {
+    console.warn(`[cliproxyapi] ${error}`);
+  }
+  const models = toV2Models({ providerID, discovery });
+  const providerPackage = options.protocol === "responses" ? V2_RESPONSES_PACKAGE : V2_CHAT_PACKAGE;
+  await ctx.provider.transform((editor) => {
+    const settings = { baseURL };
+    if (apiKey)
+      settings.apiKey = apiKey;
+    const existing = editor.get(providerID);
+    if (existing) {
+      editor.update(providerID, (provider) => {
+        provider.name = provider.name || options.providerName || DEFAULT_PROVIDER_NAME;
+        provider.activation = "enabled";
+        provider.package = providerPackage;
+        provider.settings = { ...provider.settings, ...settings };
+      });
+      editor.models.set(providerID, models);
+      return;
+    }
+    const info = {
+      id: providerID,
+      name: options.providerName ?? DEFAULT_PROVIDER_NAME,
+      activation: "enabled",
+      package: providerPackage,
+      settings
+    };
+    editor.add({ info, models });
+  });
+  return async () => {};
+}
+
+// src/index.ts
 var CLIProxyAPIPlugin = async ({ client }, rawOptions) => {
   const options = readOptions(rawOptions);
   return {
@@ -119,24 +292,13 @@ var CLIProxyAPIPlugin = async ({ client }, rawOptions) => {
       const apiKey = options.apiKey ?? process.env.CLIPROXY_API_KEY ?? stringOption(existing?.options?.apiKey);
       try {
         const timeoutMs = options.discoveryTimeoutMs ?? DEFAULT_DISCOVERY_TIMEOUT_MS;
-        const [catalog, protocolDiscovery, effortDiscovery] = await Promise.all([
-          discoverModels({
-            baseURL,
-            apiKey,
-            timeoutMs
-          }),
-          discoverProtocols({
-            url: options.modelMetadataURL ?? DEFAULT_MODEL_METADATA_URL,
-            timeoutMs
-          }),
-          discoverEffortLevels({
-            baseURL,
-            apiKey,
-            timeoutMs
-          })
-        ]);
-        const discoveryErrors = [protocolDiscovery.error, effortDiscovery.error].filter((error) => error !== undefined);
-        for (const message of discoveryErrors) {
+        const discovery = await discoverCatalog({
+          baseURL,
+          apiKey,
+          modelMetadataURL: options.modelMetadataURL ?? DEFAULT_MODEL_METADATA_URL,
+          timeoutMs
+        });
+        for (const message of discovery.errors) {
           await client.app.log({
             body: {
               service: "opencode-cliproxyapi",
@@ -151,15 +313,15 @@ var CLIProxyAPIPlugin = async ({ client }, rawOptions) => {
           baseURL,
           apiKey,
           protocol: options.protocol ?? "chat",
-          catalog,
-          protocolCatalog: protocolDiscovery.catalog,
-          effortCatalog: effortDiscovery.catalog
+          catalog: discovery.catalog,
+          protocolCatalog: discovery.protocolCatalog,
+          effortCatalog: discovery.effortCatalog
         });
         await client.app.log({
           body: {
             service: "opencode-cliproxyapi",
             level: "info",
-            message: `Discovered ${catalog.length} CLIProxyAPI models from ${baseURL}`
+            message: `Discovered ${discovery.catalog.length} CLIProxyAPI models from ${baseURL}`
           }
         });
       } catch (error) {
@@ -177,7 +339,8 @@ var CLIProxyAPIPlugin = async ({ client }, rawOptions) => {
 };
 var src_default = {
   id: "opencode-cliproxyapi",
-  server: CLIProxyAPIPlugin
+  server: CLIProxyAPIPlugin,
+  setup
 };
 function addProvider(config, input) {
   const existing = config.provider?.[input.providerID];
@@ -188,17 +351,12 @@ function addProvider(config, input) {
       tool_call: !isImageModel(model.id),
       reasoning: isReasoningModel(model.id, input.effortCatalog[model.id]),
       attachment: supportsAttachments(model.id),
-      ...model.ownedBy && resolveModelNpm(input.protocolCatalog, model.ownedBy, model.id) === "@ai-sdk/anthropic" ? {
+      ...model.ownedBy && resolveModelNpm(input.protocolCatalog, model.ownedBy, model.id) === V1_ANTHROPIC_PACKAGE ? {
         provider: {
-          npm: "@ai-sdk/anthropic"
-        }
-      } : {},
-      ...isImageModel(model.id) ? {
-        modalities: {
-          input: ["text", "image"],
-          output: ["image"]
+          npm: V1_ANTHROPIC_PACKAGE
         }
       } : {},
+      ...imageModalities(model.id),
       ...reasoningEffortConfig(model, input)
     }
   ]));
@@ -207,7 +365,7 @@ function addProvider(config, input) {
     [input.providerID]: {
       ...existing,
       name: existing?.name ?? input.providerName,
-      npm: existing?.npm ?? (input.protocol === "responses" ? "@ai-sdk/openai" : "@ai-sdk/openai-compatible"),
+      npm: existing?.npm ?? (input.protocol === "responses" ? V1_RESPONSES_PACKAGE : V1_CHAT_PACKAGE),
       env: [...new Set([...existing?.env ?? [], "CLIPROXY_API_KEY"])],
       options: {
         ...existing?.options,
@@ -218,15 +376,18 @@ function addProvider(config, input) {
     }
   };
 }
+function imageModalities(modelID) {
+  const modalities = modelModalities(modelID);
+  if (!modalities.input.includes("image") && !modalities.output.includes("image"))
+    return {};
+  return { modalities };
+}
 function reasoningEffortConfig(model, input) {
   const efforts = input.effortCatalog[model.id];
   if (!efforts)
     return {};
-  const anthropicRouted = model.ownedBy !== undefined && resolveModelNpm(input.protocolCatalog, model.ownedBy, model.id) === "@ai-sdk/anthropic";
-  if (anthropicRouted)
-    return {};
-  const levels = efforts.levels.filter((level) => level !== "none");
-  if (levels.length === 0)
+  const levels = supportedEffortLevels(model, input);
+  if (!levels)
     return {};
   const defaultLevel = efforts.defaultLevel !== undefined && efforts.levels.includes(efforts.defaultLevel) ? efforts.defaultLevel : undefined;
   return {
@@ -245,10 +406,6 @@ function disabledVariants(supported) {
     { disabled: true }
   ]));
 }
-function resolveModelNpm(catalog, providerID, modelID) {
-  const provider = catalog[providerID];
-  return provider?.models[modelID] ?? provider?.npm;
-}
 function mergeModels(discovered, existing) {
   const merged = { ...discovered };
   for (const [modelID, model] of Object.entries(existing ?? {})) {
@@ -262,62 +419,6 @@ function mergeModels(discovered, existing) {
   }
   return merged;
 }
-function readOptions(input) {
-  if (!input)
-    return {};
-  return {
-    baseURL: stringOption(input.baseURL),
-    apiKey: stringOption(input.apiKey),
-    providerID: stringOption(input.providerID),
-    providerName: stringOption(input.providerName),
-    protocol: input.protocol === "responses" ? "responses" : input.protocol === "chat" ? "chat" : undefined,
-    modelMetadataURL: input.modelMetadataURL === false ? false : stringOption(input.modelMetadataURL),
-    discoveryTimeoutMs: typeof input.discoveryTimeoutMs === "number" && input.discoveryTimeoutMs > 0 ? input.discoveryTimeoutMs : undefined
-  };
-}
-function discoverProtocols(input) {
-  if (input.url === false)
-    return Promise.resolve({ catalog: {} });
-  return discoverModelProtocols({
-    url: input.url,
-    timeoutMs: input.timeoutMs
-  }).then((catalog) => ({ catalog })).catch((error) => ({
-    catalog: {},
-    error: error instanceof Error ? error.message : String(error)
-  }));
-}
-function discoverEffortLevels(input) {
-  return discoverReasoningEfforts(input).then((catalog) => ({ catalog })).catch((error) => ({
-    catalog: {},
-    error: error instanceof Error ? error.message : String(error)
-  }));
-}
-function stringOption(value) {
-  return typeof value === "string" && value.trim() !== "" ? value : undefined;
-}
-function displayName(modelID) {
-  return modelID.split("-").map((part) => {
-    const lower = part.toLowerCase();
-    if (lower === "gpt")
-      return "GPT";
-    if (lower === "oss")
-      return "OSS";
-    if (lower === "codex")
-      return "Codex";
-    return part.charAt(0).toUpperCase() + part.slice(1);
-  }).join(" ");
-}
-function isImageModel(modelID) {
-  return /(?:^|-)image(?:-|$)/i.test(modelID);
-}
-function isReasoningModel(modelID, efforts) {
-  if (efforts?.levels.length)
-    return efforts.levels.some((level) => level !== "none");
-  return /thinking|reasoning|codex|gpt-(?:5|oss)/i.test(modelID);
-}
-function supportsAttachments(modelID) {
-  return /^(?:claude|gemini|gpt)/i.test(modelID);
-}
 export {
   CLIProxyAPIPlugin,
   src_default as default,

package/dist/plugin-v2.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OpenCode V2 entrypoint for CLIProxyAPI.
+ *
+ * V2 plugins default-export a definition with an `id` and a `setup(ctx)`
+ * function; V1 plugin functions do not run on V2. This module ports the
+ * discovery pipeline to the V2 provider API: it resolves the connector
+ * options, runs the same catalog/protocol/effort discovery as V1, and
+ * publishes the resulting provider through `ctx.provider.transform`.
+ *
+ * All `@opencode/plugin` imports are type-only, so the built plugin has no
+ * runtime dependency on the V2 SDK.
+ */
+import type { Plugin } from "@opencode/plugin";
+import { type CatalogDiscovery } from "./shared.js";
+type Context = Plugin.Context;
+export interface V2ModelVariant {
+    id: string;
+    settings?: Record<string, unknown>;
+}
+export interface V2ModelInfo {
+    id: string;
+    modelID: string;
+    providerID: string;
+    name: string;
+    package?: string;
+    capabilities: {
+        tools: boolean;
+        input: string[];
+        output: string[];
+    };
+    variants: V2ModelVariant[];
+    time: {
+        released: number;
+    };
+    cost: Array<{
+        input: number;
+        output: number;
+        cache: {
+            read: number;
+            write: number;
+        };
+    }>;
+    status: "active";
+    enabled: boolean;
+    limit: {
+        context: number;
+        output: number;
+    };
+}
+export declare function toV2Model(model: CatalogDiscovery["catalog"][number], input: {
+    providerID: string;
+    discovery: CatalogDiscovery;
+}): V2ModelInfo;
+export declare function toV2Models(input: {
+    providerID: string;
+    discovery: CatalogDiscovery;
+}): V2ModelInfo[];
+/**
+ * V2 setup. Registers the provider from the discovered catalog and returns a
+ * no-op cleanup (V2 keeps no timers or subscriptions for this plugin).
+ */
+export declare function setup(ctx: Context): Promise<() => Promise<void>>;
+export declare const v2Definition: {
+    id: string;
+    setup: typeof setup;
+};
+export {};
+//# sourceMappingURL=plugin-v2.d.ts.map

package/dist/plugin-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-v2.d.ts","sourceRoot":"","sources":["../src/plugin-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAS,MAAM,EAAY,MAAM,kBAAkB,CAAA;AAE/D,OAAO,EAgBL,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAA;AAEpB,KAAK,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;AAK7B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE;QACZ,KAAK,EAAE,OAAO,CAAA;QACd,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,MAAM,EAAE,MAAM,EAAE,CAAA;KACjB,CAAA;IACD,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,IAAI,EAAE,KAAK,CAAC;QACV,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KACvC,CAAC,CAAA;IACF,MAAM,EAAE,QAAQ,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC1C,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,GACzD,WAAW,CA6Bb;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,gBAAgB,CAAA;CAC5B,GAAG,WAAW,EAAE,CAIhB;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA8CtE;AAED,eAAO,MAAM,YAAY;;;CAGxB,CAAA"}

package/dist/shared.d.ts

@@ -0,0 +1,55 @@
+import type { PluginOptions } from "@opencode-ai/plugin";
+import { type CatalogModel, type ModelProtocolCatalog, type ReasoningEffortCatalog } from "./catalog.js";
+export declare const DEFAULT_BASE_URL = "http://localhost:8317/v1";
+export declare const DEFAULT_PROVIDER_ID = "cliproxyapi";
+export declare const DEFAULT_PROVIDER_NAME = "CLIProxyAPI";
+export declare const DEFAULT_DISCOVERY_TIMEOUT_MS = 10000;
+export declare const DEFAULT_MODEL_METADATA_URL = "https://models.dev/api.json";
+export declare const V1_CHAT_PACKAGE = "@ai-sdk/openai-compatible";
+export declare const V1_RESPONSES_PACKAGE = "@ai-sdk/openai";
+export declare const V1_ANTHROPIC_PACKAGE = "@ai-sdk/anthropic";
+export declare const V2_CHAT_PACKAGE = "@opencode/ai/providers/openai-compatible";
+export declare const V2_RESPONSES_PACKAGE = "@opencode/ai/providers/openai";
+export declare const V2_ANTHROPIC_PACKAGE = "@opencode/ai/providers/anthropic";
+export type ConnectorOptions = {
+    baseURL?: string;
+    apiKey?: string;
+    providerID?: string;
+    providerName?: string;
+    protocol?: "chat" | "responses";
+    modelMetadataURL?: string | false;
+    discoveryTimeoutMs?: number;
+};
+export type CatalogDiscovery = {
+    catalog: CatalogModel[];
+    protocolCatalog: ModelProtocolCatalog;
+    effortCatalog: ReasoningEffortCatalog;
+    errors: string[];
+};
+export declare function readOptions(input?: PluginOptions): ConnectorOptions;
+export declare function stringOption(value: unknown): string | undefined;
+export declare function displayName(modelID: string): string;
+export declare function isImageModel(modelID: string): boolean;
+export declare function isReasoningModel(modelID: string, efforts?: {
+    levels: string[];
+    defaultLevel?: string;
+}): boolean;
+export declare function supportsAttachments(modelID: string): boolean;
+export type ModelModalities = {
+    input: Array<"text" | "image">;
+    output: Array<"text" | "image">;
+};
+export declare function modelModalities(modelID: string): ModelModalities;
+export declare function resolveModelNpm(catalog: ModelProtocolCatalog, providerID: string, modelID: string): string | undefined;
+export declare function isAnthropicRouted(model: CatalogModel, protocolCatalog: ModelProtocolCatalog): boolean;
+export declare function supportedEffortLevels(model: CatalogModel, input: {
+    protocolCatalog: ModelProtocolCatalog;
+    effortCatalog: ReasoningEffortCatalog;
+}): string[] | undefined;
+export declare function discoverCatalog(input: {
+    baseURL: string;
+    apiKey?: string;
+    modelMetadataURL: string | false;
+    timeoutMs: number;
+}): Promise<CatalogDiscovery>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@darknesskiller/opencode-cliproxyapi",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Fork of opencode-cliproxyapi that discovers CLIProxyAPI models and auto-configures reasoning-effort variants in OpenCode.",
   "type": "module",
   "license": "MIT",
@@ -29,7 +29,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target bun --format esm --external @opencode-ai/plugin && tsc --emitDeclarationOnly",
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --format esm --external @opencode-ai/plugin --external @opencode/plugin && tsc --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
     "test": "bun test ./src",
     "check": "bun run typecheck && bun run test && bun run build",
@@ -43,6 +43,7 @@
   ],
   "devDependencies": {
     "@opencode-ai/plugin": "1.18.29",
+    "@opencode/plugin": "^2.0.18",
     "@types/bun": "^1.3.5",
     "typescript": "^5.9.3"
   },