@shop-os/modelkit 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -9,6 +9,24 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.4.2] - Unreleased
+
+### Added
+- `wan-3.0` (Wan 3) video row on the fal adapter (`alibaba/wan-3.0`), listed on `cowork` and `space_builder`. One row covers fal's three endpoints and the adapter picks one from the inputs: references (up to 10 images, 5 videos, 5 audio clips; 15 s of video and 15 s of audio in all) go to `/reference-to-video`, a first frame (optionally with a last frame) to `/image-to-video`, and a bare prompt to `/text-to-video`. 480p/720p/1080p, 2-30 s, `adaptive` plus five fixed ratios, switchable audio (default on), seed and the safety checker. Frames and references are exclusive (`framesExcludeReferences`), and a last frame needs a first frame (`lastFrameRequiresFirstFrame`): image-to-video requires `start_image_url`. Prompt expansion is left at fal's default (on); `file_url` / `web_url` and `enable_thinking` are not exposed.
+
+### Live rows
+pro-backend's boot `seed-model-catalog` inserts the row listed once a consumer on 0.4.2 deploys; seed its `credit_pricing_video` rows first.
+
+## [0.4.1] - Unreleased
+
+### Changed
+- `veo-3.1`, `veo-3.1-fast`, `veo-3.1-lite` and `gemini-omni-flash` are `deprecated`, replaced by `gemini-omni-1.1-flash`, with no exposure. Google shuts down their provider models (`veo-3.1-generate-preview`, `veo-3.1-fast-generate-preview`, `veo-3.1-lite-generate-preview`, `gemini-omni-flash-preview`) on 2026-10-22. The rows still resolve, so stored ids keep working until then.
+- `gemini-3-pro-image-preview` sends `gemini-3-pro-image` and `gemini-3.1-flash-image-preview` sends `gemini-3.1-flash-image`: Google listed the preview endpoints for shutdown on 2026-06-25, and the GA ids cost the same. The catalog ids are unchanged, since they are pricing keys and stored model ids.
+- `higgsfield-dop-preview` is priced `flat`: Higgsfield bills DoP per generation, a fixed-length clip with no duration knob.
+
+### Live rows
+pro-backend's `apply-model-shutdowns` script (PR #1486) makes the same changes to the live `model_catalog` rows per environment, including clearing the deprecated rows' exposure.
+
 ## [0.4.0] - Unreleased
 
 ### Added

package/dist/catalog.cjs

@@ -275,35 +275,43 @@ var IMAGE_MODELS = [
     GEMINI_PROMPT_MAX_CHARS,
     NANO_BANANA_2_1_RATIOS
   ),
