@nvae/llmswitch 0.2.0

package/dist/commands/tool.js

@@ -0,0 +1,380 @@
+import * as p from "@clack/prompts";
+import { applyProfile, deactivateProfile } from "../adapters/index.js";
+import { formatLabel } from "../formats/compatibility.js";
+import { deleteProfile, ensureDefaultProvider, getActiveProfile, getDefaultProfile, listProfiles, publicProfileView, requireProfile, saveProfile, setDefaultProfile, } from "../store/profiles.js";
+import { formatProxySummary } from "../utils/proxy.js";
+import { exitOnCancel, promptEditProfile, promptProfileDraft, resolveModelsInteractive, } from "./prompts.js";
+export function registerToolCommand(program, tool) {
+    const cmd = program
+        .command(tool)
+        .description(`管理 ${tool} 的供应商与模型配置`);
+    cmd
+        .command("provider")
+        .description("管理模型供应商：添加 / 默认 / 启用禁用 / 查看 / 编辑 / 删除")
+        .option("--json", "以 JSON 列出全部供应商后退出")
+        .action(async (opts) => {
+        ensureDefaultProvider(tool);
+        if (opts.json) {
+            const active = getActiveProfile(tool)?.name ?? null;
+            const defaultName = getDefaultProfile(tool)?.name ?? null;
+            console.log(JSON.stringify(listProfiles(tool).map((profile) => ({
+                ...publicProfileView(profile),
+                active: profile.name === active,
+                default: profile.name === defaultName,
+            })), null, 2));
+            return;
+        }
+        await runProviderManager(tool);
+    });
+    cmd
+        .command("use")
+        .description("启用已有供应商（写入对应工具配置）")
+        .argument("[name]", "供应商名称；省略则交互选择")
+        .option("--json", "JSON 输出")
+        .action(async (name, opts) => {
+        ensureDefaultProvider(tool);
+        const profileName = await resolveProfileName(tool, name);
+        const profile = requireProfile(tool, profileName);
+        const result = await applyProfile(tool, profile);
+        if (opts?.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`已启用 ${tool}/${profile.name}`);
+        console.log(`配置文件：${result.configPath}`);
+        if (result.backupPath)
+            console.log(`备份：${result.backupPath}`);
+        console.log(result.restartHint);
+    });
+    cmd
+        .command("current")
+        .description("查看默认与当前启用的供应商")
+        .option("--json", "JSON 输出")
+        .action((opts) => {
+        ensureDefaultProvider(tool);
+        const active = getActiveProfile(tool);
+        const defaultProfile = getDefaultProfile(tool);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                default: defaultProfile ? publicProfileView(defaultProfile) : null,
+                active: active ? publicProfileView(active) : null,
+            }, null, 2));
+            return;
+        }
+        if (!defaultProfile && !active) {
+            console.log(`当前没有 ${tool} 供应商`);
+            console.log(`请先：llms ${tool} provider`);
+            return;
+        }
+        if (defaultProfile) {
+            printProfileDetails(tool, defaultProfile, {
+                isActive: active?.name === defaultProfile.name,
+                isDefault: true,
+                title: "默认供应商",
+            });
+        }
+        if (active && active.name !== defaultProfile?.name) {
+            printProfileDetails(tool, active, {
+                isActive: true,
+                isDefault: false,
+                title: "当前启用",
+            });
+        }
+        else if (!active) {
+            console.log("当前没有已启用的供应商（可用 provider 菜单启用）");
+        }
+    });
+    registerModelCommands(cmd, tool);
+}
+async function runProviderManager(tool) {
+    p.intro(`${tool} 模型供应商`);
+    while (true) {
+        ensureDefaultProvider(tool);
+        const profiles = listProfiles(tool);
+        const active = getActiveProfile(tool)?.name ?? null;
+        const defaultName = getDefaultProfile(tool)?.name ?? null;
+        const selected = await p.select({
+            message: "选择供应商",
+            options: [
+                {
+                    value: "__new__",
+                    label: "添加新供应商",
+                    hint: "自定义 / OpenAI / Anthropic",
+                },
+                ...profiles.map((profile) => ({
+                    value: profile.name,
+                    // hint 仅高亮时可见，状态标在 label 上便于扫一眼认出默认项
+                    label: formatProviderListLabel(profile, {
+                        defaultName,
+                        activeName: active,
+                    }),
+                    hint: formatLabel(profile.apiFormat),
+                })),
+                {
+                    value: "__exit__",
+                    label: "退出",
+                },
+            ],
+        });
+        exitOnCancel(selected);
+        if (selected === "__exit__") {
+            p.outro("已退出供应商管理");
+            return;
+        }
+        if (selected === "__new__") {
+            await handleProviderAdd(tool);
+            continue;
+        }
+        await handleProviderActions(tool, selected);
+    }
+}
+async function handleProviderAdd(tool) {
+    const created = await promptProfileDraft(tool);
+    ensureDefaultProvider(tool);
+    const enable = await p.confirm({
+        message: `是否立即启用「${created.name}」？`,
+        initialValue: true,
+    });
+    if (p.isCancel(enable)) {
+        p.cancel("已取消");
+        process.exit(0);
+    }
+    if (enable) {
+        const result = await applyProfile(tool, created);
+        p.log.success(`已启用 ${tool}/${created.name}`);
+        p.log.info(`配置文件：${result.configPath}`);
+        p.log.info(result.restartHint);
+    }
+}
+async function handleProviderActions(tool, profileName) {
+    while (true) {
+        ensureDefaultProvider(tool);
+        let profile;
+        try {
+            profile = requireProfile(tool, profileName);
+        }
+        catch {
+            p.log.warn(`「${profileName}」已不存在`);
+            return;
+        }
+        const isActive = getActiveProfile(tool)?.name === profile.name;
+        const isDefault = getDefaultProfile(tool)?.name === profile.name;
+        const action = await p.select({
+            message: `${profile.displayName || profile.name}`,
+            options: [
+                {
+                    value: "default",
+                    label: "设置为默认供应商",
+                    hint: isDefault ? "当前已是默认" : undefined,
+                },
+                {
+                    value: "toggle",
+                    label: isActive ? "禁用" : "启用",
+                    hint: isActive ? "清除写入工具的配置" : "写入对应工具配置",
+                },
+                {
+                    value: "view",
+                    label: "查看配置",
+                },
+                {
+                    value: "edit",
+                    label: "编辑配置",
+                    hint: "显示名 / 地址 / 密钥 / 代理 / 格式",
+                },
+                {
+                    value: "delete",
+                    label: "删除配置",
+                    hint: isActive ? "将先禁用再删除" : undefined,
+                },
+                {
+                    value: "back",
+                    label: "返回列表",
+                },
+            ],
+        });
+        exitOnCancel(action);
+        if (action === "back")
+            return;
+        if (action === "default") {
+            setDefaultProfile(tool, profile.name);
+            p.log.success(`已将「${profile.name}」设为默认供应商`);
+            continue;
+        }
+        if (action === "toggle") {
+            if (isActive) {
+                const result = await deactivateProfile(tool, profile.name);
+                p.log.success(`已禁用「${profile.name}」`);
+                p.log.info(`配置文件：${result.configPath}`);
+                p.log.info(result.restartHint);
+            }
+            else {
+                const result = await applyProfile(tool, profile);
+                p.log.success(`已启用「${profile.name}」`);
+                p.log.info(`配置文件：${result.configPath}`);
+                if (result.backupPath)
+                    p.log.info(`备份：${result.backupPath}`);
+                p.log.info(result.restartHint);
+            }
+            continue;
+        }
+        if (action === "view") {
+            printProfileDetails(tool, profile, { isActive, isDefault });
+            continue;
+        }
+        if (action === "edit") {
+            const updated = await promptEditProfile(tool, profile);
+            if (getActiveProfile(tool)?.name === updated.name) {
+                const sync = await p.confirm({
+                    message: "该供应商当前已启用，是否立即写回工具配置？",
+                    initialValue: true,
+                });
+                if (p.isCancel(sync)) {
+                    p.cancel("已取消");
+                    process.exit(0);
+                }
+                if (sync) {
+                    const result = await applyProfile(tool, updated);
+                    p.log.success("已同步写入工具配置");
+                    p.log.info(result.restartHint);
+                }
+            }
+            continue;
+        }
+        if (action === "delete") {
+            const ok = await p.confirm({
+                message: `确认删除供应商「${profile.name}」？此操作不可恢复`,
+                initialValue: false,
+            });
+            if (p.isCancel(ok)) {
+                p.cancel("已取消");
+                process.exit(0);
+            }
+            if (!ok)
+                continue;
+            if (isActive) {
+                await deactivateProfile(tool, profile.name);
+            }
+            deleteProfile(tool, profile.name);
+            p.log.success(`已删除「${profile.name}」`);
+            return;
+        }
+    }
+}
+function printProfileDetails(tool, profile, flags) {
+    const view = publicProfileView(profile);
+    const status = [];
+    if (flags.isDefault)
+        status.push("默认");
+    if (flags.isActive)
+        status.push("已启用");
+    if (status.length === 0)
+        status.push("未启用");
+    p.note([
+        `标识：${view.name}`,
+        `显示名：${view.displayName}`,
+        `状态：${status.join(" · ")}`,
+        `格式：${formatLabel(view.apiFormat)}`,
+        `Base URL：${view.baseUrl}`,
+        `API Key：${view.apiKey}`,
+        `默认模型：${view.models.default}`,
+        `模型列表：${view.models.list.join(", ") || "（空）"}`,
+        `代理：${formatProxySummary(profile.proxy)}`,
+        profile.bridgeMode === "completions"
+            ? "上游接口：Completions"
+            : profile.bridgeMode === "chat"
+                ? "上游接口：Chat Completions"
+                : null,
+        `更新时间：${view.updatedAt}`,
+    ]
+        .filter(Boolean)
+        .join("\n"), flags.title || `${tool} / ${profile.name}`);
+}
+async function configureProfileModels(tool, profile) {
+    p.log.step(`配置 ${profile.displayName || profile.name} 的模型`);
+    const resolved = await resolveModelsInteractive({
+        apiFormat: profile.apiFormat,
+        baseUrl: profile.baseUrl,
+        apiKey: profile.apiKey,
+        proxy: profile.proxy,
+        preferredDefault: profile.models.default,
+        preferredList: profile.models.list,
+    });
+    profile.models.default = resolved.defaultModel;
+    profile.models.list = resolved.modelList;
+    if (resolved.resolvedBaseUrl &&
+        resolved.resolvedBaseUrl !== profile.baseUrl) {
+        p.log.info(`已根据可用接口将 Base URL 规范为 ${resolved.resolvedBaseUrl}（原：${profile.baseUrl}）`);
+        profile.baseUrl = resolved.resolvedBaseUrl;
+    }
+    saveProfile(tool, profile);
+    const active = getActiveProfile(tool);
+    if (active?.name === profile.name) {
+        await applyProfile(tool, requireProfile(tool, profile.name));
+        p.log.success(`已更新模型并写入工具配置：默认「${resolved.defaultModel}」，共 ${resolved.modelList.length} 个`);
+    }
+    else {
+        p.log.success(`已更新模型：默认「${resolved.defaultModel}」，共 ${resolved.modelList.length} 个。启用：llms ${tool} use ${profile.name}`);
+    }
+}
+async function resolveProfileName(tool, name) {
+    if (name) {
+        requireProfile(tool, name);
+        return name;
+    }
+    ensureDefaultProvider(tool);
+    const profiles = listProfiles(tool);
+    if (profiles.length === 0) {
+        throw new Error(`暂无 ${tool} 供应商。请先：llms ${tool} provider`);
+    }
+    const active = getActiveProfile(tool)?.name;
+    const defaultName = getDefaultProfile(tool)?.name;
+    const selected = await p.select({
+        message: `选择 ${tool} 供应商`,
+        options: profiles.map((profile) => ({
+            value: profile.name,
+            label: formatProviderListLabel(profile, {
+                defaultName,
+                activeName: active,
+            }),
+            hint: formatLabel(profile.apiFormat),
+        })),
+        initialValue: defaultName || active || profiles[0].name,
+    });
+    exitOnCancel(selected);
+    return selected;
+}
+/** 列表项 label 始终可见；hint 仅在高亮行显示。 */
+function formatProviderListLabel(profile, opts) {
+    const name = profile.displayName || profile.name;
+    const tags = [];
+    if (profile.name === opts.defaultName)
+        tags.push("默认");
+    if (profile.name === opts.activeName)
+        tags.push("已启用");
+    return tags.length ? `${name}（${tags.join(" · ")}）` : name;
+}
+function registerModelCommands(parent, tool) {
+    parent
+        .command("model")
+        .description("先选供应商，再拉取并选择要启用的模型（空格多选，回车确认）")
+        .option("--profile <name>", "指定供应商，跳过列表选择")
+        .option("--json", "JSON 输出")
+        .action(async (opts) => {
+        p.intro(`配置 ${tool} 模型`);
+        const profile = opts.profile
+            ? requireProfile(tool, opts.profile)
+            : requireProfile(tool, await resolveProfileName(tool));
+        await configureProfileModels(tool, profile);
+        if (opts.json) {
+            const latest = requireProfile(tool, profile.name);
+            console.log(JSON.stringify({
+                profile: latest.name,
+                default: latest.models.default,
+                models: latest.models.list,
+                applied: getActiveProfile(tool)?.name === latest.name,
+            }, null, 2));
+            return;
+        }
+        p.outro("模型配置完成");
+    });
+}

