@henjicc/ai-sdk 0.2.8

package/dist/llm/groq/index.js

@@ -0,0 +1,30 @@
+import { runLlmChatStream, } from '../chat.js';
+import { discoverModels, } from '../discovery.js';
+import { GROQ_BASE_URL, GROQ_DEFAULT_MODEL_ID, GROQ_PROVIDER_ID, } from './preset.js';
+export { GROQ_BASE_URL, GROQ_DEFAULT_MODEL_ID, GROQ_DEFAULT_MODEL_CONFIG, GROQ_PROVIDER_ID, GROQ_PROVIDER_PRESET, } from './preset.js';
+/**
+ * 把 Groq 的稳定坐标补到通用 LLM DTO；真正的 SSE、错误、usage 与 finish 解析仍由共享内核完成。
+ */
+export function createGroqChatRequest(request) {
+    return {
+        ...request,
+        providerId: GROQ_PROVIDER_ID,
+        modelId: request.modelId?.trim() || GROQ_DEFAULT_MODEL_ID,
+        adapter: 'openai',
+        baseUrl: request.baseUrl?.trim() || GROQ_BASE_URL,
+    };
+}
+/** Groq 按需流式入口；没有复制第二套 OpenAI-compatible 执行逻辑。 */
+export async function runGroqChatStream(request, taskId, emit, runtime, options = {}) {
+    const { hooks = {}, signal, timeoutMs } = options;
+    return await runLlmChatStream(createGroqChatRequest(request), taskId, emit, runtime, hooks, { signal, timeoutMs });
+}
+/** Groq 官方 /models 发现：要求凭据并过滤 active=false，保留未知 active 的兼容项。 */
+export async function discoverGroqModels(runtime, options = {}) {
+    return await discoverModels(GROQ_PROVIDER_ID, GROQ_BASE_URL, runtime, {
+        ...options,
+        requireCredential: true,
+        activeOnly: true,
+    });
+}
+export { GROQ_LLM_MODULE_DESCRIPTOR, GROQ_LLM_MODULE_ID, createGroqLlmModule, } from './module.js';

package/dist/llm/groq/module.d.ts

@@ -0,0 +1,6 @@
+import type { LlmModule, LlmModuleDescriptor } from '../modules/types.js';
+export declare const GROQ_LLM_MODULE_ID = "groq.chat.openai/gpt-oss-20b";
+/** Groq 内置路由的正式 module descriptor；外部插件占用同坐标时由 LlmModuleClient 拒绝。 */
+export declare const GROQ_LLM_MODULE_DESCRIPTOR: LlmModuleDescriptor;
+/** 把现有 Groq Chat/SSE/发现内核包装成同一 LLM module，不复制协议实现。 */
+export declare function createGroqLlmModule(): LlmModule;

package/dist/llm/groq/module.js

