@downcity/agent 1.1.408 → 1.1.437

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

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

@@ -1,154 +0,0 @@
-/**
- * VariableReplacer：prompt 变量替换模块。
- *
- * 关键点（中文）
- * - 专职负责模板变量构建与文本替换。
- * - 与 message 组装解耦，便于独立复用与测试。
- */
-
-import { resolve_prompt_geo_context } from "@executor/composer/system/default/variables/GeoContext.js";
-import type { PromptVariables } from "@executor/composer/system/default/variables/PromptTypes.js";
-import { render_template_variables } from "@/utils/Template.js";
-import {
-  format_date_in_timezone,
-  format_date_time_in_timezone,
-  format_year_in_timezone,
-  resolve_runtime_timezone,
-} from "@/utils/Time.js";
-
-/**
- * Prompt 变量替换模式。
- *
- * 关键点（中文）
- * - `full`：完整替换（包含时间/地点等上下文动态变量）。
- * - `stable`：仅保留稳定替换；但 `current_year` 属于低频年度变量，仍保留真实值。
- */
-export type PromptVariableMode = "full" | "stable";
-
-async function buildPromptVariables(options?: {
-  /**
-   * 项目路径（用于 `project_path/project_root`）。
-   */
-  projectPath?: string;
-
-  /**
-   * 会话 ID（用于 `session_id`）。
-   */
-  session_id?: string;
-
-  /**
-   * 变量替换模式（默认 full）。
-   */
-  mode?: PromptVariableMode;
-}): Promise<PromptVariables> {
-  const mode = options?.mode === "stable" ? "stable" : "full";
-  const projectPath = String(options?.projectPath || "").trim() || process.cwd();
-  const safeLocalTimezone = resolve_runtime_timezone();
-  const now = new Date();
-  if (mode === "stable") {
-    return {
-      currentDate: "[See runtime clock tail message]",
-      currentTime: "[See runtime clock tail message]",
-      currentYear: format_year_in_timezone(now, safeLocalTimezone),
-      timezone: safeLocalTimezone,
-      location: "[See runtime clock tail message]",
-      projectPath,
-      project_root: projectPath,
-      session_id: "[Runtime session id]",
-    };
-  }
-
-  const geo = await resolve_prompt_geo_context();
-  const session_id = String(options?.session_id || "").trim() || "unknown";
-  return {
-    // 关键点（中文）：时间字段只使用本机 runtime 时区，避免代理/IP 地理推断改变 cron 与相对时间口径。
-    currentDate: format_date_in_timezone(now, safeLocalTimezone),
-    currentTime: format_date_time_in_timezone(now, safeLocalTimezone),
-    currentYear: format_year_in_timezone(now, safeLocalTimezone),
-    timezone: safeLocalTimezone,
-    location: geo.location,
-    projectPath,
-    project_root: projectPath,
-    session_id,
-  };
-}
-
-/**
- * 替换 prompt 模板变量。
- *
- * 当前支持（中文）
- * - `{{current_time}}`
- * - `{{current_date}}`
- * - `{{current_year}}`
- * - `{{timezone}}`
- * - `{{location}}`
- * - `{{project_path}}`
- * - `{{project_root}}`
- * - `{{session_id}}`
- */
-export async function replace_variables_in_prompts(
-  prompt: string,
-  options?: {
-    /**
-     * 项目路径（用于 `project_path/project_root`）。
-     */
-    projectPath?: string;
-
-    /**
-     * 会话 ID（用于 `session_id`）。
-     */
-    session_id?: string;
-
-    /**
-     * 变量替换模式（默认 full）。
-     */
-    mode?: PromptVariableMode;
-  },
-): Promise<string> {
-  if (!prompt) return prompt;
-  const variables = await buildPromptVariables(options);
-  return render_template_variables(prompt, {
-    current_date: variables.currentDate,
-    current_time: variables.currentTime,
-    current_year: variables.currentYear,
-    timezone: variables.timezone,
-    location: variables.location,
-    project_path: variables.projectPath,
-    project_root: variables.project_root,
-    session_id: variables.session_id,
-  });
-}
-
-/**
- * 构建每轮运行末尾的 runtime clock system prompt。
- *
- * 关键点（中文）
- * - system/static prompt 使用 stable 模式，不能直接承载每轮变化的时间。
- * - 这里在 messages 尾部补齐 `current_date/current_time/timezone`，让 chat、task、prompt 的时间语义统一。
- * - 只使用本机 runtime 时区，避免每轮为了地理位置进行网络请求。
- */
-export function build_runtime_clock_system_prompt(options?: {
-  /**
-   * 项目路径（用于 `project_root`）。
-   */
-  projectPath?: string;
-
-  /**
-   * 会话 ID（用于 `session_id`）。
-   */
-  session_id?: string;
-}): string {
-  const timezone = resolve_runtime_timezone();
-  const projectPath = String(options?.projectPath || "").trim() || process.cwd();
-  const session_id = String(options?.session_id || "").trim() || "unknown";
-  const now = new Date();
-  return [
-    "# Runtime Clock Context",
-    "The following fields are the authoritative time context for this run. Prefer them when resolving relative time expressions such as today, tomorrow, or a specific hour:",
-    `- current_date: ${format_date_in_timezone(now, timezone)}`,
-    `- current_time: ${format_date_time_in_timezone(now, timezone)}`,
-    `- timezone: ${timezone}`,
-    `- session_id: ${session_id}`,
-    `- project_root: ${projectPath}`,
-  ].join("\n");
-}

