axon-code 2.4.0

package/dist/blueprint/agent-decision-maker.d.ts

@@ -0,0 +1,126 @@
+/**
+ * AgentDecisionMaker - 用 AI Agent 替代硬编码决策
+ *
+ * 核心理念：
+ * - 用 AI 理解上下文，而不是硬编码的正则表达式/关键词匹配
+ *
+ * 功能：
+ * 1. 任务成功判定 - 从非结构化文本中理解执行结果
+ * 2. 错误诊断 - 分析错误原因，决定重试策略
+ *
+ * 已移除的"过度设计"：
+ * - 模型选择：任务分解时已确定 complexity，直接映射即可
+ * - 成本预估：应该是执行后统计，不是拍脑袋预估
+ * - 复杂度评估：任务分解时已确定，不需要 AI 再评估
+ */
+import { ClaudeClient } from '../core/client.js';
+import type { SmartTask, TaskComplexity, Blueprint } from './types.js';
+/** 模型类型 */
+export type ModelType = 'opus' | 'sonnet' | 'haiku';
+/** API 契约判断结果 */
+export interface APIContractDecision {
+    needsContract: boolean;
+    reason: string;
+    frontendModules?: string[];
+    backendModules?: string[];
+}
+/** 任务成功判定结果 */
+export interface TaskVerdictDecision {
+    verdict: 'passed' | 'failed' | 'needs_revision';
+    confidence: 'high' | 'medium' | 'low';
+    reasoning: string;
+    issues?: string[];
+    suggestions?: string[];
+}
+/** 复杂度评估结果 */
+export interface ComplexityDecision {
+    complexity: TaskComplexity;
+    reason: string;
+    factors: {
+        codeChanges: 'minimal' | 'moderate' | 'extensive';
+        integrationPoints: number;
+        testingRequired: boolean;
+        architecturalImpact: 'none' | 'low' | 'medium' | 'high';
+    };
+}
+/** 错误诊断结果 */
+export interface ErrorDiagnosisDecision {
+    errorType: 'timeout' | 'api_error' | 'code_error' | 'environment' | 'unknown';
+    rootCause: string;
+    shouldRetry: boolean;
+    retryStrategy?: 'immediate' | 'with_fix' | 'different_approach';
+    suggestedFix?: string;
+}
+export declare class AgentDecisionMaker {
+    private client;
+    private debug;
+    constructor(client?: ClaudeClient, debug?: boolean);
+    /**
+     * 判断项目是否需要生成 API 契约
+     * 替代: smart-planner.ts:1519-1529 的正则表达式判断
+     */
+    decideAPIContract(blueprint: Blueprint, projectContext?: string): Promise<APIContractDecision>;
+    /**
+     * 判断任务是否成功完成
+     * 替代: task-reviewer.ts:608-614 的关键词匹配
+     */
+    decideTaskVerdict(task: SmartTask, executionOutput: string, expectedOutcome?: string): Promise<TaskVerdictDecision>;
+    /**
+     * 从非结构化文本中解析任务审查结果
+     * 用于当 Reviewer 返回的响应无法解析为 JSON 时，让 AI 重新理解文本含义
+     *
+     * 这比简单的关键词匹配（如 includes('passed')）更可靠，因为：
+     * - "这个任务没有 passed 所需验收标准" 不会被误判为通过
+     * - AI 能理解复杂的语义和上下文
+     */
+    askAgentForVerdict(reviewerResponse: string): Promise<TaskVerdictDecision | null>;
+    /**
+     * 分析任务实际复杂度
+     * 替代: 各处硬编码的 complexity 判断
+     */
+    decideComplexity(taskDescription: string, codeContext?: string): Promise<ComplexityDecision>;
+    /**
+     * 诊断错误原因，决定重试策略
+     * 替代: realtime-coordinator.ts:1284 的关键词匹配
+     */
+    diagnoseError(errorMessage: string, taskContext?: {
+        taskDescription?: string;
+        executionHistory?: string[];
+        retryCount?: number;
+    }): Promise<ErrorDiagnosisDecision>;
+    /**
+     * 判断对话应该进入哪个阶段
+     * 替代: smart-planner.ts 中固定的 switch-case 状态机
+     */
+    decideNextDialogPhase(currentPhase: string, collectedInfo: Record<string, any>, userInput: string): Promise<{
+        nextPhase: string;
+        response: string;
+        missingInfo?: string[];
+    }>;
+    /**
+     * 调用 Agent 获取决策结果
+     * v5.5: 支持工具能力，让蜂王能用 Bash/Read/Grep 等工具来分析代码做决策
+     * v5.7: 添加重试机制，网络抖动时自动重试
+     * @param prompt 提示词
+     * @param model 模型选择
+     * @param useTools 是否启用工具（默认 false，快速决策场景不需要工具）
+     * @param projectPath 项目路径（使用工具时需要）
+     */
+    private askAgent;
+    /**
+     * 判断错误是否可重试
+     * 网络错误、超时、5xx 服务器错误可以重试
+     * 4xx 客户端错误（如 401、400）不重试
+     */
+    private isRetryableError;
+    /**
+     * 从响应中提取文本
+     */
+    private extractTextFromResponse;
+    /**
+     * 从文本中提取 JSON
+     */
+    private extractJSON;
+}
+export declare function getAgentDecisionMaker(debug?: boolean): AgentDecisionMaker;
+//# sourceMappingURL=agent-decision-maker.d.ts.map

