@juspay/neurolink 9.90.0 → 9.91.1

package/dist/types/config.d.ts

@@ -42,6 +42,12 @@ export type NeurolinkConstructorConfig = {
     conversationMemory?: Partial<ConversationMemoryConfig>;
     enableOrchestration?: boolean;
     hitl?: HITLConfig;
+    /**
+     * Instance-level tool policy: master switch, include/exclude lists
+     * (with `*` glob support), and on-demand MCP tool discovery.
+     * See {@link ToolConfig}.
+     */
+    tools?: ToolConfig;
     toolRegistry?: MCPToolRegistry;
     observability?: ObservabilityConfig;
     modelAliasConfig?: ModelAliasConfig;
@@ -329,14 +335,48 @@ export type AnalyticsConfig = {
     };
 };
 /**
- * Tool configuration
+ * Instance-level tool configuration (`new NeuroLink({ tools: {...} })`).
+ *
+ * The four primary keys (`enabled`, `include`, `exclude`, `discovery`) form
+ * the complete modern surface; per-call options (`toolFilter`,
+ * `excludeTools`, `enabledToolNames`, `disableTools`) keep working and are
+ * merged with this config by `resolveToolPolicy()`.
  */
 export type ToolConfig = {
-    /** Whether built-in tools should be disabled */
+    /**
+     * Master switch. `false` disables all tools for every call from this
+     * instance (equivalent to passing `disableTools: true` on each call).
+     * Default: true.
+     */
+    enabled?: boolean;
+    /**
+     * Allowlist of tool names. Supports `*` globs (e.g. `"github*"`).
+     * Undefined = all tools; an EMPTY array means no tools (fail-closed).
+     * Per-call `toolFilter` is bounded by this list (a per-call filter can
+     * narrow it further but never widen past it).
+     */
+    include?: string[];
+    /** Denylist of tool names (supports `*` globs). Applied after `include`. */
+    exclude?: string[];
+    /**
+     * Defer external MCP tool schemas behind a `search_tools` meta-tool: the
+     * model sees a compact name+summary catalog instead of full schemas and
+     * loads a tool on demand by searching for it. Built-in tools, per-call
+     * tools, per-call whitelists (`toolFilter`/`enabledToolNames`), forced
+     * `toolChoice` tools, and already-discovered tools are always sent in
+     * full. Note: the instance-level `include` list deliberately does NOT
+     * force tools hot — it scopes the catalog, and discovery defers within
+     * that scope (a scoped-but-large catalog is exactly where deferral pays).
+     * Default: false.
+     */
+    discovery?: boolean;
+    /** Whether built-in tools should be disabled (equivalent to excluding all direct tools) */
     disableBuiltinTools?: boolean;
     /** Whether custom tools are allowed */
     allowCustomTools?: boolean;
-    /** Maximum number of tools per provider */
+    /**
+     * @deprecated Never enforced; retained for compile compatibility only.
+     */
     maxToolsPerProvider?: number;
     /** Whether MCP tools should be enabled */
     enableMCPTools?: boolean;

package/dist/types/index.d.ts

@@ -52,6 +52,7 @@ export * from "./subscription.js";
 export * from "./task.js";
 export * from "./taskClassification.js";
 export * from "./toolDedup.js";
+export * from "./toolResolution.js";
 export * from "./toolRouting.js";
 export * from "./tools.js";
 export * from "./vectorStoreChroma.js";

package/dist/types/index.js

@@ -53,6 +53,7 @@ export * from "./subscription.js";
 export * from "./task.js";
 export * from "./taskClassification.js";
 export * from "./toolDedup.js";
+export * from "./toolResolution.js";
 export * from "./toolRouting.js";
 export * from "./tools.js";
 export * from "./vectorStoreChroma.js";

package/dist/types/providers.d.ts

@@ -593,6 +593,14 @@ export type AIProvider = {
         traceId: string;
         parentSpanId: string;
     } | null): void;
