genai-lite 0.6.1 → 0.7.0

package/README.md

@@ -14,6 +14,7 @@ A lightweight, portable Node.js/TypeScript library providing a unified interface
 - 🛡️ **Provider Normalization** - Consistent responses across different AI APIs
 - 🎨 **Configurable Model Presets** - Built-in presets with full customization options
 - 🎭 **Template Engine** - Sophisticated templating with conditionals and variable substitution
+- 📊 **Configurable Logging** - Debug mode, custom loggers (pino, winston), and silent mode for tests
 
 ## Installation
 
@@ -112,6 +113,7 @@ Comprehensive documentation is available in the **[`genai-lite-docs`](./genai-li
 
 ### Utilities & Advanced
 - **[Prompting Utilities](./genai-lite-docs/prompting-utilities.md)** - Template engine, token counting, content parsing
+- **[Logging](./genai-lite-docs/logging.md)** - Configure logging and debugging
 - **[TypeScript Reference](./genai-lite-docs/typescript-reference.md)** - Type definitions
 
 ### Provider Reference
@@ -154,6 +156,25 @@ const llmService = new LLMService(myKeyProvider);
 
 See **[Core Concepts](./genai-lite-docs/core-concepts.md#api-key-management)** for detailed examples including Electron integration.
 
+## Logging Configuration
+
+Control logging verbosity via environment variable or service options:
+
+```bash
+# Environment variable (applies to all services)
+export GENAI_LITE_LOG_LEVEL=debug  # Options: silent, error, warn, info, debug
+```
+
+```typescript
+// Per-service configuration
+const llmService = new LLMService(fromEnvironment, {
+  logLevel: 'debug',        // Override env var
+  logger: customPinoLogger  // Inject pino/winston/etc.
+});
+```
+
+See **[Logging](./genai-lite-docs/logging.md)** for custom logger integration and testing patterns.
+
 ## Example Applications
 
 The library includes two complete demo applications showcasing all features:

package/dist/adapters/image/GenaiElectronImageAdapter.js

@@ -18,6 +18,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenaiElectronImageAdapter = void 0;
 const errorUtils_1 = require("../../shared/adapters/errorUtils");
+const defaultLogger_1 = require("../../logging/defaultLogger");
+const logger = (0, defaultLogger_1.createDefaultLogger)();
 /**
  * Adapter for genai-electron's local diffusion image generation
  */
@@ -44,7 +46,7 @@ class GenaiElectronImageAdapter {
         try {
             // Build request payload
             const payload = this.buildRequestPayload(resolvedPrompt, request, settings);
-            console.log(`GenaiElectron Image API: Starting generation`, {
+            logger.debug(`GenaiElectron Image API: Starting generation`, {
                 prompt: resolvedPrompt.substring(0, 100),
                 count: payload.count,
                 dimensions: `${payload.width}x${payload.height}`,
@@ -52,15 +54,15 @@ class GenaiElectronImageAdapter {
             });
             // Start generation (returns immediately with ID)
             const generationId = await this.startGeneration(payload);
-            console.log(`GenaiElectron Image API: Generation started with ID: ${generationId}`);
+            logger.info(`GenaiElectron Image API: Generation started with ID: ${generationId}`);
             // Poll for completion
             const result = await this.pollForCompletion(generationId, settings.diffusion?.onProgress);
-            console.log(`GenaiElectron Image API: Generation complete (${result.timeTaken}ms)`);
+            logger.info(`GenaiElectron Image API: Generation complete (${result.timeTaken}ms)`);
             // Convert to ImageGenerationResponse
             return this.convertToResponse(result, request);
         }
         catch (error) {
-            console.error('GenaiElectron Image API error:', error);
+            logger.error('GenaiElectron Image API error:', error);
             throw this.handleError(error, request);
         }
     }

package/dist/adapters/image/OpenAIImageAdapter.js

@@ -20,6 +20,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAIImageAdapter = void 0;
 const openai_1 = __importDefault(require("openai"));
 const errorUtils_1 = require("../../shared/adapters/errorUtils");
+const defaultLogger_1 = require("../../logging/defaultLogger");
+const logger = (0, defaultLogger_1.createDefaultLogger)();
 /**
  * Prompt length limits per model
  */
@@ -94,7 +96,7 @@ class OpenAIImageAdapter {
                 // dall-e-2/dall-e-3: use traditional parameters
                 this.addDalleParams(params, settings);
             }
-            console.log(`OpenAI Image API call for model: ${request.modelId}`, {
+            logger.debug(`OpenAI Image API call for model: ${request.modelId}`, {
                 model: params.model,
                 promptLength: resolvedPrompt.length,
                 n: params.n,
@@ -105,12 +107,12 @@ class OpenAIImageAdapter {
             if (!response.data || response.data.length === 0) {
                 throw new Error('OpenAI API returned no images in response');
             }
-            console.log(`OpenAI Image API call successful, generated ${response.data.length} images`);
+            logger.info(`OpenAI Image API call successful, generated ${response.data.length} images`);
             // Process response
             return await this.processResponse(response, request, isGptImageModel);
         }
         catch (error) {
-            console.error('OpenAI Image API error:', error);
+            logger.error('OpenAI Image API error:', error);
             throw this.handleError(error, request);
         }
     }

package/dist/config/llm-presets.json

@@ -369,50 +369,6 @@
             }
         }
     },
-    {
-        "id": "google-gemini-2.0-flash-default",
-        "displayName": "Google - Gemini 2.0 Flash",
-        "description": "Default preset for Gemini 2.0 Flash.",
-        "providerId": "gemini",
-        "modelId": "gemini-2.0-flash",
-        "settings": {
-            "temperature": 0.7,
-            "geminiSafetySettings": [
-                { "category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_NONE" },
-                {
-                    "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
-                    "threshold": "BLOCK_NONE"
-                },
-                {
-                    "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
-                    "threshold": "BLOCK_NONE"
-                },
-                { "category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_NONE" }
-            ]
-        }
-    },
-    {
-        "id": "google-gemini-2.0-flash-lite-default",
-        "displayName": "Google - Gemini 2.0 Flash Lite",
-        "description": "Default preset for Gemini 2.0 Flash Lite.",
-        "providerId": "gemini",
-        "modelId": "gemini-2.0-flash-lite",
-        "settings": {
-            "temperature": 0.7,
-            "geminiSafetySettings": [
-                { "category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_NONE" },
-                {
-                    "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
-                    "threshold": "BLOCK_NONE"
-                },
-                {
-                    "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
-                    "threshold": "BLOCK_NONE"
-                },
-                { "category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_NONE" }
-            ]
-        }
-    },
     {
         "id": "google-gemma-3-27b-default",
         "displayName": "Google - Gemma 3 27B (Free)",

package/dist/image/ImageService.d.ts

@@ -11,6 +11,7 @@ import type { ImageGenerationRequest, ImageGenerationRequestWithPreset, ImageGen
  */
 export declare class ImageService {
     private getApiKey;
+    private logger;
     private presetManager;
     private adapterRegistry;
     private requestValidator;

package/dist/image/ImageService.js

@@ -10,6 +10,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ImageService = void 0;
+const defaultLogger_1 = require("../logging/defaultLogger");
 const config_1 = require("./config");
 const image_presets_json_1 = __importDefault(require("../config/image-presets.json"));
 const PresetManager_1 = require("../shared/services/PresetManager");
@@ -28,13 +29,15 @@ const defaultImagePresets = image_presets_json_1.default;
 class ImageService {
     constructor(getApiKey, options = {}) {
         this.getApiKey = getApiKey;
+        // Initialize logger - custom logger takes precedence over logLevel
+        this.logger = options.logger ?? (0, defaultLogger_1.createDefaultLogger)(options.logLevel);
         // Initialize helper services
         this.presetManager = new PresetManager_1.PresetManager(defaultImagePresets, options.presets, options.presetMode);
         // Initialize adapter registry with fallback
         this.adapterRegistry = new AdapterRegistry_1.AdapterRegistry({
             supportedProviders: config_1.SUPPORTED_IMAGE_PROVIDERS,
             fallbackAdapter: new MockImageAdapter_1.MockImageAdapter(),
-        });
+        }, this.logger);
         // Register OpenAI adapter
         const openaiConfig = config_1.IMAGE_ADAPTER_CONFIGS['openai-images'];
         const openaiBaseURL = options.baseUrls?.['openai-images'] || openaiConfig.baseURL;
@@ -58,7 +61,7 @@ class ImageService {
         this.requestValidator = new ImageRequestValidator_1.ImageRequestValidator();
         this.settingsResolver = new ImageSettingsResolver_1.ImageSettingsResolver();
         this.modelResolver = new ImageModelResolver_1.ImageModelResolver(this.presetManager);
-        console.log('ImageService: Initialized with OpenAI Images and genai-electron adapters');
+        this.logger.debug('ImageService: Initialized with OpenAI Images and genai-electron adapters');
     }
     /**
      * Generates images based on the request
@@ -67,7 +70,7 @@ class ImageService {
      * @returns Promise resolving to response or error
      */
     async generateImage(request) {
-        console.log('ImageService.generateImage called');
+        this.logger.info('ImageService.generateImage called');
         try {
             // Resolve model information
             const resolved = this.modelResolver.resolve(request);
@@ -114,18 +117,18 @@ class ImageService {
                     };
                 }
                 // Generate images
-                console.log(`ImageService: Calling adapter for provider: ${providerId}`);
+                this.logger.info(`ImageService: Calling adapter for provider: ${providerId}`);
                 const response = await adapter.generate({
                     request: fullRequest,
                     resolvedPrompt,
                     settings: resolvedSettings,
                     apiKey,
                 });
-                console.log('ImageService: Image generation completed successfully');
+                this.logger.info('ImageService: Image generation completed successfully');
                 return response;
             }
             catch (error) {
-                console.error('ImageService: Error during image generation:', error);
+                this.logger.error('ImageService: Error during image generation:', error);
                 return {
                     object: 'error',
                     providerId: providerId,
@@ -142,7 +145,7 @@ class ImageService {
             }
         }
         catch (error) {
-            console.error('ImageService: Unexpected error:', error);
+            this.logger.error('ImageService: Unexpected error:', error);
             const req = request;
             return {
                 object: 'error',
@@ -163,7 +166,7 @@ class ImageService {
      * @returns Promise resolving to array of provider information
      */
     async getProviders() {
-        console.log('ImageService.getProviders called');
+        this.logger.debug('ImageService.getProviders called');
         return [...config_1.SUPPORTED_IMAGE_PROVIDERS];
     }
     /**
@@ -173,9 +176,9 @@ class ImageService {
      * @returns Promise resolving to array of model information
      */
     async getModels(providerId) {
-        console.log(`ImageService.getModels called for provider: ${providerId}`);
+        this.logger.debug(`ImageService.getModels called for provider: ${providerId}`);
         const models = (0, config_1.getImageModelsByProvider)(providerId);
-        console.log(`ImageService: Found ${models.length} models for provider: ${providerId}`);
+        this.logger.debug(`ImageService: Found ${models.length} models for provider: ${providerId}`);
         return [...models];
     }
     /**

package/dist/index.d.ts

@@ -17,3 +17,5 @@ export { parseStructuredContent, parseRoleTags, extractInitialTaggedContent, par
 export type { TemplateMetadata } from "./prompting/parser";
 export { createFallbackModelInfo, detectGgufCapabilities, KNOWN_GGUF_MODELS } from "./llm/config";
 export type { GgufModelPattern } from "./llm/config";
+export type { Logger, LogLevel, LoggingConfig } from "./logging/types";
+export { createDefaultLogger, DEFAULT_LOG_LEVEL, silentLogger } from "./logging/defaultLogger";

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KNOWN_GGUF_MODELS = exports.detectGgufCapabilities = exports.createFallbackModelInfo = exports.parseTemplateWithMetadata = exports.extractInitialTaggedContent = exports.parseRoleTags = exports.parseStructuredContent = exports.extractRandomVariables = exports.getSmartPreview = exports.countTokens = exports.renderTemplate = exports.ImageService = exports.LlamaCppServerClient = exports.LlamaCppClientAdapter = exports.fromEnvironment = exports.LLMService = void 0;
+exports.silentLogger = exports.DEFAULT_LOG_LEVEL = exports.createDefaultLogger = exports.KNOWN_GGUF_MODELS = exports.detectGgufCapabilities = exports.createFallbackModelInfo = exports.parseTemplateWithMetadata = exports.extractInitialTaggedContent = exports.parseRoleTags = exports.parseStructuredContent = exports.extractRandomVariables = exports.getSmartPreview = exports.countTokens = exports.renderTemplate = exports.ImageService = exports.LlamaCppServerClient = exports.LlamaCppClientAdapter = exports.fromEnvironment = exports.LLMService = void 0;
 // --- LLM Service ---
 var LLMService_1 = require("./llm/LLMService");
 Object.defineProperty(exports, "LLMService", { enumerable: true, get: function () { return LLMService_1.LLMService; } });
@@ -50,3 +50,7 @@ var config_1 = require("./llm/config");
 Object.defineProperty(exports, "createFallbackModelInfo", { enumerable: true, get: function () { return config_1.createFallbackModelInfo; } });
 Object.defineProperty(exports, "detectGgufCapabilities", { enumerable: true, get: function () { return config_1.detectGgufCapabilities; } });
 Object.defineProperty(exports, "KNOWN_GGUF_MODELS", { enumerable: true, get: function () { return config_1.KNOWN_GGUF_MODELS; } });
+var defaultLogger_1 = require("./logging/defaultLogger");
+Object.defineProperty(exports, "createDefaultLogger", { enumerable: true, get: function () { return defaultLogger_1.createDefaultLogger; } });
+Object.defineProperty(exports, "DEFAULT_LOG_LEVEL", { enumerable: true, get: function () { return defaultLogger_1.DEFAULT_LOG_LEVEL; } });
+Object.defineProperty(exports, "silentLogger", { enumerable: true, get: function () { return defaultLogger_1.silentLogger; } });

package/dist/llm/LLMService.d.ts

@@ -1,4 +1,5 @@
 import type { ApiKeyProvider, PresetMode } from '../types';
+import type { Logger, LogLevel } from '../logging/types';
 import type { LLMChatRequest, LLMChatRequestWithPreset, LLMResponse, LLMFailureResponse, ProviderInfo, ModelInfo, ApiProviderId, LLMSettings, ModelContext, LLMMessage } from "./types";
 import type { ModelPreset } from "../types/presets";
 export type { PresetMode };
@@ -10,6 +11,10 @@ export interface LLMServiceOptions {
     presets?: ModelPreset[];
     /** The strategy for integrating custom presets. Defaults to 'extend'. */
     presetMode?: PresetMode;
+    /** Log level for filtering messages. Defaults to GENAI_LITE_LOG_LEVEL env var or 'warn'. */
+    logLevel?: LogLevel;
+    /** Custom logger implementation. If provided, logLevel is ignored. */
+    logger?: Logger;
 }
 /**
  * Result from createMessages method
@@ -35,6 +40,7 @@ export interface CreateMessagesResult {
  */
 export declare class LLMService {
     private getApiKey;
+    private logger;
     private presetManager;
     private adapterRegistry;
     private requestValidator;

package/dist/llm/LLMService.js

@@ -6,6 +6,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LLMService = void 0;
+const defaultLogger_1 = require("../logging/defaultLogger");
 const config_1 = require("./config");
 const template_1 = require("../prompting/template");
 const parser_1 = require("../prompting/parser");
@@ -31,17 +32,19 @@ const ModelResolver_1 = require("./services/ModelResolver");
 class LLMService {
     constructor(getApiKey, options = {}) {
         this.getApiKey = getApiKey;
-        // Initialize services
+        // Initialize logger - custom logger takes precedence over logLevel
+        this.logger = options.logger ?? (0, defaultLogger_1.createDefaultLogger)(options.logLevel);
+        // Initialize services with logger
         this.presetManager = new PresetManager_1.PresetManager(llm_presets_json_1.default, options.presets, options.presetMode);
         this.adapterRegistry = new AdapterRegistry_1.AdapterRegistry({
             supportedProviders: config_1.SUPPORTED_PROVIDERS,
             fallbackAdapter: new MockClientAdapter_1.MockClientAdapter(),
             adapterConstructors: config_1.ADAPTER_CONSTRUCTORS,
             adapterConfigs: config_1.ADAPTER_CONFIGS,
-        });
+        }, this.logger);
         this.requestValidator = new RequestValidator_1.RequestValidator();
-        this.settingsManager = new SettingsManager_1.SettingsManager();
-        this.modelResolver = new ModelResolver_1.ModelResolver(this.presetManager, this.adapterRegistry);
+        this.settingsManager = new SettingsManager_1.SettingsManager(this.logger);
+        this.modelResolver = new ModelResolver_1.ModelResolver(this.presetManager, this.adapterRegistry, this.logger);
     }
     /**
      * Gets list of supported LLM providers
@@ -49,7 +52,7 @@ class LLMService {
      * @returns Promise resolving to array of provider information
      */
     async getProviders() {
-        console.log("LLMService.getProviders called");
+        this.logger.debug("LLMService.getProviders called");
         return [...config_1.SUPPORTED_PROVIDERS]; // Return a copy to prevent external modification
     }
     /**
@@ -59,14 +62,14 @@ class LLMService {
      * @returns Promise resolving to array of model information
      */
     async getModels(providerId) {
-        console.log(`LLMService.getModels called for provider: ${providerId}`);
+        this.logger.debug(`LLMService.getModels called for provider: ${providerId}`);
         // Validate provider exists
         const models = (0, config_1.getModelsByProvider)(providerId);
         if (models.length === 0) {
-            console.warn(`Requested models for unsupported provider: ${providerId}`);
+            this.logger.warn(`Requested models for unsupported provider: ${providerId}`);
             return [];
         }
-        console.log(`Found ${models.length} models for provider: ${providerId}`);
+        this.logger.debug(`Found ${models.length} models for provider: ${providerId}`);
         return [...models]; // Return a copy to prevent external modification
     }
     /**
@@ -76,7 +79,7 @@ class LLMService {
      * @returns Promise resolving to either success or failure response
      */
     async sendMessage(request) {
-        console.log(`LLMService.sendMessage called with presetId: ${request.presetId}, provider: ${request.providerId}, model: ${request.modelId}`);
+        this.logger.info(`LLMService.sendMessage called with presetId: ${request.presetId}, provider: ${request.providerId}, model: ${request.modelId}`);
         try {
             // Resolve model information from preset or direct IDs
             const resolved = await this.modelResolver.resolve(request);
@@ -130,7 +133,7 @@ class LLMService {
                 ...resolvedRequest,
                 settings: filteredSettings,
             };
-            console.log(`Processing LLM request with (potentially filtered) settings:`, {
+            this.logger.debug(`Processing LLM request with (potentially filtered) settings:`, {
                 provider: providerId,
                 model: modelId,
                 settings: filteredSettings,
@@ -166,7 +169,7 @@ class LLMService {
                         object: "error",
                     };
                 }
-                console.log(`Making LLM request with ${clientAdapter.constructor.name} for provider: ${providerId}`);
+                this.logger.info(`Making LLM request with ${clientAdapter.constructor.name} for provider: ${providerId}`);
                 const result = await clientAdapter.sendMessage(internalRequest, apiKey);
                 // Post-process for thinking tag fallback
                 // This feature extracts reasoning from XML tags when native reasoning is not active.
@@ -186,7 +189,7 @@ class LLMService {
                         const { extracted, remaining } = (0, parser_1.extractInitialTaggedContent)(choice.message.content, tagName);
                         if (extracted !== null) {
                             // Success: thinking tag found
-                            console.log(`Extracted <${tagName}> block from response.`);
+                            this.logger.debug(`Extracted <${tagName}> block from response.`);
                             // Handle the edge case: append to existing reasoning if present (e.g., native reasoning + thinking tags)
                             const existingReasoning = choice.reasoning || '';
                             if (existingReasoning) {
@@ -234,11 +237,11 @@ class LLMService {
                         }
                     }
                 }
-                console.log(`LLM request completed successfully for model: ${modelId}`);
+                this.logger.info(`LLM request completed successfully for model: ${modelId}`);
                 return result;
             }
             catch (error) {
-                console.error("Error in LLMService.sendMessage:", error);
+                this.logger.error("Error in LLMService.sendMessage:", error);
                 return {
                     provider: providerId,
                     model: modelId,
@@ -255,7 +258,7 @@ class LLMService {
             }
         }
         catch (error) {
-            console.error("Error in LLMService.sendMessage (outer):", error);
+            this.logger.error("Error in LLMService.sendMessage (outer):", error);
             return {
                 provider: request.providerId || request.presetId || 'unknown',
                 model: request.modelId || request.presetId || 'unknown',
@@ -328,7 +331,7 @@ class LLMService {
      * ```
      */
     async createMessages(options) {
-        console.log('LLMService.createMessages called');
+        this.logger.debug('LLMService.createMessages called');
         // NEW: Step 1 - Parse the template for metadata and content
         const { metadata, content: templateContent } = (0, parser_1.parseTemplateWithMetadata)(options.template);
         // Validate the settings from the template
@@ -345,7 +348,7 @@ class LLMService {
             });
             if (resolved.error) {
                 // If resolution fails, proceed without model context
-                console.warn('Model resolution failed, proceeding without model context:', resolved.error);
+                this.logger.warn('Model resolution failed, proceeding without model context:', resolved.error);
             }
             else {
                 const { providerId, modelId, modelInfo, settings } = resolved;

package/dist/llm/clients/AnthropicClientAdapter.js

@@ -9,6 +9,8 @@ exports.AnthropicClientAdapter = void 0;
 const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
 const types_1 = require("./types");
 const errorUtils_1 = require("../../shared/adapters/errorUtils");
+const defaultLogger_1 = require("../../logging/defaultLogger");
+const logger = (0, defaultLogger_1.createDefaultLogger)();
 /**
  * Client adapter for Anthropic API integration
  *
@@ -93,8 +95,8 @@ class AnthropicClientAdapter {
                     };
                 }
             }
-            console.log(`Making Anthropic API call for model: ${request.modelId}`);
-            console.log(`Anthropic API parameters:`, {
+            logger.info(`Making Anthropic API call for model: ${request.modelId}`);
+            logger.debug(`Anthropic API parameters:`, {
                 model: messageParams.model,
                 temperature: messageParams.temperature,
                 max_tokens: messageParams.max_tokens,
@@ -105,12 +107,12 @@ class AnthropicClientAdapter {
             });
             // Make the API call
             const completion = await anthropic.messages.create(messageParams);
-            console.log(`Anthropic API call successful, response ID: ${completion.id}`);
+            logger.info(`Anthropic API call successful, response ID: ${completion.id}`);
             // Convert to standardized response format
             return this.createSuccessResponse(completion, request);
         }
         catch (error) {
-            console.error("Anthropic API error:", error);
+            logger.error("Anthropic API error:", error);
             return this.createErrorResponse(error, request);
         }
     }
@@ -171,7 +173,7 @@ class AnthropicClientAdapter {
         // Anthropic requires messages to start with 'user' role
         // If the first message is not from user, we need to handle this
         if (messages.length > 0 && messages[0].role !== "user") {
-            console.warn("Anthropic API requires first message to be from user. Adjusting message order.");
+            logger.warn("Anthropic API requires first message to be from user. Adjusting message order.");
             // Find the first user message and move it to the front, or create a default one
             const firstUserIndex = messages.findIndex((msg) => msg.role === "user");
             if (firstUserIndex > 0) {
@@ -213,7 +215,7 @@ class AnthropicClientAdapter {
                 // If roles don't alternate properly, we might need to combine messages
                 // or insert a placeholder. For now, we'll skip non-alternating messages
                 // and log a warning.
-                console.warn(`Skipping message with unexpected role: expected ${expectedRole}, got ${message.role}`);
+                logger.warn(`Skipping message with unexpected role: expected ${expectedRole}, got ${message.role}`);
             }
         }
         return cleanedMessages;

package/dist/llm/clients/GeminiClientAdapter.js

@@ -6,6 +6,8 @@ exports.GeminiClientAdapter = void 0;
 const genai_1 = require("@google/genai");
 const types_1 = require("./types");
 const errorUtils_1 = require("../../shared/adapters/errorUtils");
+const defaultLogger_1 = require("../../logging/defaultLogger");
+const logger = (0, defaultLogger_1.createDefaultLogger)();
 /**
  * Client adapter for Google Gemini API integration
  *
@@ -39,8 +41,8 @@ class GeminiClientAdapter {
             const genAI = new genai_1.GoogleGenAI({ apiKey });
             // Format the request for Gemini API
             const { contents, generationConfig, safetySettings, systemInstruction } = this.formatInternalRequestToGemini(request);
-            console.log(`Making Gemini API call for model: ${request.modelId}`);
-            console.log(`Gemini API parameters:`, {
+            logger.info(`Making Gemini API call for model: ${request.modelId}`);
+            logger.debug(`Gemini API parameters:`, {
                 model: request.modelId,
                 temperature: generationConfig.temperature,
                 maxOutputTokens: generationConfig.maxOutputTokens,
@@ -58,12 +60,12 @@ class GeminiClientAdapter {
                     ...(systemInstruction && { systemInstruction: systemInstruction }),
                 },
             });
-            console.log(`Gemini API call successful, processing response`);
+            logger.info(`Gemini API call successful, processing response`);
             // Convert to standardized response format
             return this.createSuccessResponse(result, request);
         }
         catch (error) {
-            console.error("Gemini API error:", error);
+            logger.error("Gemini API error:", error);
             return this.createErrorResponse(error, request);
         }
     }

package/dist/llm/clients/LlamaCppClientAdapter.js

@@ -11,6 +11,8 @@ const types_1 = require("./types");
 const errorUtils_1 = require("../../shared/adapters/errorUtils");
 const LlamaCppServerClient_1 = require("./LlamaCppServerClient");
 const config_1 = require("../config");
+const defaultLogger_1 = require("../../logging/defaultLogger");
+const logger = (0, defaultLogger_1.createDefaultLogger)();
 /**
  * Client adapter for llama.cpp server integration
  *
@@ -78,10 +80,10 @@ class LlamaCppClientAdapter {
         }
         // Attempt detection
         try {
-            console.log(`Detecting model capabilities from llama.cpp server at ${this.baseURL}`);
+            logger.debug(`Detecting model capabilities from llama.cpp server at ${this.baseURL}`);
             const { data } = await this.serverClient.getModels();
             if (!data || data.length === 0) {
-                console.warn('No models loaded in llama.cpp server');
+                logger.warn('No models loaded in llama.cpp server');
                 this.detectionAttempted = true;
                 return null;
             }
@@ -91,15 +93,15 @@ class LlamaCppClientAdapter {
             this.cachedModelCapabilities = capabilities;
             this.detectionAttempted = true;
             if (capabilities) {
-                console.log(`Cached model capabilities for: ${ggufFilename}`);
+                logger.debug(`Cached model capabilities for: ${ggufFilename}`);
             }
             else {
-                console.log(`No known pattern matched for: ${ggufFilename}`);
+                logger.debug(`No known pattern matched for: ${ggufFilename}`);
             }
             return capabilities;
         }
         catch (error) {
-            console.warn('Failed to detect model capabilities:', error);
+            logger.warn('Failed to detect model capabilities:', error);
             this.detectionAttempted = true;
             return null;
         }
@@ -113,7 +115,7 @@ class LlamaCppClientAdapter {
     clearModelCache() {
         this.cachedModelCapabilities = null;
         this.detectionAttempted = false;
-        console.log('Cleared model capabilities cache');
+        logger.debug('Cleared model capabilities cache');
     }
     /**
      * Sends a chat message to llama.cpp server
@@ -142,7 +144,7 @@ class LlamaCppClientAdapter {
                     }
                 }
                 catch (healthError) {
-                    console.warn('Health check failed, proceeding with request anyway:', healthError);
+                    logger.warn('Health check failed, proceeding with request anyway:', healthError);
                 }
             }
             // Initialize OpenAI client with llama.cpp base URL
@@ -170,19 +172,19 @@ class LlamaCppClientAdapter {
                     presence_penalty: request.settings.presencePenalty,
                 }),
             };
-            console.log(`llama.cpp API parameters:`, {
+            logger.debug(`llama.cpp API parameters:`, {
                 baseURL: this.baseURL,
                 model: completionParams.model,
                 temperature: completionParams.temperature,
                 max_tokens: completionParams.max_tokens,
                 top_p: completionParams.top_p,
             });
-            console.log(`Making llama.cpp API call for model: ${request.modelId}`);
+            logger.info(`Making llama.cpp API call for model: ${request.modelId}`);
             // Make the API call
             const completion = await openai.chat.completions.create(completionParams);
             // Type guard to ensure we have a non-streaming response
             if ('id' in completion && 'choices' in completion) {
-                console.log(`llama.cpp API call successful, response ID: ${completion.id}`);
+                logger.info(`llama.cpp API call successful, response ID: ${completion.id}`);
                 return this.createSuccessResponse(completion, request);
             }
             else {
@@ -190,7 +192,7 @@ class LlamaCppClientAdapter {
             }
         }
         catch (error) {
-            console.error("llama.cpp API error:", error);
+            logger.error("llama.cpp API error:", error);
             // Clear cache on connection errors so we re-detect on next request
             const errorMessage = error?.message || String(error);
             if (errorMessage.includes("ECONNREFUSED") ||