mslxdff 0.1.170 → 0.1.172

package/src/model-capabilities/index.js

@@ -1,183 +1,183 @@
-// 模型能力目录服务（opencode 官方同源 models.dev）：fetch + 磁盘缓存 + TTL + staleness 降级
-// 源：https://models.opencode.ai/api.json（opencode core models-dev.ts:160 同款；备选 https://models.dev/api.json）
-// 形状：{ [providerId]: { models: { [modelId]: raw } } }；mslxdff 裸 id 归 opencode，`prov/id` 前缀路由到对应 provider
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { normalizeProviderModels, normalizeWorkbuddyCaps } from "./parse.js";
-import { compatFetch } from "../compat.js";
-
-export const DEFAULT_SOURCE_URL = "https://models.opencode.ai/api.json";
-
-export function sourceUrl() {
-  const raw = process.env.MSLXDFF_MODELS_DEV_URL;
-  return raw && String(raw).trim() ? String(raw).trim() : DEFAULT_SOURCE_URL;
-}
-
-export function ttlMs() {
-  const n = Number(process.env.MSLXDFF_MODELS_DEV_TTL_MS);
-  return Number.isInteger(n) && n >= 0 ? n : 86_400_000; // 默认 24h
-}
-
-export function createCapabilitiesService({
-  fetchImpl = compatFetch,
-  cacheFile = "",
-  ttlMs: ttl = ttlMs(),
-  url = sourceUrl(),
-  now = Date.now,
-} = {}) {
-  let raw = null;          // 原始目录（全 provider）
-  let capsIndex = new Map(); // providerId -> { modelId -> caps }
-  let npmIndex = new Map();  // opencode 裸 modelId -> provider.npm（responses 判定用；null = 继承默认）
-  let loadedAt = 0;
-  let inflight = null;
-
-  function buildIndex(data) {
-    const idx = new Map();
-    const npm = new Map();
-    for (const [pid, p] of Object.entries(data || {})) {
-      if (!p || typeof p !== "object") continue;
-      const caps = normalizeProviderModels(p.models || {});
-      idx.set(pid, caps);
-      if (String(pid).toLowerCase() === "opencode") {
-        for (const [mid, c] of Object.entries(caps)) npm.set(mid, c.npm ?? null);
-      }
-    }
-    npmIndex = npm;
-    return idx;
-  }
-
-  function readCache() {
-    if (!cacheFile) return null;
-    try { return JSON.parse(readFileSync(cacheFile, "utf8")); } catch { return null; }
-  }
-
-  function writeCache(data) {
-    if (!cacheFile || !data) return;
-    try {
-      mkdirSync(dirname(cacheFile), { recursive: true });
-      writeFileSync(cacheFile, JSON.stringify(data));
-    } catch { /* 缓存失败不致命 */ }
-  }
-
-  async function fetchFresh() {
-    const res = await fetchImpl(url, { headers: { Accept: "application/json" } });
-    if (!res?.ok) throw new Error(`models.dev fetch ${res?.status || "network"}`);
-    return res.json();
-  }
-
-  // ready：缓存新鲜直接用；否则拉新；失败回退旧缓存（含磁盘），完全无数据才抛
-  async function ready() {
-    const t = now();
-    if (raw && t - loadedAt < ttl) return;
-    if (inflight) return inflight;
-    inflight = (async () => {
-      try {
-        const data = await fetchFresh();
-        raw = data;
-        capsIndex = buildIndex(data);
-        loadedAt = t;
-        writeCache(data);
-      } catch (e) {
-        if (raw) return; // 内存还有旧的，继续用
-        const disk = readCache();
-        if (disk) {
-          raw = disk;
-          capsIndex = buildIndex(disk);
-          loadedAt = t; // 视作刚加载，避免每请求都重试打上游
-          return;
-        }
-        throw e;
-      } finally {
-        inflight = null;
-      }
-    })();
-    return inflight;
-  }
-
-  function capsFor(pid) {
-    return capsIndex.get(pid) || null;
-  }
-
-  function get(providerId, modelId) {
-    const pid = String(providerId || "opencode").toLowerCase();
-    const mid = String(modelId || "");
-    const map = capsFor(pid);
-    if (!map) return null;
-    return map[mid] || null;
-  }
-
-  function list(providerId) {
-    const pid = String(providerId || "opencode").toLowerCase();
-    const map = capsFor(pid);
-    if (!map) return [];
-    return Object.entries(map).map(([id, capabilities]) => ({ id, capabilities }));
-  }
-
-  function providers() {
-    return [...capsIndex.keys()].sort();
-  }
-  // readyWarm：仅用内存/磁盘缓存热身，绝不网络请求。/models 富化用它避免冷启动阻塞；
-  // 冷缓存时后台拉新（不 await），下次请求即富化。
-  async function readyWarm() {
-    const t = now();
-    if (raw && t - loadedAt < ttl) return true;
-    const disk = readCache();
-    if (disk) {
-      raw = disk;
-      capsIndex = buildIndex(disk);
-      loadedAt = t;
-      return true;
-    }
-    ready().catch(() => {}); // 后台拉新，失败静默（/models 原样降级）
-    return false;
-  }
-  return { ready, readyWarm, get, list, providers, npmIndex: () => new Map(npmIndex) };
-}
-
-// 模块级单例：HTTP handler 懒加载，测试 _reset 后注入
-let _global = null;
-export function globalCapabilities() {
-  if (!_global) _global = createCapabilitiesService({ cacheFile: defaultCacheFile() });
-  return _global;
-}
-export function _resetGlobalCapabilities() { _global = null; }
-// 缓存落盘位置：MSLXDFF_MODELS_DEV_CACHE 覆盖 > ~/.config/mslxdff/models-dev.json（与 state 同目录）
-function defaultCacheFile() {
-  const override = process.env.MSLXDFF_MODELS_DEV_CACHE;
-  if (override && String(override).trim()) return String(override).trim();
-  return join(homedir(), ".config", "mslxdff", "models-dev.json");
-}
-
-// workbuddy 动态源：从聚合模型服务（models.get()，带 10min 上游缓存）拉 workbuddy/ 前缀条目
-// → 统一 caps 形状 map（{ rawId -> caps }）。上游原生字段 first-party 最准，不走 models.dev。
-export function workbuddyCapsFromModels(getModels, normalizeFn) {
-  const normalize = normalizeFn || ((m) => normalizeWorkbuddyCaps(m.id, m));
-  return async () => {
-    const agg = await getModels();
-    const all = Array.isArray(agg?.data) ? agg.data : [];
-    const map = {};
-    for (const entry of all) {
-      const id = String(entry?.id || "");
-      if (!id.toLowerCase().startsWith("workbuddy/")) continue;
-      const raw = id.slice("workbuddy/".length);
-      if (!raw) continue;
-      map[raw] = normalize(entry);
-    }
-    return map;
-  };
-}
-
-// workbuddy provider 单例（直连上游 listModels 自带 10min 缓存）：HTTP handler 与
-// -setto opencode 能力注入共享同一个实例，避免双份连接池/缓存。
-let _wbProv = null;
-export function _resetWorkbuddyProv() { _wbProv = null; }
-export async function workbuddyAllModels() {
-  if (!_wbProv) {
-    const { createWorkbuddyProvider } = await import("../providers/workbuddy.js");
-    const { defaultStateFile } = await import("../state.js");
-    _wbProv = createWorkbuddyProvider({ file: defaultStateFile() });
-  }
-  const list = await _wbProv.listModels();
-  return { object: "list", data: Array.isArray(list) ? list : [] };
-}
+// 模型能力目录服务（opencode 官方同源 models.dev）：fetch + 磁盘缓存 + TTL + staleness 降级
+// 源：https://models.opencode.ai/api.json（opencode core models-dev.ts:160 同款；备选 https://models.dev/api.json）
+// 形状：{ [providerId]: { models: { [modelId]: raw } } }；mslxdff 裸 id 归 opencode，`prov/id` 前缀路由到对应 provider
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { normalizeProviderModels, normalizeWorkbuddyCaps } from "./parse.js";
+import { compatFetch } from "../compat.js";
+
+export const DEFAULT_SOURCE_URL = "https://models.opencode.ai/api.json";
+
+export function sourceUrl() {
+  const raw = process.env.MSLXDFF_MODELS_DEV_URL;
+  return raw && String(raw).trim() ? String(raw).trim() : DEFAULT_SOURCE_URL;
+}
+
+export function ttlMs() {
+  const n = Number(process.env.MSLXDFF_MODELS_DEV_TTL_MS);
+  return Number.isInteger(n) && n >= 0 ? n : 86_400_000; // 默认 24h
+}
+
+export function createCapabilitiesService({
+  fetchImpl = compatFetch,
+  cacheFile = "",
+  ttlMs: ttl = ttlMs(),
+  url = sourceUrl(),
+  now = Date.now,
+} = {}) {
+  let raw = null;          // 原始目录（全 provider）
+  let capsIndex = new Map(); // providerId -> { modelId -> caps }
+  let npmIndex = new Map();  // opencode 裸 modelId -> provider.npm（responses 判定用；null = 继承默认）
+  let loadedAt = 0;
+  let inflight = null;
+
+  function buildIndex(data) {
+    const idx = new Map();
+    const npm = new Map();
+    for (const [pid, p] of Object.entries(data || {})) {
+      if (!p || typeof p !== "object") continue;
+      const caps = normalizeProviderModels(p.models || {});
+      idx.set(pid, caps);
+      if (String(pid).toLowerCase() === "opencode") {
+        for (const [mid, c] of Object.entries(caps)) npm.set(mid, c.npm ?? null);
+      }
+    }
+    npmIndex = npm;
+    return idx;
+  }
+
+  function readCache() {
+    if (!cacheFile) return null;
+    try { return JSON.parse(readFileSync(cacheFile, "utf8")); } catch { return null; }
+  }
+
+  function writeCache(data) {
+    if (!cacheFile || !data) return;
+    try {
+      mkdirSync(dirname(cacheFile), { recursive: true });
+      writeFileSync(cacheFile, JSON.stringify(data));
+    } catch { /* 缓存失败不致命 */ }
+  }
+
+  async function fetchFresh() {
+    const res = await fetchImpl(url, { headers: { Accept: "application/json" } });
+    if (!res?.ok) throw new Error(`models.dev fetch ${res?.status || "network"}`);
+    return res.json();
+  }
+
+  // ready：缓存新鲜直接用；否则拉新；失败回退旧缓存（含磁盘），完全无数据才抛
+  async function ready() {
+    const t = now();
+    if (raw && t - loadedAt < ttl) return;
+    if (inflight) return inflight;
+    inflight = (async () => {
+      try {
+        const data = await fetchFresh();
+        raw = data;
+        capsIndex = buildIndex(data);
+        loadedAt = t;
+        writeCache(data);
+      } catch (e) {
+        if (raw) return; // 内存还有旧的，继续用
+        const disk = readCache();
+        if (disk) {
+          raw = disk;
+          capsIndex = buildIndex(disk);
+          loadedAt = t; // 视作刚加载，避免每请求都重试打上游
+          return;
+        }
+        throw e;
+      } finally {
+        inflight = null;
+      }
+    })();
+    return inflight;
+  }
+
+  function capsFor(pid) {
+    return capsIndex.get(pid) || null;
+  }
+
+  function get(providerId, modelId) {
+    const pid = String(providerId || "opencode").toLowerCase();
+    const mid = String(modelId || "");
+    const map = capsFor(pid);
+    if (!map) return null;
+    return map[mid] || null;
+  }
+
+  function list(providerId) {
+    const pid = String(providerId || "opencode").toLowerCase();
+    const map = capsFor(pid);
+    if (!map) return [];
+    return Object.entries(map).map(([id, capabilities]) => ({ id, capabilities }));
+  }
+
+  function providers() {
+    return [...capsIndex.keys()].sort();
+  }
+  // readyWarm：仅用内存/磁盘缓存热身，绝不网络请求。/models 富化用它避免冷启动阻塞；
+  // 冷缓存时后台拉新（不 await），下次请求即富化。
+  async function readyWarm() {
+    const t = now();
+    if (raw && t - loadedAt < ttl) return true;
+    const disk = readCache();
+    if (disk) {
+      raw = disk;
+      capsIndex = buildIndex(disk);
+      loadedAt = t;
+      return true;
+    }
+    ready().catch(() => {}); // 后台拉新，失败静默（/models 原样降级）
+    return false;
+  }
+  return { ready, readyWarm, get, list, providers, npmIndex: () => new Map(npmIndex) };
+}
+
+// 模块级单例：HTTP handler 懒加载，测试 _reset 后注入
+let _global = null;
+export function globalCapabilities() {
+  if (!_global) _global = createCapabilitiesService({ cacheFile: defaultCacheFile() });
+  return _global;
+}
+export function _resetGlobalCapabilities() { _global = null; }
+// 缓存落盘位置：MSLXDFF_MODELS_DEV_CACHE 覆盖 > ~/.config/mslxdff/models-dev.json（与 state 同目录）
+function defaultCacheFile() {
+  const override = process.env.MSLXDFF_MODELS_DEV_CACHE;
+  if (override && String(override).trim()) return String(override).trim();
+  return join(homedir(), ".config", "mslxdff", "models-dev.json");
+}
+
+// workbuddy 动态源：从聚合模型服务（models.get()，带 10min 上游缓存）拉 workbuddy/ 前缀条目
+// → 统一 caps 形状 map（{ rawId -> caps }）。上游原生字段 first-party 最准，不走 models.dev。
+export function workbuddyCapsFromModels(getModels, normalizeFn) {
+  const normalize = normalizeFn || ((m) => normalizeWorkbuddyCaps(m.id, m));
+  return async () => {
+    const agg = await getModels();
+    const all = Array.isArray(agg?.data) ? agg.data : [];
+    const map = {};
+    for (const entry of all) {
+      const id = String(entry?.id || "");
+      if (!id.toLowerCase().startsWith("workbuddy/")) continue;
+      const raw = id.slice("workbuddy/".length);
+      if (!raw) continue;
+      map[raw] = normalize(entry);
+    }
+    return map;
+  };
+}
+
+// workbuddy provider 单例（直连上游 listModels 自带 10min 缓存）：HTTP handler 与
+// -setto opencode 能力注入共享同一个实例，避免双份连接池/缓存。
+let _wbProv = null;
+export function _resetWorkbuddyProv() { _wbProv = null; }
+export async function workbuddyAllModels() {
+  if (!_wbProv) {
+    const { createWorkbuddyProvider } = await import("../providers/workbuddy.js");
+    const { defaultStateFile } = await import("../state.js");
+    _wbProv = createWorkbuddyProvider({ file: defaultStateFile() });
+  }
+  const list = await _wbProv.listModels();
+  return { object: "list", data: Array.isArray(list) ? list : [] };
+}

