@juspay/neurolink 9.54.6 → 9.54.8

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

@@ -1,6 +1,8 @@
 /**
  * Common utility types for NeuroLink
  */
+import type { NeuroLink } from "../neurolink.js";
+import type { ConversationMemoryConfig } from "./conversation.js";
 import type { AutoresearchErrorEvent, AutoresearchExperimentCompletedEvent, AutoresearchExperimentStartedEvent, AutoresearchInitializedEvent, AutoresearchMetricImprovedEvent, AutoresearchPhaseChangedEvent, AutoresearchResumedEvent, AutoresearchRevertEvent, AutoresearchRevertFailedEvent, AutoresearchStateUpdatedEvent } from "./autoresearch.js";
 /**
  * Type-safe unknown value - use when type is truly unknown
@@ -204,47 +206,6 @@ export type InfraRetryOptions = {
     maxDelayMs?: number;
     shouldRetry?: (error: Error) => boolean;
 };
-/**
- * Configuration options for retry operations with exponential backoff.
- * Named AsyncRetryOptions to avoid collision with utilities.ts RetryOptions.
- */
-export type AsyncRetryOptions = {
-    /**
-     * Maximum number of retry attempts (not including the initial attempt).
-     * @default 3
-     */
-    maxRetries: number;
-    /**
-     * Initial delay between retries in milliseconds.
-     * @default 1000
-     */
-    baseDelayMs: number;
-    /**
-     * Maximum delay cap in milliseconds.
-     * @default 30000
-     */
-    maxDelayMs: number;
-    /**
-     * Multiplier for exponential backoff.
-     * @default 2
-     */
-    backoffMultiplier?: number;
-    /**
-     * Function to determine if a retry should be attempted.
-     * Return false to stop retrying immediately.
-     */
-    shouldRetry?: (error: Error, attempt: number) => boolean;
-    /**
-     * Whether to add random jitter to backoff delays to prevent thundering herd.
-     * @default true
-     */
-    addJitter?: boolean;
-    /**
-     * Callback invoked before each retry attempt.
-     * Useful for logging or metrics.
-     */
-    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
-};
 /**
  * Raw usage object that may come from various AI providers.
  * Supports multiple naming conventions and nested structures.
@@ -441,3 +402,13 @@ export type StreamingParser = {
 export type HippocampusMemory = import("@juspay/hippocampus").HippocampusConfig & {
     enabled?: boolean;
 };
+/** Value types accepted as session variables by the loop REPL. */
+export type SessionVariableValue = string | number | boolean;
+/** State snapshot for the active REPL loop session. */
+export type LoopSessionState = {
+    neurolinkInstance: NeuroLink;
+    sessionId: string;
+    isActive: boolean;
+    conversationMemoryConfig?: ConversationMemoryConfig;
+    sessionVariables: Record<string, SessionVariableValue>;
+};

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

@@ -463,4 +463,9 @@ export type DeduplicationResult = {
     messages: ChatMessage[];
     filesDeduped: number;
 };
+/** Options for FileSummarizationService. */
+export type FileSummarizationServiceOptions = {
+    provider?: string;
+    model?: string;
+};
 export {};

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

@@ -7,7 +7,7 @@ import type { TokenUsage } from "./analytics.js";
 import type { GenerateResult } from "./generate.js";
 import type { ToolExecution } from "./tools.js";
 import type { JsonObject } from "./common.js";
-import type { AggregatedScores, PipelineConfig, ScorerInput } from "./scorer.js";
+import type { AggregatedScores, EvaluationTraceContext, PipelineConfig, ReportConfig, ReportFormat, ScoreResult, ScorerInput } from "./scorer.js";
 /**
  * Evaluation provider type as specified in core module refactoring
  */
@@ -318,3 +318,334 @@ export type ScorerFunction = (input: ScorerInput) => Promise<{
     reasoning: string;
     metadata?: JsonObject;
 }>;
