@sema-agent/client-core 0.108.0 → 0.109.0

package/dist/ownKey.js

@@ -175,7 +175,14 @@ export function humanInputAttachmentsOf(frame) {
                     return undefined;
                 const kind = readOwnDataNonEmptyString(r, 'kind');
                 const label = readOwnDataNonEmptyString(r, 'label');
-                return { ordinal, ...(kind !== undefined ? { kind } : {}), outcome, ...(label !== undefined ? { label } : {}) };
+                const declinedBy = guardedRead(() => {
+                    const d = readOwnDataValue(r, 'declinedBy');
+                    if (typeof d !== 'object' || d === null || Array.isArray(d))
+                        return undefined;
+                    const name = readOwnDataNonEmptyString(d, 'name');
+                    return readOwnDataValue(d, 'kind') === 'extension' && name !== undefined ? { kind: 'extension', name } : undefined;
+                });
+                return { ordinal, ...(kind !== undefined ? { kind } : {}), outcome, ...(label !== undefined ? { label } : {}), ...(declinedBy !== undefined ? { declinedBy } : {}) };
             });
             if (row !== undefined)
                 appendOwnElement(rows, row);
@@ -186,6 +193,13 @@ export function humanInputAttachmentsOf(frame) {
         return undefined;
     }
 }
