@xopcai/xopcbot 0.1.3 → 0.2.0

package/dist/providers/index.js

@@ -1,55 +1,281 @@
 /**
- * Provider Module
- *
- * LLM provider implementations.
- *
- * New Architecture (ModelRegistry):
- * - registry.ts: Model registration and management
- * - pi-ai.ts: Unified provider adapter with strict types
- * - api-strategies.ts: Provider-specific API option builders
- * - config.ts: Centralized provider configuration
- * - provider-catalog.ts: Unified provider definitions
- * - model-catalog.ts: Model capabilities system
- *
- * Auth Profiles:
- * - auth/profiles/: Advanced credential management with OAuth support
+ * Model provider module - integrates built-in models with custom models from models.json
  */
-// Core exports
-export { LLMProviderImpl, createProvider, getAvailableModels, listAllModels } from './pi-ai.js';
-// ModelRegistry exports
-export { ModelRegistry, resolveConfigValue, PROVIDER_INFO, registerOAuthRefresh, } from './registry.js';
-// API strategies
-export { getApiStrategy, buildProviderOptions } from './api-strategies.js';
-// Configuration
-export { createProviderConfig, loadProviderConfigFromEnv, DEFAULT_PROVIDER_CONFIG, } from './config.js';
-// ============================================
-// Provider Catalog
-// ============================================
-export { 
-// Core
-PROVIDER_CATALOG, getProvider, getAllProviders, 
-// Detection & Configuration
-detectProviderByModel, isProviderConfigured, getConfiguredProviders, getProviderApiKey, 
-// Display
-getProviderDisplayInfo, getAllProviderDisplayInfo, 
-// Model reference parsing
-parseModelRef, registerCustomProvider, createCustomProviderFromConfig, } from './provider-catalog.js';
-// ============================================
-// Auto Discovery
-// ============================================
-export { scanProviders, recommendDefaultModel, generateAutoConfig, generateConfigTemplate, quickSetup, isModelAvailable, getBestAvailableModel, printDiagnostic, getConfigSummary, } from './auto-discovery.js';
+import { getModel as getPiAiModel, getModels as getPiAiModels, getProviders as getPiAiProviders, } from '@mariozechner/pi-ai';
+import { getModelRegistry } from './model-registry.js';
 // ============================================
-// Model Catalog
+// Provider Environment Variable Mappings
 // ============================================
