@lingxiao-office/sdk 1.0.0

package/dist/agents/pool/AgentPoolBroadcast.d.ts

@@ -0,0 +1,25 @@
+import type { MessageBus } from '../../core/MessageBus.js';
+import type { TaskBoard } from '../../core/TaskBoard.js';
+import type { BlackboardDelta } from '../../core/blackboard/types.js';
+import type { WorkNote } from '../../core/WorkNoteManager.js';
+import type { AgentHandle } from '../AgentPoolRuntime.js';
+export declare function getHandleTaskTags(handle: AgentHandle, taskBoard: TaskBoard): Set<string>;
+export declare function formatBlackboardDeltaMessage(delta: BlackboardDelta): string;
+export declare function broadcastBlackboardDelta(input: {
+    delta: BlackboardDelta;
+    excludeAgentName?: string;
+    agents: Iterable<AgentHandle>;
+    taskBoard: TaskBoard;
+    bus: MessageBus;
+    sessionId: string;
+    sp: (name: string) => string;
+}): number;
+export declare function broadcastWorkNoteAwareness(input: {
+    note: WorkNote;
+    sourceAgentId: string;
+    agents: Iterable<AgentHandle>;
+    bus: MessageBus;
+    sessionId: string;
+    sp: (name: string) => string;
+}): number;
+//# sourceMappingURL=AgentPoolBroadcast.d.ts.map

package/dist/agents/pool/AgentPoolBroadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPoolBroadcast.d.ts","sourceRoot":"","sources":["../../../src/agents/pool/AgentPoolBroadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAaxF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA2B3E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,eAAe,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B,GAAG,MAAM,CAcT;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9B,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B,GAAG,MAAM,CAoBT"}

package/dist/agents/pool/AgentPoolBroadcast.js

@@ -0,0 +1,88 @@
+import { buildBlackboardNodeAwarenessBlock, buildWorkNoteAwarenessBlock } from '../../core/ArtifactAwareness.js';
+import { isGlobalBroadcastNode } from '../../core/blackboard/types.js';
+export function getHandleTaskTags(handle, taskBoard) {
+    const tags = new Set();
+    if (handle.roleType)
+        tags.add(handle.roleType);
+    if (handle.taskId) {
+        tags.add(handle.taskId);
+        const prefix = handle.taskId.split('-')[0];
+        if (prefix)
+            tags.add(prefix);
+    }
+    const task = handle.taskId ? taskBoard.getTask(handle.taskId) : undefined;
+    if (task) {
+        tags.add(task.agent_type);
+    }
+    return tags;
+}
+export function formatBlackboardDeltaMessage(delta) {
+    const lines = [
+        '### 黑板增量更新（系统自动注入）',
+        '',
+        `**事件**：${delta.humanSummary}`,
+    ];
+    if (delta.changedNodes.length > 0) {
+        lines.push('', '**变更节点**：');
+        for (const node of delta.changedNodes) {
+            lines.push(`- [${node.kind}] **${node.title}**: ${node.content}`);
+        }
+        const awarenessBlocks = delta.changedNodes
+            .map((node) => buildBlackboardNodeAwarenessBlock(node))
+            .filter((block) => block.trim().length > 0);
+        if (awarenessBlocks.length > 0) {
+            lines.push('', '### 跨 Agent 产物感知（系统自动注入）');
+            lines.push(...awarenessBlocks);
+        }
+    }
+    if (delta.changedEdges.length > 0) {
+        lines.push('', '**变更关系**：');
+        for (const edge of delta.changedEdges) {
+            lines.push(`- ${edge.fromNodeId} --[${edge.edgeType}]--> ${edge.toNodeId}`);
+        }
+    }
+    lines.push('', '后续判断请优先参考以上已确认事实，避免与团队状态脱节。');
+    return lines.join('\n');
+}
+export function broadcastBlackboardDelta(input) {
+    let delivered = 0;
+    const forceGlobal = input.delta.changedNodes.some((node) => isGlobalBroadcastNode(node));
+    for (const handle of input.agents) {
+        if (input.excludeAgentName && handle.name === input.excludeAgentName)
+            continue;
+        if (handle.status !== 'running' && handle.status !== 'starting')
+            continue;
+        if (!forceGlobal && input.delta.relatedTags.length > 0) {
+            const handleTags = getHandleTaskTags(handle, input.taskBoard);
+            if (!input.delta.relatedTags.some((tag) => handleTags.has(tag)))
+                continue;
+        }
+        input.bus.send(`${input.sessionId}:blackboard`, input.sp(handle.name), 'message', formatBlackboardDeltaMessage(input.delta));
+        delivered++;
+    }
+    return delivered;
+}
+export function broadcastWorkNoteAwareness(input) {
+    const awareness = buildWorkNoteAwarenessBlock(input.note, input.sourceAgentId);
+    if (!awareness.trim()) {
+        return 0;
+    }
+    const content = [
+        '### 工作笔记更新（系统自动注入）',
+        '',
+        awareness,
+        '',
+        '请把以上同伴产物/发现纳入当前判断，避免重复实现或接口漂移。',
+    ].join('\n');
+    let delivered = 0;
+    for (const handle of input.agents) {
+        if (handle.status !== 'running' && handle.status !== 'starting')
+            continue;
+        if (handle.agentId === input.sourceAgentId)
+            continue;
+        input.bus.send(`${input.sessionId}:work_note`, input.sp(handle.name), 'message', content);
+        delivered++;
+    }
+    return delivered;
+}
+//# sourceMappingURL=AgentPoolBroadcast.js.map

