@sema-agent/client-core 0.78.2 → 0.79.1

package/dist/printToolResultFrame.js

@@ -1,3 +1,4 @@
+import { isCcToolDenialKind } from './gateVocabulary.js';
 export { flattenWireOutput as flattenToolOutput } from './adapt/wireShapes.js';
 import { flattenWireOutput } from './adapt/wireShapes.js';
 function bashExitCodeFailed(toolName, text, structured) {
@@ -30,6 +31,7 @@ export function toolEndResultToUserFrame(arm) {
             ],
         },
         parent_tool_use_id: typeof arm.parentToolCallId === 'string' ? arm.parentToolCallId : null,
+        ...(isCcToolDenialKind(arm._sema_denial_kind) ? { _sema_denial_kind: arm._sema_denial_kind } : {}),
         uuid: arm.uuid,
         session_id: arm.session_id,
     };

package/dist/request/taskRequest.d.ts

@@ -1,5 +1,5 @@
 import type { TaskRequest } from '@sema-agent/sdk';
-export type RequestLane = 'interactive' | 'print';
+export type RequestLane = 'interactive' | 'print' | 'utility';
 export type TaskRequestLike = Record<string, unknown>;
 export interface RequestFieldSpec {
     field: string;
@@ -7,6 +7,7 @@ export interface RequestFieldSpec {
     live: boolean;
     why: string;
     gap?: true;
+    whyUtilityLane: string;
 }
 export declare const REQUEST_FIELD_MATRIX: readonly RequestFieldSpec[];
 export declare const LIVE_DEFAULT_FIELDS: readonly ["cwd", "additionalDirectories", "additionalReadDirectories", "forwardSubagentEvents", "retainSubagentSessions", "agents", "appendSystemPrompt|settings.outputStyle", "suggestNextPrompts", "compactionModel", "sessionId(三态解析)"];
@@ -39,12 +40,15 @@ export interface TaskRequestInput {
     oneShot?: true;
     excludeAllTools?: true;
     outputSchema?: NonNullable<TaskRequest['outputSchema']>;
+    outputRetries?: number;
     maxCostUsd?: number;
+    maxTokens?: number;
     taskBudget?: number;
     fallbackModel?: string;
     maxThinkingTokens?: number;
     memoryCapture?: 'off';
     memory?: 'off';
+    approverPosture?: NonNullable<TaskRequest['approverPosture']>;
     rewind?: Record<string, unknown>;
     repo?: string;
     council?: boolean;
@@ -65,6 +69,7 @@ export interface TaskRequestOmission {
     readonly key: string;
     readonly cause: TaskRequestOmissionCause;
 }
+export declare function taskRequestOmissionCauseDetail(cause: unknown): string;
 export interface TaskRequestAssembly {
     readonly request: TaskRequestLike;
     readonly omitted: readonly TaskRequestOmission[];
@@ -83,6 +88,7 @@ export interface UpstreamAbsentRequestIntent {
     readonly why: string;
 }
 export declare const UPSTREAM_ABSENT_REQUEST_INTENTS: readonly UpstreamAbsentRequestIntent[];
+export declare const REQUEST_LANES: readonly RequestLane[];
 export declare function taskRequestSeatOf(key: string, lane: RequestLane): TaskRequestSeatReading;
 export declare const MEMORY_CAPTURE_OFF: "off";
 export declare function memoryCaptureDeclarationField(declared: boolean): {
@@ -92,10 +98,23 @@ export declare const MEMORY_OFF: "off";
 export declare function memoryOffDeclarationField(declared: boolean): {
     memory: 'off';
 } | Record<string, never>;
+export declare const APPROVER_POSTURE_BYPASS: "bypass";
+export declare function approverPostureDeclarationField(declared: boolean): {
+    approverPosture: 'bypass';
+} | Record<string, never>;
 export declare function memoryOffDeclared(input: {
     flag?: unknown;
     settingsMemory?: unknown;
 } | null | undefined): boolean;
+export type MaxCostUsdParseWhy = 'not_text' | 'empty' | 'not_a_number' | 'not_finite' | 'not_positive';
+export type MaxCostUsdParse = {
+    readonly ok: true;
+    readonly value: number;
+} | {
+    readonly ok: false;
+    readonly why: MaxCostUsdParseWhy;
+};
+export declare function parseMaxCostUsd(text: unknown): MaxCostUsdParse;
 export declare function assembleTaskRequest(input: TaskRequestInput, lane: RequestLane): TaskRequestAssembly;
 export declare function buildTaskRequest(input: TaskRequestInput, lane: RequestLane): TaskRequestLike;
 export interface LiveDefaultsInput {

package/dist/request/taskRequest.js

@@ -1,44 +1,47 @@
 export const REQUEST_FIELD_MATRIX = [
-    { field: 'objective', lanes: ['interactive', 'print'], live: false, why: '本 turn 的真实输入,两条车道都必需' },
-    { field: 'sessionId', lanes: ['interactive', 'print'], live: false, why: '单命名空间(TP-A Step 2):壳 id 即引擎 session id;print 在非 live 下保留 mock 常量' },
-    { field: 'scenario', lanes: ['interactive', 'print'], live: false, why: 'TUI 走 selectScenario(objective) 嗅探,print 走 --scenario/SEMA_HEADLESS_SCENARIO 显式值' },
-    { field: 'sandboxImageProfile', lanes: ['interactive', 'print'], live: true, why: '[686]② 显式 profile;auto 档只在 TUI 有(一次性 advisory 进 objective)' },
-    { field: 'permissionMode', lanes: ['interactive', 'print'], live: true, why: 'TUI 读 AppState.toolPermissionContext(带 stampDefault 门),print 读 flag>env(headlessPermissionModeWire)' },
-    { field: 'selfOrchestration', lanes: ['interactive', 'print'], live: true, why: 'SEMA_SELF_ORCHESTRATION opt-in → core 挂 run_workflow' },
-    { field: 'deferTools', lanes: ['interactive', 'print'], live: true, why: '[1052]① Workflow 延迟披露;selfOrchestration 前置门' },
-    { field: 'retainBackgroundProcesses', lanes: ['interactive', 'print'], live: true, why: '缺省 ON(2026-07-26 起翻转);SEMA_RETAIN_BACKGROUND=0 逃生' },
-    { field: 'promptProfile', lanes: ['interactive', 'print'], live: true, why: 'core 1.328 呈现轴 A/B 口,缺省不 stamp = 引擎缺省 simple' },
-    { field: 'enableFork', lanes: ['interactive', 'print'], live: true, why: '显式布尔才 stamp([503]② fail-OPEN 教训:off 必须显式)' },
-    { field: 'attachments', lanes: ['interactive', 'print'], live: true, why: 'design/133 + G1 缺省开的 turn 边界 attachment' },
-    { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地技能目录投影(布局取 CC 同款);两条车道都由 launchRepl 载入面注入' },
-    { field: 'mcpServers', lanes: ['interactive', 'print'], live: true, why: '本地 .mcp.json 投影;service 单用户门决定是否兑现' },
-    { field: 'settings.webSearch', lanes: ['interactive', 'print'], live: true, why: 'SEMA_WEBSEARCH_* / settings.json;per-request 配置赢过部署 env' },
-    { field: 'settings.hooks', lanes: ['interactive', 'print'], live: true, why: '[495]① 用户 settings 文件 hooks 逐字上 wire' },
-    { field: 'settings.<resolved>', lanes: ['interactive', 'print'], live: true, why: 'settings resolver 的 effective 快照(hooks/env/model + 已解析权限投影)。两条车道同源:交互面 replEntry / print 面 printModeEngine 各跑一遍同一个 resolver,产物经同一个 buildWireSettingsStamp 投影。开放集(子键不可枚举)⇒ unregisteredRequestKeys 放行本车道 settings 的**表外**子键,但表内异车道子键仍点名' },
-    { field: 'repo', lanes: ['interactive', 'print'], live: true, why: 'scan/code-review 场景的仓库坐标(passthrough;server 是权威校验方,本层不铸第二判官)' },
-    { field: 'council', lanes: ['interactive', 'print'], live: true, why: 'code-review council 形开关(server 读 `=== true`;非 true 不 stamp=与缺席同义,发小的那个)' },
-    { field: 'debate', lanes: ['interactive', 'print'], live: true, why: 'council 的 debate 变体开关(server 读 `=== true`)' },
-    { field: 'rounds', lanes: ['interactive', 'print'], live: true, why: 'debate 轮数(server clamp [1,3],非有限数被 server 归 undefined——本层原样透传不预 clamp)' },
-    { field: 'lenses', lanes: ['interactive', 'print'], live: true, why: 'code-review 镜头集(passthrough 同 repo;形状由 server 场景定义,本层不闭集)' },
-    { field: 'memoryCapture', lanes: ['interactive', 'print'], live: true, why: '本会话永远不进长期记忆的**声明形**(server §12.4 body 键,单成员闭集 "off");两条车道都是提交面 ⇒ 都能声明。与 memoryWrite:false 不是一个轴(那是「本 run 只读平面」)。⚠️ parked 续跑腿结构性拿不到声明(决策/续跑端点从持久 body 重建 spec),那是引擎侧事实,不是本层的漏' },
-    { field: 'memory', lanes: ['interactive', 'print'], live: true, why: '这一次运行不挂记忆面的**请求级**开关(server §12.7 body 键,单成员闭集 "off");两条车道都是提交面 ⇒ 都能声明。与 memoryCapture(采集面)不是一个轴、可并存;与 memoryWrite:false(只读平面)也不是一个轴' },
-    { field: 'finalVerification', lanes: ['print'], live: true, why: 'P1-1 终验:无人值守车道才需要引擎自证;交互 REPL 由人当场看结果。#106 裁 B(让位+告知)后交互面默认关' },
-    { field: 'limits', lanes: ['print'], live: true, why: 'P2-3-b:`-p` 的预算护栏(--max-* flag 族),交互 REPL 由人随时 Esc' },
-    { field: 'interactiveTools', lanes: ['print'], live: true, why: '[909]B 件3:无人值守 stamp false,从 roster 源头灭掉 AskUserQuestion/plan 门。交互车道 stamp false 等于自废武功' },
-    { field: 'oneShot', lanes: ['print'], live: true, why: 'SDK TaskRequest.oneShot(server ≥7.12.0 消费):`-p` 提交是一次性的——没有后续回合接住异步后台通知,core 据此把「结束回合等通知」指引换成 block-wait;交互车道有后续回合,stamp true 就是谎报。老 worker 静默忽略(开集提交体),故发送侧不设能力位前置门(oneShotWireCaps 头注)' },
-    { field: 'outputSchema', lanes: ['print'], live: true, why: '结构化输出约束(sdk `TaskRequest.outputSchema`:最终答案必须匹配的 JSON Schema)。上游只验形状与序列化尺寸(坏形 400 响亮拒)、深层合法性归引擎 ⇒ 本层原样透传、不预铸第二判官。来源只在无人值守车道(`--json-schema` 一类旗);交互面今天没有入口 ⇒ 缺席是**没有来源**,不是漏。⚠️ 本行只管**上行**这一位:结果一侧的结构化产出落不落 CC 形 result 帧是下行投影的事,不在本表' },
-    { field: 'maxCostUsd', lanes: ['print'], live: true, why: '花费上限声明(sdk `TaskRequest.maxCostUsd`,请求体**顶层**位;上游向下夹到部署上限 —— 只许要得更少)。与 `limits` 同一条理由只在无人值守车道:交互面由人随时中断。🔴 坏值(非数 / 非有限 / 非正)在本层**响亮拒**:上游对这一位的坏值是安静忽略并回落部署上限,不是 4xx(见 `refuseBadMaxCostUsd`)' },
-    { field: 'attachmentIds', lanes: ['interactive'], live: true, why: '附件**字节通道**(uploadAttachment 回执 id;server ≥1.289 绑定会话并把文件物化进 run 的 attachments/)。有上传入口的端才有 id 可引用:web/desktop 有,壳走 images / 本地文件路径,`-p` 车道连 uploadAttachment 都没有 ⇒ print 缺席是**没有来源**,不是漏。🔴 与上面的 `attachments` 同名不同物(那是 turn 边界的配置键),两条永远不许合并' },
-    { field: 'excludeTools', lanes: ['interactive', 'print'], live: true, why: 'design/161 W3(2026-07-30):真 wire 键(SDK types `excludeTools`)且早在 seatContract `START_SESSION_OPTION_KEYS` 里,却是 desktop 手写 taskReq 的第 9 键、矩阵外——而 stamp 门对未登记键**静默丢弃**,真实危险形=「用户显式排除的工具被静默放回」(权限方向回归,类型层不报)。今天只有 desktop 在发;壳的工具面走 roster/interactiveTools 另一条路。0.77.0 补 print 座(三问:① wire 位与车道无关 —— sdk 具名位、提交体真收 `body.excludeTools`;② 来源 —— print 今天没有排除入口,但这是**收紧方向**的声明,传了只进回执 = 端不读回执就把用户排除的工具放回;③ 口径 —— 仍是 live 门后的位,与交互面同一行)' },
-    { field: 'excludeAllTools', lanes: ['interactive', 'print'], live: true, why: '0.78.0(sdk 11.x 具名位 `excludeAllTools`,server ≥7.90.0 请求面):整只工具面卸载 —— 调用方工具 / 脚手架 / 手 / MCP / A2A / skills 一个都不挂,终局必然纯文本(wire 上 `wiring_manifest.tools.count === 0`,整条流零 tool_start / tool_end / tool_disclosure)。与 excludeTools 是两种语义、刻意不折叠(`"*"` 是一个合法的工具名,「卸全部」不能写成 `excludeTools:["*"]`);两键同带各自生效。类型只收字面 `true`(server 只把 literal true 写上任务规格,`false` = 替引擎重申它自己的缺省 ⇒ 不发、与缺席同义、不进回执);坏值响亮拒(收紧方向的声明不许被打字错误安静丢掉)。两条车道都是提交面 ⇒ 都能声明。探测靠键闭集、没有能力位:没接线的 server(≤7.89.x)400 `request.body_shape` 并在 `unknownKeys` 里逐字点名,本层不替它猜;A2A 入站面不承载本键(零工具面走 skill 路由)' },
-    { field: 'settings.ultracode', lanes: ['interactive'], live: true, why: 'design/111:sticky `/effort ultracode` 拨盘 + 当轮关键词嗅探,两个来源都只在交互面存在', gap: true },
-    { field: 'systemPrompt', lanes: ['interactive', 'print'], live: false, why: '整段替换系统提示(sdk `TaskRequest.systemPrompt`;上游字符数超限 400 响亮拒,本层原样透传)。两条车道都有来源:交互面 = CC QueryParams.systemPrompt,无人值守面 = `--system-prompt[-file]` 一类旗。与追加位 `appendSystemPrompt` 不是一个位(那一位归 live 兜底层,见 `LIVE_DEFAULT_FIELDS`)' },
-    { field: 'reasoningEffort', lanes: ['interactive', 'print'], live: false, why: '思考档位(sdk `TaskRequest.reasoningEffort` 七词闭集;上游对表外词 400 响亮拒 ⇒ 本层不预铸第二判官)。档位是请求级的位、与车道无关:交互面 = `/effort` 拨盘,无人值守面 = 档位旗。🔴 端交的必须是**档位词**:「思考 token 数」今天没有上游对位(见 `UPSTREAM_ABSENT_REQUEST_INTENTS` 的 `maxThinkingTokens`),别把一个数字折成档位词发出去' },
-    { field: 'model', lanes: ['interactive'], live: false, why: '`/model` 中途换模型读 toolUseContext.options.mainLoopModel;print 的模型走 MODEL_ID/--model 另一条路', gap: true },
-    { field: 'images', lanes: ['interactive'], live: false, why: '贴图提交是交互动作,`-p` 的 stdin 没有图片块' },
-    { field: 'resumeAt/resumeAtMode/rewindFiles/rewindFilesTo', lanes: ['interactive'], live: false, why: 'E18 `/rewind` 是交互命令;四键同生同灭(resumeAtMode 是 both/conversation 两臂恒带的排他截语义位)' },
-    { field: 'clientContext', lanes: ['interactive'], live: false, why: 'IANA 时区 + 可选邮箱 → core 本地化 `# Environment` 的 today;print 同样跑在用户机器上,缺席让引擎误标 (UTC)', gap: true },
-    { field: 'scratchpadDir', lanes: ['interactive'], live: true, why: '[816]③ per-session 暂存目录;print 也有 session,缺席让 `-p` 的工具写不进 exemptDir', gap: true },
+    { field: 'objective', lanes: ['interactive', 'print', 'utility'], live: false, why: '本 turn 的真实输入,每条车道都必需', whyUtilityLane: '恒座:三条车道都必须带上本次提交的模型面输入' },
+    { field: 'sessionId', lanes: ['interactive', 'print', 'utility'], live: false, why: '单命名空间(TP-A Step 2):壳 id 即引擎 session id;print 在非 live 下保留 mock 常量', whyUtilityLane: '恒座:side-channel 提交走**独立**会话 id(壳另铸一个,绝不复用用户会话那一个 —— 复用会把这次提交的转录混进用户会话)' },
+    { field: 'scenario', lanes: ['interactive', 'print'], live: false, why: 'TUI 走 selectScenario(objective) 嗅探,print 走 --scenario/SEMA_HEADLESS_SCENARIO 显式值', whyUtilityLane: '无座:场景值的来源只有两条用户车道(交互面按输入嗅探 / 无人值守面显式旗);side-channel 是壳自己的一次性问答,没有场景入口' },
+    { field: 'sandboxImageProfile', lanes: ['interactive', 'print'], live: true, why: '[686]② 显式 profile;auto 档只在 TUI 有(一次性 advisory 进 objective)', whyUtilityLane: '无座:镜像档位是**工具执行面**的位,而 side-channel 提交零工具面 ⇒ 没有要挑的镜像' },
+    { field: 'permissionMode', lanes: ['interactive', 'print'], live: true, why: 'TUI 读 AppState.toolPermissionContext(带 stampDefault 门),print 读 flag>env(headlessPermissionModeWire)', whyUtilityLane: '无座:它选的是**工具门的形状**,而 side-channel 提交零工具面 ⇒ 没有门可管;带上去只会让读请求体的人以为这次提交挂着工具' },
+    { 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: '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: '无座:技能挂的是工具,与零工具面矛盾' },
+    { field: 'mcpServers', lanes: ['interactive', 'print'], live: true, why: '本地 .mcp.json 投影;service 单用户门决定是否兑现', whyUtilityLane: '无座:MCP 服务挂的是工具,与零工具面矛盾' },
+    { field: 'settings.webSearch', lanes: ['interactive', 'print'], live: true, why: 'SEMA_WEBSEARCH_* / settings.json;per-request 配置赢过部署 env', whyUtilityLane: '无座:联网检索是一只工具,与零工具面矛盾' },
+    { field: 'settings.hooks', lanes: ['interactive', 'print'], live: true, why: '[495]① 用户 settings 文件 hooks 逐字上 wire', whyUtilityLane: '无座:hook 挂在工具门上(零工具面没有门),而且 side-channel 是壳自己的提交,不该继承用户那份 hook 表' },
+    { field: 'settings.<resolved>', lanes: ['interactive', 'print'], live: true, why: 'settings resolver 的 effective 快照(hooks/env/model + 已解析权限投影)。两条车道同源:交互面 replEntry / print 面 printModeEngine 各跑一遍同一个 resolver,产物经同一个 buildWireSettingsStamp 投影。开放集(子键不可枚举)⇒ unregisteredRequestKeys 放行本车道 settings 的**表外**子键,但表内异车道子键仍点名', whyUtilityLane: '无座:这一位是**开放集 spread**(子键原样即 wire 键),摊开的是用户 settings 的已解析面(权限 / env / 模型)。side-channel 是壳自己的提交:摊上去既无用(零工具面没有工具门求值权限)又把用户的配置面带进了一条他没参与的提交。🔴 无座 ⇒ 本车道整只快照不产。🔴 **本行无座的前提由构造期校验兜住**:剥掉的是用户显式的 deny / ask,所以 `refuseUtilityWithoutToolUnload` 强制这条车道必须带字面 `excludeAllTools: true` —— 否则产出会是一条「既没卸工具、又没带用户 deny」的请求(比无人值守车道同一份输入更宽)' },
+    { field: 'repo', lanes: ['interactive', 'print'], live: true, why: 'scan/code-review 场景的仓库坐标(passthrough;server 是权威校验方,本层不铸第二判官)', whyUtilityLane: '无座:场景键;side-channel 不走场景' },
+    { field: 'council', lanes: ['interactive', 'print'], live: true, why: 'code-review council 形开关(server 读 `=== true`;非 true 不 stamp=与缺席同义,发小的那个)', whyUtilityLane: '无座:场景键;side-channel 不走场景' },
+    { field: 'debate', lanes: ['interactive', 'print'], live: true, why: 'council 的 debate 变体开关(server 读 `=== true`)', whyUtilityLane: '无座:场景键;side-channel 不走场景' },
+    { field: 'rounds', lanes: ['interactive', 'print'], live: true, why: 'debate 轮数(server clamp [1,3],非有限数被 server 归 undefined——本层原样透传不预 clamp)', whyUtilityLane: '无座:场景键;side-channel 不走场景' },
+    { field: 'lenses', lanes: ['interactive', 'print'], live: true, why: 'code-review 镜头集(passthrough 同 repo;形状由 server 场景定义,本层不闭集)', whyUtilityLane: '无座:场景键;side-channel 不走场景' },
+    { field: 'memoryCapture', lanes: ['interactive', 'print', 'utility'], live: true, why: '本会话永远不进长期记忆的**声明形**(server §12.4 body 键,单成员闭集 "off");每条车道都是提交面 ⇒ 都能声明。与 memoryWrite:false 不是一个轴(那是「本 run 只读平面」)。⚠️ parked 续跑腿结构性拿不到声明(决策/续跑端点从持久 body 重建 spec),那是引擎侧事实,不是本层的漏', whyUtilityLane: '有座:side-channel 提交是壳自己的一次性问答,**绝不该**进用户的长期记忆 —— 这一位正是那句声明,且它是收紧方向,带上去只会更严' },
+    { field: 'memory', lanes: ['interactive', 'print', 'utility'], live: true, why: '这一次运行不挂记忆面的**请求级**开关(server §12.7 body 键,单成员闭集 "off");每条车道都是提交面 ⇒ 都能声明。与 memoryCapture(采集面)不是一个轴、可并存;与 memoryWrite:false(只读平面)也不是一个轴', whyUtilityLane: '有座:side-channel 提交不需要挂记忆面(不挂记忆段 / 索引 / 三只记忆工具),省 token 且零记忆写入;与 memoryCapture 不是一个轴,两条都带' },
+    { field: 'approverPosture', lanes: ['interactive', 'print'], live: true, why: '宿主对这个 run 的**审批姿态声明**(「这个 run 的审批卡由我自己自动答」;单成员闭集 `"bypass"`)。🔴 它不授权任何东西、也不是一只门:引擎只把这句声明**渲**给模型(它自己的标记块,首个回合),没有任何裁决腿读它 —— 与 `permissionMode` 的 `bypassPermissions`(选门的形状)**不是一回事**,两键在请求体上各自原样过境、**互不派生**:宿主完全可以一边留着缺省权限模式、一边自己自动答这个 run 的审批卡。🔴 **声明它的唯一条件是「宿主确实自己自动答这个 run 的审批卡」,不许据此推导或改动 `permissionMode`** —— 拿这一位当理由去把门放宽,是把一句只渲给模型看的话读成了授权。宿主并不自动答卡却声明了它 ⇒ 那是对模型说了一句与实际不符的话,修法是**别声明**,不是去动门。加座的理由是**一个事实一处铸点**:同样一句话,要么由引擎在它自己的标记块里说,要么由壳把提醒形文本拼进本 turn 的输入 —— 后者在模型眼里是一段**没有引擎标记**的提醒形副本,按标记声明它该当**数据**处理并报出来。所以壳从此停拼,交这一位。两条用户车道都是提交面 ⇒ 都能声明。坏词由引擎响亮拒(单成员闭集,打错字不许被折成缺席),本层同律在构造期就拒(见 `refuseBadApproverPosture`)。⚠️ 上游的**提交体**与**引擎规格**两层都真读这一键,而装着的 sdk 型面尚未镜像它 ⇒ 本层的字面按提交体的形声明,不从 sdk 取型', whyUtilityLane: '无座:审批姿态是**用户**对他自己那条会话的声明,而 side-channel 是壳自己的提交 —— 把用户的 bypass 姿态带进一条他没参与的提交,等于替他重申一句他没说过的话;况且零工具面根本产不出审批卡' },
+    { field: 'finalVerification', lanes: ['print'], live: true, why: 'P1-1 终验:无人值守车道才需要引擎自证;交互 REPL 由人当场看结果。#106 裁 B(让位+告知)后交互面默认关', 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' },
+    { field: 'outputSchema', lanes: ['print', 'utility'], live: true, why: '结构化输出约束(sdk `TaskRequest.outputSchema`:最终答案必须匹配的 JSON Schema)。上游只验形状与序列化尺寸(坏形 400 响亮拒)、深层合法性归引擎 ⇒ 本层原样透传、不预铸第二判官。来源只可能在无人值守车道(schema 由壳的无人值守入口给;哪个壳今天真的接了那条入口是壳侧的事,本表只说座位);交互面今天没有入口 ⇒ 缺席是**没有来源**,不是漏。⚠️ 本行只管**上行**这一位:结果一侧的结构化产出落不落 CC 形 result 帧是下行投影的事,不在本表', whyUtilityLane: '有座:side-channel 的典型形正是「要一个可机读的小答案」(分类 / 摘要 / 抽取),结构化输出约束是它最直接的位,而 schema 由壳自己给 ⇒ 有来源' },
+    { field: 'outputRetries', lanes: ['print', 'utility'], live: true, why: '结构化输出的重试轮数(sdk `TaskRequest.outputRetries`;与 `outputSchema` 是**成对旋钮** —— 没有 schema 时引擎忽略它)。🔴 座位集与 `outputSchema` 那一行**逐字相同**:一半有座一半没座 = 端调得动重试轮数却调不动它所服务的约束(同座孪生分开定座,正是「主轴改了、孪生漏了」那一族)。上游接受域很窄(有限、≥1、向下取整、封顶 10),**表外一律整键省略**并回落引擎缺省 ⇒ 本层对坏值**响亮拒**(见 `refuseBadOutputRetries`),但**不预夹** [1,10]:夹是上游的事,本层不铸第二判官', whyUtilityLane: '有座:与 outputSchema 同座孪生 —— side-channel 要机读小答案时,重试轮数是同一个旋钮的另一半' },
+    { field: 'maxCostUsd', lanes: ['print', 'utility'], live: true, why: '花费上限声明(sdk `TaskRequest.maxCostUsd`,请求体**顶层**位;上游向下夹到部署上限 —— 只许要得更少)。与 `limits` 同一条理由只在无人值守车道:交互面由人随时中断。🔴 坏值(非数 / 非有限 / 非正)在本层**响亮拒**:上游对这一位的坏值是安静忽略并回落部署上限,不是 4xx(见 `refuseBadMaxCostUsd`)', whyUtilityLane: '有座:小预算是本车道的定义之一(与 limits 同一条理由);上游向下夹到部署上限,只许要得更少' },
+    { field: 'maxTokens', lanes: ['print', 'utility'], live: true, why: '整任务 token 预算上限声明(sdk `TaskRequest.maxTokens`,请求体**顶层**位,与 `maxCostUsd` 同属上游那一族「调用方要求的上限」:向下夹到部署上限 —— 只许要得更少)。🔴 座位集与 `maxCostUsd` 那一行**逐字相同**:同一条预算轴的两种计价单位,分开定座就是让其中一条静默漂。🔴 坏值(非数 / 非有限 / 非正 / 非整)在本层**响亮拒**:上游对这一位的坏值是安静按「调用方没给」处理并回落部署上限,不是 4xx —— 部署没设上限时这一次运行就没有 token 闸,而声明人不会知道(见 `refuseBadMaxTokens`)', whyUtilityLane: '有座:与 maxCostUsd 同轴孪生 —— 小预算是本车道的定义之一,两种计价单位都该能声明' },
+    { field: 'attachmentIds', lanes: ['interactive'], live: true, why: '附件**字节通道**(uploadAttachment 回执 id;server ≥1.289 绑定会话并把文件物化进 run 的 attachments/)。有上传入口的端才有 id 可引用:web/desktop 有,壳走 images / 本地文件路径,`-p` 车道连 uploadAttachment 都没有 ⇒ print 缺席是**没有来源**,不是漏。🔴 与上面的 `attachments` 同名不同物(那是 turn 边界的配置键),两条永远不许合并', whyUtilityLane: '无座:预上传附件句柄要先有上传入口才有 id 可引用,而 side-channel 没有上传面' },
+    { field: 'excludeTools', lanes: ['interactive', 'print', 'utility'], live: true, why: 'design/161 W3(2026-07-30):真 wire 键(SDK types `excludeTools`)且早在 seatContract `START_SESSION_OPTION_KEYS` 里,却是 desktop 手写 taskReq 的第 9 键、矩阵外——而 stamp 门对未登记键**静默丢弃**,真实危险形=「用户显式排除的工具被静默放回」(权限方向回归,类型层不报)。今天只有 desktop 在发;壳的工具面走 roster/interactiveTools 另一条路。0.77.0 补 print 座(三问:① wire 位与车道无关 —— sdk 具名位、提交体真收 `body.excludeTools`;② 来源 —— print 今天没有排除入口,但这是**收紧方向**的声明,传了只进回执 = 端不读回执就把用户排除的工具放回;③ 口径 —— 仍是 live 门后的位,与交互面同一行)', whyUtilityLane: '有座:逐名排除是卸载声明旁边的第二条收紧声明(两键同带各自生效)。⚠️ 它**不是** excludeAllTools 的降级替身 —— 本车道强制带卸载声明(见 `refuseUtilityWithoutToolUnload`),不认那一键的上游会把整条提交拒掉,那时正解是换车道或不发' },
+    { field: 'excludeAllTools', lanes: ['interactive', 'print', 'utility'], live: true, why: '0.78.0(sdk 11.x 具名位 `excludeAllTools`,server ≥7.90.0 请求面):整只工具面卸载 —— 调用方工具 / 脚手架 / 手 / MCP / A2A / skills 一个都不挂,终局必然纯文本(wire 上 `wiring_manifest.tools.count === 0`,整条流零 tool_start / tool_end / tool_disclosure)。与 excludeTools 是两种语义、刻意不折叠(`"*"` 是一个合法的工具名,「卸全部」不能写成 `excludeTools:["*"]`);两键同带各自生效。类型只收字面 `true`(server 只把 literal true 写上任务规格,`false` = 替引擎重申它自己的缺省 ⇒ 不发、与缺席同义、不进回执);坏值响亮拒(收紧方向的声明不许被打字错误安静丢掉)。每条车道都是提交面 ⇒ 都能声明。探测靠键闭集、没有能力位:没接线的 server(≤7.89.x)400 `request.body_shape` 并在 `unknownKeys` 里逐字点名,本层不替它猜;A2A 入站面不承载本键(零工具面走 skill 路由)', whyUtilityLane: '有座,而且**本车道强制**:零工具面就是这条车道的定义 —— side-channel 提交整只工具面卸载,终局必然纯文本。🔴 缺这一位(或给 `false`)⇒ 构造期响亮拒(`refuseUtilityWithoutToolUnload`):本车道上一整片「无座」的理由都压在这个前提上,其中 `settings.<resolved>` 那一行剥掉的是用户显式的 deny / ask ——前提不成立时产出会是一条「既没卸工具、又没带用户 deny」的请求' },
+    { field: 'settings.ultracode', lanes: ['interactive'], live: true, why: 'design/111:sticky `/effort ultracode` 拨盘 + 当轮关键词嗅探,两个来源都只在交互面存在', gap: true, whyUtilityLane: '无座:sticky 拨盘与当轮关键词嗅探两个来源都只在交互面' },
+    { field: 'systemPrompt', lanes: ['interactive', 'print', 'utility'], live: false, why: '整段替换系统提示(sdk `TaskRequest.systemPrompt`;上游字符数超限 400 响亮拒,本层原样透传)。三条车道都有来源:交互面 = CC QueryParams.systemPrompt,无人值守面 = `--system-prompt[-file]` 一类旗,side-channel 面 = 壳整段给出的那一份。与追加位 `appendSystemPrompt` 不是一个位(那一位归 live 兜底层,见 `LIVE_DEFAULT_FIELDS`)', whyUtilityLane: '有座:side-channel 提交的系统提示由壳整段给出 —— 它不是用户会话的续谈,不该继承用户那一份' },
+    { field: 'reasoningEffort', lanes: ['interactive', 'print', 'utility'], live: false, why: '思考档位(sdk `TaskRequest.reasoningEffort` 七词闭集;上游对表外词 400 响亮拒 ⇒ 本层不预铸第二判官)。档位是请求级的位、与车道无关:交互面 = `/effort` 拨盘,无人值守面 = 档位旗。🔴 端交的必须是**档位词**:「思考 token 数」今天没有上游对位(见 `UPSTREAM_ABSENT_REQUEST_INTENTS` 的 `maxThinkingTokens`),别把一个数字折成档位词发出去', whyUtilityLane: '有座:side-channel 该用显式低档(省钱省时);与 model 同一条理由 —— 本车道上这两位都由壳显式给,不跟用户会话的拨盘走' },
+    { field: 'model', lanes: ['interactive', 'print', 'utility'], live: false, why: '模型选择(sdk `TaskRequest.model`;交互面 = `/model` 中途换模型的拨盘,无人值守面 = 模型旗 / 部署缺省那一路,side-channel 面 = 壳显式挑的那一只)。三条车道都有来源、都是提交面。🔴 0.79.0 改口:修前「print 的模型走另一条路」这句理由被用户面实测证伪 —— 无人值守车道传了模型名却整键不上请求体,于是同一个坏名字在交互态被引擎 400 点名、在无人值守态却安静换成部署缺省并在首帧回显一个没生效的名字。一个**选择**类声明被静默丢掉,后果与收紧类声明被静默丢掉同形(端不读回执就以为生效)—— 与 `excludeTools` 补 print 座同律。本层原样透传、不预判模型名(名字的合法性归引擎,本层不铸第二判官)', whyUtilityLane: '有座:side-channel 显式挑便宜的那只模型(不跟用户会话的 `/model` 拨盘走)' },
+    { field: 'images', lanes: ['interactive'], live: false, why: '贴图提交是交互动作,`-p` 的 stdin 没有图片块', whyUtilityLane: '无座:贴图是交互动作,side-channel 的提交体里没有图片块' },
+    { field: 'resumeAt/resumeAtMode/rewindFiles/rewindFilesTo', lanes: ['interactive'], live: false, why: 'E18 `/rewind` 是交互命令;四键同生同灭(resumeAtMode 是 both/conversation 两臂恒带的排他截语义位)', whyUtilityLane: '无座:回退是交互命令,而 side-channel 是一次性的独立会话,没有可回退的历史' },
+    { field: 'clientContext', lanes: ['interactive'], live: false, why: 'IANA 时区 + 可选邮箱 → core 本地化 `# Environment` 的 today;print 同样跑在用户机器上,缺席让引擎误标 (UTC)', gap: true, whyUtilityLane: '无座:本地化 today 的用途在用户会话的环境段,而 side-channel 的系统提示由壳整段给出 —— 这一列我判不准要不要(与本行 `gap` 同一条待办:要补先单独立项)' },
+    { field: 'scratchpadDir', lanes: ['interactive'], live: true, why: '[816]③ per-session 暂存目录;print 也有 session,缺席让 `-p` 的工具写不进 exemptDir', gap: true, whyUtilityLane: '无座:per-session 暂存目录是给**工具**写的,零工具面上没人写' },
 ];
 export const LIVE_DEFAULT_FIELDS = [
     'cwd',
@@ -58,6 +61,19 @@ export const TASK_REQUEST_OMISSION_CAUSES = Object.freeze([
     'off_lane',
     'not_live',
 ]);
+const TASK_REQUEST_OMISSION_CAUSE_SENTENCES = Object.freeze({
+    upstream_absent: 'this build knows the intent but the engine has no request field for it, so nothing was sent and nothing will be until that field exists upstream — retire the knob, or wait for the upstream field',
+    other_channel: 'this is a real request field, but the request assembler never sets it — it belongs to the live-defaults layer, so hand the value to that layer instead of to the assembler',
+    off_lane: 'this request lane has no seat for the key, so the value was not sent — the lane table records why that lane does not carry it; submit on a lane that seats it, or stop passing it here',
+    not_live: 'the key has a seat on this lane but only reaches the wire on a live submission, and this submission was not live — nothing is wrong here: a mock or fixture submission keeps its request shape fixed',
+});
+export function taskRequestOmissionCauseDetail(cause) {
+    if (typeof cause === 'string' && Object.hasOwn(TASK_REQUEST_OMISSION_CAUSE_SENTENCES, cause)) {
+        return TASK_REQUEST_OMISSION_CAUSE_SENTENCES[cause];
+    }
+    const word = typeof cause === 'string' && cause.length > 0 ? cause : '(none)';
+    return `a cause this build does not know (${word}) — this build does not know this cause: receipt causes come from this build's own frozen vocabulary, so a word outside it was not produced here; check whatever supplied it`;
+}
 const row = (field) => ({ via: 'matrix', field });
 const INPUT_KEY_ROUTES = {
     objective: { via: 'always' },
@@ -88,7 +104,9 @@ const INPUT_KEY_ROUTES = {
     interactiveTools: row('interactiveTools'),
     oneShot: row('oneShot'),
     outputSchema: row('outputSchema'),
+    outputRetries: row('outputRetries'),
     maxCostUsd: row('maxCostUsd'),
+    maxTokens: row('maxTokens'),
     taskBudget: {
         via: 'fixed',
         cause: 'upstream_absent',
@@ -106,6 +124,7 @@ const INPUT_KEY_ROUTES = {
     },
     memoryCapture: row('memoryCapture'),
     memory: row('memory'),
+    approverPosture: row('approverPosture'),
     rewind: row('resumeAt/resumeAtMode/rewindFiles/rewindFilesTo'),
     repo: row('repo'),
     council: row('council'),
@@ -153,7 +172,8 @@ const OMISSION_JUDGES = {
     not_live: (s, _lane, live) => s.via === 'matrix' && s.spec.live && !live,
 };
 const omissionCauseOf = (s, lane, live) => TASK_REQUEST_OMISSION_CAUSES.find(cause => OMISSION_JUDGES[cause](s, lane, live));
-const REQUEST_LANE_SET = { interactive: true, print: true };
+const REQUEST_LANE_SET = { interactive: true, print: true, utility: true };
+export const REQUEST_LANES = Object.freeze(Object.keys(REQUEST_LANE_SET));
 const refuseBadLane = (lane) => {
     if (typeof lane === 'string' && hasOwn(REQUEST_LANE_SET, lane))
         return;
@@ -176,6 +196,7 @@ const VALUE_LEVEL_IN_PLAY = Object.freeze({
     excludeAllTools: (v) => v === true,
     memoryCapture: (v) => v === 'off',
     memory: (v) => v === 'off',
+    approverPosture: (v) => v === APPROVER_POSTURE_BYPASS,
     rewind: (v) => typeof v === 'object' && v !== null && rewindSubKeys().some((k) => hasOwn(v, k) && present(v[k])),
 });
 const inPlay = (key, v) => present(v) && (VALUE_LEVEL_IN_PLAY[key]?.(v) ?? true);
@@ -350,6 +371,12 @@ export const MEMORY_OFF = 'off';
 export function memoryOffDeclarationField(declared) {
     return declared ? { memory: MEMORY_OFF } : {};
 }
+export const APPROVER_POSTURE_BYPASS = 'bypass';
+void APPROVER_POSTURE_BYPASS;
+void true;
+export function approverPostureDeclarationField(declared) {
+    return declared ? { approverPosture: APPROVER_POSTURE_BYPASS } : {};
+}
 export function memoryOffDeclared(input) {
     if (typeof input !== 'object' || input === null)
         return false;
@@ -389,6 +416,48 @@ const refuseBadExcludeAllTools = (v) => {
         `收到 ${coarseShape(v)}。这一位是**整只工具面卸载**的收紧声明:本层若把坏值静默删键,这一次运行会挂上声明人以为已经卸掉的全部工具。` +
         '错误文本只报形状,不回显值。');
 };
+const refuseBadApproverPosture = (v) => {
+    if (v === undefined || v === null)
+        return;
+    if (v === APPROVER_POSTURE_BYPASS)
+        return;
+    throw new TypeError('buildTaskRequest: approverPosture 只接受字面量 `\'bypass\'` 或缺席(undefined/null)—— ' +
+        `收到 ${coarseShape(v)}。这一位是**审批姿态声明**,上游是**单成员闭集**(没有第二个词)且对表外词` +
+        '**响亮拒**,刻意不把打错的词折回缺席。本层若静默删键,这一次提交的模型不会被告知姿态,而声明人不会知道。' +
+        '错误文本只报形状,不回显值。');
+};
+const refuseBadMaxTokens = (v) => {
+    if (v === undefined || v === null)
+        return;
+    if (typeof v === 'number' && Number.isInteger(v) && v > 0)
+        return;
+    throw new TypeError(`buildTaskRequest: maxTokens 只接受有限正整数或缺席(undefined/null)—— 收到 ${coarseShape(v)}。` +
+        '这一位是 token 预算上限声明(收紧方向),而上游对坏值(非数 / 非正)不是 4xx,是按「没给」处理并回落' +
+        '部署上限:部署没设上限时这一次运行就没有 token 闸,而声明人不会知道。数字串请先在端侧解析成整数。' +
+        '错误文本只报形状,不回显值。');
+};
+const refuseBadOutputRetries = (v) => {
+    if (v === undefined || v === null)
+        return;
+    if (typeof v === 'number' && Number.isInteger(v) && v > 0)
+        return;
+    throw new TypeError(`buildTaskRequest: outputRetries 只接受有限正整数或缺席(undefined/null)—— 收到 ${coarseShape(v)}。` +
+        '上游对表外值(非数 / 非有限 / 小于 1)整键省略并回落引擎缺省,不是 4xx:调用方以为自己调了轮数,' +
+        '而这一次运行用的是缺省。`0` 同样拒 —— 在上游它是「省略」不是「零次重试」。本层不预夹上限(那是上游的事)。' +
+        '错误文本只报形状,不回显值。');
+};
+const refuseUtilityWithoutToolUnload = (lane, excludeAllTools) => {
+    if (lane !== 'utility')
+        return;
+    if (excludeAllTools === true)
+        return;
+    throw new TypeError('buildTaskRequest: utility 车道必须带字面量 `excludeAllTools: true` —— ' +
+        `收到 ${coarseShape(excludeAllTools)}。这条车道上每一条「无座」判断都压在同一个前提上:它是**零工具面**的提交。` +
+        '尤其已解析 settings 快照那一行(用户显式的 permissions.deny / ask 就在里面)无座的理由就是' +
+        '「零工具面没有工具门求值权限」—— 前提不成立时,产出就是一条**既没卸工具、又没带用户 deny** 的请求,' +
+        '比无人值守车道同一份输入更宽,而且没有任何人会知道。处置:补上这一位;不认这一键的老上游会把整条提交 400 拒掉,' +
+        '那时正解是换车道或不发,**不是**在这条车道上摘掉它。错误文本只报形状,不回显值。');
+};
 const refuseBadMemoryCapture = (v) => {
     if (v === undefined || v === null)
         return;
@@ -410,30 +479,100 @@ const refuseBadMaxCostUsd = (v) => {
         '这一位是花费上限声明(收紧方向),而上游对坏值(非数 / 非正)不是 4xx,是按「没给」处理并回落部署上限:' +
         '部署没设上限时这一次运行就没有花费闸,而声明人不会知道。数字串请先在端侧解析成数。错误文本只报形状,不回显值。');
 };
+const DECIMAL_AMOUNT = /^\d+(?:\.\d+)?$/;
+export function parseMaxCostUsd(text) {
+    if (typeof text !== 'string')
+        return { ok: false, why: 'not_text' };
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return { ok: false, why: 'empty' };
+    if (!DECIMAL_AMOUNT.test(trimmed))
+        return { ok: false, why: 'not_a_number' };
+    const value = Number(trimmed);
+    if (!Number.isFinite(value))
+        return { ok: false, why: 'not_finite' };
+    if (value <= 0)
+        return { ok: false, why: 'not_positive' };
+    return { ok: true, value };
+}
+const ACCESSOR_READ_ORDER = ['live', 'memoryCapture', 'memory', 'settings', 'maxCostUsd', 'excludeAllTools', 'approverPosture', 'maxTokens', 'outputRetries'];
+function dataFirstSnapshot(input, afterData) {
+    let descs;
+    try {
+        descs = Object.getOwnPropertyDescriptors(input);
+    }
+    catch {
+        throw new TypeError('buildTaskRequest: 入参的键集 / 属性描述符读不出(代理 trap 抛)—— 无法安全快照声明,拒绝装配。错误文本只报形状,不回显值。');
+    }
+    const bag = Object.create(null);
+    const accessors = [];
+    for (const k of Object.keys(descs)) {
+        const d = descs[k];
+        if (d === undefined || d.enumerable !== true)
+            continue;
+        if ('value' in d)
+            bag[k] = d.value;
+        else
+            accessors.push(k);
+    }
+    afterData?.(bag);
+    const ordered = [
+        ...ACCESSOR_READ_ORDER.filter((k) => accessors.includes(k)),
+        ...accessors.filter((k) => !ACCESSOR_READ_ORDER.includes(k)),
+    ];
+    for (const k of ordered)
+        bag[k] = Reflect.get(input, k);
+    return bag;
+}
 export function assembleTaskRequest(input, lane) {
     refuseBadLane(lane);
-    const live = input.live;
-    const memoryCaptureIn = input.memoryCapture;
-    const memoryIn = input.memory;
-    const settingsIn = input.settings;
+    let resolvedInEarly;
+    let resolvedMaterialized;
+    let resolvedMaterializeError;
+    let resolvedHookRan = false;
+    const src = dataFirstSnapshot(input, (bag) => {
+        const st = bag['settings'];
+        if (present(st) && typeof st === 'object' && !Array.isArray(st)) {
+            resolvedHookRan = true;
+            resolvedInEarly = st.resolved;
+            try {
+                resolvedMaterialized = resolvedSnapshotForWire(resolvedInEarly);
+            }
+            catch (e) {
+                resolvedMaterializeError = e;
+            }
+        }
+    });
+    const live = src.live;
+    const memoryCaptureIn = src.memoryCapture;
+    const memoryIn = src.memory;
+    const settingsIn = src.settings;
     if (present(settingsIn) && (typeof settingsIn !== 'object' || Array.isArray(settingsIn))) {
         throw new TypeError(`buildTaskRequest: settings 只接受对象或缺席(undefined/null)—— 收到 ${coarseShape(settingsIn)}。` +
             '这一位装着已解析权限面与 hooks:把畸形容器当成「没给」= 请求带着被剥掉的权限面照发。错误文本只报形状,不回显值。');
     }
     const settingsObj = present(settingsIn) ? settingsIn : {};
-    const resolvedIn = settingsObj.resolved;
+    const resolvedIn = resolvedHookRan ? resolvedInEarly : settingsObj.resolved;
     const resolvedRoute = SETTINGS_KEY_ROUTES.resolved;
     const resolvedOpen = resolvedRoute.via === 'matrix' && omissionCauseOf(standingOf(resolvedRoute), lane, live) === undefined;
-    const resolvedWire = resolvedOpen ? resolvedSnapshotForWire(resolvedIn) : {};
-    const maxCostUsdIn = input.maxCostUsd;
-    const excludeAllToolsIn = input.excludeAllTools;
+    if (resolvedOpen && resolvedHookRan && resolvedMaterializeError !== undefined)
+        throw resolvedMaterializeError;
+    const resolvedWire = resolvedOpen ? (resolvedMaterialized ?? resolvedSnapshotForWire(resolvedIn)) : {};
+    const maxCostUsdIn = src.maxCostUsd;
+    const excludeAllToolsIn = src.excludeAllTools;
+    const approverPostureIn = src.approverPosture;
+    const maxTokensIn = src.maxTokens;
+    const outputRetriesIn = src.outputRetries;
     const INPUT_KEYS = Object.keys(INPUT_KEY_ROUTES);
-    const i = snapshotByName(input, INPUT_KEYS, {
+    const i = snapshotByName(src, INPUT_KEYS, {
         live,
         memoryCapture: memoryCaptureIn,
         memory: memoryIn,
         maxCostUsd: maxCostUsdIn,
+        maxTokens: maxTokensIn,
         excludeAllTools: excludeAllToolsIn,
+        approverPosture: approverPostureIn,
+        outputRetries: outputRetriesIn,
         settings: settingsIn,
     });
     const SETTINGS_KEYS = Object.keys(SETTINGS_KEY_ROUTES);
@@ -442,6 +581,9 @@ export function assembleTaskRequest(input, lane) {
     refuseBadMemoryOff(memoryIn);
     refuseBadMaxCostUsd(maxCostUsdIn);
     refuseBadExcludeAllTools(excludeAllToolsIn);
+    refuseBadApproverPosture(approverPostureIn);
+    refuseBadMaxTokens(maxTokensIn);
+    refuseBadOutputRetries(outputRetriesIn);
     const rewindRoute = INPUT_KEY_ROUTES.rewind;
     const REWIND_KEYS = rewindRoute.via === 'matrix' ? rewindRoute.field.split('/') : [];
     const rewindIn = i.rewind;
@@ -465,10 +607,10 @@ export function assembleTaskRequest(input, lane) {
     };
     const unknownKeys = [];
     const lateOmitted = [];
-    for (const key of Object.keys(input)) {
+    for (const key of Object.keys(src)) {
         if (hasOwn(INPUT_KEY_ROUTES, key))
             continue;
-        const stray = Reflect.get(input, key);
+        const stray = Reflect.get(src, key);
         if (!present(stray))
             continue;
         const route = routeOfTopLevelKey(key);
@@ -508,6 +650,7 @@ export function assembleTaskRequest(input, lane) {
             '想问某个键有没有座 ⇒ taskRequestSeatOf(key, lane)。`settings` 快照里的开放集子键放进 settings.resolved。' +
             '错误文本只报键名,不回显值。');
     }
+    refuseUtilityWithoutToolUnload(lane, excludeAllToolsIn);
     const carries = (route, value, key) => {
         if (route.via === 'always')
             return present(value);
@@ -574,9 +717,12 @@ export function assembleTaskRequest(input, lane) {
         ...(on('interactiveTools') ? { interactiveTools: false } : {}),
         ...(on('oneShot') ? { oneShot: true } : {}),
         ...(on('outputSchema') ? { outputSchema: i.outputSchema } : {}),
+        ...(on('outputRetries') ? { outputRetries: i.outputRetries } : {}),
         ...(on('maxCostUsd') ? { maxCostUsd: maxCostUsdIn } : {}),
+        ...(on('maxTokens') ? { maxTokens: i.maxTokens } : {}),
         ...(on('memoryCapture') ? { memoryCapture: 'off' } : {}),
         ...(on('memory') ? { memory: 'off' } : {}),
+        ...(on('approverPosture') ? { approverPosture: APPROVER_POSTURE_BYPASS } : {}),
         ...(Object.keys(settingsOut).length > 0 ? { settings: settingsOut } : {}),
     };
     return Object.freeze({ request: out, omitted: Object.freeze([...omitted, ...lateOmitted]) });

package/dist/sdkRegistryTransit.d.ts

@@ -0,0 +1,6 @@
+export { RegistryClient } from '@sema-agent/sdk/registry';
+export { getMeConfig, getScopeConfigDraft, getEffective } from '@sema-agent/sdk/registry';
+export { probeRegistryHealth, postFeedback } from '@sema-agent/sdk/registry';
+export { REGISTRY_AUTH_PATHS, skillContentAddress } from '@sema-agent/sdk/registry';
+export { RegistryApiError, OAuthFlowError } from '@sema-agent/sdk/registry';
+export type { RegistryTokens, TokenProvider, } from '@sema-agent/sdk/registry';

package/dist/sdkRegistryTransit.js

@@ -0,0 +1,5 @@
+export { RegistryClient } from '@sema-agent/sdk/registry';
+export { getMeConfig, getScopeConfigDraft, getEffective } from '@sema-agent/sdk/registry';
+export { probeRegistryHealth, postFeedback } from '@sema-agent/sdk/registry';
+export { REGISTRY_AUTH_PATHS, skillContentAddress } from '@sema-agent/sdk/registry';
+export { RegistryApiError, OAuthFlowError } from '@sema-agent/sdk/registry';

package/dist/sdkWireTransit.d.ts

@@ -1,3 +1,4 @@
 export { AgentClient } from '@sema-agent/sdk';
 export { isApprovalRequestFrameV1, isApprovalRevokeFrameV1 } from '@sema-agent/sdk';
-export type { TaskRequest, SessionPermissionRules, SemaSettings, SkillSpec, AgentEvent, RunReceipt, CancelAck, RunRecord, ToolApprovalRespondAck, FleetTaskRow, FleetWorkflowRow, ApprovalCard, ApprovalRequestFrame, ApprovalRiskAxes, AskDecisionAck, AskDecisionBody, } from '@sema-agent/sdk';
+export { pushSessionBundle, pullSessionBundle, importSessionBundle, APIError } from '@sema-agent/sdk';
+export type { TaskRequest, SessionPermissionRules, SemaSettings, SkillSpec, AgentEvent, RunReceipt, CancelAck, RunRecord, ToolApprovalRespondAck, FleetTaskRow, FleetWorkflowRow, ApprovalCard, ApprovalRequestFrame, ApprovalRiskAxes, AskDecisionAck, AskDecisionBody, PolicyInfo, CcImportLayer, CcImportPrepareResult, CcImportRedeemResult, CcImportSettingsLayer, CcImportSkippedRule, PersistedRule, RuleRevokeRequest, RuleRevokeResult, } from '@sema-agent/sdk';

package/dist/sdkWireTransit.js

@@ -1,2 +1,3 @@
 export { AgentClient } from '@sema-agent/sdk';
 export { isApprovalRequestFrameV1, isApprovalRevokeFrameV1 } from '@sema-agent/sdk';
+export { pushSessionBundle, pullSessionBundle, importSessionBundle, APIError } from '@sema-agent/sdk';

package/dist/toolResult.d.ts

@@ -7,6 +7,12 @@ export declare const PROTOCOL_MARKERS: {
     readonly bashStderrSep: "\n--- stderr ---\n";
     readonly bashEmptySentinel: "(empty)";
     readonly untrustedFence: RegExp;
+    readonly delegationReportHead: "[Sub-agent report";
+    readonly delegationResultLabel: "result:";
+    readonly delegationPartialFindingsLabel: "partial findings (the child's last assistant text before it stopped):";
+    readonly delegationNoTextResult: "(no text result)";
+    readonly delegationTrailer: "Verify this result before concluding. If it leaves more to do, continue or delegate again.";
+    readonly delegationTrailerFork: "Verify this result before concluding. If it leaves more to do, continue the work yourself or fork again.";
     readonly taskOutputLabel: RegExp;
     readonly taskOutputStatus: RegExp;
     readonly taskOutputNoneSentinel: "(none)";
@@ -33,11 +39,19 @@ export type DisplayBody = {
     fenced: true;
     label: string;
     body: string;
+    frame?: DelegationReportFrame;
 } | {
     fenced: false;
     body: string;
+    frame?: DelegationReportFrame;
 };
-export declare function displayBody(text: unknown): DisplayBody | undefined;
+export type DisplayBodyOrigin = 'any_tool_result' | 'delegation_report';
+export type DelegationReportFrame = {
+    before: string;
+    after: string;
+    section: 'result' | 'partial_findings' | 'no_text_result';
+};
+export declare function displayBody(text: unknown, origin?: DisplayBodyOrigin): DisplayBody | undefined;
 export type ModelFacingTaskOutput = {
     kind: 'bash';
     taskId?: string | undefined;