@downcity/agent 1.1.287 → 1.1.310

package/bin/config/Gitignore.js

@@ -1,46 +0,0 @@
-/**
- * Agent 配置域 `.gitignore` 维护模块。
- *
- * 职责说明（中文）
- * - 负责在 agent 项目初始化阶段把必要的忽略规则补进 `.gitignore`。
- * - 让项目配置与运行时状态目录的忽略策略留在 `config/` 语义域内统一维护。
- *
- * 边界说明（中文）
- * - 这里只做最小化补丁写入，不负责 `.gitignore` 的复杂排序、分组或格式整理。
- * - 当前主要服务项目初始化流程，不追求抽象成通用 Git 文本编辑器。
- */
-import fs from "fs-extra";
-import path from "node:path";
-/**
- * 确保 `.gitignore` 中存在指定规则。
- *
- * 关键点（中文）
- * - 只会在末尾追加缺失规则，不会重排用户已有内容。
- * - 返回值用于告诉调用方本次是新建、更新还是无需修改。
- * - 设计目标是“尽量少打扰用户已有文件结构”。
- */
-export async function ensureGitignoreEntry(projectRoot, entry) {
-    const normalizedProjectRoot = path.resolve(String(projectRoot || "").trim() || ".");
-    const normalizedEntry = String(entry || "").trim();
-    if (!normalizedEntry)
-        return "unchanged";
-    const gitignorePath = path.join(normalizedProjectRoot, ".gitignore");
-    const hasGitignore = await fs.pathExists(gitignorePath);
-    const existingContent = hasGitignore
-        ? await fs.readFile(gitignorePath, "utf-8")
-        : "";
-    const normalizedLines = existingContent
-        .split(/\r?\n/)
-        .map((line) => String(line || "").trim());
-    if (normalizedLines.includes(normalizedEntry)) {
-        return "unchanged";
-    }
-    const chunks = existingContent ? [existingContent] : [];
-    if (existingContent && !existingContent.endsWith("\n")) {
-        chunks.push("\n");
-    }
-    chunks.push(`${normalizedEntry}\n`);
-    await fs.writeFile(gitignorePath, chunks.join(""), "utf-8");
-    return hasGitignore ? "updated" : "created";
-}
-//# sourceMappingURL=Gitignore.js.map

package/bin/config/Gitignore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Gitignore.js","sourceRoot":"","sources":["../../src/config/Gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,KAAa;IAEb,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC;IACpF,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,eAAe;QAAE,OAAO,WAAW,CAAC;IAEzC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,YAAY;QAClC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAC3C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,eAAe,GAAG,eAAe;SACpC,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5C,IAAI,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,IAAI,eAAe,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,IAAI,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/bin/config/Paths.d.ts

