@sema-agent/client-core 0.93.1 → 0.95.0

package/dist/seatContract.d.ts

@@ -5,6 +5,8 @@ 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;
@@ -29,6 +31,7 @@ export interface LocalSessionRecord {
     engineSessionId?: string;
     model?: string;
     title?: string;
+    cwd?: string;
     isRunning: boolean;
     createdAt: string;
     lastActivityAt?: string;
@@ -96,9 +99,27 @@ 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", "rewind"];
+export type SeatCapabilityName = (typeof SEAT_CAPABILITY_NAMES)[number];
+export interface SeatCapabilitiesState {
+    pickFolder?: boolean;
+    rewind?: boolean;
+}
+export type SeatCapabilityReading = {
+    readonly kind: "reported";
+    readonly available: boolean;
+} | {
+    readonly kind: "not_reported";
+} | {
+    readonly kind: "malformed";
+};
+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 StartSessionOptions {
     model?: string;
     title?: string;
@@ -113,6 +134,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;
@@ -128,6 +171,7 @@ export interface SendMessageRequest {
         max?: number;
     };
     settings?: SeatTurnSettings;
+    rewind?: SeatRewindIntent;
     scenario?: string;
 }
 export interface AttachmentUploadRequest {
@@ -146,17 +190,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;
@@ -225,13 +258,15 @@ 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>;
     onEvent(cb: (ev: LocalSessionEvent) => void): () => void;
     onToolPermissionRequest(cb: (req: ToolPermissionRequest) => void): () => void;
     sessionsStateStore: EipcStoreClient<SessionsState>;
     focusedSessionStateStore: EipcStoreClient<FocusedSessionState>;
     settingsStateStore: EipcStoreClient<SettingsState>;
+    seatCapabilitiesStateStore: EipcStoreClient<SeatCapabilitiesState>;
 }
 export declare function isLocalSessionRecord(s: unknown): s is LocalSessionRecord;
 export declare function isToolPermissionRequest(r: unknown): r is ToolPermissionRequest;
@@ -257,16 +292,17 @@ 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 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", "onEvent", "onToolPermissionRequest"];
-export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore"];
+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_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 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", "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_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", "rewind"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
     readonly sessionId: {
         readonly seatOnly: "座位会话句柄(渲染端持有的本地 id);引擎会话 id 由座位记录的 `engineSessionId` 承载 —— 与引擎请求体上的同名位**同名不同义**,绝不直传";
@@ -304,19 +340,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", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["sessionId", "engineSessionId", "model", "title", "cwd", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
         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";
@@ -335,7 +375,7 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
             readonly why: "展示增强位(CC-203),权威窄读在卡口与过境口(闭集六词精确字节,表外不上座);座位门不设第二判官,理由同 mandated。消费端经 readApprovalMandate 读,表外值读成缺席。";
         }, {
             readonly key: "origin";
-            readonly why: "喂姿态谓词 askSurvivesPosture 的安全位(CC-203),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口 toolPermissionRequestAskBits,座位门不设第二判官(为一个位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。坏形的两种失效方向:非串 / 空串读成缺席 ⇒ 宿主报了没命中时姿态谓词可答可以放(放宽方向:真出身若是必问词就丢了);表外串读成不认识的词 ⇒ 答 unknown,宿主退回自己的规则(不放宽)。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+            readonly why: "喂自动车道单一判定 automaticAnswerVerdict 的出身位(CC-203),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口 toolPermissionRequestAskBits,座位门不设第二判官(为一个位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。坏形的两种失效方向:非串 / 空串读成缺席 ⇒ 判定少一路必问证据(放宽方向:真出身若是收词、而卡上的类集恰没带它对应的类,这一路就丢了);表外串 ⇒ 不是收词,出身这一路不起作用(类集照读,不放宽)。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
         }, {
             readonly key: "askClass";
             readonly why: "展示位(CC-284),权威成对窄读在卡口与过境口 toolPermissionRequestAskBits(与 classes 同在同缺、首员等于 askClass、不判成员、不重排);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎超时拒)。坏形读成缺席 ⇒ 卡上不显示问类,不改决断;缺席不是「普通问」。不经过境口自铸座位请求的宿主要自己按同一把成对窄读。";
@@ -350,7 +390,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 校验)—— 校它 = 引擎加一种消息体的那天整条转录被门吃掉。";
@@ -362,10 +402,18 @@ 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", "defaultId"];
+        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 ApplyModelConfigResult: {
@@ -419,9 +467,14 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         readonly validated: readonly ["defaultModel", "engineVersion", "dataRoot"];
         readonly unchecked: readonly [];
     };
-    readonly SeatModelInfo: {
+    readonly SeatCapabilitiesState: {
         readonly check: (v: unknown) => SeatValidation;
-        readonly validated: readonly ["id", "name", "provider", "contextWindow", "maxOutputTokens"];
+        readonly validated: readonly ["pickFolder", "rewind"];
+        readonly unchecked: readonly [];
+    };
+    readonly SeatRewindIntent: {
+        readonly check: (v: unknown) => SeatValidation;
+        readonly validated: readonly ["mode", "targetMessageUuid"];
         readonly unchecked: readonly [];
     };
     readonly SessionSearchResult: {
@@ -441,6 +494,10 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
     };
 };
 export declare const SEAT_VALIDATOR_COVERAGE_EXEMPT: readonly [{
+    readonly label: "PickFolderResult";
+    readonly check: (v: unknown) => SeatValidation;
+    readonly why: "载荷是**串或 null**(选中的路径 / 用户取消,CC-469),没有键面 ⇒ `keyof` 覆盖表在它身上无从谈起。判别力由 run-seat-wave2-test.mjs ST1-1 承担:认 null 与非空串、拒空串 / 数 / undefined / 对象 / 布尔五形。";
+}, {
     readonly label: "BooleanAck";
     readonly check: (v: unknown) => SeatValidation;
     readonly why: "载荷是**裸布尔**(queue 三件 + setModel 的 CC 形回执,false = too-late/no-op),没有键面 ⇒ `keyof` 覆盖表在它身上无从谈起。判别力由 J 段承担:认 true/false、拒非布尔(对象 / 字符串 'true' / null / undefined 四形逐一投毒)。";