@contractspec/lib.video-gen 2.0.0 → 2.1.1

package/dist/browser/generators/index.js

@@ -557,12 +557,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -654,6 +658,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -683,8 +699,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -723,7 +740,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/browser/generators/scene-planner.js

@@ -557,12 +557,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -654,6 +658,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -683,8 +699,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });

package/dist/browser/generators/script-generator.js

@@ -521,11 +521,15 @@ class ScriptGenerator {
   model;
   temperature;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.5;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async generate(brief, config) {
     const style = config?.style ?? "professional";
@@ -590,6 +594,18 @@ class ScriptGenerator {
       style
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async generateWithLlm(brief, style) {
     const { t } = this.i18n;
     const styleGuide = {
@@ -619,8 +635,9 @@ class ScriptGenerator {
       return this.generateDeterministic(brief, style);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });

package/dist/browser/generators/video-generator.js

@@ -557,12 +557,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -654,6 +658,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -683,8 +699,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -723,7 +740,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/browser/index.js

@@ -1636,12 +1636,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -1733,6 +1737,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -1762,8 +1778,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -1802,7 +1819,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/generators/index.js

@@ -552,12 +552,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -649,6 +653,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -678,8 +694,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -718,7 +735,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/generators/scene-planner.d.ts

@@ -1,4 +1,5 @@
 import type { LLMProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/llm';
+import type { ModelSelector, ModelSelectionContext } from '@contractspec/lib.ai-providers/selector-types';
 import type { ScenePlan, VideoBrief } from '../types';
 export interface ScenePlannerOptions {
     llm?: LLMProvider;
@@ -6,6 +7,8 @@ export interface ScenePlannerOptions {
     temperature?: number;
     fps?: number;
     locale?: string;
+    modelSelector?: ModelSelector;
+    selectionContext?: ModelSelectionContext;
 }
 export declare class ScenePlanner {
     private readonly llm?;
@@ -13,6 +16,8 @@ export declare class ScenePlanner {
     private readonly temperature;
     private readonly fps;
     private readonly i18n;
+    private readonly modelSelector?;
+    private readonly selectionContext?;
     constructor(options?: ScenePlannerOptions);
     /**
      * Plan scenes for a video brief.
@@ -21,5 +26,6 @@ export declare class ScenePlanner {
      */
     plan(brief: VideoBrief): Promise<ScenePlan>;
     private planDeterministic;
+    private resolveModel;
     private planWithLlm;
 }

package/dist/generators/scene-planner.js

@@ -552,12 +552,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -649,6 +653,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -678,8 +694,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });

package/dist/generators/script-generator.d.ts

@@ -1,4 +1,5 @@
 import type { LLMProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/llm';
+import type { ModelSelector, ModelSelectionContext } from '@contractspec/lib.ai-providers/selector-types';
 import type { ContentBrief } from '@contractspec/lib.content-gen/types';
 import type { NarrationConfig } from '@contractspec/lib.contracts-integrations/integrations/providers/video';
 export interface NarrationScript {
@@ -24,18 +25,23 @@ export interface ScriptGeneratorOptions {
     model?: string;
     temperature?: number;
     locale?: string;
+    modelSelector?: ModelSelector;
+    selectionContext?: ModelSelectionContext;
 }
 export declare class ScriptGenerator {
     private readonly llm?;
     private readonly model?;
     private readonly temperature;
     private readonly i18n;
+    private readonly modelSelector?;
+    private readonly selectionContext?;
     constructor(options?: ScriptGeneratorOptions);
     /**
      * Generate a narration script from a content brief.
      */
     generate(brief: ContentBrief, config?: NarrationConfig): Promise<NarrationScript>;
     private generateDeterministic;
+    private resolveModel;
     private generateWithLlm;
     /**
      * Adjust text tone based on style.

package/dist/generators/script-generator.js

@@ -516,11 +516,15 @@ class ScriptGenerator {
   model;
   temperature;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.5;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async generate(brief, config) {
     const style = config?.style ?? "professional";
@@ -585,6 +589,18 @@ class ScriptGenerator {
       style
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async generateWithLlm(brief, style) {
     const { t } = this.i18n;
     const styleGuide = {
@@ -614,8 +630,9 @@ class ScriptGenerator {
       return this.generateDeterministic(brief, style);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });

package/dist/generators/video-generator.js

@@ -552,12 +552,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -649,6 +653,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -678,8 +694,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -718,7 +735,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/index.js

@@ -1631,12 +1631,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -1728,6 +1732,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -1757,8 +1773,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -1797,7 +1814,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/node/generators/index.js

@@ -552,12 +552,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -649,6 +653,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -678,8 +694,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -718,7 +735,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/node/generators/scene-planner.js

@@ -552,12 +552,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -649,6 +653,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -678,8 +694,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });

package/dist/node/generators/script-generator.js

@@ -516,11 +516,15 @@ class ScriptGenerator {
   model;
   temperature;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.5;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async generate(brief, config) {
     const style = config?.style ?? "professional";
@@ -585,6 +589,18 @@ class ScriptGenerator {
       style
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async generateWithLlm(brief, style) {
     const { t } = this.i18n;
     const styleGuide = {
@@ -614,8 +630,9 @@ class ScriptGenerator {
       return this.generateDeterministic(brief, style);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });

package/dist/node/generators/video-generator.js

@@ -552,12 +552,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -649,6 +653,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -678,8 +694,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -718,7 +735,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/node/index.js

@@ -1631,12 +1631,16 @@ class ScenePlanner {
   temperature;
   fps;
   i18n;
+  modelSelector;
+  selectionContext;
   constructor(options) {
     this.llm = options?.llm;
     this.model = options?.model;
     this.temperature = options?.temperature ?? 0.3;
     this.fps = options?.fps ?? DEFAULT_FPS;
     this.i18n = createVideoGenI18n(options?.locale);
+    this.modelSelector = options?.modelSelector;
+    this.selectionContext = options?.selectionContext;
   }
   async plan(brief) {
     if (this.llm) {
@@ -1728,6 +1732,18 @@ class ScenePlanner {
       narrationScript
     };
   }
+  async resolveModel() {
+    if (this.model)
+      return this.model;
+    if (this.modelSelector) {
+      const ctx = this.selectionContext ?? {
+        taskDimension: "reasoning"
+      };
+      const result = await this.modelSelector.select(ctx);
+      return result.modelId;
+    }
+    return;
+  }
   async planWithLlm(brief) {
     const { t } = this.i18n;
     const messages = [
@@ -1757,8 +1773,9 @@ class ScenePlanner {
       return this.planDeterministic(brief);
     }
     try {
+      const model = await this.resolveModel();
       const response = await this.llm.chat(messages, {
-        model: this.model,
+        model,
         temperature: this.temperature,
         responseFormat: "json"
       });
@@ -1797,7 +1814,9 @@ class VideoGenerator {
       model: options?.model,
       temperature: options?.temperature,
       fps: this.fps,
-      locale: options?.locale
+      locale: options?.locale,
+      modelSelector: options?.modelSelector,
+      selectionContext: options?.selectionContext
     });
   }
   async generate(brief) {

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { LLMProvider } from '@contractspec/lib.contracts-integrations/integrations/providers/llm';
+import type { ModelSelector, ModelSelectionContext } from '@contractspec/lib.ai-providers/selector-types';
 import type { VoiceSynthesizer } from '@contractspec/lib.voice/tts';
 import type { Transcriber } from '@contractspec/lib.voice/stt';
 import type { ContentBrief } from '@contractspec/lib.content-gen/types';
@@ -46,6 +47,16 @@ export interface VideoGeneratorOptions {
     fps?: number;
     /** Locale for generated content and LLM prompts (defaults to "en") */
     locale?: string;
+    /** Ranking-driven model selector for dynamic model routing */
+    modelSelector?: ModelSelector;
+    /** Per-call selection context override */
+    selectionContext?: ModelSelectionContext;
+    /** Transport mode for video/LLM providers. */
+    transport?: 'rest' | 'mcp' | 'sdk';
+    /** Auth method for video/LLM providers. */
+    authMethod?: 'api-key' | 'oauth2' | 'bearer';
+    /** Custom auth headers for video/LLM providers. */
+    authHeaders?: Record<string, string>;
 }
 export interface GeneratedVideo {
     project: VideoProject;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.video-gen",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -25,26 +25,27 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.0.0",
-    "@contractspec/lib.contracts-integrations": "3.0.0",
-    "@contractspec/lib.voice": "1.0.0",
-    "@contractspec/lib.content-gen": "3.0.0",
-    "@contractspec/lib.design-system": "3.0.0",
-    "@contractspec/lib.image-gen": "1.0.0",
-    "remotion": "^4.0.429"
+    "@contractspec/lib.contracts-spec": "3.1.1",
+    "@contractspec/lib.contracts-integrations": "3.1.1",
+    "@contractspec/lib.ai-providers": "3.1.1",
+    "@contractspec/lib.voice": "1.1.1",
+    "@contractspec/lib.content-gen": "3.1.1",
+    "@contractspec/lib.design-system": "3.1.1",
+    "@contractspec/lib.image-gen": "1.1.1",
+    "remotion": "^4.0.434"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.0.0",
-    "@contractspec/tool.bun": "3.0.0",
+    "@contractspec/tool.typescript": "3.1.0",
+    "@contractspec/tool.bun": "3.1.0",
     "typescript": "^5.9.3",
-    "@remotion/bundler": "^4.0.429",
-    "@remotion/cli": "^4.0.429",
-    "@remotion/player": "^4.0.429",
-    "@remotion/renderer": "^4.0.429",
+    "@remotion/bundler": "^4.0.434",
+    "@remotion/cli": "^4.0.434",
+    "@remotion/player": "^4.0.434",
+    "@remotion/renderer": "^4.0.434",
     "@types/react": "^19.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "tsdown": "^0.20.3"
+    "tsdown": "^0.21.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",