@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/model/providerAuth.js

@@ -1,25 +1,12 @@
-/**
- * 包内实现的设备码 provider 表。
- * 🔴 **今天是空的,理由见文件头**(宁空勿假:没有我们自己名下的 client_id 之前,填一行 = 冒用)。
- * 加一家 = 加一行;端点必须 https(门 ④a 逐行校)。
- */
 export const DEVICE_AUTH_PROVIDERS = [];
-/** 包内是否实现了这一家(能力真值的一半)。 */
 export function deviceAuthProviderFor(providerId) {
     return DEVICE_AUTH_PROVIDERS.find((p) => p.providerId === providerId);
 }
-/**
- * UI 是否显示「设备码登录」= **目录说有** ∧ **包里有实现**。
- * 任一缺席 ⇒ false(见文件头「能力真值」段)。
- */
 export function supportsDeviceCodeAuth(providerId, catalogHint) {
     if (catalogHint?.kind !== 'device_code')
         return false;
     return deviceAuthProviderFor(providerId) !== undefined;
 }
-/**
- * 一家 provider 摆给用户的轨(顺序 = UI 呈现序)。`api_key` 恒在;`device_code` 只在能力真值成立时出。
- */
 export function providerAuthMethods(preset) {
     const out = [{ kind: 'api_key', env: preset.authEnv }];
     if (supportsDeviceCodeAuth(preset.id, preset.deviceAuth)) {
@@ -27,19 +14,13 @@ export function providerAuthMethods(preset) {
     }
     return out;
 }
-/** 轮询间隔下限(RFC 8628 建议 5s;服务端给更大的值时听服务端的)。 */
 const DEVICE_CODE_MIN_INTERVAL_MS = 5000;
-/** 会话墙钟上限(design/166 §5:15min)。服务端 `expires_in` 更短时听服务端的。 */
 const DEVICE_CODE_MAX_LIFETIME_MS = 15 * 60 * 1000;
-/** 429 / slow_down 的退避增量(RFC 8628 §3.5 就是「加 5 秒」)。 */
 const DEVICE_CODE_BACKOFF_STEP_MS = 5000;
-/** 单次 HTTP 预算。 */
 const DEVICE_CODE_HTTP_TIMEOUT_MS = 10_000;
-/** 异常 → 短 detail(绝不带栈、绝不带响应体)。 */
 function shortError(e) {
     return (e instanceof Error ? e.message : String(e)).slice(0, 160);
 }
-/** POST application/x-www-form-urlencoded,收 JSON。返回 {status, body}(body 解析不动 ⇒ null)。 */
 async function postForm(url, form, fetchImpl, timeoutMs, signal) {
     const controller = new AbortController();
     const onAbort = () => controller.abort();
@@ -61,7 +42,7 @@ async function postForm(url, form, fetchImpl, timeoutMs, signal) {
             body = JSON.parse(text);
         }
         catch {
-            body = null; // 非 JSON 响应 ⇒ 当作「说不出所以然」,由调用方按 status 判(绝不回显正文)
+            body = null;
         }
         return { status: res.status, body };
     }
@@ -70,14 +51,6 @@ async function postForm(url, form, fetchImpl, timeoutMs, signal) {
         signal.removeEventListener('abort', onAbort);
     }
 }
-/**
- * 开一次设备码会话 —— **端点由调用方给**(包内表里那一行,或门的合成 descriptor)。
- * 🔴 端点是**编译进包的常量**,不是远端数据,所以本函数不对它再做白名单;真正的门是
- * 「client_id/端点绝不目录化下发」(design/165 §2 红线)+ 表内每行必须 https(门 ④a)。
- *
- * 失败(网络 / 非 2xx / 缺 user_code)⇒ **throw**(§C1 三选一里的 throw):开不出会话就是开不出,
- * 绝不返回一个永远 pending 的假会话。
- */
 export async function openDeviceCodeSession(endpoints, opts) {
     const fetchImpl = opts.fetchImpl ?? fetch;
     const timeoutMs = opts.timeoutMs ?? DEVICE_CODE_HTTP_TIMEOUT_MS;
@@ -113,16 +86,13 @@ export async function openDeviceCodeSession(endpoints, opts) {
             abort.abort();
         },
     };
-    /** 终态一旦落定就恒定(拿到 key 之后再 poll 不重复拨号)。 */
     let terminal = null;
