@downcity/agent 1.1.408 → 1.1.437

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 { PluginContext } from "@/types/plugin/PluginContext.js";
-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_context: () => PluginContext;
-
-  /**
-   * 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_context: DefaultSessionSystemComposerOptions["get_context"];
-  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_context = options.get_context;
-    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(),
-      context: this.get_context(),
-    });
-  }
-}

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),
-    })),
-  );
-}

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

@@ -1,350 +0,0 @@
-/**
- * SystemDomain：system 领域统一实现。
- *
- * 关键点（中文）
- * - 收敛 system 的资产加载、上下文档位判定、plugin prompt 收集、messages 组装。
- * - `DefaultSessionSystemComposer` 只做组件适配；核心逻辑统一在本文件。
- */
-
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-import { transform_prompts_into_system_messages } from "@executor/composer/system/default/PromptRenderer.js";
-import type { PluginContext } from "@/types/plugin/PluginContext.js";
-import { build_runtime_clock_system_prompt } from "@executor/composer/system/default/variables/VariableReplacer.js";
-import {
-  CORE_SYSTEM_PROMPT,
-  TASK_SYSTEM_PROMPT,
-} from "@executor/composer/system/default/SystemPromptAssets.js";
-
-const DEFAULT_DISABLED_MANAGED_PLUGIN_NAMES: string[] = [];
-
-function normalizeSystemText(input: string | null | undefined): string {
-  return String(input || "").trim();
-}
-
-/**
- * Ship 默认系统提示模板。
- */
-export const DEFAULT_SHIP_PROMPTS = CORE_SYSTEM_PROMPT;
-
-/**
- * 构建一次运行的运行时 system prompt。
- *
- * 关键点（中文）
- * - 仅承载“稳定规则”块，避免把每轮变化字段放在前缀 system。
- * - task 模式下追加任务输出规则；chat 模式为空。
- */
-export function build_context_system_prompt(input: {
-  /**
-   * 项目根目录。
-   */
-  project_root: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  session_id: string;
-
-  /**
-   * 当前 system 模式（默认 chat）。
-   */
-  mode?: "chat" | "task";
-
-  /**
-   * 额外上下文行（可选）。
-   */
-  extra_context_lines?: string[];
-}): string {
-  const { project_root, extra_context_lines } = input;
-  const mode = input.mode === "task" ? "task" : "chat";
-  if (mode === "chat") return "";
-
-  const runtimeContextLines: string[] = [
-    "Task runtime context:",
-    `- Project root: ${project_root}`,
-  ];
-
-  if (Array.isArray(extra_context_lines) && extra_context_lines.length > 0) {
-    runtimeContextLines.push(...extra_context_lines);
-  }
-
-  const outputRules = [
-    "Task-run output rules:",
-    "- This is a task execution context, not an interactive chat turn.",
-    "- Do NOT send external channel messages via `downcity chat send` unless explicitly required by the task itself.",
-    "- Reply with result-oriented content; do NOT paste raw tool outputs or JSON logs.",
-    "- Keep output compact and avoid unnecessary conversational fillers.",
-  ].join("\n");
-
-  return [runtimeContextLines.join("\n"), "", outputRules].join("\n");
-}
-
-/**
- * 解析静态 system prompts。
- *
- * 关键点（中文）
- * - task 执行上下文可替换默认 core prompt（`DEFAULT_SHIP_PROMPTS`）为任务专用提示词。
- * - PROFILE/SOUL 等其他静态提示保持不变。
- */
-export function resolve_static_system_prompts(input: {
-  /**
-   * 当前静态 system 文本集合。
-   */
-  systems: string[];
-
-  /**
-   * 可选默认 core prompt 替换文本（task 场景常用）。
-   */
-  replace_default_core_prompt?: string;
-}): string[] {
-  const base = Array.isArray(input.systems) ? [...input.systems] : [];
-  const replacement = String(input.replace_default_core_prompt || "").trim();
-  if (!replacement) return base;
-  return [...base.filter((item) => item !== DEFAULT_SHIP_PROMPTS), replacement];
-}
-
-type ResolvedSystemContextProfile = {
-  mode: "chat" | "task";
-  replace_default_core_prompt?: string;
-  disable_plugin_systems: string[];
-};
-
-/**
- * System 档位。
- *
- * 关键点（中文）
- * - 由外部创建 system 时显式指定，避免在 system 域猜测业务上下文。
- */
-export type SystemProfile = "chat" | "task";
-
-/**
- * 按显式 profile 解析 system 上下文档位。
- *
- * 关键点（中文）
- * - chat 模式：使用默认 core prompt 与全部 plugin system。
- * - task 模式：自动替换 task core prompt，并禁用 chat plugin system。
- */
-export function resolve_system_context_profile(
-  profile?: SystemProfile,
-): ResolvedSystemContextProfile {
-  if (profile !== "task") {
-    return {
-      mode: "chat",
-      disable_plugin_systems: [...DEFAULT_DISABLED_MANAGED_PLUGIN_NAMES],
-    };
-  }
-  return {
-    mode: "task",
-    replace_default_core_prompt: TASK_SYSTEM_PROMPT,
-    disable_plugin_systems: ["chat"],
-  };
-}
-
-/**
- * 收集受 agent 托管的 plugin system 文本。
- *
- * 关键点（中文）
- * - core prompt 已包含 plugin 系统总规则；这里仅收集各 plugin 自己的 system prompt。
- * - 单个加载失败走 fail-open，不阻断主链路。
- */
-export async function load_managed_plugin_system_prompts(input: {
-  /**
-   * 当前执行上下文。
-   */
-  context: PluginContext;
-
-  /**
-   * 当前轮禁用的 plugin 名称集合。
-   */
-  disabled_plugin_names: string[];
-}): Promise<string[]> {
-  const out: string[] = [];
-  const disabled_plugin_names = new Set(
-    input.disabled_plugin_names
-      .map((item) => String(item || "").trim())
-      .filter(Boolean),
-  );
-
-  for (const snapshot of input.context.plugins.snapshots()) {
-    const plugin = input.context.plugins.get(snapshot.name);
-    if (!plugin) continue;
-    if (disabled_plugin_names.has(plugin.name)) continue;
-    if (typeof plugin.system !== "function") continue;
-    try {
-      if (input.context.plugins.status(plugin.name)?.status !== "ready") continue;
-      if (typeof plugin.availability === "function") {
-        const availability = await plugin.availability(input.context);
-        if (!availability.available) continue;
-      }
-      const text = normalizeSystemText(await plugin.system(input.context));
-      if (!text) continue;
-      out.push(text);
-    } catch {
-      // fail-open
-    }
-  }
-
-  return out;
-}
-
-/**
- * 收集本地 plugin 的 system 文本。
- *
- * 关键点（中文）
- * - 本地 plugin 的 `plugin.system` 在语义上属于“增强注入”。
- * - 若 plugin 显式声明 availability 且当前 unavailable，则跳过其 system 注入。
- * - 单个 plugin 加载失败走 fail-open，不阻断主链路。
- */
-export async function load_local_plugin_system_prompts(input: {
-  /**
-   * 当前统一执行上下文。
-   */
-  context: PluginContext;
-}): Promise<string[]> {
-  void input;
-  return [];
-}
-
-/**
- * 统一构建一次 Session 运行所需的 system messages。
- *
- * 关键点（中文）
- * - context/static/plugin 的组装逻辑统一收敛在 system 域。
- */
-export async function build_session_system_messages(input: {
-  /**
-   * 项目根目录（用于模板变量和运行态上下文）。
-   */
-  project_root: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  session_id: string;
-
-  /**
-   * 本轮模式（chat/task）。
-   */
-  mode?: "chat" | "task";
-
-  /**
-   * 可选默认 core prompt 替换文本（task 场景常用）。
-   */
-  replace_default_core_prompt?: string;
-
-  /**
-   * 静态 system 文本集合（profile/soul/user/default）。
-   */
-  static_system_prompts: string[];
-
-  /**
-   * 受 agent 托管的 plugin system 文本集合（main plugin + managed plugins）。
-   */
-  managed_plugin_system_prompts: string[];
-
-  /**
-   * 本地 plugin system 文本集合。
-   */
-  local_plugin_system_prompts: string[];
-}): Promise<SessionSystemMessage[]> {
-  const runtimeClockText = build_runtime_clock_system_prompt({
-    projectPath: input.project_root,
-    session_id: input.session_id,
-  });
-  const runtimeClockMessages: SessionSystemMessage[] = runtimeClockText
-    ? [{ role: "system", content: runtimeClockText }]
-    : [];
-  const runtimeSystemText = build_context_system_prompt({
-    project_root: input.project_root,
-    session_id: input.session_id,
-    mode: input.mode,
-  });
-  const runtimeRuleMessages: SessionSystemMessage[] = runtimeSystemText
-    ? [{ role: "system", content: runtimeSystemText }]
-    : [];
-
-  const staticSystemMessages = await transform_prompts_into_system_messages(
-    resolve_static_system_prompts({
-      systems: input.static_system_prompts,
-      replace_default_core_prompt: input.replace_default_core_prompt,
-    }),
-    {
-      projectPath: input.project_root,
-      variableMode: "stable",
-    },
-  );
-
-  const managedPluginSystemMessages = await transform_prompts_into_system_messages(
-    Array.isArray(input.managed_plugin_system_prompts)
-      ? input.managed_plugin_system_prompts
-      : [],
-    {
-      projectPath: input.project_root,
-      variableMode: "stable",
-    },
-  );
-
-  const localPluginSystemMessages = await transform_prompts_into_system_messages(
-    Array.isArray(input.local_plugin_system_prompts)
-      ? input.local_plugin_system_prompts
-      : [],
-    {
-      projectPath: input.project_root,
-      variableMode: "stable",
-    },
-  );
-
-  return [
-    ...staticSystemMessages,
-    ...managedPluginSystemMessages,
-    ...localPluginSystemMessages,
-    ...runtimeRuleMessages,
-    ...runtimeClockMessages,
-  ];
-}
-
-/**
- * 统一解析一次 Session 运行所需的 system messages（含上下文档位判定与 plugin 收集）。
- */
-export async function resolve_session_system_messages(input: {
-  /**
-   * 项目根目录。
-   */
-  project_root: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  session_id: string;
-
-  /**
-   * 当前 system 档位（默认 chat）。
-   */
-  profile?: SystemProfile;
-
-  /**
-   * 当前静态 system 文本集合。
-   */
-  static_system_prompts: string[];
-
-  /**
-   * 当前执行上下文。
-   */
-  context: PluginContext;
-
-}): Promise<SessionSystemMessage[]> {
-  const profile = resolve_system_context_profile(input.profile);
-  return await build_session_system_messages({
-    project_root: input.project_root,
-    session_id: input.session_id,
-    mode: profile.mode,
-    replace_default_core_prompt: profile.replace_default_core_prompt,
-    static_system_prompts: input.static_system_prompts,
-    managed_plugin_system_prompts: await load_managed_plugin_system_prompts({
-      context: input.context,
-      disabled_plugin_names: profile.disable_plugin_systems,
-    }),
-    local_plugin_system_prompts: await load_local_plugin_system_prompts({
-      context: input.context,
-    }),
-  });
-}

