@officexapp/vidfarm-devcli 0.21.43 → 0.21.46

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

@@ -7,7 +7,11 @@
 // their AI agent up front), then every billed command respects it:
 //   - 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).
+//                re-confirms (--yes). NOTE this does not mean "no AI at all":
+//                if the AGENT driving the terminal has image generation included
+//                in its own subscription (Antigravity / Gemini CLI, Codex /
+//                ChatGPT — Claude Code does not), it should generate the graphic
+//                itself for $0 rather than go without. See agent-imagegen.ts.
 //   - 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.
@@ -134,9 +138,15 @@ export const COST_MODE_BLURB = {
         'For any ICON, STICKER, illustration, 3D prop or Lottie, use vidfarm iconscout "<meaning>" ' +
         "--free before even considering AI image generation: free IconScout assets cost $0 (a credit " +
         "line is the only price) and arrive as clean transparent vectors. " +
+        "$0 does NOT mean no AI: if YOUR OWN agent subscription already includes image generation " +
+        "(Google Antigravity / Gemini CLI, OpenAI Codex / ChatGPT — Claude Code does not, Anthropic " +
+        'ships no image model), generate the graphic yourself — `vidfarm agent-image "<subject>"` ' +
+        "prints the prompt, the plate rules and the import command. It is free in minimize. " +
         "Billed cloud/AI generation is refused unless you re-confirm it (--yes).",
     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). " +
+        'If your own agent subscription includes image generation, use it first (`vidfarm agent-image "<subject>"`) — ' +
+        "it costs nothing extra and leaves the budget for the shots only Vidfarm can make. " +
         'Never GENERATE an icon, sticker, illustration or 3D prop — vidfarm iconscout "<meaning>" ' +
         "buys a designer's finished asset for a fraction of one AI attempt, with no prompt loop. " +
         "Billed ops run but each prints its cost so nothing is a surprise. Charges land on " +
@@ -171,6 +181,10 @@ export function costModeExplainer() {
         "                    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.",
+        "Even minimize can make custom art: if the AI agent you are talking to has image generation",
+        "  included in its own subscription (Google Antigravity / Gemini CLI, OpenAI Codex / ChatGPT —",
+        "  Claude Code does not), it generates the graphic itself for $0 extra. Ask it to run",
+        '  `vidfarm agent-image "<subject>" --items "a,b,c"`.',
         "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.',
         "  For icons, STICKERS, illustrations, 3D props and Lottie, IconScout beats AI generation on price",
@@ -200,14 +214,20 @@ export class CostModeBlockedError extends Error {
  *   nudge once so the default posture really is "ask before spending."
  */
 export function assertBilledAllowed(input) {
-    const { resolved, yes, json, label, estimate, freeAlternative } = input;
+    const { resolved, yes, json, label, estimate, freeAlternative, agentAlternative } = input;
     const log = input.log ?? ((line) => console.error(line));
     const cost = estimate ? ` (${estimate})` : "";
     if (resolved.mode === "minimize" && !yes) {
+        const agentAlt = agentAlternative ? `\nDo it yourself for $0: ${agentAlternative}` : "";
         const alt = freeAlternative ? `\nFree alternative: ${freeAlternative}` : "";
         throw new CostModeBlockedError(`Blocked by cost mode "minimize": ${label}${cost} spends billed AI credits.\n` +
             `Confirm the spend with the user, then re-run with --yes (or switch modes: ` +
-            `vidfarm cost-mode hybrid).${alt}`);
+            `vidfarm cost-mode hybrid).${agentAlt}${alt}`);
+    }
+    // Not blocked, but still worth saying: a capability the agent already pays for
+    // beats one Vidfarm bills for, in every mode below rich-ai.
+    if (!json && agentAlternative && (resolved.mode === "hybrid" || !resolved.isSet)) {
+        log(`[cost] Cheaper first: ${agentAlternative}`);
     }
     if (json)
         return;

package/dist/src/devcli/doctor.js

@@ -8,6 +8,7 @@
 // unconditionally at session start.
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync } from "node:fs";
+import { createRequire } from "node:module";
 import net from "node:net";
 import { homedir } from "node:os";
 import path from "node:path";
@@ -17,6 +18,7 @@ import { hasFfmpeg, resolveFfmpeg, resolveFfprobe } from "../services/clip-curat
 import { resolveHyperframesCli } from "./hyperframes-cli.js";
 import { applyVidfarmStudioBrand } from "./studio-brand.js";
 import { resolveSkillsRoot } from "./skills.js";
+import { browserHarnessDoctorCheck } from "./browser-harness.js";
 import { readStoredAuth } from "./auth-store.js";
 import { scanLocalServers, reapProcesses } from "./process-scan.js";
 const GREEN = "\x1b[32m";
@@ -47,6 +49,24 @@ function isPortInUse(port) {
         server.listen(port, "127.0.0.1");
     });
 }
