@juspay/neurolink 9.75.0 → 9.76.0

package/dist/lib/neurolink.d.ts

@@ -5,7 +5,7 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor } from "./types/index.js";
+import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor, ToolDedupConfig } from "./types/index.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
 import { ExternalServerManager } from "./mcp/externalServerManager.js";
@@ -102,6 +102,7 @@ export declare class NeuroLink {
     private conversationMemoryConfig?;
     private toolRoutingConfig?;
     private toolRoutingCacheInstance?;
+    private toolDedupConfig?;
     private enableOrchestration;
     private authProvider?;
     private pendingAuthConfig?;
@@ -1089,6 +1090,19 @@ export declare class NeuroLink {
      * @see {@link NeuroLink.executeTool} for events related to tool execution
      */
     getEventEmitter(): TypedEventEmitter<NeuroLinkEvents>;
+    /**
+     * Returns the instance-level tool-dedup configuration, or `undefined` when
+     * toolDedup was not provided at construction time.
+     *
+     * The stored object is returned as-is whenever `toolDedup` was supplied,
+     * including when `enabled: false` — only the complete absence of a `toolDedup`
+     * option results in `undefined`.
+     *
+     * Called by `BaseProvider.applyToolFiltering` so the dedup pass uses the
+     * same config for every generate/stream call without threading an extra
+     * parameter through the full call stack.
+     */
+    getToolDedupConfig(): ToolDedupConfig | undefined;
     /**
      * Curator P1-1: synchronous credential health check for a single provider.
      *

package/dist/lib/neurolink.js

@@ -445,6 +445,8 @@ export class NeuroLink {
     // Lazy-initialized routing decision cache (ITEM C). Created on first use so
     // instances that don't use routing pay no overhead.
     toolRoutingCacheInstance;
+    // Opt-in tool-signature deduplication config.
+    toolDedupConfig;
     // Add orchestration property
     enableOrchestration;
     // Authentication provider for secure access control
@@ -857,6 +859,9 @@ export class NeuroLink {
             // multiple NeuroLink instances.
             this.toolRoutingConfig = { ...config.toolRouting };
         }
+        if (config?.toolDedup) {
+            this.toolDedupConfig = { ...config.toolDedup };
+        }
         logger.setEventEmitter(this.emitter);
         // Read tool cache duration from environment variables, with a default
         const cacheDurationEnv = process.env.NEUROLINK_TOOL_CACHE_DURATION;
@@ -7513,6 +7518,21 @@ Current user's request: ${currentInput}`;
     getEventEmitter() {
         return this.emitter;
     }
+    /**
+     * Returns the instance-level tool-dedup configuration, or `undefined` when
+     * toolDedup was not provided at construction time.
+     *
+     * The stored object is returned as-is whenever `toolDedup` was supplied,
+     * including when `enabled: false` — only the complete absence of a `toolDedup`
+     * option results in `undefined`.
+     *
+     * Called by `BaseProvider.applyToolFiltering` so the dedup pass uses the
+     * same config for every generate/stream call without threading an extra
+     * parameter through the full call stack.
+     */
+    getToolDedupConfig() {
+        return this.toolDedupConfig;
+    }
     /**
      * Curator P1-1: synchronous credential health check for a single provider.
      *

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

@@ -9,7 +9,6 @@ import type { ConversationMemoryConfig } from "./conversation.js";
 import type { ObservabilityConfig } from "./observability.js";
 import type { AuthProvider, AuthProviderType, AuthProviderConfig, Auth0Config, ClerkConfig, FirebaseConfig, SupabaseConfig, WorkOSConfig, BetterAuthConfig, JWTConfig, OAuth2Config, CognitoConfig, KeycloakConfig, AuthenticatedContext } from "./auth.js";
 import type { NeurolinkCredentials } from "./providers.js";
-import type { ToolRoutingConfig } from "./toolRouting.js";
 /**
  * Main NeuroLink configuration type
  */
@@ -74,6 +73,19 @@ export type NeurolinkConstructorConfig = {
      * any router failure. See {@link ToolRoutingConfig}.
      */
     toolRouting?: ToolRoutingConfig;
+    /**
+     * Opt-in tool-signature deduplication.  When enabled, tools whose
+     * canonical signatures are sufficiently similar (Jaccard ≥ threshold) are
+     * collapsed to a single representative before being sent to the model,
+     * reducing token cost and model confusion caused by near-identical tools.
+     *
+     * Disabled by default — enabling this changes nothing unless you
+     * explicitly set `enabled: true`.  Always fails open: any error in the
+     * dedup pass returns the original tool set unchanged.
+     *
+     * See {@link ToolDedupConfig}.
+     */
+    toolDedup?: ToolDedupConfig;
 };
 /**
  * Configuration for MCP enhancement modules wired into generate()/stream() paths.
@@ -338,7 +350,7 @@ export type ConfigUpdateOptions = {
  */
 export declare const DEFAULT_CONFIG: NeuroLinkConfig;
 import { TOOL_TIMEOUTS, BACKOFF_CONFIG, PERFORMANCE_PROFILES, PROVIDER_OPERATION_CONFIGS, MCP_OPERATION_CONFIGS } from "../constants/index.js";
-import type { ToolMiddleware, CacheStrategy, RoutingStrategy } from "./index.js";
+import type { ToolMiddleware, CacheStrategy, RoutingStrategy, ToolDedupConfig, ToolRoutingConfig } from "./index.js";
 import type { ModelAliasConfig } from "./generate.js";
 /** Timeout category keys from TOOL_TIMEOUTS. */
 export type TimeoutCategory = keyof typeof TOOL_TIMEOUTS;

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

@@ -50,6 +50,7 @@ export * from "./stream.js";
 export * from "./subscription.js";
 export * from "./task.js";
 export * from "./taskClassification.js";
+export * from "./toolDedup.js";
 export * from "./toolRouting.js";
 export * from "./tools.js";
 export * from "./voice.js";

package/dist/lib/types/index.js

@@ -51,6 +51,7 @@ export * from "./stream.js";
 export * from "./subscription.js";
 export * from "./task.js";
 export * from "./taskClassification.js";
+export * from "./toolDedup.js";
 export * from "./toolRouting.js";
 export * from "./tools.js";
 export * from "./voice.js";

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

@@ -0,0 +1,45 @@
+/**
+ * Tool signature deduplication types.
+ *
+ * When many MCP servers are registered, it is common for tools from different
+ * servers to be functionally identical — same purpose, same parameters, only a
+ * slightly different name or description phrasing.  Sending all of them to the
+ * model wastes tokens and can confuse the model into picking the wrong variant.
+ *
+ * The dedup pass is OPT-IN and FAIL-OPEN.  When disabled (the default) the
+ * tool set is returned byte-for-byte unchanged.  Any error in the dedup logic
+ * also returns the original tool set.
+ */
+/** Configuration for the opt-in tool-signature deduplication pass. */
+export type ToolDedupConfig = {
+    /**
+     * Master switch.  Dedup runs only when `true`.
+     * Default: `false` (disabled — no change in behaviour).
+     */
+    enabled?: boolean;
+    /**
+     * Jaccard similarity threshold in [0, 1].  Pairs of tools whose token-set
+     * Jaccard similarity over their canonical signatures meets or exceeds this
+     * value are treated as near-duplicates; only one representative per cluster
+     * (the first in stable input order) is forwarded to the model.
+     *
+     * Default: `0.9`
+     */
+    threshold?: number;
+};
+/** Record produced for each tool collapsed by the dedup pass. */
+export type ToolDedupRemoved = {
+    /** Name of the tool that was collapsed. */
+    name: string;
+    /** Name of the representative tool that this one was collapsed into. */
+    duplicateOf: string;
+    /** Similarity score that triggered the collapse (in [0, 1]). */
+    similarity: number;
+};
+/** Return type of `dedupeTools()`. */
+export type ToolDedupResult<T extends Record<string, unknown>> = {
+    /** Deduplicated tool set (or original set when dedup is disabled/errored). */
+    tools: T;
+    /** Tools that were removed along with the reason. Empty when dedup is off. */
+    removed: ToolDedupRemoved[];
+};

package/dist/lib/types/toolDedup.js

@@ -0,0 +1,14 @@
+/**
+ * Tool signature deduplication types.
+ *
+ * When many MCP servers are registered, it is common for tools from different
+ * servers to be functionally identical — same purpose, same parameters, only a
+ * slightly different name or description phrasing.  Sending all of them to the
+ * model wastes tokens and can confuse the model into picking the wrong variant.
+ *
+ * The dedup pass is OPT-IN and FAIL-OPEN.  When disabled (the default) the
+ * tool set is returned byte-for-byte unchanged.  Any error in the dedup logic
+ * also returns the original tool set.
+ */
+export {};
+//# sourceMappingURL=toolDedup.js.map

package/dist/neurolink.d.ts

@@ -5,7 +5,7 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor } from "./types/index.js";
+import type { CompactionConfig, CompactionResult, SpanData, ObservabilityConfig, MetricsSummary, MCPToolAnnotations, TraceView, AuthenticatedContext, AuthProvider, JsonObject, NeuroLinkEvents, TypedEventEmitter, MCPEnhancementsConfig, NeuroLinkAuthConfig, NeurolinkConstructorConfig, ChatMessage, ExternalMCPOperationResult, ExternalMCPServerInstance, ExternalMCPToolInfo, GenerateOptions, GenerateResult, ProviderStatus, TextGenerationOptions, TextGenerationResult, MCPExecutableTool, MCPServerInfo, MCPStatus, StreamOptions, StreamResult, ToolExecutionContext, ToolExecutionSummary, ToolInfo, ToolRegistrationOptions, BatchOperationResult, StreamGenerationEndContext, ToolRoutingServerDescriptor, ToolDedupConfig } from "./types/index.js";
 import { ConversationMemoryManager } from "./core/conversationMemoryManager.js";
 import type { RedisConversationMemoryManager } from "./core/redisConversationMemoryManager.js";
 import { ExternalServerManager } from "./mcp/externalServerManager.js";
@@ -102,6 +102,7 @@ export declare class NeuroLink {
     private conversationMemoryConfig?;
     private toolRoutingConfig?;
     private toolRoutingCacheInstance?;
+    private toolDedupConfig?;
     private enableOrchestration;
     private authProvider?;
     private pendingAuthConfig?;
@@ -1089,6 +1090,19 @@ export declare class NeuroLink {
      * @see {@link NeuroLink.executeTool} for events related to tool execution
      */
     getEventEmitter(): TypedEventEmitter<NeuroLinkEvents>;
+    /**
+     * Returns the instance-level tool-dedup configuration, or `undefined` when
+     * toolDedup was not provided at construction time.
+     *
+     * The stored object is returned as-is whenever `toolDedup` was supplied,
+     * including when `enabled: false` — only the complete absence of a `toolDedup`
+     * option results in `undefined`.
+     *
+     * Called by `BaseProvider.applyToolFiltering` so the dedup pass uses the
+     * same config for every generate/stream call without threading an extra
+     * parameter through the full call stack.
+     */
+    getToolDedupConfig(): ToolDedupConfig | undefined;
     /**
      * Curator P1-1: synchronous credential health check for a single provider.
      *

package/dist/neurolink.js

@@ -445,6 +445,8 @@ export class NeuroLink {
     // Lazy-initialized routing decision cache (ITEM C). Created on first use so
     // instances that don't use routing pay no overhead.
     toolRoutingCacheInstance;
+    // Opt-in tool-signature deduplication config.
+    toolDedupConfig;
     // Add orchestration property
     enableOrchestration;
     // Authentication provider for secure access control
@@ -857,6 +859,9 @@ export class NeuroLink {
             // multiple NeuroLink instances.
             this.toolRoutingConfig = { ...config.toolRouting };
         }
+        if (config?.toolDedup) {
+            this.toolDedupConfig = { ...config.toolDedup };
+        }
         logger.setEventEmitter(this.emitter);
         // Read tool cache duration from environment variables, with a default
         const cacheDurationEnv = process.env.NEUROLINK_TOOL_CACHE_DURATION;
@@ -7513,6 +7518,21 @@ Current user's request: ${currentInput}`;
     getEventEmitter() {
         return this.emitter;
     }
+    /**
+     * Returns the instance-level tool-dedup configuration, or `undefined` when
+     * toolDedup was not provided at construction time.
+     *
+     * The stored object is returned as-is whenever `toolDedup` was supplied,
+     * including when `enabled: false` — only the complete absence of a `toolDedup`
+     * option results in `undefined`.
+     *
+     * Called by `BaseProvider.applyToolFiltering` so the dedup pass uses the
+     * same config for every generate/stream call without threading an extra
+     * parameter through the full call stack.
+     */
+    getToolDedupConfig() {
+        return this.toolDedupConfig;
+    }
     /**
      * Curator P1-1: synchronous credential health check for a single provider.
      *

package/dist/types/config.d.ts

@@ -9,7 +9,6 @@ import type { ConversationMemoryConfig } from "./conversation.js";
 import type { ObservabilityConfig } from "./observability.js";
 import type { AuthProvider, AuthProviderType, AuthProviderConfig, Auth0Config, ClerkConfig, FirebaseConfig, SupabaseConfig, WorkOSConfig, BetterAuthConfig, JWTConfig, OAuth2Config, CognitoConfig, KeycloakConfig, AuthenticatedContext } from "./auth.js";
 import type { NeurolinkCredentials } from "./providers.js";
-import type { ToolRoutingConfig } from "./toolRouting.js";
 /**
  * Main NeuroLink configuration type
  */
@@ -74,6 +73,19 @@ export type NeurolinkConstructorConfig = {
      * any router failure. See {@link ToolRoutingConfig}.
      */
     toolRouting?: ToolRoutingConfig;
+    /**
+     * Opt-in tool-signature deduplication.  When enabled, tools whose
+     * canonical signatures are sufficiently similar (Jaccard ≥ threshold) are
+     * collapsed to a single representative before being sent to the model,
+     * reducing token cost and model confusion caused by near-identical tools.
+     *
+     * Disabled by default — enabling this changes nothing unless you
+     * explicitly set `enabled: true`.  Always fails open: any error in the
+     * dedup pass returns the original tool set unchanged.
+     *
+     * See {@link ToolDedupConfig}.
+     */
+    toolDedup?: ToolDedupConfig;
 };
 /**
  * Configuration for MCP enhancement modules wired into generate()/stream() paths.
@@ -338,7 +350,7 @@ export type ConfigUpdateOptions = {
  */
 export declare const DEFAULT_CONFIG: NeuroLinkConfig;
 import { TOOL_TIMEOUTS, BACKOFF_CONFIG, PERFORMANCE_PROFILES, PROVIDER_OPERATION_CONFIGS, MCP_OPERATION_CONFIGS } from "../constants/index.js";
-import type { ToolMiddleware, CacheStrategy, RoutingStrategy } from "./index.js";
+import type { ToolMiddleware, CacheStrategy, RoutingStrategy, ToolDedupConfig, ToolRoutingConfig } from "./index.js";
 import type { ModelAliasConfig } from "./generate.js";
 /** Timeout category keys from TOOL_TIMEOUTS. */
 export type TimeoutCategory = keyof typeof TOOL_TIMEOUTS;

package/dist/types/index.d.ts

@@ -50,6 +50,7 @@ export * from "./stream.js";
 export * from "./subscription.js";
 export * from "./task.js";
 export * from "./taskClassification.js";
+export * from "./toolDedup.js";
 export * from "./toolRouting.js";
 export * from "./tools.js";
 export * from "./voice.js";

package/dist/types/index.js

@@ -51,6 +51,7 @@ export * from "./stream.js";
 export * from "./subscription.js";
 export * from "./task.js";
 export * from "./taskClassification.js";
+export * from "./toolDedup.js";
 export * from "./toolRouting.js";
 export * from "./tools.js";
 export * from "./voice.js";

package/dist/types/toolDedup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Tool signature deduplication types.
+ *
+ * When many MCP servers are registered, it is common for tools from different
+ * servers to be functionally identical — same purpose, same parameters, only a
+ * slightly different name or description phrasing.  Sending all of them to the
+ * model wastes tokens and can confuse the model into picking the wrong variant.
+ *
+ * The dedup pass is OPT-IN and FAIL-OPEN.  When disabled (the default) the
+ * tool set is returned byte-for-byte unchanged.  Any error in the dedup logic
+ * also returns the original tool set.
+ */
+/** Configuration for the opt-in tool-signature deduplication pass. */
+export type ToolDedupConfig = {
+    /**
+     * Master switch.  Dedup runs only when `true`.
+     * Default: `false` (disabled — no change in behaviour).
+     */
+    enabled?: boolean;
+    /**
+     * Jaccard similarity threshold in [0, 1].  Pairs of tools whose token-set
+     * Jaccard similarity over their canonical signatures meets or exceeds this
+     * value are treated as near-duplicates; only one representative per cluster
+     * (the first in stable input order) is forwarded to the model.
+     *
+     * Default: `0.9`
+     */
+    threshold?: number;
+};
+/** Record produced for each tool collapsed by the dedup pass. */
+export type ToolDedupRemoved = {
+    /** Name of the tool that was collapsed. */
+    name: string;
+    /** Name of the representative tool that this one was collapsed into. */
+    duplicateOf: string;
+    /** Similarity score that triggered the collapse (in [0, 1]). */
+    similarity: number;
+};
+/** Return type of `dedupeTools()`. */
+export type ToolDedupResult<T extends Record<string, unknown>> = {
+    /** Deduplicated tool set (or original set when dedup is disabled/errored). */
+    tools: T;
+    /** Tools that were removed along with the reason. Empty when dedup is off. */
+    removed: ToolDedupRemoved[];
+};

package/dist/types/toolDedup.js

@@ -0,0 +1,13 @@
+/**
+ * Tool signature deduplication types.
+ *
+ * When many MCP servers are registered, it is common for tools from different
+ * servers to be functionally identical — same purpose, same parameters, only a
+ * slightly different name or description phrasing.  Sending all of them to the
+ * model wastes tokens and can confuse the model into picking the wrong variant.
+ *
+ * The dedup pass is OPT-IN and FAIL-OPEN.  When disabled (the default) the
+ * tool set is returned byte-for-byte unchanged.  Any error in the dedup logic
+ * also returns the original tool set.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.75.0",
+  "version": "9.76.0",
   "packageManager": "pnpm@10.15.1",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, voice (TTS/STT/realtime), and professional CLI. 58+ external MCP servers discoverable, multimodal file processing, RAG pipelines. Build, test, and deploy AI applications with 21+ providers: OpenAI, Anthropic, Google AI Studio, Google Vertex, AWS Bedrock, Azure OpenAI, Mistral, LiteLLM, SageMaker, Hugging Face, Ollama, OpenAI-compatible, OpenRouter, DeepSeek, NVIDIA NIM, LM Studio, llama.cpp, plus voice (OpenAI TTS, ElevenLabs, Deepgram, Azure Speech).",
   "author": {
@@ -120,11 +120,13 @@
     "test:envguard": "npx tsx test/helpers/envGuard.test.ts",
     "test:tool-routing-cli:vitest": "pnpm exec vitest run test/toolRoutingCli.test.ts",
     "test:tool-routing-cli": "pnpm run test:tool-routing-cli:vitest && npx tsx test/continuous-test-suite-tool-routing-cli.ts",
+    "test:tool-dedup:vitest": "pnpm exec vitest run test/toolDedup.test.ts",
+    "test:tool-dedup": "pnpm run test:tool-dedup:vitest && npx tsx test/continuous-test-suite-tool-dedup.ts",
     "test:ci": "pnpm run test && pnpm run test:client && pnpm run test:hitl",
     "// CI tier — fast, no live AI calls, safe for every commit": "",
     "test:unit:vitest": "pnpm exec vitest run test/toolRouting.test.ts",
     "test:tool-routing": "pnpm run test:unit:vitest && npx tsx test/continuous-test-suite-tool-routing.ts",
-    "test:unit": "pnpm run test:envguard && pnpm run test:bugfixes && pnpm run test:mcp:infra && pnpm run test:mcp:bash && pnpm run test:mcp:limits && pnpm run test:mcp:spans && pnpm run test:autoresearch:redis && pnpm run test:unit:vitest && pnpm run test:tool-routing-cli:vitest",
+    "test:unit": "pnpm run test:envguard && pnpm run test:bugfixes && pnpm run test:mcp:infra && pnpm run test:mcp:bash && pnpm run test:mcp:limits && pnpm run test:mcp:spans && pnpm run test:autoresearch:redis && pnpm run test:unit:vitest && pnpm run test:tool-routing-cli:vitest && pnpm run test:tool-dedup:vitest",
     "// CI tier — live providers, runs only when API keys are present (test:credentials and test:dynamic make real provider calls when keys are set, so they live here, not in test:unit)": "",
     "test:live": "pnpm run test:providers && pnpm run test:mcp:http && pnpm run test:mcp:sdk && pnpm run test:mcp:cli && pnpm run test:observability && pnpm run test:context && pnpm run test:memory && pnpm run test:tool-reliability && pnpm run test:evaluation && pnpm run test:autoresearch && pnpm run test:credentials && pnpm run test:dynamic",
     "// CI tier — product output (image/video/TTS/PPT) — costs $$ per run": "",