pixelkiln 0.70.1 → 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);
@@ -14419,6 +14432,15 @@ var SkeletonAnimationRequestSchema = z8.object({
   /** Replace an existing `keypointsFile` with `set`. */
   overwrite: z8.boolean().optional()
 }).strict();
+var SkeletonKeypointsUpdateSchema = z8.object({
+  action: z8.literal("update-skeleton-keypoints"),
+  project: z8.string().min(1).optional(),
+  styleId: z8.string().min(1),
+  assetId: z8.string().min(1),
+  /** The file's SHA-256 when the page loaded it; anything else on disk is a concurrent edit. */
+  expectedSha256: z8.string().regex(/^[0-9a-f]{64}$/),
+  set: SkeletonSetSchema
+}).strict();
 var DEFAULT_ESTIMATE_LIMIT = 10;
 function skeletonSourceFile(spec) {
   if (spec.source) return path26.resolve(spec.root, spec.source);
@@ -14521,6 +14543,26 @@ async function createSkeletonAnimation(manifestPath, request) {
     throw error;
   }
 }
+async function updateSkeletonKeypoints(ctx, request) {
+  const key = lockKey(request.styleId, request.assetId);
+  const spec = ctx.specs.find((candidate) => lockKey(candidate.styleId, candidate.assetId) === key);
+  if (!spec) throw new ManifestEditError(`"${key}" is not declared by the manifest`);
+  const file = spec.revision?.mode === "animate-skeleton" ? spec.revision.keypointsFile : void 0;
+  if (!file) throw new ManifestEditError(`${key} is not an animate-skeleton revision`);
+  const relative = path26.relative(ctx.loaded.root, file);
+  if (relative.startsWith("..") || path26.isAbsolute(relative)) {
+    throw new ManifestEditError(`${key}'s keypoints file is outside the project; edit it by hand`);
+  }
+  const current = existsSync18(file) ? sha256(await readFile17(file)) : null;
+  if (current !== request.expectedSha256) {
+    throw Object.assign(
+      new Error(`${relative.split(path26.sep).join("/")} changed on disk since this page loaded it; press Refresh and edit again`),
+      { status: 409 }
+    );
+  }
+  await writeFile12(file, JSON.stringify(request.set, null, 2) + "\n");
+  return relative.split(path26.sep).join("/");
+}
 
 // src/gallery/edit.ts
 var Base64 = z9.string().regex(/^[A-Za-z0-9+/]*={0,2}$/).max(Math.ceil(MAX_HAND_EDIT_BYTES / 3) * 4);
@@ -14597,6 +14639,18 @@ function createGalleryEditHandler(opts) {
       }
       return opts.reload();
     }
+    const poses = SkeletonKeypointsUpdateSchema.safeParse(body);
+    if (poses.success) {
+      if (!opts.loadProject) throw new ManifestEditError("pose edits are not available in this gallery");
+      const written = await updateSkeletonKeypoints(await opts.loadProject(poses.data.project), poses.data);
+      log2(`  poses saved: ${written} (${poses.data.styleId}/${poses.data.assetId} is stale until generated again)`);
+      return opts.reload();
+    }
+    if (body?.action === "update-skeleton-keypoints") {
+      throw new ManifestEditError(
+        "invalid pose edit: " + poses.error.issues.slice(0, 3).map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")
+      );
+    }
     const skeleton = SkeletonAnimationRequestSchema.safeParse(body);
     if (skeleton.success) {
       let manifestPath2;
@@ -15112,7 +15166,8 @@ async function buildGallerySnapshot(opts) {
       mirrorOfKey: spec.mirror ? lockKey(spec.styleId, spec.mirror.sourceAssetId) : entry?.mirror ? lockKey(spec.styleId, entry.mirror.sourceAssetId) : null,
       skeleton: spec.revision?.mode === "animate-skeleton" && spec.revision.keypointsFile ? {
         keypointsFile: portableOutputPath(spec.revision.keypointsFile, root),
-        set: spec.revision.skeleton ?? null
+        set: spec.revision.skeleton ?? null,
+        sha256: spec.revision.keypointsSha256 ?? null
       } : null,
       character: describeCharacter(spec, entry),
       outputs,