@juspay/neurolink 9.24.0 → 9.25.0

package/dist/features/ppt/presentationOrchestrator.js

@@ -21,6 +21,8 @@ import { SlideGenerator } from "./slideGenerator.js";
 import { PPT_GENERATION_TIMEOUT_MS } from "./constants.js";
 import { logger } from "../../utils/logger.js";
 import { withTimeout, ErrorFactory } from "../../utils/errorHandling.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../../observability/index.js";
+import { getMetricsAggregator } from "../../observability/index.js";
 import { generateOutputPath, ensureOutputDirectory, normalizeLogoConfig, getLayoutName, getFailureStage, toError, } from "./utils.js";
 // ============================================================================
 // MAIN ORCHESTRATION FUNCTION
@@ -48,6 +50,13 @@ import { generateOutputPath, ensureOutputDirectory, normalizeLogoConfig, getLayo
  * ```
  */
 export async function generatePresentation(options) {
+    const span = SpanSerializer.createSpan(SpanType.PPT_GENERATION, "ppt.orchestrate", {
+        "ppt.operation": "orchestrate",
+        "ppt.slideCount": options.context.pages,
+        "ppt.theme": typeof options.context.theme === "string"
+            ? options.context.theme
+            : "custom",
+    });
     const state = {
         startTime: Date.now(),
         contentPlan: null,
@@ -73,6 +82,12 @@ export async function generatePresentation(options) {
         ErrorFactory.toolTimeout("contentPlanning", PPT_GENERATION_TIMEOUT_MS / 2));
         // Post-process: ensure title and thank-you slides
         state.contentPlan = postProcessPlan(planResult);
+        // Update span attributes with post-processed plan values (AI may have changed slide count/theme)
+        span.attributes["ppt.slideCount"] = state.contentPlan.totalSlides;
+        span.attributes["ppt.theme"] =
+            typeof state.contentPlan.theme === "string"
+                ? state.contentPlan.theme
+                : "custom";
         logger.info("[PresentationOrchestrator] Content plan ready", {
             title: state.contentPlan.title,
             totalSlides: state.contentPlan.totalSlides,
@@ -163,6 +178,9 @@ export async function generatePresentation(options) {
         // =========================================================================
         // STEP 5: Return Result
         // =========================================================================
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+        getMetricsAggregator().recordSpan(endedSpan);
+        neurolink?.recordMetricsSpan(endedSpan);
         // Use values from content plan (AI may have chosen them if "AI will decide" was passed)
         const finalTheme = state.contentPlan?.theme || context.theme;
         const finalAudience = state.contentPlan?.audience || context.audience;
@@ -185,6 +203,11 @@ export async function generatePresentation(options) {
         };
     }
     catch (error) {
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR);
+        endedSpan.statusMessage =
+            error instanceof Error ? error.message : String(error);
+        getMetricsAggregator().recordSpan(endedSpan);
+        neurolink?.recordMetricsSpan(endedSpan);
         // Re-throw PPTError as-is
         if (error instanceof PPTError) {
             logger.error("[PresentationOrchestrator] Generation failed", {

package/dist/features/ppt/slideGenerator.js

@@ -19,6 +19,8 @@ import { SLIDE_DIMENSIONS } from "./types.js";
 import { getTheme, isImageSlideType, enhanceImagePrompt, IMAGE_GENERATION_TIMEOUT_MS, MAX_CONCURRENT_IMAGE_GENERATIONS, } from "./constants.js";
 import { logger } from "../../utils/logger.js";
 import { withTimeout, ErrorFactory, NeuroLinkError, } from "../../utils/errorHandling.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../../observability/index.js";
+import { getMetricsAggregator } from "../../observability/index.js";
 import { NeuroLink } from "../../neurolink.js";
 import { LAYOUT_POSITIONS, renderTitleSlide, renderSectionHeaderSlide, renderThankYouSlide, renderContentSlide, renderImageSlide, renderTwoColumnSlide, renderThreeColumnSlide, renderQuoteSlide, renderStatisticsSlide, renderChartSlide, renderTableSlide, renderTimelineSlide, renderProcessFlowSlide, renderComparisonSlide, renderFeaturesSlide, renderTeamSlide, renderConclusionSlide, renderDashboardSlide, renderMixedContentSlide, renderStatsGridSlide, renderIconGridSlide, } from "./slideRenderers.js";
 // ============================================================================
@@ -86,6 +88,11 @@ export class SlideGenerator {
      * Generate a single complete slide
      */
     async generateSlide(slideSchema) {
+        const span = SpanSerializer.createSpan(SpanType.PPT_GENERATION, "ppt.generateSlide", {
+            "ppt.operation": "generateSlide",
+            "ppt.slideIndex": slideSchema.slideNumber,
+            "ppt.theme": this.theme.name,
+        });
         const startTime = Date.now();
         try {
             let imageBuffer;
@@ -126,6 +133,8 @@ export class SlideGenerator {
                 hasImage: !!imageBuffer,
                 generationTime,
             });
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
             return {
                 slideNumber: slideSchema.slideNumber,
                 schema: slideSchema,
@@ -135,6 +144,10 @@ export class SlideGenerator {
             };
         }
         catch (error) {
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR);
+            endedSpan.statusMessage =
+                error instanceof Error ? error.message : String(error);
+            getMetricsAggregator().recordSpan(endedSpan);
             const err = error instanceof NeuroLinkError
                 ? error
                 : ErrorFactory.toolExecutionFailed("slideGenerator", error instanceof Error ? error : new Error(String(error)));

package/dist/features/ppt/slideRenderers.d.ts

@@ -6,7 +6,7 @@
  *
  * @module presentation/slideRenderers
  */
-import type { SlideContent, SlideLayout, SlideType, PresentationTheme, BulletPoint, PptxChartName, PptxSlide, BackgroundStyle, RenderContentSlideOptions, ColumnData } from "./types.js";
+import type { BackgroundStyle, BulletPoint, ColumnData, PptxChartName, PptxSlide, PresentationTheme, RenderContentSlideOptions, SlideContent, SlideLayout, SlideType } from "./types.js";
 export declare const LAYOUT_POSITIONS: {
     margin: {
         x: number;

package/dist/features/ppt/slideRenderers.js

@@ -6,9 +6,9 @@
  *
  * @module presentation/slideRenderers
  */
-import { getSlideTypeFormatting, getBulletOptions } from "./constants.js";
 import { logger } from "../../utils/logger.js";
-import { validateImageBuffer, bufferToDataUrl, parseMarkdownText, hasMarkdownFormatting, createFormattedTextProps, calculateFontSize, } from "./utils.js";
+import { getBulletOptions, getSlideTypeFormatting } from "./constants.js";
+import { bufferToDataUrl, calculateFontSize, createFormattedTextProps, hasMarkdownFormatting, parseMarkdownText, validateImageBuffer, } from "./utils.js";
 // ============================================================================
 // LAYOUT POSITIONS
 // ============================================================================
@@ -986,9 +986,11 @@ export function renderThankYouSlide(slide, title, content, theme, imageBuffer) {
                 fit: DEFAULT_TEXT_FIT,
             });
         }
-        if (content.contactInfo.social && content.contactInfo.social.length > 0) {
+        if (content.contactInfo.social &&
+            Array.isArray(content.contactInfo.social) &&
+            content.contactInfo.social.length > 0) {
             const socialText = content.contactInfo.social
-                .map((s) => `${s.platform}: ${s.handle}`)
+                .map((s) => `${s.platform || ""}: ${s.handle || ""}`)
                 .join("   •   ");
             slide.addText(socialText, {
                 x: 0.5,

package/dist/features/ppt/slideTypeInference.d.ts

@@ -9,7 +9,7 @@
  * This helps ensure consistent slide rendering when AI doesn't explicitly
  * specify a slide type, or when we want to normalize AI responses.
  */
-import type { SlideType, BulletStyle, BulletPoint, SlideContent } from "./types.js";
+import type { BulletPoint, BulletStyle, SlideContent, SlideType } from "./types.js";
 /**
  * Infer slide type and bullet style from title text
  */

package/dist/features/ppt/slideTypeInference.js

@@ -20,13 +20,13 @@ const TITLE_KEYWORD_PATTERNS = [
     // Agenda / Table of Contents - numbered list
     {
         patterns: [
-            /^agenda$/i,
-            /^table\s+of\s+contents$/i,
-            /^outline$/i,
-            /^overview$/i,
-            /^what\s+we('ll)?\s+cover$/i,
-            /^today('s)?\s+topics?$/i,
-            /^session\s+outline$/i,
+            /\bagenda\b/i,
+            /\btable\s+of\s+contents\b/i,
+            /\boutline\b/i,
+            /\boverview\b/i,
+            /\bwhat\s+we('ll)?\s+cover\b/i,
+            /\btoday('s)?\s+topics?\b/i,
+            /\bsession\s+outline\b/i,
         ],
         slideType: "agenda",
         bulletStyle: "number",
@@ -34,18 +34,18 @@ const TITLE_KEYWORD_PATTERNS = [
     // Conclusion / Summary - checkmark
     {
         patterns: [
-            /^conclusion$/i,
-            /^summary$/i,
-            /^key\s+takeaways?$/i,
-            /^takeaways?$/i,
-            /^recap$/i,
-            /^in\s+summary$/i,
-            /^what\s+we('ve)?\s+learned$/i,
-            /^main\s+points?$/i,
-            /^key\s+points?$/i,
-            /^highlights?$/i,
-            /^achievements?$/i,
-            /^accomplishments?$/i,
+            /\bconclusion\b/i,
+            /\bsummary\b/i,
+            /\bkey\s+takeaways?\b/i,
+            /\btakeaways?\b/i,
+            /\brecap\b/i,
+            /\bin\s+summary\b/i,
+            /\bwhat\s+we('ve)?\s+learned\b/i,
+            /\bmain\s+points?\b/i,
+            /\bkey\s+points?\b/i,
+            /\bhighlights?\b/i,
+            /\bachievements?\b/i,
+            /\baccomplishments?\b/i,
         ],
         slideType: "conclusion",
         bulletStyle: "checkmark",
@@ -53,15 +53,15 @@ const TITLE_KEYWORD_PATTERNS = [
     // Closing / Thank You - checkmark
     {
         patterns: [
-            /^thank\s+you$/i,
-            /^thanks?$/i,
-            /^questions?\??$/i,
-            /^q\s*&\s*a$/i,
-            /^contact(\s+us)?$/i,
-            /^next\s+steps?$/i,
-            /^action\s+items?$/i,
-            /^let('s)?\s+connect$/i,
-            /^get\s+(in\s+)?touch$/i,
+            /\bthank\s+you\b/i,
+            /\bthanks?\b/i,
+            /\bquestions?\b\??/i,
+            /\bq\s*&\s*a\b/i,
+            /\bcontact(\s+us)?\b/i,
+            /\bnext\s+steps?\b/i,
+            /\baction\s+items?\b/i,
+            /\blet('s)?\s+connect\b/i,
+            /\bget\s+(in\s+)?touch\b/i,
         ],
         slideType: "closing",
         bulletStyle: "checkmark",
@@ -69,14 +69,15 @@ const TITLE_KEYWORD_PATTERNS = [
     // Comparison - arrow bullets
     {
         patterns: [
-            /^comparison$/i,
-            /^vs\.?$/i,
-            /^versus$/i,
-            /^before\s+(and|&|vs\.?)\s+after$/i,
-            /^pros?\s+(and|&|vs\.?)\s+cons?$/i,
-            /^advantages?\s+(and|&|vs\.?)\s+disadvantages?$/i,
-            /^benefits?\s+(and|&|vs\.?)\s+risks?$/i,
-            /^old\s+vs\.?\s+new$/i,
+            /\bcomparison\b/i,
+            /\bcompare\b/i,
+            /\bvs\.?\b/i,
+            /\bversus\b/i,
+            /\bbefore\s+(and|&|vs\.?)\s+after\b/i,
+            /\bpros?\s+(and|&|vs\.?)\s+cons?\b/i,
+            /\badvantages?\s+(and|&|vs\.?)\s+disadvantages?\b/i,
+            /\bbenefits?\s+(and|&|vs\.?)\s+risks?\b/i,
+            /\bold\s+vs\.?\s+new\b/i,
         ],
         slideType: "comparison",
         bulletStyle: "arrow",
@@ -84,15 +85,16 @@ const TITLE_KEYWORD_PATTERNS = [
     // Process / Steps - numbered
     {
         patterns: [
-            /^process$/i,
-            /^steps?$/i,
-            /^how\s+to\b/i,
-            /^workflow$/i,
-            /^procedure$/i,
-            /^methodology$/i,
-            /^\d+\s+steps?\s+to\b/i,
-            /^implementation\s+steps?$/i,
-            /^getting\s+started$/i,
+            /\bprocess\b/i,
+            /\bsteps?\b/i,
+            /\bstep[\s-]+by[\s-]+step\b/i,
+            /\bhow\s+to\b/i,
+            /\bworkflow\b/i,
+            /\bprocedure\b/i,
+            /\bmethodology\b/i,
+            /\d+\s+steps?\s+to\b/i,
+            /\bimplementation\s+steps?\b/i,
+            /\bgetting\s+started\b/i,
         ],
         slideType: "numbered-list",
         bulletStyle: "number",
@@ -100,21 +102,21 @@ const TITLE_KEYWORD_PATTERNS = [
     // Features / Benefits - disc (but could be checkmark for benefits)
     {
         patterns: [
-            /^features?$/i,
-            /^capabilities?$/i,
-            /^what\s+(we|it)\s+offers?$/i,
-            /^our\s+offerings?$/i,
+            /\bfeatures?\b/i,
+            /\bcapabilities?\b/i,
+            /\bwhat\s+(we|it)\s+offers?\b/i,
+            /\bour\s+offerings?\b/i,
         ],
         slideType: "features",
         bulletStyle: "disc",
     },
     {
         patterns: [
-            /^benefits?$/i,
-            /^advantages?$/i,
-            /^why\s+choose\b/i,
-            /^reasons?\s+to\b/i,
-            /^value\s+proposition$/i,
+            /\bbenefits?\b/i,
+            /\badvantages?\b/i,
+            /\bwhy\s+choose\b/i,
+            /\breasons?\s+to\b/i,
+            /\bvalue\s+proposition\b/i,
         ],
         slideType: "content",
         bulletStyle: "checkmark",
@@ -122,12 +124,12 @@ const TITLE_KEYWORD_PATTERNS = [
     // Goals / Objectives - checkmark
     {
         patterns: [
-            /^goals?$/i,
-            /^objectives?$/i,
-            /^targets?$/i,
-            /^aims?$/i,
-            /^our\s+mission$/i,
-            /^what\s+we\s+aim\s+for$/i,
+            /\bgoals?\b/i,
+            /\bobjectives?\b/i,
+            /\btargets?\b/i,
+            /\baims?\b/i,
+            /\bour\s+mission\b/i,
+            /\bwhat\s+we\s+aim\s+for\b/i,
         ],
         slideType: "content",
         bulletStyle: "checkmark",
@@ -135,13 +137,13 @@ const TITLE_KEYWORD_PATTERNS = [
     // Challenges / Risks - arrow
     {
         patterns: [
-            /^challenges?$/i,
-            /^risks?$/i,
-            /^obstacles?$/i,
-            /^barriers?$/i,
-            /^concerns?$/i,
-            /^issues?$/i,
-            /^problems?$/i,
+            /\bchallenges?\b/i,
+            /\brisks?\b/i,
+            /\bobstacles?\b/i,
+            /\bbarriers?\b/i,
+            /\bconcerns?\b/i,
+            /\bissues?\b/i,
+            /\bproblems?\b/i,
         ],
         slideType: "content",
         bulletStyle: "arrow",
@@ -149,12 +151,12 @@ const TITLE_KEYWORD_PATTERNS = [
     // Requirements / Checklist - checkmark
     {
         patterns: [
-            /^requirements?$/i,
-            /^checklist$/i,
-            /^prerequisites?$/i,
-            /^what\s+you\s+need$/i,
-            /^must\s+haves?$/i,
-            /^essentials?$/i,
+            /\brequirements?\b/i,
+            /\bchecklist\b/i,
+            /\bprerequisites?\b/i,
+            /\bwhat\s+you\s+need\b/i,
+            /\bmust\s+haves?\b/i,
+            /\bessentials?\b/i,
         ],
         slideType: "content",
         bulletStyle: "checkmark",

package/dist/files/fileTools.d.ts

@@ -338,10 +338,10 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
     }, "strip", z.ZodTypeAny, {
         file_id: string;
         format?: "text" | "summary" | "detailed" | undefined;
+        end_time?: number | undefined;
+        start_time?: number | undefined;
         sheet?: string | undefined;
         columns?: string[] | undefined;
-        start_time?: number | undefined;
-        end_time?: number | undefined;
         frame_count?: number | undefined;
         pages?: number[] | undefined;
         page_range?: {
@@ -356,10 +356,10 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
     }, {
         file_id: string;
         format?: "text" | "summary" | "detailed" | undefined;
+        end_time?: number | undefined;
+        start_time?: number | undefined;
         sheet?: string | undefined;
         columns?: string[] | undefined;
-        start_time?: number | undefined;
-        end_time?: number | undefined;
         frame_count?: number | undefined;
         pages?: number[] | undefined;
         page_range?: {
@@ -389,10 +389,10 @@ export declare function createFileTools(registry: FileReferenceRegistry): {
         execute: (args: {
             file_id: string;
             format?: "text" | "summary" | "detailed" | undefined;
+            end_time?: number | undefined;
+            start_time?: number | undefined;
             sheet?: string | undefined;
             columns?: string[] | undefined;
-            start_time?: number | undefined;
-            end_time?: number | undefined;
             frame_count?: number | undefined;
             pages?: number[] | undefined;
             page_range?: {

package/dist/index.d.ts

@@ -33,17 +33,17 @@
  */
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
+export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
 export { dynamicModelProvider } from "./core/dynamicModels.js";
 export { validateTool } from "./sdk/toolRegistration.js";
 export * from "./types/index.js";
 export type { DynamicModelConfig, ModelRegistry } from "./types/modelTypes.js";
-export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
-export { calculateCost, hasPricing } from "./utils/pricing.js";
 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 { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
 export type { MCPServerInfo } from "./types/mcpTypes.js";
@@ -54,6 +54,15 @@ export type { LangfuseContext } from "./services/server/ai/observability/instrum
 export { initializeOpenTelemetry, shutdownOpenTelemetry, flushOpenTelemetry, getLangfuseHealthStatus, setLangfuseContext, getLangfuseSpanProcessor, getTracerProvider, isOpenTelemetryInitialized, getSpanProcessors, createContextEnricher, isUsingExternalTracerProvider, getLangfuseContext, getTracer, runWithCurrentLangfuseContext, };
 export { clearAnalyticsMetrics, createAnalyticsMiddleware, getAnalyticsMetrics, } from "./middleware/builtin/analytics.js";
 export { MiddlewareFactory } from "./middleware/factory.js";
+export { ExporterRegistry } from "./observability/exporterRegistry.js";
+export { NoOpExporter } from "./observability/exporters/baseExporter.js";
+export type { LatencyStats, MetricsSummary, ModelCostStats, ProviderCostStats, TraceView, } from "./observability/metricsAggregator.js";
+export { getMetricsAggregator, MetricsAggregator, resetMetricsAggregator, } from "./observability/metricsAggregator.js";
+export { AlwaysSampler, NeverSampler, } from "./observability/sampling/samplers.js";
+export { TokenTracker } from "./observability/tokenTracker.js";
+export type { SpanAttributes, SpanData, SpanEvent, } from "./observability/types/spanTypes.js";
+export { GENAI_ATTRIBUTES, SpanStatus, SpanType, } from "./observability/types/spanTypes.js";
+export { SpanSerializer } from "./observability/utils/spanSerializer.js";
 export type { MiddlewareConfig, MiddlewareContext, MiddlewareFactoryOptions, MiddlewarePreset, NeuroLinkMiddleware, } from "./types/middlewareTypes.js";
 export declare const VERSION = "1.0.0";
 /**
@@ -274,17 +283,17 @@ export declare function generateText(options: import("./types/index.js").TextGen
  * console.log('Total time:', result.workflow?.metrics?.totalTime);
  * ```
  */
-export type { WorkflowConfig, WorkflowResult, ModelConfig, JudgeConfig, ModelGroup, EnsembleResponse, JudgeScores, MultiJudgeScores, WorkflowType, ExecutionStrategy, WorkflowValidationResult, } from "./workflow/types.js";
-export { runWorkflow } from "./workflow/core/workflowRunner.js";
+export { clearRegistry as clearWorkflowRegistry, getWorkflow, listWorkflows, registerWorkflow, } from "./workflow/core/workflowRegistry.js";
 export type { RunWorkflowOptions } from "./workflow/core/workflowRunner.js";
-export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
-export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
-export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
-export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
-export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
-export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { runWorkflow } from "./workflow/core/workflowRunner.js";
+export { DEFAULT_SCORE_SCALE, WORKFLOW_ENGINE_VERSION, } from "./workflow/index.js";
+export type { EnsembleResponse, ExecutionStrategy, JudgeConfig, JudgeScores, ModelConfig, ModelGroup, MultiJudgeScores, WorkflowConfig, WorkflowResult, WorkflowType, WorkflowValidationResult, } from "./workflow/types.js";
 export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
-export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+export { BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, } from "./workflow/workflows/adaptiveWorkflow.js";
+export { CONSENSUS_3_FAST_WORKFLOW, CONSENSUS_3_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+export { AGGRESSIVE_FALLBACK_WORKFLOW, FAST_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+export { createMultiJudgeWorkflow, MULTI_JUDGE_3_WORKFLOW, MULTI_JUDGE_5_WORKFLOW, } from "./workflow/workflows/multiJudgeWorkflow.js";
 export type { AgentExecuteRequest, AgentExecuteResponse, AuthConfig, AuthenticatedUser, AuthResult, AuthStrategy, BodyParserConfig, CacheConfig, CacheEntry, CacheStore, CORSConfig, CreateRoutesOptions, DataEvent, DataStreamEvent, DataStreamEventType, DataStreamResponseConfig, DataStreamWriter, DataStreamWriterConfig, ErrorCategoryType, ErrorEvent, ErrorResponse, ErrorSeverityType, FinishEvent, HealthResponse, HttpMethod, LoggingConfig, MCPServerStatusResponse, MiddlewareDefinition, MiddlewareHandler, OpenAPIGeneratorConfig, OpenAPISpec, PropertySchema, RateLimitConfig as ServerRateLimitConfig, RateLimitMiddlewareConfig, RateLimitStore, ReadyResponse, RequiredServerAdapterConfig, RouteDefinition, RouteGroup, RouteHandler, ServerAdapterConfig, ServerAdapterErrorCodeType, ServerAdapterErrorContext, ServerAdapterEvents, ServerAdapterFactoryOptions, ServerContext, ServerFramework, ServerResponse, ServerStatus, SSEWriteOptions, StreamingConfig, TextDeltaEvent, TextEndEvent, TextStartEvent, ToolCallEvent, ToolExecuteRequest, ToolExecuteResponse, ToolResultEvent, ValidationConfig, ValidationResult, ValidationSchema, WebSocketAuthConfig, WebSocketConfig, WebSocketConnection, WebSocketHandler, WebSocketMessage, WebSocketMessageType, } from "./server/index.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
@@ -336,3 +345,28 @@ export type { BaseChunkerConfig, BM25Result, CharacterChunkerConfig, Chunk, Chun
  * ```
  */
 export { assembleContext, batchRerank, CharacterChunker, ChunkerRegistry, CohereRelevanceScorer, CrossEncoderReranker, CSVLoader, chunkText, createChunker, createContextWindow, createHybridSearch, createRAGPipeline, createVectorQueryTool, executeWithCircuitBreaker, extractMetadata, formatContextWithCitations, GraphRAG, getAvailableStrategies, getCircuitBreaker, getDefaultChunkerConfig, getRecommendedStrategy, HTMLChunker, HTMLLoader, InMemoryBM25Index, InMemoryVectorStore, JSONChunker as RAGJSONChunker, JSONLoader, LaTeXChunker, LLMMetadataExtractor, linearCombination, loadDocument, loadDocuments, MarkdownChunker, MarkdownLoader, MDocument, PDFLoader, prepareRAGTool, processDocument, RAGCircuitBreaker, type RAGCircuitBreakerConfig, type RAGCircuitBreakerEvents, RAGCircuitBreakerManager, type RAGCircuitBreakerStats, RAGPipeline, RAGRetryHandler, RecursiveChunker, ragCircuitBreakerManager, reciprocalRankFusion, rerank, SemanticChunker, SentenceChunker, simpleRerank, summarizeContext, TextLoader, TokenChunker, WebLoader, } from "./rag/index.js";
+export { ContextBuilder } from "./evaluation/contextBuilder.js";
+/**
+ * Evaluation system for AI response quality assessment.
+ *
+ * Uses RAGAS-style model-based evaluation with a "judge" LLM to score
+ * responses on relevance, accuracy, completeness, and overall quality.
+ * Supports retry logic with progressive prompt improvement.
+ *
+ * @example
+ * ```typescript
+ * import { Evaluator, RAGASEvaluator, ContextBuilder, RetryManager } from '@juspay/neurolink';
+ *
+ * const evaluator = new Evaluator({
+ *   evaluationModel: 'gemini-1.5-flash',
+ *   provider: 'vertex',
+ *   threshold: 7,
+ * });
+ * ```
+ */
+export { Evaluator } from "./evaluation/index.js";
+export { PromptBuilder } from "./evaluation/prompts.js";
+export { RAGASEvaluator } from "./evaluation/ragasEvaluator.js";
+export { RetryManager } from "./evaluation/retryManager.js";
+export { mapToEvaluationData } from "./evaluation/scoring.js";
+export type { EnhancedConversationTurn, EnhancedEvaluationContext, EvaluationConfig, EvaluationResult, GetPromptFunction, QualityErrorDetails, QueryIntentAnalysis, } from "./types/evaluationTypes.js";

package/dist/index.js

@@ -34,6 +34,7 @@
 // Core exports
 import { AIProviderFactory } from "./core/factory.js";
 export { AIProviderFactory };
+export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 // Config Manager export
 export { NeuroLinkConfigManager as ConfigManager } from "./config/configManager.js";
 export { AIProviderName, BedrockModels, OpenAIModels, VertexModels, } from "./constants/enums.js";
@@ -43,15 +44,14 @@ export { dynamicModelProvider } from "./core/dynamicModels.js";
 export { validateTool } from "./sdk/toolRegistration.js";
 // Export ALL types from the centralized type barrel
 export * from "./types/index.js";
-// Utility exports
-export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
-// Pricing utilities
-export { calculateCost, hasPricing } from "./utils/pricing.js";
 // Error utilities
 export { isAbortError } from "./utils/errorHandling.js";
+// Pricing utilities
+export { calculateCost, hasPricing } from "./utils/pricing.js";
+// Utility exports
+export { getAvailableProviders, getBestProvider, isValidProvider, } from "./utils/providerUtils.js";
 // TTS utilities
 export { TTSProcessor } from "./utils/ttsProcessor.js";
-export { GoogleTTSHandler } from "./adapters/tts/googleTTSHandler.js";
 // Main NeuroLink wrapper class and diagnostic types
 import { NeuroLink } from "./neurolink.js";
 export { NeuroLink };
@@ -72,6 +72,14 @@ runWithCurrentLangfuseContext, };
 // Analytics Middleware exports
 export { clearAnalyticsMetrics, createAnalyticsMiddleware, getAnalyticsMetrics, } from "./middleware/builtin/analytics.js";
 export { MiddlewareFactory } from "./middleware/factory.js";
+export { ExporterRegistry } from "./observability/exporterRegistry.js";
+export { NoOpExporter } from "./observability/exporters/baseExporter.js";
+// Observability modules and types
+export { getMetricsAggregator, MetricsAggregator, resetMetricsAggregator, } from "./observability/metricsAggregator.js";
+export { AlwaysSampler, NeverSampler, } from "./observability/sampling/samplers.js";
+export { TokenTracker } from "./observability/tokenTracker.js";
+export { GENAI_ATTRIBUTES, SpanStatus, SpanType, } from "./observability/types/spanTypes.js";
+export { SpanSerializer } from "./observability/utils/spanSerializer.js";
 // Version
 export const VERSION = "1.0.0";
 /**
@@ -299,23 +307,50 @@ export async function generateText(options) {
     const neurolink = new NeuroLink();
     return await neurolink.generateText(options);
 }
+// ============================================================================
+// WORKFLOW ENGINE - Multi-Model Orchestration with Judge Scoring
+// ============================================================================
+/**
+ * Workflow Engine for multi-model ensembles with judge-based evaluation
+ *
+ * Enables sophisticated AI orchestration patterns:
+ * - Ensemble execution (parallel multi-model)
+ * - Chain execution (sequential fallback)
+ * - Adaptive execution (tier-based quality/cost optimization)
+ * - Multi-judge voting for consensus
+ *
+ * @example
+ * ```typescript
+ * import { neurolink, CONSENSUS_3_WORKFLOW } from '@juspay/neurolink';
+ *
+ * // Use workflow via generate() with workflowConfig option
+ * const result = await neurolink.generate({
+ *   input: { text: 'Explain quantum computing' },
+ *   workflowConfig: CONSENSUS_3_WORKFLOW,
+ * });
+ *
+ * console.log('Best response:', result.content);
+ * console.log('Selected model:', result.workflow?.selectedModel);
+ * console.log('Total time:', result.workflow?.metrics?.totalTime);
+ * ```
+ */
+// Workflow registry
+export { clearRegistry as clearWorkflowRegistry, getWorkflow, listWorkflows, registerWorkflow, } from "./workflow/core/workflowRegistry.js";
 // Workflow execution
 export { runWorkflow } from "./workflow/core/workflowRunner.js";
-// Workflow registry
-export { registerWorkflow, getWorkflow, listWorkflows, clearRegistry as clearWorkflowRegistry, } from "./workflow/core/workflowRegistry.js";
+// Workflow constants
+export { DEFAULT_SCORE_SCALE, WORKFLOW_ENGINE_VERSION, } from "./workflow/index.js";
+export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
+// Validation and metrics
+export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
+// Pre-built workflows - Adaptive
+export { BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, } from "./workflow/workflows/adaptiveWorkflow.js";
 // Pre-built workflows - Consensus
-export { CONSENSUS_3_WORKFLOW, CONSENSUS_3_FAST_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
+export { CONSENSUS_3_FAST_WORKFLOW, CONSENSUS_3_WORKFLOW, createConsensus3WithPrompt, } from "./workflow/workflows/consensusWorkflow.js";
 // Pre-built workflows - Fallback
-export { FAST_FALLBACK_WORKFLOW, AGGRESSIVE_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
+export { AGGRESSIVE_FALLBACK_WORKFLOW, FAST_FALLBACK_WORKFLOW, } from "./workflow/workflows/fallbackWorkflow.js";
 // Pre-built workflows - Multi-judge
-export { MULTI_JUDGE_5_WORKFLOW, MULTI_JUDGE_3_WORKFLOW, createMultiJudgeWorkflow, } from "./workflow/workflows/multiJudgeWorkflow.js";
-// Pre-built workflows - Adaptive
-export { QUALITY_MAX_WORKFLOW, SPEED_FIRST_WORKFLOW, BALANCED_ADAPTIVE_WORKFLOW, createAdaptiveWorkflow, } from "./workflow/workflows/adaptiveWorkflow.js";
-// Validation and metrics
-export { validateWorkflow } from "./workflow/utils/workflowValidation.js";
-export { calculateModelMetrics, compareWorkflows, generateSummaryStats, } from "./workflow/utils/workflowMetrics.js";
-// Workflow constants
-export { WORKFLOW_ENGINE_VERSION, DEFAULT_SCORE_SCALE, } from "./workflow/index.js";
+export { createMultiJudgeWorkflow, MULTI_JUDGE_3_WORKFLOW, MULTI_JUDGE_5_WORKFLOW, } from "./workflow/workflows/multiJudgeWorkflow.js";
 /**
  * Server Adapters for exposing NeuroLink as HTTP APIs
  *
@@ -403,3 +438,30 @@ extractMetadata, formatContextWithCitations,
 GraphRAG, getAvailableStrategies, getCircuitBreaker, getDefaultChunkerConfig, getRecommendedStrategy, HTMLChunker, HTMLLoader, InMemoryBM25Index, InMemoryVectorStore, JSONChunker as RAGJSONChunker, JSONLoader, LaTeXChunker, LLMMetadataExtractor, linearCombination, loadDocument, loadDocuments, MarkdownChunker, MarkdownLoader, MDocument, PDFLoader, 
 // RAG Integration for generate/stream
 prepareRAGTool, processDocument, RAGCircuitBreaker, RAGCircuitBreakerManager, RAGPipeline, RAGRetryHandler, RecursiveChunker, ragCircuitBreakerManager, reciprocalRankFusion, rerank, SemanticChunker, SentenceChunker, simpleRerank, summarizeContext, TextLoader, TokenChunker, WebLoader, } from "./rag/index.js";
+// ============================================================================
+// EVALUATION / SCORING - RAGAS-style Response Quality Evaluation
+// ============================================================================
+export { ContextBuilder } from "./evaluation/contextBuilder.js";
+/**
+ * Evaluation system for AI response quality assessment.
+ *
+ * Uses RAGAS-style model-based evaluation with a "judge" LLM to score
+ * responses on relevance, accuracy, completeness, and overall quality.
+ * Supports retry logic with progressive prompt improvement.
+ *
+ * @example
+ * ```typescript
+ * import { Evaluator, RAGASEvaluator, ContextBuilder, RetryManager } from '@juspay/neurolink';
+ *
+ * const evaluator = new Evaluator({
+ *   evaluationModel: 'gemini-1.5-flash',
+ *   provider: 'vertex',
+ *   threshold: 7,
+ * });
+ * ```
+ */
+export { Evaluator } from "./evaluation/index.js";
+export { PromptBuilder } from "./evaluation/prompts.js";
+export { RAGASEvaluator } from "./evaluation/ragasEvaluator.js";
+export { RetryManager } from "./evaluation/retryManager.js";
+export { mapToEvaluationData } from "./evaluation/scoring.js";