@spacex110/core 0.1.11

package/src/config.ts

@@ -0,0 +1,104 @@
+/**
+ * AI Provider Selector - Config Resolution
+ * Resolves ProviderConfig into a list of providers and models
+ */
+
+import type { Provider, Model, ProviderConfig, CustomProviderDefinition } from './types';
+import { PROVIDERS } from './providers';
+import { getStaticModels } from './models';
+
+export interface ResolvedConfig {
+    providers: Provider[];
+    getModels: (providerId: string) => Model[];
+}
+
+/**
+ * Resolve a ProviderConfig into usable providers and models
+ */
+export function resolveProviderConfig(config?: ProviderConfig): ResolvedConfig {
+    // Default config: use all built-in providers
+    if (!config) {
+        return {
+            providers: Object.values(PROVIDERS),
+            getModels: (providerId: string) => getStaticModels(providerId),
+        };
+    }
+
+    const { mode, include, exclude, custom } = config;
+    let providers: Provider[] = [];
+
+    // Handle built-in providers based on mode
+    if (mode === 'default') {
+        let builtInProviders = Object.values(PROVIDERS);
+
+        // Apply include filter
+        if (include && include.length > 0) {
+            builtInProviders = builtInProviders.filter(p => include.includes(p.id));
+        }
+
+        // Apply exclude filter
+        if (exclude && exclude.length > 0) {
+            builtInProviders = builtInProviders.filter(p => !exclude.includes(p.id));
+        }
+
+        providers = [...builtInProviders];
+    }
+
+    // Handle custom providers
+    const customModelsMap: Record<string, Model[]> = {};
+
+    if (custom) {
+        for (const [id, def] of Object.entries(custom)) {
+            const customProvider: Provider = {
+                id,
+                name: def.name,
+                baseUrl: def.baseUrl,
+                needsApiKey: def.needsApiKey,
+                apiFormat: def.apiFormat,
+                supportsModelsApi: def.supportsModelsApi ?? false,
+                icon: def.icon,
+            };
+
+            // Check if provider already exists (for override)
+            const existingIndex = providers.findIndex(p => p.id === id);
+
+            if (existingIndex >= 0) {
+                // Merge/Override existing provider
+                // We keep the original icon if custom doesn't provide one
+                providers[existingIndex] = {
+                    ...providers[existingIndex],
+                    ...customProvider,
+                    icon: customProvider.icon || providers[existingIndex].icon
+                };
+            } else {
+                // Add new provider
+                providers.push(customProvider);
+            }
+
+            // Store custom models if provided
+            if (def.models && def.models.length > 0) {
+                customModelsMap[id] = def.models;
+            }
+        }
+    }
+
+    // Create getModels function that checks custom models first
+    const getModels = (providerId: string): Model[] => {
+        // Check custom models first
+        if (customModelsMap[providerId]) {
+            return customModelsMap[providerId];
+        }
+        // Fall back to static models
+        return getStaticModels(providerId);
+    };
+
+    return { providers, getModels };
+}
+
+/**
+ * Get a single provider by ID from config
+ */
+export function getProviderFromConfig(providerId: string, config?: ProviderConfig): Provider | null {
+    const { providers } = resolveProviderConfig(config);
+    return providers.find(p => p.id === providerId) || null;
+}

package/src/i18n.ts

