@shop-os/modelkit 0.4.2 → 0.4.4

package/CHANGELOG.md

@@ -9,6 +9,18 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.4.4] - Unreleased
+
+### Added
+- `inputSpec.dimensions` on image rows: `{ field, areas, maxSide?, multipleOf? }` sends one `{ width, height }` object in `field`, computed from the request's aspect ratio and size. `areas` is the target pixel count per size tier; the long side is capped at `maxSide` and both sides round down to `multipleOf`. Nothing is sent when the ratio is missing or `adaptive`, or the size has no area, so the provider default applies (on an edit endpoint, the first reference's size). A spec with `dimensions` cannot also map `aspectRatio` or `size` in `fields`, and `field` cannot be a name another mapping already sends. This lets a fal row whose endpoint only takes `image_size` presets or `{ width, height }` (FLUX 3 Image Klein) offer 2K and 4K as data.
+
+Add a row that carries `inputSpec.dimensions` only after every app that will call it runs 0.4.4. An older kit rejects the unknown key, so the row is quarantined there.
+
+## [0.4.3] - Unreleased
+
+### Fixed
+- Gemini Omni edits with no requested duration report the source video's length (`sourceVideo.durationSeconds`) as usage instead of the 10 s text-to-video default. Omni renders an edit at its source's length, also below 3 s (live probe 2026-10-16), so a 2 s edit was billed as 10 s. The fix applies only to callers that send a measured length: without one, or with a length that is not a positive finite number, the 10 s default stays. Extensions are unchanged.
+
 ## [0.4.2] - Unreleased
 
 ### Added

package/README.md

@@ -224,6 +224,7 @@ last. Video rows use `VIDEO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`,
 with `values`); audio rows use
 `AUDIO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`, `seed`, `negativePrompt`,
 `references`, `sourceVideo`, `instrumental`). `aspectRatio: "adaptive"` is omitted. A fal image row has no kind and builds its whole input from the spec; the optional `editEndpoint` (fal rows only) is the fal endpoint called instead of `providerModelId` when the request has references. fal rows without an `inputSpec` keep the Muse-shaped request and Ideogram keeps its own path; an `inputSpec` on an Ideogram row replaces that path. `editEndpoint` needs a `references` entry in `fields`. `inputSpec` on fal video rows is not supported.
+`dimensions` (image rows only, from 0.4.4) sends one `{ width, height }` object for a provider that takes pixel sizes instead of a ratio and a tier: `dimensions: { field: "image_size", areas: { "1K": 1048576, "2K": 4194304, "4K": 16777216 }, maxSide: 4096, multipleOf: 16 }`. Each `areas` entry is the target pixel count for that size; the long side is capped at `maxSide`, and both sides round down to `multipleOf`. With no ratio, `adaptive`, or a size with no area, the field is omitted. A spec with `dimensions` maps neither `aspectRatio` nor `size` in `fields`.
 `arrays` joins several image inputs into one provider array field, in the listed order: `arrays: { images: ["firstFrame", "referenceImages", "lastFrame"] }` (video rows: `firstFrame`, `referenceImages`, `lastFrame`; image rows: `references`). A key is mapped once, in `fields` or in one array, and the field is omitted when none of its inputs is set. A row that maps `sourceVideo` also needs `capabilities.acceptsSourceVideo`; set `capabilities.sourceVideoExcludesFrames` when the provider rejects a source video next to images.
 `validateInputSpec` is the shared contract the write schema, `dataOnlyCapable`, and
 the Replicate mapper all check. `dataOnlyCapable(row)` reports whether such a row would

package/dist/catalog.cjs

@@ -2563,16 +2563,26 @@ var ArraysSchema = import_zod2.z.record(import_zod2.z.string().min(1), import_zo
     }
   }
 });
+var DimensionsSchema = import_zod2.z.strictObject({
+  field: import_zod2.z.string().min(1),
+  areas: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.number().int().positive()).refine((a) => Object.keys(a).length > 0, {
+    message: "inputSpec.dimensions.areas must name at least one size"
+  }),
+  maxSide: import_zod2.z.number().int().positive().optional(),
+  multipleOf: import_zod2.z.number().int().positive().optional()
+});
 var InputSpecSchema = import_zod2.z.strictObject({
   fields: FieldsSchema,
   values: ValuesSchema.optional(),
   static: StaticSchema.optional(),
   arrays: ArraysSchema.optional(),
-  editEndpoint: import_zod2.z.string().min(1).optional()
+  editEndpoint: import_zod2.z.string().min(1).optional(),
+  dimensions: DimensionsSchema.optional()
 }).superRefine((spec, ctx) => {
   const mappedNames = /* @__PURE__ */ new Set([
     ...Object.values(spec.fields),
-    ...Object.keys(spec.arrays ?? {})
+    ...Object.keys(spec.arrays ?? {}),
+    ...spec.dimensions ? [spec.dimensions.field] : []
   ]);
   for (const key of Object.keys(spec.static ?? {})) {
     if (mappedNames.has(key)) {
@@ -2601,7 +2611,10 @@ function validateInputSpec(raw, row) {
     return {
       ok: false,
       issues: [
-        { path: [], message: "inputSpec is only supported on replicate and fal rows" }
+        {
+          path: [],
+          message: "inputSpec is only supported on replicate and fal rows"
+        }
       ]
     };
   }
@@ -2694,6 +2707,29 @@ function validateInputSpec(raw, row) {
       }
     }
   }
+  if (spec.dimensions !== void 0) {
+    if (row.type !== "image") {
+      issues.push({
+        path: ["dimensions"],
+        message: "inputSpec.dimensions is only supported on image rows"
+      });
+    }
+    for (const key of ["aspectRatio", "size"]) {
+      if (key in spec.fields) {
+        issues.push({
+          path: ["fields", key],
+          message: `inputSpec.fields "${key}" cannot be set with inputSpec.dimensions, which sends it`
+        });
+      }
+    }
+    const owner = seenNames.get(spec.dimensions.field);
+    if (owner !== void 0 || spec.dimensions.field in (spec.arrays ?? {})) {
+      issues.push({
+        path: ["dimensions", "field"],
+        message: `inputSpec.dimensions.field "${spec.dimensions.field}" is already a mapped provider field`
+      });
+    }
+  }
   const supports = row.constraints.supports ?? [];
   for (const key of INPUT_SPEC_SUPPORTS_KEYS) {
     if (supports.includes(key)) continue;