@downcity/agent 1.1.200 → 1.1.202

package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.js

@@ -0,0 +1,181 @@
+/**
+ * JsonlSessionCompactionFileOperations：上下文压缩文件操作记录模块。
+ *
+ * 关键点（中文）
+ * - 从被压缩的 session 消息中 best-effort 提取文件读写痕迹。
+ * - 输出结构化 XML 片段，追加到 LLM 生成的 compact summary 末尾。
+ * - 解析失败或没有文件操作时不影响 compact 主流程。
+ */
+import { isTextUIPart } from "ai";
+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) {
+    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) {
+    const read_files = new Set();
+    const modified_files = new Set();
+    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) {
+    const out = [];
+    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) {
+    const out = new Set();
+    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) {
+    const out = new Set();
+    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, pattern) {
+    const out = [];
+    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) {
+    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) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    return value;
+}
+/**
+ * 将未知结构紧凑地转为文本。
+ */
+function stringify_compact(value) {
+    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) {
+    return String(value || "")
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=JsonlSessionCompactionFileOperations.js.map

package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonlSessionCompactionFileOperations.js","sourceRoot":"","sources":["../../../../../src/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.ts"],"names":[],"mappings":"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"}

package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.d.ts

@@ -0,0 +1,45 @@
+/**
+ * JsonlSessionCompactionPrompts：上下文压缩提示词模块。
+ *
+ * 关键点（中文）
+ * - 统一维护 session compact 使用的 system prompt 与 user prompt。
+ * - 支持初始压缩、迭代更新压缩、turn prefix 压缩三类场景。
+ * - prompt 文本保持结构化格式稳定，便于后续 LLM 继续接力。
+ */
+/**
+ * 上下文压缩 system prompt。
+ */
+export declare const SESSION_COMPACTION_SYSTEM_PROMPT: string;
+/**
+ * 构建初始上下文压缩 prompt。
+ */
+export declare function build_initial_session_compaction_prompt(params: {
+    /** 待压缩的历史对话文本。 */
+    conversation_text: string;
+}): string;
+/**
+ * 构建迭代更新上下文压缩 prompt。
+ */
+export declare function build_update_session_compaction_prompt(params: {
+    /** 已存在的旧摘要。 */
+    previous_summary: string;
+    /** 本次需要合入旧摘要的新对话文本。 */
+    new_conversation_text: string;
+}): string;
+/**
+ * 构建 turn prefix 压缩 prompt。
+ */
+export declare function build_turn_prefix_session_compaction_prompt(params: {
+    /** 被切下来的 turn prefix 文本。 */
+    prefix_text: string;
+}): string;
+/**
+ * 给摘要追加文件操作 XML。
+ */
+export declare function append_session_compaction_file_operations(params: {
+    /** LLM 生成的结构化摘要。 */
+    summary: string;
+    /** 文件操作 XML，空字符串时不追加。 */
+    file_operations_xml?: string;
+}): string;
+//# sourceMappingURL=JsonlSessionCompactionPrompts.d.ts.map

package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonlSessionCompactionPrompts.d.ts","sourceRoot":"","sources":["../../../../../src/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,gCAAgC,QAIjC,CAAC;AAEb;;GAEG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE;IAC9D,kBAAkB;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAqCT;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC7D,eAAe;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,MAAM,CA+CT;AAED;;GAEG;AACH,wBAAgB,2CAA2C,CAAC,MAAM,EAAE;IAClE,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAmBT;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CAAC,MAAM,EAAE;IAChE,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,MAAM,CAMT"}

package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.js

@@ -0,0 +1,144 @@
+/**
+ * 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) {
+    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) {
+    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) {
+    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) {
+    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}`;
+}
+//# sourceMappingURL=JsonlSessionCompactionPrompts.js.map

package/bin/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonlSessionCompactionPrompts.js","sourceRoot":"","sources":["../../../../../src/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.ts"],"names":[],"mappings":"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"}

package/bin/executor/composer/context/LocalSessionContextComposer.d.ts

@@ -7,7 +7,7 @@
  */
 import type { ModelMessage } from "ai";
 import type { SessionContextComposer, SessionContextComposeResult } from "../../composer/context/SessionContextComposer.js";
-import type { SessionMessageV1, SessionModelMessageV1 } from "../../../executor/types/SessionMessages.js";
+import type { 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";
@@ -32,7 +32,7 @@ export declare class LocalSessionContextComposer implements SessionContextCompos
     compose(run_context: SessionRunContext): Promise<SessionContextComposeResult>;
     createPrepareStepHandler(input: {
         system: SessionSystemMessage[];
-        appendMergedUserMessages: (messages: SessionMessageV1[]) => Promise<ModelMessage[]>;
+        appendMergedUserMessages: (messages: SessionRecordV1[]) => Promise<ModelMessage[]>;
         runContext: SessionRunContext;
     }): (input: {
         messages?: ModelMessage[];
@@ -44,7 +44,7 @@ export declare class LocalSessionContextComposer implements SessionContextCompos
     /**
      * 构造 fallback assistant 消息。
      */
-    buildFallbackAssistantMessage(text: string, run_context: SessionRunContext): SessionModelMessageV1;
+    buildFallbackAssistantMessage(text: string, run_context: SessionRunContext): SessionMessageRecordV1;
 }
 export {};
 //# sourceMappingURL=LocalSessionContextComposer.d.ts.map

package/bin/executor/composer/context/LocalSessionContextComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalSessionContextComposer.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/context/LocalSessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,KAAK,kCAAkC,GAAG;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA4B,YAAW,sBAAsB;IACxE,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;gBAE9D,OAAO,EAAE,kCAAkC;IAKjD,OAAO,CACX,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,2BAA2B,CAAC;IAevC,wBAAwB,CACtB,KAAK,EAAE;QACL,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7B,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;IAgDF,yBAAyB,CACvB,WAAW,EAAE,iBAAiB,GAC7B,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC;IAqBzC;;OAEG;IACH,6BAA6B,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,iBAAiB,GAC7B,qBAAqB;CAsBzB"}
+{"version":3,"file":"LocalSessionContextComposer.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/context/LocalSessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,KAAK,kCAAkC,GAAG;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA4B,YAAW,sBAAsB;IACxE,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;gBAE9D,OAAO,EAAE,kCAAkC;IAKjD,OAAO,CACX,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,2BAA2B,CAAC;IAevC,wBAAwB,CACtB,KAAK,EAAE;QACL,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,wBAAwB,EAAE,CACxB,QAAQ,EAAE,eAAe,EAAE,KACxB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7B,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;IAgDF,yBAAyB,CACvB,WAAW,EAAE,iBAAiB,GAC7B,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC;IAqBzC;;OAEG;IACH,6BAA6B,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,iBAAiB,GAC7B,sBAAsB;CAsB1B"}

package/bin/executor/composer/context/SessionContextComposer.d.ts

@@ -6,7 +6,7 @@
  * - 不负责历史读写，不负责 system 解析，不负责 compact。
  */
 import type { ModelMessage, Tool } from "ai";
-import type { SessionMessageV1, SessionModelMessageV1 } from "../../../executor/types/SessionMessages.js";
+import type { SessionRecordV1, SessionMessageRecordV1 } from "../../../executor/types/SessionRecords.js";
 import type { SessionSystemMessage } from "../../../executor/types/SessionPrompts.js";
 import type { SessionRunContext } from "../../../types/executor/SessionRunContext.js";
 /**
@@ -41,7 +41,7 @@ export interface SessionContextComposer {
         /**
          * 将新增 user 消息转换为可追加的模型消息。
          */
-        appendMergedUserMessages: (messages: SessionMessageV1[]) => Promise<ModelMessage[]>;
+        appendMergedUserMessages: (messages: SessionRecordV1[]) => Promise<ModelMessage[]>;
         /**
          * 当前显式运行上下文。
          */
@@ -62,6 +62,6 @@ export interface SessionContextComposer {
      * 关键点（中文）
      * - fallback 消息构造由 ContextComposer 内部实现，Executor 不直接依赖 history Composer。
      */
-    buildFallbackAssistantMessage(text: string, run_context: SessionRunContext): SessionModelMessageV1;
+    buildFallbackAssistantMessage(text: string, run_context: SessionRunContext): SessionMessageRecordV1;
 }
 //# sourceMappingURL=SessionContextComposer.d.ts.map

package/bin/executor/composer/context/SessionContextComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionContextComposer.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/context/SessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAE9E;;OAEG;IACH,wBAAwB,CACtB,KAAK,EAAE;QACL;;WAEG;QACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B;;WAEG;QACH,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7B;;WAEG;QACH,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC,CAAC;IAEH;;OAEG;IACH,yBAAyB,CACvB,WAAW,EAAE,iBAAiB,GAC7B,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,6BAA6B,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,iBAAiB,GAC7B,qBAAqB,CAAC;CAC1B"}
+{"version":3,"file":"SessionContextComposer.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/context/SessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAE9E;;OAEG;IACH,wBAAwB,CACtB,KAAK,EAAE;QACL;;WAEG;QACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B;;WAEG;QACH,wBAAwB,EAAE,CACxB,QAAQ,EAAE,eAAe,EAAE,KACxB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7B;;WAEG;QACH,UAAU,EAAE,iBAAiB,CAAC;KAC/B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC,CAAC;IAEH;;OAEG;IACH,yBAAyB,CACvB,WAAW,EAAE,iBAAiB,GAC7B,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,6BAA6B,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,iBAAiB,GAC7B,sBAAsB,CAAC;CAC3B"}

package/bin/executor/composer/history/SessionHistoryComposer.d.ts

@@ -7,7 +7,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";
 /**
  * prepare 输入参数。
@@ -49,6 +49,6 @@ export interface SessionHistoryComposer {
     /**
      * 为本轮 Session 执行准备模型输入消息。
      */
-    prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
+    prepare(input: SessionHistoryPrepareInput): Promise<SessionRecordV1[]>;
 }
 //# sourceMappingURL=SessionHistoryComposer.d.ts.map

package/bin/executor/composer/history/SessionHistoryComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionHistoryComposer.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzE"}
+{"version":3,"file":"SessionHistoryComposer.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACxE"}

package/bin/executor/composer/history/SessionHistoryWriter.d.ts

@@ -7,7 +7,7 @@
  * - 会话更新后的通知也收在这里，避免把写入细节散到 Session 主类里。
  */
 import type { JsonObject } from "../../../types/common/Json.js";
-import type { SessionMessageV1 } from "../../../executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "../../../executor/types/SessionRecords.js";
 import type { SessionHistoryStore } from "../../../executor/store/history/SessionHistoryStore.js";
 type SessionHistoryWriterOptions = {
     /**
@@ -38,16 +38,16 @@ export declare class SessionHistoryWriter {
     /**
      * 追加一条 user 消息。
      */
-    appendUserMessage(params: {
-        message?: SessionMessageV1 | null;
+    append_user_message(params: {
+        message?: SessionRecordV1 | null;
         text?: string;
         extra?: JsonObject;
     }): Promise<void>;
     /**
      * 追加一条 assistant 消息。
      */
-    appendAssistantMessage(params: {
-        message?: SessionMessageV1 | null;
+    append_assistant_message(params: {
+        message?: SessionRecordV1 | null;
         fallbackText?: string;
         extra?: JsonObject;
     }): Promise<void>;

package/bin/executor/composer/history/SessionHistoryWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionHistoryWriter.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAE3F,KAAK,2BAA2B,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,MAAM,mBAAmB,CAAC;IAE3C;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwD;gBAEpF,OAAO,EAAE,2BAA2B;IAShD;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjB;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BlB"}
+{"version":3,"file":"SessionHistoryWriter.d.ts","sourceRoot":"","sources":["../../../../src/executor/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAE3F,KAAK,2BAA2B,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,MAAM,mBAAmB,CAAC;IAE3C;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwD;gBAEpF,OAAO,EAAE,2BAA2B;IAShD;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjB;;OAEG;IACG,wBAAwB,CAAC,MAAM,EAAE;QACrC,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BlB"}

package/bin/executor/composer/history/SessionHistoryWriter.js

@@ -37,11 +37,11 @@ export class SessionHistoryWriter {
     /**
      * 追加一条 user 消息。
      */
-    async appendUserMessage(params) {
+    async append_user_message(params) {
         try {
             const historyStore = this.getHistoryStore();
             if (params.message && typeof params.message === "object") {
-                await historyStore.append(params.message);
+                await historyStore.write_record(params.message);
                 void this.afterSessionUpdatedAsync();
                 return;
             }
@@ -55,7 +55,7 @@ export class SessionHistoryWriter {
                     extra: params.extra,
                 },
             });
-            await historyStore.append(message);
+            await historyStore.write_record(message);
             void this.afterSessionUpdatedAsync();
         }
         catch {
@@ -65,18 +65,18 @@ export class SessionHistoryWriter {
     /**
      * 追加一条 assistant 消息。
      */
-    async appendAssistantMessage(params) {
+    async append_assistant_message(params) {
         try {
             const historyStore = this.getHistoryStore();
             if (params.message && typeof params.message === "object") {
-                await historyStore.finalizeInflight(params.message);
+                await historyStore.finalize_inflight(params.message);
                 void this.afterSessionUpdatedAsync();
                 return;
             }
             const fallbackText = String(params.fallbackText || "").trim();
             if (!fallbackText)
                 return;
-            await historyStore.finalizeInflight(historyStore.assistantText({
+            await historyStore.finalize_inflight(historyStore.assistantText({
                 text: fallbackText,
                 metadata: {
                     sessionId: this.sessionId,

package/bin/executor/composer/history/SessionHistoryWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionHistoryWriter.js","sourceRoot":"","sources":["../../../../src/executor/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionHistoryWriter.js","sourceRoot":"","sources":["../../../../src/executor/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"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"}

package/bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.d.ts

@@ -6,7 +6,7 @@
  * - 不负责 append / list / meta / compact 等落盘能力。
  * - JSONL 文件事实源由 `JsonlSessionHistoryStore` 承担。
  */
-import { type SessionMessageV1 } from "../../../../executor/types/SessionMessages.js";
+import { type SessionRecordV1 } from "../../../../executor/types/SessionRecords.js";
 import type { SessionHistoryStore } from "../../../../executor/store/history/SessionHistoryStore.js";
 import type { SessionHistoryComposer, SessionHistoryPrepareInput } from "../../../composer/history/SessionHistoryComposer.js";
 /**
@@ -30,6 +30,6 @@ export declare class JsonlSessionHistoryComposer implements SessionHistoryCompos
     private readUserSessionMessageText;
     private hasTrailingUserQuery;
     private sanitizeMessages;
-    prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
+    prepare(input: SessionHistoryPrepareInput): Promise<SessionRecordV1[]>;
 }
 //# sourceMappingURL=JsonlSessionHistoryComposer.d.ts.map

package/bin/executor/composer/history/jsonl/JsonlSessionHistoryComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonlSessionHistoryComposer.d.ts","sourceRoot":"","sources":["../../../../../src/executor/composer/history/jsonl/JsonlSessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,KAAK,EACV,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,sDAAsD,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA4B,YAAW,sBAAsB;IACxE,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAEhC,OAAO,EAAE,kCAAkC;IAQvD,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,gBAAgB;IAiBlB,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA6B9E"}
+{"version":3,"file":"JsonlSessionHistoryComposer.d.ts","sourceRoot":"","sources":["../../../../../src/executor/composer/history/jsonl/JsonlSessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,KAAK,EACV,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,sDAAsD,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA4B,YAAW,sBAAsB;IACxE,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAEhC,OAAO,EAAE,kCAAkC;IAQvD,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,0BAA0B;IAkBlC,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,gBAAgB;IAiBlB,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CA6B7E"}