@@ -0,0 +1,51 @@
+import { runLlmChatStream } from '../chat.js';
+import { discoverModels } from '../discovery.js';
+import { GROQ_BASE_URL, GROQ_DEFAULT_MODEL_CONFIG, GROQ_DEFAULT_MODEL_ID, GROQ_PROVIDER_ID, } from './preset.js';
+export const GROQ_LLM_MODULE_ID = 'groq.chat.openai/gpt-oss-20b';
+/** Groq 内置路由的正式 module descriptor；外部插件占用同坐标时由 LlmModuleClient 拒绝。 */
+export const GROQ_LLM_MODULE_DESCRIPTOR = Object.freeze({
+    id: GROQ_LLM_MODULE_ID,
+    source: Object.freeze({ kind: 'builtin', namespace: '@henjicc/ai-sdk' }),
+    providerId: GROQ_PROVIDER_ID,
+    modelId: GROQ_DEFAULT_MODEL_ID,
+    displayName: GROQ_DEFAULT_MODEL_CONFIG.displayName,
+    capabilities: Object.freeze({ ...GROQ_DEFAULT_MODEL_CONFIG.capabilities }),
+    executionModes: Object.freeze(['request-response', 'event-stream']),
+    tags: Object.freeze(['groq', 'openai-compatible', 'builtin']),
+});
+/** 把现有 Groq Chat/SSE/发现内核包装成同一 LLM module，不复制协议实现。 */
+export function createGroqLlmModule() {
+    return {
+        descriptor: GROQ_LLM_MODULE_DESCRIPTOR,
+        execute: async (request, context) => {
+            let pendingEvent = Promise.resolve();
+            const forward = (event) => {
+                if (context.mode !== 'event-stream')
+                    return;
+                if (event.type !== 'Token' && event.type !== 'ReasoningToken')
+                    return;
+                pendingEvent = pendingEvent.then(async () => await context.emit(event));
+            };
+            const outcome = await runLlmChatStream({
+                ...request,
+                providerId: GROQ_PROVIDER_ID,
+                modelId: request.modelId || GROQ_DEFAULT_MODEL_ID,
+                adapter: 'openai',
+                baseUrl: request.baseUrl?.trim() || GROQ_BASE_URL,
+            }, context.requestId, forward, context.runtime, {}, { signal: context.signal });
+            await pendingEvent;
+            return {
+                output: outcome.output,
+                reasoningOutput: outcome.reasoningOutput,
+                usage: outcome.usage,
+                finishReason: outcome.finishReason,
+                toolCalls: outcome.toolCalls,
+            };
+        },
+        discover: async (context) => await discoverModels(GROQ_PROVIDER_ID, GROQ_BASE_URL, context.runtime, {
+            signal: context.signal,
+            requireCredential: true,
+            activeOnly: true,
+        }),
+    };
+}

package/dist/llm/groq/preset.d.ts

@@ -0,0 +1,9 @@
+import type { LlmProviderPreset } from '../providerPresets.js';
+import type { LlmModelConfig } from '../types.js';
+export declare const GROQ_PROVIDER_ID = "groq";
+export declare const GROQ_BASE_URL = "https://api.groq.com/openai/v1";
+export declare const GROQ_DEFAULT_MODEL_ID = "openai/gpt-oss-20b";
+/** GroqCloud 预设；供应商与 xAI Grok 没有关系。 */
+export declare const GROQ_PROVIDER_PRESET: LlmProviderPreset;
+/** 可直接交给统一能力发现器的默认模型；不会触发模型列表网络请求。 */
+export declare const GROQ_DEFAULT_MODEL_CONFIG: LlmModelConfig;

package/dist/llm/groq/preset.js

@@ -0,0 +1,50 @@
+import { findProviderMetadata } from '../../providers/metadata.js';
+export const GROQ_PROVIDER_ID = 'groq';
+export const GROQ_BASE_URL = 'https://api.groq.com/openai/v1';
+export const GROQ_DEFAULT_MODEL_ID = 'openai/gpt-oss-20b';
+const GROQ_PROVIDER_METADATA = findProviderMetadata(GROQ_PROVIDER_ID);
+if (!GROQ_PROVIDER_METADATA)
+    throw new Error('[provider_metadata_missing] provider "groq" is not registered');
+/** GroqCloud 预设；供应商与 xAI Grok 没有关系。 */
+export const GROQ_PROVIDER_PRESET = {
+    providerId: GROQ_PROVIDER_ID,
+    displayName: 'GroqCloud',
+    adapter: 'openai',
+    apiProtocol: 'openai-compatible',
+    baseUrl: GROQ_BASE_URL,
+    reasoning: { enabled: true, effort: 'medium' },
+    reasoningConfigurable: true,
+    modelIds: [GROQ_DEFAULT_MODEL_ID],
+    websiteUrl: GROQ_PROVIDER_METADATA.websiteUrl,
+    apiKeyUrl: GROQ_PROVIDER_METADATA.apiKeyUrl,
+    docs: 'docs/model-adaptation/供应商/Groq.md',
+    note: 'GroqCloud（providerId=groq）不是 xAI Grok；GPT-OSS 不支持 reasoning_format。',
+};
+/** 可直接交给统一能力发现器的默认模型；不会触发模型列表网络请求。 */
+export const GROQ_DEFAULT_MODEL_CONFIG = {
+    providerId: GROQ_PROVIDER_ID,
+    modelId: GROQ_DEFAULT_MODEL_ID,
+    displayName: 'GPT-OSS 20B',
+    adapter: 'openai',
+    apiProtocol: 'openai-compatible',
+    baseUrl: GROQ_BASE_URL,
+    catalogId: 'gpt-oss-20b',
+    capabilities: {
+        text: true,
+        image: false,
+        video: false,
+        audio: false,
+        file: false,
+        streaming: true,
+        toolCall: true,
+        parallelTools: false,
+        jsonOutput: true,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 131_072,
+        maxOutputTokens: 65_536,
+        usage: true,
+    },
+    enabled: true,
+};

