@sema-agent/server 7.134.0 → 7.136.0

package/dist/model-entry-refusal.d.ts

@@ -2,7 +2,7 @@ import { type ModelEntryRefusalCode, type ModelPlaneRefusalCode, type ModelRefus
 import { type DroppedCatalogEntry } from "./web-admin-client/read-warnings.js";
 import { type ModelTableLeg } from "./model-select.js";
 /**
- * 条目拒因码 → 本仓铸它的成因 —— **以码为键**(S-768):码闭集的属主是 settings-schema(`MODEL_ENTRY_REFUSAL_CODES`,6.2.0 起;此前本仓
+ * 条目拒因码 → 本仓铸它的成因 —— **以码为键**([ref]):码闭集的属主是 settings-schema(`MODEL_ENTRY_REFUSAL_CODES`,6.2.0 起;此前本仓
  * 自持一份同名码表,撞名已消灭、零别名)。那边加一个条目码 ⇒ 本表缺键 ⇒ 本仓 tsc 红(只拿 `satisfies` 约束码值证明的是「子集」,
  * 不是「相等」;以码为键才证相等)。成因闭集由本表派生,{@link refusalEventOf} 对它穷举 —— 加成因同样编译红。
  * 码的拼法随 `config.*` 家族,按**规则**命名:出现在拒因句的方括号里、warn 字段里、`modelRefusals` 里。
@@ -13,9 +13,9 @@ export declare const ENTRY_REFUSAL_REASON_OF: {
 };
 /** 不可用的成因 —— **闭集**,由 {@link ENTRY_REFUSAL_REASON_OF} 派生。 */
 export type ModelEntryRefusalReason = (typeof ENTRY_REFUSAL_REASON_OF)[ModelEntryRefusalCode];
-/** 「这张表没有缺省模型」的机读码(S-705;boot 拒启与热路径模型面组拒同一个码;组拒码闭集属主 = settings-schema)。 */
+/** 「这张表没有缺省模型」的机读码([ref];boot 拒启与热路径模型面组拒同一个码;组拒码闭集属主 = settings-schema)。 */
 export declare const DEFAULT_MODEL_MISSING_CODE = "config.default_model_missing";
-/** 🔴 S-712「被拒的名字被档位 / 别名增广铸到了别的条目上(或被丢身份载体形不对、读不出名字,无从证明没有)」的机读码
+/** 🔴 [ref]「被拒的名字被档位 / 别名增广铸到了别的条目上(或被丢身份载体形不对、读不出名字,无从证明没有)」的机读码
  *  (不变量 `refused-names-not-minted`;热路径 / boot 首次 apply / dry-run 同一个码;组拒码闭集属主 = settings-schema)。 */
 export declare const REFUSED_NAME_MINTED_CODE = "config.model_refused_name_minted";
 /**
@@ -45,14 +45,14 @@ export interface CatalogEntryLike {
     readonly name: string;
     readonly id: string;
     readonly provider: string;
-    /** S-931:线路词(`headers` 的线路判据读它;原值,不信这张型)。 */
+    /** [ref]:线路词(`headers` 的线路判据读它;原值,不信这张型)。 */
     readonly api?: unknown;
-    /** S-931:供应商附加头的承载形(`unknown`:判据在 `model-entry-headers.ts`,不信这张型)。 */
+    /** [ref]:供应商附加头的承载形(`unknown`:判据在 `model-entry-headers.ts`,不信这张型)。 */
     readonly headers?: unknown;
 }
 /**
  * **逐条判据**:`undefined` = 本部署能完整服务它。判序即语义:先形(不合形的条目谈不上走哪条腿),再腿。
- * 形分两段、同一个码(`config.model_entry_invalid`):settings-schema 的 `ModelEntry`,再是 S-931 的 `headers`(白名单 + 线路 + 值形,
+ * 形分两段、同一个码(`config.model_entry_invalid`):settings-schema 的 `ModelEntry`,再是 [ref] 的 `headers`(白名单 + 线路 + 值形,
  * 判据单属主 `model-entry-headers.ts`;settings-schema 6.3.0 的 `ModelEntry` 还没有这个键 —— 候裁加字段,届时词表不另抄)。
  *
  * 形判的属主是 settings-schema 的 `ModelEntry`(两条读腿用的就是它)—— 本仓不手抄任何一条字段规则;这里只是
@@ -63,23 +63,23 @@ export declare function judgeCatalogEntry(m: CatalogEntryLike, ctx: CatalogEntry
 /** 一批已启用条目的判决:可用的(保序)、不可用的(按 catalog name)、被丢目录条目的载体行(形对的,保序),以及形不对的载体行(坐标)。 */
 export interface CatalogEntriesVerdict<M extends CatalogEntryLike> {
     readonly usable: readonly M[];
-    /** 键 = catalog name(**每一个**名,含秘密形 / 空串 / `__proto__`:引擎自己的判决保持完整 —— S-712 不变量与选择面的「让出」都读它;
+    /** 键 = catalog name(**每一个**名,含秘密形 / 空串 / `__proto__`:引擎自己的判决保持完整 —— [ref] 不变量与选择面的「让出」都读它;
      *  名筛只在出口,见 {@link buildModelRefusalsSignal})。键以自有数据属性写入(`__proto__` 不走原型 setter)。 */
     readonly refused: Readonly<Record<string, ModelEntryRefusal>>;
-    /** S-712:被丢目录条目**载体形不对**的行坐标(`models.3`;读不出下标时是 `(unknown coordinate)`;载体不是列表时是一个固定标记)。读腿铸的每一行
+    /** [ref]:被丢目录条目**载体形不对**的行坐标(`models.3`;读不出下标时是 `(unknown coordinate)`;载体不是列表时是一个固定标记)。读腿铸的每一行
      *  都合 `read-warnings.ts` {@link DroppedCatalogEntryRow} 的形,所以这一形只来自绕过读腿的输入被改过(盘上 LKG 被手改 / 手写 effective)。
      *  非空 ⇒ 改过的行原本代表谁说不清,无从证明它的名字不被增广铸出 ⇒ 不变量 `refused-names-not-minted` 不成立 ⇒ 模型面组拒(fail-closed)。 */
     readonly malformed: readonly string[];
-    /** S-1295:载体里形对的行(保序)—— 模型面 stage 把它与 `models` 同 commit 进 `config.droppedCatalogEntries`(`GET /v1/models.droppedEntries`
+    /** [ref]:载体里形对的行(保序)—— 模型面 stage 把它与 `models` 同 commit 进 `config.droppedCatalogEntries`(`GET /v1/models.droppedEntries`
      *  的源):载体只在这里被判形、被读一次,墓碑与 wire 读的是同一批行。 */
     readonly dropped: readonly DroppedCatalogEntry[];
 }
 /**
  * 批量形(模型面 stage 与 dry-run 共用这一只 —— 报数与真 apply 永不撕裂)。
- * S-712:`dropped` = 读腿交出的被丢目录条目载体(`EffectiveConfig.models.droppedCatalogEntries`,每一条被丢的目录条目一行)。入参按 `unknown`
+ * [ref]:`dropped` = 读腿交出的被丢目录条目载体(`EffectiveConfig.models.droppedCatalogEntries`,每一条被丢的目录条目一行)。入参按 `unknown`
  * 判形:载体可能来自盘上 LKG(本仓写的,但文件可被改)。载体要么缺席,要么是一列合 {@link DroppedCatalogEntryRow} 形的行;其余一律「载体形不对」
  * 进 `malformed`(fail-closed)—— 读腿自己从不铸这种形。
- * **墓碑判据(一条,S-712 原样)**:行的 `identity.name` 在 ∧ `identity.enabled !== false` ⇒ 铸一块墓碑(它与逐条判据判出的 `entry_invalid`
+ * **墓碑判据(一条,[ref] 原样)**:行的 `identity.name` 在 ∧ `identity.enabled !== false` ⇒ 铸一块墓碑(它与逐条判据判出的 `entry_invalid`
  * 是同一件事 —— 条目不合 `ModelEntry` 形,只是在第一道边界就被丢了;拒因 provider 词空:告警身份不带它)。其余行不是墓碑:
  *  · 停用 ⇒ 不在目录(与 7.100.0 同义);
  *  · 没有名 —— 原文 `name` 不是字符串,或是字符串但不能原样出门(settings-schema `isDisclosableIdentity` 说不,身份里不带)⇒ **无名可留**,
@@ -88,7 +88,7 @@ export interface CatalogEntriesVerdict<M extends CatalogEntryLike> {
  * 与一条可用 / 已判不可用条目同名时不覆盖(可用条目仍可用;同名撞车由不变量 `refused-names-not-minted` 响亮拒)。
  */
 export declare function judgeCatalogEntries<M extends CatalogEntryLike>(enabled: readonly M[], ctx: CatalogEntryVerdictCtx, dropped?: unknown): CatalogEntriesVerdict<M>;
