mslxdff 0.1.203 → 0.1.208

package/src/model-capabilities/context-lookup.js

@@ -1,65 +1,65 @@
-// 模型上下文窗口的四级解析（ADR-0054）：/v1/models 富化时唯一真相源。
-// 旧状：顶层 context_length（provider 自报）与 capabilities.context（models.dev）两套并行可能矛盾，
-// 且四层全空时什么都不报；本模块把优先级收死，并保证"双层同源同值"。
-// 纯函数 + env，无 IO 无网络（L1/L2/L4 不依赖目录，冷缓存/目录挂掉照常生效）。
-// L4 方向沿上游 workbuddy2api-hub："未知报 1M——高估比低估安全"（只作元数据，网关转发不读它）。
-
-export const DEFAULT_CONTEXT_FALLBACK = 1_000_000;
-
-/** L4 兜底值：`MSLXDFF_MODEL_CONTEXT_FALLBACK` 覆盖；0/负数 = 关闭兜底（回"未知不报"旧口径）；非法值按默认 1M。 */
-export function contextFallback() {
-  const raw = String(process.env.MSLXDFF_MODEL_CONTEXT_FALLBACK ?? "").trim();
-  if (raw === "") return DEFAULT_CONTEXT_FALLBACK;
-  const n = Number(raw);
-  if (!Number.isFinite(n)) return DEFAULT_CONTEXT_FALLBACK;
-  if (n <= 0) return 0;
-  const f = Math.floor(n);
-  return f > 0 ? f : DEFAULT_CONTEXT_FALLBACK; // (0,1) 被.floor 成 0 会静默变"关兜底"，按非法回默认
-}
-
-function positiveInt(v) {
-  if (typeof v !== "number" && typeof v !== "string") return null; // boolean/数组/对象 = 未自报，不猜
-  const n = Number(v);
-  return Number.isFinite(n) && n > 0 ? Math.floor(n) : null;
-}
-
-/** L1 条目自报（first-party 最准）。键序覆盖现网全部自报形状；非数字/0/负数 = 未自报，丢弃而非钳制。 */
-export function firstPartyContextOf(entry) {
-  if (!entry || typeof entry !== "object") return null;
-  for (const v of [entry.context_length, entry.maxInputTokens, entry.max_input_tokens]) {
-    const n = positiveInt(v);
-    if (n) return n;
-  }
-  const cw = entry.contextWindow;
-  return positiveInt(cw && typeof cw === "object" ? cw.defaultLength : cw);
-}
-
-// L2 内置知识表：给"provider 目录不自报窗口、且值有官方/上游文档出处"的模型补一手。
-// 准入红线（评审过：无据值不得进表——traework 硬编码 131072 正是反面教材，本次已删）：
-//   - key = **实际传入解析器的条目 id 小写**（现网含裸 id 与 `-free` 后缀形态；填表前必须按此对键，
-//     跨 provider 撞名靠带前缀的 id 天然区分），别照 ADR 初稿的 `prov/raw` canonical 形去猜；
-//   - 每条必须带 source 出处注释（文档/上游字段 + 核对日期），给不出出处就让它落 L4 兜底。
-// 首期为空是盘点结论：raccoon/qoder/codearts/workbuddy/globalworkbuddy/qwenwork 系的有据值全部已被 L1 覆盖，
-// 把 L1 复制进表只会制造第二个真相源。等出现"只回 id 的极简目录 provider"之类的真缺口再填。
-export const KNOWN_CONTEXT = Object.freeze({});
-
-/** L2 查表（按条目 id 小写）；未命中或值非法返回 null。`table` 为测试注入口（缺省用内置表）。 */
-export function knownContextOf(id, table = KNOWN_CONTEXT) {
-  const e = table[String(id || "").trim().toLowerCase()];
-  return e ? positiveInt(e.context) : null;
-}
-
-/**
- * 四级解析：L1 自报 > L2 内置表 > L3 models.dev caps > L4 兜底。
- * 返回正整数；env 关闭兜底且 L1–L3 全空时返回 null（调用方两层都不写）。
- * `knownTable` 仅供测试注入假表锁 L2>L3 顺序，生产调用方不传。
- */
-export function resolveContextLength({ entry, id, caps, knownTable } = {}) {
-  const fp = firstPartyContextOf(entry);
-  if (fp) return fp;
-  const known = knownContextOf(id, knownTable);
-  if (known) return known;
-  const c = positiveInt(caps?.context);
-  if (c) return c;
-  return contextFallback() || null;
-}
+// 模型上下文窗口的四级解析（ADR-0054）：/v1/models 富化时唯一真相源。
+// 旧状：顶层 context_length（provider 自报）与 capabilities.context（models.dev）两套并行可能矛盾，
+// 且四层全空时什么都不报；本模块把优先级收死，并保证"双层同源同值"。
+// 纯函数 + env，无 IO 无网络（L1/L2/L4 不依赖目录，冷缓存/目录挂掉照常生效）。
+// L4 方向沿上游 workbuddy2api-hub："未知报 1M——高估比低估安全"（只作元数据，网关转发不读它）。
+
+export const DEFAULT_CONTEXT_FALLBACK = 1_000_000;
+
+/** L4 兜底值：`MSLXDFF_MODEL_CONTEXT_FALLBACK` 覆盖；0/负数 = 关闭兜底（回"未知不报"旧口径）；非法值按默认 1M。 */
+export function contextFallback() {
+  const raw = String(process.env.MSLXDFF_MODEL_CONTEXT_FALLBACK ?? "").trim();
+  if (raw === "") return DEFAULT_CONTEXT_FALLBACK;
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return DEFAULT_CONTEXT_FALLBACK;
+  if (n <= 0) return 0;
+  const f = Math.floor(n);
+  return f > 0 ? f : DEFAULT_CONTEXT_FALLBACK; // (0,1) 被.floor 成 0 会静默变"关兜底"，按非法回默认
+}
+
+function positiveInt(v) {
+  if (typeof v !== "number" && typeof v !== "string") return null; // boolean/数组/对象 = 未自报，不猜
+  const n = Number(v);
+  return Number.isFinite(n) && n > 0 ? Math.floor(n) : null;
+}
+
+/** L1 条目自报（first-party 最准）。键序覆盖现网全部自报形状；非数字/0/负数 = 未自报，丢弃而非钳制。 */
+export function firstPartyContextOf(entry) {
+  if (!entry || typeof entry !== "object") return null;
+  for (const v of [entry.context_length, entry.maxInputTokens, entry.max_input_tokens]) {
+    const n = positiveInt(v);
+    if (n) return n;
+  }
+  const cw = entry.contextWindow;
+  return positiveInt(cw && typeof cw === "object" ? cw.defaultLength : cw);
+}
+
+// L2 内置知识表：给"provider 目录不自报窗口、且值有官方/上游文档出处"的模型补一手。
+// 准入红线（评审过：无据值不得进表——traework 硬编码 131072 正是反面教材，本次已删）：
+//   - key = **实际传入解析器的条目 id 小写**（现网含裸 id 与 `-free` 后缀形态；填表前必须按此对键，
+//     跨 provider 撞名靠带前缀的 id 天然区分），别照 ADR 初稿的 `prov/raw` canonical 形去猜；
+//   - 每条必须带 source 出处注释（文档/上游字段 + 核对日期），给不出出处就让它落 L4 兜底。
+// 首期为空是盘点结论：raccoon/qoder/codearts/workbuddy/globalworkbuddy/qwenwork 系的有据值全部已被 L1 覆盖，
+// 把 L1 复制进表只会制造第二个真相源。等出现"只回 id 的极简目录 provider"之类的真缺口再填。
+export const KNOWN_CONTEXT = Object.freeze({});
+
+/** L2 查表（按条目 id 小写）；未命中或值非法返回 null。`table` 为测试注入口（缺省用内置表）。 */
+export function knownContextOf(id, table = KNOWN_CONTEXT) {
+  const e = table[String(id || "").trim().toLowerCase()];
+  return e ? positiveInt(e.context) : null;
+}
+
+/**
+ * 四级解析：L1 自报 > L2 内置表 > L3 models.dev caps > L4 兜底。
+ * 返回正整数；env 关闭兜底且 L1–L3 全空时返回 null（调用方两层都不写）。
+ * `knownTable` 仅供测试注入假表锁 L2>L3 顺序，生产调用方不传。
+ */
+export function resolveContextLength({ entry, id, caps, knownTable } = {}) {
+  const fp = firstPartyContextOf(entry);
+  if (fp) return fp;
+  const known = knownContextOf(id, knownTable);
+  if (known) return known;
+  const c = positiveInt(caps?.context);
+  if (c) return c;
+  return contextFallback() || null;
+}

