cctra 0.3.0

package/src/convert/streaming/outbound/format-responses.ts

@@ -0,0 +1,184 @@
+// ============================================================================
+// CanonicalChunk → OpenAI Responses SSE 流式输出格式化
+// ---------------------------------------------------------------------------
+// 关键状态：
+//   - 每个 Canonical block 对应一个 Responses output_index（直接复用 index）
+//   - 关 stop 时按 block kind 分发：
+//       text     → response.output_item.done
+//       tool_use → response.function_call_arguments.done + response.output_item.done
+//       thinking → response.reasoning_summary_part.done + response.output_item.done
+//   - signature_delta 丢（Responses 无对应）
+// ============================================================================
+
+import type { CanonicalChunk } from "../../../canonical/types";
+
+type BlockKind = "text" | "tool_use" | "thinking";
+
+interface BlockMeta {
+  kind: BlockKind;
+  id?: string;
+  name?: string;
+}
+
+export class ResponsesStreamFormatter {
+  private id = `resp_${Date.now()}`;
+  private model = "";
+  private blocks = new Map<number, BlockMeta>();
+  // 流中错已发 error event：抑制 response.completed + [DONE]（避免"错 + 完成"矛盾信号）
+  private _streamEndedWithError = false;
+
+  format(chunk: CanonicalChunk): string[] {
+    switch (chunk.type) {
+      case "message_start": {
+        if (chunk.message.id) this.id = chunk.message.id;
+        if (chunk.message.model) this.model = chunk.message.model;
+        return [event({
+          type: "response.created",
+          response: {
+            id: this.id,
+            object: "response",
+            model: this.model,
+            status: "in_progress",
+            output: [],
+          },
+        })];
+      }
+
+      case "content_block_start": {
+        const block = chunk.content_block;
+        if (block.type === "text") {
+          this.blocks.set(chunk.index, { kind: "text" });
+          return [event({
+            type: "response.output_item.added",
+            output_index: chunk.index,
+            item: {
+              type: "message",
+              id: `msg_${chunk.index}`,
+              status: "in_progress",
+              role: "assistant",
+              content: [],
+            },
+          })];
+        }
+        if (block.type === "tool_use") {
+          this.blocks.set(chunk.index, { kind: "tool_use", id: block.id, name: block.name });
+          return [event({
+            type: "response.output_item.added",
+            output_index: chunk.index,
+            item: {
+              type: "function_call",
+              id: `fc_${chunk.index}`,
+              status: "in_progress",
+              call_id: block.id,
+              name: block.name,
+              arguments: "",
+            },
+          })];
+        }
+        if (block.type === "thinking") {
+          this.blocks.set(chunk.index, { kind: "thinking" });
+          return [
+            event({
+              type: "response.output_item.added",
+              output_index: chunk.index,
+              item: { type: "reasoning", id: `rs_${chunk.index}`, summary: [] },
+            }),
+            event({
+              type: "response.reasoning_summary_part.added",
+              output_index: chunk.index,
+              summary_index: 0,
+              part: { type: "summary_text", text: "" },
+            }),
+          ];
+        }
+        // image / document / tool_result / refusal: 流式上下文很少出现，跳
+        return [];
+      }
+
+      case "content_block_delta": {
+        if (chunk.delta.type === "text_delta") {
+          return [event({
+            type: "response.output_text.delta",
+            output_index: chunk.index,
+            delta: chunk.delta.text,
+          })];
+        }
+        if (chunk.delta.type === "input_json_delta") {
+          return [event({
+            type: "response.function_call_arguments.delta",
+            output_index: chunk.index,
+            delta: chunk.delta.partial_json,
+          })];
+        }
+        if (chunk.delta.type === "thinking_delta") {
+          return [event({
+            type: "response.reasoning_summary_text.delta",
+            output_index: chunk.index,
+            summary_index: 0,
+            delta: chunk.delta.thinking,
+          })];
+        }
+        // signature_delta → Responses 无对应，丢
+        return [];
+      }
+
+      case "content_block_stop": {
+        const meta = this.blocks.get(chunk.index);
+        this.blocks.delete(chunk.index);
+        if (!meta) {
+          return [event({ type: "response.output_item.done", output_index: chunk.index })];
+        }
+        if (meta.kind === "tool_use") {
+          return [
+            event({
+              type: "response.function_call_arguments.done",
+              output_index: chunk.index,
+            }),
+            event({ type: "response.output_item.done", output_index: chunk.index }),
+          ];
+        }
+        if (meta.kind === "thinking") {
+          return [
+            event({
+              type: "response.reasoning_summary_part.done",
+              output_index: chunk.index,
+              summary_index: 0,
+            }),
+            event({ type: "response.output_item.done", output_index: chunk.index }),
+          ];
+        }
+        // text
+        return [event({ type: "response.output_item.done", output_index: chunk.index })];
+      }
+
+      case "message_delta":
+        // Responses 在 completed 一次性发 usage，中间不需要
+        return [];
+
+      case "message_stop": {
+        // 流中错时抑制 response.completed + [DONE]（cc-switch 二元化约束）
+        if (this._streamEndedWithError) return [];
+        return [
+          event({
+            type: "response.completed",
+            response: { id: this.id, model: this.model, status: "completed" },
+          }),
+          "data: [DONE]\n\n",
+        ];
+      }
+
+      case "ping":
+        return [];
+
+      case "error": {
+        // 流中错：发 error event + 设抑制标志
+        this._streamEndedWithError = true;
+        return [event({ type: "response.error", error: { message: chunk.error } })];
+      }
+    }
+  }
+}
+
+function event(payload: Record<string, unknown>): string {
+  return `data: ${JSON.stringify(payload)}\n\n`;
+}

