downcity 1.0.6 → 1.0.292

package/README.md

@@ -1,130 +1,48 @@
-# 🏰 DownCity
+# downcity
 
-> _"在数字世界的城市中，每个 AI 都是一位英雄"_
-
-一个基于游戏化思维设计的 AI 智能体框架，让 AI 开发变得像 RPG 冒险一样有趣！
-
-## 🚀 安装
+## download
 
 ```bash
-npm install downcity
+npm i -g downcity
 ```
 
-## 🎮 快速开始
-
-### 创造你的第一个英雄
-
-```ts
-// 创建一个provider
-const provider = createOpenAI({
-  apiKey: process.env.API_KEY,
-  baseURL: process.env.BASE_URL,
-});
+## quick start
 
-// 一个model chat
-const model = provider.chat("deepseek-v3.1");
-
-// 创建一个hero
-const hero = Hero.create().avatar("我是一个新的英雄").model(model);
-
-const res = await hero.chat("hello, 你好👋");
-console.log(`hero:${res}`);
-```
-
-## 使用工具
-
-```typescript
-const tools: Record<string, Tool> = {
-  // ai-sdk 的 tool
-  get_current_time: tool({}),
-};
-
-hero.study(tools);
-const res = await hero.chat("现在几点了？");
-console.log(`hero:${res}`);
+```bash
+city start
+cd /path/to/your-repo
+city agent create .
+city agent start
 ```
 
-# Session 与 Memory
-
-Memory 是 Session 的管理器。维护 hero/agent 的会话。
-
-Hero 实例中会维护一个 Session 对象。
+## troubleshooting
 
-当 hero 操作 session 的时候， memory 中会操作 session。
+### zsh: permission denied: downcity
 
-## Session
+这不是 `sudo` / 系统管理员权限问题，通常是因为 `pnpm` 的 `.bin/downcity` 可能是软链到实际入口文件（例如 `.../downcity/bin/console/commands/Index.js`），而目标文件缺少可执行位（`+x`）。
 
-## Memory
-
-当不使用 memory 的时候。
-
-```typescript
-const hero = Hero.create().avatar("你是一个英雄").model(model);
-const old_id = hero.session.id;
-// hero实例中的 _session 是一个当前的session.
-const res = await hero.chat("你好, 我叫wangenius");
-console.log(`hero:${res}`);
-// 新建对话并且切换到新会话。 原来的会话放到的 memory 中管理。 renew 返回新建的会话id。
-const id = hero.renew();
-const res = await hero.chat("我叫什么？");
-console.log(`hero:${res}`); // hero并不知道我叫什么，因为不知道。
-
-// 切换到原来的会话中 hero 将 memory 中的对应的id 的session 放到了 hero._session 中。
-hero.switch(old_id);
-const res = await hero.chat("我叫什么？");
-console.log(`hero:${res}`); // hero 知道我叫 wangenius。
-```
-
-以上使用， hero 实例中活创建默认的 `new Memory()`， 此时 Memory 的所有 session 都在内存中维护。
-
-且当某个 hero 的实例中的 session 更新后，同步会更新到 memory 中。 但是注意： memory 中更新后，并不会更新到当前使用这个 session 的实例。
-
-```ts
-hero.memory(new Memory());
-```
+```bash
+# 本地依赖安装（仓库内）
+chmod +x node_modules/downcity/bin/console/commands/Index.js
 
-以上是等价的。
-
-```ts
-// 切换会话
-hero.switch("会话id");
-// 新建会话并切换到新会话
-hero.renew();
-// 会话列表
-hero.sessions();
-// 删除列表
-hero.remove("会话id");
-// 清除所有会话
-hero.clear();
+# 或者直接用 node 执行（不依赖可执行位）
+node node_modules/downcity/bin/console/commands/Index.js agent start .
 ```
 
-memory 可以在多个 hero 之间使用:
+## access
 
-```ts
-const memory = new Memory();
-const hero1 = Hero.create().memory(memory);
-const hero2 = Hero.create().memory(memory);
-```
+```http
+GET http://localhost:3000/health
+GET http://localhost:3000/api/status
 
-```ts
-const memory1 = new Memory();
-const hero1 = Hero.create().memory(memory1);
+POST http://localhost:3000/api/execute
+Content-Type: application/json
 
-const memory2 = new Memory();
-const hero2 = Hero.create().memory(memory2);
+{"instructions":"Say hi"}
 ```
 
-持久化存储。
-
-```typescript
-const persistor = new LibPersistor({
-  filePath: "./memory.db",
-});
-
-const memory = new Memory(persistor);
-hero.memory(memory);
-```
+## debug
 
-当持久化存储的时候， 会将 session 存储到对应的持久化数据库中。
+By default the runtime logs every LLM request payload (messages + system) to help debugging.
 
-此时 Memory 不会提前加载所有的数据库中的 session。 只会打开对应的 session 到内存中。 并且超过 20 个的时候，会关掉之前的。
+- 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":"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"}

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"}