@slatesvideo/shared 0.6.11 → 0.7.0

package/dist/prompts/generation-policy.d.ts

@@ -0,0 +1,41 @@
+/** Product fan-out policy: one provider request and debit per output.
+ * This is NOT a model capability or provider batch limit. Desktop mirror is
+ * generated by slate/scripts/sync-generation-policy.mjs; never edit it there. */
+export declare const IMAGE_QUANTITIES: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+export declare const MAX_IMAGE_VARIATIONS: 1 | 2 | 4 | 5 | 3 | 10 | 8 | 7 | 6 | 9;
+export type ImageQuantity = typeof IMAGE_QUANTITIES[number];
+export declare const clampImageQuantity: (count?: number) => ImageQuantity;
+/** Default saved-recipe framing, shared by composer restore, quote and dispatch. */
+export declare const DEFAULT_SHOT_ASPECT_RATIO: "16:9";
+/**
+ * The built-in tools, and the seat each one renders on when its caller names no
+ * model. THE ONE HOME, for both repos: the desktop reads it through its generated
+ * mirror (`toolModel` in slate/src/shared/pricing.ts), this package reads it for
+ * the op descriptions and the generated skill partial.
+ *
+ * `'default-image'` means "follow the app's default image model"
+ * (`defaultModelFor('image')` in model-facts.ts), so promoting a better image
+ * model moves these tools with it and nothing else is edited. A model id pins a
+ * tool instead, for a reason recorded beside it. This file stays a
+ * dependency-free leaf (it is copied verbatim into the desktop), which is why
+ * the seat is a token each consumer resolves rather than a call made here.
+ *
+ * Before 2026-09-21 the sheet tools' model was typed at every use on the desktop
+ * and twice more here (an op description and a skill), so three screens quoted
+ * a sheet from one typed id while the handler billed from another.
+ */
+export declare const BUILT_IN_TOOLS: readonly ["character-sheet", "environment-plate", "grid-extract", "image-edit"];
+export type BuiltInTool = typeof BUILT_IN_TOOLS[number];
+export declare const DEFAULT_IMAGE_SEAT: "default-image";
+export declare const TOOL_SEAT: Record<BuiltInTool, typeof DEFAULT_IMAGE_SEAT | string>;
+/** Both sheet tools frame one wide image. On GPT Image the aspect is part of the price. */
+export declare const SHEET_TOOL_ASPECT_RATIO: "16:9";
+/**
+ * The GPT Image tier a sheet tool pins. It read 'medium' until 2026-09-09: GPT
+ * Image 2.5 renamed the ladder, so the tier GPT Image 2 called `medium` is now
+ * `high`, and a stored 'medium' would have kept compiling while naming a
+ * materially cheaper tier. Sheets are the identity lane (every downstream shot
+ * inherits this frame's likeness), so this is deliberately not the draft tier.
+ */
+export declare const SHEET_TOOL_GPT_QUALITY: "high";
+//# sourceMappingURL=generation-policy.d.ts.map

package/dist/prompts/generation-policy.js

