@downcity/agent 1.1.408 → 1.1.437

package/src/types/session/SessionMutation.ts

@@ -1,183 +0,0 @@
-/**
- * Session 的统一实时 Mutation 协议。
- *
- * Mutation 描述订阅之后发生的状态变化，不等同于 Active/Segment 持久化格式。
- */
-
-import type { SessionAssistantMessagePart, SessionMessage } from "@/types/session/SessionMessage.js";
-import type { AgentSessionCompactReason } from "@/types/sdk/AgentSessionCompact.js";
-
-/** 所有 Session Mutation 的公共字段。 */
-export interface SessionMutationBase {
-  /** 当前 Mutation 的稳定唯一标识。 */
-  mutation_id: string;
-  /** 当前 Mutation 所属 Session 标识。 */
-  session_id: string;
-  /** 当前 Mutation 创建时间戳（ms）。 */
-  created_at: number;
-}
-/** Message 创建或完整快照更新 Mutation。 */
-export type SessionMessageMutation = {
-  [TType in SessionMessage["type"]]: SessionMutationBase & {
-    /** Mutation 层级固定为 message。 */
-    variant: "message";
-    /** 当前完整 Message 类型。 */
-    type: TType;
-    /** 当前 Mutation 目标 Message 标识。 */
-    message_id: string;
-    /** 当前 Mutation 所属 Turn 标识。 */
-    turn_id?: string;
-    /** 当前 Message 在线性 Session 中的不可变顺序。 */
-    sequence: number;
-    /** 应用当前 Mutation 后的 Message revision。 */
-    revision: number;
-    /** 创建或更新后的完整 Message 快照。 */
-    message: Extract<SessionMessage, { type: TType }>;
-  };
-}[SessionMessage["type"]];
-
-/** Assistant Part 创建或完整快照更新 Mutation。 */
-export type SessionPartMutation = {
-  [TType in SessionAssistantMessagePart["type"]]: SessionMutationBase & {
-    /** Mutation 层级固定为 part。 */
-    variant: "part";
-    /** 当前完整 Part 类型。 */
-    type: TType;
-    /** 当前 Part 所属 Message 标识。 */
-    message_id: string;
-    /** 当前 Mutation 所属 Turn 标识。 */
-    turn_id?: string;
-    /** 应用当前 Mutation 后的 Message revision。 */
-    revision: number;
-    /** 当前被创建或更新的 Part 标识。 */
-    part_id: string;
-    /** 创建或更新后的完整 Part 快照。 */
-    part: SessionAssistantMessagePart & { type: TType };
-  };
-}[SessionAssistantMessagePart["type"]];
-
-/** Assistant Part 原始增量 Mutation 的公共字段。 */
-interface SessionDeltaMutationBase extends SessionMutationBase {
-  /** Mutation 层级固定为 delta。 */
-  variant: "delta";
-  /** 当前 Delta 所属 Message 标识。 */
-  message_id: string;
-  /** 当前 Mutation 所属 Turn 标识。 */
-  turn_id?: string;
-  /** 应用当前 Mutation 后的 Message revision。 */
-  revision: number;
-  /** 当前 Delta 所属 Part 标识。 */
-  part_id: string;
-  /** 本次新增的原始文本，不是累计全文。 */
-  delta: string;
-}
-
-/** Assistant 文本或推理的原始增量 Mutation。 */
-interface SessionTextDeltaMutation extends SessionDeltaMutationBase {
-  /** Delta 属于可见文本或推理文本。 */
-  type: "text" | "reasoning";
-}
-
-/** Assistant Tool 输入的原始增量 Mutation。 */
-interface SessionToolInputDeltaMutation extends SessionDeltaMutationBase {
-  /** Delta 属于 Tool 输入参数原文。 */
-  type: "tool_input";
-  /** 当前 Delta 所属 Tool Call 标识。 */
-  tool_call_id: string;
-}
-
-/** Assistant 文本、推理或 Tool 输入的原始增量 Mutation。 */
-export type SessionDeltaMutation =
-  | SessionTextDeltaMutation
-  | SessionToolInputDeltaMutation;
-
-/** Turn 生命周期 Mutation。 */
-export type SessionTurnMutation = SessionMutationBase & {
-  /** Mutation 层级固定为 turn。 */
-  variant: "turn";
-  /** 当前 Turn 是开始还是完成。 */
-  type: "start" | "finish";
-  /** 当前 Turn 的稳定唯一标识。 */
-  turn_id: string;
-  /** 当前 Turn 的执行状态。 */
-  status: "running" | "completed" | "failed" | "stopped";
-  /** Turn 完成时的最终可见文本。 */
-  text?: string;
-  /** Turn 失败或停止时的错误文本。 */
-  error?: string;
-};
-
-/** 显式 Session 压缩请求的生命周期 Mutation。 */
-export type SessionCompactMutation = SessionMutationBase & {
-  /** Mutation 层级固定为 compact。 */
-  variant: "compact";
-  /** 当前压缩请求是进入队列还是已经结束。 */
-  type: "start" | "finish";
-  /** 当前显式压缩请求的稳定标识。 */
-  compact_id: string;
-  /** 当前压缩请求的生命周期状态。 */
-  status: "queued" | "completed" | "failed";
-  /** 完成时是否实际提交了压缩计划。 */
-  compacted?: boolean;
-  /** 完成时的稳定结束原因。 */
-  reason?: AgentSessionCompactReason;
-  /** 压缩失败时的错误文本。 */
-  error?: string;
-};
-
-/** Session 标题变化 Mutation。 */
-export type SessionTitleMutation = SessionMutationBase & {
-  /** Mutation 层级固定为 session。 */
-  variant: "session";
-  /** 当前 Session 属性变化类型。 */
-  type: "title";
-  /** 当前 Session 最新标题。 */
-  title: string;
-};
-
-/** Session 模型配置变化 Mutation。 */
-export type SessionConfigMutation = SessionMutationBase & {
-  /** Mutation 层级固定为 session。 */
-  variant: "session";
-  /** 当前 Session 属性变化类型。 */
-  type: "config";
-  /** 当前 Session 已接受的模型可读标签。 */
-  model_label?: string;
-  /** 当前模型支持的总上下文窗口长度，单位为 token。 */
-  model_context_window?: number;
-};
-
-/** Session 自身属性变化 Mutation。 */
-export type SessionStateMutation = SessionTitleMutation | SessionConfigMutation;
-
-/** Session 对外唯一实时 Mutation 联合类型。 */
-export type SessionMutation =
-  | SessionMessageMutation
-  | SessionPartMutation
-  | SessionDeltaMutation
-  | SessionTurnMutation
-  | SessionCompactMutation
-  | SessionStateMutation;
-
-/** Session Mutation 订阅回调。 */
-export type SessionMutationSubscriber = (
-  mutation: SessionMutation,
-) => void | Promise<void>;
-
-/** 取消 Session Mutation 订阅的函数。 */
-export type SessionMutationUnsubscribe = () => void;
-
-/** 判断未知事件是否为 Session Mutation。 */
-export function is_session_mutation(input: unknown): input is SessionMutation {
-  if (!input || typeof input !== "object") return false;
-  const candidate = input as { mutation_id?: unknown; variant?: unknown; type?: unknown };
-  if (typeof candidate.mutation_id !== "string" || typeof candidate.type !== "string") return false;
-  return (
-    candidate.variant === "message" ||
-    candidate.variant === "part" ||
-    candidate.variant === "delta" ||
-    candidate.variant === "turn" ||
-    candidate.variant === "compact" ||
-    candidate.variant === "session"
-  );
-}

