+ jHj1Rt^RIHt^RIt^RIt^RItRtRtRtRRlt Rt RR lt R R lt RR R llt RRltRRltRRltRRltRR/RRlltRtR#)u(Session-cumulative usage for a local viewer (wave A2 / CALLMAP W3). Main's HermesCLI read its status bar (context, ``◷`` latency, ``t/s``, the spinner's ``↓ N tok``), ``/usage`` and the exit summary straight off the in-process agent's ``session_*`` counters, ``context_compressor`` and ``get_rate_limit_state()``. On the session authority the agent lives in the gateway, so the same numbers are projected here: published as ``session.usage`` after every API call and at turn end of a local-viewer turn, and returned by the ``session.stats`` verb. ) annotationsN_viewer_turn_output_basechVe.W8Xd(^Tu;8dR8dMM\\V4^4#R#)Ng.A)roundfloat)values&:/home/ubuntu/.hermes/hermes-agent/gateway/session_usage.py_finiter s.%*%65>aRWoZ]o5uq !gcggcV^8dQhRR/#returndict)formats"r __annotate__rsSS4Sr ctVfR^R^RRRRRRR^/#^RIHp\^\VR^4;'g^4pTp\P !\ 4;_uu_4^R IHp\VR R4pT!\V\4'dTM.\VR R4R R 7pVe V^8dTpRRR4\^\VR^4;'g^4pRTRV'd \WH4MTRT;'gRR\VRR4RV!V4R\VR^4;'g^/# +'giL;i)zWMain's status-bar context figures (``_get_status_bar_snapshot``), clamped the same way.Nlast_prompt_tokenscontext_tokenscontext_lengthconfig_context_lengthcontext_sourcecompression_count)context_display_source)anchored_context_tokens_session_messages_turn_base_usage_anchorF)charge_stale_thinking_config_context_length) agent.context_breakdownrmaxgetattr contextlibsuppress Exceptionagent.usage_anchorr isinstancelistmin) agent compressorrlasttokensrmessagesanchoredlengths && r_contextr1sJ$a)91>NPT'/?GZ\]_ _> q'*&:A>CC! DD F   Y ' '>5"5t<*z(D7Q7Q8WY+25:SUY+ZAFH  HqLF (GJ(8!<AA BF $(8QW#f:M]c fnn #WZ9QSW%X 4Z@ 5H!!L!Q!QPQ  SS ( 's AD'' D7 cP\P!\4;_uu_4VP4pVeS\P !V4'd7\ V\4'g!\P!V4uuRRR4#RRR4R# +'giR#;iN) r#r$r%get_rate_limit_state dataclasses is_dataclassr'typeasdict)r*states& r _rate_limitr:5sq   Y ' '**,  !9!9%!@!@TY[_I`I`%%e, ( ' '  ( ' s0B+B B% cV^8dQhRR/#)r rz dict | Noner)rs"rrr=sr c \P!\4;_uu_4\VRR4p\VRR4RJdVPp\ RVP 4R4pVeVP'dTM T;'gTp\VRR4pVe\V\4'd5^Tu;8d+\\P!4R,48:gHMR VPR VPR \VP4RVP/uuRRR4#RRR4R# +'giR#;i) uWindow plans only: the allowance the status bar shows at a glance (today's, else the one that binds), from the reply headers the agent already tracks — no extra round trip, None for everyone else._credits_stateNis_usage_windowFTc3p"TF,qPR8XgKVPR8XgK(VxK. R#5i)dayallN)idscope).0gs& r plan_gauge..Ds(V48E *UC*@*@QEiRUVZV_V_VadhVhRiEiehhiU]]I[&(:(:< ( ' '  ( ' sAD9 D9 BD99 E cV^8dQhRR/#r r)rs"rrrNs$r c(\UUu/uF%wrT\\W^4;'g^4bK' pppVP\ V\VRR444R;rE\ P !\4;_uu_4\\VRR4;'g.4p\\VRR4;'g.4p\\V4\V44;p'dG\Wh)R4p \W, 4pV ^8d\\Wx)R4V , 4MRpRRR4^p \ P !\4;_uu_4^RI Hp V !4p RRR4\V\R4p TPYE\!V \4'd\#^VR,V , 4M^Ve \%V4MRT \'\VRR4;'gR4\'\VR R4;'gR4\VR R 4R Jd+\'\VRR4;'gR4;'gRMRR 7\)V4;p eWR&V#uuppi +'giELE;i +'giEL;i)zbThe frozen ``session.usage`` / ``session.stats`` dict; zeros before the first turn built an agent.context_compressorN_api_latency_history_api_output_history) active_count output_tokensmodelprovider_fallback_activatedFT) avg_latency_s tokens_per_slast_turn_tokens rate_limitactive_subagentsr\r^fallback_modelrT) _COUNTERSrOr"updater1r#r$r%r(r)lensumr tools.async_delegationrZTURN_BASE_ATTRr'r!r:strrT)r*keyattrstats avg_latencytps latenciesoutputsntotalactiverZbaserRs& r usage_statsrxNs)KTU9ic3GE388q999EU LL%0Dd!KLMK   Y ' '(>EKKL wu&;TBHHbIC NCL1 11 1 "#'E!%),K8= '#gbcl+e34tC (F   Y ' '7 ( 5.$ /D LL{KUVZ\_K`K`#a)?$)F"Gfg272CK.`f75'26<<"=GTY[egiLjLpLpnpHqE#8%@DH"%WUGR%@%F%FB!G!O!O4NR T E""/#l L/V ( ' ' ( ' 's$+I&9I,=A3I,J, I= J cV^8dQhRR/#)r rrOr)rs"rrrjs__3_r c\\VRR4R^4p\VR^4p\\V\4'dTM^\V\4'dV4#^4#)aCompactions of this conversation: main's agent counted them on its compressor for the session's life. A canonical compress evicts the gateway's agent (a session boundary), so the count rides the live session and seeds the successor (``seed_compression_count``).rWNr)r"r!r'rO)liver*owncarrieds&& rcarried_compression_countr~js^ '%!5t<>QST UCd/3G *Wc22w*SRUBVBV3 ^^\] ^^r cV^8dQhRR/#r rNoner)rs"rrrssHHdHr cRp\P!\\4;_uu_4VP V4pRRR4\ W#4^,VnR# +'giL);i)z^A committed (never an exact-retried) compress: one more compaction than the evicted agent saw.N)r#r$AttributeErrorKeyErrorr*r~r) authorityrefr{r*s&&& rnote_compressionrssH E   ^X 6 6$ 76tCaGD 7 6s A A- cV^8dQhRR/#rr)rs"rrr{sRR4Rr c\VRR4pVeDVe>\P!\4;_uu_4\ W4VnRRR4R#R#R# +'giR#;i)rWN)r"r#r$r%r~r)r{r*r+s&& rseed_compression_countr{sT 4d;J J2   + ++DT+QJ (, +3 + + +s A A( c V^8dQhRRRR/#r rorrr)rs"rrrsTdr c*RVPR4;'gRRVPR4;'gVPR4;'g^RVPR4;'gVPR4;'g^R VPR 4;'g^R VPR4;'g^R VPR4;'g^R VPR4;'g^RVPR4;'g^/pVPR4;'g^VPR4;'g^r2V'dpV'dh\W#4pVPR4;'gRpVPW#\^\^d\ W#, ^d,444WDR8gR7VPR4eVPR4;'g^VR&VPR4;'g^VPR4;'g^reV^8d7V^8d0\^\^d\ We, ^d,444VR&RFOwrx\ VPV4\ \34'gK2\ \W,4^4W&KQ \ VPR4\ 4'd VR,VR&\ VPR4\4'd VR,VR&V#)u ``stats`` in main's TUI ``Usage`` shape (``tui_gateway/server.py::_get_usage``): the fields its status bar (context used/max/bar, ``◷`` latency, ``t/s``, ``cmp`` badge, cache hit) and ``/usage`` read off ``message.complete.usage``. Absent figures are omitted, never fabricated as zeros.r\r]input input_tokens prompt_tokensoutputr[completion_tokens reasoningreasoning_tokensprompt completionru total_tokenscalls api_callsrrrprovider_usage) context_used context_maxcontext_percentrcontext_estimatedr compressionscache_read_tokens cache_hit_pctrdrT))r`r`)avg_tpsra) getr)rgr!rr'rOrr) rousageusedmaximumsource prompt_total cache_readrm source_keys & r tui_usagerseii(..B>9R9u9uV[V_V_`oVp9u9utu uyy1XXUYY?R5SXXWX %))$67<<1h RaHbHgHgfg 599%89>>QSaIbIgIgfg eii ,11  3E II2388q%))DT:U:Z:ZYZ' 4!+,@@0@ $%(CU4>C;O5P,Q%R$*HX>X  Z yy!". % *= > C C!n$yy9>>Q J]@^@c@cbc*aJN!$QCz7PSV7V1W(X!Yo\ eii +c5\ : :uU%67;EJ]%))./55$)*<$= !%))L)400#L1l Lr c V^8dQhRRRR/#rr)rs"rrrs00t00r c R\V4/VC#)uThe ``session.usage`` event payload: BOTH views of the same counters, in one frame. ``SessionUsagePayload`` (``tui_gateway/contracts/events.py``) allows either view — the TUI ``usage`` object (``server._start_usage_ticker``) or the session-cumulative counters at the top level — and the readers on the far end want different halves. The classic CLI (``hermes_cli.gateway_connection.SessionState.apply_event``) keeps the top-level counters whenever they are present and ignores the nested view; ACP (``acp_adapter.gateway_server``) reads only the top level; a Desktop bundle older than ``usageFromTick`` reads only ``payload.usage``, so its context / cache-hit / tokens-per-second meters render their empty placeholder for as long as the frame carries the counters alone. Publishing both serves every viewer from one frame, and leaves the counters untouched for every existing consumer. ``usage`` is the standard status-bar projection of the embedded ticker's ``server._get_usage`` view, with two exceptions: ``dev_credits_spent_micros`` (``HERMES_DEV_CREDITS`` only) is not carried, and ``avg_latency_s`` / ``avg_tps`` are rounded from the counters' two decimals rather than the raw values, so they can differ by 0.1 at a rounding boundary. A Desktop bundle that reads only ``payload.usage`` fills its meters here too. The top-level counters on this event are deprecated: new viewers read ``usage`` (or call ``session.stats`` for the counters). Before they can be dropped, these readers must move off them: the classic CLI's ``SessionState.apply_event`` → ``GatewayAgent.apply_session_usage``, ACP's ``_project_usage`` (``usage_update`` / ``turn_usage``), and the flat branch of ``usageFromTick`` (Desktop and Ink). r)r)ros&r usage_framers0 Yu% / //r recordFc V^8dQhRRRR/#)r rboolrrr)rs"rrrs 2 2$ 24 2r c(VfR#\P!\4;_uu_4\V4pVP R\ V44V'd^RIHpVP4pVeW5R&RRR4R# +'giR#;i)aOne ``session.usage`` frame on the viewer's stream; never breaks the turn. At turn end (``record``) the same dict rides the captured execution result, so the turn's ``message.complete`` carries main's ``usage`` (``session_settlement_recovery.completion_payload``).Nz session.usage)execution_result session_usage) r#r$r%rx_publish_executionrgateway.session_resultsrr)turnr*rrorcaptureds&&$ r publish_usagersm }   Y ' 'E" U1CD  @'++-H#,1) ( ' ' 's A B B c"^RIHp\V4RR0, 'd V!R4hVPP VP V4GRjxL VPP V4p\V4p\VPPPVP4V4VR&V#Lh5i)zH``session.stats {session_id}``: the same dict ``session.usage`` carries.)RuntimeStoreError session_idprofileinvalid_paramsNr) hermes_state_runtimersetrresolveactorr*rxr~sessionsrr) connectionrparamsrr*results&&& rroros6 6{lI... 011    & &z'7'7 ===  & &s +E  F";JsAB?B=A)B?) )rsession_input_tokens)r[session_output_tokens)rsession_cache_read_tokens)cache_write_tokenssession_cache_write_tokens)rsession_prompt_tokens)rsession_completion_tokens)rsession_total_tokens)rsession_reasoning_tokens)rsession_api_callsr3)__doc__ __future__rr#r5rPrfrkr r1r:rTrxr~rrrrrrorr rrso#  1 ,hS0"8_HR@06 2 2 r