@@ -0,0 +1,53 @@
+/** Product fan-out policy: one provider request and debit per output.
+ * This is NOT a model capability or provider batch limit. Desktop mirror is
+ * generated by slate/scripts/sync-generation-policy.mjs; never edit it there. */
+export const IMAGE_QUANTITIES = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+export const MAX_IMAGE_VARIATIONS = IMAGE_QUANTITIES[IMAGE_QUANTITIES.length - 1];
+export const clampImageQuantity = (count = 1) => Math.max(1, Math.min(MAX_IMAGE_VARIATIONS, Number.isFinite(count) ? Math.floor(count) : 1));
+/** Default saved-recipe framing, shared by composer restore, quote and dispatch. */
+export const DEFAULT_SHOT_ASPECT_RATIO = '16:9';
+/**
+ * The built-in tools, and the seat each one renders on when its caller names no
+ * model. THE ONE HOME, for both repos: the desktop reads it through its generated
+ * mirror (`toolModel` in slate/src/shared/pricing.ts), this package reads it for
+ * the op descriptions and the generated skill partial.
+ *
+ * `'default-image'` means "follow the app's default image model"
+ * (`defaultModelFor('image')` in model-facts.ts), so promoting a better image
+ * model moves these tools with it and nothing else is edited. A model id pins a
+ * tool instead, for a reason recorded beside it. This file stays a
+ * dependency-free leaf (it is copied verbatim into the desktop), which is why
+ * the seat is a token each consumer resolves rather than a call made here.
+ *
+ * Before 2026-09-21 the sheet tools' model was typed at every use on the desktop
+ * and twice more here (an op description and a skill), so three screens quoted
+ * a sheet from one typed id while the handler billed from another.
+ */
+export const BUILT_IN_TOOLS = ['character-sheet', 'environment-plate', 'grid-extract', 'image-edit'];
+export const DEFAULT_IMAGE_SEAT = 'default-image';
+export const TOOL_SEAT = {
+    'character-sheet': DEFAULT_IMAGE_SEAT,
+    'environment-plate': DEFAULT_IMAGE_SEAT,
+    // Pinned: the image viewer offers grid extraction a fixed short list of seats,
+    // and the cell-extraction prompt has a variant per seat family. Moving it is a
+    // picker and a prompt change first.
+    'grid-extract': 'nano-banana-2',
+    // Follows the default image model (2026-09-29). The viewer's Edit box lists
+    // every image model from the registry, and the edit handler sends references
+    // to each one up to its own cap, so nothing ties this tool to one family. Until
+    // then it was pinned to Nano Banana 2 while the app's default was GPT Image 2.5
+    // Sunburst, so Edit and the prompt bar opened on different models for the
+    // same picture.
+    'image-edit': DEFAULT_IMAGE_SEAT,
+};
+/** Both sheet tools frame one wide image. On GPT Image the aspect is part of the price. */
+export const SHEET_TOOL_ASPECT_RATIO = '16:9';
+/**
+ * The GPT Image tier a sheet tool pins. It read 'medium' until 2026-09-09: GPT
+ * Image 2.5 renamed the ladder, so the tier GPT Image 2 called `medium` is now
+ * `high`, and a stored 'medium' would have kept compiling while naming a
+ * materially cheaper tier. Sheets are the identity lane (every downstream shot
+ * inherits this frame's likeness), so this is deliberately not the draft tier.
+ */
+export const SHEET_TOOL_GPT_QUALITY = 'high';
+//# sourceMappingURL=generation-policy.js.map

package/dist/prompts/guide-retrieval.d.ts

@@ -0,0 +1,9 @@
+export type GuideDepth = 'card' | 'index' | 'section' | 'full';
+/** Parse headings outside code fences; maintainer comments never reach agents. */
+export declare function guideSections(content: string): Array<{
+    title: string;
+    body: string;
+}>;
+/** Bounded retrieval. A missing card never silently expands to the full guide. */
+export declare function retrieveGuide(skill: string, content: string, depth: GuideDepth, query?: string): string;
+//# sourceMappingURL=guide-retrieval.d.ts.map

package/dist/prompts/guide-retrieval.js

