@meshy-ai/cli 0.1.3 → 0.3.0

package/dist/client/types.d.ts

@@ -1,43 +1,30 @@
 /**
  * Zod schemas for Meshy request/response shapes (permissive passthrough).
+ *
+ * `TaskSchema` fills a few defaults so 0.2.0 summaries keep their shape. The
+ * v1 TaskView is built from the *raw* JSON (see task-view.ts), never from the
+ * defaulted object, so a field the server did not send stays null there.
  */
 import { z } from "zod";
 export declare const BalanceSchema: z.ZodObject<{
     balance: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    balance: number;
-}, {
-    balance: number;
-}>;
+}, z.core.$strip>;
 export type Balance = z.infer<typeof BalanceSchema>;
 export declare const TaskErrorSchema: z.ZodObject<{
     message: z.ZodDefault<z.ZodString>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    message: z.ZodDefault<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    message: z.ZodDefault<z.ZodString>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export type TaskError = z.infer<typeof TaskErrorSchema>;
 export declare const TextureSetSchema: z.ZodObject<{
     base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export type TextureSet = z.infer<typeof TextureSetSchema>;
-export declare const TaskStatusSchema: z.ZodUnion<[z.ZodLiteral<"PENDING">, z.ZodLiteral<"IN_PROGRESS">, z.ZodLiteral<"SUCCEEDED">, z.ZodLiteral<"FAILED">, z.ZodLiteral<"CANCELED">, z.ZodString]>;
+export declare const TaskStatusSchema: z.ZodUnion<readonly [z.ZodLiteral<"PENDING">, z.ZodLiteral<"IN_PROGRESS">, z.ZodLiteral<"SUCCEEDED">, z.ZodLiteral<"FAILED">, z.ZodLiteral<"CANCELED">, z.ZodString]>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
 export declare const TERMINAL_STATUSES: Set<string>;
+export declare function isTerminalStatus(status: string | null | undefined): boolean;
 export declare const PrintabilitySchema: z.ZodObject<{
     _version: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodString>;
@@ -46,128 +33,33 @@ export declare const PrintabilitySchema: z.ZodObject<{
     warning_count: z.ZodOptional<z.ZodNumber>;
     metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     evaluated_at: z.ZodOptional<z.ZodNumber>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    _version: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodString>;
-    issue_count: z.ZodOptional<z.ZodNumber>;
-    error_count: z.ZodOptional<z.ZodNumber>;
-    warning_count: z.ZodOptional<z.ZodNumber>;
-    metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    evaluated_at: z.ZodOptional<z.ZodNumber>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    _version: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodString>;
-    issue_count: z.ZodOptional<z.ZodNumber>;
-    error_count: z.ZodOptional<z.ZodNumber>;
-    warning_count: z.ZodOptional<z.ZodNumber>;
-    metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    evaluated_at: z.ZodOptional<z.ZodNumber>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export type Printability = z.infer<typeof PrintabilitySchema>;
 export declare const TaskSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodDefault<z.ZodString>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodDefault<z.ZodString>;
-    progress: z.ZodDefault<z.ZodNumber>;
-    preceding_tasks: z.ZodDefault<z.ZodNumber>;
-    created_at: z.ZodDefault<z.ZodNumber>;
-    started_at: z.ZodDefault<z.ZodNumber>;
-    finished_at: z.ZodDefault<z.ZodNumber>;
-    expires_at: z.ZodDefault<z.ZodNumber>;
-    task_error: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        message: z.ZodDefault<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        message: z.ZodDefault<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        message: z.ZodDefault<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>>>;
-    model_urls: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>>;
-    texture_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>>;
-    thumbnail_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    image_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
-    result: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    printability: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, z.ZodTypeAny, "passthrough">>>>;
-    ai_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    texture_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    texture_image_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    text_style_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    image_style_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    id: z.ZodString;
-    type: z.ZodDefault<z.ZodString>;
-    status: z.ZodDefault<z.ZodString>;
-    progress: z.ZodDefault<z.ZodNumber>;
-    preceding_tasks: z.ZodDefault<z.ZodNumber>;
-    created_at: z.ZodDefault<z.ZodNumber>;
-    started_at: z.ZodDefault<z.ZodNumber>;
-    finished_at: z.ZodDefault<z.ZodNumber>;
-    expires_at: z.ZodDefault<z.ZodNumber>;
+    progress: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number, number | null | undefined>>;
+    preceding_tasks: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number, number | null | undefined>>;
+    created_at: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number, number | null | undefined>>;
+    started_at: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number, number | null | undefined>>;
+    finished_at: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number, number | null | undefined>>;
+    expires_at: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodNumber>>, z.ZodTransform<number, number | null | undefined>>;
     task_error: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         message: z.ZodDefault<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        message: z.ZodDefault<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        message: z.ZodDefault<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.core.$loose>>>;
     model_urls: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>>;
     texture_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+    }, z.core.$loose>>>>;
     thumbnail_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    image_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+    thumbnail_urls: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>>;
+    alpha_thumbnail_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    image_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     result: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     printability: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         _version: z.ZodOptional<z.ZodString>;
@@ -177,106 +69,20 @@ export declare const TaskSchema: z.ZodObject<{
         warning_count: z.ZodOptional<z.ZodNumber>;
         metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
         evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, z.ZodTypeAny, "passthrough">>>>;
-    ai_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    texture_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    texture_image_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    text_style_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    image_style_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    id: z.ZodString;
-    type: z.ZodDefault<z.ZodString>;
-    status: z.ZodDefault<z.ZodString>;
-    progress: z.ZodDefault<z.ZodNumber>;
-    preceding_tasks: z.ZodDefault<z.ZodNumber>;
-    created_at: z.ZodDefault<z.ZodNumber>;
-    started_at: z.ZodDefault<z.ZodNumber>;
-    finished_at: z.ZodDefault<z.ZodNumber>;
-    expires_at: z.ZodDefault<z.ZodNumber>;
-    task_error: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        message: z.ZodDefault<z.ZodString>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        message: z.ZodDefault<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        message: z.ZodDefault<z.ZodString>;
-    }, z.ZodTypeAny, "passthrough">>>>;
-    model_urls: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>>;
-    texture_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        base_color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        metallic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        normal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        roughness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.ZodTypeAny, "passthrough">>, "many">>>;
-    thumbnail_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    image_urls: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
-    result: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    printability: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        _version: z.ZodOptional<z.ZodString>;
-        status: z.ZodOptional<z.ZodString>;
-        issue_count: z.ZodOptional<z.ZodNumber>;
-        error_count: z.ZodOptional<z.ZodNumber>;
-        warning_count: z.ZodOptional<z.ZodNumber>;
-        metrics: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-        evaluated_at: z.ZodOptional<z.ZodNumber>;
-    }, z.ZodTypeAny, "passthrough">>>>;
+    }, z.core.$loose>>>;
+    face_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    consumed_credits: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     ai_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     texture_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     texture_image_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     text_style_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     image_style_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.ZodTypeAny, "passthrough">>;
+}, z.core.$loose>;
 export type Task = z.infer<typeof TaskSchema>;
 export declare const TaskCreateResponseSchema: z.ZodObject<{
     result: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    result: string;
-}, {
-    result: string;
-}>;
+}, z.core.$strip>;
 export type TaskCreateResponse = z.infer<typeof TaskCreateResponseSchema>;
 export interface TaskSummary {
     id: string;
@@ -294,5 +100,6 @@ export interface TaskSummary {
     task_error?: TaskError | null;
     elapsed_seconds?: number;
 }
+/** Legacy (0.2.0) summary — shape preserved for existing consumers. */
 export declare function summarizeTask(task: Task, elapsedSeconds?: number): TaskSummary;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,eAAe;;;;;;gCAIZ,CAAC;AACjB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;gCAOb,CAAC;AACjB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,8JAO3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,aAAuD,CAAC;AAEtF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;gCAUf,CAAC;AACjB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAgCP,CAAC;AACjB,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAClD,YAAY,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW,CAkB9E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa;;iBAExB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,eAAe;;iBAIZ,CAAC;AACjB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;iBAOb,CAAC;AACjB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB,uKAO3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,aAAuD,CAAC;AAEtF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE3E;AAED,eAAO,MAAM,kBAAkB;;;;;;;;iBAUf,CAAC;AACjB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAS9D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCP,CAAC;AACjB,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAClD,YAAY,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW,CAkB9E"}

package/dist/client/types.js

@@ -1,5 +1,9 @@
 /**
  * Zod schemas for Meshy request/response shapes (permissive passthrough).
+ *
+ * `TaskSchema` fills a few defaults so 0.2.0 summaries keep their shape. The
+ * v1 TaskView is built from the *raw* JSON (see task-view.ts), never from the
+ * defaulted object, so a field the server did not send stays null there.
  */
 import { z } from "zod";
 export const BalanceSchema = z.object({
@@ -27,6 +31,9 @@ export const TaskStatusSchema = z.union([
     z.string(),
 ]);
 export const TERMINAL_STATUSES = new Set(["SUCCEEDED", "FAILED", "CANCELED"]);
+export function isTerminalStatus(status) {
+    return typeof status === "string" && TERMINAL_STATUSES.has(status);
+}
 export const PrintabilitySchema = z
     .object({
     _version: z.string().optional(),
@@ -38,24 +45,38 @@ export const PrintabilitySchema = z
     evaluated_at: z.number().optional(),
 })
     .passthrough();
+/** A count or epoch-millisecond field that a server may omit or send as null: absent and null both read as 0. */
+const nullableNumberOr0 = z
+    .number()
+    .nullable()
+    .optional()
+    .transform((v) => v ?? 0);
 export const TaskSchema = z
     .object({
     id: z.string(),
     type: z.string().default(""),
+    name: z.string().nullable().optional(),
     status: z.string().default(""),
-    progress: z.number().default(0),
-    preceding_tasks: z.number().default(0),
-    created_at: z.number().default(0),
-    started_at: z.number().default(0),
-    finished_at: z.number().default(0),
-    expires_at: z.number().default(0),
+    // The v2 endpoints report 0 for a timestamp that has not happened yet; the
+    // Creative Lab endpoints report null (observed live: finished_at: null while
+    // IN_PROGRESS). Both mean "not yet" and normalise to 0.
+    progress: nullableNumberOr0,
+    preceding_tasks: nullableNumberOr0,
+    created_at: nullableNumberOr0,
+    started_at: nullableNumberOr0,
+    finished_at: nullableNumberOr0,
+    expires_at: nullableNumberOr0,
     task_error: TaskErrorSchema.nullable().optional(),
     model_urls: z.record(z.string(), z.string().nullable()).nullable().optional(),
     texture_urls: z.array(TextureSetSchema).nullable().optional(),
     thumbnail_url: z.string().nullable().optional(),
+    thumbnail_urls: z.record(z.string(), z.string().nullable()).nullable().optional(),
+    alpha_thumbnail_url: z.string().nullable().optional(),
     image_urls: z.array(z.string()).nullable().optional(),
     result: z.record(z.string(), z.any()).nullable().optional(),
     printability: PrintabilitySchema.nullable().optional(),
+    face_count: z.number().nullable().optional(),
+    consumed_credits: z.number().nullable().optional(),
     ai_model: z.string().nullable().optional(),
     prompt: z.string().nullable().optional(),
     texture_prompt: z.string().nullable().optional(),
@@ -67,6 +88,7 @@ export const TaskSchema = z
 export const TaskCreateResponseSchema = z.object({
     result: z.string(),
 });
+/** Legacy (0.2.0) summary — shape preserved for existing consumers. */
 export function summarizeTask(task, elapsedSeconds) {
     const summary = {
         id: task.id,

package/dist/client/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAChC,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC;IACtC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACpB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACxB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACtB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACrB,CAAC,CAAC,MAAM,EAAE;CACX,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjC,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEjD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7E,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE/C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAErD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE3D,YAAY,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEtD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAoBH,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,cAAuB;IAC/D,MAAM,OAAO,GAAgB;QAC3B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IACF,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;QAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxE,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI;QAAE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAC3E,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAiC,CAAC;IACjF,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;QAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAChC,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC;IACtC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACpB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACxB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACtB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACrB,CAAC,CAAC,MAAM,EAAE;CACX,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAEtF,MAAM,UAAU,gBAAgB,CAAC,MAAiC;IAChE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,iHAAiH;AACjH,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,EAAE;KACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,6EAA6E;IAC7E,wDAAwD;IACxD,QAAQ,EAAE,iBAAiB;IAC3B,eAAe,EAAE,iBAAiB;IAElC,UAAU,EAAE,iBAAiB;IAC7B,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,iBAAiB;IAC9B,UAAU,EAAE,iBAAiB;IAE7B,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEjD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7E,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjF,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAErD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAErD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE3D,YAAY,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAElD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC;KACD,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAoBH,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,cAAuB;IAC/D,MAAM,OAAO,GAAgB;QAC3B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IACF,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;QAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxE,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI;QAAE,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAC3E,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAiC,CAAC;IACjF,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;QAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cmd/animation-catalog.d.ts

@@ -0,0 +1,26 @@
+/**
+ * animation-catalog — the public Animation Library behind `animate --action-id`.
+ *
+ * GET <v1 origin>/web/public/animations/resources[?category=…]. No credential
+ * is loaded or sent; the command works without any Meshy account. `--search`
+ * filters the fetched batch locally (name / key / subCategory, case-insensitive)
+ * and says so in the result — it is not a server-side search.
+ */
+import { Command } from "commander";
+import { type AnimationCatalogEntry } from "../client/endpoints/animation-catalog.js";
+export interface CatalogItem {
+    action_id: number;
+    name: string | null;
+    key: string | null;
+    category: string | null;
+    sub_category: string | null;
+    preview_url: string | null;
+    rig_type: string | null;
+    is_default: boolean | null;
+    is_free: boolean | null;
+}
+export declare function toCatalogItem(e: AnimationCatalogEntry): CatalogItem;
+/** Case-insensitive substring match over name, key and sub-category. */
+export declare function matchesSearch(item: CatalogItem, search: string): boolean;
+export declare const animationCatalogCommand: Command;
+//# sourceMappingURL=animation-catalog.d.ts.map

package/dist/cmd/animation-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-catalog.d.ts","sourceRoot":"","sources":["../../src/cmd/animation-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAkD,KAAK,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAQtI,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,qBAAqB,GAAG,WAAW,CAYnE;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAIxE;AAiDD,eAAO,MAAM,uBAAuB,SAEV,CAAC"}

package/dist/cmd/animation-catalog.js

@@ -0,0 +1,80 @@
+/**
+ * animation-catalog — the public Animation Library behind `animate --action-id`.
+ *
+ * GET <v1 origin>/web/public/animations/resources[?category=…]. No credential
+ * is loaded or sent; the command works without any Meshy account. `--search`
+ * filters the fetched batch locally (name / key / subCategory, case-insensitive)
+ * and says so in the result — it is not a server-side search.
+ */
+import { Command, Option } from "commander";
+import { AnimationCatalogEndpoint, ANIMATION_CATEGORIES } from "../client/endpoints/animation-catalog.js";
+import { createPublicTransport } from "../client/transport.js";
+import { emitResult, openCommand, rejectOutputFlagForV1, saveRawJson } from "../internal/command-helpers.js";
+import { DEFAULT_BASE_URL_V1, derivePublicWebBase } from "../internal/config.js";
+import { abortSignal } from "../internal/context.js";
+import { buildLocalRuntime } from "../internal/runtime.js";
+import { warning } from "../internal/result.js";
+export function toCatalogItem(e) {
+    return {
+        action_id: e.id,
+        name: e.name ?? null,
+        key: e.key ?? null,
+        category: e.category ?? null,
+        sub_category: e.subCategory ?? null,
+        preview_url: e.previewUrl ?? null,
+        rig_type: e.rigType ?? null,
+        is_default: e.isDefault ?? null,
+        is_free: e.isFree ?? null,
+    };
+}
+/** Case-insensitive substring match over name, key and sub-category. */
+export function matchesSearch(item, search) {
+    const needle = search.trim().toLowerCase();
+    if (!needle)
+        return true;
+    return [item.name, item.key, item.sub_category].some((v) => typeof v === "string" && v.toLowerCase().includes(needle));
+}
+const listCommand = new Command("list")
+    .description("Fetch the public animation catalog (no API key needed) and list action ids")
+    .addOption(new Option("--category <name>", "server-side category filter").choices([...ANIMATION_CATEGORIES]))
+    .option("--search <text>", "local, case-insensitive match on name / key / sub-category")
+    .option("--include-raw", "include the untouched catalog response under result.raw")
+    .option("--save-json <file>", "save the untouched catalog response to this file (never overwrites)")
+    .action(async (opts, thisCmd) => {
+    const opened = openCommand(thisCmd, "animation-catalog.list", "v1");
+    rejectOutputFlagForV1(opened, opts.saveJson);
+    buildLocalRuntime(opened.flags);
+    const baseV1 = opened.flags.baseUrlV1 ?? process.env["MESHY_BASE_URL_V1"] ?? DEFAULT_BASE_URL_V1;
+    const publicBase = derivePublicWebBase(baseV1);
+    const transport = createPublicTransport({ baseUrl: publicBase, readTimeoutMs: readTimeout() });
+    const endpoint = new AnimationCatalogEndpoint(transport);
+    const { entries, total, raw } = await endpoint.list({ category: opts.category }, { signal: abortSignal() });
+    const all = entries.map(toCatalogItem);
+    const items = opts.search ? all.filter((i) => matchesSearch(i, opts.search)) : all;
+    const warnings = [];
+    if (total !== null && total !== entries.length) {
+        warnings.push(warning("catalog_total_mismatch", `server reported total=${total} but returned ${entries.length} entries; only the returned batch was searched`));
+    }
+    const saved = opts.saveJson ? saveRawJson(opts.saveJson, raw, { workspace: opened.flags.workspaceRoot }) : null;
+    await emitResult(opened, items, {
+        items,
+        count: items.length,
+        fetched: entries.length,
+        total,
+        filters: { category: opts.category ?? null, search: opts.search ?? null },
+        search_scope: "local",
+        source: `${publicBase}${AnimationCatalogEndpoint.PATH}`,
+        authenticated: false,
+        saved_json: saved,
+        ...(opts.includeRaw ? { raw } : {}),
+    }, { warnings });
+});
+function readTimeout() {
+    const raw = process.env["MESHY_READ_TIMEOUT_MS"];
+    const n = raw ? Number(raw) : NaN;
+    return Number.isFinite(n) && n > 0 ? n : 120_000;
+}
+export const animationCatalogCommand = new Command("animation-catalog")
+    .description("Public animation library lookups (no API key required)")
+    .addCommand(listCommand);
+//# sourceMappingURL=animation-catalog.js.map

package/dist/cmd/animation-catalog.js.map

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

package/dist/cmd/api.d.ts

@@ -1,8 +1,9 @@
 /**
- * Raw API passthrough: `meshy-cli api [--v1|--v2] <method> <path> [--data <json>] [--params <json>]`
+ * Raw API passthrough: `meshy-cli api [--v1|--v2|--creative-lab] <method> <path> [--data <json>] [--params <json>]`
  *
  * Prints the JSON body when the response is JSON, or raw text otherwise.
- * Non-2xx responses exit with code 1 and print an error summary on stderr.
+ * Non-2xx responses exit non-zero with an error payload. Write verbs are
+ * never retried: the passthrough is a controlled escape hatch, not a client.
  */
 import { Command } from "commander";
 export declare const apiCommand: Command;

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/cmd/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,UAAU,SAuCnB,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/cmd/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAQ5C,eAAO,MAAM,UAAU,SAsDnB,CAAC"}

package/dist/cmd/api.js

@@ -1,25 +1,37 @@
 /**
- * Raw API passthrough: `meshy-cli api [--v1|--v2] <method> <path> [--data <json>] [--params <json>]`
+ * Raw API passthrough: `meshy-cli api [--v1|--v2|--creative-lab] <method> <path> [--data <json>] [--params <json>]`
  *
  * Prints the JSON body when the response is JSON, or raw text otherwise.
- * Non-2xx responses exit with code 1 and print an error summary on stderr.
+ * Non-2xx responses exit non-zero with an error payload. Write verbs are
+ * never retried: the passthrough is a controlled escape hatch, not a client.
  */
-import { Command } from "commander";
-import { emit } from "../internal/output.js";
+import { Command, Option } from "commander";
+import { emitResult, openCommand, rejectOutputFlagForV1, saveRawJson } from "../internal/command-helpers.js";
+import { UsageError } from "../internal/errors.js";
 import { parseJsonFlag } from "../internal/payload.js";
-import { buildRuntime, readGlobalFlags } from "../internal/runtime.js";
+import { buildRuntime } from "../internal/runtime.js";
+const METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE"]);
 export const apiCommand = new Command("api")
     .description("Raw HTTP passthrough to the Meshy API (JSON only)")
     .argument("<method>", "HTTP method: GET | POST | PUT | PATCH | DELETE")
     .argument("<path>", "API path (e.g. /text-to-3d or /balance)")
     .option("--v2", "use the v2 base URL (default: v1)")
     .option("--v1", "force v1 (default)")
+    .addOption(new Option("--creative-lab", "use the Creative Lab base URL (paths like /figure/v1/prototype)"))
     .option("--data <json>", "request body JSON (or @file.json)")
     .option("--params <json>", "query params JSON object")
+    .option("--save-json <file>", "v1: also save the raw response body to this file (never overwrites)")
     .action(async (method, path, opts, thisCmd) => {
-    const runtime = await buildRuntime(readGlobalFlags(thisCmd));
-    const apiVersion = opts.v2 ? "v2" : "v1";
+    const opened = openCommand(thisCmd, "api", "legacy");
+    rejectOutputFlagForV1(opened, opts.saveJson);
     const verb = method.toUpperCase();
+    if (!METHODS.has(verb))
+        throw new UsageError(`unsupported HTTP method '${method}'. Expected: GET | POST | PUT | PATCH | DELETE`);
+    if ((opts.v2 ? 1 : 0) + (opts.v1 ? 1 : 0) + (opts.creativeLab ? 1 : 0) > 1) {
+        throw new UsageError("--v1, --v2 and --creative-lab are mutually exclusive");
+    }
+    const apiVersion = opts.v2 ? "v2" : opts.creativeLab ? "creative-lab" : "v1";
+    const runtime = await buildRuntime(opened.flags);
     let finalPath = path.startsWith("/") ? path : `/${path}`;
     const params = parseJsonFlag(opts.params, "--params");
     const qs = Object.entries(params)
@@ -45,6 +57,8 @@ export const apiCommand = new Command("api")
     catch {
         /* leave as text */
     }
-    emit(parsed, { format: runtime.flags.format, file: runtime.flags.output });
+    const saveJson = opts.saveJson;
+    const saved = saveJson ? saveRawJson(saveJson, parsed, { workspace: opened.flags.workspaceRoot }) : null;
+    await emitResult(opened, parsed, { http_status: resp.status, method: verb, path: finalPath, api: apiVersion, body: parsed, saved_json: saved }, { legacyFile: opened.flags.output });
 });
 //# sourceMappingURL=api.js.map

package/dist/cmd/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/cmd/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/cmd/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,mDAAmD,CAAC;KAChE,QAAQ,CAAC,UAAU,EAAE,gDAAgD,CAAC;KACtE,QAAQ,CAAC,QAAQ,EAAE,yCAAyC,CAAC;KAC7D,MAAM,CAAC,MAAM,EAAE,mCAAmC,CAAC;KACnD,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC;KACpC,SAAS,CAAC,IAAI,MAAM,CAAC,gBAAgB,EAAE,iEAAiE,CAAC,CAAC;KAC1G,MAAM,CAAC,eAAe,EAAE,mCAAmC,CAAC;KAC5D,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;KACrD,MAAM,CAAC,oBAAoB,EAAE,qEAAqE,CAAC;KACnG,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAY,EAAE,IAA6B,EAAE,OAAgB,EAAE,EAAE;IAC9F,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrD,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,QAA8B,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,MAAM,gDAAgD,CAAC,CAAC;IACjI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAAC,sDAAsD,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjD,IAAI,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAA4B,EAAE,UAAU,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5E,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,EAAE;QAAE,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;IAEhE,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAc,EAAE,QAAQ,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAY,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzG,MAAM,UAAU,CACd,MAAM,EACN,MAAM,EACN,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,EAC7G,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CACpC,CAAC;AACJ,CAAC,CAAC,CAAC"}