@xopcai/xopcbot 0.1.0

package/dist/providers/auto-discovery.js

@@ -0,0 +1,236 @@
+/**
+ * Auto Discovery
+ *
+ * 自动检测和配置 Provider
+ * - 从环境变量自动检测已配置的 provider
+ * - 生成简化配置
+ * - 无需手动编辑 config.json
+ */
+import { getConfiguredProviders, getProviderApiKey, getProvider, PROVIDER_CATALOG, } from './provider-catalog.js';
+/**
+ * 扫描所有 provider，返回已配置和未配置的列表
+ */
+export function scanProviders() {
+    const configured = [];
+    const unconfigured = [];
+    for (const [id, provider] of Object.entries(PROVIDER_CATALOG)) {
+        const apiKey = getProviderApiKey(id);
+        const isConfigured = !!apiKey;
+        const info = {
+            id,
+            name: provider.name,
+            configured: isConfigured,
+            apiKey: isConfigured ? '***' + apiKey.slice(-4) : undefined,
+            baseUrl: provider.api.baseUrl,
+        };
+        if (isConfigured) {
+            configured.push(info);
+        }
+        else {
+            unconfigured.push(info);
+        }
+    }
+    return { configured, unconfigured };
+}
+/**
+ * 推荐默认模型
+ * 根据已配置的 provider 选择最佳默认模型
+ */
+export function recommendDefaultModel(configuredProviders) {
+    const priority = [
+        { provider: 'openai', model: 'gpt-4o' },
+        { provider: 'anthropic', model: 'claude-sonnet-4-5' },
+        { provider: 'google', model: 'gemini-2.5-pro' },
+        { provider: 'qwen', model: 'qwen-plus' },
+        { provider: 'kimi', model: 'kimi-k2.5' },
+        { provider: 'minimax', model: 'minimax-m2.5' },
+        { provider: 'deepseek', model: 'deepseek-chat' },
+        { provider: 'groq', model: 'llama-3.3-70b' },
+    ];
+    for (const { provider, model } of priority) {
+        if (configuredProviders.includes(provider)) {
+            return `${provider}/${model}`;
+        }
+    }
+    // 如果没有优先列表中的 provider，使用第一个
+    if (configuredProviders.length > 0) {
+        const first = configuredProviders[0];
+        const provider = getProvider(first);
+        if (provider) {
+            return `${first}/${provider.defaults.maxTokens > 4000 ? 'default' : 'default'}`;
+        }
+    }
+    return 'openai/gpt-4o';
+}
+/**
+ * 生成自动配置
+ * 基于环境变量生成最小化配置
+ */
+export function generateAutoConfig() {
+    const configured = getConfiguredProviders();
+    const providerIds = configured.map(p => p.id);
+    const providerConfigs = {};
+    for (const provider of configured) {
+        const apiKey = getProviderApiKey(provider.id);
+        if (apiKey) {
+            providerConfigs[provider.id] = {
+                // 不从环境变量读取实际值，只标记为已配置
+                // 实际运行时从环境变量读取
+                apiKey: '${ENV}',
+            };
+        }
+    }
+    return {
+        defaultModel: recommendDefaultModel(providerIds),
+        enabledProviders: providerIds,
+        providerConfigs,
+    };
+}
+/**
+ * 生成 config.json 内容（用于显示或导出）
+ */
+export function generateConfigTemplate() {
+    const autoConfig = generateAutoConfig();
+    const config = {
+        agents: {
+            defaults: {
+                model: autoConfig.defaultModel,
+                maxTokens: 8192,
+                temperature: 0.7,
+            },
+        },
+        providers: autoConfig.providerConfigs,
+    };
+    return JSON.stringify(config, null, 2);
+}
+/**
+ * 快速配置向导
+ * 检测环境并返回配置建议
+ */
+export function quickSetup() {
+    const { configured, unconfigured } = scanProviders();
+    if (configured.length === 0) {
+        // 列出需要配置的 provider
+        const suggestions = unconfigured
+            .slice(0, 5)
+            .map(p => `  - ${p.name}: ${getProvider(p.id)?.auth.envKeys.join(' 或 ')}`)
+            .join('\n');
+        return {
+            success: false,
+            message: `未检测到任何 Provider 配置。\n\n请设置以下环境变量之一：\n${suggestions}`,
+            errors: ['NO_PROVIDERS_CONFIGURED'],
+        };
+    }
+    const defaultModel = recommendDefaultModel(configured.map(p => p.id));
+    const providerNames = configured.map(p => p.name).join(', ');
+    return {
+        success: true,
+        message: `检测到 ${configured.length} 个已配置 Provider: ${providerNames}\n推荐默认模型: ${defaultModel}`,
+        defaultModel,
+        providers: configured.map(p => p.id),
+    };
+}
+/**
+ * 检查特定模型是否可用
+ */
+export function isModelAvailable(modelRef) {
+    const [providerId, _modelId] = modelRef.includes('/')
+        ? modelRef.split('/')
+        : [undefined, modelRef];
+    if (!providerId) {
+        // 尝试自动检测
+        for (const id of Object.keys(PROVIDER_CATALOG)) {
+            if (getProviderApiKey(id)) {
+                return true; // 假设模型存在
+            }
+        }
+        return false;
+    }
+    return !!getProviderApiKey(providerId);
+}
+/**
+ * 获取最佳可用模型
+ * 按优先级返回第一个可用的模型
+ */
+export function getBestAvailableModel() {
+    const candidates = [
+        'openai/gpt-4o',
+        'anthropic/claude-sonnet-4-5',
+        'google/gemini-2.5-pro',
+        'qwen/qwen-plus',
+        'kimi/kimi-k2.5',
+        'minimax/minimax-m2.5',
+        'deepseek/deepseek-chat',
+    ];
+    for (const model of candidates) {
+        if (isModelAvailable(model)) {
+            return model;
+        }
+    }
+    // 返回第一个配置的 provider 的默认模型
+    const configured = getConfiguredProviders();
+    if (configured.length > 0) {
+        const first = configured[0];
+        return `${first.id}/default`;
+    }
+    return undefined;
+}
+/**
+ * 打印配置诊断信息
+ */
+export function printDiagnostic() {
+    console.log('\n🔍 Provider 配置诊断\n');
+    console.log('='.repeat(50));
+    const { configured, unconfigured } = scanProviders();
+    console.log('\n✅ 已配置 Provider:');
+    if (configured.length === 0) {
+        console.log('   (无)');
+    }
+    else {
+        for (const p of configured) {
+            console.log(`   • ${p.name} (${p.id})`);
+            console.log(`     API Key: ${p.apiKey}`);
+            console.log(`     Base URL: ${p.baseUrl}`);
+        }
+    }
+    console.log('\n⚠️  未配置 Provider (前 10 个):');
+    for (const p of unconfigured.slice(0, 10)) {
+        const provider = getProvider(p.id);
+        const envKeys = provider?.auth.envKeys.join(' 或 ') || 'N/A';
+        console.log(`   • ${p.name}: ${envKeys}`);
+    }
+    if (unconfigured.length > 10) {
+        console.log(`   ... 还有 ${unconfigured.length - 10} 个`);
+    }
+    console.log('\n📋 推荐配置:');
+    const quick = quickSetup();
+    if (quick.success) {
+        console.log(`   默认模型: ${quick.defaultModel}`);
+        console.log(`   可用 Providers: ${quick.providers?.join(', ')}`);
+    }
+    else {
+        console.log(`   ${quick.message}`);
+    }
+    console.log('\n' + '='.repeat(50) + '\n');
+}
+/**
+ * 获取配置状态摘要
+ */
+export function getConfigSummary() {
+    const configured = getConfiguredProviders();
+    if (configured.length === 0) {
+        return {
+            status: 'no_providers',
+            providers: 0,
+            message: '未配置任何 Provider，请设置环境变量',
+        };
+    }
+    const defaultModel = getBestAvailableModel();
+    return {
+        status: 'ready',
+        providers: configured.length,
+        defaultModel,
+        message: `已配置 ${configured.length} 个 Provider，默认模型: ${defaultModel}`,
+    };
+}
+//# sourceMappingURL=auto-discovery.js.map

