@meshy-ai/cli 0.1.0

package/dist/cmd/convert.js

@@ -0,0 +1,40 @@
+/**
+ * convert — https://docs.meshy.ai/en/api/convert
+ *
+ * Standalone format conversion (extracted from remesh by Meshy in May 2026).
+ * The task type is `convert`, so get/wait/delete live right here.
+ */
+import { parseCsv } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "convert",
+    description: "Convert a 3D model to one or more target formats without altering its topology or " +
+        "polycount",
+    create: {
+        description: "Create a convert task",
+        configure(cmd) {
+            return cmd
+                .option("--input-task-id <id>", "source SUCCEEDED task (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("--target-formats <csv>", "required — glb,fbx,obj,usdz,blend,stl,3mf", parseCsv);
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            const formats = opts.targetFormats;
+            if ((!formats || formats.length === 0) && !opts.data) {
+                throw new UsageError("--target-formats is required (e.g. --target-formats fbx,obj)");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+                target_formats: formats,
+            };
+        },
+    },
+    endpointOf: (c) => c.convert,
+};
+export const convertCommand = buildResourceCommand(spec);
+//# sourceMappingURL=convert.js.map

package/dist/cmd/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/cmd/convert.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,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,oFAAoF;QACpF,WAAW;IACb,MAAM,EAAE;QACN,WAAW,EAAE,uBAAuB;QACpC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,yDAAyD,CAAC;iBACzF,MAAM,CAAC,mBAAmB,EAAE,wEAAwE,CAAC;iBACrG,MAAM,CAAC,wBAAwB,EAAE,2CAA2C,EAAE,QAAQ,CAAC,CAAC;QAC7F,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,OAAO,GAAG,IAAI,CAAC,aAAqC,CAAC;YAC3D,IAAI,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACrD,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;YACvF,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,cAAc,EAAE,OAAO;aACxB,CAAC;QACJ,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/delete.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Top-level `meshy-cli delete <id>` — destructive. Uses the unified task
+ * lookup (v2 /text-to-3d/<id>) so the caller doesn't need to know the type.
+ */
+import { Command } from "commander";
+export declare const deleteCommand: Command;
+//# sourceMappingURL=delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/cmd/delete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,aAAa,SAUtB,CAAC"}

package/dist/cmd/delete.js

@@ -0,0 +1,19 @@
+/**
+ * Top-level `meshy-cli delete <id>` — destructive. Uses the unified task
+ * lookup (v2 /text-to-3d/<id>) so the caller doesn't need to know the type.
+ */
+import { Command } from "commander";
+import { emit } from "../internal/output.js";
+import { buildRuntime, readGlobalFlags } from "../internal/runtime.js";
+export const deleteCommand = new Command("delete")
+    .description("Delete any task by id")
+    .argument("<task-id>", "Meshy task id")
+    .action(async (taskId, _opts, thisCmd) => {
+    const runtime = await buildRuntime(readGlobalFlags(thisCmd));
+    await runtime.client.textTo3d.delete(taskId);
+    emit({ task_id: taskId, deleted: true }, {
+        format: runtime.flags.format,
+        file: runtime.flags.output,
+    });
+});
+//# sourceMappingURL=delete.js.map

package/dist/cmd/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/cmd/delete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,uBAAuB,CAAC;KACpC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;KACtC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAA8B,EAAE,OAAgB,EAAE,EAAE;IACjF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACvC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;QAC5B,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;KAC3B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * image-to-3d — https://docs.meshy.ai/en/api/image-to-3d
+ *
+ * The mode IS the model — there is no model flag:
+ *   - standard → meshy-6 (server default "latest") — full-detail generation;
+ *     polycount is remesh's job afterwards.
+ *   - smart-topology → meshy-t2 (server default) — component-aware low-poly
+ *     with a native --target-polycount; the budget pick for game-ready
+ *     geometry.
+ */
+export declare const imageTo3dCommand: import("commander").Command;
+//# sourceMappingURL=image-to-3d.d.ts.map

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

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

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

