@juspay/neurolink 8.2.0 → 8.4.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.4.0](https://github.com/juspay/neurolink/compare/v8.3.0...v8.4.0) (2025-12-01)
+
+### Features
+
+- **(core):** comprehensive multimodal architecture with modular refactoring and enhanced testing ([fd8d207](https://github.com/juspay/neurolink/commit/fd8d207a2f9be61e65fd00d697a0456511ece30f))
+
+## [8.3.0](https://github.com/juspay/neurolink/compare/v8.2.0...v8.3.0) (2025-11-28)
+
+### Features
+
+- **(cli):** make stream the default command in loop mode ([7aeb1d7](https://github.com/juspay/neurolink/commit/7aeb1d790e1b103b5fc1889e21431e9c7b9dcf5f))
+
 ## [8.2.0](https://github.com/juspay/neurolink/compare/v8.1.0...v8.2.0) (2025-11-25)
 
 ### Features

package/README.md

@@ -73,6 +73,7 @@ NeuroLink is a comprehensive AI development platform. Every feature below is pro
 | **OpenAI Compatible** | Any OpenAI-compatible endpoint | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openai-compatible) |
 
 **[📖 Provider Comparison Guide](docs/reference/provider-comparison.md)** - Detailed feature matrix and selection criteria
+**[🔬 Provider Feature Compatibility](docs/reference/provider-feature-compatibility.md)** - Test-based compatibility reference for all 19 features across 11 providers
 
 ---
 
@@ -211,15 +212,24 @@ npx @juspay/neurolink loop
 # Start the interactive session
 $ npx @juspay/neurolink loop
 
-neurolink » set provider google-ai
+neurolink » /set provider google-ai
 ✓ provider set to google-ai
 
-neurolink » set temperature 0.8
+neurolink » /set temperature 0.8
 ✓ temperature set to 0.8
 
-neurolink » generate "Tell me a fun fact about space"
+neurolink » Tell me a fun fact about space
+
 The quietest place on Earth is an anechoic chamber at Microsoft's headquarters in Redmond, Washington. The background noise is so low that it's measured in negative decibels, and you can hear your own heartbeat.
 
+# Use "/" for CLI commands
+neurolink » /generate "Draft a haiku"
+...
+
+# Use "//" to escape prompts starting with "/"
+neurolink » //what is /usr/bin used for?
+...
+
 # Exit the session
 neurolink » exit
 ```

package/dist/adapters/providerImageAdapter.d.ts

@@ -2,7 +2,7 @@
  * Provider Image Adapter - Smart routing for multimodal content
  * Handles provider-specific image formatting and vision capability validation
  */
-import type { Content } from "../types/content.js";
+import type { Content } from "../types/multimodal.js";
 /**
  * Simplified logger for essential error reporting only
  */

package/dist/adapters/providerImageAdapter.js

@@ -53,6 +53,7 @@ const VISION_CAPABILITIES = {
     anthropic: [
         "claude-3-7-sonnet",
         "claude-3-5-sonnet",
+        "claude-haiku-4-5",
         "claude-3-opus",
         "claude-3-sonnet",
         "claude-3-haiku",
@@ -82,6 +83,7 @@ const VISION_CAPABILITIES = {
         "gemini-1.5-flash",
         // Claude 4.x models (versioned format)
         "claude-sonnet-4-5@",
+        "claude-haiku-4-5",
         "claude-sonnet-4@",
         "claude-opus-4-1@",
         "claude-opus-4@",
@@ -100,9 +102,12 @@ const VISION_CAPABILITIES = {
         "claude-sonnet-3",
         "claude-opus-3",
         "claude-haiku-3",
+        "claude-haiku-4",
         // Additional patterns for compatibility
         "claude-3.5-sonnet",
         "claude-3.5-haiku",
+        "claude-4.5-haiku",
+        "claude-haiku-4-5",
         "claude-3.0-sonnet",
         "claude-3.0-opus",
     ],
@@ -118,6 +123,25 @@ const VISION_CAPABILITIES = {
         "gpt-4.1",
         "gpt-5",
     ],
+    mistral: [
+        // Mistral Small 3.2 (vision support for images: PNG, JPEG, WEBP, GIF)
+        "mistral-small",
+        "mistral-small-latest",
+        "mistral-small-3.2",
+        "mistral-small-2506",
+        // Mistral Medium 3.1 (vision support)
+        "mistral-medium",
+        "mistral-medium-latest",
+        "mistral-medium-3.1",
+        // Magistral models (vision support)
+        "magistral-small",
+        "magistral-medium",
+        // Pixtral models (specialized vision models)
+        "pixtral-12b",
+        "pixtral-12b-latest",
+        "pixtral-large",
+        "pixtral-large-latest",
+    ],
     ollama: [
         // Llama 4 family (May 2025 - Best vision + tool calling)
         "llama4:scout",
@@ -137,6 +161,44 @@ const VISION_CAPABILITIES = {
         // LLaVA (vision-focused)
         "llava",
     ],
+    bedrock: [
+        // Claude Sonnet 4.5 family (supports vision, PDFs, images)
+        "claude-sonnet-4-5",
+        "claude-sonnet-4.5",
+        "anthropic.claude-sonnet-4-5",
+        // Claude Haiku 4.5 family (supports vision, PDFs, images)
+        "claude-haiku-4-5",
+        "claude-haiku-4.5",
+        "anthropic.claude-haiku-4-5",
+        // Claude Sonnet 4 family
+        "claude-sonnet-4",
+        "claude-sonnet-4@",
+        "anthropic.claude-sonnet-4",
+        // Claude Opus 4 family
+        "claude-opus-4",
+        "claude-opus-4-1",
+        "claude-opus-4@",
+        "anthropic.claude-opus-4",
+        // Claude 3.7 Sonnet
+        "claude-3-7-sonnet",
+        "claude-3.7-sonnet",
+        "anthropic.claude-3-7-sonnet",
+        // Claude 3.5 Sonnet
+        "claude-3-5-sonnet",
+        "claude-3.5-sonnet",
+        "anthropic.claude-3-5-sonnet",
+        // Claude 3 Opus
+        "claude-3-opus",
+        "anthropic.claude-3-opus",
+        // Claude 3 Sonnet
+        "claude-3-sonnet",
+        "anthropic.claude-3-sonnet",
+        // Claude 3 Haiku
+        "claude-3-haiku",
+        "anthropic.claude-3-haiku",
+        // Generic anthropic.claude prefix (catches all Claude models)
+        "anthropic.claude",
+    ],
 };
 /**
  * Provider Image Adapter - Smart routing and formatting

package/dist/agent/directTools.d.ts

@@ -275,77 +275,6 @@ export declare const directAgentTools: {
             written?: undefined;
         }>;
     };
-    searchFiles: import("ai").Tool<z.ZodObject<{
-        directory: z.ZodString;
-        pattern: z.ZodString;
-        recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, "strip", z.ZodTypeAny, {
-        directory: string;
-        pattern: string;
-        recursive: boolean;
-    }, {
-        directory: string;
-        pattern: string;
-        recursive?: boolean | undefined;
-    }>, {
-        success: boolean;
-        error: string;
-        directory?: undefined;
-        pattern?: undefined;
-        matches?: undefined;
-        count?: undefined;
-    } | {
-        success: boolean;
-        directory: string;
-        pattern: string;
-        matches: {
-            name: string;
-            path: string;
-            size: number;
-            lastModified: string;
-        }[];
-        count: number;
-        error?: undefined;
-    } | {
-        success: boolean;
-        error: string;
-        directory: string;
-        pattern: string;
-        matches?: undefined;
-        count?: undefined;
-    }> & {
-        execute: (args: {
-            directory: string;
-            pattern: string;
-            recursive: boolean;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
-            success: boolean;
-            error: string;
-            directory?: undefined;
-            pattern?: undefined;
-            matches?: undefined;
-            count?: undefined;
-        } | {
-            success: boolean;
-            directory: string;
-            pattern: string;
-            matches: {
-                name: string;
-                path: string;
-                size: number;
-                lastModified: string;
-            }[];
-            count: number;
-            error?: undefined;
-        } | {
-            success: boolean;
-            error: string;
-            directory: string;
-            pattern: string;
-            matches?: undefined;
-            count?: undefined;
-        }>;
-    };
     analyzeCSV: import("ai").Tool<z.ZodObject<{
         filePath: z.ZodEffects<z.ZodString, string, string>;
         operation: z.ZodEnum<["count_by_column", "sum_by_column", "average_by_column", "min_max_by_column", "describe"]>;
@@ -546,7 +475,6 @@ export type FilesystemToolsMap = {
     readFile: typeof directAgentTools.readFile;
     listDirectory: typeof directAgentTools.listDirectory;
     writeFile: typeof directAgentTools.writeFile;
-    searchFiles: typeof directAgentTools.searchFiles;
 };
 export type UtilityToolsMap = {
     getCurrentTime: typeof directAgentTools.getCurrentTime;

package/dist/agent/directTools.js

@@ -264,79 +264,9 @@ export const directAgentTools = {
             }
         },
     }),
-    searchFiles: tool({
-        description: "Search for files by name pattern in a directory",
-        parameters: z.object({
-            directory: z.string().describe("Directory to search in"),
-            pattern: z
-                .string()
-                .describe("File name pattern to search for (supports wildcards like *.js)"),
-            recursive: z
-                .boolean()
-                .optional()
-                .default(true)
-                .describe("Search recursively in subdirectories"),
-        }),
-        execute: async ({ directory, pattern, recursive }) => {
-            try {
-                const resolvedDir = path.resolve(directory);
-                if (!fs.existsSync(resolvedDir)) {
-                    return {
-                        success: false,
-                        error: `Directory does not exist: ${resolvedDir}`,
-                    };
-                }
-                const matches = [];
-                const searchDir = (dir, depth = 0) => {
-                    if (!recursive && depth > 0) {
-                        return;
-                    }
-                    const items = fs.readdirSync(dir);
-                    for (const item of items) {
-                        const itemPath = path.join(dir, item);
-                        const stats = fs.statSync(itemPath);
-                        if (stats.isDirectory()) {
-                            if (recursive && depth < 10) {
-                                // Prevent infinite recursion
-                                searchDir(itemPath, depth + 1);
-                            }
-                        }
-                        else if (stats.isFile()) {
-                            // Simple pattern matching (convert * to regex)
-                            const regexPattern = pattern
-                                .replace(/\*/g, ".*")
-                                .replace(/\?/g, ".");
-                            const regex = new RegExp(`^${regexPattern}$`, "i");
-                            if (regex.test(item)) {
-                                matches.push({
-                                    name: item,
-                                    path: itemPath,
-                                    size: stats.size,
-                                    lastModified: stats.mtime.toISOString(),
-                                });
-                            }
-                        }
-                    }
-                };
-                searchDir(resolvedDir);
-                return {
-                    success: true,
-                    directory: resolvedDir,
-                    pattern,
-                    matches,
-                    count: matches.length,
-                };
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    error: error instanceof Error ? error.message : String(error),
-                    directory,
-                    pattern,
-                };
-            }
-        },
-    }),
+    // NOTE: searchFiles was removed to avoid naming conflict with external MCP 'search_files' tool
+    // from @modelcontextprotocol/server-filesystem which provides the same functionality
+    // with parameters {path, pattern, excludePatterns}
     analyzeCSV: tool({
         description: "Analyze CSV file for accurate counting, aggregation, and statistical analysis. Use this for precise data operations like counting rows by column, calculating sums/averages, finding min/max values, etc. The tool reads the file directly - do NOT pass CSV content.",
         parameters: z.object({
@@ -740,7 +670,6 @@ export function getToolsForCategory(category = "all") {
                 readFile: directAgentTools.readFile,
                 listDirectory: directAgentTools.listDirectory,
                 writeFile: directAgentTools.writeFile,
-                searchFiles: directAgentTools.searchFiles,
             };
         case "utility":
             return {

package/dist/cli/commands/config.d.ts

@@ -18,9 +18,9 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
             baseURL?: string | undefined;
         }, {
+            model?: string | undefined;
             apiKey?: string | undefined;
             baseURL?: string | undefined;
-            model?: string | undefined;
         }>>;
         bedrock: z.ZodOptional<z.ZodObject<{
             region: z.ZodOptional<z.ZodString>;
@@ -73,8 +73,8 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
         azure: z.ZodOptional<z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
@@ -87,8 +87,8 @@ declare const ConfigSchema: z.ZodObject<{
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         }>>;
@@ -99,8 +99,8 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
         huggingface: z.ZodOptional<z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
@@ -109,8 +109,8 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
         ollama: z.ZodOptional<z.ZodObject<{
             baseUrl: z.ZodDefault<z.ZodString>;
@@ -132,8 +132,8 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         bedrock?: {
@@ -193,9 +193,9 @@ declare const ConfigSchema: z.ZodObject<{
             sessionToken?: string | undefined;
         } | undefined;
         openai?: {
+            model?: string | undefined;
             apiKey?: string | undefined;
             baseURL?: string | undefined;
-            model?: string | undefined;
         } | undefined;
         vertex?: {
             model?: string | undefined;
@@ -207,22 +207,22 @@ declare const ConfigSchema: z.ZodObject<{
             privateKey?: string | undefined;
         } | undefined;
         anthropic?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         azure?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         } | undefined;
         "google-ai"?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         huggingface?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         ollama?: {
             timeout?: number | undefined;
@@ -230,8 +230,8 @@ declare const ConfigSchema: z.ZodObject<{
             baseUrl?: string | undefined;
         } | undefined;
         mistral?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
     }>>;
     profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -562,9 +562,9 @@ declare const ConfigSchema: z.ZodObject<{
             sessionToken?: string | undefined;
         } | undefined;
         openai?: {
+            model?: string | undefined;
             apiKey?: string | undefined;
             baseURL?: string | undefined;
-            model?: string | undefined;
         } | undefined;
         vertex?: {
             model?: string | undefined;
@@ -576,22 +576,22 @@ declare const ConfigSchema: z.ZodObject<{
             privateKey?: string | undefined;
         } | undefined;
         anthropic?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         azure?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         } | undefined;
         "google-ai"?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         huggingface?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         ollama?: {
             timeout?: number | undefined;
@@ -599,8 +599,8 @@ declare const ConfigSchema: z.ZodObject<{
             baseUrl?: string | undefined;
         } | undefined;
         mistral?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
     } | undefined;
     defaultProvider?: "bedrock" | "openai" | "vertex" | "anthropic" | "azure" | "google-ai" | "huggingface" | "ollama" | "mistral" | "auto" | undefined;

package/dist/cli/factories/commandFactory.js

@@ -34,6 +34,7 @@ export class CLICommandFactory {
                 "anthropic",
                 "azure",
                 "google-ai",
+                "google-ai-studio",
                 "huggingface",
                 "ollama",
                 "mistral",

package/dist/cli/loop/conversationSelector.js

@@ -121,6 +121,10 @@ export class ConversationSelector {
             if (conversation &&
                 conversation.messages &&
                 conversation.messages.length > 0) {
+                // Only include conversations with session IDs prefixed with "NL_"
+                if (!conversation.sessionId?.startsWith("NL_")) {
+                    return null;
+                }
                 return this.createConversationSummary(conversation);
             }
             return null;

package/dist/cli/loop/session.js

@@ -81,14 +81,31 @@ export class LoopSession {
                 if (!command) {
                     continue;
                 }
-                // Handle session variable commands first
-                if (await this.handleSessionCommands(command)) {
-                    // Save session commands to history (both memory and file)
-                    if (command && command.trim()) {
-                        this.commandHistory.unshift(command);
-                        await saveCommandToHistory(command);
+                // Save command to history
+                if (command && command.trim()) {
+                    this.commandHistory.unshift(command);
+                    await saveCommandToHistory(command);
+                }
+                let processedCommand;
+                if (command.startsWith("//")) {
+                    // Escape sequence - treat as stream with single /
+                    processedCommand = ["stream", command.slice(1)];
+                }
+                else if (command.startsWith("/")) {
+                    // Explicit CLI command: remove "/" prefix
+                    processedCommand = command.slice(1).trim();
+                    if (!processedCommand) {
+                        logger.always(chalk.red("Type 'help' for available commands."));
+                        continue;
+                    }
+                    // Handle session variable commands and skip further processing
+                    if (await this.handleSessionCommands(processedCommand)) {
+                        continue;
                     }
-                    continue;
+                }
+                else {
+                    // Default: treat as stream command with array format
+                    processedCommand = ["stream", command];
                 }
                 // Execute the command
                 // The .fail() handler in cli.ts is now session-aware and will
@@ -102,16 +119,11 @@ export class LoopSession {
                     throw err || new Error(msg);
                 })
                     .exitProcess(false)
-                    .parse(command);
-                // Save command to history (both memory and file)
-                if (command && command.trim()) {
-                    this.commandHistory.unshift(command);
-                    await saveCommandToHistory(command);
-                }
+                    .parse(processedCommand);
             }
             catch (error) {
-                // Catch errors from the main loop (e.g., readline prompt itself failing)
-                handleError(error, "An unexpected error occurred");
+                // Handle command execution errors gracefully
+                handleError(error, "Command execution failed");
             }
         }
         // Cleanup on exit

package/dist/constants/enums.d.ts

@@ -72,6 +72,7 @@ export declare enum GoogleAIModels {
  * Supported Models for Anthropic (Direct API)
  */
 export declare enum AnthropicModels {
+    CLAUDE_4_5_HAIKU = "claude-haiku-4-5-20251001",
     CLAUDE_3_5_SONNET = "claude-3-5-sonnet-20241022",
     CLAUDE_3_5_HAIKU = "claude-3-5-haiku-20241022",
     CLAUDE_3_SONNET = "claude-3-sonnet-20240229",

package/dist/constants/enums.js

@@ -91,7 +91,9 @@ export var GoogleAIModels;
  */
 export var AnthropicModels;
 (function (AnthropicModels) {
-    // Claude 3.5 Series (Latest)
+    // Claude 4.5 Series (Latest - October 2025)
+    AnthropicModels["CLAUDE_4_5_HAIKU"] = "claude-haiku-4-5-20251001";
+    // Claude 3.5 Series
     AnthropicModels["CLAUDE_3_5_SONNET"] = "claude-3-5-sonnet-20241022";
     AnthropicModels["CLAUDE_3_5_HAIKU"] = "claude-3-5-haiku-20241022";
     // Claude 3 Series (Legacy support)

package/dist/constants/tokens.d.ts

@@ -63,6 +63,7 @@ export declare const PROVIDER_TOKEN_LIMITS: {
         readonly "claude-3-5-sonnet-20241022": 4096;
         readonly "claude-3-opus-20240229": 4096;
         readonly "claude-3-5-haiku-20241022": 4096;
+        readonly "claude-haiku-4-5-20251001": 8192;
         readonly "claude-3-sonnet-20240229": 4096;
         readonly default: 4096;
     };
@@ -100,6 +101,7 @@ export declare const PROVIDER_TOKEN_LIMITS: {
         readonly "claude-opus-4@20250514": 4096;
         readonly "claude-3-5-sonnet-20241022": 4096;
         readonly "claude-3-5-haiku-20241022": 4096;
+        readonly "claude-haiku-4-5-20251001": 8192;
         readonly "claude-3-sonnet-20240229": 4096;
         readonly "claude-3-haiku-20240307": 4096;
         readonly "claude-3-opus-20240229": 4096;
@@ -111,6 +113,7 @@ export declare const PROVIDER_TOKEN_LIMITS: {
         readonly "anthropic.claude-3-haiku-20240307-v1:0": 4096;
         readonly "anthropic.claude-3-5-sonnet-20240620-v1:0": 4096;
         readonly "anthropic.claude-3-opus-20240229-v1:0": 4096;
+        readonly "anthropic.claude-haiku-4-5-20251001-v1:0": 8192;
         readonly "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0": 4096;
         readonly default: 4096;
     };

package/dist/constants/tokens.js

@@ -63,6 +63,7 @@ export const PROVIDER_TOKEN_LIMITS = {
         "claude-3-5-sonnet-20241022": 4096,
         "claude-3-opus-20240229": 4096,
         "claude-3-5-haiku-20241022": 4096,
+        "claude-haiku-4-5-20251001": 8192,
         "claude-3-sonnet-20240229": 4096,
         default: 4096, // Conservative default for Anthropic
     },
@@ -100,6 +101,7 @@ export const PROVIDER_TOKEN_LIMITS = {
         "claude-opus-4@20250514": 4096,
         "claude-3-5-sonnet-20241022": 4096,
         "claude-3-5-haiku-20241022": 4096,
+        "claude-haiku-4-5-20251001": 8192,
         "claude-3-sonnet-20240229": 4096,
         "claude-3-haiku-20240307": 4096,
         "claude-3-opus-20240229": 4096,
@@ -111,6 +113,7 @@ export const PROVIDER_TOKEN_LIMITS = {
         "anthropic.claude-3-haiku-20240307-v1:0": 4096,
         "anthropic.claude-3-5-sonnet-20240620-v1:0": 4096,
         "anthropic.claude-3-opus-20240229-v1:0": 4096,
+        "anthropic.claude-haiku-4-5-20251001-v1:0": 8192,
         "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0": 4096,
         default: 4096,
     },