@sema-agent/client-core 0.71.0 → 0.71.1

package/CHANGELOG.md

@@ -49,6 +49,14 @@
 > 挡住 ⇒ 本批把它机械化——④a0 对 `pending` 行**要求段头已是日期形**(`(未发布)` 直接红),阶段一
 > commit 漏转在发布前就红,不再靠人记。
 
+## 0.71.1(2026-09-17)
+
+> 主题:接入文档打回一条(接入方 1.0.117 实测):`readRootCandidate` 帧→卡透传位。**patch**:型面纯 additive(`ApprovalCardRequest.readRootCandidate?` + 新导出型 `ReadRootCandidateView`;窄读器不出公面),运行期零 BREAKING;公面 986 不变。接入面 §43。
+
+### Fixed
+
+- 🔴 **CC-27 `ApprovalCardRequest.readRootCandidate?: ReadRootCandidateView`(帧 → 卡原样透传)**:0.71.0 只把 `readRootCandidate` 镜像进 `TOOL_APPROVAL_FRAME_KEYS_MIRROR`(键名对账),卡入参零该位、零投影口写进卡视图,而 §42 S-8「端要做什么」列与 §42y ④ 写「审批卡在场渲一格 add-dir」—— 端侧结构上做不到,文档与 dist 不符(接入方按接入文档宪法打回)。修后 live 帧腿窄读:`dir` 非空串 ∧ `clearsThisAsk === true` ⇒ 新铸两键形上卡(`dir` 逐字不加工、多余成员不过境);缺席 / 坏形 ⇒ 键不置(不铸空对象、不折 false)。durable `ApprovalCard` 无此位(sdk `APPROVAL_CARD_KEYS` 两版相同),回放腿缺席。§42 S-8 / §42y ④ 订正为「0.71.0 = 只镜像键名,卡零该位;0.71.1 起卡上可读」。pure 门 CC-27a–d(在场原样 / 缺席不铸 / 六种坏形不置 / 多余键不过境且非原对象引用),红先绿后;变异「窄读器返回原对象」⇒ CC-27d 红。
+
 ## 0.71.0(2026-09-16)
 
 > 主题:**core 7.20.0 提货**(闭集 +5 = 六十四码 / `requestedBudgetBytes` 删 ⇒ `laneClamped` 整只退役)+ CC-08 提货批(sdk 9.6.0)+ CC-16 + `MAX_AGENT_SKILLS` 常量删。**minor**:型面 BREAKING = `SkillsListingTruncatedFactsView` 删两键 + `MAX_AGENT_SKILLS` 删。接入面 §42。

package/README.md

@@ -35,7 +35,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.71.0
+**Version:** 0.71.1
 
 - **Today** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
   B/D/E tool-card layers), the notification/caps/model families, the adapter kernel (stream driver

package/dist/hitl/toolApprovalWire.d.ts

@@ -641,6 +641,12 @@ export interface ApprovalCardRequest {
      * **行为面**改动(会改到人已按下的决断的字节),按宪法三问单独立项,不在本过境批内。
      */
     requiresRealApproval?: true;
+    /**
+     * CC-27(0.71.1;cli 1.0.117 接入档打回):根外读 ask 附的读根候选,帧 → 卡**原样透传**(live 帧腿;durable
+     * `ApprovalCard` 无此位,回放腿缺席)。在场 = 卡上渲一格「把 `dir` 加为本会话读目录」动作,`dir` 原样回传显完整;
+     * 缺席 = 今日行为(非根外读 / 引擎早于 7.19.0)。0.71.0 只镜像了帧键名、卡零该位,文档曾说反 —— §42 S-8 已订正。
+     */
+    readRootCandidate?: ReadRootCandidateView;
     /** [4851]:窗三键透传(server ≥7.34;壳 readAskDeadlineMs 消费渲倒计时)。只在
      *  `windowIsCurrent === true` 的 live 腿上过境(重放腿=旧余量,续窗即假倒计时);**全部**缺席
      *  =该帧无窗不渲,半套在场读器按「expiresAtMs 优先、expiresInMs 兜底」回落。 */
@@ -1092,10 +1098,15 @@ export interface ToolApprovalFrame {
      * 候选动作;`clearsThisAsk: true` 是穷举表恰一臂(第二成员域 = {true})。
      * 🔴 只按在场渲,`dir` 原样回传、显完整 dir(不截、不归一);缺席 = 今日行为(非根外读,或引擎早于 7.19.0)。
      */
-    readRootCandidate?: {
-        dir: string;
-        clearsThisAsk: true;
-    };
+    readRootCandidate?: ReadRootCandidateView;
+}
+/**
+ * 根外读 ask 附的「把 `dir` 加为本会话读目录」候选(core 7.19.0 #803;sdk 9.6.0 帧键第 30 员)。
+ * 穷举表恰一臂:`clearsThisAsk` 域 = {true}。`dir` 原样(不截、不归一);两键形之外的成员不过境。
+ */
+export interface ReadRootCandidateView {
+    dir: string;
+    clearsThisAsk: true;
 }
 /** {@link ToolApprovalFrame.delegation} 的形(命名形,不用内联匿名 —— typeshape 门 B4 棘轮口径)。 */
 export interface ToolApprovalDelegation {

package/dist/hitl/toolApprovalWire.js

@@ -522,6 +522,15 @@ parkGatedCallId) {
             }
     }
 }
