@nvae/llmswitch 0.8.0 → 0.9.0

package/dist/adapters/opencode.js

@@ -31,13 +31,33 @@ export function readOpenCodeAuth(path = getOpenCodeAuthPath()) {
         return {};
     return JSON.parse(readFileSync(path, "utf8"));
 }
+/**
+ * Build one model entry for the OpenCode provider block. When metadata from
+ * models.lonae.com is available, expose the supported input/output modalities
+ * and attachment support, e.g.
+ * { "name": "id", "modalities": { "input": ["text","image"], "output": ["text"] }, "attachment": true }
+ */
+function buildOpenCodeModelEntry(id, meta) {
+    const entry = { name: id };
+    if (meta?.modalities) {
+        entry.modalities = {
+            input: meta.modalities.input?.length ? meta.modalities.input : ["text"],
+            output: meta.modalities.output?.length ? meta.modalities.output : ["text"],
+        };
+    }
+    if (typeof meta?.attachment === "boolean") {
+        entry.attachment = meta.attachment;
+    }
+    return entry;
+}
 export function buildOpenCodeProviderBlock(profile, overrides) {
+    const metaById = profile.models.meta || {};
     const models = {};
     for (const id of profile.models.list) {
-        models[id] = { name: id };
+        models[id] = buildOpenCodeModelEntry(id, metaById[id]);
     }
     if (!models[profile.models.default]) {
-        models[profile.models.default] = { name: profile.models.default };
+        models[profile.models.default] = buildOpenCodeModelEntry(profile.models.default, metaById[profile.models.default]);
     }
     const options = {
         baseURL: overrides?.baseURL ||

package/dist/commands/prompts.js

@@ -6,6 +6,7 @@ import { getPreset, presetsForTool } from "../presets/index.js";
 import { detectApiFormat } from "../utils/detect-format.js";
 import { assertValidProfileName, listProfiles, profileExists, saveProfile, } from "../store/profiles.js";
 import { fetchModelList, preferResolvedBaseUrl, } from "../utils/fetch-models.js";
+import { collectModelMeta, fetchModelMetadata, lookupModelMeta, } from "../utils/model-metadata.js";
 import { normalizeBaseUrlForFormat } from "../utils/base-url.js";
 import { maskSecret } from "../utils/fs.js";
 export function isCancel(value) {
@@ -391,6 +392,7 @@ export async function promptProfileDraft(tool, partial = {}) {
         models: {
             default: defaultModel,
             list: Array.from(new Set(modelList)),
+            meta: resolved.modelMeta,
         },
         proxy,
         bridgeMode: tool === "codex" && apiFormat === "openai-chat"
@@ -475,37 +477,76 @@ export async function promptEditProfile(tool, current) {
 /**
  * Fetch models from the provider API (when possible), then let the user
  * pick a default + a saved list. Falls back to manual text entry.
+ * Model metadata (modalities/attachment) is fetched from models.lonae.com
+ * while the model list is loading and attached to the final selection.
  */
 export async function resolveModelsInteractive(input) {
+    // Best-effort: fetch metadata in the background so it overlaps with /models.
+    const metaPromise = tryFetchModelMetadata(input);
     if (input.fixedDefault && input.fixedList?.length) {
         const list = [...input.fixedList];
         if (!list.includes(input.fixedDefault))
             list.unshift(input.fixedDefault);
-        return { defaultModel: input.fixedDefault, modelList: list };
+        return {
+            defaultModel: input.fixedDefault,
+            modelList: list,
+            modelMeta: collectModelMeta(await metaPromise, list),
+        };
     }
     if (input.fixedDefault && !input.fixedList) {
         const fetched = await tryFetchModels(input);
-        if (fetched?.models.length) {
-            const list = Array.from(new Set([input.fixedDefault, ...fetched.models]));
-            return {
-                defaultModel: input.fixedDefault,
-                modelList: list,
-                resolvedBaseUrl: fetched.resolvedBaseUrl,
-            };
-        }
+        const list = fetched?.models.length
+            ? Array.from(new Set([input.fixedDefault, ...fetched.models]))
+            : [input.fixedDefault];
         return {
             defaultModel: input.fixedDefault,
-            modelList: [input.fixedDefault],
+            modelList: list,
+            resolvedBaseUrl: fetched?.resolvedBaseUrl,
+            modelMeta: collectModelMeta(await metaPromise, list),
         };
     }
+    const catalog = await metaPromise;
     const fetched = await tryFetchModels(input);
     if (fetched && fetched.models.length > 0) {
-        const selected = await selectModelsFromFetched(fetched.models, input);
+        const selected = await selectModelsFromFetched(fetched.models, input, catalog);
         return { ...selected, resolvedBaseUrl: fetched.resolvedBaseUrl };
     }
-    return manualModelsEntry(input);
+    return manualModelsEntry(input, catalog);
 }
-async function selectModelsFromFetched(fetched, input) {
+/**
+ * Best-effort metadata fetch from models.lonae.com.
+ * Returns undefined (with a warning) when unreachable.
+ */
+async function tryFetchModelMetadata(input) {
+    try {
+        const catalog = await fetchModelMetadata({ proxy: input.proxy });
+        p.log.info(`已从 models.lonae.com 获取 ${Object.keys(catalog.full).length} 个模型的元数据`);
+        return catalog;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        p.log.warn(`获取模型元数据失败（models.lonae.com）：${msg}`);
+        return undefined;
+    }
+}
+/** Human-readable modality hint for a model, e.g. "text/image → text · 支持附件". */
+function metadataHint(modelId, catalog) {
+    const meta = catalog ? lookupModelMeta(catalog, modelId) : undefined;
+    if (!meta)
+        return undefined;
+    const parts = [];
+    if (meta.modalities) {
+        parts.push(`${meta.modalities.input.join("/")} → ${meta.modalities.output.join("/")}`);
+    }
+    if (meta.attachment === true)
+        parts.push("支持附件");
+    return parts.length > 0 ? parts.join(" · ") : undefined;
+}
+function joinHints(...hints) {
+    const joined = hints.filter(Boolean).join(" · ");
+    return joined || undefined;
+}
+async function selectModelsFromFetched(fetched, input, catalog) {
     const preferredDefault = (input.preferredDefault && fetched.includes(input.preferredDefault)
         ? input.preferredDefault
         : undefined) ||
@@ -518,7 +559,7 @@ async function selectModelsFromFetched(fetched, input) {
         options: fetched.map((id) => ({
             value: id,
             label: id,
-            hint: id === input.preferredDefault ? "当前" : undefined,
+            hint: joinHints(id === input.preferredDefault ? "当前" : undefined, metadataHint(id, catalog)),
         })),
         initialValue: preferredDefault,
     });
@@ -530,7 +571,7 @@ async function selectModelsFromFetched(fetched, input) {
         options: fetched.map((id) => ({
             value: id,
             label: id,
-            hint: (input.preferredList || []).includes(id) ? "当前" : undefined,
+            hint: joinHints((input.preferredList || []).includes(id) ? "当前" : undefined, metadataHint(id, catalog)),
         })),
         initialValues: Array.from(new Set([defaultModel, ...preferredList, ...presetList])),
         required: true,
@@ -540,9 +581,9 @@ async function selectModelsFromFetched(fetched, input) {
         process.exit(0);
     }
     const modelList = Array.from(new Set([defaultModel, ...picked]));
-    return { defaultModel, modelList };
+    return { defaultModel, modelList, modelMeta: collectModelMeta(catalog, modelList) };
 }
-async function manualModelsEntry(input) {
+async function manualModelsEntry(input, catalog) {
     p.log.warn("未能自动获取模型列表，改为手动输入。");
     let defaultModel = input.fixedDefault || input.preferredDefault;
     if (!defaultModel) {
@@ -571,7 +612,11 @@ async function manualModelsEntry(input) {
     if (!modelList.includes(defaultModel)) {
         modelList = [defaultModel, ...modelList];
     }
-    return { defaultModel, modelList };
+    return {
+        defaultModel,
+        modelList,
+        modelMeta: collectModelMeta(catalog, modelList),
+    };
 }
 export async function tryFetchModels(input) {
     const spin = p.spinner();

package/dist/commands/tool.js

@@ -376,6 +376,7 @@ async function configureProfileModels(tool, profile) {
     });
     profile.models.default = resolved.defaultModel;
     profile.models.list = resolved.modelList;
+    profile.models.meta = resolved.modelMeta;
     if (resolved.resolvedBaseUrl &&
         resolved.resolvedBaseUrl !== profile.baseUrl) {
         p.log.info(`已根据可用接口将 Base URL 规范为 ${resolved.resolvedBaseUrl}（原：${profile.baseUrl}）`);

package/dist/store/profiles.js

@@ -5,6 +5,13 @@ 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}$/;
+/** Keep only metadata entries whose model id is still in the list. */
+function filterModelMeta(meta, list) {
+    if (!meta)
+        return undefined;
+    const filtered = Object.fromEntries(Object.entries(meta).filter(([id]) => list.includes(id)));
+    return Object.keys(filtered).length > 0 ? filtered : undefined;
+}
 export function assertValidProfileName(name) {
     if (!NAME_RE.test(name)) {
         throw new Error(`无效的 profile 名称「${name}」。仅允许字母、数字、下划线、连字符，且以字母或数字开头。`);
@@ -115,6 +122,7 @@ export function saveProfile(tool, profile) {
     const list = Array.from(new Set([profile.models.default, profile.models.fast, ...(profile.models.list || [])]
         .filter(Boolean)
         .map((m) => m.trim())));
+    const meta = filterModelMeta(profile.models.meta, list);
     const next = {
         ...profile,
         displayName: profile.displayName || profile.name,
@@ -124,6 +132,7 @@ export function saveProfile(tool, profile) {
             default: profile.models.default.trim(),
             fast: profile.models.fast?.trim() || undefined,
             list,
+            meta,
         },
         headers: profile.headers || {},
         updatedAt: new Date().toISOString(),
@@ -228,6 +237,7 @@ function normalizeProfile(raw, fallbackName) {
             default: raw.models?.default || list[0] || "",
             fast: raw.models?.fast || undefined,
             list: list.length ? list : raw.models?.default ? [raw.models.default] : [],
+            meta: filterModelMeta(raw.models?.meta, list),
         },
         proxy: normalizeProxyValue(raw.proxy),
         bridgeMode: raw.bridgeMode,

package/dist/utils/model-metadata.js

@@ -0,0 +1,179 @@
+import { requestWithNodeTransport } from "../bridge/transport.js";
+export const MODEL_METADATA_SOURCE = "https://models.lonae.com";
+const DEFAULT_ENDPOINT = `${MODEL_METADATA_SOURCE}/api/v1/models`;
+const PAGE_SIZE = 1000;
+/** Trailing date stamp, e.g. "-20250219" in "claude-3-7-sonnet-20250219". */
+const DATE_SUFFIX_RE = /-?\d{8}$/;
+/**
+ * Normalize a model id for fuzzy matching: lowercase, drop separators, and
+ * align dotted version segments ("claude-3.7-sonnet" ↔ "claude-3-7-sonnet").
+ */
+export function normalizeModelKey(value) {
+    return value
+        .toLowerCase()
+        .replace(/\./g, "-")
+        .replace(/[^a-z0-9]/g, "");
+}
+/** Normalize a model id ignoring a trailing date stamp. */
+export function normalizeModelKeyLoose(value) {
+    const bare = value.replace(DATE_SUFFIX_RE, "");
+    return normalizeModelKey(bare) || normalizeModelKey(value);
+}
+function asModalityList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const list = value.filter((item) => typeof item === "string" && !!item.trim());
+    return list.length > 0 ? list : undefined;
+}
+function parseModalities(row) {
+    const nested = row.modalities;
+    const input = (nested && typeof nested === "object"
+        ? asModalityList(nested.input)
+        : undefined) ?? asModalityList(row.inputModalities);
+    const output = (nested && typeof nested === "object"
+        ? asModalityList(nested.output)
+        : undefined) ?? asModalityList(row.outputModalities);
+    if (!input && !output)
+        return undefined;
+    return {
+        input: input ?? ["text"],
+        output: output ?? ["text"],
+    };
+}
+/** Insert into a normalized bucket, preferring undated ids as canonical. */
+function indexNorm(bucket, datedMetas, key, meta, dated) {
+    if (!key)
+        return;
+    const existing = bucket[key];
+    if (!existing) {
+        bucket[key] = meta;
+        return;
+    }
+    if (datedMetas.has(existing) && !dated)
+        bucket[key] = meta;
+}
+/**
+ * Build the lookup catalog from a /api/v1/models payload.
+ * Indexes: full id ("lab/model"), bare id ("model"), plus normalized variants
+ * (date-stamp tolerant) so "claude-3.7-sonnet" can find
+ * "claude-3-7-sonnet-20250219".
+ */
+export function parseModelMetadata(payload) {
+    const catalog = { full: {}, bare: {}, norm: {} };
+    const rows = payload && typeof payload === "object"
+        ? payload.data
+        : null;
+    if (!Array.isArray(rows))
+        return catalog;
+    const datedMetas = new Set();
+    for (const item of rows) {
+        if (!item || typeof item !== "object")
+            continue;
+        const row = item;
+        if (typeof row.id !== "string" || !row.id.trim())
+            continue;
+        const id = row.id.trim();
+        const meta = {
+            id,
+            name: typeof row.name === "string" && row.name.trim() ? row.name.trim() : undefined,
+            modalities: parseModalities(row),
+            attachment: typeof row.attachment === "boolean" ? row.attachment : undefined,
+        };
+        const bareIndex = id.indexOf("/");
+        const bare = bareIndex >= 0 ? id.slice(bareIndex + 1).trim() : id;
+        const dated = DATE_SUFFIX_RE.test(bare);
+        if (dated)
+            datedMetas.add(meta);
+        const fullKey = id.toLowerCase();
+        const bareKey = bare.toLowerCase();
+        const normKey = normalizeModelKey(bare);
+        const looseKey = normalizeModelKeyLoose(bare);
+        if (!catalog.full[fullKey])
+            catalog.full[fullKey] = meta;
+        if (bare && !catalog.bare[bareKey])
+            catalog.bare[bareKey] = meta;
+        indexNorm(catalog.norm, datedMetas, normKey, meta, dated);
+        if (looseKey !== normKey)
+            indexNorm(catalog.norm, datedMetas, looseKey, meta, dated);
+    }
+    return catalog;
+}
+/** Look up metadata for a profile model id (exact → bare → normalized). */
+export function lookupModelMeta(catalog, modelId) {
+    const trimmed = modelId.trim();
+    if (!trimmed)
+        return undefined;
+    const bareIndex = trimmed.indexOf("/");
+    const bare = bareIndex >= 0 ? trimmed.slice(bareIndex + 1).trim() : trimmed;
+    return (catalog.full[trimmed.toLowerCase()] ??
+        catalog.bare[bare.toLowerCase()] ??
+        catalog.norm[normalizeModelKey(bare)] ??
+        catalog.norm[normalizeModelKeyLoose(bare)]);
+}
+/** Collect metadata for a set of profile model ids. */
+export function collectModelMeta(catalog, models) {
+    if (!catalog)
+        return undefined;
+    const meta = {};
+    for (const id of models) {
+        const found = lookupModelMeta(catalog, id);
+        if (found)
+            meta[id] = found;
+    }
+    return Object.keys(meta).length > 0 ? meta : undefined;
+}
+/**
+ * Fetch the model metadata catalog from models.lonae.com.
+ * Paginates automatically (page_size capped at 1000 per request).
+ */
+export async function fetchModelMetadata(options = {}) {
+    const endpoint = options.endpoint || DEFAULT_ENDPOINT;
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const rows = [];
+    let total = Infinity;
+    let page = 1;
+    while (rows.length < total) {
+        const url = `${endpoint}${endpoint.includes("?") ? "&" : "?"}page_size=${PAGE_SIZE}&page=${page}`;
+        const payload = await requestJson(url, options.proxy, timeoutMs);
+        const batch = payload && typeof payload === "object"
+            ? payload.data
+            : null;
+        if (!Array.isArray(batch) || batch.length === 0)
+            break;
+        rows.push(...batch);
+        const totalRaw = payload && typeof payload === "object"
+            ? payload.meta?.total
+            : undefined;
+        total = typeof totalRaw === "number" && totalRaw > 0 ? totalRaw : rows.length;
+        page += 1;
+    }
+    return parseModelMetadata({ data: rows });
+}
+async function requestJson(url, proxy, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await requestWithNodeTransport({
+            url,
+            method: "GET",
+            headers: { Accept: "application/json" },
+            proxy,
+            signal: controller.signal,
+            totalTimeoutMs: timeoutMs,
+        });
+        if (!res.ok) {
+            const body = (await res.text().catch(() => "")).slice(0, 200);
+            throw new Error(`HTTP ${res.status}${body ? `: ${body}` : ""}`);
+        }
+        return await res.json();
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new Error(`请求超时（${timeoutMs}ms）`);
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nvae/llmswitch",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "CLI to switch LLM providers and models for Claude Code, Codex, and OpenCode",
   "type": "module",
   "bin": {