@officexapp/vidfarm-devcli 0.21.26 → 0.21.27

package/dist/src/devcli/cost-mode.js

@@ -11,9 +11,17 @@
 //   - hybrid   : roughly $0.01–$1 per video. Free where it's free, spend on AI
 //                only where it clearly wins. (default recommendation.) Billed
 //                ops run but print a cost line.
-//   - pure-ai  : $1+ per video. Best-quality; AI image/video/voice/music used
-//                freely. Billed ops run; cost is still surfaced. Shown to
-//                humans as "rich-ai".
+//   - rich-ai  : $1+ per video. AI video generation is used to mint REUSABLE
+//                greenscreen raws, which are then keyed and remixed with
+//                hyperframes/HTML-CSS motion and the rest of the raw library.
+//                The raws persist (local `~/.vidfarm` raws store, optionally
+//                `vidfarm sync push /raws` to the cloud on a Pro plan), so the
+//                spend amortizes into later hybrid/minimize videos. Billed ops
+//                run; cost is still surfaced. Shown to humans as "rich-ai".
+//   - pure-videogen : $5+ per video. The whole piece is generated footage —
+//                text script → image storyboard → per-scene, frame-by-frame
+//                video generation. No raws reuse, no HTML motion. The most
+//                expensive mode; reserve it for hero pieces.
 //
 // Those dollar figures are what the AI providers charge, and they are billed to
 // the user's OWN provider keys (BYOK — the keys saved via `vidfarm
@@ -25,7 +33,7 @@
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { resolveDevcliHome } from "./auth-store.js";
-export const COST_MODES = ["minimize", "hybrid", "pure-ai"];
+export const COST_MODES = ["minimize", "hybrid", "rich-ai", "pure-videogen"];
 /** What we assume when nothing is set. Hybrid is the founder-friendly middle,
  *  but callers can tell it apart from an explicit choice via `isSet`. */
 export const DEFAULT_COST_MODE = "hybrid";
@@ -41,21 +49,29 @@ export function normalizeCostMode(raw) {
         return "minimize";
     if (["hybrid", "mixed", "balanced", "smart", "default"].includes(v))
         return "hybrid";
-    if (["pure-ai", "pureai", "rich-ai", "richai", "rich", "ai", "best", "best-quality", "premium", "max"].includes(v))
-        return "pure-ai";
+    // Check videogen BEFORE rich-ai: "pure-videogen" must not be swallowed by a
+    // looser "pure*" spelling, and "videogen" always means the frame-by-frame mode.
+    if (["pure-videogen", "purevideogen", "pure-video-gen", "videogen", "video-gen", "pure-video", "purevideo", "veo", "frame-by-frame", "cinematic"].includes(v))
+        return "pure-videogen";
+    // "pure-ai"/"pureai" are the LEGACY slug this mode used to be stored under —
+    // keep accepting them so an older ~/.vidfarm/cost-mode.json still resolves.
+    if (["rich-ai", "richai", "rich", "pure-ai", "pureai", "ai", "best", "best-quality", "premium", "max"].includes(v))
+        return "rich-ai";
     return null;
 }
 /**
- * Human-facing NAME for a mode. The canonical stored slug for best-quality stays
- * `pure-ai` (so saved cost-mode.json, --cost-mode flags, and VIDFARM_COST_MODE
- * keep resolving), but users see and can type "rich-ai".
+ * Human-facing NAME for a mode. These match the canonical slugs one-for-one —
+ * there is no "pure-ai" mode any more, it is `rich-ai` everywhere (the old slug
+ * is still ACCEPTED as an alias by normalizeCostMode so saved cost-mode.json,
+ * --cost-mode flags, and VIDFARM_COST_MODE from older installs keep resolving).
  */
 export const COST_MODE_DISPLAY = {
     minimize: "minimize",
     hybrid: "hybrid",
-    "pure-ai": "rich-ai"
+    "rich-ai": "rich-ai",
+    "pure-videogen": "pure-videogen"
 };
