anantham-v2 2.0.0-alpha.1

package/dist/remote/remote-dispatch-manager.js

@@ -0,0 +1,257 @@
+import { randomUUID } from "node:crypto";
+import { RemoteWorkRequestSchema, RemoteResultSchema, } from "../domain/node.js";
+import { EventTypes } from "../domain/event.js";
+import { RemoteAuthVerifier } from "./remote-auth-verifier.js";
+/**
+ * Authoritative Central Controller Remote Dispatch Manager.
+ * PRD Part 2 Section 140–165.
+ */
+export class RemoteDispatchManager {
+    dispatchRepo;
+    taskRepo;
+    nodeRegistry;
+    claimManager;
+    eventStore;
+    authVerifier;
+    constructor(options) {
+        this.dispatchRepo = options.dispatchRepo;
+        this.taskRepo = options.taskRepo;
+        this.nodeRegistry = options.nodeRegistry;
+        this.claimManager = options.claimManager;
+        this.eventStore = options.eventStore;
+        this.authVerifier = options.authVerifier ?? new RemoteAuthVerifier();
+    }
+    /**
+     * Dispatch a task to an eligible remote worker node.
+     * Performs idempotency check and acquires exclusive lease with monotonic generation token.
+     */
+    dispatchTask(options) {
+        const idempotencyKey = options.idempotencyKey || `idem_${randomUUID()}`;
+        // 1. Idempotency Check
+        const existing = this.dispatchRepo.findDispatchByIdempotencyKey(idempotencyKey);
+        if (existing) {
+            return existing;
+        }
+        // 2. Select Eligible Worker Node
+        let node = options.targetNodeId ? this.nodeRegistry.getNode(options.targetNodeId) : null;
+        if (!node) {
+            node = this.nodeRegistry.findEligibleNode(options.requiredCapabilities, options.projectId, options.executorProfile);
+        }
+        if (!node) {
+            throw new Error(`No eligible remote node available for capabilities [${(options.requiredCapabilities || []).join(", ")}] in project "${options.projectId}".`);
+        }
+        const instanceId = options.instanceId || `inst_${randomUUID()}`;
+        const dispatchId = options.dispatchId || `disp_${randomUUID()}`;
+        const now = new Date().toISOString();
+        // 3. Acquire Authoritative Lease & Monotonic Generation Token
+        const claimRes = this.claimManager.claimTask({
+            taskId: options.taskId,
+            agentId: options.agentId,
+            instanceId,
+            projectId: options.projectId,
+            sessionId: options.sessionId,
+        });
+        if (!claimRes.success || !claimRes.lease) {
+            throw new Error(`Failed to claim task "${options.taskId}" for remote dispatch: ${claimRes.errorMessage || "Lease acquisition rejected."}`);
+        }
+        // 4. Create RemoteWorkRequest Contract
+        const dispatch = RemoteWorkRequestSchema.parse({
+            dispatchId,
+            jobId: options.jobId || options.taskId,
+            taskId: options.taskId,
+            workflowId: options.workflowId,
+            runId: options.runId,
+            agentId: options.agentId,
+            instanceId,
+            nodeId: node.id,
+            projectId: options.projectId,
+            sessionId: options.sessionId,
+            planId: options.planId,
+            generation: claimRes.lease.generation, // Monotonic generation token
+            leaseId: claimRes.lease.id,
+            requiredCapabilities: options.requiredCapabilities || [],
+            budget: options.budget,
+            deadline: options.deadline,
+            payload: options.payload,
+            idempotencyKey,
+            createdAt: now,
+            status: "DISPATCHED",
+            metadata: {},
+        });
+        this.dispatchRepo.saveDispatch(dispatch);
+        this.emitEvent(EventTypes.DISPATCH_CREATED, dispatch, { nodeId: node.id });
+        this.emitEvent(EventTypes.DISPATCH_SENT, dispatch, {
+            nodeId: node.id,
+            generation: dispatch.generation,
+            leaseId: dispatch.leaseId,
+        });
+        return dispatch;
+    }
+    /**
+     * Handle authenticated remote heartbeat. Fencing tokens are strictly validated.
+     */
+    handleRemoteHeartbeat(req) {
+        const dispatch = this.dispatchRepo.findDispatchById(req.dispatchId);
+        if (!dispatch) {
+            return { success: false, reason: `Dispatch "${req.dispatchId}" not found.` };
+        }
+        if (dispatch.nodeId !== req.nodeId) {
+            return { success: false, reason: `Node mismatch: expected "${dispatch.nodeId}", got "${req.nodeId}".` };
+        }
+        // Monotonic Generation Fencing Check
+        if (dispatch.generation !== req.generation || dispatch.leaseId !== req.leaseId) {
+            this.emitEvent(EventTypes.REMOTE_SPLIT_BRAIN_DETECTED, dispatch, {
+                providedGeneration: req.generation,
+                expectedGeneration: dispatch.generation,
+                reason: "Stale heartbeat received from partitioned or superseded node.",
+            });
+            return {
+                success: false,
+                reason: `FENCING_VIOLATION: Provided lease (${req.leaseId}, gen: ${req.generation}) does not match active dispatch lease (${dispatch.leaseId}, gen: ${dispatch.generation}).`,
+            };
+        }
+        // Renew lease via TaskClaimManager
+        const hbRes = this.claimManager.heartbeat({
+            leaseId: req.leaseId,
+            agentId: req.agentId,
+            instanceId: req.instanceId,
+            generation: req.generation,
+        });
+        if (!hbRes.success) {
+            return { success: false, reason: hbRes.errorMessage };
+        }
+        // Refresh node heartbeat
+        this.nodeRegistry.heartbeat({ nodeId: req.nodeId });
+        return { success: true };
+    }
+    /**
+     * 7-Step Verification and acceptance pipeline for untrusted remote results.
+     * PRD Part 2 Section 154.
+     */
+    acceptRemoteResult(result) {
+        // Step 1: Schema validation
+        const parsed = RemoteResultSchema.safeParse(result);
+        if (!parsed.success) {
+            return { success: false, reason: `INVALID_SCHEMA: ${parsed.error.message}` };
+        }
+        const res = parsed.data;
+        // Step 2: Signature verification if signature is provided
+        if (res.signature) {
+            const payloadToVerify = {
+                dispatchId: res.dispatchId,
+                nodeId: res.nodeId,
+                taskId: res.taskId,
+                jobId: res.jobId,
+                generation: res.generation,
+                leaseId: res.leaseId,
+                status: res.status,
+            };
+            if (!this.authVerifier.verifySignature(payloadToVerify, res.signature)) {
+                this.emitEvent(EventTypes.REMOTE_RESULT_REJECTED, { dispatchId: res.dispatchId }, {
+                    reason: "Cryptographic signature verification failed.",
+                });
+                return { success: false, reason: "AUTHENTICATION_FAILED: Invalid signature." };
+            }
+        }
+        // Step 3: Dispatch lookup
+        const dispatch = this.dispatchRepo.findDispatchById(res.dispatchId);
+        if (!dispatch) {
+            return { success: false, reason: `Dispatch "${res.dispatchId}" not found.` };
+        }
+        if (dispatch.status === "COMPLETED") {
+            // Idempotent acceptance
+            return { success: true };
+        }
+        // Step 4: Monotonic Generation Fencing Check (Split-brain prevention)
+        if (dispatch.generation !== res.generation || dispatch.leaseId !== res.leaseId) {
+            this.emitEvent(EventTypes.REMOTE_SPLIT_BRAIN_DETECTED, dispatch, {
+                providedGeneration: res.generation,
+                expectedGeneration: dispatch.generation,
+                reason: "Stale completion attempt from partitioned or superseded node.",
+            });
+            return {
+                success: false,
+                reason: `FENCING_VIOLATION: Result carries stale generation "${res.generation}". Current active generation is "${dispatch.generation}".`,
+            };
+        }
+        // Step 5: Task status check
+        const task = this.taskRepo.findById(dispatch.taskId);
+        if (!task) {
+            return { success: false, reason: `Underlying task "${dispatch.taskId}" not found.` };
+        }
+        if (task.status === "cancelled") {
+            return { success: false, reason: `Task "${dispatch.taskId}" has already been cancelled.` };
+        }
+        // Step 6 & 7: Commit completion or failure to SQLite WAL in a single atomic transaction
+        if (res.status === "SUCCESS") {
+            let compSuccess = false;
+            this.dispatchRepo.sqliteEngine.transaction(() => {
+                compSuccess = this.claimManager.completeTask(dispatch.taskId, dispatch.leaseId, dispatch.generation, { artifacts: res.artifacts, data: res.data }, dispatch.agentId);
+                if (compSuccess) {
+                    dispatch.status = "COMPLETED";
+                    this.dispatchRepo.saveDispatch(dispatch);
+                }
+            });
+            if (!compSuccess) {
+                return { success: false, reason: "Failed to complete task in claim manager." };
+            }
+            this.emitEvent(EventTypes.DISPATCH_COMPLETED, dispatch, {
+                artifacts: res.artifacts,
+                consumption: res.consumption,
+            });
+            this.emitEvent(EventTypes.REMOTE_RESULT_RECEIVED, dispatch, { status: "SUCCESS" });
+            return { success: true };
+        }
+        else {
+            this.dispatchRepo.sqliteEngine.transaction(() => {
+                this.claimManager.failTask(dispatch.taskId, dispatch.leaseId, dispatch.generation, res.error || "Remote execution failed.", dispatch.agentId);
+                dispatch.status = "FAILED";
+                this.dispatchRepo.saveDispatch(dispatch);
+            });
+            this.emitEvent(EventTypes.DISPATCH_FAILED, dispatch, { error: res.error });
+            return { success: true };
+        }
+    }
+    /**
+     * Cancel an active remote dispatch.
+     */
+    cancelDispatch(dispatchId, reason = "User cancellation") {
+        const dispatch = this.dispatchRepo.findDispatchById(dispatchId);
+        if (!dispatch)
+            return;
+        if (dispatch.status === "COMPLETED" || dispatch.status === "CANCELLED") {
+            return;
+        }
+        dispatch.status = "CANCELLED";
+        this.dispatchRepo.saveDispatch(dispatch);
+        this.claimManager.releaseTask(dispatch.taskId, dispatch.leaseId, dispatch.generation, reason);
+        this.emitEvent(EventTypes.DISPATCH_FAILED, dispatch, { reason: `Cancelled: ${reason}` });
+    }
+    getDispatch(dispatchId) {
+        return this.dispatchRepo.findDispatchById(dispatchId);
+    }
+    emitEvent(type, dispatch, payload) {
+        if (!this.eventStore)
+            return;
+        this.eventStore.append({
+            id: randomUUID(),
+            schemaVersion: 1,
+            actor: "system",
+            timestamp: new Date().toISOString(),
+            type,
+            projectId: dispatch.projectId,
+            sessionId: dispatch.sessionId,
+            payload: {
+                dispatchId: dispatch.dispatchId,
+                taskId: dispatch.taskId,
+                jobId: dispatch.jobId,
+                agentId: dispatch.agentId,
+                nodeId: dispatch.nodeId,
+                generation: dispatch.generation,
+                leaseId: dispatch.leaseId,
+                ...payload,
+            },
+        });
+    }
+}
+//# sourceMappingURL=remote-dispatch-manager.js.map

