@xbg.solutions/utils-llm-connector 1.0.0

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+import { LLMConnector } from './llm-connector';
+export { LLMConnector };
+export * from './types';
+export * from './providers';
+/**
+ * Get the default LLM connector instance
+ * Uses project configuration if available, otherwise falls back to environment-based config
+ */
+export declare function getLLMConnector(): LLMConnector;
+/**
+ * Singleton instance for convenience
+ * This will use the project configuration automatically
+ */
+export declare const llmConnector: LLMConnector;
+export default llmConnector;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAK5B;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAa9C;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAoB,CAAC;AAG9C,eAAe,YAAY,CAAC"}

package/lib/index.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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.llmConnector = exports.LLMConnector = void 0;
+exports.getLLMConnector = getLLMConnector;
+// Main connector class
+const llm_connector_1 = require("./llm-connector");
+Object.defineProperty(exports, "LLMConnector", { enumerable: true, get: function () { return llm_connector_1.LLMConnector; } });
+// Types
+__exportStar(require("./types"), exports);
+// Providers (for advanced usage)
+__exportStar(require("./providers"), exports);
+// Create singleton instance with project config
+let defaultConnector = null;
+/**
+ * Get the default LLM connector instance
+ * Uses project configuration if available, otherwise falls back to environment-based config
+ */
+function getLLMConnector() {
+    if (!defaultConnector) {
+        try {
+            // Try to import project-specific configuration
+            const { PROVIDER_CONFIGS } = require('../../config/llm-providers.config');
+            defaultConnector = new llm_connector_1.LLMConnector(PROVIDER_CONFIGS);
+        }
+        catch (error) {
+            // Fall back to default configuration if project config not found
+            console.warn('Project LLM configuration not found, using default configuration');
+            defaultConnector = new llm_connector_1.LLMConnector();
+        }
+    }
+    return defaultConnector;
+}
+/**
+ * Singleton instance for convenience
+ * This will use the project configuration automatically
+ */
+exports.llmConnector = getLLMConnector();
+// Re-export for convenience
+exports.default = exports.llmConnector;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAiBA,0CAaC;AA9BD,uBAAuB;AACvB,mDAA+C;AACtC,6FADA,4BAAY,OACA;AAErB,QAAQ;AACR,0CAAwB;AAExB,iCAAiC;AACjC,8CAA4B;AAE5B,gDAAgD;AAChD,IAAI,gBAAgB,GAAwB,IAAI,CAAC;AAEjD;;;GAGG;AACH,SAAgB,eAAe;IAC7B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,+CAA+C;YAC/C,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;YAC1E,gBAAgB,GAAG,IAAI,4BAAY,CAAC,gBAAgB,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iEAAiE;YACjE,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YACjF,gBAAgB,GAAG,IAAI,4BAAY,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACU,QAAA,YAAY,GAAG,eAAe,EAAE,CAAC;AAE9C,4BAA4B;AAC5B,kBAAe,oBAAY,CAAC"}

package/lib/llm-connector.d.ts

@@ -0,0 +1,67 @@
+import { TextGenerationRequest, TextGenerationResponse, ImageAnalysisRequest, ImageAnalysisResponse, ProviderInfo, ProviderConfig } from './types';
+/**
+ * Main LLM Connector class that orchestrates multiple providers
+ * Provides a unified interface for text generation and image analysis
+ */
+export declare class LLMConnector {
+    private providers;
+    private config;
+    constructor(config?: Record<string, ProviderConfig>);
+    /**
+     * Generate text completion using specified provider
+     */
+    generateText(request: TextGenerationRequest): Promise<TextGenerationResponse>;
+    /**
+     * Analyze image content using specified provider
+     */
+    analyzeImage(request: ImageAnalysisRequest): Promise<ImageAnalysisResponse>;
+    /**
+     * Get information about all available providers
+     */
+    getAvailableProviders(): ProviderInfo[];
+    /**
+     * Get information about a specific provider
+     */
+    getProviderInfo(providerName: string): ProviderInfo;
+    /**
+     * Check if a provider supports a specific feature
+     */
+    supportsFeature(providerName: string, feature: 'text-generation' | 'image-analysis'): boolean;
+    /**
+     * Get enabled provider names
+     */
+    getEnabledProviders(): string[];
+    /**
+     * Get provider configuration
+     */
+    getProviderConfig(providerName: string): ProviderConfig | undefined;
+    /**
+     * Update provider configuration (runtime reconfiguration)
+     */
+    updateProviderConfig(providerName: string, newConfig: Partial<ProviderConfig>): void;
+    /**
+     * Add a new provider dynamically
+     */
+    addProvider(name: string, config: ProviderConfig): void;
+    /**
+     * Remove a provider
+     */
+    removeProvider(providerName: string): void;
+    /**
+     * Get a provider instance
+     */
+    private getProvider;
+    /**
+     * Initialize all enabled providers
+     */
+    private initializeProviders;
+    /**
+     * Initialize a single provider
+     */
+    private initializeProvider;
+    /**
+     * Get default configuration (fallback when no config provided)
+     */
+    private getDefaultConfig;
+}
+//# sourceMappingURL=llm-connector.d.ts.map

