@slatesvideo/shared 0.4.8 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slatesvideo/shared",
-  "version": "0.4.8",
+  "version": "0.5.1",
   "description": "Shared operations layer for the Slates MCP server and CLI: auth, cloud/desktop clients, and the single tool surface both consume. Most users want @slatesvideo/mcp-server or @slatesvideo/cli instead.",
   "license": "MIT",
   "type": "module",

package/skills/slates-content-policy.md

@@ -53,3 +53,11 @@ Never write romantic, sexual, or suggestive content involving or directed at min
 - [ ] Anything with children is wholesome and age-appropriate.
 
 If a box fails, apply the substitution table before writing the prompt.
+
+## Editing real footage (Kling O3 edit) — real people in the SOURCE
+
+Video edit takes the user's own footage, which often contains real people. Rules:
+
+- The user must hold rights/consent for any real person's likeness in footage they edit — ask once when it's clearly someone other than the user, then proceed.
+- Kling's video-to-video filter behavior on real faces is **not yet verified** (unlike Seedance, where the consent-gated real-face route is confirmed). If an edit of real-person footage is rejected by the provider, do NOT retry-spam variations — tell the user the filter blocked it and offer a no-face crop/segment or an AI-character swap instead.
+- Never use edit to put a real, named public figure into a scene, or to make someone appear to say/do something they didn't. Faceless b-roll (hands, products, landscapes, crowds-from-behind) edits freely.

package/skills/slates-cost-discipline.md

@@ -1,6 +1,6 @@
 ---
 name: slates-cost-discipline
-description: Mandatory pre-flight discipline before ANY generation call (image or video) — estimate cost, announce in dollars, get confirmation, aggregate batches. Read this every time before calling slates_generate_image or any future slates_generate_* op. Skipping this risks burning the user's credits on guesses.
+description: Mandatory pre-flight discipline before ANY generation call (image or video) — estimate cost, announce in credits, get confirmation, aggregate batches. Read this every time before calling slates_generate_image or any future slates_generate_* op. Skipping this risks burning the user's credits on guesses.
 ---
 
 # Slates cost discipline — read before every generation
@@ -20,23 +20,25 @@ Before ANY `slates_generate_*` call, run `slates_estimate_generation_cost` first
 
 If aspect ratio or resolution isn't obvious from the user's request, **ask before estimating**. Don't guess.
 
-### 2. Announce in dollars, plainly, before spending
+### 2. Announce in credits, plainly, before spending
 
-Format: `About to spend $X.XX on N image(s) at [resolution] [aspect ratio]. Proceed?`
+Slates bills abstract **credits** (they never expire). Announce the credit total the estimate returns — never dollars.
+
+Format: `About to spend N credits on M image(s) at [resolution] [aspect ratio]. Proceed?`
 
 Examples:
-- `About to spend $0.10 on 1 image at 1k 16:9. Proceed?`
-- `About to spend $0.40 on 4 images at 2k 9:16 (variants). Proceed?`
+- `About to spend 4 credits on 1 image at 1k 16:9. Proceed?`
+- `About to spend 24 credits on 4 images at 2k 9:16 (variants). Proceed?`
 
-Below ~$0.20 you can proceed silently after announcing once. Above $0.20 wait for explicit confirmation. Above $0.50 the server itself will gate with `requires_confirm` — pass `confirm: true` only after the user explicitly OKs.
+Below ~7 credits you can proceed silently after announcing once. Above ~7 credits wait for explicit confirmation. Above ~17 credits the server itself will gate with `requires_confirm` — pass `confirm: true` only after the user explicitly OKs.
 
 ### 3. Aggregate batches into ONE upfront announcement
 
-If you're planning a multi-call workflow (5 storyboard frames, 3 character variants, a grid of options), **announce the total before the first call**, not five $0.10 announcements after the fact.
+If you're planning a multi-call workflow (5 storyboard frames, 3 character variants, a grid of options), **announce the total before the first call**, not five small announcements after the fact.
 
-Format: `Plan: N generations totaling $X.XX. [Brief description of the sequence.] Proceed with the batch?`
+Format: `Plan: N generations totaling C credits. [Brief description of the sequence.] Proceed with the batch?`
 
-Example: `Plan: 6 frame generations at 1k 16:9 totaling $0.60 — establishing wide, push-in, two-shot, reverse, OTS, insert. Proceed?`
+Example: `Plan: 6 frame generations at 1k 16:9 totaling 24 credits — establishing wide, push-in, two-shot, reverse, OTS, insert. Proceed?`
 
 ### 3b. Batch authorization — one approval covers the enumerated batch
 
