@mevdragon/vidfarm-devcli 0.20.9 → 0.20.11

package/.agents/skills/vidfarm-director/references/automation-and-local-dev.md

@@ -121,7 +121,7 @@ If a local AI script rewrites text or scenes without consuming those files first
 | `vidfarm generate <image\|video> --prompt "…"` | `POST /api/v1/primitives/{images,videos}/generate` (polls job) | generate AI media → finished URL |
 | `vidfarm inpaint <image> --mask <png> --prompt "…" [--region "label=…"] [--ref …] [--out <f>]` | `POST /api/v1/primitives/images/inpaint` (polls job) | masked image EDIT — replace ONLY the transparent-mask region, keep everything else (devcli twin of the /inpaint page) |
 | `vidfarm create-overlay "<subject>" [--key-color #00FF00] [--aspect-ratio 1:1] [--place <dir>] [--out <f>]` | `POST /api/v1/primitives/images/create-overlay` (polls job) | **Vox-style** transparent OVERLAY — AI image on a forced key-color background, chroma-keyed out in one job → ready-to-composite transparent PNG |
-| `vidfarm remove-background-greenscreen <image> [--key-color #00FF00] [--tolerance 0.3] [--out <f>]` | `POST /api/v1/primitives/images/remove-background-greenscreen` (polls job) | cheap chroma-key removal of a FLAT solid background → transparent PNG (cloud primitive) |
+| `vidfarm remove-greenscreen <image\|video> [--preset green\|blue\|white\|black\|digital-green\|magenta] [--key-color #00FF00] [--tolerance 0.3] [--local] [--out <f>]` | `POST /api/v1/primitives/remove-greenscreen` (polls job) | chroma-key a FLAT solid background → transparent PNG/WebP (image) or WebM/VP9-alpha (video); auto-detects media kind. `--local` runs it FREE in-process (sharp/ffmpeg, no wallet); default cloud is billed at real compute × 1.2. Aliases: `greenscreen`, `remove-background-greenscreen`. |
 | `vidfarm tts "…" [--style "…"] [--voice <v>] [--out <file>]` | (LOCAL-FIRST: your own OPENAI/GEMINI/OPENROUTER_API_KEY → audio file on disk; `--cloud` = `POST /api/v1/primitives/audio/speech` + poll, ElevenLabs on the platform key by default, `--own-key` for yours) | text → narration audio; `--cloud --voice <voice_id>` picks an ElevenLabs voice |
 | `vidfarm music "<prompt>" [--length <sec>] [--out <f>] [--own-key]` | `POST /api/v1/primitives/music/generate` (polls job) | prompt → music track (ElevenLabs; platform key + wallet by default, `--own-key` for yours) |
 | `vidfarm voices [--own-key] [--limit N]` | `GET /api/v1/primitives/audio/voices` | list ElevenLabs voices (voice_id/name/labels) for `tts --voice`; default a voice + tell the user they can choose |

package/.agents/skills/vidfarm-director/references/primitives.md

