@downcity/agent 1.1.199 → 1.1.202

package/src/executor/types/SessionRecords.ts

@@ -0,0 +1,217 @@
+/**
+ * SessionRecord 类型定义。
+ *
+ * 关键点（中文）
+ * - 这里统一描述 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";
+
+/**
+ * Session message record 类别。
+ *
+ * 关键点（中文）
+ * - 持久化存储在 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`
+ * - record 文件默认包含 message record，或 `type=action` 的 UI 状态记录。
+ * - compact 会把更早 message record 压缩为一条 `assistant` 摘要 record。
+ * - action 只用于 UI timeline，不进入 LLM 输入
+ */
+export type SessionMessageKind = "normal" | "summary";
+
+/**
+ * Session 消息来源类型。
+ *
+ * 说明（中文）
+ * - `ingress`：外部输入写入的 user 消息。
+ * - `egress`：模型或 agent 输出写入的 assistant 消息。
+ * - `compact`：由 compact 过程生成的摘要消息。
+ */
+export type SessionMessageSource =
+  | "ingress"
+  | "egress"
+  | "compact";
+
+/**
+ * 入站消息细分类型。
+ *
+ * 说明（中文）
+ * - 当前仅保留 `exec`，表示这条入站消息可触发一次 session 执行。
+ */
+export type SessionIngressKind = "exec";
+
+/**
+ * 摘要消息对应的原始消息范围。
+ */
+export type SessionMessageSourceRangeV1 = {
+  /** 起始消息 ID。 */
+  fromId: string;
+  /** 结束消息 ID。 */
+  toId: string;
+  /** 被覆盖的原始消息数量。 */
+  count: number;
+};
+
+/**
+ * Session 消息元信息。
+ */
+export type SessionMetadataV1 = {
+  /** 元信息 schema 版本号。 */
+  v: 1;
+  /** 当前消息写入时的毫秒时间戳。 */
+  ts: number;
+  /** 当前消息所属的 session ID。 */
+  sessionId: string;
+  /** 当前消息是普通消息还是摘要消息。 */
+  kind?: SessionMessageKind;
+  /** 当前消息来自入站、出站还是 compact。 */
+  source?: SessionMessageSource;
+  /** compact 摘要对应的 archive 文件 ID，用于用户历史按层读取更早消息。 */
+  archiveId?: string;
+  /** compact 摘要所覆盖的原始消息范围。 */
+  sourceRange?: SessionMessageSourceRangeV1;
+  /**
+   * 扩展元信息。
+   *
+   * 约定（中文）
+   * - 对 `source=ingress` 的 user 消息，可选写入 `extra.ingressKind`：
+   *   - `exec`：可触发 Session 执行的输入
+   */
+  extra?: JsonObject;
+};
+
+/**
+ * 大模型可消费的 Session message record。
+ */
+export type SessionMessageRecordV1 = UIMessage<SessionMetadataV1>;
+
+/**
+ * Session action 当前状态。
+ */
+export type SessionActionStateV1 = "running" | "completed" | "failed";
+
+/**
+ * action record 元信息。
+ */
+export type SessionActionMetadataV1 = {
+  /** 元信息 schema 版本号。 */
+  v: 1;
+  /** 当前 action 写入时的毫秒时间戳。 */
+  ts: number;
+  /** 当前 action 所属的 session ID。 */
+  sessionId: string;
+  /** 当前 action 关联的 turn 标识。 */
+  turnId?: string;
+};
+
+/**
+ * action 类型的 Session record 结构。
+ *
+ * 关键点（中文）
+ * - `action` 不是 AI SDK 原生 message record。
+ * - 它只存在于 session records 与前端 timeline，进入 LLM 前必须过滤。
+ */
+export type SessionActionRecordV1 = {
+  /** record 类型固定为 `action`。 */
+  type: "action";
+  /** 同一个 action 生命周期内稳定复用的 ID。 */
+  id: string;
+  /** 当前 action 标题。 */
+  title: string;
+  /** 当前 action 描述。 */
+  description?: string;
+  /** 当前 action 状态。 */
+  state: SessionActionStateV1;
+  /** action 元信息。 */
+  metadata: SessionActionMetadataV1;
+};
+
+/**
+ * 构造 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 SessionRecordV1 = SessionMessageRecordV1 | SessionActionRecordV1;
+
+/**
+ * user 角色的 Session message record。
+ */
+export type SessionUserMessageV1 = SessionMessageRecordV1 & {
+  /** 消息角色固定为 `user`。 */
+  role: "user";
+};
+
+/**
+ * 判断一条 record 是否为 action record。
+ */
+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 record。
+ */
+export function to_session_action_record(
+  action: SessionActionRecordInputV1 | SessionActionRecordV1,
+  session_id: string,
+): 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,
+    title,
+    ...(description ? { description } : {}),
+    state: action.state,
+    metadata: {
+      v: 1,
+      ts: typeof metadata.ts === "number" ? metadata.ts : Date.now(),
+      sessionId: String(metadata.sessionId || "").trim() || session_id,
+      ...(turn_id ? { turnId: turn_id } : {}),
+    },
+  };
+}
+
+/**
+ * 判断一条 record 是否为大模型可消费的 message record。
+ */
+export function is_session_message_record(
+  message: SessionRecordV1 | null | undefined,
+): message is SessionMessageRecordV1 {
+  if (!message || typeof message !== "object") return false;
+  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,
@@ -56,12 +56,11 @@ export type {
   AgentSessionUnsubscribe,
 } from "./types/sdk/AgentSessionEvent.js";
 export type {
-  AgentSessionOperationCallback,
-  AgentSessionOperationEvent,
-  AgentSessionOperationName,
-  AgentSessionOperationRecord,
-  AgentSessionOperationStatus,
-} from "./types/sdk/AgentSessionOperation.js";
+  AgentSessionActionCallback,
+  AgentSessionActionEvent,
+  AgentSessionActionRecord,
+  AgentSessionActionState,
+} from "./types/sdk/AgentSessionAction.js";
 export type { AgentSessionPromptInput, SessionUserMessagePart } from "./types/sdk/AgentSessionPrompt.js";
 export type { AgentSessionStopResult } from "./types/sdk/AgentSessionStop.js";
 export type {

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;
   }
 
   /**

package/src/session/Session.ts

@@ -15,8 +15,8 @@ import type {
   AgentSession,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
   AgentSessionInfo,
   AgentSessionSetInput,
   AgentSessionSystemBlock,
@@ -207,7 +207,7 @@ export class Session implements AgentSession {
   /**
    * 追加一条 user 文本消息。
    */
