@downcity/agent 1.1.7 → 1.1.10

package/bin/utils/logger/Logger.js

@@ -0,0 +1,308 @@
+/**
+ * 统一日志实现（控制台 + JSONL 落盘）。
+ *
+ * 关键点（中文）
+ * - 支持按项目根目录动态绑定日志目录。
+ * - 结构化字段写入 JSONL，便于后续检索与审计。
+ */
+import fs from "fs-extra";
+import path from "path";
+import { getLogsDirPath } from "../../config/Paths.js";
+import { getTimestamp } from "../../utils/Time.js";
+const ANSI_RESET = "\x1b[0m";
+const ANSI_BOLD = "\x1b[1m";
+const TASK_BRACKET_COLOR = "\x1b[95m"; // bright magenta
+const ALLOWED_MESSAGE_LABELS = new Set([
+    "main",
+    "system",
+    "user",
+    "assistant",
+    "tool",
+    "tool_result",
+    "agent",
+]);
+const FIXED_BRACKET_COLORS = {
+    INFO: "\x1b[36m", // cyan
+    WARN: "\x1b[33m", // yellow
+    ERROR: "\x1b[31m", // red
+    DEBUG: "\x1b[90m", // gray
+    ACTION: "\x1b[96m", // bright cyan
+    SYSTEM: "\x1b[90m", // gray
+    USER: "\x1b[33m", // yellow
+    ASSISTANT: "\x1b[32m", // green
+    TOOL: "\x1b[95m", // bright magenta
+    TOOL_RESULT: "\x1b[34m", // blue
+    AGENT: "\x1b[36m", // cyan
+    MAIN: "\x1b[90m", // gray
+};
+const BRACKET_COLOR_PALETTE = [
+    "\x1b[36m", // cyan
+    "\x1b[32m", // green
+    "\x1b[35m", // magenta
+    "\x1b[34m", // blue
+    "\x1b[33m", // yellow
+    "\x1b[96m", // bright cyan
+];
+function normalizeLogDetails(details) {
+    if (!details)
+        return undefined;
+    const normalized = {};
+    for (const [key, value] of Object.entries(details)) {
+        if (value !== undefined) {
+            normalized[key] = value;
+        }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+function hashText(input) {
+    let hash = 0;
+    for (let index = 0; index < input.length; index += 1) {
+        hash = (hash * 31 + input.charCodeAt(index)) >>> 0;
+    }
+    return hash;
+}
+function colorizeBracketedPrefix(label) {
+    const normalized = String(label || "").trim().toUpperCase();
+    const baseLabel = normalized.split(/[.\s]+/)[0].replace(/[^A-Z0-9_]/g, "");
+    // 关键点（中文）：task 日志标签使用固定高可见色，避免随机色导致辨识度不稳定。
+    if (normalized === "TASK") {
+        return `${TASK_BRACKET_COLOR}[${label}]${ANSI_RESET}`;
+    }
+    const fixedColor = FIXED_BRACKET_COLORS[normalized] || FIXED_BRACKET_COLORS[baseLabel];
+    if (fixedColor) {
+        return `${fixedColor}[${label}]${ANSI_RESET}`;
+    }
+    const color = BRACKET_COLOR_PALETTE[hashText(label) % BRACKET_COLOR_PALETTE.length];
+    return `${color}[${label}]${ANSI_RESET}`;
+}
+function colorizeMessageBracketPrefixes(message) {
+    // 关键点（中文）：紧凑单行展示时，给消息中的标签 token 着色，正文保持原样。
+    return String(message || "").replace(/\[([^\]\n]+)\]/g, (full, label) => {
+        const normalized = String(label || "").trim();
+        const base = normalized
+            .toUpperCase()
+            .split(/[.\s:]+/)[0]
+            .replace(/[^A-Z0-9_]/g, "");
+        if (!base || !/[A-Z]/.test(base))
+            return full;
+        return colorizeBracketedPrefix(normalized);
+    });
+}
+/**
+ * 压缩日志为“可分段的紧凑展示”。
+ *
+ * 关键点（中文）
+ * - 段内换行转义为字面量 `\n`，避免一条消息占多行。
+ * - 段与段之间保留真实换行，确保不同 message 可清晰区分。
+ */
+function compactMessageForConsole(message) {
+    const normalized = String(message || "").replace(/\r\n/g, "\n");
+    const blocks = normalized
+        .split(/\n{2,}/)
+        .map((block) => String(block || "").replace(/\n/g, "\\n").trim())
+        .filter(Boolean);
+    if (blocks.length === 0)
+        return "";
+    return blocks.join("\n");
+}
+function normalizeToAllowedMessageLabels(message) {
+    const normalizedLines = [];
+    let activeLabel = null;
+    for (const rawLine of String(message || "").split("\n")) {
+        const line = String(rawLine || "");
+        const trimmed = line.trim();
+        if (!trimmed) {
+            normalizedLines.push("");
+            continue;
+        }
+        const matched = trimmed.match(/^\[([^\]]+)\]\s*:?\s*(.*)$/);
+        if (matched) {
+            const rawLabel = String(matched[1] || "").trim();
+            const lowerLabel = rawLabel.toLowerCase();
+            const labelToken = lowerLabel.split(/\s+/)[0] || "";
+            const baseLabel = labelToken.split(".")[0];
+            const content = String(matched[2] || "").trim();
+            if (ALLOWED_MESSAGE_LABELS.has(baseLabel)) {
+                activeLabel = baseLabel;
+                const attrsRaw = rawLabel.slice(labelToken.length).trim();
+                const normalizedLabel = attrsRaw ? `${baseLabel} ${attrsRaw}` : baseLabel;
+                normalizedLines.push(`[${normalizedLabel}]${content ? ` ${content}` : ""}`);
+            }
+            else {
+                activeLabel = "main";
+                normalizedLines.push(`[main] ${content || trimmed}`);
+            }
+            continue;
+        }
+        if (activeLabel) {
+            // 关键点（中文）：同一消息块的续行不重复打标签。
+            normalizedLines.push(line);
+            continue;
+        }
+        normalizedLines.push(`[main] ${trimmed}`);
+    }
+    if (normalizedLines.length === 0)
+        return "[main] -";
+    return normalizedLines.join("\n");
+}
+/**
+ * Logger：项目级日志器。
+ *
+ * 关键职责（中文）
+ * - 控制台可读输出（开发期）
+ * - JSONL 持久化输出（排障 / 审计）
+ */
+export class Logger {
+    logs = [];
+    logLevel = "info";
+    writeChain = Promise.resolve();
+    maxInMemoryEntries = 2000;
+    projectRoot = null;
+    constructor(logLevel = "info") {
+        this.logLevel = logLevel;
+    }
+    /**
+     * 绑定进程级 projectRoot。
+     *
+     * 关键点（中文）
+     * - 我们约束“一个进程只服务一个 projectRoot”。
+     * - Logger 作为单例存在，但落盘目录必须在启动入口初始化后才能确定。
+     * - 未绑定 projectRoot 时，只打印到 console，不写入 `.downcity/logs/*`。
+     */
+    bindProjectRoot(projectRoot) {
+        const root = String(projectRoot || "").trim();
+        this.projectRoot = root || null;
+    }
+    /**
+     * Generic async logger used by agent / LLM logging.
+     * Accepts `info|warn|error|debug|action` (case-insensitive).
+     */
+    async log(level, message, details) {
+        const type = this.normalizeType(level);
+        await this.emit(type, message, details);
+    }
+    info(message, details) {
+        void this.emit("info", message, details);
+    }
+    warn(message, details) {
+        void this.emit("warn", message, details);
+    }
+    error(message, details) {
+        void this.emit("error", message, details);
+    }
+    debug(message, details) {
+        void this.emit("debug", message, details);
+    }
+    action(message, details) {
+        void this.emit("action", message, details);
+    }
+    normalizeType(level) {
+        const s = String(level || "")
+            .trim()
+            .toLowerCase();
+        if (s === "warn" || s === "warning")
+            return "warn";
+        if (s === "error" || s === "err")
+            return "error";
+        if (s === "debug" || s === "trace")
+            return "debug";
+        if (s === "action")
+            return "action";
+        return "info";
+    }
+    /**
+     * 写入策略（中文）
+     * - 先写内存与控制台，再串行追加到 JSONL，避免并发写乱序。
+     */
+    async emit(type, message, details) {
+        const entry = {
+            id: this.generateId(),
+            timestamp: getTimestamp(),
+            type,
+            message: normalizeToAllowedMessageLabels(message),
+            details: normalizeLogDetails(details),
+            level: type,
+        };
+        this.logs.push(entry);
+        if (this.logs.length > this.maxInMemoryEntries) {
+            this.logs.splice(0, this.logs.length - this.maxInMemoryEntries);
+        }
+        this.printLog(entry);
+        this.writeChain = this.writeChain
+            .catch(() => { })
+            .then(() => this.saveToFile(entry))
+            .catch(() => { });
+        await this.writeChain;
+    }
+    printLog(entry) {
+        // 关键点（中文）：控制台输出不展示前置时间戳，减少聊天链路日志噪音。
+        // 时间信息仍保存在 JSONL 落盘字段 `timestamp` 中。
+        const compactBody = compactMessageForConsole(entry.message);
+        const body = colorizeMessageBracketPrefixes(compactBody);
+        const message = body;
+        switch (entry.type) {
+            case "error":
+                console.error(message);
+                break;
+            case "warn":
+                console.warn(message);
+                break;
+            case "debug":
+                if (this.logLevel === "debug") {
+                    console.log(message);
+                }
+                break;
+            case "action":
+                console.log(message);
+                break;
+            default:
+                console.log(message);
+        }
+    }
+    /**
+     * 落盘算法（中文）
+     * - 日志按自然日分片：`.downcity/logs/YYYY-MM-DD.jsonl`。
+     * - 每条日志一行 JSON，便于 grep / 流式消费。
+     */
+    async saveToFile(entry) {
+        if (!this.projectRoot)
+            return;
+        const logsDir = getLogsDirPath(this.projectRoot);
+        const date = String(entry.timestamp || "").slice(0, 10) || new Date().toISOString().slice(0, 10);
+        const logFile = path.join(logsDir, `${date}.jsonl`);
+        const logLine = JSON.stringify(entry) + "\n";
+        await fs.ensureDir(logsDir);
+        await fs.appendFile(logFile, logLine);
+    }
+    generateId() {
+        return Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
+    }
+    async saveAllLogs() {
+        await this.writeChain.catch(() => { });
+    }
+    getLogs() {
+        return this.logs;
+    }
+    getLogsByType(type) {
+        return this.logs.filter((log) => log.type === type);
+    }
+    getRecentLogs(count = 10) {
+        return this.logs.slice(-count);
+    }
+    clearLogs() {
+        this.logs = [];
+    }
+}
+export const logger = new Logger();
+/**
+ * 获取统一 logger。
+ *
+ * 说明（中文）
+ * - 当前实现是“进程级单例 logger”（落盘路径依赖 runtime root）。
+ * - 参数保留是为了兼容上层调用习惯：有些代码会传入 projectRoot / logLevel。
+ * - 若未来需要“多实例 logger”，可以在这里集中改，不影响调用方。
+ */
+export function getLogger(_projectRoot, _logLevel) {
+    return logger;
+}
+//# sourceMappingURL=Logger.js.map

