pi-harness-runtime 0.10.7 → 0.10.11

package/packages/checkpoint/dist/differ.js

@@ -1,197 +0,0 @@
-/**
- * Checkpoint Engine - Differ
- *
- * Calculate state diffs for incremental checkpoints.
- */
-import { createHash } from "node:crypto";
-// --- Diff Calculator -----------------------------------------------------
-export class DiffCalculator {
-    /**
-     * Calculate diff between two states
-     */
-    calculateDiff(jobId, baseVersion, targetVersion, baseState, targetState) {
-        const changes = {};
-        // Check status change
-        if (baseState.status !== targetState.status) {
-            changes.status = targetState.status;
-        }
-        // Calculate task changes
-        const taskDeltas = this.calculateTaskDeltas(baseState.tasks, targetState.tasks);
-        if (taskDeltas.length > 0) {
-            changes.tasks = taskDeltas;
-        }
-        // Check metadata changes
-        if (JSON.stringify(baseState.metadata) !==
-            JSON.stringify(targetState.metadata)) {
-            changes.metadata = targetState.metadata;
-        }
-        // Check for errors
-        if (baseState.lastError !== targetState.lastError) {
-            changes.errors = [
-                {
-                    error: targetState.lastError ?? "",
-                    timestamp: targetState.updatedAt,
-                    recoverable: targetState.status === "blocked",
-                },
-            ];
-        }
-        const timestamp = new Date().toISOString();
-        const checksum = this.calculateChecksum(jobId, baseVersion, targetVersion, changes);
-        return {
-            jobId,
-            baseVersion,
-            targetVersion,
-            changes,
-            timestamp,
-            checksum,
-        };
-    }
-    /**
-     * Calculate task deltas
-     */
-    calculateTaskDeltas(baseTasks, targetTasks) {
-        const deltas = [];
-        const baseMap = new Map(baseTasks.map((t) => [t.id, t]));
-        const targetMap = new Map(targetTasks.map((t) => [t.id, t]));
-        // Find added and updated tasks
-        for (const [taskId, targetTask] of targetMap) {
-            const baseTask = baseMap.get(taskId);
-            if (!baseTask) {
-                // Task was added
-                deltas.push({
-                    taskId,
-                    action: "added",
-                    after: targetTask,
-                });
-            }
-            else if (this.tasksAreDifferent(baseTask, targetTask)) {
-                // Task was updated
-                deltas.push({
-                    taskId,
-                    action: "updated",
-                    before: baseTask,
-                    after: targetTask,
-                });
-            }
-        }
-        // Find removed tasks
-        for (const [taskId, baseTask] of baseMap) {
-            if (!targetMap.has(taskId)) {
-                deltas.push({
-                    taskId,
-                    action: "removed",
-                    before: baseTask,
-                });
-            }
-        }
-        return deltas;
-    }
-    /**
-     * Check if two tasks are different
-     */
-    tasksAreDifferent(a, b) {
-        return (a.status !== b.status ||
-            a.title !== b.title ||
-            a.description !== b.description ||
-            a.assignedProvider !== b.assignedProvider ||
-            a.worktreePath !== b.worktreePath);
-    }
-    /**
-     * Calculate checksum for delta
-     */
-    calculateChecksum(jobId, baseVersion, targetVersion, changes) {
-        const data = JSON.stringify({
-            jobId,
-            baseVersion,
-            targetVersion,
-            changes,
-            timestamp: new Date().toISOString(),
-        });
-        return createHash("sha256").update(data).digest("hex");
-    }
-    /**
-     * Apply delta to base state
-     */
-    applyDelta(baseState, delta) {
-        const result = { ...baseState };
-        // Apply status change
-        if (delta.changes.status !== undefined) {
-            result.status = delta.changes.status;
-        }
-        // Apply task changes
-        if (delta.changes.tasks) {
-            result.tasks = this.applyTaskDeltas(baseState.tasks, delta.changes.tasks);
-        }
-        // Apply metadata changes
-        if (delta.changes.metadata !== undefined) {
-            result.metadata = delta.changes.metadata;
-        }
-        // Apply error changes
-        if (delta.changes.errors && delta.changes.errors.length > 0) {
-            const lastError = delta.changes.errors[delta.changes.errors.length - 1];
-            result.lastError = lastError.error;
-        }
-        // Update version and timestamp
-        result.version = delta.targetVersion;
-        result.updatedAt = new Date().toISOString();
-        return result;
-    }
-    /**
-     * Apply task deltas to task list
-     */
-    applyTaskDeltas(tasks, taskDeltas) {
-        const taskMap = new Map(tasks.map((t) => [t.id, { ...t }]));
-        for (const delta of taskDeltas) {
-            switch (delta.action) {
-                case "added":
-                    if (delta.after) {
-                        taskMap.set(delta.taskId, delta.after);
-                    }
-                    break;
-                case "updated":
-                    if (delta.after) {
-                        taskMap.set(delta.taskId, delta.after);
-                    }
-                    break;
-                case "removed":
-                    taskMap.delete(delta.taskId);
-                    break;
-            }
-        }
-        return Array.from(taskMap.values());
-    }
-    /**
-     * Reconstruct state from incremental checkpoints
-     */
-    async reconstructState(fullCheckpoint, deltas) {
-        // Sort deltas by version
-        const sortedDeltas = [...deltas].sort((a, b) => a.targetVersion - b.targetVersion);
-        // Apply each delta in order
-        let state = fullCheckpoint;
-        for (const delta of sortedDeltas) {
-            state = this.applyDelta(state, delta);
-        }
-        return state;
-    }
-    /**
-     * Estimate size of delta vs full checkpoint
-     */
-    estimateDeltaSavings(fullSize, baseState, targetState) {
-        const delta = this.calculateDiff(targetState.jobId, baseState.version, targetState.version, baseState, targetState);
-        const deltaJson = JSON.stringify(delta);
-        const deltaSize = Buffer.byteLength(deltaJson);
-        const savingsPercent = ((fullSize - deltaSize) / fullSize) * 100;
-        return {
-            deltaSize,
-            savingsPercent: Math.max(0, savingsPercent),
-        };
-    }
-}
-// --- Factory Function ----------------------------------------------------
-/**
- * Create a diff calculator
- */
-export function createDiffCalculator() {
-    return new DiffCalculator();
-}
-//# sourceMappingURL=differ.js.map

