@downcity/agent 1.1.237 → 1.1.258

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionFileOperations.ts

@@ -1,197 +0,0 @@
-/**
- * JsonlSessionCompactionFileOperations：上下文压缩文件操作记录模块。
- *
- * 关键点（中文）
- * - 从被压缩的 session 消息中 best-effort 提取文件读写痕迹。
- * - 输出结构化 XML 片段，追加到 LLM 生成的 compact summary 末尾。
- * - 解析失败或没有文件操作时不影响 compact 主流程。
- */
-
-import { isTextUIPart } from "ai";
-import type { SessionMessageRecordV1 } from "@/executor/types/SessionRecords.js";
-
-/**
- * 压缩范围内的文件操作汇总。
- */
-export type SessionCompactionFileOperations = {
-  /** 本次压缩范围内被读取或查看过的文件路径。 */
-  read_files: string[];
-  /** 本次压缩范围内被新增、修改或删除过的文件路径。 */
-  modified_files: string[];
-};
-
-type UnknownRecord = Record<string, unknown>;
-
-const PATH_CANDIDATE_RE =
-  /(?:\.{1,2}\/|\/|[A-Za-z0-9_.@-]+\/)[A-Za-z0-9_.@~:+/=-]+/g;
-const PATCH_FILE_RE = /^\*\*\* (?:Add|Update|Delete) File: (.+)$/gm;
-const GIT_STATUS_FILE_RE = /^\s*(?:[MADRCU?!]{1,2}|[ MADRCU?!][ MADRCU?!])\s+(.+)$/gm;
-const READ_COMMAND_RE =
-  /\b(?:cat|less|more|sed|nl|head|tail|rg|grep|find|ls|wc|stat|open|git\s+(?:show|diff|status|grep|ls-files))\b/;
-
-/**
- * 把压缩范围内的文件操作格式化为 XML。
- */
-export function format_session_compaction_file_operations(
-  messages: SessionMessageRecordV1[],
-): string {
-  const operations = collect_session_compaction_file_operations(messages);
-  if (operations.read_files.length === 0 && operations.modified_files.length === 0) {
-    return "";
-  }
-  return [
-    "<read-files>",
-    ...operations.read_files.map((file_path) => xml_escape(file_path)),
-    "</read-files>",
-    "",
-    "<modified-files>",
-    ...operations.modified_files.map((file_path) => xml_escape(file_path)),
-    "</modified-files>",
-  ].join("\n");
-}
-
-/**
- * 收集压缩范围内的文件操作。
- */
-export function collect_session_compaction_file_operations(
-  messages: SessionMessageRecordV1[],
-): SessionCompactionFileOperations {
-  const read_files = new Set<string>();
-  const modified_files = new Set<string>();
-
-  for (const message of Array.isArray(messages) ? messages : []) {
-    const text_blocks = extract_message_operation_texts(message);
-    for (const text of text_blocks) {
-      for (const file_path of extract_modified_files(text)) {
-        modified_files.add(file_path);
-      }
-      for (const file_path of extract_read_files(text)) {
-        read_files.add(file_path);
-      }
-    }
-  }
-
-  for (const file_path of modified_files) {
-    read_files.delete(file_path);
-  }
-
-  return {
-    read_files: [...read_files].sort(),
-    modified_files: [...modified_files].sort(),
-  };
-}
-
-/**
- * 提取单条消息中可能包含文件操作的文本块。
- */
-function extract_message_operation_texts(message: SessionMessageRecordV1): string[] {
-  const out: string[] = [];
-  const parts = Array.isArray(message.parts) ? message.parts : [];
-  for (const part of parts) {
-    if (isTextUIPart(part)) {
-      const text = String(part.text ?? "").trim();
-      if (text) out.push(text);
-      continue;
-    }
-    const part_record = to_record(part);
-    if (!part_record) continue;
-    const input_text = stringify_compact(part_record.input);
-    const output_text = stringify_compact(part_record.output);
-    const error_text = stringify_compact(part_record.errorText);
-    if (input_text) out.push(input_text);
-    if (output_text) out.push(output_text);
-    if (error_text) out.push(error_text);
-  }
-  return out;
-}
-
-/**
- * 提取 patch / git status 中的修改文件。
- */
-function extract_modified_files(text: string): string[] {
-  const out = new Set<string>();
-  for (const file_path of match_group_values(text, PATCH_FILE_RE)) {
-    const normalized = normalize_file_path(file_path);
-    if (normalized) out.add(normalized);
-  }
-  for (const file_path of match_group_values(text, GIT_STATUS_FILE_RE)) {
-    const normalized = normalize_file_path(file_path);
-    if (normalized) out.add(normalized);
-  }
-  return [...out];
-}
-
-/**
- * 从读命令文本中提取读取路径。
- */
-function extract_read_files(text: string): string[] {
-  const out = new Set<string>();
-  const lines = String(text || "").split(/\r?\n/);
-  for (const line of lines) {
-    if (!READ_COMMAND_RE.test(line)) continue;
-    for (const candidate of line.match(PATH_CANDIDATE_RE) || []) {
-      const normalized = normalize_file_path(candidate);
-      if (normalized) out.add(normalized);
-    }
-  }
-  return [...out];
-}
-
-/**
- * 获取正则第一个捕获组的所有结果。
- */
-function match_group_values(text: string, pattern: RegExp): string[] {
-  const out: string[] = [];
-  pattern.lastIndex = 0;
-  let match = pattern.exec(text);
-  while (match) {
-    const value = String(match[1] || "").trim();
-    if (value) out.push(value);
-    match = pattern.exec(text);
-  }
-  return out;
-}
-
-/**
- * 归一化候选路径。
- */
-function normalize_file_path(value: string): string {
-  let file_path = String(value || "").trim();
-  if (!file_path || file_path.includes("://")) return "";
-  file_path = file_path.replace(/^["'`]+|["'`]+$/g, "");
-  file_path = file_path.replace(/[),.;:]+$/g, "");
-  if (!file_path || file_path === "." || file_path === "..") return "";
-  if (file_path.startsWith("-")) return "";
-  return file_path;
-}
-
-/**
- * 转成对象记录。
- */
-function to_record(value: unknown): UnknownRecord | null {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  return value as UnknownRecord;
-}
-
-/**
- * 将未知结构紧凑地转为文本。
- */
-function stringify_compact(value: unknown): string {
-  if (value === undefined || value === null) return "";
-  if (typeof value === "string") return value;
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return String(value);
-  }
-}
-
-/**
- * XML 文本转义。
- */
-function xml_escape(value: string): string {
-  return String(value || "")
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
-}

