@docyrus/animaguru 0.35.1 → 0.38.0

package/dist/animaguru.js

@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.35.1",
+  version: "0.38.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" } },
@@ -45013,7 +45015,11 @@ var SPRITE_IMAGE_MODELS = [
   { id: "bytedance/seedream-5-pro", label: "Seedream 5 Pro", provider: "workers-ai", edit: true, maxImages: 10, relCost: 1.5 },
   { id: "xai/grok-imagine-image-2.0", label: "Grok Imagine Image 2.0", provider: "workers-ai", edit: true, maxImages: 5, relCost: 1 },
   { id: "alibaba/qwen-image-3.0-pro", label: "Qwen Image 3.0 Pro", provider: "workers-ai", edit: false, maxImages: 0, relCost: 0.5 },
-  { id: "krea/krea-2-medium-turbo", label: "Krea 2 Medium Turbo", provider: "workers-ai", edit: false, maxImages: 0, relCost: 0.25 }
+  { id: "krea/krea-2-medium-turbo", label: "Krea 2 Medium Turbo", provider: "workers-ai", edit: false, maxImages: 0, relCost: 0.25 },
+  // Seedream on AnimaGuru's own BytePlus account: $0.045 an image (Pro, up to 2.61 MP), $0.018 (Flash), $0.035 (Lite).
+  { id: "byteplus/seedream-5.0-pro", label: "Seedream 5.0 Pro (BytePlus)", provider: "byteplus", providerModel: "dola-seedream-5-0-pro-260628", edit: true, spriteBackupCutout: true, maxImages: 10, relCost: 0.35 },
+  { id: "byteplus/seedream-5.0-flash", label: "Seedream 5.0 Flash (BytePlus)", provider: "byteplus", providerModel: "dola-seedream-5-0-flash-260915", edit: true, spriteBackupCutout: true, maxImages: 10, relCost: 0.15 },
+  { id: "byteplus/seedream-5.0-lite", label: "Seedream 5.0 Lite (BytePlus)", provider: "byteplus", providerModel: "seedream-5-0-260128", edit: true, spriteBackupCutout: true, maxImages: 14, relCost: 0.3 }
 ];
 var SPRITE_IMAGE_MODEL_IDS = SPRITE_IMAGE_MODELS.map((m) => m.id);
 function spriteImageModel(id2) {
@@ -45048,6 +45054,8 @@ var HEYGEN_LONG = { max: 30, creditsPerSecond: { "480p": 4.5, "768p": 7.5, "1080
 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 SEEDANCE_WORKFLOWS = ["image-to-video", "text-to-video", "reference-to-video"];
+var SEEDANCE_REFERENCES = { referencesOnly: true, mediaReferences: ["images", "audio"] };
 var SPRITE_VIDEO_MODELS = [
   {
     id: "pruna/p-video-2-pro",
@@ -45145,6 +45153,59 @@ var SPRITE_VIDEO_MODELS = [
     promptExpansion: ["balanced", "quality"],
     estimatedCreditsPerSecond: { "720p": { quality: 17 }, "1080p": { quality: 29 } },
     seconds: { min: 5, max: 20 }
+  },
+  // BytePlus bills a clip's tokens (width × height × frames / 1024, at 24 fps plus a frame); credits take each resolution's largest shape.
+  {
+    id: "byteplus/seedance-2.5",
+    label: "Seedance 2.5 (BytePlus)",
+    provider: "byteplus",
+    providerModel: "dreamina-seedance-2-5-260628",
+    workflows: SEEDANCE_WORKFLOWS,
+    resolutions: ["480p", "720p"],
+    workflowOptions: { "reference-to-video": { ...SEEDANCE_REFERENCES, mediaSeconds: 30 } },
+    modes: ["quality"],
+    lastFrame: true,
+    estimatedCreditsPerSecond: { "480p": { quality: 10.86 }, "720p": { quality: 23.51 } },
+    seconds: { min: 4, max: 30 }
+  },
+  {
+    id: "byteplus/seedance-2.0",
+    label: "Seedance 2.0 (BytePlus)",
+    provider: "byteplus",
+    providerModel: "dreamina-seedance-2-0-260128",
+    workflows: SEEDANCE_WORKFLOWS,
+    resolutions: ["480p", "720p", "1080p"],
+    workflowOptions: { "reference-to-video": { ...SEEDANCE_REFERENCES, audioNeedsImages: true } },
+    modes: ["quality"],
+    lastFrame: true,
+    estimatedCreditsPerSecond: { "480p": { quality: 7.11 }, "720p": { quality: 15.38 }, "1080p": { quality: 38.06 } },
+    seconds: { min: 4, max: 15 }
+  },
+  {
+    id: "byteplus/seedance-2.0-fast",
+    label: "Seedance 2.0 Fast (BytePlus)",
+    provider: "byteplus",
+    providerModel: "dreamina-seedance-2-0-fast-260128",
+    workflows: SEEDANCE_WORKFLOWS,
+    resolutions: ["480p", "720p"],
+    workflowOptions: { "reference-to-video": { ...SEEDANCE_REFERENCES, audioNeedsImages: true } },
+    modes: ["speed"],
+    lastFrame: true,
+    estimatedCreditsPerSecond: { "480p": { speed: 5.69 }, "720p": { speed: 12.3 } },
+    seconds: { min: 4, max: 15 }
+  },
+  {
+    id: "byteplus/seedance-2.0-mini",
+    label: "Seedance 2.0 Mini (BytePlus)",
+    provider: "byteplus",
+    providerModel: "dreamina-seedance-2-0-mini-260615",
+    workflows: SEEDANCE_WORKFLOWS,
+    resolutions: ["480p", "720p"],
+    workflowOptions: { "reference-to-video": { ...SEEDANCE_REFERENCES, audioNeedsImages: true } },
+    modes: ["cost"],
+    lastFrame: true,
+    estimatedCreditsPerSecond: { "480p": { cost: 3.56 }, "720p": { cost: 7.69 } },
+    seconds: { min: 4, max: 15 }
   }
 ];
 var SPRITE_VIDEO_MODEL_IDS = SPRITE_VIDEO_MODELS.map((m) => m.id);
@@ -45273,7 +45334,7 @@ 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",
@@ -46914,6 +46975,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 = [
   {
@@ -46983,20 +47168,50 @@ 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" },
-  { id: "gemini-3.8-flash-lite-tts", label: "Gemini 3.8 Flash-Lite TTS" },
-  { id: "eleven_v4", label: "ElevenLabs v4" },
-  { id: "eleven_v4_turbo", label: "ElevenLabs v4 Turbo" }
+  { 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" },
+  { id: "eleven_v4", label: "ElevenLabs v4", provider: "elevenlabs" },
+  { id: "eleven_v4_turbo", label: "ElevenLabs v4 Turbo", provider: "elevenlabs" },
+  { id: "heygen-voice-1", label: "HeyGen Voice 1", provider: "heygen" },
+  { id: "heygen-voice-1-turbo", label: "HeyGen Voice 1 Turbo", provider: "heygen" }
 ];
 var ELEVENLABS_SPEECH_MODEL_IDS = ["eleven_v4", "eleven_v4_turbo"];
+var HEYGEN_SPEECH_MODEL_IDS = ["heygen-voice-1", "heygen-voice-1-turbo"];
 var SFX_MODELS = [{ id: "eleven_text_to_sound_v2", label: "ElevenLabs Sound Effects v2" }];
 var DEFAULT_ELEVENLABS_VOICE = "JBFqnCBsd6RMkjVDRZzb";
 var ELEVENLABS_VOICES = [{ id: DEFAULT_ELEVENLABS_VOICE, label: "George" }];
 var isElevenLabsSpeech = (model) => ELEVENLABS_SPEECH_MODEL_IDS.includes(model);
-var MUSIC_MODELS = [{ id: "lyria-3.5", label: "Lyria 3.5" }];
+var isHeyGenSpeech = (model) => HEYGEN_SPEECH_MODEL_IDS.includes(model);
+var DEFAULT_HEYGEN_VOICE = "83548de556df48ba8c09c42a57c51d85";
+var HEYGEN_VOICES = [
+  { id: DEFAULT_HEYGEN_VOICE, label: "Nadine \xB7 Calm & Gentle" },
+  { id: "75300849b571414c8d62693289cb6509", label: "Sabrina \xB7 Upbeat & Lively" },
+  { id: "aa9746e325ff46d482a54fe5bc87890f", label: "Meredith \xB7 Serious & Composed" },
+  { id: "fe333747c7d04a7188d20a8ea2a222d9", label: "Claire \xB7 Rich & Expressive" },
+  { id: "7e48c8d406b04a8089c5eb3cd057cb2e", label: "Jonah \xB7 Clear & Professional" },
+  { id: "826be797681d4b1a92042b54b3c75c64", label: "Gareth \xB7 Conversational & Easygoing" },
+  { id: "9b71011176ac49ee8d0936c36566d665", label: "Hugh \xB7 Firm & Measured" },
+  { id: "7bb4df56d7714d33bb88ed1dde8128f6", label: "Rory \xB7 Upbeat & Lively" }
+];
 var SPEECH_VOICES = ["Kore", "Puck", "Charon", "Fenrir", "Aoede", "Leda", "Orus", "Zephyr"];
+var defaultSpeechVoice = (model) => isElevenLabsSpeech(model) ? DEFAULT_ELEVENLABS_VOICE : isHeyGenSpeech(model) ? DEFAULT_HEYGEN_VOICE : "Kore";
+var speechVoiceValid = (model, voice) => isElevenLabsSpeech(model) ? /^[a-zA-Z0-9]{20}$/.test(voice) : isHeyGenSpeech(model) ? /^[A-Za-z0-9_]{8,64}$/.test(voice) : SPEECH_VOICES.includes(voice);
+var MUSIC_MODELS = [
+  { id: "lyria-3.5", label: "Lyria 3.5", provider: "google" },
+  { id: "fal/mureka-9.5-song", label: "Mureka 9.5 Song", provider: "fal" },
+  { id: "fal/mureka-9.5-instrumental", label: "Mureka 9.5 Instrumental", provider: "fal" },
+  { id: "fal/mureka-9.5-soundtrack", label: "Mureka 9.5 Soundtrack", provider: "fal" }
+];
+var MUSIC_MODEL_IDS = ["lyria-3.5", "fal/mureka-9.5-song", "fal/mureka-9.5-instrumental", "fal/mureka-9.5-soundtrack"];
+var MUREKA_STYLES = ["pop", "rock", "jazz", "r&b", "edm", "ambient", "folk", "latin", "k-pop", "j-pop", "house", "gospel", "lo-fi"];
+var MUREKA_VOCALS = ["female", "male"];
+var MAX_SONG_LYRICS = 5e3;
+var SONG_SECONDS = { min: 120, max: 300 };
+var SONG_LENGTH = `Choose a length of ${SONG_SECONDS.min}\u2013${SONG_SECONDS.max} whole seconds.`;
+var SOUNDTRACK_IMAGE_MAX_BYTES = 50 * 1024 * 1024;
+var SOUNDTRACK_VIDEO_MAX_BYTES = 100 * 1024 * 1024;
 var base = { name: external_exports.string().trim().min(1).max(80), prompt: external_exports.string().trim().min(3).max(4e3) };
 var blob = external_exports.string().regex(/^[a-f0-9]{64}$/);
 var cameraKeyframe = external_exports.object({
@@ -47197,6 +47412,12 @@ function videoChecks(p, ctx) {
     if (options?.referencesOnly) {
       for (const field of ["reference", "endReference", "middleReference"]) if (p[field]) issue2(field, "This video model's reference-to-video takes references only, without a first, last or middle frame.");
     }
+    const kinds = options?.mediaReferences;
+    const files = [["images", "references", references.length], ["videos", "referenceVideos", p.referenceVideos?.length ?? 0], ["audio", "audioReferences", p.audioReferences.length]];
+    if (kinds) {
+      for (const [kind, field, count] of files) if (count && !kinds.includes(kind)) issue2(field, `This video model's reference-to-video takes reference ${kinds.join(" and ")}, not ${kind}.`);
+    }
+    if (options?.audioNeedsImages && p.audioReferences.length && !references.length && !p.referenceVideos?.length) issue2("audioReferences", "This video model needs a reference image beside reference audio.");
     if (references.length + (p.referenceVideos?.length ?? 0) + p.audioReferences.length > MAX_REFERENCE_FILES) issue2("references", `reference-to-video takes at most ${MAX_REFERENCE_FILES} reference files in all.`);
     const frames = !options?.referencesOnly && (p.reference || p.endReference);
     if (!references.length && !p.referenceVideos?.length && !p.audioReferences.length && !frames) issue2("references", `reference-to-video needs reference images, videos or audio${options?.referencesOnly ? "" : ", or a first or last frame"}.`);
@@ -47230,6 +47451,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([]);
@@ -47247,10 +47469,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;
@@ -47260,7 +47485,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(),
@@ -47273,11 +47498,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.");
@@ -47289,7 +47527,93 @@ 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. */
+  prompt: external_exports.string().trim().max(4e3).default(""),
+  type: external_exports.literal("music"),
+  model: external_exports.enum(MUSIC_MODEL_IDS).default("lyria-3.5"),
+  /** Mureka Song: the words to sing. */
+  lyrics: external_exports.string().trim().min(1).max(MAX_SONG_LYRICS).optional(),
+  /** Mureka Song written from the prompt: its genres. */
+  styles: external_exports.array(external_exports.enum(MUREKA_STYLES)).min(1).max(MUREKA_STYLES.length).optional(),
+  /** Mureka Song sung from lyrics: who sings. */
+  vocals: external_exports.enum(MUREKA_VOCALS).optional(),
+  /** Mureka Song: about how long, in whole seconds; the model chooses when it's left out. */
+  seconds: external_exports.number().int(SONG_LENGTH).min(SONG_SECONDS.min, SONG_LENGTH).max(SONG_SECONDS.max, SONG_LENGTH).optional(),
+  /** Mureka Soundtrack: the saved image or video to score. */
+  source: blob.optional()
+});
+var MUSIC_ONLY = {
+  lyrics: ["fal/mureka-9.5-song", "Only Mureka 9.5 Song sings lyrics."],
+  styles: ["fal/mureka-9.5-song", "Only Mureka 9.5 Song takes styles; describe the genre in the prompt."],
+  vocals: ["fal/mureka-9.5-song", "Only Mureka 9.5 Song takes vocals."],
+  seconds: ["fal/mureka-9.5-song", "Only Mureka 9.5 Song takes a length; the other music models choose their own."],
+  source: ["fal/mureka-9.5-soundtrack", "Only Mureka 9.5 Soundtrack scores a saved image or video."]
+};
+function musicChecks(p, ctx) {
+  const issue2 = (path, message) => ctx.addIssue({ code: "custom", message, path: [path] });
+  for (const [field, [model, message]] of Object.entries(MUSIC_ONLY)) if (p[field] !== void 0 && p.model !== model) issue2(field, message);
+  const most = (max2) => {
+    if (p.prompt.length > max2) issue2("prompt", `Describe the music in at most ${max2.toLocaleString("en-US")} characters.`);
+  };
+  if (p.model === "fal/mureka-9.5-song") {
+    if (p.lyrics) {
+      most(1024);
+      if (p.styles) issue2("styles", "A song sung from lyrics takes its style from the prompt; leave out styles.");
+    } else {
+      if (p.prompt.length < 3) issue2("prompt", "Describe the song in at least 3 characters, or give lyrics to sing.");
+      most(2e3);
+      if (p.vocals) issue2("vocals", "Vocals choose who sings lyrics; describe the singer in the prompt instead.");
+    }
+    if (p.styles && new Set(p.styles).size !== p.styles.length) issue2("styles", "Choose each style once.");
+    return;
+  }
+  if (p.model === "fal/mureka-9.5-soundtrack") {
+    if (!p.source) issue2("source", "Choose a saved image or video to score.");
+    return most(1024);
+  }
+  if (p.prompt.length < 3) issue2("prompt", "Describe the music in at least 3 characters.");
+  if (p.model === "fal/mureka-9.5-instrumental") most(1024);
+}
+function musicCostUsd(p) {
+  if (p.model === "lyria-3.5") return 0.08;
+  if (p.model === "fal/mureka-9.5-song") return p.lyrics ? 0.15 : 0.5;
+  return p.model === "fal/mureka-9.5-instrumental" ? 0.15 : 0.11;
+}
 var animationClip = external_exports.union([external_exports.enum(MODEL_ANIMATION_IDS), external_exports.number().int().min(0).max(MAX_MESHY_ACTION)]);
 var modelAsset = external_exports.object({
   name: base.name,
@@ -47346,24 +47670,31 @@ var modelDefaults = (p) => ({ ...p, animations: p.rig && !p.animations.length ?
 var assetRequest = external_exports.discriminatedUnion("type", [
   imageAsset.superRefine(imageChecks),
   videoAsset.superRefine(videoChecks).transform(videoDefaults),
-  external_exports.object({ ...base, type: external_exports.literal("music"), model: external_exports.literal("lyria-3.5").default("lyria-3.5") }),
-  external_exports.object({ ...base, type: external_exports.literal("speech"), model: external_exports.enum(["gemini-3.8-flash-tts", "gemini-3.8-flash-lite-tts", ...ELEVENLABS_SPEECH_MODEL_IDS]).default("gemini-3.8-flash-lite-tts"), voice: external_exports.string().trim().max(80).default(""), delivery: external_exports.string().trim().max(600).default("") }).superRefine((p, ctx) => {
-    if (p.voice && (isElevenLabsSpeech(p.model) ? !/^[a-zA-Z0-9]{20}$/.test(p.voice) : !SPEECH_VOICES.includes(p.voice))) ctx.addIssue({ code: "custom", message: "Choose a voice supported by the speech provider.", path: ["voice"] });
+  musicAsset.superRefine(musicChecks),
+  external_exports.object({ ...base, type: external_exports.literal("speech"), model: external_exports.enum(["gemini-3.8-flash-tts", "gemini-3.8-flash-lite-tts", ...ELEVENLABS_SPEECH_MODEL_IDS, ...HEYGEN_SPEECH_MODEL_IDS]).default("gemini-3.8-flash-lite-tts"), voice: external_exports.string().trim().max(80).default(""), delivery: external_exports.string().trim().max(600).default("") }).superRefine((p, ctx) => {
+    if (p.voice && !speechVoiceValid(p.model, p.voice)) ctx.addIssue({ code: "custom", message: "Choose a voice supported by the speech provider.", path: ["voice"] });
     if (isElevenLabsSpeech(p.model) && p.delivery) ctx.addIssue({ code: "custom", message: "ElevenLabs uses audio tags in the transcript; separate delivery instructions are only supported by Gemini.", path: ["delivery"] });
-  }).transform((p) => ({ ...p, voice: p.voice || (isElevenLabsSpeech(p.model) ? DEFAULT_ELEVENLABS_VOICE : "Kore") })),
+    if (isHeyGenSpeech(p.model) && p.delivery) ctx.addIssue({ code: "custom", message: "HeyGen Voice speaks the transcript as written; separate delivery instructions are only supported by Gemini.", path: ["delivery"] });
+  }).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") {
@@ -47383,11 +47714,13 @@ 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 80;
+  if (p.type === "music") return Math.ceil(musicCostUsd(p) / 1e-3);
   const units = (credits) => Math.max(1, Math.ceil(credits * UNITS_PER_CREDIT));
   if (p.type === "sfx") return units(Math.max(0, p.seconds) * 0.2);
+  if (isHeyGenSpeech(p.model)) return units(speechCharacters(p.prompt) * (p.model === "heygen-voice-1-turbo" ? 0.4 : 1.5) / 1e3);
   if (isElevenLabsSpeech(p.model)) {
     const promotion2 = now < Date.UTC(2026, 9, 13);
     const perThousandCharacters = p.model === "eleven_v4_turbo" ? promotion2 ? 1.1 : 4 : promotion2 ? 2.2 : 8;
@@ -47411,7 +47744,7 @@ var VIDEO_PART_BYTES = 8 * 1024 * 1024;
 var VIDEO_MAX_BYTES = { html5: 64 * 1024 * 1024, mp4: 512 * 1024 * 1024 };
 var VIDEO_LIBRARY_BYTES = { user: 2 * 1024 ** 3, team: 10 * 1024 ** 3 };
 var VIDEO_VISIBILITIES = ["private", "public"];
-var VIDEO_SHARING_AGREEMENT_VERSION = "2026-10-15-draft-2";
+var VIDEO_SHARING_AGREEMENT_VERSION = "2026-11-02";
 var videoAgreementAcceptance = external_exports.object({
   version: external_exports.literal(VIDEO_SHARING_AGREEMENT_VERSION),
   language: external_exports.enum(["en", "tr"])
@@ -48067,7 +48400,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.");
@@ -48234,7 +48567,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 {
@@ -48252,7 +48585,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);
@@ -48310,7 +48643,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);
@@ -48361,7 +48694,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 });
@@ -48652,18 +48985,20 @@ var extras = {
     "style",
     "damage"
   ],
-  music: [],
+  music: ["lyrics", "styles", "vocals", "seconds", "source"],
   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) {
-  if (type === "music") return "Music accepts only --name, --prompt and --model; the model chooses the length, so fit it during the edit.";
   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;
@@ -48693,9 +49028,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());
   }
-  if (flags.type !== "video" && flags.type !== "vector" && !(flags.type === "model" && (flags.reference || isSplatGenerator(flags.model ?? ""))) && 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" : ""}.`);
+  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 ${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") {
@@ -48733,8 +49069,10 @@ 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) {
@@ -48830,6 +49168,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",
@@ -48949,96 +49288,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) {
@@ -49073,6 +49322,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.");
 }
@@ -49086,6 +49353,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;
@@ -50829,7 +51101,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" }
@@ -50842,14 +51114,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"],
-  speech: ["assetTypes", "speechModels", "voices", "elevenLabsVoices"],
+  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), 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, 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" }
 ];
@@ -51096,7 +51377,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);
@@ -51167,23 +51448,23 @@ 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 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, ...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: "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. 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 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: "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 (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" },
+    { 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 2\u201315 s each, 15 s total) guiding the sound; refer to them as Audio 1, Audio 2\u2026 in the prompt" },
+    { 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" },
     { 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' },
@@ -51197,14 +51478,17 @@ 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), FLUX 3 Max 5\u201320 whole seconds, HeyGen Video 1 5\u201315 (up to 30 from an image or text with --prompt-expansion balanced or quality); 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, SFX or song duration in seconds (default 5; a Mureka song picks its own); H3 takes fractions (6.5), FLUX 3 Max 5\u201320 whole seconds, HeyGen Video 1 5\u201315 (up to 30 from an image or text with --prompt-expansion balanced or quality), Seedance 4\u201315 whole seconds (2.5 up to 30); 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; Mureka 9.5 Song 120\u2013300 whole seconds" },
     { 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. FLUX 3 Max always reasons about the prompt: quality thoroughly, any other value lightly. HeyGen Video 1 needs balanced or quality for clips over 15 s" },
     { name: "seed", type: "number", description: "Video, vector from text, or model with --model idol: 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)" },
-    { name: "delivery", type: "string", description: "Gemini speech delivery instructions; ElevenLabs uses audio tags in the transcript" },
+    { name: "voice", type: "string", description: "Gemini voice name, or an ElevenLabs or HeyGen public voice ID (defaults: Kore / George / Nadine; catalog --type speech suggests more)" },
+    { name: "delivery", type: "string", description: "Gemini speech delivery instructions; ElevenLabs uses audio tags in the transcript, and HeyGen Voice reads it as written" },
+    { name: "lyrics", type: "string", description: `Music with --model fal/mureka-9.5-song: the words to sing, up to ${MAX_SONG_LYRICS.toLocaleString("en-US")} characters, sections tagged [Verse], [Chorus]\u2026; --prompt then sets the style. A sung song costs 15 credits, one written from the prompt 50` },
+    { name: "styles", type: "string", description: `Music with --model fal/mureka-9.5-song and no --lyrics: comma-separated genres from ${MUREKA_STYLES.join(", ")}` },
+    { name: "vocals", type: "string", choices: MUREKA_VOCALS, description: "Music with --model fal/mureka-9.5-song and --lyrics: who sings" },
     { name: "loop", type: "boolean", description: "SFX: create a seamless loop" },
     { name: "texture", type: "boolean", description: "Model: textured (default on); --no-texture makes a plain white model" },
     { name: "pbr", type: "boolean", description: "Model: metallic, roughness and normal maps with the texture (default on); --no-pbr leaves them out" },
@@ -51215,7 +51499,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,
@@ -51236,7 +51522,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(
@@ -51244,19 +51530,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" }));