@sema-agent/client-core 0.105.0 → 0.106.0

package/dist/request/taskRequest.js

@@ -450,7 +450,7 @@ const resolvedSnapshotForWire = (resolved) => {
 export function hostTurnSettings(input) {
     return buildHostTurnSettings(input, { materialize: (snapshot) => resolvedSnapshotForWire(snapshot), memoryOffDeclared });
 }
-const fileRestoreRequested = (restoreFiles, rewindFilesTo, rewindFiles) => restoreFiles === true || (typeof rewindFilesTo === 'string' && rewindFilesTo.length > 0) || rewindFiles === true;
+const fileRestoreRequested = (restoreFiles, rewindFilesTo) => restoreFiles === true || (typeof rewindFilesTo === 'string' && rewindFilesTo.length > 0);
 function tightenedRequestOf(request, intake, lane) {
     const readData = (key) => {
         try {
@@ -489,10 +489,9 @@ function tightenedRequestOf(request, intake, lane) {
         if (sent.value !== FILE_HISTORY_DISABLED) {
             const restoreFiles = readData('restoreFiles');
             const rewindFilesTo = readData('rewindFilesTo');
-            const rewindFiles = readData('rewindFiles');
-            if (!restoreFiles.ok || !rewindFilesTo.ok || !rewindFiles.ok)
+            if (!restoreFiles.ok || !rewindFilesTo.ok)
                 return unjudged;
-            if (fileRestoreRequested(restoreFiles.value, rewindFilesTo.value, rewindFiles.value))
+            if (fileRestoreRequested(restoreFiles.value, rewindFilesTo.value))
                 return { kind: 'refuse', notice: hostFileHistoryRestoreNotice() };
             add.fileHistory = FILE_HISTORY_DISABLED;
             appendOwnElement(tightened, 'fileHistory');

package/dist/ruleCompileVerdict.d.ts

@@ -25,5 +25,3 @@ export type DenyEntryReading = {
     readonly kind: 'unknown';
 };
 export declare function denyEntryReading(rule: string): DenyEntryReading;
-export declare const DOMAIN_TIGHTEN_HONORED_FROM = "7.135.0";
-export declare function tightenEntryNeverMatches(rule: string, serverVersion: string | undefined): boolean;

package/dist/ruleCompileVerdict.js

@@ -1,6 +1,5 @@
 import { readRuleEntry, validatePermissionRules } from './coreValuePorts.js';
 import { guardedRead, readOwnDataValue } from './ownKey.js';
-import { engineVersionTier } from './supportFloor.js';
 const RULE_COMPILE_ROOT = '/';
 function issueText(issue, key) {
     try {
@@ -73,33 +72,3 @@ export function denyEntryReading(rule) {
         return { kind: 'unknown' };
     }
 }
-function readsAsDomainSpelling(rule) {
-    try {
-        const reading = readRuleEntry(rule, 'allow');
-        if (typeof reading !== 'object' || reading === null)
-            return false;
-        if (readOwnDataValue(reading, 'kind') !== 'row')
-            return false;
-        const compiled = readOwnDataValue(reading, 'compiled');
-        if (typeof compiled !== 'object' || compiled === null)
-            return false;
-        return readOwnDataValue(compiled, 'kind') === 'domain';
-    }
-    catch {
-        return false;
-    }
-}
-export const DOMAIN_TIGHTEN_HONORED_FROM = '7.135.0';
-function targetLeavesDomainTightenInert(serverVersion) {
-    return engineVersionTier(serverVersion) === 'engine' && engineVersionTier(serverVersion, DOMAIN_TIGHTEN_HONORED_FROM) === 'legacy';
-}
-export function tightenEntryNeverMatches(rule, serverVersion) {
-    if (!targetLeavesDomainTightenInert(serverVersion))
-        return false;
-    const r = denyEntryReading(rule);
-    if (r.kind !== 'inert' || r.reason !== 'content_unsupported')
-        return false;
-    if (!readsAsDomainSpelling(rule))
-        return false;
-    return ruleCompileVerdict(rule, 'deny').kind === 'compiles';
-}

package/dist/ruleRefusalSentence.js

@@ -10,7 +10,6 @@ const CLASS_OF_REASON = Object.freeze({
     home_relative_path: 'homePath',
     compile_refused: 'compile',
     paren_in_tool_name: 'compile',
-    content_form_never_matches: 'neverMatches',
 });
 function reasonOf(row, lang) {
     const cls = typeof row.reason === 'string' && Object.hasOwn(CLASS_OF_REASON, row.reason) ? CLASS_OF_REASON[row.reason] : undefined;
@@ -18,8 +17,6 @@ function reasonOf(row, lang) {
         return renderMessage(msg('rules.refusal.reason.toolName'), lang);
     if (cls === 'homePath')
         return renderMessage(msg('rules.refusal.reason.homePath'), lang);
-    if (cls === 'neverMatches')
-        return renderMessage(msg('rules.refusal.reason.neverMatches'), lang);
     if (cls === 'compile')
         return permissionRuleIssueDetail(row.code, row.message, row.rule, lang);
     return undefined;

package/dist/runReattachPolicy.d.ts

@@ -1,5 +1,6 @@
 import { type RunNotFollowed } from './runFollow.js';
 export declare const REATTACH_MAX_TRIES = 5;
+export declare const STREAM_CAP_CREDIBLE_AFTER_MS = 300000;
 export interface ReattachBudget {
     readonly tries: number;
     readonly drainingStreak: number;
@@ -14,6 +15,7 @@ export type ReattachEvent = {
 } | {
     readonly cause: 'stream_cap';
     readonly runId?: string;
+    readonly legElapsedMs?: number;
 } | {
     readonly cause: 'stream_draining';
     readonly runId?: string;
@@ -30,6 +32,7 @@ export type ReattachDrainingEvent = Extract<ReattachEvent, {
 export type ReattachDecision = {
     readonly action: 'reattach';
     readonly afterMs: number;
+    readonly premature?: true;
     readonly budget: ReattachBudget;
 } | {
     readonly action: 'give_up';

package/dist/runReattachPolicy.js

@@ -2,12 +2,14 @@ import { STREAM_DRAINING_RECONNECT_MAX, drainingRetryDelayMs, isPreStreamDrainin
 import { drainingLegStep } from './streamDrainingLegs.js';
 import { mintRunNotFollowed } from './runFollow.js';
 export const REATTACH_MAX_TRIES = 5;
+export const STREAM_CAP_CREDIBLE_AFTER_MS = 300_000;
+const connectionLostBackoffMs = (n) => 1000 * n;
 const DRAINING_TOTAL_MAX = REATTACH_MAX_TRIES * STREAM_DRAINING_RECONNECT_MAX;
 export const REATTACH_BUDGET_FRESH = Object.freeze({ tries: 0, drainingStreak: 0, drainingTotal: 0 });
 export const REATTACH_BUDGET_NONE = Object.freeze({ tries: REATTACH_MAX_TRIES, drainingStreak: 0, drainingTotal: DRAINING_TOTAL_MAX });
 const isCount = (v) => typeof v === 'number' && Number.isSafeInteger(v) && v >= 0;
 const giveUp = (notFollowed, budget) => Object.freeze({ action: 'give_up', budget, notFollowed });
-const reattach = (afterMs, tries, drainingStreak, drainingTotal) => Object.freeze({ action: 'reattach', afterMs, budget: Object.freeze({ tries, drainingStreak, drainingTotal }) });
+const reattach = (afterMs, tries, drainingStreak, drainingTotal, premature) => Object.freeze({ action: 'reattach', afterMs, ...(premature === true ? { premature } : {}), budget: Object.freeze({ tries, drainingStreak, drainingTotal }) });
 export function runReattachPolicy(budget, event) {
     let handle;
     try {
@@ -44,6 +46,15 @@ export function runReattachPolicy(budget, event) {
                 draining = { step: st };
             }
         }
+        let premature = false;
+        if (cause === 'stream_cap') {
+            const legElapsedMs = event.legElapsedMs;
+            if (legElapsedMs !== undefined) {
+                if (typeof legElapsedMs !== 'number' || !Number.isFinite(legElapsedMs) || legElapsedMs < 0)
+                    return bad();
+                premature = legElapsedMs < STREAM_CAP_CREDIBLE_AFTER_MS;
+            }
+        }
         if (runId === undefined)
             return giveUp(mintRunNotFollowed('no_run_id'), keep);
         if (handle === undefined)
@@ -55,12 +66,14 @@ export function runReattachPolicy(budget, event) {
                 return exhausted(cause);
             const error = event.error;
             const next = tries + 1;
-            const afterMs = isPreStreamDrainingReject(error) ? drainingRetryDelayMs(error, next - 1) : 1000 * next;
+            const afterMs = isPreStreamDrainingReject(error) ? drainingRetryDelayMs(error, next - 1) : connectionLostBackoffMs(next);
             return reattach(afterMs, next, 0, drainingTotal);
         }
         if (cause === 'stream_cap') {
             if (tries >= REATTACH_MAX_TRIES)
                 return exhausted(cause);
+            if (premature)
+                return reattach(connectionLostBackoffMs(tries + 1), tries + 1, 0, drainingTotal, true);
             return reattach(0, tries + 1, 0, drainingTotal);
         }
         if (draining === undefined || 'ladder' in draining) {

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,7 +1,7 @@
 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';
@@ -165,7 +165,7 @@ export type ChromeEvent = {
 } | ({
     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, {
@@ -182,7 +182,6 @@ export interface WiringManifestChromeEvent {
     autoMode?: WiringManifestAutoMode;
     mcp?: readonly WiringManifestMcpEntryView[];
     tools?: ToolRosterView;
-    hooks?: readonly WiringManifestHookEntryView[];
     lsp?: WiringManifestLspSeamView;
     writeProtection?: WiringManifestWriteProtectionView;
     autoConsolidation?: WiringManifestAutoConsolidationView;
@@ -311,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

@@ -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;
 }[], {