+/**
+ * Superset batch progress. `pending` is canonical; `remaining` in the
+ * pipeline's batchStrategy was renamed during consolidation (same value).
+ */
+export type BatchProgress = {
+    total: number;
+    completed: number;
+    failed: number;
+    pending: number;
+    percentComplete: number;
+    succeeded?: number;
+    estimatedTimeRemaining?: number;
+};
+/** Input item for BatchEvaluator. */
+export type BatchEvaluationItem = {
+    id: string;
+    options: LanguageModelV3CallOptions;
+    result: GenerateResult;
+    threshold?: number;
+};
+/** Result of a single item in BatchEvaluator. */
+export type BatchEvaluationItemResult = {
+    id: string;
+    success: boolean;
+    data?: EvaluationData;
+    error?: {
+        message: string;
+        code?: string;
+        retryable?: boolean;
+    };
+    duration: number;
+    retryCount: number;
+};
+/** Result of a single item in the pipeline batchStrategy. */
+export type BatchItemResult = {
+    index: number;
+    input: ScorerInput;
+    result?: PipelineResult;
+    error?: string;
+    duration: number;
+};
+/**
+ * Superset batch evaluation config. Union of pre-consolidation types
+ * (BatchEvaluationConfig in BatchEvaluator, BatchConfig in batchStrategy).
+ */
+export type BatchEvaluationConfig = EvaluationConfig & {
+    concurrency?: number;
+    continueOnError?: boolean;
+    onProgress?: (progress: BatchProgress) => void;
+    maxRetries?: number;
+    retryDelay?: number;
+    onItemComplete?: (result: BatchEvaluationItemResult) => void;
+    batchDelay?: number;
+    onResult?: (result: BatchItemResult) => void;
+};
+/**
+ * Superset batch-result. `results` is a union of both item-result flavors;
+ * summary field names chosen from BatchEvaluator (`succeeded`, `passingRate`).
+ */
+export type BatchEvaluationResult = {
+    results: BatchEvaluationItemResult[] | BatchItemResult[];
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+        averageScore: number;
+        averageDuration: number;
+        totalDuration: number;
+        passingRate: number;
+    };
+    allSucceeded?: boolean;
+};
+/** Statistical summary of evaluation scores. */
+export type ScoreStatistics = {
+    min: number;
+    max: number;
+    mean: number;
+    median: number;
+    stdDev: number;
+    variance: number;
+    p25: number;
+    p75: number;
+    p90: number;
+    p95: number;
+};
+/** Score distribution across ranges. */
+export type ScoreDistribution = {
+    /** Items scoring 1-3 (poor) */
+    poor: number;
+    /** Items scoring 4-5 (below average) */
+    belowAverage: number;
+    /** Items scoring 6-7 (average) */
+    average: number;
+    /** Items scoring 8-9 (good) */
+    good: number;
+    /** Items scoring 10 (excellent) */
+    excellent: number;
+};
+/** Trend analysis results. */
+export type TrendAnalysis = {
+    direction: "improving" | "declining" | "stable";
+    slope: number;
+    rSquared: number;
+    percentChange: number;
+    movingAverage: number;
+};
+/** Dimension-specific analysis for RAGAS metrics. */
+export type DimensionAnalysis = {
+    relevance: ScoreStatistics;
+    accuracy: ScoreStatistics;
+    completeness: ScoreStatistics;
+    overall: ScoreStatistics;
+    correlations: {
+        relevanceAccuracy: number;
+        relevanceCompleteness: number;
+        accuracyCompleteness: number;
+    };
+};
+/** Quality alerts summary. */
+export type AlertSummary = {
+    total: number;
+    high: number;
+    medium: number;
+    offTopic: number;
+    alertRate: number;
+};
+/** Comprehensive aggregation result. */
+export type AggregationResult = {
+    count: number;
+    statistics: ScoreStatistics;
+    distribution: ScoreDistribution;
+    dimensions: DimensionAnalysis;
+    sequenceTrend?: TrendAnalysis;
+    alerts: AlertSummary;
+    passingRate: number;
+    avgEvaluationTime: number;
+    metadata: {
+        aggregatedAt: string;
+        threshold: number;
+        evaluationModels: string[];
+    };
+};
+/** Configuration preset for common evaluation scenarios. */
+export type EvaluatorPreset = {
+    name: string;
+    description: string;
+    config?: EvaluationConfig;
+};
+/** Configuration for evaluation strategies. */
+export type EvaluationStrategyConfig = {
+    evaluationModel?: string;
+    provider?: string;
+    threshold?: number;
+    promptGenerator?: (context: {
+        userQuery: string;
+        history: string;
+        tools: string;
+        retryInfo: string;
+        aiResponse: string;
+    }) => string;
+    options?: Record<string, unknown>;
+};
+/** Function that performs evaluation and returns results. */
+export type EvaluationStrategyFunction = (options: LanguageModelV3CallOptions, result: GenerateResult, config?: EvaluationStrategyConfig) => Promise<{
+    evaluationResult: EvaluationResult;
+    evalContext: EnhancedEvaluationContext;
+}>;
+/** Metadata for registered evaluation strategies. */
+export type EvaluationStrategyMetadata = {
+    name: string;
+    description: string;
+    requiresLLM: boolean;
+    defaultModel?: string;
+    defaultProvider?: string;
+    version: string;
+    features: string[];
+};
+/** Canonical evaluation error code. */
+export type EvaluationErrorCode = "EVALUATION_FAILED" | "PARSE_ERROR" | "STRATEGY_NOT_FOUND" | "PROVIDER_ERROR" | "CONFIGURATION_ERROR" | "CUSTOM_EVALUATOR_ERROR" | "BATCH_EVALUATION_ERROR" | "AGGREGATION_ERROR" | "REGISTRY_ERROR" | "MAX_RETRIES_EXCEEDED" | "TIMEOUT_ERROR" | "RATE_LIMIT_ERROR";
+/** Extended evaluation context for error details. */
+export type EvaluationErrorContext = {
+    userQueryLength?: number;
+    aiResponseLength?: number;
+    attemptNumber?: number;
+    previousScores?: number[];
+    strategy?: string;
+    evaluationModel?: string;
+    provider?: string;
+    rawResponseLength?: number;
+    additionalContext?: Record<string, unknown>;
+};
+/** Minimal Langfuse client interface for evaluation hooks. */
+export type LangfuseClient = {
+    score: (params: {
+        name: string;
+        value: number;
+        traceId?: string;
+        observationId?: string;
+        comment?: string;
+        metadata?: Record<string, unknown>;
+    }) => Promise<unknown>;
+    trace?: (params: {
+        name: string;
+        metadata?: Record<string, unknown>;
+        tags?: string[];
+    }) => {
+        id: string;
+    };
+    shutdown?: () => Promise<void>;
+};
+/** Langfuse adapter configuration. */
+export type LangfuseAdapterConfig = {
+    client: LangfuseClient;
+    scorePrefix?: string;
+    includeMetadata?: boolean;
+    tags?: string[];
+    sendPipelineScores?: boolean;
+    sendScorerScores?: boolean;
+};
+/** Events emitted by the evaluation pipeline. */
+export type EvaluationEvents = {
+    "scorer:start": {
+        scorerId: string;
+        scorerName: string;
+        timestamp: number;
+        traceContext?: EvaluationTraceContext;
+    };
+    "scorer:end": {
+        scorerId: string;
+        scorerName: string;
+        result: ScoreResult;
+        timestamp: number;
+        duration: number;
+        traceContext?: EvaluationTraceContext;
+    };
+    "scorer:error": {
+        scorerId: string;
+        scorerName: string;
+        error: string;
+        timestamp: number;
+        traceContext?: EvaluationTraceContext;
+    };
+    "pipeline:start": {
+        pipelineName: string;
+        scorerCount: number;
+        timestamp: number;
+        correlationId: string;
+        traceContext?: EvaluationTraceContext;
+    };
+    "pipeline:end": {
+        pipelineName: string;
+        result: PipelineResult;
+        timestamp: number;
+        duration: number;
+        traceContext?: EvaluationTraceContext;
+    };
+    "pipeline:error": {
+        pipelineName: string;
+        error: string;
+        timestamp: number;
+        traceContext?: EvaluationTraceContext;
+    };
+};
+/**
+ * Flat span attribute map used by the evaluation observability layer.
+ * Named EvaluationSpanAttributes to disambiguate from the richer telemetry
+ * SpanAttributes in span.ts (§Rule 9 domain prefix).
+ */
+export type EvaluationSpanAttributes = Record<string, string | number | boolean>;
+/** Metrics captured per scorer execution. */
+export type ScorerMetrics = {
+    scorerId: string;
+    scorerName: string;
+    totalExecutions: number;
+    successfulExecutions: number;
+    failedExecutions: number;
+    passedCount: number;
+    failedCount: number;
+    totalScore: number;
+    minScore: number;
+    maxScore: number;
+    totalDuration: number;
+    averageDuration: number;
+    averageScore: number;
+    passRate: number;
+    lastExecutionTime: number;
+};
+/** Metrics captured per evaluation pipeline. */
+export type PipelineMetrics = {
+    pipelineName: string;
+    totalExecutions: number;
+    passedCount: number;
+    failedCount: number;
+    totalScore: number;
+    minScore: number;
+    maxScore: number;
+    totalDuration: number;
+    averageDuration: number;
+    averageScore: number;
+    passRate: number;
+    lastExecutionTime: number;
+    scorerMetrics: Map<string, ScorerMetrics>;
+};
+/** Aggregated metrics across pipelines and scorers. */
+export type AggregatedMetrics = {
+    totalEvaluations: number;
+    overallPassRate: number;
+    averageScore: number;
+    averageDuration: number;
+    scoreDistribution: {
+        excellent: number;
+        good: number;
+        fair: number;
+        poor: number;
+        failing: number;
+    };
+    pipelineMetrics: Map<string, PipelineMetrics>;
+    scorerMetrics: Map<string, ScorerMetrics>;
+    collectionStartTime: number;
+    lastUpdateTime: number;
+};
+/** Generated evaluation report envelope. */
+export type GeneratedReport = {
+    format: ReportFormat;
+    content: string;
+    metadata: {
+        generatedAt: number;
+        format: ReportFormat;
+        config: ReportConfig;
+    };
+};

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

