@juspay/neurolink 9.64.0 → 9.65.0

package/dist/utils/modelChoices.js

@@ -2,7 +2,7 @@
  * Centralized model choices for CLI commands
  * Derives choices from model enums to ensure consistency
  */
-import { AIProviderName, OpenAIModels, AnthropicModels, GoogleAIModels, BedrockModels, VertexModels, MistralModels, OllamaModels, AzureOpenAIModels, LiteLLMModels, HuggingFaceModels, SageMakerModels, OpenRouterModels, DeepSeekModels, NvidiaNimModels, } from "../constants/enums.js";
+import { AIProviderName, OpenAIModels, AnthropicModels, GoogleAIModels, BedrockModels, VertexModels, MistralModels, OllamaModels, AzureOpenAIModels, LiteLLMModels, HuggingFaceModels, SageMakerModels, OpenRouterModels, DeepSeekModels, NvidiaNimModels, XaiModels, GroqModels, CohereModels, TogetherAIModels, FireworksModels, PerplexityModels, CloudflareModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
 /**
  * Top models per provider with descriptions for CLI prompts
  * These are curated lists of the most commonly used/recommended models
@@ -209,7 +209,7 @@ const TOP_MODELS_CONFIG = {
     ],
     [AIProviderName.OPENROUTER]: [
         {
-            model: OpenRouterModels.CLAUDE_3_5_SONNET,
+            model: OpenRouterModels.CLAUDE_SONNET_4_5,
             description: "Anthropic via OpenRouter",
         },
         { model: OpenRouterModels.GPT_4O, description: "OpenAI via OpenRouter" },
@@ -271,6 +271,213 @@ const TOP_MODELS_CONFIG = {
             description: "Use whatever model llama-server has loaded",
         },
     ],
+    [AIProviderName.XAI]: [
+        {
+            model: XaiModels.GROK_3,
+            description: "Recommended - Latest flagship Grok",
+        },
+        { model: XaiModels.GROK_3_MINI, description: "Faster + cheaper Grok 3" },
+        {
+            model: XaiModels.GROK_2_VISION_LATEST,
+            description: "Multimodal (text + images)",
+        },
+        { model: XaiModels.GROK_2_LATEST, description: "Previous flagship" },
+        { model: XaiModels.GROK_BETA, description: "Pre-release / experimental" },
+    ],
+    [AIProviderName.GROQ]: [
+        {
+            model: GroqModels.LLAMA_3_3_70B_VERSATILE,
+            description: "Recommended - Production default; sub-100ms",
+        },
+        {
+            model: GroqModels.LLAMA_3_1_8B_INSTANT,
+            description: "Lowest latency tier",
+        },
+        {
+            model: GroqModels.LLAMA_3_2_90B_VISION_PREVIEW,
+            description: "Multimodal (vision)",
+        },
+        { model: GroqModels.GEMMA_2_9B_IT, description: "Google Gemma 2 9B" },
+        {
+            model: GroqModels.MIXTRAL_8X7B_32768,
+            description: "Mistral 8x7B MoE, 32K context",
+        },
+    ],
+    [AIProviderName.COHERE]: [
+        {
+            model: CohereModels.COMMAND_R_PLUS,
+            description: "Recommended - Flagship RAG-tuned chat",
+        },
+        { model: CohereModels.COMMAND_R, description: "Smaller RAG-tuned chat" },
+        { model: CohereModels.COMMAND_R7B, description: "Most compact" },
+    ],
+    [AIProviderName.TOGETHER_AI]: [
+        {
+            model: TogetherAIModels.LLAMA_3_3_70B_INSTRUCT_TURBO,
+            description: "Recommended - Llama 3.3 70B Turbo",
+        },
+        {
+            model: TogetherAIModels.LLAMA_3_1_405B_INSTRUCT_TURBO,
+            description: "Flagship 405B",
+        },
+        {
+            model: TogetherAIModels.QWEN_2_5_72B_INSTRUCT_TURBO,
+            description: "Qwen 2.5 72B Turbo",
+        },
+        {
+            model: TogetherAIModels.DEEPSEEK_R1,
+            description: "DeepSeek R1 reasoning",
+        },
+        {
+            model: TogetherAIModels.MIXTRAL_8X22B_INSTRUCT,
+            description: "Mistral 8x22B MoE",
+        },
+    ],
+    [AIProviderName.FIREWORKS]: [
+        {
+            model: FireworksModels.DEEPSEEK_V4_PRO,
+            description: "Recommended - DeepSeek V4 Pro",
+        },
+        { model: FireworksModels.GLM_5P1, description: "GLM 5.1 (Zhipu)" },
+        { model: FireworksModels.KIMI_K2P6, description: "Kimi K2.6 (Moonshot)" },
+        { model: FireworksModels.GPT_OSS_120B, description: "GPT-OSS 120B" },
+    ],
+    [AIProviderName.PERPLEXITY]: [
+        {
+            model: PerplexityModels.SONAR,
+            description: "Recommended - Sonar with web grounding",
+        },
+        { model: PerplexityModels.SONAR_PRO, description: "Better reasoning" },
+        {
+            model: PerplexityModels.SONAR_REASONING,
+            description: "Explicit reasoning traces",
+        },
+        {
+            model: PerplexityModels.SONAR_REASONING_PRO,
+            description: "Flagship reasoning + web",
+        },
+        {
+            model: PerplexityModels.SONAR_DEEP_RESEARCH,
+            description: "Long-form research with citations",
+        },
+    ],
+    [AIProviderName.CLOUDFLARE]: [
+        {
+            model: CloudflareModels.LLAMA_3_3_70B_FAST,
+            description: "Recommended - Llama 3.3 70B FP8 fast",
+        },
+        {
+            model: CloudflareModels.LLAMA_3_1_70B_INSTRUCT,
+            description: "Llama 3.1 70B",
+        },
+        {
+            model: CloudflareModels.LLAMA_3_1_8B_FAST,
+            description: "Llama 3.1 8B fast",
+        },
+        {
+            model: CloudflareModels.LLAMA_3_2_11B_VISION,
+            description: "Multimodal (vision)",
+        },
+    ],
+    [AIProviderName.REPLICATE]: [
+        {
+            model: "meta/meta-llama-3-70b-instruct",
+            description: "Recommended - Llama 3 70B Instruct (stable)",
+        },
+        {
+            model: "meta/meta-llama-3.1-405b-instruct",
+            description: "Llama 3.1 405B (flagship)",
+        },
+        {
+            model: "mistralai/mixtral-8x7b-instruct-v0.1",
+            description: "Mixtral 8x7B v0.1",
+        },
+        {
+            model: "black-forest-labs/flux-1.1-pro",
+            description: "FLUX 1.1 Pro (image-gen)",
+        },
+        {
+            model: "stability-ai/stable-diffusion-3.5-large",
+            description: "SD 3.5 Large (image-gen)",
+        },
+    ],
+    [AIProviderName.VOYAGE]: [
+        {
+            model: VoyageModels.VOYAGE_3_5,
+            description: "Recommended - General-purpose embeddings",
+        },
+        {
+            model: VoyageModels.VOYAGE_3_LARGE,
+            description: "Flagship — highest accuracy",
+        },
+        {
+            model: VoyageModels.VOYAGE_CODE_3,
+            description: "Code-tuned embeddings",
+        },
+        {
+            model: VoyageModels.VOYAGE_MULTILINGUAL_2,
+            description: "Multilingual embeddings",
+        },
+        {
+            model: VoyageModels.VOYAGE_3_5_LITE,
+            description: "Smaller / cheaper",
+        },
+    ],
+    [AIProviderName.JINA]: [
+        {
+            model: JinaModels.JINA_EMBEDDINGS_V3,
+            description: "Recommended - Multilingual flagship",
+        },
+        {
+            model: JinaModels.JINA_EMBEDDINGS_V2_BASE_EN,
+            description: "v2 base English",
+        },
+        {
+            model: JinaModels.JINA_EMBEDDINGS_V2_BASE_CODE,
+            description: "v2 base code",
+        },
+        {
+            model: JinaModels.JINA_RERANKER_V2_BASE_MULTILINGUAL,
+            description: "Reranker (multilingual)",
+        },
+        {
+            model: JinaModels.JINA_COLBERT_V2,
+            description: "Late-interaction retrieval",
+        },
+    ],
+    [AIProviderName.STABILITY]: [
+        {
+            model: StabilityModels.STABLE_IMAGE_ULTRA,
+            description: "Recommended - Flagship quality",
+        },
+        {
+            model: StabilityModels.STABLE_IMAGE_CORE,
+            description: "Fast tier",
+        },
+        { model: StabilityModels.SD_3_5_LARGE, description: "SD 3.5 Large" },
+        {
+            model: StabilityModels.SD_3_5_LARGE_TURBO,
+            description: "SD 3.5 Large Turbo",
+        },
+        { model: StabilityModels.SD_3_5_MEDIUM, description: "SD 3.5 Medium" },
+    ],
+    [AIProviderName.IDEOGRAM]: [
+        { model: IdeogramModels.IDEOGRAM_V3, description: "Recommended - V3" },
+        { model: IdeogramModels.IDEOGRAM_V2, description: "V2" },
+        { model: IdeogramModels.IDEOGRAM_V2_TURBO, description: "V2 Turbo (fast)" },
+        { model: IdeogramModels.IDEOGRAM_V1, description: "V1" },
+    ],
+    [AIProviderName.RECRAFT]: [
+        {
+            model: RecraftModels.RECRAFT_V3,
+            description: "Recommended - Raster V3",
+        },
+        {
+            model: RecraftModels.RECRAFT_V3_SVG,
+            description: "Vector / SVG output",
+        },
+        { model: RecraftModels.RECRAFT_V2, description: "V2" },
+    ],
     [AIProviderName.AUTO]: [],
 };
 /**
@@ -288,7 +495,7 @@ export const DEFAULT_MODELS = {
     [AIProviderName.LITELLM]: LiteLLMModels.OPENAI_GPT_4O,
     [AIProviderName.HUGGINGFACE]: HuggingFaceModels.LLAMA_3_3_70B_INSTRUCT,
     [AIProviderName.SAGEMAKER]: SageMakerModels.LLAMA_4_MAVERICK_17B_128E,
-    [AIProviderName.OPENROUTER]: OpenRouterModels.CLAUDE_3_5_SONNET,
+    [AIProviderName.OPENROUTER]: OpenRouterModels.CLAUDE_SONNET_4_5,
     [AIProviderName.OPENAI_COMPATIBLE]: "gpt-4o",
     [AIProviderName.DEEPSEEK]: DeepSeekModels.DEEPSEEK_CHAT,
     [AIProviderName.NVIDIA_NIM]: NvidiaNimModels.LLAMA_3_3_70B_INSTRUCT,
@@ -296,6 +503,19 @@ export const DEFAULT_MODELS = {
     // an empty default is the documented signal to use that path.
     [AIProviderName.LM_STUDIO]: "",
     [AIProviderName.LLAMACPP]: "",
+    [AIProviderName.XAI]: XaiModels.GROK_3,
+    [AIProviderName.GROQ]: GroqModels.LLAMA_3_3_70B_VERSATILE,
+    [AIProviderName.COHERE]: CohereModels.COMMAND_R_PLUS,
+    [AIProviderName.TOGETHER_AI]: TogetherAIModels.LLAMA_3_3_70B_INSTRUCT_TURBO,
+    [AIProviderName.FIREWORKS]: FireworksModels.DEEPSEEK_V4_PRO,
+    [AIProviderName.PERPLEXITY]: PerplexityModels.SONAR,
+    [AIProviderName.CLOUDFLARE]: CloudflareModels.LLAMA_3_3_70B_FAST,
+    [AIProviderName.REPLICATE]: "meta/meta-llama-3-70b-instruct",
+    [AIProviderName.VOYAGE]: VoyageModels.VOYAGE_3_5,
+    [AIProviderName.JINA]: JinaModels.JINA_EMBEDDINGS_V3,
+    [AIProviderName.STABILITY]: StabilityModels.STABLE_IMAGE_ULTRA,
+    [AIProviderName.IDEOGRAM]: IdeogramModels.IDEOGRAM_V3,
+    [AIProviderName.RECRAFT]: RecraftModels.RECRAFT_V3,
 };
 /**
  * Model enum mappings for getAllModels
@@ -318,6 +538,19 @@ const MODEL_ENUMS = {
     [AIProviderName.NVIDIA_NIM]: NvidiaNimModels,
     [AIProviderName.LM_STUDIO]: null,
     [AIProviderName.LLAMACPP]: null,
+    [AIProviderName.XAI]: XaiModels,
+    [AIProviderName.GROQ]: GroqModels,
+    [AIProviderName.COHERE]: CohereModels,
+    [AIProviderName.TOGETHER_AI]: TogetherAIModels,
+    [AIProviderName.FIREWORKS]: FireworksModels,
+    [AIProviderName.PERPLEXITY]: PerplexityModels,
+    [AIProviderName.CLOUDFLARE]: CloudflareModels,
+    [AIProviderName.REPLICATE]: ReplicateModels,
+    [AIProviderName.VOYAGE]: VoyageModels,
+    [AIProviderName.JINA]: JinaModels,
+    [AIProviderName.STABILITY]: StabilityModels,
+    [AIProviderName.IDEOGRAM]: IdeogramModels,
+    [AIProviderName.RECRAFT]: RecraftModels,
     [AIProviderName.AUTO]: null,
 };
 /**

package/dist/utils/musicProcessor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Music Generation Processing Utility
+ *
+ * Central registry + dispatch for music-generation handlers across
+ * providers (Beatoven, ElevenLabs Music, Lyria, Replicate-hosted models).
+ *
+ * Mirrors the static-handler-registry pattern established by
+ * `TTSProcessor` / `STTProcessor` / `VideoProcessor`.
+ *
+ * @module utils/musicProcessor
+ */
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
+import type { MusicHandler, MusicOptions, MusicResult } from "../types/index.js";
+import { NeuroLinkError } from "./errorHandling.js";
+/**
+ * Music-specific error codes.
+ */
+export declare const MUSIC_ERROR_CODES: {
+    readonly PROVIDER_NOT_SUPPORTED: "MUSIC_PROVIDER_NOT_SUPPORTED";
+    readonly PROVIDER_NOT_CONFIGURED: "MUSIC_PROVIDER_NOT_CONFIGURED";
+    readonly GENERATION_FAILED: "MUSIC_GENERATION_FAILED";
+    readonly POLL_TIMEOUT: "MUSIC_POLL_TIMEOUT";
+    readonly PROMPT_REQUIRED: "MUSIC_PROMPT_REQUIRED";
+    readonly DURATION_INVALID: "MUSIC_DURATION_INVALID";
+    readonly INVALID_INPUT: "MUSIC_INVALID_INPUT";
+};
+/**
+ * Typed error class for music-generation failures.
+ */
+export declare class MusicError extends NeuroLinkError {
+    constructor(options: {
+        code: string;
+        message: string;
+        category?: ErrorCategory;
+        severity?: ErrorSeverity;
+        retriable?: boolean;
+        context?: Record<string, unknown>;
+        originalError?: Error;
+    });
+}
+/**
+ * Static processor managing the music handler registry.
+ */
+export declare class MusicProcessor {
+    private static readonly handlers;
+    /**
+     * Register a music handler for a specific provider.
+     */
+    static registerHandler(providerName: string, handler: MusicHandler): void;
+    /**
+     * Check if a provider has a registered music handler.
+     */
+    static supports(providerName: string): boolean;
+    /**
+     * List the names of all registered providers.
+     */
+    static listProviders(): string[];
+    private static getHandler;
+    private static buildSpanAttributes;
+    /**
+     * Generate a music track via the registered handler.
+     *
+     * @throws MusicError on registry miss, handler-not-configured, or
+     *         generation failure.
+     */
+    static generate(provider: string, options: MusicOptions): Promise<MusicResult>;
+}

package/dist/utils/musicProcessor.js

@@ -0,0 +1,188 @@
+/**
+ * Music Generation Processing Utility
+ *
+ * Central registry + dispatch for music-generation handlers across
+ * providers (Beatoven, ElevenLabs Music, Lyria, Replicate-hosted models).
+ *
+ * Mirrors the static-handler-registry pattern established by
+ * `TTSProcessor` / `STTProcessor` / `VideoProcessor`.
+ *
+ * @module utils/musicProcessor
+ */
+import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
+import { SpanSerializer, SpanStatus, SpanType, getMetricsAggregator, } from "../observability/index.js";
+import { NeuroLinkError } from "./errorHandling.js";
+import { logger } from "./logger.js";
+/**
+ * Music-specific error codes.
+ */
+export const MUSIC_ERROR_CODES = {
+    PROVIDER_NOT_SUPPORTED: "MUSIC_PROVIDER_NOT_SUPPORTED",
+    PROVIDER_NOT_CONFIGURED: "MUSIC_PROVIDER_NOT_CONFIGURED",
+    GENERATION_FAILED: "MUSIC_GENERATION_FAILED",
+    POLL_TIMEOUT: "MUSIC_POLL_TIMEOUT",
+    PROMPT_REQUIRED: "MUSIC_PROMPT_REQUIRED",
+    DURATION_INVALID: "MUSIC_DURATION_INVALID",
+    INVALID_INPUT: "MUSIC_INVALID_INPUT",
+};
+/**
+ * Typed error class for music-generation failures.
+ */
+export class MusicError extends NeuroLinkError {
+    constructor(options) {
+        super({
+            code: options.code,
+            message: options.message,
+            category: options.category ?? ErrorCategory.EXECUTION,
+            severity: options.severity ?? ErrorSeverity.HIGH,
+            retriable: options.retriable ?? false,
+            context: options.context,
+            originalError: options.originalError,
+        });
+        this.name = "MusicError";
+    }
+}
+/**
+ * Static processor managing the music handler registry.
+ */
+export class MusicProcessor {
+    static handlers = new Map();
+    /**
+     * Register a music handler for a specific provider.
+     */
+    static registerHandler(providerName, handler) {
+        if (!providerName) {
+            throw new Error("Provider name is required");
+        }
+        if (!handler) {
+            throw new Error("Handler is required");
+        }
+        const key = providerName.toLowerCase();
+        if (this.handlers.has(key)) {
+            logger.warn(`[MusicProcessor] Overwriting existing handler for provider: ${key}`);
+        }
+        this.handlers.set(key, handler);
+        logger.debug(`[MusicProcessor] Registered music handler: ${key}`);
+    }
+    /**
+     * Check if a provider has a registered music handler.
+     */
+    static supports(providerName) {
+        if (!providerName) {
+            return false;
+        }
+        return this.handlers.has(providerName.toLowerCase());
+    }
+    /**
+     * List the names of all registered providers.
+     */
+    static listProviders() {
+        return Array.from(this.handlers.keys());
+    }
+    static getHandler(providerName) {
+        return this.handlers.get(providerName.toLowerCase());
+    }
+    static buildSpanAttributes(provider, options) {
+        return {
+            "music.operation": "generate",
+            "music.provider": provider,
+            "music.duration": options.duration,
+            "music.format": options.format,
+            "music.genre": options.genre,
+            "music.mood": options.mood,
+        };
+    }
+    /**
+     * Generate a music track via the registered handler.
+     *
+     * @throws MusicError on registry miss, handler-not-configured, or
+     *         generation failure.
+     */
+    static async generate(provider, options) {
+        const span = SpanSerializer.createSpan(SpanType.MEDIA_GENERATION, "music.generate", this.buildSpanAttributes(provider, options));
+        try {
+            const trimmedPrompt = options.prompt?.trim();
+            if (!trimmedPrompt) {
+                throw new MusicError({
+                    code: MUSIC_ERROR_CODES.PROMPT_REQUIRED,
+                    message: "Music generation requires a non-empty prompt",
+                    category: ErrorCategory.VALIDATION,
+                    severity: ErrorSeverity.LOW,
+                    retriable: false,
+                    context: { provider },
+                });
+            }
+            const handler = this.getHandler(provider);
+            if (!handler) {
+                throw new MusicError({
+                    code: MUSIC_ERROR_CODES.PROVIDER_NOT_SUPPORTED,
+                    message: `Music provider "${provider}" is not registered. Available: ${this.listProviders().join(", ")}`,
+                    category: ErrorCategory.CONFIGURATION,
+                    severity: ErrorSeverity.HIGH,
+                    retriable: false,
+                    context: { provider, available: this.listProviders() },
+                });
+            }
+            if (!handler.isConfigured()) {
+                throw new MusicError({
+                    code: MUSIC_ERROR_CODES.PROVIDER_NOT_CONFIGURED,
+                    message: `Music provider "${provider}" is not configured. Set the required credentials.`,
+                    category: ErrorCategory.CONFIGURATION,
+                    severity: ErrorSeverity.HIGH,
+                    retriable: false,
+                    context: { provider },
+                });
+            }
+            // Optional duration validation against per-provider max.
+            if (options.duration !== undefined &&
+                handler.maxDurationSeconds !== undefined &&
+                options.duration > handler.maxDurationSeconds) {
+                throw new MusicError({
+                    code: MUSIC_ERROR_CODES.DURATION_INVALID,
+                    message: `Requested duration (${options.duration}s) exceeds provider maximum (${handler.maxDurationSeconds}s) for "${provider}"`,
+                    category: ErrorCategory.VALIDATION,
+                    severity: ErrorSeverity.MEDIUM,
+                    retriable: false,
+                    context: {
+                        provider,
+                        requested: options.duration,
+                        maximum: handler.maxDurationSeconds,
+                    },
+                });
+            }
+            logger.debug(`[MusicProcessor] Starting music generation with provider: ${provider}`);
+            const result = await handler.generate({
+                ...options,
+                prompt: trimmedPrompt,
+            });
+            const ended = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(ended);
+            logger.info(`[MusicProcessor] Generated ${result.size} bytes (${provider})`);
+            return result;
+        }
+        catch (err) {
+            const ended = SpanSerializer.endSpan(span, SpanStatus.ERROR, err instanceof Error ? err.message : String(err));
+            getMetricsAggregator().recordSpan(ended);
+            if (err instanceof MusicError) {
+                throw err;
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            throw new MusicError({
+                code: MUSIC_ERROR_CODES.GENERATION_FAILED,
+                message: `Music generation failed for provider "${provider}": ${message}`,
+                category: ErrorCategory.EXECUTION,
+                severity: ErrorSeverity.HIGH,
+                retriable: true,
+                context: {
+                    provider,
+                    duration: options.duration,
+                    format: options.format,
+                    genre: options.genre,
+                    mood: options.mood,
+                    tempo: options.tempo,
+                },
+                originalError: err instanceof Error ? err : undefined,
+            });
+        }
+    }
+}

package/dist/utils/optionsConversion.js

@@ -10,8 +10,9 @@
  */
 export function convertGenerateToStreamOptions(generateOptions) {
     const streamOptions = {
-        // Core input mapping
-        input: generateOptions.input,
+        // Core input mapping — GenerateOptions.input is optional (media-only callers
+        // may omit it); fall back to an empty object so StreamOptions stays valid.
+        input: generateOptions.input ?? {},
         // Provider and model settings
         provider: generateOptions.provider,
         model: generateOptions.model,

package/dist/utils/parameterValidation.js

@@ -229,10 +229,20 @@ export function validateTextGenerationOptions(options) {
         return { isValid: false, errors, warnings, suggestions };
     }
     const opts = options;
-    // Validate prompt
-    const promptError = validateRequiredString(opts.prompt, "prompt", 1);
-    if (promptError) {
-        errors.push(promptError);
+    // Modality dispatch (output.mode === 'video' | 'avatar' | 'music') carries
+    // its own typed prompt inside `output.{video|avatar|music}`. The textual
+    // prompt is irrelevant for these modes, so skip the prompt-required check.
+    // Same exemption applies for STT-driven flows where `input.text` is
+    // synthesized from transcription downstream.
+    const outputMode = opts.output?.mode;
+    const isMediaModalityMode = outputMode === "video" || outputMode === "avatar" || outputMode === "music";
+    const hasSttAudio = !!opts.stt?.audio;
+    // Validate prompt (skipped for modality dispatch + STT-driven flows)
+    if (!isMediaModalityMode && !hasSttAudio) {
+        const promptError = validateRequiredString(opts.prompt, "prompt", 1);
+        if (promptError) {
+            errors.push(promptError);
+        }
     }
     if (opts.prompt && opts.prompt.length > SYSTEM_LIMITS.MAX_PROMPT_LENGTH) {
         errors.push(new ValidationError(`Prompt too large: ${opts.prompt.length} characters (max: ${SYSTEM_LIMITS.MAX_PROMPT_LENGTH})`, "prompt", "MAX_LENGTH", [