agentpage 0.0.32 → 0.0.33

package/README.md

@@ -1,9 +1,5 @@
 # AutoPilot
 
-<p align="center">
-  <img src="./assets/logo/contours%20(2).svg" alt="AutoPilot Logo" width="180" />
-</p>
-
 > 浏览器内嵌 AI Agent SDK：让 AI 通过 tool-calling 操作网页。
 
 > 核心主张：通过 **Prompt + Tools + 路由**，快速为网站实现 AI 赋能，并构建**前端运行时 AI Skill**。AutoPilot 本质上是一个运行在前端浏览器中的 AI Agent。
@@ -177,23 +173,6 @@ console.log(result.reply);
 pnpm demo
 ```
 
-### Demo Prompt 建议（Element Plus）
-
-在 `demo/App.vue` 中，推荐为 Demo 场景单独注册一条 prompt（key: `demo`），以减少无效调用和重复验证：
-
-```ts
-agent.setSystemPrompt("demo", [
-  "You are operating the Element Plus demo page.",
-  "Prefer minimal action arrays and complete independent visible actions in one round.",
-  "Do not repeat verification calls unless the user explicitly asks for verification.",
-].join(" "));
-```
-
-这三条规则分别约束：
-- 最小化动作数组，减少冗余工具调用。
-- 同一轮优先完成当前可见且彼此独立的动作，提升收敛速度。
-- 非用户明确要求时，不重复做验证型调用，避免空转。
-
 ### 按路由构建 AI Skill（推荐范式）
 
 ```ts
@@ -259,7 +238,6 @@ applyRouteSkill(location.pathname);
 | `memory` | `boolean` | `false` | 是否开启多轮对话记忆（跨 chat 调用保留历史消息） |
 | `autoSnapshot` | `boolean` | `true` | chat 前是否自动生成首轮页面快照并注入 system prompt |
 | `snapshotOptions` | `SnapshotOptions` | `{}` | 快照生成参数覆盖（深度、裁剪、剪枝、节点上限等） |
-| `roundStabilityWait` | `RoundStabilityWaitOptions` | `{ enabled: true }` | 轮次后稳定等待配置（loading hidden + DOM stable）；`loadingSelectors` 为“与默认值合并去重”，不会覆盖默认列表 |
 
 ### 参数详细说明
 
@@ -380,33 +358,14 @@ agent.clearHistory();                       // 手动清空历史
 
 | 参数 | 类型 | 默认值 | 说明 |
 | --- | --- | --- | --- |
-| `maxDepth` | `number` | `8`（chat 首轮）/ `7`（page_info.snapshot） | DOM 最大遍历深度，超过该深度的子树不会输出 |
+| `maxDepth` | `number` | `8`（chat 首轮）/ `6`（page_info.snapshot） | DOM 最大遍历深度，超过该深度的子树不会输出 |
 | `viewportOnly` | `boolean` | `false`（chat 首轮）/ `true`（page_info.snapshot） | 是否仅保留与视口相交的元素 |
 | `pruneLayout` | `boolean` | `true` | 是否折叠无意义纯布局容器（div/span/section 等） |
-| `maxNodes` | `number` | `500`（chat 首轮）/ `280`（page_info.snapshot） | 快照最大节点输出数量，超出后停止遍历并追加截断提示 |
-| `maxChildren` | `number` | `30`（chat 首轮）/ `32`（page_info.snapshot） | 每个父节点最多保留的子元素数量 |
+| `maxNodes` | `number` | `500`（chat 首轮）/ `220`（page_info.snapshot） | 快照最大节点输出数量，超出后停止遍历并追加截断提示 |
+| `maxChildren` | `number` | `30`（chat 首轮）/ `25`（page_info.snapshot） | 每个父节点最多保留的子元素数量 |
 | `maxTextLength` | `number` | `40` | 单节点文本截断长度（字符数） |
 | `refStore` | `RefStore` | 自动创建 | hash ID 映射表（一般无需手动传入，WebAgent 自动管理） |
 
-### 全局事件监听追踪（默认开启）
-
-从 `0.0.26` 开始，`web` 入口会在模块加载时默认安装全局监听追踪补丁：
-
-- 劫持 `EventTarget.prototype.addEventListener/removeEventListener`
-- 先执行原生调用，再记录事件（不阻断业务逻辑）
-- 仅记录 `Element` 目标，使用 `WeakMap<Element, Set<string>>`
-
-快照侧联动：
-
-- `page_info.snapshot` 会为命中事件追踪的元素输出 `listeners="click,input,..."`
-- 交互优先级识别会把运行时监听事件纳入判断（不仅依赖 `onclick/role` 等静态属性）
-- 智能剪枝会优先保留“自身有事件绑定”的容器，并在中浅层对子树事件做受预算探测，尽量保留可操作链路
-
-边界说明：
-
-- 事件委托场景只能记录到父容器（这是浏览器事件机制本身决定的）
-- 补丁安装前已绑定的历史监听不会被回溯记录；建议尽早初始化 `WebAgent`
-
 ### 快照参数详细说明
 
 #### `maxDepth`（遍历深度）