@@ -0,0 +1,97 @@
+/**
+ * image-to-3d — https://docs.meshy.ai/en/api/image-to-3d
+ *
+ * The mode IS the model — there is no model flag:
+ *   - standard → meshy-6 (server default "latest") — full-detail generation;
+ *     polycount is remesh's job afterwards.
+ *   - smart-topology → meshy-t2 (server default) — component-aware low-poly
+ *     with a native --target-polycount; the budget pick for game-ready
+ *     geometry.
+ */
+import { Option } from "commander";
+import { parseBool, parseCsv, parseInt10 } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "image-to-3d",
+    description: "Generate a 3D model from a single reference image (clean backgrounds and clear edges " +
+        "give the best results). Outputs an untextured draft mesh by default — texture the " +
+        "confirmed mesh with `retexture`, or pass --should-texture true for one-shot. " +
+        "Topology/polycount are not tunable in standard mode — chain `remesh` afterwards; " +
+        "smart-topology mode has a native polycount and costs less",
+    create: {
+        description: "Create an image-to-3d task",
+        configure(cmd) {
+            return cmd
+                .option("--image-url <src>", "reference image; http(s) URL or local file path")
+                .option("--input-task-id <id>", "alternative to --image-url: a SUCCEEDED text-to-image or image-to-image task whose output becomes the source image")
+                .addOption(new Option("--model-type <kind>", "standard (default; meshy-6 full-detail generation) | smart-topology (meshy-t2 component-aware low-poly: clean topology, separated parts)").choices(["standard", "smart-topology"]))
+                .option("--target-polycount <n>", "smart-topology only: target triangle count, 100-15000 (default: 10000). For standard outputs use remesh", parseInt10)
+                .option("--should-texture <bool>", "generate textures (default: false — draft white mesh, the preview stage; 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"]))
+                .addOption(new Option("--pose-mode <pose>", "a-pose | t-pose pre-pose characters for rigging; auto (default) lets the model decide").choices(["a-pose", "t-pose", "auto"]))
+                .option("--image-enhancement <bool>", "optimize the input image before processing (default: true)", parseBool)
+                .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.imageUrl && !opts.inputTaskId && !opts.data) {
+                throw new UsageError("provide --image-url or --input-task-id");
+            }
+            const smart = opts.modelType === "smart-topology";
+            if (opts.targetPolycount != null && !smart) {
+                throw new UsageError("--target-polycount applies to --model-type smart-topology only; for standard outputs chain `remesh` afterwards");
+            }
+            // 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_url: opts.imageUrl,
+                input_task_id: opts.inputTaskId,
+                model_type: opts.modelType,
+                target_polycount: opts.targetPolycount,
+                should_texture: opts.shouldTexture,
+                enable_pbr: opts.enablePbr,
+                texture_prompt: opts.texturePrompt,
+                texture_resolution: opts.textureResolution,
+                pose_mode: opts.poseMode === "auto" ? undefined : opts.poseMode,
+                image_enhancement: opts.imageEnhancement,
+                remove_lighting: opts.removeLighting,
+                target_formats: opts.targetFormats,
+            };
+        },
+        toDefaults(opts) {
+            // Draft-first: the default output is an untextured white mesh (the
+            // preview stage of the prompt → image → mesh → texture pipeline);
+            // texturing is its own step, and the API rejects texture knobs on
+            // untextured runs, so they ride only when texturing is on — then the
+            // game-ready defaults apply: full PBR map set, 4k base color. The
+            // model is not a choice — it follows the mode (standard → meshy-6,
+            // smart-topology → meshy-t2, both server defaults). Smart topology
+            // gets the rigging-friendly 10k polycount. GLB-only output — omitting
+            // target_formats makes the API produce every format.
+            const texturing = opts.shouldTexture === true;
+            return {
+                should_texture: false,
+                enable_pbr: texturing ? true : undefined,
+                texture_resolution: texturing ? "4k" : undefined,
+                target_polycount: opts.modelType === "smart-topology" ? 10_000 : undefined,
+                target_formats: ["glb"],
+            };
+        },
+    },
+    endpointOf: (c) => c.imageTo3d,
+};
+export const imageTo3dCommand = buildResourceCommand(spec);
+//# sourceMappingURL=image-to-3d.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * image-to-image — https://docs.meshy.ai/en/api/image-to-image
+ */
+import { Option } from "commander";
+import { parseBool, parseCsv } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { ASPECT_RATIOS, ASPECT_RATIO_HELP, DEFAULT_IMAGE_MODEL, IMAGE_MODELS, IMAGE_MODEL_HELP, checkImageCombo, } from "../internal/image-models.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "image-to-image",
+    description: "Instruction-driven image editing and generation from 1-5 reference images — extraction, " +
+        "transformation, combination, restyling",
+    create: {
+        description: "Create an image-to-image task",
+        configure(cmd) {
+            return cmd
+                .addOption(new Option("--ai-model <model>", IMAGE_MODEL_HELP).choices([...IMAGE_MODELS]))
+                .option("--prompt <text>", "required — a straightforward, specific instruction, e.g. 'Extract the person on the " +
+                "left onto a clean white background' or 'Restyle into chibi cartoon style'. With " +
+                "multiple references say 'the first image', 'the second image', ...")
+                .option("--reference-image-urls <csv>", "required — 1-5 reference images as CSV; each entry is a URL or local file path", parseCsv)
+                .option("--generate-multi-view <bool>", "generate multi-angle views of the subject; mutually exclusive with --aspect-ratio", parseBool)
+                .addOption(new Option("--aspect-ratio <ratio>", ASPECT_RATIO_HELP).choices([...ASPECT_RATIOS]));
+        },
+        toPayload(opts) {
+            if (!opts.prompt && !opts.data) {
+                throw new UsageError("--prompt is required");
+            }
+            const urls = opts.referenceImageUrls;
+            if ((!urls || urls.length < 1 || urls.length > 5) && !opts.data) {
+                throw new UsageError("--reference-image-urls must be a CSV of 1-5 URLs");
+            }
+            checkImageCombo({
+                // With --data in play an unset flag may be supplied there; leave the
+                // ratio check to the server rather than validating against a model
+                // the request won't use.
+                aiModel: opts.aiModel ?? (opts.data ? undefined : DEFAULT_IMAGE_MODEL),
+                aspectRatio: opts.aspectRatio,
+                generateMultiView: opts.generateMultiView,
+            });
+            return {
+                ai_model: opts.aiModel,
+                prompt: opts.prompt,
+                reference_image_urls: urls,
+                generate_multi_view: opts.generateMultiView,
+                aspect_ratio: opts.aspectRatio,
+            };
+        },
+        toDefaults() {
+            return { ai_model: DEFAULT_IMAGE_MODEL };
+        },
+    },
+    endpointOf: (c) => c.imageToImage,
+};
+export const imageToImageCommand = buildResourceCommand(spec);
+//# sourceMappingURL=image-to-image.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-to-image.js","sourceRoot":"","sources":["../../src/cmd/image-to-image.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,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,gBAAgB;IACtB,WAAW,EACT,0FAA0F;QAC1F,wCAAwC;IAC1C,MAAM,EAAE;QACN,WAAW,EAAE,+BAA+B;QAC5C,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,CACL,iBAAiB,EACjB,sFAAsF;gBACpF,kFAAkF;gBAClF,oEAAoE,CACvE;iBACA,MAAM,CACL,8BAA8B,EAC9B,gFAAgF,EAChF,QAAQ,CACT;iBACA,MAAM,CACL,8BAA8B,EAC9B,mFAAmF,EACnF,SAAS,CACV;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,MAAM,IAAI,GAAG,IAAI,CAAC,kBAA0C,CAAC;YAC7D,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAChE,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;YAC3E,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,oBAAoB,EAAE,IAAI;gBAC1B,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;gBAC3C,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,YAAY;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/cmd/make.d.ts