+// Windows installs Chrome/Edge under one of three roots depending on whether it
+// was a per-machine or per-user install. Without these the check ALWAYS reported
+// "no Chrome" on Windows, and agents went off installing a browser the user
+// already had. Edge is included because it is Chromium and always present.
+function windowsChromeCandidates() {
+    const roots = [
+        process.env["PROGRAMFILES"],
+        process.env["PROGRAMFILES(X86)"],
+        process.env.LOCALAPPDATA
+    ].filter((value) => Boolean(value?.trim()));
+    const relative = [
+        ["Google", "Chrome", "Application", "chrome.exe"],
+        ["Google", "Chrome Beta", "Application", "chrome.exe"],
+        ["Chromium", "Application", "chrome.exe"],
+        ["Microsoft", "Edge", "Application", "msedge.exe"]
+    ];
+    return roots.flatMap((root) => relative.map((parts) => path.join(root, ...parts)));
+}
 // Best-effort Chrome availability for the in-process HyperFrames render:
 // explicit env overrides, the puppeteer download cache, or a system Chrome.
 function detectChromeForRender() {
@@ -66,7 +86,9 @@ function detectChromeForRender() {
     }
     const systemCandidates = process.platform === "darwin"
         ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "/Applications/Chromium.app/Contents/MacOS/Chromium"]
