pixelkiln 0.71.0 → 0.72.0

package/PROVIDERS.md

@@ -214,7 +214,7 @@ conversion to dollars:
 | `isometricTile` | 1 generation (measured once) |
 | `character` base | 1 (standard), 2–9 (v3), 20–40 (pro), 6–17 (pro-flash; rotations only from a reference) |
 | `character` state or portrait | 20–40 generations |
-| `character` animation | 1 (template), 1 at 64px from text, 20–40 (pro) |
+| `character` animation | 1 (template), 2–4 (`skeleton-v3`, budgeted at 4), 1 at 64px from text, 20–40 (pro) |
 | `character` outfit | 20 generations (one 2-frame, 92×92 job) |
 | `objectPro` base | 6 at 64px (unmeasured) |
 | `uiAsset` | 20 generations (measured once, at 256×192) |

package/dist/cli.js

@@ -934,7 +934,7 @@ var CharacterProportionsSchema = z.union([
     hipWidth: z.number().min(0.5).max(2).optional()
   }).strict()
 ]);
-var CharacterAnimationModeSchema = z.enum(["template", "v3", "pro"]);
+var CharacterAnimationModeSchema = z.enum(["template", "skeleton-v3", "v3", "pro"]);
 var UiPieceSchema = z.discriminatedUnion("kind", [
   z.object({
     id: z.string().min(1),
@@ -1048,7 +1048,11 @@ var CharacterAnimationSchema = z.object({
   fps: z.number().int().min(1).max(60).default(8),
   /** v3 only: keep the resting pose as frame 0, so `frames` generated frames land as `frames + 1` files. */
   keepFirstFrame: z.boolean().default(true),
-  /** `template` when a template is named, otherwise `v3`; `pro` for the sequential high-quality engine. */
+  /**
+   * `template` when a template is named, otherwise `v3`; `skeleton-v3`
+   * poses a template with PixelLab's skeleton model instead; `pro` for the
+   * sequential high-quality engine.
+   */
   mode: CharacterAnimationModeSchema.optional(),
   /**
    * v3 only: a manifest-relative image of the pose to start from, instead
@@ -1085,7 +1089,7 @@ var CharacterAnimationSchema = z.object({
     if (animation[key] !== void 0 && mode2 !== "v3") {
       context.addIssue({
         code: z.ZodIssueCode.custom,
-        message: `${key} is for v3 loops; a ${mode2} loop ${mode2 === "template" ? "starts from the character's rotation and follows its template" : "takes neither"}`,
+        message: `${key} is for v3 loops; a ${mode2} loop ${mode2 === "template" || mode2 === "skeleton-v3" ? "starts from the character's rotation and follows its template" : "takes neither"}`,
         path: [key]
       });
     }
@@ -1095,10 +1099,10 @@ var CharacterAnimationSchema = z.object({
       context.addIssue({ code: z.ZodIssueCode.custom, message: `${key} overrides apply to template loops only`, path: [key] });
     }
   }
-  if (animation.template && animation.mode && animation.mode !== "template") {
+  if (animation.template && animation.mode && animation.mode !== "template" && animation.mode !== "skeleton-v3") {
     context.addIssue({
       code: z.ZodIssueCode.custom,
-      message: `a template animation cannot use mode "${animation.mode}"`,
+      message: `a template animation cannot use mode "${animation.mode}"; use "template" or "skeleton-v3"`,
       path: ["mode"]
     });
   }
@@ -1109,8 +1113,8 @@ var CharacterAnimationSchema = z.object({
       path: ["frames"]
     });
   }
-  if (!animation.template && animation.mode === "template") {
-    context.addIssue({ code: z.ZodIssueCode.custom, message: "template mode needs a template", path: ["template"] });
+  if (!animation.template && (animation.mode === "template" || animation.mode === "skeleton-v3")) {
+    context.addIssue({ code: z.ZodIssueCode.custom, message: `${animation.mode} mode needs a template`, path: ["template"] });
   }
 });
 var RevisionDitheringSchema = z.enum(["none", "2x2", "4x4", "8x8"]);
@@ -6666,12 +6670,20 @@ var PixelLabClient = class {
   }
   /**
    * One animation of one character. Template mode costs a generation per
-   * direction and fixes the frame count; v3 draws `frameCount` frames from
-   * the action text; pro is the sequential engine. One job per direction.
+   * direction and fixes the frame count; skeleton-v3 poses the same template
+   * with the skeleton video model (2-4 generations per direction); v3 draws
+   * `frameCount` frames from the action text; pro is the sequential engine.
+   * One job per direction.
+   *
+   * Every mode but skeleton-v3 goes to `/animate-character`, the path whose
+   * shapes were measured live. skeleton-v3 is documented only on
+   * `/characters/animations`, which takes the same request and answers with
+   * the same job list (plus an `animation_group_id`).
    */
   async animateCharacter(args) {
     const encode = (image) => ({ type: "base64", base64: image.base64, format: image.format });
-    const raw = await this.request("/animate-character", {
+    const endpoint = args.mode === "skeleton-v3" ? "/characters/animations" : "/animate-character";
+    const raw = await this.request(endpoint, {
       method: "POST",
       body: JSON.stringify({
         character_id: args.characterId,
@@ -6695,7 +6707,7 @@ var PixelLabClient = class {
         ...args.seed != null ? { seed: args.seed } : {}
       })
     });
-    return validateResponse(AnimateSubmitSchema, raw, "animate-character");
+    return validateResponse(AnimateSubmitSchema, raw, endpoint.slice(1));
   }
   /**
    * A full-body sprite in, a bust portrait out (or the reverse, unused
@@ -7291,6 +7303,7 @@ function characterCost(spec) {
   if (character.kind === "animation") {
     const animation = character.animation;
     if (animation.mode === "template") return 1;
+    if (animation.mode === "skeleton-v3") return 4;
     if (animation.mode === "v3") return Math.max(1, Math.ceil(px * animation.frames / 65536));
     return generationCost(spec.width, spec.height, "1dir");
   }
@@ -7883,7 +7896,7 @@ var PixelLabProvider = class _PixelLabProvider {
           `${spec.styleId}/${spec.assetId} animates "${character.animation.direction}", but its character has ${character.directions} directions: ${allowed.join(", ")}`
         );
       }
-      if (character.animation.mode !== "template" && !spec.prompt.trim()) {
+      if (character.animation.mode !== "template" && character.animation.mode !== "skeleton-v3" && !spec.prompt.trim()) {
         throw new Error(`${spec.styleId}/${spec.assetId} needs a prompt describing the motion, or a template`);
       }
     }
@@ -11400,8 +11413,8 @@ async function resolveObjectProShape(assetId, asset, style, kind, files) {
         );
       }
     }
-    if (asset.animation.mode === "template") {
-      throw new Error(`assets.${assetId}: objectPro animations have no "template" mode; use "v3" or "pro"`);
+    if (asset.animation.mode === "template" || asset.animation.mode === "skeleton-v3") {
+      throw new Error(`assets.${assetId}: objectPro animations have no "${asset.animation.mode}" mode; use "v3" or "pro"`);
     }
     const pose = async (rel, what) => {
       const image = await files.load(rel, what);