@sema-agent/client-core 0.101.0 → 0.102.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';
@@ -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' },
@@ -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 ?? [])] } : {}),
@@ -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/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;

package/dist/seatContract.js

@@ -5,6 +5,7 @@ import { SETTINGS_MODEL_API_WORDS } from "./generated/settingsSchemaTables.js";
 import { PROBE_VERDICTS } from "./modelCapabilityProbe.js";
 import { guardedRead, ownDataField, ownDataRefusalKeyOf, ownSendableField, readOwnDataValue } from "./ownKey.js";
 import { MCP_LIVENESS_STATES } from "./mcpLiveness.js";
+import { THINKING_LATCH_EVENTS, THINKING_LATCH_ROW_WORDS } from "./thinkingLatchWords.js";
 const bad = (reason, field) => field === undefined ? { reason } : { reason, field };
 const nested = (prefix, verdict) => {
     const path = verdict.field === undefined
@@ -158,6 +159,7 @@ const oneOfRule = (label, words) => ruleOf(label, (v) => typeof v === "string" &
 const R_STR = ruleOf("string", (v) => typeof v === "string");
 const R_NONEMPTY = ruleOf("non-empty string", (v) => typeof v === "string" && v.length > 0);
 const R_BOOL = ruleOf("boolean", (v) => typeof v === "boolean");
+const R_THINKING_LATCH_ROW = oneOfRule("latch word", THINKING_LATCH_ROW_WORDS);
 const R_TRUE = ruleOf("true", (v) => v === true);
 const R_NUM = ruleOf("finite number", (v) => typeof v === "number" && Number.isFinite(v));
 const R_INT0 = ruleOf("non-negative integer", (v) => typeof v === "number" && Number.isSafeInteger(v) && v >= 0);
@@ -354,7 +356,7 @@ export function readSeatStreamDelta(message) {
         return Object.freeze({ kind: "malformed" });
     }
 }
-export const SEAT_CAPABILITY_NAMES = Object.freeze(["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles"]);
+export const SEAT_CAPABILITY_NAMES = Object.freeze(["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch"]);
 const notReported = () => Object.freeze({ kind: "not_reported" });
 const malformedReading = () => Object.freeze({ kind: "malformed" });
 const reported = (available) => Object.freeze({ kind: "reported", available });
@@ -430,6 +432,7 @@ const SEAT_CAPABILITY_PHRASES = Object.freeze({
     engineTarget: Object.freeze({ action: "Switching engines", ability: "switch engines", support: "engine-switching support" }),
     onboard: Object.freeze({ action: "Model setup", ability: "add models", support: "model-setup support" }),
     mcpToolToggles: Object.freeze({ action: "Per-tool switching", ability: "toggle tools", support: "per-tool switches" }),
+    thinkingLatch: Object.freeze({ action: "Switching thinking", ability: "switch thinking", support: "thinking-switch support" }),
 });
 export function seatCapabilityUnavailableDetail(name, reading) {
     const phrase = Object.hasOwn(SEAT_CAPABILITY_PHRASES, name)
@@ -556,6 +559,7 @@ export const SEAT_TURN_SETTINGS_ORIGINS = Object.freeze({
 export const SEAT_REWIND_INTENT_KEYS = ["mode", "targetMessageUuid"];
 export const ATTACHMENT_UPLOAD_REQUEST_KEYS = ["name", "mimeType", "bytes"];
 export const SESSION_ROW_PATCH_REQUEST_KEYS = Object.freeze(["sessionId", "title", "pinned"]);
+const SET_THINKING_LATCH_REQUEST_KEYS = Object.freeze(["sessionId", "event"]);
 export const SESSION_SEARCH_RESULT_KEYS = ["sessionId", "title", "matches"];
 export const GET_TRANSCRIPT_RESULT_KEYS = ["sessionId", "messages"];
 const DEVICE_REFUSED_SPEC = { status: reqF(R_INT0), errorCode: optF(R_STR), message: optF(R_STR) };
@@ -971,6 +975,12 @@ const checkLocalSessionRecord = seatCheck((s) => {
     if (!isAbsent(pinned) && typeof pinned !== "boolean") {
         return bad("pinned must be a boolean when present (absent = not pinned or unknown)", "pinned");
     }
+    const latch = own(s, "thinkingLatch");
+    if (!isAbsent(latch)) {
+        const verdict = R_THINKING_LATCH_ROW.test(latch, "thinkingLatch");
+        if (verdict !== true)
+            return verdict;
+    }
     return true;
 });
 export function isLocalSessionRecord(s) {
@@ -1438,6 +1448,14 @@ export const checkSessionRowPatchRequest = seatCheck((v) => {
 export function isSessionRowPatchRequest(v) {
     return checkSessionRowPatchRequest(v) === true;
 }
+const checkSetThinkingLatchShape = seatShapeCheck(shapeRule("latch request", {
+    sessionId: reqF(R_NONEMPTY),
+    event: reqF(oneOfRule("latch event", THINKING_LATCH_EVENTS)),
+}));
+export const checkSetThinkingLatchRequest = seatCheck((v) => isPlainRecord(v) ? checkSetThinkingLatchShape(v) : bad("setThinkingLatch request is not a plain object"));
+export function isSetThinkingLatchRequest(v) {
+    return checkSetThinkingLatchRequest(v) === true;
+}
 const checkSendMessageAck = seatCheck((v) => {
     if (!isPlainRecord(v))
         return bad("sendMessage ack is not a plain object");
@@ -1609,6 +1627,7 @@ export const LOCAL_SESSIONS_SPEC = {
         readSessionMcpPanel: { kind: "invoke", check: checkSessionMcpPanelResult },
         listMcpToolToggles: { kind: "invoke", check: checkMcpToolTogglesResult },
         setMcpToolToggle: { kind: "invoke", check: checkOkAck },
+        setThinkingLatch: { kind: "invoke", check: checkOkAck },
         onEvent: { kind: "event", check: checkLocalSessionEvent },
         onToolPermissionRequest: { kind: "event", check: checkToolPermissionRequest },
     },
@@ -1656,6 +1675,7 @@ export const SEAT_METHOD_NAMES = [
     "readSessionMcpPanel",
     "listMcpToolToggles",
     "setMcpToolToggle",
+    "setThinkingLatch",
     "onEvent",
     "onToolPermissionRequest",
 ];
@@ -1714,6 +1734,7 @@ export const LOCAL_SESSION_RECORD_KEYS = [
     "queuedMessages",
     "parked",
     "pinned",
+    "thinkingLatch",
 ];
 export const SEND_MESSAGE_REQUEST_KEYS = [
     "sessionId",
@@ -1758,7 +1779,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     LocalSessionRecord: {
         guard: "isLocalSessionRecord",
         check: checkLocalSessionRecord,
-        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"],
+        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "thinkingLatch"],
         unchecked: [],
     },
     ToolPermissionRequest: {
@@ -1882,6 +1903,12 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
         validated: ["sessionId", "title", "pinned"],
         unchecked: [],
     },
+    SetThinkingLatchRequest: {
+        guard: "isSetThinkingLatchRequest",
+        check: checkSetThinkingLatchRequest,
+        validated: ["sessionId", "event"],
+        unchecked: [],
+    },
     ApplyModelConfigResult: {
         check: checkApplyModelConfigResult,
         validated: ["ok", "requiresRestart", "reason", "detail"],
@@ -1935,7 +1962,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     },
     SeatCapabilitiesState: {
         check: checkSeatCapabilitiesState,
-        validated: ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles"],
+        validated: ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch"],
         unchecked: [],
     },
     RecentFoldersResult: {
@@ -2006,7 +2033,7 @@ export const SEAT_VALIDATOR_COVERAGE_EXEMPT = [
     {
         label: "PickFolderResult",
         check: checkPickFolderResult,
-        why: "载荷是**串或 null**(选中的路径 / 用户取消,CC-469),没有键面 ⇒ `keyof` 覆盖表在它身上无从谈起。判别力由 run-seat-wave2-test.mjs ST1-1 承担:认 null 与非空串、拒空串 / 数 / undefined / 对象 / 布尔五形。",
+        why: "载荷是**串或 null**(选中的路径 / 用户取消,CC-469),没有键面 ⇒ `keyof` 覆盖表在它身上无从谈起。判别力由对应的座位契约测试套承担:认 null 与非空串、拒空串 / 数 / undefined / 对象 / 布尔五形。",
     },
     {
         label: "BooleanAck",
@@ -2017,10 +2044,10 @@ export const SEAT_VALIDATOR_COVERAGE_EXEMPT = [
         label: "LaneProof",
         check: (v) => checkLaneProof(v, "laneProof"),
         why: "判别式联合:必填键面随 `lane` 臂而变(subagent 要 parentToolCallId、workflow 要 via+key),而覆盖表的方法是「一个最小合法体 + 逐键投毒」—— 那套方法在它身上没有判别力(main 臂对另外两臂的伴随位本来就不该拒,投毒过了不代表漏校)。" +
-            "🔴 FIX④(2026-08-07 订正):本条此前自称判别力由「F 段**逐臂**投毒(空对象 / 非对象 / **未登记车道词**)」承担 —— 全树实扫,那三样里只有**空对象**与**非对象**真的存在(run-seat-contract-keys-test.mjs F 段)," +
+            "🔴 (2026-08-07 订正)本条此前自称判别力由「**逐臂**投毒(空对象 / 非对象 / **未登记车道词**)」承担 —— 全树实扫,那三样里只有**空对象**与**非对象**真的存在(座位契约键测试套的逐臂投毒段)," +
             "「未登记车道词」实际只钉了 `lane: 7`(非串,证明不了闭集成员判定在场),「逐臂」(subagent 缺 parentToolCallId / workflow 缺 via+key)则是**零覆盖**。也就是说这条豁免曾经拿三件不存在的判据给自己背书。" +
             "现势(判据锚在真存在的东西上):① `LANE_PROOF_LANE_TUPLE` ⇄ seam.ts 车道联合的双向 `Covers`(本文件 `_seatContractPins`,加车道不跟 ⇒ 编译红);" +
-            "② run-client-core-pure-test.mjs **FIX7 段 ④** —— 未登记车道词 / subagent 缺伴随位 / workflow 缺 via 或 key 三条投毒 + 两条逐臂正控 + 一条「main 臂不被过紧误拒」负控,全部直接喂本条的 `check`。",
+            "② 本包纯测试套的投毒段 —— 未登记车道词 / subagent 缺伴随位 / workflow 缺 via 或 key 三条投毒 + 两条逐臂正控 + 一条「main 臂不被过紧误拒」负控,全部直接喂本条的 `check`。",
     },
 ];
 const _seatContractPins = [
@@ -2050,6 +2077,8 @@ const _seatContractPins = [
     true, true, true,
     true,
     true, true, true,
+    true, true, true, true, true, true,
+    true, true, true,
     true, true,
 ];
 void _seatContractPins;