@downcity/agent 1.1.32 → 1.1.43

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

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

package/src/session/composer/system/default/StaticPromptCatalog.ts

@@ -1,287 +0,0 @@
-/**
- * StaticPromptCatalog：静态 prompt 目录与热重载模块。
- *
- * 关键点（中文）
- * - 统一管理 PROFILE.md / SOUL.md 的加载与热重载。
- * - 仅依赖“当前 systems 读取 + systems 应用”回调，不耦合 AgentRuntime 具体实现。
- */
-
-import { DEFAULT_SHIP_PROMPTS } from "@session/composer/system/default/SystemDomain.js";
-import type { Logger } from "@/utils/logger/Logger.js";
-import {
-  getProfileMdCandidatePaths,
-  getProfileMdPath,
-  getSoulMdCandidatePaths,
-  getSoulMdPath,
-} from "@/config/Paths.js";
-import fs from "fs-extra";
-import path from "node:path";
-import { watch, type FSWatcher } from "node:fs";
-
-const DEFAULT_HOT_RELOAD_DEBOUNCE_MS = 300;
-
-/**
- * 静态 prompt 文件规范。
- */
-type StaticPromptFileSpec = {
-  key: "profile" | "soul";
-  reloadReason: "profile_md_changed" | "soul_md_changed";
-  defaultPath: (rootPath: string) => string;
-  candidatePaths: (rootPath: string) => string[];
-  fallbackText?: string;
-};
-
-const STATIC_PROMPT_FILES: StaticPromptFileSpec[] = [
-  {
-    key: "profile",
-    reloadReason: "profile_md_changed",
-    defaultPath: getProfileMdPath,
-    candidatePaths: getProfileMdCandidatePaths,
-    fallbackText: `# Assistant Role
-You are a helpful project assistant.`,
-  },
-  {
-    key: "soul",
-    reloadReason: "soul_md_changed",
-    defaultPath: getSoulMdPath,
-    candidatePaths: getSoulMdCandidatePaths,
-  },
-];
-
-type StaticPromptProfile = {
-  spec: StaticPromptFileSpec;
-  resolvedPath: string | null;
-  text: string;
-};
-
-/**
- * 解析静态 prompt 文件路径（支持候选名）。
- */
-function resolveStaticPromptPath(
-  rootPath: string,
-  spec: StaticPromptFileSpec,
-): string | null {
-  const candidates = spec.candidatePaths(rootPath);
-  for (const candidate of candidates) {
-    try {
-      if (fs.existsSync(candidate)) return candidate;
-    } catch {
-      // ignore
-    }
-  }
-  return null;
-}
-
-/**
- * 读取所有静态 prompt 文件。
- */
-function loadStaticPromptProfiles(rootPath: string): StaticPromptProfile[] {
-  return STATIC_PROMPT_FILES.map((spec) => {
-    const resolvedPath = resolveStaticPromptPath(rootPath, spec);
-    let text = "";
-    if (resolvedPath) {
-      try {
-        text = fs.readFileSync(resolvedPath, "utf-8").trim();
-      } catch {
-        text = "";
-      }
-    }
-    if (!text && spec.fallbackText) {
-      text = spec.fallbackText;
-    }
-    return { spec, resolvedPath, text };
-  });
-}
-
-function buildPathByKey(
-  rootPath: string,
-  profiles: StaticPromptProfile[],
-): Map<string, string> {
-  const pathByKey = new Map<string, string>();
-  for (const profile of profiles) {
-    pathByKey.set(
-      profile.spec.key,
-      profile.resolvedPath || profile.spec.defaultPath(rootPath),
-    );
-  }
-  return pathByKey;
-}
-
-function systemsEqual(a: string[], b: string[]): boolean {
-  if (a.length !== b.length) return false;
-  for (let i = 0; i < a.length; i += 1) {
-    if (a[i] !== b[i]) return false;
-  }
-  return true;
-}
-
-/**
- * 构建静态系统提示列表。
- */
-export function buildStaticSystemPrompts(staticProfiles: string[]): string[] {
-  return [...staticProfiles, DEFAULT_SHIP_PROMPTS].filter(Boolean);
-}
-
-/**
- * 加载当前静态系统提示列表。
- */
-export function loadStaticSystemPrompts(rootPath: string): string[] {
-  const staticProfiles = loadStaticPromptProfiles(rootPath);
-  return buildStaticSystemPrompts(staticProfiles.map((item) => item.text));
-}
-
-type StaticPromptCatalogOptions = {
-  rootPath: string;
-  logger: Logger;
-  getCurrentSystems: () => string[];
-  applySystems: (nextSystems: string[]) => void;
-  debounceMs?: number;
-};
-
-/**
- * 静态 prompt 热重载器。
- */
-export class StaticPromptCatalog {
-  private readonly rootPath: string;
-  private readonly logger: Logger;
-  private readonly getCurrentSystems: StaticPromptCatalogOptions["getCurrentSystems"];
-  private readonly applySystems: StaticPromptCatalogOptions["applySystems"];
-  private readonly debounceMs: number;
-  private stopHandle: (() => void) | null = null;
-
-  constructor(options: StaticPromptCatalogOptions) {
-    this.rootPath = options.rootPath;
-    this.logger = options.logger;
-    this.getCurrentSystems = options.getCurrentSystems;
-    this.applySystems = options.applySystems;
-    this.debounceMs =
-      typeof options.debounceMs === "number" && options.debounceMs > 0
-        ? options.debounceMs
-        : DEFAULT_HOT_RELOAD_DEBOUNCE_MS;
-  }
-
-  /**
-   * 停止监听。
-   */
-  stop(): void {
-    if (!this.stopHandle) return;
-    this.stopHandle();
-    this.stopHandle = null;
-  }
-
-  private reloadStaticSystemPrompts(reason: string, filename?: string): void {
-    const staticProfiles = loadStaticPromptProfiles(this.rootPath);
-    const nextSystems = buildStaticSystemPrompts(staticProfiles.map((item) => item.text));
-    if (systemsEqual(this.getCurrentSystems(), nextSystems)) return;
-
-    this.applySystems(nextSystems);
-    const pathByKey = buildPathByKey(this.rootPath, staticProfiles);
-    this.logger.info("Static prompts hot reloaded", {
-      reason,
-      filename: filename || undefined,
-      profileMdPath: pathByKey.get("profile") || getProfileMdPath(this.rootPath),
-      soulMdPath: pathByKey.get("soul") || getSoulMdPath(this.rootPath),
-    });
-  }
-
-  /**
-   * 启动监听。
-   */
-  start(): void {
-    this.stop();
-
-    const watchers: FSWatcher[] = [];
-    const timers = new Map<string, NodeJS.Timeout>();
-    const clearAllTimers = (): void => {
-      for (const timer of timers.values()) {
-        clearTimeout(timer);
-      }
-      timers.clear();
-    };
-
-    const schedule = (key: string, task: () => void): void => {
-      const prev = timers.get(key);
-      if (prev) clearTimeout(prev);
-      const next = setTimeout(() => {
-        timers.delete(key);
-        task();
-      }, this.debounceMs);
-      timers.set(key, next);
-    };
-
-    const attachWatcher = (
-      watchPath: string,
-      options: { recursive?: boolean },
-      onChange: (eventType: string, filename: string) => void,
-    ): boolean => {
-      try {
-        const watcher = watch(
-          watchPath,
-          { recursive: Boolean(options.recursive) },
-          (eventType, filename) => {
-            const normalized = filename
-              ? Buffer.isBuffer(filename)
-                ? filename.toString("utf-8")
-                : String(filename)
-              : "";
-            onChange(eventType, normalized);
-          },
-        );
-        watcher.on("error", (error) => {
-          this.logger.warn("Hot reload watcher runtime error", {
-            watchPath,
-            error: String(error),
-          });
-        });
-        watchers.push(watcher);
-        return true;
-      } catch (error) {
-        this.logger.warn("Hot reload watcher attach failed", {
-          watchPath,
-          error: String(error),
-        });
-        return false;
-      }
-    };
-
-    const staticPromptFileNameToReason = new Map<string, string>();
-    for (const spec of STATIC_PROMPT_FILES) {
-      for (const candidatePath of spec.candidatePaths(this.rootPath)) {
-        staticPromptFileNameToReason.set(
-          path.basename(candidatePath),
-          spec.reloadReason,
-        );
-      }
-    }
-
-    // PROFILE.md / SOUL.md：监听项目根目录（文件替换/重命名也能捕获）。
-    attachWatcher(this.rootPath, {}, (_eventType, filename) => {
-      const basename = filename ? path.basename(filename) : "";
-      const changedReason = staticPromptFileNameToReason.get(basename);
-      if (!changedReason) return;
-      schedule("static-prompts", () =>
-        this.reloadStaticSystemPrompts(changedReason, basename),
-      );
-    });
-
-    const staticProfiles = loadStaticPromptProfiles(this.rootPath);
-    const pathByKey = buildPathByKey(this.rootPath, staticProfiles);
-
-    this.stopHandle = () => {
-      clearAllTimers();
-      for (const watcher of watchers) {
-        try {
-          watcher.close();
-        } catch {
-          // ignore
-        }
-      }
-    };
-
-    this.logger.info("Runtime hot reload enabled", {
-      profileMdPath: pathByKey.get("profile") || getProfileMdPath(this.rootPath),
-      soulMdPath: pathByKey.get("soul") || getSoulMdPath(this.rootPath),
-      watchers: watchers.length,
-    });
-  }
-}

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