package/src/model-capabilities/merge.js

@@ -1,142 +1,142 @@
-// /v1/models 能力富化（ADR-0022 + ADR-0054）：把 models.dev 目录（+ workbuddy 原生字段兜底）
-// 的能力合并进每条 data 条目的 `capabilities` 子对象；上下文窗口由 context-lookup 四级解析
-// 统一裁决并双层同源写入（顶层 context_length 与 capabilities.context 恒同值）。
-// 逃生门：GET /v1/models?raw=1 保持 ADR-0016 的原始透传形状；codex 调用者恒原始 + 空 models:[]。
-// 全程 best-effort：富化失败不阻塞 /models，context 一致化不依赖目录（冷缓存照常生效）。
-import { globalCapabilities } from "./index.js";
-import { resolveContextLength } from "./context-lookup.js";
-
-// "cline/deepseek/deepseek-v4-flash" → { provider: "cline", raw: "deepseek/deepseek-v4-flash" }；裸 id 归 opencode
-export function splitModelId(id) {
-  const s = String(id || "").trim();
-  const i = s.indexOf("/");
-  if (i > 0) return { provider: s.slice(0, i).toLowerCase(), raw: s.slice(i + 1) };
-  return { provider: "opencode", raw: s };
-}
-
-function stripFreeSuffix(raw) {
-  return raw.replace(/-free$/i, "");
-}
-
-// 上游原生 wire API：muse-spark* 只认 /responses（zen /chat 500 实测）；
-// models.dev 标 npm @ai-sdk/openai 的模型上游走 responses；其余 chat。
-export function upstreamApiFor(caps, raw) {
-  const bare = stripFreeSuffix(String(raw || ""));
-  if (/^muse-spark/i.test(bare)) return "responses";
-  if (caps?.npm === "@ai-sdk/openai") return "responses";
-  return "chat";
-}
-
-// caps → 对外 capabilities 子对象（只填有值的键，未收录字段不硬造）
-export function capsPayloadFor(caps, raw) {
-  if (!caps) return null;
-  const payload = {
-    reasoning: Boolean(caps.reasoning),
-    ...(caps.effortType ? { effortType: caps.effortType } : {}),
-    ...(Array.isArray(caps.effortValues) && caps.effortValues.length
-      ? { effortValues: caps.effortValues.map(String) }
-      : {}),
-    ...(caps.defaultEffort ? { defaultEffort: String(caps.defaultEffort) } : {}),
-    imageInput: Boolean(caps.imageInput),
-    inputModalities: Array.isArray(caps.inputModalities) && caps.inputModalities.length
-      ? caps.inputModalities
-      : ["text"],
-    outputModalities: Array.isArray(caps.outputModalities) && caps.outputModalities.length
-      ? caps.outputModalities
-      : ["text"],
-    toolCall: Boolean(caps.toolCall),
-    ...(Number(caps.context) > 0 ? { context: Number(caps.context) } : {}),
-    ...(Number(caps.maxOutput) > 0 ? { maxOutput: Number(caps.maxOutput) } : {}),
-    ...((caps.costIn != null || caps.costOut != null)
-      ? { costIn: Number(caps.costIn) || 0, costOut: Number(caps.costOut) || 0 }
-      : {}),
-    // 网关两侧端点都收：/v1/responses 复用 ChatPipeline 翻译层；upstreamApi 记上游原生协议
-    endpoints: ["chat", "responses"],
-    upstreamApi: upstreamApiFor(caps, raw),
-  };
-  return payload;
-}
-
-// 单条 id 的目录匹配：精确裸 id → 剥 -free 后缀 → 二级厂商前缀（cline/deepseek/x → deepseek/x）
-function lookupCaps(svc, provider, raw) {
-  return (
-    svc.get(provider, raw) ||
-    svc.get(provider, stripFreeSuffix(raw)) ||
-    null
-  );
-}
-
-function lookupCapsDeep(svc, provider, raw) {
-  const direct = lookupCaps(svc, provider, raw);
-  if (direct) return direct;
-  const parts = raw.split("/");
-  if (parts.length >= 2) {
-    const head = parts[0];
-    const rest = parts.slice(1).join("/");
-    return svc.get(head, rest) || svc.get(head, stripFreeSuffix(rest)) || null;
-  }
-  return null;
-}
-
-/**
- * 把能力合并进 { object:"list", data:[...] } 的每条条目。
- * capsSvc/wbSource 为测试接缝；生产用全局单例（models.dev 24h 缓存）+ workbuddy 动态源。
- * wbSource 显式 null 禁用 workbuddy 兜底（测试用）。
- */
-export async function mergeModelsList(data, { capsSvc, wbSource } = {}) {
-  const entries = Array.isArray(data?.data) ? data.data : [];
-  if (!entries.length) return data;
-  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
-  // 目录冷缓存/抛错不阻塞：context 一致化（L1/L2/L4）不依赖目录，照常生效（ADR-0054）
-  let catalogReady = false;
-  if (svc) {
-    try {
-      catalogReady = svc.readyWarm ? await svc.readyWarm() : await svc.ready();
-    } catch {
-      catalogReady = false;
-    }
-  }
-  // L3 目录直查（仅就绪时）；workbuddy 未命中第二遍走上游原生字段
-  const resolved = new Map(); // index -> caps
-  if (catalogReady) {
-    const needWb = []; // [index, raw]
-    entries.forEach((entry, i) => {
-      const id = String(entry?.id || "");
-      if (!id) return;
-      const { provider, raw } = splitModelId(id);
-      const caps = lookupCapsDeep(svc, provider, raw);
-      if (caps) resolved.set(i, caps);
-      else if (provider === "workbuddy" && wbSource !== null) needWb.push([i, raw]);
-    });
-    if (needWb.length) {
-      try {
-        const { workbuddyCapsFromModels, workbuddyAllModels } = await import("./index.js");
-        const wbMap = await workbuddyCapsFromModels(wbSource || workbuddyAllModels)();
-        for (const [i, raw] of needWb) {
-          const caps = wbMap?.[raw] || null;
-          if (caps) resolved.set(i, caps);
-        }
-      } catch {
-        // workbuddy 源不可用：这些条目保持无能力，不拖垮整个列表
-      }
-    }
-  }
-  // 产物：capabilities（caps 语义字段 + 解析出的 context）+ 顶层 context_length 同源同值（ADR-0054 决定 2：
-  // 两层要么同写要么同不写，绝不给客户端两种答案）；caps 未命中只补 { context }，不硬造能力声明（能力不知道就沉默）
-  const next = entries.map((entry, i) => {
-    if (!entry || typeof entry !== "object") return entry; // 异形条目原样透传，不凭空造成员
-    const caps = resolved.get(i) || null;
-    const ctx = resolveContextLength({ entry, id: String(entry?.id || ""), caps });
-    if (!caps && !ctx) return entry; // env 关兜底 + 全未命中：回旧口径
-    const { raw } = splitModelId(String(entry?.id || ""));
-    const capsPart = caps ? capsPayloadFor(caps, raw) : null;
-    const capabilities = capsPart
-      ? (ctx ? { ...capsPart, context: ctx } : capsPart)
-      : (ctx ? { context: ctx } : null);
-    if (!capabilities) return entry;
-    const out = ctx ? { ...entry, context_length: ctx } : { ...entry };
-    out.capabilities = capabilities;
-    return out;
-  });
-  return { ...data, data: next };
-}
+// /v1/models 能力富化（ADR-0022 + ADR-0054）：把 models.dev 目录（+ workbuddy 原生字段兜底）
+// 的能力合并进每条 data 条目的 `capabilities` 子对象；上下文窗口由 context-lookup 四级解析
+// 统一裁决并双层同源写入（顶层 context_length 与 capabilities.context 恒同值）。
+// 逃生门：GET /v1/models?raw=1 保持 ADR-0016 的原始透传形状；codex 调用者恒原始 + 空 models:[]。
+// 全程 best-effort：富化失败不阻塞 /models，context 一致化不依赖目录（冷缓存照常生效）。
+import { globalCapabilities } from "./index.js";
+import { resolveContextLength } from "./context-lookup.js";
+
+// "cline/deepseek/deepseek-v4-flash" → { provider: "cline", raw: "deepseek/deepseek-v4-flash" }；裸 id 归 opencode
+export function splitModelId(id) {
+  const s = String(id || "").trim();
+  const i = s.indexOf("/");
+  if (i > 0) return { provider: s.slice(0, i).toLowerCase(), raw: s.slice(i + 1) };
+  return { provider: "opencode", raw: s };
+}
+
+function stripFreeSuffix(raw) {
+  return raw.replace(/-free$/i, "");
+}
+
+// 上游原生 wire API：muse-spark* 只认 /responses（zen /chat 500 实测）；
+// models.dev 标 npm @ai-sdk/openai 的模型上游走 responses；其余 chat。
+export function upstreamApiFor(caps, raw) {
+  const bare = stripFreeSuffix(String(raw || ""));
+  if (/^muse-spark/i.test(bare)) return "responses";
+  if (caps?.npm === "@ai-sdk/openai") return "responses";
+  return "chat";
+}
+
+// caps → 对外 capabilities 子对象（只填有值的键，未收录字段不硬造）
+export function capsPayloadFor(caps, raw) {
+  if (!caps) return null;
+  const payload = {
+    reasoning: Boolean(caps.reasoning),
+    ...(caps.effortType ? { effortType: caps.effortType } : {}),
+    ...(Array.isArray(caps.effortValues) && caps.effortValues.length
+      ? { effortValues: caps.effortValues.map(String) }
+      : {}),
+    ...(caps.defaultEffort ? { defaultEffort: String(caps.defaultEffort) } : {}),
+    imageInput: Boolean(caps.imageInput),
+    inputModalities: Array.isArray(caps.inputModalities) && caps.inputModalities.length
+      ? caps.inputModalities
+      : ["text"],
+    outputModalities: Array.isArray(caps.outputModalities) && caps.outputModalities.length
+      ? caps.outputModalities
+      : ["text"],
+    toolCall: Boolean(caps.toolCall),
+    ...(Number(caps.context) > 0 ? { context: Number(caps.context) } : {}),
+    ...(Number(caps.maxOutput) > 0 ? { maxOutput: Number(caps.maxOutput) } : {}),
+    ...((caps.costIn != null || caps.costOut != null)
+      ? { costIn: Number(caps.costIn) || 0, costOut: Number(caps.costOut) || 0 }
+      : {}),
+    // 网关两侧端点都收：/v1/responses 复用 ChatPipeline 翻译层；upstreamApi 记上游原生协议
+    endpoints: ["chat", "responses"],
+    upstreamApi: upstreamApiFor(caps, raw),
+  };
+  return payload;
+}
+
+// 单条 id 的目录匹配：精确裸 id → 剥 -free 后缀 → 二级厂商前缀（cline/deepseek/x → deepseek/x）
+function lookupCaps(svc, provider, raw) {
+  return (
+    svc.get(provider, raw) ||
+    svc.get(provider, stripFreeSuffix(raw)) ||
+    null
+  );
+}
+
+function lookupCapsDeep(svc, provider, raw) {
+  const direct = lookupCaps(svc, provider, raw);
+  if (direct) return direct;
+  const parts = raw.split("/");
+  if (parts.length >= 2) {
+    const head = parts[0];
+    const rest = parts.slice(1).join("/");
+    return svc.get(head, rest) || svc.get(head, stripFreeSuffix(rest)) || null;
+  }
+  return null;
+}
+
+/**
+ * 把能力合并进 { object:"list", data:[...] } 的每条条目。
+ * capsSvc/wbSource 为测试接缝；生产用全局单例（models.dev 24h 缓存）+ workbuddy 动态源。
+ * wbSource 显式 null 禁用 workbuddy 兜底（测试用）。
+ */
+export async function mergeModelsList(data, { capsSvc, wbSource } = {}) {
+  const entries = Array.isArray(data?.data) ? data.data : [];
+  if (!entries.length) return data;
+  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
+  // 目录冷缓存/抛错不阻塞：context 一致化（L1/L2/L4）不依赖目录，照常生效（ADR-0054）
+  let catalogReady = false;
+  if (svc) {
+    try {
+      catalogReady = svc.readyWarm ? await svc.readyWarm() : await svc.ready();
+    } catch {
+      catalogReady = false;
+    }
+  }
+  // L3 目录直查（仅就绪时）；workbuddy 未命中第二遍走上游原生字段
+  const resolved = new Map(); // index -> caps
+  if (catalogReady) {
+    const needWb = []; // [index, raw]
+    entries.forEach((entry, i) => {
+      const id = String(entry?.id || "");
+      if (!id) return;
+      const { provider, raw } = splitModelId(id);
+      const caps = lookupCapsDeep(svc, provider, raw);
+      if (caps) resolved.set(i, caps);
+      else if (provider === "workbuddy" && wbSource !== null) needWb.push([i, raw]);
+    });
+    if (needWb.length) {
+      try {
+        const { workbuddyCapsFromModels, workbuddyAllModels } = await import("./index.js");
+        const wbMap = await workbuddyCapsFromModels(wbSource || workbuddyAllModels)();
+        for (const [i, raw] of needWb) {
+          const caps = wbMap?.[raw] || null;
+          if (caps) resolved.set(i, caps);
+        }
+      } catch {
+        // workbuddy 源不可用：这些条目保持无能力，不拖垮整个列表
+      }
+    }
+  }
+  // 产物：capabilities（caps 语义字段 + 解析出的 context）+ 顶层 context_length 同源同值（ADR-0054 决定 2：
+  // 两层要么同写要么同不写，绝不给客户端两种答案）；caps 未命中只补 { context }，不硬造能力声明（能力不知道就沉默）
+  const next = entries.map((entry, i) => {
+    if (!entry || typeof entry !== "object") return entry; // 异形条目原样透传，不凭空造成员
+    const caps = resolved.get(i) || null;
+    const ctx = resolveContextLength({ entry, id: String(entry?.id || ""), caps });
+    if (!caps && !ctx) return entry; // env 关兜底 + 全未命中：回旧口径
+    const { raw } = splitModelId(String(entry?.id || ""));
+    const capsPart = caps ? capsPayloadFor(caps, raw) : null;
+    const capabilities = capsPart
+      ? (ctx ? { ...capsPart, context: ctx } : capsPart)
+      : (ctx ? { context: ctx } : null);
+    if (!capabilities) return entry;
+    const out = ctx ? { ...entry, context_length: ctx } : { ...entry };
+    out.capabilities = capabilities;
+    return out;
+  });
+  return { ...data, data: next };
+}