@juspay/neurolink/dist/lib/neurolink.js

Universal AI Development Platform with external MCP server integration, multi-provider support, and professional CLI. Connect to 65+ MCP servers for filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major pr

/**
 * NeuroLink - Unified AI Interface
 *
 * Simple wrapper around the AI provider system to provide a clean API
 * for CLI and other consumers.
 */
import { AIProviderFactory } from './index.js';
import { getBestProvider } from './utils/providerUtils.js';
import { logger } from './utils/logger.js';
export class NeuroLink {
    /**
     * Generate text using the best available AI provider with automatic fallback
     */
    async generateText(options) {
        const startTime = Date.now();
        const functionTag = 'NeuroLink.generateText';
        // Define fallback provider priority order
        const providerPriority = ['openai', 'vertex', 'bedrock', 'anthropic', 'azure', 'google-ai', 'huggingface', 'ollama'];
        const requestedProvider = options.provider === 'auto' ? undefined : options.provider;
        // Local providers that should not fall back when explicitly requested
        const localProviders = ['ollama'];
        // If specific provider requested, check if we should allow fallback
        const tryProviders = requestedProvider
            ? (localProviders.includes(requestedProvider)
                ? [requestedProvider] // No fallback for local providers
                : [requestedProvider, ...providerPriority.filter(p => p !== requestedProvider)])
            : providerPriority;
        logger.debug(`[${functionTag}] Starting text generation`, {
            requestedProvider: requestedProvider || 'auto',
            tryProviders,
            allowFallback: !requestedProvider || !localProviders.includes(requestedProvider),
            promptLength: options.prompt.length
        });
        let lastError = null;
        for (const providerName of tryProviders) {
            try {
                logger.debug(`[${functionTag}] Attempting provider`, { provider: providerName });
                const provider = AIProviderFactory.createProvider(providerName);
                const result = await provider.generateText({
                    prompt: options.prompt,
                    temperature: options.temperature,
                    maxTokens: options.maxTokens,
                    systemPrompt: options.systemPrompt
                }, options.schema);
                if (!result) {
                    throw new Error('No response received from AI provider');
                }
                const responseTime = Date.now() - startTime;
                logger.debug(`[${functionTag}] Provider succeeded`, {
                    provider: providerName,
                    responseTime,
                    usage: result.usage
                });
                return {
                    content: result.text || '',
                    provider: providerName,
                    usage: result.usage,
                    responseTime
                };
            }
            catch (error) {
                const errorMessage = error instanceof Error ? error.message : String(error);
                lastError = error instanceof Error ? error : new Error(errorMessage);
                logger.debug(`[${functionTag}] Provider failed, trying next`, {
                    provider: providerName,
                    error: errorMessage,
                    remainingProviders: tryProviders.slice(tryProviders.indexOf(providerName) + 1)
                });
                // Continue to next provider
                continue;
            }
        }
        // All providers failed
        logger.debug(`[${functionTag}] All providers failed`, {
            triedProviders: tryProviders,
            lastError: lastError?.message
        });
        throw new Error(`Failed to generate text with all providers. Last error: ${lastError?.message || 'Unknown error'}`);
    }
    /**
     * Generate streaming text using the best available AI provider with automatic fallback
     */
    async generateTextStream(options) {
        const functionTag = 'NeuroLink.generateTextStream';
        // Define fallback provider priority order
        const providerPriority = ['openai', 'vertex', 'bedrock', 'anthropic', 'azure', 'google-ai', 'huggingface', 'ollama'];
        const requestedProvider = options.provider === 'auto' ? undefined : options.provider;
        // Local providers that should not fall back when explicitly requested
        const localProviders = ['ollama'];
        // If specific provider requested, check if we should allow fallback
        const tryProviders = requestedProvider
            ? (localProviders.includes(requestedProvider)
                ? [requestedProvider] // No fallback for local providers
                : [requestedProvider, ...providerPriority.filter(p => p !== requestedProvider)])
            : providerPriority;
        logger.debug(`[${functionTag}] Starting stream generation`, {
            requestedProvider: requestedProvider || 'auto',
            tryProviders,
            allowFallback: !requestedProvider || !localProviders.includes(requestedProvider),
            promptLength: options.prompt.length
        });
        let lastError = null;
        for (const providerName of tryProviders) {
            try {
                logger.debug(`[${functionTag}] Attempting provider`, { provider: providerName });
                const provider = AIProviderFactory.createProvider(providerName);
                const result = await provider.streamText({
                    prompt: options.prompt,
                    temperature: options.temperature,
                    maxTokens: options.maxTokens,
                    systemPrompt: options.systemPrompt
                });
                if (!result) {
                    throw new Error('No stream response received from AI provider');
                }
                logger.debug(`[${functionTag}] Provider succeeded`, { provider: providerName });
                // Convert the AI SDK stream to our expected format
                async function* convertStream() {
                    if (result && result.textStream) {
                        for await (const chunk of result.textStream) {
                            yield { content: chunk };
                        }
                    }
                }
                return convertStream();
            }
            catch (error) {
                const errorMessage = error instanceof Error ? error.message : String(error);
                lastError = error instanceof Error ? error : new Error(errorMessage);
                logger.debug(`[${functionTag}] Provider failed, trying next`, {
                    provider: providerName,
                    error: errorMessage,
                    remainingProviders: tryProviders.slice(tryProviders.indexOf(providerName) + 1)
                });
                // Continue to next provider
                continue;
            }
        }
        // All providers failed
        logger.debug(`[${functionTag}] All providers failed`, {
            triedProviders: tryProviders,
            lastError: lastError?.message
        });
        throw new Error(`Failed to stream text with all providers. Last error: ${lastError?.message || 'Unknown error'}`);
    }
    /**
     * Get the best available AI provider
     */
    async getBestProvider() {
        return await getBestProvider();
    }
    /**
     * Test a specific provider
     */
    async testProvider(providerName, testPrompt = 'test') {
        try {
            const provider = AIProviderFactory.createProvider(providerName);
            await provider.generateText(testPrompt);
            return true;
        }
        catch (error) {
            return false;
        }
    }
}