@xopcai/xopcbot 0.1.0

package/dist/providers/provider-catalog.js

@@ -0,0 +1,834 @@
+/**
+ * Provider Catalog
+ *
+ * 统一的 Provider 定义中心
+ * - 合并 schema.ts、registry.ts、PROVIDER_INFO 中的 provider 定义
+ * - 支持动态 provider 扩展
+ * - 声明式能力配置
+ */
+// ============================================
+// Provider 注册表
+// ============================================
+export const PROVIDER_CATALOG = {
+    // ============================================
+    // Native Providers
+    // ============================================
+    openai: {
+        id: 'openai',
+        name: 'OpenAI',
+        category: 'native',
+        description: 'OpenAI API - GPT-4, o1, o3 系列',
+        auth: {
+            type: 'api_key',
+            envKeys: ['OPENAI_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.openai.com/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+            imageGeneration: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['gpt-', 'o1', 'o3', 'o4'],
+    },
+    anthropic: {
+        id: 'anthropic',
+        name: 'Anthropic',
+        category: 'native',
+        description: 'Anthropic Claude 系列',
+        auth: {
+            type: 'api_key',
+            envKeys: ['ANTHROPIC_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: true,
+        },
+        api: {
+            type: 'anthropic',
+            baseUrl: 'https://api.anthropic.com',
+            strategy: 'anthropic-messages',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: false,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 8192,
+            timeout: 60000,
+            contextWindow: 200000,
+        },
+        modelPrefixes: ['claude-'],
+    },
+    google: {
+        id: 'google',
+        name: 'Google',
+        category: 'native',
+        description: 'Google Gemini 系列',
+        auth: {
+            type: 'api_key',
+            envKeys: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'],
+            headerPrefix: '',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'google',
+            baseUrl: 'https://generativelanguage.googleapis.com/v1',
+            strategy: 'google-generative-ai',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 8192,
+            timeout: 60000,
+            contextWindow: 1000000,
+        },
+        modelPrefixes: ['gemini-', 'gemma-'],
+    },
+    // ============================================
+    // OpenAI-Compatible Providers
+    // ============================================
+    qwen: {
+        id: 'qwen',
+        name: 'Qwen (通义千问)',
+        category: 'openai-compatible',
+        description: '阿里云通义千问',
+        auth: {
+            type: 'api_key',
+            envKeys: ['QWEN_API_KEY', 'DASHSCOPE_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: true,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['qwen', 'qwq'],
+    },
+    kimi: {
+        id: 'kimi',
+        name: 'Kimi (月之暗面)',
+        category: 'openai-compatible',
+        description: 'Moonshot Kimi 系列',
+        auth: {
+            type: 'api_key',
+            envKeys: ['KIMI_API_KEY', 'MOONSHOT_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: true,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.moonshot.cn/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 256000,
+        },
+        modelPrefixes: ['kimi'],
+    },
+    moonshot: {
+        id: 'moonshot',
+        name: 'Moonshot AI',
+        category: 'openai-compatible',
+        description: 'Moonshot AI',
+        auth: {
+            type: 'api_key',
+            envKeys: ['MOONSHOT_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.moonshot.ai/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['moonshot'],
+    },
+    deepseek: {
+        id: 'deepseek',
+        name: 'DeepSeek',
+        category: 'openai-compatible',
+        description: 'DeepSeek 大模型',
+        auth: {
+            type: 'api_key',
+            envKeys: ['DEEPSEEK_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.deepseek.com/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 8192,
+            timeout: 60000,
+            contextWindow: 64000,
+        },
+        modelPrefixes: ['deepseek', 'r1'],
+    },
+    groq: {
+        id: 'groq',
+        name: 'Groq',
+        category: 'openai-compatible',
+        description: 'Groq 高速推理',
+        auth: {
+            type: 'api_key',
+            envKeys: ['GROQ_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.groq.com/openai/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: false,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 30000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['llama', 'mixtral', 'gemma'],
+    },
+    openrouter: {
+        id: 'openrouter',
+        name: 'OpenRouter',
+        category: 'openai-compatible',
+        description: 'OpenRouter 模型聚合',
+        auth: {
+            type: 'api_key',
+            envKeys: ['OPENROUTER_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://openrouter.ai/api/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: [],
+    },
+    xai: {
+        id: 'xai',
+        name: 'xAI (Grok)',
+        category: 'openai-compatible',
+        description: 'xAI Grok 系列',
+        auth: {
+            type: 'api_key',
+            envKeys: ['XAI_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.x.ai/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['grok'],
+    },
+    cerebras: {
+        id: 'cerebras',
+        name: 'Cerebras',
+        category: 'openai-compatible',
+        description: 'Cerebras 推理',
+        auth: {
+            type: 'api_key',
+            envKeys: ['CEREBRAS_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.cerebras.ai/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: false,
+            vision: false,
+            reasoning: false,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: false,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 30000,
+            contextWindow: 8192,
+        },
+        modelPrefixes: [],
+    },
+    mistral: {
+        id: 'mistral',
+        name: 'Mistral AI',
+        category: 'openai-compatible',
+        description: 'Mistral 大模型',
+        auth: {
+            type: 'api_key',
+            envKeys: ['MISTRAL_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.mistral.ai/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: false,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 32000,
+        },
+        modelPrefixes: ['mistral'],
+    },
+    // ============================================
+    // Anthropic-Compatible Providers
+    // ============================================
+    minimax: {
+        id: 'minimax',
+        name: 'MiniMax',
+        category: 'anthropic-compatible',
+        description: 'MiniMax 海外版',
+        auth: {
+            type: 'api_key',
+            envKeys: ['MINIMAX_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: true,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.minimax.io/anthropic',
+            strategy: 'anthropic-messages',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 1000000,
+        },
+        modelPrefixes: ['minimax'],
+    },
+    'minimax-cn': {
+        id: 'minimax-cn',
+        name: 'MiniMax CN',
+        category: 'anthropic-compatible',
+        description: 'MiniMax 国内版',
+        auth: {
+            type: 'api_key',
+            envKeys: ['MINIMAX_CN_API_KEY', 'MINIMAX_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://api.minimaxi.com/anthropic',
+            strategy: 'anthropic-messages',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 1000000,
+        },
+        modelPrefixes: ['minimax-cn'],
+    },
+    zhipu: {
+        id: 'zhipu',
+        name: 'Zhipu (智谱)',
+        category: 'openai-compatible',
+        description: '智谱 GLM 系列',
+        auth: {
+            type: 'api_key',
+            envKeys: ['ZHIPU_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://open.bigmodel.cn/api/paas/v4',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: false,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['glm-'],
+    },
+    'zhipu-cn': {
+        id: 'zhipu-cn',
+        name: 'Zhipu CN',
+        category: 'openai-compatible',
+        description: '智谱国内版',
+        auth: {
+            type: 'api_key',
+            envKeys: ['ZHIPU_CN_API_KEY', 'ZHIPU_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://open.bigmodel.cn/api/paas/v4',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: false,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: ['glm-'],
+    },
+    // ============================================
+    // Local Providers
+    // ============================================
+    ollama: {
+        id: 'ollama',
+        name: 'Ollama',
+        category: 'local',
+        description: '本地 Ollama 模型',
+        auth: {
+            type: 'api_key',
+            envKeys: ['OLLAMA_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'ollama',
+            baseUrl: 'http://127.0.0.1:11434/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: true,
+            streaming: true,
+            functionCalling: true,
+            vision: true,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: [],
+    },
+    // ============================================
+    // Special Providers
+    // ============================================
+    'github-copilot': {
+        id: 'github-copilot',
+        name: 'GitHub Copilot',
+        category: 'native',
+        description: 'GitHub Copilot Chat',
+        auth: {
+            type: 'token',
+            envKeys: ['GITHUB_COPILOT_TOKEN'],
+            headerPrefix: 'token ',
+            supportsOAuth: true,
+        },
+        api: {
+            type: 'custom',
+            baseUrl: '',
+            strategy: 'github-copilot',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: false,
+            vision: false,
+            reasoning: false,
+            jsonMode: false,
+            systemPrompt: true,
+            tools: false,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+            contextWindow: 128000,
+        },
+        modelPrefixes: [],
+    },
+    // ============================================
+    // Bailian Coding Plan (百炼 Coding Plan)
+    // ============================================
+    bailian: {
+        id: 'bailian',
+        name: 'Bailian Coding Plan',
+        category: 'openai-compatible',
+        description: '阿里云百炼 Coding Plan 专属 API',
+        auth: {
+            type: 'api_key',
+            envKeys: ['BAILIAN_API_KEY', 'BAILIAN_CODING_API_KEY'],
+            headerPrefix: 'Bearer ',
+            supportsOAuth: false,
+        },
+        api: {
+            type: 'openai',
+            baseUrl: 'https://coding.dashscope.aliyuncs.com/v1',
+            strategy: 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: true,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 65536,
+            timeout: 120000,
+            contextWindow: 262144,
+        },
+        modelPrefixes: ['qwen3'],
+    },
+};
+// ============================================
+// 辅助函数
+// ============================================
+/**
+ * 获取 Provider 定义
+ */
+export function getProvider(id) {
+    return PROVIDER_CATALOG[id];
+}
+/**
+ * 获取所有 Providers
+ */
+export function getAllProviders() {
+    return Object.values(PROVIDER_CATALOG);
+}
+/**
+ * 根据模型 ID 自动检测 Provider
+ */
+export function detectProviderByModel(modelId) {
+    const lowerId = modelId.toLowerCase();
+    for (const [providerId, provider] of Object.entries(PROVIDER_CATALOG)) {
+        // 检查前缀匹配
+        if (provider.modelPrefixes?.some(prefix => lowerId.startsWith(prefix.toLowerCase()))) {
+            return providerId;
+        }
+        // 检查 provider 名称是否在模型 ID 中
+        if (lowerId.includes(providerId.toLowerCase())) {
+            return providerId;
+        }
+    }
+    return undefined;
+}
+/**
+ * 检查 Provider 是否有配置（环境变量）
+ */
+export function isProviderConfigured(id) {
+    const provider = PROVIDER_CATALOG[id];
+    if (!provider)
+        return false;
+    return provider.auth.envKeys.some(key => {
+        const value = process.env[key];
+        return value && value.length > 0;
+    });
+}
+/**
+ * 获取所有已配置的 Providers
+ */
+export function getConfiguredProviders() {
+    return getAllProviders().filter(p => isProviderConfigured(p.id));
+}
+/**
+ * 获取 Provider 的 API Key
+ */
+export function getProviderApiKey(id) {
+    const provider = PROVIDER_CATALOG[id];
+    if (!provider)
+        return undefined;
+    for (const key of provider.auth.envKeys) {
+        const value = process.env[key];
+        if (value && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+export function getProviderDisplayInfo(id) {
+    const provider = PROVIDER_CATALOG[id];
+    if (!provider)
+        return undefined;
+    return {
+        id: provider.id,
+        name: provider.name,
+        description: provider.description || '',
+        envKeys: provider.auth.envKeys,
+        authType: provider.auth.type,
+        supportsOAuth: provider.auth.supportsOAuth || false,
+        baseUrl: provider.api.baseUrl,
+        logo: provider.logo,
+        configured: isProviderConfigured(id),
+    };
+}
+/**
+ * 获取所有 Provider 显示信息
+ */
+export function getAllProviderDisplayInfo() {
+    return getAllProviders()
+        .map(p => getProviderDisplayInfo(p.id))
+        .filter((p) => p !== undefined);
+}
+export function parseModelRef(modelRef) {
+    // 检查是否为完整引用格式 provider/model
+    if (modelRef.includes('/')) {
+        const [provider, ...modelParts] = modelRef.split('/');
+        return {
+            provider,
+            model: modelParts.join('/'),
+            isFullRef: true,
+        };
+    }
+    // 尝试自动检测 provider
+    const detected = detectProviderByModel(modelRef);
+    if (detected) {
+        return {
+            provider: detected,
+            model: modelRef,
+            isFullRef: false,
+        };
+    }
+    // 默认使用 openai
+    return {
+        provider: 'openai',
+        model: modelRef,
+        isFullRef: false,
+    };
+}
+/**
+ * 注册自定义 Provider（运行时扩展）
+ */
+export function registerCustomProvider(definition) {
+    PROVIDER_CATALOG[definition.id] = definition;
+}
+/**
+ * 从配置创建自定义 Provider
+ */
+export function createCustomProviderFromConfig(id, name, config) {
+    return {
+        id,
+        name,
+        category: config.category || 'openai-compatible',
+        auth: {
+            type: 'api_key',
+            envKeys: config.envKey ? [config.envKey] : [`${id.toUpperCase().replace(/-/g, '_')}_API_KEY`],
+            headerPrefix: 'Bearer ',
+        },
+        api: {
+            type: 'openai',
+            baseUrl: config.baseUrl,
+            strategy: config.strategy || 'openai-completions',
+        },
+        capabilities: {
+            multimodal: false,
+            streaming: true,
+            functionCalling: true,
+            vision: false,
+            reasoning: false,
+            jsonMode: true,
+            systemPrompt: true,
+            tools: true,
+        },
+        defaults: {
+            temperature: 0.7,
+            maxTokens: 4096,
+            timeout: 60000,
+        },
+    };
+}
+//# sourceMappingURL=provider-catalog.js.map