@officexapp/vidfarm-devcli 0.21.24 → 0.21.27

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

@@ -5,19 +5,35 @@
 //
 // The mode is a single durable preference the human picks ONCE (ideally asked by
 // their AI agent up front), then every billed command respects it:
-//   - minimize : never burn AI credits by surprise. Prefer free local engines;
-//                refuse billed cloud/AI ops unless the user re-confirms (--yes).
-//   - hybrid   : 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  : best-quality; AI image/video/voice/music used freely. Billed
-//                ops run; cost is still surfaced. Shown to humans as "rich-ai".
+//   - minimize : ~$0 per video. Never burn AI credits by surprise. Prefer free
+//                local engines; refuse billed cloud/AI ops unless the user
+//                re-confirms (--yes).
+//   - 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.
+//   - 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
+// add-provider-key` / Settings → Bring your own keys), not to Vidfarm. Vidfarm
+// wallet credits are only used when the user explicitly runs on the platform key.
 //
 // This module lives in the CLI's static import closure and is BACKEND-FREE (only
 // Node built-ins) so it ships in the public cloud-only package.
 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";
@@ -33,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];
@@ -101,31 +125,47 @@ export function resolveCostMode(values) {
     return { mode: DEFAULT_COST_MODE, isSet: false, source: "default" };
 }
 export const COST_MODE_BLURB = {
-    minimize: "Minimize costs — stay on FREE local compute wherever possible (local render, " +
+    minimize: "Minimize costs — explicitly $0 videos. Stay on FREE local compute wherever possible (local render, " +
         "local TTS/STT, local greenscreen/matting, reused clips + HTML motion). For assets, " +
         'reach for the free stock catalog first — vidfarm media search "<meaning>" --type ' +
         "bgm|sfx|image|vector|icon|video. Check the KEYLESS sources first: Openverse (CC/CC0 " +
         "music, SFX, images) and iconify (icons) need no account at all. A free Pixabay key adds " +
         "photos/vectors/stock-video and may already be saved (check vidfarm provider-keys). " +
         "Billed cloud/AI generation is refused unless you re-confirm it (--yes).",
-    hybrid: "Hybrid (recommended) — free where it's free, spend AI 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.",
-    "pure-ai": "Rich AI — best quality; AI image/video/voice/music used freely. Billed ops run " +
-        "without gating; cost is still shown."
+    hybrid: "Hybrid (recommended) — roughly $0.01–$1 per video. Free where it's free, spend AI " +
+        "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).",
+    "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).",
+    "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 credits?",
-        "  • minimize — cheapest: free local compute + free stock media, no surprise AI spend.",
-        "  • hybrid   — recommended: free where free, pay AI only where it clearly wins.",
-        "  • rich-ai  — best quality: use AI image/video/voice/music freely.",
+        "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: 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 —",
         '  vidfarm media search "<meaning>" --type bgm|sfx|image|vector|icon|video.',
         "  Check the keyless sources first — Openverse (CC/CC0 music, SFX, images) and iconify (icons)",
@@ -147,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."
  */