@meshy-ai/cli 0.2.0 → 0.3.0

package/dist/client/index.d.ts

@@ -1,50 +1,59 @@
 /**
- * MeshyClient — two fetchers (v1 + v2), typed endpoint namespaces.
+ * MeshyClient — one transport per API family, endpoints resolved from the
+ * resource registry.
+ *
+ *   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 { AnalyzePrintabilityEndpoint } from "./endpoints/analyze-printability.js";
-import { AnimateEndpoint } from "./endpoints/animate.js";
 import { BalanceEndpoint } from "./endpoints/balance.js";
-import { ConvertEndpoint } from "./endpoints/convert.js";
-import { ResizeEndpoint } from "./endpoints/resize.js";
-import { ImageTo3DEndpoint } from "./endpoints/image-to-3d.js";
-import { ImageToImageEndpoint } from "./endpoints/image-to-image.js";
-import { MultiColorPrintEndpoint } from "./endpoints/multi-color-print.js";
-import { MultiImageTo3DEndpoint } from "./endpoints/multi-image-to-3d.js";
-import { RemeshEndpoint } from "./endpoints/remesh.js";
-import { RepairPrintabilityEndpoint } from "./endpoints/repair-printability.js";
-import { RetextureEndpoint } from "./endpoints/retexture.js";
-import { RiggingEndpoint } from "./endpoints/rigging.js";
 import { TaskEndpoint } from "./endpoints/base.js";
-import { TextTo3DEndpoint } from "./endpoints/text-to-3d.js";
-import { TextToImageEndpoint } from "./endpoints/text-to-image.js";
-import { TextToMotionEndpoint } from "./endpoints/text-to-motion.js";
-import type { MeshyConfig } from "../internal/config.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";
+export type { HttpFetch } from "./endpoints/base.js";
 export declare class MeshyClient {
     readonly config: MeshyConfig;
     readonly balance: BalanceEndpoint;
-    readonly textTo3d: TextTo3DEndpoint;
-    readonly imageTo3d: ImageTo3DEndpoint;
-    readonly multiImageTo3d: MultiImageTo3DEndpoint;
-    readonly remesh: RemeshEndpoint;
-    readonly convert: ConvertEndpoint;
-    readonly resize: ResizeEndpoint;
-    readonly rigging: RiggingEndpoint;
-    readonly animate: AnimateEndpoint;
-    readonly retexture: RetextureEndpoint;
-    readonly textToImage: TextToImageEndpoint;
-    readonly textToMotion: TextToMotionEndpoint;
-    readonly imageToImage: ImageToImageEndpoint;
-    readonly multiColorPrint: MultiColorPrintEndpoint;
-    readonly analyzePrintability: AnalyzePrintabilityEndpoint;
-    readonly repairPrintability: RepairPrintabilityEndpoint;
-    private readonly v1Fetch;
-    private readonly v2Fetch;
-    constructor(config: MeshyConfig);
-    endpointFor(resource: ResourceName): TaskEndpoint;
-    /** Raw HTTP passthrough for `meshy api …` — selects v1 or v2 by prefix. */
-    raw(apiVersion: "v1" | "v2", method: string, path: string, init?: RequestInit): Promise<Response>;
+    readonly showcases: ShowcasesEndpoint;
+    /** Public catalog — built on a transport without any credential. */
+    readonly catalog: AnimationCatalogEndpoint;
+    private readonly v1;
+    private readonly v2;
+    private creativeLabTransport;
+    private readonly endpoints;
+    constructor(config: MeshyConfig, opts?: {
+        fetchImpl?: typeof fetch;
+    });
+    private transportFor;
+    /** Endpoint for any registered task resource (`text-to-3d`, `creative-lab.lamp.build`, …). */
+    endpointFor(resource: string | TaskResourceDescriptor): TaskEndpoint;
+    creativeLab(product: CreativeLabProduct | string, stage: CreativeLabStage | string): TaskEndpoint;
+    get textTo3d(): TaskEndpoint;
+    get imageTo3d(): TaskEndpoint;
+    get multiImageTo3d(): TaskEndpoint;
+    get remesh(): TaskEndpoint;
+    get convert(): TaskEndpoint;
+    get resize(): TaskEndpoint;
+    get rigging(): TaskEndpoint;
+    get animate(): TaskEndpoint;
+    get retexture(): TaskEndpoint;
+    get textToImage(): TaskEndpoint;
+    get textToMotion(): TaskEndpoint;
+    get imageToImage(): TaskEndpoint;
+    get multiColorPrint(): TaskEndpoint;
+    get analyzePrintability(): TaskEndpoint;
+    get repairPrintability(): TaskEndpoint;
+    get uvUnwrap(): TaskEndpoint;
+    /** Raw HTTP passthrough for `meshy api …` — selects the API family by flag. */
+    raw(apiVersion: "v1" | "v2" | "creative-lab", method: string, path: string, init?: RequestInit): Promise<Response>;
 }
