@shop-os/modelkit 0.2.14 → 0.2.16

package/dist/catalog.d.cts

@@ -22,10 +22,14 @@ type OutputFormat = "png" | "jpeg" | "webp";
 type MediaRef = {
     url: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 } | {
     bytes: Uint8Array;
     mime: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 };
 /** Caller-driven Topaz upscale controls; see the topaz row and TopazImageInput. */
 interface UpscaleOptions {
@@ -103,8 +107,14 @@ interface VideoRequest {
     watermark?: boolean;
     /** Provider-side safety checker toggle (fal MiniMax). Provider default when unset. */
     safetyChecker?: boolean;
-    /** Seedance omni-reference subtask hint. `edit` forces duration -1 and adaptive ratio. */
+    /** Seedance omni-reference subtask hint. `edit` forces duration -1 and adaptive ratio.
+     * `extend` on a `videoExtension` row continues the clip by `durationSeconds` more. */
     taskType?: "reference" | "edit" | "extend";
+    /** Continue a provider-side session instead of re-sending the clip (Gemini Omni
+     * Interactions `previous_interaction_id`). The prior call's `VideoResult.providerRef`
+     * carries it. The provider rejects it together with an explicit video task, so the
+     * adapter sends the prompt alone; `taskType: "extend"` still selects the extend path. */
+    previousInteractionId?: string;
     mode?: "standard" | "pro";
 }
 /**
@@ -156,7 +166,19 @@ interface MediaPart {
     cleanup?: () => Promise<void>;
 }
 type RequiredInput = "firstFrame" | "sourceVideo" | "references";
-type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental";
+type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental"
+/** Video rows that extend a clip in fixed segments up to a cumulative cap (see `ModelConstraints.extension`). */
+ | "videoExtension";
+interface VideoSecondsLimits {
+    /** Minimum length of each reference video, in seconds. */
+    min?: number;
+    /** Maximum length of each reference video, in seconds. */
+    max?: number;
+    /** Maximum combined length of the reference videos, in seconds. */
+    total?: number;
+    /** Higher per-video minimum when `taskType` is `edit` (Seedance 2.5: 4 s). */
+    editMin?: number;
+}
 interface ReferenceLimits {
     images?: number;
     /** Lower image cap when a reference video is also sent (Kling V3 Omni: 7 → 4). */
@@ -166,6 +188,8 @@ interface ReferenceLimits {
     total?: number;
     /** Provider rejects a request whose only references are audio. */
     audioOnly?: boolean;
+    /** Per-video length caps (min/max each) and combined total for reference videos. */
+    videoSeconds?: VideoSecondsLimits;
 }
 interface ModelConstraints {
     aspectRatios?: AspectRatio[];
@@ -189,6 +213,17 @@ interface ModelConstraints {
     supports?: SupportedOption[];
     /** Ratio is dropped, with a warning, when one of these inputs is present. */
     ratioIgnoredWith?: ("firstFrame" | "sourceVideo")[];
+    /** Length limits for the source video the row edits or extends. */
+    sourceVideoSeconds?: Omit<VideoSecondsLimits, "total"> & {
+        /** The provider sends the source as a reference video, so it counts toward `references.videoSeconds.total` (Seedance). */
+        inReferenceTotal?: boolean;
+    };
+    /** Video extension (rows with `supports: ["videoExtension"]`): each `taskType: "extend"`
+     * call adds up to `segmentSeconds` and the clip can grow to `maxTotalSeconds`. */
+    extension?: {
+        segmentSeconds: number;
+        maxTotalSeconds: number;
+    };
 }
 /** JSON-compatible value. Provider options and raw payloads carry these, never `unknown`. */
 type JsonPrimitive = string | number | boolean | null;
@@ -330,6 +365,10 @@ interface VideoResult {
     };
     usage: UsageEvent;
     raw?: unknown;
+    /** Provider handle for chaining a follow-up call (`VideoRequest.previousInteractionId`). */
+    providerRef?: {
+        interactionId: string;
+    };
 }
 interface VideoCallJob extends VideoJob {
     warnings: Warning[];
@@ -562,6 +601,12 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             audios: z.ZodOptional<z.ZodNumber>;
             total: z.ZodOptional<z.ZodNumber>;
             audioOnly: z.ZodOptional<z.ZodBoolean>;
+            videoSeconds: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                total: z.ZodOptional<z.ZodNumber>;
+                editMin: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
         }, z.core.$loose>>;
         requires: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             references: "references";
@@ -586,20 +631,33 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             safetyChecker: "safetyChecker";
             taskType: "taskType";
             instrumental: "instrumental";
+            videoExtension: "videoExtension";
         }>>>;
         ratioIgnoredWith: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             firstFrame: "firstFrame";
             sourceVideo: "sourceVideo";
         }>>>;
