JjQ!:UdZddlmZddlZddlmZmZddlm Z ddl m Z ddl Z ddl mZdZd Zd Zd Zgd gd dZded<d>dZddd?dZddd@dZdAd#ZdBd%ZdddCd'ZdDd(ZeZded)<dDd*Zdd+dEd,ZdFdGd0Zdddd1dHd7Z ddddddd8dId=Z!dS)JaHuman-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_PHRASESvaluerreturn list[str]cPt|tsgSg}t}|dtD]n}t |pd}|rt |tks||vrD||| |o|S)N) isinstancelistset_MAX_CUSTOM_PHRASES_PER_SURFACEstrstriplen_MAX_PHRASE_CHARSappendadd)rcleanedseenitemphrases |r|ng||g|||<`dS)Nmoderreplacephrases)rgetrlowerrr_STATUS_SURFACESr%)r)r*r(r/r0 phrase_mapsurfacer1s r$_merge_phrase_mappingr7Cs w{{6""@n@ A A G G I I O O Q QDiG+5gkk)6L6Lg+V+VcY'''\cJ#YY$ :W^@_@_%iZ^^G%<%<%z%_iter_phrase_files..ksX  }} #(<#5#5#7#7;L#L#L #L#L#L#L  r&)rVrWr3is_dirsortediterdir)r8s r$_iter_phrase_filesr^gs ||~~$+++--1BBBv  {{}}   #||~~       Ir&pathsc|dSt|tr|n|g}|D]9}t||}|t|D]}t |||:dS)Nr')rrrOr^r@)r)r_rAr( raw_pathsrBrN phrase_files r$_merge_phrase_pathsrcrs }#E400=ugITT'(;;   -h77 T TK w N S S S S S T TTr&cdtD}ttjdz dz }t ||d|S)Nc4i|]\}}|t|SrrXr6r1s r$ z)_load_builtin_catalog..s%XXX*:'7wW XXXr&assetsr r0r')ritemsr__file__rHparentr@)r) catalog_paths r$_load_builtin_catalogrosaXX>O>U>U>W>WXXXG>>))++2X=@UULw YGGGG Nr&_DEFAULT_PHRASEScHdtDS)Nc4i|]\}}|t|Srfrgrhs r$riz)_copy_default_catalog..s% T T T'7wGT']] T T Tr&)rprkrfr&r$_copy_default_catalogrss# T T;K;Q;Q;S;S T T TTr&rAct|tsdSt|dpd}|Lt ||d||t ||d||t||dS)z@Merge one display.status_phrases-style section into ``catalog``.Nr/rr8)rAr(r_)rrrr2rr3rcr7)r)r*rAr/s r$_merge_phrase_configrvs gw ' ' w{{6"".h / / 5 5 7 7 = = ? ?DGW[[%8%88\`aaaaGW[[%9%9H]abbbb'7+++++r& user_configMapping[str, Any] | None platform_keyct}t}t|tt|t |t r|pidnd}t |t s|St||d|t||d||d}|rt |t rt||}t |t rJt||d|t||d||S)a>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``. rtdisplayNgeneric_status_phrasesr platforms) rsrrcr_CONVENTIONAL_RELATIVE_PATHSrrr2rv)rwryr) hermes_homer{r}platform_displays r$resolve_status_phrase_catalogrsd$%%G!##K&B!C!CkZZZZ4>{G4T4T^{ b%%i000Z^G gw ' ''++.F"G"GR]^^^^'++.>"?"?+VVVV K((Ih 9g66h$==66 & 0 0 h *:*>*>?W*X*Xcn o o o o *:*>*>?O*P*P[f g g g g Nr& tool_namepreviewargskindrrrrc|t|pd}|dvrdSdS)zCClassify an internal gateway event into a Hermes UI-surface bucket.r>r waiting heartbeat long_runningr r )rrr3)rrrr normalizeds r$classify_status_contextrsATZR&&((..00JGGGx 9r&)rrrrecentrngr)rMutableSequence[str] | NonerMapping[str, list[str]] | Nonec |pt}t||||}t||p!|dp td} |r!t | fd| D} | r| } |pt } | | } ||| |dd=| S)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. rr cg|]}|v| Srfrf)rXr# recent_sets r$ z(choose_status_phrase..s#MMMFF*4L4L4L4L4Lr&Ni)rprrr2r_randomchoicer)rrrrrrr)phrase_catalogcategory candidatesfreshpickerr#rs @r$choose_status_phrasers0 0N&ty'X\]]]Hn((22rn6H6H6S6SrWghqWrssJ [[ MMMMjMMM  J ^GF ]]: & &F  f 3B3K Mr&)rrrr)r)rr*r+r(r,rr-)r)rr8rr(r,rr-)rArrBrrrC)r8rrrP) r)rr_rrArr(r,rr-)rr)r)rr*rrArCrr-)N)rwrxryr,rr) rrrr,rr,rrrr)rrrr,rr,rrrrrrr)rrr)"__doc__ __future__rrandomrcollections.abcrrpathlibrtypingrr;hermes_constantsrr4rrr~r__annotations__r%r7r@rOr^rcrorprsrvrrrrfr&r$rs6#"""""44444444 ,,,,,, )"$HTSS888++    vzYYYYYYcgNNNNNN      "& TTTTTT$*?)>)@)@@@@@UUUUbf,,,,,,>!      "!*..2r&