+/** The 0.2.0 resource names, still valid ids in the registry. */
 export declare const RESOURCE_NAMES: readonly ["text-to-3d", "image-to-3d", "multi-image-to-3d", "remesh", "convert", "resize", "rigging", "animate", "retexture", "text-to-image", "text-to-motion", "image-to-image", "multi-color-print", "analyze-printability", "repair-printability"];
 export type ResourceName = (typeof RESOURCE_NAMES)[number];
+/** Every registered task resource id (15 legacy + uv-unwrap + Creative Lab stages). */
+export declare const TASK_RESOURCE_IDS: readonly string[];
 export { MeshyApiError } from "./errors.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAkB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAuDzD,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC;IAClD,QAAQ,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IAExD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IAEpC,YAAY,MAAM,EAAE,WAAW,EAqB9B;IAED,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAkBhD;IAED,2EAA2E;IACrE,GAAG,CACP,UAAU,EAAE,IAAI,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC,CAGnB;CACF;AAED,eAAO,MAAM,cAAc,YACzB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,CACb,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/index.js

@@ -1,136 +1,103 @@
 /**
- * MeshyClient — two fetchers (v1 + v2), typed endpoint namespaces.
+ * MeshyClient — one transport per API family, endpoints resolved from the
+ * resource registry.
+ *
+ *   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 { AnalyzePrintabilityEndpoint } from "./endpoints/analyze-printability.js";
-import { AnimateEndpoint } from "./endpoints/animate.js";
 import { BalanceEndpoint } from "./endpoints/balance.js";
-import { ConvertEndpoint } from "./endpoints/convert.js";
-import { ResizeEndpoint } from "./endpoints/resize.js";
-import { ImageTo3DEndpoint } from "./endpoints/image-to-3d.js";
-import { ImageToImageEndpoint } from "./endpoints/image-to-image.js";
-import { MultiColorPrintEndpoint } from "./endpoints/multi-color-print.js";
-import { MultiImageTo3DEndpoint } from "./endpoints/multi-image-to-3d.js";
-import { RemeshEndpoint } from "./endpoints/remesh.js";
-import { RepairPrintabilityEndpoint } from "./endpoints/repair-printability.js";
-import { RetextureEndpoint } from "./endpoints/retexture.js";
-import { RiggingEndpoint } from "./endpoints/rigging.js";
-import { TextTo3DEndpoint } from "./endpoints/text-to-3d.js";
-import { TextToImageEndpoint } from "./endpoints/text-to-image.js";
-import { TextToMotionEndpoint } from "./endpoints/text-to-motion.js";
-import { mapHttpError, MeshyApiError } from "./errors.js";
-import { logger } from "../internal/logger.js";
-import { USER_AGENT } from "../internal/user-agent.js";
-function makeFetcher(baseUrl, apiKey, readTimeoutMs, credentialKind) {
-    return async function (path, init) {
-        const url = path.startsWith("http") ? path : `${baseUrl}${path.startsWith("/") ? "" : "/"}${path}`;
-        const headers = new Headers(init?.headers);
-        headers.set("Authorization", `Bearer ${apiKey}`);
-        headers.set("User-Agent", USER_AGENT);
-        if (!headers.has("Accept"))
-            headers.set("Accept", "application/json");
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(new Error(`read timeout after ${readTimeoutMs}ms`)), readTimeoutMs);
-        try {
-            logger.debug(`HTTP ${init?.method ?? "GET"} ${url}`);
-            const resp = await fetch(url, { ...init, headers, signal: controller.signal });
-            logger.debug(`HTTP ${resp.status} ${url}`);
-            if (!resp.ok) {
-                throw await mapHttpError(resp, path, credentialKind);
-            }
-            return resp;
-        }
-        catch (err) {
-            if (err instanceof MeshyApiError)
-                throw err;
-            if (err instanceof Error && err.name === "AbortError") {
-                throw new MeshyApiError({
-                    message: `request to ${url} timed out after ${readTimeoutMs}ms`,
-                    status: 0,
-                    code: "network",
-                    path,
-                    credentialKind,
-                });
-            }
-            const msg = err instanceof Error ? err.message : String(err);
-            throw new MeshyApiError({
-                message: `network error calling ${url}: ${msg}`,
-                status: 0,
-                code: "network",
-                path,
-                credentialKind,
-            });
-        }
-        finally {
-            clearTimeout(timer);
-        }
-    };
-}
+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";
+import { assertCredentialAllowedForOrigin } from "../internal/config.js";
+import { UsageError } from "../internal/errors.js";
 export class MeshyClient {
     config;
     balance;
-    textTo3d;
-    imageTo3d;
-    multiImageTo3d;
-    remesh;
-    convert;
-    resize;
-    rigging;
-    animate;
-    retexture;
-    textToImage;
-    textToMotion;
-    imageToImage;
-    multiColorPrint;
-    analyzePrintability;
-    repairPrintability;
-    v1Fetch;
-    v2Fetch;
-    constructor(config) {
+    showcases;
+    /** Public catalog — built on a transport without any credential. */
+    catalog;
+    v1;
+    v2;
+    creativeLabTransport = null;
+    endpoints = new Map();
+    constructor(config, opts = {}) {
         this.config = config;
-        this.v1Fetch = makeFetcher(config.baseUrlV1, config.apiKey, config.readTimeoutMs, config.credentialKind);
-        this.v2Fetch = makeFetcher(config.baseUrlV2, config.apiKey, config.readTimeoutMs, config.credentialKind);
-        this.balance = new BalanceEndpoint(this.v1Fetch);
-        this.textTo3d = new TextTo3DEndpoint(this.v2Fetch);
-        this.imageTo3d = new ImageTo3DEndpoint(this.v1Fetch);
-        this.multiImageTo3d = new MultiImageTo3DEndpoint(this.v1Fetch);
-        this.remesh = new RemeshEndpoint(this.v1Fetch);
-        this.convert = new ConvertEndpoint(this.v1Fetch);
-        this.resize = new ResizeEndpoint(this.v1Fetch);
-        this.rigging = new RiggingEndpoint(this.v1Fetch);
-        this.animate = new AnimateEndpoint(this.v1Fetch);
-        this.retexture = new RetextureEndpoint(this.v1Fetch);
-        this.textToImage = new TextToImageEndpoint(this.v1Fetch);
-        this.textToMotion = new TextToMotionEndpoint(this.v1Fetch);
-        this.imageToImage = new ImageToImageEndpoint(this.v1Fetch);
-        this.multiColorPrint = new MultiColorPrintEndpoint(this.v1Fetch);
-        this.analyzePrintability = new AnalyzePrintabilityEndpoint(this.v1Fetch);
-        this.repairPrintability = new RepairPrintabilityEndpoint(this.v1Fetch);
+        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);
     }
