@sema-agent/client-core 0.109.0 → 0.111.0

package/dist/seatContract.d.ts

@@ -3,7 +3,9 @@ import type { PermissionMode } from "./permissionWireCaps.js";
 import type { ChromeArmKind, LaneProof } from "./seam.js";
 import type { SeatTurnFailure } from "./turnFailurePresentation.js";
 import type { QuestionAnswer } from "./liveQuestionStore.js";
-import type { ToolApprovalDelegation } from "./hitl/toolApprovalWire.js";
+import type { ApprovalInputSource, ToolApprovalDelegation } from "./hitl/toolApprovalWire.js";
+import type { ApprovalRequestedBy } from "./hitl/approvalAskers.js";
+import type { ApprovalRequestFrameUnreadableWhy } from "./hitl/approvalRequestFrameReading.js";
 import type { ApprovalMandateWord } from "./gateVocabulary.js";
 import type { ModelApiWord } from "./model/providerPresets.js";
 import type { LiveModelCatalog } from "./liveModelCatalog.js";
@@ -12,12 +14,19 @@ import { type ProbeVerdictWord } from "./modelCapabilityProbe.js";
 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 { WiringManifestModView } from "./adapter/downstream/eventToSdkMessage.js";
 import type { McpToolToggleKey } from "./mcpToolToggles.js";
 import { type ThinkingLatchEvent, type ThinkingLatchRowWord } from "./thinkingLatchWords.js";
 import type { SessionRowPatchFields, SessionRowUnreadable } from "./sessionRowTag.js";
 import { type SessionEngineKind, type SessionEngineView } from "./sessionEngine.js";
 import type { ParkedUnresumableRow } from "./hitl/parkedUnresumable.js";
 import { type EngineSwapCard } from "./localEngineSwapCard.js";
