@juspay/neurolink 7.0.0 → 7.1.0

package/dist/core/factory.js

@@ -89,6 +89,8 @@ export class AIProviderFactory {
             //     );
             //   }
             // }
+            // CRITICAL FIX: Initialize providers before using them
+            await ProviderRegistry.registerAllProviders();
             // PURE FACTORY PATTERN: No switch statements - use ProviderFactory exclusively
             const normalizedName = this.normalizeProviderName(providerName);
             const finalModelName = resolvedModelName === "default" || resolvedModelName === null

package/dist/factories/providerRegistry.js

@@ -48,7 +48,9 @@ export class ProviderRegistry {
             ProviderFactory.registerProvider(AIProviderName.AZURE, async (modelName) => {
                 const { AzureOpenAIProvider } = await import("../providers/azureOpenai.js");
                 return new AzureOpenAIProvider(modelName);
-            }, "gpt-4o-mini", ["azure", "azureOpenai"]);
+            }, process.env.AZURE_MODEL ||
+                process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
+                "gpt-4o-mini", ["azure", "azureOpenai"]);
             // Register Google Vertex AI provider
             ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");

package/dist/lib/core/factory.js

@@ -1,6 +1,7 @@
 // ✅ CIRCULAR DEPENDENCY FIX: Remove barrel export import
 // Providers are now managed via ProviderFactory instead of direct imports
 import { ProviderFactory } from "../factories/providerFactory.js";
+import { ProviderRegistry } from "../factories/providerRegistry.js";
 import { getBestProvider } from "../utils/providerUtils.js";
 import { logger } from "../utils/logger.js";
 const componentIdentifier = "aiProviderFactory";