package/bin/utils/logger/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../../src/utils/logger/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO/C,MAAM,UAAU,GAAG,SAAS,CAAC;AAC7B,MAAM,SAAS,GAAG,SAAS,CAAC;AAC5B,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,iBAAiB;AACxD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,MAAM;IACN,QAAQ;IACR,MAAM;IACN,WAAW;IACX,MAAM;IACN,aAAa;IACb,OAAO;CACR,CAAC,CAAC;AACH,MAAM,oBAAoB,GAA2B;IACnD,IAAI,EAAE,UAAU,EAAE,OAAO;IACzB,IAAI,EAAE,UAAU,EAAE,SAAS;IAC3B,KAAK,EAAE,UAAU,EAAE,MAAM;IACzB,KAAK,EAAE,UAAU,EAAE,OAAO;IAC1B,MAAM,EAAE,UAAU,EAAE,cAAc;IAClC,MAAM,EAAE,UAAU,EAAE,OAAO;IAC3B,IAAI,EAAE,UAAU,EAAE,SAAS;IAC3B,SAAS,EAAE,UAAU,EAAE,QAAQ;IAC/B,IAAI,EAAE,UAAU,EAAE,iBAAiB;IACnC,WAAW,EAAE,UAAU,EAAE,OAAO;IAChC,KAAK,EAAE,UAAU,EAAE,OAAO;IAC1B,IAAI,EAAE,UAAU,EAAE,OAAO;CAC1B,CAAC;AACF,MAAM,qBAAqB,GAAG;IAC5B,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,cAAc;CAC3B,CAAC;AAEF,SAAS,mBAAmB,CAAC,OAAoB;IAC/C,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,UAAU,GAAe,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC3E,2CAA2C;IAC3C,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,GAAG,kBAAkB,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;IACxD,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACvF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,GAAG,UAAU,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;IAChD,CAAC;IACD,MAAM,KAAK,GAAG,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpF,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,8BAA8B,CAAC,OAAe;IACrD,2CAA2C;IAC3C,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,KAAa,EAAE,EAAE;QAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU;aACpB,WAAW,EAAE;aACb,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aACnB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB,CAAC,OAAe;IAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,UAAU;SACtB,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;SAChE,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,+BAA+B,CAAC,OAAe;IACtD,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,WAAW,GAAkB,IAAI,CAAC;IAEtC,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACpD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,WAAW,GAAG,SAAS,CAAC;gBACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,MAAM,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC1E,eAAe,CAAC,IAAI,CAAC,IAAI,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,MAAM,CAAC;gBACrB,eAAe,CAAC,IAAI,CAAC,UAAU,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,0BAA0B;YAC1B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACpD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AA4BD;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IACT,IAAI,GAAe,EAAE,CAAC;IACtB,QAAQ,GAAW,MAAM,CAAC;IAC1B,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,kBAAkB,GAAG,IAAI,CAAC;IACnC,WAAW,GAAkB,IAAI,CAAC;IAE1C,YAAY,WAAmB,MAAM;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,WAAmB;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,IAAI,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CACP,KAAa,EACb,OAAe,EACf,OAAoB;QAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAoB;QACxC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAoB;QACzC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,OAAoB;QAC1C,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEO,aAAa,CAAC,KAAa;QACjC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;aAC1B,IAAI,EAAE;aACN,WAAW,EAAE,CAAC;QACjB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACnD,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,OAAO,CAAC;QACjD,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC;QACnD,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,IAAI,CAChB,IAAsB,EACtB,OAAe,EACf,OAAoB;QAEpB,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;YACrB,SAAS,EAAE,YAAY,EAAE;YACzB,IAAI;YACJ,OAAO,EAAE,+BAA+B,CAAC,OAAO,CAAC;YACjD,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;YACrC,KAAK,EAAE,IAAI;SACZ,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAErB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU;aAC9B,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aACf,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aAClC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnB,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAEO,QAAQ,CAAC,KAAe;QAC9B,oCAAoC;QACpC,qCAAqC;QACrC,MAAM,WAAW,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC;QAErB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,OAAO;gBACV,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;oBAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;gBACD,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrB,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,UAAU,CAAC,KAAe;QACtC,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjG,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;QAEpD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAEO,UAAU;QAChB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,IAAsB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,aAAa,CAAC,QAAgB,EAAE;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,YAAqB,EAAE,SAAkB;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/bin/utils/storage/index.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "../../utils/types/Json.js";
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function saveJson(filePath: string, data: JsonValue | object): Promise<void>;
+export declare function loadJson<T>(filePath: string): Promise<T | null>;
+//# sourceMappingURL=index.d.ts.map

