@juspay/neurolink 9.64.0 → 9.65.0

package/dist/lib/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/lib/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/lib/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/lib/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/middleware/builtin/lifecycle.js

@@ -10,6 +10,31 @@
 import { logger } from "../../utils/logger.js";
 import { isRecoverableError } from "../../utils/errorHandling.js";
 import { fireOnErrorOnce } from "../../utils/lifecycleCallbacks.js";
+/**
+ * Normalize a thrown value to an `Error` while preserving structured
+ * fields (`code`, `status`, `statusCode`, `retryAfter`, `details`,
+ * `cause`, etc.) that downstream retry logic and SDK callers depend on.
+ *
+ * Previously the lifecycle middleware did
+ * `error instanceof Error ? error : new Error(String(error))`, which
+ * silently dropped every custom property on non-Error throws — so a
+ * provider's `{ code: "RATE_LIMITED", retryAfter: 30 }` rejection
+ * surfaced to consumers as a bare `Error("[object Object]")`.
+ */
+function normalizeToError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (typeof error === "object" && error !== null) {
+        const obj = error;
+        const msg = typeof obj.message === "string" ? obj.message : String(error);
+        // Object.assign keeps Error's prototype chain (including the
+        // captured stack from this synthetic Error's construction) while
+        // copying enumerable fields from the original throw.
+        return Object.assign(new Error(msg), obj);
+    }
+    return new Error(String(error));
+}
 export function createLifecycleMiddleware(config = {}) {
     const metadata = {
         id: "lifecycle",
@@ -51,13 +76,18 @@ export function createLifecycleMiddleware(config = {}) {
                 return result;
             }
             catch (error) {
-                const err = error instanceof Error ? error : new Error(String(error));
-                fireOnErrorOnce(config.onError, error, {
+                const err = normalizeToError(error);
+                // fireOnErrorOnce stamps a Symbol on `err` so the SDK-level catch
+                // in neurolink.ts (and baseProvider.handleProviderError) skips
+                // its own onError fire for the same logical failure.
+                fireOnErrorOnce(config.onError, err, {
                     error: err,
                     duration: Date.now() - startTime,
                     recoverable: isRecoverableError(err),
                 });
-                throw error;
+                // Rethrow the normalized err (not the raw `error`) so the
+                // fired-mark and any preserved structured fields propagate.
+                throw err;
             }
         },
         wrapStream: async ({ doStream, }) => {
@@ -93,13 +123,13 @@ export function createLifecycleMiddleware(config = {}) {
                             controller.enqueue(chunk);
                         }
                         catch (error) {
-                            const err = error instanceof Error ? error : new Error(String(error));
-                            fireOnErrorOnce(config.onError, error, {
+                            const err = normalizeToError(error);
+                            fireOnErrorOnce(config.onError, err, {
                                 error: err,
                                 duration: Date.now() - startTime,
                                 recoverable: isRecoverableError(err),
                             });
-                            throw error;
+                            throw err;
                         }
                     },
                     flush() {
@@ -125,13 +155,13 @@ export function createLifecycleMiddleware(config = {}) {
                 };
             }
             catch (error) {
-                const err = error instanceof Error ? error : new Error(String(error));
-                fireOnErrorOnce(config.onError, error, {
+                const err = normalizeToError(error);
+                fireOnErrorOnce(config.onError, err, {
                     error: err,
                     duration: Date.now() - startTime,
                     recoverable: isRecoverableError(err),
                 });
-                throw error;
+                throw err;
             }
         },
     };

package/dist/lib/music/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Music Module — Music Generation Integration for NeuroLink
+ *
+ * Provides music-generation capability across providers (Beatoven,
+ * ElevenLabs Music, Lyria, Replicate-hosted MusicGen / Riffusion).
+ *
+ * Use `MusicProcessor.generate(provider, options)` to dispatch to the
+ * registered handler for `provider`.
+ *
+ * @module music
+ */
+export { MUSIC_ERROR_CODES, MusicError, MusicProcessor, } from "../utils/musicProcessor.js";
+export { BeatovenMusic, BeatovenMusic as BeatovenMusicHandler, } from "./providers/BeatovenMusic.js";

package/dist/lib/music/index.js

@@ -0,0 +1,14 @@
+/**
+ * Music Module — Music Generation Integration for NeuroLink
+ *
+ * Provides music-generation capability across providers (Beatoven,
+ * ElevenLabs Music, Lyria, Replicate-hosted MusicGen / Riffusion).
+ *
+ * Use `MusicProcessor.generate(provider, options)` to dispatch to the
+ * registered handler for `provider`.
+ *
+ * @module music
+ */
+export { MUSIC_ERROR_CODES, MusicError, MusicProcessor, } from "../utils/musicProcessor.js";
+export { BeatovenMusic, BeatovenMusic as BeatovenMusicHandler, } from "./providers/BeatovenMusic.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/music/providers/BeatovenMusic.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Beatoven.ai Music Generation Handler
+ *
+ * Async track-composition API. Submits a compose-track request, polls the
+ * task status, and downloads the resulting audio.
+ *
+ * @module music/providers/BeatovenMusic
+ * @see https://www.beatoven.ai/api-docs
+ */
+import type { MusicAudioFormat, MusicHandler, MusicOptions, MusicResult } from "../../types/index.js";
+/**
+ * Beatoven.ai Music Generation Handler.
+ *
+ * Beatoven is a royalty-free music generation API tuned for
+ * background / cinematic / brand music. Tracks are composed
+ * asynchronously: submit a prompt, poll the task, then download.
+ */
+export declare class BeatovenMusic implements MusicHandler {
+    readonly maxDurationSeconds = 300;
+    readonly supportedFormats: readonly MusicAudioFormat[];
+    readonly supportedGenres: readonly string[];
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey?: string);
+    isConfigured(): boolean;
+    generate(options: MusicOptions): Promise<MusicResult>;
+    private submitCompose;
+    private pollUntilComposed;
+    private fetchTaskStatus;
+    private downloadTrack;
+}