@docyrus/animaguru 0.28.0 → 0.29.0

package/README.md

@@ -581,6 +581,13 @@ animaguru videos subtitles VIDEO_ID --remove de --yes
 
 Each upload of up to 1 MiB is stored as WebVTT, up to 20 languages per video. HTML5 films draw their own captions and take no subtitle files. New subtitles on a public video send it back for staff review, like a new poster; removing a language does not.
 
+CLI 0.29.0 lets admins tag a film for the showcase as they upload it: the public gallery films the lead invitation page shows under "Films made with AnimaGuru", grouped by sector with the lead's own first. `--showcase SECTOR` adds it (`cafe`, `restaurant`, `food`, `retail`, `beauty`, `fitness`, `workspace`, `hospitality`, `realestate`, `education`, `health`, `events`, `technology` or `services`). `--showcase-tags` says what it is for (comma-separated: `social`, `website`, `product`, `space`, `offer`, `brand`, `explainer`, `event`). `--showcase-language en|tr|sv|none` gives the language it speaks or shows, and `--showcase-position N` its order (lower first). The film shows there once it is public and approved; admins can change the tags later on Staff → Video reviews. Other accounts get a 403.
+
+```sh
+animaguru submit --file production/exports/film.mp4 --poster production/exports/poster.jpg \
+  --showcase cafe --showcase-tags social,offer --showcase-language tr --showcase-position 10 --yes
+```
+
 To request public gallery publication, upload privately, open the video in My videos on the website, choose Share → Public, and accept the public video sharing agreement. Staff must approve the submission before anyone else can access its public link, download or embed. Direct CLI public-sharing requests without agreement acceptance are refused by the API.
 
 `videos list --scope mine|shared|public` lists films. Owners can edit metadata, change visibility and replace recipients on the website, or use `videos share VIDEO_ID --visibility private --share "alex@example.com" --yes`. `videos delete VIDEO_ID --yes` removes the film and files. Making a film private or removing a recipient revokes access to existing playback links.

package/dist/animaguru.js

