@downcity/agent 1.1.35 → 1.1.51

package/bin/config/AgentInitializer.js

@@ -0,0 +1,210 @@
+/**
+ * Agent 项目初始化模块。
+ *
+ * 职责说明（中文）
+ * - CLI `city agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
+ * - 负责创建项目骨架、静态 prompt、默认 `downcity.json`、基础目录与 schema 文件。
+ * - 负责把用户在创建阶段提供的最小执行配置与渠道配置写入项目。
+ *
+ * 边界说明（中文）
+ * - 这里只处理“初始化一个新项目”所需的静态文件与目录，不处理 daemon 启停。
+ * - 这里只校验项目创建阶段依赖的最小平台条件，不承担后续运行时配置合并职责。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { getCacheDirPath, getDowncityAgentsRootDirPath, getLogsDirPath, getProfileMdPath, getDowncityConfigDirPath, getDowncityDataDirPath, getDowncityDebugDirPath, getDowncityDirPath, getDowncityJsonPath, getDowncityProfileDirPath, getDowncityProfileOtherPath, getDowncityProfilePrimaryPath, getDowncityPublicDirPath, getDowncitySchemaPath, getDowncityTasksDirPath, getSoulMdPath, } from "../config/Paths.js";
+import { DEFAULT_DOWNCITY_JSON } from "../config/Defaults.js";
+import { DOWNCITY_JSON_SCHEMA } from "../config/DowncitySchema.js";
+import { DEFAULT_PROFILE_MD_TEMPLATE, DEFAULT_SOUL_MD_TEMPLATE, } from "../executor/composer/system/default/InitPrompts.js";
+import { appendMissingEnvEntries } from "../config/EnvFile.js";
+import { ensureGitignoreEntry } from "../config/Gitignore.js";
+import { renderTemplateVariables } from "../utils/Template.js";
+import { ensureDir, saveJson } from "../utils/storage/index.js";
+import { assertProjectExecutionTarget } from "../config/ExecutionBinding.js";
+/**
+ * 规范化默认 Agent ID。
+ *
+ * 关键点（中文）
+ * - 把目录名清洗为稳定、可重复的 snake_case 标识，避免展示名语义混入 SDK。
+ * - 这里只做最小格式规整，不负责跨项目唯一性分配。
+ */
+export function normalizeDefaultAgentId(input) {
+    return String(input || "")
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .replace(/_{2,}/g, "_")
+        .trim();
+}
+/**
+ * 规范化用户选择的渠道列表。
+ *
+ * 关键点（中文）
+ * - 只保留当前 agent 初始化流程支持的渠道。
+ * - 会自动去重并统一为小写，避免调用方在外部重复做清洗。
+ */
+function normalizeChannels(input) {
+    const allowed = new Set(["telegram", "feishu", "qq"]);
+    const seen = new Set();
+    for (const item of Array.isArray(input) ? input : []) {
+        const value = String(item || "").trim().toLowerCase();
+        if (!allowed.has(value))
+            continue;
+        seen.add(value);
+    }
+    return [...seen];
+}
+/**
+ * 判断项目是否已经具备最小初始化文件。
+ *
+ * 关键点（中文）
+ * - 当前只检查 `PROFILE.md` 与 `downcity.json`，用于快速判断是否已初始化过。
+ * - 不把 `.downcity/` 目录作为硬性条件，避免用户手动清理缓存后被误判为未初始化。
+ */
+export async function isAgentProjectInitialized(projectRoot) {
+    const normalizedRoot = path.resolve(String(projectRoot || "").trim() || ".");
+    const profileReady = await fs.pathExists(getProfileMdPath(normalizedRoot));
+    const shipReady = await fs.pathExists(getDowncityJsonPath(normalizedRoot));
+    return profileReady && shipReady;
+}
+/**
+ * 初始化 agent 项目骨架。
+ *
+ * 关键点（中文）
+ * - 会创建 prompt 文件、配置文件、`.downcity` 目录结构以及 schema 快照。
+ * - 对已存在文件采取“能跳过就跳过、明确冲突则报错”的策略，降低误覆盖风险。
+ * - 返回结果只描述本次初始化写入摘要，方便 CLI 与控制台直接展示。
+ */
+export async function initializeAgentProject(input) {
+    const projectRoot = path.resolve(String(input.projectRoot || "").trim() || ".");
+    const projectBaseName = path.basename(projectRoot);
+    const fallback_agent_id = normalizeDefaultAgentId(projectBaseName) || projectBaseName;
+    const agent_id = String(input.id || "").trim() || fallback_agent_id;
+    const execution = input.execution;
+    const channels = normalizeChannels(input.channels);
+    const dotEnvPath = path.join(projectRoot, ".env");
+    const dotEnvExamplePath = path.join(projectRoot, ".env.example");
+    const createdFiles = [];
+    const skippedFiles = [];
+    assertProjectExecutionTarget({
+        id: agent_id,
+        version: "1.0.0",
+        execution,
+    });
+    await ensureDir(projectRoot);
+    const profileMdPath = getProfileMdPath(projectRoot);
+    const soulMdPath = getSoulMdPath(projectRoot);
+    const shipJsonPath = getDowncityJsonPath(projectRoot);
+    const existingShipJson = await fs.pathExists(shipJsonPath);
+    if (existingShipJson && input.forceOverwriteShipJson !== true) {
+        throw new Error(`downcity.json already exists: ${shipJsonPath}`);
+    }
+    const initTemplateVariables = {
+        agent_id,
+    };
+    const staticPromptFiles = [
+        {
+            filename: "PROFILE.md",
+            filePath: profileMdPath,
+            content: renderTemplateVariables(DEFAULT_PROFILE_MD_TEMPLATE, initTemplateVariables),
+        },
+        {
+            filename: "SOUL.md",
+            filePath: soulMdPath,
+            content: renderTemplateVariables(DEFAULT_SOUL_MD_TEMPLATE, initTemplateVariables),
+        },
+    ];
+    for (const file of staticPromptFiles) {
+        if (await fs.pathExists(file.filePath)) {
+            skippedFiles.push(file.filename);
+            continue;
+        }
+        await fs.writeFile(file.filePath, file.content, "utf-8");
+        createdFiles.push(file.filename);
+    }
+    const channelsConfig = {};
+    if (channels.includes("telegram")) {
+        channelsConfig.telegram = { enabled: true };
+    }
+    if (channels.includes("feishu")) {
+        channelsConfig.feishu = { enabled: true };
+    }
+    if (channels.includes("qq")) {
+        channelsConfig.qq = { enabled: true };
+    }
+    const shipConfig = {
+        $schema: DEFAULT_DOWNCITY_JSON.$schema,
+        id: agent_id,
+        version: "1.0.0",
+        execution,
+        plugins: {
+            skill: {
+                enabled: true,
+                paths: [".agents/skills"],
+                allowExternalPaths: false,
+            },
+            ...(input.plugins || {}),
+        },
+        ...(Object.keys(channelsConfig).length > 0
+            ? {
+                plugins: {
+                    chat: {
+                        channels: channelsConfig,
+                    },
+                },
+            }
+            : {}),
+    };
+    await saveJson(shipJsonPath, shipConfig);
+    createdFiles.push("downcity.json");
+    await appendMissingEnvEntries(dotEnvPath, "Downcity Create", []);
+    await appendMissingEnvEntries(dotEnvExamplePath, "Downcity Create Example", []);
+    const gitignoreStatus = await ensureGitignoreEntry(projectRoot, ".downcity");
+    if (gitignoreStatus === "created" || gitignoreStatus === "updated") {
+        createdFiles.push(".gitignore");
+    }
+    else {
+        skippedFiles.push(".gitignore");
+    }
+    const dirs = [
+        getDowncityDirPath(projectRoot),
+        getDowncityTasksDirPath(projectRoot),
+        getLogsDirPath(projectRoot),
+        getCacheDirPath(projectRoot),
+        getDowncityProfileDirPath(projectRoot),
+        getDowncityDataDirPath(projectRoot),
+        getDowncityAgentsRootDirPath(projectRoot),
+        getDowncityPublicDirPath(projectRoot),
+        getDowncityConfigDirPath(projectRoot),
+        path.join(projectRoot, ".agents", "skills"),
+        path.join(getDowncityDirPath(projectRoot), "schema"),
+        getDowncityDebugDirPath(projectRoot),
+    ];
+    for (const dir of dirs) {
+        await ensureDir(dir);
+    }
+    const shipSchemaPath = getDowncitySchemaPath(projectRoot);
+    await ensureDir(path.dirname(shipSchemaPath));
+    await saveJson(shipSchemaPath, DOWNCITY_JSON_SCHEMA);
+    createdFiles.push(".downcity/schema/downcity.schema.json");
+    try {
+        await ensureDir(getDowncityProfileDirPath(projectRoot));
+        await fs.ensureFile(getDowncityProfilePrimaryPath(projectRoot));
+        await fs.ensureFile(getDowncityProfileOtherPath(projectRoot));
+    }
+    catch {
+        // ignore optional profile memory bootstrap errors
+    }
+    return {
+        projectRoot,
+        id: agent_id,
+        ...(execution?.type === "api" && String(execution.modelId || "").trim()
+            ? { modelId: String(execution.modelId || "").trim() }
+            : {}),
+        channels,
+        createdFiles,
+        skippedFiles,
+    };
+}
+//# sourceMappingURL=AgentInitializer.js.map

