@downcity/agent 1.1.35 → 1.1.43

package/bin/utils/object/DeepMerge.js

@@ -0,0 +1,37 @@
+/**
+ * 通用深合并工具模块。
+ *
+ * 职责说明（中文）
+ * - 提供对象递归合并能力，供配置装配等“层层覆盖”场景复用。
+ * - 统一约束数组与标量的覆盖语义，避免不同模块出现不一致行为。
+ * - 这里只负责结构合并，不负责字段合法性校验。
+ */
+import { isPlainObject } from "../../utils/object/ObjectGuards.js";
+/**
+ * 深合并两个未知值。
+ *
+ * 关键点（中文）
+ * - 只有“对象 + 对象”会递归合并。
+ * - 数组始终以 `override` 为准，不做拼接。
+ * - 当 `override === undefined` 时保留 `base`，便于做配置层覆盖。
+ */
+export 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;
+}
+//# sourceMappingURL=DeepMerge.js.map

package/bin/utils/object/DeepMerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepMerge.js","sourceRoot":"","sources":["../../../src/utils/object/DeepMerge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,QAAiB;IACxD,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,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,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;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/bin/utils/object/ObjectGuards.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 对象类型守卫工具模块。
+ *
+ * 职责说明（中文）
+ * - 提供与“普通对象”判断相关的基础守卫函数。
+ * - 供配置解析、CLI 输出、深合并等多个领域复用，避免每个模块各写一份。
+ * - 这里只处理通用对象判断，不携带任何业务字段语义。
+ */
+/**
+ * 判断一个值是否为普通对象记录。
+ *
+ * 关键点（中文）
+ * - 数组、`null`、函数都不会被视为普通对象。
+ * - 当前只要求“可按键遍历的普通对象”，不强制校验原型链来源。
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=ObjectGuards.d.ts.map

package/bin/utils/object/ObjectGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectGuards.d.ts","sourceRoot":"","sources":["../../../src/utils/object/ObjectGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E"}

package/bin/utils/object/ObjectGuards.js

@@ -0,0 +1,19 @@
+/**
+ * 对象类型守卫工具模块。
+ *
+ * 职责说明（中文）
+ * - 提供与“普通对象”判断相关的基础守卫函数。
+ * - 供配置解析、CLI 输出、深合并等多个领域复用，避免每个模块各写一份。
+ * - 这里只处理通用对象判断，不携带任何业务字段语义。
+ */
+/**
+ * 判断一个值是否为普通对象记录。
+ *
+ * 关键点（中文）
+ * - 数组、`null`、函数都不会被视为普通对象。
+ * - 当前只要求“可按键遍历的普通对象”，不强制校验原型链来源。
+ */
+export function isPlainObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=ObjectGuards.js.map

package/bin/utils/object/ObjectGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectGuards.js","sourceRoot":"","sources":["../../../src/utils/object/ObjectGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/bin/utils/path/AncestorFiles.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 祖先目录文件收集工具模块。
+ *
+ * 职责说明（中文）
+ * - 负责沿着目录树自下而上查找固定文件名，并按“根到叶子”顺序返回。
+ * - 供配置继承、工作区约定查找等场景复用，避免把目录遍历逻辑散落到业务模块。
+ * - 这里只处理文件路径收集，不解析文件内容。
+ */
+/**
+ * 收集当前目录及其所有祖先目录中的指定文件。
+ *
+ * 关键点（中文）
+ * - 返回结果按“最上层目录 -> 当前项目目录”排序，适合做逐层覆盖合并。
+ * - 若文件名为空，则直接返回空数组，避免调用方拼接出异常路径。
+ */
+export declare function collectAncestorNamedFilePaths(projectRoot: string, filename: string): string[];
+//# sourceMappingURL=AncestorFiles.d.ts.map

package/bin/utils/path/AncestorFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AncestorFiles.d.ts","sourceRoot":"","sources":["../../../src/utils/path/AncestorFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAiBV"}

package/bin/utils/path/AncestorFiles.js

