@downcity/agent 1.1.200 → 1.1.202

package/src/executor/store/history/jsonl/JsonlSessionHistoryStore.ts

@@ -1,5 +1,5 @@
 /**
- * JsonlSessionHistoryStore：基于 JSONL 的 session history 事实源。
+ * JsonlSessionHistoryStore：基于 JSONL 的 session records 事实源。
  *
  * 关键点（中文）
  * - 负责 `.downcity/.../messages/messages.jsonl`、`meta.json`、archive 与文件锁。
@@ -18,16 +18,15 @@ import { generateId } from "@/utils/Id.js";
 import { getLogger } from "@/utils/logger/Logger.js";
 import { compactSessionMessagesIfNeeded } from "@executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.js";
 import type {
-  SessionActionMessageV1,
-  SessionMessageV1,
+  SessionActionRecordV1,
+  SessionRecordV1,
   SessionMetadataV1,
-} from "@/executor/types/SessionMessages.js";
+} from "@/executor/types/SessionRecords.js";
 import {
-  isSessionActionMessage,
-  isSessionModelMessage,
-  toSessionActionMessage,
-} from "@/executor/types/SessionMessages.js";
-import type { AgentSessionActionRecord } from "@/types/sdk/AgentSessionAction.js";
+  is_session_action_record,
+  is_session_message_record,
+  to_session_action_record,
+} from "@/executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
 import type { SessionHistoryPathOverrides } from "@/executor/types/SessionHistoryPaths.js";
@@ -220,10 +219,10 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
 
   private normalizePersistedMessage(
     input: unknown,
-  ): SessionMessageV1 | null {
+  ): SessionRecordV1 | null {
     if (!input || typeof input !== "object") return null;
     if ((input as { type?: unknown }).type === "action") {
-      return this.normalizeActionMessage(input);
+      return this.normalize_action_record(input);
     }
     const candidate = input as { role?: unknown; parts?: unknown };
     const role = String(candidate.role || "");
@@ -231,12 +230,12 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
       return null;
     }
     if (!Array.isArray(candidate.parts)) return null;
-    return input as SessionMessageV1;
+    return input as SessionRecordV1;
   }
 
-  private normalizeActionMessage(input: unknown): SessionActionMessageV1 | null {
+  private normalize_action_record(input: unknown): SessionActionRecordV1 | null {
     if (!input || typeof input !== "object") return null;
-    const candidate = input as Partial<SessionActionMessageV1>;
+    const candidate = input as Partial<SessionActionRecordV1>;
     const id = String(candidate.id || "").trim();
     const title = String(candidate.title || "").trim();
     const state = String(candidate.state || "").trim();
@@ -248,7 +247,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
       candidate.metadata && typeof candidate.metadata === "object"
         ? candidate.metadata
         : {};
-    const metadata_candidate = metadata_input as Partial<SessionActionMessageV1["metadata"]>;
+    const metadata_candidate = metadata_input as Partial<SessionActionRecordV1["metadata"]>;
     const session_id =
       String(metadata_candidate.sessionId || "").trim() || this.sessionId;
     const description = String(candidate.description || "").trim();
@@ -270,9 +269,9 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     };
   }
 
-  private hasStructuredAssistantParts(message: SessionMessageV1 | null): boolean {
+  private hasStructuredAssistantParts(message: SessionRecordV1 | null): boolean {
     if (
-      !isSessionModelMessage(message) ||
+      !is_session_message_record(message) ||
       message.role !== "assistant" ||
       !Array.isArray(message.parts)
     ) {
@@ -286,11 +285,11 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
   }
 
   private mergeInflightWithFinal(
-    inflight: SessionMessageV1,
-    finalMessage: SessionMessageV1,
-  ): SessionMessageV1 {
-    if (!isSessionModelMessage(finalMessage)) return inflight;
-    if (!isSessionModelMessage(inflight)) return finalMessage;
+    inflight: SessionRecordV1,
+    finalMessage: SessionRecordV1,
+  ): SessionRecordV1 {
+    if (!is_session_message_record(finalMessage)) return inflight;
+    if (!is_session_message_record(inflight)) return finalMessage;
     const final_parts = Array.isArray(finalMessage.parts)
       ? finalMessage.parts.filter((part) => part && typeof part === "object")
       : [];
@@ -396,7 +395,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     await fs.writeJson(this.getMetaFilePath(), normalized, { spaces: 2 });
   }
 
-  private async readInflightUnsafe(): Promise<SessionMessageV1 | null> {
+  private async read_inflight_unsafe(): Promise<SessionRecordV1 | null> {
     const file = this.getInflightFilePath();
     try {
       const raw = await fs.readJson(file);
@@ -406,10 +405,10 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     }
   }
 
-  private async writeInflightUnsafe(message: SessionMessageV1): Promise<void> {
+  private async write_inflight_unsafe(message: SessionRecordV1): Promise<void> {
     const normalized = this.normalizePersistedMessage(message);
     if (
-      !isSessionModelMessage(normalized) ||
+      !is_session_message_record(normalized) ||
       normalized.role !== "assistant"
     ) {
       throw new Error("inflight assistant must be an assistant UIMessage");
@@ -425,7 +424,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     await fs.remove(this.getInflightFilePath());
   }
 
-  private async appendMessageUnsafe(message: SessionMessageV1): Promise<void> {
+  private async appendMessageUnsafe(message: SessionRecordV1): Promise<void> {
     await fs.appendFile(
       this.getMessagesFilePath(),
       JSON.stringify(message) + "\n",
@@ -433,7 +432,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     );
   }
 
-  private async rewriteMessagesUnsafe(messages: SessionMessageV1[]): Promise<void> {
+  private async rewriteMessagesUnsafe(messages: SessionRecordV1[]): Promise<void> {
     const file = this.getMessagesFilePath();
     const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
     const payload =
@@ -444,19 +443,19 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     await fs.move(temp, file, { overwrite: true });
   }
 
-  private async upsertActionMessageUnsafe(
-    message: SessionActionMessageV1,
+  private async upsert_action_record_unsafe(
+    message: SessionActionRecordV1,
   ): Promise<void> {
     const file = this.getMessagesFilePath();
     const raw = await fs.readFile(file, "utf8").catch(() => "");
-    const messages: SessionMessageV1[] = [];
+    const messages: SessionRecordV1[] = [];
     let replaced = false;
 
     for (const line of raw.split("\n").filter(Boolean)) {
       try {
         const current = this.normalizePersistedMessage(JSON.parse(line));
         if (!current) continue;
-        if (isSessionActionMessage(current) && current.id === message.id) {
+        if (is_session_action_record(current) && current.id === message.id) {
           messages.push(message);
           replaced = true;
           continue;
@@ -539,7 +538,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
         rootPath: this.rootPath,
         sessionId: this.sessionId,
         withWriteLock: (fn) => this.withWriteLock(fn),
-        loadAll: () => this.list(),
+        loadAll: () => this.list_records(),
         createSummaryMessage: ({ text, archiveId, sourceRange }) => ({
           id: `a:${this.sessionId}:${generateId()}`,
           role: "assistant",
@@ -571,19 +570,19 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     );
   }
 
-  async append(message: SessionMessageV1): Promise<void> {
+  async write_record(message: SessionRecordV1): Promise<void> {
     await this.withWriteLock(async () => {
       const normalized = this.normalizePersistedMessage(message);
       if (!normalized) return;
-      if (isSessionActionMessage(normalized)) {
-        await this.upsertActionMessageUnsafe(normalized);
+      if (is_session_action_record(normalized)) {
+        await this.upsert_action_record_unsafe(normalized);
         return;
       }
 
       // 关键点（中文）：若上一次 assistant 在运行中中断，新的 user 到来前先把残留快照收口到正式历史，
-      // 避免 `list()` 时旧 inflight 跑到新 user 后面，打乱时序。
-      if (isSessionModelMessage(normalized) && normalized.role === "user") {
-        const current_inflight = await this.readInflightUnsafe();
+      // 避免 `list_records()` 时旧 inflight 跑到新 user 后面，打乱时序。
+      if (is_session_message_record(normalized) && normalized.role === "user") {
+        const current_inflight = await this.read_inflight_unsafe();
         if (current_inflight) {
           await this.appendMessageUnsafe(current_inflight);
           await this.removeInflightUnsafe();
@@ -601,11 +600,11 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
    * - 一次锁、一次 IO，适合 fork 等需要拷贝整段历史的场景。
    * - 不处理 inflight，调用方需自行确保历史已经收口。
    */