package/src/executor/composer/context/LocalSessionContextComposer.ts

@@ -1,175 +0,0 @@
-/**
- * LocalSessionContextComposer：本地 session 运行时编排 Composer 实现。
- *
- * 关键点（中文）
- * - 统一组装 tools。
- * - step 边界回调从 SessionRunScope 读取，Executor 不直接管理来源。
- */
-
-import type { ModelMessage } from "ai";
-import { generateId } from "@/utils/Id.js";
-import type {
-  SessionContextComposer,
-  SessionContextComposeResult,
-} from "@executor/composer/context/SessionContextComposer.js";
-import type {
-  SessionRecordV1,
-  SessionMessageRecordV1,
-} from "@/executor/types/SessionRecords.js";
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-import type { Tool } from "ai";
-import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
-
-type LocalSessionContextComposerOptions = {
-  /**
-   * 可选默认 session id。
-   */
-  sessionId?: string;
-
-  /**
-   * 读取当前可用工具集合。
-   */
-  getTools: () => Record<string, Tool>;
-};
-
-/**
- * LocalSessionContextComposer 默认 Composer 实现。
- */
-export class LocalSessionContextComposer implements SessionContextComposer {
-  readonly name = "runtime_context_composer";
-  private readonly sessionId: string;
-  private readonly getTools: LocalSessionContextComposerOptions["getTools"];
-
-  constructor(options: LocalSessionContextComposerOptions) {
-    this.sessionId = String(options.sessionId || "").trim();
-    this.getTools = options.getTools;
-  }
-
-  async compose(
-    run_context: SessionRunContext,
-  ): Promise<SessionContextComposeResult> {
-    const tools = this.getTools();
-    const sessionId = String(
-      run_context.sessionId || this.sessionId || "",
-    ).trim();
-    if (!sessionId) {
-      throw new Error(
-        "LocalSessionContextComposer.compose requires a non-empty sessionId",
-      );
-    }
-    return {
-      tools,
-    };
-  }
-
-  createPrepareStepHandler(
-    input: {
-      system: SessionSystemMessage[];
-      appendMergedUserMessages: (
-        messages: SessionRecordV1[],
-      ) => Promise<ModelMessage[]>;
-      runContext: SessionRunContext;
-    },
-  ): (input: { messages?: ModelMessage[] }) => Promise<{
-    system: SessionSystemMessage[];
-    messages?: ModelMessage[];
-  }> {
-    return async ({
-      messages,
-    }: {
-      messages?: ModelMessage[];
-    }): Promise<{
-      system: SessionSystemMessage[];
-      messages?: ModelMessage[];
-    }> => {
-      const injectedMessages = [...input.runContext.injectedUserMessages];
-      input.runContext.injectedUserMessages = [];
-      const onStepCallback = input.runContext.onStepCallback;
-      if (
-        typeof onStepCallback !== "function" &&
-        injectedMessages.length === 0
-      ) {
-        return { system: input.system };
-      }
-
-      const incomingMessages: ModelMessage[] = Array.isArray(messages)
-        ? messages
-        : [];
-      let outMessages: ModelMessage[] | undefined;
-      try {
-        const mergedMessages =
-          typeof onStepCallback === "function" ? await onStepCallback() : [];
-        const mergedWithInjected = [
-          ...injectedMessages,
-          ...(Array.isArray(mergedMessages) ? mergedMessages : []),
-        ];
-        const mergedModelMessages = await input.appendMergedUserMessages(
-          mergedWithInjected,
-        );
-        if (mergedModelMessages.length > 0) {
-          // 关键点（中文）：保持当前 step 已有消息顺序不变，只把新增 user 消息追加到末尾。
-          outMessages = [...incomingMessages, ...mergedModelMessages];
-        }
-      } catch {
-        // ignore merge hook failures
-      }
-
-      return {
-        system: input.system,
-        ...(Array.isArray(outMessages) ? { messages: outMessages } : {}),
-      };
-    };
-  }
-
-  createOnStepFinishHandler(
-    run_context: SessionRunContext,
-  ): (stepResult: unknown) => Promise<void> {
-    const onAssistantStepCallback = run_context.onAssistantStepCallback;
-    let assistantStepIndex = 0;
-    return async (stepResult: unknown): Promise<void> => {
-      const step = stepResult as { text?: unknown };
-      const stepText = String(step.text || "").trim();
-      if (typeof onAssistantStepCallback !== "function") return;
-      try {
-        assistantStepIndex += 1;
-        await onAssistantStepCallback({
-          text: stepText,
-          // 关键点（中文）：1-based step 序号，按回调触发次数递增。
-          stepIndex: assistantStepIndex,
-          stepResult,
-        });
-      } catch {
-        // ignore assistant step callback failures
-      }
-    };
-  }
-
-  /**
-   * 构造 fallback assistant 消息。
-   */
-  buildFallbackAssistantMessage(
-    text: string,
-    run_context: SessionRunContext,
-  ): SessionMessageRecordV1 {
-    const sessionId = String(
-      run_context.sessionId || this.sessionId || "",
-    ).trim();
-    if (!sessionId) {
-      throw new Error(
-        "LocalSessionContextComposer.buildFallbackAssistantMessage requires a non-empty sessionId",
-      );
-    }
-    return {
-      id: `a:${sessionId}:${generateId()}`,
-      role: "assistant",
-      metadata: {
-        v: 1,
-        ts: Date.now(),
-        sessionId,
-        source: "egress",
-        kind: "normal",
-      },
-      parts: [{ type: "text", text: String(text ?? "") }],
-    };
-  }
-}