@@ -52,7 +54,7 @@ One approval = that plan, as enumerated, at those prices. Nothing else.
 
 ### 4. Track the running total
 
-After each generation completes, the response includes `cost_cents` (when available). Keep a running tally in your context. Surface it every 3 generations or whenever the user asks "how much have we spent?"
+After each generation completes, the response includes `cost_credits` (when available). Keep a running tally in your context. Surface it every 3 generations or whenever the user asks "how much have we spent?"
 
 ## Resolution decision rules
 
@@ -83,7 +85,7 @@ If the user prompt mixes signals (e.g. "cinematic Instagram post"), ask. Don't g
 
 ## When the gate fires
 
-The server returns `requires_clarification` when aspect ratio or resolution is missing. The server returns `requires_confirm` when total spend exceeds $0.50. In both cases:
+The server returns `requires_clarification` when aspect ratio or resolution is missing. The server returns `requires_confirm` when total spend exceeds ~17 credits. In both cases:
 
 1. Surface the gate response to the user
 2. Get a clean answer

package/skills/slates-direct-response-ad.md

@@ -10,7 +10,7 @@ You are building a 30-second hyper-motion direct-response ad. The user has hande
 **Hard rules**
 
 - Always estimate cost before generating. Use `slates_estimate_generation_cost` and surface the total.
-- All MCP/CLI generation routes through Slates Credits, period. BYOK is desktop-UI only by design — don't suggest "use your own keys" workarounds.
+- All Slates generation routes through Slates Credits, period (BYOK is retired) — don't suggest "use your own keys" workarounds.
 - Default model: `nano-banana-2-2k`. For close-up product hero frames step up to `4k` only if the user asks.
 - Hyper-motion = punchy cuts, 4 frames in 30 seconds, ~7s each. Don't over-storyboard.
 
@@ -58,7 +58,7 @@ For each frame:
 
 - **Don't** generate text overlays in the image. Slates renders captions/CTAs at the editor stage.
 - **Don't** burn credits on slot-machine prompting. If the first generation is off, refine the prompt; don't just regenerate.
-- **Don't** skip the cost estimate. Confirm with the user above $0.50.
+- **Don't** skip the cost estimate. Confirm with the user above ~17 credits.
 - **Don't** invent visual specifics about the product (colors, textures, angles) that aren't in the reference image. Reference-anchored prompts only.
 
 ## Voice

package/skills/slates-edit-and-iterate.md

@@ -28,7 +28,7 @@ The user's request is one of:
 | Aesthetic / compositional | `slates_generate_image` with the original in `referenceAssetIds` + a refined prompt. Don't re-roll from scratch. |
 | Wholesale | New prompt, no reference, fresh generation. Treat as a new brief. |
 
-**`slates_edit_image` shape:** `projectId` + `sourceAssetId` + `prompt` (the edit instruction). Default model `nano-banana-2` — the only edit model that also takes extra `referenceAssetIds`; `flux-2-max` / `seedream-5-lite` use their own edit endpoints and ignore references. The result lands as a NEW asset (prompt prefixed `[Edit]`); the source is untouched. Cost > $0.50 gates on `confirm=true`.
+**`slates_edit_image` shape:** `projectId` + `sourceAssetId` + `prompt` (the edit instruction). Default model `nano-banana-2` — the only edit model that also takes extra `referenceAssetIds`; `flux-2-max` / `seedream-5-lite` use their own edit endpoints and ignore references. The result lands as a NEW asset (prompt prefixed `[Edit]`); the source is untouched. Cost above ~17 credits gates on `confirm=true`.
 
 ### 4. Generate, evaluate, decide
 - Estimate cost first.

package/skills/slates-model-selection.md

@@ -18,6 +18,31 @@ Pick the model FIRST, deliberately, before writing a prompt or quoting a plan. M
 | The premium hero shot a piece hangs on | Seedance 2.0 | Spend where it shows. |
 | Native synchronized audio (dialogue + SFX generated WITH the video in one gen), 16:9, ≤8s | Veo 3.1 | The only job Veo wins. |
 