package/src/executor/core-engine/CoreEngineMessageState.ts

@@ -1,117 +0,0 @@
-/**
- * CoreEngine 模型消息运行态。
- *
- * 关键点（中文）
- * - CoreEngine 只维护本 Turn 后续模型 Step 需要的标准 ModelMessage。
- * - canonical SessionMessage 的持久化由 SessionMessages 独立拥有。
- */
-
-import type { ModelMessage } from "@downcity/type";
-import { session_messages_to_model_messages } from "@executor/messages/SessionModelMessages.js";
-import type { SessionMessage, SessionUserMessage } from "@/types/session/SessionMessage.js";
-
-/**
- * CoreEngine 单轮执行期间的消息基线。
- */
-export class CoreEngineMessageState {
-  /**
-   * 当前模型侧消息基线。
-   */
-  private current_model_messages: ModelMessage[];
-
-  /**
-   * 当前项目根目录，用于解析历史中的相对路径 file part。
-   */
-  private readonly project_root?: string;
-
-  private constructor(params: {
-    /**
-     * 当前模型侧消息基线。
-     */
-    model_messages: ModelMessage[];
-    /**
-     * 当前项目根目录。
-     */
-    project_root?: string;
-  }) {
-    this.current_model_messages = params.model_messages;
-    this.project_root = params.project_root;
-  }
-
-  /**
-   * 基于初始模型消息创建运行态。
-   */
-  static async create(params: {
-    /**
-     * 初始标准模型消息。
-     */
-    messages: ModelMessage[];
-    /**
-     * 当前项目根目录。
-     */
-    project_root?: string;
-  }): Promise<CoreEngineMessageState> {
-    return new CoreEngineMessageState({
-      model_messages: Array.isArray(params.messages) ? [...params.messages] : [],
-      project_root: params.project_root,
-    });
-  }
-
-  /**
-   * 读取当前模型消息。
-   */
-  get model_messages(): ModelMessage[] {
-    return this.current_model_messages;
-  }
-
-  /**
-   * 把 Step 间新增的 canonical User Message 并入模型基线。
-   */
-  async append_merged_user_messages(
-    messages: SessionUserMessage[],
-  ): Promise<ModelMessage[]> {
-    if (messages.length === 0) return [];
-    return await this.append_session_messages(messages);
-  }
-
-  /**
-   * 追加内部生成的 user nudge 消息。
-   */
-  async append_user_message(message: SessionUserMessage): Promise<void> {
-    await this.append_session_messages([message]);
-  }
-
-  /**
-   * 追加 SDK 返回的模型 response messages。
-   */
-  append_model_messages(messages: ModelMessage[]): void {
-    if (!Array.isArray(messages) || messages.length === 0) return;
-    this.current_model_messages = [...this.current_model_messages, ...messages];
-  }
-
-  /**
-   * 原子替换当前模型侧消息基线。
-   *
-   * 关键点（中文）：compact 只替换 Provider 后续可见的 ModelMessage，
-   * Session 语义消息与持久化历史仍保持完整，等待 turn 收口后再单独归档。
-   */
-  replace_model_messages(messages: ModelMessage[]): void {
-    this.current_model_messages = Array.isArray(messages) ? [...messages] : [];
-  }
-
-  /** 使用 Composer 重新生成的模型历史原子替换当前基线。 */
-  replace_model_history(messages: ModelMessage[]): void {
-    this.current_model_messages = Array.isArray(messages) ? [...messages] : [];
-  }
-
-  private async append_session_messages(
-    messages: SessionMessage[],
-  ): Promise<ModelMessage[]> {
-    const model_messages = await session_messages_to_model_messages(
-      messages,
-      this.project_root,
-    );
-    this.current_model_messages = [...this.current_model_messages, ...model_messages];
-    return model_messages;
-  }
-}

