@sema-agent/client-core 0.101.0 → 0.103.0

package/dist/request/taskRequest.js

@@ -1,7 +1,8 @@
 import { appendOwnElement, readOwnDataValue } from '../ownKey.js';
 import { refuseBadDisableSkills, refuseDisableSkillsConflict } from '../disableSkillsWire.js';
 import { ATTACHMENTS_SPEC_KEYS, AttachmentsSpecRefused } from '../attachmentsWireCaps.js';
-import { retiredAttachmentsKeyOf } from '../taskRequestWords.js';
+import { REASONING_EFFORT_WORDS, retiredAttachmentsKeyOf } from '../taskRequestWords.js';
+import { THINKING_LATCH_SET_STATES } from '../thinkingLatchWords.js';
 import { msg, renderMessage } from '../i18n/translate.js';
 import { PROJECT_MEMORY_DISABLED } from '../projectMemory.js';
 import { frameFamiliesJudgementOf } from '../approvalFrameFamilies.js';
@@ -20,7 +21,7 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'selfOrchestration', lanes: ['interactive', 'print'], live: true, why: 'SEMA_SELF_ORCHESTRATION opt-in → core 挂 run_workflow', whyUtilityLane: '无座:它挂的是编排工具,与零工具面直接矛盾' },
     { field: 'deferTools', lanes: ['interactive', 'print'], live: true, why: '[1052]① Workflow 延迟披露;selfOrchestration 前置门', whyUtilityLane: '无座:工具延迟披露是工具面的位,零工具面上没有对象' },
     { field: 'retainBackgroundProcesses', lanes: ['interactive', 'print'], live: true, why: '缺省 ON(2026-07-26 起翻转);SEMA_RETAIN_BACKGROUND=0 逃生', whyUtilityLane: '无座:后台进程是工具面的产物,零工具面产不出' },
-    { field: 'promptProfile', lanes: ['interactive', 'print'], live: true, why: 'core 1.328 呈现轴 A/B 口,缺省不 stamp = 引擎缺省 simple', whyUtilityLane: '无座:呈现轴是用户会话的偏好;side-channel 的系统提示由壳整段给出(见 systemPrompt 那一行),不再借呈现轴调形' },
+    { field: 'promptLean', lanes: ['interactive', 'print'], live: true, why: '提示词形轴(0.103.0 起布尔,取代退役的两词形轴键;sdk 28 / 服务端 7.137.0):缺省不 stamp = 目录缺省;映射单铸点 promptLeanFromEnv', whyUtilityLane: '无座:提示词形是用户会话的偏好;side-channel 的系统提示由壳整段给出(见 systemPrompt 那一行),不再借形轴调形' },
     { field: 'enableFork', lanes: ['interactive', 'print'], live: true, why: '显式布尔才 stamp([503]② fail-OPEN 教训:off 必须显式)', whyUtilityLane: '无座:分叉是会话面的动作,而 side-channel 提交是一次性的独立会话' },
     { field: 'attachments', lanes: ['interactive', 'print'], live: true, why: 'design/133 + G1 缺省开的 turn 边界 attachment', whyUtilityLane: '无座:turn 边界的附件配置属用户会话;side-channel 提交不带附件' },
     { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地技能目录投影(布局取 CC 同款);两条车道都由 launchRepl 载入面注入', whyUtilityLane: '无座:技能挂的是工具,与零工具面矛盾' },
@@ -38,7 +39,7 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'inheritEnv', lanes: ['interactive', 'print'], live: true, why: '模型驱动的宿主 shell「继承多少用户环境」的**请求级声明**(server 7.106.0 提交体键,两词闭集 "all" / "scrub";`POST /v1/tasks` · `/v1/tasks/stream` · `/v1/runs` 同收,续跑腿重放同判)。两条用户车道都是提交面、都可能在用户机器上跑 shell ⇒ 都能声明。本层两词原样透传、不按车道 / 部署预判(非 host 车道 × "all" 400、托管 × "all" 422 归上游判)。🔴 缺席 = 缺省清洗且清掉本会话上一条声明 ⇒ 要「本会话整份继承」就每个提交都带。🔴 只在服务端版本 ≥ 7.106.0 时发(老 server 对表外键整条 400),值由片段口 `inheritEnvDeclaration` 唯一铸出', whyUtilityLane: '无座:side-channel 强制零工具面(`excludeAllTools`),没有模型驱动的 shell 去继承环境;带上它只会在不认这一键的老服务端上给这条提交多一种 400' },
     { field: 'requireExistingSession', lanes: ['interactive', 'print'], live: true, why: '「只续已有会话」的**请求级断言**(sdk `TaskRequest.requireExistingSession`):`true` 且会话不在 ⇒ 服务端在任何东西跑起来之前拒(会话不在 / 没给会话 id 两形),而**不是**静默新开一个同 id 的空会话;缺席 / `false` = 历史的「找不到就新开」。两条用户车道都有「续某个会话」的入口 ⇒ 都能声明。本层只认字面 `true`(`false` 与缺席同义、不发);非布尔坏值响亮拒(上游对它 400);`true` 而入参没有可续的会话 id ⇒ 装配期按名响亮拒,不留给上游。上游两形的拒绝经 `requireExistingSessionRefusalFromError` 归成一句', whyUtilityLane: '无座:side-channel 每一次提交都走壳另铸的**独立**会话 id(见 sessionId 那一行),从不续任何已有会话 ⇒「必须已存在」对它没有意义,带上去只会让每一次提交都被拒' },
     { field: 'disableSkills', lanes: ['interactive', 'print'], live: true, why: '「这一发一只技能都不装」的**请求级声明**(出厂技能、调用方给的技能、子代定义里的技能一个都不进引擎;其余工具照挂 —— 与 excludeAllTools 是两件事,两键同带各自生效)。两条用户车道都是提交面 ⇒ 都能声明。本层只认字面 true(false 与缺席同义、不发);非布尔坏值响亮拒(上游对它 400);与非空 skills 或任一非空 agents[].skills 同在 ⇒ 装配期按名响亮拒(上游对这一组合 400),兜底层落 agents 之后同判。🔴 只在能力位读数为真时发(老服务端对表外键整条 400),值由片段口 disableSkillsDeclaration 唯一铸出', whyUtilityLane: '无座:同 skills 一行 —— side-channel 是零工具面,装不装技能都无从谈起' },