package/packages/checkpoint/dist/differ.js.map

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

package/packages/checkpoint/dist/engine.d.ts

@@ -1,74 +0,0 @@
-/**
- * Checkpoint Engine - Engine
- *
- * Main checkpoint engine with recovery strategies.
- */
-import type { CheckpointEngineConfig, CheckpointMetadata, PruneResult, RecoveryResult, RecoveryStrategy, RuntimeState, StateDelta, VerificationResult } from "./types.js";
-export declare class CheckpointEngine {
-    private readonly config;
-    private readonly storage;
-    private readonly differ;
-    private lastStates;
-    constructor(config: CheckpointEngineConfig);
-    /**
-     * Get current version for a job
-     */
-    private getCurrentVersion;
-    /**
-     * Create metadata for a checkpoint
-     */
-    private createMetadata;
-    /**
-     * Save a checkpoint (full or incremental based on config)
-     */
-    save(jobId: string, state: RuntimeState): Promise<CheckpointMetadata>;
-    /**
-     * Decide if we should use a full checkpoint
-     */
-    private shouldUseFullCheckpoint;
-    /**
-     * Save an incremental checkpoint explicitly
-     */
-    saveIncremental(jobId: string, delta: StateDelta): Promise<CheckpointMetadata>;
-    /**
-     * Load the latest state for a job
-     */
-    load(jobId: string): Promise<RuntimeState | null>;
-    /**
-     * Load state at specific version
-     */
-    loadState(jobId: string, version: number): Promise<RuntimeState | null>;
-    /**
-     * Reconstruct state from incremental checkpoint
-     */
-    private reconstructFromIncremental;
-    /**
-     * Recover job state using specified strategy
-     */
-    recover(jobId: string, strategy: RecoveryStrategy): Promise<RecoveryResult>;
-    /**
-     * Verify a checkpoint
-     */
-    verify(jobId: string, version: number): Promise<VerificationResult>;
-    /**
-     * Prune old checkpoints
-     */
-    prune(jobId: string, keepCount: number): Promise<PruneResult>;
-    /**
-     * Get metadata for all checkpoints
-     */
-    getMetadata(jobId: string): Promise<CheckpointMetadata[]>;
-    /**
-     * Get cached last state
-     */
-    getLastState(jobId: string): RuntimeState | undefined;
-    /**
-     * Delete all checkpoints for a job
-     */
-    deleteAll(jobId: string): Promise<void>;
-}
-/**
- * Create a checkpoint engine
- */
-export declare function createCheckpointEngine(config?: CheckpointEngineConfig): CheckpointEngine;
-//# sourceMappingURL=engine.d.ts.map

