@juspay/neurolink 6.1.0 → 6.2.1

package/dist/neurolink.js

@@ -14,18 +14,15 @@ catch (error) {
     // Environment variables should be set externally in production
 }
 import { AIProviderFactory } from "./core/factory.js";
-import { ContextManager } from "./mcp/context-manager.js";
-import { mcpLogger } from "./mcp/logging.js";
+import { mcpLogger } from "./utils/logger.js";
 import { toolRegistry } from "./mcp/tool-registry.js";
-import { unifiedRegistry } from "./mcp/unified-registry.js";
 import { logger } from "./utils/logger.js";
-import { getBestProvider } from "./utils/providerUtils-fixed.js";
+import { getBestProvider } from "./utils/providerUtils.js";
 import { ProviderRegistry } from "./factories/provider-registry.js";
 import { validateTool, createMCPServerFromTools, } from "./sdk/tool-registration.js";
 // Core types imported from core/types.js
 export class NeuroLink {
     mcpInitialized = false;
-    contextManager;
     // Tool registration support
     customTools = new Map();
     inMemoryServers = new Map();
@@ -34,7 +31,6 @@ export class NeuroLink {
         ProviderRegistry.setOptions({
             enableManualMCP: false,
         });
-        this.contextManager = new ContextManager();
     }
     /**
      * Initialize MCP registry with enhanced error handling and resource cleanup
@@ -223,12 +219,7 @@ export class NeuroLink {
             if (!this.mcpInitialized) {
                 return null; // Skip MCP if not available
             }
-            // Create execution context
-            const context = this.contextManager.createContext({
-                sessionId: `neurolink-${Date.now()}`,
-                userId: "neurolink-user",
-                aiProvider: options.provider || "auto",
-            });
+            // Context creation removed - was never used
             // Determine provider
             const providerName = options.provider === "auto" || !options.provider
                 ? await getBestProvider()
@@ -402,12 +393,7 @@ export class NeuroLink {
         }
         // Initialize MCP if needed
         await this.initializeMCP();
-        // Create execution context for tool operations
-        const context = this.contextManager.createContext({
-            sessionId: `neurolink-stream-${Date.now()}`,
-            userId: "neurolink-user",
-            aiProvider: options.provider || "auto",
-        });
+        // Context creation removed - was never used
         // Determine provider to use
         const providerName = options.provider === "auto" || !options.provider
             ? await getBestProvider()
@@ -416,7 +402,6 @@ export class NeuroLink {
             mcpLogger.debug(`[${functionTag}] Starting MCP-enabled streaming`, {
                 provider: providerName,
                 prompt: (options.input.text?.substring(0, 100) || "No text") + "...",
-                contextId: context.sessionId,
             });
             // Create provider using the same factory pattern as generate
             const provider = await AIProviderFactory.createBestProvider(providerName, options.model, true, this);
@@ -632,19 +617,14 @@ export class NeuroLink {
             }
             // If not found in custom tools or in-memory servers, try unified registry
             try {
-                // Ensure built-in tools are initialized
-                const { initializeNeuroLinkMCP, isNeuroLinkMCPInitialized } = await import("./mcp/initialize.js");
-                if (!isNeuroLinkMCPInitialized()) {
-                    mcpLogger.debug(`[${functionTag}] Initializing built-in MCP servers`);
-                    await initializeNeuroLinkMCP();
-                }
+                // Built-in tools initialization simplified
+                mcpLogger.debug(`[${functionTag}] MCP initialization simplified`);
                 // Create minimal execution context for external tools
-                const context = this.contextManager.createContext({
+                const context = {
                     sessionId: `neurolink-tool-${Date.now()}`,
                     userId: "neurolink-user",
-                    aiProvider: "auto",
-                });
-                const result = (await unifiedRegistry.executeTool(toolName, params, context));
+                };
+                const result = (await toolRegistry.executeTool(toolName, params, context));
                 return result;
             }
             catch (error) {
@@ -669,8 +649,9 @@ export class NeuroLink {
      * @returns Array of available tools with metadata
      */
     async getAllAvailableTools() {
-        const { getAllAvailableTools } = await import("./mcp/initialize-tools.js");
-        return getAllAvailableTools(this.inMemoryServers);
+        // Simplified tool listing - removed initialize-tools dependency
+        const tools = await toolRegistry.listTools();
+        return tools;
     }
     // ============================================================================
     // PROVIDER DIAGNOSTICS - SDK-First Architecture
@@ -857,25 +838,16 @@ export class NeuroLink {
      * @returns Promise resolving to MCP status details
      */
     async getMCPStatus() {
-        const { unifiedRegistry } = await import("./mcp/unified-registry.js");
         try {
-            const totalServers = unifiedRegistry.getTotalServerCount();
-            const availableServers = unifiedRegistry.getAvailableServerCount();
-            const autoDiscoveredServers = unifiedRegistry.getAutoDiscoveredServers();
-            const allTools = await unifiedRegistry.listAllTools();
+            // Simplified MCP status - unified registry removed
+            const allTools = await toolRegistry.listTools();
             return {
                 mcpInitialized: this.mcpInitialized,
-                totalServers,
-                availableServers,
-                autoDiscoveredCount: autoDiscoveredServers.length,
+                totalServers: 1, // Only tool registry now
+                availableServers: 1,
+                autoDiscoveredCount: 0, // No auto-discovery
                 totalTools: allTools.length,
-                autoDiscoveredServers: autoDiscoveredServers.map((server) => ({
-                    id: server.metadata.name,
-                    name: server.metadata.name,
-                    source: server.source,
-                    status: "discovered",
-                    hasServer: true,
-                })),
+                autoDiscoveredServers: [], // No auto-discovery
                 customToolsCount: this.customTools.size,
                 inMemoryServersCount: this.inMemoryServers.size,
             };
@@ -899,24 +871,8 @@ export class NeuroLink {
      * @returns Promise resolving to array of MCP server information
      */
     async listMCPServers() {
-        const { unifiedRegistry } = await import("./mcp/unified-registry.js");
-        try {
-            const servers = unifiedRegistry.getAutoDiscoveredServers();
-            return servers.map((server) => ({
-                id: server.metadata.name,
-                name: server.metadata.name,
-                source: server.source,
-                status: unifiedRegistry.isConnected(server.metadata.name)
-                    ? "connected"
-                    : "discovered",
-                hasServer: true,
-                metadata: server.metadata,
-            }));
-        }
-        catch (error) {
-            logger.warn("Failed to list MCP servers", { error });
-            return [];
-        }
+        // Simplified MCP servers listing - unified registry removed
+        return [];
     }
     /**
      * Test connectivity to a specific MCP server
@@ -924,13 +880,8 @@ export class NeuroLink {
      * @returns Promise resolving to true if server is reachable
      */
     async testMCPServer(serverId) {
-        const { unifiedRegistry } = await import("./mcp/unified-registry.js");
-        try {
-            return unifiedRegistry.isConnected(serverId);
-        }
-        catch {
-            return false;
-        }
+        // Simplified MCP server testing - unified registry removed
+        return false; // No auto-discovery servers available
     }
 }
 // Create default instance

package/dist/providers/amazon-bedrock.js

@@ -4,32 +4,21 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
+import { validateApiKey, createAWSAccessKeyConfig, createAWSSecretConfig, getAWSRegion, getAWSSessionToken, } from "../utils/providerConfig.js";
 // Configuration helpers
 const getBedrockModelId = () => {
     return (process.env.BEDROCK_MODEL ||
         process.env.BEDROCK_MODEL_ID ||
         "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0");
 };
+// Configuration helpers - now using consolidated utility
 const getAWSAccessKeyId = () => {
-    const accessKeyId = process.env.AWS_ACCESS_KEY_ID;
-    if (!accessKeyId) {
-        throw new Error(`❌ AWS Bedrock Provider Configuration Error\n\nMissing required environment variables: AWS_ACCESS_KEY_ID\n\n🔧 Step 1: Get AWS Credentials\n1. Visit: https://console.aws.amazon.com/iam/\n2. Create IAM user with Bedrock permissions\n3. Generate access key\n\n🔧 Step 2: Set Environment Variables\nAdd to your .env file:\nAWS_ACCESS_KEY_ID=your_access_key_here\nAWS_SECRET_ACCESS_KEY=your_secret_key_here\nAWS_REGION=us-east-1\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return accessKeyId;
+    return validateApiKey(createAWSAccessKeyConfig());
 };
 const getAWSSecretAccessKey = () => {
-    const secretAccessKey = process.env.AWS_SECRET_ACCESS_KEY;
-    if (!secretAccessKey) {
-        throw new Error(`❌ AWS Bedrock Provider Configuration Error\n\nMissing required environment variables: AWS_SECRET_ACCESS_KEY\n\n🔧 Step 1: Get AWS Credentials\n1. Visit: https://console.aws.amazon.com/iam/\n2. Create IAM user with Bedrock permissions\n3. Generate access key\n\n🔧 Step 2: Set Environment Variables\nAdd to your .env file:\nAWS_ACCESS_KEY_ID=your_access_key_here\nAWS_SECRET_ACCESS_KEY=your_secret_key_here\nAWS_REGION=us-east-1\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return secretAccessKey;
-};
-const getAWSRegion = () => {
-    return process.env.AWS_REGION || "us-east-1";
-};
-const getAWSSessionToken = () => {
-    return process.env.AWS_SESSION_TOKEN;
+    return validateApiKey(createAWSSecretConfig());
 };
+// Note: getAWSRegion and getAWSSessionToken are now directly imported from consolidated utility
 const getAppEnvironment = () => {
     return process.env.PUBLIC_APP_ENVIRONMENT || "production";
 };

package/dist/providers/anthropic-baseprovider.js

@@ -4,6 +4,7 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
+import { validateApiKey, createAnthropicBaseConfig, } from "../utils/providerConfig.js";
 /**
  * Anthropic provider implementation using BaseProvider pattern
  * Migrated from direct API calls to Vercel AI SDK (@ai-sdk/anthropic)
@@ -50,28 +51,9 @@ export class AnthropicProviderV2 extends BaseProvider {
         }
         return new Error(`Anthropic error: ${errorWithStatus?.message || String(error) || "Unknown error"}`);
     }
+    // Configuration helper - now using consolidated utility
     getApiKey() {
-        const apiKey = process.env.ANTHROPIC_API_KEY;
-        if (!apiKey) {
-            throw new Error(`❌ ANTHROPIC Provider Configuration Error
-
-Missing required environment variables: ANTHROPIC_API_KEY
-
-🔧 Step 1: Get Credentials
-Get your API key from https://console.anthropic.com/
-
-💡 Step 2: Add to your .env file (or export in CLI):
-ANTHROPIC_API_KEY="sk-ant-your-anthropic-api-key"
-# Optional:
-ANTHROPIC_MODEL="claude-3-5-sonnet-20241022"
-ANTHROPIC_BASE_URL="https://api.anthropic.com"
-
-🚀 Step 3: Test the setup:
-npx neurolink generate "Hello" --provider anthropic
-
-📖 More info: https://docs.neurolink.dev/providers/anthropic`);
-        }
-        return apiKey;
+        return validateApiKey(createAnthropicBaseConfig());
     }
     // executeGenerate removed - BaseProvider handles all generation with tools
     async executeStream(options, analysisSchema) {

package/dist/providers/anthropic.js

@@ -4,16 +4,13 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
-// Configuration helpers
+import { validateApiKey, createAnthropicConfig, getProviderModel, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getAnthropicApiKey = () => {
-    const apiKey = process.env.ANTHROPIC_API_KEY;
-    if (!apiKey) {
-        throw new Error(`❌ Anthropic Provider Configuration Error\n\nMissing required environment variable: ANTHROPIC_API_KEY\n\n🔧 Step 1: Get Anthropic API Key\n1. Visit: https://console.anthropic.com/\n2. Sign in or create an account\n3. Go to API Keys section\n4. Create a new API key\n\n🔧 Step 2: Set Environment Variable\nAdd to your .env file:\nANTHROPIC_API_KEY=your_api_key_here\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return apiKey;
+    return validateApiKey(createAnthropicConfig());
 };
 const getDefaultAnthropicModel = () => {
-    return process.env.ANTHROPIC_MODEL || "claude-3-5-sonnet-20241022";
+    return getProviderModel("ANTHROPIC_MODEL", "claude-3-5-sonnet-20241022");
 };
 /**
  * Anthropic Provider v2 - BaseProvider Implementation

package/dist/providers/azure-openai.js

@@ -1,6 +1,8 @@
 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;
@@ -21,11 +23,12 @@ export class AzureOpenAIProvider extends BaseProvider {
                 process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
                 "gpt-4o";
         this.apiVersion = process.env.AZURE_API_VERSION || "2024-10-01-preview";
+        // Configuration validation - now using consolidated utility
         if (!this.apiKey) {
-            throw new Error("AZURE_OPENAI_API_KEY environment variable is required");
+            validateApiKey(createAzureAPIKeyConfig());
         }
         if (!this.resourceName) {
-            throw new Error("AZURE_OPENAI_ENDPOINT environment variable is required");
+            validateApiKey(createAzureEndpointConfig());
         }
         // Create the Azure provider instance
         this.azureProvider = createAzure({
@@ -33,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/providers/google-vertex.js

@@ -4,6 +4,7 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
+import { validateApiKey, createVertexProjectConfig, createGoogleAuthConfig, } from "../utils/providerConfig.js";
 // Cache for anthropic module to avoid repeated imports
 let _createVertexAnthropic = null;
 let _anthropicImportAttempted = false;
@@ -28,14 +29,9 @@ async function getCreateVertexAnthropic() {
     }
 }
 // Configuration helpers
+// Configuration helpers - now using consolidated utility
 const getVertexProjectId = () => {
-    const projectId = process.env.GOOGLE_CLOUD_PROJECT_ID ||
-        process.env.VERTEX_PROJECT_ID ||
-        process.env.GOOGLE_VERTEX_PROJECT;
-    if (!projectId) {
-        throw new Error(`❌ Google Vertex AI Provider Configuration Error\n\nMissing required environment variables: GOOGLE_CLOUD_PROJECT_ID or VERTEX_PROJECT_ID\n\n🔧 Step 1: Get Google Cloud Credentials\n1. Visit: https://console.cloud.google.com/\n2. Create or select a project\n3. Enable Vertex AI API\n4. Set up authentication\n\n🔧 Step 2: Set Environment Variables\nAdd to your .env file:\nGOOGLE_CLOUD_PROJECT_ID=your_project_id_here\nGOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return projectId;
+    return validateApiKey(createVertexProjectConfig());
 };
 const getVertexLocation = () => {
     return (process.env.GOOGLE_CLOUD_LOCATION ||
@@ -72,9 +68,9 @@ export class GoogleVertexProvider extends BaseProvider {
     cachedAnthropicModel = null;
     constructor(modelName, sdk) {
         super(modelName, "vertex", sdk);
-        // Validate Google Cloud credentials
+        // Validate Google Cloud credentials - now using consolidated utility
         if (!hasGoogleCredentials()) {
-            throw new Error(`❌ Google Vertex AI Provider Configuration Error\n\nMissing Google Cloud authentication. One of the following is required:\n\n🔧 Option 1: Service Account Key File\nGOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\n\n🔧 Option 2: Service Account Key (Base64)\nGOOGLE_SERVICE_ACCOUNT_KEY=base64_encoded_key\n\n🔧 Option 3: Individual Credentials\nGOOGLE_AUTH_CLIENT_EMAIL=your-service-account@project.iam.gserviceaccount.com\nGOOGLE_AUTH_PRIVATE_KEY=-----BEGIN PRIVATE KEY-----...\n\n🔧 Step 4: Restart Application\nRestart your application to load the new environment variables.`);
+            validateApiKey(createGoogleAuthConfig());
         }
         // Initialize Google Cloud configuration
         this.projectId = getVertexProjectId();

package/dist/providers/huggingFace.js

@@ -4,20 +4,15 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
-// Configuration helpers
+import { validateApiKey, createHuggingFaceConfig, getProviderModel, hasHuggingFaceCredentials, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getHuggingFaceApiKey = () => {
-    const apiKey = process.env.HUGGINGFACE_API_KEY || process.env.HF_TOKEN;
-    if (!apiKey) {
-        throw new Error(`❌ HuggingFace Provider Configuration Error\n\nMissing required environment variables: HUGGINGFACE_API_KEY\n\n🔧 Step 1: Get Credentials\n1. Visit: https://huggingface.co/settings/tokens\n2. Create new API token\n3. Copy the token\n\n🔧 Step 2: Set Environment Variable\nAdd to your .env file:\nHUGGINGFACE_API_KEY=your_token_here\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return apiKey;
+    return validateApiKey(createHuggingFaceConfig());
 };
 const getDefaultHuggingFaceModel = () => {
-    return process.env.HUGGINGFACE_MODEL || "microsoft/DialoGPT-medium";
-};
-const hasHuggingFaceCredentials = () => {
-    return !!(process.env.HUGGINGFACE_API_KEY || process.env.HF_TOKEN);
+    return getProviderModel("HUGGINGFACE_MODEL", "microsoft/DialoGPT-medium");
 };
+// Note: hasHuggingFaceCredentials now directly imported from consolidated utility
 /**
  * HuggingFace Provider - BaseProvider Implementation
  * Using AI SDK with HuggingFace's OpenAI-compatible endpoint

package/dist/providers/mistral.js

@@ -2,17 +2,14 @@ import { createMistral } from "@ai-sdk/mistral";
 import { streamText } from "ai";
 import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
-import { createAnalytics } from "./analytics-helper.js";
-// Configuration helpers
+import { createAnalytics } from "../core/analytics.js";
+import { validateApiKey, createMistralConfig, getProviderModel, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getMistralApiKey = () => {
-    const apiKey = process.env.MISTRAL_API_KEY;
-    if (!apiKey) {
-        throw new Error("Mistral API key not found. Please set MISTRAL_API_KEY environment variable.");
-    }
-    return apiKey;
+    return validateApiKey(createMistralConfig());
 };
 const getDefaultMistralModel = () => {
-    return process.env.MISTRAL_MODEL || "mistral-large-latest";
+    return getProviderModel("MISTRAL_MODEL", "mistral-large-latest");
 };
 /**
  * Mistral AI Provider v2 - BaseProvider Implementation

package/dist/providers/openAI.js

@@ -5,16 +5,13 @@ import { BaseProvider } from "../core/base-provider.js";
 import { logger } from "../utils/logger.js";
 import { createTimeoutController, TimeoutError, getDefaultTimeout, } from "../utils/timeout.js";
 import { DEFAULT_MAX_TOKENS } from "../core/constants.js";
-// Configuration helpers
+import { validateApiKey, createOpenAIConfig, getProviderModel, } from "../utils/providerConfig.js";
+// Configuration helpers - now using consolidated utility
 const getOpenAIApiKey = () => {
-    const apiKey = process.env.OPENAI_API_KEY;
-    if (!apiKey) {
-        throw new Error(`❌ OPENAI Provider Configuration Error\n\nMissing required environment variables: OPENAI_API_KEY\n\n🔧 Step 1: Get Credentials\n1. Visit: https://platform.openai.com/api-keys\n2. Create new API key\n3. Copy the key\n\n🔧 Step 2: Set Environment Variable\nAdd to your .env file:\nOPENAI_API_KEY=your_api_key_here\n\n🔧 Step 3: Restart Application\nRestart your application to load the new environment variables.`);
-    }
-    return apiKey;
+    return validateApiKey(createOpenAIConfig());
 };
 const getOpenAIModel = () => {
-    return process.env.OPENAI_MODEL || "gpt-4o";
+    return getProviderModel("OPENAI_MODEL", "gpt-4o");
 };
 /**
  * OpenAI Provider v2 - BaseProvider Implementation

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 };