@downcity/agent 1.1.287 → 1.1.310

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

@@ -6,14 +6,14 @@
  * - 与 message 组装解耦，便于独立复用与测试。
  */
 
-import { resolvePromptGeoContext } from "@executor/composer/system/default/variables/GeoContext.js";
+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 { renderTemplateVariables } from "@/utils/Template.js";
+import { render_template_variables } from "@/utils/Template.js";
 import {
-  formatDateInTimezone,
-  formatDateTimeInTimezone,
-  formatYearInTimezone,
-  resolveRuntimeTimezone,
+  format_date_in_timezone,
+  format_date_time_in_timezone,
+  format_year_in_timezone,
+  resolve_runtime_timezone,
 } from "@/utils/Time.js";
 
 /**
@@ -34,7 +34,7 @@ async function buildPromptVariables(options?: {
   /**
    * 会话 ID（用于 `session_id`）。
    */
-  sessionId?: string;
+  session_id?: string;
 
   /**
    * 变量替换模式（默认 full）。
@@ -43,33 +43,33 @@ async function buildPromptVariables(options?: {
 }): Promise<PromptVariables> {
   const mode = options?.mode === "stable" ? "stable" : "full";
   const projectPath = String(options?.projectPath || "").trim() || process.cwd();
-  const safeLocalTimezone = resolveRuntimeTimezone();
+  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: formatYearInTimezone(now, safeLocalTimezone),
+      currentYear: format_year_in_timezone(now, safeLocalTimezone),
       timezone: safeLocalTimezone,
       location: "[See runtime clock tail message]",
       projectPath,
-      projectRoot: projectPath,
-      sessionId: "[Runtime session id]",
+      project_root: projectPath,
+      session_id: "[Runtime session id]",
     };
   }
 
-  const geo = await resolvePromptGeoContext();
-  const sessionId = String(options?.sessionId || "").trim() || "unknown";
+  const geo = await resolve_prompt_geo_context();
+  const session_id = String(options?.session_id || "").trim() || "unknown";
   return {
     // 关键点（中文）：时间字段只使用本机 runtime 时区，避免代理/IP 地理推断改变 cron 与相对时间口径。
-    currentDate: formatDateInTimezone(now, safeLocalTimezone),
-    currentTime: formatDateTimeInTimezone(now, safeLocalTimezone),
-    currentYear: formatYearInTimezone(now, safeLocalTimezone),
+    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,
-    projectRoot: projectPath,
-    sessionId,
+    project_root: projectPath,
+    session_id,
   };
 }
 
@@ -86,7 +86,7 @@ async function buildPromptVariables(options?: {
  * - `{{project_root}}`
  * - `{{session_id}}`
  */
