genai-lite 0.6.1 → 0.7.2

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)",
@@ -598,5 +554,45 @@
         "settings": {
             "temperature": 0.7
         }
+    },
+    {
+        "id": "openrouter-gemma-3-27b-free",
+        "displayName": "OpenRouter - Gemma 3 27B (Free)",
+        "description": "Google's Gemma 3 27B via OpenRouter free tier.",
+        "providerId": "openrouter",
+        "modelId": "google/gemma-3-27b-it:free",
+        "settings": {
+            "temperature": 0.7
+        }
+    },
+    {
+        "id": "openrouter-mistral-small-3.1-free",
+        "displayName": "OpenRouter - Mistral Small 3.1 (Free)",
+        "description": "Mistral Small 3.1 24B via OpenRouter free tier.",
+        "providerId": "openrouter",
+        "modelId": "mistralai/mistral-small-3.1-24b-instruct:free",
+        "settings": {
+            "temperature": 0.7
+        }
+    },
+    {
+        "id": "mistral-small-default",
+        "displayName": "Mistral - Small",
+        "description": "Cost-effective Mistral Small model for general tasks.",
+        "providerId": "mistral",
+        "modelId": "mistral-small-latest",
+        "settings": {
+            "temperature": 0.7
+        }
+    },
+    {
+        "id": "mistral-codestral-default",
+        "displayName": "Mistral - Codestral",
+        "description": "Specialized model for code generation with lower temperature.",
+        "providerId": "mistral",
+        "modelId": "codestral-2501",
+        "settings": {
+            "temperature": 0.3
+        }
     }
 ]

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

@@ -9,6 +9,10 @@ export { LlamaCppClientAdapter } from "./llm/clients/LlamaCppClientAdapter";
 export { LlamaCppServerClient } from "./llm/clients/LlamaCppServerClient";
 export type { LlamaCppClientConfig, } from "./llm/clients/LlamaCppClientAdapter";
 export type { LlamaCppHealthResponse, LlamaCppTokenizeResponse, LlamaCppDetokenizeResponse, LlamaCppEmbeddingResponse, LlamaCppInfillResponse, LlamaCppPropsResponse, LlamaCppMetricsResponse, LlamaCppSlot, LlamaCppSlotsResponse, LlamaCppModel, LlamaCppModelsResponse, } from "./llm/clients/LlamaCppServerClient";
+export { OpenRouterClientAdapter } from "./llm/clients/OpenRouterClientAdapter";
+export type { OpenRouterClientConfig } from "./llm/clients/OpenRouterClientAdapter";
+export { MistralClientAdapter } from "./llm/clients/MistralClientAdapter";
+export type { MistralClientConfig } from "./llm/clients/MistralClientAdapter";
 export { ImageService } from "./image/ImageService";
 export type { ImageProviderId, ImageMimeType, ImageResponseFormat, ImageQuality, ImageStyle, DiffusionSampler, ImageProgressStage, ImageProgressCallback, DiffusionSettings, OpenAISpecificSettings, ImageGenerationSettings, ResolvedImageGenerationSettings, ImageUsage, GeneratedImage, ImageGenerationRequestBase, ImageGenerationRequest, ImageGenerationRequestWithPreset, ImageGenerationResponse, ImageFailureResponse, ImageProviderCapabilities, ImageModelInfo, ImageProviderInfo, ImagePreset, ImageProviderAdapterConfig, ImageProviderAdapter, ImageServiceOptions, CreatePromptResult, } from "./types/image";
 export { renderTemplate } from "./prompting/template";
@@ -17,3 +21,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.MistralClientAdapter = exports.OpenRouterClientAdapter = 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; } });
@@ -30,6 +30,12 @@ var LlamaCppClientAdapter_1 = require("./llm/clients/LlamaCppClientAdapter");
 Object.defineProperty(exports, "LlamaCppClientAdapter", { enumerable: true, get: function () { return LlamaCppClientAdapter_1.LlamaCppClientAdapter; } });
 var LlamaCppServerClient_1 = require("./llm/clients/LlamaCppServerClient");
 Object.defineProperty(exports, "LlamaCppServerClient", { enumerable: true, get: function () { return LlamaCppServerClient_1.LlamaCppServerClient; } });
+// --- OpenRouter Integration ---
+var OpenRouterClientAdapter_1 = require("./llm/clients/OpenRouterClientAdapter");
+Object.defineProperty(exports, "OpenRouterClientAdapter", { enumerable: true, get: function () { return OpenRouterClientAdapter_1.OpenRouterClientAdapter; } });
+// --- Mistral Integration ---
+var MistralClientAdapter_1 = require("./llm/clients/MistralClientAdapter");
+Object.defineProperty(exports, "MistralClientAdapter", { enumerable: true, get: function () { return MistralClientAdapter_1.MistralClientAdapter; } });
 // --- Image Generation ---
 // Export Image Service
 var ImageService_1 = require("./image/ImageService");
@@ -50,3 +56,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,9 @@ 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 systemMessageUtils_1 = require("../../shared/adapters/systemMessageUtils");
+const defaultLogger_1 = require("../../logging/defaultLogger");
+const logger = (0, defaultLogger_1.createDefaultLogger)();
 /**
  * Client adapter for Anthropic API integration
  *
@@ -93,8 +96,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 +108,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);
         }
     }
@@ -142,18 +145,14 @@ class AnthropicClientAdapter {
      */
     formatMessagesForAnthropic(request) {
         const messages = [];
-        let systemMessage = request.systemMessage;
+        const inlineSystemMessages = [];
+        // Check if model supports system messages
+        const supportsSystem = request.settings.supportsSystemMessage !== false;
         // Process conversation messages
         for (const message of request.messages) {
             if (message.role === "system") {
-                // Anthropic handles system messages separately
-                // If we already have a system message, append to it
-                if (systemMessage) {
-                    systemMessage += "\n\n" + message.content;
-                }
-                else {
-                    systemMessage = message.content;
-                }
+                // Collect inline system messages
+                inlineSystemMessages.push(message.content);
             }
             else if (message.role === "user") {
                 messages.push({
@@ -168,10 +167,32 @@ class AnthropicClientAdapter {
                 });
             }
         }
+        // Use shared utility to collect and combine system content
+        const { combinedSystemContent, useNativeSystemMessage } = (0, systemMessageUtils_1.collectSystemContent)(request.systemMessage, inlineSystemMessages, supportsSystem);
+        let systemMessage;
+        if (combinedSystemContent) {
+            if (useNativeSystemMessage) {
+                // Model supports system messages - use Anthropic's system parameter
+                systemMessage = combinedSystemContent;
+            }
+            else {
+                // Model doesn't support system messages - prepend to first user message
+                const simpleMessages = messages.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                }));
+                const modifiedIndex = (0, systemMessageUtils_1.prependSystemToFirstUserMessage)(simpleMessages, combinedSystemContent, request.settings.systemMessageFallback);
+                if (modifiedIndex !== -1) {
+                    messages[modifiedIndex].content = simpleMessages[modifiedIndex].content;
+                    logger.debug(`Model ${request.modelId} doesn't support system messages - prepended to first user message`);
+                }
+                // Don't set systemMessage - it stays undefined
+            }
+        }
         // 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 +234,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;