@sema-agent/client-core 0.70.1 → 0.70.2

package/CHANGELOG.md

@@ -49,6 +49,18 @@
 > 挡住 ⇒ 本批把它机械化——④a0 对 `pending` 行**要求段头已是日期形**(`(未发布)` 直接红),阶段一
 > commit 漏转在发布前就红,不再靠人记。
 
+## 0.70.2(2026-09-16)
+
+> 主题:**CC-18 `agents[].skills` 两条孪生帽退役** —— 0.70.0 那批(`SKILL_CAPS` 三键)的**同形存量**,同轴的这两条当时漏扫。接入面 §41。
+
+### Fixed
+
+- 🔴 **CC-18 `agents[].skills` 不再被条数帽与名字长度帽静默削掉**(接入方实撞)。`src/agentsWireCaps.ts` 两处:
+  - **条数帽**:`joined.slice(0, MAX_AGENT_SKILLS)` 在第 10 条处截 + 一行运维 warn ⇒ 声明 11 个以上技能的 agent **静默丢技能**,用户看到的只是「我声明的第 11 个技能没生效」。server 7.78.1 的 `agents[].skills` 臂已删 `v.length <= MAX_AGENT_SKILLS`(7.78.0 及以前仍有),改按字节预算渲染清单。
+  - **名字长度帽**:join 时要求 `spec.name.length <= MAX_AGENT_NAME_CHARS`,名字超 64 的技能被滤掉后落进 `missing`,再被措辞说成「not found in the loaded skill set」—— 它明明加载了,那句话是假的。server `skillOk` 里 name 只判非空。
+  🔴 **射程止于这两条**:`MAX_AGENT_NAME_CHARS` 管的是 **agent 自己的名字**(server 仍逐字判非空且 ≤64,超了整请求 400),`MAX_AGENT_SKILL_CONTENT_CHARS`(1MB)server `skillOk` 至今仍判 —— 两条都**不退**,退了就是把响亮的 400 换成静默通过。
+  `MAX_AGENT_SKILLS` 常量本身**已退役但保留导出**(不再被任何投影读),只为本版不破型面,随下一个 minor 删。判据:pure 门 CC-18a–e 五格(含两条反向自证:真没加载的仍 warn 并剪、content 超 1MB 仍剪);变异三发(条数帽回来 / 名字滤回来 / content 帽也退)各红。
+
 ## 0.70.1(2026-09-16)
 
 > 主题:**CC-17 推理/文本面安全修复** —— `handOffOnly` 形(段跨包侧边界 ∧ 已提交前缀自身过期)同步两本补差账 + 清未提交尾段。接入面 §40。

package/README.md

@@ -35,7 +35,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.70.1
+**Version:** 0.70.2
 
 - **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/agentsWireCaps.d.ts

@@ -5,6 +5,12 @@ 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;

package/dist/agentsWireCaps.js

@@ -16,6 +16,12 @@ 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;
 export const MAX_AGENT_SKILL_CONTENT_CHARS = 1_048_576;
 export const MAX_AGENT_MAX_TURNS = 1_000;
