@shop-os/modelkit 0.2.21 → 0.2.23

package/dist/catalog.d.cts

@@ -942,6 +942,17 @@ declare const REFERENCE_SYNTAXES: ("numbered" | "caption" | "descriptive")[];
 declare function outputAudio(row: {
     constraints: unknown;
 }): AudioOutput | undefined;
+/**
+ * Whether a video request is billed as having sound. `always` rows are true and `never` rows
+ * false; an `optional` row takes the request's `generateAudio`, then the row's default, then
+ * true. A row with no declared audio is true. Every fallback is true because the base video
+ * price is the sound-on price: a guess must never pick the cheaper silent rate. Pass the same
+ * `requested` value the request dispatches with, so the billed and generated sound agree.
+ */
+declare function billedAudio(row: {
+    constraints: unknown;
+    defaults?: unknown;
+}, requested?: boolean): boolean;
 declare function promptConventions(row: {
     constraints: unknown;
 }): PromptConventions;
@@ -981,4 +992,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 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, 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 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 };

package/dist/catalog.d.ts

@@ -942,6 +942,17 @@ declare const REFERENCE_SYNTAXES: ("numbered" | "caption" | "descriptive")[];
 declare function outputAudio(row: {
     constraints: unknown;
 }): AudioOutput | undefined;
+/**
+ * Whether a video request is billed as having sound. `always` rows are true and `never` rows
+ * false; an `optional` row takes the request's `generateAudio`, then the row's default, then
+ * true. A row with no declared audio is true. Every fallback is true because the base video
+ * price is the sound-on price: a guess must never pick the cheaper silent rate. Pass the same
+ * `requested` value the request dispatches with, so the billed and generated sound agree.
+ */
+declare function billedAudio(row: {
+    constraints: unknown;
+    defaults?: unknown;
+}, requested?: boolean): boolean;
 declare function promptConventions(row: {
     constraints: unknown;
 }): PromptConventions;
@@ -981,4 +992,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 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, 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 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 };

package/dist/catalog.js

@@ -158,13 +158,16 @@ var GEMINI_RATIOS = [
   "5:4",
   "adaptive"
 ];