package/dist/agents/pool/AgentPoolBroadcast.js.map

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

package/dist/agents/pool/AgentPoolCompletionPayload.d.ts

@@ -0,0 +1,17 @@
+import type { WorkerArtifactTrace, WorkerContractComplianceProof, WorkerVerificationItem } from '../../core/AgentProtocol.js';
+import type { SpeculativeWinnerEvidence } from '../../core/SpeculativeExecutionController.js';
+export type StructuredCompletionPayload = {
+    summary?: string;
+    verdict?: 'PASS' | 'FAIL' | 'BLOCKED';
+    artifacts?: WorkerArtifactTrace;
+    verification?: WorkerVerificationItem[];
+    next_steps?: string[];
+    blocked_by_discovery?: string[];
+    needs_leader_coordination?: boolean;
+    evidence_refs?: string[];
+    contract_compliance?: WorkerContractComplianceProof;
+    toolTrace?: WorkerArtifactTrace;
+    taskRunGeneration?: number;
+    speculativeWinner?: SpeculativeWinnerEvidence;
+};
+//# sourceMappingURL=AgentPoolCompletionPayload.d.ts.map

package/dist/agents/pool/AgentPoolCompletionPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPoolCompletionPayload.d.ts","sourceRoot":"","sources":["../../../src/agents/pool/AgentPoolCompletionPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAE9F,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,CAAC,EAAE,6BAA6B,CAAC;IACpD,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CAC/C,CAAC"}

package/dist/agents/pool/AgentPoolCompletionPayload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AgentPoolCompletionPayload.js.map

package/dist/agents/pool/AgentPoolCompletionPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPoolCompletionPayload.js","sourceRoot":"","sources":["../../../src/agents/pool/AgentPoolCompletionPayload.ts"],"names":[],"mappings":""}

package/dist/agents/pool/AgentPoolEvents.d.ts

@@ -0,0 +1,20 @@
+import type { EventEmitter } from '../../core/EventEmitter.js';
+import type { MessageBus } from '../../core/MessageBus.js';
+import type { TaskBoard } from '../../core/TaskBoard.js';
+import type { RemoteWorkerDescriptor, RemoteWorkerRegistry } from '../../core/transport/RemoteWorkerRegistry.js';
+import type { AgentHandle } from '../AgentPoolRuntime.js';
+export declare function emitAgentSpawned(input: {
+    emitter: EventEmitter;
+    sessionId: string;
+    taskBoard: TaskBoard;
+    handle: AgentHandle;
+}): void;
+export declare function registerRemoteWorker(input: {
+    registry: RemoteWorkerRegistry;
+    bus: MessageBus;
+    sessionId: string;
+    endpoint: string;
+    capabilities: string[];
+    options?: Partial<Pick<RemoteWorkerDescriptor, 'id' | 'maxConcurrency' | 'region'>>;
+}): RemoteWorkerDescriptor;
+//# sourceMappingURL=AgentPoolEvents.d.ts.map

