@downcity/agent 1.1.1

package/bin/config/Config.js

@@ -0,0 +1,217 @@
+/**
+ * City Env Config：city 级环境与配置读取模块。
+ *
+ * 关键点（中文）
+ * - `main/city/env/*` 放的是 city 全局运行态依赖的配置基础设施，不是通用小工具目录。
+ * - 这里统一处理 `downcity.json`、项目 `.env`、全局 env store 三类配置来源。
+ * - agent 运行时和 Console 模块都通过这里读取配置，避免各处重复拼装规则。
+ */
+import dotenv from "dotenv";
+import fs from "fs-extra";
+import path from "path";
+import { ConsoleStore } from "../shared/utils/store/index.js";
+import { assertProjectExecutionTarget } from "../agent/project/ProjectExecutionBinding.js";
+/**
+ * 读取 console 共享环境变量（`env_entries.scope=global`）。
+ */
+export function loadGlobalEnvFromStore() {
+    const store = new ConsoleStore();
+    try {
+        return store.getGlobalEnvMapSync();
+    }
+    catch {
+        return {};
+    }
+    finally {
+        store.close();
+    }
+}
+/**
+ * 读取 agent 私有环境变量（`env_entries.scope=agent`）。
+ */
+export function loadAgentEnvFromStore(agentId) {
+    const normalizedAgentId = String(agentId || "").trim();
+    if (!normalizedAgentId)
+        return {};
+    const store = new ConsoleStore();
+    try {
+        return store.getAgentEnvMapSync(normalizedAgentId);
+    }
+    catch {
+        return {};
+    }
+    finally {
+        store.close();
+    }
+}
+/**
+ * 读取 agent 最终环境变量快照。
+ *
+ * 关键点（中文）
+ * - 来源：agent scope env（DB） + `<agent>/.env`（用户文件）。
+ * - 冲突时 `.env` 优先，满足用户可在本地即时覆盖。
+ */
+export function loadAgentEnvSnapshot(projectRoot) {
+    const agentFromDb = loadAgentEnvFromStore(projectRoot);
+    const projectDotenv = loadProjectDotenv(projectRoot);
+    return {
+        ...agentFromDb,
+        ...projectDotenv,
+    };
+}
+/**
+ * 读取项目 `.env` 快照（不污染全局 process.env）。
+ *
+ * 关键点（中文）
+ * - 只返回当前 agent 项目自己的 env 映射，供 runtime 局部使用。
+ * - 不再把 agent env 注入全局，避免多个 agent 在同一 console 进程里互相污染。
+ */
+export function loadProjectDotenv(projectRoot) {
+    // 关键点（中文）
+    // - console 级配置不再走 `~/.downcity/.env`（统一迁移到 downcity.db）
+    // - 仅解析项目 `.env`（agent 级）
+    const projectEnvPath = path.join(projectRoot, ".env");
+    if (!fs.existsSync(projectEnvPath)) {
+        return {};
+    }
+    try {
+        const raw = fs.readFileSync(projectEnvPath, "utf-8");
+        const parsed = dotenv.parse(raw);
+        const result = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            const normalizedKey = String(key || "").trim();
+            if (!normalizedKey)
+                continue;
+            result[normalizedKey] = String(value || "").trim();
+        }
+        return result;
+    }
+    catch {
+        return {};
+    }
+}
+function resolveEnvPlaceholdersDeep(value, resolveEnvVar) {
+    if (typeof value === "string") {
+        const match = value.match(/^\$\{([A-Z0-9_]+)\}$/);
+        if (!match)
+            return value;
+        const envVar = match[1];
+        return resolveEnvVar(envVar);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => resolveEnvPlaceholdersDeep(item, resolveEnvVar));
+    }
+    if (value && typeof value === "object") {
+        const obj = value;
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            out[k] = resolveEnvPlaceholdersDeep(v, resolveEnvVar);
+        }
+        return out;
+    }
+    return value;
+}
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * 深合并：对象递归合并，数组与标量以 override 为准。
+ *
+ * 关键点（中文）
+ * - downcity.json 的“继承/覆盖”语义：越靠近 agent 项目的配置优先级越高。
+ * - 数组不做 concat，避免出现重复 paths / models。
+ */
+function deepMerge(base, override) {
+    if (!isPlainObject(base) || !isPlainObject(override)) {
+        return override === undefined ? base : override;
+    }
+    const out = { ...base };
+    for (const [key, overrideValue] of Object.entries(override)) {
+        const baseValue = base[key];
+        if (Array.isArray(overrideValue)) {
+            out[key] = overrideValue;
+            continue;
+        }
+        if (isPlainObject(overrideValue) && isPlainObject(baseValue)) {
+            out[key] = deepMerge(baseValue, overrideValue);
+            continue;
+        }
+        out[key] = overrideValue === undefined ? baseValue : overrideValue;
+    }
+    return out;
+}
+function readShipJsonLayer(filePath, resolveEnvVar) {
+    const raw = fs.readJsonSync(filePath);
+    return resolveEnvPlaceholdersDeep(raw, resolveEnvVar);
+}
+/**
+ * 校验项目层是否误配废弃的 `extensions` 字段。
+ *
+ * 关键点（中文）
+ * - 新版本统一使用 `plugins`。
+ * - 发现旧字段时直接报错，避免继续沿用已删除方案。
+ */
+function assertNoProjectExtensionsLayer(filePath, layer) {
+    if (!isPlainObject(layer))
+        return;
+    if (!Object.prototype.hasOwnProperty.call(layer, "extensions"))
+        return;
+    throw new Error(`Invalid downcity.json: legacy "extensions" config is no longer supported. Use "plugins" instead (${filePath})`);
+}
+function collectAncestorShipJsonPaths(projectRoot) {
+    const paths = [];
+    const resolvedRoot = path.resolve(projectRoot);
+    let dir = resolvedRoot;
+    while (true) {
+        const candidate = path.join(dir, "downcity.json");
+        if (fs.existsSync(candidate))
+            paths.push(candidate);
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // root -> leaf
+    return paths.reverse();
+}
+export function loadDowncityConfig(projectRoot, options) {
+    const projectDotenv = options?.projectEnv ?? loadProjectDotenv(projectRoot);
+    const agentEnv = options?.agentEnv ?? loadAgentEnvFromStore(projectRoot);
+    const globalEnv = options?.globalEnv ?? loadGlobalEnvFromStore();
+    const runtimeAgentEnv = {
+        ...agentEnv,
+        ...projectDotenv,
+    };
+    /**
+     * 读取 agent 项目私有环境变量（services）。
+     *
+     * 关键点（中文）
+     * - project 层只读当前项目 .env，不再回退到共享 env。
+     * - 从根上杜绝跨 agent 的服务凭据串用。
+     */
+    const resolveProjectEnvVar = (name) => {
+        const projectValue = String(runtimeAgentEnv[name] || "").trim();
+        return projectValue || undefined;
+    };
+    const ancestorShipJsonPaths = collectAncestorShipJsonPaths(projectRoot);
+    if (ancestorShipJsonPaths.length === 0) {
+        throw new Error("downcity.json not found in project directory");
+    }
+    let merged = undefined;
+    for (const p of ancestorShipJsonPaths) {
+        const layer = readShipJsonLayer(p, resolveProjectEnvVar);
+        assertNoProjectExtensionsLayer(p, layer);
+        merged = deepMerge(merged, layer);
+    }
+    if (!merged || typeof merged !== "object" || Array.isArray(merged)) {
+        throw new Error("Invalid downcity.json: expected object");
+    }
+    const candidate = merged;
+    if (typeof candidate.name !== "string" || typeof candidate.version !== "string") {
+        throw new Error("Invalid downcity.json: missing required fields name/version");
+    }
+    const config = candidate;
+    assertProjectExecutionTarget(config);
+    return config;
+}
+//# sourceMappingURL=Config.js.map

package/bin/config/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAI1F;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,mBAAmB,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,iBAAiB;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,WAAW,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO;QACL,GAAG,WAAW;QACd,GAAG,aAAa;KACjB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,UAAU;IACV,yDAAyD;IACzD,0BAA0B;IAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,aAAa;gBAAE,SAAS;YAC7B,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAQD,SAAS,0BAA0B,CACjC,KAA0B,EAC1B,aAAmD;IAEnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAAmB,CAAC;QAChC,MAAM,GAAG,GAA2C,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,CAAC,CAAC,GAAG,0BAA0B,CAAC,CAAwB,EAAE,aAAa,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,IAAa,EAAE,QAAiB;IACjD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,aAAa,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CACxB,QAAgB,EAChB,aAAmD;IAEnD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAwB,CAAC;IAC7D,OAAO,0BAA0B,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,8BAA8B,CACrC,QAAgB,EAChB,KAA0B;IAE1B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;QAAE,OAAO;IACvE,MAAM,IAAI,KAAK,CACb,oGAAoG,QAAQ,GAAG,CAChH,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,WAAmB;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,GAAG,GAAG,YAAY,CAAC;IACvB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,eAAe;IACf,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,OAIC;IAED,MAAM,aAAa,GAAG,OAAO,EAAE,UAAU,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,sBAAsB,EAAE,CAAC;IACjE,MAAM,eAAe,GAAG;QACtB,GAAG,QAAQ;QACX,GAAG,aAAa;KACjB,CAAC;IACF;;;;;;OAMG;IACH,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAsB,EAAE;QAChE,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,OAAO,YAAY,IAAI,SAAS,CAAC;IACnC,CAAC,CAAC;IAEF,MAAM,qBAAqB,GAAG,4BAA4B,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,MAAM,GAAY,SAAS,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,qBAAqB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;QACzD,8BAA8B,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,SAAS,GAAG,MAAiC,CAAC;IACpD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,MAAM,GAAG,SAA2B,CAAC;IAC3C,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/bin/config/Paths.d.ts

@@ -0,0 +1,119 @@
+/**
+ * PROFILE.md 候选文件名（按优先级从高到低）。
+ *
+ * 关键点（中文）
+ * - 统一使用大写文件名：`PROFILE.md`。
+ * - 与 SOUL 一起作为静态 prompt 入口。
+ */
+export declare const PROFILE_MD_FILE_CANDIDATES: readonly ["PROFILE.md"];
+export declare function getProfileMdPath(cwd: string): string;
+export declare function getProfileMdCandidatePaths(cwd: string): string[];
+/**
+ * SOUL.md 候选文件名（按优先级从高到低）。
+ *
+ * 关键点（中文）
+ * - 统一使用大写文件名：`SOUL.md`。
+ * - 统一由 Paths 模块暴露，避免调用方散落硬编码。
+ */
+export declare const SOUL_MD_FILE_CANDIDATES: readonly ["SOUL.md"];
+export declare function getSoulMdPath(cwd: string): string;
+export declare function getSoulMdCandidatePaths(cwd: string): string[];
+export declare function getDowncityJsonPath(cwd: string): string;
+export declare function getDowncityDirPath(cwd: string): string;
+export declare function getDowncitySchemaPath(cwd: string): string;
+export declare function getDowncityConfigDirPath(cwd: string): string;
+export declare function getLogsDirPath(cwd: string): string;
+export declare function getCacheDirPath(cwd: string): string;
+export declare function getDowncityProfileDirPath(cwd: string): string;
+export declare function getDowncityProfilePrimaryPath(cwd: string): string;
+export declare function getDowncityProfileOtherPath(cwd: string): string;
+/**
+ * Memory 根目录（V2）。
+ *
+ * 关键点（中文）
+ * - `.downcity/memory` 为跨会话记忆目录。
+ */
+export declare function getDowncityMemoryDirPath(cwd: string): string;
+/**
+ * 长期记忆文件路径（V2）。
+ */
+export declare function getDowncityMemoryLongTermPath(cwd: string): string;
+/**
+ * 每日记忆目录路径（V2）。
+ */
+export declare function getDowncityMemoryDailyDirPath(cwd: string): string;
+/**
+ * 每日记忆文件路径（V2）。
+ */
+export declare function getDowncityMemoryDailyPath(cwd: string, date: string): string;
+/**
+ * Memory 索引文件路径（V2）。
+ */
+export declare function getDowncityMemoryIndexPath(cwd: string): string;
+/**
+ * Service Schedule SQLite 路径。
+ *
+ * 关键点（中文）
+ * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
+ */
+export declare function getDowncityScheduleDbPath(cwd: string): string;
+export declare function getDowncityDataDirPath(cwd: string): string;
+export declare function getDowncitySessionRootDirPath(cwd: string): string;
+export declare function getDowncitySessionDirPath(cwd: string, sessionId: string): string;
+/**
+ * Session Messages（会话消息，唯一事实源）。
+ *
+ * 关键点（中文）
+ * - `.downcity/session/<encodedSessionId>/messages/messages.jsonl`：每行一个 UIMessage（user/assistant）
+ * - compact 会把被折叠的原始段写入 `messages/archive/*`（可审计）
+ */
+export declare function getDowncitySessionMessagesDirPath(cwd: string, sessionId: string): string;
+export declare function getDowncitySessionMessagesPath(cwd: string, sessionId: string): string;
+export declare function getDowncitySessionHistoryMetaPath(cwd: string, sessionId: string): string;
+export declare function getDowncitySessionMessagesArchiveDirPath(cwd: string, sessionId: string): string;
+export declare function getDowncitySessionMessagesArchivePath(cwd: string, sessionId: string, archiveId: string): string;
+export declare function getDowncityPublicDirPath(cwd: string): string;
+export declare function getDowncityTasksDirPath(cwd: string): string;
+export declare function getDowncityDebugDirPath(cwd: string): string;
+/**
+ * Chat 元信息目录（由 services/chat 维护）。
+ *
+ * 关键点（中文）
+ * - 该目录存放 `sessionId -> chat` 的最近映射快照
+ * - 与 core session messages 分离，避免把平台路由细节耦合进 core
+ */
+export declare function getDowncityChatDirPath(cwd: string): string;
+/**
+ * Channel 目录（channel -> sessionId 映射）。
+ *
+ * 关键点（中文）
+ * - 专门承载渠道目标与内部 sessionId 的映射关系。
+ * - 与 `chat/` 审计事件目录分离，避免职责混淆。
+ */
+export declare function getDowncityChannelDirPath(cwd: string): string;
+/**
+ * Channel 元信息文件路径。
+ *
+ * 关键点（中文）
+ * - 采用单文件 JSON（`meta.json`）存储映射表与最近路由信息。
+ */
+export declare function getDowncityChannelMetaPath(cwd: string): string;
+export declare function getDowncityChatMetaDirPath(cwd: string): string;
+export declare function getDowncityChatMetaPath(cwd: string, sessionId: string): string;
+/**
+ * Chat 会话目录（按 sessionId 组织）。
+ *
+ * 关键点（中文）
+ * - 用于存放聊天事件流（history.jsonl）等审计向数据。
+ * - 与 `chat/meta` 分离，避免路由快照与事件流混在一起。
+ */
+export declare function getDowncityChatSessionDirPath(cwd: string, sessionId: string): string;
+/**
+ * Chat 事件流文件路径（JSONL）。
+ *
+ * 关键点（中文）
+ * - 每行一条 chat 事件（当前为 inbound）。
+ * - 设计为 append-only，便于审计与回放。
+ */
+export declare function getDowncityChatHistoryPath(cwd: string, sessionId: string): string;
+//# sourceMappingURL=Paths.d.ts.map

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

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

package/bin/config/Paths.js

@@ -0,0 +1,203 @@
+/**
+ * City Env Paths：项目与运行目录路径规则模块。
+ *
+ * 关键点（中文）
+ * - 统一管理单个 agent 项目内 `.downcity` 及其子目录/文件路径规则。
+ * - 避免路径字符串在不同模块重复拼接，降低维护成本。
+ * - 这里描述的是“项目级路径约定”，与 `main/city/runtime/CityPaths.ts` 的全局路径约定分开。
+ */
+import path from "path";
+/**
+ * PROFILE.md 候选文件名（按优先级从高到低）。
+ *
+ * 关键点（中文）
+ * - 统一使用大写文件名：`PROFILE.md`。
+ * - 与 SOUL 一起作为静态 prompt 入口。
+ */
+export const PROFILE_MD_FILE_CANDIDATES = ["PROFILE.md"];
+export function getProfileMdPath(cwd) {
+    return path.join(cwd, PROFILE_MD_FILE_CANDIDATES[0]);
+}
+export function getProfileMdCandidatePaths(cwd) {
+    return PROFILE_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
+}
+/**
+ * SOUL.md 候选文件名（按优先级从高到低）。
+ *
+ * 关键点（中文）
+ * - 统一使用大写文件名：`SOUL.md`。
+ * - 统一由 Paths 模块暴露，避免调用方散落硬编码。
+ */
+export const SOUL_MD_FILE_CANDIDATES = ["SOUL.md"];
+export function getSoulMdPath(cwd) {
+    return path.join(cwd, SOUL_MD_FILE_CANDIDATES[0]);
+}
+export function getSoulMdCandidatePaths(cwd) {
+    return SOUL_MD_FILE_CANDIDATES.map((filename) => path.join(cwd, filename));
+}
+export function getDowncityJsonPath(cwd) {
+    return path.join(cwd, "downcity.json");
+}
+export function getDowncityDirPath(cwd) {
+    return path.join(cwd, ".downcity");
+}
+export function getDowncitySchemaPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "schema", "downcity.schema.json");
+}
+export function getDowncityConfigDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "config");
+}
+export function getLogsDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "logs");
+}
+export function getCacheDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), ".cache");
+}
+export function getDowncityProfileDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "profile");
+}
+export function getDowncityProfilePrimaryPath(cwd) {
+    return path.join(getDowncityProfileDirPath(cwd), "Primary.md");
+}
+export function getDowncityProfileOtherPath(cwd) {
+    return path.join(getDowncityProfileDirPath(cwd), "other.md");
+}
+/**
+ * Memory 根目录（V2）。
+ *
+ * 关键点（中文）
+ * - `.downcity/memory` 为跨会话记忆目录。
+ */
+export function getDowncityMemoryDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "memory");
+}
+/**
+ * 长期记忆文件路径（V2）。
+ */
+export function getDowncityMemoryLongTermPath(cwd) {
+    return path.join(getDowncityMemoryDirPath(cwd), "MEMORY.md");
+}
+/**
+ * 每日记忆目录路径（V2）。
+ */
+export function getDowncityMemoryDailyDirPath(cwd) {
+    return path.join(getDowncityMemoryDirPath(cwd), "daily");
+}
+/**
+ * 每日记忆文件路径（V2）。
+ */
+export function getDowncityMemoryDailyPath(cwd, date) {
+    const fileName = `${String(date || "").trim() || "unknown-date"}.md`;
+    return path.join(getDowncityMemoryDailyDirPath(cwd), fileName);
+}
+/**
+ * Memory 索引文件路径（V2）。
+ */
+export function getDowncityMemoryIndexPath(cwd) {
+    return path.join(getDowncityMemoryDirPath(cwd), "index.sqlite");
+}
+/**
+ * Service Schedule SQLite 路径。
+ *
+ * 关键点（中文）
+ * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
+ */
+export function getDowncityScheduleDbPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "schedule.sqlite");
+}
+export function getDowncityDataDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "data");
+}
+export function getDowncitySessionRootDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "session");
+}
+export function getDowncitySessionDirPath(cwd, sessionId) {
+    return path.join(getDowncitySessionRootDirPath(cwd), encodeURIComponent(sessionId));
+}
+/**
+ * Session Messages（会话消息，唯一事实源）。
+ *
+ * 关键点（中文）
+ * - `.downcity/session/<encodedSessionId>/messages/messages.jsonl`：每行一个 UIMessage（user/assistant）
+ * - compact 会把被折叠的原始段写入 `messages/archive/*`（可审计）
+ */
+export function getDowncitySessionMessagesDirPath(cwd, sessionId) {
+    return path.join(getDowncitySessionDirPath(cwd, sessionId), "messages");
+}
+export function getDowncitySessionMessagesPath(cwd, sessionId) {
+    return path.join(getDowncitySessionMessagesDirPath(cwd, sessionId), "messages.jsonl");
+}
+export function getDowncitySessionHistoryMetaPath(cwd, sessionId) {
+    return path.join(getDowncitySessionMessagesDirPath(cwd, sessionId), "meta.json");
+}
+export function getDowncitySessionMessagesArchiveDirPath(cwd, sessionId) {
+    return path.join(getDowncitySessionMessagesDirPath(cwd, sessionId), "archive");
+}
+export function getDowncitySessionMessagesArchivePath(cwd, sessionId, archiveId) {
+    return path.join(getDowncitySessionMessagesArchiveDirPath(cwd, 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");
+}
+export function getDowncityDebugDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), ".debug");
+}
+/**
+ * Chat 元信息目录（由 services/chat 维护）。
+ *
+ * 关键点（中文）
+ * - 该目录存放 `sessionId -> chat` 的最近映射快照
+ * - 与 core session messages 分离，避免把平台路由细节耦合进 core
+ */
+export function getDowncityChatDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "chat");
+}
+/**
+ * Channel 目录（channel -> sessionId 映射）。
+ *
+ * 关键点（中文）
+ * - 专门承载渠道目标与内部 sessionId 的映射关系。
+ * - 与 `chat/` 审计事件目录分离，避免职责混淆。
+ */
+export function getDowncityChannelDirPath(cwd) {
+    return path.join(getDowncityDirPath(cwd), "channel");
+}
+/**
+ * Channel 元信息文件路径。
+ *
+ * 关键点（中文）
+ * - 采用单文件 JSON（`meta.json`）存储映射表与最近路由信息。
+ */
+export function getDowncityChannelMetaPath(cwd) {
+    return path.join(getDowncityChannelDirPath(cwd), "meta.json");
+}
+export function getDowncityChatMetaDirPath(cwd) {
+    return path.join(getDowncityChatDirPath(cwd), "meta");
+}
+export function getDowncityChatMetaPath(cwd, sessionId) {
+    return path.join(getDowncityChatMetaDirPath(cwd), `${encodeURIComponent(String(sessionId || "").trim())}.json`);
+}
+/**
+ * Chat 会话目录（按 sessionId 组织）。
+ *
+ * 关键点（中文）
+ * - 用于存放聊天事件流（history.jsonl）等审计向数据。
+ * - 与 `chat/meta` 分离，避免路由快照与事件流混在一起。
+ */
+export function getDowncityChatSessionDirPath(cwd, sessionId) {
+    return path.join(getDowncityChatDirPath(cwd), encodeURIComponent(String(sessionId || "").trim()));
+}
+/**
+ * Chat 事件流文件路径（JSONL）。
+ *
+ * 关键点（中文）
+ * - 每行一条 chat 事件（当前为 inbound）。
+ * - 设计为 append-only，便于审计与回放。
+ */
+export function getDowncityChatHistoryPath(cwd, sessionId) {
+    return path.join(getDowncityChatSessionDirPath(cwd, sessionId), "history.jsonl");
+}
+//# sourceMappingURL=Paths.js.map

