@tokenbuddy/tokenbuddy 1.0.35 → 1.0.37

package/src/provider-install.ts

@@ -1,1006 +0,0 @@
-import * as fs from "fs";
-import * as os from "os";
-import * as path from "path";
-import {
-  BuyerStore,
-  ProviderInstallSnapshot,
-} from "./buyer-store.js";
-import {
-  ProtocolPreference,
-} from "./seller-catalog.js";
-
-export const PROXY_ACCESS_TOKEN_PLACEHOLDER = "TOKENBUDDY_PROXY";
-const DESKTOP_PROFILE_ID = "00000000-0000-4000-8000-000000178210";
-const CLAUDE_ONE_M_MARKER = "[1M]";
-const CLAUDE_CLIENT_HAIKU_MODEL = "claude-haiku-4-5";
-const CLAUDE_CLIENT_SONNET_MODEL = "claude-sonnet-4-6";
-const CLAUDE_CLIENT_OPUS_MODEL = "claude-opus-4-7";
-
-export const SUPPORTED_PROVIDER_IDS = [
-  "codex",
-  "claude-code",
-  "claude-desktop",
-  "openclaw",
-  "opencode",
-  "hermes",
-] as const;
-
-export type ProviderId = typeof SUPPORTED_PROVIDER_IDS[number];
-export type ModelSelectionKind = "single-model" | "claude-role-mapping";
-
-/**
- * provider 探测选项。
- */
-export interface ProviderDetectOptions {
-  /** 用户 home 目录，默认 `os.homedir()`；测试可注入临时目录 */
-  home?: string;
-}
-
-/**
- * 单模型 provider 的 runtime config（适用于 codex / opencode / hermes / openclaw 等）。
- * `defaultModel` 是 buyer 端默认转发到的上游模型 ID。
- */
-export interface SingleModelProviderRuntimeConfig {
-  selectionKind: "single-model";
-  protocolPreference?: ProtocolPreference;
-  defaultModel: string;
-}
-
-/**
- * Claude Code role 绑定：把 buyer 端的 `haiku/sonnet/opus` 角色映射到具体上游模型。
- * `declareOneM` 用于在 UI 上声明 1M context（仅展示用途，不参与计费）。
- */
-export interface ClaudeRoleBinding {
-  /** 实际转发到 seller 的上游模型 ID */
-  upstreamModel: string;
-  /** UI 展示名（可选） */
-  displayName?: string;
-  /** 是否在配置里标注 1M context（Claude Code 1M marker） */
-  declareOneM?: boolean;
-}
-
-/**
- * Claude Code provider 的 model mapping 配置。
- * 三个 role 都可选；缺失时回退到 `fallbackModel`。
- */
-export interface ClaudeCodeModelMappingConfig {
-  selectionKind: "claude-role-mapping";
-  protocolPreference?: ProtocolPreference;
-  fallbackModel?: string;
-  roles: {
-    haiku?: ClaudeRoleBinding;
-    sonnet?: ClaudeRoleBinding;
-    opus?: ClaudeRoleBinding;
-  };
-}
-
-/**
- * 任何 provider 的 runtime config 联合类型。
- * 通过 `selectionKind` 字段做类型守卫。
- */
-export type ProviderRuntimeConfig =
-  | SingleModelProviderRuntimeConfig
-  | ClaudeCodeModelMappingConfig;
-
-/**
- * `tb init` 期间为每个 provider 收集的最终选择（按 provider id 索引）。
- */
-export type ProviderSelections = Partial<Record<ProviderId, ProviderRuntimeConfig>>;
-
-/**
- * `applyProviderInstall` / `previewProviderInstall` 的输入。
- * 必填 `providers`（要安装的 provider ID 列表）和 `proxyUrl`（buyer 代理 URL）。
- */
-export interface ProviderInstallOptions extends ProviderDetectOptions {
-  providers: string[];
-  proxyUrl: string;
-  model?: string;
-  providerSelections?: ProviderSelections;
-}
-
-/**
- * `rollbackProviderInstall` 的输入。
- */
-export interface ProviderRollbackOptions extends ProviderDetectOptions {
-  providers: string[];
-}
-
-/**
- * provider 探测结果（供 `tb doctor` / install 流程使用）。
- */
-export interface ProviderCandidate {
-  id: ProviderId;
-  name: string;
-  detected: boolean;
-  configured: boolean;
-  status: "configured" | "installed" | "missing";
-  configPath: string;
-  commandName?: string;
-  executablePath?: string;
-  observedPaths?: string[];
-  reason: string;
-}
-
-/**
- * provider 安装时产生的单文件变更（preview 阶段用）。
- */
-export interface ProviderFileChange {
-  providerId: ProviderId;
-  path: string;
-  action: "create" | "update";
-  existed: boolean;
-  summary: string;
-  content: string;
-}
-
-/**
- * `applyProviderInstall` 的结果（每文件一行）。
- */
-export interface ProviderApplyResult {
-  providerId: ProviderId;
-  path: string;
-  action: "created" | "updated";
-}
-
-/**
- * `rollbackProviderInstall` 的结果（每文件一行）。
- */
-export interface ProviderRollbackResult {
-  providerId: ProviderId;
-  path: string;
-  action: "restored" | "removed" | "missing_snapshot";
-}
-
-interface ProviderDefinition {
-  id: ProviderId;
-  name: string;
-  configPath(home: string): string;
-  commandName?: string;
-  observedPaths?(home: string): string[];
-  isConfigured?(filePath: string, home: string): boolean;
-  changes(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[];
-  modelSelectionKind: ModelSelectionKind;
-  protocolPreference?: ProtocolPreference;
-}
-
-function isPlainRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-function resolveHome(home?: string): string {
-  return home && home.trim() ? home : os.homedir();
-}
-
-function isProviderId(value: string): value is ProviderId {
-  return (SUPPORTED_PROVIDER_IDS as readonly string[]).includes(value);
-}
-
-function assertProviderIds(providers: string[]): ProviderId[] {
-  if (!Array.isArray(providers) || providers.length === 0) {
-    throw new Error("providers must include at least one provider id");
-  }
-  const out: ProviderId[] = [];
-  for (const provider of providers) {
-    if (!isProviderId(provider)) {
-      throw new Error(`unsupported provider: ${provider}`);
-    }
-    if (!out.includes(provider)) {
-      out.push(provider);
-    }
-  }
-  return out;
-}
-
-function readText(filePath: string): string | undefined {
-  if (!fs.existsSync(filePath)) {
-    return undefined;
-  }
-  return fs.readFileSync(filePath, "utf8");
-}
-
-function readJsonObject(filePath: string): Record<string, unknown> {
-  const text = readText(filePath);
-  if (!text) {
-    return {};
-  }
-  try {
-    const parsed = JSON.parse(text) as unknown;
-    return parsed && typeof parsed === "object" && !Array.isArray(parsed)
-      ? (parsed as Record<string, unknown>)
-      : {};
-  } catch {
-    return {};
-  }
-}
-
-function parseYamlScalar(value: string): unknown {
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return "";
-  }
-  if (trimmed === "true") {
-    return true;
-  }
-  if (trimmed === "false") {
-    return false;
-  }
-  if (trimmed === "null") {
-    return null;
-  }
-  if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
-    return trimmed.slice(1, -1);
-  }
-  const numeric = Number(trimmed);
-  if (Number.isFinite(numeric) && /^-?\d+(?:\.\d+)?$/.test(trimmed)) {
-    return numeric;
-  }
-  return trimmed;
-}
-
-function parseSimpleYamlObject(text: string): Record<string, unknown> {
-  const root: Record<string, unknown> = {};
-  const stack: Array<{ indent: number; value: Record<string, unknown> }> = [{ indent: -1, value: root }];
-  for (const rawLine of text.split(/\r?\n/)) {
-    if (!rawLine.trim() || rawLine.trimStart().startsWith("#")) {
-      continue;
-    }
-    const indent = rawLine.match(/^ */)?.[0].length ?? 0;
-    const trimmed = rawLine.trim();
-    const separatorIndex = trimmed.indexOf(":");
-    if (separatorIndex <= 0) {
-      continue;
-    }
-    const key = trimmed.slice(0, separatorIndex).trim();
-    const rest = trimmed.slice(separatorIndex + 1).trim();
-    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
-      stack.pop();
-    }
-    const parent = stack[stack.length - 1].value;
-    if (!rest) {
-      const child = isPlainRecord(parent[key]) ? parent[key] as Record<string, unknown> : {};
-      parent[key] = child;
-      stack.push({ indent, value: child });
-    } else {
-      parent[key] = parseYamlScalar(rest);
-    }
-  }
-  return root;
-}
-
-function readYamlObject(filePath: string): Record<string, unknown> {
-  const text = readText(filePath);
-  if (!text) {
-    return {};
-  }
-  return parseSimpleYamlObject(text);
-}
-
-function yamlScalarContent(value: unknown): string {
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value);
-  }
-  if (value === null) {
-    return "null";
-  }
-  const text = String(value ?? "");
-  if (!text || /[:#\n\r\t]|^\s|\s$|^(true|false|null)$/i.test(text) || /^-?\d+(?:\.\d+)?$/.test(text)) {
-    return JSON.stringify(text);
-  }
-  return text;
-}
-
-function yamlContent(value: Record<string, unknown>): string {
-  const lines: string[] = [];
-  const writeObject = (objectValue: Record<string, unknown>, indent: number): void => {
-    for (const [key, entry] of Object.entries(objectValue)) {
-      const prefix = " ".repeat(indent);
-      if (isPlainRecord(entry)) {
-        lines.push(`${prefix}${key}:`);
-        writeObject(entry, indent + 2);
-      } else {
-        lines.push(`${prefix}${key}: ${yamlScalarContent(entry)}`);
-      }
-    }
-  };
-  writeObject(value, 0);
-  return `${lines.join("\n")}\n`;
-}
-
-function replaceTopLevelYamlSection(existing: string, sectionName: string, sectionBody: string): string {
-  const lines = existing.split(/\r?\n/);
-  const sectionStart = lines.findIndex((line) => {
-    return line === `${sectionName}:` || line.startsWith(`${sectionName}: `);
-  });
-  const bodyLines = [`${sectionName}:`, ...sectionBody.trimEnd().split(/\r?\n/).map((line) => `  ${line}`)];
-  if (sectionStart < 0) {
-    const prefix = existing.trimEnd();
-    return `${prefix}${prefix ? "\n" : ""}${bodyLines.join("\n")}\n`;
-  }
-  let sectionEnd = sectionStart + 1;
-  while (sectionEnd < lines.length) {
-    const line = lines[sectionEnd];
-    if (line.trim() && !line.startsWith(" ") && !line.startsWith("\t")) {
-      break;
-    }
-    sectionEnd += 1;
-  }
-  return `${[
-    ...lines.slice(0, sectionStart),
-    ...bodyLines,
-    ...lines.slice(sectionEnd),
-  ].join("\n").replace(/\n*$/, "")}\n`;
-}
-
-function readObjectField(value: unknown, key: string): Record<string, unknown> | undefined {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return undefined;
-  }
-  const field = (value as Record<string, unknown>)[key];
-  return field && typeof field === "object" && !Array.isArray(field)
-    ? field as Record<string, unknown>
-    : undefined;
-}
-
-function jsonContent(value: unknown): string {
-  return `${JSON.stringify(value, null, 2)}\n`;
-}
-
-function displayPath(home: string, filePath: string): string {
-  return filePath.startsWith(home) ? `~${filePath.slice(home.length)}` : filePath;
-}
-
-function resolveExecutable(commandName: string): string | undefined {
-  const pathValue = process.env.PATH || "";
-  const pathEntries = pathValue.split(path.delimiter).filter(Boolean);
-  const windowsExts = process.platform === "win32"
-    ? (process.env.PATHEXT || ".EXE;.CMD;.BAT;.COM")
-      .split(";")
-      .filter(Boolean)
-    : [""];
-
-  for (const entry of pathEntries) {
-    for (const ext of windowsExts) {
-      const candidate = path.join(entry, process.platform === "win32" ? `${commandName}${ext}` : commandName);
-      try {
-        fs.accessSync(candidate, fs.constants.X_OK);
-        return candidate;
-      } catch {
-        continue;
-      }
-    }
-  }
-  return undefined;
-}
-
-function escapeTomlString(value: string): string {
-  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-}
-
-function replaceTomlSection(existing: string, sectionName: string, sectionBody: string): string {
-  const sectionPattern = new RegExp(`^\\[${sectionName}\\]\\n[\\s\\S]*?(?=^\\[|\\s*$)`, "m");
-  const normalized = existing.trimEnd();
-  const nextSection = `[${sectionName}]\n${sectionBody.trimEnd()}\n`;
-  if (sectionPattern.test(normalized)) {
-    return `${normalized.replace(sectionPattern, nextSection).trimEnd()}\n`;
-  }
-  return `${normalized}${normalized ? "\n\n" : ""}${nextSection}`;
-}
-
-function stripClaudeOneMMarker(model: string): string {
-  const trimmed = model.trimEnd();
-  if (!trimmed.toLowerCase().endsWith(CLAUDE_ONE_M_MARKER.toLowerCase())) {
-    return model;
-  }
-  return trimmed.slice(0, -CLAUDE_ONE_M_MARKER.length).trimEnd();
-}
-
-function setClaudeOneMMarker(model: string, enabled: boolean): string {
-  const base = stripClaudeOneMMarker(model).trim();
-  if (!base) {
-    return "";
-  }
-  return enabled ? `${base}${CLAUDE_ONE_M_MARKER}` : base;
-}
-
-function makeChange(providerId: ProviderId, filePath: string, summary: string, content: string): ProviderFileChange {
-  const existed = fs.existsSync(filePath);
-  return {
-    providerId,
-    path: filePath,
-    action: existed ? "update" : "create",
-    existed,
-    summary,
-    content,
-  };
-}
-
-function makeSingleModelRuntimeConfig(
-  provider: ProviderDefinition,
-  model: string,
-): SingleModelProviderRuntimeConfig {
-  return {
-    selectionKind: "single-model",
-    protocolPreference: provider.protocolPreference,
-    defaultModel: model,
-  };
-}
-
-function pickConfiguredModel(config: ProviderRuntimeConfig): string {
-  if (config.selectionKind === "single-model") {
-    return config.defaultModel;
-  }
-  const sonnetModel = config.roles.sonnet?.upstreamModel;
-  const opusModel = config.roles.opus?.upstreamModel;
-  const haikuModel = config.roles.haiku?.upstreamModel;
-  return sonnetModel || opusModel || haikuModel || config.fallbackModel || "";
-}
-
-function resolveProviderRuntimeConfig(
-  provider: ProviderDefinition,
-  options: ProviderInstallOptions,
-): ProviderRuntimeConfig {
-  const selection = options.providerSelections?.[provider.id];
-  if (selection) {
-    return selection;
-  }
-  const model = options.model?.trim();
-  if (!model) {
-    throw new Error(`model is required for provider ${provider.id}`);
-  }
-  return makeSingleModelRuntimeConfig(provider, model);
-}
-
-function codexConfig(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[] {
-  const model = pickConfiguredModel(config);
-  const configPath = path.join(home, ".codex", "config.toml");
-  const existing = readText(configPath) || "";
-  const content = replaceTomlSection(
-    existing,
-    "tokenbuddy",
-    [
-      `proxy_url = "${escapeTomlString(proxyUrl)}"`,
-      `api_key = "${PROXY_ACCESS_TOKEN_PLACEHOLDER}"`,
-      `model = "${escapeTomlString(model)}"`,
-    ].join("\n"),
-  );
-  return [makeChange("codex", configPath, "configure TokenBuddy proxy for Codex", content)];
-}
-
-function resolveClaudeFallbackAlias(config: ClaudeCodeModelMappingConfig): string {
-  if (config.roles.sonnet?.upstreamModel) {
-    return setClaudeOneMMarker(
-      CLAUDE_CLIENT_SONNET_MODEL,
-      Boolean(config.roles.sonnet.declareOneM),
-    );
-  }
-  if (config.roles.opus?.upstreamModel) {
-    return setClaudeOneMMarker(
-      CLAUDE_CLIENT_OPUS_MODEL,
-      Boolean(config.roles.opus.declareOneM),
-    );
-  }
-  if (config.roles.haiku?.upstreamModel) {
-    return CLAUDE_CLIENT_HAIKU_MODEL;
-  }
-  return CLAUDE_CLIENT_SONNET_MODEL;
-}
-
-function buildClaudeRoleEnv(config: ClaudeCodeModelMappingConfig): Record<string, string> {
-  const env: Record<string, string> = {};
-  const roleConfigs: Array<{
-    binding?: ClaudeRoleBinding;
-    modelKey: string;
-    displayNameKey: string;
-    alias: string;
-    allowOneM: boolean;
-  }> = [
-    {
-      binding: config.roles.haiku,
-      modelKey: "ANTHROPIC_DEFAULT_HAIKU_MODEL",
-      displayNameKey: "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME",
-      alias: CLAUDE_CLIENT_HAIKU_MODEL,
-      allowOneM: false,
-    },
-    {
-      binding: config.roles.sonnet,
-      modelKey: "ANTHROPIC_DEFAULT_SONNET_MODEL",
-      displayNameKey: "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME",
-      alias: CLAUDE_CLIENT_SONNET_MODEL,
-      allowOneM: true,
-    },
-    {
-      binding: config.roles.opus,
-      modelKey: "ANTHROPIC_DEFAULT_OPUS_MODEL",
-      displayNameKey: "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME",
-      alias: CLAUDE_CLIENT_OPUS_MODEL,
-      allowOneM: true,
-    },
-  ];
-
-  for (const role of roleConfigs) {
-    if (!role.binding?.upstreamModel?.trim()) {
-      continue;
-    }
-    env[role.modelKey] = role.allowOneM
-      ? setClaudeOneMMarker(role.alias, Boolean(role.binding.declareOneM))
-      : role.alias;
-    const displayName = role.binding.displayName?.trim() || stripClaudeOneMMarker(role.binding.upstreamModel).trim();
-    if (displayName) {
-      env[role.displayNameKey] = displayName;
-    }
-  }
-
-  env.ANTHROPIC_MODEL = resolveClaudeFallbackAlias(config);
-  return env;
-}
-
-function claudeCodeConfig(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[] {
-  const configPath = path.join(home, ".claude", "settings.json");
-  const current = readJsonObject(configPath);
-  const env = current.env && typeof current.env === "object" && !Array.isArray(current.env)
-    ? (current.env as Record<string, unknown>)
-    : {};
-
-  const nextEnv: Record<string, unknown> = {
-    ...env,
-    ANTHROPIC_BASE_URL: proxyUrl,
-    ANTHROPIC_AUTH_TOKEN: PROXY_ACCESS_TOKEN_PLACEHOLDER,
-  };
-
-  delete nextEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL;
-  delete nextEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME;
-  delete nextEnv.ANTHROPIC_DEFAULT_SONNET_MODEL;
-  delete nextEnv.ANTHROPIC_DEFAULT_SONNET_MODEL_NAME;
-  delete nextEnv.ANTHROPIC_DEFAULT_OPUS_MODEL;
-  delete nextEnv.ANTHROPIC_DEFAULT_OPUS_MODEL_NAME;
-  delete nextEnv.ANTHROPIC_MODEL;
-
-  if (config.selectionKind === "claude-role-mapping") {
-    Object.assign(nextEnv, buildClaudeRoleEnv(config));
-  } else {
-    nextEnv.ANTHROPIC_MODEL = config.defaultModel;
-    nextEnv.ANTHROPIC_DEFAULT_SONNET_MODEL = config.defaultModel;
-  }
-
-  current.env = nextEnv;
-  return [
-    makeChange(
-      "claude-code",
-      configPath,
-      "configure Anthropic proxy env for Claude Code",
-      jsonContent(current),
-    ),
-  ];
-}
-
-function claudeDesktopConfig(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[] {
-  const model = pickConfiguredModel(config);
-  const configDir = path.join(home, "Library", "Application Support", "Claude");
-  const configPath = path.join(configDir, "claude_desktop_config.json");
-  const threepDir = path.join(home, "Library", "Application Support", "Claude-3p");
-  const threepConfigPath = path.join(threepDir, "claude_desktop_config.json");
-  const libraryPath = path.join(threepDir, "configLibrary");
-  const profilePath = path.join(libraryPath, `${DESKTOP_PROFILE_ID}.json`);
-  const metaPath = path.join(libraryPath, "_meta.json");
-
-  const primary = readJsonObject(configPath);
-  primary.deploymentMode = "3p";
-  const threep = readJsonObject(threepConfigPath);
-  threep.deploymentMode = "3p";
-
-  const profile = {
-    disableDeploymentModeChooser: true,
-    inferenceGatewayApiKey: PROXY_ACCESS_TOKEN_PLACEHOLDER,
-    inferenceGatewayAuthScheme: "bearer",
-    inferenceGatewayBaseUrl: proxyUrl,
-    inferenceProvider: "gateway",
-    inferenceModels: [{ name: model }],
-  };
-
-  const meta = readJsonObject(metaPath);
-  const existingEntries = Array.isArray(meta.entries) ? meta.entries : [];
-  meta.appliedId = DESKTOP_PROFILE_ID;
-  meta.entries = [
-    ...existingEntries.filter((entry) => !(entry && typeof entry === "object" && "id" in entry && entry.id === DESKTOP_PROFILE_ID)),
-    { id: DESKTOP_PROFILE_ID, name: "TokenBuddy" },
-  ];
-
-  return [
-    makeChange("claude-desktop", configPath, "enable Claude Desktop 3p deployment mode", jsonContent(primary)),
-    makeChange("claude-desktop", threepConfigPath, "enable Claude Desktop 3p config", jsonContent(threep)),
-    makeChange("claude-desktop", profilePath, "write TokenBuddy Claude Desktop profile", jsonContent(profile)),
-    makeChange("claude-desktop", metaPath, "select TokenBuddy Claude Desktop profile", jsonContent(meta)),
-  ];
-}
-
-function openclawConfig(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[] {
-  const model = pickConfiguredModel(config);
-  const configPath = path.join(home, ".openclaw", "openclaw.json");
-  const current = readJsonObject(configPath);
-  const models = isPlainRecord(current.models) ? current.models : {};
-  const providers = isPlainRecord(models.providers) ? models.providers : {};
-  const existingProvider = isPlainRecord(providers.tokenbuddy) ? providers.tokenbuddy : {};
-  const existingModels = Array.isArray(existingProvider.models) ? existingProvider.models : [];
-  const nextModels = [
-    ...existingModels.filter((entry) => {
-      return !(isPlainRecord(entry) && entry.id === model);
-    }),
-    {
-      id: model,
-      name: model,
-      api: "openai-completions",
-      input: ["text", "image"],
-    },
-  ];
-  providers.tokenbuddy = {
-    ...existingProvider,
-    baseUrl: openAiBaseUrl(proxyUrl),
-    apiKey: PROXY_ACCESS_TOKEN_PLACEHOLDER,
-    auth: "api-key",
-    api: "openai-completions",
-    models: nextModels,
-  };
-  models.providers = providers;
-  current.models = models;
-  const agents = isPlainRecord(current.agents) ? current.agents : {};
-  const defaults = isPlainRecord(agents.defaults) ? agents.defaults : {};
-  defaults.model = `tokenbuddy/${model}`;
-  agents.defaults = defaults;
-  current.agents = agents;
-  return [makeChange("openclaw", configPath, "configure OpenClaw proxy settings", jsonContent(current))];
-}
-
-function isOpenclawTokenBuddyConfigured(filePath: string): boolean {
-  const current = readJsonObject(filePath);
-  const tokenbuddy = readObjectField(readObjectField(readObjectField(current, "models"), "providers"), "tokenbuddy");
-  const defaults = readObjectField(readObjectField(current, "agents"), "defaults");
-  if (!tokenbuddy || !defaults) {
-    return false;
-  }
-  const defaultModel = defaults.model;
-  return tokenbuddy.apiKey === PROXY_ACCESS_TOKEN_PLACEHOLDER &&
-    typeof tokenbuddy.baseUrl === "string" &&
-    tokenbuddy.baseUrl.includes("127.0.0.1") &&
-    tokenbuddy.baseUrl.endsWith("/v1") &&
-    typeof defaultModel === "string" &&
-    defaultModel.startsWith("tokenbuddy/");
-}
-
-function openAiBaseUrl(proxyUrl: string): string {
-  const normalized = proxyUrl.replace(/\/+$/, "");
-  return normalized.endsWith("/v1") ? normalized : `${normalized}/v1`;
-}
-
-function opencodeConfig(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[] {
-  const model = pickConfiguredModel(config);
-  const configPath = path.join(home, ".config", "opencode", "opencode.json");
-  const current = readJsonObject(configPath);
-  const providers = current.provider && typeof current.provider === "object" && !Array.isArray(current.provider)
-    ? (current.provider as Record<string, unknown>)
-    : {};
-  providers.tokenbuddy = {
-    name: "TokenBuddy",
-    npm: "@ai-sdk/openai-compatible",
-    options: {
-      apiKey: PROXY_ACCESS_TOKEN_PLACEHOLDER,
-      baseURL: openAiBaseUrl(proxyUrl),
-    },
-    models: {
-      [model]: {
-        name: model,
-        attachment: true,
-        tool_call: true,
-      },
-    },
-  };
-  current.provider = providers;
-  // 写顶层 model / small_model，让 opencode 默认走 tokenbuddy 而不是残留的 openai/qwen-plus 死链
-  current.model = `tokenbuddy/${model}`;
-  current.small_model = `tokenbuddy/${model}`;
-  return [makeChange("opencode", configPath, "configure OpenCode provider for TokenBuddy proxy", jsonContent(current))];
-}
-
-function isOpencodeTokenBuddyConfigured(filePath: string): boolean {
-  const current = readJsonObject(filePath);
-  const tokenbuddy = readObjectField(readObjectField(current, "provider"), "tokenbuddy");
-  const options = readObjectField(tokenbuddy, "options");
-  if (!tokenbuddy || !options) {
-    return false;
-  }
-
-  return tokenbuddy.npm === "@ai-sdk/openai-compatible" &&
-    options.apiKey === PROXY_ACCESS_TOKEN_PLACEHOLDER &&
-    typeof options.baseURL === "string" &&
-    options.baseURL.includes("127.0.0.1") &&
-    options.baseURL.endsWith("/v1") &&
-    typeof current.model === "string" &&
-    current.model.startsWith("tokenbuddy/") &&
-    typeof current.small_model === "string" &&
-    current.small_model.startsWith("tokenbuddy/");
-}
-
-function hermesConfig(home: string, proxyUrl: string, config: ProviderRuntimeConfig): ProviderFileChange[] {
-  const model = pickConfiguredModel(config);
-  const configPath = path.join(home, ".hermes", "config.yaml");
-  const existing = readText(configPath) || "";
-  const current = parseSimpleYamlObject(existing);
-  const modelConfig = isPlainRecord(current.model) ? current.model : {};
-  const nextModelConfig = {
-    ...modelConfig,
-    default: model,
-    provider: "custom",
-    base_url: openAiBaseUrl(proxyUrl),
-    api_key: PROXY_ACCESS_TOKEN_PLACEHOLDER,
-    api_mode: "chat_completions",
-  };
-  const content = replaceTopLevelYamlSection(existing, "model", yamlContent(nextModelConfig));
-  return [makeChange("hermes", configPath, "configure Hermes OpenAI proxy settings", content)];
-}
-
-function isHermesTokenBuddyConfigured(filePath: string): boolean {
-  const current = readYamlObject(filePath);
-  const modelConfig = readObjectField(current, "model");
-  if (!modelConfig) {
-    return false;
-  }
-  return modelConfig.provider === "custom" &&
-    modelConfig.api_key === PROXY_ACCESS_TOKEN_PLACEHOLDER &&
-    modelConfig.api_mode === "chat_completions" &&
-    typeof modelConfig.base_url === "string" &&
-    modelConfig.base_url.includes("127.0.0.1") &&
-    modelConfig.base_url.endsWith("/v1") &&
-    typeof modelConfig.default === "string" &&
-    modelConfig.default.length > 0;
-}
-
-const PROVIDERS: ProviderDefinition[] = [
-  {
-    id: "codex",
-    name: "Codex CLI",
-    commandName: "codex",
-    configPath: (home) => path.join(home, ".codex", "config.toml"),
-    changes: codexConfig,
-    modelSelectionKind: "single-model",
-    protocolPreference: "responses",
-  },
-  {
-    id: "claude-code",
-    name: "Claude Code CLI",
-    commandName: "claude",
-    configPath: (home) => path.join(home, ".claude", "settings.json"),
-    changes: claudeCodeConfig,
-    modelSelectionKind: "claude-role-mapping",
-    protocolPreference: "messages",
-  },
-  {
-    id: "claude-desktop",
-    name: "Claude Desktop App",
-    configPath: (home) => path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
-    changes: claudeDesktopConfig,
-    modelSelectionKind: "single-model",
-    protocolPreference: "messages",
-  },
-  {
-    id: "openclaw",
-    name: "OpenClaw Agent",
-    commandName: "openclaw",
-    configPath: (home) => path.join(home, ".openclaw", "openclaw.json"),
-    isConfigured: isOpenclawTokenBuddyConfigured,
-    observedPaths: (home) => [
-      path.join(home, ".openclaw", "configs"),
-      path.join(home, ".openclaw", "config.json"),
-    ],
-    changes: openclawConfig,
-    modelSelectionKind: "single-model",
-    protocolPreference: "chat_completions",
-  },
-  {
-    id: "opencode",
-    name: "OpenCode",
-    commandName: "opencode",
-    configPath: (home) => path.join(home, ".config", "opencode", "opencode.json"),
-    isConfigured: isOpencodeTokenBuddyConfigured,
-    changes: opencodeConfig,
-    modelSelectionKind: "single-model",
-    protocolPreference: "chat_completions",
-  },
-  {
-    id: "hermes",
-    name: "Hermes Terminal",
-    commandName: "hermes",
-    configPath: (home) => path.join(home, ".hermes", "config.yaml"),
-    isConfigured: isHermesTokenBuddyConfigured,
-    observedPaths: (home) => [
-      path.join(home, ".hermes", "settings.json"),
-      path.join(home, ".hermes", "auth.json"),
-    ],
-    changes: hermesConfig,
-    modelSelectionKind: "single-model",
-    protocolPreference: "chat_completions",
-  },
-];
-
-function getProviderDefinition(providerId: ProviderId): ProviderDefinition {
-  const provider = PROVIDERS.find((entry) => entry.id === providerId);
-  if (!provider) {
-    throw new Error(`unsupported provider: ${providerId}`);
-  }
-  return provider;
-}
-
-/**
- * 探测所有 SUPPORTED_PROVIDER_IDS：检查可执行文件、配置文件、原生 hints 目录。
- * 状态机：`configured`（已存在配置且被识别） / `installed`（可执行/配置存在但未配置） / `missing`（都未找到）。
- *
- * @param options 探测选项
- * @returns 探测结果列表
- */
-export function detectProviders(options: ProviderDetectOptions = {}): ProviderCandidate[] {
-  const home = resolveHome(options.home);
-  return PROVIDERS.map((provider) => {
-    const configPath = provider.configPath(home);
-    const configExists = fs.existsSync(configPath);
-    const configured = configExists && (provider.isConfigured?.(configPath, home) ?? true);
-    const executablePath = provider.commandName ? resolveExecutable(provider.commandName) : undefined;
-    const observedPaths = provider.observedPaths?.(home).filter((entry) => fs.existsSync(entry)) || [];
-    const installed = Boolean(executablePath) || observedPaths.length > 0 || configExists;
-    const status: ProviderCandidate["status"] = configured
-      ? "configured"
-      : installed
-        ? "installed"
-        : "missing";
-    const reasonParts: string[] = [];
-    if (configured) {
-      reasonParts.push(`Configured at ${displayPath(home, configPath)}`);
-    } else if (installed) {
-      reasonParts.push(`Installed, TokenBuddy config missing at ${displayPath(home, configPath)}`);
-    } else {
-      reasonParts.push(`Missing ${displayPath(home, configPath)}`);
-    }
-    if (executablePath) {
-      reasonParts.push(`CLI ${displayPath(home, executablePath)}`);
-    }
-    if (observedPaths.length > 0) {
-      reasonParts.push(`Native files ${observedPaths.map((entry) => displayPath(home, entry)).join(", ")}`);
-    }
-    return {
-      id: provider.id,
-      name: provider.name,
-      detected: status !== "missing",
-      configured,
-      status,
-      configPath,
-      commandName: provider.commandName,
-      executablePath,
-      observedPaths,
-      reason: reasonParts.join(" · "),
-    };
-  });
-}
-
-/**
- * 返回 provider 默认的协议偏好（未声明则返回 `undefined`，由运行时探测）。
- *
- * @param providerId provider ID
- * @returns 协议偏好
- */
-export function getProviderProtocolPreference(providerId: ProviderId): ProtocolPreference | undefined {
-  return getProviderDefinition(providerId).protocolPreference;
-}
-
-/**
- * 返回 provider 的 model selection kind（决定 init 走 single-model 还是 claude-role-mapping 流程）。
- *
- * @param providerId provider ID
- * @returns selection kind
- */
-export function getProviderModelSelectionKind(providerId: ProviderId): ModelSelectionKind {
-  return getProviderDefinition(providerId).modelSelectionKind;
-}
-
-/**
- * 预览 provider 安装会产生的文件变更（不实际写盘）。
- * 给 `tb init` 在用户确认前展示"将要改哪些文件 / 改什么内容"。
- *
- * @param options 安装选项
- * @returns 计划中的文件变更列表
- */
-export function previewProviderInstall(options: ProviderInstallOptions): ProviderFileChange[] {
-  const home = resolveHome(options.home);
-  const providerIds = assertProviderIds(options.providers);
-  if (!options.proxyUrl || !options.proxyUrl.trim()) {
-    throw new Error("proxyUrl is required");
-  }
-  return providerIds.flatMap((providerId) => {
-    const provider = getProviderDefinition(providerId);
-    const runtimeConfig = resolveProviderRuntimeConfig(provider, options);
-    return provider.changes(home, options.proxyUrl, runtimeConfig);
-  });
-}
-
-/**
- * 实际写盘 provider 配置。
- * 同时把每个 provider 的原始文件快照写入 `store`（用于 `tb rollback`）。
- *
- * @param options 安装选项
- * @param store buyer store（用于快照 + runtime config 持久化）
- * @returns 实际写盘结果列表
- */
-export function applyProviderInstall(options: ProviderInstallOptions, store: BuyerStore): ProviderApplyResult[] {
-  const providerIds = assertProviderIds(options.providers);
-  const changes = previewProviderInstall(options);
-  const byProvider = new Map<ProviderId, ProviderFileChange[]>();
-  for (const change of changes) {
-    byProvider.set(change.providerId, [...(byProvider.get(change.providerId) || []), change]);
-  }
-
-  for (const [providerId, providerChanges] of byProvider) {
-    const snapshot: ProviderInstallSnapshot = {
-      providerId,
-      files: providerChanges.map((change) => ({
-        path: change.path,
-        existed: fs.existsSync(change.path),
-        content: readText(change.path),
-      })),
-    };
-    store.saveProviderInstallSnapshot(snapshot);
-  }
-
-  for (const providerId of providerIds) {
-    const provider = getProviderDefinition(providerId);
-    const runtimeConfig = resolveProviderRuntimeConfig(provider, options);
-    store.saveProviderRuntimeConfig(providerId, runtimeConfig);
-  }
-
-  const applied: ProviderApplyResult[] = [];
-  for (const change of changes) {
-    const dir = path.dirname(change.path);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(change.path, change.content, "utf8");
-    applied.push({
-      providerId: change.providerId,
-      path: change.path,
-      action: change.existed ? "updated" : "created",
-    });
-  }
-  return applied;
-}
-
-/**
- * 回滚 provider 安装。
- * 从 `store` 读取安装前的快照，恢复原文件（如果快照里有原始内容）。
- * 没有快照的 provider 标记为 `missing_snapshot`。
- *
- * @param options 回滚选项
- * @param store buyer store
- * @returns 回滚结果列表
- */
-export function rollbackProviderInstall(options: ProviderRollbackOptions, store: BuyerStore): ProviderRollbackResult[] {
-  const providerIds = assertProviderIds(options.providers);
-  const results: ProviderRollbackResult[] = [];
-  for (const providerId of providerIds) {
-    const snapshot = store.getProviderInstallSnapshot(providerId);
-    if (!snapshot) {
-      results.push({ providerId, path: "", action: "missing_snapshot" });
-      continue;
-    }
-    for (const file of snapshot.files) {
-      if (file.existed) {
-        const dir = path.dirname(file.path);
-        if (!fs.existsSync(dir)) {
-          fs.mkdirSync(dir, { recursive: true });
-        }
-        fs.writeFileSync(file.path, file.content || "", "utf8");
-        results.push({ providerId, path: file.path, action: "restored" });
-      } else {
-        fs.rmSync(file.path, { force: true });
-        results.push({ providerId, path: file.path, action: "removed" });
-      }
-    }
-    store.removeProviderInstallSnapshot(providerId);
-    store.removeProviderRuntimeConfig(providerId);
-  }
-  return results;
-}