-function geminiImage(id, label, aliases, sizes, display, exposure, references) {
+var GEMINI_PROMPT_MAX_CHARS = 5e4;
+var GPT_IMAGE_PROMPT = { referenceSyntax: "numbered", maxChars: 32e3 };
+function geminiImage(id, label, aliases, sizes, display, exposure, references, promptMaxChars) {
+  const prompt = { referenceSyntax: "caption" };
+  if (promptMaxChars !== void 0) prompt.maxChars = promptMaxChars;
   const constraints = {
     aspectRatios: [...GEMINI_RATIOS],
     sizes,
     supports: ["safetySettings", "temperature"],
-    // google-image sends MediaRef.label as a text part beside each reference.
-    prompt: { referenceSyntax: "caption" }
+    prompt
   };
   if (references !== void 0) constraints.references = references;
   const model = {
@@ -196,7 +199,8 @@ var IMAGE_MODELS = [
       logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
     },
     ["cowork", "space_builder"],
-    { images: 14 }
+    { images: 14 },
+    GEMINI_PROMPT_MAX_CHARS
   ),
   geminiImage(
     "gemini-3.1-flash-image-preview",
@@ -210,7 +214,8 @@ var IMAGE_MODELS = [
       logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
     },
     ["cowork", "space_builder"],
-    { images: 14 }
+    { images: 14 },
+    GEMINI_PROMPT_MAX_CHARS
   ),
   geminiImage(
     "gemini-3.1-flash-lite-image",
@@ -223,7 +228,8 @@ var IMAGE_MODELS = [
       logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
     },
     ["cowork", "space_builder"],
-    { images: 14 }
+    { images: 14 },
+    GEMINI_PROMPT_MAX_CHARS
   ),
   // trigger-workflows validates 1K only; pricing seeds 2K/4K rows so allow all three.
   geminiImage(
@@ -261,7 +267,8 @@ var IMAGE_MODELS = [
       sizes: ["1K", "2K", "4K"],
       qualityOptions: ["auto", "low", "medium", "high"],
       references: { images: 16 },
-      supports: ["quality", "count", "outputFormat"]
+      supports: ["quality", "count", "outputFormat"],
+      prompt: GPT_IMAGE_PROMPT
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
     usage: { ...IMAGE_USAGE, slug: "gpt" },
@@ -296,7 +303,8 @@ var IMAGE_MODELS = [
       sizes: ["1K", "2K", "4K"],
       qualityOptions: ["auto", "low", "medium", "high", "xhigh", "max"],
       references: { images: 16 },
-      supports: ["quality", "count", "outputFormat"]
+      supports: ["quality", "count", "outputFormat"],
+      prompt: GPT_IMAGE_PROMPT
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
     usage: { ...IMAGE_USAGE },
@@ -330,7 +338,8 @@ var IMAGE_MODELS = [
       sizes: ["1K", "2K", "4K"],
       qualityOptions: ["auto", "low", "medium", "high", "xhigh", "max"],
       references: { images: 16 },
-      supports: ["quality", "count", "outputFormat"]
+      supports: ["quality", "count", "outputFormat"],
+      prompt: GPT_IMAGE_PROMPT
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
     usage: { ...IMAGE_USAGE },
@@ -453,7 +462,9 @@ var IMAGE_MODELS = [
       sizes: ["1K"],
       references: { images: 8 },
       // flux-2-pro's job type always returns image/png; only the seed is forwarded.
-      supports: ["seed"]
+      supports: ["seed"],
+      // Prodia's flux-2-pro schema gives the prompt a maxLength of 32,768.
+      prompt: { referenceSyntax: "numbered", maxChars: 32768 }
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
     usage: { ...IMAGE_USAGE },
@@ -1255,6 +1266,9 @@ var H3_REFERENCE_RATIOS = ["adaptive", ...H3_RATIOS];
 var NEGATIVE_PROMPT = "blur, distort, and low quality";
 var FRAMES_EXCLUDE_REFERENCES = { framesExcludeReferences: true };
 var KLING_PROMPT = { referenceSyntax: "numbered", maxChars: 2500 };
+var SEEDANCE_PROMPT = { referenceSyntax: "numbered", maxChars: 3e4 };
+var H3_PROMPT = { referenceSyntax: "numbered", maxChars: 5e4 };
+var OMNI_PROMPT = { referenceSyntax: "caption", maxChars: 5e4 };
 var BYTEDANCE_LOGO = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/3bba5d81-4e57-4e71-911b-cdfa05acca2c_compressed.png";
 var GOOGLE_LOGO2 = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png";
 var VIDEO_MODELS = [
@@ -1378,8 +1392,7 @@ var VIDEO_MODELS = [
       references: { images: 6, videos: 1, videoSeconds: { max: 10 } },
       sourceVideoSeconds: { max: 10 },
       supports: [],
-      // generateOmniVideo sends MediaRef.label as a text part beside each image.
-      prompt: { referenceSyntax: "caption" },
+      prompt: OMNI_PROMPT,
       audio: "always"
     },
     defaults: {},
@@ -1416,8 +1429,7 @@ var VIDEO_MODELS = [
       // First-to-last-frame interpolation: `<LAST_FRAME>` goes with `<FIRST_FRAME>`.
       supports: ["videoExtension", "lastFrame"],
       extension: { segmentSeconds: 10, maxTotalSeconds: 40 },
-      // generateOmniVideo sends MediaRef.label as a text part beside each image.
-      prompt: { referenceSyntax: "caption" },
+      prompt: OMNI_PROMPT,
       audio: "always"
     },
     defaults: {},
@@ -1456,6 +1468,7 @@ var VIDEO_MODELS = [
       ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       // No seed: 2.x echoes it but does not honour it (two seeded runs differed, 2026-10-01).
       supports: ["generateAudio", "lastFrame", "watermark"],
+      prompt: SEEDANCE_PROMPT,
       audio: "optional"
     },
     defaults: {
@@ -1497,6 +1510,7 @@ var VIDEO_MODELS = [
       ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       // No seed: 2.x echoes it but does not honour it (two seeded runs differed, 2026-10-01).
       supports: ["generateAudio", "lastFrame", "watermark"],
+      prompt: SEEDANCE_PROMPT,
       audio: "optional"
     },
     defaults: {
@@ -1538,6 +1552,7 @@ var VIDEO_MODELS = [
       ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       // No seed: 2.x echoes it but does not honour it (two seeded runs differed, 2026-10-01).
       supports: ["generateAudio", "lastFrame", "watermark", "taskType"],
+      prompt: SEEDANCE_PROMPT,
       audio: "optional"
     },
     defaults: {
@@ -1699,6 +1714,7 @@ var VIDEO_MODELS = [
       // fal's image-to-video endpoint has no aspect_ratio; the frame sets it.
       ratioIgnoredWith: ["firstFrame"],
       supports: ["seed", "promptExpansion", "lastFrame", "safetyChecker"],
+      prompt: H3_PROMPT,
       audio: "always"
     },
     defaults: {
@@ -1732,6 +1748,7 @@ var VIDEO_MODELS = [
       // fal's image-to-video endpoint has no aspect_ratio; the frame sets it.
       ratioIgnoredWith: ["firstFrame"],
       supports: ["seed", "promptExpansion", "lastFrame", "safetyChecker"],
+      prompt: H3_PROMPT,
       audio: "always"
     },
     defaults: {
@@ -1773,6 +1790,7 @@ var VIDEO_MODELS = [
         videoSeconds: { min: 2, max: 15, total: 15 }
       },
       supports: ["seed", "promptExpansion", "safetyChecker"],
+      prompt: H3_PROMPT,
       audio: "always"
     },
     defaults: {
@@ -1816,6 +1834,7 @@ var VIDEO_MODELS = [
         videoSeconds: { min: 2, max: 15, total: 15 }
       },
       supports: ["seed", "promptExpansion", "safetyChecker"],
+      prompt: H3_PROMPT,
       audio: "always"
     },
     defaults: {
@@ -1992,6 +2011,17 @@ function outputAudio(row) {
   const view = ConstraintsReadView.safeParse(row.constraints);
   return view.success ? view.data.audio : void 0;
 }
+var DefaultsReadView = z.looseObject({
+  generateAudio: z.boolean().optional().catch(void 0)
+});
+function billedAudio(row, requested) {
+  const audio = outputAudio(row);
+  if (audio === "never") return false;
+  if (audio !== "optional") return true;
+  if (requested !== void 0) return requested;
+  const defaults = DefaultsReadView.safeParse(row.defaults);
+  return (defaults.success ? defaults.data.generateAudio : void 0) ?? true;
+}
 function promptConventions(row) {
   const view = ConstraintsReadView.safeParse(row.constraints);
   const prompt = view.success ? view.data.prompt : void 0;
@@ -3198,6 +3228,7 @@ export {
   SurfaceSchema,
   TEXT_MODELS,
   VIDEO_MODELS,
+  billedAudio,
   compareCatalogOrder,
   isListed,
   isListedOn,