@juspay/neurolink 9.94.7 → 9.95.0

package/dist/lib/neurolink.d.ts

@@ -13,6 +13,7 @@ import { ExternalServerManager } from "./mcp/externalServerManager.js";
 import { MCPToolRegistry } from "./mcp/toolRegistry.js";
 import type { DynamicOptions } from "./types/index.js";
 import { SkillsManager } from "./skills/skillsManager.js";
+import type { CostAnalysisOptions, CostAnalysisResult, ProviderMetricsOptions, ProviderMetricsResult, TeamAnalyticsOptions, TeamAnalyticsResult } from "./types/index.js";
 import { TaskManager } from "./tasks/taskManager.js";
 import type { SessionExport, SessionListItem } from "./types/index.js";
 /**
@@ -220,6 +221,7 @@ export declare class NeuroLink {
      */
     private observabilityConfig?;
     private metricsAggregator;
+    private analyticsService;
     /**
      * Per-request metrics trace context backed by AsyncLocalStorage.
      * Safe for concurrent requests on the same SDK instance.
@@ -532,6 +534,30 @@ export declare class NeuroLink {
      * Record a span for metrics tracking
      */
     recordMetricsSpan(span: SpanData): void;
+    /**
+     * Get provider metrics analysis
+     * Retrieves aggregated performance, token usage, latency, and success rates per provider.
+     *
+     * @param options - Filtering options
+     * @returns Comprehensive provider metrics result
+     */
+    getProviderMetrics(options?: ProviderMetricsOptions): Promise<ProviderMetricsResult>;
+    /**
+     * Get cost analysis breakdown
+     * Analyzes AI generation costs across requested groups and provides future projections.
+     *
+     * @param options - Cost configuration options
+     * @returns Detailed cost analysis breakdown
+     */
+    getCostAnalysis(options?: CostAnalysisOptions): Promise<CostAnalysisResult>;
+    /**
+     * Get team-wide usage analytics
+     * Retrieves request counts, unique active users, provider breakdown, and quality scoring.
+     *
+     * @param options - Team query options
+     * @returns Comprehensive team analytics report
+     */
+    getTeamAnalytics(options?: TeamAnalyticsOptions): Promise<TeamAnalyticsResult>;
     /**
      * Record a memory operation span to both instance and global metrics aggregators.
      * This ensures memory spans are visible via sdk.getSpans() and getMetricsAggregator().getSpans().
@@ -546,6 +572,34 @@ export declare class NeuroLink {
      * Gracefully shutdown NeuroLink and all MCP connections
      */
     shutdown(): Promise<void>;
+    /**
+     * Fire-and-forget analytics tracking with rejection logging.
+     */
+    private enqueueAnalyticsTrackRequest;
+    /**
+     * Estimate cost using the canonical SDK pricing table (same source as
+     * AnalyticsService.trackRequest) — avoids diverging TokenTracker rates.
+     */
+    private estimateCostFromUsage;
+    /**
+     * Handle generation:end for Pipeline B spans + advanced analytics.
+     * When pipelineAHandled is set, skips Pipeline B spans but still tracks
+     * analytics so successful AI-SDK generate/stream calls are recorded.
+     * Stream analytics are owned here (not stream:complete) to avoid duplicates.
+     */
+    private handleGenerationEndMetrics;
+    /**
+     * Pipeline B span recording for stream:complete.
+     * Advanced analytics are recorded from generation:end only (avoids duplicates
+     * when both stream:complete and generation:end fire for the same request).
+     */
+    private handleStreamCompleteMetrics;
+    private handleToolEndMetrics;
+    /**
+     * Pipeline B span recording for stream:error.
+     * Analytics for failed streams come from generation:end (success: false).
+     */
+    private handleStreamErrorMetrics;
     /**
      * Initialize event listeners that feed span data to MetricsAggregator.
      * Listens to generation:end, stream:complete, and tool:end events.