@sema-agent/client-core 0.94.0 → 0.96.0

package/dist/runTerminal.d.ts

@@ -15,7 +15,16 @@ export interface RunTerminalFailureDetail {
     kind: string;
     status?: number;
     code?: string;
+    providerCondition?: string;
+    providerConditionSource?: string;
 }
+export type RunTerminalCompletedDetail = {
+    kind: 'finish_reason_unknown';
+    finishReasonUnknown: string;
+} | {
+    kind: 'unrecognized';
+    word: string;
+};
 export declare const PROMPT_BLOCK_CAUSES: readonly ["block", "crashed", "timeout", "cancelled"];
 export type PromptBlockCause = (typeof PROMPT_BLOCK_CAUSES)[number];
 export type RunTerminalBlockedDetail = {
@@ -31,9 +40,13 @@ export type RunTerminalBlockedDetail = {
     kind: 'unrecognized';
     word: string;
 };
-export type RunTerminalRead = {
+export type RunTerminalRead = RunTerminalReadArm & {
+    readonly replay?: true;
+};
+type RunTerminalReadArm = {
     kind: 'completed';
     plane: RunTerminalPlane;
+    detail?: RunTerminalCompletedDetail;
 } | {
     kind: 'failed';
     plane: RunTerminalPlane;
@@ -60,14 +73,4 @@ export declare function runTerminalGateKind(read: RunTerminalRead | null): strin
 export declare function runTerminalGateToolName(read: RunTerminalRead | null): string | undefined;
 export declare function runTerminalCode(read: RunTerminalRead | null): string | undefined;
 export declare function isReviewPark(read: RunTerminalRead | null): boolean;
-export declare const TERMINAL_CAUSE_KINDS: readonly ["completed", "failed", "blocked", "paused"];
-export type TerminalCauseKind = (typeof TERMINAL_CAUSE_KINDS)[number];
-export declare function isTerminalCauseKind(kind: unknown): kind is TerminalCauseKind;
-export declare const RUN_TERMINAL_NOT_SUCCESS_STATUSES: readonly ["failed", "killed", "blocked"];
-export type RunTerminalNotSuccessStatus = (typeof RUN_TERMINAL_NOT_SUCCESS_STATUSES)[number];
-export declare function isTerminalNotSuccess(status: unknown): status is RunTerminalNotSuccessStatus;
-export declare const RUN_TERMINAL_STATUSES: readonly ["completed", "failed", "killed", "blocked"];
-export type RunTerminalStatus = (typeof RUN_TERMINAL_STATUSES)[number];
-export declare function isTerminalStatus(status: unknown): status is RunTerminalStatus;
-export declare const TASK_NOTIFICATION_TERMINAL_STATUSES: readonly string[];
-export declare function isTaskNotificationTerminalStatus(status: string | undefined): boolean;
+export {};

package/dist/runTerminal.js

@@ -1,4 +1,7 @@
-import { CORE_PROMPT_BLOCK_CAUSES, CORE_TERMINAL_CAUSE_KINDS } from './generated/engineFactTables.js';
+import { CORE_PROMPT_BLOCK_CAUSES } from './generated/engineFactTables.js';
+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 PROMPT_BLOCKED_BY_HOOK_DETAIL_KIND = 'prompt_blocked_by_hook';
 function str(v) {
@@ -40,7 +43,42 @@ function failureDetailOf(cause) {
         if (kind === PROVIDER_REJECTED_DETAIL_KIND && (status === undefined || status < 400))
             return undefined;
         const code = str(own(v, 'code'));
-        return { kind, ...(status !== undefined ? { status } : {}), ...(code !== undefined ? { code } : {}) };
+        const isRejection = kind === PROVIDER_REJECTED_DETAIL_KIND;
+        const providerCondition = isRejection ? optionalDetailString(v, 'providerCondition') : undefined;
+        const providerConditionSource = isRejection ? optionalDetailString(v, 'providerConditionSource') : undefined;
+        return {
+            kind,
+            ...(status !== undefined ? { status } : {}),
+            ...(code !== undefined ? { code } : {}),
+            ...(providerCondition !== undefined ? { providerCondition } : {}),
+            ...(providerConditionSource !== undefined ? { providerConditionSource } : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function optionalDetailString(d, key) {
+    try {
+        return readOwnDataNonEmptyString(d, key);
+    }
+    catch {
+        return undefined;
+    }
+}
+const FINISH_REASON_UNKNOWN_DETAIL_KIND = 'finish_reason_unknown';
+function completedDetailOf(cause) {
+    try {
+        const v = readOwnDataValue(cause, 'detail');
+        if (typeof v !== 'object' || v === null || Array.isArray(v))
+            return undefined;
+        const kind = readOwnDataNonEmptyString(v, 'kind');
+        if (kind === undefined)
+            return undefined;
+        if (kind !== FINISH_REASON_UNKNOWN_DETAIL_KIND)
+            return { kind: 'unrecognized', word: kind };
+        const word = readOwnDataNonEmptyString(v, 'finishReasonUnknown');
+        return word === undefined ? undefined : { kind: FINISH_REASON_UNKNOWN_DETAIL_KIND, finishReasonUnknown: word };
     }
     catch {
         return undefined;
@@ -69,8 +107,17 @@ function blockedDetailOf(cause) {
         return undefined;
     }
 }
-const FLAT_PAUSED_STATUSES = ['suspended', 'needs_review'];
 export function readRunTerminal(result) {
+    if (typeof result !== 'object' || result === null || Array.isArray(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(result);
+}
+function readRunTerminalArm(result) {
     if (typeof result !== 'object' || result === null || Array.isArray(result))
         return null;
     const r = result;
@@ -83,12 +130,14 @@ export function readRunTerminal(result) {
         if (kind === undefined)
             return { kind: 'unknown', plane: 'cause' };
         const parkWord = str(r.status);
-        if (parkWord !== undefined && FLAT_PAUSED_STATUSES.includes(parkWord)) {
+        if (isSdkRunParked(parkWord)) {
             return { kind: 'paused', plane: 'cause', flatStatus: parkWord, ...(kind === 'paused' ? (pauseOf(c) ?? {}) : {}) };
         }
         switch (kind) {
-            case 'completed':
-                return { kind: 'completed', plane: 'cause' };
+            case 'completed': {
+                const detail = completedDetailOf(c);
+                return { kind: 'completed', plane: 'cause', ...(detail !== undefined ? { detail } : {}) };
+            }
             case 'failed': {
                 const code = str(c.code);
                 const message = str(c.message);
@@ -138,7 +187,7 @@ export function readRunTerminal(result) {
             ...(code !== undefined ? { code } : {}),
         };
     }
-    if (FLAT_PAUSED_STATUSES.includes(status)) {
+    if (isSdkRunParked(status)) {
         const gate = gateOf(r.checkpointGate);
         const checkpointId = str(r.checkpointId);
         const restoreMode = str(r.workspaceRestoreMode);
@@ -160,11 +209,10 @@ export function readRunTerminal(result) {
         ...(message !== undefined ? { message } : {}),
     };
 }
-export const REVIEW_PARK_GATE_KINDS = Object.freeze([
-    'plan_review',
-    'dry_run_review',
-    'needs_review',
-]);
+const REVIEW_PARK_GATE_KIND_TUPLE = ['plan_review', 'needs_review'];
+const _reviewParkGateKindPins = [true, true];
+void _reviewParkGateKindPins;
+export const REVIEW_PARK_GATE_KINDS = Object.freeze([...REVIEW_PARK_GATE_KIND_TUPLE]);
 export function runTerminalGateKind(read) {
     return read !== null && read.kind === 'paused' ? str(read.gate?.kind) : undefined;
 }
@@ -183,26 +231,3 @@ export function isReviewPark(read) {
         return true;
     return read !== null && read.kind === 'paused' && read.flatStatus === FLAT_REVIEW_STATUS;
 }
-export const TERMINAL_CAUSE_KINDS = CORE_TERMINAL_CAUSE_KINDS;
-export function isTerminalCauseKind(kind) {
-    return typeof kind === 'string' && TERMINAL_CAUSE_KINDS.includes(kind);
-}
-export const RUN_TERMINAL_NOT_SUCCESS_STATUSES = Object.freeze([
-    'failed',
-    'killed',
-    'blocked',
-]);
-export function isTerminalNotSuccess(status) {
-    return typeof status === 'string' && RUN_TERMINAL_NOT_SUCCESS_STATUSES.includes(status);
-}
-export const RUN_TERMINAL_STATUSES = Object.freeze([
-    'completed',
-    ...RUN_TERMINAL_NOT_SUCCESS_STATUSES,
-]);
-export function isTerminalStatus(status) {
-    return typeof status === 'string' && RUN_TERMINAL_STATUSES.includes(status);
-}
-export const TASK_NOTIFICATION_TERMINAL_STATUSES = Object.freeze(['completed', 'failed', 'killed', 'cancelled']);
-export function isTaskNotificationTerminalStatus(status) {
-    return status !== undefined && TASK_NOTIFICATION_TERMINAL_STATUSES.includes(status);
-}

package/dist/sandboxWire.js

@@ -1,4 +1,5 @@
 import { lastFlagValue } from './argvFlagValue.js';
+import { CAPABILITY_IMAGE_INDEX_REQUIRED } from './engineErrorCodes.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' +
@@ -45,8 +46,20 @@ 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) {
+    try {
+        return typeof err === 'object' && err !== null && err.errorCode === CAPABILITY_IMAGE_INDEX_REQUIRED;
+    }
+    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;

package/dist/sdkRegistryTransit.d.ts

@@ -3,5 +3,6 @@ export { getMeConfig, getScopeConfigDraft, getEffective } from '@sema-agent/sdk/
 export { probeRegistryHealth, postFeedback } from '@sema-agent/sdk/registry';
 export { REGISTRY_AUTH_PATHS, skillContentAddress } from '@sema-agent/sdk/registry';
 export { requestDeviceCode, pollUntilApproved, refreshTokens, listScopes, switchScope } from '@sema-agent/sdk/registry';
+export { classifyRegistryConflict } from '@sema-agent/sdk/registry';
 export { RegistryApiError, OAuthFlowError } from '@sema-agent/sdk/registry';
-export type { RegistryTokens, TokenProvider, } from '@sema-agent/sdk/registry';
+export type { RegistryConflictClass, RegistryTokens, TokenProvider, } from '@sema-agent/sdk/registry';

package/dist/sdkRegistryTransit.js

@@ -3,4 +3,5 @@ export { getMeConfig, getScopeConfigDraft, getEffective } from '@sema-agent/sdk/
 export { probeRegistryHealth, postFeedback } from '@sema-agent/sdk/registry';
 export { REGISTRY_AUTH_PATHS, skillContentAddress } from '@sema-agent/sdk/registry';
 export { requestDeviceCode, pollUntilApproved, refreshTokens, listScopes, switchScope } from '@sema-agent/sdk/registry';
+export { classifyRegistryConflict } from '@sema-agent/sdk/registry';
 export { RegistryApiError, OAuthFlowError } from '@sema-agent/sdk/registry';

package/dist/sealedKeyCapability.d.ts

@@ -9,9 +9,4 @@ export type SealedKeyReading = {
     publicKey: string;
 };
 export declare function projectSealedKeyCapability(caps: unknown): SealedKeyReading | undefined;
-export declare function noteEngineCapsForSealedKey(baseUrl: string, caps: unknown, opts?: {
-    generation?: number;
-}): void;
 export declare function observedSealedKey(baseUrl?: string | undefined): SealedKeyReading;
-export declare function forgetSealedKeyReading(baseUrl: string | undefined): void;
-export declare function __resetSealedKeyReadingsForTests(): void;

package/dist/sealedKeyCapability.js

@@ -1,18 +1,15 @@
 import { engineWireTarget } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
+import { ownDataField } from './ownKey.js';
 function ownNonEmpty(seg, key) {
-    if (!Object.hasOwn(seg, key))
-        return undefined;
-    const v = seg[key];
+    const v = ownDataField(seg, key);
     return typeof v === 'string' && v.length > 0 ? v : undefined;
 }
 export function projectSealedKeyCapability(caps) {
     try {
         if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
             return undefined;
-        if (!Object.hasOwn(caps, 'sealedKey'))
-            return { kind: 'not_reported' };
-        const seg = caps.sealedKey;
+        const seg = ownDataField(caps, 'sealedKey');
         if (seg === undefined)
             return { kind: 'not_reported' };
         if (seg === null || typeof seg !== 'object' || Array.isArray(seg))
@@ -33,15 +30,6 @@ const reader = createEngineCapReader({
     project: projectSealedKeyCapability,
     makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-export function noteEngineCapsForSealedKey(baseUrl, caps, opts) {
-    reader.note(baseUrl, caps, opts);
-}
 export function observedSealedKey(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-export function forgetSealedKeyReading(baseUrl) {
-    reader.forget(baseUrl);
-}
-export function __resetSealedKeyReadingsForTests() {
-    reader.__resetForTests();
-}

package/dist/seam.js

@@ -102,7 +102,8 @@ const CHROME_ARM_TABLE = {
         required: true,
         duty: '整段替换:①`diverged`(never false)在场 ⇒ 自己拼 thinking stream_delta 上屏的端按 content 重渲该块;' +
             '②`committedPrefixDiverged`(never false)在场 ⇒ 所有端把 `committedUuids` 首行就地换成 content,其余行**删除或清空其推理正文**(宿主按自身转录结构选:有父链/压缩段依赖的转录清空优于删,保行身份;安全目标 = 未脱敏字节零留盘;整段换不切片;`committedUuid` = 末条兼容位;`committedPrefixLen` = 全部行全文长度之和,单位 UTF-16 代码单元);' +
-            '本包在这一形上一个字节都不再交;③三键全缺席 ⇒ 照旧只当对账/定界;④缺席 ≠ 段没结束,按整条流判。',
+            '本包在这一形上一个字节都不再交;③三键全缺席 ⇒ 照旧只当对账/定界;④缺席 ≠ 段没结束,按整条流判;' +
+            '⑤序:该段推理尾部的活体增量一律先于本事件到达,本事件之后不再有同段推理增量。',
     },
     wiring_manifest: {
         required: false,
@@ -150,7 +151,8 @@ const CHROME_ARM_TABLE = {
             '🔴 **单位 = JS 字符串长度(UTF-16 代码单元),不是 UTF-8 字节、也不是几条消息**' +
             '(按 UTF-8 字节截会在非 ASCII 正文上截错位置把凭据留在屏上;按消息丢会连合并在同一条消息里的上一段定稿一起删掉),' +
             '照抄 `已committed正文.slice(0, 长度 - committedPrefixLen) + content`;按**增量拼文**计长、不是 content 上的偏移;④三键全缺席 ⇒ 照旧只当对账/定界,拿 content 再渲一行 = 同一段上屏两遍;⑤`segmentId`(恒在场)= 段身份,与本段已过境的 committed 文本行顶层 `_sema_segment_id` 同值 —— 换掉已提交那截时认行的钥匙是**两把**:行 uuid ∧ 段身份(按字节相等找行会被同后缀的独立行冒充)。' +
-            '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = 前段定稿前缀 + content、其余行空;别整行换首行,提交行可能带上一段定稿),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位。',
+            '🔴 缺席只表示「没报」,绝不等于「段没结束」——要退回自家启发式必须按整条流判、不按单帧判;⑥`committedUuids[]`(0.71.0 起,在场 = 本窗口已提交行按序、`[]` = 零行、整键缺席 = 本包说不出):`committedPrefixDiverged` ⇒ **按 `committedRows[]` 逐行写回正文**(包已算好:首行 = 前段定稿前缀 + content、其余行空;别整行换首行,提交行可能带上一段定稿),端不再自己数窗口里过境的行,也不再对多行段整发放弃;`committedUuid` = 末条兼容位;' +
+            '⑦序:该段尾部的活体增量(`stream_delta`)一律先于本事件到达,本事件之后不再有同段增量(下一条增量属于下一段)。',
     },
 };
 export const CHROME_ARMS = Object.entries(CHROME_ARM_TABLE).map(([kind, d]) => ({ kind, required: d.required, duty: d.duty }));

package/dist/seatContract.d.ts

@@ -1,10 +1,12 @@
 import type { ReasoningEffort } from "./effortWire.js";
 import type { PermissionMode } from "./permissionWireCaps.js";
-import type { LaneProof } from "./seam.js";
+import type { ChromeArmKind, LaneProof } from "./seam.js";
 import type { QuestionAnswer } from "./liveQuestionStore.js";
 import type { ToolApprovalDelegation } from "./hitl/toolApprovalWire.js";
 import type { ApprovalMandateWord } from "./gateVocabulary.js";
 import type { ModelApiWord } from "./model/providerPresets.js";
+import type { LiveModelCatalog } from "./liveModelCatalog.js";
+import { type RewindMode } from "./rewindWireCaps.js";
 export interface SeatValidationFailure {
     reason: string;
     field?: string;
@@ -38,6 +40,7 @@ export interface LocalSessionRecord {
         text: string;
     }>;
     parked?: boolean;
+    pinned?: boolean;
 }
 export declare const TOOL_PERMISSION_REQUEST_ID_DOMAINS: readonly ["live:", "durable:", "question:", "elicit:", "plan:"];
 export type ToolPermissionRequestIdDomain = (typeof TOOL_PERMISSION_REQUEST_ID_DOMAINS)[number];
@@ -65,12 +68,13 @@ export interface ToolPermissionRequest {
     ruleOffersAbsence?: string;
     askClass?: string;
     classes?: readonly string[];
+    rememberRefused?: true;
 }
 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"];
-export type ChromeEventKind = (typeof CHROME_EVENT_KIND_TUPLE)[number];
+declare const CHROME_EVENT_KIND_TUPLE: readonly ["panel_task", "notification_terminal", "prompt_suggestions", "subagent_lifecycle", "text_segment_end", "thinking_segment_end"];
+export type ChromeEventKind = Extract<ChromeArmKind, (typeof CHROME_EVENT_KIND_TUPLE)[number]>;
 export declare const CHROME_EVENT_KINDS: readonly ChromeEventKind[];
 export interface SeatChromeEnvelopeBase {
     kind: ChromeEventKind;
@@ -97,13 +101,17 @@ export interface LocalSessionEvent {
     hasPreClearSession?: boolean;
     requestId?: string;
     outcome?: string;
+    parked?: true;
     chrome?: SeatChromeEnvelope;
 }
 export declare const HITL_RESOLUTION_OUTCOMES: readonly string[];
-export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder"];
+export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind", "recents", "patchSession"];
 export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
 export interface SeatCapabilitiesState {
     pickFolder?: boolean;
+    rewind?: boolean;
+    recents?: boolean;
+    patchSession?: boolean;
 }
 export type SeatCapabilityReading = {
     readonly kind: "reported";
@@ -116,6 +124,28 @@ export type SeatCapabilityReading = {
 export declare function seatCapability(state: unknown, name: SeatCapabilityName): SeatCapabilityReading;
 export declare function watchSeatCapability(store: EipcStoreClient<SeatCapabilitiesState> | undefined, name: SeatCapabilityName, onReading: (reading: SeatCapabilityReading) => void): () => void;
 export declare function seatCapabilityUnavailableDetail(name: SeatCapabilityName, reading: SeatCapabilityReading): string | undefined;
+export interface RecentFolderSession {
+    readonly cwd?: string;
+    readonly lastActivityAt?: string;
+    readonly createdAt?: string;
+}
+export interface RecentFoldersInput {
+    readonly sessions?: readonly RecentFolderSession[] | null | undefined;
+    readonly registered?: readonly RecentFolderRow[] | null | undefined;
+}
+export declare function recentFoldersOf(input: RecentFoldersInput): string[] | null;
+export type RecentFoldersHostReading = "listed" | "skipped" | "unreadable";
+export interface RecentFoldersReading {
+    readonly folders: string[] | null;
+    readonly host: RecentFoldersHostReading;
+    readonly unreadableRows: number;
+}
+export interface ReadRecentFoldersInput {
+    readonly capability: SeatCapabilityReading;
+    readonly list: () => Promise<RecentFoldersResult>;
+    readonly sessions?: readonly RecentFolderSession[] | null | undefined;
+}
+export declare function readRecentFolders(input: ReadRecentFoldersInput): Promise<RecentFoldersReading>;
 export interface StartSessionOptions {
     model?: string;
     title?: string;
@@ -130,6 +160,28 @@ export interface SeatTurnSettings {
     ultracode?: boolean;
 }
 export declare const SEAT_TURN_SETTINGS_KEYS: readonly ["ultracode"];
+export declare const SEAT_TURN_SETTINGS_ORIGINS: Readonly<{
+    ultracode: Readonly<{
+        carriedBy: "renderer";
+    }>;
+    webSearch: Readonly<{
+        hostSupplied: "联网检索的每请求配置来自宿主的设置源(可能带检索服务的凭据与私网地址);渲染端没有设置文件,也不该持有凭据";
+    }>;
+    hooks: Readonly<{
+        hostSupplied: "hooks 表来自宿主的设置文件(宿主经设置端口与 hooksForWire 投影);渲染端没有设置文件、也不执行本机 hook";
+    }>;
+    resolved: Readonly<{
+        hostSupplied: "设置解析器的生效快照(hooks / env / model / 已解析权限)由宿主跑解析器得出;渲染端没有设置源可解析";
+    }>;
+    outputStyle: Readonly<{
+        hostSupplied: "输出风格正文由宿主的兜底层随请求带(风格文件在宿主);渲染端只选名字,不持正文";
+    }>;
+}>;
+export interface SeatRewindIntent {
+    mode: RewindMode;
+    targetMessageUuid: string;
+}
+export declare const SEAT_REWIND_INTENT_KEYS: readonly ["mode", "targetMessageUuid"];
 export interface SendMessageRequest {
     sessionId: string;
     text: string;
@@ -145,6 +197,7 @@ export interface SendMessageRequest {
         max?: number;
     };
     settings?: SeatTurnSettings;
+    rewind?: SeatRewindIntent;
     scenario?: string;
 }
 export interface AttachmentUploadRequest {
@@ -156,6 +209,12 @@ export declare const ATTACHMENT_UPLOAD_REQUEST_KEYS: readonly ["name", "mimeType
 export interface SessionScopedRequest {
     sessionId: string;
 }
+export interface SessionRowPatchRequest {
+    sessionId: string;
+    title?: string | null;
+    pinned?: boolean;
+}
+export declare const SESSION_ROW_PATCH_REQUEST_KEYS: readonly ["sessionId", "title", "pinned"];
 export interface AttachmentUploadReceipt {
     id: string;
     name: string;
@@ -163,17 +222,6 @@ export interface AttachmentUploadReceipt {
     sha256: string;
     sizeBytes: number;
 }
-export interface SeatModelInfo {
-    id: string;
-    name?: string;
-    provider?: string;
-    contextWindow?: number;
-    maxOutputTokens?: number;
-}
-export interface SeatModelCatalog {
-    models: SeatModelInfo[];
-    defaultId?: string;
-}
 export interface SendMessageAck {
     sessionId: string;
     userMessageUuid: string;
@@ -193,7 +241,6 @@ export interface EipcStoreClient<T> {
     onStateChange(cb: (state: T) => void): () => void;
 }
 export interface SettingsState {
-    defaultModel: string | null;
     engineVersion?: string;
     dataRoot?: string;
 }
@@ -228,6 +275,13 @@ export interface SessionsState {
 export interface FocusedSessionState {
     sessionId: string | null;
 }
+export interface RecentFolderRow {
+    path: string;
+    lastUsedAt?: string;
+}
+export interface RecentFoldersResult {
+    folders: RecentFolderRow[];
+}
 export interface LocalSessionsApi {
     start(opts?: StartSessionOptions): Promise<LocalSessionRecord>;
     sendMessage(req: SendMessageRequest): Promise<SendMessageAck>;
@@ -242,9 +296,12 @@ export interface LocalSessionsApi {
     getTranscript(sessionId: string): Promise<GetTranscriptResult>;
     searchSessions(query: string): Promise<SessionSearchEnvelope>;
     uploadAttachment(req: AttachmentUploadRequest): Promise<AttachmentUploadReceipt>;
-    listModels(): Promise<SeatModelCatalog>;
+    listModels(): Promise<LiveModelCatalog>;
     applyModelConfig(req: ApplyModelConfigRequest): Promise<ApplyModelConfigResult>;
     pickFolder(): Promise<string | null>;
+    listRecentFolders(): Promise<RecentFoldersResult>;
+    noteRecentFolder(path: string): Promise<OkAck>;
+    patchSession(req: SessionRowPatchRequest): Promise<LocalSessionRecord>;
     onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
     onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
     sessionsStateStore: EipcStoreClient<SessionsState>;
@@ -276,16 +333,19 @@ export interface ApplyModelConfigResult {
     reason?: string;
     requiresRestart: boolean;
 }
-export declare function isSeatModelCatalog(v: unknown): v is SeatModelCatalog;
+export declare function checkSendMessageRequest(v: unknown): SeatValidation;
+export declare function isSendMessageRequest(v: unknown): v is SendMessageRequest;
+export declare const checkSessionRowPatchRequest: (v: unknown) => SeatValidation;
+export declare function isSessionRowPatchRequest(v: unknown): v is SessionRowPatchRequest;
 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", "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", "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", "chrome"];
-export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes"];
-export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
-export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario"];
+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 TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes", "rememberRefused"];
+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"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
     readonly sessionId: {
         readonly seatOnly: "座位会话句柄(渲染端持有的本地 id);引擎会话 id 由座位记录的 `engineSessionId` 承载 —— 与引擎请求体上的同名位**同名不同义**,绝不直传";
@@ -323,19 +383,23 @@ export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
     readonly scenario: {
         readonly taskRequestKey: "scenario";
     };
+    readonly rewind: {
+        readonly projectedBy: "rewindSpecForMode";
+        readonly taskRequestKeys: readonly ["resumeAt", "resumeAtMode", "restoreFiles", "rewindFilesTo"];
+    };
 };
 export declare const TOOL_PERMISSION_DECISION_KEYS: readonly ["sessionId", "requestId", "decision", "answer", "updatedInput", "remember"];
 export declare const START_SESSION_OPTION_KEYS: readonly ["model", "title", "cwd", "excludeTools"];
 export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     readonly LocalSessionRecord: {
         readonly guard: "isLocalSessionRecord";
-        readonly check: (s: unknown) => SeatValidation;
-        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"];
         readonly unchecked: readonly [];
     };
     readonly ToolPermissionRequest: {
         readonly guard: "isToolPermissionRequest";
-        readonly check: (r: unknown) => SeatValidation;
+        readonly check: (v: unknown) => SeatValidation;
         readonly validated: readonly ["requestId", "sessionId", "toolName", "toolCallId", "message", "toctouBinding", "createdAtMs"];
         readonly unchecked: readonly [{
             readonly key: "input";
@@ -361,6 +425,9 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         }, {
             readonly key: "classes";
             readonly why: "与 askClass 同一对(CC-284),同在同缺、同一只成对窄读(非空、每员非空串、无重复、首员等于 askClass;开集、原样顺序);座位门不设第二判官,理由同 askClass。";
+        }, {
+            readonly key: "rememberRefused";
+            readonly why: "展示增强位(CC-642),权威窄读在卡口两条腿与过境口 toolPermissionRequestAskBits(同一只 readApprovalRememberRefused:自有键 ∧ 严格 true 才上座,永不铸 false);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 读,其余(缺席 / 坏形)一律当缺席 ⇒ 照旧渲「本会话放行」。缺席 = 服务端没说(记得住或老服务端),不是 false。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
         }, {
             readonly key: "ruleOffersAbsence";
             readonly why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
@@ -369,7 +436,7 @@ 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", "chrome"];
+        readonly validated: readonly ["type", "sessionId", "messages", "error", "errorCategory", "code", "request", "data", "sources", "permissionMode", "session", "userMessageUuid", "hasPreClearSession", "requestId", "outcome", "parked", "chrome"];
         readonly unchecked: readonly [{
             readonly key: "message";
             readonly why: "transcript 面直通位(CC fQe 逐字姿态:SDKMessage 体不做 schema 校验)—— 校它 = 引擎加一种消息体的那天整条转录被门吃掉。";
@@ -381,10 +448,24 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly validated: readonly ["id", "name", "mime", "sha256", "sizeBytes"];
         readonly unchecked: readonly [];
     };
-    readonly SeatModelCatalog: {
-        readonly guard: "isSeatModelCatalog";
+    readonly LiveModelCatalog: {
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["models", "default", "defaultModel"];
+        readonly unchecked: readonly [{
+            readonly key: "droppedEntries";
+            readonly why: "诊断面(哪些目录条目没被引擎收下),三态读法归 droppedModelEntriesOf(含坏形 malformed);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
+        }];
+    };
+    readonly SendMessageRequest: {
+        readonly guard: "isSendMessageRequest";
+        readonly check: typeof checkSendMessageRequest;
+        readonly validated: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario", "rewind"];
+        readonly unchecked: readonly [];
+    };
+    readonly SessionRowPatchRequest: {
+        readonly guard: "isSessionRowPatchRequest";
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["models", "defaultId"];
+        readonly validated: readonly ["sessionId", "title", "pinned"];
         readonly unchecked: readonly [];
     };
     readonly ApplyModelConfigResult: {
@@ -435,17 +516,27 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
     readonly SettingsState: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["defaultModel", "engineVersion", "dataRoot"];
+        readonly validated: readonly ["engineVersion", "dataRoot"];
         readonly unchecked: readonly [];
     };
     readonly SeatCapabilitiesState: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["pickFolder"];
+        readonly validated: readonly ["pickFolder", "rewind", "recents", "patchSession"];
+        readonly unchecked: readonly [];
+    };
+    readonly RecentFoldersResult: {
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["folders"];
+        readonly unchecked: readonly [];
+    };
+    readonly RecentFolderRow: {
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["path", "lastUsedAt"];
         readonly unchecked: readonly [];
     };
-    readonly SeatModelInfo: {
+    readonly SeatRewindIntent: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["id", "name", "provider", "contextWindow", "maxOutputTokens"];
+        readonly validated: readonly ["mode", "targetMessageUuid"];
         readonly unchecked: readonly [];
     };
     readonly SessionSearchResult: {