Historical State Query Service

from typing import List, Optional
from datetime import datetime

def get_entity_history(
    entity_id: str,
    start_time: datetime,
    end_time: Optional[datetime] = None
) -> List[dict]:
    """
    Retrieve historical states for a specific entity within a time range.

    Args:
        entity_id: The entity ID to query (e.g., 'sensor.temperature')
        start_time: The start of the time range
        end_time: The end of the time range (defaults to now if not provided)

    Returns:
        A list of state dictionaries, each containing:
        - state: The state value
        - last_changed: Timestamp of when the state changed
        - attributes: Additional state attributes
    """
    pass

def configure_recorder(
    include_entities: Optional[List[str]] = None,
    exclude_entities: Optional[List[str]] = None
) -> dict:
    """
    Configure which entities should be recorded.

    Args:
        include_entities: List of entity IDs to include (if specified, only these are recorded)
        exclude_entities: List of entity IDs to exclude from recording

    Returns:
        A dictionary with the applied configuration
    """
    pass