+export function humanInputAuthorKeys(frame) {
+    if (typeof frame !== 'object' || frame === null || Array.isArray(frame))
+        return {};
+    const author = guardedRead(() => readOwnDataNonEmptyString(frame, 'author'));
+    const extension = guardedRead(() => readOwnDataNonEmptyString(frame, 'extension'));
+    return { ...(author !== undefined ? { author } : {}), ...(extension !== undefined ? { extension } : {}) };
+}
 const DROPPED_NAMED_ROWS = Symbol.for('@sema-agent/client-core/mcpSectionDroppedNamedRows');
 export function markMcpSectionDroppedNamedRows(rows, dropped) {
     if (dropped.size === 0)

package/dist/ruleReadings.js

@@ -122,7 +122,7 @@ export function ruleNearMissSentence(rows, lang) {
     const named = shown
         .map((it) => renderMessage(msg('rules.refusal.item', {
         rule: `"${capForDisplay(it.rule, NEAR_MISS_RULE_MAX)}"`,
-        reason: renderMessage(msg('rules.nearMiss.reason', { mounted: capForDisplay(displayUntrusted(it.mounted), NEAR_MISS_NAME_MAX) }), lang),
+        reason: renderMessage(msg('rules.nearMiss.reason', { mounted: displayUntrusted(it.mounted, { max: NEAR_MISS_NAME_MAX, escapeBackslashes: 'auto' }) }), lang),
     }), lang))
         .join(separator);
     const rest = items.length - shown.length;

package/dist/seam.d.ts

@@ -8,6 +8,7 @@ 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 { SubagentAliasScope } from './subagentContentStore.js';
 import type { TaskNotificationFields } from './notifications.js';
 export interface AbortSignalLike {
     readonly aborted: boolean;
@@ -165,7 +166,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 | ApprovalCompleteChromeEvent | SessionTitledChromeEvent | {
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | CompactionStartedChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | SubagentAliasChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | ApprovalCompleteChromeEvent | SessionTitledChromeEvent | {
     kind: 'suspended_reopened';
     laneProof: LaneProof;
     reopen: Extract<SuspendedReopenReading, {
@@ -347,6 +348,14 @@ export interface ToolParkedChromeEvent {
     toolUseId: string;
     rowUuid?: string;
 }
+export interface SubagentAliasChromeEvent {
+    kind: 'subagent_alias';
+    laneProof: LaneProof;
+    parentToolCallId: string;
+    taskId: string;
+    scope: SubagentAliasScope;
+    seq?: number;
+}
 export interface EngineNoticeChromeEvent {
     kind: 'engine_notice';
     laneProof: LaneProof;
@@ -376,8 +385,10 @@ export interface HumanInputChromeEvent {
     entryId?: string;
     eventId?: string;
     attachments?: HumanInputAttachmentView[];
+    author?: string;
+    extension?: string;
 }
-export type { HumanInputAttachmentView } from './ownKey.js';
+export type { HumanInputAttachmentView, HumanInputAttachmentDeclinedByView } from './ownKey.js';
 export interface MessageCommittedChromeEvent {
     kind: 'message_committed';
     laneProof: LaneProof;

package/dist/seam.js

@@ -140,6 +140,12 @@ const CHROME_ARM_TABLE = {
             '按开始行 uuid 认行,不按 toolUseId(调用 id 只在同一条助手消息内唯一)。它的终态由执行腿的结果铸(续跑带见证时接回原行),或永远缺席(停驻被取消 / 过期)。' +
             '连坐旁观者 / 普通错误 / 停驻卡上 Esc(包已自发中断拒绝,行照铸 Interrupted)零枚。',
     },
+    subagent_alias: {
+        required: false,
+        duty: '可选:「委派卡 id → 子代任务 id」别名对(`parentToolCallId` / `taskId` / `scope`)—— 座位 lane 的渲染端收到就调 `noteSeatSubagentAlias(chrome)` 写自己账本里的同一半,' +
+            '子代详情的实时输出才按子代任务 id 读得到(子代内容帧只带卡 id)。🔴 座位宿主零逻辑:本臂在座位词表里,按词表转发的宿主自动转发;适配层与渲染层同进程的端(浏览器 lane)适配层已登记,什么都不用做;' +
+            '`scope: content` 只写内容归账那一半、`full` 两半都写(含续发目标),别把两者混着登;`full` 臂的 `seq`(帧自带代际号,可缺席)是续发目标「现卡」的顺序证据,交 `noteSeatSubagentAlias` 即可,别自己按到达序排;适配层每次登记都发(tick 逐条各一只),去重在登记口:同对重复收到答 ignored、无副作用;认不得的 `scope` 词整条不登记(读口答 undefined),别猜。',
+    },
     result_text_diverged: {
         required: false,
         duty: '可选:终帧正文与已上屏正文**互相都不是对方前缀**时的诚实披露。🔴 处置是把这一拍的转录行**改口**' +
@@ -170,7 +176,8 @@ const CHROME_ARM_TABLE = {
     },
     approval_complete: {
         required: true,
-        duty: '用 sdk isApprovalCompleteFrameV1 窄化 frame 取 askId/outcome/cause/parked;窄不下来按 askId(若有)清卡、别猜结局;按开卡帧的 askId 清本地卡' +
+        duty: '结局三态只读 classifyApprovalCompleteFrame(frame)(live-expired-parked / live-expired-retract / settled;null = 认不出、别猜结局),不自拼 outcome / cause / parked 的读法;' +
+            '清卡用的 askId 经 sdk isApprovalCompleteFrameV1 窄化取,窄不下来按 askId(若有)清卡;按开卡帧的 askId 清本地卡,三态任一都清' +
             '(与撤卡帧不冲突,两帧都可能到;清卡是这张卡的一条出口,呈卡臂登记的持有句柄照放);🔴 永不据本帧推断 run 的归宿(读 run 行 / 停驻面),' +
             'expired 不是拒绝,带 parked 的是转进耐久队列、还在等人;账本重放的消卡帧只用于时间线渲染,卡集对账基准恒为开流 preamble(帧可能整帧丢失)',
     },

package/dist/seatContract.d.ts

@@ -16,6 +16,8 @@ import type { McpToolToggleKey } from "./mcpToolToggles.js";
 import { type ThinkingLatchEvent, type ThinkingLatchRowWord } from "./thinkingLatchWords.js";
 import type { SessionRowPatchFields, SessionRowUnreadable } from "./sessionRowTag.js";
 import { type SessionEngineKind, type SessionEngineView } from "./sessionEngine.js";
+import type { ParkedUnresumableRow } from "./hitl/parkedUnresumable.js";
+import { type EngineSwapCard } from "./localEngineSwapCard.js";
 export interface SeatValidationFailure {
     reason: string;
     field?: string;
@@ -56,6 +58,7 @@ export interface LocalSessionRecord {
     thinkingLatch?: ThinkingLatchRowWord;
     engine?: SessionEngineView;
     executionLane?: string;
+    parkedUnresumable?: readonly ParkedUnresumableRow[];
 }
 export declare const TOOL_PERMISSION_REQUEST_ID_DOMAINS: readonly ["live:", "durable:", "question:", "elicit:", "plan:"];
 export type ToolPermissionRequestIdDomain = (typeof TOOL_PERMISSION_REQUEST_ID_DOMAINS)[number];
@@ -106,6 +109,7 @@ declare const CHROME_ARM_SEAT_ROUTE: {
     readonly compaction_started: "seat";
     readonly compaction_outcome: "seat";
     readonly engine_notice: "seat";
+    readonly subagent_alias: "seat";
     readonly workflow_notification_enqueue: "host";
     readonly plan_review_park: "host";
     readonly approval_request: "host";
@@ -478,9 +482,40 @@ 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 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];
+export type LocalEngineSeatReading = {
+    phase: "waiting";
+    why: LocalEngineWaitingReason;
+    unverifiable?: true;
+} | {
+    phase: "attached";
+} | {
+    phase: "pending";
+    serving: boolean;
+    card?: EngineSwapCard;
+} | {
+    phase: "swapping";
+    mode: "idle" | "forced";
+} | {
+    phase: "down";
+    reason: LocalEngineDownReason;
+} | {
+    phase: "behind";
+    running: string;
+    own: string;
+    upgrade: "available" | "unavailable";
+};
+export declare const ENGINE_SWAP_ANSWER_OUTCOMES: readonly ["started", "stale-card", "nothing-pending"];
+export type EngineSwapAnswerOutcome = (typeof ENGINE_SWAP_ANSWER_OUTCOMES)[number];
+export declare const SELF_UPGRADE_OUTCOMES: readonly ["started", "unavailable"];
+export type SelfUpgradeOutcome = (typeof SELF_UPGRADE_OUTCOMES)[number];
 export interface EngineTargetLocal {
     lastBootError?: string;
     mcp?: SeatLocalMcpReading;
+    lifecycle?: LocalEngineSeatReading;
 }
 export interface EngineTargetState {
     mode: "local" | "cloud";
@@ -708,6 +743,8 @@ export interface LocalSessionsApi {
     connectCloudEngine(req: CloudEngineConnectRequest): Promise<CloudConnectResult>;
     configureCloudEngine(req: CloudEngineConfigureRequest): Promise<CloudConnectResult>;
     clearCloudEngine(): Promise<EngineTargetResult>;
+    answerEngineSwap(choice: "force" | "wait", fingerprint: string): Promise<EngineSwapAnswerOutcome>;
+    beginSelfUpgrade(): Promise<SelfUpgradeOutcome>;
     listOnboardProviders(): Promise<OnboardProvidersResult>;
     probeOnboardEntry(req: OnboardEntryRequest): Promise<OnboardProbeResult>;
     applyOnboardEntry(req: OnboardApplyRequest): Promise<OnboardApplyResult>;
@@ -728,6 +765,7 @@ export interface LocalSessionsApi {
     engineTargetStateStore: EipcStoreClient<EngineTargetState>;
 }
 export declare function isLocalSessionRecord(s: unknown): s is LocalSessionRecord;
+export declare function readSeatParkedUnresumable(record: object): readonly ParkedUnresumableRow[] | undefined;
 export declare function isToolPermissionRequest(r: unknown): r is ToolPermissionRequest;
 export declare function readSeatSubagentContent(event: object): SubagentContentEvent | undefined;
 export declare function isLocalSessionEvent(v: unknown): v is LocalSessionEvent;
@@ -766,12 +804,12 @@ 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 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", "getComputerUse", "setComputerUse", "claimSeatActions", "onEvent", "onToolPermissionRequest", "onSeatAction"];
+export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "interrupt", "stop", "respondToToolPermission", "cancelQueuedMessage", "reorderQueuedMessage", "promoteQueuedMessage", "setFocusedSession", "setModel", "getTranscript", "searchSessions", "uploadAttachment", "listModels", "applyModelConfig", "pickFolder", "listRecentFolders", "noteRecentFolder", "patchSession", "listDevices", "readSessionBinding", "rebindSession", "issueEnrollToken", "revokeDevice", "setEngineMode", "startCloudLogin", "cancelCloudLogin", "connectCloudEngine", "configureCloudEngine", "clearCloudEngine", "answerEngineSwap", "beginSelfUpgrade", "listOnboardProviders", "probeOnboardEntry", "applyOnboardEntry", "readSessionMcpPanel", "listMcpToolToggles", "setMcpToolToggle", "setThinkingLatch", "getComputerUse", "setComputerUse", "claimSeatActions", "onEvent", "onToolPermissionRequest", "onSeatAction"];
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore", "engineTargetStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest", "onSeatAction"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "error", "errorCategory", "code", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome", "_sema_turnFailure", "subagentContent"];
 export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "sessionRow"];
-export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane"];
+export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane", "parkedUnresumable"];
 export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario", "rewind"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
     readonly sessionId: {
@@ -821,7 +859,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", "unreadable", "thinkingLatch", "engine", "executionLane"];
+        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane", "parkedUnresumable"];
         readonly unchecked: readonly [];
     };
     readonly ToolPermissionRequest: {
@@ -1021,7 +1059,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
 };
 export declare const SEAT_VALIDATOR_COVERAGE_EXEMPT: readonly [...{
-    label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey" | "ComputerUseState" | "SetComputerUseResult" | "SetComputerUseRequest" | "SeatAction";
+    label: "DeviceListOutcome" | "DeviceSessionBindingOutcome" | "DeviceRebindOutcome" | "DeviceEnrollTokenOutcome" | "DeviceRevokeOutcome" | "SeatDeviceRebindRequest" | "SeatDeviceRevokeRequest" | "EngineTargetState" | "EngineTargetResult" | "CloudLoginStart" | "CloudLoginCancelAck" | "CloudConnectResult" | "CloudLoginRequest" | "CloudEngineConnectRequest" | "CloudEngineConfigureRequest" | "OnboardProvidersResult" | "OnboardProbeResult" | "OnboardApplyResult" | "OnboardEntryRequest" | "OnboardApplyRequest" | "McpToolTogglesResult" | "McpToolToggleKey" | "ComputerUseState" | "SetComputerUseResult" | "SetComputerUseRequest" | "SeatAction" | "EngineSwapAnswerOutcome" | "SelfUpgradeOutcome";
     check: (v: unknown) => SeatValidation;
     why: string;
 }[], {

package/dist/seatContract.js

@@ -10,6 +10,7 @@ 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";
+import { LOCAL_ENGINE_SWAP_CAUSES } from "./localEngineSwapCard.js";
 const bad = (reason, field) => field === undefined ? { reason } : { reason, field };
 const nested = (prefix, verdict) => {
     const path = verdict.field === undefined
@@ -184,6 +185,21 @@ const R_INT0 = ruleOf("non-negative integer", (v) => typeof v === "number" && Nu
 const R_INT1 = ruleOf("positive integer", (v) => typeof v === "number" && Number.isSafeInteger(v) && v > 0);
 const SESSION_ENGINE_KIND_WORDS = Object.freeze(["local", "cloud"]);
 const R_ENGINE_LANE = oneOfRule("engine lane", SESSION_ENGINE_KIND_WORDS);
+const R_ROW_BAR = armsRule("row verdict", "kind", {
+    lacking: { code: reqF(R_NONEMPTY), reason: optF(R_NONEMPTY), requires: optF(arrayRule(R_NONEMPTY)), sentence: reqF(R_NONEMPTY) },
+    damaged: { code: reqF(R_NONEMPTY), reason: optF(R_NONEMPTY), requires: optF(arrayRule(R_NONEMPTY)), sentence: reqF(R_NONEMPTY) },
+    unknown: { word: reqF(R_NONEMPTY), sentence: optF(R_NONEMPTY) },
+    unreadable: {},
+});
+const PARKED_ROW_DEADLINE_WORDS = Object.freeze(["armed", "none"]);
+const R_PARKED_ROW = shapeRule("parked row", {
+    rowVerdict: reqF(R_ROW_BAR),
+    rowKey: optF(R_NONEMPTY),
+    taskId: optF(R_NONEMPTY),
+    toolName: optF(R_NONEMPTY),
+    rowDeadline: optF(oneOfRule("deadline word", PARKED_ROW_DEADLINE_WORDS)),
+});
+const R_PARKED_UNRESUMABLE = arrayRule(R_PARKED_ROW, true);
 const keyWords = (k) => k
     .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
     .toLowerCase()
@@ -293,6 +309,7 @@ const CHROME_ARM_SEAT_ROUTE = {
     compaction_started: "seat",
     compaction_outcome: "seat",
     engine_notice: "seat",
+    subagent_alias: "seat",
     workflow_notification_enqueue: "host",
     plan_review_park: "host",
     approval_request: "host",
@@ -687,6 +704,18 @@ export const CLOUD_LOGIN_FAILURES = Object.freeze([
     "no_tokens",
     "other",
 ]);
+export const LOCAL_ENGINE_DOWN_REASONS = Object.freeze([
+    "lock-unavailable",
+    "spawn-failed",
+    "spawn-refused",
+    "stop-failed",
+    "crash-loop",
+    "high-water-unreadable",
+    "principal-unknown",
+]);
+export const LOCAL_ENGINE_WAITING_REASONS = Object.freeze(["starting", "dormant", "draining", "unanswered", "peer"]);
+export const ENGINE_SWAP_ANSWER_OUTCOMES = Object.freeze(["started", "stale-card", "nothing-pending"]);
+export const SELF_UPGRADE_OUTCOMES = Object.freeze(["started", "unavailable"]);
 const R_ISO = R_NONEMPTY;
 const R_LOGIN_FAILURE = oneOfRule("login failure", CLOUD_LOGIN_FAILURES);
 const R_DISPLAY_URL = ruleOf("display url", (v) => {
@@ -763,10 +792,82 @@ const ENGINE_TARGET_CLOUD = shapeRule("cloud", {
     })),
     orgEngine: optF(shapeRule("org engine", { url: reqF(R_DISPLAY_URL), required: reqF(R_BOOL) })),
 });
-const ENGINE_TARGET_LOCAL = shapeRule("local", {
+const R_FINITE_TIME = ruleOf("non-negative integer", (v) => typeof v === "number" && Number.isSafeInteger(v) && v >= 0);
+const SWAP_CARD_IDENTITY = shapeRule("engine identity", {
+    pid: optF(R_INT1),
+    instanceId: optF(R_NONEMPTY),
+    startedAt: optF(R_FINITE_TIME),
+});
+const SWAP_CARD_REF_SPEC = {
+    pid: reqF(R_INT1),
+    port: reqF(ruleOf("port", (v) => typeof v === "number" && Number.isInteger(v) && v >= 1 && v <= 65535)),
+    identity: reqF(SWAP_CARD_IDENTITY),
+    version: optF(R_NONEMPTY),
+};
+const SWAP_CARD_PROCESS_SPEC = { pid: reqF(R_INT1), startedAt: optF(R_INT1) };
+const R_SWAP_CARD_TARGET = {
+    label: "card target",
+    test: (v, path) => {
+        if (!isPlainRecord(v))
+            return bad("not object", path === "" ? undefined : path);
+        return shapeVerdict(isAbsent(own(v, "identity")) ? SWAP_CARD_PROCESS_SPEC : SWAP_CARD_REF_SPEC, v, path);
+    },
+};
+const SWAP_CARD = shapeRule("swap card", {
+    cause: reqF(oneOfRule("swap cause", LOCAL_ENGINE_SWAP_CAUSES)),
+    target: reqF(R_SWAP_CARD_TARGET),
+    running: optF(R_NONEMPTY),
+    own: optF(R_NONEMPTY),
+    others: reqF(ruleOf("others count|null", (v) => {
+        if (v === null)
+            return true;
+        if (!isPlainRecord(v))
+            return false;
+        return shapeVerdict({ total: reqF(R_INT0), midTurn: reqF(R_INT0) }, v, "") === true;
+    })),
+    inflight: reqF(ruleOf("count|null", (v) => v === null || (typeof v === "number" && Number.isSafeInteger(v) && v >= 0))),
+    bgLive: reqF(ruleOf("count|null", (v) => v === null || (typeof v === "number" && Number.isSafeInteger(v) && v >= 0))),
+    unknown: reqF(arrayRule(oneOfRule("card unknown", ["others", "inflight", "bg", "self"]))),
+    forcedWithinMs: reqF(R_INT0),
+    fingerprint: reqF(R_NONEMPTY),
+});
+const LOCAL_ENGINE_SEAT_READING = armsRule("engine lifecycle", "phase", {
+    waiting: { why: reqF(oneOfRule("waiting reason", LOCAL_ENGINE_WAITING_REASONS)), unverifiable: optF(R_TRUE) },
+    attached: {},
+    pending: { serving: reqF(R_BOOL), card: optF(SWAP_CARD) },
+    swapping: { mode: reqF(oneOfRule("swap mode", ["idle", "forced"])) },
+    down: { reason: reqF(oneOfRule("down reason", LOCAL_ENGINE_DOWN_REASONS)) },
+    behind: { running: reqF(R_NONEMPTY), own: reqF(R_NONEMPTY), upgrade: reqF(oneOfRule("upgrade entry", ["available", "unavailable"])) },
+});
+const R_LIFECYCLE_DERIVED = ruleOf("lifecycle-derived", () => false);
+const R_LIFECYCLE_WITHDRAWN = ruleOf("lifecycle-withdrawn", () => false);
+const R_UNANSWERED_ONLY = ruleOf("unanswered-only", () => false);
+const ENGINE_TARGET_LOCAL_SPEC = {
     lastBootError: optF(R_STR),
     mcp: optF(SEAT_LOCAL_MCP_READING),
-});
+    lifecycle: optF(LOCAL_ENGINE_SEAT_READING),
+};
+const ENGINE_TARGET_LOCAL = {
+    label: "local",
+    test: (v, path) => {
+        const verdict = shapeVerdict(ENGINE_TARGET_LOCAL_SPEC, v, path);
+        if (verdict !== true)
+            return verdict;
+        const rec = v;
+        const lifecycle = own(rec, "lifecycle");
+        if (isAbsent(lifecycle))
+            return true;
+        const phase = own(lifecycle, "phase");
+        const bootError = !isAbsent(own(rec, "lastBootError"));
+        if (bootError !== (phase === "down"))
+            return R_LIFECYCLE_DERIVED.test(undefined, pathAt(path, "lastBootError"));
+        if (phase !== "attached" && phase !== "pending" && !isAbsent(own(rec, "mcp")))
+            return R_LIFECYCLE_WITHDRAWN.test(undefined, pathAt(path, "mcp"));
+        if (phase === "waiting" && own(lifecycle, "why") !== "unanswered" && !isAbsent(own(lifecycle, "unverifiable")))
+            return R_UNANSWERED_ONLY.test(undefined, pathAt(pathAt(path, "lifecycle"), "unverifiable"));
+        return true;
+    },
+};
 const ENGINE_TARGET_STATE = shapeRule("engine target", {
     mode: reqF(R_ENGINE_LANE),
     generation: reqF(R_INT0),
@@ -794,6 +895,8 @@ const ENGINE_TARGET_REFUSED_SPEC = {
     detail: optF(R_STR),
 };
 const checkEngineTargetResult = seatShapeCheck(okArmsRule("engineTarget result", {}, ENGINE_TARGET_REFUSED_SPEC));
+const checkEngineSwapAnswerOutcome = seatShapeCheck(oneOfRule("swap answer", ENGINE_SWAP_ANSWER_OUTCOMES));
+const checkSelfUpgradeOutcome = seatShapeCheck(oneOfRule("self upgrade", SELF_UPGRADE_OUTCOMES));
 const checkCancelCloudLogin = seatShapeCheck(shapeRule("cancel ack", { ok: reqF(R_BOOL) }));
 const checkCloudLoginStart = seatShapeCheck(okArmsRule("startCloudLogin result", {
     verificationUri: reqF(R_DISPLAY_URL),
@@ -1240,11 +1343,77 @@ const checkLocalSessionRecord = seatCheck((s) => {
     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");
     }
+    const parkedRows = own(s, "parkedUnresumable");
+    if (!isAbsent(parkedRows)) {
+        const verdict = R_PARKED_UNRESUMABLE.test(parkedRows, "parkedUnresumable");
+        if (verdict !== true)
+            return verdict;
+        if (parked === false)
+            return bad("bad value (parked:false)", "parkedUnresumable");
+    }
     return true;
 });
 export function isLocalSessionRecord(s) {
     return checkLocalSessionRecord(s) === true;
 }
+const checkParkedUnresumableSlot = seatCheck((v) => R_PARKED_UNRESUMABLE.test(v, "parkedUnresumable"));
+const parkedVerdictCopy = (rv) => {
+    const kind = own(rv, "kind");
+    const str = (k) => {
+        const x = own(rv, k);
+        return typeof x === "string" ? x : undefined;
+    };
+    const sentence = str("sentence");
+    if (kind === "lacking" || kind === "damaged") {
+        const reason = str("reason");
+        const requires = own(rv, "requires");
+        return Object.freeze({
+            kind,
+            code: str("code") ?? "",
+            ...(reason !== undefined ? { reason } : {}),
+            ...(Array.isArray(requires) ? { requires: Object.freeze(ownItems(requires).filter((w) => typeof w === "string")) } : {}),
+            sentence: sentence ?? "",
+        });
+    }
+    if (kind === "unknown")
+        return Object.freeze({ kind, word: str("word") ?? "", ...(sentence !== undefined ? { sentence } : {}) });
+    return Object.freeze({ kind: "unreadable" });
+};
+const parkedRowCopy = (item) => {
+    const str = (k) => {
+        const x = own(item, k);
+        return typeof x === "string" ? x : undefined;
+    };
+    const rv = own(item, "rowVerdict");
+    const rowKey = str("rowKey");
+    const taskId = str("taskId");
+    const toolName = str("toolName");
+    const rowDeadline = str("rowDeadline");
+    return Object.freeze({
+        rowVerdict: parkedVerdictCopy(typeof rv === "object" && rv !== null ? rv : {}),
+        ...(rowKey !== undefined ? { rowKey } : {}),
+        ...(taskId !== undefined ? { taskId } : {}),
+        ...(toolName !== undefined ? { toolName } : {}),
+        ...(rowDeadline === "armed" || rowDeadline === "none" ? { rowDeadline } : {}),
+    });
+};
+export function readSeatParkedUnresumable(record) {
+    try {
+        if (typeof record !== "object" || record === null)
+            return undefined;
+        const v = own(record, "parkedUnresumable");
+        if (isAbsent(v))
+            return undefined;
+        if (own(record, "parked") === false)
+            return undefined;
+        if (checkParkedUnresumableSlot(v) !== true)
+            return undefined;
+        return Object.freeze(ownItems(v).map((item) => parkedRowCopy(item)));
+    }
+    catch {
+        return undefined;
+    }
+}
 const checkToctouBinding = seatCheck((v) => {
     if (!isPlainRecord(v))
         return bad("toctouBinding must be a plain object", "toctouBinding");
@@ -1898,6 +2067,8 @@ export const LOCAL_SESSIONS_SPEC = {
         connectCloudEngine: { kind: "invoke", check: checkCloudConnectResult },
         configureCloudEngine: { kind: "invoke", check: checkCloudConnectResult },
         clearCloudEngine: { kind: "invoke", check: checkEngineTargetResult },
+        answerEngineSwap: { kind: "invoke", check: checkEngineSwapAnswerOutcome },
+        beginSelfUpgrade: { kind: "invoke", check: checkSelfUpgradeOutcome },
         listOnboardProviders: { kind: "invoke", check: checkOnboardProvidersResult },
         probeOnboardEntry: { kind: "invoke", check: checkOnboardProbeResult },
         applyOnboardEntry: { kind: "invoke", check: checkOnboardApplyResult },
@@ -1950,6 +2121,8 @@ export const SEAT_METHOD_NAMES = [
     "connectCloudEngine",
     "configureCloudEngine",
     "clearCloudEngine",
+    "answerEngineSwap",
+    "beginSelfUpgrade",
     "listOnboardProviders",
     "probeOnboardEntry",
     "applyOnboardEntry",
@@ -2024,6 +2197,7 @@ export const LOCAL_SESSION_RECORD_KEYS = [
     "thinkingLatch",
     "engine",
     "executionLane",
+    "parkedUnresumable",
 ];
 export const SEND_MESSAGE_REQUEST_KEYS = [
     "sessionId",
@@ -2068,7 +2242,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", "unreadable", "thinkingLatch", "engine", "executionLane"],
+        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned", "rowTag", "unreadable", "thinkingLatch", "engine", "executionLane", "parkedUnresumable"],
         unchecked: [],
     },
     ToolPermissionRequest: {
@@ -2341,6 +2515,8 @@ export const SEAT_VALIDATOR_COVERAGE_EXEMPT = [
         ["SetComputerUseResult", checkSetComputerUseResult],
         ["SetComputerUseRequest", checkSetComputerUseRequest],
         ["SeatAction", checkSeatAction],
+        ["EngineSwapAnswerOutcome", checkEngineSwapAnswerOutcome],
+        ["SelfUpgradeOutcome", checkSelfUpgradeOutcome],
     ].map(([label, check]) => ({
         label,
         check,
@@ -2404,5 +2580,6 @@ const _seatContractPins = [
     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/sessionBackground.js

@@ -34,6 +34,8 @@ export function readSessionBackgroundable(baseUrl = engineWireTargetBaseUrl()) {
         return Object.freeze({ kind: 'unobserved' });
     }
 }
+const localEngineLanePin = true;
+void localEngineLanePin;
 export const OPENING_RECORD_CAP = 256;
 const wireStates = new WeakMap();
 const isObj = (v) => (typeof v === 'object' && v !== null) || typeof v === 'function';

package/dist/subagentContentStore.d.ts

@@ -49,6 +49,18 @@ export declare function __resetSubagentContentStoreConfigForTests(): void;
 export declare function bindSubagentIdentityReader(fn: (id: string) => readonly string[] | undefined): void;
 export declare function registerSubagentContentAlias(parentToolCallId: string, taskId: string): void;
 export declare function registerSubagentAlias(parentToolCallId: string, taskId: string): void;
+export declare const SUBAGENT_ALIAS_SCOPES: readonly ["content", "full"];
+export type SubagentAliasScope = (typeof SUBAGENT_ALIAS_SCOPES)[number];
+export type SubagentAliasOutcome = 'new' | 'unchanged' | 'rejected';
+export declare function applySubagentAlias(parentToolCallId: string, taskId: string, scope: SubagentAliasScope, seq?: number): SubagentAliasOutcome;
+export interface SeatSubagentAlias {
+    readonly parentToolCallId: string;
+    readonly taskId: string;
+    readonly scope: SubagentAliasScope;
+    readonly seq?: number;
+}
+export declare function readSeatSubagentAlias(ev: object | null | undefined): SeatSubagentAlias | undefined;
+export declare function noteSeatSubagentAlias(ev: object | null | undefined): 'registered' | 'ignored';
 export declare function publishSubagentContentEvent(ev: SubagentContentEvent): void;
 export declare function pushSubagentLocalEcho(taskId: string, text: string): void;
 export interface SubagentContentSnapshot {