package/packages/checkpoint/dist/engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAIlB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAmBpB,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAwC;IAE1D,YAAY,MAAM,EAAE,sBAAsB,EAOzC;IAED;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsF1E;IAED;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACG,eAAe,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,kBAAkB,CAAC,CAoB7B;IAED;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAKtD;IAED;;OAEG;IACG,SAAS,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAU9B;IAED;;OAEG;YACW,0BAA0B;IAoDxC;;OAEG;IACG,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAkGzB;IAED;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8BxE;IAED;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwClE;IAED;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE9D;IAED;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpD;IAED;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5C;CACD;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,GAAE,sBAA2B,GACjC,gBAAgB,CAElB"}

package/packages/checkpoint/dist/engine.js

@@ -1,411 +0,0 @@
-/**
- * Checkpoint Engine - Engine
- *
- * Main checkpoint engine with recovery strategies.
- */
-import { DiffCalculator } from "./differ.js";
-import { StorageManager } from "./storage.js";
-// --- Default Configuration -------------------------------------------------
-const DEFAULT_CONFIG = {
-    rootDir: "./checkpoints",
-    compression: true,
-    incremental: true,
-    maxCheckpoints: 10,
-    autoPrune: true,
-    checksumAlgorithm: "sha256",
-    parallelWrites: true,
-    metadataIndex: true,
-};
-// --- Checkpoint Engine -----------------------------------------------------
-export class CheckpointEngine {
-    config;
-    storage;
-    differ;
-    lastStates = new Map();
-    constructor(config) {
-        this.config = { ...DEFAULT_CONFIG, ...config };
-        this.storage = new StorageManager(this.config.rootDir, {
-            compression: this.config.compression,
-            checksumAlgorithm: this.config.checksumAlgorithm,
-        });
-        this.differ = new DiffCalculator();
-    }
-    /**
-     * Get current version for a job
-     */
-    async getCurrentVersion(jobId) {
-        const index = await this.storage.loadIndex(jobId);
-        return index?.currentVersion ?? 0;
-    }
-    /**
-     * Create metadata for a checkpoint
-     */
-    createMetadata(jobId, version, type, state, baseVersion) {
-        const tasks = state.tasks ?? [];
-        return {
-            jobId,
-            version,
-            type,
-            sizeBytes: 0, // Will be updated by storage
-            compressed: this.config.compression,
-            checksum: "", // Will be updated by storage
-            taskProgress: {
-                total: tasks.length,
-                completed: tasks.filter((t) => t.status === "done").length,
-                failed: tasks.filter((t) => t.status === "failed").length,
-                running: tasks.filter((t) => t.status === "running").length,
-            },
-            createdAt: new Date().toISOString(),
-            baseVersion,
-        };
-    }
-    /**
-     * Save a checkpoint (full or incremental based on config)
-     */
-    async save(jobId, state) {
-        const currentVersion = await this.getCurrentVersion(jobId);
-        const newVersion = currentVersion + 1;
-        const now = new Date().toISOString();
-        // Update state version and timestamp
-        const updatedState = {
-            ...state,
-            version: newVersion,
-            updatedAt: now,
-        };
-        // Decide whether to use full or incremental
-        if (this.config.incremental &&
-            currentVersion > 0 &&
-            !this.shouldUseFullCheckpoint(updatedState)) {
-            // Save incremental checkpoint
-            const baseState = await this.loadState(jobId, currentVersion);
-            if (baseState) {
-                const delta = this.differ.calculateDiff(jobId, currentVersion, newVersion, baseState, updatedState);
-                const metadata = this.createMetadata(jobId, newVersion, "incremental", updatedState, currentVersion);
-                const checkpoint = {
-                    jobId,
-                    version: newVersion,
-                    type: "incremental",
-                    delta,
-                    metadata,
-                };
-                await this.storage.saveIncrementalCheckpoint(checkpoint);
-                this.lastStates.set(jobId, updatedState);
-                // Auto-prune if enabled
-                if (this.config.autoPrune) {
-                    this.prune(jobId, this.config.maxCheckpoints).catch((err) => {
-                        console.error("Auto-prune failed:", err);
-                    });
-                }
-                return checkpoint.metadata;
-            }
-        }
-        // Save full checkpoint
-        const metadata = this.createMetadata(jobId, newVersion, "full", updatedState);
-        const checkpoint = {
-            jobId,
-            version: newVersion,
-            type: "full",
-            state: updatedState,
-            metadata,
-        };
-        await this.storage.saveFullCheckpoint(checkpoint);
-        this.lastStates.set(jobId, updatedState);
-        // Auto-prune if enabled
-        if (this.config.autoPrune) {
-            this.prune(jobId, this.config.maxCheckpoints).catch((err) => {
-                console.error("Auto-prune failed:", err);
-            });
-        }
-        return checkpoint.metadata;
-    }
-    /**
-     * Decide if we should use a full checkpoint
-     */
-    shouldUseFullCheckpoint(state) {
-        // Use full checkpoint if:
-        // 1. Many tasks have changed
-        const taskCount = state.tasks?.length ?? 0;
-        if (taskCount > 100)
-            return true;
-        // 2. Status is terminal
-        if (["completed", "failed", "cancelled", "archived"].includes(state.status)) {
-            return true;
-        }
-        // 3. Random sampling (10% chance for non-incremental)
-        if (Math.random() < 0.1)
-            return true;
-        return false;
-    }
-    /**
-     * Save an incremental checkpoint explicitly
-     */
-    async saveIncremental(jobId, delta) {
-        const metadata = this.createMetadata(jobId, delta.targetVersion, "incremental", delta, delta.baseVersion);
-        const checkpoint = {
-            jobId,
-            version: delta.targetVersion,
-            type: "incremental",
-            delta,
-            metadata,
-        };
-        await this.storage.saveIncrementalCheckpoint(checkpoint);
-        return checkpoint.metadata;
-    }
-    /**
-     * Load the latest state for a job
-     */
-    async load(jobId) {
-        const version = await this.getCurrentVersion(jobId);
-        if (version === 0)
-            return null;
-        return this.loadState(jobId, version);
-    }
-    /**
-     * Load state at specific version
-     */
-    async loadState(jobId, version) {
-        const checkpoint = await this.storage.loadCheckpoint(jobId, version);
-        if (!checkpoint)
-            return null;
-        if (checkpoint.type === "full") {
-            return checkpoint.state;
-        }
-        // Reconstruct from incremental
-        return this.reconstructFromIncremental(jobId, checkpoint);
-    }
-    /**
-     * Reconstruct state from incremental checkpoint
-     */
-    async reconstructFromIncremental(jobId, incremental) {
-        const { delta } = incremental;
-        // Find the base full checkpoint
-        let baseState = null;
-        let baseVersion = delta.baseVersion;
-        // Walk back to find the full checkpoint
-        while (baseVersion > 0) {
-            const baseCheckpoint = await this.storage.loadCheckpoint(jobId, baseVersion);
-            if (!baseCheckpoint) {
-                baseVersion--;
-                continue;
-            }
-            if (baseCheckpoint.type === "full") {
-                baseState = baseCheckpoint.state;
-                break;
-            }
-            // It's another incremental, continue walking back
-            baseVersion = baseCheckpoint.delta.baseVersion;
-        }
-        if (!baseState) {
-            throw new Error(`Could not find base checkpoint for incremental ${incremental.version}`);
-        }
-        // Collect all deltas from base to target
-        const deltas = [];
-        let currentVersion = delta.baseVersion;
-        while (currentVersion < incremental.version) {
-            currentVersion++;
-            const cp = await this.storage.loadCheckpoint(jobId, currentVersion);
-            if (cp && cp.type === "incremental") {
-                deltas.push(cp.delta);
-            }
-        }
-        // Apply deltas
-        return this.differ.reconstructState(baseState, deltas);
-    }
-    /**
-     * Recover job state using specified strategy
-     */
-    async recover(jobId, strategy) {
-        const startTime = Date.now();
-        try {
-            const checkpoints = await this.storage.listCheckpoints(jobId);
-            if (checkpoints.length === 0) {
-                return {
-                    success: false,
-                    recoveredVersion: 0,
-                    lostEvents: 0,
-                    recoveryTimeMs: Date.now() - startTime,
-                    errors: ["No checkpoints found"],
-                };
-            }
-            let targetVersion;
-            // Handle recovery strategies
-            if (strategy === "latest") {
-                targetVersion = Math.max(...checkpoints.map((c) => c.version));
-            }
-            else if (strategy === "fullest") {
-                // Find checkpoint with most completed tasks
-                let maxCompleted = -1;
-                targetVersion = checkpoints[0].version;
-                for (const cp of checkpoints) {
-                    if (cp.taskProgress.completed > maxCompleted) {
-                        maxCompleted = cp.taskProgress.completed;
-                        targetVersion = cp.version;
-                    }
-                }
-            }
-            else if (strategy === "interactive") {
-                // Would need UI integration - use latest for now
-                targetVersion = Math.max(...checkpoints.map((c) => c.version));
-            }
-            else if (strategy.startsWith("specific:")) {
-                // Handle specific:N pattern
-                targetVersion = parseInt(strategy.split(":")[1], 10);
-            }
-            else if (strategy.startsWith("timestamp:")) {
-                // Handle timestamp:ISO pattern
-                const targetTime = new Date(strategy.split(":")[1]).getTime();
-                let minDiff = Infinity;
-                targetVersion = checkpoints[0].version;
-                for (const cp of checkpoints) {
-                    const cpTime = new Date(cp.createdAt).getTime();
-                    const diff = Math.abs(cpTime - targetTime);
-                    if (diff < minDiff) {
-                        minDiff = diff;
-                        targetVersion = cp.version;
-                    }
-                }
-            }
-            else {
-                // Default to latest
-                targetVersion = Math.max(...checkpoints.map((c) => c.version));
-            }
-            // Verify checkpoint
-            const verification = await this.verify(jobId, targetVersion);
-            if (!verification.valid) {
-                return {
-                    success: false,
-                    recoveredVersion: targetVersion,
-                    lostEvents: 0,
-                    recoveryTimeMs: Date.now() - startTime,
-                    errors: verification.corruptionDetails,
-                };
-            }
-            // Load state
-            const state = await this.loadState(jobId, targetVersion);
-            if (!state) {
-                return {
-                    success: false,
-                    recoveredVersion: targetVersion,
-                    lostEvents: 0,
-                    recoveryTimeMs: Date.now() - startTime,
-                    errors: ["Failed to load state"],
-                };
-            }
-            return {
-                success: true,
-                recoveredVersion: targetVersion,
-                recoveredState: state,
-                lostEvents: 0,
-                recoveryTimeMs: Date.now() - startTime,
-                warnings: verification.corruptionDetails?.length
-                    ? verification.corruptionDetails
-                    : undefined,
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                recoveredVersion: 0,
-                lostEvents: 0,
-                recoveryTimeMs: Date.now() - startTime,
-                errors: [error instanceof Error ? error.message : String(error)],
-            };
-        }
-    }
-    /**
-     * Verify a checkpoint
-     */
-    async verify(jobId, version) {
-        try {
-            const checkpoint = await this.storage.loadCheckpoint(jobId, version);
-            if (!checkpoint) {
-                return {
-                    valid: false,
-                    checksumMatch: false,
-                    corruptionDetails: ["Checkpoint not found"],
-                };
-            }
-            // For incremental checkpoints, chain verification is handled by storage
-            // We trust storage integrity for now
-            if (checkpoint.type === "incremental") {
-                // Delta checksum verification would require access to original data
-            }
-            return {
-                valid: true,
-                checksumMatch: true,
-            };
-        }
-        catch (error) {
-            return {
-                valid: false,
-                checksumMatch: false,
-                corruptionDetails: [
-                    error instanceof Error ? error.message : String(error),
-                ],
-            };
-        }
-    }
-    /**
-     * Prune old checkpoints
-     */
-    async prune(jobId, keepCount) {
-        const checkpoints = await this.storage.listCheckpoints(jobId);
-        const errors = [];
-        if (checkpoints.length <= keepCount) {
-            return {
-                deletedCount: 0,
-                freedBytes: 0,
-                remainingCount: checkpoints.length,
-            };
-        }
-        // Always keep the latest N checkpoints
-        const toDelete = checkpoints
-            .sort((a, b) => a.version - b.version)
-            .slice(0, checkpoints.length - keepCount);
-        let freedBytes = 0;
-        let deletedCount = 0;
-        for (const cp of toDelete) {
-            try {
-                await this.storage.deleteCheckpoint(jobId, cp.version);
-                freedBytes += cp.sizeBytes;
-                deletedCount++;
-            }
-            catch (error) {
-                errors.push(`Failed to delete checkpoint ${cp.version}: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        }
-        return {
-            deletedCount,
-            freedBytes,
-            remainingCount: checkpoints.length - deletedCount,
-            errors: errors.length > 0 ? errors : undefined,
-        };
-    }
-    /**
-     * Get metadata for all checkpoints
-     */
-    async getMetadata(jobId) {
-        return this.storage.listCheckpoints(jobId);
-    }
-    /**
-     * Get cached last state
-     */
-    getLastState(jobId) {
-        return this.lastStates.get(jobId);
-    }
-    /**
-     * Delete all checkpoints for a job
-     */
-    async deleteAll(jobId) {
-        await this.storage.deleteAllCheckpoints(jobId);
-        this.lastStates.delete(jobId);
-    }
-}
-// --- Factory Function ----------------------------------------------------
-/**
- * Create a checkpoint engine
- */
-export function createCheckpointEngine(config = {}) {
-    return new CheckpointEngine(config);
-}
-//# sourceMappingURL=engine.js.map