@nodaro/shared 2.21.1 → 2.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "2.21.1",
+  "version": "2.22.0",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/index.ts

@@ -112,6 +112,7 @@ export {
   checkRefVideoDurations,
   VIDEO_PROVIDERS_REQUIRING_IMAGE,
   videoProviderRequiresImage,
+  videoProviderFoldsLoneEndFrame,
   VIDEO_MODE_ALIASES,
   VIDEO_GEN_COLLAPSED_T2V_IDS,
   resolveVideoProviderForMode,

package/src/model-constants.ts

@@ -2105,6 +2105,29 @@ export function videoProviderRequiresImage(provider: string | undefined): boolea
   return !!provider && VIDEO_PROVIDERS_REQUIRING_IMAGE.has(provider)
 }
 
+/**
+ * True when the provider's image-to-video path FOLDS a lone closing frame into
+ * its reference images — i.e. an end frame with no start frame is a reference
+ * the model actually receives, not a half-formed frame pair.
+ *
+ * The Seedance 2.x, MiniMax Hailuo 3 and Wan 3 families all assemble their KIE
+ * input through the shared `resolveSeedance2Inputs` (`@nodaro/prompts`), whose
+ * reference mode takes a lone last frame as the sole reference image plus a
+ * closing-frame prompt hint. NOTHING else does: VEO ships `[imageUrl,
+ * endFrameUrl]` verbatim (a lone end frame would reach KIE as `[null, url]`),
+ * the Gemini Omni branch drops the frame when there is no start frame, and the
+ * generic KIE path sends `end_frame` with no image param at all. So the
+ * exemption is keyed to the FOLD, not to "carries image references" — the
+ * catalog has no capability for it, and these three family predicates are the
+ * same membership the provider layer itself branches on (the backend's
+ * `kie/video.ts::applySeedance2Params` / `applyMinimaxH3Params` / `runWan3`).
+ * A ref-capable provider that grows the fold gets the exemption by joining a
+ * family here; one that does not keeps the honest `image_required` 400.
+ */
+export function videoProviderFoldsLoneEndFrame(provider: string): boolean {
+  return isSeedance2Provider(provider) || isMinimaxH3Provider(provider) || isWan3Provider(provider)
+}
+
 /**
  * Video models where enabling audio/sound incurs an additional cost.
  * The audio addon is expressed as a separate composite identifier suffix.