pixelkiln 0.68.0 → 0.69.0

package/dist/index.d.ts

@@ -415,39 +415,30 @@ declare function requireBalance(provider: Provider): NonNullable<Provider["balan
 declare function formatCost(unit: CostUnit, amount: number): string;
 
 /**
- * PixelLab's per-joint keypoint, `{label, x, y, z_index}` (confirmed against
- * the live `animate_with_skeleton_v3` MCP tool schema, whose own example is
- * `{"label": "RIGHT KNEE", "x": 0.52, "y": 0.71, "z_index": 9}`). Field names
- * are snake_case here, breaking this codebase's usual camelCase convention —
- * deliberately: this is a serialized PixelLab API payload, not manifest
- * prose. The realistic authoring path is `pixelkiln estimate-skeleton` →
- * dump the response to disk unmodified → hand-tweak a few joints for
- * in-between frames. Renaming fields would make that a lossy round trip.
+ * PixelLab's per-joint keypoint, `{label, x, y, z_index}`, with `x`/`y` as
+ * fractions of the image (the MCP tool's own example is `{"label": "RIGHT
+ * KNEE", "x": 0.52, "y": 0.71, "z_index": 9}`). Field names are snake_case,
+ * breaking this codebase's usual camelCase convention, deliberately: this is
+ * a serialized PixelLab payload, and `pixelkiln estimate-skeleton` writes the
+ * response to disk as it came, so renaming would make that a lossy round trip.
  *
- * `label` is left a free string, not an enum of the 18 canonical joint
- * names: the exhaustive list and exact spelling of all 18 is not confirmed
- * anywhere this codebase can read from (only "RIGHT KNEE" is known, as an
- * example). Guessing the other 17 and getting one wrong would silently
- * reject a valid request. No client-side content validation of `label`
- * beyond requiring one — matching this codebase's existing precedent of
- * letting PixelLab's API reject what it rejects rather than gating on an
- * assumed vocabulary (no other PixelLab call in this codebase validates
- * field *content* client-side, only shape/range).
+ * `label` is one of the 18 names the OpenAPI document enumerates, so a typo
+ * fails when the manifest loads instead of after a paid call.
  */
 declare const SkeletonKeypointSchema: z.ZodObject<{
-    label: z.ZodString;
+    label: z.ZodEnum<["NOSE", "NECK", "RIGHT SHOULDER", "RIGHT ELBOW", "RIGHT ARM", "LEFT SHOULDER", "LEFT ELBOW", "LEFT ARM", "RIGHT HIP", "RIGHT KNEE", "RIGHT LEG", "LEFT HIP", "LEFT KNEE", "LEFT LEG", "RIGHT EYE", "LEFT EYE", "RIGHT EAR", "LEFT EAR"]>;
     x: z.ZodNumber;
     y: z.ZodNumber;
     z_index: z.ZodNumber;
     depth: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    label: string;
+    label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
     x: number;
     y: number;
     z_index: number;
     depth?: number | undefined;
 }, {
-    label: string;
+    label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
     x: number;
     y: number;
     z_index: number;
@@ -460,54 +451,78 @@ type SkeletonKeypoint = z.infer<typeof SkeletonKeypointSchema>;
  * motion (3-15 frames, PixelLab's own documented ceiling).
  */
 declare const SkeletonSetSchema: z.ZodObject<{
-    firstFrameKeypoints: z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
+    firstFrameKeypoints: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        label: z.ZodEnum<["NOSE", "NECK", "RIGHT SHOULDER", "RIGHT ELBOW", "RIGHT ARM", "LEFT SHOULDER", "LEFT ELBOW", "LEFT ARM", "RIGHT HIP", "RIGHT KNEE", "RIGHT LEG", "LEFT HIP", "LEFT KNEE", "LEFT LEG", "RIGHT EYE", "LEFT EYE", "RIGHT EAR", "LEFT EAR"]>;
         x: z.ZodNumber;
         y: z.ZodNumber;
         z_index: z.ZodNumber;
         depth: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
         depth?: number | undefined;
     }, {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
         depth?: number | undefined;
-    }>, "many">;
-    frames: z.ZodArray<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
+    }>, "many">, {
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
+        x: number;
+        y: number;
+        z_index: number;
+        depth?: number | undefined;
+    }[], {
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
+        x: number;
+        y: number;
+        z_index: number;
+        depth?: number | undefined;
+    }[]>;
+    frames: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodObject<{
+        label: z.ZodEnum<["NOSE", "NECK", "RIGHT SHOULDER", "RIGHT ELBOW", "RIGHT ARM", "LEFT SHOULDER", "LEFT ELBOW", "LEFT ARM", "RIGHT HIP", "RIGHT KNEE", "RIGHT LEG", "LEFT HIP", "LEFT KNEE", "LEFT LEG", "RIGHT EYE", "LEFT EYE", "RIGHT EAR", "LEFT EAR"]>;
         x: z.ZodNumber;
         y: z.ZodNumber;
         z_index: z.ZodNumber;
         depth: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
         depth?: number | undefined;
     }, {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
+        x: number;
+        y: number;
+        z_index: number;
+        depth?: number | undefined;
+    }>, "many">, {
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
+        x: number;
+        y: number;
+        z_index: number;
+        depth?: number | undefined;
+    }[], {
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
         depth?: number | undefined;
-    }>, "many">, "many">;
+    }[]>, "many">;
 }, "strict", z.ZodTypeAny, {
     firstFrameKeypoints: {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
         depth?: number | undefined;
     }[];
     frames: {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
@@ -515,14 +530,14 @@ declare const SkeletonSetSchema: z.ZodObject<{
     }[][];
 }, {
     firstFrameKeypoints: {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
         depth?: number | undefined;
     }[];
     frames: {
-        label: string;
+        label: "NOSE" | "NECK" | "RIGHT SHOULDER" | "RIGHT ELBOW" | "RIGHT ARM" | "LEFT SHOULDER" | "LEFT ELBOW" | "LEFT ARM" | "RIGHT HIP" | "RIGHT KNEE" | "RIGHT LEG" | "LEFT HIP" | "LEFT KNEE" | "LEFT LEG" | "RIGHT EYE" | "LEFT EYE" | "RIGHT EAR" | "LEFT EAR";
         x: number;
         y: number;
         z_index: number;
@@ -937,11 +952,11 @@ declare const AssetBatchSchema: z.ZodObject<{
     /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
     index: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
-    of: string;
     index: number;
-}, {
     of: string;
+}, {
     index: number;
+    of: string;
 }>;
 type AssetBatch = z.infer<typeof AssetBatchSchema>;
 /** A pose or outfit of an existing character, applied to every direction. */
@@ -4258,11 +4273,11 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
         /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
         index: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        of: string;
         index: number;
-    }, {
         of: string;
+    }, {
         index: number;
+        of: string;
     }>>;
     /** `uiAsset` styles: precise shape regions the panel is composited from. Combine with `elements`; omit both for a default full-canvas panel. */
     pieces: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -4573,8 +4588,8 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     remoteId?: string | undefined;
     batch?: {
-        of: string;
         index: number;
+        of: string;
     } | undefined;
     pieces?: ({
         x: number;
@@ -4691,8 +4706,8 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     remoteId?: string | undefined;
     batch?: {
-        of: string;
         index: number;
+        of: string;
     } | undefined;
     pieces?: ({
         x: number;
@@ -4815,8 +4830,8 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     remoteId?: string | undefined;
     batch?: {
-        of: string;
         index: number;
+        of: string;
     } | undefined;
     pieces?: ({
         x: number;
@@ -4933,8 +4948,8 @@ declare const AssetSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     remoteId?: string | undefined;
     batch?: {
-        of: string;
         index: number;
+        of: string;
     } | undefined;
     pieces?: ({
         x: number;
@@ -6218,11 +6233,11 @@ declare const ManifestSchema: z.ZodObject<{
             /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
             index: z.ZodNumber;
         }, "strict", z.ZodTypeAny, {
-            of: string;
             index: number;
-        }, {
             of: string;
+        }, {
             index: number;
+            of: string;
         }>>;
         /** `uiAsset` styles: precise shape regions the panel is composited from. Combine with `elements`; omit both for a default full-canvas panel. */
         pieces: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -6533,8 +6548,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -6651,8 +6666,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -6775,8 +6790,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -6893,8 +6908,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -7105,8 +7120,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -7312,8 +7327,8 @@ declare const ManifestSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -8911,11 +8926,11 @@ declare const ManifestInputSchema: z.ZodObject<{
             /** 1-based slot in the batch (the leader is implicitly slot 0). Unique and contiguous among siblings. */
             index: z.ZodNumber;
         }, "strict", z.ZodTypeAny, {
-            of: string;
             index: number;
-        }, {
             of: string;
+        }, {
             index: number;
+            of: string;
         }>>;
         /** `uiAsset` styles: precise shape regions the panel is composited from. Combine with `elements`; omit both for a default full-canvas panel. */
         pieces: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
@@ -9226,8 +9241,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -9344,8 +9359,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -9468,8 +9483,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -9586,8 +9601,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -9882,8 +9897,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;
@@ -10173,8 +10188,8 @@ declare const ManifestInputSchema: z.ZodObject<{
         } | undefined;
         remoteId?: string | undefined;
         batch?: {
-            of: string;
             index: number;
+            of: string;
         } | undefined;
         pieces?: ({
             x: number;

package/dist/index.js

@@ -1370,14 +1370,42 @@ function fetchWithRetry(request, opts = {}) {
 
 // src/skeleton.ts
 import { z as z2 } from "zod";
+var SKELETON_LABELS = [
+  "NOSE",
+  "NECK",
+  "RIGHT SHOULDER",
+  "RIGHT ELBOW",
+  "RIGHT ARM",
+  "LEFT SHOULDER",
+  "LEFT ELBOW",
+  "LEFT ARM",
+  "RIGHT HIP",
+  "RIGHT KNEE",
+  "RIGHT LEG",
+  "LEFT HIP",
+  "LEFT KNEE",
+  "LEFT LEG",
+  "RIGHT EYE",
+  "LEFT EYE",
+  "RIGHT EAR",
+  "LEFT EAR"
+];
 var SkeletonKeypointSchema = z2.object({
-  label: z2.string().min(1),
+  label: z2.enum(SKELETON_LABELS),
   x: z2.number().min(0).max(1),
   y: z2.number().min(0).max(1),
   z_index: z2.number(),
   depth: z2.number().optional()
 }).strict();
-var SkeletonFrameSchema = z2.array(SkeletonKeypointSchema).length(18);
+var SkeletonFrameSchema = z2.array(SkeletonKeypointSchema).length(18).superRefine((frame, context) => {
+  const seen = /* @__PURE__ */ new Set();
+  for (const [index, joint] of frame.entries()) {
+    if (seen.has(joint.label)) {
+      context.addIssue({ code: z2.ZodIssueCode.custom, message: `"${joint.label}" appears twice`, path: [index, "label"] });
+    }
+    seen.add(joint.label);
+  }
+});
 var SkeletonSetSchema = z2.object({
   firstFrameKeypoints: SkeletonFrameSchema,
   frames: z2.array(SkeletonFrameSchema).min(3).max(15)
@@ -2742,7 +2770,7 @@ var PixelLabClient = class {
    * account (see `EstimateSkeletonResponseSchema`'s own caveat).
    */
   async estimateSkeleton(args) {
-    const body = { image: args.image };
+    const body = { image: { type: "base64", base64: args.image.base64, format: args.image.format } };
     const res = validateResponse(
       EstimateSkeletonResponseSchema,
       await this.request("/estimate-skeleton", { method: "POST", body: JSON.stringify(body) }),