-    /** 下一次允许真正拨号的墙钟时刻(间隔是硬的,不靠调用方自律)。 */
     let nextDialAtMs = started;
     async function poll() {
         if (terminal !== null)
             return terminal;
         const now = opts.nowMs();
         if (now >= session.expiresAtMs) {
-            // 本地上限先于服务端判:上限是我们对用户的承诺,不该靠服务端良心。
             terminal = { status: 'expired', detail: 'device code session exceeded its lifetime — start a new one' };
             return terminal;
         }
@@ -139,8 +109,7 @@ export async function openDeviceCodeSession(endpoints, opts) {
         }
         catch (e) {
             if (terminal !== null)
-                return terminal; // cancel() 把在飞请求打断了 —— 终态已落定
-            // 单次网络失败不是终态:设备码流本就是长轮询,下一拍再试(退避一格避免打点)。
+                return terminal;
             nextDialAtMs = opts.nowMs() + session.intervalMs;
             return { status: 'pending', detail: `poll failed, will retry: ${shortError(e)}` };
         }
@@ -171,15 +140,10 @@ export async function openDeviceCodeSession(endpoints, opts) {
         if (res.status < 200 || res.status >= 300) {
             return { status: 'pending', detail: `poll got HTTP ${res.status}, will retry` };
         }
-        // 认不出的 error 码:不冒充终态(别把一个我们没见过的码说成「过期了」),下一拍再试。
         return { status: 'pending', detail: err === '' ? 'unrecognised token response' : `unrecognised error: ${err}` };
     }
     return session;
 }