package/dist/remote/remote-dispatch-manager.js.map

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

package/dist/remote/remote-node-client.d.ts

@@ -0,0 +1,44 @@
+import { type RemoteWorkRequest, type RemoteResult } from "../domain/node.js";
+import { RemoteAuthVerifier } from "./remote-auth-verifier.js";
+export type RemoteWorkerFn = (request: RemoteWorkRequest, abortSignal: AbortSignal) => Promise<{
+    artifacts?: string[];
+    data?: unknown;
+    tokensUsed?: number;
+    costUsd?: number;
+    durationMs?: number;
+    toolCalls?: number;
+}>;
+export interface RemoteNodeClientOptions {
+    nodeId: string;
+    authVerifier?: RemoteAuthVerifier;
+    heartbeatSender?: (req: {
+        dispatchId: string;
+        nodeId: string;
+        leaseId: string;
+        generation: number;
+        agentId: string;
+        instanceId: string;
+    }) => Promise<{
+        success: boolean;
+        reason?: string;
+    }>;
+    heartbeatIntervalMs?: number;
+}
+/**
+ * Remote Node Worker Client.
+ * Runs on the remote worker node, executes assigned work, sends heartbeats,
+ * and produces signed RemoteResult payloads.
+ * PRD Part 2 Section 140–165.
+ */
+export declare class RemoteNodeClient {
+    readonly nodeId: string;
+    private readonly authVerifier;
+    private readonly heartbeatSender?;
+    private readonly heartbeatIntervalMs;
+    constructor(options: RemoteNodeClientOptions);
+    /**
+     * Execute a received RemoteWorkRequest.
+     */
+    executeTask(request: RemoteWorkRequest, workerFn: RemoteWorkerFn): Promise<RemoteResult>;
+}
+//# sourceMappingURL=remote-node-client.d.ts.map

