@lingxiao-office/sdk 1.0.0

package/dist/agents/TeamSynchronizer.js

@@ -0,0 +1,250 @@
+/**
+ * TeamSynchronizer - Synchronizes team agents after parallel task execution
+ *
+ * v2 重构（2026-05）：
+ * - 旧实现基于 summary keyword 匹配 ("pass" vs "fail") 判断 logic_conflict — 误报严重，
+ *   把语义相近的 "did not pass" / "failed" 也算成冲突。
+ * - v2 改为结构化输入：
+ *   - file conflict：用 task.write_scope 重叠（同一文件被多个 agent 写） — 仍保留 artifact fallback。
+ *   - logic conflict：用 BlackboardGraph 中带 contradicts edge 的 fact 节点判定，无 graph 时退化到 artifact-only。
+ *   - orchestration conflict：把 `orchestration:verdict` Fact 中 `verdict:fail` 节点一并报为高优先冲突，提示 leader 修复。
+ * - schema 不变（ConflictReport / TeamSummary 的字段保持向后兼容）。
+ */
+export class TeamSynchronizer {
+    workNoteManager;
+    sessionId;
+    /** 可选黑板图 — 用于结构化冲突检测 */
+    graph;
+    constructor(workNoteManager, sessionId, graph) {
+        this.workNoteManager = workNoteManager;
+        this.sessionId = sessionId;
+        this.graph = graph;
+    }
+    setGraph(graph) {
+        this.graph = graph;
+    }
+    async collectWorkNotes(taskId) {
+        const allNotes = await this.workNoteManager.getAllNotes(this.sessionId);
+        return allNotes.filter((note) => note.taskId === taskId);
+    }
+    mergeWorkNotes(notes) {
+        if (notes.length === 0)
+            return 'No work notes available';
+        const agentGroups = {};
+        for (const note of notes) {
+            if (!agentGroups[note.agentId]) {
+                agentGroups[note.agentId] = [];
+            }
+            agentGroups[note.agentId].push(note);
+        }
+        const summary = [];
+        summary.push('## 团队工作摘要\n');
+        for (const [agentId, agentNotes] of Object.entries(agentGroups)) {
+            summary.push(`### Agent: ${agentId}`);
+            summary.push(`工作笔记 (${agentNotes.length} 条):\n`);
+            for (const note of agentNotes) {
+                summary.push(`- [${note.phase}] ${note.summary}`);
+                if (note.details) {
+                    summary.push(`  ${note.details}`);
+                }
+                if (note.blockers && note.blockers.length > 0) {
+                    summary.push(`  阻塞: ${note.blockers.join(', ')}`);
+                }
+            }
+            summary.push('');
+        }
+        return summary.join('\n');
+    }
+    /**
+     * Detect conflicts between different agents' outputs.
+     *
+     * 三个维度（按严重度从高到低）：
+     * 1. orchestration verdict fail — 黑板上 `orchestration:verdict` Fact 标记的失败节点
+     * 2. write scope / artifact 重叠 — 同一文件被多个 agent 写
+     * 3. blackboard contradicts 边 — 不同 agent 写入的 fact 被显式标为相互矛盾
+     */
+    detectConflicts(notes) {
+        const conflicts = [];
+        // ─── 1. orchestration:verdict 失败节点（如果黑板可用） ───
+        if (this.graph) {
+            try {
+                const snap = this.graph.getSnapshot(this.sessionId);
+                const verdictFail = snap.nodes.filter(n => n.kind === 'fact' && n.tags.includes('orchestration:verdict') && n.tags.includes('verdict:fail'));
+                for (const fact of verdictFail) {
+                    // step 已被同一 step 的 verdict:pass supersede 时不再报
+                    const sameStepTag = fact.tags.find(t => t.startsWith('orchestration:node:'));
+                    const passed = sameStepTag
+                        ? snap.nodes.some(n => n.kind === 'fact'
+                            && n.tags.includes('orchestration:verdict')
+                            && n.tags.includes('verdict:pass')
+                            && n.tags.includes(sameStepTag))
+                        : false;
+                    if (passed)
+                        continue;
+                    conflicts.push({
+                        id: `orchestration_${fact.id}`,
+                        type: 'logic_conflict',
+                        severity: 'high',
+                        description: `Orchestration 节点失败：${fact.title}`,
+                        agents: fact.createdBy ? [fact.createdBy] : [],
+                        suggestion: 'Leader 应基于黑板 verdict 决定 repair 策略',
+                        resolution: 'leader_arbitrate',
+                    });
+                }
+            }
+            catch {
+                // 容忍：图操作失败不应阻断同步
+            }
+        }
+        // ─── 2. write scope / artifact 重叠 ───
+        const fileToAgents = {};
+        for (const note of notes) {
+            const files = [];
+            if (note.writeScope && note.writeScope.length > 0) {
+                files.push(...note.writeScope);
+            }
+            if (note.artifacts && note.artifacts.length > 0) {
+                files.push(...note.artifacts);
+            }
+            for (const file of files) {
+                if (!fileToAgents[file])
+                    fileToAgents[file] = new Set();
+                fileToAgents[file].add(note.agentId);
+            }
+        }
+        for (const [file, agentSet] of Object.entries(fileToAgents)) {
+            if (agentSet.size > 1) {
+                const agents = Array.from(agentSet);
+                conflicts.push({
+                    id: `file_${file}_${Date.now()}`,
+                    type: 'code_conflict',
+                    severity: 'high',
+                    description: `文件 ${file} 被多个 Agent 修改 (${agents.join(', ')})`,
+                    agents,
+                    affectedFiles: [file],
+                    suggestion: `相关成员先用 team_message 协商谁负责 ${file}（拆分写入路径或串行化）；谈不拢再升级 Leader`,
+                    resolution: 'peer_negotiate',
+                });
+            }
+        }
+        // ─── 3. blackboard contradicts 边 ───
+        if (this.graph) {
+            try {
+                const snap = this.graph.getSnapshot(this.sessionId);
+                const contradictsEdges = snap.edges.filter(e => e.edgeType === 'contradicts');
+                const nodeById = new Map(snap.nodes.map(n => [n.id, n]));
+                const seen = new Set();
+                for (const edge of contradictsEdges) {
+                    const a = nodeById.get(edge.fromNodeId);
+                    const b = nodeById.get(edge.toNodeId);
+                    if (!a || !b)
+                        continue;
+                    const key = [a.id, b.id].sort().join('|');
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    const agents = [];
+                    if (a.createdBy)
+                        agents.push(a.createdBy);
+                    if (b.createdBy && b.createdBy !== a.createdBy)
+                        agents.push(b.createdBy);
+                    conflicts.push({
+                        id: `contradicts_${a.id}_${b.id}`,
+                        type: 'logic_conflict',
+                        severity: 'medium',
+                        description: `黑板矛盾：${a.title} ↔ ${b.title}`,
+                        agents,
+                        suggestion: '触发 Reason 任务收敛矛盾',
+                        resolution: 'leader_arbitrate',
+                    });
+                }
+            }
+            catch {
+                // tolerate
+            }
+        }
+        return conflicts;
+    }
+    generateTeamSummary(taskId, notes) {
+        const mergedNotes = this.mergeWorkNotes(notes);
+        const conflicts = this.detectConflicts(notes);
+        const artifacts = Array.from(new Set(notes.flatMap((n) => n.artifacts || [])));
+        return {
+            taskId,
+            agents: Array.from(new Set(notes.map((n) => n.agentId))),
+            totalNotes: notes.length,
+            summary: mergedNotes,
+            conflicts,
+            artifacts,
+            completedAt: Date.now(),
+        };
+    }
+    /**
+     * 把 resolution='peer_negotiate' 的冲突转换成「成员间协商指令」。
+     *
+     * 每个冲突生成 N 条 P2P 消息（涉及的每个成员各收到一条，告知和谁、就什么协商），
+     * urgency 一律 normal —— 进 mailbox 兜底、由对方下一轮 team_inbox 自然消费，
+     * 不打断当前推理。caller（LeaderSupervisionCoordinator）负责实际投递 + tracker 登记。
+     *
+     * 返回空数组表示无需协商（全是 leader_arbitrate 类冲突）。
+     */
+    buildPeerNegotiations(conflicts) {
+        const out = [];
+        for (const c of conflicts) {
+            if (c.resolution !== 'peer_negotiate')
+                continue;
+            const members = Array.from(new Set(c.agents)).filter(Boolean);
+            if (members.length < 2)
+                continue; // 协商至少需要两方
+            const file = c.affectedFiles?.[0];
+            const requestId = `conflict:${c.id}`;
+            for (const me of members) {
+                const peers = members.filter(m => m !== me);
+                const content = [
+                    `[协商请求] 检测到协作冲突，请与 ${peers.map(p => `@${p}`).join('、')} 直接协商收敛：`,
+                    c.description,
+                    file
+                        ? `请协商谁负责 ${file}（拆分写入路径或串行化）。达成一致后回给原协商对象：team_message(target_type='member', target='${peers[0]}', content='已协商完成：...', intent='coordination_result', type='ack', request_id='${requestId}', verdict='PASS', next_action='...')；阻塞则 verdict='BLOCKED' 并升级 Leader。`
+                        : `请协商后回给原协商对象：team_message(target_type='member', target='${peers[0]}', content='已协商完成：...', intent='coordination_result', type='ack', request_id='${requestId}', verdict='PASS', next_action='...')；阻塞则 verdict='BLOCKED' 并升级 Leader。`,
+                ].join('\n');
+                out.push({
+                    from: me,
+                    to: peers[0],
+                    requestId,
+                    content,
+                    conflictId: c.id,
+                    taskId: c.id.startsWith('file_') ? undefined : undefined,
+                    affectedFiles: c.affectedFiles,
+                    participants: members,
+                });
+            }
+        }
+        return out;
+    }
+    formatForNextStage(summary) {
+        const lines = [];
+        lines.push('## 前序团队工作摘要\n');
+        lines.push(`任务: ${summary.taskId}`);
+        lines.push(`参与 Agent: ${summary.agents.join(', ')}`);
+        lines.push(`工作笔记: ${summary.totalNotes} 条\n`);
+        if (summary.conflicts.length > 0) {
+            lines.push(`⚠️ 检测到 ${summary.conflicts.length} 个冲突:\n`);
+            for (const conflict of summary.conflicts) {
+                lines.push(`- [${conflict.severity}] ${conflict.description}`);
+                if (conflict.suggestion) {
+                    lines.push(`  建议: ${conflict.suggestion}`);
+                }
+            }
+            lines.push('');
+        }
+        lines.push('### 产出的文件');
+        for (const artifact of summary.artifacts) {
+            lines.push(`- ${artifact}`);
+        }
+        lines.push('');
+        lines.push(summary.summary);
+        return lines.join('\n');
+    }
+}
+export default TeamSynchronizer;
+//# sourceMappingURL=TeamSynchronizer.js.map

