epjFUdZddlmZddlZddlmZmZmZdZde d<dZ d%d Z d&dZ d'd(dZ d)dZddedd*d"Zddd#d+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 Available fields: model — bare model id, vendor prefix dropped (``gpt-5.4``) context_pct — last-call context occupancy as a percent (``5%``) latency — wall-clock duration of the turn (``22s``, ``1m05s``) cwd — home-relative working dir (``~``) ``latency`` is opt-in: it is NOT in the default field set, so a footer whose ``fields`` are unset renders exactly as before. 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)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 .runtime_footer`` F)enabledfieldsdisplayruntime_footerr*r+c,g|]}t|Sr .0fs r z)resolve_footer_config..Ts!G!G!GQ#a&&!G!G!Gr# platformsc,g|]}t|Sr/r0r1s rr4z)resolve_footer_config.._s)P)P)PQ#a&&)P)P)Pr#)listr get isinstancedictbool)r$r&resolvedcfg global_cfgr5plat_cfg plat_footers rresolve_footer_configrAAs!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#secondsfloatc|dkrdStt|}|dkr|dSt|d\}}|d|ddS)z6Humanize a turn duration: ``<1s``, ``22s``, ``1m05s``.rz<1s<sm02d)introunddivmod)rBtotalrGsecs r_format_latencyrNdse{{u g  E rzz{{{ E2  FAs  #    r#)r turn_secondsr+context_tokensrIcontext_length Optional[int]rOOptional[float]r+ Iterable[str]c `g}|D] }|dkr't|}|r||0|dkrX|rU|dkrO|dkrItdtdt ||z dz} || d|dkr+|(|dkr"|t ||dkrFt |ptj d d } | r||  |sd St |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. rrrd%latencyNr TERMINAL_CWDr) r"appendmaxminrJrNrrenvironr8_SEPjoin) rrPrQr rOr+partsfieldrGpctrels rformat_runtime_footerrdosSE"" G  U##A  Q m # # (.1"4"419L9L!Se^n-LPS,S&T&TUUVV YYY''' i  'LA,=,= _\::;;; e^^$S%NBJNN>2,N,NOOC " S!!! r 99U  r#)r rOc t||}|dsdSt||||||dptS)aTop-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. ``turn_seconds`` is the wall-clock duration of the agent run, measured by the caller with ``time.monotonic()``. Callers that don't measure it leave it ``None`` and the ``latency`` field is skipped. r*rr+)rrPrQr rOr+)rAr8rdr )r$r&rrPrQr rOr=s rbuild_footer_linerfsf( \ : :C 779  r %% !wwx  3O    r#)r r r r )rrr r )N)r$r%r&r'r r()rBrCr r )rrrPrIrQrRr rrOrSr+rTr r )r$r%r&r'rrrPrIrQrRr rrOrSr r )__doc__ __future__rrtypingrrrr __annotations__r^rr"rArNrdrfr/r#rrks   D#""""" **********#BBBBB     $$$$ $     F $(+%%%%%%^$(r#