@doufunao123/asset-gateway 0.17.0 → 0.18.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/auth.ts
 import { existsSync as existsSync2, unlinkSync } from "fs";
@@ -1121,11 +1121,101 @@ function createJobCommand() {
   return command;
 }
 
+// src/commands/library.ts
+import { Command as Command5 } from "commander";
+function createLibraryCommand() {
+  const command = new Command5("library").description(
+    "Search and manage the asset library"
+  );
+  command.addCommand(
+    new Command5("search").description("Search the asset library").argument("[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("-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 {
+        const params = new URLSearchParams();
+        if (query) params.set("q", query);
+        if (opts.type) params.set("type", opts.type);
+        if (opts.tags) params.set("tags", opts.tags);
+        if (opts.source) params.set("source", opts.source);
+        params.set("limit", opts.limit);
+        params.set("offset", opts.offset);
+        const data = await ctx.client.get(`/api/library/search?${params}`);
+        printSuccess("library.search", data, ctx);
+      } catch (error2) {
+        printError("library.search", error2, ctx.human);
+      }
+    })
+  );
+  command.addCommand(
+    new Command5("add").description("Add an item to the asset library").requiredOption("--name <name>", "Display name").requiredOption("--url <url>", "File URL (public)").requiredOption("-t, --type <type>", "Asset type (audio, music, image, etc.)").option("-d, --description <desc>", "Description").option("--tags <tags>", "Comma-separated tags").option("--duration <seconds>", "Duration in seconds (for audio/video)").option("--source <source>", "Source (manual, generated, imported)", "manual").action(async function() {
+      const ctx = createContext(this);
+      const opts = this.opts();
+      try {
+        const body = {
+          asset_type: opts.type,
+          name: opts.name,
+          file_url: opts.url,
+          source: opts.source
+        };
+        if (opts.description) body.description = opts.description;
+        if (opts.tags)
+          body.tags = opts.tags.split(",").map((t) => t.trim());
+        if (opts.duration)
+          body.duration_seconds = parseFloat(opts.duration);
+        const data = await ctx.client.post("/api/library", body);
+        printSuccess("library.add", data, ctx);
+      } catch (error2) {
+        printError("library.add", error2, ctx.human);
+      }
+    })
+  );
+  command.addCommand(
+    new Command5("get").description("Get a library item by ID").argument("<id>", "Library item ID").action(async function(id) {
+      const ctx = createContext(this);
+      try {
+        const data = await ctx.client.get(`/api/library/${encodeURIComponent(id)}`);
+        printSuccess("library.get", data, ctx);
+      } catch (error2) {
+        printError("library.get", error2, ctx.human);
+      }
+    })
+  );
+  command.addCommand(
+    new Command5("delete").description("Delete a library item (admin only)").argument("<id>", "Library item ID").action(async function(id) {
+      const ctx = createContext(this);
+      try {
+        const data = await ctx.client.delete(`/api/library/${encodeURIComponent(id)}`);
+        printSuccess("library.delete", data, ctx);
+      } catch (error2) {
+        printError("library.delete", error2, ctx.human);
+      }
+    })
+  );
+  command.addCommand(
+    new Command5("catalog-jobs").description("Catalog completed generation jobs into the library (admin)").option("-t, --type <type>", "Filter jobs by asset type").option("--provider <id>", "Filter jobs by provider ID").option("--after <date>", "Only catalog jobs after this date").option("--dry-run", "Just count, don't actually catalog").action(async function() {
+      const ctx = createContext(this);
+      const opts = this.opts();
+      try {
+        const body = {};
+        if (opts.type) body.asset_type = opts.type;
+        if (opts.provider) body.provider_id = opts.provider;
+        if (opts.after) body.after = opts.after;
+        if (opts.dryRun) body.dry_run = true;
+        const data = await ctx.client.post("/api/library/catalog-jobs", body);
+        printSuccess("library.catalog_jobs", data, ctx);
+      } catch (error2) {
+        printError("library.catalog_jobs", error2, ctx.human);
+      }
+    })
+  );
+  return command;
+}
+
 // src/commands/process.ts
 import { mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { existsSync as existsSync4 } from "fs";
 import { join as join3 } from "path";
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 function readInputAsBase64(input) {
   if (existsSync4(input)) {
     const bytes = readFileSync3(input);
@@ -1159,9 +1249,9 @@ function saveProcessOutput(data, outputDir) {
   return filePath;
 }
 function createProcessCommand() {
-  const command = new Command5("process").description("Post-process images and video (crop, resize, compose, extract-frames, remove-bg)");
+  const command = new Command6("process").description("Post-process images and video (crop, resize, compose, extract-frames, remove-bg)");
   command.addCommand(
-    new Command5("crop").description("Smart crop an image (trim transparent borders)").requiredOption("--input <path>", "Input image (file path or URL)").option("--mode <mode>", "Crop mode: tightest or power_of2", "tightest").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command6("crop").description("Smart crop an image (trim transparent borders)").requiredOption("--input <path>", "Input image (file path or URL)").option("--mode <mode>", "Crop mode: tightest or power_of2", "tightest").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process", {
@@ -1177,7 +1267,7 @@ function createProcessCommand() {
     })
   );
   command.addCommand(
-    new Command5("resize").description("Resize an image to exact dimensions").requiredOption("--input <path>", "Input image (file path or URL)").requiredOption("--width <n>", "Target width").requiredOption("--height <n>", "Target height").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command6("resize").description("Resize an image to exact dimensions").requiredOption("--input <path>", "Input image (file path or URL)").requiredOption("--width <n>", "Target width").requiredOption("--height <n>", "Target height").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process", {
@@ -1193,7 +1283,7 @@ function createProcessCommand() {
     })
   );
   command.addCommand(
-    new Command5("compose").description("Compose multiple images into a sprite sheet").requiredOption("--input <paths...>", "Input images (files or URLs)").option("--direction <dir>", "Layout: horizontal, vertical, grid", "horizontal").option("--columns <n>", "Columns for grid layout").option("--padding <n>", "Padding between frames in px", "0").option("--frame-width <n>", "Normalize each frame to this width").option("--frame-height <n>", "Normalize each frame to this height").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command6("compose").description("Compose multiple images into a sprite sheet").requiredOption("--input <paths...>", "Input images (files or URLs)").option("--direction <dir>", "Layout: horizontal, vertical, grid", "horizontal").option("--columns <n>", "Columns for grid layout").option("--padding <n>", "Padding between frames in px", "0").option("--frame-width <n>", "Normalize each frame to this width").option("--frame-height <n>", "Normalize each frame to this height").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const inputs = Array.isArray(options.input) ? options.input : [options.input];
@@ -1217,7 +1307,7 @@ function createProcessCommand() {
     })
   );
   command.addCommand(
-    new Command5("extract-frames").description("Extract evenly-spaced frames from a video using ffmpeg").requiredOption("--input <path>", "Input video (file path or URL)").option("--count <n>", "Number of frames to extract", "8").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command6("extract-frames").description("Extract evenly-spaced frames from a video using ffmpeg").requiredOption("--input <path>", "Input video (file path or URL)").option("--count <n>", "Number of frames to extract", "8").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process", {
@@ -1233,7 +1323,7 @@ function createProcessCommand() {
     })
   );
   command.addCommand(
-    new Command5("remove-bg").description("Remove background from image(s) using rembg or ImageMagick fallback").requiredOption("--input <paths...>", "Input images (files or URLs)").option("--bg-color <color>", "Background color hint for fallback (e.g. white, black)").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command6("remove-bg").description("Remove background from image(s) using rembg or ImageMagick fallback").requiredOption("--input <paths...>", "Input images (files or URLs)").option("--bg-color <color>", "Background color hint for fallback (e.g. white, black)").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const inputs = Array.isArray(options.input) ? options.input : [options.input];
@@ -1257,7 +1347,7 @@ function createProcessCommand() {
 // src/commands/process3d.ts
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
 import { join as join4 } from "path";
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 function infer3dExtension(format) {
   const map = {
     fbx: "fbx",
@@ -1327,9 +1417,9 @@ function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function createProcess3dCommand() {
-  const command = new Command6("process3d").description("3D model post-processing via Tripo pipeline");
+  const command = new Command7("process3d").description("3D model post-processing via Tripo pipeline");
   command.addCommand(
-    new Command6("convert").description("Convert 3D model format (FBX/USDZ/OBJ/STL/GLTF/3MF)").requiredOption("--task-id <id>", "Tripo task ID from generate model").requiredOption("--format <fmt>", "Target format: FBX, USDZ, OBJ, STL, GLTF, 3MF").option("--quad", "Enable quad remeshing").option("--face-limit <n>", "Max face count").option("--pack-uv", "Pack UVs during export").option("--bake", "Bake textures during export").option("--texture-format <fmt>", "Texture export format override").option("--force-symmetry", "Force symmetry during conversion").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("convert").description("Convert 3D model format (FBX/USDZ/OBJ/STL/GLTF/3MF)").requiredOption("--task-id <id>", "Tripo task ID from generate model").requiredOption("--format <fmt>", "Target format: FBX, USDZ, OBJ, STL, GLTF, 3MF").option("--quad", "Enable quad remeshing").option("--face-limit <n>", "Max face count").option("--pack-uv", "Pack UVs during export").option("--bake", "Bake textures during export").option("--texture-format <fmt>", "Texture export format override").option("--force-symmetry", "Force symmetry during conversion").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const params = {
@@ -1355,7 +1445,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("texture").description("Re-texture a 3D model with new materials").requiredOption("--task-id <id>", "Tripo task ID").option("--prompt <text>", "Texture description prompt").option("--style-image <input>", "Texture style reference image URL or local file path").option("--pbr", "Enable PBR materials").option("--quality <q>", "Texture quality: standard or detailed").option("--texture-alignment <mode>", "Tripo texture alignment mode").option("--bake", "Bake textures during re-texturing").option("--texture-version <version>", "Tripo texture model version override").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("texture").description("Re-texture a 3D model with new materials").requiredOption("--task-id <id>", "Tripo task ID").option("--prompt <text>", "Texture description prompt").option("--style-image <input>", "Texture style reference image URL or local file path").option("--pbr", "Enable PBR materials").option("--quality <q>", "Texture quality: standard or detailed").option("--texture-alignment <mode>", "Tripo texture alignment mode").option("--bake", "Bake textures during re-texturing").option("--texture-version <version>", "Tripo texture model version override").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const params = {};
@@ -1380,7 +1470,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("rig").description("Auto-rig a 3D model (add skeleton for animation)").requiredOption("--task-id <id>", "Tripo task ID").option("--format <fmt>", "Output format: glb or fbx", "glb").option("--spec <spec>", "Rig spec: mixamo or tripo", "mixamo").option("--rig-type <type>", "Rig type override passed through to Tripo").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("rig").description("Auto-rig a 3D model (add skeleton for animation)").requiredOption("--task-id <id>", "Tripo task ID").option("--format <fmt>", "Output format: glb or fbx", "glb").option("--spec <spec>", "Rig spec: mixamo or tripo", "mixamo").option("--rig-type <type>", "Rig type override passed through to Tripo").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const params = {
@@ -1402,7 +1492,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("animate").description("Apply preset animation to a rigged model").requiredOption("--task-id <id>", "Tripo task ID (from rig step)").requiredOption("--animation <preset>", "Animation preset (e.g. preset:walk, preset:idle, preset:run)").option("--format <fmt>", "Output format: glb or fbx", "glb").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("animate").description("Apply preset animation to a rigged model").requiredOption("--task-id <id>", "Tripo task ID (from rig step)").requiredOption("--animation <preset>", "Animation preset (e.g. preset:walk, preset:idle, preset:run)").option("--format <fmt>", "Output format: glb or fbx", "glb").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process3d", {
@@ -1422,7 +1512,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("render-sprites").description("Render animated 3D model to 2D sprite frames via Blender").requiredOption("--task-id <id>", "Tripo task ID").option("--frame-count <n>", "Number of frames", "8").option("--resolution <n>", "Frame resolution in pixels", "64").option("--camera-angle <angle>", "Camera: front, side, iso, 3/4, top", "front").option("--directions <n>", "Rotation directions: 1, 4, 8", "1").option("--output-dir <dir>", "Output directory", ".").action(async function(options) {
+    new Command7("render-sprites").description("Render animated 3D model to 2D sprite frames via Blender").requiredOption("--task-id <id>", "Tripo task ID").option("--frame-count <n>", "Number of frames", "8").option("--resolution <n>", "Frame resolution in pixels", "64").option("--camera-angle <angle>", "Camera: front, side, iso, 3/4, top", "front").option("--directions <n>", "Rotation directions: 1, 4, 8", "1").option("--output-dir <dir>", "Output directory", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process3d", {
@@ -1441,7 +1531,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("reduce").description("Reduce polygon count (high-poly to low-poly)").requiredOption("--task-id <id>", "Tripo task ID").option("--face-limit <n>", "Target face count").option("--quad", "Use quad topology").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("reduce").description("Reduce polygon count (high-poly to low-poly)").requiredOption("--task-id <id>", "Tripo task ID").option("--face-limit <n>", "Target face count").option("--quad", "Use quad topology").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const params = {};
@@ -1461,7 +1551,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("stylize").description("Apply artistic style to a model").requiredOption("--task-id <id>", "Tripo task ID").requiredOption("--style <style>", "Style: lego, voxel, voronoi, minecraft").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("stylize").description("Apply artistic style to a model").requiredOption("--task-id <id>", "Tripo task ID").requiredOption("--style <style>", "Style: lego, voxel, voronoi, minecraft").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process3d", {
@@ -1480,7 +1570,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("segment").description("Segment mesh into logical parts").requiredOption("--task-id <id>", "Tripo task ID").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("segment").description("Segment mesh into logical parts").requiredOption("--task-id <id>", "Tripo task ID").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process3d", {
@@ -1497,7 +1587,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("prerigcheck").description("Check if a model can be rigged").requiredOption("--task-id <id>", "Tripo task ID").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("prerigcheck").description("Check if a model can be rigged").requiredOption("--task-id <id>", "Tripo task ID").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process3d", {
@@ -1514,7 +1604,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("refine").description("Refine a draft model to higher quality").requiredOption("--task-id <id>", "Tripo task ID").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("refine").description("Refine a draft model to higher quality").requiredOption("--task-id <id>", "Tripo task ID").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.post("/api/process3d", {
@@ -1531,7 +1621,7 @@ function createProcess3dCommand() {
     })
   );
   command.addCommand(
-    new Command6("import").description("Import an external 3D model for post-processing").option("--file-url <url>", "URL of the 3D model to import").option("--file-path <path>", "Local path of the 3D model to import").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
+    new Command7("import").description("Import an external 3D model for post-processing").option("--file-url <url>", "URL of the 3D model to import").option("--file-path <path>", "Local path of the 3D model to import").option("--output-dir <dir>", "Directory to save output", ".").action(async function(options) {
       try {
         const ctx = createContext(this);
         const params = {};
@@ -1557,11 +1647,11 @@ function createProcess3dCommand() {
 }
 
 // src/commands/provider.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 function createProviderCommand() {
-  const command = new Command7("provider").description("Provider management");
+  const command = new Command8("provider").description("Provider management");
   command.addCommand(
-    new Command7("list").description("List available providers").action(async function() {
+    new Command8("list").description("List available providers").action(async function() {
       try {
         const ctx = createContext(this);
         const data = await ctx.client.get("/api/providers");
@@ -1572,7 +1662,7 @@ function createProviderCommand() {
     })
   );
   command.addCommand(
-    new Command7("health").description("Check provider health").argument("[name]", "Specific provider name").action(async function(name) {
+    new Command8("health").description("Check provider health").argument("[name]", "Specific provider name").action(async function(name) {
       try {
         const ctx = createContext(this);
         const path = name ? `/api/providers/${encodeURIComponent(name)}/health` : "/api/providers/health";
@@ -1587,11 +1677,11 @@ function createProviderCommand() {
 }
 
 // src/commands/upload.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 function createUploadCommand() {
-  const command = new Command8("upload").description("Upload and manage assets");
+  const command = new Command9("upload").description("Upload and manage assets");
   command.addCommand(
-    new Command8("file").description("Upload a file and get a public URL").argument("<path>", "Path to file to upload").action(async function(filePath) {
+    new Command9("file").description("Upload a file and get a public URL").argument("<path>", "Path to file to upload").action(async function(filePath) {
       const ctx = createContext(this);
       try {
         const data = await ctx.client.uploadFile(filePath);
@@ -1602,7 +1692,7 @@ function createUploadCommand() {
     })
   );
   command.addCommand(
-    new Command8("list").description("List uploaded assets").action(async function() {
+    new Command9("list").description("List uploaded assets").action(async function() {
       const ctx = createContext(this);
       try {
         const data = await ctx.client.get("/api/assets");
@@ -1613,7 +1703,7 @@ function createUploadCommand() {
     })
   );
   command.addCommand(
-    new Command8("delete").description("Delete an uploaded asset (admin only)").argument("<filename>", "Filename to delete").action(async function(filename) {
+    new Command9("delete").description("Delete an uploaded asset (admin only)").argument("<filename>", "Filename to delete").action(async function(filename) {
       const ctx = createContext(this);
       try {
         const data = await ctx.client.delete(`/api/assets/${encodeURIComponent(filename)}`);
@@ -1627,12 +1717,13 @@ function createUploadCommand() {
 }
 
 // src/index.ts
-var program = new Command9().name("asset-gateway").description("Universal asset generation gateway CLI").version(CLI_VERSION).option(
+var program = new Command10().name("asset-gateway").description("Universal asset generation gateway CLI").version(CLI_VERSION).option(
   "--gateway-url <url>",
   `Gateway URL (default: $ASSET_GATEWAY_URL, auth config, or ${DEFAULT_GATEWAY_URL})`
 ).option("--token <token>", "API token for authentication").option("--human", "Human-readable output instead of JSON").option("--fields <fields>", "Comma-separated list of output fields");
 program.addCommand(createAuthCommand());
 program.addCommand(createGenerateCommand());
+program.addCommand(createLibraryCommand());
 program.addCommand(createProcessCommand());
 program.addCommand(createProcess3dCommand());
 program.addCommand(createProviderCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doufunao123/asset-gateway",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Universal asset generation gateway CLI",
   "type": "module",
   "bin": {