@@ -0,0 +1,53 @@
+import { craftCard } from './craft-cards.js';
+/** Parse headings outside code fences; maintainer comments never reach agents. */
+export function guideSections(content) {
+    const clean = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '').replace(/<!--[\s\S]*?-->/g, '').trim();
+    const sections = [];
+    let current = { title: 'Overview', body: '' };
+    let fenced = false;
+    for (const line of clean.split(/\r?\n/)) {
+        if (/^\s*```/.test(line))
+            fenced = !fenced;
+        if (!fenced && /^#{1,3} /.test(line)) {
+            if (current.body.trim())
+                sections.push(current);
+            current = { title: line.replace(/^#+ /, ''), body: line };
+        }
+        else
+            current.body += '\n' + line;
+    }
+    if (current.body.trim())
+        sections.push(current);
+    return sections;
+}
+/** Bounded retrieval. A missing card never silently expands to the full guide. */
+export function retrieveGuide(skill, content, depth, query) {
+    const sections = guideSections(content);
+    const index = sections.map((s) => `- ${s.title}`).join('\n');
+    if (depth === 'full')
+        return sections.map((s) => s.body.trim()).join('\n\n');
+    if (depth === 'index')
+        return index;
+    if (query?.trim()) {
+        const q = query.trim().toLowerCase();
+        // Exact technique IDs return one complete row with its source heading.
+        for (const s of sections) {
+            const row = s.body.split('\n').find((line) => line.toLowerCase().startsWith(`| \`${q}\` |`));
+            if (row)
+                return `${s.title}\n\n| Technique | Evidence | What it does | Reach for · skip | Say |\n|---|---|---|---|---|\n${row}`;
+        }
+        const words = q.split(/[^\p{L}\p{N}-]+/u).filter(Boolean);
+        const ranked = sections.map((s) => ({ s, score: words.reduce((n, w) => n + (s.title.toLowerCase().includes(w) ? 4 : s.body.toLowerCase().includes(w) ? 1 : 0), 0) }))
+            .filter((x) => x.score > 0).sort((a, b) => b.score - a.score);
+        if (!ranked.length)
+            return `No section matches "${query}". Available sections:\n${index}`;
+        const body = ranked[0].s.body.trim();
+        if (body.length <= 6000)
+            return body;
+        // Never cut a table row or a worked prompt mid-sentence.
+        return `Section "${ranked[0].s.title}" is too large for a selective response. Use a technique ID or depth "full".\n${index}`;
+    }
+    const card = craftCard(skill);
+    return `${card ?? sections[0]?.body.trim().slice(0, 1600) ?? 'No overview available.'}\n\nSections (request with query, or depth "full"):\n${index}`;
+}
+//# sourceMappingURL=guide-retrieval.js.map

package/dist/prompts/index.d.ts

@@ -8,4 +8,5 @@ export * from './character-sheet.js';
 export * from './environment-sheet.js';
 export * from './prompting-tips.js';
 export * from './asset-label.js';
+export * from './generation-policy.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.js

@@ -28,4 +28,5 @@ export * from './prompting-tips.js';
 // gallery. Also its own leaf subpath (`@slatesvideo/shared/asset-label`) for the
 // renderer, which cannot import the root barrel.
 export * from './asset-label.js';
+export * from './generation-policy.js';
 //# sourceMappingURL=index.js.map

package/dist/prompts/model-capabilities.d.ts

@@ -47,6 +47,14 @@ export interface VideoResolutionCapability {
     fixed?: VideoResolution;
     /** Default when this model is chosen (falls back to `options[0]`). */
     default?: VideoResolution;
+    /**
+     * Tiers the provider makes by UPSCALING a smaller native render, keyed to that
+     * render. They stay selectable; every surface that offers one says so and says
+     * we do not recommend it (Eric, 2026-09-30: "more expensive and they actually
+     * look worse"). A refinement pass the provider documents as its own stage, such
+     * as H3 Max's 1080p, is not an upscale and is not listed.
+     */
+    upscaledFrom?: Partial<Record<VideoResolution, VideoResolution>>;
 }
 /** Everything a model will ACCEPT. Capability only — never a price. */
 /**
@@ -86,6 +94,7 @@ export interface VoiceCloneCapability {
 }
 export declare const GPT_QUALITY_TIERS: readonly ["low", "medium", "high", "xhigh", "max"];
 export type GptQuality = (typeof GPT_QUALITY_TIERS)[number];
+export declare const DEFAULT_GPT_QUALITY: GptQuality;
 export declare const GPT_BACKGROUNDS: readonly ["auto", "transparent", "opaque"];
 export type GptBackground = (typeof GPT_BACKGROUNDS)[number];
 export type ImageResolution = '1k' | '2k' | '3k' | '4k';
@@ -128,6 +137,8 @@ export declare function falImageSize(model: string, aspectRatio?: string, resolu
 };
 export interface ModelCapability {
     imageResolutions?: ImageResolution[];
+    /** Product default shared by estimates and generation. */
+    defaultImageResolution?: ImageResolution;
     /**
      * Images ONE request may ask the provider for in a single batch.
      *
@@ -204,6 +215,8 @@ export declare function voiceCloneFor(model: string): VoiceCloneCapability | und
 /** Aspect ratios a model accepts, honouring the provider override. */
 export declare function aspectRatiosFor(model: string, provider?: string): AspectRatio[];
 /** Video resolutions a model accepts. A FIXED model reports exactly its one value. */
