@slatesvideo/shared 0.6.11 → 0.7.1

package/dist/prompts/banned-tokens.js

@@ -1,219 +1,44 @@
-// ============================================================
-// BANNED PROMPT TOKENS — the "load the guide" rule, made structural.
-//
-// THE PROBLEM: "before prompting any model, load the matching guide" is a
-// sentence in a system prompt with nothing checking it. Measured 2026-08-30 in
-// a real Studio Agent session: slates_get_prompting_guide was called ZERO
-// times, and the prompt that shipped tripped the skill's own never-use list
-// twice (`photorealistic`, `cinematic`). A rule with no check is a suggestion,
-// and an LLM is the least reliable enforcer you could pick.
-//
-// THE FIX, in two halves, neither of which the model can skip:
-//   (a) the never-use list is INLINED into the generate ops' descriptions.
-//       Op descriptions are always in context on BOTH surfaces — there is no
-//       call to omit and no discretion to exercise.
-//   (b) the submitted prompt is MATCHED against the list and a warning comes
-//       back in the op result. Non-blocking: the generation proceeds
-//       (PRODUCT_PHILOSOPHY.md → make state visible, never block).
-//
-// 🚨 THE LIST IS NEVER HAND-TYPED HERE. It is extracted from the skill files
-// themselves, between `<!-- @banned:start -->` / `<!-- @banned:end -->`
-// markers. That is this workspace's LLM-docs doctrine — never hand-type a fact
-// an LLM will read — and it is the only way the op description and the skill
-// cannot drift apart. Change the skill; the description follows on the next
-// build. scripts/agent-surface-lockstep-check.mjs fails the build if a token
-// in a description no longer appears in its source skill.
-//
-// Deterministic by construction (document order, no sorting, no dedupe
-// reshuffle) because these strings land in the desktop's prompt-cached tool
-// prefix, whose byte-stability IS the cache mechanism.
-// ============================================================
-import { SKILLS } from '../skills/content.js';
-/**
- * Where each scope's CROSS-MODEL list lives.
- *
- * One skill per scope on purpose: these are the two lists that are GENERIC to
- * their modality (Stable-Diffusion-era tag soup for images, quality
- * incantations for video), not model-specific quirks. A per-model list cannot
- * ride the op DESCRIPTION — a description is one static string for every call,
- * so it cannot change with the `model` argument. That is what
- * `bannedTokensForSkill` below is for: the per-model list rides the estimate
- * RESULT, where the model has just been named.
- */
-const BANNED_TOKEN_SOURCES = [
-    { skill: 'slates-prompting-nano-banana-2', scope: 'image' },
-    { skill: 'slates-prompting-seedance', scope: 'video' },
-];
-/**
- * 🚨 THE ENFORCEMENT THAT WORKED COVERED TWO SKILLS OF FIFTEEN.
- *
- * `describeBannedTokens('image')` was Nano Banana's list and `('video')` was
- * Seedance's, so a Veo, Kling, LTX, MiniMax, FLUX, Seedream, GPT-Image or audio
- * generation was matched against another model's never-use list and its own was
- * enforced by nothing — while four skills (content-policy, lip-sync,
- * minimax-h3, motion-transfer) carried never-use prose with no markers at all,
- * which is a rule an LLM has to notice.
- *
- * Every skill that carries an `@banned` block now contributes to a per-skill
- * list, delivered on the estimate result beside the craft card. The two above
- * stay ALSO on the op descriptions, because a modality-wide list is true of
- * every call that op can make.
- */
-function extractPerSkill() {
-    const out = new Map();
-    for (const [skill, content] of Object.entries(SKILLS)) {
-        // Cheap pre-test: only pay the regex for files that carry the marker.
-        if (!content.includes('@banned:start'))
-            continue;
-        const scope = inferScope(skill);
-        out.set(skill, extractFromSkill(skill).map((token) => ({ token, skill, scope })));
-    }
-    return out;
-}
-/** Image-lane skills prompt for pixels; everything else is a time-based lane.
- *  Only used to tag a token for the warning text — the per-skill list is
- *  matched by SKILL, never by scope, so a wrong guess here cannot mis-enforce. */
-function inferScope(skill) {
-    return /nano-banana|gpt-image|flux|seedream/.test(skill) ? 'image' : 'video';
-}
-const FENCE_RE = /<!--\s*@banned:start\s*-->([\s\S]*?)<!--\s*@banned:end\s*-->/g;
-const HTML_COMMENT_RE = /<!--[\s\S]*?-->/g;
-const BACKTICKED_RE = /`([^`\n]+)`/g;
-/**
- * Pull every backticked phrase out of a skill's fenced block(s).
- *
- * HTML comments are stripped FIRST: the fence carries a "MACHINE-READ" note to
- * whoever edits the skill next, and that note itself contains backticks.
+/** Model-specific prompt advice, extracted from each skill's @banned blocks.
+ * Warnings never rewrite or block a prompt. No model's list is universal.
  */
-function extractFromSkill(skill) {
-    const content = SKILLS[skill];
-    if (content === undefined) {
-        throw new Error(`[banned-tokens] no such skill: ${skill}. BANNED_TOKEN_SOURCES must name files in packages/shared/skills/.`);
-    }
-    const out = [];
-    let fence;
-    FENCE_RE.lastIndex = 0;
-    let fences = 0;
-    while ((fence = FENCE_RE.exec(content)) !== null) {
-        fences += 1;
-        const body = fence[1].replace(HTML_COMMENT_RE, '');
-        let m;
-        BACKTICKED_RE.lastIndex = 0;
-        while ((m = BACKTICKED_RE.exec(body)) !== null) {
-            const token = m[1].trim();
-            if (token && !out.includes(token))
-                out.push(token);
-        }
-    }
-    if (fences === 0) {
-        throw new Error(`[banned-tokens] ${skill}.md has no <!-- @banned:start --> / <!-- @banned:end --> block. ` +
-            `The op description and the prompt warnings are GENERATED from it — restore the markers, ` +
-            `or drop the skill from BANNED_TOKEN_SOURCES.`);
-    }
-    if (out.length === 0) {
-        throw new Error(`[banned-tokens] ${skill}.md has a @banned block with no backticked tokens in it. ` +
-            `An empty list would silently disable the check instead of failing it.`);
-    }
-    return out;
-}
-/** Every banned token, in skill-document order. Integrity asserted at load. */
-export const BANNED_PROMPT_TOKENS = BANNED_TOKEN_SOURCES.flatMap(({ skill, scope }) => extractFromSkill(skill).map((token) => ({ token, skill, scope })));
-const byScope = new Map();
-for (const entry of BANNED_PROMPT_TOKENS) {
-    const list = byScope.get(entry.scope) ?? [];
-    list.push(entry);
-    byScope.set(entry.scope, list);
-}
-export function bannedTokensFor(scope) {
-    return byScope.get(scope) ?? [];
-}
-/** Regex cache — one word-boundary matcher per token, built once. */
+import { SKILLS } from '../skills/content.js';
+const bySkill = new Map();
+for (const [skill, content] of Object.entries(SKILLS)) {
+    const fences = [...content.matchAll(/<!--\s*@banned:start\s*-->([\s\S]*?)<!--\s*@banned:end\s*-->/g)];
+    if (!fences.length)
+        continue;
+    const tokens = [...new Set(fences.flatMap((f) => [...f[1].replace(/<!--[\s\S]*?-->/g, '').matchAll(/`([^`\n]+)`/g)].map((m) => m[1].trim())))];
+    if (!tokens.length)
+        throw new Error(`${skill}: @banned block contains no tokens`);
+    const scope = /nano-banana|gpt-image|flux|seedream/.test(skill) ? 'image' : 'video';
+    bySkill.set(skill, tokens.map((token) => ({ token, skill, scope })));
+}
+/** Compatibility exports: there is no cross-model blacklist. */
+export const BANNED_PROMPT_TOKENS = Object.freeze([]);
+export function bannedTokensFor(_scope) { return BANNED_PROMPT_TOKENS; }
+export function describeBannedTokens(_scope) { return ''; }
+export function bannedTokensForSkill(skill) { return bySkill.get(skill) ?? []; }
 const matchers = new Map();
 function matcherFor(token) {
-    let re = matchers.get(token);
-    if (!re) {
+    let matcher = matchers.get(token);
+    if (!matcher) {
         const escaped = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        // \b at both ends so `4k` does not fire inside "84king" and `flawless`
-        // does not fire inside "flawlessly". Every token starts and ends with a
-        // word character today; if one ever starts with punctuation, \b would
-        // anchor wrong — the load-time check below is what would catch it.
-        re = new RegExp(`\\b${escaped}\\b`, 'i');
-        matchers.set(token, re);
-    }
-    return re;
-}
-for (const { token, skill } of BANNED_PROMPT_TOKENS) {
-    if (!/^\w/.test(token) || !/\w$/.test(token)) {
-        throw new Error(`[banned-tokens] ${skill}: token ${JSON.stringify(token)} does not start and end with a word ` +
-            `character, so the \\b word-boundary match would never fire. Rewrite the entry or teach ` +
-            `matcherFor() the new shape.`);
+        matcher = new RegExp(`(?<!\\w)${escaped}(?!\\w)`, 'i');
+        matchers.set(token, matcher);
     }
+    return matcher;
 }
-/** Every per-skill list, keyed by skill name. */
-const bySkill = extractPerSkill();
-/** The never-use list a single skill declares. Empty for a skill with no block. */
-export function bannedTokensForSkill(skill) {
-    return bySkill.get(skill) ?? [];
+export function findBannedTokens(prompt, _scope, skill) {
+    return skill ? bannedTokensForSkill(skill).filter((b) => matcherFor(b.token).test(prompt)) : [];
 }
-/**
- * A single model's never-use list, for the estimate RESULT.
- *
- * Deliberately NOT the cross-model list — that one already rides the op
- * description on every call. This is the half that could not: the quirk that is
- * true of Veo and false of Kling.
- */
 export function describeBannedTokensForSkill(skill) {
     const list = bannedTokensForSkill(skill);
-    if (list.length === 0)
-        return '';
-    return (`NEVER put these in a ${skill.replace('slates-prompting-', '')} prompt: ` +
-        list.map((b) => `"${b.token}"`).join(', ') +
-        `. Describe specifically instead (${skill}).`);
+    return list.length ? `Avoid these phrases for ${skill}: ${list.map((b) => `"${b.token}"`).join(', ')}. Describe the intended result specifically.` : '';
 }
-/** The tokens a submitted prompt actually contains. `skill` adds that model's
- *  own list to the modality-wide one — the two overlap for nano-banana-2 and
- *  seedance, so hits are deduplicated by token. */
-export function findBannedTokens(prompt, scope, skill) {
-    const candidates = [...bannedTokensFor(scope), ...(skill ? bannedTokensForSkill(skill) : [])];
-    const seen = new Set();
-    const hits = [];
-    for (const b of candidates) {
-        if (seen.has(b.token))
-            continue;
-        seen.add(b.token);
-        if (matcherFor(b.token).test(prompt))
-            hits.push(b);
-    }
-    return hits;
-}
-/**
- * The list as it appears INSIDE an op description — always in context, on both
- * surfaces, with no call required to see it. Generated, never hand-typed.
- */
-export function describeBannedTokens(scope) {
-    const list = bannedTokensFor(scope);
-    if (list.length === 0)
-        return '';
-    const skills = [...new Set(list.map((b) => b.skill))].join(' / ');
-    return (`NEVER put these in a prompt (they measurably degrade output — full rationale in ${skills}): ` +
-        list.map((b) => `"${b.token}"`).join(', ') +
-        `. Describe specifically instead.`);
-}
-/**
- * Non-blocking warning for a submitted prompt. Empty string when clean.
- *
- * Returned in the op RESULT — the one place the agent cannot avoid reading —
- * rather than raised as an error. The generation proceeds either way: the
- * sandbox doctrine says make state visible, never block.
- */
 export function bannedTokenWarning(prompt, scope, skill) {
     const hits = findBannedTokens(prompt, scope, skill);
-    if (hits.length === 0)
+    if (!hits.length)
         return '';
-    const skills = [...new Set(hits.map((b) => b.skill))].join(', ');
-    return (`⚠️ PROMPT WARNING: your prompt contains ${hits.map((b) => `"${b.token}"`).join(', ')} — ` +
-        `on the never-use list in ${skills}. Not blocked, and this generation ran as submitted. ` +
-        `Load that guide with slates_get_prompting_guide and rewrite with specific description ` +
-        `(named lens, light direction, stock, composition) before the next generation.`);
+    return `⚠️ PROMPT WARNING: ${hits.map((b) => `"${b.token}"`).join(', ')} appear in ${skill}'s avoid list. This warning does not change or block your prompt. Describe the intended result specifically; query that guide for details.`;
 }
 //# sourceMappingURL=banned-tokens.js.map

package/dist/prompts/craft-cards.js

@@ -57,7 +57,7 @@ function extractCard(skill, content) {
     if (body.length > CRAFT_CARD_CEILING) {
         throw new Error(`[craft-cards] ${skill}.md's @card block is ${body.length} chars, over the ` +
             `${CRAFT_CARD_CEILING} ceiling. A card rides EVERY estimate result for that model — ` +
-            `move the overflow into the body of the skill, which slates_get_prompting_guide returns whole.`);
+            `move the overflow into the body of the skill, retrieved with slates_get_prompting_guide depth: full.`);
     }
     return body;
 }
@@ -77,6 +77,6 @@ export function describeCraftCard(skill) {
     const card = craftCard(skill);
     if (!card)
         return '';
-    return `${card}\n\nFull guide (examples, failure modes, sources): slates_get_prompting_guide("${skill}").`;
+    return `${card}\n\nFull guide (examples, failure modes, sources): slates_get_prompting_guide({topic: "${skill}", depth: "full"}); use query for one section.`;
 }
 //# sourceMappingURL=craft-cards.js.map

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 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+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