| """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 | |