@downcity/agent 1.1.237 → 1.1.258

package/src/executor/types/SessionHistoryPaths.ts

@@ -1,38 +0,0 @@
-/**
- * JsonlSessionHistoryStore 路径覆盖类型。
- *
- * 关键点（中文）
- * - 用于把 history Store 落盘路径定向到自定义目录（例如 task run 目录）。
- * - 每个字段都为可选，未提供时回退到默认 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/*`。
- */
-export type SessionHistoryPathOverrides = {
-  /**
-   * Session 根目录（通常是 `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>`）。
-   */
-  sessionDirPath?: string;
-
-  /**
-   * 消息目录（通常是 `.../messages`）。
-   */
-  messagesDirPath?: string;
-
-  /**
-   * 消息文件完整路径（通常是 `.../messages/messages.jsonl`）。
-   */
-  messagesFilePath?: string;
-
-  /**
-   * 元数据文件完整路径（通常是 `.../messages/meta.json`）。
-   */
-  metaFilePath?: string;
-
-  /**
-   * 历史归档目录（通常是 `.../messages/archive`）。
-   */
-  archiveDirPath?: string;
-
-  /**
-   * 运行中 assistant 快照路径（通常是 `.../messages/assistant_message.json`）。
-   */
-  inflightFilePath?: string;
-};

package/src/session/SessionSystemBuilder.ts

