@sema-agent/client-core 0.95.0 → 0.96.0

package/dist/rewindArchiveReading.js

@@ -0,0 +1,56 @@
+import { createEngineCapReader } from './engineCapReader.js';
+import { ownDataField } from './ownKey.js';
+const CAPS_KEYS = {
+    conversationAnchor: 'resumeAt',
+    forkRestore: 'rewindFiles',
+    codeOnly: 'rewindFilesTo',
+    restoreFilesEpoch: 'restoreFiles',
+};
+const _capsKeyPin = true;
+void _capsKeyPin;
+function bitOf(caps, key) {
+    const v = ownDataField(caps, key);
+    if (v === undefined)
+        return 'not_reported';
+    if (v === true)
+        return 'on';
+    if (v === false)
+        return 'off';
+    return 'malformed';
+}
+export function projectRewindArchiveCapability(caps) {
+    try {
+        if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
+            return undefined;
+        return {
+            kind: 'present',
+            conversationAnchor: bitOf(caps, CAPS_KEYS.conversationAnchor),
+            forkRestore: bitOf(caps, CAPS_KEYS.forkRestore),
+            codeOnly: bitOf(caps, CAPS_KEYS.codeOnly),
+            restoreFilesEpoch: bitOf(caps, CAPS_KEYS.restoreFilesEpoch),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+const reader = createEngineCapReader({
+    name: 'rewindArchive',
+    project: projectRewindArchiveCapability,
+    makeUnobserved: () => ({ kind: 'unobserved' }),
+});
+export function rewindArchiveReadingAt(baseUrl) {
+    return reader.observed(baseUrl);
+}
+export function resetRewindArchiveReader() {
+    reader.__resetForTests();
+}
+export function rewindConversationAvailability(reading) {
+    if (reading.kind !== 'present')
+        return 'unknown';
+    if (reading.conversationAnchor === 'on')
+        return 'available';
+    if (reading.conversationAnchor === 'off')
+        return 'unavailable';
+    return 'unknown';
+}

package/dist/ruleCompileVerdict.d.ts

@@ -1,2 +1,10 @@
-export type RuleCompileVerdict = 'compiles' | 'refused' | 'unknown';
+export type RuleCompileVerdict = {
+    readonly kind: 'compiles';
+} | {
+    readonly kind: 'refused';
+    readonly code?: string;
+    readonly message?: string;
+} | {
+    readonly kind: 'unknown';
+};
 export declare function ruleCompileVerdict(rule: string, behavior: 'deny' | 'ask'): RuleCompileVerdict;

package/dist/ruleCompileVerdict.js

@@ -1,13 +1,38 @@
 import { validatePermissionRules } from './coreValuePorts.js';
 const RULE_COMPILE_ROOT = '/';
+function issueText(issue, key) {
+    try {
+        if (typeof issue !== 'object' || issue === null || !Object.hasOwn(issue, key))
+            return undefined;
+        const v = issue[key];
+        return typeof v === 'string' && v.length > 0 ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function firstIssue(issues) {
+    try {
+        return issues[0];
+    }
+    catch {
+        return undefined;
+    }
+}
 export function ruleCompileVerdict(rule, behavior) {
+    let issues;
     try {
-        const issues = validatePermissionRules([{ rule, behavior }], { pathBases: { root: RULE_COMPILE_ROOT } });
+        issues = validatePermissionRules([{ rule, behavior }], { pathBases: { root: RULE_COMPILE_ROOT } });
         if (!Array.isArray(issues))
-            return 'unknown';
-        return issues.length === 0 ? 'compiles' : 'refused';
+            return { kind: 'unknown' };
+        if (issues.length === 0)
+            return { kind: 'compiles' };
     }
     catch {
-        return 'unknown';
+        return { kind: 'unknown' };
     }
+    const issue = firstIssue(issues);
+    const code = issueText(issue, 'code');
+    const message = issueText(issue, 'message');
+    return { kind: 'refused', ...(code !== undefined ? { code } : {}), ...(message !== undefined ? { message } : {}) };
 }

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,3 +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 {};

package/dist/runTerminal.js

@@ -1,5 +1,7 @@
 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) {
@@ -41,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;
@@ -71,6 +108,16 @@ function blockedDetailOf(cause) {
     }
 }
 export function readRunTerminal(result) {
+    if (typeof result !== 'object' || result === null || Array.isArray(result))
+        return null;
+    const view = doneResultView(result);
+    if (view.replay) {
+        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;
@@ -87,8 +134,10 @@ export function readRunTerminal(result) {
             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);
@@ -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;
 }

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/sealedKeyCapability.d.ts

@@ -9,8 +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 __resetSealedKeyReadingsForTests(): void;

package/dist/sealedKeyCapability.js

@@ -30,12 +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 __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,6 +1,6 @@
 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";
@@ -40,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];
@@ -67,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;
@@ -103,11 +105,13 @@ export interface LocalSessionEvent {
     chrome?: SeatChromeEnvelope;
 }
 export declare const HITL_RESOLUTION_OUTCOMES: readonly string[];
-export declare const SEAT_CAPABILITY_NAMES: readonly ["pickFolder", "rewind"];
+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";
@@ -120,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;
@@ -183,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;
@@ -209,7 +241,6 @@ export interface EipcStoreClient<T> {
     onStateChange(cb: (state: T) => void): () => void;
 }
 export interface SettingsState {
-    defaultModel: string | null;
     engineVersion?: string;
     dataRoot?: string;
 }
@@ -244,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>;
@@ -261,6 +299,9 @@ export interface LocalSessionsApi {
     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>;
@@ -294,14 +335,16 @@ export interface ApplyModelConfigResult {
 }
 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", "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"];
-export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
+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: {
@@ -351,7 +394,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"];
+        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"];
         readonly unchecked: readonly [];
     };
     readonly ToolPermissionRequest: {
@@ -382,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。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
@@ -416,6 +462,12 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         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 ["sessionId", "title", "pinned"];
+        readonly unchecked: readonly [];
+    };
     readonly ApplyModelConfigResult: {
         readonly check: (v: unknown) => SeatValidation;
         readonly validated: readonly ["ok", "requiresRestart", "reason"];
@@ -464,12 +516,22 @@ 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", "rewind"];
+        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 SeatRewindIntent: {