@tombcato/ai-selector-core 0.1.0

package/dist/strategies.d.ts

@@ -0,0 +1,54 @@
+import type { Model } from './types';
+export interface ProviderStrategy {
+    format: string;
+    getModelsEndpoint?: (baseUrl: string, apiKey: string) => string;
+    parseModelsResponse?: (data: any) => Model[];
+    getChatEndpoint: (baseUrl: string, apiKey: string, model: string) => string;
+    buildChatPayload: (model: string, messages: Array<{
+        role: string;
+        content: string;
+    }>, maxTokens: number) => Record<string, unknown>;
+    parseChatResponse: (data: any) => string;
+    buildHeaders: (apiKey: string) => Record<string, string>;
+}
+export declare const defaultParseModelsResponse: (data: any) => Model[];
+export declare const strategyRegistry: Record<string, ProviderStrategy>;
+export declare function getStrategy(format: string): ProviderStrategy;
+export interface DirectChatOptions {
+    apiFormat: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    maxTokens?: number;
+}
+export interface DirectChatResult {
+    success: boolean;
+    content?: string;
+    message?: string;
+    latencyMs?: number;
+}
+/**
+ * 纯前端直连 AI 厂商进行聊天
+ * 注意: 这会将 API Key 暴露在浏览器中，仅适用于 Demo/测试场景
+ */
+export declare function sendDirectChat(options: DirectChatOptions): Promise<DirectChatResult>;
+export interface TestConnectionOptions {
+    apiFormat: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+}
+export interface TestConnectionResult {
+    success: boolean;
+    latencyMs?: number;
+    message?: string;
+}
+/**
+ * 测试 AI 厂商连接 (通过发送一个简单的聊天请求)
+ */
+export declare function testDirectConnection(options: TestConnectionOptions): Promise<TestConnectionResult>;
+//# sourceMappingURL=strategies.d.ts.map

package/dist/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../src/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,KAAK,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAChE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,KAAK,EAAE,CAAC;IAE7C,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5E,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpI,iBAAiB,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC;IAEzC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5D;AAED,eAAO,MAAM,0BAA0B,GAAI,MAAM,GAAG,KAAG,KAAK,EAmB3D,CAAC;AAsGF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAK7D,CAAC;AAEF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAE5D;AAMD,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0C1F;AAMD,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAexG"}

package/dist/strategies.js

