@cicctencent/agent-core 0.1.28 → 0.1.31

package/dist/cjs/agent/rate-limit-manager.js

@@ -0,0 +1,465 @@
+"use strict";
+// ============================================================
+// RateLimitManager — 全局速率限制 + 子 Agent 并发控制
+// ============================================================
+//
+// 解决 delegate_task 并发风暴导致的 LLM API TPM 限流（429）问题。
+//
+// 三级递进策略（与 omniinsight-bi AgentService 中的实现等价）：
+// 1. 容忍期：短时间内收到少量 429 时仅记录，让 LLM 层重试/降级自行处理
+// 2. 冷却期：达到阈值后进入指数退避冷却（30s → 60s → 120s），
+//            期间新建子 Agent 排队等待，已有子 Agent 继续运行
+// 3. 终止期：冷却周期超过上限后终止整个主会话（避免无限循环）
+//
+// 并发控制：
+// - MAX_CONCURRENT_SUB_SESSIONS 限制同时运行的子 Agent 数量
+// - 超出上限时新请求进入等待队列，超时则拒绝
+//
+// 生命周期追踪：
+// - registerMainSession / unregisterMainSession：由 AgentEngine.run() 调用
+// - registerSubSession / unregisterSubSession：由 AgentEngine.linkChildSession() 调用
+// - 子 Agent 完成时通过 releaseSubSessionSlot 释放槽位并唤醒队列
+//
+// 注意：本模块为进程级单例，跨所有 AgentEngine 实例共享状态，
+//       因为 TPM 限制是 LLM API 层面的，所有 Engine 共享同一个 LLMProvider。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RATE_LIMIT_CONFIG = exports.RateLimitManager = exports.rateLimitManager = void 0;
+const logger_ts_1 = require("../observability/logger.js");
+/** 速率限制触发阈值：在短时间内收到这么多 429 即触发冷却 */
+const RATE_LIMIT_THRESHOLD = 3;
+/** 初始冷却时长（ms），后续每次翻倍 */
+const COOLDOWN_BASE_MS = 30_000;
+/** 最大冷却周期数：超过此值后终止整个主会话 */
+const MAX_COOLDOWN_CYCLES = 3;
+/** 最大并发子 Agent 数 */
+const MAX_CONCURRENT_SUB_SESSIONS = 3;
+/** 子 Agent 排队最大等待时间（ms），超时则拒绝 */
+const SUB_SESSION_WAIT_TIMEOUT = 120_000;
+/**
+ * 全局速率限制 + 并发控制管理器（单例）
+ */
+class RateLimitManager {
+    // ══════ 限流状态 ══════
+    /** 是否正在冷却中 */
+    cooldown = false;
+    /** 冷却结束时间（ms 时间戳） */
+    cooldownUntil = 0;
+    /** 连续 429 计数（同一冷却周期内累计） */
+    count429 = 0;
+    /** 冷却周期数（每次触发冷却递增，用于指数退避） */
+    cooldownCycles = 0;
+    // ══════ 并发控制 ══════
+    /** 当前活跃的子 Agent 数量 */
+    activeSubSessionCount = 0;
+    /** 已注册但尚未释放的子会话集合（防止重复释放） */
+    activeSubSessionSet = new Set();
+    /** 并发控制等待队列 */
+    waitQueue = [];
+    // ══════ 父子会话映射 ══════
+    /** 子会话 ID → 父会话 ID */
+    parentMap = new Map();
+    /** 主会话 ID → AbortController（用于在多轮冷却失败时终止主会话） */
+    mainSessionControllers = new Map();
+    /** 已终止的主会话 ID（防止重复 abort） */
+    abortedSessions = new Set();
+    // ───────── 主会话生命周期 ─────────
+    /**
+     * 注册主会话。由 AgentEngine.run() 在开始时调用。
+     *
+     * @param sessionId 主会话 ID
+     * @param controller 引擎内部 AbortController，RateLimitManager 在多轮冷却失败时
+     *                   可调用 controller.abort() 终止主会话
+     */
+    registerMainSession(sessionId, controller) {
+        this.mainSessionControllers.set(sessionId, controller);
+    }
+    /**
+     * 注销主会话。由 AgentEngine.run() 在 finally 中调用。
+     * 清理该主会话下的所有子会话映射并唤醒等待队列。
+     */
+    unregisterMainSession(sessionId) {
+        this.mainSessionControllers.delete(sessionId);
+        this.abortedSessions.delete(sessionId);
+        // 清理该主会话下的所有子会话映射（sessionId 作为 parent）
+        for (const [subId, parentId] of this.parentMap) {
+            if (parentId === sessionId) {
+                this.parentMap.delete(subId);
+                // 子会话可能仍在活跃集合中（异常退出未正常释放）
+                if (this.activeSubSessionSet.has(subId)) {
+                    this.activeSubSessionSet.delete(subId);
+                    if (this.activeSubSessionCount > 0)
+                        this.activeSubSessionCount--;
+                }
+            }
+        }
+        // 兜底：清理 sessionId 作为 child 的条目（子 engine run() 结束时自动清理自身映射）
+        // 注意：不递减 activeSubSessionCount，因为并发槽位由 tool-executor 的
+        // releaseSubSessionSlot 管理（使用临时 subslot ID，不是实际的 sessionId）
+        this.parentMap.delete(sessionId);
+        this.activeSubSessionSet.delete(sessionId);
+        // 如果已经没有任何活跃主会话，重置全局限流状态
+        if (this.mainSessionControllers.size === 0) {
+            this.resetGlobal();
+        }
+        else {
+            // 仍有其他主会话在运行，尝试唤醒排队
+            this.drainQueue();
+        }
+    }
+    // ───────── 子会话生命周期 ─────────
+    /**
+     * 注册子会话。由 AgentEngine.linkChildSession() 调用。
+     *
+     * 注意：此方法仅建立父子映射，不增加并发计数。
+     * 并发计数在 acquireSubSessionSlot() 中完成。
+     */
+    registerSubSession(childId, parentId) {
+        this.parentMap.set(childId, parentId);
+    }
+    /**
+     * 注销子会话。由 AgentEngine.unlinkChildSession() 调用。
+     * 同时释放并发槽位并唤醒等待队列。
+     */
+    unregisterSubSession(childId) {
+        const wasActive = this.activeSubSessionSet.has(childId);
+        this.activeSubSessionSet.delete(childId);
+        this.parentMap.delete(childId);
+        if (wasActive) {
+            if (this.activeSubSessionCount > 0)
+                this.activeSubSessionCount--;
+            this.drainQueue();
+        }
+    }
+    // ───────── 并发槽位 ─────────
+    /**
+     * 获取子 Agent 执行槽位（并发控制）。
+     *
+     * 在 delegate_task 工具执行前调用，确保同时运行的子 Agent 不超过上限。
+     * - 冷却期内自动等待冷却结束
+     * - 并发槽位满时排队等待，超时则拒绝
+     *
+     * 注意：本方法会增加 activeSubSessionCount。调用方在子 Agent 结束后
+     * 必须调用 releaseSubSessionSlot() 或 unregisterSubSession() 释放槽位。
+     *
+     * @param sessionId 子会话 ID（用于在父会话 abort 时提前退出等待）
+     * @returns true 表示获得槽位可以执行，false 表示超时或被拒绝
+     */
+    async acquireSubSessionSlot(sessionId) {
+        // ① 如果处于冷却期，等待冷却结束
+        if (this.cooldown) {
+            const remaining = Math.max(0, this.cooldownUntil - Date.now());
+            if (remaining > 0) {
+                if (remaining > SUB_SESSION_WAIT_TIMEOUT) {
+                    (0, logger_ts_1.logEvent)({
+                        event: 'rate_limit.cooldown_too_long',
+                        level: 'warn',
+                        sessionId,
+                        data: { remaining, max: SUB_SESSION_WAIT_TIMEOUT },
+                    });
+                    return false;
+                }
+                await this.waitCooldown(remaining, sessionId);
+                // 等待期间父会话可能已 abort
+                if (sessionId && this.isParentAborted(sessionId)) {
+                    return false;
+                }
+            }
+        }
+        // ② 检查并发槽位
+        if (this.activeSubSessionCount >= MAX_CONCURRENT_SUB_SESSIONS) {
+            const granted = await this.waitForSlot(sessionId);
+            if (!granted)
+                return false;
+            // 等待期间父会话可能已 abort
+            if (sessionId && this.isParentAborted(sessionId)) {
+                // 释放刚刚获得的槽位
+                this.releaseSubSessionSlot();
+                return false;
+            }
+        }
+        // ③ 获得槽位
+        this.activeSubSessionCount++;
+        if (sessionId)
+            this.activeSubSessionSet.add(sessionId);
+        return true;
+    }
+    /**
+     * 释放子 Agent 执行槽位。
+     *
+     * 由 delegate_task 工具执行结束（无论成功或失败）后调用。
+     * 唤醒等待队列中的下一个子 Agent。
+     */
+    releaseSubSessionSlot(sessionId) {
+        if (sessionId)
+            this.activeSubSessionSet.delete(sessionId);
+        if (this.activeSubSessionCount > 0)
+            this.activeSubSessionCount--;
+        this.drainQueue();
+    }
+    // ───────── 429 速率限制处理 ─────────
+    /**
+     * 处理 429 速率限制事件。
+     *
+     * 由 LLMCaller 在捕获 429 错误时调用。
+     *
+     * 三级递进策略：
+     * 1. 容忍期（< 阈值）：仅记录，让 LLM 层重试/降级自行处理
+     * 2. 冷却期（≥ 阈值）：触发指数退避冷却，新子 Agent 排队等待
+     * 3. 终止期（冷却周期超过上限）：终止整个主会话
+     */
+    handleRateLimited(sessionId) {
+        this.count429++;
+        // 解析父主会话 ID
+        const parentSessionId = this.parentMap.get(sessionId) || sessionId;
+        // 已处于冷却期：仅记录，让冷却计时自然结束
+        if (this.cooldown) {
+            (0, logger_ts_1.logEvent)({
+                event: 'rate_limit.429_during_cooldown',
+                level: 'warn',
+                sessionId,
+                data: {
+                    count429: this.count429,
+                    cooldownRemaining: Math.max(0, this.cooldownUntil - Date.now()),
+                    parentSessionId,
+                },
+            });
+            return;
+        }
+        // 未冷却：检查是否达到触发阈值
+        if (this.count429 >= RATE_LIMIT_THRESHOLD) {
+            this.startCooldown();
+            // 检查冷却周期是否超过上限 → 终止主会话
+            if (this.cooldownCycles >= MAX_COOLDOWN_CYCLES) {
+                this.abortMainSession(parentSessionId);
+                this.resetForSession(parentSessionId);
+            }
+            else {
+                (0, logger_ts_1.logEvent)({
+                    event: 'rate_limit.cooldown_started',
+                    level: 'warn',
+                    sessionId,
+                    data: {
+                        cycle: this.cooldownCycles,
+                        durationMs: this.getCooldownDuration(),
+                        count429: this.count429,
+                        activeSubSessions: this.activeSubSessionCount,
+                    },
+                });
+            }
+        }
+        else {
+            // 未达到阈值，仅记录
+            (0, logger_ts_1.logEvent)({
+                event: 'rate_limit.429_observed',
+                level: 'warn',
+                sessionId,
+                data: { count429: this.count429, threshold: RATE_LIMIT_THRESHOLD },
+            });
+        }
+    }
+    // ───────── 查询 API ─────────
+    /** 是否处于冷却期 */
+    isCooling() {
+        return this.cooldown;
+    }
+    /** 是否已达到并发上限或正在冷却（用于快速拒绝新请求） */
+    isRateLimitedOrSaturated() {
+        return this.cooldown || this.activeSubSessionCount >= MAX_CONCURRENT_SUB_SESSIONS;
+    }
+    /** 获取当前状态快照（诊断用） */
+    getStats() {
+        return {
+            cooldown: this.cooldown,
+            cooldownRemainingMs: Math.max(0, this.cooldownUntil - Date.now()),
+            count429: this.count429,
+            cooldownCycles: this.cooldownCycles,
+            activeSubSessions: this.activeSubSessionCount,
+            maxConcurrent: MAX_CONCURRENT_SUB_SESSIONS,
+            queueLength: this.waitQueue.length,
+        };
+    }
+    // ───────── 内部实现 ─────────
+    /** 启动速率限制冷却期（指数退避） */
+    startCooldown() {
+        this.cooldown = true;
+        this.cooldownCycles++;
+        const duration = this.getCooldownDuration();
+        this.cooldownUntil = Date.now() + duration;
+        setTimeout(() => {
+            this.cooldown = false;
+            this.count429 = 0;
+            (0, logger_ts_1.logEvent)({
+                event: 'rate_limit.cooldown_ended',
+                level: 'info',
+                data: { cycle: this.cooldownCycles },
+            });
+            // 唤醒排队中的子 Agent
+            this.drainQueue();
+        }, duration);
+    }
+    /** 获取当前冷却时长（指数退避：30s → 60s → 120s） */
+    getCooldownDuration() {
+        return COOLDOWN_BASE_MS * Math.pow(2, this.cooldownCycles - 1);
+    }
+    /** 终止指定主会话 */
+    abortMainSession(sessionId) {
+        if (this.abortedSessions.has(sessionId))
+            return;
+        this.abortedSessions.add(sessionId);
+        const controller = this.mainSessionControllers.get(sessionId);
+        if (controller && !controller.signal.aborted) {
+            controller.abort(new Error(`TPM rate limit — ${this.cooldownCycles} cooldown cycles exhausted`));
+            (0, logger_ts_1.logEvent)({
+                event: 'rate_limit.main_session_aborted',
+                level: 'error',
+                sessionId,
+                data: {
+                    cooldownCycles: this.cooldownCycles,
+                    count429: this.count429,
+                },
+            });
+        }
+    }
+    /** 等待冷却期结束 */
+    waitCooldown(remainingMs, sessionId) {
+        return new Promise(resolve => {
+            const timer = setTimeout(resolve, remainingMs);
+            // 主会话被 abort 时提前退出等待
+            if (sessionId) {
+                const parentId = this.parentMap.get(sessionId) || sessionId;
+                const controller = this.mainSessionControllers.get(parentId);
+                if (controller && !controller.signal.aborted) {
+                    const onAbort = () => {
+                        clearTimeout(timer);
+                        resolve();
+                    };
+                    controller.signal.addEventListener('abort', onAbort, { once: true });
+                }
+            }
+        });
+    }
+    /** 等待并发槽位（带超时） */
+    waitForSlot(sessionId) {
+        return new Promise(resolve => {
+            const item = { resolve, sessionId };
+            // 排队超时
+            item.timeoutId = setTimeout(() => {
+                const idx = this.waitQueue.indexOf(item);
+                if (idx !== -1)
+                    this.waitQueue.splice(idx, 1);
+                (0, logger_ts_1.logEvent)({
+                    event: 'rate_limit.slot_wait_timeout',
+                    level: 'warn',
+                    sessionId,
+                    data: { timeout: SUB_SESSION_WAIT_TIMEOUT },
+                });
+                resolve(false);
+            }, SUB_SESSION_WAIT_TIMEOUT);
+            // 主会话被 abort 时立即退出等待
+            if (sessionId) {
+                const parentId = this.parentMap.get(sessionId) || sessionId;
+                const controller = this.mainSessionControllers.get(parentId);
+                if (controller && !controller.signal.aborted) {
+                    item.abortListener = () => {
+                        if (item.timeoutId)
+                            clearTimeout(item.timeoutId);
+                        const idx = this.waitQueue.indexOf(item);
+                        if (idx !== -1)
+                            this.waitQueue.splice(idx, 1);
+                        resolve(false);
+                    };
+                    controller.signal.addEventListener('abort', item.abortListener, { once: true });
+                }
+            }
+            this.waitQueue.push(item);
+        });
+    }
+    /** 唤醒排队中的子 Agent，直到并发槽位用尽或队列空 */
+    drainQueue() {
+        while (this.activeSubSessionCount < MAX_CONCURRENT_SUB_SESSIONS &&
+            this.waitQueue.length > 0 &&
+            !this.cooldown) {
+            const item = this.waitQueue.shift();
+            if (!item)
+                continue;
+            // 清理定时器和 abort 监听器
+            if (item.timeoutId)
+                clearTimeout(item.timeoutId);
+            if (item.abortListener && item.sessionId) {
+                const parentId = this.parentMap.get(item.sessionId) || item.sessionId;
+                const controller = this.mainSessionControllers.get(parentId);
+                if (controller) {
+                    controller.signal.removeEventListener('abort', item.abortListener);
+                }
+            }
+            try {
+                item.resolve(true);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    /** 检查指定子会话的父主会话是否已被 abort */
+    isParentAborted(sessionId) {
+        const parentId = this.parentMap.get(sessionId) || sessionId;
+        const controller = this.mainSessionControllers.get(parentId);
+        return !!controller?.signal.aborted;
+    }
+    /** 重置全局限流状态（无活跃主会话时调用） */
+    resetGlobal() {
+        this.cooldown = false;
+        this.cooldownUntil = 0;
+        this.count429 = 0;
+        this.cooldownCycles = 0;
+        this.activeSubSessionCount = 0;
+        this.activeSubSessionSet.clear();
+        this.parentMap.clear();
+        this.abortedSessions.clear();
+        // 唤醒所有排队项（拒绝，因为已无主会话）
+        const queue = this.waitQueue;
+        this.waitQueue = [];
+        for (const item of queue) {
+            if (item.timeoutId)
+                clearTimeout(item.timeoutId);
+            try {
+                item.resolve(false);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    /** 重置指定主会话相关的限流状态 */
+    resetForSession(sessionId) {
+        this.cooldown = false;
+        this.cooldownUntil = 0;
+        this.count429 = 0;
+        this.cooldownCycles = 0;
+        // 唤醒所有排队项（主会话被终止，全部拒绝）
+        const queue = this.waitQueue;
+        this.waitQueue = [];
+        for (const item of queue) {
+            if (item.timeoutId)
+                clearTimeout(item.timeoutId);
+            try {
+                item.resolve(false);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+exports.RateLimitManager = RateLimitManager;
+/** 全局单例（跨所有 AgentEngine 实例共享） */
+exports.rateLimitManager = new RateLimitManager();
+/** 导出常量供外部读取（不可修改） */
+exports.RATE_LIMIT_CONFIG = {
+    RATE_LIMIT_THRESHOLD,
+    COOLDOWN_BASE_MS,
+    MAX_COOLDOWN_CYCLES,
+    MAX_CONCURRENT_SUB_SESSIONS,
+    SUB_SESSION_WAIT_TIMEOUT,
+};
+//# sourceMappingURL=rate-limit-manager.js.map

package/dist/cjs/agent/rate-limit-manager.js.map

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

package/dist/cjs/agent/tool-executor.d.ts

@@ -74,6 +74,17 @@ export declare class AgentToolExecutor {
     private executeOneToolCall;
     /** 带超时的工具执行 */
     private runWithTimeout;
+    /**
+     * 执行非 delegate_task 工具（带超时），从 runWithTimeout 抽取以保持逻辑清晰
+     */
+    private executeToolWithTimeout;
+    /**
+     * 执行 delegate_task（带超时 + 子 Agent AbortController）
+     *
+     * 与普通工具不同，delegate_task 的超时会同时 abort 子 Agent，
+     * 防止子 Agent 在父级超时后继续运行导致资源泄漏。
+     */
+    private executeDelegateWithTimeout;
     private emitUnavailableToolResult;
     /** 检查工具是否被熔断 */
     private isCircuitBroken;

package/dist/cjs/agent/tool-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../../src/agent/tool-executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAa,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,aAAa;AACb,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,oBAAoB;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,sBAAsB,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3G,YAAY;IACZ,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY;IACZ,aAAa,EAAE,MAAM,UAAU,EAAE,GAAG,SAAS,CAAC;CAC/C;AAQD,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,eAAe,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAqB;IAEnC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IAEtD,4BAA4B;IAC5B,OAAO,CAAC,cAAc,CAAc;gBAExB,MAAM,EAAE,kBAAkB;IAKtC,+BAA+B;IACxB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC;IAmBhG;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAmDtB,2BAA2B;IAC3B,OAAO,CAAC,kBAAkB;IA0B1B,2BAA2B;YACZ,wBAAwB;IAsDvC,gCAAgC;YACjB,kBAAkB;IAkPjC,eAAe;YACD,cAAc;YA4Db,yBAAyB;IAsBxC,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAIvB,iBAAiB;IACjB,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA6C3B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAoD9B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAyC5B"}
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../../src/agent/tool-executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAa,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,aAAa;AACb,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,oBAAoB;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,sBAAsB,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3G,YAAY;IACZ,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY;IACZ,aAAa,EAAE,MAAM,UAAU,EAAE,GAAG,SAAS,CAAC;CAC/C;AAQD,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,EAAE,eAAe,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAqB;IAEnC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IAEtD,4BAA4B;IAC5B,OAAO,CAAC,cAAc,CAAc;gBAExB,MAAM,EAAE,kBAAkB;IAKtC,+BAA+B;IACxB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC;IAmBhG;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAmDtB,2BAA2B;IAC3B,OAAO,CAAC,kBAAkB;IA0B1B,2BAA2B;YACZ,wBAAwB;IAsDvC,gCAAgC;YACjB,kBAAkB;IAkPjC,eAAe;YACD,cAAc;IA6C5B;;OAEG;YACW,sBAAsB;IAsDpC;;;;;OAKG;YACW,0BAA0B;YA0DzB,yBAAyB;IAsBxC,gBAAgB;IAChB,OAAO,CAAC,eAAe;IAIvB,iBAAiB;IACjB,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA6C3B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAoD9B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAyC5B"}

package/dist/cjs/agent/tool-executor.js

@@ -4,6 +4,7 @@
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentToolExecutor = void 0;
+const rate_limit_manager_ts_1 = require("./rate-limit-manager.js");
 /**
  * 工具执行管理器
  *
@@ -344,6 +345,99 @@ class AgentToolExecutor {
             ? Math.max(this.config.toolTimeout * 30, 900000)
             : this.config.toolTimeout;
         const start = Date.now();
+        // delegate_task 并发控制：在执行前获取限流/并发槽位
+        // 解决 delegate_task 并发风暴导致 LLM API TPM 限流（429）问题
+        if (isDelegate) {
+            // 为子 Agent 生成临时 sessionId，用于在限流冷却期等待时定位父会话
+            const tempSubSessionId = `subslot_${call.id}_${Date.now()}`;
+            const parentSessionId = state.sessionId;
+            // 临时建立父子映射，使 RateLimitManager 能在父会话 abort 时唤醒等待
+            rate_limit_manager_ts_1.rateLimitManager.registerSubSession(tempSubSessionId, parentSessionId);
+            const granted = await rate_limit_manager_ts_1.rateLimitManager.acquireSubSessionSlot(tempSubSessionId);
+            if (!granted) {
+                rate_limit_manager_ts_1.rateLimitManager.unregisterSubSession(tempSubSessionId);
+                const stats = rate_limit_manager_ts_1.rateLimitManager.getStats();
+                const reason = stats.cooldown
+                    ? `Rate limit cooldown active (remaining ${stats.cooldownRemainingMs}ms)`
+                    : `Sub-session concurrency limit reached (max ${stats.maxConcurrent}, queue timeout)`;
+                return {
+                    result: `Error: Sub-agent execution rejected due to rate limiting. ${reason}. Please retry later or reduce parallel delegation.`,
+                    isError: true,
+                    actualArgs: args,
+                    duration: Date.now() - start,
+                    call,
+                };
+            }
+            try {
+                const result = await this.executeDelegateWithTimeout(state, call, args, timeout, start, tempSubSessionId);
+                return result;
+            }
+            finally {
+                // 释放并发槽位并清理临时映射
+                rate_limit_manager_ts_1.rateLimitManager.releaseSubSessionSlot(tempSubSessionId);
+                rate_limit_manager_ts_1.rateLimitManager.unregisterSubSession(tempSubSessionId);
+            }
+        }
+        return this.executeToolWithTimeout(state, call, args, timeout, start);
+    }
+    /**
+     * 执行非 delegate_task 工具（带超时），从 runWithTimeout 抽取以保持逻辑清晰
+     */
+    async executeToolWithTimeout(state, call, args, timeout, start) {
+        // 为工具创建子 AbortController：超时或父级 abort 时能中止
+        const childAbort = new AbortController();
+        const parentSignal = state.toolContext.abortSignal;
+        const onParentAbort = () => childAbort.abort();
+        if (parentSignal?.aborted) {
+            childAbort.abort();
+        }
+        else if (parentSignal) {
+            parentSignal.addEventListener('abort', onParentAbort, { once: true });
+        }
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                reject(new Error(`Tool execution timeout (${timeout}ms)`));
+            }, timeout);
+        });
+        const ctxWithCallId = {
+            ...state.toolContext,
+            currentToolCallId: call.id,
+            abortSignal: childAbort.signal,
+        };
+        try {
+            const rawResult = await Promise.race([
+                this.config.toolRegistry.execute(call.function.name, args, ctxWithCallId),
+                timeoutPromise,
+            ]);
+            clearTimeout(timeoutId);
+            const result = typeof rawResult === 'string' ? rawResult : JSON.stringify(rawResult);
+            return { result, isError: false, actualArgs: args, duration: Date.now() - start, call };
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            const errorMsg = `Error: ${err.message || err}`;
+            await this.config.runHooks('on_error', {
+                sessionId: state.sessionId,
+                iteration: state.iteration,
+                tool: call.function.name,
+                error: err.message || String(err),
+                recoverable: true,
+            });
+            return { result: errorMsg, isError: true, actualArgs: args, duration: Date.now() - start, call };
+        }
+        finally {
+            if (parentSignal)
+                parentSignal.removeEventListener('abort', onParentAbort);
+        }
+    }
+    /**
+     * 执行 delegate_task（带超时 + 子 Agent AbortController）
+     *
+     * 与普通工具不同，delegate_task 的超时会同时 abort 子 Agent，
+     * 防止子 Agent 在父级超时后继续运行导致资源泄漏。
+     */
+    async executeDelegateWithTimeout(state, call, args, timeout, start, _tempSubSessionId) {
         // 为 delegate_task 创建子 AbortController：超时或父级 abort 时能中止子 Agent
         const childAbort = new AbortController();
         const parentSignal = state.toolContext.abortSignal;
@@ -373,16 +467,13 @@ class AgentToolExecutor {
                 timeoutPromise,
             ]);
             clearTimeout(timeoutId);
-            // 确保结果为字符串（工具可能返回对象）
             const result = typeof rawResult === 'string' ? rawResult : JSON.stringify(rawResult);
             return { result, isError: false, actualArgs: args, duration: Date.now() - start, call };
         }
         catch (err) {
             clearTimeout(timeoutId);
             const errorMsg = `Error: ${err.message || err}`;
-            if (isDelegate) {
-                console.error(`[ToolExecutor] delegate_task failed after ${Date.now() - start}ms: ${err.message || err}`);
-            }
+            console.error(`[ToolExecutor] delegate_task failed after ${Date.now() - start}ms: ${err.message || err}`);
             await this.config.runHooks('on_error', {
                 sessionId: state.sessionId,
                 iteration: state.iteration,