+        sourceVideoSeconds: z.ZodOptional<z.ZodObject<{
+            max: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            editMin: z.ZodOptional<z.ZodNumber>;
+            inReferenceTotal: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        extension: z.ZodOptional<z.ZodObject<{
+            segmentSeconds: z.ZodNumber;
+            maxTotalSeconds: z.ZodNumber;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     defaults: z.ZodObject<{
         references: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         aspectRatio: z.ZodOptional<z.ZodEnum<{
             "1:1": "1:1";
@@ -654,50 +712,62 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         firstFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         lastFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         sourceVideo: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         referenceImages: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceVideos: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceAudios: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         resolution: z.ZodOptional<z.ZodEnum<{
             "360p": "360p";
@@ -839,6 +909,12 @@ interface ResolveResult<T> {
 }
 /** Nearest supported ratio in the same orientation bucket, else nearest overall, by log distance. */
 declare function nearestAspectRatio(requested: AspectRatio, supported: AspectRatio[]): AspectRatio;
+/** First length violation for the videos a request sends, as a user-facing message. */
+declare function videoLengthViolation(model: CatalogModel, input: {
+    referenceVideos?: (number | undefined)[];
+    sourceVideo?: number;
+    taskType?: VideoRequest["taskType"];
+}): string | undefined;
 declare function resolveImageOptions(model: CatalogModel, request: ImageRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest>;
 declare function resolveVideoOptions(model: CatalogModel, request: VideoRequest, onUnsupported?: OnUnsupported): ResolveResult<VideoRequest>;
 declare function resolveAudioOptions(model: CatalogModel, request: AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<AudioRequest>;
@@ -878,4 +954,4 @@ declare function isModelKitError(err: unknown): err is ModelKitError;
 /** Resolve caller options against a catalog row, dispatching on `model.type`. */
 declare function resolveOptions(model: CatalogModel, request: ImageRequest | VideoRequest | AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest | VideoRequest | AudioRequest>;
 
-export { ADAPTER_IDS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, primeCatalog, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows };
+export { ADAPTER_IDS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type VideoSecondsLimits, type Warning, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, primeCatalog, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows, videoLengthViolation };

package/dist/catalog.d.ts

@@ -22,10 +22,14 @@ type OutputFormat = "png" | "jpeg" | "webp";
 type MediaRef = {
     url: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 } | {
     bytes: Uint8Array;
     mime: string;
     label?: string;
+    /** Measured length of a video/audio; the kit never measures it. */
+    durationSeconds?: number;
 };
 /** Caller-driven Topaz upscale controls; see the topaz row and TopazImageInput. */
 interface UpscaleOptions {
@@ -103,8 +107,14 @@ interface VideoRequest {
     watermark?: boolean;
     /** Provider-side safety checker toggle (fal MiniMax). Provider default when unset. */
     safetyChecker?: boolean;
-    /** Seedance omni-reference subtask hint. `edit` forces duration -1 and adaptive ratio. */
+    /** Seedance omni-reference subtask hint. `edit` forces duration -1 and adaptive ratio.
+     * `extend` on a `videoExtension` row continues the clip by `durationSeconds` more. */
     taskType?: "reference" | "edit" | "extend";
+    /** Continue a provider-side session instead of re-sending the clip (Gemini Omni
+     * Interactions `previous_interaction_id`). The prior call's `VideoResult.providerRef`
+     * carries it. The provider rejects it together with an explicit video task, so the
+     * adapter sends the prompt alone; `taskType: "extend"` still selects the extend path. */
+    previousInteractionId?: string;
     mode?: "standard" | "pro";
 }
 /**
@@ -156,7 +166,19 @@ interface MediaPart {
     cleanup?: () => Promise<void>;
 }
 type RequiredInput = "firstFrame" | "sourceVideo" | "references";
-type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental";
+type SupportedOption = "seed" | "quality" | "negativePrompt" | "cfgScale" | "generateAudio" | "promptExpansion" | "lastFrame" | "count" | "outputFormat" | "scaleFactor" | "safetySettings" | "temperature" | "upscale" | "watermark" | "safetyChecker" | "taskType" | "instrumental"
+/** Video rows that extend a clip in fixed segments up to a cumulative cap (see `ModelConstraints.extension`). */
+ | "videoExtension";
+interface VideoSecondsLimits {
+    /** Minimum length of each reference video, in seconds. */
+    min?: number;
+    /** Maximum length of each reference video, in seconds. */
+    max?: number;
+    /** Maximum combined length of the reference videos, in seconds. */
+    total?: number;
+    /** Higher per-video minimum when `taskType` is `edit` (Seedance 2.5: 4 s). */
+    editMin?: number;
+}
 interface ReferenceLimits {
     images?: number;
     /** Lower image cap when a reference video is also sent (Kling V3 Omni: 7 → 4). */
@@ -166,6 +188,8 @@ interface ReferenceLimits {
     total?: number;
     /** Provider rejects a request whose only references are audio. */
     audioOnly?: boolean;
+    /** Per-video length caps (min/max each) and combined total for reference videos. */
+    videoSeconds?: VideoSecondsLimits;
 }
 interface ModelConstraints {
     aspectRatios?: AspectRatio[];
@@ -189,6 +213,17 @@ interface ModelConstraints {
     supports?: SupportedOption[];
     /** Ratio is dropped, with a warning, when one of these inputs is present. */
     ratioIgnoredWith?: ("firstFrame" | "sourceVideo")[];
+    /** Length limits for the source video the row edits or extends. */
+    sourceVideoSeconds?: Omit<VideoSecondsLimits, "total"> & {
+        /** The provider sends the source as a reference video, so it counts toward `references.videoSeconds.total` (Seedance). */
+        inReferenceTotal?: boolean;
+    };
+    /** Video extension (rows with `supports: ["videoExtension"]`): each `taskType: "extend"`
+     * call adds up to `segmentSeconds` and the clip can grow to `maxTotalSeconds`. */
+    extension?: {
+        segmentSeconds: number;
+        maxTotalSeconds: number;
+    };
 }
 /** JSON-compatible value. Provider options and raw payloads carry these, never `unknown`. */
 type JsonPrimitive = string | number | boolean | null;
@@ -330,6 +365,10 @@ interface VideoResult {
     };
     usage: UsageEvent;
     raw?: unknown;
+    /** Provider handle for chaining a follow-up call (`VideoRequest.previousInteractionId`). */
+    providerRef?: {
+        interactionId: string;
+    };
 }
 interface VideoCallJob extends VideoJob {
     warnings: Warning[];
@@ -562,6 +601,12 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             audios: z.ZodOptional<z.ZodNumber>;
             total: z.ZodOptional<z.ZodNumber>;
             audioOnly: z.ZodOptional<z.ZodBoolean>;
+            videoSeconds: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                total: z.ZodOptional<z.ZodNumber>;
+                editMin: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
         }, z.core.$loose>>;
         requires: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             references: "references";
@@ -586,20 +631,33 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             safetyChecker: "safetyChecker";
             taskType: "taskType";
             instrumental: "instrumental";
+            videoExtension: "videoExtension";
         }>>>;
         ratioIgnoredWith: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             firstFrame: "firstFrame";
             sourceVideo: "sourceVideo";
         }>>>;
+        sourceVideoSeconds: z.ZodOptional<z.ZodObject<{
+            max: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            editMin: z.ZodOptional<z.ZodNumber>;
+            inReferenceTotal: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        extension: z.ZodOptional<z.ZodObject<{
+            segmentSeconds: z.ZodNumber;
+            maxTotalSeconds: z.ZodNumber;
+        }, z.core.$loose>>;
     }, z.core.$loose>;
     defaults: z.ZodObject<{
         references: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         aspectRatio: z.ZodOptional<z.ZodEnum<{
             "1:1": "1:1";
@@ -654,50 +712,62 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         firstFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         lastFrame: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         sourceVideo: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>;
         referenceImages: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceVideos: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         referenceAudios: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             url: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>, z.ZodObject<{
             bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
             mime: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
+            durationSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>]>>>;
         resolution: z.ZodOptional<z.ZodEnum<{
             "360p": "360p";
@@ -839,6 +909,12 @@ interface ResolveResult<T> {
 }
 /** Nearest supported ratio in the same orientation bucket, else nearest overall, by log distance. */
 declare function nearestAspectRatio(requested: AspectRatio, supported: AspectRatio[]): AspectRatio;
+/** First length violation for the videos a request sends, as a user-facing message. */
+declare function videoLengthViolation(model: CatalogModel, input: {
+    referenceVideos?: (number | undefined)[];
+    sourceVideo?: number;
+    taskType?: VideoRequest["taskType"];
+}): string | undefined;
 declare function resolveImageOptions(model: CatalogModel, request: ImageRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest>;
 declare function resolveVideoOptions(model: CatalogModel, request: VideoRequest, onUnsupported?: OnUnsupported): ResolveResult<VideoRequest>;
 declare function resolveAudioOptions(model: CatalogModel, request: AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<AudioRequest>;
@@ -878,4 +954,4 @@ declare function isModelKitError(err: unknown): err is ModelKitError;
 /** Resolve caller options against a catalog row, dispatching on `model.type`. */
 declare function resolveOptions(model: CatalogModel, request: ImageRequest | VideoRequest | AudioRequest, onUnsupported?: OnUnsupported): ResolveResult<ImageRequest | VideoRequest | AudioRequest>;
 
-export { ADAPTER_IDS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type Warning, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, primeCatalog, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows };
+export { ADAPTER_IDS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type Lifecycle, type LiveCatalogState, MODELS, type MediaPart, type MediaRef, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, type ReferenceLimits, type RequiredInput, type RequiredKeyName, type ResolveResult, type Routing, SURFACES, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type VideoSecondsLimits, type Warning, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, primeCatalog, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows, videoLengthViolation };