package/dist/blueprint/agent-decision-maker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-decision-maker.d.ts","sourceRoot":"","sources":["../../src/blueprint/agent-decision-maker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMvE,WAAW;AACX,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,iBAAiB;AACjB,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,eAAe;AACf,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAChD,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,cAAc;AACd,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,WAAW,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;QAClD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,OAAO,CAAC;QACzB,mBAAmB,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KACzD,CAAC;CACH;AAED,aAAa;AACb,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,oBAAoB,CAAC;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,GAAE,OAAe;IASzD;;;OAGG;IACG,iBAAiB,CACrB,SAAS,EAAE,SAAS,EACpB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC;IAkC/B;;;OAGG;IACG,iBAAiB,CACrB,IAAI,EAAE,SAAS,EACf,eAAe,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAuC/B;;;;;;;OAOG;IACG,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAmCvF;;;OAGG;IACG,gBAAgB,CACpB,eAAe,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,CAAC;IA6C9B;;;OAGG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE;QACZ,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,sBAAsB,CAAC;IAwClC;;;OAGG;IACG,qBAAqB,CACzB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAkDF;;;;;;;;OAQG;YACW,QAAQ;IAuEtB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,WAAW;CAyBpB;AAQD,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,OAAe,GAAG,kBAAkB,CAKhF"}

package/dist/blueprint/agent-decision-maker.js

