@juspay/neurolink 9.22.2 → 9.23.0

package/dist/lib/types/generateTypes.d.ts

@@ -7,7 +7,7 @@ import type { Content, ImageWithAltText } from "./content.js";
 import type { ChatMessage, ConversationMemoryConfig } from "./conversation.js";
 import type { EvaluationData } from "./evaluation.js";
 import type { MiddlewareFactoryOptions } from "./middlewareTypes.js";
-import type { VideoGenerationResult, VideoOutputOptions } from "./multimodal.js";
+import type { DirectorModeOptions, DirectorSegment, VideoGenerationResult, VideoOutputOptions } from "./multimodal.js";
 import type { PPTGenerationResult, PPTOutputOptions } from "./pptTypes.js";
 import type { TTSOptions, TTSResult } from "./ttsTypes.js";
 import type { StandardRecord, ValidationSchema, ZodUnknownSchema } from "./typeAliases.js";
@@ -41,6 +41,12 @@ export type GenerateOptions = {
         videoFiles?: Array<Buffer | string>;
         files?: Array<Buffer | string | import("./fileTypes.js").FileWithMetadata>;
         content?: Content[];
+        /**
+         * Director Mode segments. When provided, Director Mode is activated automatically.
+         * Each segment contains its own prompt and image.
+         * Must contain 2-10 segments.
+         */
+        segments?: DirectorSegment[];
     };
     /**
      * Output configuration options
@@ -83,6 +89,11 @@ export type GenerateOptions = {
          * Generates slides based on text prompt
          */
         ppt?: PPTOutputOptions;
+        /**
+         * Director Mode configuration (only used when input.segments is provided)
+         * Controls transition prompts, durations, and concurrency.
+         */
+        director?: DirectorModeOptions;
     };
     csvOptions?: {
         maxRows?: number;
@@ -591,6 +602,8 @@ export type TextGenerationOptions = {
         images?: Array<Buffer | string | import("./content.js").ImageWithAltText>;
         pdfFiles?: Array<Buffer | string>;
         files?: Array<Buffer | string | import("./fileTypes.js").FileWithMetadata>;
+        /** Director Mode segments (2-10). When provided, Director Mode is activated. */
+        segments?: import("./multimodal.js").DirectorSegment[];
     };
     provider?: AIProviderName;
     model?: string;
@@ -627,6 +640,10 @@ export type TextGenerationOptions = {
          * PowerPoint generation configuration (used when mode is "ppt")
          */
         ppt?: PPTOutputOptions;
+        /**
+         * Director Mode configuration (only used when input.segments is provided)
+         */
+        director?: DirectorModeOptions;
     };
     tools?: Record<string, Tool>;
     timeout?: number | string;

package/dist/lib/types/multimodal.d.ts

@@ -150,6 +150,34 @@ export type VideoOutputOptions = {
     /** Enable audio generation (default: true) */
     audio?: boolean;
 };
+/**
+ * A single segment in Director Mode, representing one video clip.
+ */
+export type DirectorSegment = {
+    /** Prompt describing the video content for this segment */
+    prompt: string;
+    /** Input image for this segment (Buffer, URL string, file path, or ImageWithAltText) */
+    image: Buffer | string | ImageWithAltText;
+};
+/**
+ * Director Mode configuration options.
+ * Used when `input.segments` is provided to control transition generation.
+ */
+export type DirectorModeOptions = {
+    /**
+     * Prompts for generating transition clips (array of N-1 entries for N segments).
+     * transitionPrompts[i] is used for the transition between segment i and segment i+1.
+     * If omitted, defaults to "Smooth cinematic transition between scenes".
+     */
+    transitionPrompts?: string[];
+    /**
+     * Duration of each transition clip in seconds (array of N-1 entries for N segments).
+     * Each value must be 4, 6, or 8 (4 recommended for seamless feel).
+     * If omitted, all transitions default to 4 seconds.
+     * @default [4, 4, ...]
+     */
+    transitionDurations?: Array<4 | 6 | 8>;
+};
 /**
  * Result type for generated video content
  *
@@ -201,6 +229,27 @@ export type VideoGenerationResult = {
         audioEnabled?: boolean;
         /** Processing time in milliseconds */
         processingTime?: number;
+        /** Number of main segments in the video */
+        segmentCount?: number;
+        /** Number of transition clips generated */
+        transitionCount?: number;
+        /** Duration of each main clip in seconds */
+        clipDuration?: number;
+        /** Durations of each transition in seconds (one per transition) */
+        transitionDurations?: number[];
+        /** Per-segment metadata */
+        segments?: Array<{
+            index: number;
+            duration: number;
+            processingTime: number;
+        }>;
+        /** Per-transition metadata */
+        transitions?: Array<{
+            fromSegment: number;
+            toSegment: number;
+            duration: number;
+            processingTime: number;
+        }>;
     };
 };
 /**
@@ -295,6 +344,21 @@ export type MultimodalInput = {
     audioFiles?: Array<Buffer | string>;
     /** Video files for file-based video processing (future) */
     videoFiles?: Array<Buffer | string>;
