@doufunao123/asset-gateway 0.24.0 → 0.25.0

package/dist/index.js

@@ -15,7 +15,7 @@ import { AssetForgeError } from "@doufunao123/assetforge-sdk";
 
 // src/meta.ts
 var CLI_NAME = "asset-gateway";
-var CLI_VERSION = "0.24.0";
+var CLI_VERSION = "0.25.0";
 var CLI_DESCRIPTION = "Universal asset generation gateway CLI";
 var DEFAULT_GATEWAY_URL = "https://asset.origingame.dev";
 
@@ -989,16 +989,32 @@ function createGenerateCommand() {
     })
   );
   command.addCommand(
-    new Command3("model").description("Generate a 3D model with Meshy AI").option("--image <input>", "Reference image path or URL").option("--format <fmt>", "Output format: glb, fbx, obj, usdz, stl, 3mf", "glb").option("--prompt <text>", "Model description prompt").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--polycount <n>", "Target polygon count").option("--pbr", "Enable PBR textures").option("--hd-texture", "Request 4K texture output").option("--pose-mode <mode>", "Character pose mode: a-pose or t-pose").option("--auto-size", "Estimate real-world size automatically").option("--negative-prompt <text>", "Negative prompt").option("--multiview <inputs>", "Comma-separated multiview image paths or URLs").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command3("model").description(
+      "Generate a 3D model with Meshy AI. Default --quality=preview returns a single preview mesh (fast); --quality=full chains preview \u2192 refine \u2192 remesh to deliver a production-ready mesh."
+    ).option("--image <input>", "Reference image path or URL").option("--format <fmt>", "Output format: glb, fbx, obj, usdz, stl, 3mf", "glb").option("--prompt <text>", "Model description prompt").option(
+      "--quality <mode>",
+      "Pipeline mode: preview (single stage, ~30s) or full (chained: preview \u2192 refine \u2192 remesh, ~5-10min)"
+    ).option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--polycount <n>", "Target polygon count (full quality only)").option("--pbr", "Enable PBR textures").option("--hd-texture", "Request 4K texture output (requires --ai-model meshy-6)").option("--pose-mode <mode>", "Character pose mode: a-pose or t-pose").option("--auto-size", "Estimate real-world size automatically").option("--negative-prompt <text>", "Negative prompt").option("--multiview <inputs>", "Comma-separated multiview image paths or URLs").option("--output-dir <dir>", "Directory to save output", ".").option(
+      "--async",
+      "Submit asynchronously; return job_id immediately without waiting. Poll with: asset-gateway job status <id>"
+    ).action(async function(options) {
       try {
         assertHas3dInput(options.prompt, options.image, options.multiview);
+        if (options.hdTexture && options.aiModel && options.aiModel !== "meshy-6") {
+          throw new Error(
+            "--hd-texture requires --ai-model meshy-6 (got '" + options.aiModel + "'); preview would succeed but refine would 400 and waste credits"
+          );
+        }
         const ctx = createContext(this);
         const params = {};
         if (options.negativePrompt) params.negative_prompt = options.negativePrompt;
         if (options.multiview) {
           params.multiview = parseCommaSeparatedValues(options.multiview).map((value) => toInputFile(value)).filter((value) => Boolean(value));
         }
-        const data = await ctx.client.model3d(options.prompt ?? "", {
+        if (options.quality) {
+          params.model3d_quality = options.quality;
+        }
+        const sdkOptions = {
           input: toInputFile(options.image),
           format: options.format,
           ai_model: options.aiModel,
@@ -1008,7 +1024,19 @@ function createGenerateCommand() {
           pose_mode: options.poseMode,
           auto_size: options.autoSize ? true : void 0,
           params: Object.keys(params).length > 0 ? toJsonObject(params) : void 0
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.model3d(options.prompt ?? "", {
+            ...sdkOptions,
+            async: true
+          });
+          printSuccess("generate.model", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.model3d(
+          options.prompt ?? "",
+          sdkOptions
+        );
         const localPath = await saveOutput(data, "model3d", options.outputDir, options.format);
         if (localPath) data.local_path = localPath;
         printSuccess("generate.model", data, ctx);
@@ -1018,12 +1046,20 @@ function createGenerateCommand() {
     })
   );
   command.addCommand(
-    new Command3("character").description("Generate a fully processed 3D character with Meshy AI").option("--prompt <text>", "Character description prompt").option("--image <input>", "Reference image path or URL").option("--images <inputs>", "Comma-separated reference image paths or URLs").option("--format <fmt>", "Output format: glb, fbx, obj, usdz, stl, 3mf", "glb").option("--polycount <n>", "Target polygon count").option("--pbr", "Enable PBR textures").option("--hd-texture", "Request 4K texture output").option("--pose-mode <mode>", "Character pose mode: a-pose or t-pose").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--auto-size", "Estimate real-world size automatically").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command3("character").description("Generate a fully processed 3D character with Meshy AI (chained preview \u2192 refine \u2192 remesh \u2192 rig)").option("--prompt <text>", "Character description prompt").option("--image <input>", "Reference image path or URL").option("--images <inputs>", "Comma-separated reference image paths or URLs").option("--format <fmt>", "Output format: glb, fbx, obj, usdz, stl, 3mf", "glb").option("--polycount <n>", "Target polygon count").option("--pbr", "Enable PBR textures").option("--hd-texture", "Request 4K texture output (requires --ai-model meshy-6)").option("--pose-mode <mode>", "Character pose mode: a-pose or t-pose").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--auto-size", "Estimate real-world size automatically").option("--output-dir <dir>", "Directory to save output", ".").option(
+      "--async",
+      "Submit asynchronously; return job_id immediately without waiting. Poll with: asset-gateway job status <id>"
+    ).action(async function(options) {
       try {
         assertHas3dInput(options.prompt, options.image, options.images);
+        if (options.hdTexture && options.aiModel && options.aiModel !== "meshy-6") {
+          throw new Error(
+            "--hd-texture requires --ai-model meshy-6 (got '" + options.aiModel + "'); preview would succeed but refine would 400 and waste credits"
+          );
+        }
         const ctx = createContext(this);
         const images = parseCommaSeparatedValues(options.images).map((value) => toInputFile(value)).filter((value) => Boolean(value));
-        const data = await ctx.client.character(options.prompt ?? "", {
+        const sdkOptions = {
           input: toInputFile(options.image),
           images: images.length > 0 ? images : void 0,
           format: options.format,
@@ -1033,7 +1069,19 @@ function createGenerateCommand() {
           pose_mode: options.poseMode,
           ai_model: options.aiModel,
           auto_size: options.autoSize ? true : void 0
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.character(options.prompt ?? "", {
+            ...sdkOptions,
+            async: true
+          });
+          printSuccess("generate.character", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.character(
+          options.prompt ?? "",
+          sdkOptions
+        );
         const localPath = await saveOutput(data, "character", options.outputDir, options.format);
         if (localPath) data.local_path = localPath;
         printSuccess("generate.character", data, ctx);
@@ -1043,12 +1091,20 @@ function createGenerateCommand() {
     })
   );
   command.addCommand(
-    new Command3("prop").description("Generate a fully processed 3D prop with Meshy AI").option("--prompt <text>", "Prop description prompt").option("--image <input>", "Reference image path or URL").option("--images <inputs>", "Comma-separated reference image paths or URLs").option("--format <fmt>", "Output format: glb, fbx, obj, usdz, stl, 3mf", "glb").option("--polycount <n>", "Target polygon count").option("--pbr", "Enable PBR textures").option("--hd-texture", "Request 4K texture output").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--auto-size", "Estimate real-world size automatically").option("--texture-prompt <text>", "Optional texture prompt for the final material pass").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command3("prop").description("Generate a fully processed 3D prop with Meshy AI (chained preview \u2192 refine \u2192 remesh)").option("--prompt <text>", "Prop description prompt").option("--image <input>", "Reference image path or URL").option("--images <inputs>", "Comma-separated reference image paths or URLs").option("--format <fmt>", "Output format: glb, fbx, obj, usdz, stl, 3mf", "glb").option("--polycount <n>", "Target polygon count").option("--pbr", "Enable PBR textures").option("--hd-texture", "Request 4K texture output (requires --ai-model meshy-6)").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--auto-size", "Estimate real-world size automatically").option("--texture-prompt <text>", "Optional texture prompt for the final material pass").option("--output-dir <dir>", "Directory to save output", ".").option(
+      "--async",
+      "Submit asynchronously; return job_id immediately without waiting. Poll with: asset-gateway job status <id>"
+    ).action(async function(options) {
       try {
         assertHas3dInput(options.prompt, options.image, options.images);
+        if (options.hdTexture && options.aiModel && options.aiModel !== "meshy-6") {
+          throw new Error(
+            "--hd-texture requires --ai-model meshy-6 (got '" + options.aiModel + "'); preview would succeed but refine would 400 and waste credits"
+          );
+        }
         const ctx = createContext(this);
         const images = parseCommaSeparatedValues(options.images).map((value) => toInputFile(value)).filter((value) => Boolean(value));
-        const data = await ctx.client.prop(options.prompt ?? "", {
+        const sdkOptions = {
           input: toInputFile(options.image),
           images: images.length > 0 ? images : void 0,
           format: options.format,
@@ -1058,7 +1114,19 @@ function createGenerateCommand() {
           ai_model: options.aiModel,
           auto_size: options.autoSize ? true : void 0,
           texture_prompt: options.texturePrompt
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.prop(options.prompt ?? "", {
+            ...sdkOptions,
+            async: true
+          });
+          printSuccess("generate.prop", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.prop(
+          options.prompt ?? "",
+          sdkOptions
+        );
         const localPath = await saveOutput(data, "prop", options.outputDir, options.format);
         if (localPath) data.local_path = localPath;
         printSuccess("generate.prop", data, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doufunao123/asset-gateway",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Universal asset generation gateway CLI",
   "type": "module",
   "bin": {
@@ -27,7 +27,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@doufunao123/assetforge-sdk": "^0.10.0",
+    "@doufunao123/assetforge-sdk": "^0.11.0",
     "commander": "^13.1.0"
   },
   "devDependencies": {