@doufunao123/asset-gateway 0.24.0 → 0.25.1

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.1";
 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);
@@ -1734,7 +1802,13 @@ async function saveProcess3dOutput(data, operation, outputDir, format) {
 function createProcess3dCommand() {
   const command = new Command8("process3d").description("3D model post-processing via Meshy AI");
   command.addCommand(
-    new Command8("remesh").description("Remesh a model and optionally change format or polygon count").option("--task-id <id>", "Meshy task ID").option("--model-url <url>", "Model URL to remesh without an existing task").requiredOption("--format <fmt>", "Target format: glb, fbx, obj, usdz, stl, 3mf").option("--polycount <n>", "Target polygon count").option("--topology <type>", "Topology type: triangle or quad").option("--auto-size", "Estimate real-world size automatically").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command8("remesh").description("Remesh a model and optionally change format or polygon count").option("--task-id <id>", "Meshy task ID").option("--model-url <url>", "Model URL to remesh without an existing task").requiredOption("--format <fmt>", "Target format: glb, fbx, obj, usdz, stl, 3mf").option("--polycount <n>", "Target polygon count (Meshy target_polycount; result polycount may vary 1.5-2x)").option("--topology <type>", "Topology type: triangle or quad").option("--auto-size", "Estimate real-world size automatically (Meshy auto_size is unreliable on small objects)").option("--resize-height <meters>", "Resize the mesh so its bounding box height equals this many meters").option(
+      "--origin-at <point>",
+      "Move the origin: bottom, top, center, bottom-center, top-center"
+    ).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 {
         if (!options.taskId && !options.modelUrl) {
           throw new Error("Either --task-id or --model-url is required");
@@ -1744,9 +1818,29 @@ function createProcess3dCommand() {
           target_formats: [options.format]
         };
         if (options.modelUrl) params.model_url = options.modelUrl;
-        if (options.polycount) params.polycount = Number(options.polycount);
+        if (options.polycount) params.target_polycount = Number(options.polycount);
         if (options.topology) params.topology = options.topology;
         if (options.autoSize) params.auto_size = true;
+        if (options.resizeHeight !== void 0) {
+          const value = Number(options.resizeHeight);
+          if (!Number.isFinite(value)) {
+            throw new Error("--resize-height must be a number (meters)");
+          }
+          params.resize_height = value;
+        }
+        if (options.originAt) params.origin_at = options.originAt;
+        if (options.async) {
+          const ack = await ctx.client.process3d(
+            {
+              task_id: options.taskId ?? "",
+              operation: "remesh",
+              params: toJsonObject2(params)
+            },
+            { async: true }
+          );
+          printSuccess("process3d.remesh", ack, ctx);
+          return;
+        }
         const data = await ctx.client.process3d({
           task_id: options.taskId ?? "",
           operation: "remesh",
@@ -1761,8 +1855,16 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command8("retexture").description("Regenerate textures for an existing Meshy model").requiredOption("--task-id <id>", "Meshy task ID").option("--prompt <text>", "Text style prompt for the new material pass").option("--style-image <input>", "Texture style reference image URL or local file path").option("--pbr", "Enable PBR materials").option("--hd-texture", "Request 4K texture output").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command8("retexture").description("Regenerate textures for an existing Meshy model").requiredOption("--task-id <id>", "Meshy task ID").option("--prompt <text>", "Text style prompt for the new material pass").option("--style-image <input>", "Texture style reference image URL or local file path").option("--pbr", "Enable PBR materials").option("--hd-texture", "Request 4K texture output (requires --ai-model meshy-6)").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").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 {
+        if (options.hdTexture && options.aiModel && options.aiModel !== "meshy-6") {
+          throw new Error(
+            "--hd-texture requires --ai-model meshy-6 (got '" + options.aiModel + "')"
+          );
+        }
         const ctx = createContext(this);
         const params = {};
         if (options.prompt) params.text_style_prompt = options.prompt;
@@ -1770,11 +1872,17 @@ function createProcess3dCommand() {
         if (options.pbr) params.pbr = true;
         if (options.hdTexture) params.hd_texture = true;
         if (options.aiModel) params.ai_model = options.aiModel;
-        const data = await ctx.client.process3d({
+        const request = {
           task_id: options.taskId,
           operation: "retexture",
           params: toJsonObject2(params)
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.process3d(request, { async: true });
+          printSuccess("process3d.retexture", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.process3d(request);
         const localPath = await saveProcess3dOutput(data, "retexture", options.outputDir);
         if (localPath) data.local_path = localPath;
         printSuccess("process3d.retexture", data, ctx);
@@ -1784,7 +1892,10 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command8("rig").description("Rig a Meshy model for character animation").option("--task-id <id>", "Meshy task ID").option("--height <meters>", "Estimated character height in meters").option("--model-url <url>", "Model URL to rig without an existing task").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command8("rig").description("Rig a Meshy model for character animation").option("--task-id <id>", "Meshy task ID").option("--height <meters>", "Estimated character height in meters").option("--model-url <url>", "Model URL to rig without an existing task").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 {
         if (!options.taskId && !options.modelUrl) {
           throw new Error("Either --task-id or --model-url is required");
@@ -1793,11 +1904,17 @@ function createProcess3dCommand() {
         const params = {};
         if (options.height) params.height_meters = Number(options.height);
         if (options.modelUrl) params.model_url = options.modelUrl;
-        const data = await ctx.client.process3d({
+        const request = {
           task_id: options.taskId ?? "",
           operation: "rig",
           params: toJsonObject2(params)
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.process3d(request, { async: true });
+          printSuccess("process3d.rig", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.process3d(request);
         const localPath = await saveProcess3dOutput(data, "rig", options.outputDir);
         if (localPath) data.local_path = localPath;
         printSuccess("process3d.rig", data, ctx);
@@ -1807,7 +1924,10 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command8("animate").description("Apply a preset animation to a rigged Meshy character").requiredOption("--task-id <id>", "Meshy rigging task ID").requiredOption("--action-id <n>", "Animation preset ID (see docs for full list)").option("--fps <n>", "Target frame rate: 24, 25, 30, or 60").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command8("animate").description("Apply a preset animation to a rigged Meshy character").requiredOption("--task-id <id>", "Meshy rigging task ID").requiredOption("--action-id <n>", "Animation preset ID (see docs for full list)").option("--fps <n>", "Target frame rate: 24, 25, 30, or 60").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 {
         const ctx = createContext(this);
         const params = {
@@ -1816,11 +1936,17 @@ function createProcess3dCommand() {
         if (options.fps) {
           params.fps = Number(options.fps);
         }
-        const data = await ctx.client.process3d({
+        const request = {
           task_id: options.taskId,
           operation: "animate",
           params: toJsonObject2(params)
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.process3d(request, { async: true });
+          printSuccess("process3d.animate", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.process3d(request);
         const localPath = await saveProcess3dOutput(data, "animate", options.outputDir);
         if (localPath) data.local_path = localPath;
         printSuccess("process3d.animate", data, ctx);
@@ -1830,19 +1956,33 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command8("refine").description("Refine a Meshy preview model into a higher quality result").requiredOption("--task-id <id>", "Meshy preview task ID").option("--pbr", "Enable PBR materials").option("--hd-texture", "Request 4K texture output").option("--texture-prompt <text>", "Optional texture prompt for the refinement pass").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command8("refine").description("Refine a Meshy preview model into a higher quality result").requiredOption("--task-id <id>", "Meshy preview task ID").option("--pbr", "Enable PBR materials").option("--hd-texture", "Request 4K texture output (requires --ai-model meshy-6)").option("--texture-prompt <text>", "Optional texture prompt for the refinement pass").option("--ai-model <name>", "Meshy model: meshy-5, meshy-6, latest").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 {
+        if (options.hdTexture && options.aiModel && options.aiModel !== "meshy-6") {
+          throw new Error(
+            "--hd-texture requires --ai-model meshy-6 (got '" + options.aiModel + "')"
+          );
+        }
         const ctx = createContext(this);
         const params = {};
         if (options.pbr) params.pbr = true;
         if (options.hdTexture) params.hd_texture = true;
         if (options.texturePrompt) params.texture_prompt = options.texturePrompt;
         if (options.aiModel) params.ai_model = options.aiModel;
-        const data = await ctx.client.process3d({
+        const request = {
           task_id: options.taskId,
           operation: "refine",
           params: toJsonObject2(params)
-        });
+        };
+        if (options.async) {
+          const ack = await ctx.client.process3d(request, { async: true });
+          printSuccess("process3d.refine", ack, ctx);
+          return;
+        }
+        const data = await ctx.client.process3d(request);
         const localPath = await saveProcess3dOutput(data, "refine", options.outputDir);
         if (localPath) data.local_path = localPath;
         printSuccess("process3d.refine", data, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doufunao123/asset-gateway",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "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.1",
     "commander": "^13.1.0"
   },
   "devDependencies": {