@juspay/neurolink 5.1.0 → 5.2.0

package/dist/types/stream-types.d.ts

@@ -1,6 +1,25 @@
 import type { ZodType, ZodTypeDef } from "zod";
 import type { Tool, Schema } from "ai";
 import type { AIProviderName, AnalyticsData, EvaluationData } from "../core/types.js";
+/**
+ * Interface for tool execution calls
+ */
+export interface ToolCall {
+    toolName: string;
+    parameters: Record<string, any>;
+    id?: string;
+}
+/**
+ * Interface for tool execution results
+ */
+export interface ToolResult {
+    toolName: string;
+    status: "success" | "failure";
+    output?: any;
+    error?: string;
+    id?: string;
+    executionTime?: number;
+}
 /**
  * Stream function options interface - Primary method for streaming content
  * Future-ready for multi-modal capabilities while maintaining text focus
@@ -26,6 +45,7 @@ export interface StreamOptions {
     tools?: Record<string, Tool>;
     timeout?: number | string;
     disableTools?: boolean;
+    maxSteps?: number;
     enableEvaluation?: boolean;
     enableAnalytics?: boolean;
     context?: Record<string, any>;
@@ -46,30 +66,22 @@ export interface StreamResult {
     }>;
     provider?: string;
     model?: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+    finishReason?: string;
+    toolCalls?: ToolCall[];
+    toolResults?: ToolResult[];
     metadata?: {
         streamId?: string;
         startTime?: number;
         totalChunks?: number;
         estimatedDuration?: number;
+        responseTime?: number;
+        fallback?: boolean;
     };
-    toolCalls?: Array<{
-        toolCallId: string;
-        toolName: string;
-        args: Record<string, any>;
-    }>;
-    toolsUsed?: string[];
-    toolExecutions?: Array<{
-        name: string;
-        input: Record<string, any>;
-        output: any;
-        duration: number;
-    }>;
-    enhancedWithTools?: boolean;
-    availableTools?: Array<{
-        name: string;
-        description: string;
-        parameters: Record<string, any>;
-    }>;
     analytics?: AnalyticsData;
     evaluation?: EvaluationData;
 }

package/dist/types/universal-provider-options.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Universal Provider Options Interface (Phase 1: Factory Pattern)
+ * Based on TypeScript factory pattern best practices for AI provider abstraction
+ */
+/**
+ * Base configuration interface for all AI providers
+ * Uses Parameter Object Pattern for flexible, extensible configuration
+ */
+export interface UniversalProviderOptions {
+    prompt?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt?: string;
+    enableAnalytics?: boolean;
+    enableEvaluation?: boolean;
+    context?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    extensionOptions?: Record<string, unknown>;
+}
+/**
+ * Generic provider options (without providerType)
+ */
+export type GenericProviderOptions = Omit<UniversalProviderOptions, "providerType">;
+/**
+ * Provider-specific configuration extensions
+ * Discriminated union pattern for type-safe provider configs
+ */
+export interface OpenAIProviderOptions extends UniversalProviderOptions {
+    providerType: "openai";
+    organization?: string;
+    seed?: number;
+    topP?: number;
+}
+export interface GoogleAIProviderOptions extends UniversalProviderOptions {
+    providerType: "google-ai";
+    topK?: number;
+    candidateCount?: number;
+    stopSequences?: string[];
+}
+export interface AnthropicProviderOptions extends UniversalProviderOptions {
+    providerType: "anthropic";
+    topK?: number;
+    stopSequences?: string[];
+}
+export interface BedrockProviderOptions extends UniversalProviderOptions {
+    providerType: "bedrock";
+    inferenceProfileArn?: string;
+    region?: string;
+}
+/**
+ * Discriminated union for type-safe provider configuration
+ * Enables compile-time type checking for provider-specific options
+ */
+export type ProviderSpecificOptions = OpenAIProviderOptions | GoogleAIProviderOptions | AnthropicProviderOptions | BedrockProviderOptions;
+/**
+ * Factory configuration interface
+ * Supports both universal and provider-specific parameters
+ */
+export interface ProviderFactoryConfig {
+    providerName: string;
+    modelName?: string;
+    options?: UniversalProviderOptions | ProviderSpecificOptions;
+    enableMCP?: boolean;
+}
+/**
+ * Parameter normalization utilities
+ * Converts between different parameter formats for backward compatibility
+ */
+export declare class ParameterNormalizer {
+    /**
+     * Normalize legacy parameter formats to universal format
+     */
+    static normalizeToUniversal(optionsOrPrompt: UniversalProviderOptions | string): UniversalProviderOptions;
+    /**
+     * Retrieve the provider type if it exists, otherwise return null
+     */
+    private static getProviderType;
+    /**
+     * Extract provider-specific parameters safely
+     */
+    static extractProviderOptions<T extends ProviderSpecificOptions>(options: UniversalProviderOptions | ProviderSpecificOptions, providerType: T["providerType"]): T | GenericProviderOptions;
+    /**
+     * Merge default values with user-provided options
+     */
+    static mergeWithDefaults(options: UniversalProviderOptions, defaults: Partial<UniversalProviderOptions>): UniversalProviderOptions;
+}