package/dist/formats/compatibility.js

@@ -0,0 +1,33 @@
+const SUPPORTED = {
+    // openai-chat 通过本地 bridge 转成 /v1/messages 供 Claude Code 使用
+    claude: ["anthropic", "openai-chat"],
+    // openai-chat 通过本地 bridge 转成 /v1/responses 供 Codex 使用
+    codex: ["openai-responses", "openai-chat"],
+    opencode: ["anthropic", "openai-chat", "openai-responses"],
+};
+export function supportedFormats(tool) {
+    return SUPPORTED[tool];
+}
+export function assertCompatible(tool, format) {
+    if (SUPPORTED[tool].includes(format))
+        return;
+    if (tool === "claude") {
+        throw new Error(`Claude Code 支持 anthropic（直连）或 openai-chat（经本地 bridge 转为 /v1/messages）。` +
+            `当前 profile 为 ${format}。`);
+    }
+    if (tool === "codex") {
+        throw new Error(`Codex 支持 openai-responses（原生）或 openai-chat（经本地 bridge 转为 /v1/responses）。` +
+            `当前 profile 为 ${format}。`);
+    }
+    throw new Error(`工具 ${tool} 不支持格式 ${format}`);
+}
+export function formatLabel(format) {
+    switch (format) {
+        case "anthropic":
+            return "Claude（Anthropic Messages）";
+        case "openai-chat":
+            return "OpenAI Chat Completions";
+        case "openai-responses":
+            return "OpenAI Responses";
+    }
+}

