@juspay/neurolink 3.0.0 → 4.0.0

package/dist/core/types.d.ts

@@ -44,10 +44,9 @@ export declare enum VertexModels {
  * Supported Models for Google AI Studio
  */
 export declare enum GoogleAIModels {
-    GEMINI_1_5_PRO_LATEST = "gemini-1.5-pro-latest",
-    GEMINI_1_5_FLASH_LATEST = "gemini-1.5-flash-latest",
-    GEMINI_2_0_FLASH_EXP = "gemini-2.0-flash-exp",
-    GEMINI_1_0_PRO = "gemini-1.0-pro"
+    GEMINI_2_5_PRO = "gemini-2.5-pro",
+    GEMINI_2_5_FLASH = "gemini-2.5-flash",
+    GEMINI_1_5_FLASH_LITE = "gemini-2.5-flash-lite"
 }
 /**
  * Union type of all supported model names
@@ -81,6 +80,15 @@ export interface TextGenerationOptions {
     schema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>;
     tools?: Record<string, Tool>;
     timeout?: number | string;
+    enableEvaluation?: boolean;
+    enableAnalytics?: boolean;
+    context?: Record<string, any>;
+    evaluationDomain?: string;
+    toolUsageContext?: string;
+    conversationHistory?: Array<{
+        role: string;
+        content: string;
+    }>;
 }
 /**
  * Stream text options interface
@@ -94,13 +102,164 @@ export interface StreamTextOptions {
     schema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>;
     tools?: Record<string, Tool>;
     timeout?: number | string;
+    enableEvaluation?: boolean;
+    enableAnalytics?: boolean;
+    context?: Record<string, any>;
+    evaluationDomain?: string;
+    toolUsageContext?: string;
+    conversationHistory?: Array<{
+        role: string;
+        content: string;
+    }>;
+}
+/**
+ * Analytics data for usage tracking
+ */
+export interface AnalyticsData {
+    provider: string;
+    model: string;
+    tokens: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    cost?: number;
+    responseTime: number;
+    timestamp: string;
+    context?: Record<string, any>;
+}
+/**
+ * Response quality evaluation scores (Lighthouse-Compatible Schema)
+ * Updated to match Lighthouse's exact evaluation interface for consistency
+ */
+export interface EvaluationData {
+    relevanceScore: number;
+    accuracyScore: number;
+    completenessScore: number;
+    overall: number;
+    isOffTopic: boolean;
+    alertSeverity: "low" | "medium" | "high" | "none";
+    reasoning: string;
+    suggestedImprovements?: string;
+    evaluationModel: string;
+    evaluationTime: number;
+    evaluationProvider?: string;
+    evaluationAttempt?: number;
+    evaluationConfig?: {
+        mode: string;
+        fallbackUsed: boolean;
+        costEstimate: number;
+    };
+}
+/**
+ * BACKWARD COMPATIBILITY: Legacy evaluation interface
+ * Maintains existing field names for backward compatibility
+ */
+export interface LegacyEvaluationData {
+    relevance: number;
+    accuracy: number;
+    completeness: number;
+    overall: number;
+    isOffTopic: boolean;
+    alertSeverity: "low" | "medium" | "high" | "none";
+    reasoning: string;
+    suggestedImprovements?: string;
+    evaluationModel: string;
+    evaluationTime: number;
+}
+/**
+ * Evaluation system configuration for multi-provider support
+ */
+export interface EvaluationConfig {
+    provider: string;
+    model: string;
+    mode: "fast" | "balanced" | "quality";
+    fallbackEnabled: boolean;
+    fallbackProviders: string[];
+    timeout: number;
+    maxTokens: number;
+    temperature: number;
+    preferCheap: boolean;
+    maxCostPerEval: number;
+    retryAttempts: number;
+}
+/**
+ * Provider model configuration for evaluation
+ */
+export interface ProviderModelConfig {
+    provider: string;
+    models: {
+        fast: string;
+        balanced: string;
+        quality: string;
+    };
+    costPerToken: {
+        input: number;
+        output: number;
+    };
+    requiresApiKey: string[];
+    performance: {
+        speed: number;
+        quality: number;
+        cost: number;
+    };
+}
+/**
+ * Enhanced result interfaces with optional analytics/evaluation
+ */
+export interface EnhancedGenerateTextResult extends GenerateTextResult<ToolSet, unknown> {
+    analytics?: AnalyticsData;
+    evaluation?: EvaluationData;
+}
+export interface EnhancedStreamTextResult extends StreamTextResult<ToolSet, unknown> {
+    analytics?: AnalyticsData;
+    evaluation?: EvaluationData;
+}
+/**
+ * Phase 2: Enhanced Streaming Infrastructure
+ * Progress tracking and metadata for streaming operations
+ */
+export interface StreamingProgressData {
+    chunkCount: number;
+    totalBytes: number;
+    chunkSize: number;
+    elapsedTime: number;
+    estimatedRemaining?: number;
+    streamId?: string;
+    phase: "initializing" | "streaming" | "processing" | "complete" | "error";
+}
+export interface StreamingMetadata {
+    startTime: number;
+    endTime?: number;
+    totalDuration?: number;
+    averageChunkSize: number;
+    maxChunkSize: number;
+    minChunkSize: number;
+    throughputBytesPerSecond?: number;
+    streamingProvider: string;
+    modelUsed: string;
+}
+export type ProgressCallback = (progress: StreamingProgressData) => void;
+export interface EnhancedStreamTextOptions extends StreamTextOptions {
+    enableProgressTracking?: boolean;
+    progressCallback?: ProgressCallback;
+    includeStreamingMetadata?: boolean;
+    streamingBufferSize?: number;
+    enableStreamingHeaders?: boolean;
+    customStreamingConfig?: {
+        chunkDelayMs?: number;
+        maxConcurrentChunks?: number;
+        compressionEnabled?: boolean;
+    };
 }
 /**
  * AI Provider interface with flexible parameter support
  */
 export interface AIProvider {
-    streamText(optionsOrPrompt: StreamTextOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<StreamTextResult<ToolSet, unknown> | null>;
-    generateText(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<GenerateTextResult<ToolSet, unknown> | null>;
+    streamText(optionsOrPrompt: StreamTextOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedStreamTextResult | null>;
+    generateText(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateTextResult | null>;
+    generate(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateTextResult | null>;
+    gen(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: ZodType<unknown, ZodTypeDef, unknown> | Schema<unknown>): Promise<EnhancedGenerateTextResult | null>;
 }
 /**
  * Provider attempt result for iteration tracking

package/dist/core/types.js

@@ -47,10 +47,9 @@ export var VertexModels;
  */
 export var GoogleAIModels;
 (function (GoogleAIModels) {
-    GoogleAIModels["GEMINI_1_5_PRO_LATEST"] = "gemini-1.5-pro-latest";
-    GoogleAIModels["GEMINI_1_5_FLASH_LATEST"] = "gemini-1.5-flash-latest";
-    GoogleAIModels["GEMINI_2_0_FLASH_EXP"] = "gemini-2.0-flash-exp";
-    GoogleAIModels["GEMINI_1_0_PRO"] = "gemini-1.0-pro";
+    GoogleAIModels["GEMINI_2_5_PRO"] = "gemini-2.5-pro";
+    GoogleAIModels["GEMINI_2_5_FLASH"] = "gemini-2.5-flash";
+    GoogleAIModels["GEMINI_1_5_FLASH_LITE"] = "gemini-2.5-flash-lite";
 })(GoogleAIModels || (GoogleAIModels = {}));
 /**
  * Default provider configurations

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export declare const VERSION = "1.0.0";
  *
  * @example
  * ```typescript
- * import { createAIProvider } from 'neurolink';
+ * import { createAIProvider } from '@juspay/neurolink';
  *
  * const provider = await createAIProvider('bedrock');
  * const result = await provider.streamText('Hello, AI!');
@@ -34,7 +34,7 @@ export declare function createAIProvider(providerName?: string, modelName?: stri
  *
  * @example
  * ```typescript
- * import { createAIProviderWithFallback } from 'neurolink';
+ * import { createAIProviderWithFallback } from '@juspay/neurolink';
  *
  * const { primary, fallback } = await createAIProviderWithFallback('bedrock', 'vertex');
  * ```
@@ -48,7 +48,7 @@ export declare function createAIProviderWithFallback(primaryProvider?: string, f
  *
  * @example
  * ```typescript
- * import { createBestAIProvider } from 'neurolink';
+ * import { createBestAIProvider } from '@juspay/neurolink';
  *
  * const provider = await createBestAIProvider();
  * ```
@@ -62,7 +62,7 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  *
  * @example
  * ```typescript
- * import { mcpEcosystem, readFile, writeFile } from 'neurolink';
+ * import { mcpEcosystem, readFile, writeFile } from '@juspay/neurolink';
  *
  * // Initialize the ecosystem
  * await mcpEcosystem.initialize();
@@ -77,3 +77,8 @@ export declare function createBestAIProvider(requestedProvider?: string, modelNa
  */
 export { MCPEcosystem, mcpEcosystem, initializeMCPEcosystem, PluginManager, pluginManager, listMCPs, executeMCP, getMCPStats, readFile, writeFile, listFiles, createDirectory, MCP, SecurityManager, mcpLogger, FileSystemMCP, } from "./mcp/index.js";
 export type { MCPMetadata, ExecutionContext, MCPConstructor, MCPInstance, DiscoveredMCP, LogLevel, } from "./mcp/index.js";
+export declare function initializeTelemetry(): Promise<boolean>;
+export declare function getTelemetryStatus(): {
+    enabled: boolean;
+    initialized: boolean;
+};

package/dist/index.js

@@ -25,7 +25,7 @@ export const VERSION = "1.0.0";
  *
  * @example
  * ```typescript
- * import { createAIProvider } from 'neurolink';
+ * import { createAIProvider } from '@juspay/neurolink';
  *
  * const provider = await createAIProvider('bedrock');
  * const result = await provider.streamText('Hello, AI!');
@@ -39,7 +39,7 @@ export async function createAIProvider(providerName, modelName) {
  *
  * @example
  * ```typescript
- * import { createAIProviderWithFallback } from 'neurolink';
+ * import { createAIProviderWithFallback } from '@juspay/neurolink';
  *
  * const { primary, fallback } = await createAIProviderWithFallback('bedrock', 'vertex');
  * ```
@@ -52,7 +52,7 @@ export async function createAIProviderWithFallback(primaryProvider, fallbackProv
  *
  * @example
  * ```typescript
- * import { createBestAIProvider } from 'neurolink';
+ * import { createBestAIProvider } from '@juspay/neurolink';
  *
  * const provider = await createBestAIProvider();
  * ```
@@ -71,7 +71,7 @@ export async function createBestAIProvider(requestedProvider, modelName) {
  *
  * @example
  * ```typescript
- * import { mcpEcosystem, readFile, writeFile } from 'neurolink';
+ * import { mcpEcosystem, readFile, writeFile } from '@juspay/neurolink';
  *
  * // Initialize the ecosystem
  * await mcpEcosystem.initialize();
@@ -95,3 +95,24 @@ readFile, writeFile, listFiles, createDirectory,
 MCP, SecurityManager, mcpLogger, 
 // Core plugins
 FileSystemMCP, } from "./mcp/index.js";
+// ============================================================================
+// REAL-TIME SERVICES & TELEMETRY - Enterprise Platform Features
+// ============================================================================
+// Real-time Services (Phase 1) - Basic SSE functionality only
+// export { createEnhancedChatService } from './chat/index.js';
+// export type * from './services/types.js';
+// Optional Telemetry (Phase 2) - Conditional export based on feature flag
+export async function initializeTelemetry() {
+    if (process.env.NEUROLINK_TELEMETRY_ENABLED === "true") {
+        const { initializeTelemetry: init } = await import("./telemetry/index.js");
+        const result = await init();
+        return !!result; // Convert TelemetryService to boolean
+    }
+    return Promise.resolve(false);
+}
+export function getTelemetryStatus() {
+    if (process.env.NEUROLINK_TELEMETRY_ENABLED === "true") {
+        return { enabled: true, initialized: false };
+    }
+    return { enabled: false, initialized: false };
+}

package/dist/lib/agent/direct-tools.d.ts

@@ -220,8 +220,8 @@ export declare const directAgentTools: {
         mode: z.ZodDefault<z.ZodEnum<["create", "overwrite", "append"]>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        content: string;
         mode: "create" | "overwrite" | "append";
+        content: string;
     }, {
         path: string;
         content: string;
@@ -250,8 +250,8 @@ export declare const directAgentTools: {
     }> & {
         execute: (args: {
             path: string;
-            content: string;
             mode: "create" | "overwrite" | "append";
+            content: string;
         }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
             success: boolean;
             error: string;
@@ -563,8 +563,8 @@ export declare function getToolsForCategory(category?: "basic" | "filesystem" |
         mode: z.ZodDefault<z.ZodEnum<["create", "overwrite", "append"]>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        content: string;
         mode: "create" | "overwrite" | "append";
+        content: string;
     }, {
         path: string;
         content: string;
@@ -593,8 +593,8 @@ export declare function getToolsForCategory(category?: "basic" | "filesystem" |
     }> & {
         execute: (args: {
             path: string;
-            content: string;
             mode: "create" | "overwrite" | "append";
+            content: string;
         }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
             success: boolean;
             error: string;
@@ -907,8 +907,8 @@ export declare function getToolsForCategory(category?: "basic" | "filesystem" |
         mode: z.ZodDefault<z.ZodEnum<["create", "overwrite", "append"]>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        content: string;
         mode: "create" | "overwrite" | "append";
+        content: string;
     }, {
         path: string;
         content: string;
@@ -937,8 +937,8 @@ export declare function getToolsForCategory(category?: "basic" | "filesystem" |
     }> & {
         execute: (args: {
             path: string;
-            content: string;
             mode: "create" | "overwrite" | "append";
+            content: string;
         }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
             success: boolean;
             error: string;

package/dist/lib/chat/client-utils.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Phase 3: SSE Chat Utilities
+ * Client-side utilities for SSE chat integration
+ */
+import type { ChatMessage } from "./types.js";
+export interface ChatClientOptions {
+    endpoint: string;
+    sessionId: string;
+    onMessage?: (message: ChatMessage) => void;
+    onError?: (error: Error) => void;
+    onConnect?: () => void;
+    onDisconnect?: () => void;
+    reconnectAttempts?: number;
+    reconnectDelay?: number;
+}
+export interface ChatStreamHook {
+    messages: ChatMessage[];
+    isConnected: boolean;
+    isReconnecting: boolean;
+    sendMessage: (content: string) => Promise<void>;
+    disconnect: () => void;
+    reconnect: () => void;
+    clearHistory: () => void;
+}
+/**
+ * Client for SSE chat communication
+ */
+export declare class ChatClient {
+    private eventSource?;
+    private options;
+    private messages;
+    private reconnectCount;
+    private isConnected;
+    private isReconnecting;
+    private reconnectTimeout?;
+    constructor(options: ChatClientOptions);
+    /**
+     * Connect to SSE endpoint
+     */
+    connect(): void;
+    /**
+     * Send message to chat
+     */
+    sendMessage(content: string): Promise<void>;
+    /**
+     * Disconnect from SSE endpoint
+     */
+    disconnect(): void;
+    /**
+     * Get message history
+     */
+    getMessages(): ChatMessage[];
+    /**
+     * Clear message history
+     */
+    clearMessages(): void;
+    /**
+     * Check connection status
+     */
+    getConnectionStatus(): {
+        connected: boolean;
+        reconnecting: boolean;
+        reconnectCount: number;
+    };
+    private handleSSEEvent;
+    private handleDataEvent;
+    private handleErrorEvent;
+    private handleCompleteEvent;
+    private scheduleReconnect;
+}
+/**
+ * Create chat client instance
+ */
+export declare function createChatClient(options: ChatClientOptions): ChatClient;
+/**
+ * React-style hook for chat streaming (can be adapted for other frameworks)
+ */
+export declare function useChatStream(options: ChatClientOptions): ChatStreamHook;
+/**
+ * Utility for creating SSE EventSource with automatic reconnection
+ */
+export declare function createSSEConnection(url: string, options?: {
+    onMessage?: (event: MessageEvent) => void;
+    onError?: (error: Error) => void;
+    onOpen?: () => void;
+    reconnect?: boolean;
+    maxReconnectAttempts?: number;
+}): {
+    connect: () => void;
+    disconnect: () => void;
+    isConnected: () => boolean;
+};