@doufunao123/asset-gateway 0.23.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.23.0";
+var CLI_VERSION = "0.25.0";
 var CLI_DESCRIPTION = "Universal asset generation gateway CLI";
 var DEFAULT_GATEWAY_URL = "https://asset.origingame.dev";
 
@@ -598,7 +598,7 @@ function createDescribeCommand() {
 
 // src/commands/generate.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2, extname, join as join2 } from "path";
+import { basename, dirname as dirname2, extname, join as join2 } from "path";
 import { AssetForgeError as AssetForgeError3 } from "@doufunao123/assetforge-sdk";
 import { Command as Command3 } from "commander";
 function inferExtension(assetType) {
@@ -747,6 +747,36 @@ async function saveNamedOutput(result, assetType, filePath) {
   }
   return null;
 }
+async function saveOutputFiles(result, outputDir) {
+  const outputFiles = Array.isArray(result.output_files) ? result.output_files : [];
+  if (outputFiles.length === 0) {
+    return [];
+  }
+  mkdirSync2(outputDir, { recursive: true });
+  const saved = [];
+  for (const file of outputFiles) {
+    if (!isOutputFile(file)) {
+      continue;
+    }
+    const filePath = join2(outputDir, basename(file.name));
+    const response = await fetch(file.url);
+    if (!response.ok) {
+      continue;
+    }
+    writeFileSync2(filePath, Buffer.from(await response.arrayBuffer()));
+    saved.push(filePath);
+  }
+  if (saved.length > 0) {
+    const manifestPath = join2(outputDir, "manifest.json");
+    writeFileSync2(manifestPath, `${JSON.stringify(result, null, 2)}
+`, "utf8");
+    saved.push(manifestPath);
+  }
+  return saved;
+}
+function isOutputFile(value) {
+  return typeof value === "object" && value !== null && typeof value.name === "string" && typeof value.url === "string" && typeof value.kind === "string";
+}
 function parseFrameSize(raw) {
   const [width, height] = raw.split("x");
   const frameWidth = Number(width);
@@ -959,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,
@@ -978,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);
@@ -988,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,
@@ -1003,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);
@@ -1013,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,
@@ -1028,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);
@@ -1094,8 +1192,13 @@ function createGenerateCommand() {
           quality: options.quality,
           display_name: options.displayName
         });