@@ -1,122 +0,0 @@
-/**
- * 返回项目运行时状态根目录 `.downcity` 的路径。
- */
-export declare function getDowncityDirPath(cwd: string): string;
-/**
- * 返回项目日志目录路径。
- */
-export declare function getLogsDirPath(cwd: string): string;
-/**
- * 返回项目缓存目录路径。
- *
- * 关键点（中文）
- * - 当前使用隐藏命名 `.cache`，避免与用户业务目录混淆。
- */
-export declare function getCacheDirPath(cwd: string): string;
-/**
- * 返回 profile 运行态目录路径。
- *
- * 关键点（中文）
- * - 初始化流程会统一创建该目录，并在其中写入 profile 相关文件。
- * - 单独保留目录级 API，避免调用方散落 `path.join(..., "profile")`。
- */
-export declare function getDowncityProfileDirPath(cwd: string): string;
-/**
- * 返回 profile 主记忆文件路径。
- *
- * 关键点（中文）
- * - 该文件通常承载主画像或核心长期 profile 信息。
- */
-export declare function getDowncityProfilePrimaryPath(cwd: string): string;
-/**
- * 返回 profile 补充记忆文件路径。
- *
- * 关键点（中文）
- * - 该文件用于存放不适合进入主 profile 的补充材料。
- */
-export declare function getDowncityProfileOtherPath(cwd: string): string;
-/**
- * Plugin Schedule JSONL 路径。
- *
- * 关键点（中文）
- * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
- */
-export declare function getDowncityScheduleDbPath(cwd: string): string;
-/**
- * 返回项目运行时数据目录路径。
- */
-export declare function getDowncityDataDirPath(cwd: string): string;
-/**
- * 返回项目内全部 agent 实例目录的根路径。
- *
- * 关键点（中文）
- * - 单项目虽然通常只有一个 agent 入口，但底层仍按 agentId 分层组织。
- */
-export declare function getDowncityAgentsRootDirPath(cwd: string): string;
-/**
- * 返回指定 agent 的 session 根目录路径。
- */
-export declare function getDowncitySessionRootDirPath(cwd: string, agentId: string): string;
-/**
- * 返回指定 session 的运行态目录路径。
- *
- * 关键点（中文）
- * - `sessionId` 同样会做 URL 编码，保证路径可安全持久化。
- */
-export declare function getDowncitySessionDirPath(cwd: string, agentId: string, sessionId: string): string;
-/**
- * Session Messages（会话消息，唯一事实源）。
- *
- * 关键点（中文）
- * - `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`：每行一个 UIMessage（user/assistant）
- * - compact 会把被折叠的原始段写入 `messages/archive/*`（可审计）
- */
-export declare function getDowncitySessionMessagesDirPath(cwd: string, agentId: string, sessionId: string): string;
-/**
- * 返回 session 消息事实源文件路径。
- *
- * 关键点（中文）
- * - 当前唯一事实源是 `messages.jsonl`，所有历史组装都应基于它。
- */
-export declare function getDowncitySessionMessagesPath(cwd: string, agentId: string, sessionId: string): string;
-/**
- * 返回 session 消息归档目录路径。
- *
- * 关键点（中文）
- * - compaction 时被折叠的原始消息段会写入该目录，便于审计和回溯。
- */
-export declare function getDowncitySessionMessagesArchiveDirPath(cwd: string, agentId: string, sessionId: string): string;
-/**
- * 返回指定归档文件的完整路径。
- *
- * 关键点（中文）
- * - `archiveId` 会做 URL 编码，避免 compaction 生成的标识污染文件名。
- */
-export declare function getDowncitySessionMessagesArchivePath(cwd: string, agentId: string, sessionId: string, archiveId: string): string;
-/**
- * 返回项目公开静态资源目录路径。
- */
-export declare function getDowncityPublicDirPath(cwd: string): string;
-/**
- * 返回项目资源目录路径。
- *
- * 关键点（中文）
- * - 该目录用于存放会话历史引用的二进制资源，例如图片生成结果。
- * - `messages.jsonl` 只保存 Agent 根目录相对路径，避免暴露本机绝对路径或长期保存 base64。
- */
-export declare function getDowncityResourcesDirPath(cwd: string): string;
-/**
- * 返回项目任务目录路径。
- *
- * 关键点（中文）
- * - 该目录用于存放任务相关的本地文件与运行时数据。
- */
-export declare function getDowncityTasksDirPath(cwd: string): string;
-/**
- * 返回项目调试目录路径。
- *
- * 关键点（中文）
- * - 当前使用隐藏目录 `.debug`，避免与用户显式业务目录冲突。
- */
-export declare function getDowncityDebugDirPath(cwd: string): string;
-//# sourceMappingURL=Paths.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../src/config/Paths.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE;AAgBD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,wCAAwC,CACtD,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/bin/config/Paths.js