-/** The three modes as users see them, e.g. for "<minimize|hybrid|rich-ai>". */
+/** The modes as users see them, e.g. "<minimize|hybrid|rich-ai|pure-videogen>". */
 export const COST_MODE_DISPLAY_LIST = COST_MODES.map((m) => COST_MODE_DISPLAY[m]);
 export function costModeDisplayName(mode) {
     return COST_MODE_DISPLAY[mode];
@@ -120,22 +136,34 @@ export const COST_MODE_BLURB = {
         "credits only where they clearly win (a hero shot, a voice you can't fake locally). " +
         "Billed ops run but each prints its cost so nothing is a surprise. Charges land on " +
         "your own AI provider keys (BYOK).",
-    "pure-ai": "Rich AI — $1+ per video. Best quality; AI image/video/voice/music used freely. " +
+    "rich-ai": "Rich AI — $1+ per video. AI video generation is spent on REUSABLE greenscreen raws " +
+        "(vidfarm avatar / generate --greenscreen), keyed once and then remixed with hyperframes " +
+        "HTML/CSS motion and the rest of the raw library. Those raws are saved in the local raws " +
+        "store (and pushed to the cloud with `vidfarm sync push /raws` on a Pro plan), so the same " +
+        "footage powers later hybrid/minimize videos for $0. AI image/voice/music used freely. " +
         "Billed ops run without gating; cost is still shown. Charges land on your own AI " +
-        "provider keys (BYOK)."
+        "provider keys (BYOK).",
+    "pure-videogen": "Pure videogen — $5+ per video. Every shot is generated footage: write the script in text, " +
+        "storyboard it as images, then generate each scene frame-by-frame from those keyframes. " +
+        "No raw reuse, no HTML motion — the most expensive and most cinematic mode. Billed ops run " +
+        "without gating; cost is still shown, and a single run can be many dollars. Charges land on " +
+        "your own AI provider keys (BYOK)."
 };
 /** One short human line summarizing the active mode. */
 export function costModeSummaryLine(resolved) {
     const setNote = resolved.isSet ? `set via ${resolved.source}` : "NOT set — assuming hybrid";
     return `cost mode: ${costModeDisplayName(resolved.mode)} (${setNote})`;
 }
-/** The 3-line "explain it simply" block an agent should relay to the user. */
+/** The "explain it simply" block an agent should relay to the user. */
 export function costModeExplainer() {
     return [
         "How much do you want Vidfarm to spend on AI per video?",
-        "  • minimize — $0 videos: free local compute + free stock media, no AI spend at all.",
-        "  • hybrid   — ~$0.01–$1 per video (recommended): free where free, pay AI only where it clearly wins.",
-        "  • rich-ai  — $1+ per video: best quality, use AI image/video/voice/music freely.",
+        "  • minimize      — $0 videos: free local compute + free stock media, no AI spend at all.",
+        "  • hybrid        — ~$0.01–$1 per video (recommended): free where free, pay AI only where it clearly wins.",
+        "  • rich-ai       — $1+ per video: AI video gen mints REUSABLE greenscreen raws, then hyperframes",
+        "                    HTML/CSS motion remixes them with your library; the raws are saved and reused later.",
+        "  • pure-videogen — $5+ per video: everything is generated footage — text script → image storyboard →",
+        "                    frame-by-frame scene generation. Most cinematic, most expensive.",
         "Any spend is billed to YOUR own AI provider keys (BYOK) — add them with",
         "  `vidfarm add-provider-key <provider> <key>` or at vidfarm.cc/settings/developer.",
         "Tip: before paying to generate music/SFX/images/video, try the free stock catalog —",
@@ -159,7 +187,7 @@ export class CostModeBlockedError extends Error {
  *
  * - minimize: throws unless `yes` is set — the agent must confirm with the user
  *   (or use the free local alternative named in `freeAlternative`).
- * - hybrid / pure-ai: allowed; prints a one-line cost notice (unless json).
+ * - hybrid / rich-ai: allowed; prints a one-line cost notice (unless json).
  * - unset: allowed like hybrid, but prints a "no preference set — ask the user"
  *   nudge once so the default posture really is "ask before spending."
  */