-        const localPath = await saveOutput(data, "world", options.outputDir);
-        if (localPath) data.local_path = localPath;
+        const localPaths = await saveOutputFiles(data, options.outputDir);
+        if (localPaths.length > 0) {
+          data.local_paths = localPaths;
+        } else {
+          const localPath = await saveOutput(data, "world", options.outputDir);
+          if (localPath) data.local_path = localPath;
+        }
         printSuccess("generate.world", data, ctx);
       } catch (error2) {
         printError("generate.world", error2);
@@ -1140,12 +1243,18 @@ import { Command as Command4 } from "commander";
 function createJobCommand() {
   const command = new Command4("job").description("Job management");
   command.addCommand(
-    new Command4("list").description("List jobs").option("--status <status>", "Filter by status").option("--limit <n>", "Maximum number of jobs to return").action(async function(options) {
+    new Command4("list").description("List jobs").option("--job-kind <kind>", "Filter by job kind").option("--status <status>", "Filter by status").option("--asset-type <type>", "Filter by asset type").option("--provider-id <id>", "Filter by provider ID").option("--since <iso>", "Filter jobs created at or after an ISO8601 timestamp").option("--provider-task-id <id>", "Filter by provider task ID").option("--limit <n>", "Maximum number of jobs to return").option("--offset <n>", "Offset for pagination").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.job.list({
+          job_kind: options.jobKind,
           status: options.status,
-          limit: options.limit ? Number(options.limit) : void 0
+          asset_type: options.assetType,
+          provider_id: options.providerId,
+          since: options.since,
+          provider_task_id: options.providerTaskId,
+          limit: options.limit ? Number(options.limit) : void 0,
+          offset: options.offset ? Number(options.offset) : void 0
         });
         printSuccess("job.list", data, ctx);
       } catch (error2) {
@@ -1187,7 +1296,7 @@ function createLibraryCommand() {
     "Search and manage the asset library"
   );
   command.addCommand(
-    new Command5("search").description("Search the asset library").argument("[query]", "Search query").option("-q, --query <query>", "Search query").option("-t, --type <type>", "Filter by asset type (audio, music, image, etc.)").option("--tags <tags>", "Filter by tags (comma-separated)").option("--source <source>", "Filter by source (manual, generated, imported)").option("--pack-id <id>", "Filter by library pack ID").option("--mode <mode>", "Search mode (fts, vector, hybrid)").option("--style <style>", "Filter by visual style").option("--composition <composition>", "Filter by composition").option("--lighting <lighting>", "Filter by lighting").option("--color-tone <tone>", "Filter by color tone").option("--mood <mood>", "Filter by mood (comma-separated)").option("--theme <theme>", "Filter by theme (comma-separated)").option("--era <era>", "Filter by era").option("--gameplay-role <role>", "Filter by gameplay role").option("--rig-name <rig>", "Filter by exact rig name").option("--compatible-rig <rig>", "Filter by compatible rig").option("--no-rerank", "Disable LLM reranking").option("-n, --limit <limit>", "Max results", "20").option("--offset <offset>", "Offset for pagination", "0").action(async function(query) {
+    new Command5("search").description("Search the asset library").argument("[query]", "Search query").option("-q, --query <query>", "Search query").option("-t, --type <type>", "Filter by asset type (audio, music, image, etc.)").option("--tags <tags>", "Filter by tags (comma-separated)").option("--source <source>", "Filter by source (manual, generated, imported)").option("--pack-id <id>", "Filter by library pack ID").option("--mode <mode>", "Search mode (fts, vector, hybrid)").option("--style <style>", "Filter by visual style").option("--composition <composition>", "Filter by composition").option("--lighting <lighting>", "Filter by lighting").option("--color-tone <tone>", "Filter by color tone").option("--mood <mood>", "Filter by mood (comma-separated)").option("--theme <theme>", "Filter by theme (comma-separated)").option("--era <era>", "Filter by era").option("--gameplay-role <role>", "Filter by gameplay role").option("--enrichment-status <status>", "Filter by enrichment status").option("--min-long-edge-px <px>", "Minimum long edge in pixels").option("--min-width-px <px>", "Minimum width in pixels").option("--min-height-px <px>", "Minimum height in pixels").option("--max-file-size-bytes <bytes>", "Maximum file size in bytes").option("--license <license>", "Filter by asset license").option("--rig-name <rig>", "Filter by exact rig name").option("--compatible-rig <rig>", "Filter by compatible rig").option("--no-rerank", "Disable LLM reranking").option("-n, --limit <limit>", "Max results", "20").option("--offset <offset>", "Offset for pagination", "0").action(async function(query) {
       const ctx = createContext(this);
       const opts = this.opts();
       try {
@@ -1206,6 +1315,12 @@ function createLibraryCommand() {
           theme: opts.theme,
           era: opts.era,
           gameplay_role: opts.gameplayRole,
+          enrichment_status: opts.enrichmentStatus,
+          min_long_edge_px: opts.minLongEdgePx ? Number(opts.minLongEdgePx) : void 0,
+          min_width_px: opts.minWidthPx ? Number(opts.minWidthPx) : void 0,
+          min_height_px: opts.minHeightPx ? Number(opts.minHeightPx) : void 0,
+          max_file_size_bytes: opts.maxFileSizeBytes ? Number(opts.maxFileSizeBytes) : void 0,
+          license: opts.license,
           rig_name: opts.rigName,
           compatible_rig: opts.compatibleRig,
           rerank: opts.rerank,
@@ -1838,7 +1953,7 @@ function createProviderCommand() {
 
 // src/commands/upload.ts
 import { readFile as readFile3 } from "fs/promises";
-import { basename } from "path";
+import { basename as basename2 } from "path";
 import { AssetForgeError as AssetForgeError6 } from "@doufunao123/assetforge-sdk";
 import { Command as Command10 } from "commander";
 function createUploadCommand() {
@@ -1848,7 +1963,7 @@ function createUploadCommand() {
       const ctx = createContext(this);
       try {
         const content = await readLocalFile(filePath);
-        const data = await ctx.client.assets.upload(content, { filename: basename(filePath) });
+        const data = await ctx.client.assets.upload(content, { filename: basename2(filePath) });
         printSuccess("asset.upload", data, ctx);
       } catch (error2) {
         printError("asset.upload", error2, ctx.human);

package/package.json

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