@juspay/neurolink 1.5.1 → 1.5.2

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @juspay/neurolink
 
+## 1.5.2
+
+### Patch Changes
+
+- **🔧 Production-Ready CLI Logging System**: Fixed critical logging system for clean production output
+  - **Issue**: CLI showed excessive debug output during normal operation, breaking demo presentations
+  - **Root Cause**: Mixed console.log statements bypassed conditional logger system
+  - **Solution**: Systematic replacement of all console.log with logger.debug across codebase
+  - **Impact**: **Clean CLI output by default** with conditional debug available via `NEUROLINK_DEBUG=true`
+
+- **🔄 Enhanced Provider Fallback Logic**: Fixed incomplete provider fallback coverage
+  - **Issue**: Provider fallback only attempted 4 of 6 providers (missing Anthropic & Azure)
+  - **Root Cause**: Incomplete provider array in NeuroLink class fallback logic
+  - **Solution**: Updated to include all 6 providers: `['openai', 'vertex', 'bedrock', 'anthropic', 'azure', 'google-ai']`
+  - **Impact**: **100% provider coverage** with comprehensive fallback for maximum reliability
+
+- **🧹 Console Statement Cleanup**: Systematic cleanup of debug output across entire codebase
+  - **Files Updated**: `src/lib/neurolink.ts`, `src/lib/core/factory.ts`, `src/lib/providers/openAI.ts`, `src/lib/mcp/servers/ai-providers/ai-core-server.ts`
+  - **Pattern**: Replaced 200+ `console.log()` statements with `logger.debug()` calls
+  - **Result**: Professional CLI behavior suitable for production deployment and demos
+
+### Technical Changes
+
+- **Production CLI Output**: Clean spinner → success → content (zero debug noise)
+- **Debug Mode Available**: Full debug logging with `NEUROLINK_DEBUG=true` environment variable
+- **Complete Provider Support**: All 6 AI providers now included in automatic fallback
+- **Error Handling**: Provider-level error logs preserved for troubleshooting
+- **Conditional Logging**: Debug messages only appear when explicitly enabled
+- **Demo Ready**: CLI output suitable for presentations and production use
+
+### CLI Behavior
+
+```bash
+# Production/Demo Mode (Clean Output)
+node dist/cli/cli/index.js generate-text "test" --max-tokens 5
+# Output: ⠋ 🤖 Generating text... ✔ ✅ Text generated successfully! [content]
+
+# Debug Mode (Full Logging)
+NEUROLINK_DEBUG=true node dist/cli/cli/index.js generate-text "test" --max-tokens 5
+# Output: [debug logs] + spinner + success + content
+```
+
+### Backward Compatibility
+
+- **100% API Compatible**: No breaking changes to public interfaces
+- **Environment Variables**: `NEUROLINK_DEBUG=true` works as documented
+- **Provider Selection**: All existing provider configurations continue working
+- **CLI Commands**: All commands maintain same functionality with cleaner output
+
 ## 1.5.1
 
 ### Patch Changes

package/README.md

@@ -17,7 +17,7 @@
 export GOOGLE_AI_API_KEY="AIza-your-google-ai-api-key"
 
 # CLI - No installation required