+import type { ToolPermissionSettledElsewhere } from "./hitl/approvalResolution.js";
+import { type HookEntryTypeWord, type HookSettingsSource, type HooksWirePlan, type PluginHookExclusionReason, type PluginHookReason, type SettingsHookDropReason } from "./pluginHooksWire.js";
+import { type HttpPolicyDropReason } from "./httpHookPolicy.js";
+import { type HooksSalvageDropCode, type HooksSalvageRejectionCode } from "./settingsHooksSalvage.js";
+import { SETTINGS_HOOK_EVENTS } from "./generated/settingsSchemaFns.js";
+import type { ToolPermissionUnconfirmed, ToolPermissionUnconfirmedCause } from "./hitl/decisionSend.js";
 export interface SeatValidationFailure {
     reason: string;
     field?: string;
@@ -87,6 +96,12 @@ export interface ToolPermissionRequest {
     askClass?: string;
     classes?: readonly string[];
     sessionRow?: true;
+    probeReason?: string;
+    probeCause?: object;
+    feedbackCapable?: true;
+    requestedBy?: ApprovalRequestedBy;
+    frameReading?: ApprovalRequestFrameUnreadableWhy;
+    inputSource?: ApprovalInputSource;
 }
 declare const SEAT_EVENT_TYPE_TUPLE: readonly ["start", "close", "session_updated", "message", "stream_event", "chrome_event", "error", "tool_permission_resolved", "subagent_content"];
 export type SeatEventType = (typeof SEAT_EVENT_TYPE_TUPLE)[number];
@@ -110,6 +125,9 @@ declare const CHROME_ARM_SEAT_ROUTE: {
     readonly compaction_outcome: "seat";
     readonly engine_notice: "seat";
     readonly subagent_alias: "seat";
+    readonly session_box_notice: "seat";
+    readonly resupply_truncated: "seat";
+    readonly host_setting_notice: "seat";
     readonly workflow_notification_enqueue: "host";
     readonly plan_review_park: "host";
     readonly approval_request: "host";
@@ -205,7 +223,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", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions"];
+export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster"];
 export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
 export interface SeatCapabilitiesState {
     pickFolder?: boolean;
@@ -220,6 +238,10 @@ export interface SeatCapabilitiesState {
     computerUseSwitch?: boolean;
     engineModeDefaultOnly?: boolean;
     seatActions?: boolean;
+    notificationLevels?: boolean;
+    modsView?: boolean;
+    quickEntryShortcut?: boolean;
+    hooksRoster?: boolean;
 }
 export type SeatCapabilityReading = {
     readonly kind: "reported";
@@ -285,6 +307,9 @@ export declare const SEAT_TURN_SETTINGS_ORIGINS: Readonly<{
     outputStyle: Readonly<{
         hostSupplied: "settings.outputStyle";
     }>;
+    env: Readonly<{
+        hostSupplied: "settings.env";
+    }>;
 }>;
 export interface SeatRewindIntent {
     mode: RewindMode;
@@ -348,6 +373,7 @@ export interface ToolPermissionDecision {
     answer?: QuestionAnswer;
     updatedInput?: unknown;
     remember?: "session";
+    feedback?: string;
 }
 export interface EipcStoreClient<T> {
     getState(): Promise<T>;
@@ -383,6 +409,29 @@ export interface StopAck {
 export interface OkAck {
     ok: boolean;
 }
+export type ToolPermissionAck = ToolPermissionAckSettled | ToolPermissionAckUnconfirmed;
+export interface ToolPermissionAckSettled extends OkAck {
+    settledElsewhere?: ToolPermissionSettledElsewhere;
+    unconfirmed?: never;
+}
+export interface ToolPermissionAckUnconfirmed extends OkAck {
+    ok: false;
+    unconfirmed: ToolPermissionUnconfirmed;
+    settledElsewhere?: never;
+}
+export type ToolPermissionAckState = {
+    readonly kind: "applied";
+} | {
+    readonly kind: "not_applied";
+} | {
+    readonly kind: "unconfirmed";
+    readonly cause: ToolPermissionUnconfirmedCause;
+};
+export interface DecisionRefusalCarrier {
+    readonly [key: string]: DecisionRefusalCarrierValue;
+}
+export type DecisionRefusalCarrierValue = string | number | boolean | null | undefined | readonly DecisionRefusalCarrierValue[] | DecisionRefusalCarrier;
+export type ToolPermissionRefusal = DecisionRefusalCarrier;
 export interface SessionsState {
     sessions: LocalSessionRecord[];
 }
@@ -482,7 +531,7 @@ export type SeatLocalMcpReading = {
     readAt: string;
     restartRequired?: true;
 };
-export declare const LOCAL_ENGINE_DOWN_REASONS: readonly ["lock-unavailable", "spawn-failed", "spawn-refused", "stop-failed", "crash-loop", "high-water-unreadable", "principal-unknown"];
+export declare const LOCAL_ENGINE_DOWN_REASONS: readonly ["lock-unavailable", "spawn-failed", "spawn-refused", "stop-failed", "crash-loop", "high-water-unreadable", "exited-once", "principal-unknown"];
 export type LocalEngineDownReason = (typeof LOCAL_ENGINE_DOWN_REASONS)[number];
 export declare const LOCAL_ENGINE_WAITING_REASONS: readonly ["starting", "dormant", "draining", "unanswered", "peer"];
 export type LocalEngineWaitingReason = (typeof LOCAL_ENGINE_WAITING_REASONS)[number];
@@ -515,13 +564,13 @@ export type SelfUpgradeOutcome = (typeof SELF_UPGRADE_OUTCOMES)[number];
 export interface EngineTargetLocal {
     lastBootError?: string;
     mcp?: SeatLocalMcpReading;
-    lifecycle?: LocalEngineSeatReading;
+    lifecycle: LocalEngineSeatReading;
 }
 export interface EngineTargetState {
     mode: "local" | "cloud";
     generation: number;
     cloud: EngineTargetCloud;
-    local: EngineTargetLocal;
+    local?: EngineTargetLocal;
 }
 export interface EngineTargetRefused {
     ok: false;
@@ -646,6 +695,46 @@ export interface OnboardProvidersResult {
 }
 export declare const checkOnboardEntryRequest: (v: unknown) => SeatValidation;
 export declare const checkOnboardApplyRequest: (v: unknown) => SeatValidation;
+export interface SessionModsView {
+    readonly rows: readonly WiringManifestModView[];
+}
+export declare const SESSION_HOOKS_ROSTER_STATUSES: readonly ["engine", "shell", "not_run"];
+export type SessionHooksRosterStatus = (typeof SESSION_HOOKS_ROSTER_STATUSES)[number];
+export type SessionHooksRosterEvent = (typeof SETTINGS_HOOK_EVENTS)[number];
+export interface SessionHooksRosterRow {
+    readonly source: HookSettingsSource;
+    readonly event: SessionHooksRosterEvent;
+    readonly groupIndex: number;
+    readonly hookIndex: number;
+    readonly type?: HookEntryTypeWord;
+    readonly status: SessionHooksRosterStatus;
+    readonly reason: PluginHookReason | PluginHookExclusionReason | SettingsHookDropReason;
+}
+export type SessionHooksRosterLayer = {
+    readonly source: HookSettingsSource;
+    readonly state: "loaded-partial";
+    readonly codes: readonly HooksSalvageDropCode[];
+} | {
+    readonly source: HookSettingsSource;
+    readonly state: "rejected";
+    readonly codes: readonly HooksSalvageRejectionCode[];
+} | {
+    readonly source: HookSettingsSource;
+    readonly state: "trust_withheld";
+};
+export interface SessionHooksRosterHttpRow {
+    readonly source: HookSettingsSource;
+    readonly event: SessionHooksRosterEvent;
+    readonly reason: HttpPolicyDropReason;
+}
+export interface SessionHooksRoster {
+    readonly closedBy: HooksWirePlan["closedBy"];
+    readonly sources?: readonly HookSettingsSource[];
+    readonly rows: readonly SessionHooksRosterRow[];
+    readonly layers: readonly SessionHooksRosterLayer[];
+    readonly http: readonly SessionHooksRosterHttpRow[];
+    readonly unlisted: number;
+}
 export declare const checkMcpToolToggleKey: (v: unknown) => SeatValidation;
 export interface McpToolTogglesResult {
     off: McpToolToggleKey[];
@@ -686,7 +775,62 @@ export type SetComputerUsePlan = {
     readonly reason: Exclude<ComputerUseRefusalReason, "write-failed">;
 };
 export declare function planSetComputerUse(request: {} | null | undefined, lockedByEnv: boolean): SetComputerUsePlan;
-export declare const SEAT_ACTION_NAMES: readonly ["new-project", "prefill-composer"];
+export declare const NOTIFICATION_LEVEL_TYPES: readonly ["permission", "question", "idle"];
+export type NotificationLevelType = (typeof NOTIFICATION_LEVEL_TYPES)[number];
+export declare const NOTIFICATION_LEVELS: readonly ["off", "badge", "banner"];
+export type NotificationLevel = (typeof NOTIFICATION_LEVELS)[number];
+export declare const NOTIFICATION_LEVEL_REFUSAL_REASONS: readonly ["invalid-request", "unsupported-level", "write-failed"];
+export type NotificationLevelRefusalReason = (typeof NOTIFICATION_LEVEL_REFUSAL_REASONS)[number];
+export interface NotificationLevelsState {
+    levels: Record<NotificationLevelType, NotificationLevel>;
+    supported: NotificationLevel[];
+}
+export type SetNotificationLevelResult = {
+    ok: true;
+    state: NotificationLevelsState;
+} | {
+    ok: false;
+    reason: NotificationLevelRefusalReason;
+    state: NotificationLevelsState;
+};
+export type SetNotificationLevelPlan = {
+    readonly kind: "apply";
+    readonly type: NotificationLevelType;
+    readonly level: NotificationLevel;
+} | {
+    readonly kind: "refused";
+    readonly reason: Exclude<NotificationLevelRefusalReason, "write-failed">;
+};
+export declare function planSetNotificationLevel(type: {} | null | undefined, level: {} | null | undefined, supported: readonly NotificationLevel[]): SetNotificationLevelPlan;
+export declare const QUICK_ENTRY_SHORTCUT_FAILURES: readonly ["invalid-accelerator", "registration-failed"];
+export type QuickEntryShortcutFailure = (typeof QUICK_ENTRY_SHORTCUT_FAILURES)[number];
+export declare const QUICK_ENTRY_SHORTCUT_REFUSAL_REASONS: readonly ["invalid-request", "invalid-accelerator", "registration-failed", "write-failed"];
+export type QuickEntryShortcutRefusalReason = (typeof QUICK_ENTRY_SHORTCUT_REFUSAL_REASONS)[number];
+export type QuickEntryShortcut = "off" | {
+    readonly accelerator: string;
+};
+export interface QuickEntryShortcutState {
+    saved: QuickEntryShortcut;
+    active: string | null;
+    savedFailure: QuickEntryShortcutFailure | null;
+}
+export type SetQuickEntryShortcutResult = {
+    ok: true;
+    state: QuickEntryShortcutState;
+} | {
+    ok: false;
+    reason: QuickEntryShortcutRefusalReason;
+    state: QuickEntryShortcutState;
+};
+export type SetQuickEntryShortcutPlan = {
+    readonly kind: "apply";
+    readonly next: QuickEntryShortcut;
+} | {
+    readonly kind: "refused";
+    readonly reason: "invalid-request";
+};
+export declare function planSetQuickEntryShortcut(request: {} | null | undefined): SetQuickEntryShortcutPlan;
+export declare const SEAT_ACTION_NAMES: readonly ["new-project", "prefill-composer", "open-local-setup"];
 export type SeatActionName = (typeof SEAT_ACTION_NAMES)[number];
 export type SeatAction = {
     readonly action: "new-project";
@@ -694,6 +838,8 @@ export type SeatAction = {
     readonly action: "prefill-composer";
     readonly text: string;
     readonly cwd?: string;
+} | {
+    readonly action: "open-local-setup";
 };
 export interface SeatActionsClaim {
     readonly actions: readonly string[];
@@ -717,7 +863,7 @@ export interface LocalSessionsApi {
     sendMessage(req: SendMessageRequest): Promise<SendMessageAck>;
     interrupt(req: SessionScopedRequest): Promise<InterruptAck>;
     stop(req: SessionScopedRequest): Promise<StopAck>;
-    respondToToolPermission(req: ToolPermissionDecision): Promise<OkAck>;
+    respondToToolPermission(req: ToolPermissionDecision): Promise<ToolPermissionAck>;
     cancelQueuedMessage(sessionId: string, userMessageUuid: string): Promise<boolean>;
     reorderQueuedMessage(sessionId: string, userMessageUuid: string, targetUserMessageUuid: string): Promise<boolean>;
     promoteQueuedMessage(sessionId: string, userMessageUuid: string): Promise<boolean>;
@@ -754,7 +900,13 @@ export interface LocalSessionsApi {
     setThinkingLatch(req: SetThinkingLatchRequest): Promise<OkAck>;
     getComputerUse(): Promise<ComputerUseState>;
     setComputerUse(req: SetComputerUseRequest): Promise<SetComputerUseResult>;
+    getNotificationLevels(): Promise<NotificationLevelsState>;
+    setNotificationLevel(type: NotificationLevelType, level: NotificationLevel): Promise<SetNotificationLevelResult>;
+    getQuickEntryShortcut(): Promise<QuickEntryShortcutState>;
+    setQuickEntryShortcut(next: QuickEntryShortcut): Promise<SetQuickEntryShortcutResult>;
     claimSeatActions(req: SeatActionsClaim): Promise<OkAck>;
+    readSessionMods(sessionId: string): Promise<SessionModsView | DeviceUnreadable | DeviceUnarmed>;
+    readSessionHooksRoster(sessionId: string): Promise<SessionHooksRoster | DeviceUnreadable | DeviceUnarmed>;
     onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
     onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
     onSeatAction(cb: (action: SeatAction) => void): () => void;
@@ -803,12 +955,14 @@ export declare function isSetThinkingLatchRequest(v: unknown): v is SetThinkingL
 export declare const checkStartSessionOptions: (v: unknown) => SeatValidation;
 export declare const checkSeatResourceScope: (v: unknown) => SeatValidation;
 export declare function isSendMessageAck(v: unknown): v is SendMessageAck;
+export declare function readToolPermissionSettledElsewhere(ack: object | null | undefined): ToolPermissionSettledElsewhere | undefined;
+export declare function readToolPermissionAckState(ack: ToolPermissionAck | null | undefined): ToolPermissionAckState | undefined;
 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", "answerEngineSwap", "beginSelfUpgrade", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "getComputerUse", "setComputerUse", "claimSeatActions", "onEvent", "onToolPermissionRequest", "onSeatAction"];
+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", "answerEngineSwap", "beginSelfUpgrade", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "getComputerUse", "setComputerUse", "getNotificationLevels", "setNotificationLevel", "getQuickEntryShortcut", "setQuickEntryShortcut", "claimSeatActions", "readSessionMods", "readSessionHooksRoster", "onEvent", "onToolPermissionRequest", "onSeatAction"];
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore", "engineTargetStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest", "onSeatAction"];
 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 TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "sessionRow", "probeReason", "probeCause", "feedbackCapable", "requestedBy", "frameReading", "inputSource"];
 export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane", "parkedUnresumable"];
 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: {
@@ -853,7 +1007,7 @@ export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
         readonly taskRequestKeys: readonly ["resumeAt", "resumeAtMode", "restoreFiles", "rewindFilesTo"];
     };
 };
-export declare const TOOL_PERMISSION_DECISION_KEYS: readonly ["sessionId", "requestId", "decision", "answer", "updatedInput", "remember"];
+export declare const TOOL_PERMISSION_DECISION_KEYS: readonly ["sessionId", "requestId", "decision", "answer", "updatedInput", "remember", "feedback"];
 export declare const START_SESSION_OPTION_KEYS: readonly ["model", "title", "cwd", "excludeTools", "engine"];
 export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     readonly LocalSessionRecord: {
@@ -893,9 +1047,27 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         }, {
             readonly key: "sessionRow";
             readonly why: "放宽方向的展示位(CC-699),判官在过境口 toolPermissionRequestAskBits(card, requestId):卡上「本会话放行」判官 standingRowsOf 的会话行同一前提 ∧ 本请求 requestId 的域带得走(live: / durable:),严格 true 才上座、永不铸 false;座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 才渲「本会话放行」,其余(缺席 / 坏形)一律不渲 —— 缺席是闭合失败,不是「没说就照渲」。不经过境口自铸座位请求的宿主拿不到这一位,座位卡就不给那一档。";
+        }, {
+            readonly key: "feedbackCapable";
+            readonly why: "放宽方向的展示位(CC-585),判官在过境口 toolPermissionRequestAskBits(card, requestId):卡判官 answerCarriage(card) 答 model(卡带耐久待决行腿的正向事实 parkRow)∧ 本请求 requestId 的域恰是 durable:(只有 /decide 收放行反馈位),严格 true 才上座、永不铸 false;座位门不设第二判官,理由同 sessionRow(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 才渲「Yes + 告诉 agent 下一步」那一格输入,其余(缺席 / 坏形)一律不渲 —— 缺席是闭合失败。不经过境口自铸座位请求的宿主拿不到这一位,座位卡就不给那一格。";
         }, {
             readonly key: "ruleOffersAbsence";
             readonly why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+        }, {
+            readonly key: "probeReason";
+            readonly why: "展示位(CC-1316),权威窄读在过境口 toolPermissionRequestAskBits,与「为什么问」那一句的读口 askProbeReasonDetail 同一个读点(自有数据属性、取值器不执行;串且去两端空白后非空才在场,原文字节);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。坏形读成缺席 ⇒ 卡上不显示这一句,不改决断;缺席不是「没有原因」。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+        }, {
+            readonly key: "probeCause";
+            readonly why: "展示位(CC-1316),与 probeReason 同一对、同一个读点;载体层判(自有数据属性、非 null 非数组对象)才在场,同一引用原样搬运,内部成员不校(成员的窄读归 askProbeReasonDetail / probeCauseRowsOf);座位门不设第二判官,理由同 probeReason。坏形读成缺席 ⇒ 不显示因由行,不改决断。两位按键隔离:一位读不出不连坐另一位。";
+        }, {
+            readonly key: "requestedBy";
+            readonly why: "展示位(CC-1341),权威窄读在过境口 toolPermissionRequestAskBits,读点是卡口的唯一载体级读口 approvalRequestedByOf(载体顶层的自有数据属性、取值器不执行;kind 恰 extension 且 name 非空串才在场,出冻结的新铸副本);原始耐久待决行不读(上游不在行上铸这一位);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。坏形读成缺席 ⇒ 卡上不显示发起者行,不改决断;缺席不是「模型发起」。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+        }, {
+            readonly key: "frameReading";
+            readonly why: "展示位(CC-1345),权威窄读在过境口 toolPermissionRequestAskBits,读点是包内唯一读口 cardPayloadReadingOf(卡上 cardPayloadUnreadable 严格 true ∧ cardPayloadUnreadableWhy 是判因闭集三词之一才在场;卡面通用卡第一行按因选句同读它);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。表外词 / 游离判因词 / 判因未知读成缺席 ⇒ 卡上回落不分因的原句,不改决断;缺席不是「帧读得出」。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+        }, {
+            readonly key: "inputSource";
+            readonly why: "展示位(CC-1366),权威窄读在过境口 toolPermissionRequestAskBits,读点是包内唯一窄读 approvalInputSourceOf(载体顶层的自有数据属性、取值器不执行;闭集 record / stream 两词精确字节才在场);来源位本身只有一个铸点(卡入参读法的读数 → 位),过境口只抄卡上已铸的位、不拿 input 重判来源,原始帧 / 原始耐久待决行直交恒缺席;座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。表外词 / 近义词 / 非串读成缺席 ⇒ 壳按来源不明处置,不改决断;缺席不是 record。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
         }];
     };
     readonly LocalSessionEvent: {
@@ -992,6 +1164,11 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly validated: readonly ["ok"];
         readonly unchecked: readonly [];
     };
+    readonly ToolPermissionAck: {
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["ok", "settledElsewhere", "unconfirmed"];
+        readonly unchecked: readonly [];
+    };
     readonly GetTranscriptResult: {
         readonly check: (v: unknown) => SeatValidation;
         readonly validated: readonly ["sessionId", "messages"];
@@ -1019,7 +1196,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", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions"];
+        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster"];
         readonly unchecked: readonly [];
     };
     readonly RecentFoldersResult: {
@@ -1059,7 +1236,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
 };
 export declare const SEAT_VALIDATOR_COVERAGE_EXEMPT: readonly [...{
-    label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey" | "ComputerUseState" | "SetComputerUseResult" | "SetComputerUseRequest" | "SeatAction" | "EngineSwapAnswerOutcome" | "SelfUpgradeOutcome";
+    label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey" | "ComputerUseState" | "SetComputerUseResult" | "SetComputerUseRequest" | "NotificationLevelsState" | "SetNotificationLevelResult" | "SeatAction" | "EngineSwapAnswerOutcome" | "SelfUpgradeOutcome" | "SessionModsResult" | "QuickEntryShortcutState" | "SetQuickEntryShortcutResult" | "SessionHooksRosterResult";
     check: (v: unknown) => SeatValidation;
     why: string;
 }[], {