package/src/model-capabilities/merge.js

@@ -1,8 +1,10 @@
-// /v1/models 能力富化（ADR-0022）：把 models.dev 目录（+ workbuddy 原生字段兜底）
-// 的能力合并进 /v1/models 每条 data 条目的 `capabilities` 子对象，客户端与 CLI 一眼可读。
+// /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 因富化失败挂掉。
+// 全程 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) {
@@ -82,46 +84,59 @@ function lookupCapsDeep(svc, provider, raw) {
  * wbSource 显式 null 禁用 workbuddy 兜底（测试用）。
  */
 export async function mergeModelsList(data, { capsSvc, wbSource } = {}) {
-  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
   const entries = Array.isArray(data?.data) ? data.data : [];
-  if (!svc || !entries.length) return data;
-  // 只用内存/磁盘缓存热身；冷缓存绝不阻塞请求（后台拉新，下次请求即富化）
-  try {
-    const warmed = svc.readyWarm ? await svc.readyWarm() : await svc.ready();
-    if (!warmed) return data;
-  } catch {
-    return 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;
+    }
   }
-  // 第一遍：目录直查；workbuddy 未命中记下，第二遍走上游原生字段
+  // L3 目录直查（仅就绪时）；workbuddy 未命中第二遍走上游原生字段
   const resolved = new Map(); // index -> caps
-  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);
+  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 源不可用：这些条目保持无能力，不拖垮整个列表
       }