package/src/executor/composer/system/default/assets/task.prompt.ts

@@ -1,9 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-
-// Source: src/executor/composer/system/default/assets/task.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "You are executing an internal Task-system job, not a chat conversation.\n\nRuntime constraints:\n- This context is for task execution and auditing, not a user chat turn.\n- Unless the task body explicitly asks for it, do not call the chat plugin send action or any external-channel sending action.\n- Do not act like a real-time support agent. Prioritize completing the task objective and producing an auditable result.\n- You may produce necessary intermediate notes during execution, but your final assistant message will be treated directly as `output.md` and as the final content to send.\n\nOutput principles:\n- Your final assistant message must be the task deliverable itself.\n- The final assistant message must not include process reports, status summaries, task-management notes, or sending notes.\n- Prefer reusable, structured, concise result content.\n- Do not echo long raw logs. Summarize them and include only the key conclusions when needed.\n- If the task input requires a fixed format such as JSON, follow that format strictly.\n- If the task asks to \"send to the current conversation\" or \"send to the user\", assume the system will send your final assistant message back directly. Therefore, output exactly the text that should be sent to the user.\n- Unless the task body explicitly requests an execution summary, the final assistant message must not say \"task completed\", \"sent\", \"I will take a look\", \"I will handle this for you\", or similar meta language.\n\nCommon content that is forbidden in the final assistant message:\n- \"I will help you...\"\n- \"First, let me...\"\n- \"I see there is already a task with the same name...\"\n- \"Task sent / completed / updated...\"\n- \"Task status summary...\"\n- Any explanatory text centered on task-management workflow.\n\nFinal self-check:\n- Before finishing, check whether your final assistant message is the final deliverable itself.\n- If the final assistant message mainly describes the process, task status, or sending state rather than the final content, the output direction is wrong and must be rewritten.\n- If removing phrases such as \"I will\", \"first\", \"sent\", or \"task status\" leaves almost no useful content, it is not a valid task output.\n\nContext principles:\n- This task context is an independent execution context. It does not inherit the chat conversation goal.\n- If these rules conflict with other system prompts, the task execution context rules take precedence.\n";
-
-export default TEXT_MODULE_CONTENT;