package/src/convert/upstream/canonical-to-anthropic.ts

@@ -0,0 +1,111 @@
+// ============================================================================
+// Canonical → Anthropic Messages 请求（发给 Anthropic 上游用）
+// ============================================================================
+import type { CanonicalRequest, CanonicalContentBlock } from "../../canonical/types";
+import { mergeExtras } from "../common/extras";
+
+interface AnthropicUpstreamRequest {
+  model: string;
+  system?: string;
+  messages: Array<{
+    role: "user" | "assistant";
+    content: string | Array<AnthropicContentBlock>;
+  }>;
+  tools?: Array<{ name: string; description?: string; input_schema: Record<string, unknown> }>;
+  max_tokens?: number;
+  temperature?: number;
+  top_p?: number;
+  stop_sequences?: string[];
+  stream: boolean;
+  // 让 Anthropic thinking 模型按 effort 估算预算（粗略映射）
+  thinking?: { type: "enabled"; budget_tokens: number };
+}
+
+type AnthropicContentBlock =
+  | { type: "text"; text: string }
+  | { type: "image"; source: { type: "base64" | "url"; media_type: string; data?: string; url?: string } }
+  | { type: "document"; source: { type: "base64" | "url"; media_type: string; data?: string; url?: string } }
+  | { type: "tool_use"; id: string; name: string; input: unknown }
+  | { type: "tool_result"; tool_use_id: string; content: string; is_error?: boolean }
+  | { type: "thinking"; thinking: string; signature?: string };
+
+export function canonicalToAnthropicUpstream(req: CanonicalRequest): AnthropicUpstreamRequest {
+  const messages: AnthropicUpstreamRequest["messages"] = req.messages.map((m) => {
+    const msgContent = m.content.length === 1 && m.content[0]?.type === "text"
+      ? m.content[0].text
+      : m.content.map(blockToAnthropic);
+    return {
+      role: m.role,
+      content: msgContent,
+      // 透传 message 级别未识别字段
+      ...(m.extras?.anthropic ?? {}),
+    };
+  });
+
+  let system: string | undefined;
+  if (typeof req.system === "string") system = req.system;
+  else if (Array.isArray(req.system)) system = req.system.map((b) => b.type === "text" ? b.text : "").join("");
+
+  return {
+    model: req.model,
+    system,
+    messages,
+    tools: req.tools?.map((t) => ({ name: t.name, description: t.description, input_schema: t.inputSchema })),
+    max_tokens: req.maxTokens,
+    temperature: req.temperature,
+    top_p: req.topP,
+    stop_sequences: req.stopSequences,
+    stream: req.stream,
+    thinking: req.reasoning?.effort ? { type: "enabled", budget_tokens: effortToBudget(req.reasoning.effort) } : undefined,
+  };
+}
+
+function effortToBudget(effort: "low" | "medium" | "high"): number {
+  switch (effort) {
+    case "low": return 1024;
+    case "medium": return 4096;
+    case "high": return 16_384;
+  }
+}
+
+function blockToAnthropic(b: CanonicalContentBlock): AnthropicContentBlock {
+  switch (b.type) {
+    case "text":
+      return mergeExtras({ type: "text", text: b.text } as AnthropicContentBlock, b.extras, "anthropic");
+    case "image": {
+      const src = b.source;
+      const built: AnthropicContentBlock = src.kind === "base64"
+        ? { type: "image", source: { type: "base64", media_type: src.mediaType, data: src.data } }
+        : { type: "image", source: { type: "url", media_type: src.mediaType, url: src.data } };
+      return mergeExtras(built, b.extras, "anthropic");
+    }
+    case "document": {
+      const src = b.source;
+      const built: AnthropicContentBlock = src.kind === "base64"
+        ? { type: "document", source: { type: "base64", media_type: src.mediaType, data: src.data } }
+        : { type: "document", source: { type: "url", media_type: src.mediaType, url: src.data } };
+      return mergeExtras(built, b.extras, "anthropic");
+    }
+    case "tool_use": {
+      const built: AnthropicContentBlock = { type: "tool_use", id: b.id, name: b.name, input: b.input };
+      return mergeExtras(built, b.extras, "anthropic");
+    }
+    case "tool_result": {
+      const built: AnthropicContentBlock = {
+        type: "tool_result",
+        tool_use_id: b.toolUseId,
+        content: typeof b.content === "string" ? b.content : b.content.map((cb) => cb.type === "text" ? cb.text : "").join(""),
+        is_error: b.isError,
+      };
+      return mergeExtras(built, b.extras, "anthropic");
+    }
+    case "thinking": {
+      // 原生 thinking block + 透传 signature（如果有）+ extras
+      const built: AnthropicContentBlock = { type: "thinking", thinking: b.thinking, ...(b.signature ? { signature: b.signature } : {}) };
+      return mergeExtras(built, b.extras, "anthropic");
+    }
+    case "refusal":
+      // Anthropic 无 refusal block；降级为加前缀的 text
+      return mergeExtras({ type: "text", text: `[refusal] ${b.refusal}` } as AnthropicContentBlock, b.extras, "anthropic");
+  }
+}

