@chen-rmag/ai-runner 0.1.0

package/TOOLS_INTEGRATION_SUMMARY.md

@@ -0,0 +1,206 @@
+# Healer 工具集成完成总结
+
+## 概述
+成功将标准化的 Playwright MCP 工具集成到 Healer 类中，替换了原有的自定义工具实现。
+
+## 主要改动
+
+### 1. Healer.ts 更新
+**文件**: [src/agents/healer.ts](src/agents/healer.ts)
+
+#### 导入新工具模块
+```typescript
+import { getAllTools } from './tools';
+```
+
+#### 替换 `createPlaywrightTools` 函数
+- **旧实现**: 包含 10 个自定义工具（click, fill, wait_for_selector 等）
+- **新实现**:
+  - 使用 `getAllTools(page)` 获取 18 个标准化工具
+  - 保留 Healer 特有的 `set_variable` 工具
+  - 总计 19 个工具（18 个标准工具 + 1 个自定义工具）
+
+#### 工具对比
+
+| 旧工具名称 | 新工具名称 | 说明 |
+|-----------|-----------|------|
+| click | browser_click | ✅ 功能增强 |
+| fill | browser_fill | ✅ 支持 JSON 格式 |
+| wait_for_selector | browser_wait_for_selector | ✅ 功能增强 |
+| wait | browser_wait_for_time | ✅ 重命名 |
+| screenshot | browser_screenshot | ✅ 保持一致 |
+| get_url | browser_get_url | ✅ 保持一致 |
+| get_content | browser_get_content | ✅ 保持一致 |
+| evaluate | ❌ 移除 | 使用 browser_snapshot 替代 |
+| get_text | browser_get_text | ✅ 保持一致 |
+| set_variable | set_variable | ✅ 保留 |
+
+#### 新增工具
+- `browser_navigate` - 导航到 URL
+- `browser_navigate_back` - 后退
+- `browser_navigate_forward` - 前进
+- `browser_hover` - 鼠标悬停
+- `browser_select_option` - 选择下拉选项
+- `browser_set_checked` - 勾选/取消复选框
+- `browser_wait_for_url` - 等待 URL 匹配
+- `browser_verify_text` - 验证文本可见性
+- `browser_verify_element` - 验证元素存在
+- `browser_snapshot` - 获取页面可访问性快照
+
+### 2. 系统提示词更新
+- 从中文改为英文（与工具名称保持一致）
+- 更新工具列表，反映新的工具名称和用法
+- 添加工具分类（导航、交互、等待、验证、变量管理）
+- 更新策略提示，使用新的工具名称
+
+### 3. 用户消息更新
+- 从中文改为英文
+- 保持结构一致
+
+## 测试验证
+
+### 单元测试
+✅ **21/21 tests passing** (50.2s)
+- [tests/tools/unit.test.ts](tests/tools/unit.test.ts)
+- 覆盖所有 18 个标准工具的功能
+
+### 集成测试
+✅ **3/3 tests passing** (3.1s)
+- [tests/healer-tool-integration.spec.ts](tests/healer-tool-integration.spec.ts)
+- 验证 Healer 类正确使用新工具
+- 验证工具数量和命名
+
+### 快速验证
+✅ 所有工具功能正常
+- 18 个标准工具
+- 1 个自定义 set_variable 工具
+
+## 工具特性增强
+
+### 1. 多选择器支持
+所有交互工具现在支持逗号分隔的多个选择器：
+```typescript
+browser_click("button, #submit, .btn-primary")
+```
+
+### 2. 智能元素匹配
+工具会自动尝试多种选择器策略：
+- 文本选择器（`getByText()`）
+- 标签选择器（`getByLabel()`）
+- 占位符选择器（`getByPlaceholder()`）
+- CSS 选择器
+
+### 3. JSON 输入格式
+复杂参数使用 JSON 格式：
+```typescript
+browser_fill('{"selector": "#username", "value": "john"}')
+browser_set_checked('{"selector": "#remember", "checked": true}')
+```
+
+### 4. 更好的错误处理
+- 每个工具都有详细的错误消息
+- 支持多选择器自动降级
+- 超时控制和重试机制
+
+## 向后兼容性
+
+### 保留功能
+✅ `set_variable` 工具完全保留
+✅ Healer 类的公共接口不变
+✅ 状态管理和 ReAct 步骤记录功能不变
+
+### 移除功能
+❌ `evaluate` 工具（使用 `browser_snapshot` 替代）
+
+### 需要注意
+- 工具名称从简短名称改为带 `browser_` 前缀的描述性名称
+- 系统提示词从中文改为英文
+- 某些工具的输入格式改变（如 `browser_fill` 使用 JSON）
+
+## 使用示例
+
+### 在 Healer 中使用
+```typescript
+import { Healer } from './agents/healer';
+
+const healer = new Healer({
+  provider: 'anthropic',
+  modelName: 'claude-3-5-sonnet-20241022',
+  apiKey: process.env.ANTHROPIC_API_KEY!,
+  temperature: 0,
+  maxTokens: 4096
+}, {
+  maxSteps: 20,
+  debugMode: true
+});
+
+const result = await healer.execute({
+  objective: 'Click the submit button',
+  error: 'Element not found: #submit-btn',
+  originalCode: 'await page.click("#submit-btn");',
+  variables: {},
+  context: { page }
+});
+```
+
+### 直接使用工具
+```typescript
+import { getAllTools } from './agents/tools';
+
+const tools = getAllTools(page);
+
+// 使用导航工具
+const navigateTool = tools.find(t => t.name === 'browser_navigate');
+await navigateTool!.invoke('https://example.com');
+
+// 使用点击工具
+const clickTool = tools.find(t => t.name === 'browser_click');
+await clickTool!.invoke('button, #submit, .btn-primary');
+
+// 使用表单填写
+const fillTool = tools.find(t => t.name === 'browser_fill');
+await fillTool!.invoke('{"selector": "#username", "value": "john"}');
+```
+
+## 文件结构
+
+```
+ai-heal/
+├── src/
+│   └── agents/
+│       ├── healer.ts                 # ✅ 更新：使用新工具
+│       └── tools/
+│           ├── index.ts              # 工具导出
+│           ├── navigate.ts           # 导航工具
+│           ├── snapshot.ts           # 快照和交互工具
+│           ├── form.ts               # 表单工具
+│           ├── wait.ts               # 等待工具
+│           ├── verify.ts             # 验证工具
+│           ├── README.md             # 工具文档
+│           └── EXAMPLES.md           # 使用示例
+└── tests/
+    ├── tools/
+    │   ├── unit.test.ts              # ✅ 单元测试（21 passed）
+    │   ├── quick-test.ts             # 快速验证脚本
+    │   └── TEST_SUMMARY.md           # 测试总结
+    └── healer-tool-integration.spec.ts  # ✅ 集成测试（3 passed）
+```
+
+## 下一步
+
+工具集成已完成，Healer 类现在使用标准化的 Playwright MCP 工具。可以考虑：
+
+1. 在实际的自愈场景中测试新工具
+2. 根据使用反馈调整工具描述和行为
+3. 添加更多测试用例覆盖边界情况
+4. 优化工具性能和错误处理
+
+## 总结
+
+✅ **工具集成成功完成**
+- 18 个标准化工具已集成到 Healer 类
+- 保留了 Healer 特有的 `set_variable` 工具
+- 所有测试通过（24/24）
+- TypeScript 编译无错误
+- 工具功能增强（多选择器、智能匹配、JSON 格式）
+- 代码结构更清晰、更易维护

