@shop-os/modelkit 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -9,6 +9,27 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.3.2] - Unreleased
+
+### Added
+- Aspect ratios `1:4`, `4:1`, `1:8` and `8:1` in the `AspectRatio` type and the row schema. Gemini Nano Banana 2.1 serves them at 1K, 2K and 4K.
+- Snapshot row `gemini-nano-banana-2.1` (alias `nb-2.1`, 1K/2K/4K, 14 references, the four new ratios plus the usual Gemini set). It runs on the existing `google-image` adapter.
+
+### Live rows to update after publish
+The live `gemini-nano-banana-2.1` rows (dev, stg, prod) keep the old ratio list until the four ratios are added in pro-admin. An app on 0.3.1 or older rejects a row that carries a ratio it does not know, so edit the live rows only after every app that reads the catalog runs 0.3.2.
+
+## [0.3.1] - Unreleased
+
+### Added
+- `providerOptions.modelkit.inputSpec` now works on fal image rows, so a new fal image model is a database row. The spec uses the image keys (`prompt`, `references`, `aspectRatio`, `size`, `outputFormat`, `seed`) with `fields`, `values` and `static`, exactly as on Replicate image rows. The new optional `editEndpoint` (fal rows only) names the endpoint called instead of `providerModelId` when the request has references, for models that split text-to-image and edit across two endpoints. Only the mapped fields are sent: no `num_images`, so a spec row returns one image per call. A fal row without an `inputSpec` keeps the Muse-shaped request and Ideogram keeps its own path. fal video rows still reject `inputSpec`. On fal an explicit `inputSpec` wins over the built-in Ideogram path, and `editEndpoint` needs a `references` entry in `fields`.
+- `resolveRowInputSpec(req, ctx)` and `invalidInputSpecError(provider, ctx, issues)` in the shared mapper, used by the Replicate and fal adapters.
+
+### Changed
+- fal image calls decode every image in the response that has a URL and fail only when none do. The Muse path used to fail when the first image had no URL even if later ones did.
+
+### Live rows to add after publish
+Add a fal image row that carries an `inputSpec` only after every app that will call it runs 0.3.1. An older kit accepts the row but ignores the `inputSpec`, so it sends the Muse-shaped request and the call fails or loses its fields.
+
 ## [0.3.0] - Unreleased
 
 ### Added

package/README.md

@@ -213,8 +213,8 @@ The Bedrock model id is `<routing.bedrockProfile>.anthropic.<providerModelId>`
 breaks the pattern sets `providerOptions.modelkit.bedrockModelId` on its row.
 See the CHANGELOG entry for the caller-visible Bedrock limits.
 
-A Replicate video, image or audio row for a new model carries `providerOptions.modelkit.inputSpec`
-instead of a kit change. It is read by the Replicate adapter only. `fields` maps a canonical key to the provider field name,
+A Replicate video, image or audio row, or a fal image row, for a new model carries `providerOptions.modelkit.inputSpec`
+instead of a kit change. It is read by the Replicate and fal adapters only. `fields` maps a canonical key to the provider field name,
 `values` remaps canonical values per key, and `static` merges literal provider fields
 last. Video rows use `VIDEO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`,
 `aspectRatio`, `resolution`, `firstFrame`, `lastFrame`, `seed`, `negativePrompt`,
@@ -223,7 +223,7 @@ last. Video rows use `VIDEO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`,
 `seed`; map `references` to the provider's array field and remap `size` and `outputFormat`
 with `values`); audio rows use
 `AUDIO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`, `seed`, `negativePrompt`,