+/** 帧上 `readRootCandidate` 的窄读(模块内部,不出公面):在场且形对 ⇒ 新铸两键形;缺席 / 坏形 ⇒ undefined(键不置)。 */
+function readReadRootCandidate(v) {
+    if (typeof v !== 'object' || v === null)
+        return undefined;
+    const o = v;
+    if (typeof o.dir !== 'string' || o.dir.length === 0 || o.clearsThisAsk !== true)
+        return undefined;
+    return { dir: o.dir, clearsThisAsk: true };
+}
 /**
  * 本地值拷贝的**运行时键集镜像**([1950]② 建议形):对账测试拿它与 SDK 0.1.6+ 的同源锚
  * `TOOL_APPROVAL_FRAME_KEYS` 比对——SDK additive 增键时对账当天红,不再人肉追平。
@@ -1426,6 +1435,8 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
         // 「这不是一次安全类 ask」,把它折成显式 false 会让宿主把「没有证据」读成「已确认可自动放行」,
         // 而本键存在的全部理由正是在这种门上把自动放行(记住的规则 / allow_session / bypass 姿态)拦下。
         ...(frame.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
+        // CC-27(0.71.1):读根候选透传 —— 窄读器铸新两键形(dir 非空串 ∧ clearsThisAsk === true),坏形/缺席 ⇒ 键不置。
+        ...(() => { const rc = readReadRootCandidate(frame.readRootCandidate); return rc !== undefined ? { readRootCandidate: rc } : {}; })(),
         // #341/[5214]③(0.43.0):bidi 披露位透传。条件 stamp **只认严格 true**,与 governanceForced /
         // requiresRealApproval 同一条纪律 —— 缺席同时覆盖「真的没有」与「扫不了」,折成显式 false 会把
         // 「没扫到」渲成「已确认干净」,而这一位存在的全部理由就是「人眼读到的顺序 ≠ 真跑的字节顺序」。

package/docs/INTEGRATION-CLIENTS.md

@@ -19,7 +19,7 @@
 
 | 项 | 值 | 真源 |
 |---|---|---|
-| 本包 | `@sema-agent/client-core` **0.71.0**(本批发布版 = **minor**:型面 BREAKING 六件 —— peer sdk 地板 >=9.6.0 + agent-types >=0.3.0 / `SkillsListingTruncatedFactsView` 删 `requestedBudgetBytes?`·`laneClamped?` / `WiringManifestMcpEntry` → `WiringManifestMcpEntryView` / `MAX_AGENT_SKILLS` 删 / `decide.workflow_host_not_parked` 退役;运行期零 BREAKING。内容:core 7.20.0 提货(闭集 +5 六十四码)/ 🔴 CC-16 `text_segment_end.committedUuids[]` / CC-08 全五件(tool_disclosure / tool_progress 两 chrome 臂、wiring_manifest tools·hooks·lsp 进切片、tool_roster_delta 接上、context_usage 进切片、`readRootCandidate` 镜像)/ CC-19 `mcpEngineLegPresence` 归包 / CC-20 not_parked clean-cut;公面 986;§42 / 42y 八条)|
+| 本包 | `@sema-agent/client-core` **0.71.1**(本批发布版 = **patch**:接入档打回修正 —— CC-27 `ApprovalCardRequest.readRootCandidate?` 帧→卡透传位 + 新导出型 `ReadRootCandidateView`;型面纯 additive、公面 986 不变、peer 不动;§43。上一版 0.71.0 = **minor**:型面 BREAKING 六件 —— peer sdk 地板 >=9.6.0 + agent-types >=0.3.0 / `SkillsListingTruncatedFactsView` 删 `requestedBudgetBytes?`·`laneClamped?` / `WiringManifestMcpEntry` → `WiringManifestMcpEntryView` / `MAX_AGENT_SKILLS` 删 / `decide.workflow_host_not_parked` 退役;运行期零 BREAKING。内容:core 7.20.0 提货(闭集 +5 六十四码)/ 🔴 CC-16 `text_segment_end.committedUuids[]` / CC-08 全五件(tool_disclosure / tool_progress 两 chrome 臂、wiring_manifest tools·hooks·lsp 进切片、tool_roster_delta 接上、context_usage 进切片、`readRootCandidate` 镜像)/ CC-19 `mcpEngineLegPresence` 归包 / CC-20 not_parked clean-cut;公面 986;§42 / 42y 八条)|
 | peer:wire 契约 | `@sema-agent/sdk` **>=9.6.0**(value-level,非 type-only;**0.71.0 抬版**:`tool_disclosure` / `tool_progress` 两帧型与 `ToolApprovalFrame.readRootCandidate` 自 9.6.0 起;0.69.0 曾抬到 >=9.4.0(`reasoning_end` / `lastLegMcp`),0.60.0 抬到 >=8.4.0;地板由 `scripts/run-sdk-floor-test.mjs` 的 `FLOOR` 与 public-surface 门 C-CC-3「不低于见证到的最低实装版」双钉)| `package.json` `peerDependencies` |
 | peer:会话词汇表 | `@sema-agent/agent-types` **>=0.3.0**(type-only,零运行时;0.71.0 抬版:devDep 与 peer 同步,type-superset 门 ④ 撞名预警对着 0.3.0 的 .d.ts 求值) | 同上 |
 | runtime dep | `diff` ^9.0.0(**唯一**一条;portability 门按**等值**钉死) | `package.json` `dependencies` |
@@ -8098,7 +8098,7 @@ installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolic
 | S-15 🔴 **子流面** | **`wiring_manifest` 三键子流断闸 + 身份透传**:投影口透 `parentToolCallId` / `sourceTaskId` / `bgAgentId`(在场非串 ⇒ `malformed`),臂按三键任一在场断闸(修前只判 `parentToolCallId`) | 端零动作;此前若在壳侧按 `sourceTaskId` 自滤子代 `wiring_manifest` 的可删(包已断闸,leader 面只见 leader 快照) |
 | S-16 🔴 **子流面** | **三键身份空串透传**:五臂共用读器三键在场即抄(含 `''`),与 `text_end` 投影和 `isSubFlowSegmentEnd`「键在场 = 子代帧」同律;`eventId` 非空才带 | 端零动作;别把 `sourceTaskId === ''` 读成主流 |
 | S-13 | **CC-19 `mcpEngineLegPresence(view)`**(cli L-335 归包):引擎侧 MCP 在场三值 `present` / `absent` / `unknown`,只从 `projectMcpPanel` 视图求 | 壳侧自算的 presence 删改调;🔴 `unknown`(视图读不出)不许渲成「一台 MCP 都没配」,有引擎接线的端开面板让「未观测」句说话;CC 那句只在壳侧零行 ∧ `absent` 时出 |
-| S-8 | **`ToolApprovalFrame.readRootCandidate?`**(#803):在场 = 根外读 ask 附「把 `dir` 加为本会话读目录」候选,`clearsThisAsk: true` | 审批卡按在场渲一格「add-dir」动作,`dir` 原样回传显完整;缺席 = 今日行为 |
+| S-8 | **`ToolApprovalFrame.readRootCandidate?`**(#803):在场 = 根外读 ask 附「把 `dir` 加为本会话读目录」候选,`clearsThisAsk: true` | 🔧 **0.71.1 订正(接入方 1.0.117 打回)**:0.71.0 只把键名镜像进 `TOOL_APPROVAL_FRAME_KEYS_MIRROR`,**卡入参零该位** ⇒ 本版端渲不到,处置登 n/a;**0.71.1 起** `ApprovalCardRequest.readRootCandidate?` 在场渲一格「add-dir」动作,`dir` 原样回传显完整;缺席 = 今日行为(§43) |
 | S-4 🔴 **安全面** | **CC-16 `text_segment_end.committedUuids[]`**:本段身份窗口里段边界**之前**已提交的文本行 uuid 按序(`[]` = 零行在场但空;整键缺席 = 零经手形 f)+ `committedUuid` 末条兼容位;常态段定稿行在轮换之后提交 ⇒ 不在列 | **端义务改口**:`committedPrefixDiverged` ⇒ 按 `committedRows[]` **逐行写回**(包已算好:首行 = 前段定稿前缀 + `content`、其余行 `''`;🔴 别整行换首行 —— 提交行可能是「上一段定稿 + 本段那截」一条,整行换会删上一段权威正文;多行跨界时包同批清掉本段未提交的原始尾巴、补差账按写回后的屏同步,端写回后转录 = 权威正文恰一次);删自建的「本窗口过境行」跟踪与 `=== 1` 歧义闸;多行跨界段不再整发放弃 |
 
 ### 42z. 逐键处置表(0.71.0,core 半场)
@@ -8130,7 +8130,7 @@ installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolic
 1. 🔴 **`text_segment_end` 归属交全(CC-16)**:`committedUuids[]` 在场即以它为准 —— `committedPrefixDiverged` ⇒ 按 `committedRows[]` 逐行写回正文(🔴 别自己整行换首行)。两形:**(a)** 提交行 = 「上一段定稿 + 本段那截」同一行时,该行最终正文 = 上一段正文(该行里已封存那截,逐字)+ 本段权威 `content`,其余行 `''`;**(b)** `committedRows` 在场 ⇔ `committedPrefixDiverged === true` ∧ `committedUuids.length > 0`,在场时与 `committedUuids` 长度相等、顺序一一对应(`committedRows[i].uuid === committedUuids[i]`),绝不只给其一;b1 形(前缀对得上)只有 `committedUuids`;`[]` = 本窗口零已提交行;整键缺席才是「包说不出」。自建的「本窗口过境行」跟踪与 `=== 1` 歧义闸可删,多行跨界段不再整发放弃。
 2. **`SkillsListingTruncatedFactsView` 删 `requestedBudgetBytes?` / `laneClamped?`**:运维面只读 `budgetBytes`。
 3. **peer sdk `>=9.6.0`**;两条新 chrome 臂 `tool_disclosure` / `tool_progress` 均 `required: false`,渲的端接、不渲零动作;🔴 `tool_progress.output` 绝不回喂模型。
-4. **审批卡 `readRootCandidate`**:在场渲一格 add-dir 动作,`dir` 原样回传;缺席不渲。
+4. **审批卡 `readRootCandidate`**:🔧 0.71.1 订正 —— 本版(0.71.0)卡入参**零该位**(只镜像了帧键名),端登 n/a 不渲;0.71.1 起按 `ApprovalCardRequest.readRootCandidate?` 在场渲一格 add-dir,`dir` 原样回传,缺席不渲(§43)。
 5. 🔴 **两个型面改名/删除**:`WiringManifestMcpEntry` → `WiringManifestMcpEntryView`(两边都 import 的端改名);`MAX_AGENT_SKILLS` 删(仍 import 的端删)。
 6. **名册增量与上下文用量**:`tool_roster_delta` 喂 `applyToolRosterDelta`(digest 对不上整只替换、重连按快照重同步);`context_usage` 按最后一条取值,`sections[].tokens` 与 `usedTokens` 禁相减。
 7. **引擎侧 MCP 在场改读 `mcpEngineLegPresence(view)`**:壳侧自算的三值删;`unknown` 开面板不渲零。
@@ -8138,3 +8138,28 @@ installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolic
 9. **子流断闸补齐**:`wiring_manifest` 三键断闸 + 五臂三键空串透传(S-15 / S-16);壳侧对这些臂自建的 `sourceTaskId` 过滤可删。
 
 **包侧缺口:** ① `agents.listing_truncated` detail 读器候消费场景(by-design:无消费方不出读器);② `ClassifierSeat.defaulted?` 候 sdk 出键(by-design:上游未出);③ CC-06 B-081 包侧半场(窗 09-22);④ CC-24 export-liveness 门(窗 09-20);⑤ CC-25 §NNz 机读门 + 三已发版本落点 + FROZEN 腿判据(窗 09-22);⑥ CC-26 `as unknown as` 铸出口棘轮(窗 09-22)。
+
+## §43 🆕 0.71.1 接入档打回修正(`readRootCandidate` 帧 → 卡透传;接入方 1.0.117 实测打回)
+
+> **patch**:型面纯 additive;运行期零 BREAKING;peer 不动。只修一件:0.71.0 的 §42 S-8 / §42y ④ 说「审批卡在场渲一格 add-dir」,而 dist 里 `readRootCandidate` 唯一运行期命中是 `TOOL_APPROVAL_FRAME_KEYS_MIRROR` 的键名镜像,`ApprovalCardRequest` 零该位 —— 端侧结构上做不到(接入文档宪法:文档报错直接打回)。
+
+### 43a. 处置表
+
+| # | 面 | 本包做了什么 | 端要做什么 |
+|---|---|---|---|
+| S-1 | **`ApprovalCardRequest.readRootCandidate?: ReadRootCandidateView`**(`{ dir: string; clearsThisAsk: true }`) | live 帧腿窄读上卡:`dir` 非空串 ∧ `clearsThisAsk === true` ⇒ 新铸两键形(`dir` 逐字不加工、多余成员不过境);缺席 / 坏形 ⇒ 键不置。新导出型 `ReadRootCandidateView`(窄读器不出公面) | 审批卡在场渲一格「把 `dir` 加为本会话读目录」动作,`dir` 原样回传显完整(不截不归一);缺席不渲(= 非根外读 / 引擎早于 7.19.0)。🔴 durable `ApprovalCard` 无此位(sdk `APPROVAL_CARD_KEYS` 两版相同),回放腿缺席是常态,别当坏形 |
+
+### 43z. 逐键处置表
+
+| # | 键 / 面 | 处置 | 坐标 / 理由 |
+|---|---|---|---|
+| 1 | `ToolApprovalFrame.readRootCandidate?` → 卡 | **consumed(卡透传位;0.71.0 只 consumed 到键名镜像)** | `src/hitl/toolApprovalWire.ts` 的 `#ApprovalCardRequest`(窄读器 `readReadRootCandidate` 模块内部);pure 门 CC-27a–d |
+| 2 | [7341] ① 三条读法约束(只按在场渲 / `dir` 原样 / 缺席 = 今日行为) | **原样留票** | 端侧 L-332;本包卡口不改写 `dir` |
+
+### 43y. 🔴 三端升级必读(固定段式,[C295])
+
+1. **审批卡读 `req.readRootCandidate`**:在场渲一格 add-dir 动作,`dir` 原样回传;缺席不渲。0.71.0 上按 n/a 处置的端换钉 0.71.1 后把 n/a 翻 consumed。
+2. **回放腿缺席是常态**:durable 卡无此位,别把缺席当坏形报。
+3. **零 BREAKING**:peer 不动、公面运行期导出 986 不变(只加一个导出型)。
+
+**包侧缺口:** ① CC-06 B-081 包侧半场(窗 09-22);② CC-24 export-liveness 门(窗 09-20);③ CC-25 §NNz 机读门 + 三已发版本落点 + FROZEN 腿判据(窗 09-22);④ CC-26 `as unknown as` 铸出口棘轮(窗 09-22);⑤ `agents.listing_truncated` detail 读器候消费场景(by-design);⑥ `ClassifierSeat.defaulted?` 候 sdk 出键(by-design)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.71.0",
+  "version": "0.71.1",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",