package/src/executor/composer/context/SessionContextComposer.ts

@@ -1,83 +0,0 @@
-/**
- * SessionContextComposer：单次 Session run context 组装协议。
- *
- * 关键点（中文）
- * - 负责 tools / prepareStep / onStepFinish / fallback message factory 等运行上下文组装。
- * - 不负责历史读写，不负责 system 解析，不负责 compact。
- */
-
-import type { ModelMessage, Tool } from "ai";
-import type {
-  SessionRecordV1,
-  SessionMessageRecordV1,
-} from "@/executor/types/SessionRecords.js";
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
-
-/**
- * 本轮运行上下文组装输出。
- */
-export type SessionContextComposeResult = {
-  /**
-   * 本轮工具集合。
-   */
-  tools: Record<string, Tool>;
-};
-
-/**
- * 运行上下文 Composer 协议。
- */
-export interface SessionContextComposer {
-  /**
-   * Composer 名（由具体实现声明）。
-   */
-  readonly name: string;
-
-  /**
-   * 组装一次 run 所需上下文。
-   */
-  compose(run_context: SessionRunContext): Promise<SessionContextComposeResult>;
-
-  /**
-   * 构造 prepareStep 回调。
-   */
-  createPrepareStepHandler(
-    input: {
-      /**
-       * 当前轮 system 消息。
-       */
-      system: SessionSystemMessage[];
-      /**
-       * 将新增 user 消息转换为可追加的模型消息。
-       */
-      appendMergedUserMessages: (
-        messages: SessionRecordV1[],
-      ) => Promise<ModelMessage[]>;
-      /**
-       * 当前显式运行上下文。
-       */
-      runContext: SessionRunContext;
-    },
-  ): (input: { messages?: ModelMessage[] }) => Promise<{
-    system: SessionSystemMessage[];
-    messages?: ModelMessage[];
-  }>;
-
-  /**
-   * 构造 onStepFinish 回调。
-   */
-  createOnStepFinishHandler(
-    run_context: SessionRunContext,
-  ): (stepResult: unknown) => Promise<void>;
-
-  /**
-   * 构造 fallback assistant 消息。
-   *
-   * 关键点（中文）
-   * - fallback 消息构造由 ContextComposer 内部实现，Executor 不直接依赖 history Composer。
-   */
-  buildFallbackAssistantMessage(
-    text: string,
-    run_context: SessionRunContext,
-  ): SessionMessageRecordV1;
-}

