@shop-os/modelkit 0.6.1 → 0.7.1

package/CHANGELOG.md

@@ -9,6 +9,23 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.7.1] - Unreleased
+
+### Changed
+- FlashVSR (`flashvsr`) is retired (`replacedBy: "flux-video-upscale-precise"`). fal bills it per output megapixel-frame, but its price rows tier by the output's short edge, so square, wide and above-4k outputs were billed below cost (ENG-3314). The dev, stg and prod catalog rows were retired on 2026-10-21; this keeps a fresh seed the same.
+
+## [0.7.0] - Unreleased
+
+ENG-3272: Luma (Agents API, direct) image and video models.
+
+### Added
+- `luma` adapter for the Luma Agents API (`POST /v1/generations`, then poll). Key `LUMA_API_KEY` (alias `LUMA_AGENTS_API_KEY`); Sloosh reads `SLOOSH_LUMA_API_KEY`. `AdapterEndpoints.luma` overrides the base URL (default `https://agents.lumalabs.ai`). Video jobs reconnect by the Luma generation id (`resumeVideo`).
+- Image rows `uni-1` and `uni-1-max` (2K output). With no input image they generate from the prompt; with input images the first is the source to edit (`image_edit`) and up to 8 more are references.
+- Video rows `ray-3.2` (5 s text- or image-to-video with optional first and last frames), `ray-3.2-edit` (changes a 5-18 s source clip) and `ray-3.2-reframe` (changes a 5-10 s source clip to a new aspect ratio). Both outputs keep the source length, so neither row has a duration choice. Luma bills them its 5 s price for any source while the rows are priced per source second, so sources under 5 s are refused. Resolutions 360p, 720p and 1080p; 1080p is refused for 9:16 and 3:4 reframes (`onUnsupported: "coerce"` sends 720p). `ray-3.2` offers 5 s only: Luma bills a 10 s clip at 3x a 5 s clip, which a per-second price cannot express.
+- Video usage: `ray-3.2` reports its fixed 5 s block. Edit and reframe report the output length read from the MP4 (`moov/mvhd`, since Luma returns no duration), else the caller's measured `sourceVideo.durationSeconds`, and never under 5 s (Luma's minimum charge). The event carries the resolution Luma rendered (720p for a coerced vertical reframe). `VideoJob.poll()` reports a failed Luma generation as `failed` whatever its failure code.
+- `ray-3.2-edit` sends a first frame as the edit's guide frame (`video.start_frame`). A Uni edit keeps the source's shape and warns (`option_ignored`) when a ratio was asked for.
+- `dataOnlyCapable` refuses a luma video row whose id is not `ray-3.2`, `ray-3.2-edit` or `ray-3.2-reframe` (the adapter routes by catalog id) and a luma row whose `providerModelId` does not fit its type. `DataOnlyRow` now includes `id`.
+
 ## [0.6.1] - Unreleased
 
 ### Fixed

package/README.md

@@ -61,7 +61,7 @@ await clip.cleanup?.();
 
 A video job that outlives its caller can be rejoined with `resumeVideo`: pass the same
 request and the `jobId` from `generateVideo` and await `job.result()` as usual. Only the
-ark adapter (Seedance) supports it today; every other adapter throws `unsupported_option`.
+ark (Seedance) and luma (Ray 3.2) adapters support it today; every other adapter throws `unsupported_option`.
 
 ### Video tools
 
@@ -108,7 +108,7 @@ before submit), and `model3dPricingSku(row, options, inputs)` names the flat pri
 bills under; `model3dSkus(row)` lists them all, and pro-backend keeps a `credit_pricing_flat`
 row for each. All three are in the browser-safe catalog entry.
 
-Keys come from `process.env` by default: bare names for pro (`OPENAI_API_KEY`, `FAL_KEY`, `ARK_API_KEY` ...), the `ENTERPRISE_` prefix for enterprise and the `SLOOSH_` prefix for sloosh. Pass `keys: { pro, enterprise, sloosh }` to override. `tier: "sloosh"` uses the sloosh keys only: a missing key is a `ModelKitError` with code `auth`, never a fallback to pro.
+Keys come from `process.env` by default: bare names for pro (`OPENAI_API_KEY`, `FAL_KEY`, `ARK_API_KEY`, `LUMA_API_KEY` ...), the `ENTERPRISE_` prefix for enterprise and the `SLOOSH_` prefix for sloosh (sloosh reads `SLOOSH_LUMA_API_KEY` for Luma). Pass `keys: { pro, enterprise, sloosh }` to override. `tier: "sloosh"` uses the sloosh keys only: a missing key is a `ModelKitError` with code `auth`, never a fallback to pro.
 
 ## Browser-safe catalog
 
