@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/resumeRefusalCopy.d.ts

@@ -1,159 +1,23 @@
-/**
- * src/resumeRefusalCopy.ts — resume 族**拒绝文案的三端单一铸点**(L-102 下半场,0.58.0)。
- *
- * ── 这一件上收的是什么 ──────────────────────────────────────────────────────────────────────
- * 0.57.0 已经把 L-102 的**事实读数**上收了({@link resumeRetryLaterFromError}:命中哪个码、
- * server 给没给窗、等一会儿有没有用)。留在壳里的另一半是**人话** —— cli 1.0.x 的
- * `src/sema/resumeRefusalCopy.ts` 自铸了一份判型 + 三句 `·` 分段文案,而 web-client / desktop
- * 各自要么没有、要么将来会再抄一份。三端各抄一份文案 = 同一次拒绝在三个端上说三句不一样的话,
- * 而这三句话回答的是**同一个安全问题**:「这次拒绝有没有消费掉我的决定 / 这张卡还能不能再决」。
- * ⇒ 文案与判型同属**判定归包、呈现归端**里的「判定」那一半,本模块是它的单一铸点。
- *
- * ── 与 0.57.0 §21 那一口的分工(两个闭集刻意分家)──────────────────────────────────────────
- * · {@link RESUME_RETRY_LATER_CODES}(engineErrorCodes.ts,0.57.0)闭的是「**server 在哪些码上铸
- *   `retryAfterSec`**」——它回答**能不能等**;
- * · {@link RESUME_REFUSAL_CODES}(本文件)闭的是「**哪些 resume 拒绝有人话可补**」——它回答
- *   **该对人说什么**。
- * 两集**交于** `resume.preflight_rejected` 一码、**各有**一个独占成员
- * (`resume.usage_window_exhausted` 只在前者 / `resume.placement_mismatch` 只在后者),所以它们
- * 不是同一张表的两个名字。🔴 **本模块不复制判定**:`preflight_rejected` 的窗与可等性一律**转调**
- * `resumeRetryLaterFromError`,本文件里没有第二个 `retryAfterSec` 窄读器
- * ([paired-mechanisms-must-share-premise]:两处各自判必然在某一格上分叉)。
- *
- * ── `retryAfterSec` 的窄读域比 cli 1.0.x 现行的更窄(端提货时要知道的差分)──────────────────
- * cli 那份自铸读器收的是「有限数 ∧ ≥0」;本口沿用 §21 的域 =「**整数 ∧ ≥1**」,坏值一律降缺席:
- *   · server 的铸键逐字是「ms → 秒**向上取整**、**下限 1**」⇒ 真供给里不存在 0 / 负数 / 小数;
- *   · 放行 `0` 就是对端说「立刻重试」,而 resume 是 AT-MOST-ONCE 的**有副作用**动作(叫醒 = 真跑
- *     一轮)—— 一个 0 会把「等一会儿」变成热循环;
- *   · 放行小数会让端渲出「等 0.4 秒」这种上游从未说过的量。
- * ⇒ 壳提货后在这三形上的**行为会变**(从「渲一个 0 秒等待」变成「不渲等待行」),这是**修好**
- * 不是回归([verdict-must-accept-stronger-form])。
- *
- * ── 开集纪律(与 cli 那份逐字同律)────────────────────────────────────────────────────────
- * 🔴 判型是**闭集**的(只认下面两个码),消费面是**开集**的:不认识的码一律 `null` ⇒ 端一个字
- *    都不补 ⇒ 机器可读那一行(`API Error: <status> <errorCode> · <msg>`)原样上屏。
- *    **绝不按前缀/子串猜一族码的语义** —— `resume.` 前缀下同时住着「等就好」「换参数」「没救了」
- *    三种处置。
- * 🔴 文案**不复述** server 的 message(那一行已经在屏上了),只补 message 里没有的那件事。
- * 🔴 文案里**不铸等待的秒数**:那一行由端用 {@link ResumeRefusalDetail.retryAfterSec} 单独渲
- *    (cli 的 `retryAfterHint` 是那一位的唯一取值口),在这里再说一遍就是同一个数字上屏两遍。
- */
 import { RESUME_CONTEXT_UNAVAILABLE } from './engineErrorCodes.js';
-/**
- * 本模块认识的 resume 拒绝码(**闭集**)—— 「有人话可补」的那两个。
- *
- * 🔴 **冻结数组,不是 `ReadonlySet`**(与 {@link RESUME_RETRY_LATER_CODES} 同一条已定谳的病形):
- *    `ReadonlySet` 只在类型面只读,运行期是一只普通 `Set`,而判定查的就是这个实例 —— 公面上任何
- *    JS 消费者一次 `.add('resume.evicted')` 就能让一条「重开吧」的拒绝挂上「你的决定没被消费」
- *    这句安全声明。冻结数组在运行期真的改不动(ESM 恒 strict:`push` / 下标赋值直接抛)。
- * 🔴 新增成员必须**同批**补文案 + 判据,不许靠前缀放宽。
- */
 export declare const RESUME_REFUSAL_CODES: readonly string[];
