@downcity/agent 1.1.32 → 1.1.43

package/bin/config/Paths.js

@@ -1,10 +1,14 @@
 /**
- * City Env Paths：项目与运行目录路径规则模块。
+ * Agent 项目路径规则模块。
  *
- * 关键点（中文）
- * - 统一管理单个 agent 项目内 `.downcity` 及其子目录/文件路径规则。
- * - 避免路径字符串在不同模块重复拼接，降低维护成本。
- * - 这里描述的是“项目级路径约定”，与 city 包中的全局运行态路径约定分开。
+ * 职责说明（中文）
+ * - 统一管理单个 agent 项目根目录下的静态文件、`.downcity` 目录与运行时状态文件路径。
+ * - 负责把“路径协议”集中到一个模块，避免各领域模块自行拼接字符串。
+ * - 为初始化、会话存储、聊天路由、调试文件等子系统提供一致的路径入口。
+ *
+ * 边界说明（中文）
+ * - 这里只负责路径计算，不负责目录创建、文件读写或存在性校验。
+ * - 这里描述的是单项目约定，不涉及平台级全局目录布局。
  */
 import path from "path";
 /**
@@ -15,9 +19,23 @@ import path from "path";
  * - 与 SOUL 一起作为静态 prompt 入口。
  */
 export const PROFILE_MD_FILE_CANDIDATES = ["PROFILE.md"];
+/**
+ * 返回项目主 `PROFILE.md` 的标准路径。
+ *
+ * 关键点（中文）
+ * - 当前始终返回候选列表中的第一优先级文件。
+ * - 调用方可把该路径视为初始化时默认写入位置。
+ */
 export function getProfileMdPath(cwd) {
     return path.join(cwd, PROFILE_MD_FILE_CANDIDATES[0]);
 }
+/**
+ * 返回 `PROFILE.md` 的全部候选路径。
+ *
+ * 关键点（中文）
+ * - 便于后续扩展多候选命名时保持调用方逻辑不变。
+ * - 当前虽然只有一个候选值，仍统一暴露数组接口。
+ */
 export function getProfileMdCandidatePaths(cwd) {
     return PROFILE_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
 }
@@ -29,36 +47,92 @@ export function getProfileMdCandidatePaths(cwd) {
  * - 统一由 Paths 模块暴露，避免调用方散落硬编码。
  */
 export const SOUL_MD_FILE_CANDIDATES = ["SOUL.md"];
+/**
+ * 返回项目主 `SOUL.md` 的标准路径。
+ *
+ * 关键点（中文）
+ * - 当前始终返回候选列表中的第一优先级文件。
+ * - 与 `PROFILE.md` 一样，属于静态 system prompt 入口文件。
+ */
 export function getSoulMdPath(cwd) {
     return path.join(cwd, SOUL_MD_FILE_CANDIDATES[0]);
 }
+/**
+ * 返回 `SOUL.md` 的全部候选路径。
+ *
+ * 关键点（中文）
+ * - 供探测逻辑统一遍历候选文件名。
+ * - 保留数组形式便于后续新增兼容命名。
+ */
 export function getSoulMdCandidatePaths(cwd) {
     return SOUL_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
 }
+/**
+ * 返回项目主配置文件 `downcity.json` 的路径。
+ */
 export function getDowncityJsonPath(cwd) {
     return path.join(cwd, "downcity.json");
 }
+/**
+ * 返回项目运行时状态根目录 `.downcity` 的路径。
+ */
 export function getDowncityDirPath(cwd) {
     return path.join(cwd, ".downcity");
 }
+/**
+ * 返回项目内 schema 快照文件路径。
+ *
+ * 关键点（中文）
+ * - 初始化流程会把本地 schema 副本写到这里，供编辑器联想与校验。
+ */
 export function getDowncitySchemaPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "schema", "downcity.schema.json");
 }
+/**
+ * 返回 `.downcity/config` 目录路径。
+ *
+ * 关键点（中文）
+ * - 用于存放项目级额外配置快照或未来扩展的辅助配置文件。
+ */
 export function getDowncityConfigDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "config");
 }
+/**
+ * 返回项目日志目录路径。
+ */
 export function getLogsDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "logs");
 }
+/**
+ * 返回项目缓存目录路径。
+ *
+ * 关键点（中文）
+ * - 当前使用隐藏命名 `.cache`，避免与用户业务目录混淆。
+ */
 export function getCacheDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), ".cache");
 }
+/**
+ * 返回 profile 运行态目录路径。
+ */
 export function getDowncityProfileDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "profile");
 }