package/bin/config/AgentInitializer.js.map

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

package/bin/config/Config.d.ts

@@ -1,32 +1,27 @@
 import type { DowncityConfig } from "../types/config/DowncityConfig.js";
 export type { DowncityConfig };
 /**
- * 读取平台共享环境变量（`env_entries.scope=global`）。
- */
-export declare function loadGlobalEnvFromStore(): Record<string, string>;
-/**
- * 读取 agent 私有环境变量（`env_entries.scope=agent`）。
+ * 读取项目 `.env` 快照（不污染全局 process.env）。
+ *
+ * 关键点（中文）
+ * - 只返回当前 agent 项目自己的 env 映射，供 runtime 局部使用。
  */
-export declare function loadAgentEnvFromStore(agentId: string): Record<string, string>;
+export declare function loadProjectDotenv(projectRoot: string): Record<string, string>;
 /**
- * 读取 agent 最终环境变量快照。
+ * 解析当前 agent 最终用户环境变量。
  *
  * 关键点（中文）
- * - 来源：agent scope env（DB） + `<agent>/.env`（用户文件）。
- * - 冲突时 `.env` 优先，满足用户可在本地即时覆盖。
+ * - 合并顺序固定为：宿主显式 `env` < 项目 `.env`。
+ * - `@downcity/agent` 不再自动读取当前进程 `process.env`。
+ * - 这里返回的是“用户可感知”的最终 env，不包含 session/server 运行时元信息。
  */
