@whispering233/ai-editor-agent 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export declare const AGENT_PKG_NAME = "@whispering233/ai-editor-agent";
+export declare const AGENT_PKG_VERSION = "0.1.0";
+export declare const TOOLS_DEP = "@whispering233/ai-editor-tools";
+export * from "./session.js";
+export * from "./prompts.js";
+export * from "./context.js";
+export * from "./run.js";
+export * from "./executor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc,mCAAmC,CAAC;AAC/D,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,SAAS,mCAAiB,CAAC;AAExC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// @whispering233/ai-editor-agent 入口
+// S7.1 会话管理（session.ts）：历史重建 / 成对裁剪 / 喂回格式 / 末条约束——纯内存、无 I/O
+// S7.2 上下文组装（context.ts + prompts.ts）：三层提示词注入 / 聚焦注入 / 工具清单 / 分层 token 预算
+// S7.3 主循环（run.ts）：runAgent 三重保险 / 工具调度接口 ToolDispatcher / AgentEvent 事件流
+// S7.4 工具调度（executor.ts）：ToolDispatcher 真实现 / 提案内存仓（TTL + 上限 + 项目绑定）
+import { TOOLS_PKG_NAME } from "@whispering233/ai-editor-tools";
+export const AGENT_PKG_NAME = "@whispering233/ai-editor-agent";
+export const AGENT_PKG_VERSION = "0.1.0";
+export const TOOLS_DEP = TOOLS_PKG_NAME;
+export * from "./session.js";
+export * from "./prompts.js";
+export * from "./context.js";
+export * from "./run.js";
+export * from "./executor.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,6DAA6D;AAC7D,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,CAAC;AAExC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,13 @@
+/** 内核提示词（决策 7 内核层）：创作顾问角色定义 + 行为规范，代码固定不可用户编辑 */
+export declare const KERNEL_PROMPT = "\u4F60\u662F\u300C\u521B\u4F5C\u987E\u95EE\u300D\uFF0C\u4E00\u540D\u8D44\u6DF1\u5C0F\u8BF4\u521B\u4F5C\u642D\u6863\uFF0C\u670D\u52A1\u4E8E\u4F5C\u8005\u7684 AI \u5199\u4F5C\u5DE5\u4F5C\u53F0\u3002\n\u4F60\u7684\u804C\u8D23\u662F\u5E2E\u52A9\u4F5C\u8005\u5206\u6790\u5927\u7EB2\u3001\u4EBA\u7269\u3001\u5173\u7CFB\u3001\u60C5\u8282\u4E0E\u4F0F\u7B14\uFF0C\u63D0\u51FA\u53EF\u6267\u884C\u7684\u4FEE\u6539\u5EFA\u8BAE\u2014\u2014\u4F60\u662F\u5206\u6790\u987E\u95EE\uFF0C\u4E0D\u662F\u64CD\u4F5C\u5458\uFF0C\u4E5F\u4E0D\u4EE3\u5199\u6B63\u6587\u3002\n\n\u884C\u4E3A\u51C6\u5219\uFF1A\n1. \u4E0D\u751F\u6210\u6B63\u6587\uFF1A\u4E0D\u4EE3\u5199\u5C0F\u8BF4\u6B63\u6587\u6216\u7AE0\u8282\u5185\u5BB9\uFF0C\u8F93\u51FA\u59CB\u7EC8\u662F\u5206\u6790\u3001\u5EFA\u8BAE\u4E0E\u65B9\u6848\u3002\n2. \u4E0D\u76F4\u63A5\u5199\u5165\uFF1A\u7EDD\u4E0D\u76F4\u63A5\u5199\u5165\u3001\u4FEE\u6539\u6216\u5220\u9664\u4EFB\u4F55\u6570\u636E\uFF08\u5B9E\u4F53/\u5173\u7CFB/\u5927\u7EB2\u8282\u70B9/\u4F0F\u7B14/Delta\uFF09\uFF1B\u5199\u64CD\u4F5C\u4E00\u5F8B\u901A\u8FC7 propose_* \u5DE5\u5177\u751F\u6210\u63D0\u6848\uFF0C\u7531\u7528\u6237\u786E\u8BA4\u540E\u6267\u884C\u2014\u2014\u7528\u6237\u59CB\u7EC8\u662F\u6700\u7EC8\u51B3\u7B56\u8005\u3002\n3. \u67E5\u8BE2\u4E0E\u5206\u6790\u81EA\u7531\uFF1A\u53EF\u968F\u65F6\u8C03\u7528\u67E5\u8BE2\u7C7B\u4E0E\u5206\u6790\u7C7B\u5DE5\u5177\u83B7\u53D6\u6570\u636E\u3001\u8FD0\u884C\u7ED3\u6784\u5316\u5206\u6790\u3002\n4. \u7ED3\u679C\u622A\u65AD\u987B\u77E5\uFF1A\u5DE5\u5177\u7ED3\u679C\u82E5\u542B\u300C\u5DF2\u622A\u65AD\u300D\u6807\u8BB0\u5373\u6570\u636E\u4E0D\u5B8C\u6574\u2014\u2014\u8BF7\u7F29\u5C0F\u67E5\u8BE2\u8303\u56F4\u6216\u5206\u9875\u83B7\u53D6\uFF0C\u4E0D\u5F97\u57FA\u4E8E\u6B8B\u7F3A\u6570\u636E\u4E0B\u7ED3\u8BBA\u3002\n5. \u957F\u5EA6\u622A\u65AD\u987B\u77E5\uFF1A\u82E5\u4F60\u7684\u56DE\u590D\u56E0\u957F\u5EA6\u9650\u5236\u88AB\u622A\u65AD\uFF0C\u7CFB\u7EDF\u4E0D\u4F1A\u91CD\u53D1\u4F60\u7684\u534A\u6761\u56DE\u590D\uFF1B\u8BF7\u63A7\u5236\u7BC7\u5E45\uFF0C\u4F18\u5148\u7ED9\u51FA\u7ED3\u8BBA\u4E0E\u8981\u70B9\u3002\n6. \u805A\u7126\u4F18\u5148\uFF1Asystem \u6D88\u606F\u4E2D\u300C\u5F53\u524D\u805A\u7126\u300D\u6BB5\u843D\u662F\u4F5C\u8005\u6B63\u5728\u67E5\u770B\u7684\u5185\u5BB9\uFF0C\u4F18\u5148\u56F4\u7ED5\u5B83\u5C55\u5F00\u3002\n7. \u63D0\u6848\u8BED\u4E49\uFF1A\u8C03\u7528\u63D0\u6848\u5DE5\u5177\u540E\u9700\u7528\u6237\u786E\u8BA4\u624D\u751F\u6548\uFF1B\u786E\u8BA4\u524D\u4E0D\u8981\u5047\u8BBE\u4EFB\u4F55\u4FEE\u6539\u5DF2\u53D1\u751F\u3002\n8. \u56DE\u590D\u4F7F\u7528\u9879\u76EE\u914D\u7F6E\u7684\u8BED\u8A00\u3002";
+/** 项目提示词段标题（决策 7 项目层，来自 project.json 的 prompt 字段） */
+export declare const PROJECT_PROMPT_TITLE = "## \u9879\u76EE\u8BBE\u5B9A";
+/** 临时指令段标题（决策 7 临时层，即时输入、不持久化） */
+export declare const INSTRUCTION_TITLE = "## \u672C\u6B21\u6307\u4EE4";
+/** 可用工具清单段标题（name + description 一行，来自 registry listTools） */
+export declare const TOOL_LIST_TITLE = "## \u53EF\u7528\u5DE5\u5177";
+/** 聚焦上下文段标题（决策 6 聚焦层：当前视图中的实体/大纲节点，由调用方查询后传入） */
+export declare const FOCUS_TITLE = "## \u5F53\u524D\u805A\u7126";
+/** 聚焦上下文截断提示（决策 15 精神：截断必须显式告知，不得静默丢数据） */
+export declare const FOCUS_TRUNCATION_NOTICE = "\n\n[\u805A\u7126\u4E0A\u4E0B\u6587\u5DF2\u622A\u65AD\uFF1A\u8D85\u51FA token \u9884\u7B97\uFF0C\u6570\u636E\u4E0D\u5B8C\u6574\uFF1B\u8BF7\u7F29\u5C0F\u67E5\u770B\u8303\u56F4]";
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAMA,iDAAiD;AACjD,eAAO,MAAM,aAAa,oiFAWV,CAAC;AAIjB,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,gCAAY,CAAC;AAE9C,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,gCAAY,CAAC;AAE3C,6DAA6D;AAC7D,eAAO,MAAM,eAAe,gCAAY,CAAC;AAEzC,iDAAiD;AACjD,eAAO,MAAM,WAAW,gCAAY,CAAC;AAErC,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,oLAA6C,CAAC"}