package/src/types/session/SessionOrigin.ts

@@ -1,21 +0,0 @@
-/**
- * Session 来源元数据。
- *
- * Session 仍然归 Agent 所有；来源只说明它由用户直接创建，
- * 还是由某个 Group 为成员协作创建，不改变 Session 的所有权。
- */
-
-/** Session 的创建来源。 */
-export type SessionOrigin =
-  | {
-      /** 来源类型。 */
-      readonly type: "user";
-    }
-  | {
-      /** 来源类型。 */
-      readonly type: "group";
-      /** 创建该成员 Session 的 Group 稳定标识。 */
-      readonly group_id: string;
-      /** 创建该成员 Session 的 GroupSession 稳定标识。 */
-      readonly group_session_id: string;
-    };

package/src/types/session/SessionSegment.ts

@@ -1,62 +0,0 @@
-/**
- * Session Message 物理分段类型。
- *
- * Segment 保存一段连续的原始 Message，并在文件末尾保存覆盖到该段末尾的累计 Summary。
- * Summary 只服务模型上下文，不占用 Session Message sequence。
- */
-
-import type { SessionMessage } from "@/types/session/SessionMessage.js";
-
-/** 已关闭 Segment 的累计上下文摘要。 */
-export interface SessionSegmentSummary {
-  /** 记录类型固定为 summary，用于和原始 Message 行区分。 */
-  record_type: "summary";
-  /** 当前 Summary 所属 Session 标识。 */
-  session_id: string;
-  /** 当前 Summary 的稳定唯一标识。 */
-  summary_id: string;
-  /** 当前 Summary 已覆盖到的最后一条真实 Message sequence。 */
-  through_sequence: number;
-  /** 供下一轮模型直接使用的累计摘要文本。 */
-  text: string;
-  /** 当前 Summary 创建时间戳（ms）。 */
-  created_at: number;
-}
-
-/** 已关闭 Segment 的 sequence 范围与文件位置。 */
-export interface SessionSegmentRange {
-  /** Segment 内第一条真实 Message sequence。 */
-  start_sequence: number;
-  /** Segment 内最后一条真实 Message sequence。 */
-  end_sequence: number;
-  /** Segment JSONL 文件的绝对路径。 */
-  file_path: string;
-}
-
-/** 从一个已关闭 Segment 读取出的完整数据。 */
-export interface SessionSegmentSnapshot {
-  /** Segment 的 sequence 范围。 */
-  range: SessionSegmentRange;
-  /** Segment 中按 sequence 升序排列的原始 Message。 */
-  messages: SessionMessage[];
-  /** Segment 文件末尾的累计 Summary。 */
-  summary: SessionSegmentSummary;
-}
-
-/** 当前模型上下文所需的最小 Session 快照。 */
-export interface SessionContextSnapshot {
-  /** 最新已关闭 Segment 的累计 Summary；从未 Compact 时为空。 */
-  summary: SessionSegmentSummary | null;
-  /** Active 中上次 Compact 后产生的全部真实 Message。 */
-  messages: SessionMessage[];
-}
-
-/** Session 历史存储统计。 */
-export interface SessionMessageStorageStats {
-  /** 当前 Session 已分配的真实 Message 总数。 */
-  message_count: number;
-  /** Active 与所有 Segment 文件占用的总字节数。 */
-  history_bytes: number;
-  /** 当前最新真实 Message；空 Session 时为空。 */
-  latest_message: SessionMessage | null;
-}

