+ KiRt^RIt^RIt^RIt^RIHt^RIHtHt^RI t ] !0Rm4t RRRllt RRRllt R ^/R R lltR RR RRR/RRlltR#)z*Shared utility functions for hermes-agent.N)Path)AnyUnionFc<V^8dQhR\R\R\/#)valuedefaultreturn)rbool)formats""/home/ubuntu/hermes-agent/utils.py __annotate__r s!3$cVfV#\V\4'dV#\V\4'd&VP4P 4\ 9#\V4#)zDCoerce bool-ish values using the project's shared truthy string set.) isinstancer strstriplowerTRUTHY_STRINGS)rrs&&r is_truthy_valuersO }% %{{}""$66 ;rc<V^8dQhR\R\R\/#)rnamerr )rr )r s"r r r s&DD#DDTDrcD\\P!W4RR7#)zBReturn True when an environment variable is set to a truthy value.F)r)rosgetenv)rrs&&r env_var_enabledrs 299T3U CCrindentc nV^8dQhR\\\3,R\R\R\RR/#)rpathdatar dump_kwargsr N)rrrrint)r s"r r r sC// T / /  /  /  /rc \V4pVPPRRR7\P!\ VP4RVP R2RR7wrE\P!VRRR 7;_uu_4p\P!VV3R VR R /VBVP4\P!VP44R R R 4\P!WP4R # +'giL(;i \d+\P !T4h \"dhi;ii;i)aWrite JSON data to a file atomically. Uses temp file + fsync + os.replace to ensure the target file is never left in a partially-written state. If the process crashes mid-write, the previous version of the file remains intact. Args: path: Target file path (will be created or overwritten). data: JSON-serializable data to write. indent: JSON indentation (default 2). **dump_kwargs: Additional keyword args forwarded to json.dump(), such as default=str for non-native types. Tparentsexist_ok._.tmpdirprefixsuffixwutf-8encodingr ensure_asciiFN)rparentmkdirtempfilemkstemprstemrfdopenjsondumpflushfsyncfilenoreplace BaseExceptionunlinkOSError)rrrr fdtmp_pathfs&&$, r atomic_json_writerDs( :DKKdT2##  499+QLB  YYr3 1 1Q II  #      GGI HHQXXZ 2 8"2 1   IIh       sI&!D AC8D 8 D D ED.-E. D<9E;D<<Edefault_flow_style sort_keys extra_contentc V^8dQhR\\\3,R\R\R\R\R,RR/#)rrrrErFrGNr )rrrrr )r s"r r r QsQ-- T - - -  - : - -rc \V4pVPPRRR7\P!\ VP4RVP R2RR7wrV\P!VRRR 7;_uu_4p\P!WW#R 7V'dVPV4VP4\P!VP44R R R 4\P!W`4R # +'giL(;i \ d+\P"!T4h \$dhi;ii;i) aBWrite YAML data to a file atomically. Uses temp file + fsync + os.replace to ensure the target file is never left in a partially-written state. If the process crashes mid-write, the previous version of the file remains intact. Args: path: Target file path (will be created or overwritten). data: YAML-serializable data to write. default_flow_style: YAML flow style (default False). sort_keys: Whether to sort dict keys (default False). extra_content: Optional string to append after the YAML dump (e.g. commented-out sections for user reference). Tr#r&r'r(r)r-r.r/)rErFN)rr2r3r4r5rr6rr7yamlr9writer:r;r<r=r>r?r@)rrrErFrGrArBrCs&&$$$ r atomic_yaml_writerLQs, :DKKdT2##  499+QLB  YYr3 1 1Q IId2D Z & GGI HHQXXZ 2 8" 2 1   IIh       sI&!D A&D -D D D E,EE EEEE>1onyestrue)F))__doc__r8rr4pathlibrtypingrrrJ frozensetrrrrDrLrr rWsj0  56D / /d- % -  - !% --r