@juspay/neurolink 9.64.0 → 9.65.1

package/dist/factories/providerRegistry.js

@@ -1,6 +1,6 @@
 import { ProviderFactory } from "./providerFactory.js";
 import { logger } from "../utils/logger.js";
-import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, MistralModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, } from "../constants/enums.js";
+import { AIProviderName, GoogleAIModels, OpenAIModels, AnthropicModels, VertexModels, MistralModels, OllamaModels, LiteLLMModels, HuggingFaceModels, DeepSeekModels, NvidiaNimModels, OpenRouterModels, XaiModels, GroqModels, CohereModels, TogetherAIModels, FireworksModels, PerplexityModels, CloudflareModels, VoyageModels, JinaModels, StabilityModels, IdeogramModels, RecraftModels, ReplicateModels, } from "../constants/enums.js";
 /**
  * Provider Registry - registers all providers with the factory
  * This is where we migrate providers one by one to the new pattern
@@ -136,10 +136,12 @@ export class ProviderRegistry {
                 const { OpenRouterProvider } = await import("../providers/openRouter.js");
                 return new OpenRouterProvider(modelName, sdk, undefined, openrouterCreds);
             }, 
-            // Default updated from claude-3-5-sonnet (sunset by OpenRouter)
-            // to claude-sonnet-4.5. Must match getDefaultOpenRouterModel()
-            // in src/lib/providers/openRouter.ts.
-            process.env.OPENROUTER_MODEL || "anthropic/claude-sonnet-4.5", ["openrouter", "or"]);
+            // OpenRouter retired `anthropic/claude-3-5-sonnet` in late 2025 — see
+            // src/lib/providers/openRouter.ts and src/lib/utils/modelChoices.ts
+            // for the rationale. Keep the three defaults aligned at the new
+            // model (claude-sonnet-4.5) so the registry doesn't override the
+            // provider's getDefault.
+            process.env.OPENROUTER_MODEL || OpenRouterModels.CLAUDE_SONNET_4_5, ["openrouter", "or"]);
             // Register Amazon SageMaker provider
             ProviderFactory.registerProvider(AIProviderName.SAGEMAKER, async (modelName, _providerName, _sdk, region, credentials) => {
                 const sagemakerCreds = credentials;
@@ -170,6 +172,86 @@ export class ProviderRegistry {
                 const { LlamaCppProvider } = await import("../providers/llamaCpp.js");
                 return new LlamaCppProvider(modelName, sdk, undefined, llamaCppCreds);
             }, process.env.LLAMACPP_MODEL || undefined, ["llamacpp", "llama.cpp", "llama-cpp"]);
+            // Register xAI Grok provider
+            ProviderFactory.registerProvider(AIProviderName.XAI, async (modelName, _providerName, sdk, _region, credentials) => {
+                const xaiCreds = credentials;
+                const { XaiProvider } = await import("../providers/xai.js");
+                return new XaiProvider(modelName, sdk, undefined, xaiCreds);
+            }, process.env.XAI_MODEL || XaiModels.GROK_3, ["xai", "grok"]);
+            // Register Groq provider
+            ProviderFactory.registerProvider(AIProviderName.GROQ, async (modelName, _providerName, sdk, _region, credentials) => {
+                const groqCreds = credentials;
+                const { GroqProvider } = await import("../providers/groq.js");
+                return new GroqProvider(modelName, sdk, undefined, groqCreds);
+            }, process.env.GROQ_MODEL || GroqModels.LLAMA_3_3_70B_VERSATILE, ["groq"]);
+            // Register Cohere provider
+            ProviderFactory.registerProvider(AIProviderName.COHERE, async (modelName, _providerName, sdk, _region, credentials) => {
+                const cohereCreds = credentials;
+                const { CohereProvider } = await import("../providers/cohere.js");
+                return new CohereProvider(modelName, sdk, undefined, cohereCreds);
+            }, process.env.COHERE_MODEL || CohereModels.COMMAND_R_PLUS, ["cohere"]);
+            // Register Together AI provider
+            ProviderFactory.registerProvider(AIProviderName.TOGETHER_AI, async (modelName, _providerName, sdk, _region, credentials) => {
+                const togetherCreds = credentials;
+                const { TogetherAIProvider } = await import("../providers/togetherAi.js");
+                return new TogetherAIProvider(modelName, sdk, undefined, togetherCreds);
+            }, process.env.TOGETHER_MODEL ||
+                TogetherAIModels.LLAMA_3_3_70B_INSTRUCT_TURBO, ["together-ai", "together"]);
+            // Register Fireworks AI provider
+            ProviderFactory.registerProvider(AIProviderName.FIREWORKS, async (modelName, _providerName, sdk, _region, credentials) => {
+                const fireworksCreds = credentials;
+                const { FireworksProvider } = await import("../providers/fireworks.js");
+                return new FireworksProvider(modelName, sdk, undefined, fireworksCreds);
+            }, process.env.FIREWORKS_MODEL || FireworksModels.DEEPSEEK_V4_PRO, ["fireworks"]);
+            // Register Perplexity provider
+            ProviderFactory.registerProvider(AIProviderName.PERPLEXITY, async (modelName, _providerName, sdk, _region, credentials) => {
+                const perplexityCreds = credentials;
+                const { PerplexityProvider } = await import("../providers/perplexity.js");
+                return new PerplexityProvider(modelName, sdk, undefined, perplexityCreds);
+            }, process.env.PERPLEXITY_MODEL || PerplexityModels.SONAR, ["perplexity", "pplx"]);
+            // Register Cloudflare Workers AI provider
+            ProviderFactory.registerProvider(AIProviderName.CLOUDFLARE, async (modelName, _providerName, sdk, _region, credentials) => {
+                const cloudflareCreds = credentials;
+                const { CloudflareProvider } = await import("../providers/cloudflare.js");
+                return new CloudflareProvider(modelName, sdk, undefined, cloudflareCreds);
+            }, process.env.CLOUDFLARE_MODEL || CloudflareModels.LLAMA_3_3_70B_FAST, ["cloudflare", "workers-ai", "cf-ai"]);
+            // Register Voyage AI embeddings provider
+            ProviderFactory.registerProvider(AIProviderName.VOYAGE, async (modelName, _providerName, sdk, _region, credentials) => {
+                const voyageCreds = credentials;
+                const { VoyageProvider } = await import("../providers/voyage.js");
+                return new VoyageProvider(modelName, sdk, undefined, voyageCreds);
+            }, process.env.VOYAGE_MODEL || VoyageModels.VOYAGE_3_5, ["voyage", "voyage-ai"]);
+            // Register Jina AI embeddings + reranking provider
+            ProviderFactory.registerProvider(AIProviderName.JINA, async (modelName, _providerName, sdk, _region, credentials) => {
+                const jinaCreds = credentials;
+                const { JinaProvider } = await import("../providers/jina.js");
+                return new JinaProvider(modelName, sdk, undefined, jinaCreds);
+            }, process.env.JINA_MODEL || JinaModels.JINA_EMBEDDINGS_V3, ["jina", "jina-ai"]);
+            // Register Stability AI image-gen provider
+            ProviderFactory.registerProvider(AIProviderName.STABILITY, async (modelName, _providerName, sdk, _region, credentials) => {
+                const stabilityCreds = credentials;
+                const { StabilityProvider } = await import("../providers/stability.js");
+                return new StabilityProvider(modelName, sdk, undefined, stabilityCreds);
+            }, process.env.STABILITY_MODEL || StabilityModels.STABLE_IMAGE_ULTRA, ["stability", "stability-ai", "sd"]);
+            // Register Ideogram image-gen provider
+            ProviderFactory.registerProvider(AIProviderName.IDEOGRAM, async (modelName, _providerName, sdk, _region, credentials) => {
+                const ideogramCreds = credentials;
+                const { IdeogramProvider } = await import("../providers/ideogram.js");
+                return new IdeogramProvider(modelName, sdk, undefined, ideogramCreds);
+            }, process.env.IDEOGRAM_MODEL || IdeogramModels.IDEOGRAM_V3, ["ideogram"]);
+            // Register Replicate LLM provider (multi-modal — also serves video /
+            // avatar / music handlers via dedicated processors registered below)
+            ProviderFactory.registerProvider(AIProviderName.REPLICATE, async (modelName, _providerName, sdk, _region, credentials) => {
+                const replicateCreds = credentials;
+                const { ReplicateProvider } = await import("../providers/replicate.js");
+                return new ReplicateProvider(modelName, sdk, undefined, replicateCreds);
+            }, process.env.REPLICATE_MODEL || ReplicateModels.LLAMA_3_70B_INSTRUCT, ["replicate"]);
+            // Register Recraft image-gen provider
+            ProviderFactory.registerProvider(AIProviderName.RECRAFT, async (modelName, _providerName, sdk, _region, credentials) => {
+                const recraftCreds = credentials;
+                const { RecraftProvider } = await import("../providers/recraft.js");
+                return new RecraftProvider(modelName, sdk, undefined, recraftCreds);
+            }, process.env.RECRAFT_MODEL || RecraftModels.RECRAFT_V3, ["recraft"]);
             logger.debug("All AI providers registered successfully");
             // ===== TTS HANDLER REGISTRATION =====
             try {
@@ -307,6 +389,121 @@ export class ProviderRegistry {
                         : String(realtimeError),
                 });
             }
+            // ===== VIDEO HANDLER REGISTRATION =====
+            try {
+                const { VideoProcessor } = await import("../utils/videoProcessor.js");
+                try {
+                    const { VertexVideoHandler } = await import("../adapters/video/vertexVideoHandler.js");
+                    VideoProcessor.registerHandler("vertex", new VertexVideoHandler());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] vertex video registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { KlingVideoHandler } = await import("../adapters/video/klingVideoHandler.js");
+                    VideoProcessor.registerHandler("kling", new KlingVideoHandler());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] kling video registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { RunwayVideoHandler } = await import("../adapters/video/runwayVideoHandler.js");
+                    VideoProcessor.registerHandler("runway", new RunwayVideoHandler());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] runway video registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { ReplicateVideoHandler } = await import("../adapters/video/replicateVideoHandler.js");
+                    VideoProcessor.registerHandler("replicate", new ReplicateVideoHandler());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] replicate video registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                logger.debug("Video handlers registered");
+            }
+            catch (err) {
+                logger.warn(`[ProviderRegistry] video registration block failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // ===== AVATAR HANDLER REGISTRATION =====
+            try {
+                const { AvatarProcessor } = await import("../utils/avatarProcessor.js");
+                try {
+                    const { DIDAvatar } = await import("../avatar/providers/DIDAvatar.js");
+                    AvatarProcessor.registerHandler("d-id", new DIDAvatar());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] d-id avatar registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { ReplicateAvatar } = await import("../avatar/providers/ReplicateAvatar.js");
+                    const replicateAvatar = new ReplicateAvatar();
+                    AvatarProcessor.registerHandler("replicate", replicateAvatar);
+                    AvatarProcessor.registerHandler("musetalk", replicateAvatar);
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] replicate avatar registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { HeyGenAvatar } = await import("../avatar/providers/HeyGenAvatar.js");
+                    AvatarProcessor.registerHandler("heygen", new HeyGenAvatar());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] heygen avatar registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                logger.debug("Avatar handlers registered");
+            }
+            catch (avatarError) {
+                logger.warn("Failed to register Avatar handlers - Avatar functionality will be unavailable", {
+                    error: avatarError instanceof Error
+                        ? avatarError.message
+                        : String(avatarError),
+                });
+            }
+            // ===== MUSIC HANDLER REGISTRATION =====
+            try {
+                const { MusicProcessor } = await import("../utils/musicProcessor.js");
+                try {
+                    const { BeatovenMusic } = await import("../music/providers/BeatovenMusic.js");
+                    MusicProcessor.registerHandler("beatoven", new BeatovenMusic());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] beatoven music registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { ReplicateMusic } = await import("../music/providers/ReplicateMusic.js");
+                    const replicateMusic = new ReplicateMusic();
+                    MusicProcessor.registerHandler("replicate", replicateMusic);
+                    MusicProcessor.registerHandler("musicgen", replicateMusic);
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] replicate music registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { ElevenLabsMusic } = await import("../music/providers/ElevenLabsMusic.js");
+                    const elevenLabsMusic = new ElevenLabsMusic();
+                    MusicProcessor.registerHandler("elevenlabs-music", elevenLabsMusic);
+                    MusicProcessor.registerHandler("elevenlabs-sound", elevenLabsMusic);
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] elevenlabs-music registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                try {
+                    const { LyriaMusic } = await import("../music/providers/LyriaMusic.js");
+                    MusicProcessor.registerHandler("lyria", new LyriaMusic());
+                }
+                catch (err) {
+                    logger.debug(`[ProviderRegistry] lyria music registration skipped: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                logger.debug("Music handlers registered");
+            }
+            catch (musicError) {
+                logger.warn("Failed to register Music handlers - Music functionality will be unavailable", {
+                    error: musicError instanceof Error
+                        ? musicError.message
+                        : String(musicError),
+                });
+            }
             // Mark registered ONLY after all blocks (AI + voice) attempted, so a
             // subsequent registerAllProviders() call does not short-circuit when an
             // optional handler block silently failed.

package/dist/features/ppt/contentPlanner.js

@@ -374,25 +374,53 @@ function validateContentPlan(plan, expectedSlides) {
 }
 /**
  * Parse AI response to extract JSON
- * Handles markdown code blocks and raw JSON
+ * Handles markdown code blocks (anywhere in the response), preambles like
+ * "Here is the JSON:", and raw JSON.
  */
 function parseAIResponse(content) {
-    let jsonString = content.trim();
-    // Strip markdown code fences if present
-    if (jsonString.startsWith("```")) {
-        jsonString = jsonString
-            .replace(/^```(?:json)?\s*\n?/, "")
-            .replace(/\n?```\s*$/, "");
+    const trimmed = content.trim();
+    const candidates = [];
+    // 1) Extract first ```json ... ``` block from anywhere in the response.
+    const fenceBlock = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fenceBlock && fenceBlock[1]) {
+        candidates.push(fenceBlock[1].trim());
     }
-    try {
-        return JSON.parse(jsonString);
+    // 2) Strict leading-fence strip (legacy behaviour).
+    if (trimmed.startsWith("```")) {
+        candidates.push(trimmed.replace(/^```(?:json)?\s*\n?/, "").replace(/\n?```\s*$/, ""));
     }
-    catch (error) {
-        throw new PPTError(`Failed to parse AI response as JSON: ${error instanceof Error ? error.message : String(error)}`, PPT_ERROR_CODES.INVALID_AI_RESPONSE, {
-            contentPreview: content.substring(0, 500),
-            parseError: error instanceof Error ? error.message : String(error),
-        });
+    // 3) Slice from first '{' or '[' to its matching close — handles preambles
+    //    like "Here is the presentation plan:\n{ ... }".
+    const firstObj = trimmed.indexOf("{");
+    const firstArr = trimmed.indexOf("[");
+    const firstStruct = firstObj === -1
+        ? firstArr
+        : firstArr === -1
+            ? firstObj
+            : Math.min(firstObj, firstArr);
+    if (firstStruct > 0) {
+        const openChar = trimmed[firstStruct];
+        const closeChar = openChar === "{" ? "}" : "]";
+        const lastClose = trimmed.lastIndexOf(closeChar);
+        if (lastClose > firstStruct) {
+            candidates.push(trimmed.slice(firstStruct, lastClose + 1));
+        }
     }
+    // 4) Raw input as last resort.
+    candidates.push(trimmed);
+    const errors = [];
+    for (const candidate of candidates) {
+        try {
+            return JSON.parse(candidate);
+        }
+        catch (err) {
+            errors.push(err instanceof Error ? err.message : String(err));
+        }
+    }
+    throw new PPTError(`Failed to parse AI response as JSON: ${errors[errors.length - 1]}`, PPT_ERROR_CODES.INVALID_AI_RESPONSE, {
+        contentPreview: content.substring(0, 500),
+        parseError: errors.join(" | "),
+    });
 }
 // ============================================================================
 // MAIN CONTENT PLANNING FUNCTION

package/dist/index.d.ts

@@ -45,6 +45,14 @@ export { isAbortError } from "./utils/errorHandling.js";
 export { calculateCost, hasPricing } from "./utils/pricing.js";
 export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
 export { TTSProcessor } from "./utils/ttsProcessor.js";
+export { TTS_ERROR_CODES, TTSError } from "./utils/ttsProcessor.js";
+export { VideoProcessor } from "./utils/videoProcessor.js";
+export { VIDEO_ERROR_CODES, VideoError } from "./utils/videoProcessor.js";
+export { AvatarProcessor } from "./utils/avatarProcessor.js";
+export { AVATAR_ERROR_CODES, AvatarError } from "./utils/avatarProcessor.js";
+export { MusicProcessor } from "./utils/musicProcessor.js";
+export { MUSIC_ERROR_CODES, MusicError } from "./utils/musicProcessor.js";
+export { ProviderRegistry } from "./factories/providerRegistry.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
 export { buildObservabilityConfigFromEnv } from "./utils/observabilityHelpers.js";
@@ -239,7 +247,7 @@ export declare function getTelemetryStatus(): Promise<{
  * });
  * ```
  */
-export { Evaluator, EvaluationAggregator, EvaluatorFactory, getEvaluatorFactory, getEvaluatorRegistry, evaluationErrors, isRetryableEvaluationError, isEvaluationError, createEvaluationFailedError, createParseError, createStrategyNotFoundError, createProviderError, createMaxRetriesExceededError, createBatchEvaluationError, createConfigurationError, contextToErrorContext, createLangfuseAdapter, createMockLangfuseClient, startLangfuseAdapter, createConsoleLoggerHook, createMetricsCollectorHook, ObservabilityHooks, observabilityHooks, pipelineToSpanAttributes, scorerToSpanAttributes, createAndInitializePipeline, createPipeline, EvaluationPipeline, PipelineBuilder, Pipelines, CODE_GENERATION_PIPELINE, COMPREHENSIVE_PIPELINE, CUSTOMER_SUPPORT_PIPELINE, getPreset, getPresetNames, MINIMAL_PIPELINE, QUALITY_PIPELINE, RAG_PIPELINE, SAFETY_PIPELINE, SUMMARIZATION_PIPELINE, BatchStrategy, createBatchStrategy, evaluateBatch, streamBatchEvaluation, createSamplingStrategy, DEFAULT_SAMPLING_CONFIG, SamplingStrategies, SamplingStrategy, createMetricsCollector, globalMetricsCollector, MetricsCollector, createReportGenerator, ReportGenerator, Reports, BaseScorer, DEFAULT_SCORE_SCALE as EVAL_DEFAULT_SCORE_SCALE, composeScorers, createConditionalScorer, createFunctionScorer, createInvertedScorer, createKeywordScorer, createRegexScorer, createScorerMetadata, createSimpleLengthScorer, AnswerRelevancyScorer, createAnswerRelevancyScorer, BaseLLMScorer, DEFAULT_LLM_SCORER_CONFIG, BiasDetectionScorer, createBiasDetectionScorer, ContextPrecisionScorer, createContextPrecisionScorer, ContextRelevancyScorer, createContextRelevancyScorer, createFaithfulnessScorer, FaithfulnessScorer, createHallucinationScorer, HallucinationScorer, createPromptAlignmentScorer, PromptAlignmentScorer, createSummarizationScorer, SummarizationScorer, createToneConsistencyScorer, ToneConsistencyScorer, createToxicityScorer, ToxicityScorer, BaseRuleScorer, DEFAULT_RULE_SCORER_CONFIG, createContentSimilarityScorer, createFormatScorer, FormatScorerPresets, createKeywordCoverageScorer, createLengthScorer, LengthScorerPresets, ScorerBuilder, Scorers, ScorerRegistry, } from "./evaluation/index.js";
+export { Evaluator, EvaluationAggregator, EvaluatorFactory, getEvaluatorFactory, getEvaluatorRegistry, evaluationErrors, isRetryableEvaluationError, isEvaluationError, createEvaluationFailedError, createParseError, createStrategyNotFoundError, createProviderError, createMaxRetriesExceededError, createBatchEvaluationError, createConfigurationError, contextToErrorContext, createLangfuseAdapter, createMockLangfuseClient, startLangfuseAdapter, createConsoleLoggerHook, createMetricsCollectorHook, ObservabilityHooks, observabilityHooks, pipelineToSpanAttributes, scorerToSpanAttributes, createAndInitializePipeline, createPipeline, EvaluationPipeline, PipelineBuilder, Pipelines, CODE_GENERATION_PIPELINE, COMPREHENSIVE_PIPELINE, CUSTOMER_SUPPORT_PIPELINE, getPreset, getPresetNames, MINIMAL_PIPELINE, QUALITY_PIPELINE, RAG_PIPELINE, SAFETY_PIPELINE, SUMMARIZATION_PIPELINE, BatchStrategy, createBatchStrategy, evaluateBatch, streamBatchEvaluation, createSamplingStrategy, DEFAULT_SAMPLING_CONFIG, SamplingStrategies, SamplingStrategy, createMetricsCollector, globalMetricsCollector, MetricsCollector, createReportGenerator, ReportGenerator, Reports, BaseScorer, DEFAULT_SCORE_SCALE as EVAL_DEFAULT_SCORE_SCALE, composeScorers, createConditionalScorer, createFunctionScorer, createInvertedScorer, createKeywordScorer, createRegexScorer, createScorerMetadata, createSimpleLengthScorer, AnswerRelevancyScorer, createAnswerRelevancyScorer, BaseLLMScorer, DEFAULT_LLM_SCORER_CONFIG, BiasDetectionScorer, createBiasDetectionScorer, ContextPrecisionScorer, createContextPrecisionScorer, ContextRelevancyScorer, createContextRelevancyScorer, createFaithfulnessScorer, FaithfulnessScorer, createHallucinationScorer, HallucinationScorer, createPromptAlignmentScorer, PromptAlignmentScorer, createSummarizationScorer, SummarizationScorer, createToneConsistencyScorer, ToneConsistencyScorer, createToxicityScorer, ToxicityScorer, BaseRuleScorer, DEFAULT_RULE_SCORER_CONFIG, createContentSimilarityScorer, createFormatScorer, FormatScorerPresets, createKeywordCoverageScorer, createLengthScorer, LengthScorerPresets, ScorerBuilder, Scorers, ScorerRegistry, RAGASEvaluator, RetryManager, } from "./evaluation/index.js";
 /**
  * Legacy generateText function for backward compatibility.
  *

package/dist/index.js

@@ -71,6 +71,19 @@ export { calculateCost, hasPricing } from "./utils/pricing.js";
 export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
 // TTS utilities
 export { TTSProcessor } from "./utils/ttsProcessor.js";
+export { TTS_ERROR_CODES, TTSError } from "./utils/ttsProcessor.js";
+// Video utilities
+export { VideoProcessor } from "./utils/videoProcessor.js";
+export { VIDEO_ERROR_CODES, VideoError } from "./utils/videoProcessor.js";
+// Avatar / lip-sync utilities
+export { AvatarProcessor } from "./utils/avatarProcessor.js";
+export { AVATAR_ERROR_CODES, AvatarError } from "./utils/avatarProcessor.js";
+// Music utilities
+export { MusicProcessor } from "./utils/musicProcessor.js";
+export { MUSIC_ERROR_CODES, MusicError } from "./utils/musicProcessor.js";
+// Provider registry (for tests, advanced consumers, and tools that need to
+// invoke registerAllProviders() outside of constructing a NeuroLink instance)
+export { ProviderRegistry } from "./factories/providerRegistry.js";
 // Main NeuroLink wrapper class and diagnostic types
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
@@ -386,7 +399,9 @@ AnswerRelevancyScorer, createAnswerRelevancyScorer, BaseLLMScorer, DEFAULT_LLM_S
 // Scorers - Rule-based
 BaseRuleScorer, DEFAULT_RULE_SCORER_CONFIG, createContentSimilarityScorer, createFormatScorer, FormatScorerPresets, createKeywordCoverageScorer, createLengthScorer, LengthScorerPresets, 
 // Scorers - Builder & Registry
-ScorerBuilder, Scorers, ScorerRegistry, } from "./evaluation/index.js";
+ScorerBuilder, Scorers, ScorerRegistry, 
+// RAGAS evaluator + retry manager (legacy + still-supported classes).
+RAGASEvaluator, RetryManager, } from "./evaluation/index.js";
 // ============================================================================
 // BACKWARD COMPATIBILITY: Legacy generateText Function Exports
 // ============================================================================

package/dist/lib/adapters/providerImageAdapter.js

@@ -281,7 +281,7 @@ const VISION_CAPABILITIES = {
     openrouter: [
         // OpenRouter provides access to vision-capable models from multiple providers
         // Anthropic Claude models (via OpenRouter)
-        "anthropic/claude-3-5-sonnet",
+        "anthropic/claude-3.7-sonnet",
         "anthropic/claude-3-5-haiku",
         "anthropic/claude-3-opus",
         "anthropic/claude-3-sonnet",
@@ -474,6 +474,34 @@ const VISION_CAPABILITIES = {
         "qwen2-vl",
         "phi-3-vision",
     ],
+    // xAI: only grok-2-vision is multimodal today
+    xai: ["grok-2-vision-latest"],
+    // Groq: vision models are explicit "*-vision-preview" variants
+    groq: ["llama-3.2-90b-vision-preview", "llama-3.2-11b-vision-preview"],
+    // Cohere: command-r* are text-only (no vision); empty list
+    cohere: [],
+    // Together AI: text-only by default; add vision variants if/when used.
+    "together-ai": [],
+    // Fireworks: vision via Phi-3-Vision and Llama 3.2 vision variants.
+    fireworks: [
+        "accounts/fireworks/models/phi-3-vision-128k-instruct",
+        "accounts/fireworks/models/llama-v3p2-90b-vision-instruct",
+        "accounts/fireworks/models/llama-v3p2-11b-vision-instruct",
+    ],
+    // Perplexity Sonar — text-only with web grounding.
+    perplexity: [],
+    // Cloudflare: explicit vision variants only.
+    cloudflare: ["@cf/meta/llama-3.2-11b-vision-instruct"],
+    // Replicate: vision capability depends on the specific model id.
+    replicate: ["llava", "llama-3.2-vision", "moondream", "qwen2-vl"],
+    // Voyage / Jina — embedding-only, not multimodal in this sense.
+    voyage: [],
+    jina: [],
+    // Stability / Ideogram / Recraft — image-OUTPUT, not image-INPUT.
+    // VISION_CAPABILITIES tracks reference-image input support.
+    stability: [],
+    ideogram: [],
+    recraft: [],
 };
 /**
  * Provider Image Adapter - Smart routing and formatting

package/dist/lib/adapters/replicate/auth.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Replicate Auth Helper
+ *
+ * Resolves the Replicate API token + base URL from per-call overrides,
+ * instance credentials, or env vars. Used by every Replicate-backed
+ * handler (LLM, video, avatar, music) so the auth chain is centralised.
+ *
+ * @module adapters/replicate/auth
+ */
+import type { ReplicateAuth } from "../../types/index.js";
+/**
+ * Resolve Replicate auth from override → env vars.
+ *
+ * Returns `null` when `REPLICATE_API_TOKEN` is missing AND no override is
+ * provided. Handlers' `isConfigured()` check `auth !== null`.
+ *
+ * @param override - per-call or instance-level credentials slice
+ */
+export declare function getReplicateAuth(override?: Partial<ReplicateAuth>): ReplicateAuth | null;

package/dist/lib/adapters/replicate/auth.js

@@ -0,0 +1,33 @@
+/**
+ * Replicate Auth Helper
+ *
+ * Resolves the Replicate API token + base URL from per-call overrides,
+ * instance credentials, or env vars. Used by every Replicate-backed
+ * handler (LLM, video, avatar, music) so the auth chain is centralised.
+ *
+ * @module adapters/replicate/auth
+ */
+const DEFAULT_BASE_URL = "https://api.replicate.com";
+/**
+ * Resolve Replicate auth from override → env vars.
+ *
+ * Returns `null` when `REPLICATE_API_TOKEN` is missing AND no override is
+ * provided. Handlers' `isConfigured()` check `auth !== null`.
+ *
+ * @param override - per-call or instance-level credentials slice
+ */
+export function getReplicateAuth(override) {
+    const apiToken = (override?.apiToken ??
+        process.env.REPLICATE_API_TOKEN ??
+        "").trim();
+    if (!apiToken) {
+        return null;
+    }
+    return {
+        apiToken,
+        baseUrl: (override?.baseUrl ??
+            process.env.REPLICATE_BASE_URL ??
+            DEFAULT_BASE_URL).replace(/\/$/, ""),
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/adapters/replicate/predictionLifecycle.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Replicate Prediction Lifecycle
+ *
+ * Shared async-job helpers used by every Replicate-backed handler. Submits
+ * a prediction, polls until terminal status, downloads the binary output.
+ *
+ * Usage pattern (for handlers — LLM, video, avatar, music):
+ *
+ *   const auth = getReplicateAuth(credentials);
+ *   if (!auth) throw new XxxError({ code: PROVIDER_NOT_CONFIGURED, ... });
+ *   const prediction = await predict(auth, { model, input });
+ *   const buffer = await downloadPredictionOutput(prediction);
+ *
+ * @module adapters/replicate/predictionLifecycle
+ */
+import type { ReplicateAuth, ReplicateCreatePredictionInput, ReplicatePollOptions, ReplicatePrediction } from "../../types/index.js";
+/**
+ * Submit a Replicate prediction. Uses `Prefer: wait=60` so quick
+ * predictions complete in the initial POST and skip polling entirely.
+ */
+export declare function createPrediction(auth: ReplicateAuth, input: ReplicateCreatePredictionInput): Promise<ReplicatePrediction>;
+/**
+ * Poll a Replicate prediction until it reaches a terminal status
+ * (succeeded / failed / canceled) or the total timeout elapses.
+ */
+export declare function pollPrediction(auth: ReplicateAuth, predictionId: string, options?: ReplicatePollOptions): Promise<ReplicatePrediction>;
+/**
+ * Submit + poll. Combines `createPrediction` + `pollPrediction`.
+ *
+ * Uses `Prefer: wait=60` in the submit call so short jobs complete in the
+ * initial POST and bypass polling entirely.
+ */
+export declare function predict(auth: ReplicateAuth, input: ReplicateCreatePredictionInput, options?: ReplicatePollOptions): Promise<ReplicatePrediction>;
+/**
+ * Download a Replicate prediction's binary output.
+ *
+ * Replicate models return either a single URL string or an array of URL
+ * strings (multi-output models). For models that return base64 directly,
+ * use a model-specific helper instead.
+ *
+ * @param prediction  The completed prediction to download.
+ * @param maxBytes    Maximum bytes allowed. Defaults to {@link MAX_VIDEO_BYTES}
+ *                    (256 MiB). Pass {@link MAX_AUDIO_BYTES} for music/TTS
+ *                    outputs or {@link MAX_IMAGE_BYTES} for image outputs.
+ */
+export declare function downloadPredictionOutput(prediction: ReplicatePrediction, maxBytes?: number): Promise<Buffer>;