@sema-agent/client-core 0.95.0 → 0.97.0

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[];
+    sessionRow?: 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", "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"];
 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: "sessionRow";
+            readonly why: "放宽方向的展示位(CC-699),判官在过境口 toolPermissionRequestAskBits(card, requestId):卡上「本会话放行」判官 standingRowsOf 的会话行同一前提 ∧ 本请求 requestId 的域带得走(live: / durable:),严格 true 才上座、永不铸 false;座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 才渲「本会话放行」,其余(缺席 / 坏形)一律不渲 —— 缺席是闭合失败,不是「没说就照渲」。不经过境口自铸座位请求的宿主拿不到这一位,座位卡就不给那一档。";
         }, {
             readonly key: "ruleOffersAbsence";
             readonly why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
@@ -408,6 +454,9 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly unchecked: readonly [{
             readonly key: "droppedEntries";
             readonly why: "诊断面(哪些目录条目没被引擎收下),三态读法归 droppedModelEntriesOf(含坏形 malformed);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
+        }, {
+            readonly key: "candidateRejected";
+            readonly why: "诊断面(0.97.0 CC-715;当前配置是候选被整拒后回落的那一份),三态读法归 modelCandidateRejectedOf(含坏形 unreadable);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。";
         }];
     };
     readonly SendMessageRequest: {
@@ -416,6 +465,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 +519,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: {

package/dist/seatContract.js

@@ -1,7 +1,7 @@
 import { PERMISSION_MODE_WORDS, REASONING_EFFORT_WORDS } from "./taskRequestWords.js";
 import { liveDefaultModelCopy, liveModelRowCopy } from "./model/liveCatalogShape.js";
 import { REWIND_MODES } from "./rewindWireCaps.js";
-import { ownDataField, ownDataRefusalKeyOf, ownSendableField } from "./ownKey.js";
+import { guardedRead, ownDataField, ownDataRefusalKeyOf, ownSendableField, readOwnDataValue } from "./ownKey.js";
 const bad = (reason, field) => field === undefined ? { reason } : { reason, field };
 const nested = (prefix, verdict) => {
     const path = verdict.field === undefined
@@ -13,8 +13,15 @@ const nested = (prefix, verdict) => {
     return bad(reason, path);
 };
 const isObject = (v) => typeof v === "object" && v !== null;
+const isPlainRecord = (v) => {
+    if (!isObject(v) || Array.isArray(v))
+        return false;
+    const proto = Object.getPrototypeOf(v);
+    return proto === Object.prototype || proto === null;
+};
 const isAbsent = (v) => typeof v === "undefined";
 const optionalString = (v) => isAbsent(v) || typeof v === "string";
+const isFolderPath = (v) => typeof v === "string" && v.length > 0;
 const inTuple = (tuple, v) => tuple.includes(v);
 const own = (o, k) => ownSendableField(o, k);
 const ownItems = (a) => {
@@ -26,6 +33,16 @@ const ownItems = (a) => {
         out.push(own(a, String(i)));
     return out;
 };
+const sendableKeysOf = (v) => {
+    const keys = [];
+    for (const k of Reflect.ownKeys(v)) {
+        if (typeof k !== "string")
+            continue;
+        own(v, k);
+        keys.push(k);
+    }
+    return keys;
+};
 const firstAccessorPath = (root) => {
     const seen = new Set();
     const stack = [[root, ""]];
@@ -112,14 +129,16 @@ const SEAT_EVENT_TYPE_TUPLE = [
     "error",
     "tool_permission_resolved",
 ];
-export const SEAT_EVENT_TYPES = SEAT_EVENT_TYPE_TUPLE;
+export const SEAT_EVENT_TYPES = Object.freeze(SEAT_EVENT_TYPE_TUPLE);
 const CHROME_EVENT_KIND_TUPLE = [
     "panel_task",
     "notification_terminal",
     "prompt_suggestions",
     "subagent_lifecycle",
+    "text_segment_end",
+    "thinking_segment_end",
 ];
-export const CHROME_EVENT_KINDS = CHROME_EVENT_KIND_TUPLE;
+export const CHROME_EVENT_KINDS = Object.freeze(CHROME_EVENT_KIND_TUPLE);
 const LANE_PROOF_LANE_TUPLE = ["main", "subagent", "workflow"];
 export const SEAT_CHROME_ENVELOPE_KEYS = ["kind", "laneProof"];
 export const HITL_RESOLUTION_OUTCOMES = [
@@ -132,7 +151,7 @@ export const HITL_RESOLUTION_OUTCOMES = [
     "decline",
     "cancel",
 ];
-export const SEAT_CAPABILITY_NAMES = Object.freeze(["pickFolder", "rewind"]);
+export const SEAT_CAPABILITY_NAMES = Object.freeze(["pickFolder", "rewind", "recents", "patchSession"]);
 const notReported = () => Object.freeze({ kind: "not_reported" });
 const malformedReading = () => Object.freeze({ kind: "malformed" });
 const reported = (available) => Object.freeze({ kind: "reported", available });
@@ -206,6 +225,7 @@ export function watchSeatCapability(store, name, onReading) {
 const SEAT_CAPABILITY_PHRASES = Object.freeze({
     pickFolder: Object.freeze({ action: "Opening a folder", ability: "show a folder picker", support: "folder picker support" }),
     rewind: Object.freeze({ action: "Rewinding to an earlier message", ability: "rewind this session", support: "rewind support" }),
+    recents: Object.freeze({ action: "Remembering recent folders", ability: "remember recent folders", support: "recent folders support" }), patchSession: Object.freeze({ action: "Renaming or pinning a conversation", ability: "rename or pin conversations", support: "rename and pin support" }),
 });
 export function seatCapabilityUnavailableDetail(name, reading) {
     const phrase = Object.hasOwn(SEAT_CAPABILITY_PHRASES, name)
@@ -228,6 +248,96 @@ export function seatCapabilityUnavailableDetail(name, reading) {
         return `${phrase.action} isn't available: this app hasn't reported ${phrase.support}.`;
     return `${phrase.action} isn't available: this app's support report couldn't be read.`;
 }
+const NO_TIME = Number.NEGATIVE_INFINITY;
+const stampMs = (v) => {
+    if (typeof v !== "string")
+        return NO_TIME;
+    const t = Date.parse(v);
+    return Number.isFinite(t) ? t : NO_TIME;
+};
+const softField = (o, key) => typeof o === "object" && o !== null ? guardedRead(() => readOwnDataValue(o, key)) : undefined;
+const softItems = (a) => {
+    const isArray = guardedRead(() => Array.isArray(a));
+    if (isArray !== true)
+        return undefined;
+    const n = softField(a, "length");
+    if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 0)
+        return undefined;
+    const out = [];
+    for (let i = 0; i < n; i += 1)
+        out.push(softField(a, String(i)));
+    return out;
+};
+export function recentFoldersOf(input) {
+    const sessions = softItems(softField(input, "sessions"));
+    const registered = softItems(softField(input, "registered"));
+    if (sessions === undefined && registered === undefined)
+        return null;
+    const byPath = new Map();
+    let order = 0;
+    const place = (path, at) => {
+        const cur = byPath.get(path);
+        order += 1;
+        if (cur === undefined)
+            byPath.set(path, { at, order });
+        else if (at > cur.at)
+            cur.at = at;
+    };
+    for (const row of registered ?? []) {
+        const path = softField(row, "path");
+        if (isFolderPath(path))
+            place(path, stampMs(softField(row, "lastUsedAt")));
+    }
+    for (const rec of sessions ?? []) {
+        const cwd = softField(rec, "cwd");
+        if (!isFolderPath(cwd))
+            continue;
+        const active = stampMs(softField(rec, "lastActivityAt"));
+        place(cwd, active !== NO_TIME ? active : stampMs(softField(rec, "createdAt")));
+    }
+    return [...byPath.entries()]
+        .sort(([, x], [, y]) => (x.at === y.at ? x.order - y.order : x.at > y.at ? -1 : 1))
+        .map(([path]) => path);
+}
+export async function readRecentFolders(input) {
+    const capability = guardedRead(() => input.capability);
+    const list = guardedRead(() => input.list);
+    const sessions = guardedRead(() => input.sessions);
+    let registered;
+    let host = "skipped";
+    let unreadableRows = 0;
+    if (capability !== undefined && seatCapabilityUnavailableDetail("recents", capability) === undefined) {
+        try {
+            const items = softItems(softField(await list(), "folders"));
+            if (items === undefined) {
+                host = "unreadable";
+            }
+            else {
+                const rows = [];
+                for (const item of items) {
+                    const path = softField(item, "path");
+                    if (!isFolderPath(path)) {
+                        unreadableRows += 1;
+                        continue;
+                    }
+                    const lastUsedAt = softField(item, "lastUsedAt");
+                    rows.push(typeof lastUsedAt === "string" ? { path, lastUsedAt } : { path });
+                }
+                if (items.length > 0 && rows.length === 0) {
+                    host = "unreadable";
+                }
+                else {
+                    registered = rows;
+                    host = "listed";
+                }
+            }
+        }
+        catch {
+            host = "unreadable";
+        }
+    }
+    return Object.freeze({ folders: recentFoldersOf({ sessions, registered }), host, unreadableRows });
+}
 export const PERMISSION_MODE_INTENTS = [...PERMISSION_MODE_WORDS];
 export const ATTACHMENT_IDS_PER_TASK_CAP = 16;
 export const SEAT_REASONING_EFFORTS = [...REASONING_EFFORT_WORDS];
@@ -241,6 +351,7 @@ export const SEAT_TURN_SETTINGS_ORIGINS = Object.freeze({
 });
 export const SEAT_REWIND_INTENT_KEYS = ["mode", "targetMessageUuid"];
 export const ATTACHMENT_UPLOAD_REQUEST_KEYS = ["name", "mimeType", "bytes"];
+export const SESSION_ROW_PATCH_REQUEST_KEYS = Object.freeze(["sessionId", "title", "pinned"]);
 export const SESSION_SEARCH_RESULT_KEYS = ["sessionId", "title", "matches"];
 export const GET_TRANSCRIPT_RESULT_KEYS = ["sessionId", "messages"];
 const checkLocalSessionRecord = seatCheck((s) => {
@@ -255,7 +366,7 @@ const checkLocalSessionRecord = seatCheck((s) => {
     if (!optionalString(own(s, "title")))
         return bad("title must be a string when present", "title");
     const cwd = own(s, "cwd");
-    if (!isAbsent(cwd) && (typeof cwd !== "string" || cwd.length === 0)) {
+    if (!isAbsent(cwd) && !isFolderPath(cwd)) {
         return bad("cwd must be a non-empty path string when present (absent = no folder chosen)", "cwd");
     }
     if (typeof own(s, "isRunning") !== "boolean")
@@ -274,6 +385,10 @@ const checkLocalSessionRecord = seatCheck((s) => {
     if (!isAbsent(parked) && typeof parked !== "boolean") {
         return bad("parked must be a boolean when present", "parked");
     }
+    const pinned = own(s, "pinned");
+    if (!isAbsent(pinned) && typeof pinned !== "boolean") {
+        return bad("pinned must be a boolean when present (absent = not pinned or unknown)", "pinned");
+    }
     return true;
 });
 export function isLocalSessionRecord(s) {
@@ -487,9 +602,9 @@ const checkLiveModelCatalog = seatCheck((v) => {
     return true;
 });
 const checkSeatRewindIntent = seatCheck((v) => {
-    if (!isObject(v) || Array.isArray(v))
-        return bad("rewind must be an object {mode, targetMessageUuid}");
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("rewind must be a plain object {mode, targetMessageUuid}");
+    for (const k of sendableKeysOf(v)) {
         if (!inTuple(SEAT_REWIND_INTENT_KEYS, k))
             return bad(`unknown key (closed shape: ${SEAT_REWIND_INTENT_KEYS.join(", ")})`, k);
     }
@@ -503,9 +618,9 @@ const checkSeatRewindIntent = seatCheck((v) => {
     return true;
 });
 const checkSeatTurnSettings = seatCheck((v) => {
-    if (!isObject(v) || Array.isArray(v))
-        return bad("settings must be an object");
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("settings must be a plain object");
+    for (const k of sendableKeysOf(v)) {
         if (!inTuple(SEAT_TURN_SETTINGS_KEYS, k)) {
             const host = Object.hasOwn(SEAT_TURN_SETTINGS_ORIGINS, k);
             return bad(host ? "this settings key is supplied by the host, not carried by the seat" : `unknown key (closed shape: ${SEAT_TURN_SETTINGS_KEYS.join(", ")})`, k);
@@ -519,9 +634,9 @@ const checkSeatTurnSettings = seatCheck((v) => {
 const checkRetainSubagentSessions = seatCheck((v) => {
     if (typeof v === "boolean")
         return true;
-    if (!isObject(v) || Array.isArray(v))
-        return bad("retainSubagentSessions must be a boolean or {ttlMs?, max?}");
-    for (const k of Object.keys(v)) {
+    if (!isPlainRecord(v))
+        return bad("retainSubagentSessions must be a boolean or a plain object {ttlMs?, max?}");
+    for (const k of sendableKeysOf(v)) {
         if (k !== "ttlMs" && k !== "max")
             return bad("unknown key (closed shape: ttlMs, max)", k);
         const n = own(v, k);
@@ -532,13 +647,13 @@ const checkRetainSubagentSessions = seatCheck((v) => {
 });
 export function checkSendMessageRequest(v) {
     try {
-        if (!isObject(v) || Array.isArray(v))
-            return bad("sendMessage request is not an object");
+        if (!isPlainRecord(v))
+            return bad("sendMessage request is not a plain object");
         const at = firstAccessorPath(v);
         if (at !== undefined)
             return bad(NOT_PLAIN_DATA, at);
-        const body = {};
-        for (const k of Object.keys(v)) {
+        const body = Object.create(null);
+        for (const k of sendableKeysOf(v)) {
             if (!inTuple(SEND_MESSAGE_REQUEST_KEYS, k))
                 return bad(`unknown key (closed shape: ${SEND_MESSAGE_REQUEST_KEYS.join(", ")})`, k);
             body[k] = own(v, k);
@@ -597,6 +712,30 @@ export function checkSendMessageRequest(v) {
 export function isSendMessageRequest(v) {
     return checkSendMessageRequest(v) === true;
 }
+export const checkSessionRowPatchRequest = seatCheck((v) => {
+    if (!isPlainRecord(v))
+        return bad("patchSession request is not a plain object");
+    const body = Object.create(null);
+    for (const k of sendableKeysOf(v)) {
+        if (!inTuple(SESSION_ROW_PATCH_REQUEST_KEYS, k))
+            return bad(`unknown key (closed shape: ${SESSION_ROW_PATCH_REQUEST_KEYS.join(", ")})`, k);
+        body[k] = own(v, k);
+    }
+    if (typeof body.sessionId !== "string" || body.sessionId.length === 0)
+        return bad("sessionId must be a non-empty string", "sessionId");
+    const { title, pinned } = body;
+    if (!isAbsent(title) && title !== null && (typeof title !== "string" || title.length === 0)) {
+        return bad('title must be a non-empty string, or null to clear it back to the automatic title (an empty string is not a way to clear)', "title");
+    }
+    if (!isAbsent(pinned) && typeof pinned !== "boolean")
+        return bad("pinned must be a boolean when present", "pinned");
+    if (isAbsent(title) && isAbsent(pinned))
+        return bad("nothing to change: carry at least one of title / pinned");
+    return true;
+});
+export function isSessionRowPatchRequest(v) {
+    return checkSessionRowPatchRequest(v) === true;
+}
 const checkSendMessageAck = seatCheck((v) => {
     if (!isObject(v))
         return bad("sendMessage ack is not an object");
@@ -678,11 +817,10 @@ const checkFocusedSessionState = seatCheck((v) => {
     return true;
 });
 const checkSettingsState = seatCheck((v) => {
-    if (!isObject(v))
-        return bad("settings state is not an object");
-    const defaultModel = own(v, "defaultModel");
-    if (defaultModel !== null && typeof defaultModel !== "string") {
-        return bad("defaultModel must be a string or null", "defaultModel");
+    if (!isPlainRecord(v))
+        return bad("settings state is not a plain object");
+    if (Object.hasOwn(v, "defaultModel")) {
+        return bad("defaultModel is not carried in settings state: read the deployment default model from the model catalog (liveDefaultModelOf over the listModels() result)", "defaultModel");
     }
     if (!optionalString(own(v, "engineVersion")))
         return bad("engineVersion must be a string when present", "engineVersion");
@@ -690,9 +828,32 @@ const checkSettingsState = seatCheck((v) => {
         return bad("dataRoot must be a string when present", "dataRoot");
     return true;
 });
-const checkPickFolderResult = (v) => v === null || (typeof v === "string" && v.length > 0)
+const checkPickFolderResult = (v) => v === null || isFolderPath(v)
     ? true
     : bad("pickFolder result must be null (cancelled) or a non-empty path string");
+const checkRecentFolderRow = seatCheck((v) => {
+    if (!isPlainRecord(v))
+        return bad("recent folder row is not a plain object");
+    if (!isFolderPath(own(v, "path")))
+        return bad("path must be a non-empty path string", "path");
+    if (!optionalString(own(v, "lastUsedAt")))
+        return bad("lastUsedAt must be a string when present", "lastUsedAt");
+    return true;
+});
+const checkRecentFoldersResult = seatCheck((v) => {
+    if (!isPlainRecord(v))
+        return bad("recent folders result is not a plain object");
+    const folders = own(v, "folders");
+    if (!Array.isArray(folders))
+        return bad("folders must be an array", "folders");
+    const rows = ownItems(folders);
+    for (let i = 0; i < rows.length; i += 1) {
+        const verdict = checkRecentFolderRow(rows[i]);
+        if (verdict !== true)
+            return nested(`folders[${i}]`, verdict);
+    }
+    return true;
+});
 const checkSeatCapabilitiesState = seatCheck((v) => {
     if (!isObject(v) || Array.isArray(v))
         return bad("seat capabilities state is not an object");
@@ -730,6 +891,8 @@ export const LOCAL_SESSIONS_SPEC = {
         listModels: { kind: "invoke", check: checkLiveModelCatalog },
         applyModelConfig: { kind: "invoke", check: checkApplyModelConfigResult },
         pickFolder: { kind: "invoke", check: checkPickFolderResult },
+        listRecentFolders: { kind: "invoke", check: checkRecentFoldersResult },
+        noteRecentFolder: { kind: "invoke", check: checkOkAck }, patchSession: { kind: "invoke", check: checkLocalSessionRecord },
         onEvent: { kind: "event", check: checkLocalSessionEvent },
         onToolPermissionRequest: { kind: "event", check: checkToolPermissionRequest },
     },
@@ -757,6 +920,8 @@ export const SEAT_METHOD_NAMES = [
     "listModels",
     "applyModelConfig",
     "pickFolder",
+    "listRecentFolders",
+    "noteRecentFolder", "patchSession",
     "onEvent",
     "onToolPermissionRequest",
 ];
@@ -804,6 +969,7 @@ export const TOOL_PERMISSION_REQUEST_KEYS = [
     "ruleOffersAbsence",
     "askClass",
     "classes",
+    "sessionRow",
 ];
 export const LOCAL_SESSION_RECORD_KEYS = [
     "sessionId",
@@ -816,6 +982,7 @@ export const LOCAL_SESSION_RECORD_KEYS = [
     "lastActivityAt",
     "queuedMessages",
     "parked",
+    "pinned",
 ];
 export const SEND_MESSAGE_REQUEST_KEYS = [
     "sessionId",
@@ -860,7 +1027,7 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     LocalSessionRecord: {
         guard: "isLocalSessionRecord",
         check: checkLocalSessionRecord,
-        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"],
+        validated: ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked", "pinned"],
         unchecked: [],
     },
     ToolPermissionRequest: {
@@ -900,6 +1067,10 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 key: "classes",
                 why: "与 askClass 同一对(CC-284),同在同缺、同一只成对窄读(非空、每员非空串、无重复、首员等于 askClass;开集、原样顺序);座位门不设第二判官,理由同 askClass。",
             },
+            {
+                key: "sessionRow",
+                why: "放宽方向的展示位(CC-699),判官在过境口 toolPermissionRequestAskBits(card, requestId):卡上「本会话放行」判官 standingRowsOf 的会话行同一前提 ∧ 本请求 requestId 的域带得走(live: / durable:),严格 true 才上座、永不铸 false;座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。消费端 `=== true` 才渲「本会话放行」,其余(缺席 / 坏形)一律不渲 —— 缺席是闭合失败,不是「没说就照渲」。不经过境口自铸座位请求的宿主拿不到这一位,座位卡就不给那一档。",
+            },
             {
                 key: "ruleOffersAbsence",
                 why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。",
@@ -949,6 +1120,10 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 key: "droppedEntries",
                 why: "诊断面(哪些目录条目没被引擎收下),三态读法归 droppedModelEntriesOf(含坏形 malformed);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。",
             },
+            {
+                key: "candidateRejected",
+                why: "诊断面(0.97.0 CC-715;当前配置是候选被整拒后回落的那一份),三态读法归 modelCandidateRejectedOf(含坏形 unreadable);出站门为它拒掉整份目录 = 选单为一行诊断整个消失。",
+            },
         ],
     },
     SendMessageRequest: {
@@ -971,6 +1146,12 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
         ],
         unchecked: [],
     },
+    SessionRowPatchRequest: {
+        guard: "isSessionRowPatchRequest",
+        check: checkSessionRowPatchRequest,
+        validated: ["sessionId", "title", "pinned"],
+        unchecked: [],
+    },
     ApplyModelConfigResult: {
         check: checkApplyModelConfigResult,
         validated: ["ok", "requiresRestart", "reason"],
@@ -1019,12 +1200,22 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
     },
     SettingsState: {
         check: checkSettingsState,
-        validated: ["defaultModel", "engineVersion", "dataRoot"],
+        validated: ["engineVersion", "dataRoot"],
         unchecked: [],
     },
     SeatCapabilitiesState: {
         check: checkSeatCapabilitiesState,
-        validated: ["pickFolder", "rewind"],
+        validated: ["pickFolder", "rewind", "recents", "patchSession"],
+        unchecked: [],
+    },
+    RecentFoldersResult: {
+        check: checkRecentFoldersResult,
+        validated: ["folders"],
+        unchecked: [],
+    },
+    RecentFolderRow: {
+        check: checkRecentFolderRow,
+        validated: ["path", "lastUsedAt"],
         unchecked: [],
     },
     SeatRewindIntent: {
@@ -1087,5 +1278,9 @@ const _seatContractPins = [
     true, true, true, true, true, true, true, true,
     true, true, true, true, true,
     true, 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/sessionPolicyCapability.d.ts

@@ -1,5 +1,7 @@
 export type SessionPolicyReading = {
     kind: 'unobserved';
+} | {
+    kind: 'unreadable';
 } | {
     kind: 'not_reported';
 } | {