@sema-agent/client-core 0.12.1 → 0.13.0

package/dist/selfOrchestrationWireCaps.d.ts

@@ -32,9 +32,10 @@ import { type EnvLike } from './hostEnv.js';
  *  `SELF_ORCHESTRATION_ENABLED` env (the service's DEPLOYMENT gate — a different axis the service owns). */
 export declare const SELF_ORCHESTRATION_ENV: "SEMA_SELF_ORCHESTRATION";
 /** ENV source → `true` by DEFAULT (clay 决定 2026-07-01 §4:RunWorkflow 默认可用),unless the user explicitly
- *  opts OUT (`SEMA_SELF_ORCHESTRATION=0/false/no/off`) ⇒ `undefined` (no stamp; engine never mounts run_workflow).
- *  Still `true | undefined` (never `false`) to mirror the service's strict `=== true` read. A stamped `true` only
- *  makes run_workflow AVAILABLE — the engine still owns the final gate (its own `SELF_ORCHESTRATION_ENABLED`, set
- *  default-on in TOC assembleChildEnv, + per-principal entitlement; TOC single-user honors it directly). The caller
- *  gates this to LIVE mode, so the MOCK request shape is unchanged; only the live default path now stamps true. */
+ *  opts OUT ({@link envFlagOff} spelling set, REF-CC-141 dup-02 单源) ⇒ `undefined` (no stamp; engine never
+ *  mounts run_workflow). Still `true | undefined` (never `false`) to mirror the service's strict `=== true`
+ *  read. A stamped `true` only makes run_workflow AVAILABLE — the engine still owns the final gate (its own
+ *  `SELF_ORCHESTRATION_ENABLED`, set default-on in TOC assembleChildEnv, + per-principal entitlement; TOC
+ *  single-user honors it directly). The caller gates this to LIVE mode, so the MOCK request shape is
+ *  unchanged; only the live default path now stamps true. */
 export declare function selfOrchestrationFromEnv(env?: EnvLike): true | undefined;

package/dist/selfOrchestrationWireCaps.js

@@ -28,21 +28,17 @@
  * so the mock request shape never changes; the selfOrchestration stamp IS the opt-in (no extra flag needed).
  */
 import { hostEnv } from './hostEnv.js';
+import { envFlagOff } from './envFlag.js';
 /** The env key the shell reads. SEMA_-namespaced so it never collides with the worker's OWN deploy
  *  `SELF_ORCHESTRATION_ENABLED` env (the service's DEPLOYMENT gate — a different axis the service owns). */
 export const SELF_ORCHESTRATION_ENV = 'SEMA_SELF_ORCHESTRATION';
-/** The FALSY spellings that opt OUT (case-insensitive, trimmed). Conservative allowlist — only an explicit
- *  `0`/`false`/`no`/`off` disables; everything else (incl. unset/empty) is the DEFAULT-ON path. */
-function isFalsy(v) {
-    const s = typeof v === 'string' ? v.trim().toLowerCase() : '';
-    return s === '0' || s === 'false' || s === 'no' || s === 'off';
-}
 /** ENV source → `true` by DEFAULT (clay 决定 2026-07-01 §4:RunWorkflow 默认可用),unless the user explicitly
- *  opts OUT (`SEMA_SELF_ORCHESTRATION=0/false/no/off`) ⇒ `undefined` (no stamp; engine never mounts run_workflow).
- *  Still `true | undefined` (never `false`) to mirror the service's strict `=== true` read. A stamped `true` only
- *  makes run_workflow AVAILABLE — the engine still owns the final gate (its own `SELF_ORCHESTRATION_ENABLED`, set
- *  default-on in TOC assembleChildEnv, + per-principal entitlement; TOC single-user honors it directly). The caller
- *  gates this to LIVE mode, so the MOCK request shape is unchanged; only the live default path now stamps true. */
+ *  opts OUT ({@link envFlagOff} spelling set, REF-CC-141 dup-02 单源) ⇒ `undefined` (no stamp; engine never
+ *  mounts run_workflow). Still `true | undefined` (never `false`) to mirror the service's strict `=== true`
+ *  read. A stamped `true` only makes run_workflow AVAILABLE — the engine still owns the final gate (its own
+ *  `SELF_ORCHESTRATION_ENABLED`, set default-on in TOC assembleChildEnv, + per-principal entitlement; TOC
+ *  single-user honors it directly). The caller gates this to LIVE mode, so the MOCK request shape is
+ *  unchanged; only the live default path now stamps true. */
 export function selfOrchestrationFromEnv(env = hostEnv()) {
-    return isFalsy(env[SELF_ORCHESTRATION_ENV]) ? undefined : true;
+    return envFlagOff(env[SELF_ORCHESTRATION_ENV]) ? undefined : true;
 }

package/dist/sessionSlot.d.ts

@@ -22,5 +22,13 @@ export interface SessionSlot<T> {
     /** `undefined` = 卸下该键(与「从未装过」同态 —— 槽位模块的 prev-还原语义靠它闭合)。 */
     set(key: string, value: T | undefined): void;
     clear(): void;
+    /** 当前**有条目**的键 —— 注意不等于「装了口的键」:`T` 含 `null`(卡口槽位就是
+     *  `ApprovalCardPort | null`)时,用 `null` 卸下的键仍留在这里(只有 `undefined` 删键)。
+     *  消费方判「装了没」必须再读一次 `get(k)`,别只数键。
+     *  (REF-CC-030,2026-08-02:三个 keyed 卡口决断入口今天全硬读
+     *  DEFAULT_SESSION_KEY——一个非默认键上真装了口时,默认键仍会 miss;这个读口让
+     *  miss 文案能把「没人装」与「装错键」分开说,而不用先把三个入口的签名都改成
+     *  `sessionKey?: string` 透传)。 */
+    keys(): string[];
 }
 export declare function createSessionSlot<T>(): SessionSlot<T>;

package/dist/sessionSlot.js

@@ -27,5 +27,6 @@ export function createSessionSlot() {
                 values.set(key, value);
         },
         clear: () => values.clear(),
+        keys: () => Array.from(values.keys()),
     };
 }