@@ -0,0 +1,433 @@
+/**
+ * AgentDecisionMaker - 用 AI Agent 替代硬编码决策
+ *
+ * 核心理念：
+ * - 用 AI 理解上下文，而不是硬编码的正则表达式/关键词匹配
+ *
+ * 功能：
+ * 1. 任务成功判定 - 从非结构化文本中理解执行结果
+ * 2. 错误诊断 - 分析错误原因，决定重试策略
+ *
+ * 已移除的"过度设计"：
+ * - 模型选择：任务分解时已确定 complexity，直接映射即可
+ * - 成本预估：应该是执行后统计，不是拍脑袋预估
+ * - 复杂度评估：任务分解时已确定，不需要 AI 再评估
+ */
+import { getDefaultClient } from '../core/client.js';
+import { ConversationLoop } from '../core/loop.js';
+// ============================================================================
+// AgentDecisionMaker 类
+// ============================================================================
+export class AgentDecisionMaker {
+    client;
+    debug;
+    constructor(client, debug = false) {
+        this.client = client || getDefaultClient();
+        this.debug = debug;
+    }
+    // --------------------------------------------------------------------------
+    // 1. API 契约判断 - 替代正则表达式匹配
+    // --------------------------------------------------------------------------
+    /**
+     * 判断项目是否需要生成 API 契约
+     * 替代: smart-planner.ts:1519-1529 的正则表达式判断
+     */
+    async decideAPIContract(blueprint, projectContext) {
+        const prompt = `分析以下项目蓝图，判断是否需要生成前后端 API 契约。
+
+## 项目蓝图
+${JSON.stringify(blueprint, null, 2)}
+
+${projectContext ? `## 项目上下文\n${projectContext}` : ''}
+
+## 判断标准
+1. 是否是前后端分离架构
+2. 是否有需要通过 HTTP/WebSocket 通信的模块
+3. 是否有独立的 API 服务层
+
+## 返回格式（JSON）
+{
+  "needsContract": true/false,
+  "reason": "判断理由",
+  "frontendModules": ["前端模块名称列表，如果有"],
+  "backendModules": ["后端模块名称列表，如果有"]
+}
+
+只返回 JSON，不要其他文字。`;
+        const result = await this.askAgent(prompt, 'haiku');
+        return result || {
+            needsContract: false,
+            reason: 'Agent 无法判断，默认不需要',
+        };
+    }
+    // --------------------------------------------------------------------------
+    // 2. 任务成功判定 - 替代 includes('passed') 字符串匹配
+    // --------------------------------------------------------------------------
+    /**
+     * 判断任务是否成功完成
+     * 替代: task-reviewer.ts:608-614 的关键词匹配
+     */
+    async decideTaskVerdict(task, executionOutput, expectedOutcome) {
+        const prompt = `分析以下任务执行结果，判断任务是否成功完成。
+
+## 任务信息
+- 任务ID: ${task.id}
+- 任务描述: ${task.description}
+- 任务类型: ${task.type}
+- 是否需要测试: ${task.needsTest ? '是' : '否'}
+
+${expectedOutcome ? `## 期望结果\n${expectedOutcome}` : ''}
+
+## 执行输出
+${executionOutput.substring(0, 5000)}${executionOutput.length > 5000 ? '\n...(输出被截断)' : ''}
+
+## 判断标准
+1. 任务目标是否达成
+2. 是否有错误或异常
+3. 输出是否符合预期
+4. 是否需要进一步修改
+
+## 返回格式（JSON）
+{
+  "verdict": "passed" | "failed" | "needs_revision",
+  "confidence": "high" | "medium" | "low",
+  "reasoning": "详细判断理由",
+  "issues": ["发现的问题列表，如果有"],
+  "suggestions": ["改进建议，如果有"]
+}
+
+只返回 JSON，不要其他文字。`;
+        const result = await this.askAgent(prompt, 'sonnet');
+        return result || {
+            verdict: 'needs_revision',
+            confidence: 'low',
+            reasoning: 'Agent 无法判断，需要人工审查',
+        };
+    }
+    /**
+     * 从非结构化文本中解析任务审查结果
+     * 用于当 Reviewer 返回的响应无法解析为 JSON 时，让 AI 重新理解文本含义
+     *
+     * 这比简单的关键词匹配（如 includes('passed')）更可靠，因为：
+     * - "这个任务没有 passed 所需验收标准" 不会被误判为通过
+     * - AI 能理解复杂的语义和上下文
+     */
+    async askAgentForVerdict(reviewerResponse) {
+        const prompt = `分析以下审查员的响应文本，提取任务审查结论。
+
+## 审查员原始响应
+${reviewerResponse.substring(0, 3000)}${reviewerResponse.length > 3000 ? '\n...(内容被截断)' : ''}
+
+## 你的任务
+仔细阅读上述文本，判断审查员的最终结论是：
+- **passed**: 任务成功完成，验收通过
+- **failed**: 任务失败，存在严重问题
+- **needs_revision**: 任务部分完成，需要修改
+
+## 注意事项
+- 关注审查员的**最终结论**，而不是中间讨论
+- 如果文本中提到"通过"但同时列出了必须修复的问题，应判断为 needs_revision
+- 如果无法确定，选择 needs_revision
+
+## 返回格式（JSON）
+{
+  "verdict": "passed" | "failed" | "needs_revision",
+  "confidence": "high" | "medium" | "low",
+  "reasoning": "你的判断依据",
+  "issues": ["从原文中提取的问题列表，如果有"],
+  "suggestions": ["从原文中提取的建议，如果有"]
+}
+
+只返回 JSON，不要其他文字。`;
+        return await this.askAgent(prompt, 'haiku');
+    }
+    // --------------------------------------------------------------------------
+    // 3. 复杂度评估（保留但不常用，任务分解时已确定）
+    // --------------------------------------------------------------------------
+    /**
+     * 分析任务实际复杂度
+     * 替代: 各处硬编码的 complexity 判断
+     */
+    async decideComplexity(taskDescription, codeContext) {
+        const prompt = `分析以下任务的实际复杂度。
+
+## 任务描述
+${taskDescription}
+
+${codeContext ? `## 相关代码上下文\n${codeContext.substring(0, 3000)}` : ''}
+
+## 复杂度级别
+- **trivial**: 单行修改、配置调整、注释添加
+- **simple**: 单文件内的小功能、简单 bug 修复
+- **moderate**: 多文件协调、中等功能、需要测试
+- **complex**: 架构变更、跨模块重构、复杂算法
+
+## 返回格式（JSON）
+{
+  "complexity": "trivial" | "simple" | "moderate" | "complex",
+  "reason": "判断理由",
+  "factors": {
+    "codeChanges": "minimal" | "moderate" | "extensive",
+    "integrationPoints": 涉及的集成点数量,
+    "testingRequired": true/false,
+    "architecturalImpact": "none" | "low" | "medium" | "high"
+  }
+}
+
+只返回 JSON，不要其他文字。`;
+        const result = await this.askAgent(prompt, 'haiku');
+        return result || {
+            complexity: 'moderate',
+            reason: 'Agent 无法判断，使用中等复杂度',
+            factors: {
+                codeChanges: 'moderate',
+                integrationPoints: 1,
+                testingRequired: true,
+                architecturalImpact: 'low',
+            },
+        };
+    }
+    // --------------------------------------------------------------------------
+    // 5. 错误诊断 - 替代 includes('超时') 关键词匹配
+    // --------------------------------------------------------------------------
+    /**
+     * 诊断错误原因，决定重试策略
+     * 替代: realtime-coordinator.ts:1284 的关键词匹配
+     */
+    async diagnoseError(errorMessage, taskContext) {
+        const prompt = `分析以下错误，诊断原因并给出重试建议。
+
+## 错误信息
+${errorMessage}
+
+${taskContext?.taskDescription ? `## 任务描述\n${taskContext.taskDescription}` : ''}
+${taskContext?.executionHistory?.length ? `## 执行历史\n${taskContext.executionHistory.join('\n')}` : ''}
+${taskContext?.retryCount !== undefined ? `## 已重试次数: ${taskContext.retryCount}` : ''}
+
+## 错误类型
+- **timeout**: 执行超时
+- **api_error**: API 调用失败
+- **code_error**: 代码逻辑错误
+- **environment**: 环境配置问题
+- **unknown**: 无法确定
+
+## 返回格式（JSON）
+{
+  "errorType": "timeout" | "api_error" | "code_error" | "environment" | "unknown",
+  "rootCause": "根本原因分析",
+  "shouldRetry": true/false,
+  "retryStrategy": "immediate" | "with_fix" | "different_approach",
+  "suggestedFix": "建议的修复方案，如果有"
+}
+
+只返回 JSON，不要其他文字。`;
+        const result = await this.askAgent(prompt, 'haiku');
+        return result || {
+            errorType: 'unknown',
+            rootCause: 'Agent 无法诊断',
+            shouldRetry: false,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // 6. 对话阶段判断 - 替代固定的状态机
+    // --------------------------------------------------------------------------
+    /**
+     * 判断对话应该进入哪个阶段
+     * 替代: smart-planner.ts 中固定的 switch-case 状态机
+     */
+    async decideNextDialogPhase(currentPhase, collectedInfo, userInput) {
+        const prompt = `作为需求分析助手，根据当前收集的信息，决定下一步应该做什么。
+
+## 当前阶段
+${currentPhase}
+
+## 已收集信息
+${JSON.stringify(collectedInfo, null, 2)}
+
+## 用户最新输入
+${userInput}
+
+## 可用阶段
+- greeting: 初次问候，了解项目大概
+- requirements: 收集核心需求
+- clarification: 澄清模糊点
+- tech_choice: 确认技术选型
+- confirmation: 确认蓝图
+- done: 完成
+
+## 判断原则
+1. 如果核心需求已清晰，可以跳过不必要的阶段
+2. 如果用户提供了足够信息，直接进入下一步
+3. 如果有关键信息缺失，停留在当前阶段追问
+
+## 返回格式（JSON）
+{
+  "nextPhase": "下一阶段名称",
+  "response": "给用户的回复",
+  "missingInfo": ["缺失的关键信息，如果有"]
+}
+
+只返回 JSON，不要其他文字。`;
+        const result = await this.askAgent(prompt, 'sonnet');
+        return result || {
+            nextPhase: currentPhase,
+            response: '请继续描述您的需求。',
+        };
+    }
+    // --------------------------------------------------------------------------
+    // 内部方法
+    // --------------------------------------------------------------------------
+    /**
+     * 调用 Agent 获取决策结果
+     * v5.5: 支持工具能力，让蜂王能用 Bash/Read/Grep 等工具来分析代码做决策
+     * v5.7: 添加重试机制，网络抖动时自动重试
+     * @param prompt 提示词
+     * @param model 模型选择
+     * @param useTools 是否启用工具（默认 false，快速决策场景不需要工具）
+     * @param projectPath 项目路径（使用工具时需要）
+     */
+    async askAgent(prompt, model, useTools = false, projectPath) {
+        const MAX_RETRIES = 3;
+        const INITIAL_DELAY_MS = 1000;
+        for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                if (this.debug) {
+                    console.log(`[AgentDecisionMaker] Asking ${model} (tools=${useTools}, attempt=${attempt}/${MAX_RETRIES}):`, prompt.substring(0, 200));
+                }
+                const systemPrompt = `你是一个专业的技术决策助手。
+${useTools ? '你可以使用工具来分析代码、检查文件，获取更准确的信息来做决策。' : ''}
+你的最终回答必须是有效的 JSON 格式，不要包含任何其他文字。`;
+                let text;
+                if (useTools && projectPath) {
+                    // v5.5: 使用 ConversationLoop，赋予蜂王工具能力
+                    const loop = new ConversationLoop({
+                        model,
+                        maxTurns: 5, // 蜂王决策不需要太多轮
+                        verbose: false,
+                        permissionMode: 'bypassPermissions',
+                        workingDir: projectPath,
+                        systemPrompt,
+                        isSubAgent: true,
+                        allowedTools: ['Read', 'Glob', 'Grep', 'Bash', 'LS'], // 只读工具 + Bash
+                    });
+                    text = await loop.processMessage(prompt);
+                }
+                else {
+                    // 快速决策模式：直接调用 API，不使用工具
+                    const response = await this.client.createMessage([{ role: 'user', content: prompt }], undefined, systemPrompt);
+                    text = this.extractTextFromResponse(response);
+                }
+                const json = this.extractJSON(text);
+                if (this.debug) {
+                    console.log('[AgentDecisionMaker] Response:', json);
+                }
+                return json;
+            }
+            catch (error) {
+                const isRetryable = this.isRetryableError(error);
+                console.error(`[AgentDecisionMaker] Error (attempt ${attempt}/${MAX_RETRIES}, retryable=${isRetryable}):`, error.message);
+                if (!isRetryable || attempt === MAX_RETRIES) {
+                    // 不可重试的错误，或已达到最大重试次数
+                    return null;
+                }
+                // 指数退避等待
+                const delayMs = INITIAL_DELAY_MS * Math.pow(2, attempt - 1);
+                console.log(`[AgentDecisionMaker] Retrying in ${delayMs}ms...`);
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+            }
+        }
+        return null;
+    }
+    /**
+     * 判断错误是否可重试
+     * 网络错误、超时、5xx 服务器错误可以重试
+     * 4xx 客户端错误（如 401、400）不重试
+     */
+    isRetryableError(error) {
+        const message = error.message?.toLowerCase() || '';
+        // 网络相关错误
+        if (message.includes('connection') ||
+            message.includes('network') ||
+            message.includes('timeout') ||
+            message.includes('econnrefused') ||
+            message.includes('econnreset') ||
+            message.includes('socket') ||
+            message.includes('etimedout')) {
+            return true;
+        }
+        // HTTP 5xx 错误
+        if (message.includes('500') ||
+            message.includes('502') ||
+            message.includes('503') ||
+            message.includes('504') ||
+            message.includes('overloaded') ||
+            message.includes('rate limit')) {
+            return true;
+        }
+        // HTTP 4xx 错误不重试
+        if (message.includes('400') ||
+            message.includes('401') ||
+            message.includes('403') ||
+            message.includes('404') ||
+            message.includes('invalid') ||
+            message.includes('unauthorized')) {
+            return false;
+        }
+        // 默认重试（乐观策略）
+        return true;
+    }
+    /**
+     * 从响应中提取文本
+     */
+    extractTextFromResponse(response) {
+        if (typeof response === 'string')
+            return response;
+        if (response?.content) {
+            if (Array.isArray(response.content)) {
+                return response.content
+                    .filter((block) => block.type === 'text')
+                    .map((block) => block.text)
+                    .join('');
+            }
+            return String(response.content);
+        }
+        return JSON.stringify(response);
+    }
+    /**
+     * 从文本中提取 JSON
+     */
+    extractJSON(text) {
+        // 尝试直接解析
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // 尝试提取 JSON 块
+            const jsonMatch = text.match(/```json\s*([\s\S]*?)```/);
+            if (jsonMatch) {
+                return JSON.parse(jsonMatch[1]);
+            }
+            // 尝试提取 {} 或 [] 包裹的内容
+            const objectMatch = text.match(/\{[\s\S]*\}/);
+            if (objectMatch) {
+                return JSON.parse(objectMatch[0]);
+            }
+            const arrayMatch = text.match(/\[[\s\S]*\]/);
+            if (arrayMatch) {
+                return JSON.parse(arrayMatch[0]);
+            }
+            throw new Error('Unable to extract JSON from response');
+        }
+    }
+}
+// ============================================================================
+// 导出单例
+// ============================================================================
+let defaultInstance = null;
+export function getAgentDecisionMaker(debug = false) {
+    if (!defaultInstance) {
+        defaultInstance = new AgentDecisionMaker(undefined, debug);
+    }
+    return defaultInstance;
+}
+//# sourceMappingURL=agent-decision-maker.js.map

package/dist/blueprint/agent-decision-maker.js.map

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