package/dist/agents/error-analyzer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 错误分析器
+ * 判断错误是否可自愈
+ */
+export declare enum ErrorType {
+    Timeout = "TimeoutError",
+    Selector = "SelectorError",
+    ElementNotFound = "ElementNotFoundError",
+    StaleElement = "StaleElementError",
+    Navigation = "NavigationError",
+    Assertion = "AssertionError",
+    Network = "NetworkError",
+    Script = "ScriptError",
+    Unknown = "UnknownError"
+}
+/**
+ * 错误分析结果
+ */
+export interface ErrorAnalysis {
+    type: ErrorType;
+    isHealable: boolean;
+    reason: string;
+    confidence: number;
+}
+/**
+ * 错误分析器
+ */
+export declare class ErrorAnalyzer {
+    /**
+     * 分析错误是否可自愈
+     */
+    static analyze(error: Error): ErrorAnalysis;
+    /**
+     * 判断是否是超时错误
+     */
+    private static isTimeoutError;
+    /**
+     * 判断是否是选择器错误
+     */
+    private static isSelectorError;
+    /**
+     * 判断是否是元素未找到错误
+     */
+    private static isElementNotFoundError;
+    /**
+     * 判断是否是过时元素错误
+     */
+    private static isStaleElementError;
+    /**
+     * 判断是否是断言错误
+     */
+    private static isAssertionError;
+    /**
+     * 判断是否是网络错误
+     */
+    private static isNetworkError;
+    /**
+     * 判断是否是脚本错误
+     */
+    private static isScriptError;
+}
+//# sourceMappingURL=error-analyzer.d.ts.map