@@ -0,0 +1,36 @@
+/**
+ * 祖先目录文件收集工具模块。
+ *
+ * 职责说明（中文）
+ * - 负责沿着目录树自下而上查找固定文件名，并按“根到叶子”顺序返回。
+ * - 供配置继承、工作区约定查找等场景复用，避免把目录遍历逻辑散落到业务模块。
+ * - 这里只处理文件路径收集，不解析文件内容。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+/**
+ * 收集当前目录及其所有祖先目录中的指定文件。
+ *
+ * 关键点（中文）
+ * - 返回结果按“最上层目录 -> 当前项目目录”排序，适合做逐层覆盖合并。
+ * - 若文件名为空，则直接返回空数组，避免调用方拼接出异常路径。
+ */
+export function collectAncestorNamedFilePaths(projectRoot, filename) {
+    const normalizedFilename = String(filename || "").trim();
+    if (!normalizedFilename)
+        return [];
+    const paths = [];
+    let dir = path.resolve(String(projectRoot || "").trim() || ".");
+    while (true) {
+        const candidate = path.join(dir, normalizedFilename);
+        if (fs.existsSync(candidate)) {
+            paths.push(candidate);
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return paths.reverse();
+}
+//# sourceMappingURL=AncestorFiles.js.map

package/bin/utils/path/AncestorFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AncestorFiles.js","sourceRoot":"","sources":["../../../src/utils/path/AncestorFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,WAAmB,EACnB,QAAgB;IAEhB,MAAM,kBAAkB,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC,kBAAkB;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC;IAChE,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACrD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC"}

package/bin/utils/string/EscapeRegExp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 正则转义工具模块。
+ *
+ * 职责说明（中文）
+ * - 提供把普通字符串安全嵌入 `RegExp` 模式中的基础能力。
+ * - 避免各业务模块手写重复实现，并降低正则特殊字符导致的误匹配风险。
+ * - 这里只做字面量转义，不负责拼装完整正则表达式。
+ */
+/**
+ * 转义字符串中的正则特殊字符。
+ *
+ * 关键点（中文）
+ * - 返回值适合直接插入 `new RegExp(...)` 的模式字符串。
+ * - 不会自动添加边界、分组或 flags。
+ */
+export declare function escapeRegExp(input: string): string;
+//# sourceMappingURL=EscapeRegExp.d.ts.map

package/bin/utils/string/EscapeRegExp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EscapeRegExp.d.ts","sourceRoot":"","sources":["../../../src/utils/string/EscapeRegExp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/bin/utils/string/EscapeRegExp.js

@@ -0,0 +1,19 @@
+/**
+ * 正则转义工具模块。
+ *
+ * 职责说明（中文）
+ * - 提供把普通字符串安全嵌入 `RegExp` 模式中的基础能力。
+ * - 避免各业务模块手写重复实现，并降低正则特殊字符导致的误匹配风险。
+ * - 这里只做字面量转义，不负责拼装完整正则表达式。
+ */
+/**
+ * 转义字符串中的正则特殊字符。
+ *
+ * 关键点（中文）
+ * - 返回值适合直接插入 `new RegExp(...)` 的模式字符串。
+ * - 不会自动添加边界、分组或 flags。
+ */
+export function escapeRegExp(input) {
+    return String(input || "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=EscapeRegExp.js.map

package/bin/utils/string/EscapeRegExp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EscapeRegExp.js","sourceRoot":"","sources":["../../../src/utils/string/EscapeRegExp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.35",
+  "version": "1.1.43",
   "type": "module",
   "description": "Downcity Agent 运行时 — 执行壳，通过 RPC/HTTP 调用 City 的能力",
   "main": "./bin/index.js",
@@ -9,11 +9,16 @@
     ".": {
       "import": "./bin/index.js",
       "types": "./bin/index.d.ts"
+    },
+    "./internal/*": {
+      "import": "./bin/*.js",
+      "types": "./bin/*.d.ts"
     }
   },
   "dependencies": {
     "@larksuiteoapi/node-sdk": "^1.40.0",
     "ai": "^6.0.57",
+    "better-sqlite3": "^11.10.0",
     "commander": "^12.0.0",
     "dotenv": "^16.4.0",
     "execa": "^9.5.0",
@@ -26,6 +31,7 @@
     "zod": "^3.24.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/fs-extra": "^11.0.4",
     "@types/js-yaml": "^4.0.0",
     "@types/node": "^22.0.0",