+/**
+ * 返回 profile 主记忆文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件通常承载主画像或核心长期 profile 信息。
+ */
 export function getDowncityProfilePrimaryPath(cwd) {
     return path.join(getDowncityProfileDirPath(cwd), "Primary.md");
 }
+/**
+ * 返回 profile 补充记忆文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件用于存放不适合进入主 profile 的补充材料。
+ */
 export function getDowncityProfileOtherPath(cwd) {
     return path.join(getDowncityProfileDirPath(cwd), "other.md");
 }
@@ -91,7 +165,7 @@ export function getDowncityMemoryDailyPath(cwd, date) {
     return path.join(getDowncityMemoryDailyDirPath(cwd), fileName);
 }
 /**
- * Service Schedule JSONL 路径。
+ * Plugin Schedule JSONL 路径。
  *
  * 关键点（中文）
  * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
@@ -99,18 +173,42 @@ export function getDowncityMemoryDailyPath(cwd, date) {
 export function getDowncityScheduleDbPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "schedule.jsonl");
 }
+/**
+ * 返回项目运行时数据目录路径。
+ */
 export function getDowncityDataDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "data");
 }
+/**
+ * 返回项目内全部 agent 实例目录的根路径。
+ *
+ * 关键点（中文）
+ * - 单项目虽然通常只有一个 agent 入口，但底层仍按 agentId 分层组织。
+ */
 export function getDowncityAgentsRootDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "agents");
 }
+/**
+ * 返回指定 agent 的运行态目录路径。
+ *
+ * 关键点（中文）
+ * - `agentId` 会做 URL 编码，避免特殊字符污染文件系统结构。
+ */
 export function getDowncityAgentDirPath(cwd, agentId) {
     return path.join(getDowncityAgentsRootDirPath(cwd), encodeURIComponent(String(agentId || "").trim()));
 }
+/**
+ * 返回指定 agent 的 session 根目录路径。
+ */
 export function getDowncitySessionRootDirPath(cwd, agentId) {
     return path.join(getDowncityAgentDirPath(cwd, agentId), "sessions");
 }
+/**
+ * 返回指定 session 的运行态目录路径。
+ *
+ * 关键点（中文）
+ * - `sessionId` 同样会做 URL 编码，保证路径可安全持久化。
+ */
 export function getDowncitySessionDirPath(cwd, agentId, sessionId) {
     return path.join(getDowncitySessionRootDirPath(cwd, agentId), encodeURIComponent(String(sessionId || "").trim()));
 }
@@ -124,29 +222,68 @@ export function getDowncitySessionDirPath(cwd, agentId, sessionId) {
 export function getDowncitySessionMessagesDirPath(cwd, agentId, sessionId) {
     return path.join(getDowncitySessionDirPath(cwd, agentId, sessionId), "messages");
 }
+/**
+ * 返回 session 消息事实源文件路径。
+ *
+ * 关键点（中文）
+ * - 当前唯一事实源是 `messages.jsonl`，所有历史组装都应基于它。
+ */
 export function getDowncitySessionMessagesPath(cwd, agentId, sessionId) {
     return path.join(getDowncitySessionMessagesDirPath(cwd, agentId, sessionId), "messages.jsonl");
 }
+/**
+ * 返回 session 历史元信息文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件保存 compaction、更新时间、SDK 配置等附加元信息。
+ */
 export function getDowncitySessionHistoryMetaPath(cwd, agentId, sessionId) {
     return path.join(getDowncitySessionMessagesDirPath(cwd, agentId, sessionId), "meta.json");
 }
+/**
+ * 返回 session 消息归档目录路径。
+ *
+ * 关键点（中文）
+ * - compaction 时被折叠的原始消息段会写入该目录，便于审计和回溯。
+ */
 export function getDowncitySessionMessagesArchiveDirPath(cwd, agentId, sessionId) {
     return path.join(getDowncitySessionMessagesDirPath(cwd, agentId, sessionId), "archive");
 }
+/**
+ * 返回指定归档文件的完整路径。
+ *
+ * 关键点（中文）
+ * - `archiveId` 会做 URL 编码，避免 compaction 生成的标识污染文件名。
+ */
 export function getDowncitySessionMessagesArchivePath(cwd, agentId, sessionId, archiveId) {
     return path.join(getDowncitySessionMessagesArchiveDirPath(cwd, agentId, sessionId), `${encodeURIComponent(String(archiveId || "").trim())}.json`);
 }
+/**
+ * 返回项目公开静态资源目录路径。
+ */
 export function getDowncityPublicDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "public");
 }
+/**
+ * 返回项目任务目录路径。
+ *
+ * 关键点（中文）
+ * - 该目录用于存放任务相关的本地文件与运行时数据。
+ */
 export function getDowncityTasksDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), "task");
 }
