Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* builtin.ts —— 内置供应商身份卡(TS 常量)+ bundled 目录组装。
*
* 2026-07-19 模型列表统一重构定案:**清单来源唯一化**——
* - anthropic:只供 Claude Code;清单来自 Agent SDK(会话 init 捕获)+ Registry presence,
* 由 host 注入。
* - openai:Codex 清单来自 models_cache.json,经 active-catalog 注入并投影 Claude bridge;
* Pi 清单来自随客户端发布的 Pi 原生目录快照,不经过 Codex 投影。
* - xd(Cindy AI 网关):清单来自 model-access-server GET /models(网关权威,
* 元数据由服务端 modelRegistry 下发);本文件零模型。
* - xai:Claude/Codex 静态清单活在 `catalog/providers.json`;Pi 同样只读 Pi 原生目录,
* 两边不互相复制成员关系。
*
* 身份卡(id / auth / access / routing / titleModel)是随代码走的事实:
* 改它们必然伴随发版(SDK 集成 / 翻译桥 / 网关协议都是代码),所以写死在这里,
* 不再经 OSS 下发。`catalog/providers.json`(v2)只承载 xai 清单 + presets 模板,
* 模型元数据与参考价只走同目录下严格版本化的 `model-registry.json`。
*
* ⚠️ 顺序契约:BUILTIN_PROVIDERS 的数组序(anthropic → openai → xai → xd)决定
* 选择器分段顺序与 deriveAvailableModels 的 first-wins 去重优先级,不要改动。
*/
import { appendPiProviderPresets } from './piProviderPresets.js';
import { expandPresetModels } from './presetModels.js';
import { projectProviderMediaModels } from './providerMediaModels.js';
import catalogJson from '../catalog/providers.json' with { type: 'json' };
import modelRegistryJson from '../catalog/model-registry.json' with { type: 'json' };
import type { ModelRegistry } from './modelAccessBean.js';
import { piNativeCatalogModels } from './piNativeCatalog.js';
import type { Catalog, CatalogModel, Provider } from './types.js';
/** 仓内 v2 目录文件(xai 清单 + presets 源格式;不直接发布到旧 OSS `cfg/providers.json`)。 */
const catalogFile = catalogJson as unknown as Catalog;
const bundledModelRegistry = modelRegistryJson as unknown as ModelRegistry;
/**
* 把静态目录条目的上下文窗口标记为**已核实**(不 mutate 入参)。
*
* 静态目录 —— 仓内 `catalog/providers.json` 与同格式的远端下发目录 —— 里的
* `contextWindow` 是产品侧逐条写定的真实上限,可以用来收敛运行期上报的窗口。动态发现
* 的模型**不走这里**(它们经 `set*DiscoveredModels` 注入,各自表态;上游不给元数据时补的
* 兜底常量一律不标记)。条目自己显式表过态时尊重原值。
*
* 语义见 `CatalogModel.contextWindowVerified`;不标记静态目录会让 xai 这类纯静态清单的
* 真实窗口(如 256K 的 `xai/grok-code-fast`)被当成未核实,虚高的上报值就收敛不掉。
*/
export function withVerifiedStaticWindows(provider: Provider): Provider {
const models: Provider['models'] = {};
let changed = false;
for (const [agent, list] of Object.entries(provider.models) as Array<
[keyof Provider['models'], Provider['models'][keyof Provider['models']]]
>) {
if (!list) continue;
models[agent] = list.map((m) => {
if (m.contextWindowVerified !== undefined) return m;
changed = true;
return { ...m, contextWindowVerified: true };
});
}
return changed ? { ...provider, models } : provider;
}
const xaiRaw = catalogFile.providers.find((p) => p.id === 'xai');
if (!xaiRaw) {
// 仓内目录文件被误删 xai 段属于构建期错误,越早炸越好(import 期即失败)。
throw new Error('[model-providers] catalog/providers.json missing builtin provider "xai"');
}
if (!xaiRaw.routing.pi?.wireProtocol) {
throw new Error('[model-providers] catalog/providers.json missing explicit xai Pi protocol');
}
const xaiFromCatalog = withVerifiedStaticWindows(xaiRaw);
const withoutPiApi = (model: CatalogModel): CatalogModel => {
if (model.piApi === undefined) return model;
const rest = { ...model };
delete rest.piApi;
return rest;
};
const xaiClaudeModels = xaiFromCatalog.models['claude-code'] ?? [];
const xaiCodexModels = xaiFromCatalog.models.codex ?? [];
const xaiPiOverrides = new Map((xaiFromCatalog.models.pi ?? []).map((model) => [model.id, model]));
const xaiPiModels = piNativeCatalogModels('xai', { group: 'grok' }).map((model) => ({
...model,
...xaiPiOverrides.get(model.id),
id: model.id,
}));
const openAiPiModels = piNativeCatalogModels('openai-codex', {
idPrefix: 'chatgpt/',
group: 'gpt',
});
/** xAI 的 Claude/Codex 静态根;Pi 清单来自独立的 Pi 原生快照。 */
const XAI_PROVIDER: Provider = {
...xaiFromCatalog,
agents: xaiFromCatalog.agents.includes('pi')
? xaiFromCatalog.agents
: [...xaiFromCatalog.agents, 'pi'],
routing: {
...xaiFromCatalog.routing,
pi: xaiFromCatalog.routing.pi,
},
models: {
...xaiFromCatalog.models,
'claude-code': xaiClaudeModels.map(withoutPiApi),
codex: xaiCodexModels.map(withoutPiApi),
pi: xaiPiModels,
},
};
/**
* Anthropic(Claude.ai 订阅)。清单来自 Claude Code 会话 init 的 SDK 捕获 + Registry presence。
*
* 只给 Claude Code:订阅由 Cindy 内置的官方 CLI 用它自己的登录凭证直连 Anthropic,
* Cindy 进程不读取、不转发这份凭证。Anthropic 不允许把订阅凭证用在第三方 harness
* (Codex / Pi)或第三方应用自己的请求里,所以这里不声明 codex / pi 路由。
* 远端目录若仍声明了 codex / pi,active-catalog 会按 claudeSubscriptionOnlyForClaudeCode 收窄。
*/
const ANTHROPIC_PROVIDER: Provider = {
id: 'anthropic',
name: 'Anthropic',
source: 'builtin',
agents: ['claude-code'],
auth: { method: 'oauth' },
access: { kind: 'subscription', product: 'Claude.ai' },
titleModel: 'claude-haiku-4-5',
routing: {
'claude-code': {
upstream: 'https://api.anthropic.com',
authStrategy: 'oauth-passthrough',
},
},
models: { 'claude-code': [] },
};
/**
* 把 Claude 订阅来源收窄为只供 Claude Code(内置 anthropic 与同形态的远端条目)。
* 不 mutate 入参;无需收窄时原样返回。
*/
export function claudeSubscriptionOnlyForClaudeCode(provider: Provider): Provider {
if (provider.id !== 'anthropic') return provider;
const hasOtherAgents = provider.agents.some((agent) => agent !== 'claude-code');
const hasOtherRoutes = Object.keys(provider.routing).some((agent) => agent !== 'claude-code');
const hasOtherModels = Object.entries(provider.models).some(
([agent, list]) => agent !== 'claude-code' && (list?.length ?? 0) > 0,
);
if (!hasOtherAgents && !hasOtherRoutes && !hasOtherModels) return provider;
return {
...provider,
agents: provider.agents.filter((agent) => agent === 'claude-code'),
routing: provider.routing['claude-code'] ? { 'claude-code': provider.routing['claude-code'] } : {},
models: { 'claude-code': provider.models['claude-code'] ?? [] },
};
}
/** OpenAI(ChatGPT 订阅 OAuth)。Codex/Claude 动态发现,Pi 使用独立原生快照。 */
const OPENAI_PROVIDER: Provider = {
id: 'openai',
name: 'OpenAI',
source: 'builtin',
agents: ['codex', 'claude-code', 'pi'],
auth: { method: 'oauth' },
access: { kind: 'subscription', product: 'ChatGPT' },
titleModel: 'gpt-5.4-mini',
// 图像通道:已登录 ChatGPT/Codex 时走 Codex Responses 的 hosted
// image_generation tool;用户另配 `openai-images` Platform key 时优先走 public
// Images API。id 带 openai/ 前缀(跨供应商数据契约,防 first-wins 归属漂移);
// 不声明 imageDefaults(xd 默认地位不动)。
routing: {
codex: {
upstream: 'https://chatgpt.com/backend-api/codex',
authStrategy: 'oauth-passthrough',
supportsResponsesCustomTools: true,
},
'claude-code': {
upstream: 'https://chatgpt.com/backend-api/codex',
authStrategy: 'oauth-passthrough',
modelPrefixes: ['chatgpt/'],
},
pi: {
upstream: 'https://chatgpt.com/backend-api/codex',
wireProtocol: 'anthropic-messages',
authStrategy: 'oauth-passthrough',
modelPrefixes: ['chatgpt/'],
},
},
models: { codex: [], 'claude-code': [], pi: openAiPiModels },
};
/** XD / Cindy AI 网关(账号体系托管 key)。模型清单来自网关实时下发,此处恒为空。 */
const XD_PROVIDER: Provider = {
id: 'xd',
name: 'XD Gateway',
source: 'builtin',
agents: ['claude-code', 'codex', 'pi'],
auth: { method: 'managed' },
access: { kind: 'managed' },
titleModel: 'gpt-5.4-mini',
// 向量模型:id 必须与 @cindy/embedding-client 的 EmbeddingModelId 逐字一致
// (执行侧按 id 查 catalog 拿 provider 做 input_type 值域翻译,对不上就翻译不了)。
// 只列 2026-08-04 经网关实测确认可用的型号 + 同族高置信的 3-large。
// voyage-context-4 经同一 OpenAI 形态端点支持:索引侧把 input 传二维数组
// (客户端 embedDocuments,按文档分组),查询侧仍传一维。注意它的响应形状由
// **型号**决定而不是请求维度 —— 两侧都返两层嵌套 data,解析走同一个 parser。
embeddingModels: [
{ id: 'voyage/voyage-4', name: 'Voyage 4' },
{ id: 'voyage/voyage-4-large', name: 'Voyage 4 Large' },
{ id: 'voyage/voyage-context-4', name: 'Voyage Context 4' },
{ id: 'voyage/voyage-code-3', name: 'Voyage Code 3' },
{ id: 'text-embedding-3-small', name: 'OpenAI Embedding 3 Small' },
{ id: 'text-embedding-3-large', name: 'OpenAI Embedding 3 Large' },
{ id: 'gemini-embedding-2-preview', name: 'Gemini Embedding 2 (Preview)' },
],
// standard 取 voyage-4:1024 维、32K 单条上限、中等价格,且是四个候选里唯一
// 实测确定性的多语通用型号。preview 型号不作默认(catalog 注释同口径)。
embeddingDefaults: {
standard: 'voyage/voyage-4',
draft: 'text-embedding-3-small',
best: 'voyage/voyage-4-large',
},
// XD 网关真实推理入口运行时由 model-access server 随凭据成对下发
// (见 main/model-access/effectiveEndpoint.ts;端点清单/静态值已退役)。
// gateway-key 路由只换鉴权头、不 override upstream,故此处 upstream 不参与路由,
// 仅为满足类型的占位(不写内部域名);品牌按 provider id 判定,不读此值。
routing: {
'claude-code': {
upstream: 'https://xd-gateway.invalid',
authStrategy: 'gateway-key',
},
codex: {
upstream: 'https://xd-gateway.invalid/v1',
authStrategy: 'gateway-key',
supportsResponsesCustomTools: false,
},
// pi 直连网关 anthropic-messages 面(与 claude-code 同可达面);upstream 同为占位。
pi: {
upstream: 'https://xd-gateway.invalid',
authStrategy: 'gateway-key',
},
},
models: { 'claude-code': [], codex: [], pi: [] },
};
/**
* Google Gemini(API key,媒体-only,2026-07 图像多来源)。
* 没有 Google OAuth(那是后续独立项目),连接方式是用户自己的 Gemini API key
* (Google AI Studio);agents 为空 —— 图像模型不经 agent runtime,由主机图像
* 通道(geminiImageClient)直调,不参与任何聊天路由。模型 id 带 `gemini/` 前缀
* 且**不声明 imageDefaults**:xd 网关的出厂默认地位不动(数据契约测试锁定)。
*/
const GEMINI_PROVIDER: Provider = {
id: 'gemini',
name: 'Google Gemini',
source: 'builtin',
agents: [],
auth: { method: 'apiKey' },
access: { kind: 'api' },
routing: {},
models: {},
};
/** 内置供应商(顺序契约见文件头;gemini 追加在 xd 之后,聊天分段与 first-wins 契约零影响)。 */
export const BUILTIN_PROVIDERS: Provider[] = [
ANTHROPIC_PROVIDER,
OPENAI_PROVIDER,
XAI_PROVIDER,
XD_PROVIDER,
GEMINI_PROVIDER,
].map((provider) => projectProviderMediaModels(provider, bundledModelRegistry, { addDeclared: true }));
/** 打包进 App 的内置目录(离线兜底 / 远端拉取失败时使用)。 */
export const BUNDLED_CATALOG: Catalog = {
version: catalogFile.version,
providers: BUILTIN_PROVIDERS,
modelRegistry: bundledModelRegistry,
presets: appendPiProviderPresets((catalogFile.presets ?? []).map(expandPresetModels)),
};