Queries multiple NTP servers, removes outliers, and computes a consensus time
that is independent of the system clock. Returns detailed information about
all sources, consensus method, and estimated error.

By default, the returned timestamp is compensated for the time it took to
query NTP servers and compute consensus. This means the timestamp represents
the time when the response is returned, not when NTP servers were queried.

Args:
    mode: Accuracy mode - "fast" uses 3-4 servers, "accurate" uses 7 servers
    compensate_latency: If True, add query duration to timestamp (default: True)

Returns:
    TimeResponse with consensus time and metadata

Queries multiple NTP servers for accurate UTC time, then converts to the
requested timezone. Includes all consensus metadata and source details.

Args:
    timezone_name: IANA timezone name (e.g., "America/New_York")
    mode: Accuracy mode - "fast" or "accurate"
    compensate_latency: If True, add query duration to timestamp (default: True)

Returns:
    TimezoneResponse with time in specified timezone

Useful for detecting system clock drift or misconfiguration. Queries NTP
servers and reports the difference between system time and consensus time.

Args:
    mode: Accuracy mode - "fast" or "accurate"

Returns:
    ClockComparisonResponse with comparison data

Uses NTP consensus for accurate UTC time, then converts to the requested
timezone using IANA tzdata. This provides authoritative local time independent
of system clock accuracy.

Args:
    timezone: IANA timezone identifier (e.g., "America/New_York", "Europe/London")
    mode: Accuracy mode - "fast" or "accurate"
    compensate_latency: If True, add query duration to timestamp (default: True)

Returns:
    LocalTimeResponse with local time and timezone metadata

Performs timezone conversion independent of system clock. Uses IANA tzdata
to handle all DST transitions, historical changes, and political boundaries.

Args:
    datetime_str: ISO 8601 datetime string (naive, will be interpreted in from_timezone)
    from_timezone: Source IANA timezone identifier
    to_timezone: Target IANA timezone identifier

Returns:
    TimezoneConversionResponse with conversion details and explanation

Returns all valid IANA timezone identifiers. Helps discover correct timezone
names and prevents hallucination of invalid timezones.

Args:
    country_code: Optional ISO 3166 country code filter (e.g., "US", "GB", "FR")
    search: Optional substring search filter (case-insensitive)

Returns:
    ListTimezonesResponse with list of timezones and metadata

Provides comprehensive timezone metadata including current offset, DST status,
and upcoming transitions (e.g., DST changes). Useful for planning and
understanding timezone behavior.

Args:
    timezone: IANA timezone identifier
    mode: Accuracy mode for getting current time - "fast" or "accurate"

Returns:
    TimezoneDetailResponse with current info and transition schedule