package/dist/llm/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 大语言模型（openai-compatible 协议）相关能力：供应商协议差异、思考参数请求体处理、
+ * 内置模型能力目录、供应商预设、供应商无关的默认值、模型步契约、共享类型。
+ *
+ * 任务 4.1 从 `src/core/llm/` 迁入。痕迹AI 的助手与提示词优化业务逻辑
+ * （`promptOptimization*.ts`、`agentProfiles.ts`、`capabilitySmoke*.ts`、`events.ts`）
+ * 不属于"供应商无关的纯逻辑"，仍留在应用侧 `src/core/llm/`。
+ */
+export * from './reasoning.js';
+export * from './providerProtocol.js';
+export * from './providerReasoningRequest.js';
+export * from './modelCatalogEntries.js';
+export * from './modelCatalog.js';
+export * from './modelStep.js';
+export * from './types.js';
+export * from './defaults.js';
+export * from './providerPresets.js';
+export * from './endpointProfiles.js';
+export * from './providerSetup.js';
+export * from './chatTypes.js';
+export * from './streaming.js';
+export * from './chat.js';
+export * from './requestContract.js';
+export * from './discovery.js';
+export * from './sdk/index.js';

package/dist/llm/index.js

@@ -0,0 +1,30 @@
+/**
+ * 大语言模型（openai-compatible 协议）相关能力：供应商协议差异、思考参数请求体处理、
+ * 内置模型能力目录、供应商预设、供应商无关的默认值、模型步契约、共享类型。
+ *
+ * 任务 4.1 从 `src/core/llm/` 迁入。痕迹AI 的助手与提示词优化业务逻辑
+ * （`promptOptimization*.ts`、`agentProfiles.ts`、`capabilitySmoke*.ts`、`events.ts`）
+ * 不属于"供应商无关的纯逻辑"，仍留在应用侧 `src/core/llm/`。
+ */
+export * from './reasoning.js';
+export * from './providerProtocol.js';
+export * from './providerReasoningRequest.js';
+export * from './modelCatalogEntries.js';
+export * from './modelCatalog.js';
+export * from './modelStep.js';
+export * from './types.js';
+export * from './defaults.js';
+export * from './providerPresets.js';
+export * from './endpointProfiles.js';
+export * from './providerSetup.js';
+// 任务 4.2 迁入：LLM 执行层——原生 SSE 流式聊天路径（`chatTypes`/`streaming`/`chat`/
+// `requestContract`/`discovery`）与 Vercel AI SDK 模型步路径（`./sdk`，供应商无关执行逻辑）。
+// trace（助手结构化追踪）、capability-smoke（依赖仍留痕迹AI 的 `src/core/llm/capabilitySmoke.ts`
+// 请求/结果 schema）、scripted-model-step（助手测试替身）三处按重要记录.md 记录 014 决定
+// 不迁入 SDK，理由与依赖分析见该记录。
+export * from './chatTypes.js';
+export * from './streaming.js';
+export * from './chat.js';
+export * from './requestContract.js';
+export * from './discovery.js';
+export * from './sdk/index.js';

package/dist/llm/message-metrics.d.ts

@@ -0,0 +1,3 @@
+import type { LlmChatMessageDto } from './chatTypes.js';
+/** 流式内核与外部 module client 共用的纯输入计量，不读取或记录消息内容。 */
+export declare function countLlmInputChars(messages: readonly LlmChatMessageDto[]): number;

package/dist/llm/message-metrics.js

@@ -0,0 +1,11 @@
+/** 流式内核与外部 module client 共用的纯输入计量，不读取或记录消息内容。 */
+export function countLlmInputChars(messages) {
+    return messages.reduce((sum, message) => sum + countMessageContent(message.content), 0);
+}
+function countMessageContent(content) {
+    if (typeof content === 'string')
+        return content.length;
+    if (!Array.isArray(content))
+        return 0;
+    return content.reduce((sum, part) => sum + (typeof part.text === 'string' ? part.text.length : 0), 0);
+}