package/src/convert/upstream/canonical-to-chat.ts

@@ -0,0 +1,115 @@
+// ============================================================================
+// Canonical → OpenAI Chat Completions 请求（发给上游用）
+// ============================================================================
+import type { CanonicalRequest, CanonicalContentBlock, ImageSource } from "../../canonical/types";
+import { systemToString } from "../common/system-prompt";
+import { mergeExtras } from "../common/extras";
+
+type ChatContentPart =
+  | { type: "text"; text: string }
+  | { type: "image_url"; image_url: { url: string } };
+
+interface ChatUpstreamRequest {
+  model: string;
+  messages: Array<{
+    role: "system" | "user" | "assistant" | "tool";
+    content: string | null | ChatContentPart[];
+    tool_call_id?: string;
+    tool_calls?: Array<{ id: string; type: "function"; function: { name: string; arguments: string } }>;
+  }>;
+  tools?: Array<{ type: "function"; function: { name: string; description?: string; parameters?: Record<string, unknown> } }>;
+  max_tokens?: number;
+  temperature?: number;
+  top_p?: number;
+  stop?: string[];
+  stream: boolean;
+  // 兼容 reasoning_effort（OpenAI o-series / 兼容上游可识别）
+  reasoning_effort?: "low" | "medium" | "high";
+}
+
+export function canonicalToChatUpstream(req: CanonicalRequest): ChatUpstreamRequest {
+  const messages: ChatUpstreamRequest["messages"] = [];
+
+  // 顶级 system → 第一条 system message
+  const sysText = systemToString(req.system);
+  if (sysText) messages.push({ role: "system", content: sysText });
+
+  for (const m of req.messages) {
+    if (m.role === "user") {
+      const userBlocks = m.content;
+      // 检查是否全是 tool_result
+      const toolResults = userBlocks.filter((b) => b.type === "tool_result");
+      if (toolResults.length > 0 && toolResults.length === userBlocks.length) {
+        for (const tr of toolResults) {
+          if (tr.type === "tool_result") {
+            messages.push({
+              role: "tool",
+              content: typeof tr.content === "string" ? tr.content : "",
+              tool_call_id: tr.toolUseId,
+            });
+          }
+        }
+      } else if (userBlocks.some((b) => b.type === "image")) {
+        // 多模态：构造 OpenAI Chat content parts 数组
+        const parts: ChatContentPart[] = [];
+        for (const b of userBlocks) {
+          if (b.type === "text") {
+            parts.push({ type: "text", text: b.text });
+          } else if (b.type === "image") {
+            parts.push({ type: "image_url", image_url: { url: imageToDataUrl(b.source) } });
+          }
+          // document → OpenAI 兼容端点一般不支持，丢
+        }
+        messages.push({ role: "user", content: parts });
+      } else {
+        // 纯文本：合并成字符串
+        const text = extractText(userBlocks);
+        messages.push({ role: "user", content: text });
+      }
+    } else if (m.role === "assistant") {
+      const text = extractText(m.content);
+      const toolUses = m.content.filter((b): b is { type: "tool_use"; id: string; name: string; input: unknown } => b.type === "tool_use");
+      const msg: ChatUpstreamRequest["messages"][number] = { role: "assistant", content: text || null };
+      if (toolUses.length > 0) {
+        msg.tool_calls = toolUses.map((u) => ({
+          id: u.id,
+          type: "function",
+          function: {
+            name: u.name,
+            arguments: typeof u.input === "string" ? u.input : JSON.stringify(u.input ?? {}),
+          },
+        }));
+      }
+      // 透传 assistant message 级别 extras（openaiChat 桶）
+      const merged = mergeExtras(msg as unknown as Record<string, unknown>, m.extras, "openaiChat");
+      messages.push(merged as unknown as ChatUpstreamRequest["messages"][number]);
+    }
+  }
+
+  return {
+    model: req.model,
+    messages,
+    tools: req.tools?.map((t) => ({
+      type: "function",
+      function: { name: t.name, description: t.description, parameters: t.inputSchema },
+    })),
+    max_tokens: req.maxTokens,
+    temperature: req.temperature,
+    top_p: req.topP,
+    stop: req.stopSequences,
+    stream: req.stream,
+    reasoning_effort: req.reasoning?.effort,
+  };
+}
+
+function imageToDataUrl(src: ImageSource): string {
+  if (src.kind === "base64") return `data:${src.mediaType};base64,${src.data}`;
+  return src.data;
+}
+
+function extractText(blocks: CanonicalContentBlock[]): string {
+  return blocks
+    .filter((b): b is { type: "text"; text: string } => b.type === "text")
+    .map((b) => b.text)
+    .join("");
+}