-    } catch {
-      // workbuddy 源不可用：这些条目保持无能力，不拖垮整个列表
     }
   }
-  if (!resolved.size) return data;
+  // 产物：capabilities（caps 语义字段 + 解析出的 context）+ 顶层 context_length 同源同值（ADR-0054 决定 2：
+  // 两层要么同写要么同不写，绝不给客户端两种答案）；caps 未命中只补 { context }，不硬造能力声明（能力不知道就沉默）
   const next = entries.map((entry, i) => {
-    const caps = resolved.get(i);
-    if (!caps) return entry;
+    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 payload = capsPayloadFor(caps, raw);
-    return payload ? { ...entry, capabilities: payload } : entry;
+    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 };
 }

package/src/model-capabilities/parse.js

@@ -1,70 +1,70 @@
-// models.dev 能力目录 → mslxdff 能力形状的纯函数解析层（无 IO，测试接缝 S1）
-// 源数据形态（实测 models.opencode.ai/api.json 2026-09-11）：
-//   reasoning_options: [{type:"effort",values:["low","medium","high","max"]} | {type:"toggle"} | {type:"budget_tokens",min}]
-//   modalities.input 含 "image" 即可读图；limit.context/output；cost.input/output 为 $/M tokens
-export function normalizeModelCaps(_id, m) {
-  const opts = Array.isArray(m?.reasoning_options) ? m.reasoning_options : [];
-  const effort = opts.find((o) => o?.type === "effort");
-  const toggle = opts.some((o) => o?.type === "toggle");
-  const budget = opts.find((o) => o?.type === "budget_tokens");
-  const input = Array.isArray(m?.modalities?.input) ? m.modalities.input : [];
-  return {
-    reasoning: Boolean(m?.reasoning),
-    effortType: effort ? "effort" : toggle ? "toggle" : budget ? "budget_tokens" : null,
-    effortValues: effort && Array.isArray(effort.values) ? effort.values.map(String) : null,
-    imageInput: input.includes("image"),
-    toolCall: Boolean(m?.tool_call),
-    context: Number(m?.limit?.context) || null,
-    maxOutput: Number(m?.limit?.output) || null,
-    costIn: Number(m?.cost?.input) || null,
-    costOut: Number(m?.cost?.output) || null,
-    // opencode Model 形状补充字段（-setto opencode 条目注入用）
-    attachment: Boolean(m?.attachment),
-    temperature: Boolean(m?.temperature),
-    releaseDate: typeof m?.release_date === "string" && m.release_date ? m.release_date : null,
-    inputModalities: input.length ? input : ["text"],
-    outputModalities: Array.isArray(m?.modalities?.output) && m.modalities.output.length ? m.modalities.output : ["text"],
-    // 模型级 SDK 覆盖（models.dev provider.npm）：@ai-sdk/openai → responses 端点；null = 继承 provider 默认
-    npm: typeof m?.provider?.npm === "string" && m.provider.npm ? m.provider.npm : null,
-  };
-}
-
-// provider.models 对象（{ [modelId]: rawModel }）→ { [modelId]: caps }
-export function normalizeProviderModels(modelsObj) {
-  const out = {};
-  if (!modelsObj || typeof modelsObj !== "object") return out;
-  for (const [id, m] of Object.entries(modelsObj)) {
-    if (!m || typeof m !== "object") continue;
-    out[id] = normalizeModelCaps(id, m);
-  }
-  return out;
-}
-
-// workbuddy 上游原生字段（/v3/config 产品文档，first-party 最准）→ 统一 caps 形状
-// 实测字段（2026-09-11，29 模型全覆盖）：maxInputTokens/maxOutputTokens/supportsImages/
-// supportsReasoning/reasoning{effort,summary}/supportsToolCall/disabledMultimodal/credits/tags/name/vendor
-// reasoning 是"当前档位"非档位列表 → effortType=effort 但 effortValues=null、defaultEffort 记默认档
-export function normalizeWorkbuddyCaps(_id, m) {
-  const imageOk = Boolean(m?.supportsImages) && !m?.disabledMultimodal;
-  const reasoning = Boolean(m?.supportsReasoning);
-  const effort = reasoning && m?.reasoning && typeof m.reasoning === "object" ? String(m.reasoning.effort || "").trim() : "";
-  return {
-    reasoning,
-    effortType: reasoning ? "effort" : null,
-    // 上游只给当前档位不给档位列表；实测 hy3 reasoning_effort low/high 均生效（思考块 99 vs 210），
-    // 网关层按 OpenAI 兼容标准给通用三档（上游不识别时忽略，无害）
-    effortValues: reasoning ? ["low", "medium", "high"] : null,
-    defaultEffort: effort || null,
-    imageInput: imageOk,
-    toolCall: Boolean(m?.supportsToolCall),
-    context: Number(m?.maxInputTokens) || null,
-    maxOutput: Number(m?.maxOutputTokens) || null,
-    costIn: null,
-    costOut: null,
-    attachment: false,
-    temperature: m?.temperature != null,
-    releaseDate: null,
-    inputModalities: imageOk ? ["text", "image"] : ["text"],
-    outputModalities: ["text"],
-  };
-}
+// models.dev 能力目录 → mslxdff 能力形状的纯函数解析层（无 IO，测试接缝 S1）
+// 源数据形态（实测 models.opencode.ai/api.json 2026-09-11）：
+//   reasoning_options: [{type:"effort",values:["low","medium","high","max"]} | {type:"toggle"} | {type:"budget_tokens",min}]
+//   modalities.input 含 "image" 即可读图；limit.context/output；cost.input/output 为 $/M tokens
+export function normalizeModelCaps(_id, m) {
+  const opts = Array.isArray(m?.reasoning_options) ? m.reasoning_options : [];
+  const effort = opts.find((o) => o?.type === "effort");
+  const toggle = opts.some((o) => o?.type === "toggle");
+  const budget = opts.find((o) => o?.type === "budget_tokens");
+  const input = Array.isArray(m?.modalities?.input) ? m.modalities.input : [];
+  return {
+    reasoning: Boolean(m?.reasoning),
+    effortType: effort ? "effort" : toggle ? "toggle" : budget ? "budget_tokens" : null,
+    effortValues: effort && Array.isArray(effort.values) ? effort.values.map(String) : null,
+    imageInput: input.includes("image"),
+    toolCall: Boolean(m?.tool_call),
+    context: Number(m?.limit?.context) || null,
+    maxOutput: Number(m?.limit?.output) || null,
+    costIn: Number(m?.cost?.input) || null,
+    costOut: Number(m?.cost?.output) || null,
+    // opencode Model 形状补充字段（-setto opencode 条目注入用）
+    attachment: Boolean(m?.attachment),
+    temperature: Boolean(m?.temperature),
+    releaseDate: typeof m?.release_date === "string" && m.release_date ? m.release_date : null,
+    inputModalities: input.length ? input : ["text"],
+    outputModalities: Array.isArray(m?.modalities?.output) && m.modalities.output.length ? m.modalities.output : ["text"],
+    // 模型级 SDK 覆盖（models.dev provider.npm）：@ai-sdk/openai → responses 端点；null = 继承 provider 默认
+    npm: typeof m?.provider?.npm === "string" && m.provider.npm ? m.provider.npm : null,
+  };
+}
+
+// provider.models 对象（{ [modelId]: rawModel }）→ { [modelId]: caps }
+export function normalizeProviderModels(modelsObj) {
+  const out = {};
+  if (!modelsObj || typeof modelsObj !== "object") return out;
+  for (const [id, m] of Object.entries(modelsObj)) {
+    if (!m || typeof m !== "object") continue;
+    out[id] = normalizeModelCaps(id, m);
+  }
+  return out;
+}
+
+// workbuddy 上游原生字段（/v3/config 产品文档，first-party 最准）→ 统一 caps 形状
+// 实测字段（2026-09-11，29 模型全覆盖）：maxInputTokens/maxOutputTokens/supportsImages/
+// supportsReasoning/reasoning{effort,summary}/supportsToolCall/disabledMultimodal/credits/tags/name/vendor
+// reasoning 是"当前档位"非档位列表 → effortType=effort 但 effortValues=null、defaultEffort 记默认档
+export function normalizeWorkbuddyCaps(_id, m) {
+  const imageOk = Boolean(m?.supportsImages) && !m?.disabledMultimodal;
+  const reasoning = Boolean(m?.supportsReasoning);
+  const effort = reasoning && m?.reasoning && typeof m.reasoning === "object" ? String(m.reasoning.effort || "").trim() : "";
+  return {
+    reasoning,
+    effortType: reasoning ? "effort" : null,
+    // 上游只给当前档位不给档位列表；实测 hy3 reasoning_effort low/high 均生效（思考块 99 vs 210），
+    // 网关层按 OpenAI 兼容标准给通用三档（上游不识别时忽略，无害）
+    effortValues: reasoning ? ["low", "medium", "high"] : null,
+    defaultEffort: effort || null,
+    imageInput: imageOk,
+    toolCall: Boolean(m?.supportsToolCall),
+    context: Number(m?.maxInputTokens) || null,
+    maxOutput: Number(m?.maxOutputTokens) || null,
+    costIn: null,
+    costOut: null,
+    attachment: false,
+    temperature: m?.temperature != null,
+    releaseDate: null,
+    inputModalities: imageOk ? ["text", "image"] : ["text"],
+    outputModalities: ["text"],
+  };
+}