@shop-os/modelkit 0.7.7 → 0.7.10

package/CHANGELOG.md

@@ -9,6 +9,24 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.7.10] - Unreleased
+
+Kling V3 Omni moves from Replicate to fal at half the provider cost.
+
+### Changed
+- `kling-v3-omni-video` runs on fal Kling O3 (`adapter: "fal"`, `providerModelId: "fal-ai/kling-video/o3"`) instead of Replicate `kwaivgi/kling-v3-omni-video`. The id, aliases, ratios, resolutions, durations, defaults and the `mode` to resolution rule stay. The tier picks the endpoint path (`standard` 720p, `pro` 1080p, `4k`), and the inputs pick the task: reference images go to `reference-to-video`, frames alone to `image-to-video`, a prompt alone to `text-to-video`. A lone end frame still goes as the start frame. fal cost per second: standard $0.084 silent / $0.112 sound, pro $0.112 / $0.14, 4k $0.42 (Replicate: $0.168 / $0.224, $0.224 / $0.28, $0.42).
+- The row's usage unit is `seconds` (was Replicate `compute_seconds`): usage events now carry provider `fal`, the requested length and the rendered resolution.
+- The row declares `videos: 0, audios: 0` (was no video slot and a dormant `imagesWithVideo: 4`). The Replicate adapter never sent a reference video, so nothing that worked is lost; the resolver now trims one with `references_trimmed` instead of passing it through. Frames and reference images share fal's cap of 7, as on `kling-o3`. The display description no longer claims editing or reference video.
+- The Replicate `kwaivgi/kling-v3-omni-video` mapper stays. `seed-model-catalog` never updates an existing row, so each deployed `model_catalog` row keeps running on Replicate after the bump, until it is switched to this row's `adapter`, `providerModelId`, `references` and `usage` (pro-admin, per env). Reverting that edit rolls back.
+- Consumers that branch on `adapter === "replicate"` for this row (shopos-ui vibe-triggers, the trigger-workflows wire test) must handle the fal row before an env is switched.
+
+## [0.7.8] - Unreleased
+
+ENG-3324: Ray 3.2 offers 10 s clips.
+
+### Changed
+- `ray-3.2` offers `durations: [5, 10]` (was `[5]`); the default stays 5 s. The Luma adapter sends the requested length (`"10s"`) instead of a fixed `"5s"`, and a generate reports the block it asked for (5 or 10) as `durationSeconds`, never the measured frames. A generate of any other length is refused with `unsupported_option` before a request, since nothing prices it. Luma bills a 10 s clip at 3x the 5 s price; pro-backend prices it through its billed-seconds map (`{"10": 15}`), so usage keeps the real 10 s. Consumers must not offer this version before that pricing is deployed, or a 10 s clip bills 2x.
+
 ## [0.7.7] - Unreleased
 
 ### Fixed

package/dist/catalog.cjs

@@ -5201,8 +5201,10 @@ 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.
+    // https://docs.agents.lumalabs.ai: type "video" with a 5 s or 10 s duration;
+    // firstFrame and lastFrame ride as start_frame and end_frame. Luma bills a
+    // 10 s clip at 3x the 5 s price; pro-backend prices it that way, so this row
+    // must not offer 10 s before that pricing is deployed (ENG-3324).
     id: "ray-3.2",
     aliases: [],
     label: "Ray 3.2",