-export { 
-// Core
-MODEL_CATALOG, getAllModels, findModel, findModelByProvider, findModelByRef, getModelsByProvider, 
-// Recommendations
-getRecommendedModels, getModelsForTask, 
-// Capabilities
-getModelsByCapability, getModelsByModality, getVisionModels, getFunctionCallingModels, modelSupportsModality, modelSupportsFeature, 
-// Pricing & Performance
-estimateCost, getModelComparisonInfo, 
-// Utilities
-getFullModelRef, parseModelReference, registerCustomModel, } from './model-catalog.js';
+// Unified mapping of provider -> environment variable names
+// This is the single source of truth for API key resolution
+export const PROVIDER_ENV_MAP = {
+    openai: ['OPENAI_API_KEY'],
+    anthropic: ['ANTHROPIC_API_KEY'],
+    google: ['GEMINI_API_KEY', 'GOOGLE_API_KEY'],
+    'google-vertex': ['GOOGLE_CLOUD_PROJECT', 'GOOGLE_CLOUD_LOCATION'],
+    groq: ['GROQ_API_KEY'],
+    deepseek: ['DEEPSEEK_API_KEY'],
+    xai: ['XAI_API_KEY'],
+    cerebras: ['CEREBRAS_API_KEY'],
+    mistral: ['MISTRAL_API_KEY'],
+    openrouter: ['OPENROUTER_API_KEY'],
+    'azure-openai-responses': ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_BASE_URL'],
+    'amazon-bedrock': ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_REGION'],
+    minimax: ['MINIMAX_API_KEY'],
+    'minimax-cn': ['MINIMAX_API_KEY'],
+    'kimi-coding': ['KIMI_API_KEY', 'MOONSHOT_API_KEY'],
+    huggingface: ['HF_TOKEN', 'HUGGINGFACE_TOKEN'],
+    opencode: ['OPENCODE_API_KEY'],
+    zai: ['ZAI_API_KEY'],
+    zhipu: ['ZHIPU_API_KEY'],
+    qwen: ['QWEN_API_KEY', 'DASHSCOPE_API_KEY'],
+    kimi: ['KIMI_API_KEY', 'MOONSHOT_API_KEY'],
+    'google-gemini-cli': ['GEMINI_CLI_TOKEN', 'GOOGLE_TOKEN'],
+    'google-antigravity': ['ANTIGRAVITY_API_KEY'],
+    vercel: ['VERCEL_TOKEN'],
+    'vercel-ai-gateway': ['VERCEL_AI_GATEWAY_API_KEY'],
+    'github-copilot': ['GITHUB_TOKEN', 'GITHUB_COPILOT_TOKEN'],
+};
+/**
+ * Get API key from environment variables for a provider
+ */
+export function getApiKeyFromEnv(provider) {
+    // Standard format: PROVIDER_API_KEY
+    const envVar = provider.toUpperCase().replace(/-/g, '_') + '_API_KEY';
+    const envKey = process.env[envVar];
+    if (envKey)
+        return envKey;
+    // Provider-specific env var mappings
+    const keys = PROVIDER_ENV_MAP[provider] || [];
+    for (const key of keys) {
+        if (process.env[key])
+            return process.env[key];
+    }
+    return undefined;
+}
+/**
+ * Resolve model reference. Supports:
+ * - "provider/modelId" format
+ * - "modelId" auto-detection via pi-ai or custom models
+ * @throws if model not found
+ */
+export function resolveModel(ref) {
+    // First try ModelRegistry (includes custom models)
+    const registry = getModelRegistry();
+    const customModel = registry.resolve(ref);
+    if (customModel) {
+        return customModel;
+    }
+    // Fall back to built-in models
+    if (ref.includes('/')) {
+        const [provider, modelId] = ref.split('/');
+        const model = getPiAiModel(provider, modelId);
+        if (!model)
+            throw new Error(`Model not found: ${ref}`);
+        return model;
+    }
+    for (const provider of getPiAiProviders()) {
+        try {
+            const models = getPiAiModels(provider);
+            const found = models.find(m => m.id === ref);
+            if (found)
+                return found;
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error(`Model not found: ${ref}. Use format: provider/model-id`);
+}
+export function getModelsByProvider(provider) {
+    // Get from registry (includes custom models)
+    const registry = getModelRegistry();
+    return registry.getAll().filter(m => m.provider === provider);
+}
+export function getAllProviders() {
+    const registry = getModelRegistry();
+    const providers = new Set();
+    // Add built-in providers
+    for (const p of getPiAiProviders()) {
+        providers.add(p);
+    }
+    // Add custom providers from registry
+    for (const m of registry.getAll()) {
+        providers.add(m.provider);
+    }
+    return Array.from(providers);
+}
+export function getApiKey(config, provider) {
+    // Check config.providers first (simple string format only)
+    const configKey = config?.providers?.[provider];
+    if (configKey) {
+        return configKey;
+    }
+    // Check registry for custom providers (from models.json)
+    const registry = getModelRegistry();
+    const registryKey = registry.getApiKey(provider);
+    if (registryKey) {
+        return registryKey;
+    }
+    // Check environment variables
+    return getApiKeyFromEnv(provider);
+}
+export function isProviderConfigured(config, provider) {
+    return !!getApiKey(config, provider);
+}
+export function getConfiguredProviders(config) {
+    return getAllProviders().filter(p => isProviderConfigured(config, p));
+}
+export function getAllModels() {
+    const registry = getModelRegistry();
+    return registry.getAll();
+}
+export function getAvailableModels(config) {
+    const registry = getModelRegistry();
+    const allModels = registry.getAll();
+    // Filter models by checking if provider has auth configured
+    // Check in order: config.providers -> registry.getApiKey() -> environment variables
+    return allModels.filter(model => {
+        // Check config.providers first
+        if (config?.providers?.[model.provider]) {
+            return true;
+        }
+        // Check registry (models.json custom providers)
+        if (registry.getApiKey(model.provider)) {
+            return true;
+        }
+        // Check environment variables
+        if (getApiKeyFromEnv(model.provider)) {
+            return true;
+        }
+        return false;
+    });
+}
+/**
+ * Get the first available model with a valid API key.
+ * Useful when the configured model doesn't have valid credentials.
+ *
+ * Priority:
+ * 1. Use defaultModel from config if available and has API key
+ * 2. Use first available model with valid API key
+ * 3. Return undefined if no models are available
+ */
+export function getFirstAvailableModel(config) {
+    const availableModels = getAvailableModels(config);
+    if (availableModels.length === 0) {
+        return undefined;
+    }
+    // Try to find configured default model first
+    const defaultModel = config?.agents?.defaults?.model;
+    if (defaultModel) {
+        const modelRef = typeof defaultModel === 'string' ? defaultModel : defaultModel.primary;
+        if (modelRef) {
+            // Check if the configured model has valid API key
+            const configured = availableModels.find(m => `${m.provider}/${m.id}` === modelRef ||
+                m.id === modelRef);
+            if (configured) {
+                return configured;
+            }
+        }
+    }
+    // Return first available model
+    return availableModels[0];
+}
+export const PROVIDER_META = {
+    'openai': { name: 'OpenAI (GPT-4, o1, o3)', category: 'common', supportsApiKey: true },
+    'anthropic': { name: 'Anthropic Claude', category: 'common', supportsApiKey: true, supportsOAuth: true },
+    'google': { name: 'Google Gemini', category: 'common', supportsApiKey: true },
+    'groq': { name: 'Groq (Fast Inference)', category: 'common', supportsApiKey: true },
+    'deepseek': { name: 'DeepSeek', category: 'common', supportsApiKey: true },
+    'minimax': { name: 'MiniMax', category: 'common', supportsApiKey: true },
+    'minimax-cn': { name: 'MiniMax CN', category: 'common', supportsApiKey: true },
+    'kimi-coding': { name: 'Kimi For Coding', category: 'common', supportsApiKey: true },
+    'xai': { name: 'xAI (Grok)', category: 'specialty', supportsApiKey: true },
+    'mistral': { name: 'Mistral AI', category: 'specialty', supportsApiKey: true },
+    'cerebras': { name: 'Cerebras', category: 'specialty', supportsApiKey: true },
+    'openrouter': { name: 'OpenRouter (Multi-provider)', category: 'specialty', supportsApiKey: true },
+    'huggingface': { name: 'Hugging Face', category: 'specialty', supportsApiKey: true },
+    'opencode': { name: 'OpenCode', category: 'specialty', supportsApiKey: true },
+    'zai': { name: 'z.ai', category: 'specialty', supportsApiKey: true },
+    'amazon-bedrock': { name: 'Amazon Bedrock', category: 'enterprise', supportsApiKey: true },
+    'azure-openai-responses': { name: 'Azure OpenAI', category: 'enterprise', supportsApiKey: true },
+    'google-vertex': { name: 'Google Vertex AI', category: 'enterprise', supportsApiKey: true },
+    'vercel-ai-gateway': { name: 'Vercel AI Gateway', category: 'enterprise', supportsApiKey: true },
+    'github-copilot': { name: 'GitHub Copilot (OAuth)', category: 'oauth', supportsOAuth: true },
+    'openai-codex': { name: 'OpenAI Codex (OAuth)', category: 'oauth', supportsOAuth: true },
+    'google-gemini-cli': { name: 'Google Gemini CLI (OAuth)', category: 'oauth', supportsOAuth: true },
+    'google-antigravity': { name: 'Google Antigravity (OAuth)', category: 'oauth', supportsOAuth: true },
+};
+export function getSortedProviders() {
+    const all = getAllProviders();
+    const catOrder = { common: 0, specialty: 1, enterprise: 2, oauth: 3 };
+    return [...all].sort((a, b) => {
+        const catA = PROVIDER_META[a]?.category ?? 'specialty';
+        const catB = PROVIDER_META[b]?.category ?? 'specialty';
+        if (catOrder[catA] !== catOrder[catB]) {
+            return catOrder[catA] - catOrder[catB];
+        }
+        return a.localeCompare(b);
+    });
+}
+export function getProviderDisplayName(provider) {
+    return PROVIDER_META[provider]?.name || provider;
+}
+export function providerSupportsOAuth(provider) {
+    return PROVIDER_META[provider]?.supportsOAuth ?? false;
+}
+export function providerSupportsApiKey(provider) {
+    return PROVIDER_META[provider]?.supportsApiKey ?? true;
+}
+export const DEFAULT_MODEL = 'anthropic/claude-sonnet-4-5';
+export const RECOMMENDED_MODELS = [
+    'anthropic/claude-sonnet-4-5',
+    'openai/gpt-4o',
+    'google/gemini-2.5-flash',
+    'groq/llama-3.3-70b',
+    'deepseek/deepseek-chat',
+];
+export const PROVIDER_PREFIX_PATTERNS = {
+    openai: ['gpt-', 'o1', 'o3', 'o4', 'chatgpt-'],
+    anthropic: ['claude-'],
+    google: ['gemini-', 'gemma-'],
+    xai: ['grok-'],
+    groq: ['llama-', 'mixtral-', 'gemma-'],
+    deepseek: ['deepseek-', 'r1'],
+    mistral: ['mistral-'],
+    cerebras: ['llama-'],
+    openrouter: [],
+};
+export function detectProvider(modelId) {
+    const lowerId = modelId.toLowerCase();
+    // Check custom models first
+    const registry = getModelRegistry();
+    for (const model of registry.getAll()) {
+        if (model.id === modelId) {
+            return model.provider;
+        }
+    }
+    for (const [provider, prefixes] of Object.entries(PROVIDER_PREFIX_PATTERNS)) {
+        if (prefixes.some(p => lowerId.startsWith(p))) {
+            return provider;
+        }
+    }
+    for (const provider of getPiAiProviders()) {
+        try {
+            const models = getPiAiModels(provider);
+            if (models.some(m => m.id === modelId)) {
+                return provider;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+export function getProviderEnvVars(provider) {
+    return PROVIDER_ENV_MAP[provider] || [`${provider.toUpperCase().replace(/-/g, '_')}_API_KEY`];
+}
+// Re-export ModelRegistry for advanced use cases
+export { ModelRegistry, getModelRegistry, resetModelRegistry } from './model-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAe;AACf,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhG,wBAAwB;AACxB,OAAO,EACN,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,oBAAoB,GAGpB,MAAM,eAAe,CAAC;AAiBvB,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,gBAAgB;AAChB,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,GAEvB,MAAM,aAAa,CAAC;AAErB,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAC/C,OAAO;AACN,OAAO;AACP,gBAAgB,EAChB,WAAW,EACX,eAAe;AAEf,4BAA4B;AAC5B,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB;AAEjB,UAAU;AACV,sBAAsB,EACtB,yBAAyB;AAEzB,0BAA0B;AAC1B,aAAa,EACb,sBAAsB,EACtB,8BAA8B,GAW9B,MAAM,uBAAuB,CAAC;AAE/B,+CAA+C;AAC/C,iBAAiB;AACjB,+CAA+C;AAC/C,OAAO,EACN,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GAIhB,MAAM,qBAAqB,CAAC;AAE7B,+CAA+C;AAC/C,gBAAgB;AAChB,+CAA+C;AAC/C,OAAO;AACN,OAAO;AACP,aAAa,EACb,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,mBAAmB;AAEnB,kBAAkB;AAClB,oBAAoB,EACpB,gBAAgB;AAEhB,eAAe;AACf,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB;AAEpB,wBAAwB;AACxB,YAAY,EACZ,sBAAsB;AAEtB,YAAY;AACZ,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GAWnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/model-registry.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Model Registry - manages built-in and custom models from models.json
+ *
+ * Features:
+ * - Loads built-in models from @mariozechner/pi-ai
+ * - Loads custom models from ~/.xopcbot/models.json
+ * - Supports provider baseUrl/headers overrides
+ * - Supports per-model overrides (modelOverrides)
+ * - API key resolution with shell commands, env vars, and literals
+ * - Hot reload support
+ */
+import { type Api, type Model } from '@mariozechner/pi-ai';
+/**
+ * Model Registry - manages all models (built-in + custom)
+ */
+export declare class ModelRegistry {
+    private modelsJsonPath;
+    private models;
+    private customProviderApiKeys;
+    private loadError;
+    private _availableModelsCache;
+    private _providersCache;
+    private _authStatusCache;
+    constructor(modelsJsonPath?: string);
+    /**
+     * Reload models from disk (built-in + custom from models.json)
+     * Clears all caches
+     */
+    refresh(): void;
+    /**
+     * Get any error from loading models.json (undefined if no error)
+     */
+    getError(): string | undefined;
+    /**
+     * Get all models (built-in + custom)
+     * Results are cached until refresh() is called
+     */
+    getAll(): readonly Model<Api>[];
+    /**
+     * Get only models that have auth configured
+     * Results are cached on first call until refresh()
+     */
+    getAvailable(): readonly Model<Api>[];
+    /**
+     * Find a model by provider and ID
+     */
+    find(provider: string, modelId: string): Model<Api> | undefined;
+    /**
+     * Resolve a model reference (provider/modelId or just modelId)
+     */
+    resolve(ref: string): Model<Api> | undefined;
+    /**
+     * Get API key for a provider (for custom providers from models.json)
+     */
+    getApiKey(provider: string): string | undefined;
+    /**
+     * Check if a provider has auth configured
+     * Results are cached until refresh() is called
+     */
+    private hasAuth;
+    /**
+     * Load all models
+     * Clears caches to ensure fresh data
+     */
+    private loadModels;
+    /**
+     * Load built-in models and apply provider/model overrides
+     */
+    private loadBuiltInModels;
+    /**
+     * Merge custom models into built-in list (custom wins on conflicts)
+     */
+    private mergeCustomModels;
+    /**
+     * Load custom models from models.json
+     */
+    private loadCustomModels;
+    /**
+     * Parse custom models from config
+     */
+    private parseModels;
+}
+export declare function getModelRegistry(): ModelRegistry;
+export declare function resetModelRegistry(): void;