+    /**
+     * Director Mode segments for multi-clip video generation.
+     * Each segment contains a prompt and image for generating one video clip.
+     * Automatically enables Director Mode when provided.
+     *
+     * @example
+     * ```typescript
+     * segments: [
+     *   { prompt: "Product reveal", image: imageBuffer1 },
+     *   { prompt: "Feature showcase", image: "./image2.jpg" },
+     *   { prompt: "Call to action", image: { data: imageBuffer3, altText: "CTA" } }
+     * ]
+     * ```
+     */
+    segments?: DirectorSegment[];
 };
 /**
  * Content format for multimodal messages (used internally)
@@ -389,10 +453,6 @@ export declare function isAudioContent(content: Content): content is AudioConten
  * Type guard to check if content is VideoContent
  */
 export declare function isVideoContent(content: Content): content is VideoContent;
-/**
- * Type guard to check if input contains multimodal content
- * Now includes audio and video detection
- */
 export declare function isMultimodalInput(input: unknown): input is MultimodalInput;
 /**
  * Type guard to check if message content is multimodal (array)

package/dist/lib/types/multimodal.js

@@ -82,6 +82,38 @@ export function isVideoContent(content) {
  * Type guard to check if input contains multimodal content
  * Now includes audio and video detection
  */
+/**
+ * Type guard to validate if an object matches the DirectorSegment shape.
+ * Checks for required prompt (string) and image (Buffer, string, or ImageWithAltText).
+ */
+function isDirectorSegment(segment) {
+    if (!segment || typeof segment !== "object") {
+        return false;
+    }
+    const maybeSegment = segment;
+    // Check for required prompt field
+    if (typeof maybeSegment.prompt !== "string" || !maybeSegment.prompt) {
+        return false;
+    }
+    // Check for required image field
+    const { image } = maybeSegment;
+    if (!image) {
+        return false;
+    }
+    // Validate image type: Buffer, string (URL/path), or ImageWithAltText
+    if (Buffer.isBuffer(image)) {
+        return true;
+    }
+    if (typeof image === "string") {
+        return true;
+    }
+    // Check for ImageWithAltText structure
+    if (typeof image === "object" && "data" in image) {
+        const imgData = image.data;
+        return Buffer.isBuffer(imgData) || typeof imgData === "string";
+    }
+    return false;
+}
 export function isMultimodalInput(input) {
     const maybeInput = input;
     return !!(maybeInput?.images?.length ||
@@ -90,7 +122,10 @@ export function isMultimodalInput(input) {
         maybeInput?.files?.length ||
         maybeInput?.content?.length ||
         maybeInput?.audioFiles?.length ||
-        maybeInput?.videoFiles?.length);
+        maybeInput?.videoFiles?.length ||
+        (maybeInput?.segments?.length &&
+            Array.isArray(maybeInput.segments) &&
+            maybeInput.segments.every(isDirectorSegment)));
 }
 /**
  * Type guard to check if message content is multimodal (array)

package/dist/lib/utils/parameterValidation.d.ts

@@ -8,7 +8,7 @@ import type { VideoOutputOptions } from "../types/multimodal.js";
 import type { PPTOutputOptions } from "../types/pptTypes.js";
 import type { EnhancedValidationResult } from "../types/tools.js";
 import type { StringArray, ValidationSchema } from "../types/typeAliases.js";
-import { NeuroLinkError } from "./errorHandling.js";
+import { type NeuroLinkError } from "./errorHandling.js";
 /**
  * Custom error class for parameter validation failures
  * Provides detailed information about validation errors including field context and suggestions
@@ -134,6 +134,13 @@ export declare function validateImageForVideo(image: Buffer | string, maxSize?:
  * ```
  */
 export declare function validateVideoGenerationInput(options: GenerateOptions): EnhancedValidationResult;