-  async appendUserMessage(input: {
+  async append_user_message(input: {
     text: string;
   }): Promise<void> {
     await this.stateService.append_user_message({
@@ -218,7 +218,7 @@ export class Session implements AgentSession {
   /**
    * 追加一条 assistant 文本消息。
    */
-  async appendAssistantMessage(input: {
+  async append_assistant_message(input: {
     text: string;
   }): Promise<void> {
     await this.stateService.append_assistant_message({
@@ -229,15 +229,15 @@ export class Session implements AgentSession {
   /**
    * 读取当前 session 详情。
    */
-  async getInfo(): Promise<AgentSessionInfo> {
+  async get_info(): Promise<AgentSessionInfo> {
     return await this.viewService.get_info();
   }
 
   /**
-   * 读取当前 session 历史分页。
+   * 读取当前 session records 分页。
    */
-  async history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage> {
-    return await this.viewService.history(input);
+  async records(input?: AgentSessionRecordsInput): Promise<AgentSessionRecordsPage> {
+    return await this.viewService.records(input);
   }
 
   /**
@@ -288,10 +288,10 @@ export class Session implements AgentSession {
       afterSessionUpdatedAsync: async () => {
         await this.executor.afterSessionUpdatedAsync();
       },
-      appendUserMessage: async (message_params) => {
+      append_user_message: async (message_params) => {
         await this.stateService.append_user_message(message_params);
       },
-      appendAssistantMessage: async (message_params) => {
+      append_assistant_message: async (message_params) => {
         await this.stateService.append_assistant_message(message_params);
       },
       isExecuting: () => this.isExecuting(),

package/src/session/SessionTitle.ts

@@ -9,7 +9,8 @@
 
 import { generateText, type LanguageModel } from "ai";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
+import { is_session_message_record } from "@/executor/types/SessionRecords.js";
 import {
   normalizeSessionTitle,
   readSessionMetadata,
@@ -40,7 +41,7 @@ export interface EnsureSessionTitleParams {
   /**
    * 当前 session 已落盘消息。
    */
-  messages: SessionMessageV1[];
+  messages: SessionRecordV1[];
 
   /**
    * 可选模型实例；传入时会尝试生成更短标题。
@@ -60,7 +61,8 @@ function truncateTitle(input: string, maxChars: number): string {
   return title.slice(0, maxChars).trimEnd();
 }
 
-function extractTextFromMessage(message: SessionMessageV1): string {
+function extractTextFromMessage(message: SessionRecordV1): string {
+  if (!is_session_message_record(message)) return "";
   if (!Array.isArray(message.parts)) return "";
   const texts: string[] = [];
   for (const part of message.parts) {
@@ -74,8 +76,9 @@ function extractTextFromMessage(message: SessionMessageV1): string {
   return texts.join("\n").trim();
 }
 
-function resolveFirstUserText(messages: SessionMessageV1[]): string {
+function resolveFirstUserText(messages: SessionRecordV1[]): string {
   for (const message of messages) {
+    if (!is_session_message_record(message)) continue;
     if (message.role !== "user") continue;
     const text = extractTextFromMessage(message);
     if (text) return text;

package/src/session/browse/Browse.ts

@@ -17,19 +17,24 @@ import {
 } from "ai";
 import type {
   AgentListSessionsInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
-  AgentSessionHistoryView,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
+  AgentSessionRecordsView,
   AgentSessionInfo,
   AgentSessionSummary,
   AgentSessionSummaryPage,
   AgentSessionTimelineEvent,
 } from "@/types/agent/AgentTypes.js";
 import type {
-  SessionMessageV1,
+  SessionActionRecordV1,
+  SessionRecordV1,
   SessionMetadataV1,
-} from "@/executor/types/SessionMessages.js";
-import { isSessionOperationMessage } from "@/executor/types/SessionMessages.js";
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
+import {
+  is_session_action_record,
+  is_session_message_record,
+} from "@/executor/types/SessionRecords.js";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
 import { pickLastSuccessfulChatSendText } from "@/executor/messages/UserVisibleText.js";
 import { getSdkAgentSessionMessagesPath } from "@/session/storage/Paths.js";
@@ -76,7 +81,7 @@ type SessionBrowseBaseInput = {
   /**
    * 当前 session 已读取到的完整消息。
    */
-  messages: SessionMessageV1[];
+  messages: SessionRecordV1[];
 
   /**
    * 当前 session 是否正在执行。
@@ -172,7 +177,7 @@ function extractMessageText(parts: unknown): string {
   return texts.join("\n").trim();
 }
 
-function extractAssistantToolSummary(message: SessionMessageV1): string {
+function extractAssistantToolSummary(message: SessionMessageRecordV1): string {
   if (!Array.isArray(message.parts)) return "";
   const toolNames = new Set<string>();
   for (const part of message.parts as AnyUiPart[]) {
@@ -188,7 +193,13 @@ function extractAssistantToolSummary(message: SessionMessageV1): string {
 /**
  * 解析单条 session 消息的用户可见预览文本。
  */
-export function resolveSessionMessagePreview(message: SessionMessageV1): string {
+export function resolveSessionMessagePreview(message: SessionRecordV1): string {
+  if (is_session_action_record(message)) {
+    return message.description
+      ? `${message.title}\n${message.description}`
+      : message.title;
+  }
+  if (!is_session_message_record(message)) return "";
   const plainText = extractMessageText(message.parts);
   if (plainText) return plainText;
   if (message.role !== "assistant") return "";
@@ -226,7 +237,7 @@ function extractToolResultOutput(part: ToolPartCompatShape): unknown {
 }
 
 function toTimelineEvent(params: {
-  message: SessionMessageV1;
+  message: SessionMessageRecordV1;
   role: AgentSessionTimelineEvent["role"];
   text: string;
   sequence: number;
@@ -241,15 +252,21 @@ function toTimelineEvent(params: {
     ...(typeof metadata?.source === "string" ? { source: metadata.source } : {}),
     text: params.text,
     ...(params.toolName ? { toolName: params.toolName } : {}),
-    ...(params.role === "operation" && metadata?.operation?.operationId
-      ? { operationId: metadata.operation.operationId }
-      : {}),
-    ...(params.role === "operation" && metadata?.operation?.name
-      ? { operationName: metadata.operation.name }
-      : {}),
-    ...(params.role === "operation" && metadata?.operation?.status
-      ? { operationStatus: metadata.operation.status }
-      : {}),
+  };
+}
+
+function toActionTimelineEvent(
+  message: SessionActionRecordV1,
+): AgentSessionTimelineEvent {
+  const metadata = message.metadata || null;
+  return {
+    id: `${String(message.id || "")}:0`,
+    role: "action",
+    ...(typeof metadata?.ts === "number" ? { ts: metadata.ts } : {}),
+    text: resolveSessionMessagePreview(message),
+    actionTitle: message.title,
+    ...(message.description ? { actionDescription: message.description } : {}),
+    actionState: message.state,
   };
 }
 
@@ -257,23 +274,13 @@ function toTimelineEvent(params: {
  * 把单条 session message 展平成时间线事件。
  */
 export function toSessionTimelineEvents(
-  message: SessionMessageV1,
+  message: SessionRecordV1,
 ): AgentSessionTimelineEvent[] {
-  if (isSessionOperationMessage(message)) {
-    const metadata = (message.metadata || null) as SessionMetadataV1 | null;
-    if (metadata?.operation?.status !== "finished") return [];
-    return [
-      toTimelineEvent({
-        message,
-        role: "operation",
-        text:
-          String(metadata?.operation?.label || "").trim() ||
-          resolveSessionMessagePreview(message),
-        sequence: 0,
-      }),
-    ];
+  if (is_session_action_record(message)) {
+    return [toActionTimelineEvent(message)];
   }
 
+  if (!is_session_message_record(message)) return [];
   if (message.role !== "assistant") {
     return [
       toTimelineEvent({
@@ -359,19 +366,20 @@ export function toSessionTimelineEvents(
  */
 export async function loadSessionMessagesFromPath(
   filePath: string,
-): Promise<SessionMessageV1[]> {
-  const messages: SessionMessageV1[] = [];
+): Promise<SessionRecordV1[]> {
+  const messages: SessionRecordV1[] = [];
   if (await fs.pathExists(filePath)) {
     const raw = await fs.readFile(filePath, "utf-8");
     const lines = raw.split("\n").filter(Boolean);
     for (const line of lines) {
       try {
-        const parsed = JSON.parse(line) as SessionMessageV1;
+        const parsed = JSON.parse(line) as SessionRecordV1;
         if (!parsed || typeof parsed !== "object") continue;
+        const candidate = parsed as { type?: unknown; role?: unknown };
         if (
-          parsed.role !== "user" &&
-          parsed.role !== "assistant" &&
-          parsed.role !== "operation"
+          candidate.type !== "action" &&
+          candidate.role !== "user" &&
+          candidate.role !== "assistant"
         ) {
           continue;
         }
@@ -385,10 +393,9 @@ export async function loadSessionMessagesFromPath(
   const inflight_path = filePath.replace(/messages\.jsonl$/, "inflight.json");
   if (await fs.pathExists(inflight_path)) {
     try {
-      const parsed = (await fs.readJson(inflight_path)) as SessionMessageV1;
+      const parsed = (await fs.readJson(inflight_path)) as SessionRecordV1;
       if (
-        parsed &&
-        typeof parsed === "object" &&
+        is_session_message_record(parsed) &&
         parsed.role === "assistant" &&
         Array.isArray(parsed.parts)
       ) {
@@ -411,20 +418,20 @@ export async function loadSessionMessagesFromPath(
  */
 export async function loadSessionArchiveMessagesFromPath(
   filePath: string,
-): Promise<SessionMessageV1[]> {
+): Promise<SessionRecordV1[]> {
   try {
     const raw = (await fs.readJson(filePath)) as SessionArchiveFileV1 | null;
     const items = Array.isArray(raw?.messages) ? raw.messages : [];
-    return items.filter((item): item is SessionMessageV1 => {
+    return items.filter((item): item is SessionRecordV1 => {
       if (!item || typeof item !== "object") return false;
-      const candidate = item as Partial<SessionMessageV1>;
+      const candidate = item as { type?: unknown; role?: unknown; parts?: unknown };
       return (
         (
+          candidate.type === "action" ||
           candidate.role === "user" ||
-          candidate.role === "assistant" ||
-          candidate.role === "operation"
+          candidate.role === "assistant"
         ) &&
-        Array.isArray(candidate.parts)
+        (candidate.type === "action" || Array.isArray(candidate.parts))
       );
     });
   } catch {
@@ -432,12 +439,13 @@ export async function loadSessionArchiveMessagesFromPath(
   }
 }
 
-function isCompactSummaryMessage(message: SessionMessageV1): boolean {
+function isCompactSummaryMessage(message: SessionRecordV1): boolean {
+  if (!is_session_message_record(message)) return false;
   const metadata = (message.metadata || null) as SessionMetadataV1 | null;
   return metadata?.source === "compact" || metadata?.kind === "summary";
 }
 
-function resolvePreviousArchiveId(messages: SessionMessageV1[]): string | undefined {
+function resolvePreviousArchiveId(messages: SessionRecordV1[]): string | undefined {
   for (const message of messages) {
     if (!isCompactSummaryMessage(message)) continue;
     const metadata = (message.metadata || null) as SessionMetadataV1 | null;
@@ -448,8 +456,8 @@ function resolvePreviousArchiveId(messages: SessionMessageV1[]): string | undefi
 }
 
 function filterUserVisibleHistoryMessages(
-  messages: SessionMessageV1[],
-): SessionMessageV1[] {
+  messages: SessionRecordV1[],
+): SessionRecordV1[] {
   return messages.filter((message) => !isCompactSummaryMessage(message));
 }
 
@@ -492,14 +500,14 @@ export function buildSessionInfo(
 }
 
 /**
- * 基于完整消息列表构建 session history 分页结果。
+ * 基于完整消息列表构建 session records 分页结果。
  */
-export function buildSessionHistoryPage(params: {
+export function buildSessionRecordsPage(params: {
   session: AgentSessionInfo;
-  messages: SessionMessageV1[];
-  input?: AgentSessionHistoryInput;
-}): AgentSessionHistoryPage {
-  const view: AgentSessionHistoryView = params.input?.view || "message";
+  messages: SessionRecordV1[];
+  input?: AgentSessionRecordsInput;
+}): AgentSessionRecordsPage {
+  const view: AgentSessionRecordsView = params.input?.view || "message";
   const order = params.input?.order || "asc";
   const limit = normalizeLimit(params.input?.limit, 50, 500);
   const cursor = normalizeCursor(params.input?.cursor);

package/src/session/index.ts

@@ -46,7 +46,7 @@ export {
   createRuntimeSessionPort,
 } from "./storage/RuntimeSessionPort.js";
 export {
-  buildSessionHistoryPage,
+  buildSessionRecordsPage,
   buildSessionInfo,
   listArchivedAgentSessionSummaryPage,
   listAgentSessionSummaryPage,