@shop-os/modelkit 0.5.0 → 0.6.1

package/dist/index.js

@@ -140,18 +140,18 @@ function normalizeExposure(value) {
     if (value.every(
       (entry) => SURFACES.includes(entry)
     )) {
-      const present = new Set(value);
-      return SURFACES.filter((surface) => present.has(surface));
+      const present2 = new Set(value);
+      return SURFACES.filter((surface) => present2.has(surface));
     }
     return value;
   }
   return value;
 }
-function isListedOn(row, surface) {
-  return row.lifecycle === "active" && row.exposure.includes(surface);
+function isListedOn(row2, surface) {
+  return row2.lifecycle === "active" && row2.exposure.includes(surface);
 }
-function isListed(row) {
-  return row.lifecycle === "active" && row.exposure.length > 0;
+function isListed(row2) {
+  return row2.lifecycle === "active" && row2.exposure.length > 0;
 }
 
 // src/catalog/image-fal.ts
@@ -3553,6 +3553,197 @@ var MEDIA_NODE_MODELS = [
   SAM_3_IMAGE
 ];
 
+// src/catalog/model3d.ts
+var REQUEST_USAGE = { unit: "requests" };
+function row(id, label, spec, display) {
+  return {
+    id,
+    aliases: [],
+    label,
+    type: "model3d",
+    adapter: "fal",
+    // The single-image endpoint; the adapter picks the endpoint a request needs.
+    providerModelId: spec.endpoints.image ?? id,
+    lifecycle: "active",
+    exposure: ["space_builder"],
+    constraints: { supports: [], model3d: spec },
+    defaults: {},
+    usage: REQUEST_USAGE,
+    pricingKind: "flat",
+    display
+  };
+}
+var MODEL3D_MODELS = [
+  row(
+    "trellis-2",
+    "Trellis 2",
+    {
+      family: "trellis",
+      endpoints: { image: "fal-ai/trellis-2" },
+      text: false,
+      imageRequired: true,
+      views: "none",
+      maxImages: 1,
+      texture: [],
+      pbr: false,
+      textureRef: false,
+      seed: true,
+      resolutions: { label: "Resolution", options: ["512", "1024", "1536"], default: "1024" }
+    },
+    {
+      provider: "microsoft",
+      description: "One photo to a detailed textured model. Fast and the best value.",
+      sortOrder: 70
+    }
+  ),
+  row(
+    "hunyuan3d-3.1-pro",
+    "Hunyuan3D 3.1 Pro",
+    {
+      family: "hunyuan",
+      endpoints: {
+        text: "fal-ai/hunyuan-3d/v3.1/pro/text-to-3d",
+        image: "fal-ai/hunyuan-3d/v3.1/pro/image-to-3d"
+      },
+      text: true,
+      imageRequired: false,
+      views: "named",
+      maxImages: 4,
+      texture: ["none", "standard"],
+      pbr: true,
+      textureRef: false,
+      seed: false
+    },
+    {
+      provider: "tencent",
+      description: "Photo-faithful models from a prompt, a photo, or a photo with back and side views.",
+      sortOrder: 60
+    }
+  ),
+  row(
+    "tripo-h3.1",
+    "Tripo H3.1",
+    {
+      family: "tripo",
+      endpoints: {
+        text: "tripo3d/h3.1/text-to-3d",
+        image: "tripo3d/h3.1/image-to-3d",
+        multiImage: "tripo3d/h3.1/multiview-to-3d"
+      },
+      text: true,
+      imageRequired: false,
+      views: "ordered",
+      maxImages: 4,
+      texture: ["none", "standard", "detailed"],
+      pbr: true,
+      textureRef: false,
+      seed: true
+    },
+    {
+      provider: "tripo",
+      description: "Clean, game-ready models from a prompt, a photo or four views.",
+      sortOrder: 50
+    }
+  ),
+  row(
+    "rodin-gen-2.5",
+    "Rodin Gen-2.5",
+    {
+      family: "rodin",
+      endpoints: {
+        text: "fal-ai/hyper3d/rodin/v2.5/text-to-3d",
+        image: "fal-ai/hyper3d/rodin/v2.5"
+      },
+      text: true,
+      imageRequired: false,
+      views: "unordered",
+      maxImages: 5,
+      texture: [],
+      pbr: false,
+      textureRef: false,
+      seed: true,
+      seedMax: 65535
+    },
+    {
+      provider: "hyper3d",
+      description: "Detailed PBR models from a prompt or up to five photos.",
+      sortOrder: 40
+    }
+  ),
+  row(
+    "meshy-7.1",
+    "Meshy 7.1",
+    {
+      family: "meshy",
+      endpoints: {
+        text: "meshy/v7.1/text-to-3d",
+        image: "meshy/v7.1/image-to-3d",
+        multiImage: "meshy/v7.1/multi-image-to-3d"
+      },
+      text: true,
+      imageRequired: false,
+      views: "unordered",
+      maxImages: 4,
+      texture: ["none", "standard"],
+      pbr: true,
+      textureRef: true,
+      seed: true
+    },
+    {
+      provider: "meshy",
+      description: "Models from a prompt or photos, with a texture prompt or texture image to restyle.",
+      sortOrder: 30
+    }
+  ),
+  row(
+    "hi3d-3.0",
+    "Hi3D 3.0",
+    {
+      family: "hi3d",
+      endpoints: {
+        image: "hitem3d/hi3d/v3.0/image-to-3d",
+        multiImage: "hitem3d/hi3d/v3.0/multi-view-to-3d"
+      },
+      text: false,
+      imageRequired: true,
+      views: "named",
+      maxImages: 4,
+      texture: ["none", "standard"],
+      pbr: true,
+      textureRef: false,
+      seed: false,
+      resolutions: { label: "Quality", options: ["quality", "master"], default: "quality" }
+    },
+    {
+      provider: "hitem3d",
+      description: "Highest-fidelity product models from a photo or four views. Slowest.",
+      sortOrder: 20
+    }
+  ),
+  row(
+    "sam-3d-objects",
+    "SAM 3D Objects",
+    {
+      family: "sam",
+      endpoints: { image: "fal-ai/sam-3/3d-objects" },
+      text: true,
+      imageRequired: true,
+      promptRequired: true,
+      views: "none",
+      maxImages: 1,
+      texture: [],
+      pbr: false,
+      textureRef: false,
+      seed: true
+    },
+    {
+      provider: "meta",
+      description: "Lifts one named object out of a real photo into a 3D model.",
+      sortOrder: 10
+    }
+  )
+];
+
 // src/catalog/other.ts
 var GOOGLE_LOGO2 = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png";
 var ELEVENLABS_LOGO2 = "https://cdn.jsdelivr.net/npm/@lobehub/icons-static-png@1.97.0/light/elevenlabs.png";
@@ -5871,6 +6062,7 @@ var MODELS = [
   ...IMAGE_MODELS,
   ...VIDEO_MODELS,
   ...VIDEO_TOOL_MODELS,
+  ...MODEL3D_MODELS,
   ...OTHER_MODELS,
   ...MEDIA_NODE_MODELS
 ];
@@ -5879,11 +6071,11 @@ var MODELS = [
 import { z as z3 } from "zod";
 
 // src/resolve-provider-rules.ts
-function ruleRefusal(row, message, code) {
+function ruleRefusal(row2, message, code) {
   return new ModelKitError({
     code,
-    message: `${row.label}: ${message}`,
-    model: row.id,
+    message: `${row2.label}: ${message}`,
+    model: row2.id,
     retryable: false
   });
 }
@@ -6042,27 +6234,27 @@ function collisionIssues(rows) {
   const issues = [];
   const seenIds = /* @__PURE__ */ new Map();
   const seenAliases = /* @__PURE__ */ new Map();
-  rows.forEach((row, index) => {
-    if (seenIds.has(row.id)) {
+  rows.forEach((row2, index) => {
+    if (seenIds.has(row2.id)) {
       issues.push({
         index,
         path: ["id"],
-        message: `Duplicate model id "${row.id}"`
+        message: `Duplicate model id "${row2.id}"`
       });
     } else {
-      const aliasOwner = seenAliases.get(row.id);
+      const aliasOwner = seenAliases.get(row2.id);
       if (aliasOwner !== void 0) {
         issues.push({
           index: aliasOwner.index,
           path: ["aliases", aliasOwner.aliasIndex],
-          message: `Alias "${row.id}" collides with a model id`
+          message: `Alias "${row2.id}" collides with a model id`
         });
       }
-      seenIds.set(row.id, index);
+      seenIds.set(row2.id, index);
     }
     const local = /* @__PURE__ */ new Set();
-    for (const [aliasIndex, alias] of row.aliases.entries()) {
-      if (alias === row.id || seenIds.has(alias)) {
+    for (const [aliasIndex, alias] of row2.aliases.entries()) {
+      if (alias === row2.id || seenIds.has(alias)) {
         issues.push({
           index,
           path: ["aliases", aliasIndex],
@@ -6104,8 +6296,8 @@ var DEFAULT_CONVENTIONS = { referenceSyntax: "numbered" };
 var DefaultsReadView = z.looseObject({
   generateAudio: z.boolean().optional().catch(void 0)
 });
-function promptConventions(row) {
-  const view = ConstraintsReadView.safeParse(row.constraints);
+function promptConventions(row2) {
+  const view = ConstraintsReadView.safeParse(row2.constraints);
   const prompt = view.success ? view.data.prompt : void 0;
   if (prompt === void 0) return { ...DEFAULT_CONVENTIONS };
   const result = { referenceSyntax: prompt.referenceSyntax };
@@ -6116,22 +6308,111 @@ var RawConventionsView = z.looseObject({
   audio: z.unknown().optional(),
   prompt: z.unknown().optional()
 });
-function normaliseConventions(row) {
-  const view = RawConventionsView.safeParse(row.constraints);
-  if (!view.success) return { row, invalidKeys: [] };
+function normaliseConventions(row2) {
+  const view = RawConventionsView.safeParse(row2.constraints);
+  if (!view.success) return { row: row2, invalidKeys: [] };
   const { audio, prompt } = view.data;
   const badAudio = audio !== void 0 && !AudioOutputSchema.safeParse(audio).success;
   const badPrompt = prompt !== void 0 && !PromptConventionsSchema.safeParse(prompt).success;
-  if (!badAudio && !badPrompt) return { row, invalidKeys: [] };
+  if (!badAudio && !badPrompt) return { row: row2, invalidKeys: [] };
   const invalidKeys = [];
   if (badAudio) invalidKeys.push("constraints.audio");
   if (badPrompt) invalidKeys.push("constraints.prompt");
-  const entries = Object.entries(row.constraints).flatMap(([key, value]) => {
+  const entries = Object.entries(row2.constraints).flatMap(([key, value]) => {
     if (key === "audio" && badAudio) return [];
-    if (key === "prompt" && badPrompt) return [[key, promptConventions(row)]];
+    if (key === "prompt" && badPrompt) return [[key, promptConventions(row2)]];
     return [[key, value]];
   });
-  return { row: { ...row, constraints: Object.fromEntries(entries) }, invalidKeys };
+  return { row: { ...row2, constraints: Object.fromEntries(entries) }, invalidKeys };
+}
+
+// src/catalog/model3d-spec.ts
+function model3dConstraints(row2) {
+  if (row2.type !== "model3d") return void 0;
+  return row2.constraints.model3d;
+}
+var MODEL3D_IMAGE_SLOTS = {
+  none: ["image"],
+  named: ["image", "back", "left", "right"],
+  ordered: ["image", "left", "back", "right"],
+  unordered: ["image", "back", "left", "right", "top"]
+};
+function model3dInputRefusal(spec, wired) {
+  const top = spec.views === "unordered" && wired.top === true;
+  const anyView = spec.views !== "none" && (wired.back || wired.left || wired.right || top);
+  if (anyView && !wired.image) return "model3d_views_need_image";
+  if (spec.imageRequired && !wired.image) return "model3d_needs_image";
+  if (spec.promptRequired && !wired.prompt) return "model3d_needs_prompt";
+  if (!wired.image && !(spec.text && wired.prompt)) return "model3d_needs_input";
+  if (spec.views === "ordered") {
+    if ((wired.back || wired.right) && !wired.left) return "model3d_views_out_of_order";
+    if (wired.right && !wired.back) return "model3d_views_out_of_order";
+  }
+  return null;
+}
+function model3dSeedFits(spec, seed) {
+  return Number.isSafeInteger(seed) && seed >= 0 && seed <= (spec.seedMax ?? Number.MAX_SAFE_INTEGER);
+}
+function model3dTexture(spec, requested) {
+  if (requested !== void 0 && spec.texture.includes(requested)) return requested;
+  return spec.texture.includes("standard") ? "standard" : spec.texture[0] ?? "standard";
+}
+function model3dResolution(spec, requested) {
+  const res = spec.resolutions;
+  if (res === void 0) return void 0;
+  return requested !== void 0 && res.options.includes(requested) ? requested : res.default;
+}
+function model3dPricingSku(row2, options, inputs) {
+  const spec = model3dConstraints(row2);
+  if (spec === void 0) throw new Error(`${row2.id} is not a 3D model`);
+  const texture = model3dTexture(spec, options.texture);
+  const textured = spec.texture.length > 0 && texture !== "none";
+  const pbr = spec.pbr && textured && options.pbr === true;
+  const resolution = model3dResolution(spec, options.resolution);
+  switch (spec.family) {
+    case "meshy":
+      return `${row2.id}__${textured ? "textured" : "untextured"}`;
+    case "tripo":
+      return `${row2.id}__${inputs.image ? "image" : "text"}__${texture}`;
+    case "hunyuan":
+      return `${row2.id}${pbr ? "__pbr" : ""}${inputs.views ? "__views" : ""}`;
+    case "trellis":
+      return `${row2.id}__${resolution}`;
+    case "hi3d":
+      return `${row2.id}__${resolution}__${textured ? pbr ? "texture-pbr" : "texture" : "geometry"}`;
+    case "rodin":
+    case "sam":
+      return row2.id;
+  }
+}
+function model3dSkus(row2) {
+  const spec = model3dConstraints(row2);
+  if (spec === void 0) return [];
+  const textures = spec.texture.length > 0 ? spec.texture : [void 0];
+  const pbrs = spec.pbr ? [false, true] : [false];
+  const resolutions = spec.resolutions?.options ?? [void 0];
+  const images = spec.text && !spec.imageRequired ? [true, false] : [true];
+  const views = spec.views === "none" ? [false] : [false, true];
+  const skus = /* @__PURE__ */ new Set();
+  for (const texture of textures)
+    for (const pbr of pbrs)
+      for (const resolution of resolutions)
+        for (const image of images)
+          for (const view of views) {
+            if (view && !image) continue;
+            skus.add(
+              model3dPricingSku(
+                row2,
+                {
+                  ...texture !== void 0 && { texture },
+                  pbr,
+                  ...resolution !== void 0 && { resolution }
+                },
+                { image, views: view }
+              )
+            );
+          }
+  return [...skus].sort();
 }
 
 // src/catalog/input-spec.ts
@@ -6282,7 +6563,7 @@ function isInputSpecKey(key) {
 function isArrayInputSpecKey(key) {
   return ARRAY_KEY_SET.has(key);
 }
-function validateInputSpec(raw, row) {
+function validateInputSpec(raw, row2) {
   const parsed = InputSpecSchema.safeParse(raw);
   if (!parsed.success) {
     return {
@@ -6294,7 +6575,7 @@ function validateInputSpec(raw, row) {
     };
   }
   const spec = parsed.data;
-  const supportedTypes = TYPES_BY_ADAPTER.get(row.adapter);
+  const supportedTypes = TYPES_BY_ADAPTER.get(row2.adapter);
   if (supportedTypes === void 0) {
     return {
       ok: false,
@@ -6307,18 +6588,18 @@ function validateInputSpec(raw, row) {
     };
   }
   const issues = [];
-  const allowed = ALLOWED_KEYS_BY_TYPE.get(row.type);
-  if (allowed === void 0 || !supportedTypes.includes(row.type)) {
+  const allowed = ALLOWED_KEYS_BY_TYPE.get(row2.type);
+  if (allowed === void 0 || !supportedTypes.includes(row2.type)) {
     issues.push({
       path: [],
-      message: row.adapter === "fal" ? `inputSpec on fal rows is only supported for image rows, not "${row.type}"` : `inputSpec is not supported for "${row.type}" rows`
+      message: row2.adapter === "fal" ? `inputSpec on fal rows is only supported for image rows, not "${row2.type}"` : `inputSpec is not supported for "${row2.type}" rows`
     });
   } else {
     for (const key of Object.keys(spec.fields)) {
       if (!allowed.has(key)) {
         issues.push({
           path: ["fields", key],
-          message: `inputSpec.fields "${key}" is not supported for ${row.type} rows`
+          message: `inputSpec.fields "${key}" is not supported for ${row2.type} rows`
         });
       }
     }
@@ -6326,13 +6607,13 @@ function validateInputSpec(raw, row) {
       if (!allowed.has(key)) {
         issues.push({
           path: ["values", key],
-          message: `inputSpec.values "${key}" is not supported for ${row.type} rows`
+          message: `inputSpec.values "${key}" is not supported for ${row2.type} rows`
         });
       }
     }
   }
   if (spec.editEndpoint !== void 0) {
-    if (row.adapter !== "fal") {
+    if (row2.adapter !== "fal") {
       issues.push({
         path: ["editEndpoint"],
         message: "inputSpec.editEndpoint is only supported on fal rows"
@@ -6376,7 +6657,7 @@ function validateInputSpec(raw, row) {
       if (allowed !== void 0 && !allowed.has(key)) {
         issues.push({
           path: ["arrays", name],
-          message: `inputSpec.arrays "${key}" is not supported for ${row.type} rows`
+          message: `inputSpec.arrays "${key}" is not supported for ${row2.type} rows`
         });
       }
       if (key in spec.fields) {
@@ -6396,7 +6677,7 @@ function validateInputSpec(raw, row) {
     }
   }
   if (spec.dimensions !== void 0) {
-    if (row.type !== "image") {
+    if (row2.type !== "image") {
       issues.push({
         path: ["dimensions"],
         message: "inputSpec.dimensions is only supported on image rows"
@@ -6418,7 +6699,7 @@ function validateInputSpec(raw, row) {
       });
     }
   }
-  const supports = row.constraints.supports ?? [];
+  const supports = row2.constraints.supports ?? [];
   for (const key of INPUT_SPEC_SUPPORTS_KEYS) {
     if (supports.includes(key)) continue;
     if (key in spec.fields) {
@@ -6463,8 +6744,8 @@ function listIssues(name, values, fallback, defaultKey) {
   }
   return issues;
 }
-function optionListIssues(row) {
-  const { constraints, defaults } = row;
+function optionListIssues(row2) {
+  const { constraints, defaults } = row2;
   const issues = [
     ...listIssues(
       "voices",
@@ -6522,7 +6803,8 @@ var ModelTypeSchema = z3.enum([
   "voice-change",
   "dubbing",
   "lipsync",
-  "transcription"
+  "transcription",
+  "model3d"
 ]);
 var LifecycleSchema = z3.enum(["active", "deprecated", "retired"]);
 var SurfaceSchema = z3.enum(["cowork", "space_builder"]);
@@ -6586,7 +6868,8 @@ var UsageUnitSchema = z3.enum([
   "images",
   "seconds",
   "reported_cost_usd",
-  "compute_seconds"
+  "compute_seconds",
+  "requests"
 ]);
 var PricingKindSchema = z3.enum(["token", "image_size", "video_per_second", "flat"]);
 var ProviderOptionValueSchema = z3.lazy(
@@ -6640,6 +6923,156 @@ var LanguageOptionSchema = z3.looseObject({
   code: z3.string().min(1),
   name: z3.string().min(1)
 });
+var MODEL3D_FAMILY_RULES = {
+  trellis: {
+    textPath: false,
+    views: ["none"],
+    multiImage: false,
+    texture: null,
+    pbr: false,
+    seed: true,
+    textureRef: false,
+    resolutions: "integer"
+  },
+  hunyuan: {
+    textPath: true,
+    views: ["none", "named"],
+    multiImage: false,
+    texture: ["none", "standard"],
+    pbr: true,
+    seed: false,
+    textureRef: false,
+    resolutions: null
+  },
+  tripo: {
+    textPath: true,
+    views: ["none", "ordered"],
+    multiImage: true,
+    texture: ["none", "standard", "detailed"],
+    pbr: true,
+    seed: true,
+    textureRef: false,
+    resolutions: null
+  },
+  rodin: {
+    textPath: true,
+    views: ["none", "unordered"],
+    multiImage: false,
+    texture: null,
+    pbr: false,
+    seed: true,
+    textureRef: false,
+    resolutions: null
+  },
+  meshy: {
+    textPath: true,
+    views: ["none", "unordered"],
+    multiImage: true,
+    texture: ["none", "standard"],
+    pbr: true,
+    seed: true,
+    textureRef: true,
+    resolutions: null
+  },
+  hi3d: {
+    textPath: false,
+    views: ["none", "named"],
+    multiImage: true,
+    texture: ["none", "standard"],
+    pbr: true,
+    seed: false,
+    textureRef: false,
+    resolutions: ["quality", "master"]
+  },
+  sam: {
+    textPath: false,
+    views: ["none"],
+    multiImage: false,
+    texture: null,
+    pbr: false,
+    seed: true,
+    textureRef: false,
+    resolutions: null
+  }
+};
+function model3dSpecIssues(spec) {
+  const issues = [];
+  const add = (path, message) => issues.push({ path, message });
+  const rules = MODEL3D_FAMILY_RULES[spec.family];
+  const promptOnly = spec.text && !spec.imageRequired;
+  if (spec.endpoints.image === void 0)
+    add(["endpoints", "image"], "every row needs an image endpoint");
+  if (promptOnly && !rules.textPath) {
+    add(
+      ["imageRequired"],
+      `${spec.family} has no text-to-3D endpoint; a text row needs an image`
+    );
+  }
+  if (promptOnly && spec.endpoints.text === void 0) {
+    add(["endpoints", "text"], "a text row needs a text endpoint");
+  }
+  if (!rules.views.includes(spec.views)) {
+    add(["views"], `${spec.family} takes views ${rules.views.join(" or ")}`);
+  }
+  if (spec.views === "none" && spec.maxImages !== 1) {
+    add(["maxImages"], "a row without views takes 1 image");
+  }
+  if (spec.views === "unordered" && spec.maxImages < 2) {
+    add(["maxImages"], "a row with views takes at least 2 images");
+  }
+  const slots = MODEL3D_IMAGE_SLOTS[spec.views].length;
+  if (spec.views !== "none" && spec.maxImages > slots) {
+    add(["maxImages"], `a row with ${spec.views} views sends at most ${slots} images`);
+  }
+  if ((spec.views === "named" || spec.views === "ordered") && spec.maxImages < slots) {
+    add(
+      ["maxImages"],
+      `a row with ${spec.views} views takes ${slots} images (front and three sides)`
+    );
+  }
+  if (spec.views !== "none" && rules.multiImage && spec.endpoints.multiImage === void 0) {
+    add(["endpoints", "multiImage"], `${spec.family} sends views to a multi-image endpoint`);
+  }
+  if (rules.texture === null) {
+    if (spec.texture.length > 0) add(["texture"], `${spec.family} has no texture switch`);
+  } else {
+    const allowed = rules.texture;
+    if (spec.texture.length === 0) add(["texture"], `${spec.family} needs its texture options`);
+    if (new Set(spec.texture).size !== spec.texture.length)
+      add(["texture"], "texture options repeat");
+    for (const t of spec.texture) {
+      if (!allowed.includes(t)) add(["texture"], `${spec.family} has no "${t}" texture`);
+    }
+  }
+  if (spec.pbr && !rules.pbr) add(["pbr"], `${spec.family} has no PBR switch`);
+  if (spec.pbr && !spec.texture.some((t) => t !== "none")) {
+    add(["pbr"], "PBR needs a textured option");
+  }
+  if (spec.seed && !rules.seed) add(["seed"], `${spec.family} takes no seed`);
+  if (spec.seedMax !== void 0 && !spec.seed) add(["seedMax"], "seedMax needs seed");
+  if (spec.textureRef && !rules.textureRef)
+    add(["textureRef"], `${spec.family} takes no texture reference`);
+  const res = spec.resolutions;
+  if (rules.resolutions === null) {
+    if (res !== void 0) add(["resolutions"], `${spec.family} has no resolution option`);
+  } else if (res === void 0) {
+    add(["resolutions"], `${spec.family} needs its resolution options`);
+  } else {
+    if (!res.options.includes(res.default)) {
+      add(["resolutions", "default"], "default must be an option");
+    }
+    if (new Set(res.options).size !== res.options.length) {
+      add(["resolutions", "options"], "resolution options repeat");
+    }
+    const allowed = rules.resolutions;
+    for (const option of res.options) {
+      const ok = allowed === "integer" ? /^[1-9][0-9]*$/.test(option) : allowed.includes(option);
+      if (!ok)
+        add(["resolutions", "options"], `${spec.family} has no "${option}" resolution`);
+    }
+  }
+  return issues;
+}
 var VideoToolConstraintsSchema = z3.looseObject({
   kind: z3.enum(["upscale", "interpolate", "hdr", "bg-remove", "subtitles"]),
   upscaleFactor: RangeSchema.optional(),
@@ -6656,6 +7089,30 @@ var VideoToolConstraintsSchema = z3.looseObject({
   translationLanguages: z3.array(z3.string().min(1)).min(1).optional(),
   maxSecondsAbove1080p: z3.number().positive().optional()
 });
+var Model3dTextureSchema = z3.enum(["none", "standard", "detailed"]);
+var Model3dConstraintsSchema = z3.looseObject({
+  family: z3.enum(["trellis", "hunyuan", "tripo", "rodin", "meshy", "hi3d", "sam"]),
+  endpoints: z3.looseObject({
+    text: z3.string().min(1).optional(),
+    image: z3.string().min(1).optional(),
+    multiImage: z3.string().min(1).optional()
+  }),
+  text: z3.boolean(),
+  imageRequired: z3.boolean(),
+  promptRequired: z3.boolean().optional(),
+  views: z3.enum(["none", "unordered", "ordered", "named"]),
+  maxImages: z3.number().int().positive(),
+  texture: z3.array(Model3dTextureSchema),
+  pbr: z3.boolean(),
+  textureRef: z3.boolean(),
+  seed: z3.boolean(),
+  seedMax: z3.number().int().positive().optional(),
+  resolutions: z3.looseObject({
+    label: z3.string().min(1),
+    options: z3.array(z3.string().min(1)).min(1),
+    default: z3.string().min(1)
+  }).optional()
+});
 var ModelConstraintsSchema = z3.looseObject({
   aspectRatios: z3.array(AspectRatioSchema).optional(),
   sizes: z3.array(ImageSizeSchema).optional(),
@@ -6683,6 +7140,7 @@ var ModelConstraintsSchema = z3.looseObject({
     returns: z3.enum(["new", "joined"]).optional()
   }).optional(),
   tool: VideoToolConstraintsSchema.optional(),
+  model3d: Model3dConstraintsSchema.optional(),
   // Loose on purpose: the read path keeps a row whose value is invalid (the accessors in
   // conventions.ts read it as "not set"); CatalogModelSchema below rejects it on write.
   audio: z3.unknown().optional(),
@@ -6798,29 +7256,47 @@ var CatalogModelSchemaBase = z3.looseObject({
   pricingKind: PricingKindSchema,
   display: CatalogDisplaySchema.optional(),
   capabilities: CatalogCapabilitiesSchema.optional()
-}).superRefine((row, ctx) => {
-  if (row.lifecycle === "active" && !row.display) {
+}).superRefine((row2, ctx) => {
+  if (row2.lifecycle === "active" && !row2.display) {
     ctx.addIssue({
       code: "custom",
       path: ["display"],
       message: "active rows need display"
     });
   }
-  if (row.lifecycle === "active" && row.type === "text" && !row.capabilities?.contextWindow) {
+  if (row2.lifecycle === "active" && row2.type === "text" && !row2.capabilities?.contextWindow) {
     ctx.addIssue({
       code: "custom",
       path: ["capabilities", "contextWindow"],
       message: "active text rows need contextWindow"
     });
   }
-  if (row.type === "video-tool" && row.constraints.tool === void 0) {
+  if (row2.type === "video-tool" && row2.constraints.tool === void 0) {
     ctx.addIssue({
       code: "custom",
       path: ["constraints", "tool"],
       message: "video-tool rows need constraints.tool"
     });
   }
-  if (row.replacedBy !== void 0 && row.replacedBy === row.id) {
+  if (row2.type === "model3d") {
+    const spec = row2.constraints.model3d;
+    if (spec === void 0) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["constraints", "model3d"],
+        message: "model3d rows need constraints.model3d"
+      });
+    } else {
+      for (const issue of model3dSpecIssues(spec)) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["constraints", "model3d", ...issue.path],
+          message: issue.message
+        });
+      }
+    }
+  }
+  if (row2.replacedBy !== void 0 && row2.replacedBy === row2.id) {
     ctx.addIssue({
       code: "custom",
       path: ["replacedBy"],
@@ -6829,8 +7305,8 @@ var CatalogModelSchemaBase = z3.looseObject({
   }
 });
 var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
-  (row, ctx) => {
-    const transport = row.providerOptions?.["modelkit"]?.["transport"];
+  (row2, ctx) => {
+    const transport = row2.providerOptions?.["modelkit"]?.["transport"];
     if (transport !== void 0 && transport !== "direct" && transport !== "bedrock") {
       ctx.addIssue({
         code: "custom",
@@ -6838,9 +7314,9 @@ var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
         message: 'transport must be "direct" or "bedrock"'
       });
     }
-    const inputSpecRaw = row.providerOptions?.["modelkit"]?.["inputSpec"];
+    const inputSpecRaw = row2.providerOptions?.["modelkit"]?.["inputSpec"];
     if (inputSpecRaw !== void 0) {
-      const result = validateInputSpec(inputSpecRaw, row);
+      const result = validateInputSpec(inputSpecRaw, row2);
       if (!result.ok) {
         for (const issue of result.issues) {
           ctx.addIssue({
@@ -6851,7 +7327,7 @@ var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
         }
       }
     }
-    const audio = row.constraints.audio;
+    const audio = row2.constraints.audio;
     if (audio !== void 0 && !AudioOutputSchema.safeParse(audio).success) {
       ctx.addIssue({
         code: "custom",
@@ -6859,7 +7335,7 @@ var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
         message: 'audio must be "always", "optional" or "never"'
       });
     }
-    const refs = row.constraints.references;
+    const refs = row2.constraints.references;
     for (const kind of ["images", "videos", "audios"]) {
       const least = refs?.min?.[kind];
       const most = refs?.[kind];
@@ -6871,10 +7347,10 @@ var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
         });
       }
     }
-    for (const issue of optionListIssues(row)) {
+    for (const issue of optionListIssues(row2)) {
       ctx.addIssue({ code: "custom", path: issue.path, message: issue.message });
     }
-    const prompt = row.constraints.prompt;
+    const prompt = row2.constraints.prompt;
     if (prompt !== void 0) {
       const parsed = PromptConventionsSchema.safeParse(prompt);
       if (!parsed.success) {
@@ -6889,7 +7365,7 @@ var CatalogModelSchema = CatalogModelSchemaBase.superRefine(
     }
   }
 );
-var CatalogSchema = z3.array(CatalogModelSchemaBase.transform((row) => normaliseConventions(row).row)).superRefine((rows, ctx) => {
+var CatalogSchema = z3.array(CatalogModelSchemaBase.transform((row2) => normaliseConventions(row2).row)).superRefine((rows, ctx) => {
   for (const issue of collisionIssues(rows)) {
     ctx.addIssue({
       code: "custom",
@@ -7892,7 +8368,7 @@ async function generateSeedanceVideo(req, ctx) {
 }
 
 // src/adapters/fal.ts
-import { z as z18 } from "zod";
+import { z as z20 } from "zod";
 import { createFalClient } from "@fal-ai/client";
 
 // src/adapters/fal-http.ts
@@ -8197,7 +8673,7 @@ async function passthroughVideoJob(ctx, endpoint, input, decode) {
 }
 
 // src/adapters/fal-video-tools.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 
 // src/video-length.ts
 function tenths(seconds3) {
@@ -8288,28 +8764,99 @@ function subtitleFields(tool, options) {
   return out;
 }
 
-// src/catalog/video-tools-spec.ts
+// src/adapters/fal-queue.ts
 import { z as z11 } from "zod";
-var RangeSchema2 = z11.object({ min: z11.number(), max: z11.number() });
-var ToolSchema = z11.object({
-  kind: z11.enum(["upscale", "interpolate", "hdr", "bg-remove", "subtitles"]),
+var FAL_QUEUE_ORIGIN = "https://queue.fal.run";
+var queueUrlSchema = z11.url().refine((value) => new URL(value).origin === FAL_QUEUE_ORIGIN, {
+  message: "not a fal queue URL"
+});
+var submitResponseSchema = z11.object({
+  request_id: z11.string().min(1),
+  status_url: queueUrlSchema,
+  response_url: queueUrlSchema,
+  cancel_url: queueUrlSchema
+});
+var statusResponseSchema = z11.object({ status: z11.string() });
+var falWebhookBodySchema = z11.object({
+  request_id: z11.string().min(1),
+  gateway_request_id: z11.string().nullish(),
+  status: z11.enum(["OK", "ERROR"]),
+  payload: JsonValueSchema.nullish(),
+  error: z11.string().nullish(),
+  payload_error: JsonValueSchema.nullish()
+});
+async function queueFetch(ctx, url, method, body) {
+  const payload = body === void 0 ? void 0 : JSON.stringify(body);
+  try {
+    if (ctx.routing.fal === "cloudflare-passthrough") {
+      return await gatewayFetch(gatewayConfig(ctx), ctx.fetch, url, {
+        method,
+        ...payload !== void 0 && { body: payload }
+      });
+    }
+    const falKey = ctx.keys.fal;
+    if (!falKey) {
+      throw new ModelKitError({
+        code: "auth",
+        message: "Missing API key for fal",
+        provider: "fal",
+        model: ctx.model.id,
+        retryable: false
+      });
+    }
+    return await ctx.fetch(url, {
+      method,
+      headers: {
+        Authorization: `Key ${falKey}`,
+        ...payload !== void 0 && { "Content-Type": "application/json" }
+      },
+      ...payload !== void 0 && { body: payload },
+      ...ctx.signal !== void 0 && { signal: ctx.signal }
+    });
+  } catch (cause) {
+    if (cause instanceof ModelKitError) throw cause;
+    throw classifyThrown("fal", cause, ctx.model.id);
+  }
+}
+async function readJson(ctx, res) {
+  if (!res.ok) throw falError(res.status, await readBody(res), ctx.model.id);
+  return JsonValueSchema.parse(await res.json());
+}
+function checkedQueueUrl(ctx, url, what) {
+  if (!queueUrlSchema.safeParse(url).success) {
+    throw new ModelKitError({
+      code: "provider_rejected",
+      message: `${what} submission carries a URL outside fal's queue`,
+      provider: "fal",
+      model: ctx.model.id,
+      retryable: false
+    });
+  }
+  return url;
+}
+
+// src/catalog/video-tools-spec.ts
+import { z as z12 } from "zod";
+var RangeSchema2 = z12.object({ min: z12.number(), max: z12.number() });
+var ToolSchema = z12.object({
+  kind: z12.enum(["upscale", "interpolate", "hdr", "bg-remove", "subtitles"]),
   upscaleFactor: RangeSchema2.optional(),
-  maxOutputLongEdge: z11.number().positive().optional(),
-  prompt: z11.boolean().optional(),
+  maxOutputLongEdge: z12.number().positive().optional(),
+  prompt: z12.boolean().optional(),
   fps: RangeSchema2.optional(),
-  outputFormats: z11.array(z11.enum(["h265", "prores", "exr"])).min(1).optional(),
-  maxOutputShortEdge: z11.number().positive().optional(),
-  maxOutputFrames: z11.number().positive().optional(),
-  minOutputFrames: z11.number().positive().optional(),
-  maxOutputFps: z11.number().positive().optional(),
-  presets: z11.array(z11.string().min(1)).min(1).optional(),
-  languages: z11.array(z11.string().min(1)).min(1).optional(),
-  translationLanguages: z11.array(z11.string().min(1)).min(1).optional(),
-  maxSecondsAbove1080p: z11.number().positive().optional()
+  outputFormats: z12.array(z12.enum(["h265", "prores", "exr"])).min(1).optional(),
+  maxOutputShortEdge: z12.number().positive().optional(),
+  maxOutputFrames: z12.number().positive().optional(),
+  minOutputFrames: z12.number().positive().optional(),
+  maxOutputFps: z12.number().positive().optional(),
+  presets: z12.array(z12.string().min(1)).min(1).optional(),
+  languages: z12.array(z12.string().min(1)).min(1).optional(),
+  translationLanguages: z12.array(z12.string().min(1)).min(1).optional(),
+  maxSecondsAbove1080p: z12.number().positive().optional()
 });
-function videoToolConstraints(row) {
-  if (row.type !== "video-tool") return void 0;
-  const parsed = ToolSchema.safeParse(row.constraints.tool);
+function videoToolConstraints(row2) {
+  if (row2.type !== "video-tool") return void 0;
+  const parsed = ToolSchema.safeParse(row2.constraints.tool);
   if (!parsed.success) return void 0;
   const {
     kind,
@@ -8356,16 +8903,16 @@ function resolutionTier(width, height) {
 function fail(error) {
   return { ok: false, error };
 }
-function planVideoTool(row, req) {
-  const tool = videoToolConstraints(row);
-  if (!tool) return fail(`${row.id} is not a video tool`);
+function planVideoTool(row2, req) {
+  const tool = videoToolConstraints(row2);
+  if (!tool) return fail(`${row2.id} is not a video tool`);
   const { width, height, durationSeconds, fps } = req.source;
   if (!(width > 0 && height > 0 && durationSeconds > 0)) {
     return fail("The source video's width, height and duration are required");
   }
-  const maxSeconds = row.constraints.sourceVideoSeconds?.max;
+  const maxSeconds = row2.constraints.sourceVideoSeconds?.max;
   if (maxSeconds !== void 0 && overMax(durationSeconds, maxSeconds)) {
-    return fail(`${row.label} takes source videos up to ${maxSeconds} seconds.`);
+    return fail(`${row2.label} takes source videos up to ${maxSeconds} seconds.`);
   }
   const base = {
     durationSeconds,
@@ -8376,7 +8923,7 @@ function planVideoTool(row, req) {
     if (factor === void 0) return fail("An upscale factor is required");
     const range2 = tool.upscaleFactor;
     if (range2 && (factor < range2.min || factor > range2.max)) {
-      return fail(`${row.label} upscales by ${range2.min}x to ${range2.max}x.`);
+      return fail(`${row2.label} upscales by ${range2.min}x to ${range2.max}x.`);
     }
     const outWidth = Math.round(width * factor);
     const outHeight = Math.round(height * factor);
@@ -8404,7 +8951,7 @@ function planVideoTool(row, req) {
     }
     const range2 = tool.fps;
     if (range2 && (target < range2.min || target > range2.max)) {
-      return fail(`${row.label} outputs ${range2.min} to ${range2.max} fps.`);
+      return fail(`${row2.label} outputs ${range2.min} to ${range2.max} fps.`);
     }
     return {
       ok: true,
@@ -8433,7 +8980,7 @@ function planVideoTool(row, req) {
   if (tool.kind === "subtitles") {
     const resolution = resolutionTier(width, height);
     const problem = subtitleProblem(
-      row.label,
+      row2.label,
       tool,
       req.subtitles,
       resolution,
@@ -8445,9 +8992,9 @@ function planVideoTool(row, req) {
   const formats = tool.outputFormats ?? ["h265"];
   const format = req.outputFormat ?? formats[0] ?? "h265";
   if (!formats.includes(format)) {
-    return fail(`${row.label} writes ${formats.join(" or ")}.`);
+    return fail(`${row2.label} writes ${formats.join(" or ")}.`);
   }
-  const timing = renderedTiming(row, tool, durationSeconds, fps);
+  const timing = renderedTiming(row2, tool, durationSeconds, fps);
   if (!timing.ok) return fail(timing.error);
   const out = shrinkToShortEdge(width, height, tool.maxOutputShortEdge);
   return {
@@ -8463,7 +9010,7 @@ function planVideoTool(row, req) {
   };
 }
 var DEFAULT_FPS = 24;
-function renderedTiming(row, tool, durationSeconds, fps) {
+function renderedTiming(row2, tool, durationSeconds, fps) {
   const { maxOutputFps, minOutputFrames, maxOutputFrames } = tool;
   if (maxOutputFps === void 0 && minOutputFrames === void 0 && maxOutputFrames === void 0) {
     return fps !== void 0 ? { ok: true, fps } : { ok: true };
@@ -8472,7 +9019,7 @@ function renderedTiming(row, tool, durationSeconds, fps) {
   const frames = Math.max(minOutputFrames ?? 1, Math.round(durationSeconds * rate));
   if (maxOutputFrames !== void 0 && frames > maxOutputFrames) {
     const limit = `${maxOutputFrames} frames (${seconds(maxOutputFrames, rate)})`;
-    return { ok: false, error: `${row.label} renders up to ${limit}.` };
+    return { ok: false, error: `${row2.label} renders up to ${limit}.` };
   }
   return { ok: true, fps: rate, frames, durationSeconds: frames / rate };
 }
@@ -8487,76 +9034,20 @@ function shrinkToShortEdge(width, height, limit) {
 }
 
 // src/adapters/fal-video-tools.ts
-var FAL_QUEUE_ORIGIN = "https://queue.fal.run";
-var queueUrlSchema = z12.url().refine((value) => new URL(value).origin === FAL_QUEUE_ORIGIN, {
-  message: "not a fal queue URL"
-});
-var submitResponseSchema = z12.object({
-  request_id: z12.string().min(1),
-  status_url: queueUrlSchema,
-  response_url: queueUrlSchema,
-  cancel_url: queueUrlSchema
+var videoFileSchema = z13.object({
+  url: z13.url(),
+  content_type: z13.string().nullish(),
+  file_size: z13.number().nullish()
 });
-var statusResponseSchema = z12.object({ status: z12.string() });
-var videoFileSchema = z12.object({
-  url: z12.url(),
-  content_type: z12.string().nullish(),
-  file_size: z12.number().nullish()
+var toolOutputSchema = z13.object({
+  video: z13.union([videoFileSchema, z13.array(videoFileSchema).min(1)])
 });
-var toolOutputSchema = z12.object({
-  video: z12.union([videoFileSchema, z12.array(videoFileSchema).min(1)])
-});
-var exrOutputSchema = z12.object({
+var exrOutputSchema = z13.object({
   preview_video: videoFileSchema,
   exr_frames_url: videoFileSchema
 });
-var falWebhookBodySchema = z12.object({
-  request_id: z12.string().min(1),
-  gateway_request_id: z12.string().nullish(),
-  status: z12.enum(["OK", "ERROR"]),
-  payload: JsonValueSchema.nullish(),
-  error: z12.string().nullish(),
-  payload_error: JsonValueSchema.nullish()
-});
-async function queueFetch(ctx, url, method, body) {
-  const payload = body === void 0 ? void 0 : JSON.stringify(body);
-  try {
-    if (ctx.routing.fal === "cloudflare-passthrough") {
-      return await gatewayFetch(gatewayConfig(ctx), ctx.fetch, url, {
-        method,
-        ...payload !== void 0 && { body: payload }
-      });
-    }
-    const falKey = ctx.keys.fal;
-    if (!falKey) {
-      throw new ModelKitError({
-        code: "auth",
-        message: "Missing API key for fal",
-        provider: "fal",
-        model: ctx.model.id,
-        retryable: false
-      });
-    }
-    return await ctx.fetch(url, {
-      method,
-      headers: {
-        Authorization: `Key ${falKey}`,
-        ...payload !== void 0 && { "Content-Type": "application/json" }
-      },
-      ...payload !== void 0 && { body: payload },
-      ...ctx.signal !== void 0 && { signal: ctx.signal }
-    });
-  } catch (cause) {
-    if (cause instanceof ModelKitError) throw cause;
-    throw classifyThrown("fal", cause, ctx.model.id);
-  }
-}
-async function readJson(ctx, res) {
-  if (!res.ok) throw falError(res.status, await readBody(res), ctx.model.id);
-  return JsonValueSchema.parse(await res.json());
-}
 function providerModelName(ctx) {
-  return z12.string().safeParse(ctx.model.providerOptions?.["fal"]?.["model"]).data;
+  return z13.string().safeParse(ctx.model.providerOptions?.["fal"]?.["model"]).data;
 }
 function staticInput(ctx) {
   return JsonObjectSchema.safeParse(ctx.model.providerOptions?.["fal"]?.["input"]).data ?? {};
@@ -8627,20 +9118,8 @@ async function submitFalVideoTool(req, ctx, opts) {
     output: plan3.output
   };
 }
-function checkedQueueUrl(ctx, url) {
-  if (!queueUrlSchema.safeParse(url).success) {
-    throw new ModelKitError({
-      code: "provider_rejected",
-      message: "Video-tool submission carries a URL outside fal's queue",
-      provider: "fal",
-      model: ctx.model.id,
-      retryable: false
-    });
-  }
-  return url;
-}
 async function falVideoToolStatus(sub, ctx) {
-  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.statusUrl), "GET");
+  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.statusUrl, "Video-tool"), "GET");
   const { status } = statusResponseSchema.parse(await readJson(ctx, res));
   if (status === "IN_QUEUE") return "queued";
   if (status === "COMPLETED") return "completed";
@@ -8737,18 +9216,18 @@ async function falVideoToolResult(sub, ctx, webhook) {
     }
     return resultOf(ctx, sub, webhook.payload);
   }
-  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.responseUrl), "GET");
+  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.responseUrl, "Video-tool"), "GET");
   return resultOf(ctx, sub, await readJson(ctx, res));
 }
 async function cancelFalVideoTool(sub, ctx) {
-  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.cancelUrl), "PUT");
+  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.cancelUrl, "Video-tool"), "PUT");
   if (res.ok) return true;
   if (res.status === 400) return false;
   throw falError(res.status, await readBody(res), ctx.model.id);
 }
 
 // src/adapters/fal-image.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 
 // src/resolve-image-rules.ts
 var WIDE_RATIOS = [
@@ -9334,9 +9813,9 @@ function planFalImage(req, providerModelId, model) {
   if (built.imageSize !== void 0) plan3.imageSize = built.imageSize;
   return plan3;
 }
-var FalFileSchema = z13.object({ url: z13.string(), content_type: z13.string().nullish() });
-var ImagesPayloadSchema = z13.object({ images: z13.array(FalFileSchema) });
-var ImagePayloadSchema = z13.object({ image: FalFileSchema });
+var FalFileSchema = z14.object({ url: z14.string(), content_type: z14.string().nullish() });
+var ImagesPayloadSchema = z14.object({ images: z14.array(FalFileSchema) });
+var ImagePayloadSchema = z14.object({ image: FalFileSchema });
 function decodeDataUri(url) {
   const comma = url.indexOf(",");
   const meta = url.slice(5, comma);
@@ -9395,15 +9874,15 @@ async function generateFalFamilyImage(req, ctx, run) {
 }
 
 // src/adapters/fal-mask.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 var SAM3_IMAGE = "fal-ai/sam-3/image";
 var MAX_MASKS = 32;
-function fail3(row, message, code) {
+function fail3(row2, message, code) {
   return new ModelKitError({
     code,
-    message: `${row.label}: ${message}`,
+    message: `${row2.label}: ${message}`,
     provider: "fal",
-    model: row.id,
+    model: row2.id,
     retryable: false
   });
 }
@@ -9413,22 +9892,22 @@ function pointPrompts(points) {
 function boxPrompts(boxes) {
   return boxes.map((b) => ({ x_min: b.xMin, y_min: b.yMin, x_max: b.xMax, y_max: b.yMax }));
 }
-function planFalMask(row, req) {
-  if (row.providerModelId !== SAM3_IMAGE) {
+function planFalMask(row2, req) {
+  if (row2.providerModelId !== SAM3_IMAGE) {
     throw fail3(
-      row,
-      `fal has no mask mapper for "${row.providerModelId}"`,
+      row2,
+      `fal has no mask mapper for "${row2.providerModelId}"`,
       "unsupported_option"
     );
   }
   const refs = req.references ?? [];
   const [image] = refs;
-  if (image === void 0) throw fail3(row, "needs one source image", "missing_input");
+  if (image === void 0) throw fail3(row2, "needs one source image", "missing_input");
   if (refs.length > 1) {
-    throw fail3(row, `takes one source image; got ${refs.length}`, "unsupported_option");
+    throw fail3(row2, `takes one source image; got ${refs.length}`, "unsupported_option");
   }
   const problem = maskProblem(req);
-  if (problem !== void 0) throw fail3(row, problem.message, problem.code);
+  if (problem !== void 0) throw fail3(row2, problem.message, problem.code);
   const input = {
     image_url: refToUrl(image),
     prompt: req.prompt.trim(),
@@ -9445,17 +9924,17 @@ function planFalMask(row, req) {
   }
   return { endpoint: SAM3_IMAGE, input };
 }
-var masksSchema = z14.object({
-  masks: z14.array(z14.object({ url: z14.string().min(1), content_type: z14.string().nullish() }))
+var masksSchema = z15.object({
+  masks: z15.array(z15.object({ url: z15.string().min(1), content_type: z15.string().nullish() }))
 });
-function parseFalMasks(row, payload) {
+function parseFalMasks(row2, payload) {
   const parsed = masksSchema.safeParse(payload);
   if (!parsed.success) {
     throw new ModelKitError({
       code: "provider_rejected",
       message: `fal ${SAM3_IMAGE} returned no mask list`,
       provider: "fal",
-      model: row.id,
+      model: row2.id,
       retryable: false
     });
   }
@@ -9488,7 +9967,7 @@ async function generateFalMask(req, ctx, run) {
 }
 
 // src/adapters/fal-audio-plan.ts
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
 var ELEVENLABS_MUSIC = FAL_AUDIO.elevenLabsMusic;
 var MINIMAX_MUSIC_32 = FAL_AUDIO.minimaxMusic;
 var ELEVENLABS_SFX = FAL_AUDIO.elevenLabsSfx;
@@ -9535,65 +10014,65 @@ var FAL_MEDIA_TYPES = /* @__PURE__ */ new Set([
 function isFalMediaKnown(type, providerModelId) {
   return KNOWN[type]?.has(providerModelId) ?? false;
 }
-function falMediaError(row, message, code) {
+function falMediaError(row2, message, code) {
   return new ModelKitError({
     code,
-    message: `${row.label}: ${message}`,
+    message: `${row2.label}: ${message}`,
     provider: "fal",
-    model: row.id,
+    model: row2.id,
     retryable: false
   });
 }
-function refuseMedia(row, present) {
-  const extra = Object.entries(present).find(([, set]) => set);
-  if (extra) throw falMediaError(row, `does not take ${extra[0]}`, "unsupported_option");
+function refuseMedia(row2, present2) {
+  const extra = Object.entries(present2).find(([, set]) => set);
+  if (extra) throw falMediaError(row2, `does not take ${extra[0]}`, "unsupported_option");
 }
 function setIf(input, key, value) {
   if (value !== void 0) input[key] = value;
 }
-function unmapped(row) {
+function unmapped(row2) {
   return falMediaError(
-    row,
-    `fal has no ${row.type} mapper for "${row.providerModelId}"`,
+    row2,
+    `fal has no ${row2.type} mapper for "${row2.providerModelId}"`,
     "unsupported_option"
   );
 }
-function mediaUrl(row, field, ref) {
-  if (ref === void 0) throw falMediaError(row, `needs ${field}`, "missing_input");
+function mediaUrl(row2, field, ref) {
+  if (ref === void 0) throw falMediaError(row2, `needs ${field}`, "missing_input");
   return refToUrl(ref);
 }
 function trimmed(text2) {
   const value = text2?.trim();
   return value ? value : void 0;
 }
-function requireText(row, text2, what) {
+function requireText(row2, text2, what) {
   const value = trimmed(text2);
-  if (value === void 0) throw falMediaError(row, `needs ${what}`, "missing_input");
+  if (value === void 0) throw falMediaError(row2, `needs ${what}`, "missing_input");
   return value;
 }
-function planMirelo(row, req) {
-  const id = row.providerModelId;
+function planMirelo(row2, req) {
+  const id = row2.providerModelId;
   const input = { num_samples: 1 };
   setIf(input, "duration", req.durationSeconds);
   setIf(input, "negative_prompt", req.negativePrompt);
   setIf(input, "seed", req.seed);
   setIf(input, "upload_audio_format", req.outputFormat);
   if (id === MIRELO_VIDEO) {
-    input["video_url"] = mediaUrl(row, "sourceVideo", req.sourceVideo);
+    input["video_url"] = mediaUrl(row2, "sourceVideo", req.sourceVideo);
     setIf(input, "text_prompt", trimmed(req.prompt));
     return { endpoint: id, input };
   }
   input["prompt"] = req.prompt.trim();
   return { endpoint: id, input };
 }
-function planFalAudio(row, req) {
-  if (row.type !== "audio" && row.type !== "sound-effect") {
-    throw falMediaError(row, `${row.type} rows do not generate audio`, "unsupported_option");
+function planFalAudio(row2, req) {
+  if (row2.type !== "audio" && row2.type !== "sound-effect") {
+    throw falMediaError(row2, `${row2.type} rows do not generate audio`, "unsupported_option");
   }
-  const id = row.providerModelId;
+  const id = row2.providerModelId;
   const problem = falAudioProblem(id, req);
-  if (problem !== void 0) throw falMediaError(row, problem.message, problem.code);
-  if (id === MIRELO_TEXT || id === MIRELO_VIDEO) return planMirelo(row, req);
+  if (problem !== void 0) throw falMediaError(row2, problem.message, problem.code);
+  if (id === MIRELO_TEXT || id === MIRELO_VIDEO) return planMirelo(row2, req);
   const prompt = req.prompt.trim();
   if (id === ELEVENLABS_MUSIC) {
     const input = { prompt };
@@ -9618,12 +10097,12 @@ function planFalAudio(row, req) {
     setIf(input, "output_format", req.outputFormat);
     return { endpoint: id, input };
   }
-  throw unmapped(row);
+  throw unmapped(row2);
 }
-function planFalSpeech(row, req) {
-  const id = row.providerModelId;
-  if (row.type !== "speech") throw unmapped(row);
-  const script = requireText(row, req.text, "text");
+function planFalSpeech(row2, req) {
+  const id = row2.providerModelId;
+  if (row2.type !== "speech") throw unmapped(row2);
+  const script = requireText(row2, req.text, "text");
   if (ELEVENLABS_TTS.has(id)) {
     const input = { text: script };
     setIf(input, "voice", req.voice);
@@ -9643,31 +10122,31 @@ function planFalSpeech(row, req) {
     setIf(input, "language_boost", req.language);
     return { endpoint: id, input };
   }
-  throw unmapped(row);
+  throw unmapped(row2);
 }
-function planFalVoiceChange(row, req) {
-  if (row.type !== "voice-change" || row.providerModelId !== VOICE_CHANGER) throw unmapped(row);
-  const input = { audio_url: mediaUrl(row, "sourceAudio", req.sourceAudio) };
+function planFalVoiceChange(row2, req) {
+  if (row2.type !== "voice-change" || row2.providerModelId !== VOICE_CHANGER) throw unmapped(row2);
+  const input = { audio_url: mediaUrl(row2, "sourceAudio", req.sourceAudio) };
   setIf(input, "voice", req.voice);
   setIf(input, "output_format", req.outputFormat);
   return { endpoint: VOICE_CHANGER, input };
 }
-var fileSchema = z15.object({
-  url: z15.string().min(1),
-  content_type: z15.string().nullish()
+var fileSchema = z16.object({
+  url: z16.string().min(1),
+  content_type: z16.string().nullish()
 });
-var audioOutputSchema = z15.object({
-  audio: z15.union([fileSchema, z15.array(fileSchema).min(1)]),
-  duration: z15.number().nullish(),
-  duration_ms: z15.number().nullish(),
-  lyrics: z15.string().nullish()
+var audioOutputSchema = z16.object({
+  audio: z16.union([fileSchema, z16.array(fileSchema).min(1)]),
+  duration: z16.number().nullish(),
+  duration_ms: z16.number().nullish(),
+  lyrics: z16.string().nullish()
 });
-function noFalOutput(row, what, endpoint) {
+function noFalOutput(row2, what, endpoint) {
   return new ModelKitError({
     code: "provider_rejected",
     message: `fal ${endpoint} returned no ${what}`,
     provider: "fal",
-    model: row.id,
+    model: row2.id,
     retryable: false
   });
 }
@@ -9675,12 +10154,12 @@ function reportedSeconds(seconds3, ms) {
   if (seconds3 != null) return seconds3;
   return ms != null ? ms / 1e3 : void 0;
 }
-function parseFalAudio(row, endpoint, payload) {
+function parseFalAudio(row2, endpoint, payload) {
   const parsed = audioOutputSchema.safeParse(payload);
-  if (!parsed.success) throw noFalOutput(row, "audio", endpoint);
+  if (!parsed.success) throw noFalOutput(row2, "audio", endpoint);
   const { audio, duration, duration_ms: durationMs, lyrics } = parsed.data;
   const file = Array.isArray(audio) ? audio[0] : audio;
-  if (file === void 0) throw noFalOutput(row, "audio", endpoint);
+  if (file === void 0) throw noFalOutput(row2, "audio", endpoint);
   const seconds3 = reportedSeconds(duration, durationMs);
   return {
     url: file.url,
@@ -9691,114 +10170,114 @@ function parseFalAudio(row, endpoint, payload) {
 }
 
 // src/adapters/fal-media-plan.ts
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 var MINIMAX_LIPSYNC_RESOLUTIONS = {
   "480p": "480P",
   "768p": "768P",
   "1080p": "1080P",
   "2k": "2K"
 };
-function syncModelName(row) {
-  return z16.string().safeParse(row.providerOptions?.["fal"]?.["model"]).data;
+function syncModelName(row2) {
+  return z17.string().safeParse(row2.providerOptions?.["fal"]?.["model"]).data;
 }
-function planFalLipsync(row, req) {
-  const id = row.providerModelId;
-  if (row.type !== "lipsync") throw unmapped(row);
-  const audio = mediaUrl(row, "audio", req.audio);
+function planFalLipsync(row2, req) {
+  const id = row2.providerModelId;
+  if (row2.type !== "lipsync") throw unmapped(row2);
+  const audio = mediaUrl(row2, "audio", req.audio);
   if (id === FAL_LIPSYNC.minimax) {
-    refuseMedia(row, { sourceVideo: req.sourceVideo !== void 0 });
+    refuseMedia(row2, { sourceVideo: req.sourceVideo !== void 0 });
     const input = {
-      image_url: mediaUrl(row, "image", req.image),
+      image_url: mediaUrl(row2, "image", req.image),
       audio_url: audio
     };
     if (req.resolution !== void 0) {
       const resolution = MINIMAX_LIPSYNC_RESOLUTIONS[req.resolution];
       if (resolution === void 0) {
-        throw falMediaError(row, `does not render ${req.resolution}`, "unsupported_option");
+        throw falMediaError(row2, `does not render ${req.resolution}`, "unsupported_option");
       }
       input["resolution"] = resolution;
     }
     return { endpoint: id, input };
   }
-  refuseMedia(row, { image: req.image !== void 0 });
-  const video = mediaUrl(row, "sourceVideo", req.sourceVideo);
+  refuseMedia(row2, { image: req.image !== void 0 });
+  const video = mediaUrl(row2, "sourceVideo", req.sourceVideo);
   if (id === FAL_LIPSYNC.veed) {
     return { endpoint: id, input: { video_url: video, audio_url: audio } };
   }
   if (id === FAL_LIPSYNC.syncV2 || id === FAL_LIPSYNC.syncV3) {
     const input = { video_url: video, audio_url: audio, sync_mode: "cut_off" };
-    const model = syncModelName(row);
+    const model = syncModelName(row2);
     if (id === FAL_LIPSYNC.syncV2 && model !== void 0) input["model"] = model;
     return { endpoint: id, input };
   }
-  throw unmapped(row);
+  throw unmapped(row2);
 }
-function planFalDubbing(row, req) {
-  if (row.type !== "dubbing" || row.providerModelId !== FAL_DUBBING) throw unmapped(row);
+function planFalDubbing(row2, req) {
+  if (row2.type !== "dubbing" || row2.providerModelId !== FAL_DUBBING) throw unmapped(row2);
   if (req.sourceVideo !== void 0 && req.sourceAudio !== void 0) {
     throw falMediaError(
-      row,
+      row2,
       "takes sourceVideo or sourceAudio, not both",
       "unsupported_option"
     );
   }
   const target = req.targetLanguage.trim();
-  if (!target) throw falMediaError(row, "needs targetLanguage", "missing_input");
+  if (!target) throw falMediaError(row2, "needs targetLanguage", "missing_input");
   const input = { target_lang: target };
   if (req.sourceVideo !== void 0) input["video_url"] = refToUrl(req.sourceVideo);
-  else input["audio_url"] = mediaUrl(row, "sourceVideo or sourceAudio", req.sourceAudio);
+  else input["audio_url"] = mediaUrl(row2, "sourceVideo or sourceAudio", req.sourceAudio);
   return { endpoint: FAL_DUBBING, input };
 }
-function planFalTranscription(row, req) {
-  if (row.type !== "transcription" || row.providerModelId !== FAL_SCRIBE) throw unmapped(row);
-  const input = { audio_url: mediaUrl(row, "source", req.source) };
+function planFalTranscription(row2, req) {
+  if (row2.type !== "transcription" || row2.providerModelId !== FAL_SCRIBE) throw unmapped(row2);
+  const input = { audio_url: mediaUrl(row2, "source", req.source) };
   setIf(input, "language_code", req.language?.trim() || void 0);
   return { endpoint: FAL_SCRIBE, input };
 }
-var fileSchema2 = z16.object({
-  url: z16.string().min(1),
-  content_type: z16.string().nullish()
+var fileSchema2 = z17.object({
+  url: z17.string().min(1),
+  content_type: z17.string().nullish()
 });
-var videoOutputSchema = z16.object({
+var videoOutputSchema = z17.object({
   video: fileSchema2,
-  duration: z16.number().nullish()
+  duration: z17.number().nullish()
 });
-var dubbingOutputSchema = z16.object({
+var dubbingOutputSchema = z17.object({
   video: fileSchema2.nullish(),
   audio: fileSchema2.nullish()
 });
-var transcriptSchema = z16.object({
-  text: z16.string(),
-  language_code: z16.string().nullish(),
-  words: z16.array(
-    z16.object({
-      text: z16.string(),
-      type: z16.string(),
-      start: z16.number().nullish(),
-      end: z16.number().nullish(),
-      speaker_id: z16.string().nullish()
+var transcriptSchema = z17.object({
+  text: z17.string(),
+  language_code: z17.string().nullish(),
+  words: z17.array(
+    z17.object({
+      text: z17.string(),
+      type: z17.string(),
+      start: z17.number().nullish(),
+      end: z17.number().nullish(),
+      speaker_id: z17.string().nullish()
     })
   ).nullish()
 });
-function parseFalVideo(row, endpoint, payload) {
+function parseFalVideo(row2, endpoint, payload) {
   const parsed = videoOutputSchema.safeParse(payload);
-  if (!parsed.success) throw noFalOutput(row, "video", endpoint);
+  if (!parsed.success) throw noFalOutput(row2, "video", endpoint);
   const { video, duration } = parsed.data;
   return { url: video.url, ...duration != null && { durationSeconds: duration } };
 }
-function parseFalDubbing(row, kind, payload) {
+function parseFalDubbing(row2, kind, payload) {
   const parsed = dubbingOutputSchema.safeParse(payload);
   const file = parsed.success ? parsed.data[kind] : void 0;
-  if (file == null) throw noFalOutput(row, kind, FAL_DUBBING);
+  if (file == null) throw noFalOutput(row2, kind, FAL_DUBBING);
   return {
     kind,
     url: file.url,
     ...file.content_type != null && { mime: file.content_type }
   };
 }
-function parseFalTranscript(row, endpoint, payload) {
+function parseFalTranscript(row2, endpoint, payload) {
   const parsed = transcriptSchema.safeParse(payload);
-  if (!parsed.success) throw noFalOutput(row, "transcript", endpoint);
+  if (!parsed.success) throw noFalOutput(row2, "transcript", endpoint);
   const words = (parsed.data.words ?? []).map(
     (w) => ({
       text: w.text,
@@ -9961,8 +10440,313 @@ async function transcribeFal(req, ctx, run) {
   };
 }
 
+// src/adapters/fal-model3d.ts
+import { z as z18 } from "zod";
+var fileSchema3 = z18.object({
+  url: z18.url(),
+  content_type: z18.string().nullish(),
+  file_size: z18.number().nullish()
+});
+var resultSchema = z18.looseObject({
+  model_glb: fileSchema3.nullish(),
+  model_mesh: fileSchema3.nullish(),
+  thumbnail: fileSchema3.nullish(),
+  rendered_image: fileSchema3.nullish()
+});
+function rejected(ctx, message) {
+  return new ModelKitError({
+    code: "provider_rejected",
+    message,
+    provider: "fal",
+    model: ctx.model.id,
+    retryable: false
+  });
+}
+function specOf(ctx) {
+  const spec = model3dConstraints(ctx.model);
+  if (spec === void 0) {
+    throw new ModelKitError({
+      code: "unsupported_option",
+      message: `${ctx.model.id} is not a 3D model`,
+      model: ctx.model.id
+    });
+  }
+  return spec;
+}
+var present = (v) => v !== void 0 && v.length > 0;
+function model3dCall(row2, spec, req) {
+  const prompt = req.prompt?.trim() || void 0;
+  const texture = model3dTexture(spec, req.texture);
+  const textured = spec.texture.length > 0 && texture !== "none";
+  const pbr = spec.pbr && textured && req.pbr === true;
+  const resolution = model3dResolution(spec, req.resolution);
+  const views = spec.views === "none" ? {} : req.views ?? {};
+  const seed = spec.seed && req.seed !== void 0 ? req.seed : void 0;
+  const endpoint = (path) => {
+    if (path === void 0) {
+      throw new ModelKitError({
+        code: "unsupported_option",
+        message: `${row2.id} has no endpoint for this request`,
+        provider: "fal",
+        model: row2.id,
+        retryable: false
+      });
+    }
+    return path;
+  };
+  const slotted = (kind) => MODEL3D_IMAGE_SLOTS[kind].map((slot) => slot === "image" ? req.image : views[slot]).filter(present).slice(0, spec.maxImages);
+  const images = slotted("unordered");
+  switch (spec.family) {
+    case "trellis":
+      return {
+        endpoint: endpoint(spec.endpoints.image),
+        input: {
+          image_url: req.image ?? "",
+          resolution: Number(resolution),
+          ...seed !== void 0 && { seed }
+        }
+      };
+    case "sam":
+      return {
+        endpoint: endpoint(spec.endpoints.image),
+        input: {
+          image_url: req.image ?? "",
+          ...prompt !== void 0 && { prompt },
+          export_textured_glb: true,
+          ...seed !== void 0 && { seed }
+        }
+      };
+    case "hunyuan": {
+      const opts = { generate_type: textured ? "Normal" : "Geometry", enable_pbr: pbr };
+      if (!present(req.image)) {
+        return {
+          endpoint: endpoint(spec.endpoints.text),
+          input: { prompt: prompt ?? "", ...opts }
+        };
+      }
+      return {
+        endpoint: endpoint(spec.endpoints.image),
+        input: {
+          input_image_url: req.image,
+          ...present(views.back) && { back_image_url: views.back },
+          ...present(views.left) && { left_image_url: views.left },
+          ...present(views.right) && { right_image_url: views.right },
+          ...opts
+        }
+      };
+    }
+    case "tripo": {
+      const opts = {
+        texture: textured,
+        pbr,
+        ...textured && {
+          texture_quality: texture === "detailed" ? "detailed" : "standard"
+        },
+        ...seed !== void 0 && { model_seed: seed }
+      };
+      if (!present(req.image)) {
+        return {
+          endpoint: endpoint(spec.endpoints.text),
+          input: { prompt: prompt ?? "", ...opts }
+        };
+      }
+      const ordered = slotted("ordered");
+      return ordered.length > 1 ? {
+        endpoint: endpoint(spec.endpoints.multiImage),
+        input: { image_urls: ordered, ...opts }
+      } : {
+        endpoint: endpoint(spec.endpoints.image),
+        input: { image_url: req.image, ...opts }
+      };
+    }
+    case "rodin": {
+      const opts = {
+        geometry_file_format: "glb",
+        material: "PBR",
+        ...seed !== void 0 && { seed }
+      };
+      if (images.length === 0) {
+        return {
+          endpoint: endpoint(spec.endpoints.text),
+          input: { prompt: prompt ?? "", ...opts }
+        };
+      }
+      return {
+        endpoint: endpoint(spec.endpoints.image),
+        input: { image_urls: images, ...prompt !== void 0 && { prompt }, ...opts }
+      };
+    }
+    case "meshy": {
+      const texturePrompt = req.texturePrompt?.trim() || void 0;
+      const opts = {
+        enable_pbr: pbr,
+        ...spec.textureRef && texturePrompt !== void 0 && { texture_prompt: texturePrompt },
+        ...spec.textureRef && present(req.textureImage) && { texture_image_url: req.textureImage }
+      };
+      if (images.length === 0) {
+        return {
+          endpoint: endpoint(spec.endpoints.text),
+          input: {
+            prompt: prompt ?? "",
+            mode: textured ? "full" : "preview",
+            ...opts,
+            ...seed !== void 0 && { seed }
+          }
+        };
+      }
+      return images.length > 1 ? {
+        endpoint: endpoint(spec.endpoints.multiImage),
+        input: { image_urls: images, should_texture: textured, ...opts }
+      } : {
+        endpoint: endpoint(spec.endpoints.image),
+        input: { image_url: req.image ?? "", should_texture: textured, ...opts }
+      };
+    }
+    case "hi3d": {
+      const opts = {
+        resolution: resolution === "master" ? "2048master" : "2048quality",
+        enable_texture: textured,
+        enable_pbr: pbr,
+        export_format: "glb"
+      };
+      const anyView = present(views.back) || present(views.left) || present(views.right);
+      return anyView ? {
+        endpoint: endpoint(spec.endpoints.multiImage),
+        input: {
+          front_image_url: req.image ?? "",
+          ...present(views.back) && { back_image_url: views.back },
+          ...present(views.left) && { left_image_url: views.left },
+          ...present(views.right) && { right_image_url: views.right },
+          ...opts
+        }
+      } : {
+        endpoint: endpoint(spec.endpoints.image),
+        input: { image_url: req.image ?? "", ...opts }
+      };
+    }
+  }
+}
+async function submitFalModel3d(req, ctx, opts) {
+  const spec = specOf(ctx);
+  const views = req.views ?? {};
+  const refusal2 = model3dInputRefusal(spec, {
+    prompt: present(req.prompt?.trim()),
+    image: present(req.image),
+    back: present(views.back),
+    left: present(views.left),
+    right: present(views.right),
+    top: present(views.top)
+  });
+  if (refusal2 !== null) {
+    throw new ModelKitError({
+      code: "unsupported_option",
+      message: `${ctx.model.id}: ${refusal2}`,
+      provider: "fal",
+      model: ctx.model.id,
+      retryable: false
+    });
+  }
+  if (spec.seed && req.seed !== void 0 && !model3dSeedFits(spec, req.seed)) {
+    throw new ModelKitError({
+      code: "unsupported_option",
+      message: `${ctx.model.id} takes a seed from 0 to ${spec.seedMax ?? Number.MAX_SAFE_INTEGER}`,
+      provider: "fal",
+      model: ctx.model.id,
+      retryable: false
+    });
+  }
+  const call = model3dCall(ctx.model, spec, req);
+  const sku = model3dPricingSku(
+    ctx.model,
+    {
+      ...req.texture !== void 0 && { texture: req.texture },
+      ...req.pbr !== void 0 && { pbr: req.pbr },
+      ...req.resolution !== void 0 && { resolution: req.resolution }
+    },
+    {
+      image: present(req.image),
+      views: spec.views !== "none" && (present(views.back) || present(views.left) || present(views.right) || spec.views === "unordered" && present(views.top))
+    }
+  );
+  const target = new URL(`${FAL_QUEUE_ORIGIN}/${call.endpoint}`);
+  if (opts.webhookUrl !== void 0) target.searchParams.set("fal_webhook", opts.webhookUrl);
+  const res = await queueFetch(ctx, target.toString(), "POST", call.input);
+  const parsed = submitResponseSchema.safeParse(await readJson(ctx, res));
+  if (!parsed.success) throw rejected(ctx, `fal ${call.endpoint} submit returned no queue URLs`);
+  return {
+    model: ctx.model.id,
+    provider: "fal",
+    endpoint: call.endpoint,
+    sku,
+    requestId: parsed.data.request_id,
+    statusUrl: parsed.data.status_url,
+    responseUrl: parsed.data.response_url,
+    cancelUrl: parsed.data.cancel_url
+  };
+}
+async function falModel3dStatus(sub, ctx) {
+  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.statusUrl, "3D"), "GET");
+  const { status } = statusResponseSchema.parse(await readJson(ctx, res));
+  if (status === "IN_QUEUE") return "queued";
+  if (status === "COMPLETED") return "completed";
+  return "running";
+}
+function httpsUrl(ctx, sub, url, what) {
+  if (new URL(url).protocol === "https:") return url;
+  throw rejected(ctx, `fal ${sub.endpoint} returned a ${what} URL that is not https`);
+}
+function resultOf2(ctx, sub, payload) {
+  const parsed = resultSchema.safeParse(payload);
+  const glb = parsed.success ? parsed.data.model_glb ?? parsed.data.model_mesh : void 0;
+  if (!glb) throw rejected(ctx, `fal ${sub.endpoint} returned no GLB`);
+  const still = parsed.success ? parsed.data.thumbnail ?? parsed.data.rendered_image : void 0;
+  const glbUrl = httpsUrl(ctx, sub, glb.url, "GLB");
+  const stillUrl = still ? httpsUrl(ctx, sub, still.url, "thumbnail") : void 0;
+  return {
+    glb: {
+      url: glbUrl,
+      ...glb.content_type != null && { mime: glb.content_type },
+      ...glb.file_size != null && { bytes: glb.file_size }
+    },
+    ...stillUrl !== void 0 && { thumbnail: { url: stillUrl } },
+    sku: sub.sku,
+    usage: {
+      model: ctx.model.id,
+      provider: "fal",
+      // The sink has no 3D modality; IMAGE is the nearest. The unit is what bills it.
+      modality: "IMAGE",
+      unit: "requests",
+      quantity: 1
+    },
+    raw: payload
+  };
+}
+async function falModel3dResult(sub, ctx, webhook) {
+  if (webhook !== void 0) {
+    if (webhook.request_id !== sub.requestId) {
+      throw rejected(ctx, "fal webhook is for a different request");
+    }
+    if (webhook.status === "ERROR") {
+      throw falError(
+        void 0,
+        webhook.payload ?? webhook.error ?? "fal job failed",
+        ctx.model.id
+      );
+    }
+    return resultOf2(ctx, sub, webhook.payload);
+  }
+  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.responseUrl, "3D"), "GET");
+  return resultOf2(ctx, sub, await readJson(ctx, res));
+}
+async function cancelFalModel3d(sub, ctx) {
+  const res = await queueFetch(ctx, checkedQueueUrl(ctx, sub.cancelUrl, "3D"), "PUT");
+  if (res.ok) return true;
+  if (res.status === 400) return false;
+  throw falError(res.status, await readBody(res), ctx.model.id);
+}
+
 // src/adapters/fal-video-plan.ts
-import { z as z17 } from "zod";
+import { z as z19 } from "zod";
 function refusal(ctx, message, code = "unsupported_option") {
   return new ModelKitError({
     code,
@@ -9999,9 +10783,9 @@ function wholeSeconds(req, ctx) {
   if (!Number.isInteger(duration)) throw refusal(ctx, "takes whole-second durations");
   return duration;
 }
-var lengthSchema = z17.object({
-  duration: z17.number().positive().optional(),
-  video: z17.object({ duration: z17.number().positive().nullish() }).optional()
+var lengthSchema = z19.object({
+  duration: z19.number().positive().optional(),
+  video: z19.object({ duration: z19.number().positive().nullish() }).optional()
 });
 function reportedSeconds2(payload) {
   const parsed = lengthSchema.safeParse(payload);
@@ -10133,6 +10917,30 @@ var klingV3Family = {
   }
 };
 
+// src/replicate-video-kinds.ts
+function replicateBaseModelId(providerModelId) {
+  const colon = providerModelId.indexOf(":");
+  return colon === -1 ? providerModelId : providerModelId.slice(0, colon);
+}
+var REPLICATE_VIDEO_KINDS = /* @__PURE__ */ new Map([
+  ["kling-video/v2.5-turbo/pro/image-to-video", "kling"],
+  ["kling-video/v3.0/pro/image-to-video", "kling"],
+  ["kwaivgi/kling-v3-video", "kling"],
+  ["kwaivgi/kling-v3-omni-video", "kling-omni"],
+  ["minimax/hailuo-02", "hailuo"]
+]);
+function videoKind(providerModelId) {
+  return REPLICATE_VIDEO_KINDS.get(replicateBaseModelId(providerModelId));
+}
+var KLING_TIERS = [
+  { mode: "standard", resolution: "720p" },
+  { mode: "pro", resolution: "1080p" },
+  { mode: "4k", resolution: "4k" }
+];
+function klingTier(req) {
+  return KLING_TIERS.find((tier) => tier.resolution === req.resolution) ?? KLING_TIERS.find((tier) => tier.mode === req.mode) ?? KLING_TIERS[0];
+}
+
 // src/resolve-video-rules.ts
 var MOTION_PRO2 = "fal-ai/kling-video/v3/pro/motion-control";
 var MOTION_STANDARD2 = "fal-ai/kling-video/v3/standard/motion-control";
@@ -10306,6 +11114,16 @@ function h3EndFrameRatioWarning(model, ratio) {
     message: `${model.id} follows the end frame's aspect ratio`
   };
 }
+function isReplicateKling(model) {
+  if (model.adapter !== "replicate") return false;
+  const kind = videoKind(model.providerModelId);
+  return kind === "kling" || kind === "kling-omni";
+}
+function fillReplicateKlingResolution(model, req) {
+  if (isReplicateKling(model) && req.resolution === void 0) {
+    req.resolution = klingTier(req).resolution;
+  }
+}
 function applyFalVideoRules(model, req, callerRatio, warnings) {
   if (model.adapter !== "fal") return;
   const problem = falVideoProblem(model.providerModelId, withPromptForResolve(req));
@@ -10514,7 +11332,7 @@ var MUSE_T2I_ENDPOINT = "meta/muse-image/text-to-image";
 var MUSE_EDIT_ENDPOINT = "meta/muse-image/edit";
 var KLING_O1_ENDPOINT = "fal-ai/kling-video/o1/video-to-video/reference";
 var PASSTHROUGH_MAX_WAIT_MS = 18e4;
-var falSubscribePayloadSchema = z18.object({ data: JsonValueSchema });
+var falSubscribePayloadSchema = z20.object({ data: JsonValueSchema });
 function defaultCreateFalClient(opts) {
   if (opts.maxRetries !== void 0)
     return createFalHttpClient({
@@ -10592,7 +11410,11 @@ function createFalAdapter(deps = defaultDeps) {
     submitVideoTool: submitFalVideoTool,
     videoToolStatus: falVideoToolStatus,
     videoToolResult: falVideoToolResult,
-    cancelVideoTool: cancelFalVideoTool
+    cancelVideoTool: cancelFalVideoTool,
+    submitModel3d: submitFalModel3d,
+    model3dStatus: falModel3dStatus,
+    model3dResult: falModel3dResult,
+    cancelModel3d: cancelFalModel3d
   };
 }
 function falRun(ctx, deps) {
@@ -10740,11 +11562,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 = z18.object({
-  images: z18.array(
-    z18.object({
-      url: z18.string().optional(),
-      content_type: z18.string().nullable().optional()
+var museImageResultSchema = z20.object({
+  images: z20.array(
+    z20.object({
+      url: z20.string().optional(),
+      content_type: z20.string().nullable().optional()
     })
   ).optional()
 });
@@ -10944,8 +11766,8 @@ function klingO1Input(req) {
   if (refs.length > 0) input.image_urls = refs;
   return input;
 }
-var falVideoResultSchema = z18.object({
-  video: z18.object({ url: z18.string().optional() }).optional()
+var falVideoResultSchema = z20.object({
+  video: z20.object({ url: z20.string().optional() }).optional()
 });
 function extractVideoUrl(result, endpoint, model) {
   const parsed = falVideoResultSchema.safeParse(result);
@@ -11037,13 +11859,13 @@ function planUsage(ctx, plan3) {
 }
 
 // src/adapters/google-genai.ts
-import { z as z20 } from "zod";
+import { z as z22 } from "zod";
 import {
   GoogleGenAI
 } from "@google/genai";
 
 // src/adapters/google-files.ts
-import { z as z19 } from "zod";
+import { z as z21 } from "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;
@@ -11053,17 +11875,17 @@ var GENERIC_MEDIA_TYPES = /* @__PURE__ */ new Set([
   "binary/octet-stream",
   "application/binary"
 ]);
-var uploadedFileSchema = z19.object({
-  file: z19.object({
-    uri: z19.string().optional(),
-    name: z19.string().optional(),
-    state: z19.string().optional(),
-    mimeType: z19.string().optional()
+var uploadedFileSchema = z21.object({
+  file: z21.object({
+    uri: z21.string().optional(),
+    name: z21.string().optional(),
+    state: z21.string().optional(),
+    mimeType: z21.string().optional()
   }).optional()
 });
-var fileStateSchema = z19.object({
-  state: z19.string().optional(),
-  error: z19.object({ message: z19.string().optional() }).optional()
+var fileStateSchema = z21.object({
+  state: z21.string().optional(),
+  error: z21.object({ message: z21.string().optional() }).optional()
 });
 function resolveMime(declared, fallback) {
   const clean = declared?.split(";")[0]?.trim().toLowerCase();
@@ -11284,7 +12106,7 @@ var OMNI_POLL_INTERVAL_MS = 1e4;
 var RESULT_TIMEOUT_MS3 = 15 * 60 * 1e3;
 var OMNI_INLINE_LIMIT_BYTES = 4 * 1024 * 1024;
 var MEDIA_PART_INLINE_LIMIT_BYTES = 20 * 1024 * 1024;
-var errorTextSchema = z20.string();
+var errorTextSchema = z22.string();
 function isGoogleGenaiVideoKnown(providerModelId) {
   return providerModelId.startsWith("veo-") || providerModelId.startsWith("gemini-omni");
 }
@@ -11948,15 +12770,15 @@ async function prepareGoogleMediaPart(ref, mediaType, ctx) {
 // src/adapters/google-image.ts
 import { createGoogleGenerativeAI as createGoogleGenerativeAI2 } from "@ai-sdk/google";
 import { generateText } from "ai";
-import { z as z21 } from "zod";
+import { z as z23 } from "zod";
 var GEMINI_IMAGE_TIMEOUT_MS = 6e5;
 var defaultGoogleImageDeps = {
   createGoogleClient: (opts) => createGoogleGenerativeAI2(opts),
   runTextGeneration: (opts) => generateText(opts)
 };
-var causeChainNodeSchema = z21.object({
-  message: z21.string().optional(),
-  cause: z21.unknown().optional()
+var causeChainNodeSchema = z23.object({
+  message: z23.string().optional(),
+  cause: z23.unknown().optional()
 });
 function extractBlockReason(cause) {
   let current = cause;
@@ -12076,7 +12898,7 @@ function createGoogleImageAdapter(deps = defaultGoogleImageDeps) {
 var googleImageAdapter = createGoogleImageAdapter();
 
 // src/adapters/higgsfield.ts
-import { z as z22 } from "zod";
+import { z as z24 } from "zod";
 
 // src/adapters/higgsfield-motions.ts
 var MOTION_MAP = {
@@ -12295,14 +13117,14 @@ function klingEndpointFields(providerModelId) {
   const path = (providerModelId.startsWith("/") ? providerModelId.slice(1) : providerModelId).toLowerCase();
   return KLING_ENDPOINT_FIELDS.get(path) ?? UNLISTED_KLING_FIELDS;
 }
-var klingCreateSchema = z22.object({ status_url: z22.string() });
-var klingStatusSchema = z22.object({
-  status: z22.string().optional(),
-  video: z22.object({ url: z22.string().optional() }).optional(),
+var klingCreateSchema = z24.object({ status_url: z24.string() });
+var klingStatusSchema = z24.object({
+  status: z24.string().optional(),
+  video: z24.object({ url: z24.string().optional() }).optional(),
   error: JsonValueSchema.optional()
 });
-var errorMessageSchema = z22.object({ message: z22.string().optional() });
-var textValueSchema = z22.string();
+var errorMessageSchema = z24.object({ message: z24.string().optional() });
+var textValueSchema = z24.string();
 function klingErrorDetail(error) {
   if (error === void 0) return "unknown_error";
   const asText = textValueSchema.safeParse(error);
@@ -12458,8 +13280,8 @@ async function generateKlingVideo(req, ctx) {
     }
   };
 }
-var dopMotionOptionsSchema = z22.object({
-  modelkit: z22.object({ motion: z22.string().optional() }).optional()
+var dopMotionOptionsSchema = z24.object({
+  modelkit: z24.object({ motion: z24.string().optional() }).optional()
 });
 function dopMotionId(ctx) {
   const parsed = dopMotionOptionsSchema.safeParse(ctx.model.providerOptions);
@@ -12475,7 +13297,7 @@ function dopMotionId(ctx) {
     });
   return id;
 }
-var jsonRecordSchema = z22.record(z22.string(), JsonValueSchema);
+var jsonRecordSchema = z24.record(z24.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) {
@@ -12503,8 +13325,8 @@ function dopUrl(body) {
   }
   return void 0;
 }
-var dopCreateSchema = z22.object({ id: z22.string() });
-var dopStatusSchema = z22.object({ status: z22.string().optional() });
+var dopCreateSchema = z24.object({ id: z24.string() });
+var dopStatusSchema = z24.object({ status: z24.string().optional() });
 async function generateDopVideo(req, ctx) {
   const firstFrame = req.firstFrame ? refToUrl(req.firstFrame) : void 0;
   if (!firstFrame) {
@@ -12632,7 +13454,7 @@ var higgsfieldAdapter = {
 
 // src/adapters/openai-image.ts
 import OpenAI from "openai";
-import { z as z23 } from "zod";
+import { z as z25 } from "zod";
 var MAX_EDIT_REFERENCES = 16;
 function aspectRatioToSize(ratio, tier) {
   const TIER_LONG_EDGE = {
@@ -12715,9 +13537,9 @@ function toProviderError2(cause, ctx) {
     ctx.model.id
   );
 }
-var openaiUsageSchema = z23.object({
-  input_tokens: z23.number().optional(),
-  output_tokens: z23.number().optional()
+var openaiUsageSchema = z25.object({
+  input_tokens: z25.number().optional(),
+  output_tokens: z25.number().optional()
 });
 var openaiImageAdapter = {
   id: "openai-image",
@@ -13129,13 +13951,13 @@ var prodiaAdapter = {
 import Replicate from "replicate";
 
 // src/adapters/replicate-http.ts
-import { z as z24 } from "zod";
-var predictionSchema = z24.object({
-  id: z24.string(),
-  status: z24.string(),
+import { z as z26 } from "zod";
+var predictionSchema = z26.object({
+  id: z26.string(),
+  status: z26.string(),
   output: JsonValueSchema.optional(),
   error: JsonValueSchema.optional(),
-  metrics: z24.object({ predict_time: z24.number().optional() }).optional()
+  metrics: z26.object({ predict_time: z26.number().optional() }).optional()
 });
 function createReplicateHttpClient(opts) {
   async function request(path, body, signal) {
@@ -13186,7 +14008,7 @@ function createReplicateHttpClient(opts) {
 }
 
 // src/adapters/replicate.ts
-import { z as z25 } from "zod";
+import { z as z27 } from "zod";
 var POLL_INTERVAL_MS = 1e3;
 var POLL_TIMEOUT_MS = 15 * 6e4;
 var defaultReplicateDeps = {
@@ -13226,8 +14048,8 @@ function route(providerModelId) {
   if (!providerModelId.includes("/")) return { version: providerModelId };
   return { model: providerModelId };
 }
-var replicateResponseStatusSchema = z25.object({
-  response: z25.object({ status: z25.number() }).partial()
+var replicateResponseStatusSchema = z27.object({
+  response: z27.object({ status: z27.number() }).partial()
 });
 function replicateError(cause, ctx) {
   if (isModelKitError(cause)) return cause;
@@ -13236,10 +14058,6 @@ function replicateError(cause, ctx) {
   const status = info.status ?? (nested.success ? nested.data.response?.status : void 0);
   return classifyThrown("replicate", cause, ctx.model.id, { status, body: info.body });
 }
-function baseModelId(providerModelId) {
-  const colon = providerModelId.indexOf(":");
-  return colon === -1 ? providerModelId : providerModelId.slice(0, colon);
-}
 function predictionErrorBody(cause) {
   const parsed = JsonValueSchema.safeParse(cause);
   if (parsed.success) return parsed.data;
@@ -13254,7 +14072,7 @@ function isUrlFn(value) {
 function extractOutputUrl(output) {
   const root = Array.isArray(output) ? output[0] : output;
   if (root === void 0) throw noOutput();
-  const asString = z25.string().safeParse(root);
+  const asString = z27.string().safeParse(root);
   if (asString.success && asString.data) return asString.data;
   if (root instanceof URL) return root.href;
   if (isObjectOutput(root)) {
@@ -13263,15 +14081,15 @@ function extractOutputUrl(output) {
       if (urlValue !== void 0 && isUrlFn(urlValue)) {
         const called = urlValue();
         if (called instanceof URL) return called.href;
-        const calledString = z25.string().safeParse(called);
+        const calledString = z27.string().safeParse(called);
         if (calledString.success && calledString.data) return calledString.data;
       } else {
-        const direct = z25.string().safeParse(urlValue);
+        const direct = z27.string().safeParse(urlValue);
         if (direct.success && direct.data) return direct.data;
       }
     }
     if ("default" in root) {
-      const fallback = z25.string().safeParse(root.default);
+      const fallback = z27.string().safeParse(root.default);
       if (fallback.success && fallback.data) return fallback.data;
     }
   }
@@ -13332,7 +14150,7 @@ async function runPrediction(ctx, input, deps) {
     }
     return void 0;
   }, pollOpts);
-  const predictTime = z25.number().safeParse(done.metrics?.predict_time);
+  const predictTime = z27.number().safeParse(done.metrics?.predict_time);
   if (done.output === void 0) throw noOutput();
   return {
     url: extractOutputUrl(done.output),
@@ -13393,17 +14211,7 @@ var REPLICATE_IMAGE_KINDS = {
   "qwen-edit-apps/qwen-image-edit-plus-lora-skin": "qwen-edit"
 };
 function imageKind(providerModelId) {
-  return REPLICATE_IMAGE_KINDS[baseModelId(providerModelId)] ?? "generic";
-}
-var REPLICATE_VIDEO_KINDS = {
-  "kling-video/v2.5-turbo/pro/image-to-video": "kling",
-  "kling-video/v3.0/pro/image-to-video": "kling",
-  "kwaivgi/kling-v3-video": "kling",
-  "kwaivgi/kling-v3-omni-video": "kling-omni",
-  "minimax/hailuo-02": "hailuo"
-};
-function videoKind(providerModelId) {
-  return REPLICATE_VIDEO_KINDS[baseModelId(providerModelId)];
+  return REPLICATE_IMAGE_KINDS[replicateBaseModelId(providerModelId)] ?? "generic";
 }
 function isReplicateVideoKnown(providerModelId) {
   return videoKind(providerModelId) !== void 0;
@@ -13414,7 +14222,7 @@ var REPLICATE_AUDIO_KINDS = {
   "google/lyria-2": "lyria"
 };
 function audioKind(providerModelId) {
-  return REPLICATE_AUDIO_KINDS[baseModelId(providerModelId)];
+  return REPLICATE_AUDIO_KINDS[replicateBaseModelId(providerModelId)];
 }
 function isReplicateAudioKnown(providerModelId) {
   return audioKind(providerModelId) !== void 0;
@@ -13618,14 +14426,6 @@ function replicateVideoResolution(providerModelId, req) {
   if (kind === "hailuo") return hailuoResolution(req);
   return req.resolution;
 }
-var KLING_TIERS = [
-  { mode: "standard", resolution: "720p" },
-  { mode: "pro", resolution: "1080p" },
-  { mode: "4k", resolution: "4k" }
-];
-function klingTier(req) {
-  return KLING_TIERS.find((tier) => tier.resolution === req.resolution) ?? KLING_TIERS.find((tier) => tier.mode === req.mode) ?? KLING_TIERS[0];
-}
 function klingOmniInput(req) {
   const input = {
     prompt: req.prompt,
@@ -13703,7 +14503,7 @@ async function generateReplicateVideo(req, ctx, deps) {
       throw replicateError(cause, ctx);
     }
     if (current.status === "succeeded") {
-      const predictTime = z25.number().safeParse(current.metrics?.predict_time);
+      const predictTime = z27.number().safeParse(current.metrics?.predict_time);
       if (current.output === void 0) throw noOutput();
       return {
         url: extractOutputUrl(current.output),
@@ -13845,7 +14645,7 @@ async function generateReplicateAudio(req, ctx, deps) {
 // src/adapters/xai-video.ts
 import { experimental_generateVideo } from "ai";
 import { createXai as createXai2 } from "@ai-sdk/xai";
-import { z as z26 } from "zod";
+import { z as z28 } from "zod";
 var POLL_INTERVAL_MS2 = 1e4;
 var POLL_TIMEOUT_MS2 = 15 * 6e4;
 var defaultXaiDeps = {
@@ -13858,8 +14658,8 @@ function createXaiVideoAdapter(deps = defaultXaiDeps) {
   };
 }
 var xaiVideoAdapter = createXaiVideoAdapter();
-var xaiResponseStatusSchema = z26.object({
-  response: z26.object({ status: z26.number() }).partial()
+var xaiResponseStatusSchema = z28.object({
+  response: z28.object({ status: z28.number() }).partial()
 });
 function xaiError(cause, ctx) {
   const info = describeThrown(cause);
@@ -13867,12 +14667,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 = z26.object({
+var xaiMetaSchema = z28.object({
   videoUrl: JsonValueSchema.optional(),
   costInUsdTicks: JsonValueSchema.optional(),
   duration: JsonValueSchema.optional()
 });
-var xaiProviderMetadataSchema = z26.object({ xai: xaiMetaSchema });
+var xaiProviderMetadataSchema = z28.object({ xai: xaiMetaSchema });
 function metaOf(result) {
   const parsed = xaiProviderMetadataSchema.partial().safeParse(result.providerMetadata);
   if (!parsed.success) return {};
@@ -13988,7 +14788,7 @@ async function mapResult(ctx, req, result) {
     };
   }
   const meta = metaOf(result);
-  const videoUrl = z26.string().safeParse(meta.videoUrl);
+  const videoUrl = z28.string().safeParse(meta.videoUrl);
   if (videoUrl.success && videoUrl.data) {
     const res = await ctx.fetch(videoUrl.data);
     if (!res.ok) {
@@ -14011,7 +14811,7 @@ async function mapResult(ctx, req, result) {
   });
 }
 function usage2(ctx, req, meta) {
-  const costTicks = z26.number().safeParse(meta.costInUsdTicks);
+  const costTicks = z28.number().safeParse(meta.costInUsdTicks);
   const cost = costTicks.success ? costTicks.data / 1e10 : void 0;
   const event = {
     model: ctx.model.id,
@@ -14063,10 +14863,10 @@ var DEFAULT_ADAPTERS = {
 };
 
 // src/catalog/data-only.ts
-function hasValidInputSpec(row) {
-  const raw = row.providerOptions?.["modelkit"]?.["inputSpec"];
+function hasValidInputSpec(row2) {
+  const raw = row2.providerOptions?.["modelkit"]?.["inputSpec"];
   if (raw === void 0) return false;
-  return validateInputSpec(raw, row).ok;
+  return validateInputSpec(raw, row2).ok;
 }
 function assertNever(value) {
   throw new Error(`Unhandled adapter: ${String(value)}`);
@@ -14084,6 +14884,7 @@ function adapterServesType(adapter, type) {
   if (type === "lipsync") return adapter.lipsync !== void 0;
   if (type === "transcription") return adapter.transcribe !== void 0;
   if (type === "video-tool") return adapter.submitVideoTool !== void 0;
+  if (type === "model3d") return adapter.submitModel3d !== void 0;
   return adapter.languageModel !== void 0;
 }
 var FAL_NODE_TYPES = /* @__PURE__ */ new Set([
@@ -14095,18 +14896,18 @@ var FAL_NODE_TYPES = /* @__PURE__ */ new Set([
   "transcription",
   "mask"
 ]);
-function dataOnlyCapable(row) {
-  const adapter = DEFAULT_ADAPTERS[row.adapter];
-  if (!adapterServesType(adapter, row.type)) {
-    return { ok: false, reason: `${row.adapter} cannot serve ${row.type} rows` };
+function dataOnlyCapable(row2) {
+  const adapter = DEFAULT_ADAPTERS[row2.adapter];
+  if (!adapterServesType(adapter, row2.type)) {
+    return { ok: false, reason: `${row2.adapter} cannot serve ${row2.type} rows` };
   }
-  if (FAL_NODE_TYPES.has(row.type) && row.adapter !== "fal") {
-    return { ok: false, reason: `only fal serves ${row.type} rows` };
+  if (FAL_NODE_TYPES.has(row2.type) && row2.adapter !== "fal") {
+    return { ok: false, reason: `only fal serves ${row2.type} rows` };
   }
-  switch (row.adapter) {
+  switch (row2.adapter) {
     case "ai-sdk-text": {
       try {
-        textProviderOf(row);
+        textProviderOf(row2);
         return { ok: true };
       } catch {
         return {
@@ -14124,14 +14925,14 @@ function dataOnlyCapable(row) {
       return { ok: true };
     }
     case "google-genai": {
-      if (row.type === "video") {
-        return isGoogleGenaiVideoKnown(row.providerModelId) ? { ok: true } : { ok: false, reason: "google-genai video needs a veo- or gemini-omni id" };
+      if (row2.type === "video") {
+        return isGoogleGenaiVideoKnown(row2.providerModelId) ? { ok: true } : { ok: false, reason: "google-genai video needs a veo- or gemini-omni id" };
       }
-      return isGoogleGenaiAudioKnown(row.providerModelId) ? { ok: true } : { ok: false, reason: "google-genai audio needs a lyria- id" };
+      return isGoogleGenaiAudioKnown(row2.providerModelId) ? { ok: true } : { ok: false, reason: "google-genai audio needs a lyria- id" };
     }
     case "replicate": {
-      if (row.type === "video") {
-        if (isReplicateVideoKnown(row.providerModelId) || hasValidInputSpec(row)) {
+      if (row2.type === "video") {
+        if (isReplicateVideoKnown(row2.providerModelId) || hasValidInputSpec(row2)) {
           return { ok: true };
         }
         return {
@@ -14139,8 +14940,8 @@ function dataOnlyCapable(row) {
           reason: "replicate video needs a known kind or a valid inputSpec"
         };
       }
-      if (row.type === "audio") {
-        if (isReplicateAudioKnown(row.providerModelId) || hasValidInputSpec(row)) {
+      if (row2.type === "audio") {
+        if (isReplicateAudioKnown(row2.providerModelId) || hasValidInputSpec(row2)) {
           return { ok: true };
         }
         return {
@@ -14151,31 +14952,31 @@ function dataOnlyCapable(row) {
       return { ok: true };
     }
     case "fal": {
-      if (row.type === "video") {
-        return isFalVideoKnown(row.providerModelId) ? { ok: true } : { ok: false, reason: "fal video needs an id from a fal video family" };
+      if (row2.type === "video") {
+        return isFalVideoKnown(row2.providerModelId) ? { ok: true } : { ok: false, reason: "fal video needs an id from a fal video family" };
       }
-      if (row.type === "mask") {
-        return row.providerModelId === SAM3_IMAGE ? { ok: true } : { ok: false, reason: `fal maps mask rows only to ${SAM3_IMAGE}` };
+      if (row2.type === "mask") {
+        return row2.providerModelId === SAM3_IMAGE ? { ok: true } : { ok: false, reason: `fal maps mask rows only to ${SAM3_IMAGE}` };
       }
-      if (row.type === "video-tool" && row.constraints.tool?.kind === "subtitles") {
-        return row.providerModelId === VEED_SUBTITLES2 ? { ok: true } : { ok: false, reason: `fal maps subtitles only to ${VEED_SUBTITLES2}` };
+      if (row2.type === "video-tool" && row2.constraints.tool?.kind === "subtitles") {
+        return row2.providerModelId === VEED_SUBTITLES2 ? { ok: true } : { ok: false, reason: `fal maps subtitles only to ${VEED_SUBTITLES2}` };
       }
-      if (FAL_MEDIA_TYPES.has(row.type)) {
-        return isFalMediaKnown(row.type, row.providerModelId) ? { ok: true } : { ok: false, reason: `fal has no ${row.type} mapping for this id` };
+      if (FAL_MEDIA_TYPES.has(row2.type)) {
+        return isFalMediaKnown(row2.type, row2.providerModelId) ? { ok: true } : { ok: false, reason: `fal has no ${row2.type} mapping for this id` };
       }
       return { ok: true };
     }
     case "prodia": {
-      return isProdiaCapable(row.providerModelId) ? { ok: true } : { ok: false, reason: "prodia has no job mapping for this id" };
+      return isProdiaCapable(row2.providerModelId) ? { ok: true } : { ok: false, reason: "prodia has no job mapping for this id" };
     }
     case "higgsfield": {
-      return isHiggsfieldCapable(row.providerModelId) ? { ok: true } : {
+      return isHiggsfieldCapable(row2.providerModelId) ? { ok: true } : {
         ok: false,
         reason: "higgsfield providerModelId must be a platform path, not a URL"
       };
     }
     default: {
-      return assertNever(row.adapter);
+      return assertNever(row2.adapter);
     }
   }
 }
@@ -14193,22 +14994,22 @@ var liveState = store[KEY] ??= {
 var liveCatalog = liveState.catalog;
 
 // src/catalog/load.ts
-import { z as z27 } from "zod";
+import { z as z29 } from "zod";
 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 };
 }
-var EnvelopeSchema = z27.object({
-  rows: z27.array(JsonValueSchema),
-  revision: z27.string().optional()
+var EnvelopeSchema = z29.object({
+  rows: z29.array(JsonValueSchema),
+  revision: z29.string().optional()
 });
 function dropReason(path, message) {
   return path.length === 0 ? message : `${path.map((part) => String(part)).join(".")} ${message}`;
 }
 function rowId(raw) {
-  const parsed = z27.object({ id: z27.string().min(1) }).loose().safeParse(raw);
+  const parsed = z29.object({ id: z29.string().min(1) }).loose().safeParse(raw);
   if (!parsed.success) return "?";
   return parsed.data.id;
 }
@@ -14224,22 +15025,22 @@ function quarantine(rawRows, logger) {
       dropped += 1;
       continue;
     }
-    const row = parsed.data;
-    const inputSpecRaw = row.providerOptions?.["modelkit"]?.["inputSpec"];
+    const row2 = parsed.data;
+    const inputSpecRaw = row2.providerOptions?.["modelkit"]?.["inputSpec"];
     if (inputSpecRaw !== void 0) {
-      const result = validateInputSpec(inputSpecRaw, row);
+      const result = validateInputSpec(inputSpecRaw, row2);
       if (!result.ok) {
         const first = result.issues[0];
         const detail = first ? dropReason(first.path, first.message) : "invalid inputSpec";
         logger.warn(
-          `[modelkit] catalog row ${row.id} has an invalid providerOptions.modelkit.inputSpec: ${detail}; calls fail until it is fixed`
+          `[modelkit] catalog row ${row2.id} has an invalid providerOptions.modelkit.inputSpec: ${detail}; calls fail until it is fixed`
         );
       }
     }
-    const normalised = normaliseConventions(row);
+    const normalised = normaliseConventions(row2);
     if (normalised.invalidKeys.length > 0) {
       logger.warn(
-        `[modelkit] catalog row ${row.id} has an invalid ${normalised.invalidKeys.join(", ")}; read as not set`
+        `[modelkit] catalog row ${row2.id} has an invalid ${normalised.invalidKeys.join(", ")}; read as not set`
       );
     }
     valid.push(normalised.row);
@@ -14253,10 +15054,10 @@ function quarantine(rawRows, logger) {
       if (!firstByIndex.has(issue.index)) firstByIndex.set(issue.index, issue);
     }
     for (const [index, issue] of [...firstByIndex.entries()].sort((a, b) => a[0] - b[0])) {
-      const row = kept[index];
-      if (!row) continue;
+      const row2 = kept[index];
+      if (!row2) continue;
       logger.warn(
-        `[modelkit] catalog row dropped id=${row.id} reason=${String(issue.path[0] ?? "")} ${issue.message}`
+        `[modelkit] catalog row dropped id=${row2.id} reason=${String(issue.path[0] ?? "")} ${issue.message}`
       );
     }
     const dropSet = new Set(firstByIndex.keys());
@@ -14852,8 +15653,10 @@ function resolveVideoOptions(model, request, onUnsupported = "error") {
     warnings
   );
   if (aspectRatio !== void 0) merged.aspectRatio = aspectRatio;
+  fillReplicateKlingResolution(model, merged);
   const resolution = resolveVideoResolution(merged.resolution, model, onUnsupported, warnings);
   if (resolution !== void 0) merged.resolution = resolution;
+  if (isReplicateKling(model)) delete merged.mode;
   const duration = resolveDuration(
     merged.durationSeconds,
     c.durations,
@@ -14956,16 +15759,16 @@ function resolveVideoOptions(model, request, onUnsupported = "error") {
 }
 function checkVideoRequired(model, req) {
   const c = model.constraints;
-  const present = (input) => input === "references" ? compact(req.referenceImages).length + compact(req.referenceVideos).length + compact(req.referenceAudios).length > 0 : input !== "sourceAudio" && req[input] !== void 0;
+  const present2 = (input) => input === "references" ? compact(req.referenceImages).length + compact(req.referenceVideos).length + compact(req.referenceAudios).length > 0 : input !== "sourceAudio" && req[input] !== void 0;
   for (const input of c.requires ?? []) {
-    if (!present(input))
+    if (!present2(input))
       throw new ModelKitError({
         code: "missing_input",
         message: `${model.id} requires ${input}`,
         model: model.id
       });
   }
-  if (c.requiresOneOf && !c.requiresOneOf.some(present)) {
+  if (c.requiresOneOf && !c.requiresOneOf.some(present2)) {
     throw new ModelKitError({
       code: "missing_input",
       message: `${model.id} requires one of: ${c.requiresOneOf.join(", ")}`,
@@ -15013,8 +15816,8 @@ function resolveAudioOptions(model, request, onUnsupported = "error") {
   if (references.length > 0) merged.references = references;
   else delete merged.references;
   for (const input of c.requires ?? []) {
-    const present = input === "references" ? references.length > 0 : input === "sourceVideo" && merged.sourceVideo !== void 0;
-    if (!present)
+    const present2 = input === "references" ? references.length > 0 : input === "sourceVideo" && merged.sourceVideo !== void 0;
+    if (!present2)
       throw new ModelKitError({
         code: "missing_input",
         message: `${model.id} requires ${input}`,
@@ -15068,12 +15871,12 @@ function unsupported3(model, message) {
     model: model.id
   });
 }
-function checkRequired(model, present) {
+function checkRequired(model, present2) {
   for (const input of model.constraints.requires ?? []) {
-    if (present[input] !== true) throw missing2(model, input);
+    if (present2[input] !== true) throw missing2(model, input);
   }
   const oneOf = model.constraints.requiresOneOf;
-  if (oneOf !== void 0 && !oneOf.some((input) => present[input] === true)) {
+  if (oneOf !== void 0 && !oneOf.some((input) => present2[input] === true)) {
     throw missing2(model, `one of ${oneOf.join(", ")}`);
   }
 }
@@ -15335,7 +16138,7 @@ function keysFromEnv(env, prefix = "") {
 
 // src/text.ts
 import "ai";
-import { z as z28 } from "zod";
+import { z as z30 } from "zod";
 function mergeTextProviderOptions(catalog, caller) {
   const merged = {};
   const catalogOptions = catalog.providerOptions ?? {};
@@ -15374,8 +16177,8 @@ function passthroughTextModel(model) {
     pricingKind: "token"
   };
 }
-var perplexityCostSchema = z28.object({
-  perplexity: z28.object({ cost: z28.object({ totalCost: z28.number().finite().nonnegative() }) })
+var perplexityCostSchema = z30.object({
+  perplexity: z30.object({ cost: z30.object({ totalCost: z30.number().finite().nonnegative() }) })
 });
 function reportedCostUsd(metadata) {
   const parsed = perplexityCostSchema.safeParse(metadata);
@@ -15455,7 +16258,7 @@ import {
   streamObject as aiStreamObject2,
   streamText as aiStreamText2
 } from "ai";
-import { z as z29 } from "zod";
+import { z as z31 } from "zod";
 
 // src/generated-image.ts
 function toGeneratedImage(image) {
@@ -15482,8 +16285,8 @@ function isAnthropicTransport(value) {
   return ANTHROPIC_TRANSPORTS.some((transport) => transport === value);
 }
 function preferredAnthropicTransport(model, routing) {
-  const row = model.providerOptions?.["modelkit"]?.["transport"];
-  if (isAnthropicTransport(row)) return row;
+  const row2 = model.providerOptions?.["modelkit"]?.["transport"];
+  if (isAnthropicTransport(row2)) return row2;
   return routing.anthropic ?? "direct";
 }
 function resolveAnthropicTransport(model, config, tier, warn) {
@@ -15510,6 +16313,85 @@ function textUsageProvider(model, transport) {
   return transport === "bedrock" ? BEDROCK_USAGE_PROVIDER : textProviderOf(model);
 }
 
+// src/provider-job.ts
+var VIDEO_TOOL_JOB = {
+  type: "video-tool",
+  noun: "a video tool",
+  plural: "video tools",
+  methods: (a) => ({
+    submit: a.submitVideoTool?.bind(a),
+    status: a.videoToolStatus?.bind(a),
+    result: a.videoToolResult?.bind(a),
+    cancel: a.cancelVideoTool?.bind(a)
+  })
+};
+var MODEL3D_JOB = {
+  type: "model3d",
+  noun: "a 3D model",
+  plural: "3D models",
+  methods: (a) => ({
+    submit: a.submitModel3d?.bind(a),
+    status: a.model3dStatus?.bind(a),
+    result: a.model3dResult?.bind(a),
+    cancel: a.cancelModel3d?.bind(a)
+  })
+};
+function providerJobMethods(kind, deps) {
+  function target(modelId, call) {
+    mediaRetryOptions(call);
+    const model = deps.catalog.require(modelId);
+    if (model.type !== kind.type)
+      throw new ModelKitError({
+        code: "unsupported_option",
+        message: `${model.id} is not ${kind.noun}`,
+        model: model.id
+      });
+    const { adapter, ctx } = deps.context(model, call);
+    return { methods: kind.methods(adapter), adapter, ctx };
+  }
+  function missing3(adapter, model) {
+    return new ModelKitError({
+      code: "unsupported_option",
+      message: `${adapter.id} has no ${kind.plural}`,
+      model: model.id
+    });
+  }
+  return {
+    async submit(req, call = {}) {
+      const { webhookUrl, ...rest } = call;
+      const { methods, adapter, ctx } = target(req.model, rest);
+      if (!methods.submit) throw missing3(adapter, ctx.model);
+      const submittedAt = Date.now();
+      const submission = await methods.submit(
+        req,
+        ctx,
+        webhookUrl !== void 0 ? { webhookUrl } : {}
+      );
+      return { ...submission, submittedAt };
+    },
+    async status(sub, call = {}) {
+      const { methods, adapter, ctx } = target(sub.model, call);
+      if (!methods.status) throw missing3(adapter, ctx.model);
+      return methods.status(sub, ctx);
+    },
+    async result(sub, call = {}) {
+      const { webhook, ...rest } = call;
+      const { methods, adapter, ctx } = target(sub.model, rest);
+      if (!methods.result) throw missing3(adapter, ctx.model);
+      const result = await methods.result(sub, ctx, webhook);
+      const base = { ...result.usage, model: ctx.model.id, unit: ctx.model.usage.unit };
+      const usage3 = sub.submittedAt === void 0 ? base : deps.timed(base, sub.submittedAt);
+      await deps.emit(usage3);
+      return { ...result, usage: usage3 };
+    },
+    async cancel(sub, call = {}) {
+      const { methods, adapter, ctx } = target(sub.model, call);
+      if (!methods.cancel) throw missing3(adapter, ctx.model);
+      return methods.cancel(sub, ctx);
+    }
+  };
+}
+
 // src/resolve-call.ts
 var MEDIA_METHODS = {
   text: [],
@@ -15525,7 +16407,10 @@ var MEDIA_METHODS = {
   lipsync: ["lipsync"],
   dubbing: ["dub"],
   transcription: ["transcribe"],
-  "video-tool": ["submitVideoTool"]
+  "video-tool": ["submitVideoTool"],
+  // 3D jobs run through submitModel3d, which checks the row type itself; their preflight
+  // is model3dInputRefusal, not resolveOptions.
+  model3d: []
 };
 var METHOD_NOUN = {
   generateImage: "an image model",
@@ -15722,10 +16607,10 @@ function textAbortOptions(sdk, context) {
   if (abortSignal) return { abortSignal };
   return {};
 }
-var catalogId = z29.string();
-var exactSize = z29.templateLiteral([z29.number(), "x", z29.number()]);
-var sdkRatio = z29.templateLiteral([z29.number(), ":", z29.number()]);
-var sizeTier = z29.enum(["512", "1K", "2K", "4K"]);
+var catalogId = z31.string();
+var exactSize = z31.templateLiteral([z31.number(), "x", z31.number()]);
+var sdkRatio = z31.templateLiteral([z31.number(), ":", z31.number()]);
+var sizeTier = z31.enum(["512", "1K", "2K", "4K"]);
 function isCatalogId(model) {
   return catalogId.safeParse(model).success;
 }
@@ -15835,19 +16720,14 @@ function createModelKit(config, adapters) {
     if (call.signal) ctx.signal = call.signal;
     return { adapter, ctx };
   }
-  function videoToolTarget(modelId, call) {
-    mediaRetryOptions(call);
-    const model = catalog.require(modelId);
-    assertMethod(model, "submitVideoTool");
-    return context(model, call, []);
-  }
-  function noVideoTools(adapter, model) {
-    return new ModelKitError({
-      code: "unsupported_option",
-      message: `${adapter.id} has no video tools`,
-      model: model.id
-    });
-  }
+  const jobDeps = {
+    catalog,
+    context: (model, call) => context(model, call, []),
+    timed,
+    emit
+  };
+  const videoToolJobs = providerJobMethods(VIDEO_TOOL_JOB, jobDeps);
+  const model3dJobs = providerJobMethods(MODEL3D_JOB, jobDeps);
   function timed(event, startedAt) {
     if (event.latencyMs !== void 0) return event;
     return { ...event, latencyMs: Math.max(0, Date.now() - startedAt) };
@@ -15863,8 +16743,8 @@ function createModelKit(config, adapters) {
     }
   }
   function withRowUnit(event) {
-    const row = catalog.get(event.model);
-    return row ? { ...event, unit: row.usage.unit } : event;
+    const row2 = catalog.get(event.model);
+    return row2 ? { ...event, unit: row2.usage.unit } : event;
   }
   function textTarget(model, call) {
     if (!isCatalogId(model)) {
@@ -16278,38 +17158,14 @@ function createModelKit(config, adapters) {
         usageProvider: provider
       };
     },
-    async submitVideoTool(req, call = {}) {
-      const { webhookUrl, ...rest } = call;
-      const { adapter, ctx } = videoToolTarget(req.model, rest);
-      if (!adapter.submitVideoTool) throw noVideoTools(adapter, ctx.model);
-      const submittedAt = Date.now();
-      const submission = await adapter.submitVideoTool(
-        req,
-        ctx,
-        webhookUrl !== void 0 ? { webhookUrl } : {}
-      );
-      return { ...submission, submittedAt };
-    },
-    async videoToolStatus(sub, call = {}) {
-      const { adapter, ctx } = videoToolTarget(sub.model, call);
-      if (!adapter.videoToolStatus) throw noVideoTools(adapter, ctx.model);
-      return adapter.videoToolStatus(sub, ctx);
-    },
-    async videoToolResult(sub, call = {}) {
-      const { webhook, ...rest } = call;
-      const { adapter, ctx } = videoToolTarget(sub.model, rest);
-      if (!adapter.videoToolResult) throw noVideoTools(adapter, ctx.model);
-      const result = await adapter.videoToolResult(sub, ctx, webhook);
-      const base = { ...result.usage, model: ctx.model.id, unit: ctx.model.usage.unit };
-      const usage3 = sub.submittedAt === void 0 ? base : timed(base, sub.submittedAt);
-      await emit(usage3);
-      return { ...result, usage: usage3 };
-    },
-    async cancelVideoTool(sub, call = {}) {
-      const { adapter, ctx } = videoToolTarget(sub.model, call);
-      if (!adapter.cancelVideoTool) throw noVideoTools(adapter, ctx.model);
-      return adapter.cancelVideoTool(sub, ctx);
-    },
+    submitVideoTool: videoToolJobs.submit,
+    videoToolStatus: videoToolJobs.status,
+    videoToolResult: videoToolJobs.result,
+    cancelVideoTool: videoToolJobs.cancel,
+    submitModel3d: model3dJobs.submit,
+    model3dStatus: model3dJobs.status,
+    model3dResult: model3dJobs.result,
+    cancelModel3d: model3dJobs.cancel,
     usageProvider(modelId, call = {}) {
       const entry = catalog.require(modelId);
       if (entry.type !== "text") return entry.adapter;
@@ -16456,6 +17312,8 @@ export {
   InputSpecSchema,
   JsonObjectSchema,
   JsonValueSchema,
+  MODEL3D_IMAGE_SLOTS,
+  MODEL3D_MODELS,
   MODELS,
   ModelKitError,
   SURFACES2 as SURFACES,
@@ -16498,6 +17356,14 @@ export {
   liveState,
   mergeTextProviderOptions,
   missingTierKeys,
+  model3dCall,
+  model3dConstraints,
+  model3dInputRefusal,
+  model3dPricingSku,
+  model3dResolution,
+  model3dSeedFits,
+  model3dSkus,
+  model3dTexture,
   nearestAspectRatio,
   normalizeExposure,
   openaiImageAdapter,