package/bin/utils/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/storage/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1D;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKrE"}

package/bin/utils/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,UAAU,CAAC;AAG1B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,IAAwB;IACvE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,QAAgB;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAe,CAAC;AAC7C,CAAC"}

package/bin/utils/types/Json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.d.ts","sourceRoot":"","sources":["../../../src/utils/types/Json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC"}

package/bin/utils/types/Json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.js","sourceRoot":"","sources":["../../../src/utils/types/Json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/utils/types/Template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.d.ts","sourceRoot":"","sources":["../../../src/utils/types/Template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/bin/utils/types/Template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.js","sourceRoot":"","sources":["../../../src/utils/types/Template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.7",
+  "version": "1.1.10",
   "type": "module",
   "description": "Downcity Agent 运行时 — 执行壳，通过 RPC/HTTP 调用 City 的能力",
   "main": "./bin/index.js",
@@ -23,10 +23,8 @@
     "@larksuiteoapi/node-sdk": "^1.40.0",
     "@openrouter/ai-sdk-provider": "^2.2.3",
     "ai": "^6.0.57",
-    "better-sqlite3": "^11.10.0",
     "commander": "^12.0.0",
     "dotenv": "^16.4.0",
-    "drizzle-orm": "^0.36.4",
     "execa": "^9.5.0",
     "fs-extra": "^11.2.0",
     "hono": "^4.0.0",