-    endpointFor(resource) {
-        switch (resource) {
-            case "text-to-3d": return this.textTo3d;
-            case "image-to-3d": return this.imageTo3d;
-            case "multi-image-to-3d": return this.multiImageTo3d;
-            case "remesh": return this.remesh;
-            case "convert": return this.convert;
-            case "resize": return this.resize;
-            case "rigging": return this.rigging;
-            case "animate": return this.animate;
-            case "retexture": return this.retexture;
-            case "text-to-image": return this.textToImage;
-            case "text-to-motion": return this.textToMotion;
-            case "image-to-image": return this.imageToImage;
-            case "multi-color-print": return this.multiColorPrint;
-            case "analyze-printability": return this.analyzePrintability;
-            case "repair-printability": return this.repairPrintability;
+    transportFor(base) {
+        switch (base) {
+            case "v1":
+                return this.v1;
+            case "v2":
+                return this.v2;
+            case "creative-lab": {
+                if (this.creativeLabTransport)
+                    return this.creativeLabTransport;
+                const baseUrl = this.config.baseUrlCreativeLab;
+                if (!baseUrl) {
+                    throw new UsageError("the Creative Lab base URL cannot be derived from --base-url-v1; pass --base-url-creative-lab <url> (or MESHY_BASE_URL_CREATIVE_LAB)");
+                }
+                assertCredentialAllowedForOrigin(this.config, baseUrl, "Creative Lab");
+                this.creativeLabTransport = createTransport({
+                    baseUrl,
+                    apiKey: this.config.apiKey,
+                    credentialKind: this.config.credentialKind,
+                    readTimeoutMs: this.config.readTimeoutMs,
+                });
+                return this.creativeLabTransport;
+            }
         }
     }
-    /** Raw HTTP passthrough for `meshy api …` — selects v1 or v2 by prefix. */
+    /** Endpoint for any registered task resource (`text-to-3d`, `creative-lab.lamp.build`, …). */
+    endpointFor(resource) {
+        const d = typeof resource === "string" ? requireTaskResource(resource) : resource;
+        const existing = this.endpoints.get(d.id);
+        if (existing)
+            return existing;
+        const ep = new TaskEndpoint(this.transportFor(d.base), d.relativePath);
+        this.endpoints.set(d.id, ep);
+        return ep;
+    }
+    creativeLab(product, stage) {
+        const d = creativeLabResource(product, stage);
+        if (!d)
+            throw new UsageError(`unknown Creative Lab product/stage '${product}/${stage}'`);
+        return this.endpointFor(d);
+    }
+    // Named accessors kept for existing call sites and tests.
+    get textTo3d() { return this.endpointFor("text-to-3d"); }
+    get imageTo3d() { return this.endpointFor("image-to-3d"); }
+    get multiImageTo3d() { return this.endpointFor("multi-image-to-3d"); }
+    get remesh() { return this.endpointFor("remesh"); }
+    get convert() { return this.endpointFor("convert"); }
+    get resize() { return this.endpointFor("resize"); }
+    get rigging() { return this.endpointFor("rigging"); }
+    get animate() { return this.endpointFor("animate"); }
+    get retexture() { return this.endpointFor("retexture"); }
+    get textToImage() { return this.endpointFor("text-to-image"); }
+    get textToMotion() { return this.endpointFor("text-to-motion"); }
+    get imageToImage() { return this.endpointFor("image-to-image"); }
+    get multiColorPrint() { return this.endpointFor("multi-color-print"); }
+    get analyzePrintability() { return this.endpointFor("analyze-printability"); }
+    get repairPrintability() { return this.endpointFor("repair-printability"); }
+    get uvUnwrap() { return this.endpointFor("uv-unwrap"); }
+    /** Raw HTTP passthrough for `meshy api …` — selects the API family by flag. */
     async raw(apiVersion, method, path, init) {
-        const fetcher = apiVersion === "v2" ? this.v2Fetch : this.v1Fetch;
-        return fetcher(path, { ...init, method });
+        return this.transportFor(apiVersion).fetchRaw(path, { ...init, method });
     }
 }
+/** The 0.2.0 resource names, still valid ids in the registry. */
 export const RESOURCE_NAMES = [
     "text-to-3d",
     "image-to-3d",
@@ -148,5 +115,7 @@ export const RESOURCE_NAMES = [
     "analyze-printability",
     "repair-printability",
 ];
+/** Every registered task resource id (15 legacy + uv-unwrap + Creative Lab stages). */
+export const TASK_RESOURCE_IDS = TASK_RESOURCES.map((d) => d.id);
 export { MeshyApiError } from "./errors.js";
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,97 @@
+/**
+ * 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,
+ * 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.
+ *
+ * docs/skill-parity/endpoint-contracts.json documents the same data and
+ * tests/resource-registry.test.ts fails when the two drift apart.
+ */
+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";
+export type CreativeLabStage = "prototype" | "build";
+export type Verb = "create" | "get" | "list" | "delete" | "stream";
+export interface MediaField {
+    /** snake_case payload field that carries the media reference. */
+    path: string;
+    kind: MediaKind;
+    many: boolean;
+    /** When set, only these file extensions/formats are accepted for local files. */
+    formats?: readonly string[];
+}
+export interface VerbSupport {
+    create: boolean;
+    get: boolean;
+    list: boolean;
+    delete: boolean;
+    stream: boolean;
+}
+export interface TaskResourceDescriptor {
+    /** Stable id, dotted for Creative Lab: `creative-lab.figure.prototype`. */
+    id: string;
+    /** Command tokens after `meshy`. */
+    commandPath: readonly string[];
+    base: ApiBase;
+    /** Appended to the base URL of the API family. */
+    relativePath: string;
+    /** Full path as the Skills documented it, for `resources` and endpoint-contracts. */
+    legacyEndpoint: string;
+    supports: VerbSupport;
+    mediaFields: readonly MediaField[];
+    /** `type` values the server reports for this resource. */
+    taskTypes: readonly string[];
+    billing: {
+        create: Billing;
+    };
+    /** Never true in S1: nothing billable is retried for the caller. */
+    automaticRetry: false;
+    creativeLab?: {
+        product: CreativeLabProduct;
+        stage: CreativeLabStage;
+    };
+    summary: string;
+}
+export declare const CREATIVE_LAB_PRODUCTS: readonly CreativeLabProduct[];
+export declare const CREATIVE_LAB_STAGES: readonly CreativeLabStage[];
+export declare const TASK_RESOURCES: readonly TaskResourceDescriptor[];
+export declare function findTaskResource(id: string): TaskResourceDescriptor | undefined;
+export declare function requireTaskResource(id: string): TaskResourceDescriptor;
+export declare function taskResourceByCommandPath(path: readonly string[]): TaskResourceDescriptor | undefined;
+/** Resolve a Creative Lab descriptor from user-supplied tokens without ever building a path from them. */
+export declare function creativeLabResource(product: string, stage: string): TaskResourceDescriptor | undefined;
+/** Resource ids that map 1:1 onto a top-level command (used by the legacy `--resource` flag and the index). */
+export declare const TOP_LEVEL_TASK_RESOURCE_IDS: readonly string[];
+export interface QueryResourceDescriptor {
+    id: string;
+    commandPath: readonly string[];
+    base: "v1" | "public-web";
+    method: "GET";
+    relativePath: string;
+    auth: "bearer" | "none";
+    billing: Billing;
+    summary: string;
+}
+export declare const QUERY_RESOURCES: readonly QueryResourceDescriptor[];
+export interface LocalToolDescriptor {
+    id: string;
+    commandPath: readonly string[];
+    summary: string;
+}
+export declare const LOCAL_TOOLS: readonly LocalToolDescriptor[];
+export type ResourceIndexKind = "task" | "query" | "local";
+export interface ResourceIndexEntry {
+    name: string;
+    kind: ResourceIndexKind;
+    command: string;
+    summary: string;
+    endpoint: string | null;
+    verbs: Verb[] | null;
+}
+/** The v1 `resources` index: every task resource, query and local tool. */
+export declare function resourceIndex(): ResourceIndexEntry[];
+//# sourceMappingURL=resource-registry.d.ts.map

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

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