@slatesvideo/shared 0.6.10 → 0.7.0

package/dist/prompts/model-facts.js

@@ -1,3 +1,9 @@
+/** Connected host, not an API model: capabilities are checked at runtime. */
+export const CHATGPT_IMAGE_HOST = {
+    id: 'chatgpt-account', label: 'ChatGPT',
+    note: 'Generate with your connected ChatGPT account',
+    usage: 'Uses your ChatGPT account limits',
+};
 // Per-model prompting facts — routing doctrine and the prompt formula, as
 // KNOWLEDGE (for skills + lead-magnet + op descriptions).
 //
@@ -26,6 +32,19 @@
 // Relative cost claims STAY ("dearer than 2.0 at every shared tier") — that is
 // routing. The figures go, because those are data.
 import { MODEL_CAPABILITIES } from './model-capabilities.js';
+import { DEFAULT_IMAGE_SEAT, TOOL_SEAT } from './generation-policy.js';
+/** Authoring presets only: these do not claim hosted ChatGPT API capabilities. */
+export const CHATGPT_FRAMING_RATIOS = MODEL_CAPABILITIES['gpt-image-2-5-sunburst'].aspectRatios;
+export function composeChatGptFraming(prompt, aspectRatio) {
+    if (aspectRatio === undefined)
+        return prompt;
+    if (!CHATGPT_FRAMING_RATIOS.includes(aspectRatio)) {
+        throw new Error('Choose a supported ChatGPT framing preset');
+    }
+    // Reuse may contain our previous appended request. Replace only this exact suffix.
+    const base = prompt.replace(/\n\nRequested output framing: \d+:\d+ aspect ratio\.$/, '');
+    return `${base}\n\nRequested output framing: ${aspectRatio} aspect ratio.`;
+}
 /**
  * Reference caps for a fact, read out of the capability SSOT.
  *
@@ -69,14 +88,14 @@ export function multimodalRefSummary(id) {
         return '';
     const parts = [];
     if (v > 0)
-        parts.push(`${v} reference video${v === 1 ? '' : 's'} (${f.maxReferenceVideoSeconds}s combined)`);
+        parts.push(`${v} video${v === 1 ? '' : 's'} (${f.maxReferenceVideoSeconds}s total)`);
     if (a > 0)
-        parts.push(`${a} reference audio clip${a === 1 ? '' : 's'} (${f.maxReferenceAudioSeconds}s combined)`);
-    const total = f.maxReferenceFilesTotal ? `, ${f.maxReferenceFilesTotal} files max across all modalities` : '';
+        parts.push(`${a} audio clip${a === 1 ? '' : 's'} (${f.maxReferenceAudioSeconds}s total)`);
+    const total = f.maxReferenceFilesTotal ? `, ${f.maxReferenceFilesTotal} files max` : '';
     const companion = f.audioRefNeedsCompanion
-        ? ' Audio needs at least one image or video reference alongside it.'
-        : ' Audio-only references are allowed.';
-    return `${f.label}: up to ${parts.join(' and ')}${total}.${companion}`;
+        ? '; audio needs an image or video alongside.'
+        : '; audio-only is allowed.';
+    return `${f.label}: up to ${parts.join(' + ')}${total}${companion}`;
 }
 /**
  * The prompt words that make Seedance 2.5 reclassify a reference-carrying
@@ -120,6 +139,7 @@ export const MODEL_FACTS = [
     {
         id: 'nano-banana-2',
         route: 'generate',
+        tier: 'specialist',
         // Gemini 3.1 FLASH Image — verified against the runtime slug map in
         // slate/src/main/api/google.ts. Nano Banana PRO is a different model
         // (gemini-3-pro-image-preview); do not conflate them.
@@ -127,11 +147,12 @@ export const MODEL_FACTS = [
         kind: 'image',
         // 14 = 10 object-fidelity + 4 character-consistency; the categories don't trade.
         ...caps('nano-banana-2'),
-        notes: 'DEFAULT image model and the all-rounder — route here unless another seat\'s speciality is the point. Best start-frame for legible in-scene text. Knowledge cutoff Jan 2025: anything later needs reference images.',
+        notes: 'The all-rounder and the only image seat with a headless path: holds many subjects coherently in one frame, and the start-frame for legible in-scene text. Knowledge cutoff Jan 2025: anything later needs reference images.',
     },
     {
         id: 'nano-banana-2-lite',
         route: 'generate',
+        tier: 'specialist',
         label: 'Nano Banana 2 Lite',
         kind: 'image',
         ...caps('nano-banana-2-lite'),
@@ -140,6 +161,7 @@ export const MODEL_FACTS = [
     {
         id: 'nano-banana-pro',
         route: 'generate',
+        tier: 'specialist',
         label: 'Nano Banana Pro',
         kind: 'image',
         ...caps('nano-banana-pro'),
@@ -148,6 +170,7 @@ export const MODEL_FACTS = [
     {
         id: 'gpt-image-2-5-flare',
         route: 'generate',
+        tier: 'specialist',
         label: 'GPT Image 2.5 Flare',
         kind: 'image',
         ...caps('gpt-image-2-5-flare'),
@@ -156,14 +179,16 @@ export const MODEL_FACTS = [
     {
         id: 'gpt-image-2-5-sunburst',
         route: 'generate',
+        tier: 'default',
         label: 'GPT Image 2.5 Sunburst',
         kind: 'image',
         ...caps('gpt-image-2-5-sunburst'),
-        notes: 'THE QUALITY GPT IMAGE SEAT — OpenAI\'s most capable image model, higher quality than GPT Image 2, same price as Flare, deliberately SLOWER. Route here whenever quality outranks speed: finals, hero frames, photoreal people, and multi-reference edits where every reference must survive into one frame — its widest lead. Not for drafts; you pay latency on every frame. Explore on Flare, finish on Sunburst.',
+        notes: 'THE QUALITY GPT IMAGE SEAT — OpenAI\'s most capable image model, higher quality than GPT Image 2, same price as Flare, deliberately SLOWER. Route here unless speed is the point: finals, hero frames, photoreal people, and multi-reference edits where every reference must survive into one frame — its widest lead. Explore on Flare, finish on Sunburst.',
     },
     {
         id: 'flux-2-max',
         route: 'generate',
+        tier: 'specialist',
         label: 'FLUX.2 Max',
         kind: 'image',
         ...caps('flux-2-max'),
@@ -172,6 +197,7 @@ export const MODEL_FACTS = [
     {
         id: 'seedream-5-lite',
         route: 'generate',
+        tier: 'specialist',
         label: 'Seedream 5 Lite',
         kind: 'image',
         ...caps('seedream-5-lite'),
@@ -180,25 +206,28 @@ export const MODEL_FACTS = [
     {
         id: 'seedance-2',
         route: 'generate',
+        tier: 'specialist',
         label: 'Seedance 2.0',
         kind: 'video',
         ...caps('seedance-2'),
         audioRefNeedsCompanion: true,
-        notes: 'PREMIUM video tier and the DEFAULT video model — route here the moment physics, effects, destruction or scale matter, and for hero shots. VIDEO-ONLY. Strong image-to-video and own-footage restyle. 4K is Pro-gated (base accounts get PRO_REQUIRED). Stays the default over 2.5: it is the only Seedance with native 4K and it is cheaper at every tier the two share.',
+        notes: 'THE 4K AND VALUE SEAT beside the 2.5 default — the only Seedance with native 4K (Pro-gated; base accounts get PRO_REQUIRED) and cheaper than 2.5 at every resolution they share, with the same physics, effects and scale strengths; shorter takes, fewer references, no timestamps. VIDEO-ONLY. A bare "seedance" still resolves here for older CLIs that expect 4K.',
     },
     {
         id: 'seedance-2.5',
         route: 'generate',
+        tier: 'default',
         label: 'Seedance 2.5',
         kind: 'video',
         ...caps('seedance-2.5'),
         // No companion requirement — audio-only references are one of the things
         // the second seat actually buys.
-        notes: 'A SECOND SEAT NEXT TO 2.0, NOT AN UPGRADE — and the dearer one at every tier they share. Pick 2.5 when the shot needs LENGTH, MANY references, an AUDIO-ONLY reference, TIMED BEATS, or tighter prompt adherence; pick 2.0 for 4K and for the same resolution cheaper. VIDEO-ONLY. Timestamp grammar, and the edit/extend words that make the provider reclassify a fresh generation and fail it, are in slates-prompting-seedance-2-5.',
+        notes: 'DEFAULT VIDEO MODEL — the strongest seat for physics, effects, scale and hero shots, and the only Seedance that takes long single takes, many references, audio-only references and integer-second timestamps. No 4K, and dearer than 2.0 at every shared resolution: go to 2.0 for 4K or the same resolution cheaper. LENGTH is the price dial — quote long takes first. VIDEO-ONLY. Timestamp grammar and the edit/extend words that make the provider reclassify and fail a generation are in slates-prompting-seedance-2-5.',
     },
     {
         id: 'seedance-2.5-edit',
         route: 'edit',
+        tier: 'specialist',
         label: 'Seedance 2.5 Edit',
         kind: 'video',
         // 0 ingredients: prompt + source clip only on slates_edit_video.
@@ -208,15 +237,17 @@ export const MODEL_FACTS = [
     {
         id: 'kling-v3',
         route: 'generate',
+        tier: 'specialist',
         label: 'Kling 3.0',
         kind: 'video',
         // Family-level fact — caps are identical across std/pro/omni/omni-pro.
         ...caps('kling-v3.0-std'),
-        notes: 'DEFAULT general-purpose video model — cost-effective, strong start-frame adherence (identity, layout, text), acting, dialogue, lip-sync, and the widest aspect-ratio set. Escalate to Seedance for physics. Kling is also the ONLY engine behind the Motion Transfer and Lip Sync tools.',
+        notes: 'THE COST-EFFECTIVE SEAT — strong start-frame adherence (identity, layout, text), acting, dialogue, lip-sync and the widest aspect-ratio set; pick it when the budget matters and the shot is a performance or a start-frame animation. Kling is also the ONLY engine behind the Motion Transfer and Lip Sync tools.',
     },
     {
         id: 'kling-v3-edit',
         route: 'edit',
+        tier: 'specialist',
         label: 'Kling O3 Video Edit',
         kind: 'video',
         // Family-level fact; 4 = combined subject elements + style refs per edit.
@@ -226,15 +257,17 @@ export const MODEL_FACTS = [
     {
         id: 'veo-3.1',
         route: 'generate',
+        tier: 'niche',
         label: 'Veo 3.1',
         kind: 'video',
         // Family-level fact — fast and standard declare the same caps.
         ...caps('veo-3.1-fast'),
-        notes: 'NICHE, never the default — pick only when native synchronized audio must generate WITH the video in one pass, and the narrowest aspect-ratio and duration sets in the catalogue are acceptable. Otherwise Kling (default) or Seedance (physics/premium) win.',
+        notes: 'NICHE, never the default — pick only when native synchronized audio must generate WITH the video in one pass, and the narrowest aspect-ratio and duration sets in the catalogue are acceptable. Otherwise Seedance 2.5 (the default) or Kling (cost-effective performance) win.',
     },
     {
         id: 'omni-flash',
         route: 'generate',
+        tier: 'specialist',
         label: 'Gemini Omni Flash',
         kind: 'video',
         // 7 ref2v image_urls — mirrors Google's own reference limit.
@@ -244,6 +277,7 @@ export const MODEL_FACTS = [
     {
         id: 'omni-flash-edit',
         route: 'edit',
+        tier: 'default',
         label: 'Omni Flash Edit',
         kind: 'video',
         // 0: prompt + source clip ONLY — no element/style refs on this endpoint.
@@ -253,6 +287,7 @@ export const MODEL_FACTS = [
     {
         id: 'minimax-h3',
         route: 'generate',
+        tier: 'specialist',
         label: 'MiniMax H3',
         kind: 'video',
         ...caps('minimax-h3'),
@@ -265,16 +300,36 @@ export const MODEL_FACTS = [
     {
         id: 'minimax-h3-max',
         route: 'generate',
+        tier: 'specialist',
         label: 'MiniMax H3 Max',
         kind: 'video',
-        // No reference caps: fal publishes no reference-to-video endpoint for this
-        // row, so `caps()` returns nulls and the composer refuses references.
+        // References landed 2026-09-09 when the "h3-max/reference-to-video returns
+        // 404" claim was retired against the fetched schema (caps come from
+        // model-capabilities.ts; the rip is second-brain/business/projects/slates/
+        // provider-docs/fal-minimax-h3-openapi-schemas.md, section 6).
         ...caps('minimax-h3-max'),
-        notes: 'THE SPEED SEAT, and the DEARER one at the tier they share — never the cheap H3 and never the default. fal\'s post-train of the H3 weights: MEASURED 2026-08-27 at about 12x faster than base H3 on the same prompt and params, queue to finished file, plus a thin vendor-reported quality edge. It gives up the upper resolution tiers and the REFERENCE endpoint, so the omni-reference set is base-H3 only — but it still animates start and end frames, which is one of the two things it is FOR. Never describe this row as taking no image input. Route here when a fast turnaround on text-to-video or a start-frame shot is worth the premium.',
+        // Quoted off THAT endpoint's reference_audio_urls description, not copied
+        // from the base row: "Audio cannot be the only reference input; provide at
+        // least one reference image or video with it."
+        audioRefNeedsCompanion: true,
+        notes: 'THE SPEED SEAT, and the DEARER one at the tier they share — never the cheap H3 and never the default. fal\'s post-train of the H3 weights: MEASURED 2026-08-27 at about 12x faster than base H3 on the same prompt and params, queue to finished file, plus a thin vendor-reported quality edge. It tops out at a 1080p refinement of its 768p render. It takes the same omni-reference set as base H3 and animates start and end frames — but not both in one call: its reference endpoint has no start/end-frame fields, where base H3\'s does. Never describe this row as taking no image or reference input. Route here when a fast turnaround on text-to-video or a start-frame shot is worth the premium.',
+    },
+    {
+        id: 'minimax-h3-max-turbo',
+        route: 'generate',
+        tier: 'specialist',
+        label: 'MiniMax H3 Max Turbo',
+        kind: 'video',
+        // Added 2026-09-29. No reference caps: fal publishes text-to-video and
+        // image-to-video for Turbo and its reference-to-video returns 404, so
+        // `caps()` returns nulls and the composer refuses references.
+        ...caps('minimax-h3-max-turbo'),
+        notes: 'THE BUDGET SEAT of the MiniMax family: a second fal post-train of the H3 weights, billed at half H3 Max\'s rate at every tier. Its 1080p is a refinement of the native 768p render, not a native 1080p generation. INPUTS ARE FRAMES, NOT REFERENCES: text-to-video and start/end frames only, with no reference endpoint, so reference-driven consistency goes to H3 Max or base H3. Route here for drafts, volume and cheap coverage, then re-run the keeper on H3 Max or a hero seat.',
     },
     {
         id: 'ltx-2-5',
         route: 'generate',
+        tier: 'specialist',
         label: 'LTX-2.5',
         kind: 'video',
         // No reference caps: fal publishes text-to-video and image-to-video for LTX
@@ -286,6 +341,7 @@ export const MODEL_FACTS = [
     {
         id: 'ltx-2-5-pro',
         route: 'generate',
+        tier: 'specialist',
         label: 'LTX-2.5 Pro',
         kind: 'video',
         ...caps('ltx-2-5-pro'),
@@ -294,6 +350,7 @@ export const MODEL_FACTS = [
     {
         id: 'seed-audio',
         route: 'generate',
+        tier: 'default',
         label: 'Seed Audio 1.0',
         kind: 'audio',
         // ONE image XOR up to 3 audio clips — the two inputs are mutually exclusive.
@@ -303,6 +360,7 @@ export const MODEL_FACTS = [
     {
         id: 'eleven-sfx',
         route: 'generate',
+        tier: 'specialist',
         label: 'ElevenLabs Sound Effects v2',
         kind: 'audio',
         ...caps('eleven-sfx'),
@@ -311,13 +369,61 @@ export const MODEL_FACTS = [
     {
         id: 'inworld-tts-2',
         route: 'generate',
+        tier: 'specialist',
         label: 'Inworld Realtime TTS-2',
         kind: 'audio',
         ...caps('inworld-tts-2'),
         notes: 'THE VOICE SEAT — one named voice saying one line, billed per CHARACTER not per second. Route here when WHO is speaking matters. NOT scene audio — that is seed-audio; a single effect is eleven-sfx.',
     },
 ];
+/**
+ * One default per lane, asserted where the data is declared. Two rows both
+ * reading "DEFAULT" is exactly the drift `tier` exists to make impossible, and
+ * a lane with no default leaves an agent (and slates-web) nothing to lead with.
+ */
+for (const kind of ['image', 'video', 'audio']) {
+    for (const route of ['generate', 'edit']) {
+        const lane = MODEL_FACTS.filter((f) => f.kind === kind && f.route === route);
+        if (lane.length === 0)
+            continue;
+        const defaults = lane.filter((f) => f.tier === 'default').map((f) => f.id);
+        if (defaults.length !== 1) {
+            throw new Error(`MODEL_FACTS: ${kind}/${route} must have exactly one tier: 'default' row, found ${defaults.length}` +
+                (defaults.length ? ` (${defaults.join(', ')})` : ''));
+        }
+    }
+}
+/**
+ * The one `default` seat for a kind on the generate route, READ from `tier`.
+ * Anything that needs "the default image model" calls this instead of naming
+ * one: the op surface and slates-web both hand-typed nano-banana-2 for six days
+ * after the app picker moved to Sunburst.
+ */
+export function defaultModelFor(kind) {
+    const fact = MODEL_FACTS.find((f) => f.kind === kind && f.route === 'generate' && f.tier === 'default');
+    if (!fact)
+        throw new Error(`MODEL_FACTS: no default ${kind} seat on the generate route`);
+    return fact.id;
+}
+/**
+ * The seat a built-in tool renders on when its caller names no model. Resolves
+ * `TOOL_SEAT` (generation-policy.ts, THE home): `'default-image'` follows the
+ * default image seat above, a model id pins the tool. The desktop resolves the
+ * same table through its generated mirror, so an op description, the skill
+ * partial and the handler that bills cannot name different models.
+ */
+export function toolModelFor(tool) {
+    const seat = TOOL_SEAT[tool];
+    return seat === DEFAULT_IMAGE_SEAT ? defaultModelFor('image') : seat;
+}
 const FACT_BY_ID = new Map(MODEL_FACTS.map((m) => [m.id, m]));