package/src/types/store/SessionDataStore.ts

@@ -1,109 +0,0 @@
-/**
- * 单个 Session 数据存储类型。
- *
- * 关键点（中文）
- * - Session 领域只依赖这些持久化能力，不感知 JSONL、目录或文件名。
- * - Message、Metadata 与 Instruction 共享同一个 Session 生命周期边界。
- */
-
-import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
-import type {
-  SessionAssistantMessage,
-  SessionMessage,
-} from "@/types/session/SessionMessage.js";
-import type {
-  SessionMessageStorageStats,
-  SessionSegmentRange,
-  SessionSegmentSnapshot,
-  SessionSegmentSummary,
-} from "@/types/session/SessionSegment.js";
-import type { SessionAttachmentStore } from "@/types/store/SessionAttachmentStore.js";
-
-/** 在 Message Store 写事务中创建新消息所需的稳定状态。 */
-export interface SessionMessageCommitState {
-  /** 下一条真实 Message 应使用的全局线性顺序。 */
-  message_sequence: number;
-  /** 当前 Active 与 Assistant 草稿组成的运行态 Message。 */
-  messages: SessionMessage[];
-}
-
-/** Active Message 压缩提交参数。 */
-export interface CompactActiveMessagesInput {
-  /** 移入新 Segment 的最后一条真实 Message sequence。 */
-  through_sequence: number;
-  /** 写入新 Segment 末尾的累计上下文摘要。 */
-  summary: SessionSegmentSummary;
-}
-
-/** Active Message 压缩提交结果。 */
-export interface CompactActiveMessagesResult {
-  /** 本次创建的不可变历史分段。 */
-  segment: SessionSegmentSnapshot;
-  /** 压缩后继续保留在 Active 区域的 Message。 */
-  active_messages: SessionMessage[];
-}
-
-/** Session Message 持久化能力。 */
-export interface SessionMessageStore {
-  /** 初始化消息存储，并修复可恢复的中断状态。 */
-  initialize(): Promise<void>;
-  /** 读取当前 Active Message 与运行中的 Assistant 草稿。 */
-  list_messages(): Promise<SessionMessage[]>;
-  /** 读取指定 sequence 之前最近的完整历史分段。 */
-  read_segment_before(before_sequence: number): Promise<SessionSegmentSnapshot | null>;
-  /** 读取最新历史分段的累计摘要。 */
-  read_latest_summary(): Promise<SessionSegmentSummary | null>;
-  /** 读取当前 Session 的全部真实历史消息。 */
-  list_history_messages(): Promise<SessionMessage[]>;
-  /** 读取消息数量、存储大小与最新消息统计。 */
-  stats(): Promise<SessionMessageStorageStats>;
-  /** 判断指定 sequence 之前是否存在历史分段。 */
-  has_segment_before(before_sequence: number): Promise<boolean>;
-  /** 计算当前 Active Message 之前的读取边界。 */
-  active_before_sequence(messages: SessionMessage[]): Promise<number | undefined>;
-  /** 读取当前运行中的 Assistant 草稿。 */
-  read_assistant_message(): Promise<SessionAssistantMessage | null>;
-  /** 原子覆盖当前运行中的 Assistant 草稿。 */
-  write_assistant_message(message: SessionAssistantMessage): Promise<void>;
-  /** 在存储事务中创建唯一 Assistant 草稿。 */
-  create_assistant_message(
-    build_message: (state: SessionMessageCommitState) => SessionAssistantMessage,
-  ): Promise<SessionAssistantMessage>;
-  /** 在存储事务中追加一条 Message。 */
-  append_message(
-    build_message: (state: SessionMessageCommitState) => SessionMessage,
-  ): Promise<SessionMessage>;
-  /** 提交最终 Assistant Message 并删除运行中草稿。 */
-  finalize_assistant_message(message: SessionAssistantMessage): Promise<void>;
-  /** 将 Active 前缀压缩为不可变历史分段。 */
-  compact_active(input: CompactActiveMessagesInput): Promise<CompactActiveMessagesResult>;
-  /** 读取全部历史分段的 sequence 索引。 */
-  list_segment_ranges(): Promise<SessionSegmentRange[]>;
-}
-
-/** 单个 Session 的领域持久化视图。 */
-export interface SessionDataStore {
-  /** 当前 Session 的稳定标识。 */
-  readonly session_id: string;
-
-  /** 当前 Session 的 Message 持久化能力。 */
-  readonly messages: SessionMessageStore;
-
-  /** 当前 Session 的附件持久化能力。 */
-  readonly attachments: SessionAttachmentStore;
-
-  /** 读取 Session Metadata；不存在时返回规范化的初始值。 */
-  read_metadata(): Promise<SessionHistoryMetaV1>;
-
-  /** 原子写入完整 Session Metadata。 */
-  write_metadata(metadata: SessionHistoryMetaV1): Promise<void>;
-
-  /** 判断 Session 是否存在显式固化的完整 system。 */
-  has_instruction(): Promise<boolean>;
-
-  /** 读取显式固化的完整 system；不存在时返回 null。 */
-  read_instruction(): Promise<string | null>;
-
-  /** 原子写入显式固化的完整 system。 */
-  write_instruction(instruction: string): Promise<void>;
-}