-/**
- * 按 providerId 开设备码会话(UI 入口)。
- * 包内没有这一家 ⇒ **throw**(UI 本就不该显示这个选项;走到这里说明能力判据被绕过了)。
- */
 export async function beginDeviceCodeAuth(providerId, opts) {
     const provider = deviceAuthProviderFor(providerId);
     if (provider === undefined) {

package/dist/model/providerCatalog.d.ts

@@ -1,63 +1,18 @@
-/**
- * providerCatalog.ts — F4 族D(A-028.17,2026-08-15):46 家 provider 表的**规范折表层**
- * (canonical fold)。纯派生、零 IO、零宿主依赖 —— 表本体在 `providerPresets.json`,
- * 本件只做「表 → 目录行」的那一次投影与行级文案判定。
- *
- * ## 为什么折表要进包
- *
- * 搬迁前这张表被折了三次:cli `src/sema/config/providerDirectory.ts`(Model Hub 目录行)、
- * web `src/lib/providers/catalog.ts`(向导折表)、web `provider-catalog.ts`(降级表二次映射)。
- * 三份折表各自持有「host 怎么取 / 零模型家怎么说 / 顺序动不动」这些**判定**,两侧常驻全表门
- * 只能靠人工对齐 —— 判定漂了没有任何编译器会响。折表进包后:cli 换装 re-export(单一真源),
- * web 侧第二份折表退役是 web 半场的事(发布帖点名)。
- *
- * ## 三条继承自 cli #175 的设计约束(逐字保留语义)
- *
- *   ① **单一真源**:每个量都从 `PROVIDER_PRESETS` 现算,本文件里没有第二张表 —— 没有硬编码的
- *      家名/baseUrl/模型清单。表更新一次,所有端的目录跟着变。
- *   ② **全表不重排**:顺序 = 表序,一行不筛、不重排、不分组(clay 令 2026-08-01:模型 provider
- *      完全用户选择,走全表)。本件不导出任何排序/过滤函数。
- *   ③ **诚实缺席**:表里没登记模型列表的家(ollama / vllm / litellm / 聚合网关等)`modelIds`
- *      就是空数组,行文案说「model id typed in」,**不写「0 models」**——「0 个模型」是编造
- *      出来的量:表没登记 ≠ 这家没有模型。consoleUrl / signupUrl 缺席同样原样缺席,不回落编造。
- *
- * 行形是 cli DirectoryRow 与 web 折表两侧字段的**严格超集**(字段名与 cli 侧逐字一致,cli 直接
- * re-export 零改动;web 侧的 label/keyEnvSuggestion/suggestedModels 对应 name/authEnv/modelIds)。
- */
 import { type ProviderPreset } from './providerPresets.js';
-/** 目录/向导的一行(表的一次纯投影;字段全部现算,invariant:modelCount === modelIds.length)。 */
 export interface ProviderCatalogRow {
-    /** preset 表里的 id(行 key + 回查用) */
     presetId: string;
     name: string;
     baseUrl: string;
-    /** baseUrl 的 host(含端口);解析不出时给空串(诚实缺席,不猜) */
     host: string;
     api: ProviderPreset['api'];
-    /** 领 key 的环境变量**名**(绝不是值;web 侧的 keyEnvSuggestion) */
     authEnv: string;
-    /** 表里登记了的模型 id(原序原样;空数组 = 这家的 model id 由用户手填,见约束③) */
     modelIds: string[];
-    /** 表里**登记了**的模型条数(0 = model id 手填,不是「这家没有模型」) */
     modelCount: number;
-    /** 聚合网关/本地引擎:模型 id 手填,ctx/maxTokens 走家族表 */
     modelViaFamily: boolean;
-    /** 去哪拿 key 的控制台页(纯 URL);缺席 = 上游没有确证地址,不编 */
     consoleUrl?: string;
-    /** 没账号时的注册入口;缺席 = 用 consoleUrl 那条 */
     signupUrl?: string;
 }
-/**
- * 全表 → 目录行。**顺序 = 表序**(约束②):这里没有 filter,也没有 sort。
- * `presets` 入参只给测试用(注入一张小表),产品路径恒走 `PROVIDER_PRESETS`。
- */
 export declare function providerCatalogRows(presets?: readonly ProviderPreset[]): ProviderCatalogRow[];
-/** 目录规模。端上「家数」与目录行数同源 —— 两处不会各报一个数。 */
 export declare function providerCatalogCount(): number;
-/** 按 preset id 回查整条 preset(目录选中之后要拿 baseUrl / models / consoleUrl)。 */
 export declare function providerPresetById(presetId: string): ProviderPreset | undefined;
-/**
- * 一行的 dim 说明:`host · api · 模型情况`。
- * 约束③:`modelCount === 0` 说「model id typed in」,绝不写「0 models」。
- */
 export declare function providerCatalogRowDetail(row: Pick<ProviderCatalogRow, 'host' | 'baseUrl' | 'api' | 'modelCount' | 'modelViaFamily'>): string;

package/dist/model/providerCatalog.js

@@ -1,29 +1,3 @@
-/**
- * providerCatalog.ts — F4 族D(A-028.17,2026-08-15):46 家 provider 表的**规范折表层**
- * (canonical fold)。纯派生、零 IO、零宿主依赖 —— 表本体在 `providerPresets.json`,
- * 本件只做「表 → 目录行」的那一次投影与行级文案判定。
- *
- * ## 为什么折表要进包
- *
- * 搬迁前这张表被折了三次:cli `src/sema/config/providerDirectory.ts`(Model Hub 目录行)、
- * web `src/lib/providers/catalog.ts`(向导折表)、web `provider-catalog.ts`(降级表二次映射)。
- * 三份折表各自持有「host 怎么取 / 零模型家怎么说 / 顺序动不动」这些**判定**,两侧常驻全表门
- * 只能靠人工对齐 —— 判定漂了没有任何编译器会响。折表进包后:cli 换装 re-export(单一真源),
- * web 侧第二份折表退役是 web 半场的事(发布帖点名)。
- *
- * ## 三条继承自 cli #175 的设计约束(逐字保留语义)
- *
- *   ① **单一真源**:每个量都从 `PROVIDER_PRESETS` 现算,本文件里没有第二张表 —— 没有硬编码的
- *      家名/baseUrl/模型清单。表更新一次,所有端的目录跟着变。
- *   ② **全表不重排**:顺序 = 表序,一行不筛、不重排、不分组(clay 令 2026-08-01:模型 provider
- *      完全用户选择,走全表)。本件不导出任何排序/过滤函数。
- *   ③ **诚实缺席**:表里没登记模型列表的家(ollama / vllm / litellm / 聚合网关等)`modelIds`
- *      就是空数组,行文案说「model id typed in」,**不写「0 models」**——「0 个模型」是编造
- *      出来的量:表没登记 ≠ 这家没有模型。consoleUrl / signupUrl 缺席同样原样缺席,不回落编造。
- *
- * 行形是 cli DirectoryRow 与 web 折表两侧字段的**严格超集**(字段名与 cli 侧逐字一致,cli 直接
- * re-export 零改动;web 侧的 label/keyEnvSuggestion/suggestedModels 对应 name/authEnv/modelIds)。
- */
 import { PROVIDER_PRESETS } from './providerPresets.js';
 const hostOf = (u) => {
     try {
@@ -33,12 +7,7 @@ const hostOf = (u) => {
         return '';
     }
 };
-/** api 家族的行内短名(目录行/芯片行两端同一个词,不各自缩写)。 */
 const providerApiShortName = (api) => api === 'anthropic-messages' ? 'anthropic' : 'openai';
-/**
- * 全表 → 目录行。**顺序 = 表序**(约束②):这里没有 filter,也没有 sort。
- * `presets` 入参只给测试用(注入一张小表),产品路径恒走 `PROVIDER_PRESETS`。
- */
 export function providerCatalogRows(presets = PROVIDER_PRESETS) {
     return presets.map(p => ({
         presetId: p.id,
@@ -54,18 +23,12 @@ export function providerCatalogRows(presets = PROVIDER_PRESETS) {
         ...(p.signupUrl === undefined ? {} : { signupUrl: p.signupUrl }),
     }));
 }
-/** 目录规模。端上「家数」与目录行数同源 —— 两处不会各报一个数。 */
 export function providerCatalogCount() {
     return providerCatalogRows().length;
 }
-/** 按 preset id 回查整条 preset(目录选中之后要拿 baseUrl / models / consoleUrl)。 */
 export function providerPresetById(presetId) {
     return PROVIDER_PRESETS.find(p => p.id === presetId);
 }
-/**
- * 一行的 dim 说明:`host · api · 模型情况`。
- * 约束③:`modelCount === 0` 说「model id typed in」,绝不写「0 models」。
- */
 export function providerCatalogRowDetail(row) {
     const models = row.modelCount === 0
         ? 'model id typed in'

package/dist/model/providerPresets.d.ts

@@ -2,7 +2,6 @@ export type PresetModel = {
     id: string;
     contextWindow: number;
     maxTokens: number;
-    /** Marks the provider's cheap sibling — screen-4 execution-slot recommendation. */
     cheapHint?: boolean;
 };
 export type ProviderPreset = {
@@ -12,61 +11,29 @@ export type ProviderPreset = {
     api: 'anthropic-messages' | 'openai-completions';
     authEnv: string;
     models: PresetModel[];
-    /** Aggregator gateways (OpenRouter): model id is hand-typed, ctx/maxtok via family table. */
     modelViaFamily?: boolean;
-    /**
-     * 🆕 design/160 需求②-B(2026-07-31):**去哪拿 key** 的控制台页(纯链接,离线也能显示)。
-     *
-     * 🔴 **诚实缺席**:只填能可靠确认的官网控制台地址;拿不准的家**不填**,绝不编 URL —— 这个字段
-     * 会被 onboard 直接拿去开浏览器,编一个 = 把用户送到错误的地方。本地/自建家(ollama /
-     * lmstudio / vllm / sglang / litellm)按定义没有控制台页,缺席是正确答案不是遗漏。
-     * 设计档待裁点 3b:`oauth` / `subscribe` 两类**本批不加**(授权码流/设备码流单独排)。
-     */
     consoleUrl?: string;
-    /** 没账号时的注册入口。与 `consoleUrl` 同页的家不重复填(缺席 = 用 consoleUrl 那条)。 */
     signupUrl?: string;
-    /**
-     * 🆕 design/165 §2 + design/166 §5(2026-08-04):**设备码能力开关**(B 档)。
-     *
-     * 🔴 它只是**开关**,不携带 client_id / token 端点 / authorize 端点 —— 那些编译进
-     * `model/providerAuth.ts` 的 `DEVICE_AUTH_PROVIDERS`。理由:目录是远端可改的数据,
-     * 让它决定鉴权端点 = 把钓鱼面下发给客户端(design/165 §2 红线④,CI 的 validate.mjs
-     * 里有对应的机械不变式)。
-     * 🔴 能力真值 = **本键在场 ∧ 包内有实现**(`supportsDeviceCodeAuth`)——目录先行不造 affordance。
-     */
     deviceAuth?: ProviderDeviceAuthHint;
 };
-/** 目录里的设备码能力开关(只有 kind 与文档链接;凭证参数一律不进目录)。 */
 export interface ProviderDeviceAuthHint {
     kind: 'device_code';
-    /** 该家自己的设备码说明页(纯链接;拿不准就不填,绝不编 URL)。 */
     docsUrl?: string;
 }
 export type ModelFamily = {
     id: string;
     name: string;
-    /** Regex source matched against a model id to PRE-SELECT the family. '' = fallback. */
     match: string;
     contextWindow: number;
     maxTokens: number;
-    /** 图像输入能力(确信才标:false=确认无 vision,true=确认有;缺省=未知不 stamp)。 */
     vision?: boolean;
-    /**
-     * per-model 已知输出上限 —— 仅 inferFamily 第①层(providerPresets.json 精确表)命中时携带
-     * (=该行 maxTokens)。F2 裁决(clay 2026-07-15)封顶① 的证据位:家族正则/主干层的 maxTokens
-     * 是家族参考值,不是该模型的确证 cap,不带此位。
-     */
     perModelCap?: number;
 };
 export declare const PROVIDER_PRESETS: ProviderPreset[];
 export declare const MODEL_FAMILIES: ModelFamily[];
-/** Infer context/max from a model id — four evidence tiers, strongest first. */
 export declare function inferFamily(modelId: string): ModelFamily | undefined;
-/** Format token counts like "1m" / "384k". */
 export declare function fmtTokens(n: number): string;
-/** "1m ctx / 384k out" style short metric text. */
 export declare function fmtCtxOut(ctx: number, out: number): string;
-/** Screen-4 execution-slot recommendation: cheapHint first, else a cheap-sounding sibling. */
 export declare function pickCheapCandidate<T extends {
     id: string;
     cheapHint?: boolean;

package/dist/model/providerPresets.js

@@ -1,44 +1,7 @@
-/**
- * ⇄ 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。这不是「少个装饰」。
- *
- * 🔴 **搬迁期的双份漂移锁已退役(0.11.10)**:搬迁期壳树那两个 JSON 还在,pure 门当时有一条
- *    **byte-identity 断言**(本包 `src/model/*.json` 与壳树 `src/sema/onboard/*.json` 逐字节相等)。
- *    壳侧 shim 落地(那两个 JSON 删除、`providerPresets.ts` 改 re-export 本包)之后,那条断言的
- *    **前提消失**了 —— 它从此每跑必打 DEGRADED 且**永远不会再跑**(校一个已经不存在的物,再自我
- *    降级放过 = 僵尸腿)。继任不变量不是「两份一致」,是「**只有一份、而且用户拿到的就是它**」:
- *      · pure 门:`dist/model/*.json` 与 src **语义**等同(tsc emit 会重排缩进,跨 emit 边界只能校
- *        语义)+ 运行时表的 id 序列 === 表本身 + src 树里各恰好一份 + 壳树零副本/shim 仍 re-export;
- *      · public-surface 门:`npm pack` 的**真实发布清单**里必须有这两个 JSON(换 bundler / 一行
- *        .npmignore 就能让数据表静悄悄不进 tarball,而类型与单测照样全绿)。
- *
- * ── 以下为原文件的领域说明(逐字保留)────────────────────────────────────────────────────────
- *
- * 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() {
@@ -64,13 +27,6 @@ function presetIndex() {
     presetIndexCache = { exact, stems };
     return presetIndexCache;
 }
-/**
- * family 表(第④层)的**唯一**匹配器 —— anchored 优先、再 unanchored 兜底。
- *
- * 提出来的理由不是整洁,是**单源**:`vision` 位只住在这张表上,而第①/②/③ 层命中时也要能读到它
- * (见 {@link visionFromFamilyTable})。若两处各写一遍两趟正则,「这个 id 属哪个家族」在同一个函数
- * 里就会有两个答案。
- */
 function familyFromTable(id) {
     for (const fam of MODEL_FAMILIES) {
         if (fam.match && new RegExp(fam.match, 'i').test(id))
@@ -82,25 +38,6 @@ function familyFromTable(id) {
     }
     return undefined;
 }
-/**
- * 🔴 **#318 件③(cli [4752] 自领缺口1)—— `vision` 的分层遮蔽修**。
- *
- * 病(修前的真行为,不是假设):`vision` 位只写在 `modelFamilies.json` 上,而那张表只有**第④层**
- * 读。可是任何真实的 `deepseek-*` id 在**第①层**(preset 大表精确)或**第③层**(家族主干包含)
- * 就已经命中并 return 了,而这两层的构造器 `hitOf` **不带 vision 位** ⇒ 第④层对它们**结构性不可达**
- * ⇒ `deepseek4` 行的 `vision: false` **永远读不出来**,壳的 `MODEL_VISION=false` stamp 恒不发生
- * (下游两处注释自述的行为是死的)。
- *
- * 修的形:把 `vision` 从「第④层的一个字段」提成**与 ctx/maxTokens 证据层正交的一次独立查表**。
- * 判据分工从此是两条轴,各自单源:
- *   · **容量轴**(contextWindow / maxTokens / perModelCap)= 四层证据,强者先赢 —— 一字不动;
- *   · **vision 轴** = 恒查 family 表(本函数),与哪一层命中**无关**。
- * 为什么正交是对的:preset 大表(第①层)根本没有 vision 列,主干匹配(第③层)拿的是**别的模型**
- * 的行 —— 两者都不是「这个 id 能不能看图」的证据。唯一有这个事实的地方就是 family 表。
- *
- * 🔴 **诚实缺席**:表上没标(键缺席)⇒ 返回 `undefined` ⇒ 调用方**不 stamp 这个键**。
- * 「没人说过这个模型能不能看图」与「确认它不能看图」是两件事,后者会永久封死一个真能力。
- */
 function visionFromFamilyTable(id) {
     const fam = familyFromTable(id);
     return typeof fam?.vision === 'boolean' ? fam.vision : undefined;
@@ -109,25 +46,20 @@ 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] 容量后缀在第②层单独消费
+        id = id.slice(slash + 1);
+    id = id.replace(/\[[0-9]+[km]\]$/, '');
     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)
-        // eopt:vision/perModelCap 是「缺省=未知不 stamp」的条件展开位(与 taskId/status 那种「键恒在」
-        // 公面契约不同义——那两位没有「已确认为未知」这个第三态,这两位有),诚实透传 base 的键在场与否。
         return {
             id: base?.id ?? 'cap-suffix',
             name: base?.name ?? 'capacity suffix',
@@ -139,20 +71,13 @@ export function inferFamily(modelId) {
         };
     }
     const id = normalizeId(raw);
-    // vision 轴:与容量证据层**正交**的一次独立查表(#318 件③ 分层遮蔽修,推导见 visionFromFamilyTable)。
-    // 恒按**完整归一 id** 查(不按主干):family 的 match 是锚在 id 上的前缀正则,拿主干去查会把
-    // `deepseek-chat` 的证据换成 `deepseek` 的证据 —— 同族时同解,不同族时是另一个答案。
     const vision = visionFromFamilyTable(id);
-    // ① preset 大表精确(含剥变体尾巴后再试)——精确命中才带 perModelCap(F2 裁决封顶① 证据位;
-    //   ③ 层主干匹配拿的是家族参考行,不是该模型的确证 cap)
     const hitOf = (m, exact = false) => ({
         id: m.famId,
         name: m.famId,
         match: '',
         contextWindow: m.contextWindow,
         maxTokens: m.maxTokens,
-        // 🔴 诚实缺席:表上没标就**不 stamp 键**(`exactOptionalPropertyTypes` 下 `vision: undefined`
-        //    与键缺席不是一回事,消费方读的正是「键在不在」这个三态)。
         ...(vision !== undefined ? { vision } : {}),
         ...(exact ? { perModelCap: m.maxTokens } : {}),
     });
@@ -165,14 +90,11 @@ export function inferFamily(modelId) {
         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;
-            // vision 轴同样正交透出(`deepseek-v3-128k` 这类 id 在这一层就 return,不透 = 同一个遮蔽病
-            // 换个层复发)。
             return {
                 id: 'inline-cap',
                 name: 'capacity in id',
@@ -183,14 +105,11 @@ export function inferFamily(modelId) {
             };
         }
     }
-    // ③ 家族主干:候选主干=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;
@@ -199,15 +118,9 @@ export function inferFamily(modelId) {
     }
     if (best)
         return hitOf(best);
-    // ④ family 表前缀(anchored → unanchored)—— 与 vision 轴共用同一个匹配器(单源,见 familyFromTable)
     return familyFromTable(id);
 }
-/** 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)
@@ -218,11 +131,9 @@ export function fmtTokens(n) {
         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) ??

package/dist/model/tierVocabulary.d.ts

@@ -1,43 +1,12 @@
-/**
- * tierVocabulary.ts — F4 族D(A-028.18,2026-08-15):档位(tier)的**词表 + 派生 + 校验**单源。
- * 纯数据 + 纯函数,零 IO、零宿主依赖。
- *
- * ## 为什么进包
- *
- * 搬迁前这套词表跨两仓共三份:cli `src/sema/config/tierCore.ts`(词表 + isTier 校验 +
- * resolveTierBinding 派生)、web `tiers-page.tsx`(词表)、web `chat/wording.ts`(词表 + 按
- * 模型名 token 化的派生)。五档顺序/别名映射漂了没有任何编译器会响。词表进包后:cli 的
- * tierCore 换装 re-export(settings 读写那半场留在壳里 —— 那是宿主存储,不是词表);web 侧
- * 两份的退役是 web 半场的事(发布帖点名)。
- *
- * ## 与引擎侧的对齐
- *
- * 五档序镜像 core `DEFAULT_TIER_ORDER`、CC 别名镜像 core `CC_MODEL_TIER_ALIASES`(cli 侧
- * tierStore.test.ts 有对 core 导出的运行时 drift-lock);`ultra` 预留在 max 之上(core 已排位,
- * UI 今天不面)。缺省默认档 pro(clay [599])。
- */
-/** sema 档位(用户/模型可寻址的命名档)。`ultra` 预留(core 已排位,UI 今天不面)。 */
 export type Tier = 'ultra' | 'max' | 'pro' | 'flash' | 'lite';
-/** 降档链(强→弱)——镜像 core DEFAULT_TIER_ORDER;解析某档无绑定时沿链向后取第一个有绑定的档。 */
 export declare const TIER_ORDER: readonly Tier[];
-/** UI 呈现的四档(ultra 预留不面)。 */
 export declare const SURFACED_TIERS: readonly Tier[];
-/** CC 档位词 → sema 档位(内置固定映射,镜像 core CC_MODEL_TIER_ALIASES;兼容层不可配)。 */
 export declare const CC_TIER_ALIASES: Readonly<Record<string, Tier>>;
-/** 缺省默认档(clay [599]:默认档缺省 pro)。 */
 export declare const DEFAULT_TIER: Tier;
-/** 各档一句话职责(档位 Hub/onboard 行描述共用;无 roster/role 词)。 */
 export declare const TIER_BLURBS: Readonly<Record<Tier, string>>;
-/** 一个命名档位组的绑定形(纯类型:绑定值 = 端侧模型目录的 entry id)。 */
 export type TierGroupDef = {
-    /** tier → 模型 entry id。未绑档沿 TIER_ORDER 向下 fail-open(见 resolveTierBinding)。 */
     tiers: Partial<Record<Tier, string>>;
-    /** 组内默认档(缺省 DEFAULT_TIER=pro)。 */
     defaultTier?: Tier;
 };
 export declare const isTier: (v: unknown) => v is Tier;
-/**
- * 组内解析某档 → 绑定 entry id(该档未绑则沿 TIER_ORDER 向下取第一个有绑定的档;全空
- * undefined)。fail-open 沿链向下,镜像 core expandTiers 语义。
- */
 export declare function resolveTierBinding(def: TierGroupDef, tier: Tier): string | undefined;

package/dist/model/tierVocabulary.js

@@ -1,26 +1,5 @@
-/**
- * tierVocabulary.ts — F4 族D(A-028.18,2026-08-15):档位(tier)的**词表 + 派生 + 校验**单源。
- * 纯数据 + 纯函数,零 IO、零宿主依赖。
- *
- * ## 为什么进包
- *
- * 搬迁前这套词表跨两仓共三份:cli `src/sema/config/tierCore.ts`(词表 + isTier 校验 +
- * resolveTierBinding 派生)、web `tiers-page.tsx`(词表)、web `chat/wording.ts`(词表 + 按
- * 模型名 token 化的派生)。五档顺序/别名映射漂了没有任何编译器会响。词表进包后:cli 的
- * tierCore 换装 re-export(settings 读写那半场留在壳里 —— 那是宿主存储,不是词表);web 侧
- * 两份的退役是 web 半场的事(发布帖点名)。
- *
- * ## 与引擎侧的对齐
- *
- * 五档序镜像 core `DEFAULT_TIER_ORDER`、CC 别名镜像 core `CC_MODEL_TIER_ALIASES`(cli 侧
- * tierStore.test.ts 有对 core 导出的运行时 drift-lock);`ultra` 预留在 max 之上(core 已排位,
- * UI 今天不面)。缺省默认档 pro(clay [599])。
- */
-/** 降档链(强→弱)——镜像 core DEFAULT_TIER_ORDER;解析某档无绑定时沿链向后取第一个有绑定的档。 */
 export const TIER_ORDER = ['ultra', 'max', 'pro', 'flash', 'lite'];
-/** UI 呈现的四档(ultra 预留不面)。 */
 export const SURFACED_TIERS = ['max', 'pro', 'flash', 'lite'];
-/** CC 档位词 → sema 档位(内置固定映射,镜像 core CC_MODEL_TIER_ALIASES;兼容层不可配)。 */
 export const CC_TIER_ALIASES = {
     fable: 'max',
     mythos: 'max',
@@ -28,9 +7,7 @@ export const CC_TIER_ALIASES = {
     sonnet: 'flash',
     haiku: 'lite',
 };
-/** 缺省默认档(clay [599]:默认档缺省 pro)。 */
 export const DEFAULT_TIER = 'pro';
-/** 各档一句话职责(档位 Hub/onboard 行描述共用;无 roster/role 词)。 */
 export const TIER_BLURBS = {
     ultra: 'reserved above max — binds when a stronger model lands',
     max: 'hardest problems — deep reasoning, big refactors',
@@ -39,10 +16,6 @@ export const TIER_BLURBS = {
     lite: 'cheapest — bulk classification, simple lookups',
 };
 export const isTier = (v) => typeof v === 'string' && TIER_ORDER.includes(v);
-/**
- * 组内解析某档 → 绑定 entry id(该档未绑则沿 TIER_ORDER 向下取第一个有绑定的档;全空
- * undefined)。fail-open 沿链向下,镜像 core expandTiers 语义。
- */
 export function resolveTierBinding(def, tier) {
     const direct = def.tiers[tier];
     if (direct)

package/dist/modelBudgetRule.d.ts

@@ -1,44 +1,5 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/modelBudgetRule.ts 逐字搬入(零依赖,纯规则)。
- */
-/**
- * modelBudgetRule.ts — max-output-tokens 中央规则(clay 2026-07-15 拍板,F2 maxTokens 裁决批)。
- *
- * 裁决(逐字):
- *   · 上下文窗口:预设/家族表能匹配用匹配值;匹配不上默认 200000(FALLBACK_CONTEXT_WINDOW)。
- *   · maxTokens 默认:32000;上下文窗口 ≥500000 → 64000;恒受两道封顶:
- *       ① per-model 已知 cap(providerPresets 精确表,inferFamily 第①层命中带 perModelCap);
- *       ② 上下文窗口 ÷ 4(向下取整)。
- *   · UI 四档(超集):16K / 32K(默认)/ 64K / 128K;档位 > 上下文窗口÷4 的禁用/跳过
- *     (例:128K 上下文 → 顶 32K;1M → 全档可用)。
- *   · env 显式值恒赢:CLAUDE_CODE_MAX_OUTPUT_TOKENS 映射与显式 MODEL_MAX_TOKENS 既有行为不动
- *     (本模块只算默认,不碰覆盖层 —— 见 ccConfigFallback.applyModelEnvFamilyFallback)。
- *
- * CC 对照锚(有意偏离,记忆档 max-tokens-ruling-deviate-cc):CC 2.1.207 per-model 表
- * `max_output_tokens:{default:32000,upper:64000}`(源 13760)+ CLAUDE_CODE_MAX_OUTPUT_TOKENS env
- * 钳制(源 529278),无 UI 档位、无 ÷4 封顶。sema 面对任意三方模型/网关,家族表大数直接当默认会
- * 超供应商 cap(400)或单轮吃穿预算 —— 故默认收敛到 CC 口径 32K/64K,并加 ÷4 与 per-model 封顶;
- * UI 档位是超集便利面。
- *
- * 注意:providerPresets.json 精确表 / modelFamilies.json 家族表的 maxTokens 字段【保留】——
- * 只作 cap 参考(perModelCap / 显示),不再直接当默认 stamp 值。
- */
-/** 裁决:预设/家族都匹配不上时的上下文窗口默认(=CC 的 200k 口径)。 */
 export declare const FALLBACK_CONTEXT_WINDOW = 200000;
-/** UI 四档(超集):16K / 32K(默认)/ 64K / 128K。十进制(与 CC 32000/64000 同基)。 */
 export declare const MAXTOK_TIERS: readonly [16000, 32000, 64000, 128000];
-/**
- * 默认 max tokens = min( ctx>=500000 ? 64000 : 32000 , floor(ctx/4) , perModelCap ?? ∞ )。
- * contextWindow 传 null/undefined/非法 = 匹配不上 → 按 200000 算(→ 32000)。
- */
 export declare function defaultMaxTokensFor(contextWindow: number | null | undefined, perModelCap?: number | null): number;
-/**
- * 该上下文窗口下可用的 UI 档位(> ctx÷4 的禁用/跳过)。可能为空(ctx < 64000,如 32K 上下文
- * 连 16K 档都超 ÷4)—— UI 调用方对空列表降级(提示用 M 自由输入),规则函数不瞎补。
- */
 export declare function tierChoicesFor(contextWindow: number | null | undefined): number[];
-/**
- * 档位循环:当前值在档内 → 下一档(循环);不在档内(自由输入/家族值)→ 大于当前的最小档,
- * 都不大于则回第一档(与 modelCtxOverride.nextStep 同语义)。无可用档 → null(调用方降级)。
- */
 export declare function nextMaxTokTier(current: number | null | undefined, contextWindow: number | null | undefined): number | null;