@juspay/neurolink 7.13.0 → 7.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (132) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +89 -25
  3. package/dist/agent/directTools.d.ts +3 -3
  4. package/dist/agent/directTools.js +1 -1
  5. package/dist/cli/commands/mcp.js +67 -207
  6. package/dist/cli/factories/commandFactory.js +7 -1
  7. package/dist/cli/utils/interactiveSetup.js +1 -1
  8. package/dist/config/conversationMemoryConfig.js +2 -1
  9. package/dist/context/ContextManager.js +15 -4
  10. package/dist/context/config.js +5 -1
  11. package/dist/context/utils.js +1 -1
  12. package/dist/core/baseProvider.d.ts +11 -30
  13. package/dist/core/baseProvider.js +268 -42
  14. package/dist/core/conversationMemoryManager.js +3 -2
  15. package/dist/core/dynamicModels.d.ts +14 -14
  16. package/dist/core/dynamicModels.js +1 -1
  17. package/dist/core/evaluation.js +1 -1
  18. package/dist/core/factory.js +1 -1
  19. package/dist/factories/providerFactory.js +5 -11
  20. package/dist/factories/providerRegistry.js +2 -2
  21. package/dist/index.d.ts +5 -4
  22. package/dist/index.js +1 -1
  23. package/dist/lib/agent/directTools.js +1 -1
  24. package/dist/lib/config/conversationMemoryConfig.js +2 -1
  25. package/dist/lib/context/ContextManager.js +15 -4
  26. package/dist/lib/context/config.js +5 -1
  27. package/dist/lib/context/utils.js +1 -1
  28. package/dist/lib/core/baseProvider.d.ts +11 -30
  29. package/dist/lib/core/baseProvider.js +268 -42
  30. package/dist/lib/core/conversationMemoryManager.js +3 -2
  31. package/dist/lib/core/dynamicModels.js +1 -1
  32. package/dist/lib/core/evaluation.js +1 -1
  33. package/dist/lib/core/factory.js +1 -1
  34. package/dist/lib/factories/providerFactory.js +5 -11
  35. package/dist/lib/factories/providerRegistry.js +2 -2
  36. package/dist/lib/index.d.ts +5 -4
  37. package/dist/lib/index.js +1 -1
  38. package/dist/lib/mcp/externalServerManager.d.ts +148 -0
  39. package/dist/lib/mcp/externalServerManager.js +1038 -0
  40. package/dist/lib/mcp/mcpCircuitBreaker.d.ts +184 -0
  41. package/dist/lib/mcp/mcpCircuitBreaker.js +338 -0
  42. package/dist/lib/mcp/mcpClientFactory.d.ts +105 -0
  43. package/dist/lib/mcp/mcpClientFactory.js +421 -0
  44. package/dist/lib/mcp/toolDiscoveryService.d.ts +193 -0
  45. package/dist/lib/mcp/toolDiscoveryService.js +646 -0
  46. package/dist/lib/mcp/toolRegistry.d.ts +15 -11
  47. package/dist/lib/mcp/toolRegistry.js +118 -55
  48. package/dist/lib/models/modelResolver.js +1 -1
  49. package/dist/lib/neurolink.d.ts +139 -43
  50. package/dist/lib/neurolink.js +604 -174
  51. package/dist/lib/providers/googleVertex.d.ts +7 -1
  52. package/dist/lib/providers/googleVertex.js +34 -7
  53. package/dist/lib/providers/huggingFace.js +1 -1
  54. package/dist/lib/providers/mistral.js +3 -3
  55. package/dist/lib/providers/ollama.js +1 -1
  56. package/dist/lib/providers/openAI.d.ts +3 -2
  57. package/dist/lib/providers/openAI.js +2 -2
  58. package/dist/lib/providers/openaiCompatible.d.ts +1 -1
  59. package/dist/lib/providers/openaiCompatible.js +2 -2
  60. package/dist/lib/providers/sagemaker/config.js +1 -1
  61. package/dist/lib/sdk/toolRegistration.d.ts +4 -13
  62. package/dist/lib/sdk/toolRegistration.js +19 -66
  63. package/dist/lib/types/cli.d.ts +0 -1
  64. package/dist/lib/types/cli.js +0 -1
  65. package/dist/lib/types/common.d.ts +1 -2
  66. package/dist/lib/types/common.js +0 -1
  67. package/dist/lib/types/contextTypes.d.ts +1 -1
  68. package/dist/lib/types/contextTypes.js +3 -3
  69. package/dist/lib/types/externalMcp.d.ts +288 -0
  70. package/dist/lib/types/externalMcp.js +7 -0
  71. package/dist/lib/types/generateTypes.d.ts +0 -1
  72. package/dist/lib/types/index.d.ts +2 -2
  73. package/dist/lib/types/index.js +0 -1
  74. package/dist/lib/types/mcpTypes.d.ts +53 -99
  75. package/dist/lib/types/providers.d.ts +0 -1
  76. package/dist/lib/types/providers.js +0 -1
  77. package/dist/lib/types/tools.d.ts +2 -2
  78. package/dist/lib/types/tools.js +2 -2
  79. package/dist/lib/utils/factoryProcessing.js +1 -1
  80. package/dist/lib/utils/mcpDefaults.d.ts +54 -0
  81. package/dist/lib/utils/mcpDefaults.js +125 -0
  82. package/dist/lib/utils/providerConfig.d.ts +1 -1
  83. package/dist/lib/utils/providerConfig.js +2 -2
  84. package/dist/lib/utils/providerHealth.js +6 -6
  85. package/dist/mcp/externalServerManager.d.ts +148 -0
  86. package/dist/mcp/externalServerManager.js +1038 -0
  87. package/dist/mcp/mcpCircuitBreaker.d.ts +184 -0
  88. package/dist/mcp/mcpCircuitBreaker.js +338 -0
  89. package/dist/mcp/mcpClientFactory.d.ts +105 -0
  90. package/dist/mcp/mcpClientFactory.js +421 -0
  91. package/dist/mcp/toolDiscoveryService.d.ts +193 -0
  92. package/dist/mcp/toolDiscoveryService.js +646 -0
  93. package/dist/mcp/toolRegistry.d.ts +15 -11
  94. package/dist/mcp/toolRegistry.js +118 -55
  95. package/dist/models/modelResolver.js +1 -1
  96. package/dist/neurolink.d.ts +139 -43
  97. package/dist/neurolink.js +604 -174
  98. package/dist/providers/googleVertex.d.ts +7 -1
  99. package/dist/providers/googleVertex.js +34 -7
  100. package/dist/providers/huggingFace.js +1 -1
  101. package/dist/providers/mistral.js +3 -3
  102. package/dist/providers/ollama.js +1 -1
  103. package/dist/providers/openAI.d.ts +3 -2
  104. package/dist/providers/openAI.js +2 -2
  105. package/dist/providers/openaiCompatible.d.ts +1 -1
  106. package/dist/providers/openaiCompatible.js +2 -2
  107. package/dist/providers/sagemaker/config.js +1 -1
  108. package/dist/sdk/toolRegistration.d.ts +4 -13
  109. package/dist/sdk/toolRegistration.js +19 -66
  110. package/dist/types/cli.d.ts +0 -1
  111. package/dist/types/cli.js +0 -1
  112. package/dist/types/common.d.ts +1 -2
  113. package/dist/types/common.js +0 -1
  114. package/dist/types/contextTypes.d.ts +1 -1
  115. package/dist/types/contextTypes.js +3 -3
  116. package/dist/types/externalMcp.d.ts +288 -0
  117. package/dist/types/externalMcp.js +7 -0
  118. package/dist/types/generateTypes.d.ts +0 -1
  119. package/dist/types/index.d.ts +2 -2
  120. package/dist/types/index.js +0 -1
  121. package/dist/types/mcpTypes.d.ts +53 -99
  122. package/dist/types/providers.d.ts +0 -1
  123. package/dist/types/providers.js +0 -1
  124. package/dist/types/tools.d.ts +2 -2
  125. package/dist/types/tools.js +2 -2
  126. package/dist/utils/factoryProcessing.js +1 -1
  127. package/dist/utils/mcpDefaults.d.ts +54 -0
  128. package/dist/utils/mcpDefaults.js +125 -0
  129. package/dist/utils/providerConfig.d.ts +1 -1
  130. package/dist/utils/providerConfig.js +2 -2
  131. package/dist/utils/providerHealth.js +6 -6
  132. package/package.json +1 -1