@@ -442,10 +401,6 @@ agent.clearHistory();                       // 手动清空历史
 
 折叠规则：
 - 没有 `id`、没有语义标签（如 `main`/`nav`）、没有交互属性、没有直接文本的纯布局div/span
-- 浅层布局主干默认保留（避免页面主结构被过早折叠）
-- 自身有事件绑定（`on*` 或追踪到 listeners）的容器优先保留
-- 中浅层子树出现事件绑定时，在预算范围内尽量保留相关容器
-- `svg` 装饰节点与 `__SVG_SPRITE_NODE__` sprite 容器会被过滤，避免噪音吞掉节点预算
 - 子节点直接**提升**输出到父级位置
 - 当同一折叠容器提升出多个相邻节点时，用 `collapsed-group` 括号块标记它们的来源关联
 
@@ -469,7 +424,7 @@ agent.clearHistory();                       // 手动清空历史
 | --- | --- | --- | --- | --- | --- |
 | `chat()` 首轮 | 8 | false | 500 | 30 | 优先完整性，提供充足的页面上下文 |
 | `page_info.snapshot`（loop 内） | 8 | false | 500 | 30 | 与首轮对齐，保证一致性 |
-| `page_info.snapshot`（手动调用） | 7 | true | 280 | 32 | 略放宽额度，兼顾结构完整与可操作性 |
+| `page_info.snapshot`（手动调用） | 6 | true | 220 | 25 | 较小体积，适合局部更新 |
 
 ---
 
@@ -749,7 +704,7 @@ AutoPilot 内置 5 个工具，覆盖浏览器交互的核心能力。所有工
 | `attribute` | `string` | get_attr/set_attr | 属性名称 |
 | `className` | `string` | add_class/remove_class | CSS 类名（旧参数名，已被 `value` 兼容） |
 | `clickCount` | `number` | click | 点击次数（默认 1，双击传 2，三击传 3） |
-| `waitMs` | `number` | 所有动作 | 等待元素出现的超时时间（毫秒，默认 1200） |
+| `waitMs` | `number` | 所有动作 | 等待元素出现的超时时间（毫秒，默认 2000） |
 | `waitSeconds` | `number` | 所有动作 | 等待超时（秒，`waitMs` 优先级更高） |
 | `force` | `boolean` | 所有动作 | 跳过 actionability 检查（默认 false） |
 
@@ -859,7 +814,7 @@ AutoPilot 内置 5 个工具，覆盖浏览器交互的核心能力。所有工
 | `selector` | `string` | wait_for_selector/hidden | 目标元素选择器 |
 | `state` | `string` | wait_for_selector | 目标状态：`attached`/`visible`/`hidden`/`detached` |
 | `text` | `string` | wait_for_text | 要等待出现的文本内容 |
-| `timeout` | `number` | 所有动作 | 超时时间（毫秒，默认 6000） |
+| `timeout` | `number` | 所有动作 | 超时时间（毫秒，默认 10000） |
 | `quietMs` | `number` | wait_for_stable | DOM 静默窗口时长（毫秒，默认 300） |
 
 **动作详解：**
@@ -1011,7 +966,6 @@ src/
 │       └── sse.ts
 └── web/
   ├── index.ts
-  ├── event-listener-tracker.ts  # 全局事件监听追踪（WeakMap<Element, Set<string>>）
   ├── dom-tool.ts          # 兼容转发层（re-export）
   ├── navigate-tool.ts     # 兼容转发层（re-export）
   ├── page-info-tool.ts    # 兼容转发层（re-export）
@@ -1020,14 +974,7 @@ src/
   ├── ref-store.ts
   ├── messaging.ts
   └── tools/
-    ├── dom-tool/
-    │   ├── index.ts          # createDomTool 入口 + schema + execute 路由
-    │   ├── constants.ts       # 常量（DEFAULT_WAIT_MS, KEY_CODE_MAP 等）
-    │   ├── query.ts           # 元素查找、RefStore 管理、describeElement
-    │   ├── actionability.ts   # 可操作性检查（可见/禁用/可编辑/稳定/命中）
-    │   ├── events.ts          # 事件派发（click/hover/input 链、键盘 press）
-    │   ├── resolve.ts         # 目标解析（retarget、checkable/editable 穿透、ARIA widget→input 穿透）
-    │   └── dropdown.ts        # 自定义下拉增强（findVisibleOptionByText）
+    ├── dom-tool.ts
     ├── navigate-tool.ts
     ├── page-info-tool.ts
     ├── wait-tool.ts
@@ -1089,8 +1036,6 @@ AI 每一轮不是“凭记忆猜页面”，而是基于最新快照选择可
 例子：
 - 可同轮：同时填写两个已可见输入框
 - 不可同轮：点击“打开弹窗”后立即填写弹窗字段（应等下一轮新快照）
