@meshy-ai/cli 0.1.0

package/dist/cmd/multi-image-to-3d.js

@@ -0,0 +1,72 @@
+/**
+ * multi-image-to-3d — https://docs.meshy.ai/en/api/multi-image-to-3d
+ */
+import { Option } from "commander";
+import { parseBool, parseCsv } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "multi-image-to-3d",
+    description: "Generate a 3D model from 1-4 viewpoint images of a single object. Beta and unstable — " +
+        "prefer image-to-3d unless multi-view input is explicitly required. Each input must be a " +
+        "separate single-view image, never one grid/collage. Topology/polycount are not tunable " +
+        "here — chain `remesh` afterwards",
+    create: {
+        description: "Create a multi-image-to-3d task",
+        configure(cmd) {
+            return cmd
+                .option("--image-urls <csv>", "1-4 reference images as CSV, ideally front/side/back; each entry is a URL or local file path", parseCsv)
+                .option("--input-task-id <id>", "alternative to --image-urls: a SUCCEEDED text-to-image or image-to-image task (e.g. multi-view output) whose images become the source views")
+                .option("--should-texture <bool>", "generate textures (default: false — draft white mesh; texture later with retexture)", parseBool)
+                .option("--enable-pbr <bool>", "generate normal/metallic/roughness/emission maps (default: true, so game-engine imports carry the full map set)", parseBool)
+                .option("--texture-prompt <text>", "text guidance for texturing (max 600 chars)")
+                .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);
+        },
+        toPayload(opts) {
+            const urls = opts.imageUrls;
+            if (!opts.inputTaskId && (!urls || urls.length < 1 || urls.length > 4) && !opts.data) {
+                throw new UsageError("provide --image-urls (CSV of 1-4) or --input-task-id");
+            }
+            // The API rejects texture knobs on untextured runs; catch it before the wire.
+            if (opts.shouldTexture !== true && !opts.data) {
+                for (const [flag, value] of [
+                    ["--enable-pbr", opts.enablePbr],
+                    ["--texture-resolution", opts.textureResolution],
+                    ["--texture-prompt", opts.texturePrompt],
+                ]) {
+                    if (value !== undefined) {
+                        throw new UsageError(`${flag} requires --should-texture true (the default output is an untextured draft mesh)`);
+                    }
+                }
+            }
+            return {
+                image_urls: urls,
+                input_task_id: opts.inputTaskId,
+                should_texture: opts.shouldTexture,
+                enable_pbr: opts.enablePbr,
+                texture_prompt: opts.texturePrompt,
+                texture_resolution: opts.textureResolution,
+                remove_lighting: opts.removeLighting,
+                target_formats: opts.targetFormats,
+            };
+        },
+        toDefaults(opts) {
+            // Draft-first, matching image-to-3d: white mesh by default, texturing
+            // is its own step; texture knobs ride only when texturing is on (the
+            // API rejects them otherwise), then game-ready values apply. No model
+            // choice — the server default (latest = meshy-6) applies.
+            const texturing = opts.shouldTexture === true;
+            return {
+                should_texture: false,
+                enable_pbr: texturing ? true : undefined,
+                texture_resolution: texturing ? "4k" : undefined,
+                target_formats: ["glb"],
+            };
+        },
+    },
+    endpointOf: (c) => c.multiImageTo3d,
+};
+export const multiImageTo3dCommand = buildResourceCommand(spec);
+//# sourceMappingURL=multi-image-to-3d.js.map

package/dist/cmd/multi-image-to-3d.js.map

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

package/dist/cmd/remesh.d.ts

@@ -0,0 +1,8 @@
+/**
+ * remesh — https://docs.meshy.ai/en/api/remesh
+ *
+ * Geometry only: topology and polycount. Format-only conversion is the
+ * standalone `convert` command; size changes are `resize`.
+ */
+export declare const remeshCommand: import("commander").Command;
+//# sourceMappingURL=remesh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remesh.d.ts","sourceRoot":"","sources":["../../src/cmd/remesh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyDH,eAAO,MAAM,aAAa,6BAA6B,CAAC"}

package/dist/cmd/remesh.js

