anantham-v2 2.0.0-alpha.1 → 2.0.2

package/dist/resume/external-lease-reconciler.js

@@ -0,0 +1,260 @@
+import { randomBytes } from "node:crypto";
+import { z } from "zod";
+import { LeaseStatusSchema } from "../domain/lease.js";
+export const ExternalLeaseKindSchema = z.enum([
+    "MCP_SERVER",
+    "REMOTE_EXECUTOR_NODE",
+    "TOOL_LOCK",
+    "SHARED_RESOURCE",
+]);
+export const ExternalLeaseReconciliationStatusSchema = z.enum([
+    "RENEWED_VALID",
+    "RE_ACQUIRED_NEW_GENERATION",
+    "REVOKED_UNREACHABLE",
+    "EXPIRED_AND_RELEASED",
+    "KEY_ROTATED_UPDATED",
+]);
+export const ExternalServiceLeaseSchema = z.object({
+    id: z.string().min(1),
+    leaseKind: ExternalLeaseKindSchema,
+    targetResourceId: z.string().min(1),
+    sessionId: z.string().min(1),
+    taskId: z.string().optional(),
+    generation: z.number().int().positive().default(1),
+    expiresAt: z.string(),
+    lastHeartbeatAt: z.string(),
+    ttlMs: z.number().int().positive().default(60_000),
+    status: LeaseStatusSchema.default("ACTIVE"),
+    credentialsRef: z.string().optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+export const ExternalLeaseReconciliationReportSchema = z.object({
+    sessionId: z.string(),
+    reconciledAt: z.string(),
+    totalLeases: z.number().int().nonnegative(),
+    renewedCount: z.number().int().nonnegative(),
+    revokedCount: z.number().int().nonnegative(),
+    keyRotatedCount: z.number().int().nonnegative(),
+    reconciliations: z.array(z.object({
+        leaseId: z.string(),
+        targetResourceId: z.string(),
+        leaseKind: ExternalLeaseKindSchema,
+        status: ExternalLeaseReconciliationStatusSchema,
+        previousGeneration: z.number(),
+        newGeneration: z.number().optional(),
+        explanation: z.string(),
+    })),
+});
+export class ExternalLeaseReconciler {
+    engine;
+    taskRepo;
+    eventStore;
+    resourceProber;
+    inMemoryLeases = new Map();
+    constructor(options = {}) {
+        this.engine = options.engine;
+        this.taskRepo = options.taskRepo;
+        this.eventStore = options.eventStore;
+        this.resourceProber = options.resourceProber ?? (async () => ({ alive: true, renewable: true }));
+    }
+    registerExternalLease(lease) {
+        const validated = ExternalServiceLeaseSchema.parse(lease);
+        this.inMemoryLeases.set(validated.id, validated);
+        if (this.engine) {
+            try {
+                const stmt = this.engine.raw.prepare(`
+          INSERT INTO external_service_leases (
+            id, lease_kind, target_resource_id, session_id, task_id,
+            generation, expires_at, last_heartbeat_at, ttl_ms, status,
+            credentials_ref, metadata_json
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          ON CONFLICT(id) DO UPDATE SET
+            generation = excluded.generation,
+            expires_at = excluded.expires_at,
+            last_heartbeat_at = excluded.last_heartbeat_at,
+            status = excluded.status,
+            credentials_ref = excluded.credentials_ref,
+            metadata_json = excluded.metadata_json;
+        `);
+                stmt.run(validated.id, validated.leaseKind, validated.targetResourceId, validated.sessionId, validated.taskId ?? null, validated.generation, validated.expiresAt, validated.lastHeartbeatAt, validated.ttlMs, validated.status, validated.credentialsRef ?? null, validated.metadata ? JSON.stringify(validated.metadata) : null);
+            }
+            catch { }
+        }
+    }
+    listLeases(sessionId) {
+        if (this.engine) {
+            try {
+                let sql = "SELECT * FROM external_service_leases";
+                const params = [];
+                if (sessionId) {
+                    sql += " WHERE session_id = ?";
+                    params.push(sessionId);
+                }
+                const rows = this.engine.raw.prepare(sql).all(...params);
+                if (rows.length > 0) {
+                    return rows.map((r) => ({
+                        id: r.id,
+                        leaseKind: r.lease_kind,
+                        targetResourceId: r.target_resource_id,
+                        sessionId: r.session_id,
+                        taskId: r.task_id ?? undefined,
+                        generation: Number(r.generation),
+                        expiresAt: r.expires_at,
+                        lastHeartbeatAt: r.last_heartbeat_at,
+                        ttlMs: Number(r.ttl_ms),
+                        status: r.status,
+                        credentialsRef: r.credentials_ref ?? undefined,
+                        metadata: r.metadata_json ? JSON.parse(r.metadata_json) : undefined,
+                    }));
+                }
+            }
+            catch { }
+        }
+        const all = Array.from(this.inMemoryLeases.values());
+        return sessionId ? all.filter((l) => l.sessionId === sessionId) : all;
+    }
+    async reconcileSingleLease(lease, options) {
+        const probeResult = await this.resourceProber(lease);
+        if (probeResult.alive && probeResult.renewable) {
+            const newGeneration = lease.generation + 1;
+            const newExpiresAt = new Date(Date.now() + lease.ttlMs).toISOString();
+            if (!options?.dryRun) {
+                lease.generation = newGeneration;
+                lease.expiresAt = newExpiresAt;
+                lease.lastHeartbeatAt = new Date().toISOString();
+                lease.status = "ACTIVE";
+                this.registerExternalLease(lease);
+                if (this.eventStore) {
+                    this.eventStore.append({
+                        id: "evt_ext_ls_ren_" + Date.now(),
+                        schemaVersion: 1,
+                        sessionId: lease.sessionId,
+                        taskId: lease.taskId,
+                        type: "lease.renewed",
+                        actor: "system",
+                        timestamp: new Date().toISOString(),
+                        payload: {
+                            leaseId: lease.id,
+                            targetResourceId: lease.targetResourceId,
+                            newGeneration,
+                            expiresAt: newExpiresAt,
+                        },
+                    });
+                }
+            }
+            return {
+                status: "RENEWED_VALID",
+                newGeneration,
+                explanation: "External resource responded healthy. Renewed lease with incremented generation token.",
+            };
+        }
+        else {
+            // Unreachable or expired
+            if (!options?.dryRun) {
+                lease.status = "REVOKED";
+                this.registerExternalLease(lease);
+                // Transition dependent task to blocked if taskRepo is available
+                if (lease.taskId && this.taskRepo) {
+                    try {
+                        const task = this.taskRepo.findById(lease.taskId);
+                        if (task && (task.status === "running" || task.status === "queued")) {
+                            this.taskRepo.save({
+                                ...task,
+                                status: "blocked",
+                                updatedAt: new Date().toISOString(),
+                                metadata: {
+                                    ...task.metadata,
+                                    blockedReason: "External resource lease unreachable: " + lease.targetResourceId,
+                                },
+                            });
+                        }
+                    }
+                    catch { }
+                }
+                if (this.eventStore) {
+                    this.eventStore.append({
+                        id: "evt_ext_ls_rev_" + Date.now(),
+                        schemaVersion: 1,
+                        sessionId: lease.sessionId,
+                        taskId: lease.taskId,
+                        type: "lease.revoked",
+                        actor: "system",
+                        timestamp: new Date().toISOString(),
+                        payload: {
+                            leaseId: lease.id,
+                            targetResourceId: lease.targetResourceId,
+                            error: probeResult.error ?? "Resource unreachable during resume",
+                        },
+                    });
+                }
+            }
+            return {
+                status: "REVOKED_UNREACHABLE",
+                explanation: "External resource probe failed: " + (probeResult.error ?? "Endpoint unreachable"),
+            };
+        }
+    }
+    async reconcileSessionLeases(sessionId, options) {
+        const leases = this.listLeases(sessionId);
+        const reconciliations = [];
+        let renewedCount = 0;
+        let revokedCount = 0;
+        for (const lease of leases) {
+            const outcome = await this.reconcileSingleLease(lease, options);
+            if (outcome.status === "RENEWED_VALID" || outcome.status === "RE_ACQUIRED_NEW_GENERATION") {
+                renewedCount++;
+            }
+            else {
+                revokedCount++;
+            }
+            reconciliations.push({
+                leaseId: lease.id,
+                targetResourceId: lease.targetResourceId,
+                leaseKind: lease.leaseKind,
+                status: outcome.status,
+                previousGeneration: lease.generation,
+                newGeneration: outcome.newGeneration,
+                explanation: outcome.explanation,
+            });
+        }
+        return {
+            sessionId,
+            reconciledAt: new Date().toISOString(),
+            totalLeases: leases.length,
+            renewedCount,
+            revokedCount,
+            keyRotatedCount: 0,
+            reconciliations,
+        };
+    }
+    async handleKeyRotation(sessionId, oldKeyRef, newKeyRef) {
+        const leases = this.listLeases(sessionId);
+        let updatedCount = 0;
+        for (const lease of leases) {
+            if (lease.credentialsRef === oldKeyRef) {
+                lease.credentialsRef = newKeyRef;
+                this.registerExternalLease(lease);
+                updatedCount++;
+                if (this.eventStore) {
+                    this.eventStore.append({
+                        id: "evt_key_rot_" + Date.now() + "_" + randomBytes(3).toString("hex"),
+                        schemaVersion: 1,
+                        sessionId,
+                        taskId: lease.taskId,
+                        type: "key.rotated",
+                        actor: "system",
+                        timestamp: new Date().toISOString(),
+                        payload: {
+                            leaseId: lease.id,
+                            targetResourceId: lease.targetResourceId,
+                            oldKeyRef,
+                            newKeyRef,
+                        },
+                    });
+                }
+            }
+        }
+        return { updatedCount };
+    }
+}
+//# sourceMappingURL=external-lease-reconciler.js.map

package/dist/resume/external-lease-reconciler.js.map

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

package/dist/resume/fork-point-recovery-manager.d.ts

@@ -0,0 +1,97 @@
+import { SqliteEngine } from "../persistence/sqlite-engine.js";
+import { SessionRepository } from "../persistence/repositories/session-repository.js";
+import { TaskRepository } from "../persistence/repositories/task-repository.js";
+import { EventStore } from "../event-state/event-store.js";
+import type { EventRepository } from "../persistence/repositories/event-repository.js";
+import type { CheckpointRepository } from "../persistence/repositories/checkpoint-repository.js";
+import type { ArtifactRepository } from "../persistence/repositories/artifact-repository.js";
+import type { DeltaSnapshotManager } from "../event-state/delta-snapshot-manager.js";
+import type { ProjectionManager } from "../event-state/projections/projection-manager.js";
+import { type HarnessEvent } from "../domain/event.js";
+import type { Session } from "../domain/session.js";
+export interface ForkPointRecoveryRequest {
+    sourceSessionId: string;
+    forkAtEventId?: string;
+    forkAtSequenceNumber?: number;
+    forkAtTimestamp?: string;
+    newSessionId?: string;
+    newBranchName: string;
+    newSessionName?: string;
+    modelProfile?: string;
+    keyPoolProfile?: string;
+    reconcileTasks?: boolean;
+    inheritMemory?: boolean;
+    reason?: string;
+}
+export interface ForkPointPreview {
+    sourceSessionId: string;
+    forkAtEventId: string;
+    forkAtTimestamp: string;
+    sequenceNumber: number;
+    totalAncestorEvents: number;
+    sessionStateAtFork: {
+        status: string;
+        branch: string;
+        activeTaskId?: string;
+    };
+    tasksAtFork: Array<{
+        id: string;
+        objective: string;
+        status: string;
+        reconciledStatus: string;
+    }>;
+    availableCheckpoints: string[];
+}
+export interface ForkPointRecoveryResult {
+    success: boolean;
+    recoveryId: string;
+    sourceSessionId: string;
+    forkedSessionId: string;
+    forkedAtEventId: string;
+    forkedAtTimestamp: string;
+    parentBranch: string;
+    newBranch: string;
+    inheritedEventsCount: number;
+    reconstructedTasksCount: number;
+    reconciledTasks: Array<{
+        taskId: string;
+        oldStatus: string;
+        newStatus: string;
+    }>;
+    parentSessionUntouched: boolean;
+    newSession: Session;
+    forkEvent: Readonly<HarnessEvent>;
+    durationMs: number;
+}
+export interface ForkPointRecoveryManagerOptions {
+    engine: SqliteEngine;
+    sessionRepo: SessionRepository;
+    taskRepo: TaskRepository;
+    eventRepo: EventRepository;
+    eventStore: EventStore;
+    checkpointRepo?: CheckpointRepository;
+    artifactRepo?: ArtifactRepository;
+    deltaSnapshotManager?: DeltaSnapshotManager;
+    projectionManager?: ProjectionManager;
+}
+export declare class ForkPointRecoveryManager {
+    private readonly engine;
+    private readonly sessionRepo;
+    private readonly taskRepo;
+    private readonly eventStore;
+    private readonly checkpointRepo?;
+    private readonly projectionManager?;
+    constructor(options: ForkPointRecoveryManagerOptions);
+    private resolveForkTarget;
+    validateForkSafety(sourceSessionId: string, forkAtEventId: string): {
+        safe: boolean;
+        errors: string[];
+    };
+    previewForkPoint(sourceSessionId: string, target: {
+        eventId?: string;
+        sequenceNumber?: number;
+        timestamp?: string;
+    }): Promise<ForkPointPreview>;
+    recoverFromForkPoint(request: ForkPointRecoveryRequest): Promise<ForkPointRecoveryResult>;
+}
+//# sourceMappingURL=fork-point-recovery-manager.d.ts.map

package/dist/resume/fork-point-recovery-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-point-recovery-manager.d.ts","sourceRoot":"","sources":["../../src/resume/fork-point-recovery-manager.ts"],"names":[],"mappings":"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"}

package/dist/resume/fork-point-recovery-manager.js

@@ -0,0 +1,275 @@
+import { randomBytes } from "node:crypto";
+import { reconstructSessionState } from "../event-state/reconstruction/session-reconstruct.js";
+import { reconstructTaskState } from "../event-state/reconstruction/task-reconstruct.js";
+import { EventTypes } from "../domain/event.js";
+export class ForkPointRecoveryManager {
+    engine;
+    sessionRepo;
+    taskRepo;
+    eventStore;
+    checkpointRepo;
+    projectionManager;
+    constructor(options) {
+        this.engine = options.engine;
+        this.sessionRepo = options.sessionRepo;
+        this.taskRepo = options.taskRepo;
+        this.eventStore = options.eventStore;
+        this.checkpointRepo = options.checkpointRepo;
+        this.projectionManager = options.projectionManager;
+    }
+    resolveForkTarget(sourceSessionId, target) {
+        const allEvents = this.eventStore.getEventsBySession(sourceSessionId);
+        if (allEvents.length === 0) {
+            throw new Error("Cannot fork from session with no events: " + sourceSessionId);
+        }
+        let targetSeq = allEvents.length;
+        let initialEvent = allEvents[allEvents.length - 1];
+        if (!initialEvent) {
+            throw new Error("No events in session");
+        }
+        let targetEvent = initialEvent;
+        if (target.eventId) {
+            const idx = allEvents.findIndex((e) => e.id === target.eventId);
+            if (idx === -1) {
+                throw new Error("Fork target event ID not found in session: " + target.eventId);
+            }
+            targetSeq = idx + 1;
+            const ev = allEvents[idx];
+            if (ev)
+                targetEvent = ev;
+        }
+        else if (typeof target.sequenceNumber === "number") {
+            targetSeq = Math.max(1, Math.min(target.sequenceNumber, allEvents.length));
+            const ev = allEvents[targetSeq - 1];
+            if (ev)
+                targetEvent = ev;
+        }
+        else if (target.timestamp) {
+            const idx = allEvents.findIndex((e) => e.timestamp >= target.timestamp);
+            if (idx !== -1) {
+                targetSeq = idx + 1;
+                const ev = allEvents[idx];
+                if (ev)
+                    targetEvent = ev;
+            }
+        }
+        return {
+            targetEvent,
+            sequenceNumber: targetSeq,
+            ancestorEvents: allEvents.slice(0, targetSeq),
+        };
+    }
+    validateForkSafety(sourceSessionId, forkAtEventId) {
+        const errors = [];
+        const session = this.sessionRepo.findById(sourceSessionId);
+        if (!session) {
+            errors.push("Source session not found: " + sourceSessionId);
+        }
+        const event = this.eventStore.getEventById(forkAtEventId);
+        if (!event) {
+            errors.push("Target fork event not found: " + forkAtEventId);
+        }
+        else if (event.sessionId !== sourceSessionId) {
+            errors.push("Target fork event does not belong to source session.");
+        }
+        return {
+            safe: errors.length === 0,
+            errors,
+        };
+    }
+    async previewForkPoint(sourceSessionId, target) {
+        const { targetEvent, sequenceNumber, ancestorEvents } = this.resolveForkTarget(sourceSessionId, target);
+        const sessionAgg = reconstructSessionState(sourceSessionId, ancestorEvents);
+        const taskIds = new Set();
+        for (const ev of ancestorEvents) {
+            if (ev.taskId)
+                taskIds.add(ev.taskId);
+        }
+        const tasksAtFork = [];
+        for (const tid of taskIds) {
+            const taskAgg = reconstructTaskState(tid, ancestorEvents);
+            const rawStatus = taskAgg.status;
+            const reconciledStatus = (rawStatus === "failed" || rawStatus === "running" || rawStatus === "claimed")
+                ? "queued"
+                : rawStatus;
+            tasksAtFork.push({
+                id: tid,
+                objective: taskAgg.objective ?? "Task " + tid,
+                status: rawStatus,
+                reconciledStatus,
+            });
+        }
+        const availableCheckpoints = [];
+        if (this.checkpointRepo) {
+            const chks = this.checkpointRepo.listBySession(sourceSessionId);
+            for (const c of chks) {
+                if (c.createdAt <= targetEvent.timestamp) {
+                    availableCheckpoints.push(c.id);
+                }
+            }
+        }
+        return {
+            sourceSessionId,
+            forkAtEventId: targetEvent.id,
+            forkAtTimestamp: targetEvent.timestamp,
+            sequenceNumber,
+            totalAncestorEvents: sequenceNumber,
+            sessionStateAtFork: {
+                status: sessionAgg.status,
+                branch: sessionAgg.branch ?? "main",
+                activeTaskId: sessionAgg.activeTaskId,
+            },
+            tasksAtFork,
+            availableCheckpoints,
+        };
+    }
+    async recoverFromForkPoint(request) {
+        const startTime = Date.now();
+        const sourceSession = this.sessionRepo.findById(request.sourceSessionId);
+        if (!sourceSession) {
+            throw new Error("Source session not found: " + request.sourceSessionId);
+        }
+        const safety = this.validateForkSafety(request.sourceSessionId, (request.forkAtEventId ?? this.eventStore.getEventsBySession(request.sourceSessionId).slice(-1)[0]?.id) || "");
+        if (!safety.safe) {
+            throw new Error("Cannot recover from fork point: " + safety.errors.join("; "));
+        }
+        const { targetEvent, sequenceNumber, ancestorEvents } = this.resolveForkTarget(request.sourceSessionId, {
+            eventId: request.forkAtEventId,
+            sequenceNumber: request.forkAtSequenceNumber,
+            timestamp: request.forkAtTimestamp,
+        });
+        const newSessionId = request.newSessionId ?? "sess_" + Date.now() + "_" + randomBytes(4).toString("hex");
+        const newSessionName = request.newSessionName ?? sourceSession.name + " (Recovered Fork)";
+        const modelProfile = request.modelProfile ?? sourceSession.modelProfile;
+        const keyPoolProfile = request.keyPoolProfile ?? sourceSession.keyPoolProfile;
+        const parentSnapshot = { ...sourceSession };
+        let createdSession;
+        let forkEvent;
+        const reconciledTasks = [];
+        const taskIds = new Set();
+        // Execute atomic transaction
+        this.engine.transaction(() => {
+            // 1. Create child session
+            const newSessionObj = {
+                id: newSessionId,
+                projectId: sourceSession.projectId,
+                name: newSessionName,
+                branch: request.newBranchName || "main-fork",
+                parentSessionId: sourceSession.id,
+                status: "active",
+                modelProfile,
+                keyPoolProfile,
+                mode: sourceSession.mode,
+                permissions: { ...sourceSession.permissions },
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                metadata: {
+                    forkedFromSessionId: sourceSession.id,
+                    forkedAtEventId: targetEvent.id,
+                    forkedAtTimestamp: targetEvent.timestamp,
+                    forkReason: request.reason ?? "Fork Point-in-Time Recovery",
+                },
+            };
+            this.sessionRepo.save(newSessionObj);
+            createdSession = newSessionObj;
+            // 2. Reconstruct & clone tasks with status reconciliation
+            for (const ev of ancestorEvents) {
+                if (ev.taskId)
+                    taskIds.add(ev.taskId);
+            }
+            for (const tid of taskIds) {
+                const taskAgg = reconstructTaskState(tid, ancestorEvents);
+                const originalStatus = taskAgg.status;
+                let newStatus = originalStatus;
+                const shouldReconcile = request.reconcileTasks !== false;
+                if (shouldReconcile && (originalStatus === "failed" || originalStatus === "running" || originalStatus === "claimed")) {
+                    newStatus = "queued";
+                    reconciledTasks.push({
+                        taskId: tid,
+                        oldStatus: originalStatus,
+                        newStatus,
+                    });
+                }
+                // Clone task to new session with new UUID
+                const newTaskId = "tsk_" + Date.now() + "_" + randomBytes(3).toString("hex");
+                const nowIso = new Date().toISOString();
+                this.taskRepo.save({
+                    id: newTaskId,
+                    projectId: sourceSession.projectId,
+                    sessionId: newSessionId,
+                    objective: taskAgg.objective ?? "Task " + tid,
+                    status: newStatus,
+                    priority: taskAgg.priority ?? "normal",
+                    agentRole: taskAgg.assignedAgent,
+                    dependencies: [],
+                    inputArtifacts: [],
+                    outputArtifacts: [],
+                    createdAt: nowIso,
+                    updatedAt: nowIso,
+                    metadata: {
+                        clonedFromTaskId: tid,
+                        reconciledFromStatus: originalStatus,
+                    },
+                });
+            }
+            // 3. Emit authoritative events to EventStore
+            forkEvent = this.eventStore.append({
+                id: "evt_fork_" + Date.now() + "_" + randomBytes(4).toString("hex"),
+                schemaVersion: 1,
+                projectId: sourceSession.projectId,
+                sessionId: newSessionId,
+                type: EventTypes.SESSION_FORKED,
+                actor: "user",
+                timestamp: new Date().toISOString(),
+                payload: {
+                    parentSessionId: sourceSession.id,
+                    branch: request.newBranchName || "main-fork",
+                    forkedAtEventId: targetEvent.id,
+                    forkedAtTimestamp: targetEvent.timestamp,
+                    reason: request.reason ?? "Point-in-time session recovery",
+                },
+            });
+            this.eventStore.append({
+                id: "evt_rec_" + Date.now() + "_" + randomBytes(4).toString("hex"),
+                schemaVersion: 1,
+                projectId: sourceSession.projectId,
+                sessionId: newSessionId,
+                type: "session.fork_point_recovered",
+                actor: "user",
+                timestamp: new Date().toISOString(),
+                payload: {
+                    sourceSessionId: sourceSession.id,
+                    forkedSessionId: newSessionId,
+                    inheritedEventsCount: sequenceNumber,
+                    reconciledTasksCount: reconciledTasks.length,
+                    reconciledTasks,
+                },
+            });
+        });
+        // Verify parent session remained untouched
+        const parentAfter = this.sessionRepo.findById(sourceSession.id);
+        const parentSessionUntouched = JSON.stringify(parentSnapshot) === JSON.stringify(parentAfter);
+        // Rebuild projection manager if present
+        if (this.projectionManager) {
+            this.projectionManager.rebuildAll();
+        }
+        return {
+            success: true,
+            recoveryId: "rec_" + Date.now() + "_" + randomBytes(4).toString("hex"),
+            sourceSessionId: sourceSession.id,
+            forkedSessionId: newSessionId,
+            forkedAtEventId: targetEvent.id,
+            forkedAtTimestamp: targetEvent.timestamp,
+            parentBranch: sourceSession.branch,
+            newBranch: request.newBranchName,
+            inheritedEventsCount: sequenceNumber,
+            reconstructedTasksCount: taskIds.size,
+            reconciledTasks,
+            parentSessionUntouched,
+            newSession: createdSession,
+            forkEvent: forkEvent,
+            durationMs: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=fork-point-recovery-manager.js.map