@@ -17,18 +17,17 @@ curl -X POST "$VIDFARM_BASE/api/v1/primitives/images/remove-background" \
   -d '{"source_image_url": "https://cdn.example.com/photo.jpg"}'
 ```
 
-## Primitive: image_remove_background_greenscreen
-
-Cheap **local chroma-key** background removal — no third-party API, just `sharp` doing per-pixel color-distance keying, so it costs a fraction of `image_remove_background`. Use it whenever the source sits on a **flat, solid, evenly-lit background**: a green screen, or any single fill color you pass via `key_color` (e.g. `#FFFFFF` for a white background, `#0047BB` for blue). The result is a transparent PNG/WebP at a durable Vidfarm URL.
-
-- `POST /api/v1/primitives/images/remove-background-greenscreen` (flat alias: `POST /api/v1/primitives/remove-background-greenscreen`)
-- Body: `{ "tracer": "...", "payload": { "source_image_url": "https://...", "key_color"?: "#00FF00", "tolerance"?: 0.3, "softness"?: 0.1, "despill"?: true, "output_format"?: "png" | "webp" }, "webhook_url"?: "..." }`
-  - `key_color` — the background color to key out (hex / `rgb(...)` / named `green`/`white`/`blue`/`black`). Default `#00FF00`.
-  - `tolerance` (0–1, default `0.3`) — how close a pixel must be to `key_color` to be removed. Raise it if fringe survives, lower it if the subject is being eaten.
-  - `softness` (0–1, default `0.1`) — feather band beyond `tolerance` for anti-aliased edges.
-  - `despill` (default `true`) — suppresses the residual key-color rim on the subject's edges (only applied for chromatic keys like green/blue).
-- Response: standard primitive job; poll for completion, then read `image.file_url` / `primary_file_url`. `keyed_fraction` in the output tells you what share of pixels were removed (near-0 usually means the wrong `key_color` or too-low `tolerance`).
-- Billing: small compute-only wallet fee (`greenscreen_chroma_key` cost center) — cheaper than the RapidAPI route.
+## Primitive: remove-greenscreen (image **or** video chroma-key)
+
+**Local chroma-key** background removal for an IMAGE **or** a VIDEO — no third-party API, so it costs a fraction of `image_remove_background`. Use it whenever the source sits on a **flat, solid, evenly-lit background**: a green screen, or any single fill color. An IMAGE returns a transparent PNG/WebP; a VIDEO returns a transparent **WebM (VP9 alpha)** that stays transparent in the `/editor` preview AND the final render (it composites over whatever layers sit behind it).
+
+- **Unified (auto-detect):** `POST /api/v1/primitives/remove-greenscreen` — detects image vs video from the source and dispatches. Preferred entry point.
+- Image-only: `POST /api/v1/primitives/images/remove-background-greenscreen` (flat alias: `POST /api/v1/primitives/remove-background-greenscreen`). Video-only: `POST /api/v1/primitives/videos/remove-greenscreen`.
+- Body: `{ "tracer": "...", "payload": { "source_url": "https://..." (image OR video), "media_type"?: "image" | "video" (skip auto-detect), "preset"?: "green" | "digital-green" | "blue" | "white" | "black" | "magenta", "key_color"?: "#00FF00", "tolerance"?: 0.3, "softness"?: 0.1, "despill"?: true, "output_format"?: "png" | "webp" (image only) }, "webhook_url"?: "..." }`
+  - `preset` — pick a common background color by name; fills `key_color` + tuned defaults. `key_color` (hex / `rgb(...)` / named) overrides the preset for a custom color/range.
+  - `tolerance` (0–1) — how close a pixel must be to key it out. Raise it if fringe survives, lower it if the subject is eaten. `softness` (0–1) feathers the edge; `despill` (default `true`) trims the residual key-color rim (green/blue only).
+- Response: standard primitive job; poll, then read `primary_file_url` (a `.png/.webp` for image, `.webm` for video). After keying, `set_layer_media` the URL back onto the source layer to swap the transparent cut-out in place.
+- Billing: the **real measured AWS compute cost × 1.2** (`greenscreen_chroma_key` cost center) — no flat fee. Far cheaper than the RapidAPI matting route.
 
 ## Primitive: media_overlay ("create media overlay" — Vox-style)
 

package/SKILL.director.md

@@ -986,7 +986,7 @@ If a local AI script rewrites text or scenes without consuming those files first
 | `vidfarm generate <image\|video> --prompt "…"` | `POST /api/v1/primitives/{images,videos}/generate` (polls job) | generate AI media → finished URL |
 | `vidfarm inpaint <image> --mask <png> --prompt "…" [--region "label=…"] [--ref …] [--out <f>]` | `POST /api/v1/primitives/images/inpaint` (polls job) | masked image EDIT — replace ONLY the transparent-mask region, keep everything else (devcli twin of the /inpaint page) |
 | `vidfarm create-overlay "<subject>" [--key-color #00FF00] [--aspect-ratio 1:1] [--place <dir>] [--out <f>]` | `POST /api/v1/primitives/images/create-overlay` (polls job) | **Vox-style** transparent OVERLAY — AI image on a forced key-color background, chroma-keyed out in one job → ready-to-composite transparent PNG |