-/** {@link resumeRefusalFromError} 的结构化读数。 */
 export interface ResumeRefusalDetail {
-    /** 命中的那一个码({@link RESUME_REFUSAL_CODES} 的成员之一)。 */
     code: string;
-    /**
-     * server 给的**等待秒数**(整数 ∧ ≥1;窄读域与 §21 同律,见模块顶注)。
-     * 🔴 **缺席 = 服务端没给窗**,不是 0、不是「立刻」——绝不渲一个编出来的倒计时
-     *    ([honest-absence-not-fabricated-zero])。`resume.placement_mismatch` 上**恒缺席**
-     *    (server 只在时间性二码上铸这一位);`resume.preflight_rejected` 上按 server 供给。
-     */
     retryAfterSec?: number;
-    /**
-     * **等一会儿再赎有没有用**(处置位;文案据它选第三句)。
-     *
-     * 🔴 **两个码上的 `false` 是两种「不」,别合并读**:
-     *   · `resume.preflight_rejected` 的 `false` = **不可判**(转调 {@link resumeRetryLaterFromError}
-     *     的同名位:core 侧那条 `terminal` 臂与缺省 `retry_later` 臂的判别位只在 message 散文里,
-     *     本包不按文案分臂 ⇒ 只认「server 真给了窗」这条正向证据);
-     *   · `resume.placement_mismatch` 的 `false` = **等没有用**(出路是换参数不是等时间,见该码顶注)。
-     *   两者在文案上落到**不同的第三句**,所以消费端不必自己再分。
-     */
     waitable: boolean;
 }
-/**
- * 被 catch 的错误 → resume 拒绝读数;不是这两个码 ⇒ `null`(绝不误吃别的 4xx)。
- *
- * 🔴 **duck-typed 不 `instanceof`**:三端注入面可能是宿主的裸 fetch、desktop 的 IPC 转投、web 跨
- *    bundle 的 plain object(跨 bundle 同名类是两个类),这些形上 `instanceof` 一律为假而
- *    `errorCode` 恒在。键位**只认 `errorCode`**([2055] 死键纪律,退役 `code` 槽不做兼容)。
- * 🔴 **判据只有 `errorCode`,不看 HTTP 数字**(与 §21 同口径):`resume.*` 那一族成员全是 409,
- *    按数字分支等于把几种不同处置压成一种。
- * 🔴 **`preflight_rejected` 的窗与可等性全部转调 §21 那一口**,本文件不复制判定。
- */
 export declare function resumeRefusalFromError(err: unknown): ResumeRefusalDetail | null;
-/**
- * 结构化读数 → 人话补充行(`·` 分段,与端上 quota / scenario 两个兄弟同形)。
- *
- * 三句的分工固定:①**发生了什么**(用户看得懂的那句)· ②**这次拒绝有没有消费掉你的决定**
- * (安全声明,两条臂都成立时才敢说)· ③**接下来怎么办 / 还能不能再决**。
- *
- * 🔴 第三句由 {@link ResumeRefusalDetail.waitable} 选,**不由 message 文本选**:按上游散文分支
- *    正是「上游改一个词、壳的判定静默空转」的形(wire 锚契约门要挡的就是它)。
- * 🔴 `preflight_rejected` 且 `waitable === false` 时说的是**两条臂都为真**的那句;`waitable === true`
- *    时 server 真给了窗 ——那是 `retry_later` 臂的**充分证据**(core 的 `terminal` 臂抛的
- *    `CheckpointError` 一个 detail 都不带,窗结构上到不了客户端)⇒ 可以放心说「障碍清掉之后这个
- *    token 还能再赎」。
- *
- * 🔴 **三句每一句都必须自足**(0.60.0 修;上游候包件 ①):无窗那一句此前写的是「The engine line
- *    above says whether this token can still be redeemed」—— 它把答案**外包给了屏上另一行**,而
- *    那一行只有 **turn 级**报错路径才有。同一份文案在**决断路径**(审批卡 decide 的 409)上也照发,
- *    那条路上引擎原文按凭证纪律**根本不上屏** ⇒ 用户读到的是一句指向不存在的东西的指路话。
- *    ⇒ 措辞改成只陈述**本读面自己知道的事实**(「引擎没给窗,所以这次拒绝没说它还能不能再赎」),
- *    在两条路上都为真。**不是**把那句话删掉换成沉默:「不知道」本身就是用户要的答案之一
- *    ([honest-absence-not-fabricated-zero])。
- */
 export declare function resumeRefusalContent(detail: ResumeRefusalDetail): string;
-/** reopen 族的结构化读数:`reason` = 码去掉 `resume.` 前缀(端按它分臂渲原因);`retriable` 恒 true(族的定义)。 */
 export interface ResumeReopenDetail {
     code: string;
     reason: 'env_failed' | 'tool_unavailable' | 'tool_contract_mismatch';
     retriable: true;
 }
