Return the current date and time for an IANA timezone.

Reads the real system clock — this is the tool an agent should call instead of guessing "now". The result carries an explicit UTC offset and broken-out calendar fields so no downstream parsing is ambiguous.

Args: timezone: IANA timezone name (e.g. "UTC", "Europe/London", "America/New_York"). Defaults to "UTC".

Returns: A dict with the ISO-8601 timestamp (with offset), the resolved timezone, the UTC offset, the Unix timestamp, and broken-out calendar fields.

Return the date of a named weekday within the current week.

Answers "what is the date this Wednesday?" deterministically. "This week" is anchored to today in timezone and bounded by week_start.

Args: weekday: Weekday to resolve — full name or 3-letter abbreviation (e.g. "Wednesday", "wed"), case-insensitive. week_start: Day the week starts on. Omit to use the configured default ("Monday" unless overridden in config.ini). timezone: IANA timezone name anchoring "today". Omit to use the configured default (config.ini, else the detected OS zone, else "UTC").

Returns: The target date's calendar fields, the week's start/end dates, and context.

Validate a weekday+date claim against the current week and correct it.

The weekday name is authoritative: if claimed_date is not that weekday's date in the current week, is_correct is false and corrected_date gives the right date.

Args: weekday: The weekday the caller asserts — name or 3-letter abbreviation. claimed_date: The caller's asserted date, ISO YYYY-MM-DD. week_start: Day the week starts on. Omit to use the configured default. timezone: IANA timezone name anchoring "today". Omit to use the default.

Returns: is_correct, the claimed/corrected dates and weekday names, the week's start/end dates, and context.