package/dist/agents/pool/AgentPoolEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPoolEvents.d.ts","sourceRoot":"","sources":["../../../src/agents/pool/AgentPoolEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACjH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG,IAAI,CAmBP;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,IAAI,GAAG,gBAAgB,GAAG,QAAQ,CAAC,CAAC,CAAC;CACrF,GAAG,sBAAsB,CAazB"}

package/dist/agents/pool/AgentPoolEvents.js

@@ -0,0 +1,35 @@
+export function emitAgentSpawned(input) {
+    const task = input.taskBoard.getTask(input.handle.taskId);
+    input.emitter.emit('agent:spawned', {
+        sessionId: input.sessionId,
+        agentId: input.handle.agentId,
+        agentName: input.handle.name,
+        role: input.handle.displayRole || input.handle.roleType,
+        taskId: input.handle.taskId,
+        workingDirectory: task?.working_directory,
+        writeScope: task?.write_scope,
+        baselineRole: input.handle.capabilityDetails?.baselineRole,
+        skillNames: input.handle.capabilityDetails?.skillNames,
+        droppedTools: input.handle.capabilityDetails?.droppedTools,
+        tools: input.handle.capabilityDetails?.tools,
+        backend: input.handle.workerBackend || 'worker_process',
+        externalSessionId: input.handle.externalSessionId,
+        pid: input.handle.externalPid,
+        logPath: input.handle.externalDiagnostics?.logPath,
+    });
+}
+export function registerRemoteWorker(input) {
+    const descriptor = {
+        id: input.options?.id ?? `remote-${input.endpoint.replace(/[^a-zA-Z0-9]+/g, '-').replace(/^-|-$/g, '')}`,
+        endpoint: input.endpoint,
+        capabilities: [...input.capabilities],
+        maxConcurrency: input.options?.maxConcurrency ?? 1,
+        currentLoad: 0,
+        region: input.options?.region,
+        lastHeartbeat: Date.now(),
+    };
+    input.registry.register(descriptor);
+    input.bus.send(`${input.sessionId}:agent_pool`, 'remote:worker_registry', 'worker_register', descriptor);
+    return descriptor;
+}
+//# sourceMappingURL=AgentPoolEvents.js.map

package/dist/agents/pool/AgentPoolEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPoolEvents.js","sourceRoot":"","sources":["../../../src/agents/pool/AgentPoolEvents.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,gBAAgB,CAAC,KAKhC;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;QAC7B,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ;QACvD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,gBAAgB,EAAE,IAAI,EAAE,iBAAiB;QACzC,UAAU,EAAE,IAAI,EAAE,WAAW;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,YAAY;QAC1D,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,UAAU;QACtD,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,YAAY;QAC1D,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK;QAC5C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,aAAa,IAAI,gBAAgB;QACvD,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB;QACjD,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;QAC7B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,mBAAmB,EAAE,OAAO;KACnD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAOpC;IACC,MAAM,UAAU,GAA2B;QACzC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,UAAU,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE;QACxG,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;QACrC,cAAc,EAAE,KAAK,CAAC,OAAO,EAAE,cAAc,IAAI,CAAC;QAClD,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM;QAC7B,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE;KAC1B,CAAC;IACF,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,aAAa,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;IACzG,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/agents/pool/FaultRecovery.d.ts