@@ -0,0 +1,31 @@
+/**
+ * make — one command for "give me a 3D model".
+ *
+ * The per-resource commands mirror the API one endpoint at a time, which
+ * leaves the caller to carry task ids between steps by hand. `make` chains the
+ * documented flows instead:
+ *
+ *   a prompt  → text-to-3d preview → text-to-3d refine
+ *   an image  → image-to-3d (textured)
+ *
+ * What it deliberately does NOT do: pick a route by inspecting the input,
+ * insert an image step ahead of a prompt, or stop for confirmation between
+ * stages. Those are judgement calls, and a CLI that makes them silently spends
+ * someone else's credits on its own opinion. The resource commands remain the
+ * way to compose anything else.
+ *
+ * When a later step fails, the error carries the finished step's task id and
+ * the command that resumes from it, so a retry never re-runs — or re-bills —
+ * work that already succeeded.
+ */
+import { Command } from "commander";
+import { type MakePlan } from "../internal/make-plan.js";
+import { type Runtime } from "../internal/runtime.js";
+export declare const makeCommand: Command;
+/**
+ * The command that picks the chain back up from a completed step. Only the
+ * text route has a resumable hand-off (a preview's latents are what refine
+ * consumes); the image route is a single task with nothing to resume.
+ */
+export declare function resumeCommand(plan: MakePlan, completedTaskId: string, runtime: Runtime): string | undefined;
+//# sourceMappingURL=make.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../src/cmd/make.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAK5C,OAAO,EAAY,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAIlF,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAiBrF,eAAO,MAAM,WAAW,SAuCpB,CAAC;AAqGL;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,SAAS,CAIpB"}