@@ -1,183 +0,0 @@
-/**
- * Agent 项目路径规则模块。
- *
- * 职责说明（中文）
- * - 统一管理单个 agent 项目根目录下的静态文件、`.downcity` 目录与运行时状态文件路径。
- * - 负责把“路径协议”集中到一个模块，避免各领域模块自行拼接字符串。
- * - 为初始化、会话存储、聊天路由、调试文件等子系统提供一致的路径入口。
- *
- * 边界说明（中文）
- * - 这里只负责路径计算，不负责目录创建、文件读写或存在性校验。
- * - 这里描述的是单项目约定，不涉及平台级全局目录布局。
- */
-import path from "path";
-/**
- * 返回项目运行时状态根目录 `.downcity` 的路径。
- */
-export function getDowncityDirPath(cwd) {
-    return path.join(cwd, ".downcity");
-}
-/**
- * 返回项目日志目录路径。
- */
-export function getLogsDirPath(cwd) {
-    return path.join(getDowncityDirPath(cwd), "logs");
-}
-/**
- * 返回项目缓存目录路径。
- *
- * 关键点（中文）
- * - 当前使用隐藏命名 `.cache`，避免与用户业务目录混淆。
- */
-export function getCacheDirPath(cwd) {
-    return path.join(getDowncityDirPath(cwd), ".cache");
-}
-/**
- * 返回 profile 运行态目录路径。
- *
- * 关键点（中文）
- * - 初始化流程会统一创建该目录，并在其中写入 profile 相关文件。
- * - 单独保留目录级 API，避免调用方散落 `path.join(..., "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");
-}
-/**
- * Plugin Schedule JSONL 路径。
- *
- * 关键点（中文）
- * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
- */
-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 编码，避免特殊字符污染文件系统结构。
- * - 当前仅供本模块内部拼接 session 根目录使用。
- */
-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()));
-}
-/**
- * Session Messages（会话消息，唯一事实源）。
- *
- * 关键点（中文）
- * - `.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/messages.jsonl`：每行一个 UIMessage（user/assistant）
- * - compact 会把被折叠的原始段写入 `messages/archive/*`（可审计）
- */
-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 时被折叠的原始消息段会写入该目录，便于审计和回溯。
- */
-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");
-}
-/**
- * 返回项目资源目录路径。
- *
- * 关键点（中文）
- * - 该目录用于存放会话历史引用的二进制资源，例如图片生成结果。
- * - `messages.jsonl` 只保存 Agent 根目录相对路径，避免暴露本机绝对路径或长期保存 base64。
- */
-export function getDowncityResourcesDirPath(cwd) {
-    return path.join(getDowncityDirPath(cwd), "resources");
-}
-/**
- * 返回项目任务目录路径。
- *
- * 关键点（中文）
- * - 该目录用于存放任务相关的本地文件与运行时数据。
- */
-export function getDowncityTasksDirPath(cwd) {
-    return path.join(getDowncityDirPath(cwd), "task");
-}
-/**
- * 返回项目调试目录路径。
- *
- * 关键点（中文）
- * - 当前使用隐藏目录 `.debug`，避免与用户显式业务目录冲突。
- */
-export function getDowncityDebugDirPath(cwd) {
-    return path.join(getDowncityDirPath(cwd), ".debug");
-}
-//# sourceMappingURL=Paths.js.map

package/bin/config/Paths.js.map

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

package/bin/config/PlatformPaths.d.ts

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