@@ -0,0 +1,184 @@
+export const defaultParseModelsResponse = (data) => {
+    if (Array.isArray(data?.data)) {
+        return data.data
+            .filter((m) => m.id)
+            .map((m) => {
+            const name = m.name ||
+                (m.id.split('/').pop() ?? '')
+                    .replace(/[-_]/g, ' ')
+                    .replace(/\b\w/g, (c) => c.toUpperCase());
+            return {
+                id: m.id,
+                name,
+                created: m.created || 0,
+            };
+        })
+            .sort((a, b) => (b.created || 0) - (a.created || 0)); // 最新的排在前面
+    }
+    return [];
+};
+const openaiStrategy = {
+    format: 'openai',
+    getModelsEndpoint: (baseUrl) => `${baseUrl}/models`,
+    getChatEndpoint: (baseUrl) => `${baseUrl}/chat/completions`,
+    buildHeaders: (apiKey) => ({
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+    }),
+    buildChatPayload: (model, messages, maxTokens) => ({
+        model,
+        messages,
+        max_tokens: maxTokens,
+    }),
+    parseChatResponse: (data) => {
+        return data.choices?.[0]?.message?.content || '';
+    },
+};
+const anthropicStrategy = {
+    format: 'anthropic',
+    getChatEndpoint: (baseUrl) => `${baseUrl}/messages`,
+    buildHeaders: (apiKey) => ({
+        'Content-Type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': '2023-06-01',
+    }),
+    buildChatPayload: (model, messages, maxTokens) => ({
+        model,
+        messages,
+        max_tokens: maxTokens,
+    }),
+    parseChatResponse: (data) => {
+        return data.content?.[0]?.text || '';
+    },
+};
+const geminiStrategy = {
+    format: 'gemini',
+    getModelsEndpoint: (baseUrl, apiKey) => `${baseUrl}/models?key=${apiKey}`,
+    getChatEndpoint: (baseUrl, apiKey, model) => `${baseUrl}/models/${model}:generateContent?key=${apiKey}`,
+    buildHeaders: () => ({
+        'Content-Type': 'application/json',
+    }),
+    buildChatPayload: (_model, messages, maxTokens) => {
+        // 转换 OpenAI 格式的 messages 为 Gemini 格式
+        const contents = messages.map(m => ({
+            role: m.role === 'assistant' ? 'model' : 'user',
+            parts: [{ text: m.content }],
+        }));
+        return {
+            contents,
+            generationConfig: { maxOutputTokens: maxTokens },
+        };
+    },
+    parseChatResponse: (data) => {
+        return data.candidates?.[0]?.content?.parts?.[0]?.text || '';
+    },
+    // Gemini 返回格式: { models: [{ name: "models/gemini-pro", ... }] }
+    parseModelsResponse: (data) => {
+        if (Array.isArray(data.models)) {
+            return data.models
+                .filter((m) => m.supportedGenerationMethods?.includes('generateContent'))
+                .map((m) => ({
+                id: m.name.replace('models/', ''), // "models/gemini-pro" -> "gemini-pro"
+                name: m.displayName || m.name.replace('models/', ''),
+                created: m.created || 0,
+            }))
+                .sort((a, b) => (b.created || 0) - (a.created || 0));
+        }
+        return [];
+    },
+};
+const cohereStrategy = {
+    format: 'cohere',
+    getModelsEndpoint: (baseUrl) => `${baseUrl}/models`,
+    getChatEndpoint: (baseUrl) => `${baseUrl}/chat`,
+    buildHeaders: (apiKey) => ({
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+    }),
+    buildChatPayload: (model, messages, maxTokens) => {
+        // Cohere 使用不同的格式: message 是当前消息, chat_history 是历史
+        const lastMessage = messages[messages.length - 1];
+        const chatHistory = messages.slice(0, -1).map(m => ({
+            role: m.role === 'assistant' ? 'CHATBOT' : 'USER',
+            message: m.content,
+        }));
+        return {
+            model,
+            message: lastMessage.content,
+            chat_history: chatHistory,
+            max_tokens: maxTokens,
+        };
+    },
+    parseChatResponse: (data) => {
+        return data.text || '';
+    },
+};
+export const strategyRegistry = {
+    openai: openaiStrategy,
+    anthropic: anthropicStrategy,
+    gemini: geminiStrategy,
+    cohere: cohereStrategy,
+};
+export function getStrategy(format) {
+    return strategyRegistry[format] || openaiStrategy;
+}
+/**
+ * 纯前端直连 AI 厂商进行聊天
+ * 注意: 这会将 API Key 暴露在浏览器中，仅适用于 Demo/测试场景
+ */
+export async function sendDirectChat(options) {
+    const { apiFormat, baseUrl, apiKey, model, messages, maxTokens = 2048 } = options;
+    const strategy = getStrategy(apiFormat);
+    const endpoint = strategy.getChatEndpoint(baseUrl, apiKey, model);
+    const headers = strategy.buildHeaders(apiKey);
+    const payload = strategy.buildChatPayload(model, messages, maxTokens);
+    const startTime = performance.now();
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload),
+        });
+        const latencyMs = Math.round(performance.now() - startTime);
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({}));
+            return {
+                success: false,
+                message: errorData.error?.message || `HTTP ${response.status}: ${response.statusText}`,
+                latencyMs,
+            };
+        }
+        const data = await response.json();
+        const content = strategy.parseChatResponse(data);
+        return {
+            success: true,
+            content,
+            latencyMs,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            message: e instanceof Error ? e.message : '网络错误',
+        };
+    }
+}
+/**
+ * 测试 AI 厂商连接 (通过发送一个简单的聊天请求)
+ */
+export async function testDirectConnection(options) {
+    const result = await sendDirectChat({
+        apiFormat: options.apiFormat,
+        baseUrl: options.baseUrl,
+        apiKey: options.apiKey,
+        model: options.model,
+        messages: [{ role: 'user', content: 'Hi' }],
+        maxTokens: 5, // 最小 token 数，节省成本
+    });
+    return {
+        success: result.success,
+        latencyMs: result.latencyMs,
+        message: result.success ? undefined : result.message,
+    };
+}
+//# sourceMappingURL=strategies.js.map

