cartethyia 2.7.4 → 2.7.6

package/src/console/backup/store.ts

@@ -38,6 +38,7 @@ import { appendFile, mkdir } from "node:fs/promises";
 import { getTableColumns, type Column, type SQL, type Table } from "drizzle-orm";
 import type { CartethyiaDatabase } from "../../persistence/db-handle";
 import { decryptCredentialToString, encryptCredential } from "../../security/crypto";
+import { asConsoleDb } from "../shared/transaction";
 import {
   apiKeys,
   cliToolMappings,
@@ -75,7 +76,7 @@ import {
   tableName,
   type BackupBytes,
   type BackupDate,
-  type BackupExportResult,
+  type BackupPayloadExport,
   type BackupPayload,
   type BackupRow,
   type ValidatedRestore,
@@ -187,11 +188,15 @@ function decodeCell(value: unknown, dataType: string): unknown {
 }
 
 /** Column name → the object key Drizzle uses for it, and its data type. */
+const COLUMN_INDEX_CACHE = new WeakMap<Table, ReadonlyMap<string, { key: string; dataType: string }>>();
 function columnIndex(table: Table): ReadonlyMap<string, { key: string; dataType: string }> {
+  const cached = COLUMN_INDEX_CACHE.get(table);
+  if (cached) return cached;
   const out = new Map<string, { key: string; dataType: string }>();
   for (const [key, column] of Object.entries(getTableColumns(table))) {
     out.set(column.name, { key, dataType: column.dataType });
   }
+  COLUMN_INDEX_CACHE.set(table, out);
   return out;
 }
 
@@ -386,13 +391,6 @@ async function* pagedTelemetryEvents(
   }
 }
 
-/**
- * Streams the payload document: the requested tables, grouped into their
- * sections, written membrane-incrementally so the process never holds a table
- * — let alone every table and a second JSON copy — in memory. Consumed
- * chunks concatenated are exactly the JSON the buffered variant used to
- * stringify in one piece.
- */
 /**
  * Streams the payload document: the requested tables, grouped into their
  * sections, written incrementally so the process never holds a table — let
@@ -571,7 +569,7 @@ export async function exportBackup(
   db: CartethyiaDatabase,
   tables: readonly Table[],
   tenantId: string,
-): Promise<BackupExportResult> {
+): Promise<BackupPayloadExport> {
   const stream = exportBackupStream(db, tables, tenantId);
   let document = "";
   for await (const chunk of stream.jsonChunks) document += chunk;
@@ -618,7 +616,7 @@ export async function compressBackupStream(chunks: AsyncGenerator<string, void,
 const GZIP_MAGIC = [0x1f, 0x8b] as const;
 
 /** Whether `bytes` starts with the gzip magic. */
-export function isGzipBytes(bytes: Uint8Array): boolean {
+function isGzipBytes(bytes: Uint8Array): boolean {
   return GZIP_MAGIC.every((byte, index) => bytes[index] === byte);
 }
 
@@ -722,7 +720,6 @@ function createdAtIso(value: unknown): string {
  * timestamps are normalised in SQL to the same ISO spelling the payload uses,
  * so the two sides are comparable regardless of how the driver types them.
  */
-/** Natural keys already present in the event file, so a re-import skips them. */
 async function existingEventFileKeys(db: CartethyiaDatabase, tenantId: string, rows: readonly BackupRow[]): Promise<Set<string>> {
   const wanted = new Set(rows.map((row) => row.request_id).filter((id): id is string => typeof id === "string"));
   if (wanted.size === 0) return new Set();
@@ -894,9 +891,8 @@ async function insertRows(
       // stays writable and the per-row path can isolate the offending row.
       const count = await tx.transaction(async (innerTx) => {
         // Drizzle types the nested transaction callback with the dialect's
-        // own transaction handle; cast once to a named local with a reason,
-        // never inline on member access.
-        const inner = innerTx as unknown as CartethyiaDatabase; // nested-tx handle; mirrors applyRestore's outer `scoped` cast on line 607.
+        // own transaction handle; normalize once via the shared helper.
+        const inner = asConsoleDb(innerTx);
         const statement = inner.insert(table).values(chunk as never);
         if (options.ignoreConflicts) {
           if (options.conflictTarget === undefined) {
@@ -1003,22 +999,46 @@ export async function normalizeShareChildPolicy(
   db: CartethyiaDatabase,
   tenantId: string,
 ): Promise<void> {
+  // Template policy columns are nulled on every child so auth reads the full
+  // policy from the parent (`policy = parent ?? row`). The exception is a
+  // `per_key` concurrency child: it carries its own cap (copied at issue) and
+  // its own admission identity, so `concurrency_scope` and
+  // `max_concurrent_requests` are preserved for those rows.
+  const policyNulls = {
+    notesTitle: null,
+    notesSubtitle: null,
+    notesBody: null,
+    requestsPerMinute: null,
+    dailyTokenLimit: null,
+    monthlyTokenLimit: null,
+    lifetimeTokenBudget: null,
+    modelPrefix: null,
+    modelList: null,
+    clientRouterDenylist: null,
+  };
   await db
     .update(apiKeys)
     .set({
-      notesTitle: null,
-      notesSubtitle: null,
-      notesBody: null,
-      requestsPerMinute: null,
-      dailyTokenLimit: null,
-      monthlyTokenLimit: null,
-      lifetimeTokenBudget: null,
+      ...policyNulls,
       maxConcurrentRequests: null,
-      modelPrefix: null,
-      modelList: null,
-      clientRouterDenylist: null,
     })
-    .where(and(eq(apiKeys.tenantId, tenantId), isNotNull(apiKeys.parentKeyId)));
+    .where(
+      and(
+        eq(apiKeys.tenantId, tenantId),
+        isNotNull(apiKeys.parentKeyId),
+        sql`${apiKeys.concurrencyScope} <> 'per_key'`,
+      ),
+    );
+  await db
+    .update(apiKeys)
+    .set(policyNulls)
+    .where(
+      and(
+        eq(apiKeys.tenantId, tenantId),
+        isNotNull(apiKeys.parentKeyId),
+        eq(apiKeys.concurrencyScope, "per_key"),
+      ),
+    );
 }
 
 /**
@@ -1046,7 +1066,7 @@ export async function applyRestore(
   const skipped: Record<string, number> = {};
 
   await db.transaction(async (tx) => {
-    const scoped = tx as unknown as CartethyiaDatabase;
+    const scoped = asConsoleDb(tx);
 
     // The tenant row is ensured, never replaced: it almost always exists, and
     // its PK is `id`, so a conflict means "already there" rather than an error.
@@ -1199,7 +1219,7 @@ export async function deleteAll(
   const apiKeyIds: string[] = [];
 
   await db.transaction(async (tx) => {
-    const scoped = tx as unknown as CartethyiaDatabase;
+    const scoped = asConsoleDb(tx);
     const remove = async (table: Table, filter: SQL, name = tableName(table)): Promise<void> => {
       const rows = await scoped.delete(table).where(filter).returning();
       if (rows.length > 0) deleted[name] = (deleted[name] ?? 0) + rows.length;
@@ -1241,5 +1261,3 @@ export async function deleteAll(
 
   return { deleted, apiKeyIds };
 }
-
-export { and, eq };

package/src/console/backup/validate.ts

@@ -101,12 +101,17 @@ function normalizeLegacyCiphertext(table: Table, row: Record<string, unknown>):
   return normalized;
 }
 
+const COLUMN_TYPES_CACHE = new WeakMap<Table, ReadonlyMap<string, string>>();
+
 /** Column name → its Drizzle data type, so validation knows what may nest. */
 function columnTypes(table: Table): ReadonlyMap<string, string> {
+  const cached = COLUMN_TYPES_CACHE.get(table);
+  if (cached) return cached;
   const out = new Map<string, string>();
   for (const column of Object.values(getTableColumns(table))) {
     out.set(column.name, column.dataType);
   }
+  COLUMN_TYPES_CACHE.set(table, out);
   return out;
 }
 
@@ -122,7 +127,11 @@ function columnTypes(table: Table): ReadonlyMap<string, string> {
  * would write a row the operator never had, and guessing wrong on a credential
  * column is worse than not restoring that one row.
  */
+const REQUIRED_COLUMNS_CACHE = new WeakMap<Table, ReadonlySet<string>>();
+
 function requiredColumns(table: Table): ReadonlySet<string> {
+  const cached = REQUIRED_COLUMNS_CACHE.get(table);
+  if (cached) return cached;
   const out = new Set<string>();
   for (const column of Object.values(getTableColumns(table))) {
     if (!column.notNull || column.hasDefault) continue;
@@ -132,11 +141,12 @@ function requiredColumns(table: Table): ReadonlySet<string> {
     if (column.name === "tenant_id") continue;
     out.add(column.name);
   }
+  REQUIRED_COLUMNS_CACHE.set(table, out);
   return out;
 }
 
 /** Detection outcome for an uploaded file. */
-export type DetectedFormat =
+type DetectedFormat =
   | { readonly kind: "native"; readonly payload: Record<string, unknown> }
   | { readonly kind: "nine_router"; readonly payload: Record<string, unknown> }
   | { readonly kind: "unknown"; readonly reason: string };

package/src/console/cli-tools/contracts.ts

@@ -6,12 +6,11 @@ import { ensureV1Suffix } from "./fs-ops";
  * CLI Tools type contracts — shared across registry, injectors, service,
  * dashboard, and API routes.
  *
- * Each supported CLI coding agent ([CC], Codex, Cline, etc.) has a `ToolDef`
- * with static metadata and (when `configType !== "guide"`) a paired
- * `ToolInjector` that reads and writes the tool's config files on the host
- * filesystem. The dashboard picks an API key + models, POSTs to the backend,
- * and the injector merges Cartethyia-specific fields into the tool's config
- * without clobbering user settings.
+ * Each supported CLI coding agent ([CC], Codex, Kilo, OpenCode) has a `ToolDef`
+ * with static metadata and a paired `ToolInjector` that reads and writes the
+ * tool's config files on the host filesystem. The dashboard picks an API key +
+ * models, POSTs to the backend, and the injector merges Cartethyia-specific
+ * fields into the tool's config without clobbering user settings.
  */
 
 /**
@@ -19,13 +18,13 @@ import { ensureV1Suffix } from "./fs-ops";
  * sibling project used `openai-chat | openai-responses | anthropic-messages`;
  * Cartethyia's canonical surface vocabulary is the shorter form.
  */
-export type CliToolSurface = "chat" | "responses" | "messages";
+type CliToolSurface = "chat" | "responses" | "messages";
 
 /** How the tool's config is managed. */
-export type ConfigType = "env" | "custom" | "guide";
+type ConfigType = "env" | "custom";
 
 /** A native model slot exposed by a CLI tool. */
-export interface ToolModelDef {
+interface ToolModelDef {
   readonly id: string;
   readonly name: string;
   readonly alias: string;
@@ -53,6 +52,13 @@ export interface CliMappingInput {
 /** The user-facing routing mode for a CLI tool: `remote` routes are resolved by the gateway, `local` routes are baked into the tool's own config file. */
 export type CliMappingMode = "remote" | "local";
 
+/**
+ * The default runtime SDK package for OpenCode: its native
+ * `@opencode/ai/providers/openai-compatible` package (bundled with OpenCode
+ * itself, not the AI SDK).
+ */
+export const DEFAULT_SDK: string = "@opencode/ai/providers/openai-compatible";
+
 /** Persisted mapping settings for one CLI tool + API key pair. */
 export interface CliMappingSettings {
   readonly toolId: string;
@@ -63,26 +69,11 @@ export interface CliMappingSettings {
 }
 
 /** A note shown in the tool card UI. */
-export interface ToolNote {
+interface ToolNote {
   readonly type: "info" | "warning" | "error";
   readonly text: string;
 }
 
-/** A guide step for guide-only tools. */
-export interface GuideStep {
-  readonly step: number;
-  readonly title: string;
-  readonly desc?: string;
-  readonly value?: string;
-  readonly type?: "apiKeySelector" | "modelSelector";
-}
-
-/** A code block for guide-only tools. */
-export interface GuideCodeBlock {
-  readonly language: string;
-  readonly code: string;
-}
-
 /** Static metadata for a CLI tool — consumed by both backend and frontend. */
 export interface ToolDef {
   readonly id: string;
@@ -95,8 +86,6 @@ export interface ToolDef {
   readonly settingsFile?: string;
   readonly docsUrl?: string;
   readonly notes?: readonly ToolNote[];
-  readonly guideSteps?: readonly GuideStep[];
-  readonly codeBlock?: GuideCodeBlock;
   /**
    * How this tool's slot→route mapping behaves, which also decides whether the
    * tool has a mapping surface at all.
@@ -109,9 +98,7 @@ export interface ToolDef {
    *   so a slot has one value (written to the file) rather than a separate
    *   target. There is nothing to persist; the model is baked into the file.
    *
-   * Absent means the tool exposes no configurable model slots at all (a
-   * guide-only tool). This replaces a separate `mappingSupported` flag that
-   * had to be kept consistent with the mode by hand — the mode already says it.
+   * Absent means the tool exposes no configurable model slots at all.
    */
   readonly mappingMode?: CliMappingMode;
 }
@@ -137,8 +124,6 @@ export type ToolRegistryEntry = Pick<
   | "settingsFile"
   | "docsUrl"
   | "notes"
-  | "guideSteps"
-  | "codeBlock"
 > & { readonly mappingSupported: boolean };
 
 /** Runtime status of a CLI tool on the host. */
@@ -175,6 +160,17 @@ export interface ApplyInput {
   readonly mapping?: CliMappingInput;
   /** Enables [CC]'s bypass-permissions (YOLO) mode when explicitly selected. */
   readonly bypassPermissions?: boolean;
+  /**
+   * The runtime SDK package to write into the tool's config (e.g. OpenCode's
+   * `provider.*.npm`). Absent = the tool's default.
+   */
+  readonly sdk?: string;
+  /**
+   * WebSearch provider selection written into OpenCode's config. "carte"
+   * routes search through the Cartethyia gateway; "native" (or absent) leaves
+   * OpenCode's own provider selection in place.
+   */
+  readonly websearch?: string;
 }
 
 /** Result of an apply or reset operation. */
@@ -182,6 +178,8 @@ export interface ApplyResult {
   readonly success: boolean;
   readonly settingsPath?: string;
   readonly message: string;
+  /** Non-fatal notes for the operator, e.g. preserved pre-existing providers. */
+  readonly warnings?: readonly string[];
 }
 
 /**
@@ -195,9 +193,9 @@ export interface ApplyResult {
  *   persisted routing rows on each `/v1/*` call. Works when the gateway is
  *   remote, containerised, or the CLI lives on another machine.
  * - `both` — the tool's config was written and a remote route was recorded.
- * - `none` — nothing ran: the tool has no injectable config (a guide tool) and
- *   the request asked for no remote route. Reported rather than folded into
- *   `file`, so the UI never claims a write that did not happen.
+ * - `none` — nothing ran: the tool has no injectable config and the request
+ *   asked for no remote route. Reported rather than folded into `file`, so
+ *   the UI never claims a write that did not happen.
  */
 export type ApplyOutcome = "file" | "remote" | "both" | "none";
 
@@ -210,6 +208,8 @@ export interface ApplyConfigResult {
   readonly savedRemoteRoute: boolean;
   readonly settingsPath?: string;
   readonly message: string;
+  /** Non-fatal notes for the operator (see `ApplyResult.warnings`). */
+  readonly warnings?: readonly string[];
 }
 
 /** Result of a download-config operation. */
@@ -220,8 +220,7 @@ export interface DownloadResult {
 }
 
 /**
- * Injector contract — one per file-based tool.
- * Guide-only tools share a single GuideInjector that generates config text.
+ * Injector contract — one per tool.
  */
 export interface ToolInjector {
   readonly toolId: string;
@@ -235,7 +234,7 @@ export interface ToolInjector {
 export type AllStatusesResult = Readonly<Record<string, ToolStatus>>;
 
 /** Status details extracted from a tool's configuration file(s). */
-export interface StatusDetails {
+interface StatusDetails {
   readonly configured: boolean;
   readonly currentEndpoint?: string | null | undefined;
   readonly currentApiKeyPrefix?: string | null | undefined;
@@ -325,8 +324,12 @@ export interface InjectorSpec {
   /** Extract status details from existing settings file(s) */
   readonly readStatus: (path: string) => Promise<StatusDetails> | StatusDetails;
 
-  /** Apply Cartethyia configuration to the settings file(s) */
-  readonly apply: (input: ApplyInput, path: string) => Promise<void> | void;
+  /**
+   * Apply Cartethyia configuration to the settings file(s). Return an array of
+   * non-fatal warning strings to surface them to the operator (e.g. preserved
+   * pre-existing providers).
+   */
+  readonly apply: (input: ApplyInput, path: string) => Promise<readonly string[] | void> | readonly string[] | void;
 
   /**
    * Reset Cartethyia configuration from settings file(s).
@@ -449,32 +452,6 @@ export const TOOL_REGISTRY = {
     ],
   },
 
-  cline: {
-    id: "cline",
-    name: "Cline",
-    color: "#00D1B2",
-    description: "Cline AI Coding Assistant (VS Code)",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "~/.cline/data/globalState.json",
-    defaultModels: [
-      {
-        id: "claude/claude-sonnet-5",
-        name: "Claude Sonnet 5",
-        alias: "sonnet",
-        roleLabel: "Primary Agent",
-        roleKind: "primary",
-      },
-      {
-        id: "claude/claude-opus-4-8",
-        name: "Claude Opus",
-        alias: "opus",
-        roleLabel: "Advanced Agent",
-        roleKind: "secondary",
-      },
-    ],
-  },
-
   opencode: {
     id: "opencode",
     name: "OpenCode",
@@ -501,86 +478,6 @@ export const TOOL_REGISTRY = {
     ],
   },
 
-  droid: {
-    id: "droid",
-    name: "Factory Droid",
-    color: "#00D4FF",
-    description: "Factory Droid AI Assistant",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "~/.factory/settings.json",
-    defaultModels: [
-      { id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" },
-      { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", alias: "gpt-5.6-sol" },
-    ],
-  },
-
-  hermes: {
-    id: "hermes",
-    name: "Hermes Agent",
-    color: "#8B5CF6",
-    description: "Nous Research self-improving AI agent",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "~/.hermes/config.yaml",
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-  },
-
-  "grok-build": {
-    id: "grok-build",
-    name: "Grok Build",
-    color: "#1DA1F2",
-    description: "xAI Grok Build CLI",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "~/.grok/config.toml",
-    defaultModels: [{ id: "grok/grok-4", name: "Grok 4", alias: "grok-4" }],
-  },
-
-  copilot: {
-    id: "copilot",
-    name: "GitHub Copilot",
-    color: "#1F6FEB",
-    description: "GitHub Copilot Chat (VS Code chatLanguageModels.json)",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "Code/User/chatLanguageModels.json",
-    defaultModels: [
-      { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", alias: "gpt-5.6-sol" },
-      { id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" },
-    ],
-  },
-
-  "deepseek-tui": {
-    id: "deepseek-tui",
-    name: "DeepSeek TUI",
-    color: "#4D6BFE",
-    description: "DeepSeek Terminal Coding Agent (Rust TUI)",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "~/.deepseek/config.toml",
-    defaultModels: [
-      { id: "deepseek/deepseek-chat", name: "DeepSeek Chat", alias: "deepseek-chat" },
-      {
-        id: "deepseek/deepseek-reasoner",
-        name: "DeepSeek Reasoner",
-        alias: "deepseek-reasoner",
-      },
-    ],
-  },
-
-  jcode: {
-    id: "jcode",
-    name: "jcode",
-    color: "#FF6B35",
-    description: "High-performance Rust-based coding agent harness",
-    configType: "custom" as const,
-    surface: "chat" as const,
-    settingsFile: "~/.jcode/config.toml",
-    docsUrl: "https://github.com/1jehuang/jcode",
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-  },
-
   kilo: {
     id: "kilo",
     name: "Kilo Code",
@@ -591,159 +488,6 @@ export const TOOL_REGISTRY = {
     settingsFile: "~/.local/share/kilo/auth.json",
     defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
   },
-
-  openclaw: {
-    id: "openclaw",
-    name: "Open Claw",
-    color: "#FF6B35",
-    description: "Open Claw AI Assistant",
-    configType: "custom" as const,
-    surface: "messages" as const,
-    settingsFile: "~/.openclaw/openclaw.json",
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-  },
-
-  cowork: {
-    id: "cowork",
-    name: "Claude Cowork",
-    color: "#D97757",
-    description: "Claude Desktop Cowork (third-party inference)",
-    configType: "custom" as const,
-    surface: "messages" as const,
-    settingsFile: "Claude/configLibrary/_meta.json",
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-  },
-  // ── Guide-only tools (no fs injection — show steps + downloadable config) ──
-  roo: {
-    id: "roo",
-    name: "Roo",
-    color: "#FF6B6B",
-    description: "Roo AI Assistant",
-    configType: "guide" as const,
-    surface: "chat" as const,
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-    guideSteps: [
-      { step: 1, title: "Open Settings", desc: "Go to Roo Settings panel" },
-      { step: 2, title: "Select Provider", desc: "Choose API Provider → Ollama" },
-      { step: 3, title: "Base URL", value: "{{baseUrl}}" },
-      { step: 4, title: "API Key", type: "apiKeySelector" },
-      { step: 5, title: "Select Model", type: "modelSelector" },
-    ],
-  },
-
-  continue: {
-    id: "continue",
-    name: "Continue",
-    color: "#7C3AED",
-    description: "Continue AI Assistant",
-    configType: "guide" as const,
-    surface: "chat" as const,
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-    guideSteps: [
-      { step: 1, title: "Open Config", desc: "Open Continue configuration file" },
-      { step: 2, title: "API Key", type: "apiKeySelector" },
-      { step: 3, title: "Select Model", type: "modelSelector" },
-      {
-        step: 4,
-        title: "Add Model Config",
-        desc: "Add the following configuration to your models array:",
-      },
-    ],
-    codeBlock: {
-      language: "json",
-      code: `{
-  "apiBase": "{{baseUrl}}",
-  "title": "{{model}}",
-  "model": "{{model}}",
-  "provider": "openai",
-  "apiKey": "{{apiKey}}"
-}`,
-    },
-  },
-
-  amp: {
-    id: "amp",
-    name: "Amp CLI",
-    color: "#F97316",
-    description: "Sourcegraph Amp coding assistant CLI",
-    configType: "guide" as const,
-    surface: "chat" as const,
-    docsUrl: "/docs?section=cli-tools&tool=amp",
-    defaultModels: [{ id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" }],
-    notes: [
-      {
-        type: "info",
-        text: "Use Cartethyia model aliases to keep Amp shorthand mappings stable across provider updates.",
-      },
-    ],
-    guideSteps: [
-      {
-        step: 1,
-        title: "Install Amp",
-        desc: "Install the Amp CLI using the package manager supported by your environment.",
-      },
-      { step: 2, title: "API Key", type: "apiKeySelector" },
-      { step: 3, title: "Base URL", value: "{{baseUrl}}" },
-      { step: 4, title: "Select Model", type: "modelSelector" },
-      {
-        step: 5,
-        title: "Add Shorthands",
-        desc: "Map Amp shorthand names to Cartethyia aliases in your local config.",
-      },
-    ],
-    codeBlock: {
-      language: "bash",
-      code: `export OPENAI_API_KEY="{{apiKey}}"
-export OPENAI_BASE_URL="{{baseUrl}}"
-amp --model "{{model}}"`,
-    },
-  },
-
-  qwen: {
-    id: "qwen",
-    name: "Qwen Code",
-    color: "#10B981",
-    description: "Alibaba Qwen Code CLI — OpenAI-compatible via Cartethyia",
-    configType: "guide" as const,
-    surface: "chat" as const,
-    docsUrl: "https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/",
-    defaultModels: [
-      { id: "claude/claude-sonnet-5", name: "Claude Sonnet 5", alias: "sonnet" },
-      { id: "gpt-5.6-sol", name: "GPT-5.6 Sol", alias: "gpt-5.6-sol" },
-    ],
-    notes: [
-      {
-        type: "warning",
-        text: "Config path: Linux/macOS ~/.qwen/settings.json - Windows %USERPROFILE%\\.qwen\\settings.json",
-      },
-    ],
-    guideSteps: [
-      { step: 1, title: "Install Qwen Code", desc: "npm install -g @qwen-code/qwen-code" },
-      { step: 2, title: "API Key", type: "apiKeySelector" },
-      { step: 3, title: "Base URL", value: "{{baseUrl}}" },
-      { step: 4, title: "Select Model", type: "modelSelector" },
-      {
-        step: 5,
-        title: "Save Config",
-        desc: "Copy the JSON below to your ~/.qwen/settings.json file.",
-      },
-    ],
-    codeBlock: {
-      language: "json",
-      code: `{
-  "security": {
-    "auth": {
-      "selectedType": "openai",
-      "apiKey": "{{apiKey}}",
-      "baseUrl": "{{baseUrl}}"
-    }
-  },
-  "model": {
-    "name": "{{model}}"
-  }
-}`,
-    },
-  },
 } satisfies Record<string, ToolDef>;
 
 export type ToolId = keyof typeof TOOL_REGISTRY;