@shop-os/modelkit 0.1.11 → 0.2.2

package/dist/index.cjs

@@ -31,8 +31,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ADAPTER_IDS: () => ADAPTER_IDS,
   ADAPTER_KEYS: () => ADAPTER_KEYS,
   Catalog: () => Catalog,
+  CatalogModelSchema: () => CatalogModelSchema,
+  CatalogSchema: () => CatalogSchema,
   DEFAULT_ADAPTERS: () => DEFAULT_ADAPTERS,
   JsonObjectSchema: () => JsonObjectSchema,
   JsonValueSchema: () => JsonValueSchema,
@@ -48,6 +51,7 @@ __export(index_exports, {
   describeThrown: () => describeThrown,
   experimental_generateImage: () => generateImage,
   falAdapter: () => falAdapter,
+  fileCatalogCache: () => fileCatalogCache,
   generateAudio: () => generateAudio,
   generateImage: () => generateImage,
   generateObject: () => generateObject,
@@ -59,15 +63,19 @@ __export(index_exports, {
   isModelKitError: () => isModelKitError,
   keysFromEnv: () => keysFromEnv,
   languageModel: () => languageModel,
+  liveCatalog: () => liveCatalog,
+  liveState: () => liveState,
   mergeTextProviderOptions: () => mergeTextProviderOptions,
   nearestAspectRatio: () => nearestAspectRatio,
   openaiImageAdapter: () => openaiImageAdapter,
   passthroughTextModel: () => passthroughTextModel,
   pollUntil: () => pollUntil,
   prepareMediaPart: () => prepareMediaPart,
+  primeCatalog: () => primeCatalog,
   prodiaAdapter: () => prodiaAdapter,
   readErrorBody: () => readErrorBody,
   replicateAdapter: () => replicateAdapter,
+  resetLiveCatalog: () => resetLiveCatalog,
   resolveAudioOptions: () => resolveAudioOptions,
   resolveImageOptions: () => resolveImageOptions,
   resolveKeys: () => resolveKeys,
@@ -179,6 +187,14 @@ var Catalog = class _Catalog {
       ...rows
     ]);
   }
+  /** Atomically swap every row. Builds the maps first so a bad batch throws before anything changes. */
+  replace(rows) {
+    const next = new _Catalog(rows);
+    this.byId.clear();
+    this.byAlias.clear();
+    for (const [id, model] of next.byId) this.byId.set(id, model);
+    for (const [alias, id] of next.byAlias) this.byAlias.set(alias, id);
+  }
 };
 
 // src/catalog/image.ts
@@ -196,7 +212,7 @@ var GEMINI_RATIOS = [
   "5:4",
   "adaptive"
 ];
-function geminiImage(id, label, aliases, sizes, display, exposure) {
+function geminiImage(id, label, aliases, sizes, display, exposure, references) {
   const model = {
     id,
     aliases,
@@ -209,7 +225,8 @@ function geminiImage(id, label, aliases, sizes, display, exposure) {
     constraints: {
       aspectRatios: [...GEMINI_RATIOS],
       sizes,
-      supports: ["safetySettings", "temperature"]
+      supports: ["safetySettings", "temperature"],
+      ...references ? { references } : {}
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
     usage: { ...IMAGE_USAGE, slug: "gemini" },
@@ -229,7 +246,8 @@ var IMAGE_MODELS = [
       description: "Create stunning, production-quality visuals with exceptional realism, detail, and typography. Best for campaigns, e-commerce, product photography, and hero creatives.",
       logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
     },
-    "catalog"
+    "catalog",
+    { images: 14 }
   ),
   geminiImage(
     "gemini-3.1-flash-image-preview",
@@ -242,7 +260,8 @@ var IMAGE_MODELS = [
       description: "Generate high-quality images at speed. Perfect for brainstorming, moodboards, concept testing, creative exploration, and large batch workflows.",
       logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
     },
-    "catalog"
+    "catalog",
+    { images: 14 }
   ),
   geminiImage(
     "gemini-3.1-flash-lite-image",
@@ -254,14 +273,15 @@ var IMAGE_MODELS = [
       description: "The fastest and most affordable image model. Ideal for rapid drafts, bulk exploration, and iterative concept testing at 1K resolution.",
       logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
     },
-    "catalog"
+    "catalog",
+    { images: 14 }
   ),
   // trigger-workflows validates 1K only; pricing seeds 2K/4K rows so allow all three.
   geminiImage(
     "gemini-2.5-flash-image",
     "Gemini 2.5 Flash Image",
     [],
-    ["1K", "2K", "4K"],
+    ["1K"],
     {
       provider: "google",
       description: "Nano Banana (legacy Gemini 2.5 Flash Image) native image generation and editing model for high-volume, low-latency creative workflows."
@@ -292,7 +312,7 @@ var IMAGE_MODELS = [
       sizes: ["1K", "2K", "4K"],
       qualityOptions: ["auto", "low", "medium", "high"],
       references: { images: 16 },
-      supports: ["quality", "count"]
+      supports: ["quality", "count", "outputFormat"]
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
     usage: { ...IMAGE_USAGE, slug: "gpt" },
@@ -312,7 +332,7 @@ var IMAGE_MODELS = [
     adapter: "openai-image",
     providerModelId: "gpt-image-2.5-sunburst",
     lifecycle: "active",
-    exposure: "internal",
+    exposure: "catalog",
     constraints: {
       exactSizes: {
         "1:1": "1024x1024",
@@ -325,9 +345,9 @@ var IMAGE_MODELS = [
       },
       aspectRatios: ["1:1", "3:2", "2:3", "16:9", "9:16", "4:5", "5:4", "adaptive"],
       sizes: ["1K", "2K", "4K"],
-      qualityOptions: ["auto", "low", "medium", "high"],
+      qualityOptions: ["auto", "low", "medium", "high", "xhigh", "max"],
       references: { images: 16 },
-      supports: ["quality", "count"]
+      supports: ["quality", "count", "outputFormat"]
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
     usage: { ...IMAGE_USAGE },
@@ -346,7 +366,7 @@ var IMAGE_MODELS = [
     adapter: "openai-image",
     providerModelId: "gpt-image-2.5-flare",
     lifecycle: "active",
-    exposure: "internal",
+    exposure: "catalog",
     constraints: {
       exactSizes: {
         "1:1": "1024x1024",
@@ -359,9 +379,9 @@ var IMAGE_MODELS = [
       },
       aspectRatios: ["1:1", "3:2", "2:3", "16:9", "9:16", "4:5", "5:4", "adaptive"],
       sizes: ["1K", "2K", "4K"],
-      qualityOptions: ["auto", "low", "medium", "high"],
+      qualityOptions: ["auto", "low", "medium", "high", "xhigh", "max"],
       references: { images: 16 },
-      supports: ["quality", "count"]
+      supports: ["quality", "count", "outputFormat"]
     },
     defaults: { size: "1K", aspectRatio: "adaptive", quality: "auto" },
     usage: { ...IMAGE_USAGE },
@@ -391,8 +411,6 @@ var IMAGE_MODELS = [
         "2:3",
         "3:4",
         "9:16",
-        "4:5",
-        "5:4",
         "9:21",
         "adaptive"
       ],
@@ -424,7 +442,7 @@ var IMAGE_MODELS = [
       references: { images: 10 },
       // Ark's Images API has no output-format, quality or count field; only
       // the seed is forwarded, so anything else must warn, not vanish.
-      supports: ["seed"]
+      supports: ["seed", "outputFormat"]
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
     usage: { ...IMAGE_USAGE },
@@ -460,7 +478,7 @@ var IMAGE_MODELS = [
         "21:9",
         "9:21"
       ],
-      sizes: ["1K", "2K", "4K"],
+      sizes: ["2K", "4K"],
       references: { images: 10 },
       supports: ["seed"]
     },
@@ -512,7 +530,7 @@ var IMAGE_MODELS = [
       aspectRatios: ["1:1", "2:3", "3:2", "4:3", "3:4", "4:5", "5:4", "9:16", "16:9", "21:9"],
       sizes: ["1K", "2K", "4K"],
       requires: ["references"],
-      supports: ["seed"]
+      supports: []
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
     usage: { ...IMAGE_USAGE },
@@ -537,7 +555,7 @@ var IMAGE_MODELS = [
       aspectRatios: ["1:1", "2:3", "3:4", "4:3", "9:16", "16:9", "21:9"],
       sizes: ["1K"],
       requires: ["references"],
-      supports: ["seed"]
+      supports: []
     },
     defaults: { size: "1K", aspectRatio: "1:1" },
     usage: { ...IMAGE_USAGE },
@@ -589,7 +607,6 @@ var IMAGE_MODELS = [
       aspectRatios: ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"],
       sizes: [],
       references: { images: 1 },
-      requires: ["references"],
       supports: []
     },
     defaults: { aspectRatio: "1:1" },
@@ -1308,7 +1325,7 @@ var VIDEO_MODELS = [
       resolutions: ["720p", "1080p", "4k"],
       durations: [8],
       references: { images: 3 },
-      supports: ["lastFrame"]
+      supports: ["lastFrame", "seed"]
     },
     defaults: { durationSeconds: 8, resolution: "720p", aspectRatio: "16:9" },
     usage: { ...VIDEO_USAGE, slug: "veo" },
@@ -1336,9 +1353,9 @@ var VIDEO_MODELS = [
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
       resolutions: ["720p", "1080p", "4k"],
-      durations: [4, 8],
+      durations: [4, 6, 8],
       references: { images: 3 },
-      supports: ["lastFrame"]
+      supports: ["lastFrame", "seed"]
     },
     defaults: { durationSeconds: 8, resolution: "720p", aspectRatio: "16:9" },
     usage: { ...VIDEO_USAGE },
@@ -1365,9 +1382,8 @@ var VIDEO_MODELS = [
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
       resolutions: ["720p", "1080p"],
-      durations: [4, 8],
-      references: { images: 3 },
-      supports: ["lastFrame"]
+      durations: [4, 6, 8],
+      supports: ["lastFrame", "seed"]
     },
     defaults: { durationSeconds: 8, resolution: "720p", aspectRatio: "16:9" },
     usage: { ...VIDEO_USAGE },
@@ -1399,7 +1415,7 @@ var VIDEO_MODELS = [
       // reference clip keeps its own framing.
       aspectRatios: [...OMNI_RATIOS],
       durations: [3, 4, 5, 6, 7, 8, 9, 10],
-      references: { images: 6, videos: 1 },
+      references: { images: 6, videos: 3 },
       supports: []
     },
     defaults: {},
@@ -1425,7 +1441,7 @@ var VIDEO_MODELS = [
       aspectRatios: [...OMNI_RATIOS],
       resolutions: ["360p", "720p", "1080p", "4k"],
       durations: [3, 4, 5, 6, 7, 8, 9, 10],
-      references: { images: 6, videos: 1 },
+      references: { images: 6, videos: 3 },
       supports: []
     },
     defaults: {},
@@ -1454,7 +1470,7 @@ var VIDEO_MODELS = [
       durations: { min: 4, max: 15 },
       durationPresets: [4, 6, 8, 10, 12, 15],
       references: { images: 9, videos: 3, audios: 3, audioOnly: false },
-      ratioIgnoredWith: ["firstFrame"],
+      ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       supports: ["generateAudio", "seed", "lastFrame", "watermark"]
     },
     defaults: {
@@ -1486,7 +1502,7 @@ var VIDEO_MODELS = [
       resolutions: ["480p", "720p"],
       durations: { min: 4, max: 15 },
       references: { images: 9, videos: 3, audios: 3, audioOnly: false },
-      ratioIgnoredWith: ["firstFrame"],
+      ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       supports: ["generateAudio", "seed", "lastFrame", "watermark"]
     },
     defaults: {
@@ -1519,7 +1535,7 @@ var VIDEO_MODELS = [
       resolutions: ["480p", "720p", "1080p"],
       durations: { min: 4, max: 30 },
       references: { images: 30, videos: 10, audios: 10 },
-      ratioIgnoredWith: ["firstFrame"],
+      ratioIgnoredWith: ["firstFrame", "sourceVideo"],
       supports: ["generateAudio", "seed", "lastFrame", "watermark"]
     },
     defaults: {
@@ -1638,18 +1654,7 @@ var VIDEO_MODELS = [
     lifecycle: "active",
     exposure: "catalog",
     constraints: {
-      aspectRatios: [
-        "1:1",
-        "16:9",
-        "9:16",
-        "4:3",
-        "3:4",
-        "3:2",
-        "2:3",
-        "21:9",
-        "4:5",
-        "adaptive"
-      ],
+      aspectRatios: [...KLING_RATIOS],
       resolutions: ["720p", "1080p"],
       durations: { min: 3, max: 15 },
       references: { images: 7 },
@@ -1869,6 +1874,417 @@ var MODELS = [
   ...OTHER_MODELS
 ];
 
+// src/catalog/schema.ts
+var import_zod = require("zod");
+var ADAPTER_IDS = [
+  "ai-sdk-text",
+  "google-image",
+  "openai-image",
+  "google-genai",
+  "ark",
+  "fal",
+  "replicate",
+  "prodia",
+  "higgsfield",
+  "xai-video"
+];
+var ModelTypeSchema = import_zod.z.enum(["text", "image", "video", "audio", "upscale", "bg-remove"]);
+var LifecycleSchema = import_zod.z.enum(["active", "deprecated", "retired"]);
+var AdapterSchema = import_zod.z.enum(ADAPTER_IDS);
+var AspectRatioSchema = import_zod.z.enum([
+  "1:1",
+  "16:9",
+  "9:16",
+  "4:3",
+  "3:4",
+  "3:2",
+  "2:3",
+  "4:5",
+  "5:4",
+  "21:9",
+  "9:21",
+  "97:30",
+  "adaptive"
+]);
+var ImageSizeSchema = import_zod.z.enum(["512", "1K", "2K", "4K"]);
+var VideoResolutionSchema = import_zod.z.enum(["360p", "480p", "720p", "768p", "1080p", "2k", "4k"]);
+var ImageQualitySchema = import_zod.z.enum(["auto", "low", "medium", "high", "xhigh", "max"]);
+var OutputFormatSchema = import_zod.z.enum(["png", "jpeg", "webp"]);
+var RequiredInputSchema = import_zod.z.enum(["firstFrame", "sourceVideo", "references"]);
+var SupportedOptionSchema = import_zod.z.enum([
+  "seed",
+  "quality",
+  "negativePrompt",
+  "cfgScale",
+  "generateAudio",
+  "promptExpansion",
+  "lastFrame",
+  "count",
+  "outputFormat",
+  "scaleFactor",
+  "safetySettings",
+  "temperature",
+  "upscale",
+  "watermark",
+  "safetyChecker",
+  "instrumental"
+]);
+var UsageUnitSchema = import_zod.z.enum([
+  "tokens",
+  "images",
+  "seconds",
+  "reported_cost_usd",
+  "compute_seconds"
+]);
+var PricingKindSchema = import_zod.z.enum(["token", "image_size", "video_per_second", "flat"]);
+var ProviderOptionValueSchema = import_zod.z.lazy(
+  () => import_zod.z.union([
+    import_zod.z.string(),
+    import_zod.z.number(),
+    import_zod.z.boolean(),
+    import_zod.z.array(ProviderOptionValueSchema),
+    import_zod.z.record(import_zod.z.string(), ProviderOptionValueSchema)
+  ])
+);
+var ProviderOptionsSchema = import_zod.z.record(import_zod.z.string(), import_zod.z.record(import_zod.z.string(), ProviderOptionValueSchema));
+var ReferenceLimitsSchema = import_zod.z.looseObject({
+  images: import_zod.z.number().optional(),
+  videos: import_zod.z.number().optional(),
+  audios: import_zod.z.number().optional(),
+  total: import_zod.z.number().optional(),
+  audioOnly: import_zod.z.boolean().optional()
+});
+var ModelConstraintsSchema = import_zod.z.looseObject({
+  aspectRatios: import_zod.z.array(AspectRatioSchema).optional(),
+  sizes: import_zod.z.array(ImageSizeSchema).optional(),
+  resolutions: import_zod.z.array(VideoResolutionSchema).optional(),
+  durations: import_zod.z.union([import_zod.z.looseObject({ min: import_zod.z.number(), max: import_zod.z.number() }), import_zod.z.array(import_zod.z.number())]).optional(),
+  durationPresets: import_zod.z.array(import_zod.z.number()).optional(),
+  qualityOptions: import_zod.z.array(import_zod.z.string()).optional(),
+  exactSizes: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional(),
+  references: ReferenceLimitsSchema.optional(),
+  requires: import_zod.z.array(RequiredInputSchema).optional(),
+  supports: import_zod.z.array(SupportedOptionSchema).optional(),
+  ratioIgnoredWith: import_zod.z.array(import_zod.z.enum(["firstFrame", "sourceVideo"])).optional()
+});
+var MediaRefSchema = import_zod.z.union([
+  import_zod.z.looseObject({ url: import_zod.z.string(), label: import_zod.z.string().optional() }),
+  import_zod.z.looseObject({
+    bytes: import_zod.z.instanceof(Uint8Array),
+    mime: import_zod.z.string(),
+    label: import_zod.z.string().optional()
+  })
+]);
+var ImageSafetySettingSchema = import_zod.z.looseObject({ category: import_zod.z.string(), threshold: import_zod.z.string() });
+var UpscaleOptionsSchema = import_zod.z.looseObject({
+  enhanceModel: import_zod.z.string().optional(),
+  subjectDetection: import_zod.z.string().optional(),
+  faceEnhancement: import_zod.z.boolean().optional(),
+  faceEnhancementCreativity: import_zod.z.number().optional(),
+  faceEnhancementStrength: import_zod.z.number().optional()
+});
+var DefaultsSchema = import_zod.z.looseObject({
+  references: import_zod.z.array(MediaRefSchema).optional(),
+  aspectRatio: AspectRatioSchema.optional(),
+  size: ImageSizeSchema.optional(),
+  exactSize: import_zod.z.string().optional(),
+  quality: ImageQualitySchema.optional(),
+  seed: import_zod.z.number().optional(),
+  count: import_zod.z.number().optional(),
+  outputFormat: OutputFormatSchema.optional(),
+  scaleFactor: import_zod.z.number().optional(),
+  safetySettings: import_zod.z.array(ImageSafetySettingSchema).optional(),
+  temperature: import_zod.z.number().optional(),
+  upscale: UpscaleOptionsSchema.optional(),
+  firstFrame: MediaRefSchema.optional(),
+  lastFrame: MediaRefSchema.optional(),
+  sourceVideo: MediaRefSchema.optional(),
+  referenceImages: import_zod.z.array(MediaRefSchema).optional(),
+  referenceVideos: import_zod.z.array(MediaRefSchema).optional(),
+  referenceAudios: import_zod.z.array(MediaRefSchema).optional(),
+  resolution: VideoResolutionSchema.optional(),
+  durationSeconds: import_zod.z.number().optional(),
+  generateAudio: import_zod.z.boolean().optional(),
+  negativePrompt: import_zod.z.string().optional(),
+  cfgScale: import_zod.z.number().optional(),
+  promptExpansion: import_zod.z.enum(["fast", "balanced", "quality"]).optional(),
+  watermark: import_zod.z.boolean().optional(),
+  safetyChecker: import_zod.z.boolean().optional(),
+  mode: import_zod.z.enum(["standard", "pro"]).optional(),
+  instrumental: import_zod.z.boolean().optional()
+});
+var CatalogDisplaySchema = import_zod.z.looseObject({
+  provider: import_zod.z.string(),
+  description: import_zod.z.string(),
+  logo: import_zod.z.string().optional(),
+  costTier: import_zod.z.union([import_zod.z.literal(1), import_zod.z.literal(2), import_zod.z.literal(3)]).optional(),
+  recommended: import_zod.z.boolean().optional(),
+  sortOrder: import_zod.z.number().optional(),
+  chat: import_zod.z.looseObject({
+    providerOptions: ProviderOptionsSchema.optional(),
+    temperature: import_zod.z.number().optional()
+  }).optional()
+});
+var CatalogCapabilitiesSchema = import_zod.z.looseObject({
+  acceptsSourceVideo: import_zod.z.boolean().optional(),
+  framesExcludeReferences: import_zod.z.boolean().optional(),
+  reasoning: import_zod.z.boolean().optional(),
+  vision: import_zod.z.boolean().optional(),
+  contextWindow: import_zod.z.number().optional()
+});
+var CatalogModelSchemaBase = import_zod.z.looseObject({
+  id: import_zod.z.string().min(1),
+  aliases: import_zod.z.array(import_zod.z.string()).default([]),
+  label: import_zod.z.string().min(1),
+  type: ModelTypeSchema,
+  adapter: AdapterSchema,
+  providerModelId: import_zod.z.string().min(1),
+  lifecycle: LifecycleSchema,
+  replacedBy: import_zod.z.string().optional(),
+  exposure: import_zod.z.enum(["catalog", "internal"]),
+  constraints: ModelConstraintsSchema,
+  defaults: DefaultsSchema,
+  providerOptions: ProviderOptionsSchema.optional(),
+  usage: import_zod.z.looseObject({
+    unit: UsageUnitSchema,
+    slug: import_zod.z.string().optional(),
+    providerLabel: import_zod.z.string().optional()
+  }),
+  pricingKind: PricingKindSchema,
+  display: CatalogDisplaySchema.optional(),
+  capabilities: CatalogCapabilitiesSchema.optional()
+}).superRefine((row, ctx) => {
+  if (row.lifecycle === "active" && !row.display) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["display"],
+      message: "active rows need display"
+    });
+  }
+  if (row.lifecycle === "active" && row.type === "text" && !row.capabilities?.contextWindow) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["capabilities", "contextWindow"],
+      message: "active text rows need contextWindow"
+    });
+  }
+  if (row.replacedBy !== void 0 && row.replacedBy === row.id) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["replacedBy"],
+      message: "replacedBy must not equal id"
+    });
+  }
+});
+var CatalogModelSchema = CatalogModelSchemaBase;
+var CatalogSchema = import_zod.z.array(CatalogModelSchemaBase).superRefine((rows, ctx) => {
+  const seenIds = /* @__PURE__ */ new Map();
+  rows.forEach((row, index) => {
+    if (seenIds.has(row.id)) {
+      ctx.addIssue({
+        code: "custom",
+        path: [index, "id"],
+        message: `Duplicate model id "${row.id}"`
+      });
+    } else {
+      seenIds.set(row.id, index);
+    }
+  });
+  const seenAliases = /* @__PURE__ */ new Map();
+  rows.forEach((row, index) => {
+    row.aliases.forEach((alias, aliasIndex) => {
+      const path = [index, "aliases", aliasIndex];
+      if (alias === row.id || seenIds.has(alias)) {
+        ctx.addIssue({
+          code: "custom",
+          path,
+          message: `Alias "${alias}" collides with a model id`
+        });
+        return;
+      }
+      if (seenAliases.has(alias)) {
+        ctx.addIssue({
+          code: "custom",
+          path,
+          message: `Duplicate alias "${alias}"`
+        });
+      } else {
+        seenAliases.set(alias, index);
+      }
+    });
+  });
+});
+
+// src/catalog/live.ts
+var KEY = /* @__PURE__ */ Symbol.for("@shop-os/modelkit/live-catalog");
+var store = globalThis;
+var liveState = store[KEY] ??= {
+  catalog: new Catalog(MODELS),
+  memo: void 0,
+  timer: void 0,
+  revision: void 0,
+  origin: "snapshot"
+};
+var liveCatalog = liveState.catalog;
+
+// src/catalog/load.ts
+function rowCount() {
+  return liveCatalog.list({ lifecycle: ["active", "deprecated", "retired"] }).length;
+}
+function authHeaders(auth) {
+  return "bearer" in auth ? { Authorization: `Bearer ${auth.bearer}` } : { "x-api-key": auth.apiKey };
+}
+function describeError(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+function parseEnvelope(json) {
+  if (typeof json !== "object" || json === null || !("rows" in json)) {
+    throw new Error("invalid catalog response: missing rows");
+  }
+  const rows = CatalogSchema.parse(json.rows);
+  const rev = json.revision;
+  if (typeof rev === "string") return { rows, revision: rev };
+  return { rows };
+}
+function logPrimed(logger, result) {
+  const { origin: loggedOrigin, rowCount: loggedCount, revision: loggedRevision } = result;
+  logger.info("[modelkit] catalog primed", {
+    origin: loggedOrigin,
+    rowCount: loggedCount,
+    revision: loggedRevision
+  });
+}
+async function fetchRemote(source, logger) {
+  const fetchImpl = source.fetch ?? globalThis.fetch;
+  const headers2 = authHeaders(source.auth);
+  if (liveState.revision !== void 0) headers2["If-None-Match"] = `"${liveState.revision}"`;
+  const res = await fetchImpl(`${source.baseUrl}/models/catalog`, {
+    headers: headers2,
+    signal: AbortSignal.timeout(source.timeoutMs ?? 1e4)
+  });
+  if (res.status === 304) return { kept: true };
+  if (!res.ok) throw new Error(`catalog fetch failed with status ${res.status}`);
+  const json = await res.json();
+  const { rows, revision: rev } = parseEnvelope(json);
+  if (rev === void 0) return { rows, fromCache: false };
+  return { rows, revision: rev, fromCache: false };
+}
+async function writeCache(source, logger, rows, rev) {
+  if (!source.cache) return;
+  try {
+    await source.cache.set(JSON.stringify({ rows, revision: rev }));
+  } catch (err) {
+    logger.warn("[modelkit] catalog cache write failed", err);
+  }
+}
+async function prime(source, logger) {
+  try {
+    const fetched = await fetchRemote(source, logger);
+    if ("kept" in fetched) {
+      const result2 = { origin: liveState.origin, rowCount: rowCount() };
+      if (liveState.revision !== void 0) result2.revision = liveState.revision;
+      logPrimed(logger, result2);
+      return result2;
+    }
+    liveCatalog.replace(fetched.rows);
+    liveState.origin = "remote";
+    liveState.revision = fetched.revision;
+    await writeCache(source, logger, fetched.rows, fetched.revision);
+    const result = { origin: liveState.origin, rowCount: rowCount() };
+    if (fetched.revision !== void 0) result.revision = fetched.revision;
+    logPrimed(logger, result);
+    return result;
+  } catch (err) {
+    logger.warn("[modelkit] catalog remote failed, trying cache", err);
+    const error = describeError(err);
+    try {
+      const cached = await source.cache?.get();
+      if (!cached) throw new Error("no cached catalog");
+      const { rows, revision: rev } = parseEnvelope(JSON.parse(cached));
+      liveCatalog.replace(rows);
+      liveState.origin = "last-good";
+      liveState.revision = rev;
+      const result = {
+        origin: liveState.origin,
+        rowCount: rowCount(),
+        error
+      };
+      if (rev !== void 0) result.revision = rev;
+      logPrimed(logger, result);
+      return result;
+    } catch (cacheErr) {
+      logger.warn("[modelkit] catalog cache failed, using snapshot", cacheErr);
+      liveCatalog.replace([...MODELS]);
+      liveState.origin = "snapshot";
+      liveState.revision = void 0;
+      const result = {
+        origin: liveState.origin,
+        rowCount: rowCount(),
+        error
+      };
+      logPrimed(logger, result);
+      return result;
+    }
+  }
+}
+async function refresh(source, logger) {
+  try {
+    const fetched = await fetchRemote(source, logger);
+    if ("kept" in fetched) return;
+    liveCatalog.replace(fetched.rows);
+    liveState.origin = "remote";
+    liveState.revision = fetched.revision;
+    await writeCache(source, logger, fetched.rows, fetched.revision);
+  } catch (err) {
+    logger.warn("[modelkit] catalog refresh failed, keeping current rows", err);
+  }
+}
+function primeCatalog(source) {
+  const memo = liveState.memo;
+  if (memo) return memo;
+  const logger = source.logger ?? console;
+  liveState.memo = prime(source, logger).then((result) => {
+    const ttlMs = source.ttlMs ?? 3e5;
+    if (ttlMs > 0 && liveState.timer === void 0) {
+      liveState.timer = setInterval(() => void refresh(source, logger), ttlMs);
+      const maybeUnref = liveState.timer;
+      maybeUnref.unref?.();
+    }
+    return result;
+  });
+  return liveState.memo;
+}
+function resetLiveCatalog() {
+  if (liveState.timer !== void 0) {
+    clearInterval(liveState.timer);
+    liveState.timer = void 0;
+  }
+  liveState.memo = void 0;
+  liveState.revision = void 0;
+  liveState.origin = "snapshot";
+  liveCatalog.replace([...MODELS]);
+}
+
+// src/catalog/file-cache.ts
+var import_promises = require("fs/promises");
+function fileCatalogCache(path) {
+  return {
+    async get() {
+      try {
+        return await (0, import_promises.readFile)(path, "utf8");
+      } catch (err) {
+        if (err?.code === "ENOENT") return null;
+        throw err;
+      }
+    },
+    async set(json) {
+      const tmp = `${path}.tmp`;
+      await (0, import_promises.writeFile)(tmp, json, "utf8");
+      await (0, import_promises.rename)(tmp, path);
+    }
+  };
+}
+
 // src/resolve-options.ts
 var SIZE_ORDER = ["512", "1K", "2K", "4K"];
 var RESOLUTION_ORDER = ["360p", "480p", "720p", "768p", "1080p", "2k", "4k"];
@@ -2294,21 +2710,21 @@ function keysFromEnv(env, prefix = "") {
 }
 
 // src/retry.ts
-var import_zod2 = require("zod");
+var import_zod3 = require("zod");
 
 // src/json.ts
-var import_zod = require("zod");
-var JsonValueSchema = import_zod.z.lazy(
-  () => import_zod.z.union([
-    import_zod.z.string(),
-    import_zod.z.number(),
-    import_zod.z.boolean(),
-    import_zod.z.null(),
-    import_zod.z.array(JsonValueSchema),
-    import_zod.z.record(import_zod.z.string(), JsonValueSchema)
+var import_zod2 = require("zod");
+var JsonValueSchema = import_zod2.z.lazy(
+  () => import_zod2.z.union([
+    import_zod2.z.string(),
+    import_zod2.z.number(),
+    import_zod2.z.boolean(),
+    import_zod2.z.null(),
+    import_zod2.z.array(JsonValueSchema),
+    import_zod2.z.record(import_zod2.z.string(), JsonValueSchema)
   ])
 );
-var JsonObjectSchema = import_zod.z.record(import_zod.z.string(), JsonValueSchema);
+var JsonObjectSchema = import_zod2.z.record(import_zod2.z.string(), JsonValueSchema);
 async function readErrorBody(res) {
   const text2 = await res.text().catch(() => "");
   try {
@@ -2317,11 +2733,11 @@ async function readErrorBody(res) {
     return text2;
   }
 }
-var thrownErrorSchema = import_zod.z.object({
-  message: import_zod.z.string().optional(),
-  status: import_zod.z.number().optional(),
-  statusCode: import_zod.z.number().optional(),
-  responseBody: import_zod.z.string().optional()
+var thrownErrorSchema = import_zod2.z.object({
+  message: import_zod2.z.string().optional(),
+  status: import_zod2.z.number().optional(),
+  statusCode: import_zod2.z.number().optional(),
+  responseBody: import_zod2.z.string().optional()
 });
 function describeThrown(cause) {
   const parsed = thrownErrorSchema.safeParse(cause);
@@ -2332,7 +2748,7 @@ function describeThrown(cause) {
 }
 
 // src/retry.ts
-var textBody = import_zod2.z.string();
+var textBody = import_zod3.z.string();
 function classifyHttpError(status, body, provider, model) {
   const asText = textBody.safeParse(body);
   const text2 = asText.success ? asText.data : JSON.stringify(body);
@@ -2540,7 +2956,7 @@ function createTextSteps(initial, resolve, callerProviderOptions) {
 
 // src/client.ts
 var import_ai2 = require("ai");
-var import_zod4 = require("zod");
+var import_zod5 = require("zod");
 
 // src/adapters/media-ref.ts
 function isUrlRef(ref) {
@@ -2625,7 +3041,7 @@ var import_perplexity = require("@ai-sdk/perplexity");
 var import_xai = require("@ai-sdk/xai");
 var import_deepseek = require("@ai-sdk/deepseek");
 var import_moonshotai = require("@ai-sdk/moonshotai");
-var import_zod3 = require("zod");
+var import_zod4 = require("zod");
 var TEXT_PROVIDERS = [
   "openai",
   "anthropic",
@@ -2636,7 +3052,7 @@ var TEXT_PROVIDERS = [
   "moonshot",
   "minimax"
 ];
-var textProviderSchema = import_zod3.z.enum(TEXT_PROVIDERS);
+var textProviderSchema = import_zod4.z.enum(TEXT_PROVIDERS);
 function isTextProvider(value) {
   return textProviderSchema.safeParse(value).success;
 }
@@ -2806,10 +3222,10 @@ function textAbortOptions(sdk, context) {
   if (abortSignal) return { abortSignal };
   return {};
 }
-var catalogId = import_zod4.z.string();
-var exactSize = import_zod4.z.templateLiteral([import_zod4.z.number(), "x", import_zod4.z.number()]);
-var sdkRatio = import_zod4.z.templateLiteral([import_zod4.z.number(), ":", import_zod4.z.number()]);
-var sizeTier = import_zod4.z.enum(["512", "1K", "2K", "4K"]);
+var catalogId = import_zod5.z.string();
+var exactSize = import_zod5.z.templateLiteral([import_zod5.z.number(), "x", import_zod5.z.number()]);
+var sdkRatio = import_zod5.z.templateLiteral([import_zod5.z.number(), ":", import_zod5.z.number()]);
+var sizeTier = import_zod5.z.enum(["512", "1K", "2K", "4K"]);
 function isCatalogId(model) {
   return catalogId.safeParse(model).success;
 }
@@ -2876,7 +3292,7 @@ function logCoercions(logger, modelId, warnings) {
   logger.warn(`[modelkit] ${modelId} request coerced`, { model: modelId, warnings });
 }
 function createModelKit(config, adapters) {
-  const catalog = new Catalog(MODELS).withOverrides(config.catalogOverride ?? []);
+  const catalog = config.catalogOverride ? liveCatalog.withOverrides(config.catalogOverride) : liveCatalog;
   const logger = config.logger ?? console;
   const fetchImpl = config.fetch ?? globalThis.fetch;
   function context(model, call, warnings) {
@@ -3330,7 +3746,7 @@ function createModelKit(config, adapters) {
 }
 
 // src/adapters/ark.ts
-var import_zod5 = require("zod");
+var import_zod6 = require("zod");
 var ARK_BASE_URL = "https://ark.ap-southeast.bytepluses.com/api/v3";
 var SUBMIT_PATH = "/contents/generations/tasks";
 var SEEDANCE_POLL_INTERVAL_MS = 15e3;
@@ -3407,7 +3823,7 @@ function arkKey(ctx) {
   return key;
 }
 function throwArkError(status, body, model) {
-  const parsed = import_zod5.z.string().safeParse(body);
+  const parsed = import_zod6.z.string().safeParse(body);
   const text2 = parsed.success ? parsed.data : JSON.stringify(body ?? "");
   if (/sensitive.?content|human.?face/i.test(text2)) {
     const init = {
@@ -3445,13 +3861,13 @@ function sniffedImageMime(bytes) {
     return "image/webp";
   return "image/jpeg";
 }
-var SeedreamImageSchema = import_zod5.z.object({
-  url: import_zod5.z.string().optional(),
-  b64_json: import_zod5.z.string().optional()
+var SeedreamImageSchema = import_zod6.z.object({
+  url: import_zod6.z.string().optional(),
+  b64_json: import_zod6.z.string().optional()
 });
-var SeedreamResponseSchema = import_zod5.z.object({
-  data: import_zod5.z.array(SeedreamImageSchema).optional(),
-  error: import_zod5.z.object({ message: import_zod5.z.string().optional(), code: import_zod5.z.string().optional() }).optional()
+var SeedreamResponseSchema = import_zod6.z.object({
+  data: import_zod6.z.array(SeedreamImageSchema).optional(),
+  error: import_zod6.z.object({ message: import_zod6.z.string().optional(), code: import_zod6.z.string().optional() }).optional()
 });
 function retryOptsFor(ctx, attempts = 3) {
   const opts = { attempts };
@@ -3480,6 +3896,18 @@ async function generateSeedreamImage(req, ctx) {
     watermark: false
   };
   if (req.seed !== void 0) body.seed = req.seed;
+  if (req.outputFormat !== void 0) {
+    if (req.outputFormat === "webp") {
+      ctx.warnings.push({
+        code: "option_ignored",
+        field: "outputFormat",
+        from: "webp",
+        to: "png",
+        message: `${modelId} accepts png or jpeg output; using png`
+      });
+    }
+    body.output_format = req.outputFormat === "jpeg" ? "jpeg" : "png";
+  }
   const firstRef = refs[0];
   if (refs.length === 1 && firstRef !== void 0) body.image = firstRef;
   else if (refs.length > 1) body.image = refs;
@@ -3523,21 +3951,21 @@ async function generateSeedreamImage(req, ctx) {
   if (req.quality !== void 0) usage2.imageQuality = req.quality;
   return { images: [{ bytes, mime: sniffedImageMime(bytes) }], usage: usage2, raw: data };
 }
-var SeedanceUsageSchema = import_zod5.z.object({
-  total_tokens: import_zod5.z.number().optional(),
-  completion_tokens: import_zod5.z.number().optional()
+var SeedanceUsageSchema = import_zod6.z.object({
+  total_tokens: import_zod6.z.number().optional(),
+  completion_tokens: import_zod6.z.number().optional()
 });
-var SeedanceResponseSchema = import_zod5.z.object({
-  id: import_zod5.z.string().optional(),
-  status: import_zod5.z.string().optional(),
-  content: import_zod5.z.object({ video_url: import_zod5.z.string().optional() }).optional(),
+var SeedanceResponseSchema = import_zod6.z.object({
+  id: import_zod6.z.string().optional(),
+  status: import_zod6.z.string().optional(),
+  content: import_zod6.z.object({ video_url: import_zod6.z.string().optional() }).optional(),
   usage: SeedanceUsageSchema.optional(),
-  duration: import_zod5.z.number().optional(),
-  framespersecond: import_zod5.z.number().optional(),
-  resolution: import_zod5.z.string().optional(),
-  error: import_zod5.z.union([import_zod5.z.string(), import_zod5.z.object({ message: import_zod5.z.string().optional() })]).optional()
+  duration: import_zod6.z.number().optional(),
+  framespersecond: import_zod6.z.number().optional(),
+  resolution: import_zod6.z.string().optional(),
+  error: import_zod6.z.union([import_zod6.z.string(), import_zod6.z.object({ message: import_zod6.z.string().optional() })]).optional()
 });
-var SeedanceErrorMessageSchema = import_zod5.z.object({ message: import_zod5.z.string().optional() });
+var SeedanceErrorMessageSchema = import_zod6.z.object({ message: import_zod6.z.string().optional() });
 function seedanceUsage(ctx, req, duration) {
   const usage2 = {
     model: ctx.model.id,
@@ -3551,7 +3979,7 @@ function seedanceUsage(ctx, req, duration) {
   return usage2;
 }
 function seedanceErrorMessage(error, status) {
-  const asString = import_zod5.z.string().safeParse(error);
+  const asString = import_zod6.z.string().safeParse(error);
   if (asString.success) return asString.data;
   const asObject = SeedanceErrorMessageSchema.safeParse(error);
   if (asObject.success && asObject.data.message !== void 0) return asObject.data.message;
@@ -3700,7 +4128,7 @@ async function generateSeedanceVideo(req, ctx) {
 }
 
 // src/adapters/fal.ts
-var import_zod6 = require("zod");
+var import_zod7 = require("zod");
 var import_client = require("@fal-ai/client");
 var MUSE_T2I_ENDPOINT = "meta/muse-image/text-to-image";
 var MUSE_EDIT_ENDPOINT = "meta/muse-image/edit";
@@ -3708,7 +4136,7 @@ var KLING_O1_ENDPOINT = "fal-ai/kling-video/o1/video-to-video/reference";
 var FAL_QUEUE_HOST = "https://queue.fal.run";
 var PASSTHROUGH_POLL_MS = 2e3;
 var PASSTHROUGH_MAX_WAIT_MS = 18e4;
-var falSubscribePayloadSchema = import_zod6.z.object({ data: JsonValueSchema });
+var falSubscribePayloadSchema = import_zod7.z.object({ data: JsonValueSchema });
 function defaultCreateFalClient(opts) {
   const client2 = (0, import_client.createFalClient)(opts);
   return {
@@ -3758,7 +4186,7 @@ function createFalAdapter(deps = defaultDeps) {
   };
 }
 var falAdapter = createFalAdapter();
-var falDetailSchema = import_zod6.z.object({ detail: JsonValueSchema });
+var falDetailSchema = import_zod7.z.object({ detail: JsonValueSchema });
 function liftDetail(body) {
   const parsed = falDetailSchema.safeParse(body);
   const detail = parsed.success ? parsed.data.detail : void 0;
@@ -3767,11 +4195,11 @@ function liftDetail(body) {
 function falError(status, body, model) {
   return classifyHttpError(status, liftDetail(body), "fal", model);
 }
-var falSdkThrownSchema = import_zod6.z.object({
-  status: import_zod6.z.number().optional(),
-  statusCode: import_zod6.z.number().optional(),
+var falSdkThrownSchema = import_zod7.z.object({
+  status: import_zod7.z.number().optional(),
+  statusCode: import_zod7.z.number().optional(),
   body: JsonValueSchema.optional(),
-  message: import_zod6.z.string().optional()
+  message: import_zod7.z.string().optional()
 });
 function falSdkError(cause, model) {
   const parsed = falSdkThrownSchema.safeParse(cause);
@@ -3815,12 +4243,12 @@ async function gatewayFetch(cfg, fetchImpl, targetUrl, init) {
   if (init.body !== void 0) request.body = init.body;
   return fetchImpl(cfg.baseUrl, request);
 }
-var falQueueSubmitSchema = import_zod6.z.object({
-  request_id: import_zod6.z.string(),
-  status_url: import_zod6.z.string(),
-  response_url: import_zod6.z.string()
+var falQueueSubmitSchema = import_zod7.z.object({
+  request_id: import_zod7.z.string(),
+  status_url: import_zod7.z.string(),
+  response_url: import_zod7.z.string()
 });
-var falQueueStatusSchema = import_zod6.z.object({ status: import_zod6.z.string() });
+var falQueueStatusSchema = import_zod7.z.object({ status: import_zod7.z.string() });
 async function passthroughRequest(ctx, endpoint, input) {
   const cfg = gatewayConfig(ctx);
   const submitRes = await gatewayFetch(cfg, ctx.fetch, `${FAL_QUEUE_HOST}/${endpoint}`, {
@@ -3946,11 +4374,11 @@ async function decodeImage(ctx, url, contentType) {
   const mime = res.headers.get("content-type") ?? contentType ?? "image/png";
   return { bytes: new Uint8Array(await res.arrayBuffer()), mime };
 }
-var museImageResultSchema = import_zod6.z.object({
-  images: import_zod6.z.array(
-    import_zod6.z.object({
-      url: import_zod6.z.string().optional(),
-      content_type: import_zod6.z.string().nullable().optional()
+var museImageResultSchema = import_zod7.z.object({
+  images: import_zod7.z.array(
+    import_zod7.z.object({
+      url: import_zod7.z.string().optional(),
+      content_type: import_zod7.z.string().nullable().optional()
     })
   ).optional()
 });
@@ -4042,8 +4470,8 @@ function klingO1Input(req) {
   if (refs.length > 0) input.image_urls = refs;
   return input;
 }
-var falVideoResultSchema = import_zod6.z.object({
-  video: import_zod6.z.object({ url: import_zod6.z.string().optional() }).optional()
+var falVideoResultSchema = import_zod7.z.object({
+  video: import_zod7.z.object({ url: import_zod7.z.string().optional() }).optional()
 });
 function extractVideoUrl(result, endpoint, model) {
   const parsed = falVideoResultSchema.safeParse(result);
@@ -4233,11 +4661,11 @@ async function passthroughVideoJob(ctx, req, endpoint, input) {
 }
 
 // src/adapters/google-genai.ts
-var import_zod8 = require("zod");
+var import_zod9 = require("zod");
 var import_genai = require("@google/genai");
 
 // src/adapters/google-files.ts
-var import_zod7 = require("zod");
+var import_zod8 = require("zod");
 var GOOGLE_FILES_BASE = "https://generativelanguage.googleapis.com";
 var GOOGLE_FILES_POLL_INTERVAL_MS = 2e3;
 var GOOGLE_FILES_POLL_TIMEOUT_MS = 5 * 60 * 1e3;
@@ -4247,17 +4675,17 @@ var GENERIC_MEDIA_TYPES = /* @__PURE__ */ new Set([
   "binary/octet-stream",
   "application/binary"
 ]);
-var uploadedFileSchema = import_zod7.z.object({
-  file: import_zod7.z.object({
-    uri: import_zod7.z.string().optional(),
-    name: import_zod7.z.string().optional(),
-    state: import_zod7.z.string().optional(),
-    mimeType: import_zod7.z.string().optional()
+var uploadedFileSchema = import_zod8.z.object({
+  file: import_zod8.z.object({
+    uri: import_zod8.z.string().optional(),
+    name: import_zod8.z.string().optional(),
+    state: import_zod8.z.string().optional(),
+    mimeType: import_zod8.z.string().optional()
   }).optional()
 });
-var fileStateSchema = import_zod7.z.object({
-  state: import_zod7.z.string().optional(),
-  error: import_zod7.z.object({ message: import_zod7.z.string().optional() }).optional()
+var fileStateSchema = import_zod8.z.object({
+  state: import_zod8.z.string().optional(),
+  error: import_zod8.z.object({ message: import_zod8.z.string().optional() }).optional()
 });
 function resolveMime(declared, fallback) {
   const clean = declared?.split(";")[0]?.trim().toLowerCase();
@@ -4470,7 +4898,7 @@ var OMNI_POLL_INTERVAL_MS = 1e4;
 var RESULT_TIMEOUT_MS2 = 15 * 60 * 1e3;
 var OMNI_INLINE_LIMIT_BYTES = 4 * 1024 * 1024;
 var MEDIA_PART_INLINE_LIMIT_BYTES = 20 * 1024 * 1024;
-var errorTextSchema = import_zod8.z.string();
+var errorTextSchema = import_zod9.z.string();
 function createGoogleGenaiAdapter(deps = defaultDeps2) {
   const { createGenAIClient } = deps;
   return {
@@ -4623,6 +5051,7 @@ async function generateVeoVideo(req, ctx, createGenAIClient) {
   const config = { durationSeconds: duration, personGeneration };
   if (req.aspectRatio !== void 0) config.aspectRatio = req.aspectRatio;
   if (req.resolution !== void 0) config.resolution = req.resolution;
+  if (req.seed !== void 0) config.seed = req.seed;
   if (lastFrame !== void 0) config.lastFrame = lastFrame;
   if (referenceImages !== void 0) config.referenceImages = referenceImages;
   const requestBody = {
@@ -5028,15 +5457,15 @@ async function prepareGoogleMediaPart(ref, mediaType, ctx) {
 // src/adapters/google-image.ts
 var import_google2 = require("@ai-sdk/google");
 var import_ai3 = require("ai");
-var import_zod9 = require("zod");
+var import_zod10 = require("zod");
 var GEMINI_IMAGE_TIMEOUT_MS = 6e5;
 var defaultGoogleImageDeps = {
   createGoogleClient: (opts) => (0, import_google2.createGoogleGenerativeAI)(opts),
   runTextGeneration: (opts) => (0, import_ai3.generateText)(opts)
 };
-var causeChainNodeSchema = import_zod9.z.object({
-  message: import_zod9.z.string().optional(),
-  cause: import_zod9.z.unknown().optional()
+var causeChainNodeSchema = import_zod10.z.object({
+  message: import_zod10.z.string().optional(),
+  cause: import_zod10.z.unknown().optional()
 });
 function extractBlockReason(cause) {
   let current = cause;
@@ -5157,7 +5586,7 @@ function createGoogleImageAdapter(deps = defaultGoogleImageDeps) {
 var googleImageAdapter = createGoogleImageAdapter();
 
 // src/adapters/higgsfield.ts
-var import_zod10 = require("zod");
+var import_zod11 = require("zod");
 
 // src/adapters/higgsfield-motions.ts
 var MOTION_MAP = {
@@ -5345,14 +5774,14 @@ function videoUsage3(ctx, req, duration) {
   if (req.durationSeconds !== void 0) event.durationSeconds = req.durationSeconds;
   return event;
 }
-var klingCreateSchema = import_zod10.z.object({ status_url: import_zod10.z.string() });
-var klingStatusSchema = import_zod10.z.object({
-  status: import_zod10.z.string().optional(),
-  video: import_zod10.z.object({ url: import_zod10.z.string().optional() }).optional(),
+var klingCreateSchema = import_zod11.z.object({ status_url: import_zod11.z.string() });
+var klingStatusSchema = import_zod11.z.object({
+  status: import_zod11.z.string().optional(),
+  video: import_zod11.z.object({ url: import_zod11.z.string().optional() }).optional(),
   error: JsonValueSchema.optional()
 });
-var errorMessageSchema = import_zod10.z.object({ message: import_zod10.z.string().optional() });
-var textValueSchema = import_zod10.z.string();
+var errorMessageSchema = import_zod11.z.object({ message: import_zod11.z.string().optional() });
+var textValueSchema = import_zod11.z.string();
 function klingErrorDetail(error) {
   if (error === void 0) return "unknown_error";
   const asText = textValueSchema.safeParse(error);
@@ -5486,8 +5915,8 @@ async function generateKlingVideo(req, ctx) {
     }
   };
 }
-var dopMotionOptionsSchema = import_zod10.z.object({
-  modelkit: import_zod10.z.object({ motion: import_zod10.z.string().optional() }).optional()
+var dopMotionOptionsSchema = import_zod11.z.object({
+  modelkit: import_zod11.z.object({ motion: import_zod11.z.string().optional() }).optional()
 });
 function dopMotionId(ctx) {
   const parsed = dopMotionOptionsSchema.safeParse(ctx.model.providerOptions);
@@ -5503,7 +5932,7 @@ function dopMotionId(ctx) {
     });
   return id;
 }
-var jsonRecordSchema = import_zod10.z.record(import_zod10.z.string(), JsonValueSchema);
+var jsonRecordSchema = import_zod11.z.record(import_zod11.z.string(), JsonValueSchema);
 var DOP_URL_KEYS = ["url", "video_url", "output_url", "result_url", "download_url"];
 var DOP_NESTED_KEYS = ["video", "result", "results"];
 function dopUrl(body) {
@@ -5531,8 +5960,8 @@ function dopUrl(body) {
   }
   return void 0;
 }
-var dopCreateSchema = import_zod10.z.object({ id: import_zod10.z.string() });
-var dopStatusSchema = import_zod10.z.object({ status: import_zod10.z.string().optional() });
+var dopCreateSchema = import_zod11.z.object({ id: import_zod11.z.string() });
+var dopStatusSchema = import_zod11.z.object({ status: import_zod11.z.string().optional() });
 async function generateDopVideo(req, ctx) {
   const firstFrame = req.firstFrame ? refToUrl(req.firstFrame) : void 0;
   if (!firstFrame) {
@@ -5652,7 +6081,7 @@ var higgsfieldAdapter = {
 
 // src/adapters/openai-image.ts
 var import_openai2 = __toESM(require("openai"), 1);
-var import_zod11 = require("zod");
+var import_zod12 = require("zod");
 var MAX_EDIT_REFERENCES = 16;
 function aspectRatioToSize(ratio, tier) {
   const TIER_LONG_EDGE = {
@@ -5735,9 +6164,9 @@ function toProviderError2(cause, ctx) {
     ctx.model.id
   );
 }
-var openaiUsageSchema = import_zod11.z.object({
-  input_tokens: import_zod11.z.number().optional(),
-  output_tokens: import_zod11.z.number().optional()
+var openaiUsageSchema = import_zod12.z.object({
+  input_tokens: import_zod12.z.number().optional(),
+  output_tokens: import_zod12.z.number().optional()
 });
 var openaiImageAdapter = {
   id: "openai-image",
@@ -5766,6 +6195,19 @@ var openaiImageAdapter = {
     const quality = req.quality ?? (isEdit ? "medium" : "auto");
     const sdkQuality = quality;
     const count = req.count !== void 0 && req.count > 1 ? { n: req.count } : {};
+    let outputFormat = req.outputFormat;
+    if (outputFormat === "webp") {
+      ctx.warnings.push({
+        code: "option_ignored",
+        field: "outputFormat",
+        from: "webp",
+        to: "png",
+        message: `${ctx.model.id} returns PNG for output_format webp; using png`
+      });
+      outputFormat = "png";
+    }
+    const format = outputFormat !== void 0 ? { output_format: outputFormat } : {};
+    const mime = outputFormat === "jpeg" ? "image/jpeg" : "image/png";
     const retryOptions = {};
     if (ctx.signal !== void 0) retryOptions.signal = ctx.signal;
     const response = await withRetry(async () => {
@@ -5778,7 +6220,8 @@ var openaiImageAdapter = {
                 prompt: req.prompt,
                 size,
                 quality: sdkQuality,
-                ...count
+                ...count,
+                ...format
               },
               { signal: ctx.signal }
             );
@@ -5788,20 +6231,21 @@ var openaiImageAdapter = {
               model: ctx.model.providerModelId,
               prompt: req.prompt,
               quality: sdkQuality,
-              ...count
+              ...count,
+              ...format
             },
             { signal: ctx.signal }
           );
         }
         const files = await Promise.all(
           refs.slice(0, MAX_EDIT_REFERENCES).map(async (ref, i) => {
-            const { bytes, mime } = await mediaRefToBytes(ref, ctx.fetch, {
+            const { bytes, mime: mime2 } = await mediaRefToBytes(ref, ctx.fetch, {
               signal: ctx.signal,
               provider: "openai-image",
               model: ctx.model.id
             });
-            const ext = mime.includes("jpeg") ? "jpg" : mime.includes("webp") ? "webp" : "png";
-            return new File([bytes], `ref-${i}.${ext}`, { type: mime });
+            const ext = mime2.includes("jpeg") ? "jpg" : mime2.includes("webp") ? "webp" : "png";
+            return new File([bytes], `ref-${i}.${ext}`, { type: mime2 });
           })
         );
         const single = files.length === 1 ? files[0] : void 0;
@@ -5814,7 +6258,8 @@ var openaiImageAdapter = {
               prompt: req.prompt,
               size,
               quality: sdkQuality,
-              ...count
+              ...count,
+              ...format
             },
             { signal: ctx.signal }
           );
@@ -5825,7 +6270,8 @@ var openaiImageAdapter = {
             image: imageInput,
             prompt: req.prompt,
             quality: sdkQuality,
-            ...count
+            ...count,
+            ...format
           },
           { signal: ctx.signal }
         );
@@ -5834,7 +6280,7 @@ var openaiImageAdapter = {
       }
     }, retryOptions);
     const images = (response.data ?? []).flatMap(
-      (item) => item.b64_json ? [{ bytes: base64ToBytes(item.b64_json), mime: "image/png" }] : []
+      (item) => item.b64_json ? [{ bytes: base64ToBytes(item.b64_json), mime }] : []
     );
     if (images.length === 0)
       throw classifyHttpError(
@@ -6127,7 +6573,7 @@ var prodiaAdapter = {
 
 // src/adapters/replicate.ts
 var import_replicate = __toESM(require("replicate"), 1);
-var import_zod12 = require("zod");
+var import_zod13 = require("zod");
 var POLL_INTERVAL_MS = 1e3;
 var POLL_TIMEOUT_MS = 15 * 6e4;
 var defaultReplicateDeps = {
@@ -6163,8 +6609,8 @@ function route(providerModelId) {
   if (!providerModelId.includes("/")) return { version: providerModelId };
   return { model: providerModelId };
 }
-var replicateResponseStatusSchema = import_zod12.z.object({
-  response: import_zod12.z.object({ status: import_zod12.z.number() }).partial()
+var replicateResponseStatusSchema = import_zod13.z.object({
+  response: import_zod13.z.object({ status: import_zod13.z.number() }).partial()
 });
 function replicateError(cause, ctx) {
   if (isModelKitError(cause)) return cause;
@@ -6191,7 +6637,7 @@ function isUrlFn(value) {
 function extractOutputUrl(output) {
   const root = Array.isArray(output) ? output[0] : output;
   if (root === void 0) throw noOutput();
-  const asString = import_zod12.z.string().safeParse(root);
+  const asString = import_zod13.z.string().safeParse(root);
   if (asString.success && asString.data) return asString.data;
   if (root instanceof URL) return root.href;
   if (isObjectOutput(root)) {
@@ -6200,15 +6646,15 @@ function extractOutputUrl(output) {
       if (urlValue !== void 0 && isUrlFn(urlValue)) {
         const called = urlValue();
         if (called instanceof URL) return called.href;
-        const calledString = import_zod12.z.string().safeParse(called);
+        const calledString = import_zod13.z.string().safeParse(called);
         if (calledString.success && calledString.data) return calledString.data;
       } else {
-        const direct = import_zod12.z.string().safeParse(urlValue);
+        const direct = import_zod13.z.string().safeParse(urlValue);
         if (direct.success && direct.data) return direct.data;
       }
     }
     if ("default" in root) {
-      const fallback = import_zod12.z.string().safeParse(root.default);
+      const fallback = import_zod13.z.string().safeParse(root.default);
       if (fallback.success && fallback.data) return fallback.data;
     }
   }
@@ -6269,7 +6715,7 @@ async function runPrediction(ctx, input, deps) {
     }
     return void 0;
   }, pollOpts);
-  const predictTime = import_zod12.z.number().safeParse(done.metrics?.predict_time);
+  const predictTime = import_zod13.z.number().safeParse(done.metrics?.predict_time);
   if (done.output === void 0) throw noOutput();
   return {
     url: extractOutputUrl(done.output),
@@ -6612,7 +7058,7 @@ async function generateReplicateVideo(req, ctx, deps) {
       throw replicateError(cause, ctx);
     }
     if (current.status === "succeeded") {
-      const predictTime = import_zod12.z.number().safeParse(current.metrics?.predict_time);
+      const predictTime = import_zod13.z.number().safeParse(current.metrics?.predict_time);
       if (current.output === void 0) throw noOutput();
       return {
         url: extractOutputUrl(current.output),
@@ -6744,7 +7190,7 @@ async function generateReplicateAudio(req, ctx, deps) {
 // src/adapters/xai-video.ts
 var import_ai4 = require("ai");
 var import_xai2 = require("@ai-sdk/xai");
-var import_zod13 = require("zod");
+var import_zod14 = require("zod");
 var POLL_INTERVAL_MS2 = 1e4;
 var POLL_TIMEOUT_MS2 = 15 * 6e4;
 var defaultXaiDeps = {
@@ -6757,8 +7203,8 @@ function createXaiVideoAdapter(deps = defaultXaiDeps) {
   };
 }
 var xaiVideoAdapter = createXaiVideoAdapter();
-var xaiResponseStatusSchema = import_zod13.z.object({
-  response: import_zod13.z.object({ status: import_zod13.z.number() }).partial()
+var xaiResponseStatusSchema = import_zod14.z.object({
+  response: import_zod14.z.object({ status: import_zod14.z.number() }).partial()
 });
 function xaiError(cause, ctx) {
   const info = describeThrown(cause);
@@ -6766,12 +7212,12 @@ function xaiError(cause, ctx) {
   const status = info.status ?? (nested.success ? nested.data.response?.status : void 0);
   return classifyThrown("xai-video", cause, ctx.model.id, { status, body: info.body });
 }
-var xaiMetaSchema = import_zod13.z.object({
+var xaiMetaSchema = import_zod14.z.object({
   videoUrl: JsonValueSchema.optional(),
   costInUsdTicks: JsonValueSchema.optional(),
   duration: JsonValueSchema.optional()
 });
-var xaiProviderMetadataSchema = import_zod13.z.object({ xai: xaiMetaSchema });
+var xaiProviderMetadataSchema = import_zod14.z.object({ xai: xaiMetaSchema });
 function metaOf(result) {
   const parsed = xaiProviderMetadataSchema.partial().safeParse(result.providerMetadata);
   if (!parsed.success) return {};
@@ -6878,7 +7324,7 @@ async function mapResult(ctx, req, result) {
     };
   }
   const meta = metaOf(result);
-  const videoUrl = import_zod13.z.string().safeParse(meta.videoUrl);
+  const videoUrl = import_zod14.z.string().safeParse(meta.videoUrl);
   if (videoUrl.success && videoUrl.data) {
     const res = await ctx.fetch(videoUrl.data);
     if (!res.ok) {
@@ -6901,7 +7347,7 @@ async function mapResult(ctx, req, result) {
   });
 }
 function usage(ctx, req, meta) {
-  const costTicks = import_zod13.z.number().safeParse(meta.costInUsdTicks);
+  const costTicks = import_zod14.z.number().safeParse(meta.costInUsdTicks);
   const cost = costTicks.success ? costTicks.data / 1e10 : void 0;
   const event = {
     model: ctx.model.id,
@@ -6950,8 +7396,11 @@ var languageModel = (modelId, call) => createDefaultModelKit().languageModel(mod
 var describe = (modelId) => createDefaultModelKit().describe(modelId);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ADAPTER_IDS,
   ADAPTER_KEYS,
   Catalog,
+  CatalogModelSchema,
+  CatalogSchema,
   DEFAULT_ADAPTERS,
   JsonObjectSchema,
   JsonValueSchema,
@@ -6967,6 +7416,7 @@ var describe = (modelId) => createDefaultModelKit().describe(modelId);
   describeThrown,
   experimental_generateImage,
   falAdapter,
+  fileCatalogCache,
   generateAudio,
   generateImage,
   generateObject,
@@ -6978,15 +7428,19 @@ var describe = (modelId) => createDefaultModelKit().describe(modelId);
   isModelKitError,
   keysFromEnv,
   languageModel,
+  liveCatalog,
+  liveState,
   mergeTextProviderOptions,
   nearestAspectRatio,
   openaiImageAdapter,
   passthroughTextModel,
   pollUntil,
   prepareMediaPart,
+  primeCatalog,
   prodiaAdapter,
   readErrorBody,
   replicateAdapter,
+  resetLiveCatalog,
   resolveAudioOptions,
   resolveImageOptions,
   resolveKeys,