@shop-os/modelkit 0.7.3 → 0.7.6

package/dist/index.cjs

@@ -6467,14 +6467,14 @@ function xaiReferenceMode(model, req) {
   const takesLastFrame = (model.constraints.supports ?? []).includes("lastFrame");
   return (req.referenceImages ?? []).length > 0 || takesLastFrame && req.lastFrame !== void 0;
 }
-function applyXaiVideoRules(model, req, onUnsupported, warnings) {
-  if (model.adapter !== "xai-video" || req.resolution !== "1080p") return;
-  if (!xaiReferenceMode(model, req)) return;
+function xaiReferenceResolution(model, req, onUnsupported, warnings, provider) {
+  if (req.resolution !== "1080p" || !xaiReferenceMode(model, req)) return void 0;
   const message = xaiReferenceResolutionMessage(model.id);
   if (onUnsupported === "error") {
     throw new ModelKitError({
       code: "unsupported_option",
       message,
+      ...provider === void 0 ? {} : { provider },
       model: model.id,
       retryable: false
     });
@@ -6486,7 +6486,12 @@ function applyXaiVideoRules(model, req, onUnsupported, warnings) {
     to: XAI_REFERENCE_MAX_RESOLUTION,
     message
   });
-  req.resolution = XAI_REFERENCE_MAX_RESOLUTION;
+  return XAI_REFERENCE_MAX_RESOLUTION;
+}
+function applyXaiVideoRules(model, req, onUnsupported, warnings) {
+  if (model.adapter !== "xai-video") return;
+  const lowered = xaiReferenceResolution(model, req, onUnsupported, warnings);
+  if (lowered !== void 0) req.resolution = lowered;
 }
 function takesTargetAspectRatio(model) {
   const ratios = model.constraints.aspectRatios ?? [];
@@ -6687,6 +6692,161 @@ var MODEL3D_IMAGE_SLOTS = {
   ordered: ["image", "left", "back", "right"],
   unordered: ["image", "back", "left", "right", "top"]
 };
+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,
+    // generate_type
+    texture: { none: "Geometry", standard: "Normal" },
+    pbr: true,
+    seed: false,
+    textureRef: false,
+    resolutions: null
+  },
+  tripo: {
+    textPath: true,
+    views: ["none", "ordered"],
+    multiImage: true,
+    // texture_quality; null sends an untextured model.
+    texture: { none: null, standard: "standard", detailed: "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,
+    // The text endpoint's mode; the image endpoints take should_texture.
+    texture: { none: "preview", standard: "full" },
+    pbr: true,
+    seed: true,
+    textureRef: true,
+    resolutions: null
+  },
+  hi3d: {
+    textPath: false,
+    views: ["none", "named"],
+    multiImage: true,
+    // enable_texture
+    texture: { none: false, standard: true },
+    pbr: true,
+    seed: false,
+    textureRef: false,
+    resolutions: { quality: "2048quality", master: "2048master" }
+  },
+  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 (!Object.hasOwn(allowed, 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) : Object.hasOwn(allowed, option);
+      if (!ok)
+        add(["resolutions", "options"], `${spec.family} has no "${option}" resolution`);
+    }
+  }
+  return issues;
+}
 function model3dInputRefusal(spec, wired) {
   const top = spec.views === "unordered" && wired.top === true;
   const anyView = spec.views !== "none" && (wired.back || wired.left || wired.right || top);
@@ -7274,156 +7434,6 @@ var LanguageOptionSchema = import_zod3.z.looseObject({
   code: import_zod3.z.string().min(1),
   name: import_zod3.z.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 = import_zod3.z.looseObject({
   kind: import_zod3.z.enum(["upscale", "interpolate", "hdr", "bg-remove", "subtitles"]),
   upscaleFactor: RangeSchema.optional(),
@@ -10825,6 +10835,19 @@ function specOf(ctx) {
   return spec;
 }
 var present = (v) => v !== void 0 && v.length > 0;
+function wireValue(row2, values, option, what) {
+  const value = option !== void 0 && Object.hasOwn(values, option) ? values[option] : void 0;
+  if (value === void 0) {
+    throw new ModelKitError({
+      code: "unsupported_option",
+      message: `${row2.id} has no ${what} "${option ?? ""}" to send`,
+      provider: "fal",
+      model: row2.id,
+      retryable: false
+    });
+  }
+  return value;
+}
 function model3dCall(row2, spec, req) {
   const prompt = req.prompt?.trim() || void 0;
   const texture = model3dTexture(spec, req.texture);
@@ -10868,7 +10891,15 @@ function model3dCall(row2, spec, req) {
         }
       };
     case "hunyuan": {
-      const opts = { generate_type: textured ? "Normal" : "Geometry", enable_pbr: pbr };
+      const opts = {
+        generate_type: wireValue(
+          row2,
+          MODEL3D_FAMILY_RULES.hunyuan.texture,
+          texture,
+          "texture"
+        ),
+        enable_pbr: pbr
+      };
       if (!present(req.image)) {
         return {
           endpoint: endpoint(spec.endpoints.text),
@@ -10887,12 +10918,11 @@ function model3dCall(row2, spec, req) {
       };
     }
     case "tripo": {
+      const quality = wireValue(row2, MODEL3D_FAMILY_RULES.tripo.texture, texture, "texture");
       const opts = {
         texture: textured,
         pbr,
-        ...textured && {
-          texture_quality: texture === "detailed" ? "detailed" : "standard"
-        },
+        ...quality !== null && { texture_quality: quality },
         ...seed !== void 0 && { model_seed: seed }
       };
       if (!present(req.image)) {
@@ -10928,6 +10958,7 @@ function model3dCall(row2, spec, req) {
       };
     }
     case "meshy": {
+      const mode = wireValue(row2, MODEL3D_FAMILY_RULES.meshy.texture, texture, "texture");
       const texturePrompt = req.texturePrompt?.trim() || void 0;
       const opts = {
         enable_pbr: pbr,
@@ -10939,7 +10970,7 @@ function model3dCall(row2, spec, req) {
           endpoint: endpoint(spec.endpoints.text),
           input: {
             prompt: prompt ?? "",
-            mode: textured ? "full" : "preview",
+            mode,
             ...opts,
             ...seed !== void 0 && { seed }
           }
@@ -10955,8 +10986,18 @@ function model3dCall(row2, spec, req) {
     }
     case "hi3d": {
       const opts = {
-        resolution: resolution === "master" ? "2048master" : "2048quality",
-        enable_texture: textured,
+        resolution: wireValue(
+          row2,
+          MODEL3D_FAMILY_RULES.hi3d.resolutions,
+          resolution,
+          "resolution"
+        ),
+        enable_texture: wireValue(
+          row2,
+          MODEL3D_FAMILY_RULES.hi3d.texture,
+          texture,
+          "texture"
+        ),
         enable_pbr: pbr,
         export_format: "glb"
       };
@@ -15682,14 +15723,15 @@ async function generateXaiVideo(req, ctx, deps) {
     });
   }
   const refLimit = ctx.model.constraints.references?.images ?? SDK_REFERENCE_CAP;
-  const refUrls = (req.referenceImages ?? []).map(refToUrl).slice(0, refLimit);
+  const refs = (req.referenceImages ?? []).slice(0, refLimit);
+  const refUrls = refs.map(refToUrl);
   const takesLastFrame = (ctx.model.constraints.supports ?? []).includes("lastFrame");
   const lastFrame = takesLastFrame && req.lastFrame ? refToUrl(req.lastFrame) : void 0;
   const xaiOptions = {
     pollIntervalMs: POLL_INTERVAL_MS2,
     pollTimeoutMs: POLL_TIMEOUT_MS2
   };
-  const resolution = xaiResolution(req, ctx, refUrls.length > 0 || lastFrame !== void 0);
+  const resolution = xaiResolution(req, ctx, refs);
   if (resolution !== void 0) xaiOptions.resolution = resolution;
   const sent = resolution === void 0 ? req : { ...req, resolution };
   if (refUrls.length > SDK_REFERENCE_CAP) {
@@ -15816,27 +15858,17 @@ function usage2(ctx, req, meta) {
   if (req.resolution !== void 0) event.resolution = req.resolution;
   return event;
 }
-function xaiResolution(req, ctx, referenceMode) {
+function xaiResolution(req, ctx, sentRefs) {
   const requested = req.resolution;
   if (requested !== "480p" && requested !== "720p" && requested !== "1080p") return void 0;
-  if (!referenceMode || requested !== "1080p") return requested;
-  if ((ctx.call.onUnsupported ?? "error") === "error") {
-    throw new ModelKitError({
-      code: "unsupported_option",
-      message: xaiReferenceResolutionMessage(ctx.model.id),
-      provider: "xai-video",
-      model: ctx.model.id,
-      retryable: false
-    });
-  }
-  ctx.warnings.push({
-    code: "resolution_coerced",
-    field: "resolution",
-    from: requested,
-    to: XAI_REFERENCE_MAX_RESOLUTION,
-    message: xaiReferenceResolutionMessage(ctx.model.id)
-  });
-  return XAI_REFERENCE_MAX_RESOLUTION;
+  const lowered = xaiReferenceResolution(
+    ctx.model,
+    { ...req, referenceImages: sentRefs },
+    ctx.call.onUnsupported ?? "error",
+    ctx.warnings,
+    "xai-video"
+  );
+  return lowered ?? requested;
 }
 
 // src/adapters/index.ts