package/dist/llm/modelCatalog.d.ts

@@ -0,0 +1,60 @@
+import type { LlmApiProtocol } from './providerProtocol.js';
+import type { LlmCapabilities } from './types.js';
+/**
+ * 内置大语言模型能力目录（查表逻辑）。
+ *
+ * 解决的问题：供应商和模型是用户在设置页自建的，添加完一个模型后所有能力项默认都是关的，
+ * 用户必须自己知道"这个模型能不能看图、能不能调工具、上下文多大"再逐项勾。绝大多数用户不知道，
+ * 结果是提示词优化选不到视觉模型、画布文本节点不给挂图、智能助手判定模型不合格。
+ *
+ * 这里按模型 ID 查一次官方文档核对过的能力，添加时自动标好，用户仍可手工改。
+ * 数据在 `modelCatalogEntries.ts`，本文件只负责规范化与查表，两者都不依赖任何服务或组件。
+ */
+export interface LlmModelCatalogEntry {
+    /** 规范化后的模型 ID，同时作为落库的 `catalogId` */
+    id: string;
+    displayName: string;
+    /** 模型厂商，不是接入它的供应商——同一个模型可以从多个供应商接入 */
+    vendor: string;
+    /** 规范化后仍与 `id` 不同的其他写法（例如同能力的价格变体） */
+    aliases?: readonly string[];
+    /** 本项目当前请求路径下真实可用的输入模态，取值依据见 `modelCatalogEntries.ts` 顶部注释 */
+    input: {
+        image: boolean;
+        video: boolean;
+        audio: boolean;
+        file?: boolean;
+    };
+    toolCall: boolean;
+    parallelTools: boolean;
+    structuredOutputMode: LlmCapabilities['structuredOutputMode'];
+    reasoning: boolean;
+    /** 是否接受 temperature / top_p；官方声明为固定值的模型要记 false */
+    sampling: boolean;
+    contextWindow: number | null;
+    maxOutputTokens: number | null;
+    /** 模型原厂已确认支持的协议；最终使用协议还要与接入供应商的端点能力取交集。 */
+    apiProtocols?: readonly LlmApiProtocol[];
+    note?: string;
+    /** 该条目的资料出处，仓库内相对路径 */
+    docs: string;
+}
+export declare function modelSupportsLlmApiProtocol(entry: LlmModelCatalogEntry, protocol: LlmApiProtocol): boolean;
+/**
+ * 把各种写法的模型 ID 收敛成目录键。
+ *
+ * 同一个模型经不同渠道进来写法不同：聚合网关带厂商前缀（`deepseek/deepseek-v4-flash`、
+ * `xiaomimimo/mimo-v2.5-pro`），官方渠道带快照日期后缀（`doubao-seed-2-1-pro-260628`），
+ * 部分网关还带 `:free` 之类的档位标记。这些都指向同一份能力。
+ */
+export declare function normalizeCatalogModelId(modelId: string): string;
+export declare function findLlmModelCatalogEntry(modelId: string): LlmModelCatalogEntry | null;
+/**
+ * 把目录条目盖到一份基础能力上。
+ *
+ * 目录只覆盖它确实登记了的项：`streaming`、`usage` 这类所有 OpenAI 兼容供应商都成立的通用能力
+ * 保持基础值，不在每条数据里重复写一遍。
+ */
+export declare function applyLlmModelCatalogEntry(base: LlmCapabilities, entry: LlmModelCatalogEntry): LlmCapabilities;
+/** 人可读的输入模态摘要，用于设置页提示。 */
+export declare function describeCatalogInputModalities(entry: LlmModelCatalogEntry): string;

package/dist/llm/modelCatalog.js

