@slatesvideo/shared 0.5.9 → 0.6.0

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export { SKILLS } from './skills/content.js';
 export * as operations from './operations/index.js';
 export { ALL_OPERATIONS, VIDEO_MODELS, AUDIO_MODELS, defaultContext, type Operation, type OperationContext, type OperationResult } from './operations/index.js';
 export { MODEL_FACTS, getModelFact, multimodalRefSummary, multimodalRefModels, SEEDANCE_TASK_INTENT_WORDS, seedanceTaskIntentWords, type ModelFact, } from './prompts/model-facts.js';
+export { MODEL_CAPABILITIES, ALL_ASPECT_RATIOS, AGENT_ROUTE_PROVIDER, getModelCapability, aspectRatiosFor, videoResolutionsFor, defaultVideoResolutionFor, durationsFor, durationValuesFor, aspectRatioUnion, videoResolutionUnion, durationBounds, checkAspectRatio, checkVideoResolution, checkDuration, describeAspectRatios, describeVideoResolutions, describeDurations, describeReferenceImageCaps, type AspectRatio, type VideoResolution, type ModelCapability, type DurationCapability, type VideoResolutionCapability, } from './prompts/model-capabilities.js';
 export { PROMPTING_TIPS, getPromptingTips, type PromptingTipsEntry, type PromptingTipCard, type PromptingTipsKey } from './prompts/prompting-tips.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -11,6 +11,12 @@ export { MODEL_FACTS, getModelFact, multimodalRefSummary, multimodalRefModels,
 // Mirrored in slate/src/shared/pricing.ts — see the constant's own header for
 // why the mirror exists and why it must never drive a prompt rewrite.
 SEEDANCE_TASK_INTENT_WORDS, seedanceTaskIntentWords, } from './prompts/model-facts.js';
+// Model CAPABILITY SSOT — what each model will ACCEPT (aspect ratios incl.
+// per-provider overrides, video resolutions, duration windows, reference caps).
+// `slate/src/shared/pricing.ts` spreads these into every MODEL_REGISTRY entry;
+// the op surface validates against them and GENERATES its `.describe()` prose
+// from them. Never hand-type a capability fact an LLM will read.
+export { MODEL_CAPABILITIES, ALL_ASPECT_RATIOS, AGENT_ROUTE_PROVIDER, getModelCapability, aspectRatiosFor, videoResolutionsFor, defaultVideoResolutionFor, durationsFor, durationValuesFor, aspectRatioUnion, videoResolutionUnion, durationBounds, checkAspectRatio, checkVideoResolution, checkDuration, describeAspectRatios, describeVideoResolutions, describeDurations, describeReferenceImageCaps, } from './prompts/model-capabilities.js';
 // Per-model prompting tips — the SSOT for the desktop "See prompting tips"
 // modals. The desktop renders these; it never hand-writes tips content.
 export { PROMPTING_TIPS, getPromptingTips } from './prompts/prompting-tips.js';

package/dist/operations/index.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { SlatesCloudClient } from '../clients/cloud.js';
 import { SlatesDesktopClient } from '../clients/desktop.js';