package/bin/config/Paths.js.map

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

package/bin/daemon/Api.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Daemon API 协议类型模块。
+ *
+ * 关键点（中文）
+ * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
+ * - service 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
+ * - 该文件属于 `main/city/daemon/*` 的协议边界，而不是通用 HTTP 类型目录。
+ */
+import type { JsonValue } from "../shared/types/Json.js";
+/**
+ * Daemon 服务端点。
+ */
+export type DaemonEndpoint = {
+    host: string;
+    port: number;
+    baseUrl: string;
+};
+/**
+ * Daemon HTTP 方法白名单。
+ */
+export type DaemonHttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+/**
+ * JSON API 调用参数。
+ *
+ * 关键点（中文）
+ * - `projectRoot` 用于解析 downcity.json 与默认 endpoint。
+ * - `host/port` 可显式覆盖自动解析结果。
+ */
+export type DaemonJsonApiCallParams = {
+    projectRoot: string;
+    path: string;
+    method?: DaemonHttpMethod;
+    body?: JsonValue;
+    /**
+     * 单次调用超时（毫秒）。
+     *
+     * 说明（中文）
+     * - 仅本地 IPC transport 当前会消费该参数。
+     * - 用于 `session execute`、`service command` 这类可能持续几十秒的请求，
+     *   避免被默认短超时误判成“Agent server 未启动”。
+     */
+    timeoutMs?: number;
+    host?: string;
+    port?: number;
+    authToken?: string;
+};
+/**
+ * JSON API 通用返回结构。
+ *
+ * 语义（中文）
+ * - `success=true` 时读取 `data`。
+ * - `success=false` 时读取 `error`（可选 `status`）。
+ */
+export type DaemonJsonApiCallResult<T> = {
+    success: boolean;
+    status?: number;
+    data?: T;
+    error?: string;
+};
+//# sourceMappingURL=Api.d.ts.map

