@juspay/neurolink 10.5.1 → 10.5.3

package/dist/core/baseProvider.d.ts

@@ -43,9 +43,14 @@ export declare abstract class BaseProvider implements AIProvider {
     /**
      * Check if this provider supports tool/function calling
      * Override in subclasses to disable tools for specific providers or models
-     * @returns true by default, providers can override to return false
+     * @returns the current model's registered capability, or true when unknown
      */
     supportsTools(): boolean;
+    /**
+     * Apply the shared tool gate and optionally report registry-backed
+     * suppression at the request entry point.
+     */
+    private shouldUseTools;
     /**
      * Primary streaming method - implements AIProvider interface
      * When tools are involved, falls back to generate() with synthetic streaming

package/dist/core/baseProvider.js

@@ -2,6 +2,7 @@ import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import { directAgentTools } from "../agent/directTools.js";
 import { IMAGE_GENERATION_MODELS } from "../core/constants.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
+import { modelSupports } from "../models/modelRegistry.js";
 import { ATTR, tracers } from "../telemetry/index.js";
 import { isAbortError } from "../utils/errorHandling.js";
 import { hasLifecycleErrorFired, markLifecycleErrorFired, } from "../utils/lifecycleCallbacks.js";
@@ -105,10 +106,27 @@ export class BaseProvider {
     /**
      * Check if this provider supports tool/function calling
      * Override in subclasses to disable tools for specific providers or models
-     * @returns true by default, providers can override to return false
+     * @returns the current model's registered capability, or true when unknown
      */
     supportsTools() {
-        return true;
+        return modelSupports("functionCalling", this.providerName, this.modelName);
+    }
+    /**
+     * Apply the shared tool gate and optionally report registry-backed
+     * suppression at the request entry point.
+     */
+    shouldUseTools(options, warnWhenUnsupported = false) {
+        if (options.disableTools) {
+            return false;
+        }
+        const supportsTools = this.supportsTools();
+        if (!supportsTools && warnWhenUnsupported) {
+            logger.warn(`Tools disabled for ${this.providerName}/${this.modelName} because the model does not support function calling`, {
+                provider: this.providerName,
+                model: this.modelName,
+            });
+        }
+        return supportsTools;
     }
     // ===================
     // PUBLIC API METHODS
@@ -178,7 +196,7 @@ export class BaseProvider {
         // tools (e.g. RAG tools) into options.tools. This way, every provider's
         // executeStream() can simply use options.tools (or getAllTools() + options.tools)
         // and get the complete tool set without needing per-provider merge logic.
-        if (!options.disableTools && this.supportsTools()) {
+        if (this.shouldUseTools(options, true)) {
             const mergedTools = await this.getToolsForStream(options);
             options = { ...options, tools: mergedTools };
         }
@@ -731,7 +749,7 @@ export class BaseProvider {
      * Prepare generation context including tools and model
      */
     async prepareGenerationContext(options) {
-        const shouldUseTools = !options.disableTools && this.supportsTools();
+        const shouldUseTools = this.shouldUseTools(options, true);
         const baseTools = shouldUseTools ? await this.getAllTools() : {};
         let tools = shouldUseTools
             ? {
@@ -765,7 +783,7 @@ export class BaseProvider {
      * All providers should call this instead of getAllTools() directly.
      */
     async getToolsForStream(options) {
-        const shouldUseTools = !options.disableTools && this.supportsTools();
+        const shouldUseTools = this.shouldUseTools(options);
         if (!shouldUseTools) {
             return {};
         }

package/dist/lib/core/baseProvider.d.ts

@@ -43,9 +43,14 @@ export declare abstract class BaseProvider implements AIProvider {
     /**
      * Check if this provider supports tool/function calling
      * Override in subclasses to disable tools for specific providers or models
-     * @returns true by default, providers can override to return false
+     * @returns the current model's registered capability, or true when unknown
      */
     supportsTools(): boolean;
+    /**
+     * Apply the shared tool gate and optionally report registry-backed
+     * suppression at the request entry point.
+     */
+    private shouldUseTools;
     /**
      * Primary streaming method - implements AIProvider interface
      * When tools are involved, falls back to generate() with synthetic streaming

package/dist/lib/core/baseProvider.js

@@ -2,6 +2,7 @@ import { context, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import { directAgentTools } from "../agent/directTools.js";
 import { IMAGE_GENERATION_MODELS } from "../core/constants.js";
 import { MiddlewareFactory } from "../middleware/factory.js";
+import { modelSupports } from "../models/modelRegistry.js";
 import { ATTR, tracers } from "../telemetry/index.js";
 import { isAbortError } from "../utils/errorHandling.js";
 import { hasLifecycleErrorFired, markLifecycleErrorFired, } from "../utils/lifecycleCallbacks.js";
@@ -105,10 +106,27 @@ export class BaseProvider {
     /**
      * Check if this provider supports tool/function calling
      * Override in subclasses to disable tools for specific providers or models
-     * @returns true by default, providers can override to return false
+     * @returns the current model's registered capability, or true when unknown
      */
     supportsTools() {
-        return true;
+        return modelSupports("functionCalling", this.providerName, this.modelName);
+    }
+    /**
+     * Apply the shared tool gate and optionally report registry-backed
+     * suppression at the request entry point.
+     */
+    shouldUseTools(options, warnWhenUnsupported = false) {
+        if (options.disableTools) {
+            return false;
+        }
+        const supportsTools = this.supportsTools();
+        if (!supportsTools && warnWhenUnsupported) {
+            logger.warn(`Tools disabled for ${this.providerName}/${this.modelName} because the model does not support function calling`, {
+                provider: this.providerName,
+                model: this.modelName,
+            });
+        }
+        return supportsTools;
     }
     // ===================
     // PUBLIC API METHODS
@@ -178,7 +196,7 @@ export class BaseProvider {
         // tools (e.g. RAG tools) into options.tools. This way, every provider's
         // executeStream() can simply use options.tools (or getAllTools() + options.tools)
         // and get the complete tool set without needing per-provider merge logic.
-        if (!options.disableTools && this.supportsTools()) {
+        if (this.shouldUseTools(options, true)) {
             const mergedTools = await this.getToolsForStream(options);
             options = { ...options, tools: mergedTools };
         }
@@ -731,7 +749,7 @@ export class BaseProvider {
      * Prepare generation context including tools and model
      */
     async prepareGenerationContext(options) {
-        const shouldUseTools = !options.disableTools && this.supportsTools();
+        const shouldUseTools = this.shouldUseTools(options, true);
         const baseTools = shouldUseTools ? await this.getAllTools() : {};
         let tools = shouldUseTools
             ? {
@@ -765,7 +783,7 @@ export class BaseProvider {
      * All providers should call this instead of getAllTools() directly.
      */
     async getToolsForStream(options) {
-        const shouldUseTools = !options.disableTools && this.supportsTools();
+        const shouldUseTools = this.shouldUseTools(options);
         if (!shouldUseTools) {
             return {};
         }

package/dist/lib/models/modelRegistry.d.ts

@@ -4,7 +4,7 @@
  * Part of Phase 4.1 - Models Command System
  */
 import { AIProviderName } from "../constants/enums.js";
-import type { JsonValue, ModelInfo } from "../types/index.js";
+import type { JsonValue, ModelCapabilities, ModelInfo } from "../types/index.js";
 /**
  * Comprehensive model registry
  */
@@ -25,6 +25,14 @@ export declare function getAllModels(): ModelInfo[];
  * Get model by ID
  */
 export declare function getModelById(id: string): ModelInfo | undefined;
+/**
+ * Check whether a model supports a registered capability.
+ *
+ * Aliases resolve to their canonical model ID before the provider is
+ * cross-checked. Unknown provider/model pairs default to supported so new or
+ * custom models retain the existing behavior until capability data is added.
+ */
+export declare function modelSupports(capability: keyof ModelCapabilities, provider: string, model: string): boolean;
 /**
  * Get models by provider
  */

package/dist/lib/models/modelRegistry.js

@@ -726,7 +726,7 @@ export const MODEL_REGISTRY = {
         description: "Preview version of O1 reasoning model",
         capabilities: {
             vision: false,
-            functionCalling: true,
+            functionCalling: false,
             codeGeneration: true,
             reasoning: true,
             multimodal: false,
@@ -770,7 +770,7 @@ export const MODEL_REGISTRY = {
         description: "Cost-effective O1 variant with strong reasoning capabilities",
         capabilities: {
             vision: false,
-            functionCalling: true,
+            functionCalling: false,
             codeGeneration: true,
             reasoning: true,
             multimodal: false,
@@ -2342,6 +2342,22 @@ export function getAllModels() {
 export function getModelById(id) {
     return MODEL_REGISTRY[id];
 }
+/**
+ * Check whether a model supports a registered capability.
+ *
+ * Aliases resolve to their canonical model ID before the provider is
+ * cross-checked. Unknown provider/model pairs default to supported so new or
+ * custom models retain the existing behavior until capability data is added.
+ */
+export function modelSupports(capability, provider, model) {
+    const normalizedModel = model.toLowerCase();
+    const modelId = MODEL_ALIASES[normalizedModel] ?? normalizedModel;
+    const modelInfo = MODEL_REGISTRY[modelId];
+    if (!modelInfo || modelInfo.provider !== provider.toLowerCase()) {
+        return true;
+    }
+    return modelInfo.capabilities[capability];
+}
 /**
  * Get models by provider
  */

package/dist/lib/neurolink.js

@@ -299,8 +299,9 @@ export const NEUROLINK_BRAND = Symbol.for("@juspay/neurolink/sdk-brand");
  * exists yet to ask directly; every other provider gets tool definitions
  * natively via its `tools` parameter, so repeating them in the prompt was
  * pure token duplication. The stream path asks the provider instance
- * (`provider.supportsTools()`) instead of this list. Keep in sync with
- * `supportsTools()` overrides when adding providers.
+ * (`provider.supportsTools()`) instead of this list. BaseProvider resolves its
+ * default through MODEL_REGISTRY's `modelSupports()` facade; keep this list in
+ * sync with provider-specific `supportsTools()` overrides when adding providers.
  */
 const PROMPT_ONLY_TOOL_PROVIDERS = new Set([
     "ollama",

package/dist/lib/providers/openaiChatCompletionsBase.d.ts

@@ -159,7 +159,6 @@ export declare abstract class OpenAIChatCompletionsProvider extends BaseProvider
      * uses an `api-key` header instead of `Authorization: Bearer`).
      */
     protected getAuthHeaders(): Record<string, string>;
-    supportsTools(): boolean;
     /**
      * Health-check hook — part of the documented public provider contract
      * (`docs/provider-integration/00-architecture.md`). Default returns true

package/dist/lib/providers/openaiChatCompletionsBase.js

@@ -261,9 +261,6 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
     // ===========================================================================
     // Public/protected concrete methods (shared by all subclasses)
     // ===========================================================================
-    supportsTools() {
-        return true;
-    }
     /**
      * Health-check hook — part of the documented public provider contract
      * (`docs/provider-integration/00-architecture.md`). Default returns true

package/dist/models/modelRegistry.d.ts

@@ -4,7 +4,7 @@
  * Part of Phase 4.1 - Models Command System
  */
 import { AIProviderName } from "../constants/enums.js";
-import type { JsonValue, ModelInfo } from "../types/index.js";
+import type { JsonValue, ModelCapabilities, ModelInfo } from "../types/index.js";
 /**
  * Comprehensive model registry
  */
@@ -25,6 +25,14 @@ export declare function getAllModels(): ModelInfo[];
  * Get model by ID
  */
 export declare function getModelById(id: string): ModelInfo | undefined;
+/**
+ * Check whether a model supports a registered capability.
+ *
+ * Aliases resolve to their canonical model ID before the provider is
+ * cross-checked. Unknown provider/model pairs default to supported so new or
+ * custom models retain the existing behavior until capability data is added.
+ */
+export declare function modelSupports(capability: keyof ModelCapabilities, provider: string, model: string): boolean;
 /**
  * Get models by provider
  */

package/dist/models/modelRegistry.js

@@ -726,7 +726,7 @@ export const MODEL_REGISTRY = {
         description: "Preview version of O1 reasoning model",
         capabilities: {
             vision: false,
-            functionCalling: true,
+            functionCalling: false,
             codeGeneration: true,
             reasoning: true,
             multimodal: false,
@@ -770,7 +770,7 @@ export const MODEL_REGISTRY = {
         description: "Cost-effective O1 variant with strong reasoning capabilities",
         capabilities: {
             vision: false,
-            functionCalling: true,
+            functionCalling: false,
             codeGeneration: true,
             reasoning: true,
             multimodal: false,
@@ -2342,6 +2342,22 @@ export function getAllModels() {
 export function getModelById(id) {
     return MODEL_REGISTRY[id];
 }
+/**
+ * Check whether a model supports a registered capability.
+ *
+ * Aliases resolve to their canonical model ID before the provider is
+ * cross-checked. Unknown provider/model pairs default to supported so new or
+ * custom models retain the existing behavior until capability data is added.
+ */
+export function modelSupports(capability, provider, model) {
+    const normalizedModel = model.toLowerCase();
+    const modelId = MODEL_ALIASES[normalizedModel] ?? normalizedModel;
+    const modelInfo = MODEL_REGISTRY[modelId];
+    if (!modelInfo || modelInfo.provider !== provider.toLowerCase()) {
+        return true;
+    }
+    return modelInfo.capabilities[capability];
+}
 /**
  * Get models by provider
  */

package/dist/neurolink.js

@@ -299,8 +299,9 @@ export const NEUROLINK_BRAND = Symbol.for("@juspay/neurolink/sdk-brand");
  * exists yet to ask directly; every other provider gets tool definitions
  * natively via its `tools` parameter, so repeating them in the prompt was
  * pure token duplication. The stream path asks the provider instance
- * (`provider.supportsTools()`) instead of this list. Keep in sync with
- * `supportsTools()` overrides when adding providers.
+ * (`provider.supportsTools()`) instead of this list. BaseProvider resolves its
+ * default through MODEL_REGISTRY's `modelSupports()` facade; keep this list in
+ * sync with provider-specific `supportsTools()` overrides when adding providers.
  */
 const PROMPT_ONLY_TOOL_PROVIDERS = new Set([
     "ollama",

package/dist/providers/openaiChatCompletionsBase.d.ts

@@ -159,7 +159,6 @@ export declare abstract class OpenAIChatCompletionsProvider extends BaseProvider
      * uses an `api-key` header instead of `Authorization: Bearer`).
      */
     protected getAuthHeaders(): Record<string, string>;
-    supportsTools(): boolean;
     /**
      * Health-check hook — part of the documented public provider contract
      * (`docs/provider-integration/00-architecture.md`). Default returns true

package/dist/providers/openaiChatCompletionsBase.js

@@ -261,9 +261,6 @@ export class OpenAIChatCompletionsProvider extends BaseProvider {
     // ===========================================================================
     // Public/protected concrete methods (shared by all subclasses)
     // ===========================================================================
-    supportsTools() {
-        return true;
-    }
     /**
      * Health-check hook — part of the documented public provider contract
      * (`docs/provider-integration/00-architecture.md`). Default returns true

package/dist/providers/sagemaker/language-model.d.ts

@@ -153,7 +153,7 @@ export declare class SageMakerLanguageModel implements SageMakerAsLanguageModel
         provider: string;
         specificationVersion: "v2";
         endpointName: string;
-        modelType: "huggingface" | "mistral" | "custom" | "claude" | "llama" | "jumpstart" | undefined;
+        modelType: "huggingface" | "mistral" | "custom" | "llama" | "claude" | "jumpstart" | undefined;
         region: string;
     };
     /**
@@ -200,7 +200,7 @@ export declare class SageMakerLanguageModel implements SageMakerAsLanguageModel
         provider: string;
         specificationVersion: "v2";
         endpointName: string;
-        modelType: "huggingface" | "mistral" | "custom" | "claude" | "llama" | "jumpstart" | undefined;
+        modelType: "huggingface" | "mistral" | "custom" | "llama" | "claude" | "jumpstart" | undefined;
         region: string;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.5.1",
+  "version": "10.5.3",
   "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": {
@@ -141,6 +141,7 @@
     "test:tool-dedup": "pnpm run test:tool-dedup:vitest && npx tsx test/continuous-test-suite-tool-dedup.ts",
     "test:model-pool:vitest": "pnpm exec vitest run test/modelPool.test.ts",
     "test:model-pool": "pnpm run test:model-pool:vitest && npx tsx test/continuous-test-suite-model-pool.ts",
+    "test:model-capabilities:vitest": "pnpm exec vitest run test/modelCapabilities.test.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",
@@ -149,7 +150,7 @@
     "test:system-messages:vitest": "pnpm exec vitest run test/systemMessages.test.ts",
     "test:tool-routing-semantic:vitest": "pnpm exec vitest run test/toolRoutingSemantic.test.ts",
     "test:tool-routing-semantic": "pnpm run test:tool-routing-semantic:vitest && npx tsx test/continuous-test-suite-tool-routing-semantic.ts",
-    "test:unit": "pnpm run test:envguard && pnpm run test:bugfixes && pnpm run test:file-detector-extension && pnpm run test:file-detector-magic-bytes && 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 && pnpm run test:model-pool:vitest && pnpm run test:litellm-context:vitest && pnpm run test:step-budget-guard:vitest && pnpm run test:system-messages:vitest && pnpm run test:tool-routing-semantic:vitest && pnpm run test:anthropic-tools-policy && pnpm run test:sagemaker-tools && pnpm run test:anthropic-multimodal && pnpm run test:excel-interop",
+    "test:unit": "pnpm run test:envguard && pnpm run test:bugfixes && pnpm run test:file-detector-extension && pnpm run test:file-detector-magic-bytes && 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 && pnpm run test:model-pool:vitest && pnpm run test:litellm-context:vitest && pnpm run test:step-budget-guard:vitest && pnpm run test:system-messages:vitest && pnpm run test:tool-routing-semantic:vitest && pnpm run test:anthropic-tools-policy && pnpm run test:sagemaker-tools && pnpm run test:anthropic-multimodal && pnpm run test:excel-interop && pnpm run test:model-capabilities: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": "",