@downcity/agent 1.1.430 → 1.1.438

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

@@ -1,301 +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 { SessionHookRuntime } from "@downcity/type";
-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_EXTENSION_NAMES: string[] = [];
-
-function normalize_system_text(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;
-  disabled_plugin_names: 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",
-      disabled_plugin_names: [...DEFAULT_DISABLED_EXTENSION_NAMES],
-    };
-  }
-  return {
-    mode: "task",
-    replace_default_core_prompt: TASK_SYSTEM_PROMPT,
-    disabled_plugin_names: ["chat"],
-  };
-}
-
-/**
- * 收集宿主 Plugin 提供的 system 文本。
- *
- * 关键点（中文）
- * - core prompt 已包含扩展系统总规则；这里只收集各 Plugin 自己的 system prompt。
- * - 单个 Plugin 是否可用由宿主投影的运行时负责。
- */
-export async function load_plugin_system_prompts(input: {
-  /**
-   * 当前执行上下文。
-   */
-  hooks: SessionHookRuntime;
-
-  /**
-   * 当前轮禁用的 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),
-  );
-
-  const blocks = await input.hooks.system_blocks();
-  for (const block of blocks) {
-    if (disabled_plugin_names.has(block.name)) continue;
-    const text = normalize_system_text(block.content);
-    if (text) out.push(text);
-  }
-
-  return out;
-}
-
-/**
- * 统一构建一次 Session 运行所需的 system messages。
- *
- * 关键点（中文）
- * - context/static/extension 的组装逻辑统一收敛在 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[];
-
-  /**
-   * 宿主 Plugin 提供的 system 文本集合。
-   */
-  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 plugin_system_messages = await transform_prompts_into_system_messages(
-    Array.isArray(input.plugin_system_prompts)
-      ? input.plugin_system_prompts
-      : [],
-    {
-      projectPath: input.project_root,
-      variableMode: "stable",
-    },
-  );
-
-  return [
-    ...staticSystemMessages,
-    ...plugin_system_messages,
-    ...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[];
-
-  /**
-   * 当前执行上下文。
-   */
-  hooks: SessionHookRuntime;
-
-}): 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,
-    plugin_system_prompts: await load_plugin_system_prompts({
-      hooks: input.hooks,
-      disabled_plugin_names: profile.disabled_plugin_names,
-    }),
-  });
-}

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;

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

@@ -1,33 +0,0 @@
-You are executing an internal Task-system job, not a chat conversation.
-
-Runtime constraints:
-- This context is for task execution and auditing, not a user chat turn.
-- Unless the task body explicitly asks for it, do not call the chat plugin send action or any external-channel sending action.
-- Do not act like a real-time support agent. Prioritize completing the task objective and producing an auditable result.
-- 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.
-
-Output principles:
-- Your final assistant message must be the task deliverable itself.
-- The final assistant message must not include process reports, status summaries, task-management notes, or sending notes.
-- Prefer reusable, structured, concise result content.
-- Do not echo long raw logs. Summarize them and include only the key conclusions when needed.
-- If the task input requires a fixed format such as JSON, follow that format strictly.
-- 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.
-- 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.
-
-Common content that is forbidden in the final assistant message:
-- "I will help you..."
-- "First, let me..."
-- "I see there is already a task with the same name..."
-- "Task sent / completed / updated..."
-- "Task status summary..."
-- Any explanatory text centered on task-management workflow.
-
-Final self-check:
-- Before finishing, check whether your final assistant message is the final deliverable itself.
-- 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.
-- If removing phrases such as "I will", "first", "sent", or "task status" leaves almost no useful content, it is not a valid task output.
-
-Context principles:
-- This task context is an independent execution context. It does not inherit the chat conversation goal.
-- If these rules conflict with other system prompts, the task execution context rules take precedence.

package/src/executor/composer/system/default/variables/GeoContext.ts

