@darknesskiller/opencode-cliproxyapi 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,7 +5,38 @@ 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.0] - Unreleased
+## [0.4.0] - 2026-11-13
+
+### Added
+
+- Discovered models now carry token limits parsed from the CLIProxyAPI
+  codex-client catalog, resolving the V1/V2 alignment gap. Context window
+  comes from `context_window`, falling back to `max_context_window` and
+  then 128,000; output comes from `max_tokens`, falling back to 32,000,
+  OpenCode V1's effective default (`0` breaks Anthropic-routed models and
+  V2 has no default of its own). Both plugin versions resolve limits
+  through the same shared code.
+- User config now wins per field over discovered models in both versions:
+  non-empty strings for `name`/`package`/`provider.npm`, booleans for the
+  capability flags, and `limit` merged key-by-key (raising and lowering
+  both win; `0` keeps the default policy). `variants` and other nested
+  objects keep whole-object override semantics, models configured in user
+  config alone are preserved, and invalid values no longer erase what
+  discovery found.
+
+## [0.3.1] - 2026-11-13
+
+### 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-06
 
 ### Added
 
@@ -78,7 +109,9 @@ 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.4.0...HEAD
+[0.4.0]: https://github.com/DarknessKiller/opencode-cliproxyapi/compare/v0.3.1...v0.4.0
+[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

@@ -240,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/catalog.d.ts

@@ -7,8 +7,12 @@ export type ModelProtocolCatalog = Record<string, {
     models: Record<string, string>;
 }>;
 export type ReasoningEffortLevels = {
-    levels: string[];
+    levels?: string[];
     defaultLevel?: string;
+    limit?: {
+        context?: number;
+        output?: number;
+    };
 };
 export type ReasoningEffortCatalog = Record<string, ReasoningEffortLevels>;
 export declare function normalizeBaseURL(value: string): string;

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,CACF,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAGD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;AAW1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,UAK7C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAuB3D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAqBlF;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiBlC;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,2BAcA;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAsB9E;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,iCAaA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,CACF,CAAA;AAID,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9C,CAAA;AAGD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;AAW1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,UAK7C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAuB3D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAiClF;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiBlC;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,2BAcA;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAsB9E;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB,iCAaA"}

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,EAAgB,MAAM,qBAAqB,CAAA;AAuBvE,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,MAAM,EAAgB,MAAM,qBAAqB,CAAA;AA6BvE,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

@@ -38,15 +38,19 @@ function parseReasoningEffortCatalog(input) {
     if (!isRecord(item) || typeof item.slug !== "string" || item.slug.trim() === "")
       continue;
     const rawLevels = item.supported_reasoning_levels;
-    if (!Array.isArray(rawLevels))
-      continue;
-    const levels = rawLevels.map((entry) => isRecord(entry) && typeof entry.effort === "string" ? entry.effort : undefined).filter((level) => level !== undefined);
-    if (levels.length === 0)
-      continue;
-    const defaultLevel = typeof item.default_reasoning_level === "string" ? item.default_reasoning_level : undefined;
+    const levels = Array.isArray(rawLevels) ? rawLevels.map((entry) => isRecord(entry) && typeof entry.effort === "string" ? entry.effort : undefined).filter((level) => level !== undefined) : undefined;
+    const limit = {};
+    const context = [item.context_window, item.max_context_window].find(isPositiveNumber);
+    const output = isPositiveNumber(item.max_tokens) ? item.max_tokens : undefined;
+    if (context !== undefined)
+      limit.context = context;
+    if (output !== undefined)
+      limit.output = output;
+    const defaultLevel = levels && typeof item.default_reasoning_level === "string" ? item.default_reasoning_level : undefined;
     catalog[item.slug] = {
-      levels: [...new Set(levels)],
-      ...defaultLevel ? { defaultLevel } : {}
+      ...levels ? { levels: [...new Set(levels)] } : {},
+      ...defaultLevel ? { defaultLevel } : {},
+      ...Object.keys(limit).length > 0 ? { limit } : {}
     };
   }
   return catalog;
@@ -99,6 +103,9 @@ async function discoverModelProtocols(input) {
   }
   return parseModelProtocolCatalog(await response.json());
 }
+function isPositiveNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -109,6 +116,8 @@ 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 DEFAULT_CONTEXT_LIMIT = 128000;
+var DEFAULT_OUTPUT_LIMIT = 32000;
 var V1_CHAT_PACKAGE = "@ai-sdk/openai-compatible";
 var V1_RESPONSES_PACKAGE = "@ai-sdk/openai";
 var V1_ANTHROPIC_PACKAGE = "@ai-sdk/anthropic";