@@ -0,0 +1,106 @@
+import type { DatabaseManager } from '../../core/Database.js';
+import type { TaskBoard, Task as BoardTask } from '../../core/TaskBoard.js';
+import type { EventEmitter } from '../../core/EventEmitter.js';
+import type { AgentRoleRegistry } from '../RoleRegistry.js';
+import type { AgentRole } from '../RoleRegistry.js';
+import { type RecoveryFaultClass } from '../../core/RecoveryRecords.js';
+import type { LLMErrorKind } from '../../llm/errors.js';
+import { type WorkerRecoveryPayload } from '../../core/AgentProtocol.js';
+import type { TaskCompletePayload, TaskFailedPayload } from '../../core/AgentProtocol.js';
+export type FaultClass = 'timeout' | 'crash' | 'protocol' | 'network' | 'unknown';
+export type RecoveryAction = 'retry' | 'respawn' | 'requeue' | 'fail';
+export interface RecoveryDecision {
+    fault: FaultClass;
+    action: RecoveryAction;
+    reason: string;
+}
+/**
+ * 恢复执行路径所需的 handle 最小面（结构化，对应 AgentHandle 的子集）。
+ */
+export interface RecoveryHandleLike {
+    agentId: string;
+    name: string;
+    roleType: string;
+    taskId: string;
+    status: 'starting' | 'running' | 'stopped';
+    iteration?: number;
+    startTime: number;
+    lastProgress?: number;
+    taskRunGeneration?: number;
+    recoveryLineage?: number;
+    asyncTask?: Promise<string>;
+    runtimeRole?: AgentRole;
+    interactiveRuntime?: {
+        setStatus(status: string): void;
+        clearQueuedMessages(): void;
+        clearAllToolOutputs(): void;
+        getSnapshot(): unknown;
+    };
+    respawnTimestampsMs?: number[];
+    consecutiveRespawnFailures?: number;
+}
+/** 诊断载荷 —— 直接复用 WorkerRecoveryPayload 的契约类型（结构化，不重定义避免漂移）。 */
+export type RecoveryDiagnostics = NonNullable<WorkerRecoveryPayload['diagnostics']>;
+export interface AgentRespawnOptionsLike {
+    failureMode?: 'task_failed' | 'recovery';
+}
+/**
+ * 宿主上下文：恢复执行体所需的最小依赖面（确定性结构，无启发式）。
+ * AgentPool 把自身这些字段/方法交给子模块。
+ */
+export interface RecoveryHostContext {
+    readonly sessionId: string;
+    readonly db: DatabaseManager;
+    readonly taskBoard: TaskBoard;
+    readonly roleRegistry: AgentRoleRegistry;
+    readonly emitter: EventEmitter;
+    readonly autoRetryRecoveries: boolean;
+    readonly maxRecoveryAttempts: number;
+    /** 给 agent name 加会话前缀（MessageBus 寻址）。 */
+    sp(name: string): string;
+    getTaskRunGeneration(handle: RecoveryHandleLike): number;
+    forceStopAgent(handle: RecoveryHandleLike, exitReason: 'completed' | 'failed' | 'timeout' | 'crashed' | 'terminated', reason?: string): void;
+    cleanupWorkerInboxBridge(handle: RecoveryHandleLike): void;
+    emitInteractiveRuntimeState(handle: RecoveryHandleLike | undefined): void;
+    releaseHeavyResources(handle: RecoveryHandleLike): void;
+    /**
+     * 释放仍 claim 指定 task 的 active handle（转终态 + 回收资源）。
+     * 用于恢复失败路径解绑任务时同步清理 pool 侧，避免 board「无主」与 pool「active 占用」desync。
+     */
+    releaseHandleForTask(taskId: string, reason?: string): boolean;
+    sendCriticalBusMessageToLeader(from: string, type: 'task_complete' | 'task_failed' | 'worker_recovery', payload: TaskCompletePayload | TaskFailedPayload | WorkerRecoveryPayload): void;
+    respawnAgent(handle: RecoveryHandleLike, task: BoardTask, leaderMessage?: string, options?: AgentRespawnOptionsLike): Promise<string>;
+}
+export declare class FaultRecovery {
+    private host;
+    /** AgentPool 注入宿主上下文（构造期完成，运行期不变）。 */
+    bindHost(context: RecoveryHostContext): void;
+    classify(error: unknown): FaultClass;
+    decide(error: unknown, attempts: number): RecoveryDecision;
+    /**
+     * 标记 agent 进入恢复态：强制 stop → 清交互运行时 → 清 inbox bridge →
+     * emit 状态 → 计算 attempt/lineId → 应用预算决策 → 持久化 recoveryRecord →
+     * 构造 payload → critical bus 通知 leader → emit recovery:changed →
+     * 尝试自动重试（否则释放重型资源）。
+     *
+     * 调用顺序与原 AgentPool.markAgentRecovering 原样下沉，逐字对应。
+     */
+    markRecovering<H extends RecoveryHandleLike>(handle: H, faultClass: RecoveryFaultClass, reason: string, diagnostics?: RecoveryDiagnostics, llmErrorKind?: LLMErrorKind): WorkerRecoveryPayload;
+    /**
+     * 自动重试恢复中的 worker：满足前置条件 → prepareTaskForRedispatch →
+     * assignTask → respawnAgent → emit auto_retry_started → 失败回退 markRecoveryAutoRetryFailed。
+     *
+     * 调用顺序与原 AgentPool.maybeAutoRetryRecoveringWorker 原样下沉。
+     */
+    maybeAutoRetryRecoveringWorker<H extends RecoveryHandleLike>(handle: H, recovery: WorkerRecoveryPayload): boolean;
+    /**
+     * 自动重试失败：读 current → 写 leader_takeover recoveryRecord → 必要时
+     * prepareTaskForRedispatch → 构造 payload → emit auto_retry_failed。
+     *
+     * 调用顺序与原 AgentPool.markRecoveryAutoRetryFailed 原样下沉。
+     */
+    markAutoRetryFailed(recovery: WorkerRecoveryPayload, reason: string): void;
+    private requireHost;
+}
+export default FaultRecovery;
+//# sourceMappingURL=FaultRecovery.d.ts.map