-/**
- * 只认 `errorCode`(退役 `code` 槽不做兼容,[2055] 死键纪律);同族别码 / 非对象 ⇒ null。
- * 🔴 **还必须 `retriable === true`**(异源复审实抓):server 只在 store **复核**过 checkpoint 真重开之后才铸
- *    `retriable: true`(resume-legs.ts `checkpointReopened`,头注逐字「never inferred from the code alone」);同一个码也可能
- *    出现在 reopen 本身失败、checkpoint 已 resolved 的终局失败上(那时没有 `retriable`)。凭码就说「卡仍 pending、决定没被消费」
- *    = 替 server 编一句安全声明。⇒ 缺席 / false ⇒ null(端走通用拒绝面,不渲再 park 文案)。
- */
 export declare function resumeReopenFromError(err: unknown): ResumeReopenDetail | null;
-/**
- * 三句 ` · ` 分段(与 quota / scenario / refusal 三个兄弟同形):原因 / 安全声明 / 出路。
- * 🔴 零内部车道词(DS-04):只说用户能做的事;不复述 server 的 message(那一行已在屏上)。
- */
 export declare function resumeReopenContent(detail: ResumeReopenDetail): string;
-/** {@link resumeContextUnavailableFromError} 的结构化读数。 */
 export interface ResumeContextUnavailableDetail {
-    /** 恒为 {@link RESUME_CONTEXT_UNAVAILABLE}(留字段是为了与本文件其它读数同形,消费端可按 `code` 分派)。 */
     code: typeof RESUME_CONTEXT_UNAVAILABLE;
-    /**
-     * 该部署当下的会话保留时长(整数秒;server 逐字 = `REAP_RUN_STALE_SEC` 真值,与回收器用的是同一个值)。
-     * 🔴 窄读域 = 整数 ∧ ≥1(与 `retryAfterSec` 同律);坏值**降缺席**不降 0。
-     * 🔴 缺席 = **没读到**:老 server(<7.80.1)不铸这一位,**sdk 9.6.0 也还没把它带到错误对象上**
-     *    (`ConflictError` 只带 activeTaskId 三件)⇒ 经 sdk 的端今天恒缺席;这不是「保留时长为零」,
-     *    端渲「部署保留时长」那一行时缺席就**不渲**([honest-absence-not-fabricated-zero])。
-     */
     staleAfterSec?: number;
-    /** 这条 run 的 id(体上既有键;非空串才在场)—— 出路①「自己恢复这条 run」用的句柄。缺席同上(sdk 未带)。 */
     runId?: string;
 }
-/**
- * 被 catch 的错误 → 「批准无处投递:上下文当前不可用」读数;不是本码 ⇒ `null`(绝不误吃别的 `conflict.*`)。
- *
- * 🔴 duck-typed 不 `instanceof`、键位只认 `errorCode`(与 {@link resumeRefusalFromError} 同律;退役 `code` 槽不做兼容)。
- * 🔴 **本码不进两个 resume 闭集**:server 在上下文被回收 **或读取失败** 时都发它,能不能等 wire 上没有判别位 ⇒ 不进「可等」集;
- *    也不是「换参数重来」⇒ 不进 refusal 集;出路见文案第三句(按 `runId` 在场与否)。
- * 🔴 `staleAfterSec` / `runId` 都按结构读:server 铸在体上、sdk 今天没搬上来 ⇒ 缺席;sdk 出键当天自动填满,本包零改动。
- */
 export declare function resumeContextUnavailableFromError(err: unknown): ResumeContextUnavailableDetail | null;
-/**
- * 读数 → 人话三句(`·` 分段,与 {@link resumeRefusalContent} 同形):①发生了什么 · ②你的决定没被消费 · ③出路。
- * 🔴 **只凭码不推断原因**(异源对抗复审实抓):server 在「上下文被回收」与「上下文读取失败(如存储故障)」两种情况下
- *    都返回本码,wire 上没有判别位 ⇒ 第一句只说「当前没有可用的上下文来继续它」,不说「等得太久 / 已被回收」。
- * 🔴 **调大保留时长救不回这一次**(上下文已删就是删了),它只能避免以后再发生 ⇒ 第三句按 `runId` 在场与否给恢复指引,
- *    保留时长只作预防句。零内部车道词;{@link ResumeContextUnavailableDetail.staleAfterSec} 在场时第三句**带原数**
- *    (0.72.9 CC-45:此前留给端渲而端没渲 ⇒ 有数必渲),缺席就不渲、不编。
- */
 export declare function resumeContextUnavailableContent(d: ResumeContextUnavailableDetail): string;

package/dist/resumeRefusalCopy.js

