@sema-agent/client-core 0.67.2 → 0.68.0

package/dist/autoModeUnavailable.js

@@ -61,6 +61,9 @@
  * 🔴 形制:`Object.freeze` 的数组,**不是**只在类型面只读的 `readonly T[]` —— 后者一行 `.splice()`
  *    就能改,而公面消费者拿到的正是这个实例(本仓已定谳的病形,同 `RESUME_RETRY_LATER_CODES`)。
  */
+// 🔴 0.68.0 / L-245:形制从 `readonly string[]` 改成**字面元组**(`as const`)—— 型面交得出成员
+//    字面量,端的型面才能**派生**而不是再抄一遍两个词(与 `runTerminal.ts` 的两表分源同一条medicine)。
+//    冻结的理由一字未改(公面消费者拿到的正是这个实例)。
 export const CLASSIFIER_DENY_CAUSES = Object.freeze(['unavailable', 'parse_error']);
 /** {@link CLASSIFIER_DENY_CAUSES} 的运行期成员判据(判据用它,别在端上再抄一张表)。 */
 const DENY_CAUSE_SET = new Set(CLASSIFIER_DENY_CAUSES);
@@ -103,6 +106,8 @@ export function classifierDenyCauseOf(gate) {
     const dd = d;
     if (dd.kind !== 'denied')
         return undefined;
+    // 🔴 0.68.0 / L-245:出参改**闭集成员型**(谓词已是型守卫)—— 读器闭集进、闭集出,措辞铸点
+    //    那一层的入参因此也能收窄,那条「结构不可达的兜底」于是变成编译期就闭的事(见下面那段)。
     return isClassifierDenyCause(dd.cause) ? dd.cause : undefined;
 }
 /**
@@ -142,6 +147,11 @@ export const AUTO_MODE_UNAVAILABLE_CAUSES = Object.freeze(['error', 'timeout']);
  *     重试解决不了,要去看那一轮的裁决散文 / 调分类器。
  * 🔴 两句**不许合并**:合并等于把「稍后重试」与「别重试」渲成同一句。
  */
