@sema-agent/client-core 0.110.0 → 0.111.0

package/dist/seatContract.d.ts

@@ -22,6 +22,11 @@ import { type SessionEngineKind, type SessionEngineView } from "./sessionEngine.
 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;
@@ -121,6 +126,8 @@ declare const CHROME_ARM_SEAT_ROUTE: {
     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";
@@ -216,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", "notificationLevels", "modsView"];
+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;
@@ -233,6 +240,8 @@ export interface SeatCapabilitiesState {
     seatActions?: boolean;
     notificationLevels?: boolean;
     modsView?: boolean;
+    quickEntryShortcut?: boolean;
+    hooksRoster?: boolean;
 }
 export type SeatCapabilityReading = {
     readonly kind: "reported";
@@ -400,9 +409,29 @@ export interface StopAck {
 export interface OkAck {
     ok: boolean;
 }
-export interface ToolPermissionAck extends OkAck {
+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[];
 }
@@ -502,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];
@@ -541,7 +570,7 @@ export interface EngineTargetState {
     mode: "local" | "cloud";
     generation: number;
     cloud: EngineTargetCloud;
-    local: EngineTargetLocal;
+    local?: EngineTargetLocal;
 }
 export interface EngineTargetRefused {
     ok: false;
@@ -669,6 +698,43 @@ 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[];
@@ -736,7 +802,35 @@ export type SetNotificationLevelPlan = {
     readonly reason: Exclude<NotificationLevelRefusalReason, "write-failed">;
 };
 export declare function planSetNotificationLevel(type: {} | null | undefined, level: {} | null | undefined, supported: readonly NotificationLevel[]): SetNotificationLevelPlan;
-export declare const SEAT_ACTION_NAMES: readonly ["new-project", "prefill-composer"];
+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";
@@ -744,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[];
@@ -806,8 +902,11 @@ export interface LocalSessionsApi {
     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;
@@ -857,8 +956,9 @@ 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", "getNotificationLevels", "setNotificationLevel", "claimSeatActions", "readSessionMods", "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"];
@@ -1066,7 +1166,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
     readonly ToolPermissionAck: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["ok", "settledElsewhere"];
+        readonly validated: readonly ["ok", "settledElsewhere", "unconfirmed"];
         readonly unchecked: readonly [];
     };
     readonly GetTranscriptResult: {
@@ -1096,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", "notificationLevels", "modsView"];
+        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster"];
         readonly unchecked: readonly [];
     };
     readonly RecentFoldersResult: {
@@ -1136,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" | "NotificationLevelsState" | "SetNotificationLevelResult" | "SeatAction" | "EngineSwapAnswerOutcome" | "SelfUpgradeOutcome" | "SessionModsResult";
+    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;
 }[], {

package/dist/seatContract.js

@@ -1,4 +1,5 @@
 import { PERMISSION_MODE_WORDS, REASONING_EFFORT_WORDS } from "./taskRequestWords.js";
+import { CC_TOOL_DENIAL_KINDS } from "./gateVocabulary.js";
 import { liveDefaultModelCopy, liveModelRowCopy } from "./model/liveCatalogShape.js";
 import { REWIND_MODES } from "./rewindWireCaps.js";
 import { SETTINGS_MODEL_API_WORDS } from "./generated/settingsSchemaTables.js";
@@ -11,6 +12,10 @@ import { THINKING_LATCH_EVENTS, THINKING_LATCH_ROW_WORDS } from "./thinkingLatch
 import { EXECUTION_PLACEMENT_ROLES } from "./executionPlacementWords.js";
 import { isSessionEngineView } from "./sessionEngine.js";
 import { LOCAL_ENGINE_SWAP_CAUSES } from "./localEngineSwapCard.js";
+import { HOOK_ENTRY_TYPE_WORDS, PLUGIN_HOOK_EXCLUSION_REASONS, PLUGIN_HOOK_REASONS, SETTINGS_HOOK_DROP_REASONS, } from "./pluginHooksWire.js";
+import { HTTP_POLICY_DROP_REASONS } from "./httpHookPolicy.js";
+import { HOOK_SETTINGS_SOURCE_TEXT } from "./settingsHooksSalvage.js";
+import { SETTINGS_HOOK_EVENTS, SETTINGS_HOOKS_DROPPED_PIECE_CODES, SETTINGS_HOOKS_REJECTION_CODES } from "./generated/settingsSchemaFns.js";
 const bad = (reason, field) => field === undefined ? { reason } : { reason, field };
 const nested = (prefix, verdict) => {
     const path = verdict.field === undefined
@@ -311,6 +316,8 @@ const CHROME_ARM_SEAT_ROUTE = {
     engine_notice: "seat",
     subagent_alias: "seat",
     session_box_notice: "seat",
+    resupply_truncated: "seat",
+    host_setting_notice: "seat",
     workflow_notification_enqueue: "host",
     plan_review_park: "host",
     approval_request: "host",
@@ -399,7 +406,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", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView"]);
+export const SEAT_CAPABILITY_NAMES = Object.freeze(["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster"]);
 const notReported = () => Object.freeze({ kind: "not_reported" });
 const malformedReading = () => Object.freeze({ kind: "malformed" });
 const reported = (available) => Object.freeze({ kind: "reported", available });
@@ -481,6 +488,8 @@ const SEAT_CAPABILITY_PHRASES = Object.freeze({
     seatActions: Object.freeze({ action: "App menu actions", ability: "send actions to this window", support: "app action support" }),
     notificationLevels: Object.freeze({ action: "Choosing notification levels", ability: "keep notification levels", support: "notification-level support" }),
     modsView: Object.freeze({ action: "Showing mods", ability: "show mods", support: "mods support" }),
+    quickEntryShortcut: Object.freeze({ action: "Changing the Quick Entry shortcut", ability: "change the Quick Entry shortcut", support: "Quick Entry shortcut support" }),
+    hooksRoster: Object.freeze({ action: "Showing hooks", ability: "show hooks", support: "hooks support" }),
 });
 export function seatCapabilityUnavailableDetail(name, reading) {
     const phrase = Object.hasOwn(SEAT_CAPABILITY_PHRASES, name)
@@ -715,6 +724,7 @@ export const LOCAL_ENGINE_DOWN_REASONS = Object.freeze([
     "stop-failed",
     "crash-loop",
     "high-water-unreadable",
+    "exited-once",
     "principal-unknown",
 ]);
 export const LOCAL_ENGINE_WAITING_REASONS = Object.freeze(["starting", "dormant", "draining", "unanswered", "peer"]);
@@ -874,7 +884,7 @@ const ENGINE_TARGET_STATE = shapeRule("engine target", {
     mode: reqF(R_ENGINE_LANE),
     generation: reqF(R_INT0),
     cloud: reqF(ENGINE_TARGET_CLOUD),
-    local: reqF(ENGINE_TARGET_LOCAL),
+    local: optF(ENGINE_TARGET_LOCAL),
 });
 const checkEngineTargetState = seatShapeCheck(ENGINE_TARGET_STATE);
 const okArmsRule = (label, okSpec, refusedSpec) => ({
@@ -1116,6 +1126,78 @@ const checkSessionModsResult = seatCheck((v) => {
         return bad("not object");
     return Object.hasOwn(v, "kind") ? checkSessionModsFailure(v) : checkSessionModsView(v);
 });
+export const SESSION_HOOKS_ROSTER_STATUSES = Object.freeze(["engine", "shell", "not_run"]);
+const HOOKS_ROSTER_CLOSED_BY = Object.freeze(["workspace_untrusted", "governance_unreadable", "policy_disable_all"]);
+const HOOKS_ROSTER_REASONS = Object.freeze([...new Set([...PLUGIN_HOOK_REASONS, ...PLUGIN_HOOK_EXCLUSION_REASONS, ...SETTINGS_HOOK_DROP_REASONS])]);
+const R_HOOK_SOURCE = ruleOf("hook source", (v) => typeof v === "string" && Object.hasOwn(HOOK_SETTINGS_SOURCE_TEXT, v));
+const R_HOOK_EVENT = oneOfRule("hook event", SETTINGS_HOOK_EVENTS);
+const HOOKS_ROSTER_ROW_SHAPE = shapeRule("hooks roster row", {
+    source: reqF(R_HOOK_SOURCE),
+    event: reqF(R_HOOK_EVENT),
+    groupIndex: reqF(R_INT0),
+    hookIndex: reqF(R_INT0),
+    type: optF(oneOfRule("hook type", HOOK_ENTRY_TYPE_WORDS)),
+    status: reqF(oneOfRule("hooks roster status", SESSION_HOOKS_ROSTER_STATUSES)),
+    reason: reqF(oneOfRule("hooks roster reason", HOOKS_ROSTER_REASONS)),
+});
+const HOOKS_ROSTER_ROW = {
+    label: HOOKS_ROSTER_ROW_SHAPE.label,
+    test: (v, path) => {
+        const verdict = HOOKS_ROSTER_ROW_SHAPE.test(v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        const status = own(rec, "status");
+        const reason = own(rec, "reason");
+        if (status === "engine" && !PLUGIN_HOOK_REASONS.includes(reason))
+            return bad("status conflict", pathAt(path, "reason"));
+        return true;
+    },
+};
+const HOOKS_ROSTER_LAYER = armsRule("hooks roster layer", "state", {
+    "loaded-partial": { source: reqF(R_HOOK_SOURCE), codes: reqF(arrayRule(oneOfRule("hooks drop code", SETTINGS_HOOKS_DROPPED_PIECE_CODES), true)) },
+    rejected: { source: reqF(R_HOOK_SOURCE), codes: reqF(arrayRule(oneOfRule("hooks rejection code", SETTINGS_HOOKS_REJECTION_CODES), true)) },
+    trust_withheld: { source: reqF(R_HOOK_SOURCE) },
+});
+const HOOKS_ROSTER_HTTP_ROW = shapeRule("hooks roster http row", {
+    source: reqF(R_HOOK_SOURCE),
+    event: reqF(R_HOOK_EVENT),
+    reason: reqF(oneOfRule("http policy reason", HTTP_POLICY_DROP_REASONS)),
+});
+const HOOKS_ROSTER_SHAPE = shapeRule("hooks roster", {
+    closedBy: reqF(ruleOf("closedBy", (v) => v === null || (typeof v === "string" && inTuple(HOOKS_ROSTER_CLOSED_BY, v)))),
+    sources: optF(arrayRule(R_HOOK_SOURCE)),
+    rows: reqF(arrayRule(HOOKS_ROSTER_ROW)),
+    layers: reqF(arrayRule(HOOKS_ROSTER_LAYER)),
+    http: reqF(arrayRule(HOOKS_ROSTER_HTTP_ROW)),
+    unlisted: reqF(R_INT0),
+});
+const checkSessionHooksRosterView = seatShapeCheck({
+    label: HOOKS_ROSTER_SHAPE.label,
+    test: (v, path) => {
+        const verdict = HOOKS_ROSTER_SHAPE.test(v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        if (own(rec, "closedBy") === null)
+            return true;
+        const rows = ownItems(own(rec, "rows"));
+        for (let i = 0; i < rows.length; i += 1) {
+            if (own(rows[i], "status") !== "not_run")
+                return bad("status conflict", pathAt(path, `rows[${i}].status`));
+        }
+        return true;
+    },
+});
+const checkSessionHooksRosterFailure = seatShapeCheck(armsRule("readSessionHooksRoster failure", "kind", {
+    unreadable: DEVICE_UNREADABLE_SPEC,
+    unarmed: {},
+}));
+const checkSessionHooksRosterResult = seatCheck((v) => {
+    if (!isPlainRecord(v))
+        return bad("not object");
+    return Object.hasOwn(v, "kind") ? checkSessionHooksRosterFailure(v) : checkSessionHooksRosterView(v);
+});
 const MCP_TOOL_TOGGLE_KEY = shapeRule("toggle key", {
     server: reqF(R_NONEMPTY),
     tool: reqF(R_NONEMPTY),
@@ -1280,7 +1362,75 @@ export function planSetNotificationLevel(type, level, supported) {
         return Object.freeze({ kind: "refused", reason: "unsupported-level" });
     return Object.freeze({ kind: "apply", type, level });
 }
-export const SEAT_ACTION_NAMES = Object.freeze(["new-project", "prefill-composer"]);
+export const QUICK_ENTRY_SHORTCUT_FAILURES = Object.freeze(["invalid-accelerator", "registration-failed"]);
+export const QUICK_ENTRY_SHORTCUT_REFUSAL_REASONS = Object.freeze(["invalid-request", "invalid-accelerator", "registration-failed", "write-failed"]);
+const QUICK_ENTRY_ACCELERATOR_SPEC = { accelerator: reqF(R_NONEMPTY) };
+const R_QUICK_ENTRY_SHORTCUT = {
+    label: "quick entry shortcut",
+    test: (v, path) => (v === "off" ? true : shapeVerdict(QUICK_ENTRY_ACCELERATOR_SPEC, v, path)),
+};
+const QUICK_ENTRY_STATE_SHAPE = shapeRule("quick entry shortcut state", {
+    saved: reqF(R_QUICK_ENTRY_SHORTCUT),
+    active: reqF(ruleOf("active accelerator", (v) => v === null || (typeof v === "string" && v.length > 0))),
+    savedFailure: reqF(ruleOf("saved failure", (v) => v === null || (typeof v === "string" && inTuple(QUICK_ENTRY_SHORTCUT_FAILURES, v)))),
+});
+const QUICK_ENTRY_STATE = {
+    label: QUICK_ENTRY_STATE_SHAPE.label,
+    test: (v, path) => {
+        const verdict = QUICK_ENTRY_STATE_SHAPE.test(v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        if (own(rec, "savedFailure") === null)
+            return true;
+        const saved = own(rec, "saved");
+        if (saved === "off")
+            return bad("failure conflict", pathAt(path, "savedFailure"));
+        if (own(rec, "active") === own(saved, "accelerator"))
+            return bad("failure conflict", pathAt(path, "active"));
+        return true;
+    },
+};
+const checkQuickEntryShortcutState = seatShapeCheck(QUICK_ENTRY_STATE);
+const SET_QUICK_ENTRY_SHORTCUT_RESULT = okArmsRule("setQuickEntryShortcut result", { state: reqF(QUICK_ENTRY_STATE) }, {
+    reason: reqF(oneOfRule("quick entry refusal", QUICK_ENTRY_SHORTCUT_REFUSAL_REASONS)),
+    state: reqF(QUICK_ENTRY_STATE),
+});
+const checkSetQuickEntryShortcutResult = seatShapeCheck({
+    label: SET_QUICK_ENTRY_SHORTCUT_RESULT.label,
+    test: (v, path) => {
+        const verdict = SET_QUICK_ENTRY_SHORTCUT_RESULT.test(v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        if (own(rec, "ok") === true && own(own(rec, "state"), "savedFailure") !== null)
+            return bad("failure conflict", pathAt(path, "state.savedFailure"));
+        return true;
+    },
+});
+export function planSetQuickEntryShortcut(request) {
+    const refused = Object.freeze({ kind: "refused", reason: "invalid-request" });
+    if (request === "off")
+        return Object.freeze({ kind: "apply", next: "off" });
+    try {
+        if (!isPlainRecord(request) || firstAccessorPath(request) !== undefined)
+            return refused;
+        const snap = new Map();
+        for (const k of Reflect.ownKeys(request))
+            if (typeof k === "string")
+                snap.set(k, own(request, k));
+        if (snap.size !== 1 || !snap.has("accelerator"))
+            return refused;
+        const accelerator = snap.get("accelerator");
+        if (typeof accelerator !== "string" || accelerator.length === 0)
+            return refused;
+        return Object.freeze({ kind: "apply", next: Object.freeze({ accelerator }) });
+    }
+    catch {
+        return refused;
+    }
+}
+export const SEAT_ACTION_NAMES = Object.freeze(["new-project", "prefill-composer", "open-local-setup"]);
 const SEAT_PREFILL_TEXT_MAX = 14336;
 const SEAT_PREFILL_CWD_MAX = 4096;
 const SEAT_ACTIONS_CLAIM_MAX = 16;
@@ -1293,6 +1443,7 @@ const R_PREFILL_CWD = ruleOf(`folder path (1–${SEAT_PREFILL_CWD_MAX} chars, no
 const SEAT_ACTION_ARMS = {
     "new-project": {},
     "prefill-composer": { text: reqF(R_PREFILL_TEXT), cwd: optF(R_PREFILL_CWD) },
+    "open-local-setup": {},
 };
 export const checkSeatAction = seatShapeCheck(armsRule("seat action", "action", SEAT_ACTION_ARMS));
 const seatActionMalformed = (reason) => Object.freeze({ kind: "malformed", reason });
@@ -1311,6 +1462,8 @@ export function readSeatAction(ev) {
         }
         if (name === "new-project")
             return Object.freeze({ kind: "action", action: Object.freeze({ action: "new-project" }) });
+        if (name === "open-local-setup")
+            return Object.freeze({ kind: "action", action: Object.freeze({ action: "open-local-setup" }) });
         const text = own(ev, "text");
         const cwd = own(ev, "cwd");
         if (R_PREFILL_TEXT.test(text, "text") !== true || typeof text !== "string")
@@ -1763,6 +1916,8 @@ const SUBAGENT_CONTENT_SHAPE = shapeRule("subagent content", {
     output: optF(R_STR),
     isError: optF(R_BOOL),
     notExecuted: optF(R_TRUE),
+    denialKind: optF(oneOfRule("denial kind", CC_TOOL_DENIAL_KINDS)),
+    refusalNoted: optF(R_TRUE),
 });
 export function readSeatSubagentContent(event) {
     try {
@@ -2037,23 +2192,43 @@ const R_SETTLED_ELSEWHERE = shapeRule("settled elsewhere", {
     firstDecision: reqF(oneOfRule("decision word", TOOL_PERMISSION_SETTLED_WORDS)),
     contrary: reqF(R_BOOL),
 });
-const checkToolPermissionAck = seatCheck((v) => {
-    const base = okAckVerdict(v);
-    if (base !== true)
-        return base;
-    const slot = own(v, "settledElsewhere");
-    return isAbsent(slot) ? true : R_SETTLED_ELSEWHERE.test(slot, "settledElsewhere");
+const TOOL_PERMISSION_UNCONFIRMED_CAUSES = Object.freeze(["transport", "server_error", "local_error", "aborted", "gone_after_retry", "registry_unreadable"]);
+const R_UNCONFIRMED = shapeRule("unconfirmed", {
+    cause: reqF(oneOfRule("cause word", TOOL_PERMISSION_UNCONFIRMED_CAUSES)),
+});
+const R_TOOL_PERMISSION_ACK = shapeRule("permission ack", {
+    ok: reqF(R_BOOL),
+    settledElsewhere: optF(R_SETTLED_ELSEWHERE),
+    unconfirmed: optF(R_UNCONFIRMED),
 });
-const checkSettledElsewhereSlot = seatCheck((v) => R_SETTLED_ELSEWHERE.test(v, "settledElsewhere"));
+const TOOL_PERMISSION_ACK_SLOTS = [["settledElsewhere"], ["unconfirmed"]];
+const R_FALSE = ruleOf("false", (v) => v === false);
+function toolPermissionAckVerdict(v) {
+    if (!isPlainRecord(v))
+        return okAckVerdict(v);
+    const shape = R_TOOL_PERMISSION_ACK.test(v, "");
+    if (shape !== true)
+        return shape;
+    const ack = v;
+    const groups = keyGroupsVerdict(TOOL_PERMISSION_ACK_SLOTS, ack, "");
+    if (groups !== true)
+        return groups;
+    const ok = own(ack, "ok");
+    if (!isAbsent(own(ack, "unconfirmed")))
+        return R_FALSE.test(ok, "ok");
+    const settled = own(ack, "settledElsewhere");
+    if (isAbsent(settled))
+        return true;
+    return own(settled, "contrary") === true ? R_FALSE.test(ok, "ok") : R_TRUE.test(ok, "ok");
+}
+const checkToolPermissionAck = seatShapeCheck({ label: "permission ack", test: (v) => toolPermissionAckVerdict(v) });
 export function readToolPermissionSettledElsewhere(ack) {
     try {
-        if (typeof ack !== "object" || ack === null)
+        if (checkToolPermissionAck(ack) !== true)
             return undefined;
         const slot = own(ack, "settledElsewhere");
         if (isAbsent(slot))
             return undefined;
-        if (checkSettledElsewhereSlot(slot) !== true)
-            return undefined;
         const first = own(slot, "firstDecision");
         return Object.freeze({ firstDecision: first === "allow" ? "allow" : "deny", contrary: own(slot, "contrary") === true });
     }
@@ -2061,6 +2236,22 @@ export function readToolPermissionSettledElsewhere(ack) {
         return undefined;
     }
 }
+export function readToolPermissionAckState(ack) {
+    try {
+        if (checkToolPermissionAck(ack) !== true)
+            return undefined;
+        const un = own(ack, "unconfirmed");
+        if (!isAbsent(un)) {
+            const word = own(un, "cause");
+            const cause = TOOL_PERMISSION_UNCONFIRMED_CAUSES.find((w) => w === word);
+            return cause === undefined ? undefined : Object.freeze({ kind: "unconfirmed", cause });
+        }
+        return own(ack, "ok") === true ? Object.freeze({ kind: "applied" }) : Object.freeze({ kind: "not_applied" });
+    }
+    catch {
+        return undefined;
+    }
+}
 const checkBooleanAck = (v) => typeof v === "boolean" ? true : bad("expected a bare boolean result");
 const checkGetTranscriptResult = seatCheck((v) => {
     if (!isPlainRecord(v))
@@ -2221,8 +2412,11 @@ export const LOCAL_SESSIONS_SPEC = {
         setComputerUse: { kind: "invoke", check: checkSetComputerUseResult },
         getNotificationLevels: { kind: "invoke", check: checkNotificationLevelsState },
         setNotificationLevel: { kind: "invoke", check: checkSetNotificationLevelResult },
+        getQuickEntryShortcut: { kind: "invoke", check: checkQuickEntryShortcutState },
+        setQuickEntryShortcut: { kind: "invoke", check: checkSetQuickEntryShortcutResult },
         claimSeatActions: { kind: "invoke", check: checkOkAck },
         readSessionMods: { kind: "invoke", check: checkSessionModsResult },
+        readSessionHooksRoster: { kind: "invoke", check: checkSessionHooksRosterResult },
         onEvent: { kind: "event", check: checkLocalSessionEvent },
         onToolPermissionRequest: { kind: "event", check: checkToolPermissionRequest },
         onSeatAction: { kind: "event", check: checkSeatAction },
@@ -2278,8 +2472,11 @@ export const SEAT_METHOD_NAMES = [
     "setComputerUse",
     "getNotificationLevels",
     "setNotificationLevel",
+    "getQuickEntryShortcut",
+    "setQuickEntryShortcut",
     "claimSeatActions",
     "readSessionMods",
+    "readSessionHooksRoster",
     "onEvent",
     "onToolPermissionRequest",
     "onSeatAction",
@@ -2601,7 +2798,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     },
     ToolPermissionAck: {
         check: checkToolPermissionAck,
-        validated: ["ok", "settledElsewhere"],
+        validated: ["ok", "settledElsewhere", "unconfirmed"],
         unchecked: [],
     },
     GetTranscriptResult: {
@@ -2631,7 +2828,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     },
     SeatCapabilitiesState: {
         check: checkSeatCapabilitiesState,
-        validated: ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView"],
+        validated: ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly", "seatActions", "notificationLevels", "modsView", "quickEntryShortcut", "hooksRoster"],
         unchecked: [],
     },
     RecentFoldersResult: {
@@ -2703,6 +2900,9 @@ export const SEAT_VALIDATOR_COVERAGE_EXEMPT = [
         ["EngineSwapAnswerOutcome", checkEngineSwapAnswerOutcome],
         ["SelfUpgradeOutcome", checkSelfUpgradeOutcome],
         ["SessionModsResult", checkSessionModsResult],
+        ["QuickEntryShortcutState", checkQuickEntryShortcutState],
+        ["SetQuickEntryShortcutResult", checkSetQuickEntryShortcutResult],
+        ["SessionHooksRosterResult", checkSessionHooksRosterResult],
     ].map(([label, check]) => ({
         label,
         check,
@@ -2770,5 +2970,8 @@ const _seatContractPins = [
     true, true, true, true, true,
     true, true, true,
     true, true, true, true,
+    true, true, true, true,
+    true, true, true, true, true, true,
+    true, true, true, true, true,
 ];
 void _seatContractPins;