+// A pinned tool seat must be a live image model, or the tool quotes and fires
+// an id nothing can render. Asserted at load, like the one-default-per-kind rule.
+for (const [tool, seat] of Object.entries(TOOL_SEAT)) {
+    if (seat !== DEFAULT_IMAGE_SEAT && FACT_BY_ID.get(seat)?.kind !== 'image') {
+        throw new Error(`TOOL_SEAT: ${tool} is pinned to "${seat}", which is not an image model in MODEL_FACTS`);
+    }
+}
 /**
  * Routing prose for one lane, generated from the SSOT.
  *

package/dist/prompts/partials.generated.js

@@ -5,12 +5,18 @@
 // per-model skills, so the TS consumers and the markdown consumers can
 // no longer disagree. Edit the partial, not this file, not the skills.
 export const PARTIALS = {
-    "decision-log": "When you surface the plan, include a short **decision log** — one line per decision *you* made that the user did not specify **and that no row already records**:\n\n```\nsource phrase or declared default → what you wrote → what it resolves\n\"in a diner\"        → warm, and the light is the reason           → why the anchor was chosen, not what it is\n(no time of day)    → late afternoon, low warm key                 → default; say the word and it changes\n```\n\n🚨 **Keep it to what is NOT already data — and almost everything now IS.** A Shot holds the references and their roles, the model, every param, the shot size, the camera, the prop, the action and the spoken line, and `slates_list_shots` reads the whole board back in order with its variety counts. Narrating any of those is retelling a row the user can open. **Write the Shot, and let the log carry only the judgement no field holds** — why this world, why this light, why this register.\n\n**Hard rule: never silently add weather, props, style, or camera movement.** Four of those are now FIELDS: put the value on the Shot (`prop`, `camera`, `shotSize`, `action`) so the user can read and change it, and put the *reason* in the log only when you invented it rather than being told it. The rule has not softened — it moved from narration into data, which is stronger, because a field can be corrected and a sentence in chat cannot.\n\n> ❌ **Do NOT turn this into a question gate.** Clarifying questions before optimizing directly fight the locked fast-path rule: *if intent is clear, generate immediately with sane defaults, don't ask questions; only ask for production intent, and batch every question into one message.* Log the decisions, then go. The log is an **output**, not an interrogation — surfaced alongside the plan, never as a separate ceremony, and never as a reason to wait.",
-    "reference-rules-core": "Identity = a few flat-lit neutral angles; one reference per role, named inline; 2-4 refs not 12; describe environments instead of feeding a grid.\n\n1. **2-4 strong references beat both extremes.** Not 1 (warps toward itself), not 12 (averages worse). Start with 2-3 focused refs — each one adds context AND another variable to balance.\n2. **One reference per ROLE, named in the prompt** — identity / style-grade / environment. The model does **not** infer a reference's role from its position in the list; the inline name carries it. Same-role competitors drift (two \"identity\" refs of different people blend into a third face). Slates composes the naming for you from your `@mentions` / `#tags` — you never hand-write role labels.\n3. **One identity sheet per character, named inline.** A character's identity is a single asset (dominant portrait + body panels), so attach that one asset rather than a pile of views: **fewer competing renderings of a face is better, because the model cannot tell which one is authoritative and averages them.** Slates cites it as `Marcus (image 1)`. **Do NOT hand-write a \"Reference Image Instructions\" block or role essays** (\"use for identity, ignore the outfit, render a neutral expression\") — that drags the sheet's studio lighting and wardrobe into a scene that asked for neither. The prompt leads; the user's words own wardrobe, expression, lighting, and action.\n4. **Flat-light identity refs.** Prep identity references with flat, even, shadowless lighting on a plain neutral background. A studio-lit or scene-lit character sheet bleeds its lighting into every generation — the failure looks like the subject was green-screen-pasted in front of the location. Reference prep beats prompting here.\n5. **Environment: describe it, don't feed a grid.** Default to describing the location in words and let the model build a space that fits the shot. Reserve an environment reference for a mandatory exact-match, and then use ONE clean establishing image with natural ambient light that reads as the location's real light — never a multi-panel grid fed whole.\n6. **Grids: explore, don't input.** Use grids to explore compositions cheaply, then pick a cell. Never feed a grid back in as a reference — the cells share a split detail budget and were generated jointly, so their flaws propagate.\n7. **Reuse the same refs across every shot** in a sequence. Lock a set and keep it; swapping references mid-sequence causes drift, because the model adapts each reference to the current prompt rather than copying it.\n8. **Legible in-shot text → bake it into a still start frame, never trust text-to-video.** Have an image model render the text, then animate from that locked frame. Video models smear type.\n9. **Working from existing media — describe ONLY what changes.** The source already carries its composition, motion, timing, and performance; re-describing them fights the model. Narrate the delta. (Video lane: restyle your own clip while keeping the performance; delayed-VFX on \"video one\"; marker-object insertion; video-as-reference for a series.)\n10. **Style transforms happen in natural language.** By default the source's artistic medium and visual style are inherited. To change it, add a plain-text instruction (\"anime → real person\"). There are no preset pickers, and there is no style slider.",
+    "cinematic-card": "**For a photographic look, use only what this frame needs.** Image models default to clean, evenly lit and fully exposed. Describe what the camera sees, not just gear or mood:\n- **Inspect every reference first.** Write its grade and imperfections in words: darkness, contrast, muddy or true blacks, colour, softness/noise, subject separation. Never grade cleaner or brighter than the look reference unless asked.\n- **One light system** — `low sun behind her`, `her face falls into deep shadow`, `no light in front of her`.\n- **Visible exposure** — `the sky burns out to white`, `dense, slightly crushed shadows`.\n- **Lens name plus effect** — `200mm telephoto`, `peaks loom huge behind her and melt into soft shapes`.\n- **Name every garment and close the foreground.** Omissions invite reference leakage or invented props.\nBind references inline. A scene reference owns the grade; for a look-only reference, write the new scene's light. References are optional. For owned-frame edits, describe only the change and what stays.\n<!-- slates-only -->Use `slates-cinematic-look` with a technique ID or section query for more.<!-- /slates-only -->",
+    "cinematic-routes-short": "Two routes: describe a new frame, or change a frame you own. For a new scene, name references where you use them, write the look reference's grade and imperfections in plain words, then describe one light system, visible exposure, lens plus effect, every garment and a closed foreground. Use only what the shot needs. For your own plate, sheet, photo, footage or Blender render, say only what changes and what stays. Never use a released film frame as the edit base; use it as an art-direction brief for a new scene.",
+    "cinematic-tips-short": "Image models tend toward clean, evenly lit, fully exposed pictures. For a filmed look, describe what you see: one light source and its effect, a face almost in silhouette, a sky burned white. Name the lens and its visible effect together. Look at every reference first and describe its own darkness, contrast, colour, softness, noise and subject separation. Keep muddy blacks muddy; never clean up or brighten the reference's grade unless that is the change you want. Name every garment and exactly what is in the foreground. Use only what the shot needs; references are optional.",
+    "decision-log": "Record production choices in the editable shot fields. Explain only consequential judgments the user did not specify and no field already records: for example, why a particular light or performance register supports the brief. Do not repeat the shot list in prose or turn this explanation into an approval gate. Follow the separate generation authorization policy before spending.",
+    "image-defaults": "**Image default:** gpt-image-2-5-sunburst, quality `high`, 3k. User overrides take priority. Without a project, generation uses the headless Nano Banana 2 seat.\n\n| Model | Default resolution |\n|---|---|\n| nano-banana-2 | 2k |\n| nano-banana-2-lite | 1k |\n| nano-banana-pro | 2k |\n| gpt-image-2-5-flare | 2k |\n| gpt-image-2-5-sunburst | 3k |\n| flux-2-max | 1k |\n| seedream-5-lite | 2k |",
+    "lens-video-split": "Named lenses, apertures, film stocks and camera bodies (`85mm f/1.4`, `Kodak Portra 400`, `ARRI Alexa 65`) are an image-model lever. On a video model, translate the look instead of pasting the gear list: `85mm f/1.4, Portra 400` becomes `close-up, shallow depth of field, warm natural colors, cinematic texture, film-grain texture`. ByteDance's Seedance 2.0 guide never mentions fps, shutter angle, f-stop or lens millimetres. Its Seedance 2.5 guide does, once: the visual-style line of its own storyboard example names one camera body and one 35 mm cinema lens. On 2.5 a single line like that is vendor-sanctioned; a stacked gear list still is not.",
+    "reference-rules-core": "Identity = a few flat-lit neutral angles; one reference per role, named inline; 2-4 refs not 12; describe environments instead of feeding a grid.\n\n1. **2-4 strong references beat both extremes.** Not 1 (warps toward itself), not 12 (averages worse). Start with 2-3 focused refs — each one adds context AND another variable to balance.\n2. **One reference per ROLE, named in the prompt** — identity / style-grade / environment. The model does **not** infer a reference's role from its position in the list; the inline name carries it. Same-role competitors drift (two \"identity\" refs of different people blend into a third face). Slates resolves `@mentions` / `#tags` into numbered citations. You can also bind references directly in scene prose, naming what each image supplies.\n3. **One identity sheet per character, named inline.** A character's identity is a single asset (dominant portrait + body panels), so attach that one asset rather than a pile of views: **fewer competing renderings of a face is better, because the model cannot tell which one is authoritative and averages them.** Slates cites it as `Marcus (image 1)`. **Do NOT hand-write a \"Reference Image Instructions\" block or role essays** (\"use for identity, ignore the outfit, render a neutral expression\") — that drags the sheet's studio lighting and wardrobe into a scene that asked for neither. The prompt leads; the user's words own wardrobe, expression, lighting, and action.\n4. **Flat-light identity refs.** Prep identity references with flat, even, shadowless lighting on a plain neutral background. A studio-lit or scene-lit character sheet bleeds its lighting into every generation — the failure looks like the subject was green-screen-pasted in front of the location. Reference prep beats prompting here.\n5. **Environment: describe it, don't feed a grid.** Default to describing the location in words and let the model build a space that fits the shot. Reserve an environment reference for a mandatory exact-match, and then use ONE clean establishing image with natural ambient light that reads as the location's real light — never a multi-panel grid fed whole.\n6. **Grids: explore, don't input.** Use grids to explore compositions cheaply, then pick a cell. Never feed a grid back in as a reference — the cells share a split detail budget and were generated jointly, so their flaws propagate.\n7. **Reuse the same refs across every shot** in a sequence. Lock a set and keep it; swapping references mid-sequence causes drift, because the model adapts each reference to the current prompt rather than copying it.\n8. **Legible in-shot text → bake it into a still start frame, never trust text-to-video.** Have an image model render the text, then animate from that locked frame. Video models smear type.\n9. **Working from existing media — describe ONLY what changes.** The source already carries its composition, motion, timing, and performance; re-describing them fights the model. Narrate the delta. (Video lane: restyle your own clip while keeping the performance; delayed-VFX on \"video one\"; marker-object insertion; video-as-reference for a series.)\n10. **Style transforms happen in natural language.** By default the source's artistic medium and visual style are inherited. To change it, add a plain-text instruction (\"anime → real person\"). There are no preset pickers, and there is no style slider.",
     "reference-tips-short": "Name each reference inline; never write role essays. Slates does this for you: `@mention` a subject or environment and it composes `Marcus (image 1) in the cafe (image 2)`, citing them in the exact order it sends them. One canonical identity image avoids competing facial renderings; a \"Reference Image Instructions\" block drags reference lighting into your scene. Start with 2-3 focused refs.",
     "references-read-literally": "> **The general law: the model reads a reference literally.**\n> A reference image is not a suggestion. Whatever is baked into it — lighting, medium, texture, symmetry, competing identities — is read as a **property of the subject** and reproduced downstream. A baked rim light tints every shot made from that sheet. A sheet that looks like a 3D game render gets animated like game footage. Two competing renderings of one face get averaged into a third face.\n\nEvery reference rule below is a corollary of that one sentence, which is why \"prep the reference\" beats \"prompt around the reference\" every time:\n\n- **Flat, plain identity refs** — because scene lighting in the sheet becomes scene lighting in the output (Slates' own receipt: a studio-lit sheet produced a subject that looked green-screen-pasted in front of mountains).\n- **One authoritative rendering per subject** — because the model cannot tell which panel is the real one. ByteDance documents this failure directly: multi-view character assets \"confuse the model's character recognition, causing it to generate duplicate characters of the same appearance.\"\n- **No 3D-game-render look in a reference** — the model recognizes the render mood and inherits its motion character, so the *animation* comes out looking like game footage. This is not a taste rule; it is the same literal-reading mechanism applied to the temporal layer.\n- **Break perfect symmetry** — mirrored faces and dead-square framing read as synthetic, and the model preserves that reading rather than correcting it.\n\n**What this means in practice:** when output is wrong in a way that tracks the *subject* rather than the *scene* — the lighting is wrong the same way in every shot, the face drifts, the material looks synthetic everywhere — fix the reference, not the prompt. Prompting around a baked-in property is the expensive way to lose.",
     "seedance-25-timestamps": "**2.0 does not respond to timestamps and answers only to shot numbers. 2.5 responds to\ninteger-second timestamps.** That is ByteDance's own first line under \"Differences from Seedance\n2.0\", and it is why a 30-second take is usable at all: the length is only worth buying if you can\nsay *when* things happen inside it.\n\nBoth formats are valid on 2.5, and you can mix them — `Shot N` blocks for a storyboard whose\npacing you are happy to leave to the model, timestamps when a beat has to land at a moment.\n\n**Three ways to control time, all first-party:**\n\n| Form | Write it like |\n|---|---|\n| **Interval** | `0-3 seconds… 3-7 seconds… 7-15 seconds` or `[1s-4s]… [4s-8s]… [8s-12s]` |\n| **Time point** | *\"Quick left sideways transition at the 5-second mark.\"* |\n| **Relative** | *\"After 3 seconds, everyone around him shakes their head.\"* · *\"The frame freezes for 1 second after he presses the shutter.\"* |\n\n**The rules that come with them:**\n\n- **One second is the smallest unit.** Integers only — no `2.5s`, no frames.\n- **No gaps in the timeline.** `0-3s… 5-6s…` leaves 3-5s unspecified and the model fills it however\n  it likes. Intervals must abut: `0-3s`, `3-7s`, `7-15s`.\n- **Budget the plot to the seconds.** Too little content in a range and the model improvises to\n  fill it; too much and you get extra cuts or dropped beats. This is the actual craft of a 30s take.\n- **Never time-code a high-frequency action.** *\"Shake your head three times per second\"* is\n  explicitly called out as a misuse — timestamps schedule beats, they don't choreograph frames.\n- **Transitions want both halves:** the moment AND the method — *\"At the 5-second mark, the camera\n  transitions leftward with a left wipe into a natural dissolve.\"*\n- **Timestamps work on an EDIT too**, and that is where they earn the most: they scope a change in\n  time as well as in content — *\"Change the man's action from drinking coffee to mopping the floor\n  from 4-6 seconds in Video 1, and leave the rest of the content unchanged.\"* Without a range, a\n  whole-clip instruction is applied to the whole clip.\n\nDo **not** carry this back to 2.0, and do not carry Veo's `[00:00-00:02]` bracket syntax into\neither — 2.0 ignores time entirely, and the cross-model syntax swap is its own known failure.",
     "seedance-25-timestamps-short": "Seedance 2.0 ignores timing and answers only to \"Shot 1 / Shot 2\"; 2.5 acts on whole-second timestamps, and that is what makes a 30-second take controllable rather than just long. Three forms work: intervals (\"0-3 seconds…3-7 seconds\"), a point (\"at the 5-second mark\"), or relative (\"after 3 seconds\"). Whole seconds only, no gaps between intervals, and never to choreograph fast repeated motion. They work on edits too, where a range scopes the change: \"…from 4-6 seconds…\".",
+    "sheet-tool-defaults": "**What the sheet tools render on** (you do not pick these; omit `model`):\n\n- **Character identity sheet:** `gpt-image-2-5-sunburst` at 3k, quality `high`, one 16:9 image.\n- **Establishing image:** `gpt-image-2-5-sunburst` at 3k, quality `high`, one 16:9 image.\n\nPrice a sheet for that model at 16:9, with resolution and quality left at their defaults. **Never 4K** — no identity gain at sheet scale, wasted spend.",
     "still-gate": "**A visible defect in the still is already a STOP.** Do not animate it. Fix the frame first, then move to motion — and go to motion only when the crop passes the still scan and you genuinely need movement to confirm an uncertain edge, reflection, or object.\n\nThis is a **cost** rule as much as a craft rule: a 1080p/10s premium video generation costs many multiples of an image re-roll, and video is where a defect stops being fixable. Anything wrong in the still gets worse in motion — soft geometry mushes, broken-but-plausible objects fall apart, oily textures start crawling. **Animating a known-bad frame is the single most expensive mistake in the pipeline.** Re-rolling the image is the cheap move; re-rolling the video is not.",
     "thresholds": "<!-- GENERATED from @slatesvideo/shared — do not edit between the markers.\n     Source: CONFIRM_CREDITS, DEVIATION_FACTOR and the audio bounds in\n     packages/shared/src/operations/index.ts. Every number here is REFUSED by an\n     op when a prompt gets it wrong, which is why none of them is typed by hand\n     any more: this block replaced four claims that contradicted the code. -->\n\n**The thresholds, from the code that enforces them:**\n\n- **Confirm gate:** above **17 credits** an op returns `requires_confirm` and will not\n  proceed until you re-call with `confirm: true`. Below it, announce the cost once and go.\n- **Deviation pause:** the desktop Studio Agent stops and re-asks when projected generation spend\n  exceeds the approved plan by more than **20%**. You do not trigger this; the app does.\n- **Seed Audio duration:** **3–120 seconds.** There is no duration\n  parameter on the model — the number you pass is written into the prompt AND is what the user is\n  billed. Outside that range the op refuses rather than clamping.\n- **Sound Effects duration:** **1–22 seconds**, billed per second, never left for the\n  model to pick.\n\nNever quote a credit figure from memory: `slates_estimate_generation_cost` returns the real one.",
 };

package/dist/prompts/prompting-tips.d.ts

@@ -16,7 +16,7 @@ export interface PromptingTipsEntry {
     /** Footer callout paragraphs. */
     footer?: string[];
 }
