President Donald Trump has announced a framework agreement with Iran aimed at ending months of military conflict, hailing it as a historic diplomatic achievement that reopens a vital global oil shipping route.