Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

12.0 KB
Raw Blame
/**
 * 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)),
};