@shop-os/modelkit 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -9,6 +9,15 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.15.0] - Unreleased
+
+Reference and source videos have a minimum frame size, checked before the provider call (ENG-3453).
+
+### Added
+- `references.videoPixels` and `sourceVideoPixels` constraints (`{ minWidth?, minHeight? }`, `VideoPixelLimits`): the smallest frame a row takes for a reference or source video. Kits before 0.15.0 ignore them (the constraint objects are loose).
+- `videoSizeViolation(model, { referenceVideos?, sourceVideo? })` beside `videoLengthViolation`: the first undersized video as a user-facing message ("Kling 4.0 takes reference videos at least 700 px wide; video 1 is 576 px."), from measured sizes. An unmeasured video passes.
+- Limits from fal's schemas: `kling-4.0` reference videos and `kling-4.0-edit` source 700 px, `kling-o3-edit` source 720 px, `kling-3.0-motion-control-*` motion clip 340 px (width and height each). The stored `model_catalog` rows need the same values (pro-admin) for runtime checks to see them.
+
 ## [0.14.0] - Unreleased
 
 Video Depth Anything on fal, as a Creative Studio video tool.

package/dist/catalog.cjs

@@ -79,6 +79,7 @@ __export(catalog_entry_exports, {
   sortCatalogRows: () => sortCatalogRows,
   takesTargetAspectRatio: () => takesTargetAspectRatio,
   videoLengthViolation: () => videoLengthViolation,
+  videoSizeViolation: () => videoSizeViolation,
   videoToolConstraints: () => videoToolConstraints
 });
 module.exports = __toCommonJS(catalog_entry_exports);
@@ -5167,6 +5168,7 @@ function klingMotionControl(tier) {
         videos: 1,
         audios: 0,
         videoSeconds: { min: 3, max: 30.05 },
+        videoPixels: { minWidth: 340, minHeight: 340 },
         min: { images: 1, videos: 1 }
       },
       requires: ["references"],
@@ -5233,6 +5235,7 @@ var VIDEO_FAMILY_MODELS = [
       references: { ...NO_REFERENCES, images: 4 },
       requires: ["sourceVideo"],
       sourceVideoSeconds: { min: 3, max: 15.05 },
+      sourceVideoPixels: { minWidth: 720, minHeight: 720 },
       // generateAudio keeps (true) or drops (false) the source soundtrack.
       supports: ["generateAudio"],
       prompt: KLING_PROMPT,
@@ -5273,7 +5276,8 @@ var VIDEO_FAMILY_MODELS = [
         ...NO_REFERENCES,
         images: 10,
         videos: 5,
-        videoSeconds: { min: 3, max: 30.05, total: 30 }
+        videoSeconds: { min: 3, max: 30.05, total: 30 },
+        videoPixels: { minWidth: 700, minHeight: 700 }
       },
       supports: ["lastFrame"],
       prompt: KLING_V4_PROMPT,
@@ -5307,6 +5311,7 @@ var VIDEO_FAMILY_MODELS = [
       references: { ...NO_REFERENCES, images: 10 },
       requires: ["sourceVideo"],
       sourceVideoSeconds: { min: 3, max: 30.05 },
+      sourceVideoPixels: { minWidth: 700, minHeight: 700 },
       supports: [],
       prompt: KLING_V4_PROMPT,
       audio: KLING_V4_AUDIO
@@ -7857,6 +7862,10 @@ var VideoSecondsLimitsSchema = import_zod3.z.looseObject({
   total: import_zod3.z.number().optional(),
   editMin: import_zod3.z.number().optional()
 });
+var VideoPixelLimitsSchema = import_zod3.z.looseObject({
+  minWidth: import_zod3.z.number().int().positive().optional(),
+  minHeight: import_zod3.z.number().int().positive().optional()
+});
 var ReferenceLimitsSchema = import_zod3.z.looseObject({
   images: import_zod3.z.number().optional(),
   imagesWithVideo: import_zod3.z.number().optional(),
@@ -7865,6 +7874,7 @@ var ReferenceLimitsSchema = import_zod3.z.looseObject({
   total: import_zod3.z.number().optional(),
   audioOnly: import_zod3.z.boolean().optional(),
   videoSeconds: VideoSecondsLimitsSchema.optional(),
+  videoPixels: VideoPixelLimitsSchema.optional(),
   audioSeconds: import_zod3.z.looseObject({
     min: import_zod3.z.number().optional(),
     max: import_zod3.z.number().optional(),
@@ -7954,6 +7964,7 @@ var ModelConstraintsSchema = import_zod3.z.looseObject({
   }).optional(),
   languages: import_zod3.z.array(LanguageOptionSchema).optional(),
   outputFormats: import_zod3.z.array(import_zod3.z.string().min(1)).min(1).optional(),
+  sourceVideoPixels: VideoPixelLimitsSchema.optional(),
   sourceVideoSeconds: VideoSecondsLimitsSchema.omit({ total: true }).extend({ inReferenceTotal: import_zod3.z.boolean().optional() }).optional(),
   // segmentSeconds/maxTotalSeconds stay required: a kit before 0.3.0 drops a row whose
   // extension lacks them, so every extension block keeps them.
@@ -9478,6 +9489,28 @@ function videoLengthViolation(model, input) {
     return `${model.label} takes a source video of at least ${String(sourceMin)} s; this one is ${seconds2(source, sourceMin)} s.`;
   return void 0;
 }
+function undersizedSide(frame, limits) {
+  if (!frame || !limits) return void 0;
+  const { width, height } = frame;
+  if (limits.minWidth !== void 0 && width !== void 0 && width > 0 && width < limits.minWidth)
+    return { side: "wide", min: limits.minWidth, actual: width };
+  if (limits.minHeight !== void 0 && height !== void 0 && height > 0 && height < limits.minHeight)
+    return { side: "tall", min: limits.minHeight, actual: height };
+  return void 0;
+}
+function videoSizeViolation(model, input) {
+  const refLimits = model.constraints.references?.videoPixels;
+  const refs = input.referenceVideos ?? [];
+  for (let i = 0; i < refs.length; i++) {
+    const under2 = undersizedSide(refs[i], refLimits);
+    if (under2)
+      return `${model.label} takes reference videos at least ${String(under2.min)} px ${under2.side}; video ${i + 1} is ${String(under2.actual)} px.`;
+  }
+  const under = undersizedSide(input.sourceVideo, model.constraints.sourceVideoPixels);
+  if (under)
+    return `${model.label} takes a source video at least ${String(under.min)} px ${under.side}; this one is ${String(under.actual)} px.`;
+  return void 0;
+}
 function resolveImageOptions(model, request, onUnsupported = "error") {
   const warnings = [];
   const c = model.constraints;