@@ -0,0 +1,64 @@
+import { LLM_MODEL_CATALOG_ENTRIES } from './modelCatalogEntries.js';
+export function modelSupportsLlmApiProtocol(entry, protocol) {
+    return (entry.apiProtocols ?? ['openai-compatible']).includes(protocol);
+}
+/**
+ * 把各种写法的模型 ID 收敛成目录键。
+ *
+ * 同一个模型经不同渠道进来写法不同：聚合网关带厂商前缀（`deepseek/deepseek-v4-flash`、
+ * `xiaomimimo/mimo-v2.5-pro`），官方渠道带快照日期后缀（`doubao-seed-2-1-pro-260628`），
+ * 部分网关还带 `:free` 之类的档位标记。这些都指向同一份能力。
+ */
+export function normalizeCatalogModelId(modelId) {
+    const trimmed = modelId.trim().toLowerCase();
+    if (!trimmed)
+        return '';
+    const withoutVendorPrefix = trimmed.slice(trimmed.lastIndexOf('/') + 1);
+    const withoutTierTag = withoutVendorPrefix.split(':')[0];
+    return withoutTierTag
+        .replace(/-latest$/, '')
+        .replace(/-(\d{4}-\d{2}-\d{2}|\d{6,8})$/, '');
+}
+const CATALOG_BY_KEY = new Map(LLM_MODEL_CATALOG_ENTRIES.flatMap(entry => [
+    [entry.id, entry],
+    ...(entry.aliases ?? []).map(alias => [normalizeCatalogModelId(alias), entry]),
+]));
+export function findLlmModelCatalogEntry(modelId) {
+    const key = normalizeCatalogModelId(modelId);
+    return key ? CATALOG_BY_KEY.get(key) ?? null : null;
+}
+/**
+ * 把目录条目盖到一份基础能力上。
+ *
+ * 目录只覆盖它确实登记了的项：`streaming`、`usage` 这类所有 OpenAI 兼容供应商都成立的通用能力
+ * 保持基础值，不在每条数据里重复写一遍。
+ */
+export function applyLlmModelCatalogEntry(base, entry) {
+    return {
+        ...base,
+        text: true,
+        image: entry.input.image,
+        video: entry.input.video,
+        audio: entry.input.audio,
+        file: entry.input.file === true,
+        toolCall: entry.toolCall,
+        parallelTools: entry.parallelTools,
+        structuredOutputMode: entry.structuredOutputMode,
+        jsonOutput: entry.structuredOutputMode !== 'none',
+        reasoning: entry.reasoning,
+        sampling: entry.sampling,
+        contextWindow: entry.contextWindow,
+        maxOutputTokens: entry.maxOutputTokens,
+    };
+}
+/** 人可读的输入模态摘要，用于设置页提示。 */
+export function describeCatalogInputModalities(entry) {
+    const kinds = [
+        '文本',
+        ...(entry.input.image ? ['图片'] : []),
+        ...(entry.input.video ? ['视频'] : []),
+        ...(entry.input.audio ? ['音频'] : []),
+        ...(entry.input.file ? ['文件'] : []),
+    ];
+    return kinds.join(' / ');
+}

package/dist/llm/modelCatalogEntries.d.ts

@@ -0,0 +1,15 @@
+import type { LlmModelCatalogEntry } from './modelCatalog.js';
+/**
+ * 内置大语言模型能力目录（数据）。
+ *
+ * 每条都对应 `packages/ai-sdk/docs/llm-adaptation/供应商/*.md` 里核对过的官方文档，`docs` 字段指向该文档。
+ * **只登记文档明确写出的能力**：文档没写的一律保持保守取值（false / null），由用户手工勾选或
+ * 走「验证此模型」动态探测补齐，不靠模型名猜。
+ *
+ * `input` 记录的是**在本项目当前请求路径下真实可用**的输入模态，不是模型宣传的模态：
+ * 画布文本处理与提示词优化走原生流式路径（`streaming.ts`，image/video/audio 三种内容块都能发），
+ * 智能助手走 AI SDK 模型步骤（`provider.ts`，当前只能表达 image/audio）。某个模态只在项目尚未
+ * 实现的协议（Responses API / Anthropic Messages）下可用时，一律记为 false 并在 `note` 里写明原因，
+ * 否则用户会得到"勾了但发过去没反应"的静默失效。
+ */
+export declare const LLM_MODEL_CATALOG_ENTRIES: readonly LlmModelCatalogEntry[];

package/dist/llm/modelCatalogEntries.js