package/bin/daemon/Api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.d.ts","sourceRoot":"","sources":["../../src/daemon/Api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/bin/daemon/Api.js

@@ -0,0 +1,10 @@
+/**
+ * Daemon API 协议类型模块。
+ *
+ * 关键点（中文）
+ * - 这里描述的是 CLI 与 agent daemon 之间的远程访问契约，不包含具体 HTTP 实现。
+ * - service 等上层模块只依赖这些协议类型，不需要感知 city/daemon 的内部实现细节。
+ * - 该文件属于 `main/city/daemon/*` 的协议边界，而不是通用 HTTP 类型目录。
+ */
+export {};
+//# sourceMappingURL=Api.js.map

package/bin/daemon/Api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.js","sourceRoot":"","sources":["../../src/daemon/Api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/daemon/Client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Daemon API 客户端（process 子模块）。
+ *
+ * 关键点（中文）
+ * - 业务模块统一通过 daemon API 与运行时通信。
+ * - 地址解析优先级：CLI 参数 > 环境变量 > daemon meta > 默认值。
+ */
+import { type DaemonJsonApiCallParams, type DaemonJsonApiCallResult } from "./Api.js";
+/**
+ * 调用 daemon JSON API。
+ *
+ * 错误语义（中文）
+ * - 网络异常：`success=false` + `error`（无 status）。
+ * - HTTP 非 2xx：`success=false` + `status` + `error`。
+ */
+export declare function callServer<T>(params: DaemonJsonApiCallParams): Promise<DaemonJsonApiCallResult<T>>;
+//# sourceMappingURL=Client.d.ts.map

package/bin/daemon/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/daemon/Client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,UAAU,CAAC;AAqGlB;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CA0DrC"}