-  geminiImage(
-    "gemini-3-pro-image-preview",
-    "Nano Banana Pro",
-    ["nb-pro"],
-    ["1K", "2K", "4K"],
-    {
-      provider: "google",
-      description: "Create stunning, production-quality visuals with exceptional realism, detail, and typography. Best for campaigns, e-commerce, product photography, and hero creatives.",
-      logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
-    },
-    ["cowork", "space_builder"],
-    { images: 14 },
-    GEMINI_PROMPT_MAX_CHARS
-  ),
-  geminiImage(
-    "gemini-3.1-flash-image-preview",
-    "Nano Banana 2",
-    ["nb-2"],
-    // Flash 3.1 is the only Gemini image model with the 512 tier.
-    ["512", "1K", "2K", "4K"],
-    {
-      provider: "google",
-      description: "Generate high-quality images at speed. Perfect for brainstorming, concept boards, concept testing, creative exploration, and large batch workflows.",
-      logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
-    },
-    ["cowork", "space_builder"],
-    { images: 14 },
-    GEMINI_PROMPT_MAX_CHARS
-  ),
+  // Google retired the -preview endpoints for the GA ids; the catalog ids stay because they
+  // are pricing keys and stored model ids.
+  {
+    ...geminiImage(
+      "gemini-3-pro-image-preview",
+      "Nano Banana Pro",
+      ["nb-pro"],
+      ["1K", "2K", "4K"],
+      {
+        provider: "google",
+        description: "Create stunning, production-quality visuals with exceptional realism, detail, and typography. Best for campaigns, e-commerce, product photography, and hero creatives.",
+        logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
+      },
+      ["cowork", "space_builder"],
+      { images: 14 },
+      GEMINI_PROMPT_MAX_CHARS
+    ),
+    providerModelId: "gemini-3-pro-image"
+  },
+  {
+    ...geminiImage(
+      "gemini-3.1-flash-image-preview",
+      "Nano Banana 2",
+      ["nb-2"],
+      // Flash 3.1 is the only Gemini image model with the 512 tier.
+      ["512", "1K", "2K", "4K"],
+      {
+        provider: "google",
+        description: "Generate high-quality images at speed. Perfect for brainstorming, concept boards, concept testing, creative exploration, and large batch workflows.",
+        logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
+      },
+      ["cowork", "space_builder"],
+      { images: 14 },
+      GEMINI_PROMPT_MAX_CHARS
+    ),
+    providerModelId: "gemini-3.1-flash-image"
+  },
   geminiImage(
     "gemini-3.1-flash-lite-image",
     "Nano Banana Lite",
@@ -1423,6 +1431,7 @@ var OMNI_RATIOS = ["16:9", "9:16"];
 var GROK_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"];
 var H3_RATIOS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"];
 var H3_REFERENCE_RATIOS = ["adaptive", ...H3_RATIOS];
+var WAN_RATIOS = ["adaptive", "16:9", "4:3", "1:1", "3:4", "9:16"];
 var NEGATIVE_PROMPT = "blur, distort, and low quality";
 var FRAMES_EXCLUDE_REFERENCES = { framesExcludeReferences: true };
 var KLING_PROMPT = { referenceSyntax: "numbered", maxChars: 2500 };
@@ -1433,10 +1442,12 @@ var SEEDANCE_2_AUDIO = {
   audioMaxBytes: 15 * 1024 * 1024
 };
 var H3_PROMPT = { referenceSyntax: "numbered", maxChars: 5e4 };
+var WAN_PROMPT = { referenceSyntax: "numbered", maxChars: 2e4 };
 var OMNI_PROMPT = { referenceSyntax: "caption", maxChars: 5e4 };
 var BYTEDANCE_LOGO = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/3bba5d81-4e57-4e71-911b-cdfa05acca2c_compressed.png";
 var GOOGLE_LOGO2 = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png";
 var VIDEO_MODELS = [
+  // Google shuts down the Veo 3.1 previews and Omni Flash 1.0 on 2026-10-22.
   {
     id: "veo-3.1",
     aliases: [
@@ -1449,8 +1460,9 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "veo-3.1-generate-preview",
-    lifecycle: "active",
-    exposure: ["cowork", "space_builder"],
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
+    exposure: [],
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
       resolutions: ["720p", "1080p", "4k"],
@@ -1485,7 +1497,8 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "veo-3.1-fast-generate-preview",
-    lifecycle: "active",
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
     exposure: [],
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
@@ -1515,7 +1528,8 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "veo-3.1-lite-generate-preview",
-    lifecycle: "active",
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
     exposure: [],
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
@@ -1546,8 +1560,9 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "gemini-omni-flash-preview",
-    lifecycle: "active",
-    exposure: ["cowork", "space_builder"],
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
+    exposure: [],
     constraints: {
       // 1.0 rejects `resolution`; it renders 720p. No defaults: the adapter
       // sends ratio and duration only when the caller set them, so a
@@ -2033,6 +2048,48 @@ var VIDEO_MODELS = [
     // references instead of the adapter silently dropping the frame.
     capabilities: { ...FRAMES_EXCLUDE_REFERENCES }
   },
+  {
+    // One row for fal's three Wan 3.0 endpoints; the adapter picks text-, image- or
+    // reference-to-video from the inputs. Each takes aspect_ratio, so none is ignored.
+    // https://fal.ai/models/alibaba/wan-3.0/reference-to-video/api
+    id: "wan-3.0",
+    aliases: ["wan-3", "wan3"],
+    label: "Wan 3",
+    type: "video",
+    adapter: "fal",
+    providerModelId: "alibaba/wan-3.0",
+    lifecycle: "active",
+    exposure: ["cowork", "space_builder"],
+    constraints: {
+      aspectRatios: [...WAN_RATIOS],
+      resolutions: ["480p", "720p", "1080p"],
+      durations: { min: 2, max: 30 },
+      durationPresets: [5, 10, 15, 30],
+      references: {
+        images: 10,
+        videos: 5,
+        audios: 5,
+        videoSeconds: { total: 15 },
+        audioSeconds: { total: 15 }
+      },
+      supports: ["seed", "lastFrame", "generateAudio", "safetyChecker"],
+      prompt: WAN_PROMPT,
+      audio: "optional"
+    },
+    defaults: {
+      durationSeconds: 5,
+      resolution: "1080p",
+      aspectRatio: "adaptive",
+      generateAudio: true
+    },
+    usage: { ...VIDEO_USAGE },
+    pricingKind: "video_per_second",
+    display: {
+      provider: "alibaba",
+      description: "Alibaba Wan 3 video model for text-to-video, image-to-video (start/end frame), and reference-to-video from up to 10 images, 5 videos and 5 audio clips, with native audio; 2-30 seconds at up to 1080p."
+    },
+    capabilities: { ...FRAMES_EXCLUDE_REFERENCES, lastFrameRequiresFirstFrame: true }
+  },
   {
     // Duration 3-10s per trigger-workflows mapDuration; the endpoint takes no resolution.
     id: "kling-o1-v2v",
@@ -2102,7 +2159,8 @@ var VIDEO_MODELS = [
     },
     defaults: {},
     usage: { ...VIDEO_USAGE },
-    pricingKind: "video_per_second",
+    // Higgsfield bills DoP per generation: a fixed-length clip with no duration knob.
+    pricingKind: "flat",
     display: {
       provider: "higgsfield",
       description: "Higgsfield DOP image-to-video model; animates a required first-frame image from a text prompt with an optional last-frame image and motion controls."