+ iaRt0tRt^RIt^RIt^RIHt^RIHt^RIHt^RI H t ]P!] 4t ^RIHtRs]^kRs]^kRs]^kRR ltR R ltR R ltRRltRRltRRltR# ]d ^RIHtLGi;i)u Timezone-aware clock for Hermes. Provides a single ``now()`` helper that returns a timezone-aware datetime based on the user's configured IANA timezone (e.g. ``Asia/Kolkata``). Resolution order: 1. ``HERMES_TIMEZONE`` environment variable 2. ``timezone`` key in ``~/.hermes/config.yaml`` 3. Falls back to the server's local time (``datetime.now().astimezone()``) Invalid timezone values log a warning and fall back safely — Hermes never crashes due to a bad timezone string. Ndatetime)Path)get_hermes_home)Optional)ZoneInfoFc$V^8dQhR\/#returnstr)formats"(/home/ubuntu/hermes-agent/hermes_time.py __annotate__r&sc\P!RR4P4pV'dV#^RIp\ 4pVR, pVP 4'd\ V4;_uu_4pVPV4;'g/pRRR4XPRR4p\V\4'd'VP4'dVP4#R# +'giL`;i \dR#i;i)zRead the configured IANA timezone string (or empty string). This does file I/O when falling through to config.yaml, so callers should cache the result rather than calling on every ``now()``. HERMES_TIMEZONENz config.yamltimezone) osgetenvstripyamlrexistsopen safe_loadget isinstancer Exception)tz_envr hermes_home config_pathfcfgtz_cfgs r_resolve_timezone_namer&&sYY(" - 3 3 5F    %' !M1     k""annQ'--2#WWZ,F&#&&6<<>>||~% #"    s1AC81C% AC8C8% C5 0C88 DDcFV^8dQhR\R\\,/#)r namer )r rr)rs"rrrBs    2 rcV'gR#\V4# \\3d"p\P RY4Rp?R#Rp?ii;i)z3Validate and return a ZoneInfo, or None if invalid.Nz=Invalid timezone '%s': %s. Falling back to server local time.)rKeyErrorrloggerwarning)r(excs& r _get_zoneinfor.BsC ~ i  K   s A AA c:V^8dQhR\\,/#r )rr)rs"rrrPs  hx( rc\\'g\4s\\4sRs\#)zReturn the user's configured ZoneInfo, or None (meaning server-local). Resolved once and cached. Call ``reset_cache()`` after config changes. T)_cache_resolvedr&_cached_tz_namer. _cached_tzrr get_timezoner5Ps& ?02"?3  rc$V^8dQhR\/#r r )rs"rrr]s!!3!rcN\'g \4\;'gR#)zAReturn the IANA name of the configured timezone, or empty string.r)r1r5r2r4rrget_timezone_namer8]s ?  b rc$V^8dQhR\/#r r)rs"rrres ' 'X 'rc\4pVe\P!V4#\P!4P4#)z Return the current time as a timezone-aware datetime. If a valid timezone is configured, returns wall-clock time in that zone. Otherwise returns the server's local time (via ``astimezone()``). )r5rnow astimezone)tzs rr;r;es4 B ~||B <<> $ $ &&rcV^8dQhRR/#)r r Nr4)rs"rrrssTrcRsRsRsR#)zBClear the cached timezone. Used by tests and after config changes.NF)r3r2r1r4rr reset_cacher@ssJOOrcV^8dQh/^\9d\\,;R&^\9d\\,;R&^\9d \;R&#)r r3r2r1)__conditional_annotations__rrr bool)rs"rrrsQ  @&%HX %A B&%#%C DE r)rB__doc__loggingrrpathlibrhermes_constantsrtypingr getLogger__name__r+zoneinfor ImportErrorbackports.zoneinfor3r2r1r&r.r5r8r;r@r)rBs@rrNs  ,   8 $,!"& %!%%8  ! 'q,+,sA:: B  B