package/dist/cmd/make.js

@@ -0,0 +1,195 @@
+/**
+ * make — one command for "give me a 3D model".
+ *
+ * The per-resource commands mirror the API one endpoint at a time, which
+ * leaves the caller to carry task ids between steps by hand. `make` chains the
+ * documented flows instead:
+ *
+ *   a prompt  → text-to-3d preview → text-to-3d refine
+ *   an image  → image-to-3d (textured)
+ *
+ * What it deliberately does NOT do: pick a route by inspecting the input,
+ * insert an image step ahead of a prompt, or stop for confirmation between
+ * stages. Those are judgement calls, and a CLI that makes them silently spends
+ * someone else's credits on its own opinion. The resource commands remain the
+ * way to compose anything else.
+ *
+ * When a later step fails, the error carries the finished step's task id and
+ * the command that resumes from it, so a retry never re-runs — or re-bills —
+ * work that already succeeded.
+ */
+import { Command, Option } from "commander";
+import { HintedError, UsageError } from "../internal/errors.js";
+import { parseInt10 } from "../internal/flags.js";
+import { resolveImageFields } from "../internal/file-input.js";
+import { logger } from "../internal/logger.js";
+import { planMake } from "../internal/make-plan.js";
+import { emit } from "../internal/output.js";
+import { pollUntilTerminal } from "../internal/poll.js";
+import { PRICING_DOCS } from "../internal/pricing.js";
+import { buildRuntime, readGlobalFlags } from "../internal/runtime.js";
+import { emitTerminalOutcome } from "../internal/task-command.js";
+const DESCRIPTION = "Generate a 3D model in one command. A prompt runs the two-stage text flow " +
+    "(preview then refine); an image runs the single textured image-to-3d task. " +
+    "Use -o to download the result. Compose anything else from the resource commands";
+export const makeCommand = new Command("make")
+    .description(DESCRIPTION)
+    .argument("<input>", "a text prompt, a local image path, or an http(s) image URL")
+    .addOption(new Option("--dry-run", "print the planned steps and the estimate, then exit without calling the API").default(false))
+    .addOption(new Option("--max-credits <n>", "refuse to start when the estimate exceeds this budget")
+    .argParser(parseInt10))
+    .addOption(new Option("--async", "start the first step and return its task id instead of running the whole chain").default(false))
+    .addOption(new Option("--timeout <seconds>", "max seconds to poll each step").default("600"))
+    .action(async (input, opts, thisCmd) => {
+    const plan = planMake(input);
+    const flags = readGlobalFlags(thisCmd);
+    // Budget check before anything is created: refusing costs nothing, and a
+    // refusal after step one has already billed is not a budget at all.
+    if (opts.maxCredits !== undefined && plan.estimatedCredits > opts.maxCredits) {
+        throw new UsageError(`estimate ${plan.estimatedCredits} exceeds --max-credits ${opts.maxCredits} ` +
+            `(${describeChain(plan)}). Nothing was started.`);
+    }
+    if (opts.dryRun) {
+        emit(planPayload(plan), { format: flags.format });
+        return;
+    }
+    await runChain(plan, opts, await buildRuntime(flags));
+});
+async function runChain(plan, opts, runtime) {
+    const timeoutSeconds = Number(opts.timeout ?? 600);
+    const payloadFor = await buildPayloads(plan);
+    /** Task id of the last step that reached SUCCEEDED — what a resume hangs off. */
+    let completedTaskId = "";
+    for (const step of plan.steps) {
+        const endpoint = endpointFor(step, runtime);
+        const payload = payloadFor[step.index - 1]?.(completedTaskId) ?? {};
+        logger.debug(`make step ${step.index} payload`, payload);
+        // The id is announced before polling starts: an interrupted run leaves a
+        // task progressing server-side, and the caller needs its id to exist
+        // somewhere other than this process's memory.
+        const taskId = await endpoint.create(payload);
+        announceStart(plan, step, taskId);
+        const started = Date.now();
+        const { task, timedOut } = await pollUntilTerminal(endpoint, taskId, {
+            timeoutSeconds,
+            intervalMs: runtime.config.pollIntervalMs,
+        });
+        const elapsed = (Date.now() - started) / 1000;
+        announceOutcome(task, timedOut, elapsed);
+        if (timedOut || task.status !== "SUCCEEDED") {
+            throw stepFailure(plan, step, task, timedOut, completedTaskId, runtime);
+        }
+        if (step.index === plan.steps.length) {
+            await emitTerminalOutcome(task, false, elapsed, step.resource, runtime);
+            return;
+        }
+        completedTaskId = task.id;
+        if (opts.async) {
+            emit({
+                command: "make",
+                route: plan.route,
+                stopped_after: step.action,
+                task_id: task.id,
+                status: task.status,
+                hint: resumeCommand(plan, task.id, runtime),
+            }, { format: runtime.flags.format });
+            return;
+        }
+    }
+}
+/**
+ * One payload builder per step, taking the previous step's task id so the
+ * chain stays a function of the plan plus what actually ran.
+ *
+ * Texture settings reuse the resource commands' pinned defaults (full PBR map
+ * set, 4k base color, relightable, GLB out) rather than inventing a second set.
+ */
+async function buildPayloads(plan) {
+    if (plan.route === "text") {
+        return [
+            () => ({ mode: "preview", prompt: plan.input, target_formats: ["glb"] }),
+            (previewTaskId) => ({
+                mode: "refine",
+                preview_task_id: previewTaskId,
+                enable_pbr: true,
+                texture_resolution: "4k",
+                remove_lighting: true,
+                target_formats: ["glb"],
+            }),
+        ];
+    }
+    // Resolve the image before anything is created: a missing file or an
+    // unreachable URL must fail while the run is still free.
+    const resolved = { imageUrl: plan.input };
+    await resolveImageFields(resolved);
+    return [
+        () => ({
+            image_url: resolved.imageUrl,
+            should_texture: true,
+            enable_pbr: true,
+            texture_resolution: "4k",
+            remove_lighting: true,
+            target_formats: ["glb"],
+        }),
+    ];
+}
+function endpointFor(step, runtime) {
+    return step.resource === "text-to-3d" ? runtime.client.textTo3d : runtime.client.imageTo3d;
+}
+/**
+ * The command that picks the chain back up from a completed step. Only the
+ * text route has a resumable hand-off (a preview's latents are what refine
+ * consumes); the image route is a single task with nothing to resume.
+ */
+export function resumeCommand(plan, completedTaskId, runtime) {
+    if (plan.route !== "text" || !completedTaskId)
+        return undefined;
+    const output = runtime.flags.output ? ` -o ${runtime.flags.output}` : "";
+    return `meshy text-to-3d create --mode refine --preview-task-id ${completedTaskId}${output}`;
+}
+function stepFailure(plan, step, task, timedOut, completedTaskId, runtime) {
+    if (timedOut) {
+        return new HintedError({
+            message: `make: ${step.label} did not finish within the timeout — task ${task.id} is still running`,
+            code: "step_timeout",
+            hint: `meshy ${step.resource} wait ${task.id}`,
+            exitCode: 8,
+        });
+    }
+    // A resume is only offered when an earlier step actually succeeded; without
+    // one, a suggested command would be a guess, and a wrong command is worse
+    // than none.
+    const resume = resumeCommand(plan, completedTaskId, runtime);
+    return new HintedError({
+        message: task.task_error?.message ||
+            `make: ${step.label} ended as ${task.status} — task ${task.id}`,
+        code: "step_failed",
+        ...(resume ? { hint: `${resume}   # step ${step.index} failed; step ${step.index - 1} is kept` } : {}),
+    });
+}
+function planPayload(plan) {
+    return {
+        command: "make",
+        route: plan.route,
+        steps: plan.steps.map((s) => ({
+            step: s.index,
+            resource: s.resource,
+            action: s.action,
+            estimated_credits: s.credits,
+        })),
+        estimated_credits: plan.estimatedCredits,
+        note: `Estimates only — confirm prices at ${PRICING_DOCS} and your balance with \`meshy balance\`.`,
+    };
+}
+function describeChain(plan) {
+    return plan.steps.map((s) => `${s.resource} ${s.action}`).join(" → ");
+}
+/** Progress goes to stderr so stdout stays the machine-readable channel. */
+function announceStart(plan, step, taskId) {
+    process.stderr.write(`[${step.index}/${plan.steps.length}] ${step.label}  ${taskId}\n`);
+}
+function announceOutcome(task, timedOut, elapsed) {
+    const mark = timedOut ? "timed out" : task.status === "SUCCEEDED" ? "ok" : task.status;
+    process.stderr.write(`      ${mark} in ${elapsed.toFixed(0)}s\n`);
+}
+//# sourceMappingURL=make.js.map