@@ -118,10 +124,10 @@ export function projectAgentsForWire(defs, deps) {
                 if (typeof skillName !== 'string' || skillName.length === 0)
                     continue;
                 const spec = byName.get(skillName.toLowerCase());
-                if (spec &&
-                    spec.name.length <= MAX_AGENT_NAME_CHARS &&
-                    spec.content.length > 0 &&
-                    spec.content.length <= MAX_AGENT_SKILL_CONTENT_CHARS) {
+                // 🔴 CC-18(0.70.2):**不再按名字长度滤**(server `skillOk` 里 name 只判非空)。修前名字超 64 的
+                //    技能会落进下面的 `missing`,再被措辞说成「not found in the loaded skill set」—— 它明明加载了,
+                //    那句话是假的。`content` 两条判**保留**:server `skillOk` 至今逐字判非空且 ≤1MB(超了整请求 400)。
+                if (spec && spec.content.length > 0 && spec.content.length <= MAX_AGENT_SKILL_CONTENT_CHARS) {
                     joined.push(spec);
                 }
                 else {
@@ -131,11 +137,11 @@ export function projectAgentsForWire(defs, deps) {
             if (missing.length > 0) {
                 warnings.push(`agents wire: agent "${name}" skills not found in the loaded skill set (dropped): ${missing.join(', ')}`);
             }
-            if (joined.length > MAX_AGENT_SKILLS) {
-                warnings.push(`agents wire: agent "${name}" skills truncated to ${MAX_AGENT_SKILLS}`);
-            }
+            // 🔴 CC-18(0.70.2):**零条数帽**,join 上几条发几条(server 7.78.1 的 skills 臂已无
+            //    `v.length <= MAX_AGENT_SKILLS`)。修前在第 10 条处 `slice` + warn —— warn 落在运维日志里,
+            //    用户看到的只是「我声明的第 11 个技能没生效」,没有任何一层会响。
             if (joined.length > 0)
-                item.skills = joined.slice(0, MAX_AGENT_SKILLS);
+                item.skills = joined;
         }
         if (typeof def.background === 'boolean')
             item.background = def.background;

package/dist/mcpPanel.d.ts

@@ -13,6 +13,11 @@
  *  · `lastLegMcp` **整键缺席** = server 的三形同形(新会话 / 最近腿的账本行在保留窗外 / 该腿没推
  *    `wiring_manifest`)**或**引擎早于 7.77.0;本视图同样不铸该键。「为什么缺席」这一位答不出来,
  *    也不猜。
+ *    🔒 **定谳(0.70.1,三方闭环):这三形永远不会长出缺席原因伴生键**,本读器也不留位。理由 ①
+ *    后两形在上游是同一条代码路径(走完事件表就是没有那一帧),分不出是保留窗剪的还是压根没推,
+ *    启发式 = 把猜测穿成事实;② 该读面的属主门那一臂必须与其余缺席**同形**(非属主读别人的会话
+ *    时本键缺席、面板照常 200,反枚举),一旦带原因键,「不存在的会话答 no_leg、别人的会话不答」
+ *    就是一个**会话存在性 oracle** —— 可分辨性在这里让位给反枚举。⇒ 缺席只有一句话可说,不编第三句。
  *  · `lastLegMcp` **在场但形坏**(`runId` / `at` 不是非空串、`mcp` 读不出一行)⇒ 视图不铸该键,
  *    改立 {@link McpPanelView.lastLegMcpUnreadable}(never false)。「引擎送了一份我读不懂的」与
  *    「引擎没送」对运维是两句话,不折成一个 `undefined`。

package/docs/INTEGRATION-CLIENTS.md

@@ -19,7 +19,7 @@
 
 | 项 | 值 | 真源 |
 |---|---|---|
-| 本包 | `@sema-agent/client-core` **0.70.1**(本批发布版 = patch,零型面变化:🔴 CC-17 `handOffOnly` 形(段跨包侧边界 ∧ 已提交前缀自身过期)同步两本补差账 + 清未提交尾段 —— 修前形一卡后原始未脱敏尾段照常上屏落盘、形二 `result` 臂把它当缺的后缀补吐;账对不上(前缀跨多条消息)则退回既有行为;§40 / 40y 两条)|
+| 本包 | `@sema-agent/client-core` **0.70.2**(本批发布版 = patch,零型面变化:🔴 CC-18 `agents[].skills` 两条孪生帽退役 —— 条数帽(修前 11+ 技能的 agent 静默丢技能)与技能名字长度过滤(修前长名技能被误报「未加载」);射程止于这两条,agent 自己的名字帽与 skill content 帽上游仍判故不退;`MAX_AGENT_SKILLS` 常量退役但保留导出,随下一个 minor 删;§41 / 41y 两条)|
 | peer:wire 契约 | `@sema-agent/sdk` **>=8.4.0**(value-level,非 type-only;**0.60.0 抬版**,四条硬理由见 §24a 与 `scripts/run-sdk-floor-test.mjs` 的 `FLOOR` 注;上一次是 0.59.0 的 `>=8.3.0`)。🔴 支持窗同批收到 **engine ≥7.64.0**:sdk 8.4.0 与 7.63.0 及以前的 wire **不同窗** | `package.json` `peerDependencies` |
 | peer:会话词汇表 | `@sema-agent/agent-types` **>=0.2.0**(type-only,零运行时) | 同上 |
 | runtime dep | `diff` ^9.0.0(**唯一**一条;portability 门按**等值**钉死) | `package.json` `dependencies` |
@@ -7772,6 +7772,10 @@ const line = mcpPanelLastLegDetail(view, { reachable })  // 一行措辞唯一
 | `servers[]` 行 | `name` + `status` 必需(`status` **按开集读**);`serverInfo` / `toolNames` / `error` 逐键挑,形坏只丢该键 | 坏行只丢自己;`[]` = 一台都没配(正面事实) |
 | `degraded` | `true`(never false)= materialize 超时/失败,`servers` 空但**不是**「没有 MCP」 | 正常 materialize |
 | `lastLegMcp` | `{ runId, at, mcp[] }`;`mcp[]` 与 `wiring_manifest` 第三段**同一只读器**(`projectMcpSection`,同形同缺席律) | server 三形同形(新会话 / 最近腿账本行在保留窗外 / 该腿没推 manifest)**或**引擎 <7.77.0 —— 视图不铸键,「为什么缺席」不猜 |
+
+🔒 **定谳(0.70.1;三方闭环):`lastLegMcp` 的三形同形**(新会话 / 最近腿账本行在保留窗外 / 该腿没推 manifest)**不是包侧缺口,永远不会长出缺席原因伴生键** —— 消费端可以照此设计,不必给原因键留位。两条硬理由:① 后两形在 server 是**同一条代码路径**(走完事件表就是没有那一帧),分不出「被保留窗剪掉」还是「压根没推」;能凑的启发式是把猜测穿成事实,与本包「不知道绝不渲成 0」同一条纪律。② 该读面的**属主门那一臂必须与其余缺席同形**(非属主读别人的会话时本键缺席、面板照常 200,反枚举);一旦有原因键,「不存在的会话答 `no_leg`、别人的会话不答」就是一个**会话存在性 oracle** ⇒ 可分辨性在这里必须让位给反枚举。
+⇒ 端渲这一格只有两句话可说:`lastLegMcp` 在场就照它渲,整键缺席就一句「不报」(`mcpPanelLastLegDetail` 的五句之一),**不编第三句**。上游对照:server 契约 B.2c-bis 第 3 条 + `lastLegMcpFor` 头注同批钉住。「这条会话跑过腿没有」属 **runs 面**、不属本面板,上游愿在真实用户困惑出现后评估做成 runs 面读法,届时本包认领投影。
+
 | `lastLegMcpUnreadable` | `true`(never false)= server 送了 `lastLegMcp` 但本视图读不出(`runId`/`at` 非非空串、`mcp` 读不出一行、值是 null) | 缺席 = 没这回事 |
 
 🔴 **两面合法可不同**(契约 G.7 ④;server 判据 LL-2):`servers[].name` 与 `lastLegMcp.mcp[].name` 是两张表(部署缺省场景 vs 按请求注入的名册),视图上**没有**任何「一致/不一致」位,五句措辞没有一句提到 `servers`。端渲并排两块,不对账。
@@ -8045,3 +8049,31 @@ installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolic
 2. **多行跨界段仍按老规矩**:一个 `segmentId` 对上多行时端照旧整发放弃(包这一版不单方面清);整段归属交全在下一版(`text_segment_end.committedUuids[]`)。
 
 **包侧缺口:** ① 多行跨界形候 `committedUuids[]`(下一版);② 其余同 §39 包侧缺口。
+
+## §41 🆕 0.70.2 安全修复(CC-18:`agents[].skills` 两条孪生帽退役)
+
+### 41a. 本节速览
+
+| 件 | 一句话 | 端要做什么 |
+|---|---|---|
+| S-1 🔴 | **`agents[].skills` 零条数帽**:`projectAgentsForWire` 不再在第 10 条处截 —— 修前声明 11+ 技能的 agent **静默丢技能**(只有一行运维 warn) | 为这一条自建的壳侧规避(先自己截到 10、或把 agent 拆成多个)**可退役**;端不要复刻条数帽 |
+| S-2 🔴 | **不再按技能名字长度滤**:名字超 64 的技能修前被滤进 `missing`,措辞说成「not found in the loaded skill set」= 假事实 | 读 `missing` 那条 warning 的端:它现在只含**真没加载**的名字,可以照字面信 |
+| S-3 | **射程止于这两条**:`MAX_AGENT_NAME_CHARS`(agent 自己的名字 ≤64)与 `MAX_AGENT_SKILL_CONTENT_CHARS`(1MB)上游仍判,**不退** | 零动作;别顺手把这两条也退了 —— 退了就是把响亮的 400 换成静默通过 |
+| S-4 | `MAX_AGENT_SKILLS` 常量**已退役但保留导出**(不再被任何投影读) | 读它的端改不读;常量随下一个 minor 删(型面 BREAKING,单独一版) |
+
+### 41z. 逐键处置表(0.70.2)
+
+| # | 键 / 面 | 处置 | 坐标 / 理由 |
+|---|---|---|---|
+| 1 | `agents[].skills` 条数帽 | **retired(行为)** | `src/agentsWireCaps.ts` 的 `#projectAgentsForWire`;server 7.78.1 `spec-fields.js` 的 `skills` 臂已删该判 |
+| 2 | `agents[].skills[].name` 长度过滤 | **retired(行为)** | 同上;server `skillOk` 里 name 只判非空 |
+| 3 | `MAX_AGENT_NAME_CHARS`(agent 自己的名字) | **不退** | server `spec-fields.js` 的 `name` 臂仍判非空且 ≤64 |
+| 4 | `MAX_AGENT_SKILL_CONTENT_CHARS`(1MB) | **不退** | server `skillOk` 仍判;超了整请求 400 |
+| 5 | `MAX_AGENT_SKILLS` 常量导出 | **deprecated(保留一版)** | 零读点;删它 = 型面 BREAKING,随下一个 minor |
+
+### 41y. 🔴 三端升级必读(固定段式,[C295];本批**两条**)
+
+1. 🔴 **别在端里复刻技能条数帽**:`agents[].skills` 上游已无条数帽,包侧也退了;为这一条自建的规避(自己先截到 10、把 agent 拆成多个)可退役。
+2. **`missing` 那条 warning 现在可以照字面信**:它只含真没加载的技能名;修前名字超 64 的已加载技能也在里面。
+
+**包侧缺口:** ① `MAX_AGENT_SKILLS` 常量删除随下一个 minor;② 其余同 §40。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.70.1",
+  "version": "0.70.2",
   "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",