-- 当前实现：若本轮出现潜在 DOM 变化动作，轮次结束会自动执行双重等待（先 loading hidden，再 DOM quiet window），默认 `quietMs=200`、`timeoutMs=4000`。
-- `loadingSelectors` 默认内置 AntD / Element Plus / BK / TDesign（TD）及通用加载态选择器；用户自定义会在默认列表基础上追加并去重，不会覆盖默认值。
 
 ---
 
@@ -1140,13 +1085,12 @@ loop 对本轮返回做以下处理：
 1. 执行工具调用批次
 2. 拦截 `page_info.*`（在 loop 内视为冗余，不让其成为主流程）
 3. 处理恢复（元素找不到时自动刷新快照）
-4. 若本轮存在潜在 DOM 变化动作：执行轮次后稳定等待（loading hidden + DOM stable）
-5. 刷新快照进入下一轮
-6. 更新下一轮任务文本：
+4. 刷新快照进入下一轮
+5. 更新下一轮任务文本：
   - 优先使用 `REMAINING`
-  - 若缺失 `REMAINING` 且本轮有执行动作：仅在存在明确顺序连接词（如 `然后`/`next`/`->`）时，保守地启发式推进一步
+  - 若缺失 `REMAINING` 且本轮有执行动作：按线性任务剔除做启发式推进（避免整段原任务重复）
   - 若缺失 `REMAINING` 且本轮无执行进展：保持当前任务不推进（按协议回退）
-7. 若“remaining 未完成 + 无工具调用”：
+6. 若“remaining 未完成 + 无工具调用”：
   - 不直接结束
   - 下一轮注入 `Protocol violation` 强约束提示，要求“要么给可执行工具调用，要么严格 `REMAINING: DONE`”
 
@@ -1157,12 +1101,12 @@ loop 对本轮返回做以下处理：
 1. 收集失败工具调用（name/input）及失败原因
 2. 将“失败工具集合 + 最新快照 + 当前任务”一起发给模型重试
 3. 在消息中标注重试次数：`attempt x/y`
-4. 若仍未命中，默认 `await 1000ms` 后刷新快照再重试
+4. 若仍未命中，默认 `await 2000ms` 后刷新快照再重试
 5. 超过最大尝试次数后退出重试流，交由模型给出剩余任务或结束
 
 默认参数：
 - `DEFAULT_NOT_FOUND_RETRY_ROUNDS = 2`
-- `DEFAULT_NOT_FOUND_RETRY_WAIT_MS = 1000`
+- `DEFAULT_NOT_FOUND_RETRY_WAIT_MS = 2000`
 
 ### 4) 停机条件
 
@@ -1173,8 +1117,6 @@ loop 对本轮返回做以下处理：
 
 ### 5) 线性任务剔除示例（标准范式）
 
-注意：该示例仅适用于任务文本中包含明确顺序连接词的场景（例如 `然后`、`next`、`->`）。
-
 总任务：`点击按钮 -> 输入框输入 "abc" -> 发送`
 
 - 第 1 轮
@@ -1203,13 +1145,13 @@ loop 对本轮返回做以下处理：
 
 ### A. System Prompt（全局规则层）
 
-由 `src/core/system-prompt.ts` 生成，采用 Decision Framework 架构：
+由 `src/core/system-prompt.ts` 生成，职责是定义不可变执行约束：
 
-- 五阶段决策流：ANALYZE → ASSESS → CHOOSE → EXECUTE → OUTPUT
-- Targeting Rules：hash selector 优先、ordinal 1-based 视觉序
-- Constraints：form-input 顺序、DOM 变化断轮、禁止冗余 page_info
-- Listener Abbreviations：快照中缩写到原始事件的映射
-- 工具部分由各工具 `t.description` 动态注入，不在 prompt 正文重复
+- 从当前快照直接执行，不复述任务
+- 任务按“剔除模型”推进（current + previous + this-round -> new remaining）
+- 禁止 `page_info` 作为规划手段
+- 可见目标尽量同轮批量执行
+- DOM 会变化的动作执行后在下一轮继续
 - 统一输出 `REMAINING` 协议
 
 ### B. Round Messages（轮次状态层）
@@ -1231,7 +1173,7 @@ loop 对本轮返回做以下处理：
 - 首轮使用前端注入的 `initialSnapshot`
 - 每轮执行后刷新快照
 - 推进 `remainingInstruction`
-- `REMAINING` 缺失且本轮有执行动作时：仅在显式序列任务下启发式推进一步
+- `REMAINING` 缺失且本轮有执行动作时：按线性任务剔除做启发式推进
 - `REMAINING` 缺失且本轮无执行进展时：保持当前 remaining
 - 防空转、防重复、防无限循环
 - DOM 变更动作触发强制断轮（等待下一轮新快照）