package/dist/cmd/make.js.map

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

package/dist/cmd/multi-color-print.d.ts

@@ -0,0 +1,6 @@
+/**
+ * multi-color-print — https://docs.meshy.ai/en/api/multi-color-print
+ * Converts a SUCCEEDED 3D task into a multi-color 3MF print file.
+ */
+export declare const multiColorPrintCommand: import("commander").Command;
+//# sourceMappingURL=multi-color-print.d.ts.map

package/dist/cmd/multi-color-print.d.ts.map

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

package/dist/cmd/multi-color-print.js

@@ -0,0 +1,44 @@
+/**
+ * multi-color-print — https://docs.meshy.ai/en/api/multi-color-print
+ * Converts a SUCCEEDED 3D task into a multi-color 3MF print file.
+ */
+import { parseInt10 } from "../internal/flags.js";
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+const spec = {
+    name: "multi-color-print",
+    description: "Convert a 3D model into multi-color 3MF format for 3D printing, with a configurable " +
+        "color palette of up to 16 colors",
+    create: {
+        description: "Create a multi-color-print task",
+        configure(cmd) {
+            return cmd
+                .option("--input-task-id <id>", "SUCCEEDED source 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/.fbx)")
+                .option("--max-colors <n>", "1-16 (default: 4)", parseInt10)
+                .option("--max-depth <n>", "quadtree depth 3-6 (default: 4)", parseInt10);
+        },
+        toPayload(opts) {
+            if (!opts.inputTaskId && !opts.modelUrl && !opts.data) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            const maxColors = opts.maxColors;
+            if (maxColors !== undefined && (maxColors < 1 || maxColors > 16)) {
+                throw new UsageError("--max-colors must be between 1 and 16");
+            }
+            const maxDepth = opts.maxDepth;
+            if (maxDepth !== undefined && (maxDepth < 3 || maxDepth > 6)) {
+                throw new UsageError("--max-depth must be between 3 and 6");
+            }
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+                max_colors: maxColors,
+                max_depth: maxDepth,
+            };
+        },
+    },
+    endpointOf: (c) => c.multiColorPrint,
+};
+export const multiColorPrintCommand = buildResourceCommand(spec);
+//# sourceMappingURL=multi-color-print.js.map

package/dist/cmd/multi-color-print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-color-print.js","sourceRoot":"","sources":["../../src/cmd/multi-color-print.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,sFAAsF;QACtF,kCAAkC;IACpC,MAAM,EAAE;QACN,WAAW,EAAE,iCAAiC;QAC9C,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CACL,sBAAsB,EACtB,4HAA4H,CAC7H;iBACA,MAAM,CAAC,mBAAmB,EAAE,wDAAwD,CAAC;iBACrF,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,UAAU,CAAC;iBAC3D,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,EAAE,UAAU,CAAC,CAAC;QAC9E,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,SAAS,GAAG,IAAI,CAAC,SAA+B,CAAC;YACvD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;YACrD,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,QAAQ;aACpB,CAAC;QACJ,CAAC;KACF;IACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

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

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

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

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