@lingxiao-office/sdk 1.0.0

package/dist/core/TeamCommunicationGuard.js

@@ -0,0 +1,221 @@
+/**
+ * TeamCommunicationGuard — 防止 agent 间通信失控的安全护栏
+ *
+ * 控制机制：
+ * 1. 消息频率限制 — 单 agent 每分钟最多 30 条消息
+ * 2. 广播限制 — 每分钟最多 5 次广播
+ * 3. 循环检测 — A→B→A→B 乒乓模式（5 轮 / 60s 内）阻断
+ * 4. 总量预算 — 单 session 每小时最多 500 条 team 消息（滑动窗口）
+ * 5. 内容去重 — 相同 from+to+content(指纹) 30s 内不重复投递
+ * 6. 日志审计 — 所有消息记录到结构化日志
+ */
+import { createHash } from 'node:crypto';
+import { coreLogger } from './Log.js';
+const DEFAULT_CONFIG = {
+    maxMessagesPerMinute: 30,
+    maxBroadcastsPerMinute: 5,
+    pingPongThreshold: 5,
+    pingPongWindowMs: 60_000,
+    totalBudgetWindowMs: 60 * 60_000, // 1 小时
+    maxTotalMessagesPerWindow: 500,
+    dedupeWindowMs: 30_000,
+};
+export class TeamCommunicationGuard {
+    config;
+    sessionId;
+    /** agent name → 发送频率窗口 */
+    sendRates = new Map();
+    /** 广播频率窗口 */
+    broadcastRate = { timestamps: [] };
+    /** 去重缓存：fingerprint → ts */
+    dedupeCache = new Map();
+    /** 乒乓检测：pair key → tracker */
+    pingPongTrackers = new Map();
+    /** 总量预算滑动窗口（ts 列表） */
+    totalMessageWindow = [];
+    constructor(sessionId, config) {
+        this.sessionId = sessionId;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * 仅检查是否允许通过，不计数（不修改内部状态）。
+     * 给工具入口（TeamSendMessage）做"前置反馈"使用，让 LLM 立即拿到 rate_limited / deduplicated 反馈。
+     */
+    preCheck(from, to, content, isBroadcast) {
+        return this.evaluate(from, to, content, isBroadcast, /*record*/ false);
+    }
+    /**
+     * 检查并计数（service 主路径用）。
+     */
+    check(from, to, content, isBroadcast) {
+        return this.evaluate(from, to, content, isBroadcast, /*record*/ true);
+    }
+    evaluate(from, to, content, isBroadcast, record) {
+        const now = Date.now();
+        // 1. 总量预算滑动窗口
+        this.pruneTotalWindow(now);
+        if (this.totalMessageWindow.length >= this.config.maxTotalMessagesPerWindow) {
+            coreLogger.warn(`[TeamGuard] session=${this.sessionId} 滑动窗口预算超限 (${this.totalMessageWindow.length}/${this.config.maxTotalMessagesPerWindow}/${Math.round(this.config.totalBudgetWindowMs / 60_000)}min)`);
+            return { verdict: 'budget_exhausted', reason: `滑动窗口内消息超限 ${this.config.maxTotalMessagesPerWindow}/${Math.round(this.config.totalBudgetWindowMs / 60_000)}min` };
+        }
+        // 2. 频率限制
+        if (isBroadcast) {
+            this.pruneWindow(this.broadcastRate, now);
+            if (this.broadcastRate.timestamps.length >= this.config.maxBroadcastsPerMinute) {
+                coreLogger.warn(`[TeamGuard] ${from} 广播频率超限 (${this.broadcastRate.timestamps.length}/${this.config.maxBroadcastsPerMinute}/min)`);
+                return { verdict: 'rate_limited', reason: `广播频率超限 (${this.config.maxBroadcastsPerMinute}/min)` };
+            }
+        }
+        const senderWindow = this.getOrCreateWindow(from);
+        this.pruneWindow(senderWindow, now);
+        if (senderWindow.timestamps.length >= this.config.maxMessagesPerMinute) {
+            coreLogger.warn(`[TeamGuard] ${from} 发送频率超限 (${senderWindow.timestamps.length}/${this.config.maxMessagesPerMinute}/min)`);
+            return { verdict: 'rate_limited', reason: `发送频率超限 (${this.config.maxMessagesPerMinute}/min)` };
+        }
+        // 3. 内容去重（用 sha1 截断指纹避免大 content 拷贝）
+        if (to) {
+            const fingerprint = this.makeFingerprint(from, to, content);
+            this.pruneDedupeCache(now);
+            const lastTs = this.dedupeCache.get(fingerprint);
+            if (lastTs !== undefined) {
+                coreLogger.debug(`[TeamGuard] 去重拦截: ${from}→${to} (fingerprint=${fingerprint.slice(0, 16)}...)`);
+                return { verdict: 'deduplicated', reason: '相同消息在去重窗口内已发送' };
+            }
+            if (record)
+                this.dedupeCache.set(fingerprint, now);
+        }
+        // 4. 乒乓循环检测（仅 P2P）
+        if (to) {
+            const pairKey = [from, to].sort().join('↔');
+            const direction = `${from}→${to}`;
+            const tracker = this.getOrCreatePingPong(pairKey);
+            // 仅在 record 阶段才追加方向；preCheck 时只读，避免污染序列
+            if (record) {
+                tracker.directions.push(direction);
+                tracker.lastTimestamp = now;
+                const maxLen = this.config.pingPongThreshold * 2;
+                if (tracker.directions.length > maxLen) {
+                    tracker.directions = tracker.directions.slice(-maxLen);
+                }
+            }
+            const pingPongDetected = this.detectPingPong(tracker, now, direction, record);
+            if (pingPongDetected === 'blocked') {
+                coreLogger.warn(`[TeamGuard] 乒乓循环阻断: ${pairKey} (${tracker.directions.length} 条交替消息 in 60s)`);
+                return { verdict: 'ping_pong_blocked', reason: `检测到乒乓循环 (${pairKey})，发送被阻断` };
+            }
+            if (pingPongDetected === 'degraded') {
+                coreLogger.warn(`[TeamGuard] 乒乓循环检测: ${pairKey} (${tracker.directions.length} 条交替消息)，urgency 降级`);
+                if (record)
+                    this.recordSend(from, isBroadcast, now);
+                return { verdict: 'ping_pong_degraded', degradedUrgency: 'normal', reason: `检测到乒乓循环 (${pairKey})，urgency 降级为 normal` };
+            }
+        }
+        // 通过所有检查
+        if (record)
+            this.recordSend(from, isBroadcast, now);
+        return { verdict: 'allow' };
+    }
+    /** 记录一次成功发送 */
+    recordSend(from, isBroadcast, now) {
+        this.totalMessageWindow.push(now);
+        const window = this.getOrCreateWindow(from);
+        window.timestamps.push(now);
+        if (isBroadcast) {
+            this.broadcastRate.timestamps.push(now);
+        }
+    }
+    /** 获取当前统计 */
+    getStats() {
+        const now = Date.now();
+        this.pruneTotalWindow(now);
+        const agentRates = {};
+        for (const [name, window] of this.sendRates) {
+            this.pruneWindow(window, now);
+            agentRates[name] = window.timestamps.length;
+        }
+        return {
+            totalMessages: this.totalMessageWindow.length,
+            budget: this.config.maxTotalMessagesPerWindow - this.totalMessageWindow.length,
+            agentRates,
+        };
+    }
+    /** 重置（用于测试或 session 结束） */
+    reset() {
+        this.sendRates.clear();
+        this.broadcastRate = { timestamps: [] };
+        this.dedupeCache.clear();
+        this.pingPongTrackers.clear();
+        this.totalMessageWindow = [];
+    }
+    // ─── 内部方法 ───
+    getOrCreateWindow(agentName) {
+        let w = this.sendRates.get(agentName);
+        if (!w) {
+            w = { timestamps: [] };
+            this.sendRates.set(agentName, w);
+        }
+        return w;
+    }
+    pruneWindow(window, now) {
+        const cutoff = now - 60_000; // 1 分钟窗口
+        window.timestamps = window.timestamps.filter(t => t > cutoff);
+    }
+    pruneTotalWindow(now) {
+        const cutoff = now - this.config.totalBudgetWindowMs;
+        this.totalMessageWindow = this.totalMessageWindow.filter(t => t > cutoff);
+    }
+    pruneDedupeCache(now) {
+        const cutoff = now - this.config.dedupeWindowMs;
+        for (const [fp, ts] of this.dedupeCache) {
+            if (ts <= cutoff)
+                this.dedupeCache.delete(fp);
+        }
+    }
+    makeFingerprint(from, to, content) {
+        const hash = createHash('sha1').update(content).digest('hex').slice(0, 16);
+        return `${from}→${to}::${hash}`;
+    }
+    getOrCreatePingPong(pairKey) {
+        let t = this.pingPongTrackers.get(pairKey);
+        if (!t) {
+            t = { directions: [], lastTimestamp: 0 };
+            this.pingPongTrackers.set(pairKey, t);
+        }
+        // 超过 pingPongWindowMs 无活动则重置
+        if (t.lastTimestamp > 0 && Date.now() - t.lastTimestamp > this.config.pingPongWindowMs) {
+            t.directions = [];
+        }
+        return t;
+    }
+    /**
+     * 乒乓检测策略：
+     * - 4-5 次内严格交替 → degraded（仅降级 urgency）
+     * - ≥ pingPongThreshold * 2 次（默认 10 次）严格交替 → blocked（阻断）
+     * - 必须在 60s 时间窗内
+     */
+    detectPingPong(tracker, now, currentDirection, record) {
+        // preCheck 时 tracker.directions 还没追加 currentDirection，需要临时考量
+        const sequence = record
+            ? tracker.directions
+            : [...tracker.directions, currentDirection].slice(-this.config.pingPongThreshold * 2);
+        if (sequence.length < this.config.pingPongThreshold)
+            return null;
+        // 时间窗校验：tracker 最近活动必须在窗口内
+        if (tracker.lastTimestamp > 0 && now - tracker.lastTimestamp > this.config.pingPongWindowMs) {
+            return null;
+        }
+        // 检查最近 N 条是否严格交替
+        const checkLen = Math.min(sequence.length, this.config.pingPongThreshold * 2);
+        const recent = sequence.slice(-checkLen);
+        for (let i = 1; i < recent.length; i++) {
+            if (recent[i] === recent[i - 1])
+                return null;
+        }
+        if (recent.length >= this.config.pingPongThreshold * 2)
+            return 'blocked';
+        if (recent.length >= this.config.pingPongThreshold)
+            return 'degraded';
+        return null;
+    }
+}
+//# sourceMappingURL=TeamCommunicationGuard.js.map

package/dist/core/TeamCommunicationGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TeamCommunicationGuard.js","sourceRoot":"","sources":["../../src/core/TeamCommunicationGuard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAmBtC,MAAM,cAAc,GAAgB;IAClC,oBAAoB,EAAE,EAAE;IACxB,sBAAsB,EAAE,CAAC;IACzB,iBAAiB,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM;IACxB,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO;IACzC,yBAAyB,EAAE,GAAG;IAC9B,cAAc,EAAE,MAAM;CACvB,CAAC;AAqBF,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAc;IACpB,SAAS,CAAS;IAE1B,0BAA0B;IAClB,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAClD,aAAa;IACL,aAAa,GAAe,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACvD,4BAA4B;IACpB,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,8BAA8B;IACtB,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC9D,sBAAsB;IACd,kBAAkB,GAAa,EAAE,CAAC;IAE1C,YAAY,SAAiB,EAAE,MAA6B;QAC1D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAY,EAAE,EAAsB,EAAE,OAAe,EAAE,WAAoB;QAClF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY,EAAE,EAAsB,EAAE,OAAe,EAAE,WAAoB;QAC/E,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,EAAsB,EAAE,OAAe,EAAE,WAAoB,EAAE,MAAe;QAC3G,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,cAAc;QACd,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,yBAAyB,EAAE,CAAC;YAC5E,UAAU,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,SAAS,cAAc,IAAI,CAAC,kBAAkB,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,yBAAyB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1M,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,IAAI,CAAC,MAAM,CAAC,yBAAyB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAClK,CAAC;QAED,UAAU;QACV,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CAAC;gBAC/E,UAAU,CAAC,IAAI,CAAC,eAAe,IAAI,YAAY,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,sBAAsB,OAAO,CAAC,CAAC;gBAClI,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,IAAI,CAAC,MAAM,CAAC,sBAAsB,OAAO,EAAE,CAAC;YACnG,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QACpC,IAAI,YAAY,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACvE,UAAU,CAAC,IAAI,CAAC,eAAe,IAAI,YAAY,YAAY,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,OAAO,CAAC,CAAC;YAC1H,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,IAAI,CAAC,MAAM,CAAC,oBAAoB,OAAO,EAAE,CAAC;QACjG,CAAC;QAED,qCAAqC;QACrC,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YAC5D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,UAAU,CAAC,KAAK,CAAC,qBAAqB,IAAI,IAAI,EAAE,iBAAiB,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;gBACjG,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;YAC9D,CAAC;YACD,IAAI,MAAM;gBAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,mBAAmB;QACnB,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAElD,wCAAwC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACnC,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC;gBAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC;gBACjD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;oBACvC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAC9E,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACnC,UAAU,CAAC,IAAI,CAAC,uBAAuB,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,MAAM,gBAAgB,CAAC,CAAC;gBAC9F,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,OAAO,SAAS,EAAE,CAAC;YAChF,CAAC;YACD,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;gBACpC,UAAU,CAAC,IAAI,CAAC,uBAAuB,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,MAAM,oBAAoB,CAAC,CAAC;gBAClG,IAAI,MAAM;oBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;gBACpD,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,OAAO,sBAAsB,EAAE,CAAC;YACzH,CAAC;QACH,CAAC;QAED,SAAS;QACT,IAAI,MAAM;YAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,eAAe;IACP,UAAU,CAAC,IAAY,EAAE,WAAoB,EAAE,GAAW;QAChE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,aAAa;IACb,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,UAAU,GAA2B,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAC9C,CAAC;QACD,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,yBAAyB,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM;YAC9E,UAAU;SACX,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,eAAe;IAEP,iBAAiB,CAAC,SAAiB;QACzC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,WAAW,CAAC,MAAkB,EAAE,GAAW;QACjD,MAAM,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,SAAS;QACtC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAChE,CAAC;IAEO,gBAAgB,CAAC,GAAW;QAClC,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;QACrD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAC5E,CAAC;IAEO,gBAAgB,CAAC,GAAW;QAClC,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAChD,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,EAAE,IAAI,MAAM;gBAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe;QAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,OAAO,GAAG,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAClC,CAAC;IAEO,mBAAmB,CAAC,OAAe;QACzC,IAAI,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,6BAA6B;QAC7B,IAAI,CAAC,CAAC,aAAa,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACvF,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,OAAwB,EAAE,GAAW,EAAE,gBAAwB,EAAE,MAAe;QACrG,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,MAAM;YACrB,CAAC,CAAC,OAAO,CAAC,UAAU;YACpB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAExF,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QAEjE,2BAA2B;QAC3B,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5F,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iBAAiB;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC/C,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACzE,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB;YAAE,OAAO,UAAU,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/core/TeamCommunicationService.d.ts

@@ -0,0 +1,55 @@
+/**
+ * TeamCommunicationService — team 通信统一协调服务
+ *
+ * 主通道职责：
+ * - 监听 TeamMailbox 的 team:message_sent 事件
+ * - 通过 TeamCommunicationGuard 过滤限流 / 乒乓 / 总量预算
+ * - 把消息推到 Worker 进程的 MessageBus
+ * - 推送成功立即 markRead（主通道天然保证已读），让 team_inbox 退化为补漏
+ *
+ * AgentPool 只提供 isAgentRunning + bus.send 能力，不关心协议细节。
+ */
+import type { MessageBus } from './MessageBus.js';
+import type { EventEmitter } from './EventEmitter.js';
+export interface TeamCommunicationAgentRuntime {
+    /** 判断 agent 是否当前可接收推送消息 */
+    isAgentRunning(agentName: string): boolean;
+    /**
+     * 目标 agent 已离线、但消息已落 mailbox 时，尝试复活它去读邮箱补漏。
+     * 仅对「曾被派发过」的 agent 生效；从未派发的成员会被忽略。fire-and-forget。
+     */
+    reviveAgentForTeamMessage?(agentName: string): void;
+}
+export interface TeamCommunicationServiceOptions {
+    sessionId: string;
+    bus: MessageBus;
+    emitter: EventEmitter;
+    runtime: TeamCommunicationAgentRuntime;
+}
+export declare function getActiveTeamCommunicationService(sessionId: string): TeamCommunicationService | undefined;
+export declare class TeamCommunicationService {
+    private readonly sessionId;
+    private readonly bus;
+    private readonly emitter;
+    private readonly runtime;
+    private readonly guard;
+    private unsubscribe?;
+    private started;
+    constructor(options: TeamCommunicationServiceOptions);
+    start(): void;
+    cleanup(): void;
+    /** 暴露给 TeamSendMessage 工具：在写 mailbox 前 preCheck，让 LLM 立即拿到 rate_limited 反馈而不是静默吞 */
+    preCheckMessage(from: string, to: string | undefined, content: string, isBroadcast: boolean): import("./TeamCommunicationGuard.js").GuardResult;
+    /** 暴露 Guard 统计给监控/调试入口 */
+    getStats(): {
+        totalMessages: number;
+        budget: number;
+        agentRates: Record<string, number>;
+    };
+    private routeTeamMessage;
+    private routeBroadcast;
+    private routeDirect;
+    private deliverToAgent;
+    private scoped;
+}
+//# sourceMappingURL=TeamCommunicationService.d.ts.map

package/dist/core/TeamCommunicationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TeamCommunicationService.d.ts","sourceRoot":"","sources":["../../src/core/TeamCommunicationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,WAAW,6BAA6B;IAC5C,2BAA2B;IAC3B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C;;;OAGG;IACH,yBAAyB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,6BAA6B,CAAC;CACxC;AAYD,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAEzG;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,+BAA+B;IAQpD,KAAK,IAAI,IAAI;IASb,OAAO,IAAI,IAAI;IAUf,oFAAoF;IACpF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO;IAI3F,0BAA0B;IAC1B,QAAQ;;;;;IAIR,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,cAAc;IA0DtB,OAAO,CAAC,MAAM;CAGf"}

package/dist/core/TeamCommunicationService.js

@@ -0,0 +1,178 @@
+/**
+ * TeamCommunicationService — team 通信统一协调服务
+ *
+ * 主通道职责：
+ * - 监听 TeamMailbox 的 team:message_sent 事件
+ * - 通过 TeamCommunicationGuard 过滤限流 / 乒乓 / 总量预算
+ * - 把消息推到 Worker 进程的 MessageBus
+ * - 推送成功立即 markRead（主通道天然保证已读），让 team_inbox 退化为补漏
+ *
+ * AgentPool 只提供 isAgentRunning + bus.send 能力，不关心协议细节。
+ */
+import { TeamCommunicationGuard } from './TeamCommunicationGuard.js';
+import { getTeamMailbox, getTeamMemberRegistry } from './TeamMailbox.js';
+import { createProtocolMessage, formatProtocolMessageForContext, wrapProtocolPayload } from './TeamProtocol.js';
+import { coreLogger } from './Log.js';
+/** session-scoped 单例注册：让 TeamSendMessage 等工具能拿到当前 session 的 service 实例做 preCheck */
+const activeServices = new Map();
+export function getActiveTeamCommunicationService(sessionId) {
+    return activeServices.get(sessionId);
+}
+export class TeamCommunicationService {
+    sessionId;
+    bus;
+    emitter;
+    runtime;
+    guard;
+    unsubscribe;
+    started = false;
+    constructor(options) {
+        this.sessionId = options.sessionId;
+        this.bus = options.bus;
+        this.emitter = options.emitter;
+        this.runtime = options.runtime;
+        this.guard = new TeamCommunicationGuard(options.sessionId);
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.unsubscribe = this.emitter.subscribe('team:message_sent', (data) => {
+            this.routeTeamMessage(data);
+        });
+        activeServices.set(this.sessionId, this);
+    }
+    cleanup() {
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+        this.guard.reset();
+        this.started = false;
+        if (activeServices.get(this.sessionId) === this) {
+            activeServices.delete(this.sessionId);
+        }
+    }
+    /** 暴露给 TeamSendMessage 工具：在写 mailbox 前 preCheck，让 LLM 立即拿到 rate_limited 反馈而不是静默吞 */
+    preCheckMessage(from, to, content, isBroadcast) {
+        return this.guard.preCheck(from, to, content, isBroadcast);
+    }
+    /** 暴露 Guard 统计给监控/调试入口 */
+    getStats() {
+        return this.guard.getStats();
+    }
+    routeTeamMessage(data) {
+        // 硬过滤：消息必须显式带 sessionId 且与本服务一致；缺省一律丢弃，
+        // 防止多 session 进程内串台。
+        if (!data.sessionId || data.sessionId !== this.sessionId)
+            return;
+        const msg = data.message;
+        // fromMember 现在直接是 agent name；缺省时（系统消息）用 'system'
+        const fromAgentName = msg.fromMember ?? 'system';
+        if (data.isBroadcast) {
+            this.routeBroadcast(data, fromAgentName);
+            return;
+        }
+        if (!msg.toMember)
+            return;
+        this.routeDirect(msg, fromAgentName, msg.toMember);
+    }
+    routeBroadcast(data, fromAgentName) {
+        const msg = data.message;
+        const mailbox = getTeamMailbox();
+        const members = getTeamMemberRegistry().getByTeam(data.toTeam, this.sessionId);
+        const recipients = members
+            .map((m) => m.name)
+            .filter((name) => name !== fromAgentName);
+        if (recipients.length === 0) {
+            mailbox.updateDelivery(msg.id, data.toTeam, 'skipped', 'no_recipient');
+            return;
+        }
+        const guardResult = this.guard.check(fromAgentName, undefined, msg.content, true);
+        if (guardResult.verdict !== 'allow' && guardResult.verdict !== 'ping_pong_degraded') {
+            coreLogger.debug(`[TeamCommunicationService] 广播被 Guard 拦截: ${guardResult.verdict} - ${guardResult.reason}`);
+            for (const recipient of recipients) {
+                mailbox.updateDelivery(msg.id, recipient, 'skipped', `guard_${guardResult.verdict}`);
+            }
+            return;
+        }
+        const effectiveUrgency = guardResult.degradedUrgency ?? msg.urgency;
+        for (const recipient of recipients) {
+            if (this.runtime.isAgentRunning(recipient)) {
+                this.deliverToAgent(msg, fromAgentName, recipient, effectiveUrgency, true);
+            }
+            else {
+                mailbox.updateDelivery(msg.id, recipient, 'queued', 'offline');
+            }
+        }
+    }
+    routeDirect(msg, fromAgentName, toAgentName) {
+        // Leader 路径：通过 mailbox.getTeam(toTeam).leader 判定，绕过 isAgentRunning 直送 leader bus
+        // —— Leader 是 BaseAgent 子类、constructor 内已 subscribe ${sessionId}:leader bus，始终可投递。
+        const mailbox = getTeamMailbox();
+        const team = mailbox.getTeam(msg.toTeam, this.sessionId);
+        const isLeaderRecipient = team?.leader === toAgentName;
+        if (!isLeaderRecipient && !this.runtime.isAgentRunning(toAgentName)) {
+            const reviveAvailable = typeof this.runtime.reviveAgentForTeamMessage === 'function';
+            this.runtime.reviveAgentForTeamMessage?.(toAgentName);
+            mailbox.updateDelivery(msg.id, toAgentName, 'queued', reviveAvailable ? 'offline_revive_requested' : 'offline');
+            return;
+        }
+        const guardResult = this.guard.check(fromAgentName, toAgentName, msg.content, false);
+        if (guardResult.verdict !== 'allow' && guardResult.verdict !== 'ping_pong_degraded') {
+            coreLogger.debug(`[TeamCommunicationService] 消息被 Guard 拦截: ${guardResult.verdict} - ${guardResult.reason}`);
+            mailbox.updateDelivery(msg.id, toAgentName, 'skipped', `guard_${guardResult.verdict}`);
+            return;
+        }
+        const effectiveUrgency = guardResult.degradedUrgency ?? msg.urgency;
+        this.deliverToAgent(msg, fromAgentName, toAgentName, effectiveUrgency, false, isLeaderRecipient);
+    }
+    deliverToAgent(msg, fromAgentName, toAgentName, urgency, isBroadcast, bypassRunningCheck = false) {
+        const mailbox = getTeamMailbox();
+        // routeDirect / routeBroadcast 已在 guard 之前过滤过 isAgentRunning，
+        // 这里保留二次防御：派发瞬间 worker 退出也不会 NPE。bypassRunningCheck=true 时跳过（leader 路径）。
+        if (!bypassRunningCheck && !this.runtime.isAgentRunning(toAgentName)) {
+            mailbox.updateDelivery(msg.id, toAgentName, 'queued', 'offline_during_delivery');
+            return;
+        }
+        const protocolMessage = createProtocolMessage({
+            id: msg.id,
+            from: fromAgentName,
+            to: toAgentName,
+            sessionId: this.sessionId,
+            rawContent: msg.content,
+            urgency,
+            timestamp: msg.timestamp,
+            metadata: msg.metadata,
+        });
+        const routedProtocolMessage = {
+            ...protocolMessage,
+            type: isBroadcast && protocolMessage.type === 'message' ? 'broadcast' : protocolMessage.type,
+        };
+        const contextContent = formatProtocolMessageForContext(routedProtocolMessage);
+        const busType = urgency === 'urgent' ? 'user_intervention' : 'message';
+        let sendOk = true;
+        try {
+            this.bus.send(this.scoped(fromAgentName), this.scoped(toAgentName), busType, wrapProtocolPayload({ ...routedProtocolMessage, content: contextContent }));
+        }
+        catch (err) {
+            sendOk = false;
+            coreLogger.warn(`[TeamCommunicationService] bus.send 失败 (${fromAgentName}→${toAgentName}): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (sendOk) {
+            mailbox.updateDelivery(msg.id, toAgentName, 'delivered');
+            // 仅在 bus.send 同步路径成功时才 markRead；失败留给 inbox_check 兜底，避免静默丢消息
+            try {
+                mailbox.markRead([msg.id], toAgentName);
+            }
+            catch {
+                // mailbox 操作失败不应阻断后续投递
+            }
+        }
+        else {
+            mailbox.updateDelivery(msg.id, toAgentName, 'failed', 'bus_send_failed');
+        }
+    }
+    scoped(agentName) {
+        return `${this.sessionId}:${agentName}`;
+    }
+}
+//# sourceMappingURL=TeamCommunicationService.js.map

package/dist/core/TeamCommunicationService.js.map

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