@meshy-ai/cli 0.2.0 → 0.3.1

package/dist/cmd/uv-unwrap.d.ts

@@ -0,0 +1,16 @@
+/**
+ * uv-unwrap — https://docs.meshy.ai/en/api/uv-unwrap
+ *
+ * Generates fresh UVs for a GLB (≤ 40,000 faces) and returns a "UV white
+ * model" (grey placeholder material, no textures) for external texturing.
+ *
+ * Exactly one source is accepted — `--input-task-id` or `--model-url` — also
+ * when supplied through --data. The server would prefer input_task_id if both
+ * were sent; refusing the ambiguity here is cheaper than a surprise. Input
+ * files must be GLB. A face count above 40k is the server's call (400); the
+ * CLI never downloads a model just to pre-count faces — `meshy inspect faces`
+ * answers that from a saved task when the field is available.
+ */
+export declare const UV_UNWRAP_FACE_CEILING = 40000;
+export declare const uvUnwrapCommand: import("commander").Command;
+//# sourceMappingURL=uv-unwrap.d.ts.map

package/dist/cmd/uv-unwrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uv-unwrap.d.ts","sourceRoot":"","sources":["../../src/cmd/uv-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAoC7C,eAAO,MAAM,eAAe,6BAA6B,CAAC"}

package/dist/cmd/uv-unwrap.js

@@ -0,0 +1,52 @@
+/**
+ * uv-unwrap — https://docs.meshy.ai/en/api/uv-unwrap
+ *
+ * Generates fresh UVs for a GLB (≤ 40,000 faces) and returns a "UV white
+ * model" (grey placeholder material, no textures) for external texturing.
+ *
+ * Exactly one source is accepted — `--input-task-id` or `--model-url` — also
+ * when supplied through --data. The server would prefer input_task_id if both
+ * were sent; refusing the ambiguity here is cheaper than a surprise. Input
+ * files must be GLB. A face count above 40k is the server's call (400); the
+ * CLI never downloads a model just to pre-count faces — `meshy inspect faces`
+ * answers that from a saved task when the field is available.
+ */
+import { UsageError } from "../internal/errors.js";
+import { buildResourceCommand } from "../internal/task-command.js";
+export const UV_UNWRAP_FACE_CEILING = 40_000;
+const spec = {
+    name: "uv-unwrap",
+    defaultSchema: "v1",
+    description: "Generate fresh UVs for a GLB model (input task or GLB file, at most 40k faces) — outputs a UV " +
+        "white model for external texturing. Remesh first if the mesh is denser",
+    create: {
+        description: "Create a uv-unwrap task",
+        configure(cmd) {
+            return cmd
+                .option("--input-task-id <id>", "SUCCEEDED source task with a GLB output (mutually exclusive with --model-url)")
+                .option("--model-url <src>", "GLB model as http(s) URL, data: URI or local .glb path (mutually exclusive with --input-task-id)");
+        },
+        toPayload(opts) {
+            return {
+                input_task_id: opts.inputTaskId,
+                model_url: opts.modelUrl,
+            };
+        },
+        validatePayload(payload) {
+            const hasTask = payload.input_task_id !== undefined && payload.input_task_id !== null && payload.input_task_id !== "";
+            const hasModel = payload.model_url !== undefined && payload.model_url !== null && payload.model_url !== "";
+            if (hasTask && hasModel) {
+                throw new UsageError("uv-unwrap takes exactly one source: --input-task-id or --model-url (also inside --data), not both");
+            }
+            if (!hasTask && !hasModel) {
+                throw new UsageError("provide --input-task-id or --model-url");
+            }
+            if (hasTask && typeof payload.input_task_id !== "string")
+                throw new UsageError("input_task_id must be a string");
+            if (hasModel && typeof payload.model_url !== "string")
+                throw new UsageError("model_url must be a string");
+        },
+    },
+};
+export const uvUnwrapCommand = buildResourceCommand(spec);
+//# sourceMappingURL=uv-unwrap.js.map

