iUdZddlmZddlZddlmZddlmZmZm Z dZ de d<d Z d!d Z d"dZ d#d$dZde dd%dZddd&d ZdS)'uGateway runtime-metadata footer. Renders a compact footer showing runtime state (model, context %, cwd) and appends it to the FINAL message of an agent turn when enabled. Off by default to keep replies minimal. Config (``~/.hermes/config.yaml``):: display: runtime_footer: enabled: true # off by default fields: [model, context_pct, cwd] # order shown; drop any to hide Per-platform overrides live under ``display.platforms..runtime_footer``. Users can toggle the global setting with ``/footer on|off`` from both the CLI and any gateway platform. The footer is appended to the final response text in ``gateway/run.py`` right before returning the response to the adapter send path — so it only lands on the final message a user sees, not on tool-progress updates or streaming partials. When streaming is on and the final text has already been delivered piecemeal, the footer is sent as a separate trailing message via ``send_trailing_footer()``. ) annotationsN)Path)AnyIterableOptional)model context_pctcwdztuple[str, ...]_DEFAULT_FIELDSu · r strreturnc8|sdS tjd}tj|}|rB||ks"||tjzrd|t |dzS|S#t$r|cYSwxYw)zGReturn *cwd* with ``$HOME`` collapsed to ``~``. Empty string if unset.~N)ospath expanduserabspath startswithseplen Exception)r homeps ;/home/ubuntu/.hermes/hermes-agent/gateway/runtime_footer.py_home_relative_cwdr$s rw!!#&& GOOC   'Q$YY!,,tbf}"="=Y3t99::& &  sBB B BBr Optional[str]cB|sdS|dddS)uMDrop ``vendor/`` prefix for readability (``openai/gpt-5.4`` → ``gpt-5.4``).r/)rsplit)rs r _model_shortr#2s( r <<Q   ## user_configdict[str, Any] | None platform_key str | Nonedict[str, Any]cLdttd}|pidpi}|d}t|trnd|vr%t |d|d<t|dtr|drd|dD|d<|r|dpi}||}t|tr|d}t|trnd|vr%t |d|d<t|dtr|drd |dD|d<|S) zResolve effective runtime-footer config for *platform_key*. Merge order (later wins): 1. Built-in defaults (enabled=False) 2. ``display.runtime_footer`` 3. ``display.platforms..runtime_footer`` F)enabledfieldsdisplayruntime_footerr+r,c,g|]}t|Sr .0fs r z)resolve_footer_config..Ls!G!G!GQ#a&&!G!G!Gr$ platformsc,g|]}t|Sr0r1r2s rr5z)resolve_footer_config..Ws)P)P)PQ#a&&)P)P)Pr$)listr get isinstancedictbool)r%r'resolvedcfg global_cfgr6plat_cfg plat_footers rresolve_footer_configrB9s!D,A,ABBH  " ! !) , , 2C)**J*d##H  " ""&z~~i'@'@"A"AHY  jnnX.. 5 5 H*X:N H!G!G*X2F!G!G!GHX  QGGK((.B ==.. h % % Q",,'788K+t,, Q ++*.{y/I/I*J*JHY'kooh77>>Q;xCXQ)P)P+h:O)P)P)PHX& Or$)r r,context_tokensintcontext_length Optional[int]r, Iterable[str]c g}|D]}|dkr't|}|r||/|dkrX|rU|dkrO|dkrItdtdt ||z dz}||d|dkrFt |pt jdd} | r|| |sdSt |S) uRender the footer line, or return "" if no fields have data. Fields are skipped silently when their underlying data is missing — a partially-populated footer is better than a line with ``?%`` or empty slots. rr rd%r TERMINAL_CWDr) r#appendmaxminroundrrenvironr9_SEPjoin) rrCrEr r,partsfieldmpctrels rformat_runtime_footerrX\sE " " G  U##A  Q m # # (.1"4"419L9L!Se^n-LPS,S&T&TUUVV YYY''' e^^$S%NBJNN>2,N,NOOC " S!!! r 99U  r$)r c t||}|dsdSt|||||dptS)zTop-level entry point used by gateway/run.py. Returns the footer text (empty string when disabled or no data). Callers append this to the final response themselves, preserving a single blank line of separation. r+rr,)rrCrEr r,)rBr9rXr )r%r'rrCrEr r>s rbuild_footer_linerZ~sc \ : :C 779  r %% wwx  3O    r$)r r r r )rrr r )N)r%r&r'r(r r)) rrrCrDrErFr rr,rGr r )r%r&r'r(rrrCrDrErFr rr r )__doc__ __future__rrpathlibrtypingrrrr __annotations__rQrr#rBrXrZr0r$rr`s2#""""" **********#BBBBB     $$$$ $     P+ Rr$