@@ -0,0 +1,66 @@
+export const I18N = {
+    zh: {
+        save: '保存配置',
+        saved: '保存成功',
+        providerLabel: 'Provider',
+        modelLabel: 'Model',
+        selectProvider: '选择 Provider...',
+        customBaseUrl: '自定义 Base URL',
+        apiKeyLabel: 'API Key',
+        apiKeyPlaceholder: '输入 API Key...',
+        testConnection: '测试模型连接',
+        testing: '测试中...',
+        testSuccess: '连接成功',
+        testFailed: '测试连通性失败',
+        selectModel: '选择 Model...',
+        searchModel: '搜索或自定义模型...',
+        useCustom: '使用自定义',
+        noModels: '暂无模型数据',
+        apiKeyTip: '输入 API Key 后可获取完整模型列表',
+        fetchModelsFailed: '拉取模型列表失败，已使用离线模型列表',
+        refreshingModels: '列表刷新中...',
+        modelListUpdated: '模型列表已刷新',
+        preview: '配置预览',
+        unselected: '(未选择)',
+        customProvider: '自定义 (Custom)',
+        baseUrlRequired: '请输入 Base URL',
+        baseUrlPlaceholder: '输入 API 地址，如 http://localhost:11434/v1',
+        apiKeyOptional: 'API Key（可选）',
+        modelAllTypes: '全部',
+        modelCount: '个',
+    },
+    en: {
+        save: 'Save Config',
+        saved: 'Saved',
+        providerLabel: 'Provider',
+        modelLabel: 'Model',
+        selectProvider: 'Select Provider...',
+        customBaseUrl: 'Custom Base URL',
+        apiKeyLabel: 'API Key',
+        apiKeyPlaceholder: 'Enter API Key...',
+        testConnection: 'Test Model Connection',
+        testing: 'Testing...',
+        testSuccess: 'Connection Successful',
+        testFailed: 'Connection Failed',
+        selectModel: 'Select Model...',
+        searchModel: 'Search or custom models...',
+        useCustom: 'Use custom',
+        noModels: 'No models found',
+        apiKeyTip: 'Enter API Key to fetch full model list',
+        fetchModelsFailed: 'Failed to fetch model list, using offline models',
+        refreshingModels: 'Refreshing models...',
+        modelListUpdated: 'Model list updated',
+        preview: 'Config Preview',
+        unselected: '(Unselected)',
+        customProvider: '自定义 (Custom)',
+        baseUrlRequired: 'Base URL is required',
+        baseUrlPlaceholder: 'Enter API URL, e.g. http://localhost:11434/v1',
+        apiKeyOptional: 'API Key (optional)',
+        modelAllTypes: 'All',
+        modelCount: '',
+    }
+} as const;
+
+export type Language = keyof typeof I18N;
+export type I18NKeys = keyof typeof I18N['zh'];
+

package/src/index.ts

@@ -0,0 +1,97 @@
+/**
+ * AI Provider Selector - Core Package
+ * Framework-agnostic logic for AI provider configuration
+ */
+
+// I18N
+export * from './i18n';
+
+// Types
+export type {
+    Provider,
+    Model,
+    AIConfig,
+
+    ApiFormat,
+    TestConnectionOptions,
+    TestConnectionResult,
+    FetchModelsOptions,
+    StorageAdapter,
+    // New config types
+    ProviderConfig,
+    CustomProviderDefinition,
+    AIConfigFormProps,
+    // Fetcher types
+    ModelFetcher,
+    FetcherParams,
+    FetcherActionType,
+    // Model capability
+    ModelCapability,
+} from './types';
+
+export {
+    MODEL_CAPABILITIES,
+} from './types';
+
+// Providers
+export {
+    PROVIDERS,
+    PROVIDER_ID,
+    type ProviderId,
+    getProvider,
+    getAllProviders,
+    getProvidersByFormat
+} from './providers';
+
+// Models
+export {
+    STATIC_MODELS,
+    getStaticModels
+} from './models';
+
+// API
+export {
+    testConnection,
+    fetchModels
+} from './api';
+
+// Storage
+export {
+    encryptedStorageAdapter,
+    plainStorageAdapter,
+    defaultStorageAdapter,
+    localStorageAdapter, // deprecated
+    createConfigStorage
+} from './storage';
+
+
+
+// Config Resolution
+export {
+    resolveProviderConfig,
+    getProviderFromConfig,
+    type ResolvedConfig
+} from './config';
+
+// Strategies
+export {
+    type ProviderStrategy,
+    strategyRegistry,
+    getStrategy,
+    sendDirectChat,
+    sendDirectChatStream,
+    testDirectConnection,
+    type DirectChatOptions,
+    type DirectChatStreamOptions,
+    type DirectChatResult,
+} from './strategies';
+
+// Channel Manager (Headless)
+export {
+    AIChannelManager,
+    type ChannelConfig,
+    type ChannelManagerOptions,
+    type ChannelFilter,
+    type ChatResult,
+    type ChannelEventType,
+} from './channel-manager';

package/src/models.ts

