@downcity/agent 1.1.430 → 1.1.437

package/bin/types/session/SessionSegment.js

@@ -1,8 +0,0 @@
-/**
- * Session Message 物理分段类型。
- *
- * Segment 保存一段连续的原始 Message，并在文件末尾保存覆盖到该段末尾的累计 Summary。
- * Summary 只服务模型上下文，不占用 Session Message sequence。
- */
-export {};
-//# sourceMappingURL=SessionSegment.js.map

package/bin/types/session/SessionSegment.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionSegment.js","sourceRoot":"","sources":["../../../src/types/session/SessionSegment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/types/store/SessionDataStore.d.ts

@@ -1,88 +0,0 @@
-/**
- * 单个 Session 数据存储类型。
- *
- * 关键点（中文）
- * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
- * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
- */
-import type { SessionHistoryMeta } from "../../executor/types/SessionHistoryMeta.js";
-import type { SessionAssistantMessage, SessionMessage } from "@downcity/type";
-import type { SessionMessageStorageStats, SessionSegmentRange, SessionSegmentSnapshot, SessionSegmentSummary } from "../../types/session/SessionSegment.js";
-import type { SessionAttachmentStore } from "../../types/store/SessionAttachmentStore.js";
-import type { SessionOrigin } from "@downcity/type";
-/** 在 Message Store 写事务中创建新消息所需的稳定状态。 */
-export interface SessionMessageCommitState {
-    /** 下一条真实 Message 应使用的全局线性顺序。 */
-    message_sequence: number;
-    /** 当前 Active 与 Assistant 草稿组成的运行态 Message。 */
-    messages: SessionMessage[];
-}
-/** Active Message 压缩提交参数。 */
-export interface CompactActiveMessagesInput {
-    /** 移入新 Segment 的最后一条真实 Message sequence。 */
-    through_sequence: number;
-    /** 写入新 Segment 末尾的累计上下文摘要。 */
-    summary: SessionSegmentSummary;
-}
-/** Active Message 压缩提交结果。 */
-export interface CompactActiveMessagesResult {
-    /** 本次创建的不可变历史分段。 */
-    segment: SessionSegmentSnapshot;
-    /** 压缩后继续保留在 Active 区域的 Message。 */
-    active_messages: SessionMessage[];
-}
-/** Session Message 持久化能力。 */
-export interface SessionMessageStore {
-    /** 初始化消息存储，并修复可恢复的中断状态。 */
-    initialize(): Promise<void>;
-    /** 读取当前 Active Message 与运行中的 Assistant 草稿。 */
-    list_messages(): Promise<SessionMessage[]>;
-    /** 读取指定 sequence 之前最近的完整历史分段。 */
-    read_segment_before(before_sequence: number): Promise<SessionSegmentSnapshot | null>;
-    /** 读取最新历史分段的累计摘要。 */
-    read_latest_summary(): Promise<SessionSegmentSummary | null>;
-    /** 读取当前 Session 的全部真实历史消息。 */
-    list_history_messages(): Promise<SessionMessage[]>;
-    /** 读取消息数量、存储大小与最新消息统计。 */
-    stats(): Promise<SessionMessageStorageStats>;
-    /** 判断指定 sequence 之前是否存在历史分段。 */
-    has_segment_before(before_sequence: number): Promise<boolean>;
-    /** 计算当前 Active Message 之前的读取边界。 */
-    active_before_sequence(messages: SessionMessage[]): Promise<number | undefined>;
-    /** 读取当前运行中的 Assistant 草稿。 */
-    read_assistant_message(): Promise<SessionAssistantMessage | null>;
-    /** 原子覆盖当前运行中的 Assistant 草稿。 */
-    write_assistant_message(message: SessionAssistantMessage): Promise<void>;
-    /** 在存储事务中创建唯一 Assistant 草稿。 */
-    create_assistant_message(build_message: (state: SessionMessageCommitState) => SessionAssistantMessage): Promise<SessionAssistantMessage>;
-    /** 在存储事务中追加一条 Message。 */
-    append_message(build_message: (state: SessionMessageCommitState) => SessionMessage): Promise<SessionMessage>;
-    /** 提交最终 Assistant Message 并删除运行中草稿。 */
-    finalize_assistant_message(message: SessionAssistantMessage): Promise<void>;
-    /** 将 Active 前缀压缩为不可变历史分段。 */
-    compact_active(input: CompactActiveMessagesInput): Promise<CompactActiveMessagesResult>;
-    /** 读取全部历史分段的 sequence 索引。 */
-    list_segment_ranges(): Promise<SessionSegmentRange[]>;
-}
-/** 单个 Session 的领域持久化视图。 */
-export interface SessionDataStore {
-    /** 当前 Session 的稳定标识。 */
-    readonly session_id: string;
-    /** 当前 Session 的创建来源与物理存储分区。 */
-    readonly origin: SessionOrigin;
-    /** 当前 Session 的 Message 持久化能力。 */
-    readonly messages: SessionMessageStore;
-    /** 当前 Session 的附件持久化能力。 */
-    readonly attachments: SessionAttachmentStore;
-    /** 读取 Session Metadata；不存在时返回规范化的初始值。 */
-    read_metadata(): Promise<SessionHistoryMeta>;
-    /** 原子写入完整 Session Metadata。 */
-    write_metadata(metadata: SessionHistoryMeta): Promise<void>;
-    /** 判断 Session 是否存在显式固化的完整 system。 */
-    has_instruction(): Promise<boolean>;
-    /** 读取显式固化的完整 system；不存在时返回 null。 */
-    read_instruction(): Promise<string | null>;
-    /** 原子写入显式固化的完整 system。 */
-    write_instruction(instruction: string): Promise<void>;
-}
-//# sourceMappingURL=SessionDataStore.d.ts.map