package/dist/agents/error-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-analyzer.d.ts","sourceRoot":"","sources":["../../src/agents/error-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,SAAS;IAEnB,OAAO,iBAAiB;IACxB,QAAQ,kBAAkB;IAC1B,eAAe,yBAAyB;IACxC,YAAY,sBAAsB;IAClC,UAAU,oBAAoB;IAG9B,SAAS,mBAAmB;IAC5B,OAAO,iBAAiB;IACxB,MAAM,gBAAgB;IACtB,OAAO,iBAAiB;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa;IAmF3C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAQlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAS/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAS7B"}

package/dist/agents/error-analyzer.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * 错误分析器
+ * 判断错误是否可自愈
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorAnalyzer = exports.ErrorType = void 0;
+var ErrorType;
+(function (ErrorType) {
+    // 可自愈的错误
+    ErrorType["Timeout"] = "TimeoutError";
+    ErrorType["Selector"] = "SelectorError";
+    ErrorType["ElementNotFound"] = "ElementNotFoundError";
+    ErrorType["StaleElement"] = "StaleElementError";
+    ErrorType["Navigation"] = "NavigationError";
+    // 不可自愈的错误
+    ErrorType["Assertion"] = "AssertionError";
+    ErrorType["Network"] = "NetworkError";
+    ErrorType["Script"] = "ScriptError";
+    ErrorType["Unknown"] = "UnknownError";
+})(ErrorType || (exports.ErrorType = ErrorType = {}));
+/**
+ * 错误分析器
+ */
+class ErrorAnalyzer {
+    /**
+     * 分析错误是否可自愈
+     */
+    static analyze(error) {
+        const message = error.message.toLowerCase();
+        const stack = error.stack?.toLowerCase() || '';
+        // 检查是否是超时错误
+        if (this.isTimeoutError(message, stack)) {
+            return {
+                type: ErrorType.Timeout,
+                isHealable: true,
+                reason: '元素加载超时，可以通过等待或重试修复',
+                confidence: 0.9
+            };
+        }
+        // 检查是否是选择器错误
+        if (this.isSelectorError(message, stack)) {
+            return {
+                type: ErrorType.Selector,
+                isHealable: true,
+                reason: '选择器找不到元素，可以通过更新选择器修复',
+                confidence: 0.95
+            };
+        }
+        // 检查是否是元素未找到错误
+        if (this.isElementNotFoundError(message, stack)) {
+            return {
+                type: ErrorType.ElementNotFound,
+                isHealable: true,
+                reason: '元素未找到，可以通过等待或更新定位器修复',
+                confidence: 0.9
+            };
+        }
+        // 检查是否是过时元素错误
+        if (this.isStaleElementError(message, stack)) {
+            return {
+                type: ErrorType.StaleElement,
+                isHealable: true,
+                reason: '元素已过时，可以通过重新获取元素修复',
+                confidence: 0.95
+            };
+        }
+        // 检查是否是断言错误（不可自愈）
+        if (this.isAssertionError(message, stack)) {
+            return {
+                type: ErrorType.Assertion,
+                isHealable: false,
+                reason: '断言失败，这可能是业务逻辑问题，不建议自愈',
+                confidence: 0.95
+            };
+        }
+        // 检查是否是网络错误（不可自愈）
+        if (this.isNetworkError(message, stack)) {
+            return {
+                type: ErrorType.Network,
+                isHealable: false,
+                reason: '网络错误，通常是环境问题，不建议自愈',
+                confidence: 0.8
+            };
+        }
+        // 检查是否是脚本错误（不可自愈）
+        if (this.isScriptError(message, stack)) {
+            return {
+                type: ErrorType.Script,
+                isHealable: false,
+                reason: '脚本语法错误，需要人工修复',
+                confidence: 0.95
+            };
+        }
+        // 未知错误
+        return {
+            type: ErrorType.Unknown,
+            isHealable: false,
+            reason: '未知错误类型，建议人工检查',
+            confidence: 0.5
+        };
+    }
+    /**
+     * 判断是否是超时错误
+     */
+    static isTimeoutError(message, stack) {
+        return (message.includes('timeout') ||
+            message.includes('timed out') ||
+            message.includes('waiting failed') ||
+            stack.includes('timeout'));
+    }
+    /**
+     * 判断是否是选择器错误
+     */
+    static isSelectorError(message, stack) {
+        return (message.includes('selector') ||
+            message.includes('not found') ||
+            message.includes('no element matching') ||
+            message.includes('failed to find element'));
+    }
+    /**
+     * 判断是否是元素未找到错误
+     */
+    static isElementNotFoundError(message, stack) {
+        return (message.includes('element not found') ||
+            message.includes('cannot find element') ||
+            message.includes('visible check failed'));
+    }
+    /**
+     * 判断是否是过时元素错误
+     */
+    static isStaleElementError(message, stack) {
+        return (message.includes('stale') ||
+            message.includes('detached') ||
+            message.includes('not attached to the DOM'));
+    }
+    /**
+     * 判断是否是断言错误
+     */
+    static isAssertionError(message, stack) {
+        return (message.includes('assert') ||
+            message.includes('expect') ||
+            stack.includes('assert') ||
+            stack.includes('expect'));
+    }
+    /**
+     * 判断是否是网络错误
+     */
+    static isNetworkError(message, stack) {
+        return (message.includes('network') ||
+            message.includes('connection') ||
+            message.includes('fetch failed') ||
+            message.includes('net::'));
+    }
+    /**
+     * 判断是否是脚本错误
+     */
+    static isScriptError(message, stack) {
+        return (message.includes('syntaxerror') ||
+            message.includes('referenceerror') ||
+            message.includes('typeerror') &&
+                !message.includes('timeout') && // 排除超时错误
+                !message.includes('stale') // 排除过时元素错误
+        );
+    }
+}
+exports.ErrorAnalyzer = ErrorAnalyzer;
+//# sourceMappingURL=error-analyzer.js.map

