@downcity/agent 1.1.199 → 1.1.202

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts

@@ -18,12 +18,22 @@ import {
 import { generateId } from "@/utils/Id.js";
 import { getLogger } from "@/utils/logger/Logger.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_message_record,
+} from "@/executor/types/SessionRecords.js";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
-import type { AgentSessionOperationRecord } from "@/types/sdk/AgentSessionOperation.js";
+import {
+  append_session_compaction_file_operations,
+  build_initial_session_compaction_prompt,
+  build_update_session_compaction_prompt,
+  SESSION_COMPACTION_SYSTEM_PROMPT,
+} from "@executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.js";
+import { format_session_compaction_file_operations } from "@executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.js";
 
 export type SessionCompactParams = {
   model: LanguageModel;
@@ -32,19 +42,19 @@ export type SessionCompactParams = {
   maxInputTokensApprox: number;
   archiveOnCompact: boolean;
   compactRatio: number;
-  onOperation?: (operation: AgentSessionOperationRecord) => Promise<void>;
+  onAction?: (action: SessionActionRecordV1) => Promise<void>;
 };
 
 type SessionCompactDeps = {
   rootPath: string;
   sessionId: string;
   withWriteLock: <T>(fn: () => Promise<T>) => Promise<T>;
-  loadAll: () => Promise<SessionMessageV1[]>;
+  loadAll: () => Promise<SessionRecordV1[]>;
   createSummaryMessage: (params: {
     text: string;
     archiveId?: string;
     sourceRange?: SessionMetadataV1["sourceRange"];
-  }) => SessionMessageV1;
+  }) => SessionRecordV1;
   getArchiveDirPath: () => string;
   getMessagesFilePath: () => string;
   readMetaUnsafe: () => Promise<SessionHistoryMetaV1>;