package/bin/types/store/SessionDataStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionDataStore.d.ts","sourceRoot":"","sources":["../../../src/types/store/SessionDataStore.ts"],"names":[],"mappings":"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"}

package/bin/types/store/SessionDataStore.js

@@ -1,9 +0,0 @@
-/**
- * 单个 Session 数据存储类型。
- *
- * 关键点（中文）
- * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
- * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
- */
-export {};
-//# sourceMappingURL=SessionDataStore.js.map

package/bin/types/store/SessionDataStore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SessionDataStore.js","sourceRoot":"","sources":["../../../src/types/store/SessionDataStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/utils/Template.d.ts

@@ -1,17 +0,0 @@
-/**
- * 字符串模板渲染工具。
- *
- * 职责说明（中文）
- * - 提供统一的 `{{variable}}` 占位符替换能力。
- * - 供 init 模板与 runtime system prompt 渲染复用，避免重复实现。
- */
-import type { TemplateVariableMap } from "../types/common/Template.js";
-/**
- * 渲染模板中的 `{{variable}}` 占位符。
- *
- * 关键点（中文）
- * - 变量名支持字母、数字、下划线，且允许写成 `{{ key }}`。
- * - 未提供值的变量保持原样，便于排查模板与变量映射不一致问题。
- */
-export declare function render_template_variables(template: string, variables: TemplateVariableMap): string;
-//# sourceMappingURL=Template.d.ts.map

package/bin/utils/Template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Template.d.ts","sourceRoot":"","sources":["../../src/utils/Template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,mBAAmB,GAC7B,MAAM,CAOR"}

package/bin/utils/Template.js

@@ -1,24 +0,0 @@
-/**
- * 字符串模板渲染工具。
- *
- * 职责说明（中文）
- * - 提供统一的 `{{variable}}` 占位符替换能力。
- * - 供 init 模板与 runtime system prompt 渲染复用，避免重复实现。
- */
-/**
- * 渲染模板中的 `{{variable}}` 占位符。
- *
- * 关键点（中文）
- * - 变量名支持字母、数字、下划线，且允许写成 `{{ key }}`。
- * - 未提供值的变量保持原样，便于排查模板与变量映射不一致问题。
- */
-export function render_template_variables(template, variables) {
-    if (!template)
-        return template;
-    return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (match, key) => {
-        return Object.prototype.hasOwnProperty.call(variables, key)
-            ? String(variables[key])
-            : match;
-    });
-}
-//# sourceMappingURL=Template.js.map

