@juspay/neurolink 4.1.0 → 4.2.0

package/CHANGELOG.md

@@ -1,9 +1,21 @@
-# [4.1.0](https://github.com/juspay/neurolink/compare/v4.0.0...v4.1.0) (2025-07-09)
+# [4.2.0](https://github.com/juspay/neurolink/compare/v4.1.1...v4.2.0) (2025-07-11)
+
+
+### Features
+
+* **mcp:** comprehensive MCP system enhancements with timeout management ([1d35b5e](https://github.com/juspay/neurolink/commit/1d35b5e12d03ce60bcdf0608749a1b99e8565567))
 
+## [4.1.1](https://github.com/juspay/neurolink/compare/v4.1.0...v4.1.1) (2025-07-10)
+
+### Bug Fixes
+
+- **format:** fix formatting for all follow ([a49a94b](https://github.com/juspay/neurolink/commit/a49a94bf4d2e02cf1b1f7d4b555c3c71e25a0ea5))
+
+# [4.1.0](https://github.com/juspay/neurolink/compare/v4.0.0...v4.1.0) (2025-07-09)
 
 ### Features
 
-* **mcp:** comprehensive MCP system overhaul with GitHub PR fixes ([c0d8114](https://github.com/juspay/neurolink/commit/c0d8114ef1ab2d5dd3162c369f234d0de17397f7))
+- **mcp:** comprehensive MCP system overhaul with GitHub PR fixes ([c0d8114](https://github.com/juspay/neurolink/commit/c0d8114ef1ab2d5dd3162c369f234d0de17397f7))
 
 # [4.0.0](https://github.com/juspay/neurolink/compare/v3.0.1...v4.0.0) (2025-07-06)
 

package/README.md

@@ -1,15 +1,4 @@
-# @juspay/neurolink
-
-<!-- TOC -->
-
-- [📄 License](#[object Object])
-- [🔗 Related Projects](#-related-projects)
-<!-- /TOC -->
-
-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.
-
-**Version:** 4.0.0
-**License:** MIT
+# 🧠 NeuroLink
 
 [![NPM Version](https://img.shields.io/npm/v/@juspay/neurolink)](https://www.npmjs.com/package/@juspay/neurolink)
 [![Downloads](https://img.shields.io/npm/dm/@juspay/neurolink)](https://www.npmjs.com/package/@juspay/neurolink)
@@ -48,28 +37,28 @@ npm run config:validate
 ```typescript
 // Modern camelCase interfaces with rich context
 interface ExecutionContext {
-	sessionId?: string;
-	userId?: string;
-	aiProvider?: string;
-	permissions?: string[];
-	cacheOptions?: CacheOptions;
-	fallbackOptions?: FallbackOptions;
-	metadata?: Record<string, unknown>;
+  sessionId?: string;
+  userId?: string;
+  aiProvider?: string;
+  permissions?: string[];
+  cacheOptions?: CacheOptions;
+  fallbackOptions?: FallbackOptions;
+  metadata?: Record<string, unknown>;
 }
 
 // Optional methods for maximum flexibility
 interface McpRegistry {
-	registerServer?(
-		serverId: string,
-		config?: unknown,
-		context?: ExecutionContext,
-	): Promise<void>;
-	executeTool?<T>(
-		toolName: string,
-		args?: unknown,
-		context?: ExecutionContext,
-	): Promise<T>;
-	listTools?(context?: ExecutionContext): Promise<ToolInfo[]>;
+  registerServer?(
+    serverId: string,
+    config?: unknown,
+    context?: ExecutionContext,
+  ): Promise<void>;
+  executeTool?<T>(
+    toolName: string,
+    args?: unknown,
+    context?: ExecutionContext,
+  ): Promise<T>;
+  listTools?(context?: ExecutionContext): Promise<ToolInfo[]>;
 }
 ```
 
@@ -115,8 +104,8 @@ import { createBestAIProvider } from "@juspay/neurolink";
 // Auto-selects best available provider
 const provider = createBestAIProvider();
 const result = await provider.generateText({
-	prompt: "Write a haiku about programming",
-	timeout: "30s", // Optional: Set custom timeout (default: 30s)
+  prompt: "Write a haiku about programming",
+  timeout: "30s", // Optional: Set custom timeout (default: 30s)
 });
 
 console.log(result.text);
@@ -138,8 +127,8 @@ const provider = createBestAIProvider();
 
 // Detailed method name
 const story = await provider.generateText({
-	prompt: "Write a short story about AI",
-	maxTokens: 200,
+  prompt: "Write a short story about AI",
+  maxTokens: 200,
 });
 
 // CLI-style method names
@@ -177,10 +166,10 @@ const result = await neurolink.generateText("Write a story");
 
 // With enhancements (NEW!)
 const enhancedResult = await neurolink.generateText({
-	prompt: "Write a business proposal",
-	enableAnalytics: true, // Get usage & cost data
-	enableEvaluation: true, // Get AI quality scores
-	context: { project: "Q1-sales" }, // Custom context
+  prompt: "Write a business proposal",
+  enableAnalytics: true, // Get usage & cost data
+  enableEvaluation: true, // Get AI quality scores
+  context: { project: "Q1-sales" }, // Custom context
 });
 
 // Access enhancement data
@@ -190,25 +179,25 @@ console.log("Response:", enhancedResult.content);
 
 // 🆕 NEW: Enhanced Evaluation with Domain Awareness
 import {
-	performEnhancedEvaluation,
-	createEnhancedContext,
+  performEnhancedEvaluation,
+  createEnhancedContext,
 } from "@juspay/neurolink";
 
 const enhancedContext = createEnhancedContext(
-	"Write a business proposal for Q1 expansion",
-	enhancedResult.text,
-	{
-		domain: "Business development",
-		role: "Business proposal assistant",
-		toolsUsed: ["generate-text", "analytics-helper"],
-		conversationHistory: [
-			{ role: "user", content: "I need help with our Q1 business plan" },
-			{
-				role: "assistant",
-				content: "I can help you create a comprehensive plan",
-			},
-		],
-	},
+  "Write a business proposal for Q1 expansion",
+  enhancedResult.text,
+  {
+    domain: "Business development",
+    role: "Business proposal assistant",
+    toolsUsed: ["generate-text", "analytics-helper"],
+    conversationHistory: [
+      { role: "user", content: "I need help with our Q1 business plan" },
+      {
+        role: "assistant",
+        content: "I can help you create a comprehensive plan",
+      },
+    ],
+  },
 );
 
 const domainEvaluation = await performEnhancedEvaluation(enhancedContext);
@@ -226,39 +215,39 @@ console.log("🎯 Enhanced Evaluation:", domainEvaluation);
 
 ```typescript
 import {
-	createEnhancedChatService,
-	NeuroLinkWebSocketServer,
+  createEnhancedChatService,
+  NeuroLinkWebSocketServer,
 } from "@juspay/neurolink";
 
 // Enhanced chat with WebSocket support
 const chatService = createEnhancedChatService({
-	provider: await createBestAIProvider(),
-	enableWebSocket: true,
-	enableSSE: true,
-	streamingConfig: {
-		bufferSize: 8192,
-		compressionEnabled: true,
-	},
+  provider: await createBestAIProvider(),
+  enableWebSocket: true,
+  enableSSE: true,
+  streamingConfig: {
+    bufferSize: 8192,
+    compressionEnabled: true,
+  },
 });
 
 // WebSocket server for real-time applications
 const wsServer = new NeuroLinkWebSocketServer({
-	port: 8080,
-	maxConnections: 1000,
-	enableCompression: true,
+  port: 8080,
+  maxConnections: 1000,
+  enableCompression: true,
 });
 
 // Handle real-time chat
 wsServer.on("chat-message", async ({ connectionId, message }) => {
-	await chatService.streamChat({
-		prompt: message.data.prompt,
-		onChunk: (chunk) => {
-			wsServer.sendMessage(connectionId, {
-				type: "ai-chunk",
-				data: { chunk },
-			});
-		},
-	});
+  await chatService.streamChat({
+    prompt: message.data.prompt,
+    onChunk: (chunk) => {
+      wsServer.sendMessage(connectionId, {
+        type: "ai-chunk",
+        data: { chunk },
+      });
+    },
+  });
 });
 ```
 
@@ -269,11 +258,11 @@ import { initializeTelemetry, getTelemetryStatus } from "@juspay/neurolink";
 
 // Optional enterprise monitoring (zero overhead when disabled)
 const telemetry = initializeTelemetry({
-	serviceName: "my-ai-app",
-	endpoint: "http://localhost:4318",
-	enableTracing: true,
-	enableMetrics: true,
-	enableLogs: true,
+  serviceName: "my-ai-app",
+  endpoint: "http://localhost:4318",
+  enableTracing: true,
+  enableMetrics: true,
+  enableLogs: true,
 });
 
 // Check telemetry status
@@ -285,7 +274,7 @@ console.log("Version:", status.version);
 // All AI operations are now automatically monitored
 const provider = await createBestAIProvider();
 const result = await provider.generateText({
-	prompt: "Generate business report",
+  prompt: "Generate business report",
 });
 // Telemetry automatically tracks: response time, token usage, cost, errors
 ```
@@ -433,34 +422,34 @@ npx @juspay/neurolink batch prompts.txt --timeout 45s --output results.json
 ```typescript
 // SvelteKit API route with timeout handling
 export const POST: RequestHandler = async ({ request }) => {
-	const { message } = await request.json();
-	const provider = createBestAIProvider();
-
-	try {
-		const result = await provider.streamText({
-			prompt: message,
-			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 });
-		}
-		throw error;
-	}
+  const { message } = await request.json();
+  const provider = createBestAIProvider();
+
+  try {
+    const result = await provider.streamText({
+      prompt: message,
+      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 });
+    }
+    throw error;
+  }
 };
 
 // Next.js API route with timeout
 export async function POST(request: NextRequest) {
-	const { prompt } = await request.json();
-	const provider = createBestAIProvider();
+  const { prompt } = await request.json();
+  const provider = createBestAIProvider();
 
-	const result = await provider.generateText({
-		prompt,
-		timeout: process.env.AI_TIMEOUT || "30s", // Configurable timeout
-	});
+  const result = await provider.generateText({
+    prompt,
+    timeout: process.env.AI_TIMEOUT || "30s", // Configurable timeout
+  });
 
-	return NextResponse.json({ text: result.text });
+  return NextResponse.json({ text: result.text });
 }
 ```
 
@@ -559,27 +548,27 @@ const neurolink = new NeuroLink();
 
 // Add Bitbucket integration
 await neurolink.addMCPServer("bitbucket", {
-	command: "npx",
-	args: ["-y", "@nexus2520/bitbucket-mcp-server"],
-	env: {
-		BITBUCKET_USERNAME: "your-username",
-		BITBUCKET_APP_PASSWORD: "your-app-password",
-	},
+  command: "npx",
+  args: ["-y", "@nexus2520/bitbucket-mcp-server"],
+  env: {
+    BITBUCKET_USERNAME: "your-username",
+    BITBUCKET_APP_PASSWORD: "your-app-password",
+  },
 });
 
 // Add custom database connector
 await neurolink.addMCPServer("database", {
-	command: "node",
-	args: ["./custom-db-mcp-server.js"],
-	env: { DB_CONNECTION_STRING: "postgresql://..." },
+  command: "node",
+  args: ["./custom-db-mcp-server.js"],
+  env: { DB_CONNECTION_STRING: "postgresql://..." },
 });
 
 // Add any MCP-compatible server
 await neurolink.addMCPServer("slack-integration", {
-	command: "npx",
-	args: ["-y", "@slack/mcp-server"],
-	env: { SLACK_BOT_TOKEN: "xoxb-..." },
-	cwd: "/tmp",
+  command: "npx",
+  args: ["-y", "@slack/mcp-server"],
+  env: { SLACK_BOT_TOKEN: "xoxb-..." },
+  cwd: "/tmp",
 });
 
 // Verify servers are registered

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

@@ -4,5 +4,16 @@
  * Real MCP server connectivity and management
  */
 import type { Argv } from "yargs";
+interface MCPServerConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    transport: "stdio" | "sse";
+    url?: string;
+}
+export declare function executeMCPTool(serverConfig: MCPServerConfig, toolName: string, toolParams: any): Promise<any>;
 export declare function mcpExecuteTool(serverName: string, toolName: string, toolParams: any): Promise<any>;
 export declare function addMCPCommands(yargs: Argv): Argv;
+export {};