BjUdZddlmZddlZddlmZddlmZmZm Z dZ de d<d Z dd Z dd Z d dd Zde d  ddZdd ddZy)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 · c |sy tjjd}tjj|}|r8||k(s"|j |tj zrd|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} ww!!#& GGOOC  Q$Y!,,tbff}"=3t9:& &  sA7A?=A?? B  B c2|sy|jdddS)uMDrop ``vendor/`` prefix for readability (``openai/gpt-5.4`` → ``gpt-5.4``).r /)rsplit)rs r _model_shortr 2s  <<Q  ##cdttd}|xsijdxsi}|jd}t|trdd|vrt |jd|d<t|jdtr$|dr|dDcgc] }t |c}|d<|r|jdxsi}|j|}t|tr|jd}t|trdd|vrt |jd|d<t|jdtr$|dr|dDcgc] }t |c}|d<|Scc}wcc}w)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$ platforms)listr get isinstancedictboolstr) user_config platform_keyresolvedcfg global_cfgfr'plat_cfg plat_footers rresolve_footer_configr69sN!D,ABH  " ! !) , 2C)*J*d#  ""&z~~i'@"AHY  jnnX. 5*X:N2;xCX:Eh:O)PQ#a&)PHX& O"H*Qs E0E5)r r$c g}|D]}|dk(r t|}|s|j|(|dk(rI|s0|dkDs6|dk\s2,NOC S! "  99U r!)r c t||}|jdsyt|||||jdxstS)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#r r$)rrBrCr r$)r6r)rIr )r.r/rrBrCr r1s rbuild_footer_linerK~sI \ :C 779  %% wwx 3O  r!)r r-returnr-)r Optional[str]rLr-)N)r.dict[str, Any] | Noner/ str | NonerLzdict[str, Any]) rrMrBintrC Optional[int]r rMr$z Iterable[str]rLr-)r.rNr/rOrrMrBrPrCrQr rMrLr-)__doc__ __future__rrpathlibrtypingrrrr __annotations__r@rr r6rIrKr!rrXs2# **#BB  $ $ &   P+  "      R&     "   r!