@shop-os/modelkit 0.2.12 → 0.2.13

package/CHANGELOG.md

@@ -9,6 +9,19 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.2.13] - 2026-09-18
+
+### Added
+- `dataOnlyCapable(row)`: reports whether a database catalog row would be served by a generic path, a hard-coded kind, or a valid `inputSpec`. The modality check is derived from the adapter's `generateImage` / `generateVideo` / `generateAudio` / `languageModel` surface, so a wrong-modality row reports `ok: false`. Replicate video and audio rows also need a known kind or a valid `inputSpec`.
+- `providerOptions.modelkit.inputSpec`: per-row Replicate video and audio field mapping (`fields`, `values`, `static`) with the shared `applyInputSpec` mapper, read by the Replicate adapter only. Video rows use `VIDEO_INPUT_SPEC_KEYS`; audio rows use `AUDIO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`, `seed`, `negativePrompt`, `references`, `sourceVideo`, `instrumental`).
+- `validateInputSpec(raw, row)`: the shared Replicate-only `inputSpec` contract (schema, values-need-fields entries, no duplicate provider names, `constraints.supports` cross-check including `instrumental`, video/audio modality check) used by the write schema, `dataOnlyCapable`, and the Replicate mapper.
+- `PrimeCatalogResult.droppedRows`: count of catalog rows dropped by the per-row quarantine on the read path.
+
+### Changed
+- Replicate and fal video or audio ids with no input mapper now throw `unsupported_option` instead of using a default mapper.
+- Higgsfield Kling rows with an absolute-URL `providerModelId` are rejected with `unsupported_option`; the id must be a platform path.
+- The catalog read path drops invalid rows with one warning each instead of rejecting the whole envelope.
+
 ## [0.2.12] - 2026-09-17
 
 ### Changed

package/README.md

@@ -165,6 +165,18 @@ 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 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,
+`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`,
+`generateAudio`, `cfgScale`, `promptExpansion`, `referenceImages`); audio rows use
+`AUDIO_INPUT_SPEC_KEYS` (`prompt`, `durationSeconds`, `seed`, `negativePrompt`,
+`references`, `sourceVideo`, `instrumental`). `aspectRatio: "adaptive"` is omitted.
+`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.
+
 ```ts
 import { defaultProvider } from "@aws-sdk/credential-provider-node";
 import { createDefaultModelKit, keysFromEnv } from "@shop-os/modelkit";