`gjQ!tUdZddlmZddlZddlmZmZddlm Z ddl m Z ddl Z ddl mZdZd Zd Zd Zgd gd dZded<d!dZddd"dZddd#dZd$dZd%dZdd d&dZd'dZeZded<d'dZddd(dZd)d*dZdddd d+dZ ddddddd d,d Z!y)-aHuman-friendly generic gateway status phrases. These helpers deliberately avoid relaying raw model scratch text. They turn Hermes' long-running gateway status surface into short status lines suitable for chat surfaces. Built-in defaults live in ``gateway/assets/status_phrases.yaml``. Users can add portable, profile-relative phrase catalogs under ``HERMES_HOME`` either by using conventional paths:: ~/.hermes/status_phrases.yaml ~/.hermes/status_phrases/*.yaml or by pointing config at a relative file/directory:: display: status_phrases: path: status_phrases/whatsapp.yaml # relative to HERMES_HOME mode: append # append (default) or replace Absolute paths and ``..`` escapes are ignored on purpose so config stays profile-portable and does not accidentally read arbitrary files. Only configured phrase strings are used; raw tool args, commands, previews, and reasoning text are never interpolated into the returned phrase. ) annotationsN)MappingMutableSequence)Path)Any)get_hermes_home)statusgenericP)status_phrases.yamlstatus_phrases)z still on itzstill working through itzwaiting for the result)zon itzone seczchecking that nowdict[str, list[str]]_FALLBACK_PHRASESct|tsgSg}t}|dtD]Z}t |xsdj }|rt |tkDs||vr9|j||j|\|S)N) isinstancelistset_MAX_CUSTOM_PHRASES_PER_SURFACEstrstriplen_MAX_PHRASE_CHARSappendadd)valuecleanedseenitemphrases I/root/.hermes/venv/lib/python3.12/site-packages/gateway/status_phrases.py_clean_phrase_listr#5s eT " GUD667TZR&&(V'88FdN v   Ninherited_modect|jdxs|xsdjj}|dk(}t |jdt r|jdn|}t D]N}tt |t r|j|nd}|s2|r|ng|j|g|||<Py)Nmoderreplacephrases)rgetrlowerrr_STATUS_SURFACESr#)catalogsectionr&r(r) phrase_mapsurfacer*s r"_merge_phrase_mappingr2Cs w{{6"@n@ A G G I O O QDiG+5gkk)6Lg+VY'\cJ#Y$ :W^@_Z^^G%t|xsdj}|syt|j}|j sd|j vry|j }||z j } |j||S#t$rYywxYw)Nrz..) rrr expanduser is_absolutepartsresolve relative_to ValueError)base_dirraw_pathraw candidatebaseresolveds r"_relative_path_underrIWs hn"  # # %C S $$&I$)//"9    Dy ))+HT" O s=B BBc|jr|jjdvr|gS|jr t d|j DSgS)N.yml.yamlc3xK|]2}|jr |jjdvr|4yw)rKN)is_filesuffixr,).0childs r" z%_iter_phrase_files..ks6 }}5<<#5#5#7;L#L  s8:)rOrPr,is_dirsortediterdir)r9s r"_iter_phrase_filesrWgsW ||~$++++-1BBv  {{} #||~    Ir$c|yt|tr|n|g}|D]/}t||}|t|D]}t |||1y)Nr%)rrrIrWr;)r.pathsrCr& raw_pathsrDrH phrase_files r"_merge_phrase_pathsr\rsf }#E40ugIT'(;   -h7 TK w N S T Tr$ctjDcic]\}}|t|}}}ttj j dz dz }t||d|Scc}}w)Nassetsr r)r%)ritemsrr__file__r@parentr;)r1r*r. catalog_paths r"_load_builtin_catalogrcsf>O>U>U>WX*:'7wW %XGX>))+22X=@UULw YG NYsA._DEFAULT_PHRASEScptjDcic]\}}|t|c}}Scc}}wN)rdr_r)r1r*s r"_copy_default_catalogrgs-;K;Q;Q;S T'7wGT'] " TT Ts2rCc.t|tsyt|jdxsdj j }|Resolve built-in + user-configured generic status phrases. Resolution order mirrors gateway display settings: built-ins, conventional profile-relative user files, global ``display.status_phrases`` (or legacy alias ``generic_status_phrases``), then ``display.platforms..status_phrases``. rhdisplayNgeneric_status_phrasesr platforms) rgrr\r_CONVENTIONAL_RELATIVE_PATHSrrr+rj) user_config platform_keyr. hermes_homerlrnplatform_displays r"resolve_status_phrase_catalogrts$%G!#K&B!CkZ4>{G4T{ b%%i0Z^G gw ''++.F"GR]^'++.>"?+V K(I 9g6$==6 & 0 *:*>*>?W*Xcn o *:*>*>?O*P[f g Nr$ tool_namepreviewargscdt|xsdjj}|dvryy)zCClassify an internal gateway event into a Hermes UI-surface bucket.r>r waiting heartbeat long_runningr r )rrr,)kindrvrwrx normalizeds r"classify_status_contextrs2TZR&&(..0JGG r$)rvrwrxrecentrngr.cb|xst}t||||}t|j|xs|jdxs td} |r#t |} | D cgc] } | | vs|  } } | r| } |xst } | j | } ||j| |dd=| Scc} w)zPick a short generic status phrase, avoiding recent repeats. ``preview`` and ``args`` are accepted for callback compatibility, but their raw contents are never embedded in the returned phrase. rur Ni)rdrrr+r_randomchoicer)r}rvrwrxrrr.phrase_catalogcategory candidates recent_setr!freshpickers r"choose_status_phrasers0 0N&ty'X\]Hn((2rn6H6H6SrWghqWrsJ [ &0MFF*4LMM J ^GF ]]: &F  f 3B3K MNs # B,-B,)rrreturnz list[str])r.rr/zMapping[str, Any]r& str | NonerNone)r.rr9rr&rrr)rCrrDrr Path | None)r9rrz list[Path]) r.rrYrrCrr&rrr)rr)r.rr/rrCrrrrf)rpzMapping[str, Any] | Nonerqrrr) r}rrvrrwrrxrrr)r}rrvrrwrrxrrzMutableSequence[str] | Nonerrr.zMapping[str, list[str]] | Nonerr)"__doc__ __future__rrandomrcollections.abcrrpathlibrtypingrr5hermes_constantsrr-rrror__annotations__r#r2r;rIrWr\rcrdrgrjrtrrr$r"rs6#4 , )"$HT8+' vzYcgN   "& T !T T T  T  T$*?)@&@Ubf,>!         "!*..2     (  , r$