+/**
+ * 返回项目调试目录路径。
+ *
+ * 关键点（中文）
+ * - 当前使用隐藏目录 `.debug`，避免与用户显式业务目录冲突。
+ */
 export function getDowncityDebugDirPath(cwd) {
     return path.join(getDowncityDirPath(cwd), ".debug");
 }
 /**
- * Chat 元信息目录（由 service/builtins/chat 维护）。
+ * Chat 元信息目录（由 chat plugin runtime 维护）。
  *
  * 关键点（中文）
  * - 该目录存放 `sessionId -> chat` 的最近映射快照
@@ -174,9 +311,21 @@ export function getDowncityChannelDirPath(cwd) {
 export function getDowncityChannelMetaPath(cwd) {
     return path.join(getDowncityChannelDirPath(cwd), "meta.json");
 }
+/**
+ * 返回 chat 元信息目录路径。
+ *
+ * 关键点（中文）
+ * - 用于按 sessionId 存放最近聊天路由快照与附加索引信息。
+ */
 export function getDowncityChatMetaDirPath(cwd) {
     return path.join(getDowncityChatDirPath(cwd), "meta");
 }
+/**
+ * 返回指定 session 的 chat 元信息文件路径。
+ *
+ * 关键点（中文）
+ * - 文件名按 `sessionId` 编码，避免不同会话之间互相覆盖。
+ */
 export function getDowncityChatMetaPath(cwd, sessionId) {
     return path.join(getDowncityChatMetaDirPath(cwd), `${encodeURIComponent(String(sessionId || "").trim())}.json`);
 }

package/bin/config/Paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../../src/config/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,YAAY,CAAU,CAAC;AAElE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAS,CAAU,CAAC;AAE5D,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAW,EAAE,IAAY;IAClE,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,cAAc,KAAK,CAAC;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,OAAe;IAClE,OAAO,IAAI,CAAC,IAAI,CACd,4BAA4B,CAAC,GAAG,CAAC,EACjC,kBAAkB,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,GAAW,EACX,OAAe;IAEf,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,OAAe,EACf,SAAiB;IAEjB,OAAO,IAAI,CAAC,IAAI,CACd,6BAA6B,CAAC,GAAG,EAAE,OAAO,CAAC,EAC3C,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAC/C,GAAW,EACX,OAAe,EACf,SAAiB;IAEjB,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,GAAW,EACX,OAAe,EACf,SAAiB;IAEjB,OAAO,IAAI,CAAC,IAAI,CACd,iCAAiC,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAC1D,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,GAAW,EACX,OAAe,EACf,SAAiB;IAEjB,OAAO,IAAI,CAAC,IAAI,CACd,iCAAiC,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAC1D,WAAW,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,GAAW,EACX,OAAe,EACf,SAAiB;IAEjB,OAAO,IAAI,CAAC,IAAI,CACd,iCAAiC,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAC1D,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,GAAW,EACX,OAAe,EACf,SAAiB,EACjB,SAAiB;IAEjB,OAAO,IAAI,CAAC,IAAI,CACd,wCAAwC,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EACjE,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,SAAiB;IACpE,OAAO,IAAI,CAAC,IAAI,CACd,0BAA0B,CAAC,GAAG,CAAC,EAC/B,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAC7D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAW,EAAE,SAAiB;IAC1E,OAAO,IAAI,CAAC,IAAI,CACd,sBAAsB,CAAC,GAAG,CAAC,EAC3B,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAW,EAAE,SAAiB;IACvE,OAAO,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC;AACnF,CAAC"}
+{"version":3,"file":"Paths.js","sourceRoot":"","sources":["../../src/config/Paths.ts"],"names":[],"mappings":"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"}

package/bin/config/PlatformPaths.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 平台级全局路径规则。
+ *
+ * 职责说明（中文）
+ * - 统一描述用户级 `~/.downcity` 根目录及其关键子路径。
+ * - 让 `agent` 在不依赖 `city` 实现细节的前提下，也能复用同一套默认全局存储位置。
+ *
+ * 边界说明（中文）
+ * - 这里只定义“路径约定”，不负责任何数据库、密钥或业务读写逻辑。
+ * - 如需更换根目录，只能通过 `DC_PLATFORM_ROOT` 环境变量覆盖。
+ */
+/**
+ * 返回 Downcity 平台级全局根目录。
+ *
+ * 关键点（中文）
+ * - 默认固定为 `~/.downcity`。
+ * - 测试或隔离运行场景可通过 `DC_PLATFORM_ROOT` 覆盖。
+ */
+export declare function getPlatformRootDirPath(): string;
+/**
+ * 返回平台级运行目录。
+ */
+export declare function getPlatformRuntimeDirPath(): string;
+/**
+ * 返回平台级全局 SQLite 数据库路径。
+ */
+export declare function getPlatformStoreDbPath(): string;
+/**
+ * 返回平台级数据库密钥文件路径。
+ *
+ * 关键点（中文）
+ * - 这里沿用现有 `city` 的默认密钥位置，保证账号密钥读写格式一致。
+ */
+export declare function getPlatformStoreKeyPath(): string;
+//# sourceMappingURL=PlatformPaths.d.ts.map