@@ -371,3 +371,7 @@ export type SvgSanitizationResult = {
     /** Whether any content was modified */
     wasModified: boolean;
 };
+/** Contract implemented by each file-detection strategy. */
+export type DetectionStrategy = {
+    detect(input: FileInput): Promise<FileDetectionResult>;
+};

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

@@ -245,13 +245,16 @@ export type MCPStatus = {
     [key: string]: unknown;
 };
 /**
- * Call record for circuit breaker statistics tracking
- * Extracted from mcpCircuitBreaker.ts for centralized type management
+ * Call record for circuit breaker statistics tracking.
+ * Superset shape: MCP breaker uses {timestamp, success, duration};
+ * RAG breaker also tracks `operationType` (optional, for routing and
+ * metrics). Both import from here.
  */
 export type CallRecord = {
     timestamp: number;
     success: boolean;
     duration: number;
+    operationType?: string;
 };
 /**
  * Tool execution context - Rich context passed to every tool execution
@@ -2033,3 +2036,100 @@ export type MCPTool = ToolInfo & {
     serverId?: string;
     category?: string;
 };
+/** Pending request in the batcher queue. */
+export type PendingRequest<T = unknown> = {
+    id: string;
+    tool: string;
+    args: unknown;
+    serverId?: string;
+    resolve: (value: T) => void;
+    reject: (error: Error) => void;
+    addedAt: number;
+};
+/**
+ * Cached entry held by ToolCache. Named McpCacheEntry to disambiguate from
+ * the response-caching middleware's CacheEntry in server.ts (Rule 9).
+ */
+export type McpCacheEntry<T = unknown> = {
+    value: T;
+    expires: number;
+    createdAt: number;
+    accessedAt: number;
+    accessCount: number;
+    key: string;
+};
+/** Runtime metrics tracked per MCP server by MultiServerManager. */
+export type ServerMetrics = {
+    activeRequests: number;
+    totalRequests: number;
+    completedRequests: number;
+    averageResponseTime: number;
+    errorRate: number;
+    lastHealthCheck?: Date;
+    isHealthy: boolean;
+};
+/** Synthesized test case produced by the AI workflow test-generator. */
+export type WorkflowTestCase = {
+    name: string;
+    type: string;
+    code: string;
+    description: string;
+    assertions: number;
+};
+/** Result of the code-refactoring AI workflow. */
+export type RefactoringResult = {
+    refactoredCode: string;
+    changes: string[];
+    improvements: string[];
+    metrics: {
+        linesReduced: number;
+        complexityReduction: number;
+        readabilityScore: number;
+    };
+};
+/** Result of the AI documentation-generation workflow. */
+export type DocumentationResult = {
+    documentation: string;
+    sections: string[];
+    examples: string[];
+    coverage: number;
+};
+/** Result of the AI debugging workflow. */
+export type DebugResult = {
+    issues: Array<{
+        type: string;
+        severity: "low" | "medium" | "high";
+        description: string;
+        location?: string;
+    }>;
+    suggestions: string[];
+    possibleCauses: string[];
+    fixedOutput?: string;
+};
+/** Provider name accepted by the AI analysis MCP tools. */
+export type AiAnalysisProvider = "openai" | "bedrock" | "vertex" | "anthropic" | "google-ai" | "azure" | "huggingface" | "ollama" | "mistral";
+/** Parsed input for the analyze-ai-usage MCP tool. */
+export type AnalyzeUsageParams = {
+    sessionId?: string;
+    timeRange: "1h" | "24h" | "7d" | "30d";
+    provider?: AiAnalysisProvider;
+    includeTokenBreakdown: boolean;
+    includeCostEstimation: boolean;
+};
+/** Parsed input for the benchmark-provider-performance MCP tool. */
+export type BenchmarkParams = {
+    providers?: AiAnalysisProvider[];
+    testPrompts?: string[];
+    iterations: number;
+    metrics: Array<"latency" | "quality" | "cost" | "tokens">;
+    maxTokens: number;
+};
+/** Parsed input for the optimize-prompt-parameters MCP tool. */
+export type OptimizeParametersParams = {
+    prompt: string;
+    provider?: AiAnalysisProvider;
+    targetLength?: number;
+    style: "creative" | "balanced" | "precise" | "factual";
+    optimizeFor: "speed" | "quality" | "cost" | "tokens";
+    iterations: number;
+};

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

