@bolloon/bolloon-agent 0.4.27 → 0.4.29

package/dist/electron-build/agents/error-classifier.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * error-classifier.ts — 工具错误分类 + 反射引擎
+ *
+ * 分层:
+ *   1. classifyError: 原始 error string → ErrorClass
+ *   2. buildObservation: 工具结果 → 结构化 Observation
+ *   3. buildReflection: 错误历史 → 替代策略建议
+ *   4. suggestEscalation: 阶梯升档: 重试→换参数→换工具→简化→放弃
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyError = classifyError;
+exports.buildObservation = buildObservation;
+exports.buildReflection = buildReflection;
+exports.formatObservationWithReflection = formatObservationWithReflection;
+const ERROR_SIGNATURES = [
+    { pattern: /unknown tool|未知工具|tool.*not found|is not a function/i, cls: 'tool_not_found', label: '工具不存在' },
+    { pattern: /PreToolUse 拒绝|Harness.*拒绝|permission|not allowed|denied/i, cls: 'permission_denied', label: '权限拒绝' },
+    { pattern: /ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENOTFOUND|network|connect.*fail|fetch.*fail/i, cls: 'network_error', label: '网络错误' },
+    { pattern: /timeout|timed out/i, cls: 'timeout', label: '执行超时' },
+    { pattern: /ENOENT|not found|no such file|does not exist|invalid path|bad argument|ERR_INVALID/i, cls: 'bad_input', label: '参数错误' },
+    { pattern: /401|403|quota|rate limit|API key|unauthorized|authentication/i, cls: 'api_error', label: 'API 认证错误' },
+];
+function classifyError(errorMsg) {
+    if (!errorMsg)
+        return { cls: 'unknown', label: '未知错误', severity: 'medium', recoverable: true };
+    for (const sig of ERROR_SIGNATURES) {
+        if (sig.pattern.test(errorMsg)) {
+            const severity = sig.cls === 'api_error' ? 'high'
+                : sig.cls === 'internal_error' ? 'high'
+                    : sig.cls === 'permission_denied' ? 'high'
+                        : sig.cls === 'tool_not_found' ? 'low'
+                            : sig.cls === 'bad_input' ? 'low'
+                                : 'medium';
+            const recoverable = sig.cls !== 'api_error' && sig.cls !== 'permission_denied';
+            return { cls: sig.cls, label: sig.label, severity, recoverable };
+        }
+    }
+    return { cls: 'unknown', label: '未知错误', severity: 'medium', recoverable: true };
+}
+function buildObservation(tool, args, result) {
+    const obs = { tool, args, success: result.success, summary: '' };
+    if (result.success) {
+        const output = result.output || '(无输出)';
+        obs.output = output;
+        obs.summary = `✅ ${tool} 成功 (${output.length}B)`;
+    }
+    else {
+        const errMsg = result.error || '未知失败';
+        const cls = classifyError(errMsg);
+        obs.errorClass = cls.cls;
+        obs.errorLabel = cls.label;
+        obs.summary = `❌ ${tool} 失败: ${cls.label} — ${errMsg.slice(0, 120)}`;
+    }
+    return obs;
+}
+const ERROR_TO_STRATEGIES = {
+    tool_not_found: [
+        { action: 'change_tool', reason: '工具名不存在', detail: '用 list_tools 查可用工具, 使用正确的工具名' },
+        { action: 'retry', reason: '可能是别名没匹配上', detail: '尝试用标准工具名重新调用, 如 shell_exec 而非 bash' },
+    ],
+    permission_denied: [
+        { action: 'change_tool', reason: '当前工具被权限系统阻止', detail: '尝试用其他方式完成目标, 如 read_file 替代 shell_exec cat' },
+        { action: 'simplify_goal', reason: '权限持续拒绝', detail: '缩小操作范围, 选择不需要高权限的操作' },
+    ],
+    network_error: [
+        { action: 'retry', reason: '网络偶发故障', detail: '等待 2-3 秒后重试, LLM 会自动降速' },
+        { action: 'change_tool', reason: '网络不可用', detail: '尝试本地操作替代网络请求' },
+    ],
+    timeout: [
+        { action: 'retry', reason: '可能暂时性负载高', detail: '简化参数后重试, 或分多次执行' },
+        { action: 'change_tool', reason: '工具执行时间过长', detail: '换一个更轻量的工具' },
+    ],
+    bad_input: [
+        { action: 'change_params', reason: '参数格式不对', detail: '检查参数格式: 路径用绝对路径, 空格用引号包裹' },
+        { action: 'retry', reason: '参数调整后重试', detail: '用正确的参数重新调用' },
+    ],
+    api_error: [
+        { action: 'simplify_goal', reason: 'API 认证失败', detail: '检查 API 配置或使用已有的本地能力完成' },
+        { action: 'abandon', reason: 'API 不可恢复', detail: 'API key 或配额问题无法自动解决, 告知用户' },
+    ],
+    internal_error: [
+        { action: 'change_tool', reason: '工具内部异常', detail: '换另一种方式处理' },
+        { action: 'simplify_goal', reason: '工具无法正常工作', detail: '尝试用更简单的方式完成任务' },
+    ],
+    unknown: [
+        { action: 'retry', reason: '错误类型不确定', detail: '换个方式或参数再试一次' },
+        { action: 'change_tool', reason: '原方法不可行', detail: '尝试用其他工具组合达成目标' },
+    ],
+};
+function buildReflection(toolName, errorMsg, errorCount, sameToolFailCount) {
+    if (!errorMsg)
+        return ERROR_TO_STRATEGIES.unknown.slice(0, 1);
+    const cls = classifyError(errorMsg);
+    // 阶梯升档: 根据连续失败次数选择更激进的策略
+    if (sameToolFailCount >= 3) {
+        return [
+            { action: 'abandon', reason: `工具 ${toolName} 连续失败 ${sameToolFailCount} 次`, detail: '放弃这个工具, 用其他方法或直接给用户已知信息' },
+            { action: 'simplify_goal', reason: '工具不可用', detail: '简化任务, 给出已成功执行的部分结果' },
+        ];
+    }
+    if (errorCount >= 5) {
+        return [
+            { action: 'simplify_goal', reason: `累计 ${errorCount} 次错误`, detail: '放弃复杂操作, 用已有知识回答用户' },
+        ];
+    }
+    return ERROR_TO_STRATEGIES[cls.cls] || ERROR_TO_STRATEGIES.unknown;
+}
+// ==================== 格式化为 system prompt 注入 ====================
+/**
+ * 把 Observation + Reflection 格式化成一条 system 消息,
+ * 注入到 messageHistory 中让 LLM 下一轮能看到.
+ */
+function formatObservationWithReflection(obs, reflection) {
+    const lines = [];
+    lines.push(`[工具结果] ${obs.summary}`);
+    if (!obs.success && reflection.length > 0) {
+        lines.push(`[Reflection] 推荐策略:`);
+        for (const r of reflection.slice(0, 2)) {
+            lines.push(`  - ${r.action}: ${r.reason}. ${r.detail}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/electron-build/agents/error-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.js","sourceRoot":"","sources":["../../../src/agents/error-classifier.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;AAcH,MAAM,gBAAgB,GAA+D;IACnF,EAAE,OAAO,EAAE,sDAAsD,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE;IAC1G,EAAE,OAAO,EAAE,0DAA0D,EAAE,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE;IAChH,EAAE,OAAO,EAAE,gFAAgF,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE;IAClI,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;IAChE,EAAE,OAAO,EAAE,qFAAqF,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE;IACnI,EAAE,OAAO,EAAE,+DAA+D,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE;CAClH,CAAC;AASF,uBAA8B,QAAgB;IAC5C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/F,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM;gBAC/C,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,gBAAgB,CAAC,CAAC,CAAC,MAAM;oBACvC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC,CAAC,MAAM;wBAC1C,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK;4BACtC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK;gCACjC,CAAC,CAAC,QAAQ,CAAC;YACb,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,GAAG,KAAK,mBAAmB,CAAC;YAC/E,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAClF,CAAC;AAeD,0BACE,IAAY,EACZ,IAA4B,EAC5B,MAA6D;IAE7D,MAAM,GAAG,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC9E,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC;QACxC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,CAAC,OAAO,GAAG,KAAK,IAAI,QAAQ,MAAM,CAAC,MAAM,IAAI,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;QACtC,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC;QACzB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC;QAC3B,GAAG,CAAC,OAAO,GAAG,KAAK,IAAI,QAAQ,GAAG,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAUD,MAAM,mBAAmB,GAA6C;IACpE,cAAc,EAAE;QACd,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,8BAA8B,EAAE;QACnF,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,oCAAoC,EAAE;KACvF;IACD,iBAAiB,EAAE;QACjB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,4CAA4C,EAAE;QACtG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,qBAAqB,EAAE;KAC7E;IACD,aAAa,EAAE;QACb,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,wBAAwB,EAAE;QACvE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE;KACnE;IACD,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE;QAClE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE;KACnE;IACD,SAAS,EAAE;QACT,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,0BAA0B,EAAE;QACjF,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE;KAC7D;IACD,SAAS,EAAE;QACT,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,uBAAuB,EAAE;QAChF,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,2BAA2B,EAAE;KAC/E;IACD,cAAc,EAAE;QACd,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE;QAC/D,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE;KACzE;IACD,OAAO,EAAE;QACP,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE;QAC7D,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE;KACrE;CACF,CAAC;AAEF,yBACE,QAAgB,EAChB,QAA4B,EAC5B,UAAkB,EAClB,iBAAyB;IAEzB,IAAI,CAAC,QAAQ;QAAE,OAAO,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEpC,yBAAyB;IACzB,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAAQ,SAAS,iBAAiB,IAAI,EAAE,MAAM,EAAE,yBAAyB,EAAE;YAC9G,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE;SAC3E,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE;SACzF,CAAC;IACJ,CAAC;IAED,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,OAAO,CAAC;AACrE,CAAC;AAED,kEAAkE;AAElE;;;GAGG;AACH,yCACE,GAAgB,EAChB,UAAgC;IAEhC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}