package/dist/providers/auto-discovery.js.map

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

package/dist/providers/config.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Provider Configuration
+ *
+ * Centralized configuration for provider behavior and defaults
+ */
+export interface ProviderBehaviorConfig {
+    /** Maximum thinking budget tokens (default: 8192) */
+    maxThinkingBudgetTokens: number;
+    /** Default temperature (default: 0.7) */
+    defaultTemperature: number;
+    /** Default max tokens for responses */
+    defaultMaxTokens: number;
+    /** Ollama base URL */
+    ollamaBaseUrl: string;
+    /** Ollama API timeout in ms */
+    ollamaTimeoutMs: number;
+    /** Ollama discovery timeout in ms */
+    ollamaDiscoveryTimeoutMs: number;
+}
+/** Default provider configuration */
+export declare const DEFAULT_PROVIDER_CONFIG: ProviderBehaviorConfig;
+/** Provider config from environment variables */
+export declare function loadProviderConfigFromEnv(): Partial<ProviderBehaviorConfig>;
+/** Merge config with defaults */
+export declare function createProviderConfig(overrides?: Partial<ProviderBehaviorConfig>): ProviderBehaviorConfig;

package/dist/providers/config.js

@@ -0,0 +1,42 @@
+/**
+ * Provider Configuration
+ *
+ * Centralized configuration for provider behavior and defaults
+ */
+/** Default provider configuration */
+export const DEFAULT_PROVIDER_CONFIG = {
+    maxThinkingBudgetTokens: 8192,
+    defaultTemperature: 0.7,
+    defaultMaxTokens: 4096,
+    ollamaBaseUrl: 'http://127.0.0.1:11434',
+    ollamaTimeoutMs: 5000,
+    ollamaDiscoveryTimeoutMs: 2000,
+};
+/** Provider config from environment variables */
+export function loadProviderConfigFromEnv() {
+    return {
+        maxThinkingBudgetTokens: envToNumber('XOPCBOT_MAX_THINKING_TOKENS'),
+        defaultTemperature: envToNumber('XOPCBOT_DEFAULT_TEMPERATURE'),
+        defaultMaxTokens: envToNumber('XOPCBOT_DEFAULT_MAX_TOKENS'),
+        ollamaBaseUrl: process.env.OLLAMA_BASE_URL,
+        ollamaTimeoutMs: envToNumber('OLLAMA_TIMEOUT_MS'),
+        ollamaDiscoveryTimeoutMs: envToNumber('OLLAMA_DISCOVERY_TIMEOUT_MS'),
+    };
+}
+/** Merge config with defaults */
+export function createProviderConfig(overrides = {}) {
+    const envConfig = loadProviderConfigFromEnv();
+    return {
+        ...DEFAULT_PROVIDER_CONFIG,
+        ...envConfig,
+        ...overrides,
+    };
+}
+function envToNumber(key) {
+    const value = process.env[key];
+    if (!value)
+        return undefined;
+    const num = parseInt(value, 10);
+    return isNaN(num) ? undefined : num;
+}
+//# sourceMappingURL=config.js.map