package/src/executor/composer/history/SessionHistoryComposer.ts

@@ -1,62 +0,0 @@
-/**
- * SessionHistoryComposer：会话历史 Composer 抽象。
- *
- * 关键点（中文）
- * - 负责把历史事实源组装成本轮模型输入消息。
- * - 不负责 append / list / meta / archive 等落盘能力。
- * - 不负责模型调用，不负责执行编排。
- */
-
-import type { LanguageModel, Tool } from "ai";
-import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-
-/**
- * prepare 输入参数。
- */
-export type SessionHistoryPrepareInput = {
-  /**
-   * 当前用户查询文本。
-   */
-  query: string;
-
-  /**
-   * 当前轮可用工具集合。
-   */
-  tools: Record<string, Tool>;
-
-  /**
-   * 当前轮 system messages。
-   */
-  system: SessionSystemMessage[];
-
-  /**
-   * 当前模型实例。
-   */
-  model: LanguageModel;
-
-  /**
-   * 当前重试次数（由 Executor 递增）。
-   */
-  retryCount: number;
-};
-
-/**
- * SessionHistoryComposer 协议。
- */
-export interface SessionHistoryComposer {
-  /**
-   * Composer 名（由具体实现声明）。
-   */
-  readonly name: string;
-
-  /**
-   * 当前会话 ID。
-   */
-  readonly sessionId: string;
-
-  /**
-   * 为本轮 Session 执行准备模型输入消息。
-   */
-  prepare(input: SessionHistoryPrepareInput): Promise<SessionRecordV1[]>;
-}

