@docyrus/animaguru 0.20.0 → 0.22.0

package/dist/animaguru.js

@@ -2312,8 +2312,8 @@ var require_lib = __commonJS({
       if (typeof cb !== "function") {
         opts = cb;
         cb = null;
-        deferred = new this.Promise(function(resolve17, reject) {
-          deferredResolve = resolve17;
+        deferred = new this.Promise(function(resolve18, reject) {
+          deferredResolve = resolve18;
           deferredReject = reject;
         });
       }
@@ -2461,17 +2461,17 @@ var require_lib = __commonJS({
       if (typeof cb === "function") {
         fnx(cb);
       } else {
-        return new this.Promise(function(resolve17, reject) {
+        return new this.Promise(function(resolve18, reject) {
           if (fnx.length === 1) {
             fnx(function(err2, ret) {
               if (err2) {
                 reject(err2);
               } else {
-                resolve17(ret);
+                resolve18(ret);
               }
             });
           } else {
-            resolve17(fnx());
+            resolve18(fnx());
           }
         });
       }
@@ -6862,7 +6862,7 @@ var require_pify = __commonJS({
     "use strict";
     var processFn = (fn, options) => function(...args) {
       const P = options.promiseModule;
-      return new P((resolve17, reject) => {
+      return new P((resolve18, reject) => {
         if (options.multiArgs) {
           args.push((...result) => {
             if (options.errorFirst) {
@@ -6870,10 +6870,10 @@ var require_pify = __commonJS({
                 reject(result);
               } else {
                 result.shift();
-                resolve17(result);
+                resolve18(result);
               }
             } else {
-              resolve17(result);
+              resolve18(result);
             }
           });
         } else if (options.errorFirst) {
@@ -6881,11 +6881,11 @@ var require_pify = __commonJS({
             if (error62) {
               reject(error62);
             } else {
-              resolve17(result);
+              resolve18(result);
             }
           });
         } else {
-          args.push(resolve17);
+          args.push(resolve18);
         }
         fn.apply(this, args);
       });
@@ -11400,7 +11400,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           } catch (err22) {
             if (err22 === null || err22.code === "EEXIST") return;
             if (err22.code === "ENOENT" && attempt < retries) {
-              await new Promise((resolve17) => setTimeout(resolve17, 0));
+              await new Promise((resolve18) => setTimeout(resolve18, 0));
               continue;
             }
             throw err22;
@@ -14616,9 +14616,9 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
           throw Error("You cannot write to a FIFO that has already been ended!");
         }
         if (this._waiting) {
-          const resolve17 = this._waiting;
+          const resolve18 = this._waiting;
           this._waiting = null;
-          resolve17({ value: chunk });
+          resolve18({ value: chunk });
         } else {
           this._queue.push(chunk);
         }
@@ -14626,9 +14626,9 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       end() {
         this._ended = true;
         if (this._waiting) {
-          const resolve17 = this._waiting;
+          const resolve18 = this._waiting;
           this._waiting = null;
-          resolve17({ done: true });
+          resolve18({ done: true });
         }
       }
       destroy(err2) {
@@ -14647,8 +14647,8 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
             "You cannot call read until the previous call to read has returned!"
           );
         }
-        return new Promise((resolve17) => {
-          this._waiting = resolve17;
+        return new Promise((resolve18) => {
+          this._waiting = resolve18;
         });
       }
     };
@@ -14803,7 +14803,7 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
       const acks = [];
       let nak = false;
       let done = false;
-      return new Promise((resolve17, reject) => {
+      return new Promise((resolve18, reject) => {
         forAwait2(packetlines, (data) => {
           const line = data.toString("utf8").trim();
           if (line.startsWith("shallow")) {
@@ -14830,11 +14830,11 @@ ${obj.gpgsig ? obj.gpgsig : ""}`;
             nak = true;
           }
           if (done) {
-            stream.error ? reject(stream.error) : resolve17({ shallows, unshallows, acks, nak, packfile, progress });
+            stream.error ? reject(stream.error) : resolve18({ shallows, unshallows, acks, nak, packfile, progress });
           }
         }).finally(() => {
           if (!done) {
-            stream.error ? reject(stream.error) : resolve17({ shallows, unshallows, acks, nak, packfile, progress });
+            stream.error ? reject(stream.error) : resolve18({ shallows, unshallows, acks, nak, packfile, progress });
           }
         });
       });
@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.20.0",
+  version: "0.22.0",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {
@@ -24295,8 +24295,8 @@ var version = defineExtension(VERSION).factory((extension, value, options = {})
 
 // cli/src/commands.ts
 import { spawn as spawn3 } from "node:child_process";
-import { mkdir as mkdir15, readFile as readFile18, writeFile as writeFile16 } from "node:fs/promises";
-import { dirname as dirname14, resolve as resolve16 } from "node:path";
+import { mkdir as mkdir15, readFile as readFile19, writeFile as writeFile16 } from "node:fs/promises";
+import { dirname as dirname14, resolve as resolve17 } from "node:path";
 import { setTimeout as delay6 } from "node:timers/promises";
 
 // node_modules/fflate/esm/index.mjs
@@ -25339,13 +25339,14 @@ var SPRITE_IMAGE_MODEL_IDS = SPRITE_IMAGE_MODELS.map((m) => m.id);
 function spriteImageModel(id2) {
   return SPRITE_IMAGE_MODELS.find((m) => m.id === id2) ?? SPRITE_IMAGE_MODELS[0];
 }
-var VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video", "reference-to-video", "lip-sync", "camera-controls", "insert-video", "recast", "relight", "3d-to-video", "style"];
+var VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video", "reference-to-video", "lip-sync", "camera-controls", "insert-video", "recast", "relight", "3d-to-video", "style", "keyframes-to-video"];
 var STUDIO_VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video"];
 var MEDIA_LENGTH_WORKFLOWS = ["lip-sync", "recast", "relight", "3d-to-video"];
 var lengthFromMedia = (workflow) => MEDIA_LENGTH_WORKFLOWS.includes(workflow);
 var VIDEO_STYLES = ["vhs", "retro-toon-70s", "low-poly", "hand-drawn", "16bit-pixel"];
 var VHS_DAMAGE_LEVELS = ["light", "medium", "heavy"];
-var VIDEO_RESOLUTIONS = ["480p", "768p", "1080p", "2k"];
+var VIDEO_RESOLUTIONS = ["480p", "720p", "768p", "1080p", "2k"];
+var H3_RESOLUTIONS = ["480p", "768p", "1080p", "2k"];
 var VIDEO_ASPECT_RATIOS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"];
 var PROMPT_EXPANSION_MODES = ["disabled", "balanced", "quality"];
 var EXTEND_OUTPUTS = ["extended", "continuation"];
@@ -25359,7 +25360,10 @@ var MAX_RECAST_PEOPLE = 4;
 var MAX_3D_REFERENCES = 8;
 var MAX_CAMERA_KEYFRAMES = 12;
 var MAX_CAMERA_TURNS = 32;
+var MAX_IMAGE_KEYFRAMES = 10;
+var KEYFRAME_FPS = 24;
 var H3_MAX = "minimax/h3-max";
+var FLUX_3_MAX = "blackforestlabs/flux-3-max";
 var h3Endpoints = (route) => ({ "image-to-video": `${route}/image-to-video`, "text-to-video": `${route}/text-to-video`, "extend-video": `${route}/extend-video` });
 var SPRITE_VIDEO_MODELS = [
   {
@@ -25388,7 +25392,8 @@ var SPRITE_VIDEO_MODELS = [
     id: "fal/minimax-h3-max",
     label: "MiniMax H3 Max (fal.ai)",
     provider: "fal",
-    workflows: VIDEO_WORKFLOWS,
+    // Every workflow but FLUX 3 Max's keyframes.
+    workflows: VIDEO_WORKFLOWS.filter((w) => w !== "keyframes-to-video"),
     endpoints: {
       ...h3Endpoints(H3_MAX),
       "reference-to-video": `${H3_MAX}/reference-to-video`,
@@ -25402,11 +25407,11 @@ var SPRITE_VIDEO_MODELS = [
     },
     resolutions: ["480p", "768p", "1080p"],
     workflowOptions: {
-      "extend-video": { resolutions: VIDEO_RESOLUTIONS },
-      "lip-sync": { resolutions: VIDEO_RESOLUTIONS, seconds: { min: 5, max: 900, fractional: true } },
+      "extend-video": { resolutions: H3_RESOLUTIONS },
+      "lip-sync": { resolutions: H3_RESOLUTIONS, seconds: { min: 5, max: 900, fractional: true } },
       "insert-video": { resolutions: ["480p", "768p"], seconds: { min: 5, max: 13, fractional: true }, creditsPerSecond: { "480p": 5, "768p": 6 } },
       recast: { resolutions: ["768p", "1080p"], seconds: { min: 5, max: 30, fractional: true }, creditsPerSecond: { "768p": 30, "1080p": 45 } },
-      relight: { resolutions: VIDEO_RESOLUTIONS, seconds: { min: 2.33, max: 15, fractional: true } },
+      relight: { resolutions: H3_RESOLUTIONS, seconds: { min: 2.33, max: 15, fractional: true } },
       "3d-to-video": { seconds: { min: 1, max: 15, fractional: true } },
       style: { resolutions: ["768p"], seconds: { min: 5, max: 15 } }
     },
@@ -25426,7 +25431,7 @@ var SPRITE_VIDEO_MODELS = [
     workflows: STUDIO_VIDEO_WORKFLOWS,
     endpoints: h3Endpoints("minimax/h3-max-turbo"),
     resolutions: ["480p", "768p", "1080p"],
-    workflowOptions: { "extend-video": { resolutions: VIDEO_RESOLUTIONS } },
+    workflowOptions: { "extend-video": { resolutions: H3_RESOLUTIONS } },
     modes: ["speed"],
     lastFrame: true,
     endFrameOnly: true,
@@ -25435,6 +25440,21 @@ var SPRITE_VIDEO_MODELS = [
     audio: true,
     estimatedCreditsPerSecond: { "480p": { speed: 2.5 }, "768p": { speed: 4 }, "1080p": { speed: 8 }, "2k": { speed: 16 } },
     seconds: { min: 1, max: 15, fractional: true }
+  },
+  {
+    id: "fal/flux-3-max",
+    label: "FLUX 3 Max (fal.ai)",
+    provider: "fal",
+    workflows: ["image-to-video", "text-to-video", "keyframes-to-video"],
+    endpoints: { "image-to-video": `${FLUX_3_MAX}/image-to-video`, "text-to-video": `${FLUX_3_MAX}/text-to-video`, "keyframes-to-video": `${FLUX_3_MAX}/keyframes-to-video` },
+    falInputs: "flux",
+    resolutions: ["720p", "1080p"],
+    modes: ["quality"],
+    lastFrame: true,
+    seed: true,
+    promptExpansion: ["balanced", "quality"],
+    estimatedCreditsPerSecond: { "720p": { quality: 17 }, "1080p": { quality: 29 } },
+    seconds: { min: 5, max: 20 }
   }
 ];
 var SPRITE_VIDEO_MODEL_IDS = SPRITE_VIDEO_MODELS.map((m) => m.id);
@@ -30496,7 +30516,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve17) {
+function isRecursive(inst, stack, resolve18) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -30506,7 +30526,7 @@ function isRecursive(inst, stack, resolve17) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve17);
+      const answer = isRecursive(child, stack, resolve18);
       if (answer > result)
         result = answer;
     }
@@ -30517,7 +30537,7 @@ function isRecursive(inst, stack, resolve17) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve17) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve18) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -30581,7 +30601,7 @@ function isRecursive(inst, stack, resolve17) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve17 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve18 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -45199,6 +45219,12 @@ async function saveWorkspace(origin, workspaceId) {
   credentials[origin] = { ...saved, workspaceId };
   await writeCredentials(credentials);
 }
+async function sessionToken(origin) {
+  const saved = (await readCredentials())[origin];
+  const token3 = process.env.ANIMAGURU_TOKEN ?? (saved && saved.expiresAt > Date.now() ? saved.token : void 0);
+  if (!token3) throw new Error("Sign in with animaguru auth login, or set ANIMAGURU_TOKEN.");
+  return token3;
+}
 var ServiceError = class extends Error {
   constructor(status, code, message) {
     super(message);
@@ -45216,12 +45242,7 @@ var Client = class {
   signal;
   origin;
   async request(path, options = {}) {
-    let token3;
-    if (options.authenticated !== false) {
-      const saved = (await readCredentials())[this.origin];
-      token3 = process.env.ANIMAGURU_TOKEN ?? (saved && saved.expiresAt > Date.now() ? saved.token : void 0);
-      if (!token3) throw new Error("Sign in with animaguru auth login, or set ANIMAGURU_TOKEN.");
-    }
+    const token3 = options.authenticated !== false ? await sessionToken(this.origin) : void 0;
     const generation = options.method === "POST" && /^\/api\/v1\/sprites\/[^/]+\/(jobs|assets|avatars|avatars\/looks|avatars\/[^/]+\/consent)$/.test(path);
     const idempotency = generation ? { "Idempotency-Key": generationRequestId(path, options.body) } : {};
     const response = await fetch(`${this.origin}${path}`, {
@@ -45347,14 +45368,7 @@ var animation_styles_default = {
         "Masked reveals",
         "Speech & beat timing"
       ],
-      previewCaption: "Type takes the lead through scale, alignment and a measured reading rhythm.",
-      studyCopy: [
-        "Make",
-        "every",
-        "word",
-        "move.",
-        "TYPE / RHYTHM / EMPHASIS"
-      ],
+      previewCaption: "Words slam, mask and split into letters on a 120 bpm beat across four color fields, then settle into a lockup. Drawn entirely in code.",
       family: "graphic",
       example: false
     },
@@ -45371,11 +45385,7 @@ var animation_styles_default = {
         "Connected transitions",
         "Designed easing"
       ],
-      previewCaption: "A geometric system assembles, connects and resolves into a clear composition.",
-      studyCopy: [
-        "A shape. An idea.",
-        "One connected system."
-      ],
+      previewCaption: "A bouncing ball splits and morphs into hills and a sun, a skyline rises, and a cyclist rides into dusk before an iris closes. Every shape is drawn and morphed in code.",
       family: "graphic",
       example: false
     },
@@ -45392,13 +45402,7 @@ var animation_styles_default = {
         "Drawn connections",
         "Readable drawing holds"
       ],
-      previewCaption: "Ordered pen strokes build an idea, then hold the completed drawing for reading.",
-      studyCopy: [
-        "Draw the connection.",
-        "Imagine",
-        "Connect",
-        "Create"
-      ],
+      previewCaption: "A generated hand draws an AnimaGuru-generated marker illustration stroke by stroke, colors it in, titles it and wipes the board clean.",
       family: "graphic",
       example: false
     },
@@ -45415,13 +45419,7 @@ var animation_styles_default = {
         "Travelling path markers",
         "Controlled camera movement"
       ],
-      previewCaption: "Platforms rise into place and a travelling marker connects their stations.",
-      studyCopy: [
-        "A world, connected.",
-        "Collect",
-        "Shape",
-        "Share"
-      ],
+      previewCaption: "An isometric town assembles tile by tile: buildings extrude, trees pop, cars and a train start running and the windows light up at dusk. Built from projected geometry in code.",
       family: "technical",
       example: false
     },
@@ -45438,14 +45436,7 @@ var animation_styles_default = {
         "Counted values",
         "Comparison highlights"
       ],
-      previewCaption: "Illustrative data only: three sample values reveal and settle at 24, 48 and 72.",
-      studyCopy: [
-        "Make the comparison clear.",
-        "A",
-        "B",
-        "C",
-        "ILLUSTRATIVE DATA / SAMPLE VALUES"
-      ],
+      previewCaption: "A line chart is drawn, counted and annotated, then becomes ranked bars beside a platform donut. Drawn entirely in code from sample values.",
       family: "technical",
       example: false
     },
@@ -45462,12 +45453,7 @@ var animation_styles_default = {
         "Parameter changes",
         "Semantic transformations"
       ],
-      previewCaption: "A changing radius connects a circle to its area formula and a corresponding plot.",
-      studyCopy: [
-        "See the relationship.",
-        "radius",
-        "area"
-      ],
+      previewCaption: "A unit circle traces a sine wave, then becomes the largest of 90 rotating circles that draw \u03C0. Plotted from a real Fourier series.",
       family: "technical",
       example: false
     },
@@ -45484,19 +45470,7 @@ var animation_styles_default = {
         "Bounded zooms",
         "State transitions"
       ],
-      previewCaption: "A conceptual interface demonstrates focus, a precise click and its resulting state.",
-      studyCopy: [
-        "Focus on what matters.",
-        "CONCEPTUAL INTERFACE",
-        "Workspace",
-        "Overview",
-        "Projects",
-        "Library",
-        "New project",
-        "Project created",
-        "Create your next idea.",
-        "Ready to create"
-      ],
+      previewCaption: "A cursor drives a dashboard: a live toggle, hover lift, drag-to-reorder, a modal with typing and loading, then a toast and a phone notification. Every element and interaction is coded.",
       family: "technical",
       example: false
     },
@@ -45513,10 +45487,7 @@ var animation_styles_default = {
         "Pose-to-pose timing",
         "Gesture & reaction"
       ],
-      previewCaption: "An original illustrated character points, pauses and reacts to a moving idea.",
-      studyCopy: [
-        "An idea comes to life."
-      ],
+      previewCaption: "Pip, a cartoon character drawn and animated in AnimaGuru, walks a generated meadow and hops a log, with a following camera, squash and stretch, and dust on landing.",
       family: "character",
       example: false
     },
@@ -45533,11 +45504,7 @@ var animation_styles_default = {
         "Palette accents",
         "Pixel transitions"
       ],
-      previewCaption: "A small pixel world comes to life with grid-aligned motion and stepped poses.",
-      studyCopy: [
-        "SMALL PIXELS.",
-        "BIG POSSIBILITIES."
-      ],
+      previewCaption: "Bit, a pixel-art sprite animated in AnimaGuru, runs a side-scrolling level built from generated parallax layers, with coins, sparkles and a score drawn in code.",
       family: "character",
       example: false
     },
@@ -45554,10 +45521,7 @@ var animation_styles_default = {
         "Foreground reveals",
         "Selective organic motion"
       ],
-      previewCaption: "An original brush-textured landscape moves through overlapping painted planes.",
-      studyCopy: [
-        "Let the picture breathe."
-      ],
+      previewCaption: "Five AnimaGuru-generated oil-painted planes on a slow dolly, with haze between them, sun rays, drifting pollen and wind in the grass.",
       family: "material",
       example: false
     },
@@ -45574,13 +45538,8 @@ var animation_styles_default = {
         "Matched reveals",
         "Controlled depth"
       ],
-      studyCopy: [
-        "Bring the signal forward.",
-        "Concept stage",
-        "One clear focus"
-      ],
       family: "technical",
-      previewCaption: "Dark presentation stages, crisp components and controlled accent light with precise assembly and focused reveals. Original procedural 2.5D study.",
+      previewCaption: "Glass interface panels assemble around a hero card on a reflective stage under sweeping light. Built in code with depth of field and floor reflections.",
       example: true
     },
     "studio-product-reveal": {
@@ -45596,13 +45555,8 @@ var animation_styles_default = {
         "Detail close-ups",
         "Layered part separation"
       ],
-      studyCopy: [
-        "Form. Material. Detail.",
-        "Illustrative product",
-        "Light reveals the shape"
-      ],
       family: "material",
-      previewCaption: "A product silhouette, material details and layered light revealed through deliberate close-ups in a controlled 2.5D studio. Original procedural 2.5D study.",
+      previewCaption: "An unbranded fragrance bottle generated with AnimaGuru turns under a strip light: a macro start, a pull-back, anamorphic glints and a title lockup.",
       example: true
     },
     "risograph-print": {
@@ -45618,13 +45572,8 @@ var animation_styles_default = {
         "Registration shifts",
         "Held-drawing cadence"
       ],
-      studyCopy: [
-        "Two inks. More possibilities.",
-        "Separate plates",
-        "Meet in the overprint"
-      ],
       family: "print",
-      previewCaption: "Porous paper, limited spot inks and colored overprints with deliberate registration and plate reveals. Original procedural 2.5D study.",
+      previewCaption: "An AnimaGuru-generated illustration separated in code into yellow, fluorescent pink and teal drums, then printed pass by pass with riso grain and slight misregistration.",
       example: true
     },
     "halftone-editorial": {
@@ -45640,13 +45589,8 @@ var animation_styles_default = {
         "Stamp impacts",
         "Layered panel changes"
       ],
-      studyCopy: [
-        "Give the idea a headline.",
-        "An original print study",
-        "Make the point readable"
-      ],
       family: "print",
-      previewCaption: "Bold editorial type, dot shading, graphic cutouts and stamps arranged with a strong information hierarchy. Original procedural 2.5D study.",
+      previewCaption: "An AnimaGuru-generated stage photo screened in code into black and orange halftone dots at 45\xB0 and 15\xB0, pulling back from the dots to a magazine spread.",
       example: true
     },
     "silkscreen-poster": {
@@ -45662,13 +45606,8 @@ var animation_styles_default = {
         "Layer-by-layer builds",
         "Graphic holds"
       ],
-      studyCopy: [
-        "One ink. One impression.",
-        "Print the composition",
-        "Hold the finished image"
-      ],
       family: "print",
-      previewCaption: "Opaque ink layers, bold silhouette and stepped color bands revealed through successive printing pulls. Original procedural 2.5D study.",
+      previewCaption: "AnimaGuru-generated poster art cut into five flat stencils in code and pulled screen by screen with a squeegee, ending on the finished print.",
       example: true
     },
     "art-deco-motion": {
@@ -45684,13 +45623,8 @@ var animation_styles_default = {
         "Sequenced lights",
         "Mechanical settling"
       ],
-      studyCopy: [
-        "Geometry catches the light.",
-        "Open from the center",
-        "A measured reveal"
-      ],
       family: "graphic",
-      previewCaption: "Geometric ornament, metallic keylines and lacquer-like planes opening through symmetry and mechanical motion. Original procedural 2.5D study.",
+      previewCaption: "Gold keylines, stepped arches and a sunburst fan open symmetrically; chevrons and marquee lights run in sequence while a specular sweep crosses the metal. Drawn entirely in code.",
       example: true
     },
     "blueprint-drafting": {
@@ -45706,13 +45640,8 @@ var animation_styles_default = {
         "Exploded parts",
         "Anchored dimensions"
       ],
-      studyCopy: [
-        "See how the parts connect.",
-        "Illustrative drawing",
-        "Assemble the relationship"
-      ],
       family: "technical",
-      previewCaption: "Measured line work, construction marks, sections and dimensions on a drafting surface with progressive assembly. Original procedural 2.5D study.",
+      previewCaption: "A drafting point traces an AnimaGuru-generated cyanotype line by line, then dimensions, callouts and a title block are drawn in.",
       example: true
     },
     "holographic-scan": {
@@ -45728,13 +45657,8 @@ var animation_styles_default = {
         "Target locking",
         "Local part separation"
       ],
-      studyCopy: [
-        "Scan. Focus. Understand.",
-        "Illustrative part model",
-        "Follow the detail"
-      ],
       family: "technical",
-      previewCaption: "Luminous projected geometry, traveling scans and accurate part callouts with restrained depth and local explosions. Original procedural 2.5D study.",
+      previewCaption: "A wireframe turbofan grows under a moving scan, locks onto its parts and separates them with callouts. Projected 3D geometry drawn in code.",
       example: true
     },
     "paper-popup": {
@@ -45750,13 +45674,8 @@ var animation_styles_default = {
         "Back-to-front arrival",
         "Paper-stage transitions"
       ],
-      studyCopy: [
-        "A flat page gains a world.",
-        "An original paper mechanism",
-        "Fold. Open. Discover."
-      ],
       family: "paper",
-      previewCaption: "Hinged cardstock pieces, visible fronts and backs, fold mechanisms and layered paper stages in constrained perspective. Original procedural 2.5D study.",
+      previewCaption: "A book opens and AnimaGuru-generated cardstock layers hinge up from the fold with shadows and spring, while a pull tab lifts the balloon and sun.",
       example: true
     },
     "shadow-theatre": {
@@ -45772,13 +45691,8 @@ var animation_styles_default = {
         "Jointed articulation",
         "Lamp-distance changes"
       ],
-      studyCopy: [
-        "A silhouette tells a thousand things.",
-        "Light and carved shape",
-        "Move with the material"
-      ],
       family: "paper",
-      previewCaption: "Articulated silhouettes or translucent carved puppets on a lit screen, with distance-driven softness and scale. Original procedural 2.5D study.",
+      previewCaption: "Shadow puppets generated with AnimaGuru perform behind a lit linen screen, finished in code with the cloth's weave, a breathing lamp and a warm glow.",
       example: true
     },
     "engraved-relief-print": {
@@ -45794,13 +45708,8 @@ var animation_styles_default = {
         "Progressive hatching",
         "Successive impressions"
       ],
-      studyCopy: [
-        "Every mark has a direction.",
-        "Carve the form",
-        "Pull the impression"
-      ],
       family: "print",
-      previewCaption: "Form-following hatch marks and carved impressions revealed through stable mark schedules and layered print treatments. Original procedural 2.5D study.",
+      previewCaption: "A generated woodblock print pulled in order: hatching carved first, then two color impressions rolled into register.",
       example: true
     },
     "ascii-crt": {
@@ -45816,13 +45725,8 @@ var animation_styles_default = {
         "Grid-scale reveals",
         "Analytic afterglow"
       ],
-      studyCopy: [
-        "A picture made of characters.",
-        "Signal on the grid",
-        "Pixels become language"
-      ],
       family: "cinematic",
-      previewCaption: "Real glyph-grid imagery, terminal text and restrained phosphor glow with deliberate typing and screen behavior. Original procedural 2.5D study.",
+      previewCaption: "An AnimaGuru-generated jellyfish clip rendered as real ASCII on a 128-column green-phosphor terminal, with curvature, glow trails and a typed command.",
       example: true
     },
     "analog-film-tape": {
@@ -45838,13 +45742,8 @@ var animation_styles_default = {
         "Deterministic weave",
         "Tape-inspired transitions"
       ],
-      studyCopy: [
-        "A different kind of time.",
-        "Original scene / film variant",
-        "Texture follows the medium"
-      ],
       family: "cinematic",
-      previewCaption: "Projected-film cadence or camcorder texture over original scenes, with controlled weave, exposure and medium-specific transitions. Original procedural 2.5D study.",
+      previewCaption: "Two generated summer scenes projected at 18 fps, with gate weave, grain, a slipped splice and a film burn.",
       example: true
     },
     "glass-mosaic": {
@@ -45860,13 +45759,8 @@ var animation_styles_default = {
         "Moving light bands",
         "Identity-preserving rearrangement"
       ],
-      studyCopy: [
-        "Pieces become a picture.",
-        "Original glass-like mosaic",
-        "Light passes through"
-      ],
       family: "material",
-      previewCaption: "Colored panes or loose glass-like tiles, strong seams and moving transmitted-light treatments in 2.5D. Original procedural 2.5D study.",
+      previewCaption: "An AnimaGuru-generated peacock cut in code into leaded glass pieces that slot in one by one, then lit by a low sun crossing the window.",
       example: true
     },
     "portal-zoom": {
@@ -45882,13 +45776,8 @@ var animation_styles_default = {
         "Layered parallax",
         "Occluded scene handoffs"
       ],
-      studyCopy: [
-        "Every frame opens another.",
-        "An original nested world",
-        "Keep the journey continuous"
-      ],
       family: "cinematic",
-      previewCaption: "Nested compositions, matched apertures and continuous scale changes through layered scenes with planned parallax. Original procedural 2.5D study.",
+      previewCaption: "A continuous zoom through four AnimaGuru-generated worlds, each framed inside the last, that ends exactly where it began.",
       example: true
     },
     "photo-footage-editorial": {
@@ -45904,13 +45793,8 @@ var animation_styles_default = {
         "Media-wall selection",
         "Focused detail reveals"
       ],
-      studyCopy: [
-        "Give every image its place.",
-        "Original illustrated media cards",
-        "Frame the detail"
-      ],
       family: "cinematic",
-      previewCaption: "Purposeful media frames, filmstrips and contact-sheet layouts with selective focus and continuous framing relationships. Original procedural 2.5D study.",
+      previewCaption: "Six generated photographs on a contact sheet. The circled frame becomes footage, then returns to its strip.",
       example: true
     },
     "stop-motion-objects": {
@@ -45926,13 +45810,8 @@ var animation_styles_default = {
         "Physical-looking assembly",
         "Held-drawing timing"
       ],
-      studyCopy: [
-        "Build it one piece at a time.",
-        "Illustrative tactile objects",
-        "Deliberate held poses"
-      ],
       family: "material",
-      previewCaption: "Tactile tabletop objects and deliberate held poses assembled with attached contact shadows in a 2.5D treatment. Original procedural 2.5D study.",
+      previewCaption: "Clay footage generated with AnimaGuru, held on twos at 12 fps, with a nudge of the set and a flicker of the lamp between poses.",
       example: true
     },
     "miniature-diorama": {
@@ -45948,13 +45827,8 @@ var animation_styles_default = {
         "Elevated camera travel",
         "Optional time-lapse activity"
       ],
-      studyCopy: [
-        "A small world, carefully built.",
-        "An original 2.5D miniature",
-        "Let scale guide the view"
-      ],
       family: "material",
-      previewCaption: "Small constructed worlds seen from an elevated angle, with coherent scale, layered focus and controlled miniature activity. Original procedural 2.5D study.",
+      previewCaption: "A generated harbor model with a slow elevated drift, a focus band on the quay and small time-lapsed activity.",
       example: true
     },
     "sand-drawing": {
@@ -45970,13 +45844,8 @@ var animation_styles_default = {
         "Authored reshape paths",
         "Material holds"
       ],
-      studyCopy: [
-        "A shape emerges from grains.",
-        "Original procedural sand study",
-        "Reveal the silhouette"
-      ],
       family: "material",
-      previewCaption: "Granular surface marks and swept negative space revealing coherent silhouettes through an original seeded 2D density recipe. Original procedural 2.5D study.",
+      previewCaption: "A whale is swept into a seabird on a lit sand table, in one take. Footage generated with AnimaGuru.",
       example: true
     },
     "generative-light-signal": {
@@ -45992,20 +45861,14 @@ var animation_styles_default = {
         "Measured cue response",
         "Controlled pattern changes"
       ],
-      studyCopy: [
-        "Turn a signal into movement.",
-        "Original analytic field",
-        "Follow the rhythm"
-      ],
       family: "graphic",
-      previewCaption: "Luminous traces, geometric fields and seeded paths choreographed by time or precomputed audio cues. Original procedural 2.5D study.",
+      previewCaption: "Seeded light particles stream along braided ribbons, flaring as timed pulses pass. A seamless loop rendered in code.",
       example: true
     }
   },
   browseStyles: "Browse animation styles",
   styleCount_one: "{{count}} visual style, guided by your brief",
   styleCount_other: "{{count}} visual styles, guided by your brief",
-  previewBrand: "ANIMAGURU / MOTION STUDIES",
   families: {
     all: "All styles",
     graphic: "Graphic & type",
@@ -46452,6 +46315,7 @@ var cameraKeyframe = external_exports.object({
   /** Distance from the subject in scene units. */
   distance: external_exports.number().gt(0).max(100)
 });
+var imageKeyframe = external_exports.object({ image: blob, seconds: external_exports.number().min(0).max(20) });
 var videoAsset = external_exports.object({
   name: base.name,
   /** Lip-sync and relight take no prompt, and camera-controls, insert-video, recast and 3d-to-video may leave it out. */
@@ -46478,6 +46342,8 @@ var videoAsset = external_exports.object({
   referenceVideos: external_exports.array(blob).max(MAX_REFERENCE_VIDEOS).optional(),
   /** The camera's path around the reference image: 2–12 keyframes. */
   camera: external_exports.array(cameraKeyframe).min(2).max(MAX_CAMERA_KEYFRAMES).optional(),
+  /** Keyframes-to-video: 1–10 images pinned to moments of the clip, each on a frame of its own. */
+  keyframes: external_exports.array(imageKeyframe).min(1).max(MAX_IMAGE_KEYFRAMES).optional(),
   /** Seconds into the source where the inserted scene starts, and where the source resumes after it. */
   insertAt: external_exports.number().min(1.625).max(60).optional(),
   resumeAt: external_exports.number().gt(1.625).max(60).optional(),
@@ -46521,6 +46387,7 @@ var TAKES = {
   references: ["reference-to-video", "insert-video", "recast", "3d-to-video"],
   referenceVideos: ["reference-to-video", "insert-video"],
   camera: ["camera-controls"],
+  keyframes: ["keyframes-to-video"],
   insertAt: ["insert-video"],
   resumeAt: ["insert-video"],
   colorMatch: ["insert-video"],
@@ -46531,8 +46398,8 @@ var TAKES = {
   generatedReferences: ["3d-to-video"],
   style: ["style"],
   damage: ["style"],
-  aspectRatio: ["text-to-video", "extend-video", "reference-to-video", "relight", "style"],
-  promptExpansion: ["image-to-video", "text-to-video", "extend-video", "reference-to-video", "camera-controls", "insert-video"],
+  aspectRatio: ["text-to-video", "extend-video", "reference-to-video", "relight", "style", "keyframes-to-video"],
+  promptExpansion: ["image-to-video", "text-to-video", "extend-video", "reference-to-video", "camera-controls", "insert-video", "keyframes-to-video"],
   seed: ALL.filter((w) => w !== "3d-to-video"),
   extendOutput: ["extend-video"]
 };
@@ -46543,7 +46410,8 @@ var NEEDS = {
   recast: ["source", "references", "subjectConsent"],
   relight: ["source", "lighting"],
   "3d-to-video": ["source"],
-  style: ["style"]
+  style: ["style"],
+  "keyframes-to-video": ["keyframes"]
 };
 var LABELS = {
   reference: "a starting image",
@@ -46556,6 +46424,7 @@ var LABELS = {
   references: "reference images",
   referenceVideos: "reference videos",
   camera: "camera keyframes",
+  keyframes: "keyframe images",
   insertAt: "insertAt",
   resumeAt: "resumeAt",
   colorMatch: "colorMatch",
@@ -46641,6 +46510,11 @@ function videoChecks(p, ctx) {
     const travel = p.camera.slice(1).reduce((sum, k, i2) => sum + Math.abs(k.azimuth - p.camera[i2].azimuth), 0);
     if (travel > 360 * MAX_CAMERA_TURNS) issue2("camera", `The camera may travel at most ${MAX_CAMERA_TURNS} full turns around the subject.`);
   }
+  if (p.keyframes) {
+    const frames = p.keyframes.map((k) => Math.round(k.seconds * KEYFRAME_FPS));
+    if (new Set(frames).size !== frames.length) issue2("keyframes", `Put each keyframe on a frame of its own; the video has ${KEYFRAME_FPS} frames a second.`);
+    if (p.keyframes.some((k) => k.seconds > seconds2)) issue2("keyframes", "Put each keyframe within the video's length.");
+  }
 }
 var defaultSeconds = (model, workflow) => {
   const r = videoSeconds(model, workflow);
@@ -47112,7 +46986,7 @@ var CLOUD_PART_BYTES = 8 * 1024 * 1024;
 var CLOUD_MANIFEST_PATH = ".animaguru-cloud.json";
 var CLOUD_MANIFEST_MAX_BYTES = 16 * 1024 * 1024;
 var CLOUD_MAX_FILES = 5e4;
-var CLOUD_STORAGE_BYTES = { pro: 20 * 1024 ** 3, team: 100 * 1024 ** 3 };
+var CLOUD_STORAGE_BYTES = { starter: 5 * 1024 ** 3, pro: 20 * 1024 ** 3, team: 100 * 1024 ** 3 };
 var cloudProjectId = external_exports.string().regex(/^prj_[A-Za-z0-9]{8,40}$/, "Use a project ID such as prj_\u2026.");
 var sha256Hex = external_exports.string().regex(/^[a-f0-9]{64}$/, "Use a lowercase SHA-256 hex digest.");
 var gitObjectId = external_exports.string().regex(/^[a-f0-9]{40}$/, "Use a full 40-character version ID.");
@@ -47917,6 +47791,7 @@ var extras = {
     "middle-reference",
     "middle-seconds",
     "camera",
+    "keyframes",
     "insert-at",
     "resume-at",
     "color-match",
@@ -47951,11 +47826,16 @@ var regions = (value) => value?.split(";").filter((region) => region.trim()).map
   if (rest.length || [x2, y, width, height].some((n) => !Number.isFinite(n))) throw new Error(`--mask regions are x,y,width,height in fractions of Image 1, separated by semicolons; "${region.trim()}" is not.`);
   return { x: x2, y, width, height };
 });
-var keyframes = (value) => value?.split(";").filter((frame) => frame.trim()).map((frame) => {
+var cameraKeyframes = (value) => value?.split(";").filter((frame) => frame.trim()).map((frame) => {
   const [time3, azimuth, elevation, distance, ...rest] = frame.split(",").map((n) => n.trim() ? Number(n) : NaN);
   if (rest.length || [time3, azimuth, elevation, distance].some((n) => !Number.isFinite(n))) throw new Error(`--camera keyframes are time,azimuth,elevation,distance (time 0\u20131, angles in degrees), separated by semicolons; "${frame.trim()}" is not.`);
   return { time: time3, azimuth, elevation, distance };
 });
+var imageKeyframes = (value) => value?.split(";").filter((frame) => frame.trim()).map((frame) => {
+  const [seconds2, image, ...rest] = frame.split(",").map((part) => part.trim());
+  if (rest.length || !image || !seconds2 || !Number.isFinite(Number(seconds2))) throw new Error(`--keyframes are seconds,image SHA pairs separated by semicolons, e.g. "0,SHA;5,SHA"; "${frame.trim()}" is not.`);
+  return { image, seconds: Number(seconds2) };
+});
 function assetFromFlags(flags) {
   if (flags.type === "image" && flags.model) throw new Error("Image models are managed by staff. Omit --model.");
   for (const name2 of Object.values(extras).flat()) {
@@ -47978,7 +47858,8 @@ function assetFromFlags(flags) {
       referenceVideos: shas(flags["reference-videos"]),
       middleReference: flags["middle-reference"],
       middleSeconds: flags["middle-seconds"],
-      camera: keyframes(flags.camera),
+      camera: cameraKeyframes(flags.camera),
+      keyframes: imageKeyframes(flags.keyframes),
       insertAt: flags["insert-at"],
       resumeAt: flags["resume-at"],
       colorMatch: flags["color-match"],
@@ -48688,8 +48569,8 @@ async function youtubeLogin(options) {
     let receive;
     let fail;
     let used = false;
-    const callback = new Promise((resolve17, reject) => {
-      receive = resolve17;
+    const callback = new Promise((resolve18, reject) => {
+      receive = resolve18;
       fail = reject;
     });
     void callback.catch(() => {
@@ -48727,9 +48608,9 @@ async function youtubeLogin(options) {
       response.end("Authorization received. Return to your AnimaGuru terminal.");
       receive(code);
     });
-    await new Promise((resolve17, reject) => {
+    await new Promise((resolve18, reject) => {
       server.once("error", reject);
-      server.listen(0, "127.0.0.1", resolve17);
+      server.listen(0, "127.0.0.1", resolve18);
     });
     const address = server.address();
     if (!address || typeof address === "string") throw new Error("Cannot open the local YouTube authorization listener.");
@@ -48764,7 +48645,7 @@ async function youtubeLogin(options) {
       clearTimeout(timer);
       options.signal?.removeEventListener("abort", abort);
       server.closeAllConnections();
-      await new Promise((resolve17) => server.close(() => resolve17()));
+      await new Promise((resolve18) => server.close(() => resolve18()));
     }
   });
 }
@@ -49868,6 +49749,114 @@ async function referenceGet(client, id2, options) {
   return report(options.wait ? await finished(client, analysis, options.log) : analysis, options);
 }
 
+// cli/src/curl.ts
+import { createWriteStream as createWriteStream2, openAsBlob as openAsBlob2 } from "node:fs";
+import { readFile as readFile18, unlink as unlink3 } from "node:fs/promises";
+import { extname as extname4, resolve as resolve16 } from "node:path";
+import { Readable as Readable2 } from "node:stream";
+import { pipeline as pipeline2 } from "node:stream/promises";
+function curlUrl(server, target2) {
+  const origin = serverUrl(server);
+  const url3 = target2.startsWith("/") && !target2.startsWith("//") ? new URL(target2, origin) : URL.canParse(target2) ? new URL(target2) : null;
+  if (!url3 || url3.origin !== origin || url3.username || url3.password) throw new Error(`animaguru curl calls only ${origin}. Pass a path such as /api/v1/me.`);
+  return url3;
+}
+function curlHeaders(lines = []) {
+  const headers = new Headers();
+  for (const line of lines) {
+    const colon = line.indexOf(":");
+    const name2 = colon > 0 ? line.slice(0, colon).trim() : "";
+    if (!name2) throw new Error(`Write headers as "Name: value", not "${line}".`);
+    if (/^(authorization|host)$/i.test(name2)) throw new Error(`Leave out the ${name2} header; animaguru curl sends the signed-in session's.`);
+    headers.append(name2, line.slice(colon + 1).trim());
+  }
+  return headers;
+}
+var UPLOAD_TYPES = {
+  ".mp4": "video/mp4",
+  ".webm": "video/webm",
+  ".mov": "video/quicktime",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".webp": "image/webp",
+  ".gif": "image/gif",
+  ".json": "application/json",
+  ".txt": "text/plain"
+};
+var isText = (type) => /^(text\/|application\/([\w.+-]*\+)?(json|xml)\b|application\/(javascript|x-www-form-urlencoded)\b)/i.test(type);
+var readStdin = async () => {
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(Buffer.from(chunk));
+  return Buffer.concat(chunks);
+};
+async function bodyValue(value, io) {
+  if (value === "@-") return (io.stdin ?? readStdin)();
+  return value.startsWith("@") ? readFile18(resolve16(value.slice(1))) : value;
+}
+var parsesAsJson = (body) => {
+  try {
+    JSON.parse(body.toString());
+    return true;
+  } catch {
+    return false;
+  }
+};
+async function curl(options, io) {
+  const url3 = curlUrl(options.server, options.target);
+  const headers = curlHeaders(options.header);
+  if ([options.data, options.json, options.uploadFile].filter((value) => value !== void 0).length > 1) throw new Error("Use one of --data, --json and --upload-file.");
+  let body;
+  if (options.uploadFile !== void 0) {
+    const file2 = resolve16(options.uploadFile);
+    body = await openAsBlob2(file2);
+    if (!headers.has("content-type")) headers.set("Content-Type", UPLOAD_TYPES[extname4(file2).toLowerCase()] ?? "application/octet-stream");
+  } else if (options.json !== void 0) {
+    body = await bodyValue(options.json, io);
+    if (!headers.has("content-type")) headers.set("Content-Type", "application/json");
+    if (!headers.has("accept")) headers.set("Accept", "application/json");
+  } else if (options.data !== void 0) {
+    body = await bodyValue(options.data, io);
+    if (!headers.has("content-type")) headers.set("Content-Type", parsesAsJson(body) ? "application/json" : "application/x-www-form-urlencoded");
+  }
+  headers.set("Authorization", `Bearer ${await sessionToken(url3.origin)}`);
+  if (!headers.has("origin")) headers.set("Origin", url3.origin);
+  const method = (options.request ?? (options.uploadFile !== void 0 ? "PUT" : body !== void 0 ? "POST" : "GET")).toUpperCase();
+  const timeout = AbortSignal.timeout(options.maxTime * 1e3);
+  const response = await fetch(url3, { method, headers, body, redirect: "manual", signal: io.signal ? AbortSignal.any([io.signal, timeout]) : timeout });
+  if (options.include) io.stdout([`HTTP ${response.status} ${response.statusText}`.trim(), ...[...response.headers].map(([name2, value]) => `${name2}: ${value}`), ""].join("\n"));
+  const type = response.headers.get("content-type") ?? "";
+  const failed = options.fail && response.status >= 400;
+  if (options.output !== void 0 && !failed) {
+    const file2 = resolve16(options.output);
+    let bytes = 0;
+    try {
+      await pipeline2(
+        response.body ? Readable2.fromWeb(response.body) : Readable2.from([]),
+        async function* (chunks) {
+          for await (const chunk of chunks) {
+            bytes += chunk.length;
+            yield chunk;
+          }
+        },
+        createWriteStream2(file2, { flags: "wx" })
+      );
+    } catch (error62) {
+      if (error62.code === "EEXIST") throw new Error(`${options.output} already exists; choose another --output.`);
+      await unlink3(file2).catch(() => void 0);
+      throw error62;
+    }
+    io.stdout(JSON.stringify({ status: response.status, contentType: type || null, bytes, file: file2 }));
+  } else if (!response.body || isText(type) || failed) {
+    const text2 = await response.text();
+    if (text2) io.stdout(text2.replace(/\n$/, ""));
+  } else {
+    await response.body.cancel();
+    throw new Error(`The response is ${type || "binary"} (HTTP ${response.status}). Save it with -o FILE.`);
+  }
+  if (failed) throw new Error(`HTTP ${response.status}${response.statusText ? ` ${response.statusText}` : ""} from ${method} ${url3.pathname}.`);
+}
+
 // cli/src/commands.ts
 var assetModelIds = [...SPRITE_VIDEO_MODEL_IDS, ...MUSIC_MODELS.map((m) => m.id), ...SPEECH_MODELS.map((m) => m.id), ...SFX_MODELS.map((m) => m.id)];
 var assetAuthorizationFlags = [
@@ -49918,12 +49907,12 @@ var workspaceQuery = async (client) => {
 async function openBrowser(url3) {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "rundll32" : "xdg-open";
   const args = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url3] : [url3];
-  await new Promise((resolve17) => {
+  await new Promise((resolve18) => {
     const child = spawn3(command, args, { stdio: "ignore", detached: true });
-    child.once("error", () => resolve17());
+    child.once("error", () => resolve18());
     child.once("spawn", () => {
       child.unref();
-      resolve17();
+      resolve18();
     });
   });
 }
@@ -50024,7 +50013,7 @@ function createCli() {
   ).action(async ({ args, flags, stdout, signal }) => out(stdout, await changeVideoSubtitles(new Client(flags.url, signal), args.id, flags))))).add(defineCommand("delete", { description: "Remove a video and its hosted files" }, (command) => command.args({ name: "id", type: "string", required: true }).flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }, { name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
     if (!flags.yes) throw new Error("Pass --yes to delete the video.");
     out(stdout, await new Client(flags.url, signal).request(`/api/v1/videos/${encodeURIComponent(args.id)}`, { method: "DELETE" }));
-  })))).command("cloud", (cloud) => cloud.add(defineCommand("list", { description: "List projects with synced animations in the selected workspace, with plan and storage (Individual Pro and Team)" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).action(async ({ flags, stdout, signal }) => {
+  })))).command("cloud", (cloud) => cloud.add(defineCommand("list", { description: "List projects with synced animations in the selected workspace, with plan and storage (Individual Starter, Individual Pro and Team)" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).action(async ({ flags, stdout, signal }) => {
     const client = new Client(flags.url, signal);
     out(stdout, await client.request(`/api/v1/cloud${await workspaceQuery(client)}`));
   }))).add(defineCommand("link", { description: "Sync this video workspace with a project's animations: --project for an existing project, or a new project in the selected workspace" }, (command) => command.flags(
@@ -50042,7 +50031,31 @@ function createCli() {
   }))).add(defineCommand("restore", { description: "Make the folder, or --path parts of it, match an earlier version; push afterwards to save it as the newest" }, (command) => command.args({ name: "version", type: "string", required: true, description: "Version ID or its first characters" }).flags({ name: "dir", type: "string", default: "." }, { name: "path", type: "string", multiple: true, description: "File or folder to restore; repeatable" }, { name: "yes", type: "boolean", description: "Replace unsaved local changes (copies are kept)" }).action(async ({ args, flags, stdout, stderr, signal }) => out(stdout, await restoreCloud({ dir: flags.dir, version: args.version, paths: flags.path, yes: flags.yes, log: stderr, signal }))))).add(defineCommand("clone", { description: "Download the newest version of a project's animations into a new folder" }, (command) => command.args({ name: "id", type: "string", required: true, description: "Project ID" }, { name: "directory", type: "string", description: "New folder; defaults to the project name" }).flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).action(async ({ args, flags, stdout, stderr, signal }) => out(stdout, await cloneCloud(new Client(flags.url, signal), { id: args.id, dir: args.directory, log: stderr, signal }))))).add(defineCommand("unlink", { description: "Stop syncing this folder; the project's animations and versions stay" }, (command) => command.flags({ name: "dir", type: "string", default: "." }).action(async ({ flags, stdout }) => out(stdout, await unlinkCloud({ dir: flags.dir }))))).add(defineCommand("delete", { description: "Delete a project's animations with all their versions, drafts and stored files; the project and its assets stay. Requires --yes" }, (command) => command.args({ name: "id", type: "string", required: true, description: "Project ID" }).flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }, { name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
     if (!flags.yes) throw new Error("Pass --yes to delete the project's animations and every saved version.");
     out(stdout, await new Client(flags.url, signal).request(`/api/v1/cloud/${encodeURIComponent(args.id)}`, { method: "DELETE" }));
-  })))).command("auth", (auth) => auth.add(defineCommand("login", { description: "Approve a browser sign-in and save a seven-day CLI session" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).flags({ name: "browser", type: "boolean", default: true, description: "Open the browser; --no-browser prints the URL only" }).action(async ({ flags, stdout, stderr, signal }) => {
+  })))).add(defineCommand("curl", { description: "Call an AnimaGuru API path as the signed-in user with curl's flags; the server and the session's token are added for you. Prints the response body, or saves it with -o" }, (command) => command.args({ name: "path", type: "string", required: true, description: "API path such as /api/v1/me (with any query string), or a full URL on the server" }).flags(
+    { name: "request", short: "X", type: "string", description: "HTTP method; GET by default, POST with --data or --json, PUT with --upload-file" },
+    { name: "header", short: "H", type: "string", multiple: true, description: '"Name: value" request header; repeatable. Authorization is added for you' },
+    { name: "data", short: "d", type: "string", aliases: ["data-binary"], description: "Request body: text, @FILE or @- for standard input. JSON is sent as application/json" },
+    { name: "json", type: "string", description: "JSON body (text, @FILE or @-) with JSON Content-Type and Accept headers" },
+    { name: "upload-file", short: "T", type: "string", description: "Stream a file as the body (PUT unless -X); Content-Type follows its extension unless -H sets one" },
+    { name: "output", short: "o", type: "string", description: "Save the response body to a new file and print a JSON summary; needed for video and images" },
+    { name: "include", short: "i", type: "boolean", noNegate: true, description: "Print the status line and response headers first" },
+    { name: "fail", short: "f", type: "boolean", default: true, description: "Exit non-zero on HTTP 4xx and 5xx after printing the body; --no-fail exits 0 like plain curl" },
+    { name: "silent", short: "s", type: "boolean", noNegate: true, description: "Accepted for curl compatibility; nothing else is printed anyway" },
+    { name: "max-time", short: "m", type: "number", default: 600, description: "Maximum seconds for the whole request" },
+    { name: "server", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }
+  ).action(async ({ args, flags, stdout, signal }) => curl({
+    server: flags.server,
+    target: args.path,
+    request: flags.request,
+    header: flags.header,
+    data: flags.data,
+    json: flags.json,
+    uploadFile: flags["upload-file"],
+    output: flags.output,
+    include: flags.include,
+    fail: flags.fail,
+    maxTime: flags["max-time"]
+  }, { stdout, signal })))).command("auth", (auth) => auth.add(defineCommand("login", { description: "Approve a browser sign-in and save a seven-day CLI session" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).flags({ name: "browser", type: "boolean", default: true, description: "Open the browser; --no-browser prints the URL only" }).action(async ({ flags, stdout, stderr, signal }) => {
     const client = new Client(flags.url, signal);
     const device = await client.request("/api/auth/device/code", { method: "POST", authenticated: false, body: { client_id: CLI_CLIENT_ID } });
     stderr(`Open ${device.verification_uri_complete}
@@ -50164,11 +50177,11 @@ Confirm code: ${device.user_code}`);
     { name: "name", type: "string", required: true },
     { name: "prompt", type: "string", description: "Description to generate, or verbatim transcript for speech; video lip-sync and relight take none, and camera-controls, insert-video, recast and 3d-to-video may leave it out" },
     { name: "model", type: "string", choices: assetModelIds, description: "Model for the chosen asset type" },
-    { name: "aspect-ratio", type: "string", choices: [.../* @__PURE__ */ new Set([...IMAGE_ASPECT_RATIOS, "auto", ...VIDEO_ASPECT_RATIOS])], description: "Image: 1:1 (default), 3:2, 2:3, 16:9 or 9:16; a masked edit keeps Image 1's shape. Video from text or a style without --reference: 21:9\u20139:16 (default 16:9). Extension, reference-to-video and relight: auto (default, the inputs' shape) or a ratio to crop to" },
+    { name: "aspect-ratio", type: "string", choices: [.../* @__PURE__ */ new Set([...IMAGE_ASPECT_RATIOS, "auto", ...VIDEO_ASPECT_RATIOS])], description: "Image: 1:1 (default), 3:2, 2:3, 16:9 or 9:16; a masked edit keeps Image 1's shape. Video from text or a style without --reference: 21:9\u20139:16 (default 16:9). Extension, reference-to-video, relight and keyframes-to-video: auto (default, the inputs' shape) or a ratio to crop to" },
     { name: "transparent", type: "boolean", description: "Image: transparent background" },
     { name: "references", type: "string", description: "Comma-separated blob SHAs of this project's images or sprite art, named Image 1, Image 2\u2026 in the prompt. Image: up to 4 to follow, such as a character sheet. Video: subjects or looks to keep (reference-to-video and insert-video up to 9, 3d-to-video up to 8), or recast's new people, one photo each (up to 4)" },
     { name: "mask", type: "string", description: "Image: edit only these rectangles of Image 1 (the first --references image), as x,y,width,height fractions of its size from the top left, up to 8 separated by semicolons; the rest is kept" },
-    { name: "workflow", type: "string", choices: VIDEO_WORKFLOWS, description: "Video: image-to-video (default), text-to-video or extend-video; H3 Max also reference-to-video, lip-sync, camera-controls, insert-video, recast, relight, 3d-to-video and style, as the model's videoProfiles allow" },
+    { name: "workflow", type: "string", choices: VIDEO_WORKFLOWS, description: "Video: image-to-video (default), text-to-video or extend-video; H3 Max also reference-to-video, lip-sync, camera-controls, insert-video, recast, relight, 3d-to-video and style, FLUX 3 Max keyframes-to-video, as the model's videoProfiles allow" },
     { name: "reference", type: "string", description: "Video: starting image blob SHA from this project's assets or sprites; the speaking face for lip-sync, the image the camera moves around for camera-controls" },
     { name: "end-reference", type: "string", description: "Video: ending image blob SHA; models with endFrameOnly accept it without --reference" },
     { name: "middle-reference", type: "string", description: "Reference-to-video: image blob SHA reached at --middle-seconds; needs --reference and --end-reference, 480p or 768p" },
@@ -50178,6 +50191,7 @@ Confirm code: ${device.user_code}`);
     { name: "audio-references", type: "string", description: "Extension or reference-to-video: up to 3 comma-separated audio asset blob SHAs (2\u201315 s each, 15 s total) guiding the sound; refer to them as Audio 1, Audio 2\u2026 in the prompt" },
     { name: "reference-videos", type: "string", description: "Reference-to-video or insert-video: up to 3 comma-separated video asset blob SHAs (2\u201315 s each, 15 s total) guiding motion, named Video 1, Video 2\u2026 in the prompt" },
     { name: "camera", type: "string", description: 'Camera-controls: 2\u201312 keyframes time,azimuth,elevation,distance (time 0\u20131, angles in degrees, elevation \u221290\u201390) separated by semicolons, e.g. "0,0,0,1;1,90,15,1.2"' },
+    { name: "keyframes", type: "string", description: 'Keyframes-to-video (FLUX 3 Max): 1\u201310 seconds,image-SHA pairs separated by semicolons, e.g. "0,SHA;2.5,SHA;5,SHA"; each image is reached at its second, on a frame of its own of the 24 fps clip, within --seconds' },
     { name: "insert-at", type: "number", description: "Insert-video: seconds into --source where the new scene starts (1.625\u201360)" },
     { name: "resume-at", type: "number", description: "Insert-video: seconds into --source where it resumes after the scene" },
     { name: "color-match", type: "boolean", description: "Insert-video: match the scene's colors to the source (default on; --no-color-match turns it off)" },
@@ -50188,10 +50202,10 @@ Confirm code: ${device.user_code}`);
     { name: "generated-references", type: "number", description: "3d-to-video without --references: how many reference images it may draw, 1\u20138 (default 2)" },
     { name: "style", type: "string", choices: VIDEO_STYLES, description: "Style workflow: the preset look, at 768p for 5\u201315 whole seconds" },
     { name: "damage", type: "string", choices: VHS_DAMAGE_LEVELS, description: "VHS style: tape damage (fal's default medium)" },
-    { name: "seconds", type: "number", description: "Video or SFX duration in seconds (default 5); H3 takes fractions (6.5); extensions add this many seconds, insert-video's scene is 5\u201313; lip-sync, recast, relight and 3d-to-video take their input's length; SFX supports 0.5\u201330" },
+    { name: "seconds", type: "number", description: "Video or SFX duration in seconds (default 5); H3 takes fractions (6.5), FLUX 3 Max 5\u201320 whole seconds; extensions add this many seconds, insert-video's scene is 5\u201313; lip-sync, recast, relight and 3d-to-video take their input's length; SFX supports 0.5\u201330" },
     { name: "resolution", type: "string", choices: VIDEO_RESOLUTIONS, description: "Video resolution supported by the selected model and workflow (default its first)" },
     { name: "mode", type: "string", choices: ["cost", "speed", "quality"], description: "Video generation mode supported by the selected model (default its first)" },
-    { name: "prompt-expansion", type: "string", choices: PROMPT_EXPANSION_MODES, description: "Video: how much the model may rewrite the prompt (default disabled); extensions treat any other value as on" },
+    { name: "prompt-expansion", type: "string", choices: PROMPT_EXPANSION_MODES, description: "Video: how much the model may rewrite the prompt (default disabled); extensions treat any other value as on. FLUX 3 Max always reasons about the prompt: quality thoroughly, any other value lightly" },
     { name: "seed", type: "number", description: "Video: seed for repeatable results, where the model takes one" },
     { name: "extend-output", type: "string", choices: EXTEND_OUTPUTS, description: "Extension: extended (default, source plus new footage) or continuation (a 1.625 s overlap, then the new footage)" },
     { name: "voice", type: "string", description: "Gemini voice name or ElevenLabs voice ID (defaults: Kore / George)" },
@@ -50243,7 +50257,7 @@ Confirm code: ${device.user_code}`);
     out(stdout, await new Client(flags.url, signal).request(flags.look ? `${avatarsPath(args.id)}/looks/${encodeURIComponent(flags.look)}` : `${avatarsPath(args.id)}/${encodeURIComponent(flags.group)}`, { method: "DELETE" }));
   })))).command("jobs", (jobs) => jobs.add(defineCommand("list", { description: "List the latest generation jobs" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/jobs`))))).add(defineCommand("submit", { description: "Submit a typed JSON job: character, animate, custom or redraw; spends credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags(...modelFlags).flags({ name: "file", type: "string", required: true, description: "JSON job file" }, { name: "yes", type: "boolean", required: true, description: "Authorize spending credits" }).action(async ({ args, flags, stdout, signal }) => {
     if (!flags.yes) throw new Error("Pass --yes to authorize spending credits.");
-    const body = spriteJobBody.parse({ ...JSON.parse(await readFile18(flags.file, "utf8")), ...selectedModels(flags) });
+    const body = spriteJobBody.parse({ ...JSON.parse(await readFile19(flags.file, "utf8")), ...selectedModels(flags) });
     out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/jobs`, { method: "POST", body }));
   }))).add(defineCommand("wait", { description: "Wait for a specific job; fail if generation fails or times out" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id, { name: "job", type: "string", required: true }).flags({ name: "timeout", type: "number", default: 600, description: "Maximum seconds to wait" }).action(async ({ args, flags, stdout, signal }) => out(stdout, { job: await waitForJob(new Client(flags.url, signal), args.id, args.job, flags.timeout, signal) }))))).add(defineCommand("models", { description: "Set the default video model for future project jobs" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags(...modelFlags).action(async ({ args, flags, stdout, signal }) => {
     const body = selectedModels(flags);
@@ -50258,7 +50272,7 @@ Confirm code: ${device.user_code}`);
     const extension = flags.file.split(".").at(-1)?.toLowerCase();
     const type = extension === "png" ? "image/png" : extension === "jpg" || extension === "jpeg" ? "image/jpeg" : extension === "webp" ? "image/webp" : void 0;
     if (!type) throw new Error("Use a PNG, JPEG or WebP image.");
-    const bytes = await readFile18(flags.file);
+    const bytes = await readFile19(flags.file);
     if (bytes.length > 10 * 1024 * 1024) throw new Error("Image must be at most 10 MB.");
     const form = new FormData();
     form.set("image", new Blob([bytes], { type }), `reference.${extension}`);
@@ -50274,7 +50288,7 @@ Confirm code: ${device.user_code}`);
     if (!file2) throw new Error(`No file at ${args.path} in this project. List them with animaguru files list.`);
     if (!/^[a-f0-9]{64}$/.test(file2.sha)) throw new Error("Invalid blob hash in manifest.");
     const response = await client.request(`/api/v1/blobs/${encodeURIComponent(manifest.ownerId)}/${file2.sha}`, { raw: true });
-    const path = resolve16(flags.output);
+    const path = resolve17(flags.output);
     await mkdir15(dirname14(path), { recursive: true });
     const bytes = new Uint8Array(await response.arrayBuffer());
     await writeFile16(path, bytes, { flag: "wx" });
@@ -50289,7 +50303,7 @@ Confirm code: ${device.user_code}`);
       const response = await client.request(`/api/v1/blobs/${encodeURIComponent(manifest.ownerId)}/${file2.sha}`, { raw: true });
       entries[path2] = new Uint8Array(await response.arrayBuffer());
     }
-    const path = resolve16(flags.output);
+    const path = resolve17(flags.output);
     await writeFile16(path, zipSync(entries, { level: 0 }), { flag: "wx" });
     out(stdout, { path, files: manifest.files.length });
   })))).extend(version(package_default.version, { format: "plain" })).extend(help()).extend(completion());