@meshy-ai/cli 0.1.0

package/dist/internal/file-input.js

@@ -0,0 +1,164 @@
+/**
+ * Resolve user-supplied image and model inputs into something Meshy accepts.
+ *
+ * Accepted inputs (both images and 3D models):
+ *   - http(s) URLs — preflighted with HEAD so unreachable sources fail fast.
+ *   - Local file paths (absolute or relative to cwd) — read, MIME-sniffed,
+ *     and inlined as data URIs. Users don't have to host files themselves.
+ *
+ * Base64 data URIs on the command line aren't accepted — the whole point of
+ * local-path support is to spare the user from encoding them manually.
+ */
+import { readFileSync, statSync } from "node:fs";
+import { extname, isAbsolute, resolve as resolvePath } from "node:path";
+import { UsageError } from "./errors.js";
+import { logger } from "./logger.js";
+/** camelCase option names that hold image inputs. */
+export const IMAGE_FIELDS = {
+    scalar: [
+        "imageUrl", // image-to-3d
+        "imageStyleUrl", // retexture
+    ],
+    list: [
+        "imageUrls", // multi-image-to-3d
+        "referenceImageUrls", // image-to-image
+    ],
+};
+/** camelCase option names that hold 3D model inputs. */
+export const MODEL_FIELDS = {
+    scalar: ["modelUrl"], // remesh, retexture, rigging
+    list: [],
+};
+export async function resolveImageFields(opts) {
+    await resolveGroup(opts, IMAGE_FIELDS, detectImageMime, "image");
+}
+export async function resolveModelFields(opts) {
+    await resolveGroup(opts, MODEL_FIELDS, detectModelMime, "3d model");
+}
+async function resolveGroup(opts, fields, detect, kind) {
+    for (const key of fields.scalar) {
+        const v = opts[key];
+        if (typeof v === "string" && v) {
+            opts[key] = await resolveOne(v, `--${toFlag(key)}`, detect, kind);
+        }
+    }
+    for (const key of fields.list) {
+        const v = opts[key];
+        if (Array.isArray(v) && v.length > 0) {
+            const resolved = [];
+            for (const entry of v) {
+                if (typeof entry === "string" && entry) {
+                    resolved.push(await resolveOne(entry, `--${toFlag(key)}`, detect, kind));
+                }
+            }
+            opts[key] = resolved;
+        }
+    }
+}
+function toFlag(camel) {
+    return camel.replace(/([A-Z])/g, "-$1").toLowerCase();
+}
+async function resolveOne(input, flagLabel, detect, kind) {
+    if (input.startsWith("data:")) {
+        throw new UsageError(`${flagLabel}: data: URIs aren't accepted on the command line — pass a local file path instead`);
+    }
+    if (/^https?:\/\//i.test(input)) {
+        await preflightUrl(input, flagLabel);
+        return input;
+    }
+    return loadLocalFile(input, flagLabel, detect, kind);
+}
+async function preflightUrl(url, flagLabel) {
+    let resp;
+    try {
+        resp = await fetch(url, { method: "HEAD", redirect: "follow" });
+        if (resp.status === 405 || resp.status === 501) {
+            const controller = new AbortController();
+            resp = await fetch(url, { method: "GET", signal: controller.signal, redirect: "follow" });
+            controller.abort();
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new UsageError(`${flagLabel}: cannot reach ${url} (${msg})`);
+    }
+    if (!resp.ok) {
+        throw new UsageError(`${flagLabel}: ${url} returned ${resp.status} ${resp.statusText}`);
+    }
+    logger.debug(`${flagLabel} preflight OK: ${url} (${resp.status})`);
+}
+function loadLocalFile(input, flagLabel, detect, kind) {
+    const absPath = isAbsolute(input) ? input : resolvePath(process.cwd(), input);
+    let stat;
+    try {
+        stat = statSync(absPath);
+    }
+    catch {
+        throw new UsageError(`${flagLabel}: file not found: ${input}`);
+    }
+    if (!stat.isFile()) {
+        throw new UsageError(`${flagLabel}: not a regular file: ${input}`);
+    }
+    const buffer = readFileSync(absPath);
+    const mime = detect(buffer, absPath);
+    if (!mime) {
+        throw new UsageError(`${flagLabel}: could not detect ${kind} MIME type for ${absPath}`);
+    }
+    logger.debug(`${flagLabel} inlined ${absPath} as ${mime} data URI (${buffer.length} bytes)`);
+    return `data:${mime};base64,${buffer.toString("base64")}`;
+}
+function detectImageMime(buffer, path) {
+    if (buffer.length >= 12) {
+        if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff)
+            return "image/jpeg";
+        if (buffer[0] === 0x89 &&
+            buffer[1] === 0x50 &&
+            buffer[2] === 0x4e &&
+            buffer[3] === 0x47)
+            return "image/png";
+        if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46)
+            return "image/gif";
+        if (buffer.subarray(0, 4).toString("ascii") === "RIFF" &&
+            buffer.subarray(8, 12).toString("ascii") === "WEBP")
+            return "image/webp";
+        if (buffer[0] === 0x42 && buffer[1] === 0x4d)
+            return "image/bmp";
+    }
+    const ext = extname(path).slice(1).toLowerCase();
+    const map = {
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        png: "image/png",
+        webp: "image/webp",
+        gif: "image/gif",
+        bmp: "image/bmp",
+    };
+    return map[ext] ?? "";
+}
+function detectModelMime(buffer, path) {
+    // GLB: magic "glTF" at offset 0
+    if (buffer.length >= 4 &&
+        buffer[0] === 0x67 &&
+        buffer[1] === 0x6c &&
+        buffer[2] === 0x54 &&
+        buffer[3] === 0x46) {
+        return "model/gltf-binary";
+    }
+    // FBX binary: "Kaydara FBX Binary" ASCII signature at offset 0
+    if (buffer.length >= 18 && buffer.subarray(0, 18).toString("ascii") === "Kaydara FBX Binary") {
+        return "application/octet-stream";
+    }
+    // Fall back to extension for text formats (obj, gltf, ascii stl) and usdz/3mf.
+    const ext = extname(path).slice(1).toLowerCase();
+    const map = {
+        glb: "model/gltf-binary",
+        gltf: "model/gltf+json",
+        obj: "model/obj",
+        fbx: "application/octet-stream",
+        stl: "model/stl",
+        usdz: "model/vnd.usdz+zip",
+        "3mf": "model/3mf",
+    };
+    return map[ext] ?? "";
+}
+//# sourceMappingURL=file-input.js.map