@@ -1489,7 +1431,7 @@ agent.registerTool({
   - `agent-loop`：轮次编排、停机判定、恢复/重试、指标汇总
   - `system-prompt`：系统规则模板
   - `tool-registry`：工具注册/分发/错误兜底
-  - `ai-client`：多 provider 协议适配（OpenAI/Copilot/Anthropic/DeepSeek/Doubao/Qwen）
+  - `ai-client`：多 provider 协议适配（OpenAI/Copilot/Anthropic/DeepSeek）
 - `web`（浏览器实现）：
   - `WebAgent`：入口编排、记忆、autoSnapshot、callbacks
   - `tools`：DOM/导航/页面信息/等待/evaluate
@@ -1547,7 +1489,7 @@ agent.registerTool({
 
 #### 2.3 缺失协议时的回退策略
 
-- 若本轮有执行动作：仅当当前任务包含显式顺序连接词时，启发式推进一步（`reduceRemainingHeuristically`）
+- 若本轮有执行动作：启发式线性剔除（`reduceRemainingHeuristically`）
 - 若本轮无推进：保持 remaining 不变，并标记协议违约风险
 
 #### 2.4 协议修复回合（Protocol Violation Round）
@@ -1583,7 +1525,7 @@ agent.registerTool({
 | 冗余 page_info 拦截 | `page_info.snapshot/query_all/get_url/get_title/get_viewport` | - | 直接返回拦截结果，不执行真实调用 | `recovery.ts#checkRedundantSnapshot` |
 | 连续 snapshot 防抖 | 连续 page_info.snapshot | 阈值=2 | 标记 `REDUNDANT_SNAPSHOT` | `recovery.ts#applySnapshotDebounce` |
 | 元素未找到自动恢复 | `dom` 且结果为 element not found | `DEFAULT_ACTION_RECOVERY_ROUNDS=2`，`DEFAULT_RECOVERY_WAIT_MS=100` | 等待 -> 刷新快照 -> 返回 recovery 结果 | `recovery.ts#handleElementRecovery` |
-| Not-found 重试对话流 | 本轮有 not-found 失败任务 | `DEFAULT_NOT_FOUND_RETRY_ROUNDS=2`，`DEFAULT_NOT_FOUND_RETRY_WAIT_MS=1000` | 注入失败任务上下文 + attempt x/y，必要时等待后重试 | `index.ts` 主循环 |
+| Not-found 重试对话流 | 本轮有 not-found 失败任务 | `DEFAULT_NOT_FOUND_RETRY_ROUNDS=2`，`DEFAULT_NOT_FOUND_RETRY_WAIT_MS=2000` | 注入失败任务上下文 + attempt x/y，必要时等待后重试 | `index.ts` 主循环 |
 | 导航后上下文刷新 | `navigate` 成功且动作为 goto/back/forward/reload | - | 立即刷新快照 | `recovery.ts#handleNavigationUrlChange` |
 | 空转检测 | 连续只读轮次 | 连续 2 轮 | 返回 -1 终止 | `recovery.ts#detectIdleLoop` |
 
@@ -1654,7 +1596,7 @@ agent.registerTool({
 
 ### 6. Tools 能力总表（详细）
 
-#### 6.1 `dom` 工具（`src/web/tools/dom-tool/`）
+#### 6.1 `dom` 工具（`src/web/tools/dom-tool.ts`）
 
 支持动作：
 
@@ -1763,36 +1705,34 @@ agent.registerTool({
 
 1. **System Prompt（稳定规则层）**
   - 由 `buildSystemPrompt()` 生成
-  - 采用 Decision Framework 架构：ANALYZE → ASSESS → CHOOSE → EXECUTE → OUTPUT
-  - 包含 Targeting Rules、Constraints、Listener Abbreviations
-  - 工具部分由各工具 `t.description` 动态注入，prompt 不重复工具能力描述
+  - 永久规则：快照优先、批处理、输入顺序、禁止 page_info、REMAINING 协议
 2. **Round Message（动态状态层）**
   - 由 `buildCompactMessages()` 生成
-  - 包含当前 remaining、Master goal 锚点（防漂移）、done steps、上轮计划、上轮输出归一化、最新快照
+  - 包含当前 remaining、done steps、上轮计划、上轮输出归一化、最新快照
 3. **Recovery Context（修复层）**
   - Not-found retry context
   - Protocol violation hint
 
 #### 7.2 System Prompt 的关键规则（当前实现）
 
-`buildSystemPrompt()` 采用 Decision Framework 架构，不再逐条罗列规则：
+`buildSystemPrompt()` 中的核心约束（英文原文语义）：
 
-- 五阶段决策流：ANALYZE snapshot → ASSESS targets → CHOOSE action → EXECUTE → OUTPUT
-- Targeting Rules：hash selector 优先、ordinal 为 1-based 视觉序
-- Constraints：form-input 顺序约束（focus/click → fill/type/select_option）、DOM 结构变化后断轮
-- Listener Abbreviations：`clk`/`inp`/`chg`/`kdn`/`kup` 等缩写映射
-- 工具描述去重：工具部分完全由各工具 `t.description` 动态注入，prompt 不再重复
-- 统一输出 `REMAINING: <text>` 或 `REMAINING: DONE`
+- 从“当前快照 + 当前 remaining”直接执行，不复述任务
+- 每轮按 task reduction 推进
+- 使用 hash selector，不猜 CSS
+- 可见且互不依赖的动作同轮批量执行
+- 输入顺序强约束：`focus/click -> fill/type/select_option`
+- 多字段交替对执行（防止 focus-only 空轮）
+- DOM 结构变化动作后断轮
+- 禁用 `page_info` 作为规划手段
+- 输出 `REMAINING: ...` 或 `REMAINING: DONE`
 
 #### 7.3 Round 0 与 Round 1+ 差异
 
 - Round 0：原始任务 + 首轮快照
-- Round 1+：以 remaining 驱动；当 remaining 与原始任务不同时，注入 `Master goal (reference only)` 锚点
+- Round 1+：不再重复原始用户输入，改为“remaining 驱动”
 
-Master goal 锚点的设计目的：
-- 防止 remaining 因模型错误缩减而偏离原始目标（任务漂移）
-- 标注 `reference only — do NOT restart from scratch`，避免模型回头重做
-- 让模型能随时交叉校验当前行动是否符合原始意图
+这能显著降低“回头重做”的概率。
 
 #### 7.4 显式 UI 意图判定
 
@@ -1838,38 +1778,27 @@ Master goal 锚点的设计目的：
 - `DEFAULT_RECOVERY_WAIT_MS = 100`
 - `DEFAULT_ACTION_RECOVERY_ROUNDS = 2`
 - `DEFAULT_NOT_FOUND_RETRY_ROUNDS = 2`
-- `DEFAULT_NOT_FOUND_RETRY_WAIT_MS = 1000`
+- `DEFAULT_NOT_FOUND_RETRY_WAIT_MS = 2000`
 
 `src/web/tools/wait-tool.ts`：
 
-- `DEFAULT_TIMEOUT = 6000`
+- `DEFAULT_TIMEOUT = 10000`
 
 ---
 
 ### 10. 文档与实现一致性清单（维护者必看）
 
-Agent Loop 机制权威文档：`src/core/agent-loop/LOOP_MECHANISM.md`。
-
 任何涉及“渐进式任务消费”的改动，至少同步以下文件：
 
 1. `src/core/agent-loop/messages.ts`（输入语义）
 2. `src/core/agent-loop/index.ts`（停机判定与推进逻辑）
-3. `src/core/agent-loop/LOOP_MECHANISM.md`（机制权威说明）
-4. `README.md`（机制说明）
+3. `README.md`（机制说明）
 
 任何涉及“找不到元素重试流”的改动，至少同步：
 
 1. `src/core/agent-loop/index.ts`
 2. `src/core/agent-loop/recovery.ts`
-3. `src/core/agent-loop/LOOP_MECHANISM.md`
-4. `README.md`
-
-任何涉及 provider 新增/调整的改动，至少同步：
-
-1. `src/core/ai-client/index.ts`（provider 路由）
-2. `src/core/ai-client/constants.ts`（默认端点）
-3. `src/web/index.ts`（WebAgentOptions 注释/提示）
-4. `README.md`（配置示例与支持矩阵）
+3. `README.md`
 
 这样才能保证“实现、提示词、文档”三者一致，不出现行为漂移。
 
@@ -1921,4 +1850,4 @@ MIT
 4. **RefStore - 生命周期图**：从 `chat()` 创建到 `clear()` 释放的完整流程
 5. **AI Client - 自定义接入**：`BaseAIClient` 和纯对象两种方式的代码示例
 6. **快照格式 - 生成管线**：从 `document.body` 到最终文本的 10 步管线流程
-7. **错误处理 - 恢复常量**：`DEFAULT_ACTION_RECOVERY_ROUNDS=2` / `DEFAULT_NOT_FOUND_RETRY_ROUNDS=2` / `DEFAULT_NOT_FOUND_RETRY_WAIT_MS=1000` 等关键参数说明
+7. **错误处理 - 恢复常量**：`DEFAULT_ACTION_RECOVERY_ROUNDS=2` / `DEFAULT_NOT_FOUND_RETRY_ROUNDS=2` / `DEFAULT_NOT_FOUND_RETRY_WAIT_MS=2000` 等关键参数说明

package/dist/index.d.mts

@@ -62,13 +62,6 @@ type AIClient = {
 };
 //#endregion
 //#region src/core/agent-loop/types.d.ts
-/** 轮次后稳定等待配置（加载态 + DOM 静默） */
-type RoundStabilityWaitOptions = {
-  /** 是否启用轮次后稳定等待（默认 true） */enabled?: boolean; /** 双重等待总超时（毫秒，默认 4000） */
-  timeoutMs?: number; /** DOM 静默窗口（毫秒，默认 200） */
-  quietMs?: number; /** 页面加载态选择器列表（会与默认列表合并去重，不会覆盖默认值） */
-  loadingSelectors?: string[];
-};
 type AgentLoopMetrics = {
   roundCount: number;
   totalToolCalls: number;
@@ -164,16 +157,6 @@ declare class RefStore {
   get(id: string): Element | undefined;
   /** 检查 hash ID 是否存在 */
   has(id: string): boolean;
-  /** 删除指定 hash ID 映射，返回是否删除成功。 */
-  delete(id: string): boolean;
-  /**
-   * 清理失效引用：
-   * - 仅保留 keepIds 中的映射（若提供）
-   * - 自动移除已脱离文档（isConnected=false）的元素
-   *
-   * @returns 被移除的映射数量
-   */
-  prune(keepIds?: ReadonlySet<string>): number;
   /** 清空所有映射 */
   clear(): void;
   /**
@@ -192,7 +175,7 @@ declare class RefStore {
 //#region src/web/tools/page-info-tool.d.ts
 /** 快照配置选项 */
 type SnapshotOptions = {
-  /** 最大遍历深度（默认 7） */maxDepth?: number;
+  /** 最大遍历深度（默认 6） */maxDepth?: number;
   /**
    * 视口裁剪：只保留与视口相交的元素（默认 true）。
    * 开启后，完全在视口外的元素会被跳过，大幅减少 token 消耗。
@@ -210,8 +193,8 @@ type SnapshotOptions = {
    * 传入 RefStore 实例后，每个元素使用确定性 hash ID 替代完整 XPath，
    * 大幅减少 token 消耗。dom-tool 通过 RefStore.get(id) 解析回 DOM 元素。
    */
-  refStore?: RefStore; /** 最大输出节点数（默认 280），超过后停止继续遍历。 */
-  maxNodes?: number; /** 每个父节点最多输出的子元素数（默认 32），超出部分会折叠。 */
+  refStore?: RefStore; /** 最大输出节点数（默认 220），超过后停止继续遍历。 */
+  maxNodes?: number; /** 每个父节点最多输出的子元素数（默认 25），超出部分会折叠。 */
   maxChildren?: number; /** 文本截断长度（默认 40）。 */
   maxTextLength?: number;
   /**
@@ -249,7 +232,7 @@ type SnapshotOptions = {
 declare function generateSnapshot(root?: Element, options?: SnapshotOptions | number): string;
 declare function createPageInfoTool(): ToolDefinition;
 //#endregion
-//#region src/web/tools/dom-tool/index.d.ts
+//#region src/web/tools/dom-tool.d.ts
 declare function createDomTool(): ToolDefinition;
 //#endregion
 //#region src/web/tools/navigate-tool.d.ts
@@ -364,8 +347,7 @@ type WebAgentOptions = {
   maxRounds?: number; /** 是否启用多轮对话记忆（默认 false） */
   memory?: boolean; /** 是否在每次对话前自动生成页面快照（默认 true） */
   autoSnapshot?: boolean; /** 快照选项（视口裁剪、智能剪枝等，autoSnapshot 开启时生效） */
-  snapshotOptions?: SnapshotOptions; /** 轮次后稳定等待（加载态 + DOM 静默）配置 */
-  roundStabilityWait?: RoundStabilityWaitOptions;
+  snapshotOptions?: SnapshotOptions;
 };
 declare class WebAgent {
   /** 默认系统提示词 key（兼容旧版 setSystemPrompt(prompt)）。 */
@@ -393,8 +375,6 @@ declare class WebAgent {
   private autoSnapshot;
   /** 快照选项 */
   private snapshotOptions;
-  /** 轮次后稳定等待配置 */
-  private roundStabilityWait?;
   /** 工具注册表实例 — 每个 WebAgent 拥有独立的工具集 */
   private registry;
   /** 事件回调 — 绑定后可实时获取 Agent 进度，用于 UI 展示 */

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core/tool-registry.ts","../src/core/types.ts","../src/core/agent-loop/types.ts","../src/web/ref-store.ts","../src/web/tools/page-info-tool.ts","../src/web/tools/dom-tool/index.ts","../src/web/tools/navigate-tool.ts","../src/web/tools/wait-tool.ts","../src/web/tools/evaluate-tool.ts","../src/web/messaging.ts","../src/web/index.ts"],"mappings":";;;;;;KA0BY,cAAA;EAuBV,qCArBA,OAAA,WAAkB,MAAA,mBAqBR;EAnBV,OAAA,GAAU,MAAA;AAAA;;;;;;ACfZ;;;KD0BY,cAAA;ECxBV,4CD0BA,IAAA,UCtBA;EDwBA,WAAA,UCxBK;ED0BL,MAAA,EAAQ,OAAA,ECpBW;EDsBnB,OAAA,GAAU,MAAA,EAAQ,MAAA,sBAA4B,OAAA,CAAQ,cAAA;AAAA;;;;KClC5C,UAAA;ED0BA,0BCxBV,EAAA;EAEA,IAAA,UD8BkB;EC5BlB,KAAA;AAAA;;KAMU,SAAA;EACV,IAAA,4CDiBA;ECfA,OAAA,WAAkB,KAAA;IAAQ,UAAA;IAAoB,MAAA;EAAA,IDmBpC;ECjBV,SAAA,GAAY,UAAA;AAAA;;KAMF,cAAA;iBAEV,IAAA;EAEA,SAAA,GAAY,UAAA,IA3BQ;EA6BpB,KAAA;IAAU,WAAA;IAAqB,YAAA;EAAA;AAAA;;;AAjBjC;;;KA2BY,QAAA;EACV,IAAA,CAAK,MAAA;IACH,YAAA;IACA,QAAA,EAAU,SAAA;IACV,KAAA,GAAQ,cAAA;EAAA,IACN,OAAA,CAAQ,cAAA;AAAA;;;;KCjDF,yBAAA;EFoBA,2BElBV,OAAA,YFkBgB;EEhBhB,SAAA,WF2BwB;EEzBxB,OAAA,WF+BQ;EE7BR,gBAAA;AAAA;AAAA,KAGU,gBAAA;EACV,UAAA;EACA,cAAA;EACA,mBAAA;EACA,eAAA;EACA,eAAA;EACA,aAAA;EACA,uBAAA;EACA,iBAAA;EACA,kBAAA;EACA,eAAA;EACA,eAAA;EACA,WAAA;EACA,YAAA;AAAA;;KAMU,kBAAA;EDzBA,mBC2BV,MAAA,IAAU,IAAA;EAEV,UAAA,IAAc,IAAA,UAAc,KAAA,oBD3B5B;EC6BA,YAAA,IAAgB,IAAA,UAAc,MAAA,EAAQ,cAAA,WDzBtC;EC2BA,OAAA,IAAW,KAAA;ED3BN;AAMP;;;;;;;EC8BE,wBAAA,IAA4B,MAAA,oBD3BkB;EC6B9C,SAAA,IAAa,OAAA,EAAS,gBAAA;AAAA;AAAA,KA4BZ,eAAA;EDhCV,iBCkCA,KAAA,UDhCE;ECkCF,SAAA,EAAW,KAAA;IAAQ,IAAA;IAAc,KAAA;IAAgB,MAAA,EAAQ,cAAA;EAAA,IDhC7C;ECkCZ,QAAA,EAAU,SAAA,IDlCgB;ECoC1B,OAAA,EAAS,gBAAA;AAAA;;;;;;AFrEX;;;;;;;;;;AAeA;;;;;;;;;;;;;;cGAa,QAAA;EAAA,QACH,GAAA;EHOsC;EAAA,QGLtC,MAAA;EHK4D;;;;cGCxD,GAAA;EFnCF;;;;;;;EE8CV,GAAA,CAAI,EAAA,EAAI,OAAA,EAAS,IAAA;EFxCZ;AAMP;;;EEkDE,GAAA,CAAI,EAAA,WAAa,OAAA;EFjDjB;EEsDA,GAAA,CAAI,EAAA;EFpDc;EEyDlB,MAAA,CAAO,EAAA;EFzDuC;;;;;AAQhD;;EE4DE,KAAA,CAAM,OAAA,GAAU,WAAA;EFxDM;EEsEtB,KAAA,CAAA;EFtEA;;;;;;;AAYF;EEsEE,KAAA,CAAM,GAAA;;MAQF,IAAA,CAAA;AAAA;;;;KC/GM,eAAA;EJKc,mBIHxB,QAAA;EJOgB;;;;;EIDhB,YAAA;EJCgB;AAWlB;;;;EINE,WAAA;EJcsD;;;;;EIRtD,QAAA,GAAW,QAAA,EJMX;EIJA,QAAA,WJMA;EIJA,WAAA,WJIU;EIFV,aAAA;EJEsD;;;;EIGtD,iBAAA;;AHrCF;;;EG0CE,kBAAA,aHxCA;EG0CA,qBAAA;AAAA;;;AHhCF;;;;;;;;;;;;;AAWA;;;;;iBG0GgB,gBAAA,CACd,IAAA,GAAM,OAAA,EACN,OAAA,GAAS,eAAA;AAAA,iBAggBK,kBAAA,CAAA,GAAsB,cAAA;;;iBC3lBtB,aAAA,CAAA,GAAiB,cAAA;;;iBC7BjB,kBAAA,CAAA,GAAsB,cAAA;;;iBCuMtB,cAAA,CAAA,GAAkB,cAAA;;;iBC/JlB,kBAAA,CAAA,GAAsB,cAAA;;;;;;ARxCtC;;;;;;;;;;AAeA;;;;;;;;;;;;;;KSXY,eAAA;EACV,IAAA;EACA,QAAA;EACA,MAAA,EAAQ,MAAA;EACR,MAAA;AAAA;;KAIU,gBAAA;EACV,IAAA;EACA,MAAA;EACA,MAAA;IACE,OAAA,WAAkB,MAAA;IAClB,OAAA,GAAU,MAAA;EAAA;AAAA;;;;ARhBd;;;;;iBQ8BgB,mBAAA,CAAA,IAEZ,QAAA,UACA,MAAA,EAAQ,MAAA,sBACP,OAAA;EAAU,OAAA,WAAkB,MAAA;EAAyB,OAAA,GAAU,MAAA;AAAA;;KAgCxD,eAAA,GAAkB,GAAA,UAE3B,MAAA,EAAQ,MAAA,sBAA4B,OAAA;EACnC,OAAA,WAAkB,MAAA;EAClB,OAAA,GAAU,MAAA;AAAA;;;;;;;;;iBAYE,mBAAA,CAAoB,SAAA,EAAW,eAAA;;;;KCrDnC,iBAAA,GAAoB,kBAAA;oBAE9B,UAAA,IAAc,QAAA;AAAA;AAAA,KAKJ,eAAA;EThDU;;;;;;AAYtB;;;;;ESgDE,MAAA,GAAS,QAAA,ET7CS;ES+ClB,KAAA,WT/C8C;ESiD9C,QAAA,WT/CY;ESiDZ,KAAA,WTjDsB;ESmDtB,OAAA,WT7CwB;ES+CxB,MAAA,YT3CsB;ES6CtB,MAAA;ET7CA;;;;;ESmDA,YAAA,YAAwB,MAAA,kBTjDmB;ESmD3C,SAAA,WTzCkB;ES2ClB,MAAA,YTxCY;ES0CZ,YAAA,YTxCY;ES0CZ,eAAA,GAAkB,eAAA,ET1CP;ES4CX,kBAAA,GAAqB,yBAAA;AAAA;AAAA,cAKV,QAAA;ETnDT;EAAA,wBSqDsB,yBAAA;ETpDtB;EAAA,wBSsDsB,kBAAA;ETzDnB;EAAA,QS4DG,MAAA;EAAA,QACA,KAAA;EAAA,QACA,QAAA;EAAA,QACA,KAAA;EAAA,QACA,OAAA;EAAA,QACA,MAAA;EAAA,QACA,MAAA;EAAA,QACA,SAAA;ERhH2B;EAAA,QQkH3B,oBAAA;ERlH2B;EAAA,QQoH3B,kBAAA;ERhHR;EAAA,QQmHQ,MAAA;ER/GR;EAAA,QQiHQ,OAAA;ERjHQ;EAAA,QQmHR,YAAA;ERhHkB;EAAA,QQkHlB,eAAA;ERlHkB;EAAA,QQoHlB,kBAAA;ERlHR;EAAA,QQqHQ,QAAA;ERnHR;EQsHA,SAAA,EAAW,iBAAA;cAEC,OAAA,EAAS,eAAA;ERrHrB;EQ6IA,aAAA,CAAA;ER3IA;EQwJA,YAAA,CAAa,IAAA,EAAM,cAAA;ERtJnB;;;;;EQ+JA,UAAA,CAAW,IAAA;ERvJiB;EQ6J5B,OAAA,CAAQ,IAAA;ER1I8B;EQ+ItC,YAAA,CAAA;ERhKU;;;;EQwKV,gBAAA,CAAA;ERpKgB;EQgLhB,QAAA,CAAA,GAAY,cAAA;ERhLkB;EQuL9B,QAAA,CAAS,KAAA;ERrLE;;;;;;EQ+LX,SAAA,CAAU,MAAA,EAAQ,QAAA;ERpLoB;EQyLtC,WAAA,CAAY,QAAA;ER7Ja;EQkKzB,QAAA,CAAS,KAAA;ER9JgD;EQmKzD,SAAA,CAAU,OAAA;ERjKA;EQsKV,SAAA,CAAA;ERpKyB;EQyKzB,SAAA,CAAU,OAAA;ER/KV;;;;;EQwLA,eAAA,CAAgB,MAAA;EAChB,eAAA,CAAgB,GAAA,UAAa,MAAA;ERrL7B;EQoMA,gBAAA,CAAiB,OAAA,EAAS,MAAA;ERlM1B;EQyMA,kBAAA,CAAmB,GAAA;ERzMM;EQ8MzB,oBAAA,CAAqB,GAAA;;EASrB,gBAAA,CAAA,GAAoB,MAAA;;EAKpB,kBAAA,CAAA;EPlRmB;EOuRnB,SAAA,CAAU,OAAA;EPnQF;EOyQR,SAAA,CAAA;EPpOgB;EOyOhB,eAAA,CAAgB,OAAA;EPzOW;EO8O3B,eAAA,CAAA;EPpSQ;EOySR,kBAAA,CAAmB,OAAA,EAAS,eAAA;EPnShB;EOwSZ,kBAAA,CAAA,GAAsB,eAAA;EP7Rd;EOkSR,YAAA,CAAA;EPlSiB;;;;;;;;;EOiTX,IAAA,CAAK,OAAA,WAAkB,OAAA,CAAQ,eAAA;EP5Q/B;;;;;EAAA,QOqWE,mBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core/tool-registry.ts","../src/core/types.ts","../src/core/agent-loop/types.ts","../src/web/ref-store.ts","../src/web/tools/page-info-tool.ts","../src/web/tools/dom-tool.ts","../src/web/tools/navigate-tool.ts","../src/web/tools/wait-tool.ts","../src/web/tools/evaluate-tool.ts","../src/web/messaging.ts","../src/web/index.ts"],"mappings":"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"}