+/**
+ * Validate Director Mode input: segments, transition prompts, and durations.
+ *
+ * @param options - GenerateOptions with input.segments and output.director
+ * @returns EnhancedValidationResult with errors, warnings, and suggestions
+ */
+export declare function validateDirectorModeInput(options: GenerateOptions): EnhancedValidationResult;
 export declare const MIN_PPT_PAGES = 5;
 export declare const MAX_PPT_PAGES = 50;
 export declare const MIN_PPT_PROMPT_LENGTH = 10;

package/dist/lib/utils/parameterValidation.js

@@ -2,8 +2,9 @@
  * Parameter Validation Utilities
  * Provides consistent parameter validation across all tool interfaces
  */
+import { VIDEO_ERROR_CODES } from "../constants/videoErrors.js";
 import { SYSTEM_LIMITS } from "../core/constants.js";
-import { ErrorFactory, NeuroLinkError } from "./errorHandling.js";
+import { ErrorFactory } from "./errorHandling.js";
 import { isNonNullObject } from "./typeUtils.js";
 // ============================================================================
 // VALIDATION ERROR TYPES
@@ -606,6 +607,84 @@ export function validateVideoGenerationInput(options) {
     return { isValid: errors.length === 0, errors, warnings, suggestions };
 }
 // ============================================================================