@@ -1 +0,0 @@
-{"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;AAaD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/bin/config/PlatformPaths.js

@@ -1,53 +0,0 @@
-/**
- * 平台级全局路径规则。
- *
- * 职责说明（中文）
- * - 统一描述用户级 `~/.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");
-}
-/**
- * 返回平台级运行目录。
- *
- * 关键点（中文）
- * - 当前仅供本模块内部拼接平台级派生路径使用。
- * - 不再对外导出，避免暴露未被实际消费的路径 API。
- */
-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

@@ -1 +0,0 @@
-{"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;;;;;;GAMG;AACH,SAAS,yBAAyB;IAChC,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/config/ProjectSetup.d.ts

@@ -1,11 +0,0 @@
-/**
- * ProjectSetup：本地 Agent 启动前项目结构准备模块。
- *
- * 关键点（中文）
- * - 统一确保 `.downcity/*` 目录结构存在，避免调用方重复拼装目录逻辑。
- */
-/**
- * runtime 启动前准备项目结构。
- */
-export declare function ensureRuntimeProjectReady(projectRoot: string): void;
-//# sourceMappingURL=ProjectSetup.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectSetup.d.ts","sourceRoot":"","sources":["../../src/config/ProjectSetup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEnE"}

package/bin/config/ProjectSetup.js

@@ -1,32 +0,0 @@
-/**
- * ProjectSetup：本地 Agent 启动前项目结构准备模块。
- *
- * 关键点（中文）
- * - 统一确保 `.downcity/*` 目录结构存在，避免调用方重复拼装目录逻辑。
- */
-import fs from "fs-extra";
-import path from "node:path";
-import { getCacheDirPath, getDowncityAgentsRootDirPath, getLogsDirPath, getDowncityDataDirPath, getDowncityDebugDirPath, getDowncityDirPath, getDowncityProfileDirPath, getDowncityPublicDirPath, getDowncityTasksDirPath, } from "../config/Paths.js";
-/**
- * 确保 `.downcity` 运行目录结构完整。
- */
-function ensure_runtime_directories(projectRoot) {
-    // 关键点（中文）：尽量只在启动时确保目录结构存在，避免在 Agent/Tool 执行过程中反复 ensure。
-    fs.ensureDirSync(getDowncityDirPath(projectRoot));
-    fs.ensureDirSync(getDowncityTasksDirPath(projectRoot));
-    fs.ensureDirSync(getLogsDirPath(projectRoot));
-    fs.ensureDirSync(getCacheDirPath(projectRoot));
-    fs.ensureDirSync(getDowncityProfileDirPath(projectRoot));
-    fs.ensureDirSync(getDowncityDataDirPath(projectRoot));
-    fs.ensureDirSync(getDowncityAgentsRootDirPath(projectRoot));
-    fs.ensureDirSync(getDowncityPublicDirPath(projectRoot));
-    fs.ensureDirSync(path.join(projectRoot, ".agents", "skills"));
-    fs.ensureDirSync(getDowncityDebugDirPath(projectRoot));
-}
-/**
- * runtime 启动前准备项目结构。
- */
-export function ensureRuntimeProjectReady(projectRoot) {
-    ensure_runtime_directories(projectRoot);
-}
-//# sourceMappingURL=ProjectSetup.js.map

package/bin/config/ProjectSetup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ProjectSetup.js","sourceRoot":"","sources":["../../src/config/ProjectSetup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,SAAS,0BAA0B,CAAC,WAAmB;IACrD,yDAAyD;IACzD,EAAE,CAAC,aAAa,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,EAAE,CAAC,aAAa,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9C,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/C,EAAE,CAAC,aAAa,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,EAAE,CAAC,aAAa,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9D,EAAE,CAAC,aAAa,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,0BAA0B,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC"}

package/bin/executor/messages/AssistantFileResource.d.ts

@@ -1,63 +0,0 @@
-/**
- * AssistantFileResource：assistant file part 的本地资源落盘工具。
- *
- * 关键点（中文）
- * - 只处理运行期产生的 assistant file part，不参与 user 附件注入。
- * - 将 data URL、远程 URL 与本地文件统一写入 `.downcity/resources`。
- * - 历史中只保留基于 Agent 项目根目录的相对路径，避免暴露本机绝对路径。
- * - 资源文件按内容 hash 命名，天然去重并避免重复写入大文件。
- */
-import type { FileUIPart } from "ai";
-/**
- * assistant file part 资源落盘参数。
- */
-export interface MaterializeAssistantFilePartsParams {
-    /**
-     * 当前项目根目录。
-     *
-     * 关键点（中文）
-     * - 正常 session run 必须显式传入 projectRoot。
-     * - 旧入口未传时仅为兼容回退到 `process.cwd()`。
-     */
-    projectRoot?: string;
-    /**
-     * 待处理的 assistant file parts。
-     */
-    parts: FileUIPart[];
-}
-/**
- * 将项目内文件路径转换为基于 Agent 根目录的相对路径。
- */
-export declare function toAgentRelativePath(params: {
-    /**
-     * 当前 Agent 项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 项目内文件绝对路径。
-     */
-    filePath: string;
-}): string;
-/**
- * 将相对路径解析为 Agent 项目内绝对路径。
- *
- * 关键点（中文）
- * - 相对路径统一基于 Agent 项目根目录解析。
- * - 绝对路径原样归一化后返回。
- * - 越界路径返回空字符串，由调用方决定是否忽略。
- */
-export declare function resolveAgentFilePath(params: {
-    /**
-     * 当前 Agent 项目根目录。
-     */
-    projectRoot: string;
-    /**
-     * 待解析的相对路径或绝对路径。
-     */
-    filePath: string;
-}): string;
-/**
- * 将 assistant file part 中的资源统一落盘为 Agent 根目录相对路径。
- */
-export declare function materializeAssistantFileParts(params: MaterializeAssistantFilePartsParams): Promise<FileUIPart[]>;
-//# sourceMappingURL=AssistantFileResource.d.ts.map

package/bin/executor/messages/AssistantFileResource.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AssistantFileResource.d.ts","sourceRoot":"","sources":["../../../src/executor/messages/AssistantFileResource.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAmBrC;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AA2DD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAUT;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAWT;AA2QD;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvB"}