-export async function replaceVariablesInPrompts(
+export async function replace_variables_in_prompts(
   prompt: string,
   options?: {
     /**
@@ -97,7 +97,7 @@ export async function replaceVariablesInPrompts(
     /**
      * 会话 ID（用于 `session_id`）。
      */
-    sessionId?: string;
+    session_id?: string;
 
     /**
      * 变量替换模式（默认 full）。
@@ -107,15 +107,15 @@ export async function replaceVariablesInPrompts(
 ): Promise<string> {
   if (!prompt) return prompt;
   const variables = await buildPromptVariables(options);
-  return renderTemplateVariables(prompt, {
+  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.projectRoot,
-    session_id: variables.sessionId,
+    project_root: variables.project_root,
+    session_id: variables.session_id,
   });
 }
 
@@ -127,7 +127,7 @@ export async function replaceVariablesInPrompts(
  * - 这里在 messages 尾部补齐 `current_date/current_time/timezone`，让 chat、task、prompt 的时间语义统一。
  * - 只使用本机 runtime 时区，避免每轮为了地理位置进行网络请求。
  */
-export function buildRuntimeClockSystemPrompt(options?: {
+export function build_runtime_clock_system_prompt(options?: {
   /**
    * 项目路径（用于 `project_root`）。
    */
@@ -136,19 +136,19 @@ export function buildRuntimeClockSystemPrompt(options?: {
   /**
    * 会话 ID（用于 `session_id`）。
    */
-  sessionId?: string;
+  session_id?: string;
 }): string {
-  const timezone = resolveRuntimeTimezone();
+  const timezone = resolve_runtime_timezone();
   const projectPath = String(options?.projectPath || "").trim() || process.cwd();
-  const sessionId = String(options?.sessionId || "").trim() || "unknown";
+  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: ${formatDateInTimezone(now, timezone)}`,
-    `- current_time: ${formatDateTimeInTimezone(now, timezone)}`,
+    `- current_date: ${format_date_in_timezone(now, timezone)}`,
+    `- current_time: ${format_date_time_in_timezone(now, timezone)}`,
     `- timezone: ${timezone}`,
-    `- session_id: ${sessionId}`,
+    `- session_id: ${session_id}`,
     `- project_root: ${projectPath}`,
   ].join("\n");
 }

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

@@ -11,7 +11,7 @@ import type { JsonObject } from "@/types/common/Json.js";
 /**
  * 归一化 stream 错误日志字段。
  */
-export function summarizeStreamError(error: unknown): JsonObject {
+export function summarize_stream_error(error: unknown): JsonObject {
   const record =
     error && typeof error === "object" && !Array.isArray(error)
       ? (error as Record<string, unknown>)
@@ -28,7 +28,7 @@ export function summarizeStreamError(error: unknown): JsonObject {
 /**
  * 提取实际应返回给上层的错误文本。
  */
-export function resolveEffectiveCoreEngineError(params: {
+export function resolve_effective_core_engine_error(params: {
   /**
    * 外层捕获到的执行错误。
    */

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

@@ -21,7 +21,7 @@ import type {
  * 3. text-only 自动续跑
  * 4. 停止
  */
-export function evaluateCoreEngineLoopDecision(
+export function evaluate_core_engine_loop_decision(
   input: SessionLoopDecisionInput,
 ): SessionLoopDecision {
   if (
@@ -73,7 +73,7 @@ export function evaluateCoreEngineLoopDecision(
  * - 只要最后一次 tail merge 真正并入了新的 user 消息，就必须续跑。
  * - 这样可以覆盖“最后一个 step 结束后，新消息才到达”的收尾窗口。
  */
-export function shouldContinueForTailMergedUserMessages(
+export function should_continue_for_tail_merged_user_messages(
   input: SessionTailMergeContinuationInput,
 ): boolean {
   return input.mergedUserMessageCount > 0;

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

@@ -10,8 +10,8 @@
 import type { ModelMessage, Tool } from "ai";
 import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
 import {
-  pickMergedUserMessages,
-  toModelMessages,
+  pick_merged_user_messages,
+  to_model_messages,
 } from "@executor/messages/SessionMessageCodec.js";
 
 /**
@@ -36,7 +36,7 @@ export class CoreEngineMessageState {
   /**
    * 当前项目根目录，用于解析历史中的相对路径 file part。
    */
-  private readonly projectRoot?: string;
+  private readonly project_root?: string;
 
   private constructor(params: {
     /**
@@ -54,12 +54,12 @@ export class CoreEngineMessageState {
     /**
      * 当前项目根目录。
      */
-    projectRoot?: string;
+    project_root?: string;
   }) {
     this.sessionMessages = params.sessionMessages;
     this.currentModelMessages = params.modelMessages;
     this.tools = params.tools;
-    this.projectRoot = params.projectRoot;
+    this.project_root = params.project_root;
   }
 
   /**
@@ -77,20 +77,20 @@ export class CoreEngineMessageState {
     /**
      * 当前项目根目录。
      */
-    projectRoot?: string;
+    project_root?: string;
   }): Promise<CoreEngineMessageState> {
     const sessionMessages = Array.isArray(params.messages)
       ? [...params.messages]
       : [];
     return new CoreEngineMessageState({
       sessionMessages,
-      modelMessages: await toModelMessages(
+      modelMessages: await to_model_messages(
         sessionMessages,
         params.tools,
-        params.projectRoot,
+        params.project_root,
       ),
       tools: params.tools,
-      projectRoot: params.projectRoot,
+      project_root: params.project_root,
     });
   }
 
@@ -107,7 +107,7 @@ export class CoreEngineMessageState {
   async appendMergedUserMessages(
     messages: SessionRecordV1[],
   ): Promise<ModelMessage[]> {
-    const mergedMessages = pickMergedUserMessages(messages);
+    const mergedMessages = pick_merged_user_messages(messages);
     if (mergedMessages.length === 0) return [];
     return await this.appendSessionMessagesAsModelMessages(mergedMessages);
   }
@@ -156,10 +156,10 @@ export class CoreEngineMessageState {
     tools: Record<string, Tool>,
   ): Promise<void> {
     this.sessionMessages = Array.isArray(messages) ? [...messages] : [];
-    this.currentModelMessages = await toModelMessages(
+    this.currentModelMessages = await to_model_messages(
       this.sessionMessages,
       tools,
-      this.projectRoot,
+      this.project_root,
     );
   }
 
@@ -167,19 +167,19 @@ export class CoreEngineMessageState {
     messages: SessionRecordV1[],
   ): Promise<ModelMessage[]> {
     this.sessionMessages = [...this.sessionMessages, ...messages];
-    const modelMessages = await toModelMessages(
+    const modelMessages = await to_model_messages(
       messages,
       this.tools,
-      this.projectRoot,
+      this.project_root,
     );
     if (modelMessages.length > 0) {
       this.currentModelMessages = [...this.currentModelMessages, ...modelMessages];
       return modelMessages;
     }
-    this.currentModelMessages = await toModelMessages(
+    this.currentModelMessages = await to_model_messages(
       this.sessionMessages,
       this.tools,
-      this.projectRoot,
+      this.project_root,
     );
     return [];
   }