@sema-agent/client-core 0.70.2 → 0.71.0

package/dist/adapter/downstream/eventToSdkMessage.js

@@ -2,6 +2,8 @@ import { stamp, } from '../types.js';
 import { turnUsageToModelUsage } from './turnUsageToModelUsage.js';
 // 0.60.0(engine ≥7.64.0 / sdk 8.4.0):`tool_end.gate` 的三端共用窄读器(判定归包,端不许自拼)。
 import { gateOutcomeOf } from '../../gateOutcome.js';
+// CC-08(0.71.0):名册与名册增量的窄读器归 toolRoster.ts(0.63.0 起在),本层只接线。
+import { projectToolRoster, projectToolRosterDelta } from '../../toolRoster.js';
 import { SEGMENT_END_IDENTITY_KEYS } from '../types.js';
 // 0.65.0(core 7.12.0 CHANGELOG「Removed (BREAKING)」`WiringManifest.autoMode.breaker`):
 // 熔断族整只退役 ⇒ 本臂此前对 `autoMode.breaker` 的窄读(`classifierBreakerOf`)与它的型位一并
@@ -37,6 +39,11 @@ const SUGGESTION_CHARS_CAP = 200;
  * 即红。`turn_usage` 的铸点在 runStream.ts(usage 聚合腿),不在本文件的 switch 里,同属本表。
  */
 export const INTERNAL_SDK_ARM_TYPES = new Set([
+    // CC-08(0.71.0,sdk 9.6.0):两条新帧 → 中性内部臂(print 车道按 text_end 同律吞/转;裸透传 = 越界帧)。
+    'tool_disclosure',
+    'tool_progress',
+    'tool_roster_delta',
+    'context_usage',
     'workflow_complete',
     'tool_end_result',
     'retry_status',
@@ -174,8 +181,18 @@ export function eventToSdkMessage(ev, ctx) {
          * 三段),名册增量没有可挂的基线 ⇒ **有痕 dropped**,与 0.65.0 前的 `approval_request` 同形(不静默、
          * 不 not_in_slice);接上 `tools` 段的那一批把它一起接。
          */
-        case 'tool_roster_delta':
-            return dropped('unsupported_arm', 'tool_roster_delta');
+        case 'tool_roster_delta': {
+            // CC-08 ①(0.71.0):L-315 收口 —— 名册增量接上(此前有痕 dropped)。`delta` 读不出 ⇒ malformed(server 判不出形整帧不发,
+            //   本层读不出就是坏帧);三键身份原样透传。宿主按 `fromDigest` 与手上名册比对(applyToolRosterDelta),包不持名册。
+            const raw = ev;
+            const delta = projectToolRosterDelta(raw.delta);
+            if (delta === undefined)
+                return dropped('malformed', 'tool_roster_delta');
+            const { identity, bad } = identityOrMalformed(raw, 'tool_roster_delta');
+            if (bad !== null)
+                return bad;
+            return projected(stamp(ctx, armBody({ type: 'tool_roster_delta', delta, ...identity })));
+        }
         // ── `human_input`(core 5.14.0 design/171 / server 7.4.0 SSE,[3017]/[3020])────────────
         // 🔴 **到期复核已兑现(sdk 6.9.0 提货,2026-08-08)**:本臂此前是 switch **之前**的一条 raw
         //    预分派(理由 = 它还没进 SDK 6.3.0 的 `AgentEvent` union,`case 'human_input'` 在 `ev.type`
@@ -666,8 +683,12 @@ export function eventToSdkMessage(ev, ctx) {
             // `eventId` 与别的臂同律带上(core 铸的事件身份;wire 未必带 ⇒ 缺席时键不在场)。
             // 🔴 主会话收货门 A1c 抓出的死臂:适配层 `wiringManifestArm` 读 `m.eventId`,而本层原来没投它,
             //    那句透传永远是空 —— 消费端拿不到幂等键,durable 重放只能退到内容去重。
-            const eventId = typeof raw.eventId === 'string' && raw.eventId.length > 0 ? { eventId: raw.eventId } : {};
-            return projected(stamp(ctx, armBody({ type: 'wiring_manifest', ...body, ...eventId })));
+            //    三键身份同函数透传 + 坏值不买路(异源对抗复审第 1 轮 finding②:修前只留 eventId,臂看不见 sourceTaskId / bgAgentId,
+            //    子代的接线快照(0.71.0 起含 tools 名册)会上 leader 面、被端当作名册重同步基线)。
+            const { identity, bad } = identityOrMalformed(raw, 'wiring_manifest');
+            if (bad !== null)
+                return bad;
+            return projected(stamp(ctx, armBody({ type: 'wiring_manifest', ...body, ...identity })));
         }
         case 'task_notification': {
             // 载荷两形:嵌在 `notification` 里(server 早期形)或直接摊在帧上(今天的 union 形)。
@@ -812,7 +833,6 @@ export function eventToSdkMessage(ev, ctx) {
         case 'file_link':
         case 'prompt_assembled':
         case 'model_usage':
-        case 'context_usage':
         case 'config_assembled':
         // `needs_review`:plan-review park 的**事件**形;壳消费的是 done{status:'needs_review'} 终帧
         //   (runStream 的 plan_review_park chrome 臂),事件形在本切片重复且更早,故不投影。
@@ -886,6 +906,16 @@ export function eventToSdkMessage(ev, ctx) {
         //    身份键**根本不在** SDK 臂声明里(SDK 从 SSE `id:` stamp),收窄形上读它们是编译错。
         case 'engine_notice':
             return engineNoticeProjection(ev, ctx);
+        // CC-08(0.71.0,sdk 9.6.0 换钉):两条新帧。投影仍走 raw `Record` 视图(理由同 engine_notice:
+        // wire 是 JSON,必填是 server 的承诺不是本层的前提;缺席/坏值逐键诚实处理)。
+        case 'tool_disclosure':
+            return toolDisclosureProjection(ev, ctx);
+        // CC-08 ③(0.71.0):`context_usage` 从 not_in_slice 组里拿出来 —— sections(core 7.18.0 #790)是「这条腿的系统提示词
+        //   由哪些段组成、哪一段大」,fleet/HUD 面要渲;三个标量走 finite 门(非有限即缺席,永不 null)。
+        case 'context_usage':
+            return contextUsageProjection(ev, ctx);
+        case 'tool_progress':
+            return toolProgressProjection(ev, ctx);
         default:
             // B5 穷举:SDK union 加成员必须在**编译期**打红这一行(而不是让新臂在用户面静默丢帧)。
             assertNeverArm(ev);
@@ -894,6 +924,91 @@ export function eventToSdkMessage(ev, ctx) {
             return dropped('unknown_arm', String(ev.type ?? 'unknown'));
     }
 }
+/** CC-08:三键身份(sdk `EventIdentity`)—— 在场非串 ⇒ 坏值不买路;在场(含空串)⇒ 原样透传;`eventId` 非空才带。 */
+function identityOrMalformed(ev, arm) {
+    for (const k of SEGMENT_END_IDENTITY_KEYS) {
+        if (ev[k] !== undefined && typeof ev[k] !== 'string')
+            return { identity: {}, bad: dropped('malformed', arm) };
+    }
+    const identity = {};
+    for (const k of ['eventId', ...SEGMENT_END_IDENTITY_KEYS]) {
+        // 🔴 三键**空串也透**:子流律是「键在场 = 子代帧」(`isSubFlowSegmentEnd` / `text_end` 投影同律),按 length>0 才抄会把
+        //    `sourceTaskId: ''` 的子代帧洗成主流(异源对抗复审第 1 轮 finding③);`eventId` 是幂等键,仍要非空。
+        if (typeof ev[k] === 'string' && (k === 'eventId' ? ev[k].length > 0 : true))
+            identity[k] = ev[k];
+    }
+    return { identity, bad: null };
+}
+/** 非空串数组窄读:非数组 ⇒ undefined(调用方判 malformed);数组里的非串 / 空串按 server 律**逐个滤掉**。 */
+function nameList(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    return v.filter((x) => typeof x === 'string' && x.length > 0);
+}
+const nonNegInt = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;
+/**
+ * `tool_disclosure` → 中性内部臂(CC-08,0.71.0;core design/393 S3 第二缝,sdk 9.6.0)。
+ * 这条腿的工具**名字占位普查**:`policy` 开集三词(core 加一档要能穿过 default 臂)/ `thresholdPercent?`
+ * (🔴 缺席 = `always`/`never` 两档下根本没查过阈值,**不是**默认百分比;坏值 ⇒ 键不铸不丢帧)/
+ * `deferred[]` / `activated[]`(全量快照,整只替换;数组里的非串空串逐个滤 = server 律同形)。
+ * 🔴 三只必需位缺一 ⇒ `malformed`:半张普查表会被读成「只有这些被延迟」。
+ */
+function toolDisclosureProjection(ev, ctx) {
+    const policy = ev.policy;
+    if (typeof policy !== 'string' || policy.length === 0)
+        return dropped('malformed', 'tool_disclosure');
+    const deferred = nameList(ev.deferred);
+    const activated = nameList(ev.activated);
+    if (deferred === undefined || activated === undefined)
+        return dropped('malformed', 'tool_disclosure');
+    if (Array.isArray(ev.activated) && ev.activated.some((x) => typeof x !== 'string'))
+        return dropped('malformed', 'tool_disclosure');
+    const { identity, bad } = identityOrMalformed(ev, 'tool_disclosure');
+    if (bad !== null)
+        return bad;
+    const threshold = typeof ev.thresholdPercent === 'number' && Number.isFinite(ev.thresholdPercent) && ev.thresholdPercent >= 0
+        ? ev.thresholdPercent
+        : undefined;
+    return projected(stamp(ctx, armBody({
+        type: 'tool_disclosure',
+        policy,
+        ...(threshold !== undefined ? { thresholdPercent: threshold } : {}),
+        deferred,
+        activated,
+        ...identity,
+    })));
+}
+/**
+ * `tool_progress` → 中性内部臂(CC-08,0.71.0;DV-741,clay C-R50 裁「一帧两拍」入 divergence 册,本包按裁定形投)。
+ * `toolCallId` / `toolName` 必在(接不回自己 `tool_start` 的 tick 挂不上卡 ⇒ `malformed`);
+ * `elapsedTimeSeconds?`(🔴 缺席不是 0);`output?` 在场 = 尾巴窗口(UNTRUSTED RAW,与 `tool_end.output` 同类,
+ * 绝不回喂模型)+ `totalLines?` / `totalBytes?`;`output` 缺席 ⇒ 后两键**一起**不铸(server 律:三者按 output 在场判)。
+ */
+function toolProgressProjection(ev, ctx) {
+    const toolCallId = ev.toolCallId;
+    const toolName = ev.toolName;
+    if (typeof toolCallId !== 'string' || toolCallId.length === 0)
+        return dropped('malformed', 'tool_progress');
+    if (typeof toolName !== 'string' || toolName.length === 0)
+        return dropped('malformed', 'tool_progress');
+    const { identity, bad } = identityOrMalformed(ev, 'tool_progress');
+    if (bad !== null)
+        return bad;
+    const elapsed = nonNegInt(ev.elapsedTimeSeconds);
+    const output = typeof ev.output === 'string' ? ev.output : undefined;
+    const totalLines = output !== undefined ? nonNegInt(ev.totalLines) : undefined;
+    const totalBytes = output !== undefined ? nonNegInt(ev.totalBytes) : undefined;
+    return projected(stamp(ctx, armBody({
+        type: 'tool_progress',
+        toolCallId,
+        toolName,
+        ...(elapsed !== undefined ? { elapsedTimeSeconds: elapsed } : {}),
+        ...(output !== undefined ? { output } : {}),
+        ...(totalLines !== undefined ? { totalLines } : {}),
+        ...(totalBytes !== undefined ? { totalBytes } : {}),
+        ...identity,
+    })));
+}
 /**
  * `text_end` → 中性内部**段边界**臂(#323 / core #447)。
  *
@@ -983,24 +1098,8 @@ function segmentEndProjection(ev, ctx, arm) {
         ? projected(stamp(ctx, armBody({ type: 'text_end', content, ...identity })))
         : projected(stamp(ctx, armBody({ type: 'reasoning_end', content, ...identity })));
 }
-/**
- * `wiring_manifest.mcp` 的形校验(S-124 / core 7.5.0,server ≥7.60.0)。
- *
- * 🔴 **空数组 ≠ 缺席,两者都要能被消费端分辨**(core 顶注逐字:"an empty array is *this leg
- *    declared no servers*, absence is an older mint or an external derivation")⇒ **真的**空数组
- *    原样铸成 `[]`。把它折成缺席 = 把「我一台都没申报」这句**正面事实**说成「不知道」。
- * 🔴 **但「过滤后为空」不是「原本就是空」**(异源对抗复审 r1 [medium] 采纳,真病):一份
- *    `[{name:'github', errorCode:'http_503'}]`(缺 `status`)进来时,唯一那一行被下面的逐行判据
- *    丢掉 —— 若照样铸出 `[]`,消费端按本臂的义务④读到的是**「这条腿一台都没申报」这句肯定话**,
- *    一份读不懂的回体就此被伪装成一个确定的零申报。⇒ **非空输入而零行幸存 ⇒ 整段缺席**
- *    (「我读不出来」不是「我知道是零」)。这与下面「逐条独立」并不矛盾:只要**还有幸存者**,
- *    半张表仍是真读数,坏行照旧只丢自己。
- * 🔴 **逐条独立**:一条坏行只丢自己(与 server 侧 `continue` 同判据),绝不因为一条坏行丢整表。
- * 🔴 **逐键挑,禁 spread**:core 往条目上加新键时必须由人显式处置 —— 而它下一个加的很可能又是
- *    一个像 `error` 那样的自由文本面。(0.60.0 按此显式处置了 S6-B 的 `delivered` / `httpStatus`。)
- * ⚠️ `toolCount` 按**有限数**判(`Number.isFinite`),不按真值判:`0` 是合法读数(连上了、零工具),
- *    折成缺席会让「连上了但没工具」与「没报」在消费端同形。
- */
+const _mcpEntryViewPin = true;
+void _mcpEntryViewPin;
 export function projectMcpSection(raw) {
     if (!Array.isArray(raw))
         return undefined;
@@ -1117,14 +1216,77 @@ function wiringManifestSupersetBody(ev) {
     //    空数组是一句正面事实(「这条腿一台都没申报」),拿它当「没有这一段」会让 `mcp: []` 的帧连同
     //    另两段一起落回 `not_in_slice`,而那正是 core 顶注点名要防的读法。
     const mcp = projectMcpSection(ev.mcp);
-    if (modelGate === undefined && autoMode === undefined && mcp === undefined)
+    // CC-08 ①(0.71.0):第四/五/六段进切片 —— tools(L-315;读器归 toolRoster.ts)/ hooks[] / lsp{mounted, lane?}。
+    const tools = projectToolRoster(ev);
+    const hooks = projectHooksSection(ev.hooks);
+    const lsp = projectLspSection(ev.lsp);
+    if (modelGate === undefined && autoMode === undefined && mcp === undefined && tools === undefined && hooks === undefined && lsp === undefined)
         return undefined;
     return {
         ...(modelGate !== undefined ? { _sema_modelGate: modelGate } : {}),
         ...(autoMode !== undefined ? { _sema_autoMode: autoMode } : {}),
         ...(mcp !== undefined ? { _sema_mcp: mcp } : {}),
+        ...(tools !== undefined ? { _sema_tools: tools } : {}),
+        ...(hooks !== undefined ? { _sema_hooks: hooks } : {}),
+        ...(lsp !== undefined ? { _sema_lsp: lsp } : {}),
     };
 }
+function projectHooksSection(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const rows = [];
+    for (const r of raw) {
+        if (typeof r !== 'object' || r === null || Array.isArray(r))
+            continue;
+        const o = r;
+        if (typeof o.family !== 'string' || o.family.length === 0 || typeof o.owner !== 'string' || o.owner.length === 0)
+            continue;
+        rows.push({ family: o.family, owner: o.owner, ...(o.observational === true ? { observational: true } : {}) });
+    }
+    return rows.length > 0 ? rows : undefined;
+}
+function projectLspSection(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return undefined;
+    const o = raw;
+    if (typeof o.mounted !== 'boolean')
+        return undefined;
+    return { mounted: o.mounted, ...(typeof o.lane === 'string' && o.lane.length > 0 ? { lane: o.lane } : {}) };
+}
+function contextUsageProjection(ev, ctx) {
+    const { identity, bad } = identityOrMalformed(ev, 'context_usage');
+    if (bad !== null)
+        return bad;
+    const fin = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : undefined);
+    const usedTokens = fin(ev.usedTokens);
+    const windowTokens = fin(ev.windowTokens);
+    const compactAtTokens = fin(ev.compactAtTokens);
+    let sections;
+    if (Array.isArray(ev.sections)) {
+        const rows = [];
+        for (const r of ev.sections) {
+            if (typeof r !== 'object' || r === null || Array.isArray(r))
+                continue;
+            const o = r;
+            const tokens = fin(o.tokens);
+            if (typeof o.id !== 'string' || o.id.length === 0 || tokens === undefined)
+                continue; // 坏行逐条丢(server 律同形)
+            rows.push({ id: o.id, tokens, ...(typeof o.kind === 'string' && o.kind.length > 0 ? { kind: o.kind } : {}) });
+        }
+        if (rows.length > 0)
+            sections = rows; // 全丢光 ⇒ 键缺席(= 这条腿没装配出段 IR,不是各段为零)
+    }
+    if (usedTokens === undefined && windowTokens === undefined && compactAtTokens === undefined && sections === undefined)
+        return nothing('empty_payload');
+    return projected(stamp(ctx, armBody({
+        type: 'context_usage',
+        ...(usedTokens !== undefined ? { usedTokens } : {}),
+        ...(windowTokens !== undefined ? { windowTokens } : {}),
+        ...(compactAtTokens !== undefined ? { compactAtTokens } : {}),
+        ...(sections !== undefined ? { sections } : {}),
+        ...identity,
+    })));
+}
 function engineNoticeProjection(ev, ctx) {
     const code = typeof ev.code === 'string' && ev.code.length > 0 ? ev.code : undefined;
     if (code === undefined)

package/dist/agentsWireCaps.d.ts

@@ -5,13 +5,6 @@ export declare const MAX_AGENT_TEXT_CHARS = 4096;
 export declare const MAX_AGENT_SYSTEM_PROMPT_CHARS = 65536;
 export declare const MAX_AGENT_TOOLS = 64;
 export declare const MAX_AGENT_TOOL_NAME_CHARS = 128;
-/**
- * 🔴 **已退役(0.70.2,CC-18):本常量不再被任何投影读**,保留导出只为不破型面,随下一个 minor 删。
- * server 7.78.1 的 `agents[].skills` 臂删掉了 `v.length <= MAX_AGENT_SKILLS`(7.78.0 及以前仍有),
- * 引擎侧改按字节预算渲染技能清单;包侧再按 10 条截 = 在一道已不存在的门下面**静默丢技能**,
- * 与顶层 `SKILL_CAPS.items`(0.70.0 退役)是同一个病形的同轴存量。
- */
-export declare const MAX_AGENT_SKILLS = 10;
 export declare const MAX_AGENT_SKILL_CONTENT_CHARS = 1048576;
 export declare const MAX_AGENT_MAX_TURNS = 1000;
 /** server 1.205 TASK_AGENT_FIELD_SHAPES 的 15 字段白名单(permissionMode 显式拒收,不在表内)。 */

package/dist/agentsWireCaps.js

@@ -16,13 +16,7 @@ export const MAX_AGENT_TEXT_CHARS = 4_096;
 export const MAX_AGENT_SYSTEM_PROMPT_CHARS = 65_536;
 export const MAX_AGENT_TOOLS = 64;
 export const MAX_AGENT_TOOL_NAME_CHARS = 128;
-/**
- * 🔴 **已退役(0.70.2,CC-18):本常量不再被任何投影读**,保留导出只为不破型面,随下一个 minor 删。
- * server 7.78.1 的 `agents[].skills` 臂删掉了 `v.length <= MAX_AGENT_SKILLS`(7.78.0 及以前仍有),
- * 引擎侧改按字节预算渲染技能清单;包侧再按 10 条截 = 在一道已不存在的门下面**静默丢技能**,
- * 与顶层 `SKILL_CAPS.items`(0.70.0 退役)是同一个病形的同轴存量。
- */
-export const MAX_AGENT_SKILLS = 10;
+// 0.71.0(CC-18 收口):`MAX_AGENT_SKILLS` 常量已删(0.70.2 退役保留一版;server 7.78.1 起 agents[].skills 无条数帽)。
 export const MAX_AGENT_SKILL_CONTENT_CHARS = 1_048_576;
 export const MAX_AGENT_MAX_TURNS = 1_000;
 /** server 1.205 TASK_AGENT_FIELD_SHAPES 的 15 字段白名单(permissionMode 显式拒收,不在表内)。 */

package/dist/cloudConfigWireCaps.js

@@ -100,7 +100,7 @@ export function cloudMcpToSpecs(servers, env) {
             ...(s.elicitation === true ? { elicitation: true } : {}),
             // ── 0.64.2 族扫(cli L-167① 的**同形存量第二处**)─────────────────────────────────────
             // 病形与 `mcpWireCaps.mcpConfigToSpec` **逐字同一条**:这也是一次逐键白名单重建,而
-            // settings-schema 的 mcp 段上有**解析透明键**(`z.unknown()`;1.10.0 两员 `source` / `toolFaces`)。
+            // settings-schema 的 mcp 段上有**解析透明键**(`z.unknown()`;1.10.0 两员 `source` / `toolFaces`,2.0.0 同形〔2026-09-16 核〕)。
             // 上游对 `toolFaces` 的成文是「三条腿(请求 / config-center / 本地 config.d)同一条规则」——
             // 本函数正是 **config-center 那条腿落到请求面**的投影,只修本地那条 = 同形存量留一半:
             // 用 center 下发配置的部署,运维声明的 per-tool 面照样在包边界被静默剥掉。

package/dist/decideReceipt.d.ts

@@ -97,16 +97,16 @@ export interface DecideRefusalDetail {
     detail: string;
     /**
      * **同一个决定再发一次有没有用**。
-     * 🔴 三个码上的取值各有出处(见 `engineErrorCodes.ts` 的逐码顶注),**不是**按严重程度排的:
-     *    `host_unknown` = `false`(无重试价值);`host_not_parked` / `remember_unsupported` = `true`
-     *    (前者等宿主再 park,后者去掉 `remember`)。
-     * ⚠️ `true` **不带窗**:server 在这三个码上**从不**铸 `retryAfterSec`(它只在
+     * 🔴 两个码上的取值各有出处(见 `engineErrorCodes.ts` 的逐码顶注),**不是**按严重程度排的:
+     *    `host_unknown` = `false`(无重试价值);`remember_unsupported` = `true`(去掉 `remember` 重发)。
+     *    0.71.0 CC-20:曾有第三码(宿主没停在 park 上,可重发)已随 server 7.72.0 退役,那条车道改铸新 run 不再拒。
+     * ⚠️ `true` **不带窗**:server 在这两个码上**从不**铸 `retryAfterSec`(它只在
      *    `RESUME_RETRY_LATER_CODES` 那两码上铸)⇒ 端**不许**据此渲一个编出来的倒计时。
      */
     resendable: boolean;
 }
 /**
- * 一个 decide 失败抛出物 → {@link DecideRefusalDetail};不是这三个码之一 ⇒ `null`。
+ * 一个 decide 失败抛出物 → {@link DecideRefusalDetail};不是这两个码之一 ⇒ `null`。
  *
  * 🔴 **判型是闭集的,消费面是开集的**(与 `resumeRefusalFromError` 逐字同律):不认识的码一律
  *    `null` ⇒ 端一个字都不补 ⇒ 机器可读那一行(`API Error: <status> <errorCode> · <msg>`)原样上屏。

package/dist/decideReceipt.js

@@ -32,7 +32,7 @@
  *   消费端渲卡时:**在场**才说「执行时被放行/被否」,缺席一个字都不说。
  */
 import { gateOutcomeOf } from './gateOutcome.js';
-import { DECIDE_WORKFLOW_HOST_NOT_PARKED, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, } from './engineErrorCodes.js';
+import { DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, } from './engineErrorCodes.js';
 /** 受理形/parked 回执上那个**唯一**表示「受理了、还没做完」的状态词(sdk README §9.0.0 逐字)。 */
 const STATUS_RESUMING = 'resuming';
 /** 非空串窄读(与本包其余读面同一条:空串 = 没这一格)。 */
@@ -101,17 +101,15 @@ export function decideAcceptedNotResolved(receipt) {
  */
 const DECIDE_REFUSAL_SENTENCES = Object.freeze({
     [DECIDE_WORKFLOW_HOST_UNKNOWN]: 'this workflow run carries no originating session to deliver the decision to, so re-sending the same decision cannot help; the approval is still pending and can be decided again once the run is reachable',
-    [DECIDE_WORKFLOW_HOST_NOT_PARKED]: 'the host session is not sitting on a wakeable pause right now, so this delivery had nowhere to land; the approval is still pending — send it again once the host parks, or resume that run directly',
     [DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED]: 'this lane refuses to remember the decision for the session; re-send the same decision without the remember option — nothing was consumed by this refusal',
 });
 /** 按码给出的 `resendable`(单铸;理由逐码写在 `engineErrorCodes.ts` 的顶注里)。 */
 const DECIDE_RESENDABLE = Object.freeze({
     [DECIDE_WORKFLOW_HOST_UNKNOWN]: false,
-    [DECIDE_WORKFLOW_HOST_NOT_PARKED]: true,
     [DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED]: true,
 });
 /**
- * 一个 decide 失败抛出物 → {@link DecideRefusalDetail};不是这三个码之一 ⇒ `null`。
+ * 一个 decide 失败抛出物 → {@link DecideRefusalDetail};不是这两个码之一 ⇒ `null`。
  *
  * 🔴 **判型是闭集的,消费面是开集的**(与 `resumeRefusalFromError` 逐字同律):不认识的码一律
  *    `null` ⇒ 端一个字都不补 ⇒ 机器可读那一行(`API Error: <status> <errorCode> · <msg>`)原样上屏。

package/dist/engineErrorCodes.d.ts

@@ -258,14 +258,6 @@ export declare const RESUME_RETRY_LATER_CODES: readonly string[];
  *    `runId` 自己去看那条 run(或换一条路 resume 它)。
  */
 export declare const DECIDE_WORKFLOW_HOST_UNKNOWN = "decide.workflow_host_unknown";
-/**
- * `decide.workflow_host_not_parked`(409;同上:「宿主此刻没停在可唤醒的 park 上 ⇒ **等它再 park
- * 后重发**,或据 `runId` 自行 resume」)。
- * 🔴 与上一码**刻意分成两个词**:这一个**可以**重发(宿主是时序问题),上一个不能。
- *    ⚠️ 但它**不在** {@link RESUME_RETRY_LATER_CODES} 里,也不该在 —— 那张表闭的是「server 在哪些码上
- *    铸 `retryAfterSec`」,而本码**恒无窗**(server 给不出「等多久」)。可等 ≠ 有窗。
- */
-export declare const DECIDE_WORKFLOW_HOST_NOT_PARKED = "decide.workflow_host_not_parked";
 /**
  * `decide.workflow_remember_unsupported`(400;同上:「本车道 fail-closed 拒 `remember:"session"`」)。
  * 🔴 出路是**去掉 `remember` 重发**,而且 sdk 顶注逐字保证「零副作用」——这一格与另外两个 409
@@ -273,14 +265,18 @@ export declare const DECIDE_WORKFLOW_HOST_NOT_PARKED = "decide.workflow_host_not
  */
 export declare const DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED = "decide.workflow_remember_unsupported";
 /**
- * `/decide` workflow 车道的拒绝码**闭集**(三员)。
+ * `/decide` workflow 车道的拒绝码**闭集**(两员;0.71.0 CC-20 退役 `host_not_parked` 后从三员收成两员)。
  *
  * 🔴 闭的不是「`decide.*` 一共有几个码」(那仍是开集:`approval_binding_mismatch` /
  *    `approval_stale` / `gate_not_tool_approval` 等都不在本表,它们各有既有处置),闭的是
- *    「**这三个码是 workflow 那条新车道独有的、而且各自有一句人话**」。
+ *    「**这两个码是 workflow 那条新车道独有的、而且各自有一句人话**」。
  * 🔴 **形制**:`Object.freeze` 的数组,不是 `ReadonlySet`(同 {@link RESUME_RETRY_LATER_CODES} 的
  *    已定谳病形 —— `ReadonlySet` 只在类型面只读,而判定查的就是公面上这同一个实例)。
  * 🔴 加成员必须**同批**补那一句人话 + 判据,不许靠 `decide.` 前缀放宽(前缀下住着三种处置)。
+ * 🔴 **删成员义务**(0.71.0 CC-20 补):上游退役某码(sdk errors.d.ts 顶注 ⚰️ RETIRED 无别名)⇒ 同批删常量、出路句、
+ *    `resendable` 行,退役词进 census 门登记;decide-receipt 门 E0 对每一员钉「上游仍活着」,上游退役当天先红。
+ * 📋 **刻意不镜像**:`decide.workflow_park_identity_lost`(server 7.71.0 引入、7.75.0 退役,sdk 从未建模,继任 `decide.workflow_resume_not_admitted`
+ *    家族由 sdk 类承载);端收到未知 `decide.*` 码一律走开集通用行(机器行原样上屏),本表不为已退役码留位。
  */
 export declare const DECIDE_WORKFLOW_LANE_CODES: readonly string[];
 /** 这条 workflow 的 park 真相**读不出来**(店抛了 / 超时 / 记录不在 / 记录还在跑)。

package/dist/engineErrorCodes.js

@@ -351,14 +351,8 @@ export const RESUME_RETRY_LATER_CODES = Object.freeze([
  *    `runId` 自己去看那条 run(或换一条路 resume 它)。
  */
 export const DECIDE_WORKFLOW_HOST_UNKNOWN = 'decide.workflow_host_unknown';
-/**
- * `decide.workflow_host_not_parked`(409;同上:「宿主此刻没停在可唤醒的 park 上 ⇒ **等它再 park
- * 后重发**,或据 `runId` 自行 resume」)。
- * 🔴 与上一码**刻意分成两个词**:这一个**可以**重发(宿主是时序问题),上一个不能。
- *    ⚠️ 但它**不在** {@link RESUME_RETRY_LATER_CODES} 里,也不该在 —— 那张表闭的是「server 在哪些码上
- *    铸 `retryAfterSec`」,而本码**恒无窗**(server 给不出「等多久」)。可等 ≠ 有窗。
- */
-export const DECIDE_WORKFLOW_HOST_NOT_PARKED = 'decide.workflow_host_not_parked';
+// 0.71.0(CC-20):`decide.workflow_host_not_parked` 常量与出路句**整只退役**(server 7.72.0 退役无别名,sdk errors.d.ts ⚰️ 顶注:
+//   ≥7.72.0 永不再发 —— 那条车道有了第二条腿,宿主没停在 park 上时改铸新 run,不再拒);退役词由 census 门钉零命中。
 /**
  * `decide.workflow_remember_unsupported`(400;同上:「本车道 fail-closed 拒 `remember:"session"`」)。
  * 🔴 出路是**去掉 `remember` 重发**,而且 sdk 顶注逐字保证「零副作用」——这一格与另外两个 409
@@ -366,18 +360,21 @@ export const DECIDE_WORKFLOW_HOST_NOT_PARKED = 'decide.workflow_host_not_parked'
  */
 export const DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED = 'decide.workflow_remember_unsupported';
 /**
- * `/decide` workflow 车道的拒绝码**闭集**(三员)。
+ * `/decide` workflow 车道的拒绝码**闭集**(两员;0.71.0 CC-20 退役 `host_not_parked` 后从三员收成两员)。
  *
  * 🔴 闭的不是「`decide.*` 一共有几个码」(那仍是开集:`approval_binding_mismatch` /
  *    `approval_stale` / `gate_not_tool_approval` 等都不在本表,它们各有既有处置),闭的是
- *    「**这三个码是 workflow 那条新车道独有的、而且各自有一句人话**」。
+ *    「**这两个码是 workflow 那条新车道独有的、而且各自有一句人话**」。
  * 🔴 **形制**:`Object.freeze` 的数组,不是 `ReadonlySet`(同 {@link RESUME_RETRY_LATER_CODES} 的
  *    已定谳病形 —— `ReadonlySet` 只在类型面只读,而判定查的就是公面上这同一个实例)。
  * 🔴 加成员必须**同批**补那一句人话 + 判据,不许靠 `decide.` 前缀放宽(前缀下住着三种处置)。
+ * 🔴 **删成员义务**(0.71.0 CC-20 补):上游退役某码(sdk errors.d.ts 顶注 ⚰️ RETIRED 无别名)⇒ 同批删常量、出路句、
+ *    `resendable` 行,退役词进 census 门登记;decide-receipt 门 E0 对每一员钉「上游仍活着」,上游退役当天先红。
+ * 📋 **刻意不镜像**:`decide.workflow_park_identity_lost`(server 7.71.0 引入、7.75.0 退役,sdk 从未建模,继任 `decide.workflow_resume_not_admitted`
+ *    家族由 sdk 类承载);端收到未知 `decide.*` 码一律走开集通用行(机器行原样上屏),本表不为已退役码留位。
  */
 export const DECIDE_WORKFLOW_LANE_CODES = Object.freeze([
     DECIDE_WORKFLOW_HOST_UNKNOWN,
-    DECIDE_WORKFLOW_HOST_NOT_PARKED,
     DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED,
 ]);
 // ══ 0.68.0 提货批(core 7.17.0 #652;server [7084] D 段)—— workflow **park 真相**四拒码 ══════

package/dist/engineNoticeCodes.d.ts

@@ -54,7 +54,7 @@
 /** 一条通告是**说给谁听**的。两值,刻意不设第三值(见模块顶注)。 */
 export type NoticeAudience = 'user' | 'operator';
 /**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.19.0 = 五十九码**(7.17.x 五十二 + 7.18.0 #748 两枚 writeFace + #742 两枚 classifier + 7.19.0 三枚:`classifier.role_defaulted` / `classifier.contract_broken` / `skills.listing_truncated`,均 operator);顺序同源)。
+ * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.20.0 = 六十四码**(7.19.0 五十九 + 7.20.0 五枚:`config.task_root_not_canonical` / `config.execution_env_capability_invalid` / `config.forward_sink_failed` / `memory.restore_withheld` / `agents.listing_truncated`,均 operator);顺序同源)。
  * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
  * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
  *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。
@@ -202,10 +202,9 @@ export interface DurableGateUnavailableFactsView {
 export declare function readDurableGateUnavailable(notice: unknown): DurableGateUnavailableFactsView | undefined;
 /** `skills.listing_truncated` 通告 `detail` 上的事实(core `skill-listing-budget.js` 铸点逐格)。 */
 export interface SkillsListingTruncatedFactsView {
-    /** 清单实际拿到的字节预算(交付车道结构性 clamp 之后)。 */
+    /** 清单实际拿到的字节预算 = 在场预算(core 7.20.0 起 8 KiB 结构天花板退役,声明比例即实际;0.70.0 那版曾并列一个
+     *  `requestedBudgetBytes?` 与派生 `laneClamped?`,随该 detail 键在 7.20.0 删除而**整只退役**——不留恒 false 的位)。 */
     budgetBytes: number;
-    /** 部署声明的比例**要**的预算(clamp 之前);只在 clamp 真绑住时与 `budgetBytes` 不同。读不出 ⇒ 键不铸。 */
-    requestedBudgetBytes?: number;
     /** 每条描述的字符帽(含省略号)。读不出 ⇒ 键不铸。 */
     descMaxChars?: number;
     /** 这一帧清单上的技能总数(初始清单 = 全名册;drift 帧 = 新宣告的那一批)。 */
@@ -216,9 +215,6 @@ export interface SkillsListingTruncatedFactsView {
     nameOnly: readonly string[];
     /** 整条没进清单的技能名(病态形;Skill 工具仍服务它们)。 */
     dropped: readonly string[];
-    /** 🔴 清单是被**交付车道的结构性 clamp** 缩短的(而不是部署自己的比例):`requestedBudgetBytes` 在场且 ≠ `budgetBytes`。
-     *  两者都读得出才铸;缺席 = 分不出(不折 `false`)。运维面据此分「调 fraction 有用」与「调了也没用」。 */
-    laneClamped?: boolean;
     /** 投给哪个会话。读不出 ⇒ 键不铸(operator 通告不要求会话)。 */
     sessionId?: string;
 }

package/dist/engineNoticeCodes.js

@@ -52,7 +52,7 @@
  * 出现在本包源码或产物里 => 当场红。
  */
 /**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.19.0 = 五十九码**(7.17.x 五十二 + 7.18.0 #748 两枚 writeFace + #742 两枚 classifier + 7.19.0 三枚:`classifier.role_defaulted` / `classifier.contract_broken` / `skills.listing_truncated`,均 operator);顺序同源)。
+ * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.20.0 = 六十四码**(7.19.0 五十九 + 7.20.0 五枚:`config.task_root_not_canonical` / `config.execution_env_capability_invalid` / `config.forward_sink_failed` / `memory.restore_withheld` / `agents.listing_truncated`,均 operator);顺序同源)。
  * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
  * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
  *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。
@@ -76,9 +76,14 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     // 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',
+    // core 7.20.0(0.71.0 提货):任务根非规范路径 / 远端执行环境能力声明坏值,两枚部署面通告;顺序同源(紧跟 artifact_host_invalid)。
+    'config.task_root_not_canonical',
+    'config.execution_env_capability_invalid',
     'config.tool_card_undeclared',
     'config.tool_face_undeclared',
     'config.tool_face_invalid',
+    // core 7.20.0:转发 sink 失败;顺序同源(紧跟 tool_face_invalid)。
+    'config.forward_sink_failed',
     'config.durable_gate_unavailable',
     'config.peer_admission_out_of_range',
     'config.peer_lane_unmounted',
@@ -111,6 +116,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'memory.consolidation_incomplete',
     'memory.consolidation_refused',
     'memory.consolidation_withheld',
+    // core 7.20.0:恢复被扣留;顺序同源(紧跟 consolidation_withheld)。
+    'memory.restore_withheld',
     'route.fallback_to_primary',
     // core 7.18.0 #742(CC-05):分类器候选梯子无可路由席;元组 @44。
     'route.classifier_unroutable',
@@ -128,6 +135,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     // core 7.19.0(CC-04 core 半场):`<skills>` 披露块超字节预算 ⇒ 至少一条只列名(`detail.nameOnly[]`)或整条不列
     //   (`detail.dropped[]`);Skill 工具仍服务全部技能。运维面事(调 skillListingBudgetFraction / skillListingMaxDescChars / 少声明)。
     'skills.listing_truncated',
+    // core 7.20.0:agent roster 清单超预算(与 skills 同族;同一个 fraction 预算);顺序同源(紧跟 skills.listing_truncated)。
+    'agents.listing_truncated',
     'tool_result.offload_put_failed',
 ]);
 const CATALOG = new Set(ENGINE_NOTICE_CODES);
@@ -157,9 +166,12 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.tool_model_gate_env_invalid': 'operator',
     // 0.68.0 提货批:`NOTICE_AUDIENCE_TABLE:181` 真字节 —— 一条「宿主把 artifact 席接坏了」的部署事实。
     'config.artifact_host_invalid': 'operator',
+    'config.task_root_not_canonical': 'operator',
+    'config.execution_env_capability_invalid': 'operator',
     'config.tool_card_undeclared': 'operator',
     'config.tool_face_undeclared': 'operator',
     'config.tool_face_invalid': 'operator',
+    'config.forward_sink_failed': 'operator',
     'config.durable_gate_unavailable': 'user',
     'config.peer_admission_out_of_range': 'operator',
     'config.peer_lane_unmounted': 'operator',
@@ -192,6 +204,7 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     // 🔴 core 7.14.0 **value-domain BREAKING**:user → operator(见模块顶注提货记账段;
     //    理由 = 这条通告没有 sessionId,一次固化跑在任何会话之外)。
     'memory.consolidation_withheld': 'operator',
+    'memory.restore_withheld': 'operator',
     'route.fallback_to_primary': 'operator',
     'route.classifier_unroutable': 'operator',
     'route.base_url_changed_key_unchanged': 'operator',
@@ -205,6 +218,7 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'memory.capture_opted_out': 'user',
     'memory.capture_optout_unpersisted': 'user',
     'skills.listing_truncated': 'operator',
+    'agents.listing_truncated': 'operator',
     'tool_result.offload_put_failed': 'operator',
 });
 /**
@@ -405,18 +419,16 @@ export function readSkillsListingTruncated(notice) {
     if (budgetBytes === undefined || total === undefined || kept === undefined || nameOnly === undefined || dropped === undefined) {
         return undefined;
     }
-    const requestedBudgetBytes = nonNegInt(o.requestedBudgetBytes);
+    // 0.71.0:`requestedBudgetBytes` 若在场(老引擎 7.19.0)**不铸不派生**——它在 7.20.0 已删,本视图不再有它的位。
     const descMaxChars = nonNegInt(o.descMaxChars);
     const sessionId = typeof o.sessionId === 'string' && o.sessionId.length > 0 ? o.sessionId : undefined;
     return {
         budgetBytes,
-        ...(requestedBudgetBytes !== undefined ? { requestedBudgetBytes } : {}),
         ...(descMaxChars !== undefined ? { descMaxChars } : {}),
         total,
         kept,
         nameOnly,
         dropped,
-        ...(requestedBudgetBytes !== undefined ? { laneClamped: requestedBudgetBytes !== budgetBytes } : {}),
         ...(sessionId !== undefined ? { sessionId } : {}),
     };
 }

package/dist/hitl/toolApprovalWire.d.ts

@@ -1086,6 +1086,16 @@ export interface ToolApprovalFrame {
     expiresAtMs?: number;
     /** server 出帧时刻(epoch ms)——壳用它对本地时钟校偏后再消费 expiresAtMs。 */
     serverNowMs?: number;
+    /**
+     * CC-08(0.71.0;core 7.19.0 #803,sdk 9.6.0 `TOOL_APPROVAL_FRAME_KEYS` 第 30 员):**根外读卡附读根候选**。
+     * 在场 = 这只 ask 是「读了 trackedCwd 之外的目录」那一形,且引擎给出一个「把 `dir` 加为本会话读目录」的
+     * 候选动作;`clearsThisAsk: true` 是穷举表恰一臂(第二成员域 = {true})。
+     * 🔴 只按在场渲,`dir` 原样回传、显完整 dir(不截、不归一);缺席 = 今日行为(非根外读,或引擎早于 7.19.0)。
+     */
+    readRootCandidate?: {
+        dir: string;
+        clearsThisAsk: true;
+    };
 }
 /** {@link ToolApprovalFrame.delegation} 的形(命名形,不用内联匿名 —— typeshape 门 B4 棘轮口径)。 */
 export interface ToolApprovalDelegation {
@@ -1101,7 +1111,7 @@ export interface ToolApprovalDelegation {
  * `TOOL_APPROVAL_FRAME_KEYS` 比对——SDK additive 增键时对账当天红,不再人肉追平。
  * 下面两个类型钉保证镜像与 interface 本身不可能漂移(少键/多键都是编译错)。
  */
-export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "ruleStoreUnreadable", "origin", "inputHasBidi", "parked", "persistedRuleShadowed", "probeCause", "ruleEvidence", "requiresRealApproval", "expiresInMs", "expiresAtMs", "serverNowMs", "delegation", "outcome"];
+export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "ruleStoreUnreadable", "readRootCandidate", "origin", "inputHasBidi", "parked", "persistedRuleShadowed", "probeCause", "ruleEvidence", "requiresRealApproval", "expiresInMs", "expiresAtMs", "serverNowMs", "delegation", "outcome"];
 /**
  * 子代帧判别:显式键 fromSubagent(core 1.378 RB-39②)优先;缺席退 sourceTaskId 在场性权宜式
  * (server 1.258 [1549]①3,旧代际兼容)。

package/dist/hitl/toolApprovalWire.js

@@ -569,6 +569,8 @@ export const TOOL_APPROVAL_FRAME_KEYS_MIRROR = [
     // ⚠️ 与 `persistedRuleShadowed`/`probeCause` 同形:sdk 8.8.0 的运行期锚**尚无**本键 ⇒ **领先**一代,
     // 进对账门的 AHEAD_OF_ANCHOR 带退出条件登记(sdk 8.9.x 补上那天那条登记自红逼删,回到逐元素相等)。
     'ruleStoreUnreadable',
+    // CC-08(0.71.0):core 7.19.0 #803 根外读卡附读根候选;sdk 9.6.0 锚第 30 员。
+    'readRootCandidate',
     // S-125③/#564(client-core 0.59.0):server 7.57.0 起真发 `origin`(core 7.5.0 `ASK_ORIGINS`
     // 八词;engine 7.60.0 fixture 直证)。同上:sdk 8.3.0 锚已含本键 ⇒ 追平,不进领先表。
     'origin',