@juspay/neurolink 13.8.3 → 13.8.5

package/dist/core/factory.d.ts

@@ -17,8 +17,9 @@ export declare class AIProviderFactory {
     /**
      * A provider whose descriptor declares `inferenceKinds` of exactly `["decide"]`
      * names its own model (its registered default reads its own variable), so a
-     * chat provider's model variable has no claim on it. Exactly `["decide"]`: a
-     * provider that also serves text keeps its chat-model fallbacks.
+     * chat provider's model variable has no claim on it, nor does the chat model
+     * registry. Exactly `["decide"]`: a provider that also serves text keeps its
+     * chat-model fallbacks.
      */
     private static isDecisionOnly;
     private static resolveModelFromEnvironment;

package/dist/core/factory.js

@@ -51,8 +51,9 @@ export class AIProviderFactory {
     /**
      * A provider whose descriptor declares `inferenceKinds` of exactly `["decide"]`
      * names its own model (its registered default reads its own variable), so a
-     * chat provider's model variable has no claim on it. Exactly `["decide"]`: a
-     * provider that also serves text keeps its chat-model fallbacks.
+     * chat provider's model variable has no claim on it, nor does the chat model
+     * registry. Exactly `["decide"]`: a provider that also serves text keeps its
+     * chat-model fallbacks.
      */
     static isDecisionOnly(providerName) {
         const canonical = PROVIDER_ALIAS_INDEX.get(providerName.toLowerCase());
@@ -151,6 +152,17 @@ export class AIProviderFactory {
             });
             return resolvedModelName;
         }
+        // The registry lists chat providers, and a decision-only provider reads its
+        // own model setting, so loading it for one can only cost: it is awaited (up
+        // to the 10 s init timeout), tries a local port, then GitHub, then a file,
+        // and is tried again by the next call when every source fails.
+        if (this.isDecisionOnly(providerName)) {
+            logger.debug(`[${functionTag}] Skipping dynamic model resolution`, {
+                resolvedModelName: resolvedModelName || "none",
+                reason: `${providerName} serves decisions only and reads its own model setting`,
+            });
+            return resolvedModelName;
+        }
         logger.debug(`[${functionTag}] Attempting dynamic model resolution`, {
             currentResolvedModel: resolvedModelName || "none",
             reason: "No environment variable found and no explicit model provided",

package/dist/mcp/externalServerManager.js

@@ -8,7 +8,7 @@
  */
 import { EventEmitter } from "events";
 import { mcpLogger } from "../utils/logger.js";
-import { MCPClientFactory, terminateStartingStdioServers, } from "./mcpClientFactory.js";
+import { MCPClientFactory, terminateLiveStdioServers, } from "./mcpClientFactory.js";
 import { ToolDiscoveryService } from "./toolDiscoveryService.js";
 import { toolRegistry } from "./toolRegistry.js";
 import { HITLUserRejectedError, HITLTimeoutError } from "../hitl/hitlErrors.js";
@@ -372,9 +372,9 @@ const shutdownOnSignal = (signal) => {
         // re-raise and nowhere else.
         if (!hadOtherListeners) {
             process.removeListener(signal, shutdownOnSignal);
-            // Dying of a signal runs no `exit` handler, and the cleanup above cannot
-            // reach a server whose handshake is still pending.
-            terminateStartingStdioServers();
+            // Dying of a signal runs no `exit` handler, and the cleanup above reaches
+            // only the servers a manager has recorded and that close when asked.
+            terminateLiveStdioServers();
             process.kill(process.pid, signal);
         }
     });

package/dist/mcp/mcpClientFactory.d.ts

@@ -14,7 +14,7 @@ import type { MCPTransportType, MCPServerInfo, MCPClientResult } from "../types/
  * `exit` event, and SIGTERM is delivered by the kernel even though this
  * process is already on its way out.
  */
-export declare const terminateStartingStdioServers: () => void;
+export declare const terminateLiveStdioServers: () => void;
 /**
  * MCPClientFactory
  * Factory class for creating MCP clients with different transports

package/dist/mcp/mcpClientFactory.js

@@ -63,25 +63,29 @@ class StderrTail {
 }
 const stderrTails = new WeakMap();
 /**
- * Stdio servers that have been spawned but have not yet answered `initialize`.
+ * Stdio servers this process has spawned and has not yet seen close.
  *
- * Nothing that cleans up at exit can reach one: the manager learns of a client
- * and its transport only when `connect()` returns, and `process.exit()` runs
- * no async handler anyway. It is also the state a server is least likely to
- * notice its host going away, because `npx -y <pkg>` does not read its stdin
- * until the package has downloaded. Once a server has answered it is an
- * ordinary MCP server again and ends when its stdin closes, so it leaves this
- * set and the shutdown paths that already exist keep ownership of it.
+ * A transport is tracked from creation to close, not only until the server
+ * answers `initialize`, because two things leave a server running with nothing
+ * to stop it. Until the manager records the client, which happens only after
+ * `connect()` and the handshake, no shutdown path knows the server exists, and
+ * `npx -y <pkg>` does not read its stdin until the package has downloaded.
+ * After that, a server holding a timer, a connection pool or a file watcher
+ * ignores its stdin closing, and `process.exit()` runs neither `beforeExit`
+ * nor the manager's async shutdown.
+ *
+ * `transport.close()` takes a transport out through `onclose` once the child
+ * has exited, so a server the manager closed is not signalled again.
  */
-const startingStdioTransports = new Set();
-let startingStdioExitHookInstalled = false;
+const liveStdioTransports = new Set();
+let stdioExitHookInstalled = false;
 /**
  * Synchronous on purpose: it is the one thing that can run inside the
  * `exit` event, and SIGTERM is delivered by the kernel even though this
  * process is already on its way out.
  */
-export const terminateStartingStdioServers = () => {
-    for (const transport of startingStdioTransports) {
+export const terminateLiveStdioServers = () => {
+    for (const transport of liveStdioTransports) {
         if ("pid" in transport && typeof transport.pid === "number") {
             try {
                 process.kill(transport.pid, "SIGTERM");
@@ -92,16 +96,18 @@ export const terminateStartingStdioServers = () => {
         }
     }
 };
-const trackStartingStdioTransport = (transport) => {
-    if (!startingStdioExitHookInstalled) {
-        startingStdioExitHookInstalled = true;
-        process.on("exit", terminateStartingStdioServers);
+const trackStdioTransport = (transport) => {
+    if (!stdioExitHookInstalled) {
+        stdioExitHookInstalled = true;
+        process.on("exit", terminateLiveStdioServers);
     }
-    startingStdioTransports.add(transport);
+    liveStdioTransports.add(transport);
     // Client.connect() chains an onclose that is already set rather than
-    // replacing it, and a spawn that fails still closes the transport.
+    // replacing it, and the manager listens on client.onclose, so this one
+    // survives for the life of the connection. A spawn that fails still closes
+    // the transport.
     transport.onclose = () => {
-        startingStdioTransports.delete(transport);
+        liveStdioTransports.delete(transport);
     };
 };
 /**
@@ -265,7 +271,6 @@ export class MCPClientFactory {
             }
             // Connect with timeout
             await this.raceWithTimeout(client.connect(transport, { timeout }), timeout, `Client connection timeout for ${config.id}`);
-            startingStdioTransports.delete(transport);
             // Perform handshake to get server capabilities
             const serverCapabilities = await this.performHandshake(client, timeout);
             mcpLogger.debug(`[MCPClientFactory] Handshake completed for ${config.id}`, {
@@ -361,7 +366,7 @@ export class MCPClientFactory {
             cwd: config.cwd,
             stderr: "pipe",
         });
-        trackStartingStdioTransport(transport);
+        trackStdioTransport(transport);
         const tail = new StderrTail();
         stderrTails.set(transport, tail);
         transport.stderr?.on("data", (chunk) => {

package/docs-site/static/search-index.json

@@ -6932,7 +6932,7 @@
 {"objectID":"414073f854b4e0089e242f2f22fbfaf3f7e6eedefd0c50b7d59b869892a88ff7","title":"Old Complex Approach (Removed)","url":"/docs/guides/domain-specific#old-complex-approach-removed","content":"Old Complex Approach (Removed)","hierarchy":{"lvl0":"Guides","lvl1":"Domain-Specific AI Usage Guide","lvl2":"Old Complex Approach (Removed)","lvl3":""}},
 {"objectID":"9e4ad8dacc4c35053c269f93b548667a415aeb50ac75c886c9fe4c690ec9642b","title":"New Simple Approach (Current)","url":"/docs/guides/domain-specific#new-simple-approach-current","content":"New Simple Approach (Current)","hierarchy":{"lvl0":"Guides","lvl1":"Domain-Specific AI Usage Guide","lvl2":"New Simple Approach (Current)","lvl3":""}},
 {"objectID":"decae422fa08532a517df169300f8b19a6200d3d66e9d8942b99e501f400101c","title":"🔧 Migration Guide","url":"/docs/guides/domain-specific#-migration-guide","content":"If you were using the old domain configuration:\nRemove old config: pnpm cli config reset (optional)\nUse simple parameters: Add evaluationDomain to your requests\nEnable features: Use enableEvaluation and enableAnalytics flags\n\nBefore:\n\nAfter:\n\nThis simplified approach gives you all the domain-specific AI benefits without configuration complexity.","hierarchy":{"lvl0":"Guides","lvl1":"Domain-Specific AI Usage Guide","lvl2":"🔧 Migration Guide","lvl3":""}},
-{"objectID":"11123a060c91ea3b304978b427176ba793f0ccc1d7d37e2c9a7e833cce3becb1","title":"Dynamic Model Configuration System","url":"/docs/guides/dynamic-models","content":"Dynamic Model Configuration System\n\nThis document describes the new dynamic model configuration system that replaces static enums with flexible, runtime-configurable model definitions.\n\n🎯 Overview\n\nThe dynamic model system enables:\nRuntime model discovery from external configuration sources\nAutomatic fallback to local configurations when external sources fail\nSmart model resolution with fuzzy matching and aliases\nCapability-based search to find models with specific features\nCost optimization by automatically selecting cheapest models for tasks\n\n🏗️ Architecture\n\nComponents\nModel Configuration Server (scripts/modelServer.js)\nServes model configurations via REST API\nProvides search and filtering capabilities\nCan be hosted anywhere (GitHub, CDN, internal server)\nDynamic Model Provider (src/lib/core/dynamicModels.ts)\nLoads configurations from multiple sources with fallback\nCaches configurations to reduce network requests\nValidates configurations using Zod schemas\nProvides intelligent model resolution\nModel Configuration (config/models.json)\nJSON-based model definitions\nIncludes pricing, capabilities, and metadata\nSupports aliases and provider defaults\n\n🚀 Quick Start\nEnvironment Setup\n\nBefore using the dynamic model system, ensure your provider configurations are set up correctly. See the Provider Configuration Guide for detailed instructions.\nStart the Model Server\n\nServer runs on http://localhost:3001 by default.\nTest the System\nUse in Code\n\n📡 API Endpoints\n\nModel Server Endpoints\nGET /health - Health check\nGET /api/v1/models - Get all model configurations\nGET /api/v1/models/:provider - Get models for specific provider\nGET /api/v1/search?capability=X&maxPrice=Y - Search models by criteria\n\nExample API Usage\n\n🔧 Configuration Schema\n\nModel Configuration Structure\n\nKey Fields\nid: Provider-specific model identifier\ndisplayName: Human-readable model name\ncapabilities: Array of model capabilities (functionCalling, vision, etc.)\ndeprecated: Whether the model is deprecated\npricing: Input/output token costs per 1K tokens\ncontextWindow: Maximum context window size\nreleaseDate: Model release date\n\n🎛️ Advanced Usage\n\nConfiguration Sources\n\nThe system tries multiple sources in order:\nprocess.env.MODEL_CONFIG_URL - Custom URL override\nhttp://localhost:3001/api/v1/models - Local development server\nhttps://raw.githubusercontent.com/juspay/neurolink/release/config/models.json - GitHub\n./config/models.json - Local fallback\n\nModel Resolution Logic\n\nCapability Search Options\n\n🔄 Migration from Static Enums\n\nBefore (Static Enums)\n\nAfter (Dynamic Resolution)\n\n🔐 Production Deployment\n\nEnvironment Variables\n\nHosting Configuration\nGitHub Pages: Host models.json as static file\nCDN: Use CloudFlare/AWS CloudFront for global distribution\nInternal API: Integrate with existing infrastructure\nFile System: Local configurations for air-gapped environments\n\nCache Strategy\n5-minute cache: Balances freshness with performance\nGraceful degradation: Falls back to cached data on network failures\nManual refresh: dynamicModelProvider.refresh() for immediate updates\n\n🧪 Testing\n\nThe test suite verifies:\n\n✅ Model provider initialization\n✅ Configuration loading from multiple sources\n✅ Model resolution (exact, default, fuzzy, alias)\n✅ Capability-based search\n✅ Best model selection algorithms\n✅ Error handling and fallbacks\n\nRun tests with:\n\n🚀 Benefits\n🔄 Future-Proof: New models automatically available\n💰 Cost-Optimized: Runtime selection based on pricing\n🛡️ Reliable: Multiple fallback sources\n⚡ Fast: Cached configurations with smart invalidation\n🔒 Type-Safe: Zod schemas ensure runtime safety\n🔧 Backward Compatible: Existing code continues working\n\nThis system transforms static model definitions into a dynamic, self-updating platform that scales with the rapidly evolving AI landscape.","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"","lvl3":""}},
+{"objectID":"11123a060c91ea3b304978b427176ba793f0ccc1d7d37e2c9a7e833cce3becb1","title":"Dynamic Model Configuration System","url":"/docs/guides/dynamic-models","content":"Dynamic Model Configuration System\n\nThis document describes the new dynamic model configuration system that replaces static enums with flexible, runtime-configurable model definitions.\n\n🎯 Overview\n\nThe dynamic model system enables:\nRuntime model discovery from external configuration sources\nAutomatic fallback to local configurations when external sources fail\nSmart model resolution with fuzzy matching and aliases\nCapability-based search to find models with specific features\nCost optimization by automatically selecting cheapest models for tasks\n\n🏗️ Architecture\n\nComponents\nModel Configuration Server (scripts/modelServer.js)\nServes model configurations via REST API\nProvides search and filtering capabilities\nCan be hosted anywhere (GitHub, CDN, internal server)\nDynamic Model Provider (src/lib/core/dynamicModels.ts)\nLoads configurations from multiple sources with fallback\nCaches configurations to reduce network requests\nValidates configurations using Zod schemas\nProvides intelligent model resolution\nModel Configuration (config/models.json)\nJSON-based model definitions\nIncludes pricing, capabilities, and metadata\nSupports aliases and provider defaults\n\n🚀 Quick Start\nEnvironment Setup\n\nBefore using the dynamic model system, ensure your provider configurations are set up correctly. See the Provider Configuration Guide for detailed instructions.\nStart the Model Server\n\nServer runs on http://localhost:3001 by default.\nTest the System\nUse in Code\n\n📡 API Endpoints\n\nModel Server Endpoints\nGET /health - Health check\nGET /api/v1/models - Get all model configurations\nGET /api/v1/models/:provider - Get models for specific provider\nGET /api/v1/search?capability=X&maxPrice=Y - Search models by criteria\n\nExample API Usage\n\n🔧 Configuration Schema\n\nModel Configuration Structure\n\nKey Fields\nid: Provider-specific model identifier\ndisplayName: Human-readable model name\ncapabilities: Array of model capabilities (functionCalling, vision, etc.)\ndeprecated: Whether the model is deprecated\npricing: Input/output token costs per 1K tokens\ncontextWindow: Maximum context window size\nreleaseDate: Model release date\n\n🎛️ Advanced Usage\n\nConfiguration Sources\n\nThe system tries multiple sources in order:\nprocess.env.MODEL_CONFIG_URL - Custom URL override\nhttp://localhost:3001/api/v1/models - Local development server\nhttps://raw.githubusercontent.com/juspay/neurolink/release/config/models.json - GitHub\n./config/models.json - Local fallback\n\nOnly chat providers use these sources. A decision provider (the decide\ninference type) reads its own model setting and never loads them.\n\nModel Resolution Logic\n\nCapability Search Options\n\n🔄 Migration from Static Enums\n\nBefore (Static Enums)\n\nAfter (Dynamic Resolution)\n\n🔐 Production Deployment\n\nEnvironment Variables\n\nHosting Configuration\nGitHub Pages: Host models.json as static file\nCDN: Use CloudFlare/AWS CloudFront for global distribution\nInternal API: Integrate with existing infrastructure\nFile System: Local configurations for air-gapped environments\n\nCache Strategy\n5-minute cache: Balances freshness with performance\nGraceful degradation: Falls back to cached data on network failures\nManual refresh: dynamicModelProvider.refresh() for immediate updates\n\n🧪 Testing\n\nThe test suite verifies:\n\n✅ Model provider initialization\n✅ Configuration loading from multiple sources\n✅ Model resolution (exact, default, fuzzy, alias)\n✅ Capability-based search\n✅ Best model selection algorithms\n✅ Error handling and fallbacks\n\nRun tests with:\n\n🚀 Benefits\n🔄 Future-Proof: New models automatically available\n💰 Cost-Optimized: Runtime selection based on pricing\n🛡️ Reliable: Multiple fallback sources\n⚡ Fast: Cached configurations with smart invalidation\n🔒 Type-Safe: Zod schemas ensure runtime safety\n🔧 Backward Compatible: Existing code continues working\n\nThis system transforms static model definitions into a dynamic, self-updating platform that scales with the rapidly evolving AI landscape.","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"","lvl3":""}},
 {"objectID":"db0dd52cd471bbbf32227e2195168f0402abbbb17462a95fec58b9ff60387e0e","title":"Dynamic Model Configuration System","url":"/docs/guides/dynamic-models#dynamic-model-configuration-system","content":"This document describes the new dynamic model configuration system that replaces static enums with flexible, runtime-configurable model definitions.","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Dynamic Model Configuration System","lvl3":""}},
 {"objectID":"98d59f7bb1b48c946b9671430c1a48b627caa50c718285629a2ccdca68461f6f","title":"🎯 Overview","url":"/docs/guides/dynamic-models#-overview","content":"The dynamic model system enables:\nRuntime model discovery from external configuration sources\nAutomatic fallback to local configurations when external sources fail\nSmart model resolution with fuzzy matching and aliases\nCapability-based search to find models with specific features\nCost optimization by automatically selecting cheapest models for tasks","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"🎯 Overview","lvl3":""}},
 {"objectID":"61687b3b7ac0a3524d872ed6d9e535b66c7e7f888ca25202373543b085cd358c","title":"Components","url":"/docs/guides/dynamic-models#components","content":"Model Configuration Server (scripts/modelServer.js)\nServes model configurations via REST API\nProvides search and filtering capabilities\nCan be hosted anywhere (GitHub, CDN, internal server)\nDynamic Model Provider (src/lib/core/dynamicModels.ts)\nLoads configurations from multiple sources with fallback\nCaches configurations to reduce network requests\nValidates configurations using Zod schemas\nProvides intelligent model resolution\nModel Configuration (config/models.json)\nJSON-based model definitions\nIncludes pricing, capabilities, and metadata\nSupports aliases and provider defaults","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Components","lvl3":""}},
@@ -6944,7 +6944,7 @@
 {"objectID":"44a7c3552d226686afe7bcd07306d423f895b6594053ceaea4e3d91d02fd0b7e","title":"Example API Usage","url":"/docs/guides/dynamic-models#example-api-usage","content":"Example API Usage","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Example API Usage","lvl3":""}},
 {"objectID":"67f064b3683be73cb6e6b7cb977710e02544fa1d4bc2ff21ae53cb660a9bd6af","title":"Model Configuration Structure","url":"/docs/guides/dynamic-models#model-configuration-structure","content":"Model Configuration Structure","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Model Configuration Structure","lvl3":""}},
 {"objectID":"9219ec439a82c9925daf0a3d17fcb470741c29c85cb4eeb094c5a69a9a98d4bd","title":"Key Fields","url":"/docs/guides/dynamic-models#key-fields","content":"id: Provider-specific model identifier\ndisplayName: Human-readable model name\ncapabilities: Array of model capabilities (functionCalling, vision, etc.)\ndeprecated: Whether the model is deprecated\npricing: Input/output token costs per 1K tokens\ncontextWindow: Maximum context window size\nreleaseDate: Model release date","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Key Fields","lvl3":""}},
-{"objectID":"0f264f6be2e93ba8e2a581391c1e9b1fca8fe98a53533e93362c8da8bba29dc0","title":"Configuration Sources","url":"/docs/guides/dynamic-models#configuration-sources","content":"The system tries multiple sources in order:\nprocess.env.MODEL_CONFIG_URL - Custom URL override\nhttp://localhost:3001/api/v1/models - Local development server\nhttps://raw.githubusercontent.com/juspay/neurolink/release/config/models.json - GitHub\n./config/models.json - Local fallback","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Configuration Sources","lvl3":""}},
+{"objectID":"0f264f6be2e93ba8e2a581391c1e9b1fca8fe98a53533e93362c8da8bba29dc0","title":"Configuration Sources","url":"/docs/guides/dynamic-models#configuration-sources","content":"The system tries multiple sources in order:\nprocess.env.MODEL_CONFIG_URL - Custom URL override\nhttp://localhost:3001/api/v1/models - Local development server\nhttps://raw.githubusercontent.com/juspay/neurolink/release/config/models.json - GitHub\n./config/models.json - Local fallback\n\nOnly chat providers use these sources. A decision provider (the decide\ninference type) reads its own model setting and never loads them.","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Configuration Sources","lvl3":""}},
 {"objectID":"b688f0ce894e3129cf9cf4f16256f66b5c7e68e0f6dba297bb7944fca37d5115","title":"Model Resolution Logic","url":"/docs/guides/dynamic-models#model-resolution-logic","content":"Model Resolution Logic","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Model Resolution Logic","lvl3":""}},
 {"objectID":"7db5af405a30c15d8205661f5688afb88863bf77da535269e1c31d9c95f5339a","title":"Capability Search Options","url":"/docs/guides/dynamic-models#capability-search-options","content":"Capability Search Options","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Capability Search Options","lvl3":""}},
 {"objectID":"1496da3154d5741db46365221066e76d4eb6228a9a7f64f4dc05669648a5e92a","title":"Before (Static Enums)","url":"/docs/guides/dynamic-models#before-static-enums","content":"Before (Static Enums)","hierarchy":{"lvl0":"Guides","lvl1":"Dynamic Model Configuration System","lvl2":"Before (Static Enums)","lvl3":""}},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "13.8.3",
+  "version": "13.8.5",
   "packageManager": "pnpm@10.15.1",
   "description": "The pipe layer of an AI nervous system: one interface connecting provider neurons to your application, across three inference types — generate, stream and decide. `decide` returns typed, calibrated judgements from a non-generative model (~400ms, ~$0.00002/call) for routing, tool selection and context budgeting. MCP-native (4 transports), voice TTS/STT/realtime, RAG, agents, memory, compaction, 9 observability exporters. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · TypeSafe Jev and more.",
   "author": {