@@ -344,7 +344,7 @@ the app's secrets, not a Cloudflare gateway token.
 
 ## Adapters
 
-`ai-sdk-text`, `google-image`, `openai-image`, `google-genai` (Veo, Omni with `delivery: "uri"`, Lyria 3, Files API media parts), `ark` (Seedream, Seedance), `fal`, `replicate` (images, video, Lyria 2, MMAudio), `prodia`, `higgsfield`, `xai-video`. See `src/adapters/`.
+`ai-sdk-text`, `google-image`, `openai-image`, `google-genai` (Veo, Omni with `delivery: "uri"`, Lyria 3, Files API media parts), `ark` (Seedream, Seedance), `fal`, `replicate` (images, video, Lyria 2, MMAudio), `prodia`, `higgsfield`, `xai-video`, `luma` (Uni images, Ray 3.2 video via the Agents API; `LUMA_API_KEY`, base-url override `endpoints.luma`). See `src/adapters/`.
 
 ## Not in the package
 

package/dist/catalog.cjs

@@ -445,8 +445,59 @@ var FAL_IMAGE_MODELS = [
   }
 ];
 
-// src/catalog/image.ts
+// src/catalog/image-luma.ts
 var IMAGE_USAGE2 = { unit: "images" };
+var EXPOSURE2 = ["cowork", "space_builder"];
+var LOBE2 = "https://cdn.jsdelivr.net/npm/@lobehub/icons-static-png@1.97.0/light";
+var LUMA_LOGO = `${LOBE2}/luma-color.png`;
+var UNI_RATIOS = ["adaptive", "16:9", "3:2", "1:1", "2:3", "9:16"];
+function uniImage(id, label, providerModelId, description) {
+  return {
+    // https://docs.agents.lumalabs.ai: type "image" without references, else
+    // "image_edit" with the first reference as source and up to 8 more as
+    // image_ref. The output is always 2048 px on the long side.
+    id,
+    aliases: [],
+    label,
+    type: "image",
+    adapter: "luma",
+    providerModelId,
+    lifecycle: "active",
+    exposure: EXPOSURE2,
+    constraints: {
+      aspectRatios: [...UNI_RATIOS],
+      sizes: ["2K"],
+      references: { images: 9 },
+      supports: ["outputFormat"],
+      prompt: { referenceSyntax: "numbered", maxChars: 6e3 }
+    },
+    defaults: { size: "2K", aspectRatio: "adaptive" },
+    usage: { ...IMAGE_USAGE2 },
+    pricingKind: "image_size",
+    display: {
+      provider: "luma",
+      description,
+      logo: LUMA_LOGO
+    }
+  };
+}
+var LUMA_IMAGE_MODELS = [
+  uniImage(
+    "uni-1",
+    "Uni-1",
+    "uni-1",
+    "Luma Uni-1 fast image generation and editing; takes a prompt and up to 9 reference images and outputs 2K."
+  ),
+  uniImage(
+    "uni-1-max",
+    "Uni-1 Max",
+    "uni-1-max",
+    "Luma Uni-1 Max higher-quality image generation and editing; takes a prompt and up to 9 reference images and outputs 2K."
+  )
+];
+
+// src/catalog/image.ts
+var IMAGE_USAGE3 = { unit: "images" };
 var GEMINI_RATIOS = [
   "1:1",
   "2:3",
@@ -491,7 +542,7 @@ function geminiImage(id, label, aliases, sizes, display, exposure, references, p
     exposure,
     constraints,
     defaults: { size: "1K", aspectRatio: "1:1" },
-    usage: { ...IMAGE_USAGE2, slug: "gemini" },
+    usage: { ...IMAGE_USAGE3, slug: "gemini" },
     pricingKind: "image_size",
     display
   };
@@ -604,7 +655,7 @@ var IMAGE_MODELS = [
       prompt: GPT_IMAGE_PROMPT
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
-    usage: { ...IMAGE_USAGE2, slug: "gpt" },
+    usage: { ...IMAGE_USAGE3, slug: "gpt" },
     pricingKind: "image_size",
     display: {
       provider: "openai",
@@ -640,7 +691,7 @@ var IMAGE_MODELS = [
       prompt: GPT_IMAGE_PROMPT
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "openai",
@@ -675,7 +726,7 @@ var IMAGE_MODELS = [
       prompt: GPT_IMAGE_PROMPT
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "openai",
@@ -710,7 +761,7 @@ var IMAGE_MODELS = [
       supports: ["count", "outputFormat"]
     },
     defaults: { size: "1K", aspectRatio: "1:1", outputFormat: "png", count: 1 },
-    usage: { ...IMAGE_USAGE2, slug: "muse" },
+    usage: { ...IMAGE_USAGE3, slug: "muse" },
     pricingKind: "image_size",
     display: {
       provider: "meta",
@@ -737,7 +788,7 @@ var IMAGE_MODELS = [
       supports: ["quality", "count", "seed"]
     },
     defaults: { size: "2K", aspectRatio: "1:1", quality: "medium", count: 1 },
-    usage: { ...IMAGE_USAGE2, slug: "ideogram" },
+    usage: { ...IMAGE_USAGE3, slug: "ideogram" },
     pricingKind: "image_size",
     display: {
       provider: "ideogram",
@@ -762,7 +813,7 @@ var IMAGE_MODELS = [
       supports: ["seed", "outputFormat"]
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "bytedance",
@@ -800,7 +851,7 @@ var IMAGE_MODELS = [
       supports: ["seed"]
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "bytedance",
@@ -826,7 +877,7 @@ var IMAGE_MODELS = [
       prompt: { referenceSyntax: "numbered", maxChars: 32768 }
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "black-forest-labs",
@@ -853,7 +904,7 @@ var IMAGE_MODELS = [
       supports: []
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "google",
@@ -878,7 +929,7 @@ var IMAGE_MODELS = [
       supports: []
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
-    usage: { ...IMAGE_USAGE2 },
+    usage: { ...IMAGE_USAGE3 },
     pricingKind: "image_size",
     display: {
       provider: "google",
@@ -964,7 +1015,8 @@ var IMAGE_MODELS = [
       description: "Alibaba Qwen Image Edit Plus with Lightning and a skin-retouching LoRA; takes one or more reference images plus an edit prompt and outputs webp, jpg, or png."
     }
   },
-  ...FAL_IMAGE_MODELS
+  ...FAL_IMAGE_MODELS,
+  ...LUMA_IMAGE_MODELS
 ];
 
 // src/catalog/audio-formats.ts
@@ -1160,7 +1212,7 @@ var VEED_SUBTITLE_LANGUAGES = [
 ];
 
 // src/catalog/canvas-tools.ts
-var EXPOSURE2 = ["cowork", "space_builder"];
+var EXPOSURE3 = ["cowork", "space_builder"];
 var META_LOGO = "https://d31vvfpk2ppdyq.cloudfront.net/assets/characters/1787909065794-k9a7zz.png";
 var VEED_SUBTITLE_PRESETS = [
   "simple",
@@ -1202,7 +1254,7 @@ var SAM_3_IMAGE = {
   adapter: "fal",
   providerModelId: "fal-ai/sam-3/image",
   lifecycle: "active",
-  exposure: EXPOSURE2,
+  exposure: EXPOSURE3,
   constraints: {
     references: { images: 1 },
     requires: ["references"],
@@ -1225,7 +1277,7 @@ var VEED_SUBTITLES = {
   adapter: "fal",
   providerModelId: "veed/subtitles",
   lifecycle: "active",
-  exposure: EXPOSURE2,
+  exposure: EXPOSURE3,
   constraints: {
     supports: [],
     // fal: up to 2 hours at 1080p or below, 1 hour above.
@@ -3330,7 +3382,7 @@ var GOOGLE_LOGO = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a
 var MINIMAX_LOGO = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/f4c2e906-28b7-4a4a-b491-df8fef7808ed.png";
 var SYNC_LOGO = "https://cdn.jsdelivr.net/npm/@lobehub/icons-static-png@1.97.0/light/sync.png";
 var PER_CALL = { unit: "images" };
-var EXPOSURE3 = ["cowork", "space_builder"];
+var EXPOSURE4 = ["cowork", "space_builder"];
 var LIPSYNC_AUDIO = { audioSeconds: { max: 30 } };
 function elevenLabsTts(tts) {
   return {
@@ -3341,7 +3393,7 @@ function elevenLabsTts(tts) {
     adapter: "fal",
     providerModelId: tts.providerModelId,
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       voices: ELEVENLABS_VOICES,
       languages: tts.languages,
@@ -3366,7 +3418,7 @@ function geminiTts(id, label, description) {
     adapter: "fal",
     providerModelId,
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       voices: GEMINI_TTS_VOICES,
       supports: ["style"],
@@ -3389,7 +3441,7 @@ function syncLipsync(id, label, providerModelId, syncModel, description) {
     adapter: "fal",
     providerModelId,
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       requires: ["sourceVideo", "sourceAudio"],
       references: LIPSYNC_AUDIO,
@@ -3450,7 +3502,7 @@ var MEDIA_NODE_MODELS = [
     adapter: "fal",
     providerModelId: "fal-ai/minimax/speech-2.8-hd",
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       voices: MINIMAX_VOICES,
       languages: MINIMAX_SPEECH_LANGUAGES,
@@ -3475,7 +3527,7 @@ var MEDIA_NODE_MODELS = [
     adapter: "fal",
     providerModelId: "fal-ai/elevenlabs/voice-changer",
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       requires: ["sourceAudio"],
       // The flat price assumes at most a minute of speech.
@@ -3502,7 +3554,7 @@ var MEDIA_NODE_MODELS = [
     adapter: "fal",
     providerModelId: "fal-ai/elevenlabs/dubbing",
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       requiresOneOf: ["sourceVideo", "sourceAudio"],
       // The flat price covers 60 s of source.
@@ -3550,7 +3602,7 @@ var MEDIA_NODE_MODELS = [
     adapter: "fal",
     providerModelId: "veed/lipsync/v2",
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       requires: ["sourceVideo", "sourceAudio"],
       references: LIPSYNC_AUDIO,
@@ -3576,7 +3628,7 @@ var MEDIA_NODE_MODELS = [
     adapter: "fal",
     providerModelId: "minimax/h3-max/lip-sync/image-to-video",
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       requires: ["firstFrame", "sourceAudio"],
       resolutions: ["480p", "768p", "1080p", "2k"],
@@ -3602,7 +3654,7 @@ var MEDIA_NODE_MODELS = [
     adapter: "fal",
     providerModelId: "fal-ai/elevenlabs/speech-to-text/scribe-v2",
     lifecycle: "active",
-    exposure: EXPOSURE3,
+    exposure: EXPOSURE4,
     constraints: {
       requires: ["sourceAudio"],
       // The flat price covers 10 minutes of audio.
@@ -5138,8 +5190,113 @@ var VIDEO_FAMILY_MODELS = [
   }
 ];
 
-// src/catalog/video.ts
+// src/catalog/video-luma.ts
 var VIDEO_USAGE2 = { unit: "seconds" };
+var EXPOSURE5 = ["cowork", "space_builder"];
+var LUMA_LOGO2 = "https://cdn.jsdelivr.net/npm/@lobehub/icons-static-png@1.97.0/light/luma-color.png";
+var RAY_RATIOS = ["9:16", "3:4", "1:1", "4:3", "16:9", "21:9"];
+var RAY_RESOLUTIONS = ["360p", "720p", "1080p"];
+var RAY_PROMPT = { referenceSyntax: "numbered", maxChars: 6e3 };
+var LUMA_VIDEO_MODELS = [
+  {
+    // https://docs.agents.lumalabs.ai: type "video" with a fixed 5 s duration;
+    // firstFrame and lastFrame ride as start_frame and end_frame.
+    id: "ray-3.2",
+    aliases: [],
+    label: "Ray 3.2",
+    type: "video",
+    adapter: "luma",
+    providerModelId: "ray-3.2",
+    lifecycle: "active",
+    exposure: EXPOSURE5,
+    constraints: {
+      aspectRatios: ["adaptive", ...RAY_RATIOS],
+      resolutions: [...RAY_RESOLUTIONS],
+      durations: [5],
+      supports: ["lastFrame"],
+      prompt: { ...RAY_PROMPT },
+      audio: "never"
+    },
+    defaults: { durationSeconds: 5, resolution: "720p", aspectRatio: "adaptive" },
+    usage: { ...VIDEO_USAGE2 },
+    pricingKind: "video_per_second",
+    display: {
+      provider: "luma",
+      description: "Luma Ray 3.2 text- and image-to-video with optional first and last frames, 5-second clips at up to 1080p.",
+      logo: LUMA_LOGO2
+    },
+    capabilities: {}
+  },
+  {
+    // https://docs.agents.lumalabs.ai: type "video_edit" with a source video of
+    // up to 18 s; the output keeps the source length, so there is no durations
+    // knob, no aspect_ratio and no end frame. Luma bills its 5 s price for any
+    // source (live, 2026-10-21) and the row is priced per source second, so a
+    // source under 5 s is refused: it would be billed below Luma's charge.
+    id: "ray-3.2-edit",
+    aliases: [],
+    label: "Ray 3.2 Edit",
+    type: "video",
+    adapter: "luma",
+    providerModelId: "ray-3.2",
+    lifecycle: "active",
+    exposure: EXPOSURE5,
+    constraints: {
+      resolutions: [...RAY_RESOLUTIONS],
+      requires: ["sourceVideo"],
+      sourceVideoSeconds: { min: 5, max: 18 },
+      supports: [],
+      prompt: { ...RAY_PROMPT },
+      audio: "never"
+    },
+    defaults: { resolution: "720p" },
+    usage: { ...VIDEO_USAGE2 },
+    pricingKind: "video_per_second",
+    display: {
+      provider: "luma",
+      description: "Luma Ray 3.2 video edit: changes a 5-18 second clip from a prompt, keeping its length.",
+      logo: LUMA_LOGO2
+    },
+    capabilities: { acceptsSourceVideo: true, videoEdit: true }
+  },
+  {
+    // https://docs.agents.lumalabs.ai: type "video_reframe" with a required
+    // target aspect_ratio; the source is up to 10 s and the output keeps its
+    // length whatever video.duration says, while Luma bills that duration
+    // (live, 2026-10-21). So there is no durations knob, and a source under
+    // 5 s is refused, as on ray-3.2-edit. 1080p is not offered for the
+    // vertical targets 9:16 and 3:4.
+    id: "ray-3.2-reframe",
+    aliases: [],
+    label: "Ray 3.2 Reframe",
+    type: "video",
+    adapter: "luma",
+    providerModelId: "ray-3.2",
+    lifecycle: "active",
+    exposure: EXPOSURE5,
+    constraints: {
+      aspectRatios: [...RAY_RATIOS],
+      resolutions: [...RAY_RESOLUTIONS],
+      requires: ["sourceVideo"],
+      sourceVideoSeconds: { min: 5, max: 10 },
+      supports: [],
+      prompt: { ...RAY_PROMPT },
+      audio: "never"
+    },
+    defaults: { resolution: "720p", aspectRatio: "16:9" },
+    usage: { ...VIDEO_USAGE2 },
+    pricingKind: "video_per_second",
+    display: {
+      provider: "luma",
+      description: "Luma Ray 3.2 Reframe: changes a 5-10 second clip to a new aspect ratio and fills the new area from the prompt.",
+      logo: LUMA_LOGO2
+    },
+    capabilities: { acceptsSourceVideo: true, videoEdit: true }
+  }
+];
+
+// src/catalog/video.ts
+var VIDEO_USAGE3 = { unit: "seconds" };
 var SEEDANCE_RATIOS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "adaptive"];
 var KLING_RATIOS2 = ["16:9", "9:16", "1:1", "adaptive"];
 var KLING_OMNI_RATIOS = ["16:9", "9:16", "1:1"];
@@ -5192,7 +5349,7 @@ var VIDEO_MODELS = [
       audio: "always"
     },
     defaults: { durationSeconds: 8, resolution: "720p", aspectRatio: "16:9" },
-    usage: { ...VIDEO_USAGE2, slug: "veo" },
+    usage: { ...VIDEO_USAGE3, slug: "veo" },
     pricingKind: "video_per_second",
     display: {
       provider: "google",
@@ -5225,7 +5382,7 @@ var VIDEO_MODELS = [
       audio: "always"
     },
     defaults: { durationSeconds: 8, resolution: "720p", aspectRatio: "16:9" },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "google",
@@ -5255,7 +5412,7 @@ var VIDEO_MODELS = [
       audio: "always"
     },
     defaults: { durationSeconds: 8, resolution: "720p", aspectRatio: "16:9" },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "google",
@@ -5292,7 +5449,7 @@ var VIDEO_MODELS = [
       audio: "always"
     },
     defaults: {},
-    usage: { ...VIDEO_USAGE2, slug: "gemini_omni" },
+    usage: { ...VIDEO_USAGE3, slug: "gemini_omni" },
     pricingKind: "video_per_second",
     display: {
       provider: "google",
@@ -5329,7 +5486,7 @@ var VIDEO_MODELS = [
       audio: "always"
     },
     defaults: {},
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "google",
@@ -5378,7 +5535,7 @@ var VIDEO_MODELS = [
       aspectRatio: "16:9",
       generateAudio: true
     },
-    usage: { ...VIDEO_USAGE2, slug: "seedance2", providerLabel: "byteplus" },
+    usage: { ...VIDEO_USAGE3, slug: "seedance2", providerLabel: "byteplus" },
     pricingKind: "video_per_second",
     display: {
       provider: "bytedance",
@@ -5421,7 +5578,7 @@ var VIDEO_MODELS = [
       aspectRatio: "16:9",
       generateAudio: true
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "bytedance",
@@ -5471,7 +5628,7 @@ var VIDEO_MODELS = [
       aspectRatio: "16:9",
       generateAudio: true
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "bytedance",
@@ -5533,7 +5690,7 @@ var VIDEO_MODELS = [
       cfgScale: 0.5,
       negativePrompt: NEGATIVE_PROMPT
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "kuaishou",
@@ -5565,7 +5722,7 @@ var VIDEO_MODELS = [
       cfgScale: 0.5,
       generateAudio: true
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "kuaishou",
@@ -5633,7 +5790,7 @@ var VIDEO_MODELS = [
       aspectRatio: "16:9",
       promptExpansion: "balanced"
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "minimax",
@@ -5667,7 +5824,7 @@ var VIDEO_MODELS = [
       aspectRatio: "16:9",
       promptExpansion: "balanced"
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "minimax",
@@ -5709,7 +5866,7 @@ var VIDEO_MODELS = [
       aspectRatio: "adaptive",
       promptExpansion: "balanced"
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "minimax",
@@ -5753,7 +5910,7 @@ var VIDEO_MODELS = [
       aspectRatio: "adaptive",
       promptExpansion: "balanced"
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "minimax",
@@ -5798,7 +5955,7 @@ var VIDEO_MODELS = [
       aspectRatio: "adaptive",
       generateAudio: true
     },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "alibaba",
@@ -5825,7 +5982,7 @@ var VIDEO_MODELS = [
       audio: "never"
     },
     defaults: { durationSeconds: 5, aspectRatio: "16:9" },
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "kuaishou",
@@ -5874,7 +6031,7 @@ var VIDEO_MODELS = [
       audio: "never"
     },
     defaults: {},
-    usage: { ...VIDEO_USAGE2 },
+    usage: { ...VIDEO_USAGE3 },
     // Higgsfield bills DoP per generation: a fixed-length clip with no duration knob.
     pricingKind: "flat",
     display: {
@@ -5883,7 +6040,8 @@ var VIDEO_MODELS = [
     },
     capabilities: {}
   },
-  ...VIDEO_FAMILY_MODELS
+  ...VIDEO_FAMILY_MODELS,
+  ...LUMA_VIDEO_MODELS
 ];
 
 // src/catalog/video-tools.ts
@@ -6049,14 +6207,17 @@ var VIDEO_TOOL_MODELS = [
   {
     // https://fal.ai/models/fal-ai/flashvsr/upscale/video/api: upscale_factor 1-4, X264 MP4
     // by default; fal bills $0.0005 per output megapixel-frame (width x height x frames).
+    // Retired (ENG-3314): the price rows tier by short edge, which under-prices square, wide
+    // and above-4k outputs.
     id: "flashvsr",
     aliases: ["flashvsr-upscale"],
     label: "FlashVSR",
     type: "video-tool",
     adapter: "fal",
     providerModelId: "fal-ai/flashvsr/upscale/video",
-    lifecycle: "active",
-    exposure: ["cowork", "space_builder"],
+    lifecycle: "retired",
+    replacedBy: "flux-video-upscale-precise",
+    exposure: [],
     constraints: {
       supports: [],
       tool: { kind: "upscale", upscaleFactor: { min: 1, max: 4 } }
@@ -6863,7 +7024,8 @@ var ADAPTER_IDS = [
   "replicate",
   "prodia",
   "higgsfield",
-  "xai-video"
+  "xai-video",
+  "luma"
 ];
 var ModelTypeSchema = import_zod3.z.enum([
   "text",