package/bin/config/PlatformPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformPaths.d.ts","sourceRoot":"","sources":["../../src/config/PlatformPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAM/C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/bin/config/PlatformPaths.js

@@ -0,0 +1,49 @@
+/**
+ * 平台级全局路径规则。
+ *
+ * 职责说明（中文）
+ * - 统一描述用户级 `~/.downcity` 根目录及其关键子路径。
+ * - 让 `agent` 在不依赖 `city` 实现细节的前提下，也能复用同一套默认全局存储位置。
+ *
+ * 边界说明（中文）
+ * - 这里只定义“路径约定”，不负责任何数据库、密钥或业务读写逻辑。
+ * - 如需更换根目录，只能通过 `DC_PLATFORM_ROOT` 环境变量覆盖。
+ */
+import os from "node:os";
+import path from "node:path";
+/**
+ * 返回 Downcity 平台级全局根目录。
+ *
+ * 关键点（中文）
+ * - 默认固定为 `~/.downcity`。
+ * - 测试或隔离运行场景可通过 `DC_PLATFORM_ROOT` 覆盖。
+ */
+export function getPlatformRootDirPath() {
+    const explicitRoot = String(process.env.DC_PLATFORM_ROOT || "").trim();
+    if (explicitRoot) {
+        return path.resolve(explicitRoot);
+    }
+    return path.join(os.homedir(), ".downcity");
+}
+/**
+ * 返回平台级运行目录。
+ */
+export function getPlatformRuntimeDirPath() {
+    return path.join(getPlatformRootDirPath(), "main");
+}
+/**
+ * 返回平台级全局 SQLite 数据库路径。
+ */
+export function getPlatformStoreDbPath() {
+    return path.join(getPlatformRootDirPath(), "downcity.db");
+}
+/**
+ * 返回平台级数据库密钥文件路径。
+ *
+ * 关键点（中文）
+ * - 这里沿用现有 `city` 的默认密钥位置，保证账号密钥读写格式一致。
+ */
+export function getPlatformStoreKeyPath() {
+    return path.join(getPlatformRuntimeDirPath(), "model-db.key");
+}
+//# sourceMappingURL=PlatformPaths.js.map

package/bin/config/PlatformPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformPaths.js","sourceRoot":"","sources":["../../src/config/PlatformPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC"}