@@ -0,0 +1,274 @@
+/**
+ * 内置大语言模型能力目录（数据）。
+ *
+ * 每条都对应 `packages/ai-sdk/docs/llm-adaptation/供应商/*.md` 里核对过的官方文档，`docs` 字段指向该文档。
+ * **只登记文档明确写出的能力**：文档没写的一律保持保守取值（false / null），由用户手工勾选或
+ * 走「验证此模型」动态探测补齐，不靠模型名猜。
+ *
+ * `input` 记录的是**在本项目当前请求路径下真实可用**的输入模态，不是模型宣传的模态：
+ * 画布文本处理与提示词优化走原生流式路径（`streaming.ts`，image/video/audio 三种内容块都能发），
+ * 智能助手走 AI SDK 模型步骤（`provider.ts`，当前只能表达 image/audio）。某个模态只在项目尚未
+ * 实现的协议（Responses API / Anthropic Messages）下可用时，一律记为 false 并在 `note` 里写明原因，
+ * 否则用户会得到"勾了但发过去没反应"的静默失效。
+ */
+export const LLM_MODEL_CATALOG_ENTRIES = [
+    // ---------------- OpenAI GPT-OSS（Groq 托管） ----------------
+    {
+        id: 'gpt-oss-20b',
+        displayName: 'GPT-OSS 20B',
+        vendor: 'OpenAI',
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 131_072,
+        maxOutputTokens: 65_536,
+        note: 'Groq Production 模型；reasoning_effort 仅支持 low / medium / high，且不支持 reasoning_format。',
+        docs: 'docs/model-adaptation/GPT-OSS-20B/GPT-OSS-20B_Groq.md',
+    },
+    // ---------------- DeepSeek ----------------
+    {
+        id: 'deepseek-v4-flash',
+        displayName: 'DeepSeek V4 Flash',
+        vendor: 'DeepSeek',
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 384_000,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '思考模式下 temperature / top_p 传了也不生效。',
+        docs: 'docs/llm-adaptation/供应商/DeepSeek.md',
+    },
+    {
+        id: 'deepseek-v4-pro',
+        displayName: 'DeepSeek V4 Pro',
+        vendor: 'DeepSeek',
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 384_000,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        docs: 'docs/llm-adaptation/供应商/DeepSeek.md',
+    },
+    {
+        id: 'deepseek-v4-flash-vision-exp',
+        displayName: 'DeepSeek V4 Flash Vision (实验)',
+        vendor: 'DeepSeek',
+        input: { image: true, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 384_000,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '图片输入只在 Responses API 下可用；SDK 会在直连 DeepSeek 时自动选择 Responses。',
+        docs: 'docs/llm-adaptation/供应商/DeepSeek.md',
+    },
+    // ---------------- Kimi（Moonshot） ----------------
+    {
+        id: 'kimi-k3',
+        displayName: 'Kimi K3',
+        vendor: 'Moonshot',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'schema',
+        reasoning: true,
+        // 官方文档把 temperature / top_p 等列为固定值并明确"建议不要显式传入"，
+        // sampling=false 会让模型步骤不再下发这两个参数。
+        sampling: false,
+        contextWindow: 1_048_576,
+        maxOutputTokens: 131_072,
+        note: '思考模式始终开启无法关闭；图片必须用 base64 data URL，不接受公网直链；视频要先经 Files API 上传再用 ms://<file-id> 引用。',
+        docs: 'docs/llm-adaptation/供应商/Kimi.md',
+    },
+    {
+        id: 'kimi-k2.6',
+        displayName: 'Kimi K2.6',
+        vendor: 'Moonshot',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: null,
+        maxOutputTokens: null,
+        note: '沿用项目既有内置配置的模态标注，未逐项核对官方文档；上下文与输出上限留空由动态验证或用户补齐。',
+        docs: 'docs/llm-adaptation/供应商/Kimi.md',
+    },
+    // ---------------- 智谱 GLM ----------------
+    {
+        id: 'glm-5.3-flash',
+        displayName: 'GLM-5.3-Flash',
+        vendor: '智谱',
+        input: { image: true, video: true, audio: false, file: true },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'none',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 131_072,
+        note: '国内与国际端点共用 Chat Completions 协议；文件只接受宿主已持有的 URL/内联内容，不声明上传与 file_id。结构化输出和 tool_stream 未确认，保持关闭。',
+        docs: 'docs/model-adaptation/GLM-5.3-Flash/GLM-5.3-Flash_智谱.md',
+    },
+    {
+        id: 'glm-5.3',
+        displayName: 'GLM-5.3',
+        vendor: '智谱',
+        // 官方模型页原文："目前仅支持处理文本模态"。视觉场景要换 glm-5v-turbo。
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 128_000,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '始终开启思考且无法关闭；官方明确只支持文本模态，需要看图看视频请改用 GLM-5V-Turbo。',
+        docs: 'docs/llm-adaptation/供应商/智谱GLM.md',
+    },
+    {
+        id: 'glm-5v-turbo',
+        displayName: 'GLM-5V-Turbo',
+        vendor: '智谱',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 200_000,
+        maxOutputTokens: 128_000,
+        note: '官方明确不支持在一次请求里同时理解文件、视频和图像，一次只能带其中一种。',
+        docs: 'docs/llm-adaptation/供应商/智谱GLM.md',
+    },
+    // ---------------- 火山引擎（豆包 / Ark） ----------------
+    {
+        id: 'doubao-seed-evolving',
+        displayName: 'Doubao-Seed-Evolving',
+        vendor: '火山引擎',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_048_576,
+        maxOutputTokens: 262_144,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: 'Model ID 固定、版本自动滚动；SDK 在火山引擎直连时默认使用 Responses API。',
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
+    {
+        id: 'doubao-seed-2-1-pro',
+        displayName: 'Doubao-Seed-2.1-Pro',
+        vendor: '火山引擎',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 262_144,
+        maxOutputTokens: 262_144,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
+    {
+        id: 'doubao-seed-2-1-turbo',
+        displayName: 'Doubao-Seed-2.1-Turbo',
+        vendor: '火山引擎',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 262_144,
+        maxOutputTokens: 262_144,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        docs: 'docs/llm-adaptation/供应商/火山引擎.md',
+    },
+    // ---------------- 小米 MiMo ----------------
+    {
+        id: 'mimo-v2.5-pro',
+        displayName: 'MiMo-V2.5-Pro',
+        vendor: '小米',
+        input: { image: false, video: false, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 131_072,
+        note: '多轮工具调用时官方建议把历史轮次的 reasoning_content 一并回传。',
+        docs: 'docs/llm-adaptation/供应商/小米MiMo.md',
+    },
+    {
+        id: 'mimo-v2.5',
+        displayName: 'MiMo-V2.5',
+        vendor: '小米',
+        input: { image: true, video: true, audio: true },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 131_072,
+        note: '官方标注全模态理解，图片 / 音频 / 视频均可作为输入。',
+        docs: 'docs/llm-adaptation/供应商/小米MiMo.md',
+    },
+    // ---------------- 阿里云百炼 Qwen ----------------
+    {
+        id: 'qwen3.8-max',
+        displayName: 'Qwen3.8-Max',
+        vendor: '阿里云百炼',
+        aliases: ['qwen3.8-max-prime'],
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        // 官方文档只写"超长文档与长视频"，没有给出可引用的上下文 token 数，留空走回退预算。
+        contextWindow: null,
+        maxOutputTokens: null,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: '必须走多模态接口：即使是纯文字对话，content 也要写成内容块数组，直接传字符串会报 url error。',
+        docs: 'docs/llm-adaptation/供应商/百炼Qwen.md',
+    },
+    // ---------------- MiniMax ----------------
+    {
+        id: 'minimax-m3',
+        displayName: 'MiniMax-M3',
+        vendor: 'MiniMax',
+        input: { image: true, video: true, audio: false },
+        toolCall: true,
+        parallelTools: false,
+        structuredOutputMode: 'json',
+        reasoning: true,
+        sampling: true,
+        contextWindow: 1_000_000,
+        maxOutputTokens: 131_072,
+        apiProtocols: ['openai-responses', 'openai-compatible'],
+        note: 'SDK 在 MiniMax 直连时默认使用 Responses API；不向用户暴露底层协议选择。',
+        docs: 'docs/llm-adaptation/供应商/MiniMax.md',
+    },
+];