@sema-agent/client-core 0.14.0 → 0.16.0

package/dist/sandboxWire.d.ts

@@ -18,7 +18,18 @@ export type SandboxParseResult = {
  * `--sandbox=<v>` forms). No flag ⇒ `{mode:'default'}`. Repeated flag ⇒ LAST wins (commander convention).
  * Missing value / flag-shaped value / empty / over-long ⇒ fail-LOUD parse error (never a silent default —
  * a mis-typed environment choice must not quietly run on the wrong image).
- */
+ *
+ * 🔴 [2393] sweep-F10(2026-08-03 全窗复审)**承诺范围如实收窄**(裁定:行为不改,话改):
+ * 「fail-LOUD,never a silent default」这句话现在**不**覆盖一种输入 —— 同一个旗**重复出现**且
+ * 前一次缺值/非法、后一次合法(`--sandbox --sandbox foo`):
+ * 收编前是 per-occurrence eager validate,在**第一个**缺值 occurrence 上就 fail-loud;收编后走
+ * `lastFlagValue`('invalidate' 缺省)= 后一次合法 occurrence 覆盖前一次,整体接受。
+ * 为什么裁定不改回去:本模块自己写着的契约就是「Repeated flag ⇒ LAST wins(commander convention)」,
+ * eager-validate 违反的正是这条契约(它让**被覆盖掉的**那一次决定整条命令的成败)。
+ * 剩下的形(唯一一次出现却缺值 / 值是旗形 / 空 / 超长 / 带空白)**仍然全部 fail-loud** —— 那才是
+ * 「打错一个字就悄悄跑在别的镜像上」真正要防的那一族。
+ * ⚠️ `docs/REFACTOR-LEDGER.md` REF-CC-143 的处置列此前写的是「缺值策略**统一** fail-loud」,
+ * 与落地的两策略叶(`'invalidate'` / `'latch-previous'`)相悖,已同批改正(sweep-F11)。 */
 export declare function parseSandboxArgv(argv: readonly string[]): SandboxParseResult;
 /** The request-body stamp for a selection: EXPLICIT ⇒ `{sandboxImageProfile}`, default/auto ⇒ nothing
  *  (auto is advisory-by-prompt — the submit itself never carries a profile, per clay's c) 口径). */

package/dist/sandboxWire.js

@@ -37,7 +37,18 @@ const USAGE_HINT = "sema: --sandbox expects a profile name or 'auto'.\n" +
  * `--sandbox=<v>` forms). No flag ⇒ `{mode:'default'}`. Repeated flag ⇒ LAST wins (commander convention).
  * Missing value / flag-shaped value / empty / over-long ⇒ fail-LOUD parse error (never a silent default —
  * a mis-typed environment choice must not quietly run on the wrong image).
