@sema-agent/client-core 0.6.0 → 0.8.0

package/dist/model/providerPresets.js

@@ -0,0 +1,160 @@
+/**
+ * ⇄ B6 批搬迁(2026-07-27,设计稿 §3 B6 · B4「四残件」之 model 数据表):cli
+ *    `src/sema/onboard/providerPresets.{ts,json}` + `modelFamilies.json` 整搬(零依赖、纯查表)。
+ *
+ * 🔴 **为什么数据表必须进包**:`modelBudgetRule.defaultMaxTokensFor()`(B2 已搬)的封顶① 参数
+ *    `perModelCap` 只有一个来源 —— `inferFamily()` 第①层精确命中。表留在壳里 ⇒ 库里那条中央规则
+ *    在 web/桌面上**永远拿不到 cap**,`defaultMaxTokensFor(ctx)` 恒走 min(base, ctx/4),
+ *    对 deepseek-chat(cap 8192)这类模型直接超发 ⇒ 网关 400。这不是「少个装饰」。
+ *
+ * 🔴 **两份副本的漂移锁**:搬迁期壳树那两个 JSON 还在(壳侧 shim 批之前 onboard 全族在读它),
+ *    所以 pure 门加了一条 **byte-identity 断言**:本包 `src/model/*.json` 与壳树
+ *    `src/sema/onboard/*.json` 必须**逐字节相等**,任一侧加一行 provider 而另一侧没加即当场红。
+ *    壳侧 shim 落地(那两个 JSON 删除、providerPresets.ts 改 re-export 本包)之后,该断言
+ *    自动降为 SKIP(壳树缺席 = 搬完了),不会变成陈旧的假红。
+ *
+ * ── 以下为原文件的领域说明(逐字保留)────────────────────────────────────────────────────────
+ *
+ * providerPresets.ts — typed accessors over the static preset data tables for
+ * `sema onboard` (GUIDE-ONBOARD-DESIGN §3a/§3b, clay 拍板 2026-07-03).
+ *
+ * DATA lives in the sibling JSON files (providerPresets.json /
+ * modelFamilies.json) — adding a provider or family is a table row, no code
+ * change (维护性原则: new source = one module + one table row). Shapes align
+ * with openclaw's plugin-manifest `modelCatalog.providers` / CenterModel so
+ * translators stay ~free, but centralized (sema has no plugin system).
+ *
+ * All numbers are best-effort defaults (待核 official docs); qwen/glm values
+ * were read from clay's real ~/.openclaw catalog.
+ */
+import presetData from './providerPresets.json' with { type: 'json' };
+import familyData from './modelFamilies.json' with { type: 'json' };
+export const PROVIDER_PRESETS = presetData.presets;
+export const MODEL_FAMILIES = familyData.families;
+// ── 模型自动匹配 v2(clay 07-06:预填要"较为准确的推荐",真实测例驱动,verify/_infer-family-test)──
+// 四层:①preset 大表精确命中(46 provider 的真实 models,最强证据)②容量后缀/名内提示([1m]、-128k)
+// ③家族主干匹配(部署前缀/参数量/量化后缀容忍)④family 表前缀兜底。
+/** 尾部变体词(主干提取时剥):不承载 ctx 信息的营销/角色/量化/参数量后缀。 */
+const VARIANT_TAIL = /(-(plus|pro|max|flash|turbo|mini|lite|chat|coder?|code|instruct|thinking|reasoner|next|preview|latest|fp8|fp16|awq|int[48]|gptq|\d+b))+$/;
+let presetIndexCache = null;
+function presetIndex() {
+    if (presetIndexCache)
+        return presetIndexCache;
+    const exact = new Map();
+    const stems = [];
+    for (const p of PROVIDER_PRESETS) {
+        for (const m of p.models ?? []) {
+            if (!m?.id || !m.contextWindow)
+                continue;
+            const hit = {
+                id: m.id.toLowerCase(),
+                contextWindow: m.contextWindow,
+                maxTokens: m.maxTokens ?? 32768,
+                famId: p.id,
+            };
+            if (!exact.has(hit.id))
+                exact.set(hit.id, hit);
+            stems.push(hit);
+        }
+    }
+    presetIndexCache = { exact, stems };
+    return presetIndexCache;
+}
+function normalizeId(raw) {
+    let id = raw.trim().toLowerCase();
+    const slash = id.lastIndexOf('/');
+    if (slash >= 0)
+        id = id.slice(slash + 1); // org/model → model
+    id = id.replace(/\[[0-9]+[km]\]$/, ''); // [1m] 容量后缀在第②层单独消费
+    return id;
+}
+/** Infer context/max from a model id — four evidence tiers, strongest first. */
+export function inferFamily(modelId) {
+    const raw = modelId.trim().toLowerCase();
+    if (!raw)
+        return undefined;
+    const idx = presetIndex();
+    // ② 前置:显式容量标注恒赢([1m]/[200k] CC 惯例后缀)——用户/工具已声明,别猜。
+    const capSuffix = raw.match(/\[(\d+)([km])\]$/);
+    if (capSuffix) {
+        const n = Number(capSuffix[1]);
+        const ctx = capSuffix[2] === 'm' ? n * 1000000 : n * 1024;
+        const base = inferFamily(raw.replace(/\[[0-9]+[km]\]$/, ''));
+        // perModelCap 透传:后缀只声明 ctx,不改该模型的确证输出 cap(deepseek-chat[1m] 仍 cap 8192)
+        return { id: base?.id ?? 'cap-suffix', name: base?.name ?? 'capacity suffix', match: '', contextWindow: ctx, maxTokens: base?.maxTokens ?? 64000, vision: base?.vision, perModelCap: base?.perModelCap };
+    }
+    const id = normalizeId(raw);
+    // ① preset 大表精确(含剥变体尾巴后再试)——精确命中才带 perModelCap(F2 裁决封顶① 证据位;
+    //   ③ 层主干匹配拿的是家族参考行,不是该模型的确证 cap)
+    const hitOf = (m, exact = false) => ({ id: m.famId, name: m.famId, match: '', contextWindow: m.contextWindow, maxTokens: m.maxTokens, ...(exact ? { perModelCap: m.maxTokens } : {}) });
+    const exact = idx.exact.get(id);
+    if (exact)
+        return hitOf(exact, true);
+    const stripped = id.replace(VARIANT_TAIL, '');
+    if (stripped !== id) {
+        const e2 = idx.exact.get(stripped);
+        if (e2)
+            return hitOf(e2, true);
+    }
+    // ② 名内容量提示(moonshot-v1-128k / *-32k):k=×1024
+    const inline = id.match(/-(\d+)([km])\b/);
+    if (inline) {
+        const n = Number(inline[1]);
+        if ((inline[2] === 'k' && n >= 8) || inline[2] === 'm') {
+            const ctx = inline[2] === 'm' ? n * 1000000 : n * 1024;
+            return { id: 'inline-cap', name: 'capacity in id', match: '', contextWindow: ctx, maxTokens: Math.min(ctx, 65536) };
+        }
+    }
+    // ③ 家族主干:候选主干=preset model id 剥变体尾;主干出现在待匹配 id 中,取最长主干
+    let best = null;
+    let bestLen = 0;
+    for (const m of idx.stems) {
+        const stem = m.id.replace(VARIANT_TAIL, '');
+        if (stem.length >= 6 && id.includes(stem)) {
+            // 同长命中取 ctx 最小=家族原生保守值(服务档扩展如 DashScope 1M 让用户在档位里升,
+            // 预填错大比错小危险——超发请求直接被网关拒)
+            if (stem.length > bestLen || (stem.length === bestLen && best && m.contextWindow < best.contextWindow)) {
+                best = m;
+                bestLen = stem.length;
+            }
+        }
+    }
+    if (best)
+        return hitOf(best);
+    // ④ family 表前缀(anchored → unanchored)
+    for (const fam of MODEL_FAMILIES) {
+        if (fam.match && new RegExp(fam.match, 'i').test(id))
+            return fam;
+    }
+    for (const fam of MODEL_FAMILIES) {
+        if (fam.match && new RegExp(fam.match.replace(/\^/g, ''), 'i').test(id))
+            return fam;
+    }
+    return undefined;
+}
+/** Format token counts like "1m" / "384k". */
+export function fmtTokens(n) {
+    // token 界惯例=二进制 K(clay 07-06:32768 显示 33K 是错的,就是 32K;262144=256K)。
+    // 1024 整除走二进制;否则十进制圆整(200000→200k、202800→203k);M 档十进制(1000000→1m)。
+    // #29⑤(prelaunch audit):十进制整千先判 —— 128000 是十进制圆数,必须渲 128k,不是 125k
+    // (128000%1024==0 曾把它劫进二进制档;其它入口全都叫 128K)。32768/262144/393216 不整除 1000,不受影响。
+    if (n >= 1000000 && n % 100000 === 0)
+        return `${n / 1000000}m`;
+    if (n >= 1000 && n % 1000 === 0)
+        return `${n / 1000}k`;
+    if (n >= 1024 && n % 1024 === 0)
+        return `${n / 1024}k`;
+    if (n >= 1000)
+        return `${Math.round(n / 1000)}k`;
+    return String(n);
+}
+/** "1m ctx / 384k out" style short metric text. */
+export function fmtCtxOut(ctx, out) {
+    return `${fmtTokens(ctx)} ctx / ${fmtTokens(out)} out`;
+}
+/** Screen-4 execution-slot recommendation: cheapHint first, else a cheap-sounding sibling. */
+export function pickCheapCandidate(models, defaultId) {
+    const others = models.filter(m => m.id !== defaultId);
+    return (others.find(m => m.cheapHint) ??
+        others.find(m => /flash|mini|lite|turbo|air|haiku|small/i.test(m.id)));
+}