@@ -19761,7 +19761,7 @@ var require_ignore2 = __commonJS({
 // cli/package.json
 var package_default = {
   name: "@docyrus/animaguru",
-  version: "0.28.0",
+  version: "0.29.0",
   description: "Agent-friendly AnimaGuru CLI built with CrustJS",
   type: "module",
   bin: {
@@ -25288,208 +25288,6 @@ function unzipSync(data, opts) {
 // shared/auth.ts
 var CLI_CLIENT_ID = "animaguru-cli";
 
-// shared/sprites/styles.ts
-var GAME_SPRITE_STYLES = ["hd-cartoon", "pixel", "painted", "vector"];
-var VIDEO_SPRITE_STYLES = [
-  "photoreal-cutout",
-  "photo-collage",
-  "paper-cutout",
-  "photoreal-stop-motion",
-  "cutout-motion-graphics"
-];
-var SPRITE_STYLES = [...GAME_SPRITE_STYLES, ...VIDEO_SPRITE_STYLES];
-
-// shared/credits.ts
-var UNITS_PER_CREDIT = 10;
-var toCredits = (units) => Math.round(units) / UNITS_PER_CREDIT;
-var toUnits = (credits) => Math.round(credits * UNITS_PER_CREDIT);
-
-// shared/sprites/types.ts
-var SPRITE_KINDS = ["character", "vehicle", "machine", "effect"];
-var SPRITE_ACTIONS = ["idle", "walk", "run", "skid-stop", "shoot", "jump", "hurt", "death", "slide", "punch", "kick"];
-var SPRITE_KIND_ACTIONS = {
-  character: SPRITE_ACTIONS,
-  vehicle: ["idle", "move", "fire", "hurt", "destroyed"],
-  machine: ["idle", "work", "activate", "fire", "hurt", "break"],
-  effect: ["projectile", "charge", "impact", "explosion", "aura"]
-};
-var ALL_SPRITE_ACTIONS = [...new Set(Object.values(SPRITE_KIND_ACTIONS).flat())];
-var SPRITE_TOP_ACTIONS = {
-  vehicle: ["hull-move", "hull-destroyed", "turret-fire"],
-  machine: ["hull-break", "turret-fire"]
-};
-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 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: "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" } },
-  { id: "gpt-image-2.5", label: "GPT Image 2.5 (OpenAI)", provider: "openai", edit: true, nativeAlpha: true, maxImages: 16, relCost: 1 },
-  { id: "black-forest-labs/flux-2-max", label: "FLUX.2 [max]", provider: "workers-ai", edit: true, maxImages: 8, relCost: 3 },
-  { 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 }
-];
-var SPRITE_IMAGE_MODEL_IDS = SPRITE_IMAGE_MODELS.map((m) => m.id);
-function spriteImageModel(id2) {
-  return SPRITE_IMAGE_MODELS.find((m) => m.id === id2) ?? SPRITE_IMAGE_MODELS[0];
-}
-var VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video", "reference-to-video", "lip-sync", "camera-controls", "insert-video", "recast", "relight", "3d-to-video", "style", "keyframes-to-video"];
-var STUDIO_VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video"];
-var MEDIA_LENGTH_WORKFLOWS = ["lip-sync", "recast", "relight", "3d-to-video"];
-var lengthFromMedia = (workflow) => MEDIA_LENGTH_WORKFLOWS.includes(workflow);
-var VIDEO_STYLES = ["vhs", "retro-toon-70s", "low-poly", "hand-drawn", "16bit-pixel"];
-var VHS_DAMAGE_LEVELS = ["light", "medium", "heavy"];
-var VIDEO_RESOLUTIONS = ["480p", "720p", "768p", "1080p", "2k"];
-var H3_RESOLUTIONS = ["480p", "768p", "1080p", "2k"];
-var VIDEO_ASPECT_RATIOS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"];
-var PROMPT_EXPANSION_MODES = ["disabled", "balanced", "quality"];
-var EXTEND_OUTPUTS = ["extended", "continuation"];
-var SOUNDTRACK_MAX_BYTES = 15 * 1024 * 1024;
-var EXTEND_SOURCE_MAX_BYTES = 50 * 1024 * 1024;
-var MAX_AUDIO_REFERENCES = 3;
-var MAX_VIDEO_REFERENCE_IMAGES = 9;
-var MAX_REFERENCE_VIDEOS = 3;
-var MAX_REFERENCE_FILES = 12;
-var MAX_RECAST_PEOPLE = 4;
-var MAX_3D_REFERENCES = 8;
-var MAX_CAMERA_KEYFRAMES = 12;
-var MAX_CAMERA_TURNS = 32;
-var MAX_IMAGE_KEYFRAMES = 10;
-var KEYFRAME_FPS = 24;
-var H3_MAX = "minimax/h3-max";
-var FLUX_3_MAX = "blackforestlabs/flux-3-max";
-var h3Endpoints = (route) => ({ "image-to-video": `${route}/image-to-video`, "text-to-video": `${route}/text-to-video`, "extend-video": `${route}/extend-video` });
-var SPRITE_VIDEO_MODELS = [
-  {
-    id: "pruna/p-video-2-pro",
-    label: "Pruna P-Video 2 Pro",
-    provider: "pruna",
-    workflows: ["image-to-video"],
-    resolutions: ["480p", "768p"],
-    modes: ["cost", "speed", "quality"],
-    lastFrame: true,
-    estimatedCreditsPerSecond: { "480p": { cost: 1, speed: 2, quality: 4 }, "768p": { cost: 2.5, speed: 3.5, quality: 7.5 } },
-    seconds: { min: 5, max: 15 }
-  },
-  {
-    id: "heygen/heygen-video-1",
-    label: "HeyGen Video 1",
-    provider: "heygen",
-    workflows: ["image-to-video"],
-    resolutions: ["480p", "768p"],
-    modes: ["cost"],
-    lastFrame: false,
-    estimatedCreditsPerSecond: { "480p": { cost: 1 }, "768p": { cost: 1.5 } },
-    seconds: { min: 5, max: 15 }
-  },
-  {
-    id: "fal/minimax-h3-max",
-    label: "MiniMax H3 Max (fal.ai)",
-    provider: "fal",
-    // Every workflow but FLUX 3 Max's keyframes.
-    workflows: VIDEO_WORKFLOWS.filter((w) => w !== "keyframes-to-video"),
-    endpoints: {
-      ...h3Endpoints(H3_MAX),
-      "reference-to-video": `${H3_MAX}/reference-to-video`,
-      "lip-sync": `${H3_MAX}/lip-sync/image-to-video`,
-      "camera-controls": `${H3_MAX}/camera-controls`,
-      "insert-video": `${H3_MAX}/insert-video`,
-      recast: `${H3_MAX}/recast`,
-      relight: `${H3_MAX}/relight`,
-      "3d-to-video": `${H3_MAX}/3d-to-video`,
-      style: `${H3_MAX}/styles`
-    },
-    resolutions: ["480p", "768p", "1080p"],
-    workflowOptions: {
-      "extend-video": { resolutions: H3_RESOLUTIONS },
-      "lip-sync": { resolutions: H3_RESOLUTIONS, seconds: { min: 5, max: 900, fractional: true } },
-      "insert-video": { resolutions: ["480p", "768p"], seconds: { min: 5, max: 13, fractional: true }, creditsPerSecond: { "480p": 5, "768p": 6 } },
-      recast: { resolutions: ["768p", "1080p"], seconds: { min: 5, max: 30, fractional: true }, creditsPerSecond: { "768p": 30, "1080p": 45 } },
-      relight: { resolutions: H3_RESOLUTIONS, seconds: { min: 2.33, max: 15, fractional: true } },
-      "3d-to-video": { seconds: { min: 1, max: 15, fractional: true } },
-      style: { resolutions: ["768p"], seconds: { min: 5, max: 15 } }
-    },
-    modes: ["quality"],
-    lastFrame: true,
-    endFrameOnly: true,
-    seed: true,
-    promptExpansion: PROMPT_EXPANSION_MODES,
-    audio: true,
-    estimatedCreditsPerSecond: { "480p": { quality: 5 }, "768p": { quality: 8 }, "1080p": { quality: 16 }, "2k": { quality: 32 } },
-    seconds: { min: 1, max: 15, fractional: true }
-  },
-  {
-    id: "fal/minimax-h3-max-turbo",
-    label: "MiniMax H3 Max Turbo (fal.ai)",
-    provider: "fal",
-    workflows: STUDIO_VIDEO_WORKFLOWS,
-    endpoints: h3Endpoints("minimax/h3-max-turbo"),
-    resolutions: ["480p", "768p", "1080p"],
-    workflowOptions: { "extend-video": { resolutions: H3_RESOLUTIONS } },
-    modes: ["speed"],
-    lastFrame: true,
-    endFrameOnly: true,
-    seed: true,
-    promptExpansion: PROMPT_EXPANSION_MODES,
-    audio: true,
-    estimatedCreditsPerSecond: { "480p": { speed: 2.5 }, "768p": { speed: 4 }, "1080p": { speed: 8 }, "2k": { speed: 16 } },
-    seconds: { min: 1, max: 15, fractional: true }
-  },
-  {
-    id: "fal/flux-3-max",
-    label: "FLUX 3 Max (fal.ai)",
-    provider: "fal",
-    workflows: ["image-to-video", "text-to-video", "keyframes-to-video"],
-    endpoints: { "image-to-video": `${FLUX_3_MAX}/image-to-video`, "text-to-video": `${FLUX_3_MAX}/text-to-video`, "keyframes-to-video": `${FLUX_3_MAX}/keyframes-to-video` },
-    falInputs: "flux",
-    resolutions: ["720p", "1080p"],
-    modes: ["quality"],
-    lastFrame: true,
-    seed: true,
-    promptExpansion: ["balanced", "quality"],
-    estimatedCreditsPerSecond: { "720p": { quality: 17 }, "1080p": { quality: 29 } },
-    seconds: { min: 5, max: 20 }
-  }
-];
-var SPRITE_VIDEO_MODEL_IDS = SPRITE_VIDEO_MODELS.map((m) => m.id);
-var DEFAULT_SPRITE_VIDEO_MODEL = "pruna/p-video-2-pro";
-function spriteVideoModel(id2) {
-  return SPRITE_VIDEO_MODELS.find((m) => m.id === id2) ?? SPRITE_VIDEO_MODELS[0];
-}
-function videoResolutions(model, workflow = "image-to-video") {
-  return model.workflowOptions?.[workflow]?.resolutions ?? model.resolutions;
-}
-function videoSeconds(model, workflow = "image-to-video") {
-  return model.workflowOptions?.[workflow]?.seconds ?? model.seconds;
-}
-var INCLUDED_REFERENCE_TOKENS = 4096;
-var imageReferenceTokens = (size) => size && size[0] > 0 && size[1] > 0 ? 32 * Math.ceil(32 * Math.max(...size) / Math.min(...size)) : 1824;
-var clipReferenceTokens = (seconds2, resolution) => Math.ceil(Math.max(0, seconds2) * (resolution === "480p" ? 2700 : 6900));
-var audioReferenceTokens = (seconds2) => Math.ceil(Math.max(0, seconds2) * 80);
-var DEFAULT_GENERATED_REFERENCES = 2;
-function billedVideoSeconds(model, workflow, seconds2) {
-  const s = videoSeconds(model, workflow).fractional ? seconds2 : Math.round(seconds2);
-  if (workflow === "3d-to-video") return Math.max(5, s);
-  return workflow === "lip-sync" && s > 15 ? s * 1.2 : s;
-}
-function videoCreditsPerSecond(model, p) {
-  const override = model.workflowOptions?.[p.workflow ?? "image-to-video"]?.creditsPerSecond?.[p.resolution];
-  if (override !== void 0) return override;
-  const byMode = model.estimatedCreditsPerSecond[p.resolution] ?? model.estimatedCreditsPerSecond[model.resolutions[0]];
-  return byMode[p.mode] ?? byMode[model.modes[0]] ?? 0;
-}
-function spriteVideoEstimate(model, p, extras2 = {}) {
-  const seconds2 = billedVideoSeconds(model, p.workflow ?? "image-to-video", p.seconds);
-  const beyond = Math.max(0, (extras2.referenceTokens ?? 0) - INCLUDED_REFERENCE_TOKENS) * 2e-3 + (extras2.generatedReferences ?? 0) * 3;
-  return Math.max(1, Math.ceil((videoCreditsPerSecond(model, p) * seconds2 + beyond) * UNITS_PER_CREDIT));
-}
-
 // node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -45158,6 +44956,220 @@ function date4(params) {
   return _coercedDate(ZodDate, params);
 }
 
+// shared/showcase.ts
+var SHOWCASE_SECTORS = ["cafe", "restaurant", "food", "retail", "beauty", "fitness", "workspace", "hospitality", "realestate", "education", "health", "events", "technology", "services"];
+var SHOWCASE_TAGS = ["social", "website", "product", "space", "offer", "brand", "explainer", "event"];
+var SHOWCASE_LOCALES = ["", "en", "tr", "sv"];
+var showcaseEntry = external_exports.object({
+  sector: external_exports.enum(SHOWCASE_SECTORS),
+  tags: external_exports.array(external_exports.enum(SHOWCASE_TAGS)).max(SHOWCASE_TAGS.length).default([]).transform((tags) => [...new Set(tags)]),
+  locale: external_exports.enum(SHOWCASE_LOCALES).default(""),
+  /** Lower comes first; films with the same position show newest first. */
+  position: external_exports.number().int().min(0).max(1e3).default(0)
+}).strict();
+
+// shared/sprites/styles.ts
+var GAME_SPRITE_STYLES = ["hd-cartoon", "pixel", "painted", "vector"];
+var VIDEO_SPRITE_STYLES = [
+  "photoreal-cutout",
+  "photo-collage",
+  "paper-cutout",
+  "photoreal-stop-motion",
+  "cutout-motion-graphics"
+];
+var SPRITE_STYLES = [...GAME_SPRITE_STYLES, ...VIDEO_SPRITE_STYLES];
+
+// shared/credits.ts
+var UNITS_PER_CREDIT = 10;
+var toCredits = (units) => Math.round(units) / UNITS_PER_CREDIT;
+var toUnits = (credits) => Math.round(credits * UNITS_PER_CREDIT);
+
+// shared/sprites/types.ts
+var SPRITE_KINDS = ["character", "vehicle", "machine", "effect"];
+var SPRITE_ACTIONS = ["idle", "walk", "run", "skid-stop", "shoot", "jump", "hurt", "death", "slide", "punch", "kick"];
+var SPRITE_KIND_ACTIONS = {
+  character: SPRITE_ACTIONS,
+  vehicle: ["idle", "move", "fire", "hurt", "destroyed"],
+  machine: ["idle", "work", "activate", "fire", "hurt", "break"],
+  effect: ["projectile", "charge", "impact", "explosion", "aura"]
+};
+var ALL_SPRITE_ACTIONS = [...new Set(Object.values(SPRITE_KIND_ACTIONS).flat())];
+var SPRITE_TOP_ACTIONS = {
+  vehicle: ["hull-move", "hull-destroyed", "turret-fire"],
+  machine: ["hull-break", "turret-fire"]
+};
+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 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: "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" } },
+  { id: "gpt-image-2.5", label: "GPT Image 2.5 (OpenAI)", provider: "openai", edit: true, nativeAlpha: true, maxImages: 16, relCost: 1 },
+  { id: "black-forest-labs/flux-2-max", label: "FLUX.2 [max]", provider: "workers-ai", edit: true, maxImages: 8, relCost: 3 },
+  { 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 }
+];
+var SPRITE_IMAGE_MODEL_IDS = SPRITE_IMAGE_MODELS.map((m) => m.id);
+function spriteImageModel(id2) {
+  return SPRITE_IMAGE_MODELS.find((m) => m.id === id2) ?? SPRITE_IMAGE_MODELS[0];
+}
+var VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video", "reference-to-video", "lip-sync", "camera-controls", "insert-video", "recast", "relight", "3d-to-video", "style", "keyframes-to-video"];
+var STUDIO_VIDEO_WORKFLOWS = ["image-to-video", "text-to-video", "extend-video"];
+var MEDIA_LENGTH_WORKFLOWS = ["lip-sync", "recast", "relight", "3d-to-video"];
+var lengthFromMedia = (workflow) => MEDIA_LENGTH_WORKFLOWS.includes(workflow);
+var VIDEO_STYLES = ["vhs", "retro-toon-70s", "low-poly", "hand-drawn", "16bit-pixel"];
+var VHS_DAMAGE_LEVELS = ["light", "medium", "heavy"];
+var VIDEO_RESOLUTIONS = ["480p", "720p", "768p", "1080p", "2k"];
+var H3_RESOLUTIONS = ["480p", "768p", "1080p", "2k"];
+var VIDEO_ASPECT_RATIOS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"];
+var PROMPT_EXPANSION_MODES = ["disabled", "balanced", "quality"];
+var EXTEND_OUTPUTS = ["extended", "continuation"];
+var SOUNDTRACK_MAX_BYTES = 15 * 1024 * 1024;
+var EXTEND_SOURCE_MAX_BYTES = 50 * 1024 * 1024;
+var MAX_AUDIO_REFERENCES = 3;
+var MAX_VIDEO_REFERENCE_IMAGES = 9;
+var MAX_REFERENCE_VIDEOS = 3;
+var MAX_REFERENCE_FILES = 12;
+var MAX_RECAST_PEOPLE = 4;
+var MAX_3D_REFERENCES = 8;
+var MAX_CAMERA_KEYFRAMES = 12;
+var MAX_CAMERA_TURNS = 32;
+var MAX_IMAGE_KEYFRAMES = 10;
+var KEYFRAME_FPS = 24;
+var H3_MAX = "minimax/h3-max";
+var FLUX_3_MAX = "blackforestlabs/flux-3-max";
+var h3Endpoints = (route) => ({ "image-to-video": `${route}/image-to-video`, "text-to-video": `${route}/text-to-video`, "extend-video": `${route}/extend-video` });
+var SPRITE_VIDEO_MODELS = [
+  {
+    id: "pruna/p-video-2-pro",
+    label: "Pruna P-Video 2 Pro",
+    provider: "pruna",
+    workflows: ["image-to-video"],
+    resolutions: ["480p", "768p"],
+    modes: ["cost", "speed", "quality"],
+    lastFrame: true,
+    estimatedCreditsPerSecond: { "480p": { cost: 1, speed: 2, quality: 4 }, "768p": { cost: 2.5, speed: 3.5, quality: 7.5 } },
+    seconds: { min: 5, max: 15 }
+  },
+  {
+    id: "heygen/heygen-video-1",
+    label: "HeyGen Video 1",
+    provider: "heygen",
+    workflows: ["image-to-video"],
+    resolutions: ["480p", "768p"],
+    modes: ["cost"],
+    lastFrame: false,
+    estimatedCreditsPerSecond: { "480p": { cost: 1 }, "768p": { cost: 1.5 } },
+    seconds: { min: 5, max: 15 }
+  },
+  {
+    id: "fal/minimax-h3-max",
+    label: "MiniMax H3 Max (fal.ai)",
+    provider: "fal",
+    // Every workflow but FLUX 3 Max's keyframes.
+    workflows: VIDEO_WORKFLOWS.filter((w) => w !== "keyframes-to-video"),
+    endpoints: {
+      ...h3Endpoints(H3_MAX),
+      "reference-to-video": `${H3_MAX}/reference-to-video`,
+      "lip-sync": `${H3_MAX}/lip-sync/image-to-video`,
+      "camera-controls": `${H3_MAX}/camera-controls`,
+      "insert-video": `${H3_MAX}/insert-video`,
+      recast: `${H3_MAX}/recast`,
+      relight: `${H3_MAX}/relight`,
+      "3d-to-video": `${H3_MAX}/3d-to-video`,
+      style: `${H3_MAX}/styles`
+    },
+    resolutions: ["480p", "768p", "1080p"],
+    workflowOptions: {
+      "extend-video": { resolutions: H3_RESOLUTIONS },
+      "lip-sync": { resolutions: H3_RESOLUTIONS, seconds: { min: 5, max: 900, fractional: true } },
+      "insert-video": { resolutions: ["480p", "768p"], seconds: { min: 5, max: 13, fractional: true }, creditsPerSecond: { "480p": 5, "768p": 6 } },
+      recast: { resolutions: ["768p", "1080p"], seconds: { min: 5, max: 30, fractional: true }, creditsPerSecond: { "768p": 30, "1080p": 45 } },
+      relight: { resolutions: H3_RESOLUTIONS, seconds: { min: 2.33, max: 15, fractional: true } },
+      "3d-to-video": { seconds: { min: 1, max: 15, fractional: true } },
+      style: { resolutions: ["768p"], seconds: { min: 5, max: 15 } }
+    },
+    modes: ["quality"],
+    lastFrame: true,
+    endFrameOnly: true,
+    seed: true,
+    promptExpansion: PROMPT_EXPANSION_MODES,
+    audio: true,
+    estimatedCreditsPerSecond: { "480p": { quality: 5 }, "768p": { quality: 8 }, "1080p": { quality: 16 }, "2k": { quality: 32 } },
+    seconds: { min: 1, max: 15, fractional: true }
+  },
+  {
+    id: "fal/minimax-h3-max-turbo",
+    label: "MiniMax H3 Max Turbo (fal.ai)",
+    provider: "fal",
+    workflows: STUDIO_VIDEO_WORKFLOWS,
+    endpoints: h3Endpoints("minimax/h3-max-turbo"),
+    resolutions: ["480p", "768p", "1080p"],
+    workflowOptions: { "extend-video": { resolutions: H3_RESOLUTIONS } },
+    modes: ["speed"],
+    lastFrame: true,
+    endFrameOnly: true,
+    seed: true,
+    promptExpansion: PROMPT_EXPANSION_MODES,
+    audio: true,
+    estimatedCreditsPerSecond: { "480p": { speed: 2.5 }, "768p": { speed: 4 }, "1080p": { speed: 8 }, "2k": { speed: 16 } },
+    seconds: { min: 1, max: 15, fractional: true }
+  },
+  {
+    id: "fal/flux-3-max",
+    label: "FLUX 3 Max (fal.ai)",
+    provider: "fal",
+    workflows: ["image-to-video", "text-to-video", "keyframes-to-video"],
+    endpoints: { "image-to-video": `${FLUX_3_MAX}/image-to-video`, "text-to-video": `${FLUX_3_MAX}/text-to-video`, "keyframes-to-video": `${FLUX_3_MAX}/keyframes-to-video` },
+    falInputs: "flux",
+    resolutions: ["720p", "1080p"],
+    modes: ["quality"],
+    lastFrame: true,
+    seed: true,
+    promptExpansion: ["balanced", "quality"],
+    estimatedCreditsPerSecond: { "720p": { quality: 17 }, "1080p": { quality: 29 } },
+    seconds: { min: 5, max: 20 }
+  }
+];
+var SPRITE_VIDEO_MODEL_IDS = SPRITE_VIDEO_MODELS.map((m) => m.id);
+var DEFAULT_SPRITE_VIDEO_MODEL = "pruna/p-video-2-pro";
+function spriteVideoModel(id2) {
+  return SPRITE_VIDEO_MODELS.find((m) => m.id === id2) ?? SPRITE_VIDEO_MODELS[0];
+}
+function videoResolutions(model, workflow = "image-to-video") {
+  return model.workflowOptions?.[workflow]?.resolutions ?? model.resolutions;
+}
+function videoSeconds(model, workflow = "image-to-video") {
+  return model.workflowOptions?.[workflow]?.seconds ?? model.seconds;
+}
+var INCLUDED_REFERENCE_TOKENS = 4096;
+var imageReferenceTokens = (size) => size && size[0] > 0 && size[1] > 0 ? 32 * Math.ceil(32 * Math.max(...size) / Math.min(...size)) : 1824;
+var clipReferenceTokens = (seconds2, resolution) => Math.ceil(Math.max(0, seconds2) * (resolution === "480p" ? 2700 : 6900));
+var audioReferenceTokens = (seconds2) => Math.ceil(Math.max(0, seconds2) * 80);
+var DEFAULT_GENERATED_REFERENCES = 2;
+function billedVideoSeconds(model, workflow, seconds2) {
+  const s = videoSeconds(model, workflow).fractional ? seconds2 : Math.round(seconds2);
+  if (workflow === "3d-to-video") return Math.max(5, s);
+  return workflow === "lip-sync" && s > 15 ? s * 1.2 : s;
+}
+function videoCreditsPerSecond(model, p) {
+  const override = model.workflowOptions?.[p.workflow ?? "image-to-video"]?.creditsPerSecond?.[p.resolution];
+  if (override !== void 0) return override;
+  const byMode = model.estimatedCreditsPerSecond[p.resolution] ?? model.estimatedCreditsPerSecond[model.resolutions[0]];
+  return byMode[p.mode] ?? byMode[model.modes[0]] ?? 0;
+}
+function spriteVideoEstimate(model, p, extras2 = {}) {
+  const seconds2 = billedVideoSeconds(model, p.workflow ?? "image-to-video", p.seconds);
+  const beyond = Math.max(0, (extras2.referenceTokens ?? 0) - INCLUDED_REFERENCE_TOKENS) * 2e-3 + (extras2.generatedReferences ?? 0) * 3;
+  return Math.max(1, Math.ceil((videoCreditsPerSecond(model, p) * seconds2 + beyond) * UNITS_PER_CREDIT));
+}
+
 // shared/sprites/generation-models.ts
 var generationModelShape = {
   videoModel: external_exports.enum(SPRITE_VIDEO_MODEL_IDS).optional()
@@ -47336,7 +47348,9 @@ var videoSubmission = videoDetails.and(external_exports.object({
   bytes: external_exports.number().int().positive(),
   width: external_exports.number().int().min(1).max(4096).default(1920),
   height: external_exports.number().int().min(1).max(4096).default(1080),
-  duration: external_exports.number().positive().max(7200).optional()
+  duration: external_exports.number().positive().max(7200).optional(),
+  /** Admins only: adds the video to the showcase (shared/showcase.ts), where it shows once it is public and approved. */
+  showcase: showcaseEntry.optional()
 })).refine((value) => value.bytes <= VIDEO_MAX_BYTES[value.format], "HTML5 ZIPs support up to 64 MiB; MP4s support up to 512 MiB.").refine((value) => !value.animation || value.project, "Name the project of the animation.");
 var videoMove = external_exports.object({ workspace: videoWorkspace }).strict();
 function videoPosterType(bytes) {
@@ -48282,6 +48296,17 @@ async function restoreCloud(options) {
 }
 
 // cli/src/videos.ts
+function showcaseOption(options) {
+  const extra = options["showcase-tags"] !== void 0 || options["showcase-language"] !== void 0 || options["showcase-position"] !== void 0;
+  if (!options.showcase) {
+    if (extra) throw new Error("Pass --showcase SECTOR to add the video to the showcase.");
+    return {};
+  }
+  const tags = options["showcase-tags"] ? options["showcase-tags"].split(",").map((tag) => tag.trim()).filter(Boolean) : [];
+  const parsed = showcaseEntry.safeParse({ sector: options.showcase, tags, locale: options["showcase-language"] === "none" ? "" : options["showcase-language"] ?? "", position: options["showcase-position"] ?? 0 });
+  if (!parsed.success) throw new Error(`Check the showcase tags: ${parsed.error.issues[0]?.message ?? "invalid"} (tags are ${SHOWCASE_TAGS.join(", ")}).`);
+  return { showcase: parsed.data };
+}
 var subtitlesBody = (content) => new Blob([new Uint8Array(content)], { type: "text/plain; charset=utf-8" });
 function libraryWorkspace(value) {
   if (value === "personal" || value === "me") return "me";
@@ -48326,6 +48351,7 @@ async function exportHtml(root, animation, signal, log) {
 async function submitVideo(client, options) {
   if (!options.yes && !options["dry-run"]) throw new Error("Pass --yes to authorize uploading and sharing this animation, or --dry-run to inspect the submission.");
   const workspace3 = options.workspace === void 0 ? void 0 : libraryWorkspace(options.workspace);
+  const showcase = showcaseOption(options);
   const root = resolve10(options.directory ?? ".");
   const context = await localProject(root, options.animation);
   const file2 = options.file ? resolve10(root, options.file) : await exportHtml(context.toolsRoot, context.animation, options.signal, options.log);
@@ -48370,7 +48396,8 @@ async function submitVideo(client, options) {
     bytes: info.size,
     width: metadata.width,
     height: metadata.height,
-    duration: metadata.duration
+    duration: metadata.duration,
+    ...showcase
   });
   let subtitles = null;
   const choice = options.subtitles ?? "auto";
@@ -50091,6 +50118,7 @@ var brandCreate = brandFields.extend({ requestId: external_exports.string().uuid
 var brandUpdate = external_exports.object(fieldShape).partial().strict();
 var brandResearch = external_exports.object({ requestId: external_exports.string().uuid(), workspace, url: brandWebsite, name: external_exports.string().trim().min(1).max(120).optional() }).strict();
 var brandRefresh = external_exports.object({ requestId: external_exports.string().uuid(), url: brandWebsite.optional() }).strict();
+var brandTransfer = external_exports.object({ workspace }).strict();
 var DEFAULT_BRAND_COLORS = { primary: "#2563eb", background: "#ffffff", text: "#111827", accent: null, palette: [] };
 var DEFAULT_BRAND_FONTS = { heading: { family: "Inter, sans-serif", file: null }, body: { family: "Inter, sans-serif", file: null } };
 var brandDraftFields = brandFields.extend({
@@ -50702,6 +50730,10 @@ function createCli() {
     { name: "poster", type: "string", description: "PNG, JPEG or WebP cover image" },
     { name: "subtitles", type: "string", default: "auto", description: "MP4 subtitle file (.vtt or .srt) the player shows over the picture; auto uses FILM.vtt or FILM.srt beside FILM.mp4; none skips" },
     { name: "subtitle-language", type: "string", description: "Subtitle language code such as en or tr; defaults to the MP4's export receipt or film.config.json" },
+    { name: "showcase", type: "string", choices: [...SHOWCASE_SECTORS], description: "Admins: add the video to the showcase under this sector; it shows on lead pages once public and approved" },
+    { name: "showcase-tags", type: "string", description: `Admins: what the film is for, comma-separated: ${SHOWCASE_TAGS.join(", ")}` },
+    { name: "showcase-language", type: "string", choices: ["en", "tr", "sv", "none"], description: "Admins: the language the film speaks or shows; none for music and pictures only (default)" },
+    { name: "showcase-position", type: "number", description: "Admins: order in the showcase, lower first (default 0)" },
     { name: "yes", type: "boolean", description: "Authorize upload and chosen sharing" },
     { name: "dry-run", type: "boolean", description: "Inspect locally without uploading" }
   ).action(async ({ args, flags, stdout, stderr, signal }) => out(stdout, await submitVideo(new Client(flags.url, signal), { ...flags, directory: args.directory, log: stderr, signal }))))).command("videos", (videos) => videos.add(defineCommand("list", { description: "List a video library (the selected workspace's by default), privately shared videos, or the public gallery" }, (command) => command.flags(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docyrus/animaguru",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Agent-friendly AnimaGuru CLI built with CrustJS",
   "type": "module",
   "bin": {

package/skills/animaguru-video/SKILL.md

@@ -112,7 +112,7 @@ Run `npm run build`. Review the actual browser at desktop and mobile sizes, play
 
 Deliver the playable HTML film first unless the user asked for MP4 too. A branching story (`story.json`) and a quiz film (`quiz.json`) are HTML5 only. For an embeddable HTML5 deliverable, use the download menu or `npm run export:html`. Unzip and test the static package over HTTP(S), including its iframe example; it should play without the authoring workspace or an AnimaGuru account. `npm run build` includes the same download in the static player. Preserve embed mode and hide authoring controls there.
 
-For MP4 on the user's own computer, run `npm run export:mp4 -- --headless`; it captures in a local headless Chrome (installed Chrome or Edge, `PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH`, or `npx playwright install chromium`). Without `--headless`, open the printed local capture URL in a browser and keep it open until completion. The script verifies H.264/AAC, dimensions, duration and exact frame count and writes a JSON report next to the MP4. Captions stay out of the picture; the `captions` resource track becomes `.srt` (YouTube, desktop players) and `.vtt` (HTML5) subtitle files with the MP4's name, so keep that track's clips equal to the spoken lines. For social feeds that need open captions, add `-- --burn-captions`; it saves `SLUG-LANGUAGE-captioned.mp4` with captions in the picture and no subtitle files. Set `"poster"` in `film.config.json` to the seconds of the film's most representative frame (title, product or end card, never a fade or a blank moment); the export saves it beside the MP4 as a 1280-pixel JPEG thumbnail, which `animaguru youtube upload` and video pages can use. Exporting existing local assets spends no generation credits. If browser control is unavailable, give the user the printed URL and explain the one manual step. The cloud Animator makes no MP4s and `export:mp4` refuses to run there: the user applies the draft and exports the MP4 in their browser.
+For MP4 on the user's own computer, run `npm run export:mp4 -- --headless`; it captures in a local headless Chrome (installed Chrome or Edge, `PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH`, or `npx playwright install chromium`). Without `--headless`, open the printed local capture URL in a browser and keep it open until completion. The script verifies H.264/AAC, dimensions, duration and exact frame count and writes a JSON report next to the MP4. Captions stay out of the picture; the `captions` resource track becomes `.srt` (YouTube, desktop players) and `.vtt` (HTML5) subtitle files with the MP4's name, so keep that track's clips equal to the spoken lines. For social feeds that need open captions, add `-- --burn-captions`; it saves `SLUG-LANGUAGE-captioned.mp4` with captions in the picture and no subtitle files. Set `"poster"` in `film.config.json` to the seconds of the film's most representative frame (title, product or end card, never a fade or a blank moment); the export saves it beside the MP4 as a 1280-pixel JPEG thumbnail, which `animaguru youtube upload` and video pages can use. Exporting existing local assets spends no generation credits. If browser control is unavailable, give the user the printed URL and explain the one manual step. The cloud Animator makes no MP4s and `export:mp4` refuses to run there: the user exports the MP4 in their browser from the draft page.
 
 `npm run dev` starts the preview. The capture API and file map are documented in the generated project README. Publishing a website, package or campaign is separate from creating the local video.
 

package/templates/video/scripts/export-mp4.mjs

@@ -12,8 +12,8 @@ import { workspacePlugin } from "./workspace-plugin.mjs";
 import { subtitleCues, toSrt, toVtt } from "./subtitles.mjs";
 import { captureHeadless, takeHeadlessFlag } from "./headless-browser.mjs";
 
-// The cloud Animator makes no MP4s: once the user applies the draft, they export it in their own browser.
-if (process.env.ANIMAGURU_CLOUD_WORKSPACE) throw new Error("MP4 export is not available in the cloud Animator. After the user applies the draft, they export the MP4 in their browser from the draft page.");
+// The cloud Animator makes no MP4s: the user exports the film in their own browser, from the draft page.
+if (process.env.ANIMAGURU_CLOUD_WORKSPACE) throw new Error("MP4 export is not available in the cloud Animator. The user exports the MP4 in their browser from the draft page.");
 
 const root = fileURLToPath(new URL("../", import.meta.url));
 const selection = projectArguments(process.argv.slice(2));