package/src/utils/Template.ts

@@ -1,28 +0,0 @@
-/**
- * 字符串模板渲染工具。
- *
- * 职责说明（中文）
- * - 提供统一的 `{{variable}}` 占位符替换能力。
- * - 供 init 模板与 runtime system prompt 渲染复用，避免重复实现。
- */
-
-import type { TemplateVariableMap } from "@/types/common/Template.js";
-
-/**
- * 渲染模板中的 `{{variable}}` 占位符。
- *
- * 关键点（中文）
- * - 变量名支持字母、数字、下划线，且允许写成 `{{ key }}`。
- * - 未提供值的变量保持原样，便于排查模板与变量映射不一致问题。
- */
-export function render_template_variables(
-  template: string,
-  variables: TemplateVariableMap,
-): string {
-  if (!template) return template;
-  return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (match, key) => {
-    return Object.prototype.hasOwnProperty.call(variables, key)
-      ? String(variables[key])
-      : match;
-  });
-}

package/src/workspace/WorkspacePaths.ts

@@ -1,37 +0,0 @@
-/**
- * Agent 内部数据路径规则模块。
- *
- * 职责说明（中文）
- * - 统一管理 Agent 根目录下的运行时状态路径。
- * - 负责把“路径协议”集中到一个模块，避免各领域模块自行拼接字符串。
- * - 为初始化、日志、任务与调试文件等非 Store 子系统提供一致的路径入口。
- *
- * 边界说明（中文）
- * - 这里只负责路径计算，不负责目录创建、文件读写或存在性校验。
- * - 这里描述的是 Agent 私有数据约定，不涉及项目目录或平台级全局目录布局。
- */
-import path from "path";
-
-/**
- * 返回 Agent 内部数据根目录。
- */
-export function get_downcity_dir_path(data_path: string): string {
-  return path.resolve(data_path);
-}
-
-/**
- * 返回项目日志目录路径。
- */
-export function get_logs_dir_path(cwd: string): string {
-  return path.join(get_downcity_dir_path(cwd), "logs");
-}
-
-/**
- * Plugin Schedule JSONL 路径。
- *
- * 关键点（中文）
- * - 调度任务属于 Agent，因此放在 Agent 集中式内部数据目录。
- */
-export function get_downcity_schedule_db_path(cwd: string): string {
-  return path.join(get_downcity_dir_path(cwd), "schedule.jsonl");
-}