@juspay/neurolink 6.2.0 → 6.2.1

package/dist/mcp/index.js

@@ -4,7 +4,7 @@
  * Implementation based on research blueprint
  */
 // Core functionality exports
-export { mcpLogger } from "./logging.js";
+export { mcpLogger } from "../utils/logger.js";
 /**
  * Initialize the MCP ecosystem - simplified
  */

package/dist/mcp/registry.js

@@ -1,7 +1,7 @@
 /**
  * MCP Registry - Industry Standard Interface with camelCase
  */
-import { registryLogger } from "./logging.js";
+import { registryLogger } from "../utils/logger.js";
 /**
  * Simple MCP registry for plugin management
  * Maintains backward compatibility with existing code

package/dist/mcp/servers/ai-providers/ai-analysis-tools.js

@@ -6,6 +6,7 @@
 import { z } from "zod";
 import { AIProviderFactory } from "../../../core/factory.js";
 import { getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
+import { logger } from "../../../utils/logger.js";
 /**
  * Input Schemas for AI Analysis Tools
  */
@@ -89,7 +90,7 @@ const analyzeAIUsageTool = {
         const typedParams = params;
         const startTime = Date.now();
         try {
-            console.log(`[AI-Analysis] Starting real AI-powered usage analysis for timeRange: ${typedParams.timeRange}`);
+            logger.debug(`[AI-Analysis] Starting real AI-powered usage analysis for timeRange: ${typedParams.timeRange}`);
             const providerName = await getBestProvider();
             const provider = await AIProviderFactory.createProvider(providerName);
             if (!provider) {

package/dist/mcp/tool-registry.js

@@ -3,7 +3,7 @@
  * Updated to match industry standard camelCase interfaces
  */
 import { MCPRegistry } from "./registry.js";
-import { registryLogger } from "./logging.js";
+import { registryLogger } from "../utils/logger.js";
 import { randomUUID } from "crypto";
 export class MCPToolRegistry extends MCPRegistry {
     tools = new Map();

package/dist/neurolink.js

@@ -14,7 +14,7 @@ catch (error) {
     // Environment variables should be set externally in production
 }
 import { AIProviderFactory } from "./core/factory.js";
-import { mcpLogger } from "./mcp/logging.js";
+import { mcpLogger } from "./utils/logger.js";
 import { toolRegistry } from "./mcp/tool-registry.js";
 import { logger } from "./utils/logger.js";
 import { getBestProvider } from "./utils/providerUtils.js";

package/dist/providers/azure-openai.js

@@ -2,6 +2,7 @@ import { createAzure } from "@ai-sdk/azure";
 import { streamText } from "ai";
 import { BaseProvider } from "../core/base-provider.js";
 import { validateApiKey, createAzureAPIKeyConfig, createAzureEndpointConfig, } from "../utils/providerConfig.js";
+import { logger } from "../utils/logger.js";
 export class AzureOpenAIProvider extends BaseProvider {
     apiKey;
     resourceName;
@@ -35,7 +36,7 @@ export class AzureOpenAIProvider extends BaseProvider {
             apiKey: this.apiKey,
             apiVersion: this.apiVersion,
         });
-        console.log("Azure Vercel Provider initialized", {
+        logger.debug("Azure Vercel Provider initialized", {
             deployment: this.deployment,
             resourceName: this.resourceName,
             provider: "azure-vercel",

package/dist/telemetry/index.js

@@ -1,5 +1,6 @@
 // Optional Telemetry Infrastructure (Phase 2)
 export { TelemetryService } from "./telemetry-service.js";
+import { logger } from "../utils/logger.js";
 /**
  * Initialize telemetry for NeuroLink
  * OPTIONAL - Only works when NEUROLINK_TELEMETRY_ENABLED=true
@@ -9,7 +10,7 @@ export async function initializeTelemetry() {
     const telemetry = TelemetryService.getInstance();
     if (telemetry.isEnabled()) {
         await telemetry.initialize();
-        console.log("[NeuroLink] Telemetry initialized");
+        logger.info("[NeuroLink] Telemetry initialized");
     }
     return telemetry;
 }

package/dist/utils/logger.d.ts

@@ -1,12 +1,72 @@
 /**
- * NeuroLink Logger Utility
+ * NeuroLink Unified Logger Utility
  *
- * Provides conditional logging based on NEUROLINK_DEBUG environment variable
+ * Centralized logging for the entire NeuroLink ecosystem
+ * Supports both CLI --debug flag and NEUROLINK_DEBUG environment variable
+ * Migrated from MCP logging with enhanced features
  */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    data?: unknown;
+}
+declare class NeuroLinkLogger {
+    private logLevel;
+    private logs;
+    private maxLogs;
+    private isDebugMode;
+    constructor();
+    setLogLevel(level: LogLevel): void;
+    shouldLog(level: LogLevel): boolean;
+    private getLogPrefix;
+    /**
+     * Outputs a log entry to the console based on the log level.
+     *
+     * @param level - The log level (debug, info, warn, error).
+     * @param prefix - The formatted log prefix.
+     * @param message - The log message.
+     * @param data - Optional additional data to log.
+     */
+    private outputToConsole;
+    private log;
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    getLogs(level?: LogLevel): LogEntry[];
+    clearLogs(): void;
+    /**
+     * Logs messages unconditionally using `console.log`.
+     *
+     * This method is part of a legacy simple logger interface for backward compatibility.
+     * It bypasses the structured logging mechanism and should only be used when
+     * unstructured, unconditional logging is required.
+     *
+     * @param args - The arguments to log. These are passed directly to `console.log`.
+     */
+    always(...args: unknown[]): void;
+}
 export declare const logger: {
     debug: (...args: unknown[]) => void;
     info: (...args: unknown[]) => void;
     warn: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
     always: (...args: unknown[]) => void;
+    setLogLevel: (level: LogLevel) => void;
+    getLogs: (level?: LogLevel) => LogEntry[];
+    clearLogs: () => void;
 };
+export declare const mcpLogger: NeuroLinkLogger;
+export declare const autoDiscoveryLogger: NeuroLinkLogger;
+export declare const registryLogger: NeuroLinkLogger;
+export declare const unifiedRegistryLogger: NeuroLinkLogger;
+export declare function setGlobalMCPLogLevel(level: LogLevel): void;
+export declare const LogLevels: {
+    readonly debug: "debug";
+    readonly info: "info";
+    readonly warn: "warn";
+    readonly error: "error";
+};
+export type { LogEntry };

package/dist/utils/logger.js

@@ -1,25 +1,190 @@
 /**
- * NeuroLink Logger Utility
+ * NeuroLink Unified Logger Utility
  *
- * Provides conditional logging based on NEUROLINK_DEBUG environment variable
+ * Centralized logging for the entire NeuroLink ecosystem
+ * Supports both CLI --debug flag and NEUROLINK_DEBUG environment variable
+ * Migrated from MCP logging with enhanced features
  */
+// Pre-computed uppercase log levels for performance optimization
+const UPPERCASE_LOG_LEVELS = {
+    debug: "DEBUG",
+    info: "INFO",
+    warn: "WARN",
+    error: "ERROR",
+};
+class NeuroLinkLogger {
+    logLevel = "info";
+    logs = [];
+    maxLogs = 1000;
+    isDebugMode;
+    constructor() {
+        // Cache debug mode check to avoid repeated array searches
+        this.isDebugMode =
+            process.argv.includes("--debug") ||
+                process.env.NEUROLINK_DEBUG === "true";
+        // Check NEUROLINK_LOG_LEVEL for consistency with the unified NeuroLink logger
+        let envLevel = process.env.NEUROLINK_LOG_LEVEL?.toLowerCase();
+        // Fallback to MCP_LOG_LEVEL for backward compatibility (if needed)
+        if (!envLevel) {
+            envLevel = process.env.MCP_LOG_LEVEL?.toLowerCase();
+        }
+        if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
+            this.logLevel = envLevel;
+        }
+    }
+    setLogLevel(level) {
+        this.logLevel = level;
+    }
+    shouldLog(level) {
+        // Hide all logs except errors unless debugging
+        if (!this.isDebugMode && level !== "error") {
+            return false;
+        }
+        const levels = ["debug", "info", "warn", "error"];
+        return levels.indexOf(level) >= levels.indexOf(this.logLevel);
+    }
+    getLogPrefix(timestamp, level) {
+        return `[${timestamp}] [NEUROLINK:${UPPERCASE_LOG_LEVELS[level]}]`;
+    }
+    /**
+     * Outputs a log entry to the console based on the log level.
+     *
+     * @param level - The log level (debug, info, warn, error).
+     * @param prefix - The formatted log prefix.
+     * @param message - The log message.
+     * @param data - Optional additional data to log.
+     */
+    outputToConsole(level, prefix, message, data) {
+        const logMethod = {
+            debug: console.debug,
+            info: console.info,
+            warn: console.warn,
+            error: console.error,
+        }[level];
+        if (data !== undefined && data !== null) {
+            logMethod(prefix, message, data);
+        }
+        else {
+            logMethod(prefix, message);
+        }
+    }
+    log(level, message, data) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            level,
+            message,
+            timestamp: new Date(),
+            data,
+        };
+        // Store log entry
+        this.logs.push(entry);
+        // Trim old logs
+        if (this.logs.length > this.maxLogs) {
+            this.logs = this.logs.slice(-this.maxLogs);
+        }
+        // Console output
+        const timestamp = entry.timestamp.toISOString();
+        const prefix = this.getLogPrefix(timestamp, level);
+        this.outputToConsole(level, prefix, message, data);
+    }
+    debug(message, data) {
+        this.log("debug", message, data);
+    }
+    info(message, data) {
+        this.log("info", message, data);
+    }
+    warn(message, data) {
+        this.log("warn", message, data);
+    }
+    error(message, data) {
+        this.log("error", message, data);
+    }
+    getLogs(level) {
+        if (level) {
+            return this.logs.filter((log) => log.level === level);
+        }
+        return [...this.logs];
+    }
+    clearLogs() {
+        this.logs = [];
+    }
+    /**
+     * Logs messages unconditionally using `console.log`.
+     *
+     * This method is part of a legacy simple logger interface for backward compatibility.
+     * It bypasses the structured logging mechanism and should only be used when
+     * unstructured, unconditional logging is required.
+     *
+     * @param args - The arguments to log. These are passed directly to `console.log`.
+     */
+    always(...args) {
+        console.log(...args);
+    }
+}
+// Export singleton instance
+const neuroLinkLogger = new NeuroLinkLogger();
+// Helper function to process arguments with minimal overhead
+function processLoggerArgs(args, logMethod) {
+    if (args.length === 0) {
+        return;
+    }
+    // Serialize the first argument robustly to handle complex objects
+    const message = (() => {
+        try {
+            return typeof args[0] === "string" ? args[0] : JSON.stringify(args[0]);
+        }
+        catch {
+            return "[Unserializable Object]";
+        }
+    })();
+    const data = args.length === 2 ? args[1] : args.length > 2 ? args.slice(1) : undefined;
+    logMethod(message, data);
+}
+// Main unified logger export
 export const logger = {
     debug: (...args) => {
-        if (process.env.NEUROLINK_DEBUG === "true") {
-            console.log(...args);
+        if (neuroLinkLogger.shouldLog("debug")) {
+            processLoggerArgs(args, (message, data) => neuroLinkLogger.debug(message, data));
         }
     },
     info: (...args) => {
-        // Completely disabled for clean CLI demo output
+        if (neuroLinkLogger.shouldLog("info")) {
+            processLoggerArgs(args, (message, data) => neuroLinkLogger.info(message, data));
+        }
     },
     warn: (...args) => {
-        // Completely disabled for clean CLI demo output
+        if (neuroLinkLogger.shouldLog("warn")) {
+            processLoggerArgs(args, (message, data) => neuroLinkLogger.warn(message, data));
+        }
     },
     error: (...args) => {
-        // Always show errors regardless of debug mode
-        console.error(...args);
+        if (neuroLinkLogger.shouldLog("error")) {
+            processLoggerArgs(args, (message, data) => neuroLinkLogger.error(message, data));
+        }
     },
     always: (...args) => {
-        console.log(...args);
+        neuroLinkLogger.always(...args);
     },
+    // Expose structured logging methods
+    setLogLevel: (level) => neuroLinkLogger.setLogLevel(level),
+    getLogs: (level) => neuroLinkLogger.getLogs(level),
+    clearLogs: () => neuroLinkLogger.clearLogs(),
+};
+// MCP compatibility exports - all use the same unified logger
+export const mcpLogger = neuroLinkLogger;
+export const autoDiscoveryLogger = neuroLinkLogger;
+export const registryLogger = neuroLinkLogger;
+export const unifiedRegistryLogger = neuroLinkLogger;
+// Global log level setter
+export function setGlobalMCPLogLevel(level) {
+    neuroLinkLogger.setLogLevel(level);
+}
+// Export LogLevel enum for runtime use
+export const LogLevels = {
+    debug: "debug",
+    info: "info",
+    warn: "warn",
+    error: "error",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "6.2.0",
+  "version": "6.2.1",
   "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",

package/dist/lib/mcp/logging.d.ts

@@ -1,38 +0,0 @@
-/**
- * MCP Logging Utility
- * Centralized logging for the MCP ecosystem
- */
-export type LogLevel = "debug" | "info" | "warn" | "error";
-interface LogEntry {
-    level: LogLevel;
-    message: string;
-    timestamp: Date;
-    data?: unknown;
-}
-declare class MCPLogger {
-    private logLevel;
-    private logs;
-    private maxLogs;
-    constructor();
-    setLogLevel(level: LogLevel): void;
-    private shouldLog;
-    private log;
-    debug(message: string, data?: unknown): void;
-    info(message: string, data?: unknown): void;
-    warn(message: string, data?: unknown): void;
-    error(message: string, data?: unknown): void;
-    getLogs(level?: LogLevel): LogEntry[];
-    clearLogs(): void;
-}
-export declare const mcpLogger: MCPLogger;
-export declare const autoDiscoveryLogger: MCPLogger;
-export declare const registryLogger: MCPLogger;
-export declare const unifiedRegistryLogger: MCPLogger;
-export declare function setGlobalMCPLogLevel(level: LogLevel): void;
-export declare const LogLevels: {
-    readonly debug: "debug";
-    readonly info: "info";
-    readonly warn: "warn";
-    readonly error: "error";
-};
-export {};

package/dist/lib/mcp/logging.js

@@ -1,100 +0,0 @@
-/**
- * MCP Logging Utility
- * Centralized logging for the MCP ecosystem
- */
-class MCPLogger {
-    logLevel = "info";
-    logs = [];
-    maxLogs = 1000;
-    constructor() {
-        // Set log level from environment
-        const envLevel = process.env.MCP_LOG_LEVEL?.toLowerCase();
-        if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
-            this.logLevel = envLevel;
-        }
-    }
-    setLogLevel(level) {
-        this.logLevel = level;
-    }
-    shouldLog(level) {
-        // CRITICAL: Respect CLI debug flag - hide all logs except errors unless debugging
-        const isDebugMode = process.argv.includes("--debug");
-        if (!isDebugMode && level !== "error") {
-            return false;
-        }
-        const levels = ["debug", "info", "warn", "error"];
-        return levels.indexOf(level) >= levels.indexOf(this.logLevel);
-    }
-    log(level, message, data) {
-        if (!this.shouldLog(level)) {
-            return;
-        }
-        const entry = {
-            level,
-            message,
-            timestamp: new Date(),
-            data,
-        };
-        // Store log entry
-        this.logs.push(entry);
-        // Trim old logs
-        if (this.logs.length > this.maxLogs) {
-            this.logs = this.logs.slice(-this.maxLogs);
-        }
-        // Console output
-        const timestamp = entry.timestamp.toISOString();
-        const prefix = `[${timestamp}] [MCP:${level.toUpperCase()}]`;
-        switch (level) {
-            case "debug":
-                console.debug(prefix, message, data ? data : "");
-                break;
-            case "info":
-                console.info(prefix, message, data ? data : "");
-                break;
-            case "warn":
-                console.warn(prefix, message, data ? data : "");
-                break;
-            case "error":
-                console.error(prefix, message, data ? data : "");
-                break;
-        }
-    }
-    debug(message, data) {
-        this.log("debug", message, data);
-    }
-    info(message, data) {
-        this.log("info", message, data);
-    }
-    warn(message, data) {
-        this.log("warn", message, data);
-    }
-    error(message, data) {
-        this.log("error", message, data);
-    }
-    getLogs(level) {
-        if (level) {
-            return this.logs.filter((log) => log.level === level);
-        }
-        return [...this.logs];
-    }
-    clearLogs() {
-        this.logs = [];
-    }
-}
-// Export singleton instance
-export const mcpLogger = new MCPLogger();
-// Additional logger instances for different modules
-export const autoDiscoveryLogger = mcpLogger;
-export const registryLogger = mcpLogger;
-export const unifiedRegistryLogger = mcpLogger;
-// Global log level setter
-export function setGlobalMCPLogLevel(level) {
-    mcpLogger.setLogLevel(level);
-}
-// Export LogLevel enum for runtime use
-export const LogLevels = {
-    debug: "debug",
-    info: "info",
-    warn: "warn",
-    error: "error",
-};

package/dist/mcp/logging.d.ts

@@ -1,38 +0,0 @@
-/**
- * MCP Logging Utility
- * Centralized logging for the MCP ecosystem
- */
-export type LogLevel = "debug" | "info" | "warn" | "error";
-interface LogEntry {
-    level: LogLevel;
-    message: string;
-    timestamp: Date;
-    data?: unknown;
-}
-declare class MCPLogger {
-    private logLevel;
-    private logs;
-    private maxLogs;
-    constructor();
-    setLogLevel(level: LogLevel): void;
-    private shouldLog;
-    private log;
-    debug(message: string, data?: unknown): void;
-    info(message: string, data?: unknown): void;
-    warn(message: string, data?: unknown): void;
-    error(message: string, data?: unknown): void;
-    getLogs(level?: LogLevel): LogEntry[];
-    clearLogs(): void;
-}
-export declare const mcpLogger: MCPLogger;
-export declare const autoDiscoveryLogger: MCPLogger;
-export declare const registryLogger: MCPLogger;
-export declare const unifiedRegistryLogger: MCPLogger;
-export declare function setGlobalMCPLogLevel(level: LogLevel): void;
-export declare const LogLevels: {
-    readonly debug: "debug";
-    readonly info: "info";
-    readonly warn: "warn";
-    readonly error: "error";
-};
-export {};

package/dist/mcp/logging.js

@@ -1,100 +0,0 @@
-/**
- * MCP Logging Utility
- * Centralized logging for the MCP ecosystem
- */
-class MCPLogger {
-    logLevel = "info";
-    logs = [];
-    maxLogs = 1000;
-    constructor() {
-        // Set log level from environment
-        const envLevel = process.env.MCP_LOG_LEVEL?.toLowerCase();
-        if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
-            this.logLevel = envLevel;
-        }
-    }
-    setLogLevel(level) {
-        this.logLevel = level;
-    }
-    shouldLog(level) {
-        // CRITICAL: Respect CLI debug flag - hide all logs except errors unless debugging
-        const isDebugMode = process.argv.includes("--debug");
-        if (!isDebugMode && level !== "error") {
-            return false;
-        }
-        const levels = ["debug", "info", "warn", "error"];
-        return levels.indexOf(level) >= levels.indexOf(this.logLevel);
-    }
-    log(level, message, data) {
-        if (!this.shouldLog(level)) {
-            return;
-        }
-        const entry = {
-            level,
-            message,
-            timestamp: new Date(),
-            data,
-        };
-        // Store log entry
-        this.logs.push(entry);
-        // Trim old logs
-        if (this.logs.length > this.maxLogs) {
-            this.logs = this.logs.slice(-this.maxLogs);
-        }
-        // Console output
-        const timestamp = entry.timestamp.toISOString();
-        const prefix = `[${timestamp}] [MCP:${level.toUpperCase()}]`;
-        switch (level) {
-            case "debug":
-                console.debug(prefix, message, data ? data : "");
-                break;
-            case "info":
-                console.info(prefix, message, data ? data : "");
-                break;
-            case "warn":
-                console.warn(prefix, message, data ? data : "");
-                break;
-            case "error":
-                console.error(prefix, message, data ? data : "");
-                break;
-        }
-    }
-    debug(message, data) {
-        this.log("debug", message, data);
-    }
-    info(message, data) {
-        this.log("info", message, data);
-    }
-    warn(message, data) {
-        this.log("warn", message, data);
-    }
-    error(message, data) {
-        this.log("error", message, data);
-    }
-    getLogs(level) {
-        if (level) {
-            return this.logs.filter((log) => log.level === level);
-        }
-        return [...this.logs];
-    }
-    clearLogs() {
-        this.logs = [];
-    }
-}
-// Export singleton instance
-export const mcpLogger = new MCPLogger();
-// Additional logger instances for different modules
-export const autoDiscoveryLogger = mcpLogger;
-export const registryLogger = mcpLogger;
-export const unifiedRegistryLogger = mcpLogger;
-// Global log level setter
-export function setGlobalMCPLogLevel(level) {
-    mcpLogger.setLogLevel(level);
-}
-// Export LogLevel enum for runtime use
-export const LogLevels = {
-    debug: "debug",
-    info: "info",
-    warn: "warn",
-    error: "error",
-};