-        : ["/usr/bin/google-chrome", "/usr/bin/chromium", "/usr/bin/chromium-browser"];
+        : process.platform === "win32"
+            ? windowsChromeCandidates()
+            : ["/usr/bin/google-chrome", "/usr/bin/chromium", "/usr/bin/chromium-browser"];
     for (const candidate of systemCandidates) {
         if (existsSync(candidate))
             return { found: true, detail: candidate };
@@ -154,6 +176,11 @@ export async function runDoctorCommand(argv) {
     // 4. Chrome for the in-process render (stills / serve local render).
     const chrome = detectChromeForRender();
     add("chrome", chrome.found ? "ok" : "warn", chrome.found ? chrome.detail : `${chrome.detail} — local render/stills will try to download one on first run`);
+    // 4b. browser-harness — OPTIONAL, and the only free substitute for the paid
+    // search/download primitives. Reported even when absent because a free-plan
+    // user who doesn't know it exists gets a 402 instead of footage.
+    const browserHarness = browserHarnessDoctorCheck();
+    add("browser control", browserHarness.level, browserHarness.detail);
     // 5. Vidfarm cloud auth — --api-key / env, else the persisted `vidfarm login`
     // (auth-store), which is how most users authenticate. Without the store
     // lookup a logged-in user got a false "VIDFARM_API_KEY not set" warning.
@@ -175,9 +202,31 @@ export async function runDoctorCommand(argv) {
     add("provider keys", presentKeys.length > 0 ? "ok" : "warn", presentKeys.length > 0
         ? presentKeys.join(", ")
         : "none of OPENAI/GEMINI/OPENROUTER/ELEVENLABS_API_KEY set — BYOK speech/clip tagging unavailable (keyless local engines still work)");
-    // 7. Local agent CLI (claude / codex) for clips scan etc.
+    // 7. Local agent CLI (claude / codex) for clips scan etc. On Windows the CLI
+    // is a .cmd shim and the scan passes a multi-line prompt as an argv, which a
+    // cmd.exe command line cannot carry — so report the limit rather than
+    // claiming a path that fails at use time.
     const agent = detectLocalAgent();
-    add("agent CLI", agent ? "ok" : "warn", agent ? `${agent.kind} (${agent.bin})` : "no claude/codex CLI on PATH — `clips scan` falls back to provider keys");
+    if (agent && process.platform === "win32") {
+        add("agent CLI", "warn", `${agent.kind} found (${agent.bin}) but agent-driven \`clips scan\` is not supported on Windows yet — use provider keys (OPENAI/GEMINI_API_KEY)`);
+    }
+    else {
+        add("agent CLI", agent ? "ok" : "warn", agent ? `${agent.kind} (${agent.bin})` : "no claude/codex CLI on PATH — `clips scan` falls back to provider keys");
+    }
+    // 7b. The local clip library rides on the OPTIONAL native module
+    // better-sqlite3. It is optional precisely because a Windows box with no C++
+    // toolchain cannot build it — report that here instead of letting
+    // `vidfarm clips` be the thing that discovers it.
+    try {
+        createRequire(import.meta.url)("better-sqlite3");
+        add("clip library", "ok", "better-sqlite3 native module loaded (`vidfarm clips` available)");
+    }
+    catch {
+        add("clip library", "warn", "optional native module better-sqlite3 is not built — only `vidfarm clips` is affected; everything else works. " +
+            (process.platform === "win32"
+                ? "To enable it, install \"Desktop development with C++\" from the Visual Studio Installer, then reinstall the devcli."
+                : "To enable it, install a C++ toolchain (macOS: xcode-select --install; Linux: apt install build-essential python3), then reinstall the devcli."));
+    }
     // 8. Poisoned-env traps.
     if (process.env.AWS_PROFILE?.trim()) {
         add("env AWS_PROFILE", "warn", `AWS_PROFILE=${process.env.AWS_PROFILE} is set — it can hijack AWS SDK auth; run \`env -u AWS_PROFILE\` or unset it`);

package/dist/src/devcli/hyperframes-cli.js

@@ -74,11 +74,21 @@ export async function runHyperframesCommand(subcommand, args, opts = {}) {
     const [bin, baseArgs] = cli
         ? [process.execPath, [cli]]
         : ["npx", ["-y", "hyperframes"]];
+    // On Windows `npx` is `npx.cmd`, and Node >= 20.12 refuses to spawn a
+    // .cmd/.bat without a shell (it throws EINVAL, which surfaced here as the
+    // misleading "npx unavailable" error below). Route the FALLBACK through a
+    // shell there. The primary path spawns process.execPath directly and needs
+    // no shell on any platform, so this never touches the normal case.
+    const useShell = !cli && process.platform === "win32";
+    // A shell re-parses the command line, so quote anything with whitespace
+    // (project paths under "C:\Users\Some Name\..." are the common case).
+    const quote = (value) => (useShell && /[\s"&|<>^]/.test(value) ? `"${value.replace(/"/g, '\\"')}"` : value);
     const capture = opts.stdio === "capture";
     return new Promise((resolvePromise, rejectPromise) => {
-        const child = spawn(bin, [...baseArgs, subcommand, ...args], {
+        const child = spawn(bin, [...baseArgs, subcommand, ...args].map(quote), {
             cwd: opts.cwd,
             env,
+            shell: useShell,
             stdio: capture ? ["ignore", "pipe", "pipe"] : "inherit"
         });
         let stdout = "";

package/dist/src/devcli/local-render.js

@@ -19,6 +19,7 @@ import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { prepareProjectMediaForRender } from "../lib/render-media-prep.js";
+import { resolveBundledFfprobe } from "../lib/ffprobe-path.js";
 import { runHyperframesCommand } from "./hyperframes-cli.js";
 import { normalizeTikTokCaptionLayout } from "./composition-edit.js";
 // Same invariant as the backend's forceEvenCompositionDimensions: libx264
@@ -53,13 +54,9 @@ async function producerFfmpegEnv() {
         catch { /* PATH fallback */ }
     }
     if (!process.env.HYPERFRAMES_FFPROBE_PATH?.trim()) {
-        try {
-            const mod = (await import("ffprobe-static"));
-            const resolved = (mod.path ?? mod.default?.path);
-            if (typeof resolved === "string" && resolved && existsSync(resolved))
-                env.HYPERFRAMES_FFPROBE_PATH = resolved;
-        }
-        catch { /* PATH fallback */ }
+        const resolved = resolveBundledFfprobe();
+        if (resolved)
+            env.HYPERFRAMES_FFPROBE_PATH = resolved;
     }
     return env;
 }