@meshy-ai/cli 0.4.0 → 0.4.2

package/.env.example

@@ -1,4 +1,4 @@
-# Your Meshy API key (https://www.meshy.ai/settings/api). Read from the
+# Your Meshy API key (https://www.meshy.ai/developers/keys). Read from the
 # environment, or from an explicit file via `meshy ... --api-key-file <path>`
 # (only this key is read from the file; nothing is executed).
 MESHY_API_KEY=YOUR_MESHY_API_KEY_HERE

package/README.md

@@ -2,7 +2,8 @@
 
 The command line for the [Meshy AI API](https://docs.meshy.ai/): text-to-3D,
 image-to-3D, text-to-motion, remesh, convert, resize, UV unwrap, rigging,
-animation, retexture, 2D images, multi-color print, Creative Lab products, plus
+animation, retexture, 2D images, printability, auto split, multi-color print,
+Creative Lab products, usage records, plus
 the local helpers a 3D-printing or agent workflow needs. Built for people and
 AI agents: a terminal gets a readable view, a pipe or an agent gets JSON.
 
@@ -30,7 +31,7 @@ meshy auth status
 ```
 
 In CI, set `MESHY_API_KEY` instead; it wins over a stored login. Get a key at
-<https://www.meshy.ai/settings/api>.
+<https://www.meshy.ai/developers/keys>.
 
 ## Quick start
 

package/dist/client/endpoints/base.d.ts

@@ -26,6 +26,8 @@ export interface CreateResult {
 export interface RetrieveResult {
     task: Task;
     raw: unknown;
+    /** The server's poll hint (`Retry-After` on a task read), in ms, when it sent one. */
+    retryAfterMs?: number;
 }
 export interface ListResult {
     tasks: Task[];

package/dist/client/endpoints/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,aAAa,CAAC;AAErB,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAExC,YAAY,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAMrD;IAED,qFAAqF;IACrF,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;IAEK,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxG;IAEK,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExE;IAEK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAe1F;IAEK,IAAI,CAAC,MAAM,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAE/E;IAEK,YAAY,CAAC,MAAM,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiB3F;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKzE;IAED,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjC;IAED,gFAAgF;IAC1E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEtH;CACF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/client/endpoints/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAGL,KAAK,IAAI,EACV,MAAM,aAAa,CAAC;AAErB,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;IACb,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAExC,YAAY,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAMrD;IAED,qFAAqF;IACrF,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;IAEK,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxG;IAEK,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExE;IAEK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1F;IAEK,IAAI,CAAC,MAAM,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAE/E;IAEK,YAAY,CAAC,MAAM,GAAE,UAAe,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiB3F;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKzE;IAED,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjC;IAED,gFAAgF;IAC1E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEtH;CACF"}

package/dist/client/endpoints/base.js

@@ -9,7 +9,7 @@
  * The `*Detailed` variants also return the raw JSON exactly as received, which
  * is what --save-json, --include-raw and the v1 TaskView are built from.
  */
-import { MeshyApiError } from "../errors.js";
+import { MeshyApiError, parseRetryAfter } from "../errors.js";
 import { TaskCreateResponseSchema, TaskSchema, } from "../types.js";
 export class TaskEndpoint {
     resourcePath;
@@ -64,7 +64,8 @@ export class TaskEndpoint {
                 body: resp.json,
             });
         }
-        return { task: parsed.data, raw: resp.json };
+        const retryAfterMs = parseRetryAfter(resp.headers.get("retry-after"));
+        return retryAfterMs === undefined ? { task: parsed.data, raw: resp.json } : { task: parsed.data, raw: resp.json, retryAfterMs };
     }
     async list(params = {}, extras = {}) {
         return (await this.listDetailed(params, extras)).tasks;

package/dist/client/endpoints/base.js.map

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

package/dist/client/errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * Single typed error class for all Meshy HTTP failures.
  */
-export type MeshyErrorCode = "validation" | "auth" | "credit" | "not_found" | "rate_limit" | "server" | "network";
+export type MeshyErrorCode = "validation" | "auth" | "credit" | "not_found" | "rate_limit" | "conflict" | "server" | "network";
 export declare class MeshyApiError extends Error {
     readonly status: number;
     readonly code: MeshyErrorCode;
@@ -9,6 +9,8 @@ export declare class MeshyApiError extends Error {
     readonly body?: unknown;
     /** Set when the credential kind is known at the call site — used to tailor the 401 hint. */
     readonly credentialKind?: "oauth" | "api_key";
+    /** The server's `Retry-After`, in ms, when the response carried one (429, 503). */
+    readonly retryAfterMs?: number;
     constructor(params: {
         message: string;
         status: number;
@@ -16,9 +18,15 @@ export declare class MeshyApiError extends Error {
         path?: string;
         body?: unknown;
         credentialKind?: "oauth" | "api_key";
+        retryAfterMs?: number;
     });
     toJSON(): Record<string, unknown>;
 }
 export declare function codeForStatus(status: number): MeshyErrorCode;
+/**
+ * `Retry-After` in ms: delta-seconds (what the API sends) or an HTTP date.
+ * Absent, unparseable or in the past → undefined.
+ */
+export declare function parseRetryAfter(value: string | null | undefined, now?: number): number | undefined;
 export declare function mapHttpError(resp: Response, path?: string, credentialKind?: "oauth" | "api_key"): Promise<MeshyApiError>;
 //# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,SAAS,CAAC;AAEd,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE9C,YAAY,MAAM,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,cAAc,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KACtC,EAQA;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAShC;CACF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAO5D;AAyBD,wBAAsB,YAAY,CAChC,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,GACnC,OAAO,CAAC,aAAa,CAAC,CAYxB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,MAAM,GACN,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,SAAS,CAAC;AAEd,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,mFAAmF;IACnF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,YAAY,MAAM,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,cAAc,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QACrC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EASA;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAShC;CACF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAQ5D;AAyBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,SAAS,CAMtG;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,GACnC,OAAO,CAAC,aAAa,CAAC,CAaxB"}

package/dist/client/errors.js

@@ -8,6 +8,8 @@ export class MeshyApiError extends Error {
     body;
     /** Set when the credential kind is known at the call site — used to tailor the 401 hint. */
     credentialKind;
+    /** The server's `Retry-After`, in ms, when the response carried one (429, 503). */
+    retryAfterMs;
     constructor(params) {
         super(params.message);
         this.name = "MeshyApiError";
@@ -16,6 +18,8 @@ export class MeshyApiError extends Error {
         this.path = params.path;
         this.body = params.body;
         this.credentialKind = params.credentialKind;
+        if (params.retryAfterMs !== undefined)
+            this.retryAfterMs = params.retryAfterMs;
     }
     toJSON() {
         return {
@@ -37,6 +41,8 @@ export function codeForStatus(status) {
         return "credit";
     if (status === 404)
         return "not_found";
+    if (status === 409)
+        return "conflict";
     if (status === 429)
         return "rate_limit";
     return "server";
@@ -66,6 +72,19 @@ async function extractMessage(resp) {
         return { msg: bodyText.slice(0, 200), body: bodyText };
     }
 }
+/**
+ * `Retry-After` in ms: delta-seconds (what the API sends) or an HTTP date.
+ * Absent, unparseable or in the past → undefined.
+ */
+export function parseRetryAfter(value, now = Date.now()) {
+    if (!value)
+        return undefined;
+    const text = value.trim();
+    if (/^\d+(\.\d+)?$/.test(text))
+        return Math.round(Number(text) * 1000);
+    const at = Date.parse(text);
+    return Number.isFinite(at) && at > now ? at - now : undefined;
+}
 export async function mapHttpError(resp, path, credentialKind) {
     const { msg, body } = await extractMessage(resp);
     const code = codeForStatus(resp.status);
@@ -77,6 +96,7 @@ export async function mapHttpError(resp, path, credentialKind) {
         path: where,
         body,
         credentialKind,
+        retryAfterMs: parseRetryAfter(resp.headers.get("retry-after")),
     });
 }
 //# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

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

package/dist/client/index.d.ts

@@ -5,11 +5,9 @@
  *   v1 / v2       bearer credential, resolved by config
  *   creative-lab  bearer credential; base derived from the v1 origin or given
  *                 explicitly; a stored profile is never sent to another origin
- *   public-web    no credential (animation catalog)
  */
 import { BalanceEndpoint } from "./endpoints/balance.js";
 import { TaskEndpoint } from "./endpoints/base.js";
-import { AnimationCatalogEndpoint } from "./endpoints/animation-catalog.js";
 import { ShowcasesEndpoint } from "./endpoints/showcases.js";
 import { type CreativeLabProduct, type CreativeLabStage, type TaskResourceDescriptor } from "./resource-registry.js";
 import { type MeshyConfig } from "../internal/config.js";
@@ -18,8 +16,6 @@ export declare class MeshyClient {
     readonly config: MeshyConfig;
     readonly balance: BalanceEndpoint;
     readonly showcases: ShowcasesEndpoint;
-    /** Public catalog — built on a transport without any credential. */
-    readonly catalog: AnimationCatalogEndpoint;
     private readonly v1;
     private readonly v2;
     private creativeLabTransport;
@@ -27,6 +23,10 @@ export declare class MeshyClient {
     constructor(config: MeshyConfig, opts?: {
         fetchImpl?: typeof fetch;
     });
+    /** One authenticated GET on the v1 family for the list-shaped queries (usage, animation library). */
+    getV1(path: string, query: Record<string, string | number | undefined>, extras?: {
+        signal?: AbortSignal;
+    }): Promise<unknown>;
     private transportFor;
     /** Endpoint for any registered task resource (`text-to-3d`, `creative-lab.lamp.build`, …). */
     endpointFor(resource: string | TaskResourceDescriptor): TaskEndpoint;

package/dist/client/index.d.ts.map

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

package/dist/client/index.js

@@ -5,11 +5,9 @@
  *   v1 / v2       bearer credential, resolved by config
  *   creative-lab  bearer credential; base derived from the v1 origin or given
  *                 explicitly; a stored profile is never sent to another origin
- *   public-web    no credential (animation catalog)
  */
 import { BalanceEndpoint } from "./endpoints/balance.js";
 import { TaskEndpoint } from "./endpoints/base.js";
-import { AnimationCatalogEndpoint } from "./endpoints/animation-catalog.js";
 import { ShowcasesEndpoint } from "./endpoints/showcases.js";
 import { creativeLabResource, requireTaskResource, TASK_RESOURCES, } from "./resource-registry.js";
 import { createTransport } from "./transport.js";
@@ -19,8 +17,6 @@ export class MeshyClient {
     config;
     balance;
     showcases;
-    /** Public catalog — built on a transport without any credential. */
-    catalog;
     v1;
     v2;
     creativeLabTransport = null;
@@ -30,10 +26,12 @@ export class MeshyClient {
         const common = { readTimeoutMs: config.readTimeoutMs, fetchImpl: opts.fetchImpl, credentialKind: config.credentialKind };
         this.v1 = createTransport({ ...common, baseUrl: config.baseUrlV1, apiKey: config.apiKey });
         this.v2 = createTransport({ ...common, baseUrl: config.baseUrlV2, apiKey: config.apiKey });
-        const publicTransport = createTransport({ baseUrl: config.publicWebBase, readTimeoutMs: config.readTimeoutMs, fetchImpl: opts.fetchImpl });
         this.balance = new BalanceEndpoint((path, init) => this.v1.fetchRaw(path, init));
         this.showcases = new ShowcasesEndpoint(this.v1);
-        this.catalog = new AnimationCatalogEndpoint(publicTransport);
+    }
+    /** One authenticated GET on the v1 family for the list-shaped queries (usage, animation library). */
+    async getV1(path, query, extras = {}) {
+        return (await this.v1.requestJson("GET", path, { query, signal: extras.signal })).json;
     }
     transportFor(base) {
         switch (base) {

package/dist/client/index.js.map

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

package/dist/client/resource-registry.d.ts

@@ -1,8 +1,8 @@
 /**
  * Resource registry — the single source for what the CLI can call.
  *
- * Every task resource (the 16 first-class endpoints plus the 4 × 2 Creative
- * Lab stages) is described once: command path, API family, relative path,
+ * Every task resource (the first-class endpoints plus the Creative Lab
+ * stages) is described once: command path, API family, relative path,
  * supported verbs, billing class and the payload fields that carry media.
  * Commands, the `resources` index, payload normalisation and the transport
  * all read from here; nothing else hard-codes a path.
@@ -13,7 +13,10 @@
 export type ApiBase = "v1" | "v2" | "creative-lab";
 export type MediaKind = "image" | "model";
 export type Billing = "none" | "may-charge";
-export type CreativeLabProduct = "figure" | "lamp" | "keychain" | "fridge-magnet";
+/** Two-stage products (prototype → build). */
+export type CreativeLabProduct = "figure" | "lamp" | "keychain" | "fridge-magnet" | "vinyl-figure" | "brick-figure" | "keycap" | "fidget-pixel";
+/** Products with a single create, no stages. */
+export type CreativeLabSingleProduct = "fidget-collapsible";
 export type CreativeLabStage = "prototype" | "build";
 export type Verb = "create" | "get" | "list" | "delete" | "stream";
 export interface MediaField {
@@ -23,6 +26,8 @@ export interface MediaField {
     many: boolean;
     /** When set, only these file extensions/formats are accepted for local files. */
     formats?: readonly string[];
+    /** Appended to the error when a local file or data: URI is not one of `formats`. */
+    formatsHint?: string;
 }
 export interface VerbSupport {
     create: boolean;
@@ -51,12 +56,13 @@ export interface TaskResourceDescriptor {
     /** Never true in S1: nothing billable is retried for the caller. */
     automaticRetry: false;
     creativeLab?: {
-        product: CreativeLabProduct;
-        stage: CreativeLabStage;
+        product: CreativeLabProduct | CreativeLabSingleProduct;
+        stage: CreativeLabStage | null;
     };
     summary: string;
 }
 export declare const CREATIVE_LAB_PRODUCTS: readonly CreativeLabProduct[];
+export declare const CREATIVE_LAB_SINGLE_PRODUCTS: readonly CreativeLabSingleProduct[];
 export declare const CREATIVE_LAB_STAGES: readonly CreativeLabStage[];
 export declare const TASK_RESOURCES: readonly TaskResourceDescriptor[];
 export declare function findTaskResource(id: string): TaskResourceDescriptor | undefined;
@@ -69,10 +75,10 @@ export declare const TOP_LEVEL_TASK_RESOURCE_IDS: readonly string[];
 export interface QueryResourceDescriptor {
     id: string;
     commandPath: readonly string[];
-    base: "v1" | "public-web";
+    base: "v1";
     method: "GET";
     relativePath: string;
-    auth: "bearer" | "none";
+    auth: "bearer";
     billing: Billing;
     summary: string;
 }
@@ -83,7 +89,7 @@ export interface LocalToolDescriptor {
     summary: string;
 }
 export declare const LOCAL_TOOLS: readonly LocalToolDescriptor[];
-export type ResourceIndexKind = "task" | "query" | "local";
+export type ResourceIndexKind = "task" | "query" | "action" | "local";
 export interface ResourceIndexEntry {
     name: string;
     kind: ResourceIndexKind;
@@ -92,6 +98,6 @@ export interface ResourceIndexEntry {
     endpoint: string | null;
     verbs: Verb[] | null;
 }
-/** The v1 `resources` index: every task resource, query and local tool. */
+/** The v1 `resources` index: every task resource, query, action and local tool. */
 export declare function resourceIndex(): ResourceIndexEntry[];
 //# sourceMappingURL=resource-registry.d.ts.map

package/dist/client/resource-registry.d.ts.map

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

package/dist/client/resource-registry.js

@@ -1,8 +1,8 @@
 /**
  * Resource registry — the single source for what the CLI can call.
  *
- * Every task resource (the 16 first-class endpoints plus the 4 × 2 Creative
- * Lab stages) is described once: command path, API family, relative path,
+ * Every task resource (the first-class endpoints plus the Creative Lab
+ * stages) is described once: command path, API family, relative path,
  * supported verbs, billing class and the payload fields that carry media.
  * Commands, the `resources` index, payload normalisation and the transport
  * all read from here; nothing else hard-codes a path.
@@ -12,7 +12,21 @@
  */
 const ALL_VERBS = { create: true, get: true, list: true, delete: true, stream: true };
 const image = (path, many = false, formats) => formats ? { path, kind: "image", many, formats } : { path, kind: "image", many };
-const model = (path, formats) => formats ? { path, kind: "model", many: false, formats } : { path, kind: "model", many: false };
+const model = (path, formats, formatsHint) => ({
+    path,
+    kind: "model",
+    many: false,
+    ...(formats ? { formats } : {}),
+    ...(formatsHint ? { formatsHint } : {}),
+});
+/**
+ * The API takes an inline (data:) model only as glTF, and a local file is
+ * always sent inline. Other formats need a URL the API can fetch itself.
+ * multi-color-print takes GLB or FBX at all, so inline it is GLB only.
+ */
+const INLINE_MODEL_FORMATS = ["glb", "gltf"];
+const INLINE_MODEL_HINT = "the API takes an inline (local) model as glTF only — for .stl/.obj/.fbx pass a public http(s) URL, or --input-task-id";
+const inlineModel = (path) => model(path, INLINE_MODEL_FORMATS, INLINE_MODEL_HINT);
 function v1(id, relativePath, opts) {
     return {
         id,
@@ -28,7 +42,17 @@ function v1(id, relativePath, opts) {
         summary: opts.summary,
     };
 }
-export const CREATIVE_LAB_PRODUCTS = ["figure", "lamp", "keychain", "fridge-magnet"];
+export const CREATIVE_LAB_PRODUCTS = [
+    "figure",
+    "lamp",
+    "keychain",
+    "fridge-magnet",
+    "vinyl-figure",
+    "brick-figure",
+    "keycap",
+    "fidget-pixel",
+];
+export const CREATIVE_LAB_SINGLE_PRODUCTS = ["fidget-collapsible"];
 export const CREATIVE_LAB_STAGES = ["prototype", "build"];
 const CREATIVE_LAB_IMAGE_FORMATS = ["jpg", "jpeg", "png", "webp"];
 function creativeLab(product, stage, summary) {
@@ -48,6 +72,24 @@ function creativeLab(product, stage, summary) {
         summary,
     };
 }
+/** A single-stage product: one create on the product root, no prototype/build. */
+function creativeLabSingle(product, summary) {
+    const relativePath = `/${product}/v1`;
+    return {
+        id: `creative-lab.${product}`,
+        commandPath: ["creative-lab", product],
+        base: "creative-lab",
+        relativePath,
+        legacyEndpoint: `/openapi/creative-lab${relativePath}`,
+        supports: ALL_VERBS,
+        mediaFields: [image("image_url", false, CREATIVE_LAB_IMAGE_FORMATS)],
+        taskTypes: [`creative-lab-${product}`],
+        billing: { create: "may-charge" },
+        automaticRetry: false,
+        creativeLab: { product, stage: null },
+        summary,
+    };
+}
 export const TASK_RESOURCES = [
     {
         id: "text-to-3d",
@@ -63,19 +105,20 @@ export const TASK_RESOURCES = [
         summary: "two-stage 3D generation from text (preview → refine)",
     },
     v1("image-to-3d", "/image-to-3d", { mediaFields: [image("image_url")], taskTypes: ["image-to-3d"], summary: "3D from a single image (standard or smart-topology low-poly)" }),
-    v1("multi-image-to-3d", "/multi-image-to-3d", { mediaFields: [image("image_urls", true)], taskTypes: ["multi-image-to-3d"], summary: "3D from multiple views (beta; prefer image-to-3d)" }),
-    v1("remesh", "/remesh", { mediaFields: [model("model_url")], taskTypes: ["remesh"], summary: "retopologize / change polycount" }),
-    v1("convert", "/convert", { mediaFields: [model("model_url")], taskTypes: ["convert"], summary: "change file format only" }),
-    v1("resize", "/resize", { mediaFields: [model("model_url")], taskTypes: ["resize"], summary: "resize to real-world dimensions" }),
+    v1("multi-image-to-3d", "/multi-image-to-3d", { mediaFields: [image("image_urls", true), image("texture_image_urls", true)], taskTypes: ["multi-image-to-3d"], summary: "3D from 1-4 views of one object (prefer image-to-3d for a single image)" }),
+    v1("remesh", "/remesh", { mediaFields: [inlineModel("model_url")], taskTypes: ["remesh"], summary: "retopologize / change polycount" }),
+    v1("convert", "/convert", { mediaFields: [inlineModel("model_url")], taskTypes: ["convert"], summary: "change file format only" }),
+    v1("resize", "/resize", { mediaFields: [inlineModel("model_url")], taskTypes: ["resize"], summary: "resize to real-world dimensions" }),
     v1("rigging", "/rigging", { mediaFields: [model("model_url", ["glb"]), image("texture_image_url")], taskTypes: ["rig"], summary: "rig a humanoid mesh (+ bundled walk/run animations)" }),
-    v1("animate", "/animations", { taskTypes: ["animation"], summary: "apply an animation clip to a rigged mesh" }),
-    v1("retexture", "/retexture", { mediaFields: [model("model_url"), image("image_style_url"), image("multiview_image_urls", true)], taskTypes: ["retexture"], summary: "regenerate textures" }),
+    v1("animate", "/animations", { taskTypes: ["animate"], summary: "apply an animation clip to a rigged mesh" }),
+    v1("retexture", "/retexture", { mediaFields: [inlineModel("model_url"), image("image_style_url"), image("multiview_image_urls", true)], taskTypes: ["retexture"], summary: "regenerate textures" }),
     v1("text-to-image", "/text-to-image", { taskTypes: ["text-to-image"], summary: "2D image generation" }),
     v1("text-to-motion", "/text-to-motion", { taskTypes: ["text-to-motion"], summary: "generate a standalone skeletal motion clip from text" }),
     v1("image-to-image", "/image-to-image", { mediaFields: [image("reference_image_urls", true)], taskTypes: ["image-to-image"], summary: "2D image editing" }),
-    v1("multi-color-print", "/print/multi-color", { mediaFields: [model("model_url")], taskTypes: ["print-multi-color"], summary: "color-separated 3D print output" }),
-    v1("analyze-printability", "/print/analyze", { mediaFields: [model("model_url")], taskTypes: ["print-analyze"], billing: "none", summary: "inspect a model for 3D-printing issues (free)" }),
-    v1("repair-printability", "/print/repair", { mediaFields: [model("model_url")], taskTypes: ["print-repair"], summary: "fix non-watertight / non-manifold geometry" }),
+    v1("multi-color-print", "/print/multi-color", { mediaFields: [model("model_url", ["glb"], "the API takes an inline (local) model as GLB only here — for .fbx pass a public http(s) URL, or --input-task-id")], taskTypes: ["print-multi-color"], summary: "color-separated 3D print output" }),
+    v1("analyze-printability", "/print/analyze", { mediaFields: [inlineModel("model_url")], taskTypes: ["print-analyze"], billing: "none", summary: "inspect a model for 3D-printing issues (free)" }),
+    v1("repair-printability", "/print/repair", { mediaFields: [inlineModel("model_url")], taskTypes: ["print-repair"], summary: "fix non-watertight / non-manifold geometry" }),
+    v1("auto-split", "/print/split", { taskTypes: ["print-split"], summary: "split a model into printable parts (auto / by named parts / by colour; optional connectors)" }),
     v1("uv-unwrap", "/uv-unwrap", { mediaFields: [model("model_url", ["glb"])], taskTypes: ["uv-unwrap"], summary: "generate fresh UVs for a GLB (≤40k faces) — a UV white model for external texturing" }),
     creativeLab("figure", "prototype", "Creative Lab figure: photo → styled concept image"),
     creativeLab("figure", "build", "Creative Lab figure: prototype → textured GLB/OBJ/MTL"),
@@ -85,6 +128,15 @@ export const TASK_RESOURCES = [
     creativeLab("keychain", "build", "Creative Lab keychain: prototype → relief GLB / OBJ bundle (zip) / zip"),
     creativeLab("fridge-magnet", "prototype", "Creative Lab fridge magnet: photo → styled concept image"),
     creativeLab("fridge-magnet", "build", "Creative Lab fridge magnet: prototype → relief GLB / OBJ bundle (zip) / zip"),
+    creativeLab("vinyl-figure", "prototype", "Creative Lab vinyl figure: photo → big-head vinyl concept image"),
+    creativeLab("vinyl-figure", "build", "Creative Lab vinyl figure: prototype → textured GLB/OBJ/MTL"),
+    creativeLab("brick-figure", "prototype", "Creative Lab brick figure: photo → brick minifigure concept image"),
+    creativeLab("brick-figure", "build", "Creative Lab brick figure: prototype → textured GLB/OBJ/MTL"),
+    creativeLab("keycap", "prototype", "Creative Lab keycap: photo → keycap design (one candidate)"),
+    creativeLab("keycap", "build", "Creative Lab keycap: prototype candidate → GLB + OBJ bundle (zip), real-world mm"),
+    creativeLab("fidget-pixel", "prototype", "Creative Lab fidget pixel: photo → pixel-art image (person | other)"),
+    creativeLab("fidget-pixel", "build", "Creative Lab fidget pixel: prototype → 3MF board, one object per piece"),
+    creativeLabSingle("fidget-collapsible", "Creative Lab collapsible fidget: photo → printable STL (+ preview GLB), one stage"),
 ];
 const BY_ID = new Map(TASK_RESOURCES.map((d) => [d.id, d]));
 export function findTaskResource(id) {
@@ -111,7 +163,8 @@ export function creativeLabResource(product, stage) {
 export const TOP_LEVEL_TASK_RESOURCE_IDS = TASK_RESOURCES.filter((d) => d.commandPath.length === 1).map((d) => d.id);
 export const QUERY_RESOURCES = [
     { id: "balance", commandPath: ["balance"], base: "v1", method: "GET", relativePath: "/balance", auth: "bearer", billing: "none", summary: "remaining credit balance" },
-    { id: "animation-catalog", commandPath: ["animation-catalog", "list"], base: "public-web", method: "GET", relativePath: "/animations/resources", auth: "none", billing: "none", summary: "public animation library (action ids); no key needed" },
+    { id: "animation-catalog", commandPath: ["animation-catalog", "list"], base: "v1", method: "GET", relativePath: "/animations/library", auth: "bearer", billing: "none", summary: "animation library (action ids for animate); free, server-side search" },
+    { id: "usage", commandPath: ["usage", "tasks"], base: "v1", method: "GET", relativePath: "/usage/tasks", auth: "bearer", billing: "none", summary: "finished API tasks with the credits each consumed (Studio/Enterprise)" },
     { id: "showcases", commandPath: ["showcases", "list"], base: "v1", method: "GET", relativePath: "/showcases", auth: "bearer", billing: "may-charge", summary: "Enterprise community showcases (every request is billed)" },
 ];
 export const LOCAL_TOOLS = [
@@ -121,9 +174,8 @@ export const LOCAL_TOOLS = [
     { id: "mesh.prepare-print", commandPath: ["mesh", "prepare-print"], summary: "OBJ Y-up → Z-up, scale to a target height, centre, bottom at Z=0" },
     { id: "slicer", commandPath: ["slicer"], summary: "detect installed slicers | open a file in one" },
     { id: "doctor", commandPath: ["doctor"], summary: "local environment diagnosis (no network by default)" },
-    { id: "delete", commandPath: ["delete"], summary: "delete any task, whatever its resource" },
 ];
-/** The v1 `resources` index: every task resource, query and local tool. */
+/** The v1 `resources` index: every task resource, query, action and local tool. */
 export function resourceIndex() {
     const verbsOf = (s) => ["create", "get", "list", "wait", "stream", "delete"]
         .filter((v) => (v === "wait" ? s.get : s[v]))
@@ -141,7 +193,7 @@ export function resourceIndex() {
         kind: "query",
         command: `meshy ${q.commandPath.join(" ")}`,
         summary: q.summary,
-        endpoint: q.base === "public-web" ? `/web/public${q.relativePath}` : `/openapi/v1${q.relativePath}`,
+        endpoint: `/openapi/v1${q.relativePath}`,
         verbs: null,
     }));
     const locals = LOCAL_TOOLS.map((l) => ({
@@ -152,6 +204,10 @@ export function resourceIndex() {
         endpoint: null,
         verbs: null,
     }));
-    return [...tasks, ...queries, ...locals];
+    // A one-off API call that changes state: not a task resource, not a read, not local.
+    const actions = [
+        { name: "delete", kind: "action", command: "meshy delete", summary: "permanently delete a task of any resource except Creative Lab (whose own delete verb cancels)", endpoint: "/openapi/v2/text-to-3d", verbs: null },
+    ];
+    return [...tasks, ...queries, ...locals, ...actions];
 }
 //# sourceMappingURL=resource-registry.js.map