package/dist/cmd/uv-unwrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uv-unwrap.js","sourceRoot":"","sources":["../../src/cmd/uv-unwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAE7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,IAAI,GAAwB;IAChC,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,IAAI;IACnB,WAAW,EACT,gGAAgG;QAChG,wEAAwE;IAC1E,MAAM,EAAE;QACN,WAAW,EAAE,yBAAyB;QACtC,SAAS,CAAC,GAAG;YACX,OAAO,GAAG;iBACP,MAAM,CAAC,sBAAsB,EAAE,+EAA+E,CAAC;iBAC/G,MAAM,CAAC,mBAAmB,EAAE,kGAAkG,CAAC,CAAC;QACrI,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;QACJ,CAAC;QACD,eAAe,CAAC,OAAO;YACrB,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI,IAAI,OAAO,CAAC,aAAa,KAAK,EAAE,CAAC;YACtH,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;YAC3G,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;gBACxB,MAAM,IAAI,UAAU,CAAC,mGAAmG,CAAC,CAAC;YAC5H,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ;gBAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;YACjH,IAAI,QAAQ,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;gBAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;QAC5G,CAAC;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,18 @@
 #!/usr/bin/env node
 /**
  * meshy-cli entry point.
+ *
+ * Responsibilities kept here on purpose:
+ *   - decide whether the background update check may run before anything else;
+ *   - turn SIGINT into a cooperative abort (exit 130) instead of a hard kill;
+ *   - route every failure — including Commander parse errors — through one
+ *     exit that renders the payload in the schema the command would have used;
+ *   - flush stdout before exiting.
  */
-export {};
+/**
+ * The update check never runs for local work: no network, no detached child.
+ * Local means the command touches neither the API nor the update state, or
+ * the caller said so.
+ */
+export declare function shouldRunUpdateCheck(argv: string[], env?: NodeJS.ProcessEnv): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAgCH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAWlG"}

package/dist/index.js

@@ -1,23 +1,117 @@
 #!/usr/bin/env node
 /**
  * meshy-cli entry point.
+ *
+ * Responsibilities kept here on purpose:
+ *   - decide whether the background update check may run before anything else;
+ *   - turn SIGINT into a cooperative abort (exit 130) instead of a hard kill;
+ *   - route every failure — including Commander parse errors — through one
+ *     exit that renders the payload in the schema the command would have used;
+ *   - flush stdout before exiting.
  */
