@sema-agent/client-core 0.97.0 → 0.98.0

package/dist/runTerminal.js

@@ -3,6 +3,8 @@ import { isSdkRunParked } from './terminalStatuses.js';
 import { readOwnDataNonEmptyString, readOwnDataValue } from './ownKey.js';
 import { doneResultView } from './replayBody.js';
 export const PROMPT_BLOCK_CAUSES = CORE_PROMPT_BLOCK_CAUSES;
+const _promptBlockTablePin = true;
+void _promptBlockTablePin;
 const PROMPT_BLOCKED_BY_HOOK_DETAIL_KIND = 'prompt_blocked_by_hook';
 function str(v) {
     return typeof v === 'string' && v.length > 0 ? v : undefined;
@@ -267,8 +269,7 @@ export function readRunTerminal(result) {
         return null;
     const view = doneResultView(result);
     if (view.replay) {
-        const inner = readRunTerminalArm(view.engine) ?? readRunTerminalArm({ status: view.row?.status, errorCode: view.row?.errorCode, errorMessage: view.row?.error });
-        return inner === null ? null : { ...inner, replay: true };
+        return readRunTerminalArm(view.engine) ?? readRunTerminalArm({ status: view.row?.status, errorCode: view.row?.errorCode, errorMessage: view.row?.error });
     }
     return readRunTerminalArm(result);
 }
@@ -278,16 +279,14 @@ function readRunTerminalArm(result) {
     const r = result;
     if ('terminal' in r) {
         const t = r.terminal;
-        if (typeof t !== 'object' || t === null || Array.isArray(t))
-            return { kind: 'unknown', plane: 'cause' };
-        const c = t;
-        const kind = str(c.kind);
-        if (kind === undefined)
-            return { kind: 'unknown', plane: 'cause' };
+        const c = typeof t === 'object' && t !== null && !Array.isArray(t) ? t : undefined;
+        const kind = c === undefined ? undefined : str(c.kind);
         const parkWord = str(r.status);
         if (isSdkRunParked(parkWord)) {
-            return { kind: 'paused', plane: 'cause', flatStatus: parkWord, ...(kind === 'paused' ? (pauseOf(c) ?? {}) : {}) };
+            return { kind: 'paused', plane: 'cause', flatStatus: parkWord, ...(c !== undefined && kind === 'paused' ? (pauseOf(c) ?? {}) : {}) };
         }
+        if (c === undefined || kind === undefined)
+            return { kind: 'unknown', plane: 'cause' };
         switch (kind) {
             case 'completed': {
                 const detail = completedDetailOf(c);

package/dist/sandboxWire.d.ts

@@ -23,4 +23,6 @@ export declare const SANDBOX_K8S_ONLY_400_ANCHOR = "only supported on the k8s sa
 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 declare function sandboxDegradeHint(err: unknown): string | undefined;
+export type SandboxHintHost = 'terminal' | 'web' | 'desktop';
+export declare const SANDBOX_HINT_HOSTS: readonly SandboxHintHost[];
+export declare function sandboxDegradeHint(err: unknown, host?: SandboxHintHost): string | undefined;

package/dist/sandboxWire.js

@@ -1,5 +1,6 @@
 import { lastFlagValue } from './argvFlagValue.js';
 import { CAPABILITY_IMAGE_INDEX_REQUIRED } from './engineErrorCodes.js';
+import { THROWN_SLOT_UNREADABLE, readThrownSlot } from './wireFailureShape.js';
 const MAX_PROFILE_LEN = 128;
 const USAGE_HINT = "sema: --sandbox expects a profile name or 'auto'.\n" +
     '  --sandbox <profile>  run on that sandbox image profile (k8s-lane workers; list: sema cloud images list)\n' +
@@ -46,36 +47,84 @@ export const SANDBOX_K8S_ONLY_400_ANCHOR = 'only supported on the k8s sandbox ba
 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';
-const SANDBOX_IMAGE_INDEX_501_HINT = 'Cloud sandbox images are not available on this engine: its storage backend keeps no image index, so profiles cannot be listed or selected here.\n' +
-    'Use a worker backed by a SQL store (it has the image index), or re-run without --sandbox.';
-function imageIndexRequiredCode(err) {
+export const SANDBOX_HINT_HOSTS = Object.freeze(['terminal', 'web', 'desktop']);
+const SANDBOX_HINT_ARMS = Object.freeze({
+    imageIndexRequired501: {
+        fact: 'Cloud sandbox images are not available on this engine: its storage backend keeps no image index, so profiles cannot be listed or selected here.',
+        sep: '\n',
+        outlet: {
+            terminal: 'Use a worker backed by a SQL store (it has the image index), or re-run without --sandbox.',
+            graphical: 'Use a worker backed by a SQL store (it has the image index), or keep the default environment.',
+        },
+    },
+    k8sLaneOnly400: {
+        subject: { terminal: '--sandbox <profile>', graphical: 'The selected sandbox image profile' },
+        fact: ' only applies on k8s-lane workers; this engine runs a host/e2b sandbox lane, so the request was honestly rejected.',
+        sep: '\n',
+        outlet: {
+            terminal: 'Re-run without --sandbox (worker default image), or point the shell at a k8s-lane worker (sema cloud engine connect <url>).',
+            graphical: 'Keep the default environment, or connect to a k8s-lane worker.',
+        },
+    },
+    noImageIndex400: {
+        fact: 'This worker has no sandbox image index configured (the sema-web-admin config center is not attached), so per-task profiles cannot resolve.',
+        sep: '\n',
+        outlet: {
+            terminal: 'Re-run without --sandbox, or use a worker with the image index enabled.',
+            graphical: 'Keep the default environment, or use a worker with the image index enabled.',
+        },
+    },
+    noPublishedImage404: {
+        fact: 'No published image matches that profile for your principal.',
+        sep: ' ',
+        outlet: {
+            terminal: 'List what you can use: sema cloud images list',
+            graphical: 'Choose one of the environments that are offered instead.',
+        },
+    },
+    cascadeConflict400: {
+        subject: { terminal: '--sandbox', graphical: 'The sandbox image profile' },
+        fact: ' cannot combine with cascade/verify submits in v1 (the per-task image would not bind to the sub-runs).',
+        sep: ' ',
+        outlet: { terminal: 'Drop one of the two.', graphical: 'Drop one of the two.' },
+    },
+});
+function sandboxHintOf(arm, host) {
+    const terminal = host === undefined || host === 'terminal';
+    const graphical = host === 'web' || host === 'desktop';
+    const subject = arm.subject === undefined ? '' : terminal ? arm.subject.terminal : arm.subject.graphical;
+    const factSegment = `${subject}${arm.fact}`;
+    if (terminal)
+        return `${factSegment}${arm.sep}${arm.outlet.terminal}`;
+    if (graphical)
+        return `${factSegment}${arm.sep}${arm.outlet.graphical}`;
+    return factSegment;
+}
+function sandboxSlot(err, key) {
+    const v = readThrownSlot(err, key, 'data');
+    return v === THROWN_SLOT_UNREADABLE ? undefined : v;
+}
+export function sandboxDegradeHint(err, host) {
+    const status = sandboxSlot(err, 'status');
+    if (status === 501 && sandboxSlot(err, 'errorCode') === CAPABILITY_IMAGE_INDEX_REQUIRED)
+        return sandboxHintOf(SANDBOX_HINT_ARMS.imageIndexRequired501, host);
+    if (typeof err !== 'object' || err === null || typeof status !== 'number')
+        return undefined;
     try {
-        return typeof err === 'object' && err !== null && err.errorCode === CAPABILITY_IMAGE_INDEX_REQUIRED;
+        const msg = err.message;
+        if (typeof msg !== 'string')
+            return undefined;
+        if (status === 400 && msg.includes(SANDBOX_K8S_ONLY_400_ANCHOR))
+            return sandboxHintOf(SANDBOX_HINT_ARMS.k8sLaneOnly400, host);
+        if (status === 400 && msg.includes(SANDBOX_NO_IMAGE_INDEX_400_ANCHOR))
+            return sandboxHintOf(SANDBOX_HINT_ARMS.noImageIndex400, host);
+        if (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;
     }
     catch {
-        return false;
-    }
-}
-export function sandboxDegradeHint(err) {
-    const e = err;
-    if (e?.status === 501 && imageIndexRequiredCode(err))
-        return SANDBOX_IMAGE_INDEX_501_HINT;
-    if (typeof e?.status !== 'number' || typeof e?.message !== 'string')
         return undefined;
-    const msg = e.message;
-    if (e.status === 400 && msg.includes(SANDBOX_K8S_ONLY_400_ANCHOR)) {
-        return ('--sandbox <profile> only applies on k8s-lane workers; this engine runs a host/e2b sandbox lane, so the request was honestly rejected.\n' +
-            'Re-run without --sandbox (worker default image), or point the shell at a k8s-lane worker (sema cloud engine connect <url>).');
-    }
-    if (e.status === 400 && msg.includes(SANDBOX_NO_IMAGE_INDEX_400_ANCHOR)) {
-        return ('This worker has no sandbox image index configured (the sema-web-admin config center is not attached), so per-task profiles cannot resolve.\n' +
-            'Re-run without --sandbox, or use a worker with the image index enabled.');
-    }
-    if (e.status === 404 && msg.includes(SANDBOX_NO_PUBLISHED_IMAGE_404_ANCHOR)) {
-        return 'No published image matches that profile for your principal. List what you can use: sema cloud images list';
-    }
-    if (e.status === 400 && msg.includes(SANDBOX_CASCADE_CONFLICT_400_ANCHOR)) {
-        return '--sandbox cannot combine with cascade/verify submits in v1 (the per-task image would not bind to the sub-runs). Drop one of the two.';
     }
-    return undefined;
 }

package/dist/scenarioWire.js

@@ -4,7 +4,7 @@ export const SCENARIO_NAME_RE = /^[a-z][a-z0-9-]{1,31}$/;
 export const HEADLESS_SCENARIO_ENV = 'SEMA_HEADLESS_SCENARIO';
 const USAGE_HINT = "sema: --scenario expects a scenario name (lowercase letters/digits/hyphens, starting with a letter, ≤32 chars).\n" +
     '  --scenario <name>    route this run through the named engine scenario (deployment-defined tool\n' +
-    '                       roster + system prompt; unknown names fall back to the default scenario)\n' +
+    '                       roster + system prompt; unknown names are refused by the engine (scenario_unknown))\n' +
     '  (no flag)            the default scenario — today\'s behaviour';
 export function parseScenarioArgv(argv) {
     const flag = lastFlagValue(argv, '--scenario');

package/dist/seam.d.ts

@@ -5,6 +5,7 @@ import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcp
 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 { ToolKillCause } from './toolResult.js';
 export interface AbortSignalLike {
     readonly aborted: boolean;
 }
@@ -27,7 +28,18 @@ export interface AdapterContext {
     signal?: AbortSignalLike;
     setTimer?(ms: number, fn: () => void): TimerHandle;
     clearTimer?(handle: TimerHandle): void;
+    toolKillCause?(call: {
+        readonly toolCallId: string;
+        readonly toolName: string;
+    }): ToolKillCause | undefined;
     coalesceIntervalMs?: number;
+    continuesPark?: ContinuesParkDeclaration;
+}
+export interface ContinuesParkDeclaration {
+    readonly toolCallId: string;
+    readonly checkpointId?: string;
+    readonly parkedTaskId?: string;
+    readonly continuationTaskId?: string;
 }
 export type ChromeEvent = {
     kind: 'retry_status';
@@ -152,7 +164,7 @@ export type ChromeEvent = {
 } | ({
     kind: 'run_cost_reconciled';
     laneProof: LaneProof;
-} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
     kind: 'suspended_reopened';
     laneProof: LaneProof;
     reopen: Extract<SuspendedReopenReading, {
@@ -286,6 +298,17 @@ export interface ResultTextDivergedChromeEvent {
     committedLength: number;
     resultLength: number;
 }
+export interface ResultReplayedChromeEvent {
+    kind: 'result_replayed';
+    laneProof: LaneProof;
+    text: string;
+}
+export interface ToolParkedChromeEvent {
+    kind: 'tool_parked';
+    laneProof: LaneProof;
+    toolUseId: string;
+    rowUuid?: string;
+}
 export interface EngineNoticeChromeEvent {
     kind: 'engine_notice';
     laneProof: LaneProof;
@@ -352,6 +375,5 @@ export interface WireToCcAdapter {
 }
 export declare function deriveTranscriptId(frame: {
     id?: unknown;
-    seq?: unknown;
     toolCallId?: unknown;
 }, ctx: Pick<AdapterContext, 'uuid'>, suffix?: string): string;

package/dist/seam.js

@@ -113,6 +113,19 @@ const CHROME_ARM_TABLE = {
             'mcp 的空数组是「一台都没申报」这句正面事实、**不是**缺席(判在场写 mcp !== undefined,' +
             '别写 mcp?.length),errorCode 按开集分支必带 default;durable 重放按 run/leg 幂等',
     },
+    result_replayed: {
+        required: true,
+        duty: '0.98.0:提交幂等的重放(同一把幂等键命中更早的一次提交,这次没有新跑)。每个重放终局恰一条,在终局臂全部产出之后;渲一行 `text`,不进模型面。' +
+            '🔴 零转录行的重放终局(空正文成功 / 停驻)里本臂是这一轮唯一的可渲染产出 —— 不接 = 整轮无提示;' +
+            '句子只说「这次没有新跑」,结局由已有的行与结果帧说,别在本臂上拼结局,也别从行上的 `_sema_replay` 现拼句子;' +
+            '没收到本臂 ≠ 这次真跑;续读 / 接管重投的终局永不发本臂;冷恢复后看不到是诚实缺席(要留就把渲成的那一行随转录落盘)。',
+    },
+    tool_parked: {
+        required: true,
+        duty: '0.98.0:被停驻扣住的那只调用此刻是「停驻、没结算」—— 摘卡那一拍恰一枚(同一拍零终态行)。把 `rowUuid` 那一行(调用 occurrence 的开始行)置「在等审批」;' +
+            '按开始行 uuid 认行,不按 toolUseId(调用 id 只在同一条助手消息内唯一)。它的终态由执行腿的结果铸(续跑带见证时接回原行),或永远缺席(停驻被取消 / 过期)。' +
+            '连坐旁观者 / 普通错误 / 停驻卡上 Esc(包已自发中断拒绝,行照铸 Interrupted)零枚。',
+    },
     result_text_diverged: {
         required: false,
         duty: '可选:终帧正文与已上屏正文**互相都不是对方前缀**时的诚实披露。🔴 处置是把这一拍的转录行**改口**' +
@@ -155,14 +168,13 @@ const CHROME_ARM_TABLE = {
             '⑦序:该段尾部的活体增量(`stream_delta`)一律先于本事件到达,本事件之后不再有同段增量(下一条增量属于下一段)。',
     },
 };
+const _chromeArmRequiredFloorPins = [true, true];
+void _chromeArmRequiredFloorPins;
 export const CHROME_ARMS = Object.entries(CHROME_ARM_TABLE).map(([kind, d]) => ({ kind, required: d.required, duty: d.duty }));
 export function deriveTranscriptId(frame, ctx, suffix) {
     if (typeof frame.id === 'string' && frame.id.length > 0) {
         return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wid_${frame.id}#${suffix}` : `wid_${frame.id}`);
     }
-    if (typeof frame.seq === 'number') {
-        return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wseq#${suffix}_${frame.seq}` : `wseq_${frame.seq}`);
-    }
     if (typeof frame.toolCallId === 'string' && frame.toolCallId.length > 0) {
         return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wtc#${suffix}_${frame.toolCallId}` : `wtc_${frame.toolCallId}`);
     }

package/dist/seatContract.d.ts

@@ -1,6 +1,7 @@
 import type { ReasoningEffort } from "./effortWire.js";
 import type { PermissionMode } from "./permissionWireCaps.js";
 import type { ChromeArmKind, LaneProof } from "./seam.js";
+import type { SeatTurnFailure } from "./turnFailurePresentation.js";
 import type { QuestionAnswer } from "./liveQuestionStore.js";
 import type { ToolApprovalDelegation } from "./hitl/toolApprovalWire.js";
 import type { ApprovalMandateWord } from "./gateVocabulary.js";
@@ -73,7 +74,7 @@ export interface ToolPermissionRequest {
 declare const SEAT_EVENT_TYPE_TUPLE: readonly ["start", "close", "session_updated", "message", "stream_event", "chrome_event", "error", "tool_permission_resolved"];
 export type SeatEventType = (typeof SEAT_EVENT_TYPE_TUPLE)[number];
 export declare const SEAT_EVENT_TYPES: readonly SeatEventType[];
-declare const CHROME_EVENT_KIND_TUPLE: readonly ["panel_task", "notification_terminal", "prompt_suggestions", "subagent_lifecycle", "text_segment_end", "thinking_segment_end"];
+declare const CHROME_EVENT_KIND_TUPLE: readonly ["panel_task", "notification_terminal", "prompt_suggestions", "subagent_lifecycle", "text_segment_end", "thinking_segment_end", "retry_status", "context_usage", "last_turn_usage", "bgshell_register", "bgshell_settle", "memory_saved", "result_replayed", "tool_parked"];
 export type ChromeEventKind = Extract<ChromeArmKind, (typeof CHROME_EVENT_KIND_TUPLE)[number]>;
 export declare const CHROME_EVENT_KINDS: readonly ChromeEventKind[];
 export interface SeatChromeEnvelopeBase {
@@ -88,23 +89,58 @@ export interface LocalSessionEvent {
     type: SeatEventType;
     sessionId: string;
     message?: unknown;
-    messages?: unknown[];
     error?: string;
     errorCategory?: string;
+    _sema_turnFailure?: SeatTurnFailure;
     code?: number;
     request?: ToolPermissionRequest;
-    data?: string;
     sources?: string[];
-    permissionMode?: PermissionModeIntent;
     session?: LocalSessionRecord;
     userMessageUuid?: string;
-    hasPreClearSession?: boolean;
     requestId?: string;
     outcome?: string;
     parked?: true;
     chrome?: SeatChromeEnvelope;
 }
 export declare const HITL_RESOLUTION_OUTCOMES: readonly string[];
+export declare const SEAT_STREAM_DELTA_TYPE_OF_CHANNEL: Readonly<{
+    readonly text: "text_delta";
+    readonly thinking: "thinking_delta";
+}>;
+export type SeatStreamChannel = keyof typeof SEAT_STREAM_DELTA_TYPE_OF_CHANNEL;
+export type SeatStreamDeltaType = (typeof SEAT_STREAM_DELTA_TYPE_OF_CHANNEL)[SeatStreamChannel];
+export interface SeatStreamDelta {
+    type: SeatStreamDeltaType;
+    delta: string;
+}
+export interface SeatStreamEventMessage {
+    type: "stream_event";
+    uuid: string;
+    session_id: string;
+    event: SeatStreamDelta;
+    parent_tool_use_id: null;
+}
+export interface SeatStreamDeltaSource {
+    readonly channel: SeatStreamChannel;
+    readonly text: string;
+}
+export interface SeatStreamDeltaIds {
+    readonly uuid: string;
+    readonly sessionId: string;
+}
+export type SeatStreamReading = {
+    readonly kind: "delta";
+    readonly channel: SeatStreamChannel;
+    readonly delta: string;
+} | {
+    readonly kind: "unknown_event";
+} | {
+    readonly kind: "malformed";
+} | {
+    readonly kind: "not_stream_event";
+};
+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"];
 export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
 export interface SeatCapabilitiesState {
@@ -328,11 +364,15 @@ export interface ApplyModelConfigRequest {
     defaultModel: SeatCatalogEntry;
     cheapModel?: SeatCatalogEntry;
 }
+export declare const APPLY_MODEL_CONFIG_REASONS: readonly ["shadowed_by_models_json", "cheap_provider_unsupported", "invalid_request", "write_failed", "unavailable"];
+export type ApplyModelConfigReason = (typeof APPLY_MODEL_CONFIG_REASONS)[number];
 export interface ApplyModelConfigResult {
     ok: boolean;
-    reason?: string;
+    reason?: ApplyModelConfigReason;
+    detail?: string;
     requiresRestart: boolean;
 }
+export declare function applyModelConfigReasonDetail(reason: string | undefined): string;
 export declare function checkSendMessageRequest(v: unknown): SeatValidation;
 export declare function isSendMessageRequest(v: unknown): v is SendMessageRequest;
 export declare const checkSessionRowPatchRequest: (v: unknown) => SeatValidation;
@@ -342,7 +382,7 @@ 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", "onEvent", "onToolPermissionRequest"];
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore", "seatCapabilitiesStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
-export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "messages", "error", "errorCategory", "code", "request", "data", "sources", "permissionMode", "session", "userMessageUuid", "hasPreClearSession", "requestId", "outcome", "parked", "chrome"];
+export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "error", "errorCategory", "code", "request", "sources", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome", "_sema_turnFailure"];
 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"];
 export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario", "rewind"];
@@ -436,10 +476,13 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     readonly LocalSessionEvent: {
         readonly guard: "isLocalSessionEvent";
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["type", "sessionId", "messages", "error", "errorCategory", "code", "request", "data", "sources", "permissionMode", "session", "userMessageUuid", "hasPreClearSession", "requestId", "outcome", "parked", "chrome"];
+        readonly validated: readonly ["type", "sessionId", "error", "errorCategory", "code", "request", "sources", "session", "userMessageUuid", "requestId", "outcome", "parked", "chrome"];
         readonly unchecked: readonly [{
             readonly key: "message";
             readonly why: "transcript 面直通位(CC fQe 逐字姿态:SDKMessage 体不做 schema 校验)—— 校它 = 引擎加一种消息体的那天整条转录被门吃掉。";
+        }, {
+            readonly key: "_sema_turnFailure";
+            readonly why: "turn 失败的呈现判决(CC-378 TK-9),核形在包读口 readSeatTurnFailure(坏形 / 表外类别词 ⇒ undefined、渲染端只渲 error 文本);出站门为它拒掉整条 error 事件 = 宿主 settle 照走、渲染端把失败轮渲成完成,所以门只登键不拒。";
         }];
     };
     readonly AttachmentUploadReceipt: {
@@ -450,7 +493,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
     readonly LiveModelCatalog: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["models", "default", "defaultModel"];
+        readonly validated: readonly ["models", "defaultModel"];
         readonly unchecked: readonly [{
             readonly key: "droppedEntries";
             readonly why: "诊断面(哪些目录条目没被引擎收下),三态读法归 droppedModelEntriesOf(含坏形 malformed);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
@@ -473,7 +516,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
     readonly ApplyModelConfigResult: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["ok", "requiresRestart", "reason"];
+        readonly validated: readonly ["ok", "requiresRestart", "reason", "detail"];
         readonly unchecked: readonly [];
     };
     readonly SendMessageAck: {