@slatesvideo/shared 0.5.9 → 0.6.0

package/dist/prompts/index.d.ts

@@ -2,6 +2,7 @@ export * from './reference-rules.js';
 export * from './reference-composer.js';
 export * from './content-policy.js';
 export * from './style-library.js';
+export * from './model-capabilities.js';
 export * from './model-facts.js';
 export * from './character-sheet.js';
 export * from './environment-sheet.js';

package/dist/prompts/index.js

@@ -13,6 +13,10 @@ export * from './reference-rules.js';
 export * from './reference-composer.js';
 export * from './content-policy.js';
 export * from './style-library.js';
+// Model CAPABILITY SSOT (aspect ratios, video resolutions, durations, reference
+// caps). The desktop's MODEL_REGISTRY spreads these into every entry and the op
+// surface validates + generates its descriptions from them — never hand-typed.
+export * from './model-capabilities.js';
 export * from './model-facts.js';
 export * from './character-sheet.js';
 export * from './environment-sheet.js';

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

@@ -0,0 +1,124 @@
+/** Every aspect ratio any Slates model accepts. There is no `9:21`. */
+export type AspectRatio = '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9';
+/**
+ * 🚨 `768p` and `2k` entered this vocabulary with MiniMax H3 (2026-08-27) and
+ * are NOT aliases of anything already here. 768p is H3's native generation tier
+ * and prices between 480p and 2K ($0.060/s vs 720p Seedance's $0.15/s — a
+ * different tier of a different model, not a rename); 2K is H3's upscaled tier.
+ * Aliasing either onto 720p/1080p would build a cost key that does not exist.
+ */
+export type VideoResolution = '480p' | '720p' | '768p' | '1080p' | '2k' | '4k';
+/**
+ * The full ten, in display order. `9:21` was in the MCP op's enum and in NO
+ * model — it was invented downstream. Do not add a ratio here that no model
+ * declares; the op's enum is generated from the union of what models accept, so
+ * a phantom entry here becomes a phantom entry an agent can pass.
+ */
+export declare const ALL_ASPECT_RATIOS: AspectRatio[];
+/** Duration constraints for a video model. */
+export interface DurationCapability {
+    min: number;
+    max: number;
+    /** 'continuous' = every whole second from min to max; 'discrete' = `values` only. */
+    mode: 'continuous' | 'discrete';
+    /** For discrete mode: the exact allowed durations. */
+    values?: number[];
+    /** Resolution-dependent narrowing (Veo forces 8s at 1080p AND 4k). */
+    resolutionOverrides?: Record<string, Pick<DurationCapability, 'min' | 'max' | 'mode' | 'values'>>;
+    /** Prompt-mode narrowing (Veo's reference-to-video endpoint is 8s only). */
+    modeOverrides?: Record<string, Pick<DurationCapability, 'min' | 'max' | 'mode' | 'values'>>;
+}
+/** Video resolution constraints. */
+export interface VideoResolutionCapability {
+    options: VideoResolution[];
+    /** Set when the resolution is not selectable at all (Omni Flash is 720p, full stop). */
+    fixed?: VideoResolution;
+    /** Default when this model is chosen (falls back to `options[0]`). */
+    default?: VideoResolution;
+}
+/** Everything a model will ACCEPT. Capability only — never a price. */
+export interface ModelCapability {
+    aspectRatios: AspectRatio[];
+    /** Provider-keyed overrides. `fal` is the one that matters — see AGENT_ROUTE_PROVIDER. */
+    providerAspectRatios?: Record<string, AspectRatio[]>;
+    videoResolution?: VideoResolutionCapability;
+    duration?: DurationCapability;
+    /** Max reference images in create-image mode (image models). */
+    maxRefImages?: number;
+    /** Max ingredient / free reference images (video models). */
+    maxIngredientImages?: number;
+    /** Reference VIDEOS accepted. Absent/0 = none. */
+    maxReferenceVideos?: number;
+    /** Reference AUDIO clips accepted. Absent/0 = none. */
+    maxReferenceAudio?: number;
+    /** Ceiling on TOTAL reference files across ALL modalities. */
+    maxReferenceFilesTotal?: number;
+    /** Combined seconds across every reference video. */
+    maxReferenceVideoSeconds?: number;
+    /** Combined seconds across every reference audio clip. */
+    maxReferenceAudioSeconds?: number;
+}
+/**
+ * The provider every AGENT generation actually lands on for Kling and Veo.
+ *
+ * 🚨 THIS IS WHY `providerAspectRatios` MATTERS TO THE OP. MCP/CLI/Studio-Agent
+ * generations are credits-only (BYOK is retired on the agent surface), and the
+ * credits route carries Kling and Veo on fal: `slate/src/main/agent/routes.ts`
+ * never sends `klingProvider`, so `handlers/video.ts` defaults it to `'fal'`,
+ * and `generateVeoVideo`'s proxy arm builds a fal request
+ * (`buildFalVeoRequest`). So an agent gets Kling's THREE fal ratios and Veo's
+ * TWO — not the eight and ten those models take on their direct APIs. Validating
+ * against the direct sets would accept a ratio fal rejects, which is the exact
+ * failure this module exists to delete.
+ */
+export declare const AGENT_ROUTE_PROVIDER = "fal";
+export declare const MODEL_CAPABILITIES: Record<string, ModelCapability>;
+export declare function getModelCapability(model: string): ModelCapability | undefined;
+/** 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. */
+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`. */
+export declare function defaultVideoResolutionFor(model: string): VideoResolution | undefined;
+/**
+ * Duration constraints after applying overrides.
+ *
+ * ⚠️ ORDER IS LOAD-BEARING and mirrors `getAvailableDurations` in
+ * slate/src/shared/pricing.ts EXACTLY: mode override first (more specific),
+ * resolution override only if no mode override applied. Reversing them would
+ * make the desktop and the agent disagree about the same generation.
+ */
+export declare function durationsFor(model: string, opts?: {
+    videoResolution?: string;
+    promptMode?: string;
+}): DurationCapability | undefined;
+/** Every legal whole-second duration. Mirrors `getAvailableDurations`. */
+export declare function durationValuesFor(model: string, opts?: {
+    videoResolution?: string;
+    promptMode?: string;
+}): number[];
+/** Union of every ratio the given models accept — the legal universe for an enum. */
+export declare function aspectRatioUnion(models: readonly string[], provider?: string): AspectRatio[];
+/** Union of every resolution the given models accept. */
+export declare function videoResolutionUnion(models: readonly string[]): VideoResolution[];
+/** Widest legal duration window across the given models, overrides included. */
+export declare function durationBounds(models: readonly string[]): {
+    min: number;
+    max: number;
+};
+export declare function checkAspectRatio(model: string, aspectRatio: string | undefined, provider?: string): string | null;
+export declare function checkVideoResolution(model: string, videoResolution: string | undefined): string | null;
+export declare function checkDuration(model: string, duration: number | undefined, opts?: {
+    videoResolution?: string;
+    promptMode?: string;
+}): string | null;
+/** e.g. "kling-v3.0-std/kling-v3.0-pro: 16:9, 9:16, 1:1 · seedance-2: 21:9, …" */
+export declare function describeAspectRatios(models: readonly string[], provider?: string): string;
+/** e.g. "seedance-2: 480p, 720p, 1080p, 4k (default 1080p) · omni-flash: 720p only (fixed)" */
+export declare function describeVideoResolutions(models: readonly string[]): string;
+/** e.g. "kling-v3.0-std: 3-15s · veo-3.1-fast: 4s/6s/8s (1080p/4k: 8s only; with reference images: 8s only)" */
+export declare function describeDurations(models: readonly string[]): string;
+/** e.g. "seedance-2: 9 · seedance-2.5: 30 · omni-flash: 7 · seedance-2.5-edit: 0 (prompt + source clip only)" */
+export declare function describeReferenceImageCaps(models: readonly string[]): string;
+//# sourceMappingURL=model-capabilities.d.ts.map