genai-lite 0.4.3 → 0.5.1

package/dist/image/services/ImageRequestValidator.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageRequestValidator = void 0;
+/**
+ * Validates image generation requests
+ */
+class ImageRequestValidator {
+    /**
+     * Validates the basic structure of an image generation request
+     *
+     * @param request - The request to validate
+     * @returns null if valid, ImageFailureResponse if invalid
+     */
+    validateRequestStructure(request) {
+        // Validate provider ID
+        if (!request.providerId || typeof request.providerId !== 'string') {
+            return this.createValidationError(request, 'Missing or invalid providerId', 'MISSING_PROVIDER_ID', 'providerId');
+        }
+        // Validate model ID
+        if (!request.modelId || typeof request.modelId !== 'string') {
+            return this.createValidationError(request, 'Missing or invalid modelId', 'MISSING_MODEL_ID', 'modelId');
+        }
+        // Validate prompt exists and is a string
+        if (request.prompt === undefined || request.prompt === null || typeof request.prompt !== 'string') {
+            return this.createValidationError(request, 'Missing or invalid prompt', 'MISSING_PROMPT', 'prompt');
+        }
+        // Validate prompt is not empty/whitespace
+        if (request.prompt.trim().length === 0) {
+            return this.createValidationError(request, 'Prompt cannot be empty or whitespace-only', 'EMPTY_PROMPT', 'prompt');
+        }
+        // Validate count if provided
+        if (request.count !== undefined) {
+            const countValidation = this.validateCount(request);
+            if (countValidation) {
+                return countValidation;
+            }
+        }
+        // Validate settings if provided
+        if (request.settings) {
+            const settingsValidation = this.validateSettings(request);
+            if (settingsValidation) {
+                return settingsValidation;
+            }
+        }
+        return null; // Valid
+    }
+    /**
+     * Validates the count parameter
+     *
+     * @param request - The request containing the count
+     * @returns null if valid, ImageFailureResponse if invalid
+     */
+    validateCount(request) {
+        const count = request.count;
+        if (count === undefined) {
+            return null;
+        }
+        if (!Number.isInteger(count)) {
+            return this.createValidationError(request, 'count must be an integer', 'INVALID_COUNT', 'count');
+        }
+        if (count <= 0) {
+            return this.createValidationError(request, 'count must be a positive integer (> 0)', 'INVALID_COUNT', 'count');
+        }
+        if (count > 10) {
+            return this.createValidationError(request, 'count cannot exceed 10 images per request', 'INVALID_COUNT', 'count');
+        }
+        return null;
+    }
+    /**
+     * Validates settings
+     *
+     * @param request - The request containing the settings
+     * @returns null if valid, ImageFailureResponse if invalid
+     */
+    validateSettings(request) {
+        const settings = request.settings;
+        if (!settings) {
+            return null;
+        }
+        // Validate width
+        if (settings.width !== undefined) {
+            if (!Number.isInteger(settings.width) || settings.width < 64 || settings.width > 2048) {
+                return this.createValidationError(request, 'Image width must be an integer between 64 and 2048 pixels', 'INVALID_WIDTH', 'settings.width');
+            }
+        }
+        // Validate height
+        if (settings.height !== undefined) {
+            if (!Number.isInteger(settings.height) || settings.height < 64 || settings.height > 2048) {
+                return this.createValidationError(request, 'Image height must be an integer between 64 and 2048 pixels', 'INVALID_HEIGHT', 'settings.height');
+            }
+        }
+        // Validate diffusion settings if present
+        if (settings.diffusion) {
+            const diffusion = settings.diffusion;
+            // Validate steps
+            if (diffusion.steps !== undefined) {
+                if (diffusion.steps < 1 || diffusion.steps > 150) {
+                    return this.createValidationError(request, 'Diffusion steps must be between 1 and 150', 'INVALID_DIFFUSION_STEPS', 'settings.diffusion.steps');
+                }
+            }
+            // Validate cfgScale
+            if (diffusion.cfgScale !== undefined) {
+                if (diffusion.cfgScale < 0.1 || diffusion.cfgScale > 30) {
+                    return this.createValidationError(request, 'Diffusion cfgScale must be between 0.1 and 30', 'INVALID_DIFFUSION_CFG_SCALE', 'settings.diffusion.cfgScale');
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Creates a validation error response
+     *
+     * @param request - The original request
+     * @param message - Error message
+     * @param code - Error code
+     * @param param - Parameter that caused the error
+     * @returns ImageFailureResponse
+     */
+    createValidationError(request, message, code, param) {
+        return {
+            object: 'error',
+            providerId: request.providerId || 'unknown',
+            modelId: request.modelId,
+            error: {
+                message,
+                code,
+                type: 'validation_error',
+                param,
+            },
+        };
+    }
+}
+exports.ImageRequestValidator = ImageRequestValidator;

package/dist/image/services/ImageSettingsResolver.d.ts

@@ -0,0 +1,25 @@
+import type { ImageGenerationSettings, ImageModelInfo, ResolvedImageGenerationSettings } from '../../types/image';
+/**
+ * Resolves and merges image generation settings from multiple sources
+ */
+export declare class ImageSettingsResolver {
+    /**
+     * Resolves settings by merging defaults, preset settings, and request settings
+     * Priority: Model defaults < Preset settings < Request settings
+     *
+     * @param modelInfo - Model information containing defaults
+     * @param presetSettings - Settings from preset (if any)
+     * @param requestSettings - Settings from request (if any)
+     * @returns Resolved settings with all required fields
+     */
+    resolveSettings(modelInfo: ImageModelInfo, presetSettings?: ImageGenerationSettings, requestSettings?: ImageGenerationSettings): ResolvedImageGenerationSettings;
+    /**
+     * Merges diffusion settings from multiple sources
+     *
+     * @param modelDefaults - Model default diffusion settings
+     * @param presetSettings - Preset diffusion settings
+     * @param requestSettings - Request diffusion settings
+     * @returns Merged diffusion settings
+     */
+    private mergeDiffusionSettings;
+}

package/dist/image/services/ImageSettingsResolver.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImageSettingsResolver = void 0;
+/**
+ * Resolves and merges image generation settings from multiple sources
+ */
+class ImageSettingsResolver {
+    /**
+     * Resolves settings by merging defaults, preset settings, and request settings
+     * Priority: Model defaults < Preset settings < Request settings
+     *
+     * @param modelInfo - Model information containing defaults
+     * @param presetSettings - Settings from preset (if any)
+     * @param requestSettings - Settings from request (if any)
+     * @returns Resolved settings with all required fields
+     */
+    resolveSettings(modelInfo, presetSettings, requestSettings) {
+        // Start with library defaults
+        const defaults = {
+            width: 1024,
+            height: 1024,
+            responseFormat: 'buffer',
+            quality: 'standard',
+            style: 'natural',
+        };
+        // Merge in model defaults
+        const modelDefaults = modelInfo.defaultSettings || {};
+        // Merge all settings (defaults < model < preset < request)
+        const merged = {
+            ...defaults,
+            ...modelDefaults,
+            ...(presetSettings || {}),
+            ...(requestSettings || {}),
+        };
+        // Handle diffusion settings separately (deep merge)
+        const diffusionSettings = this.mergeDiffusionSettings(modelDefaults.diffusion, presetSettings?.diffusion, requestSettings?.diffusion);
+        // Build final resolved settings
+        const resolved = {
+            width: merged.width || 1024,
+            height: merged.height || 1024,
+            responseFormat: merged.responseFormat || 'buffer',
+            quality: merged.quality || 'standard',
+            style: merged.style || 'natural',
+            user: merged.user,
+            n: merged.n,
+        };
+        if (diffusionSettings) {
+            // Ensure required diffusion fields have defaults
+            resolved.diffusion = {
+                ...diffusionSettings,
+                steps: diffusionSettings.steps || 20,
+                cfgScale: diffusionSettings.cfgScale || 7.5,
+            };
+        }
+        return resolved;
+    }
+    /**
+     * Merges diffusion settings from multiple sources
+     *
+     * @param modelDefaults - Model default diffusion settings
+     * @param presetSettings - Preset diffusion settings
+     * @param requestSettings - Request diffusion settings
+     * @returns Merged diffusion settings
+     */
+    mergeDiffusionSettings(modelDefaults, presetSettings, requestSettings) {
+        if (!modelDefaults && !presetSettings && !requestSettings) {
+            return undefined;
+        }
+        return {
+            ...(modelDefaults || {}),
+            ...(presetSettings || {}),
+            ...(requestSettings || {}),
+        };
+    }
+}
+exports.ImageSettingsResolver = ImageSettingsResolver;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export type { ApiKeyProvider } from "./types";
+export type { ApiKeyProvider, PresetMode } from "./types";
 export { LLMService } from "./llm/LLMService";
-export type { LLMServiceOptions, PresetMode, CreateMessagesResult } from "./llm/LLMService";
+export type { LLMServiceOptions, CreateMessagesResult } from "./llm/LLMService";
 export type { ModelPreset } from "./types/presets";
 export * from "./llm/types";
 export * from "./llm/clients/types";
@@ -9,6 +9,8 @@ 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 { 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";
 export { countTokens, getSmartPreview, extractRandomVariables } from "./prompting/content";
 export { parseStructuredContent, parseRoleTags, extractInitialTaggedContent, parseTemplateWithMetadata } from "./prompting/parser";

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.LlamaCppServerClient = exports.LlamaCppClientAdapter = exports.fromEnvironment = exports.LLMService = void 0;
+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; } });
@@ -30,6 +30,10 @@ 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; } });
+// --- Image Generation ---
+// Export Image Service
+var ImageService_1 = require("./image/ImageService");
+Object.defineProperty(exports, "ImageService", { enumerable: true, get: function () { return ImageService_1.ImageService; } });
 // --- Utilities ---
 var template_1 = require("./prompting/template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });

package/dist/llm/LLMService.d.ts

@@ -1,7 +1,6 @@
-import type { ApiKeyProvider } from '../types';
+import type { ApiKeyProvider, PresetMode } from '../types';
 import type { LLMChatRequest, LLMChatRequestWithPreset, LLMResponse, LLMFailureResponse, ProviderInfo, ModelInfo, ApiProviderId, LLMSettings, ModelContext, LLMMessage } from "./types";
 import type { ModelPreset } from "../types/presets";
-import { type PresetMode } from "./services/PresetManager";
 export type { PresetMode };
 /**
  * Options for configuring the LLMService
@@ -129,11 +128,11 @@ export declare class LLMService {
      *
      * @returns Map of provider IDs to adapter info
      */
-    getRegisteredAdapters(): Map<string, import("./services/AdapterRegistry").AdapterInfo>;
+    getRegisteredAdapters(): Map<string, import("../shared/services/AdapterRegistry").AdapterInfo<string>>;
     /**
      * Gets a summary of available providers and their adapter status
      *
      * @returns Summary of provider availability
      */
-    getProviderSummary(): import("./services/AdapterRegistry").ProviderSummary;
+    getProviderSummary(): import("../shared/services/AdapterRegistry").ProviderSummary;
 }