package/dist/strategies.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * AI Provider Selector - Core Types
+ * Framework-agnostic type definitions
+ */
+export type ApiFormat = 'openai' | 'anthropic' | 'gemini' | 'cohere';
+export type FetcherActionType = 'fetchModels' | 'checkConnection';
+export interface FetcherParams {
+    type: FetcherActionType;
+    providerId: string;
+    baseUrl: string;
+    apiKey?: string;
+    modelId?: string;
+}
+/**
+ * Custom fetcher for retrieving models and checking connection.
+ * If provided, this will bypass internal fetch logic.
+ *
+ * - type='fetchModels': returns Promise<Model[]>
+ * - type='checkConnection': returns Promise<{ success: boolean; latency?: number; message?: string }>
+ */
+export type ModelFetcher = (params: FetcherParams) => Promise<any>;
+export interface Provider {
+    id: string;
+    name: string;
+    baseUrl: string;
+    needsApiKey: boolean;
+    apiFormat: ApiFormat;
+    supportsModelsApi: boolean;
+    icon?: string;
+}
+/** 自定义 Provider 定义 */
+export interface CustomProviderDefinition {
+    name: string;
+    baseUrl: string;
+    needsApiKey: boolean;
+    apiFormat: ApiFormat;
+    supportsModelsApi?: boolean;
+    icon?: string;
+    /** 静态模型列表（当不支持 /models API 时使用） */
+    models?: Model[];
+}
+export interface Model {
+    id: string;
+    name: string;
+}
+export interface AIConfig {
+    providerId: string;
+    apiKey: string;
+    model: string;
+    modelName?: string;
+    baseUrl?: string;
+}
+export interface TestConnectionOptions {
+    provider: Provider;
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    proxyUrl?: string;
+}
+export interface TestConnectionResult {
+    success: boolean;
+    latencyMs?: number;
+    message?: string;
+}
+export interface FetchModelsOptions {
+    provider: Provider;
+    apiKey?: string;
+    baseUrl?: string;
+    proxyUrl?: string;
+    fallbackToStatic?: boolean;
+}
+export interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+/** 自定义 Provider 定义 */
+export interface CustomProviderDefinition {
+    name: string;
+    baseUrl: string;
+    needsApiKey: boolean;
+    apiFormat: ApiFormat;
+    supportsModelsApi?: boolean;
+    icon?: string;
+    /** 静态模型列表（当不支持 /models API 时使用） */
+    models?: Model[];
+}
+/** Provider 配置 JSON */
+export interface ProviderConfig {
+    /** 模式：default=内置+自定义，customOnly=只用自定义 */
+    mode: 'default' | 'customOnly';
+    /** 白名单：只显示这些内置 provider（仅 mode=default） */
+    include?: string[];
+    /** 黑名单：隐藏这些内置 provider（仅 mode=default） */
+    exclude?: string[];
+    /** 自定义 Providers */
+    custom?: Record<string, CustomProviderDefinition>;
+}
+/** AIConfigForm 组件的 Props */
+export interface AIConfigFormProps {
+    /**
+     * 自定义请求处理器
+     * 用于接管获取模型列表和连通性测试的请求
+     * 如果提供此函数，proxyUrl 在这两种操作中将被忽略
+     */
+    modelFetcher?: ModelFetcher;
+    /** 后端代理地址（必需，除非提供了 modelFetcher） */
+    proxyUrl?: string;
+    /** Provider 配置（可选，默认使用全部内置 Providers） */
+    config?: ProviderConfig;
+    /** 初始配置（可选，用于编辑已有配置） */
+    initialConfig?: Partial<AIConfig>;
+    /** 表单标题 */
+    title?: string;
+    /** 是否显示配置预览区域 */
+    showPreview?: boolean;
+    /** 保存按钮文本 */
+    saveButtonText?: string;
+    /** 是否禁用整个表单 */
+    disabled?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * AI Provider Selector - Core Types
+ * Framework-agnostic type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function calculateCommonPrefix(str1: string, str2: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAuH"}

package/dist/utils.js

@@ -0,0 +1,4 @@
+export function calculateCommonPrefix(str1, str2) { let i = 0; while (i < str1.length && i < str2.length && str1[i] === str2[i]) {
+    i++;
+} return str1.substring(0, i); }
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,IAAY,IAAY,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAAC,CAAC,EAAE,CAAC;AAAC,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@tombcato/ai-selector-core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic AI Provider Selector core utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "ai",
+    "provider",
+    "openai",
+    "anthropic",
+    "gemini",
+    "deepseek",
+    "selector"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/api.ts

@@ -0,0 +1,154 @@
+/**
+ * AI Provider Selector - API Functions
+ * Connection testing and model fetching logic
+ */
+
+import type {
+    Provider,
+    Model,
+    TestConnectionOptions,
+    TestConnectionResult,
+    FetchModelsOptions
+} from './types';
+import { getStaticModels } from './models';
+import { getStrategy, defaultParseModelsResponse } from './strategies';
+
+const DEFAULT_TIMEOUT = 30000;
+
+/**
+ * Test connection to an AI provider
+ */
+export async function testConnection(options: TestConnectionOptions): Promise<TestConnectionResult> {
+    const { provider, apiKey, model, baseUrl, proxyUrl } = options;
+    const actualBaseUrl = baseUrl || provider.baseUrl;
+    const startTime = Date.now();
+
+    try {
+        // If proxy URL is provided, use it
+        if (proxyUrl) {
+            const response = await fetch(`${proxyUrl}/test`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    provider_id: provider.id,
+                    api_key: apiKey,
+                    model: model || '',
+                    base_url: baseUrl || provider.baseUrl,
+                    api_format: provider.apiFormat,
+                }),
+            });
+            const data = await response.json();
+            return {
+                success: data.success,
+                latencyMs: data.latency_ms || (Date.now() - startTime),
+                message: data.message,
+            };
+        }
+
+        // Direct API call (for browser-compatible providers)
+        const strategy = getStrategy(provider.apiFormat);
+        const targetModel = model || '';
+
+        // If no model provided, we cannot test (user must select model first)
+        if (!targetModel) {
+            return {
+                success: false,
+                latencyMs: 0,
+                message: '请先选择模型 (Please select a model)'
+            };
+        }
+
+        const headers = strategy.buildHeaders(apiKey);
+        // 使用聊天接口进行测试，发送最简单的请求
+        const testPayload = strategy.buildChatPayload(targetModel, [{ role: 'user', content: 'Hi' }], 5);
+        const endpoint = strategy.getChatEndpoint(actualBaseUrl, apiKey, targetModel);
+
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(testPayload),
+        });
+
+        const latencyMs = Date.now() - startTime;
+
+        if (response.ok) {
+            return { success: true, latencyMs, message: '连接成功' };
+        } else {
+            const errorText = await response.text();
+            return {
+                success: false,
+                latencyMs,
+                message: `HTTP ${response.status}: ${errorText.slice(0, 200)}`
+            };
+        }
+    } catch (error) {
+        return {
+            success: false,
+            latencyMs: Date.now() - startTime,
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+
+/**
+ * Fetch available models from a provider
+ */
+export async function fetchModels(options: FetchModelsOptions): Promise<Model[]> {
+    const { provider, apiKey, baseUrl, proxyUrl, fallbackToStatic = true } = options;
+
+    // If proxy URL is provided, use it
+    if (proxyUrl) {
+        try {
+            const response = await fetch(`${proxyUrl}/models`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    provider_id: provider.id,
+                    api_key: apiKey || undefined,
+                    base_url: baseUrl || provider.baseUrl,
+                }),
+            });
+            const data = await response.json();
+            if (data.success && data.models?.length > 0) {
+                return data.models;
+            }
+        } catch (error) {
+            console.warn('Failed to fetch models via proxy:', error);
+            if (!fallbackToStatic) throw error;
+        }
+    }
+
+    // Direct API call
+    if (!proxyUrl && provider.supportsModelsApi) {
+        try {
+            const strategy = getStrategy(provider.apiFormat);
+            if (strategy.getModelsEndpoint) {
+                const endpoint = strategy.getModelsEndpoint(baseUrl || provider.baseUrl, apiKey || '');
+                const headers = strategy.buildHeaders(apiKey || '');
+
+                const response = await fetch(endpoint, {
+                    method: 'GET',
+                    headers
+                });
+
+                if (response.ok) {
+                    const data = await response.json();
+                    const parser = strategy.parseModelsResponse || defaultParseModelsResponse;
+                    return parser(data);
+                } else {
+                    if (!fallbackToStatic) throw new Error(`HTTP ${response.status}`);
+                }
+            }
+        } catch (e) {
+            console.warn('Failed to fetch models directly:', e);
+            if (!fallbackToStatic) throw e;
+        }
+    }
+
+    if (!fallbackToStatic && provider.supportsModelsApi) {
+        throw new Error('Failed to fetch models');
+    }
+
+    // Fallback to static models
+    return getStaticModels(provider.id);
+}