@@ -1,68 +1,9 @@
-/**
- * src/resumeRefusalCopy.ts — resume 族**拒绝文案的三端单一铸点**(L-102 下半场,0.58.0)。
- *
- * ── 这一件上收的是什么 ──────────────────────────────────────────────────────────────────────
- * 0.57.0 已经把 L-102 的**事实读数**上收了({@link resumeRetryLaterFromError}:命中哪个码、
- * server 给没给窗、等一会儿有没有用)。留在壳里的另一半是**人话** —— cli 1.0.x 的
- * `src/sema/resumeRefusalCopy.ts` 自铸了一份判型 + 三句 `·` 分段文案,而 web-client / desktop
- * 各自要么没有、要么将来会再抄一份。三端各抄一份文案 = 同一次拒绝在三个端上说三句不一样的话,
- * 而这三句话回答的是**同一个安全问题**:「这次拒绝有没有消费掉我的决定 / 这张卡还能不能再决」。
- * ⇒ 文案与判型同属**判定归包、呈现归端**里的「判定」那一半,本模块是它的单一铸点。
- *
- * ── 与 0.57.0 §21 那一口的分工(两个闭集刻意分家)──────────────────────────────────────────
- * · {@link RESUME_RETRY_LATER_CODES}(engineErrorCodes.ts,0.57.0)闭的是「**server 在哪些码上铸
- *   `retryAfterSec`**」——它回答**能不能等**;
- * · {@link RESUME_REFUSAL_CODES}(本文件)闭的是「**哪些 resume 拒绝有人话可补**」——它回答
- *   **该对人说什么**。
- * 两集**交于** `resume.preflight_rejected` 一码、**各有**一个独占成员
- * (`resume.usage_window_exhausted` 只在前者 / `resume.placement_mismatch` 只在后者),所以它们
- * 不是同一张表的两个名字。🔴 **本模块不复制判定**:`preflight_rejected` 的窗与可等性一律**转调**
- * `resumeRetryLaterFromError`,本文件里没有第二个 `retryAfterSec` 窄读器
- * ([paired-mechanisms-must-share-premise]:两处各自判必然在某一格上分叉)。
- *
- * ── `retryAfterSec` 的窄读域比 cli 1.0.x 现行的更窄(端提货时要知道的差分)──────────────────
- * cli 那份自铸读器收的是「有限数 ∧ ≥0」;本口沿用 §21 的域 =「**整数 ∧ ≥1**」,坏值一律降缺席:
- *   · server 的铸键逐字是「ms → 秒**向上取整**、**下限 1**」⇒ 真供给里不存在 0 / 负数 / 小数;
- *   · 放行 `0` 就是对端说「立刻重试」,而 resume 是 AT-MOST-ONCE 的**有副作用**动作(叫醒 = 真跑
- *     一轮)—— 一个 0 会把「等一会儿」变成热循环;
- *   · 放行小数会让端渲出「等 0.4 秒」这种上游从未说过的量。
- * ⇒ 壳提货后在这三形上的**行为会变**(从「渲一个 0 秒等待」变成「不渲等待行」),这是**修好**
- * 不是回归([verdict-must-accept-stronger-form])。
- *
- * ── 开集纪律(与 cli 那份逐字同律)────────────────────────────────────────────────────────
- * 🔴 判型是**闭集**的(只认下面两个码),消费面是**开集**的:不认识的码一律 `null` ⇒ 端一个字
- *    都不补 ⇒ 机器可读那一行(`API Error: <status> <errorCode> · <msg>`)原样上屏。
- *    **绝不按前缀/子串猜一族码的语义** —— `resume.` 前缀下同时住着「等就好」「换参数」「没救了」
- *    三种处置。
- * 🔴 文案**不复述** server 的 message(那一行已经在屏上了),只补 message 里没有的那件事。
- * 🔴 文案里**不铸等待的秒数**:那一行由端用 {@link ResumeRefusalDetail.retryAfterSec} 单独渲
- *    (cli 的 `retryAfterHint` 是那一位的唯一取值口),在这里再说一遍就是同一个数字上屏两遍。
- */
 import { RESUME_CONTEXT_UNAVAILABLE, RESUME_PLACEMENT_MISMATCH, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_ENV_FAILED, RESUME_TOOL_UNAVAILABLE, } from './engineErrorCodes.js';
 import { resumeRetryLaterFromError } from './wireErrorTriage.js';
-/**
- * 本模块认识的 resume 拒绝码(**闭集**)—— 「有人话可补」的那两个。
- *
- * 🔴 **冻结数组,不是 `ReadonlySet`**(与 {@link RESUME_RETRY_LATER_CODES} 同一条已定谳的病形):
- *    `ReadonlySet` 只在类型面只读,运行期是一只普通 `Set`,而判定查的就是这个实例 —— 公面上任何
- *    JS 消费者一次 `.add('resume.evicted')` 就能让一条「重开吧」的拒绝挂上「你的决定没被消费」
- *    这句安全声明。冻结数组在运行期真的改不动(ESM 恒 strict:`push` / 下标赋值直接抛)。
- * 🔴 新增成员必须**同批**补文案 + 判据,不许靠前缀放宽。
- */
 export const RESUME_REFUSAL_CODES = Object.freeze([
     RESUME_PLACEMENT_MISMATCH,
     RESUME_PREFLIGHT_REJECTED,
 ]);
