@staticeng/opencode-litellm 0.2.3 → 0.2.4

package/README.md

@@ -48,12 +48,15 @@ Shared or synchronized OpenCode configuration should use the published package n
 | `providerOverrides` | `{}` | Provider-level deep-merge overrides. |
 | `includeModes` | `chat`, `responses` | LiteLLM modes to include. |
 | `includeModels` | all included modes | Optional allowlist by model name. |
+| `includeBackends` | unset | Optional exact allowlist by `model_info.backend`, unioned with `includeModels` pins. |
 | `excludeModels` | none | Optional denylist by model name. |
 | `timeoutMs` | `30000` | Per-request discovery timeout. |
 | `strict` | `false` | Throw on fetch/mapping failures instead of warning. |
 
 The LiteLLM key must have permission to call `GET /model/info` and root `GET /model_group/info`.
 
+When `includeBackends` is present, models are candidates when `model_info.backend` exactly and case-sensitively matches an entry or their exact model name is pinned by `includeModels`. Backend values are not trimmed, normalized, or partially matched; missing and non-string values do not match. An empty `includeBackends` matches no backends, so without model pins it includes no models. `excludeModels` always wins over backend matches and pins, and candidates must still pass `includeModes` (or the default `chat` and `responses` modes). When `includeBackends` is omitted, `includeModels` retains its historical behavior: a non-empty array is a model-name allowlist, while an omitted or empty array imposes no model-name allowlist.
+
 ## Overrides
 
 LiteLLM metadata does not expose every OpenCode model field. The plugin includes exact built-in contracts for the currently approved GPT-5.4, GPT-5.5, GPT-5.6, DeepSeek V4 Flash, and Qwen3.8 aliases. Use `overrides` to customize those defaults or to add metadata for unknown models.

package/dist/mapping.js

@@ -169,8 +169,16 @@ function allowedByFilters(model, options) {
         return false;
     if (isRetiredModelAlias(name))
         return false;
-    if (options.includeModels?.length && !options.includeModels.includes(name))
+    const pinned = options.includeModels?.includes(name) ?? false;
+    if (options.includeBackends !== undefined) {
+        const backend = model.model_info?.backend;
+        const backendMatched = typeof backend === "string" && options.includeBackends.includes(backend);
+        if (!backendMatched && !pinned)
+            return false;
+    }
+    else if (options.includeModels?.length && !pinned) {
         return false;
+    }
     if (options.excludeModels?.includes(name))
         return false;
     const modelMode = mode(model);

package/dist/types.d.ts

@@ -123,6 +123,8 @@ export type LiteLLMPluginOptions = {
     includeModes?: string[];
     excludeModels?: string[];
     includeModels?: string[];
+    /** Exact model_info.backend matches, unioned with includeModels pins. */
+    includeBackends?: string[];
     timeoutMs?: number;
     strict?: boolean;
 };
@@ -134,6 +136,7 @@ export type LiteLLMModelInfo = JsonObject & {
     model_info?: JsonObject & {
         id?: string;
         base_model?: string;
+        backend?: unknown;
         mode?: string;
         input_cost_per_token?: number | string;
         output_cost_per_token?: number | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staticeng/opencode-litellm",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "OpenCode plugin that discovers LiteLLM models at runtime.",
   "type": "module",
   "license": "MIT",