package/dist/types/universal-provider-options.js

@@ -0,0 +1,53 @@
+/**
+ * Universal Provider Options Interface (Phase 1: Factory Pattern)
+ * Based on TypeScript factory pattern best practices for AI provider abstraction
+ */
+/**
+ * Parameter normalization utilities
+ * Converts between different parameter formats for backward compatibility
+ */
+export class ParameterNormalizer {
+    /**
+     * Normalize legacy parameter formats to universal format
+     */
+    static normalizeToUniversal(optionsOrPrompt) {
+        if (typeof optionsOrPrompt === "string") {
+            return { prompt: optionsOrPrompt };
+        }
+        return optionsOrPrompt;
+    }
+    /**
+     * Retrieve the provider type if it exists, otherwise return null
+     */
+    static getProviderType(options) {
+        return "providerType" in options ? options.providerType : null;
+    }
+    /**
+     * Extract provider-specific parameters safely
+     */
+    static extractProviderOptions(options, providerType) {
+        const currentProviderType = ParameterNormalizer.getProviderType(options);
+        if (currentProviderType === providerType) {
+            return options;
+        }
+        // Handle case where options has providerType but doesn't match
+        if (currentProviderType !== null) {
+            const { providerType: _providerType, ...genericOptions } = options;
+            return genericOptions;
+        }
+        // Options don't have providerType, return as generic
+        return options;
+    }
+    /**
+     * Merge default values with user-provided options
+     */
+    static mergeWithDefaults(options, defaults) {
+        return {
+            ...defaults,
+            ...options,
+            // Merge nested objects
+            context: { ...defaults.context, ...options.context },
+            metadata: { ...defaults.metadata, ...options.metadata },
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "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.",
   "author": {
     "name": "Juspay Technologies",
@@ -124,10 +124,13 @@
   "dependencies": {
     "@ai-sdk/amazon-bedrock": "^1.0.0",
     "@ai-sdk/anthropic": "^1.2.12",
+    "@ai-sdk/azure": "^1.3.24",
     "@ai-sdk/google": "^1.2.19",
     "@ai-sdk/google-vertex": "^2.2.0",
     "@ai-sdk/mistral": "^1.0.0",
     "@ai-sdk/openai": "^1.0.0",
+    "@ai-sdk/provider": "^1.1.3",
+    "@ai-sdk/provider-utils": "^2.2.8",
     "@google/generative-ai": "^0.24.1",
     "@huggingface/inference": "^2.8.0",
     "@modelcontextprotocol/sdk": "^1.13.0",
@@ -145,25 +148,26 @@
     "@opentelemetry/sdk-metrics": "^1.30.1",
     "@opentelemetry/sdk-node": "^0.54.2",
     "@opentelemetry/semantic-conventions": "^1.34.0",
-    "@types/ws": "^8.18.1",
     "ai": "^4.0.0",
-    "chalk": "^5.3.0",
-    "cors": "^2.8.5",
     "dotenv": "^16.5.0",
-    "express": "^5.1.0",
-    "inquirer": "^9.2.15",
-    "ora": "^7.0.1",
-    "playwright": "^1.52.0",
+    "ollama-ai-provider": "^1.2.0",
     "reconnecting-eventsource": "^1.6.4",
     "undici": "^6.6.2",
     "uuid": "^11.1.0",
     "ws": "^8.18.3",
-    "yargs": "^17.7.2",
     "zod": "^3.22.0",
-    "zod-to-json-schema": "^3.24.5"
+    "zod-to-json-schema": "^3.24.5",
+    "chalk": "^5.3.0",
+    "inquirer": "^9.2.15",
+    "ora": "^7.0.1",
+    "yargs": "^17.7.2"
   },
   "devDependencies": {
     "@changesets/cli": "^2.26.2",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^2.1.9",
+    "cors": "^2.8.5",
+    "express": "^5.1.0",
     "@eslint/js": "^9.0.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.0",
@@ -183,6 +187,7 @@
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "eslint": "^9.0.0",
+    "playwright": "^1.52.0",
     "prettier": "^3.0.0",
     "publint": "^0.3.2",
     "puppeteer": "^24.10.0",

package/dist/lib/providers/agent-enhanced-provider.d.ts

@@ -1,93 +0,0 @@
-/**
- * Agent-Enhanced Provider for NeuroLink CLI
- * Integrates direct tools with AI providers for true agent functionality
- */
-import type { GenerateResult } from "../types/generate-types.js";
-import type { AIProvider, TextGenerationOptions, EnhancedGenerateResult } from "../core/types.js";
-import type { StreamOptions, StreamResult } from "../types/stream-types.js";
-/**
- * Agent configuration options
- */
-interface AgentConfig {
-    provider: "openai" | "google-ai" | "anthropic";
-    model?: string;
-    toolCategory?: "basic" | "filesystem" | "utility" | "all";
-    maxSteps?: number;
-    enableTools?: boolean;
-    enableMCP?: boolean;
-    mcpInitTimeoutMs?: number;
-    toolExecutionTimeout?: number | string;
-    mcpDiscoveryOptions?: {
-        searchPaths?: string[];
-        configFiles?: string[];
-        autoDiscover?: boolean;
-    };
-}
-/**
- * Agent-Enhanced Provider Class
- * Provides AI generation with tool calling capabilities
- * Now includes MCP tool integration alongside direct tools
- */
-export declare class AgentEnhancedProvider implements AIProvider {
-    private config;
-    private model;
-    private resolvedModelName;
-    private mcpSystem;
-    private mcpInitialized;
-    private mcpInitializing;
-    private mcpInitFailed;
-    constructor(config: AgentConfig);
-    private createModel;
-    /**
-     * Initialize MCP registry with auto-discovery
-     */
-    private initializeMCP;
-    /**
-     * Get combined tools: direct tools + MCP tools
-     */
-    private getCombinedTools;
-    /**
-     * PRIMARY METHOD: Stream content using AI (recommended for new code)
-     * Future-ready for multi-modal capabilities with current text focus
-     */
-    stream(optionsOrPrompt: StreamOptions | string, analysisSchema?: any): Promise<StreamResult>;
-    generate(optionsOrPrompt: TextGenerationOptions | string): Promise<GenerateResult>;
-    /**
-     * Determine if we should force tool usage based on prompt patterns
-     */
-    private shouldForceToolUsage;
-    getCapabilities(): string[];
-    getProviderName(): string;
-    getModelName(): string;
-    /**
-     * Test agent functionality
-     */
-    testAgentCapabilities(): Promise<{
-        success: boolean;
-        results: any[];
-    }>;
-    /**
-     * Create agent-enhanced provider factory
-     */
-    static createAgent(config: AgentConfig): AgentEnhancedProvider;
-    /**
-     * Create multiple agent providers for comparison
-     */
-    static createMultiProviderAgents(): Record<string, AgentEnhancedProvider>;
-    /**
-     * Alias for generate() - CLI-SDK consistency
-     */
-    /**
-     * Short alias for generate() - CLI-SDK consistency
-     */
-    gen(optionsOrPrompt: TextGenerationOptions | string, analysisSchema?: any): Promise<EnhancedGenerateResult | null>;
-}
-/**
- * Helper function to create agent provider
- */
-export declare function createAgentProvider(provider: "openai" | "google-ai" | "anthropic", options?: Partial<AgentConfig>): AgentEnhancedProvider;
-/**
- * Test all available agent providers
- */
-export declare function testAllAgentProviders(): Promise<void>;
-export {};