@juspay/neurolink 9.40.0 → 9.42.0

package/dist/lib/evaluation/pipeline/evaluationPipeline.js

@@ -91,6 +91,7 @@ export class EvaluationPipeline {
         if (!this._initialized) {
             await this.initialize();
         }
+        this._validateExecutionOptions(options);
         const startTime = Date.now();
         const correlationId = options?.correlationId ?? `pipeline-${Date.now()}`;
         logger.debug(`Executing pipeline: ${this._config.name ?? "unnamed"}`, {
@@ -173,16 +174,25 @@ export class EvaluationPipeline {
             skippedScorers,
         };
     }
+    _validateExecutionOptions(options) {
+        const hasOnlyScorers = !!options?.onlyScorers && options.onlyScorers.length > 0;
+        const hasSkipScorers = !!options?.skipScorers && options.skipScorers.length > 0;
+        if (hasOnlyScorers && hasSkipScorers) {
+            throw new Error("Cannot specify both 'onlyScorers' and 'skipScorers' options");
+        }
+    }
     /**
      * Get scorers to run based on options
      */
     _getScorersToRun(options) {
         const allScorers = Array.from(this._scorers.entries());
-        if (options?.onlyScorers && options.onlyScorers.length > 0) {
-            return allScorers.filter(([id]) => options.onlyScorers.includes(id));
+        const onlyScorers = options?.onlyScorers;
+        const skipScorers = options?.skipScorers;
+        if (onlyScorers && onlyScorers.length > 0) {
+            return allScorers.filter(([id]) => onlyScorers.includes(id));
         }
-        if (options?.skipScorers && options.skipScorers.length > 0) {
-            return allScorers.filter(([id]) => !options.skipScorers.includes(id));
+        if (skipScorers && skipScorers.length > 0) {
+            return allScorers.filter(([id]) => !skipScorers.includes(id));
         }
         return allScorers;
     }
@@ -191,11 +201,13 @@ export class EvaluationPipeline {
      */
     _getSkippedScorers(options) {
         const allIds = Array.from(this._scorers.keys());
-        if (options?.onlyScorers && options.onlyScorers.length > 0) {
-            return allIds.filter((id) => !options.onlyScorers.includes(id));
+        const onlyScorers = options?.onlyScorers;
+        const skipScorers = options?.skipScorers;
+        if (onlyScorers && onlyScorers.length > 0) {
+            return allIds.filter((id) => !onlyScorers.includes(id));
         }
-        if (options?.skipScorers && options.skipScorers.length > 0) {
-            return options.skipScorers.filter((id) => allIds.includes(id));
+        if (skipScorers && skipScorers.length > 0) {
+            return skipScorers.filter((id) => allIds.includes(id));
         }
         return [];
     }

package/dist/lib/evaluation/pipeline/strategies/batchStrategy.js

@@ -2,6 +2,9 @@
  * @file Batch Strategy
  * Batch processing for evaluation pipelines
  */
+function hasPipelineResult(result) {
+    return !result.error && result.result !== undefined;
+}
 /**
  * Default batch configuration
  */
@@ -66,7 +69,7 @@ export class BatchStrategy {
         }
         // Calculate summary
         const totalDuration = Date.now() - startTime;
-        const successfulResults = results.filter((r) => !r.error && r.result);
+        const successfulResults = results.filter(hasPipelineResult);
         const scores = successfulResults.map((r) => r.result.overallScore);
         const passed = successfulResults.filter((r) => r.result.passed);
         return {
@@ -192,7 +195,7 @@ export async function* streamBatchEvaluation(pipeline, inputs, config) {
             durations.push(result.duration);
             // If continueOnError is false and this result has an error, abort and return summary
             if (result.error && batchConfig.continueOnError === false) {
-                const successfulResults = results.filter((r) => !r.error && r.result);
+                const successfulResults = results.filter(hasPipelineResult);
                 const earlyScores = successfulResults.map((r) => r.result.overallScore);
                 const earlyPassed = successfulResults.filter((r) => r.result.passed);
                 return {
@@ -219,7 +222,7 @@ export async function* streamBatchEvaluation(pipeline, inputs, config) {
         }
     }
     // Return summary
-    const successfulResults = results.filter((r) => !r.error && r.result);
+    const successfulResults = results.filter(hasPipelineResult);
     const scores = successfulResults.map((r) => r.result.overallScore);
     const passed = successfulResults.filter((r) => r.result.passed);
     return {

package/dist/lib/evaluation/pipeline/strategies/samplingStrategy.js

@@ -17,6 +17,12 @@ export const DEFAULT_SAMPLING_CONFIG = {
         maxRate: 1.0,
     },
 };
+const DEFAULT_ADAPTIVE_CONFIG = {
+    enabled: false,
+    qualityThreshold: 0.7,
+    minRate: 0.1,
+    maxRate: 1.0,
+};
 /**
  * Sampling strategy for evaluation
  */
@@ -27,9 +33,10 @@ export class SamplingStrategy {
     _maxRecentScores = 100;
     constructor(config = {}) {
         const clamp01 = (v) => Math.max(0, Math.min(1, v));
+        const defaultAdaptive = DEFAULT_SAMPLING_CONFIG.adaptive ?? DEFAULT_ADAPTIVE_CONFIG;
         const rawRate = config.rate ?? DEFAULT_SAMPLING_CONFIG.rate;
-        const rawMinRate = config.adaptive?.minRate ?? DEFAULT_SAMPLING_CONFIG.adaptive.minRate;
-        const rawMaxRate = config.adaptive?.maxRate ?? DEFAULT_SAMPLING_CONFIG.adaptive.maxRate;
+        const rawMinRate = config.adaptive?.minRate ?? defaultAdaptive.minRate;
+        const rawMaxRate = config.adaptive?.maxRate ?? defaultAdaptive.maxRate;
         const minRate = clamp01(Math.min(rawMinRate, rawMaxRate));
         const maxRate = clamp01(Math.max(rawMinRate, rawMaxRate));
         this._config = {
@@ -41,9 +48,8 @@ export class SamplingStrategy {
                 ...(config.alwaysEvaluate ?? {}),
             },
             adaptive: {
-                enabled: config.adaptive?.enabled ?? DEFAULT_SAMPLING_CONFIG.adaptive.enabled,
-                qualityThreshold: clamp01(config.adaptive?.qualityThreshold ??
-                    DEFAULT_SAMPLING_CONFIG.adaptive.qualityThreshold),
+                enabled: config.adaptive?.enabled ?? defaultAdaptive.enabled,
+                qualityThreshold: clamp01(config.adaptive?.qualityThreshold ?? defaultAdaptive.qualityThreshold),
                 minRate,
                 maxRate,
             },
@@ -156,9 +162,12 @@ export class SamplingStrategy {
      */
     configure(config) {
         const clamp01 = (v) => Math.max(0, Math.min(1, v));
+        const currentAdaptive = this._config.adaptive ??
+            DEFAULT_SAMPLING_CONFIG.adaptive ??
+            DEFAULT_ADAPTIVE_CONFIG;
         const rawRate = config.rate ?? this._config.rate;
-        const rawMinRate = config.adaptive?.minRate ?? this._config.adaptive.minRate;
-        const rawMaxRate = config.adaptive?.maxRate ?? this._config.adaptive.maxRate;
+        const rawMinRate = config.adaptive?.minRate ?? currentAdaptive.minRate;
+        const rawMaxRate = config.adaptive?.maxRate ?? currentAdaptive.maxRate;
         const minRate = clamp01(Math.min(rawMinRate, rawMaxRate));
         const maxRate = clamp01(Math.max(rawMinRate, rawMaxRate));
         this._config = {
@@ -170,9 +179,8 @@ export class SamplingStrategy {
                 ...(config.alwaysEvaluate ?? {}),
             },
             adaptive: {
-                enabled: config.adaptive?.enabled ?? this._config.adaptive.enabled,
-                qualityThreshold: clamp01(config.adaptive?.qualityThreshold ??
-                    this._config.adaptive.qualityThreshold),
+                enabled: config.adaptive?.enabled ?? currentAdaptive.enabled,
+                qualityThreshold: clamp01(config.adaptive?.qualityThreshold ?? currentAdaptive.qualityThreshold),
                 minRate,
                 maxRate,
             },

package/dist/lib/neurolink.d.ts

@@ -13,8 +13,9 @@ import type { MCPToolAnnotations } from "./mcp/toolAnnotations.js";
 import { MCPToolRegistry } from "./mcp/toolRegistry.js";
 import type { MetricsSummary, TraceView } from "./observability/metricsAggregator.js";
 import type { SpanData } from "./observability/types/spanTypes.js";
-import type { JsonObject, NeuroLinkEvents, TypedEventEmitter } from "./types/common.js";
+import { TaskManager } from "./tasks/taskManager.js";
 import type { AuthenticatedContext, MastraAuthProvider } from "./types/authTypes.js";
+import type { JsonObject, NeuroLinkEvents, TypedEventEmitter } from "./types/common.js";
 import type { MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig } from "./types/configTypes.js";
 import type { ChatMessage } from "./types/conversation.js";
 import type { ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo } from "./types/externalMcp.js";
@@ -30,6 +31,8 @@ export declare class NeuroLink {
     private mcpSkipped;
     private mcpInitPromise;
     private emitter;
+    private _taskManager?;
+    private _taskManagerConfig?;
     private toolRegistry;
     private autoDiscoveredServerInfos;
     private externalServerManager;
@@ -148,6 +151,13 @@ export declare class NeuroLink {
      */
     private get _metricsTraceContext();
     constructor(config?: NeurolinkConstructorConfig);
+    /**
+     * TaskManager — scheduled and self-running tasks.
+     * Lazy-initialized on first access. Configurable via constructor `tasks` option.
+     * The actual async initialization (Redis connect, backend start) happens
+     * lazily inside TaskManager on first operation.
+     */
+    get tasks(): TaskManager;
     /**
      * Initialize provider registry with security settings
      */
@@ -173,6 +183,12 @@ export declare class NeuroLink {
      * and registers them as direct tools so they're available to LLMs.
      */
     private registerFileTools;
+    /**
+     * Register task management tools bound to a TaskManager instance.
+     * Follows the same factory + registry pattern as registerFileTools().
+     * Called when TaskManager is created (eagerly or lazily via the `tasks` getter).
+     */
+    private registerTaskTools;
     /**
      * Register memory retrieval tools that allow the AI to access
      * conversation history, including full tool outputs.
@@ -1893,6 +1909,7 @@ export declare class NeuroLink {
      * @param config - Auth provider or configuration to create one
      */
     setAuthProvider(config: NeuroLinkAuthConfig): Promise<void>;
+    private initializeAuthProviderFromConfig;
     /**
      * Get the currently configured authentication provider
      */