@@ -36,7 +34,6 @@
     "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",
@@ -46,8 +43,8 @@
     "typescript": "^5.7.0"
   },
   "scripts": {
-    "build": "rm -rf bin tsconfig.tsbuildinfo && tsc && tsc-alias -f && node scripts/copy-prompt-assets.mjs",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit"
+    "build": "node scripts/agent-compiler.mjs build",
+    "dev": "node scripts/agent-compiler.mjs dev",
+    "typecheck": "node scripts/agent-compiler.mjs typecheck"
   }
 }

package/scripts/agent-compiler.mjs

@@ -0,0 +1,253 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+/**
+ * Agent compiler：统一处理 text module 生成、build、typecheck 与 dev watch。
+ *
+ * 关键点（中文）
+ * - `*.ts.txt` 是 prompt 文本源码；生成后得到同路径的 `*.ts` 模块。
+ * - runtime / bundler 只依赖生成后的 TS 模块，不再读取文本文件。
+ * - build / typecheck / dev 全部收敛到一个脚本入口，减少流程分叉。
+ */
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.resolve(__dirname, "..");
+const srcRoot = path.join(packageRoot, "src");
+const generatedHeader = [
+  "/**",
+  " * 自动生成文件，请勿手改。",
+  " * 源文件：由同路径 `*.ts.txt` 生成。",
+  " */",
+  "",
+].join("\n");
+
+function toPosixRelative(filePath) {
+  return path.relative(packageRoot, filePath).split(path.sep).join("/");
+}
+
+async function collectTextModuleSources(rootDir) {
+  const out = [];
+
+  async function walk(currentDir) {
+    const entries = await fsp.readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const absPath = path.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        await walk(absPath);
+        continue;
+      }
+      if (entry.isFile() && absPath.endsWith(".ts.txt")) {
+        out.push(absPath);
+      }
+    }
+  }
+
+  await walk(rootDir);
+  return out.sort();
+}
+
+function renderGeneratedTextModule(params) {
+  const { sourcePath, rawText } = params;
+  return [
+    generatedHeader,
+    `// Source: ${toPosixRelative(sourcePath)}`,
+    `const TEXT_MODULE_CONTENT = ${JSON.stringify(rawText)};`,
+    "",
+    "export default TEXT_MODULE_CONTENT;",
+    "",
+  ].join("\n");
+}
+
+async function writeGeneratedModule(sourcePath) {
+  const targetPath = sourcePath.slice(0, -4);
+  const rawText = await fsp.readFile(sourcePath, "utf-8");
+  const rendered = renderGeneratedTextModule({
+    sourcePath,
+    rawText,
+  });
+  await fsp.mkdir(path.dirname(targetPath), { recursive: true });
+  const previous = await fsp.readFile(targetPath, "utf-8").catch(() => null);
+  if (previous === rendered) return false;
+  await fsp.writeFile(targetPath, rendered, "utf-8");
+  return true;
+}
+
+async function generateTextModules() {
+  const sourceFiles = await collectTextModuleSources(srcRoot);
+  let updatedCount = 0;
+  for (const sourcePath of sourceFiles) {
+    const changed = await writeGeneratedModule(sourcePath);
+    if (changed) updatedCount += 1;
+  }
+  return {
+    sourceCount: sourceFiles.length,
+    updatedCount,
+  };
+}
+
+function spawnCommand(command, args, options = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      cwd: packageRoot,
+      stdio: "inherit",
+      env: process.env,
+      ...options,
+    });
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      if (signal) {
+        reject(new Error(`${command} exited with signal ${signal}`));
+        return;
+      }
+      if (code !== 0) {
+        reject(new Error(`${command} exited with code ${String(code)}`));
+        return;
+      }
+      resolve();
+    });
+  });
+}
+
+async function runBuild() {
+  await generateTextModules();
+  await spawnCommand("rm", ["-rf", "bin", "tsconfig.tsbuildinfo"]);
+  await spawnCommand("tsc", []);
+  await spawnCommand("tsc-alias", ["-f"]);
+}
+
+async function runTypecheck() {
+  await generateTextModules();
+  await spawnCommand("tsc", ["--noEmit"]);
+}
+
+async function runDev() {
+  await generateTextModules();
+
+  const watchers = [];
+  const watchedDirs = new Set();
+  let regenerateTimer = null;
+  let generating = Promise.resolve();
+  let rerunRequested = false;
+
+  async function collectDirectories(rootDir) {
+    const directories = [];
+    async function walk(currentDir) {
+      directories.push(currentDir);
+      const entries = await fsp.readdir(currentDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        await walk(path.join(currentDir, entry.name));
+      }
+    }
+    await walk(rootDir);
+    return directories;
+  }
+
+  async function attachWatchers() {
+    const directories = await collectDirectories(srcRoot);
+    for (const dirPath of directories) {
+      if (watchedDirs.has(dirPath)) continue;
+      const watcher = fs.watch(dirPath, (_eventType, filename) => {
+        const normalized = filename
+          ? Buffer.isBuffer(filename)
+            ? filename.toString("utf-8")
+            : String(filename)
+          : "";
+        if (!normalized.endsWith(".ts.txt")) return;
+        scheduleGenerate();
+      });
+      watchers.push(watcher);
+      watchedDirs.add(dirPath);
+    }
+  }
+
+  async function regenerate() {
+    try {
+      const result = await generateTextModules();
+      if (result.updatedCount > 0) {
+        console.log(
+          `[agent-compiler] regenerated ${String(result.updatedCount)} of ${String(result.sourceCount)} text module(s)`,
+        );
+      }
+      await attachWatchers();
+    } catch (error) {
+      console.error("[agent-compiler] regenerate failed");
+      console.error(error);
+    }
+  }
+
+  function runRegenerateQueue() {
+    generating = generating.finally(async () => {
+      await regenerate();
+      if (!rerunRequested) return;
+      rerunRequested = false;
+      runRegenerateQueue();
+    });
+  }
+
+  function scheduleGenerate() {
+    if (regenerateTimer) clearTimeout(regenerateTimer);
+    regenerateTimer = setTimeout(() => {
+      regenerateTimer = null;
+      if (generating && generating !== Promise.resolve()) {
+        rerunRequested = true;
+      }
+      runRegenerateQueue();
+    }, 120);
+  }
+
+  await attachWatchers();
+  const tscWatch = spawn("tsc", ["--watch"], {
+    cwd: packageRoot,
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  const shutdown = () => {
+    for (const watcher of watchers) watcher.close();
+    if (!tscWatch.killed) {
+      tscWatch.kill("SIGINT");
+    }
+  };
+
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+
+  await new Promise((resolve, reject) => {
+    tscWatch.on("error", reject);
+    tscWatch.on("exit", (code, signal) => {
+      shutdown();
+      if (signal && signal !== "SIGINT" && signal !== "SIGTERM") {
+        reject(new Error(`tsc --watch exited with signal ${signal}`));
+        return;
+      }
+      if (code && code !== 0) {
+        reject(new Error(`tsc --watch exited with code ${String(code)}`));
+        return;
+      }
+      resolve();
+    });
+  });
+}
+
+const mode = String(process.argv[2] || "build").trim().toLowerCase();
+
+if (mode === "build") {
+  await runBuild();
+} else if (mode === "typecheck") {
+  await runTypecheck();
+} else if (mode === "dev") {
+  await runDev();
+} else if (mode === "generate") {
+  const result = await generateTextModules();
+  console.log(
+    `[agent-compiler] generated ${String(result.sourceCount)} text module(s), updated ${String(result.updatedCount)}`,
+  );
+} else {
+  console.error(`Unknown mode: ${mode}`);
+  process.exit(1);
+}

package/src/agent/AgentContext.ts

@@ -13,15 +13,15 @@ import type {
   InvokeServicePort,
   SessionCollectionPort,
 } from "@/agent/AgentContextTypes.js";
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 import type {
   PluginAvailability,
   PluginPort,
   PluginView,
-} from "@/shared/types/Plugin.js";
+} from "@/plugin/types/Plugin.js";
 import type { AgentRuntime } from "@/agent/AgentRuntimeTypes.js";
 import { runServiceCommand } from "@/service/core/Manager.js";
-import { getPluginManager } from "@/plugin/PluginManager.js";
+import { getPluginManager } from "@/plugin/core/PluginManager.js";
 import { getAgentRuntime } from "@/agent/AgentRuntimeState.js";
 import { appendExecSessionMessage } from "@/service/builtins/chat/runtime/ChatIngressStore.js";
 import { readChatMetaBySessionId } from "@/service/builtins/chat/runtime/ChatMetaStore.js";
@@ -160,6 +160,7 @@ export function createAgentContext(input: AgentRuntime): AgentContext {
     systems: input.systems,
     paths: input.paths,
     pluginConfig: input.pluginConfig,
+    platform: input.platform,
     session: buildSessionPort(input),
     invoke: serviceInvokePort,
     chat: buildChatPort(() => context),