package/dist/remote/remote-node-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-node-client.d.ts","sourceRoot":"","sources":["../../src/remote/remote-node-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,WAAW,KACrB,OAAO,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAOoB;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAEjC,OAAO,EAAE,uBAAuB;IAO5C;;OAEG;IACU,WAAW,CACtB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;CA2GzB"}

package/dist/remote/remote-node-client.js

@@ -0,0 +1,124 @@
+import { RemoteWorkRequestSchema, RemoteResultSchema, } from "../domain/node.js";
+import { RemoteAuthVerifier } from "./remote-auth-verifier.js";
+/**
+ * Remote Node Worker Client.
+ * Runs on the remote worker node, executes assigned work, sends heartbeats,
+ * and produces signed RemoteResult payloads.
+ * PRD Part 2 Section 140–165.
+ */
+export class RemoteNodeClient {
+    nodeId;
+    authVerifier;
+    heartbeatSender;
+    heartbeatIntervalMs;
+    constructor(options) {
+        this.nodeId = options.nodeId;
+        this.authVerifier = options.authVerifier ?? new RemoteAuthVerifier();
+        this.heartbeatSender = options.heartbeatSender;
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? 5000;
+    }
+    /**
+     * Execute a received RemoteWorkRequest.
+     */
+    async executeTask(request, workerFn) {
+        const validatedReq = RemoteWorkRequestSchema.parse(request);
+        if (validatedReq.nodeId !== this.nodeId) {
+            throw new Error(`Node ID mismatch: WorkRequest targeted to "${validatedReq.nodeId}", but client is "${this.nodeId}".`);
+        }
+        const abortController = new AbortController();
+        let intervalId;
+        if (this.heartbeatSender) {
+            intervalId = setInterval(async () => {
+                try {
+                    const hbRes = await this.heartbeatSender({
+                        dispatchId: validatedReq.dispatchId,
+                        nodeId: this.nodeId,
+                        leaseId: validatedReq.leaseId,
+                        generation: validatedReq.generation,
+                        agentId: validatedReq.agentId,
+                        instanceId: validatedReq.instanceId,
+                    });
+                    if (!hbRes.success) {
+                        abortController.abort();
+                        clearInterval(intervalId);
+                    }
+                }
+                catch {
+                    abortController.abort();
+                    clearInterval(intervalId);
+                }
+            }, this.heartbeatIntervalMs);
+        }
+        try {
+            const output = await workerFn(validatedReq, abortController.signal);
+            if (intervalId)
+                clearInterval(intervalId);
+            const resultPayload = {
+                dispatchId: validatedReq.dispatchId,
+                nodeId: this.nodeId,
+                taskId: validatedReq.taskId,
+                jobId: validatedReq.jobId,
+                generation: validatedReq.generation,
+                leaseId: validatedReq.leaseId,
+                status: "SUCCESS",
+                artifacts: output.artifacts || [],
+                data: output.data,
+                consumption: {
+                    tokens: output.tokensUsed || 0,
+                    costUsd: output.costUsd || 0,
+                    durationMs: output.durationMs || 0,
+                    toolCalls: output.toolCalls || 0,
+                },
+                completedAt: new Date().toISOString(),
+            };
+            const signature = this.authVerifier.signPayload({
+                dispatchId: resultPayload.dispatchId,
+                nodeId: resultPayload.nodeId,
+                taskId: resultPayload.taskId,
+                jobId: resultPayload.jobId,
+                generation: resultPayload.generation,
+                leaseId: resultPayload.leaseId,
+                status: resultPayload.status,
+            });
+            return RemoteResultSchema.parse({
+                ...resultPayload,
+                signature,
+            });
+        }
+        catch (err) {
+            if (intervalId)
+                clearInterval(intervalId);
+            const resultPayload = {
+                dispatchId: validatedReq.dispatchId,
+                nodeId: this.nodeId,
+                taskId: validatedReq.taskId,
+                jobId: validatedReq.jobId,
+                generation: validatedReq.generation,
+                leaseId: validatedReq.leaseId,
+                status: "FAILURE",
+                artifacts: [],
+                consumption: { tokens: 0, costUsd: 0, durationMs: 0, toolCalls: 0 },
+                error: err.message || String(err),
+                completedAt: new Date().toISOString(),
+            };
+            const signature = this.authVerifier.signPayload({
+                dispatchId: resultPayload.dispatchId,
+                nodeId: resultPayload.nodeId,
+                taskId: resultPayload.taskId,
+                jobId: resultPayload.jobId,
+                generation: resultPayload.generation,
+                leaseId: resultPayload.leaseId,
+                status: resultPayload.status,
+            });
+            return RemoteResultSchema.parse({
+                ...resultPayload,
+                signature,
+            });
+        }
+        finally {
+            if (intervalId)
+                clearInterval(intervalId);
+        }
+    }
+}
+//# sourceMappingURL=remote-node-client.js.map

