@henjicc/ai-sdk 0.2.8

package/dist/providers/grsai.js

@@ -0,0 +1,99 @@
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+import { POLL_QUERY_FAILED, pollUntilResult } from '../protocols/polling.js';
+import { buildGrsaiEndpoints, markGrsaiEndpointReachable } from './endpoints/grsai.js';
+import { collectDeepUrls, getPointer, isJsonObject, readJsonResponse, stringAt } from './helpers.js';
+import { fetchProvider } from './provider-fetch.js';
+// Grsai 状态是与 failed 平级的独立终态（内容审核不通过），必须单独判断，不能只看 succeeded/failed。
+const TERMINAL_FAILURE_STATUSES = new Set(['failed', 'violation']);
+export async function execute(input) {
+    const payload = await sendGenerate(input);
+    const status = extractStatus(payload);
+    if (TERMINAL_FAILURE_STATUSES.has(status)) {
+        throw new AiRuntimeError('provider_task_failed', extractErrorMessage(payload) ?? 'Grsai generate failed');
+    }
+    const urls = extractUrls(payload);
+    if (status === 'succeeded' && urls.length > 0) {
+        return { status: 'completed', url: urls.join('|||'), metadata: payload };
+    }
+    const taskId = extractTaskId(payload);
+    if (taskId) {
+        return { status: 'pending', url: '', taskId, metadata: payload };
+    }
+    if (urls.length > 0) {
+        return { status: 'completed', url: urls.join('|||'), metadata: payload };
+    }
+    throw new AiRuntimeError('empty_result', 'Grsai response has neither task ID nor media URL');
+}
+export async function continuePolling(input) {
+    const payload = await pollTask(input);
+    const urls = extractUrls(payload);
+    if (urls.length === 0) {
+        throw new AiRuntimeError('empty_result', `Grsai response has no media URL (task_id=${input.taskId})`);
+    }
+    return { status: 'completed', url: urls.join('|||'), taskId: input.taskId, metadata: payload };
+}
+async function sendGenerate(input) {
+    const endpoints = buildGrsaiEndpoints(input.route);
+    const response = await fetchProvider('Grsai', endpoints[0], {
+        method: input.method,
+        headers: {
+            Authorization: `Bearer ${input.apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        // 项目按轮询模式接入，无论模型 builder 传了什么都在发送边界强制收敛为异步模式，
+        // 防止漏写/误写导致改走同步等待或 SSE 流，与本项目的轮询驱动不兼容。
+        body: JSON.stringify(isJsonObject(input.body)
+            ? { ...input.body, replyType: 'async' }
+            : input.body),
+        signal: input.signal,
+    }, {
+        transport: input.runtime.transport,
+        // 两条线路的账号/任务数据关系未经官方确认，只在能证明尚未建立连接时切换，不重放已建立连接后的失败。
+        retryPreconnectOnce: true,
+        fallbackEndpoints: endpoints.slice(1),
+        onEndpointReached: markGrsaiEndpointReachable,
+    });
+    return await readJsonResponse(response, 'Grsai');
+}
+async function pollTask(input) {
+    return await pollUntilResult(input, async () => {
+        const endpoints = buildGrsaiEndpoints(`/v1/api/result?id=${encodeURIComponent(input.taskId)}`);
+        const response = await fetchProvider('Grsai', endpoints[0], {
+            headers: { Authorization: `Bearer ${input.apiKey}` },
+            signal: input.signal,
+        }, {
+            transport: input.runtime.transport,
+            retryPreconnectOnce: true,
+            fallbackEndpoints: endpoints.slice(1),
+            onEndpointReached: markGrsaiEndpointReachable,
+        });
+        const payload = await readJsonResponse(response, 'Grsai');
+        const status = extractStatus(payload);
+        if (status === 'succeeded')
+            return payload;
+        if (TERMINAL_FAILURE_STATUSES.has(status)) {
+            throw new AiRuntimeError('provider_task_failed', extractErrorMessage(payload) ?? 'Grsai task failed');
+        }
+        if (status === 'running')
+            return undefined;
+        // 状态字段缺失或未知取值：查询本身没能给出可信结果，计入连续失败而不是当作"仍在处理中"。
+        return POLL_QUERY_FAILED;
+    });
+}
+function extractTaskId(payload) {
+    return stringAt(payload, '/id');
+}
+function extractStatus(payload) {
+    return (stringAt(payload, '/status') ?? '').trim().toLowerCase();
+}
+function extractErrorMessage(payload) {
+    const message = stringAt(payload, '/error');
+    return message?.trim() ? message : undefined;
+}
+function extractUrls(payload) {
+    const urls = [];
+    const results = getPointer(payload, '/results');
+    if (results !== undefined)
+        collectDeepUrls(results, urls);
+    return urls;
+}

package/dist/providers/helpers.d.ts

@@ -0,0 +1,10 @@
+import type { JsonObject, JsonValue } from '../types/runtime.js';
+export declare function normalizeEndpoint(base: string, route: string): string;
+export declare function readJsonResponse(response: Response, provider: string): Promise<JsonValue>;
+export declare function asObject(value: JsonValue): JsonObject;
+export declare function getPointer(value: JsonValue, pointer: string): JsonValue | undefined;
+export declare function stringAt(value: JsonValue, pointer: string): string | undefined;
+export declare function numberAt(value: JsonValue, pointer: string): number | undefined;
+export declare function pushUniqueUrl(target: string[], url: string): void;
+export declare function collectDeepUrls(value: JsonValue, target: string[]): void;
+export declare function isJsonObject(value: JsonValue | undefined): value is JsonObject;

package/dist/providers/helpers.js

@@ -0,0 +1,76 @@
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+export function normalizeEndpoint(base, route) {
+    if (route.startsWith('http://') || route.startsWith('https://')) {
+        return route;
+    }
+    if (route.startsWith('/')) {
+        return `${base}${route}`;
+    }
+    return `${base}/${route}`;
+}
+export async function readJsonResponse(response, provider) {
+    const payload = await response.json().catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new AiRuntimeError('invalid_json', message);
+    });
+    if (!response.ok) {
+        throw new AiRuntimeError('provider_http_error', `${provider} HTTP ${response.status}: ${JSON.stringify(payload)}`);
+    }
+    return payload;
+}
+export function asObject(value) {
+    return isJsonObject(value) ? value : {};
+}
+export function getPointer(value, pointer) {
+    if (pointer === '') {
+        return value;
+    }
+    let current = value;
+    for (const rawPart of pointer.split('/').slice(1)) {
+        if (!isJsonObject(current) && !Array.isArray(current)) {
+            return undefined;
+        }
+        const part = rawPart.replace(/~1/g, '/').replace(/~0/g, '~');
+        current = Array.isArray(current) ? current[Number(part)] : current[part];
+    }
+    return current;
+}
+export function stringAt(value, pointer) {
+    const target = getPointer(value, pointer);
+    return typeof target === 'string' ? target : undefined;
+}
+export function numberAt(value, pointer) {
+    const target = getPointer(value, pointer);
+    return typeof target === 'number' ? target : undefined;
+}
+export function pushUniqueUrl(target, url) {
+    if (!url.trim() || target.includes(url)) {
+        return;
+    }
+    target.push(url);
+}
+export function collectDeepUrls(value, target) {
+    if (typeof value === 'string') {
+        if (/^https?:\/\//.test(value))
+            pushUniqueUrl(target, value);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectDeepUrls(item, target);
+        }
+        return;
+    }
+    if (!isJsonObject(value)) {
+        return;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (key.toLowerCase().includes('url') && typeof item === 'string' && /^https?:\/\//.test(item)) {
+            pushUniqueUrl(target, item);
+        }
+        collectDeepUrls(item, target);
+    }
+}
+export function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/providers/index.d.ts

@@ -0,0 +1,25 @@
+import type { ProviderContinuePollingInput, ProviderExecutionInput, ProviderExecutionResult } from '../types/runtime.js';
+import type { ProviderAdapter } from './types.js';
+import { type ProviderId } from '../types/model.js';
+export { resolvePpioMediaRewriteMode, type PpioMediaRewriteMode } from './ppio-media.js';
+export { PROVIDER_METADATA, findProviderMetadata, type ProviderMetadata, type ProviderMetadataLookupOptions, } from './metadata.js';
+export { testProviderConnection } from './connection.js';
+export { fetchProvider } from './provider-fetch.js';
+export { buildApiMartEndpoints, markApiMartEndpointReachable, resetApiMartEndpointPreference, warmApiMartEndpointPreference, } from './endpoints/apimart.js';
+export { buildGrsaiEndpoints, markGrsaiEndpointReachable, resetGrsaiEndpointPreference, warmGrsaiEndpointPreference, } from './endpoints/grsai.js';
+export type { ProviderAdapter } from './types.js';
+/**
+ * 登记一个供应商适配器。
+ *
+ * 同一 id 重复注册会抛 `provider_already_registered`，避免扩展意外覆盖内置供应商。
+ * 测试或插件卸载时应在 `finally`/`afterEach` 调用 `unregisterProvider` 清理自己的唯一 id。
+ */
+export declare function registerProvider(id: ProviderId, adapter: ProviderAdapter): void;
+/** 注销指定供应商；存在并删除时返回 `true`，未登记时返回 `false`。 */
+export declare function unregisterProvider(id: ProviderId): boolean;
+/** 返回当前已登记 provider id 的快照；修改返回数组不会影响注册表。 */
+export declare function listProviders(): ProviderId[];
+/** 按 id 查找已登记的供应商适配器；找不到时抛 `unknown_provider`，不静默返回 `undefined`。 */
+export declare function resolveProvider(id: ProviderId): ProviderAdapter;
+export declare function executeGenerate(providerId: ProviderId, input: ProviderExecutionInput): Promise<ProviderExecutionResult>;
+export declare function executeContinuePolling(providerId: ProviderId, input: ProviderContinuePollingInput): Promise<ProviderExecutionResult>;

package/dist/providers/index.js

@@ -0,0 +1,93 @@
+/**
+ * 各 AI 供应商适配器（PPIO / Fal / ModelScope / KIE / APIMart / Grsai / Bailian / Volcengine）。
+ *
+ * 分发方式是注册表而不是静态 `switch`（见 docs/task/模型SDK抽离/重要记录.md 记录 005）：
+ * `registerProvider(id, adapter)` 把一个供应商适配器登记进内存 Map，`resolveProvider(id)` /
+ * `executeGenerate` / `executeContinuePolling` 按 id 查表分发。这是为「新增供应商无需改这个
+ * 文件本身的 switch 分支」的可扩展性铺路——本任务（2.3）只做这一层机制改造，8 个内置供应商
+ * 的行为与迁移前完全一致，全部在本文件底部自注册。
+ */
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+import { BUILTIN_PROVIDER_IDS, } from '../types/model.js';
+export { resolvePpioMediaRewriteMode } from './ppio-media.js';
+export { PROVIDER_METADATA, findProviderMetadata, } from './metadata.js';
+export { testProviderConnection } from './connection.js';
+export { fetchProvider } from './provider-fetch.js';
+export { buildApiMartEndpoints, markApiMartEndpointReachable, resetApiMartEndpointPreference, warmApiMartEndpointPreference, } from './endpoints/apimart.js';
+export { buildGrsaiEndpoints, markGrsaiEndpointReachable, resetGrsaiEndpointPreference, warmGrsaiEndpointPreference, } from './endpoints/grsai.js';
+const registry = new Map();
+let builtinProvidersInitialized = false;
+/**
+ * 内置 provider 在首次使用注册表时惰性装入，而不是在模块加载阶段执行注册调用。
+ * 这样模块可被消费方安全 tree-shake，`sideEffects: false` 不会丢失仅靠副作用保留的初始化代码。
+ */
+function ensureBuiltinProvidersInitialized() {
+    if (builtinProvidersInitialized)
+        return;
+    for (const providerId of BUILTIN_PROVIDER_IDS) {
+        registry.set(providerId, builtinProviders[providerId]);
+    }
+    builtinProvidersInitialized = true;
+}
+/**
+ * 登记一个供应商适配器。
+ *
+ * 同一 id 重复注册会抛 `provider_already_registered`，避免扩展意外覆盖内置供应商。
+ * 测试或插件卸载时应在 `finally`/`afterEach` 调用 `unregisterProvider` 清理自己的唯一 id。
+ */
+export function registerProvider(id, adapter) {
+    ensureBuiltinProvidersInitialized();
+    if (typeof id !== 'string' || id.trim().length === 0) {
+        throw new AiRuntimeError('invalid_provider_id', 'Provider id must be a non-empty string');
+    }
+    if (registry.has(id)) {
+        throw new AiRuntimeError('provider_already_registered', `Provider already registered: ${id}`);
+    }
+    registry.set(id, adapter);
+}
+/** 注销指定供应商；存在并删除时返回 `true`，未登记时返回 `false`。 */
+export function unregisterProvider(id) {
+    ensureBuiltinProvidersInitialized();
+    return registry.delete(id);
+}
+/** 返回当前已登记 provider id 的快照；修改返回数组不会影响注册表。 */
+export function listProviders() {
+    ensureBuiltinProvidersInitialized();
+    return [...registry.keys()];
+}
+/** 按 id 查找已登记的供应商适配器；找不到时抛 `unknown_provider`，不静默返回 `undefined`。 */
+export function resolveProvider(id) {
+    ensureBuiltinProvidersInitialized();
+    const adapter = registry.get(id);
+    if (!adapter) {
+        throw new AiRuntimeError('unknown_provider', `Unknown provider: ${id}`);
+    }
+    return adapter;
+}
+export async function executeGenerate(providerId, input) {
+    return await resolveProvider(providerId).execute(input);
+}
+export async function executeContinuePolling(providerId, input) {
+    return await resolveProvider(providerId).continuePolling(input);
+}
+// ---------------------------------------------------------------------------
+// 内置供应商自注册
+// ---------------------------------------------------------------------------
+import * as apimart from './apimart.js';
+import * as bailian from './bailian.js';
+import * as fal from './fal.js';
+import * as grsai from './grsai.js';
+import * as kie from './kie.js';
+import * as modelscope from './modelscope.js';
+import * as ppio from './ppio.js';
+import * as volcengine from './volcengine.js';
+const builtinProviders = {
+    apimart,
+    bailian,
+    volcengine,
+    ppio,
+    kie,
+    modelscope,
+    fal,
+    grsai,
+};

package/dist/providers/kie.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderContinuePollingInput, ProviderExecutionInput, ProviderExecutionResult } from '../types/runtime.js';
+export declare function execute(input: ProviderExecutionInput): Promise<ProviderExecutionResult>;
+export declare function continuePolling(input: ProviderContinuePollingInput): Promise<ProviderExecutionResult>;

package/dist/providers/kie.js

@@ -0,0 +1,125 @@
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
+import { POLL_QUERY_FAILED, pollUntilResult } from '../protocols/polling.js';
+import { collectDeepUrls, getPointer, normalizeEndpoint, pushUniqueUrl, readJsonResponse, stringAt } from './helpers.js';
+import { fetchProvider } from './provider-fetch.js';
+const KIE_BASE_URL = 'https://api.kie.ai';
+const KIE_STATUS_ENDPOINT = '/api/v1/jobs/recordInfo';
+export async function execute(input) {
+    const response = await sendCreateTask(input, normalizeEndpoint(KIE_BASE_URL, input.route));
+    const taskId = extractTaskId(response);
+    if (taskId) {
+        return { status: 'pending', url: '', taskId, metadata: response };
+    }
+    const urls = extractUrls(response);
+    if (urls.length === 0) {
+        throw new AiRuntimeError('empty_result', `KIE response has no media URL (task_id=${taskId ?? 'unknown'})`);
+    }
+    return { status: 'completed', url: urls.join('|||'), taskId, metadata: response };
+}
+export async function continuePolling(input) {
+    const finalPayload = await pollTask(input);
+    const urls = extractUrls(finalPayload);
+    if (urls.length === 0) {
+        throw new AiRuntimeError('empty_result', `KIE response has no media URL (task_id=${input.taskId})`);
+    }
+    return { status: 'completed', url: urls.join('|||'), taskId: input.taskId, metadata: finalPayload };
+}
+async function sendCreateTask(input, endpoint) {
+    const response = await fetchProvider('KIE', endpoint, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${input.apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(input.body),
+        signal: input.signal,
+    }, {
+        transport: input.runtime.transport,
+        // 只对尚未建立连接的错误重试；连接建立后的失败可能已创建计费任务，禁止盲目重放。
+        retryPreconnectOnce: true,
+    });
+    const payload = await readJsonResponse(response, 'KIE');
+    const code = getPointer(payload, '/code');
+    const success = getPointer(payload, '/success');
+    if ((typeof code === 'number' && code !== 200) || success === false) {
+        throw new AiRuntimeError('provider_task_failed', stringAt(payload, '/msg') ?? 'KIE create task failed');
+    }
+    return payload;
+}
+async function pollTask(input) {
+    return await pollUntilResult(input, async () => {
+        const endpoint = `${KIE_BASE_URL}${KIE_STATUS_ENDPOINT}?taskId=${encodeURIComponent(input.taskId)}`;
+        const response = await fetchProvider('KIE', endpoint, {
+            headers: { Authorization: `Bearer ${input.apiKey}` },
+            signal: input.signal,
+        }, {
+            transport: input.runtime.transport,
+            retryPreconnectOnce: true,
+        });
+        const payload = await readJsonResponse(response, 'KIE');
+        const code = getPointer(payload, '/code');
+        if (typeof code === 'number' && code !== 200) {
+            // 查询本身没成功（含 taskId 已被清理的情况），不是"任务还在跑"
+            return POLL_QUERY_FAILED;
+        }
+        if (getPointer(payload, '/success') === false)
+            return POLL_QUERY_FAILED;
+        const state = (stringAt(payload, '/data/state') ?? '').trim().toLowerCase();
+        if (state === 'success')
+            return payload;
+        if (state === 'fail') {
+            throw new AiRuntimeError('provider_task_failed', stringAt(payload, '/data/failMsg') ?? 'KIE task failed');
+        }
+        if (['waiting', 'queuing', 'generating'].includes(state))
+            return undefined;
+        return POLL_QUERY_FAILED;
+    });
+}
+function extractTaskId(payload) {
+    return stringAt(payload, '/data/taskId');
+}
+function extractUrls(payload) {
+    const resultJson = stringAt(payload, '/data/resultJson');
+    if (resultJson) {
+        try {
+            const parsed = JSON.parse(resultJson);
+            const urls = [];
+            for (const pointer of ['/resultUrls', '/images', '/videos', '/firstFrameUrl', '/lastFrameUrl']) {
+                extractFromValue(getPointer(parsed, pointer), urls);
+            }
+            const resultObject = getPointer(parsed, '/resultObject');
+            if (resultObject !== undefined)
+                collectDeepUrls(resultObject, urls);
+            if (urls.length > 0)
+                return urls;
+        }
+        catch {
+            // Fall through to direct payload extraction.
+        }
+    }
+    const urls = [];
+    for (const pointer of ['/resultUrls', '/images', '/videos', '/firstFrameUrl', '/lastFrameUrl']) {
+        extractFromValue(getPointer(payload, pointer), urls);
+    }
+    const resultObject = getPointer(payload, '/resultObject');
+    if (resultObject !== undefined)
+        collectDeepUrls(resultObject, urls);
+    return urls;
+}
+function extractFromValue(value, target) {
+    if (typeof value === 'string') {
+        pushUniqueUrl(target, value);
+        return;
+    }
+    if (!Array.isArray(value))
+        return;
+    for (const item of value) {
+        if (typeof item === 'string')
+            pushUniqueUrl(target, item);
+        else {
+            const url = getPointer(item, '/url');
+            if (typeof url === 'string')
+                pushUniqueUrl(target, url);
+        }
+    }
+}

package/dist/providers/metadata.d.ts

@@ -0,0 +1,22 @@
+/** SDK 内置供应商的公开入口；不参与模型请求或宿主网络白名单。 */
+export interface ProviderMetadata {
+    providerId: string;
+    displayName: string;
+    /** 面向用户的供应商入口；存在项目邀请链接时优先使用邀请链接。 */
+    websiteUrl: string;
+    /** 创建或管理 API Key 的官方入口。 */
+    apiKeyUrl: string;
+    websiteUrlKind: 'official' | 'referral';
+    /** 该供应商资料在 SDK 包内的相对路径。 */
+    docs: string;
+}
+export interface ProviderMetadataLookupOptions {
+    /** 同一供应商存在地区站点时用于选择对应入口。 */
+    endpointProfile?: string;
+}
+export declare const PROVIDER_METADATA: readonly ProviderMetadata[];
+/**
+ * 按 providerId 获取公开入口。BigModel 可用 `endpointProfile: 'global'` 取得 Z.AI 地址。
+ * 未登记的自定义供应商返回 `null`，调用方不应猜测其官网或密钥地址。
+ */
+export declare function findProviderMetadata(providerId: string, options?: ProviderMetadataLookupOptions): ProviderMetadata | null;

package/dist/providers/metadata.js

@@ -0,0 +1,141 @@
+export const PROVIDER_METADATA = [
+    {
+        providerId: 'apimart',
+        displayName: 'APIMart',
+        websiteUrl: 'https://apimart.ai/register?aff=cGPOZd',
+        apiKeyUrl: 'https://apimart.ai/keys',
+        websiteUrlKind: 'referral',
+        docs: 'docs/model-adaptation/供应商/APIMart.md',
+    },
+    {
+        providerId: 'bailian',
+        displayName: '阿里云百炼',
+        websiteUrl: 'https://www.aliyun.com/product/bailian',
+        apiKeyUrl: 'https://bailian.console.aliyun.com/?apiKey=1#/api-key',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/百炼.md',
+    },
+    {
+        providerId: 'bigmodel',
+        displayName: '智谱 GLM（中国大陆）',
+        websiteUrl: 'https://open.bigmodel.cn/',
+        apiKeyUrl: 'https://bigmodel.cn/usercenter/proj-mgmt/apikeys',
+        websiteUrlKind: 'official',
+        docs: 'docs/llm-adaptation/供应商/智谱GLM.md',
+    },
+    {
+        providerId: 'bigmodel-global',
+        displayName: 'Z.AI GLM（Global）',
+        websiteUrl: 'https://z.ai/',
+        apiKeyUrl: 'https://z.ai/manage-apikey/apikey-list',
+        websiteUrlKind: 'official',
+        docs: 'docs/llm-adaptation/供应商/智谱GLM.md',
+    },
+    {
+        providerId: 'deepseek',
+        displayName: 'DeepSeek',
+        websiteUrl: 'https://www.deepseek.com/',
+        apiKeyUrl: 'https://platform.deepseek.com/api_keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/llm-adaptation/供应商/DeepSeek.md',
+    },
+    {
+        providerId: 'fal',
+        displayName: 'Fal',
+        websiteUrl: 'https://fal.ai/',
+        apiKeyUrl: 'https://fal.ai/dashboard/keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/Fal.md',
+    },
+    {
+        providerId: 'groq',
+        displayName: 'GroqCloud',
+        websiteUrl: 'https://groq.com/',
+        apiKeyUrl: 'https://console.groq.com/keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/Groq.md',
+    },
+    {
+        providerId: 'grsai',
+        displayName: 'Grsai',
+        websiteUrl: 'https://grsai.ai/',
+        apiKeyUrl: 'https://grsai.ai/zh/dashboard/api-keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/Grsai.md',
+    },
+    {
+        providerId: 'kie',
+        displayName: 'KIE',
+        websiteUrl: 'https://kie.ai?ref=eef20ef0b0595cad227d45b29c635f6c',
+        apiKeyUrl: 'https://kie.ai/api-key',
+        websiteUrlKind: 'referral',
+        docs: 'docs/model-adaptation/供应商/KIE.md',
+    },
+    {
+        providerId: 'kimi',
+        displayName: 'Kimi（月之暗面）',
+        websiteUrl: 'https://platform.kimi.com/',
+        apiKeyUrl: 'https://platform.kimi.com/console/api-keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/llm-adaptation/供应商/Kimi.md',
+    },
+    {
+        providerId: 'minimax',
+        displayName: 'MiniMax',
+        websiteUrl: 'https://platform.minimaxi.com/',
+        apiKeyUrl: 'https://platform.minimaxi.com/console/access?tab=api-keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/llm-adaptation/供应商/MiniMax.md',
+    },
+    {
+        providerId: 'mimo',
+        displayName: '小米 MiMo',
+        websiteUrl: 'https://mimo.mi.com/',
+        apiKeyUrl: 'https://platform.xiaomimimo.com/console/api-keys',
+        websiteUrlKind: 'official',
+        docs: 'docs/llm-adaptation/供应商/小米MiMo.md',
+    },
+    {
+        providerId: 'modelscope',
+        displayName: '魔搭',
+        websiteUrl: 'https://www.modelscope.cn/',
+        apiKeyUrl: 'https://modelscope.cn/my/myaccesstoken',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/魔搭.md',
+    },
+    {
+        providerId: 'ppio',
+        displayName: '派欧云',
+        websiteUrl: 'https://ppio.com/user/register?invited_by=WGY0DZ',
+        apiKeyUrl: 'https://ppio.com/settings/key-management',
+        websiteUrlKind: 'referral',
+        docs: 'docs/model-adaptation/供应商/派欧云.md',
+    },
+    {
+        providerId: 'siliconflow',
+        displayName: '硅基流动',
+        websiteUrl: 'https://siliconflow.cn/',
+        apiKeyUrl: 'https://cloud.siliconflow.cn/account/ak',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/硅基流动.md',
+    },
+    {
+        providerId: 'volcengine',
+        displayName: '火山引擎（豆包）',
+        websiteUrl: 'https://www.volcengine.com/product/ark',
+        apiKeyUrl: 'https://console.volcengine.com/ark/region:cn-beijing/apiKey',
+        websiteUrlKind: 'official',
+        docs: 'docs/model-adaptation/供应商/火山引擎.md',
+    },
+];
+/**
+ * 按 providerId 获取公开入口。BigModel 可用 `endpointProfile: 'global'` 取得 Z.AI 地址。
+ * 未登记的自定义供应商返回 `null`，调用方不应猜测其官网或密钥地址。
+ */
+export function findProviderMetadata(providerId, options = {}) {
+    const normalized = providerId.trim().toLowerCase();
+    const resolvedId = normalized === 'bigmodel' && options.endpointProfile?.trim().toLowerCase() === 'global'
+        ? 'bigmodel-global'
+        : normalized;
+    return PROVIDER_METADATA.find(provider => provider.providerId === resolvedId) ?? null;
+}

package/dist/providers/modelscope.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderContinuePollingInput, ProviderExecutionInput, ProviderExecutionResult } from '../types/runtime.js';
+export declare function execute(input: ProviderExecutionInput): Promise<ProviderExecutionResult>;
+export declare function continuePolling(input: ProviderContinuePollingInput): Promise<ProviderExecutionResult>;