@@ -1,377 +0,0 @@
-/**
- * SystemDomain：system 领域统一实现。
- *
- * 关键点（中文）
- * - 收敛 system 的资产加载、上下文档位判定、plugin prompt 收集、messages 组装。
- * - `DefaultSessionSystemComposer` 只做组件适配；核心逻辑统一在本文件。
- */
-
-import type { SystemModelMessage } from "ai";
-import { transformPromptsIntoSystemMessages } from "@session/composer/system/default/PromptRenderer.js";
-import { isPluginEnabled } from "@/plugin/core/Activation.js";
-import { PLUGINS } from "@/plugin/core/Plugins.js";
-import { PLUGIN_SYSTEM_PROVIDERS } from "@/plugin/core/PluginSystemProviders.js";
-import type { AgentContext } from "@/core/AgentContextTypes.js";
-import { buildRuntimeClockSystemPrompt } from "@session/composer/system/default/variables/VariableReplacer.js";
-import {
-  CORE_SYSTEM_PROMPT,
-  PLUGIN_SYSTEM_PROMPT,
-  TASK_SYSTEM_PROMPT,
-} from "@session/composer/system/default/SystemPromptAssets.js";
-
-const DEFAULT_DISABLED_RUNTIME_PLUGIN_NAMES: string[] = [];
-
-function normalizeSystemText(input: string | null | undefined): string {
-  return String(input || "").trim();
-}
-
-/**
- * Ship 默认系统提示模板。
- */
-export const DEFAULT_SHIP_PROMPTS = CORE_SYSTEM_PROMPT;
-
-const MAIN_PLUGIN_PROMPT = PLUGIN_SYSTEM_PROMPT;
-
-/**
- * 构建一次运行的运行时 system prompt。
- *
- * 关键点（中文）
- * - 仅承载“稳定规则”块，避免把每轮变化字段放在前缀 system。
- * - task 模式下追加任务输出规则；chat 模式为空。
- */
-export function buildContextSystemPrompt(input: {
-  /**
-   * 项目根目录。
-   */
-  projectRoot: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  sessionId: string;
-
-  /**
-   * 当前 system 模式（默认 chat）。
-   */
-  mode?: "chat" | "task";
-
-  /**
-   * 额外上下文行（可选）。
-   */
-  extraContextLines?: string[];
-}): string {
-  const { projectRoot, extraContextLines } = input;
-  const mode = input.mode === "task" ? "task" : "chat";
-  if (mode === "chat") return "";
-
-  const runtimeContextLines: string[] = [
-    "Task runtime context:",
-    `- Project root: ${projectRoot}`,
-  ];
-
-  if (Array.isArray(extraContextLines) && extraContextLines.length > 0) {
-    runtimeContextLines.push(...extraContextLines);
-  }
-
-  const outputRules = [
-    "Task-run output rules:",
-    "- This is a task execution context, not an interactive chat turn.",
-    "- Do NOT send external channel messages via `city 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 resolveStaticSystemPrompts(input: {
-  /**
-   * 当前静态 system 文本集合。
-   */
-  systems: string[];
-
-  /**
-   * 可选默认 core prompt 替换文本（task 场景常用）。
-   */
-  replaceDefaultCorePrompt?: string;
-}): string[] {
-  const base = Array.isArray(input.systems) ? [...input.systems] : [];
-  const replacement = String(input.replaceDefaultCorePrompt || "").trim();
-  if (!replacement) return base;
-  return [...base.filter((item) => item !== DEFAULT_SHIP_PROMPTS), replacement];
-}
-
-type ResolvedSystemContextProfile = {
-  mode: "chat" | "task";
-  replaceDefaultCorePrompt?: string;
-  disablePluginSystems: 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 resolveSystemContextProfile(
-  profile?: SystemProfile,
-): ResolvedSystemContextProfile {
-  if (profile !== "task") {
-    return {
-      mode: "chat",
-      disablePluginSystems: [...DEFAULT_DISABLED_RUNTIME_PLUGIN_NAMES],
-    };
-  }
-  return {
-    mode: "task",
-    replaceDefaultCorePrompt: TASK_SYSTEM_PROMPT,
-    disablePluginSystems: ["chat"],
-  };
-}
-
-/**
- * 收集 runtime plugin 维度的 system 文本。
- *
- * 关键点（中文）
- * - 顺序：main plugin prompt -> plugin.system。
- * - 单个加载失败走 fail-open，不阻断主链路。
- */
-export async function loadRuntimePluginSystemPrompts(input: {
-  /**
-   * 当前执行上下文。
-   */
-  context: AgentContext;
-
-  /**
-   * 当前轮禁用的 plugin 名称集合。
-   */
-  disabledPluginNames: string[];
-}): Promise<string[]> {
-  const out: string[] = [];
-  const mainPluginPrompt = normalizeSystemText(MAIN_PLUGIN_PROMPT);
-  if (mainPluginPrompt) {
-    out.push(mainPluginPrompt);
-  }
-
-  const disabledPluginNames = new Set(
-    input.disabledPluginNames
-      .map((item) => String(item || "").trim())
-      .filter(Boolean),
-  );
-
-  for (const plugin of PLUGIN_SYSTEM_PROVIDERS) {
-    if (disabledPluginNames.has(plugin.name)) continue;
-    try {
-      const text = normalizeSystemText(await plugin.system(input.context));
-      if (!text) continue;
-      out.push(text);
-    } catch {
-      // fail-open
-    }
-  }
-
-  return out;
-}
-
-/**
- * 收集扩展型 plugin 的 system 文本。
- *
- * 关键点（中文）
- * - extension plugin 的 `plugin.system` 在语义上属于“增强注入”。
- * - 若 plugin 显式声明 availability 且当前 unavailable，则跳过其 system 注入。
- * - 单个 plugin 加载失败走 fail-open，不阻断主链路。
- */
-export async function loadExtensionPluginSystemPrompts(input: {
-  /**
-   * 当前统一执行上下文。
-   */
-  context: AgentContext;
-}): Promise<string[]> {
-  const out: string[] = [];
-
-  for (const plugin of PLUGINS) {
-    if (typeof plugin.system !== "function") continue;
-    try {
-      if (
-        !isPluginEnabled({
-          plugin,
-          context: input.context,
-        })
-      ) {
-        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;
-}
-
-/**
- * 统一构建一次 Session 运行所需的 system messages。
- *
- * 关键点（中文）
- * - context/static/plugin 的组装逻辑统一收敛在 system 域。
- */
-export async function buildSessionSystemMessages(input: {
-  /**
-   * 项目根目录（用于模板变量和运行态上下文）。
-   */
-  projectRoot: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  sessionId: string;
-
-  /**
-   * 本轮模式（chat/task）。
-   */
-  mode?: "chat" | "task";
-
-  /**
-   * 可选默认 core prompt 替换文本（task 场景常用）。
-   */
-  replaceDefaultCorePrompt?: string;
-
-  /**
-   * 静态 system 文本集合（profile/soul/user/default）。
-   */
-  staticSystemPrompts: string[];
-
-  /**
-   * runtime plugin system 文本集合（main plugin + builtin runtime plugins）。
-   */
-  runtimePluginSystemPrompts: string[];
-
-  /**
-   * extension plugin system 文本集合。
-   */
-  extensionPluginSystemPrompts: string[];
-}): Promise<SystemModelMessage[]> {
-  const runtimeClockText = buildRuntimeClockSystemPrompt({
-    projectPath: input.projectRoot,
-    sessionId: input.sessionId,
-  });
-  const runtimeClockMessages: SystemModelMessage[] = runtimeClockText
-    ? [{ role: "system", content: runtimeClockText }]
-    : [];
-  const runtimeSystemText = buildContextSystemPrompt({
-    projectRoot: input.projectRoot,
-    sessionId: input.sessionId,
-    mode: input.mode,
-  });
-  const runtimeRuleMessages: SystemModelMessage[] = runtimeSystemText
-    ? [{ role: "system", content: runtimeSystemText }]
-    : [];
-
-  const staticSystemMessages = await transformPromptsIntoSystemMessages(
-    resolveStaticSystemPrompts({
-      systems: input.staticSystemPrompts,
-      replaceDefaultCorePrompt: input.replaceDefaultCorePrompt,
-    }),
-    {
-      projectPath: input.projectRoot,
-      variableMode: "stable",
-    },
-  );
-
-  const runtimePluginSystemMessages = await transformPromptsIntoSystemMessages(
-    Array.isArray(input.runtimePluginSystemPrompts)
-      ? input.runtimePluginSystemPrompts
-      : [],
-    {
-      projectPath: input.projectRoot,
-      variableMode: "stable",
-    },
-  );
-
-  const extensionPluginSystemMessages = await transformPromptsIntoSystemMessages(
-    Array.isArray(input.extensionPluginSystemPrompts)
-      ? input.extensionPluginSystemPrompts
-      : [],
-    {
-      projectPath: input.projectRoot,
-      variableMode: "stable",
-    },
-  );
-
-  return [
-    ...staticSystemMessages,
-    ...runtimePluginSystemMessages,
-    ...extensionPluginSystemMessages,
-    ...runtimeRuleMessages,
-    ...runtimeClockMessages,
-  ];
-}
-
-/**
- * 统一解析一次 Session 运行所需的 system messages（含上下文档位判定与 plugin 收集）。
- */
-export async function resolveSessionSystemMessages(input: {
-  /**
-   * 项目根目录。
-   */
-  projectRoot: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  sessionId: string;
-
-  /**
-   * 当前 system 档位（默认 chat）。
-   */
-  profile?: SystemProfile;
-
-  /**
-   * 当前静态 system 文本集合。
-   */
-  staticSystemPrompts: string[];
-
-  /**
-   * 当前执行上下文。
-   */
-  context: AgentContext;
-
-}): Promise<SystemModelMessage[]> {
-  const profile = resolveSystemContextProfile(input.profile);
-  return await buildSessionSystemMessages({
-    projectRoot: input.projectRoot,
-    sessionId: input.sessionId,
-    mode: profile.mode,
-    replaceDefaultCorePrompt: profile.replaceDefaultCorePrompt,
-    staticSystemPrompts: input.staticSystemPrompts,
-    runtimePluginSystemPrompts: await loadRuntimePluginSystemPrompts({
-      context: input.context,
-      disabledPluginNames: profile.disablePluginSystems,
-    }),
-    extensionPluginSystemPrompts: await loadExtensionPluginSystemPrompts({
-      context: input.context,
-    }),
-  });
-}