-export declare function loadAgentEnvSnapshot(projectRoot: string): Record<string, string>;
+export declare function resolveAgentEnv(projectRoot: string, hostEnv?: Record<string, string>): Record<string, string>;
 /**
- * 读取项目 `.env` 快照（不污染全局 process.env）。
+ * 加载当前项目最终生效的 `downcity.json` 配置。
  *
  * 关键点（中文）
- * - 只返回当前 agent 项目自己的 env 映射，供 runtime 局部使用。
- * - 不再把 agent env 注入全局，避免多个 agent 在同一 control plane 进程里互相污染。
+ * - 读取顺序为“祖先目录 -> 当前项目目录”，后层配置覆盖前层配置。
+ * - 返回前会断言最小执行目标，保证 agent 至少知道该如何执行。
  */
-export declare function loadProjectDotenv(projectRoot: string): Record<string, string>;
-export declare function loadDowncityConfig(projectRoot: string, options?: {
-    projectEnv?: Record<string, string>;
-    agentEnv?: Record<string, string>;
-    globalEnv?: Record<string, string>;
-}): DowncityConfig;
+export declare function loadDowncityConfig(projectRoot: string): DowncityConfig;
 //# sourceMappingURL=Config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI7E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB7E;AA4GD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GACA,cAAc,CA2ChB"}
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAMvE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB7E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB;AA8BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA2BtE"}