package/dist/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { run } from "./cli.js";
+await run();

package/dist/presets/index.js

@@ -0,0 +1,40 @@
+import { supportedFormats } from "../formats/compatibility.js";
+export const PRESET_IDS = ["custom", "openai", "anthropic"];
+export const PRESETS = [
+    {
+        id: "custom",
+        displayName: "自定义（OpenAI 兼容）",
+        apiFormat: "openai-chat",
+        baseUrl: "",
+        defaultModel: "",
+        models: [],
+        tools: ["claude", "codex", "opencode"],
+    },
+    {
+        id: "openai",
+        displayName: "OpenAI",
+        apiFormat: "openai-responses",
+        baseUrl: "https://api.openai.com/v1",
+        defaultModel: "",
+        models: [],
+        tools: ["codex", "opencode"],
+    },
+    {
+        id: "anthropic",
+        displayName: "Anthropic",
+        apiFormat: "anthropic",
+        baseUrl: "https://api.anthropic.com",
+        defaultModel: "",
+        models: [],
+        tools: ["claude", "opencode"],
+    },
+];
+export function isPresetId(value) {
+    return PRESET_IDS.includes(value);
+}
+export function presetsForTool(tool) {
+    return PRESETS.filter((p) => p.tools.includes(tool) && supportedFormats(tool).includes(p.apiFormat));
+}
+export function getPreset(id) {
+    return PRESETS.find((p) => p.id === id);
+}

