@meshy-ai/cli 0.4.0 → 0.4.2

package/dist/cmd/repair-printability.js

@@ -1,20 +1,26 @@
 /**
  * repair-printability — https://docs.meshy.ai/en/api/repair-printability
  * Fix non-watertight / non-manifold geometry. Existing textures are removed
- * (re-run retexture afterward if needed). Costs 10 credits on success.
+ * (re-run retexture afterward if needed). With a printer type or print size,
+ * walls too thin at that size are also thickened; the output keeps its scale.
  */
 import { UsageError } from "../internal/errors.js";
+import { parseBool } from "../internal/flags.js";
 import { buildResourceCommand } from "../internal/task-command.js";
+import { printSizeOptions, printSizePayload, validatePrintSize } from "./analyze-printability.js";
 const spec = {
     name: "repair-printability",
     description: "Repair geometric defects (non-manifold edges, holes, degenerate faces) so a model can " +
-        "be 3D-printed. Textures are dropped — re-run retexture afterwards if needed",
+        "be 3D-printed; with a printer type or print size, also thicken walls too thin at that size. " +
+        "Textures are dropped — re-run retexture afterwards if needed",
     create: {
         description: "Create a repair-printability task",
         configure(cmd) {
-            return cmd
-                .option("--input-task-id <id>", "source SUCCEEDED task (image-to-3d, multi-image-to-3d, text-to-3d, remesh, or retexture) — takes priority over --model-url")
-                .option("--model-url <src>", "3D model as http(s) URL or local file path (.glb/.stl/.obj only, max 100MB)");
+            cmd
+                .option("--input-task-id <id>", "source SUCCEEDED task: image-to-3d, multi-image-to-3d, text-to-3d, remesh, retexture or analyze-printability — takes priority over --model-url")
+                .option("--model-url <src>", "3D model: an http(s) URL (.glb/.gltf/.obj/.fbx/.stl, max 100MB; the output keeps the input format) or a local .glb/.gltf file — the API takes inline uploads as glTF only, so host .stl/.obj/.fbx at a URL")
+                .option("--alpha-thumbnail <bool>", "also render a transparent-background preview (alpha_thumbnail_url; default: false)", parseBool);
+            return printSizeOptions(cmd, "thicken");
         },
         toPayload(opts) {
             if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
@@ -23,8 +29,11 @@ const spec = {
             return {
                 input_task_id: opts.inputTaskId,
                 model_url: opts.modelUrl,
+                alpha_thumbnail: opts.alphaThumbnail,
+                ...printSizePayload(opts),
             };
         },
+        validatePayload: validatePrintSize,
     },
     endpointOf: (c) => c.repairPrintability,
 };

package/dist/cmd/repair-printability.js.map

@@ -1 +1 @@
-{"version":3,"file":"repair-printability.js","sourceRoot":"","sources":["../../src/cmd/repair-printability.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,wFAAwF;QACxF,6EAA6E;IAC/E,MAAM,EAAE;QACN,WAAW,EAAE,mCAAmC;QAChD,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,4HAA4H,CAAC;iBAC5J,MAAM,CAAC,mBAAmB,EAAE,6EAA6E,CAAC,CAAC;QAChH,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;QACJ,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"repair-printability.js","sourceRoot":"","sources":["../../src/cmd/repair-printability.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAElG,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,wFAAwF;QACxF,8FAA8F;QAC9F,8DAA8D;IAChE,MAAM,EAAE;QACN,WAAW,EAAE,mCAAmC;QAChD,SAAS,CAAC,GAAG;YACX,GAAG;iBACA,MAAM,CACL,sBAAsB,EACtB,gJAAgJ,CACjJ;iBACA,MAAM,CACL,mBAAmB,EACnB,4MAA4M,CAC7M;iBACA,MAAM,CAAC,0BAA0B,EAAE,oFAAoF,EAAE,SAAS,CAAC,CAAC;YACvI,OAAO,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,eAAe,EAAE,IAAI,CAAC,cAAc;gBACpC,GAAG,gBAAgB,CAAC,IAAI,CAAC;aAC1B,CAAC;QACJ,CAAC;QACD,eAAe,EAAE,iBAAiB;KACnC;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/cmd/resize.js

@@ -17,7 +17,7 @@ const spec = {
         configure(cmd) {
             return cmd
                 .option("--input-task-id <id>", "source Meshy task id (takes priority over --model-url)")
-                .option("--model-url <src>", "3D model as http(s) URL or local file path")
+                .option("--model-url <src>", "3D model: an http(s) URL (.glb/.gltf/.obj/.fbx/.stl) or a local .glb/.gltf file — the API takes inline uploads as glTF only, so host .stl/.obj/.fbx at a URL")
                 .option("--resize-height <m>", "target height in meters (one sizing mode required)", parseNumber)
                 .option("--resize-longest-side <m>", "target longest dimension in meters", parseNumber)
                 .option("--auto-size <bool>", "AI-estimate the real-world size", parseBool)

package/dist/cmd/resize.js.map

@@ -1 +1 @@
-{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/cmd/resize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,mFAAmF;QACnF,0CAA0C;IAC5C,MAAM,EAAE;QACN,WAAW,EAAE,sBAAsB;QACnC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,wDAAwD,CAAC;iBACxF,MAAM,CAAC,mBAAmB,EAAE,4CAA4C,CAAC;iBACzE,MAAM,CAAC,qBAAqB,EAAE,oDAAoD,EAAE,WAAW,CAAC;iBAChG,MAAM,CAAC,2BAA2B,EAAE,oCAAoC,EAAE,WAAW,CAAC;iBACtF,MAAM,CAAC,oBAAoB,EAAE,iCAAiC,EAAE,SAAS,CAAC;iBAC1E,SAAS,CACR,IAAI,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAC7F,CAAC;QACN,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,KAAK,GAAG;gBACZ,IAAI,CAAC,YAAY,IAAI,IAAI;gBACzB,IAAI,CAAC,iBAAiB,IAAI,IAAI;gBAC9B,IAAI,CAAC,QAAQ,KAAK,IAAI;aACvB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACzB,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAClB,8FAA8F,CAC/F,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,aAAa,EAAE,IAAI,CAAC,YAAY;gBAChC,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;gBAC3C,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;QACJ,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/cmd/resize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,mFAAmF;QACnF,0CAA0C;IAC5C,MAAM,EAAE;QACN,WAAW,EAAE,sBAAsB;QACnC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,wDAAwD,CAAC;iBACxF,MAAM,CAAC,mBAAmB,EAAE,8JAA8J,CAAC;iBAC3L,MAAM,CAAC,qBAAqB,EAAE,oDAAoD,EAAE,WAAW,CAAC;iBAChG,MAAM,CAAC,2BAA2B,EAAE,oCAAoC,EAAE,WAAW,CAAC;iBACtF,MAAM,CAAC,oBAAoB,EAAE,iCAAiC,EAAE,SAAS,CAAC;iBAC1E,SAAS,CACR,IAAI,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAC7F,CAAC;QACN,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,KAAK,GAAG;gBACZ,IAAI,CAAC,YAAY,IAAI,IAAI;gBACzB,IAAI,CAAC,iBAAiB,IAAI,IAAI;gBAC9B,IAAI,CAAC,QAAQ,KAAK,IAAI;aACvB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACzB,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAClB,8FAA8F,CAC/F,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,aAAa,EAAE,IAAI,CAAC,YAAY;gBAChC,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;gBAC3C,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;QACJ,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/cmd/resources.d.ts

@@ -7,7 +7,7 @@
  * callers need and points here for the rest.
  *
  * legacy: the 0.2.0 array of `{name, summary}` (new commands appended).
- * v1:     `result.items` with `kind` (task | query | local), the command line,
+ * v1:     `result.items` with `kind` (task | query | action | local), the command line,
  *         the endpoint and the supported verbs — all generated from the
  *         registry and filtered to what this build actually registers.
  */

package/dist/cmd/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/cmd/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,EAAE,aAAa,EA6BpC,CAAC;AAoBF,eAAO,MAAM,gBAAgB,SAsBzB,CAAC"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/cmd/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,EAAE,aAAa,EA+BpC,CAAC;AAoBF,eAAO,MAAM,gBAAgB,SAsBzB,CAAC"}

package/dist/cmd/resources.js

@@ -7,7 +7,7 @@
  * callers need and points here for the rest.
  *
  * legacy: the 0.2.0 array of `{name, summary}` (new commands appended).
- * v1:     `result.items` with `kind` (task | query | local), the command line,
+ * v1:     `result.items` with `kind` (task | query | action | local), the command line,
  *         the endpoint and the supported verbs — all generated from the
  *         registry and filtered to what this build actually registers.
  */
@@ -19,7 +19,7 @@ import { buildLocalRuntime } from "../internal/runtime.js";
 export const RESOURCES = [
     { name: "text-to-3d", summary: "two-stage 3D generation from text (preview → refine)" },
     { name: "image-to-3d", summary: "3D from a single image (standard or smart-topology low-poly)" },
-    { name: "multi-image-to-3d", summary: "3D from multiple views (beta; prefer image-to-3d)" },
+    { name: "multi-image-to-3d", summary: "3D from 1-4 views of one object (prefer image-to-3d for a single image)" },
     { name: "remesh", summary: "retopologize / change polycount" },
     { name: "convert", summary: "change file format only" },
     { name: "resize", summary: "resize to real-world dimensions" },
@@ -33,11 +33,11 @@ export const RESOURCES = [
     { name: "analyze-printability", summary: "inspect a model for 3D-printing issues (free)" },
     { name: "repair-printability", summary: "fix non-watertight / non-manifold geometry" },
     { name: "balance", summary: "remaining credit balance" },
-    { name: "delete", summary: "delete any task, whatever its resource" },
+    { name: "delete", summary: "delete a task of any resource except Creative Lab (whose own delete verb cancels)" },
     // Added in S1 (appended so 0.2.0 consumers keep their positions).
     { name: "uv-unwrap", summary: "generate fresh UVs for a GLB (≤40k faces) — a UV white model for external texturing" },
-    { name: "creative-lab", summary: "photo → printable product: figure | lamp | keychain | fridge-magnet (prototype then build)" },
-    { name: "animation-catalog", summary: "public animation library (action ids); no key needed" },
+    { name: "creative-lab", summary: "photo → printable product: figure | vinyl-figure | brick-figure | lamp | keychain | fridge-magnet | keycap | fidget-pixel (prototype then build) | fidget-collapsible (one stage)" },
+    { name: "animation-catalog", summary: "animation library (action ids for animate); free, server-side search" },
     { name: "showcases", summary: "Enterprise community showcases (every request is billed)" },
     { name: "download", summary: "download selected assets of a task (saved task JSON, URL, or API)" },
     { name: "project", summary: "meshy_output project folders: init | record | show | list | rebuild-index" },
@@ -45,6 +45,8 @@ export const RESOURCES = [
     { name: "mesh", summary: "prepare-print: OBJ Y-up → Z-up, scale to height, centre, ground at Z=0" },
     { name: "slicer", summary: "detect installed slicers | open a model in one" },
     { name: "doctor", summary: "local environment diagnosis (no network by default)" },
+    { name: "auto-split", summary: "split a model into printable parts (auto / by named parts / by colour; optional connectors)" },
+    { name: "usage", summary: "usage tasks: finished API tasks with the credits each consumed (Studio/Enterprise)" },
 ];
 const VERBS = `Every task resource carries the same verbs:
 
@@ -81,7 +83,7 @@ export const resourcesCommand = new Command("resources")
     const byKind = (kind) => items.filter((e) => e.kind === kind).length;
     await emitResult(opened, legacy, {
         items,
-        counts: { task: byKind("task"), query: byKind("query"), local: byKind("local") },
+        counts: { task: byKind("task"), query: byKind("query"), action: byKind("action"), local: byKind("local") },
         verbs_help: "meshy resources --help",
     });
 });

package/dist/cmd/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/cmd/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAA2B,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,sDAAsD,EAAE;IACvF,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,8DAA8D,EAAE;IAChG,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,mDAAmD,EAAE;IAC3F,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iCAAiC,EAAE;IAC9D,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB,EAAE;IACvD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iCAAiC,EAAE;IAC9D,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,qDAAqD,EAAE;IACnF,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,0CAA0C,EAAE;IACxE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,EAAE;IACrD,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,qBAAqB,EAAE;IACzD,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,sDAAsD,EAAE;IAC3F,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE;IACvD,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,iCAAiC,EAAE;IACzE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,+CAA+C,EAAE;IAC1F,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,4CAA4C,EAAE;IACtF,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,EAAE;IACxD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,wCAAwC,EAAE;IACrE,kEAAkE;IAClE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,qFAAqF,EAAE;IACrH,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,4FAA4F,EAAE;IAC/H,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sDAAsD,EAAE;IAC9F,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,0DAA0D,EAAE;IAC1F,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,mEAAmE,EAAE;IAClG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,2EAA2E,EAAE;IACzG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,6DAA6D,EAAE;IAC3F,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wEAAwE,EAAE;IACnG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gDAAgD,EAAE;IAC7E,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qDAAqD,EAAE;CACnF,CAAC;AAEF,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;0EAgB4D,CAAC;AAE3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;KACrD,WAAW,CAAC,yDAAyD,CAAC;KACtE,WAAW,CAAC,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC;KACpC,MAAM,CAAC,KAAK,EAAE,KAA8B,EAAE,OAAgB,EAAE,EAAE;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3D,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,IAAgC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IACjG,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE;QAC/B,KAAK;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;QAChF,UAAU,EAAE,wBAAwB;KACrC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/cmd/resources.ts"],"names":[],"mappings":"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"}

package/dist/cmd/retexture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retexture.d.ts","sourceRoot":"","sources":["../../src/cmd/retexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAgG7F,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,gFAAgF;AAChF,eAAO,MAAM,aAAa,qBAAO,CAAC"}
+{"version":3,"file":"retexture.d.ts","sourceRoot":"","sources":["../../src/cmd/retexture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAkG7F,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,gFAAgF;AAChF,eAAO,MAAM,aAAa,qBAAO,CAAC"}

package/dist/cmd/retexture.js

@@ -26,19 +26,20 @@ const spec = {
         configure(cmd) {
             return cmd
                 .option("--input-task-id <id>", "source Meshy task id (takes priority over --model-url)")
-                .option("--model-url <src>", "3D model as http(s) URL or local file path (.glb/.gltf/.obj/.fbx/.stl)")
+                .option("--model-url <src>", "3D model: an http(s) URL (.glb/.gltf/.obj/.fbx/.stl) or a local .glb/.gltf file — the API takes inline uploads as glTF only, so host .stl/.obj/.fbx at a URL")
                 .option("--text-style-prompt <text>", "text style description; mutually exclusive with --image-style-url")
                 .option("--image-style-url <src>", "style reference image (URL or local path); mutually exclusive with --text-style-prompt")
                 .option("--multiview-image-urls <csv>", "1-4 views of the SAME object as CSV, first entry is the front reference; each is a URL or local file path. Mutually exclusive with the two style flags", parseCsv)
-                .option("--enable-original-uv <bool>", "reuse the model's original UVs (default: true)", parseBool)
-                .option("--enable-pbr <bool>", "generate normal/metallic/roughness/emission maps (default: true, so game-engine imports carry the full map set)", parseBool)
+                .option("--enable-original-uv <bool>", "keep the model's existing UV layout — true suits Meshy outputs and models with good UVs (default: false, fresh UVs)", parseBool)
+                .option("--enable-pbr <bool>", "generate normal/metallic/roughness maps, plus an emission map on meshy-6 below 8k (default: true, so game-engine imports carry the full map set)", parseBool)
                 .addOption(new Option("--texture-resolution <res>", "base color texture size (default: 4k)").choices([
                 "2k",
                 "4k",
                 "8k",
             ]))
                 .option("--remove-lighting <bool>", "strip baked lighting from the base color (default: true)", parseBool)
-                .option("--target-formats <csv>", "glb,obj,fbx,stl,usdz,3mf (default: glb)", parseCsv);
+                .option("--target-formats <csv>", "glb,obj,fbx,stl,usdz,3mf (default: glb)", parseCsv)
+                .option("--alpha-thumbnail <bool>", "also render a transparent-background preview (alpha_thumbnail_url; default: false)", parseBool);
         },
         toPayload(opts) {
             if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
@@ -73,6 +74,7 @@ const spec = {
                 texture_resolution: opts.textureResolution,
                 remove_lighting: opts.removeLighting,
                 target_formats: opts.targetFormats,
+                alpha_thumbnail: opts.alphaThumbnail,
             };
         },
         toDefaults(opts) {

package/dist/cmd/retexture.js.map

@@ -1 +1 @@
-{"version":3,"file":"retexture.js","sourceRoot":"","sources":["../../src/cmd/retexture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retexture.js","sourceRoot":"","sources":["../../src/cmd/retexture.ts"],"names":[],"mappings":"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"}

package/dist/cmd/rigging.d.ts

@@ -1,6 +1,5 @@
 /**
  * rigging — https://docs.meshy.ai/en/api/rigging
- * Note: Meshy does not expose a list endpoint for rigging.
  */
 export declare const riggingCommand: import("commander").Command;
 //# sourceMappingURL=rigging.d.ts.map

package/dist/cmd/rigging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rigging.d.ts","sourceRoot":"","sources":["../../src/cmd/rigging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2CH,eAAO,MAAM,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"rigging.d.ts","sourceRoot":"","sources":["../../src/cmd/rigging.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+CH,eAAO,MAAM,cAAc,6BAA6B,CAAC"}

package/dist/cmd/rigging.js

@@ -1,6 +1,5 @@
 /**
  * rigging — https://docs.meshy.ai/en/api/rigging
- * Note: Meshy does not expose a list endpoint for rigging.
  */
 import { parseNumber } from "../internal/flags.js";
 import { UsageError } from "../internal/errors.js";
@@ -11,13 +10,13 @@ const spec = {
         "character as GLB + FBX plus bundled walking and running animations at no extra cost. " +
         "Input must be GLB with under 300k faces — remesh to ~10000 first if denser. Not suitable " +
         "for non-humanoid assets or models with unclear limb structure",
-    supportsList: false,
     create: {
         description: "Create a rigging task",
         configure(cmd) {
             return cmd
                 .option("--input-task-id <id>", "source Meshy task id (takes priority over --model-url)")
                 .option("--model-url <src>", "textured humanoid .glb as http(s) URL or local file path")
+                .option("--texture-image-url <src>", "the model's UV-unwrapped base color texture (.png; URL or local file) — for a --model-url input")
                 .option("--height-meters <m>", "approximate character height in meters (default: 1.7) — drives bone proportions", parseNumber);
         },
         toPayload(opts) {
@@ -27,6 +26,7 @@ const spec = {
             return {
                 input_task_id: opts.inputTaskId,
                 model_url: opts.modelUrl,
+                texture_image_url: opts.textureImageUrl,
                 height_meters: opts.heightMeters,
             };
         },

package/dist/cmd/rigging.js.map

@@ -1 +1 @@
-{"version":3,"file":"rigging.js","sourceRoot":"","sources":["../../src/cmd/rigging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,0FAA0F;QAC1F,uFAAuF;QACvF,2FAA2F;QAC3F,+DAA+D;IACjE,YAAY,EAAE,KAAK;IACnB,MAAM,EAAE;QACN,WAAW,EAAE,uBAAuB;QACpC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,wDAAwD,CAAC;iBACxF,MAAM,CAAC,mBAAmB,EAAE,0DAA0D,CAAC;iBACvF,MAAM,CACL,qBAAqB,EACrB,iFAAiF,EACjF,WAAW,CACZ,CAAC;QACN,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,aAAa,EAAE,IAAI,CAAC,YAAY;aACjC,CAAC;QACJ,CAAC;QACD,UAAU;YACR,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;QAChC,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"rigging.js","sourceRoot":"","sources":["../../src/cmd/rigging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,SAAS;IACf,WAAW,EACT,0FAA0F;QAC1F,uFAAuF;QACvF,2FAA2F;QAC3F,+DAA+D;IACjE,MAAM,EAAE;QACN,WAAW,EAAE,uBAAuB;QACpC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,wDAAwD,CAAC;iBACxF,MAAM,CAAC,mBAAmB,EAAE,0DAA0D,CAAC;iBACvF,MAAM,CACL,2BAA2B,EAC3B,iGAAiG,CAClG;iBACA,MAAM,CACL,qBAAqB,EACrB,iFAAiF,EACjF,WAAW,CACZ,CAAC;QACN,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtD,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,iBAAiB,EAAE,IAAI,CAAC,eAAe;gBACvC,aAAa,EAAE,IAAI,CAAC,YAAY;aACjC,CAAC;QACJ,CAAC;QACD,UAAU;YACR,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;QAChC,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO;CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/cmd/text-to-3d.d.ts

@@ -5,12 +5,11 @@
  * `--mode refine --preview-task-id <id>` textures it.
  *
  * The flag surface is deliberately minimal: topology and polycount are
- * remesh's job, resizing is resize's job, deprecated parameters
- * (symmetry_mode, lowpoly) are gone, and there is no model choice — the
- * server default "latest" applies. Unlike the image-driven endpoints, this
- * one has no meshy-7: its model set is meshy-5 / meshy-6 / latest, and
- * "latest" is still Meshy 6. The `--data` escape hatch still reaches
- * anything the API accepts.
+ * remesh's job (except smart topology's native polycount), resizing is
+ * resize's job, deprecated parameters (symmetry_mode, lowpoly, ultra_mode)
+ * are gone, and there is no model flag — the mode is the model: standard runs
+ * the server default "latest" (Meshy 7.1), smart-topology runs meshy-t2. The
+ * `--data` escape hatch still reaches anything the API accepts.
  */
 export declare const textTo3dCommand: import("commander").Command;
 //# sourceMappingURL=text-to-3d.d.ts.map

package/dist/cmd/text-to-3d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-to-3d.d.ts","sourceRoot":"","sources":["../../src/cmd/text-to-3d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyFH,eAAO,MAAM,eAAe,6BAA6B,CAAC"}
+{"version":3,"file":"text-to-3d.d.ts","sourceRoot":"","sources":["../../src/cmd/text-to-3d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4HH,eAAO,MAAM,eAAe,6BAA6B,CAAC"}

package/dist/cmd/text-to-3d.js

@@ -5,35 +5,38 @@
  * `--mode refine --preview-task-id <id>` textures it.
  *
  * The flag surface is deliberately minimal: topology and polycount are
- * remesh's job, resizing is resize's job, deprecated parameters
- * (symmetry_mode, lowpoly) are gone, and there is no model choice — the
- * server default "latest" applies. Unlike the image-driven endpoints, this
- * one has no meshy-7: its model set is meshy-5 / meshy-6 / latest, and
- * "latest" is still Meshy 6. The `--data` escape hatch still reaches
- * anything the API accepts.
+ * remesh's job (except smart topology's native polycount), resizing is
+ * resize's job, deprecated parameters (symmetry_mode, lowpoly, ultra_mode)
+ * are gone, and there is no model flag — the mode is the model: standard runs
+ * the server default "latest" (Meshy 7.1), smart-topology runs meshy-t2. The
+ * `--data` escape hatch still reaches anything the API accepts.
  */
 import { Option } from "commander";
-import { parseBool, parseCsv } from "../internal/flags.js";
+import { parseBool, parseCsv, parseInt10 } from "../internal/flags.js";
 import { UsageError } from "../internal/errors.js";
 import { buildResourceCommand } from "../internal/task-command.js";
 const spec = {
     name: "text-to-3d",
     description: "Generate 3D models from text prompts (two-stage: preview → refine). " +
-        "Topology/polycount are not tunable here — chain `remesh` afterwards",
+        "Topology/polycount are not tunable in standard mode — chain `remesh` afterwards; " +
+        "smart-topology mode has a native polycount",
     create: {
         description: "Create a text-to-3d task",
         configure(cmd) {
             return cmd
                 .addOption(new Option("--mode <mode>", "preview | refine").choices(["preview", "refine"]))
-                .option("--prompt <text>", "required in preview mode; max 600 chars")
+                .option("--prompt <text>", "required in preview mode; max 800 chars")
                 .option("--preview-task-id <id>", "required in refine mode. Must be a SUCCEEDED text-to-3d preview task — refine " +
                 "consumes the preview's latents, so uploaded models or image-to-3d/remesh outputs " +
                 "cannot be refined (use retexture for those)")
                 .addOption(new Option("--pose-mode <pose>", "preview only. a-pose | t-pose pre-pose characters for rigging; auto (default) lets the model decide").choices(["a-pose", "t-pose", "auto"]))
-                .option("--enable-pbr <bool>", "refine only. Generate normal/metallic/roughness/emission maps (default: true, so game-engine imports carry the full map set)", parseBool)
-                .option("--texture-prompt <text>", "refine only. Extra texture guidance (max 600 chars)")
-                .addOption(new Option("--texture-resolution <res>", "refine only. Base color texture size (default: 4k)").choices(["2k", "4k", "8k"]))
-                .option("--remove-lighting <bool>", "refine only. Strip baked lighting from the base color (default: true)", parseBool)
+                .addOption(new Option("--model-type <kind>", "preview only. standard (default; full-detail generation) | smart-topology (meshy-t2: clean triangle topology, separated parts, native --target-polycount)").choices(["standard", "smart-topology"]))
+                .option("--target-polycount <n>", "preview, smart-topology only: target face count, 100-15000 (default: 10000)", parseInt10)
+                .addOption(new Option("--geometry-resolution <res>", "preview, standard only: standard (default) | 2k | 4k — the Ultra geometry pass at 2048³ / 4096³ (needs meshy-7.1 / latest, the default; billed on top)").choices(["standard", "2k", "4k"]))
+                .option("--enable-pbr <bool>", "refine only. Generate normal/metallic/roughness maps, plus an emission map on meshy-6 below 8k (default: true, so game-engine imports carry the full map set)", parseBool)
+                .option("--texture-prompt <text>", "refine only. Extra texture guidance (max 800 chars)")
+                .addOption(new Option("--texture-resolution <res>", "refine only. Base color texture size (default: the server's, 2k). 4k/8k need a meshy-6, meshy-7.1 or latest preview — a meshy-6-lite preview refuses them").choices(["2k", "4k", "8k"]))
+                .option("--remove-lighting <bool>", "refine only. Strip baked lighting from the base color (default: the server's — on for meshy-6/7; a meshy-6-lite preview refuses the flag)", parseBool)
                 .option("--target-formats <csv>", "glb,obj,fbx,stl,usdz,3mf (default: glb)", parseCsv);
         },
         toPayload(opts) {
@@ -44,12 +47,31 @@ const spec = {
             if (mode === "refine" && !opts.previewTaskId) {
                 throw new UsageError("--mode refine requires --preview-task-id");
             }
+            if (mode === "refine") {
+                for (const [flag, value] of [["--model-type", opts.modelType], ["--target-polycount", opts.targetPolycount], ["--geometry-resolution", opts.geometryResolution]]) {
+                    if (value !== undefined)
+                        throw new UsageError(`${flag} applies to --mode preview only (refine inherits the preview's geometry)`);
+                }
+            }
+            const smart = opts.modelType === "smart-topology";
+            if (opts.targetPolycount !== undefined && !smart) {
+                throw new UsageError("--target-polycount applies to --model-type smart-topology only; for standard outputs chain `remesh` afterwards");
+            }
+            if (opts.targetPolycount !== undefined && (opts.targetPolycount < 100 || opts.targetPolycount > 15000)) {
+                throw new UsageError("--target-polycount must be between 100 and 15000");
+            }
+            if (smart && opts.geometryResolution !== undefined && opts.geometryResolution !== "standard") {
+                throw new UsageError("--geometry-resolution 2k/4k needs meshy-7.1 (standard); smart-topology runs meshy-t2");
+            }
             return {
                 mode,
                 prompt: opts.prompt,
                 preview_task_id: opts.previewTaskId,
                 // "auto" means "let the model decide" — the API's default, expressed by omission.
                 pose_mode: opts.poseMode === "auto" ? undefined : opts.poseMode,
+                model_type: opts.modelType,
+                target_polycount: opts.targetPolycount,
+                geometry_resolution: opts.geometryResolution,
                 enable_pbr: opts.enablePbr,
                 texture_prompt: opts.texturePrompt,
                 texture_resolution: opts.textureResolution,
@@ -58,17 +80,20 @@ const spec = {
             };
         },
         toDefaults(opts) {
-            // Game-ready refine defaults: full PBR map set and 4k textures, priced
-            // the same as the API's bare defaults. The model is not a choice —
-            // the server default (latest, still Meshy 6 on this endpoint) applies;
-            // override via --data.
+            // Refine inherits its model from the preview, and the task GET does not
+            // say which model that was. So only what every refine target accepts is
+            // pinned here: the full PBR map set. texture_resolution 4k and
+            // remove_lighting are refused (400) for a meshy-6-lite preview, so they
+            // ride only when asked for — the server's own defaults (2k; lighting
+            // removed on meshy-6/7) apply otherwise. `make` still asks for 4k: it
+            // made the preview itself, on latest.
             // GLB-only output — omitting target_formats makes the API produce
-            // every format.
+            // every format. Smart topology gets image-to-3d's rigging-friendly 10k
+            // polycount, so the two commands default alike.
             const refine = opts.mode === "refine";
             return {
                 enable_pbr: refine ? true : undefined,
-                texture_resolution: refine ? "4k" : undefined,
-                remove_lighting: refine ? true : undefined,
+                target_polycount: opts.modelType === "smart-topology" ? 10_000 : undefined,
                 target_formats: ["glb"],
             };
         },

package/dist/cmd/text-to-3d.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-to-3d.js","sourceRoot":"","sources":["../../src/cmd/text-to-3d.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"text-to-3d.js","sourceRoot":"","sources":["../../src/cmd/text-to-3d.ts"],"names":[],"mappings":"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"}

package/dist/cmd/text-to-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-to-image.d.ts","sourceRoot":"","sources":["../../src/cmd/text-to-image.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkEH,eAAO,MAAM,kBAAkB,6BAA6B,CAAC"}
+{"version":3,"file":"text-to-image.d.ts","sourceRoot":"","sources":["../../src/cmd/text-to-image.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoEH,eAAO,MAAM,kBAAkB,6BAA6B,CAAC"}

package/dist/cmd/text-to-image.js

@@ -21,7 +21,8 @@ const spec = {
                 "a-pose",
                 "t-pose",
             ]))
-                .addOption(new Option("--aspect-ratio <ratio>", ASPECT_RATIO_HELP).choices([...ASPECT_RATIOS]));
+                .addOption(new Option("--aspect-ratio <ratio>", ASPECT_RATIO_HELP).choices([...ASPECT_RATIOS]))
+                .option("--remove-background <bool>", "return a transparent RGBA PNG with the background removed (default: false)", parseBool);
         },
         toPayload(opts) {
             if (!opts.prompt && !opts.data) {
@@ -41,6 +42,7 @@ const spec = {
                 generate_multi_view: opts.generateMultiView,
                 pose_mode: opts.poseMode,
                 aspect_ratio: opts.aspectRatio,
+                remove_background: opts.removeBackground,
             };
         },
         toDefaults() {

package/dist/cmd/text-to-image.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-to-image.js","sourceRoot":"","sources":["../../src/cmd/text-to-image.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,iFAAiF;QACjF,wBAAwB;IAC1B,MAAM,EAAE;QACN,WAAW,EAAE,6BAA6B;QAC1C,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,SAAS,CAAC,IAAI,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;iBACxF,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;iBAC1F,MAAM,CACL,8BAA8B,EAC9B,6GAA6G,EAC7G,SAAS,CACV;iBACA,SAAS,CACR,IAAI,MAAM,CAAC,oBAAoB,EAAE,uCAAuC,CAAC,CAAC,OAAO,CAAC;gBAChF,QAAQ;gBACR,QAAQ;aACT,CAAC,CACH;iBACA,SAAS,CAAC,IAAI,MAAM,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QACpG,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,IAAI,UAAU,CAAC,sBAAsB,CAAC,CAAC;YAC/C,CAAC;YACD,eAAe,CAAC;gBACd,qEAAqE;gBACrE,mEAAmE;gBACnE,yBAAyB;gBACzB,OAAO,EAAG,IAAI,CAAC,OAA8B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC;gBAC9F,WAAW,EAAE,IAAI,CAAC,WAAiC;gBACnD,iBAAiB,EAAE,IAAI,CAAC,iBAAwC;aACjE,CAAC,CAAC;YACH,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,OAAO;gBACtB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;gBAC3C,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,YAAY,EAAE,IAAI,CAAC,WAAW;aAC/B,CAAC;QACJ,CAAC;QACD,UAAU;YACR,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QAC3C,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"text-to-image.js","sourceRoot":"","sources":["../../src/cmd/text-to-image.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,iFAAiF;QACjF,wBAAwB;IAC1B,MAAM,EAAE;QACN,WAAW,EAAE,6BAA6B;QAC1C,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,SAAS,CAAC,IAAI,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;iBACxF,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;iBAC1F,MAAM,CACL,8BAA8B,EAC9B,6GAA6G,EAC7G,SAAS,CACV;iBACA,SAAS,CACR,IAAI,MAAM,CAAC,oBAAoB,EAAE,uCAAuC,CAAC,CAAC,OAAO,CAAC;gBAChF,QAAQ;gBACR,QAAQ;aACT,CAAC,CACH;iBACA,SAAS,CAAC,IAAI,MAAM,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;iBAC9F,MAAM,CAAC,4BAA4B,EAAE,4EAA4E,EAAE,SAAS,CAAC,CAAC;QACnI,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,IAAI,UAAU,CAAC,sBAAsB,CAAC,CAAC;YAC/C,CAAC;YACD,eAAe,CAAC;gBACd,qEAAqE;gBACrE,mEAAmE;gBACnE,yBAAyB;gBACzB,OAAO,EAAG,IAAI,CAAC,OAA8B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC;gBAC9F,WAAW,EAAE,IAAI,CAAC,WAAiC;gBACnD,iBAAiB,EAAE,IAAI,CAAC,iBAAwC;aACjE,CAAC,CAAC;YACH,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,OAAO;gBACtB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;gBAC3C,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,YAAY,EAAE,IAAI,CAAC,WAAW;gBAC9B,iBAAiB,EAAE,IAAI,CAAC,gBAAgB;aACzC,CAAC;QACJ,CAAC;QACD,UAAU;YACR,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;QAC3C,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW;CACjC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/cmd/usage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * usage — GET /openapi/v1/usage/tasks: the team's finished API tasks with the
+ * credits each consumed (Studio / Enterprise teams; 403 otherwise). Free. One
+ * page per call; the window defaults to the last 30 days and spans at most a
+ * year. Items are passed through as the API returns them.
+ */
+import { Command } from "commander";
+export declare const USAGE_TASKS_PATH = "/usage/tasks";
+export declare const usageCommand: Command;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cmd/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cmd/usage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAkD/C,eAAO,MAAM,YAAY,SAEE,CAAC"}

package/dist/cmd/usage.js

@@ -0,0 +1,61 @@
+/**
+ * usage — GET /openapi/v1/usage/tasks: the team's finished API tasks with the
+ * credits each consumed (Studio / Enterprise teams; 403 otherwise). Free. One
+ * page per call; the window defaults to the last 30 days and spans at most a
+ * year. Items are passed through as the API returns them.
+ */
+import { Command, Option } from "commander";
+import { emitResult, listItems, openCommand, rejectOutputFlagForV1, saveRawJson } from "../internal/command-helpers.js";
+import { abortSignal } from "../internal/context.js";
+import { UsageError } from "../internal/errors.js";
+import { parseCsv, parseInt10 } from "../internal/flags.js";
+import { buildRuntime } from "../internal/runtime.js";
+export const USAGE_TASKS_PATH = "/usage/tasks";
+function rfc3339(flag, value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^\d{4}-\d{2}-\d{2}T/.test(value) || Number.isNaN(Date.parse(value))) {
+        throw new UsageError(`${flag} must be an RFC 3339 timestamp, e.g. 2026-08-01T00:00:00Z`);
+    }
+    return value;
+}
+const tasksCommand = new Command("tasks")
+    .description("List finished API tasks with the credits each consumed (Studio/Enterprise teams; free)")
+    .option("--page <n>", "page number (1-based)", parseInt10, 1)
+    .option("--page-size <n>", "1-100", parseInt10, 10)
+    .addOption(new Option("--sort-by <field>", "sort order").choices(["-created_at", "+created_at"]).default("-created_at"))
+    .option("--start-time <rfc3339>", "start of the created_at window (default: 30 days before --end-time)")
+    .option("--end-time <rfc3339>", "end of the created_at window (default: now); a window spans at most 1 year")
+    .option("--endpoints <csv>", "endpoint names to include, e.g. image-to-3d,text-to-3d (text-to-3d covers preview and refine)", parseCsv)
+    .addOption(new Option("--status <status>", "terminal status filter").choices(["SUCCEEDED", "FAILED"]))
+    .option("--save-json <file>", "save the untouched response to this file (never overwrites)")
+    .action(async (opts, thisCmd) => {
+    const opened = openCommand(thisCmd, "usage.tasks", "v1");
+    rejectOutputFlagForV1(opened, opts.saveJson);
+    if (!Number.isInteger(opts.page) || opts.page < 1)
+        throw new UsageError("--page must be a positive integer");
+    if (!Number.isInteger(opts.pageSize) || opts.pageSize < 1 || opts.pageSize > 100)
+        throw new UsageError("--page-size must be between 1 and 100");
+    const page = { page_num: opts.page, page_size: opts.pageSize, sort_by: opts.sortBy };
+    const filters = {
+        start_time: rfc3339("--start-time", opts.startTime) ?? null,
+        end_time: rfc3339("--end-time", opts.endTime) ?? null,
+        endpoints: opts.endpoints?.join(",") ?? null,
+        status: opts.status ?? null,
+    };
+    const runtime = await buildRuntime(opened.flags);
+    const raw = await runtime.client.getV1(USAGE_TASKS_PATH, {
+        ...page,
+        start_time: filters.start_time ?? undefined,
+        end_time: filters.end_time ?? undefined,
+        endpoints: filters.endpoints ?? undefined,
+        status: filters.status ?? undefined,
+    }, { signal: abortSignal() });
+    const items = listItems(raw, USAGE_TASKS_PATH);
+    const saved = opts.saveJson ? saveRawJson(opts.saveJson, raw, { workspace: opened.flags.workspaceRoot }) : null;
+    await emitResult(opened, items, { items, count: items.length, page, filters, saved_json: saved });
+});
+export const usageCommand = new Command("usage")
+    .description("Account usage records (Studio/Enterprise teams)")
+    .addCommand(tasksCommand);
+//# sourceMappingURL=usage.js.map

package/dist/cmd/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/cmd/usage.ts"],"names":[],"mappings":"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"}

package/dist/internal/artifacts.d.ts

@@ -11,6 +11,7 @@
  *   - lamp build: `lamp_stl` / `base_stl` are STL files, `bundle_zip` is a ZIP;
  *   - keychain / fridge-magnet build: `model_urls.obj` is a ZIP bundle
  *     (model.obj + model.mtl + texture.png), delivered as `.zip`, unextracted;
+ *   - keycap build: `model_urls.obj_zip` is the same kind of bundle;
  *   - motion clips carry their format in `result.motion_format`.
  */
 import type { TaskResourceDescriptor } from "../client/resource-registry.js";

package/dist/internal/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/internal/artifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/internal/artifacts.ts"],"names":[],"mappings":"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"}