@@ -0,0 +1,125 @@
1
+ /**
2
+ * Smart Defaults for MCPServerInfo Creation
3
+ * Eliminates boilerplate manual object creation
4
+ */
5
+ /**
6
+ * Smart category detection based on context
7
+ */
8
+ export function detectCategory(context) {
9
+ // If category is already provided, validate and use it
10
+ if (context.existingCategory) {
11
+ const validCategories = [
12
+ "external",
13
+ "in-memory",
14
+ "built-in",
15
+ "user-defined",
16
+ ];
17
+ if (validCategories.includes(context.existingCategory)) {
18
+ return context.existingCategory;
19
+ }
20
+ }
21
+ // Smart detection based on context
22
+ if (context.isCustomTool) {
23
+ return "user-defined";
24
+ }
25
+ if (context.isBuiltIn) {
26
+ return "built-in";
27
+ }
28
+ if (context.isExternal) {
29
+ return "external";
30
+ }
31
+ if (context.serverId?.startsWith("custom-tool-")) {
32
+ return "user-defined";
33
+ }
34
+ if (context.serverId?.includes("external")) {
35
+ return "external";
36
+ }
37
+ if (context.serverId === "direct") {
38
+ return "built-in";
39
+ }
40
+ // Default to in-memory for most cases
41
+ return "in-memory";
42
+ }
43
+ /**
44
+ * Generate smart description based on name and category
45
+ */
46
+ function generateDescription(name, category) {
47
+ // Generate descriptions based on category for better context
48
+ switch (category) {
49
+ case "external":
50
+ return `External MCP server: ${name}`;
51
+ case "built-in":
52
+ return `Built-in tool server: ${name}`;
53
+ case "custom":
54
+ case "user-defined":
55
+ return `Custom tool server: ${name}`;
56
+ case "in-memory":
57
+ return `In-memory MCP server: ${name}`;
58
+ default:
59
+ return name;
60
+ }
61
+ }
62
+ /**
63
+ * Create MCPServerInfo with smart defaults
64
+ * Eliminates manual boilerplate object creation
65
+ */
66
+ export function createMCPServerInfo(options) {
67
+ const id = options.id || `server-${options.name}`;
68
+ const category = options.category ||
69
+ detectCategory({
70
+ isCustomTool: options.isCustomTool,
71
+ isExternal: options.isExternal,
72
+ isBuiltIn: options.isBuiltIn,
73
+ serverId: id,
74
+ });
75
+ const tools = options.tools || (options.tool ? [options.tool] : []);
76
+ return {
77
+ id,
78
+ name: options.name,
79
+ transport: options.transport || "stdio",
80
+ status: options.status || "connected",
81
+ tools,
82
+ description: options.description || generateDescription(options.name, category),
83
+ ...(options.command && { command: options.command }),
84
+ ...(options.args && { args: options.args }),
85
+ ...(options.env && { env: options.env }),
86
+ metadata: {
87
+ category: category,
88
+ toolCount: tools.length,
89
+ },
90
+ };
91
+ }
92
+ /**
93
+ * Create MCPServerInfo for custom tool registration
94
+ * Specialized version with smart defaults for registerTool usage
95
+ */
96
+ export function createCustomToolServerInfo(toolName, tool) {
97
+ return createMCPServerInfo({
98
+ id: `custom-tool-${toolName}`,
99
+ name: toolName,
100
+ tool: {
101
+ name: toolName,
102
+ description: tool.description || toolName,
103
+ inputSchema: tool.inputSchema || {},
104
+ execute: tool.execute,
105
+ },
106
+ isCustomTool: true,
107
+ });
108
+ }
109
+ /**
110
+ * Create MCPServerInfo for external servers
111
+ * Specialized version with smart defaults for external server usage
112
+ */
113
+ export function createExternalServerInfo(options) {
114
+ return createMCPServerInfo({
115
+ id: options.id,
116
+ name: options.name || options.id,
117
+ tools: options.tools || [],
118
+ transport: options.transport || "stdio",
119
+ description: options.description || options.name || options.id,
120
+ isExternal: true,
121
+ command: options.command,
122
+ args: options.args,
123
+ env: options.env,
124
+ });
125
+ }
@@ -56,7 +56,7 @@ export declare function getProviderModel(envVar: string, defaultModel: string):
56
56
  /**
57
57
  * Checks if provider credentials are available
58
58
  * @param envVars Array of environment variable names to check
59
- * @returns True if any of the credentials are available
59
+ * @returns True if one of the credentials is available
60
60
  */