@@ -0,0 +1,49 @@
+/**
+ * remesh — https://docs.meshy.ai/en/api/remesh
+ *
+ * Geometry only: topology and polycount. Format-only conversion is the
+ * standalone `convert` command; size changes are `resize`.
+ */
+import { Option } from "commander";
+import { parseCsv, parseInt10 } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "remesh",
+    description: "Regenerate the geometry of a 3D model — change topology (quad/triangle) and polygon " +
+        "count; textures and position are preserved. For format-only changes use `convert`; " +
+        "for size changes use `resize`",
+    create: {
+        description: "Create a remesh task",
+        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)")
+                .addOption(new Option("--topology <kind>", "quad (rigging/CAD/subdivision-friendly) | triangle (default; native engine topology)").choices(["quad", "triangle"]))
+                .option("--target-polycount <n>", "100-300000 (default: 30000). Rigging tip: ~10000 rigs well", parseInt10)
+                .addOption(new Option("--decimation-mode <level>", "adaptive 1|2|3|4; when set, overrides --target-polycount")
+                .choices(["1", "2", "3", "4"]))
+                .option("--target-formats <csv>", "glb,fbx,obj,usdz,blend,stl,3mf (default: glb)", parseCsv);
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+                topology: opts.topology,
+                target_polycount: opts.targetPolycount,
+                decimation_mode: opts.decimationMode == null ? undefined : Number(opts.decimationMode),
+                target_formats: opts.targetFormats,
+            };
+        },
+        toDefaults() {
+            // GLB only unless asked otherwise.
+            return { target_formats: ["glb"] };
+        },
+    },
+    endpointOf: (c) => c.remesh,
+};
+export const remeshCommand = buildResourceCommand(spec);
+//# sourceMappingURL=remesh.js.map

package/dist/cmd/remesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remesh.js","sourceRoot":"","sources":["../../src/cmd/remesh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC5D,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,sFAAsF;QACtF,qFAAqF;QACrF,+BAA+B;IACjC,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,wEAAwE,CAAC;iBACrG,SAAS,CACR,IAAI,MAAM,CACR,mBAAmB,EACnB,sFAAsF,CACvF,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAChC;iBACA,MAAM,CACL,wBAAwB,EACxB,4DAA4D,EAC5D,UAAU,CACX;iBACA,SAAS,CACR,IAAI,MAAM,CAAC,2BAA2B,EAAE,0DAA0D,CAAC;iBAChG,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CACjC;iBACA,MAAM,CAAC,wBAAwB,EAAE,+CAA+C,EAAE,QAAQ,CAAC,CAAC;QACjG,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,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,gBAAgB,EAAE,IAAI,CAAC,eAAe;gBACtC,eAAe,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;gBACtF,cAAc,EAAE,IAAI,CAAC,aAAa;aACnC,CAAC;QACJ,CAAC;QACD,UAAU;YACR,mCAAmC;YACnC,OAAO,EAAE,cAAc,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,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/repair-printability.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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.
+ */
+export declare const repairPrintabilityCommand: import("commander").Command;
+//# sourceMappingURL=repair-printability.d.ts.map

package/dist/cmd/repair-printability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-printability.d.ts","sourceRoot":"","sources":["../../src/cmd/repair-printability.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH,eAAO,MAAM,yBAAyB,6BAA6B,CAAC"}

package/dist/cmd/repair-printability.js

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.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",
+    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)");
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+            };
+        },
+    },
+    endpointOf: (c) => c.repairPrintability,
+};
+export const repairPrintabilityCommand = buildResourceCommand(spec);
+//# sourceMappingURL=repair-printability.js.map

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

@@ -0,0 +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"}

package/dist/cmd/resize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * resize — https://docs.meshy.ai/en/api/resize
+ *
+ * Standalone model resizing (extracted from remesh by Meshy in May 2026).
+ * Exactly one sizing mode per task.
+ */
+export declare const resizeCommand: import("commander").Command;
+//# sourceMappingURL=resize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/cmd/resize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoDH,eAAO,MAAM,aAAa,6BAA6B,CAAC"}

package/dist/cmd/resize.js

