venice-video-harness 2.18.0 → 2.19.0

package/.agents/skills/venice-video-model-routing/SKILL.md

@@ -318,6 +318,64 @@ Generate consistent storyboard panels using two Venice models in sequence:
 
 Construct prompts differently depending on the resolved model's capabilities:
 
+### Simple-Prompt Models (MiniMax H3 Max, H3 Max Turbo)
+
+Read this before anything else in this section: everything below assumes a model that
+renders what it is told and drifts when it is not. The H3 Max pair is the opposite, and
+the registry marks it with `promptStyle: 'simple'` (`modelWantsSimplePrompt(modelId)`).
+These models compose their own coverage — framing, cutting, beat rhythm — from one plain
+statement of intent, and the directorial stack fights the shot the model would otherwise
+have chosen.
+
+`buildVideoPrompt()` and `buildMontagePrompt()` already drop the heavy blocks for them, so
+the adaptation is mostly a matter of not writing them back in by hand:
+
+- **Dropped:** the authored `Blocking:` restatement, the location description and
+  `spatialAnchors` "Fixed layout (never rearrange)" line, the geography-hold /
+  no-mirroring lecture, and the full aesthetic string (the compact one is used instead).
+- **Kept:** `@ImageN` identity declarations and role clauses on the R2V lane, the beat
+  description, dialogue with delivery, and the audio-exclusion suffix. Identity and look
+  still have to be bound; only the staging instructions go.
+- **Dialogue is IMPROVISED, not scripted.** These models carry natural, continuous speech
+  across a whole generation and degrade when handed an exact line to recite. So in
+  native-dialogue mode the prompt gives the scripted line as INTENT — `[@Image1, voice,
+  delivery] conveys: "…"` plus a one-line "improvise naturally in character, keep the intent
+  and tone, don't recite word for word" note — instead of the directorial `[…]: "exact line"`
+  quote. `buildVideoPrompt` / `buildMontagePrompt` do this automatically via
+  `shouldImproviseDialogue(modelId, series)` (gated on `modelWantsSimplePrompt` +
+  `audioStrategy !== 'lip-sync'`). Do NOT hand-write exact quotes for these models expecting
+  them verbatim. The exception is **exact-lip-sync**, where the `audio_url` drives the exact
+  words, so the line stays verbatim. One consequence: captions must come from transcribing
+  the rendered audio, not from `script.json` (the model won't say it word for word).
+- **Don't** add camera terms, shot lists, or `Lens switch.` lines per beat. State the
+  sequence in a sentence or two and let the model cut it — that instinct is why this is
+  the montage family.
+- Resolution is pinned to **768P** by default (2K is a hard 400 — the inverse of plain
+  MiniMax H3, which is 2K-only). **480P is the draft tier** and is only selected via an
+  explicit `resolution` override on `renderVideoFile`. Durations run the 5-15s ladder.
+  `audio` is not configurable, so the field is omitted from the body entirely.
+- Turbo ships **no R2V lane**; identity and lip-sync shots cross to
+  `minimax-h3-max-reference-to-video`.
+
+**Loop mode uses this family, with two modes.** `venice-video loop` renders the whole shot
+script continuously and plays it as a live browser loop that hot-swaps in fresh takes:
+
+- `--mode watch` (default) — `minimax-h3-max-turbo-text-to-video` (or `-image-to-video` off
+  an existing panel) at 480P, ~$0.012/s. The cheapest lane; a disposable draft that does NOT
+  lock identity (Turbo has no R2V lane).
+- `--mode create` — the real reference-first routing on the **non-Turbo** H3 Max family at
+  768P (~$0.024/s): character shots on `minimax-h3-max-reference-to-video` with the full
+  `@Image` reference stack + voice-donor audio (identity locked, takes usable), atmosphere on
+  Max i2v/t2v. Shots with missing references degrade to i2v/t2v.
+
+Both skip the storyboard/QA gates and write only under `loop/`. See `LoopEngine`
+(`src/mini-drama/loop-engine.ts`) and AGENTS.md rule 58. Watch is a preview, not a production
+path; create is the "keep the good takes" path.
+
+The Creator app mirrors this: `VideoModelCapabilities.wantsSimplePrompt(id:)` gates the
+same trimming in `ShotPromptBuilder`, and relaxes the `produce_shots` motion/length gate
+so a correctly short H3 Max prompt isn't rejected as thin.
+
 ### Image-Tag R2V Models (Seedance 2.0 R2V Enhanced — default for all lanes)
 
 - Replace character names in descriptions with `@Image1`, `@Image2` tokens via regex
@@ -454,6 +512,9 @@ Seedance 2.0 (now the default for both atmosphere and character shots) accepts *
 - **Omitting `aspect_ratio` from R2V models:** Both Seedance R2V and Kling O3 R2V require `aspect_ratio`. If omitted, it defaults to `16:9` in code. Always pass `aspect_ratio` explicitly.
 - **Sending `image_references`/`image_1` to `nano-banana-pro`:** Returns 400. The generation model does not accept reference payloads at all.
 - **Sending invalid durations:** Seedance 2.0 accepts 4s/5s/8s/10s/12s/15s. Veo 3.1 accepts 4s/6s/8s. Duration auto-snap corrects this.
+- **Sending `2K` to MiniMax H3 Max, or `768P` to plain MiniMax H3:** The two families share a name and invert on resolution. H3 is 2K-only; H3 Max and H3 Max Turbo top out at 768P and reject 2K. `video-generator.ts` pins each family, and the `-max` branch has to stay above the `minimax-h3` substring match or every H3 Max render 400s.
+- **Reaching for `minimax-h3-max-turbo-reference-to-video`:** It doesn't exist ("Specified model not found"). Turbo has no R2V lane; identity shots route to `minimax-h3-max-reference-to-video`.
+- **Sending `audio` to any MiniMax H3 family model:** `audioConfigurable: false` — audio is always generated and the field must be omitted from the body, not set to `true`.
 - **Reference images below 300x300:** R2V models reject `reference_image_urls` and `elements` images smaller than 300x300 pixels. Never downscale character references below this threshold.
 - **Seedance + non-seedream face images (no longer an issue, 2026-07):** Venice removed the restriction that Seedance 2.0 only accepts face-bearing input images from `seedream-v5-lite` / `seedream-v5-lite-edit`. Any image family now works for face-bearing inputs, so there's nothing to pair, reroute, or launder — the pre-flight gate is a no-op.
 
@@ -471,6 +532,11 @@ Seedance 2.0 (now the default for both atmosphere and character shots) accepts *
 - **Sequential action in image descriptions:** Causes comic-panel layouts instead of single frames. Separate the single-frame panel description from the full video action description.
 - **Vague body orientation:** Produces twisted poses. Always specify full-body direction explicitly (e.g., "seen entirely from behind", "facing camera directly").
 
+### Prompt-Style Mismatches
+
+- **Over-directing a simple-prompt model:** Hand-writing blocking, per-beat camera terms, `Lens switch.` lines, or geography-hold clauses into a MiniMax H3 Max prompt flattens the result — it stages its own coverage and the clauses fight it. The prompt builder strips these automatically; don't re-add them via authored shot fields expecting them to help.
+- **Padding an H3 Max prompt to clear the motion gate:** The Creator's `produce_shots` money gate normally demands 12+ words and motion vocabulary. For simple-prompt models it only asks for a stated subject and setting. Inflating a short, correct prompt to satisfy the old bar is the failure, not the fix.
+
 ### Style Consistency Failures
 
 - **Aesthetic description buried at end of prompt:** The model commits to a rendering style before reaching the style instructions, causing inconsistency between angles/shots. Always front-load style with a `STYLE:` prefix and add a `STYLE REMINDER:` suffix.

package/AGENTS.md

@@ -123,6 +123,44 @@ The full model registry lives in `src/venice/models.ts` with typed specs for eve
 - **R2V is pure-reference-only.** Sending `image_url` (or `end_image_url`) alongside `reference_image_urls` is a hard 400: *"image_url and end_image_url cannot be combined with reference media for this model."* `minimax-h3-reference-to-video` is therefore in `MODELS_USING_IMAGE_TAGS`, which is what puts the generator in pure reference mode. It honors `@ImageN` tags — verified by paid render, both tagged characters landed on their assigned `@Image1` / `@Image2` slots.
 - **Reference aspect influences output orientation, so keep a 16:9 plate in the stack.** With the harness's normal slot plan (1:1 character sheets + the 16:9 storyboard blocking plate) and `aspect_ratio: '16:9'`, a paid render returned a true 2560×1440. But a stack of uniformly portrait references returned 1440×1920 *despite* `aspect_ratio: '16:9'` — the requested ratio did not override them. Character-only H3 shots with no blocking plate are the orientation risk; check the first-frame contact sheet before assembling.
 
+**MiniMax H3 Max / H3 Max Turbo (added 2026-09-03):**
+- `minimax-h3-max-text-to-video` / `-image-to-video` / `-reference-to-video`, and
+  `minimax-h3-max-turbo-text-to-video` / `-image-to-video`.
+- **Related to MiniMax H3 in name only.** Four differences, each of which costs
+  a render if you assume H3 behavior:
+  - **768P, and 2K is a hard 400** (`Expected '480P' | '768P'`) — the exact
+    inverse of base H3. The generator's resolution pin matches
+    `minimax-h3-max` *before* `minimax-h3` for this reason; do not reorder
+    those branches. 480P is the draft tier, 768P the finish.
+  - **They want plain prompts** (`promptStyle: 'simple'` in the registry).
+    These models stage their own framing, coverage, and cutting from a stated
+    intent, and the directorial stack overrides that instinct. `buildVideoPrompt`
+    and `buildMontagePrompt` drop blocking, the locked location description, and
+    the geography-hold paragraphs for them; identity (`@ImageN`), the beat, the
+    line, the sound, and a compact look survive. Use `modelWantsSimplePrompt(id)`
+    rather than an id check when adding new behavior.
+  - **`private` tier** (H3 is `anonymized`), and uncensored. Prompt cap 10000
+    chars, though the useful prompt is a couple of sentences.
+  - **Price.** $0.024/s for H3 Max and $0.012/s for Turbo at 768P, against
+    $0.10/s for base H3 — Turbo is the cheapest lane in the registry, cheap
+    enough that a 15s take is disposable: render several and pick.
+- **Best used for montages and single-take storytelling.** This is where the
+  simple-prompt instinct pays: describe the sequence and let the model cut it.
+  Note the montage window now derives from the montage model's own ladder, so
+  H3 Max montages plan at 5-15s rather than Seedance's 30s.
+- Shared with H3: the 5-15s ladder (4s is a hard 400) and native audio that is
+  **not** toggleable, so the generator omits the `audio` field entirely.
+- **Turbo has no R2V lane.** `minimax-h3-max-turbo-reference-to-video` is
+  "Specified model not found", so the `minimax-h3-max-turbo` family routes
+  character-consistency and lip-sync shots to `minimax-h3-max-reference-to-video`.
+- R2V is treated as pure-reference (in `MODELS_USING_IMAGE_TAGS`) like H3 R2V.
+  Note the difference from H3: `/video/quote` *accepted* `image_url` alongside
+  `reference_image_urls` here, but quote validates less than queue, and
+  pure-reference is the right mode regardless — it keeps compositional
+  authority with the reference stack and is what makes `@ImageN` resolve.
+- i2v lanes inherit aspect from the start image and expose no `aspect_ratios`;
+  t2v and R2V accept `16:9 / 21:9 / 4:3 / 1:1 / 3:4 / 9:16`.
+
 **Long Duration:**
 - `longcat-image-to-video` / `longcat-distilled-image-to-video` (up to **30s**, no audio)
 - `ltx-2-fast-image-to-video` / `ltx-2-v2-3-fast-image-to-video` (up to **20s**, up to 4K)
@@ -440,6 +478,10 @@ Use `POST /video/quote` (via `quoteVideo()`) to estimate costs before committing
 
 57. **The browser UI is the built-in node web app — default to `venice-video web`.** When the operator asks for a browser UI, a dashboard, or to "open the harness in a browser," start the bundled local web app: `venice-video web` (browser dashboard + a whitelisted command runner over the workspace; binds localhost only, `http://127.0.0.1:3000` by default). Do NOT scaffold a separate/ad-hoc UI or point them at anything else. Per the workspace dev-server rule, kill existing node processes first and run on port 3000. The compiled front-end ships inside the npm package (`dist/web/ui/dist`); `npm run web:build` rebuilds it. Command lives in `src/mini-drama/cli.ts` (`web`), server in `src/web/server.ts`.
 
+58. **Loop mode has two modes — a disposable Turbo draft (watch) and an identity-locked Max R2V create — both gate-skipping and money-capped (2026-09-04).** `venice-video loop -p <project> -e <n> [--mode watch|create]` boots the web UI (Loop tab) plus an in-process `LoopEngine` (`src/mini-drama/loop-engine.ts`) that renders every shot into `episodes/episode-NNN/loop/` and keeps regenerating fresh takes so the browser can watch the whole plan on repeat while it evolves. Both modes **bypass the references(only for watch) / storyboard / QA gates** — the only hard precondition is a shot script with ≥1 shot — and write ONLY under `loop/` (`shot-NNN--takeK.mp4` + `loop-manifest.json`), never touching canonical `scene-001/` renders or `series.json`, so a loop can run alongside real production. **The mode is the session's first, REQUIRED decision** — the `loop` command asks "is this for LOOPING (creative flow, lower quality) or PRODUCTION (gather usable shots, higher quality)?" It is a deliberate quality-vs-flow tradeoff, never a silent default: interactive `promptChoice` in a TTY, and a **hard error** in a non-interactive run with no `--mode` (agents MUST pass it). `--mode` accepts natural words — `looping`/`loop`/`fun`/`creative` → watch, `production`/`prod`/`gather` → create (`normalizeLoopMode`). Internally the modes are still `watch`/`create`. **The two modes are the point:** (a) **watch** (enjoyment / creative flow) = MiniMax H3 Max **Turbo** at 480P (~$0.012/s): the first generation is **t2v**, every shot after it **chains i2v off the previous last frame**, and it **NEVER uses R2V** (R2V renders are too slow for a loop, and Turbo has none anyway). It ignores panels and the reference stack — identity is NOT locked; it is a fast fun loop, never production-fidelity. (b) **create** (gather good shots for a project) = the real reference-first routing on the **non-Turbo** H3 Max family at 768P (~$0.024/s): character shots render on `minimax-h3-max-reference-to-video` with the full `@Image` reference stack + voice-donor audio (identity **locked**, takes usable), atmosphere shots on Max i2v/t2v, **each shot rendered independently (chaining OFF by default** — R2V and a start frame can't combine on MiniMax). Create degrades a character shot to i2v/t2v only when its references are missing on disk — so for create, generate character/location references first (rule 54). Both share the render primitive: create mode reuses `resolveShotReferenceInputs` + `ensureVoiceReferenceForShot` (exported from `video-generator.ts`, the SAME resolution `renderSingleShotUnit` uses), so its reference stack can't drift from the real pipeline. Other invariants: (c) **chaining default follows the mode:** watch chains (shot 1 t2v, every later shot i2v off the previous shot's current-take LAST frame via `extractLastFrame`, so the loop plays as one piece); create does NOT chain (each shot is independent R2V — chaining and R2V are mutually exclusive on MiniMax). `--no-chain` forces it off. Chaining uses a lean prompt because the start frame, not a reference stack, drives the render. (d) **Every take renders the model's full length (15s default)** — not the shot's scripted duration — for maximum footage/playback per render; override with `--duration`. (e) **The loop regenerates continuously** and does NOT settle after a fixed number of takes: `--max-takes` is a **ring buffer** (candidate takes kept per shot; older non-current takes are pruned and their files deleted so an infinite run can't fill the disk), NOT a stop condition. It stops only on Pause, `--once` (one pass), or the budget. (f) **Money:** billed at queue time; `--budget` (default $2) pauses the loop, and the UI **Resume** button (or a per-shot regenerate) authorizes another budget's worth via `engine.start()` — so "Start/Resume" always does something. `--unbounded` removes the budget cap (spends until stopped) but keeps the ring buffer. (g) Resolution is reachable because `renderVideoFile` honors an optional `resolution` override validated against the model's `resolutions` (it otherwise force-pins `768P` for every `minimax-h3-max*` id); **watch defaults 480P (the infinite-loop tier), create 768P**. (h) The engine shares the web server's `EventHub` and broadcasts `loop-updated` for instant hot-swap; the manifest (with `mode` + `chain`) also feeds `collectEpisodeState` so a plain `venice-video web` shows the last loop state. When changing loop behavior, keep `loop-engine.ts`, the `loop` command in `cli.ts`, the `/api/projects/:slug/loop/*` endpoints + `WebServerOptions.loop` in `src/web/server.ts`, `resolveShotReferenceInputs`/`extractLastFrame` in `video-generator.ts`, and the `LoopView` UI in sync.
+
+59. **MiniMax H3 Max (simple-prompt) models IMPROVISE dialogue — the scripted line is intent, not a script (2026-09-04).** Unlike Seedance/Wan, which render the exact line you give them, the H3 Max family (`promptStyle: 'simple'`) performs markedly better carrying natural, continuous speech across a whole generation than reciting a verbatim quote — a fixed line fights the model the same way the directorial blocks do. So in **native-dialogue mode** the prompt builders render a speaker's line as INTENT — `[@ImageN, voice, delivery] conveys: "…"` plus a one-line "improvise naturally in character, keep the meaning and tone, don't recite word for word" note — instead of the directorial `[…]: "exact line"` quote. This is automatic via `shouldImproviseDialogue(modelId, series)` in `prompt-builder.ts` (`modelWantsSimplePrompt(modelId)` AND `videoDefaults.audioStrategy !== 'lip-sync'`), applied in both `buildVideoPrompt` (singles) and `buildMontagePrompt` (montage) — the two paths the H3 Max family renders through. Directorial models keep the exact quote; the legacy Seedance-native / Kling multi-shot builders (`buildMultiShotPrompt`) are untouched because those lanes are never simple-prompt. **The exception is exact-lip-sync**: there the `audio_url` drives the exact spoken words, so the line stays verbatim (the improv gate excludes `audioStrategy === 'lip-sync'`). **Consequence:** when a simple-prompt model improvises, burned/exported captions must be derived by transcribing the rendered audio (the editing pipeline's `silencedetect`/whisper path), NOT from `script.json` — the model will not say it word for word. When changing this, keep `shouldImproviseDialogue` / `formatDialogueLine` / `IMPROV_DIALOGUE_NOTE` in `prompt-builder.ts` and this rule in sync.
+
 ## Learned Anti-Patterns (Production Issues Log)
 
 Issues discovered during production and their fixes. The agent should internalize these to avoid repeating them.

package/CHANGELOG.md

@@ -1,5 +1,111 @@
 # Changelog
 
+## 2.19.0 — 2026-09-04
+
+### Added
+
+- **`venice-video loop` — infinite loop mode (watch + create).** Boots the local
+  web UI (a new **Loop** tab) plus an in-process `LoopEngine`
+  (`src/mini-drama/loop-engine.ts`) that renders the approved shot script
+  continuously and plays the whole plan as a live browser loop, hot-swapping each
+  shot in as its take finishes and regenerating fresh takes while it plays. Two
+  modes, **chosen by a required decision at session start** — "is this for LOOPING
+  (creative flow, lower quality) or PRODUCTION (gather usable shots, higher
+  quality)?" — asked interactively in a terminal and a hard error in a
+  non-interactive run with no `--mode` (never a silent default). `--mode` accepts
+  natural words (`looping`/`loop`/`fun`, `production`/`prod`/`gather`). The modes:
+  **watch** (looping) renders
+  **MiniMax H3 Max Turbo at 480P** — the first generation is t2v, every later shot
+  chains i2v off the previous last frame, and it **never uses R2V** (too slow for
+  a loop); identity is NOT locked. **create** renders the **non-Turbo** H3 Max
+  family at 768P using the real reference-first routing — character shots on
+  `minimax-h3-max-reference-to-video` with the full `@Image` reference stack +
+  voice-donor audio (identity locked, takes usable), each shot rendered
+  independently, degrading to i2v/t2v when references are missing.
+  - **Continuous by default:** the loop regenerates forever (it does not stop
+    after N takes); `--max-takes` is a ring buffer (candidate takes kept per shot,
+    older ones pruned + deleted), not a stop condition. It stops only on Pause,
+    `--once`, or the budget.
+  - **Last-frame chaining** defaults to the mode (on for watch, off for create,
+    since R2V and a start frame can't combine on MiniMax); `--no-chain` forces it
+    off. Shot 1 renders normally, every later chained shot renders i2v off the
+    previous shot's last frame so the loop plays as one continuous piece.
+  - **Full-length takes:** every generation renders the model max (15s default),
+    override with `--duration`.
+  - **Budget as pause, not a hard stop:** `--budget` (default $2) pauses the loop;
+    the UI **Resume** button (and per-shot regenerate) authorizes another budget's
+    worth, so "Start/Resume" always does something. `--unbounded` removes the cap.
+  Both modes skip the storyboard/QA gates, write only under
+  `episodes/episode-NNN/loop/` (per-take mp4s + `loop-manifest.json`), and never
+  touch canonical renders or `series.json`. Resumable across restarts; pins and
+  per-shot regenerate from the UI. New
+  `/api/projects/:slug/loop/{state,start,stop,pin,regenerate}` endpoints, a shared
+  `EventHub` `loop-updated` event, and loop state surfaced through
+  `collectEpisodeState`. See AGENTS.md rule 58.
+- **MiniMax H3 Max (simple-prompt) models now improvise dialogue.** In
+  native-dialogue mode, `buildVideoPrompt` and `buildMontagePrompt` render a
+  speaker's scripted line as INTENT for these models — `[@ImageN, voice,
+  delivery] conveys: "…"` plus a "improvise naturally in character, keep the
+  meaning and tone, don't recite word for word" note — instead of the
+  directorial `[…]: "exact line"` quote. Gated on
+  `shouldImproviseDialogue(modelId, series)` (`modelWantsSimplePrompt` AND
+  `audioStrategy !== 'lip-sync'`). Seedance/Wan/Kling keep the exact quote, and
+  exact-lip-sync keeps the exact line (the `audio_url` drives the words). See
+  AGENTS.md rule 59. Note: captions for these shots should come from
+  transcribing the rendered audio, not `script.json`.
+- **`resolveShotReferenceInputs` / `ensureVoiceReferenceForShot` exported from
+  `video-generator.ts`.** The per-shot reference/scene/voice resolution block was
+  extracted from `renderSingleShotUnit` into a shared `resolveShotReferenceInputs`
+  helper (behavior-identical; `renderSingleShotUnit` now calls it) so loop create
+  mode resolves the exact same reference stack the real pipeline does instead of a
+  divergent copy.
+- **`resolution` override on `renderVideoFile`.** Honored only when the model
+  lists it (validated against the registry, else the family default applies), so
+  loop mode can pin H3 Max Turbo to its 480P draft tier without disturbing the
+  `768P`/`2K`/`720p` auto-pins every other path relies on.
+- **MiniMax H3 Max + H3 Max Turbo** (probe-verified 2026-09-03):
+  `minimax-h3-max-text-to-video` / `-image-to-video` / `-reference-to-video`
+  and `minimax-h3-max-turbo-text-to-video` / `-image-to-video`. 768P/480P,
+  5-15s, native non-toggleable audio, `private`, uncensored. $0.024/s and
+  $0.012/s at 768P (base H3 is $0.10/s). Turbo ships no R2V lane. Two new
+  video families — `minimax-h3-max` and `minimax-h3-max-turbo` — both routing
+  identity to `minimax-h3-max-reference-to-video`, which is the only lane in
+  the pair with `audio_input: true` and therefore also the family lip-sync model.
+- **`promptStyle` on `VideoModelSpec`, and a simple-prompt path in the prompt
+  builder.** H3 Max models are `promptStyle: 'simple'`: they stage their own
+  framing, coverage, and cutting from a plain statement of intent, and the
+  directorial stack flattens that. `buildVideoPrompt` and `buildMontagePrompt`
+  now drop spatial blocking, the locked location description, and the
+  geography-hold paragraphs for these models, and use the compact aesthetic
+  instead of the full one. Identity declarations, reference role clauses, the
+  beat, dialogue, sound, and the hard-cut instruction are kept — those are not
+  inferable. Gate new behavior on `modelWantsSimplePrompt(id)`, not id checks.
+  Every other family is unchanged (`'directorial'` is the default).
+
+### Fixed
+
+- **The resolution pin no longer sends H3 Max to 2K.** `renderVideoFile` matched
+  `minimax-h3` by substring, so every `minimax-h3-max-*` render would have been
+  pinned to `2K` — a hard 400 on those models. The `minimax-h3-max` branch now
+  precedes it and pins `768P`.
+- **Montage windows are bounded by the montage model, not a flat 30s.**
+  `resolveMontageMaxDurationSec` accepted a `montageModel` and ignored it,
+  always returning Seedance 2.5's 30s ceiling. Pointing `montageModel` at any
+  shorter-ladder model (H3 Max tops out at 15s) therefore planned 30s units
+  that all failed `assertShotDurationsValid` *after* the plan was written. The
+  ceiling now comes from the model's `maxDurationSec` and an explicit
+  `montageMaxDurationSec` is clamped to it. New `resolveMontageMinDurationSec`
+  does the same for the floor, so H3 Max montages respect its 5s ladder start
+  instead of Seedance's 4s.
+- **Registry resolution ORDER is now load-bearing, and the Creator app honors
+  it.** The app defaults to the first allowed resolution whenever a plan's own
+  value isn't offered, and Venice's live `/models` lists H3 Max as
+  `["480P", "768P"]` — so the app would have rendered every H3 Max shot at its
+  draft tier. H3 Max entries list `['768P', '480P']` deliberately, and the app
+  reorders the live list to follow the manifest
+  (`VideoModelCapabilities.preferredResolutionOrder`). When editing a
+  `resolutions` array, treat position 0 as the default, not as arbitrary.
+
 ## 2.18.0 — 2026-08-21
 
 ### Added

package/README.md

@@ -552,6 +552,8 @@ Live catalog (synced against `GET /api/v1/models?type=video` — 103 entries). F
 | **HappyHorse 1.1** | i2v, R2V (up to 9 refs) | t2v | 15s | Yes (joint single-pass, 7-lang phoneme lip-sync) | **#1 blind-preference T2V + I2V** (Alibaba 15B). 3-15s, 720p/1080p, nine aspect ratios. Best for talking characters + multilingual localization; SFW/commercial-leaning. The `happyhorse` video-family now routes here. |
 | **HappyHorse 1.0** | i2v, R2V | t2v | 15s | Yes | Prior line, kept for back-compat. Livelier hand-camera realism / cinematic grain vs Seedance. |
 | **MiniMax H3** | i2v, R2V (up to 9 refs) | t2v | 15s (**5s floor**) | Yes (native stereo, not toggleable) | Open-weight omni-modal model — one net covers T2V/I2V/reference. **2K is the only resolution** (no draft tier) at ~1/3 the per-second cost of other families; 24fps, 2500-char prompts. The `minimax-h3` video-family routes here. Sub-5s durations are a hard 400. |
+| **MiniMax H3 Max** | i2v, R2V (up to 9 refs) | t2v | 15s (**5s floor**) | Yes (native, not toggleable) | **Simple prompts — the model stages its own coverage.** Registry `promptStyle: 'simple'`, so the prompt builder strips blocking, locked location descriptions, and geography-hold clauses; say the intent in a sentence or two. Best for montages and beats where the model telling its own story is the point. **768P max — 2K is a hard 400**, the inverse of base H3 (480P is the draft tier). `private` tier, uncensored, 10000-char prompts. $0.024/s. The `minimax-h3-max` video-family routes here. |
+| **MiniMax H3 Max Turbo** | i2v | t2v | 15s (**5s floor**) | Yes (native, not toggleable) | Same model and constraints at **$0.012/s — the cheapest lane in the registry**, which makes 15s takes cheap enough to render several and pick. **No R2V lane** (`-turbo-reference-to-video` does not exist), so the `minimax-h3-max-turbo` family routes identity shots to `minimax-h3-max-reference-to-video`. |
 | **Wan 3.0** | i2v, R2V (up to 9 refs), Enhanced | t2v | **30s** | Yes (always on, not toggleable) | **Longest shots on Venice** — 5/10/15/20/25/30s at 480p/720p/1080p, five aspect ratios plus adaptive, 5000-char prompts. The `wan-3-0` video-family routes here. No audio input anywhere in the family, so it can't lip-sync to a supplied recording. `*-enhanced-*` variants are beta. |
 | **Wan 2.7** | i2v, R2V, V2V, Spicy | t2v | 15s | Wan i2v has no audio; lip-syncs via `audio_url` input | **The audio-driven fallback for exact lip-sync.** R2V exposes per-element `audio_url` for multi-speaker. Spicy = uncensored i2v variant. Seedance 2.x R2V and MiniMax H3 R2V also accept a top-level `audio_url`, so those families never route here. |
 | **Wan 2.6** | Standard, Flash, R2V | Standard | 15s | Yes (i2v/t2v); R2V capped at 10s | Now has R2V variant with `audio_url` input. 1080p. |
@@ -930,6 +932,94 @@ a persistent history file; `Ctrl-C` cancels the running command without killing
 the session (`Ctrl-D` or `/exit` leaves); `/help`, `/status`, `/jobs`, `/cd`, and
 `/pwd` are shell meta-commands; `!<cmd>` runs something in your system shell.
 
+### Loop mode — watch the whole plan while it renders, or iterate on real shots
+
+Once a plan exists (an approved shot script), you can play the entire film as a
+live browser loop while the harness renders it, instead of waiting for the full
+gated pipeline:
+
+```bash
+venice-video loop -p ~/VeniceVideos/my-film -e 1                   # asks the purpose
+venice-video loop -p ~/VeniceVideos/my-film -e 1 --mode looping    # or state it
+venice-video loop -p ~/VeniceVideos/my-film -e 1 --mode production
+```
+
+Loop mode starts with one **required, deliberate decision** — **is this for
+LOOPING or for PRODUCTION?** — because it is a real quality-vs-flow tradeoff, not
+a default to fall through. In a terminal it asks; non-interactively you must pass
+`--mode` (it errors otherwise). You can state it in plain words —
+`--mode looping` / `loop` / `fun` / `creative`, or `--mode production` / `prod` /
+`gather`:
+
+- **Looping — creative flow, lower quality.** The first generation is **t2v**,
+  every shot after it **chains i2v off the previous shot's last frame**, and it
+  **never uses R2V** (those renders are too slow for a loop). Turbo, 480P, fast.
+  Not final-quality; it's for watching and riffing.
+- **Production — gather usable shots, higher quality.** **Max R2V + references**
+  at 768P, identity locked, each shot rendered independently. Slower, but the
+  takes you pin are keepers.
+
+Either way it boots the local web UI, opens the browser to a **Loop** tab, and
+**auto-starts** a background engine that renders each shot into the episode's
+`loop/` directory and **keeps regenerating fresh takes continuously** (it does
+not stop after a fixed number of takes — only a Pause or the budget stops it).
+The plan plays on repeat and each shot hot-swaps in as its take finishes;
+because the render outruns playback, the video keeps evolving. Pin the keepers,
+regenerate the ones you don't, and watch a running spend meter. Both modes
+**skip the storyboard/QA gates** and write **only** under `loop/` — canonical
+`scene-001/shot-NNN.mp4` renders and `series.json` are never touched, so a loop
+can run alongside real production.
+
+Two behaviors make the loop play as one continuous piece:
+
+- **Last-frame chaining (default on).** Shot 1 renders normally; **every shot
+  after the first renders i2v using the previous shot's last frame as its first
+  frame**, so the clips flow into each other. Turn it off with `--no-chain` to
+  render each shot independently (in create mode that keeps per-shot R2V identity
+  locking).
+- **Full-length takes.** Every generation renders the model's full length
+  (**15s** by default — MiniMax H3 Max's max), for maximum footage and playback
+  per render. Override with `--duration`.
+
+Because the engine auto-starts, the **Loop** tab shows **Pause** while it's
+running. It regenerates until you Pause or the budget is reached; when the budget
+is reached it pauses and the button becomes **Resume**, which authorizes another
+budget's worth and continues. (`--max-takes` is a ring buffer — the number of
+candidate takes kept per shot — not a stop condition; older takes are pruned so
+an infinite run can't fill the disk.)
+
+The two modes differ in what they render:
+
+| Purpose (`--mode`) | Model | Resolution | Identity | Use it to… |
+|---|---|---|---|---|
+| **looping** | MiniMax H3 Max **Turbo** t2v/i2v (~$0.012/s) | 480P | **not** locked (Turbo has no R2V lane) | keep a fast, continuous loop going for creative flow |
+| **production** | MiniMax H3 Max **R2V** for character shots, i2v/t2v otherwise (~$0.024/s) | 768P | **locked** via the project's reference stack | gather real, usable shots and pin keepers |
+
+Production mode uses the same reference-first routing as the real pipeline:
+character shots render on `minimax-h3-max-reference-to-video` with the full
+`@Image` reference stack (character sheets, location angles, blocking plates)
+plus voice-donor audio, so identity holds. Shots with no references on disk
+degrade to i2v (off a panel) or t2v, so generate your character/location
+references first for the full effect.
+
+Continuous regeneration spends money, so it is capped by default:
+
+```bash
+venice-video loop -p <dir> -e 1 \
+  --mode production \      # looping | production (required; also accepts loop/fun, prod/gather)
+  --resolution 768P \      # defaults: 480P (looping) / 768P (production)
+  --duration 15s \         # per-take length, snapped to the 5-15s ladder (default 15s)
+  --budget 2 \             # pause after ~$2; Resume/regenerate authorizes another budget
+  --max-takes 3 \          # candidate takes kept per shot (ring buffer, not a stop)
+  --no-chain \             # render shots independently instead of i2v last-frame chaining
+  --once                   # or: render one take per shot, then stop
+# --unbounded              # remove the budget cap (spends until you Ctrl-C)
+```
+
+The loop is resumable: takes, pins, and spend are recorded in
+`loop/loop-manifest.json`, so re-running `loop` picks up where it left off.
+`Ctrl-C` stops the engine and the server.
+
 ### Interrupted renders are resumable
 
 The harness records each Venice `queue_id` to disk *before* it starts polling, so
@@ -1018,7 +1108,7 @@ These defaults are overridable per-project via `series.json` → `videoDefaults`
 
 ### Picking a family at project creation
 
-`venice-video new` asks which family to use, and `venice-video new-series` asks too when it's run on a terminal without `--video-family`. Both write the answer to `series.json` → `videoDefaults.videoFamilyPreference` and swap the action / atmosphere / character-consistency models to match. The wizard orders the families as Automatic, Seedance, Wan 3.0, MiniMax H3, HappyHorse, Grok Imagine, then Kling O3.
+`venice-video new` asks which family to use, and `venice-video new-series` asks too when it's run on a terminal without `--video-family`. Both write the answer to `series.json` → `videoDefaults.videoFamilyPreference` and swap the action / atmosphere / character-consistency models to match. The wizard orders the families as Automatic, Seedance, Wan 3.0, MiniMax H3, MiniMax H3 Max, MiniMax H3 Max Turbo, HappyHorse, Grok Imagine, then Kling O3.
 
 ### Choosing dialogue audio
 

package/capabilities.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "harnessVersion": "2.18.0",
-  "generatedAt": "2026-08-13T16:15:20-03:00",
+  "harnessVersion": "2.19.0",
+  "generatedAt": "2026-08-21T10:20:08-03:00",
   "videoModels": [
     {
       "id": "wan-2.6-image-to-video",
@@ -1767,6 +1767,202 @@
       "privacy": "anonymized",
       "offline": false
     },
+    {
+      "id": "minimax-h3-max-text-to-video",
+      "name": "MiniMax H3 Max",
+      "type": "text-to-video",
+      "durations": [
+        "5s",
+        "6s",
+        "7s",
+        "8s",
+        "9s",
+        "10s",
+        "11s",
+        "12s",
+        "13s",
+        "14s",
+        "15s"
+      ],
+      "resolutions": [
+        "768P",
+        "480P"
+      ],
+      "aspectRatios": [
+        "16:9",
+        "21:9",
+        "4:3",
+        "1:1",
+        "3:4",
+        "9:16"
+      ],
+      "audio": true,
+      "audioConfigurable": false,
+      "audioInput": false,
+      "videoInput": false,
+      "supportsElements": false,
+      "supportsReferenceImages": false,
+      "supportsSceneImages": false,
+      "supportsEndImage": false,
+      "maxDurationSec": 15,
+      "promptStyle": "simple",
+      "privacy": "private",
+      "offline": false
+    },
+    {
+      "id": "minimax-h3-max-image-to-video",
+      "name": "MiniMax H3 Max",
+      "type": "image-to-video",
+      "durations": [
+        "5s",
+        "6s",
+        "7s",
+        "8s",
+        "9s",
+        "10s",
+        "11s",
+        "12s",
+        "13s",
+        "14s",
+        "15s"
+      ],
+      "resolutions": [
+        "768P",
+        "480P"
+      ],
+      "aspectRatios": [],
+      "audio": true,
+      "audioConfigurable": false,
+      "audioInput": false,
+      "videoInput": false,
+      "supportsElements": false,
+      "supportsReferenceImages": false,
+      "supportsSceneImages": false,
+      "supportsEndImage": false,
+      "maxDurationSec": 15,
+      "promptStyle": "simple",
+      "privacy": "private",
+      "offline": false
+    },
+    {
+      "id": "minimax-h3-max-reference-to-video",
+      "name": "MiniMax H3 Max R2V",
+      "type": "image-to-video",
+      "durations": [
+        "5s",
+        "6s",
+        "7s",
+        "8s",
+        "9s",
+        "10s",
+        "11s",
+        "12s",
+        "13s",
+        "14s",
+        "15s"
+      ],
+      "resolutions": [
+        "768P",
+        "480P"
+      ],
+      "aspectRatios": [
+        "16:9",
+        "21:9",
+        "4:3",
+        "1:1",
+        "3:4",
+        "9:16"
+      ],
+      "audio": true,
+      "audioConfigurable": false,
+      "audioInput": true,
+      "videoInput": false,
+      "supportsElements": false,
+      "supportsReferenceImages": true,
+      "supportsSceneImages": false,
+      "supportsEndImage": false,
+      "maxDurationSec": 15,
+      "promptStyle": "simple",
+      "privacy": "private",
+      "offline": false
+    },
+    {
+      "id": "minimax-h3-max-turbo-text-to-video",
+      "name": "MiniMax H3 Max Turbo",
+      "type": "text-to-video",
+      "durations": [
+        "5s",
+        "6s",
+        "7s",
+        "8s",
+        "9s",
+        "10s",
+        "11s",
+        "12s",
+        "13s",
+        "14s",
+        "15s"
+      ],
+      "resolutions": [
+        "768P",
+        "480P"
+      ],
+      "aspectRatios": [
+        "16:9",
+        "21:9",
+        "4:3",
+        "1:1",
+        "3:4",
+        "9:16"
+      ],
+      "audio": true,
+      "audioConfigurable": false,
+      "audioInput": false,
+      "videoInput": false,
+      "supportsElements": false,
+      "supportsReferenceImages": false,
+      "supportsSceneImages": false,
+      "supportsEndImage": false,
+      "maxDurationSec": 15,
+      "promptStyle": "simple",
+      "privacy": "private",
+      "offline": false
+    },
+    {
+      "id": "minimax-h3-max-turbo-image-to-video",
+      "name": "MiniMax H3 Max Turbo",
+      "type": "image-to-video",
+      "durations": [
+        "5s",
+        "6s",
+        "7s",
+        "8s",
+        "9s",
+        "10s",
+        "11s",
+        "12s",
+        "13s",
+        "14s",
+        "15s"
+      ],
+      "resolutions": [
+        "768P",
+        "480P"
+      ],
+      "aspectRatios": [],
+      "audio": true,
+      "audioConfigurable": false,
+      "audioInput": false,
+      "videoInput": false,
+      "supportsElements": false,
+      "supportsReferenceImages": false,
+      "supportsSceneImages": false,
+      "supportsEndImage": false,
+      "maxDurationSec": 15,
+      "promptStyle": "simple",
+      "privacy": "private",
+      "offline": false
+    },
     {
       "id": "kling-v3-pro-text-to-video",
       "name": "Kling V3 Pro",
@@ -3466,6 +3662,7 @@
       "kling-o3-pro-reference-to-video",
       "kling-o3-standard-reference-to-video",
       "kling-v3-4k-reference-to-video",
+      "minimax-h3-max-reference-to-video",
       "minimax-h3-reference-to-video",
       "pixverse-c1-reference-to-video",
       "seedance-2-0-enhanced-reference-to-video",
@@ -3503,6 +3700,7 @@
     "imageTags": [
       "grok-imagine-reference-to-video",
       "happyhorse-1-1-reference-to-video",
+      "minimax-h3-max-reference-to-video",
       "minimax-h3-reference-to-video",
       "seedance-2-0-enhanced-reference-to-video",
       "seedance-2-0-fast-reference-to-video",
@@ -3510,6 +3708,7 @@
       "seedance-2-5-reference-to-video"
     ],
     "audioInput": [
+      "minimax-h3-max-reference-to-video",
       "minimax-h3-reference-to-video",
       "seedance-2-0-enhanced-reference-to-video",
       "seedance-2-0-fast-reference-to-video",
@@ -3545,6 +3744,7 @@
       "seedance-2-0-fast-reference-to-video": 9,
       "happyhorse-1-1-reference-to-video": 9,
       "minimax-h3-reference-to-video": 9,
+      "minimax-h3-max-reference-to-video": 9,
       "wan-3-0-reference-to-video": 9,
       "wan-3-0-enhanced-reference-to-video": 9
     },

package/dist/mini-drama/choices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"choices.d.ts","sourceRoot":"","sources":["../../src/mini-drama/choices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACnE,CAQA,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACzD,CAWA,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACpD,CAaG,CAAC"}
+{"version":3,"file":"choices.d.ts","sourceRoot":"","sources":["../../src/mini-drama/choices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACnE,CAUA,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACzD,CAWA,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACpD,CAaG,CAAC"}

package/dist/mini-drama/choices.js

@@ -4,6 +4,8 @@ export const VIDEO_FAMILY_CHOICES = [
     { label: 'Seedance 2.0', value: 'seedance', description: 'Reference-first identity anchoring, native dialogue, 720p drafts, 4-15s' },
     { label: 'Wan 3.0', value: 'wan-3-0', description: 'Shots up to 30s, 480p drafts through 1080p, native audio always on' },
     { label: 'MiniMax H3', value: 'minimax-h3', description: 'Open-weight omni-modal, 2K native audio, 5-15s' },
+    { label: 'MiniMax H3 Max', value: 'minimax-h3-max', description: 'Simple prompts, model stages its own coverage; 768P, private, 5-15s' },
+    { label: 'MiniMax H3 Max Turbo', value: 'minimax-h3-max-turbo', description: 'Same at half the price ($0.012/s), no R2V lane — identity crosses to H3 Max R2V' },
     { label: 'HappyHorse 1.1', value: 'happyhorse', description: 'Native multilingual lip-sync, 720p/1080p, 3-15s' },
     { label: 'Grok Imagine', value: 'grok-imagine', description: 'Atmosphere-forward look; R2V durations stepped at 5s/8s/10s' },
     { label: 'Kling O3', value: 'kling-o3', description: 'Stylized and illustrated aesthetics; structured character elements' },