package/dist/agents/error-analyzer.js.map

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

package/dist/agents/heal-agent.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 自愈 Agent
+ * 使用 LangChain 的 Healer 执行 ReAct 循环
+ */
+import type { HealAgentState, HealAgentResult, HealAgentConfig } from './types';
+/**
+ * 自愈 Agent
+ * 使用 LLM + ReAct 循环实现智能自愈
+ */
+export declare class HealAgent {
+    private config;
+    private healer?;
+    constructor(config?: HealAgentConfig);
+    /**
+     * 执行自愈
+     *
+     * 使用 Healer 通过 ReAct 循环执行自愈任务
+     * - Thought: 分析错误和目标
+     * - Action: 调用 Playwright 工具执行操作
+     * - Observation: 观察工具执行结果
+     * - Reflection: 判断是否继续或结束
+     * - 循环直到成功或达到最大步数
+     */
+    heal(state: HealAgentState): Promise<HealAgentResult>;
+    /**
+     * 日志输出
+     */
+    private log;
+}
+//# sourceMappingURL=heal-agent.d.ts.map

package/dist/agents/heal-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-agent.d.ts","sourceRoot":"","sources":["../../src/agents/heal-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGhF;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,GAAE,eAAoB;IAoBxC;;;;;;;;;OASG;IACG,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA8B3D;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/agents/heal-agent.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * 自愈 Agent
+ * 使用 LangChain 的 Healer 执行 ReAct 循环
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealAgent = void 0;
+const healer_1 = require("./healer");
+/**
+ * 自愈 Agent
+ * 使用 LLM + ReAct 循环实现智能自愈
+ */
+class HealAgent {
+    constructor(config = {}) {
+        this.config = {
+            maxSteps: config.maxSteps ?? 20,
+            debugMode: config.debugMode ?? false,
+            model: config.model,
+            setVariable: config.setVariable,
+            getAllVariables: config.getAllVariables
+        };
+        // 如果提供了模型配置，初始化 Healer
+        if (this.config.model) {
+            this.healer = new healer_1.Healer(this.config.model, {
+                maxSteps: this.config.maxSteps,
+                debugMode: this.config.debugMode,
+                setVariable: this.config.setVariable,
+                getAllVariables: this.config.getAllVariables
+            });
+        }
+    }
+    /**
+     * 执行自愈
+     *
+     * 使用 Healer 通过 ReAct 循环执行自愈任务
+     * - Thought: 分析错误和目标
+     * - Action: 调用 Playwright 工具执行操作
+     * - Observation: 观察工具执行结果
+     * - Reflection: 判断是否继续或结束
+     * - 循环直到成功或达到最大步数
+     */
+    async heal(state) {
+        this.log('[HealAgent] ========== 开始自愈流程 ==========');
+        this.log(`[HealAgent] 目标: ${state.objective}`);
+        this.log(`[HealAgent] 错误: ${state.error}`);
+        this.log(`[HealAgent] 最大步数: ${state.maxSteps || this.config.maxSteps}`);
+        this.log(`[HealAgent] 模式: ${this.healer ? 'LLM Healer' : '未配置'}`);
+        if (!this.healer) {
+            const errorMsg = 'Healer 未初始化，请提供 model 配置';
+            this.log(`[HealAgent] ❌ ${errorMsg}`);
+            return {
+                success: false,
+                errorMessage: errorMsg,
+                reasoning: '未配置模型，无法执行自愈',
+                steps: 0,
+                updatedVariables: {}
+            };
+        }
+        this.log('[HealAgent] 使用 Healer（LLM Agent）');
+        const result = await this.healer.execute(state);
+        this.log(`[HealAgent] 执行结果: ${result.success ? '成功 ✅' : '失败 ❌'}`);
+        this.log(`[HealAgent] 执行步数: ${result.steps}`);
+        this.log('[HealAgent] ========== 自愈流程结束 ==========\n');
+        return result;
+    }
+    /**
+     * 日志输出
+     */
+    log(message) {
+        if (this.config.debugMode) {
+            console.log(message);
+        }
+    }
+}
+exports.HealAgent = HealAgent;
+//# sourceMappingURL=heal-agent.js.map