-`references`, `sourceVideo`, `instrumental`). `aspectRatio: "adaptive"` is omitted.
+`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.
 `validateInputSpec` is the shared contract the write schema, `dataOnlyCapable`, and
 the Replicate mapper all check. `dataOnlyCapable(row)` reports whether such a row would
 be served.

package/dist/catalog.cjs

@@ -222,13 +222,21 @@ var GEMINI_RATIOS = [
   "5:4",
   "adaptive"
 ];
+var NANO_BANANA_2_1_RATIOS = [
+  ...GEMINI_RATIOS.filter((r) => r !== "adaptive"),
+  "1:4",
+  "4:1",
+  "1:8",
+  "8:1",
+  "adaptive"
+];
 var GEMINI_PROMPT_MAX_CHARS = 5e4;
 var GPT_IMAGE_PROMPT = { referenceSyntax: "numbered", maxChars: 32e3 };
-function geminiImage(id, label, aliases, sizes, display, exposure, references, promptMaxChars) {
+function geminiImage(id, label, aliases, sizes, display, exposure, references, promptMaxChars, aspectRatios = GEMINI_RATIOS) {
   const prompt = { referenceSyntax: "caption" };
   if (promptMaxChars !== void 0) prompt.maxChars = promptMaxChars;
   const constraints = {
-    aspectRatios: [...GEMINI_RATIOS],
+    aspectRatios: [...aspectRatios],
     sizes,
     supports: ["safetySettings", "temperature"],
     prompt
@@ -252,6 +260,21 @@ function geminiImage(id, label, aliases, sizes, display, exposure, references, p
   return model;
 }
 var IMAGE_MODELS = [
+  geminiImage(
+    "gemini-nano-banana-2.1",
+    "Nano Banana 2.1",
+    ["nb-2.1"],
+    ["1K", "2K", "4K"],
+    {
+      provider: "google",
+      description: "Latest high-efficiency Nano Banana. Better realism, prompt adherence, text rendering and character consistency at Flash speed. Great for campaigns, infographics, and iterative edits.",
+      logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
+    },
+    ["cowork", "space_builder"],
+    { images: 14 },
+    GEMINI_PROMPT_MAX_CHARS,
+    NANO_BANANA_2_1_RATIOS
+  ),
   geminiImage(
     "gemini-3-pro-image-preview",
     "Nano Banana Pro",
@@ -2317,6 +2340,10 @@ var ALL_KEY_SET = /* @__PURE__ */ new Set([
   ...IMAGE_INPUT_SPEC_KEYS,
   ...AUDIO_INPUT_SPEC_KEYS
 ]);
+var TYPES_BY_ADAPTER = /* @__PURE__ */ new Map([
+  ["replicate", ["video", "image", "audio"]],
+  ["fal", ["image"]]
+]);
 var ALLOWED_KEYS_BY_TYPE = /* @__PURE__ */ new Map([
   ["video", VIDEO_KEY_SET],
   ["image", IMAGE_KEY_SET],
@@ -2355,7 +2382,8 @@ var StaticSchema = import_zod2.z.record(import_zod2.z.string(), ProviderScalarSc
 var InputSpecSchema = import_zod2.z.strictObject({
   fields: FieldsSchema,
   values: ValuesSchema.optional(),
-  static: StaticSchema.optional()
+  static: StaticSchema.optional(),
+  editEndpoint: import_zod2.z.string().min(1).optional()
 }).superRefine((spec, ctx) => {
   const mappedNames = new Set(Object.values(spec.fields));
   for (const key of Object.keys(spec.static ?? {})) {
@@ -2380,18 +2408,21 @@ function validateInputSpec(raw, row) {
     };
   }
   const spec = parsed.data;
-  if (row.adapter !== "replicate") {
+  const supportedTypes = TYPES_BY_ADAPTER.get(row.adapter);
+  if (supportedTypes === void 0) {
     return {
       ok: false,
-      issues: [{ path: [], message: "inputSpec is only supported on replicate rows" }]
+      issues: [
+        { path: [], message: "inputSpec is only supported on replicate and fal rows" }
+      ]
     };
   }
   const issues = [];
   const allowed = ALLOWED_KEYS_BY_TYPE.get(row.type);
-  if (allowed === void 0) {
+  if (allowed === void 0 || !supportedTypes.includes(row.type)) {
     issues.push({
       path: [],
-      message: `inputSpec is not supported for "${row.type}" rows`
+      message: row.adapter === "fal" ? `inputSpec on fal rows is only supported for image rows, not "${row.type}"` : `inputSpec is not supported for "${row.type}" rows`
     });
   } else {
     for (const key of Object.keys(spec.fields)) {
@@ -2411,6 +2442,19 @@ function validateInputSpec(raw, row) {
       }
     }
   }
+  if (spec.editEndpoint !== void 0) {
+    if (row.adapter !== "fal") {
+      issues.push({
+        path: ["editEndpoint"],
+        message: "inputSpec.editEndpoint is only supported on fal rows"
+      });
+    } else if (!("references" in spec.fields)) {
+      issues.push({
+        path: ["editEndpoint"],
+        message: 'inputSpec.editEndpoint needs a "references" entry in inputSpec.fields'
+      });
+    }
+  }
   const seenNames = /* @__PURE__ */ new Map();
   for (const [key, name] of Object.entries(spec.fields)) {
     const first = seenNames.get(name);
@@ -2486,6 +2530,10 @@ var AspectRatioSchema = import_zod3.z.enum([
   "21:9",
   "9:21",
   "97:30",
+  "1:4",
+  "4:1",
+  "1:8",
+  "8:1",
   "adaptive"
 ]);
 var ImageSizeSchema = import_zod3.z.enum(["512", "1K", "2K", "4K"]);