package/src/convert/upstream/canonical-to-responses.ts

@@ -0,0 +1,123 @@
+// ============================================================================
+// Canonical → OpenAI Responses 请求（发给上游用）
+// ============================================================================
+import type { CanonicalRequest, CanonicalContentBlock, ImageSource } from "../../canonical/types";
+import { systemToString } from "../common/system-prompt";
+
+type ResponsesInputItem =
+  | { role: "user"; content: Array<{ type: "input_text"; text: string } | { type: "input_image"; image_url: string }> }
+  | { role: "assistant"; content: Array<{ type: "output_text"; text: string } | { type: "refusal"; refusal: string }> }
+  | { type: "function_call"; call_id: string; name: string; arguments: string }
+  | { type: "function_call_output"; call_id: string; output: string };
+
+interface ResponsesTool {
+  type: "function";
+  name: string;
+  description?: string;
+  parameters: Record<string, unknown>;
+}
+
+interface ResponsesUpstreamRequest {
+  model: string;
+  input: ResponsesInputItem[];
+  instructions?: string;
+  tools?: ResponsesTool[];
+  max_output_tokens?: number;
+  temperature?: number;
+  top_p?: number;
+  stream: boolean;
+  reasoning?: { effort: "low" | "medium" | "high" };
+  previous_response_id?: string;
+}
+
+export function canonicalToResponses(req: CanonicalRequest): ResponsesUpstreamRequest {
+  const input: ResponsesInputItem[] = [];
+  const instructions = systemToString(req.system);
+
+  for (const m of req.messages) {
+    // 抽 assistant tool_use 块 → 平级 function_call item（不是 message）
+    if (m.role === "assistant") {
+      const toolUses = m.content.filter((b): b is { type: "tool_use"; id: string; name: string; input: unknown } => b.type === "tool_use");
+      const otherBlocks = m.content.filter((b) => b.type !== "tool_use");
+
+      // assistant message（含 text / refusal）
+      if (otherBlocks.length > 0) {
+        const content: Array<{ type: "output_text"; text: string } | { type: "refusal"; refusal: string }> = [];
+        for (const b of otherBlocks) {
+          if (b.type === "text") content.push({ type: "output_text", text: b.text });
+          else if (b.type === "refusal") content.push({ type: "refusal", refusal: b.refusal });
+          // 忽略 thinking / image / document / tool_result 在 assistant message
+        }
+        if (content.length > 0) {
+          input.push({ role: "assistant", content });
+        }
+      }
+
+      // function_call item（每个 tool_use 一个）
+      for (const u of toolUses) {
+        input.push({
+          type: "function_call",
+          call_id: u.id,
+          name: u.name,
+          arguments: typeof u.input === "string" ? u.input : JSON.stringify(u.input ?? {}),
+        });
+      }
+    } else {
+      // user 消息
+      const toolResults = m.content.filter((b): b is { type: "tool_result"; toolUseId: string; content: string | CanonicalContentBlock[]; isError?: boolean } => b.type === "tool_result");
+      const otherBlocks = m.content.filter((b) => b.type !== "tool_result");
+
+      // function_call_output item（每个 tool_result 一个）
+      for (const tr of toolResults) {
+        input.push({
+          type: "function_call_output",
+          call_id: tr.toolUseId,
+          output: typeof tr.content === "string" ? tr.content : extractTextFromBlocks(tr.content),
+        });
+      }
+
+      // user message（含 text / image）
+      if (otherBlocks.length > 0) {
+        const content: Array<{ type: "input_text"; text: string } | { type: "input_image"; image_url: string }> = [];
+        for (const b of otherBlocks) {
+          if (b.type === "text") content.push({ type: "input_text", text: b.text });
+          else if (b.type === "image") content.push({ type: "input_image", image_url: imageToDataUrl(b.source) });
+          // 忽略 document / thinking / refusal 在 user message
+        }
+        if (content.length > 0) {
+          input.push({ role: "user", content });
+        }
+      }
+    }
+  }
+
+  return {
+    model: req.model,
+    input,
+    ...(instructions ? { instructions } : {}),
+    tools: req.tools?.map((t) => ({
+      type: "function" as const,
+      name: t.name,
+      description: t.description,
+      parameters: t.inputSchema,
+    })),
+    max_output_tokens: req.maxTokens,
+    temperature: req.temperature,
+    top_p: req.topP,
+    stream: req.stream,
+    ...(req.reasoning?.effort ? { reasoning: { effort: req.reasoning.effort } } : {}),
+    ...(req.previousResponseId ? { previous_response_id: req.previousResponseId } : {}),
+  };
+}
+
+function imageToDataUrl(src: ImageSource): string {
+  if (src.kind === "base64") return `data:${src.mediaType};base64,${src.data}`;
+  return src.data;
+}
+
+function extractTextFromBlocks(blocks: CanonicalContentBlock[]): string {
+  return blocks
+    .filter((b): b is { type: "text"; text: string } => b.type === "text")
+    .map((b) => b.text)
+    .join("");
+}