@@ -0,0 +1,51 @@
+/**
+ * resize — https://docs.meshy.ai/en/api/resize
+ *
+ * Standalone model resizing (extracted from remesh by Meshy in May 2026).
+ * Exactly one sizing mode per task.
+ */
+import { Option } from "commander";
+import { parseBool, parseNumber } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "resize",
+    description: "Resize a 3D model to real-world dimensions — set a target height, a longest-side " +
+        "length, or let AI estimate the real size",
+    create: {
+        description: "Create a resize task",
+        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("--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)
+                .addOption(new Option("--origin-at <where>", "bottom (default) | center").choices(["bottom", "center"]));
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            const modes = [
+                opts.resizeHeight != null,
+                opts.resizeLongestSide != null,
+                opts.autoSize === true,
+            ].filter(Boolean).length;
+            if (modes !== 1 && !opts.data) {
+                throw new UsageError("provide exactly one sizing mode: --resize-height, --resize-longest-side, or --auto-size true");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+                resize_height: opts.resizeHeight,
+                resize_longest_side: opts.resizeLongestSide,
+                auto_size: opts.autoSize,
+                origin_at: opts.originAt,
+            };
+        },
+    },
+    endpointOf: (c) => c.resize,
+};
+export const resizeCommand = buildResourceCommand(spec);
+//# sourceMappingURL=resize.js.map

package/dist/cmd/resize.js.map

@@ -0,0 +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"}

package/dist/cmd/resources.d.ts

@@ -0,0 +1,18 @@
+/**
+ * resources — the index for the per-endpoint commands.
+ *
+ * Those commands stay registered and stay supported; they are simply not what
+ * the root help leads with. An agent that reads `--help` on every invocation
+ * pays for the whole surface every time, so the root lists the one verb most
+ * callers need and points here for the rest.
+ */
+import { Command } from "commander";
+interface ResourceEntry {
+    name: string;
+    summary: string;
+}
+/** Kept in registration order, matching root.ts. */
+export declare const RESOURCES: ResourceEntry[];
+export declare const resourcesCommand: Command;
+export {};
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/cmd/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,EAAE,aAAa,EAiBpC,CAAC;AAkBF,eAAO,MAAM,gBAAgB,SAYzB,CAAC"}

package/dist/cmd/resources.js

@@ -0,0 +1,59 @@
+/**
+ * resources — the index for the per-endpoint commands.
+ *
+ * Those commands stay registered and stay supported; they are simply not what
+ * the root help leads with. An agent that reads `--help` on every invocation
+ * pays for the whole surface every time, so the root lists the one verb most
+ * callers need and points here for the rest.
+ */
+import { Command } from "commander";
+import { emit } from "../internal/output.js";
+import { readGlobalFlags } from "../internal/runtime.js";
+/** Kept in registration order, matching root.ts. */
+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: "remesh", summary: "retopologize / change polycount" },
+    { name: "convert", summary: "change file format only" },
+    { name: "resize", summary: "resize to real-world dimensions" },
+    { name: "rigging", summary: "rig a humanoid mesh (+ bundled walk/run animations)" },
+    { name: "animate", summary: "apply an animation clip to a rigged mesh" },
+    { name: "retexture", summary: "regenerate textures" },
+    { name: "text-to-image", summary: "2D image generation" },
+    { name: "image-to-image", summary: "2D image editing" },
+    { name: "multi-color-print", summary: "color-separated 3D print output" },
+    { 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" },
+];
+const VERBS = `Every resource carries the same verbs:
+
+    meshy <resource> create [flags] [--data '<json>'] [--async] [--timeout <s>]
+    meshy <resource> get    <task-id>
+    meshy <resource> list   [--page <n>] [--page-size <n>] [--sort-by <field>]
+    meshy <resource> wait   <task-id> [--timeout <s>]
+    meshy <resource> delete <task-id>
+
+\`create\` is sync by default — it blocks until the task is terminal. Pass
+--async for the task id straight away, then \`wait\`/\`get\` it later.
+
+Endpoints without a dedicated command are reachable through the passthrough:
+
+    meshy api GET  /balance
+    meshy api POST /text-to-3d --data '{"mode":"preview","prompt":"car"}'`;
+export const resourcesCommand = new Command("resources")
+    .description("List the per-endpoint commands and the verbs they share")
+    .addHelpText("after", `\n${VERBS}\n`)
+    .action((_opts, thisCmd) => {
+    const { format } = readGlobalFlags(thisCmd);
+    if (format === "pretty") {
+        const width = Math.max(...RESOURCES.map((r) => r.name.length));
+        const lines = RESOURCES.map((r) => `  ${r.name.padEnd(width)}  ${r.summary}`);
+        process.stdout.write(`${lines.join("\n")}\n\n${VERBS}\n`);
+        return;
+    }
+    emit(RESOURCES, { format });
+});
+//# sourceMappingURL=resources.js.map

