@staticeng/opencode-litellm 0.3.2 → 0.3.3

package/README.md

@@ -188,3 +188,7 @@ publisher for package `@staticeng/opencode-litellm` with this repository, workfl
 The exact discovered aliases `5090-local-model` and `5090-local-model-codex` use the Qwen3.8 Flash Next Strata contract: text/image input, text output, reasoning, tools, and 262144 tokens of shared context. The output ceiling is 262144 within that shared window; it is not an additional output budget. Pricing continues to come from LiteLLM metadata.
 
 Both aliases preserve their routable IDs and use Chat Completions in OpenCode. Their public variants are `off`, `low`, `medium`, and `xhigh` (default `xhigh`): `off` sends `reasoning_effort: "none"`; the other variants send their named effort. Strata accepts `high` and `max` as aliases of native `xhigh`; they are not distinct variants. This differs from the cloud Qwen contract and does not alter it. The `-codex` alias remains available to Codex via LiteLLM's separate Responses adapter. No alias is fabricated when discovery omits it; explicit model/provider overrides still win.
+
+## Native image models (OpenCode 2.2+)
+
+Current V2 discovery includes LiteLLM `image_generation` deployments as `type: "image"` using the native OpenAI-compatible Images driver. They are available to OpenCode image generation and OpenChamber image model settings, separately from conversation models. Explicit `includeModes` and model filters still apply. Legacy and transitional catalogs omit image deployments. Generation uses `/images/generations`; reference images use `/images/edits`.

package/dist/mapping.d.ts

@@ -18,7 +18,7 @@ export declare function mapModels(response: unknown, options?: LiteLLMPluginOpti
     [k: string]: OpenCodeModel;
 };
 export declare function buildProvider(models: unknown, options?: LiteLLMPluginOptions): OpenCodeProvider;
