[spec] Clarify API public interfaces.