+## Video EDIT routing (changing an existing clip)
+
+| Job | Tool | Why |
+|---|---|---|
+| **Fix a 90%-right clip** — wrong shirt, one artifact, swap the subject, change the environment | **Kling O3 Edit** (`slates_edit_video`) | The default edit tool. Element lock (frontal + angles) holds identity; original motion, camera, and AUDIO preserved. One pass, no masking, ~19¢/s. |
+| Style-transfer-heavy re-imagining, full relocate of the scene | Seedance edit/relocate (`videoReferenceAssetId` on `slates_generate_video`) | Seedance's strength is transfer intensity; it re-generates rather than surgically edits. |
+| AI-edit the user's OWN footage (3–15s clips) | Kling O3 Edit | Takes any MP4/MOV 3–15s, 720–3840px — not just Slates gens. |
+
+- **Edit before re-roll.** A re-roll gambles away the parts the user already likes; an edit changes only what the prompt names. Quote the edit first when a clip is mostly right.
+- Edited clips are themselves editable ≤15s clips — chain passes; lineage links each output to its parent.
+
+## Motion Transfer & Lip Sync routing (two engines per tool)
+
+Both tools have a cheap Kling utility lane and a premium Seedance lane. The capability is the same; the execution model differs: Kling bolts motion/lip onto the source as a dedicated post-process; Seedance generates in a single pass with the driving clip / dialogue as native conditioning signals — better motion fidelity, natural speech delivery, audio included.
+
+| Job | Engine | Why |
+|---|---|---|
+| Quick motion retarget, budget lane, or driving clip >15s | Kling MC std/pro (`slates_generate_motion_transfer`) | Structured skeleton/depth retarget, ~32–42 credits / 5s, takes up to 30s driving clips. |
+| **Motion transfer where fidelity or audio matters** — dance, choreography, cinematic action | **Seedance 2.0** (`motionModel=seedance-2`) | Single-pass conditioning beats post-hoc retargeting; prompt-driven; native audio. Driving clip 2–15s; bills input+output seconds (vref keys). |
+| Cheap lip-sync utility (re-voice a clip, simple avatar) | Kling lip-sync / avatar (`slates_generate_lip_sync`) | ~4–29 credits / 5s blocks. |
+| **Natural speech, voice cloned from the source clip, premium delivery** | **Seedance 2.0** (`engine=seedance-2`) | The line is spoken IN the generation (no TTS layer); a video source keeps its own voice; uploaded ≤15s audio can drive it. |
+
+- Faces: Seedance tool gens default `seedanceFace=true` (sources are people). A REAL person triggers the consent cascade (`[REAL_FACE_DETECTED]` → `seedanceRealFace` + `realFaceConsent`, premium realface pricing).
+- Billing: any Seedance gen with a video reference bills COMBINED input+output seconds (`seedance-2*-vref-*` keys) — always pass the clip duration and quote before confirming.
+
 **Rules:**
 
 - **Default video = Kling 3.0 std.** Escalate to Seedance the moment the shot has physics/effects weight or is the hero moment — and say why in the plan ("physics-heavy, routing to Seedance").
@@ -31,8 +56,13 @@ Pick the model FIRST, deliberately, before writing a prompt or quoting a plan. M
 **Video models (Kling, Seedance, Veo) cannot generate standalone images — ever.** A "premium hero reference image" is still an image job: it routes to an image model below, never to Seedance.
 
 - **Default: Nano Banana 2** — best reference handling (14 refs), best legible text, the standard start-frame generator.