+    /**
+     * Whether this provider supports native tool/function calling for the
+     * current model. Implemented by BaseProvider (default true); overridden by
+     * providers with model-dependent or absent tool support (ollama,
+     * huggingface, image providers). Optional for compile compatibility with
+     * external AIProvider implementations — callers treat absence as `true`.
+     */
+    supportsTools?(): boolean;
 };
 /**
  * Provider attempt result for iteration tracking (converted from interface)

package/dist/types/toolResolution.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Tool resolution types — the single tool-policy pipeline that decides which
+ * tools are sent to a provider for a given request.
+ *
+ * One policy object is resolved per request from (a) per-call legacy options
+ * (`toolFilter`, `excludeTools`, `enabledToolNames`, `disableTools`) and
+ * (b) the instance-level `tools` config, then applied at the single gate in
+ * `BaseProvider` that every generate/stream path passes through.
+ */
+import type { ToolConfig } from "./config.js";
+/**
+ * The resolved, merged tool policy for one request. Produced by
+ * `resolveToolPolicy()` (src/lib/tools/toolPolicy.ts) and consumed by
+ * `applyToolGate()` (src/lib/tools/toolGate.ts).
+ */
+export type ResolvedToolPolicy = {
+    /** false = no tools at all for this request (drops caller-supplied tools too). */
+    enabled: boolean;
+    /**
+     * Allowlist of tool-name patterns (exact names or `*` globs).
+     * `undefined` = all tools pass. An empty array means "no tools" — it can
+     * only come from the new `tools.include` config surface; legacy
+     * `toolFilter: []` is normalized to `undefined` (fail-open, preserving
+     * historical behavior) before it reaches here.
+     */
+    include?: string[];
+    /**
+     * Secondary allowlist clause ANDed with `include` — set when both a
+     * legacy per-call allowlist and the instance `tools.include` are present.
+     * Kept as a separate clause because two glob pattern lists cannot be
+     * losslessly pre-intersected into a single pattern array (a name must
+     * match BOTH lists to pass).
+     */
+    includeBound?: string[];
+    /** Denylist of tool-name patterns (exact names or `*` globs), applied after include. */
+    exclude: string[];
+    /** Defer external MCP tool schemas behind the search_tools meta-tool. */
+    discovery: boolean;
+    /** Which option/config sources contributed to this policy (telemetry/debugging). */
+    sources: string[];
+};
+/**
+ * Inputs to `resolveToolPolicy()`. Kept as a named type so the mapping is
+ * unit-testable as a pure function.
+ */
+export type ToolPolicyResolutionInput = {
+    /** Per-call options (the legacy per-call filtering surface). */
+    options: {
+        disableTools?: boolean;
+        toolFilter?: string[];
+        enabledToolNames?: string[];
+        excludeTools?: string[];
+    };
+    /** Instance-level `tools` config passed to the NeuroLink constructor. */
+    instanceConfig?: ToolConfig;
+    /**
+     * Names of the built-in (direct) tools of the calling provider — used to
+     * honor `tools.disableBuiltinTools` without this module importing the
+     * direct-tools registry.
+     */
+    builtinToolNames?: string[];
+};
+/**
+ * One entry in the deferred-tool catalog embedded in the `search_tools`
+ * meta-tool description when `tools.discovery` is enabled.
+ */
+export type DeferredToolIndexEntry = {
+    name: string;
+    /** One-line description (truncated) shown in the search_tools catalog. */
+    summary: string;
+    /** Originating MCP server id, when known. */
+    serverId?: string;
+};

package/dist/types/toolResolution.js

@@ -0,0 +1,10 @@
+/**
+ * Tool resolution types — the single tool-policy pipeline that decides which
+ * tools are sent to a provider for a given request.
+ *
+ * One policy object is resolved per request from (a) per-call legacy options
+ * (`toolFilter`, `excludeTools`, `enabledToolNames`, `disableTools`) and
+ * (b) the instance-level `tools` config, then applied at the single gate in
+ * `BaseProvider` that every generate/stream path passes through.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.90.0",
+  "version": "9.91.1",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {
@@ -74,6 +74,7 @@
     "test:cache": "npx tsx test/continuous-test-suite-cache-breakpoints.ts",
     "test:evaluation": "npx tsx test/continuous-test-suite-evaluation.ts",
     "test:mcp": "npx tsx test/continuous-test-suite-mcp-infra.ts",
+    "test:tool-resolution": "npx tsx test/continuous-test-suite-tool-resolution.ts",
     "test:mcp:http": "npx tsx test/continuous-test-suite-mcp-http.ts",
     "test:mcp:sdk": "npx tsx test/continuous-test-suite-mcp-sdk.ts",
     "test:mcp:cli": "npx tsx test/continuous-test-suite-mcp-cli.ts",
@@ -335,7 +336,6 @@
     "@ai-sdk/provider": "^3.0.8",
     "@anthropic-ai/sdk": "^0.102.0",
     "@anthropic-ai/vertex-sdk": "^0.16.0",
-    "@aws-sdk/client-sagemaker-runtime": "^3.1000.0",
     "@aws-sdk/types": "^3.862.0",
     "@google/genai": "^1.43.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
@@ -399,6 +399,7 @@
     "@aws-sdk/client-bedrock": "^3.1000.0",
     "@aws-sdk/client-bedrock-runtime": "^3.1000.0",
     "@aws-sdk/client-sagemaker": "^3.1000.0",
+    "@aws-sdk/client-sagemaker-runtime": "^3.1000.0",
     "@aws-sdk/credential-provider-node": "^3.886.0",
     "@fastify/cors": "^11.2.0",
     "@fastify/rate-limit": "^10.3.0",