+/** The native render an upscaled tier is made from, or undefined for a native tier. */
+export declare function upscaledFrom(model: string, resolution: string | undefined): VideoResolution | undefined;
 export declare function videoResolutionsFor(model: string): VideoResolution[];
 /** The resolution a model would actually run at. Fixed wins; else keep a legal
  *  current value; else the model's own default. Mirrors `clampVideoResolution`. */
@@ -250,7 +263,9 @@ export declare function describeDurations(models: readonly string[]): string;
 export declare function describeReferenceImageCaps(models: readonly string[]): string;
 /** H3 Max reference accounting, fal's worked tables read 2026-09-09.
  * https://fal.ai/models/minimax/h3-max/reference-to-video
- * 1080p video-reference pricing is unpublished; never infer it from output rates.
+ * 1080p: fal's page, read 2026-09-29: "768p and 1080p output use the same
+ * reference-video token counts." So 1080p takes the 768p figure; it was absent
+ * until fal published that sentence, and must never be inferred from output rates.
  */
 export declare const MINIMAX_MAX_REFERENCE: {
     readonly freeTokens: 4096;
@@ -265,4 +280,6 @@ export declare function minimaxMaxReferenceTokens(input: {
     audioSeconds: number;
     resolution: string;
 }): number;
+/** Quotes and generation use the same model default. */
+export declare function defaultImageResolutionFor(model: string): ImageResolution;
 //# sourceMappingURL=model-capabilities.d.ts.map

package/dist/prompts/model-capabilities.js

@@ -74,9 +74,9 @@ const OMNI_FLASH_ASPECT_RATIOS = ['16:9', '9:16'];
 /** Seedance (both seats, and the edit row): six — notably NO `4:5`. */
 const SEEDANCE_ASPECT_RATIOS = ['21:9', '16:9', '4:3', '1:1', '3:4', '9:16'];
 /**
- * MiniMax H3, both seats: six. Read off fal's live OpenAPI 2026-08-27 for
- * `minimax/h3/text-to-video` and `minimax/h3-max/text-to-video` — identical
- * enums. It happens to be the same six Seedance takes; kept as its OWN constant
+ * MiniMax H3, all three seats: six. Read off fal's live OpenAPI 2026-08-27 for
+ * `minimax/h3/text-to-video` and `minimax/h3-max/text-to-video`, and 2026-09-29
+ * for `minimax/h3-max-turbo/text-to-video` — identical enums. It happens to be the same six Seedance takes; kept as its OWN constant
  * because a provider that adds a ratio adds it to ITS family, and sharing the
  * Seedance constant would silently move H3 the next time ByteDance moves.
  *
@@ -101,6 +101,7 @@ const MINIMAX_H3_ASPECT_RATIOS = ['21:9', '16:9', '4:3', '1:1', '3:4', '9:16'];
  */
 const LTX_2_5_ASPECT_RATIOS = ['16:9', '9:16'];
 export const GPT_QUALITY_TIERS = ['low', 'medium', 'high', 'xhigh', 'max'];
+export const DEFAULT_GPT_QUALITY = 'high';
 export const GPT_BACKGROUNDS = ['auto', 'transparent', 'opaque'];
 // Product output sizes; schema bounds and metering receipt live in the GPT harvest.
 export const GPT_IMAGE_25_SIZES = {
@@ -221,6 +222,7 @@ export const AGENT_ROUTE_PROVIDER = 'fal';
 export const MODEL_CAPABILITIES = {
     // ── Image models ───────────────────────────────────────────────────────────
     'nano-banana-2': {
+        defaultImageResolution: '2k',
         imageResolutions: ['1k', '2k', '4k'],
         // fal's nano-banana-2 schema caps `num_images` at 4 (read 2026-09-09). This
         // is the ONLY model that batches: the MCP's headless path (no projectId) asks
@@ -231,11 +233,13 @@ export const MODEL_CAPABILITIES = {
         maxRefImages: 14,
     },
     'nano-banana-2-lite': {
+        defaultImageResolution: '1k',
         imageResolutions: ['1k'],
         aspectRatios: FULL_ASPECT_RATIOS,
         maxRefImages: 4, // fal edit endpoint caps input images at 4
     },
     'nano-banana-pro': {
+        defaultImageResolution: '2k',
         imageResolutions: ['1k', '2k', '4k'],
         aspectRatios: FULL_ASPECT_RATIOS,
         maxRefImages: 14,
@@ -276,30 +280,39 @@ export const MODEL_CAPABILITIES = {
     // limits either: the MCP's 4,000-character prompt against fal's 32,000, and
     // image quantity, which is a fan-out and has no provider ceiling at all.
     'gpt-image-2-5-flare': {
+        defaultImageResolution: '2k',
         imageResolutions: ['2k', '3k', '4k'],
         aspectRatios: ['1:1', '16:9', '9:16', '4:3', '3:4'],
         maxRefImages: 16,
     },
     'gpt-image-2-5-sunburst': {
+        defaultImageResolution: '3k',
         imageResolutions: ['2k', '3k', '4k'],
         aspectRatios: ['1:1', '16:9', '9:16', '4:3', '3:4'],
         maxRefImages: 16,
     },
     'flux-2-max': {
+        defaultImageResolution: '1k',
         imageResolutions: ['1k', '2k', '4k'],
         aspectRatios: FULL_ASPECT_RATIOS,
         maxRefImages: 4,
     },
     'seedream-5-lite': {
+        defaultImageResolution: '2k',
         imageResolutions: ['2k', '3k', '4k'],
         aspectRatios: FULL_ASPECT_RATIOS,
         maxRefImages: 10,
     },
     // ── Kling video ────────────────────────────────────────────────────────────
+    // Standard is 720p and Pro is 1080p; 4K is a separate endpoint shared by all
+    // four. Kling's own API: "std: ... The output video resolution is 720P.
+    // pro: ... The output video resolution is 1080P." The fal Standard endpoint
+    // takes no resolution parameter, and every Standard and Omni render we
+    // measured came back 1280x720 (2026-09-29). This row said 1080p until then.
     'kling-v3.0-std': {
         aspectRatios: KLING_DIRECT_ASPECT_RATIOS,
         providerAspectRatios: { fal: KLING_FAL_ASPECT_RATIOS },
-        videoResolution: { options: ['1080p', '4k'] },
+        videoResolution: { options: ['720p', '4k'] },
         // 3, not 5. The op claimed "Kling: 5-15" and refused legal 3-4s takes.
         duration: { min: 3, max: 15, mode: 'continuous' },
         maxIngredientImages: 4,
@@ -314,7 +327,8 @@ export const MODEL_CAPABILITIES = {
     'kling-v3.0-omni': {
         aspectRatios: KLING_DIRECT_ASPECT_RATIOS,
         providerAspectRatios: { fal: KLING_FAL_ASPECT_RATIOS },
-        videoResolution: { options: ['1080p', '4k'] },
+        // O3 Standard: 720p, as Standard above. Omni Pro is the 1080p tier.
+        videoResolution: { options: ['720p', '4k'] },
         duration: { min: 3, max: 15, mode: 'continuous' },
         maxIngredientImages: 4,
     },
@@ -435,10 +449,9 @@ export const MODEL_CAPABILITIES = {
         // ['480p','720p','1080p']. There is still NO 4K on 2.5 (2.0 is the only
         // Seedance with one), which is what keeps `is4kVideoKey` version-blind.
         //
-        // DEFAULT STAYS 720p, deliberately: a 30s take at 1080p is ~614 credits
-        // against a 1,000-credit welcome grant, and that is at the promotional
-        // 1080p rate — it rises when the promo lapses. Reaching a tier and
-        // defaulting to it are different decisions.
+        // DEFAULT STAYS 720p, deliberately: a 30s take at 1080p is ~853 credits
+        // against a 1,000-credit welcome grant. Reaching a tier and defaulting to it
+        // are different decisions.
         videoResolution: { options: ['480p', '720p', '1080p'], default: '720p' },
         duration: { min: 4, max: 30, mode: 'continuous' },
         maxIngredientImages: 30,
@@ -472,21 +485,25 @@ export const MODEL_CAPABILITIES = {
         // NO multimodal reference caps, deliberately: on an edit row the clip IS the
         // canvas and arrives through `sourceVideo`, not as a reference.
     },
-    // ── MiniMax H3 (both seats on fal — added 2026-08-27) ──────────────────────
+    // ── MiniMax H3 (three seats on fal — base and Max added 2026-08-27, Max
+    //    Turbo 2026-09-29) ─────────────────────────────────────────────────────
     //
-    // Every value below is READ OFF fal's live OpenAPI, fetched 2026-08-27:
+    // Every value below is READ OFF fal's live OpenAPI, fetched 2026-08-27, and
+    // re-read 2026-09-29 for the Max 1080p tier and the Turbo row:
     //   minimax/h3/{text-to-video,image-to-video,reference-to-video}
     //   minimax/h3-max/{text-to-video,image-to-video,reference-to-video}
+    //   minimax/h3-max-turbo/{text-to-video,image-to-video} (reference-to-video 404s)
     // 🚨 CORRECTED 2026-09-09: `minimax/h3-max/reference-to-video` DOES exist —
     // 9 images, 3 videos, 3 audio. The earlier note here said it 404s; the schema
     // had never been read. Both rows now declare the full omni-reference set, and
     // every cap on the Max row was re-read on the Max endpoint rather than copied
     // down from the base row.
     //
-    // 🚨 NEVER PREFIX-MATCH THESE TWO IDS. `minimax-h3-max` starts with
-    // `minimax-h3`, so any `startsWith('minimax-h3')` swallows the Max row into
-    // the base row's branch — a different ladder AND a different price at the one
-    // tier they share. Every lookup downstream is an exact-id map, not a prefix.
+    // 🚨 NEVER PREFIX-MATCH THESE THREE IDS. `minimax-h3-max-turbo` starts with
+    // `minimax-h3-max`, which starts with `minimax-h3`, so any `startsWith`
+    // swallows a row into its neighbour's branch — a different ladder AND a
+    // different price at the tiers they share. Every lookup downstream is an
+    // exact-id map, not a prefix.
     'minimax-h3': {
         // fal reference-to-video schema, 2026-09-09: each audio clip is 2-15s.
         referenceAudioDuration: { min: 2, max: 15 },
@@ -501,7 +518,7 @@ export const MODEL_CAPABILITIES = {
         // trained to output and the one every benchmark quotes; 2K is a 2.2x price
         // step and 4K a 2.7x step, and reaching a tier is a different decision from
         // defaulting to it (same reasoning that keeps Seedance 2.5 on 720p).
-        videoResolution: { options: ['480p', '768p', '2k', '4k'], default: '768p' },
+        videoResolution: { options: ['480p', '768p', '2k', '4k'], default: '768p', upscaledFrom: { '2k': '768p', '4k': '768p' } },
         // 5, not 4. MiniMax's own model card says 4-15s; fal's schema — which is
         // what our request actually hits — says `minimum: 5`. The endpoint wins.
         duration: { min: 5, max: 15, mode: 'continuous' },
@@ -548,8 +565,28 @@ export const MODEL_CAPABILITIES = {
         // arms — quoted off this endpoint, not inherited.
         maxReferenceVideoSeconds: 15,
         maxReferenceAudioSeconds: 15,
-        videoResolution: { options: ['480p', '768p'], default: '768p' },
+        // 1080P is on all three h3-max endpoints' enum (fal schema, 2026-09-09 and
+        // 2026-09-29), described as "1080P latent refinement from a native 768P
+        // source": a refinement, not a native generation and not base H3's
+        // 2K/4K upscaler. It was keyed 2026-09-09 and pulled 2026-09-10 because the
+        // 1080p video-reference token rate was unpublished; fal now states it
+        // (see MINIMAX_MAX_REFERENCE). Default stays 768p, the native tier.
+        videoResolution: { options: ['480p', '768p', '1080p'], default: '768p' },
+        duration: { min: 5, max: 15, mode: 'continuous' },
+    },
+    'minimax-h3-max-turbo': {
+        aspectRatios: MINIMAX_H3_ASPECT_RATIOS,
+        // fal schema for both Turbo endpoints, 2026-09-29: enum
+        // ["480P","768P","1080P"], default "768P", the same 1080P "latent
+        // refinement from a native 768P source" as the Max row.
+        videoResolution: { options: ['480p', '768p', '1080p'], default: '768p' },
+        // duration: integer, minimum 5, maximum 15, default 5 (both endpoints).
         duration: { min: 5, max: 15, mode: 'continuous' },
+        // NO reference capacity: `minimax/h3-max-turbo/reference-to-video` returns
+        // 404 from fal's OpenAPI endpoint (2026-09-29), and neither published
+        // endpoint carries a reference array. Start and end frames ride
+        // image-to-video and live in MODEL_REGISTRY.features.lastFrame.
+        maxIngredientImages: 0,
     },
     // ── LTX-2.5 (both seats on fal — added 2026-08-29) ─────────────────────────
     //
@@ -706,6 +743,12 @@ export function aspectRatiosFor(model, provider) {
     return cap.aspectRatios;
 }
 /** Video resolutions a model accepts. A FIXED model reports exactly its one value. */
+/** The native render an upscaled tier is made from, or undefined for a native tier. */
+export function upscaledFrom(model, resolution) {
+    if (!resolution)
+        return undefined;
+    return MODEL_CAPABILITIES[model]?.videoResolution?.upscaledFrom?.[resolution];
+}
 export function videoResolutionsFor(model) {
     const vr = MODEL_CAPABILITIES[model]?.videoResolution;
     if (!vr)
@@ -928,14 +971,16 @@ export function describeReferenceImageCaps(models) {
 }
 /** H3 Max reference accounting, fal's worked tables read 2026-09-09.
  * https://fal.ai/models/minimax/h3-max/reference-to-video
- * 1080p video-reference pricing is unpublished; never infer it from output rates.
+ * 1080p: fal's page, read 2026-09-29: "768p and 1080p output use the same
+ * reference-video token counts." So 1080p takes the 768p figure; it was absent
+ * until fal published that sentence, and must never be inferred from output rates.
  */
 export const MINIMAX_MAX_REFERENCE = {
     freeTokens: 4096,
     imagePixelsPerToken: 1024,
     normalizedImageEdge: 1024,
     audioTokensPerSecond: 80,
-    videoTokensPerSecond: { '480p': 2886, '768p': 7459.2 },
+    videoTokensPerSecond: { '480p': 2886, '768p': 7459.2, '1080p': 7459.2 },
 };
 export function minimaxMaxReferenceTokens(input) {
     const rate = MINIMAX_MAX_REFERENCE.videoTokensPerSecond[input.resolution];
@@ -950,4 +995,12 @@ export function minimaxMaxReferenceTokens(input) {
         input.videoSeconds * (rate ?? 0) + input.audioSeconds * MINIMAX_MAX_REFERENCE.audioTokensPerSecond -
         MINIMAX_MAX_REFERENCE.freeTokens));
 }
+/** Quotes and generation use the same model default. */
+export function defaultImageResolutionFor(model) {
+    const c = MODEL_CAPABILITIES[model];
+    if (!c?.defaultImageResolution || !c.imageResolutions?.includes(c.defaultImageResolution)) {
+        throw new Error(`Missing or invalid image default for ${model}`);
+    }
+    return c.defaultImageResolution;
+}
 //# sourceMappingURL=model-capabilities.js.map

package/dist/prompts/model-facts.d.ts

@@ -1,3 +1,14 @@
+/** Connected host, not an API model: capabilities are checked at runtime. */
+export declare const CHATGPT_IMAGE_HOST: {
+    readonly id: "chatgpt-account";
+    readonly label: "ChatGPT";
+    readonly note: "Generate with your connected ChatGPT account";
+    readonly usage: "Uses your ChatGPT account limits";
+};
+import { type BuiltInTool } from './generation-policy.js';
+/** Authoring presets only: these do not claim hosted ChatGPT API capabilities. */
+export declare const CHATGPT_FRAMING_RATIOS: import("./model-capabilities.js").AspectRatio[];
+export declare function composeChatGptFraming(prompt: string, aspectRatio?: string): string;
 export interface ModelFact {
     id: string;
     label: string;
@@ -32,8 +43,14 @@ export interface ModelFact {
      * best in the world". 2.0 is the specialist for native 4K and for the same
      * resolution cheaper; Kling is the specialist for cost-effective start-frame,
      * performance and lip-sync work and the only engine behind Motion Transfer and
-     * Lip Sync. Recorded in the vault's prompting-ssot.md the same day. Changing the
-     * default again lands there first, then here, then in slates-model-selection.md. slates-web reads this to order its model lineup
+     * Lip Sync. Recorded in the vault's prompting-ssot.md the same day.
+     *
+     * IMAGE (Eric, 2026-09-15): GPT IMAGE 2.5 SUNBURST IS THE DEFAULT IMAGE MODEL, at
+     * `high` and 3k, in agent routing as it has been in the app picker since
+     * 2026-09-09. Nano Banana 2 keeps the only headless path, so an image call
+     * with no project still runs there. Changing the
+     * default lives in this tier field; quality/resolution live in model-capabilities.ts.
+     * Consumers and generated skill partials derive them. slates-web reads this to order its model lineup
      * and to fail its build when a niche seat is named more often than the default.
      */
     tier: 'default' | 'specialist' | 'niche';
@@ -94,6 +111,21 @@ export declare function seedanceTaskIntentWords(prompt: string): string[];
 /** Every model that reads reference video and/or audio, for op descriptions. */
 export declare function multimodalRefModels(): string[];
 export declare const MODEL_FACTS: ModelFact[];
+/**
+ * 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 declare function defaultModelFor(kind: ModelFact['kind']): string;
+/**
+ * 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 declare function toolModelFor(tool: BuiltInTool): string;
 /**
  * Routing prose for one lane, generated from the SSOT.
  *

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.
  *
@@ -120,7 +139,7 @@ export const MODEL_FACTS = [
     {
         id: 'nano-banana-2',
         route: 'generate',
-        tier: 'default',
+        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.
@@ -128,7 +147,7 @@ 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',
@@ -160,11 +179,11 @@ export const MODEL_FACTS = [
     {
         id: 'gpt-image-2-5-sunburst',
         route: 'generate',
-        tier: 'specialist',
+        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',
@@ -293,7 +312,19 @@ export const MODEL_FACTS = [
         // 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 gives up the upper resolution tiers. 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.',
+        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',
@@ -362,7 +393,37 @@ for (const kind of ['image', 'video', 'audio']) {
         }
     }
 }
+/**
+ * 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.
  *