import type { CompiledBuildPlan } from "../core/buildPlan.js";
import { type ExecutionLimits, type ArtifactReference, type GraphEvent, type GraphExecutionState } from "../core/scheduler.js";
import type { RunPaths } from "./artifacts.js";
import { type BuildDispatchSealReference } from "./buildArtifacts.js";
import { type CheckpointFailurePoint, type GraphCheckpointLease, type GraphCheckpointPaths } from "../runtime/graphCheckpoint.js";
export interface BuildGraphExecutionOptions {
    owner: Readonly<GraphCheckpointLease>;
    graphOwner: Readonly<GraphCheckpointLease>;
    now: string;
    pid: number;
    limits: Readonly<ExecutionLimits>;
}
export interface BuildGraphCheckpointOptions {
    owner: Readonly<GraphCheckpointLease>;
    graphOwner: Readonly<GraphCheckpointLease>;
    tempId: string;
    failAt?(point: CheckpointFailurePoint): void;
}
export declare function buildGraphExecutionPaths(paths: RunPaths, planVersion?: number): GraphCheckpointPaths;
export declare function acquireBuildGraphExecutionLease(paths: RunPaths, owner: Readonly<GraphCheckpointLease>, options: Readonly<{
    now: string;
    pid: number;
    planVersion?: number;
    isProcessAlive?(pid: number): boolean;
}>): GraphCheckpointLease;
/**
 * Create or recover the immutable BUILD graph under both the outer lifecycle
 * generation and the separately acquired nested graph generation.
 */
export declare function initializeBuildGraphExecution(paths: RunPaths, compiled: Readonly<CompiledBuildPlan>, options: Readonly<BuildGraphExecutionOptions>): GraphExecutionState;
export declare function recoverBuildGraphExecution(paths: RunPaths, compiled: Readonly<CompiledBuildPlan>, options: Readonly<{
    owner: Readonly<GraphCheckpointLease>;
    graphOwner: Readonly<GraphCheckpointLease>;
    tempId: string;
}>): GraphExecutionState;
export declare function checkpointBuildGraphEvent(paths: RunPaths, compiled: Readonly<CompiledBuildPlan>, state: Readonly<GraphExecutionState>, event: Readonly<GraphEvent>, options: Readonly<BuildGraphCheckpointOptions>): GraphExecutionState;
export declare function releaseBuildGraphExecution(paths: RunPaths, owner: Readonly<GraphCheckpointLease>, planVersion?: number): boolean;
export declare function mirrorBuildNodeArtifactToGraph(paths: RunPaths, reference: Readonly<ArtifactReference>, options: Readonly<{
    owner: Readonly<GraphCheckpointLease>;
    graphOwner: Readonly<GraphCheckpointLease>;
}>): ArtifactReference;
export declare function mirrorBuildDispatchSealToGraph(paths: RunPaths, reference: Readonly<BuildDispatchSealReference>, options: Readonly<{
    owner: Readonly<GraphCheckpointLease>;
    graphOwner: Readonly<GraphCheckpointLease>;
}>): ArtifactReference;