package/src/group/GroupDispatchSession.ts

@@ -1,175 +0,0 @@
-/**
- * GroupDispatchSession：单个 GroupSession 独享的持久化调度执行边界。
- *
- * 本对象统一拥有调度队列、当前模型取消信号和调度 Turn 状态。调度策略只负责决策，
- * 不再自行拥有跨 GroupSession 的运行状态或停止语义。
- */
-
-import { nanoid } from "nanoid";
-import type {
-  GroupDispatchSessionDataStore,
-  GroupDispatchSessionInput,
-  GroupDispatchSessionOptions,
-  GroupDispatchSessionResult,
-  GroupDispatchTurnRecord,
-} from "@/types/group/GroupDispatchSession.js";
-
-/** 主动停止 Dispatch Session 时使用的内部错误。 */
-export class GroupDispatchStoppedError extends Error {
-  constructor() {
-    super("Group dispatch stopped");
-    this.name = "GroupDispatchStoppedError";
-  }
-}
-
-/** GroupSession 私有的调度 Session。 */
-export class GroupDispatchSession {
-  private readonly dispatch_strategy: GroupDispatchSessionOptions["dispatch_strategy"];
-  private store?: GroupDispatchSessionDataStore;
-  private queue_tail: Promise<void> = Promise.resolve();
-  private active_abort_controller?: AbortController;
-  private stopping = false;
-  private disposed = false;
-
-  constructor(options: GroupDispatchSessionOptions) {
-    this.dispatch_strategy = options.dispatch_strategy;
-  }
-
-  /** 绑定持久化视图，并把进程中断留下的运行态明确收口为 stopped。 */
-  async initialize(store: GroupDispatchSessionDataStore): Promise<this> {
-    if (this.store && this.store !== store) {
-      throw new Error("GroupDispatchSession is already initialized with another Store");
-    }
-    if (this.store === store) return this;
-    this.store = store;
-    const interrupted_turns = (await store.list_turns()).filter((turn) => (
-      turn.status === "queued" || turn.status === "running"
-    ));
-    for (const turn of interrupted_turns) {
-      await store.append_turn({
-        ...turn,
-        status: "stopped",
-        error: "Group dispatch interrupted before recovery",
-        updated_at: Date.now(),
-      });
-    }
-    return this;
-  }
-
-  /** 按提交顺序执行一次调度，并在返回前持久化最终决定。 */
-  decide(input: GroupDispatchSessionInput): Promise<GroupDispatchSessionResult> {
-    this.assert_available();
-    const store = this.require_store();
-    const created_at = Date.now();
-    const queued_turn: GroupDispatchTurnRecord = {
-      dispatch_id: `group-dispatch-${nanoid(12)}`,
-      trigger: input.trigger,
-      message_id: input.message.id,
-      pending_message_ids: input.pending_messages.map((message) => message.id),
-      status: "queued",
-      created_at,
-      updated_at: created_at,
-    };
-    const persist_queued = store.append_turn(queued_turn);
-    const operation = this.queue_tail.then(async () => {
-      await persist_queued;
-      return await this.execute_turn(input, queued_turn);
-    });
-    this.queue_tail = operation.then(() => undefined, () => undefined);
-    return operation;
-  }
-
-  /** 中断当前模型调用，并让尚未开始的调度 Turn 按队列顺序收口。 */
-  async stop(): Promise<void> {
-    if (this.disposed || this.stopping) return;
-    this.stopping = true;
-    this.active_abort_controller?.abort(new GroupDispatchStoppedError());
-    await this.queue_tail;
-    this.active_abort_controller = undefined;
-    this.stopping = false;
-  }
-
-  /** 永久释放当前 Dispatch Session。 */
-  async dispose(): Promise<void> {
-    if (this.disposed) return;
-    await this.stop();
-    this.disposed = true;
-    this.store = undefined;
-  }
-
-  /** 执行队首调度 Turn，确保成功、失败和停止都形成持久化终态。 */
-  private async execute_turn(
-    input: GroupDispatchSessionInput,
-    queued_turn: GroupDispatchTurnRecord,
-  ): Promise<GroupDispatchSessionResult> {
-    const store = this.require_store();
-    if (this.stopping || this.disposed) {
-      await this.persist_terminal_turn(queued_turn, "stopped", "Group dispatch stopped");
-      throw new GroupDispatchStoppedError();
-    }
-    const abort_controller = new AbortController();
-    this.active_abort_controller = abort_controller;
-    await store.append_turn({
-      ...queued_turn,
-      status: "running",
-      updated_at: Date.now(),
-    });
-    try {
-      const decision = await this.dispatch_strategy.decide_dispatch({
-        ...input,
-        abort_signal: abort_controller.signal,
-      });
-      if (this.stopping || this.disposed || abort_controller.signal.aborted) {
-        throw new GroupDispatchStoppedError();
-      }
-      await store.append_turn({
-        ...queued_turn,
-        status: "completed",
-        decision,
-        updated_at: Date.now(),
-      });
-      return { dispatch_id: queued_turn.dispatch_id, decision };
-    } catch (error) {
-      if (
-        error instanceof GroupDispatchStoppedError ||
-        this.stopping ||
-        this.disposed ||
-        abort_controller.signal.aborted
-      ) {
-        await this.persist_terminal_turn(queued_turn, "stopped", "Group dispatch stopped");
-        throw new GroupDispatchStoppedError();
-      }
-      const detail = error instanceof Error ? error.message : String(error);
-      await this.persist_terminal_turn(queued_turn, "failed", detail);
-      throw error;
-    } finally {
-      if (this.active_abort_controller === abort_controller) {
-        this.active_abort_controller = undefined;
-      }
-    }
-  }
-
-  /** 提交没有 decision 的失败或停止终态。 */
-  private async persist_terminal_turn(
-    turn: GroupDispatchTurnRecord,
-    status: "failed" | "stopped",
-    error: string,
-  ): Promise<void> {
-    await this.require_store().append_turn({
-      ...turn,
-      status,
-      error,
-      updated_at: Date.now(),
-    });
-  }
-
-  private require_store(): GroupDispatchSessionDataStore {
-    if (!this.store) throw new Error("GroupDispatchSession is not initialized");
-    return this.store;
-  }
-
-  private assert_available(): void {
-    if (this.disposed) throw new Error("GroupDispatchSession is disposed");
-    if (this.stopping) throw new Error("GroupDispatchSession is stopping");
-  }
-}