package/dist/remote/remote-node-client.js.map

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

package/dist/remote/remote-recovery-reconciler.d.ts

@@ -0,0 +1,33 @@
+import { type RemoteWorkRequest, type RemoteDispatchStatus } from "../domain/node.js";
+import { EventStore } from "../event-state/event-store.js";
+import { RemoteDispatchRepository } from "../persistence/repositories/remote-dispatch-repository.js";
+import { NodeRepository } from "../persistence/repositories/node-repository.js";
+import { TaskClaimManager } from "../tasks/task-claim-manager.js";
+export interface ReconciledDispatchSummary {
+    dispatchId: string;
+    nodeId: string;
+    previousStatus: RemoteDispatchStatus;
+    newStatus: RemoteDispatchStatus;
+    reclaimedLeaseId: string;
+    reconciledAt: string;
+}
+/**
+ * Remote Multi-Node Recovery & Partition Reconciler.
+ * PRD Part 1 Section 50–54 & PRD Part 2 Section 140–165.
+ */
+export declare class RemoteRecoveryReconciler {
+    private readonly dispatchRepo;
+    private readonly nodeRepo;
+    private readonly claimManager;
+    private readonly eventStore?;
+    constructor(dispatchRepo: RemoteDispatchRepository, nodeRepo: NodeRepository, claimManager: TaskClaimManager, eventStore?: EventStore | undefined);
+    /**
+     * Scan and reconcile active remote dispatches.
+     */
+    reconcileActiveDispatches(): ReconciledDispatchSummary[];
+    /**
+     * Reconcile a single remote dispatch.
+     */
+    reconcileSingleDispatch(dispatch: RemoteWorkRequest): ReconciledDispatchSummary;
+}
+//# sourceMappingURL=remote-recovery-reconciler.d.ts.map