@@ -87,6 +88,8 @@ export class AIProviderFactory {
             //     );
             //   }
             // }
+            // CRITICAL FIX: Initialize providers before using them
+            await ProviderRegistry.registerAllProviders();
             // PURE FACTORY PATTERN: No switch statements - use ProviderFactory exclusively
             const normalizedName = this.normalizeProviderName(providerName);
             const finalModelName = resolvedModelName === "default" || resolvedModelName === null

package/dist/lib/factories/providerRegistry.js

@@ -48,7 +48,9 @@ export class ProviderRegistry {
             ProviderFactory.registerProvider(AIProviderName.AZURE, async (modelName) => {
                 const { AzureOpenAIProvider } = await import("../providers/azureOpenai.js");
                 return new AzureOpenAIProvider(modelName);
-            }, "gpt-4o-mini", ["azure", "azureOpenai"]);
+            }, process.env.AZURE_MODEL ||
+                process.env.AZURE_OPENAI_DEPLOYMENT_ID ||
+                "gpt-4o-mini", ["azure", "azureOpenai"]);
             // Register Google Vertex AI provider
             ProviderFactory.registerProvider(AIProviderName.VERTEX, async (modelName) => {
                 const { GoogleVertexProvider } = await import("../providers/googleVertex.js");

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

@@ -39,6 +39,11 @@ export declare class MCPToolRegistry extends MCPRegistry {
     private tools;
     private toolImpls;
     private toolExecutionStats;
+    constructor();
+    /**
+     * Register all direct tools from directAgentTools
+     */
+    private registerDirectTools;
     /**
      * Register a server with its tools (updated signature)
      */

package/dist/lib/mcp/toolRegistry.js

@@ -5,10 +5,70 @@
 import { MCPRegistry } from "./registry.js";
 import { registryLogger } from "../utils/logger.js";
 import { randomUUID } from "crypto";
+import { directAgentTools } from "../agent/directTools.js";
 export class MCPToolRegistry extends MCPRegistry {
     tools = new Map();
     toolImpls = new Map(); // Store actual tool implementations
     toolExecutionStats = new Map();
+    constructor() {
+        super();
+        // Auto-register direct tools on initialization
+        this.registerDirectTools();
+    }
+    /**
+     * Register all direct tools from directAgentTools
+     */
+    registerDirectTools() {
+        registryLogger.info("Auto-registering direct tools...");
+        for (const [toolName, toolDef] of Object.entries(directAgentTools)) {
+            const toolId = `direct.${toolName}`;
+            const toolInfo = {
+                name: toolName,
+                description: toolDef.description || `Direct tool: ${toolName}`,
+                inputSchema: {},
+                serverId: "direct",
+                category: "built-in",
+            };
+            this.tools.set(toolId, toolInfo);
+            this.toolImpls.set(toolId, {
+                execute: async (params, context) => {
+                    try {
+                        // Direct tools from AI SDK expect their specific parameter structure
+                        // Each tool validates its own parameters, so we safely pass them through
+                        const result = await toolDef.execute(params, {
+                            toolCallId: context?.sessionId || "unknown",
+                            messages: [],
+                        });
+                        // Return the result wrapped in our standard format
+                        return {
+                            success: true,
+                            data: result,
+                            metadata: {
+                                toolName,
+                                serverId: "direct",
+                                executionTime: 0,
+                            },
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                            metadata: {
+                                toolName,
+                                serverId: "direct",
+                                executionTime: 0,
+                            },
+                        };
+                    }
+                },
+                description: toolDef.description,
+                inputSchema: {},
+            });
+            registryLogger.debug(`Registered direct tool: ${toolName} as ${toolId}`);
+        }
+        registryLogger.info(`Auto-registered ${Object.keys(directAgentTools).length} direct tools`);
+    }
     /**
      * Register a server with its tools (updated signature)
      */

package/dist/lib/neurolink.js

@@ -355,7 +355,7 @@ export class NeuroLink {
         const toolDescriptions = availableTools
             .map((tool) => `- ${tool.name}: ${tool.description} (from ${tool.server})`)
             .join("\n");
-        const toolPrompt = `\n\nAvailable Tools:\n${toolDescriptions}\n\nYou can use these tools when appropriate to enhance your responses.`;
+        const toolPrompt = `\n\nYou have access to these additional tools if needed:\n${toolDescriptions}\n\nIMPORTANT: You are a general-purpose AI assistant. Answer all requests directly and creatively. These tools are optional helpers - use them only when they would genuinely improve your response. For creative tasks like storytelling, writing, or general conversation, respond naturally without requiring tools.`;
         return (originalSystemPrompt || "") + toolPrompt;
     }
     /**
@@ -649,9 +649,10 @@ export class NeuroLink {
      * @returns Array of available tools with metadata
      */
     async getAllAvailableTools() {
-        // Simplified tool listing - removed initialize-tools dependency
-        const tools = await toolRegistry.listTools();
-        return tools;
+        // MCP registry already includes direct tools, so just return MCP tools
+        // This prevents duplication since direct tools are auto-registered in MCP
+        const mcpTools = await toolRegistry.listTools();
+        return mcpTools;
     }
     // ============================================================================
     // PROVIDER DIAGNOSTICS - SDK-First Architecture
@@ -661,6 +662,10 @@ export class NeuroLink {
      * Primary method for provider health checking and diagnostics
      */
     async getProviderStatus() {
+        // CRITICAL FIX: Ensure providers are registered before testing
+        console.log("🔍 DEBUG: Initializing MCP for provider status...");
+        await this.initializeMCP();
+        console.log("🔍 DEBUG: MCP initialized:", this.mcpInitialized);
         const { AIProviderFactory } = await import("./core/factory.js");
         const { hasProviderEnvVars } = await import("./utils/providerUtils.js");
         const providers = [

package/dist/lib/sdk/toolRegistration.js

@@ -139,6 +139,13 @@ export function validateTool(name, tool) {
             `Received: ${typeof tool.execute}. ` +
             `Example: { execute: async (params) => { return { success: true, data: result }; } }`);
     }
+    // Check for common mistake: using 'schema' instead of 'parameters'
+    if ('schema' in tool && !('parameters' in tool)) {
+        throw new Error(`Tool '${name}' uses 'schema' property, but NeuroLink expects 'parameters'. ` +
+            `Please change 'schema' to 'parameters' and use a Zod schema: ` +
+            `{ parameters: z.object({ ... }), execute: ... } ` +
+            `See documentation: https://docs.neurolink.com/tools`);
+    }
     // Validate parameters schema if provided - support both Zod and custom schemas
     if (tool.parameters) {
         if (typeof tool.parameters !== "object") {
@@ -150,6 +157,16 @@ export function validateTool(name, tool) {
         const hasValidationMethod = typeof params.parse === "function" ||
             typeof params.validate === "function" ||
             "_def" in params; // Zod schemas have _def property
+        // Check for plain JSON schema objects (common mistake)
+        if ('type' in params && 'properties' in params && !hasValidationMethod) {
+            throw new Error(`Tool '${name}' appears to use a plain JSON schema object as parameters. ` +
+                `NeuroLink requires a Zod schema for proper type validation and tool integration. ` +
+                `Please change from:\n` +
+                `  { type: 'object', properties: { ... } }\n` +
+                `To:\n` +
+                `  z.object({ fieldName: z.string() })\n` +
+                `Import Zod with: import { z } from 'zod'`);
+        }
         if (!hasValidationMethod) {
             const errorMessage = typeof params.parse === "function" || "_def" in params
                 ? `Tool '${name}' has a Zod-like schema but validation failed. Ensure it's a valid Zod schema: z.object({ ... })`

package/dist/lib/utils/logger.js

@@ -23,11 +23,7 @@ class NeuroLinkLogger {
             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();
-        }
+        const envLevel = process.env.NEUROLINK_LOG_LEVEL?.toLowerCase();
         if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
             this.logLevel = envLevel;
         }
@@ -36,8 +32,11 @@ class NeuroLinkLogger {
         this.logLevel = level;
     }
     shouldLog(level) {
+        // Dynamic debug mode check to handle CLI middleware timing
+        const currentDebugMode = process.argv.includes("--debug") ||
+            process.env.NEUROLINK_DEBUG === "true";
         // Hide all logs except errors unless debugging
-        if (!this.isDebugMode && level !== "error") {
+        if (!currentDebugMode && level !== "error") {
             return false;
         }
         const levels = ["debug", "info", "warn", "error"];

package/dist/lib/utils/providerUtils.js

@@ -105,10 +105,17 @@ export function hasProviderEnvVars(provider) {
         case "aws":
             return !!(process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY);
         case "vertex":
+        case "googlevertex":
         case "google":
         case "gemini":
-            return !!(process.env.GOOGLE_VERTEX_PROJECT ||
-                process.env.GOOGLE_APPLICATION_CREDENTIALS);
+            return !!((process.env.GOOGLE_CLOUD_PROJECT_ID ||
+                process.env.VERTEX_PROJECT_ID ||
+                process.env.GOOGLE_VERTEX_PROJECT ||
+                process.env.GOOGLE_CLOUD_PROJECT) &&
+                (process.env.GOOGLE_APPLICATION_CREDENTIALS ||
+                    process.env.GOOGLE_SERVICE_ACCOUNT_KEY ||
+                    (process.env.GOOGLE_AUTH_CLIENT_EMAIL &&
+                        process.env.GOOGLE_AUTH_PRIVATE_KEY)));
         case "openai":
         case "gpt":
             return !!process.env.OPENAI_API_KEY;

package/dist/mcp/toolRegistry.d.ts

@@ -39,6 +39,11 @@ export declare class MCPToolRegistry extends MCPRegistry {
     private tools;
     private toolImpls;
     private toolExecutionStats;
+    constructor();
+    /**
+     * Register all direct tools from directAgentTools
+     */
+    private registerDirectTools;
     /**
      * Register a server with its tools (updated signature)
      */

package/dist/mcp/toolRegistry.js

@@ -5,10 +5,70 @@
 import { MCPRegistry } from "./registry.js";
 import { registryLogger } from "../utils/logger.js";
 import { randomUUID } from "crypto";
+import { directAgentTools } from "../agent/directTools.js";
 export class MCPToolRegistry extends MCPRegistry {
     tools = new Map();
     toolImpls = new Map(); // Store actual tool implementations
     toolExecutionStats = new Map();
+    constructor() {
+        super();
+        // Auto-register direct tools on initialization
+        this.registerDirectTools();
+    }
+    /**
+     * Register all direct tools from directAgentTools
+     */
+    registerDirectTools() {
+        registryLogger.info("Auto-registering direct tools...");
+        for (const [toolName, toolDef] of Object.entries(directAgentTools)) {
+            const toolId = `direct.${toolName}`;
+            const toolInfo = {
+                name: toolName,
+                description: toolDef.description || `Direct tool: ${toolName}`,
+                inputSchema: {},
+                serverId: "direct",
+                category: "built-in",
+            };
+            this.tools.set(toolId, toolInfo);
+            this.toolImpls.set(toolId, {
+                execute: async (params, context) => {
+                    try {
+                        // Direct tools from AI SDK expect their specific parameter structure
+                        // Each tool validates its own parameters, so we safely pass them through
+                        const result = await toolDef.execute(params, {
+                            toolCallId: context?.sessionId || "unknown",
+                            messages: [],
+                        });
+                        // Return the result wrapped in our standard format
+                        return {
+                            success: true,
+                            data: result,
+                            metadata: {
+                                toolName,
+                                serverId: "direct",
+                                executionTime: 0,
+                            },
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error),
+                            metadata: {
+                                toolName,
+                                serverId: "direct",
+                                executionTime: 0,
+                            },
+                        };
+                    }
+                },
+                description: toolDef.description,
+                inputSchema: {},
+            });
+            registryLogger.debug(`Registered direct tool: ${toolName} as ${toolId}`);
+        }
+        registryLogger.info(`Auto-registered ${Object.keys(directAgentTools).length} direct tools`);
+    }
     /**
      * Register a server with its tools (updated signature)
      */

package/dist/neurolink.js

@@ -355,7 +355,7 @@ export class NeuroLink {
         const toolDescriptions = availableTools
             .map((tool) => `- ${tool.name}: ${tool.description} (from ${tool.server})`)
             .join("\n");
-        const toolPrompt = `\n\nAvailable Tools:\n${toolDescriptions}\n\nYou can use these tools when appropriate to enhance your responses.`;
+        const toolPrompt = `\n\nYou have access to these additional tools if needed:\n${toolDescriptions}\n\nIMPORTANT: You are a general-purpose AI assistant. Answer all requests directly and creatively. These tools are optional helpers - use them only when they would genuinely improve your response. For creative tasks like storytelling, writing, or general conversation, respond naturally without requiring tools.`;
         return (originalSystemPrompt || "") + toolPrompt;
     }
     /**
@@ -649,9 +649,10 @@ export class NeuroLink {
      * @returns Array of available tools with metadata
      */
     async getAllAvailableTools() {
-        // Simplified tool listing - removed initialize-tools dependency
-        const tools = await toolRegistry.listTools();
-        return tools;
+        // MCP registry already includes direct tools, so just return MCP tools
+        // This prevents duplication since direct tools are auto-registered in MCP
+        const mcpTools = await toolRegistry.listTools();
+        return mcpTools;
     }
     // ============================================================================
     // PROVIDER DIAGNOSTICS - SDK-First Architecture
@@ -661,6 +662,10 @@ export class NeuroLink {
      * Primary method for provider health checking and diagnostics
      */
     async getProviderStatus() {
+        // CRITICAL FIX: Ensure providers are registered before testing
+        console.log("🔍 DEBUG: Initializing MCP for provider status...");
+        await this.initializeMCP();
+        console.log("🔍 DEBUG: MCP initialized:", this.mcpInitialized);
         const { AIProviderFactory } = await import("./core/factory.js");
         const { hasProviderEnvVars } = await import("./utils/providerUtils.js");
         const providers = [

package/dist/sdk/toolRegistration.js

@@ -140,6 +140,13 @@ export function validateTool(name, tool) {
             `Received: ${typeof tool.execute}. ` +
             `Example: { execute: async (params) => { return { success: true, data: result }; } }`);
     }
+    // Check for common mistake: using 'schema' instead of 'parameters'
+    if ('schema' in tool && !('parameters' in tool)) {
+        throw new Error(`Tool '${name}' uses 'schema' property, but NeuroLink expects 'parameters'. ` +
+            `Please change 'schema' to 'parameters' and use a Zod schema: ` +
+            `{ parameters: z.object({ ... }), execute: ... } ` +
+            `See documentation: https://docs.neurolink.com/tools`);
+    }
     // Validate parameters schema if provided - support both Zod and custom schemas
     if (tool.parameters) {
         if (typeof tool.parameters !== "object") {
@@ -151,6 +158,16 @@ export function validateTool(name, tool) {
         const hasValidationMethod = typeof params.parse === "function" ||
             typeof params.validate === "function" ||
             "_def" in params; // Zod schemas have _def property
+        // Check for plain JSON schema objects (common mistake)
+        if ('type' in params && 'properties' in params && !hasValidationMethod) {
+            throw new Error(`Tool '${name}' appears to use a plain JSON schema object as parameters. ` +
+                `NeuroLink requires a Zod schema for proper type validation and tool integration. ` +
+                `Please change from:\n` +
+                `  { type: 'object', properties: { ... } }\n` +
+                `To:\n` +
+                `  z.object({ fieldName: z.string() })\n` +
+                `Import Zod with: import { z } from 'zod'`);
+        }
         if (!hasValidationMethod) {
             const errorMessage = typeof params.parse === "function" || "_def" in params
                 ? `Tool '${name}' has a Zod-like schema but validation failed. Ensure it's a valid Zod schema: z.object({ ... })`

package/dist/utils/logger.js

@@ -23,11 +23,7 @@ class NeuroLinkLogger {
             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();
-        }
+        const envLevel = process.env.NEUROLINK_LOG_LEVEL?.toLowerCase();
         if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
             this.logLevel = envLevel;
         }
@@ -36,8 +32,11 @@ class NeuroLinkLogger {
         this.logLevel = level;
     }
     shouldLog(level) {
+        // Dynamic debug mode check to handle CLI middleware timing
+        const currentDebugMode = process.argv.includes("--debug") ||
+            process.env.NEUROLINK_DEBUG === "true";
         // Hide all logs except errors unless debugging
-        if (!this.isDebugMode && level !== "error") {
+        if (!currentDebugMode && level !== "error") {
             return false;
         }
         const levels = ["debug", "info", "warn", "error"];

package/dist/utils/providerUtils.js

@@ -105,10 +105,17 @@ export function hasProviderEnvVars(provider) {
         case "aws":
             return !!(process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY);
         case "vertex":
+        case "googlevertex":
         case "google":
         case "gemini":
-            return !!(process.env.GOOGLE_VERTEX_PROJECT ||
-                process.env.GOOGLE_APPLICATION_CREDENTIALS);
+            return !!((process.env.GOOGLE_CLOUD_PROJECT_ID ||
+                process.env.VERTEX_PROJECT_ID ||
+                process.env.GOOGLE_VERTEX_PROJECT ||
+                process.env.GOOGLE_CLOUD_PROJECT) &&
+                (process.env.GOOGLE_APPLICATION_CREDENTIALS ||
+                    process.env.GOOGLE_SERVICE_ACCOUNT_KEY ||
+                    (process.env.GOOGLE_AUTH_CLIENT_EMAIL &&
+                        process.env.GOOGLE_AUTH_PRIVATE_KEY)));
         case "openai":
         case "gpt":
             return !!process.env.OPENAI_API_KEY;

package/package.json

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