-    { field: 'finalVerification', lanes: ['print'], live: true, why: 'P1-1 终验:无人值守车道才需要引擎自证;交互 REPL 由人当场看结果。#106 裁 B(让位+告知)后交互面默认关', whyUtilityLane: '无座:终验让引擎再跑一轮自证,而 side-channel 要的是一次小提交的即时答案;「无人值守才需要引擎自证」这条理由在本车道上让位给「小预算优先」' },
+    { field: 'finalVerification', lanes: ['print'], live: true, why: 'P1-1 终验:无人值守车道才需要引擎自证;交互 REPL 由人当场看结果。裁定「让位+告知」后交互面默认关', whyUtilityLane: '无座:终验让引擎再跑一轮自证,而 side-channel 要的是一次小提交的即时答案;「无人值守才需要引擎自证」这条理由在本车道上让位给「小预算优先」' },
     { field: 'limits', lanes: ['print', 'utility'], live: true, why: 'P2-3-b:`-p` 的预算护栏(--max-* flag 族),交互 REPL 由人随时 Esc', whyUtilityLane: '有座:side-channel 必须带预算护栏(墙钟 / 输出 token / 轮数)—— 它同样没有人看着,而且没有后续回合可以中断' },
     { field: 'interactiveTools', lanes: ['print', 'utility'], live: true, why: '[909]B 件3:无人值守 stamp false,从 roster 源头灭掉 AskUserQuestion/plan 门。交互车道 stamp false 等于自废武功', whyUtilityLane: '有座:side-channel 绝不该弹交互问答 / plan 门(没有人在看这条提交)。它与 excludeAllTools 是**两条独立**的收紧声明、在这条车道上**并存**(本车道强制带卸载声明,见 `refuseUtilityWithoutToolUnload`;这一位是它旁边那条「连问都别问」的声明,不是它的降级替身)' },
     { field: 'oneShot', lanes: ['print', 'utility'], live: true, why: 'SDK TaskRequest.oneShot(server ≥7.12.0 消费):`-p` 提交是一次性的——没有后续回合接住异步后台通知,core 据此把「结束回合等通知」指引换成 block-wait;交互车道有后续回合,stamp true 就是谎报。老 worker 静默忽略(开集提交体),故发送侧不设能力位前置门(oneShotWireCaps 头注)', whyUtilityLane: '有座:side-channel 就是一次性提交 —— 没有后续回合接住异步后台通知,引擎据此把「结束回合等通知」换成 block-wait' },