package/dist/remote/remote-recovery-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-recovery-reconciler.d.ts","sourceRoot":"","sources":["../../src/remote/remote-recovery-reconciler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEtF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,oBAAoB,CAAC;IACrC,SAAS,EAAE,oBAAoB,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAHX,YAAY,EAAE,wBAAwB,EACtC,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,gBAAgB,EAC9B,UAAU,CAAC,EAAE,UAAU,YAAA;IAG1C;;OAEG;IACI,yBAAyB,IAAI,yBAAyB,EAAE;IAY/D;;OAEG;IACI,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,yBAAyB;CA+CvF"}

package/dist/remote/remote-recovery-reconciler.js

@@ -0,0 +1,72 @@
+import { randomUUID } from "node:crypto";
+import { EventTypes } from "../domain/event.js";
+/**
+ * Remote Multi-Node Recovery & Partition Reconciler.
+ * PRD Part 1 Section 50–54 & PRD Part 2 Section 140–165.
+ */
+export class RemoteRecoveryReconciler {
+    dispatchRepo;
+    nodeRepo;
+    claimManager;
+    eventStore;
+    constructor(dispatchRepo, nodeRepo, claimManager, eventStore) {
+        this.dispatchRepo = dispatchRepo;
+        this.nodeRepo = nodeRepo;
+        this.claimManager = claimManager;
+        this.eventStore = eventStore;
+    }
+    /**
+     * Scan and reconcile active remote dispatches.
+     */
+    reconcileActiveDispatches() {
+        const activeDispatches = this.dispatchRepo.listActiveDispatches();
+        const summaries = [];
+        for (const dispatch of activeDispatches) {
+            const summary = this.reconcileSingleDispatch(dispatch);
+            summaries.push(summary);
+        }
+        return summaries;
+    }
+    /**
+     * Reconcile a single remote dispatch.
+     */
+    reconcileSingleDispatch(dispatch) {
+        const previousStatus = dispatch.status;
+        const now = new Date().toISOString();
+        const node = this.nodeRepo.findNodeById(dispatch.nodeId);
+        // Release task lease on controller
+        this.claimManager.releaseTask(dispatch.taskId, dispatch.leaseId, dispatch.generation, "REMOTE_DISPATCH_RECONCILED");
+        const newStatus = "RECLAIMED";
+        dispatch.status = newStatus;
+        this.dispatchRepo.saveDispatch(dispatch);
+        if (this.eventStore) {
+            this.eventStore.append({
+                id: randomUUID(),
+                schemaVersion: 1,
+                actor: "system",
+                timestamp: now,
+                type: EventTypes.DISPATCH_RECLAIMED,
+                projectId: dispatch.projectId,
+                sessionId: dispatch.sessionId,
+                payload: {
+                    dispatchId: dispatch.dispatchId,
+                    taskId: dispatch.taskId,
+                    nodeId: dispatch.nodeId,
+                    previousStatus,
+                    newStatus,
+                    nodeStatus: node?.status || "UNKNOWN",
+                    reason: "Controller restart or node partition detected.",
+                },
+            });
+        }
+        return {
+            dispatchId: dispatch.dispatchId,
+            nodeId: dispatch.nodeId,
+            previousStatus,
+            newStatus,
+            reclaimedLeaseId: dispatch.leaseId,
+            reconciledAt: now,
+        };
+    }
+}
+//# sourceMappingURL=remote-recovery-reconciler.js.map