package/bin/executor/Executor.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Executor：单个 session 的执行编排器。
+ *
+ * 关键点（中文）
+ * - SDK 对外对象叫 `Session`，这里是内部执行层。
+ * - 一个 Executor 只对应一个固定的 `sessionId`。
+ * - 负责 history 写入、run scope、executing 状态、Composer 编排与 tool-loop 执行。
+ */
+import { type LanguageModel, type Tool } from "ai";
+import type { SessionHistoryComposer } from "./composer/history/SessionHistoryComposer.js";
+import type { SessionHistoryStore } from "../executor/store/history/SessionHistoryStore.js";
+import type { SessionRunScope } from "./SessionRunScope.js";
+import type { SessionCompactionComposer } from "./composer/compaction/SessionCompactionComposer.js";
+import type { SessionContextComposer } from "./composer/context/SessionContextComposer.js";
+import type { SessionSystemComposer } from "./composer/system/SessionSystemComposer.js";
+import type { Logger } from "../utils/logger/Logger.js";
+import type { JsonObject } from "../types/common/Json.js";
+import type { SessionMessageV1 } from "../executor/types/SessionMessages.js";
+import type { SessionExecutor } from "../executor/types/SessionExecutor.js";
+import type { SessionRunResult } from "../executor/types/SessionRun.js";
+type ExecutorOptions = {
+    /**
+     * 当前会话 ID。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 对应的 history 事实源。
+     */
+    historyStore: SessionHistoryStore;
+    /**
+     * 当前 session 对应的 history Composer。
+     *
+     * 关键点（中文）
+     * - Composer 只负责组装本轮 messages，不负责落盘。
+     */
+    historyComposer: SessionHistoryComposer;
+    /**
+     * 读取当前 session 使用的模型实例。
+     */
+    getModel: () => LanguageModel | undefined;
+    /**
+     * 统一日志器。
+     */
+    logger: Logger;
+    /**
+     * 当前 session 对应的 compaction Composer。
+     */
+    compactionComposer?: SessionCompactionComposer;
+    /**
+     * 当前 session 对应的 system Composer。
+     */
+    systemComposer: SessionSystemComposer;
+    /**
+     * 获取当前可用工具集合。
+     */
+    getTools: () => Record<string, Tool>;
+    /**
+     * 可选自定义 context Composer。
+     */
+    contextComposer?: SessionContextComposer;
+    /**
+     * session 更新后的异步回调。
+     */
+    runAfterSessionUpdated?: (sessionId: string) => Promise<void>;
+};
+/**
+ * Executor 单实例实现。
+ */
+export declare class Executor implements SessionExecutor {
+    /**
+     * 当前 session 标识。
+     */
+    readonly sessionId: string;
+    private readonly historyComposer;
+    private readonly historyStore;
+    private readonly getModel;
+    private readonly logger;
+    private readonly compactionComposer;
+    private readonly systemComposer;
+    protected readonly contextComposer: SessionContextComposer;
+    private readonly historyWriter;
+    private executing;
+    private retryCount;
+    constructor(options: ExecutorOptions);
+    /**
+     * 返回当前 session 是否正在执行。
+     */
+    isExecuting(): boolean;
+    /**
+     * 获取当前 session 的 history 事实源。
+     */
+    getHistoryStore(): SessionHistoryStore;
+    /**
+     * 获取当前 session 的执行端口。
+     *
+     * 关键点（中文）
+     * - 兼容 runtime/service 端口语义：Executor 自己就是执行端口。
+     */
+    getExecutor(): SessionExecutor;
+    /**
+     * 清理当前 session 的执行器运行态。
+     *
+     * 关键点（中文）
+     * - 当前 Executor 不缓存模型实例，模型每轮 run 都从 `getModel()` 读取。
+     * - history 是事实源，不应随着执行态一起丢失。
+     */
+    clearExecutor(): void;
+    /**
+     * 触发 session 更新后的异步回调。
+     */
+    afterSessionUpdatedAsync(): Promise<void>;
+    /**
+     * 追加一条 user 消息。
+     */
+    appendUserMessage(params: {
+        message?: SessionMessageV1 | null;
+        text?: string;
+        extra?: JsonObject;
+    }): Promise<void>;
+    /**
+     * 追加一条 assistant 消息。
+     */
+    appendAssistantMessage(params: {
+        message?: SessionMessageV1 | null;
+        fallbackText?: string;
+        extra?: JsonObject;
+    }): Promise<void>;
+    /**
+     * 运行当前 session 的一次请求。
+     *
+     * 关键点（中文）
+     * - 这里直接承接单个 Session 实例的一次 run 外层编排。
+     * - scope 绑定、assistant step 持久化、executing 状态都收在实例内部。
+     */
+    run(params: {
+        query: string;
+        onStepCallback?: SessionRunScope["onStepCallback"];
+        onAssistantStepCallback?: SessionRunScope["onAssistantStepCallback"];
+        onUiMessageChunkCallback?: SessionRunScope["onUiMessageChunkCallback"];
+    }): Promise<SessionRunResult>;
+    /**
+     * 执行一次 session run（带可压缩错误重试）。
+     */
+    private runWithRetry;
+    /**
+     * 调用 Composer 组装当前轮执行输入。
+     */
+    private prepareExecuteInput;
+    /**
+     * 执行一次已装配完成的运行材料。
+     */
+    private executePreparedRun;
+    /**
+     * 运行模型/tool-loop 核心。
+     *
+     * 关键点（中文）
+     * - CoreEngine 是 Executor 内部机制，不是第二个 Executor 实例。
+     * - 这里只返回最终 assistant message；是否写入长期 history 由外层 Session/Service 决定。
+     * - 运行中生成的内部续写 user message 只进入本轮内存态，不直接落盘。
+     */
+    private runCoreEngine;
+    /**
+     * 读取当前 session 模型。
+     */
+    private resolveModelOrThrow;
+    /**
+     * 重置当前 run 级状态。
+     */
+    private resetRunState;
+}
+export {};
+//# sourceMappingURL=Executor.d.ts.map

package/bin/executor/Executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Executor.d.ts","sourceRoot":"","sources":["../../src/executor/Executor.ts"],"names":[],"mappings":"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"}