@juspay/neurolink 1.9.0 → 1.10.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.10.0](https://github.com/juspay/neurolink/compare/v1.9.0...v1.10.0) (2025-06-21)
+
+
+### Features
+
+* **cli:** improve provider status accuracy and error handling ([523e845](https://github.com/juspay/neurolink/commit/523e84566fee5d9afa3638186f90c628e20e4894))
+
 # 1.9.0 (2025-06-20)
 
 

package/README.md

@@ -201,7 +201,7 @@ cd neurolink-demo && node server.js
 ### 🖥️ CLI Demonstrations
 
 - **[CLI Help & Commands](./docs/visual-content/cli-videos/cli-01-cli-help.mp4)** - Complete command reference
-- **[Provider Status Check](./docs/visual-content/cli-videos/cli-02-provider-status.mp4)** - Connectivity verification
+- **[Provider Status Check](./docs/visual-content/cli-videos/cli-02-provider-status.mp4)** - Connectivity verification (now with authentication and model availability checks)
 - **[Text Generation](./docs/visual-content/cli-videos/cli-03-text-generation.mp4)** - Real AI content creation
 
 ### 🌐 Web Interface Videos

package/dist/cli/index.js

@@ -595,22 +595,102 @@ const cli = yargs(args)
             "ollama",
             "mistral",
         ];
+        // Import hasProviderEnvVars to check environment variables
+        const { hasProviderEnvVars } = await import("../lib/utils/providerUtils.js");
         const results = [];
         for (const p of providers) {
             if (spinner) {
                 spinner.text = `Testing ${p}...`;
             }
+            // First check if provider has env vars configured
+            const hasEnvVars = hasProviderEnvVars(p);
+            if (!hasEnvVars && p !== "ollama") {
+                // No env vars, don't even try to test
+                results.push({
+                    provider: p,
+                    status: "not-configured",
+                    configured: false,
+                    error: "Missing required environment variables",
+                });
+                if (spinner) {
+                    spinner.fail(`${p}: ${chalk.gray("⚪ Not configured")} - Missing environment variables`);
+                }
+                else if (!argv.quiet) {
+                    console.log(`${p}: ${chalk.gray("⚪ Not configured")} - Missing environment variables`);
+                }
+                continue;
+            }
+            // Special handling for Ollama
+            if (p === "ollama") {
+                try {
+                    // First, check if the service is running
+                    const serviceResponse = await fetch('http://localhost:11434/api/tags', {
+                        method: 'GET',
+                        signal: AbortSignal.timeout(2000)
+                    });
+                    if (!serviceResponse.ok) {
+                        throw new Error("Ollama service not responding");
+                    }
+                    // Service is running, now check if the default model is available
+                    const { models } = await serviceResponse.json();
+                    const defaultOllamaModel = "llama3.2:latest";
+                    const modelIsAvailable = models.some((m) => m.name === defaultOllamaModel);
+                    if (modelIsAvailable) {
+                        results.push({
+                            provider: p,
+                            status: "working",
+                            configured: true,
+                            authenticated: true,
+                            responseTime: 0,
+                        });
+                        if (spinner) {
+                            spinner.succeed(`${p}: ${chalk.green("✅ Working")} - Service running and model '${defaultOllamaModel}' is available.`);
+                        }
+                    }
+                    else {
+                        results.push({
+                            provider: p,
+                            status: "failed",
+                            configured: true,
+                            authenticated: false,
+                            error: `Ollama service is running, but model '${defaultOllamaModel}' is not found. Please run 'ollama pull ${defaultOllamaModel}'.`,
+                        });
+                        if (spinner) {
+                            spinner.fail(`${p}: ${chalk.red("❌ Model Not Found")} - Run 'ollama pull ${defaultOllamaModel}'`);
+                        }
+                    }
+                }
+                catch (error) {
+                    results.push({
+                        provider: p,
+                        status: "failed",
+                        configured: false,
+                        authenticated: false,
+                        error: "Ollama is not running. Please start with: ollama serve",
+                    });
+                    if (spinner) {
+                        spinner.fail(`${p}: ${chalk.red("❌ Failed")} - Service not running`);
+                    }
+                }
+                continue;
+            }
+            // Provider has env vars, now test authentication
             try {
                 const start = Date.now();
-                await sdk.generateText({
+                // Import AIProviderFactory to test providers directly without fallback
+                const { AIProviderFactory } = await import("../lib/core/factory.js");
+                // Create and test provider directly to avoid automatic fallback
+                const provider = await AIProviderFactory.createProvider(p);
+                await provider.generateText({
                     prompt: "test",
-                    provider: p,
                     maxTokens: 1,
                 });
                 const duration = Date.now() - start;
                 results.push({
                     provider: p,
                     status: "working",
+                    configured: true,
+                    authenticated: true,
                     responseTime: duration,
                 });
                 if (spinner) {
@@ -621,25 +701,41 @@ const cli = yargs(args)
                 }
             }
             catch (error) {
+                const errorMsg = error.message;
+                let authStatus = false;
+                let statusText = "Failed";
+                // Check if it's an authentication error
+                if (errorMsg.includes('401') || errorMsg.includes('Unauthorized') ||
+                    errorMsg.includes('Invalid API') || errorMsg.includes('Authentication') ||
+                    errorMsg.includes('API key') || errorMsg.includes('not authorized') ||
+                    errorMsg.includes('ExpiredToken') || errorMsg.includes('expired')) {
+                    statusText = "Invalid credentials";
+                }
+                else if (errorMsg.includes('fetch') || errorMsg.includes('blob')) {
+                    statusText = "Service error";
+                }
                 results.push({
                     provider: p,
                     status: "failed",
-                    error: error.message,
+                    configured: true,
+                    authenticated: authStatus,
+                    error: errorMsg,
                 });
                 if (spinner) {
-                    spinner.fail(`${p}: ${chalk.red("❌ Failed")} - ${error.message.split("\n")[0]}`);
+                    spinner.fail(`${p}: ${chalk.red("❌ " + statusText)} - ${errorMsg.split("\n")[0]}`);
                 }
                 else if (!argv.quiet) {
-                    console.error(`${p}: ${chalk.red("❌ Failed")} - ${error.message.split("\n")[0]}`);
+                    console.error(`${p}: ${chalk.red("❌ " + statusText)} - ${errorMsg.split("\n")[0]}`);
                 }
             }
         }
         const working = results.filter((r) => r.status === "working").length;
+        const configured = results.filter((r) => r.configured).length;
         if (spinner) {
-            spinner.info(chalk.blue(`\n📊 Summary: ${working}/${results.length} providers working`));
+            spinner.info(chalk.blue(`\n📊 Summary: ${working}/${results.length} providers working, ${configured}/${results.length} configured`));
         }
         else if (!argv.quiet) {
-            console.log(chalk.blue(`\n📊 Summary: ${working}/${results.length} providers working`));
+            console.log(chalk.blue(`\n📊 Summary: ${working}/${results.length} providers working, ${configured}/${results.length} configured`));
         }
         if (argv.verbose && !argv.quiet) {
             console.log(chalk.blue("\n📋 Detailed Results:"));

package/dist/core/factory.js

@@ -1,5 +1,5 @@
 import { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, GoogleAIStudio, HuggingFace, Ollama, MistralAI, } from "../providers/index.js";
-import { getBestProvider } from "../utils/providerUtils.js";
+import { getBestProviderSync } from "../utils/providerUtils.js";
 import { logger } from "../utils/logger.js";
 import { dynamicModelProvider } from "./dynamic-models.js";
 const componentIdentifier = "aiProviderFactory";
@@ -233,7 +233,7 @@ export class AIProviderFactory {
     static async createBestProvider(requestedProvider, modelName, enableMCP = true) {
         const functionTag = "AIProviderFactory.createBestProvider";
         try {
-            const bestProvider = getBestProvider(requestedProvider);
+            const bestProvider = getBestProviderSync(requestedProvider);
             logger.debug(`[${functionTag}] Best provider selected`, {
                 requestedProvider: requestedProvider || "auto",
                 selectedProvider: bestProvider,

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, }
 export { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, } from "./providers/index.js";
 export type { ProviderName } from "./providers/index.js";
 export { PROVIDERS, AVAILABLE_PROVIDERS } from "./providers/index.js";
-export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
+export { getBestProviderSync as getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 export { NeuroLink } from "./neurolink.js";
 export type { TextGenerationOptions, StreamTextOptions, TextGenerationResult, } from "./neurolink.js";
 export declare const VERSION = "1.0.0";

package/dist/index.js

@@ -15,7 +15,7 @@ export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, }
 export { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, } from "./providers/index.js";
 export { PROVIDERS, AVAILABLE_PROVIDERS } from "./providers/index.js";
 // Utility exports
-export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
+export { getBestProviderSync as getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 // Main NeuroLink wrapper class
 export { NeuroLink } from "./neurolink.js";
 // Version

package/dist/lib/core/factory.js

@@ -1,5 +1,5 @@
 import { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, GoogleAIStudio, HuggingFace, Ollama, MistralAI, } from "../providers/index.js";
-import { getBestProvider } from "../utils/providerUtils.js";
+import { getBestProviderSync } from "../utils/providerUtils.js";
 import { logger } from "../utils/logger.js";
 import { dynamicModelProvider } from "./dynamic-models.js";
 const componentIdentifier = "aiProviderFactory";
@@ -233,7 +233,7 @@ export class AIProviderFactory {
     static async createBestProvider(requestedProvider, modelName, enableMCP = true) {
         const functionTag = "AIProviderFactory.createBestProvider";
         try {
-            const bestProvider = getBestProvider(requestedProvider);
+            const bestProvider = getBestProviderSync(requestedProvider);
             logger.debug(`[${functionTag}] Best provider selected`, {
                 requestedProvider: requestedProvider || "auto",
                 selectedProvider: bestProvider,

package/dist/lib/index.d.ts

@@ -13,7 +13,7 @@ export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, }
 export { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, } from "./providers/index.js";
 export type { ProviderName } from "./providers/index.js";
 export { PROVIDERS, AVAILABLE_PROVIDERS } from "./providers/index.js";
-export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
+export { getBestProviderSync as getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 export { NeuroLink } from "./neurolink.js";
 export type { TextGenerationOptions, StreamTextOptions, TextGenerationResult, } from "./neurolink.js";
 export declare const VERSION = "1.0.0";

package/dist/lib/index.js

@@ -15,7 +15,7 @@ export { BedrockModels, OpenAIModels, VertexModels, DEFAULT_PROVIDER_CONFIGS, }
 export { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, } from "./providers/index.js";
 export { PROVIDERS, AVAILABLE_PROVIDERS } from "./providers/index.js";
 // Utility exports
-export { getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
+export { getBestProviderSync as getBestProvider, getAvailableProviders, isValidProvider, } from "./utils/providerUtils.js";
 // Main NeuroLink wrapper class
 export { NeuroLink } from "./neurolink.js";
 // Version

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

@@ -149,8 +149,16 @@ export declare class MCPToolRegistry {
     private updateExecutionMetrics;
 }
 /**
- * Default registry instance
- * Can be used across the application for consistent tool management
+ * Get the default singleton instance of the MCPToolRegistry.
+ * This function ensures that the registry is only instantiated once.
+ * Using a function getter helps prevent circular dependency issues during module initialization.
+ *
+ * @returns The singleton MCPToolRegistry instance.
+ */
+export declare function getDefaultToolRegistry(): MCPToolRegistry;
+/**
+ * @deprecated The direct export `defaultToolRegistry` is deprecated and will be removed.
+ * Please use `getDefaultToolRegistry()` instead to avoid circular dependency issues.
  */
 export declare const defaultToolRegistry: MCPToolRegistry;
 /**

package/dist/lib/mcp/registry.js

@@ -350,14 +350,32 @@ export class MCPToolRegistry {
  * Default registry instance
  * Can be used across the application for consistent tool management
  */
-export const defaultToolRegistry = new MCPToolRegistry();
+let defaultRegistryInstance = null;
+/**
+ * Get the default singleton instance of the MCPToolRegistry.
+ * This function ensures that the registry is only instantiated once.
+ * Using a function getter helps prevent circular dependency issues during module initialization.
+ *
+ * @returns The singleton MCPToolRegistry instance.
+ */
+export function getDefaultToolRegistry() {
+    if (!defaultRegistryInstance) {
+        defaultRegistryInstance = new MCPToolRegistry();
+    }
+    return defaultRegistryInstance;
+}
+/**
+ * @deprecated The direct export `defaultToolRegistry` is deprecated and will be removed.
+ * Please use `getDefaultToolRegistry()` instead to avoid circular dependency issues.
+ */
+export const defaultToolRegistry = getDefaultToolRegistry();
 /**
  * Utility function to register server with default registry
  *
  * @param server MCP server to register
  */
 export async function registerServer(server) {
-    return defaultToolRegistry.registerServer(server);
+    return getDefaultToolRegistry().registerServer(server);
 }
 /**
  * Utility function to execute tool with default registry
@@ -369,7 +387,7 @@ export async function registerServer(server) {
  * @returns Tool execution result
  */
 export async function executeTool(toolName, params, context, options) {
-    return defaultToolRegistry.executeTool(toolName, params, context, options);
+    return getDefaultToolRegistry().executeTool(toolName, params, context, options);
 }
 /**
  * Utility function to list tools with default registry
@@ -378,5 +396,5 @@ export async function executeTool(toolName, params, context, options) {
  * @returns Array of tool information
  */
 export function listTools(criteria) {
-    return defaultToolRegistry.listTools(criteria);
+    return getDefaultToolRegistry().listTools(criteria);
 }

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

@@ -5,7 +5,7 @@
  */
 import { z } from "zod";
 import { AIProviderFactory } from "../../../core/factory.js";
-import { getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
+import { getBestProviderSync as getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
 /**
  * Input Schemas for AI Analysis Tools
  */

package/dist/lib/mcp/servers/ai-providers/ai-core-server.js

@@ -6,7 +6,7 @@
 import { z } from "zod";
 import { createMCPServer } from "../../factory.js";
 import { AIProviderFactory } from "../../../core/factory.js";
-import { getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
+import { getBestProviderSync as getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
 import { logger } from "../../../utils/logger.js";
 import { analyzeAIUsageTool, benchmarkProviderPerformanceTool, optimizePromptParametersTool, } from "./ai-analysis-tools.js";
 import { generateTestCasesTool, refactorCodeTool, generateDocumentationTool, debugAIOutputTool, } from "./ai-workflow-tools.js";

package/dist/lib/mcp/servers/ai-providers/ai-workflow-tools.js

@@ -4,7 +4,7 @@
  */
 import { z } from "zod";
 import { AIProviderFactory } from "../../../core/factory.js";
-import { getBestProvider } from "../../../utils/providerUtils.js";
+import { getBestProviderSync as getBestProvider } from "../../../utils/providerUtils.js";
 // Tool-specific schemas with comprehensive validation
 const generateTestCasesSchema = z.object({
     codeFunction: z

package/dist/lib/neurolink.js

@@ -8,10 +8,10 @@
 import { AIProviderFactory } from "./index.js";
 import { ContextManager } from "./mcp/context-manager.js";
 import { mcpLogger } from "./mcp/logging.js";
-import { defaultToolRegistry } from "./mcp/registry.js";
+import { getDefaultToolRegistry } from "./mcp/registry.js";
 import { defaultUnifiedRegistry } from "./mcp/unified-registry.js";
 import { logger } from "./utils/logger.js";
-import { getBestProvider } from "./utils/providerUtils.js";
+import { getBestProvider } from "./utils/providerUtils-fixed.js";
 export class NeuroLink {
     mcpInitialized = false;
     contextManager;
@@ -108,8 +108,8 @@ export class NeuroLink {
             // Get available tools from default registry (simplified approach)
             let availableTools = [];
             try {
-                // Use defaultToolRegistry directly instead of unified registry to avoid hanging
-                const allTools = defaultToolRegistry.listTools();
+                // Use getDefaultToolRegistry() to avoid circular dependencies
+                const allTools = getDefaultToolRegistry().listTools();
                 availableTools = allTools.map((tool) => ({
                     name: tool.name,
                     description: tool.description || "No description available",

package/dist/lib/providers/ollama.js

@@ -119,6 +119,12 @@ class OllamaLanguageModel {
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
+                if (response.status === 404) {
+                    const errorData = await response.json();
+                    if (errorData.error && errorData.error.includes("not found")) {
+                        throw new Error(`Model '${this.modelId}' not found. Please run 'ollama pull ${this.modelId}'`);
+                    }
+                }
                 throw new Error(`Ollama API error: ${response.status} ${response.statusText}`);
             }
             const data = (await response.json());
@@ -183,6 +189,12 @@ class OllamaLanguageModel {
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
+                if (response.status === 404) {
+                    const errorData = await response.json();
+                    if (errorData.error && errorData.error.includes("not found")) {
+                        throw new Error(`Model '${this.modelId}' not found. Please run 'ollama pull ${this.modelId}'`);
+                    }
+                }
                 throw new Error(`Ollama API error: ${response.status} ${response.statusText}`);
             }
             if (!response.body) {
@@ -400,6 +412,9 @@ export class Ollama {
                 });
             }
             const result = await generateText(generateOptions);
+            if (result.text.includes("model not found")) {
+                throw new Error(`Model '${this.modelName}' not found. Please run 'ollama pull ${this.modelName}'`);
+            }
             logger.debug(`[${functionTag}] Generate text completed`, {
                 provider,
                 modelName: this.modelName,

package/dist/lib/utils/providerUtils-fixed.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Asynchronously get the best available provider based on real-time checks.
+ * This function performs actual authentication and availability tests.
+ *
+ * @param requestedProvider - Optional preferred provider name
+ * @returns The best provider name to use
+ */
+export declare function getBestProvider(requestedProvider?: string): Promise<string>;

package/dist/lib/utils/providerUtils-fixed.js

@@ -0,0 +1,75 @@
+import { AIProviderFactory } from '../core/factory.js';
+import { logger } from './logger.js';
+import { hasProviderEnvVars } from './providerUtils.js';
+/**
+ * Asynchronously get the best available provider based on real-time checks.
+ * This function performs actual authentication and availability tests.
+ *
+ * @param requestedProvider - Optional preferred provider name
+ * @returns The best provider name to use
+ */
+export async function getBestProvider(requestedProvider) {
+    const providers = [
+        "google-ai",
+        "anthropic",
+        "openai",
+        "mistral",
+        "vertex",
+        "azure",
+        "huggingface",
+        "bedrock",
+        "ollama",
+    ];
+    if (requestedProvider && requestedProvider !== 'auto') {
+        if (await isProviderAvailable(requestedProvider)) {
+            logger.debug(`[getBestProvider] Using requested provider: ${requestedProvider}`);
+            return requestedProvider;
+        }
+        else {
+            logger.warn(`[getBestProvider] Requested provider '${requestedProvider}' is not available. Falling back to auto-selection.`);
+        }
+    }
+    for (const provider of providers) {
+        if (await isProviderAvailable(provider)) {
+            logger.debug(`[getBestProvider] Selected provider: ${provider}`);
+            return provider;
+        }
+    }
+    throw new Error("No available AI providers. Please check your configurations.");
+}
+/**
+ * Check if a provider is truly available by performing a quick authentication test.
+ *
+ * @param providerName - The name of the provider to check.
+ * @returns True if the provider is available and authenticated.
+ */
+async function isProviderAvailable(providerName) {
+    if (!hasProviderEnvVars(providerName) && providerName !== 'ollama') {
+        return false;
+    }
+    if (providerName === 'ollama') {
+        try {
+            const response = await fetch('http://localhost:11434/api/tags', {
+                method: 'GET',
+                signal: AbortSignal.timeout(2000)
+            });
+            if (response.ok) {
+                const { models } = await response.json();
+                const defaultOllamaModel = "llama3.2:latest";
+                return models.some((m) => m.name === defaultOllamaModel);
+            }
+            return false;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    try {
+        const provider = await AIProviderFactory.createProvider(providerName);
+        await provider.generateText({ prompt: "test", maxTokens: 1 });
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}

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

@@ -3,7 +3,14 @@
  * @param requestedProvider - Optional preferred provider name
  * @returns The best provider name to use
  */
-export declare function getBestProvider(requestedProvider?: string): string;
+export declare function getBestProviderSync(requestedProvider?: string): string;
+/**
+ * Check if a provider has the minimum required environment variables
+ * NOTE: This only checks if variables exist, not if they're valid
+ * @param provider - Provider name to check
+ * @returns True if the provider has required environment variables
+ */
+export declare function hasProviderEnvVars(provider: string): boolean;
 /**
  * Get available provider names
  * @returns Array of available provider names

package/dist/lib/utils/providerUtils.js

@@ -7,7 +7,7 @@ import { logger } from "./logger.js";
  * @param requestedProvider - Optional preferred provider name
  * @returns The best provider name to use
  */
-export function getBestProvider(requestedProvider) {
+export function getBestProviderSync(requestedProvider) {
     // If a specific provider is requested, return it
     if (requestedProvider) {
         return requestedProvider;
@@ -42,6 +42,15 @@ export function getBestProvider(requestedProvider) {
  * @returns True if the provider appears to be configured
  */
 function isProviderConfigured(provider) {
+    return hasProviderEnvVars(provider);
+}
+/**
+ * Check if a provider has the minimum required environment variables
+ * NOTE: This only checks if variables exist, not if they're valid
+ * @param provider - Provider name to check
+ * @returns True if the provider has required environment variables
+ */
+export function hasProviderEnvVars(provider) {
     switch (provider.toLowerCase()) {
         case "bedrock":
         case "amazon":

package/dist/mcp/registry.d.ts

@@ -149,8 +149,16 @@ export declare class MCPToolRegistry {
     private updateExecutionMetrics;
 }
 /**
- * Default registry instance
- * Can be used across the application for consistent tool management
+ * Get the default singleton instance of the MCPToolRegistry.
+ * This function ensures that the registry is only instantiated once.
+ * Using a function getter helps prevent circular dependency issues during module initialization.
+ *
+ * @returns The singleton MCPToolRegistry instance.
+ */
+export declare function getDefaultToolRegistry(): MCPToolRegistry;
+/**
+ * @deprecated The direct export `defaultToolRegistry` is deprecated and will be removed.
+ * Please use `getDefaultToolRegistry()` instead to avoid circular dependency issues.
  */
 export declare const defaultToolRegistry: MCPToolRegistry;
 /**

package/dist/mcp/registry.js

@@ -350,14 +350,32 @@ export class MCPToolRegistry {
  * Default registry instance
  * Can be used across the application for consistent tool management
  */
-export const defaultToolRegistry = new MCPToolRegistry();
+let defaultRegistryInstance = null;
+/**
+ * Get the default singleton instance of the MCPToolRegistry.
+ * This function ensures that the registry is only instantiated once.
+ * Using a function getter helps prevent circular dependency issues during module initialization.
+ *
+ * @returns The singleton MCPToolRegistry instance.
+ */
+export function getDefaultToolRegistry() {
+    if (!defaultRegistryInstance) {
+        defaultRegistryInstance = new MCPToolRegistry();
+    }
+    return defaultRegistryInstance;
+}
+/**
+ * @deprecated The direct export `defaultToolRegistry` is deprecated and will be removed.
+ * Please use `getDefaultToolRegistry()` instead to avoid circular dependency issues.
+ */
+export const defaultToolRegistry = getDefaultToolRegistry();
 /**
  * Utility function to register server with default registry
  *
  * @param server MCP server to register
  */
 export async function registerServer(server) {
-    return defaultToolRegistry.registerServer(server);
+    return getDefaultToolRegistry().registerServer(server);
 }
 /**
  * Utility function to execute tool with default registry
@@ -369,7 +387,7 @@ export async function registerServer(server) {
  * @returns Tool execution result
  */
 export async function executeTool(toolName, params, context, options) {
-    return defaultToolRegistry.executeTool(toolName, params, context, options);
+    return getDefaultToolRegistry().executeTool(toolName, params, context, options);
 }
 /**
  * Utility function to list tools with default registry
@@ -378,5 +396,5 @@ export async function executeTool(toolName, params, context, options) {
  * @returns Array of tool information
  */
 export function listTools(criteria) {
-    return defaultToolRegistry.listTools(criteria);
+    return getDefaultToolRegistry().listTools(criteria);
 }

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

@@ -5,7 +5,7 @@
  */
 import { z } from "zod";
 import { AIProviderFactory } from "../../../core/factory.js";
-import { getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
+import { getBestProviderSync as getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
 /**
  * Input Schemas for AI Analysis Tools
  */

package/dist/mcp/servers/ai-providers/ai-core-server.js

@@ -6,7 +6,7 @@
 import { z } from "zod";
 import { createMCPServer } from "../../factory.js";
 import { AIProviderFactory } from "../../../core/factory.js";
-import { getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
+import { getBestProviderSync as getBestProvider, getAvailableProviders, } from "../../../utils/providerUtils.js";
 import { logger } from "../../../utils/logger.js";
 import { analyzeAIUsageTool, benchmarkProviderPerformanceTool, optimizePromptParametersTool, } from "./ai-analysis-tools.js";
 import { generateTestCasesTool, refactorCodeTool, generateDocumentationTool, debugAIOutputTool, } from "./ai-workflow-tools.js";

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

@@ -4,7 +4,7 @@
  */
 import { z } from "zod";
 import { AIProviderFactory } from "../../../core/factory.js";
-import { getBestProvider } from "../../../utils/providerUtils.js";
+import { getBestProviderSync as getBestProvider } from "../../../utils/providerUtils.js";
 // Tool-specific schemas with comprehensive validation
 const generateTestCasesSchema = z.object({
     codeFunction: z

package/dist/neurolink.js

@@ -8,10 +8,10 @@
 import { AIProviderFactory } from "./index.js";
 import { ContextManager } from "./mcp/context-manager.js";
 import { mcpLogger } from "./mcp/logging.js";
-import { defaultToolRegistry } from "./mcp/registry.js";
+import { getDefaultToolRegistry } from "./mcp/registry.js";
 import { defaultUnifiedRegistry } from "./mcp/unified-registry.js";
 import { logger } from "./utils/logger.js";
-import { getBestProvider } from "./utils/providerUtils.js";
+import { getBestProvider } from "./utils/providerUtils-fixed.js";
 export class NeuroLink {
     mcpInitialized = false;
     contextManager;
@@ -108,8 +108,8 @@ export class NeuroLink {
             // Get available tools from default registry (simplified approach)
             let availableTools = [];
             try {
-                // Use defaultToolRegistry directly instead of unified registry to avoid hanging
-                const allTools = defaultToolRegistry.listTools();
+                // Use getDefaultToolRegistry() to avoid circular dependencies
+                const allTools = getDefaultToolRegistry().listTools();
                 availableTools = allTools.map((tool) => ({
                     name: tool.name,
                     description: tool.description || "No description available",

package/dist/providers/ollama.js

@@ -119,6 +119,12 @@ class OllamaLanguageModel {
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
+                if (response.status === 404) {
+                    const errorData = await response.json();
+                    if (errorData.error && errorData.error.includes("not found")) {
+                        throw new Error(`Model '${this.modelId}' not found. Please run 'ollama pull ${this.modelId}'`);
+                    }
+                }
                 throw new Error(`Ollama API error: ${response.status} ${response.statusText}`);
             }
             const data = (await response.json());
@@ -183,6 +189,12 @@ class OllamaLanguageModel {
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
+                if (response.status === 404) {
+                    const errorData = await response.json();
+                    if (errorData.error && errorData.error.includes("not found")) {
+                        throw new Error(`Model '${this.modelId}' not found. Please run 'ollama pull ${this.modelId}'`);
+                    }
+                }
                 throw new Error(`Ollama API error: ${response.status} ${response.statusText}`);
             }
             if (!response.body) {
@@ -400,6 +412,9 @@ export class Ollama {
                 });
             }
             const result = await generateText(generateOptions);
+            if (result.text.includes("model not found")) {
+                throw new Error(`Model '${this.modelName}' not found. Please run 'ollama pull ${this.modelName}'`);
+            }
             logger.debug(`[${functionTag}] Generate text completed`, {
                 provider,
                 modelName: this.modelName,

package/dist/utils/providerUtils-fixed.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Asynchronously get the best available provider based on real-time checks.
+ * This function performs actual authentication and availability tests.
+ *
+ * @param requestedProvider - Optional preferred provider name
+ * @returns The best provider name to use
+ */
+export declare function getBestProvider(requestedProvider?: string): Promise<string>;

package/dist/utils/providerUtils-fixed.js

@@ -0,0 +1,75 @@
+import { AIProviderFactory } from '../core/factory.js';
+import { logger } from './logger.js';
+import { hasProviderEnvVars } from './providerUtils.js';
+/**
+ * Asynchronously get the best available provider based on real-time checks.
+ * This function performs actual authentication and availability tests.
+ *
+ * @param requestedProvider - Optional preferred provider name
+ * @returns The best provider name to use
+ */
+export async function getBestProvider(requestedProvider) {
+    const providers = [
+        "google-ai",
+        "anthropic",
+        "openai",
+        "mistral",
+        "vertex",
+        "azure",
+        "huggingface",
+        "bedrock",
+        "ollama",
+    ];
+    if (requestedProvider && requestedProvider !== 'auto') {
+        if (await isProviderAvailable(requestedProvider)) {
+            logger.debug(`[getBestProvider] Using requested provider: ${requestedProvider}`);
+            return requestedProvider;
+        }
+        else {
+            logger.warn(`[getBestProvider] Requested provider '${requestedProvider}' is not available. Falling back to auto-selection.`);
+        }
+    }
+    for (const provider of providers) {
+        if (await isProviderAvailable(provider)) {
+            logger.debug(`[getBestProvider] Selected provider: ${provider}`);
+            return provider;
+        }
+    }
+    throw new Error("No available AI providers. Please check your configurations.");
+}
+/**
+ * Check if a provider is truly available by performing a quick authentication test.
+ *
+ * @param providerName - The name of the provider to check.
+ * @returns True if the provider is available and authenticated.
+ */
+async function isProviderAvailable(providerName) {
+    if (!hasProviderEnvVars(providerName) && providerName !== 'ollama') {
+        return false;
+    }
+    if (providerName === 'ollama') {
+        try {
+            const response = await fetch('http://localhost:11434/api/tags', {
+                method: 'GET',
+                signal: AbortSignal.timeout(2000)
+            });
+            if (response.ok) {
+                const { models } = await response.json();
+                const defaultOllamaModel = "llama3.2:latest";
+                return models.some((m) => m.name === defaultOllamaModel);
+            }
+            return false;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    try {
+        const provider = await AIProviderFactory.createProvider(providerName);
+        await provider.generateText({ prompt: "test", maxTokens: 1 });
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}

package/dist/utils/providerUtils.d.ts

@@ -3,7 +3,14 @@
  * @param requestedProvider - Optional preferred provider name
  * @returns The best provider name to use
  */
-export declare function getBestProvider(requestedProvider?: string): string;
+export declare function getBestProviderSync(requestedProvider?: string): string;
+/**
+ * Check if a provider has the minimum required environment variables
+ * NOTE: This only checks if variables exist, not if they're valid
+ * @param provider - Provider name to check
+ * @returns True if the provider has required environment variables
+ */
+export declare function hasProviderEnvVars(provider: string): boolean;
 /**
  * Get available provider names
  * @returns Array of available provider names

package/dist/utils/providerUtils.js

@@ -7,7 +7,7 @@ import { logger } from "./logger.js";
  * @param requestedProvider - Optional preferred provider name
  * @returns The best provider name to use
  */
-export function getBestProvider(requestedProvider) {
+export function getBestProviderSync(requestedProvider) {
     // If a specific provider is requested, return it
     if (requestedProvider) {
         return requestedProvider;
@@ -42,6 +42,15 @@ export function getBestProvider(requestedProvider) {
  * @returns True if the provider appears to be configured
  */
 function isProviderConfigured(provider) {
+    return hasProviderEnvVars(provider);
+}
+/**
+ * Check if a provider has the minimum required environment variables
+ * NOTE: This only checks if variables exist, not if they're valid
+ * @param provider - Provider name to check
+ * @returns True if the provider has required environment variables
+ */
+export function hasProviderEnvVars(provider) {
     switch (provider.toLowerCase()) {
         case "bedrock":
         case "amazon":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "1.9.0",
+  "version": "1.10.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",
@@ -25,6 +25,25 @@
     "npm": ">=8.0.0",
     "pnpm": ">=8.0.0"
   },
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build && pnpm run prepack",
+    "build:cli": "echo 'Building CLI...' && tsc --project tsconfig.cli.json",
+    "cli": "node dist/cli/index.js",
+    "preview": "vite preview",
+    "prepare": "svelte-kit sync || echo ''",
+    "prepack": "svelte-kit sync && svelte-package && pnpm run build:cli && publint",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:dynamic-models": "node test-dynamic-models.js",
+    "model-server": "node scripts/model-server.js",
+    "lint": "prettier --check . && eslint .",
+    "format": "prettier --write .",
+    "changeset": "changeset",
+    "changeset:version": "changeset version && git add --all"
+  },
   "files": [
     "dist",
     "!dist/**/*.test.*",
@@ -151,26 +170,15 @@
     "ai-development",
     "llm-integration"
   ],
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "puppeteer"
+    ]
+  },
   "os": [
     "darwin",
     "linux",
     "win32"
-  ],
-  "scripts": {
-    "dev": "vite dev",
-    "build": "vite build && pnpm run prepack",
-    "build:cli": "echo 'Building CLI...' && tsc --project tsconfig.cli.json",
-    "cli": "node dist/cli/index.js",
-    "preview": "vite preview",
-    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "test:dynamic-models": "node test-dynamic-models.js",
-    "model-server": "node scripts/model-server.js",
-    "lint": "prettier --check . && eslint .",
-    "format": "prettier --write .",
-    "changeset": "changeset",
-    "changeset:version": "changeset version && git add --all"
-  }
-}
+  ]
+}