- */
+ *
+ * 🔴 [2393] sweep-F10(2026-08-03 全窗复审)**承诺范围如实收窄**(裁定:行为不改,话改):
+ * 「fail-LOUD,never a silent default」这句话现在**不**覆盖一种输入 —— 同一个旗**重复出现**且
+ * 前一次缺值/非法、后一次合法(`--sandbox --sandbox foo`):
+ * 收编前是 per-occurrence eager validate,在**第一个**缺值 occurrence 上就 fail-loud;收编后走
+ * `lastFlagValue`('invalidate' 缺省)= 后一次合法 occurrence 覆盖前一次,整体接受。
+ * 为什么裁定不改回去:本模块自己写着的契约就是「Repeated flag ⇒ LAST wins(commander convention)」,
+ * eager-validate 违反的正是这条契约(它让**被覆盖掉的**那一次决定整条命令的成败)。
+ * 剩下的形(唯一一次出现却缺值 / 值是旗形 / 空 / 超长 / 带空白)**仍然全部 fail-loud** —— 那才是
+ * 「打错一个字就悄悄跑在别的镜像上」真正要防的那一族。
+ * ⚠️ `docs/REFACTOR-LEDGER.md` REF-CC-143 的处置列此前写的是「缺值策略**统一** fail-loud」,
+ * 与落地的两策略叶(`'invalidate'` / `'latch-previous'`)相悖,已同批改正(sweep-F11)。 */
 export function parseSandboxArgv(argv) {
     // REF-CC-143(dup-07)收编:extraction 改吃共用 lastFlagValue(argvFlagValue.ts)——scan-all-then-
     // validate-once, matching this module's own documented "Repeated flag ⇒ LAST wins" contract (the

package/dist/scenarioWire.d.ts

@@ -46,7 +46,18 @@ export type ScenarioParseResult = {
  * flag ⇒ LAST wins (commander convention). Missing value / flag-shaped value / name-shape violation ⇒
  * fail-LOUD parse error (never a silent default — a mis-typed routing choice must not quietly run on
  * the wrong tool surface; same stance as `--sandbox`).
- */
+ *
+ * 🔴 [2393] sweep-F10(2026-08-03 全窗复审)**承诺范围如实收窄**(裁定:行为不改,话改):
+ * 「fail-LOUD,never a silent default」这句话现在**不**覆盖一种输入 —— 同一个旗**重复出现**且
+ * 前一次缺值/非法、后一次合法(`--scenario --scenario foo`):
+ * 收编前是 per-occurrence eager validate,在**第一个**缺值 occurrence 上就 fail-loud;收编后走
+ * `lastFlagValue`('invalidate' 缺省)= 后一次合法 occurrence 覆盖前一次,整体接受。
+ * 为什么裁定不改回去:本模块自己写着的契约就是「Repeated flag ⇒ LAST wins(commander convention)」,
+ * eager-validate 违反的正是这条契约(它让**被覆盖掉的**那一次决定整条命令的成败)。
+ * 剩下的形(唯一一次出现却缺值 / 值是旗形 / 空 / 超长 / 带空白)**仍然全部 fail-loud** —— 那才是
+ * 「打错一个字就悄悄跑在别的镜像上」真正要防的那一族。
+ * ⚠️ `docs/REFACTOR-LEDGER.md` REF-CC-143 的处置列此前写的是「缺值策略**统一** fail-loud」,
+ * 与落地的两策略叶(`'invalidate'` / `'latch-previous'`)相悖,已同批改正(sweep-F11)。 */
 export declare function parseScenarioArgv(argv: readonly string[]): ScenarioParseResult;
 /**
  * The settings-lane default (`SEMA_HEADLESS_SCENARIO`). FAIL-SOFT on a bad value (stderr warning +

package/dist/scenarioWire.js

@@ -44,7 +44,18 @@ const USAGE_HINT = "sema: --scenario expects a scenario name (lowercase letters/
  * flag ⇒ LAST wins (commander convention). Missing value / flag-shaped value / name-shape violation ⇒
  * fail-LOUD parse error (never a silent default — a mis-typed routing choice must not quietly run on
  * the wrong tool surface; same stance as `--sandbox`).
- */
+ *
+ * 🔴 [2393] sweep-F10(2026-08-03 全窗复审)**承诺范围如实收窄**(裁定:行为不改,话改):
+ * 「fail-LOUD,never a silent default」这句话现在**不**覆盖一种输入 —— 同一个旗**重复出现**且
+ * 前一次缺值/非法、后一次合法(`--scenario --scenario foo`):
+ * 收编前是 per-occurrence eager validate,在**第一个**缺值 occurrence 上就 fail-loud;收编后走
+ * `lastFlagValue`('invalidate' 缺省)= 后一次合法 occurrence 覆盖前一次,整体接受。
+ * 为什么裁定不改回去:本模块自己写着的契约就是「Repeated flag ⇒ LAST wins(commander convention)」,
+ * eager-validate 违反的正是这条契约(它让**被覆盖掉的**那一次决定整条命令的成败)。
+ * 剩下的形(唯一一次出现却缺值 / 值是旗形 / 空 / 超长 / 带空白)**仍然全部 fail-loud** —— 那才是
+ * 「打错一个字就悄悄跑在别的镜像上」真正要防的那一族。
+ * ⚠️ `docs/REFACTOR-LEDGER.md` REF-CC-143 的处置列此前写的是「缺值策略**统一** fail-loud」,
+ * 与落地的两策略叶(`'invalidate'` / `'latch-previous'`)相悖,已同批改正(sweep-F11)。 */
 export function parseScenarioArgv(argv) {
     // REF-CC-143(dup-07)收编:extraction 改吃共用 lastFlagValue(argvFlagValue.ts)——scan-all-then-
     // validate-once, matching this function's own documented "Repeated flag ⇒ LAST wins" contract (the

package/dist/seatContract.js

@@ -73,6 +73,26 @@
  * @sema-agent/client-core), the contract shape does not.
  */
 const bad = (reason, field) => field === undefined ? { reason } : { reason, field };
+/**
+ * 🔴 [2393] sweep-F8(2026-08-03 全窗复审):**嵌套失败的 field 路径不许在汇聚点被丢掉**。
+ * 修前三种写法各写各的:`chrome` 那条把已经算好的 `chrome.laneProof.lane` 整个覆盖成 `"chrome"`;
+ * `request`/`session`/`results[i]`/`sessions[i]` 把路径丢成父键名(reason 前缀里还留着索引,
+ * field 里没有)。这与 `SeatValidationFailure.field` 自己的定义(「嵌套位用点号,如
+ * `chrome.laneProof`」)直接相悖,也削弱 REF-CC-069 存在的理由 ——「一条被门吃掉的事件从此可诊断」:
+ * 宿主日志只会说「chrome 有问题」,而门明明知道是 `chrome.laneProof.lane`。
+ * @param prefix 父位路径(`"chrome"` / `` `results[${i}]` ``)
+ * @param verdict 子判据的失败(field 可能已是点号路径,也可能是裸键名,也可能缺席)
+ */
+const nested = (prefix, verdict) => {
+    // 子判据自己已经带上父前缀时(checkSeatChromeEnvelope 收的就是 field 参数)不再重复拼。
+    const path = verdict.field === undefined
+        ? prefix
+        : verdict.field === prefix || verdict.field.startsWith(`${prefix}.`)
+            ? verdict.field
+            : `${prefix}.${verdict.field}`;
+    const reason = verdict.reason.startsWith(`${prefix}:`) ? verdict.reason : `${prefix}: ${verdict.reason}`;
+    return bad(reason, path);
+};
 /** 存在性判定(§B10:`!!v` 那种真值判定会把空串/0 当缺席,对象位则会把 `{}` 当「有证」)。 */
 const isObject = (v) => typeof v === "object" && v !== null;
 const isAbsent = (v) => typeof v === "undefined";
@@ -318,7 +338,7 @@ const checkLocalSessionEvent = (v) => {
     if (!isAbsent(v.request)) {
         const verdict = checkToolPermissionRequest(v.request);
         if (verdict !== true)
-            return bad(`request: ${verdict.reason}`, "request");
+            return nested("request", verdict); // sweep-F8:路径不丢
     }
     if (!optionalString(v.data))
         return bad("data must be a string when present", "data");
@@ -336,7 +356,7 @@ const checkLocalSessionEvent = (v) => {
     if (!isAbsent(v.session)) {
         const verdict = checkLocalSessionRecord(v.session);
         if (verdict !== true)
-            return bad(`session: ${verdict.reason}`, "session");
+            return nested("session", verdict); // sweep-F8:路径不丢
     }
     if (!optionalString(v.userMessageUuid))
         return bad("userMessageUuid must be a string when present", "userMessageUuid");
@@ -352,7 +372,7 @@ const checkLocalSessionEvent = (v) => {
     if (!isAbsent(v.chrome)) {
         const verdict = checkSeatChromeEnvelope(v.chrome, "chrome");
         if (verdict !== true)
-            return bad(verdict.reason, "chrome");
+            return nested("chrome", verdict); // sweep-F8:门算好的 chrome.laneProof.lane 不许被覆盖
     }
     return true;
 };
@@ -469,7 +489,7 @@ const checkSessionSearchEnvelope = (v) => {
     for (let i = 0; i < results.length; i += 1) {
         const verdict = checkSessionSearchResult(results[i]);
         if (verdict !== true)
-            return bad(`results[${i}]: ${verdict.reason}`, "results");
+            return nested(`results[${i}]`, verdict); // sweep-F8
     }
     return true;
 };
@@ -482,7 +502,7 @@ const checkSessionsState = (v) => {
     for (let i = 0; i < sessions.length; i += 1) {
         const verdict = checkLocalSessionRecord(sessions[i]);
         if (verdict !== true)
-            return bad(`sessions[${i}]: ${verdict.reason}`, "sessions");
+            return nested(`sessions[${i}]`, verdict); // sweep-F8
     }
     return true;
 };

package/dist/steering.js

@@ -72,12 +72,21 @@ function parseBackgroundTaskLine(line) {
         const m = /^- \[([^\]]+)\] Task "([\s\S]*)$/.exec(head);
         if (!m)
             return null;
+        // 🔴 [2393] sweep-F16(2026-08-03 全窗复审):这里**不许**回落成空串。两个捕获组都是非可选的,
+        // `m` 非空时它们必在场(所以这条早退今天不可达),但 `?? ''` 的**形**是「不知道就渲空串」——
+        // 与同窗刚立的口径(`fleetAgentPanelProjection`「缺席就是 undefined,这里不许兜 0」/
+        // `seatContract`「绝不回落成 0(那会渲成 1970)」)相反,且真出问题时会静默产出一条 taskId
+        // 为空串的任务行(谁也定位不到)。noUncheckedIndexedAccess 适配的正解是**如实拒绝**。
+        const taskId = m[1];
+        const description = m[2];
+        if (taskId === undefined || description === undefined)
+            return null;
         return {
             type: 'task_status',
-            taskId: m[1] ?? '',
+            taskId,
             taskType: 'local_bash',
             status,
-            description: m[2] ?? '',
+            description,
             deltaSummary: null,
         };
     }

package/dist/subagentContentStore.d.ts

@@ -44,6 +44,19 @@ export type SubagentContentItem = {
     kind: 'echo';
     text: string;
 };
+/**
+ * 🔴 [2393] sweep-F15(2026-08-03 全窗复审)**记一笔口径分叉**(裁定:留 `| undefined`,写明为什么):
+ * 下面五个可选位在 eopt 收官批被写成 `?: T | undefined`(= 允许显式赋 `undefined` 落键),而同窗
+ * 另两处的口径是相反的(`fleetAgentPanelProjection` 的「🔴 缺席即不落键(消费端据键在不在判三态)」、
+ * `toolResult` 的「公面键恒在形不许被 eopt 批翻成条件展开」)。两种口径都出自同一批,当时没有一处记账。
+ * 为什么这里走另一条:**本类型的消费端一处都不用「键在不在」判三态** —— 本文件 `apply()` 全部用
+ * `typeof ev.delta === 'string'` / `ev.output ?? ''` / `ev.isError === true` 这类**值级**判据
+ * (逐行核过,见下方 switch),所以 `{delta: undefined}` 与「不落键」在本模块里可观测等价;而生产者
+ * 是宿主的帧适配腿,`{ delta: maybe }` 这种直写形在 eopt 下会编译红,逼它们改写成条件展开只是把
+ * 噪音推给三端,换不来任何判别力。
+ * ⚠️ 反过来的约束:**谁想给这个类型加一个用「键在不在」判三态的位,就必须同批把这里改成条件展开**
+ * (那时两种口径就不能再共存了)。
+ */
 export interface SubagentContentEvent {
     type: 'text_delta' | 'reasoning_delta' | 'tool_start' | 'tool_end';
     taskId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "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. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",