61
61
  export declare function hasProviderCredentials(envVars: string[]): boolean;
62
62
  /**
@@ -135,7 +135,7 @@ export function getProviderModel(envVar, defaultModel) {
135
135
  /**
136
136
  * Checks if provider credentials are available
137
137
  * @param envVars Array of environment variable names to check
138
- * @returns True if any of the credentials are available
138
+ * @returns True if one of the credentials is available
139
139
  */
140
140
  export function hasProviderCredentials(envVars) {
141
141
  return envVars.some((envVar) => !!process.env[envVar]);
@@ -286,7 +286,7 @@ export function createOpenAICompatibleConfig() {
286
286
  "1. Set OPENAI_COMPATIBLE_BASE_URL to your endpoint (e.g., https://api.openrouter.ai/api/v1)",
287
287
  "2. Get API key from your OpenAI-compatible service:",
288
288
  " • OpenRouter: https://openrouter.ai/keys",
289
- " • vLLM: Use any value for local deployments",
289
+ " • vLLM: Use a random value for local deployments",
290
290
  " • LiteLLM: Check your LiteLLM server configuration",
291
291
  "3. Set OPENAI_COMPATIBLE_API_KEY to your API key",
292
292
  "4. Optionally set OPENAI_COMPATIBLE_MODEL (will auto-discover if not set)",
@@ -487,13 +487,13 @@ export class ProviderHealthChecker {
487
487
  return provider;
488
488
  }
489
489
  }
490
- // Fallback to any healthy provider
491
- const anyHealthy = healthStatuses.find((h) => h.isHealthy);
492
- if (anyHealthy) {
493
- logger.info(`Using fallback healthy provider: ${anyHealthy.provider}`);
494
- return anyHealthy.provider;
490
+ // Fallback to first healthy provider
491
+ const firstHealthyProvider = healthStatuses.find((h) => h.isHealthy);
492
+ if (firstHealthyProvider) {
493
+ logger.info(`Using fallback healthy provider: ${firstHealthyProvider.provider}`);
494
+ return firstHealthyProvider.provider;
495
495
  }
496
- // Last resort: any configured provider
496
+ // Last resort: first configured provider
497
497
  const anyConfigured = healthStatuses.find((h) => h.isConfigured);
498
498
  if (anyConfigured) {
499
499
  logger.warn(`Using configured but potentially unhealthy provider: ${anyConfigured.provider}`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@juspay/neurolink",
3
- "version": "7.13.0",
3
+ "version": "7.14.1",
4
4
  "description": "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.",
5
5
  "author": {
6
6
  "name": "Juspay Technologies",