-npx @juspay/neurolink generate-text "Hello, AI!"
+npx @juspay/neurolink generate-text "Hello, AI"
 npx @juspay/neurolink status
 ```
 

package/dist/cli/commands/config.d.ts

@@ -18,8 +18,8 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
             baseURL?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             baseURL?: string | undefined;
         }>>;
         bedrock: z.ZodOptional<z.ZodObject<{
@@ -73,8 +73,8 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
         azure: z.ZodOptional<z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
@@ -87,8 +87,8 @@ declare const ConfigSchema: z.ZodObject<{
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         }>>;
@@ -99,8 +99,8 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
         huggingface: z.ZodOptional<z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodString>;
@@ -109,15 +109,10 @@ declare const ConfigSchema: z.ZodObject<{
             model: string;
             apiKey?: string | undefined;
         }, {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        openai?: {
-            model: string;
-            apiKey?: string | undefined;
-            baseURL?: string | undefined;
-        } | undefined;
         bedrock?: {
             model: string;
             region?: string | undefined;
@@ -125,6 +120,11 @@ declare const ConfigSchema: z.ZodObject<{
             secretAccessKey?: string | undefined;
             sessionToken?: string | undefined;
         } | undefined;
+        openai?: {
+            model: string;
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+        } | undefined;
         vertex?: {
             model: string;
             location: string;
@@ -153,11 +153,6 @@ declare const ConfigSchema: z.ZodObject<{
             apiKey?: string | undefined;
         } | undefined;
     }, {
-        openai?: {
-            apiKey?: string | undefined;
-            model?: string | undefined;
-            baseURL?: string | undefined;
-        } | undefined;
         bedrock?: {
             model?: string | undefined;
             region?: string | undefined;
@@ -165,6 +160,11 @@ declare const ConfigSchema: z.ZodObject<{
             secretAccessKey?: string | undefined;
             sessionToken?: string | undefined;
         } | undefined;
+        openai?: {
+            model?: string | undefined;
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+        } | undefined;
         vertex?: {
             model?: string | undefined;
             projectId?: string | undefined;
@@ -175,22 +175,22 @@ declare const ConfigSchema: z.ZodObject<{
             privateKey?: string | undefined;
         } | undefined;
         anthropic?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         azure?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         } | undefined;
         'google-ai'?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         huggingface?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
     }>>;
     profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
@@ -217,13 +217,8 @@ declare const ConfigSchema: z.ZodObject<{
         cacheStrategy?: "file" | "memory" | "redis" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    defaultProvider: "auto" | "openai" | "bedrock" | "vertex" | "anthropic" | "azure" | "google-ai" | "huggingface";
+    defaultProvider: "bedrock" | "openai" | "vertex" | "anthropic" | "azure" | "google-ai" | "auto" | "huggingface";
     providers: {
-        openai?: {
-            model: string;
-            apiKey?: string | undefined;
-            baseURL?: string | undefined;
-        } | undefined;
         bedrock?: {
             model: string;
             region?: string | undefined;
@@ -231,6 +226,11 @@ declare const ConfigSchema: z.ZodObject<{
             secretAccessKey?: string | undefined;
             sessionToken?: string | undefined;
         } | undefined;
+        openai?: {
+            model: string;
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+        } | undefined;
         vertex?: {
             model: string;
             location: string;
@@ -269,13 +269,8 @@ declare const ConfigSchema: z.ZodObject<{
         cacheStrategy: "file" | "memory" | "redis";
     };
 }, {
-    defaultProvider?: "auto" | "openai" | "bedrock" | "vertex" | "anthropic" | "azure" | "google-ai" | "huggingface" | undefined;
+    defaultProvider?: "bedrock" | "openai" | "vertex" | "anthropic" | "azure" | "google-ai" | "auto" | "huggingface" | undefined;
     providers?: {
-        openai?: {
-            apiKey?: string | undefined;
-            model?: string | undefined;
-            baseURL?: string | undefined;
-        } | undefined;
         bedrock?: {
             model?: string | undefined;
             region?: string | undefined;
@@ -283,6 +278,11 @@ declare const ConfigSchema: z.ZodObject<{
             secretAccessKey?: string | undefined;
             sessionToken?: string | undefined;
         } | undefined;
+        openai?: {
+            model?: string | undefined;
+            apiKey?: string | undefined;
+            baseURL?: string | undefined;
+        } | undefined;
         vertex?: {
             model?: string | undefined;
             projectId?: string | undefined;
@@ -293,22 +293,22 @@ declare const ConfigSchema: z.ZodObject<{
             privateKey?: string | undefined;
         } | undefined;
         anthropic?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         azure?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
             endpoint?: string | undefined;
             deploymentId?: string | undefined;
         } | undefined;
         'google-ai'?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
         huggingface?: {
-            apiKey?: string | undefined;
             model?: string | undefined;
+            apiKey?: string | undefined;
         } | undefined;
     } | undefined;
     profiles?: Record<string, any> | undefined;

package/dist/cli/index.js

@@ -6,7 +6,7 @@
  * Features: Spinners, colors, batch processing, provider testing, rich help
  * Implementation: ~300 lines using simple JS utility functions
  */
-import { NeuroLink } from '@juspay/neurolink';
+import { NeuroLink } from '../lib/neurolink.js';
 import yargs from 'yargs'; // Keep default import
 import { hideBin } from 'yargs/helpers';
 import ora from 'ora';
@@ -49,6 +49,7 @@ function handleError(error, context) {
     let isAuthError = false;
     let genericMessage = specificErrorMessage; // Initialize genericMessage with the specific one
     if (originalErrorMessageLowerCase.includes('api_key') ||
+        originalErrorMessageLowerCase.includes('google_ai_api_key') ||
         originalErrorMessageLowerCase.includes('aws_access_key_id') ||
         originalErrorMessageLowerCase.includes('aws_secret_access_key') ||
         originalErrorMessageLowerCase.includes('aws_session_token') ||
@@ -61,6 +62,7 @@ function handleError(error, context) {
     }
     else if ( // Fallback to checking the full stringified error if direct message didn't match
     errorStringLowerCase.includes('api_key') ||
+        errorStringLowerCase.includes('google_ai_api_key') ||
         errorStringLowerCase.includes('aws_access_key_id') ||
         errorStringLowerCase.includes('aws_secret_access_key') ||
         errorStringLowerCase.includes('aws_session_token') ||
@@ -96,9 +98,10 @@ function handleError(error, context) {
     console.error(chalk.red(`❌ ${context} failed: ${genericMessage}`));
     // Smart hints for common errors (just string matching!)
     if (genericMessage.toLowerCase().includes('api key') || genericMessage.toLowerCase().includes('credential')) {
-        console.error(chalk.yellow('💡 Set API key: export OPENAI_API_KEY=sk-...'));
-        console.error(chalk.yellow('💡 Or set AWS credentials & region: export AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... AWS_REGION=us-east-1'));
-        console.error(chalk.yellow('💡 Or set Google credentials: export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json'));
+        console.error(chalk.yellow('💡 Set Google AI Studio API key (RECOMMENDED): export GOOGLE_AI_API_KEY=AIza-...'));
+        console.error(chalk.yellow('💡 Or set OpenAI API key: export OPENAI_API_KEY=sk-...'));
+        console.error(chalk.yellow('💡 Or set AWS Bedrock credentials: export AWS_ACCESS_KEY_ID=... AWS_SECRET_ACCESS_KEY=... AWS_REGION=us-east-1'));
+        console.error(chalk.yellow('💡 Or set Google Vertex AI credentials: export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json'));
         console.error(chalk.yellow('💡 Or set Anthropic API key: export ANTHROPIC_API_KEY=sk-ant-...'));
         console.error(chalk.yellow('💡 Or set Azure OpenAI credentials: export AZURE_OPENAI_API_KEY=... AZURE_OPENAI_ENDPOINT=...'));
     }
@@ -112,14 +115,16 @@ function handleError(error, context) {
     process.exit(1);
 }
 function validateConfig() {
+    const hasGoogleAI = !!process.env.GOOGLE_AI_API_KEY;
     const hasOpenAI = !!process.env.OPENAI_API_KEY;
     const hasAWS = !!(process.env.AWS_REGION || process.env.AWS_ACCESS_KEY_ID);
     const hasGoogle = !!(process.env.GOOGLE_APPLICATION_CREDENTIALS || process.env.GOOGLE_SERVICE_ACCOUNT_KEY || process.env.GOOGLE_AUTH_CLIENT_EMAIL);
     const hasAnthropic = !!process.env.ANTHROPIC_API_KEY;
     const hasAzure = !!(process.env.AZURE_OPENAI_API_KEY && process.env.AZURE_OPENAI_ENDPOINT);
-    if (!hasOpenAI && !hasAWS && !hasGoogle && !hasAnthropic && !hasAzure) {
+    if (!hasGoogleAI && !hasOpenAI && !hasAWS && !hasGoogle && !hasAnthropic && !hasAzure) {
         console.error(chalk.red('⚠️  No AI provider credentials found'));
         console.error(chalk.yellow('💡 Set one of:'));
+        console.error(chalk.yellow('   • GOOGLE_AI_API_KEY=AIza-...'));
         console.error(chalk.yellow('   • OPENAI_API_KEY=sk-...'));
         console.error(chalk.yellow('   • AWS_REGION=us-east-1 (+ AWS credentials)'));
         console.error(chalk.yellow('   • GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json'));
@@ -147,11 +152,18 @@ const cli = yargs(args)
     .epilogue('For more info: https://github.com/juspay/neurolink')
     .showHelpOnFail(true, 'Specify --help for available options')
     .middleware((argv) => {
-    // Middleware for NEUROLINK_QUIET is fine
+    // Control SDK logging based on debug flag
+    if (argv.debug) {
+        process.env.NEUROLINK_DEBUG = 'true';
+    }
+    else if (typeof argv.debug !== 'undefined') {
+        // Only set to false if debug flag was explicitly provided
+        process.env.NEUROLINK_DEBUG = 'false';
+    }
+    // Keep existing quiet middleware
     if (process.env.NEUROLINK_QUIET === 'true' && typeof argv.quiet === 'undefined') {
         argv.quiet = true;
     }
-    // NEUROLINK_DEBUG will be handled by option defaults
 })
     .fail((msg, err, yargsInstance) => {
     const exitProcess = () => {
@@ -259,13 +271,19 @@ const cli = yargs(args)
             };
             process.stdout.write(JSON.stringify(jsonOutput, null, 2) + '\n');
         }
-        else {
+        else if (argv.debug) {
+            // Debug mode: Show AI response + full metadata
             if (result.content)
                 console.log('\n' + result.content + '\n');
             console.log(JSON.stringify({ provider: result.provider, usage: result.usage, responseTime: result.responseTime }, null, 2));
             if (result.usage)
                 console.log(chalk.blue(`ℹ️  ${result.usage.totalTokens} tokens used`));
         }
+        else {
+            // Default mode: Clean AI response only
+            if (result.content)
+                console.log(result.content);
+        }
         // Explicitly exit to prevent hanging, especially with Google AI Studio
         process.exit(0);
     }
@@ -290,9 +308,16 @@ const cli = yargs(args)
     .positional('prompt', { type: 'string', description: 'Text prompt for streaming', demandOption: true })
     .option('provider', { choices: ['auto', 'openai', 'bedrock', 'vertex', 'anthropic', 'azure', 'google-ai'], default: 'auto', description: 'AI provider to use' })
     .option('temperature', { type: 'number', default: 0.7, description: 'Creativity level' })
+    .option('debug', { type: 'boolean', default: false, description: 'Enable debug mode with interleaved logging' })
     .example('$0 stream "Tell me a story"', 'Stream a story in real-time'), async (argv) => {
-    if (!argv.quiet)
-        console.log(chalk.blue(`🔄 Streaming from ${argv.provider} provider...\n`));
+    // Default mode: Simple streaming message
+    // Debug mode: More detailed information
+    if (!argv.quiet && !argv.debug) {
+        console.log(chalk.blue('🔄 Streaming...'));
+    }
+    else if (!argv.quiet && argv.debug) {
+        console.log(chalk.blue(`🔄 Streaming from ${argv.provider} provider with debug logging...\n`));
+    }
     try {
         const stream = await sdk.generateTextStream({
             prompt: argv.prompt,
@@ -301,9 +326,11 @@ const cli = yargs(args)
         });
         for await (const chunk of stream) {
             process.stdout.write(chunk.content);
+            // In debug mode, interleaved logging would appear here
+            // (SDK logs are controlled by NEUROLINK_DEBUG set in middleware)
         }
         if (!argv.quiet)
-            process.stdout.write('\n'); // Ensure newline after stream if not quiet
+            process.stdout.write('\n'); // Ensure newline after stream
     }
     catch (error) {
         handleError(error, 'Text streaming');
@@ -320,6 +347,7 @@ const cli = yargs(args)
     .option('temperature', { type: 'number', description: 'Global temperature for batch jobs' })
     .option('max-tokens', { type: 'number', description: 'Global max tokens for batch jobs' })
     .option('system', { type: 'string', description: 'Global system prompt for batch jobs' })
+    .option('debug', { type: 'boolean', default: false, description: 'Enable debug mode with detailed per-item logging' })
     .example('$0 batch prompts.txt --output results.json', 'Process and save to file'), async (argv) => {
     const spinner = argv.quiet ? null : ora().start();
     try {
@@ -552,18 +580,34 @@ const cli = yargs(args)
 // which will be caught by the main .fail() handler.
 )
     // Get Best Provider Command
-    .command('get-best-provider', 'Show the best available AI provider', (yargsInstance) => yargsInstance.usage('Usage: $0 get-best-provider'), async () => {
-    const spinner = ora('🎯 Finding best provider...').start();
+    .command('get-best-provider', 'Show the best available AI provider', (yargsInstance) => yargsInstance
+    .usage('Usage: $0 get-best-provider [options]')
+    .option('debug', { type: 'boolean', default: false, description: 'Enable debug mode with selection reasoning' })
+    .example('$0 get-best-provider', 'Get best provider')
+    .example('$0 get-best-provider --debug', 'Show selection logic'), async (argv) => {
+    const spinner = argv.quiet ? null : ora('🎯 Finding best provider...').start();
     try {
         const provider = await sdk.getBestProvider();
-        spinner.succeed(chalk.green(`✅ Best provider: ${provider}`));
-        // Ensure spinner is stopped if it hasn't been by succeed/fail before final log
-        if (spinner.isSpinning)
-            spinner.stop();
-        console.log(provider); // Ensure output for test capture
+        if (spinner) {
+            if (argv.debug) {
+                spinner.succeed(chalk.green(`✅ Best provider selected: ${provider}`));
+            }
+            else {
+                spinner.succeed(chalk.green('✅ Provider found'));
+            }
+        }
+        if (argv.debug) {
+            // Debug mode: Show selection reasoning and metadata
+            console.log(`\nBest available provider: ${provider}`);
+            console.log(`Selection based on: availability, performance, and configuration`);
+        }
+        else {
+            // Default mode: Clean provider name only
+            console.log(provider);
+        }
     }
     catch (error) {
-        if (spinner.isSpinning)
+        if (spinner && spinner.isSpinning)
             spinner.fail();
         handleError(error, 'Provider selection');
     }

package/dist/core/factory.js

@@ -1,5 +1,6 @@
 import { GoogleVertexAI, AmazonBedrock, OpenAI, AnthropicProvider, AzureOpenAIProvider, GoogleAIStudio } from '../providers/index.js';
 import { getBestProvider } from '../utils/providerUtils.js';
+import { logger } from '../utils/logger.js';
 const componentIdentifier = 'aiProviderFactory';
 /**
  * Factory for creating AI provider instances with centralized configuration
@@ -13,7 +14,7 @@ export class AIProviderFactory {
      */
     static createProvider(providerName, modelName) {
         const functionTag = 'AIProviderFactory.createProvider';
-        console.log(`[${functionTag}] Provider creation started`, {
+        logger.debug(`[${functionTag}] Provider creation started`, {
             providerName,
             modelName: modelName || 'default'
         });
@@ -49,7 +50,7 @@ export class AIProviderFactory {
                 default:
                     throw new Error(`Unknown provider: ${providerName}. Supported providers: vertex, bedrock, openai, anthropic, azure, google-ai`);
             }
-            console.log(`[${functionTag}] Provider creation succeeded`, {
+            logger.debug(`[${functionTag}] Provider creation succeeded`, {
                 providerName,
                 modelName: modelName || 'default',
                 providerType: provider.constructor.name
@@ -58,7 +59,7 @@ export class AIProviderFactory {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error(`[${functionTag}] Provider creation failed`, {
+            logger.debug(`[${functionTag}] Provider creation failed`, {
                 providerName,
                 modelName: modelName || 'default',
                 error: errorMessage
@@ -74,13 +75,13 @@ export class AIProviderFactory {
      */
     static createProviderWithModel(provider, model) {
         const functionTag = 'AIProviderFactory.createProviderWithModel';
-        console.log(`[${functionTag}] Provider model creation started`, {
+        logger.debug(`[${functionTag}] Provider model creation started`, {
             provider,
             model
         });
         try {
             const providerInstance = this.createProvider(provider, model);
-            console.log(`[${functionTag}] Provider model creation succeeded`, {
+            logger.debug(`[${functionTag}] Provider model creation succeeded`, {
                 provider,
                 model,
                 providerType: providerInstance.constructor.name
@@ -89,7 +90,7 @@ export class AIProviderFactory {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error(`[${functionTag}] Provider model creation failed`, {
+            logger.debug(`[${functionTag}] Provider model creation failed`, {
                 provider,
                 model,
                 error: errorMessage
@@ -107,7 +108,7 @@ export class AIProviderFactory {
         const functionTag = 'AIProviderFactory.createBestProvider';
         try {
             const bestProvider = getBestProvider(requestedProvider);
-            console.log(`[${functionTag}] Best provider selected`, {
+            logger.debug(`[${functionTag}] Best provider selected`, {
                 requestedProvider: requestedProvider || 'auto',
                 selectedProvider: bestProvider,
                 modelName: modelName || 'default'
@@ -116,7 +117,7 @@ export class AIProviderFactory {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error(`[${functionTag}] Best provider selection failed`, {
+            logger.debug(`[${functionTag}] Best provider selection failed`, {
                 requestedProvider: requestedProvider || 'auto',
                 error: errorMessage
             });
@@ -132,7 +133,7 @@ export class AIProviderFactory {
      */
     static createProviderWithFallback(primaryProvider, fallbackProvider, modelName) {
         const functionTag = 'AIProviderFactory.createProviderWithFallback';
-        console.log(`[${functionTag}] Fallback provider setup started`, {
+        logger.debug(`[${functionTag}] Fallback provider setup started`, {
             primaryProvider,
             fallbackProvider,
             modelName: modelName || 'default'
@@ -140,7 +141,7 @@ export class AIProviderFactory {
         try {
             const primary = this.createProvider(primaryProvider, modelName);
             const fallback = this.createProvider(fallbackProvider, modelName);
-            console.log(`[${functionTag}] Fallback provider setup succeeded`, {
+            logger.debug(`[${functionTag}] Fallback provider setup succeeded`, {
                 primaryProvider,
                 fallbackProvider,
                 modelName: modelName || 'default'
@@ -149,7 +150,7 @@ export class AIProviderFactory {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            console.error(`[${functionTag}] Fallback provider setup failed`, {
+            logger.debug(`[${functionTag}] Fallback provider setup failed`, {
                 primaryProvider,
                 fallbackProvider,
                 error: errorMessage

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

@@ -0,0 +1,40 @@
+import type { AIProvider, AIProviderName, SupportedModelName } from './types.js';
+declare const componentIdentifier = "aiProviderFactory";
+/**
+ * Factory for creating AI provider instances with centralized configuration
+ */
+export declare class AIProviderFactory {
+    /**
+     * Create a provider instance for the specified provider type
+     * @param providerName - Name of the provider ('vertex', 'bedrock', 'openai')
+     * @param modelName - Optional model name override
+     * @returns AIProvider instance
+     */
+    static createProvider(providerName: string, modelName?: string | null): AIProvider;
+    /**
+     * Create a provider instance with specific provider enum and model
+     * @param provider - Provider enum value
+     * @param model - Specific model enum value
+     * @returns AIProvider instance
+     */
+    static createProviderWithModel(provider: AIProviderName, model: SupportedModelName): AIProvider;
+    /**
+     * Create the best available provider automatically
+     * @param requestedProvider - Optional preferred provider
+     * @param modelName - Optional model name override
+     * @returns AIProvider instance
+     */
+    static createBestProvider(requestedProvider?: string, modelName?: string | null): AIProvider;
+    /**
+     * Create primary and fallback provider instances
+     * @param primaryProvider - Primary provider name
+     * @param fallbackProvider - Fallback provider name
+     * @param modelName - Optional model name override
+     * @returns Object with primary and fallback providers
+     */
+    static createProviderWithFallback(primaryProvider: string, fallbackProvider: string, modelName?: string | null): {
+        primary: AIProvider;
+        fallback: AIProvider;
+    };
+}
+export { componentIdentifier };