@@ -1,262 +0,0 @@
-/**
- * SDK Session 默认 system composer。
- *
- * 关键点（中文）
- * - 面向 `Agent` SDK 的本地会话执行场景。
- * - 注入调用方显式传入的静态 instruction、受托管 plugin system 与显式注册 plugin system。
- * - SDK 不在 system 中注入动态变量；动态上下文应由调用方放入 user message。
- */
-
-import type { SessionSystemComposer } from "@executor/composer/system/SessionSystemComposer.js";
-import type { SessionSystemMessage } from "@/executor/types/SessionPrompts.js";
-import type {
-  AgentSessionSystemBlock,
-  AgentSessionSystemSessionInfo,
-} from "@/types/agent/SessionTypes.js";
-import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
-
-/**
- * 解析 SDK session system blocks 的输入。
- */
-export interface BuildSessionSystemBlocksParams {
-  /**
-   * 当前 agent 的稳定标识。
-   */
-  agentId: string;
-
-  /**
-   * 当前 agent 绑定的项目根目录。
-   */
-  projectRoot: string;
-
-  /**
-   * 当前 sessionId。
-   */
-  sessionId: string;
-
-  /**
-   * 当前 session 首次创建时间（ms）。
-   */
-  createdAt: number;
-
-  /**
-   * 当前 session 初始化时解析到的系统时区。
-   */
-  timezone: string;
-
-  /**
-   * 读取当前 SDK 调用方传入的 instruction system blocks。
-   */
-  getInstructionSystemBlocks: () => AgentSessionSystemBlock[];
-
-  /**
-   * 读取当前显式注入的受托管 plugin system blocks。
-   */
-  getManagedPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
-
-  /**
-   * 读取当前显式注册 plugin 的 system blocks。
-   */
-  getPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
-}
-
-type SessionSystemBuilderOptions = {
-  /**
-   * 当前 agent 的稳定标识。
-   */
-  agentId: string;
-
-  /**
-   * 当前 agent 绑定的项目根目录。
-   */
-  projectRoot: string;
-
-  /**
-   * 读取当前 session 首次创建时间（ms）。
-   */
-  getSessionCreatedAt: () => number;
-
-  /**
-   * 读取当前 session 初始化时解析到的系统时区。
-   */
-  getSessionTimezone: () => string;
-
-  /**
-   * 读取当前 SDK 调用方传入的 instruction system blocks。
-   */
-  getInstructionSystemBlocks: () => AgentSessionSystemBlock[];
-
-  /**
-   * 读取当前显式注册 plugin 的 system blocks。
-   */
-  getPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
-
-  /**
-   * 读取当前显式注入的受托管 plugin system blocks。
-   */
-  getManagedPluginSystemBlocks: () => Promise<AgentSessionSystemBlock[]>;
-};
-
-function normalizeSystemBlocks(
-  blocks: AgentSessionSystemBlock[],
-): AgentSessionSystemBlock[] {
-  if (!Array.isArray(blocks)) return [];
-  return blocks
-    .map((block) => {
-      const content = String(block?.content || "").trim();
-      if (!content) return null;
-      const source = block.source;
-      if (
-        source !== "core" &&
-        source !== "instruction" &&
-        source !== "plugin" &&
-        source !== "session"
-      ) {
-        return null;
-      }
-      return {
-        source,
-        name: String(block.name || source).trim() || source,
-        content,
-      } satisfies AgentSessionSystemBlock;
-    })
-    .filter((block): block is AgentSessionSystemBlock => Boolean(block));
-}
-
-function createSessionInfo(
-  params: Pick<
-    BuildSessionSystemBlocksParams,
-    "agentId" | "sessionId" | "projectRoot" | "createdAt" | "timezone"
-  >,
-): AgentSessionSystemSessionInfo {
-  const createdAt = Number.isFinite(params.createdAt) ? params.createdAt : 0;
-  return {
-    agentId: String(params.agentId || "").trim(),
-    sessionId: String(params.sessionId || "").trim(),
-    projectRoot: String(params.projectRoot || "").trim(),
-    createdAt: new Date(createdAt).toISOString(),
-    timezone: String(params.timezone || "").trim() || "UTC",
-  };
-}
-
-function createSessionSystemBlock(
-  session: AgentSessionSystemSessionInfo,
-): AgentSessionSystemBlock {
-  const content = [
-    "当前会话上下文：",
-    `你正在服务 agent "${session.agentId}" 的 session "${session.sessionId}"。`,
-    `当前项目根目录是 "${session.projectRoot}"。`,
-    `本会话创建于 ${session.createdAt}，参考时区是 ${session.timezone}。`,
-    "这个创建时间是当前会话的稳定参考时间，不代表每轮运行时的当前时间。",
-    "如果用户消息中提供了新的当前时间、相对时间或其他动态上下文，应优先使用用户消息中的动态信息。",
-  ].join("\n");
-  return {
-    source: "session",
-    name: "context",
-    content,
-  };
-}
-
-/**
- * 解析 SDK session 当前生效的 system blocks。
- */
-export async function buildSessionSystemBlocks(
-  params: BuildSessionSystemBlocksParams,
-): Promise<AgentSessionSystemBlock[]> {
-  const agentId = String(params.agentId || "").trim();
-  const projectRoot = String(params.projectRoot || "").trim();
-  const sessionId = String(params.sessionId || "").trim();
-  const createdAt = Number(params.createdAt || 0);
-  const timezone = String(params.timezone || "").trim();
-  if (!agentId) {
-    throw new Error("buildSessionSystemBlocks requires a non-empty agentId");
-  }
-  if (!projectRoot) {
-    throw new Error("buildSessionSystemBlocks requires a non-empty projectRoot");
-  }
-  if (!sessionId) {
-    throw new Error("buildSessionSystemBlocks requires a non-empty sessionId");
-  }
-  if (!Number.isFinite(createdAt) || createdAt <= 0) {
-    throw new Error("buildSessionSystemBlocks requires a valid createdAt");
-  }
-  if (!timezone) {
-    throw new Error("buildSessionSystemBlocks requires a non-empty timezone");
-  }
-  return [
-    ...normalizeSystemBlocks(params.getInstructionSystemBlocks()),
-    ...normalizeSystemBlocks(await params.getManagedPluginSystemBlocks()),
-    ...normalizeSystemBlocks(await params.getPluginSystemBlocks()),
-    // session block 放在最后，尽量保留前缀 system blocks 的跨 session 缓存命中。
-    createSessionSystemBlock(
-      createSessionInfo({ agentId, projectRoot, sessionId, createdAt, timezone }),
-    ),
-  ];
-}
-
-/**
- * 解析 SDK session 当前生效的 system messages。
- */
-export async function buildSessionSystemMessages(
-  params: BuildSessionSystemBlocksParams,
-): Promise<SessionSystemMessage[]> {
-  const blocks = await buildSessionSystemBlocks(params);
-  return blocks.map((block) => ({
-    role: "system" as const,
-    content: block.content,
-  }));
-}
-
-/**
- * SDK Session system composer 实现。
- */
-export class SessionSystemBuilder implements SessionSystemComposer {
-  readonly name = "sdk_prompt_system";
-
-  private readonly agentId: string;
-  private readonly projectRoot: string;
-  private readonly getSessionCreatedAt: SessionSystemBuilderOptions["getSessionCreatedAt"];
-  private readonly getSessionTimezone: SessionSystemBuilderOptions["getSessionTimezone"];
-  private readonly getInstructionSystemBlocks: SessionSystemBuilderOptions["getInstructionSystemBlocks"];
-  private readonly getManagedPluginSystemBlocks: SessionSystemBuilderOptions["getManagedPluginSystemBlocks"];
-  private readonly getPluginSystemBlocks: SessionSystemBuilderOptions["getPluginSystemBlocks"];
-
-  constructor(options: SessionSystemBuilderOptions) {
-    this.agentId = String(options.agentId || "").trim();
-    this.projectRoot = String(options.projectRoot || "").trim();
-    this.getSessionCreatedAt = options.getSessionCreatedAt;
-    this.getSessionTimezone = options.getSessionTimezone;
-    this.getInstructionSystemBlocks = options.getInstructionSystemBlocks;
-    this.getManagedPluginSystemBlocks = options.getManagedPluginSystemBlocks;
-    this.getPluginSystemBlocks = options.getPluginSystemBlocks;
-    if (!this.agentId) {
-      throw new Error("SessionSystemBuilder requires a non-empty agentId");
-    }
-    if (!this.projectRoot) {
-      throw new Error("SessionSystemBuilder requires a non-empty projectRoot");
-    }
-  }
-
-  /**
-   * 解析本轮 SDK session system messages。
-   */
-  async resolve(run_context: SessionRunContext) {
-    const sessionId = String(run_context.sessionId || "").trim();
-    if (!sessionId) {
-      throw new Error("SessionSystemBuilder.resolve requires a non-empty sessionId");
-    }
-    return await buildSessionSystemMessages({
-      agentId: this.agentId,
-      projectRoot: this.projectRoot,
-      sessionId,
-      createdAt: this.getSessionCreatedAt(),
-      timezone: this.getSessionTimezone(),
-      getInstructionSystemBlocks: this.getInstructionSystemBlocks,
-      getManagedPluginSystemBlocks: this.getManagedPluginSystemBlocks,
-      getPluginSystemBlocks: async () =>
-        run_context.agentPlugins
-          ? await run_context.agentPlugins.systemBlocks()
-          : await this.getPluginSystemBlocks(),
-    });
-  }
-}