+// 🔴 0.68.0 / L-245:表型从 `Record<string, string>` 改成 **`Record<ClassifierDenyCause, string>`**。
+//    这一改就是本件真正的「never 分支断言」:core 哪天加第三个词,元组长一员 ⇒ 成员型多一员 ⇒
+//    **这张表少一个键** ⇒ **编译期当场红**,逼人同批补那一句话。修前是 `Record<string,…>`,加词那天
+//    这里一声不响,靠的是运行期那句「a word newer than this client」的兜底 —— 而那句兜底**结构上
+//    走不到**(读器在上一层就按闭集把表外词判成缺席),所以它既拦不住漂移、也从来没说过话。
 const DENY_CAUSE_SENTENCES = Object.freeze({
     unavailable: 'denied because the auto-mode classifier could not run this round (the call may be retried later)',
     parse_error: 'denied because the auto-mode classifier answered outside its contract (its reply could not be parsed, so the call was blocked)',
@@ -151,18 +161,26 @@ const DENY_CAUSE_SENTENCES = Object.freeze({
  *
  * 🔴 **按自有属性查表**(与本包其余措辞铸点同一条纪律):`Object.freeze` 不移除原型,裸下标会让
  *    一个来自 wire 的 `constructor` / `toString` 命中 `Object.prototype` 上的**函数**并被当成一句话。
- * 🔴 表外词 / 坏值 ⇒ 一句**兜底**:仍然告诉用户「这次拒是分类器那条腿引出来的」,但**不冒充**
- *    两句里的任何一句;原样带上那个词供运维追问上游。
- *    ⚠️ 与 {@link classifierDenyCauseOf} 的闭集判据**不矛盾**:那一层答「这条事实在不在」(闭集,
- *    出集 = 坏记录),本层答「拿到一个词怎么渲」——**渲判据面**的消费端(以及一条从旧持久态恢复
- *    回来的视图)可能手里就是一个表外词,它必须渲出一句诚实的话,而不是整屏崩或冒充一句已知的。
+ * ── 🔴 0.68.0 / L-245:入参从 `unknown` 收窄成**闭集成员型** ─────────────────────────────────
+ * 修前这里留着一句「its reported cause X **is a word newer than this client**」的兜底,而它
+ * **结构上走不到**:唯一到达本铸点的路是 {@link classifierDenyCauseOf},那一层已经按闭集把表外词
+ * 判成了缺席(理由见该函数:出闭集的 cause 在 core 那边是**记录缺陷**,server 整条不上帧 ⇒ 一个
+ * 表外词根本到不了消费端)。一条走不到的兜底有两重坏处:① 它假装这一面是开集,于是没人给这张表
+ * 配编译期围栏,core 加词那天这里一声不响;② 它说的那句话是**假的** —— 真有一个「比这一端新」的词
+ * 时,它压根不会到这里。
+ * ⇒ 入参收窄(表外词现在是**编译期**错误)+ 表型 `Record<ClassifierDenyCause, string>`(加词当天
+ *   缺键红)。剩下的运行期兜底只服务一种情形:调用方 cast 绕过型面、或从旧持久态恢复出一个非成员值
+ *   —— 那时它说的是「这个词不在本端的闭集里」(一句真话),而**不再**冒充「上游比我新」。
+ * 🔴 渲染路径**不许抛**(本仓已定谳的病形),所以 never 分支照样交一句话,不 throw。
  */
 export function classifierDenyCauseDetail(cause) {
-    const known = typeof cause === 'string' && Object.hasOwn(DENY_CAUSE_SENTENCES, cause)
+    // 🔴 **按自有属性查表**(与本包其余措辞铸点同一条纪律):`Object.freeze` 不移除原型,一个被
+    //    cast 进来的 `constructor` / `toString` 会命中 `Object.prototype` 上的**函数**并被当成一句话。
+    const known = Object.hasOwn(DENY_CAUSE_SENTENCES, cause)
         ? DENY_CAUSE_SENTENCES[cause]
         : undefined;
-    if (known !== undefined)
+    if (typeof known === 'string')
         return known;
     const word = typeof cause === 'string' && cause.length > 0 ? cause : '(none)';
-    return `denied by the auto-mode classifier lane; its reported cause ${word} is a word newer than this client`;
+    return `denied by the auto-mode classifier lane; its reported cause ${word} is not one of the causes this client's closed set knows`;
 }

package/dist/classifierStatus.d.ts

@@ -20,6 +20,32 @@
  *    `AUTO_MODE_UNAVAILABLE_CAUSES` 的理由)。
  */
 export declare const CLASSIFIER_STATUS_STATES: readonly string[];
+/**
+ * 「本轮那一次观测」的**窄型面**(0.68.0 / L-245 B6)。
+ *
+ * ── 为什么这个型要有名字 ────────────────────────────────────────────────────────────────────
+ * 修前第二参是裸 `unknown`,而端手里常常只有**两格裸串**(`disposition.kind` / `disposition.cause`)——
+ * 于是壳把它们**铸回一个假门记录** `{gate:{disposition:{kind,cause}}}` 再喂进来(cli
+ * `classifierRoundObservation.ts` 的那一处)。那是一条「为了过读器而伪造上游形状」的路:伪造出来的
+ * 那层 `gate` 在 wire 上根本不存在,读者会以为端手里有一整只门记录,而下一次读器换键路时端还得
+ * 跟着改自己的伪造件。
+ * ⇒ 给它一个名字,并把**三条合法入形**写进型面:
+ *   · `{ disposition }` —— 端手里只有处置那一格时**直接给这一格**(不必再铸一层 `gate`);
+ *   · `{ gate }`        —— 整只 `tool_end` 帧 / 一条耐久 park 行(键路 `gate.disposition`);
+ *   · `{ origin }`      —— 「分类器真的跑过」那条**肯定事实**的载体。
+ * 🔴 索引签名是**故意**的:整只 wire 帧(键远不止这三个)照样喂得进来,端零改造;而 `unknown`
+ *    类型的变量从此喂不进来 —— 那正是「端先自己判一下手里是什么」的那一步,也是伪造件消失的地方。
+ */
+export interface ClassifierRoundObservation {
+    /** 门记录上的处置(`{kind:'denied', cause}`)。端手里只有这一格时直接给它。 */
+    readonly disposition?: unknown;
+    /** 整只帧 / 耐久行上的门记录(键路 `gate.disposition`)。 */
+    readonly gate?: unknown;
+    /** 这只 ask 的出身词(`askOriginOf` 读它;`CLASSIFIER_RAN_ORIGINS` 的成员 = 分类器真跑过)。 */
+    readonly origin?: unknown;
+    /** 整只 wire 帧上的其余键(读器一个都不读;留索引签名是为了端零改造)。 */
+    readonly [extra: string]: unknown;
+}
 /** 一次状态读数。 */
 export interface ClassifierStatusView {
     /** {@link CLASSIFIER_STATUS_STATES} 之一。 */
@@ -31,9 +57,11 @@ export interface ClassifierStatusView {
  * 「这个会话上,auto 分类器现在是什么状态」——三态,或 `undefined`(**说不出来**)。
  *
  * @param autoMode `wiring_manifest` 的 `autoMode` 段(投影后的或原始的都吃;本函数自己窄读)
- * @param ask      可选:**本轮那一次观测** —— 一只 ask / 一条 durable park 行的 `tool_approval`
- *   载荷 / 一只带 `gate` 的 `tool_end` 帧 / 一条门记录本体。三形键路同形,同一把读器吃(0.67.0:
- *   否定事实的载体从 ask 上的 `classifierUnavailable` 改成门记录上的 `disposition.cause`)。
+ * @param ask      可选:**本轮那一次观测**({@link ClassifierRoundObservation};0.68.0 / L-245 起
+ *   有名字)—— 一只 ask / 一条 durable park 行的 `tool_approval` 载荷 / 一只带 `gate` 的 `tool_end`
+ *   帧 / 一条门记录本体 / **只有 `{disposition}` 那一格**。键路同形,同一把读器吃(0.67.0:否定事实
+ *   的载体从 ask 上的 `classifierUnavailable` 改成门记录上的 `disposition.cause`)。
+ *   🔴 端**不必**为了过这只读器去铸一个假门记录:手里只有两格裸串时,直接交 `{disposition:{kind,cause}}`。
  *
  * 优先序(承重,理由见模块顶注):**本轮事实(否定 + 肯定)> 这条腿的 `armed`**——先看观测座上的
  * 本轮不可用事实,再看那条「分类器真的跑过」的肯定事实,最后才看这条腿武没武装。
@@ -45,7 +73,7 @@ export interface ClassifierStatusView {
  *    两种情形都**绝不**折成 `available`(那是把「没报」渲成「一切正常」)。
  * ⚠️ 「没武装」本身仍是一条要渲的事实 —— 但它的出处是 `autoMode.reason`,不是本读器。
  */
-export declare function classifierStatusOf(autoMode: unknown, ask?: unknown): ClassifierStatusView | undefined;
+export declare function classifierStatusOf(autoMode: unknown, ask?: ClassifierRoundObservation): ClassifierStatusView | undefined;
 /**
  * 一次状态读数 → 一句人话。**唯一措辞铸点**(三端共用;端零自拼)。
  *

package/dist/classifierStatus.js

@@ -135,9 +135,11 @@ const NOT_A_ROUND_FAILURE = new Set(['parse_error']);
  * 「这个会话上,auto 分类器现在是什么状态」——三态,或 `undefined`(**说不出来**)。
  *
  * @param autoMode `wiring_manifest` 的 `autoMode` 段(投影后的或原始的都吃;本函数自己窄读)
- * @param ask      可选:**本轮那一次观测** —— 一只 ask / 一条 durable park 行的 `tool_approval`
- *   载荷 / 一只带 `gate` 的 `tool_end` 帧 / 一条门记录本体。三形键路同形,同一把读器吃(0.67.0:
- *   否定事实的载体从 ask 上的 `classifierUnavailable` 改成门记录上的 `disposition.cause`)。
+ * @param ask      可选:**本轮那一次观测**({@link ClassifierRoundObservation};0.68.0 / L-245 起
+ *   有名字)—— 一只 ask / 一条 durable park 行的 `tool_approval` 载荷 / 一只带 `gate` 的 `tool_end`
+ *   帧 / 一条门记录本体 / **只有 `{disposition}` 那一格**。键路同形,同一把读器吃(0.67.0:否定事实
+ *   的载体从 ask 上的 `classifierUnavailable` 改成门记录上的 `disposition.cause`)。
+ *   🔴 端**不必**为了过这只读器去铸一个假门记录:手里只有两格裸串时,直接交 `{disposition:{kind,cause}}`。
  *
  * 优先序(承重,理由见模块顶注):**本轮事实(否定 + 肯定)> 这条腿的 `armed`**——先看观测座上的
  * 本轮不可用事实,再看那条「分类器真的跑过」的肯定事实,最后才看这条腿武没武装。

package/dist/engineErrorCodes.d.ts

@@ -283,6 +283,37 @@ export declare const DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED = "decide.workflow_rem
  * 🔴 加成员必须**同批**补那一句人话 + 判据,不许靠 `decide.` 前缀放宽(前缀下住着三种处置)。
  */
 export declare const DECIDE_WORKFLOW_LANE_CODES: readonly string[];
+/** 这条 workflow 的 park 真相**读不出来**(店抛了 / 超时 / 记录不在 / 记录还在跑)。
+ *  `detail.reason` 开集(`checkpoint_store_threw` / `store_threw` / `record_missing` /
+ *  `record_not_terminal`…;词表属主在 core)⇒ 读得出即原样带,读不懂**不折**已知词。 */
+export declare const WORKFLOW_PARK_TRUTH_UNREADABLE = "workflow.park_truth_unreadable";
+/** 记录说这一序号 park 着,而 checkpoint 店说那只审批**已决 / 已过期 / 被回收**。
+ *  `detail.status` 三词(`absent` / `expired` / `resolved`)+ `detail.ordinal`;
+ *  `detail.checkpointId` **可缺席**(店里没 id)—— 缺席 ≠ 「没有 checkpoint」。 */
+export declare const WORKFLOW_PARK_NOT_PENDING = "workflow.park_not_pending";
+/** 记录里的 park **绑不回**它的 checkpoint(记录自相矛盾)。`detail.ordinal` 在场。 */
+export declare const WORKFLOW_PARK_BINDING_BROKEN = "workflow.park_binding_broken";
+/** 这条 workflow 的子代会 park,而部署**没有 run 店**(或没有 checkpoint 店)⇒ 没有耐久行可供
+ *  宿主按它路由那只停着的审批。`detail` 恒空对象(这是**配置**问题,不是某一条 run 的事实)。 */
+export declare const WORKFLOW_PARK_REQUIRES_RUN_STORE = "workflow.park_requires_run_store";
+/**
+ * workflow **park 真相**拒绝码的闭集(四员;core 7.17.0 `workflow.ts:602` 码集)。
+ *
+ * 🔴 闭的是「**这四个码是 park 真相这一族独有的**」,不是「`workflow.*` 一共有几个码」——
+ *    后者仍是开集(`workflow.governance_key_stripped` / `workflow.agent_option_ignored` 是通告码,
+ *    `workflow.journal_incompatible` 是另一族拒绝码,各有各的既有处置)。
+ * 🔴 **绝不靠 `workflow.park_` 前缀放宽**:前缀是个命名巧合,不是契约;上游哪天加第五个码,
+ *    该在这里显形并被人处置,而不是被一条前缀判据无声吞进来。
+ * 🔴 形制:`Object.freeze` 的数组(同 {@link DECIDE_WORKFLOW_LANE_CODES})。
+ */
+export declare const WORKFLOW_PARK_REFUSAL_CODES: readonly string[];
+/**
+ * 这个码是不是 workflow park 真相族的拒绝码({@link WORKFLOW_PARK_REFUSAL_CODES} 的成员)。
+ *
+ * 🔴 表外码 ⇒ `false` = 「本端认不出它属于这一族」,**不是**「这次 resume 没问题」。
+ * 🔴 非串 / 空串 ⇒ `false`;认**原始值**(消毒只进文案,不进判据)。
+ */
+export declare function isWorkflowParkRefusalCode(code: unknown): boolean;
 /**
  * server 温切 drain 门的 pre-stream 拒收码(503 + `errorCode:"draining"`;server 侧
  * `error:"draining"` 是冻结契约,SDK toApiError 盖成 `errorCode`)。此前壳/包注释各持裸字面。
@@ -314,3 +345,24 @@ export type ModelFallbackReason = 'inherit_no_tier_binding';
 export declare const MODEL_FALLBACK_INHERIT_NO_TIER_BINDING: ModelFallbackReason;
 /** wire 上的 `modelFallback` 窄化:是闭集成员才认,别的一律当缺席(不认得的原因 ≠ 编一个)。 */
 export declare function asModelFallbackReason(v: unknown): ModelFallbackReason | undefined;
+/**
+ * 引擎 turn 停止原词的**识别表**(五词;core `StopReason` 归一化后的值集)。
+ *
+ * 🔴 **它是识别表不是闭集判据**:`turn_end.stopReason` 在 sdk 型面上是开放 `string`(上游刻意让
+ *    引擎的 union 保持私有)⇒ 引擎比这一端新时真的会送一个第六个词过来。本表回答的是
+ *    「我认不认得这个词」,**绝不是**「合法的词只有这五个」。
+ */
+export declare const ENGINE_STOP_REASONS: readonly string[];
+/**
+ * 引擎停止原词 → CC `stop_reason` 的**唯一映射口**。**三态**,刻意不合并:
+ *  · `string`      —— 映到了一个 CC 词;
+ *  · `null`        —— 映到了**诚实缺席**(`error` / `aborted`:CC 没有对应词,不编一个);
+ *  · `undefined`   —— **这个词本端不认识**(表外词 / 非串 / 空串)⇒ 调用方按「不映射」走原路。
+ *
+ * 🔴 `null` 与 `undefined` 必须分开:前者是「我认得这个词,而它的正确渲法就是没有词」,后者是
+ *    「我不认得这个词」。合成一个值 ⇒ 引擎加第六个词那天,它会被渲成一次「这一轮没有 stop_reason」
+ *    的**肯定事实**,而真相是这一端读不懂 —— 本仓反复在修的那条「把不知道渲成事实」的病。
+ * 🔴 **按自有属性查表**(`Object.freeze` 不移除原型):一个来自 wire 的 `constructor` / `toString`
+ *    会命中 `Object.prototype` 上的**函数**并被当成一个 CC 词交出去。
+ */
+export declare function engineStopReasonToCc(stopReason: unknown): string | null | undefined;

package/dist/engineErrorCodes.js

@@ -380,6 +380,57 @@ export const DECIDE_WORKFLOW_LANE_CODES = Object.freeze([
     DECIDE_WORKFLOW_HOST_NOT_PARKED,
     DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED,
 ]);
+// ══ 0.68.0 提货批(core 7.17.0 #652;server [7084] D 段)—— workflow **park 真相**四拒码 ══════
+//
+// 背景一句话:workflow run 记录从 7.17.0 起带 `parks[]`(准入输入),而「一条 run 的 park 到底是
+// 什么状态」是 **resume 的前提**。读不出 / 对不上 / 不在 pending / 压根没有 run 店 —— 四种情形此前
+// 混在 `workflow.journal_incompatible` 的「journal entry missing」那一臂里,一个码说四件事,于是
+// 消费端只能渲一句「日志不兼容」,而四条出路完全不同。core 7.17.0 把它们拆成四个码(那条旧臂同批
+// 退役),`workflow.ts:602` 是码集的铸点。
+//
+// 🔴 **它们不是 `SCRIPT_ERROR_CODES` 的成员**(core 顶注逐字:host runtime 类)—— 别拿脚本错误那
+//    张表去判它们,也别把它们塞进那张表。
+// 🔴 **本包不抄 core 的句子**(单铸律,同 `engineNoticeCodes.ts` 顶注):只给码、闭集与每个码的
+//    `detail` 键位读法,人话用引擎给的那一句。
+/** 这条 workflow 的 park 真相**读不出来**(店抛了 / 超时 / 记录不在 / 记录还在跑)。
+ *  `detail.reason` 开集(`checkpoint_store_threw` / `store_threw` / `record_missing` /
+ *  `record_not_terminal`…;词表属主在 core)⇒ 读得出即原样带,读不懂**不折**已知词。 */
+export const WORKFLOW_PARK_TRUTH_UNREADABLE = 'workflow.park_truth_unreadable';
+/** 记录说这一序号 park 着,而 checkpoint 店说那只审批**已决 / 已过期 / 被回收**。
+ *  `detail.status` 三词(`absent` / `expired` / `resolved`)+ `detail.ordinal`;
+ *  `detail.checkpointId` **可缺席**(店里没 id)—— 缺席 ≠ 「没有 checkpoint」。 */
+export const WORKFLOW_PARK_NOT_PENDING = 'workflow.park_not_pending';
+/** 记录里的 park **绑不回**它的 checkpoint(记录自相矛盾)。`detail.ordinal` 在场。 */
+export const WORKFLOW_PARK_BINDING_BROKEN = 'workflow.park_binding_broken';
+/** 这条 workflow 的子代会 park,而部署**没有 run 店**(或没有 checkpoint 店)⇒ 没有耐久行可供
+ *  宿主按它路由那只停着的审批。`detail` 恒空对象(这是**配置**问题,不是某一条 run 的事实)。 */
+export const WORKFLOW_PARK_REQUIRES_RUN_STORE = 'workflow.park_requires_run_store';
+/**
+ * workflow **park 真相**拒绝码的闭集(四员;core 7.17.0 `workflow.ts:602` 码集)。
+ *
+ * 🔴 闭的是「**这四个码是 park 真相这一族独有的**」,不是「`workflow.*` 一共有几个码」——
+ *    后者仍是开集(`workflow.governance_key_stripped` / `workflow.agent_option_ignored` 是通告码,
+ *    `workflow.journal_incompatible` 是另一族拒绝码,各有各的既有处置)。
+ * 🔴 **绝不靠 `workflow.park_` 前缀放宽**:前缀是个命名巧合,不是契约;上游哪天加第五个码,
+ *    该在这里显形并被人处置,而不是被一条前缀判据无声吞进来。
+ * 🔴 形制:`Object.freeze` 的数组(同 {@link DECIDE_WORKFLOW_LANE_CODES})。
+ */
+export const WORKFLOW_PARK_REFUSAL_CODES = Object.freeze([
+    WORKFLOW_PARK_TRUTH_UNREADABLE,
+    WORKFLOW_PARK_NOT_PENDING,
+    WORKFLOW_PARK_BINDING_BROKEN,
+    WORKFLOW_PARK_REQUIRES_RUN_STORE,
+]);
+const WORKFLOW_PARK_REFUSAL_CODE_SET = new Set(WORKFLOW_PARK_REFUSAL_CODES);
+/**
+ * 这个码是不是 workflow park 真相族的拒绝码({@link WORKFLOW_PARK_REFUSAL_CODES} 的成员)。
+ *
+ * 🔴 表外码 ⇒ `false` = 「本端认不出它属于这一族」,**不是**「这次 resume 没问题」。
+ * 🔴 非串 / 空串 ⇒ `false`;认**原始值**(消毒只进文案,不进判据)。
+ */
+export function isWorkflowParkRefusalCode(code) {
+    return typeof code === 'string' && WORKFLOW_PARK_REFUSAL_CODE_SET.has(code);
+}
 // ── drain / 场景执法族(A-028.11/.13 单源化,#244 族E,2026-08-15)────────────────────────────
 /**
  * server 温切 drain 门的 pre-stream 拒收码(503 + `errorCode:"draining"`;server 侧
@@ -405,3 +456,69 @@ export const MODEL_FALLBACK_INHERIT_NO_TIER_BINDING = 'inherit_no_tier_binding';
 export function asModelFallbackReason(v) {
     return v === MODEL_FALLBACK_INHERIT_NO_TIER_BINDING ? MODEL_FALLBACK_INHERIT_NO_TIER_BINDING : undefined;
 }
+// ══════════════════════════════════════════════════════════════════════════════════════════════
+// 0.68.0(L-246 A13)—— 引擎的 **turn 停止原词** → CC `stop_reason`(**唯一映射铸点**)
+// ══════════════════════════════════════════════════════════════════════════════════════════════
+//
+// ── 为什么它下沉到包里 ────────────────────────────────────────────────────────────────────────
+// 这张表此前住在壳里(cli `printStreamJsonContract.ts` 的 `ENGINE_STOP_REASON_TO_CC`),而它是一张
+// **CC 皮肤词汇表** —— 本包的立意逐字是「Every CC-skin shape is collected here so the wire itself
+// stays neutral」。住在壳里的后果是三端各铸一份:web / desktop 要渲同一个 `stop_reason` 时只能
+// 自己再抄一遍五个词,而下一次 core 归一化词表变动时,漏掉的那一份会把**这一轮为什么停**渲错 ——
+// 而那恰恰是出错/被截断那一刻最需要读对的一格。
+//
+// ── 左右两列的出处 ────────────────────────────────────────────────────────────────────────────
+// 左列 = `turn_end.stopReason`(core `StopReason` 归一化后的五词;core `task-event.d.ts` 逐字:
+//   「Typed `string` (not the internal `StopReason`) to keep the engine's union private, but the
+//   value set is exactly those five tokens」)—— 本包的 `turn_usage._sema_stop_reason` 原词透传它。
+// 右列 = CC stdout 契约上的 `stop_reason`。
+/**
+ * 引擎 turn 停止原词的**识别表**(五词;core `StopReason` 归一化后的值集)。
+ *
+ * 🔴 **它是识别表不是闭集判据**:`turn_end.stopReason` 在 sdk 型面上是开放 `string`(上游刻意让
+ *    引擎的 union 保持私有)⇒ 引擎比这一端新时真的会送一个第六个词过来。本表回答的是
+ *    「我认不认得这个词」,**绝不是**「合法的词只有这五个」。
+ */
+export const ENGINE_STOP_REASONS = Object.freeze([
+    'stop',
+    'length',
+    'toolUse',
+    'error',
+    'aborted',
+]);
+/**
+ * 五词 → CC `stop_reason`。`null` **不是**「没映射」,是**映射到诚实缺席**。
+ *
+ * 🔴 两条纪律(逐字自壳侧原表搬入,一个字节没改语义):
+ *   · `error` / `aborted` 在 CC 的词表里**没有对应词**,而既有结算规则对出错的一轮本来就留 `null`
+ *     (schema 可空)⇒ 这里同样**不编一个词出来**;
+ *   · **表外词一律不映射**(见 {@link engineStopReasonToCc}):引擎长出第六个词时既不猜也不改既有
+ *     结算,让它按修前那条路走完 —— 猜一个 CC 词会让消费者据此判错这一轮的结局。
+ */
+const ENGINE_STOP_REASON_TO_CC = Object.freeze({
+    stop: 'end_turn',
+    length: 'max_tokens',
+    toolUse: 'tool_use',
+    error: null,
+    aborted: null,
+});
+/**
+ * 引擎停止原词 → CC `stop_reason` 的**唯一映射口**。**三态**,刻意不合并:
+ *  · `string`      —— 映到了一个 CC 词;
+ *  · `null`        —— 映到了**诚实缺席**(`error` / `aborted`:CC 没有对应词,不编一个);
+ *  · `undefined`   —— **这个词本端不认识**(表外词 / 非串 / 空串)⇒ 调用方按「不映射」走原路。
+ *
+ * 🔴 `null` 与 `undefined` 必须分开:前者是「我认得这个词,而它的正确渲法就是没有词」,后者是
+ *    「我不认得这个词」。合成一个值 ⇒ 引擎加第六个词那天,它会被渲成一次「这一轮没有 stop_reason」
+ *    的**肯定事实**,而真相是这一端读不懂 —— 本仓反复在修的那条「把不知道渲成事实」的病。
+ * 🔴 **按自有属性查表**(`Object.freeze` 不移除原型):一个来自 wire 的 `constructor` / `toString`
+ *    会命中 `Object.prototype` 上的**函数**并被当成一个 CC 词交出去。
+ */
+export function engineStopReasonToCc(stopReason) {
+    if (typeof stopReason !== 'string' || stopReason.length === 0)
+        return undefined;
+    if (!Object.hasOwn(ENGINE_STOP_REASON_TO_CC, stopReason))
+        return undefined;
+    const row = ENGINE_STOP_REASON_TO_CC[stopReason];
+    return typeof row === 'string' || row === null ? row : undefined;
+}

package/dist/engineNoticeCodes.d.ts

@@ -22,6 +22,10 @@
  * · **core 7.10.0 +2**:`delegation.ask_unresolvable`(audience **user** —— 委派链上那只 ask 判不出
  *   归属、没有人可问,这件事的收件人是发起这次委派的**用户**)/ `config.read_face_swapped`
  *   (audience **operator** —— READ 容纳面被换过档,是部署事实)。四十八码 ⇒ **五十码**。
+ * · **core 7.17.0 +1**(0.68.0 提货批,同样由本门 A1 段当天红抓出:「上游 52 / 本包 51」):
+ *   `config.artifact_host_invalid`(audience **operator** —— 宿主接了 artifact 席但它的
+ *   `capabilities()` 声明不过席上的不变量、或 `onMount` 抛了 ⇒ 那只工具没挂上。上游逐字:
+ *   「an absent seat is silent; a broken one must not look the same」)。五十一码 ⇒ **五十二码**。
  * · **core ≤7.16.0 +1**(0.67.0 提货批,由本门的 A1 段当天红抓出 —— 不是人眼发现的):
  *   `task.interrupt_unconsumed`(audience **user**;位置在 `task.late_approval` 与
  *   `memory.capture_opted_out` 之间,`governance-codes.js:146` / `NOTICE_AUDIENCE_TABLE:165` 真字节)。
@@ -50,7 +54,7 @@
 /** 一条通告是**说给谁听**的。两值,刻意不设第三值(见模块顶注)。 */
 export type NoticeAudience = 'user' | 'operator';
 /**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**≤7.16.0 = 五十一码**;顺序同源)。
+ * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.17.x = 五十二码**;顺序同源)。
  * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
  * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
  *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。
@@ -106,3 +110,93 @@ export interface McpInjectionDropFactsView {
  *    (要渲一句话时,用引擎给的 `message`,见模块顶注的单铸律。)
  */
 export declare function readMcpInjectionDrop(notice: unknown): McpInjectionDropFactsView | undefined;
+/**
+ * `delegation.ask_unresolvable` 的三个成因(core `ASK_UNRESOLVABLE_CAUSES` 逐词镜像,
+ * `dist/core/ask-unresolvable-notice.d.ts:31`)。
+ *
+ * 🔴 **0.68.0 BREAKING(core #709 ②)**:这一位**取代**了 7.16.0 及以前那条通告 `detail` 上的
+ *    `settlementKind`(core `gate-exit.ts` 的一处铸点;`settlementKind` 在 7.17.x 的 core 与 sdk
+ *    真字节上**零命中**,本包按 clean-cut 不留双读,登记在 `run-retired-vocabulary-census-test.mjs`)。
+ *    两者不是改名:`settlementKind` 只说得出「结算是怎么落的」,而 in-fold 拒绝那一臂**根本没有
+ *    结算**骑在帧上(`mandate_unreconstructible`)—— 旧位在那一形上恒缺席。
+ *
+ * 三词各答「为什么这只 ask 判不出来」(上游逐字):
+ *  · `approver_unavailable` —— 被问到的审批席(本 run 自己的,或委派子代身上那张冻结的祖先席)
+ *    对路由问题答了 `unavailable`,而其后**没有**耐久 park 接下这次调用;
+ *  · `no_approver_wired` —— 这条 run 根本没接审批席(或问答面),或者席位就是拒绝姿态串
+ *    (headless 自动拒);
+ *  · `mandate_unreconstructible` —— 继承来的耐久审批 mandate 绑住了这只 ask,而**这条腿没有 park
+ *    设施**去兑现它,于是委派子代就地拒绝(in-fold 拒,帧上不带 settlement)。
+ *
+ * 🔴 形制:`Object.freeze` 的数组(同 `MCP_INJECTION_DROP_REASONS` 的已定谳病形)。
+ */
+export declare const ASK_UNRESOLVABLE_CAUSES: readonly string[];
+/** `delegation.ask_unresolvable` 通告 `detail` 上的事实(引擎在拒绝出口知道的那几件)。 */
+export interface AskUnresolvableFactsView {
+    /** 这条通告投给哪个会话。**必填** —— user audience 的通告没有会话就无处投递(上游在铸点抛)。 */
+    sessionId: string;
+    /** 这只 ask 是为哪个工具问的(引擎的 message 里逐字引了它)。 */
+    toolName: string;
+    /** 被拒的那次调用 id —— 与带着同一次拒绝的 `tool_end` 帧对得上的关联键。 */
+    toolCallId: string;
+    /** 三词之一({@link ASK_UNRESOLVABLE_CAUSES})。 */
+    cause: string;
+    /**
+     * 这条 run 上**有没有**武装过耐久审批 park 车道。
+     * `true` = park 有过它那一次机会而没接下(它拒了或失败了);`false` = 压根没有 park 车道(常见形)。
+     * 🔴 **读不出 ⇒ 键不铸**(不折 `false`):「没有 park 车道」与「不知道有没有」的下一步不同 ——
+     *    前者该去接一个 checkpoint 店,后者该去问引擎为什么没说。
+     */
+    parkLaneExisted?: boolean;
+}
+/**
+ * `delegation.ask_unresolvable` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
+ *
+ * 🔴 `cause` **按闭集读**:它是消费端分支的键(三条恢复路不同 —— 接一个耐久店 / 接一个审批席 /
+ *    别在无 park 设施的腿上继承 mandate)。读不懂的词 ⇒ **整只缺席**,而不是交一个分不了支的串。
+ */
+export declare function readAskUnresolvable(notice: unknown): AskUnresolvableFactsView | undefined;
+/**
+ * 一条腿上的耐久审批 **mandate 从哪儿来**(core `DURABLE_MANDATE_SOURCES` 逐词镜像,
+ * `dist/core/tool-policy.d.ts:1403`)。两词的**恢复动作不同**,这正是上游把它铸上通告的理由:
+ *  · `force_durable_gate` —— per-principal 的控制面权利,与席位无关 ⇒ 要么给这套部署接一个
+ *    checkpoint 店,要么撤掉这批 principal 的这项权利;
+ *  · `durable_approval` —— 任务自己的 opt-in 且**没有**活审批席 ⇒ 给任务一个活席位,或者不要
+ *    再传 `durableApproval`。
+ *
+ * 🔴 形制同上(冻结数组)。
+ */
+export declare const DURABLE_MANDATE_SOURCES: readonly string[];
+/** `config.durable_gate_unavailable` 通告 `detail` 上的事实。 */
+export interface DurableGateUnavailableFactsView {
+    /** 这条通告投给哪个会话(user audience ⇒ 必填)。 */
+    sessionId: string;
+    /** 哪一条 run。 */
+    runId: string;
+    /** 这条腿服务的 principal;上游只在有值时铸 ⇒ 读不出即缺席。 */
+    principal?: string;
+    /**
+     * **哪一个 mandate 没被兑现**({@link DURABLE_MANDATE_SOURCES} 之一)。
+     * 🔴 读不懂的词 ⇒ **整只缺席**(它是恢复动作的分支键;猜错会把人指去撤一项他根本没开的权利)。
+     */
+    source: string;
+    /**
+     * **为什么没有 park 设施**:上游今天两词 `no_deployment_store`(这套部署一个店都没接)/
+     * `task_store_disabled`(`TaskSpec.checkpointStore: "disabled"`,这一次 run 自己关掉的)。
+     * 🔴 **开集透传**:core 今天**不导出**这两个词的闭集(它在铸点是一个三元表达式,
+     *    `prepare-wiring-manifest.js:90`)⇒ 抄一份就是本包自铸词表,加员那天还是本包先错。
+     *    非空串即原样带回,词表属主在 core;要分支的消费端自己按已知词判,别拿它当穷举。
+     */
+    cause: string;
+    /** 这条腿的权限 ask **会不会**由一个活席位当场答(`false` ⇒ fail-closed 拒)。读不出 ⇒ 键不铸。 */
+    liveApprover?: boolean;
+    /** `AskUserQuestion` **会不会**由一个活问答面当场答。读不出 ⇒ 键不铸。 */
+    liveQuestionFace?: boolean;
+}
+/**
+ * `config.durable_gate_unavailable` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
+ *
+ * 🔴 **两个布尔位缺席不折 `false`**:core 在铸点把它们写成必填,但「这一格读不出」与
+ *    「这一格是 false」对用户的下一步不同(前者是「引擎没说」,后者是「没有人会答你这条 ask」)。
+ */
+export declare function readDurableGateUnavailable(notice: unknown): DurableGateUnavailableFactsView | undefined;

package/dist/engineNoticeCodes.js

@@ -22,6 +22,10 @@
  * · **core 7.10.0 +2**:`delegation.ask_unresolvable`(audience **user** —— 委派链上那只 ask 判不出
  *   归属、没有人可问,这件事的收件人是发起这次委派的**用户**)/ `config.read_face_swapped`
  *   (audience **operator** —— READ 容纳面被换过档,是部署事实)。四十八码 ⇒ **五十码**。
+ * · **core 7.17.0 +1**(0.68.0 提货批,同样由本门 A1 段当天红抓出:「上游 52 / 本包 51」):
+ *   `config.artifact_host_invalid`(audience **operator** —— 宿主接了 artifact 席但它的
+ *   `capabilities()` 声明不过席上的不变量、或 `onMount` 抛了 ⇒ 那只工具没挂上。上游逐字:
+ *   「an absent seat is silent; a broken one must not look the same」)。五十一码 ⇒ **五十二码**。
  * · **core ≤7.16.0 +1**(0.67.0 提货批,由本门的 A1 段当天红抓出 —— 不是人眼发现的):
  *   `task.interrupt_unconsumed`(audience **user**;位置在 `task.late_approval` 与
  *   `memory.capture_opted_out` 之间,`governance-codes.js:146` / `NOTICE_AUDIENCE_TABLE:165` 真字节)。
@@ -48,7 +52,7 @@
  * 出现在本包源码或产物里 => 当场红。
  */
 /**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**≤7.16.0 = 五十一码**;顺序同源)。
+ * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.17.x = 五十二码**;顺序同源)。
  * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
  * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
  *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。
@@ -66,6 +70,9 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'config.tool_model_gate_removed',
     'config.tool_model_gate_unknown_class',
     'config.tool_model_gate_env_invalid',
+    // 0.68.0 提货批(core 7.17.0 加员;位置 = `governance-codes.js:108` 真字节,在
+    // `config.tool_model_gate_env_invalid` 与 `config.tool_card_undeclared` 之间)。
+    'config.artifact_host_invalid',
     'config.tool_card_undeclared',
     'config.tool_face_undeclared',
     'config.tool_face_invalid',
@@ -133,6 +140,8 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.tool_model_gate_removed': 'operator',
     'config.tool_model_gate_unknown_class': 'operator',
     'config.tool_model_gate_env_invalid': 'operator',
+    // 0.68.0 提货批:`NOTICE_AUDIENCE_TABLE:181` 真字节 —— 一条「宿主把 artifact 席接坏了」的部署事实。
+    'config.artifact_host_invalid': 'operator',
     'config.tool_card_undeclared': 'operator',
     'config.tool_face_undeclared': 'operator',
     'config.tool_face_invalid': 'operator',
@@ -235,3 +244,117 @@ export function readMcpInjectionDrop(notice) {
     const field = typeof o.field === 'string' && o.field.length > 0 ? o.field : undefined;
     return { sessionId, server, reason, ...(field !== undefined ? { field } : {}) };
 }
+// ══════════════════════════════════════════════════════════════════════════════════════════════
+// 0.68.0 提货批(core 7.17.0 #709 ①②)—— 两条通告的**事实窄读器**
+// ══════════════════════════════════════════════════════════════════════════════════════════════
+// 与 {@link readMcpInjectionDrop} 同一套规矩(单铸律不变:本模块只给码册、闭集与**事实**,
+// 一句措辞都不抄 —— 转录用引擎给的 `message`):
+//   · **只认自己那一个码**(读器按码分家);
+//   · 必填格缺一 ⇒ **整只缺席**(读点判缺席而不抛:读点抛只会把一条读不懂的通告升级成一次崩);
+//   · **分支用的键按闭集读**(读不懂的词不许被当成一个能拿去分支的原因);**非分支键开集透传**。
+/**
+ * `delegation.ask_unresolvable` 的三个成因(core `ASK_UNRESOLVABLE_CAUSES` 逐词镜像,
+ * `dist/core/ask-unresolvable-notice.d.ts:31`)。
+ *
+ * 🔴 **0.68.0 BREAKING(core #709 ②)**:这一位**取代**了 7.16.0 及以前那条通告 `detail` 上的
+ *    `settlementKind`(core `gate-exit.ts` 的一处铸点;`settlementKind` 在 7.17.x 的 core 与 sdk
+ *    真字节上**零命中**,本包按 clean-cut 不留双读,登记在 `run-retired-vocabulary-census-test.mjs`)。
+ *    两者不是改名:`settlementKind` 只说得出「结算是怎么落的」,而 in-fold 拒绝那一臂**根本没有
+ *    结算**骑在帧上(`mandate_unreconstructible`)—— 旧位在那一形上恒缺席。
+ *
+ * 三词各答「为什么这只 ask 判不出来」(上游逐字):
+ *  · `approver_unavailable` —— 被问到的审批席(本 run 自己的,或委派子代身上那张冻结的祖先席)
+ *    对路由问题答了 `unavailable`,而其后**没有**耐久 park 接下这次调用;
+ *  · `no_approver_wired` —— 这条 run 根本没接审批席(或问答面),或者席位就是拒绝姿态串
+ *    (headless 自动拒);
+ *  · `mandate_unreconstructible` —— 继承来的耐久审批 mandate 绑住了这只 ask,而**这条腿没有 park
+ *    设施**去兑现它,于是委派子代就地拒绝(in-fold 拒,帧上不带 settlement)。
+ *
+ * 🔴 形制:`Object.freeze` 的数组(同 `MCP_INJECTION_DROP_REASONS` 的已定谳病形)。
+ */
+export const ASK_UNRESOLVABLE_CAUSES = Object.freeze([
+    'approver_unavailable',
+    'no_approver_wired',
+    'mandate_unreconstructible',
+]);
+const ASK_UNRESOLVABLE_CAUSE_SET = new Set(ASK_UNRESOLVABLE_CAUSES);
+/**
+ * `delegation.ask_unresolvable` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
+ *
+ * 🔴 `cause` **按闭集读**:它是消费端分支的键(三条恢复路不同 —— 接一个耐久店 / 接一个审批席 /
+ *    别在无 park 设施的腿上继承 mandate)。读不懂的词 ⇒ **整只缺席**,而不是交一个分不了支的串。
+ */
+export function readAskUnresolvable(notice) {
+    if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
+        return undefined;
+    const n = notice;
+    if (n.code !== 'delegation.ask_unresolvable')
+        return undefined;
+    const d = n.detail;
+    if (typeof d !== 'object' || d === null || Array.isArray(d))
+        return undefined;
+    const o = d;
+    const sessionId = typeof o.sessionId === 'string' && o.sessionId.length > 0 ? o.sessionId : undefined;
+    const toolName = typeof o.toolName === 'string' && o.toolName.length > 0 ? o.toolName : undefined;
+    const toolCallId = typeof o.toolCallId === 'string' && o.toolCallId.length > 0 ? o.toolCallId : undefined;
+    const cause = typeof o.cause === 'string' && ASK_UNRESOLVABLE_CAUSE_SET.has(o.cause) ? o.cause : undefined;
+    if (sessionId === undefined || toolName === undefined || toolCallId === undefined || cause === undefined) {
+        return undefined;
+    }
+    return {
+        sessionId,
+        toolName,
+        toolCallId,
+        cause,
+        ...(typeof o.parkLaneExisted === 'boolean' ? { parkLaneExisted: o.parkLaneExisted } : {}),
+    };
+}
+/**
+ * 一条腿上的耐久审批 **mandate 从哪儿来**(core `DURABLE_MANDATE_SOURCES` 逐词镜像,
+ * `dist/core/tool-policy.d.ts:1403`)。两词的**恢复动作不同**,这正是上游把它铸上通告的理由:
+ *  · `force_durable_gate` —— per-principal 的控制面权利,与席位无关 ⇒ 要么给这套部署接一个
+ *    checkpoint 店,要么撤掉这批 principal 的这项权利;
+ *  · `durable_approval` —— 任务自己的 opt-in 且**没有**活审批席 ⇒ 给任务一个活席位,或者不要
+ *    再传 `durableApproval`。
+ *
+ * 🔴 形制同上(冻结数组)。
+ */
+export const DURABLE_MANDATE_SOURCES = Object.freeze([
+    'force_durable_gate',
+    'durable_approval',
+]);
+const DURABLE_MANDATE_SOURCE_SET = new Set(DURABLE_MANDATE_SOURCES);
+/**
+ * `config.durable_gate_unavailable` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
+ *
+ * 🔴 **两个布尔位缺席不折 `false`**:core 在铸点把它们写成必填,但「这一格读不出」与
+ *    「这一格是 false」对用户的下一步不同(前者是「引擎没说」,后者是「没有人会答你这条 ask」)。
+ */
+export function readDurableGateUnavailable(notice) {
+    if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
+        return undefined;
+    const n = notice;
+    if (n.code !== 'config.durable_gate_unavailable')
+        return undefined;
+    const d = n.detail;
+    if (typeof d !== 'object' || d === null || Array.isArray(d))
+        return undefined;
+    const o = d;
+    const sessionId = typeof o.sessionId === 'string' && o.sessionId.length > 0 ? o.sessionId : undefined;
+    const runId = typeof o.runId === 'string' && o.runId.length > 0 ? o.runId : undefined;
+    const source = typeof o.source === 'string' && DURABLE_MANDATE_SOURCE_SET.has(o.source) ? o.source : undefined;
+    const cause = typeof o.cause === 'string' && o.cause.length > 0 ? o.cause : undefined;
+    if (sessionId === undefined || runId === undefined || source === undefined || cause === undefined) {
+        return undefined;
+    }
+    const principal = typeof o.principal === 'string' && o.principal.length > 0 ? o.principal : undefined;
+    return {
+        sessionId,
+        runId,
+        ...(principal !== undefined ? { principal } : {}),
+        source,
+        cause,
+        ...(typeof o.liveApprover === 'boolean' ? { liveApprover: o.liveApprover } : {}),
+        ...(typeof o.liveQuestionFace === 'boolean' ? { liveQuestionFace: o.liveQuestionFace } : {}),
+    };
+}