package/dist/agents/TeamSynchronizer.js.map

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

package/dist/agents/UnifiedScheduler.d.ts

@@ -0,0 +1,111 @@
+/**
+ * UnifiedScheduler — 凌霄 Agent OS 的 worker dispatch 槽位预算管理
+ *
+ * 设计要点：
+ * - LLM 显式调 dispatch_agent → LeaderTools.dispatchAgent → scheduler.requestDispatch；
+ *   走统一 budget + dispatchTask hook，确保所有派发都受全局/单 session 并发上限约束。
+ * - tick() / 自动 selectNext 已废弃 — 所有派发决策必须经过 Leader LLM，
+ *   不再由 scheduler 自驱挑选 ready task（避免与 Leader thinking 形成竞争）。
+ * - 通过订阅 task:assigned / task:completed / task:failed / task:cancelled 维护并发槽位。
+ */
+import type { TaskBoard, Task } from '../core/TaskBoard.js';
+import type { AgentPool } from './AgentPoolRuntime.js';
+import type { EventEmitter } from '../core/EventEmitter.js';
+export interface SchedulerConfig {
+    /** 全局最大并发 Worker 数 */
+    maxWorkers: number;
+    /** 单个项目（session）最大并发 Worker 数 */
+    maxProjectWorkers: number;
+}
+export interface SchedulerStats {
+    totalDispatched: number;
+    totalCompleted: number;
+    totalFailed: number;
+    currentRunning: number;
+}
+export interface UnifiedSchedulerDeps {
+    sessionId: string;
+    board: TaskBoard;
+    pool: AgentPool;
+    emitter: EventEmitter;
+    /**
+     * Hook：把可调度任务转换为已派发 Agent；返回是否成功启动 worker。
+     *
+     * `opts.agentName` 由 caller（例如 LeaderTools.dispatchAgent）显式指定时使用，
+     * 用于保留 LLM 选定的 agent 名称；否则由 hook 内部生成默认名 `worker-<taskId>`。
+     */
+    dispatchTask: (task: Task, opts?: DispatchOptions) => Promise<boolean>;
+    config?: Partial<SchedulerConfig>;
+}
+export interface DispatchOptions {
+    agentName?: string;
+    displayRole?: string;
+    capabilityDetails?: unknown;
+    collaborationMode?: 'solo' | 'team';
+    runtimeIdentity?: {
+        visibility: 'team' | 'ephemeral';
+        owner: 'leader' | 'team';
+        interactive: boolean;
+        persistAcrossTurns: boolean;
+        teamMember: string | null;
+    };
+}
+/**
+ * 统一调度器槽位预算管理。
+ *
+ * 不持有 setInterval，不自驱选 task。所有派发都由 LLM 显式触发 requestDispatch。
+ */
+export declare class UnifiedScheduler {
+    private config;
+    private readonly deps;
+    /** sessionId -> Set<taskId>，反映"已派发尚未释放槽位"的 worker */
+    private readonly runningWorkers;
+    private readonly stats;
+    private disposed;
+    private readonly unsubscribers;
+    /** 最近一次 requestDispatch 拒绝原因（供 LeaderTools 读取给 LLM 精确反馈） */
+    private lastRejectReason;
+    constructor(deps: UnifiedSchedulerDeps);
+    /** 订阅 TaskBoard 生命周期事件，自动维护槽位计数 */
+    private subscribeToTaskBoardEvents;
+    /**
+     * 释放并发槽位。terminal 路径在 worker 完成时也会被 caller 通过事件触发。
+     */
+    private releaseSlot;
+    /** 当前是否还能再派发（全局 + 本 session 桶）。 */
+    private canDispatchMore;
+    /**
+     * 把 task 标记为"已认领"，避免同一调用里被重复派发。
+     * 真正释放走 task lifecycle 事件。
+     */
+    private claimSlot;
+    /**
+     * LLM/Leader 显式请求派发某个任务（保留 LLM 选定的 agent 名称）。
+     *
+     * @returns 是否成功启动 worker。budget 不足、任务非 dispatchable、hook 拒绝都会返回 false。
+     */
+    requestDispatch(task: Task, opts?: DispatchOptions): Promise<boolean>;
+    /** Caller 在 worker 终态时主动通知；事件路径已经覆盖大部分场景，此处幂等。 */
+    onTaskCompleted(taskId: string): void;
+    onTaskFailed(taskId: string): void;
+    onTaskCancelled(taskId: string): void;
+    /**
+     * A7: 与 TaskBoard 权威源对账——释放桶中已转终态(或已不存在)的 task 槽位。
+     * 事件路径(task:completed/failed/cancelled)覆盖大部分场景,但 emitter 订阅在
+     * dispose/重连竞态下漏事件、或 worker 异常退出未发事件时槽位泄漏(currentRunning
+     * 虚高 → canDispatchMore 永久低估可用槽位)。以 TaskBoard 为单一事实源确定性回收。
+     */
+    reconcile(): void;
+    getStats(): SchedulerStats;
+    /** 返回最近一次 requestDispatch 的拒绝原因（null 表示上次成功或未调用过） */
+    getLastRejectReason(): string | null;
+    getRunningTaskIds(): string[];
+    /** 返回当前并发槽位使用情况，供 Leader 给出精确的"槽位已满"错误信息 */
+    getCapacityInfo(): {
+        running: number;
+        max: number;
+        available: number;
+    };
+    dispose(): void;
+}
+//# sourceMappingURL=UnifiedScheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnifiedScheduler.d.ts","sourceRoot":"","sources":["../../src/agents/UnifiedScheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAK5D,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,eAAe,CAAC,EAAE;QAChB,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;QACjC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;QACrB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAKpB;IACF,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,4DAA4D;IAC5D,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,IAAI,EAAE,oBAAoB;IA4BtC,mCAAmC;IACnC,OAAO,CAAC,0BAA0B;IAuBlC;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB,mCAAmC;IACnC,OAAO,CAAC,eAAe;IAOvB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAYjB;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA6C/E,kDAAkD;IAClD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAGrC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAGlC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,SAAS,IAAI,IAAI;IAmBjB,QAAQ,IAAI,cAAc;IAI1B,qDAAqD;IACrD,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC,iBAAiB,IAAI,MAAM,EAAE;IAI7B,4CAA4C;IAC5C,eAAe,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAOtE,OAAO,IAAI,IAAI;CAUhB"}

