@sema-agent/client-core 0.104.1 → 0.106.0

package/dist/runTerminal.js

@@ -1,7 +1,7 @@
 import { CORE_PROMPT_BLOCK_CAUSES } from './generated/engineFactTables.js';
 import { isSdkRunParked } from './terminalStatuses.js';
+import { runRowSentenceOf, terminalLayerOf } from './replayBody.js';
 import { readOwnDataNonEmptyString, readOwnDataValue } from './ownKey.js';
-import { doneResultView } from './replayBody.js';
 import { washCredentials } from './displayUntrusted.js';
 export const PROMPT_BLOCK_CAUSES = CORE_PROMPT_BLOCK_CAUSES;
 const _promptBlockTablePin = true;
@@ -300,18 +300,40 @@ function blockedDetailOf(cause) {
     }
 }
 export function readRunTerminal(result) {
-    if (typeof result !== 'object' || result === null || Array.isArray(result))
-        return null;
-    const view = doneResultView(result);
-    if (view.replay) {
-        return readRunTerminalArm(view.engine) ?? readRunTerminalArm({ status: view.row?.status, errorCode: view.row?.errorCode, errorMessage: view.row?.error });
+    const layer = terminalLayerOf(result);
+    const read = readRunTerminalArm(layer);
+    if (read === null || read.kind !== 'failed' || read.plane !== 'flat' || read.message !== undefined || layer !== result)
+        return read;
+    const sentence = runRowSentenceOf(result);
+    return sentence === undefined ? read : { ...read, message: sentence };
+}
+function topLevelSnapshotOf(o) {
+    const snap = Object.create(null);
+    for (const k of ['terminal', 'status', 'errorCode', 'errorMessage', 'blockedReason', 'checkpointGate', 'checkpointId', 'workspaceRestoreMode']) {
+        let present;
+        try {
+            present = k in o;
+        }
+        catch {
+            return undefined;
+        }
+        if (!present)
+            continue;
+        try {
+            snap[k] = o[k];
+        }
+        catch {
+            snap[k] = undefined;
+        }
     }
-    return readRunTerminalArm(result);
+    return snap;
 }
 function readRunTerminalArm(result) {
     if (typeof result !== 'object' || result === null || Array.isArray(result))
         return null;
-    const r = result;
+    const r = topLevelSnapshotOf(result);
+    if (r === undefined)
+        return null;
     if ('terminal' in r) {
         const t = r.terminal;
         const c = typeof t === 'object' && t !== null && !Array.isArray(t) ? t : undefined;

package/dist/sandboxWire.d.ts

@@ -20,9 +20,6 @@ export declare function sandboxRequestFields(sel: SandboxSelection | undefined):
 };
 export declare const AUTO_SANDBOX_ADVISORY: string;
 export declare function wrapObjectiveWithAutoSandboxAdvisory(objective: string): string;
-export declare const SANDBOX_K8S_ONLY_400_ANCHOR = "only supported on the k8s sandbox backend";
-export declare const SANDBOX_NO_IMAGE_INDEX_400_ANCHOR = "requires the image index";
-export declare const SANDBOX_NO_PUBLISHED_IMAGE_404_ANCHOR = "no published sandbox image for profile";
 export declare const SANDBOX_CASCADE_CONFLICT_400_ANCHOR = "not supported together with cascade/verify";
 export type SandboxHintHost = 'terminal' | 'web' | 'desktop';
 export declare const SANDBOX_HINT_HOSTS: readonly SandboxHintHost[];

package/dist/sandboxWire.js

@@ -41,9 +41,6 @@ export const AUTO_SANDBOX_ADVISORY = '<sandbox-auto-select>\n' +
 export function wrapObjectiveWithAutoSandboxAdvisory(objective) {
     return `${AUTO_SANDBOX_ADVISORY}\n\n${objective}`;
 }
-export const SANDBOX_K8S_ONLY_400_ANCHOR = 'only supported on the k8s sandbox backend';
-export const SANDBOX_NO_IMAGE_INDEX_400_ANCHOR = 'requires the image index';
-export const SANDBOX_NO_PUBLISHED_IMAGE_404_ANCHOR = 'no published sandbox image for profile';
 export const SANDBOX_CASCADE_CONFLICT_400_ANCHOR = 'not supported together with cascade/verify';
 export const SANDBOX_HINT_HOSTS = Object.freeze(['terminal', 'web', 'desktop']);
 const SANDBOX_HINT_ARMS = Object.freeze({
@@ -146,12 +143,6 @@ export function sandboxDegradeHint(err, host, sentRequest) {
         const msg = err.message;
         if (typeof msg !== 'string')
             return undefined;
-        if (noCode && status === 400 && msg.includes(SANDBOX_K8S_ONLY_400_ANCHOR))
-            return sandboxHintOf(SANDBOX_HINT_ARMS.k8sLaneOnly, host);
-        if (noCode && status === 400 && msg.includes(SANDBOX_NO_IMAGE_INDEX_400_ANCHOR))
-            return sandboxHintOf(SANDBOX_HINT_ARMS.imageIndexRequired, host);
-        if (noCode && status === 404 && msg.includes(SANDBOX_NO_PUBLISHED_IMAGE_404_ANCHOR))
-            return sandboxHintOf(SANDBOX_HINT_ARMS.noPublishedImage404, host);
         if (status === 400 && msg.includes(SANDBOX_CASCADE_CONFLICT_400_ANCHOR))
             return sandboxHintOf(SANDBOX_HINT_ARMS.cascadeConflict400, host);
         return undefined;

package/dist/seam.d.ts

@@ -1,10 +1,11 @@
 import type { ModelUsage, SDKMessage } from '@sema-agent/agent-types';
 import type { EngineTurnUsage } from './adapter/downstream/turnUsageToModelUsage.js';
 import type { RunCostReconcile } from './adapter/downstream/terminalToSdkResult.js';
-import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestHookEntryView, WiringManifestLspSeamView, WiringManifestWriteProtectionView, WiringManifestAutoConsolidationView, WiringManifestReadDenyView, WiringManifestModView, ContextUsageSectionView, PromptManifestSectionView, PromptManifestBlockView, PromptManifestToolView, PromptManifestIdentityView } from './adapter/downstream/eventToSdkMessage.js';
+import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestLspSeamView, WiringManifestWriteProtectionView, WiringManifestAutoConsolidationView, WiringManifestReadDenyView, WiringManifestModView, ContextUsageSectionView, PromptManifestSectionView, PromptManifestBlockView, PromptManifestToolView, PromptManifestIdentityView } from './adapter/downstream/eventToSdkMessage.js';
 import type { ToolRosterView, ToolRosterDeltaView, WiringManifestHandsView } from './toolRoster.js';
 import type { WiringManifestFleetView } from './adapter/downstream/wiringManifestView.js';
 import type { SuspendedReopenReading } from './hitl/suspendedReopen.js';
+import type { PlanReviewCardFacts } from './planReviewCardFacts.js';
 import type { ToolKillCause } from './toolResult.js';
 import type { HumanInputAttachmentView } from './ownKey.js';
 import type { TaskNotificationFields } from './notifications.js';
@@ -117,6 +118,7 @@ export type ChromeEvent = {
     summary: string;
     message: string;
     notification: Readonly<TaskNotificationFields>;
+    diagnostics?: string;
 } | {
     kind: 'task_ledger_sync';
     laneProof: LaneProof;
@@ -159,10 +161,11 @@ export type ChromeEvent = {
     kind: 'plan_review_park';
     laneProof: LaneProof;
     result: unknown;
+    planReview?: PlanReviewCardFacts;
 } | ({
     kind: 'run_cost_reconciled';
     laneProof: LaneProof;
-} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | CompactionStartedChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | CompactionStartedChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | ApprovalCompleteChromeEvent | SessionTitledChromeEvent | {
     kind: 'suspended_reopened';
     laneProof: LaneProof;
     reopen: Extract<SuspendedReopenReading, {
@@ -179,7 +182,6 @@ export interface WiringManifestChromeEvent {
     autoMode?: WiringManifestAutoMode;
     mcp?: readonly WiringManifestMcpEntryView[];
     tools?: ToolRosterView;
-    hooks?: readonly WiringManifestHookEntryView[];
     lsp?: WiringManifestLspSeamView;
     writeProtection?: WiringManifestWriteProtectionView;
     autoConsolidation?: WiringManifestAutoConsolidationView;
@@ -308,17 +310,25 @@ export interface ThinkingSegmentEndChromeEvent {
     committedUuids?: readonly string[];
     eventId?: string;
 }
-export interface ApprovalRequestChromeEvent {
+export interface ApprovalRequestChromeEvent extends ApprovalFrameChromeEnvelope {
     kind: 'approval_request';
+}
+export interface ApprovalFrameChromeEnvelope {
     laneProof: LaneProof;
     frame: unknown;
     schemaVersion: number;
 }
-export interface ApprovalRevokeChromeEvent {
+export interface ApprovalCompleteChromeEvent extends ApprovalFrameChromeEnvelope {
+    kind: 'approval_complete';
+}
+export interface ApprovalRevokeChromeEvent extends ApprovalFrameChromeEnvelope {
     kind: 'approval_revoke';
+}
+export interface SessionTitledChromeEvent {
+    kind: 'session_titled';
     laneProof: LaneProof;
-    frame: unknown;
-    schemaVersion: number;
+    sessionId: string;
+    title: string;
 }
 export interface ResultTextDivergedChromeEvent {
     kind: 'result_text_diverged';

package/dist/seam.js

@@ -32,7 +32,7 @@ const CHROME_ARM_TABLE = {
             '🔴 `usageMissing` 在场时同行 usage 是**下界**,渲「≥」不渲已知账;' +
             '🔴 终帧的 `_sema_nested_usage_by_task` 是同一份账的**收口快照**,两者**不相加**(本臂是增量、那是合计)',
     },
-    plan_review_park: { required: true, duty: '弹 plan 审批卡(fail-soft,不挡后续终态帧)' },
+    plan_review_park: { required: true, duty: '弹 plan 审批卡(fail-soft,不挡后续终态帧);卡事实 `planReview` 在场时按它出选项与原因句(只有 shown 给批准档)' },
     run_cost_reconciled: {
         required: false,
         duty: '可选:终局成本对账(own / nested / compaction 三段 + reconciled = own + nested)。' +
@@ -168,6 +168,18 @@ const CHROME_ARM_TABLE = {
             '🔴 三纪律:①按 taskId 归属过滤(孤儿撤帧行非我即忽略)②账本重放的撤帧只用于时间线渲染,卡集基准恒为开流 preamble' +
             '(撤帧可能整帧丢失)③已 DECIDED 的兄弟不在 askIds 里;真撤到本地卡时给一行归因(reason 消毒后呈现),零命中不要多说那一行',
     },
+    approval_complete: {
+        required: true,
+        duty: '用 sdk isApprovalCompleteFrameV1 窄化 frame 取 askId/outcome/cause/parked;窄不下来按 askId(若有)清卡、别猜结局;按开卡帧的 askId 清本地卡' +
+            '(与撤卡帧不冲突,两帧都可能到;清卡是这张卡的一条出口,呈卡臂登记的持有句柄照放);🔴 永不据本帧推断 run 的归宿(读 run 行 / 停驻面),' +
+            'expired 不是拒绝,带 parked 的是转进耐久队列、还在等人;账本重放的消卡帧只用于时间线渲染,卡集对账基准恒为开流 preamble(帧可能整帧丢失)',
+    },
+    session_titled: {
+        required: false,
+        duty: '可选:按 sessionId(服务端会话 id)把那一条会话行的标题刷新成 title(与行上同值,写进宿主自己那一份会话行);' +
+            '🔴 会话行 title 是唯一真源:本臂只活不存、可能不到(冷启动 / 多窗口 / 断线重连读行),没收到 ≠ 还没有标题;' +
+            'title 是模型产文,只渲染、永不回喂模型;座位上由宿主刷新会话行后经 session_updated 推给渲染端',
+    },
     text_segment_end: {
         required: true,
         duty: '🔴 引擎明报的 assistant 散文段边界 + **该段权威全文**(server ≥7.75.3 起 content 经脱敏器、' +

package/dist/seatContract.d.ts

@@ -14,7 +14,8 @@ import type { DeviceEnrollTokenOutcome, DeviceListOutcome, DeviceRebindOutcome,
 import type { McpPanelView } from "./mcpPanel.js";
 import type { McpToolToggleKey } from "./mcpToolToggles.js";
 import { type ThinkingLatchEvent, type ThinkingLatchRowWord } from "./thinkingLatchWords.js";
-import type { SessionRowPatchFields } from "./sessionRowTag.js";
+import type { SessionRowPatchFields, SessionRowUnreadable } from "./sessionRowTag.js";
+import { type SessionEngineView } from "./sessionEngine.js";
 export interface SeatValidationFailure {
     reason: string;
     field?: string;
@@ -50,7 +51,10 @@ export interface LocalSessionRecord {
     parked?: boolean;
     pinned?: boolean;
     rowTag?: string;
+    unreadable?: SessionRowUnreadable;
     thinkingLatch?: ThinkingLatchRowWord;
+    engine?: SessionEngineView;
+    executionLane?: string;
 }
 export declare const TOOL_PERMISSION_REQUEST_ID_DOMAINS: readonly ["live:", "durable:", "question:", "elicit:", "plan:"];
 export type ToolPermissionRequestIdDomain = (typeof TOOL_PERMISSION_REQUEST_ID_DOMAINS)[number];
@@ -105,6 +109,7 @@ declare const CHROME_ARM_SEAT_ROUTE: {
     readonly plan_review_park: "host";
     readonly approval_request: "host";
     readonly approval_revoke: "host";
+    readonly approval_complete: "host";
     readonly task_ledger_sync: "host";
     readonly inline_task_stats: "host";
     readonly stream_delta: "host";
@@ -124,6 +129,7 @@ declare const CHROME_ARM_SEAT_ROUTE: {
     readonly wiring_manifest: "host";
     readonly suspended_reopened: "host";
     readonly result_text_diverged: "host";
+    readonly session_titled: "host";
 };
 type SeatRoutedKind = {
     [K in keyof typeof CHROME_ARM_SEAT_ROUTE]: (typeof CHROME_ARM_SEAT_ROUTE)[K] extends "seat" ? K : never;
@@ -194,7 +200,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"];
+export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly"];
 export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
 export interface SeatCapabilitiesState {
     pickFolder?: boolean;
@@ -206,6 +212,8 @@ export interface SeatCapabilitiesState {
     onboard?: boolean;
     mcpToolToggles?: boolean;
     thinkingLatch?: boolean;
+    computerUseSwitch?: boolean;
+    engineModeDefaultOnly?: boolean;
 }
 export type SeatCapabilityReading = {
     readonly kind: "reported";
@@ -589,6 +597,7 @@ export interface OnboardImportableProfile {
     api: ModelApiWord;
     hasKey: boolean;
     models: string[];
+    isCurrent?: boolean;
 }
 export interface OnboardProvidersResult {
     providers: OnboardProviderRow[];
@@ -600,6 +609,42 @@ export declare const checkMcpToolToggleKey: (v: unknown) => SeatValidation;
 export interface McpToolTogglesResult {
     off: McpToolToggleKey[];
 }
+export declare const COMPUTER_USE_SOURCES: readonly ["env", "settings", "default"];
+export type ComputerUseSource = (typeof COMPUTER_USE_SOURCES)[number];
+export declare const COMPUTER_USE_REFUSAL_REASONS: readonly ["locked-by-env", "confirmation-required", "invalid-request", "write-failed"];
+export type ComputerUseRefusalReason = (typeof COMPUTER_USE_REFUSAL_REASONS)[number];
+export declare const COMPUTER_USE_APPLIES_ON: readonly ["next-engine-start"];
+export type ComputerUseAppliesOn = (typeof COMPUTER_USE_APPLIES_ON)[number];
+export interface ComputerUseState {
+    enabled: boolean;
+    source: ComputerUseSource;
+    lockedByEnv: boolean;
+    appliesOn: ComputerUseAppliesOn;
+}
+export type SetComputerUseRequest = {
+    readonly enabled: false;
+} | {
+    readonly enabled: true;
+    readonly confirmed: true;
+};
+export type SetComputerUseResult = {
+    ok: true;
+    changed: boolean;
+    state: ComputerUseState;
+} | {
+    ok: false;
+    reason: ComputerUseRefusalReason;
+    state: ComputerUseState;
+};
+export declare const checkSetComputerUseRequest: (v: unknown) => SeatValidation;
+export type SetComputerUsePlan = {
+    readonly kind: "apply";
+    readonly enabled: boolean;
+} | {
+    readonly kind: "refused";
+    readonly reason: Exclude<ComputerUseRefusalReason, "write-failed">;
+};
+export declare function planSetComputerUse(request: {} | null | undefined, lockedByEnv: boolean): SetComputerUsePlan;
 export interface LocalSessionsApi {
     start(opts?: StartSessionOptions): Promise<LocalSessionRecord>;
     sendMessage(req: SendMessageRequest): Promise<SendMessageAck>;
@@ -638,6 +683,8 @@ export interface LocalSessionsApi {
     listMcpToolToggles(): Promise<McpToolTogglesResult>;
     setMcpToolToggle(key: McpToolToggleKey, enabled: boolean): Promise<OkAck>;
     setThinkingLatch(req: SetThinkingLatchRequest): Promise<OkAck>;
+    getComputerUse(): Promise<ComputerUseState>;
+    setComputerUse(req: SetComputerUseRequest): Promise<SetComputerUseResult>;
     onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
     onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
     sessionsStateStore: EipcStoreClient<SessionsState>;
@@ -683,12 +730,12 @@ export declare const checkSetThinkingLatchRequest: (v: unknown) => SeatValidatio
 export declare function isSetThinkingLatchRequest(v: unknown): v is SetThinkingLatchRequest;
 export declare function isSendMessageAck(v: unknown): v is SendMessageAck;
 export declare const LOCAL_SESSIONS_SPEC: EipcServiceSpec;
-export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "onEvent", "onToolPermissionRequest"];
+export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "getComputerUse", "setComputerUse", "onEvent", "onToolPermissionRequest"];
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore", "engineTargetStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "error", "errorCategory", "code", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome", "_sema_turnFailure", "subagentContent"];
 export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "sessionRow"];
-export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "thinkingLatch"];
+export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane"];
 export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario", "rewind"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
     readonly sessionId: {
@@ -738,7 +785,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     readonly LocalSessionRecord: {
         readonly guard: "isLocalSessionRecord";
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "thinkingLatch"];
+        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane"];
         readonly unchecked: readonly [];
     };
     readonly ToolPermissionRequest: {
@@ -804,6 +851,9 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         }, {
             readonly key: "candidateRejected";
             readonly why: "诊断面(0.97.0 CC-715;当前配置是候选被整拒后回落的那一份),三态读法归 modelCandidateRejectedOf(含坏形 unreadable);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
+        }, {
+            readonly key: "modelPlane";
+            readonly why: "诊断面(0.106.0 CC-1156;这台引擎服务的是哪张模型表 / 最近一份目录候选的结局),三态读法归 modelPlaneOf(含坏形 unreadable、表外词整位不给);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
         }];
     };
     readonly SendMessageRequest: {
@@ -877,7 +927,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"];
+        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly"];
         readonly unchecked: readonly [];
     };
     readonly RecentFoldersResult: {
@@ -917,7 +967,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";
+    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";
     check: (v: unknown) => SeatValidation;
     why: string;
 }[], {

package/dist/seatContract.js

@@ -7,6 +7,7 @@ import { guardedRead, ownDataField, ownDataRefusalKeyOf, ownSendableField, readO
 import { MCP_LIVENESS_STATES } from "./mcpLiveness.js";
 import { THINKING_LATCH_EVENTS, THINKING_LATCH_ROW_WORDS } from "./thinkingLatchWords.js";
 import { EXECUTION_PLACEMENT_ROLES } from "./executionPlacementWords.js";
+import { isSessionEngineView } from "./sessionEngine.js";
 const bad = (reason, field) => field === undefined ? { reason } : { reason, field };
 const nested = (prefix, verdict) => {
     const path = verdict.field === undefined
@@ -295,6 +296,7 @@ const CHROME_ARM_SEAT_ROUTE = {
     plan_review_park: "host",
     approval_request: "host",
     approval_revoke: "host",
+    approval_complete: "host",
     task_ledger_sync: "host",
     inline_task_stats: "host",
     stream_delta: "host",
@@ -314,6 +316,7 @@ const CHROME_ARM_SEAT_ROUTE = {
     wiring_manifest: "host",
     suspended_reopened: "host",
     result_text_diverged: "host",
+    session_titled: "host",
 };
 const CHROME_EVENT_KIND_TUPLE = Object.keys(CHROME_ARM_SEAT_ROUTE).filter((k) => CHROME_ARM_SEAT_ROUTE[k] === "seat");
 export const CHROME_EVENT_KINDS = Object.freeze(CHROME_EVENT_KIND_TUPLE);
@@ -376,7 +379,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"]);
+export const SEAT_CAPABILITY_NAMES = Object.freeze(["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly"]);
 const notReported = () => Object.freeze({ kind: "not_reported" });
 const malformedReading = () => Object.freeze({ kind: "malformed" });
 const reported = (available) => Object.freeze({ kind: "reported", available });
@@ -453,6 +456,8 @@ const SEAT_CAPABILITY_PHRASES = Object.freeze({
     onboard: Object.freeze({ action: "Model setup", ability: "add models", support: "model-setup support" }),
     mcpToolToggles: Object.freeze({ action: "Per-tool switching", ability: "toggle tools", support: "per-tool switches" }),
     thinkingLatch: Object.freeze({ action: "Switching thinking", ability: "switch thinking", support: "thinking-switch support" }),
+    computerUseSwitch: Object.freeze({ action: "Computer use", ability: "be switched", support: "switch support" }),
+    engineModeDefaultOnly: Object.freeze({ action: "Default-only engine switching", ability: "keep existing sessions on their engine", support: "default-only engine switching" }),
 });
 export function seatCapabilityUnavailableDetail(name, reading) {
     const phrase = Object.hasOwn(SEAT_CAPABILITY_PHRASES, name)
@@ -886,6 +891,7 @@ const checkOnboardProvidersResult = seatShapeCheck(shapeRule("onboard providers"
         api: reqF(R_API_WORD),
         hasKey: reqF(R_BOOL),
         models: reqF(arrayRule(R_NONEMPTY)),
+        isCurrent: optF(R_BOOL),
     }))),
 }));
 const checkSessionMcpPanelFailure = seatShapeCheck(armsRule("readSessionMcpPanel failure", "kind", {
@@ -967,6 +973,95 @@ const MCP_TOOL_TOGGLE_KEY = shapeRule("toggle key", {
 });
 export const checkMcpToolToggleKey = seatShapeCheck(MCP_TOOL_TOGGLE_KEY);
 const checkMcpToolTogglesResult = seatShapeCheck(shapeRule("toggles result", { off: reqF(arrayRule(MCP_TOOL_TOGGLE_KEY)) }));
+export const COMPUTER_USE_SOURCES = Object.freeze(["env", "settings", "default"]);
+export const COMPUTER_USE_REFUSAL_REASONS = Object.freeze(["locked-by-env", "confirmation-required", "invalid-request", "write-failed"]);
+export const COMPUTER_USE_APPLIES_ON = Object.freeze(["next-engine-start"]);
+const SET_COMPUTER_USE_REQUEST_KEYS = Object.freeze(["enabled", "confirmed"]);
+const COMPUTER_USE_STATE_SHAPE = shapeRule("computer-use state", {
+    enabled: reqF(R_BOOL),
+    source: reqF(oneOfRule("computer-use source", COMPUTER_USE_SOURCES)),
+    lockedByEnv: reqF(R_BOOL),
+    appliesOn: reqF(oneOfRule("computer-use appliesOn", COMPUTER_USE_APPLIES_ON)),
+});
+const COMPUTER_USE_STATE = {
+    label: COMPUTER_USE_STATE_SHAPE.label,
+    test: (v, path) => {
+        const verdict = COMPUTER_USE_STATE_SHAPE.test(v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        return own(rec, "lockedByEnv") === true && own(rec, "source") !== "env" ? bad("lock conflict", pathAt(path, "lockedByEnv")) : true;
+    },
+};
+const checkComputerUseState = seatShapeCheck(COMPUTER_USE_STATE);
+const SET_COMPUTER_USE_RESULT = okArmsRule("setComputerUse result", { changed: reqF(R_BOOL), state: reqF(COMPUTER_USE_STATE) }, {
+    reason: reqF(oneOfRule("computer-use refusal", COMPUTER_USE_REFUSAL_REASONS)),
+    state: reqF(COMPUTER_USE_STATE),
+});
+const checkSetComputerUseResult = seatShapeCheck({
+    label: SET_COMPUTER_USE_RESULT.label,
+    test: (v, path) => {
+        const verdict = SET_COMPUTER_USE_RESULT.test(v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        if (own(rec, "reason") === "locked-by-env" && own(own(rec, "state"), "lockedByEnv") !== true)
+            return bad("lock conflict", pathAt(path, "state.lockedByEnv"));
+        return true;
+    },
+});
+const failureOfRule = (rule, v, path) => {
+    const verdict = rule.test(v, path);
+    return verdict === true ? bad("bad value", path) : verdict;
+};
+const computerUseIntentOf = (v) => {
+    const invalid = (failure) => ({ kind: "invalid", failure });
+    if (!isPlainRecord(v))
+        return invalid(bad("not object"));
+    const snap = new Map();
+    for (const k of Reflect.ownKeys(v))
+        if (typeof k === "string")
+            snap.set(k, own(v, k));
+    for (const k of snap.keys())
+        if (!inTuple(SET_COMPUTER_USE_REQUEST_KEYS, k))
+            return invalid(bad("unknown key", k));
+    const enabled = snap.get("enabled");
+    if (enabled === undefined)
+        return invalid(bad("missing key", "enabled"));
+    if (typeof enabled !== "boolean")
+        return invalid(failureOfRule(R_BOOL, enabled, "enabled"));
+    if (!enabled)
+        return snap.has("confirmed") ? invalid(bad("unknown key", "confirmed")) : { kind: "disable" };
+    const confirmed = snap.get("confirmed");
+    if (confirmed === true)
+        return { kind: "enable" };
+    if (confirmed === undefined)
+        return { kind: "unconfirmed", failure: bad("missing key", "confirmed") };
+    if (confirmed === false)
+        return { kind: "unconfirmed", failure: failureOfRule(R_TRUE, confirmed, "confirmed") };
+    return invalid(failureOfRule(R_BOOL, confirmed, "confirmed"));
+};
+export const checkSetComputerUseRequest = seatCheck((v) => {
+    const intent = computerUseIntentOf(v);
+    return intent.kind === "disable" || intent.kind === "enable" ? true : intent.failure;
+});
+export function planSetComputerUse(request, lockedByEnv) {
+    let intent;
+    try {
+        const at = firstAccessorPath(request);
+        intent = at !== undefined ? { kind: "invalid", failure: bad(NOT_PLAIN_DATA, at) } : computerUseIntentOf(request);
+    }
+    catch {
+        intent = { kind: "invalid", failure: bad("unreadable") };
+    }
+    if (intent.kind === "invalid")
+        return Object.freeze({ kind: "refused", reason: "invalid-request" });
+    if (lockedByEnv !== false)
+        return Object.freeze({ kind: "refused", reason: "locked-by-env" });
+    if (intent.kind === "unconfirmed")
+        return Object.freeze({ kind: "refused", reason: "confirmation-required" });
+    return Object.freeze({ kind: "apply", enabled: intent.kind === "enable" });
+}
 const checkLocalSessionRecord = seatCheck((s) => {
     if (!isPlainRecord(s))
         return bad("session record is not a plain object");
@@ -1006,12 +1101,28 @@ const checkLocalSessionRecord = seatCheck((s) => {
     if (!isAbsent(rowTag) && (typeof rowTag !== "string" || rowTag.length === 0)) {
         return bad("rowTag must be a non-empty string when present (absent = this row cannot be written conditionally)", "rowTag");
     }
+    const unreadable = own(s, "unreadable");
+    if (!isAbsent(unreadable)) {
+        if (!isPlainRecord(unreadable))
+            return bad("unreadable must be a plain object when present (absent = the list did not report this session as unreadable)", "unreadable");
+        const code = own(unreadable, "errorCode");
+        if (!isAbsent(code) && (typeof code !== "string" || code.length === 0))
+            return bad("unreadable.errorCode must be a non-empty string when present", "unreadable.errorCode");
+    }
     const latch = own(s, "thinkingLatch");
     if (!isAbsent(latch)) {
         const verdict = R_THINKING_LATCH_ROW.test(latch, "thinkingLatch");
         if (verdict !== true)
             return verdict;
     }
+    const engine = own(s, "engine");
+    if (!isAbsent(engine) && !isSessionEngineView(engine)) {
+        return bad("engine must be a session engine reading (kind local|cloud + identityKind + identity{key, presentation} as the package mints it) when present (absent = the engine is not known)", "engine");
+    }
+    const lane = own(s, "executionLane");
+    if (!isAbsent(lane) && (typeof lane !== "string" || lane.length === 0)) {
+        return bad("executionLane must be a non-empty string when present (absent = no writer lane reading)", "executionLane");
+    }
     return true;
 });
 export function isLocalSessionRecord(s) {
@@ -1254,6 +1365,7 @@ const SUBAGENT_CONTENT_SHAPE = shapeRule("subagent content", {
     args: optF({ label: "passthrough", test: () => true }),
     output: optF(R_STR),
     isError: optF(R_BOOL),
+    notExecuted: optF(R_TRUE),
 });
 export function readSeatSubagentContent(event) {
     try {
@@ -1666,6 +1778,8 @@ export const LOCAL_SESSIONS_SPEC = {
         listMcpToolToggles: { kind: "invoke", check: checkMcpToolTogglesResult },
         setMcpToolToggle: { kind: "invoke", check: checkOkAck },
         setThinkingLatch: { kind: "invoke", check: checkOkAck },
+        getComputerUse: { kind: "invoke", check: checkComputerUseState },
+        setComputerUse: { kind: "invoke", check: checkSetComputerUseResult },
         onEvent: { kind: "event", check: checkLocalSessionEvent },
         onToolPermissionRequest: { kind: "event", check: checkToolPermissionRequest },
     },
@@ -1714,6 +1828,8 @@ export const SEAT_METHOD_NAMES = [
     "listMcpToolToggles",
     "setMcpToolToggle",
     "setThinkingLatch",
+    "getComputerUse",
+    "setComputerUse",
     "onEvent",
     "onToolPermissionRequest",
 ];
@@ -1773,7 +1889,10 @@ export const LOCAL_SESSION_RECORD_KEYS = [
     "parked",
     "pinned",
     "rowTag",
+    "unreadable",
     "thinkingLatch",
+    "engine",
+    "executionLane",
 ];
 export const SEND_MESSAGE_REQUEST_KEYS = [
     "sessionId",
@@ -1818,7 +1937,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     LocalSessionRecord: {
         guard: "isLocalSessionRecord",
         check: checkLocalSessionRecord,
-        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "thinkingLatch"],
+        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane"],
         unchecked: [],
     },
     ToolPermissionRequest: {
@@ -1914,6 +2033,10 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 key: "candidateRejected",
                 why: "诊断面(0.97.0 CC-715;当前配置是候选被整拒后回落的那一份),三态读法归 modelCandidateRejectedOf(含坏形 unreadable);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。",
             },
+            {
+                key: "modelPlane",
+                why: "诊断面(0.106.0 CC-1156;这台引擎服务的是哪张模型表 / 最近一份目录候选的结局),三态读法归 modelPlaneOf(含坏形 unreadable、表外词整位不给);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。",
+            },
         ],
     },
     SendMessageRequest: {
@@ -2001,7 +2124,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     },
     SeatCapabilitiesState: {
         check: checkSeatCapabilitiesState,
-        validated: ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch"],
+        validated: ["pickFolder", "rewind", "recents", "patchSession", "devices", "engineTarget", "onboard", "mcpToolToggles", "thinkingLatch", "computerUseSwitch", "engineModeDefaultOnly"],
         unchecked: [],
     },
     RecentFoldersResult: {
@@ -2064,6 +2187,9 @@ export const SEAT_VALIDATOR_COVERAGE_EXEMPT = [
         ["OnboardApplyRequest", checkOnboardApplyRequest],
         ["McpToolTogglesResult", checkMcpToolTogglesResult],
         ["McpToolToggleKey", checkMcpToolToggleKey],
+        ["ComputerUseState", checkComputerUseState],
+        ["SetComputerUseResult", checkSetComputerUseResult],
+        ["SetComputerUseRequest", checkSetComputerUseRequest],
     ].map(([label, check]) => ({
         label,
         check,
@@ -2119,5 +2245,9 @@ const _seatContractPins = [
     true, true, true, true, true, true,
     true, true, true,
     true, true,
+    true, true, true,
+    true, true,
+    true, true, true, true,
+    true, true,
 ];
 void _seatContractPins;

package/dist/serverSupportRange.d.ts

@@ -0,0 +1,18 @@
+import type { UiLanguage } from './env/uiLanguage.js';
+export declare const SERVER_SUPPORT_RANGE_REASONS: readonly ["below_floor", "version_absent", "version_unreadable"];
+export type ServerSupportRangeReason = (typeof SERVER_SUPPORT_RANGE_REASONS)[number];
+export type ServerSupportRangeVerdict = {
+    readonly kind: 'in_range';
+    readonly floor: string;
+} | {
+    readonly kind: 'out_of_range';
+    readonly reason: 'below_floor';
+    readonly version: string;
+    readonly floor: string;
+} | {
+    readonly kind: 'unknown';
+    readonly reason: 'version_absent' | 'version_unreadable';
+    readonly floor: string;
+};
+export declare function serverSupportRangeVerdict(version: string | undefined): ServerSupportRangeVerdict;
+export declare function serverSupportRangeSentence(verdict: ServerSupportRangeVerdict, lang?: UiLanguage): string | undefined;