@juspay/neurolink 9.23.0 → 9.25.0

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

@@ -471,8 +471,8 @@ export type GenerateResult = {
      * });
      *
      * if (result.ppt) {
-     *   console.log(`Generated ${result.ppt.slides.length} slides`);
-     *   console.log(`Title: ${result.ppt.slides[0].title}`);
+     *   console.log(`Generated ${result.ppt.totalSlides} slides`);
+     *   console.log(`Saved at: ${result.ppt.filePath}`);
      * }
      * ```
      */

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

@@ -89,24 +89,24 @@ export declare const ModelConfigSchema: z.ZodObject<{
     releaseDate: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     capabilities: string[];
-    id: string;
-    displayName: string;
-    deprecated: boolean;
     pricing: {
         output: number;
         input: number;
     };
+    id: string;
+    displayName: string;
+    deprecated: boolean;
     contextWindow: number;
     releaseDate: string;
 }, {
     capabilities: string[];
-    id: string;
-    displayName: string;
-    deprecated: boolean;
     pricing: {
         output: number;
         input: number;
     };
+    id: string;
+    displayName: string;
+    deprecated: boolean;
     contextWindow: number;
     releaseDate: string;
 }>;
@@ -135,24 +135,24 @@ export declare const ModelRegistrySchema: z.ZodObject<{
         releaseDate: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         capabilities: string[];
-        id: string;
-        displayName: string;
-        deprecated: boolean;
         pricing: {
             output: number;
             input: number;
         };
+        id: string;
+        displayName: string;
+        deprecated: boolean;
         contextWindow: number;
         releaseDate: string;
     }, {
         capabilities: string[];
-        id: string;
-        displayName: string;
-        deprecated: boolean;
         pricing: {
             output: number;
             input: number;
         };
+        id: string;
+        displayName: string;
+        deprecated: boolean;
         contextWindow: number;
         releaseDate: string;
     }>>>;
@@ -162,13 +162,13 @@ export declare const ModelRegistrySchema: z.ZodObject<{
     version: string;
     models: Record<string, Record<string, {
         capabilities: string[];
-        id: string;
-        displayName: string;
-        deprecated: boolean;
         pricing: {
             output: number;
             input: number;
         };
+        id: string;
+        displayName: string;
+        deprecated: boolean;
         contextWindow: number;
         releaseDate: string;
     }>>;
@@ -179,13 +179,13 @@ export declare const ModelRegistrySchema: z.ZodObject<{
     version: string;
     models: Record<string, Record<string, {
         capabilities: string[];
-        id: string;
-        displayName: string;
-        deprecated: boolean;
         pricing: {
             output: number;
             input: number;
         };
+        id: string;
+        displayName: string;
+        deprecated: boolean;
         contextWindow: number;
         releaseDate: string;
     }>>;

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

@@ -335,6 +335,11 @@ export type AIProvider = {
         customTools: Map<string, unknown>;
         executeTool: (toolName: string, params: unknown) => Promise<unknown>;
     }, functionTag: string): void;
+    /** Trace context propagated from NeuroLink SDK for parent-child span hierarchy */
+    _traceContext?: {
+        traceId: string;
+        parentSpanId: string;
+    } | null;
 };
 /**
  * Provider attempt result for iteration tracking (converted from interface)

package/dist/lib/utils/pricing.js

@@ -61,6 +61,12 @@ const PRICING = {
     },
     // Google (Gemini)
     google: {
+        "gemini-2.5-flash": { input: 0.15 / 1_000_000, output: 0.6 / 1_000_000 },
+        "gemini-2.5-pro": { input: 1.25 / 1_000_000, output: 10.0 / 1_000_000 },
+        "gemini-2.5-flash-lite": {
+            input: 0.075 / 1_000_000,
+            output: 0.3 / 1_000_000,
+        },
         "gemini-2.0-flash": { input: 0.1 / 1_000_000, output: 0.4 / 1_000_000 },
         "gemini-2.0-pro": { input: 1.25 / 1_000_000, output: 10.0 / 1_000_000 },
         "gemini-1.5-pro": { input: 1.25 / 1_000_000, output: 5.0 / 1_000_000 },
@@ -101,7 +107,25 @@ function findRates(provider, model) {
     // Longest-prefix match
     const sortedKeys = Object.keys(providerPricing).sort((a, b) => b.length - a.length);
     const key = sortedKeys.find((k) => model.startsWith(k));
-    return key ? providerPricing[key] : undefined;
+    if (key) {
+        return providerPricing[key];
+    }
+    // Fallback: Vertex hosts both Claude and Gemini models.
+    // If no match found under "vertex", try "google" pricing for Gemini models.
+    if (normalizedProvider === "vertex" && model.startsWith("gemini")) {
+        const googlePricing = PRICING["google"];
+        if (googlePricing) {
+            if (googlePricing[model]) {
+                return googlePricing[model];
+            }
+            const googleKeys = Object.keys(googlePricing).sort((a, b) => b.length - a.length);
+            const googleKey = googleKeys.find((k) => model.startsWith(k));
+            if (googleKey) {
+                return googlePricing[googleKey];
+            }
+        }
+    }
+    return undefined;
 }
 /**
  * Calculate the dollar cost of a generate/stream call based on token usage.

package/dist/lib/utils/ttsProcessor.js

@@ -9,6 +9,8 @@
 import { logger } from "./logger.js";
 import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
 import { NeuroLinkError } from "./errorHandling.js";
+import { SpanSerializer, SpanType, SpanStatus, } from "../observability/index.js";
+import { getMetricsAggregator } from "../observability/index.js";
 /**
  * TTS-specific error codes
  */
@@ -175,63 +177,70 @@ export class TTSProcessor {
      * ```
      */
     static async synthesize(text, provider, options) {
-        // Trim the text once at the start
-        const trimmedText = text.trim();
-        // 1. Text validation: reject empty text
-        if (!trimmedText) {
-            logger.error("[TTSProcessor] Text is required for synthesis");
-            throw new TTSError({
-                code: TTS_ERROR_CODES.EMPTY_TEXT,
-                message: "Text is required for TTS synthesis",
-                severity: ErrorSeverity.LOW,
-                retriable: false,
-                context: { provider },
-            });
-        }
-        // 2. Handler lookup and error if provider not supported
-        const handler = this.getHandler(provider);
-        if (!handler) {
-            logger.error(`[TTSProcessor] Provider "${provider}" is not registered`);
-            throw new TTSError({
-                code: TTS_ERROR_CODES.PROVIDER_NOT_SUPPORTED,
-                message: `TTS provider "${provider}" is not supported. Use TTSProcessor.registerHandler() to register it.`,
-                severity: ErrorSeverity.HIGH,
-                retriable: false,
-                context: {
-                    provider,
-                    availableProviders: Array.from(this.handlers.keys()),
-                },
-            });
-        }
-        // 3. Text validation: reject text exceeding provider-specific max length
-        const maxTextLength = handler.maxTextLength ?? this.DEFAULT_MAX_TEXT_LENGTH;
-        if (trimmedText.length > maxTextLength) {
-            logger.error(`[TTSProcessor] Text exceeds maximum length of ${maxTextLength} characters for provider "${provider}"`);
-            throw new TTSError({
-                code: TTS_ERROR_CODES.TEXT_TOO_LONG,
-                message: `Text length (${trimmedText.length}) exceeds maximum allowed length (${maxTextLength} characters) for provider "${provider}"`,
-                severity: ErrorSeverity.MEDIUM,
-                retriable: false,
-                context: {
-                    provider,
-                    textLength: trimmedText.length,
-                    maxLength: maxTextLength,
-                },
-            });
-        }
-        // 4. Configuration check
-        if (!handler.isConfigured()) {
-            logger.warn(`[TTSProcessor] Provider "${provider}" is not properly configured`);
-            throw new TTSError({
-                code: TTS_ERROR_CODES.PROVIDER_NOT_CONFIGURED,
-                message: `TTS provider "${provider}" is not configured. Please set the required API keys.`,
-                category: ErrorCategory.CONFIGURATION,
-                severity: ErrorSeverity.HIGH,
-                retriable: false,
-                context: { provider },
-            });
-        }
+        // Create span early so preflight failures are captured
+        const span = SpanSerializer.createSpan(SpanType.TTS, "tts.synthesize", {
+            "tts.operation": "synthesize",
+            "tts.provider": provider,
+            "tts.voice": options.voice,
+            "tts.format": options.format,
+        });
         try {
+            // Trim the text once at the start
+            const trimmedText = text.trim();
+            // 1. Text validation: reject empty text
+            if (!trimmedText) {
+                logger.error("[TTSProcessor] Text is required for synthesis");
+                throw new TTSError({
+                    code: TTS_ERROR_CODES.EMPTY_TEXT,
+                    message: "Text is required for TTS synthesis",
+                    severity: ErrorSeverity.LOW,
+                    retriable: false,
+                    context: { provider },
+                });
+            }
+            // 2. Handler lookup and error if provider not supported
+            const handler = this.getHandler(provider);
+            if (!handler) {
+                logger.error(`[TTSProcessor] Provider "${provider}" is not registered`);
+                throw new TTSError({
+                    code: TTS_ERROR_CODES.PROVIDER_NOT_SUPPORTED,
+                    message: `TTS provider "${provider}" is not supported. Use TTSProcessor.registerHandler() to register it.`,
+                    severity: ErrorSeverity.HIGH,
+                    retriable: false,
+                    context: {
+                        provider,
+                        availableProviders: Array.from(this.handlers.keys()),
+                    },
+                });
+            }
+            // 3. Text validation: reject text exceeding provider-specific max length
+            const maxTextLength = handler.maxTextLength ?? this.DEFAULT_MAX_TEXT_LENGTH;
+            if (trimmedText.length > maxTextLength) {
+                logger.error(`[TTSProcessor] Text exceeds maximum length of ${maxTextLength} characters for provider "${provider}"`);
+                throw new TTSError({
+                    code: TTS_ERROR_CODES.TEXT_TOO_LONG,
+                    message: `Text length (${trimmedText.length}) exceeds maximum allowed length (${maxTextLength} characters) for provider "${provider}"`,
+                    severity: ErrorSeverity.MEDIUM,
+                    retriable: false,
+                    context: {
+                        provider,
+                        textLength: trimmedText.length,
+                        maxLength: maxTextLength,
+                    },
+                });
+            }
+            // 4. Configuration check
+            if (!handler.isConfigured()) {
+                logger.warn(`[TTSProcessor] Provider "${provider}" is not properly configured`);
+                throw new TTSError({
+                    code: TTS_ERROR_CODES.PROVIDER_NOT_CONFIGURED,
+                    message: `TTS provider "${provider}" is not configured. Please set the required API keys.`,
+                    category: ErrorCategory.CONFIGURATION,
+                    severity: ErrorSeverity.HIGH,
+                    retriable: false,
+                    context: { provider },
+                });
+            }
             logger.debug(`[TTSProcessor] Starting synthesis with provider: ${provider}`);
             // 5. Call handler.synthesize() - providers handle their own timeouts
             const result = await handler.synthesize(trimmedText, options);
@@ -241,11 +250,17 @@ export class TTSProcessor {
                 voice: result.voice ?? options.voice,
             };
             logger.info(`[TTSProcessor] Successfully synthesized ${result.size} bytes of audio`);
-            // 7. Returns TTSResult with buffer, format, metadata
+            // 7. Record successful span
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
+            // 8. Returns TTSResult with buffer, format, metadata
             return enrichedResult;
         }
         catch (err) {
-            // 8. Comprehensive error handling
+            // Record error span
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, err instanceof Error ? err.message : String(err));
+            getMetricsAggregator().recordSpan(endedSpan);
+            // 9. Comprehensive error handling
             // Re-throw TTSError as-is
             if (err instanceof TTSError) {
                 throw err;
@@ -261,7 +276,7 @@ export class TTSProcessor {
                 retriable: true,
                 context: {
                     provider,
-                    textLength: trimmedText.length,
+                    textLength: text.trim().length,
                     options,
                 },
                 originalError: err instanceof Error ? err : undefined,