package/dist/agents/UnifiedScheduler.js

@@ -0,0 +1,246 @@
+/**
+ * UnifiedScheduler — 凌霄 Agent OS 的 worker dispatch 槽位预算管理
+ *
+ * 设计要点：
+ * - LLM 显式调 dispatch_agent → LeaderTools.dispatchAgent → scheduler.requestDispatch；
+ *   走统一 budget + dispatchTask hook，确保所有派发都受全局/单 session 并发上限约束。
+ * - tick() / 自动 selectNext 已废弃 — 所有派发决策必须经过 Leader LLM，
+ *   不再由 scheduler 自驱挑选 ready task（避免与 Leader thinking 形成竞争）。
+ * - 通过订阅 task:assigned / task:completed / task:failed / task:cancelled 维护并发槽位。
+ */
+import { config as runtimeConfig, onConfigReload } from '../config.js';
+import { coreLogger } from '../core/Log.js';
+import { isCoreTaskTerminalStatus } from '../core/StateSemantics.js';
+/**
+ * 统一调度器槽位预算管理。
+ *
+ * 不持有 setInterval，不自驱选 task。所有派发都由 LLM 显式触发 requestDispatch。
+ */
+export class UnifiedScheduler {
+    config;
+    deps;
+    /** sessionId -> Set<taskId>，反映"已派发尚未释放槽位"的 worker */
+    runningWorkers = new Map();
+    stats = {
+        totalDispatched: 0,
+        totalCompleted: 0,
+        totalFailed: 0,
+        currentRunning: 0,
+    };
+    disposed = false;
+    unsubscribers = [];
+    /** 最近一次 requestDispatch 拒绝原因（供 LeaderTools 读取给 LLM 精确反馈） */
+    lastRejectReason = null;
+    constructor(deps) {
+        this.deps = deps;
+        const defaultMaxWorkers = runtimeConfig.agents.max_concurrent;
+        this.config = {
+            maxWorkers: deps.config?.maxWorkers ?? defaultMaxWorkers,
+            maxProjectWorkers: deps.config?.maxProjectWorkers ?? defaultMaxWorkers,
+        };
+        this.subscribeToTaskBoardEvents();
+        // 注册配置热加载：agents.max_concurrent 变化时动态更新槽位上限，
+        // 避免需要重启 session 才能让新并发上限生效。
+        const unsub = onConfigReload((cfg) => {
+            try {
+                const newMax = cfg.agents.max_concurrent;
+                if (newMax > 0 && newMax !== this.config.maxProjectWorkers) {
+                    this.config = {
+                        maxWorkers: newMax,
+                        maxProjectWorkers: newMax,
+                    };
+                    coreLogger.info(`[UnifiedScheduler] 热加载并发上限 → ${newMax}`);
+                }
+            }
+            catch (e) {
+                coreLogger.warn(`[UnifiedScheduler] onConfigReload 回调异常: ${e}`);
+            }
+        });
+        this.unsubscribers.push(unsub);
+    }
+    /** 订阅 TaskBoard 生命周期事件，自动维护槽位计数 */
+    subscribeToTaskBoardEvents() {
+        const onCompleted = (payload) => {
+            this.releaseSlot(payload.taskId, 'completed');
+        };
+        const onFailed = (payload) => {
+            this.releaseSlot(payload.taskId, 'failed');
+        };
+        const onCancelled = (payload) => {
+            this.releaseSlot(payload.taskId, 'cancelled');
+        };
+        const e = this.deps.emitter;
+        e.on('task:completed', onCompleted);
+        e.on('task:failed', onFailed);
+        e.on('task:cancelled', onCancelled);
+        this.unsubscribers.push(() => e.off('task:completed', onCompleted), () => e.off('task:failed', onFailed), () => e.off('task:cancelled', onCancelled));
+    }
+    /**
+     * 释放并发槽位。terminal 路径在 worker 完成时也会被 caller 通过事件触发。
+     */
+    releaseSlot(taskId, kind) {
+        const sid = this.deps.sessionId;
+        const bucket = this.runningWorkers.get(sid);
+        if (!bucket || !bucket.has(taskId))
+            return;
+        bucket.delete(taskId);
+        if (bucket.size === 0)
+            this.runningWorkers.delete(sid);
+        this.stats.currentRunning = Math.max(0, this.stats.currentRunning - 1);
+        if (kind === 'completed')
+            this.stats.totalCompleted++;
+        else if (kind === 'failed')
+            this.stats.totalFailed++;
+    }
+    /** 当前是否还能再派发（全局 + 本 session 桶）。 */
+    canDispatchMore() {
+        if (this.stats.currentRunning >= this.config.maxWorkers)
+            return false;
+        const bucket = this.runningWorkers.get(this.deps.sessionId);
+        if (bucket && bucket.size >= this.config.maxProjectWorkers)
+            return false;
+        return true;
+    }
+    /**
+     * 把 task 标记为"已认领"，避免同一调用里被重复派发。
+     * 真正释放走 task lifecycle 事件。
+     */
+    claimSlot(taskId) {
+        const sid = this.deps.sessionId;
+        let bucket = this.runningWorkers.get(sid);
+        if (!bucket) {
+            bucket = new Set();
+            this.runningWorkers.set(sid, bucket);
+        }
+        bucket.add(taskId);
+        this.stats.currentRunning++;
+        this.stats.totalDispatched++;
+    }
+    /**
+     * LLM/Leader 显式请求派发某个任务（保留 LLM 选定的 agent 名称）。
+     *
+     * @returns 是否成功启动 worker。budget 不足、任务非 dispatchable、hook 拒绝都会返回 false。
+     */
+    async requestDispatch(task, opts = {}) {
+        if (this.disposed) {
+            this.lastRejectReason = '调度器已销毁';
+            return false;
+        }
+        // A7: 派发前先对账,回收因漏事件泄漏的槽位(否则 currentRunning 虚高挤占可用并发)。
+        this.reconcile();
+        if (task.status !== 'dispatchable') {
+            this.lastRejectReason = `任务状态为 ${task.status}（非 dispatchable）`;
+            return false;
+        }
+        if (!this.deps.board.isTaskReady(task.id)) {
+            const blockedReason = this.deps.board.getBlockedReason(task);
+            this.lastRejectReason = blockedReason ? `依赖/契约未就绪：${blockedReason}` : '依赖或契约未就绪';
+            return false;
+        }
+        const bucket = this.runningWorkers.get(this.deps.sessionId);
+        if (bucket?.has(task.id)) {
+            this.lastRejectReason = `任务 ${task.id} 已在派发中（bucket 冲突）`;
+            return false;
+        }
+        if (!this.canDispatchMore()) {
+            const cap = this.getCapacityInfo();
+            this.lastRejectReason = `并发槽位已满（${cap.running}/${cap.max}），请等待运行中的 Agent 完成`;
+            return false;
+        }
+        this.claimSlot(task.id);
+        let ok = false;
+        try {
+            ok = await this.deps.dispatchTask(task, opts);
+        }
+        catch (err) {
+            coreLogger.error(`[UnifiedScheduler] requestDispatch threw for ${task.id}:`, err);
+        }
+        if (!ok) {
+            const b = this.runningWorkers.get(this.deps.sessionId);
+            // 以 bucket.delete 结果为准（H/M：双重递减）。await dispatchTask 期间若
+            // task:failed/completed/cancelled 事件先行触发 releaseSlot，该 task 已被
+            // 从 bucket 移除并递减过 currentRunning。此处 delete 返回 false 表示已被
+            // 事件路径处理，必须跳过递减，避免与 releaseSlot 双重递减 currentRunning
+            // （会把并发上限低估，长期挤占可用槽位）。
+            const removed = b?.delete(task.id) ?? false;
+            if (b && b.size === 0)
+                this.runningWorkers.delete(this.deps.sessionId);
+            if (removed) {
+                this.stats.currentRunning = Math.max(0, this.stats.currentRunning - 1);
+                this.stats.totalDispatched = Math.max(0, this.stats.totalDispatched - 1);
+            }
+            this.lastRejectReason = `dispatchTask hook 返回 false（worker 启动失败，可能原因：agent 名称冲突/角色注册失败/进程启动异常）`;
+            return false;
+        }
+        this.lastRejectReason = null;
+        return true;
+    }
+    /** Caller 在 worker 终态时主动通知；事件路径已经覆盖大部分场景，此处幂等。 */
+    onTaskCompleted(taskId) {
+        this.releaseSlot(taskId, 'completed');
+    }
+    onTaskFailed(taskId) {
+        this.releaseSlot(taskId, 'failed');
+    }
+    onTaskCancelled(taskId) {
+        this.releaseSlot(taskId, 'cancelled');
+    }
+    /**
+     * A7: 与 TaskBoard 权威源对账——释放桶中已转终态(或已不存在)的 task 槽位。
+     * 事件路径(task:completed/failed/cancelled)覆盖大部分场景,但 emitter 订阅在
+     * dispose/重连竞态下漏事件、或 worker 异常退出未发事件时槽位泄漏(currentRunning
+     * 虚高 → canDispatchMore 永久低估可用槽位)。以 TaskBoard 为单一事实源确定性回收。
+     */
+    reconcile() {
+        const sid = this.deps.sessionId;
+        const bucket = this.runningWorkers.get(sid);
+        if (!bucket || bucket.size === 0)
+            return;
+        let reclaimed = 0;
+        for (const taskId of bucket) {
+            const task = this.deps.board.getTask(taskId);
+            if (!task || isCoreTaskTerminalStatus(task.status)) {
+                bucket.delete(taskId);
+                reclaimed++;
+            }
+        }
+        if (reclaimed > 0) {
+            this.stats.currentRunning = Math.max(0, this.stats.currentRunning - reclaimed);
+            coreLogger.warn(`[UnifiedScheduler] reconcile 回收 ${reclaimed} 个泄漏槽位(session=${sid})`);
+        }
+        if (bucket.size === 0)
+            this.runningWorkers.delete(sid);
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    /** 返回最近一次 requestDispatch 的拒绝原因（null 表示上次成功或未调用过） */
+    getLastRejectReason() {
+        return this.lastRejectReason;
+    }
+    getRunningTaskIds() {
+        return Array.from(this.runningWorkers.get(this.deps.sessionId) ?? []);
+    }
+    /** 返回当前并发槽位使用情况，供 Leader 给出精确的"槽位已满"错误信息 */
+    getCapacityInfo() {
+        this.reconcile();
+        const running = this.stats.currentRunning;
+        const max = this.config.maxProjectWorkers;
+        return { running, max, available: Math.max(0, max - running) };
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const off of this.unsubscribers) {
+            try {
+                off();
+            }
+            catch { /* tolerate */ }
+        }
+        this.unsubscribers.length = 0;
+        this.runningWorkers.clear();
+        coreLogger.info('[UnifiedScheduler] disposed');
+    }
+}
+//# sourceMappingURL=UnifiedScheduler.js.map

package/dist/agents/UnifiedScheduler.js.map

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