-/**
- * 被 catch 的错误 → resume 拒绝读数;不是这两个码 ⇒ `null`(绝不误吃别的 4xx)。
- *
- * 🔴 **duck-typed 不 `instanceof`**:三端注入面可能是宿主的裸 fetch、desktop 的 IPC 转投、web 跨
- *    bundle 的 plain object(跨 bundle 同名类是两个类),这些形上 `instanceof` 一律为假而
- *    `errorCode` 恒在。键位**只认 `errorCode`**([2055] 死键纪律,退役 `code` 槽不做兼容)。
- * 🔴 **判据只有 `errorCode`,不看 HTTP 数字**(与 §21 同口径):`resume.*` 那一族成员全是 409,
- *    按数字分支等于把几种不同处置压成一种。
- * 🔴 **`preflight_rejected` 的窗与可等性全部转调 §21 那一口**,本文件不复制判定。
- */
 export function resumeRefusalFromError(err) {
     if (typeof err !== 'object' || err === null)
         return null;
@@ -70,13 +11,9 @@ export function resumeRefusalFromError(err) {
     if (typeof code !== 'string' || !RESUME_REFUSAL_CODES.includes(code))
         return null;
     if (code === RESUME_PLACEMENT_MISMATCH) {
-        // 时间性闭集里没有本码,也不该有(见该码顶注):无窗、且等一会儿对它毫无用处。
         return { code, waitable: false };
     }
-    // `resume.preflight_rejected` —— 两集的交点,事实读数**只有一个来源**。
     const timed = resumeRetryLaterFromError(err);
-    // 🔴 `null` 在今天不可达(本码同在两个闭集里,交点由门双向钉死)。真出现 = 上游把本码移出了
-    //    时间性闭集 ⇒ 「有没有窗」这件事**本包不再知道**,按诚实缺席读作不可判,绝不自己再判一次。
     if (timed === null)
         return { code, waitable: false };
     return {
@@ -85,27 +22,6 @@ export function resumeRefusalFromError(err) {
         ...(timed.retryAfterSec !== undefined ? { retryAfterSec: timed.retryAfterSec } : {}),
     };
 }
-/**
- * 结构化读数 → 人话补充行(`·` 分段,与端上 quota / scenario 两个兄弟同形)。
- *
- * 三句的分工固定:①**发生了什么**(用户看得懂的那句)· ②**这次拒绝有没有消费掉你的决定**
- * (安全声明,两条臂都成立时才敢说)· ③**接下来怎么办 / 还能不能再决**。
- *
- * 🔴 第三句由 {@link ResumeRefusalDetail.waitable} 选,**不由 message 文本选**:按上游散文分支
- *    正是「上游改一个词、壳的判定静默空转」的形(wire 锚契约门要挡的就是它)。
- * 🔴 `preflight_rejected` 且 `waitable === false` 时说的是**两条臂都为真**的那句;`waitable === true`
- *    时 server 真给了窗 ——那是 `retry_later` 臂的**充分证据**(core 的 `terminal` 臂抛的
- *    `CheckpointError` 一个 detail 都不带,窗结构上到不了客户端)⇒ 可以放心说「障碍清掉之后这个
- *    token 还能再赎」。
- *
- * 🔴 **三句每一句都必须自足**(0.60.0 修;上游候包件 ①):无窗那一句此前写的是「The engine line
- *    above says whether this token can still be redeemed」—— 它把答案**外包给了屏上另一行**,而
- *    那一行只有 **turn 级**报错路径才有。同一份文案在**决断路径**(审批卡 decide 的 409)上也照发,
- *    那条路上引擎原文按凭证纪律**根本不上屏** ⇒ 用户读到的是一句指向不存在的东西的指路话。
- *    ⇒ 措辞改成只陈述**本读面自己知道的事实**(「引擎没给窗,所以这次拒绝没说它还能不能再赎」),
- *    在两条路上都为真。**不是**把那句话删掉换成沉默:「不知道」本身就是用户要的答案之一
- *    ([honest-absence-not-fabricated-zero])。
- */
 export function resumeRefusalContent(detail) {
     const parts = [];
     if (detail.code === RESUME_PLACEMENT_MISMATCH) {
@@ -118,18 +34,10 @@ export function resumeRefusalContent(detail) {
     parts.push('The refusal happened before the commit — your decision was not consumed');
     parts.push(detail.waitable
         ? 'The engine supplied a wait, so this token stays redeemable once the obstacle clears'
-        : // 🔴 自足措辞(见函数顶注):只说本读面知道的事 —— 引擎没给窗,所以这次拒绝**没有**表态
-            // 这个 token 还能不能再赎。绝不指向「上面那一行」(决断路径上没有那一行)。
+        :
             'The engine supplied no wait, so this refusal does not say whether the token stays redeemable');
     return parts.join(' · ');
 }
-/**
- * 只认 `errorCode`(退役 `code` 槽不做兼容,[2055] 死键纪律);同族别码 / 非对象 ⇒ null。
- * 🔴 **还必须 `retriable === true`**(异源复审实抓):server 只在 store **复核**过 checkpoint 真重开之后才铸
- *    `retriable: true`(resume-legs.ts `checkpointReopened`,头注逐字「never inferred from the code alone」);同一个码也可能
- *    出现在 reopen 本身失败、checkpoint 已 resolved 的终局失败上(那时没有 `retriable`)。凭码就说「卡仍 pending、决定没被消费」
- *    = 替 server 编一句安全声明。⇒ 缺席 / false ⇒ null(端走通用拒绝面,不渲再 park 文案)。
- */
 export function resumeReopenFromError(err) {
     if (typeof err !== 'object' || err === null)
         return null;
@@ -141,10 +49,6 @@ export function resumeReopenFromError(err) {
     const reason = code.slice('resume.'.length);
     return { code, reason, retriable: true };
 }
-/**
- * 三句 ` · ` 分段(与 quota / scenario / refusal 三个兄弟同形):原因 / 安全声明 / 出路。
- * 🔴 零内部车道词(DS-04):只说用户能做的事;不复述 server 的 message(那一行已在屏上)。
- */
 export function resumeReopenContent(detail) {
     const first = detail.code === RESUME_ENV_FAILED
         ? 'The execution environment for this parked work could not be brought back'
@@ -157,14 +61,6 @@ export function resumeReopenContent(detail) {
         'Re-fetch the pending approvals and decide again on an engine where the same tool is available',
     ].join(' · ');
 }
-/**
- * 被 catch 的错误 → 「批准无处投递:上下文当前不可用」读数;不是本码 ⇒ `null`(绝不误吃别的 `conflict.*`)。
- *
- * 🔴 duck-typed 不 `instanceof`、键位只认 `errorCode`(与 {@link resumeRefusalFromError} 同律;退役 `code` 槽不做兼容)。
- * 🔴 **本码不进两个 resume 闭集**:server 在上下文被回收 **或读取失败** 时都发它,能不能等 wire 上没有判别位 ⇒ 不进「可等」集;
- *    也不是「换参数重来」⇒ 不进 refusal 集;出路见文案第三句(按 `runId` 在场与否)。
- * 🔴 `staleAfterSec` / `runId` 都按结构读:server 铸在体上、sdk 今天没搬上来 ⇒ 缺席;sdk 出键当天自动填满,本包零改动。
- */
 export function resumeContextUnavailableFromError(err) {
     if (typeof err !== 'object' || err === null)
         return null;
@@ -180,19 +76,7 @@ export function resumeContextUnavailableFromError(err) {
         ...(runId !== undefined ? { runId } : {}),
     };
 }
-/**
- * 读数 → 人话三句(`·` 分段,与 {@link resumeRefusalContent} 同形):①发生了什么 · ②你的决定没被消费 · ③出路。
- * 🔴 **只凭码不推断原因**(异源对抗复审实抓):server 在「上下文被回收」与「上下文读取失败(如存储故障)」两种情况下
- *    都返回本码,wire 上没有判别位 ⇒ 第一句只说「当前没有可用的上下文来继续它」,不说「等得太久 / 已被回收」。
- * 🔴 **调大保留时长救不回这一次**(上下文已删就是删了),它只能避免以后再发生 ⇒ 第三句按 `runId` 在场与否给恢复指引,
- *    保留时长只作预防句。零内部车道词;{@link ResumeContextUnavailableDetail.staleAfterSec} 在场时第三句**带原数**
- *    (0.72.9 CC-45:此前留给端渲而端没渲 ⇒ 有数必渲),缺席就不渲、不编。
- */
 export function resumeContextUnavailableContent(d) {
-    // 0.72.9 CC-45(cli L-383 / test [7516] N-G10):**有数必渲、无数不编**。0.72.1 曾把秒数留给端「单独渲」而端没渲 ⇒ 补充句永无
-    //    保留秒数;归层改为本句直接带原数(整数秒,读口已窄读),缺席时本句逐字同 0.72.1。
-    //    🔴 措辞铸点是最后一关(opus 替补复审 [low]):公面函数入参可被手工构造,`0` / 非整数 / 巨数与读口同一判据(整数 ∧ ≥1)才渲,
-    //    否则不渲 —— 绝不渲「0 秒」这种看起来像答案的空壳。
     const sec = d.staleAfterSec;
     const retention = typeof sec === 'number' && Number.isSafeInteger(sec) && sec >= 1 ? `(本部署的会话保留时长为 ${sec} 秒)` : '';
     const third = (d.runId !== undefined

package/dist/retainBackgroundWireCaps.d.ts

@@ -1,51 +1,3 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/retainBackgroundWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/retainBackgroundWireCaps.ts — PURE projection: the shell's "retain background processes past
- * task teardown" opt-in → the TOP-LEVEL `TaskRequest.retainBackgroundProcesses` boolean the SERVICE consumes
- * (spec-fields.js `retainBackgroundProcessesFromBody`: `raw !== true` ⇒ dropped;requirePrincipal 多租户形
- * 服务端另有门)。Mirrors selfOrchestrationWireCaps(the verified top-of-body wire pattern)。
- *
- * 背景([1046] 核谳,TB [991]② reap 族):core 直跑腿(sema-tb)出厂显式
- * `retainBackgroundProcesses:true`(design/128 T1-1——「交付存活服务」任务的 verifier 在进程退出后
- * 才连接),而组合腿产品曾默认关 ⇒ 两腿在 reap 族不是同一场考试。
- *
- * ⚠️ 缺省已翻转为 ON(clay 亲报「后台 shell 命令跑到一半被杀」案,2026-07-26;[1046]④ 的裁量件本次
- * 由真实场景需求兑现)。缺省不发时,引擎 turn finally 的**两道门**都关着:
- *   ① `settleKilledForOwner({retainProcesses})` 的 retain 豁免;
- *   ② `retainBgBySpec = spec.retainBackgroundProcesses === true && !ownedEnvDying` —— 为真才整块跳过
- *      `bgEnv.disposeBackgroundShells(...)`(该 blanket sweep 不经 task-registry,故被它收掉的任务
- *      `stopSource` 为空,终态归因落到 `stoppedBy = "system"` 缺省 = clay 观察到的 `stopped-by: system`)。
- *
- * 三问(宪法 NO-SHIP 检查):
- *   谁需要:真人用户 —— `run_in_background` 起的构建/测试/服务在当轮结束后必须还活着,否则
- *           BashOutput/TaskOutput 续读到的是尸体(clay 案:输出文件 0 字节 + status killed)。
- *   谁受害:隔离执行环境(e2b/k8s/ssh 等 `isIsolated(env)`)—— 那里 `ownedEnvDying` 为真,retain 被
- *           **无条件覆盖**(core 侧 `!opts.envDying` / `&& !ownedEnvDying`),进程随宿主一起走。这是
- *           正确的:进程宿主没了,留 handle 无意义。故本翻转对隔离腿零语义变化。
- *           次级受害面 = 本机资源泄漏(后台进程活过当轮)—— 但这正是 CC 的既定契约,不是回归。
- *   补偿机制:`SEMA_RETAIN_BACKGROUND=0|false|no|off` 逃生口 ⇒ 不 stamp ⇒ 回引擎缺省 reap;
- *           进程始终可由 KillShell/TaskStop 显式收,`/bashes` 面板可见可停;引擎 hard-wall
- *           (defaultBgTimeoutSec 30min / maxBgTimeoutSec 2h)仍是兜底上限。
- *
- * CC 逐字锚(对标纲领 = 100% 达 CC 效果):CC 的 Bash `run_in_background` 契约 = 进程活过当轮,
- * 由 BashOutput 续读、KillShell 显式收 —— **不在 turn 边界回收**。缺省 reap 是对 CC 的偏离,本次钉回。
- *
- * 语义:缺省 ON —— unset / 未识别值 ⇒ `true`(stamp);显式 truthy(1/true/yes/on)⇒ `true`;
- * 只有显式 falsy(0/false/no/off)⇒ `undefined`(不 stamp ⇒ 引擎缺省 reap)。
- * 服务端 `retainBackgroundProcessesFromBody` 是 `raw !== true ⇒ 丢弃` 的严格刻度,所以 opt-out 一律
- * 表达为**不 stamp**,绝不发 `false`(形状诚实)。
- * PURE — callers pass `env`;caller gates to LIVE mode(mock request shape 不变)。
- */
 import { type EnvLike } from './hostEnv.js';
-/** The env key the shell reads(SEMA_ 命名空间,与引擎自己的 spec∨env 通道正交——这里是壳→
- *  TaskRequest 的 per-request 意图面,非引擎部署面)。 */
 export declare const RETAIN_BACKGROUND_ENV: "SEMA_RETAIN_BACKGROUND";
-/**
- * ENV source → `true`(缺省 ON = CC `run_in_background` 契约:后台进程活过当轮),
- * 只有显式 falsy 逃生口({@link envFlagOff} 拼写集,REF-CC-141 dup-02 单源)⇒ `undefined`
- * (不 stamp ⇒ 引擎缺省 reap)。返回型刻意是 `true | undefined` —— 服务端 `raw !== true ⇒ 丢弃`,
- * opt-out 只能表达为「不 stamp」。
- */
 export declare function retainBackgroundFromEnv(env?: EnvLike): true | undefined;

package/dist/retainBackgroundWireCaps.js

@@ -1,54 +1,6 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/retainBackgroundWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/retainBackgroundWireCaps.ts — PURE projection: the shell's "retain background processes past
- * task teardown" opt-in → the TOP-LEVEL `TaskRequest.retainBackgroundProcesses` boolean the SERVICE consumes
- * (spec-fields.js `retainBackgroundProcessesFromBody`: `raw !== true` ⇒ dropped;requirePrincipal 多租户形
- * 服务端另有门)。Mirrors selfOrchestrationWireCaps(the verified top-of-body wire pattern)。
- *
- * 背景([1046] 核谳,TB [991]② reap 族):core 直跑腿(sema-tb)出厂显式
- * `retainBackgroundProcesses:true`(design/128 T1-1——「交付存活服务」任务的 verifier 在进程退出后
- * 才连接),而组合腿产品曾默认关 ⇒ 两腿在 reap 族不是同一场考试。
- *
- * ⚠️ 缺省已翻转为 ON(clay 亲报「后台 shell 命令跑到一半被杀」案,2026-07-26;[1046]④ 的裁量件本次
- * 由真实场景需求兑现)。缺省不发时,引擎 turn finally 的**两道门**都关着:
- *   ① `settleKilledForOwner({retainProcesses})` 的 retain 豁免;
- *   ② `retainBgBySpec = spec.retainBackgroundProcesses === true && !ownedEnvDying` —— 为真才整块跳过
- *      `bgEnv.disposeBackgroundShells(...)`(该 blanket sweep 不经 task-registry,故被它收掉的任务
- *      `stopSource` 为空,终态归因落到 `stoppedBy = "system"` 缺省 = clay 观察到的 `stopped-by: system`)。
- *
- * 三问(宪法 NO-SHIP 检查):
- *   谁需要:真人用户 —— `run_in_background` 起的构建/测试/服务在当轮结束后必须还活着,否则
- *           BashOutput/TaskOutput 续读到的是尸体(clay 案:输出文件 0 字节 + status killed)。
- *   谁受害:隔离执行环境(e2b/k8s/ssh 等 `isIsolated(env)`)—— 那里 `ownedEnvDying` 为真,retain 被
- *           **无条件覆盖**(core 侧 `!opts.envDying` / `&& !ownedEnvDying`),进程随宿主一起走。这是
- *           正确的:进程宿主没了,留 handle 无意义。故本翻转对隔离腿零语义变化。
- *           次级受害面 = 本机资源泄漏(后台进程活过当轮)—— 但这正是 CC 的既定契约,不是回归。
- *   补偿机制:`SEMA_RETAIN_BACKGROUND=0|false|no|off` 逃生口 ⇒ 不 stamp ⇒ 回引擎缺省 reap;
- *           进程始终可由 KillShell/TaskStop 显式收,`/bashes` 面板可见可停;引擎 hard-wall
- *           (defaultBgTimeoutSec 30min / maxBgTimeoutSec 2h)仍是兜底上限。
- *
- * CC 逐字锚(对标纲领 = 100% 达 CC 效果):CC 的 Bash `run_in_background` 契约 = 进程活过当轮,
- * 由 BashOutput 续读、KillShell 显式收 —— **不在 turn 边界回收**。缺省 reap 是对 CC 的偏离,本次钉回。
- *
- * 语义:缺省 ON —— unset / 未识别值 ⇒ `true`(stamp);显式 truthy(1/true/yes/on)⇒ `true`;
- * 只有显式 falsy(0/false/no/off)⇒ `undefined`(不 stamp ⇒ 引擎缺省 reap)。
- * 服务端 `retainBackgroundProcessesFromBody` 是 `raw !== true ⇒ 丢弃` 的严格刻度,所以 opt-out 一律
- * 表达为**不 stamp**,绝不发 `false`(形状诚实)。
- * PURE — callers pass `env`;caller gates to LIVE mode(mock request shape 不变)。
- */
 import { hostEnv } from './hostEnv.js';
 import { envFlagOff } from './envFlag.js';
-/** The env key the shell reads(SEMA_ 命名空间,与引擎自己的 spec∨env 通道正交——这里是壳→
- *  TaskRequest 的 per-request 意图面,非引擎部署面)。 */
 export const RETAIN_BACKGROUND_ENV = 'SEMA_RETAIN_BACKGROUND';
-/**
- * ENV source → `true`(缺省 ON = CC `run_in_background` 契约:后台进程活过当轮),
- * 只有显式 falsy 逃生口({@link envFlagOff} 拼写集,REF-CC-141 dup-02 单源)⇒ `undefined`
- * (不 stamp ⇒ 引擎缺省 reap)。返回型刻意是 `true | undefined` —— 服务端 `raw !== true ⇒ 丢弃`,
- * opt-out 只能表达为「不 stamp」。
- */
 export function retainBackgroundFromEnv(env = hostEnv()) {
     return envFlagOff(env[RETAIN_BACKGROUND_ENV]) ? undefined : true;
 }