"""User-display-safe error types.""" class UserFacingError(Exception): """Raised for conditions that should be shown to end users (clear message).""" def __init__(self, message: str, *, details: str | None = None) -> None: super().__init__(message) self.user_message = message self.details = details