@docyrus/animaguru 0.36.0 → 0.39.0

package/dist/animaguru.js

@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.36.0",
+  version: "0.39.0",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {
@@ -45002,9 +45002,11 @@ var ALL_TOP_ACTIONS = [...new Set(Object.values(SPRITE_TOP_ACTIONS).flat())];
 var CUSTOM_FRAMES = { min: 2, max: 12 };
 
 // shared/sprites/models.ts
-var DEFAULT_SPRITE_IMAGE_MODEL = "fal/gpt-image-2.5-medium";
+var DEFAULT_SPRITE_IMAGE_MODEL = "fal/gpt-image-2.6-medium";
 var SPRITE_IMAGE_MODELS = [
-  { id: DEFAULT_SPRITE_IMAGE_MODEL, label: "GPT Image 2.5 \xB7 medium (fal)", provider: "fal", edit: true, nativeAlpha: true, maxImages: 16, relCost: 0.3, quality: "medium", endpoints: { generate: "openai/gpt-image-2.5/flare/text-to-image", edit: "openai/gpt-image-2.5/flare/edit" } },
+  { id: DEFAULT_SPRITE_IMAGE_MODEL, label: "GPT Image 2.6 Flare \xB7 medium (fal)", provider: "fal", edit: true, nativeAlpha: true, maxImages: 16, relCost: 0.3, quality: "medium", endpoints: { generate: "openai/gpt-image-2.6/flare/text-to-image", edit: "openai/gpt-image-2.6/flare/edit" } },
+  { id: "fal/gpt-image-2.6-sunburst-high", label: "GPT Image 2.6 Sunburst \xB7 high (fal)", provider: "fal", edit: true, nativeAlpha: true, maxImages: 16, relCost: 1, quality: "high", endpoints: { generate: "openai/gpt-image-2.6/sunburst/text-to-image", edit: "openai/gpt-image-2.6/sunburst/edit" } },
+  { id: "fal/gpt-image-2.5-medium", label: "GPT Image 2.5 \xB7 medium (fal)", provider: "fal", edit: true, nativeAlpha: true, maxImages: 16, relCost: 0.3, quality: "medium", endpoints: { generate: "openai/gpt-image-2.5/flare/text-to-image", edit: "openai/gpt-image-2.5/flare/edit" } },
   { id: "fal/gpt-image-2-low", label: "GPT Image 2 \xB7 low (fal)", provider: "fal", edit: true, spriteBackupCutout: true, maxImages: 16, relCost: 0.2, quality: "low", endpoints: { generate: "openai/gpt-image-2", edit: "openai/gpt-image-2/edit" } },
   { id: "fal/muse-image", label: "Muse Image (fal)", provider: "fal", edit: true, maxImages: 10, relCost: 0.2, endpoints: { generate: "meta/muse-image/text-to-image", edit: "meta/muse-image/edit" } },
   { id: "fal/krea-2-turbo", label: "Krea 2 Turbo (fal)", provider: "fal", edit: false, maxImages: 0, relCost: 0.16, endpoints: { generate: "fal-ai/krea-2/turbo" } },
@@ -45267,6 +45269,7 @@ import { chmod as chmod2, mkdir as mkdir4, readFile as readFile2, rename as rena
 import { dirname as dirname3, join as join4, resolve as resolve3 } from "node:path";
 import { homedir as homedir3 } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
+var USER_AGENT = `animaguru-cli/${package_default.version}`;
 function serverUrl(value) {
   const url3 = new URL(value);
   if (url3.username || url3.password || url3.search || url3.hash || url3.pathname !== "/") throw new Error("Use an origin URL without credentials, path, query or fragment.");
@@ -45332,18 +45335,19 @@ var Client = class {
   origin;
   async request(path, options = {}) {
     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 generation = options.method === "POST" && /^\/api\/v1\/sprites\/[^/]+\/(jobs|assets|avatars|avatars\/looks|avatars\/videos|avatars\/[^/]+\/consent)$/.test(path);
     const idempotency = generation ? { "Idempotency-Key": generationRequestId(path, options.body) } : {};
     const response = await fetch(`${this.origin}${path}`, {
       method: options.method ?? "GET",
-      headers: { Origin: this.origin, ...token3 ? { Authorization: `Bearer ${token3}` } : {}, ...options.body instanceof Blob ? { "Content-Type": options.body.type || "application/octet-stream" } : options.body !== void 0 && !(options.body instanceof FormData) ? { "Content-Type": "application/json" } : {}, ...idempotency, ...options.headers },
+      headers: { Origin: this.origin, "User-Agent": USER_AGENT, ...token3 ? { Authorization: `Bearer ${token3}` } : {}, ...options.body instanceof Blob ? { "Content-Type": options.body.type || "application/octet-stream" } : options.body !== void 0 && !(options.body instanceof FormData) ? { "Content-Type": "application/json" } : {}, ...idempotency, ...options.headers },
       body: options.body instanceof FormData || options.body instanceof Blob ? options.body : options.body === void 0 ? void 0 : JSON.stringify(options.body),
       redirect: "error",
       signal: this.signal ? AbortSignal.any([this.signal, AbortSignal.timeout(options.timeout ?? 3e4)]) : AbortSignal.timeout(options.timeout ?? 3e4)
     });
     if (response.ok && options.raw) return response;
     const data = await response.json();
-    if (!response.ok) throw new ServiceError(response.status, typeof data.error === "string" ? data.error : "request_failed", data.error_description ?? (typeof data.error === "object" ? data.error.message : void 0) ?? data.message ?? `Request failed (${response.status}).`);
+    const code = typeof data.error === "string" ? data.error : typeof data.error?.code === "string" ? data.error.code : "request_failed";
+    if (!response.ok) throw new ServiceError(response.status, code, data.error_description ?? (typeof data.error === "object" ? data.error.message : void 0) ?? data.message ?? `Request failed (${response.status}).`);
     return data;
   }
 };
@@ -46973,6 +46977,130 @@ async function createAnimation(options) {
   };
 }
 
+// shared/avatars.ts
+var AVATAR_OWNERSHIPS = ["public", "private"];
+var AVATAR_LOOK_TYPES = ["studio_avatar", "digital_twin", "photo_avatar"];
+var AVATAR_CREATE_TYPES = ["prompt", "photo", "digital_twin"];
+var AVATAR_ASPECT_RATIOS = ["auto", "16:9", "9:16", "1:1", "4:5", "5:4"];
+var LOOK_PACK_ASPECT_RATIOS = ["16:9", "9:16"];
+var AVATAR_LOOK_METHODS = ["look_pack", "template"];
+var AVATAR_CREDIT_UNITS = { digital_twin: 2130, photo: 1320, prompt: 1320 };
+var AVATAR_LOOK_CREDIT_UNITS = 1320;
+var LOOKS_PER_METHOD = { look_pack: 5, template: 2 };
+var AVATAR_LOOK_TEMPLATES = [
+  { id: "5a8e6be843ee4321a014946bf62aa322", method: "look_pack", name: "Modern Corporate", variant: "female" },
+  { id: "5e659e76755d47fd9160a2d7dedce124", method: "look_pack", name: "Modern Corporate", variant: "male" },
+  { id: "e1650a9029d04ea1a350421c163295fd", method: "look_pack", name: "Stylish Business-Casual", variant: "female" },
+  { id: "a5f8e0c0cb654c1a83c695629b173af5", method: "look_pack", name: "Stylish Business-Casual", variant: "male" },
+  { id: "e7b000e2cb0d44f1a2d2f291a38b395a", method: "look_pack", name: "Scandinavian Minimal", variant: "female" },
+  { id: "9600f78f27bb49d792e1c56ce624b929", method: "look_pack", name: "Scandinavian Minimal", variant: "male" },
+  { id: "d7ad40ec97d4459a92b33398b57caf4e", method: "look_pack", name: "Cool Tech / Slate", variant: "female" },
+  { id: "fbd03fc3603a4e3caff594f5743a1733", method: "look_pack", name: "Cool Tech / Slate", variant: "male" },
+  { id: "14f4070bd5a04eb6b1f82ae087cd0f30", method: "look_pack", name: "Healthcare", variant: "female" },
+  { id: "ce706bfa8556401e8c4401765102a455", method: "look_pack", name: "Healthcare", variant: "male" },
+  { id: "b0cae4fbae384ab9ab9a8e73ba504be8", method: "look_pack", name: "Keynote Power Presenter", variant: "female" },
+  { id: "71e84769162d4f4186563ad9e0fc45b8", method: "look_pack", name: "Keynote Power Presenter", variant: "male" },
+  { id: "935ea0b7cdde4e6eb5a198a3d666f677", method: "look_pack", name: "Fitness", variant: "female" },
+  { id: "daeb8b15c92a4acf9ffb437ba5534458", method: "look_pack", name: "Fitness", variant: "male" },
+  { id: "6f183d726933457c9035fc0aa4e9c0c3", method: "look_pack", name: "Automotive Dealership", variant: "female" },
+  { id: "8595c78b466c4e51802731229c59b6e7", method: "look_pack", name: "Automotive Dealership", variant: "male" },
+  { id: "b30c83d99cec48e09c8f5b07ed8aa38c", method: "template", name: "Business Casual", variant: "female" },
+  { id: "2dc326030e2e4471babcc9eda56131b6", method: "template", name: "Business Casual", variant: "male" },
+  { id: "00c49daa4eb94386a0c12508043bab17", method: "template", name: "Podcast", variant: "female" },
+  { id: "0e52ceafe4d5456fb83c1e39899ff76a", method: "template", name: "Podcast", variant: "male" }
+];
+var avatarTemplate = (id2) => AVATAR_LOOK_TEMPLATES.find((t) => t.id === id2);
+var heygenId = external_exports.string().trim().regex(/^(?!\.{1,2}$)[A-Za-z0-9_.-]{1,128}$/, "Use an avatar id returned by AnimaGuru.");
+var sha = external_exports.string().regex(/^[a-f0-9]{64}$/);
+var name = external_exports.string().trim().min(1).max(80);
+var https = external_exports.string().trim().max(2048).url().refine((url3) => url3.startsWith("https://"), "Use an HTTPS URL.");
+var AVATAR_INLINE_MAX_BYTES = 8 * 1024 * 1024;
+var AVATAR_PHOTO_TYPES = ["image/png", "image/jpeg", "image/webp"];
+var AVATAR_FOOTAGE_TYPES = ["video/mp4", "video/quicktime", "video/webm"];
+var avatarFile = external_exports.discriminatedUnion("type", [
+  external_exports.object({ type: external_exports.literal("file"), sha }),
+  external_exports.object({ type: external_exports.literal("url"), url: https }),
+  external_exports.object({
+    type: external_exports.literal("base64"),
+    mediaType: external_exports.enum([...AVATAR_PHOTO_TYPES, ...AVATAR_FOOTAGE_TYPES]),
+    data: external_exports.string().max(Math.ceil(AVATAR_INLINE_MAX_BYTES / 3) * 4, "Inline files must be at most 8 MB; use a URL or a project file.").regex(/^[A-Za-z0-9+/]+={0,2}$/, "Send the file as standard base64.")
+  })
+]);
+var subjectConsent = external_exports.literal(true, { error: "Confirm that the person shown agreed to become an avatar (subjectConsent: true)." });
+var avatarCreateRequest = external_exports.discriminatedUnion("type", [
+  external_exports.object({
+    type: external_exports.literal("prompt"),
+    name,
+    prompt: external_exports.string().trim().min(3).max(1e3),
+    aspectRatio: external_exports.enum(AVATAR_ASPECT_RATIOS).default("auto"),
+    lookId: heygenId.optional(),
+    groupId: heygenId.optional(),
+    referenceImages: external_exports.array(avatarFile).max(3).default([])
+  }),
+  external_exports.object({ type: external_exports.literal("photo"), name, file: avatarFile, groupId: heygenId.optional(), subjectConsent }),
+  external_exports.object({ type: external_exports.literal("digital_twin"), name, file: avatarFile, groupId: heygenId.optional(), subjectConsent })
+]).superRefine((p, ctx) => {
+  const files = p.type === "prompt" ? p.referenceImages : [p.file];
+  const footage = p.type === "digital_twin";
+  for (const [index2, file2] of files.entries()) {
+    if (file2.type !== "base64") continue;
+    const allowed = footage ? AVATAR_FOOTAGE_TYPES : AVATAR_PHOTO_TYPES;
+    if (!allowed.includes(file2.mediaType)) ctx.addIssue({ code: "custom", message: footage ? "Send footage as MP4, MOV or WebM." : "Send a PNG, JPEG or WebP image.", path: p.type === "prompt" ? ["referenceImages", index2, "mediaType"] : ["file", "mediaType"] });
+  }
+});
+var avatarLooksRequest = external_exports.discriminatedUnion("method", [
+  external_exports.object({ method: external_exports.literal("look_pack"), lookId: heygenId, templateId: heygenId, aspectRatio: external_exports.enum(LOOK_PACK_ASPECT_RATIOS).default("16:9") }),
+  external_exports.object({ method: external_exports.literal("template"), lookId: heygenId, templateId: heygenId })
+]).superRefine((p, ctx) => {
+  const known = avatarTemplate(p.templateId);
+  if (known && known.method !== p.method) ctx.addIssue({ code: "custom", message: `This template is applied with method ${known.method}.`, path: ["method"] });
+});
+var heygenVoiceId = external_exports.string().trim().regex(/^[A-Za-z0-9_.-]{1,128}$/, "Use a HeyGen voice ID.");
+var avatarGroupUpdate = external_exports.object({ defaultVoiceId: heygenVoiceId });
+var avatarLookUpdate = external_exports.object({ name: external_exports.string().trim().min(1).max(255) });
+var avatarConsentRequest = external_exports.object({ rerouteUrl: https.optional() });
+var limit = external_exports.coerce.number().int().min(1).max(50).default(20);
+var token = external_exports.string().max(2048).optional();
+var avatarListQuery = external_exports.object({ ownership: external_exports.enum(AVATAR_OWNERSHIPS).default("public"), limit, token });
+var avatarLookListQuery = external_exports.object({ groupId: heygenId.optional(), avatarType: external_exports.enum(AVATAR_LOOK_TYPES).optional(), limit, token });
+var avatarVoiceListQuery = external_exports.object({ ownership: external_exports.enum(AVATAR_OWNERSHIPS).default("public"), language: external_exports.string().trim().min(1).max(40).optional(), gender: external_exports.enum(["male", "female"]).optional(), limit, token });
+var avatarCreateEstimate = (p) => AVATAR_CREDIT_UNITS[p.type];
+var avatarLooksEstimate = (p) => LOOKS_PER_METHOD[p.method] * AVATAR_LOOK_CREDIT_UNITS;
+var AVATAR_VIDEO_MODEL_IDS = ["heygen/avatar-iv", "heygen/avatar-v", "heygen/avatar-iii"];
+var DEFAULT_AVATAR_VIDEO_MODEL = "heygen/avatar-iv";
+var AVATAR_VIDEO_RESOLUTIONS = ["720p", "1080p"];
+var AVATAR_EXPRESSIVENESS = ["low", "medium", "high"];
+var AVATAR_SCRIPT_MAX = 1500;
+var AVATAR_VIDEO_MAX_SECONDS = 120;
+var avatarVideoRequest = external_exports.object({
+  type: external_exports.literal("video"),
+  name,
+  model: external_exports.enum(AVATAR_VIDEO_MODEL_IDS).default(DEFAULT_AVATAR_VIDEO_MODEL),
+  /** A look of this workspace's avatars or of HeyGen's catalog. */
+  lookId: heygenId,
+  /** What the avatar says. */
+  script: external_exports.string().trim().min(1).max(AVATAR_SCRIPT_MAX).optional(),
+  /** Saved speech or music in this project that the avatar lip-syncs instead of a script. */
+  soundtrack: sha.optional(),
+  /** The voice that speaks the script; without it, the look's own voice. */
+  voiceId: heygenVoiceId.optional(),
+  aspectRatio: external_exports.enum(AVATAR_ASPECT_RATIOS).default("auto"),
+  resolution: external_exports.enum(AVATAR_VIDEO_RESOLUTIONS).default("1080p"),
+  /** How the body and hands move: photo avatars on Avatar IV, any look on Avatar V. */
+  motionPrompt: external_exports.string().trim().min(3).max(1e3).optional(),
+  /** How much a photo avatar moves on Avatar IV (low unless set). */
+  expressiveness: external_exports.enum(AVATAR_EXPRESSIVENESS).optional(),
+  /** The clip's length, which the server sets: the audio's, or the script's estimate until the clip is made. */
+  seconds: external_exports.number().positive().max(600).optional()
+}).superRefine((p, ctx) => {
+  const issue2 = (path, message) => ctx.addIssue({ code: "custom", message, path: [path] });
+  if (p.script && p.soundtrack) issue2("soundtrack", "Give the avatar a script or a saved audio track, not both.");
+  if (!p.script && !p.soundtrack) issue2("script", "Write what the avatar says, or choose saved speech or music for it to lip-sync.");
+  if (p.soundtrack && p.voiceId) issue2("voiceId", "A saved audio track speaks in its own voice; leave out voiceId.");
+  if (p.model === "heygen/avatar-iii" && p.motionPrompt) issue2("motionPrompt", "Avatar III doesn't take a motion prompt; use Avatar IV or Avatar V.");
+  if (p.model !== "heygen/avatar-iv" && p.expressiveness) issue2("expressiveness", "Only Avatar IV takes expressiveness.");
+});
+
 // shared/model-assets.ts
 var MODEL_GENERATORS = [
   {
@@ -47042,7 +47170,7 @@ var rigCostUsd = (clips2) => 0.2 + 0.12 * clips2;
 var modelCostUsd = (p) => generationCostUsd(p) + (p.rig ? rigCostUsd(p.animations.length) : 0);
 
 // shared/assets.ts
-var ASSET_TYPES = ["image", "vector", "video", "music", "speech", "sfx", "model"];
+var ASSET_TYPES = ["image", "vector", "gif", "video", "music", "speech", "sfx", "model"];
 var SPEECH_MODELS = [
   { id: "gemini-3.8-flash-tts", label: "Gemini 3.8 Flash TTS", provider: "google" },
   { id: "gemini-3.8-flash-lite-tts", label: "Gemini 3.8 Flash-Lite TTS", provider: "google" },
@@ -47325,6 +47453,7 @@ var videoDefaults = (p) => {
   return { ...p, seconds: p.seconds ?? defaultSeconds(model, p.workflow), resolution: p.resolution ?? videoResolutions(model, p.workflow)[0], mode: p.mode ?? model.modes[0] };
 };
 var IMAGE_ASPECT_RATIOS = ["1:1", "3:2", "2:3", "16:9", "9:16"];
+var IMAGE_SIZES = { "1:1": [1024, 1024], "3:2": [1536, 1024], "2:3": [1024, 1536], "16:9": [1536, 864], "9:16": [864, 1536] };
 var MAX_IMAGE_REFERENCES = 4;
 var MAX_MASK_REGIONS = 8;
 var imageReferences = external_exports.array(blob).max(MAX_IMAGE_REFERENCES).refine((shas2) => new Set(shas2).size === shas2.length, "Choose each reference image once.").default([]);
@@ -47342,10 +47471,13 @@ var imageAsset = external_exports.object({
 var imageChecks = (p, ctx) => {
   if (p.mask && !p.references.length) ctx.addIssue({ code: "custom", message: "A mask edits Image 1; add the image to edit as the first reference.", path: ["mask"] });
 };
-var VECTOR_MODELS = [{ id: "fal/ideogram-vector", label: "Ideogram Vector (fal)" }];
+var VECTOR_MODELS = [{ id: "fal/ideogram-vector", label: "Ideogram Vector (fal)" }, { id: "fal/gpt-image-2.6-vector", label: "GPT Image 2.6 Vector (fal)" }];
+var VECTOR_MODEL_IDS = ["fal/ideogram-vector", "fal/gpt-image-2.6-vector"];
+var GPT_VECTOR_MODEL = "fal/gpt-image-2.6-vector";
 var VECTOR_WORKFLOWS = ["text-to-vector", "image-to-vector"];
 var VECTOR_QUALITIES = ["low", "medium", "high"];
 var VECTOR_ASPECT_RATIOS = ["auto", "1:1", "1:4", "1:3", "1:2", "9:16", "10:16", "2:3", "3:4", "4:5", "5:4", "4:3", "3:2", "16:10", "16:9", "2:1", "3:1", "4:1"];
+var GPT_VECTOR_ASPECT_RATIOS = VECTOR_ASPECT_RATIOS.filter((ratio) => ratio !== "1:4" && ratio !== "4:1");
 var VECTOR_SHAPES = ["detailed", "simple"];
 var MAX_VECTOR_REFERENCES = 5;
 var VECTOR_REFERENCE_MAX_BYTES = 10 * 1024 * 1024;
@@ -47355,7 +47487,7 @@ var vectorAsset = external_exports.object({
   /** Image-to-vector takes no prompt. */
   prompt: external_exports.string().trim().max(4e3).default(""),
   type: external_exports.literal("vector"),
-  model: external_exports.literal("fal/ideogram-vector").default("fal/ideogram-vector"),
+  model: external_exports.enum(VECTOR_MODEL_IDS).default("fal/ideogram-vector"),
   workflow: external_exports.enum(VECTOR_WORKFLOWS).default("text-to-vector"),
   /** Text-to-vector; defaults to medium. */
   quality: external_exports.enum(VECTOR_QUALITIES).optional(),
@@ -47368,11 +47500,24 @@ var vectorAsset = external_exports.object({
   /** Image-to-vector; defaults to detailed. */
   shapes: external_exports.enum(VECTOR_SHAPES).optional(),
   /** Text-to-vector. */
-  seed: external_exports.number().int().min(0).max(2 ** 32 - 1).optional()
+  seed: external_exports.number().int().min(0).max(2 ** 32 - 1).optional(),
+  /** GPT Image 2.6: draw the art alone, without a background (default false). */
+  transparent: external_exports.boolean().optional()
 });
 function vectorChecks(p, ctx) {
   const issue2 = (path, message) => ctx.addIssue({ code: "custom", message, path: [path] });
   if (new Set(p.references).size !== p.references.length) issue2("references", "Choose each reference image once.");
+  if (p.model === GPT_VECTOR_MODEL) {
+    if (p.workflow !== "text-to-vector") return issue2("workflow", "GPT Image 2.6 Vector draws from text; trace a saved image with Ideogram Vector (fal/ideogram-vector).");
+    if (p.prompt.length < 3) issue2("prompt", "Describe the vector in at least 3 characters.");
+    if (p.references.length) issue2("references", "GPT Image 2.6 Vector draws from the prompt alone; follow reference images with Ideogram Vector (fal/ideogram-vector).");
+    if (p.source) issue2("source", "Only image-to-vector traces a saved image.");
+    if (p.shapes) issue2("shapes", "Only image-to-vector takes shapes.");
+    if (p.seed !== void 0) issue2("seed", "GPT Image 2.6 Vector doesn't take a seed.");
+    if (p.aspectRatio && !GPT_VECTOR_ASPECT_RATIOS.includes(p.aspectRatio)) issue2("aspectRatio", "GPT Image 2.6 Vector draws between 1:3 and 3:1; choose another aspect ratio.");
+    return;
+  }
+  if (p.transparent !== void 0) issue2("transparent", "Only GPT Image 2.6 Vector (fal/gpt-image-2.6-vector) leaves out the background.");
   if (p.workflow === "text-to-vector") {
     if (p.prompt.length < 3) issue2("prompt", "Describe the vector in at least 3 characters.");
     if (p.source) issue2("source", "Only image-to-vector traces a saved image; use references to guide text-to-vector.");
@@ -47384,7 +47529,39 @@ function vectorChecks(p, ctx) {
   for (const field of ["quality", "aspectRatio", "seed"]) if (p[field] !== void 0) issue2(field, `image-to-vector doesn't take ${field === "aspectRatio" ? "an aspect ratio" : field === "seed" ? "a seed" : "a quality"}; the SVG follows the image.`);
   if (p.references.length) issue2("references", "image-to-vector traces its source alone and takes no references.");
 }
-var vectorDefaults = (p) => p.workflow === "text-to-vector" ? { ...p, quality: p.quality ?? "medium", aspectRatio: p.aspectRatio ?? "auto" } : { ...p, shapes: p.shapes ?? "detailed" };
+var vectorDefaults = (p) => p.workflow === "text-to-vector" ? { ...p, quality: p.quality ?? "medium", aspectRatio: p.aspectRatio ?? "auto", ...p.model === GPT_VECTOR_MODEL ? { transparent: p.transparent ?? false } : {} } : { ...p, shapes: p.shapes ?? "detailed" };
+var GIF_MODELS = [
+  { id: "fal/gpt-image-2.6-gif", label: "GPT Image 2.6 Flare GIF (fal)" },
+  { id: "fal/gpt-image-2.6-sunburst-gif", label: "GPT Image 2.6 Sunburst GIF (fal)" }
+];
+var GIF_MODEL_IDS = ["fal/gpt-image-2.6-gif", "fal/gpt-image-2.6-sunburst-gif"];
+var DEFAULT_GIF_MODEL = "fal/gpt-image-2.6-gif";
+var GIF_QUALITIES = ["low", "medium", "high"];
+var GIF_FRAMES = { min: 2, max: 16, default: 9 };
+var GIF_FRAME_MS = { min: 20, max: 2e3, default: 200 };
+var MAX_GIF_REFERENCES = 4;
+var GIF_PIXEL_BUDGET = 3840 * 2160;
+function gifFrameSize(aspectRatio, frames) {
+  const [w, h] = IMAGE_SIZES[aspectRatio];
+  const scale = Math.min(1, Math.sqrt(GIF_PIXEL_BUDGET / Math.max(1, frames) / (w * h)));
+  const width = Math.max(16, Math.floor(w * scale / 16) * 16);
+  return [width, Math.max(16, Math.floor(width * h / w / 16) * 16)];
+}
+var gifAsset = external_exports.object({
+  ...base,
+  type: external_exports.literal("gif"),
+  model: external_exports.enum(GIF_MODEL_IDS).default(DEFAULT_GIF_MODEL),
+  aspectRatio: external_exports.enum(IMAGE_ASPECT_RATIOS).default("1:1"),
+  frames: external_exports.number().int().min(GIF_FRAMES.min).max(GIF_FRAMES.max).default(GIF_FRAMES.default),
+  /** How long each frame shows, in milliseconds; rounded to 10. */
+  frameMs: external_exports.number().min(GIF_FRAME_MS.min).max(GIF_FRAME_MS.max).default(GIF_FRAME_MS.default),
+  quality: external_exports.enum(GIF_QUALITIES).default("medium"),
+  /** Frames without a background, for a sprite over a scene. */
+  transparent: external_exports.boolean().default(false),
+  /** Saved images or sprite art to animate or follow, named Image 1, Image 2… in the prompt. */
+  references: external_exports.array(blob).max(MAX_GIF_REFERENCES).refine((shas2) => new Set(shas2).size === shas2.length, "Choose each reference image once.").default([])
+});
+var gifDefaults = (p) => ({ ...p, frameMs: Math.round(p.frameMs / 10) * 10 });
 var musicAsset = external_exports.object({
   name: base.name,
   /** A soundtrack may leave it out, and so may a song sung from lyrics, where it sets the style. */
@@ -47503,17 +47680,23 @@ var assetRequest = external_exports.discriminatedUnion("type", [
   }).transform((p) => ({ ...p, voice: p.voice || defaultSpeechVoice(p.model) })),
   external_exports.object({ ...base, type: external_exports.literal("sfx"), model: external_exports.literal("eleven_text_to_sound_v2").default("eleven_text_to_sound_v2"), seconds: external_exports.number().min(0.5).max(30).default(5), loop: external_exports.boolean().default(false), promptInfluence: external_exports.number().min(0).max(1).default(0.3) }),
   vectorAsset.superRefine(vectorChecks).transform(vectorDefaults),
-  modelAsset.superRefine(modelChecks).transform(modelDefaults)
+  modelAsset.superRefine(modelChecks).transform(modelDefaults),
+  gifAsset.transform(gifDefaults)
 ]);
 var assetGenerationRequest = external_exports.discriminatedUnion("type", [imageAsset.omit({ model: true }).superRefine(imageChecks), ...assetRequest.options.slice(1)]);
 var LIBRARY_AUDIO_MODEL = "library-audio";
 var libraryAudio = external_exports.object({ name: base.name, prompt: external_exports.string().trim().max(4e3).default(""), type: external_exports.enum(["music", "sfx"]), model: external_exports.literal(LIBRARY_AUDIO_MODEL), loop: external_exports.boolean().default(false) });
 var UPLOADED_MODEL = "uploaded";
 var uploadedMedia = external_exports.object({ name: base.name, prompt: external_exports.string().trim().max(4e3).default(""), type: external_exports.enum(["image", "video"]), model: external_exports.literal(UPLOADED_MODEL) });
-var savedAssetOptions = external_exports.union([assetRequest, libraryAudio, uploadedMedia]);
+var savedAssetOptions = external_exports.union([assetRequest, avatarVideoRequest, libraryAudio, uploadedMedia]);
 var speechCharacters = (text2) => Array.from(text2).length;
 var imageEstimate = (p) => Math.ceil((130 + 40 * p.references.length) * spriteImageModel(p.model).relCost);
-var vectorEstimate = (p) => p.workflow === "image-to-vector" ? 100 : p.quality === "low" ? 130 : p.quality === "high" ? p.references.length ? 320 : 200 : 160;
+var vectorEstimate = (p) => p.model === GPT_VECTOR_MODEL ? p.quality === "low" ? 80 : p.quality === "high" ? 220 : 120 : p.workflow === "image-to-vector" ? 100 : p.quality === "low" ? 130 : p.quality === "high" ? p.references.length ? 320 : 200 : 160;
+var GIF_UNITS_PER_MEGAPIXEL = { low: 13, medium: 39, high: 130 };
+function gifEstimate(p) {
+  const [w, h] = gifFrameSize(p.aspectRatio, p.frames);
+  return Math.ceil(p.frames * (w * h) / (1024 * 1024) * GIF_UNITS_PER_MEGAPIXEL[p.quality] + 12 * p.references.length);
+}
 function videoExtras(p, facts = {}) {
   const w = p.workflow;
   if (spriteVideoModel(p.model).provider === "heygen") {
@@ -47533,6 +47716,7 @@ var modelEstimate = (p) => Math.max(1, Math.ceil(modelCostUsd(p) / 1e-3));
 function assetEstimate(p, now = Date.now()) {
   if (p.type === "image") return imageEstimate(p);
   if (p.type === "vector") return vectorEstimate(p);
+  if (p.type === "gif") return gifEstimate(p);
   if (p.type === "model") return modelEstimate(p);
   if (p.type === "video") return spriteVideoEstimate(spriteVideoModel(p.model), p, videoExtras(p));
   if (p.type === "music") return Math.ceil(musicCostUsd(p) / 1e-3);
@@ -48218,7 +48402,7 @@ ${entries.join(",\n")}
 }}
 `;
 }
-async function token(context, access4) {
+async function token2(context, access4) {
   const result = await context.client.request(`/api/v1/cloud/${context.link.projectId}/token`, { method: "POST", body: { access: access4 } });
   const remote = new URL(result.remote);
   if (remote.protocol !== "https:" && !(remote.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(remote.hostname))) throw new Error("The server returned an unsafe cloud remote.");
@@ -48385,7 +48569,7 @@ async function cloudStatus(options) {
     await saveState(context);
     let cloud = null;
     if (!options.offline) {
-      const latest = await fetchLatest(context, await token(context, "read"));
+      const latest = await fetchLatest(context, await token2(context, "read"));
       cloud = { latest, newer: Boolean(latest && latest !== context.state.base) };
     }
     return {
@@ -48403,7 +48587,7 @@ async function cloudStatus(options) {
 async function pushCloud(options) {
   const context = await openContext(options.dir, options);
   return withLock(context.root, async () => {
-    const remote = await token(context, "write");
+    const remote = await token2(context, "write");
     const latest = await fetchLatest(context, remote);
     if (latest && latest !== context.state.base) throw new Error(`The project's animations have a newer version (${short(latest)}). Run animaguru cloud pull, then push again.`);
     const { files: scanned, skipped, tooLarge } = await scanFiles(context.root);
@@ -48461,7 +48645,7 @@ function defaultMessage(diff) {
 async function pullCloud(options) {
   const context = await openContext(options.dir, options);
   return withLock(context.root, async () => {
-    const latest = await fetchLatest(context, await token(context, "read"));
+    const latest = await fetchLatest(context, await token2(context, "read"));
     if (!latest || latest === context.state.base) return { updated: false, version: context.state.base, message: "Already up to date." };
     const { files: scanned, tooLarge } = await scanFiles(context.root);
     const local = await describeFiles(context, scanned);
@@ -48512,7 +48696,7 @@ async function restoreCloud(options) {
   const context = await openContext(options.dir, options);
   return withLock(context.root, async () => {
     if (!/^[a-f0-9]{4,40}$/.test(options.version)) throw new Error("Pass a version ID from animaguru cloud versions.");
-    await fetchLatest(context, await token(context, "read"));
+    await fetchLatest(context, await token2(context, "read"));
     let version4;
     try {
       version4 = await import_isomorphic_git.default.expandOid({ fs, gitdir: context.gitdir, oid: options.version });
@@ -48807,13 +48991,16 @@ var extras = {
   speech: ["voice", "delivery"],
   sfx: ["seconds", "loop", "prompt-influence"],
   model: ["reference", "texture", "pbr", "faces", "rig", "animations", "height", "splats", "photo", "seed"],
-  vector: ["workflow", "references", "source", "aspect-ratio", "quality", "shapes", "seed"]
+  vector: ["workflow", "references", "source", "aspect-ratio", "quality", "shapes", "seed", "transparent"],
+  gif: ["aspect-ratio", "frames", "frame-ms", "quality", "transparent", "references"]
 };
+var typeName = (type) => type === "gif" ? "GIF" : type;
 var list2 = (items) => items.length < 2 ? items.join("") : `${items.slice(0, -1).join(", ")} and ${items.at(-1)}`;
 function accepted(type) {
   const options = extras[type];
   if (!options) return "";
-  return `${type[0].toUpperCase()}${type.slice(1)} assets accept ${list2(["--name", "--prompt", "--model", ...options.map((option) => `--${option}`)])}.`;
+  const name2 = typeName(type);
+  return `${name2[0].toUpperCase()}${name2.slice(1)} assets accept ${list2(["--name", "--prompt", "--model", ...options.map((option) => `--${option}`)])}.`;
 }
 function parseAsset(input2) {
   const value = input2 && typeof input2 === "object" && "type" in input2 && input2.type === "image" ? { ...input2, model: void 0 } : input2;
@@ -48843,10 +49030,10 @@ function assetFromFlags(flags) {
   for (const name2 of Object.values(extras).flat()) {
     const value = flags[name2];
     const given2 = value !== void 0 && (value !== false || (name2 === "texture" || name2 === "pbr") && flags.type !== "model");
-    if (given2 && !extras[flags.type]?.includes(name2)) throw new Error(`--${name2} is not an option for ${flags.type} assets. ${accepted(flags.type)}`.trim());
+    if (given2 && !extras[flags.type]?.includes(name2)) throw new Error(`--${name2} is not an option for ${typeName(flags.type)} assets. ${accepted(flags.type)}`.trim());
   }
   const promptOptional = flags.type === "video" || flags.type === "vector" || flags.type === "model" && (flags.reference || isSplatGenerator(flags.model ?? "")) || flags.type === "music" && (flags.model === "fal/mureka-9.5-soundtrack" || flags.lyrics !== void 0);
-  if (!promptOptional && flags.prompt === void 0) throw new Error(`--prompt is required for ${flags.type} assets${flags.type === "model" ? " unless --reference names an image to build from" : flags.type === "music" ? " unless Mureka 9.5 Song sings --lyrics or Mureka 9.5 Soundtrack scores --source" : ""}.`);
+  if (!promptOptional && flags.prompt === void 0) throw new Error(`--prompt is required for ${typeName(flags.type)} assets${flags.type === "model" ? " unless --reference names an image to build from" : flags.type === "music" ? " unless Mureka 9.5 Song sings --lyrics or Mureka 9.5 Soundtrack scores --source" : ""}.`);
   const base2 = { type: flags.type, name: flags.name, prompt: flags.prompt, model: flags.model };
   if (flags.type === "image") return parseAsset({ ...base2, aspectRatio: flags["aspect-ratio"], transparent: flags.transparent, references: shas(flags.references), mask: regions(flags.mask) });
   if (flags.type === "video") {
@@ -48886,7 +49073,8 @@ function assetFromFlags(flags) {
   if (flags.type === "sfx") return parseAsset({ ...base2, seconds: flags.seconds, loop: flags.loop, promptInfluence: flags["prompt-influence"] });
   if (flags.type === "music") return parseAsset({ ...base2, lyrics: flags.lyrics, styles: shas(flags.styles), vocals: flags.vocals, seconds: flags.seconds, source: flags.source });
   if (flags.type === "model") return parseAsset({ ...base2, reference: flags.reference, texture: flags.texture, pbr: flags.pbr, faces: flags.faces, rig: flags.rig, animations: clips(flags.animations), height: flags.height, splats: flags.splats, photo: flags.photo || void 0, seed: flags.seed });
-  if (flags.type === "vector") return parseAsset({ ...base2, workflow: flags.workflow, quality: flags.quality, aspectRatio: flags["aspect-ratio"], references: shas(flags.references), source: flags.source, shapes: flags.shapes, seed: flags.seed });
+  if (flags.type === "vector") return parseAsset({ ...base2, workflow: flags.workflow, quality: flags.quality, aspectRatio: flags["aspect-ratio"], references: shas(flags.references), source: flags.source, shapes: flags.shapes, seed: flags.seed, transparent: flags.transparent || void 0 });
+  if (flags.type === "gif") return parseAsset({ ...base2, aspectRatio: flags["aspect-ratio"], frames: flags.frames, frameMs: flags["frame-ms"], quality: flags.quality, transparent: flags.transparent, references: shas(flags.references) });
   return parseAsset({ ...base2, ...flags.type === "speech" ? { voice: flags.voice, delivery: flags.delivery } : {} });
 }
 async function assetFromFile(file2, model) {
@@ -48982,6 +49170,7 @@ var MIME_EXTENSIONS = {
   "image/png": "png",
   "image/jpeg": "jpg",
   "image/webp": "webp",
+  "image/gif": "gif",
   "image/svg+xml": "svg",
   "video/mp4": "mp4",
   "video/webm": "webm",
@@ -49101,96 +49290,6 @@ async function submitAssetBatch(client, project, requests, options, signal) {
 import { readFile as readFile11, stat as stat6 } from "node:fs/promises";
 import { extname } from "node:path";
 import { setTimeout as delay4 } from "node:timers/promises";
-
-// shared/avatars.ts
-var AVATAR_OWNERSHIPS = ["public", "private"];
-var AVATAR_LOOK_TYPES = ["studio_avatar", "digital_twin", "photo_avatar"];
-var AVATAR_CREATE_TYPES = ["prompt", "photo", "digital_twin"];
-var AVATAR_ASPECT_RATIOS = ["auto", "16:9", "9:16", "1:1", "4:5", "5:4"];
-var LOOK_PACK_ASPECT_RATIOS = ["16:9", "9:16"];
-var AVATAR_LOOK_METHODS = ["look_pack", "template"];
-var AVATAR_CREDIT_UNITS = { digital_twin: 2130, photo: 1320, prompt: 1320 };
-var AVATAR_LOOK_CREDIT_UNITS = 1320;
-var LOOKS_PER_METHOD = { look_pack: 5, template: 2 };
-var AVATAR_LOOK_TEMPLATES = [
-  { id: "5a8e6be843ee4321a014946bf62aa322", method: "look_pack", name: "Modern Corporate", variant: "female" },
-  { id: "5e659e76755d47fd9160a2d7dedce124", method: "look_pack", name: "Modern Corporate", variant: "male" },
-  { id: "e1650a9029d04ea1a350421c163295fd", method: "look_pack", name: "Stylish Business-Casual", variant: "female" },
-  { id: "a5f8e0c0cb654c1a83c695629b173af5", method: "look_pack", name: "Stylish Business-Casual", variant: "male" },
-  { id: "e7b000e2cb0d44f1a2d2f291a38b395a", method: "look_pack", name: "Scandinavian Minimal", variant: "female" },
-  { id: "9600f78f27bb49d792e1c56ce624b929", method: "look_pack", name: "Scandinavian Minimal", variant: "male" },
-  { id: "d7ad40ec97d4459a92b33398b57caf4e", method: "look_pack", name: "Cool Tech / Slate", variant: "female" },
-  { id: "fbd03fc3603a4e3caff594f5743a1733", method: "look_pack", name: "Cool Tech / Slate", variant: "male" },
-  { id: "14f4070bd5a04eb6b1f82ae087cd0f30", method: "look_pack", name: "Healthcare", variant: "female" },
-  { id: "ce706bfa8556401e8c4401765102a455", method: "look_pack", name: "Healthcare", variant: "male" },
-  { id: "b0cae4fbae384ab9ab9a8e73ba504be8", method: "look_pack", name: "Keynote Power Presenter", variant: "female" },
-  { id: "71e84769162d4f4186563ad9e0fc45b8", method: "look_pack", name: "Keynote Power Presenter", variant: "male" },
-  { id: "935ea0b7cdde4e6eb5a198a3d666f677", method: "look_pack", name: "Fitness", variant: "female" },
-  { id: "daeb8b15c92a4acf9ffb437ba5534458", method: "look_pack", name: "Fitness", variant: "male" },
-  { id: "6f183d726933457c9035fc0aa4e9c0c3", method: "look_pack", name: "Automotive Dealership", variant: "female" },
-  { id: "8595c78b466c4e51802731229c59b6e7", method: "look_pack", name: "Automotive Dealership", variant: "male" },
-  { id: "b30c83d99cec48e09c8f5b07ed8aa38c", method: "template", name: "Business Casual", variant: "female" },
-  { id: "2dc326030e2e4471babcc9eda56131b6", method: "template", name: "Business Casual", variant: "male" },
-  { id: "00c49daa4eb94386a0c12508043bab17", method: "template", name: "Podcast", variant: "female" },
-  { id: "0e52ceafe4d5456fb83c1e39899ff76a", method: "template", name: "Podcast", variant: "male" }
-];
-var avatarTemplate = (id2) => AVATAR_LOOK_TEMPLATES.find((t) => t.id === id2);
-var heygenId = external_exports.string().trim().regex(/^(?!\.{1,2}$)[A-Za-z0-9_.-]{1,128}$/, "Use an avatar id returned by AnimaGuru.");
-var sha = external_exports.string().regex(/^[a-f0-9]{64}$/);
-var name = external_exports.string().trim().min(1).max(80);
-var https = external_exports.string().trim().max(2048).url().refine((url3) => url3.startsWith("https://"), "Use an HTTPS URL.");
-var AVATAR_INLINE_MAX_BYTES = 8 * 1024 * 1024;
-var AVATAR_PHOTO_TYPES = ["image/png", "image/jpeg", "image/webp"];
-var AVATAR_FOOTAGE_TYPES = ["video/mp4", "video/quicktime", "video/webm"];
-var avatarFile = external_exports.discriminatedUnion("type", [
-  external_exports.object({ type: external_exports.literal("file"), sha }),
-  external_exports.object({ type: external_exports.literal("url"), url: https }),
-  external_exports.object({
-    type: external_exports.literal("base64"),
-    mediaType: external_exports.enum([...AVATAR_PHOTO_TYPES, ...AVATAR_FOOTAGE_TYPES]),
-    data: external_exports.string().max(Math.ceil(AVATAR_INLINE_MAX_BYTES / 3) * 4, "Inline files must be at most 8 MB; use a URL or a project file.").regex(/^[A-Za-z0-9+/]+={0,2}$/, "Send the file as standard base64.")
-  })
-]);
-var subjectConsent = external_exports.literal(true, { error: "Confirm that the person shown agreed to become an avatar (subjectConsent: true)." });
-var avatarCreateRequest = external_exports.discriminatedUnion("type", [
-  external_exports.object({
-    type: external_exports.literal("prompt"),
-    name,
-    prompt: external_exports.string().trim().min(3).max(1e3),
-    aspectRatio: external_exports.enum(AVATAR_ASPECT_RATIOS).default("auto"),
-    lookId: heygenId.optional(),
-    groupId: heygenId.optional(),
-    referenceImages: external_exports.array(avatarFile).max(3).default([])
-  }),
-  external_exports.object({ type: external_exports.literal("photo"), name, file: avatarFile, groupId: heygenId.optional(), subjectConsent }),
-  external_exports.object({ type: external_exports.literal("digital_twin"), name, file: avatarFile, groupId: heygenId.optional(), subjectConsent })
-]).superRefine((p, ctx) => {
-  const files = p.type === "prompt" ? p.referenceImages : [p.file];
-  const footage = p.type === "digital_twin";
-  for (const [index2, file2] of files.entries()) {
-    if (file2.type !== "base64") continue;
-    const allowed = footage ? AVATAR_FOOTAGE_TYPES : AVATAR_PHOTO_TYPES;
-    if (!allowed.includes(file2.mediaType)) ctx.addIssue({ code: "custom", message: footage ? "Send footage as MP4, MOV or WebM." : "Send a PNG, JPEG or WebP image.", path: p.type === "prompt" ? ["referenceImages", index2, "mediaType"] : ["file", "mediaType"] });
-  }
-});
-var avatarLooksRequest = external_exports.discriminatedUnion("method", [
-  external_exports.object({ method: external_exports.literal("look_pack"), lookId: heygenId, templateId: heygenId, aspectRatio: external_exports.enum(LOOK_PACK_ASPECT_RATIOS).default("16:9") }),
-  external_exports.object({ method: external_exports.literal("template"), lookId: heygenId, templateId: heygenId })
-]).superRefine((p, ctx) => {
-  const known = avatarTemplate(p.templateId);
-  if (known && known.method !== p.method) ctx.addIssue({ code: "custom", message: `This template is applied with method ${known.method}.`, path: ["method"] });
-});
-var avatarGroupUpdate = external_exports.object({ defaultVoiceId: external_exports.string().trim().min(1).max(255) });
-var avatarLookUpdate = external_exports.object({ name: external_exports.string().trim().min(1).max(255) });
-var avatarConsentRequest = external_exports.object({ rerouteUrl: https.optional() });
-var limit = external_exports.coerce.number().int().min(1).max(50).default(20);
-var token2 = external_exports.string().max(2048).optional();
-var avatarListQuery = external_exports.object({ ownership: external_exports.enum(AVATAR_OWNERSHIPS).default("public"), limit, token: token2 });
-var avatarLookListQuery = external_exports.object({ groupId: heygenId.optional(), avatarType: external_exports.enum(AVATAR_LOOK_TYPES).optional(), limit, token: token2 });
-var avatarCreateEstimate = (p) => AVATAR_CREDIT_UNITS[p.type];
-var avatarLooksEstimate = (p) => LOOKS_PER_METHOD[p.method] * AVATAR_LOOK_CREDIT_UNITS;
-
-// cli/src/avatars.ts
 var MEDIA_TYPES = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp", ".mp4": "video/mp4", ".mov": "video/quicktime", ".webm": "video/webm" };
 var avatarsPath = (project) => `/api/v1/sprites/${encodeURIComponent(project)}/avatars`;
 function parse3(schema, input2) {
@@ -49225,6 +49324,24 @@ function looksFromFlags(flags) {
   if (flags["aspect-ratio"] && method !== "look_pack") throw new Error("--aspect-ratio applies only to Look Packs.");
   return parse3(avatarLooksRequest, { method, lookId: flags.look, templateId: flags.template, aspectRatio: flags["aspect-ratio"] });
 }
+async function avatarVideoFromFlags(flags) {
+  if (flags.script && flags["script-file"]) throw new Error("Pass --script or --script-file, not both.");
+  const script = flags["script-file"] ? (await readFile11(flags["script-file"], "utf8")).trim() : flags.script;
+  if (flags.audio && !/^[a-f0-9]{64}$/.test(flags.audio)) throw new Error("--audio takes the file SHA of saved speech or music from assets list.");
+  return parse3(avatarVideoRequest, {
+    type: "video",
+    name: flags.name,
+    lookId: flags.look,
+    model: flags.model,
+    script,
+    soundtrack: flags.audio,
+    voiceId: flags.voice,
+    aspectRatio: flags["aspect-ratio"],
+    resolution: flags.resolution,
+    motionPrompt: flags["motion-prompt"],
+    expressiveness: flags.expressiveness
+  });
+}
 function authorize(options) {
   if (!options.yes) throw new Error("Pass --yes to authorize spending credits, or --dry-run to validate and estimate without creating anything.");
 }
@@ -49238,6 +49355,11 @@ async function submitLooks(client, project, body, options) {
   authorize(options);
   return client.request(`${avatarsPath(project)}/looks`, { method: "POST", body, timeout: 18e4 });
 }
+async function submitAvatarVideo(client, project, body, options) {
+  if (options["dry-run"]) return client.request(`${avatarsPath(project)}/videos/estimate`, { method: "POST", body });
+  authorize(options);
+  return client.request(`${avatarsPath(project)}/videos`, { method: "POST", body });
+}
 async function waitForLook(client, project, lookId, timeout, signal, interval = 1e4) {
   if (!Number.isFinite(timeout) || timeout <= 0) throw new Error("Timeout must be positive.");
   const deadline = Date.now() + timeout * 1e3;
@@ -50943,6 +51065,7 @@ async function curl(options, 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("user-agent")) headers.set("User-Agent", USER_AGENT);
   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);
@@ -50981,7 +51104,7 @@ async function curl(options, io) {
 }
 
 // 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), ...VECTOR_MODELS.map((m) => m.id), ...MODEL_GENERATOR_IDS];
+var assetModelIds = [...SPRITE_VIDEO_MODEL_IDS, ...MUSIC_MODELS.map((m) => m.id), ...SPEECH_MODELS.map((m) => m.id), ...SFX_MODELS.map((m) => m.id), ...VECTOR_MODELS.map((m) => m.id), ...GIF_MODELS.map((m) => m.id), ...MODEL_GENERATOR_IDS];
 var assetAuthorizationFlags = [
   { name: "yes", type: "boolean", description: "Authorize spending credits" },
   { name: "dry-run", type: "boolean", description: "Validate and estimate locally without submitting a paid job" }
@@ -50994,14 +51117,23 @@ var catalogSections = {
   sprites: ["styles", "kinds", "actions", "videoModels"],
   image: ["assetTypes"],
   vector: ["assetTypes", "vectorModels", "vectorOptions"],
+  gif: ["assetTypes", "gifModels", "gifOptions"],
   video: ["assetTypes", "videoModels", "videoProfiles"],
   music: ["assetTypes", "musicModels", "musicOptions"],
   speech: ["assetTypes", "speechModels", "voices", "elevenLabsVoices", "heygenVoices"],
   sfx: ["assetTypes", "sfxModels"],
   model: ["assetTypes", "modelGenerators", "modelAnimations"],
-  avatars: ["avatarTypes", "avatarLookTypes"]
+  avatars: ["avatarTypes", "avatarLookTypes", "avatarVideoModels"]
+};
+var gifOptions = {
+  frames: GIF_FRAMES,
+  frameMs: GIF_FRAME_MS,
+  qualities: GIF_QUALITIES,
+  aspectRatios: IMAGE_ASPECT_RATIOS,
+  maxReferences: MAX_GIF_REFERENCES,
+  frameSizes: Object.fromEntries(IMAGE_ASPECT_RATIOS.map((ratio) => [ratio, Object.fromEntries(Array.from({ length: GIF_FRAMES.max - GIF_FRAMES.min + 1 }, (_, i2) => GIF_FRAMES.min + i2).map((frames) => [frames, gifFrameSize(ratio, frames)]))]))
 };
-var catalog = () => ({ styles: SPRITE_STYLES, kinds: SPRITE_KINDS, actions: ALL_SPRITE_ACTIONS, videoModels: SPRITE_VIDEO_MODEL_IDS, assetTypes: ASSET_TYPES, musicModels: MUSIC_MODELS.map((m) => m.id), musicOptions: { styles: MUREKA_STYLES, vocals: MUREKA_VOCALS, songSeconds: SONG_SECONDS, maxLyrics: MAX_SONG_LYRICS }, speechModels: SPEECH_MODELS.map((m) => m.id), sfxModels: SFX_MODELS.map((m) => m.id), modelGenerators: MODEL_GENERATORS.map((g) => ({ id: g.id, label: g.label, output: g.output, ...g.output === "spz" ? { splats: g.splats } : { faces: g.faces } })), modelAnimations: MODEL_ANIMATIONS, vectorModels: VECTOR_MODELS.map((m) => m.id), vectorOptions: { workflows: VECTOR_WORKFLOWS, qualities: VECTOR_QUALITIES, aspectRatios: VECTOR_ASPECT_RATIOS, shapes: VECTOR_SHAPES, maxReferences: MAX_VECTOR_REFERENCES }, elevenLabsVoices: ELEVENLABS_VOICES, heygenVoices: HEYGEN_VOICES, voices: SPEECH_VOICES, videoProfiles: SPRITE_VIDEO_MODELS, avatarTypes: AVATAR_CREATE_TYPES, avatarLookTypes: AVATAR_LOOK_TYPES });
+var catalog = () => ({ styles: SPRITE_STYLES, kinds: SPRITE_KINDS, actions: ALL_SPRITE_ACTIONS, videoModels: SPRITE_VIDEO_MODEL_IDS, assetTypes: ASSET_TYPES, musicModels: MUSIC_MODELS.map((m) => m.id), musicOptions: { styles: MUREKA_STYLES, vocals: MUREKA_VOCALS, songSeconds: SONG_SECONDS, maxLyrics: MAX_SONG_LYRICS }, speechModels: SPEECH_MODELS.map((m) => m.id), sfxModels: SFX_MODELS.map((m) => m.id), modelGenerators: MODEL_GENERATORS.map((g) => ({ id: g.id, label: g.label, output: g.output, ...g.output === "spz" ? { splats: g.splats } : { faces: g.faces } })), modelAnimations: MODEL_ANIMATIONS, vectorModels: VECTOR_MODELS.map((m) => m.id), vectorOptions: { workflows: VECTOR_WORKFLOWS, qualities: VECTOR_QUALITIES, aspectRatios: VECTOR_ASPECT_RATIOS, gptAspectRatios: GPT_VECTOR_ASPECT_RATIOS, shapes: VECTOR_SHAPES, maxReferences: MAX_VECTOR_REFERENCES }, gifModels: GIF_MODELS.map((m) => m.id), gifOptions, elevenLabsVoices: ELEVENLABS_VOICES, heygenVoices: HEYGEN_VOICES, voices: SPEECH_VOICES, videoProfiles: SPRITE_VIDEO_MODELS, avatarTypes: AVATAR_CREATE_TYPES, avatarLookTypes: AVATAR_LOOK_TYPES, avatarVideoModels: AVATAR_VIDEO_MODEL_IDS });
 var modelFlags = [
   { name: "video-model", type: "string", choices: SPRITE_VIDEO_MODEL_IDS, description: "Video model override for this operation" }
 ];
@@ -51221,8 +51353,8 @@ Confirm code: ${device.user_code}`);
         else if (e.code !== "authorization_pending") throw e;
       }
     }
-    throw new Error("Device code expired. Run auth login again.");
-  }))).add(defineCommand("status", { description: "Show the signed-in user" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request("/api/v1/me"))))).add(defineCommand("logout", { description: "Revoke the CLI session and remove its saved credentials" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => {
+    throw new Error(`Device code expired. Run auth login again. If the browser said the CLI needs a plan, choose one at ${client.origin}/app/billing first: every account starts with a 7-day Individual Starter trial, and members of a team on the Team plan are covered by it.`);
+  }))).add(defineCommand("status", { description: "Show the signed-in user, its plan or Starter trial, and whether the CLI can act for it (agents)" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request("/api/v1/me"))))).add(defineCommand("logout", { description: "Revoke the CLI session and remove its saved credentials" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => {
     const client = new Client(flags.url, signal);
     try {
       await client.request("/api/auth/sign-out", { method: "POST", body: {} });
@@ -51248,7 +51380,7 @@ Confirm code: ${device.user_code}`);
   })))).add(defineCommand("credits", { description: "Show the selected workspace's remaining credit balance" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).action(async ({ flags, stdout, signal }) => {
     const client = new Client(flags.url, signal);
     out(stdout, await client.request(`/api/v1/credits${await workspaceQuery(client)}`));
-  }))).add(defineCommand("catalog", { description: "List styles, kinds, actions, asset types, models, video settings, speech voices and avatar types" }, (command) => command.flags({ name: "type", type: "string", choices: Object.keys(catalogSections), description: "Only one part: sprites, image, vector, video, music, speech, sfx, model or avatars" }).action(({ flags, stdout }) => {
+  }))).add(defineCommand("catalog", { description: "List styles, kinds, actions, asset types, models, video settings, speech voices and avatar types" }, (command) => command.flags({ name: "type", type: "string", choices: Object.keys(catalogSections), description: "Only one part: sprites, image, vector, gif, video, music, speech, sfx, model or avatars" }).action(({ flags, stdout }) => {
     const full = catalog();
     const section = flags.type;
     out(stdout, section ? Object.fromEntries(catalogSections[section].map((key) => [key, full[key]])) : full);
@@ -51319,21 +51451,21 @@ Confirm code: ${device.user_code}`);
   ).action(async ({ args, flags, stdout, signal }) => out(stdout, await moveWork(new Client(flags.url, signal), args.id, flags))))).add(defineCommand("delete", { description: "Delete a project; requires --yes" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" }, description: "Server origin" }).args(id).flags({ name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
     if (!flags.yes) throw new Error("Pass --yes to delete this project.");
     out(stdout, await new Client(flags.url, signal).request(`/api/v1/projects/${encodeURIComponent(args.id)}`, { method: "DELETE" }));
-  })))).command("assets", (assets) => assets.add(defineCommand("list", { description: "List saved assets, their blob hashes, and configured generation models" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/assets`))))).add(defineCommand("generate", { description: "Generate an image, vector (SVG), video, music, speech, sound-effect or 3D model asset; --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
+  })))).command("assets", (assets) => assets.add(defineCommand("list", { description: "List saved assets, their blob hashes, and configured generation models" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${projectPath(args.id)}/assets`))))).add(defineCommand("generate", { description: "Generate an image, vector (SVG), animated GIF, video, music, speech, sound-effect or 3D model asset; --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
     { name: "type", type: "string", required: true, choices: ASSET_TYPES },
     { name: "name", type: "string", required: true },
     { name: "prompt", type: "string", description: "Description to generate, or verbatim transcript for speech; video lip-sync and relight and vector image-to-vector take none, and camera-controls, insert-video, recast, 3d-to-video, a Mureka soundtrack and a song with --lyrics (where it sets the style) 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, ...VECTOR_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. Vector from text: auto (default, the model's choice) or 1:4\u20134:1" },
-    { 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. Vector from text: up to 5, the first leading. 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: "model", type: "string", choices: assetModelIds, description: "Model for the chosen asset type. Vector: fal/ideogram-vector (default) or fal/gpt-image-2.6-vector. GIF: fal/gpt-image-2.6-gif (default, Flare, faster) or fal/gpt-image-2.6-sunburst-gif (finer, slower)" },
+    { name: "aspect-ratio", type: "string", choices: [.../* @__PURE__ */ new Set([...IMAGE_ASPECT_RATIOS, "auto", ...VIDEO_ASPECT_RATIOS, ...VECTOR_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. Vector from text: auto (default, the model's choice) or 1:4\u20134:1 (GPT Image 2.6 1:3\u20133:1). GIF: 1:1 (default), 3:2, 2:3, 16:9 or 9:16" },
+    { name: "transparent", type: "boolean", description: "Image or GIF: transparent background. Vector with --model fal/gpt-image-2.6-vector: leave out the background" },
+    { name: "references", type: "string", description: "Comma-separated blob SHAs of this project's images, GIFs (their first frame) or sprite art, named Image 1, Image 2\u2026 in the prompt. Image: up to 4 to follow, such as a character sheet. Vector from text (Ideogram): up to 5, the first leading. GIF: up to 4 to animate or follow. 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, ...VECTOR_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, HeyGen Video 1 and Seedance reference-to-video, as the model's videoProfiles allow. Vector: text-to-vector (default) or image-to-vector, which traces --source" },
-    { 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. Model: the image or sprite art to build it from (image-to-3D); without one the prompt describes it" },
+    { name: "reference", type: "string", description: "Video: starting image blob SHA from this project's assets (a GIF's SHA gives its first frame) or sprites; the speaking face for lip-sync, the image the camera moves around for camera-controls. Model: the image or sprite art to build it from (image-to-3D); without one the prompt describes it" },
     { 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" },
     { name: "middle-seconds", type: "number", description: "Reference-to-video: when the middle image is reached, in seconds" },
-    { name: "source", type: "string", description: "Blob SHA of a video asset in this project: the clip to extend, insert a scene into, recast or relight, or the 3D render 3d-to-video turns into footage. Vector image-to-vector: the image or sprite art to trace. Music with --model fal/mureka-9.5-soundtrack: the video (up to 100 MB), image or sprite art to score; a video's soundtrack runs as long as the video" },
+    { name: "source", type: "string", description: "Blob SHA of a video asset in this project: the clip to extend, insert a scene into, recast or relight, or the 3D render 3d-to-video turns into footage. Vector image-to-vector: the image, GIF (its first frame) or sprite art to trace. Music with --model fal/mureka-9.5-soundtrack: the video (up to 100 MB), image, GIF still or sprite art to score; a video's soundtrack runs as long as the video" },
     { name: "soundtrack", type: "string", description: "Video from an image or text: blob SHA of a music, speech or SFX asset pinned as the soundtrack (2 s or longer). Lip-sync: the speech to say (5 s\u201315 min), which sets the length" },
     { name: "audio-references", type: "string", description: "Extension or reference-to-video: up to 3 comma-separated audio asset blob SHAs (on fal and Seedance 2\u201315 s each, 15 s total; Seedance 2.5 30 s) 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 (on fal 2\u201315 s each, 15 s total; HeyGen reads the first 5 s of each) guiding motion, named Video 1, Video 2\u2026 in the prompt" },
@@ -51370,7 +51502,9 @@ Confirm code: ${device.user_code}`);
     { name: "splats", type: "number", description: "Model with --model idol: how many Gaussian splats, 32,768\u20131,048,576 (default 262,144)" },
     { name: "photo", type: "boolean", description: "Model with --model idol: --reference is a camera photo, cropped more loosely than a render or generated image" },
     { name: "prompt-influence", type: "number", description: "SFX: prompt adherence, 0\u20131 (default 0.3)" },
-    { name: "quality", type: "string", choices: VECTOR_QUALITIES, description: "Vector from text: low (fastest, 13 credits), medium (default, 16) or high (20, or 32 with --references)" },
+    { name: "quality", type: "string", choices: [.../* @__PURE__ */ new Set([...VECTOR_QUALITIES, ...GIF_QUALITIES])], description: "Vector from text: low (fastest), medium (default) or high; Ideogram 13, 16 or 20 credits (32 at high with --references), GPT Image 2.6 holds 8, 12 or 22 and is charged fal's metered tokens. GIF: low, medium (default) or high detail in every frame" },
+    { name: "frames", type: "number", description: `GIF: how many frames, ${GIF_FRAMES.min}\u2013${GIF_FRAMES.max} (default ${GIF_FRAMES.default}); all frames share one picture's pixels, so more frames make each smaller (catalog --type gif lists the sizes)` },
+    { name: "frame-ms", type: "number", description: `GIF: how long each frame shows, ${GIF_FRAME_MS.min}\u2013${GIF_FRAME_MS.max} ms (default ${GIF_FRAME_MS.default}), rounded to 10 ms` },
     { name: "shapes", type: "string", choices: VECTOR_SHAPES, description: "Vector image-to-vector (10 credits): detailed (default) keeps fine detail, simple uses fewer, simpler shapes" },
     ...assetAuthorizationFlags,
     ...assetWaitFlags,
@@ -51391,7 +51525,7 @@ Confirm code: ${device.user_code}`);
     const result = await submitAssetBatch(new Client(flags.url, signal), args.id, await assetsFromBatchFile(flags.file, flags.model), flags, signal);
     out(stdout, result);
     if (result.error) throw new Error(result.error);
-  }))).add(defineCommand("download", { description: "Download a saved asset by id; refuses to overwrite" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "asset", type: "string", required: true, description: "Asset id from assets list" }).flags({ name: "output", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => out(stdout, await downloadAsset(new Client(flags.url, signal), args.id, args.asset, flags.output)))))).command("avatars", (avatars) => avatars.add(defineCommand("list", { description: "List HeyGen avatar characters: the public catalog, or --ownership private for this project's own" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "ownership", type: "string", choices: AVATAR_OWNERSHIPS, default: "public" }, { name: "limit", type: "number", default: 20, description: "Avatars per page, 1\u201350" }, { name: "token", type: "string", description: "nextToken from the previous page" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}?${new URLSearchParams({ ownership: flags.ownership, limit: String(flags.limit), ...flags.token ? { token: flags.token } : {} })}`))))).add(defineCommand("looks", { description: "List an avatar's looks with --group, or HeyGen's public looks; a look ID is what HeyGen renders with" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "group", type: "string", description: "Avatar group ID: one of this project's or a public one" }, { name: "avatar-type", type: "string", choices: AVATAR_LOOK_TYPES }, { name: "limit", type: "number", default: 20, description: "Looks per page, 1\u201350" }, { name: "token", type: "string", description: "nextToken from the previous page" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/looks?${new URLSearchParams({ limit: String(flags.limit), ...flags.group ? { groupId: flags.group } : {}, ...flags["avatar-type"] ? { avatarType: flags["avatar-type"] } : {}, ...flags.token ? { token: flags.token } : {} })}`))))).add(defineCommand("get", { description: "Show one avatar group (--group) or look (--look), with status and consent" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "group", type: "string" }, { name: "look", type: "string" }).action(async ({ args, flags, stdout, signal }) => {
+  }))).add(defineCommand("download", { description: "Download a saved asset by id; refuses to overwrite" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "asset", type: "string", required: true, description: "Asset id from assets list" }).flags({ name: "output", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => out(stdout, await downloadAsset(new Client(flags.url, signal), args.id, args.asset, flags.output)))))).command("avatars", (avatars) => avatars.add(defineCommand("list", { description: "List HeyGen avatar characters: the public catalog, or --ownership private for this workspace's own, which all its projects share" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "ownership", type: "string", choices: AVATAR_OWNERSHIPS, default: "public" }, { name: "limit", type: "number", default: 20, description: "Avatars per page, 1\u201350" }, { name: "token", type: "string", description: "nextToken from the previous page" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}?${new URLSearchParams({ ownership: flags.ownership, limit: String(flags.limit), ...flags.token ? { token: flags.token } : {} })}`))))).add(defineCommand("looks", { description: "List an avatar's looks with --group, or HeyGen's public looks; a look ID is what HeyGen renders with" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "group", type: "string", description: "Avatar group ID: one of this workspace's or a public one" }, { name: "avatar-type", type: "string", choices: AVATAR_LOOK_TYPES }, { name: "limit", type: "number", default: 20, description: "Looks per page, 1\u201350" }, { name: "token", type: "string", description: "nextToken from the previous page" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/looks?${new URLSearchParams({ limit: String(flags.limit), ...flags.group ? { groupId: flags.group } : {}, ...flags["avatar-type"] ? { avatarType: flags["avatar-type"] } : {}, ...flags.token ? { token: flags.token } : {} })}`))))).add(defineCommand("get", { description: "Show one avatar group (--group) or look (--look), with status and consent" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "group", type: "string" }, { name: "look", type: "string" }).action(async ({ args, flags, stdout, signal }) => {
     if (Boolean(flags.group) === Boolean(flags.look)) throw new Error("Pass --group or --look.");
     out(stdout, await new Client(flags.url, signal).request(flags.look ? `${avatarsPath(args.id)}/looks/${encodeURIComponent(flags.look)}` : `${avatarsPath(args.id)}/${encodeURIComponent(flags.group)}`));
   }))).add(defineCommand("templates", { description: "List HeyGen Look Packs and look templates with their female and male IDs" }, (command) => command.action(({ stdout }) => out(stdout, { templates: AVATAR_LOOK_TEMPLATES })))).add(defineCommand("create", { description: "Create a HeyGen avatar from a prompt, a photo or footage (digital_twin); --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
@@ -51399,19 +51533,32 @@ Confirm code: ${device.user_code}`);
     { name: "name", type: "string", required: true },
     { name: "prompt", type: "string", description: "Prompt: the character, wardrobe, setting and light, up to 1000 characters" },
     { name: "aspect-ratio", type: "string", choices: AVATAR_ASPECT_RATIOS, description: "Prompt: image shape (default auto)" },
-    { name: "look", type: "string", description: "Prompt: one of this project's looks to put in a new outfit or setting" },
+    { name: "look", type: "string", description: "Prompt: one of this workspace's looks to put in a new outfit or setting" },
     { name: "reference-images", type: "string", description: "Prompt: up to 3 comma-separated wardrobe or style references (project image SHA, HTTPS URL or local file)" },
     { name: "file", type: "string", description: "Photo or digital_twin: project image/video SHA, HTTPS URL (up to 32 MB) or local file (up to 8 MB)" },
-    { name: "group", type: "string", description: "Add the result to one of this project's avatar groups" },
+    { name: "group", type: "string", description: "Add the result to one of this workspace's avatar groups" },
     { name: "subject-consent", type: "boolean", description: "Photo or digital_twin: confirm the person shown agreed to become an avatar" },
     ...assetAuthorizationFlags
-  ).action(async ({ args, flags, stdout, signal }) => out(stdout, await submitAvatar(new Client(flags.url, signal), args.id, await avatarFromFlags(flags), flags))))).add(defineCommand("add-looks", { description: "Apply a Look Pack (five looks) or look template (two) to one of this project's looks; --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
-    { name: "look", type: "string", required: true, description: "Reference look ID from this project's avatars" },
+  ).action(async ({ args, flags, stdout, signal }) => out(stdout, await submitAvatar(new Client(flags.url, signal), args.id, await avatarFromFlags(flags), flags))))).add(defineCommand("add-looks", { description: "Apply a Look Pack (five looks) or look template (two) to one of this workspace's looks; --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
+    { name: "look", type: "string", required: true, description: "Reference look ID from this workspace's avatars" },
     { name: "template", type: "string", required: true, description: "Template ID from avatars templates" },
     { name: "method", type: "string", choices: AVATAR_LOOK_METHODS, description: "Needed only for templates outside the gallery" },
     { name: "aspect-ratio", type: "string", choices: LOOK_PACK_ASPECT_RATIOS, description: "Look Pack: 16:9 (default) or 9:16, cropped to portrait" },
     ...assetAuthorizationFlags
-  ).action(async ({ args, flags, stdout, signal }) => out(stdout, await submitLooks(new Client(flags.url, signal), args.id, looksFromFlags(flags), flags))))).add(defineCommand("wait", { description: "Wait until HeyGen finishes a new look; fail if it fails or times out" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "look", type: "string", required: true, description: "Look ID from avatars create or add-looks" }).flags({ name: "timeout", type: "number", default: 900, description: "Maximum seconds to wait" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await waitForLook(new Client(flags.url, signal), args.id, args.look, flags.timeout, signal))))).add(defineCommand("rename", { description: "Rename one of this project's photo avatar or digital twin looks" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "look", type: "string", required: true }).flags({ name: "name", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/looks/${encodeURIComponent(args.look)}`, { method: "PATCH", body: { name: flags.name } }))))).add(defineCommand("voice", { description: "Set the default voice of one of this project's avatars" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "group", type: "string", required: true }).flags({ name: "voice", type: "string", required: true, description: "HeyGen voice ID" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/${encodeURIComponent(args.group)}`, { method: "PATCH", body: { defaultVoiceId: flags.voice } }))))).add(defineCommand("consent", { description: "Get a 24-hour link where the person in a digital twin records consent" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "group", type: "string", required: true }).flags({ name: "reroute-url", type: "string", description: "HTTPS page to send the person to afterwards" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/${encodeURIComponent(args.group)}/consent`, { method: "POST", body: flags["reroute-url"] ? { rerouteUrl: flags["reroute-url"] } : {} }))))).add(defineCommand("delete", { description: "Permanently delete one of this project's avatars (--group, with every look) or one look (--look); requires --yes" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "group", type: "string" }, { name: "look", type: "string" }, { name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
+  ).action(async ({ args, flags, stdout, signal }) => out(stdout, await submitLooks(new Client(flags.url, signal), args.id, looksFromFlags(flags), flags))))).add(defineCommand("wait", { description: "Wait until HeyGen finishes a new look; fail if it fails or times out" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "look", type: "string", required: true, description: "Look ID from avatars create or add-looks" }).flags({ name: "timeout", type: "number", default: 900, description: "Maximum seconds to wait" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await waitForLook(new Client(flags.url, signal), args.id, args.look, flags.timeout, signal))))).add(defineCommand("rename", { description: "Rename one of this workspace's photo avatar or digital twin looks" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "look", type: "string", required: true }).flags({ name: "name", type: "string", required: true }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/looks/${encodeURIComponent(args.look)}`, { method: "PATCH", body: { name: flags.name } }))))).add(defineCommand("voice", { description: "Set the default voice of one of this workspace's avatars: a public voice or one of its own cloned voices" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "group", type: "string", required: true }).flags({ name: "voice", type: "string", required: true, description: "Voice ID from avatars voices" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/${encodeURIComponent(args.group)}`, { method: "PATCH", body: { defaultVoiceId: flags.voice } }))))).add(defineCommand("voices", { description: "List voices an avatar can speak with: HeyGen's public library, or --ownership private for those cloned from this workspace's digital twins" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "ownership", type: "string", choices: AVATAR_OWNERSHIPS, default: "public" }, { name: "language", type: "string", description: "Public voices in one language, such as English or Turkish" }, { name: "gender", type: "string", choices: ["male", "female"] }, { name: "limit", type: "number", default: 20, description: "Voices per page, 1\u201350" }, { name: "token", type: "string", description: "nextToken from the previous page" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/voices?${new URLSearchParams({ ownership: flags.ownership, limit: String(flags.limit), ...flags.language ? { language: flags.language } : {}, ...flags.gender ? { gender: flags.gender } : {}, ...flags.token ? { token: flags.token } : {} })}`))))).add(defineCommand("video", { description: "Make a video of an avatar look speaking a script or lip-syncing saved audio, saved to the project; --yes authorizes credits" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags(
+    { name: "look", type: "string", required: true, description: "A completed look ID: one of this workspace's avatars or a public one" },
+    { name: "name", type: "string", required: true, description: "Name of the saved video" },
+    { name: "script", type: "string", description: `What the avatar says, up to ${AVATAR_SCRIPT_MAX} characters` },
+    { name: "script-file", type: "string", description: "Read the script from a UTF-8 text file" },
+    { name: "audio", type: "string", description: `Instead of a script: the file SHA of saved speech or music to lip-sync, up to ${AVATAR_VIDEO_MAX_SECONDS} seconds` },
+    { name: "voice", type: "string", description: "Voice for the script (avatars voices); the look's own voice by default" },
+    { name: "model", type: "string", choices: AVATAR_VIDEO_MODEL_IDS, description: "Rendering engine the look supports (default heygen/avatar-iv)" },
+    { name: "aspect-ratio", type: "string", choices: AVATAR_ASPECT_RATIOS, description: "auto (the look's shape, default), 16:9, 9:16, 1:1, 4:5 or 5:4" },
+    { name: "resolution", type: "string", choices: AVATAR_VIDEO_RESOLUTIONS, description: "720p or 1080p (default)" },
+    { name: "motion-prompt", type: "string", description: "Body and hand movement: photo avatars on Avatar IV, any look on Avatar V" },
+    { name: "expressiveness", type: "string", choices: AVATAR_EXPRESSIVENESS, description: "Photo avatars on Avatar IV: how much they move" },
+    ...assetAuthorizationFlags
+  ).action(async ({ args, flags, stdout, signal }) => out(stdout, await submitAvatarVideo(new Client(flags.url, signal), args.id, await avatarVideoFromFlags(flags), flags))))).add(defineCommand("consent", { description: "Get a 24-hour link where the person in a digital twin records consent" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id, { name: "group", type: "string", required: true }).flags({ name: "reroute-url", type: "string", description: "HTTPS page to send the person to afterwards" }).action(async ({ args, flags, stdout, signal }) => out(stdout, await new Client(flags.url, signal).request(`${avatarsPath(args.id)}/${encodeURIComponent(args.group)}/consent`, { method: "POST", body: flags["reroute-url"] ? { rerouteUrl: flags["reroute-url"] } : {} }))))).add(defineCommand("delete", { description: "Permanently delete one of this workspace's avatars (--group, with every look and its cloned voice) or one look (--look); requires --yes" }, (command) => command.flags({ name: "url", type: "string", default: "https://animaguru.com", env: { name: "ANIMAGURU_URL" } }).args(id).flags({ name: "group", type: "string" }, { name: "look", type: "string" }, { name: "yes", type: "boolean", required: true }).action(async ({ args, flags, stdout, signal }) => {
     if (Boolean(flags.group) === Boolean(flags.look)) throw new Error("Pass --group or --look.");
     if (!flags.yes) throw new Error("Pass --yes to delete the avatar for good.");
     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" }));