@@ -0,0 +1,202 @@
+/**
+ * AI Provider Selector - Static Model Definitions
+ * Models data when API doesn't support /models endpoint
+ */
+
+import type { Model } from './types';
+import { PROVIDER_ID } from './providers';
+
+export const STATIC_MODELS: Record<string, Model[]> = {
+    [PROVIDER_ID.OPENAI]: [
+        { id: 'gpt-5.2-pro', name: 'GPT-5.2 Pro' },
+        { id: 'gpt-5.2', name: 'GPT-5.2' },
+        { id: 'gpt-5', name: 'GPT-5' },
+        { id: 'gpt-5-mini', name: 'GPT-5 Mini' },
+        { id: 'gpt-5-nano', name: 'GPT-5 Nano' },
+        { id: 'gpt-4.1', name: 'GPT-4.1' },
+    ],
+    [PROVIDER_ID.ANTHROPIC]: [
+        { id: 'claude-opus-4.5-20251101', name: 'Claude Opus 4.5' },
+        { id: 'claude-opus-4.5-20251101-thinking', name: 'Claude Opus 4.5 Thinking' },
+        { id: 'claude-sonnet-4.5-20250929', name: 'Claude Sonnet 4.5' },
+        { id: 'claude-sonnet-4.5-20250929-thinking', name: 'Claude Sonnet 4.5 Thinking' },
+        { id: 'claude-haiku-4.5-20251001', name: 'Claude Haiku 4.5' },
+        { id: 'claude-haiku-4.5-20251001-thinking', name: 'Claude Haiku 4.5 Thinking' },
+        { id: 'claude-opus-4.1-20250805', name: 'Claude Opus 4.1' },
+        { id: 'claude-opus-4.1-20250805-thinking', name: 'Claude Opus 4.1 Thinking' },
+    ],
+    [PROVIDER_ID.GEMINI]: [
+        { id: 'gemini-3-flash-preview', name: 'Gemini 3 Flash Preview' },
+        { id: 'gemini-3-pro-preview', name: 'Gemini 3 Pro Preview' },
+        { id: 'gemini-2.5-pro', name: 'Gemini 2.5 Pro' },
+        { id: 'gemini-2.5-flash', name: 'Gemini 2.5 Flash' },
+        { id: 'gemini-2.5-flash-lite', name: 'Gemini 2.5 Flash-Lite' },
+    ],
+    [PROVIDER_ID.DEEPSEEK]: [
+        { id: 'deepseek-chat', name: 'Deepseek Chat' },
+        { id: 'deepseek-reasoner', name: 'Deepseek Reasoner' },
+    ],
+    [PROVIDER_ID.MISTRAL]: [
+        { id: 'mistral-large-latest', name: 'Mistral Large' },
+        { id: 'mistral-medium-latest', name: 'Mistral Medium' },
+        { id: 'mistral-small-latest', name: 'Mistral Small' },
+        { id: 'codestral-latest', name: 'Codestral' },
+        { id: 'devstral-latest', name: 'Devstral' },
+        { id: 'magistral-medium-latest', name: 'Magistral Medium' },
+        { id: 'pixtral-large-latest', name: 'Pixtral Large' },
+        { id: 'pixtral-12b-latest', name: 'Pixtral 12B' },
+        { id: 'ministral-8b-latest', name: 'Ministral 8B' },
+        { id: 'ministral-3b-latest', name: 'Ministral 3B' },
+    ],
+    [PROVIDER_ID.GROQ]: [
+        { id: 'canopylabs/orpheus-v1-english', name: 'Orpheus V1 English' },
+        { id: 'canopylabs/orpheus-arabic-saudi', name: 'Orpheus Arabic Saudi' },
+        { id: 'moonshotai/kimi-k2-instruct', name: 'Kimi K2 Instruct' },
+        { id: 'groq/compound-mini', name: 'Compound Mini' },
+        { id: 'llama-3.3-70b-versatile', name: 'Llama 3.3 70B Versatile' },
+        { id: 'openai/gpt-oss-120b', name: 'Gpt Oss 120B' },
+        { id: 'qwen/qwen3-32b', name: 'Qwen3 32B' },
+        { id: 'groq/compound', name: 'Compound' },
+        { id: 'meta-llama/llama-4-maverick-17b-128e-instruct', name: 'Llama 4 Maverick 17B 128E Instruct' },
+    ],
+    [PROVIDER_ID.XAI]: [
+        { id: 'grok-4', name: 'Grok 4' },
+        { id: 'grok-4-fast', name: 'Grok 4 Fast' },
+        { id: 'grok-3-latest', name: 'Grok 3' },
+        { id: 'grok-3-fast', name: 'Grok 3 Fast' },
+        { id: 'grok-3-mini-latest', name: 'Grok 3 Mini' },
+        { id: 'grok-3-mini-fast', name: 'Grok 3 Mini Fast' },
+        { id: 'grok-vision-beta', name: 'Grok Vision (Beta)' },
+    ],
+    [PROVIDER_ID.TOGETHER]: [
+        { id: 'Qwen/Qwen2.5-72B-Instruct-Turbo', name: 'Qwen2.5 72B Instruct Turbo' },
+        { id: 'Qwen/Qwen3-235B-A22B-Thinking-2507', name: 'Qwen3 235B A22B Thinking 2507' },
+        { id: 'deepseek-ai/DeepSeek-R1', name: 'Deepseek R1' },
+        { id: 'deepseek-ai/DeepSeek-V3.1', name: 'Deepseek V3.1' },
+        { id: 'meta-llama/Llama-3.2-3B-Instruct-Turbo', name: 'Llama 3.2 3B Instruct Turbo' },
+        { id: 'meta-llama/Llama-3.3-70B-Instruct-Turbo', name: 'Llama 3.3 70B Instruct Turbo' },
+        { id: 'meta-llama/Llama-3.3-70B-Instruct-Turbo-Free', name: 'Llama 3.3 70B Instruct Turbo Free' },
+    ],
+    [PROVIDER_ID.FIREWORKS]: [
+        { id: 'accounts/fireworks/models/llama4-scout-instruct-basic', name: 'Llama4 Scout Instruct Basic' },
+        { id: 'accounts/fireworks/models/qwen3-vl-235b-a22b-thinking', name: 'Qwen3 Vl 235B A22B Thinking' },
+        { id: 'accounts/fireworks/models/deepseek-v3p2', name: 'Deepseek V3P2' },
+        { id: 'accounts/fireworks/models/qwen3-vl-30b-a3b-thinking', name: 'Qwen3 Vl 30B A3B Thinking' },
+        { id: 'accounts/fireworks/models/qwen3-8b', name: 'Qwen3 8B' },
+        { id: 'accounts/fireworks/models/qwen3-vl-30b-a3b-instruct', name: 'Qwen3 Vl 30B A3B Instruct' },
+        { id: 'accounts/fireworks/models/qwen2p5-vl-32b-instruct', name: 'Qwen2P5 Vl 32B Instruct' },
+        { id: 'accounts/fireworks/models/llama4-maverick-instruct-basic', name: 'Llama4 Maverick Instruct Basic' },
+        { id: 'accounts/fireworks/models/qwen3-235b-a22b-thinking-2507', name: 'Qwen3 235B A22B Thinking 2507' },
+        { id: 'accounts/fireworks/models/qwen3-coder-480b-a35b-instruct', name: 'Qwen3 Coder 480B A35B Instruct' },
+    ],
+    [PROVIDER_ID.DEEPINFRA]: [
+        { id: 'meta-llama/Llama-3.2-11B-Vision-Instruct', name: 'Llama 3.2 11B Vision Instruct' },
+        { id: 'Qwen/Qwen3-32B', name: 'Qwen3 32B' },
+        { id: 'NousResearch/Hermes-3-Llama-3.1-70B', name: 'Hermes 3 Llama 3.1 70B' },
+        { id: 'Qwen/Qwen2.5-72B-Instruct', name: 'Qwen2.5 72B Instruct' },
+        { id: 'deepseek-ai/DeepSeek-V3-0324', name: 'Deepseek V3 0324' },
+        { id: 'Qwen/Qwen3-VL-235B-A22B-Instruct', name: 'Qwen3 Vl 235B A22B Instruct' },
+        { id: 'meta-llama/Llama-3.2-3B-Instruct', name: 'Llama 3.2 3B Instruct' },
+        { id: 'Qwen/Qwen2.5-VL-32B-Instruct', name: 'Qwen2.5 Vl 32B Instruct' },
+        { id: 'meta-llama/Meta-Llama-3.1-8B-Instruct', name: 'Meta Llama 3.1 8B Instruct' },
+        { id: 'Qwen/Qwen3-Coder-480B-A35B-Instruct-Turbo', name: 'Qwen3 Coder 480B A35B Instruct Turbo' },
+    ],
+    [PROVIDER_ID.OPENROUTER]: [
+        { id: 'google/gemini-3-flash-preview', name: 'Gemini 3 Flash Preview' },
+        { id: 'mistralai/mistral-small-creative', name: 'Mistral Small Creative' },
+        { id: 'openai/gpt-5.2-chat', name: 'Gpt 5.2 Chat' },
+        { id: 'openai/gpt-5.2-pro', name: 'Gpt 5.2 Pro' },
+        { id: 'openai/gpt-5.2', name: 'Gpt 5.2' },
+        { id: 'mistralai/devstral-2512', name: 'Devstral 2512' },
+        { id: 'openai/gpt-5.1-codex-max', name: 'Gpt 5.1 Codex Max' },
+        { id: 'mistralai/ministral-14b-2512', name: 'Ministral 14B 2512' },
+        { id: 'mistralai/ministral-8b-2512', name: 'Ministral 8B 2512' },
+        { id: 'mistralai/ministral-3b-2512', name: 'Ministral 3B 2512' },
+        { id: 'mistralai/mistral-large-2512', name: 'Mistral Large 2512' },
+        { id: 'deepseek/deepseek-v3.2-speciale', name: 'Deepseek V3.2 Speciale' },
+    ],
+    [PROVIDER_ID.PERPLEXITY]: [
+        { id: 'codellama-34b-instruct', name: 'Codellama 34B Instruct' },
+        { id: 'codellama-70b-instruct', name: 'Codellama 70B Instruct' },
+        { id: 'llama-2-70b-chat', name: 'Llama 2 70B Chat' },
+        { id: 'llama-3.1-70b-instruct', name: 'Llama 3.1 70B Instruct' },
+        { id: 'llama-3.1-8b-instruct', name: 'Llama 3.1 8B Instruct' },
+        { id: 'llama-3.1-sonar-huge-128k-online', name: 'Llama 3.1 Sonar Huge 128K Online' },
+        { id: 'llama-3.1-sonar-large-128k-chat', name: 'Llama 3.1 Sonar Large 128K Chat' },
+        { id: 'llama-3.1-sonar-large-128k-online', name: 'Llama 3.1 Sonar Large 128K Online' },
+        { id: 'llama-3.1-sonar-small-128k-chat', name: 'Llama 3.1 Sonar Small 128K Chat' },
+    ],
+    [PROVIDER_ID.COHERE]: [
+        { id: 'command-a-vision-07-2025', name: 'Command A Vision 07 2025' },
+        { id: 'command-a-reasoning-08-2025', name: 'Command A Reasoning 08 2025' },
+        { id: 'command-r-08-2024', name: 'Command R 08 2024' },
+        { id: 'command-r7b-arabic-02-2025', name: 'Command R7B Arabic 02 2025' },
+        { id: 'command-r7b-12-2024', name: 'Command R7B 12 2024' },
+    ],
+    [PROVIDER_ID.MOONSHOT]: [
+        { id: 'moonshot-v1-128k', name: 'Moonshot 128K' },
+        { id: 'moonshot-v1-32k', name: 'Moonshot 32K' },
+        { id: 'moonshot-v1-8k', name: 'Moonshot 8K' },
+        { id: 'kimi-k2-0711-chat', name: 'Kimi K2 Chat' },
+        { id: 'moonshot-v1-auto', name: 'Moonshot Auto' },
+    ],
+    [PROVIDER_ID.QWEN]: [
+        { id: 'qwen-flash', name: 'Qwen Flash' },
+        { id: 'qwen3-vl-plus-2025-12-19', name: 'Qwen3 Vl Plus 2025 12 19' },
+        { id: 'qwen3-tts-vd-realtime-2025-12-16', name: 'Qwen3 Tts Vd Realtime 2025 12 16' },
+        { id: 'qwen-image-edit-plus-2025-12-15', name: 'Qwen Image Edit Plus 2025 12 15' },
+        { id: 'qwen3-omni-flash-2025-12-01', name: 'Qwen3 Omni Flash 2025 12 01' },
+        { id: 'qwen3-omni-flash-realtime-2025-12-01', name: 'Qwen3 Omni Flash Realtime 2025 12 01' },
+        { id: 'qwen3-livetranslate-flash-2025-12-01', name: 'Qwen3 Livetranslate Flash 2025 12 01' },
+        { id: 'qwen3-livetranslate-flash', name: 'Qwen3 Livetranslate Flash' },
+        { id: 'qwen-plus-2025-12-01', name: 'Qwen Plus 2025 12 01' },
+        { id: 'qwen3-tts-vc-realtime-2025-11-27', name: 'Qwen3 Tts Vc Realtime 2025 11 27' },
+    ],
+    [PROVIDER_ID.ZHIPU]: [
+        { id: 'glm-4.5', name: 'Glm 4.5' },
+        { id: 'glm-4.5-air', name: 'Glm 4.5 Air' },
+        { id: 'glm-4.6', name: 'Glm 4.6' },
+        { id: 'glm-4.7', name: 'Glm 4.7' },
+    ],
+    [PROVIDER_ID.SILICONFLOW]: [
+        { id: 'deepseek-ai/DeepSeek-V3.2', name: 'Deepseek V3.2' },
+        { id: 'deepseek-ai/DeepSeek-V3.1-Terminus', name: 'Deepseek V3.1 Terminus' },
+        { id: 'deepseek-ai/DeepSeek-R1', name: 'Deepseek R1' },
+        { id: 'deepseek-ai/DeepSeek-V3', name: 'Deepseek V3' },
+        { id: 'zai-org/GLM-4.6V', name: 'Glm 4.6V' },
+        { id: 'zai-org/GLM-4.6', name: 'Glm 4.6' },
+        { id: 'Pro/zai-org/GLM-4.7', name: 'Glm 4.7' },
+        { id: 'Qwen/Qwen3-VL-32B-Instruct', name: 'Qwen3 Vl 32B Instruct' },
+    ],
+    [PROVIDER_ID.OLLAMA]: [
+        { id: 'llama3.3', name: 'Llama 3.3' },
+        { id: 'llama3.2', name: 'Llama 3.2' },
+        { id: 'qwq', name: 'QwQ (推理)' },
+        { id: 'qwen3:32b', name: 'Qwen3 32B' },
+        { id: 'deepseek-r1:32b', name: 'DeepSeek R1 32B' },
+        { id: 'deepseek-coder-v2', name: 'DeepSeek Coder V2' },
+        { id: 'gemma3:27b', name: 'Gemma 3 27B' },
+        { id: 'mistral:7b', name: 'Mistral 7B' },
+        { id: 'phi4', name: 'Phi 4' },
+        { id: 'codellama', name: 'Code Llama' },
+    ],
+    [PROVIDER_ID.DOUBAO]: [
+        { id: 'doubao-seed-1-8-251215', name: 'Doubao 1.8' },
+        { id: "doubao-seed-1-6-251015",name: "Doubao 1.6"},
+        { id: 'doubao-seed-1-6-lite-251015', name: 'Doubao 1.6 Lite' },
+        { id: 'doubao-seed-1-6-flash-250828', name: 'Doubao 1.6 Flash' },
+        { id: 'doubao-seed-1-6-thinking-250615', name: 'Doubao 1.6 Thinking' },
+    ],
+    [PROVIDER_ID.MINIMAX]: [
+        { id: 'MiniMax-M2.1', name: 'MiniMax M2.1' },
+        { id: 'MiniMax-M2.1-lightning', name: 'MiniMax M2.1 Lightning' },
+        { id: 'MiniMax-M2', name: 'MiniMax M2' },
+    ],
+};
+
+/**
+ * Get static models for a provider
+ */
+export function getStaticModels(providerId: string): Model[] {
+    return STATIC_MODELS[providerId] || [];
+}