package/dist/remote/remote-recovery-reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-recovery-reconciler.js","sourceRoot":"","sources":["../../src/remote/remote-recovery-reconciler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAehD;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAEhB;IACA;IACA;IACA;IAJnB,YACmB,YAAsC,EACtC,QAAwB,EACxB,YAA8B,EAC9B,UAAuB;QAHvB,iBAAY,GAAZ,YAAY,CAA0B;QACtC,aAAQ,GAAR,QAAQ,CAAgB;QACxB,iBAAY,GAAZ,YAAY,CAAkB;QAC9B,eAAU,GAAV,UAAU,CAAa;IACvC,CAAC;IAEJ;;OAEG;IACI,yBAAyB;QAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,CAAC;QAClE,MAAM,SAAS,GAAgC,EAAE,CAAC;QAElD,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;YACvD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,uBAAuB,CAAC,QAA2B;QACxD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEzD,mCAAmC;QACnC,IAAI,CAAC,YAAY,CAAC,WAAW,CAC3B,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,UAAU,EACnB,4BAA4B,CAC7B,CAAC;QAEF,MAAM,SAAS,GAAyB,WAAW,CAAC;QACpD,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBACrB,EAAE,EAAE,UAAU,EAAE;gBAChB,aAAa,EAAE,CAAC;gBAChB,KAAK,EAAE,QAAQ;gBACf,SAAS,EAAE,GAAG;gBACd,IAAI,EAAE,UAAU,CAAC,kBAAkB;gBACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,OAAO,EAAE;oBACP,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,cAAc;oBACd,SAAS;oBACT,UAAU,EAAE,IAAI,EAAE,MAAM,IAAI,SAAS;oBACrC,MAAM,EAAE,gDAAgD;iBACzD;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,cAAc;YACd,SAAS;YACT,gBAAgB,EAAE,QAAQ,CAAC,OAAO;YAClC,YAAY,EAAE,GAAG;SAClB,CAAC;IACJ,CAAC;CACF"}

package/dist/resume/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./resume-contract.js";
+export * from "./task-dag-restorer.js";
+export * from "./pending-approval-restorer.js";
+export * from "./session-resume-engine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/resume/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resume/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC"}

package/dist/resume/index.js

@@ -0,0 +1,5 @@
+export * from "./resume-contract.js";
+export * from "./task-dag-restorer.js";
+export * from "./pending-approval-restorer.js";
+export * from "./session-resume-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/resume/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resume/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC"}

package/dist/resume/pending-approval-restorer.d.ts

@@ -0,0 +1,12 @@
+import type { HarnessEvent } from "../domain/event.js";
+import type { RestoredPendingApprovals } from "./resume-contract.js";
+export declare class PendingApprovalRestorer {
+    /**
+     * Reconstructs active pending approvals from the immutable event log.
+     * PRD Part 1 Section 56-57 & PRD Part 3 Section 146.
+     */
+    static restorePendingApprovals(events: Readonly<HarnessEvent>[], options?: {
+        nowMs?: number;
+    }): RestoredPendingApprovals;
+}
+//# sourceMappingURL=pending-approval-restorer.d.ts.map

package/dist/resume/pending-approval-restorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-approval-restorer.d.ts","sourceRoot":"","sources":["../../src/resume/pending-approval-restorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAuB,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,qBAAa,uBAAuB;IAClC;;;OAGG;WACW,uBAAuB,CACnC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,EAChC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,wBAAwB;CAyD5B"}