@@ -1,6 +1,7 @@
 import type { LanguageModelMiddleware } from "ai";
 import type { JsonValue } from "../types/common.js";
 import type { EvaluationData, GetPromptFunction } from "./evaluation.js";
+import type { AuthenticatedUser, RouteDefinition, ServerContext } from "./server.js";
 /**
  * Metadata type for NeuroLink middleware
  * Provides additional information about middleware without affecting execution
@@ -285,3 +286,118 @@ export type LifecycleMiddlewareConfig = {
     onError?: OnErrorCallback;
     onChunk?: OnChunkCallback;
 };
+/** Options for the abort-signal middleware. */
+export type AbortSignalMiddlewareOptions = {
+    onAbort?: (ctx: ServerContext) => void;
+    timeout?: number;
+};
+/** Options for the bearer-token auth middleware. */
+export type BearerAuthOptions = {
+    required?: boolean;
+    headerName?: string;
+    skipPaths?: string[];
+};
+/** Token-validation function signature. */
+export type TokenValidator = (token: string) => Promise<AuthenticatedUser | null> | AuthenticatedUser | null;
+/** Options for the API-key auth middleware. */
+export type ApiKeyAuthOptions = {
+    headerName?: string;
+    skipPaths?: string[];
+};
+/** Configuration for the route-deprecation middleware. */
+export type DeprecationConfig = {
+    routes: RouteDefinition[];
+    noticeHeader?: string;
+    includeLink?: boolean;
+};
+/** Rate-limit middleware configuration. */
+export type RateLimitMiddlewareConfig = {
+    maxRequests: number;
+    windowMs: number;
+    message?: string;
+    skipPaths?: string[];
+    keyGenerator?: (ctx: ServerContext) => string;
+    onRateLimitExceeded?: (ctx: ServerContext, retryAfter: number) => unknown;
+    store?: RateLimitStore;
+};
+/** Rate-limit counter entry tracked per key. */
+export type RateLimitEntry = {
+    count: number;
+    resetAt: number;
+};
+/** Rate-limit store contract (memory or Redis). */
+export type RateLimitStore = {
+    get(key: string): Promise<RateLimitEntry | undefined>;
+    set(key: string, entry: RateLimitEntry): Promise<void>;
+    increment(key: string, windowMs: number): Promise<RateLimitEntry>;
+    reset(key: string): Promise<void>;
+};
+/** Simple fixed-window rate-limit configuration. */
+export type FixedWindowRateLimitConfig = {
+    maxRequests: number;
+    windowMs: number;
+    message?: string;
+    skipPaths?: string[];
+    keyGenerator?: (ctx: ServerContext) => string;
+    onRateLimitExceeded?: (ctx: ServerContext, retryAfter: number) => unknown;
+};
+/** Per-field entry inside a ServerValidationError's `errors` array. */
+export type ValidationErrorPayload = {
+    field: string;
+    message: string;
+    value?: unknown;
+};
+/**
+ * Minimal structural view of the server-side ValidationError class used by
+ * the request-validation middleware's errorFormatter callback.
+ */
+export type ValidationErrorInfo = {
+    errors: ValidationErrorPayload[];
+    requestId?: string;
+};
+/** Validation configuration for the request-validation middleware. */
+export type ValidationConfig = {
+    bodySchema?: MiddlewareRequestSchema;
+    querySchema?: MiddlewareRequestSchema;
+    paramsSchema?: MiddlewareRequestSchema;
+    headersSchema?: MiddlewareRequestSchema;
+    customValidator?: (ctx: ServerContext) => Promise<void>;
+    skipPaths?: string[];
+    errorFormatter?: (errors: ValidationErrorInfo[]) => unknown;
+};
+/**
+ * Simple structural validation schema used by the request-validation
+ * middleware. Named MiddlewareRequestSchema to disambiguate from the zod
+ * `ValidationSchema` exported from aliases.ts (§Rule 9 domain prefix).
+ */
+export type MiddlewareRequestSchema = {
+    required?: string[];
+    properties?: Record<string, PropertySchema>;
+    additionalProperties?: boolean;
+};
+/** Schema for an individual property in ValidationSchema. */
+export type PropertySchema = {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+    pattern?: string;
+    enum?: unknown[];
+    default?: unknown;
+    validate?: (value: unknown) => boolean | string;
+};
+/** PropertySchema with an extra `format` tag for common schemas. */
+export type ExtendedPropertySchema = PropertySchema & {
+    format?: string;
+};
+/** Extended validation schema for common schemas. */
+export type ExtendedValidationSchema = {
+    type?: string;
+    format?: string;
+    required?: string[];
+    properties?: Record<string, ExtendedPropertySchema>;
+    additionalProperties?: boolean;
+};