@shop-os/modelkit 0.2.27 → 0.3.0

package/dist/catalog.d.cts

@@ -39,7 +39,13 @@ interface UpscaleOptions {
     faceEnhancementCreativity?: number;
     faceEnhancementStrength?: number;
 }
-type ModelType = "text" | "image" | "video" | "audio" | "upscale" | "bg-remove";
+type ModelType = "text" | "image" | "video" | "audio" | "upscale" | "bg-remove"
+/** Video in, video out, no prompt: upscale, frame interpolation, SDR to HDR. */
+ | "video-tool";
+/** What a `video-tool` row does to its source clip. */
+type VideoToolKind = "upscale" | "interpolate" | "hdr";
+/** Container/codec a video-tool row can write. */
+type VideoToolOutputFormat = "h265" | "prores";
 type Lifecycle = "active" | "deprecated" | "retired";
 type Surface = "cowork" | "space_builder";
 /** @deprecated use Surface[] */
@@ -130,6 +136,61 @@ interface VideoCallOptions extends Omit<VideoRequest, "model"> {
     /** Reaches the provider only for AI SDK model instances; catalog rows carry their own. */
     providerOptions?: ProviderOptions;
 }
+/** What the caller measured about a video-tool source; the kit never measures. */
+interface VideoToolSource {
+    url: string;
+    width: number;
+    height: number;
+    durationSeconds: number;
+    fps?: number;
+}
+interface VideoToolRequest {
+    model: string;
+    source: VideoToolSource;
+    /** Upscale rows. */
+    upscaleFactor?: number;
+    /** Interpolate rows. */
+    targetFps?: number;
+    /** HDR rows; the row's first `outputFormats` entry when unset. */
+    outputFormat?: VideoToolOutputFormat;
+}
+/** The output a video-tool request will produce, from the request alone. */
+interface VideoToolOutputSpec {
+    width: number;
+    height: number;
+    durationSeconds: number;
+    fps?: number;
+    resolution: VideoResolution;
+    format: "h264" | VideoToolOutputFormat;
+}
+interface VideoToolCallContext extends CallContext {
+    /** Where the provider posts the result when the job ends. */
+    webhookUrl?: string;
+}
+/**
+ * A submitted video-tool job. Plain JSON so a caller can store it and pass it back
+ * to `videoToolStatus` / `videoToolResult` / `cancelVideoTool` from another process.
+ */
+interface VideoToolSubmission {
+    model: string;
+    provider: "fal";
+    requestId: string;
+    statusUrl: string;
+    responseUrl: string;
+    cancelUrl: string;
+    output: VideoToolOutputSpec;
+}
+type VideoToolStatus = "queued" | "running" | "completed";
+interface VideoToolResult {
+    video: {
+        url: string;
+        mime?: string;
+        bytes?: number;
+    };
+    output: VideoToolOutputSpec;
+    usage: UsageEvent;
+    raw?: unknown;
+}
 interface AudioRequest {
     model: string;
     prompt: string;
@@ -190,6 +251,33 @@ interface ReferenceLimits {
     audioOnly?: boolean;
     /** Per-video length caps (min/max each) and combined total for reference videos. */
     videoSeconds?: VideoSecondsLimits;
+    /** Per-clip length caps (min/max each) and combined total for reference audio, in seconds. */
+    audioSeconds?: {
+        min?: number;
+        max?: number;
+        total?: number;
+    };
+    /** File types the provider takes for reference audio, as lowercase extensions. */
+    audioFormats?: string[];
+    /** Largest reference audio file the provider takes, in bytes. */
+    audioMaxBytes?: number;
+}
+interface VideoToolConstraints {
+    kind: VideoToolKind;
+    /** Upscale: allowed factor range. */
+    upscaleFactor?: {
+        min: number;
+        max: number;
+    };
+    /** Upscale: the output's long edge may not pass this, in pixels. */
+    maxOutputLongEdge?: number;
+    /** Interpolate: allowed target frame rate range. */
+    fps?: {
+        min: number;
+        max: number;
+    };
+    /** HDR: the formats the row writes, first is the default. */
+    outputFormats?: VideoToolOutputFormat[];
 }
 /** Whether a video row's output has sound: always, switchable (`supports: generateAudio`), or silent. */
 type AudioOutput = "always" | "optional" | "never";
@@ -232,7 +320,12 @@ interface ModelConstraints {
     extension?: {
         segmentSeconds: number;
         maxTotalSeconds: number;
+        /** `joined` (absent): the provider returns the whole clip so far (Omni).
+         * `new`: it returns only the added footage and the caller joins it (Seedance). */
+        returns?: "new" | "joined";
     };
+    /** What a `video-tool` row accepts. Read it through `videoToolConstraints(row)`. */
+    tool?: VideoToolConstraints;
     /** Whether the output has sound. Read it through `outputAudio(row)`, which tolerates bad data. */
     audio?: AudioOutput;
     /** Prompt conventions. Read them through `promptConventions(row)`, which fills the default. */
@@ -293,6 +386,11 @@ interface CatalogDisplay {
 interface CatalogCapabilities {
     /** Video rows: takes an existing video as the thing to edit or extend. */
     acceptsSourceVideo?: boolean;
+    /**
+     * Video rows: offered for prompt-driven edits of a source clip (`taskType: "edit"`). Absent
+     * means the caller falls back to `acceptsSourceVideo`; `false` opts a row out.
+     */
+    videoEdit?: boolean;
     /** Video rows: first/last frames and reference images are mutually exclusive inputs. */
     framesExcludeReferences?: boolean;
     /** Video rows: a last frame is accepted only together with a first frame. */
@@ -411,6 +509,8 @@ interface UsageEvent {
     imageQuality?: ImageQuality;
     resolution?: VideoResolution;
     durationSeconds?: number;
+    /** Output frame rate (video-tool rows price by output frames). */
+    fps?: number;
     inputTokens?: number;
     outputTokens?: number;
     reportedCostUsd?: number;
@@ -553,6 +653,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         audio: "audio";
         upscale: "upscale";
         "bg-remove": "bg-remove";
+        "video-tool": "video-tool";
     }>;
     adapter: z.ZodEnum<{
         "ai-sdk-text": "ai-sdk-text";
@@ -625,6 +726,13 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
                 total: z.ZodOptional<z.ZodNumber>;
                 editMin: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>;
+            audioSeconds: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                total: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            audioFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            audioMaxBytes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>>;
         requires: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             references: "references";
@@ -664,6 +772,30 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         extension: z.ZodOptional<z.ZodObject<{
             segmentSeconds: z.ZodNumber;
             maxTotalSeconds: z.ZodNumber;
+            returns: z.ZodOptional<z.ZodEnum<{
+                new: "new";
+                joined: "joined";
+            }>>;
+        }, z.core.$loose>>;
+        tool: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                upscale: "upscale";
+                interpolate: "interpolate";
+                hdr: "hdr";
+            }>;
+            upscaleFactor: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$loose>>;
+            maxOutputLongEdge: z.ZodOptional<z.ZodNumber>;
+            fps: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$loose>>;
+            outputFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                h265: "h265";
+                prores: "prores";
+            }>>>;
         }, z.core.$loose>>;
         audio: z.ZodOptional<z.ZodUnknown>;
         prompt: z.ZodOptional<z.ZodUnknown>;
@@ -852,6 +984,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
     }, z.core.$loose>>;
     capabilities: z.ZodOptional<z.ZodObject<{
         acceptsSourceVideo: z.ZodOptional<z.ZodBoolean>;
+        videoEdit: z.ZodOptional<z.ZodBoolean>;
         framesExcludeReferences: z.ZodOptional<z.ZodBoolean>;
         lastFrameRequiresFirstFrame: z.ZodOptional<z.ZodBoolean>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
@@ -919,6 +1052,29 @@ declare const IMAGE_MODELS: CatalogModel[];
 
 declare const VIDEO_MODELS: CatalogModel[];
 
+/**
+ * Topaz Labs video tools on fal. `providerOptions.fal.model` names the Topaz model the
+ * endpoint runs; the adapter sends it as `model`. Exposed on cowork only (Creative Studio).
+ */
+declare const VIDEO_TOOL_MODELS: CatalogModel[];
+
+/** A video-tool row's constraints, or undefined when the row has none or they are invalid. */
+declare function videoToolConstraints(row: CatalogModel): VideoToolConstraints | undefined;
+/** The pricing tier a frame lands in, by its short edge. */
+declare function resolutionTier(width: number, height: number): VideoResolution;
+type VideoToolPlan = {
+    ok: true;
+    output: VideoToolOutputSpec;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * What a video-tool request produces, checked against the row. Pure: callers use it to
+ * validate and price before submitting, and the adapter uses it to build the usage event.
+ */
+declare function planVideoTool(row: CatalogModel, req: Omit<VideoToolRequest, "model">): VideoToolPlan;
+
 declare const TEXT_MODELS: CatalogModel[];
 
 declare const OTHER_MODELS: CatalogModel[];
@@ -995,4 +1151,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, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, 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 KeyTier, 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 PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, 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, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, outputAudio, primeCatalog, promptConventions, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows, videoLengthViolation };
+export { ADAPTER_IDS, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, 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 KeyTier, 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 PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, 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, VIDEO_TOOL_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type VideoSecondsLimits, type VideoToolCallContext, type VideoToolConstraints, type VideoToolKind, type VideoToolOutputFormat, type VideoToolOutputSpec, type VideoToolPlan, type VideoToolRequest, type VideoToolResult, type VideoToolSource, type VideoToolStatus, type VideoToolSubmission, type Warning, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, outputAudio, planVideoTool, primeCatalog, promptConventions, resetLiveCatalog, resolutionTier, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows, videoLengthViolation, videoToolConstraints };

package/dist/catalog.d.ts

@@ -39,7 +39,13 @@ interface UpscaleOptions {
     faceEnhancementCreativity?: number;
     faceEnhancementStrength?: number;
 }
-type ModelType = "text" | "image" | "video" | "audio" | "upscale" | "bg-remove";
+type ModelType = "text" | "image" | "video" | "audio" | "upscale" | "bg-remove"
+/** Video in, video out, no prompt: upscale, frame interpolation, SDR to HDR. */
+ | "video-tool";
+/** What a `video-tool` row does to its source clip. */
+type VideoToolKind = "upscale" | "interpolate" | "hdr";
+/** Container/codec a video-tool row can write. */
+type VideoToolOutputFormat = "h265" | "prores";
 type Lifecycle = "active" | "deprecated" | "retired";
 type Surface = "cowork" | "space_builder";
 /** @deprecated use Surface[] */
@@ -130,6 +136,61 @@ interface VideoCallOptions extends Omit<VideoRequest, "model"> {
     /** Reaches the provider only for AI SDK model instances; catalog rows carry their own. */
     providerOptions?: ProviderOptions;
 }
+/** What the caller measured about a video-tool source; the kit never measures. */
+interface VideoToolSource {
+    url: string;
+    width: number;
+    height: number;
+    durationSeconds: number;
+    fps?: number;
+}
+interface VideoToolRequest {
+    model: string;
+    source: VideoToolSource;
+    /** Upscale rows. */
+    upscaleFactor?: number;
+    /** Interpolate rows. */
+    targetFps?: number;
+    /** HDR rows; the row's first `outputFormats` entry when unset. */
+    outputFormat?: VideoToolOutputFormat;
+}
+/** The output a video-tool request will produce, from the request alone. */
+interface VideoToolOutputSpec {
+    width: number;
+    height: number;
+    durationSeconds: number;
+    fps?: number;
+    resolution: VideoResolution;
+    format: "h264" | VideoToolOutputFormat;
+}
+interface VideoToolCallContext extends CallContext {
+    /** Where the provider posts the result when the job ends. */
+    webhookUrl?: string;
+}
+/**
+ * A submitted video-tool job. Plain JSON so a caller can store it and pass it back
+ * to `videoToolStatus` / `videoToolResult` / `cancelVideoTool` from another process.
+ */
+interface VideoToolSubmission {
+    model: string;
+    provider: "fal";
+    requestId: string;
+    statusUrl: string;
+    responseUrl: string;
+    cancelUrl: string;
+    output: VideoToolOutputSpec;
+}
+type VideoToolStatus = "queued" | "running" | "completed";
+interface VideoToolResult {
+    video: {
+        url: string;
+        mime?: string;
+        bytes?: number;
+    };
+    output: VideoToolOutputSpec;
+    usage: UsageEvent;
+    raw?: unknown;
+}
 interface AudioRequest {
     model: string;
     prompt: string;
@@ -190,6 +251,33 @@ interface ReferenceLimits {
     audioOnly?: boolean;
     /** Per-video length caps (min/max each) and combined total for reference videos. */
     videoSeconds?: VideoSecondsLimits;
+    /** Per-clip length caps (min/max each) and combined total for reference audio, in seconds. */
+    audioSeconds?: {
+        min?: number;
+        max?: number;
+        total?: number;
+    };
+    /** File types the provider takes for reference audio, as lowercase extensions. */
+    audioFormats?: string[];
+    /** Largest reference audio file the provider takes, in bytes. */
+    audioMaxBytes?: number;
+}
+interface VideoToolConstraints {
+    kind: VideoToolKind;
+    /** Upscale: allowed factor range. */
+    upscaleFactor?: {
+        min: number;
+        max: number;
+    };
+    /** Upscale: the output's long edge may not pass this, in pixels. */
+    maxOutputLongEdge?: number;
+    /** Interpolate: allowed target frame rate range. */
+    fps?: {
+        min: number;
+        max: number;
+    };
+    /** HDR: the formats the row writes, first is the default. */
+    outputFormats?: VideoToolOutputFormat[];
 }
 /** Whether a video row's output has sound: always, switchable (`supports: generateAudio`), or silent. */
 type AudioOutput = "always" | "optional" | "never";
@@ -232,7 +320,12 @@ interface ModelConstraints {
     extension?: {
         segmentSeconds: number;
         maxTotalSeconds: number;
+        /** `joined` (absent): the provider returns the whole clip so far (Omni).
+         * `new`: it returns only the added footage and the caller joins it (Seedance). */
+        returns?: "new" | "joined";
     };
+    /** What a `video-tool` row accepts. Read it through `videoToolConstraints(row)`. */
+    tool?: VideoToolConstraints;
     /** Whether the output has sound. Read it through `outputAudio(row)`, which tolerates bad data. */
     audio?: AudioOutput;
     /** Prompt conventions. Read them through `promptConventions(row)`, which fills the default. */
@@ -293,6 +386,11 @@ interface CatalogDisplay {
 interface CatalogCapabilities {
     /** Video rows: takes an existing video as the thing to edit or extend. */
     acceptsSourceVideo?: boolean;
+    /**
+     * Video rows: offered for prompt-driven edits of a source clip (`taskType: "edit"`). Absent
+     * means the caller falls back to `acceptsSourceVideo`; `false` opts a row out.
+     */
+    videoEdit?: boolean;
     /** Video rows: first/last frames and reference images are mutually exclusive inputs. */
     framesExcludeReferences?: boolean;
     /** Video rows: a last frame is accepted only together with a first frame. */
@@ -411,6 +509,8 @@ interface UsageEvent {
     imageQuality?: ImageQuality;
     resolution?: VideoResolution;
     durationSeconds?: number;
+    /** Output frame rate (video-tool rows price by output frames). */
+    fps?: number;
     inputTokens?: number;
     outputTokens?: number;
     reportedCostUsd?: number;
@@ -553,6 +653,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         audio: "audio";
         upscale: "upscale";
         "bg-remove": "bg-remove";
+        "video-tool": "video-tool";
     }>;
     adapter: z.ZodEnum<{
         "ai-sdk-text": "ai-sdk-text";
@@ -625,6 +726,13 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
                 total: z.ZodOptional<z.ZodNumber>;
                 editMin: z.ZodOptional<z.ZodNumber>;
             }, z.core.$loose>>;
+            audioSeconds: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                total: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>;
+            audioFormats: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            audioMaxBytes: z.ZodOptional<z.ZodNumber>;
         }, z.core.$loose>>;
         requires: z.ZodOptional<z.ZodArray<z.ZodEnum<{
             references: "references";
@@ -664,6 +772,30 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         extension: z.ZodOptional<z.ZodObject<{
             segmentSeconds: z.ZodNumber;
             maxTotalSeconds: z.ZodNumber;
+            returns: z.ZodOptional<z.ZodEnum<{
+                new: "new";
+                joined: "joined";
+            }>>;
+        }, z.core.$loose>>;
+        tool: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                upscale: "upscale";
+                interpolate: "interpolate";
+                hdr: "hdr";
+            }>;
+            upscaleFactor: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$loose>>;
+            maxOutputLongEdge: z.ZodOptional<z.ZodNumber>;
+            fps: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$loose>>;
+            outputFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                h265: "h265";
+                prores: "prores";
+            }>>>;
         }, z.core.$loose>>;
         audio: z.ZodOptional<z.ZodUnknown>;
         prompt: z.ZodOptional<z.ZodUnknown>;
@@ -852,6 +984,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
     }, z.core.$loose>>;
     capabilities: z.ZodOptional<z.ZodObject<{
         acceptsSourceVideo: z.ZodOptional<z.ZodBoolean>;
+        videoEdit: z.ZodOptional<z.ZodBoolean>;
         framesExcludeReferences: z.ZodOptional<z.ZodBoolean>;
         lastFrameRequiresFirstFrame: z.ZodOptional<z.ZodBoolean>;
         reasoning: z.ZodOptional<z.ZodBoolean>;
@@ -919,6 +1052,29 @@ declare const IMAGE_MODELS: CatalogModel[];
 
 declare const VIDEO_MODELS: CatalogModel[];
 
+/**
+ * Topaz Labs video tools on fal. `providerOptions.fal.model` names the Topaz model the
+ * endpoint runs; the adapter sends it as `model`. Exposed on cowork only (Creative Studio).
+ */
+declare const VIDEO_TOOL_MODELS: CatalogModel[];
+
+/** A video-tool row's constraints, or undefined when the row has none or they are invalid. */
+declare function videoToolConstraints(row: CatalogModel): VideoToolConstraints | undefined;
+/** The pricing tier a frame lands in, by its short edge. */
+declare function resolutionTier(width: number, height: number): VideoResolution;
+type VideoToolPlan = {
+    ok: true;
+    output: VideoToolOutputSpec;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * What a video-tool request produces, checked against the row. Pure: callers use it to
+ * validate and price before submitting, and the adapter uses it to build the usage event.
+ */
+declare function planVideoTool(row: CatalogModel, req: Omit<VideoToolRequest, "model">): VideoToolPlan;
+
 declare const TEXT_MODELS: CatalogModel[];
 
 declare const OTHER_MODELS: CatalogModel[];
@@ -995,4 +1151,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, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, 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 KeyTier, 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 PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, 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, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, outputAudio, primeCatalog, promptConventions, resetLiveCatalog, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows, videoLengthViolation };
+export { ADAPTER_IDS, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, 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 KeyTier, 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 PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, 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, VIDEO_TOOL_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, type VideoResult, type VideoSecondsLimits, type VideoToolCallContext, type VideoToolConstraints, type VideoToolKind, type VideoToolOutputFormat, type VideoToolOutputSpec, type VideoToolPlan, type VideoToolRequest, type VideoToolResult, type VideoToolSource, type VideoToolStatus, type VideoToolSubmission, type Warning, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, nearestAspectRatio, normalizeExposure, outputAudio, planVideoTool, primeCatalog, promptConventions, resetLiveCatalog, resolutionTier, resolveAudioOptions, resolveImageOptions, resolveOptions, resolveVideoOptions, sortCatalogRows, videoLengthViolation, videoToolConstraints };