package/dist/cmd/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/cmd/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD,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,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;CACtE,CAAC;AAEF,MAAM,KAAK,GAAG;;;;;;;;;;;;;;0EAc4D,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,CAAC,KAA8B,EAAE,OAAgB,EAAE,EAAE;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/cmd/retexture.d.ts

@@ -0,0 +1,5 @@
+/**
+ * retexture — https://docs.meshy.ai/en/api/retexture
+ */
+export declare const retextureCommand: import("commander").Command;
+//# sourceMappingURL=retexture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retexture.d.ts","sourceRoot":"","sources":["../../src/cmd/retexture.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6EH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC"}

package/dist/cmd/retexture.js

@@ -0,0 +1,64 @@
+/**
+ * retexture — https://docs.meshy.ai/en/api/retexture
+ */
+import { Option } from "commander";
+import { parseBool, parseCsv } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "retexture",
+    description: "Regenerate the textures of a 3D model from a style prompt or a style image — prefer a " +
+        "reference image showing the desired final look",
+    create: {
+        description: "Create a retexture task",
+        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("--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("--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)
+                .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);
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            if (!opts.textStylePrompt && !opts.imageStyleUrl && !opts.data) {
+                throw new UsageError("provide --text-style-prompt or --image-style-url");
+            }
+            if (opts.textStylePrompt && opts.imageStyleUrl) {
+                throw new UsageError("--text-style-prompt and --image-style-url are mutually exclusive");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+                text_style_prompt: opts.textStylePrompt,
+                image_style_url: opts.imageStyleUrl,
+                enable_original_uv: opts.enableOriginalUv,
+                enable_pbr: opts.enablePbr,
+                texture_resolution: opts.textureResolution,
+                remove_lighting: opts.removeLighting,
+                target_formats: opts.targetFormats,
+            };
+        },
+        toDefaults() {
+            // Game-ready defaults (agent-ts parity); see image-to-3d.
+            return {
+                enable_pbr: true,
+                texture_resolution: "4k",
+                target_formats: ["glb"],
+            };
+        },
+    },
+    endpointOf: (c) => c.retexture,
+};
+export const retextureCommand = buildResourceCommand(spec);
+//# sourceMappingURL=retexture.js.map