+- **NB2 Lite** — the fast/draft seat: ~half NB2's price, ~2.7× faster, 1K only. Route iteration volume and drafts here; finals go back to NB2 full (2K/4K).
+- **Nano Banana Pro** — the hero-frame/typography ceiling (~2× NB2). NB2 ≈ 95% of Pro; escalate only when spatial composition, cinematic lighting/skin, fine typography-in-scene, or deep multi-element frames must be perfect. Up to 14 refs — feed it a full subject library.
+- **GPT Image 2** — readable text / panels / UI king: character sheets, shot grids, diagrams, text-bearing panels. Medium quality is the default (half NB2's price at 1080p); high (~4×) only when text precision is the whole job. 4K at both tiers is API-only — even paid ChatGPT can't render it.
 - **FLUX.2 Max** — photoreal texture, hex-color binding, typography, less censored.
-- **Seedream 5 Lite** — cheapest; flat-priced drafts and volume exploration.
+- **Seedream 5 Lite** — uncensored + any-resolution flat price; volume exploration when the Gemini filter is in the way.
+
+**Split rule of thumb:** readable text / panels / UI → GPT Image 2; photoreal, character-locked, widescreen, or edit-heavy → the Banana line; drafts → NB2 Lite; uncensored or odd resolutions → Seedream/FLUX.
 
 ## Cost is a tiebreaker, not the router
 

package/skills/slates-prompting-gpt-image-2.md

@@ -0,0 +1,40 @@
+---
+name: slates-prompting-gpt-image-2
+description: Prompting GPT Image 2 — the readable-text / character-sheet / shot-grid engine. Read before calling slates_generate_image with model gpt-image-2. Covers the quality tiers (medium default, high for max text precision), resolution classes (1k/2k=1080p/3k=1440p/4k), text-accuracy prompting, panel/grid layout direction, and when to route to the Banana line instead.
+---
+
+# GPT Image 2 — sheets, grids, and text that actually reads
+
+GPT Image 2's edge is **character-level text accuracy** (~99% on English), ordered panels, and exact element placement — the jobs where every other model garbles a word or shuffles a layout. It is NOT the photoreal or character-locked pick: route those to the Banana line (`slates-model-selection` has the split).
+
+## Quality tiers — always set explicitly
+
+- **medium** (default) — sharp text, fast, the value seat: half NB2's price at the 1080p class. Blind benchmarks put it within a hair of high at a quarter of the cost. Start here.
+- **high** — ~4× the price; max text precision + reasoning. A deliberate premium pick when tiny type, dense diagrams, or many labeled elements ARE the job.
+
+Never rely on the provider default (it's high — the priciest tier). The Slates ops send medium unless you say otherwise.
+
+## Resolution classes
+
+`1k` = 1024²-class · `2k` = 1920×1080-class · `3k` = 2560×1440-class · `4k` = 3840×2160-class. Pick 2k for most sheets/panels; 4k for print-density grids. 4K exists at BOTH tiers and is API-only — even paid ChatGPT can't render it.
+
+## Prompting for text accuracy
+
+- **Quote every string that must render verbatim**: `the sign reads "OPEN 24 HOURS"` — quoted strings render most reliably.
+- Specify font *feel*, not font names: "clean geometric sans, high contrast", "hand-painted brush lettering".
+- For dense text (posters, UI mocks), list the copy as ordered lines: `Line 1: "..." Line 2: "..."` — GPT Image 2 respects ordering.
+- Keep total on-image text under ~30 words for perfect accuracy; beyond that, accuracy degrades gracefully but degrades.
+
+## Panels, sheets, and grids
+
+- State the grid explicitly and number the cells: "a 2×3 grid of panels, numbered 1–6, reading left-to-right, top-to-bottom".
+- Give each cell ONE content clause: "Panel 3: the character mid-jump, side view".
+- Character sheets: "character turnaround sheet: front, 3/4 left, profile, back — same character, same outfit, flat even lighting, plain background". GPT Image 2 holds the layout; the Banana line holds the *face* better — for identity-critical turnarounds prefer NB2/NB Pro and use GPT Image 2 when labels/annotations matter.
+
+## References & editing
+
+Reference images route through the edit endpoint (up to ~10). The composed "image N" naming applies as everywhere else. Mask-based inpainting exists at the API level but isn't surfaced — describe the change instead.
+
+## Filter regime
+
+OpenAI moderate — a third regime distinct from Gemini (NB family) and ByteDance (Seedream). Real-face references pass more readily than Gemini; violence/brand rules are similar. `slates-content-policy` applies unchanged.

package/skills/slates-prompting-kling-v3.md

@@ -159,6 +159,32 @@ When talking to the user about the gen, refer to each reference by its short cod
 - ✅ "I'm anchoring on **IMG-A12** as the detective and **IMG-A18** as the alleyway environment — Omni will handle the line delivery in EN."
 - ❌ "I'm using the detective image and the alley one..." (which alley? Three exist.)
 
+## Video-to-video EDIT (`slates_edit_video`) — @Video1 / @ElementN / @ImageN
+
+Kling O3 edit takes an EXISTING 3-15s clip and changes only what the prompt names — character swap, environment change, style transfer — in one pass, no masking. Original motion, camera, and audio are preserved by default. Its notation is Kling's own, different from the "image N" naming used everywhere else:
+
+- **`@Video1`** — the source clip (always; the transport anchors the instruction to it).
+- **`@Element1..`** — subjects to swap IN. Each element = one frontal image + up to 3 angle images (pass as `characterAssetIds`; @mention names in the prompt compile to @ElementN automatically).
+- **`@Image1..`** — style/appearance references (pass as `styleAssetIds`).
+- Max **4 combined** element + image refs per edit.
+
+**Prompt shape — the change, not the whole scene:**
+
+```
+Replace the man in @Video1 with @Element1, keeping his walk cycle, the camera move, and the rain unchanged.
+```
+
+```
+Edit @Video1: turn the daytime street into a neon-lit Tokyo alley at night, wet asphalt reflections. Apply the visual style of @Image1. Keep the subject and camera motion exactly as they are.
+```
+
+Rules:
+- Name what CHANGES; explicitly state what stays ("keep the motion / camera / everything else unchanged") — the model preserves better when told to.
+- One edit intent per pass. Chain passes for compound changes (each output is itself an editable clip, linked to its parent).
+- Billing is per second of OUTPUT ≈ the clip length, rounded UP to the next second. A 7.3s clip bills as 8s.
+- Clip constraints: 3-15s, 720-3840px, MP4/MOV. Agents can pre-trim on the timeline when a clip runs long.
+- Routing: Kling edit is the default edit tool (element lock + audio intact); Seedance edit/relocate wins style-transfer-heavy re-imaginings — see `slates-model-selection`.
+
 ## Sources
 
 - [fal.ai — Kling 3.0 Prompting Guide](https://blog.fal.ai/kling-3-0-prompting-guide/)

package/skills/slates-prompting-lip-sync.md

@@ -1,26 +1,40 @@
 ---
 name: slates-prompting-lip-sync
-description: How to set up Kling lip-sync. Read before calling slates_generate_lip_sync. Two flows — video→video re-dub and image→video avatar — with different inputs, pricing, and gotchas. Voice catalog, framing rules, audio file constraints, and which tier to pick.
+description: How to set up lip-sync — Kling (cheap utility lane) or Seedance 2.0 (premium single-pass lane). Read before calling slates_generate_lip_sync. Flows — video→video re-dub, image→video avatar, and Seedance native speech — with different inputs, pricing, and gotchas. Voice catalog, framing rules, audio file constraints, and which engine/tier to pick.
 ---
 
-# Kling lip-sync — setup guide
+# Lip-sync — setup guide
 
-Two distinct flows, both 5-second outputs:
+Two engines. Kling is the cheap utility lane (dedicated lip-sync endpoints, 5-second outputs); Seedance is the premium lane (speech generated IN the video itself, single pass):
 
-| Flow | Source | Model | Cost (5s) | Use case |
+| Flow | Source | Engine/Model | Cost | Use case |
 |------|--------|-------|-----------|----------|
-| Re-dub | video clip | kling-lip-sync-video | $0.11 | Replace dialogue on an existing talking head |
-| Avatar standard | still image | ai-avatar/v2/standard | $0.42 | Animate a portrait into a talking avatar |
-| Avatar pro | still image | ai-avatar/v2/pro | $0.86 | Higher facial fidelity for hero shots |
+| Re-dub | video clip | kling-lip-sync-video | ~4 credits / 5s | Replace dialogue on an existing talking head |
+| Avatar standard | still image | ai-avatar/v2/standard | ~14 credits / 5s | Animate a portrait into a talking avatar |
+| Avatar pro | still image | ai-avatar/v2/pro | ~29 credits / 5s | Higher facial fidelity for hero shots |
+| **Seedance native** | image or video | `engine=seedance-2` | per second (`seedance-2-face-*`; video sources bill input+output seconds) | **Premium**: natural delivery, whole-body performance, voice cloned from a video source, audio included |
 
-Pick `sourceType` deliberately — it decides the pricing tier and the underlying endpoint.
+Pick engine + `sourceType` deliberately — they decide the pricing tier and the underlying endpoint.
+
+## Seedance engine (premium single-pass)
+
+Kling lip-sync moves the mouth on finished pixels; Seedance *generates* the performance — head movement, gesture, delivery energy — with the dialogue as a native conditioning signal. Key facts:
+
+- **`ttsText` becomes the spoken line, natively.** No TTS voice/speed params — a VIDEO source keeps its **own voice** (the model clones it from the clip's audio track); for an image source the voice follows the character's look, or describe it in the line's context.
+- **`audioMethod=upload`** drives the speech from a ≤15s audio file instead (a reference-audio input, no billing surcharge).
+- **Sources:** image (any style; same framing rules as the avatar flow below) or a 2–15s video clip. Output duration follows the source/audio/line length (4–15s), not a fixed 5s.
+- **Billing:** image sources bill the normal `seedance-2-face-{res}-{N}s` keys; video sources bill combined input+output seconds (`-vref-` keys) — pass `sourceSeconds` and quote via the confirm gate.
+- **Faces:** `seedanceFace` defaults true. A REAL person → `[REAL_FACE_DETECTED]` → confirm consent → retry with `seedanceRealFace=true, realFaceConsent=true` (premium realface pricing).
+- When to pick it: hero dialogue shots, natural delivery, "make this clip's person say X in their own voice". Stay on Kling for cheap utility re-dubs and long clips.
+
+Everything below applies to the **Kling** engine.
 
 ## Choosing video vs avatar
 
 Use **video** (re-dub) when:
 - A talking-head clip already exists (Slates-generated, recorded, or imported)
 - The mouth/face is already moving and only the audio needs to change
-- $0.11 is hard to beat for short dialogue replacement
+- ~4 credits is hard to beat for short dialogue replacement
 
 Use **avatar** when:
 - Only a still portrait exists
@@ -113,9 +127,9 @@ Default `"."` is fine if you have nothing useful to add.
 **Use pro** when:
 - Final ads where the avatar's face fills the screen
 - The character is named / branded — identity drift kills the take
-- You're already paying $1+ for the surrounding video pipeline
+- You're already paying tens of credits for the surrounding video pipeline
 
-Don't default to pro. The $0.44 delta per take adds up across iteration.
+Don't default to pro. The ~15-credit delta per take adds up across iteration.
 
 ## Common failure modes
 
@@ -131,17 +145,17 @@ Don't default to pro. The $0.44 delta per take adds up across iteration.
 
 ## Cost discipline
 
-- Video re-dub at $0.11 is the cheapest dialogue iteration in the entire Slates stack — use it for voice A/B testing
-- Avatar standard at $0.42 is fine for medium use
-- Avatar pro at $0.86 trips the >$0.50 confirm gate — explicit user OK required every time
+- Video re-dub at ~4 credits is the cheapest dialogue iteration in the entire Slates stack — use it for voice A/B testing
+- Avatar standard at ~14 credits is fine for medium use
+- Avatar pro at ~29 credits trips the confirm gate — explicit user OK required every time
 - All 5s. There is no shorter option.
 
 ## Workflow patterns
 
 **Voice A/B test (cheap):**
-1. Generate one base talking-head video clip with Veo or Seedance (~$1.20)
+1. Generate one base talking-head video clip with Veo or Seedance (~40 credits)
 2. Run `slates_generate_lip_sync` with `sourceType: 'video'` against 3–5 different `ttsVoice` values
-3. Total cost: $1.20 + (5 × $0.11) = $1.75 to compare voices
+3. Total cost: ~40 + (5 × ~4) ≈ 60 credits to compare voices
 
 **Brand avatar from a single portrait:**
 1. Generate or upload the hero portrait (face fills frame, eyes open, neutral mouth)
@@ -157,7 +171,7 @@ Don't default to pro. The $0.44 delta per take adds up across iteration.
 
 Lip-sync is mechanical — the model re-syncs the chosen source to the chosen audio. The confirm response carries the source asset's code so you can announce it in chat.
 
-- ✅ "Lip-syncing **IMG-A12 — Founder Portrait** to the new line. $0.86 on avatar-pro. Confirm?"
+- ✅ "Lip-syncing **IMG-A12 — Founder Portrait** to the new line. ~29 credits on avatar-pro. Confirm?"
 - ❌ "Using the founder image..." (which? Three exist.)
 
 Don't second-guess the source. If the output is wrong, iterate on source choice or audio, not on a refinement prompt (there isn't one).

package/skills/slates-prompting-motion-transfer.md

@@ -1,18 +1,32 @@
 ---
 name: slates-prompting-motion-transfer
-description: How to set up Kling Motion Control (motion transfer). Read before calling slates_generate_motion_transfer. Reference image (character) + driving video (motion source) → new video of the character performing the motion. Asset selection rules, character_orientation choice, std vs pro tier, and prompt usage.
+description: How to set up motion transfer — Kling Motion Control (cheap utility lane) or Seedance 2.0 (premium single-pass lane). Read before calling slates_generate_motion_transfer. Reference image (character) + driving video (motion source) → new video of the character performing the motion. Asset selection rules, engine choice, character_orientation, tiers, and prompt usage.
 ---
 
-# Kling Motion Control — setup guide
+# Motion transfer — setup guide
 
-Take a still **target image** (your character) and a **source video** (the motion you want), produce a new 5s video of your character performing the source video's motion.
+Take a still **target image** (your character) and a **source video** (the motion you want), produce a new video of your character performing the source video's motion. Two engines:
 
-| Tier | Cost (5s) | Use case |
+| Engine | Cost | Use case |
 |------|-----------|----------|
-| std (`kling-mc-std-5s`) | $0.95 | General motion transfer |
-| pro (`kling-mc-pro-5s`) | $1.26 | Cleaner anatomy, better identity preservation |
+| Kling std (`kling-mc-std-5s`) | ~32 credits / 5s | General motion transfer, budget lane |
+| Kling pro (`kling-mc-pro-5s`) | ~42 credits / 5s | Cleaner anatomy, better identity preservation |
+| **Seedance 2.0** (`motionModel=seedance-2`) | per second of input+output (`seedance-2-face-vref-*`) | **Premium lane** — single-pass generation with the driving clip as a native conditioning signal: better motion fidelity, native audio, prompt-directed |
 
-Both tiers trip the >$0.50 confirm gate. User OK required every time.
+All tiers trip the confirm gate. User OK required every time. (Prices are approximate — `slates_estimate_generation_cost` returns the exact credit total.)
+
+## Seedance engine (premium single-pass)
+
+Kling MC retargets a skeleton onto a finished image; Seedance *generates* the shot with the motion as a conditioning input — the difference shows on fast choreography, physical contact, cloth/hair, and camera motion. Key differences from Kling:
+
+- **Prompt-driven.** The prompt is the primary control, using ordinal references: `The character from image 1 performs the exact motion, choreography, and camera movement from video 1. Preserve the character's identity, appearance, and outfit.` Add style/setting/camera direction freely — Seedance re-generates the whole shot.
+- **Driving clip must be 2–15s** (all providers cap reference video at 15s). Longer clips: trim first, or use Kling MC (`character_orientation: 'video'` takes up to 30s).
+- **Billing = combined input+output seconds** (the vref keys). Pass `sourceVideoSeconds`; output `duration` defaults to the clip length (4–15s). The server probes the clip and corrects an understated key — quote via the confirm gate before spending.
+- **Faces route through the face cascade**: `seedanceFace` defaults true (driving clips contain people). A REAL person → `[REAL_FACE_DETECTED]` → confirm consent with the user → retry `seedanceRealFace=true, realFaceConsent=true` (premium realface vref pricing).
+- **Native audio included** — the output can carry sound from the prompt (or the driving clip's vibe); no audio surcharge.
+- `characterOrientation` is Kling-only; Seedance framing follows the prompt + `aspectRatio`.
+
+Everything below applies to the **Kling** engine.
 
 ## Inputs
 
@@ -66,18 +80,18 @@ Switch to `image` when the target image's composition is the brand asset and the
 
 ## Tier choice — std vs pro
 
-**std ($0.95)** for:
+**std (~32 credits)** for:
 - Drafts, motion exploration, blocking
 - Group scenes where the character isn't a hero shot
 - When the budget is tight and the motion is the focus
 
-**pro ($1.26)** for:
+**pro (~42 credits)** for:
 - Final hero takes
 - Branded characters where identity drift = unacceptable
 - Anatomically complex motion (limbs crossing, fast direction changes)
 - Anime / cartoon target images — pro handles non-realistic styles better
 
-Don't default to pro. The $0.31 delta compounds fast across iteration.
+Don't default to pro. The ~10-credit delta compounds fast across iteration.
 
 ## Prompt usage (optional)
 
@@ -112,7 +126,7 @@ Leave it empty if you don't have a specific atmospheric note.
 2. Find driving footage — a clean reference video of the dance you want
 3. Upload both as project assets
 4. Run motion transfer with `motionModel: 'kling-mc-pro'`, `characterOrientation: 'video'`
-5. Total cost: $1.26 per 5s take
+5. Total cost: ~42 credits per 5s take
 
 **Subtle motion on a hero portrait:**
 1. Use the locked hero portrait as the target image
@@ -129,15 +143,15 @@ Leave it empty if you don't have a specific atmospheric note.
 ## Cost discipline
 
 - 5 seconds, no shorter option
-- Both tiers trip the >$0.50 confirm gate — every call needs explicit user OK
-- Iteration is expensive: 4 takes at pro = $5.04. Lock framing + driving video before tier-up to pro.
+- Both tiers trip the confirm gate — every call needs explicit user OK
+- Iteration is expensive: 4 takes at pro ≈ 168 credits. Lock framing + driving video before tier-up to pro.
 - Always run a single std take first to validate the motion + framing combo before committing to pro
 
 ## Confirm gate: cost + codes, no inline preview
 
-Motion transfer is mechanical — the model deterministically applies source motion to target image. Both tiers trip the >$0.50 confirm gate; the response includes the asset codes for source and target so you can announce them in chat.
+Motion transfer is mechanical — the model deterministically applies source motion to target image. Both tiers trip the confirm gate; the response includes the asset codes for source and target so you can announce them in chat.
 
-- ✅ "Transferring motion from **VID-V3** onto **IMG-A12 — Detective Closeup**. $1.26, confirm?"
+- ✅ "Transferring motion from **VID-V3** onto **IMG-A12 — Detective Closeup**. ~42 credits, confirm?"
 - ❌ "Using the walk video and the detective image..." (multiple of each in the project.)
 
 Don't second-guess the assets the user picked — the model executes the transfer. If the output is wrong, iterate on motion source or target choice, not on a refinement prompt.

package/skills/slates-prompting-nano-banana-2.md

@@ -144,3 +144,12 @@ Default to #1. Reach for #2 only when positive framing can't suppress the unwant
 ## The 3-strike rule
 
 If three iterations on the same prompt haven't produced what the user wants, stop. Hand back to the user with what you tried and what isn't working. The slot machine doesn't converge — the prompt structure is wrong, not the seed.
+
+## Family variants — Lite and Pro
+
+Everything in this skill applies to the whole Nano Banana family; two variants trade speed/ceiling around NB2 full:
+
+- **nano-banana-2-lite** — ~half the price, ~2.7× faster, **1K output only**, max 4 refs. The draft/iteration seat: explore compositions here, then re-run the winner on NB2 full at 2K/4K. Same Gemini filter.
+- **nano-banana-pro** — the hero-frame/typography ceiling (~2× NB2, 4K native). NB2 ≈ 95% of Pro; escalate only when spatial composition, cinematic lighting/skin, fine typography-in-scene, or deep multi-element frames must be perfect. Up to 14 refs — it takes a full subject library in one call.
+
+Routing between them (and vs GPT Image 2 / FLUX / Seedream): `slates-model-selection`.

package/skills/slates-prompting-seedance.md

@@ -83,6 +83,15 @@ Reference-to-video endpoint accepts up to **9 reference images, 3 reference vide
 
 **Mutually exclusive:** First-frame/last-frame mode CANNOT be combined with reference images. The error reads `"first/last frame content cannot be mixed with reference media content."` Pick one or the other.
 
+### Motion transfer & lip-sync recipes (reference video / audio)
+
+These aren't separate Seedance features — they're prompting strategies over reference media, and the Slates tools (`slates_generate_motion_transfer` / `slates_generate_lip_sync` with the seedance engine) compose them for you. When driving them by hand through `slates_generate_video`:
+
+- **Motion transfer:** subject image as a reference + the driving clip via `videoReferenceAssetId` (2–15s) + `The character from image 1 performs the exact motion, choreography, and camera movement from video 1. Preserve the character's identity, appearance, and outfit.`
+- **Lip-sync / dialogue:** write the line in the prompt — `The person in video 1 says: "…"` — with `generate_audio` on (always on in Slates). A **video** source's own voice is cloned natively; an **audio** reference (`audioReferenceAssetId`, ≤15s) drives speech from an existing recording: `…speaks the dialogue from audio 1 with accurate lip sync.`
+- **Voice + face from one clip (the talking-head recipe):** ONE unedited 2–15s clip of the person speaking (clear voice, no music, no cuts) as the video reference + prompt with the new script → their likeness AND voice deliver the new line.
+- **Billing:** a reference VIDEO switches the cost key to `seedance-2*-vref-{res}-{T}s` where T = clip seconds + output seconds — quote before confirming. Audio references are free (audio is included on every route).
+
 ## Faces — set `seedanceFace` for AI-character faces
 
 Seedance routes through **three tiers** depending on the face in the reference, exposed as the "Face in Reference" toggle plus the real-face params on `slates_generate_video`:

package/skills/slates-storyboard-from-script.md

@@ -33,7 +33,7 @@ Ask: **"Generate frame images now? (y/N)"**
 
 ### 3. Generate frames if requested
 For each frame:
-- Estimate cost (`slates_estimate_generation_cost`, `count = total frames`). Confirm with user if total > $0.50.
+- Estimate cost (`slates_estimate_generation_cost`, `count = total frames`). Confirm with user if total > ~17 credits.
 - Generate sequentially, with character/environment/style references attached when present in the project (`slates_list_characters`, `slates_list_environments`).
 - Each result returns inline. Evaluate. If wrong, refine prompt + regenerate (charge once, not multiple).
 - Bind to the frame via `slates_add_frame`.

package/skills/slates-vision-feedback-loop.md

@@ -47,7 +47,7 @@ The code is the FORMAL reference. The label is human texture. Use both: `IMG-A12
 
 - Track total credits spent across the loop. Surface to the user every 3 iterations.
 - Stop after 3 failed iterations on the same prompt — escalate to the user with what you tried and what's not working. The slot machine never converges.
-- For high-cost generations (`> $0.50`), confirm before *every* attempt, not just the first.
+- For high-cost generations (above ~17 credits), confirm before *every* attempt, not just the first.
 
 ## When to break the loop