unrealon 1.0.9__py3-none-any.whl → 1.1.1__py3-none-any.whl

unrealon_sdk/src/dto/logging.py

@@ -1,230 +0,0 @@
-"""
-Logging-related Data Transfer Objects
-
-Custom DTO models for enterprise logging system functionality.
-These models provide type-safe logging configuration and event tracking.
-Includes models for both development logging and structured logging.
-"""
-
-from datetime import datetime, timezone
-from typing import Dict, List, Optional, Any
-from enum import Enum
-from dataclasses import dataclass
-
-from pydantic import BaseModel, Field, ConfigDict
-
-# Import LogEntryMessage at module level to avoid inline imports
-try:
-    from unrealon_sdk.src.enterprise.logging.service import LogEntryMessage
-except ImportError:
-    # Fallback for when logging service is not available
-    LogEntryMessage = None
-
-
-class LogDestination(str, Enum):
-    """Available log destinations."""
-    
-    CONSOLE = "console"
-    WEBSOCKET = "websocket"
-    FILE = "file"
-    HTTP = "http"
-    BUFFER = "buffer"
-
-
-class SDKEventType(str, Enum):
-    """SDK development event types for process tracking."""
-
-    # SDK Lifecycle Events
-    SDK_INITIALIZED = "sdk_initialized"
-    SDK_STARTED = "sdk_started"
-    SDK_SHUTDOWN = "sdk_shutdown"
-    SDK_ERROR = "sdk_error"
-
-    # Layer Development Events (Skyscraper Architecture)
-    LAYER_STARTED = "layer_started"
-    LAYER_COMPLETED = "layer_completed"
-    LAYER_VALIDATION = "layer_validation"
-    LAYER_FAILED = "layer_failed"
-
-    # Component Development Events
-    COMPONENT_CREATED = "component_created"
-    COMPONENT_TESTED = "component_tested"
-    COMPONENT_INTEGRATED = "component_integrated"
-    COMPONENT_DEPRECATED = "component_deprecated"
-
-    # Connection Management Events
-    CONNECTION_ESTABLISHED = "connection_established"
-    CONNECTION_LOST = "connection_lost"
-    CONNECTION_RETRY = "connection_retry"
-    CONNECTION_HEALTH_CHECK = "connection_health_check"
-
-    # Command Processing Events
-    COMMAND_RECEIVED = "command_received"
-    COMMAND_EXECUTED = "command_executed"
-    COMMAND_COMPLETED = "command_completed"
-    COMMAND_FAILED = "command_failed"
-    COMMAND_TIMEOUT = "command_timeout"
-
-    # Proxy Management Events
-    PROXY_MANAGER_INITIALIZED = "proxy_manager_initialized"
-    PROXY_ALLOCATED = "proxy_allocated"
-    PROXY_ROTATION = "proxy_rotation"
-    PROXY_HEALTH_CHECK = "proxy_health_check"
-    PROXY_BLACKLISTED = "proxy_blacklisted"
-
-    # Logging Service Events
-    LOGGING_SERVICE_INITIALIZED = "logging_service_initialized"
-    LOG_BUFFER_FLUSHED = "log_buffer_flushed"
-    LOG_WEBSOCKET_SENT = "log_websocket_sent"
-    LOG_WEBSOCKET_ERROR = "log_websocket_error"
-
-    # Performance Monitoring Events
-    PERFORMANCE_METRIC_COLLECTED = "performance_metric_collected"
-    PERFORMANCE_THRESHOLD_EXCEEDED = "performance_threshold_exceeded"
-    PERFORMANCE_OPTIMIZATION_APPLIED = "performance_optimization_applied"
-
-    # Error Recovery Events
-    ERROR_DETECTED = "error_detected"
-    ERROR_RECOVERY_STARTED = "error_recovery_started"
-    ERROR_RECOVERY_COMPLETED = "error_recovery_completed"
-    ERROR_RECOVERY_FAILED = "error_recovery_failed"
-
-    # API Integration Events
-    API_CALL_STARTED = "api_call_started"
-    API_CALL_COMPLETED = "api_call_completed"
-    API_CALL_FAILED = "api_call_failed"
-    API_RATE_LIMITED = "api_rate_limited"
-
-    # Development Quality Events
-    TYPE_SAFETY_VALIDATION = "type_safety_validation"
-    PYDANTIC_MODEL_VALIDATION = "pydantic_model_validation"
-    CODE_QUALITY_CHECK = "code_quality_check"
-    LINT_CHECK = "lint_check"
-
-    # Testing Events
-    TEST_STARTED = "test_started"
-    TEST_PASSED = "test_passed"
-    TEST_FAILED = "test_failed"
-    TEST_COVERAGE_MEASURED = "test_coverage_measured"
-
-    # Integration Events
-    CLIENT_INTEGRATION = "client_integration"
-    WEBSOCKET_INTEGRATION = "websocket_integration"
-    HTTP_INTEGRATION = "http_integration"
-
-    # Debug Events
-    DEBUG_CHECKPOINT = "debug_checkpoint"
-    DEBUG_VARIABLE_DUMP = "debug_variable_dump"
-    DEBUG_STACK_TRACE = "debug_stack_trace"
-
-
-class SDKSeverity(str, Enum):
-    """SDK development event severity levels."""
-
-    TRACE = "trace"  # Detailed tracing information
-    DEBUG = "debug"  # Debug information
-    INFO = "info"  # General information
-    WARNING = "warning"  # Warning conditions
-    ERROR = "error"  # Error conditions
-    CRITICAL = "critical"  # Critical conditions
-    FATAL = "fatal"  # Fatal conditions causing shutdown
-
-
-@dataclass
-class SDKContext:
-    """Context information for SDK development events."""
-
-    # Development context
-    layer_name: Optional[str] = None
-    component_name: Optional[str] = None
-    method_name: Optional[str] = None
-    file_path: Optional[str] = None
-    line_number: Optional[int] = None
-
-    # Runtime context
-    thread_id: Optional[str] = None
-    session_id: Optional[str] = None
-    correlation_id: Optional[str] = None
-
-    # Performance context
-    execution_time_ms: Optional[float] = None
-    memory_usage_mb: Optional[float] = None
-    cpu_usage_percent: Optional[float] = None
-
-    # Connection context
-    parser_id: Optional[str] = None
-    adapter_url: Optional[str] = None
-    websocket_connected: Optional[bool] = None
-    http_client_active: Optional[bool] = None
-
-    # Command context
-    command_id: Optional[str] = None
-    command_type: Optional[str] = None
-    command_priority: Optional[str] = None
-
-    # Additional metadata (use Any for flexible context data)
-    metadata: Optional[Any] = None
-
-
-class SDKDevelopmentEvent(BaseModel):
-    """Structured development event model for SDK logging."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Event identification
-    event_type: SDKEventType = Field(..., description="Type of SDK development event")
-    severity: SDKSeverity = Field(..., description="Event severity level")
-    timestamp: datetime = Field(
-        default_factory=lambda: datetime.now(timezone.utc), description="Event timestamp in UTC"
-    )
-
-    # Event details
-    message: str = Field(..., description="Human-readable event description")
-    details: Any = Field(
-        default_factory=dict, description="Additional event details (flexible structure)"
-    )
-
-    # Context information
-    context: SDKContext = Field(default_factory=SDKContext, description="Event context")
-
-    # Result information
-    success: bool = Field(..., description="Whether the operation was successful")
-    error_code: Optional[str] = Field(None, description="Error code if operation failed")
-    error_message: Optional[str] = Field(None, description="Error message if operation failed")
-
-    # Performance metrics
-    duration_ms: Optional[float] = Field(None, description="Operation duration in milliseconds")
-
-    def to_websocket_message(self, session_id: str) -> Any:
-        """Convert to WebSocket LogEntryMessage for real-time streaming."""
-        # Note: This method will use LogEntryMessage from enterprise logging service
-        if LogEntryMessage is None:
-            raise ImportError("LogEntryMessage not available - logging service not installed")
-        
-        return LogEntryMessage(
-            type="sdk_development_log",
-            session_id=session_id,
-            entry={
-                "event_type": self.event_type.value,
-                "severity": self.severity.value,
-                "message": self.message,
-                "success": self.success,
-                "details": self.details,
-                "context": self.context.__dict__ if hasattr(self.context, "__dict__") else {},
-                "error_code": self.error_code,
-                "error_message": self.error_message,
-                "duration_ms": self.duration_ms,
-            },
-            timestamp=self.timestamp.isoformat(),
-        )
-
-
-__all__ = [
-    # Enums
-    "LogDestination",
-    "SDKEventType", 
-    "SDKSeverity",
-    # Models
-    "SDKContext",
-    "SDKDevelopmentEvent",
-]

unrealon_sdk/src/dto/performance.py

@@ -1,165 +0,0 @@
-"""
-Performance Monitoring Data Transfer Objects
-
-DTO models for enterprise performance monitoring system functionality.
-These models provide type-safe performance metrics, alerts, and reporting.
-"""
-
-from datetime import datetime, timezone
-from typing import Dict, List, Optional, Any, Union
-from enum import Enum
-from dataclasses import dataclass, field
-
-from pydantic import BaseModel, Field, ConfigDict
-
-from unrealon_sdk.src.utils import generate_correlation_id
-
-
-class MetricType(str, Enum):
-    """Types of performance metrics."""
-    
-    COUNTER = "counter"           # Incrementing values (requests, errors)
-    GAUGE = "gauge"              # Point-in-time values (memory, CPU)
-    HISTOGRAM = "histogram"       # Distribution of values (response times)
-    TIMER = "timer"              # Elapsed time measurements
-    RATE = "rate"                # Events per time unit
-
-
-class AlertSeverity(str, Enum):
-    """Alert severity levels."""
-    
-    INFO = "info"
-    WARNING = "warning"
-    ERROR = "error"
-    CRITICAL = "critical"
-
-
-class MetricUnit(str, Enum):
-    """Metric measurement units."""
-    
-    # Time units
-    MILLISECONDS = "ms"
-    SECONDS = "s"
-    MINUTES = "min"
-    
-    # Size units
-    BYTES = "bytes"
-    KILOBYTES = "kb"
-    MEGABYTES = "mb"
-    
-    # Rate units
-    PER_SECOND = "/s"
-    PER_MINUTE = "/min"
-    
-    # Percentage
-    PERCENT = "%"
-    
-    # Count
-    COUNT = "count"
-
-
-@dataclass
-class MetricValue:
-    """Individual metric measurement."""
-    
-    timestamp: datetime
-    value: Union[int, float]
-    labels: Dict[str, str] = field(default_factory=dict)
-
-
-@dataclass
-class MetricThreshold:
-    """Threshold configuration for alerting."""
-    
-    warning_threshold: Optional[float] = None
-    error_threshold: Optional[float] = None
-    critical_threshold: Optional[float] = None
-    
-    # For rate-based alerts (e.g., error rate)
-    time_window_seconds: float = 60.0
-    min_samples: int = 5
-
-
-class PerformanceMetric(BaseModel):
-    """Performance metric model with metadata."""
-    
-    model_config = ConfigDict(extra="forbid")
-    
-    name: str = Field(..., description="Metric name")
-    metric_type: MetricType = Field(..., description="Type of metric")
-    unit: MetricUnit = Field(..., description="Measurement unit")
-    description: str = Field(..., description="Metric description")
-    
-    # Current values
-    current_value: Optional[float] = Field(default=None, description="Latest value")
-    total_samples: int = Field(default=0, description="Total number of samples")
-    
-    # Statistical data
-    min_value: Optional[float] = Field(default=None, description="Minimum recorded value")
-    max_value: Optional[float] = Field(default=None, description="Maximum recorded value")
-    avg_value: Optional[float] = Field(default=None, description="Average value")
-    
-    # Metadata
-    created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    last_updated: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    tags: Dict[str, str] = Field(default_factory=dict, description="Metric tags")
-
-
-class PerformanceAlert(BaseModel):
-    """Performance alert model."""
-    
-    model_config = ConfigDict(extra="forbid")
-    
-    alert_id: str = Field(default_factory=generate_correlation_id)
-    metric_name: str = Field(..., description="Name of metric that triggered alert")
-    severity: AlertSeverity = Field(..., description="Alert severity")
-    threshold_value: float = Field(..., description="Threshold that was exceeded")
-    current_value: float = Field(..., description="Current metric value")
-    message: str = Field(..., description="Alert message")
-    timestamp: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    acknowledged: bool = Field(default=False, description="Whether alert was acknowledged")
-    resolved: bool = Field(default=False, description="Whether alert was resolved")
-
-
-class PerformanceReport(BaseModel):
-    """Comprehensive performance report."""
-    
-    model_config = ConfigDict(extra="forbid")
-    
-    report_id: str = Field(default_factory=generate_correlation_id)
-    period_start: datetime = Field(..., description="Report period start")
-    period_end: datetime = Field(..., description="Report period end")
-    
-    # System metrics
-    avg_cpu_percent: float = Field(..., description="Average CPU usage")
-    avg_memory_mb: float = Field(..., description="Average memory usage in MB")
-    peak_memory_mb: float = Field(..., description="Peak memory usage in MB")
-    
-    # Operation metrics
-    total_operations: int = Field(..., description="Total operations performed")
-    avg_operation_time_ms: float = Field(..., description="Average operation time")
-    error_rate_percent: float = Field(..., description="Error rate percentage")
-    
-    # Network metrics
-    total_requests: int = Field(..., description="Total network requests")
-    avg_response_time_ms: float = Field(..., description="Average response time")
-    timeout_count: int = Field(..., description="Number of timeouts")
-    
-    # Alerts
-    total_alerts: int = Field(..., description="Total alerts generated")
-    critical_alerts: int = Field(..., description="Critical alerts")
-    unresolved_alerts: int = Field(..., description="Unresolved alerts")
-
-
-__all__ = [
-    # Enums
-    "MetricType",
-    "AlertSeverity", 
-    "MetricUnit",
-    # Models
-    "MetricValue",
-    "MetricThreshold",
-    "PerformanceMetric",
-    "PerformanceAlert",
-    "PerformanceReport",
-]

unrealon_sdk/src/dto/rate_limiting.py

@@ -1,295 +0,0 @@
-"""
-Rate Limiting DTOs - Data Transfer Objects for request throttling system.
-
-This module contains all Pydantic models and enums related to rate limiting,
-separated from business logic for clean architecture and reusability.
-
-Components:
-- Rate limiting strategies and configuration models
-- Throttling metrics and statistics models
-- Backoff algorithms and retry policies
-- Performance and analytics data structures
-"""
-
-import uuid
-from datetime import datetime, timezone, timedelta
-from typing import Dict, List, Optional, Any, Union
-from enum import Enum
-from dataclasses import dataclass, field
-
-from pydantic import BaseModel, Field, ConfigDict
-
-
-class RateLimitStrategy(str, Enum):
-    """Rate limiting strategies."""
-
-    TOKEN_BUCKET = "token_bucket"  # Token bucket algorithm
-    LEAKY_BUCKET = "leaky_bucket"  # Leaky bucket algorithm
-    SLIDING_WINDOW = "sliding_window"  # Sliding window counter
-    FIXED_WINDOW = "fixed_window"  # Fixed window counter
-    ADAPTIVE = "adaptive"  # Adaptive rate limiting based on load
-
-
-class BackoffStrategy(str, Enum):
-    """Backoff strategies for rate limiting."""
-
-    LINEAR = "linear"  # Linear backoff
-    EXPONENTIAL = "exponential"  # Exponential backoff
-    FIBONACCI = "fibonacci"  # Fibonacci sequence backoff
-    JITTERED = "jittered"  # Jittered exponential backoff
-    CUSTOM = "custom"  # Custom backoff function
-
-
-class RateLimitScope(str, Enum):
-    """Rate limit scope levels."""
-
-    GLOBAL = "global"  # Global rate limit across all operations
-    USER = "user"  # Per-user rate limiting
-    API_KEY = "api_key"  # Per-API key rate limiting
-    ENDPOINT = "endpoint"  # Per-endpoint rate limiting
-    OPERATION = "operation"  # Per-operation type rate limiting
-
-
-class RateLimitStatus(str, Enum):
-    """Rate limit operation status."""
-
-    ALLOWED = "allowed"  # Request allowed
-    THROTTLED = "throttled"  # Request throttled but queued
-    REJECTED = "rejected"  # Request rejected due to rate limit
-    RETRYING = "retrying"  # Request being retried with backoff
-
-
-class RateLimitEventType(str, Enum):
-    """Rate limit event types for monitoring."""
-
-    REQUEST_ALLOWED = "request_allowed"
-    REQUEST_THROTTLED = "request_throttled" 
-    REQUEST_REJECTED = "request_rejected"
-    LIMIT_EXCEEDED = "limit_exceeded"
-    QUOTA_RESET = "quota_reset"
-    BACKOFF_APPLIED = "backoff_applied"
-    ADAPTIVE_ADJUSTMENT = "adaptive_adjustment"
-
-
-class RateLimitConfig(BaseModel):
-    """Rate limiting configuration model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Basic limits
-    requests_per_second: float = Field(default=10.0, description="Requests per second limit")
-    requests_per_minute: int = Field(default=600, description="Requests per minute limit")
-    requests_per_hour: int = Field(default=36000, description="Requests per hour limit")
-    requests_per_day: int = Field(default=864000, description="Requests per day limit")
-
-    # Strategy configuration
-    strategy: RateLimitStrategy = Field(
-        default=RateLimitStrategy.TOKEN_BUCKET, description="Rate limiting strategy"
-    )
-    scope: RateLimitScope = Field(default=RateLimitScope.GLOBAL, description="Rate limit scope")
-
-    # Token bucket specific
-    bucket_capacity: int = Field(default=100, description="Token bucket capacity")
-    refill_rate: float = Field(default=10.0, description="Token refill rate per second")
-
-    # Sliding window specific
-    window_size_seconds: int = Field(default=60, description="Sliding window size in seconds")
-    window_segments: int = Field(default=10, description="Number of window segments")
-
-    # Backoff configuration
-    backoff_strategy: BackoffStrategy = Field(
-        default=BackoffStrategy.EXPONENTIAL, description="Backoff strategy"
-    )
-    base_delay_seconds: float = Field(default=1.0, description="Base delay for backoff")
-    max_delay_seconds: float = Field(default=300.0, description="Maximum delay for backoff")
-    backoff_multiplier: float = Field(default=2.0, description="Backoff multiplier")
-    jitter_enabled: bool = Field(default=True, description="Enable jitter in backoff")
-
-    # Adaptive configuration
-    adaptive_enabled: bool = Field(default=False, description="Enable adaptive rate limiting")
-    load_threshold: float = Field(default=0.8, description="Load threshold for adaptation")
-    adaptation_factor: float = Field(default=0.5, description="Rate adaptation factor")
-
-    # Queue configuration
-    queue_enabled: bool = Field(default=True, description="Enable request queuing")
-    max_queue_size: int = Field(default=1000, description="Maximum queue size")
-    queue_timeout_seconds: float = Field(default=30.0, description="Queue timeout")
-
-    # Monitoring
-    enable_metrics: bool = Field(default=True, description="Enable rate limit metrics")
-    metrics_window_seconds: int = Field(default=300, description="Metrics collection window")
-
-
-class RateLimitQuota(BaseModel):
-    """Rate limit quota tracking model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Identification
-    scope_id: str = Field(..., description="Scope identifier (user_id, api_key, etc.)")
-    scope_type: RateLimitScope = Field(..., description="Scope type")
-
-    # Current state
-    current_requests: int = Field(default=0, description="Current request count")
-    remaining_requests: int = Field(default=0, description="Remaining requests")
-    reset_time: datetime = Field(..., description="When quota resets")
-
-    # Limits
-    requests_limit: int = Field(..., description="Request limit for this quota")
-    window_start: datetime = Field(..., description="Window start time")
-    window_end: datetime = Field(..., description="Window end time")
-
-    # Token bucket state (if applicable)
-    tokens_available: float = Field(default=0.0, description="Available tokens")
-    last_refill: datetime = Field(
-        default_factory=lambda: datetime.now(timezone.utc), description="Last token refill time"
-    )
-
-    # Statistics
-    total_requests: int = Field(default=0, description="Total requests made")
-    throttled_requests: int = Field(default=0, description="Throttled requests")
-    rejected_requests: int = Field(default=0, description="Rejected requests")
-
-    def is_expired(self) -> bool:
-        """Check if quota window has expired."""
-        return datetime.now(timezone.utc) > self.reset_time
-
-    def time_until_reset(self) -> timedelta:
-        """Get time until quota resets."""
-        now = datetime.now(timezone.utc)
-        if now >= self.reset_time:
-            return timedelta(0)
-        return self.reset_time - now
-
-
-class RateLimitRequest(BaseModel):
-    """Rate limit request tracking model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Request identification
-    request_id: str = Field(default_factory=lambda: str(uuid.uuid4()))
-    scope_id: str = Field(..., description="Scope identifier")
-    scope_type: RateLimitScope = Field(..., description="Scope type")
-    operation_type: str = Field(..., description="Type of operation")
-
-    # Timing
-    timestamp: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
-    processing_time_ms: Optional[float] = Field(default=None, description="Processing time")
-
-    # Rate limit result
-    status: RateLimitStatus = Field(..., description="Rate limit decision")
-    retry_after_seconds: Optional[float] = Field(default=None, description="Retry after delay")
-    queue_position: Optional[int] = Field(default=None, description="Position in queue")
-
-    # Context
-    quota_remaining: int = Field(default=0, description="Remaining quota")
-    quota_reset_time: datetime = Field(..., description="Quota reset time")
-    backoff_count: int = Field(default=0, description="Number of backoff attempts")
-
-    # Metadata
-    user_agent: Optional[str] = Field(default=None, description="User agent")
-    ip_address: Optional[str] = Field(default=None, description="IP address")
-    additional_headers: Dict[str, str] = Field(
-        default_factory=dict, description="Additional request headers"
-    )
-
-
-class RateLimitStatistics(BaseModel):
-    """Rate limiting statistics model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Basic counters
-    total_requests: int = Field(default=0, description="Total requests processed")
-    allowed_requests: int = Field(default=0, description="Allowed requests")
-    throttled_requests: int = Field(default=0, description="Throttled requests")
-    rejected_requests: int = Field(default=0, description="Rejected requests")
-
-    # Performance metrics
-    avg_processing_time_ms: float = Field(default=0.0, description="Average processing time")
-    throttle_rate_percent: float = Field(default=0.0, description="Throttle rate percentage")
-    rejection_rate_percent: float = Field(default=0.0, description="Rejection rate percentage")
-
-    # Queue metrics
-    avg_queue_size: float = Field(default=0.0, description="Average queue size")
-    avg_queue_wait_time_ms: float = Field(default=0.0, description="Average queue wait time")
-    queue_timeouts: int = Field(default=0, description="Queue timeout count")
-
-    # Backoff metrics
-    total_backoffs: int = Field(default=0, description="Total backoff attempts")
-    avg_backoff_delay_ms: float = Field(default=0.0, description="Average backoff delay")
-    max_backoff_delay_ms: float = Field(default=0.0, description="Maximum backoff delay")
-
-    # Adaptive metrics (if enabled)
-    rate_adjustments: int = Field(default=0, description="Number of rate adjustments")
-    current_rate_multiplier: float = Field(default=1.0, description="Current rate multiplier")
-    system_load_percent: float = Field(default=0.0, description="Current system load")
-
-    # Time window
-    window_start: datetime = Field(
-        default_factory=lambda: datetime.now(timezone.utc), description="Statistics window start"
-    )
-    window_end: datetime = Field(
-        default_factory=lambda: datetime.now(timezone.utc), description="Statistics window end"
-    )
-    last_reset: datetime = Field(
-        default_factory=lambda: datetime.now(timezone.utc), description="Last statistics reset"
-    )
-
-
-class BackoffState(BaseModel):
-    """Backoff state tracking model."""
-
-    model_config = ConfigDict(extra="forbid")
-
-    # Identification
-    scope_id: str = Field(..., description="Scope identifier")
-    operation_type: str = Field(..., description="Operation type")
-
-    # Backoff state
-    attempt_count: int = Field(default=0, description="Current attempt count")
-    current_delay_seconds: float = Field(default=0.0, description="Current delay")
-    next_retry_time: datetime = Field(..., description="Next retry time")
-
-    # Configuration
-    strategy: BackoffStrategy = Field(..., description="Backoff strategy")
-    base_delay: float = Field(..., description="Base delay")
-    max_delay: float = Field(..., description="Maximum delay")
-    multiplier: float = Field(default=2.0, description="Backoff multiplier")
-
-    # History
-    retry_history: List[datetime] = Field(
-        default_factory=list, description="Retry attempt timestamps"
-    )
-    success_time: Optional[datetime] = Field(default=None, description="Last success time")
-
-    def can_retry(self) -> bool:
-        """Check if retry is allowed now."""
-        return datetime.now(timezone.utc) >= self.next_retry_time
-
-    def time_until_retry(self) -> timedelta:
-        """Get time until next retry is allowed."""
-        now = datetime.now(timezone.utc)
-        if now >= self.next_retry_time:
-            return timedelta(0)
-        return self.next_retry_time - now
-
-
-__all__ = [
-    # Enums
-    "RateLimitStrategy",
-    "BackoffStrategy",
-    "RateLimitScope",
-    "RateLimitStatus",
-    "RateLimitEventType",
-
-    # Configuration models
-    "RateLimitConfig",
-
-    # Data models
-    "RateLimitQuota",
-    "RateLimitRequest",
-    "RateLimitStatistics",
-    "BackoffState",
-]