package/dist/llm/LLMService.js

@@ -1,14 +1,19 @@
 "use strict";
 // AI Summary: Main process service for LLM operations, integrating with ApiKeyProvider for secure key access.
 // Orchestrates LLM requests through provider-specific client adapters with proper error handling.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LLMService = void 0;
 const config_1 = require("./config");
 const template_1 = require("../prompting/template");
 const parser_1 = require("../prompting/parser");
+const llm_presets_json_1 = __importDefault(require("../config/llm-presets.json"));
+const MockClientAdapter_1 = require("./clients/MockClientAdapter");
 // Import the extracted services
-const PresetManager_1 = require("./services/PresetManager");
-const AdapterRegistry_1 = require("./services/AdapterRegistry");
+const PresetManager_1 = require("../shared/services/PresetManager");
+const AdapterRegistry_1 = require("../shared/services/AdapterRegistry");
 const RequestValidator_1 = require("./services/RequestValidator");
 const SettingsManager_1 = require("./services/SettingsManager");
 const ModelResolver_1 = require("./services/ModelResolver");
@@ -27,8 +32,13 @@ class LLMService {
     constructor(getApiKey, options = {}) {
         this.getApiKey = getApiKey;
         // Initialize services
-        this.presetManager = new PresetManager_1.PresetManager(options.presets, options.presetMode);
-        this.adapterRegistry = new AdapterRegistry_1.AdapterRegistry();
+        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.requestValidator = new RequestValidator_1.RequestValidator();
         this.settingsManager = new SettingsManager_1.SettingsManager();
         this.modelResolver = new ModelResolver_1.ModelResolver(this.presetManager, this.adapterRegistry);

package/dist/llm/clients/AnthropicClientAdapter.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AnthropicClientAdapter = void 0;
 const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
 const types_1 = require("./types");
-const adapterErrorUtils_1 = require("./adapterErrorUtils");
+const errorUtils_1 = require("../../shared/adapters/errorUtils");
 /**
  * Client adapter for Anthropic API integration
  *
@@ -304,7 +304,7 @@ class AnthropicClientAdapter {
     createErrorResponse(error, request) {
         // Use shared error mapping utility for common error patterns
         const initialProviderMessage = error instanceof sdk_1.default.APIError ? error.message : undefined;
-        let { errorCode, errorMessage, errorType, status } = (0, adapterErrorUtils_1.getCommonMappedErrorDetails)(error, initialProviderMessage);
+        let { errorCode, errorMessage, errorType, status } = (0, errorUtils_1.getCommonMappedErrorDetails)(error, initialProviderMessage);
         // Apply Anthropic-specific refinements for 400 errors based on message content
         if (error instanceof sdk_1.default.APIError && status === 400) {
             if (error.message.toLowerCase().includes("context length") ||

package/dist/llm/clients/GeminiClientAdapter.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GeminiClientAdapter = void 0;
 const genai_1 = require("@google/genai");
 const types_1 = require("./types");
-const adapterErrorUtils_1 = require("./adapterErrorUtils");
+const errorUtils_1 = require("../../shared/adapters/errorUtils");
 /**
  * Client adapter for Google Gemini API integration
  *
@@ -276,7 +276,7 @@ class GeminiClientAdapter {
     createErrorResponse(error, request) {
         // Use shared error mapping utility for common error patterns
         const initialProviderMessage = error?.message;
-        let { errorCode, errorMessage, errorType, status } = (0, adapterErrorUtils_1.getCommonMappedErrorDetails)(error, initialProviderMessage);
+        let { errorCode, errorMessage, errorType, status } = (0, errorUtils_1.getCommonMappedErrorDetails)(error, initialProviderMessage);
         // Apply Gemini-specific refinements for certain error types
         if (error && error.message) {
             const message = error.message.toLowerCase();

package/dist/llm/clients/LlamaCppClientAdapter.d.ts

@@ -40,7 +40,7 @@ export interface LlamaCppClientConfig {
  * // Use via LLMService
  * const response = await service.sendMessage({
  *   providerId: 'llamacpp',
- *   modelId: 'llama-3-8b-instruct',
+ *   modelId: 'llamacpp',
  *   messages: [{ role: 'user', content: 'Hello!' }]
  * });
  * ```

package/dist/llm/clients/LlamaCppClientAdapter.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LlamaCppClientAdapter = void 0;
 const openai_1 = __importDefault(require("openai"));
 const types_1 = require("./types");
-const adapterErrorUtils_1 = require("./adapterErrorUtils");
+const errorUtils_1 = require("../../shared/adapters/errorUtils");
 const LlamaCppServerClient_1 = require("./LlamaCppServerClient");
 const config_1 = require("../config");
 /**
@@ -41,7 +41,7 @@ const config_1 = require("../config");
  * // Use via LLMService
  * const response = await service.sendMessage({
  *   providerId: 'llamacpp',
- *   modelId: 'llama-3-8b-instruct',
+ *   modelId: 'llamacpp',
  *   messages: [{ role: 'user', content: 'Hello!' }]
  * });
  * ```
@@ -351,7 +351,7 @@ class LlamaCppClientAdapter {
             };
         }
         // Use common error mapping for other errors
-        const mappedError = (0, adapterErrorUtils_1.getCommonMappedErrorDetails)(error);
+        const mappedError = (0, errorUtils_1.getCommonMappedErrorDetails)(error);
         return {
             provider: request.providerId,
             model: request.modelId,

package/dist/llm/clients/OpenAIClientAdapter.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAIClientAdapter = void 0;
 const openai_1 = __importDefault(require("openai"));
 const types_1 = require("./types");
-const adapterErrorUtils_1 = require("./adapterErrorUtils");
+const errorUtils_1 = require("../../shared/adapters/errorUtils");
 /**
  * Client adapter for OpenAI API integration
  *
@@ -214,7 +214,7 @@ class OpenAIClientAdapter {
     createErrorResponse(error, request) {
         // Use shared error mapping utility for common error patterns
         const initialProviderMessage = error instanceof openai_1.default.APIError ? error.message : undefined;
-        let { errorCode, errorMessage, errorType, status } = (0, adapterErrorUtils_1.getCommonMappedErrorDetails)(error, initialProviderMessage);
+        let { errorCode, errorMessage, errorType, status } = (0, errorUtils_1.getCommonMappedErrorDetails)(error, initialProviderMessage);
         // Apply OpenAI-specific refinements for 400 errors based on message content
         if (error instanceof openai_1.default.APIError && status === 400) {
             if (error.message.toLowerCase().includes("context length")) {

package/dist/llm/config.js

@@ -573,39 +573,15 @@ exports.SUPPORTED_MODELS = [
         supportsImages: false,
         supportsPromptCache: false,
     },
-    // llama.cpp Models (examples - users can specify any loaded model)
+    // llama.cpp Model (generic - actual model determined by llama.cpp server)
     {
-        id: "llama-3-8b-instruct",
-        name: "Llama 3 8B Instruct",
-        providerId: "llamacpp",
-        contextWindow: 8192,
-        inputPrice: 0.0,
-        outputPrice: 0.0,
-        description: "Local Llama 3 8B model via llama.cpp server",
-        maxTokens: 4096,
-        supportsImages: false,
-        supportsPromptCache: false,
-    },
-    {
-        id: "llama-3-70b-instruct",
-        name: "Llama 3 70B Instruct",
+        id: "llamacpp",
+        name: "llama.cpp Local Model",
         providerId: "llamacpp",
         contextWindow: 8192,
         inputPrice: 0.0,
         outputPrice: 0.0,
-        description: "Local Llama 3 70B model via llama.cpp server",
-        maxTokens: 4096,
-        supportsImages: false,
-        supportsPromptCache: false,
-    },
-    {
-        id: "mistral-7b-instruct",
-        name: "Mistral 7B Instruct",
-        providerId: "llamacpp",
-        contextWindow: 32768,
-        inputPrice: 0.0,
-        outputPrice: 0.0,
-        description: "Local Mistral 7B model via llama.cpp server",
+        description: "Local model running via llama.cpp server (model determined by server)",
         maxTokens: 4096,
         supportsImages: false,
         supportsPromptCache: false,

package/dist/llm/services/ModelResolver.d.ts

@@ -1,6 +1,8 @@
-import type { LLMFailureResponse, LLMSettings, ModelInfo } from "../types";
-import { PresetManager } from "./PresetManager";
-import { AdapterRegistry } from "./AdapterRegistry";
+import type { LLMFailureResponse, LLMSettings, ModelInfo, ApiProviderId } from "../types";
+import type { ILLMClientAdapter } from "../clients/types";
+import type { ModelPreset } from "../../types/presets";
+import { PresetManager } from "../../shared/services/PresetManager";
+import { AdapterRegistry } from "../../shared/services/AdapterRegistry";
 /**
  * Options for model selection
  */
@@ -26,7 +28,7 @@ export interface ModelResolution {
 export declare class ModelResolver {
     private presetManager;
     private adapterRegistry;
-    constructor(presetManager: PresetManager, adapterRegistry: AdapterRegistry);
+    constructor(presetManager: PresetManager<ModelPreset>, adapterRegistry: AdapterRegistry<ILLMClientAdapter, ApiProviderId>);
     /**
      * Resolves model information from either a preset ID or provider/model IDs
      *

package/dist/providers/fromEnvironment.d.ts

@@ -1,12 +1,16 @@
 import type { ApiKeyProvider } from "../types";
 /**
  * Creates an ApiKeyProvider that sources keys from system environment variables.
- * It looks for variables in the format: PROVIDERID_API_KEY (e.g., OPENAI_API_KEY).
+ * It looks for variables in the format: PROVIDERID_API_KEY (e.g., OPENAI_IMAGES_API_KEY).
  * This is a secure and standard practice for server-side applications.
  * Note: Provider IDs are converted to uppercase.
  *
  * Special handling:
  * - llamacpp: Returns 'not-needed' (local server, no authentication)
  * - mock: Returns 'not-needed' (test provider, no authentication)
+ * - genai-electron-images: Returns 'not-needed' (local server, no authentication)
+ *
+ * Provider Aliases:
+ * - openai-images: Also accepts OPENAI_API_KEY (standard OpenAI env var)
  */
 export declare const fromEnvironment: ApiKeyProvider;

package/dist/providers/fromEnvironment.js

@@ -1,22 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fromEnvironment = void 0;
+/**
+ * Provider-specific environment variable aliases.
+ * Allows providers to accept alternative env var names for convenience.
+ *
+ * Example: 'openai-images' accepts both OPENAI_IMAGES_API_KEY and OPENAI_API_KEY
+ */
+const PROVIDER_ENV_VAR_ALIASES = {
+    'openai-images': ['OPENAI'], // Accepts standard OPENAI_API_KEY
+};
 /**
  * Creates an ApiKeyProvider that sources keys from system environment variables.
- * It looks for variables in the format: PROVIDERID_API_KEY (e.g., OPENAI_API_KEY).
+ * It looks for variables in the format: PROVIDERID_API_KEY (e.g., OPENAI_IMAGES_API_KEY).
  * This is a secure and standard practice for server-side applications.
  * Note: Provider IDs are converted to uppercase.
  *
  * Special handling:
  * - llamacpp: Returns 'not-needed' (local server, no authentication)
  * - mock: Returns 'not-needed' (test provider, no authentication)
+ * - genai-electron-images: Returns 'not-needed' (local server, no authentication)
+ *
+ * Provider Aliases:
+ * - openai-images: Also accepts OPENAI_API_KEY (standard OpenAI env var)
  */
 const fromEnvironment = async (providerId) => {
     // Providers that don't require API keys (local/test providers)
-    if (providerId === 'llamacpp' || providerId === 'mock') {
+    if (providerId === 'llamacpp' || providerId === 'mock' || providerId === 'genai-electron-images') {
         return 'not-needed';
     }
-    const envVarName = `${providerId.toUpperCase()}_API_KEY`;
-    return process.env[envVarName] || null;
+    // Try standard env var first: PROVIDERID_API_KEY
+    const standardEnvVar = `${providerId.toUpperCase().replace(/-/g, '_')}_API_KEY`;
+    if (process.env[standardEnvVar]) {
+        return process.env[standardEnvVar];
+    }
+    // Try aliases
+    const aliases = PROVIDER_ENV_VAR_ALIASES[providerId] || [];
+    for (const alias of aliases) {
+        const aliasEnvVar = `${alias.toUpperCase()}_API_KEY`;
+        if (process.env[aliasEnvVar]) {
+            return process.env[aliasEnvVar];
+        }
+    }
+    return null;
 };
 exports.fromEnvironment = fromEnvironment;

package/dist/shared/adapters/errorUtils.d.ts

@@ -0,0 +1,26 @@
+import { type AdapterErrorCode } from '../../llm/clients/types';
+/**
+ * Mapped error details returned by the utility function
+ */
+export interface MappedErrorDetails {
+    errorCode: AdapterErrorCode;
+    errorMessage: string;
+    errorType: string;
+    status?: number;
+}
+/**
+ * Maps common error patterns to standardized error codes and types
+ *
+ * This utility handles:
+ * - Common HTTP status codes (401, 402, 404, 429, 4xx, 5xx)
+ * - Network connection errors (ENOTFOUND, ECONNREFUSED, timeouts)
+ * - Generic JavaScript errors
+ *
+ * Individual adapters can further refine the mappings for provider-specific cases,
+ * particularly for 400 errors where message content determines the specific error type.
+ *
+ * @param error - The error object from the provider SDK or network layer
+ * @param providerMessageOverride - Optional override for the error message (e.g., from provider SDK)
+ * @returns Mapped error details with standardized codes and types
+ */
+export declare function getCommonMappedErrorDetails(error: any, providerMessageOverride?: string): MappedErrorDetails;