@doufunao123/asset-gateway 0.25.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.25.0";
+var CLI_VERSION = "0.25.1";
 var CLI_DESCRIPTION = "Universal asset generation gateway CLI";
 var DEFAULT_GATEWAY_URL = "https://asset.origingame.dev";
 
@@ -1802,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");
@@ -1812,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",
@@ -1829,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;
@@ -1838,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);
@@ -1852,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");
@@ -1861,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);
@@ -1875,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 = {
@@ -1884,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);
@@ -1898,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.25.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.11.0",
+    "@doufunao123/assetforge-sdk": "^0.11.1",
     "commander": "^13.1.0"
   },
   "devDependencies": {