package/src/executor/composer/history/SessionHistoryWriter.ts

@@ -1,100 +0,0 @@
-/**
- * SessionHistoryWriter：单个 Session 的消息写入器。
- *
- * 关键点（中文）
- * - 只负责当前 session 的 user / assistant 消息补写。
- * - 只依赖当前 session 的 history Store，不感知其他 session。
- */
-
-import type { JsonObject } from "@/types/common/Json.js";
-import type {
-  SessionRecordV1,
-  SessionMetadataV1,
-} from "@/executor/types/SessionRecords.js";
-import type { SessionHistoryStore } from "@/executor/store/history/SessionHistoryStore.js";
-
-type SessionHistoryWriterOptions = {
-  /**
-   * 当前 session 标识。
-   */
-  sessionId: string;
-
-  /**
-   * 获取当前 session 对应的 history Store。
-   */
-  getHistoryStore: () => SessionHistoryStore;
-
-};
-
-/**
- * SessionHistoryWriter：单 session 写入器。
- */
-export class SessionHistoryWriter {
-  private readonly sessionId: string;
-  private readonly getHistoryStore: SessionHistoryWriterOptions["getHistoryStore"];
-
-  constructor(options: SessionHistoryWriterOptions) {
-    this.sessionId = String(options.sessionId || "").trim();
-    this.getHistoryStore = options.getHistoryStore;
-    if (!this.sessionId) {
-      throw new Error("SessionHistoryWriter requires a non-empty sessionId");
-    }
-  }
-
-  /**
-   * 追加一条 user 消息。
-   */
-  async append_user_message(params: {
-    message?: SessionRecordV1 | null;
-    text?: string;
-    extra?: JsonObject;
-  }): Promise<void> {
-    const historyStore = this.getHistoryStore();
-    if (params.message && typeof params.message === "object") {
-      await historyStore.write_record(params.message);
-      return;
-    }
-
-    const fallbackText = String(params.text || "").trim();
-    if (!fallbackText) return;
-
-    const message = historyStore.userText({
-      text: fallbackText,
-      metadata: {
-        sessionId: this.sessionId,
-        extra: params.extra,
-      } as Omit<SessionMetadataV1, "v" | "ts">,
-    });
-    await historyStore.write_record(message);
-  }
-
-  /**
-   * 追加一条 assistant 消息。
-   */
-  async append_assistant_message(params: {
-    message?: SessionRecordV1 | null;
-    fallbackText?: string;
-    extra?: JsonObject;
-  }): Promise<void> {
-    const historyStore = this.getHistoryStore();
-    if (params.message && typeof params.message === "object") {
-      await historyStore.finalize_inflight(params.message);
-      return;
-    }
-
-    const fallbackText = String(params.fallbackText || "").trim();
-    if (!fallbackText) return;
-
-    await historyStore.finalize_inflight(
-      historyStore.assistantText({
-        text: fallbackText,
-        metadata: {
-          sessionId: this.sessionId,
-          extra: params.extra,
-        },
-        kind: "normal",
-        source: "egress",
-      }),
-    );
-  }
-}