-import { buildRootCommand } from "./root.js";
-import { exitCodeFor, reportError } from "./internal/errors.js";
-import { refreshCache } from "./internal/update-notifier.js";
+import { buildRootCommand, V1_ONLY_COMMANDS, LOCAL_COMMANDS } from "./root.js";
+import { currentCommand, markInterrupted, wasInterrupted } from "./internal/context.js";
+import { exitCodeFor, isCommanderInformational, reportError, CliError } from "./internal/errors.js";
+import { emitEnvelope, writeStdout } from "./internal/output.js";
+import { errorEnvelope } from "./internal/result.js";
+import { refreshCache, shouldSkip } from "./internal/update-notifier.js";
 async function main() {
-    refreshCache(); // fire-and-forget; internally guarded; never throws
+    const argv = process.argv;
+    if (argv.includes("--no-update-check")) {
+        // Children (none today, but any future spawn) inherit the opt-out.
+        process.env["MESHY_CLI_NO_UPDATE_NOTIFIER"] = "1";
+    }
+    if (shouldRunUpdateCheck(argv))
+        refreshCache(); // fire-and-forget; internally guarded; never throws
+    installSignalHandlers();
     const program = buildRootCommand();
     try {
-        await program.parseAsync(process.argv);
+        await program.parseAsync(argv);
         const code = process.exitCode ?? 0;
         return typeof code === "number" ? code : 1;
     }
     catch (err) {
-        const fmt = resolveErrorFormat(program);
-        reportError(err, fmt);
-        return exitCodeFor(err);
+        if (isCommanderInformational(err))
+            return err.exitCode;
+        return await reportFailure(program, argv, err);
+    }
+}
+/**
+ * The update check never runs for local work: no network, no detached child.
+ * Local means the command touches neither the API nor the update state, or
+ * the caller said so.
+ */
+export function shouldRunUpdateCheck(argv, env = process.env) {
+    if (shouldSkip(env))
+        return false;
+    if (argv.includes("--no-update-check"))
+        return false;
+    const rest = argv.slice(2);
+    if (rest.length === 0)
+        return false;
+    if (rest.some((a) => a === "--help" || a === "-h" || a === "--version" || a === "-V"))
+        return false;
+    const first = rest.find((a) => !a.startsWith("-"));
+    if (!first)
+        return false;
+    if (LOCAL_COMMANDS.has(first))
+        return false;
+    if (first === "make" && rest.includes("--dry-run"))
+        return false;
+    return true;
+}
+function installSignalHandlers() {
+    let count = 0;
+    process.on("SIGINT", () => {
+        count += 1;
+        if (count === 1) {
+            markInterrupted();
+            process.stderr.write("\ninterrupted — finishing local bookkeeping; press Ctrl-C again to force exit\n");
+            return;
+        }
+        process.exit(130);
+    });
+}
+async function reportFailure(program, argv, err) {
+    const ctx = currentCommand();
+    const schema = ctx?.schema ?? resolveSchemaHeuristically(program, argv);
+    const format = ctx?.format ?? resolveErrorFormat(program);
+    // A SIGINT that surfaced as some other failure is still reported as
+    // interrupted — but whatever the command already knew (task id, submission,
+    // files written so far, recovery command) travels with it.
+    const interruptedErr = wasInterrupted() && !(err instanceof CliError && err.code === "interrupted")
+        ? new CliError({
+            code: "interrupted",
+            message: `interrupted by SIGINT${err instanceof Error && err.message ? ` (${err.message})` : ""}`,
+            result: err instanceof CliError ? err.result : null,
+            warnings: err instanceof CliError ? err.warnings : [],
+            recovery: err instanceof CliError ? err.recovery : null,
+            hint: err instanceof CliError ? err.hint : undefined,
+            cause: err,
+        })
+        : err;
+    if (schema === "v1") {
+        const command = ctx?.command ?? commandNameFromArgv(program, argv);
+        const { envelope, exitCode } = errorEnvelope(command, interruptedErr);
+        process.stderr.write(`error: ${envelope.error?.message ?? "unknown error"}\n`);
+        if (envelope.error?.hint)
+            process.stderr.write(`hint: ${envelope.error.hint}\n`);
+        try {
+            await emitEnvelope(envelope, format);
+        }
+        catch {
+            /* stderr already carries the human message */
+        }
+        return exitCode;
+    }
+    reportError(interruptedErr, format);
+    try {
+        await writeStdout("");
+    }
+    catch {
+        /* nothing to flush */
     }
+    return exitCodeFor(interruptedErr);
 }
 /**
  * Resolve the output format for the error path.
@@ -42,5 +136,44 @@ function resolveErrorFormat(program) {
     const v = (typeof raw === "string" ? raw : "json").toLowerCase();
     return v === "pretty" || v === "ndjson" ? v : "json";
 }
+/**
+ * Before an action ran we only know argv. `--output-schema` is a root option,
+ * so a parsed value is authoritative; otherwise the first command token decides
+ * (new commands are v1-only, everything else is legacy).
+ */
+function resolveSchemaHeuristically(program, argv) {
+    const parsed = program.opts()["outputSchema"];
+    if (parsed === "v1" || parsed === "legacy")
+        return parsed;
+    const idx = argv.indexOf("--output-schema");
+    if (idx !== -1) {
+        const v = argv[idx + 1];
+        if (v === "v1" || v === "legacy")
+            return v;
+    }
+    const first = firstCommandToken(program, argv);
+    return first && V1_ONLY_COMMANDS.has(first) ? "v1" : "legacy";
+}
+function firstCommandToken(program, argv) {
+    const names = new Set(program.commands.map((c) => c.name()));
+    return argv.slice(2).find((a) => names.has(a));
+}
+function commandNameFromArgv(program, argv) {
+    const first = firstCommandToken(program, argv);
+    if (!first)
+        return "meshy";
+    const rest = argv.slice(argv.indexOf(first) + 1).filter((a) => !a.startsWith("-"));
+    const sub = program.commands.find((c) => c.name() === first);
+    const path = [first];
+    let node = sub;
+    for (const token of rest) {
+        const next = node?.commands.find((c) => c.name() === token);
+        if (!next)
+            break;
+        path.push(token);
+        node = next;
+    }
+    return path.join(".");
+}
 main().then((code) => process.exit(code));
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,KAAK,UAAU,IAAI;IACjB,YAAY,EAAE,CAAC,CAAC,oDAAoD;IACpE,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACxC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAS,kBAAkB,CACzB,OAAgB;IAEhB,MAAM,OAAO,GAAG,CAAC,GAAY,EAAW,EAAE,CACxC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACjE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACvD,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/internal/artifacts.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Asset enumeration — which files a task exposes, under stable keys.
+ *
+ * Only known response fields are walked; an unknown string URL anywhere in
+ * `result` is reported under `unknown_urls` and never downloaded. Keys are
+ * the stable selectors of `meshy download --asset` and of the v1 download
+ * manifest; the file name is derived separately and never from the key or
+ * the URL alone.
+ *
+ * Product knowledge that changes the delivery format lives here too:
+ *   - 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;
+ *   - motion clips carry their format in `result.motion_format`.
+ */
+import type { TaskResourceDescriptor } from "../client/resource-registry.js";
+export type AssetKind = "model" | "image" | "texture" | "thumbnail" | "rig" | "animation" | "motion" | "report";
+export interface Asset {
+    /** Stable selector, e.g. `model.glb`, `thumbnail.primary`, `result.basic_animations.walking_glb_url`. */
+    key: string;
+    kind: AssetKind;
+    url: string | null;
+    /** File format the bytes are expected to be in (extension without dot), or null when unknown. */
+    format: string | null;
+    /** Set when the file is a container for the nominal format (keychain OBJ is a ZIP). */
+    containerFormat: string | null;
+    /** Nominal model format when it differs from the file (e.g. `obj` inside a ZIP). */
+    modelFormat: string | null;
+    /** Response path the asset came from. */
+    sourcePath: string;
+    /** Suggested safe file name (directory mode). */
+    filename: string;
+    /** Keys this asset needs to be usable (OBJ → MTL → textures). */
+    dependencies: string[];
+    /** Report assets carry their JSON here instead of a URL. */
+    report?: unknown;
+    /** Extra flags for the manifest (e.g. extracted:false for bundles). */
+    notes?: Record<string, unknown>;
+}
+export interface AssetEnumeration {
+    assets: Asset[];
+    /** String URLs found in `result` that no rule recognised. */
+    unknown_urls: Array<{
+        path: string;
+        url: string;
+    }>;
+    product: string | null;
+}
+/** Creative Lab product from a task type such as `creative-lab-keychain-build`. */
+export declare function productFromTaskType(type: unknown): {
+    product: string;
+    stage: string;
+} | null;
+/**
+ * The asset a `model_urls` entry stands for. Shared with the legacy `-o`
+ * downloader so both paths name Creative Lab parts the same way (`lamp.stl`,
+ * `base.stl`, `bundle.zip`, the keychain/fridge-magnet OBJ bundle as
+ * `model.obj.zip`) instead of turning the key into an extension.
+ */
+export declare function modelAsset(fmtKey: string, url: string, product: string | null): Asset;
+/**
+ * Enumerate every downloadable asset of a task object (raw API shape).
+ * `descriptor` (when known) supplies the product for Creative Lab builds.
+ */
+export declare function enumerateAssets(task: Record<string, unknown>, descriptor?: TaskResourceDescriptor | null): AssetEnumeration;
+/** 0.2.0 artifact keys → stable keys, so old scripts and internal tests keep resolving. */
+export declare const LEGACY_KEY_ALIASES: Readonly<Record<string, string>>;
+export declare function resolveAssetKey(requested: string, assets: readonly Asset[]): Asset | undefined;
+export interface Selection {
+    keys?: string[];
+    modelFormat?: string;
+    kind?: AssetKind;
+    all?: boolean;
+}
+export interface SelectionResult {
+    selected: Asset[];
+    /** Dependencies pulled in for selected OBJ files (empty when geometryOnly). */
+    dependencies: Asset[];
+    missingDependencies: string[];
+}
+/**
+ * Apply a selector to the enumeration. Exactly one selector kind must be
+ * given; contradictory combinations are rejected by the caller (usage).
+ * With `withDependencies`, an OBJ selection pulls its MTL and textures.
+ */
+export declare function selectAssets(enumeration: AssetEnumeration, sel: Selection, opts: {
+    withDependencies: boolean;
+}): SelectionResult;
+export declare class SelectionError extends Error {
+    readonly candidates: Array<{
+        key: string;
+        kind: AssetKind;
+        format: string | null;
+    }>;
+    constructor(message: string, assets: readonly Asset[]);
+}
+//# sourceMappingURL=artifacts.d.ts.map

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

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