-| `vidfarm remove-background-greenscreen <image> [--key-color #00FF00] [--tolerance 0.3] [--out <f>]` | `POST /api/v1/primitives/images/remove-background-greenscreen` (polls job) | cheap chroma-key removal of a FLAT solid background → transparent PNG (cloud primitive) |
+| `vidfarm remove-greenscreen <image\|video> [--preset green\|blue\|white\|black\|digital-green\|magenta] [--key-color #00FF00] [--tolerance 0.3] [--local] [--out <f>]` | `POST /api/v1/primitives/remove-greenscreen` (polls job) | chroma-key a FLAT solid background → transparent PNG/WebP (image) or WebM/VP9-alpha (video); auto-detects media kind. `--local` runs it FREE in-process (sharp/ffmpeg, no wallet); default cloud is billed at real compute × 1.2. Aliases: `greenscreen`, `remove-background-greenscreen`. |
 | `vidfarm tts "…" [--style "…"] [--voice <v>] [--out <file>]` | (LOCAL-FIRST: your own OPENAI/GEMINI/OPENROUTER_API_KEY → audio file on disk; `--cloud` = `POST /api/v1/primitives/audio/speech` + poll, ElevenLabs on the platform key by default, `--own-key` for yours) | text → narration audio; `--cloud --voice <voice_id>` picks an ElevenLabs voice |
 | `vidfarm music "<prompt>" [--length <sec>] [--out <f>] [--own-key]` | `POST /api/v1/primitives/music/generate` (polls job) | prompt → music track (ElevenLabs; platform key + wallet by default, `--own-key` for yours) |
 | `vidfarm voices [--own-key] [--limit N]` | `GET /api/v1/primitives/audio/voices` | list ElevenLabs voices (voice_id/name/labels) for `tts --voice`; default a voice + tell the user they can choose |
@@ -1157,18 +1157,17 @@ curl -X POST "$VIDFARM_BASE/api/v1/primitives/images/remove-background" \
   -d '{"source_image_url": "https://cdn.example.com/photo.jpg"}'
 ```
 
-## Primitive: image_remove_background_greenscreen
+## Primitive: remove-greenscreen (image **or** video chroma-key)
 
-Cheap **local chroma-key** background removal — no third-party API, just `sharp` doing per-pixel color-distance keying, so it costs a fraction of `image_remove_background`. Use it whenever the source sits on a **flat, solid, evenly-lit background**: a green screen, or any single fill color you pass via `key_color` (e.g. `#FFFFFF` for a white background, `#0047BB` for blue). The result is a transparent PNG/WebP at a durable Vidfarm URL.
+**Local chroma-key** background removal for an IMAGE **or** a VIDEO — no third-party API, so it costs a fraction of `image_remove_background`. Use it whenever the source sits on a **flat, solid, evenly-lit background**: a green screen, or any single fill color. An IMAGE returns a transparent PNG/WebP; a VIDEO returns a transparent **WebM (VP9 alpha)** that stays transparent in the `/editor` preview AND the final render (it composites over whatever layers sit behind it).
 
-- `POST /api/v1/primitives/images/remove-background-greenscreen` (flat alias: `POST /api/v1/primitives/remove-background-greenscreen`)
-- Body: `{ "tracer": "...", "payload": { "source_image_url": "https://...", "key_color"?: "#00FF00", "tolerance"?: 0.3, "softness"?: 0.1, "despill"?: true, "output_format"?: "png" | "webp" }, "webhook_url"?: "..." }`
-  - `key_color` — the background color to key out (hex / `rgb(...)` / named `green`/`white`/`blue`/`black`). Default `#00FF00`.
-  - `tolerance` (0–1, default `0.3`) — how close a pixel must be to `key_color` to be removed. Raise it if fringe survives, lower it if the subject is being eaten.
-  - `softness` (0–1, default `0.1`) — feather band beyond `tolerance` for anti-aliased edges.
-  - `despill` (default `true`) — suppresses the residual key-color rim on the subject's edges (only applied for chromatic keys like green/blue).
-- Response: standard primitive job; poll for completion, then read `image.file_url` / `primary_file_url`. `keyed_fraction` in the output tells you what share of pixels were removed (near-0 usually means the wrong `key_color` or too-low `tolerance`).
-- Billing: small compute-only wallet fee (`greenscreen_chroma_key` cost center) — cheaper than the RapidAPI route.
+- **Unified (auto-detect):** `POST /api/v1/primitives/remove-greenscreen` — detects image vs video from the source and dispatches. Preferred entry point.
+- Image-only: `POST /api/v1/primitives/images/remove-background-greenscreen` (flat alias: `POST /api/v1/primitives/remove-background-greenscreen`). Video-only: `POST /api/v1/primitives/videos/remove-greenscreen`.
+- Body: `{ "tracer": "...", "payload": { "source_url": "https://..." (image OR video), "media_type"?: "image" | "video" (skip auto-detect), "preset"?: "green" | "digital-green" | "blue" | "white" | "black" | "magenta", "key_color"?: "#00FF00", "tolerance"?: 0.3, "softness"?: 0.1, "despill"?: true, "output_format"?: "png" | "webp" (image only) }, "webhook_url"?: "..." }`
+  - `preset` — pick a common background color by name; fills `key_color` + tuned defaults. `key_color` (hex / `rgb(...)` / named) overrides the preset for a custom color/range.
+  - `tolerance` (0–1) — how close a pixel must be to key it out. Raise it if fringe survives, lower it if the subject is eaten. `softness` (0–1) feathers the edge; `despill` (default `true`) trims the residual key-color rim (green/blue only).
+- Response: standard primitive job; poll, then read `primary_file_url` (a `.png/.webp` for image, `.webm` for video). After keying, `set_layer_media` the URL back onto the source layer to swap the transparent cut-out in place.
+- Billing: the **real measured AWS compute cost × 1.2** (`greenscreen_chroma_key` cost center) — no flat fee. Far cheaper than the RapidAPI matting route.
 
 ## Primitive: media_overlay ("create media overlay" — Vox-style)
 

