class MemoryError(Exception):
    """Base exception for all memory-related errors"""
    
    def __init__(self, message: str, error_code: str, details: dict = None, 
                 suggestion: str = None, debug_info: dict = None):
        self.message = message
        self.error_code = error_code
        self.details = details or {}
        self.suggestion = suggestion
        self.debug_info = debug_info or {}
        super().__init__(self.message)

class AuthenticationError(MemoryError):
    """Raised when authentication fails"""
    pass

class RateLimitError(MemoryError):
    """Raised when rate limits are exceeded"""
    pass

class ValidationError(MemoryError):
    """Raised when input validation fails"""
    pass

class MemoryNotFoundError(MemoryError):
    """Raised when a memory is not found"""
    pass

class NetworkError(MemoryError):
    """Raised when network connectivity issues occur"""
    pass

class ConfigurationError(MemoryError):
    """Raised when client configuration is invalid"""
    pass

class MemoryQuotaExceededError(MemoryError):
    """Raised when user's memory quota is exceeded"""
    pass

class MemoryCorruptionError(MemoryError):
    """Raised when memory data is corrupted"""
    pass

class VectorSearchError(MemoryError):
    """Raised when vector search operations fail"""
    pass

class CacheError(MemoryError):
    """Raised when caching operations fail"""
    pass

try:
    memory.add(content, user_id=user_id)
except RateLimitError as e:
    # Implement exponential backoff
    time.sleep(e.debug_info.get('retry_after', 60))
except MemoryQuotaExceededError as e:
    # Trigger quota upgrade flow
    logger.error(f"Quota exceeded: {e.error_code}")
except ValidationError as e:
    # Return user-friendly error
    raise HTTPException(400, detail=e.suggestion)