@juspay/neurolink 9.22.0 → 9.22.2

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [9.22.2](https://github.com/juspay/neurolink/compare/v9.22.1...v9.22.2) (2026-03-12)
+
+### Bug Fixes
+
+- **(observability):** prevent duplicate Langfuse traces from streaming by restricting trace attributes to root spans ([ddac782](https://github.com/juspay/neurolink/commit/ddac78229f7ed42a1d332c23e0a5e6d80418dd6a))
+
+## [9.22.1](https://github.com/juspay/neurolink/compare/v9.22.0...v9.22.1) (2026-03-12)
+
+### Bug Fixes
+
+- **(vision):** allow unknown models for proxy providers in vision check ([b2c5b4e](https://github.com/juspay/neurolink/commit/b2c5b4edebd43545dee8ccb31cb5253302602936))
+
 ## [9.22.0](https://github.com/juspay/neurolink/compare/v9.21.0...v9.22.0) (2026-03-12)
 
 ### Features

package/dist/adapters/providerImageAdapter.js

@@ -39,6 +39,24 @@ const IMAGE_LIMITS = {
     bedrock: 20, // Same as Anthropic for Claude models on Bedrock
     openrouter: 10, // Conservative limit, routes to various underlying providers
 };
+/**
+ * Proxy providers that route to arbitrary underlying models.
+ * Vision capability cannot be statically determined for these — pass requests
+ * through and let the underlying provider surface errors if needed.
+ */
+const PROXY_PROVIDERS = new Set(["litellm", "openrouter"]);
+/**
+ * Normalize provider name/alias to its canonical form for vision checks.
+ */
+function normalizeVisionProvider(provider) {
+    const lower = provider.toLowerCase();
+    switch (lower) {
+        case "or":
+            return "openrouter";
+        default:
+            return lower;
+    }
+}
 /**
  * Vision capability definitions for each provider
  */
@@ -645,13 +663,18 @@ export class ProviderImageAdapter {
      * Validate that provider and model support vision
      */
     static validateVisionSupport(provider, model) {
-        const normalizedProvider = provider.toLowerCase();
+        const normalizedProvider = normalizeVisionProvider(provider);
         const supportedModels = VISION_CAPABILITIES[normalizedProvider];
         if (!supportedModels) {
             throw new Error(`Provider ${provider} does not support vision processing. ` +
                 `Supported providers: ${Object.keys(VISION_CAPABILITIES).join(", ")}`);
         }
         const isSupported = supportedModels.some((supportedModel) => model.toLowerCase().includes(supportedModel.toLowerCase()));
+        // Proxy providers route to arbitrary underlying models — skip the allowlist
+        // check for unknown models and let the underlying provider error if needed.
+        if (!isSupported && PROXY_PROVIDERS.has(normalizedProvider)) {
+            return;
+        }
         if (!isSupported) {
             throw new Error(`Provider ${provider} with model ${model} does not support vision processing. ` +
                 `Supported models for ${provider}: ${supportedModels.join(", ")}`);
@@ -692,7 +715,7 @@ export class ProviderImageAdapter {
      */
     static supportsVision(provider, model) {
         try {
-            const normalizedProvider = provider.toLowerCase();
+            const normalizedProvider = normalizeVisionProvider(provider);
             const supportedModels = VISION_CAPABILITIES[normalizedProvider];
             if (!supportedModels) {
                 return false;
@@ -700,7 +723,13 @@ export class ProviderImageAdapter {
             if (!model) {
                 return true; // Provider supports vision, but need to check specific model
             }
-            return supportedModels.some((supportedModel) => model.toLowerCase().includes(supportedModel.toLowerCase()));
+            const modelMatched = supportedModels.some((supportedModel) => model.toLowerCase().includes(supportedModel.toLowerCase()));
+            // Proxy providers route to arbitrary underlying models — pass through if
+            // the model isn't in the known allowlist.
+            if (!modelMatched && PROXY_PROVIDERS.has(normalizedProvider)) {
+                return true;
+            }
+            return modelMatched;
         }
         catch {
             return false;

package/dist/core/modules/TelemetryHandler.js

@@ -19,6 +19,7 @@ import { recordProviderPerformanceFromMetrics } from "../evaluationProviders.js"
 import { modelConfig } from "../modelConfiguration.js";
 import { TelemetryService } from "../../telemetry/telemetryService.js";
 import { calculateCost, hasPricing } from "../../utils/pricing.js";
+import { getLangfuseContext } from "../../services/server/ai/observability/instrumentation.js";
 /**
  * TelemetryHandler class - Handles analytics and telemetry for AI providers
  */
@@ -143,8 +144,9 @@ export class TelemetryHandler {
             return undefined;
         }
         const context = options.context;
-        const traceName = context?.traceName;
-        const userId = context?.userId;
+        const langfuseContext = getLangfuseContext();
+        const traceName = context?.traceName ?? langfuseContext?.traceName;
+        const userId = context?.userId ?? langfuseContext?.userId;
         const functionId = traceName ? traceName : userId ? userId : "guest";
         const metadata = {
             ...(context?.metadata || {}),
@@ -168,7 +170,7 @@ export class TelemetryHandler {
             isEnabled: true,
             functionId,
             metadata,
-            recordInputs: process.env.NEUROLINK_RECORD_INPUTS?.toLowerCase() === "true",
+            recordInputs: process.env.NEUROLINK_RECORD_INPUTS?.toLowerCase() !== "false",
             recordOutputs: true,
         };
     }

package/dist/lib/adapters/providerImageAdapter.js

@@ -39,6 +39,24 @@ const IMAGE_LIMITS = {
     bedrock: 20, // Same as Anthropic for Claude models on Bedrock
     openrouter: 10, // Conservative limit, routes to various underlying providers
 };
+/**
+ * Proxy providers that route to arbitrary underlying models.
+ * Vision capability cannot be statically determined for these — pass requests
+ * through and let the underlying provider surface errors if needed.
+ */
+const PROXY_PROVIDERS = new Set(["litellm", "openrouter"]);
+/**
+ * Normalize provider name/alias to its canonical form for vision checks.
+ */
+function normalizeVisionProvider(provider) {
+    const lower = provider.toLowerCase();
+    switch (lower) {
+        case "or":
+            return "openrouter";
+        default:
+            return lower;
+    }
+}
 /**
  * Vision capability definitions for each provider
  */
@@ -645,13 +663,18 @@ export class ProviderImageAdapter {
      * Validate that provider and model support vision
      */
     static validateVisionSupport(provider, model) {
-        const normalizedProvider = provider.toLowerCase();
+        const normalizedProvider = normalizeVisionProvider(provider);
         const supportedModels = VISION_CAPABILITIES[normalizedProvider];
         if (!supportedModels) {
             throw new Error(`Provider ${provider} does not support vision processing. ` +
                 `Supported providers: ${Object.keys(VISION_CAPABILITIES).join(", ")}`);
         }
         const isSupported = supportedModels.some((supportedModel) => model.toLowerCase().includes(supportedModel.toLowerCase()));
+        // Proxy providers route to arbitrary underlying models — skip the allowlist
+        // check for unknown models and let the underlying provider error if needed.
+        if (!isSupported && PROXY_PROVIDERS.has(normalizedProvider)) {
+            return;
+        }
         if (!isSupported) {
             throw new Error(`Provider ${provider} with model ${model} does not support vision processing. ` +
                 `Supported models for ${provider}: ${supportedModels.join(", ")}`);
@@ -692,7 +715,7 @@ export class ProviderImageAdapter {
      */
     static supportsVision(provider, model) {
         try {
-            const normalizedProvider = provider.toLowerCase();
+            const normalizedProvider = normalizeVisionProvider(provider);
             const supportedModels = VISION_CAPABILITIES[normalizedProvider];
             if (!supportedModels) {
                 return false;
@@ -700,7 +723,13 @@ export class ProviderImageAdapter {
             if (!model) {
                 return true; // Provider supports vision, but need to check specific model
             }
-            return supportedModels.some((supportedModel) => model.toLowerCase().includes(supportedModel.toLowerCase()));
+            const modelMatched = supportedModels.some((supportedModel) => model.toLowerCase().includes(supportedModel.toLowerCase()));
+            // Proxy providers route to arbitrary underlying models — pass through if
+            // the model isn't in the known allowlist.
+            if (!modelMatched && PROXY_PROVIDERS.has(normalizedProvider)) {
+                return true;
+            }
+            return modelMatched;
         }
         catch {
             return false;

package/dist/lib/core/modules/TelemetryHandler.js

@@ -19,6 +19,7 @@ import { recordProviderPerformanceFromMetrics } from "../evaluationProviders.js"
 import { modelConfig } from "../modelConfiguration.js";
 import { TelemetryService } from "../../telemetry/telemetryService.js";
 import { calculateCost, hasPricing } from "../../utils/pricing.js";
+import { getLangfuseContext } from "../../services/server/ai/observability/instrumentation.js";
 /**
  * TelemetryHandler class - Handles analytics and telemetry for AI providers
  */
@@ -143,8 +144,9 @@ export class TelemetryHandler {
             return undefined;
         }
         const context = options.context;
-        const traceName = context?.traceName;
-        const userId = context?.userId;
+        const langfuseContext = getLangfuseContext();
+        const traceName = context?.traceName ?? langfuseContext?.traceName;
+        const userId = context?.userId ?? langfuseContext?.userId;
         const functionId = traceName ? traceName : userId ? userId : "guest";
         const metadata = {
             ...(context?.metadata || {}),
@@ -168,7 +170,7 @@ export class TelemetryHandler {
             isEnabled: true,
             functionId,
             metadata,
-            recordInputs: process.env.NEUROLINK_RECORD_INPUTS?.toLowerCase() === "true",
+            recordInputs: process.env.NEUROLINK_RECORD_INPUTS?.toLowerCase() !== "false",
             recordOutputs: true,
         };
     }

package/dist/lib/providers/googleAiStudio.js

@@ -464,9 +464,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
                     logger.warn(`[GoogleAIStudio] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
                 }
                 tools =
-                    Object.keys(sanitized.tools).length > 0
-                        ? sanitized.tools
-                        : undefined;
+                    Object.keys(sanitized.tools).length > 0 ? sanitized.tools : undefined;
             }
             else {
                 tools = undefined;

package/dist/lib/providers/googleVertex.js

@@ -831,9 +831,7 @@ export class GoogleVertexProvider extends BaseProvider {
                     logger.warn(`[GoogleVertex] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
                 }
                 tools =
-                    Object.keys(sanitized.tools).length > 0
-                        ? sanitized.tools
-                        : undefined;
+                    Object.keys(sanitized.tools).length > 0 ? sanitized.tools : undefined;
             }
             else if (isAnthropic && Object.keys(rawTools).length > 0) {
                 // Anthropic models don't need Gemini sanitization — pass tools through

package/dist/lib/services/server/ai/observability/instrumentation.js

@@ -81,7 +81,7 @@ class ContextEnricher {
      * operations here so we can update the trace name in onEnd().
      */
     detectedOperations = new Map();
-    onStart(span) {
+    onStart(span, parentContext) {
         const context = contextStorage.getStore();
         const userId = context?.userId ?? currentConfig?.userId ?? "guest";
         const sessionId = context?.sessionId ?? currentConfig?.sessionId;
@@ -140,10 +140,10 @@ class ContextEnricher {
         if (context?.requestId) {
             span.setAttribute("request.id", context.requestId);
         }
-        // Set trace name for Langfuse (using proper Langfuse attribute)
-        if (traceName) {
+        const isRootSpan = !trace.getSpan(parentContext);
+        if (traceName && isRootSpan) {
             span.setAttribute("langfuse.trace.name", traceName);
-            span.setAttribute("trace.name", traceName); // Keep for compatibility
+            span.setAttribute("trace.name", traceName);
         }
         // Set operation name as separate attribute for filtering/analytics
         if (operationName) {
@@ -158,14 +158,16 @@ class ContextEnricher {
                     if (typeof value === "string" ||
                         typeof value === "number" ||
                         typeof value === "boolean") {
-                        span.setAttribute(`metadata.${key}`, value);
+                        if (metadata && isRootSpan) {
+                            span.setAttribute("langfuse.trace.metadata", JSON.stringify(metadata));
+                        }
                     }
                     else if (Array.isArray(value) &&
                         value.every((v) => typeof v === "string" ||
                             typeof v === "number" ||
                             typeof v === "boolean")) {
                         // OTEL supports homogeneous arrays of primitives
-                        span.setAttribute(`metadata.${key}`, value);
+                        span.setAttribute(`metadata.${key}`, JSON.stringify(value));
                     }
                     else {
                         // Fall back to JSON string for complex types

package/dist/lib/utils/modelRouter.d.ts

@@ -18,29 +18,29 @@ declare const MODEL_CONFIGS: {
         };
         readonly fallback: {
             readonly provider: "vertex";
-            readonly model: "gemini-2.5-pro";
+            readonly model: "claude-haiku-4-5@20251001";
             readonly capabilities: readonly ["speed", "general", "basic-reasoning"];
             readonly avgResponseTime: 1200;
             readonly costPerToken: 0.0002;
-            readonly reasoning: "Vertex AI Gemini Pro fallback";
+            readonly reasoning: "Vertex AI Claude Haiku fallback";
         };
     };
     readonly reasoning: {
         readonly primary: {
             readonly provider: "vertex";
-            readonly model: "claude-sonnet-4@20250514";
+            readonly model: "claude-sonnet-4-5@20250929";
             readonly capabilities: readonly ["reasoning", "analysis", "complex-logic", "code", "creativity"];
             readonly avgResponseTime: 3000;
             readonly costPerToken: 0.003;
-            readonly reasoning: "Advanced reasoning and analysis via Claude Sonnet 4 on Vertex AI";
+            readonly reasoning: "Advanced reasoning and analysis via Claude Sonnet 4-5 on Vertex AI";
         };
         readonly fallback: {
             readonly provider: "vertex";
-            readonly model: "claude-opus-4@20250514";
+            readonly model: "claude-opus-4-5@20251101";
             readonly capabilities: readonly ["reasoning", "analysis", "complex-logic", "code", "creativity", "agentic"];
             readonly avgResponseTime: 4000;
             readonly costPerToken: 0.005;
-            readonly reasoning: "Claude Opus 4 fallback on Vertex AI for most complex tasks";
+            readonly reasoning: "Claude Opus 4-5 fallback on Vertex AI for most complex tasks";
         };
     };
 };

package/dist/lib/utils/modelRouter.js

@@ -22,23 +22,23 @@ const MODEL_CONFIGS = {
             provider: "vertex",
             model: "gemini-2.5-flash",
             capabilities: ["speed", "general", "code", "basic-reasoning"],
-            avgResponseTime: 800, // ms
+            avgResponseTime: 800,
             costPerToken: 0.0001,
             reasoning: "Optimized for speed and efficiency via Vertex AI",
         },
         fallback: {
             provider: "vertex",
-            model: "gemini-2.5-pro",
+            model: "claude-haiku-4-5@20251001",
             capabilities: ["speed", "general", "basic-reasoning"],
             avgResponseTime: 1200,
             costPerToken: 0.0002,
-            reasoning: "Vertex AI Gemini Pro fallback",
+            reasoning: "Vertex AI Claude Haiku fallback",
         },
     },
     reasoning: {
         primary: {
             provider: "vertex",
-            model: "claude-sonnet-4@20250514",
+            model: "claude-sonnet-4-5@20250929",
             capabilities: [
                 "reasoning",
                 "analysis",
@@ -46,13 +46,13 @@ const MODEL_CONFIGS = {
                 "code",
                 "creativity",
             ],
-            avgResponseTime: 3000, // ms
+            avgResponseTime: 3000,
             costPerToken: 0.003,
-            reasoning: "Advanced reasoning and analysis via Claude Sonnet 4 on Vertex AI",
+            reasoning: "Advanced reasoning and analysis via Claude Sonnet 4-5 on Vertex AI",
         },
         fallback: {
             provider: "vertex",
-            model: "claude-opus-4@20250514",
+            model: "claude-opus-4-5@20251101",
             capabilities: [
                 "reasoning",
                 "analysis",
@@ -63,7 +63,7 @@ const MODEL_CONFIGS = {
             ],
             avgResponseTime: 4000,
             costPerToken: 0.005,
-            reasoning: "Claude Opus 4 fallback on Vertex AI for most complex tasks",
+            reasoning: "Claude Opus 4-5 fallback on Vertex AI for most complex tasks",
         },
     },
 };

package/dist/providers/googleAiStudio.js

@@ -464,9 +464,7 @@ export class GoogleAIStudioProvider extends BaseProvider {
                     logger.warn(`[GoogleAIStudio] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
                 }
                 tools =
-                    Object.keys(sanitized.tools).length > 0
-                        ? sanitized.tools
-                        : undefined;
+                    Object.keys(sanitized.tools).length > 0 ? sanitized.tools : undefined;
             }
             else {
                 tools = undefined;

package/dist/providers/googleVertex.js

@@ -831,9 +831,7 @@ export class GoogleVertexProvider extends BaseProvider {
                     logger.warn(`[GoogleVertex] Dropped ${sanitized.dropped.length} incompatible tool(s): ${sanitized.dropped.join(", ")}`);
                 }
                 tools =
-                    Object.keys(sanitized.tools).length > 0
-                        ? sanitized.tools
-                        : undefined;
+                    Object.keys(sanitized.tools).length > 0 ? sanitized.tools : undefined;
             }
             else if (isAnthropic && Object.keys(rawTools).length > 0) {
                 // Anthropic models don't need Gemini sanitization — pass tools through

package/dist/services/server/ai/observability/instrumentation.js

@@ -81,7 +81,7 @@ class ContextEnricher {
      * operations here so we can update the trace name in onEnd().
      */
     detectedOperations = new Map();
-    onStart(span) {
+    onStart(span, parentContext) {
         const context = contextStorage.getStore();
         const userId = context?.userId ?? currentConfig?.userId ?? "guest";
         const sessionId = context?.sessionId ?? currentConfig?.sessionId;
@@ -140,10 +140,10 @@ class ContextEnricher {
         if (context?.requestId) {
             span.setAttribute("request.id", context.requestId);
         }
-        // Set trace name for Langfuse (using proper Langfuse attribute)
-        if (traceName) {
+        const isRootSpan = !trace.getSpan(parentContext);
+        if (traceName && isRootSpan) {
             span.setAttribute("langfuse.trace.name", traceName);
-            span.setAttribute("trace.name", traceName); // Keep for compatibility
+            span.setAttribute("trace.name", traceName);
         }
         // Set operation name as separate attribute for filtering/analytics
         if (operationName) {
@@ -158,14 +158,16 @@ class ContextEnricher {
                     if (typeof value === "string" ||
                         typeof value === "number" ||
                         typeof value === "boolean") {
-                        span.setAttribute(`metadata.${key}`, value);
+                        if (metadata && isRootSpan) {
+                            span.setAttribute("langfuse.trace.metadata", JSON.stringify(metadata));
+                        }
                     }
                     else if (Array.isArray(value) &&
                         value.every((v) => typeof v === "string" ||
                             typeof v === "number" ||
                             typeof v === "boolean")) {
                         // OTEL supports homogeneous arrays of primitives
-                        span.setAttribute(`metadata.${key}`, value);
+                        span.setAttribute(`metadata.${key}`, JSON.stringify(value));
                     }
                     else {
                         // Fall back to JSON string for complex types

package/dist/utils/modelRouter.d.ts

@@ -18,29 +18,29 @@ declare const MODEL_CONFIGS: {
         };
         readonly fallback: {
             readonly provider: "vertex";
-            readonly model: "gemini-2.5-pro";
+            readonly model: "claude-haiku-4-5@20251001";
             readonly capabilities: readonly ["speed", "general", "basic-reasoning"];
             readonly avgResponseTime: 1200;
             readonly costPerToken: 0.0002;
-            readonly reasoning: "Vertex AI Gemini Pro fallback";
+            readonly reasoning: "Vertex AI Claude Haiku fallback";
         };
     };
     readonly reasoning: {
         readonly primary: {
             readonly provider: "vertex";
-            readonly model: "claude-sonnet-4@20250514";
+            readonly model: "claude-sonnet-4-5@20250929";
             readonly capabilities: readonly ["reasoning", "analysis", "complex-logic", "code", "creativity"];
             readonly avgResponseTime: 3000;
             readonly costPerToken: 0.003;
-            readonly reasoning: "Advanced reasoning and analysis via Claude Sonnet 4 on Vertex AI";
+            readonly reasoning: "Advanced reasoning and analysis via Claude Sonnet 4-5 on Vertex AI";
         };
         readonly fallback: {
             readonly provider: "vertex";
-            readonly model: "claude-opus-4@20250514";
+            readonly model: "claude-opus-4-5@20251101";
             readonly capabilities: readonly ["reasoning", "analysis", "complex-logic", "code", "creativity", "agentic"];
             readonly avgResponseTime: 4000;
             readonly costPerToken: 0.005;
-            readonly reasoning: "Claude Opus 4 fallback on Vertex AI for most complex tasks";
+            readonly reasoning: "Claude Opus 4-5 fallback on Vertex AI for most complex tasks";
         };
     };
 };

package/dist/utils/modelRouter.js

@@ -22,23 +22,23 @@ const MODEL_CONFIGS = {
             provider: "vertex",
             model: "gemini-2.5-flash",
             capabilities: ["speed", "general", "code", "basic-reasoning"],
-            avgResponseTime: 800, // ms
+            avgResponseTime: 800,
             costPerToken: 0.0001,
             reasoning: "Optimized for speed and efficiency via Vertex AI",
         },
         fallback: {
             provider: "vertex",
-            model: "gemini-2.5-pro",
+            model: "claude-haiku-4-5@20251001",
             capabilities: ["speed", "general", "basic-reasoning"],
             avgResponseTime: 1200,
             costPerToken: 0.0002,
-            reasoning: "Vertex AI Gemini Pro fallback",
+            reasoning: "Vertex AI Claude Haiku fallback",
         },
     },
     reasoning: {
         primary: {
             provider: "vertex",
-            model: "claude-sonnet-4@20250514",
+            model: "claude-sonnet-4-5@20250929",
             capabilities: [
                 "reasoning",
                 "analysis",
@@ -46,13 +46,13 @@ const MODEL_CONFIGS = {
                 "code",
                 "creativity",
             ],
-            avgResponseTime: 3000, // ms
+            avgResponseTime: 3000,
             costPerToken: 0.003,
-            reasoning: "Advanced reasoning and analysis via Claude Sonnet 4 on Vertex AI",
+            reasoning: "Advanced reasoning and analysis via Claude Sonnet 4-5 on Vertex AI",
         },
         fallback: {
             provider: "vertex",
-            model: "claude-opus-4@20250514",
+            model: "claude-opus-4-5@20251101",
             capabilities: [
                 "reasoning",
                 "analysis",
@@ -63,7 +63,7 @@ const MODEL_CONFIGS = {
             ],
             avgResponseTime: 4000,
             costPerToken: 0.005,
-            reasoning: "Claude Opus 4 fallback on Vertex AI for most complex tasks",
+            reasoning: "Claude Opus 4-5 fallback on Vertex AI for most complex tasks",
         },
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.22.0",
+  "version": "9.22.2",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",