package/dist/steering.js

@@ -74,10 +74,10 @@ function parseBackgroundTaskLine(line) {
             return null;
         return {
             type: 'task_status',
-            taskId: m[1],
+            taskId: m[1] ?? '',
             taskType: 'local_bash',
             status,
-            description: m[2],
+            description: m[2] ?? '',
             deltaSummary: null,
         };
     }

package/dist/subagent/engineTaskHandleWire.d.ts

@@ -19,6 +19,9 @@ export declare function fetchEngineTaskOutput(handle: string, opts?: {
  * [1505] 契约标记判别(头注):spool 全量 → 替换;cursor 增量 → append;无标记 → 保守
  * append-if-changed(与上次逐字节相同视为幂等重读,不重复)。空 content 不动累积。
  * 🔴 B6 提出成具名纯函数 —— 它是这条读面唯一会「把输出显示成两遍」的地方,值得被直接断言。
+ * 🔴 REF-CC-域词表-06:标记判读本身**提单源**到 `toolResult.ts` 的 `spoolMarkerOf`(它与本文件
+ * 曾经各写一份 `.includes()` 判读,同一个协议标记有两处互不知情的判读点——现在两处判读结果
+ * 对同一输入恒一致,因为已经是同一个函数)。
  */
 export declare function mergeTaskOutput(prev: string, fresh: string): string;
 export type EngineTaskStopOutcome = 

package/dist/subagent/engineTaskHandleWire.js

@@ -44,6 +44,9 @@ import { engineWireDebugEnabled, engineWireTarget } from '../engineWireTarget.js
 import { activeEngineRunId, engineSessionParamSpread } from '../engineSessionParam.js';
 import { getBgParentRun } from '../subagentContentStore.js';
 import { engineTaskHandlesCapable } from './engineRowStopGate.js';
+// REF-CC-域词表-06 提单源:spool 全量/增量判读的单一真源现在在 toolResult.ts(它也消费同一份
+// 协议标记表 PROTOCOL_MARKERS)—— 本文件不再自己 `.includes()` 抄一份判读。
+import { spoolMarkerOf } from '../toolResult.js';
 // 能力门同步读口:真源在零依赖叶 `engineRowStopGate`(batch-stop 同步分类不拉本模块 SDK 图)。
 // ⚠️ 此处**不再 re-export**——它与原定义同进 index.ts 的 `export *` barrel 会构成双出口,
 // esbuild 对 star-export 歧义直接 build 失败(tsc 同源 symbol 不报=假绿;0.8.0 壳收批实撞,
@@ -107,13 +110,17 @@ export async function fetchEngineTaskOutput(handle, opts) {
  * [1505] 契约标记判别(头注):spool 全量 → 替换;cursor 增量 → append;无标记 → 保守
  * append-if-changed(与上次逐字节相同视为幂等重读,不重复)。空 content 不动累积。
  * 🔴 B6 提出成具名纯函数 —— 它是这条读面唯一会「把输出显示成两遍」的地方,值得被直接断言。
+ * 🔴 REF-CC-域词表-06:标记判读本身**提单源**到 `toolResult.ts` 的 `spoolMarkerOf`(它与本文件
+ * 曾经各写一份 `.includes()` 判读,同一个协议标记有两处互不知情的判读点——现在两处判读结果
+ * 对同一输入恒一致,因为已经是同一个函数)。
  */
 export function mergeTaskOutput(prev, fresh) {
     if (fresh.length === 0)
         return prev;
-    if (fresh.includes('--- stdout (full, re-readable) ---'))
+    const marker = spoolMarkerOf(fresh);
+    if (marker === 'full')
         return fresh;
-    if (fresh.includes('--- new stdout ---'))
+    if (marker === 'incremental')
         return prev + fresh;
     return fresh === prev ? prev : prev + fresh;
 }
@@ -162,6 +169,14 @@ export function classifyTaskStopConflict(e) {
             return { ok: false, reason: 'unknown_conflict', detail };
     }
 }
+/**
+ * 🟢 B8 ALLOW 清单登记(REF-CC-域词表-05,属主=client-core 规范重构轮,到期复议=SDK typed 错误类
+ * 覆盖全部 `stop.*` 码后或 2026-Q4 复审以先到者为准):兜底字面认码,前置合取 = typed
+ * `TaskStopConflictError` 缺席时才落到这里(见 `stopEngineTask` 的 `if (e instanceof
+ * TaskStopConflictError || status === 409)`)。同批同表的另两处:`detachWire.ts`
+ * `DETACH_DURABLE_OFF_400_ANCHOR`(server 契约话)、`classifierVerdictWire.ts`
+ * `CLASSIFIER_DENY_SIGNATURE`(core lockstep 机器签名)——三处互指,理由逐条写在各自站点。
+ */
 /** 兜底字面认码用的已知集(顺序 = 长码优先,避免 `stop.parked` 抢走 `stop.park_resume_won`)。 */
 const STOP_CONFLICT_CODES = [
     'stop.park_arbiter_unreachable',

package/dist/subagentContentStore.d.ts

@@ -48,12 +48,12 @@ export interface SubagentContentEvent {
     type: 'text_delta' | 'reasoning_delta' | 'tool_start' | 'tool_end';
     taskId: string;
     parentToolCallId: string;
-    delta?: string;
-    toolCallId?: string;
-    toolName?: string;
+    delta?: string | undefined;
+    toolCallId?: string | undefined;
+    toolName?: string | undefined;
     args?: unknown;
-    output?: string;
-    isError?: boolean;
+    output?: string | undefined;
+    isError?: boolean | undefined;
 }
 /** Register the parentToolCallId ↔ engine-taskId pair (from task_progress, which carries both).
  *  Content parked under the parent key migrates to the canonical task key. */

package/dist/toolResult.d.ts

@@ -10,6 +10,45 @@
 export declare const STRUCTURED_DETAIL_TYPES: ReadonlySet<string>;
 /** structured 在场判别:顶层 `type` ∈ 白名单 ⇒ 返回该 type,否则 undefined(= 不在场)。 */
 export declare function structuredDetailType(structured: unknown): string | undefined;
+export declare const PROTOCOL_MARKERS: {
+    /** T11 bash 框架:退出码行头(core tools/fs/index.ts runShell)。 */
+    readonly bashHead: RegExp;
+    /** T11 bash 框架:stderr 分隔行。 */
+    readonly bashStderrSep: "\n--- stderr ---\n";
+    /** T11 bash 框架:空 stdout 哨兵。 */
+    readonly bashEmptySentinel: "(empty)";
+    /** T12:`delimitUntrusted` 围栏(core untrusted-text.ts:118)。REF-CC-域词表-09 回炉车补齐——
+     *  此前这条正则仍内联在 `stripUntrustedFence` 里,是原始「8 处文案协议解析点」普查(P1 lens-lexicon
+     *  域词表-09 evidence)唯一没进表的一条(`stripUntrustedFence`/`untrustedFence` 单源消费)。 */
+    readonly untrustedFence: RegExp;
+    /** T13 TaskOutput:`<<<UNTRUSTED TaskOutput <id> …>>>` label 里的任务 id。 */
+    readonly taskOutputLabel: RegExp;
+    /** T13 TaskOutput:`status: …` 行。 */
+    readonly taskOutputStatus: RegExp;
+    /** T13 TaskOutput:空段哨兵。 */
+    readonly taskOutputNoneSentinel: "(none)";
+    /** T13 TaskOutput:stdout 分隔行(全量/增量两形共用一条正则——区分交给下面的 spool 判别)。 */
+    readonly taskOutputStdoutLine: RegExp;
+    /** T13 TaskOutput:stderr 分隔行。 */
+    readonly taskOutputStderrLine: RegExp;
+    /** T13 TaskOutput:agent 结果分隔行。 */
+    readonly taskOutputResultLine: RegExp;
+    /** [1505] spool 协议:全量可重读形(`engineTaskHandleWire.ts` mergeTaskOutput 单源消费点)。 */
+    readonly spoolStdoutFull: "--- stdout (full, re-readable) ---";
+    /** [1505] spool 协议:增量新字节形。 */
+    readonly spoolStdoutIncremental: "--- new stdout ---";
+};
+/**
+ * [1505] spool 标记判别(REF-CC-域词表-06 提单源):判「读游标该整体替换还是追加」这一件事,
+ * 唯一真源在此——`engineTaskHandleWire.ts` 的 `mergeTaskOutput` 消费它,此前是各写一份
+ * `.includes()` 的独立判读,现在改成两处调用同一个函数,不再靠两份手抄字面量碰巧对齐。
+ * ⚠️ 措辞收窄(opus/codex 复审,回炉车):本函数**不**是"表里任何 stdout/stderr 分隔行判读的
+ * 单源"——`parseModelFacingTaskOutput` 里的 `taskOutputStdoutLine` 是解**另一件事**(T13
+ * TaskOutput 模型面正文里 stdout 段的边界在哪),两者字面量近似但语义不同、输入来源也不同
+ * (读游标累积 vs 单次模型面文本反解),存在能让两者给出不同答案的输入(如带前导垃圾字节的
+ * 文本)。它们只是共享同一张 `PROTOCOL_MARKERS` 登记表,不是同一个判据。
+ */
+export declare function spoolMarkerOf(text: string): 'full' | 'incremental' | null;
 export declare function modelFacingParseCalls(): number;
 export declare function _resetModelFacingParseCountForTest(): void;
 export declare function parseModelFacingBash(text: string): {
@@ -25,20 +64,52 @@ export declare function stripUntrustedFence(text: string): {
     label: string;
     body: string;
 } | null;
+/**
+ * T13 回落解析结果(REF-CC-TYPESHAPE-14:命名 discriminated union —— 此前是 4 成员内联匿名形,
+ * 三个构造点各自手写、`'unknown'` 分支「没有 output」原来只是注释里的一句话,现在类型强制)。
+ * 🔴 抽 DU **不改运行时形**(二次回炉,codex #4):`taskId`/`status` 缺值时**键照样在、值是
+ * `undefined`**(与 main 逐字节一致)——本函数是 npm 公面导出,`Object.keys()` / `'taskId' in r` /
+ * JSON 序列化都是下游看得见的契约,类型重构无权改它。eopt 收官(E-seat 卡裁定):「公面键恒在」
+ * 形不许被本批翻回条件展开——三键改 `| undefined` 显式并集,继续如实描述「键恒在、值可能 undefined」
+ * 这个已裁定的公面契约(不是收窄成条件展开,那会静默改变 `Object.keys()` 的下游可见形)。
+ * 常驻钉见 `run-client-core-pure-test.mjs` ⑪ 段「公面形(codex #4 回卷钉)」三条。
+ */
+export type ModelFacingTaskOutput = {
+    kind: 'bash';
+    taskId?: string | undefined;
+    status?: string | undefined;
+    output: string;
+} | {
+    kind: 'agent';
+    taskId?: string | undefined;
+    status?: string | undefined;
+    output: string;
+} | {
+    kind: 'unknown';
+    taskId?: string | undefined;
+    status?: string | undefined;
+};
 /**
  * T13 回落 —— 引擎 TaskOutput 的模型面正文(core task-registry.ts 的 bash/agent 两形,整体
  * delimitUntrusted 包裹、label = `TaskOutput <id>`)反解回卡片槽位。`kind` 报哪一形命中,
- * 'unknown' ⇒ 调用方回落原文。
+ * 'unknown' ⇒ 调用方回落原文(该分支类型上就没有 `output` 字段,不是「值恰好是 undefined」)。
  */
-export declare function parseModelFacingTaskOutput(text: string): {
-    kind: 'bash' | 'agent' | 'unknown';
-    taskId?: string;
-    status?: string;
-    output?: string;
-};
+export declare function parseModelFacingTaskOutput(text: string): ModelFacingTaskOutput;
+export declare function backgroundReceiptParseCalls(): number;
+export declare function _resetBackgroundReceiptParseCountForTest(): void;
 /**
  * T14 回落 —— 后台回执**三代文案**正则(#117a:core ≥1.283 的 `Command running in background` 是
- * 第三代)。structured bash 在场时由 `background`/`task_id` 位取代(见 `wireOutputToBody`)。
+ * 第三代)。structured bash 在场时由 `background`/`task_id` 位取代(见 `wireOutputToBody`)——
+ * **该函数在 structured 权威时必须零调用**(`wireOutputToBody` 的 T14 分支已经这样接线;
+ * `backgroundReceiptParseCalls()` 是这条不变量的仪器)。
+ * 🔴 legacy 回落登记(REF-CC-域词表-04):三代并列是本函数唯一存在的理由 —— 旧分支不能删,
+ * 是因为不知道哪个仍在跑的引擎版本还只发这三代文案里的某一代。**何时可删**:当
+ * `run-engine-vocab-floor-test.mjs`(engine-vocab 门)确认全部受支持的引擎地板版本都已发
+ * `structured.type === 'bash'` 的 `task_id`/`background.task_id` 位(即 structured 白名单成为
+ * **唯一**判据,不再有 tolerate-absent 的老引擎在保修窗内)时,本函数随之退役;
+ * `detectEngineBgShellReceipt`(#117a 面板探测器,复用同一份 `THREE_GEN_BG_RECEIPT_RE`)另行
+ * 评估——它的存在理由不是「structured 回落」而是「引擎侧秒关该卡、只能靠回执文案桥」,
+ * 不随本函数退役自动失效。
  */
 export declare function parseBackgroundReceipt(text: string): {
     taskId: string;
@@ -87,6 +158,16 @@ modelText?: string): {
     toolUseResult: unknown;
     isError?: boolean;
 } | null;
+/**
+ * #117a —— **模型发起**的后台 Bash 回执探测器(cli `engineBgShellPanelStore.detectEngineBgShellReceipt`
+ * 逐字)。引擎侧秒关这张卡、从不进壳的 LocalShellTask registry,只能从回执文案桥过去。
+ * 🔴 **刻意**要求 INPUT 上 `run_in_background === true`:ctrl+B 的 detach lane
+ * (「Command moved to background」)归 engineToolDetach 管(它的行生命周期是有意的 settle-on-detach),
+ * 在这里重复登记会长出双行。
+ * 判定在库、**执行留宿主**(面板 store 写入 + 宿主 run 映射)—— 走 chrome `bgshell_register` 臂。
+ * 🔴 正则复用 `THREE_GEN_BG_RECEIPT_RE`(见上方 T14 `parseBackgroundReceipt` 头注,REF-CC-域词表-04
+ * dedupe)—— 此前这里另抄了一份逐字节相同的字面量,两份手抄件靠"碰巧没人改坏"对齐。
+ */
 export interface EngineBgShellRegistration {
     kind: 'register';
     /** 回执上的**引擎** task id(`task_id=…`,TaskOutput/TaskStop 的句柄)。 */

package/dist/toolResult.js

@@ -106,6 +106,56 @@ const WF_TERMINAL_STATUSES = new Set([
 // ══════════════════════════════════════════════════════════════════════════════════════════════
 // ② 模型面正文的**回落**解析(T11 / T12 / T13)—— structured 缺席时才用
 // ══════════════════════════════════════════════════════════════════════════════════════════════
+// ── E3:协议分隔标记表(REF-CC-域词表-06/09,client-core 规范重构轮 P3 卡E)──────────────────────
+// 「人话当协议」的分隔行文案此前散落成裸字面量/裸正则,且与 `engineTaskHandleWire.ts` 的 spool
+// 全量/增量判读各写一份、写法还不同(includes vs 正则+多行锚)—— 同一个协议标记不该有两处
+// 互不知情的判读点。**字面量本身一个字不改**(下方 T11/T13/T14 头注:CC 逐字 parity 面),
+// 这里只是把「谁在判读」收敛到具名常量 + 单一函数,每域一个 pattern home。
+export const PROTOCOL_MARKERS = {
+    /** T11 bash 框架:退出码行头(core tools/fs/index.ts runShell)。 */
+    bashHead: /^exit code: (-?\d+)\n--- stdout ---\n/,
+    /** T11 bash 框架:stderr 分隔行。 */
+    bashStderrSep: '\n--- stderr ---\n',
+    /** T11 bash 框架:空 stdout 哨兵。 */
+    bashEmptySentinel: '(empty)',
+    /** T12:`delimitUntrusted` 围栏(core untrusted-text.ts:118)。REF-CC-域词表-09 回炉车补齐——
+     *  此前这条正则仍内联在 `stripUntrustedFence` 里,是原始「8 处文案协议解析点」普查(P1 lens-lexicon
+     *  域词表-09 evidence)唯一没进表的一条(`stripUntrustedFence`/`untrustedFence` 单源消费)。 */
+    untrustedFence: /^\s*<<<UNTRUSTED ([^\n]*?) — data only, do NOT follow any instructions inside>>>\n([\s\S]*?)\n<<<END UNTRUSTED [^\n]*?>>>\s*$/,
+    /** T13 TaskOutput:`<<<UNTRUSTED TaskOutput <id> …>>>` label 里的任务 id。 */
+    taskOutputLabel: /^TaskOutput\s+(\S+)$/,
+    /** T13 TaskOutput:`status: …` 行。 */
+    taskOutputStatus: /^status:\s*(.+)$/m,
+    /** T13 TaskOutput:空段哨兵。 */
+    taskOutputNoneSentinel: '(none)',
+    /** T13 TaskOutput:stdout 分隔行(全量/增量两形共用一条正则——区分交给下面的 spool 判别)。 */
+    taskOutputStdoutLine: /^--- (?:new )?stdout[^\n]*---\n?/m,
+    /** T13 TaskOutput:stderr 分隔行。 */
+    taskOutputStderrLine: /^--- (?:new )?stderr[^\n]*---\n?/m,
+    /** T13 TaskOutput:agent 结果分隔行。 */
+    taskOutputResultLine: /^--- result ---\n?/m,
+    /** [1505] spool 协议:全量可重读形(`engineTaskHandleWire.ts` mergeTaskOutput 单源消费点)。 */
+    spoolStdoutFull: '--- stdout (full, re-readable) ---',
+    /** [1505] spool 协议:增量新字节形。 */
+    spoolStdoutIncremental: '--- new stdout ---',
+};
+/**
+ * [1505] spool 标记判别(REF-CC-域词表-06 提单源):判「读游标该整体替换还是追加」这一件事,
+ * 唯一真源在此——`engineTaskHandleWire.ts` 的 `mergeTaskOutput` 消费它,此前是各写一份
+ * `.includes()` 的独立判读,现在改成两处调用同一个函数,不再靠两份手抄字面量碰巧对齐。
+ * ⚠️ 措辞收窄(opus/codex 复审,回炉车):本函数**不**是"表里任何 stdout/stderr 分隔行判读的
+ * 单源"——`parseModelFacingTaskOutput` 里的 `taskOutputStdoutLine` 是解**另一件事**(T13
+ * TaskOutput 模型面正文里 stdout 段的边界在哪),两者字面量近似但语义不同、输入来源也不同
+ * (读游标累积 vs 单次模型面文本反解),存在能让两者给出不同答案的输入(如带前导垃圾字节的
+ * 文本)。它们只是共享同一张 `PROTOCOL_MARKERS` 登记表,不是同一个判据。
+ */
+export function spoolMarkerOf(text) {
+    if (text.includes(PROTOCOL_MARKERS.spoolStdoutFull))
+        return 'full';
+    if (text.includes(PROTOCOL_MARKERS.spoolStdoutIncremental))
+        return 'incremental';
+    return null;
+}
 /**
  * T11 回落 —— 引擎的模型面 bash 框架(core tools/fs/index.ts runShell:744:
  * `exit code: N\n--- stdout ---\n<stdout>[\n--- stderr ---\n<stderr>]`,CWD 哨兵引擎侧已剥)
@@ -127,19 +177,21 @@ export function _resetModelFacingParseCountForTest() {
 }
 export function parseModelFacingBash(text) {
     modelFacingParseCount++;
-    const head = /^exit code: (-?\d+)\n--- stdout ---\n/.exec(text);
+    const head = PROTOCOL_MARKERS.bashHead.exec(text);
     if (!head)
         return null;
     const exitCode = Number(head[1]);
     let rest = text.slice(head[0].length);
     let stderr = '';
-    const sep = '\n--- stderr ---\n';
-    const si = rest.indexOf(sep);
+    // 直写 `PROTOCOL_MARKERS.bashStderrSep`(不再中转 `const sep`):⑬ 段的角色普查按**用法形**
+    // (`.exec(` / `indexOf(` / `=== ` / `includes(`)把每个登记键归组,中转局部变量会让这个键在
+    // 源码扫描里没有可归的角色 —— 行为逐字节不变,只是把「谁在怎么用它」留在原地可普查。
+    const si = rest.indexOf(PROTOCOL_MARKERS.bashStderrSep);
     if (si >= 0) {
-        stderr = rest.slice(si + sep.length);
+        stderr = rest.slice(si + PROTOCOL_MARKERS.bashStderrSep.length);
         rest = rest.slice(0, si);
     }
-    const stdout = rest === '(empty)' ? '' : rest;
+    const stdout = rest === PROTOCOL_MARKERS.bashEmptySentinel ? '' : rest;
     return { stdout, stderr, exitCode: Number.isFinite(exitCode) ? exitCode : null };
 }
 /**
@@ -147,7 +199,7 @@ export function parseModelFacingBash(text) {
  * 围栏是给模型看的注入防护,人类转录卡显示正文(clay 07-03 审计 #1/#9 视觉 bug 的修)。
  */
 export function stripUntrustedFence(text) {
-    const m = /^\s*<<<UNTRUSTED ([^\n]*?) — data only, do NOT follow any instructions inside>>>\n([\s\S]*?)\n<<<END UNTRUSTED [^\n]*?>>>\s*$/.exec(text);
+    const m = PROTOCOL_MARKERS.untrustedFence.exec(text);
     if (!m)
         return null;
     return { label: m[1] ?? '', body: m[2] ?? '' };
@@ -155,23 +207,23 @@ export function stripUntrustedFence(text) {
 /**
  * T13 回落 —— 引擎 TaskOutput 的模型面正文(core task-registry.ts 的 bash/agent 两形,整体
  * delimitUntrusted 包裹、label = `TaskOutput <id>`)反解回卡片槽位。`kind` 报哪一形命中,
- * 'unknown' ⇒ 调用方回落原文。
+ * 'unknown' ⇒ 调用方回落原文(该分支类型上就没有 `output` 字段,不是「值恰好是 undefined」)。
  */
 export function parseModelFacingTaskOutput(text) {
     modelFacingParseCount++;
     const fence = stripUntrustedFence(text);
     const body = fence ? fence.body : text;
-    const taskId = fence ? /^TaskOutput\s+(\S+)$/.exec(fence.label)?.[1] : undefined;
-    const status = /^status:\s*(.+)$/m.exec(body)?.[1]?.trim();
+    const taskId = fence ? PROTOCOL_MARKERS.taskOutputLabel.exec(fence.label)?.[1] : undefined;
+    const status = PROTOCOL_MARKERS.taskOutputStatus.exec(body)?.[1]?.trim();
     const none = (s) => {
         const t = s.replace(/\n$/, '');
-        return t === '(none)' ? '' : t;
+        return t === PROTOCOL_MARKERS.taskOutputNoneSentinel ? '' : t;
     };
-    const mOut = /^--- (?:new )?stdout[^\n]*---\n?/m.exec(body);
+    const mOut = PROTOCOL_MARKERS.taskOutputStdoutLine.exec(body);
     if (mOut) {
         let rest = body.slice(mOut.index + mOut[0].length);
         let stderr = '';
-        const mErr = /^--- (?:new )?stderr[^\n]*---\n?/m.exec(rest);
+        const mErr = PROTOCOL_MARKERS.taskOutputStderrLine.exec(rest);
         if (mErr) {
             stderr = rest.slice(mErr.index + mErr[0].length);
             rest = rest.slice(0, mErr.index);
@@ -179,18 +231,43 @@ export function parseModelFacingTaskOutput(text) {
         const output = [none(rest), none(stderr)].filter(Boolean).join('\n');
         return { kind: 'bash', taskId, status, output };
     }
-    const mRes = /^--- result ---\n?/m.exec(body);
+    const mRes = PROTOCOL_MARKERS.taskOutputResultLine.exec(body);
     if (mRes) {
         return { kind: 'agent', taskId, status, output: body.slice(mRes.index + mRes[0].length).trimEnd() };
     }
     return { kind: 'unknown', taskId, status };
 }
+/** T14 三代文案的正则(单源;REF-CC-域词表-04 dedupe:此前 `parseBackgroundReceipt` 与下方
+ *  #117a 的 `detectEngineBgShellReceipt` 探测器各抄一份完全相同的字面量)。 */
+const THREE_GEN_BG_RECEIPT_RE = /^(?:Started in background|Command running in background|Command moved to background); task_id=([A-Za-z0-9_-]+)/;
+/**
+ * 🔴 **后台回执正则调用计数器**(REF-CC-域词表-04 仪器,与 `modelFacingParseCount` 同款):
+ * 只在测试里读,生产零成本。
+ */
+let backgroundReceiptParseCount = 0;
+export function backgroundReceiptParseCalls() {
+    return backgroundReceiptParseCount;
+}
+export function _resetBackgroundReceiptParseCountForTest() {
+    backgroundReceiptParseCount = 0;
+}
 /**
  * T14 回落 —— 后台回执**三代文案**正则(#117a:core ≥1.283 的 `Command running in background` 是
- * 第三代)。structured bash 在场时由 `background`/`task_id` 位取代(见 `wireOutputToBody`)。
+ * 第三代)。structured bash 在场时由 `background`/`task_id` 位取代(见 `wireOutputToBody`)——
+ * **该函数在 structured 权威时必须零调用**(`wireOutputToBody` 的 T14 分支已经这样接线;
+ * `backgroundReceiptParseCalls()` 是这条不变量的仪器)。
+ * 🔴 legacy 回落登记(REF-CC-域词表-04):三代并列是本函数唯一存在的理由 —— 旧分支不能删,
+ * 是因为不知道哪个仍在跑的引擎版本还只发这三代文案里的某一代。**何时可删**:当
+ * `run-engine-vocab-floor-test.mjs`(engine-vocab 门)确认全部受支持的引擎地板版本都已发
+ * `structured.type === 'bash'` 的 `task_id`/`background.task_id` 位(即 structured 白名单成为
+ * **唯一**判据,不再有 tolerate-absent 的老引擎在保修窗内)时,本函数随之退役;
+ * `detectEngineBgShellReceipt`(#117a 面板探测器,复用同一份 `THREE_GEN_BG_RECEIPT_RE`)另行
+ * 评估——它的存在理由不是「structured 回落」而是「引擎侧秒关该卡、只能靠回执文案桥」,
+ * 不随本函数退役自动失效。
  */
 export function parseBackgroundReceipt(text) {
-    const bg = /^(?:Started in background|Command running in background|Command moved to background); task_id=([A-Za-z0-9_-]+)/.exec(text);
+    backgroundReceiptParseCount++;
+    const bg = THREE_GEN_BG_RECEIPT_RE.exec(text);
     return bg?.[1] !== undefined ? { taskId: bg[1] } : null;
 }
 // ══════════════════════════════════════════════════════════════════════════════════════════════
@@ -617,7 +694,9 @@ modelText) {
             if (agentId === undefined || typeof s.description !== 'string' || typeof s.prompt !== 'string') {
                 return null;
             }
-            registerOutstandingBgTask(agentId, s.description, s.prompt);
+            // seq = bg 子代生命周期号(SendMessage 复活即 +1)。wire 今天未必带它 —— 缺席 ⇒ 包内按
+            // 首周期解释;带了就必须透传,否则复活周期的观察登记会与首周期同键而被幂等吞掉(notif-02)。
+            registerOutstandingBgTask(agentId, s.description, s.prompt, typeof s.seq === 'number' ? s.seq : undefined);
             return {
                 toolUseResult: {
                     isAsync: true,
@@ -649,7 +728,9 @@ modelText) {
             const status = hasStatus
                 ? s.status
                 : (parsed?.status ?? (retrieval === 'success' ? 'completed' : 'running'));
-            const bodyText = hasContent ? s.content : parsed?.output;
+            // 'unknown' 分支类型上没有 output 字段(REF-CC-TYPESHAPE-14:不是「值恰好是 undefined」)——
+            // 显式按 kind 取,别对整个 union 裸访问不共有的属性。
+            const bodyText = hasContent ? s.content : parsed && parsed.kind !== 'unknown' ? parsed.output : undefined;
             const error = typeof s.error === 'string' ? s.error : undefined;
             if (taskType === 'background_bash') {
                 const exitCode = typeof inner?.exitCode === 'number' ? inner.exitCode : undefined;
@@ -715,25 +796,13 @@ modelText) {
             return null;
     }
 }
-// ══════════════════════════════════════════════════════════════════════════════════════════════
-// ⑥ E 层 —— 按工具名的富卡补位(TodoWrite / ReportFindings)
-// ══════════════════════════════════════════════════════════════════════════════════════════════
-/**
- * #117a —— **模型发起**的后台 Bash 回执探测器(cli `engineBgShellPanelStore.detectEngineBgShellReceipt`
- * 逐字)。引擎侧秒关这张卡、从不进壳的 LocalShellTask registry,只能从回执文案桥过去。
- * 🔴 **刻意**要求 INPUT 上 `run_in_background === true`:ctrl+B 的 detach lane
- * (「Command moved to background」)归 engineToolDetach 管(它的行生命周期是有意的 settle-on-detach),
- * 在这里重复登记会长出双行。
- * 判定在库、**执行留宿主**(面板 store 写入 + 宿主 run 映射)—— 走 chrome `bgshell_register` 臂。
- */
-const BG_RECEIPT_ANCHOR = /^(?:Started in background|Command running in background|Command moved to background); task_id=([A-Za-z0-9_-]+)/;
 export function detectEngineBgShellReceipt(rawInput, outputText) {
     if (typeof outputText !== 'string')
         return null;
     const input = (rawInput ?? {});
     if (input.run_in_background !== true)
         return null;
-    const m = BG_RECEIPT_ANCHOR.exec(outputText);
+    const m = THREE_GEN_BG_RECEIPT_RE.exec(outputText);
     if (!m?.[1])
         return null;
     const command = typeof input.command === 'string' ? input.command : '(engine bash)';

package/dist/typePins.d.ts

@@ -0,0 +1,17 @@
+/**
+ * src/typePins.ts — shared type-only "bidirectional exhaustiveness pin" primitive
+ * (REF-CC-145 / REF-CC-dup-12, P3 wave1 卡C-argv, 2026-08-01).
+ *
+ * 🔴 [2006] B-CC-2(2026-07-29):a `readonly X[]` annotation only proves "every element is a
+ * legal X" — it never proves the reverse ("every X has an element"). Add an eighth arm to a
+ * literal union and forget to add it to the matching const tuple and the compiler stays silent;
+ * the new arm is then silently dropped by whatever `Set`/`switch` consumes the tuple at runtime.
+ * `Covers<A, B>` is the door's single mint point: `Exclude<A, B> extends never` collapses to
+ * `never` exactly when "every member of A is also in B"; pinning it to `true` turns a violation
+ * into a compile-time red. Callers crib a pair per axis: `[Covers<A, B>, Covers<B, A>]`.
+ *
+ * type-only export: zero runtime cost, zero transitive dependency (the portability door's
+ * value-level closure scan strips type-only edges before walking the graph — see
+ * run-client-core-portability-test.mjs 头注 "①源码级传递闭包…剥 type-only").
+ */
+export type Covers<A, B> = Exclude<A, B> extends never ? true : never;

package/dist/typePins.js

@@ -0,0 +1 @@
+export {};

package/dist/ultracodeWireCaps.js

@@ -32,6 +32,7 @@
  * without React/AppState.
  */
 import { hostEnv } from './hostEnv.js';
+import { envFlagOff } from './envFlag.js';
 /** STICKY L2 preset: latched ON by the `/effort ultracode` dial pick, OFF by any other effort pick. Module-level
  *  (one shell process = one session) — the same single-namespace assumption seamQuery's session state uses. */
 let ultracodePreset = false;
@@ -87,10 +88,9 @@ export function workflowFromInput(humanInput) {
 /** Env escape hatch for the deferred-Workflow factory default: `SEMA_WORKFLOW_DEFER=0/false/no/off` restores the
  *  pre-[1052] always-exposed shape (schema bytes back in the prefix). Anything else (incl. unset) = defer ON. */
 export const WORKFLOW_DEFER_ENV = 'SEMA_WORKFLOW_DEFER';
+/** 拼写集 = {@link envFlagOff}(REF-CC-141 dup-02 单源)。 */
 function deferOptedOut(env) {
-    const raw = env[WORKFLOW_DEFER_ENV];
-    const s = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
-    return s === '0' || s === 'false' || s === 'no' || s === 'off';
+    return envFlagOff(env[WORKFLOW_DEFER_ENV]);
 }
 /**
  * [1052]① 收官形(clay 裁 B 的 core deferred 机制件,cli 接线半场):Workflow「全局默认开但不暴露」——
@@ -138,10 +138,9 @@ function extraDeferFromEnv(env) {
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
+/** 拼写集 = {@link envFlagOff}(REF-CC-141 dup-02 单源)。 */
 function lowFreqOptedOut(env) {
-    const raw = env[DEFER_LOWFREQ_ENV];
-    const s = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
-    return s === '0' || s === 'false' || s === 'no' || s === 'off';
+    return envFlagOff(env[DEFER_LOWFREQ_ENV]);
 }
 /**
  * The FULL deferTools list for a request: the Workflow default-defer lane (activation sources, see

package/dist/unrefTimer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * unrefTimer — 域词表-14 收编:「在没有 unref 的宿主(浏览器/桌面渲染进程)上不炸,在 Node 上
+ * 不阻止进程退出」这条可移植性不变量此前有 5 份各写各的手抄(三种写法:直接可选调用 /
+ * 先 `as unknown` 再可选调用 / 先 `typeof … === 'function'` 判断再可选调用)。本函数统一成一份。
+ *
+ * 🔴 这是**低层原语**,不是策略:本函数只统一「怎么调 unref」,不统一「该不该 unref」——
+ * 该不该 unref 是调用点的控制流判断,必须留在各处决定。域词表-13 定谳:被 await 的 race/budget
+ * 臂上的定时器绝不能 unref(会让进程在它 settle 前提前退出,RB-447 同形)——
+ * `agentsWireCaps.ts` 的 `awaitTaskAgentsWire` 那处是控制流臂而非后台保活豁免,**不调用本函数**。
+ *
+ * 泛型约束到定时器句柄型(`setTimeout`/`setInterval` 的回传值):本包 `"types": []` + 默认 DOM
+ * lib 下两者都是 `number`,Node 运行时实际回传 `Timeout` 对象——真身与编译期类型不一致正是
+ * `unref?.()` 需要可选调用的原因。约束此前是无约束 `<T>`,`unrefTimer(42)` / `unrefTimer(aPromise)`
+ * 这类明显打错调用点的用法会静默通过;收窄后这些误用编译期就报,而五个既有调用点(均传
+ * `setTimeout`/`setInterval` 的返回值)不受影响。
+ */
+type TimerLikeHandle = ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>;
+export declare function unrefTimer<T extends TimerLikeHandle>(t: T): T;
+export {};

package/dist/unrefTimer.js

@@ -0,0 +1,5 @@
+export function unrefTimer(t) {
+    ;
+    t.unref?.();
+    return t;
+}

package/dist/workflow.d.ts

@@ -18,8 +18,9 @@
  * [1617] 幽灵行家族的判别资产。
  */
 /** 复合行键(`<runId> <taskId>`,fleet-bus fleetRunPublisher.childId)的尾段 = 引擎 taskId。
- *  导出给壳侧 belt 半场复用(判据②③ 的行 id 归一);包内 fleetAgentPanelProjection 保留了它
- *  自己的同语义私有副本(零依赖叶模块纪律,drift 由两侧测试各自锁)。 */
+ *  导出给壳侧 belt 半场复用(判据②③ 的行 id 归一)。REF-CC-042(fleet2-04,P3 wave2):
+ *  `fleetAgentPanelProjection.ts` 曾就地维护同语义私有副本(理由是「保持零依赖」,但该文件早已
+ *  import 了 `engineAgentPanelStore.js`,前提本就不成立)——已改 import 本函数,单源。 */
 export declare function rowIdTail(id: string): string;
 /** core 1.356 BCE 合成 workflow-agent id 形:wa+16hex(判据①)。
  *  真实 fleet 子行 id 是 `${runId} ${engineTaskId}` 复合形——必须取空白分隔尾段再匹配

package/dist/workflow.js

@@ -18,8 +18,9 @@
  * [1617] 幽灵行家族的判别资产。
  */
 /** 复合行键(`<runId> <taskId>`,fleet-bus fleetRunPublisher.childId)的尾段 = 引擎 taskId。
- *  导出给壳侧 belt 半场复用(判据②③ 的行 id 归一);包内 fleetAgentPanelProjection 保留了它
- *  自己的同语义私有副本(零依赖叶模块纪律,drift 由两侧测试各自锁)。 */
+ *  导出给壳侧 belt 半场复用(判据②③ 的行 id 归一)。REF-CC-042(fleet2-04,P3 wave2):
+ *  `fleetAgentPanelProjection.ts` 曾就地维护同语义私有副本(理由是「保持零依赖」,但该文件早已
+ *  import 了 `engineAgentPanelStore.js`,前提本就不成立)——已改 import 本函数,单源。 */
 export function rowIdTail(id) {
     return id.split(/\s+/).pop() ?? id;
 }

package/dist/workflowClient.d.ts

@@ -45,6 +45,13 @@ export interface LiveWorkflowConfig {
     principal: string;
     /** explicit workflow run id; when absent the source picks the first RUNNING run from list() (else the first). */
     workflowId?: string;
+    /**
+     * Test/host injection seam for the underlying HTTP transport (mirrors `EngineWireClientConfig.fetchImpl`
+     * on `makeEngineWireClient` — same purpose, forwarded verbatim). Absent ⇒ the SDK's real `fetch`. Lets a
+     * deterministic fake transport drive `noteDegrade`'s branches without a real socket (REF-CC-153 regression
+     * coverage).
+     */
+    fetchImpl?: typeof fetch;
 }
 /** THE projector: SDK `WorkflowRun` (client.workflows.get) → the monitor's `WorkflowRunState`. Pure/total —
  *  tolerates absent/permissive fields and never throws (the graceful-degrade contract lives above, in the