-export declare function mapModelsV2(models: unknown, options?: LiteLLMPluginOptions): {
+export declare function mapModelsV2(models: unknown, options?: LiteLLMPluginOptions, nativeImages?: boolean): {
     [k: string]: OpenCodeModelV2 | {
         variants: {
             id: string;
@@ -26,6 +26,7 @@ export declare function mapModelsV2(models: unknown, options?: LiteLLMPluginOpti
                 [x: string]: unknown;
             };
         }[];
+        type?: "image";
         family?: string;
         name?: string;
         api?: {
@@ -63,4 +64,4 @@ export declare function mapModelsV2(models: unknown, options?: LiteLLMPluginOpti
         };
     };
 };
-export declare function buildProviderV2(models: unknown, options?: LiteLLMPluginOptions): OpenCodeProviderV2;
+export declare function buildProviderV2(models: unknown, options?: LiteLLMPluginOptions, nativeImages?: boolean): OpenCodeProviderV2;

package/dist/mapping.js

@@ -167,7 +167,7 @@ export function normalizeModelListResponse(response) {
 function mode(model) {
     return asString(model.model_info?.mode) ?? "chat";
 }
-function allowedByFilters(model, options) {
+function allowedByFilters(model, options, nativeImages = false) {
     const name = modelName(model);
     if (!name)
         return false;
@@ -186,8 +186,13 @@ function allowedByFilters(model, options) {
     if (options.excludeModels?.includes(name))
         return false;
     const modelMode = mode(model);
+    // Images require the typed catalog and media resolver introduced in current V2.
+    if (modelMode === "image_generation" && !nativeImages)
+        return false;
     if (options.includeModes?.length)
         return options.includeModes.includes(modelMode);
+    if (modelMode === "image_generation")
+        return nativeImages;
     return DEFAULT_MODES.has(modelMode) && !NON_CHAT_MODES.has(modelMode);
 }
 function cost(model) {
@@ -330,6 +335,15 @@ function generatedModel(model, tombstones = false) {
     const name = modelName(model);
     if (!name)
         return undefined;
+    if (mode(model) === "image_generation")
+        return {
+            id: name,
+            name,
+            type: "image",
+            provider: { npm: "@opencode/ai/providers/openai-compatible/images" },
+            modalities: { input: supportedModalities(["text", ...(model.model_info?.supported_modalities ?? [])]), output: ["image"] },
+            tool_call: false,
+        };
     const mappedModalities = modalities(model);
     const discoveredVariants = supportsReasoning(model) ? reasoningVariants(model) : undefined;
     const suppressDiscoveredVariants = modelContract(name)?.suppressDiscoveredVariants === true;
@@ -403,6 +417,7 @@ function v2Model(model, baseURL) {
     const name = asString(model.name);
     const family = asString(model.family);
     return {
+        ...(model.type === "image" ? { type: "image" } : {}),
         ...(family ? { family } : {}),
         ...(name ? { name } : {}),
         api: {
@@ -425,10 +440,10 @@ function v2Model(model, baseURL) {
         ...(v2Variants(model) ? { variants: v2Variants(model) } : {}),
     };
 }
-function mapModelsInternal(response, options, tombstones) {
+function mapModelsInternal(response, options, tombstones, nativeImages = false) {
     const models = normalizeModelListResponse(response);
     return Object.fromEntries(models
-        .filter((model) => allowedByFilters(model, options))
+        .filter((model) => allowedByFilters(model, options, nativeImages))
         .map((model) => {
         const name = modelName(model);
         const generated = generatedModel(model, tombstones);
@@ -458,8 +473,8 @@ export function buildProvider(models, options = {}) {
         models: mapModelsInternal(models, options, true),
     }, options.providerOverrides);
 }
-export function mapModelsV2(models, options = {}) {
-    const legacy = mapModels(models, options);
+export function mapModelsV2(models, options = {}, nativeImages = false) {
+    const legacy = mapModelsInternal(models, options, false, nativeImages);
     return Object.fromEntries(Object.entries(legacy).map(([name, model]) => {
         const mapped = v2Model(model, options.baseURL);
         const variants = contractV2Variants(name, model, options.overrides?.[name]);
@@ -504,7 +519,7 @@ function responsesBody(options) {
     }
     return body;
 }
-export function buildProviderV2(models, options = {}) {
+export function buildProviderV2(models, options = {}, nativeImages = false) {
     return deepMerge({
         name: options.providerName ?? "LiteLLM",
         api: {
@@ -518,6 +533,6 @@ export function buildProviderV2(models, options = {}) {
                 ...(options.apiKey ? { apiKey: options.apiKey } : {}),
             },
         },
-        models: mapModelsV2(models, options),
+        models: mapModelsV2(models, options, nativeImages),
     }, options.providerOverrides);
 }

package/dist/types.d.ts

@@ -27,6 +27,7 @@ export type ModelContract = Readonly<{
     metadata?: ModelContractMetadata;
 }>;
 export type OpenCodeModel = JsonObject & {
+    type?: "image";
     provider?: {
         npm?: string;
         api?: string;
@@ -54,6 +55,7 @@ export type OpenCodeModel = JsonObject & {
     variants?: Record<string, JsonObject>;
 };
 export type OpenCodeModelV2 = JsonObject & {
+    type?: "image";
     family?: string;
     name?: string;
     api?: {

package/dist/v2.js

@@ -5,6 +5,13 @@ import { resolveOptions } from "./options.js";
 const CHAT_PACKAGE = "@opencode/ai/providers/openai-compatible";
 // The 2.0.16 binary bundles this driver, but not openai-compatible/responses.
 const RESPONSES_PACKAGE = "@opencode/ai/providers/openai/responses";
+/** Image catalog types and their resolver are available in OpenCode 2.2+. */
+function supportsNativeImages(ctx) {
+    const version = ctx.app?.version?.match(/^v?(\d+)\.(\d+)\.(\d+)(?:$|[-+])/);
+    if (!version)
+        return false;
+    return Number(version[1]) > 2 || (Number(version[1]) === 2 && Number(version[2]) >= 2);
+}
 function packageName(name) {
     if (name === "@ai-sdk/openai" || name === "@opencode/ai/providers/openai-compatible/responses")
         return RESPONSES_PACKAGE;
@@ -49,6 +56,7 @@ function currentModel(providerID, id, config, providerPackage) {
     }
     return {
         id,
+        ...(config.type === "image" ? { type: "image" } : {}),
         modelID: config.api?.id ?? id,
         providerID,
         name: config.name ?? id,
@@ -250,7 +258,7 @@ const LiteLLMPluginV2 = {
                     // Opaque Responses aliases need the same transport as GPT-named models.
                     overrides[id] = deepMerge({ provider: { npm: "@ai-sdk/openai" } }, overrides[id]);
                 }
-                provider = buildProviderV2(models, { ...options, overrides });
+                provider = buildProviderV2(models, { ...options, overrides }, supportsNativeImages(ctx));
                 for (const model of models) {
                     if (model.model_info?.use_responses_lite !== true)
                         continue;

package/package.json

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