package/dist/src/cli.js

@@ -22,7 +22,7 @@ import { renderCompositionStills } from "./devcli/stills.js";
 import { runDoctorCommand } from "./devcli/doctor.js";
 import { runSkillsCommand } from "./devcli/skills.js";
 import { initTelemetry, reportCliCrash } from "./devcli/telemetry.js";
-import { resolveLocalDataDir, localBackendAvailable, LocalModeUnavailableError } from "./devcli/local-backend.js";
+import { resolveLocalDataDir, localBackendAvailable, LocalModeUnavailableError, localApiRequest } from "./devcli/local-backend.js";
 // vidfarm-devcli — command-line bridge for the Vidfarm video studio. The
 // `serve` command boots the FULL editor locally (single origin, disk-backed
 // records + storage) so power users edit compositions on disk while a browser
@@ -172,14 +172,20 @@ Generate AI media and drop it on the timeline (for local coding agents):
     --out <file>            Download the transparent PNG to this path
     --no-wait               Return the job id instead of polling to the URL
     --place <dir> --at <time>|--replace <layer_key>   Fuse onto a composition
-  remove-background-greenscreen <image|url>   Cheap chroma-key removal of a FLAT
-                            solid background → transparent PNG (cloud primitive;
-                            differs from remove-background = local ONNX matting)
-                            → POST /api/v1/primitives/images/remove-background-greenscreen
-    --key-color <c>         Background color to key out (default #00FF00; e.g. #FFFFFF)
+  remove-greenscreen <image|video|url>   Key out a FLAT solid background from an
+                            IMAGE (→ transparent PNG/WebP) or VIDEO (→ transparent
+                            WebM/VP9 alpha), auto-detecting the media kind.
+                            (aliases: greenscreen, remove-background-greenscreen)
+                            → POST /api/v1/primitives/remove-greenscreen
+    --preset <name>         green | digital-green | blue | white | black | magenta
+    --key-color <c>         Custom background color (hex/rgb/named; overrides --preset)
+    --media-type <k>        Force image|video instead of auto-detecting
     --tolerance <0..1>      Key radius (default 0.3); --softness <0..1> edge feather (0.1)
     --no-despill            Skip edge color-fringe suppression
-    --out <file>            Download the transparent PNG to this path
+    --output-format <f>     Image only: png|webp
+    --local                 Run the keyer in-process for FREE (sharp/ffmpeg, no wallet)
+    --cloud                 Force the billed cloud primitive (default when a key is set)
+    --out <file>            Download the transparent result to this path
   place <dir|composition.html>   Insert media into a local composition
                             (fill a gap, replace a scene, or overlay an AUDIO
                             track) — same clip markup the browser editor makes;
@@ -667,10 +673,11 @@ async function main() {
         case "overlay":
             await runCreateOverlayCommand(rest);
             return;
+        case "remove-greenscreen":
         case "remove-background-greenscreen":
         case "rmbg-green":
         case "greenscreen":
-            await runRemoveBackgroundGreenscreenCommand(rest);
+            await runRemoveGreenscreenCommand(rest);
             return;
         case "tts":
             await runTtsCommand(rest);
@@ -3585,33 +3592,67 @@ async function runCreateOverlayCommand(argv) {
     }
 }
 // ── Green-screen (chroma-key) background removal ──────────────────────────────
-// The devcli twin of the image_remove_background_greenscreen primitive: cheap
-// local chroma key on a flat, solid background. A cloud primitive job (distinct
-// from `vidfarm remove-background`, which is the free LOCAL ONNX matting engine).
-async function runRemoveBackgroundGreenscreenCommand(argv) {
+// The devcli twin of the remove-greenscreen primitive: key out a flat, solid
+// background from an IMAGE (→ transparent PNG/WebP) OR a VIDEO (→ transparent
+// WebM/VP9 alpha), auto-detecting the media kind. LOCAL vs CLOUD: --local runs
+// the keyer in-process for FREE (sharp/ffmpeg, no wallet); --cloud runs the
+// billed primitive. Default = cloud (paid), unless there's no cloud key AND the
+// local backend is present (free / offline), in which case it runs local.
+const GREENSCREEN_PRESET_NAMES = new Set(["green", "digital-green", "blue", "white", "black", "magenta"]);
+function resolveGreenscreenTarget(values) {
+    if (values.local)
+        return "local";
+    if (values.cloud)
+        return "cloud";
+    const env = (process.env.VIDFARM_TARGET ?? "").trim().toLowerCase();
+    if (env === "local" || env === "cloud")
+        return env;
+    const hasCloudKey = Boolean(values["api-key"] ?? process.env.VIDFARM_API_KEY);
+    if (!hasCloudKey && localBackendAvailable())
+        return "local";
+    return "cloud";
+}
+async function runRemoveGreenscreenCommand(argv) {
     const parsed = parseArgs({
         args: argv,
         allowPositionals: true,
         options: {
             ...commonOptions(),
             source: { type: "string" },
+            preset: { type: "string" },
+            "media-type": { type: "string" },
             "key-color": { type: "string" },
             tolerance: { type: "string" },
             softness: { type: "string" },
             "no-despill": { type: "boolean", default: false },
             "output-format": { type: "string" },
+            local: { type: "boolean", default: false },
+            cloud: { type: "boolean", default: false },
             out: { type: "string" },
             "no-wait": { type: "boolean", default: false },
             tracer: { type: "string" }
         }
     });
     const ctx = commonContext(parsed.values);
+    const target = resolveGreenscreenTarget(parsed.values);
+    if (target === "local" && !localBackendAvailable())
+        throw new LocalModeUnavailableError();
     const sourceArg = parsed.values.source ?? parsed.positionals[0];
     if (!sourceArg) {
-        throw new Error("remove-background-greenscreen requires a source image: `vidfarm remove-background-greenscreen <image|url> [--key-color #00FF00] [--out cutout.png]`.");
+        throw new Error("remove-greenscreen requires a source image or video: `vidfarm remove-greenscreen <image|video|url> [--preset green|blue|white|black|digital-green|magenta] [--key-color #00FF00] [--local] [--out cutout.png|.webm]`.");
     }
     const sourceUrl = await resolveSingleMediaUrl(ctx, sourceArg);
-    const payload = { source_image_url: sourceUrl };
+    const presetRaw = parsed.values.preset?.trim().toLowerCase();
+    if (presetRaw && !GREENSCREEN_PRESET_NAMES.has(presetRaw)) {
+        throw new Error(`Unknown --preset "${presetRaw}". Choose one of: ${[...GREENSCREEN_PRESET_NAMES].join(", ")}, or pass --key-color <hex>.`);
+    }
+    const mediaTypeArg = parsed.values["media-type"]?.trim().toLowerCase();
+    const mediaType = mediaTypeArg === "image" || mediaTypeArg === "video"
+        ? mediaTypeArg
+        : (/\.(mp4|mov|webm|m4v|mkv)(\?|#|$)/i.test(sourceUrl) ? "video" : "image");
+    const payload = { source_url: sourceUrl, media_type: mediaType };
+    if (presetRaw)
+        payload.preset = presetRaw;
     if (parsed.values["key-color"])
         payload.key_color = parsed.values["key-color"];
     if (parsed.values.tolerance)
@@ -3620,12 +3661,17 @@ async function runRemoveBackgroundGreenscreenCommand(argv) {
         payload.softness = Number(parsed.values.softness);
     if (parsed.values["no-despill"])
         payload.despill = false;
-    if (parsed.values["output-format"])
+    if (mediaType === "image" && parsed.values["output-format"])
         payload.output_format = parsed.values["output-format"];
-    const tracer = parsed.values.tracer ?? `devcli-gsbg-${Date.now().toString(36)}`;
-    const submit = await apiRequest({ method: "POST", host: ctx.host, path: "/api/v1/primitives/images/remove-background-greenscreen", auth: ctx.auth, body: { tracer, payload } });
-    assertApiOk(submit, "remove-background-greenscreen");
+    const tracer = parsed.values.tracer ?? `devcli-greenscreen-${Date.now().toString(36)}`;
+    const route = "/api/v1/primitives/remove-greenscreen";
+    const submit = target === "local"
+        ? await localApiRequest({ method: "POST", path: route, auth: ctx.auth, body: { tracer, payload }, home: ctx.home })
+        : await apiRequest({ method: "POST", host: ctx.host, path: route, auth: ctx.auth, body: { tracer, payload } });
+    assertApiOk(submit, "remove-greenscreen");
     const jobId = submit.json?.job_id;
+    if (!ctx.json)
+        console.log(`${DIM}${target === "local" ? "Local (free)" : "Cloud"} ${mediaType} greenscreen removal…${RESET}`);
     const wait = !parsed.values["no-wait"];
     if (!wait || !jobId) {
         if (!ctx.json && jobId)
@@ -3635,7 +3681,7 @@ async function runRemoveBackgroundGreenscreenCommand(argv) {
     }
     if (!ctx.json)
         console.log(`${DIM}Keying out background (${jobId})… polling every 5s.${RESET}`);
-    const job = await pollPrimitiveJob(ctx, jobId);
+    const job = await pollGreenscreenJob(ctx, target, jobId);
     const mediaUrl = resolveJobMediaUrl(job);
     const status = String(job?.status ?? "");
     if (!mediaUrl) {
@@ -3655,12 +3701,38 @@ async function runRemoveBackgroundGreenscreenCommand(argv) {
         await downloadUrlToFile(mediaUrl, outPath);
     }
     if (ctx.json) {
-        printJson({ ok: true, job_id: jobId, media_url: mediaUrl, out: outPath, keyed_fraction: job?.result?.keyed_fraction ?? null });
+        printJson({ ok: true, job_id: jobId, media_type: mediaType, target, media_url: mediaUrl, out: outPath });
     }
     else {
-        console.log(`${GREEN}Transparent cut-out ready:${RESET} ${mediaUrl}`);
+        console.log(`${GREEN}Transparent ${mediaType === "video" ? "WebM" : "cut-out"} ready:${RESET} ${mediaUrl}`);
         if (outPath)
             console.log(`${DIM}Saved to ${outPath}${RESET}`);
+        console.log(`${DIM}Place it with: vidfarm set-media <dir> --src "${mediaUrl}" --replace <layer_key> (keeps its transparency).${RESET}`);
+    }
+}
+// Poll a greenscreen job through the same backend it was submitted to (local
+// in-process app or cloud). Mirrors pollPrimitiveJob's terminal conditions.
+async function pollGreenscreenJob(ctx, target, jobId) {
+    if (target !== "local")
+        return pollPrimitiveJob(ctx, jobId);
+    const MAX_WAIT_MS = 8 * 60 * 1000;
+    const startedAt = Date.now();
+    let last = null;
+    for (;;) {
+        await sleep(5000);
+        const res = await localApiRequest({ method: "GET", path: `/api/v1/user/me/jobs/${encodeURIComponent(jobId)}`, auth: ctx.auth, home: ctx.home });
+        if (res.ok && res.json) {
+            last = res.json;
+            const status = String(last.status ?? "");
+            if (!ctx.json)
+                console.log(`${DIM}  ${status}${typeof last.progress === "number" ? ` ${Math.round(last.progress * 100)}%` : ""}${RESET}`);
+            if (status === "succeeded" || status === "failed" || status === "cancelled")
+                return last;
+            if (resolveJobMediaUrl(last))
+                return last;
+        }
+        if (Date.now() - startedAt > MAX_WAIT_MS)
+            return last ?? { status: "timeout" };
     }
 }
 // ── Speech: tts / stt ────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mevdragon/vidfarm-devcli",
-  "version": "0.20.9",
+  "version": "0.20.11",
   "description": "Local bridge for the Vidfarm Trackpad Editor. `vidfarm serve <template_id>` boots the FULL editor on localhost (disk-backed records/storage, free in-process render); edit composition.html on disk (Claude Code, Codex, etc.) and the browser live-morphs it.",
   "type": "module",
   "bin": {