package/dist/prompts.js

@@ -0,0 +1,30 @@
+// @whispering233/ai-editor-agent 提示词（S7.2）
+// 契约来源：doc/design/decisions.md 决策 7（提示词三层注入——本文件是**内核层**：
+// 开发者编辑、代码固定、不持久化）、doc/api/tools.md「核心设计原则」（AI 角色是分析顾问
+// 不是操作员、写操作走提案、截断显式告知）。
+// 项目层（用户可编辑，project.json）与临时层（即时输入）由调用方传入 context.ts 组装。
+/** 内核提示词（决策 7 内核层）：创作顾问角色定义 + 行为规范，代码固定不可用户编辑 */
+export const KERNEL_PROMPT = `你是「创作顾问」，一名资深小说创作搭档，服务于作者的 AI 写作工作台。
+你的职责是帮助作者分析大纲、人物、关系、情节与伏笔，提出可执行的修改建议——你是分析顾问，不是操作员，也不代写正文。
+
+行为准则：
+1. 不生成正文：不代写小说正文或章节内容，输出始终是分析、建议与方案。
+2. 不直接写入：绝不直接写入、修改或删除任何数据（实体/关系/大纲节点/伏笔/Delta）；写操作一律通过 propose_* 工具生成提案，由用户确认后执行——用户始终是最终决策者。
+3. 查询与分析自由：可随时调用查询类与分析类工具获取数据、运行结构化分析。
+4. 结果截断须知：工具结果若含「已截断」标记即数据不完整——请缩小查询范围或分页获取，不得基于残缺数据下结论。
+5. 长度截断须知：若你的回复因长度限制被截断，系统不会重发你的半条回复；请控制篇幅，优先给出结论与要点。
+6. 聚焦优先：system 消息中「当前聚焦」段落是作者正在查看的内容，优先围绕它展开。
+7. 提案语义：调用提案工具后需用户确认才生效；确认前不要假设任何修改已发生。
+8. 回复使用项目配置的语言。`;
+// ============ 组装段标题与提示文案（context.ts 拼装 system 消息使用） ============
+/** 项目提示词段标题（决策 7 项目层，来自 project.json 的 prompt 字段） */
+export const PROJECT_PROMPT_TITLE = "## 项目设定";
+/** 临时指令段标题（决策 7 临时层，即时输入、不持久化） */
+export const INSTRUCTION_TITLE = "## 本次指令";
+/** 可用工具清单段标题（name + description 一行，来自 registry listTools） */
+export const TOOL_LIST_TITLE = "## 可用工具";
+/** 聚焦上下文段标题（决策 6 聚焦层：当前视图中的实体/大纲节点，由调用方查询后传入） */
+export const FOCUS_TITLE = "## 当前聚焦";
+/** 聚焦上下文截断提示（决策 15 精神：截断必须显式告知，不得静默丢数据） */
+export const FOCUS_TRUNCATION_NOTICE = "\n\n[聚焦上下文已截断：超出 token 预算，数据不完整；请缩小查看范围]";
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,0DAA0D;AAC1D,uDAAuD;AACvD,wBAAwB;AACxB,yDAAyD;AAEzD,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;gBAWb,CAAC;AAEjB,kEAAkE;AAElE,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,kCAAkC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AAEzC,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,0CAA0C,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,182 @@
+import { type AbortSignalLike, type ChatStreamResult, type LLMError, type LLMMessage, type LLMStreamEvent } from "@whispering233/ai-editor-llm";
+import { type ContextBudgets, type ToolListEntry } from "./context.js";
+import { type SessionMessage, type SessionState } from "./session.js";
+/** 轮次上限（决策 15：8 轮；持续 tool_call 死循环兜底） */
+export declare const DEFAULT_MAX_ROUNDS = 8;
+/** 单轮总预算 ms（决策 15：120s，含 LLM 重试退避与工具执行；测试可覆盖） */
+export declare const DEFAULT_ROUND_TIMEOUT_MS = 120000;
+/**
+ * 单次 attempt 超时 ms（决策 15：「LLM 单次 attempt 另有自身 fetch 超时」落地——
+ * 独立于 120s 单轮总预算；attempt 超时映射为可重试错误，轮内重试仍受 roundDeadline 兜底）。
+ */
+export declare const DEFAULT_ATTEMPT_TIMEOUT_MS = 60000;
+/** 上下文 token 预算（决策 15：60K——DeepSeek 64K 窗口留余量；测试可覆盖） */
+export declare const DEFAULT_TOKEN_BUDGET = 60000;
+/** 提案载荷（S7.4 工具调度层构造 preview；对齐 endpoints.md proposal 事件 data 形态） */
+export interface ProposalPayload {
+    proposal_id: string;
+    /** 提案类型 = 产生它的 propose_* 工具名（endpoints.md data.type） */
+    type: string;
+    /** 提案预览（前端提案卡渲染数据；本层透传不构造） */
+    preview: Record<string, unknown>;
+}
+/**
+ * runAgent 输出事件流：
+ * - turn_start：循环内部事件（每轮开始；S7.6 可不映射 SSE 帧，用于日志/调试）
+ * - text：AI 文本增量（实时转发，失败轮可能已流出的半条文本属重试语义，接受）
+ * - tool_call / tool_result：工具调用与结果（按 tool_call_id 配对；length 截断的调用
+ *   不发 dispatcher，仍发 tool_call 事件）
+ * - proposal：恒在对应 tool_result 之后、循环继续之前发送（endpoints.md 顺序约定）
+ * - done：自然终止（无工具调用），携带 session_id
+ * - error：终止（决策 15：模型最终失败 / 8 轮上限 / 超时 / token 超限 / 调度器缺陷）或
+ *   用户取消（aborted=true，决策 16）；S7.6 收到 error 后立即关闭流
+ */
+export type AgentEvent = {
+    type: "turn_start";
+    round: number;
+} | {
+    type: "text";
+    delta: string;
+} | {
+    type: "tool_call";
+    tool: string;
+    args: Record<string, unknown> | null;
+    id: string;
+} | {
+    type: "tool_result";
+    tool: string;
+    result: string;
+    id: string;
+} | {
+    type: "proposal";
+    proposal: ProposalPayload;
+} | {
+    type: "done";
+    sessionId: string;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+    aborted: boolean;
+};
+/** 待调度工具调用（LLMToolCallResult 解析成功后的形态：id/tool/parsed args——S7.4 executor 直接 zod 校验执行） */
+export interface DispatchToolCall {
+    id: string;
+    tool: string;
+    args: Record<string, unknown>;
+}
+/** 单个工具调度结果（S7.4 构造；isError=true 结构化回填、不终止循环） */
+export interface DispatchResult {
+    id: string;
+    tool: string;
+    /**
+     * 执行成功与否（与 isError 同义冗余——按任务卡接口保留双字段；ora S7.3 审核 S4：
+     * 本卡不消费 ok，留 S7.4 真实现构造时使用，接口不动）
+     */
+    ok: boolean;
+    /** 失败标记：喂回 LLM 的内容须含错误说明（决策 15 结构化喂回自纠） */
+    isError: boolean;
+    /** 回填 LLM 的 tool 消息内容（成功 = 结果 JSON/文本；失败 = 错误说明） */
+    content: string;
+    /** 提案数据（仅 propose_* 工具返回；触发 proposal 事件） */
+    proposal?: ProposalPayload;
+}
+/**
+ * 工具调度器：
+ * - 输入按原 tool_call 顺序；输出**必须同序等长**（防御：条数不符 → AGENT_DISPATCH_ERROR 终止，
+ *   防止 tool_call ↔ tool_result 错位配对——决策 18）
+ * - signal：决策 16 ③「工具执行中检查取消」（S7.4 executor 承担；长工具执行须监听）
+ * - 本层不抛错（失败编码进 isError 结果）；抛错视为调度器缺陷 → 循环终止。
+ *   **例外：AbortedError（tools analysis/utils，决策 16 ③ 取消语义）→ 原样抛穿**——
+ *   S7.4 executor 在工具执行中检查 signal，命中取消即抛 AbortedError；本层 dispatcher
+ *   catch 识别后按用户取消终止（aborted=true、不重试、不视为缺陷），与循环其他环节的
+ *   取消语义一致（决策 16：取消不喂回）
+ */
+export type ToolDispatcher = (calls: DispatchToolCall[], signal?: AbortSignalLike) => Promise<DispatchResult[]>;
+/** runAgent 依赖注入（S7.6 组装） */
+export interface RunAgentDeps {
+    /**
+     * 模型调用（S7.6 注入：闭包持有 apiKey/model/tools，内部调用 llm chatStream）。
+     * **契约**：必须把 onEvent 转发给 chatStream 的 onEvent——runAgent 依赖它累积文本与
+     * 收集工具调用（失败轮的重试会自动丢弃旧累积，无需调用方处理）；失败按 chatStream
+     * 契约 resolve 出 { ok:false, ... }，不 throw。
+     * signal 由 runAgent 注入 attempt 级独立控制器（超时 abort 与用户取消分离，决策 15）。
+     */
+    produce: (messages: LLMMessage[], signal: AbortSignalLike, onEvent?: (event: LLMStreamEvent) => void) => Promise<ChatStreamResult>;
+    /** 工具调度（S7.4 真实现） */
+    dispatcher: ToolDispatcher;
+    /**
+     * 事件输出（S7.6 转 SSE 帧；缺省丢弃）。
+     * **硬契约（ora S7.3 审核 S3）**：回调抛错不逃逸——run 侧统一兜底吞掉（防 runAgent
+     * 直接 reject 导致 SSE 异常关流而非 error 事件）；S7.6 不得依赖异常传播通知故障。
+     */
+    onEvent?: (event: AgentEvent) => void;
+    /**
+     * 每轮新消息序列（S7.6 持久化到 chat_messages；本层不落库）。
+     * **硬契约同上**：抛错不逃逸（落库失败由 S7.6 自行处理，不中断 agent 循环）。
+     */
+    onMessages?: (messages: SessionMessage[]) => void;
+}
+export interface RunAgentInput {
+    /** 会话 ID（done 事件携带；S7.6 必传——创建/复用会话后传入） */
+    sessionId?: string;
+    /** 本轮用户消息（由本层追加进会话——S7.6 传入的 session 不应已含它，避免双写） */
+    userMessage: string;
+    /** 初始会话（S7.6 经 loadHistory/trimSession 加载的历史；不含本轮 userMessage） */
+    session: SessionState;
+    /** 聚焦上下文文本（决策 6 聚焦层；S7.6 查询实体/大纲节点后拼好传入） */
+    focus?: string;
+    /** 项目提示词（决策 7 项目层） */
+    projectPrompt?: string;
+    /** 临时指令（决策 7 临时层） */
+    instruction?: string;
+    deps: RunAgentDeps;
+    /** 用户取消信号（决策 16：全链路第 0 层；abort 永不重试） */
+    signal?: AbortSignalLike;
+    /** 分层上下文预算覆盖（S7.2） */
+    budgets?: Partial<ContextBudgets>;
+    /** 工具清单（默认 registry listTools；S7.2 注入 system 消息） */
+    tools?: ToolListEntry[];
+    /** 轮次上限（决策 15：默认 8；测试可覆盖） */
+    maxRounds?: number;
+    /** 单轮总预算 ms（决策 15：默认 120s 含重试退避；测试可覆盖） */
+    roundTimeoutMs?: number;
+    /** 单次 attempt 超时 ms（决策 15：默认 60s——LLM 单次调用独立超时，与轮次总预算分离；测试可覆盖） */
+    attemptTimeoutMs?: number;
+    /** 上下文 token 预算（决策 15：默认 60K；测试可覆盖） */
+    tokenBudget?: number;
+    /** 每次模型调用最大重试次数（决策 15：默认 3；测试可覆盖） */
+    maxRetries?: number;
+    /** 重试退避基数 ms（决策 15：默认 2000；测试可覆盖） */
+    retryBaseDelayMs?: number;
+}
+export interface RunAgentResult {
+    ok: boolean;
+    /** 用户取消（决策 16：abort 不重试，立即终止） */
+    aborted: boolean;
+    /** 终止原因（ok=false 时；code 为 AGENT_MAX_ITERATIONS / AGENT_TIMEOUT / AGENT_TOKEN_BUDGET
+     * 或模型错误码 / 调度器缺陷码） */
+    error: LLMError | null;
+    /** 实际执行轮数（≤ maxRounds） */
+    rounds: number;
+    /**
+     * 重试累计（决策 15：重试与轮次分开计量、不互相消耗；ora S7.3 审核 S6 断言口径——
+     * 报告值不清零，为全程累计：最后一次成功轮前重试过几次即为其值；「成功即清零」的预算
+     * 语义由 withRetry maxRetries 独立限制 + roundDeadline 兜底承担，无跨轮累计消耗问题）
+     */
+    retries: number;
+}
+/**
+ * runAgent：对话主循环（S7.3）。每轮：buildContext（含 lastUsage 回写链）→ LLM 调用
+ * （withRetry + classifyRunOutcome + attempt 独立超时）→ 文本实时转发 → 成功收尾：
+ *   - 无 tool_call → done 事件终止
+ *   - stopReason=length → 全部 tool_call 标错喂回（不执行，决策 15）
+ *   - 有合法 tool_call → dispatcher 执行 → tool_result 事件（按 id 回填）→ proposal 事件
+ *     （在 tool_result 后、循环继续前）→ 结果回填会话 → 下一轮
+ * 三重保险（决策 15）：8 轮上限 / 120s 单轮总预算（含重试退避**与工具执行**——调度前与
+ * dispatcher 返回后均校验 deadline）/ token 预算，各自发 error 事件终止。工具失败（isError）
+ * 结构化回填不终止（喂回自纠）；模型失败按重试策略退避重试，重试与轮次分开计量（报告值
+ * 累计不清零，见 result.retries 注释）；abort 双形态归一后循环只处理 resolve 形态。
+ */
+export declare function runAgent(input: RunAgentInput): Promise<RunAgentResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

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