package/dist/agents/heal-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-agent.js","sourceRoot":"","sources":["../../src/agents/heal-agent.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,qCAAkC;AAElC;;;GAGG;AACH,MAAa,SAAS;IAIpB,YAAY,SAA0B,EAAE;QACtC,IAAI,CAAC,MAAM,GAAG;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;QAEF,uBAAuB;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC1C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAChC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;aAC7C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAC,KAAqB;QAC9B,IAAI,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAElE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,0BAA0B,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;YAEtC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,QAAQ;gBACtB,SAAS,EAAE,cAAc;gBACzB,KAAK,EAAE,CAAC;gBACR,gBAAgB,EAAE,EAAE;aACrB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEhD,IAAI,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAEvD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAxED,8BAwEC"}

package/dist/agents/healer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Healer - 测试自愈代理
+ * 使用 LangChain 的 createAgent API 实现 ReAct 循环
+ *
+ * 参考：https://www.npmjs.com/package/langchain
+ */
+import type { HealAgentState, HealAgentResult } from './types';
+import type { ModelConfig } from '../types/external';
+export declare class Healer {
+    private modelConfig;
+    private maxSteps;
+    private debugMode;
+    private reactSteps;
+    private setVariableCallback?;
+    private getAllVariablesCallback?;
+    constructor(modelConfig: ModelConfig, config?: {
+        maxSteps?: number;
+        debugMode?: boolean;
+        setVariable?: (name: string, value: any) => void;
+        getAllVariables?: () => Record<string, any>;
+    });
+    /**
+     * 默认的 setVariable 方法（当没有提供回调时使用）
+     */
+    private defaultSetVariable;
+    /**
+     * 默认的 getAllVariables 方法（当没有提供回调时使用）
+     */
+    private defaultGetAllVariables;
+    /**
+     * 执行自愈（使用 LangChain createAgent API）
+     */
+    execute(state: HealAgentState): Promise<HealAgentResult>;
+    /**
+     * 记录 Thought 步骤
+     */
+    private recordThoughtStep;
+    /**
+     * 记录 Action 步骤
+     */
+    private recordActionStep;
+    /**
+     * 记录 Observation 步骤
+     */
+    private recordObservationStep;
+    /**
+     * 创建带日志输出的 Playwright 工具
+     */
+    private createPlaywrightToolsWithLogging;
+    /**
+     * 创建 LLM 实例
+     */
+    private createLLM;
+    /**
+     * 构建系统提示
+     */
+    private buildSystemPrompt;
+    /**
+     * 构建用户消息
+     */
+    private buildUserMessage;
+    /**
+     * 判断是否成功
+     * TODO: 后续优化成功判断逻辑，支持更多场景
+     */
+    private isSuccess;
+    /**
+     * 提取推理过程
+     * TODO: 后续优化推理过程提取，支持更详细的分析
+     */
+    private extractReasoning;
+}
+//# sourceMappingURL=healer.d.ts.map

package/dist/agents/healer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healer.d.ts","sourceRoot":"","sources":["../../src/agents/healer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAyDrD,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,mBAAmB,CAAC,CAAqC;IACjE,OAAO,CAAC,uBAAuB,CAAC,CAA4B;gBAEhD,WAAW,EAAE,WAAW,EAAE,MAAM,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAO;IAQ5L;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAoK9D;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,gCAAgC;IA8CxC;;OAEG;IACH,OAAO,CAAC,SAAS;IA4BjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkFzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;;OAGG;IACH,OAAO,CAAC,SAAS;IA6BjB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAmEzB"}