downcity 1.0.7 → 1.0.322

package/README.md

@@ -0,0 +1,48 @@
+# downcity
+
+## download
+
+```bash
+npm i -g downcity
+```
+
+## quick start
+
+```bash
+city start
+cd /path/to/your-repo
+city agent create .
+city agent start
+```
+
+## troubleshooting
+
+### zsh: permission denied: downcity
+
+这不是 `sudo` / 系统管理员权限问题，通常是因为 `pnpm` 的 `.bin/downcity` 可能是软链到实际入口文件（例如 `.../downcity/bin/console/commands/Index.js`），而目标文件缺少可执行位（`+x`）。
+
+```bash
+# 本地依赖安装（仓库内）
+chmod +x node_modules/downcity/bin/console/commands/Index.js
+
+# 或者直接用 node 执行（不依赖可执行位）
+node node_modules/downcity/bin/console/commands/Index.js agent start .
+```
+
+## access
+
+```http
+GET http://localhost:3000/health
+GET http://localhost:3000/api/status
+
+POST http://localhost:3000/api/execute
+Content-Type: application/json
+
+{"instructions":"Say hi"}
+```
+
+## debug
+
+By default the runtime logs every LLM request payload (messages + system) to help debugging.
+
+- Disable: set `llm.logMessages=false` in `ship.json`

package/bin/agent/Agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/agent/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,IAAI,CAAC;AACZ,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAO3E,OAAO,KAAK,EAEV,WAAW,EACX,aAAa,EACd,MAAM,uBAAuB,CAAC;AAa/B;;GAEG;AACH,KAAK,YAAY,GAAG;IAClB,cAAc;IACd,KAAK,EAAE,aAAa,CAAC;IAErB,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,iBAAiB;IACjB,SAAS,EAAE,kBAAkB,CAAC;IAE9B,gBAAgB;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAE9B,iBAAiB;IACjB,YAAY,EAAE,qBAAqB,CAAC;IAEpC,uBAAuB;IACvB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAK;IAChB,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IAErD,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,kCAAkC;IAClC,OAAO,CAAC,SAAS,CAAS;IAE1B,2BAA2B;IAC3B,OAAO,CAAC,UAAU,CAAK;IAEvB;;OAEG;gBACS,OAAO,EAAE,YAAY;IAoBjC;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBrD;;;;;;;;OAQG;YACW,YAAY;IAoD1B;;;;;;;OAOG;YACW,mBAAmB;IAmDjC;;;;;;OAMG;YACW,kBAAkB;IA+HhC;;;;;;OAMG;YACW,4BAA4B;IAyC1C;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/bin/agent/Agent.js