package/lib/llm-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-connector.d.ts","sourceRoot":"","sources":["../src/llm-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC;AAUjB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAcnD;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAUnF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUjF;;OAEG;IACH,qBAAqB,IAAI,YAAY,EAAE;IAIvC;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY;IAKnD;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,OAAO;IAU7F;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAM/B;;OAEG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInE;;OAEG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAkBpF;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAOvD;;OAEG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAK1C;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiCzB"}

package/lib/llm-connector.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMConnector = void 0;
+const providers_1 = require("./providers");
+/**
+ * Main LLM Connector class that orchestrates multiple providers
+ * Provides a unified interface for text generation and image analysis
+ */
+class LLMConnector {
+    constructor(config) {
+        this.providers = new Map();
+        // Use provided config or import default config
+        if (config) {
+            this.config = config;
+        }
+        else {
+            // Import default config dynamically to avoid circular dependencies
+            this.config = this.getDefaultConfig();
+        }
+        this.initializeProviders();
+    }
+    /**
+     * Generate text completion using specified provider
+     */
+    async generateText(request) {
+        const provider = this.getProvider(request.provider);
+        if (!this.supportsFeature(request.provider, 'text-generation')) {
+            throw new Error(`Provider '${request.provider}' does not support text generation`);
+        }
+        return await provider.generateText(request);
+    }
+    /**
+     * Analyze image content using specified provider
+     */
+    async analyzeImage(request) {
+        const provider = this.getProvider(request.provider);
+        if (!this.supportsFeature(request.provider, 'image-analysis')) {
+            throw new Error(`Provider '${request.provider}' does not support image analysis`);
+        }
+        return await provider.analyzeImage(request);
+    }
+    /**
+     * Get information about all available providers
+     */
+    getAvailableProviders() {
+        return Array.from(this.providers.values()).map(provider => provider.getInfo());
+    }
+    /**
+     * Get information about a specific provider
+     */
+    getProviderInfo(providerName) {
+        const provider = this.getProvider(providerName);
+        return provider.getInfo();
+    }
+    /**
+     * Check if a provider supports a specific feature
+     */
+    supportsFeature(providerName, feature) {
+        try {
+            const provider = this.getProvider(providerName);
+            const info = provider.getInfo();
+            return info.supportedFeatures.includes(feature);
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Get enabled provider names
+     */
+    getEnabledProviders() {
+        return Object.entries(this.config)
+            .filter(([, config]) => config.enabled)
+            .map(([name]) => name);
+    }
+    /**
+     * Get provider configuration
+     */
+    getProviderConfig(providerName) {
+        return this.config[providerName];
+    }
+    /**
+     * Update provider configuration (runtime reconfiguration)
+     */
+    updateProviderConfig(providerName, newConfig) {
+        const currentConfig = this.config[providerName];
+        if (!currentConfig) {
+            throw new Error(`Provider '${providerName}' not found in configuration`);
+        }
+        // Update config
+        this.config[providerName] = Object.assign(Object.assign({}, currentConfig), newConfig);
+        // Reinitialize provider if it exists and is still enabled
+        if (this.config[providerName].enabled) {
+            this.initializeProvider(providerName, this.config[providerName]);
+        }
+        else {
+            // Remove provider if disabled
+            this.providers.delete(providerName);
+        }
+    }
+    /**
+     * Add a new provider dynamically
+     */
+    addProvider(name, config) {
+        this.config[name] = config;
+        if (config.enabled) {
+            this.initializeProvider(name, config);
+        }
+    }
+    /**
+     * Remove a provider
+     */
+    removeProvider(providerName) {
+        this.providers.delete(providerName);
+        delete this.config[providerName];
+    }
+    /**
+     * Get a provider instance
+     */
+    getProvider(providerName) {
+        const provider = this.providers.get(providerName);
+        if (!provider) {
+            const availableProviders = Array.from(this.providers.keys()).join(', ');
+            throw new Error(`Provider '${providerName}' not found or not enabled. Available providers: ${availableProviders}`);
+        }
+        return provider;
+    }
+    /**
+     * Initialize all enabled providers
+     */
+    initializeProviders() {
+        Object.entries(this.config).forEach(([name, config]) => {
+            if (config.enabled) {
+                try {
+                    this.initializeProvider(name, config);
+                }
+                catch (error) {
+                    console.warn(`Failed to initialize provider '${name}':`, error);
+                }
+            }
+        });
+        if (this.providers.size === 0) {
+            console.warn('No LLM providers were successfully initialized');
+        }
+    }
+    /**
+     * Initialize a single provider
+     */
+    initializeProvider(name, config) {
+        switch (name) {
+            case 'claude':
+                this.providers.set(name, new providers_1.ClaudeProvider(config));
+                break;
+            case 'openai':
+                this.providers.set(name, new providers_1.OpenAIProvider(config));
+                break;
+            case 'gemini':
+                this.providers.set(name, new providers_1.GeminiProvider(config));
+                break;
+            case 'google-lens':
+                this.providers.set(name, new providers_1.GoogleLensProvider(config));
+                break;
+            default:
+                console.warn(`Unknown provider: ${name}. Skipping initialization.`);
+                break;
+        }
+    }
+    /**
+     * Get default configuration (fallback when no config provided)
+     */
+    getDefaultConfig() {
+        // Minimal default configuration
+        return {
+            claude: {
+                name: 'claude',
+                enabled: !!process.env.ANTHROPIC_API_KEY,
+                defaultModel: 'claude-3-5-sonnet-20241022',
+                timeout: 30000,
+                maxRetries: 2
+            },
+            openai: {
+                name: 'openai',
+                enabled: !!process.env.OPENAI_API_KEY,
+                defaultModel: 'gpt-4o',
+                timeout: 30000,
+                maxRetries: 2
+            },
+            gemini: {
+                name: 'gemini',
+                enabled: !!process.env.GOOGLE_AI_API_KEY,
+                defaultModel: 'gemini-1.5-pro',
+                timeout: 30000,
+                maxRetries: 2
+            },
+            'google-lens': {
+                name: 'google-lens',
+                enabled: !!process.env.GOOGLE_CLOUD_API_KEY || !!process.env.GOOGLE_APPLICATION_CREDENTIALS,
+                defaultModel: 'vision-product-search',
+                timeout: 15000,
+                maxRetries: 1
+            }
+        };
+    }
+}
+exports.LLMConnector = LLMConnector;
+//# sourceMappingURL=llm-connector.js.map

package/lib/llm-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-connector.js","sourceRoot":"","sources":["../src/llm-connector.ts"],"names":[],"mappings":"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"}

package/lib/providers/base.provider.d.ts

@@ -0,0 +1,51 @@
+import { TextGenerationRequest, TextGenerationResponse, ImageAnalysisRequest, ImageAnalysisResponse, BaseResponse, UsageMetrics, ProviderInfo, ProviderConfig } from '../types';
+/**
+ * Abstract base class for all LLM providers
+ * Provides common functionality and enforces consistent interface
+ */
+export declare abstract class BaseProvider {
+    protected name: string;
+    protected config: ProviderConfig;
+    constructor(name: string, config: ProviderConfig);
+    /**
+     * Generate text completion
+     */
+    abstract generateText(request: TextGenerationRequest): Promise<TextGenerationResponse>;
+    /**
+     * Analyze image content
+     */
+    abstract analyzeImage(request: ImageAnalysisRequest): Promise<ImageAnalysisResponse>;
+    /**
+     * Get provider information
+     */
+    abstract getInfo(): ProviderInfo;
+    /**
+     * Get API key - user provided or environment variable
+     */
+    protected getApiKey(userProvidedKey?: string): string;
+    /**
+     * Get the environment variable name for this provider's API key
+     */
+    protected abstract getApiKeyEnvVar(): string;
+    /**
+     * Create a standardized base response
+     */
+    protected createBaseResponse(requestId: string, usage: UsageMetrics): BaseResponse;
+    /**
+     * Generate a unique request ID for tracking
+     */
+    protected generateRequestId(): string;
+    /**
+     * Handle provider-specific errors with common error mapping
+     */
+    protected handleProviderError(error: any, requestId: string, model: string): BaseResponse;
+    /**
+     * Validate request before processing
+     */
+    protected validateRequest(request: TextGenerationRequest | ImageAnalysisRequest): void;
+    /**
+     * Apply rate limiting if configured
+     */
+    protected applyRateLimit(): Promise<void>;
+}
+//# sourceMappingURL=base.provider.d.ts.map

package/lib/providers/base.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.provider.d.ts","sourceRoot":"","sources":["../../src/providers/base.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACf,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,8BAAsB,YAAY;IAChC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;gBAErB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAKhD;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAEtF;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAEpF;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,YAAY;IAEhC;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM;IAarD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,MAAM;IAE5C;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY;IAUlF;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IA4BzF;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,IAAI;IAqBtF;;OAEG;cACa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhD"}

package/lib/providers/base.provider.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseProvider = void 0;
+/**
+ * Abstract base class for all LLM providers
+ * Provides common functionality and enforces consistent interface
+ */
+class BaseProvider {
+    constructor(name, config) {
+        this.name = name;
+        this.config = config;
+    }
+    /**
+     * Get API key - user provided or environment variable
+     */
+    getApiKey(userProvidedKey) {
+        // Use user-provided key if available, otherwise platform key
+        if (userProvidedKey) {
+            return userProvidedKey;
+        }
+        const envKey = process.env[this.getApiKeyEnvVar()];
+        if (!envKey) {
+            throw new Error(`API key not found for provider '${this.name}'. Set ${this.getApiKeyEnvVar()} environment variable.`);
+        }
+        return envKey;
+    }
+    /**
+     * Create a standardized base response
+     */
+    createBaseResponse(requestId, usage) {
+        return {
+            success: true,
+            usage,
+            provider: this.name,
+            model: '', // Will be set by concrete implementation
+            requestId
+        };
+    }
+    /**
+     * Generate a unique request ID for tracking
+     */
+    generateRequestId() {
+        return `${this.name}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Handle provider-specific errors with common error mapping
+     */
+    handleProviderError(error, requestId, model) {
+        const errorMap = {
+            'rate_limit_exceeded': 'Rate limit exceeded for provider',
+            'invalid_api_key': 'Invalid API key provided',
+            'quota_exceeded': 'API quota exceeded',
+            'model_not_found': 'Requested model not available',
+            'timeout': 'Request timeout',
+            'insufficient_quota': 'Insufficient API quota',
+            'invalid_request': 'Invalid request format'
+        };
+        const mappedError = errorMap[error.code] || error.message || 'Unknown provider error';
+        return {
+            success: false,
+            error: mappedError,
+            usage: {
+                inputTokens: 0,
+                outputTokens: 0,
+                totalTokens: 0,
+                processingTimeMs: 0
+            },
+            provider: this.name,
+            model,
+            requestId
+        };
+    }
+    /**
+     * Validate request before processing
+     */
+    validateRequest(request) {
+        var _a;
+        if (!request.provider || request.provider !== this.name) {
+            throw new Error(`Invalid provider. Expected '${this.name}', got '${request.provider}'`);
+        }
+        if (!request.model) {
+            throw new Error('Model is required');
+        }
+        // Type-specific validation
+        if ('prompt' in request && !((_a = request.prompt) === null || _a === void 0 ? void 0 : _a.trim())) {
+            throw new Error('Prompt is required for text generation');
+        }
+        if ('imageUrl' in request || 'imageBase64' in request) {
+            if (!request.imageUrl && !request.imageBase64) {
+                throw new Error('Either imageUrl or imageBase64 is required for image analysis');
+            }
+        }
+    }
+    /**
+     * Apply rate limiting if configured
+     */
+    async applyRateLimit() {
+        if (this.config.rateLimits) {
+            // Basic rate limiting implementation
+            // In production, this would use Redis or similar for distributed rate limiting
+            console.log(`Rate limits configured for ${this.name}:`, this.config.rateLimits);
+        }
+    }
+}
+exports.BaseProvider = BaseProvider;
+//# sourceMappingURL=base.provider.js.map

package/lib/providers/base.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.provider.js","sourceRoot":"","sources":["../../src/providers/base.provider.ts"],"names":[],"mappings":"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"}

package/lib/providers/claude.provider.d.ts

@@ -0,0 +1,26 @@
+import { BaseProvider } from './base.provider';
+import { TextGenerationRequest, TextGenerationResponse, ImageAnalysisRequest, ImageAnalysisResponse, ProviderInfo, ProviderConfig } from '../types';
+/**
+ * Anthropic Claude provider implementation
+ * Supports text generation with Claude models
+ */
+export declare class ClaudeProvider extends BaseProvider {
+    constructor(config: ProviderConfig);
+    generateText(request: TextGenerationRequest): Promise<TextGenerationResponse>;
+    analyzeImage(request: ImageAnalysisRequest): Promise<ImageAnalysisResponse>;
+    getInfo(): ProviderInfo;
+    protected getApiKeyEnvVar(): string;
+    /**
+     * Calculate estimated cost based on usage and model
+     */
+    private calculateCost;
+    /**
+     * Map Claude's finish reasons to our standard format
+     */
+    private mapFinishReason;
+    /**
+     * Dynamically import Anthropic SDK
+     */
+    private getAnthropicSDK;
+}
+//# sourceMappingURL=claude.provider.d.ts.map

package/lib/providers/claude.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.provider.d.ts","sourceRoot":"","sources":["../../src/providers/claude.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EAErB,YAAY,EACZ,cAAc,EACf,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,MAAM,EAAE,cAAc;IAI5B,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiE7E,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwBjF,OAAO,IAAI,YAAY;IAkCvB,SAAS,CAAC,eAAe,IAAI,MAAM;IAInC;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,eAAe;CAQ9B"}