@juspay/neurolink 7.53.5 → 8.0.0

package/dist/services/server/ai/observability/instrumentation.d.ts

@@ -55,3 +55,20 @@ export declare function getLangfuseHealthStatus(): {
         release: string;
     } | undefined;
 };
+/**
+ * Set user and session context for Langfuse spans in the current async context
+ *
+ * Merges the provided context with existing AsyncLocalStorage context. If a callback is provided,
+ * the context is scoped to that callback execution. Without a callback, the context applies to
+ * the current execution context and its children.
+ *
+ * Uses AsyncLocalStorage to properly scope context per request, avoiding race conditions
+ * in concurrent scenarios.
+ *
+ * @param context - Object containing optional userId and/or sessionId to merge with existing context
+ * @param callback - Optional callback to run within the context scope. If omitted, context applies to current execution
+ */
+export declare function setLangfuseContext(context: {
+    userId?: string | null;
+    sessionId?: string | null;
+}, callback?: () => void | Promise<void>): Promise<void>;

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

@@ -10,13 +10,38 @@ import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
 import { LangfuseSpanProcessor } from "@langfuse/otel";
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from "@opentelemetry/semantic-conventions";
 import { resourceFromAttributes } from "@opentelemetry/resources";
+import { AsyncLocalStorage } from "async_hooks";
 import { logger } from "../../../../utils/logger.js";
 const LOG_PREFIX = "[OpenTelemetry]";
+const contextStorage = new AsyncLocalStorage();
 let tracerProvider = null;
 let langfuseProcessor = null;
 let isInitialized = false;
 let isCredentialsValid = false;
 let currentConfig = null;
+/**
+ * Span processor that enriches spans with user and session context from AsyncLocalStorage
+ */
+class ContextEnricher {
+    onStart(span) {
+        const context = contextStorage.getStore();
+        const userId = context?.userId ?? currentConfig?.userId;
+        const sessionId = context?.sessionId ?? currentConfig?.sessionId;
+        if (userId) {
+            span.setAttribute("user.id", userId);
+        }
+        if (sessionId) {
+            span.setAttribute("session.id", sessionId);
+        }
+    }
+    onEnd() { }
+    shutdown() {
+        return Promise.resolve();
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+}
 /**
  * Initialize OpenTelemetry with Langfuse span processor
  *
@@ -46,7 +71,6 @@ export function initializeOpenTelemetry(config) {
     try {
         currentConfig = config;
         isCredentialsValid = true;
-        // Create Langfuse span processor with configuration
         langfuseProcessor = new LangfuseSpanProcessor({
             publicKey: config.publicKey,
             secretKey: config.secretKey,
@@ -54,18 +78,15 @@ export function initializeOpenTelemetry(config) {
             environment: config.environment || "dev",
             release: config.release || "v1.0.0",
         });
-        // Create resource with service metadata (v2.x API)
         const resource = resourceFromAttributes({
             [ATTR_SERVICE_NAME]: "neurolink",
             [ATTR_SERVICE_VERSION]: config.release || "v1.0.0",
             "deployment.environment": config.environment || "dev",
         });
-        // Initialize tracer provider with span processor and resource
         tracerProvider = new NodeTracerProvider({
             resource,
-            spanProcessors: [langfuseProcessor],
+            spanProcessors: [new ContextEnricher(), langfuseProcessor],
         });
-        // Register provider globally so Vercel AI SDK can use it
         tracerProvider.register();
         isInitialized = true;
         logger.info(`${LOG_PREFIX} Initialized with Langfuse span processor`, {
@@ -168,3 +189,31 @@ export function getLangfuseHealthStatus() {
             : undefined,
     };
 }
+/**
+ * Set user and session context for Langfuse spans in the current async context
+ *
+ * Merges the provided context with existing AsyncLocalStorage context. If a callback is provided,
+ * the context is scoped to that callback execution. Without a callback, the context applies to
+ * the current execution context and its children.
+ *
+ * Uses AsyncLocalStorage to properly scope context per request, avoiding race conditions
+ * in concurrent scenarios.
+ *
+ * @param context - Object containing optional userId and/or sessionId to merge with existing context
+ * @param callback - Optional callback to run within the context scope. If omitted, context applies to current execution
+ */
+export async function setLangfuseContext(context, callback) {
+    const currentContext = contextStorage.getStore() || {};
+    const newContext = {
+        userId: context.userId !== undefined ? context.userId : currentContext.userId,
+        sessionId: context.sessionId !== undefined
+            ? context.sessionId
+            : currentContext.sessionId,
+    };
+    if (callback) {
+        return await contextStorage.run(newContext, callback);
+    }
+    else {
+        contextStorage.enterWith(newContext);
+    }
+}

package/dist/types/common.d.ts

@@ -114,6 +114,7 @@ export type NeuroLinkEvents = {
     message: unknown;
     error: unknown;
     log: unknown;
+    "log-event": unknown;
     [key: string]: unknown;
 };
 /**

package/dist/types/observability.d.ts

@@ -24,6 +24,10 @@ export type LangfuseConfig = {
     environment?: string;
     /** Release/version identifier */
     release?: string;
+    /** Optional default user id to attach to spans */
+    userId?: string;
+    /** Optional default session id to attach to spans */
+    sessionId?: string;
 };
 /**
  * OpenTelemetry configuration

package/dist/utils/fileDetector.js

@@ -3,7 +3,7 @@
  * Centralized file detection for all multimodal file types
  * Uses multi-strategy approach for reliable type identification
  */