package/src/core/config.ts

@@ -0,0 +1,156 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { parseTOML, stringifyTOML } from "confbox";
+import { configTomlPath, ensureCctraDir } from "../utils/paths";
+import { DEFAULT_CONFIG, type Config, type Subscription, type PluginConfig, type Tier } from "../types";
+
+/**
+ * 从 ~/.cctra/config.toml 加载配置
+ * 如果文件不存在或损坏，返回默认配置
+ */
+export function loadConfigFile(): Config {
+  const path = configTomlPath();
+  if (!existsSync(path)) {
+    return structuredClone(DEFAULT_CONFIG);
+  }
+
+  const content = readFileSync(path, "utf-8");
+  let data: Partial<Config>;
+  try {
+    data = parseTOML(content) as Partial<Config>;
+  } catch {
+    console.warn("⚠ ~/.cctra/config.toml 格式损坏，将按空配置处理");
+    return structuredClone(DEFAULT_CONFIG);
+  }
+
+  // 合并默认结构
+  const config: Config = {
+    port: data.port ?? DEFAULT_CONFIG.port,
+    subscriptions: data.subscriptions ?? {},
+    plugins: data.plugins ?? {},
+    tiers: data.tiers ?? {},
+  };
+
+  // 补回 4 个预定义 tier（如果用户删了）
+  for (const t of ["cctra", "cctra-pro", "cctra-flash", "cctra-vision"] as const) {
+    if (!config.tiers[t]) {
+      config.tiers[t] = {
+        name: t,
+        target: "",
+        description: DEFAULT_CONFIG.tiers[t]?.description,
+      };
+    }
+  }
+
+  // 兜底：补 kind 字段（手动写的 config 可能漏了）
+  for (const sub of Object.values(config.subscriptions)) {
+    if (!sub.kind) sub.kind = "subscription";
+  }
+  for (const p of Object.values(config.plugins)) {
+    if (!p.kind) p.kind = "plugin";
+    if (p.enabled === undefined) p.enabled = true;
+  }
+
+  return config;
+}
+
+/** 把配置写到 ~/.cctra/config.toml */
+export function saveConfigFile(config: Config): void {
+  ensureCctraDir();
+  const content = stringifyTOML(config as unknown as Record<string, unknown>);
+  writeFileSync(configTomlPath(), content, "utf-8");
+}
+
+// ============================================================================
+// Subscription CRUD
+// ============================================================================
+
+export function getAllSubscriptions(config: Config): Array<[string, Subscription]> {
+  return Object.entries(config.subscriptions);
+}
+
+export function getSubscription(config: Config, name: string): Subscription | null {
+  return config.subscriptions[name] ?? null;
+}
+
+export function addSubscription(config: Config, sub: Subscription): void {
+  if (config.subscriptions[sub.name]) {
+    throw new Error(`Subscription "${sub.name}" already exists.`);
+  }
+  config.subscriptions[sub.name] = sub;
+}
+
+export function updateSubscription(config: Config, sub: Subscription): void {
+  if (!config.subscriptions[sub.name]) {
+    throw new Error(`Subscription "${sub.name}" not found.`);
+  }
+  config.subscriptions[sub.name] = sub;
+}
+
+export function removeSubscription(config: Config, name: string): void {
+  if (!config.subscriptions[name]) {
+    throw new Error(`Subscription "${name}" not found.`);
+  }
+  delete config.subscriptions[name];
+}
+
+// ============================================================================
+// Plugin CRUD
+// ============================================================================
+
+export function getAllPlugins(config: Config): Array<[string, PluginConfig]> {
+  return Object.entries(config.plugins);
+}
+
+export function getPlugin(config: Config, name: string): PluginConfig | null {
+  return config.plugins[name] ?? null;
+}
+
+export function addPlugin(config: Config, plugin: PluginConfig): void {
+  if (config.plugins[plugin.name]) {
+    throw new Error(`Plugin "${plugin.name}" already exists.`);
+  }
+  config.plugins[plugin.name] = plugin;
+}
+
+export function updatePlugin(config: Config, plugin: PluginConfig): void {
+  if (!config.plugins[plugin.name]) {
+    throw new Error(`Plugin "${plugin.name}" not found.`);
+  }
+  config.plugins[plugin.name] = plugin;
+}
+
+export function removePlugin(config: Config, name: string): void {
+  if (!config.plugins[name]) {
+    throw new Error(`Plugin "${name}" not found.`);
+  }
+  delete config.plugins[name];
+}
+
+// ============================================================================
+// Tier CRUD
+// ============================================================================
+
+export function getAllTiers(config: Config): Array<[string, Tier]> {
+  return Object.entries(config.tiers);
+}
+
+export function getTier(config: Config, name: string): Tier | null {
+  return config.tiers[name] ?? null;
+}
+
+export function setTier(config: Config, tier: Tier): void {
+  config.tiers[tier.name] = tier;
+}
+
+export function removeTier(config: Config, name: string): void {
+  // 预定义 tier 不允许删除，只能清空 target
+  if (["cctra", "cctra-pro", "cctra-flash", "cctra-vision"].includes(name)) {
+    config.tiers[name] = {
+      name,
+      target: "",
+      description: DEFAULT_CONFIG.tiers[name]?.description,
+    };
+    return;
+  }
+  delete config.tiers[name];
+}