+import { type AspectRatio, type VideoResolution } from '../prompts/model-capabilities.js';
 export interface OperationContext {
     cloud: () => SlatesCloudClient;
     desktop: () => SlatesDesktopClient;
@@ -28,16 +29,25 @@ export declare const getCreditBalance: Operation<Record<string, never>>;
 export declare const listAvailableModels: Operation<{
     filter?: string;
 }>;
+export declare const VIDEO_MODELS: readonly ["kling-v3.0-std", "kling-v3.0-pro", "kling-v3.0-omni", "veo-3.1-fast", "veo-3.1-standard", "seedance-2", "seedance-2.5", "omni-flash", "minimax-h3", "minimax-h3-max"];
+type VideoModel = (typeof VIDEO_MODELS)[number];
+/** The exact `model` ids `slates_edit_video` accepts. Edit rows are deliberately
+ *  NOT in VIDEO_MODELS — they take a source clip, not frames. */
+export declare const EDIT_VIDEO_MODELS: readonly ["kling-v3.0-omni-edit", "kling-v3.0-omni-pro-edit", "omni-flash-edit", "seedance-2.5-edit"];
+type EditVideoModel = (typeof EDIT_VIDEO_MODELS)[number];
 export declare const estimateGenerationCost: Operation<{
     model: string;
     quantity?: number;
     duration?: number;
-    videoResolution?: '480p' | '720p' | '1080p' | '4k';
+    /** The FULL union — the runtime Zod enum is generated from MODEL_CAPABILITIES
+     *  and `assertVideoCapabilities` is the per-model narrowing authority. */
+    videoResolution?: VideoResolution;
     resolution?: '1k' | '2k' | '3k' | '4k';
     quality?: 'medium' | 'high';
     sound?: boolean;
     seedanceFace?: boolean;
     seedanceRealFace?: boolean;
+    referenceImages?: number;
 }>;
 export declare const listProjects: Operation<Record<string, never>>;
 export declare const createProject: Operation<{
@@ -156,12 +166,14 @@ export declare const addFrame: Operation<{
     position?: number;
 }>;
 export type ImageModelId = 'nano-banana-2' | 'nano-banana-2-lite' | 'nano-banana-pro' | 'gpt-image-2' | 'flux-2-max' | 'seedream-5-lite';
+/** The exact `model` ids `slates_generate_image` accepts. */
+export declare const IMAGE_MODELS: readonly ["nano-banana-2", "nano-banana-2-lite", "nano-banana-pro", "gpt-image-2", "flux-2-max", "seedream-5-lite"];
 export declare const generateImage: Operation<{
     prompt: string;
     model?: ImageModelId;
     projectId?: string;
     resolution?: '1k' | '2k' | '3k' | '4k';
-    aspectRatio?: '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '21:9' | '9:21' | '4:5' | '5:4' | '2:3' | '3:2';
+    aspectRatio?: AspectRatio;
     quality?: 'medium' | 'high';
     count?: number;
     referenceImageUrls?: string[];
@@ -181,12 +193,12 @@ export declare const editImage: Operation<{
     confirm?: boolean;
     background?: boolean;
 }>;
-export declare const VIDEO_MODELS: readonly ["kling-v3.0-std", "kling-v3.0-pro", "kling-v3.0-omni", "veo-3.1-fast", "veo-3.1-standard", "seedance-2", "seedance-2.5", "omni-flash"];
-type VideoModel = (typeof VIDEO_MODELS)[number];
 export declare function videoCostKey(input: {
     model: VideoModel;
     duration: number;
-    videoResolution?: '480p' | '720p' | '1080p' | '4k';
+    /** Widened to the full union because the Zod enum is GENERATED from
+     *  MODEL_CAPABILITIES; the runtime schema is the narrowing authority. */
+    videoResolution?: VideoResolution;
     sound?: boolean;
     seedanceFace?: boolean;
     seedanceRealFace?: boolean;
@@ -194,15 +206,24 @@ export declare function videoCostKey(input: {
      *  transfer / lip-sync on video / relocate). >0 bills the vref key on TOTAL
      *  (input+output) seconds — the server re-derives this by probing the refs. */
     videoRefSeconds?: number;
+    /** MiniMax H3 base only: how many reference IMAGES the request carries. Past
+     *  the fifth, fal charges per image, so it is a KEY DIMENSION — omit it on a
+     *  reference-heavy call and the quote under-reports what the proxy bills
+     *  (which it re-derives from the request itself). */
+    referenceImages?: number;
 }): string;
 export declare function klingEditCostKey(model: 'kling-v3.0-omni-edit' | 'kling-v3.0-omni-pro-edit', duration: number): string;
 export declare function omniFlashEditCostKey(duration: number): string;
-/** Seedance 2.5 source-clip bounds for the edit task type. */
-export declare const SEEDANCE_25_EDIT_MIN_SECONDS = 4;
-export declare const SEEDANCE_25_EDIT_MAX_SECONDS = 30;
+/** Seedance 2.5 source-clip bounds for the edit task type — READ from the
+ *  capability SSOT, not typed. Kept as named exports because published builds
+ *  import them. */
+export declare const SEEDANCE_25_EDIT_MIN_SECONDS: number;
+export declare const SEEDANCE_25_EDIT_MAX_SECONDS: number;
 export declare function seedanceEditCostKey(input: {
     duration: number;
-    videoResolution?: '480p' | '720p';
+    /** Widened to the full union because the Zod enum is GENERATED from
+     *  MODEL_CAPABILITIES; the runtime schema is the narrowing authority. */
+    videoResolution?: VideoResolution;
     seedanceFace?: boolean;
     seedanceRealFace?: boolean;
 }): string;
@@ -241,9 +262,9 @@ export declare const generateVideo: Operation<{
     prompt: string;
     model: string;
     projectId?: string;
-    aspectRatio?: '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '21:9' | '9:21' | '4:5' | '5:4' | '2:3' | '3:2';
+    aspectRatio?: AspectRatio;
     duration?: number;
-    videoResolution?: '480p' | '720p' | '1080p' | '4k';
+    videoResolution?: VideoResolution;
     firstFrameAssetId?: string;
     lastFrameAssetId?: string;
     ingredientAssetIds?: string[];
@@ -313,11 +334,11 @@ export declare const editVideo: Operation<{
     projectId: string;
     sourceVideoAssetId: string;
     prompt: string;
-    model?: 'kling-v3.0-omni-edit' | 'kling-v3.0-omni-pro-edit' | 'omni-flash-edit' | 'seedance-2.5-edit';
+    model?: EditVideoModel;
     characterAssetIds?: string[];
     styleAssetIds?: string[];
     keepAudio?: boolean;
-    videoResolution?: '480p' | '720p';
+    videoResolution?: VideoResolution;
     seedanceFace?: boolean;
     background?: boolean;
     confirm?: boolean;