package/src/session/recorder/SessionRecorderHistoryStore.ts

@@ -1,256 +0,0 @@
-/**
- * SessionRecorder 到 Executor SessionHistoryStore 的内部投影适配器。
- *
- * 关键点（中文）
- * - Recorder 的 active.jsonl、segments 与 assistant_message.json 共同组成持久化事实源。
- * - Executor 继续读取临时 UIMessage 投影，不直接拥有文件写入权。
- * - 流式草稿写入由 AssistantMessageWriter 负责，Executor 的旧接口只提供投影兼容。
- */
-
-import { nanoid } from "nanoid";
-import type {
-  SessionActionRecordV1,
-  SessionMetadataV1,
-  SessionRecordV1,
-} from "@/executor/types/SessionRecords.js";
-import { is_session_action_record } from "@/executor/types/SessionRecords.js";
-import type {
-  SessionHistoryCompactInput,
-  SessionHistoryStore,
-} from "@/executor/store/history/SessionHistoryStore.js";
-import { SessionRecorder } from "@/session/recorder/SessionRecorder.js";
-import {
-  from_ui_assistant_parts,
-  from_ui_user_parts,
-  to_executor_ui_message,
-} from "@/session/recorder/SessionMessageCodec.js";
-import { compact_session_recorder_messages } from "@/session/recorder/SessionRecorderCompaction.js";
-
-/** Recorder History Store 构造参数。 */
-export interface SessionRecorderHistoryStoreOptions {
-  /** 当前 Session 标识。 */
-  session_id: string;
-  /** 当前 Session Recorder。 */
-  recorder: SessionRecorder;
-}
-
-/** 只把 canonical SessionMessage 投影给 Executor 的 Store。 */
-export class SessionRecorderHistoryStore implements SessionHistoryStore {
-  readonly sessionId: string;
-
-  private readonly recorder: SessionRecorder;
-
-  constructor(options: SessionRecorderHistoryStoreOptions) {
-    this.sessionId = String(options.session_id || "").trim();
-    this.recorder = options.recorder;
-    if (!this.sessionId) {
-      throw new Error("SessionRecorderHistoryStore requires session_id");
-    }
-  }
-
-  /** 把外部 user/assistant/action 写入请求收口到 Recorder。 */
-  async write_record(message: SessionRecordV1): Promise<void> {
-    if (is_session_action_record(message)) {
-      const action = message as SessionActionRecordV1;
-      const existing = this.recorder.get_message(action.id);
-      if (existing?.type === "action") {
-        if (action.state !== "running") {
-          await this.recorder.update_action_message(
-            action.id,
-            action.state,
-            {
-              title: action.title,
-              description: action.description,
-            },
-          );
-        }
-        return;
-      }
-      const writer = await this.recorder.open_action_message({
-        message_id: action.id,
-        turn_id: action.metadata.turnId,
-        action_type: infer_action_type(action.id),
-        title: action.title,
-        description: action.description,
-      });
-      if (action.state === "completed") await writer.complete();
-      if (action.state === "failed") await writer.fail(action.description || action.title);
-      return;
-    }
-
-    if (message.role === "user") {
-      const metadata = message.metadata || {
-        v: 1 as const,
-        ts: Date.now(),
-        sessionId: this.sessionId,
-      };
-      await this.recorder.append_user_message({
-        turn_id: String(metadata.turnId || `external:${nanoid(10)}`),
-        input_type:
-          metadata.extra?.inputType === "steer" ? "steer" : "prompt",
-        parts: from_ui_user_parts(message.parts),
-      });
-      return;
-    }
-
-    const metadata = message.metadata || {
-      v: 1 as const,
-      ts: Date.now(),
-      sessionId: this.sessionId,
-    };
-    await this.recorder.append_completed_assistant_message({
-      turn_id: metadata.turnId,
-      parts: from_ui_assistant_parts(message.parts),
-      visibility:
-        metadata.extra?.visibility === "internal"
-          ? "internal"
-          : "visible",
-      kind: metadata.kind === "summary" ? "summary" : "normal",
-    });
-  }
-
-  /** 从 Recorder 当前快照投影运行中的 Assistant。 */
-  async read_inflight(): Promise<SessionRecordV1 | null> {
-    const snapshot = await this.recorder.context_snapshot();
-    const assistant = [...snapshot.messages]
-      .reverse()
-      .find(
-        (message) =>
-          message.type === "assistant" && message.status === "streaming",
-      );
-    return assistant ? to_executor_ui_message(assistant) : null;
-  }
-
-  /** Executor 草稿写入口不持久化；流式内容由 Recorder writer 负责。 */
-  async write_inflight(_message: SessionRecordV1): Promise<void> {}
-
-  /** Executor 草稿收口入口不持久化；Assistant writer 负责 complete。 */
-  async finalize_inflight(_message?: SessionRecordV1 | null): Promise<void> {}
-
-  /** 返回 Context Composer 使用的 UIMessage 投影。 */
-  async list_records(): Promise<SessionRecordV1[]> {
-    const snapshot = await this.recorder.context_snapshot();
-    const records: SessionRecordV1[] = [];
-    if (snapshot.summary) {
-      records.push({
-        id: snapshot.summary.summary_id,
-        role: "assistant",
-        metadata: {
-          v: 1,
-          ts: snapshot.summary.created_at,
-          sessionId: this.sessionId,
-          source: "compact",
-          kind: "summary",
-          extra: {
-            visibility: "internal",
-            summaryThroughSequence: snapshot.summary.through_sequence,
-          },
-        },
-        parts: [{ type: "text", text: snapshot.summary.text }],
-      });
-    }
-    for (const message of snapshot.messages) {
-      if (message.type !== "user" && message.type !== "assistant") continue;
-      const projected = to_executor_ui_message(message);
-      if (projected) records.push(projected);
-    }
-    return records;
-  }
-
-  /** 返回 Context Message 区间。 */
-  async slice_records(start: number, end: number): Promise<SessionRecordV1[]> {
-    return (await this.list_records()).slice(start, end);
-  }
-
-  /** 返回 Context Message 数量。 */
-  async record_count(): Promise<number> {
-    return (await this.list_records()).length;
-  }
-
-  /** Recorder metadata 由 SessionStateService 管理。 */
-  async meta(): Promise<Record<string, unknown>> {
-    return {};
-  }
-
-  /** 通过 Recorder 把 Active 前缀关闭为带累计 Summary 的 Segment。 */
-  async compact(input: SessionHistoryCompactInput): Promise<{
-    compacted: boolean;
-    reason?: string;
-  }> {
-    return await compact_session_recorder_messages({
-      recorder: this.recorder,
-      compact_input: input,
-    });
-  }
-
-  /** 构造临时 user UIMessage。 */
-  userText(input: {
-    text: string;
-    metadata: Omit<SessionMetadataV1, "v" | "ts"> &
-      Partial<Pick<SessionMetadataV1, "ts">>;
-    id?: string;
-  }): SessionRecordV1 {
-    const { ts, ...metadata } = input.metadata;
-    return {
-      id: input.id || `u:${this.sessionId}:${nanoid(10)}`,
-      role: "user",
-      metadata: {
-        v: 1,
-        ts: typeof ts === "number" ? ts : Date.now(),
-        ...metadata,
-        source: "ingress",
-        kind: "normal",
-      },
-      parts: [{ type: "text", text: String(input.text || "") }],
-    };
-  }
-
-  /** 构造临时 assistant UIMessage。 */
-  assistantText(input: {
-    text: string;
-    metadata: Omit<SessionMetadataV1, "v" | "ts"> &
-      Partial<Pick<SessionMetadataV1, "ts">>;
-    id?: string;
-    kind?: "normal" | "summary";
-    source?: "egress" | "compact";
-  }): SessionRecordV1 {
-    const { ts, ...metadata } = input.metadata;
-    return {
-      id: input.id || `a:${this.sessionId}:${nanoid(10)}`,
-      role: "assistant",
-      metadata: {
-        v: 1,
-        ts: typeof ts === "number" ? ts : Date.now(),
-        ...metadata,
-        source: input.source || "egress",
-        kind: input.kind || "normal",
-      },
-      parts: [{ type: "text", text: String(input.text || "") }],
-    };
-  }
-
-  /** 返回 action 原结构，真正持久化仍经过 write_record。 */
-  action(input: {
-    action: SessionActionRecordV1;
-    metadata: Pick<SessionMetadataV1, "sessionId"> &
-      Partial<Pick<SessionMetadataV1, "ts">>;
-    id?: string;
-  }): SessionActionRecordV1 {
-    return {
-      ...input.action,
-      id: input.id || input.action.id,
-      metadata: {
-        ...input.action.metadata,
-        sessionId: input.metadata.sessionId,
-        ts:
-          typeof input.metadata.ts === "number"
-            ? input.metadata.ts
-            : input.action.metadata.ts,
-      },
-    };
-  }
-}
-
-function infer_action_type(message_id: string): string {
-  return String(message_id || "").split(":")[0] || "action";
-}