@juspay/neurolink 2.1.0 → 3.0.1

package/CHANGELOG.md

@@ -1,35 +1,62 @@
-# [2.1.0](https://github.com/juspay/neurolink/compare/v2.0.0...v2.1.0) (2025-06-29)
+## [3.0.1](https://github.com/juspay/neurolink/compare/v3.0.0...v3.0.1) (2025-07-01)
+
+
+### Bug Fixes
+
+* **cli:** honor --model parameter in CLI commands ([467ea85](https://github.com/juspay/neurolink/commit/467ea8548688a9db6046c98dbfd268ecd297605c))
+
+# [3.0.0](https://github.com/juspay/neurolink/compare/v2.1.0...v3.0.0) (2025-07-01)
 
 
 ### Features
 
-* **timeout:** add comprehensive timeout support for all AI providers ([8610f4a](https://github.com/juspay/neurolink/commit/8610f4ade418345b0395ab72af6e675f6eec6f93))
+* **proxy:** add comprehensive enterprise proxy support across all providers ([9668e67](https://github.com/juspay/neurolink/commit/9668e67dfaa27831ba85d45fdf5b7739de902b28))
 
-# [2.0.0](https://github.com/juspay/neurolink/compare/v1.11.3...v2.0.0) (2025-06-28)
 
+### BREAKING CHANGES
+
+* **proxy:** None - fully backward compatible
+
+Files modified:
+- docs/ENTERPRISE-PROXY-SETUP.md (NEW) - Comprehensive enterprise proxy guide
+- docs/PROVIDER-CONFIGURATION.md - Added proxy configuration section
+- docs/CLI-GUIDE.md - Added proxy environment variables documentation
+- docs/ENVIRONMENT-VARIABLES.md - Added proxy configuration examples
+- docs/TROUBLESHOOTING.md - Added proxy troubleshooting procedures
+- .env.example - Added proxy environment variables
+- memory-bank/ - Updated with proxy implementation milestone
+- .clinerules - Added proxy success patterns
+- CHANGELOG.md - Added v2.2.0 proxy support entry
+- package.json - Updated description with enterprise features
+- README.md - Removed outdated content
+
+# [2.1.0](https://github.com/juspay/neurolink/compare/v2.0.0...v2.1.0) (2025-06-29)
 
 ### Features
 
-* **cli:** add command variations and stream agent support ([5fc4c26](https://github.com/juspay/neurolink/commit/5fc4c26b23bd189be52272521bdd2ca40dd55837))
+- **timeout:** add comprehensive timeout support for all AI providers ([8610f4a](https://github.com/juspay/neurolink/commit/8610f4ade418345b0395ab72af6e675f6eec6f93))
+
+# [2.0.0](https://github.com/juspay/neurolink/compare/v1.11.3...v2.0.0) (2025-06-28)
+
+### Features
 
+- **cli:** add command variations and stream agent support ([5fc4c26](https://github.com/juspay/neurolink/commit/5fc4c26b23bd189be52272521bdd2ca40dd55837))
 
 ### BREAKING CHANGES
 
-* **cli:** 'generate-text' command is deprecated and will be removed in v2.0
+- **cli:** 'generate-text' command is deprecated and will be removed in v2.0
 
 ## [1.11.3](https://github.com/juspay/neurolink/compare/v1.11.2...v1.11.3) (2025-06-22)
 
-
 ### Bug Fixes
 
-* resolve MCP external tools returning raw JSON instead of human-readable responses ([921a12b](https://github.com/juspay/neurolink/commit/921a12b5b31ca96bbfe3f1db05001ddb84470e14))
+- resolve MCP external tools returning raw JSON instead of human-readable responses ([921a12b](https://github.com/juspay/neurolink/commit/921a12b5b31ca96bbfe3f1db05001ddb84470e14))
 
 ## [1.11.2](https://github.com/juspay/neurolink/compare/v1.11.1...v1.11.2) (2025-06-22)
 
-
 ### Bug Fixes
 
-* **ci:** refactor auto-converted Node.js scripts ([4088888](https://github.com/juspay/neurolink/commit/408888863f8223e64269423412f5c79a35ddfe36))
+- **ci:** refactor auto-converted Node.js scripts ([4088888](https://github.com/juspay/neurolink/commit/408888863f8223e64269423412f5c79a35ddfe36))
 
 ## [1.11.1](https://github.com/juspay/neurolink/compare/v1.11.0...v1.11.1) (2025-06-21)
 

package/README.md

@@ -11,28 +11,6 @@
 
 **NeuroLink** unifies OpenAI, Bedrock, Vertex AI, Google AI Studio, Anthropic, Azure OpenAI, Hugging Face, Ollama, and Mistral AI with intelligent fallback and streaming support. Available as both a **programmatic SDK** and **professional CLI tool**. Extracted from production use at Juspay.
 
-## 🔥 **Latest Breakthrough: Full MCP Tool Integration Operational** (June 21, 2025)
-
-**MAJOR SUCCESS**: All blocking TypeScript compilation errors resolved + Complete CLI MCP integration achieved!
-
-✅ **Function Calling Ready**: AI can now execute real filesystem operations, data analysis, and system commands
-✅ **Production Validated**: 23,230+ token MCP context loading confirmed via comprehensive CLI testing
-✅ **Zero Build Errors**: Clean TypeScript compilation after resolving all 13 blocking errors
-✅ **CLI Tool Integration**: Both `generate`/`gen` and `agent-generate` commands use full MCP capabilities
-✅ **Backward Compatible**: Tools enabled by default with opt-out flag for traditional usage
-
-```bash
-# NEW: AI can now access your filesystem and execute tools (use preferred commands)
-npx @juspay/neurolink generate "List files in this directory" --provider google-ai
-
-# Alternative shorter command
-npx @juspay/neurolink gen "List files in this directory" --provider google-ai
-
-# ⚠️ DEPRECATED: generate-text will be removed in v2.0 (use 'generate' or 'gen' instead)
-# This command shows a deprecation warning and is kept for backward compatibility only
-npx @juspay/neurolink generate-text "List files in this directory" --provider google-ai
-```
-
 ## 🚀 Quick Start
 
 ### Install & Run (2 minutes)
@@ -61,7 +39,7 @@ import { createBestAIProvider } from "@juspay/neurolink";
 const provider = createBestAIProvider();
 const result = await provider.generateText({
   prompt: "Write a haiku about programming",
-  timeout: '30s' // Optional: Set custom timeout (default: 30s)
+  timeout: "30s", // Optional: Set custom timeout (default: 30s)
 });
 
 console.log(result.text);
@@ -101,14 +79,14 @@ npx @juspay/neurolink status
 
 ## 🛠️ MCP Integration Status (v1.11.1) ✅ **PRODUCTION READY**
 
-| Component           | Status             | Description                                         |
-| ------------------- | ------------------ | --------------------------------------------------- |
-| Built-in Tools      | ✅ **Working**     | Time tool, utilities - fully functional             |
-| External Discovery  | ✅ **Working**     | 58+ MCP servers auto-discovered from all AI tools   |
-| Tool Execution      | ✅ **Working**     | Real-time AI tool calling with built-in tools       |
+| Component           | Status             | Description                                                |
+| ------------------- | ------------------ | ---------------------------------------------------------- |
+| Built-in Tools      | ✅ **Working**     | Time tool, utilities - fully functional                    |
+| External Discovery  | ✅ **Working**     | 58+ MCP servers auto-discovered from all AI tools          |
+| Tool Execution      | ✅ **Working**     | Real-time AI tool calling with built-in tools              |
 | **External Tools**  | ✅ **SOLVED**      | **Two-step tool calling fixed - human-readable responses** |
-| **CLI Integration** | ✅ **READY**       | **Production-ready AI assistant with external tools** |
-| External Activation | 🔧 **Development** | Discovery complete, activation protocol in progress |
+| **CLI Integration** | ✅ **READY**       | **Production-ready AI assistant with external tools**      |
+| External Activation | 🔧 **Development** | Discovery complete, activation protocol in progress        |
 
 ### ✅ Quick MCP Test (v1.7.1)
 
@@ -213,16 +191,16 @@ npx @juspay/neurolink batch prompts.txt --timeout 45s --output results.json
 export const POST: RequestHandler = async ({ request }) => {
   const { message } = await request.json();
   const provider = createBestAIProvider();
-  
+
   try {
-    const result = await provider.streamText({ 
+    const result = await provider.streamText({
       prompt: message,
-      timeout: '2m' // 2 minutes for streaming
+      timeout: "2m", // 2 minutes for streaming
     });
     return new Response(result.toReadableStream());
   } catch (error) {
-    if (error.name === 'TimeoutError') {
-      return new Response('Request timed out', { status: 408 });
+    if (error.name === "TimeoutError") {
+      return new Response("Request timed out", { status: 408 });
     }
     throw error;
   }
@@ -232,12 +210,12 @@ export const POST: RequestHandler = async ({ request }) => {
 export async function POST(request: NextRequest) {
   const { prompt } = await request.json();
   const provider = createBestAIProvider();
-  
-  const result = await provider.generateText({ 
+
+  const result = await provider.generateText({
     prompt,
-    timeout: process.env.AI_TIMEOUT || '30s' // Configurable timeout
+    timeout: process.env.AI_TIMEOUT || "30s", // Configurable timeout
   });
-  
+
   return NextResponse.json({ text: result.text });
 }
 ```

package/dist/cli/index.js

@@ -256,6 +256,10 @@ const cli = yargs(args)
     type: "string",
     default: "30s",
     description: "Timeout for the request (e.g., 30s, 2m, 1h, 5000)",
+})
+    .option("model", {
+    type: "string",
+    description: "Specific model to use (e.g. gemini-2.5-pro, gemini-2.5-flash)",
 })
     .option("disable-tools", {
     type: "boolean",
@@ -268,7 +272,7 @@ const cli = yargs(args)
     .example('$0 generate-text "Hello world" --disable-tools', "Use without tool integration"), async (argv) => {
     // Check if generate-text was used specifically (for deprecation warning)
     const usedCommand = argv._[0];
-    if (usedCommand === 'generate-text' && !argv.quiet) {
+    if (usedCommand === "generate-text" && !argv.quiet) {
         console.warn(chalk.yellow('⚠️  Warning: "generate-text" is deprecated. Use "generate" or "gen" instead for multimodal support.'));
     }
     let originalConsole = {};
@@ -296,6 +300,7 @@ const cli = yargs(args)
                 provider: argv.provider === "auto"
                     ? undefined
                     : argv.provider,
+                model: argv.model,
                 temperature: argv.temperature,
                 maxTokens: argv.maxTokens,
                 systemPrompt: argv.system,
@@ -318,7 +323,7 @@ const cli = yargs(args)
             })();
             const agentProvider = new AgentEnhancedProvider({
                 provider: supportedProvider,
-                model: undefined, // Use default model for provider
+                model: argv.model, // Use specified model or default
                 toolCategory: "all", // Enable all tool categories
             });
             generatePromise = agentProvider.generateText(argv.prompt);
@@ -331,20 +336,26 @@ const cli = yargs(args)
             spinner.succeed(chalk.green("✅ Text generated successfully!"));
         }
         // Handle both AgentEnhancedProvider (AI SDK) and standard NeuroLink SDK responses
-        const responseText = result ? (result.text || result.content || "") : "";
-        const responseUsage = result ? (result.usage || {
-            promptTokens: 0,
-            completionTokens: 0,
-            totalTokens: 0,
-        }) : { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+        const responseText = result
+            ? result.text || result.content || ""
+            : "";
+        const responseUsage = result
+            ? result.usage || {
+                promptTokens: 0,
+                completionTokens: 0,
+                totalTokens: 0,
+            }
+            : { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
         if (argv.format === "json") {
             const jsonOutput = {
                 content: responseText,
-                provider: result ? (result.provider || argv.provider) : argv.provider,
+                provider: result
+                    ? result.provider || argv.provider
+                    : argv.provider,
                 usage: responseUsage,
-                responseTime: result ? (result.responseTime || 0) : 0,
-                toolCalls: result ? (result.toolCalls || []) : [],
-                toolResults: result ? (result.toolResults || []) : [],
+                responseTime: result ? result.responseTime || 0 : 0,
+                toolCalls: result ? result.toolCalls || [] : [],
+                toolResults: result ? result.toolResults || [] : [],
             };
             process.stdout.write(JSON.stringify(jsonOutput, null, 2) + "\n");
         }
@@ -354,7 +365,9 @@ const cli = yargs(args)
                 console.log("\n" + responseText + "\n");
             }
             // Show tool calls if any
-            if (result && result.toolCalls && result.toolCalls.length > 0) {
+            if (result &&
+                result.toolCalls &&
+                result.toolCalls.length > 0) {
                 console.log(chalk.blue("🔧 Tools Called:"));
                 for (const toolCall of result.toolCalls) {
                     console.log(`- ${toolCall.toolName}`);
@@ -363,7 +376,9 @@ const cli = yargs(args)
                 console.log();
             }
             // Show tool results if any
-            if (result && result.toolResults && result.toolResults.length > 0) {
+            if (result &&
+                result.toolResults &&
+                result.toolResults.length > 0) {
                 console.log(chalk.blue("📋 Tool Results:"));
                 for (const toolResult of result.toolResults) {
                     console.log(`- ${toolResult.toolCallId}`);
@@ -372,9 +387,11 @@ const cli = yargs(args)
                 console.log();
             }
             console.log(JSON.stringify({
-                provider: result ? (result.provider || argv.provider) : argv.provider,
+                provider: result
+                    ? result.provider || argv.provider
+                    : argv.provider,
                 usage: responseUsage,
-                responseTime: result ? (result.responseTime || 0) : 0,
+                responseTime: result ? result.responseTime || 0 : 0,
             }, null, 2));
             if (responseUsage.totalTokens) {
                 console.log(chalk.blue(`ℹ️  ${responseUsage.totalTokens} tokens used`));
@@ -438,6 +455,10 @@ const cli = yargs(args)
     type: "string",
     default: "2m",
     description: "Timeout for streaming (e.g., 30s, 2m, 1h)",
+})
+    .option("model", {
+    type: "string",
+    description: "Specific model to use (e.g., gemini-1.5-pro-latest, gemini-2.0-flash-exp)",
 })
     .option("debug", {
     type: "boolean",
@@ -469,6 +490,7 @@ const cli = yargs(args)
                 provider: argv.provider === "auto"
                     ? undefined
                     : argv.provider,
+                model: argv.model,
                 temperature: argv.temperature,
                 timeout: argv.timeout,
             });
@@ -489,7 +511,7 @@ const cli = yargs(args)
             })();
             const agentProvider = new AgentEnhancedProvider({
                 provider: supportedProvider,
-                model: undefined, // Use default model for provider
+                model: argv.model, // Use specified model or default
                 toolCategory: "all", // Enable all tool categories
             });
             // Note: AgentEnhancedProvider doesn't support streaming with tools yet
@@ -501,7 +523,7 @@ const cli = yargs(args)
             const DELAY_MS = 50;
             for (let i = 0; i < text.length; i += CHUNK_SIZE) {
                 process.stdout.write(text.slice(i, i + CHUNK_SIZE));
-                await new Promise(resolve => setTimeout(resolve, DELAY_MS)); // Small delay
+                await new Promise((resolve) => setTimeout(resolve, DELAY_MS)); // Small delay
             }
             if (!argv.quiet) {
                 process.stdout.write("\n");

package/dist/lib/mcp/plugins/filesystem-mcp.d.ts

@@ -3,7 +3,7 @@
  * Implements the new MCP contract with security sandbox
  * Based on research document recommendations
  */
-import { MCP, MCPMetadata, ExecutionContext } from "../contracts/mcp-contract.js";
+import { MCP, type MCPMetadata, type ExecutionContext } from "../contracts/mcp-contract.js";
 /**
  * FileSystem MCP Configuration
  */

package/dist/lib/neurolink.d.ts

@@ -8,6 +8,7 @@ import type { AIProviderName } from "./core/types.js";
 export interface TextGenerationOptions {
     prompt: string;
     provider?: "openai" | "bedrock" | "vertex" | "anthropic" | "azure" | "google-ai" | "huggingface" | "ollama" | "mistral" | "auto";
+    model?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;
@@ -18,6 +19,7 @@ export interface TextGenerationOptions {
 export interface StreamTextOptions {
     prompt: string;
     provider?: "openai" | "bedrock" | "vertex" | "anthropic" | "azure" | "google-ai" | "huggingface" | "ollama" | "mistral" | "auto";
+    model?: string;
     temperature?: number;
     maxTokens?: number;
     systemPrompt?: string;

package/dist/lib/neurolink.js

@@ -127,7 +127,7 @@ export class NeuroLink {
             // Create tool-aware system prompt
             const enhancedSystemPrompt = this.createToolAwareSystemPrompt(options.systemPrompt, availableTools);
             // Create provider with MCP enabled using best provider function
-            const provider = await AIProviderFactory.createBestProvider(providerName, undefined, true);
+            const provider = await AIProviderFactory.createBestProvider(providerName, options.model, true);
             // Generate text with automatic tool detection
             const result = await provider.generateText({
                 prompt: options.prompt,
@@ -217,9 +217,10 @@ export class NeuroLink {
                 logger.debug(`[${functionTag}] Attempting provider`, {
                     provider: providerName,
                 });
-                const provider = await AIProviderFactory.createProvider(providerName);
+                const provider = await AIProviderFactory.createProvider(providerName, options.model);
                 const result = await provider.generateText({
                     prompt: options.prompt,
+                    model: options.model,
                     temperature: options.temperature,
                     maxTokens: options.maxTokens,
                     systemPrompt: options.systemPrompt,
@@ -343,9 +344,10 @@ Note: Tool integration is currently in development. Please provide helpful respo
                 logger.debug(`[${functionTag}] Attempting provider`, {
                     provider: providerName,
                 });
-                const provider = await AIProviderFactory.createProvider(providerName);
+                const provider = await AIProviderFactory.createProvider(providerName, options.model);
                 const result = await provider.streamText({
                     prompt: options.prompt,
+                    model: options.model,
                     temperature: options.temperature,
                     maxTokens: options.maxTokens,
                     systemPrompt: options.systemPrompt,