@juspay/neurolink 1.6.0 → 1.9.0

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

@@ -2,72 +2,115 @@
  * AI Development Workflow Tools
  * Phase 1.2 Implementation - 4 specialized tools for AI development lifecycle
  */
-import { z } from 'zod';
-import { AIProviderFactory } from '../../../core/factory.js';
-import { getBestProvider } from '../../../utils/providerUtils.js';
+import { z } from "zod";
+import { AIProviderFactory } from "../../../core/factory.js";
+import { getBestProvider } from "../../../utils/providerUtils.js";
 // Tool-specific schemas with comprehensive validation
 const generateTestCasesSchema = z.object({
-    codeFunction: z.string().min(1).describe('The function or code to generate test cases for'),
-    testTypes: z.array(z.enum(['unit', 'integration', 'edge-cases', 'performance', 'security']))
+    codeFunction: z
+        .string()
         .min(1)
-        .default(['unit', 'edge-cases'])
-        .describe('Types of test cases to generate'),
-    framework: z.enum(['jest', 'mocha', 'vitest', 'pytest', 'unittest', 'rspec'])
-        .default('jest')
-        .describe('Testing framework to target'),
-    coverageTarget: z.number().min(0).max(100).default(80).describe('Target test coverage percentage'),
-    includeAsyncTests: z.boolean().default(true).describe('Whether to include async test cases')
+        .describe("The function or code to generate test cases for"),
+    testTypes: z
+        .array(z.enum(["unit", "integration", "edge-cases", "performance", "security"]))
+        .min(1)
+        .default(["unit", "edge-cases"])
+        .describe("Types of test cases to generate"),
+    framework: z
+        .enum(["jest", "mocha", "vitest", "pytest", "unittest", "rspec"])
+        .default("jest")
+        .describe("Testing framework to target"),
+    coverageTarget: z
+        .number()
+        .min(0)
+        .max(100)
+        .default(80)
+        .describe("Target test coverage percentage"),
+    includeAsyncTests: z
+        .boolean()
+        .default(true)
+        .describe("Whether to include async test cases"),
 });
 const refactorCodeSchema = z.object({
-    code: z.string().min(1).describe('The code to refactor'),
-    language: z.string().default('javascript').describe('Programming language of the code'),
-    objectives: z.array(z.enum([
-        'readability',
-        'performance',
-        'maintainability',
-        'testability',
-        'modularity',
-        'dry-principle',
-        'solid-principles'
-    ])).default(['readability', 'maintainability']).describe('Refactoring objectives'),
-    preserveFunctionality: z.boolean().default(true).describe('Ensure functionality remains identical'),
-    styleGuide: z.string().optional().describe('Optional style guide to follow (e.g., airbnb, google)')
+    code: z.string().min(1).describe("The code to refactor"),
+    language: z
+        .string()
+        .default("javascript")
+        .describe("Programming language of the code"),
+    objectives: z
+        .array(z.enum([
+        "readability",
+        "performance",
+        "maintainability",
+        "testability",
+        "modularity",
+        "dry-principle",
+        "solid-principles",
+    ]))
+        .default(["readability", "maintainability"])
+        .describe("Refactoring objectives"),
+    preserveFunctionality: z
+        .boolean()
+        .default(true)
+        .describe("Ensure functionality remains identical"),
+    styleGuide: z
+        .string()
+        .optional()
+        .describe("Optional style guide to follow (e.g., airbnb, google)"),
 });
 const generateDocumentationSchema = z.object({
-    code: z.string().min(1).describe('The code to document'),
-    language: z.string().default('javascript').describe('Programming language of the code'),
-    documentationType: z.enum(['jsdoc', 'markdown', 'sphinx', 'doxygen', 'readme'])
-        .default('jsdoc')
-        .describe('Type of documentation to generate'),
-    includeExamples: z.boolean().default(true).describe('Whether to include usage examples'),
-    detailLevel: z.enum(['minimal', 'standard', 'comprehensive']).default('standard')
-        .describe('Level of documentation detail')
+    code: z.string().min(1).describe("The code to document"),
+    language: z
+        .string()
+        .default("javascript")
+        .describe("Programming language of the code"),
+    documentationType: z
+        .enum(["jsdoc", "markdown", "sphinx", "doxygen", "readme"])
+        .default("jsdoc")
+        .describe("Type of documentation to generate"),
+    includeExamples: z
+        .boolean()
+        .default(true)
+        .describe("Whether to include usage examples"),
+    detailLevel: z
+        .enum(["minimal", "standard", "comprehensive"])
+        .default("standard")
+        .describe("Level of documentation detail"),
 });
 const debugAIOutputSchema = z.object({
-    aiOutput: z.string().min(1).describe('The AI-generated output to debug'),
-    expectedBehavior: z.string().describe('Description of expected behavior or output'),
-    context: z.string().optional().describe('Additional context about the AI generation'),
-    outputType: z.enum(['code', 'text', 'structured-data', 'conversation'])
-        .default('text')
-        .describe('Type of AI output being debugged'),
-    includeFixSuggestions: z.boolean().default(true).describe('Whether to include fix suggestions')
+    aiOutput: z.string().min(1).describe("The AI-generated output to debug"),
+    expectedBehavior: z
+        .string()
+        .describe("Description of expected behavior or output"),
+    context: z
+        .string()
+        .optional()
+        .describe("Additional context about the AI generation"),
+    outputType: z
+        .enum(["code", "text", "structured-data", "conversation"])
+        .default("text")
+        .describe("Type of AI output being debugged"),
+    includeFixSuggestions: z
+        .boolean()
+        .default(true)
+        .describe("Whether to include fix suggestions"),
 });
 /**
  * Generate test cases for code functions
  */
 export const generateTestCasesTool = {
-    name: 'generate-test-cases',
-    description: 'Generate comprehensive test cases for code functions with various test types and frameworks',
-    category: 'ai-workflow',
+    name: "generate-test-cases",
+    description: "Generate comprehensive test cases for code functions with various test types and frameworks",
+    category: "ai-workflow",
     inputSchema: generateTestCasesSchema,
     isImplemented: true,
-    permissions: ['write'],
-    version: '2.0.0', // Updated version with real AI
+    permissions: ["write"],
+    version: "2.0.0", // Updated version with real AI
     execute: async (params, context) => {
         const startTime = Date.now();
         try {
             const validatedParams = generateTestCasesSchema.parse(params);
-            const { codeFunction, testTypes, framework, coverageTarget, includeAsyncTests } = validatedParams;
+            const { codeFunction, testTypes, framework, coverageTarget, includeAsyncTests, } = validatedParams;
             // Get AI provider for real test case generation
             const providerName = await getBestProvider();
             const provider = await AIProviderFactory.createProvider(providerName);
@@ -75,12 +118,12 @@ export const generateTestCasesTool = {
                 throw new Error(`Failed to create AI provider: ${providerName}`);
             }
             // Create structured prompt for test case generation
-            const prompt = `Generate ${testTypes.join(', ')} test cases for this ${framework} function:
+            const prompt = `Generate ${testTypes.join(", ")} test cases for this ${framework} function:
 
 ${codeFunction}
 
 Requirements:
-- Test types: ${testTypes.join(', ')}
+- Test types: ${testTypes.join(", ")}
 - Framework: ${framework}
 - Coverage target: ${coverageTarget}%
 - Include async tests: ${includeAsyncTests}
@@ -103,10 +146,10 @@ Generate 3-5 comprehensive test cases covering the requested types.`;
             const result = await provider.generateText({
                 prompt,
                 maxTokens: 1200,
-                temperature: 0.3 // Lower temperature for more consistent structured output
+                temperature: 0.3, // Lower temperature for more consistent structured output
             });
             if (!result || !result.text) {
-                throw new Error('AI provider returned no result for test case generation.');
+                throw new Error("AI provider returned no result for test case generation.");
             }
             // Parse AI response
             const aiResponse = JSON.parse(result.text);
@@ -119,7 +162,7 @@ Generate 3-5 comprehensive test cases covering the requested types.`;
                 totalTests: testCases.length,
                 totalAssertions: testCases.reduce((sum, tc) => sum + (tc.assertions || 1), 0),
                 generatedAt: new Date().toISOString(),
-                aiProvider: providerName
+                aiProvider: providerName,
             };
             return {
                 success: true,
@@ -128,15 +171,15 @@ Generate 3-5 comprehensive test cases covering the requested types.`;
                     ...result.usage,
                     executionTime,
                     provider: providerName,
-                    model: 'test-case-generator'
+                    model: "test-case-generator",
                 },
                 metadata: {
-                    toolName: 'generate-test-cases',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "generate-test-cases",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
         catch (error) {
@@ -146,27 +189,27 @@ Generate 3-5 comprehensive test cases covering the requested types.`;
                 success: false,
                 error: errorMessage,
                 metadata: {
-                    toolName: 'generate-test-cases',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "generate-test-cases",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
-    }
+    },
 };
 /**
  * Refactor code for improved quality
  */
 export const refactorCodeTool = {
-    name: 'refactor-code',
-    description: 'AI-powered code refactoring for improved readability, performance, and maintainability',
-    category: 'ai-workflow',
+    name: "refactor-code",
+    description: "AI-powered code refactoring for improved readability, performance, and maintainability",
+    category: "ai-workflow",
     inputSchema: refactorCodeSchema,
     isImplemented: true,
-    permissions: ['write'],
-    version: '2.0.0', // Updated version with real AI
+    permissions: ["write"],
+    version: "2.0.0", // Updated version with real AI
     execute: async (params, context) => {
         const startTime = Date.now();
         try {
@@ -179,7 +222,7 @@ export const refactorCodeTool = {
                 throw new Error(`Failed to create AI provider: ${providerName}`);
             }
             // Create structured prompt for code refactoring
-            const prompt = `Refactor this ${language} code focusing on: ${objectives.join(', ')}
+            const prompt = `Refactor this ${language} code focusing on: ${objectives.join(", ")}
 
 Original code:
 \`\`\`${language}
@@ -188,8 +231,8 @@ ${code}
 
 Requirements:
 - Language: ${language}
-- Objectives: ${objectives.join(', ')}
-- Style guide: ${styleGuide || 'standard best practices'}
+- Objectives: ${objectives.join(", ")}
+- Style guide: ${styleGuide || "standard best practices"}
 - Preserve functionality: ${preserveFunctionality}
 - Provide clean, production-ready code
 
@@ -209,23 +252,23 @@ Focus on real, actionable improvements based on the specified objectives.`;
             const result = await provider.generateText({
                 prompt,
                 maxTokens: 1000,
-                temperature: 0.2 // Very low temperature for consistent refactoring
+                temperature: 0.2, // Very low temperature for consistent refactoring
             });
             if (!result || !result.text) {
-                throw new Error('AI provider returned no result for code refactoring.');
+                throw new Error("AI provider returned no result for code refactoring.");
             }
             // Parse AI response
             const aiResponse = JSON.parse(result.text);
             const executionTime = Date.now() - startTime;
             const responseData = {
                 refactoredCode: aiResponse.refactoredCode || code,
-                changes: aiResponse.changes || ['Code refactored successfully'],
-                improvements: aiResponse.improvements || objectives.map(obj => `Improved ${obj}`),
+                changes: aiResponse.changes || ["Code refactored successfully"],
+                improvements: aiResponse.improvements || objectives.map((obj) => `Improved ${obj}`),
                 metrics: {
                     linesReduced: aiResponse.metrics?.linesReduced || 0,
                     complexityReduction: aiResponse.metrics?.complexityReduction || 15,
-                    readabilityScore: aiResponse.metrics?.readabilityScore || 85
-                }
+                    readabilityScore: aiResponse.metrics?.readabilityScore || 85,
+                },
             };
             return {
                 success: true,
@@ -235,21 +278,21 @@ Focus on real, actionable improvements based on the specified objectives.`;
                     language,
                     objectives,
                     generatedAt: new Date().toISOString(),
-                    aiProvider: providerName
+                    aiProvider: providerName,
                 },
                 usage: {
                     ...result.usage,
                     executionTime,
                     provider: providerName,
-                    model: 'code-refactorer'
+                    model: "code-refactorer",
                 },
                 metadata: {
-                    toolName: 'refactor-code',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "refactor-code",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
         catch (error) {
@@ -259,32 +302,32 @@ Focus on real, actionable improvements based on the specified objectives.`;
                 success: false,
                 error: errorMessage,
                 metadata: {
-                    toolName: 'refactor-code',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "refactor-code",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
-    }
+    },
 };
 /**
  * Generate documentation from code
  */
 export const generateDocumentationTool = {
-    name: 'generate-documentation',
-    description: 'Automatically generate comprehensive documentation from code',
-    category: 'ai-workflow',
+    name: "generate-documentation",
+    description: "Automatically generate comprehensive documentation from code",
+    category: "ai-workflow",
     inputSchema: generateDocumentationSchema,
     isImplemented: true,
-    permissions: ['read'],
-    version: '2.0.0', // Updated version with real AI
+    permissions: ["read"],
+    version: "2.0.0", // Updated version with real AI
     execute: async (params, context) => {
         const startTime = Date.now();
         try {
             const validatedParams = generateDocumentationSchema.parse(params);
-            const { code, language, documentationType, includeExamples, detailLevel } = validatedParams;
+            const { code, language, documentationType, includeExamples, detailLevel, } = validatedParams;
             // Get AI provider for real documentation generation
             const providerName = await getBestProvider();
             const provider = await AIProviderFactory.createProvider(providerName);
@@ -309,7 +352,7 @@ Return ONLY a valid JSON object with this exact structure:
 {
   "documentation": "formatted documentation string in ${documentationType} format",
   "sections": ["list of documentation sections included"],
-  "examples": ${includeExamples ? '["code examples with usage"]' : '[]'},
+  "examples": ${includeExamples ? '["code examples with usage"]' : "[]"},
   "coverage": percentage_number_representing_documentation_completeness
 }
 
@@ -317,19 +360,24 @@ Focus on creating accurate, useful documentation that explains the code's purpos
             const result = await provider.generateText({
                 prompt,
                 maxTokens: 1200,
-                temperature: 0.3 // Moderate temperature for creative but structured documentation
+                temperature: 0.3, // Moderate temperature for creative but structured documentation
             });
             if (!result || !result.text) {
-                throw new Error('AI provider returned no result for documentation generation.');
+                throw new Error("AI provider returned no result for documentation generation.");
             }
             // Parse AI response
             const aiResponse = JSON.parse(result.text);
             const executionTime = Date.now() - startTime;
             const responseData = {
-                documentation: aiResponse.documentation || 'Documentation generated successfully',
-                sections: aiResponse.sections || ['Overview'],
+                documentation: aiResponse.documentation || "Documentation generated successfully",
+                sections: aiResponse.sections || ["Overview"],
                 examples: aiResponse.examples || [],
-                coverage: aiResponse.coverage || (detailLevel === 'comprehensive' ? 95 : detailLevel === 'standard' ? 80 : 60)
+                coverage: aiResponse.coverage ||
+                    (detailLevel === "comprehensive"
+                        ? 95
+                        : detailLevel === "standard"
+                            ? 80
+                            : 60),
             };
             return {
                 success: true,
@@ -341,21 +389,21 @@ Focus on creating accurate, useful documentation that explains the code's purpos
                     detailLevel,
                     includeExamples,
                     generatedAt: new Date().toISOString(),
-                    aiProvider: providerName
+                    aiProvider: providerName,
                 },
                 usage: {
                     ...result.usage,
                     executionTime,
                     provider: providerName,
-                    model: 'documentation-generator'
+                    model: "documentation-generator",
                 },
                 metadata: {
-                    toolName: 'generate-documentation',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "generate-documentation",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
         catch (error) {
@@ -365,32 +413,32 @@ Focus on creating accurate, useful documentation that explains the code's purpos
                 success: false,
                 error: errorMessage,
                 metadata: {
-                    toolName: 'generate-documentation',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "generate-documentation",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
-    }
+    },
 };
 /**
  * Debug AI-generated output
  */
 export const debugAIOutputTool = {
-    name: 'debug-ai-output',
-    description: 'Analyze and debug AI-generated output to identify issues and suggest improvements',
-    category: 'ai-workflow',
+    name: "debug-ai-output",
+    description: "Analyze and debug AI-generated output to identify issues and suggest improvements",
+    category: "ai-workflow",
     inputSchema: debugAIOutputSchema,
     isImplemented: true,
-    permissions: ['read', 'analytics'],
-    version: '2.0.0', // Updated version with real AI
+    permissions: ["read", "analytics"],
+    version: "2.0.0", // Updated version with real AI
     execute: async (params, context) => {
         const startTime = Date.now();
         try {
             const validatedParams = debugAIOutputSchema.parse(params);
-            const { aiOutput, expectedBehavior, context: debugContext, outputType, includeFixSuggestions } = validatedParams;
+            const { aiOutput, expectedBehavior, context: debugContext, outputType, includeFixSuggestions, } = validatedParams;
             // Get AI provider for real output analysis
             const providerName = await getBestProvider();
             const provider = await AIProviderFactory.createProvider(providerName);
@@ -408,7 +456,7 @@ ${aiOutput}
 Expected Behavior:
 ${expectedBehavior}
 
-Context: ${debugContext || 'None provided'}
+Context: ${debugContext || "None provided"}
 Output Type: ${outputType}
 Include Fix Suggestions: ${includeFixSuggestions}
 
@@ -430,26 +478,31 @@ Return ONLY a valid JSON object with this exact structure:
   ],
   "suggestions": ["actionable improvement suggestion 1", "suggestion 2"],
   "possibleCauses": ["potential cause 1", "potential cause 2"],
-  "fixedOutput": ${includeFixSuggestions ? '"corrected version if possible"' : 'null'}
+  "fixedOutput": ${includeFixSuggestions ? '"corrected version if possible"' : "null"}
 }
 
 Provide thorough, actionable analysis focused on improving AI output quality.`;
             const result = await provider.generateText({
                 prompt,
                 maxTokens: 1000,
-                temperature: 0.4 // Moderate temperature for analytical thinking
+                temperature: 0.4, // Moderate temperature for analytical thinking
             });
             if (!result || !result.text) {
-                throw new Error('AI provider returned no result for output debugging.');
+                throw new Error("AI provider returned no result for output debugging.");
             }
             // Parse AI response
             const aiResponse = JSON.parse(result.text);
             const executionTime = Date.now() - startTime;
             const responseData = {
                 issues: aiResponse.issues || [],
-                suggestions: aiResponse.suggestions || ['Consider refining the prompt for clearer instructions'],
-                possibleCauses: aiResponse.possibleCauses || ['Prompt clarity', 'Model limitations'],
-                fixedOutput: aiResponse.fixedOutput || undefined
+                suggestions: aiResponse.suggestions || [
+                    "Consider refining the prompt for clearer instructions",
+                ],
+                possibleCauses: aiResponse.possibleCauses || [
+                    "Prompt clarity",
+                    "Model limitations",
+                ],
+                fixedOutput: aiResponse.fixedOutput || undefined,
             };
             return {
                 success: true,
@@ -460,21 +513,21 @@ Provide thorough, actionable analysis focused on improving AI output quality.`;
                     outputType,
                     analysisContext: debugContext,
                     generatedAt: new Date().toISOString(),
-                    aiProvider: providerName
+                    aiProvider: providerName,
                 },
                 usage: {
                     ...result.usage,
                     executionTime,
                     provider: providerName,
-                    model: 'ai-output-debugger'
+                    model: "ai-output-debugger",
                 },
                 metadata: {
-                    toolName: 'debug-ai-output',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "debug-ai-output",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
         catch (error) {
@@ -484,28 +537,30 @@ Provide thorough, actionable analysis focused on improving AI output quality.`;
                 success: false,
                 error: errorMessage,
                 metadata: {
-                    toolName: 'debug-ai-output',
-                    serverId: 'neurolink-ai-core',
+                    toolName: "debug-ai-output",
+                    serverId: "neurolink-ai-core",
                     sessionId: context.sessionId,
                     timestamp: Date.now(),
-                    executionTime
-                }
+                    executionTime,
+                },
             };
         }
-    }
+    },
 };
 // Helper functions
 function extractFunctionName(code) {
     const match = code.match(/function\s+(\w+)|const\s+(\w+)\s*=|(\w+)\s*\(/);
-    return match ? (match[1] || match[2] || match[3] || 'processData') : 'processData';
+    return match
+        ? match[1] || match[2] || match[3] || "processData"
+        : "processData";
 }
 function simulateRefactoring(code, objectives, styleGuide) {
     // Simulate basic refactoring
     let refactored = code;
-    if (objectives.includes('readability')) {
-        refactored = refactored.replace(/([a-z])([A-Z])/g, '$1 $2');
+    if (objectives.includes("readability")) {
+        refactored = refactored.replace(/([a-z])([A-Z])/g, "$1 $2");
     }
-    if (objectives.includes('dry-principle')) {
+    if (objectives.includes("dry-principle")) {
         refactored = `// Extracted common functionality\nconst CONSTANTS = { MAX_RETRIES: 3, TIMEOUT: 5000 };\n\n${refactored}`;
     }
     return refactored;
@@ -515,12 +570,12 @@ export const aiWorkflowTools = [
     generateTestCasesTool,
     refactorCodeTool,
     generateDocumentationTool,
-    debugAIOutputTool
+    debugAIOutputTool,
 ];
 // Export schemas for external validation
 export const workflowToolSchemas = {
-    'generate-test-cases': generateTestCasesSchema,
-    'refactor-code': refactorCodeSchema,
-    'generate-documentation': generateDocumentationSchema,
-    'debug-ai-output': debugAIOutputSchema
+    "generate-test-cases": generateTestCasesSchema,
+    "refactor-code": refactorCodeSchema,
+    "generate-documentation": generateDocumentationSchema,
+    "debug-ai-output": debugAIOutputSchema,
 };

package/dist/lib/mcp/servers/utilities/utility-server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * NeuroLink Utility Server
+ * Provides general utility tools following Lighthouse patterns
+ */
+/**
+ * Utility Server - General utility tools
+ */
+export declare const utilityServer: import("../../factory.js").NeuroLinkMCPServer;