@@ -1,180 +0,0 @@
-/**
- * Prompt 地理上下文解析器。
- *
- * 关键点（中文）
- * - 基于公网 IP 服务推断 location + timezone。
- * - 失败时回退到本机时区，保证 prompt 渲染稳定可用。
- * - 使用进程内缓存，避免每次请求都访问外部服务。
- */
-
-import type { PromptGeoContext } from "@executor/composer/system/default/variables/PromptTypes.js";
-
-type IpApiCoResponse = {
-  ip?: unknown;
-  city?: unknown;
-  region?: unknown;
-  country_name?: unknown;
-  timezone?: unknown;
-};
-
-type IpWhoIsResponse = {
-  success?: unknown;
-  ip?: unknown;
-  city?: unknown;
-  region?: unknown;
-  country?: unknown;
-  timezone?: unknown;
-};
-
-const GEO_CACHE_TTL_MS = 30 * 60 * 1000;
-const GEO_REQUEST_TIMEOUT_MS = 3000;
-
-let cachedGeoContext:
-  | {
-      value: PromptGeoContext;
-      expires_at: number;
-    }
-  | null = null;
-let inFlightGeoContext: Promise<PromptGeoContext> | null = null;
-
-function readString(input: unknown): string | null {
-  if (typeof input !== "string") return null;
-  const value = input.trim();
-  return value ? value : null;
-}
-
-function isValidIanaTimezone(input: string | null): input is string {
-  if (!input) return false;
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: input });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function buildLocation(parts: Array<unknown>): string {
-  const values = parts.map(readString).filter((item): item is string => Boolean(item));
-  return values.length > 0 ? values.join(", ") : "Unknown";
-}
-
-function buildFallbackGeoContext(): PromptGeoContext {
-  const timezone = readString(Intl.DateTimeFormat().resolvedOptions().timeZone);
-  const safeTimezone = isValidIanaTimezone(timezone) ? timezone : "UTC";
-  return {
-    ip: "unknown",
-    location: "Unknown",
-    timezone: safeTimezone,
-    source: "local",
-  };
-}
-
-function writeCache(value: PromptGeoContext): PromptGeoContext {
-  cachedGeoContext = {
-    value,
-    expires_at: Date.now() + GEO_CACHE_TTL_MS,
-  };
-  return value;
-}
-
-async function fetchIpApiGeoContext(): Promise<PromptGeoContext | null> {
-  let response: Response;
-  try {
-    response = await fetch("https://ipapi.co/json/", {
-      headers: {
-        Accept: "application/json",
-      },
-      signal: AbortSignal.timeout(GEO_REQUEST_TIMEOUT_MS),
-    });
-  } catch {
-    return null;
-  }
-  if (!response.ok) return null;
-
-  let data: IpApiCoResponse;
-  try {
-    data = (await response.json()) as IpApiCoResponse;
-  } catch {
-    return null;
-  }
-
-  const timezone = readString(data.timezone);
-  if (!isValidIanaTimezone(timezone)) return null;
-
-  return {
-    ip: readString(data.ip) || "unknown",
-    location: buildLocation([data.city, data.region, data.country_name]),
-    timezone,
-    source: "ipapi",
-  };
-}
-
-function readIpWhoIsTimezone(input: unknown): string | null {
-  if (typeof input === "string") return readString(input);
-  if (!input || typeof input !== "object") return null;
-  return readString((input as { id?: unknown }).id);
-}
-
-async function fetchIpWhoIsGeoContext(): Promise<PromptGeoContext | null> {
-  let response: Response;
-  try {
-    response = await fetch("https://ipwho.is/", {
-      headers: {
-        Accept: "application/json",
-      },
-      signal: AbortSignal.timeout(GEO_REQUEST_TIMEOUT_MS),
-    });
-  } catch {
-    return null;
-  }
-  if (!response.ok) return null;
-
-  let data: IpWhoIsResponse;
-  try {
-    data = (await response.json()) as IpWhoIsResponse;
-  } catch {
-    return null;
-  }
-
-  if (data.success === false) return null;
-
-  const timezone = readIpWhoIsTimezone(data.timezone);
-  if (!isValidIanaTimezone(timezone)) return null;
-
-  return {
-    ip: readString(data.ip) || "unknown",
-    location: buildLocation([data.city, data.region, data.country]),
-    timezone,
-    source: "ipwhois",
-  };
-}
-
-async function loadGeoContext(): Promise<PromptGeoContext> {
-  const now = Date.now();
-  if (cachedGeoContext && now < cachedGeoContext.expires_at) {
-    return cachedGeoContext.value;
-  }
-
-  if (inFlightGeoContext) return inFlightGeoContext;
-
-  inFlightGeoContext = (async () => {
-    const ipApiResult = await fetchIpApiGeoContext();
-    if (ipApiResult) return writeCache(ipApiResult);
-
-    const ipWhoIsResult = await fetchIpWhoIsGeoContext();
-    if (ipWhoIsResult) return writeCache(ipWhoIsResult);
-
-    return writeCache(buildFallbackGeoContext());
-  })().finally(() => {
-    inFlightGeoContext = null;
-  });
-
-  return inFlightGeoContext;
-}
-
-/**
- * 解析 prompt 所需地理上下文。
- */
-export async function resolve_prompt_geo_context(): Promise<PromptGeoContext> {
-  return loadGeoContext();
-}

package/src/executor/composer/system/default/variables/PromptTypes.ts

@@ -1,37 +0,0 @@
-/**
- * Prompt 模板变量类型。
- *
- * 关键点（中文）
- * - 统一描述 prompt template 支持的运行时变量结构。
- * - 供模板渲染与地理位置解析模块复用，避免隐式约定。
- */
-
-export interface PromptGeoContext {
-  /** 公网 IP；当外部服务不可用时回退为 `unknown`。 */
-  ip: string;
-  /** 地理解析后的地点描述，用于提示模型当前大致位置。 */
-  location: string;
-  /** IANA 时区标识，例如 `Asia/Shanghai`。 */
-  timezone: string;
-  /** 地理上下文来源。 */
-  source: "ipapi" | "ipwhois" | "local";
-}
-
-export interface PromptVariables {
-  /** 当前日期字符串，按当前时区格式化为 `YYYY-MM-DD`。 */
-  currentDate: string;
-  /** 当前时间字符串，包含日期、时分秒与时区信息。 */
-  currentTime: string;
-  /** 当前年份字符串，用于显式提示“现在是几几年”。 */
-  currentYear: string;
-  /** 当前运行时使用的 IANA 时区标识，例如 `Asia/Shanghai`。 */
-  timezone: string;
-  /** 当前地理位置描述。 */
-  location: string;
-  /** 当前项目路径。 */
-  projectPath: string;
-  /** 当前项目根路径。 */
-  project_root: string;
-  /** 当前会话标识。 */
-  session_id: string;
-}