@@ -131,6 +140,35 @@ function readOptions(input) {
 function stringOption(value) {
   return typeof value === "string" && value.trim() !== "" ? value : undefined;
 }
+function resolveModelLimits(model, effortCatalog) {
+  const limit = effortCatalog[model.id]?.limit;
+  return {
+    context: limit?.context ?? DEFAULT_CONTEXT_LIMIT,
+    output: limit?.output ?? DEFAULT_OUTPUT_LIMIT
+  };
+}
+function isProperString(value) {
+  return typeof value === "string" && value.trim() !== "";
+}
+function isProperBoolean(value) {
+  return typeof value === "boolean";
+}
+function isProperContextLimit(value) {
+  return Number.isInteger(value) && value > 0;
+}
+function isProperOutputLimit(value) {
+  return Number.isInteger(value) && value > 0;
+}
+function properLimitOverrides(userLimit) {
+  const input = typeof userLimit === "object" && userLimit !== null ? userLimit : {};
+  return {
+    ...isProperContextLimit(input.context) ? { context: input.context } : {},
+    ...isProperOutputLimit(input.output) ? { output: input.output } : {}
+  };
+}
+function definedKeys(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}
 function displayName(modelID) {
   return modelID.split("-").map((part) => {
     const lower = part.toLowerCase();
@@ -147,12 +185,19 @@ function isImageModel(modelID) {
   return /(?:^|-)image(?:-|$)/i.test(modelID);
 }
 function isReasoningModel(modelID, efforts) {
-  if (efforts?.levels.length)
+  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);
+  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];
@@ -167,7 +212,7 @@ function supportedEffortLevels(model, input) {
     return;
   if (isAnthropicRouted(model, input.protocolCatalog))
     return;
-  const levels = efforts.levels.filter((level) => level !== "none");
+  const levels = efforts.levels?.filter((level) => level !== "none") ?? [];
   return levels.length > 0 ? levels : undefined;
 }
 async function discoverCatalog(input) {
@@ -202,10 +247,9 @@ function discoverEffortLevels(input) {
 }
 
 // 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 {
@@ -216,8 +260,8 @@ function toV2Model(model, input) {
     ...anthropic ? { package: V2_ANTHROPIC_PACKAGE } : {},
     capabilities: {
       tools: !image,
-      input: image ? ["text", "image"] : ["text"],
-      output: image ? ["image"] : ["text"]
+      input: modalities.input,
+      output: modalities.output
     },
     variants: (levels ?? []).map((level) => ({
       id: level,
@@ -227,12 +271,39 @@ function toV2Model(model, input) {
     cost: [{ input: 0, output: 0, cache: { read: 0, write: 0 } }],
     status: "active",
     enabled: true,
-    limit: { context: DEFAULT_CONTEXT_LIMIT, output: DEFAULT_OUTPUT_LIMIT }
+    limit: resolveModelLimits(model, input.discovery.effortCatalog)
   };
 }
 function toV2Models(input) {
   return input.discovery.catalog.map((model) => toV2Model(model, { providerID: input.providerID, discovery: input.discovery }));
 }
+function mergeV2Models(discovered, userModels) {
+  const merged = discovered.map((base) => {
+    const userModel = userModels?.get(base.id);
+    return isRecord2(userModel) ? mergeV2Model(base, userModel) : base;
+  });
+  if (userModels) {
+    const discoveredIDs = new Set(discovered.map((model) => model.id));
+    for (const [id, userModel] of userModels) {
+      if (!discoveredIDs.has(id) && isRecord2(userModel))
+        merged.push(userModel);
+    }
+  }
+  return merged;
+}
+function mergeV2Model(base, userModel) {
+  return {
+    ...base,
+    ...definedKeys(userModel),
+    name: isProperString(userModel.name) ? userModel.name : base.name,
+    package: isProperString(userModel.package) ? userModel.package : base.package,
+    enabled: isProperBoolean(userModel.enabled) ? userModel.enabled : base.enabled,
+    limit: { ...base.limit, ...properLimitOverrides(userModel.limit) }
+  };
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 async function setup(ctx) {
   const options = readOptions(ctx.options);
   const providerID = options.providerID ?? DEFAULT_PROVIDER_ID;
@@ -244,13 +315,14 @@ async function setup(ctx) {
   for (const error of discovery.errors) {
     console.warn(`[cliproxyapi] ${error}`);
   }
-  const models = toV2Models({ providerID, discovery });
+  const discovered = 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);
+    const models = mergeV2Models(discovered, existing?.models);
     if (existing) {
       editor.update(providerID, (provider) => {
         provider.name = provider.name || options.providerName || DEFAULT_PROVIDER_NAME;
@@ -343,17 +415,13 @@ function addProvider(config, input) {
       tool_call: !isImageModel(model.id),
       reasoning: isReasoningModel(model.id, input.effortCatalog[model.id]),
       attachment: supportsAttachments(model.id),
+      limit: resolveModelLimits(model, input.effortCatalog),
       ...model.ownedBy && resolveModelNpm(input.protocolCatalog, model.ownedBy, model.id) === V1_ANTHROPIC_PACKAGE ? {
         provider: {
           npm: V1_ANTHROPIC_PACKAGE
         }
       } : {},
-      ...isImageModel(model.id) ? {
-        modalities: {
-          input: ["text", "image"],
-          output: ["image"]
-        }
-      } : {},
+      ...imageModalities(model.id),
       ...reasoningEffortConfig(model, input)
     }
   ]));
@@ -373,6 +441,12 @@ 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)
@@ -380,12 +454,12 @@ function reasoningEffortConfig(model, input) {
   const levels = supportedEffortLevels(model, input);
   if (!levels)
     return {};
-  const defaultLevel = efforts.defaultLevel !== undefined && efforts.levels.includes(efforts.defaultLevel) ? efforts.defaultLevel : undefined;
+  const defaultLevel = efforts.defaultLevel !== undefined && efforts.levels?.includes(efforts.defaultLevel) ? efforts.defaultLevel : undefined;
   return {
     ...defaultLevel ? { options: { reasoningEffort: defaultLevel } } : {},
     variants: {
-      ...Object.fromEntries(efforts.levels.map((level) => [level, { reasoningEffort: level }])),
-      ...disabledVariants(efforts.levels)
+      ...Object.fromEntries((efforts.levels ?? []).map((level) => [level, { reasoningEffort: level }])),
+      ...disabledVariants(efforts.levels ?? [])
     }
   };
 }
@@ -399,25 +473,50 @@ function disabledVariants(supported) {
 }
 function mergeModels(discovered, existing) {
   const merged = { ...discovered };
-  for (const [modelID, model] of Object.entries(existing ?? {})) {
-    const discoveredModel = merged[modelID];
-    const providerNpm = model.provider?.npm ?? discoveredModel?.provider?.npm;
-    merged[modelID] = {
-      ...discoveredModel,
-      ...model,
-      ...providerNpm ? { provider: { npm: providerNpm } } : {}
-    };
+  for (const [modelID, userModel] of Object.entries(existing ?? {})) {
+    const base = merged[modelID];
+    if (!base) {
+      if (isRecord3(userModel))
+        merged[modelID] = { ...userModel };
+      continue;
+    }
+    if (isRecord3(userModel))
+      merged[modelID] = mergeDiscoveredModel(base, userModel);
   }
   return merged;
 }
+function mergeDiscoveredModel(base, userModel) {
+  const limits = { ...base.limit, ...properLimitOverrides(userModel.limit) };
+  const merged = {
+    ...base,
+    ...definedKeys(userModel),
+    name: isProperString(userModel.name) ? userModel.name : base.name,
+    tool_call: isProperBoolean(userModel.tool_call) ? userModel.tool_call : base.tool_call,
+    reasoning: isProperBoolean(userModel.reasoning) ? userModel.reasoning : base.reasoning,
+    attachment: isProperBoolean(userModel.attachment) ? userModel.attachment : base.attachment,
+    limit: limits
+  };
+  const userProvider = userModel.provider;
+  if (typeof userProvider === "object" && userProvider !== null) {
+    const { npm, ...rest } = userProvider;
+    const providerNpm = isProperString(npm) ? npm : base.provider?.npm;
+    const provider = providerNpm ? { npm: providerNpm, ...rest } : rest;
+    if (Object.keys(provider ?? {}).length > 0)
+      merged.provider = provider;
+  }
+  return merged;
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export {
-  parseReasoningEffortCatalog,
-  parseModelProtocolCatalog,
-  parseCatalog,
-  normalizeBaseURL,
-  discoverReasoningEfforts,
-  discoverModels,
-  discoverModelProtocols,
+  CLIProxyAPIPlugin,
   src_default as default,
-  CLIProxyAPIPlugin
+  discoverModelProtocols,
+  discoverModels,
+  discoverReasoningEfforts,
+  normalizeBaseURL,
+  parseCatalog,
+  parseModelProtocolCatalog,
+  parseReasoningEffortCatalog
 };

package/dist/plugin-v2.d.ts

@@ -55,6 +55,12 @@ export declare function toV2Models(input: {
     providerID: string;
     discovery: CatalogDiscovery;
 }): V2ModelInfo[];
+/**
+ * Overlays the user's configured models on the discovered list. Discovery
+ * provides the defaults; a user value wins only where it is a value V2 can
+ * use, and a model the user configured alone is preserved verbatim.
+ */
+export declare function mergeV2Models(discovered: V2ModelInfo[], userModels?: ReadonlyMap<string, unknown>): 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).

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

@@ -1 +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,EAeL,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,CA4Bb;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"}
+{"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,EAqBL,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAA;AAEpB,KAAK,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;AAE7B,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;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,WAAW,EAAE,EACzB,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,WAAW,EAAE,CAgBf;AAkBD;;;GAGG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA+CtE;AAED,eAAO,MAAM,YAAY;;;CAGxB,CAAA"}

package/dist/shared.d.ts

@@ -1,10 +1,12 @@
 import type { PluginOptions } from "@opencode-ai/plugin";
-import { type CatalogModel, type ModelProtocolCatalog, type ReasoningEffortCatalog } from "./catalog.js";
+import { type CatalogModel, type ModelProtocolCatalog, type ReasoningEffortCatalog, type ReasoningEffortLevels } 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 DEFAULT_CONTEXT_LIMIT = 128000;
+export declare const DEFAULT_OUTPUT_LIMIT = 32000;
 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";
@@ -28,13 +30,28 @@ export type CatalogDiscovery = {
 };
 export declare function readOptions(input?: PluginOptions): ConnectorOptions;
 export declare function stringOption(value: unknown): string | undefined;
+export declare function resolveModelLimits(model: CatalogModel, effortCatalog: ReasoningEffortCatalog): {
+    context: number;
+    output: number;
+};
+export declare function isProperString(value: unknown): value is string;
+export declare function isProperBoolean(value: unknown): value is boolean;
+export declare function isProperContextLimit(value: unknown): value is number;
+export declare function isProperOutputLimit(value: unknown): value is number;
+export declare function properLimitOverrides(userLimit: unknown): {
+    context?: number;
+    output?: number;
+};
+export declare function definedKeys<T extends object>(value: T): Partial<T>;
 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 isReasoningModel(modelID: string, efforts?: ReasoningEffortLevels): 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: {

package/dist/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAA;AAErB,eAAO,MAAM,gBAAgB,6BAA6B,CAAA;AAC1D,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAChD,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAClD,eAAO,MAAM,4BAA4B,QAAS,CAAA;AAClD,eAAO,MAAM,0BAA0B,gCAAgC,CAAA;AAGvE,eAAO,MAAM,eAAe,8BAA8B,CAAA;AAC1D,eAAO,MAAM,oBAAoB,mBAAmB,CAAA;AACpD,eAAO,MAAM,oBAAoB,sBAAsB,CAAA;AACvD,eAAO,MAAM,eAAe,6CAA6C,CAAA;AACzE,eAAO,MAAM,oBAAoB,kCAAkC,CAAA;AACnE,eAAO,MAAM,oBAAoB,qCAAqC,CAAA;AAEtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,eAAe,EAAE,oBAAoB,CAAA;IACrC,aAAa,EAAE,sBAAsB,CAAA;IACrC,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAiBnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,sBAE1C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,UAW1C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,WAE3C;AAID,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,WAItD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,WAElD;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,oBAAoB,GACpC,OAAO,CAKT;AAMD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IAAE,eAAe,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,sBAAsB,CAAA;CAAE,GACtF,MAAM,EAAE,GAAG,SAAS,CAOtB;AAKD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAAA;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe5B"}
+{"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.3.0",
+  "version": "0.4.0",
   "description": "Fork of opencode-cliproxyapi that discovers CLIProxyAPI models and auto-configures reasoning-effort variants in OpenCode.",
   "type": "module",
   "license": "MIT",