package/dist/providers/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/providers/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,qCAAqC;AACrC,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,uBAAuB,EAAE,IAAI;IAC7B,kBAAkB,EAAE,GAAG;IACvB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,wBAAwB;IACvC,eAAe,EAAE,IAAI;IACrB,wBAAwB,EAAE,IAAI;CAC/B,CAAC;AAEF,iDAAiD;AACjD,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,uBAAuB,EAAE,WAAW,CAAC,6BAA6B,CAAC;QACnE,kBAAkB,EAAE,WAAW,CAAC,6BAA6B,CAAC;QAC9D,gBAAgB,EAAE,WAAW,CAAC,4BAA4B,CAAC;QAC3D,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;QAC1C,eAAe,EAAE,WAAW,CAAC,mBAAmB,CAAC;QACjD,wBAAwB,EAAE,WAAW,CAAC,6BAA6B,CAAC;KACrE,CAAC;AACJ,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,oBAAoB,CAClC,YAA6C,EAAE;IAE/C,MAAM,SAAS,GAAG,yBAAyB,EAAE,CAAC;IAE9C,OAAO;QACL,GAAG,uBAAuB;QAC1B,GAAG,SAAS;QACZ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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
+ */
+export { LLMProviderImpl, createProvider, getAvailableModels, listAllModels } from './pi-ai.js';
+export type { LLMProvider } from './pi-ai.js';
+export { ModelRegistry, resolveConfigValue, PROVIDER_INFO, registerOAuthRefresh, type ProviderOverride, type ProviderInfo, } from './registry.js';
+export type { ChatMessage, ChatOptions, ChatResponse, ToolCall, ContentPart, TextContent, ImageContent, ApiType, ApiStrategyOptions, FinishReason, TokenUsage, } from './types.js';
+export { getApiStrategy, buildProviderOptions } from './api-strategies.js';
+export { createProviderConfig, loadProviderConfigFromEnv, DEFAULT_PROVIDER_CONFIG, type ProviderBehaviorConfig, } from './config.js';
+export { PROVIDER_CATALOG, getProvider, getAllProviders, detectProviderByModel, isProviderConfigured, getConfiguredProviders, getProviderApiKey, getProviderDisplayInfo, getAllProviderDisplayInfo, parseModelRef, registerCustomProvider, createCustomProviderFromConfig, type ProviderDefinition, type ProviderAuth, type ProviderApi, type ProviderCapabilities, type ProviderDefaults, type ProviderCategory, type AuthType, type ParsedModelRef, } from './provider-catalog.js';
+export { scanProviders, recommendDefaultModel, generateAutoConfig, generateConfigTemplate, quickSetup, isModelAvailable, getBestAvailableModel, printDiagnostic, getConfigSummary, type DiscoveredProvider, type AutoConfig, type QuickSetupResult, } from './auto-discovery.js';
+export { MODEL_CATALOG, getAllModels, findModel, findModelByProvider, findModelByRef, getModelsByProvider, getRecommendedModels, getModelsForTask, getModelsByCapability, getModelsByModality, getVisionModels, getFunctionCallingModels, modelSupportsModality, modelSupportsFeature, estimateCost, getModelComparisonInfo, getFullModelRef, parseModelReference, registerCustomModel, type ModelDefinition, type ModelFeatures, type ModelLimits, type ModelPricing, type ModelPerformance, type Modality, type TaskType, type ModelComparisonInfo, } from './model-catalog.js';

