@juspay/neurolink 4.2.0 → 5.1.0

package/dist/lib/mcp/external-client.js

@@ -139,7 +139,7 @@ export class ExternalMCPClient extends EventEmitter {
             // Transform MCP response to NeuroLink format
             const result = {
                 success: !response.isError,
-                data: response.content || response.result || response,
+                data: response.text || response.result || response,
                 metadata: {
                     toolName,
                     serverId: this.config.name,
@@ -150,7 +150,7 @@ export class ExternalMCPClient extends EventEmitter {
                 },
             };
             if (response.isError) {
-                result.error = response.content?.[0]?.text || "Tool execution failed";
+                result.error = response.text?.[0]?.text || "Tool execution failed";
             }
             logger.debug(`[External MCP] Tool ${toolName} executed in ${executionTime}ms`);
             return result;

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

@@ -134,7 +134,7 @@ export interface MCPServerConfig {
  * });
  *
  * aiCoreServer.registerTool({
- *   name: 'generate-text',
+ *   name: 'generate',
  *   description: 'Generate text using AI providers',
  *   execute: async (params, context) => {
  *     // Tool implementation

package/dist/lib/mcp/factory.js

@@ -50,7 +50,7 @@ const ServerConfigSchema = z.object({
  * });
  *
  * aiCoreServer.registerTool({
- *   name: 'generate-text',
+ *   name: 'generate',
  *   description: 'Generate text using AI providers',
  *   execute: async (params, context) => {
  *     // Tool implementation

package/dist/lib/mcp/neurolink-mcp-client.js

@@ -94,14 +94,14 @@ Examples:
 
 Response (JSON object only):`;
         try {
-            const response = await this.provider.generateText({
+            const response = await this.provider.generate({
                 prompt: extractionPrompt,
                 temperature: 0,
                 maxTokens: 200,
             });
-            if (response?.text) {
+            if (response?.content) {
                 // Extract JSON object from response
-                const match = response.text.match(/\{([^}]*)\}/);
+                const match = response.content.match(/\{([^}]*)\}/);
                 if (match) {
                     try {
                         const params = JSON.parse(match[0]);
@@ -153,14 +153,14 @@ Examples:
 
 Response (JSON array only):`;
             try {
-                const response = await this.provider.generateText({
+                const response = await this.provider.generate({
                     prompt: analysisPrompt,
                     temperature: 0,
                     maxTokens: 200,
                 });
-                if (response?.text) {
+                if (response?.content) {
                     // Extract JSON array from response
-                    const match = response.text.match(/\[([^\]]*)\]/);
+                    const match = response.content.match(/\[([^\]]*)\]/);
                     if (match) {
                         try {
                             const toolNames = JSON.parse(match[0]);
@@ -317,8 +317,8 @@ Response (JSON array only):`;
     async generateResponse(prompt, toolResults) {
         // If no tools were used, generate regular response
         if (toolResults.length === 0) {
-            const response = await this.provider.generateText({ prompt });
-            return response?.text || "";
+            const response = await this.provider.generate({ prompt });
+            return response?.content || "";
         }
         // Extract human-readable results from tool executions
         const toolResultsText = toolResults
@@ -379,12 +379,12 @@ Tool results: ${toolResultsText}
 
 Please provide a natural response based on the tool results.`;
         // Generate final response
-        const response = await this.provider.generateText({
+        const response = await this.provider.generate({
             prompt: enhancedPrompt,
             temperature: 0.7,
             maxTokens: DEFAULT_MAX_TOKENS,
         });
-        return response?.text || toolResultsText;
+        return response?.content || toolResultsText;
     }
     /**
      * Send a prompt and automatically execute any needed tools

package/dist/lib/mcp/orchestrator.js

@@ -303,8 +303,8 @@ export class MCPOrchestrator {
             }
             // Step 2: Text generation
             steps.push({
-                stepId: "generate-text",
-                toolName: "generate-text",
+                stepId: "generate",
+                toolName: "generate",
                 params: {
                     prompt,
                     provider: options.provider,
@@ -324,7 +324,7 @@ export class MCPOrchestrator {
                         params: {
                         /* tool-specific params */
                         },
-                        dependsOn: ["generate-text"],
+                        dependsOn: ["generate"],
                     });
                 }
             }
@@ -336,7 +336,7 @@ export class MCPOrchestrator {
             });
             const executionTime = Date.now() - startTime;
             // Extract text generation result
-            const textResult = pipelineResult.results.get("generate-text");
+            const textResult = pipelineResult.results.get("generate");
             const providerResult = pipelineResult.results.get("select-provider");
             if (!textResult || !textResult.success) {
                 throw new Error("Text generation failed");

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

@@ -108,15 +108,15 @@ export const analyzeAIUsageTool = {
         - "analysis" should contain: timeRange, totalRequests, totalTokens, and a "providers" object.
         - "insights" should contain: mostUsedProvider, avgCostPerToken, peakUsageHours, costOptimizationPotential, and an array of "recommendations".
       `;
-            const result = await provider.generateText({
+            const result = await provider.generate({
                 prompt: analysisPrompt,
                 maxTokens: 800,
                 temperature: 0.5,
             });
-            if (!result || !result.text) {
+            if (!result || !result.content) {
                 throw new Error("AI provider returned no result for usage analysis.");
             }
-            const parsedData = JSON.parse(result.text);
+            const parsedData = JSON.parse(result.content);
             const executionTime = Date.now() - startTime;
             return {
                 success: true,
@@ -190,8 +190,8 @@ export const benchmarkProviderPerformanceTool = {
                 for (const prompt of testPrompts) {
                     for (let i = 0; i < params.iterations; i++) {
                         const testStartTime = Date.now();
-                        const result = await provider.generateText({
-                            prompt,
+                        const result = await provider.generate({
+                            prompt: prompt,
                             maxTokens: params.maxTokens,
                         });
                         if (result && result.usage) {
@@ -274,7 +274,7 @@ export const optimizePromptParametersTool = {
             const optimizationResults = [];
             const temperatures = [0.2, 0.7, 1.0]; // Test a range of temperatures
             for (const temp of temperatures) {
-                const result = await provider.generateText({
+                const result = await provider.generate({
                     prompt: params.prompt,
                     temperature: temp,
                     maxTokens: params.targetLength || 250,
@@ -282,7 +282,7 @@ export const optimizePromptParametersTool = {
                 if (result) {
                     optimizationResults.push({
                         parameters: { temperature: temp },
-                        output: result.text,
+                        output: result.content,
                         usage: result.usage,
                     });
                 }
@@ -300,14 +300,14 @@ export const optimizePromptParametersTool = {
         Determine which set of parameters is optimal and provide a recommendation.
         Return a valid JSON object with keys: "optimalParameters", "reasoning", "recommendations".
       `;
-            const analysisResult = await analysisProvider.generateText({
+            const analysisResult = await analysisProvider.generate({
                 prompt: analysisPrompt,
                 maxTokens: 500,
             });
-            if (!analysisResult || !analysisResult.text) {
+            if (!analysisResult || !analysisResult.content) {
                 throw new Error("Optimization analysis failed.");
             }
-            const parsedAnalysis = JSON.parse(analysisResult.text);
+            const parsedAnalysis = JSON.parse(analysisResult.content);
             const executionTime = Date.now() - startTime;
             return {
                 success: true,

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

@@ -75,7 +75,7 @@ const ProviderSelectionSchema = z.object({
  * Core tool that leverages existing AIProviderFactory for text generation
  */
 aiCoreServer.registerTool({
-    name: "generate-text",
+    name: "generate",
     description: "Generate text using AI providers with automatic fallback and provider selection",
     category: "text-generation",
     inputSchema: TextGenerationSchema,
@@ -88,7 +88,7 @@ aiCoreServer.registerTool({
             const selectedProvider = params.provider || (await getBestProvider(params.provider));
             const provider = await AIProviderFactory.createBestProvider(selectedProvider);
             // Generate text using existing NeuroLink patterns
-            const result = await provider.generateText({
+            const result = await provider.generate({
                 prompt: params.prompt,
                 model: params.model,
                 temperature: params.temperature,
@@ -103,7 +103,7 @@ aiCoreServer.registerTool({
             return {
                 success: true,
                 data: {
-                    text: result.text,
+                    text: result.content,
                     model: params.model || "default",
                     provider: selectedProvider,
                     generatedAt: new Date().toISOString(),
@@ -115,7 +115,7 @@ aiCoreServer.registerTool({
                     executionTime,
                 },
                 metadata: {
-                    toolName: "generate-text",
+                    toolName: "generate",
                     serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
@@ -131,7 +131,7 @@ aiCoreServer.registerTool({
                 success: false,
                 error: errorMessage,
                 metadata: {
-                    toolName: "generate-text",
+                    toolName: "generate",
                     serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),

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

@@ -88,14 +88,14 @@ export declare const workflowToolSchemas: {
     }, "strip", z.ZodTypeAny, {
         aiOutput: string;
         expectedBehavior: string;
-        outputType: "code" | "text" | "conversation" | "structured-data";
+        outputType: "text" | "code" | "conversation" | "structured-data";
         includeFixSuggestions: boolean;
         context?: string | undefined;
     }, {
         aiOutput: string;
         expectedBehavior: string;
         context?: string | undefined;
-        outputType?: "code" | "text" | "conversation" | "structured-data" | undefined;
+        outputType?: "text" | "code" | "conversation" | "structured-data" | undefined;
         includeFixSuggestions?: boolean | undefined;
     }>;
 };

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

@@ -144,16 +144,16 @@ Return ONLY a valid JSON object with this exact structure:
 }
 
 Generate 3-5 comprehensive test cases covering the requested types.`;
-            const result = await provider.generateText({
-                prompt,
+            const result = await provider.generate({
+                prompt: prompt,
                 maxTokens: Math.floor(DEFAULT_MAX_TOKENS * 1.2),
                 temperature: 0.3, // Lower temperature for more consistent structured output
             });
-            if (!result || !result.text) {
+            if (!result || !result.content) {
                 throw new Error("AI provider returned no result for test case generation.");
             }
             // Parse AI response
-            const aiResponse = JSON.parse(result.text);
+            const aiResponse = JSON.parse(result.content);
             const testCases = aiResponse.testCases || [];
             const executionTime = Date.now() - startTime;
             const responseData = {
@@ -250,16 +250,16 @@ Return ONLY a valid JSON object with this exact structure:
 }
 
 Focus on real, actionable improvements based on the specified objectives.`;
-            const result = await provider.generateText({
-                prompt,
+            const result = await provider.generate({
+                prompt: prompt,
                 maxTokens: DEFAULT_MAX_TOKENS,
                 temperature: 0.2, // Very low temperature for consistent refactoring
             });
-            if (!result || !result.text) {
+            if (!result || !result.content) {
                 throw new Error("AI provider returned no result for code refactoring.");
             }
             // Parse AI response
-            const aiResponse = JSON.parse(result.text);
+            const aiResponse = JSON.parse(result.content);
             const executionTime = Date.now() - startTime;
             const responseData = {
                 refactoredCode: aiResponse.refactoredCode || code,
@@ -358,16 +358,16 @@ Return ONLY a valid JSON object with this exact structure:
 }
 
 Focus on creating accurate, useful documentation that explains the code's purpose, parameters, return values, and usage patterns.`;
-            const result = await provider.generateText({
-                prompt,
+            const result = await provider.generate({
+                prompt: prompt,
                 maxTokens: Math.floor(DEFAULT_MAX_TOKENS * 1.2),
                 temperature: 0.3, // Moderate temperature for creative but structured documentation
             });
-            if (!result || !result.text) {
+            if (!result || !result.content) {
                 throw new Error("AI provider returned no result for documentation generation.");
             }
             // Parse AI response
-            const aiResponse = JSON.parse(result.text);
+            const aiResponse = JSON.parse(result.content);
             const executionTime = Date.now() - startTime;
             const responseData = {
                 documentation: aiResponse.documentation || "Documentation generated successfully",
@@ -483,16 +483,16 @@ Return ONLY a valid JSON object with this exact structure:
 }
 
 Provide thorough, actionable analysis focused on improving AI output quality.`;
-            const result = await provider.generateText({
-                prompt,
+            const result = await provider.generate({
+                prompt: prompt,
                 maxTokens: DEFAULT_MAX_TOKENS,
                 temperature: 0.4, // Moderate temperature for analytical thinking
             });
-            if (!result || !result.text) {
+            if (!result || !result.content) {
                 throw new Error("AI provider returned no result for output debugging.");
             }
             // Parse AI response
-            const aiResponse = JSON.parse(result.text);
+            const aiResponse = JSON.parse(result.content);
             const executionTime = Date.now() - startTime;
             const responseData = {
                 issues: aiResponse.issues || [],

package/dist/lib/neurolink.d.ts

@@ -4,66 +4,9 @@
  * Enhanced AI provider system with natural MCP tool access.
  * Uses real MCP infrastructure for tool discovery and execution.
  */
-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;
-    schema?: any;
-    timeout?: number | string;
-    disableTools?: boolean;
-    enableAnalytics?: boolean;
-    enableEvaluation?: boolean;
-    context?: Record<string, any>;
-    evaluationDomain?: string;
-    toolUsageContext?: string;
-    conversationHistory?: Array<{
-        role: string;
-        content: string;
-    }>;
-}
-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;
-    schema?: any;
-    timeout?: number | string;
-    disableTools?: boolean;
-    enableAnalytics?: boolean;
-    enableEvaluation?: boolean;
-    context?: Record<string, any>;
-}
-export interface TextGenerationResult {
-    content: string;
-    provider?: string;
-    model?: string;
-    usage?: {
-        promptTokens?: number;
-        completionTokens?: number;
-        totalTokens?: number;
-    };
-    responseTime?: number;
-    toolsUsed?: string[];
-    toolExecutions?: Array<{
-        toolName: string;
-        executionTime: number;
-        success: boolean;
-        serverId?: string;
-    }>;
-    enhancedWithTools?: boolean;
-    availableTools?: Array<{
-        name: string;
-        description: string;
-        server: string;
-        category?: string;
-    }>;
-}
+import type { AIProviderName, TextGenerationOptions, TextGenerationResult } from "./core/types.js";
+import type { GenerateOptions, GenerateResult } from "./types/generate-types.js";
+import type { StreamOptions, StreamResult } from "./types/stream-types.js";
 export declare class NeuroLink {
     private mcpInitialized;
     private contextManager;
@@ -78,26 +21,37 @@ export declare class NeuroLink {
      */
     private doIsolatedMCPInitialization;
     /**
-     * Generate text using the best available AI provider with automatic fallback
-     * Tools are ENABLED BY DEFAULT for natural AI behavior
+     * PRIMARY METHOD: Generate content using AI (recommended for new code)
+     * Future-ready for multi-modal capabilities with current text focus
+     */
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+    /**
+     * BACKWARD COMPATIBILITY: Legacy generateText method
+     * Internally calls generate() and converts result format
      */
     generateText(options: TextGenerationOptions): Promise<TextGenerationResult>;
     /**
      * Generate text with real MCP tool integration using automatic detection
      */
-    private generateTextWithTools;
+    private generateWithTools;
     /**
      * Regular text generation (existing logic)
      */
-    private generateTextRegular;
+    private generateRegular;
     /**
      * Create tool-aware system prompt that informs AI about available tools
      */
     private createToolAwareSystemPrompt;
     /**
-     * Generate streaming text using the best available AI provider with automatic fallback
+     * PRIMARY METHOD: Stream content using AI (recommended for new code)
+     * Future-ready for multi-modal capabilities with current text focus
+     */
+    stream(options: StreamOptions): Promise<StreamResult>;
+    /**
+     * BACKWARD COMPATIBILITY: Legacy streamText method
+     * Internally calls stream() and converts result format
      */
-    generateTextStream(options: StreamTextOptions): Promise<AsyncIterable<{
+    streamText(options: TextGenerationOptions): Promise<AsyncIterable<{
         content: string;
     }>>;
     /**
@@ -171,13 +125,7 @@ export declare class NeuroLink {
         timeout?: number;
     }): Promise<void>;
     /**
-     * Alias for generateText() - CLI-SDK consistency
-     * @param options - Text generation options
-     * @returns Promise resolving to text generation result
-     */
-    generate(options: TextGenerationOptions): Promise<TextGenerationResult>;
-    /**
-     * Short alias for generateText() - CLI-SDK consistency
+     * Short alias for generate() - CLI-SDK consistency
      * @param options - Text generation options
      * @returns Promise resolving to text generation result
      */