@@ -63,17 +73,22 @@ export async function compactSessionMessagesIfNeeded(
   params: SessionCompactParams,
 ): Promise<{ compacted: boolean; reason?: string }> {
   const logger = getLogger(deps.rootPath, "info");
-  const operation_id = `compacting:${deps.sessionId}:${Date.now()}:${generateId()}`;
-  let operation_started = false;
+  const action_id = `compacting:${deps.sessionId}:${Date.now()}:${generateId()}`;
+  let action_started = false;
 
-  const publish_operation = async (
-    operation: Omit<AgentSessionOperationRecord, "operationId" | "name">,
+  const publish_action = async (
+    action: Omit<SessionActionRecordV1, "type" | "id" | "metadata">,
   ): Promise<void> => {
-    if (typeof params.onOperation !== "function") return;
-    await params.onOperation({
-      operationId: operation_id,
-      name: "compacting",
-      ...operation,
+    if (typeof params.onAction !== "function") return;
+    await params.onAction({
+      type: "action",
+      id: action_id,
+      ...action,
+      metadata: {
+        v: 1,
+        ts: Date.now(),
+        sessionId: deps.sessionId,
+      },
     });
   };
 
@@ -81,12 +96,10 @@ export async function compactSessionMessagesIfNeeded(
   // phase 1：snapshot（短锁）
   // - 仅负责拿一致性快照，不做耗时的模型调用。
   // - 目的是把锁持有时间降到最低。
-  let snapshot: SessionMessageV1[] = [];
+  let snapshot: SessionMessageRecordV1[] = [];
   let snapshotTailId = "";
   await deps.withWriteLock(async () => {
-    snapshot = (await deps.loadAll()).filter(
-      (message) => !isSessionOperationMessage(message),
-    );
+    snapshot = (await deps.loadAll()).filter(is_session_message_record);
     snapshotTailId =
       snapshot.length > 0
         ? String(snapshot[snapshot.length - 1].id || "")
@@ -118,19 +131,29 @@ export async function compactSessionMessagesIfNeeded(
   const older = snapshot.slice(0, compactCount);
   if (older.length === 0) return { compacted: false, reason: "nothing_to_compact" };
 
-  operation_started = true;
-  await publish_operation({
-    status: "started",
-    label: "Compacting session history",
-    progress: 0,
+  action_started = true;
+  await publish_action({
+    title: "Compacting session records",
+    state: "running",
   });
 
-  const olderTextAll = extractPlainTextFromMessages(older);
+  const previous_summary = extract_existing_compaction_summary(older[0]);
+  const conversation_messages = previous_summary ? older.slice(1) : older;
+  const olderTextAll = extractPlainTextFromMessages(conversation_messages);
   const maxOlderChars = 24_000;
   const olderText =
     olderTextAll.length > maxOlderChars
       ? "（注意：更早历史过长，已截断保留末尾）\n" + olderTextAll.slice(-maxOlderChars)
       : olderTextAll;
+  const prompt = previous_summary
+    ? build_update_session_compaction_prompt({
+        previous_summary,
+        new_conversation_text: olderText || "(none)",
+      })
+    : build_initial_session_compaction_prompt({
+        conversation_text: olderText || "(none)",
+      });
+  const file_operations_xml = format_session_compaction_file_operations(older);
 
   // phase 1.5：生成摘要（不持锁）
   // - 这一步最耗时，必须在锁外执行，避免阻塞 append。
@@ -141,18 +164,15 @@ export async function compactSessionMessagesIfNeeded(
       system: [
         {
           role: "system",
-          content:
-            "你是对话压缩助手。请把更早的对话历史压缩成“可持续复用”的工作摘要。\n" +
-            "要求：\n" +
-            "- 输出中文\n" +
-            "- 不要复述无关细节，不要输出工具原始日志\n" +
-            "- 必须包含：已确认事实/用户偏好约束/已做决策/未完成事项\n" +
-            "- 使用 Markdown 列表，控制在 300~800 字",
+          content: SESSION_COMPACTION_SYSTEM_PROMPT,
         },
       ],
-      prompt: `请压缩以下更早历史（按 user/assistant 交替记录）：\n\n${olderText}`,
+      prompt,
+    });
+    summary = append_session_compaction_file_operations({
+      summary: String(r.text || "").trim(),
+      file_operations_xml,
     });
-    summary = String(r.text || "").trim();
   } catch (e) {
     await logger.log(
       "warn",
@@ -162,12 +182,14 @@ export async function compactSessionMessagesIfNeeded(
         error: String(e),
       },
     );
-    summary = "（系统自动压缩：摘要生成失败，已丢弃更早历史，仅保留最近对话。）";
-    await publish_operation({
-      status: "progress",
-      label: "Compacting session history",
-      reason: "summary_fallback",
-      progress: 0.5,
+    summary = append_session_compaction_file_operations({
+      summary: "（系统自动压缩：摘要生成失败，已丢弃更早历史，仅保留最近对话。）",
+      file_operations_xml,
+    });
+    await publish_action({
+      title: "Compacting session records",
+      description: "Summary generation failed; using a fallback summary.",
+      state: "running",
     });
   }
 
@@ -191,7 +213,7 @@ export async function compactSessionMessagesIfNeeded(
     void snapshotTailId;
 
     const current_model_messages = current.filter(
-      (message) => !isSessionOperationMessage(message),
+      is_session_message_record,
     );
     const currentCompactCount = resolveCompactCount(
       current_model_messages.length,
@@ -242,15 +264,11 @@ export async function compactSessionMessagesIfNeeded(
     });
   });
 
-  if (operation_started) {
-    await publish_operation({
-      status: "finished",
-      label: "Session history compacted",
-      progress: 1,
-      result: {
-        archiveId,
-        compactedCount: older.length,
-      },
+  if (action_started) {
+    await publish_action({
+      title: "Session records compacted",
+      description: `Compacted ${String(older.length)} earlier messages into ${archiveId}.`,
+      state: "completed",
     });
   }
 
@@ -302,7 +320,7 @@ function estimateTokensApproxFromText(text: string): number {
  * - 统一把 user / assistant 内容线性化，作为 compact 摘要输入。
  * - tool 原始结构不会原样输出，避免把噪声日志喂给摘要模型。
  */
-function extractPlainTextFromMessages(messages: SessionMessageV1[]): string {
+function extractPlainTextFromMessages(messages: SessionMessageRecordV1[]): string {
   const lines: string[] = [];
   for (const m of messages) {
     if (!m || typeof m !== "object") continue;
@@ -315,3 +333,24 @@ function extractPlainTextFromMessages(messages: SessionMessageV1[]): string {
   }
   return lines.join("\n");
 }
+
+/**
+ * 从已有 compact summary 消息中提取旧摘要。
+ *
+ * 关键点（中文）
+ * - 旧摘要通常位于 messages.jsonl 第一条，后续 compact 应基于它迭代更新。
+ * - 只识别 compact 生成的 summary，避免误把普通 assistant 文本当作旧摘要。
+ */
+function extract_existing_compaction_summary(
+  message: SessionMessageRecordV1 | undefined,
+): string {
+  if (!message || typeof message !== "object") return "";
+  const metadata = message.metadata;
+  if (metadata?.source !== "compact" || metadata.kind !== "summary") return "";
+  const parts = Array.isArray(message.parts) ? message.parts : [];
+  return parts
+    .filter(isTextUIPart)
+    .map((part) => String(part.text ?? ""))
+    .join("\n")
+    .trim();
+}

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.ts

@@ -0,0 +1,197 @@
+/**
+ * JsonlSessionCompactionFileOperations：上下文压缩文件操作记录模块。
+ *
+ * 关键点（中文）
+ * - 从被压缩的 session 消息中 best-effort 提取文件读写痕迹。
+ * - 输出结构化 XML 片段，追加到 LLM 生成的 compact summary 末尾。
+ * - 解析失败或没有文件操作时不影响 compact 主流程。
+ */
+
+import { isTextUIPart } from "ai";
+import type { SessionMessageRecordV1 } from "@/executor/types/SessionRecords.js";
+
+/**
+ * 压缩范围内的文件操作汇总。
+ */
+export type SessionCompactionFileOperations = {
+  /** 本次压缩范围内被读取或查看过的文件路径。 */
+  read_files: string[];
+  /** 本次压缩范围内被新增、修改或删除过的文件路径。 */
+  modified_files: string[];
+};
+
+type UnknownRecord = Record<string, unknown>;
+
+const PATH_CANDIDATE_RE =
+  /(?:\.{1,2}\/|\/|[A-Za-z0-9_.@-]+\/)[A-Za-z0-9_.@~:+/=-]+/g;
+const PATCH_FILE_RE = /^\*\*\* (?:Add|Update|Delete) File: (.+)$/gm;
+const GIT_STATUS_FILE_RE = /^\s*(?:[MADRCU?!]{1,2}|[ MADRCU?!][ MADRCU?!])\s+(.+)$/gm;
+const READ_COMMAND_RE =
+  /\b(?:cat|less|more|sed|nl|head|tail|rg|grep|find|ls|wc|stat|open|git\s+(?:show|diff|status|grep|ls-files))\b/;
+
+/**
+ * 把压缩范围内的文件操作格式化为 XML。
+ */
+export function format_session_compaction_file_operations(
+  messages: SessionMessageRecordV1[],
+): string {
+  const operations = collect_session_compaction_file_operations(messages);
+  if (operations.read_files.length === 0 && operations.modified_files.length === 0) {
+    return "";
+  }
+  return [
+    "<read-files>",
+    ...operations.read_files.map((file_path) => xml_escape(file_path)),
+    "</read-files>",
+    "",
+    "<modified-files>",
+    ...operations.modified_files.map((file_path) => xml_escape(file_path)),
+    "</modified-files>",
+  ].join("\n");
+}
+
+/**
+ * 收集压缩范围内的文件操作。
+ */
+export function collect_session_compaction_file_operations(
+  messages: SessionMessageRecordV1[],
+): SessionCompactionFileOperations {
+  const read_files = new Set<string>();
+  const modified_files = new Set<string>();
+
+  for (const message of Array.isArray(messages) ? messages : []) {
+    const text_blocks = extract_message_operation_texts(message);
+    for (const text of text_blocks) {
+      for (const file_path of extract_modified_files(text)) {
+        modified_files.add(file_path);
+      }
+      for (const file_path of extract_read_files(text)) {
+        read_files.add(file_path);
+      }
+    }
+  }
+
+  for (const file_path of modified_files) {
+    read_files.delete(file_path);
+  }
+
+  return {
+    read_files: [...read_files].sort(),
+    modified_files: [...modified_files].sort(),
+  };
+}
+
+/**
+ * 提取单条消息中可能包含文件操作的文本块。
+ */
+function extract_message_operation_texts(message: SessionMessageRecordV1): string[] {
+  const out: string[] = [];
+  const parts = Array.isArray(message.parts) ? message.parts : [];
+  for (const part of parts) {
+    if (isTextUIPart(part)) {
+      const text = String(part.text ?? "").trim();
+      if (text) out.push(text);
+      continue;
+    }
+    const part_record = to_record(part);
+    if (!part_record) continue;
+    const input_text = stringify_compact(part_record.input);
+    const output_text = stringify_compact(part_record.output);
+    const error_text = stringify_compact(part_record.errorText);
+    if (input_text) out.push(input_text);
+    if (output_text) out.push(output_text);
+    if (error_text) out.push(error_text);
+  }
+  return out;
+}
+
+/**
+ * 提取 patch / git status 中的修改文件。
+ */
+function extract_modified_files(text: string): string[] {
+  const out = new Set<string>();
+  for (const file_path of match_group_values(text, PATCH_FILE_RE)) {
+    const normalized = normalize_file_path(file_path);
+    if (normalized) out.add(normalized);
+  }
+  for (const file_path of match_group_values(text, GIT_STATUS_FILE_RE)) {
+    const normalized = normalize_file_path(file_path);
+    if (normalized) out.add(normalized);
+  }
+  return [...out];
+}
+
+/**
+ * 从读命令文本中提取读取路径。
+ */
+function extract_read_files(text: string): string[] {
+  const out = new Set<string>();
+  const lines = String(text || "").split(/\r?\n/);
+  for (const line of lines) {
+    if (!READ_COMMAND_RE.test(line)) continue;
+    for (const candidate of line.match(PATH_CANDIDATE_RE) || []) {
+      const normalized = normalize_file_path(candidate);
+      if (normalized) out.add(normalized);
+    }
+  }
+  return [...out];
+}
+
+/**
+ * 获取正则第一个捕获组的所有结果。
+ */
+function match_group_values(text: string, pattern: RegExp): string[] {
+  const out: string[] = [];
+  pattern.lastIndex = 0;
+  let match = pattern.exec(text);
+  while (match) {
+    const value = String(match[1] || "").trim();
+    if (value) out.push(value);
+    match = pattern.exec(text);
+  }
+  return out;
+}
+
+/**
+ * 归一化候选路径。
+ */
+function normalize_file_path(value: string): string {
+  let file_path = String(value || "").trim();
+  if (!file_path || file_path.includes("://")) return "";
+  file_path = file_path.replace(/^["'`]+|["'`]+$/g, "");
+  file_path = file_path.replace(/[),.;:]+$/g, "");
+  if (!file_path || file_path === "." || file_path === "..") return "";
+  if (file_path.startsWith("-")) return "";
+  return file_path;
+}
+
+/**
+ * 转成对象记录。
+ */
+function to_record(value: unknown): UnknownRecord | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value as UnknownRecord;
+}
+
+/**
+ * 将未知结构紧凑地转为文本。
+ */
+function stringify_compact(value: unknown): string {
+  if (value === undefined || value === null) return "";
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+
+/**
+ * XML 文本转义。
+ */
+function xml_escape(value: string): string {
+  return String(value || "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.ts

@@ -0,0 +1,162 @@
+/**
+ * JsonlSessionCompactionPrompts：上下文压缩提示词模块。
+ *
+ * 关键点（中文）
+ * - 统一维护 session compact 使用的 system prompt 与 user prompt。
+ * - 支持初始压缩、迭代更新压缩、turn prefix 压缩三类场景。
+ * - prompt 文本保持结构化格式稳定，便于后续 LLM 继续接力。
+ */
+
+/**
+ * 上下文压缩 system prompt。
+ */
+export const SESSION_COMPACTION_SYSTEM_PROMPT = [
+  "You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, then produce a structured summary following the exact format specified.",
+  "",
+  "Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.",
+].join("\n");
+
+/**
+ * 构建初始上下文压缩 prompt。
+ */
+export function build_initial_session_compaction_prompt(params: {
+  /** 待压缩的历史对话文本。 */
+  conversation_text: string;
+}): string {
+  return [
+    String(params.conversation_text || "").trim(),
+    "",
+    "The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.",
+    "",
+    "Use this EXACT format:",
+    "",
+    "## Goal",
+    "[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]",
+    "",
+    "## Constraints & Preferences",
+    "- [Any constraints, preferences, or requirements mentioned by user]",
+    '- [Or "(none)" if none were mentioned]',
+    "",
+    "## Progress",
+    "### Done",
+    "- [x] [Completed tasks/changes]",
+    "",
+    "### In Progress",
+    "- [ ] [Current work]",
+    "",
+    "### Blocked",
+    "[Issues preventing progress, if any]",
+    "",
+    "## Key Decisions",
+    "- **[Decision]**: [Brief rationale]",
+    "",
+    "## Next Steps",
+    "1. [Ordered list of what should happen next]",
+    "",
+    "## Critical Context",
+    "- [Any data, examples, or references needed to continue]",
+    '- [Or "(none)" if not applicable]',
+    "",
+    "Keep each section concise. Preserve exact file paths, function names, and error messages.",
+  ].join("\n");
+}
+
+/**
+ * 构建迭代更新上下文压缩 prompt。
+ */
+export function build_update_session_compaction_prompt(params: {
+  /** 已存在的旧摘要。 */
+  previous_summary: string;
+  /** 本次需要合入旧摘要的新对话文本。 */
+  new_conversation_text: string;
+}): string {
+  return [
+    "<previous-summary>",
+    String(params.previous_summary || "").trim(),
+    "</previous-summary>",
+    "",
+    String(params.new_conversation_text || "").trim(),
+    "",
+    "The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.",
+    "",
+    "Update the existing structured summary with new information. RULES:",
+    "- PRESERVE all existing information from the previous summary",
+    "- ADD new progress, decisions, and context from the new messages",
+    '- UPDATE the Progress section: move items from "In Progress" to "Done" when completed',
+    '- UPDATE "Next Steps" based on what was accomplished',
+    "- PRESERVE exact file paths, function names, and error messages",
+    "- If something is no longer relevant, you may remove it",
+    "",
+    "Use this EXACT format:",
+    "",
+    "## Goal",
+    "[Preserve existing goals, add new ones if the task expanded]",
+    "",
+    "## Constraints & Preferences",
+    "- [Preserve existing, add new ones discovered]",
+    "",
+    "## Progress",
+    "### Done",
+    "- [x] [Include previously done items AND newly completed items]",
+    "",
+    "### In Progress",
+    "- [ ] [Current work - update based on progress]",
+    "",
+    "### Blocked",
+    "[Current blockers - remove if resolved]",
+    "",
+    "## Key Decisions",
+    "- **[Decision]**: [Brief rationale] (preserve all previous, add new)",
+    "",
+    "## Next Steps",
+    "1. [Update based on current state]",
+    "",
+    "## Critical Context",
+    "- [Preserve important context, add new if needed]",
+    "",
+    "Keep each section concise. Preserve exact file paths, function names, and error messages.",
+  ].join("\n");
+}
+
+/**
+ * 构建 turn prefix 压缩 prompt。
+ */
+export function build_turn_prefix_session_compaction_prompt(params: {
+  /** 被切下来的 turn prefix 文本。 */
+  prefix_text: string;
+}): string {
+  return [
+    String(params.prefix_text || "").trim(),
+    "",
+    "This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.",
+    "",
+    "Summarize the prefix to provide context for the retained suffix:",
+    "",
+    "## Original Request",
+    "[What did the user ask for in this turn?]",
+    "",
+    "## Early Progress",
+    "- [Key decisions and work done in the prefix]",
+    "",
+    "## Context for Suffix",
+    "- [Information needed to understand the retained recent work]",
+    "",
+    "Be concise. Focus on what's needed to understand the kept suffix.",
+  ].join("\n");
+}
+
+/**
+ * 给摘要追加文件操作 XML。
+ */
+export function append_session_compaction_file_operations(params: {
+  /** LLM 生成的结构化摘要。 */
+  summary: string;
+  /** 文件操作 XML，空字符串时不追加。 */
+  file_operations_xml?: string;
+}): string {
+  const summary = String(params.summary || "").trim();
+  const file_operations_xml = String(params.file_operations_xml || "").trim();
+  if (!file_operations_xml) return summary;
+  if (!summary) return file_operations_xml;
+  return `${summary}\n\n${file_operations_xml}`;
+}

package/src/executor/composer/context/LocalSessionContextComposer.ts

@@ -13,9 +13,9 @@ import type {
   SessionContextComposeResult,
 } from "@executor/composer/context/SessionContextComposer.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionRecordV1,
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { Tool } from "ai";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
@@ -66,7 +66,7 @@ export class LocalSessionContextComposer implements SessionContextComposer {
     input: {
       system: SessionSystemMessage[];
       appendMergedUserMessages: (
-        messages: SessionMessageV1[],
+        messages: SessionRecordV1[],
       ) => Promise<ModelMessage[]>;
       runContext: SessionRunContext;
     },
@@ -150,7 +150,7 @@ export class LocalSessionContextComposer implements SessionContextComposer {
   buildFallbackAssistantMessage(
     text: string,
     run_context: SessionRunContext,
-  ): SessionModelMessageV1 {
+  ): SessionMessageRecordV1 {
     const sessionId = String(
       run_context.sessionId || this.sessionId || "",
     ).trim();

package/src/executor/composer/context/SessionContextComposer.ts

@@ -8,9 +8,9 @@
 
 import type { ModelMessage, Tool } from "ai";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionRecordV1,
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
 
@@ -51,7 +51,7 @@ export interface SessionContextComposer {
        * 将新增 user 消息转换为可追加的模型消息。
        */
       appendMergedUserMessages: (
-        messages: SessionMessageV1[],
+        messages: SessionRecordV1[],
       ) => Promise<ModelMessage[]>;
       /**
        * 当前显式运行上下文。
@@ -79,5 +79,5 @@ export interface SessionContextComposer {
   buildFallbackAssistantMessage(
     text: string,
     run_context: SessionRunContext,
-  ): SessionModelMessageV1;
+  ): SessionMessageRecordV1;
 }

package/src/executor/composer/history/SessionHistoryComposer.ts

@@ -8,7 +8,7 @@
  */
 
 import type { LanguageModel, Tool } from "ai";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
 
 /**
@@ -58,5 +58,5 @@ export interface SessionHistoryComposer {
   /**
    * 为本轮 Session 执行准备模型输入消息。
    */
-  prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
+  prepare(input: SessionHistoryPrepareInput): Promise<SessionRecordV1[]>;
 }