+// DIRECTOR MODE VALIDATION
+// ============================================================================
+const MIN_DIRECTOR_SEGMENTS = 2;
+const MAX_DIRECTOR_SEGMENTS = 10;
+const VALID_TRANSITION_DURATIONS = [4, 6, 8];
+/**
+ * Validate Director Mode input: segments, transition prompts, and durations.
+ *
+ * @param options - GenerateOptions with input.segments and output.director
+ * @returns EnhancedValidationResult with errors, warnings, and suggestions
+ */
+export function validateDirectorModeInput(options) {
+    const errors = [];
+    const warnings = [];
+    const suggestions = [];
+    const segments = options.input?.segments;
+    if (!segments || !Array.isArray(segments)) {
+        errors.push(new ValidationError("Director Mode requires an input.segments array", "input.segments", VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        return { isValid: false, errors, warnings, suggestions };
+    }
+    if (segments.length < MIN_DIRECTOR_SEGMENTS ||
+        segments.length > MAX_DIRECTOR_SEGMENTS) {
+        errors.push(new ValidationError(`Director Mode requires ${MIN_DIRECTOR_SEGMENTS}-${MAX_DIRECTOR_SEGMENTS} segments, got ${segments.length}`, "input.segments", segments.length > MAX_DIRECTOR_SEGMENTS
+            ? VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_LIMIT_EXCEEDED
+            : VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        return { isValid: false, errors, warnings, suggestions };
+    }
+    // Validate each segment
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (!seg || typeof seg !== "object") {
+            errors.push(new ValidationError(`Segment ${i} must be an object with prompt and image`, `input.segments[${i}]`, VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+            continue;
+        }
+        if (!seg.prompt ||
+            typeof seg.prompt !== "string" ||
+            seg.prompt.trim().length === 0) {
+            errors.push(new ValidationError(`Segment ${i} requires a non-empty prompt`, `input.segments[${i}].prompt`, VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+        if (seg.image === undefined || seg.image === null) {
+            errors.push(new ValidationError(`Segment ${i} requires a valid image (Buffer, URL, path, or ImageWithAltText)`, `input.segments[${i}].image`, VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+    }
+    // Validate director options
+    const director = options.output?.director;
+    const expectedTransitions = segments.length - 1;
+    if (director?.transitionPrompts) {
+        if (director.transitionPrompts.length !== expectedTransitions) {
+            errors.push(new ValidationError(`Expected ${expectedTransitions} transition prompts, got ${director.transitionPrompts.length}`, "output.director.transitionPrompts", VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+    }
+    if (director?.transitionDurations) {
+        if (director.transitionDurations.length !== expectedTransitions) {
+            errors.push(new ValidationError(`Expected ${expectedTransitions} transition durations, got ${director.transitionDurations.length}`, "output.director.transitionDurations", VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+        else {
+            for (let i = 0; i < director.transitionDurations.length; i++) {
+                const d = director.transitionDurations[i];
+                if (!VALID_TRANSITION_DURATIONS.includes(d)) {
+                    errors.push(new ValidationError(`Invalid transition duration at index ${i}: ${d}. Use 4, 6, or 8`, `output.director.transitionDurations[${i}]`, VIDEO_ERROR_CODES.DIRECTOR_INVALID_TRANSITION_DURATION));
+                }
+            }
+        }
+    }
+    // Validate video output options if provided
+    if (options.output?.video) {
+        const videoError = validateVideoOutputOptions(options.output.video);
+        if (videoError) {
+            errors.push(toValidationError(videoError));
+        }
+    }
+    if (errors.length === 0) {
+        const totalCalls = segments.length + expectedTransitions;
+        suggestions.push(`Director Mode will make ${totalCalls} API calls (${segments.length} clips + ${expectedTransitions} transitions). Ensure adequate timeout.`);
+    }
+    return { isValid: errors.length === 0, errors, warnings, suggestions };
+}
+// ============================================================================
 // PPT VALIDATION (Presentation Generation)
 // ============================================================================
 /**

package/dist/types/content.d.ts

@@ -14,5 +14,5 @@
  * import type { MultimodalInput } from './types/multimodal.js';
  * ```
  */
-export type { TextContent, ImageContent, CSVContent, PDFContent, AudioContent, VideoContent, VideoOutputOptions, VideoGenerationResult, Content, ImageWithAltText, MultimodalInput, MultimodalMessage, VisionCapability, ProviderImageFormat, ProcessedImage, ProviderMultimodalPayload, } from "./multimodal.js";
+export type { TextContent, ImageContent, CSVContent, PDFContent, AudioContent, VideoContent, VideoOutputOptions, VideoGenerationResult, DirectorSegment, DirectorModeOptions, Content, ImageWithAltText, MultimodalInput, MultimodalMessage, VisionCapability, ProviderImageFormat, ProcessedImage, ProviderMultimodalPayload, } from "./multimodal.js";
 export { isTextContent, isImageContent, isCSVContent, isPDFContent, isAudioContent, isVideoContent, isMultimodalInput, } from "./multimodal.js";

package/dist/types/generateTypes.d.ts

@@ -7,7 +7,7 @@ import type { Content, ImageWithAltText } from "./content.js";
 import type { ChatMessage, ConversationMemoryConfig } from "./conversation.js";
 import type { EvaluationData } from "./evaluation.js";
 import type { MiddlewareFactoryOptions } from "./middlewareTypes.js";
-import type { VideoGenerationResult, VideoOutputOptions } from "./multimodal.js";
+import type { DirectorModeOptions, DirectorSegment, VideoGenerationResult, VideoOutputOptions } from "./multimodal.js";
 import type { PPTGenerationResult, PPTOutputOptions } from "./pptTypes.js";
 import type { TTSOptions, TTSResult } from "./ttsTypes.js";
 import type { StandardRecord, ValidationSchema, ZodUnknownSchema } from "./typeAliases.js";
@@ -41,6 +41,12 @@ export type GenerateOptions = {
         videoFiles?: Array<Buffer | string>;
         files?: Array<Buffer | string | import("./fileTypes.js").FileWithMetadata>;
         content?: Content[];
+        /**
+         * Director Mode segments. When provided, Director Mode is activated automatically.
+         * Each segment contains its own prompt and image.
+         * Must contain 2-10 segments.
+         */
+        segments?: DirectorSegment[];
     };
     /**
      * Output configuration options
@@ -83,6 +89,11 @@ export type GenerateOptions = {
          * Generates slides based on text prompt
          */
         ppt?: PPTOutputOptions;
+        /**
+         * Director Mode configuration (only used when input.segments is provided)
+         * Controls transition prompts, durations, and concurrency.
+         */
+        director?: DirectorModeOptions;
     };
     csvOptions?: {
         maxRows?: number;
@@ -591,6 +602,8 @@ export type TextGenerationOptions = {
         images?: Array<Buffer | string | import("./content.js").ImageWithAltText>;
         pdfFiles?: Array<Buffer | string>;
         files?: Array<Buffer | string | import("./fileTypes.js").FileWithMetadata>;
+        /** Director Mode segments (2-10). When provided, Director Mode is activated. */
+        segments?: import("./multimodal.js").DirectorSegment[];
     };
     provider?: AIProviderName;
     model?: string;
@@ -627,6 +640,10 @@ export type TextGenerationOptions = {
          * PowerPoint generation configuration (used when mode is "ppt")
          */
         ppt?: PPTOutputOptions;
+        /**
+         * Director Mode configuration (only used when input.segments is provided)
+         */
+        director?: DirectorModeOptions;
     };
     tools?: Record<string, Tool>;
     timeout?: number | string;

package/dist/types/multimodal.d.ts

@@ -150,6 +150,34 @@ export type VideoOutputOptions = {
     /** Enable audio generation (default: true) */
     audio?: boolean;
 };
+/**
+ * A single segment in Director Mode, representing one video clip.
+ */
+export type DirectorSegment = {
+    /** Prompt describing the video content for this segment */
+    prompt: string;
+    /** Input image for this segment (Buffer, URL string, file path, or ImageWithAltText) */
+    image: Buffer | string | ImageWithAltText;
+};
+/**
+ * Director Mode configuration options.
+ * Used when `input.segments` is provided to control transition generation.
+ */
+export type DirectorModeOptions = {
+    /**
+     * Prompts for generating transition clips (array of N-1 entries for N segments).
+     * transitionPrompts[i] is used for the transition between segment i and segment i+1.
+     * If omitted, defaults to "Smooth cinematic transition between scenes".
+     */
+    transitionPrompts?: string[];
+    /**
+     * Duration of each transition clip in seconds (array of N-1 entries for N segments).
+     * Each value must be 4, 6, or 8 (4 recommended for seamless feel).
+     * If omitted, all transitions default to 4 seconds.
+     * @default [4, 4, ...]
+     */
+    transitionDurations?: Array<4 | 6 | 8>;
+};
 /**
  * Result type for generated video content
  *
@@ -201,6 +229,27 @@ export type VideoGenerationResult = {
         audioEnabled?: boolean;
         /** Processing time in milliseconds */
         processingTime?: number;
+        /** Number of main segments in the video */
+        segmentCount?: number;
+        /** Number of transition clips generated */
+        transitionCount?: number;
+        /** Duration of each main clip in seconds */
+        clipDuration?: number;
+        /** Durations of each transition in seconds (one per transition) */
+        transitionDurations?: number[];
+        /** Per-segment metadata */
+        segments?: Array<{
+            index: number;
+            duration: number;
+            processingTime: number;
+        }>;
+        /** Per-transition metadata */
+        transitions?: Array<{
+            fromSegment: number;
+            toSegment: number;
+            duration: number;
+            processingTime: number;
+        }>;
     };
 };
 /**
@@ -295,6 +344,21 @@ export type MultimodalInput = {
     audioFiles?: Array<Buffer | string>;
     /** Video files for file-based video processing (future) */
     videoFiles?: Array<Buffer | string>;
+    /**
+     * Director Mode segments for multi-clip video generation.
+     * Each segment contains a prompt and image for generating one video clip.
+     * Automatically enables Director Mode when provided.
+     *
+     * @example
+     * ```typescript
+     * segments: [
+     *   { prompt: "Product reveal", image: imageBuffer1 },
+     *   { prompt: "Feature showcase", image: "./image2.jpg" },
+     *   { prompt: "Call to action", image: { data: imageBuffer3, altText: "CTA" } }
+     * ]
+     * ```
+     */
+    segments?: DirectorSegment[];
 };
 /**
  * Content format for multimodal messages (used internally)
@@ -389,10 +453,6 @@ export declare function isAudioContent(content: Content): content is AudioConten
  * Type guard to check if content is VideoContent
  */
 export declare function isVideoContent(content: Content): content is VideoContent;
-/**
- * Type guard to check if input contains multimodal content
- * Now includes audio and video detection
- */
 export declare function isMultimodalInput(input: unknown): input is MultimodalInput;
 /**
  * Type guard to check if message content is multimodal (array)

package/dist/types/multimodal.js

@@ -82,6 +82,38 @@ export function isVideoContent(content) {
  * Type guard to check if input contains multimodal content
  * Now includes audio and video detection
  */
+/**
+ * Type guard to validate if an object matches the DirectorSegment shape.
+ * Checks for required prompt (string) and image (Buffer, string, or ImageWithAltText).
+ */
+function isDirectorSegment(segment) {
+    if (!segment || typeof segment !== "object") {
+        return false;
+    }
+    const maybeSegment = segment;
+    // Check for required prompt field
+    if (typeof maybeSegment.prompt !== "string" || !maybeSegment.prompt) {
+        return false;
+    }
+    // Check for required image field
+    const { image } = maybeSegment;
+    if (!image) {
+        return false;
+    }
+    // Validate image type: Buffer, string (URL/path), or ImageWithAltText
+    if (Buffer.isBuffer(image)) {
+        return true;
+    }
+    if (typeof image === "string") {
+        return true;
+    }
+    // Check for ImageWithAltText structure
+    if (typeof image === "object" && "data" in image) {
+        const imgData = image.data;
+        return Buffer.isBuffer(imgData) || typeof imgData === "string";
+    }
+    return false;
+}
 export function isMultimodalInput(input) {
     const maybeInput = input;
     return !!(maybeInput?.images?.length ||
@@ -90,7 +122,10 @@ export function isMultimodalInput(input) {
         maybeInput?.files?.length ||
         maybeInput?.content?.length ||
         maybeInput?.audioFiles?.length ||
-        maybeInput?.videoFiles?.length);
+        maybeInput?.videoFiles?.length ||
+        (maybeInput?.segments?.length &&
+            Array.isArray(maybeInput.segments) &&
+            maybeInput.segments.every(isDirectorSegment)));
 }
 /**
  * Type guard to check if message content is multimodal (array)

package/dist/utils/parameterValidation.d.ts

@@ -8,7 +8,7 @@ import type { VideoOutputOptions } from "../types/multimodal.js";
 import type { PPTOutputOptions } from "../types/pptTypes.js";
 import type { EnhancedValidationResult } from "../types/tools.js";
 import type { StringArray, ValidationSchema } from "../types/typeAliases.js";
-import { NeuroLinkError } from "./errorHandling.js";
+import { type NeuroLinkError } from "./errorHandling.js";
 /**
  * Custom error class for parameter validation failures
  * Provides detailed information about validation errors including field context and suggestions
@@ -134,6 +134,13 @@ export declare function validateImageForVideo(image: Buffer | string, maxSize?:
  * ```
  */
 export declare function validateVideoGenerationInput(options: GenerateOptions): EnhancedValidationResult;
+/**
+ * Validate Director Mode input: segments, transition prompts, and durations.
+ *
+ * @param options - GenerateOptions with input.segments and output.director
+ * @returns EnhancedValidationResult with errors, warnings, and suggestions
+ */
+export declare function validateDirectorModeInput(options: GenerateOptions): EnhancedValidationResult;
 export declare const MIN_PPT_PAGES = 5;
 export declare const MAX_PPT_PAGES = 50;
 export declare const MIN_PPT_PROMPT_LENGTH = 10;

package/dist/utils/parameterValidation.js

@@ -2,8 +2,9 @@
  * Parameter Validation Utilities
  * Provides consistent parameter validation across all tool interfaces
  */
+import { VIDEO_ERROR_CODES } from "../constants/videoErrors.js";
 import { SYSTEM_LIMITS } from "../core/constants.js";
-import { ErrorFactory, NeuroLinkError } from "./errorHandling.js";
+import { ErrorFactory } from "./errorHandling.js";
 import { isNonNullObject } from "./typeUtils.js";
 // ============================================================================
 // VALIDATION ERROR TYPES
@@ -606,6 +607,84 @@ export function validateVideoGenerationInput(options) {
     return { isValid: errors.length === 0, errors, warnings, suggestions };
 }
 // ============================================================================
+// DIRECTOR MODE VALIDATION
+// ============================================================================
+const MIN_DIRECTOR_SEGMENTS = 2;
+const MAX_DIRECTOR_SEGMENTS = 10;
+const VALID_TRANSITION_DURATIONS = [4, 6, 8];
+/**
+ * Validate Director Mode input: segments, transition prompts, and durations.
+ *
+ * @param options - GenerateOptions with input.segments and output.director
+ * @returns EnhancedValidationResult with errors, warnings, and suggestions
+ */
+export function validateDirectorModeInput(options) {
+    const errors = [];
+    const warnings = [];
+    const suggestions = [];
+    const segments = options.input?.segments;
+    if (!segments || !Array.isArray(segments)) {
+        errors.push(new ValidationError("Director Mode requires an input.segments array", "input.segments", VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        return { isValid: false, errors, warnings, suggestions };
+    }
+    if (segments.length < MIN_DIRECTOR_SEGMENTS ||
+        segments.length > MAX_DIRECTOR_SEGMENTS) {
+        errors.push(new ValidationError(`Director Mode requires ${MIN_DIRECTOR_SEGMENTS}-${MAX_DIRECTOR_SEGMENTS} segments, got ${segments.length}`, "input.segments", segments.length > MAX_DIRECTOR_SEGMENTS
+            ? VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_LIMIT_EXCEEDED
+            : VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        return { isValid: false, errors, warnings, suggestions };
+    }
+    // Validate each segment
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        if (!seg || typeof seg !== "object") {
+            errors.push(new ValidationError(`Segment ${i} must be an object with prompt and image`, `input.segments[${i}]`, VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+            continue;
+        }
+        if (!seg.prompt ||
+            typeof seg.prompt !== "string" ||
+            seg.prompt.trim().length === 0) {
+            errors.push(new ValidationError(`Segment ${i} requires a non-empty prompt`, `input.segments[${i}].prompt`, VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+        if (seg.image === undefined || seg.image === null) {
+            errors.push(new ValidationError(`Segment ${i} requires a valid image (Buffer, URL, path, or ImageWithAltText)`, `input.segments[${i}].image`, VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+    }
+    // Validate director options
+    const director = options.output?.director;
+    const expectedTransitions = segments.length - 1;
+    if (director?.transitionPrompts) {
+        if (director.transitionPrompts.length !== expectedTransitions) {
+            errors.push(new ValidationError(`Expected ${expectedTransitions} transition prompts, got ${director.transitionPrompts.length}`, "output.director.transitionPrompts", VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+    }
+    if (director?.transitionDurations) {
+        if (director.transitionDurations.length !== expectedTransitions) {
+            errors.push(new ValidationError(`Expected ${expectedTransitions} transition durations, got ${director.transitionDurations.length}`, "output.director.transitionDurations", VIDEO_ERROR_CODES.DIRECTOR_SEGMENT_MISMATCH));
+        }
+        else {
+            for (let i = 0; i < director.transitionDurations.length; i++) {
+                const d = director.transitionDurations[i];
+                if (!VALID_TRANSITION_DURATIONS.includes(d)) {
+                    errors.push(new ValidationError(`Invalid transition duration at index ${i}: ${d}. Use 4, 6, or 8`, `output.director.transitionDurations[${i}]`, VIDEO_ERROR_CODES.DIRECTOR_INVALID_TRANSITION_DURATION));
+                }
+            }
+        }
+    }
+    // Validate video output options if provided
+    if (options.output?.video) {
+        const videoError = validateVideoOutputOptions(options.output.video);
+        if (videoError) {
+            errors.push(toValidationError(videoError));
+        }
+    }
+    if (errors.length === 0) {
+        const totalCalls = segments.length + expectedTransitions;
+        suggestions.push(`Director Mode will make ${totalCalls} API calls (${segments.length} clips + ${expectedTransitions} transitions). Ensure adequate timeout.`);
+    }
+    return { isValid: errors.length === 0, errors, warnings, suggestions };
+}
+// ============================================================================
 // PPT VALIDATION (Presentation Generation)
 // ============================================================================
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.22.2",
+  "version": "9.23.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",