@@ -5214,7 +5216,7 @@ var LUMA_VIDEO_MODELS = [
     constraints: {
       aspectRatios: ["adaptive", ...RAY_RATIOS],
       resolutions: [...RAY_RESOLUTIONS],
-      durations: [5],
+      durations: [5, 10],
       supports: ["lastFrame"],
       prompt: { ...RAY_PROMPT },
       audio: "never"
@@ -5224,7 +5226,7 @@ var LUMA_VIDEO_MODELS = [
     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.",
+      description: "Luma Ray 3.2 text- and image-to-video with optional first and last frames, 5- or 10-second clips at up to 1080p.",
       logo: LUMA_LOGO2
     },
     capabilities: {}
@@ -5734,38 +5736,38 @@ var VIDEO_MODELS = [
     capabilities: { ...FRAMES_EXCLUDE_REFERENCES }
   },
   {
-    // mode standard/pro/4k selects 720p/1080p/4K; the endpoint takes no separate resolution.
-    // Replicate: "Max 7 [images] without video, 4 with video"; 4K does not support
-    // reference_video. No `videos` limit yet: the adapter sends no reference video,
-    // so `imagesWithVideo` stays dormant until one is wired through.
+    // fal Kling O3 (adapters/fal-kling-omni.ts): mode standard/pro/4k selects 720p/1080p/4K
+    // in the endpoint path. Moved off Replicate kwaivgi/kling-v3-omni-video, which fal sells
+    // at half the price; the id and inputs stay. The Replicate mapper stays for deployed
+    // model_catalog rows not yet switched. Frames and reference images share fal's cap of 7.
+    // Reference video, multi-shot and keep-sound were never wired, so stay off.
     id: "kling-v3-omni-video",
     aliases: ["kwaivgi/kling-v3-omni-video", "kling-v3-omni"],
     label: "Kling V3 Omni",
     type: "video",
-    adapter: "replicate",
-    providerModelId: "kwaivgi/kling-v3-omni-video",
+    adapter: "fal",
+    providerModelId: "fal-ai/kling-video/o3",
     lifecycle: "active",
     exposure: ["cowork", "space_builder"],
     constraints: {
       aspectRatios: [...KLING_OMNI_RATIOS],
       resolutions: ["720p", "1080p", "4k"],
       durations: { min: 3, max: 15 },
-      references: { images: 7, imagesWithVideo: 4 },
+      references: { images: 7, videos: 0, audios: 0 },
       supports: ["generateAudio", "lastFrame"],
       prompt: KLING_PROMPT2,
       audio: "optional"
     },
     defaults: { durationSeconds: 5, aspectRatio: "16:9", generateAudio: true, mode: "pro" },
-    usage: { unit: "compute_seconds" },
+    usage: { ...VIDEO_USAGE3 },
     pricingKind: "video_per_second",
     display: {
       provider: "kuaishou",
       logo: "https://cdn.jsdelivr.net/npm/@lobehub/icons-static-png@1.97.0/light/kling-color.png",
-      description: "Kuaishou Kling Video 3.0 Omni unified generation and editing from text, start/end images, up to 7 reference images, and reference video; up to 15 seconds at up to 4K."
+      description: "Kuaishou Kling Video 3.0 Omni generation from text, start/end images and up to 7 reference images, with optional native audio; up to 15 seconds at up to 4K."
     }
-    // end_image "Requires start_image", but no lastFrameRequiresFirstFrame: SpaceLab resolves
-    // replicate rows in error mode, so the flag would refuse its end-frame-only nodes, which
-    // the adapter sends as start_image.
+    // No lastFrameRequiresFirstFrame: fal image-to-video needs a start frame, so the adapter
+    // sends a lone end frame as the start frame, as the Replicate model took it.
   },
   {
     id: "minimax-h3",
@@ -8520,6 +8522,7 @@ var KLING_TIERS = [
   { mode: "pro", resolution: "1080p" },
   { mode: "4k", resolution: "4k" }
 ];
+var KLING_O3_OMNI = "fal-ai/kling-video/o3";
 function klingTier(req) {
   return KLING_TIERS.find((tier) => tier.resolution === req.resolution) ?? KLING_TIERS.find((tier) => tier.mode === req.mode) ?? KLING_TIERS[0];
 }
@@ -8668,6 +8671,7 @@ var RULES = /* @__PURE__ */ new Map([
   [MOTION_PRO, motionControl],
   [MOTION_STANDARD, motionControl],
   [O3_REFERENCE, o3Reference],
+  [KLING_O3_OMNI, o3Reference],
   [O3_EDIT, (req) => needsSource(req) ?? needsPrompt(req)],
   [H3_TURBO, h3Turbo],
   [MINIMAX_H3_INSERT, h3Insert],
@@ -8697,13 +8701,14 @@ function h3EndFrameRatioWarning(model, ratio) {
     message: `${model.id} follows the end frame's aspect ratio`
   };
 }
-function isReplicateKling(model) {
+function takesKlingMode(model) {
+  if (model.adapter === "fal") return model.providerModelId.toLowerCase() === KLING_O3_OMNI;
   if (model.adapter !== "replicate") return false;
   const kind = videoKind(model.providerModelId);
   return kind === "kling" || kind === "kling-omni";
 }
-function fillReplicateKlingResolution(model, req) {
-  if (isReplicateKling(model) && req.resolution === void 0) {
+function fillKlingModeResolution(model, req) {
+  if (takesKlingMode(model) && req.resolution === void 0) {
     req.resolution = klingTier(req).resolution;
   }
 }
@@ -9096,10 +9101,10 @@ function resolveVideoOptions(model, request, onUnsupported = "error") {
     warnings
   );
   if (aspectRatio !== void 0) merged.aspectRatio = aspectRatio;
-  fillReplicateKlingResolution(model, merged);
+  fillKlingModeResolution(model, merged);
   const resolution = resolveVideoResolution(merged.resolution, model, onUnsupported, warnings);
   if (resolution !== void 0) merged.resolution = resolution;
-  if (isReplicateKling(model)) delete merged.mode;
+  if (takesKlingMode(model)) delete merged.mode;
   const duration = resolveDuration(
     merged.durationSeconds,
     c.durations,