@downcity/agent 1.1.199 → 1.1.202

package/src/session/runtime/SessionPromptRuntime.ts

@@ -8,11 +8,11 @@
  */
 
 import { nanoid } from "nanoid";
-import type { SessionUserMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionUserMessageV1 } from "@/executor/types/SessionRecords.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionRecordV1,
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import type { AgentSessionEvent } from "@/types/sdk/AgentSessionEvent.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
@@ -109,7 +109,7 @@ export interface SessionPromptRuntimeOptions {
   }) => Promise<{
     text: string;
     success: boolean;
-    assistantMessage?: SessionModelMessageV1 | null;
+    assistantMessage?: SessionMessageRecordV1 | null;
     error?: string;
   }>;
 
@@ -349,7 +349,7 @@ export class SessionPromptRuntime {
 function buildPromptRuntimeErrorAssistantMessage(input: {
   sessionId: string;
   message: string;
-}): SessionModelMessageV1 {
+}): SessionMessageRecordV1 {
   return {
     id: `a:${input.sessionId}:${Date.now()}:${nanoid(6)}`,
     role: "assistant",

package/src/session/services/SessionStateService.ts

@@ -30,16 +30,15 @@ import type {
 import type {
   AgentSessionEvent,
 } from "@/types/sdk/AgentSessionEvent.js";
-import type {
-  AgentSessionOperationEvent,
-  AgentSessionOperationRecord,
-} from "@/types/sdk/AgentSessionOperation.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
+  SessionActionRecordInputV1,
+  SessionActionRecordV1,
+  SessionRecordV1,
+  SessionMessageRecordV1,
   SessionUserMessageV1,
-} from "@/executor/types/SessionMessages.js";
+} from "@/executor/types/SessionRecords.js";
+import { to_session_action_record } from "@/executor/types/SessionRecords.js";
 import type { SessionLocalState } from "@/types/session/SessionLocalState.js";
 import { generateId } from "@/utils/Id.js";
 
@@ -87,17 +86,16 @@ type SessionStateServiceOptions = {
 
 type SessionSetOptions = {
   /**
-   * 是否写入并发布 model-switching operation。
+   * 是否写入并发布 model-switching action。
    *
    * 说明（中文）
    * - 公开 `session.set()` 应保持默认开启。
    * - fork 内部复制模型配置时关闭，避免污染 forked session 历史。
    */
-  emit_operation?: boolean;
+  emit_action?: boolean;
 };
 
-type EmitOperationInput = Omit<AgentSessionOperationRecord, "operationId"> &
-  Partial<Pick<AgentSessionOperationRecord, "operationId">>;
+type EmitActionInput = SessionActionRecordInputV1 | SessionActionRecordV1;
 
 /**
  * 本地 Session 状态与持久化服务。
@@ -223,23 +221,21 @@ export class SessionStateService {
    * 写入当前 session 配置。
    */
   async set(input: AgentSessionSetInput, options?: SessionSetOptions): Promise<void> {
-    const should_emit_operation = options?.emit_operation !== false;
+    const should_emit_action = options?.emit_action !== false;
     const previous_model_label = this.state.sessionConfig.modelLabel;
     const next_model_label = input.model
       ? inferAgentModelLabel(input.model)
       : undefined;
-    const operation_id = `model-switching:${this.session_id}:${Date.now()}:${generateId()}`;
-
-    if (input.model && should_emit_operation) {
-      await this.emit_operation_event({
-        operationId: operation_id,
-        name: "model-switching",
-        status: "started",
-        label: "Switching session model",
-        result: {
-          ...(previous_model_label ? { previousModelLabel: previous_model_label } : {}),
-          ...(next_model_label ? { modelLabel: next_model_label } : {}),
-        },
+    const action_id = `model-switching:${this.session_id}:${Date.now()}:${generateId()}`;
+
+    if (input.model && should_emit_action) {
+      await this.emit_action_event({
+        id: action_id,
+        title: "Switching session model",
+        description: next_model_label
+          ? `Switching to ${next_model_label}.`
+          : undefined,
+        state: "running",
       });
     }
 
@@ -256,30 +252,25 @@ export class SessionStateService {
         model: this.state.sessionConfig.model,
       });
     } catch (error) {
-      if (input.model && should_emit_operation) {
-        await this.emit_operation_event({
-          operationId: operation_id,
-          name: "model-switching",
-          status: "failed",
-          label: "Session model switch failed",
-          error: error instanceof Error ? error.message : String(error),
+      if (input.model && should_emit_action) {
+        await this.emit_action_event({
+          id: action_id,
+          title: "Session model switch failed",
+          description: error instanceof Error ? error.message : String(error),
+          state: "failed",
         });
       }
       throw error;
     }
 
-    if (input.model && should_emit_operation) {
-      await this.emit_operation_event({
-        operationId: operation_id,
-        name: "model-switching",
-        status: "finished",
-        label: "Session model switched",
-        result: {
-          ...(previous_model_label ? { previousModelLabel: previous_model_label } : {}),
-          ...(this.state.sessionConfig.modelLabel
-            ? { modelLabel: this.state.sessionConfig.modelLabel }
-            : {}),
-        },
+    if (input.model && should_emit_action) {
+      await this.emit_action_event({
+        id: action_id,
+        title: "Session model switched",
+        description: this.state.sessionConfig.modelLabel
+          ? `Using ${this.state.sessionConfig.modelLabel}.`
+          : undefined,
+        state: "completed",
       });
     }
   }
@@ -288,10 +279,10 @@ export class SessionStateService {
    * 追加一条 user 消息并刷新标题与 metadata。
    */
   async append_user_message(params: {
-    message?: SessionMessageV1 | null;
+    message?: SessionRecordV1 | null;
     text?: string;
   }): Promise<void> {
-    await this.executor.appendUserMessage(params);
+    await this.executor.append_user_message(params);
     await this.ensure_title_from_history({ generate: true });
     await this.touch_metadata();
   }
@@ -300,10 +291,10 @@ export class SessionStateService {
    * 追加一条 assistant 消息并刷新 metadata。
    */
   async append_assistant_message(params: {
-    message?: SessionMessageV1 | null;
+    message?: SessionRecordV1 | null;
     fallbackText?: string;
   }): Promise<void> {
-    await this.executor.appendAssistantMessage(params);
+    await this.executor.append_assistant_message(params);
     await this.touch_metadata();
   }
 
@@ -328,7 +319,7 @@ export class SessionStateService {
      */
     generate?: boolean;
   }): Promise<void> {
-    const messages = await this.history_store.list();
+    const messages = await this.history_store.list_records();
     const before_metadata = await readSessionMetadata({
       projectRoot: this.project_root,
       agentId: this.agent_id,
@@ -356,7 +347,7 @@ export class SessionStateService {
    * 持久化最终 assistant 结果。
    */
   async persist_assistant_result(
-    assistant_message?: SessionModelMessageV1 | null,
+    assistant_message?: SessionMessageRecordV1 | null,
   ): Promise<void> {
     await persistSdkAssistantResult({
       projectRoot: this.project_root,
@@ -369,49 +360,33 @@ export class SessionStateService {
   }
 
   /**
-   * 持久化一条 operation message。
+   * 持久化一条 action record。
    */
-  async persist_operation_event(
-    event: AgentSessionOperationEvent,
+  async persist_action_event(
+    event: SessionActionRecordV1,
   ): Promise<void> {
-    if (event.status !== "finished" || event.visible === false) return;
-    const message = this.history_store.operation({
-      operation: {
-        operationId: event.operationId,
-        name: event.name,
-        status: event.status,
-        ...(event.turnId ? { turnId: event.turnId } : {}),
-        ...(event.label ? { label: event.label } : {}),
-        ...(event.reason ? { reason: event.reason } : {}),
-        ...(typeof event.progress === "number" ? { progress: event.progress } : {}),
-        ...(event.result !== undefined ? { result: event.result } : {}),
-        ...(event.error ? { error: event.error } : {}),
-      },
-      metadata: {
-        sessionId: this.session_id,
-      },
-    });
-    await this.history_store.append(message);
+    const message = to_session_action_record(event, this.session_id);
+    await this.history_store.write_record(message);
     await this.touch_metadata();
   }
 
   /**
-   * 写入并发布一条 operation。
+   * 写入并发布一条 action。
    */
-  async emit_operation_event(input: EmitOperationInput): Promise<void> {
-    const operation_id =
-      String(input.operationId || "").trim() ||
-      `${input.name}:${this.session_id}:${Date.now()}:${generateId()}`;
-    const event: AgentSessionOperationEvent = {
-      type: "operation",
-      sessionId: this.session_id,
-      ...input,
-      operationId: operation_id,
-    };
+  async emit_action_event(input: EmitActionInput): Promise<void> {
+    const event = to_session_action_record(
+      {
+        ...input,
+        id:
+          String(input.id || "").trim() ||
+          `action:${this.session_id}:${Date.now()}:${generateId()}`,
+      },
+      this.session_id,
+    );
     try {
-      await this.persist_operation_event(event);
+      await this.persist_action_event(event);
     } catch {
-      // operation 持久化失败不应阻断宿主操作。
+      // action 持久化失败不应阻断宿主操作。
     }
     this.publish_event(event);
   }
@@ -430,7 +405,7 @@ export class SessionStateService {
           sessionId: this.session_id,
         },
       }) as SessionUserMessageV1;
-      await this.executor.appendUserMessage({
+      await this.executor.append_user_message({
         message,
       });
       await this.ensure_title_from_history({ generate: true });
@@ -455,7 +430,7 @@ export class SessionStateService {
         kind: "normal",
       },
     };
-    await this.executor.appendUserMessage({
+    await this.executor.append_user_message({
       message,
     });
     await this.ensure_title_from_history({ generate: true });
@@ -474,7 +449,7 @@ export class SessionStateService {
       : [];
     if (normalized_messages.length <= 0) return;
     for (const message of normalized_messages) {
-      await this.executor.appendUserMessage({
+      await this.executor.append_user_message({
         message,
       });
     }

package/src/session/services/SessionTurnService.ts

@@ -19,10 +19,10 @@ import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js"
 import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
 import type { AgentSessionTurnHandle } from "@/types/sdk/AgentSessionTurn.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
+  SessionRecordV1,
+  SessionMessageRecordV1,
   SessionUserMessageV1,
-} from "@/executor/types/SessionMessages.js";
+} from "@/executor/types/SessionRecords.js";
 import { mapAgentEventToSessionEvent, mapUiMessageChunkToAgentEvent } from "@/session/SessionEventMapper.js";
 import { SessionEventHub } from "@/session/runtime/SessionEventHub.js";
 import { SessionPromptRuntime } from "@/session/runtime/SessionPromptRuntime.js";
@@ -145,7 +145,7 @@ export class SessionTurnService {
   }): Promise<{
     text: string;
     success: boolean;
-    assistantMessage?: SessionModelMessageV1 | null;
+    assistantMessage?: SessionMessageRecordV1 | null;
     error?: string;
   }> {
     const tool_name_by_call_id = new Map<string, string>();
@@ -199,11 +199,11 @@ export class SessionTurnService {
           this.publish_event(session_event);
         }
       },
-      onOperationCallback: async (event) => {
+      onActionCallback: async (event) => {
         try {
-          await this.state_service.persist_operation_event(event);
+          await this.state_service.persist_action_event(event);
         } catch {
-          // operation 持久化失败不应阻断当前 turn。
+          // action 持久化失败不应阻断当前 turn。
         }
         this.publish_event(event);
       },

package/src/session/services/SessionViewService.ts

@@ -2,14 +2,14 @@
  * SessionViewService：本地 Session 查询与派生视图服务。
  *
  * 关键点（中文）
- * - 统一管理 info/history/system/fork 这类读取型能力。
+ * - 统一管理 info/records/system/fork 这类读取型能力。
  * - 该服务只负责拼装查询结果，不负责编排 prompt turn。
  * - 需要写入持久化状态的地方仍委托给 SessionStateService。
  */
 
 import { nanoid } from "nanoid";
 import {
-  buildSessionHistoryPage,
+  buildSessionRecordsPage,
   buildSessionInfo,
   getSdkAgentSessionArchiveFilePath,
   ensureSessionTitle,
@@ -21,14 +21,14 @@ import type { JsonlSessionHistoryStore } from "@/executor/store/history/jsonl/Js
 import type { SessionSystemComposer } from "@/executor/composer/system/SessionSystemComposer.js";
 import type {
   AgentSessionForkInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
   AgentSessionInfo,
   AgentSession,
   AgentSessionSystemBlock,
   AgentSessionSystemSnapshot,
 } from "@/types/agent/AgentTypes.js";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
 import { SessionStateService } from "@/session/services/SessionStateService.js";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
 
@@ -138,7 +138,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
         agentId: this.agent_id,
         sessionId: this.session_id,
       }),
-      this.history_store.list(),
+      this.history_store.list_records(),
     ]);
     return await this.build_info({
       metadata,
@@ -155,7 +155,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
     /**
      * 当前 session 消息列表。
      */
-    messages: SessionMessageV1[];
+    messages: SessionRecordV1[];
   }): Promise<AgentSessionInfo> {
     const metadata_with_title = input.metadata.title
       ? input.metadata
@@ -176,11 +176,11 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
   }
 
   /**
-   * 读取当前 session 历史分页。
+   * 读取当前 session records 分页。
    */
-  async history(
-    input?: AgentSessionHistoryInput,
-  ): Promise<AgentSessionHistoryPage> {
+  async records(
+    input?: AgentSessionRecordsInput,
+  ): Promise<AgentSessionRecordsPage> {
     const archive_id = String(input?.archive_id || "").trim();
     const [metadata, current_messages] = await Promise.all([
       readSessionMetadata({
@@ -188,7 +188,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
         agentId: this.agent_id,
         sessionId: this.session_id,
       }),
-      this.history_store.list(),
+      this.history_store.list_records(),
     ]);
     const page_messages = archive_id
       ? await loadSessionArchiveMessagesFromPath(
@@ -204,7 +204,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
       metadata,
       messages: current_messages,
     });
-    return buildSessionHistoryPage({
+    return buildSessionRecordsPage({
       session,
       messages: page_messages,
       input,
@@ -273,22 +273,18 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
       typeof input === "string"
         ? String(input || "").trim() || undefined
         : String(input?.messageId || "").trim() || undefined;
-    const messages = await this.history_store.list();
+    const messages = await this.history_store.list_records();
     const fork_messages =
       !message_id
         ? messages
         : this.resolve_fork_messages(messages, message_id);
-    const operation_id = `history-forking:${this.session_id}:${Date.now()}:${nanoid(8)}`;
+    const action_id = `history-forking:${this.session_id}:${Date.now()}:${nanoid(8)}`;
 
-    await this.state_service.emit_operation_event({
-      operationId: operation_id,
-      name: "history-forking",
-      status: "started",
-      label: "Forking session history",
-      result: {
-        messageCount: fork_messages.length,
-        ...(message_id ? { messageId: message_id } : {}),
-      },
+    await this.state_service.emit_action_event({
+      id: action_id,
+      title: "Forking session records",
+      description: `Preparing ${String(fork_messages.length)} messages for the new session.`,
+      state: "running",
     });
 
     try {
@@ -302,38 +298,32 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
           {
             model: session_config.model,
           },
-          { emit_operation: false },
+          { emit_action: false },
         );
       }
       await this.append_fork_messages(forked_bundle, fork_messages);
-      await this.state_service.emit_operation_event({
-        operationId: operation_id,
-        name: "history-forking",
-        status: "finished",
-        label: "Session history forked",
-        result: {
-          forkedSessionId: String((forked as { id?: unknown }).id || ""),
-          messageCount: fork_messages.length,
-          ...(message_id ? { messageId: message_id } : {}),
-        },
+      await this.state_service.emit_action_event({
+        id: action_id,
+        title: "Session records forked",
+        description: `Created ${String((forked as { id?: unknown }).id || "")} with ${String(fork_messages.length)} messages.`,
+        state: "completed",
       });
       return forked;
     } catch (error) {
-      await this.state_service.emit_operation_event({
-        operationId: operation_id,
-        name: "history-forking",
-        status: "failed",
-        label: "Session history fork failed",
-        error: error instanceof Error ? error.message : String(error),
+      await this.state_service.emit_action_event({
+        id: action_id,
+        title: "Session records fork failed",
+        description: error instanceof Error ? error.message : String(error),
+        state: "failed",
       });
       throw error;
     }
   }
 
   private resolve_fork_messages(
-    messages: SessionMessageV1[],
+    messages: SessionRecordV1[],
     message_id: string,
-  ): SessionMessageV1[] {
+  ): SessionRecordV1[] {
     const target_index = messages.findIndex(
       (message) => String(message.id || "").trim() === message_id,
     );
@@ -350,9 +340,9 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
       history_store: JsonlSessionHistoryStore;
       state_service: SessionStateService;
     },
-    messages: SessionMessageV1[],
+    messages: SessionRecordV1[],
   ): Promise<void> {
-    await forked_bundle.history_store.appendMany(messages);
+    await forked_bundle.history_store.write_records(messages);
   }
 
   private stringify_system_content(content: unknown): string {

package/src/session/storage/Persistence.ts

@@ -9,9 +9,9 @@
 import { extractTextFromUiMessage } from "@/executor/messages/UIMessageTransformer.js";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionRecordV1,
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import { persistAssistantResult } from "@/executor/messages/AssistantResultPersistence.js";
 import type { AgentSessionConfigSnapshot } from "@/types/agent/AgentTypes.js";
 import {
@@ -50,11 +50,11 @@ export interface PersistSdkAssistantResultParams
    * 追加 assistant 消息的底层执行编排器。
    */
   executor: {
-    appendAssistantMessage(params: {
+    append_assistant_message(params: {
       /**
        * 已构造好的完整消息。
        */
-      message?: SessionMessageV1 | null;
+      message?: SessionRecordV1 | null;
       /**
        * 兜底文本内容。
        */
@@ -68,7 +68,7 @@ export interface PersistSdkAssistantResultParams
    * - stop/abort 且没有 assistant 内容时允许为空。
    * - 为空时仅刷新 metadata，不写入伪造 assistant 正文。
    */
-  assistantMessage?: SessionModelMessageV1 | null;
+  assistantMessage?: SessionMessageRecordV1 | null;
 }
 
 /**

package/src/session/storage/RuntimeSessionPort.ts

@@ -58,11 +58,11 @@ export interface CreateRuntimeSessionPortParams {
   /**
    * 追加 user 消息到底层历史。
    */
-  appendUserMessage: SessionPort["appendUserMessage"];
+  append_user_message: SessionPort["append_user_message"];
   /**
    * 追加 assistant 消息到底层历史。
    */
-  appendAssistantMessage: SessionPort["appendAssistantMessage"];
+  append_assistant_message: SessionPort["append_assistant_message"];
   /**
    * 返回当前 session 是否正在执行。
    */
@@ -111,12 +111,12 @@ export function createRuntimeSessionPort(
     afterSessionUpdatedAsync: async () => {
       await params.afterSessionUpdatedAsync();
     },
-    appendUserMessage: async (messageParams) => {
-      await params.appendUserMessage(messageParams);
+    append_user_message: async (messageParams) => {
+      await params.append_user_message(messageParams);
       await params.touchMetadata();
     },
-    appendAssistantMessage: async (messageParams) => {
-      await params.appendAssistantMessage(messageParams);
+    append_assistant_message: async (messageParams) => {
+      await params.append_assistant_message(messageParams);
       await params.touchMetadata();
     },
     isExecuting: () => params.isExecuting(),

package/src/types/agent/AgentTypes.ts

@@ -36,9 +36,9 @@ export type {
   AgentListSessionsInput,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
-  AgentSessionHistoryView,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
+  AgentSessionRecordsView,
   AgentSessionInfo,
   AgentSessionSetInput,
   AgentSessionSummary,
@@ -53,6 +53,6 @@ export type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
 export type {
   AgentSession,
   AgentSessionActor,
-  AgentSessionCollection,
+  AgentSessions,
   RemoteAgentSession,
 } from "@/types/agent/SessionActor.js";

package/src/types/agent/SessionActor.ts

@@ -16,8 +16,8 @@ import type {
   AgentListSessionsInput,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
   AgentSessionInfo,
   AgentSessionSetInput,
   AgentSessionSummaryPage,
@@ -32,23 +32,23 @@ import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
 import type { AgentSessionTurnHandle } from "@/types/sdk/AgentSessionTurn.js";
 
 /**
- * SDK Session 集合绑定。
+ * SDK Session 集合入口。
  */
-export interface AgentSessionCollection {
+export interface AgentSessions<TSession extends AgentSessionActor = AgentSession> {
   /** 新建一个 session。 */
-  create_session(input?: AgentCreateSessionInput): Promise<AgentSession>;
+  create(input?: AgentCreateSessionInput): Promise<TSession>;
 
   /** 获取一个已存在的 session。 */
-  get_session(sessionId: string): Promise<AgentSession>;
+  get(session_id: string): Promise<TSession>;
 
   /** 列出当前 agent 的 session 摘要页。 */
-  list_sessions(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
+  list(input?: AgentListSessionsInput): Promise<AgentSessionSummaryPage>;
 
   /** 归档单个 session。 */
-  archive_session(input: AgentArchiveSessionInput): Promise<AgentArchiveSessionResult>;
+  archive(input: AgentArchiveSessionInput): Promise<AgentArchiveSessionResult>;
 
   /** 列出已归档的 session 摘要页。 */
-  archive_sessions(input?: AgentArchiveSessionsInput): Promise<AgentArchiveSessionsResult>;
+  archived(input?: AgentArchiveSessionsInput): Promise<AgentArchiveSessionsResult>;
 
   /** 永久清空已归档 session。 */
   clean_archive(): Promise<AgentCleanArchiveResult>;
@@ -62,7 +62,7 @@ export interface AgentSessionActor {
   readonly id: string;
 
   /** 读取当前 session 详情。 */
-  getInfo(): Promise<AgentSessionInfo>;
+  get_info(): Promise<AgentSessionInfo>;
 
   /** 追加一条新的 prompt。 */
   prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
@@ -73,8 +73,8 @@ export interface AgentSessionActor {
   /** 订阅当前 session 的未来事件。 */
   subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
 
-  /** 读取当前 session 历史分页。 */
-  history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+  /** 读取当前 session records 分页。 */
+  records(input?: AgentSessionRecordsInput): Promise<AgentSessionRecordsPage>;
 
   /** 读取当前 session 生效的 system 快照。 */
   system(): Promise<AgentSessionSystemSnapshot>;