package/dist/providers/index.js

@@ -0,0 +1,55 @@
+/**
+ * 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
+ */
+// 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';
+// ============================================
+// Model Catalog
+// ============================================
+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';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,205 @@
+/**
+ * Model Catalog
+ *
+ * 模型能力系统 - 声明式模型定义
+ * - 支持多模态能力声明
+ * - 支持定价信息
+ * - 支持能力匹配和筛选
+ */
+/** 支持的模态类型 */
+export type Modality = 'text' | 'image' | 'audio' | 'video' | 'document' | 'pdf';
+/** 模型能力特性 */
+export interface ModelFeatures {
+    /** 流式输出 */
+    streaming: boolean;
+    /** 函数调用 */
+    functionCalling: boolean;
+    /** JSON 模式 */
+    jsonMode: boolean;
+    /** 推理能力 */
+    reasoning: boolean;
+    /** 系统提示词 */
+    systemPrompt: boolean;
+    /** 工具调用 */
+    tools: boolean;
+    /** 视觉理解 */
+    vision: boolean;
+    /** 长文档理解 */
+    documentUnderstanding: boolean;
+    /** 代码执行 */
+    codeExecution: boolean;
+    /** 图像生成 */
+    imageGeneration: boolean;
+    /** 音频理解 */
+    audioUnderstanding: boolean;
+    /** 视频理解 */
+    videoUnderstanding: boolean;
+}
+/** 模型限制 */
+export interface ModelLimits {
+    /** 上下文窗口大小 */
+    contextWindow: number;
+    /** 最大输出 token */
+    maxOutputTokens: number;
+    /** 最大输入文件大小（MB） */
+    maxFileSize?: number;
+    /** 单请求最大图像数 */
+    maxImagesPerRequest?: number;
+    /** 支持的图像类型 */
+    supportedImageTypes?: string[];
+    /** 支持的视频类型 */
+    supportedVideoTypes?: string[];
+    /** 支持音频类型 */
+    supportedAudioTypes?: string[];
+    /** 支持文档类型 */
+    supportedDocumentTypes?: string[];
+}
+/** 模型定价 */
+export interface ModelPricing {
+    /** 输入每 1K token 价格（美元） */
+    inputPer1k: number;
+    /** 输出每 1K token 价格（美元） */
+    outputPer1k: number;
+    /** 缓存读取折扣（如 0.5 表示半价） */
+    cacheReadDiscount?: number;
+    /** 缓存写入费用 */
+    cacheWritePer1k?: number;
+}
+/** 模型性能指标（估算） */
+export interface ModelPerformance {
+    /** 质量评分 1-10 */
+    qualityScore?: number;
+    /** 速度评分 1-10 */
+    speedScore?: number;
+    /** 典型响应延迟（毫秒） */
+    typicalLatency?: number;
+    /** 适合的任务类型 */
+    recommendedFor?: string[];
+}
+export interface ModelDefinition {
+    /** 模型 ID（在 provider 内唯一） */
+    id: string;
+    /** 显示名称 */
+    name: string;
+    /** 所属 Provider */
+    provider: string;
+    /** 描述 */
+    description?: string;
+    /** 模型版本 */
+    version?: string;
+    /** 模型系列 */
+    family?: string;
+    /** 支持输入模态 */
+    inputModalities: Modality[];
+    /** 支持输出模态 */
+    outputModalities: Modality[];
+    /** 功能特性 */
+    features: ModelFeatures;
+    /** 限制 */
+    limits: ModelLimits;
+    /** 定价（可选，如不提供则从 provider 估算） */
+    pricing?: ModelPricing;
+    /** 性能指标（可选） */
+    performance?: ModelPerformance;
+    /** 模型特定参数覆盖 */
+    defaultParams?: Record<string, unknown>;
+    /** 是否推荐 */
+    recommended?: boolean;
+    /** 是否 Deprecated */
+    deprecated?: boolean;
+}
+export declare const MODEL_CATALOG: ModelDefinition[];
+/**
+ * 获取所有模型
+ */
+export declare function getAllModels(): ModelDefinition[];
+/**
+ * 根据 ID 查找模型
+ */
+export declare function findModel(id: string): ModelDefinition | undefined;
+/**
+ * 根据 Provider 获取模型
+ */
+export declare function getModelsByProvider(providerId: string): ModelDefinition[];
+/**
+ * 根据 Provider 和模型 ID 查找
+ */
+export declare function findModelByProvider(providerId: string, modelId: string): ModelDefinition | undefined;
+/**
+ * 获取推荐的模型
+ */
+export declare function getRecommendedModels(): ModelDefinition[];
+/**
+ * 获取支持特定能力的模型
+ */
+export declare function getModelsByCapability(capability: keyof ModelFeatures): ModelDefinition[];
+/**
+ * 获取支持特定模态的模型
+ */
+export declare function getModelsByModality(modality: Modality): ModelDefinition[];
+/**
+ * 获取支持视觉的模型
+ */
+export declare function getVisionModels(): ModelDefinition[];
+/**
+ * 获取支持函数调用的模型
+ */
+export declare function getFunctionCallingModels(): ModelDefinition[];
+/**
+ * 根据任务类型推荐模型
+ */
+export type TaskType = 'general' | 'coding' | 'vision' | 'fast' | 'cheap' | 'long-context' | 'reasoning' | 'document' | 'multimodal';
+export declare function getModelsForTask(task: TaskType): ModelDefinition[];
+/**
+ * 检查模型是否支持特定模态
+ */
+export declare function modelSupportsModality(modelId: string, modality: Modality): boolean;
+/**
+ * 检查模型是否支持特定功能
+ */
+export declare function modelSupportsFeature(modelId: string, feature: keyof ModelFeatures): boolean;
+/**
+ * 估算请求成本
+ */
+export declare function estimateCost(modelId: string, inputTokens: number, outputTokens: number): number | undefined;
+/**
+ * 模型对比信息（用于 UI 展示）
+ */
+export interface ModelComparisonInfo {
+    id: string;
+    name: string;
+    provider: string;
+    description?: string;
+    contextWindow: number;
+    maxOutputTokens: number;
+    supportsVision: boolean;
+    supportsFunctions: boolean;
+    supportsStreaming: boolean;
+    inputPrice?: number;
+    outputPrice?: number;
+    recommended: boolean;
+}
+export declare function getModelComparisonInfo(): ModelComparisonInfo[];
+/**
+ * 注册自定义模型（运行时扩展）
+ */
+export declare function registerCustomModel(model: ModelDefinition): void;
+/**
+ * 从远程获取模型列表（用于 OpenRouter 等动态 provider）
+ */
+export declare function fetchRemoteModels(_providerId: string, _apiKey: string, _baseUrl: string): Promise<ModelDefinition[]>;
+/**
+ * 获取完整模型引用（provider/model）
+ */
+export declare function getFullModelRef(model: ModelDefinition): string;
+/**
+ * 解析模型引用
+ */
+export declare function parseModelReference(ref: string): {
+    provider?: string;
+    modelId: string;
+};
+/**
+ * 查找模型（支持完整引用格式）
+ */
+export declare function findModelByRef(ref: string): ModelDefinition | undefined;