package/dist/store/profiles.js

@@ -0,0 +1,202 @@
+import { existsSync, readdirSync, unlinkSync } from "node:fs";
+import { readFileSync } from "node:fs";
+import { isApiFormat } from "../types.js";
+import { normalizeBaseUrlForFormat } from "../utils/base-url.js";
+import { atomicWriteFile, ensureDir, maskSecret } from "../utils/fs.js";
+import { getProfilePath, getProfilesDir, getStatePath, getToolStoreDir, } from "../utils/paths.js";
+const NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
+export function assertValidProfileName(name) {
+    if (!NAME_RE.test(name)) {
+        throw new Error(`无效的 profile 名称「${name}」。仅允许字母、数字、下划线、连字符，且以字母或数字开头。`);
+    }
+}
+export function ensureToolStore(tool) {
+    ensureDir(getProfilesDir(tool));
+}
+export function readState(tool) {
+    const path = getStatePath(tool);
+    if (!existsSync(path))
+        return { active: null, default: null };
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        return {
+            active: raw.active ?? null,
+            default: raw.default ?? null,
+        };
+    }
+    catch {
+        return { active: null, default: null };
+    }
+}
+export function writeState(tool, state) {
+    ensureToolStore(tool);
+    atomicWriteFile(getStatePath(tool), JSON.stringify({
+        active: state.active ?? null,
+        default: state.default ?? null,
+    }, null, 2) + "\n");
+}
+export function listProfiles(tool) {
+    ensureToolStore(tool);
+    const dir = getProfilesDir(tool);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith(".json"))
+        .map((f) => readProfile(tool, f.replace(/\.json$/, "")))
+        .filter((p) => p !== null)
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+export function profileExists(tool, name) {
+    return existsSync(getProfilePath(tool, name));
+}
+export function readProfile(tool, name) {
+    const path = getProfilePath(tool, name);
+    if (!existsSync(path))
+        return null;
+    const raw = JSON.parse(readFileSync(path, "utf8"));
+    return normalizeProfile(raw, name);
+}
+export function requireProfile(tool, name) {
+    const profile = readProfile(tool, name);
+    if (!profile) {
+        throw new Error(`未找到 ${tool} 的 profile「${name}」`);
+    }
+    return profile;
+}
+export function saveProfile(tool, profile) {
+    assertValidProfileName(profile.name);
+    if (!isApiFormat(profile.apiFormat)) {
+        throw new Error(`无效的 apiFormat: ${profile.apiFormat}`);
+    }
+    if (!profile.baseUrl?.trim()) {
+        throw new Error("baseUrl 不能为空");
+    }
+    if (!profile.models?.default?.trim()) {
+        throw new Error("默认模型不能为空");
+    }
+    const list = Array.from(new Set([profile.models.default, profile.models.fast, ...(profile.models.list || [])]
+        .filter(Boolean)
+        .map((m) => m.trim())));
+    const next = {
+        ...profile,
+        displayName: profile.displayName || profile.name,
+        baseUrl: normalizeBaseUrlForFormat(profile.apiFormat, profile.baseUrl),
+        apiKey: profile.apiKey ?? "",
+        models: {
+            default: profile.models.default.trim(),
+            fast: profile.models.fast?.trim() || undefined,
+            list,
+        },
+        headers: profile.headers || {},
+        updatedAt: new Date().toISOString(),
+    };
+    ensureToolStore(tool);
+    atomicWriteFile(getProfilePath(tool, next.name), JSON.stringify(next, null, 2) + "\n");
+}
+export function deleteProfile(tool, name) {
+    const path = getProfilePath(tool, name);
+    if (!existsSync(path)) {
+        throw new Error(`未找到 ${tool} 的 profile「${name}」`);
+    }
+    unlinkSync(path);
+    const state = readState(tool);
+    writeState(tool, {
+        active: state.active === name ? null : state.active,
+        default: state.default === name ? null : state.default,
+    });
+    ensureDefaultProvider(tool);
+}
+export function getActiveProfile(tool) {
+    const { active } = readState(tool);
+    if (!active)
+        return null;
+    return readProfile(tool, active);
+}
+export function setActiveProfile(tool, name) {
+    requireProfile(tool, name);
+    const state = readState(tool);
+    const defaultName = state.default && profileExists(tool, state.default) ? state.default : name;
+    writeState(tool, { active: name, default: defaultName });
+}
+export function clearActiveProfile(tool) {
+    const state = readState(tool);
+    writeState(tool, { ...state, active: null });
+}
+/**
+ * Ensure a default provider exists whenever there is at least one profile.
+ * Missing/invalid default falls back to active (if valid), otherwise the first profile.
+ */
+export function ensureDefaultProvider(tool) {
+    const profiles = listProfiles(tool);
+    const state = readState(tool);
+    if (profiles.length === 0) {
+        if (state.default !== null || state.active !== null) {
+            writeState(tool, { active: null, default: null });
+        }
+        return null;
+    }
+    if (state.default && profiles.some((p) => p.name === state.default)) {
+        return state.default;
+    }
+    if (state.active && profiles.some((p) => p.name === state.active)) {
+        writeState(tool, { ...state, default: state.active });
+        return state.active;
+    }
+    const first = profiles[0].name;
+    writeState(tool, { ...state, default: first });
+    return first;
+}
+export function getDefaultProfile(tool) {
+    const name = ensureDefaultProvider(tool);
+    if (!name)
+        return null;
+    return readProfile(tool, name);
+}
+export function setDefaultProfile(tool, name) {
+    requireProfile(tool, name);
+    const state = readState(tool);
+    writeState(tool, { ...state, default: name });
+}
+export function publicProfileView(profile) {
+    return {
+        name: profile.name,
+        displayName: profile.displayName,
+        apiFormat: profile.apiFormat,
+        baseUrl: profile.baseUrl,
+        apiKey: maskSecret(profile.apiKey),
+        models: profile.models,
+        proxy: profile.proxy || null,
+        updatedAt: profile.updatedAt,
+    };
+}
+function normalizeProfile(raw, fallbackName) {
+    const name = raw.name || fallbackName;
+    const list = Array.from(new Set([
+        raw.models?.default,
+        raw.models?.fast,
+        ...(raw.models?.list || []),
+    ]
+        .filter(Boolean)
+        .map((m) => String(m).trim())));
+    return {
+        name,
+        displayName: raw.displayName || name,
+        apiFormat: raw.apiFormat,
+        baseUrl: isApiFormat(raw.apiFormat)
+            ? normalizeBaseUrlForFormat(raw.apiFormat, String(raw.baseUrl || ""))
+            : String(raw.baseUrl || "").replace(/\/+$/, ""),
+        apiKey: raw.apiKey ?? "",
+        models: {
+            default: raw.models?.default || list[0] || "",
+            fast: raw.models?.fast || undefined,
+            list: list.length ? list : raw.models?.default ? [raw.models.default] : [],
+        },
+        proxy: raw.proxy,
+        bridgeMode: raw.bridgeMode,
+        headers: raw.headers || {},
+        updatedAt: raw.updatedAt || new Date(0).toISOString(),
+    };
+}
+export function storeRoot(tool) {
+    return getToolStoreDir(tool);
+}

package/dist/types.js

@@ -0,0 +1,17 @@
+export const TOOLS = ["claude", "codex", "opencode"];
+export const API_FORMATS = [
+    "anthropic",
+    "openai-chat",
+    "openai-responses",
+];
+export function isTool(value) {
+    return TOOLS.includes(value);
+}
+export function isApiFormat(value) {
+    return API_FORMATS.includes(value);
+}
+export function emptyProxy(proxy) {
+    if (!proxy)
+        return true;
+    return !proxy.http && !proxy.https && !proxy.all;
+}