@@ -0,0 +1,347 @@
+/**
+ * Agent：最小执行层。
+ *
+ * 关键点（中文）
+ * - 这个类只做“流程编排”，不承载业务策略。
+ * - 业务策略由组件实现（Orchestrator / Prompter / Persistor / Compactor）。
+ * - 本文件追求“看注释即可理解执行路径”。
+ *
+ * 主流程（中文）
+ * 1) `run`：入口，做并发保护与状态初始化。
+ * 2) `runWithRetry`：做“可压缩错误”的重试。
+ * 3) `prepareExecuteInput`：从各组件装配 system/tools/messages。
+ * 4) `executePreparedRun`：执行 streamText tool-loop。
+ * 5) `collectFinalAssistantMessage`：收敛最终 assistant 消息。
+ */
+import { streamText, stepCountIs } from "ai";
+import { buildOpenAIResponsesProviderOptions, logAssistantMessageNow, pickMergedUserMessages, toModelMessages, } from "./helpers/AgentHelpers.js";
+/**
+ * 可压缩错误的最大重试次数。
+ */
+const MAX_COMPACTION_RETRY_ATTEMPTS = 3;
+/**
+ * 单次 tool-loop 允许的最大 step 数。
+ */
+const MAX_TOOL_LOOP_STEPS = 64;
+/**
+ * Agent 主类。
+ */
+export class Agent {
+    /** 模型实例：用于真正执行 streamText。 */
+    model;
+    /** 日志实例：用于输出运行过程与错误。 */
+    logger;
+    /** 持久化组件：用于读写会话消息。 */
+    persistor;
+    /** 压缩组件：用于在上下文过长前执行 compact。 */
+    compactor;
+    /** 编排组件：用于提供 tools 与 step 回调。 */
+    orchestrator;
+    /** system 组件：用于解析 system messages。 */
+    prompter;
+    /** 运行互斥锁：防止同一个 Agent 实例并发 run。 */
+    isRunning = false;
+    /** context-length 重试计数。 */
+    retryCount = 0;
+    /**
+     * 构造函数。
+     */
+    constructor(options) {
+        // 注入模型。
+        this.model = options.model;
+        // 注入日志。
+        this.logger = options.logger;
+        // 注入持久化组件。
+        this.persistor = options.persistor;
+        // 注入压缩组件。
+        this.compactor = options.compactor;
+        // 注入编排组件。
+        this.orchestrator = options.orchestrator;
+        // 注入 system 组件。
+        this.prompter = options.prompter;
+    }
+    /**
+     * 执行一次 Agent run。
+     *
+     * 关键点（中文）
+     * - 这里只做入口控制，不直接做模型调用。
+     * - 保证同实例串行运行，避免 `retryCount` 等状态串线。
+     */
+    async run(input) {
+        // 如果当前实例已经在运行，则直接拒绝并发调用。
+        if (this.isRunning) {
+            throw new Error("Agent.run does not support concurrent execution");
+        }
+        // 标记运行中。
+        this.isRunning = true;
+        // 每次新 run 先清理状态。
+        this.resetRunState();
+        try {
+            // 真正执行带重试的 run。
+            return await this.runWithRetry(input);
+        }
+        finally {
+            // 无论成功失败都清理状态，避免污染下一轮。
+            this.resetRunState();
+            // 释放运行锁。
+            this.isRunning = false;
+        }
+    }
+    /**
+     * 执行一次 Agent run（带可压缩错误重试）。
+     *
+     * 关键点（中文）
+     * - 正常：准备输入 -> 执行。
+     * - 异常：
+     *   - 可压缩错误：压缩重试（是否可压缩由 compactor 决定）。
+     *   - 其他错误：返回失败消息。
+     */
+    async runWithRetry(input) {
+        try {
+            // 清理并规整 query，避免把 undefined/null 传入后续组件。
+            const query = String(input.query || "").trim();
+            // 组装本轮运行所需输入（system/messages/tools）。
+            const prepared = await this.prepareExecuteInput(query);
+            // 执行组装好的运行输入。
+            return await this.executePreparedRun(prepared);
+        }
+        catch (error) {
+            // 是否应压缩重试由 compactor 决策，Agent 只消费布尔结果。
+            if (this.compactor.shouldCompactOnError(error)) {
+                // 记录压缩重试日志，便于观测问题频率。
+                await this.logger.log("info", "[agent] compacting", {
+                    retryCount: this.retryCount,
+                    error: String(error),
+                });
+                // 若未超过上限，则增加计数并递归重试。
+                if (this.retryCount < MAX_COMPACTION_RETRY_ATTEMPTS) {
+                    this.retryCount += 1;
+                    return this.runWithRetry(input);
+                }
+                // 达到上限后返回可读失败消息，避免死循环。
+                return {
+                    success: false,
+                    assistantMessage: this.orchestrator.buildFallbackAssistantMessage("Context length exceeded and retries failed. Please resend your question."),
+                };
+            }
+            // 非“可压缩错误”走统一失败返回。
+            const errorMsg = String(error);
+            // 记录错误日志。
+            await this.logger.log("error", "Agent execution failed", {
+                error: errorMsg,
+            });
+            // 返回失败 assistant 消息。
+            return {
+                success: false,
+                assistantMessage: this.orchestrator.buildFallbackAssistantMessage(`Execution failed: ${errorMsg}`),
+            };
+        }
+    }
+    /**
+     * 调用核心组件组装当前轮执行输入。
+     *
+     * 关键点（中文）
+     * - orchestrator 提供 tools 与运行上下文。
+     * - system 提供本轮 system messages。
+     * - compactor 先尝试压缩，再由 persistor 产出消息基线。
+     */
+    async prepareExecuteInput(query) {
+        // 基础安全检查：persistor 必须携带 contextId。
+        if (!String(this.persistor.contextId || "").trim()) {
+            throw new Error("Agent.run requires persistor.contextId");
+        }
+        // 让 orchestrator 组装运行上下文（例如 tools 与 request 作用域）。
+        const runContext = await this.orchestrator.compose();
+        // 拿到本轮工具集合。
+        const tools = runContext.tools;
+        // 解析本轮 system messages。
+        const system = await this.prompter.resolve();
+        try {
+            // 只有在重试场景下才记录额外 compacting 日志。
+            if (this.retryCount > 0) {
+                await this.logger.log("info", "[agent] compacting", {
+                    retryCount: this.retryCount,
+                });
+            }
+            // 尝试执行压缩（best-effort，失败不阻断主流程）。
+            await this.compactor.run({
+                persistor: this.persistor,
+                model: this.model,
+                system,
+                retryCount: this.retryCount,
+            });
+        }
+        catch {
+            // 压缩失败忽略，继续使用当前历史消息执行。
+        }
+        // 让 persistor 按当前 query/system/tools 生成消息基线。
+        const messages = await this.persistor.prepare({
+            query,
+            tools,
+            system,
+            model: this.model,
+            retryCount: this.retryCount,
+        });
+        // 返回最终可执行输入。
+        return {
+            system,
+            messages,
+            tools,
+        };
+    }
+    /**
+     * 执行一次已装配完成的运行材料。
+     *
+     * 关键点（中文）
+     * - 这里只关心执行，不关心 request/context 参数怎么来的。
+     * - 增量并入逻辑用来支持 step 间新增 user 消息。
+     */
+    async executePreparedRun(input) {
+        // 记录开始时间，用于 finish 日志。
+        const startTime = Date.now();
+        // 防御性兜底：确保 system 至少是数组。
+        const system = Array.isArray(input.system) ? input.system : [];
+        // 工具集合直接透传。
+        const tools = input.tools;
+        try {
+            // 核心步骤 1（中文）：把 context messages 转成模型输入消息。
+            let baseContextMessages = Array.isArray(input.messages)
+                ? [...input.messages]
+                : [];
+            // 根据当前基线消息生成模型消息。
+            let baseModelMessages = await toModelMessages(baseContextMessages, tools);
+            // 核心步骤 2（中文）：定义“step 间新增 user 消息并入器”。
+            const appendMergedUserMessages = async (messages) => {
+                // 子步骤 A（中文）：过滤出有效 user 文本消息。
+                const mergedMessages = pickMergedUserMessages(messages);
+                // 如果没有可并入消息，直接返回空增量。
+                if (mergedMessages.length === 0)
+                    return [];
+                // 子步骤 B（中文）：更新 context 基线，保证后续全量重算时可见这些新增消息。
+                baseContextMessages = [...baseContextMessages, ...mergedMessages];
+                // 先尝试只转换新增消息，减少重复计算。
+                const mergedModelMessages = await toModelMessages(mergedMessages, tools);
+                // 如果增量转换成功，直接追加并返回增量。
+                if (mergedModelMessages.length > 0) {
+                    baseModelMessages = [...baseModelMessages, ...mergedModelMessages];
+                    return mergedModelMessages;
+                }
+                // 子步骤 C（中文）：增量不可用时回退为全量重算，保证一致性。
+                baseModelMessages = await toModelMessages(baseContextMessages, tools);
+                // 返回空，表示本次 prepareStep 不注入增量片段。
+                return [];
+            };
+            // 从 orchestrator 获取 step 完成回调（用于中间输出处理）。
+            const onStepFinish = this.orchestrator.createOnStepFinishHandler();
+            // 从 orchestrator 获取 step 准备回调（用于 step 间消息并入）。
+            const prepareStep = this.orchestrator.createPrepareStepHandler({
+                system,
+                appendMergedUserMessages,
+            });
+            // 核心步骤 3（中文）：启动 streamText 工具循环。
+            const result = streamText({
+                // 指定模型。
+                model: this.model,
+                // 指定 system。
+                system,
+                // 注入 step 完成钩子。
+                onStepFinish,
+                // 注入 step 准备钩子。
+                prepareStep,
+                // 注入消息基线。
+                messages: baseModelMessages,
+                // 注入工具集。
+                tools,
+                // 注入 provider 选项。
+                providerOptions: buildOpenAIResponsesProviderOptions(),
+                // 限制最大 step 数，避免无界循环。
+                stopWhen: [stepCountIs(MAX_TOOL_LOOP_STEPS)],
+            });
+            // 核心步骤 4（中文）：收敛最终 assistant 消息。
+            const finalAssistantUiMessage = await this.collectFinalAssistantMessage({
+                result,
+            });
+            // 输出 assistant 文本日志。
+            await logAssistantMessageNow(this.logger, finalAssistantUiMessage);
+            // 计算耗时。
+            const duration = Date.now() - startTime;
+            // 写入 finish 日志。
+            await this.logger.log("info", "[agent] finish", {
+                duration,
+            });
+            // 返回成功结果。
+            return {
+                success: true,
+                assistantMessage: finalAssistantUiMessage,
+            };
+        }
+        catch (error) {
+            // 可压缩错误上抛，让上层 runWithRetry 统一处理重试。
+            if (this.compactor.shouldCompactOnError(error)) {
+                throw error;
+            }
+            // 非“可压缩错误”转为失败结果。
+            const errorMsg = String(error);
+            // 记录错误日志。
+            await this.logger.log("error", "Agent execution failed", {
+                error: errorMsg,
+            });
+            // 返回失败消息。
+            return {
+                success: false,
+                assistantMessage: this.orchestrator.buildFallbackAssistantMessage(`Execution failed: ${errorMsg}`),
+            };
+        }
+    }
+    /**
+     * 消费 UI stream 并解析最终 assistant 消息。
+     *
+     * 关键点（中文）
+     * - 优先取 UI stream 的结构化 responseMessage。
+     * - 取不到时回退到 `result.text` 生成文本消息。
+     */
+    async collectFinalAssistantMessage(params) {
+        // 用于接收 onFinish 传出的结构化 assistant 消息。
+        let streamedAssistantMessage = null;
+        // 创建 UI message stream。
+        const uiStream = params.result.toUIMessageStream({
+            // 不发送 reasoning 片段。
+            sendReasoning: false,
+            // 不发送来源片段。
+            sendSources: false,
+            // 在 finish 时收敛最终 responseMessage。
+            onFinish: (event) => {
+                streamedAssistantMessage = event.responseMessage ?? null;
+            },
+        });
+        // 必须完整消费 stream，确保 onFinish 被触发。
+        for await (const _ of uiStream) {
+            // 此处只为驱动流消费，不处理 chunk。
+        }
+        // 如果拿到结构化消息，直接返回。
+        if (streamedAssistantMessage)
+            return streamedAssistantMessage;
+        // 回退路径：尝试读取纯文本结果。
+        let assistantText = "";
+        try {
+            assistantText = String((await params.result.text) ?? "").trim();
+        }
+        catch {
+            // 读取文本失败时保持空串。
+            assistantText = "";
+        }
+        // 用回退文本构造标准 assistant 消息并返回。
+        return this.orchestrator.buildFallbackAssistantMessage(assistantText || "Execution completed");
+    }
+    /**
+     * 重置当前 run 状态。
+     *
+     * 关键点（中文）
+     * - 统一收口 run 级状态，避免散落在多个位置。
+     */
+    resetRunState() {
+        // 当前仅维护 retryCount，重置为 0。
+        this.retryCount = 0;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/bin/agent/Agent.js.map

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

package/bin/agent/components/AgentComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentComponent.d.ts","sourceRoot":"","sources":["../../../src/agent/components/AgentComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,8BAAsB,cAAc;IAClC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/bin/agent/components/AgentComponent.js

@@ -0,0 +1,29 @@
+/**
+ * AgentComponent：Agent 能力组件基类。
+ *
+ * 关键点（中文）
+ * - 仅定义最小公共生命周期能力，避免演化为“万能基类”。
+ * - 业务行为由子类自行定义（Persistor/Compactor/Orchestrator/Prompter）。
+ */
+export class AgentComponent {
+    /**
+     * 可选初始化钩子。
+     *
+     * 关键点（中文）
+     * - Agent/Runtime 启动时可统一调用。
+     * - 无需初始化的组件可不实现。
+     */
+    async init() {
+        // no-op
+    }
+    /**
+     * 可选释放钩子。
+     *
+     * 关键点（中文）
+     * - Runtime 关停时统一释放资源（连接、句柄、缓存等）。
+     */
+    async dispose() {
+        // no-op
+    }
+}
+//# sourceMappingURL=AgentComponent.js.map

package/bin/agent/components/AgentComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentComponent.js","sourceRoot":"","sources":["../../../src/agent/components/AgentComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAgB,cAAc;IAMlC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI;QACR,QAAQ;IACV,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACX,QAAQ;IACV,CAAC;CACF"}

package/bin/agent/components/CompactorComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactorComponent.d.ts","sourceRoot":"","sources":["../../../src/agent/components/CompactorComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,8BAAsB,kBAAmB,SAAQ,cAAc;IAC7D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAC9C,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAMvD"}

package/bin/agent/components/CompactorComponent.js

@@ -0,0 +1,14 @@
+/**
+ * CompactorComponent：上下文压缩组件抽象。
+ *
+ * 关键点（中文）
+ * - 负责“何时压缩 + 压缩策略参数”决策。
+ * - 具体读写由 Persistor 执行（Compactor 不直接落盘）。
+ */
+import { AgentComponent } from "./AgentComponent.js";
+/**
+ * Compactor 组件抽象类。
+ */
+export class CompactorComponent extends AgentComponent {
+}
+//# sourceMappingURL=CompactorComponent.js.map

package/bin/agent/components/CompactorComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompactorComponent.js","sourceRoot":"","sources":["../../../src/agent/components/CompactorComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4BrD;;GAEG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,cAAc;CA2B9D"}

package/bin/agent/components/OrchestratorComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorComponent.d.ts","sourceRoot":"","sources":["../../../src/agent/components/OrchestratorComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,8BAAsB,qBAAsB,SAAQ,cAAc;IAChE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,wBAAwB,CAC/B,KAAK,EAAE;QACL;;WAEG;QACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B;;WAEG;QACH,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC9B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,yBAAyB,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC;IAE5E;;;;;OAKG;IACH,QAAQ,CAAC,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;CACvE"}

package/bin/agent/components/OrchestratorComponent.js

@@ -0,0 +1,14 @@
+/**
+ * OrchestratorComponent：单次 Agent run 编排组件抽象。
+ *
+ * 关键点（中文）
+ * - 负责 requestId/tools/onStepCallback 等运行时编排。
+ * - 不负责历史读写，不负责 system 解析，不负责 compact。
+ */
+import { AgentComponent } from "./AgentComponent.js";
+/**
+ * Orchestrator 组件抽象类。
+ */
+export class OrchestratorComponent extends AgentComponent {
+}
+//# sourceMappingURL=OrchestratorComponent.js.map

package/bin/agent/components/OrchestratorComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorComponent.js","sourceRoot":"","sources":["../../../src/agent/components/OrchestratorComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAYrD;;GAEG;AACH,MAAM,OAAgB,qBAAsB,SAAQ,cAAc;CA4CjE"}

package/bin/agent/components/PersistorComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistorComponent.d.ts","sourceRoot":"","sources":["../../../src/agent/components/PersistorComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,8BAAsB,kBAAmB,SAAQ,cAAc;IAC7D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE3E;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;QACtD,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAEvE;;OAEG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE;QACvB;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,GAAG,IAAI,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;QAEzC;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,gBAAgB;IAEpB;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE;QAC5B;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,GAAG,IAAI,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;QAEzC;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAE5B;;WAEG;QACH,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;KAC/B,GAAG,gBAAgB;CAMrB"}

package/bin/agent/components/PersistorComponent.js

@@ -0,0 +1,14 @@
+/**
+ * PersistorComponent：会话历史持久化组件抽象。
+ *
+ * 关键点（中文）
+ * - 负责“历史读写 + 运行输入准备 + 文本消息工厂”。
+ * - 不负责模型调用，不负责执行编排。
+ */
+import { AgentComponent } from "./AgentComponent.js";
+/**
+ * Persistor 组件抽象类。
+ */
+export class PersistorComponent extends AgentComponent {
+}
+//# sourceMappingURL=PersistorComponent.js.map

package/bin/agent/components/PersistorComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistorComponent.js","sourceRoot":"","sources":["../../../src/agent/components/PersistorComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuErD;;GAEG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,cAAc;CAyG9D"}

package/bin/agent/components/PrompterComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrompterComponent.d.ts","sourceRoot":"","sources":["../../../src/agent/components/PrompterComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,8BAAsB,iBAAkB,SAAQ,cAAc;IAC5D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAClD"}

package/bin/agent/components/PrompterComponent.js

@@ -0,0 +1,14 @@
+/**
+ * PrompterComponent：system 管理组件抽象。
+ *
+ * 关键点（中文）
+ * - 专职负责“会话上下文 -> system messages”解析。
+ * - 与 tools/requestId/onStep 编排解耦，避免 Orchestrator 过重。
+ */
+import { AgentComponent } from "./AgentComponent.js";
+/**
+ * Prompter 组件抽象类。
+ */
+export class PrompterComponent extends AgentComponent {
+}
+//# sourceMappingURL=PrompterComponent.js.map

package/bin/agent/components/PrompterComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrompterComponent.js","sourceRoot":"","sources":["../../../src/agent/components/PrompterComponent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,cAAc;CAU7D"}

package/bin/agent/context/context-agent/ContextAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextAgent.d.ts","sourceRoot":"","sources":["../../../../src/agent/context/context-agent/ContextAgent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAExE,KAAK,mBAAmB,GAAG;IACzB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAC;IAE9B;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,OAAO,EAAE,mBAAmB;IAcxC;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;CAGtD"}

package/bin/agent/context/context-agent/ContextAgent.js

@@ -0,0 +1,35 @@
+/**
+ * ContextAgent：Context 场景运行装配器。
+ *
+ * 关键点（中文）
+ * - 负责在当前 `contextId` 作用域内装配 Agent 所需核心组件。
+ * - 具体 run loop 仍由 `agent/Agent` 执行。
+ */
+import { Agent } from "../../Agent.js";
+import { RuntimeOrchestrator } from "../../context/context-agent/components/RuntimeOrchestrator.js";
+/**
+ * ContextAgent 默认实现。
+ */
+export class ContextAgent {
+    agent;
+    constructor(options) {
+        this.agent = new Agent({
+            model: options.model,
+            logger: options.logger,
+            persistor: options.persistor,
+            compactor: options.compactor,
+            prompter: options.system,
+            orchestrator: new RuntimeOrchestrator({
+                contextId: options.persistor.contextId,
+                getTools: options.getTools,
+            }),
+        });
+    }
+    /**
+     * 运行当前 context 的一次请求。
+     */
+    async run(input) {
+        return await this.agent.run(input);
+    }
+}
+//# sourceMappingURL=ContextAgent.js.map

package/bin/agent/context/context-agent/ContextAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextAgent.js","sourceRoot":"","sources":["../../../../src/agent/context/context-agent/ContextAgent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAIxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAmCrG;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,CAAQ;IAE9B,YAAY,OAA4B;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC;YACrB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM;YACxB,YAAY,EAAE,IAAI,mBAAmB,CAAC;gBACpC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS;gBACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAAoB;QAC5B,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}

package/bin/agent/context/context-agent/ContextAgentDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextAgentDispatcher.d.ts","sourceRoot":"","sources":["../../../../src/agent/context/context-agent/ContextAgentDispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE5E;;GAEG;AACH,KAAK,6BAA6B,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;IAE3D;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmD;IACnF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwC;IAC1E,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAC1B;gBAEA,OAAO,EAAE,6BAA6B;IASlD;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB;IAenD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAsBzC;;OAEG;IACH,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;CAOrC"}