-  async appendMany(messages: SessionMessageV1[]): Promise<void> {
+  async write_records(messages: SessionRecordV1[]): Promise<void> {
     if (!Array.isArray(messages) || messages.length === 0) return;
     const normalized_list = messages
       .map((message) => this.normalizePersistedMessage(message))
-      .filter((message): message is SessionMessageV1 => message !== null);
+      .filter((message): message is SessionRecordV1 => message !== null);
     if (normalized_list.length === 0) return;
 
     const payload = normalized_list
@@ -616,20 +615,20 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     });
   }
 
-  async readInflight(): Promise<SessionMessageV1 | null> {
+  async read_inflight(): Promise<SessionRecordV1 | null> {
     await this.ensureLayout();
-    return this.readInflightUnsafe();
+    return this.read_inflight_unsafe();
   }
 
-  async writeInflight(message: SessionMessageV1): Promise<void> {
+  async write_inflight(message: SessionRecordV1): Promise<void> {
     await this.withWriteLock(async () => {
-      await this.writeInflightUnsafe(message);
+      await this.write_inflight_unsafe(message);
     });
   }
 
-  async finalizeInflight(message?: SessionMessageV1 | null): Promise<void> {
+  async finalize_inflight(message?: SessionRecordV1 | null): Promise<void> {
     await this.withWriteLock(async () => {
-      const current_inflight = await this.readInflightUnsafe();
+      const current_inflight = await this.read_inflight_unsafe();
       const normalized_message = this.normalizePersistedMessage(message);
       const final_message =
         current_inflight && normalized_message
@@ -644,12 +643,12 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     });
   }
 
-  async list(): Promise<SessionMessageV1[]> {
+  async list_records(): Promise<SessionRecordV1[]> {
     await this.ensureLayout();
     const file = this.getMessagesFilePath();
     const raw = await fs.readFile(file, "utf8");
     const lines = raw.split("\n").filter(Boolean);
-    const out: SessionMessageV1[] = [];
+    const out: SessionRecordV1[] = [];
     for (const line of lines) {
       try {
         const obj = this.normalizePersistedMessage(JSON.parse(line));
@@ -659,22 +658,22 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
         // ignore invalid lines
       }
     }
-    const current_inflight = await this.readInflightUnsafe();
+    const current_inflight = await this.read_inflight_unsafe();
     if (current_inflight) {
       out.push(current_inflight);
     }
     return out;
   }
 
-  async slice(start: number, end: number): Promise<SessionMessageV1[]> {
-    const msgs = await this.list();
+  async slice_records(start: number, end: number): Promise<SessionRecordV1[]> {
+    const msgs = await this.list_records();
     const startIndex = Math.max(0, Math.floor(start));
     const endIndex = Math.max(startIndex, Math.floor(end));
     return msgs.slice(startIndex, endIndex);
   }
 
-  async size(): Promise<number> {
-    const msgs = await this.list();
+  async record_count(): Promise<number> {
+    const msgs = await this.list_records();
     return msgs.length;
   }
 
@@ -691,7 +690,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     metadata: Omit<SessionMetadataV1, "v" | "ts"> &
       Partial<Pick<SessionMetadataV1, "ts">>;
     id?: string;
-  }): SessionMessageV1 {
+  }): SessionRecordV1 {
     const { ts, ...metadata } = input.metadata;
     const md: SessionMetadataV1 = {
       v: 1,
@@ -716,7 +715,7 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     id?: string;
     kind?: "normal" | "summary";
     source?: "egress" | "compact";
-  }): SessionMessageV1 {
+  }): SessionRecordV1 {
     const { ts, ...metadata } = input.metadata;
     const md: SessionMetadataV1 = {
       v: 1,
@@ -735,17 +734,14 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
   }
 
   action(input: {
-    action: AgentSessionActionRecord;
+    action: SessionActionRecordV1;
     metadata: Pick<SessionMetadataV1, "sessionId"> &
       Partial<Pick<SessionMetadataV1, "ts">>;
     id?: string;
-  }): SessionActionMessageV1 {
+  }): SessionActionRecordV1 {
     const { ts, ...metadata } = input.metadata;
-    const message = toSessionActionMessage(
-      {
-        ...input.action,
-        ...(input.id ? { id: input.id } : {}),
-      },
+    const message = to_session_action_record(
+      input.id ? { ...input.action, id: input.id } : input.action,
       metadata.sessionId || this.sessionId,
     );
     return {

package/src/executor/tools/plugin/PluginToolSchemas.ts

@@ -3,20 +3,34 @@
  *
  * 关键点（中文）
  * - plugin_call 是 agent 内置的最低层 plugin action 桥。
- * - schema 只描述模型需要提交的目标 plugin、action 与 JSON payload。
+ * - plugin_call.payload 是透传给具体 plugin action 的 JSON object。
+ * - 这里不用 Zod 表达 payload 的开放对象语义，避免 AI SDK zodSchema
+ *   转换后把 additionalProperties 收窄为 false。
  */
 
+import { jsonSchema } from "ai";
 import { z } from "zod";
 
-export const plugin_call_input_schema = z.object({
-  plugin: z.string().describe("Registered plugin name to call, for example image."),
-  action: z.string().describe("Plugin action name to execute, for example image_create."),
-  payload: z
-    .object({})
-    .passthrough()
-    .optional()
-    .default({})
-    .describe("JSON payload passed to the plugin action."),
+export const plugin_call_input_schema = jsonSchema({
+  type: "object",
+  required: ["plugin", "action"],
+  additionalProperties: false,
+  properties: {
+    plugin: {
+      type: "string",
+      description: "Registered plugin name to call, for example image.",
+    },
+    action: {
+      type: "string",
+      description: "Plugin action name to execute, for example image_create.",
+    },
+    payload: {
+      type: "object",
+      additionalProperties: true,
+      default: {},
+      description: "JSON payload passed to the plugin action.",
+    },
+  },
 });
 
 export const plugin_read_input_schema = z.object({

package/src/executor/types/{SessionMessages.ts → SessionRecords.ts}

@@ -1,26 +1,23 @@
 /**
- * SessionMessage 类型定义。
+ * SessionRecord 类型定义。
  *
  * 关键点（中文）
- * - 这里统一描述 session 消息落盘格式与元信息结构。
- * - session 的唯一事实源是消息 JSONL，模型消息继续使用 AI SDK `UIMessage`。
- * - 这些类型会被 history Store、history Composer、compact、control UI、task runtime 共同复用。
+ * - 这里统一描述 session JSONL 中的持久化 record 结构。
+ * - record 是 session 内部事实源；其中 message record 继续使用 AI SDK `UIMessage`。
+ * - action record 是 UI record，不属于 LLM 输入。
+ * - 这些类型会被 Store、Composer、compact、control UI、task runtime 共同复用。
  */
 
 import type { UIMessage } from "ai";
 import type { JsonObject } from "@/types/common/Json.js";
-import type {
-  AgentSessionActionRecord,
-  AgentSessionActionState,
-} from "@/types/sdk/AgentSessionAction.js";
 
 /**
- * Session 消息：以 UIMessage[] 作为唯一事实源。
+ * Session message record 类别。
  *
  * 关键点（中文）
  * - 持久化存储在 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`
- * - 默认只存模型消息，或 `type=action` 的 UI 状态消息。
- * - compact 会把更早消息压缩为一条 `assistant` 摘要消息
+ * - record 文件默认包含 message record，或 `type=action` 的 UI 状态记录。
+ * - compact 会把更早 message record 压缩为一条 `assistant` 摘要 record。
  * - action 只用于 UI timeline，不进入 LLM 输入
  */
 export type SessionMessageKind = "normal" | "summary";
@@ -87,12 +84,17 @@ export type SessionMetadataV1 = {
 };
 
 /**
- * 模型可消费的 Session UI 消息结构。
+ * 大模型可消费的 Session message record。
  */
-export type SessionModelMessageV1 = UIMessage<SessionMetadataV1>;
+export type SessionMessageRecordV1 = UIMessage<SessionMetadataV1>;
 
 /**
- * action 消息元信息。
+ * Session action 当前状态。
+ */
+export type SessionActionStateV1 = "running" | "completed" | "failed";
+
+/**
+ * action record 元信息。
  */
 export type SessionActionMetadataV1 = {
   /** 元信息 schema 版本号。 */
@@ -106,14 +108,14 @@ export type SessionActionMetadataV1 = {
 };
 
 /**
- * action 类型的 Session 消息结构。
+ * action 类型的 Session record 结构。
  *
  * 关键点（中文）
- * - `action` 不是 AI SDK 原生模型消息。
- * - 它只存在于 JSONL history 与前端 timeline，进入 LLM 前必须过滤。
+ * - `action` 不是 AI SDK 原生 message record。
+ * - 它只存在于 session records 与前端 timeline，进入 LLM 前必须过滤。
  */
-export type SessionActionMessageV1 = {
-  /** item 类型固定为 `action`。 */
+export type SessionActionRecordV1 = {
+  /** record 类型固定为 `action`。 */
   type: "action";
   /** 同一个 action 生命周期内稳定复用的 ID。 */
   id: string;
@@ -122,44 +124,73 @@ export type SessionActionMessageV1 = {
   /** 当前 action 描述。 */
   description?: string;
   /** 当前 action 状态。 */
-  state: AgentSessionActionState;
+  state: SessionActionStateV1;
   /** action 元信息。 */
   metadata: SessionActionMetadataV1;
 };
 
 /**
- * Session 持久化消息结构。
+ * 构造 action record 的输入结构。
+ */
+export type SessionActionRecordInputV1 = {
+  /** 同一个 action 生命周期内稳定复用的 ID。 */
+  id?: string;
+  /** 当前 action 标题。 */
+  title: string;
+  /** 当前 action 描述。 */
+  description?: string;
+  /** 当前 action 状态。 */
+  state: SessionActionStateV1;
+  /** 当前 action 关联的 turn 标识。 */
+  turnId?: string;
+  /** 可选 action 元信息覆盖。 */
+  metadata?: Partial<SessionActionMetadataV1>;
+};
+
+/**
+ * Session 持久化 record 结构。
+ *
+ * 说明（中文）
+ * - message record 是可进入 LLM 的 record。
+ * - action record 是只给前端展示的 record，组装模型输入前必须过滤。
  */
-export type SessionMessageV1 = SessionModelMessageV1 | SessionActionMessageV1;
+export type SessionRecordV1 = SessionMessageRecordV1 | SessionActionRecordV1;
 
 /**
- * user 角色的 Session 消息结构。
+ * user 角色的 Session message record。
  */
-export type SessionUserMessageV1 = SessionModelMessageV1 & {
+export type SessionUserMessageV1 = SessionMessageRecordV1 & {
   /** 消息角色固定为 `user`。 */
   role: "user";
 };
 
 /**
- * 判断一条消息是否为 action message。
+ * 判断一条 record 是否为 action record。
  */
-export function isSessionActionMessage(
-  message: SessionMessageV1 | null | undefined,
-): message is SessionActionMessageV1 {
+export function is_session_action_record(
+  message: SessionRecordV1 | null | undefined,
+): message is SessionActionRecordV1 {
   if (!message || typeof message !== "object") return false;
   return (message as { type?: unknown }).type === "action";
 }
 
 /**
- * 从订阅事件构造 action message。
+ * 从订阅事件构造 action record。
  */
-export function toSessionActionMessage(
-  action: AgentSessionActionRecord,
+export function to_session_action_record(
+  action: SessionActionRecordInputV1 | SessionActionRecordV1,
   session_id: string,
-): SessionActionMessageV1 {
+): SessionActionRecordV1 {
   const title = String(action.title || "").trim() || "Action";
   const description = String(action.description || "").trim();
   const id = String(action.id || "").trim() || `action:${session_id}:${Date.now()}`;
+  const metadata =
+    "metadata" in action && action.metadata && typeof action.metadata === "object"
+      ? action.metadata
+      : {};
+  const turn_id =
+    String(metadata.turnId || "").trim() ||
+    ("turnId" in action ? String(action.turnId || "").trim() : "");
   return {
     type: "action",
     id,
@@ -168,19 +199,19 @@ export function toSessionActionMessage(
     state: action.state,
     metadata: {
       v: 1,
-      ts: Date.now(),
-      sessionId: session_id,
-      ...(action.turnId ? { turnId: action.turnId } : {}),
+      ts: typeof metadata.ts === "number" ? metadata.ts : Date.now(),
+      sessionId: String(metadata.sessionId || "").trim() || session_id,
+      ...(turn_id ? { turnId: turn_id } : {}),
     },
   };
 }
 
 /**
- * 判断一条消息是否为模型可消费的 UIMessage。
+ * 判断一条 record 是否为大模型可消费的 message record。
  */
-export function isSessionModelMessage(
-  message: SessionMessageV1 | null | undefined,
-): message is SessionModelMessageV1 {
+export function is_session_message_record(
+  message: SessionRecordV1 | null | undefined,
+): message is SessionMessageRecordV1 {
   if (!message || typeof message !== "object") return false;
-  return !isSessionActionMessage(message);
+  return !is_session_action_record(message);
 }

package/src/executor/types/SessionRun.ts

@@ -9,10 +9,10 @@
 
 import type { Tool, UIMessageChunk } from "ai";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
+  SessionRecordV1,
+  SessionMessageRecordV1,
   SessionUserMessageV1,
-} from "@/executor/types/SessionMessages.js";
+} from "@/executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
 
@@ -102,7 +102,7 @@ export interface SessionRunResult {
    * - stop/abort 且没有任何 assistant 内容时可以为空。
    * - turn 状态通过 `success` / `error` 表达，不应伪造成 assistant 正文。
    */
-  assistantMessage?: SessionModelMessageV1 | null;
+  assistantMessage?: SessionMessageRecordV1 | null;
 
   /**
    * 本轮执行结束后待写入长期历史的 user 消息。
@@ -150,7 +150,7 @@ export interface SessionExecuteInput {
   /**
    * 当前轮 context 语义消息历史。
    */
-  messages: SessionMessageV1[];
+  messages: SessionRecordV1[];
 
   /**
    * 当前轮可用工具集合。

package/src/index.ts

@@ -22,7 +22,7 @@ export type {
   AgentArchiveSessionResult,
   AgentArchiveSessionsResult,
   AgentCleanArchiveResult,
-  AgentSessionCollection,
+  AgentSessions,
   AgentModel,
   AgentManagedSession,
   AgentSessionActor,
@@ -34,9 +34,9 @@ export type {
   RemoteAgentOptions,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
-  AgentSessionHistoryView,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
+  AgentSessionRecordsView,
   AgentSessionInfo,
   AgentSessionSetInput,
   AgentSessionSummary,

package/src/rpc/Client.ts

@@ -16,8 +16,8 @@ import type {
   AgentArchiveSessionResult,
   AgentArchiveSessionsResult,
   AgentCleanArchiveResult,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
   AgentSessionInfo,
   AgentSessionStopResult,
   AgentSessionSummaryPage,
@@ -196,20 +196,20 @@ export class RpcClient {
   }
 
   /**
-   * 读取 history。
+   * 读取 session records。
    */
-  async get_session_history(params: {
+  async get_session_records(params: {
     session_id: string;
-    input?: AgentSessionHistoryInput;
-  }): Promise<AgentSessionHistoryPage> {
-    const data = await this.request<{ history: AgentSessionHistoryPage }>({
-      method: "sdk.sessions.history",
+    input?: AgentSessionRecordsInput;
+  }): Promise<AgentSessionRecordsPage> {
+    const data = await this.request<{ records: AgentSessionRecordsPage }>({
+      method: "sdk.sessions.records",
       params: {
         sessionId: params.session_id,
         input: params.input,
       },
     });
-    return data.history;
+    return data.records;
   }
 
   /**