package/dist/cmd/retexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retexture.js","sourceRoot":"","sources":["../../src/cmd/retexture.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,wFAAwF;QACxF,gDAAgD;IAClD,MAAM,EAAE;QACN,WAAW,EAAE,yBAAyB;QACtC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,wDAAwD,CAAC;iBACxF,MAAM,CAAC,mBAAmB,EAAE,wEAAwE,CAAC;iBACrG,MAAM,CAAC,4BAA4B,EAAE,mEAAmE,CAAC;iBACzG,MAAM,CACL,yBAAyB,EACzB,wFAAwF,CACzF;iBACA,MAAM,CAAC,6BAA6B,EAAE,gDAAgD,EAAE,SAAS,CAAC;iBAClG,MAAM,CACL,qBAAqB,EACrB,iHAAiH,EACjH,SAAS,CACV;iBACA,SAAS,CACR,IAAI,MAAM,CAAC,4BAA4B,EAAE,uCAAuC,CAAC,CAAC,OAAO,CAAC;gBACxF,IAAI;gBACJ,IAAI;gBACJ,IAAI;aACL,CAAC,CACH;iBACA,MAAM,CACL,0BAA0B,EAC1B,0DAA0D,EAC1D,SAAS,CACV;iBACA,MAAM,CAAC,wBAAwB,EAAE,yCAAyC,EAAE,QAAQ,CAAC,CAAC;QAC3F,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,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/D,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC/C,MAAM,IAAI,UAAU,CAAC,kEAAkE,CAAC,CAAC;YAC3F,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,iBAAiB,EAAE,IAAI,CAAC,eAAe;gBACvC,eAAe,EAAE,IAAI,CAAC,aAAa;gBACnC,kBAAkB,EAAE,IAAI,CAAC,gBAAgB;gBACzC,UAAU,EAAE,IAAI,CAAC,SAAS;gBAC1B,kBAAkB,EAAE,IAAI,CAAC,iBAAiB;gBAC1C,eAAe,EAAE,IAAI,CAAC,cAAc;gBACpC,cAAc,EAAE,IAAI,CAAC,aAAa;aACnC,CAAC;QACJ,CAAC;QACD,UAAU;YACR,0DAA0D;YAC1D,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,kBAAkB,EAAE,IAAI;gBACxB,cAAc,EAAE,CAAC,KAAK,CAAC;aACxB,CAAC;QACJ,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/cmd/rigging.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 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

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

package/dist/cmd/rigging.js

@@ -0,0 +1,40 @@
+/**
+ * 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";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "rigging",
+    description: "Rig a 3D model with a bipedal humanoid skeleton (skinning included). Returns the rigged " +
+        "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("--height-meters <m>", "approximate character height in meters (default: 1.7) — drives bone proportions", parseNumber);
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+                height_meters: opts.heightMeters,
+            };
+        },
+        toDefaults() {
+            return { height_meters: 1.7 };
+        },
+    },
+    endpointOf: (c) => c.rigging,
+};
+export const riggingCommand = buildResourceCommand(spec);
+//# sourceMappingURL=rigging.js.map

package/dist/cmd/rigging.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+/**
+ * text-to-3d — https://docs.meshy.ai/en/api/text-to-3d
+ *
+ * Two-stage flow: `--mode preview` generates geometry, then
+ * `--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 = meshy-6) applies. 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

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

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

@@ -0,0 +1,76 @@
+/**
+ * text-to-3d — https://docs.meshy.ai/en/api/text-to-3d
+ *
+ * Two-stage flow: `--mode preview` generates geometry, then
+ * `--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 = meshy-6) applies. The `--data` escape hatch
+ * still reaches anything the API accepts.
+ */
+import { Option } from "commander";
+import { parseBool, parseCsv } 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",
+    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("--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)
+                .option("--target-formats <csv>", "glb,obj,fbx,stl,usdz,3mf (default: glb)", parseCsv);
+        },
+        toPayload(opts) {
+            const mode = opts.mode;
+            if (mode === "preview" && !opts.prompt) {
+                throw new UsageError("--mode preview requires --prompt");
+            }
+            if (mode === "refine" && !opts.previewTaskId) {
+                throw new UsageError("--mode refine requires --preview-task-id");
+            }
+            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,
+                enable_pbr: opts.enablePbr,
+                texture_prompt: opts.texturePrompt,
+                texture_resolution: opts.textureResolution,
+                remove_lighting: opts.removeLighting,
+                target_formats: opts.targetFormats,
+            };
+        },
+        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 = meshy-6) applies; override via --data.
+            // GLB-only output — omitting target_formats makes the API produce
+            // every format.
+            const refine = opts.mode === "refine";
+            return {
+                enable_pbr: refine ? true : undefined,
+                texture_resolution: refine ? "4k" : undefined,
+                remove_lighting: refine ? true : undefined,
+                target_formats: ["glb"],
+            };
+        },
+    },
+    endpointOf: (c) => c.textTo3d,
+};
+export const textTo3dCommand = buildResourceCommand(spec);
+//# sourceMappingURL=text-to-3d.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,5 @@
+/**
+ * text-to-image — https://docs.meshy.ai/en/api/text-to-image
+ */
+export declare const textToImageCommand: import("commander").Command;
+//# sourceMappingURL=text-to-image.d.ts.map

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

@@ -0,0 +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"}