package/dist/agents/pool/FaultRecovery.d.ts.map

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

package/dist/agents/pool/FaultRecovery.js

@@ -0,0 +1,290 @@
+import { getRecoveryRecord, saveRecoveryRecord, } from '../../core/RecoveryRecords.js';
+import { applyRecoveryAttemptBudget, classifyAutonomousFault } from '../../core/AutonomousFaultPolicy.js';
+import { createWorkerRecoveryPayload, } from '../../core/AgentProtocol.js';
+import { agentLogger } from '../../core/Log.js';
+// A8: 恢复重试指数退避基址与封顶。系统性崩溃的 worker 若立即重试 → spawn+LLM 风暴
+// (maxRecoveryAttempts 次无间隔连发)。按 attempt 退避:1s/2s/4s/8s...封顶 30s。
+const RECOVERY_BACKOFF_BASE_MS = 1_000;
+const RECOVERY_BACKOFF_MAX_MS = 30_000;
+export class FaultRecovery {
+    host = null;
+    /** AgentPool 注入宿主上下文（构造期完成，运行期不变）。 */
+    bindHost(context) {
+        this.host = context;
+    }
+    classify(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (/timeout|timed out|ETIMEDOUT/i.test(message))
+            return 'timeout';
+        if (/ECONNRESET|EPIPE|network|socket/i.test(message))
+            return 'network';
+        if (/protocol|contract|invalid payload/i.test(message))
+            return 'protocol';
+        if (/crash|exit|SIGKILL|SIGTERM/i.test(message))
+            return 'crash';
+        return 'unknown';
+    }
+    decide(error, attempts) {
+        const fault = this.classify(error);
+        if (fault === 'protocol') {
+            return { fault, action: 'fail', reason: 'protocol errors need corrected worker output' };
+        }
+        if (attempts <= 0) {
+            return { fault, action: 'fail', reason: 'retry budget exhausted' };
+        }
+        if (fault === 'network' || fault === 'timeout') {
+            return { fault, action: 'retry', reason: 'transient worker failure' };
+        }
+        if (fault === 'crash') {
+            return { fault, action: 'respawn', reason: 'worker process crashed' };
+        }
+        return { fault, action: 'requeue', reason: 'unknown failure should move task to another worker' };
+    }
+    /**
+     * 标记 agent 进入恢复态：强制 stop → 清交互运行时 → 清 inbox bridge →
+     * emit 状态 → 计算 attempt/lineId → 应用预算决策 → 持久化 recoveryRecord →
+     * 构造 payload → critical bus 通知 leader → emit recovery:changed →
+     * 尝试自动重试（否则释放重型资源）。
+     *
+     * 调用顺序与原 AgentPool.markAgentRecovering 原样下沉，逐字对应。
+     */
+    markRecovering(handle, faultClass, reason, diagnostics, llmErrorKind) {
+        const host = this.requireHost();
+        const exitReason = faultClass === 'worker_heartbeat_timeout' ||
+            faultClass === 'worker_max_runtime' ||
+            faultClass === 'external_agent_timeout'
+            ? 'timeout'
+            : 'crashed';
+        host.forceStopAgent(handle, exitReason, reason);
+        handle.interactiveRuntime?.setStatus('failed');
+        handle.interactiveRuntime?.clearQueuedMessages();
+        handle.interactiveRuntime?.clearAllToolOutputs();
+        host.cleanupWorkerInboxBridge(handle);
+        // 同 worker:complete —— 不在失败/崩溃时 detachFromTeam，保留 team 成员注册记录。
+        host.emitInteractiveRuntimeState(handle);
+        const taskRunGeneration = host.getTaskRunGeneration(handle);
+        const previous = getRecoveryRecord(host.db, host.sessionId, handle.taskId);
+        const attempt = (previous?.attempt || 0) + 1;
+        const lineId = previous?.lineId || `${handle.agentId}:${handle.taskId}`;
+        const decision = applyRecoveryAttemptBudget(classifyAutonomousFault({ reason, faultClass, llmErrorKind }), attempt, host.maxRecoveryAttempts);
+        handle.recoveryLineage = attempt;
+        const recoveryRecord = {
+            sessionId: host.sessionId,
+            taskId: handle.taskId,
+            agentId: handle.agentId,
+            agentName: handle.name,
+            roleType: handle.roleType,
+            category: decision.category,
+            faultClass,
+            status: decision.status,
+            reason: decision.reason,
+            recoveryAction: decision.recoveryAction,
+            attempt,
+            lineId,
+            lastActivityAt: handle.lastProgress ?? handle.startTime,
+            timestamp: Date.now() / 1000,
+        };
+        try {
+            saveRecoveryRecord(host.db, recoveryRecord);
+        }
+        catch (err) {
+            agentLogger.error(`[AgentPool] saveRecoveryRecord failed (${handle.name}/${handle.taskId}): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const recoveryPayload = createWorkerRecoveryPayload({
+            kind: 'worker_recovery',
+            taskId: handle.taskId,
+            taskRunGeneration,
+            agentId: handle.agentId,
+            agentName: handle.name,
+            roleType: handle.roleType,
+            category: decision.category,
+            faultClass,
+            ...(llmErrorKind ? { llmErrorKind } : {}),
+            status: decision.status,
+            recoveryAction: decision.recoveryAction,
+            reason: decision.reason,
+            attempt,
+            lineId,
+            lastActivityAt: recoveryRecord.lastActivityAt,
+            ...(diagnostics ? { diagnostics } : {}),
+        });
+        // 先决定是否自主重派，再把结果写进 payload 发给 Leader —— Leader 的 directive 才能
+        // 准确反映「系统已自动重派，验证勿重复 dispatch」。原顺序是先发再重派，Leader 拿不到
+        // 这个布尔，会对已被自主恢复接管的事件重复判读 / 冗余 redispatch（"干扰 leader" 根因）。
+        // maybeAutoRetryRecoveringWorker 的门控只读 recovery.status/recoveryAction/attempt 等，
+        // 已由上方 decision/attempt 算好，不依赖是否已发送，故提前调用安全。
+        const autoRetryStarted = this.maybeAutoRetryRecoveringWorker(handle, recoveryPayload);
+        recoveryPayload.autoRetryScheduled = autoRetryStarted;
+        // 系统已自主重派（autoRetryStarted=true）时【不】向 Leader 投递 P0 worker_recovery。
+        // 这是「agent 一出事就乱激活 leader」噪声的根因：每条 worker_recovery 都是 P0_CRITICAL，
+        // 会硬唤醒 Leader 跑一整轮 think（一次 LLM 调用），即便系统已自愈、Leader 跑完只能得出
+        // 「无需我动」。自主恢复由系统接管，Leader 通过持久化 recoveryRecord 懒感知，并在 respawn
+        // worker 最终 task_complete（P0）或恢复预算耗尽（attempt 达 max → leader_takeover →
+        // autoRetryStarted=false → 此处照常唤醒）时被适时唤醒。仅 leader_takeover / blocked /
+        // 不可恢复 / 无自主重派路径才 P0 唤醒。runtime_recovery:changed emit（UI）仍无条件触发。
+        if (!autoRetryStarted) {
+            host.sendCriticalBusMessageToLeader(host.sp(handle.name), 'worker_recovery', recoveryPayload);
+        }
+        host.emitter.emit('runtime_recovery:changed', {
+            sessionId: host.sessionId,
+            action: 'saved',
+            record: recoveryPayload,
+        });
+        if (!autoRetryStarted) {
+            host.releaseHeavyResources(handle);
+        }
+        return recoveryPayload;
+    }
+    /**
+     * 自动重试恢复中的 worker：满足前置条件 → prepareTaskForRedispatch →
+     * assignTask → respawnAgent → emit auto_retry_started → 失败回退 markRecoveryAutoRetryFailed。
+     *
+     * 调用顺序与原 AgentPool.maybeAutoRetryRecoveringWorker 原样下沉。
+     */
+    maybeAutoRetryRecoveringWorker(handle, recovery) {
+        const host = this.requireHost();
+        if (!host.autoRetryRecoveries) {
+            return false;
+        }
+        if (recovery.status !== 'recovering' ||
+            (recovery.recoveryAction !== 'worker_restart' && recovery.recoveryAction !== 'worker_redispatch')) {
+            return false;
+        }
+        if (recovery.attempt >= host.maxRecoveryAttempts) {
+            return false;
+        }
+        if (recovery.faultClass.startsWith('external_agent_')) {
+            return false;
+        }
+        const role = handle.runtimeRole || host.roleRegistry.get(handle.roleType);
+        if (role?.worker_backend && role.worker_backend !== 'worker_process') {
+            return false;
+        }
+        const task = host.taskBoard.getTask(recovery.taskId);
+        if (!task || task.status === 'terminal') {
+            return false;
+        }
+        try {
+            host.taskBoard.prepareTaskForRedispatch(recovery.taskId, `[recovering] ${recovery.reason}`);
+            const dispatchableTask = host.taskBoard.getTask(recovery.taskId) || task;
+            if (dispatchableTask.status === 'dispatchable') {
+                const assignedTask = host.taskBoard.assignTask(recovery.taskId, handle.name);
+                if (assignedTask) {
+                    handle.taskRunGeneration = assignedTask.runGeneration;
+                }
+            }
+            const retryTask = host.taskBoard.getTask(recovery.taskId) || dispatchableTask;
+            if (retryTask.status !== 'running' || retryTask.assigned_agent !== handle.name) {
+                throw new Error(`recovery auto retry could not assign task ${recovery.taskId} to @${handle.name}`);
+            }
+            // A8: 按 attempt 指数退避(1s/2s/4s...封顶 30s),防止系统性崩溃的 worker 被立即连发重试
+            // 形成 spawn+LLM 风暴。delay 期间 handle.asyncTask 占位,handle 视为 busy。
+            const backoffMs = Math.min(RECOVERY_BACKOFF_BASE_MS * 2 ** Math.max(0, recovery.attempt - 1), RECOVERY_BACKOFF_MAX_MS);
+            const respawnPromise = new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    host.respawnAgent(handle, retryTask, `[RECOVERY:${recovery.faultClass}] ${recovery.reason}`, { failureMode: 'recovery' }).then(resolve, reject);
+                }, backoffMs);
+                timer.unref?.();
+            });
+            handle.asyncTask = respawnPromise;
+            agentLogger.info(`[AgentPool] recovery auto retry scheduled @${handle.name} attempt=${recovery.attempt} backoff=${backoffMs}ms`);
+            host.emitter.emit('runtime_recovery:changed', {
+                sessionId: host.sessionId,
+                action: 'auto_retry_started',
+                taskId: recovery.taskId,
+                record: recovery,
+            });
+            void respawnPromise.catch((error) => {
+                const message = error instanceof Error ? error.message : String(error);
+                agentLogger.warn(`[AgentPool] recovery auto retry failed (@${handle.name}/${recovery.taskId}): ${message}`);
+                this.markAutoRetryFailed(recovery, message);
+                host.releaseHeavyResources(handle);
+            });
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            agentLogger.warn(`[AgentPool] recovery auto retry scheduling failed (@${handle.name}/${recovery.taskId}): ${message}`);
+            this.markAutoRetryFailed(recovery, message);
+            host.releaseHeavyResources(handle);
+            return false;
+        }
+    }
+    /**
+     * 自动重试失败：读 current → 写 leader_takeover recoveryRecord → 必要时
+     * prepareTaskForRedispatch → 构造 payload → emit auto_retry_failed。
+     *
+     * 调用顺序与原 AgentPool.markRecoveryAutoRetryFailed 原样下沉。
+     */
+    markAutoRetryFailed(recovery, reason) {
+        const host = this.requireHost();
+        const current = getRecoveryRecord(host.db, host.sessionId, recovery.taskId);
+        const record = {
+            sessionId: host.sessionId,
+            taskId: recovery.taskId,
+            agentId: current?.agentId ?? recovery.agentId,
+            agentName: current?.agentName ?? recovery.agentName,
+            roleType: current?.roleType ?? recovery.roleType,
+            category: current?.category ?? recovery.category,
+            faultClass: current?.faultClass ?? recovery.faultClass,
+            status: 'recovering',
+            reason: `auto retry failed: ${reason}; original recovery: ${current?.reason ?? recovery.reason}`,
+            recoveryAction: 'leader_takeover',
+            attempt: current?.attempt ?? recovery.attempt,
+            lineId: current?.lineId ?? recovery.lineId,
+            lastActivityAt: current?.lastActivityAt ?? recovery.lastActivityAt,
+            timestamp: Date.now() / 1000,
+        };
+        try {
+            saveRecoveryRecord(host.db, record);
+        }
+        catch (err) {
+            agentLogger.error(`[AgentPool] saveRecoveryRecord(auto_retry_failed) failed (${recovery.taskId}): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const task = host.taskBoard.getTask(recovery.taskId);
+        if (task && task.status !== 'terminal' && (task.status !== 'dispatchable' || task.assigned_agent)) {
+            host.taskBoard.prepareTaskForRedispatch(recovery.taskId, `[recovery_auto_retry_failed] ${reason}`);
+        }
+        // 恢复已确认失败（无成功 respawn 在途）：释放仍 claim 该 task 的 active handle，
+        // 否则 board 解绑后 pool 侧残留 active handle 会与 board「无主」desync，任务进死区
+        // （dispatch 判占用、force_complete 判未分配，谁都动不了）。
+        host.releaseHandleForTask(recovery.taskId, `[recovery_auto_retry_failed] ${reason}`);
+        const payload = createWorkerRecoveryPayload({
+            kind: 'worker_recovery',
+            taskId: record.taskId,
+            agentId: record.agentId,
+            agentName: record.agentName,
+            roleType: record.roleType,
+            category: record.category,
+            faultClass: record.faultClass,
+            status: record.status,
+            recoveryAction: record.recoveryAction,
+            reason: record.reason,
+            attempt: record.attempt,
+            lineId: record.lineId,
+            lastActivityAt: record.lastActivityAt,
+        });
+        // auto-retry 已确认失败 → 明确告知 Leader 需接管（autoRetryScheduled=false）
+        payload.autoRetryScheduled = false;
+        host.emitter.emit('runtime_recovery:changed', {
+            sessionId: host.sessionId,
+            action: 'auto_retry_failed',
+            taskId: recovery.taskId,
+            record: payload,
+            reason,
+        });
+        // leader_takeover 必须 P0 唤醒 Leader：auto-retry 已失败、系统无能为力，任务被
+        // prepareTaskForRedispatch 设回 dispatchable，若不唤醒 Leader 则既不被自动重派、也不被
+        // Leader 接手 → 永远卡 dispatchable → runtimeImpliesBusy 永真 → 前端永远 processing。
+        // 与 markRecovering 的 !autoRetryStarted 分支对称：凡需 Leader 介入的恢复结果都 P0 唤醒。
+        host.sendCriticalBusMessageToLeader(host.sp(record.agentName ?? recovery.agentName), 'worker_recovery', payload);
+    }
+    requireHost() {
+        if (!this.host) {
+            throw new Error('FaultRecovery host not bound');
+        }
+        return this.host;
+    }
+}
+export default FaultRecovery;
+//# sourceMappingURL=FaultRecovery.js.map