@juspay/neurolink 7.51.1 → 7.51.3

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

@@ -6,19 +6,19 @@ import type { ToolExecution } from "./tools.js";
  * Represents the analysis of the user's query intent.
  * This provides a basic understanding of what the user is trying to achieve.
  */
-export interface QueryIntentAnalysis {
+export type QueryIntentAnalysis = {
     /** The type of query, e.g., asking a question or giving a command. */
     type: "question" | "command" | "greeting" | "unknown";
     /** The estimated complexity of the query. */
     complexity: "low" | "medium" | "high";
     /** Whether the query likely required the use of tools to be answered correctly. */
     shouldHaveUsedTools: boolean;
-}
+};
 /**
  * Represents a single turn in an enhanced conversation history,
  * including tool executions and evaluations for richer context.
  */
-export interface EnhancedConversationTurn {
+export type EnhancedConversationTurn = {
     /** The role of the speaker, either 'user' or 'assistant'. */
     role: "user" | "assistant";
     /** The content of the message. */
@@ -29,12 +29,12 @@ export interface EnhancedConversationTurn {
     toolExecutions?: ToolExecution[];
     /** The evaluation result for this turn, if applicable. */
     evaluation?: EvaluationResult;
-}
+};
 /**
  * Contains all the rich context needed for a thorough, RAGAS-style evaluation.
  * This object is constructed by the `ContextBuilder` and used by the `RAGASEvaluator`.
  */
-export interface EnhancedEvaluationContext {
+export type EnhancedEvaluationContext = {
     /** The original user query. */
     userQuery: string;
     /** An analysis of the user's query intent. */
@@ -63,11 +63,11 @@ export interface EnhancedEvaluationContext {
     previousEvaluations?: EvaluationResult[];
     /** The current attempt number for this evaluation (1-based). */
     attemptNumber: number;
-}
+};
 /**
  * Represents the result of a single evaluation attempt, based on RAGAS principles.
  */
-export interface EvaluationResult {
+export type EvaluationResult = {
     /** The final, overall score for the response, typically from 1 to 10. */
     finalScore: number;
     /** How well the response addresses the user's query. */
@@ -90,11 +90,11 @@ export interface EvaluationResult {
     evaluationTime: number;
     /** The attempt number for this evaluation. */
     attemptNumber: number;
-}
+};
 /**
  * Provides detailed information when a response fails quality assurance checks.
  */
-export interface QualityErrorDetails {
+export type QualityErrorDetails = {
     /** The history of all evaluation attempts for this response. */
     evaluationHistory: EvaluationResult[];
     /** The final score of the last attempt. */
@@ -103,11 +103,11 @@ export interface QualityErrorDetails {
     attempts: number;
     /** A summary message of the failure. */
     message: string;
-}
+};
 /**
  * Configuration for the main `Evaluator` class.
  */
-export interface EvaluationConfig {
+export type EvaluationConfig = {
     /** The minimum score (1-10) for a response to be considered passing. */
     threshold?: number;
     /** The evaluation strategy to use. Currently only 'ragas' is supported. */
@@ -129,7 +129,7 @@ export interface EvaluationConfig {
     highSeverityThreshold?: number;
     /** An optional function to generate custom evaluation prompts. */
     promptGenerator?: GetPromptFunction;
-}
+};
 /**
  * A function that generates the main body of an evaluation prompt.
  */

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

@@ -14,7 +14,7 @@ export type MCPTransportType = "stdio" | "sse" | "websocket";
 /**
  * External MCP server configuration for process spawning
  */
-export interface ExternalMCPServerConfig {
+export type ExternalMCPServerConfig = {
     /** Unique identifier for the server */
     id: string;
     /** Command to execute (e.g., 'npx', 'node', 'python') */
@@ -39,11 +39,11 @@ export interface ExternalMCPServerConfig {
     url?: string;
     /** Additional metadata */
     metadata?: Record<string, JsonValue>;
-}
+};
 /**
  * Runtime state of an external MCP server instance
  */
-export interface ExternalMCPServerInstance {
+export type ExternalMCPServerInstance = {
     /** Server configuration */
     config: ExternalMCPServerConfig;
     /** Child process (for stdio transport) */
@@ -87,7 +87,7 @@ export interface ExternalMCPServerInstance {
         averageResponseTime: number;
         lastResponseTime: number;
     };
-}
+};
 /**
  * External MCP server status states
  */
@@ -95,7 +95,7 @@ export type ExternalMCPServerStatus = "initializing" | "connecting" | "connected
 /**
  * Tool information from external MCP server
  */
-export interface ExternalMCPToolInfo {
+export type ExternalMCPToolInfo = {
     /** Tool name */
     name: string;
     /** Tool description */
@@ -118,11 +118,11 @@ export interface ExternalMCPToolInfo {
         averageExecutionTime: number;
         lastExecutionTime: number;
     };
-}
+};
 /**
  * External MCP server health status
  */
-export interface ExternalMCPServerHealth {
+export type ExternalMCPServerHealth = {
     /** Server ID */
     serverId: string;
     /** Whether the server is healthy */
@@ -144,11 +144,11 @@ export interface ExternalMCPServerHealth {
         cpuUsage?: number;
         averageResponseTime: number;
     };
-}
+};
 /**
  * External MCP server configuration validation result
  */
-export interface ExternalMCPConfigValidation {
+export type ExternalMCPConfigValidation = {
     /** Whether the configuration is valid */
     isValid: boolean;
     /** Validation errors */
@@ -157,11 +157,11 @@ export interface ExternalMCPConfigValidation {
     warnings: string[];
     /** Suggestions for improvement */
     suggestions: string[];
-}
+};
 /**
  * External MCP server operation result
  */
-export interface ExternalMCPOperationResult<T = unknown> {
+export type ExternalMCPOperationResult<T = unknown> = {
     /** Whether the operation was successful */
     success: boolean;
     /** Result data if successful */
@@ -178,11 +178,11 @@ export interface ExternalMCPOperationResult<T = unknown> {
         operation: string;
         [key: string]: JsonValue;
     };
-}
+};
 /**
  * External MCP tool execution context
  */
-export interface ExternalMCPToolContext {
+export type ExternalMCPToolContext = {
     /** Execution session ID */
     sessionId: string;
     /** User ID if available */
@@ -195,11 +195,11 @@ export interface ExternalMCPToolContext {
     timeout?: number;
     /** Additional context data */
     metadata?: Record<string, JsonValue>;
-}
+};
 /**
  * External MCP tool execution result
  */
-export interface ExternalMCPToolResult {
+export type ExternalMCPToolResult = {
     /** Whether the execution was successful */
     success: boolean;
     /** Result data if successful */
@@ -215,11 +215,11 @@ export interface ExternalMCPToolResult {
         timestamp: number;
         [key: string]: JsonValue;
     };
-}
+};
 /**
  * External MCP server events
  */
-export interface ExternalMCPServerEvents {
+export type ExternalMCPServerEvents = {
     /** Server status changed */
     statusChanged: {
         serverId: string;
@@ -264,11 +264,11 @@ export interface ExternalMCPServerEvents {
         health: ExternalMCPServerHealth;
         timestamp: Date;
     };
-}
+};
 /**
  * External MCP manager configuration
  */
-export interface ExternalMCPManagerConfig {
+export type ExternalMCPManagerConfig = {
     /** Maximum number of concurrent servers */
     maxServers?: number;
     /** Default timeout for operations */
@@ -285,4 +285,4 @@ export interface ExternalMCPManagerConfig {
     enablePerformanceMonitoring?: boolean;
     /** Log level for external MCP operations */
     logLevel?: "debug" | "info" | "warn" | "error";
-}
+};

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

@@ -2,7 +2,7 @@ import type { LanguageModelV1 } from "ai";
 /**
  * Result from precall evaluation of user input
  */
-export interface PrecallEvaluationResult {
+export type PrecallEvaluationResult = {
     overall: "safe" | "unsafe" | "suspicious" | "inappropriate";
     safetyScore: number;
     appropriatenessScore: number;
@@ -14,25 +14,25 @@ export interface PrecallEvaluationResult {
     }[];
     suggestedAction: "allow" | "block" | "sanitize" | "warn";
     reasoning?: string;
-}
+};
 export type IssueCategory = "explicit_content" | "hate_speech" | "violence" | "personal_info" | "spam" | "other";
 export type IssueSeverity = "low" | "medium" | "high" | "critical";
 export type EvaluationAction = "allow" | "block" | "sanitize" | "warn";
 export type SafetyStatus = "safe" | "unsafe" | "suspicious" | "inappropriate";
-export interface EvaluationActions {
+export type EvaluationActions = {
     onUnsafe?: "block" | "sanitize" | "warn" | "log";
     onInappropriate?: "block" | "sanitize" | "warn" | "log";
     onSuspicious?: "warn" | "log" | "allow";
-}
-export interface EvaluationThresholds {
+};
+export type EvaluationThresholds = {
     safetyScore?: number;
     appropriatenessScore?: number;
     confidenceLevel?: number;
-}
+};
 /**
  * Configuration for precall evaluation using AI models
  */
-export interface PrecallEvaluationConfig {
+export type PrecallEvaluationConfig = {
     enabled?: boolean;
     provider?: string;
     evaluationModel?: string;
@@ -63,8 +63,8 @@ export interface PrecallEvaluationConfig {
      * - '[FILTERED]'
      */
     replacementText?: string;
-}
-export interface BadWordsConfig {
+};
+export type BadWordsConfig = {
     enabled?: boolean;
     list?: string[];
     regexPatterns?: string[];
@@ -79,25 +79,25 @@ export interface BadWordsConfig {
      * - '[FILTERED]'
      */
     replacementText?: string;
-}
-export interface ModelFilterConfig {
+};
+export type ModelFilterConfig = {
     enabled?: boolean;
     filterModel?: LanguageModelV1;
-}
+};
 /**
  * Configuration for the Guardrails middleware
  */
-export interface GuardrailsMiddlewareConfig {
+export type GuardrailsMiddlewareConfig = {
     badWords?: BadWordsConfig;
     modelFilter?: ModelFilterConfig;
     precallEvaluation?: PrecallEvaluationConfig;
-}
-export interface EvaluationActionResult {
+};
+export type EvaluationActionResult = {
     shouldBlock: boolean;
     sanitizedInput?: string;
-}
-export interface EvaluationIssue {
+};
+export type EvaluationIssue = {
     category: IssueCategory;
     severity: IssueSeverity;
     description: string;
-}
+};

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

@@ -3,10 +3,10 @@ import type { JsonValue } from "../types/common.js";
 import type { EvaluationData } from "./evaluation.js";
 import type { GetPromptFunction } from "./evaluationTypes.js";
 /**
- * Metadata interface for NeuroLink middleware
+ * Metadata type for NeuroLink middleware
  * Provides additional information about middleware without affecting execution
  */
-export interface NeuroLinkMiddlewareMetadata {
+export type NeuroLinkMiddlewareMetadata = {
     /** Unique identifier for the middleware */
     id: string;
     /** Human-readable name */
@@ -19,30 +19,30 @@ export interface NeuroLinkMiddlewareMetadata {
     defaultEnabled?: boolean;
     /** Configuration schema for the middleware */
     configSchema?: Record<string, unknown>;
-}
+};
 /**
  * NeuroLink middleware with metadata
  * Combines standard AI SDK middleware with NeuroLink-specific metadata
  */
-export interface NeuroLinkMiddleware extends LanguageModelV1Middleware {
+export type NeuroLinkMiddleware = LanguageModelV1Middleware & {
     /** Middleware metadata */
     readonly metadata: NeuroLinkMiddlewareMetadata;
-}
+};
 /**
  * Middleware configuration options
  */
-export interface MiddlewareConfig {
+export type MiddlewareConfig = {
     /** Whether the middleware is enabled */
     enabled?: boolean;
     /** Middleware-specific configuration */
     config?: Record<string, unknown>;
     /** Conditions under which to apply this middleware */
     conditions?: MiddlewareConditions;
-}
+};
 /**
  * Conditions for applying middleware
  */
-export interface MiddlewareConditions {
+export type MiddlewareConditions = {
     /** Apply only to specific providers */
     providers?: string[];
     /** Apply only to specific models */
@@ -51,11 +51,11 @@ export interface MiddlewareConditions {
     options?: Record<string, unknown>;
     /** Custom condition function */
     custom?: (context: MiddlewareContext) => boolean;
-}
+};
 /**
  * Context passed to middleware for decision making
  */
-export interface MiddlewareContext {
+export type MiddlewareContext = {
     /** Provider name */
     provider: string;
     /** Model name */
@@ -69,22 +69,22 @@ export interface MiddlewareContext {
     };
     /** Additional metadata */
     metadata?: Record<string, JsonValue>;
-}
+};
 /**
  * Middleware registration options
  */
-export interface MiddlewareRegistrationOptions {
+export type MiddlewareRegistrationOptions = {
     /** Whether to replace existing middleware with same ID */
     replace?: boolean;
     /** Whether to enable the middleware by default */
     defaultEnabled?: boolean;
     /** Global configuration for the middleware */
     globalConfig?: Record<string, JsonValue>;
-}
+};
 /**
  * Middleware execution result
  */
-export interface MiddlewareExecutionResult {
+export type MiddlewareExecutionResult = {
     /** Whether the middleware was applied */
     applied: boolean;
     /** Execution time in milliseconds */
@@ -93,11 +93,11 @@ export interface MiddlewareExecutionResult {
     error?: Error;
     /** Additional metadata from the middleware */
     metadata?: Record<string, JsonValue>;
-}
+};
 /**
  * Middleware chain execution statistics
  */
-export interface MiddlewareChainStats {
+export type MiddlewareChainStats = {
     /** Total number of middleware in the chain */
     totalMiddleware: number;
     /** Number of middleware that were applied */
@@ -106,7 +106,7 @@ export interface MiddlewareChainStats {
     totalExecutionTime: number;
     /** Individual middleware execution results */
     results: Record<string, MiddlewareExecutionResult>;
-}
+};
 /**
  * Built-in middleware types
  */
@@ -114,18 +114,18 @@ export type BuiltInMiddlewareType = "analytics" | "guardrails" | "logging" | "ca
 /**
  * Middleware preset configurations
  */
-export interface MiddlewarePreset {
+export type MiddlewarePreset = {
     /** Preset name */
     name: string;
     /** Description of the preset */
     description: string;
     /** Middleware configurations in the preset */
     config: Record<string, MiddlewareConfig>;
-}
+};
 /**
  * Factory options for middleware
  */
-export interface MiddlewareFactoryOptions {
+export type MiddlewareFactoryOptions = {
     /** Custom middleware to register on initialization */
     middleware?: NeuroLinkMiddleware[];
     /** Enable specific middleware */
@@ -145,11 +145,11 @@ export interface MiddlewareFactoryOptions {
         /** Whether to collect execution statistics */
         collectStats?: boolean;
     };
-}
+};
 /**
  * Configuration for the Auto-Evaluation Middleware.
  */
-export interface AutoEvaluationConfig {
+export type AutoEvaluationConfig = {
     /** The minimum score (1-10) for a response to be considered passing. */
     threshold?: number;
     /** The maximum number of retry attempts before failing. */
@@ -169,4 +169,67 @@ export interface AutoEvaluationConfig {
     highSeverityThreshold?: number;
     promptGenerator?: GetPromptFunction;
     provider?: string;
-}
+};
+/**
+ * Middleware factory configuration options
+ */
+export type MiddlewareFactoryConfig = {
+    enabled: boolean;
+    type: string;
+    priority?: number;
+    config?: Record<string, unknown>;
+};
+/**
+ * Middleware registry entry
+ */
+export type MiddlewareRegistryEntry = {
+    name: string;
+    factory: MiddlewareFactory;
+    defaultConfig: Record<string, unknown>;
+    description?: string;
+    version?: string;
+};
+/**
+ * Middleware factory function type
+ */
+export type MiddlewareFactory = (config: Record<string, unknown>) => LanguageModelV1Middleware;
+/**
+ * Middleware validation result
+ */
+export type MiddlewareValidationResult = {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Middleware execution context
+ */
+export type MiddlewareExecutionContext = {
+    requestId: string;
+    timestamp: number;
+    provider: string;
+    model: string;
+    userId?: string;
+    sessionId?: string;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * Middleware performance metrics
+ */
+export type MiddlewareMetrics = {
+    name: string;
+    executionTime: number;
+    status: "success" | "error" | "skipped";
+    error?: string;
+    inputSize: number;
+    outputSize: number;
+};
+/**
+ * Middleware chain configuration
+ */
+export type MiddlewareChainConfig = {
+    middlewares: MiddlewareFactoryConfig[];
+    errorHandling: "continue" | "stop" | "rollback";
+    timeout?: number;
+    retries?: number;
+};