-import { request } from "undici";
+import { request, getGlobalDispatcher, interceptors } from "undici";
 import { readFile, stat } from "fs/promises";
 import { logger } from "./logger.js";
 import { CSVProcessor } from "./csvProcessor.js";
@@ -146,10 +146,10 @@ export class FileDetector {
         const maxSize = options?.maxSize || 10 * 1024 * 1024;
         const timeout = options?.timeout || 30000;
         const response = await request(url, {
+            dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
             method: "GET",
             headersTimeout: timeout,
             bodyTimeout: timeout,
-            maxRedirections: 5,
         });
         if (response.statusCode !== 200) {
             throw new Error(`HTTP ${response.statusCode}`);
@@ -271,10 +271,10 @@ class MimeTypeStrategy {
         }
         try {
             const response = await request(input, {
+                dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
                 method: "HEAD",
                 headersTimeout: 5000,
                 bodyTimeout: 5000,
-                maxRedirections: 5,
             });
             const contentType = response.headers["content-type"] || "";
             const type = this.mimeToFileType(contentType);

package/dist/utils/logger.d.ts

@@ -19,7 +19,22 @@ declare class NeuroLinkLogger {
     private logs;
     private maxLogs;
     private isDebugMode;
+    private eventEmitter?;
     constructor();
+    /**
+     * Sets the event emitter that will receive log events.
+     * When set, all log operations will emit a "log-event" event.
+     *
+     * @param emitter - The event emitter instance
+     */
+    setEventEmitter(emitter: {
+        emit: (event: string, ...args: unknown[]) => boolean;
+    }): void;
+    /**
+     * Clears the event emitter reference.
+     * Should be called when a NeuroLink instance is disposed to prevent memory leaks.
+     */
+    clearEventEmitter(): void;
     /**
      * Sets the minimum log level that will be processed and output.
      * Log messages with a level lower than this will be ignored.
@@ -63,6 +78,7 @@ declare class NeuroLinkLogger {
      * 2. Storing entries in the log history
      * 3. Managing log rotation to prevent memory issues
      * 4. Outputting formatted logs to the console
+     * 5. Emitting log events if an event emitter is configured
      *
      * This is the central method called by all specific logging methods (debug, info, etc.)
      *
@@ -164,6 +180,7 @@ declare class NeuroLinkLogger {
  * - Unconditional logging (always, table)
  * - Log level control and configuration
  * - Log history management
+ * - Event emission for all log operations (when emitter is configured)
  */
 export declare const logger: {
     debug: (...args: unknown[]) => void;
@@ -175,6 +192,10 @@ export declare const logger: {
     setLogLevel: (level: LogLevel) => void;
     getLogs: (level?: LogLevel) => LogEntry[];
     clearLogs: () => void;
+    setEventEmitter: (emitter: {
+        emit: (event: string, ...args: unknown[]) => boolean;
+    }) => void;
+    clearEventEmitter: () => void;
 };
 /**
  * MCP compatibility exports - all use the same unified logger instance.

package/dist/utils/logger.js

@@ -25,6 +25,7 @@ class NeuroLinkLogger {
     logs = [];
     maxLogs = 1000;
     isDebugMode;
+    eventEmitter;
     constructor() {
         // Cache debug mode check to avoid repeated array searches
         this.isDebugMode =
@@ -36,6 +37,22 @@ class NeuroLinkLogger {
             this.logLevel = envLevel;
         }
     }
+    /**
+     * Sets the event emitter that will receive log events.
+     * When set, all log operations will emit a "log-event" event.
+     *
+     * @param emitter - The event emitter instance
+     */
+    setEventEmitter(emitter) {
+        this.eventEmitter = emitter;
+    }
+    /**
+     * Clears the event emitter reference.
+     * Should be called when a NeuroLink instance is disposed to prevent memory leaks.
+     */
+    clearEventEmitter() {
+        this.eventEmitter = undefined;
+    }
     /**
      * Sets the minimum log level that will be processed and output.
      * Log messages with a level lower than this will be ignored.
@@ -106,6 +123,7 @@ class NeuroLinkLogger {
      * 2. Storing entries in the log history
      * 3. Managing log rotation to prevent memory issues
      * 4. Outputting formatted logs to the console
+     * 5. Emitting log events if an event emitter is configured
      *
      * This is the central method called by all specific logging methods (debug, info, etc.)
      *
@@ -123,6 +141,20 @@ class NeuroLinkLogger {
             timestamp: new Date(),
             data,
         };
+        // Emit log event if emitter is configured
+        if (this.eventEmitter) {
+            try {
+                this.eventEmitter.emit("log-event", {
+                    level,
+                    message,
+                    timestamp: new Date().getTime(),
+                    data,
+                });
+            }
+            catch {
+                // Silently ignore emitter errors to avoid disrupting logging
+            }
+        }
         // Store log entry
         this.logs.push(entry);
         // Trim old logs
@@ -277,6 +309,7 @@ function processLoggerArgs(args, logMethod) {
  * - Unconditional logging (always, table)
  * - Log level control and configuration
  * - Log history management
+ * - Event emission for all log operations (when emitter is configured)
  */
 export const logger = {
     debug: (...args) => {
@@ -309,6 +342,8 @@ export const logger = {
     setLogLevel: (level) => neuroLinkLogger.setLogLevel(level),
     getLogs: (level) => neuroLinkLogger.getLogs(level),
     clearLogs: () => neuroLinkLogger.clearLogs(),
+    setEventEmitter: (emitter) => neuroLinkLogger.setEventEmitter(emitter),
+    clearEventEmitter: () => neuroLinkLogger.clearEventEmitter(),
 };
 /**
  * MCP compatibility exports - all use the same unified logger instance.

package/dist/utils/messageBuilder.js

@@ -8,7 +8,7 @@ import { ProviderImageAdapter, MultimodalLogger, } from "../adapters/providerIma
 import { logger } from "./logger.js";
 import { FileDetector } from "./fileDetector.js";
 import { PDFProcessor } from "./pdfProcessor.js";
-import { request } from "undici";
+import { request, getGlobalDispatcher, interceptors } from "undici";
 import { readFileSync, existsSync } from "fs";
 /**
  * Type guard for validating message roles
@@ -562,10 +562,10 @@ function isInternetUrl(input) {
 async function downloadImageFromUrl(url) {
     try {
         const response = await request(url, {
+            dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
             method: "GET",
             headersTimeout: 10000, // 10 second timeout for headers
-            bodyTimeout: 30000, // 30 second timeout for body
-            maxRedirections: 5,
+            bodyTimeout: 30000, // 30 second timeout for body,
         });
         if (response.statusCode !== 200) {
             throw new Error(`HTTP ${response.statusCode}: Failed to download image from ${url}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.53.5",
+  "version": "8.0.0",
   "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 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",
@@ -21,8 +21,8 @@
     "url": "https://github.com/sponsors/juspay"
   },
   "engines": {
-    "node": ">=18.0.0",
-    "npm": ">=8.0.0",
+    "node": ">=20.18.1",
+    "npm": ">=10.0.0",
     "pnpm": ">=8.0.0"
   },
   "scripts": {
@@ -192,7 +192,7 @@
     "p-limit": "^6.2.0",
     "reconnecting-eventsource": "^1.6.4",
     "redis": "^5.8.2",
-    "undici": "^6.21.3",
+    "undici": "^7.5.0",
     "uuid": "^11.1.0",
     "ws": "^8.18.3",
     "yargs": "^17.7.2",
@@ -240,7 +240,7 @@
     "svelte-check": "^4.0.0",
     "tslib": "^2.4.1",
     "typescript": "^5.0.0",
-    "vite": "^6.3.6",
+    "vite": "^6.4.1",
     "vitest": "^2.0.0",
     "why-is-node-running": "^3.2.2"
   },