package/bin/config/Config.js

@@ -1,50 +1,27 @@
 /**
- * Config：agent 项目环境与配置读取模块。
+ * Agent 项目配置读取与装配模块。
  *
- * 关键点（中文）
- * - 这里统一处理 `downcity.json`、项目 `.env`、全局 env 快照三类配置来源。
- * - agent 运行时通过这里读取项目配置，避免各处重复拼装规则。
+ * 职责说明（中文）
+ * - 统一负责读取 `downcity.json`、项目 `.env` 与宿主显式注入的基础 env。
+ * - 负责把祖先目录中的多个 `downcity.json` 逐层合并成当前项目的最终配置。
+ * - 负责在配置读取阶段完成最小结构校验。
+ *
+ * 边界说明（中文）
+ * - 这里只做“配置文件 -> 运行时配置对象”的装配，不负责项目初始化写文件。
+ * - 这里只校验配置是否满足 agent 运行最低要求，不负责平台模型是否真实可用。
  */
 import dotenv from "dotenv";
 import fs from "fs-extra";
 import path from "path";
 import { assertProjectExecutionTarget } from "../config/ExecutionBinding.js";
-/**
- * 读取平台共享环境变量（`env_entries.scope=global`）。
- */
-export function loadGlobalEnvFromStore() {
-    return {};
-}
-/**
- * 读取 agent 私有环境变量（`env_entries.scope=agent`）。
- */
-export function loadAgentEnvFromStore(agentId) {
-    const normalizedAgentId = String(agentId || "").trim();
-    if (!normalizedAgentId)
-        return {};
-    return {};
-}
-/**
- * 读取 agent 最终环境变量快照。
- *
- * 关键点（中文）
- * - 来源：agent scope env（DB） + `<agent>/.env`（用户文件）。
- * - 冲突时 `.env` 优先，满足用户可在本地即时覆盖。
- */
-export function loadAgentEnvSnapshot(projectRoot) {
-    const agentFromDb = loadAgentEnvFromStore(projectRoot);
-    const projectDotenv = loadProjectDotenv(projectRoot);
-    return {
-        ...agentFromDb,
-        ...projectDotenv,
-    };
-}
+import { deepMerge } from "../utils/object/DeepMerge.js";
+import { isPlainObject } from "../utils/object/ObjectGuards.js";
+import { collectAncestorNamedFilePaths } from "../utils/path/AncestorFiles.js";
 /**
  * 读取项目 `.env` 快照（不污染全局 process.env）。
  *
  * 关键点（中文）
  * - 只返回当前 agent 项目自己的 env 映射，供 runtime 局部使用。
- * - 不再把 agent env 注入全局，避免多个 agent 在同一 control plane 进程里互相污染。
  */
 export function loadProjectDotenv(projectRoot) {
     // 关键点（中文）
@@ -70,59 +47,28 @@ export function loadProjectDotenv(projectRoot) {
         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 为准。
+ * 解析当前 agent 最终用户环境变量。
  *
  * 关键点（中文）
- * - downcity.json 的“继承/覆盖”语义：越靠近 agent 项目的配置优先级越高。
- * - 数组不做 concat，避免出现重复 paths / models。
+ * - 合并顺序固定为：宿主显式 `env` < 项目 `.env`。
+ * - `@downcity/agent` 不再自动读取当前进程 `process.env`。
+ * - 这里返回的是“用户可感知”的最终 env，不包含 session/server 运行时元信息。
  */
-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;
+export function resolveAgentEnv(projectRoot, hostEnv) {
+    return {
+        ...(hostEnv ? { ...hostEnv } : {}),
+        ...loadProjectDotenv(projectRoot),
+    };
 }
-function readShipJsonLayer(filePath, resolveEnvVar) {
-    const raw = fs.readJsonSync(filePath);
-    return resolveEnvPlaceholdersDeep(raw, resolveEnvVar);
+/**
+ * 读取单层 `downcity.json`。
+ *
+ * 关键点（中文）
+ * - 单层读取不做字段语义校验，便于后续统一合并后再做最终断言。
+ */
+function readShipJsonLayer(filePath) {
+    return fs.readJsonSync(filePath);
 }
 /**
  * 校验项目层是否误配废弃的 `extensions` 字段。
@@ -138,48 +84,21 @@ function assertNoProjectExtensionsLayer(filePath, layer) {
         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);
+/**
+ * 加载当前项目最终生效的 `downcity.json` 配置。
+ *
+ * 关键点（中文）
+ * - 读取顺序为“祖先目录 -> 当前项目目录”，后层配置覆盖前层配置。
+ * - 返回前会断言最小执行目标，保证 agent 至少知道该如何执行。
+ */
+export function loadDowncityConfig(projectRoot) {
+    const ancestorShipJsonPaths = collectAncestorNamedFilePaths(projectRoot, "downcity.json");
     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);
+        const layer = readShipJsonLayer(p);
         assertNoProjectExtensionsLayer(p, layer);
         merged = deepMerge(merged, layer);
     }
@@ -187,8 +106,8 @@ export function loadDowncityConfig(projectRoot, options) {
         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");
+    if (typeof candidate.id !== "string" || typeof candidate.version !== "string") {
+        throw new Error("Invalid downcity.json: missing required fields id/version");
     }
     const config = candidate;
     assertProjectExecutionTarget(config);

package/bin/config/Config.js.map

@@ -1 +1 @@
-{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAI5E;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,EAAE,CAAC;AACZ,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,OAAO,EAAE,CAAC;AACZ,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,mDAAmD;IACnD,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"}
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../src/config/Config.ts"],"names":[],"mappings":"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"}

package/bin/config/Defaults.d.ts

@@ -1,13 +1,21 @@
 /**
- * Defaults：agent 项目默认配置模板。
+ * Agent 项目默认配置模板模块。
  *
- * 关键点（中文）
- * - 这里集中声明初始化项目时写入的默认 `downcity.json`。
- * - 默认值只服务项目初始化，不参与运行时配置合并逻辑。
+ * 职责说明（中文）
+ * - 集中声明初始化新项目时写入的默认 `downcity.json` 结构。
+ * - 为创建流程提供一份稳定、最小可运行的默认配置基线。
+ *
+ * 边界说明（中文）
+ * - 这里的默认值只服务“新项目生成”，不参与运行时多层配置合并。
+ * - 业务运行过程中若要读取最终配置，应始终走 `Config.ts` 的装配逻辑。
  */
 import type { DowncityConfig } from "../types/config/DowncityConfig.js";
 /**
  * 默认 `downcity.json` 配置。
+ *
+ * 关键点（中文）
+ * - 这是一份“初始化模板”，不是运行时的最终真相来源。
+ * - 调用方若只想取某个字段的默认值，也应意识到它可能被用户项目配置覆盖。
  */
 export declare const DEFAULT_DOWNCITY_JSON: DowncityConfig;
 //# sourceMappingURL=Defaults.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Defaults.d.ts","sourceRoot":"","sources":["../../src/config/Defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAmCnC,CAAC"}
+{"version":3,"file":"Defaults.d.ts","sourceRoot":"","sources":["../../src/config/Defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,cA2BnC,CAAC"}

package/bin/config/Defaults.js

@@ -1,16 +1,24 @@
 /**
- * Defaults：agent 项目默认配置模板。
+ * Agent 项目默认配置模板模块。
  *
- * 关键点（中文）
- * - 这里集中声明初始化项目时写入的默认 `downcity.json`。
- * - 默认值只服务项目初始化，不参与运行时配置合并逻辑。
+ * 职责说明（中文）
+ * - 集中声明初始化新项目时写入的默认 `downcity.json` 结构。
+ * - 为创建流程提供一份稳定、最小可运行的默认配置基线。
+ *
+ * 边界说明（中文）
+ * - 这里的默认值只服务“新项目生成”，不参与运行时多层配置合并。
+ * - 业务运行过程中若要读取最终配置，应始终走 `Config.ts` 的装配逻辑。
  */
 /**
  * 默认 `downcity.json` 配置。
+ *
+ * 关键点（中文）
+ * - 这是一份“初始化模板”，不是运行时的最终真相来源。
+ * - 调用方若只想取某个字段的默认值，也应意识到它可能被用户项目配置覆盖。
  */
 export const DEFAULT_DOWNCITY_JSON = {
     $schema: "./.downcity/schema/downcity.schema.json",
-    name: "downcity",
+    id: "downcity",
     version: "1.0.0",
     start: {
         port: 5314,
@@ -20,14 +28,6 @@ export const DEFAULT_DOWNCITY_JSON = {
         type: "api",
         modelId: "default",
     },
-    context: {
-        messages: {
-            keepLastMessages: 30,
-            maxInputTokensApprox: 128000,
-            archiveOnCompact: true,
-            compactRatio: 0.5,
-        },
-    },
     plugins: {
         chat: {
             queue: {

package/bin/config/Defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"Defaults.js","sourceRoot":"","sources":["../../src/config/Defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;KAChB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,SAAS;KACnB;IACD,OAAO,EAAE;QACP,QAAQ,EAAE;YACR,gBAAgB,EAAE,EAAE;YACpB,oBAAoB,EAAE,MAAM;YAC5B,gBAAgB,EAAE,IAAI;YACtB,YAAY,EAAE,GAAG;SAClB;KACF;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,GAAG;gBACpB,cAAc,EAAE,IAAI;aACrB;YACD,QAAQ,EAAE;gBACR,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK;oBACd,gBAAgB,EAAE,SAAS;iBAC5B;aACF;SACF;KACF;CACF,CAAC"}
+{"version":3,"file":"Defaults.js","sourceRoot":"","sources":["../../src/config/Defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,OAAO,EAAE,yCAAyC;IAClD,EAAE,EAAE,UAAU;IACd,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,SAAS;KAChB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,SAAS;KACnB;IACD,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,GAAG;gBACpB,cAAc,EAAE,IAAI;aACrB;YACD,QAAQ,EAAE;gBACR,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK;oBACd,gBAAgB,EAAE,SAAS;iBAC5B;aACF;SACF;KACF;CACF,CAAC"}

package/bin/config/DowncitySchema.d.ts

@@ -1,3 +1,21 @@
+/**
+ * `downcity.json` Schema 定义模块。
+ *
+ * 职责说明（中文）
+ * - 提供项目初始化时写入本地的 JSON Schema 常量。
+ * - 统一维护用户可编辑配置的结构约束、字段说明与编辑器联想元数据。
+ *
+ * 边界说明（中文）
+ * - 这里是静态 schema 常量，不负责运行时配置装配或业务校验逻辑。
+ * - 当 schema 与运行时实现存在差异时，应同时更新配置解析与用户文档。
+ */
 import type { JsonObject } from "../types/common/Json.js";
+/**
+ * `downcity.json` 的本地 Schema 常量。
+ *
+ * 关键点（中文）
+ * - 初始化流程会把该常量写入 `.downcity/schema/downcity.schema.json`。
+ * - 该结构主要面向 IDE 校验与用户编辑体验，不替代运行时断言。
+ */
 export declare const DOWNCITY_JSON_SCHEMA: JsonObject;
 //# sourceMappingURL=DowncitySchema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DowncitySchema.d.ts","sourceRoot":"","sources":["../../src/config/DowncitySchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,oBAAoB,EAAE,UAgXlC,CAAC"}
+{"version":3,"file":"DowncitySchema.d.ts","sourceRoot":"","sources":["../../src/config/DowncitySchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAkQlC,CAAC"}