-/** S-768:一次 apply 对「最新交到手的那份候选目录」的模型拒因判决(纯数据;`ApplyReport.modelRefusals`)。 */
+/** [ref]:一次 apply 对「最新交到手的那份候选目录」的模型拒因判决(纯数据;`ApplyReport.modelRefusals`)。 */
 export interface ModelRefusalVerdict {
     /** 那份候选的逐条判决(键 = catalog name,**完整**,未过名筛 —— 名筛在出口 {@link buildModelRefusalsSignal})。 */
     readonly entries: Readonly<Record<string, ModelEntryRefusal>>;
@@ -96,11 +96,11 @@ export interface ModelRefusalVerdict {
     readonly plane?: ModelPlaneRefusalCode;
 }
 /**
- * S-768 —— 判决 → `/health.modelRefusals` 与 fleet 心跳 `modelRefusals` 的 wire 形(settings-schema `ModelRefusalsSignal`,纯投影):
+ * [ref] —— 判决 → `/health.modelRefusals` 与 fleet 心跳 `modelRefusals` 的 wire 形(settings-schema `ModelRefusalsSignal`,纯投影):
  * 名 → 码,**值只码**(拒因事实里的上游 id / provider 词 / 坏字段键 / 出路句都不上 wire —— `entry_invalid` 行是没人验过的行,id / provider
  * 可能就是坏行原样;句子是给本机运维的散文,不是契约)。**名筛在这里、只在这里**:键过 settings-schema `isReportableRefusalName`(唯一判据,
  * import 不复制;6.3.0 起 = 标识符白名单 ∧ 无密钥形 ∧ 无 URL userinfo)—— 秘密形 / 空串 / `__proto__` / 不是标识符的串这类出不了门的名不进键、
- * 不计数;引擎内部的判决不受影响;本机日志 / 拒因句里的写名同样先问这一只(S-805,{@link disclosableRefusalName}:不可披露的名只写码)。
+ * 不计数;引擎内部的判决不受影响;本机日志 / 拒因句里的写名同样先问这一只([ref],{@link disclosableRefusalName}:不可披露的名只写码)。
  * 逐条空且无组拒 ⇒ `undefined`(键缺席:「没有」只有一种拼法)。
  */
 export declare function buildModelRefusalsSignal(v: ModelRefusalVerdict | undefined): ModelRefusalsSignal | undefined;
@@ -114,7 +114,7 @@ export declare function refusedNameLogField(key: string, name: string): Record<s
 export declare function refusedNamesLogFields(key: string, names: readonly string[]): Record<string, unknown>;
 /** 成因 → 它那一条 warn 的事件名(**穷举**)。两个名字是票面点名的既有/新事件,运维的告警规则按名挂。 */
 export declare function refusalEventOf(reason: ModelEntryRefusalReason): "web_admin_model_no_brain" | "web_admin_model_entry_invalid";
-/** warn 字段(不含值):`field` = 第一处坏字段(告警规则最常按它分组),`fields` = 全部。S-805:`model` 只在名可披露时写。 */
+/** warn 字段(不含值):`field` = 第一处坏字段(告警规则最常按它分组),`fields` = 全部。[ref]:`model` 只在名可披露时写。 */
 export declare function refusalWarnFields(name: string, r: ModelEntryRefusal): Record<string, unknown>;
 /** 调用方写的模型 ref(`model` / `compactionModel` / `agents[i].model` / `@name`)回到人面前 —— 拒句与留声日志 —— 的字符上限。 */
 export declare const MODEL_REF_ECHO_CHARS = 120;
@@ -136,7 +136,7 @@ export interface DefaultModelView {
     readonly modelRefusals: Readonly<Record<string, ModelEntryRefusal>>;
 }
 /**
- * 🔴 S-705 —— **这张模型表有没有一只缺省模型**(`models.default`)。`undefined` = 有。
+ * 🔴 [ref] —— **这张模型表有没有一只缺省模型**(`models.default`)。`undefined` = 有。
  *
  * 规则只有一句:**进程服务的那张表必须有 `default`**。env 腿(`MODEL_ID`)与目录腿(缺省解析)是它的两个来源,
  * 任一在场即过;目录一旦生效就整张换掉 env 表,所以判的永远是「生效之后的那张表」—— 这正是它必须在目录应用
@@ -162,7 +162,7 @@ export interface RefusedNameView {
     readonly modelRefusals: Readonly<Record<string, ModelEntryRefusal>>;
 }
 /**
- * 🔴 S-712 —— 不变量 `refused-names-not-minted` 的判据:**这张表回应的每一个名字(目录键 ∪ core `expandTiers` 增广出来的档位词 /
+ * 🔴 [ref] —— 不变量 `refused-names-not-minted` 的判据:**这张表回应的每一个名字(目录键 ∪ core `expandTiers` 增广出来的档位词 /
  * CC 别名 / `best`)都不是一个被拒条目的名字**。返回撞上的那些(空 = 成立)。
  *
  * 为什么是「增广之后」:引擎在构造 / 换装时自己 `expandTiers(models, tiers)`,显式 `model:"sonnet"` 与角色绑定 `advisor→sonnet` 都在

package/dist/model-provider.d.ts

@@ -1,12 +1,12 @@
 /**
- * S-461 —— **模型 provider 词表的唯一属主**(闭集 + 路由腿的穷举判词 + 域外拒因)。
+ * [ref] —— **模型 provider 词表的唯一属主**(闭集 + 路由腿的穷举判词 + 域外拒因)。
  *
  * ## 病
  * `MODEL_PROVIDER` 此前收**任意字符串**(`config.ts` 里就是一句 `process.env.MODEL_PROVIDER`),而消费它的
  * 只有一处「非 anthropic 即 gateway」的二分。于是最自然的误填 —— 把**厂商名**写成 provider,
  * `MODEL_PROVIDER=deepseek` —— 起得来、静默走网关栈(实测改前读数:`model.provider="deepseek"`、
  * `api="openai-completions"`)。运维以为自己点了一条专用路线,拿到的是默认腿,而读数上没有任何异常。
- * 这与 [ref] 件⑤ / S-188 的三根模型线路旋钮是**同一条族律**([ref] A 档:坏值拒启,不静默折默认)。
+ * 这与 [ref] 件⑤ / [ref] 的三根模型线路旋钮是**同一条族律**([ref] A 档:坏值拒启,不静默折默认)。
  *
  * ## 词源:取不到型,就取那句自述 + 一格钉
  * 词表的上游属主是 `@sema-agent/settings-schema` 的 `ModelEntry.provider`。它的 zod 形是
@@ -14,7 +14,7 @@
  * 那两张能取型的表不同),但它的 JSDoc 逐字写着三词与各自的腿:
  *   > Routes the brain in the service (createRoutingBrain by provider): "gateway"/"vllm" → OpenAI brain,
  *   > "anthropic" → Anthropic brain.
- * 于是本仓建闭集常量,并由 `test/config-coverage-model-plane.test.ts` 的 S-461 ④ 格**钉住它与那句自述同集**
+ * 于是本仓建闭集常量,并由 `test/config-coverage-model-plane.test.ts` 的 [ref] ④ 格**钉住它与那句自述同集**
  * (读的是装载的那份 dist,不手抄第二份词表)。上游哪天把词表写进 zod enum,那一格会告诉我们该改成取型。
  *
  * ## 三条腿各自的边界(刻意分开写)
@@ -70,14 +70,14 @@ export declare function modelBrainLane(provider: ModelProvider): ModelBrainLane;
  * 「目录里写了个没人认识的 provider」这件事在代码里有一处可指的坐标,而不是散在两个 `=== "anthropic"` 里。
  *
  * ⚠️ **未闭环(收窄后如实)**:认不出的目录词今天仍然**无声**地落进网关腿(OpenAI 兼容;条目带自己的 baseUrl /
- * 钥匙,打的是它自己的端点 —— 不是凭据越界,是词面失真)。S-704(7.101.0)已把**热路径上的逐条判据**落地
+ * 钥匙,打的是它自己的端点 —— 不是凭据越界,是词面失真)。[ref](7.101.0)已把**热路径上的逐条判据**落地
  * (`model-entry-refusal.ts`:本部署没有对应 brain 的条目整条不可用 —— 今天那一形是「anthropic 词 + 本机没装
  * anthropic 路由」),但**域外词**是否也该不可用是另一个问题(web-admin 的新条目缺省就写 `"openai"`,预设写厂商名;
  * 把它们判不可用会让大量在跑的目录整条消失),另车带三问定。在这里加一个 throw 会让一次热发布打死在跑的副本,方向反了。
  */
 export declare function catalogBrainLane(provider: string | undefined): ModelBrainLane;
 /**
- * 🔴 **本部署装上的路由表的唯一铸法**(core 7.53.0 #1842;S-623 的「词 ∧ 路由装上」合取由此收成「问表」)。
+ * 🔴 **本部署装上的路由表的唯一铸法**(core 7.53.0 [ref];[ref] 的「词 ∧ 路由装上」合取由此收成「问表」)。
  *
  * 键 = `createRoutingBrain` 选线读的那个词(`model.provider`),值 = 那条路由上的东西 —— `createBrain` 铸 brain 交给路由器,判词侧(启动摘要、端点判官、
  * hook 选线)铸路由自己的配置交给 {@link brainLaneFor}(core 的判官从不读值,只问 `Object.hasOwn(routes, word)`)。两侧走同一只函数 ⇒ 同一组键,
@@ -85,13 +85,13 @@ export declare function catalogBrainLane(provider: string | undefined): ModelBra
  *
  * `anthropic` 键在场 ⇔ anthropic 路由装上(`ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN` 在场 ⇒ `config.anthropic` 在场);没装时**键缺席**,
  * 绝不写成 `{ anthropic: undefined }` —— core 7.53.0 起「装上的键而值不是 brain」是一条坏线路(该请求 error terminal),不再回落网关
- * (core CHANGELOG #1842「the key must be absent, not `undefined`」)。视图上 `anthropic` 的自有键带 `undefined`(配置对象的形)照样读成没装。
+ * (core CHANGELOG [ref]「the key must be absent, not `undefined`」)。视图上 `anthropic` 的自有键带 `undefined`(配置对象的形)照样读成没装。
  */
 export declare function mountRoutes<R extends object, T>(view: {
     readonly anthropic?: R | undefined;
 }, mount: (route: R) => T): Readonly<Record<string, T>>;
 /**
- * 🔴 **anthropic 路由的请求根** —— 唯一读法(S-1655 / core 7.53.0 #1905)。声明了 `ANTHROPIC_BASE_URL` ⇒ 它;没声明 ⇒ core 包根导出的 `ANTHROPIC_DEFAULT_BASE_URL`
+ * 🔴 **anthropic 路由的请求根** —— 唯一读法([ref] / core 7.53.0 [ref])。声明了 `ANTHROPIC_BASE_URL` ⇒ 它;没声明 ⇒ core 包根导出的 `ANTHROPIC_DEFAULT_BASE_URL`
  * (引擎的 Anthropic brain 的请求根与配对律的车道缺省、`fable5Model` 预设的 `baseUrl` 读的同一只常量)。「没声明」按引擎的读法:缺席、空串、纯空白都是没声明
  * (core 原话:「nothing, an empty string and whitespace read as undeclared」)。修前本仓两处手抄字面量:主路由的声明根(`brain.ts`,`??`)与 hook 的 anthropic 腿根
  * (`hooks/hook-llm.ts`,`||`)—— 一个根、两份拷贝、两种合取。
@@ -111,16 +111,16 @@ export declare function routeTableOf<R extends object>(view: {
 /**
  * 🔴 **一条目录条目在本部署上真正落哪条 brain 腿**(= 引擎路由器对同一只表的答案,不是词面)—— 唯一判词。
  *
- * 判据是 core 包根导出的 `brainLaneOf({ provider }, routes)`(core 7.53.0 #1842):`createRoutingBrain` 对每个请求问的正是它,所以引擎主路由与本仓的
+ * 判据是 core 包根导出的 `brainLaneOf({ provider }, routes)`(core 7.53.0 [ref]):`createRoutingBrain` 对每个请求问的正是它,所以引擎主路由与本仓的
  * 四处调用点(主路由降级腿与启动摘要在 `brain.ts`、端点判官 `model-route-endpoint.ts`、hook 选线 `hooks/hook-llm.ts`)读**一个**答案。修前本仓自写一只
- * 合取 `dispatchBrainLane(provider, anthropicRouteMounted)`(`catalogBrainLane(provider) === "anthropic" ∧ 路由装上`)—— 两份写法,S-1630 那次真病
+ * 合取 `dispatchBrainLane(provider, anthropicRouteMounted)`(`catalogBrainLane(provider) === "anthropic" ∧ 路由装上`)—— 两份写法,[ref] 那次真病
  * (hook 面按词面判线、主路由按装配判线)就是两份写法分叉的样子。
  *
  * core 的答案是路由名或 `undefined`(网关 fallback 服务它:词下没装路由,或没有 string 词)。本部署只装 `anthropic` 一条路由(表的唯一铸法 {@link mountRoutes}),
  * 所以答案映到本仓两词闭集:`"anthropic"` ⇒ anthropic 腿,`undefined` ⇒ 网关腿;别的名字结构上不可能(表里没有那个键),真撞上 ⇒ **响亮抛**([ref]:运行期
  * miss 臂必须说出来,不静默折网关)。
  *
- * S-704(7.101.0):**目录条目**到不了「anthropic 词、路由没装」这一格 —— 模型面 stage 的逐条判据把它判成不可用(`config.model_no_brain`,那一判问的是
+ * [ref](7.101.0):**目录条目**到不了「anthropic 词、路由没装」这一格 —— 模型面 stage 的逐条判据把它判成不可用(`config.model_no_brain`,那一判问的是
  * 「词想要的腿装没装」,{@link catalogBrainLane},与本判词是两个问题)。这一格今天只剩 **env 腿**:`MODEL_PROVIDER=anthropic` 而没配 anthropic 凭据的部署,
  * env 模型落网关腿、用的是网关自己的 `MODEL_API_KEY`(凭据与端点同属网关,不越界)。
  */

package/dist/model-reach-scope.d.ts

@@ -1,5 +1,5 @@
 /**
- * S-925(7.108.0)—— 「这次模型调用的每一次出网尝试落在哪」的**异步作用域**(叶:只引 node 与类型)。
+ * [ref](7.108.0)—— 「这次模型调用的每一次出网尝试落在哪」的**异步作用域**(叶:只引 node 与类型)。
  *
  * 两层,一只 `AsyncLocalStorage`:
  *  · **腿层**(`withModelReachScope`,三条带用户面投递口的 run 腿各包一次:流式 `POST /v1/tasks/stream`、后台 `POST /v1/runs`、续跑):

package/dist/model-route-endpoint.d.ts

@@ -1,7 +1,7 @@
 /**
- * S-623 —— **openai 兼容路由的有效端点**:解析规则与「解析不到」的拒因,唯一属主。
+ * [ref] —— **openai 兼容路由的有效端点**:解析规则与「解析不到」的拒因,唯一属主。
  *
- * ## 病(事实,主会话 09-23 12:40 亲核 + cli L-589 真案)
+ * ## 病(事实,主会话 09-23 12:40 亲核 + cli [ref] 真案)
  * `MODEL_GATEWAY_BASEURL` 曾有一个出厂缺省(本机 8000 端口的 `/v1`)。缺省值在读入那一步就把「来源」抹掉了:
  * 只设 `MODEL_ID` + key 的隔离配置照常起,第一次模型调用才在 core 的 `describeNetworkError` 里炸成
  * `fetch failed (connect ECONNREFUSED …:8000)` —— core 不知道、也不该知道那个端点是缺省值;compose 的
@@ -14,7 +14,7 @@
  * base URL(路由自己的 `baseUrl`,或显式设了的网关),否则拒。** 附带一条同类:备用网关
  * (`MODEL_GATEWAY_FALLBACK_URLS`)是主网关的镜像,没有主就没有镜像 ⇒ 拒。
  *
- * ## 执法点(判据只在这里,执法点在调用处 —— 与 S-475 `gateway-url-userinfo` 同形)
+ * ## 执法点(判据只在这里,执法点在调用处 —— 与 [ref] `gateway-url-userinfo` 同形)
  * **判官只判「将要服务的那张表」,拒因句按视图说真话**(视图词 = {@link ModelTableLeg} 两词,进判据入参,不靠调用方拼句):
  *  · boot:装配第 2 段**目录应用之后**的跨域不变量区(`boot/stage-02-web-admin-pull.ts`,锚 `CROSS-INVARIANT:model-route-endpoint`)⇒ 拒启 ——
  *    经 {@link judgeServedModelRoute}:目录被采纳 ⇒ 判目录表(目录视图),目录缺席 / 被整拒 / 没有启用条目 ⇒ 判 env 表(env 视图);
@@ -29,7 +29,7 @@
  *    {@link openaiRouteBaseUrl},不再各写一个 `model.baseUrl || gatewayBaseUrl`。
  *
  * ## 三问
- *  · **谁需要**:忘设端点的本机 / 隔离配置用户与 compose 直用者(cli L-589)—— 他们今天起得来、第一次调用才炸;
+ *  · **谁需要**:忘设端点的本机 / 隔离配置用户与 compose 直用者(cli [ref])—— 他们今天起得来、第一次调用才炸;
  *  · **谁受伤**:隐式依赖本机 8000 网关(如 vLLM 缺省端口)的部署,从「照常起」变成「拒启」;
  *  · **补偿**:显式写一行 —— 拒因原样给出这一行({@link LOCAL_GATEWAY_HINT})。
  *
@@ -101,7 +101,7 @@ export interface ModelRouteEndpointView {
  * 与别的键指同一只对象时不重复点名;只有它一个键时(手搓夹具)照样点名 `default`。
  */
 export declare function modelRouteEndpointRefusal(view: ModelRouteEndpointView, leg: ModelTableLeg): string | undefined;
-/** S-768:部署级判决的结构化形 —— 码与拒因句由**同一次**判决给出(一个不变量 id 两个码,组拒码在判决那刻当数据带出,不从句子里抠)。 */
+/** [ref]:部署级判决的结构化形 —— 码与拒因句由**同一次**判决给出(一个不变量 id 两个码,组拒码在判决那刻当数据带出,不从句子里抠)。 */
 export interface ModelRouteEndpointVerdict {
     readonly code: typeof GATEWAY_FALLBACK_WITHOUT_PRIMARY_CODE | typeof MODEL_ROUTE_ENDPOINT_MISSING_CODE;
     /** 出路轴({@link MODEL_ROUTE_GAP_WORDS}):同一次判决给出,不从句子或码里反推(`lane_credential_missing` 与 `endpoint_missing` 共用一个码)。 */
@@ -109,7 +109,7 @@ export interface ModelRouteEndpointVerdict {
     readonly reason: string;
 }
 /**
- * **判据属主**(S-768 起的结构化形;{@link modelRouteEndpointRefusal} 是它的句子投影):`undefined` = 通过。判序即 {@link modelRouteEndpointRefusal}
+ * **判据属主**([ref] 起的结构化形;{@link modelRouteEndpointRefusal} 是它的句子投影):`undefined` = 通过。判序即 {@link modelRouteEndpointRefusal}
  * 头注所列 —— ① 备用无主先说,② 逐条目解析不到端点全部点名。加一枝 = 在这里同时给出码与句(返回型强制两者同在)。
  * `leg` = `view.models` 是哪一张表({@link ModelTableLeg}):判据本身两视图同一把,**句子**按视图铸(出路在 env 表与目录表上不是同一组)。
  */

package/dist/model-route-gap.d.ts

@@ -64,11 +64,14 @@ export interface ModelRouteEnvReading {
      * 它只与网关端点配对(没有 {@link gatewayBaseUrl} 就不装载),配对由消费方判。
      */
     readonly gatewayApiKey: string | undefined;
-    /** `ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`:空串 = 未设,别名各自独立(一个空别名不遮蔽另一个)。 */
+    /**
+     * `ANTHROPIC_API_KEY` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_BASE_URL`:空串 = 未设,各自独立(一个空的不遮蔽另一个)。
+     * 两把凭据**各是各的头**(`x-api-key` / `Authorization: Bearer`),同设是起服拒启的形 —— 读数原样交出两把,取哪种头只问 {@link judgeAnthropicCredential}。
+     */
     readonly anthropicApiKey: string | undefined;
     readonly anthropicAuthToken: string | undefined;
     readonly anthropicBaseUrl: string | undefined;
-    /** anthropic 路由装不装 = 两把凭据任一在场(`createBrain` 同判);只读在场性。 */
+    /** anthropic 路由装不装 = 两把凭据任一在场(`createBrain` 同判);只读在场性(同设由起服拒启,不在读数里判)。 */
     readonly anthropicRouteMounted: boolean;
     /**
      * env 腿模型的 provider 词:显式 `MODEL_PROVIDER` 胜(原样,**不在此过闭集** —— 域外拒启是 `model-provider-word` 那条不变量的事);
@@ -90,6 +93,47 @@ export declare const csvOf: (raw: string | undefined) => string[];
  * `parseModelDomain`(起服铸 `ServiceConfig`)吃它的读数。
  */
 export declare function readModelRouteEnv(env: ModelRouteEnv): ModelRouteEnvReading;
+/**
+ * **anthropic 车道凭据的唯一判官**(一名一义):两个名字各走各的头、互斥 ——
+ *  · `ANTHROPIC_API_KEY`    ⇒ `x-api-key`(只发它);
+ *  · `ANTHROPIC_AUTH_TOKEN` ⇒ `Authorization: Bearer`(只发它);
+ *  · 两个都设 ⇒ `conflict`:两个名字说的是两种头,哪个赢都是替运维猜(7.135.0 及以前是「AUTH_TOKEN 优先」,x-api-key 被静默丢弃)⇒ 起服拒启,拒句 {@link anthropicCredentialRefusal}。
+ * 空串 = 未设(与 {@link readModelRouteEnv} 同尺)。入参是两个名字各自的值 —— env 读数的两位或 `config.anthropic` 的 `apiKey` / `authToken` —— 不读 `process.env`。
+ * 读者:起服(`config.ts` 的拒启锚与跨键不变量表 `anthropic-credential-exclusive` 同一句)· brain 装配(交引擎哪种头)· hook 直连腿(哪种头、交引擎配对判官的那份值)·
+ * 车道端口 {@link laneAndEndpointFor}(哪把键)· 起服的 Bearer 部署诊断(`boot/web-admin.ts`)。
+ */
+export type AnthropicCredentialVerdict = {
+    readonly kind: "absent";
+} | {
+    readonly kind: "x-api-key";
+    readonly envName: typeof MODEL_ROUTE_ENV_KEYS.anthropicApiKey;
+    readonly value: string;
+} | {
+    readonly kind: "bearer";
+    readonly envName: typeof MODEL_ROUTE_ENV_KEYS.anthropicAuthToken;
+    readonly value: string;
+} | {
+    readonly kind: "conflict";
+};
+/** 判官的入参:两个名字各自的值(`config.anthropic` 的两位与 env 读数的两位都映射成这一形)。 */
+export interface AnthropicCredentialNames {
+    readonly apiKey?: string | undefined;
+    readonly authToken?: string | undefined;
+}
+export declare function judgeAnthropicCredential(names: AnthropicCredentialNames): AnthropicCredentialVerdict;
+/** 同设拒启的机读码(拒句方括号里)。 */
+export declare const ANTHROPIC_CREDENTIAL_CONFLICT_CODE = "config.anthropic_credential_conflict";
+/** {@link judgeAnthropicCredential} 的拒句投影:`conflict` ⇒ 一句点名两键与出路(不回显任何值);其余 ⇒ `undefined`。 */
+export declare function anthropicCredentialRefusal(names: AnthropicCredentialNames): string | undefined;
+/** 一份会上线的 anthropic 车道凭据(判官的两种头形)。 */
+export type AnthropicLaneCredential = Extract<AnthropicCredentialVerdict, {
+    kind: "x-api-key" | "bearer";
+}>;
+/**
+ * 判官的**取值面**:这条车道会带上的那一份(头形 + 值);缺席 ⇒ `undefined`;同设 ⇒ **抛**拒句 ——
+ * 起服已在 `loadConfig` 拒启这一形,到得了这里的只有绕过起服装配、自拼配置的嵌入方(响亮,不替它挑一个)。
+ */
+export declare function anthropicLaneCredentialOf(names: AnthropicCredentialNames): AnthropicLaneCredential | undefined;
 /**
  * **env 腿的条目表** —— 主槽别名 `default` + 主槽 id(+ 铸出的 cheap 槽);没有 `MODEL_ID` ⇒ 空表(不铸占位条目:一个不存在的模型名
  * 进可选目录 / 当缺省,正是 3.0.0 删掉的那种病)。`parseModelDomain` 铸真 `Model` 表与判官铸路由切面都经这一只,条目名与键序不会各写一份。
@@ -116,7 +160,7 @@ export interface LaneAndEndpoint {
     readonly endpointDeclared: boolean;
     /**
      * 这条腿此刻真会带上的凭据那把 env 键;没有会装载的凭据 ⇒ `undefined`。
-     *  · anthropic 腿:`ANTHROPIC_AUTH_TOKEN` 压过 `ANTHROPIC_API_KEY`(引擎装配同序),空串别名不遮蔽另一把;
+     *  · anthropic 腿:设了哪一把就是哪一把(一名一义,{@link judgeAnthropicCredential} —— 引擎装配同一只判官),空串不遮蔽另一把;两把同设 ⇒ 抛起服那一句拒句;
      *  · 网关腿:`MODEL_API_KEY`,**只在端点声明时**(凭据只与网关自己的根配对;没有网关就不装载),空串 = 没有凭据(keyless 部署)。
      */
     readonly apiKeyEnvName: ModelRouteEnvName | undefined;
@@ -128,7 +172,8 @@ export interface LaneAndEndpoint {
  * 键名 = {@link MODEL_ROUTE_ENV_KEYS}。`routes` 是 core 路由表的原型(`Object.hasOwn(routes, 词)` 的表;`anthropic` 键在场 ⇔ anthropic 路由装上)。
  * **只交键名不交值**:凭据与端点的值调用方自己从 env 取,本函数的答案里没有任何 env 值。
  *
- * 纯:不读 `process.env`,只按键表点名取值、不枚举入参。路由表里有本部署从不装的键(表在 `mountRoutes` 之外铸)⇒ 抛(`brainLaneFor` 的响亮臂),不折网关。
+ * 纯:不读 `process.env`,只按键表点名取值、不枚举入参。路由表里有本部署从不装的键(表在 `mountRoutes` 之外铸)⇒ 抛(`brainLaneFor` 的响亮臂),不折网关;
+ * anthropic 腿两把凭据同设 ⇒ 抛起服的同一句拒句({@link anthropicLaneCredentialOf}:引擎在这一形上拒启,端口不替它答一把)。
  */
 export declare function laneAndEndpointFor(env: ModelRouteEnv, model: ModelRouteSubject, routes: Readonly<Record<string, unknown>>): LaneAndEndpoint;
 //# sourceMappingURL=model-route-gap.d.ts.map

package/dist/model-route-gap.js

@@ -56,6 +56,39 @@ export function readModelRouteEnv(env) {
                     : { kind: "minted", id: rawCheapId },
     };
 }
+export function judgeAnthropicCredential(names) {
+    const K = MODEL_ROUTE_ENV_KEYS;
+    const apiKey = declaredValue(names.apiKey);
+    const authToken = declaredValue(names.authToken);
+    if (apiKey !== undefined && authToken !== undefined)
+        return { kind: "conflict" };
+    if (apiKey !== undefined)
+        return { kind: "x-api-key", envName: K.anthropicApiKey, value: apiKey };
+    if (authToken !== undefined)
+        return { kind: "bearer", envName: K.anthropicAuthToken, value: authToken };
+    return { kind: "absent" };
+}
+export const ANTHROPIC_CREDENTIAL_CONFLICT_CODE = "config.anthropic_credential_conflict";
+export function anthropicCredentialRefusal(names) {
+    if (judgeAnthropicCredential(names).kind !== "conflict")
+        return undefined;
+    const K = MODEL_ROUTE_ENV_KEYS;
+    return (`[${ANTHROPIC_CREDENTIAL_CONFLICT_CODE}] both ${K.anthropicApiKey} and ${K.anthropicAuthToken} are set — they are two different credentials ` +
+        `(${K.anthropicApiKey} is sent as the x-api-key header, ${K.anthropicAuthToken} as Authorization: Bearer) and the Anthropic route carries exactly one; ` +
+        `keep the one your endpoint expects and unset the other`);
+}
+export function anthropicLaneCredentialOf(names) {
+    const verdict = judgeAnthropicCredential(names);
+    switch (verdict.kind) {
+        case "absent":
+            return undefined;
+        case "x-api-key":
+        case "bearer":
+            return verdict;
+        case "conflict":
+            throw new Error(anthropicCredentialRefusal(names));
+    }
+}
 export function envLaneTable(mainId, main, cheap) {
     if (mainId === "")
         return {};
@@ -74,7 +107,7 @@ export function laneAndEndpointFor(env, model, routes) {
                 lane,
                 endpointEnvName: K.anthropicBaseUrl,
                 endpointDeclared: declaredRootUrl(reading.anthropicBaseUrl) !== undefined,
-                apiKeyEnvName: reading.anthropicAuthToken !== undefined ? K.anthropicAuthToken : reading.anthropicApiKey !== undefined ? K.anthropicApiKey : undefined,
+                apiKeyEnvName: anthropicLaneCredentialOf({ apiKey: reading.anthropicApiKey, authToken: reading.anthropicAuthToken })?.envName,
             };
         case "gateway": {
             const endpointDeclared = declaredRootUrl(reading.gatewayBaseUrl) !== undefined;

package/dist/model-route-url.d.ts

@@ -1,10 +1,10 @@
 /** 机读码(拼法随 `config.<键名蛇形>_*` 既有族:`config.model_provider_invalid` / `config.retention_policy_invalid`)。 */
 export declare const GATEWAY_URL_USERINFO_CODE = "config.gateway_url_userinfo";
-/** 同族第二码(S-483 座⑨):这一位不是一个层级式 http(s) URL(不透明 / 解析不动 / 非 http(s) —— S-1269 起后者同码)。三根键共用一码,
+/** 同族第二码([ref] 座⑨):这一位不是一个层级式 http(s) URL(不透明 / 解析不动 / 非 http(s) —— [ref] 起后者同码)。三根键共用一码,
  *  与上面那只同纪律(码按**规则**命名,不按键名 —— 键名已经逐字在拒因文案里点过了)。 */
 export declare const MODEL_ROUTE_URL_INVALID_CODE = "config.model_route_url_invalid";
 /**
- * 🔴 **第三条臂的机读码(S-514;core 7.24.2 / [ref] 提货)——请求根带 `#fragment`**。
+ * 🔴 **第三条臂的机读码([ref];core 7.24.2 / [ref] 提货)——请求根带 `#fragment`**。
  *
  * 为什么与前两条各自一码:运维要按码行动,而三条臂的**出路不同**(补全 URL / 把凭据搬去旋钮 / 删掉 `#`
  * 之后的一切)。`fetch` **从不把 fragment 发上线**,所以这一形此前是**静默**打根自己的路径、端点后缀整段
@@ -19,10 +19,10 @@ export declare const MODEL_ROUTE_URL_FRAGMENT_CODE = "config.model_route_url_fra
  * 拒因四件齐:**码** + **哪个 env 键** + **值的样子**(判官的 `buildRefusalShownUrl`:层级式只到 `scheme://host[:port]` + `/…`,不透明形整只成记号 ——
  * 运维要靠 host 认出是哪一条路由,而密码一个字节都不许进启动错误)+ **出路一句**(点名真实旋钮)。
  *
- * ① 为什么在**声明关口**而不是「由别的门管」(S-483 座⑨):半写 userinfo `http://user:pass@`(解析不动)与 `alice:pw@host:8000`
+ * ① 为什么在**声明关口**而不是「由别的门管」([ref] 座⑨):半写 userinfo `http://user:pass@`(解析不动)与 `alice:pw@host:8000`
  * (不透明 URL,`username`/`password` 恒空)两形若被当「无凭据」放行,一路到 brain 装配期才由 core 拒,拒启点越晚运维越读不出
- * 是哪根旋钮配错了;层级式非 http(s)(`ftp://h/v1`)对 `fetch` 同样必然失败(S-1269 起同判,修前放行)。
- * ③ 判在声明关口而不是留给 core 的 brain 构造期(S-514):core 的拒因只过位置律、pathname 逐字,`…/v1/sk-…#note` 那一形的
+ * 是哪根旋钮配错了;层级式非 http(s)(`ftp://h/v1`)对 `fetch` 同样必然失败([ref] 起同判,修前放行)。
+ * ③ 判在声明关口而不是留给 core 的 brain 构造期([ref]):core 的拒因只过位置律、pathname 逐字,`…/v1/sk-…#note` 那一形的
  * core 拒因会把 path 上的令牌原文打进启动日志 —— 值在到达 core 之前就被这里拒掉,那条文本根本不由 core 铸。
  *
  * @param envKey 出问题的那根 env 旋钮的名字(CSV 键上还带第几项)。

package/dist/model-select.d.ts

@@ -85,7 +85,7 @@ export declare function resolveTaskModel(bodyModel: unknown, objective: string,
     unavailable?: ModelUnavailable;
 };
 /**
- * S-704 判别式拒因:这次**用户选择**点中的是一条已发布、但本部署不可用的目录条目(`config.modelRefusals`)。
+ * [ref] 判别式拒因:这次**用户选择**点中的是一条已发布、但本部署不可用的目录条目(`config.modelRefusals`)。
  * 与 {@link ModelNotAllowed} 同一种处置口:本函数不 throw,调用点按 leg 分流(fresh 400 `request.model_unavailable` /
  * resume 留声降级)。拒因句由 `model-entry-refusal.ts` 的 `modelUnavailableMessage` 铸(一处)。
  */
@@ -99,13 +99,13 @@ export interface ModelUnavailable {
     source: "explicit" | "mention";
 }
 /**
- * S-704 —— **用户可选目录**:服务的目录经 core `expandTiers` 增广(档位词 / CC 别名 / `best`),再把**不可用条目的名字**
+ * [ref] —— **用户可选目录**:服务的目录经 core `expandTiers` 增广(档位词 / CC 别名 / `best`),再把**不可用条目的名字**
  * 从增广出来的别名键里**让出**。全部用户**显式**选择通道(body.model / `@name` / settings.model / compactionModel /
  * agents[].model / side-query 的 body.model / 名单判定 / `/v1/models` 的可点性)都在这一只上解析 —— 一个优先序,不各写一份;
  * 与之配套的另一半是 {@link matchCatalogModel} 的「保留名不走 id 回退」。
  * ⚠️ 射程只到显式选择:引擎自己的隐式选路(角色的档位缺省、档位梯、workflow 名单在 core 里的解析)用的是 core 的增广目录,
  * 本函数**不**进那里(codex 验修轮 V4:让出名字会改变只带 `modelRole` 的隐式选路)。不可用条目名撞上别名词时引擎侧的改绑
- * (运维配置里点名它的角色绑定 / workflow 名单)自 S-712 起由不变量 `refused-names-not-minted`(`model-entry-refusal.ts`)在
+ * (运维配置里点名它的角色绑定 / workflow 名单)自 [ref] 起由不变量 `refused-names-not-minted`(`model-entry-refusal.ts`)在
  * 源头收口:增广会把被拒名铸到别的条目上的候选,模型面整组被拒、进不了引擎 —— 于是本函数的「让出」在已采纳的配置上恒是
  * 空操作,保留作 HTTP 选择面的第二道(绕过 stage 的写者若造出这种表,选择面仍不改绑)。
  *
@@ -117,7 +117,16 @@ export interface ModelUnavailable {
  */
 export declare function selectableCatalog<M>(models: Record<string, M>, tiers: Record<string, string> | undefined, refusals: Readonly<Record<string, ModelEntryRefusal>> | undefined): Record<string, M>;
 /**
- * S-704 —— ref(name 或上游 id)→ 它命中的**不可用条目**;未命中 ⇒ undefined。与 {@link matchCatalogModel} 同一种双键
+ * [ref] —— 选择面**认**、目录行(`GET /v1/models` 的 `models[]`,即 `models` 里 `default` 以外的键)**不列名**的词:`default` 别名(服务表有缺省才在)、
+ * 增广铸出的档位词 / CC 别名 / `best`(按部署绑定如实)、以及按上游 id 认的写法。成员资格**由受理口自己的判官定**:候选 = `selectable` 的键与其中条目的 id,
+ * 逐个问 {@link matchCatalogModel}(`body.model` 门调的就是它;门在它之前只先判「非空串」,空串在这里同样不算)—— 判官认 ⇒ 列,不认 ⇒ 不列。本仓不写词表,也不在读面另写一份匹配规则(名先于 id、
+ * 不可用条目的名字不按 id 解、`default` 键不参与 id 扫描,全在判官里):判官怎么改,读面跟着变。
+ * `selectable` 必须是同一份配置上 {@link selectableCatalog} 的产物(读面把可点性判定用的那一只同一个对象传进来:一张表,两个读数)。
+ * 序 = 键在前(可选目录键序)、id 在后(条目序),去重;确定性,消费方按集合读。
+ */
+export declare function selectableAliasNames(models: Record<string, unknown>, selectable: Record<string, unknown>, refusals: Readonly<Record<string, ModelEntryRefusal>> | undefined): string[];
+/**
+ * [ref] —— ref(name 或上游 id)→ 它命中的**不可用条目**;未命中 ⇒ undefined。与 {@link matchCatalogModel} 同一种双键
  * 索引(name 用 `Object.hasOwn`,id 扫值)。调用方**先**查可用目录、再查这里(一个 id 被可用与不可用条目共享时,可用那条胜)。
  */
 export declare function refusedCatalogEntry(ref: string, refusals: Readonly<Record<string, ModelEntryRefusal>> | undefined): {
@@ -148,7 +157,7 @@ export interface ModelNotAllowed {
  * 可用目录收窄成目录名(settings-schema `narrowAtMention`),名单项是档位词 / 别名 / id 的形只可能来自绕过 stage 的写者 —— 它们准不了任何东西。
  * 🔴 **刻意没有「id 相等」退路**(codex 复审 R1 [high]):目录**允许两条不同 name 的条目共享同一个上游 `Model.id`,却各自带不同的
  * `baseUrl` / `apiKeyEnv` / `cost` / provider** —— 按 id 判同会把 `safe` 与 `premium` 合并,一张只含 `safe` 的名单会放行 `premium`。
- * 🔴 S-704:名里写着一条**不可用**条目的名字 ⇒ 它准不了任何东西(不经 id 回退 / 别名改绑去准另一只模型 —— `matchCatalogModel` 的名字保留律)。
+ * 🔴 [ref]:名里写着一条**不可用**条目的名字 ⇒ 它准不了任何东西(不经 id 回退 / 别名改绑去准另一只模型 —— `matchCatalogModel` 的名字保留律)。
  * `only` 的名在 stage 期已按本世代可用目录收窄过(settings-schema `narrowAtMention`,收窄到一个不剩 ⇒ `none`),所以这里的悬空名只来自绕过 stage 的写者(按名直比,悬空名不等于任何条目的名)。
  *
  * ⚠️ 射程:本门是**提交时**门。core 运行时路由(degrade 降级链 / cascade 梯 / roles 解析)按 operator 配置自己走,**不经本门**。
@@ -169,7 +178,7 @@ export declare function terminalCatalogName(ref: string, catalog: Record<string,
  *    索引下是真值,会跳过 allow-list——沿袭原实现的纪律)。
  *  - id 命中扫目录值(`Model.id`),跳过 "default" 别名键(它与其指向的真身共享 id,解析到别名会让 /model
  *    面板与实际路由再度撕裂);同 id 多 name 时取目录序第一个(与 /v1/models 列表序一致,确定性)。
- *  - 🔴 S-704(codex 验修轮 V1):**名字先于 id** 这条序对不可用条目同样成立 —— `refusals` 里的名字是一条已发布
+ *  - 🔴 [ref](codex 验修轮 V1):**名字先于 id** 这条序对不可用条目同样成立 —— `refusals` 里的名字是一条已发布
  *    条目的名字,它不在可用目录里时**不许**被 id 回退解析成另一条可用条目(v7.100.0 那条条目在目录里,name 命中先返回
  *    它自己)。命中保留名 ⇒ undefined,调用方接着问 {@link refusedCatalogEntry} 拿拒因码。
  */

package/dist/model-select.js

@@ -67,6 +67,11 @@ export function selectableCatalog(models, tiers, refusals) {
         delete out[n];
     return out;
 }
+export function selectableAliasNames(models, selectable, refusals) {
+    const candidates = new Set([...Object.keys(selectable), ...Object.values(selectable).map((m) => m?.id)]);
+    const rowNamed = (w) => w !== DEFAULT_MODEL_REF && Object.hasOwn(models, w);
+    return [...candidates].filter((w) => typeof w === "string" && w.length > 0 && !rowNamed(w) && matchCatalogModel(w, selectable, refusals) !== undefined);
+}
 export function refusedCatalogEntry(ref, refusals) {
     if (refusals === undefined)
         return undefined;

package/dist/model-unreachable-notice.d.ts

@@ -1,12 +1,12 @@
 /**
- * S-925(7.108.0;test [ref] ② 用户报案分诊,验收 `srv7108-s925-connect-timeout-diagnostic`)—— **模型调用因建连失败终态**时
+ * [ref](7.108.0;test [ref] ② 用户报案分诊,验收 `srv7108-s925-connect-timeout-diagnostic`)—— **模型调用因建连失败终态**时
  * 给这条腿的用户铸的通告 `server.model_unreachable` 的**唯一铸点**,与把它挂到每一次模型调用上的 brain 装饰器。
  *
  * ## 病
  * 运营用户看不到日志 / 诊断面:VPN 中途切换之后模型网关建连超时,用户只拿到一句 undici 原句(`fetch failed (connect …)`),
  * 分不清是网络断了还是起服时读进的代理已经失效,也没有「查 VPN / 代理、代理变过就重启」这条出路。只落运维日志不算闭环
- * (test 立案原话)。core 没有现成的「模型不可达」用户通告码 ⇒ 本仓铸,走既有的本仓铸码族(S-690 形:白名单 / 归属 / 消毒 / 隔离四件判据
- * 一个不绕),不开第二条通道。core 7.38.0(#1240)起本码在 core 码册里:受众 `NOTICE_AUDIENCE` = user、铸者 `NOTICE_MINTER` = `"server"`。
+ * (test 立案原话)。core 没有现成的「模型不可达」用户通告码 ⇒ 本仓铸,走既有的本仓铸码族([ref] 形:白名单 / 归属 / 消毒 / 隔离四件判据
+ * 一个不绕),不开第二条通道。core 7.38.0([ref])起本码在 core 码册里:受众 `NOTICE_AUDIENCE` = user、铸者 `NOTICE_MINTER` = `"server"`。
  *
  * ## 判据(一句):**这一次模型调用的终局是 `stopReason: "error"`,且它发出的最后一条请求在建连时就失败了**
  * 「最后一条请求落在哪」由出网观察者记在调用作用域上(`model-reach-scope.ts`,undici 诊断通道,见 `outbound-dispatcher.ts`)——

package/dist/namespaced-rule-name.d.ts

@@ -2,7 +2,7 @@
  * 规则里的工具名**够不够得着**一只挂载工具 —— 判官只有一个:引擎的 `judgeRuleToolName`。本文件只剩「规则文本里工具名那一段怎么取」与「判词怎么说」。
  *
  * 一个名字永远匹配不到工具的成因,全是引擎判官的判词(`retired` / `unprefixed_namespace` / `unmintable_segment`,带 `guidance` 与 1:1 `currentName`):
- * 退役名、无协议前缀的 `__` 短名、协议名的对端段引擎铸不出(`mcp__github.com__*`、`mcp__*`、`mcp____x`、`mcp__`),以及(core 7.48.0 #1400 起)
+ * 退役名、无协议前缀的 `__` 短名、协议名的对端段引擎铸不出(`mcp__github.com__*`、`mcp__git*`、`mcp____x`、`mcp__`),以及(core 7.48.0 [ref] 起)
  * **工具段为空**(`mcp__srv__` / `a2a__peer__`)。最后这一形 7.116.0–7.122.x 是本仓自答的(引擎判官当时答 `current`);引擎给了判词 ⇒ 本仓那一问
  * (本文件那只判与它在会话规则写口、SQL 店写口、四张条目表上的调用)退役,零双读。
  *
@@ -12,13 +12,13 @@
  * (名册 = {@link TOOL_NAME_ROSTER};判官判非现役的条目读成 `tool_name`,名册里有的只差大小写读成 `near_miss`)。
  * **不调它的面**:`/v1/rules` 的持久规则写口与 `cc-import` 导入口(`http/routes/rules.ts`、`rules-consent.ts` 与两只持久规则店零判官调用)—— 如实未接,
  * 在那里写铸不出的服务器段仍被收下、永不命中;把它接上判官 = 另一件事(`unmatchableRuleNameOf` 就是现成的那一只)。
- * 子代的工具名表 `agents[].allowTools` / `denyTools` 不是本文件的面:core 7.45.0 #1377 / #1385 起名字归引擎在开跑前一只判(三来源同判,`spec-fields.ts`
+ * 子代的工具名表 `agents[].allowTools` / `denyTools` 不是本文件的面:core 7.45.0 [ref] / [ref] 起名字归引擎在开跑前一只判(三来源同判,`spec-fields.ts`
  * 受理口只判形与条数),本仓不对它另做对照。
  * **精确名的工具段归一不在这里判**:包根没有导出工具段的铸法,不手抄 —— 精确名的工具段按字面收,本仓每张表上都不判它。
  *
  * 规则文本里「工具名那一段」怎么取也只有一种读法:{@link ruleEntryToolName}(配置表读它)。
  */
-import { type RuleToolNameVerdict } from "@sema-agent/core";
+import { type PermissionRule, type RuleToolNameVerdict } from "@sema-agent/core";
 /**
  * 一条**规则文本**里的工具名那一段(判官与旧名判据的主语)= core 包根 `parsePermissionRule` 的 `toolName`,原样 —— 引擎的技能编译器
  * (`compileSkillGrant`)与规则编译器读条目用的就是这一只:`Bash(npm:*)` ⇒ `Bash`;`mcp__srv(*)` / `mcp__srv()` / 带首尾空格的 `mcp__srv ` ⇒ 光杆名 `mcp__srv`。
@@ -39,8 +39,18 @@ export declare const TOOL_NAME_ROSTER: ReadonlySet<string>;
 export type UnmatchableRuleName = Exclude<RuleToolNameVerdict, {
     kind: "current";
 }>;
-/** 判:引擎判官非 `current` ⇒ 原样交回;`current` ⇒ `undefined`。 */
-export declare function unmatchableRuleNameOf(name: string): UnmatchableRuleName | undefined;
+/**
+ * **运维名表的态度** —— 一个常量,判官与匹配器同读(core 7.55.0 [ref])。本仓的名表消费者(env `APPROVAL_REQUIRE` / `APPROVAL_DENY` / `APPROVAL_NEVER_AUTO`、
+ * 中心下发的 `approvalRequire`、请求 `settings.permissions` 的 neverAuto 座)全是**限制表**(要求审批 / 硬拦 / 禁自动答):引擎对一个名字在限制表里的读法
+ * (`judgeRuleToolName(name, 名册, behavior)` 收不收、`isNamespacedCoveringRuleName(name, behavior)` 够着哪些工具)只分「限制 / 放行」两侧 —— 整个协议的名字
+ * `mcp__*` / `mcp__*__*` 在 deny 与 ask 里同读成这一协议的每一只工具。受理口的判(`config.ts`)与运行期的匹配(`approval.ts`)读同一个态度,一张表不会一边收、一边什么也不拦。
+ */
+export declare const NAME_TABLE_BEHAVIOR: "deny";
+/**
+ * 判:引擎判官**按这张表的态度**判这个名字,非 `current` ⇒ 原样交回;`current` ⇒ `undefined`。`behavior` 必填 —— 同一个名字在限制表与放行表里是两种读法
+ * (core 7.55.0 [ref]:`mcp__*` 在 deny / ask 里是这一协议的每一只工具、在 allow 里什么也不是),漏传态度的调用点是编译错,不是一条静默的「不带态度」读法。
+ */
+export declare function unmatchableRuleNameOf(name: string, behavior: PermissionRule["behavior"]): UnmatchableRuleName | undefined;
 /**
  * 判词 → 「为什么永远匹配不到 + 怎么写」(不复述条目本身 —— 调用方的句子已点名它)。引擎判词的 `guidance` 原样带出,是改法指引的**唯一**一句
  * (本仓不在后面追加 1:1 现名:通配名上那个现名是摘要名或更窄的写法,照写不生效;现名过境给机器读的位,如会话规则拒体顶层的 `currentName`);

package/dist/namespaced-rule-name.js

@@ -5,8 +5,9 @@ export function ruleEntryToolName(entry) {
     return parsePermissionRule(entry).toolName;
 }
 export const TOOL_NAME_ROSTER = new Set([...catalogToolNames(), ...HOST_TOOL_NAMES]);
-export function unmatchableRuleNameOf(name) {
-    const verdict = judgeRuleToolName(name, TOOL_NAME_ROSTER);
+export const NAME_TABLE_BEHAVIOR = "deny";
+export function unmatchableRuleNameOf(name, behavior) {
+    const verdict = judgeRuleToolName(name, TOOL_NAME_ROSTER, behavior);
     return verdict.kind === "current" ? undefined : verdict;
 }
 export function describeUnmatchableRuleName(v, name) {

package/dist/object-store-buckets.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The two object-store buckets this server reads from and never creates (`docs/DEPLOY-PREREQS.md` "对象存储桶"), and the name each takes when its
+ * knob is unset — ONE spelling of each default. The config loader (`config.ts`), the config catalog's default notes, the boot presence check's role
+ * table (`plugins/snapshot-bucket-presence.ts`) and the k8s adapter's refusal sentence all read these constants; a literal copied into any of them is
+ * a second source that drifts the day a default changes (the refusal would then name a bucket the loader no longer defaults to).
+ *
+ * Pure leaf: no imports.
+ */
+/** `SESSION_SNAPSHOT_BUCKET` unset ⇒ this bucket: snapshot-BLOB offload, and the SendUserFile private presigned track / sandbox staging. */
+export declare const SESSION_SNAPSHOT_BUCKET_DEFAULT = "session-snapshots";
+/** `WORKSPACE_SNAPSHOT_BUCKET` unset ⇒ this bucket: the k8s lane's workspace snapshots (cross-run space snapshots and parked-run archives). */
+export declare const WORKSPACE_SNAPSHOT_BUCKET_DEFAULT = "workspaces";
+//# sourceMappingURL=object-store-buckets.d.ts.map

package/dist/object-store-buckets.js

@@ -0,0 +1,3 @@
+export const SESSION_SNAPSHOT_BUCKET_DEFAULT = "session-snapshots";
+export const WORKSPACE_SNAPSHOT_BUCKET_DEFAULT = "workspaces";
+//# sourceMappingURL=object-store-buckets.js.map