package/bin/utils/Template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Template.js","sourceRoot":"","sources":["../../src/utils/Template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,SAA8B;IAE9B,IAAI,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC/B,OAAO,QAAQ,CAAC,OAAO,CAAC,gCAAgC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvE,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC;YACzD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/scripts/session-compaction-prompts.test.mjs

@@ -1,49 +0,0 @@
-/**
- * @file 验证 Session compact prompt 的结构化摘要格式。
- *
- * 关键点（中文）
- * - compact prompt 必须保持结构化摘要格式稳定。
- * - 迭代更新 prompt 需要携带 previous-summary 标签。
- */
-
-import test from "node:test";
-import assert from "node:assert/strict";
-
-import {
-  SESSION_COMPACTION_SYSTEM_PROMPT,
-  build_initial_session_compaction_prompt,
-  build_turn_prefix_session_compaction_prompt,
-  build_update_session_compaction_prompt,
-} from "../bin/executor/composer/compaction/jsonl/JsonlSessionCompactionPrompts.js";
-
-test("session compaction prompts preserve structured formats", () => {
-  assert.match(
-    SESSION_COMPACTION_SYSTEM_PROMPT,
-    /Do NOT continue the conversation/,
-  );
-
-  const initial_prompt = build_initial_session_compaction_prompt({
-    conversation_text: "user: 请修改 packages/agent/src/foo.ts",
-  });
-  assert.match(initial_prompt, /## Goal/);
-  assert.match(initial_prompt, /## Constraints & Preferences/);
-  assert.match(initial_prompt, /## Critical Context/);
-  assert.match(
-    initial_prompt,
-    /Keep each section concise\. Preserve exact file paths/,
-  );
-
-  const update_prompt = build_update_session_compaction_prompt({
-    previous_summary: "## Goal\n旧目标",
-    new_conversation_text: "assistant: 已完成一部分",
-  });
-  assert.match(update_prompt, /<previous-summary>\n## Goal\n旧目标\n<\/previous-summary>/);
-  assert.match(update_prompt, /PRESERVE all existing information/);
-  assert.match(update_prompt, /## Next Steps/);
-
-  const prefix_prompt = build_turn_prefix_session_compaction_prompt({
-    prefix_text: "user: 这个 turn 太长",
-  });
-  assert.match(prefix_prompt, /## Original Request/);
-  assert.match(prefix_prompt, /## Context for Suffix/);
-});

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

@@ -1,162 +0,0 @@
-/**
- * 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/system/SessionSystemComposer.ts

@@ -1,25 +0,0 @@
-/**
- * SessionSystemComposer：Session system messages Composer 抽象。
- *
- * 关键点（中文）
- * - 专职负责“会话上下文 -> system messages”解析。
- * - 与 tools / step 编排解耦，避免 Executor 过载。
- */
-
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-import type { SessionComposeInput } from "@/types/session/SessionComposer.js";
-
-/**
- * Session system Composer 协议。
- */
-export interface SessionSystemComposer {
-  /**
-   * 解析器名称（由具体实现声明）。
-   */
-  readonly name: string;
-
-  /**
-   * 解析本轮 system messages。
-   */
-  resolve(input: SessionComposeInput): Promise<SessionSystemMessage[]>;
-}

package/src/executor/composer/system/default/DefaultSessionSystemComposer.ts

@@ -1,76 +0,0 @@
-/**
- * DefaultSessionSystemComposer：默认 system Composer。
- *
- * 关键点（中文）
- * - 该实现归属默认 system Composer，统一负责 Session system 解析入口。
- * - 具体“解析 / 加载 / 组装”下沉到 SystemDomain，保持类本身轻量。
- */
-
-import type {
-  SessionSystemComposer,
-} from "@executor/composer/system/SessionSystemComposer.js";
-import type { SessionHookRuntime } from "@downcity/type";
-import type { SessionComposeInput } from "@/types/session/SessionComposer.js";
-import {
-  resolve_session_system_messages,
-  type SystemProfile,
-} from "@executor/composer/system/default/SystemDomain.js";
-
-type DefaultSessionSystemComposerOptions = {
-  /**
-   * 项目根目录，用于渲染运行时 system 模板。
-   */
-  project_root: string;
-
-  /**
-   * 读取当前生效的静态 system 文本集合。
-   */
-  get_static_system_prompts: () => string[];
-
-  /**
-   * 读取当前执行上下文（用于加载 Plugin system 文本）。
-   */
-  get_hooks: () => SessionHookRuntime;
-
-  /**
-   * system 档位（默认 chat）。
-   */
-  profile?: SystemProfile;
-};
-
-/**
- * SessionSystemComposer 默认实现。
- */
-export class DefaultSessionSystemComposer implements SessionSystemComposer {
-  readonly name = "prompt_system";
-
-  private readonly project_root: string;
-  private readonly get_static_system_prompts: DefaultSessionSystemComposerOptions["get_static_system_prompts"];
-  private readonly get_hooks: DefaultSessionSystemComposerOptions["get_hooks"];
-  private readonly profile: SystemProfile;
-
-  constructor(options: DefaultSessionSystemComposerOptions) {
-    const project_root = String(options.project_root || "").trim();
-    if (!project_root) {
-      throw new Error("DefaultSessionSystemComposer requires a non-empty project_root");
-    }
-    this.project_root = project_root;
-    this.get_static_system_prompts = options.get_static_system_prompts;
-    this.get_hooks = options.get_hooks;
-    this.profile = options.profile === "task" ? "task" : "chat";
-  }
-
-  async resolve(input: SessionComposeInput) {
-    const session_id = input.session.session_id;
-    if (!session_id) {
-      throw new Error("DefaultSessionSystemComposer.resolve requires a non-empty session_id");
-    }
-    return await resolve_session_system_messages({
-      project_root: this.project_root,
-      session_id,
-      profile: this.profile,
-      static_system_prompts: this.get_static_system_prompts(),
-      hooks: this.get_hooks(),
-    });
-  }
-}

package/src/executor/composer/system/default/PromptRenderer.ts

@@ -1,52 +0,0 @@
-/**
- * PromptRenderer：system prompt 消息渲染器。
- *
- * 关键点（中文）
- * - 负责文本 prompt -> system message 的转换能力。
- * - 变量替换下沉到 `session/composer/system/default/variables/VariableReplacer`。
- * - 不关注具体 prompt 来源（静态/服务/运行时）。
- */
-
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-import {
-  replace_variables_in_prompts,
-  type PromptVariableMode,
-} from "@executor/composer/system/default/variables/VariableReplacer.js";
-
-/**
- * 将纯文本 prompts 转为 `system` messages。
- *
- * 关键点（中文）
- * - 自动过滤空串并执行变量替换。
- */
-export async function transform_prompts_into_system_messages(
-  prompts: string[],
-  options?: {
-    /**
-     * 项目路径（用于模板变量）。
-     */
-    projectPath?: string;
-
-    /**
-     * 会话 ID（用于模板变量）。
-     */
-    session_id?: string;
-
-    /**
-     * 变量替换模式。
-     *
-     * 关键点（中文）
-     * - `full`：替换全部变量（含时间/位置）。
-     * - `stable`：仅保留稳定变量，易变变量替换为稳定占位文本。
-     */
-    variableMode?: PromptVariableMode;
-  },
-): Promise<SessionSystemMessage[]> {
-  const nonEmptyPrompts = prompts.filter((item) => item.length > 0);
-  return Promise.all(
-    nonEmptyPrompts.map(async (item) => ({
-      role: "system" as const,
-      content: await replace_variables_in_prompts(item, options),
-    })),
-  );
-}