@@ -151,7 +152,7 @@ const INPUT_KEY_ROUTES = {
     selfOrchestration: row('selfOrchestration'),
     deferTools: row('deferTools'),
     retainBackgroundProcesses: row('retainBackgroundProcesses'),
-    promptProfile: row('promptProfile'),
+    promptLean: row('promptLean'),
     enableFork: row('enableFork'),
     attachments: row('attachments'),
     attachmentIds: row('attachmentIds'),
@@ -191,6 +192,8 @@ const INPUT_KEY_ROUTES = {
     allowTools: row('allowTools'),
     hostSettings: { via: 'control' },
     approvalFrameFamiliesReading: { via: 'control' },
+    thinkingLatch: { via: 'control' },
+    reasoningFloor: { via: 'control' },
     settings: { via: 'settings' },
 };
 const HOST_TOP_KEY_ROUTES = {
@@ -202,6 +205,8 @@ const _hostTopKeysPin = [true];
 void _hostTopKeysPin;
 const _projectMemoryWordPin = [true, true];
 void _projectMemoryWordPin;
+const _thinkingLatchWordPin = [true, true];
+void _thinkingLatchWordPin;
 const HOST_TOP_ASK_AFTER = 'memoryCapture';
 const HOST_SETTINGS_SUBKEYS = Object.freeze(HOST_SUPPLIED_KEYS.filter((k) => k.startsWith('settings.')).map((k) => k.slice('settings.'.length)));
 const MINTED_SETTINGS_SUBKEYS = Object.freeze(['approvalFrameFamilies']);
@@ -699,6 +704,15 @@ const refuseBadProjectMemory = (v) => {
         '这一位是「这一次运行别读部署的项目上下文」的收紧声明,引擎是**单成员闭集**(没有第二个词:要照常读就不带这一键)且对坏值拒启。' +
         '本层若静默删键,请求会照发、项目指令文件会照常递给模型,而声明人不会知道自己的 opt-out 丢了。错误文本只报形状,不回显值。');
 };
+const refuseBadThinkingLatch = (v) => {
+    if (v === undefined || v === null)
+        return;
+    if (typeof v === 'string' && THINKING_LATCH_SET_STATES.includes(v))
+        return;
+    throw new TypeError(`buildTaskRequest: thinkingLatch 只接受 ${THINKING_LATCH_SET_STATES.map((w) => `'${w}'`).join(' / ')} 或缺席(undefined/null = 未设)—— 收到 ${coarseShape(v)}。` +
+        '这一位是会话级思考开关的读数(从存储宿主的端口读:readThinkingLatch(port).state;未设就不带这一键):「关」被打字错误静默吞掉,' +
+        '这一发会照档位词思考而关掉开关的人不会知道。错误文本只报形状,不回显值。');
+};
 const refuseBadRequireExistingSession = (v) => {
     if (v === undefined || v === null || v === true || v === false)
         return;
@@ -787,7 +801,7 @@ export function parseMaxCostUsd(text) {
         return { ok: false, why: 'not_positive' };
     return { ok: true, value };
 }
-const ACCESSOR_READ_ORDER = ['live', 'memoryCapture', 'hostSettings', 'settings', 'maxCostUsd', 'excludeAllTools', 'maxTokens', 'outputRetries', 'inheritEnv', 'requireExistingSession', 'disableSkills', 'approvalReach', 'allowTools', 'userInvokedSkills', 'projectMemory'];
+const ACCESSOR_READ_ORDER = ['live', 'memoryCapture', 'hostSettings', 'settings', 'maxCostUsd', 'excludeAllTools', 'maxTokens', 'outputRetries', 'inheritEnv', 'requireExistingSession', 'disableSkills', 'approvalReach', 'allowTools', 'userInvokedSkills', 'projectMemory', 'thinkingLatch'];
 const MATERIALIZE_AT_READ = Object.freeze({ allowTools: (v) => allowToolsSnapshot(v), userInvokedSkills: (v) => allowToolsSnapshot(v) });
 function dataFirstSnapshot(input, afterData) {
     let descs;
@@ -878,6 +892,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
     const approvalReachIn = src.approvalReach;
     const allowToolsIn = src.allowTools;
     const projectMemoryIn = src.projectMemory;
+    const thinkingLatchIn = src.thinkingLatch;
     const INPUT_KEYS = Object.keys(INPUT_KEY_ROUTES);
     const i = snapshotByName(src, INPUT_KEYS, {
         live,
@@ -892,6 +907,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
         approvalReach: approvalReachIn,
         allowTools: allowToolsIn,
         projectMemory: projectMemoryIn,
+        thinkingLatch: thinkingLatchIn,
         settings: settingsIn,
     });
     const SETTINGS_KEYS = Object.keys(SETTINGS_KEY_ROUTES);
@@ -921,6 +937,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
     refuseBadApprovalReach(approvalReachIn, 'buildTaskRequest');
     refuseBadAllowTools(allowToolsIn);
     refuseBadProjectMemory(projectMemoryIn);
+    refuseBadThinkingLatch(thinkingLatchIn);
     refuseBadUserInvokedSkills(i.userInvokedSkills);
     const rewindRoute = INPUT_KEY_ROUTES.rewind;
     const RETIRED_REWIND_FILES_KEY = 'rewindFiles';
@@ -1019,7 +1036,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
             return present(value);
         if (route.via === 'control' || route.via === 'settings')
             return false;
-        const cause = omissionCauseOf(standingOf(route), lane, live, origin);
+        const cause = seatCauseOf(route, lane, live, origin);
         if (!inPlay(key, value))
             return false;
         if (cause === undefined)
@@ -1029,6 +1046,8 @@ export function assembleTaskRequest(input, laneOrIdentity) {
     };
     const gate = Object.create(null);
     const askInput = (key) => {
+        if (key === THINKING_DEFERRED_ASK)
+            return;
         const route = INPUT_KEY_ROUTES[key];
         if (route.via === 'settings') {
             for (const sub of SETTINGS_KEYS)
@@ -1047,8 +1066,16 @@ export function assembleTaskRequest(input, laneOrIdentity) {
     };
     for (const key of INPUT_KEYS.slice(hostTopAt))
         askInput(key);
-    const on = (key) => gate[key] === true;
     const onSetting = (sub) => gate[`settings.${sub}`] === true;
+    const thinking = projectThinkingCore({
+        lane,
+        latch: thinkingLatchIn,
+        strength: i.reasoningEffort,
+        floor: i.reasoningFloor,
+        ultracodeStamped: onSetting('ultracode') && s.ultracode === true,
+    });
+    gate[THINKING_DEFERRED_ASK] = carries(INPUT_KEY_ROUTES[THINKING_DEFERRED_ASK], thinking.word, THINKING_DEFERRED_ASK);
+    const on = (key) => gate[key] === true;
     const settingsOut = {
         ...resolvedWire,
         ...(onSetting('webSearch') ? { webSearch: s.webSearch } : {}),
@@ -1063,7 +1090,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
         sessionId: i.sessionId,
         ...(on('scenario') ? { scenario: i.scenario } : {}),
         ...(on('systemPrompt') ? { systemPrompt: i.systemPrompt } : {}),
-        ...(on('reasoningEffort') ? { reasoningEffort: i.reasoningEffort } : {}),
+        ...(on('reasoningEffort') ? { reasoningEffort: thinking.word } : {}),
         ...(on('model') ? { model: i.model } : {}),
         ...(on('images') ? { images: i.images } : {}),
         ...(on('userAttachments') ? { userAttachments: [...(i.userAttachments ?? [])] } : {}),
@@ -1076,7 +1103,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
         ...(on('selfOrchestration') ? { selfOrchestration: i.selfOrchestration } : {}),
         ...(on('deferTools') ? { deferTools: i.deferTools } : {}),
         ...(on('retainBackgroundProcesses') ? { retainBackgroundProcesses: i.retainBackgroundProcesses } : {}),
-        ...(on('promptProfile') ? { promptProfile: i.promptProfile } : {}),
+        ...(on('promptLean') ? { promptLean: i.promptLean } : {}),
         ...(on('enableFork') ? { enableFork: i.enableFork } : {}),
         ...(on('attachments') ? { attachments: attachmentsForWire } : {}),
         ...(on('repo') ? { repo: i.repo } : {}),
@@ -1107,11 +1134,100 @@ export function assembleTaskRequest(input, laneOrIdentity) {
     const familiesRoute = SETTINGS_KEY_ROUTES.approvalFrameFamilies;
     const familiesSeated = (familiesRoute.via === 'matrix' || familiesRoute.via === 'fixed') && omissionCauseOf(standingOf(familiesRoute), lane, live, origin) === undefined;
     const familiesWithheld = familiesSeated && approvalFamilies === undefined ? Object.freeze({ cause: familiesJudged === undefined || familiesJudged.ok ? 'reading_absent' : familiesJudged.cause }) : undefined;
-    return Object.freeze({ request: out, omitted: Object.freeze([...omitted, ...lateOmitted]), host, ...(familiesWithheld !== undefined ? { approvalFrameFamiliesWithheld: familiesWithheld } : {}) });
+    return Object.freeze({
+        request: out,
+        omitted: Object.freeze([...omitted, ...lateOmitted]),
+        host,
+        ...(familiesWithheld !== undefined ? { approvalFrameFamiliesWithheld: familiesWithheld } : {}),
+        thinking,
+    });
 }
 export function buildTaskRequest(input, laneOrIdentity) {
     return assembleTaskRequest(input, laneOrIdentity).request;
 }
+const THINKING_DEFERRED_ASK = 'reasoningEffort';
+const FLOOR_WORDS = Object.freeze(REASONING_EFFORT_WORDS.filter((w) => w !== 'off'));
+const effortRank = (w) => (typeof w === 'string' ? REASONING_EFFORT_WORDS.indexOf(w) : -1);
+const seatCauseOf = (route, lane, live, origin) => omissionCauseOf(standingOf(route), lane, live, origin);
+const frozenProjection = (p) => Object.freeze(p);
+function projectThinkingCore(c) {
+    const latch = c.latch === 'on' || c.latch === 'off' ? c.latch : 'unset';
+    const ultracodeStamped = c.ultracodeStamped === true;
+    const strength = c.strength;
+    if (c.lane === 'utility')
+        return frozenProjection({ word: strength, verdict: 'utility_lane', latch, ultracodeStamped });
+    if (latch === 'off') {
+        const overruled = present(strength) && strength !== 'off';
+        return frozenProjection({ word: 'off', verdict: 'off', latch, ultracodeStamped, ...(overruled ? { strengthOverruled: strength } : {}) });
+    }
+    let base = strength;
+    let overruledOff = false;
+    if (latch === 'on' && base === 'off') {
+        base = undefined;
+        overruledOff = true;
+    }
+    let floorApplied = false;
+    const floor = c.floor;
+    if (typeof floor === 'string' && FLOOR_WORDS.includes(floor) && base !== 'off') {
+        const baseRank = effortRank(base);
+        if (!present(base) || (baseRank >= 0 && baseRank < effortRank(floor))) {
+            base = floor;
+            floorApplied = true;
+        }
+    }
+    return frozenProjection({
+        word: base,
+        verdict: 'strength',
+        latch,
+        ultracodeStamped,
+        ...(floorApplied ? { floorApplied: true } : {}),
+        ...(overruledOff ? { strengthOverruled: 'off' } : {}),
+    });
+}
+export function thinkingTurnProjection(input) {
+    let submission;
+    let live;
+    let latch;
+    let strength;
+    let floor;
+    let ultracode;
+    try {
+        if (typeof input === 'object' && input !== null) {
+            submission = input.submission;
+            live = input.live;
+            latch = input.latch;
+            strength = input.strength;
+            floor = input.floor;
+            ultracode = input.ultracode;
+        }
+    }
+    catch {
+        submission = live = latch = strength = floor = ultracode = undefined;
+    }
+    let lane;
+    let origin;
+    try {
+        const axes = laneAxesOf(submission, 'seat');
+        lane = axes.lane;
+        origin = axes.origin;
+    }
+    catch {
+        lane = undefined;
+        origin = undefined;
+    }
+    const ultracodeRoute = SETTINGS_KEY_ROUTES.ultracode;
+    let seated = false;
+    try {
+        seated =
+            lane !== undefined &&
+                (ultracodeRoute.via === 'matrix' || ultracodeRoute.via === 'fixed') &&
+                seatCauseOf(ultracodeRoute, lane, live === true, origin) === undefined;
+    }
+    catch {
+        seated = false;
+    }
+    return projectThinkingCore({ lane, latch, strength, floor, ultracodeStamped: seated && inPlay('settings.ultracode', ultracode) && ultracode === true });
+}
 export function applyLiveRequestDefaults(req, host) {
     const out = { ...req };
     if (out.cwd == null && host.cwd !== undefined)

package/dist/retryStatus.d.ts

@@ -11,6 +11,8 @@ export type RetryStatus = {
     providerConditionSource?: string;
     elapsedMs?: number;
     timeoutMs?: number;
+    sleptMs?: number;
+    waitSegment?: BrainStatusWaitSegment | (string & {});
     detail?: string;
 } | {
     kind: 'error';
@@ -26,6 +28,8 @@ export type RetryStatus = {
     error: RetryStatusErrorPayload;
     elapsedMs?: number;
     timeoutMs?: number;
+    sleptMs?: number;
+    waitSegment?: BrainStatusWaitSegment | (string & {});
 } | {
     kind: 'waiting';
     deadline: number;
@@ -38,6 +42,8 @@ export type RetryStatus = {
     providerConditionSource?: string;
     elapsedMs?: number;
     timeoutMs?: number;
+    sleptMs?: number;
+    waitSegment?: BrainStatusWaitSegment | (string & {});
     terminal?: never;
     error: RetryStatusErrorPayload;
 };
@@ -69,8 +75,12 @@ export interface BrainStatusPayload {
     timeoutMs?: number;
     providerCondition?: string;
     providerConditionSource?: string;
+    sleptMs?: number;
+    waitSegment?: BrainStatusWaitSegment | (string & {});
 }
-export declare const BRAIN_STATUS_PAYLOAD_KEYS: readonly ["phase", "detail", "retryInSec", "retryInMs", "attempt", "maxRetries", "errClass", "retryAtMs", "errorStatus", "elapsedMs", "timeoutMs", "providerCondition", "providerConditionSource"];
+export declare const BRAIN_STATUS_WAIT_SEGMENTS: readonly ["response_headers", "first_token"];
+export type BrainStatusWaitSegment = (typeof BRAIN_STATUS_WAIT_SEGMENTS)[number];
+export declare const BRAIN_STATUS_PAYLOAD_KEYS: readonly ["phase", "detail", "retryInSec", "retryInMs", "attempt", "maxRetries", "errClass", "retryAtMs", "errorStatus", "elapsedMs", "timeoutMs", "providerCondition", "providerConditionSource", "sleptMs", "waitSegment"];
 export declare function mapBrainStatusToRetry(p: BrainStatusPayload, nowMs: number): RetryStatus | null;
 export interface RetryStatusArmLike {
     readonly phase?: string;
@@ -86,6 +96,8 @@ export interface RetryStatusArmLike {
     readonly timeoutMs?: number;
     readonly providerCondition?: string;
     readonly providerConditionSource?: string;
+    readonly sleptMs?: number;
+    readonly waitSegment?: string;
     readonly parentToolCallId?: string;
 }
 export declare function retryStatusFromArm(arm: RetryStatusArmLike | null | undefined, nowMs: number): RetryStatus | null | undefined;

package/dist/retryStatus.js

@@ -11,6 +11,9 @@ export const BRAIN_STATUS_PHASES = [
     'gave_up',
     'waiting_first_token',
 ];
+export const BRAIN_STATUS_WAIT_SEGMENTS = Object.freeze(['response_headers', 'first_token']);
+void true;
+void true;
 export const BRAIN_STATUS_PAYLOAD_KEYS = [
     'phase',
     'detail',
@@ -25,6 +28,8 @@ export const BRAIN_STATUS_PAYLOAD_KEYS = [
     'timeoutMs',
     'providerCondition',
     'providerConditionSource',
+    'sleptMs',
+    'waitSegment',
 ];
 const _brainStatusKeyPin = [true, true];
 void _brainStatusKeyPin;
@@ -41,9 +46,11 @@ export function mapBrainStatusToRetry(p, nowMs) {
     const cause = typeof p.errClass === 'string' && p.errClass.length > 0 ? { errClass: p.errClass } : {};
     const producerTiming = typeof p.retryAtMs === 'number' ? { retryAtMs: p.retryAtMs } : {};
     const failureStatus = typeof p.errorStatus === 'number' ? { errorStatus: p.errorStatus } : {};
+    const providerCondition = p.providerCondition;
+    const providerConditionSource = p.providerConditionSource;
     const providerJudged = {
-        ...(typeof p.providerCondition === 'string' && p.providerCondition.length > 0 ? { providerCondition: p.providerCondition } : {}),
-        ...(typeof p.providerConditionSource === 'string' && p.providerConditionSource.length > 0 ? { providerConditionSource: p.providerConditionSource } : {}),
+        ...(typeof providerCondition === 'string' && providerCondition.length > 0 ? { providerCondition } : {}),
+        ...(typeof providerConditionSource === 'string' && providerConditionSource.length > 0 ? { providerConditionSource } : {}),
     };
     const saneMs = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : undefined;
     const elapsedMs = saneMs(p.elapsedMs);
@@ -52,10 +59,16 @@ export function mapBrainStatusToRetry(p, nowMs) {
         ...(elapsedMs !== undefined ? { elapsedMs } : {}),
         ...(timeoutMs !== undefined ? { timeoutMs } : {}),
     };
+    const sleptMs = saneMs(p.sleptMs);
+    const waitSegment = p.waitSegment;
+    const waitFacts = {
+        ...(sleptMs !== undefined ? { sleptMs } : {}),
+        ...(typeof waitSegment === 'string' && waitSegment.length > 0 ? { waitSegment } : {}),
+    };
     const stalledShown = typeof p.detail === 'string' && p.detail.length > 0 ? displayUntrusted(p.detail) : '';
     const stalledDetail = stalledShown.length > 0 ? { detail: stalledShown } : {};
     const shown = (absent) => (typeof p.detail === 'string' ? displayUntrusted(p.detail) : absent);
-    const extra = { ...counts, ...cause, ...producerTiming, ...failureStatus, ...providerJudged, ...waitProgress };
+    const extra = { ...counts, ...cause, ...producerTiming, ...failureStatus, ...providerJudged, ...waitProgress, ...waitFacts };
     switch (p.phase) {
         case 'recovered':
             return null;
@@ -99,8 +112,8 @@ export function retryStatusFromArm(arm, nowMs) {
         const v = str(key);
         return v !== undefined && v.length > 0 ? v : undefined;
     };
-    const [detail, retryInSec, retryInMs, attempt, maxRetries, errClass, retryAtMs, errorStatus, elapsedMs, timeoutMs, providerCondition, providerConditionSource] = [
-        str('detail'), num('retryInSec'), num('retryInMs'), num('attempt'), num('maxRetries'), str('errClass'), num('retryAtMs'), num('errorStatus'), num('elapsedMs'), num('timeoutMs'), word('providerCondition'), word('providerConditionSource'),
+    const [detail, retryInSec, retryInMs, attempt, maxRetries, errClass, retryAtMs, errorStatus, elapsedMs, timeoutMs, providerCondition, providerConditionSource, sleptMs, waitSegment] = [
+        str('detail'), num('retryInSec'), num('retryInMs'), num('attempt'), num('maxRetries'), str('errClass'), num('retryAtMs'), num('errorStatus'), num('elapsedMs'), num('timeoutMs'), word('providerCondition'), word('providerConditionSource'), num('sleptMs'), word('waitSegment'),
     ];
     const phase = str('phase');
     if (phase === undefined)
@@ -119,6 +132,8 @@ export function retryStatusFromArm(arm, nowMs) {
         ...(timeoutMs !== undefined ? { timeoutMs } : {}),
         ...(providerCondition !== undefined ? { providerCondition } : {}),
         ...(providerConditionSource !== undefined ? { providerConditionSource } : {}),
+        ...(sleptMs !== undefined ? { sleptMs } : {}),
+        ...(waitSegment !== undefined ? { waitSegment } : {}),
     }, nowMs);
 }
 const WAIT_SWITCH_FRACTION = 0.5;

package/dist/seam.js

@@ -170,7 +170,7 @@ const CHROME_ARM_TABLE = {
     },
     text_segment_end: {
         required: true,
-        duty: '🔴 引擎明报的 assistant 散文段边界 + **该段权威全文**(#323/core #447;server ≥7.75.3 起 content 经脱敏器、' +
+        duty: '🔴 引擎明报的 assistant 散文段边界 + **该段权威全文**(server ≥7.75.3 起 content 经脱敏器、' +
             'text_delta 仍逐字 ⇒ 两者**可以不相等**)。①`diverged` 在场(never false)⇒ 你按增量拼出来的那一段是过期的,' +
             '必须用 content **重渲该段**并以它为该段 committed 文本,不许保留增量拼文;②`committedPrefixDiverged` 在场' +
             '(never false)⇒ 这一段此前已 committed 上屏的正文**也**过期了,🔴 本包在这一形上**一个字节都不再交**(唯一不同:本段已提交行的归属说不出 —— 上游两行同 uuid,`committedUuids` 整键缺席 —— 时本包一个字节不动,还押着的原始那截在本事件之后照旧作为本段末行交出)' +

package/dist/seatContract.d.ts

@@ -13,6 +13,7 @@ import type { SubagentContentEvent } from "./subagentContentStore.js";
 import type { DeviceEnrollTokenOutcome, DeviceListOutcome, DeviceRebindOutcome, DeviceRevokeOutcome, DeviceSessionBindingOutcome, DeviceTransport, DeviceUnarmed, DeviceUnreadable } from "./deviceRebind.js";
 import type { McpPanelView } from "./mcpPanel.js";
 import type { McpToolToggleKey } from "./mcpToolToggles.js";
+import { type ThinkingLatchEvent, type ThinkingLatchRowWord } from "./thinkingLatchWords.js";
 export interface SeatValidationFailure {
     reason: string;
     field?: string;
@@ -47,6 +48,7 @@ export interface LocalSessionRecord {
     }>;
     parked?: boolean;
     pinned?: boolean;
+    thinkingLatch?: ThinkingLatchRowWord;
 }
 export declare const TOOL_PERMISSION_REQUEST_ID_DOMAINS: readonly ["live:", "durable:", "question:", "elicit:", "plan:"];
 export type ToolPermissionRequestIdDomain = (typeof TOOL_PERMISSION_REQUEST_ID_DOMAINS)[number];
@@ -190,7 +192,7 @@ export type SeatStreamReading = {
 };
 export declare function seatStreamDeltaMessage(event: SeatStreamDeltaSource, ids: SeatStreamDeltaIds): SeatStreamEventMessage | undefined;
 export declare function readSeatStreamDelta(message: object): SeatStreamReading;
-export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles"];
+export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch"];
 export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
 export interface SeatCapabilitiesState {
     pickFolder?: boolean;
@@ -201,6 +203,7 @@ export interface SeatCapabilitiesState {
     engineTarget?: boolean;
     onboard?: boolean;
     mcpToolToggles?: boolean;
+    thinkingLatch?: boolean;
 }
 export type SeatCapabilityReading = {
     readonly kind: "reported";
@@ -304,6 +307,10 @@ export interface SessionRowPatchRequest {
     pinned?: boolean;
 }
 export declare const SESSION_ROW_PATCH_REQUEST_KEYS: readonly ["sessionId", "title", "pinned"];
+export interface SetThinkingLatchRequest {
+    readonly sessionId: string;
+    readonly event: ThinkingLatchEvent;
+}
 export interface AttachmentUploadReceipt {
     id: string;
     name: string;
@@ -630,6 +637,7 @@ export interface LocalSessionsApi {
     readSessionMcpPanel(sessionId: string): Promise<McpPanelView | DeviceUnreadable | DeviceTransport | DeviceUnarmed>;
     listMcpToolToggles(): Promise<McpToolTogglesResult>;
     setMcpToolToggle(key: McpToolToggleKey, enabled: boolean): Promise<OkAck>;
+    setThinkingLatch(req: SetThinkingLatchRequest): Promise<OkAck>;
     onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
     onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
     sessionsStateStore: EipcStoreClient<SessionsState>;
@@ -671,14 +679,16 @@ export declare function checkSendMessageRequest(v: unknown): SeatValidation;
 export declare function isSendMessageRequest(v: unknown): v is SendMessageRequest;
 export declare const checkSessionRowPatchRequest: (v: unknown) => SeatValidation;
 export declare function isSessionRowPatchRequest(v: unknown): v is SessionRowPatchRequest;
+export declare const checkSetThinkingLatchRequest: (v: unknown) => SeatValidation;
+export declare function isSetThinkingLatchRequest(v: unknown): v is SetThinkingLatchRequest;
 export declare function isSendMessageAck(v: unknown): v is SendMessageAck;
 export declare const LOCAL_SESSIONS_SPEC: EipcServiceSpec;
-export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "onEvent", "onToolPermissionRequest"];
+export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "onEvent", "onToolPermissionRequest"];
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore", "engineTargetStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "error", "errorCategory", "code", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome", "_sema_turnFailure", "subagentContent"];
 export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "sessionRow"];
-export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"];
+export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "thinkingLatch"];
 export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario", "rewind"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
     readonly sessionId: {
@@ -728,7 +738,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     readonly LocalSessionRecord: {
         readonly guard: "isLocalSessionRecord";
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"];
+        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "thinkingLatch"];
         readonly unchecked: readonly [];
     };
     readonly ToolPermissionRequest: {
@@ -808,6 +818,12 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly validated: readonly ["sessionId", "title", "pinned"];
         readonly unchecked: readonly [];
     };
+    readonly SetThinkingLatchRequest: {
+        readonly guard: "isSetThinkingLatchRequest";
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["sessionId", "event"];
+        readonly unchecked: readonly [];
+    };
     readonly ApplyModelConfigResult: {
         readonly check: (v: unknown) => SeatValidation;
         readonly validated: readonly ["ok", "requiresRestart", "reason", "detail"];
@@ -861,7 +877,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
     readonly SeatCapabilitiesState: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles"];
+        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch"];
         readonly unchecked: readonly [];
     };
     readonly RecentFoldersResult: {
@@ -907,7 +923,7 @@ export declare const SEAT_VALIDATOR_COVERAGE_EXEMPT: readonly [...{
 }[], {
     readonly label: "PickFolderResult";
     readonly check: (v: unknown) => SeatValidation;
-    readonly why: "载荷是**串或 null**(选中的路径 / 用户取消,CC-469),没有键面 ⇒ `keyof` 覆盖表在它身上无从谈起。判别力由 run-seat-wave2-test.mjs ST1-1 承担:认 null 与非空串、拒空串 / 数 / undefined / 对象 / 布尔五形。";
+    readonly why: "载荷是**串或 null**(选中的路径 / 用户取消,CC-469),没有键面 ⇒ `keyof` 覆盖表在它身上无从谈起。判别力由对应的座位契约测试套承担:认 null 与非空串、拒空串 / 数 / undefined / 对象 / 布尔五形。";
 }, {
     readonly label: "BooleanAck";
     readonly check: (v: unknown) => SeatValidation;