-export type PromptingTipsKey = 'seedance' | 'seedance-2-5' | 'seedance-2-5-edit' | 'kling' | 'kling-edit' | 'veo' | 'omni-flash' | 'omni-flash-edit' | 'minimax-h3' | 'ltx-2-5' | 'nano-banana' | 'nano-banana-lite' | 'seed-audio' | 'eleven-sfx' | 'inworld-tts-2';
+export type PromptingTipsKey = 'seedance' | 'seedance-2-5' | 'seedance-2-5-edit' | 'kling' | 'kling-edit' | 'veo' | 'omni-flash' | 'omni-flash-edit' | 'minimax-h3' | 'ltx-2-5' | 'nano-banana' | 'nano-banana-lite' | 'gpt-image-2-5' | 'seed-audio' | 'eleven-sfx' | 'inworld-tts-2';
 export declare const PROMPTING_TIPS: Record<PromptingTipsKey, PromptingTipsEntry>;
 /** Null when no tips exist for the key — callers render an honest fallback. */
 export declare function getPromptingTips(key: string): PromptingTipsEntry | null;

package/dist/prompts/prompting-tips.js

@@ -115,7 +115,7 @@ const SEEDANCE_25 = {
     ...SEEDANCE,
     label: 'Seedance 2.5',
     intro: [
-        'Seedance 2.5 is a SECOND SEAT next to 2.0, not an upgrade of it. It buys one 30-second take instead of 15, up to 30 image references (plus 10 video and 10 audio), audio-only references and integer-second timestamps — and it gives up 4K. It runs at 480p, 720p or 1080p, and it costs more than 2.0 at every tier they share, so pick 2.0 when you want the same resolution cheaper or you want 4K.',
+        'Seedance 2.5 is the default video model. Against 2.0 it buys one 30-second take instead of 15, up to 30 image references (plus 10 video and 10 audio), audio-only references and integer-second timestamps — and it gives up 4K. It runs at 480p, 720p or 1080p, and it costs more than 2.0 at every tier they share, so pick 2.0 when you want the same resolution cheaper or you want 4K.',
         "ByteDance's official advanced formula has 8 slots: precise subject + action details + scene/environment + lighting & color tone + camera movement + visual style + image quality + constraints. Sweet spot 60-150 words for a single shot, longer for multi-shot.",
     ],
     columns: [
@@ -137,7 +137,7 @@ const SEEDANCE_25 = {
         [
             {
                 heading: '720p is not the cheap one here',
-                example: '30s \u00b7 720p \u00b7 Face route = 484 credits\n15s \u00b7 1080p \u00b7 Seedance 2.0 Face = 411 credits',
+                example: '30s \u00b7 720p \u00b7 Face route = 489 credits\n15s \u00b7 1080p \u00b7 Seedance 2.0 Face = 411 credits',
                 note: 'Length is what moves the price, and 2.5 doubles the length ceiling — so a 30-second 720p clip can cost more than a 15-second 1080p one, against a 1,000-credit starting balance. Explore at short LENGTH rather than low resolution: cut the seconds to 4-8 while you are finding the shot, and stay at the resolution you actually want. A 480p pass does not de-risk a 720p render — generation is stochastic, so the 720p run is a different take, not the same shot rendered better. The Generate button always shows the exact number first.',
                 critical: true,
             },
@@ -151,7 +151,7 @@ const SEEDANCE_25 = {
     ],
     footer: [
         '30 image references is a budget, not a target — 2-4 strong references still beat both extremes, one per role. ByteDance\'s own ceilings for 2.5: 1-8 subjects bound by image reference stay stable (9-12 works but needs re-rolls), 1-5 subjects bound by video or audio reference, and 5-10 seconds is the sweet spot for a reference clip. Unlike 2.0, a multi-view turnaround sheet can be a single subject reference here — past 5 subjects, go back to one view per image. The larger budget is for long multi-shot takes and for video plus audio references alongside images.',
-        'A reference VIDEO bills input seconds PLUS output seconds, and 2.5 accepts references up to 30s combined — so a 20-second reference driving a 20-second output bills 40 seconds. The Generate button shows the total.',
+        'A reference VIDEO bills input seconds PLUS output seconds, and 2.5 accepts references up to 30s combined — so a 20-second reference driving a 20-second output bills 40 seconds. On the AI-face route the reference counts as at least as long as the output: a 5-second reference on a 20-second output bills 40 seconds, not 25. The Generate button shows the total.',
         ...(SEEDANCE.footer ?? []).slice(0, 2),
         'Frames and reference images stay mutually exclusive, and on a first/last-frame generation Seedance 2.5 chooses the aspect ratio itself — the ratio control shows "Adaptive" because the start frame decides the shape.',
     ],
@@ -190,7 +190,7 @@ const SEEDANCE_25_EDIT = {
         [
             {
                 heading: 'When to use it instead of the others',
-                note: 'Length is the reason: it is the only engine that accepts a clip over 15 seconds. Inside the others\' range, choose on fidelity — Omni Flash Edit is the prompt-only fidelity winner and the cheapest seat, and Kling O3 Edit is the one that takes subject and style reference images.',
+                note: 'Length is the reason: it is the only engine that accepts a clip over 15 seconds. Inside the others\' range, choose on fidelity — Omni Flash Edit is the prompt-only fidelity winner and the cheapest option, and Kling O3 Edit is the one that takes subject and style reference images.',
             },
             {
                 heading: 'It edits the audio too',
@@ -347,8 +347,8 @@ const OMNI_FLASH = {
                 note: 'No negative-prompt field — write what to avoid as a direct instruction.',
             },
             {
-                heading: 'Know its seat',
-                note: 'Cheap drafts, iteration volume, and audio-in-one-gen at low cost. For hero shots, Kling 3.0 (general default) or Seedance 2.0 (premium/physics) still win.',
+                heading: 'Know its role',
+                note: 'Cheap drafts, iteration volume, and audio-in-one-gen at low cost. For hero shots, Seedance 2.5 (the default) or Seedance 2.0 (4K, cheaper) still win.',
             },
         ],
     ],
@@ -398,6 +398,45 @@ const OMNI_FLASH_EDIT = {
         'Ship via segment-splice: edit only the seconds where the change happens (Trim / Split first), then splice back over the original on the timeline with the original audio underneath. Chain edits one change at a time — each edit saves as a new clip linked to its parent.',
     ],
 };
+const GPT_IMAGE_25 = {
+    label: 'GPT Image 2.5',
+    intro: [
+        'Two tiers at the same price: Flare is the faster one; Sunburst is the better-quality one, and slower. Explore on Flare, finish on Sunburst.',
+        'The photoreal front-runner for people, and the most reliable model for readable text, ordered panels and exact placement.',
+    ],
+    columns: [
+        [
+            {
+                heading: 'Name each reference where it is used',
+                example: 'The woman from image 1 cooks on a rocky summit, lit and graded like image 2.',
+                note: PARTIALS['reference-tips-short'],
+            },
+            {
+                heading: 'Quote text that must render',
+                example: 'the word "SLATES" once in small plain letters on the left chest',
+                note: "Quoted strings render most reliably. Describe a font's feel, never its name, and keep on-image text under about 30 words.",
+            },
+            {
+                heading: 'Set the quality tier on purpose',
+                example: 'low · medium · high · xhigh · max',
+                note: 'High is the everyday tier and max costs about four times as much. Medium is cheap enough to draft on; go past high only when tiny type or a finished frame needs it.',
+            },
+        ],
+        [
+            {
+                heading: 'The look: describe what the camera sees',
+                example: 'She is close to a silhouette: her face falls into deep shadow.\nThe sky around the sun burns out to white.',
+                note: PARTIALS['cinematic-tips-short'],
+                critical: true,
+            },
+            {
+                heading: 'Describe the frame, or swap into one you own',
+                example: 'Dark hiking trousers. The only things on the rock are the stove and the pan.\nTake image 1 and change only the character to the character in image 2.',
+                note: PARTIALS['cinematic-routes-short'],
+            },
+        ],
+    ],
+};
 const NANO_BANANA = {
     label: 'Nano Banana 2',
     intro: [
@@ -414,7 +453,7 @@ const NANO_BANANA = {
             {
                 heading: 'Named lenses + apertures',
                 example: '85mm f/1.4 · 135mm f/2.8 · 50mm f/1.2 · 35mm f/2 · Panavision anamorphic · 400mm telephoto',
-                note: '135mm f/2.8 is the cheat code for skin texture and intimate compression. Anamorphic for cinematic width + horizontal flares.',
+                note: 'Describe the intended perspective, depth of field and texture alongside the lens. A model does not guarantee physical lens simulation.',
             },
             {
                 heading: 'Named film stocks (one per prompt)',
@@ -424,7 +463,7 @@ const NANO_BANANA = {
             {
                 heading: "Don't carry lens + stock into a video prompt",
                 example: '85mm f/1.4, Portra 400\n→ close-up, shallow depth of field, warm natural colors, cinematic texture',
-                note: 'Lenses, apertures, film stocks and camera bodies are an image-model lever and a video-model anti-pattern — ByteDance\'s Seedance guide never mentions f-stops, lens millimetres, fps or shutter angle. When you animate a frame you made here, translate the look into shot size, depth of field and colour tone instead of pasting the gear list across.',
+                note: PARTIALS['lens-video-split'],
             },
             {
                 heading: 'Physics-based lighting',
@@ -434,14 +473,19 @@ const NANO_BANANA = {
             {
                 heading: 'Imperfection vocabulary',
                 example: 'visible pores · peach fuzz · ISO noise · sweat beading · slight hyperpigmentation · unretouched raw photography',
-                note: 'Forces the model away from AI-clean skin. The default is too smooth — you have to ask for the imperfections that real photos have.',
+                note: 'Forces the model away from AI-clean skin. The default is too smooth — you have to ask for the imperfections that real photos have. Lead with the kind of photograph and the conditions on the skin; a bare list of flaw words reads as tokens.',
+            },
+            {
+                heading: 'The look: describe what the camera sees',
+                example: 'She is close to a silhouette: her face falls into deep shadow.\nThe sky around the sun burns out to white.',
+                note: PARTIALS['cinematic-tips-short'],
             },
         ],
         [
             {
                 heading: '❌ The anti-list — avoid these',
                 example: '8k · masterpiece · hyperrealistic · ultra-detailed · trending on ArtStation · perfect skin · flawless · airbrushed · cinematic (alone)',
-                note: 'Tag-soup phrases from the Stable-Diffusion era. Measured success ~60-70% with these vs ~95%+ with positive description. Always specify which cinema — director, lens, era, stock.',
+                note: 'Generic quality tags do not specify an observable result. Describe the medium, light, exposure and texture the brief calls for.',
                 critical: true,
             },
             {
@@ -537,7 +581,7 @@ const SEED_AUDIO = {
                 note: 'Up to 3 audio clips (max 30s each), referenced as @Audio1–@Audio3 — OR one image to score what is in frame. Never both in the same generation.',
             },
             {
-                heading: 'Know its seat',
+                heading: 'Know its role',
                 note: 'Scenes, beds, room tone and dialogue in one pass. For a single effect that has to land on a specific frame, use Sound Effects.',
             },
         ],
@@ -579,7 +623,7 @@ const ELEVEN_SFX = {
                 note: 'Higher hugs your wording with less variation between takes; lower explores. Raise it when a re-roll keeps wandering off the brief.',
             },
             {
-                heading: 'Know its seat',
+                heading: 'Know its role',
                 note: 'One precise effect on a known frame. Full rooms and layered scenes are cheaper and better in one Seed Audio pass.',
             },
         ],
@@ -589,7 +633,7 @@ const MINIMAX_H3 = {
     label: 'MiniMax H3',
     intro: [
         'MiniMax H3 generates picture and sound in one pass — 24fps, 32kHz stereo, 5-15 seconds, 11 stably-supported languages. It is the only video model in Slates where audio is AUTHORED rather than switched on: synchronised dialogue and action sounds go in the body of the prompt, ambience goes in a soundscape section, and audience-only music goes in a score section. Put a sound in the wrong section and it is dropped, doubled, or attributed to the wrong source.',
-        'Two seats that differ in LADDER and PRICE, not in what they accept. Base H3 runs 480p / 768p / 2K / 4K; H3 Max is fal\'s faster post-train and runs 480p / 768p / 1080p, dearer than base H3 at the tier they share - a deliberate speed pick, never the cheap one. BOTH read up to 9 reference images plus 3 video and 3 audio clips (12 files total, and audio never travels alone), and both animate a start frame and an end frame. 768p is the default on both because it is the tier the model natively generates; base H3\'s 2K and 4K are upscales of a 768p base. Reference images past the free allowance are billed and the allowances DIFFER: 5 free on base H3, 4 on Max.',
+        'Three models. Base H3 runs 480p / 768p / 2K / 4K; H3 Max is fal\'s faster post-train and runs 480p / 768p / 1080p, dearer than base H3 at the tier they share - a deliberate speed pick, never the cheap one; H3 Max Turbo has Max\'s ladder at half Max\'s rate and takes NO references. Base H3 and Max read up to 9 reference images plus 3 video and 3 audio clips (12 files total, and audio never travels alone); all three animate a start frame and an end frame. 768p is the default on all three because it is the tier the model natively generates; base H3\'s 2K and 4K are upscales of a 768p base, and 1080p on Max and Turbo is a refinement of it. Reference images past the free allowance are billed and the allowances DIFFER: 5 free on base H3, 4 on Max.',
     ],
     columns: [
         [
@@ -624,7 +668,7 @@ const MINIMAX_H3 = {
             {
                 heading: 'Say how much of a reference survives',
                 example: 'Give the man in image 3 the weathered leather texture of the jacket in image 4.',
-                note: 'H3 is the only seat that understands transferring a characteristic onto a DIFFERENT subject. State each reference\'s job and how much of it should carry through — kept whole, kept in part, transferred, or a loose echo.',
+                note: 'H3 is the only model that understands transferring a characteristic onto a DIFFERENT subject. State each reference\'s job and how much of it should carry through — kept whole, kept in part, transferred, or a loose echo.',
             },
             {
                 heading: 'Reference images past the fifth cost extra',
@@ -650,7 +694,7 @@ const LTX_2_5 = {
     label: 'LTX-2.5',
     intro: [
         'LTX-2.5 scores the picture on the same pass that draws it, so SOUND IS THE FIRST THING YOU WRITE, not the last. Lightricks ranks the six parts of a prompt in this order: sound, camera, character detail, shot type and scene, then scene dressing — and scene dressing is the first thing to cut when a prompt sprawls. Everything goes in ONE flowing paragraph, not a list of labelled sections.',
-        'Two seats. Base LTX-2.5 is the distilled build: 720p / 1080p / 1440p / 4K and clips from 6 to 20 seconds, and it is the cheapest native 1080p second in Slates. LTX-2.5 Pro is the full diffusion build ("Diffusion Fidelity Rendering" spends extra compute on busy frames) but reaches a SHORTER ladder — 1080p and 10 seconds maximum — while costing about a third more. Pro is for a dense final render; base is for iteration, long takes and 4K.',
+        'Two models. Base LTX-2.5 is the distilled build: 720p / 1080p / 1440p / 4K and clips from 6 to 20 seconds, and it is the cheapest native 1080p second in Slates. LTX-2.5 Pro is the full diffusion build ("Diffusion Fidelity Rendering" spends extra compute on busy frames) but reaches a SHORTER ladder — 1080p and 10 seconds maximum — while costing about a third more. Pro is for a dense final render; base is for iteration, long takes and 4K.',
     ],
     columns: [
         [
@@ -706,14 +750,14 @@ const LTX_2_5 = {
     ],
     footer: [
         'Frames, not references. LTX takes a start frame and an optional end frame (which generates a transition between the two) — it has no reference endpoint at all, so identity, style and environment reference images are not available on this model. For character consistency across separate shots, use MiniMax H3 or Kling.',
-        'Aspect ratios are 16:9 and 9:16 only, and native audio is included free at every resolution — there is no sound surcharge on either seat.',
+        'Aspect ratios are 16:9 and 9:16 only, and native audio is included free at every resolution — there is no sound surcharge on either model.',
         'In image-to-video, do not cut away from the opening frame too early: you have paid for that frame, so let it play before the first move.',
     ],
 };
 const INWORLD_TTS = {
     label: 'Inworld TTS-2',
     intro: [
-        'The voice seat: one named voice saying one line. Unlike every other surface in Slates, the prompt is not a description of what you want — it IS the words that get spoken, verbatim, and its length is what you are billed for.',
+        'The voice model: one named voice saying one line. Unlike every other surface in Slates, the prompt is not a description of what you want — it IS the words that get spoken, verbatim, and its length is what you are billed for.',
         'A voice belongs to a character, the same way a face does. Build it once from a clip or a description, then send it lines.',
     ],
     columns: [
@@ -761,7 +805,7 @@ const INWORLD_TTS = {
                 note: 'Numbers, dates and abbreviations are read literally. Write them as they should sound.',
             },
             {
-                heading: 'Know its seat',
+                heading: 'Know its role',
                 note: 'One voice, cleanly. Dialogue mixed with effects and room tone in one pass is Seed Audio; a single non-speech sound is Sound Effects.',
             },
         ],
@@ -780,6 +824,7 @@ export const PROMPTING_TIPS = {
     'ltx-2-5': LTX_2_5,
     'nano-banana': NANO_BANANA,
     'nano-banana-lite': NANO_BANANA_LITE,
+    'gpt-image-2-5': GPT_IMAGE_25,
     'seed-audio': SEED_AUDIO,
     'eleven-sfx': ELEVEN_SFX,
     'inworld-tts-2': INWORLD_TTS,