package/dist/internal/file-input.js.map

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

package/dist/internal/flags.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Small reusable Commander `<arg>` parsers.
+ */
+export declare function parseBool(raw: string): boolean;
+export declare function parseInt10(raw: string): number;
+export declare function parseNumber(raw: string): number;
+export declare function parseCsv(raw: string): string[];
+export declare function collect(raw: string, prev?: string[]): string[];
+//# sourceMappingURL=flags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/internal/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAElE"}

package/dist/internal/flags.js

@@ -0,0 +1,31 @@
+/**
+ * Small reusable Commander `<arg>` parsers.
+ */
+import { UsageError } from "./errors.js";
+export function parseBool(raw) {
+    const v = raw.toLowerCase();
+    if (v === "true" || v === "1" || v === "yes")
+        return true;
+    if (v === "false" || v === "0" || v === "no")
+        return false;
+    throw new UsageError(`expected true/false, got '${raw}'`);
+}
+export function parseInt10(raw) {
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n))
+        throw new UsageError(`expected integer, got '${raw}'`);
+    return n;
+}
+export function parseNumber(raw) {
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        throw new UsageError(`expected number, got '${raw}'`);
+    return n;
+}
+export function parseCsv(raw) {
+    return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
+export function collect(raw, prev = []) {
+    return [...prev, raw];
+}
+//# sourceMappingURL=flags.js.map

package/dist/internal/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/internal/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,IAAI,UAAU,CAAC,6BAA6B,GAAG,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC;IAChF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,OAAiB,EAAE;IACtD,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/internal/global-options.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Global flags that should be accepted at every command level so they work
+ * regardless of position in argv (e.g. `meshy-cli balance --format pretty`
+ * as well as `meshy-cli --format pretty balance`).
+ *
+ * We declare them once on the root with visible help + defaults, and mirror
+ * them (hidden, no defaults) onto every descendant command. `optsWithGlobals`
+ * then merges any set value — a flag on the innermost command wins, and
+ * unset leaf options fall through to the parent's value or its default.
+ */
+import { Command } from "commander";
+/** Register the visible, default-carrying versions on the root command. */
+export declare function registerRootGlobalOptions(root: Command): void;
+/** Mirror the same flags onto every descendant, hidden from help. */
+export declare function mirrorGlobalOptionsToDescendants(root: Command): void;
+//# sourceMappingURL=global-options.d.ts.map

package/dist/internal/global-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-options.d.ts","sourceRoot":"","sources":["../../src/internal/global-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AA0B5C,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAO7D;AAED,qEAAqE;AACrE,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CASpE"}

package/dist/internal/global-options.js

@@ -0,0 +1,57 @@
+/**
+ * Global flags that should be accepted at every command level so they work
+ * regardless of position in argv (e.g. `meshy-cli balance --format pretty`
+ * as well as `meshy-cli --format pretty balance`).
+ *
+ * We declare them once on the root with visible help + defaults, and mirror
+ * them (hidden, no defaults) onto every descendant command. `optsWithGlobals`
+ * then merges any set value — a flag on the innermost command wins, and
+ * unset leaf options fall through to the parent's value or its default.
+ */
+import { Option } from "commander";
+const FACTORIES = [
+    () => new Option("--api-key <key>", "Meshy API key (overrides MESHY_API_KEY)"),
+    () => new Option("--base-url-v1 <url>", "override v1 base URL"),
+    () => new Option("--base-url-v2 <url>", "override v2 base URL"),
+    () => new Option("--format <fmt>", "output format").choices(["json", "pretty", "ndjson"]),
+    () => new Option("--json", "output as JSON (alias for --format json)"),
+    () => new Option("-o, --output <path>", "download artifacts + write meta.json; switches stdout to a status report"),
+    () => new Option("-v, --verbose", "debug logging"),
+    () => new Option("--log-level <level>", "log level").choices([
+        "debug",
+        "info",
+        "warn",
+        "error",
+        "silent",
+    ]),
+];
+/** Register the visible, default-carrying versions on the root command. */
+export function registerRootGlobalOptions(root) {
+    for (const factory of FACTORIES) {
+        const opt = factory();
+        if (opt.long === "--format")
+            opt.default("json");
+        if (opt.long === "--verbose")
+            opt.default(false);
+        root.addOption(opt);
+    }
+}
+/** Mirror the same flags onto every descendant, hidden from help. */
+export function mirrorGlobalOptionsToDescendants(root) {
+    walk(root, (cmd) => {
+        if (cmd === root)
+            return;
+        for (const factory of FACTORIES) {
+            const opt = factory().hideHelp();
+            if (cmd.options.some((existing) => existing.long === opt.long))
+                continue;
+            cmd.addOption(opt);
+        }
+    });
+}
+function walk(cmd, visit) {
+    visit(cmd);
+    for (const sub of cmd.commands)
+        walk(sub, visit);
+}
+//# sourceMappingURL=global-options.js.map

package/dist/internal/global-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-options.js","sourceRoot":"","sources":["../../src/internal/global-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAW,MAAM,EAAE,MAAM,WAAW,CAAC;AAI5C,MAAM,SAAS,GAAoB;IACjC,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,CAAC;IAC9E,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;IAC/D,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;IAC/D,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzF,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,0CAA0C,CAAC;IACtE,GAAG,EAAE,CACH,IAAI,MAAM,CACR,qBAAqB,EACrB,0EAA0E,CAC3E;IACH,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;IAClD,GAAG,EAAE,CACH,IAAI,MAAM,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC;QACrD,OAAO;QACP,MAAM;QACN,MAAM;QACN,OAAO;QACP,QAAQ;KACT,CAAC;CACL,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,yBAAyB,CAAC,IAAa;IACrD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;YAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,gCAAgC,CAAC,IAAa;IAC5D,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QACjB,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO;QACzB,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,GAAY,EAAE,KAA2B;IACrD,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ;QAAE,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC"}

package/dist/internal/headless.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Headless environment detection and login mode resolution.
+ *
+ * detectHeadless() returns true when the process is running in an environment
+ * where a browser cannot be opened (CI, SSH, container, no display server).
+ *
+ * resolveLoginMode() maps explicit flags + environment signals to one of the
+ * four login modes: "loopback", "manual", "device", or "no-wait".
+ */
+export type LoginMode = "loopback" | "manual" | "device" | "no-wait" | "resume";
+export interface HeadlessEnv {
+    CI?: string;
+    SSH_CONNECTION?: string;
+    SSH_TTY?: string;
+    KUBERNETES_SERVICE_HOST?: string;
+    DISPLAY?: string;
+    WAYLAND_DISPLAY?: string;
+    MESHY_CLI_NO_BROWSER?: string;
+    [key: string]: string | undefined;
+}
+export interface TtyState {
+    stderrIsTTY: boolean;
+    stdinIsTTY: boolean;
+    stdoutIsTTY: boolean;
+    platform: string;
+}
+/**
+ * Detect whether the current environment is headless (no browser available).
+ *
+ * Strong signals (any one → headless):
+ *   - CI env var set
+ *   - SSH_CONNECTION or SSH_TTY set
+ *   - /.dockerenv or /run/.containerenv exists
+ *   - KUBERNETES_SERVICE_HOST set
+ *   - Linux with no DISPLAY and no WAYLAND_DISPLAY
+ *   - MESHY_CLI_NO_BROWSER=1 (explicit opt-out)
+ *
+ * Weak signal (both must be absent for headless):
+ *   - !stderr.isTTY && !stdin.isTTY → probably headless
+ *
+ * NOTE: !stdout.isTTY alone is NOT used — piping JSON to jq on a desktop
+ * must stay loopback.
+ *
+ * MESHY_CLI_FORCE_GUI=1 overrides all signals and forces GUI (non-headless)
+ * mode. Used in tests that need to simulate a GUI environment.
+ */
+export declare function detectHeadless(env?: HeadlessEnv, tty?: TtyState): boolean;
+export interface ResolveModeOpts {
+    manual?: boolean;
+    device?: boolean;
+    noWait?: boolean;
+    deviceFlow?: string;
+    deviceCode?: string;
+    env?: HeadlessEnv;
+    tty?: TtyState;
+}
+/**
+ * Resolve the login mode from explicit flags and environment signals.
+ *
+ * Priority (highest to lowest):
+ *   1. --device-flow <id> or --device-code <code> → "resume"
+ *   2. --no-wait → "no-wait"
+ *   3. --device → "device"
+ *   4. --manual → "manual"
+ *   5. detectHeadless() → "device"
+ *   6. default → "loopback"
+ */
+export declare function resolveLoginMode(opts: ResolveModeOpts): LoginMode;
+//# sourceMappingURL=headless.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../src/internal/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,GAAE,WAAyB,EAC9B,GAAG,GAAE,QAKJ,GACA,OAAO,CAiCT;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,CAqBjE"}

package/dist/internal/headless.js

@@ -0,0 +1,101 @@
+/**
+ * Headless environment detection and login mode resolution.
+ *
+ * detectHeadless() returns true when the process is running in an environment
+ * where a browser cannot be opened (CI, SSH, container, no display server).
+ *
+ * resolveLoginMode() maps explicit flags + environment signals to one of the
+ * four login modes: "loopback", "manual", "device", or "no-wait".
+ */
+import { existsSync } from "node:fs";
+/**
+ * Detect whether the current environment is headless (no browser available).
+ *
+ * Strong signals (any one → headless):
+ *   - CI env var set
+ *   - SSH_CONNECTION or SSH_TTY set
+ *   - /.dockerenv or /run/.containerenv exists
+ *   - KUBERNETES_SERVICE_HOST set
+ *   - Linux with no DISPLAY and no WAYLAND_DISPLAY
+ *   - MESHY_CLI_NO_BROWSER=1 (explicit opt-out)
+ *
+ * Weak signal (both must be absent for headless):
+ *   - !stderr.isTTY && !stdin.isTTY → probably headless
+ *
+ * NOTE: !stdout.isTTY alone is NOT used — piping JSON to jq on a desktop
+ * must stay loopback.
+ *
+ * MESHY_CLI_FORCE_GUI=1 overrides all signals and forces GUI (non-headless)
+ * mode. Used in tests that need to simulate a GUI environment.
+ */
+export function detectHeadless(env = process.env, tty = {
+    stderrIsTTY: Boolean(process.stderr.isTTY),
+    stdinIsTTY: Boolean(process.stdin.isTTY),
+    stdoutIsTTY: Boolean(process.stdout.isTTY),
+    platform: process.platform,
+}) {
+    // Force GUI mode (test escape hatch).
+    if (env["MESHY_CLI_FORCE_GUI"])
+        return false;
+    // Explicit opt-out.
+    if (env["MESHY_CLI_NO_BROWSER"])
+        return true;
+    // CI environment.
+    if (env["CI"])
+        return true;
+    // SSH session.
+    if (env["SSH_CONNECTION"] || env["SSH_TTY"])
+        return true;
+    // Container environments.
+    if (existsSync("/.dockerenv") || existsSync("/run/.containerenv"))
+        return true;
+    // Kubernetes.
+    if (env["KUBERNETES_SERVICE_HOST"])
+        return true;
+    // Linux with no display server.
+    if (tty.platform === "linux" &&
+        !env["DISPLAY"] &&
+        !env["WAYLAND_DISPLAY"]) {
+        return true;
+    }
+    // Weak signal: no stderr TTY and no stdin TTY → probably headless.
+    // (stdout piped to jq on a desktop must NOT trigger this.)
+    if (!tty.stderrIsTTY && !tty.stdinIsTTY)
+        return true;
+    return false;
+}
+/**
+ * Resolve the login mode from explicit flags and environment signals.
+ *
+ * Priority (highest to lowest):
+ *   1. --device-flow <id> or --device-code <code> → "resume"
+ *   2. --no-wait → "no-wait"
+ *   3. --device → "device"
+ *   4. --manual → "manual"
+ *   5. detectHeadless() → "device"
+ *   6. default → "loopback"
+ */
+export function resolveLoginMode(opts) {
+    const env = opts.env ?? process.env;
+    const tty = opts.tty ?? {
+        stderrIsTTY: Boolean(process.stderr.isTTY),
+        stdinIsTTY: Boolean(process.stdin.isTTY),
+        stdoutIsTTY: Boolean(process.stdout.isTTY),
+        platform: process.platform,
+    };
+    // Explicit resume flags win first.
+    if (opts.deviceFlow || opts.deviceCode)
+        return "resume";
+    // Explicit mode flags.
+    if (opts.noWait)
+        return "no-wait";
+    if (opts.device)
+        return "device";
+    if (opts.manual)
+        return "manual";
+    // Auto-detect.
+    if (detectHeadless(env, tty))
+        return "device";
+    return "loopback";
+}
+//# sourceMappingURL=headless.js.map

package/dist/internal/headless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.js","sourceRoot":"","sources":["../../src/internal/headless.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAsBrC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB,OAAO,CAAC,GAAG,EAC9B,MAAgB;IACd,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAC1C,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IACxC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC3B;IAED,sCAAsC;IACtC,IAAI,GAAG,CAAC,qBAAqB,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,oBAAoB;IACpB,IAAI,GAAG,CAAC,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7C,kBAAkB;IAClB,IAAI,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3B,eAAe;IACf,IAAI,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzD,0BAA0B;IAC1B,IAAI,UAAU,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,oBAAoB,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/E,cAAc;IACd,IAAI,GAAG,CAAC,yBAAyB,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,gCAAgC;IAChC,IACE,GAAG,CAAC,QAAQ,KAAK,OAAO;QACxB,CAAC,GAAG,CAAC,SAAS,CAAC;QACf,CAAC,GAAG,CAAC,iBAAiB,CAAC,EACvB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mEAAmE;IACnE,2DAA2D;IAC3D,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAErD,OAAO,KAAK,CAAC;AACf,CAAC;AAYD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI;QACtB,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC1C,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACxC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;IAEF,mCAAmC;IACnC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IAExD,uBAAuB;IACvB,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAEjC,eAAe;IACf,IAAI,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE9C,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/internal/image-models.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared model/aspect-ratio table for the 2D image commands, so text-to-image
+ * and image-to-image can't drift apart as Meshy ships new models.
+ */
+export declare const IMAGE_MODELS: readonly ["gpt-image-2", "nano-banana-pro", "nano-banana-2", "nano-banana-2-lite", "nano-banana"];
+export declare const DEFAULT_IMAGE_MODEL = "gpt-image-2";
+export declare const IMAGE_MODEL_HELP: string;
+export declare const ASPECT_RATIOS: readonly ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"];
+export declare const ASPECT_RATIO_HELP: string;
+/**
+ * Cross-validate model × aspect-ratio × multi-view before any credits are
+ * spent; the API's own 400 is less specific. When the model is unknown at
+ * parse time (driven via --data), the ratio check is left to the server.
+ */
+export declare function checkImageCombo(opts: {
+    aiModel?: string;
+    aspectRatio?: string;
+    generateMultiView?: boolean;
+}): void;
+//# sourceMappingURL=image-models.d.ts.map

package/dist/internal/image-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-models.d.ts","sourceRoot":"","sources":["../../src/internal/image-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,YAAY,mGAMf,CAAC;AAEX,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,eAAO,MAAM,gBAAgB,QAEoC,CAAC;AAElE,eAAO,MAAM,aAAa,8DAA+D,CAAC;AAE1F,eAAO,MAAM,iBAAiB,QAEmB,CAAC;AAKlD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,IAAI,CAcP"}

package/dist/internal/image-models.js

@@ -0,0 +1,40 @@
+/**
+ * Shared model/aspect-ratio table for the 2D image commands, so text-to-image
+ * and image-to-image can't drift apart as Meshy ships new models.
+ */
+import { UsageError } from "./errors.js";
+export const IMAGE_MODELS = [
+    "gpt-image-2",
+    "nano-banana-pro",
+    "nano-banana-2",
+    "nano-banana-2-lite",
+    "nano-banana",
+];
+export const DEFAULT_IMAGE_MODEL = "gpt-image-2";
+export const IMAGE_MODEL_HELP = "gpt-image-2 (default, best; ratios 1:1|3:2|2:3) | nano-banana-pro | nano-banana-2 | " +
+    "nano-banana-2-lite (fastest, cheapest) | nano-banana (legacy)";
+export const ASPECT_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3"];
+export const ASPECT_RATIO_HELP = "default: 1:1. nano-banana*: 1:1|16:9|9:16|4:3|3:4. gpt-image-2: 1:1|3:2|2:3. " +
+    "Mutually exclusive with --generate-multi-view";
+const GPT_IMAGE_2_RATIOS = new Set(["1:1", "3:2", "2:3"]);
+const NANO_BANANA_RATIOS = new Set(["1:1", "16:9", "9:16", "4:3", "3:4"]);
+/**
+ * Cross-validate model × aspect-ratio × multi-view before any credits are
+ * spent; the API's own 400 is less specific. When the model is unknown at
+ * parse time (driven via --data), the ratio check is left to the server.
+ */
+export function checkImageCombo(opts) {
+    if (opts.generateMultiView === true && opts.aspectRatio) {
+        throw new UsageError("--generate-multi-view true is mutually exclusive with --aspect-ratio");
+    }
+    const ratio = opts.aspectRatio;
+    if (!ratio || !opts.aiModel)
+        return;
+    const supported = opts.aiModel === "gpt-image-2" ? GPT_IMAGE_2_RATIOS : NANO_BANANA_RATIOS;
+    if (!supported.has(ratio)) {
+        throw new UsageError(opts.aiModel === "gpt-image-2"
+            ? `--aspect-ratio ${ratio} is not supported by gpt-image-2 (use 1:1, 3:2, or 2:3)`
+            : `--aspect-ratio ${ratio} is only supported by gpt-image-2`);
+    }
+}
+//# sourceMappingURL=image-models.js.map

package/dist/internal/image-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-models.js","sourceRoot":"","sources":["../../src/internal/image-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,sFAAsF;IACtF,+DAA+D,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAE1F,MAAM,CAAC,MAAM,iBAAiB,GAC5B,+EAA+E;IAC/E,+CAA+C,CAAC;AAElD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAC1D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC3F,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAClB,IAAI,CAAC,OAAO,KAAK,aAAa;YAC5B,CAAC,CAAC,kBAAkB,KAAK,yDAAyD;YAClF,CAAC,CAAC,kBAAkB,KAAK,mCAAmC,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/internal/logger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Leveled logger → stderr. stdout is reserved for command output
+ * so `meshy-cli ... | jq ...` stays clean.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare const logger: {
+    debug: (msg: string, extra?: unknown) => void;
+    info: (msg: string, extra?: unknown) => void;
+    warn: (msg: string, extra?: unknown) => void;
+    error: (msg: string, extra?: unknown) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/internal/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAYtE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAoBD,eAAO,MAAM,MAAM;iBACJ,MAAM,UAAU,OAAO;gBACxB,MAAM,UAAU,OAAO;gBACvB,MAAM,UAAU,OAAO;iBACtB,MAAM,UAAU,OAAO;CACrC,CAAC"}

package/dist/internal/logger.js

@@ -0,0 +1,42 @@
+/**
+ * Leveled logger → stderr. stdout is reserved for command output
+ * so `meshy-cli ... | jq ...` stays clean.
+ */
+const LEVEL_ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 99,
+};
+let currentLevel = "warn";
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+export function getLogLevel() {
+    return currentLevel;
+}
+function write(level, msg, extra) {
+    if (LEVEL_ORDER[level] < LEVEL_ORDER[currentLevel])
+        return;
+    const time = new Date().toISOString();
+    const line = extra === undefined
+        ? `[${time}] ${level.toUpperCase()} ${msg}\n`
+        : `[${time}] ${level.toUpperCase()} ${msg} ${safeJson(extra)}\n`;
+    process.stderr.write(line);
+}
+function safeJson(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+export const logger = {
+    debug: (msg, extra) => write("debug", msg, extra),
+    info: (msg, extra) => write("info", msg, extra),
+    warn: (msg, extra) => write("warn", msg, extra),
+    error: (msg, extra) => write("error", msg, extra),
+};
+//# sourceMappingURL=logger.js.map

package/dist/internal/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/internal/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,KAAK,CAAC,KAAe,EAAE,GAAW,EAAE,KAAe;IAC1D,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC;QAAE,OAAO;IAC3D,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,IAAI,GACR,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI;QAC7C,CAAC,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;IACnE,IAAI,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IACjE,IAAI,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IACjE,KAAK,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;CACpE,CAAC"}