+ iHja0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI H t ^RI H t ^RI HtHtHt^RIHt^RIHtHtHtHtHtHtHtHtHt]P:!]4tRs R ]!R &]"!0Rm4t#]PH!R 4t%]&!4t']"!R R 04t(RRlt)] !RR44t*Rt+Rt,Rt-R]!R&Rt.Rt/Rt0Rt1Rt2Rt3Rt4Rt5Rt6R t7R!t8R"t9R#R$lt:RR%R&llt;R'R(ltR+t?Rt@R,R-ltAR.R/ltBR0R1ltCR2R/R3R4lltDR2R/R5R6lltER7tFR8R9R:]FR;RltHR?R@ltIR2R/RARBlltJ] !RCRD44tKRERFltLRGRHltMRRIRJlltNRKRR2R/RLRMlltORtPRQ]!RR&]"!0Rm4tQ]QRNRO0,tRRStSRTRUltTRVRWltU]'3RXRYlltVRRZR[lltWR\R]ltXRR^RPR_R/R`RallltYRb]Y!RcRdReRf4Rg]Y!RhRhRe4Ri]Y!RjRjRe4Rk]Y!RlRlRe4Rm]Y!RfRnReRf4Ro]Y!RnRnRRnRRpRq7Rr]Y!RnRsReRnRRpRq7/tZRt]!Ru&RvRwlt[RxRylt\RzR{lt]/t^R|]!R}&R~t_RRlt`]0]2]13ta/tbR|]!R&RRltcRRltdRRlteRRltfRRltgRRlthRRltiRRltjRRltkR#)aqNous credits: parse ``x-nous-credits-*`` / ``x-nous-tool-pool-*`` response headers into a validated CreditsState (depletion = paid_access, subscription-cap used_fraction, warn-once schema-version gating) and drive the notice policy. Header contract: see ``_HEADER_FIELDS``. Money is micros ints only; ``*_usd`` strings are preserved verbatim (never re-parsed to float).) annotationsN) dataclass)Decimal)AnyMappingOptional)is_truthy_value) BP_FULLSCOPE_TOP_TIER WindowGauge all_scope binding_gaugegauge_limit_name parse_gaugespaused_for_paymenttop_tier_gaugeFbool_version_warning_emittedz^-?\d+\.\d{2}$includedpaygc V^8dQhRRRR/#)valuerreturn)formats":/home/ubuntu/.hermes/hermes-agent/agent/credits_tracker.py __annotate__r,sSSczVf\#\\V44# \\3d \u#i;i)zExact int (money-safe) or ``_SENTINEL``. ``int()`` directly, NOT ``int(float())`` (precision loss above 2**53 corrupts money); float-shaped strings fail.) _SENTINELintstr TypeError ValueError)rs&r _safe_intr%,s8!My>s3u:> z "s  ::c]tRt^5t$Rt^tR]R&^tR]R&RtR]R&^t R]R&Rt R]R &R t R ]R &R t R ]R&^t R]R&^tR]R&RtR]R&^tR]R&RtR]R&RtR]R&RtR]R&R tR ]R&^tR]R&RtR]R&RtR]R&RBtR ]R!&R tR ]R"&RtR]R#&R tR ]R$&RtR]R%&R tR&]R'&]R(R)l4t]R*R+l4t ]R,R-l4t!]R.R/l4t"]R0R1l4t#]R2R3l4t$]R4R5l4t%]R6R7l4t&]R8R9l4t']R:R;l4t(]R<R=l4t)]R>R?l4t*]R@RAl4t+RBt,R #)C CreditsStatezrKs&rhas_dataCreditsState.has_data\s!##rcV^8dQhRR/#)rrr=r)rs"rrrIasQQUQrc VP'd'\P!4VP, #\R4#)inf)rRtimer>r=rKs&r age_secondsCreditsState.age_seconds`s*15tyy{T---PE%LPrcV^8dQhRR/#rHr)rs"rrrIes$$$$rc $VP'*#)u``paid_access == False`` ONLY — ``remaining_micros == 0`` is a false positive when the balance is zero but access is live (renewal pending).)r9rKs&rdepletedCreditsState.depletedds####rcV^8dQhRR/#rHr)rs"rrrIksXXXrc lVPR8H;'d\\VP44#)zLA usage-window plan with at least one allowance that stops every paid model. usage_window)r8rr r@rKs&ris_usage_windowCreditsState.is_usage_windowjs+$$6WW4 $++@V;WWrcV^8dQhRR/#rrOptional[WindowGauge]r)rs"rrrIpsLL4Lrc TVP'd\VP4#R#)z_The all-scope allowance that binds (see :func:`usage_gauges.binding_gauge`). Usage window only.N)rar r@rKs&rr CreditsState.binding_gaugeos#.2-A-A-A}T[[)KtKrcV^8dQhRR/#rdr)rs"rrrIusMM 5Mrc TVP'd\VP4#R#N)rarr@rKs&rrCreditsState.top_tier_gaugets!.2.B.B.B~dkk*LLrcV^8dQhRR/#)rrzOptional[float]r)rs"rrrIys J J Jrc VP'dVPP#VPp\ V\ 4'dV^8:dR#\ R\RWP, V, 44#)aFraction of the cap consumed in [0.0, 1.0]; None without a computable denominator. Credit-grant: guarded on the LIMIT FIELD (the real denominator), not ``denominator_kind``. Usage window: the binding all-scope allowance (whichever stops every model first).Nr<?) rar used_fractionr/ isinstancer!maxminr,)rLlims& rroCreditsState.used_fractionxse    %%33 3,,#s##sax3C#(@(@"@C!GHIIrcV^8dQhRR/#rrr.r)rs"rrrIs99]9rc >VPpVe VP#R#)z'Reset instant of the binding allowance.N)r resets_at_msrLgs& rwindow_resets_at_ms CreditsState.window_resets_at_mss"   !"q~~8D8rcV^8dQhRR/#rvr)rs"rrrIs99}9rc >VPpVe VP#R#rj)rrxrys& rtop_tier_resets_at_ms"CreditsState.top_tier_resets_at_mss   !"q~~8D8rcV^8dQhRR/#rvr)rs"rrrIs44-4rc >VPpVe VP#R#rj)rused_bprys& rtop_tier_used_bpCreditsState.top_tier_used_bps   Mqyy3t3rcV^8dQhRR/#rHr)rs"rrrIsTT$Trc VP;'d[\;QJd/R\VP44F 'gK R# R#!R\VP444#)zgAn allowance that stops every paid model is full. Paused (payment) is NOT exhausted: nothing was spent.c38"TFqPxK R#5irj)full).0rzs& r 0CreditsState.window_exhausted..s+Sr?r@rArBrCrDrFpropertyrMrRrXr\rar rror{rrrr__static_attributes__rrrr'r'5sFGScM3  c/3}3,0M0OScM3c %%"c"K%)O])HcKK&(F #("&L-&It#'M=' %%-1>0 UU$$QQ$$ XXLLMM J J99 9944TT((rr'stickyi@?z"tuple[tuple[float, str, int], ...]CREDITS_USAGE_BANDSz credits.usagei'zcredits.window_paygcredits.depletedzcredits.window_limitcredits.restoredcredits.grant_spent0✕ Credit access paused · run /topup to top upuy✕ Included usage paused · your subscription payment failed · update your card, or add credits in /topup to keep goingu^✕ Included usage paused · see Billing in the Portal, or add credits in /topup to keep goingz)You've hit your monthly large-model limitu · auto top-up is oncV^8dQhRR/#)rrdictr)rs"rrrsss4src *R\4RRRRRRR//#)zzFresh notice latch for :func:`evaluate_credits_notices`; every producer builds it here so a new gate key lands everywhere.active seen_below_90F usage_bandNseen_grant_unspenttexts)setrrrnew_credits_latchrs# ce_e\4I]_dfmoq rrrc$V^8dQhRRRRRR/#)rrxr.now_msrr"r)rs"rrrs'TTmT]TVYTrc\V\4'dV^8:dR#Vf&\\P!4R,4MTpW8:dR#\P!VR, 4pY, pTR8d'\P!RT4 RTP 2#\P!TR 8dRT4#RT4# \\ \ 3dR#i;i) zLocal-time reset for notices: ``HH:MM`` within 24h, ``Tue HH:MM`` within a week, ``Nov 3`` beyond (the monthly large-model allowance), ``shortly`` once passed (the server rolls the clock on the next request, so a stale stamp is never contradicted).zthe next resetishortlyz%b z%H:%Mz%a %H:%Mi $i\&) rpr!rW localtimer$ OverflowErrorOSErrorstrftimetm_mday)rxrnowstamplefts&& rformat_window_resetrs lC ( (LA,=%+^#diikD !C |d23  D ##--e,-Qu}}o>> ==D+;$;U SSU SS  w /  sC C%$C%c V^8dQhRRRR/#)rrxr.rr"r)rs"rrrs{{-{C{rc\\V\4'dV^8dR\V4 2#R#)u8`` · resets 15:56``; empty when the instant is unknown.u · resets r*)rpr!r)rxs&r_resetsrs2@J``: one key per allowance, so a client replaces it in place.)CREDITS_WINDOW_APPROACH_PREFIX)rs&rwindow_approach_keyrs )H 44rc V^8dQhRRRR/#)rrzr rr"r)rs"rrrs[[[[S[rc\^c\VP^d,44pRV R\V4 R\ VP 4 2#)u:``⚠ 90% of your weekly limit used · resets Thu 09:00``.u⚠ z % of your z limit used)rrr!rorrrx)rzpcts& r_window_approach_textrsF b#aoo+, -C #j!1!!4 5[AX@Y ZZrc$V^8dQhRRRRRR/#)rrr'model_is_top_tierrErrer)rs"rrrs"  | > Nc rcVP'gR#^RIHpVP;'dVPRJpT!RVP RT;'dVRJR7pVf'V'dVP 'd VP#V#)aThe full allowance behind the limit line, by :func:`agent.plan_limits.blocking_gauge` (the rule ``limit_hit`` reads, so the line, the retry time and the card agree). A full top-tier allowance counts only on a refusal: the API stamps ``spend-source`` on every admitted request and never on a 402, so header-sourced + no source = this model was refused; an ``included`` source means the model is not top-tier and a seed cannot know the model. A refusal no all-scope allowance explains is the top-tier one (a cold catalog). ``model_is_top_tier=None`` (tier unknown) counts the top-tier allowance as one that may stop the model, so of several full ones the later reset wins and no retry is promised before the model can run.N)blocking_gauger*F)freetop_tier)raagent.plan_limitsrr?rAr@rr)rrrrefusedrzs&$ r _stop_gaugersz  0>>E$6$6$$>Gr5<h>hJ[chJhiAyW!9!9!9### Hrrc(V^8dQhRRRRRRRR/#) rrr' model_is_freerrrErr0r)rs"rrrs0cc\cTcVdcq~crcVPpVP'd/V^8:d(\VP4'd\#\#VP 'gV'dR#\ #V'gVP'dR#VP'dR#^RI H p\V!VPV4,p\WR7pVfR#VP\8XdIVP 'dV\"8Xd\$MRpR\& \)VP*4 RV V 2#R\-V4 R\)VP*4 RV 2#) aBlocking copy for a usage-window account, or None. ``paid_access`` is the portal's word (dunning); then: payment paused with no credits (credits keep a paused plan going whatever the setting says; a card update restores included usage), the large-model allowance used with no pay path, the window used with no pay path. A free model keeps inferencing, so only the payment-paused line survives it. The credits step comes from :func:`agent.plan_limits.credits_action`, the rule every limit surface reads.N)credits_actionrr*u✕ u · u✕ You've hit your  limit)r3rCr _PAUSED_TEXT_PAUSED_OTHER_TEXTr9_DEPLETED_TEXTrMrBrr _CREDITS_STEPrFrscoper rD_ADD_CREDITS_ACTION_AUTO_TOP_UP_SUFFIX_TOP_TIER_LIMITrrxr)rrr purchasedractionrzautos&$$ r_window_hard_stoprs &&I yA~1%2E2EFF|^L^^    $t8.8))) 0 >%*E*EyQ RFE?Ayww. &+&?&?&?FNaDa"gio&wq~~'>&?tF8D6RR !"21"5!6fWQ^^=T>44rz/topup to add credits use_creditszturn on Keep going in /topup add_creditsadd_credits_and_keep_goingz,add credits and turn on Keep going in /topupc V^8dQhRRRR/#)rrr'rr0r)rs"rrr3s M M\ Mm MrcbVPR8XdVP^8gR#VP'd!\V4wrRV R\ V4 R2pM4VP 'd!R\ \ VP4 R2pMRpY0P'd \,#R ,#) zfThe one-shot PAYG line: the last request drew on top-up credits instead of the window. None otherwise.rNu• You've hit your ru · now using creditsu• u · large models now use creditsu• Now using creditsr*) rAr3rrrrrrrDr)rnameresetstexts& r_window_payg_textr3s   & (U-C-Ca-G $U+ %dV6'&/1BBWX  ! ! !o&wu/J/J'K&LLlm& *C*C*C& LL LLrc4V^8dQhRRRRRRRRRR R R R R /#) rkeyr"rr0levellatchrto_showlistto_clearrNoner)rs"rrrAs@  3 m C  W[ gk pt rcVR,VPR/4rvVefW9gVPV4V8wdJW9dVPV4VP\WV44VP V4WV&R#Vf?W9d7VPV4VP V4VP VR4R#R#R#)zaShow / replace / clear one sticky line by key: a text change re-emits (clear first), None clears.rrN) setdefaultgetappend_sticky_noticeadddiscardpop)rrrrrrrrs&&&&&& r_reconcile_stickyrAs(OU%5%5gr%BE S.%))C.D2H = OOC ~d378 3c #-s #t(rc ,V^8dQhRRRRRRRRRR /#) rrr'rrrrrrztuple[list, list]r)rs"rrrPs2&&L&&QU&04&AR&rc .p.pVR,pVPR/4p\V9d\\RRWV4RVR&VPFpV'*;'dVP\ 8g;'gTp V 'gK9VP 'dKMVP\8gKdVPVP4VP8wgKVPWxP&\VP4p VP\\V4RR\ WR74K \"V9d+VP\"4VP%\"4\'WVR 7p V RJ;'dV \(\*\,39p \.V9;'g \0V9p \\0V 'dT MRR WV4\\.V 'dRMT R WV4V 'dKV fGVP2'd5V'g-VP\R R R\4\6\6R74\\8V 'dRM \;V4RWV4WE3#) aNotice policy for a usage-window account (see :func:`evaluate_credits_notices` for the contract). Approach: each allowance warns once at 90% per reset (``credits.window.``, a TTL heads-up; the limit line takes over when it runs out). The top-tier allowance warns only while the session is on a top-tier model (no other model moves it); a free model warns about nothing. grant_spent never fires (no grant); a payment pause / depleted account reuses ``credits.depleted`` and its ``credits.restored``.r window_warnedNinforwarnttlrrkindttl_msridrrerror✓ Credit access restoredsuccess)rCREDITS_USAGE_KEYrr@rr rroWINDOW_APPROACH_FRACTIONrr rxrr AgentNoticerWINDOW_APPROACH_TTL_MSCREDITS_GRANT_SPENT_KEYrrrrrCREDITS_DEPLETED_KEYCREDITS_WINDOW_LIMIT_KEYr9CREDITS_RESTORED_TTL_MSCREDITS_RESTORED_KEYCREDITS_WINDOW_PAYG_KEYr)rrrrrrrwarnedrzrelevantrstoplimit was_stoppeds&&$$ r_evaluate_window_noticesr!PsGH 8_F##OR8FF"+T658T"l \\$$YY!''^*C*X*XGX 8AFFFq:R'RJJqtt$6>>F44L%add+C NN;,A!,DFY^.D#W X&(/0./ USd eD   _ _l ! ** s  c$V^8dQhRRRRRR/#)rmodelr"r'rrr)rs"rrrs!cS$rc4V'gR#VPR4'gVPR4'dR#V'gR#\V4'dR#^RIHp^RIHpV!V4p\V4;'d V!W4# \dR#i;i)uTrue when *model* is a Nous free-tier model, using ONLY local data: (1) ``:free`` suffix — canonical Nous free SKU marker; (2) ``stealth/`` prefix — stealth-preview SKUs are free without the suffix (naming-convention trust: a PAID ``stealth/`` model would wrongly suppress the banner); (3) a PEEK into ``hermes_cli.models``' pricing cache (filled by the model picker; a miss never fetches). Fail-open to False (depleted notice still shows): a wrong warning is recoverable noise; hiding it masks a real block.Fz:freezstealth/T)_is_model_free)peek_cached_pricing) endswith startswithr,hermes_cli.modelsr0hermes_cli.models_pricingr1r Exception)r.r'r0r1pricings&& ris_free_tier_modelr8s  ~~g%"2"2:">"> h''4A%h/G}??!?? s%B?B BBrc ,V^8dQhRRRRRRRRRR /#) rrr'rrrrrrz#tuple[list[AgentNotice], list[str]]r)rs"rrrs9UULUUQUU04UAdUrc aVP'd\WVVR7#.p.pVPVR,uop\\3FOpWv9gK VP V4VP V4VPR/4PVR4KQ SeS\^,^,8dRVR&Se"SR8dVP\8dRVR&RpSe5VP^8:d$\V3R l\\44R4pV'dVR,'d V^,MRp WPR 48wd\V9d+VP \4VP \4V eV^,p VP ;'g^p V 'd0\#^\%WVP, 44R , R MR p V R8XdRMR RT RVP&;'gR R2p VP \)W\44VP+\4WR &VP,R8H;'d)SRJ;'dSR8;'dVP^8pV'daRV9dZVPRR4'dBVP \)RVP. R2RR44VP+R4RVR&M1RV9d+V'g#VP R4VP R4VP0'*pT;'dV'*pV'd8RV9d1VP \)RRR44VP+R4WE3#RV9dWV'gOVP R4VP R4V'g%VP \3RRR\4R R R!74WE3#)"uReconcile credits notices against the latch (see :func:`new_credits_latch`); mutates ``latch`` IN PLACE. Pure — no I/O, no agent/run_agent imports. ``model_is_free`` suppresses ``credits.depleted`` (a depleted account on a free model keeps inferencing) WITHOUT emitting "restored" — that fires only on a genuine ``paid_access`` flip back to True. Returns ``(to_show, to_clear)``; caller emits to_clear FIRST. A usage-window state (day/week percents, no grant) takes the window policy; everything else is unchanged.rrrNTrrnrc3H<"TFpSV^,8gKVxK R#5i)rQNr)rbufs& rr+evaluate_credits_notices..s T(E1qQRtQQ(Es" "r@B.2f?ru⚠u•z You've used $z of your $z capsubscription_caprFu• Grant spent · $z top-up leftrrrrrrr rr )rar!rorrrrrrrr,GRANT_UNSPENT_MIN_MICROSr3nextreversedrr/rqrrr1rrr8r4r9rr)rrrrrrr window_key current_band target_bandrrsused_usdr grant_cond depleted_cond show_depletedr=s&&$$ @revaluate_credits_noticesrMs 'M:KM M!#GH$$eHoJB.0HI   OOJ ' NN: & IIgr " & &z4 8 J ~"215a88!%o ~"s(u'@'@D\'\&*"#6:L ~%00A5T1D(ETVZ[ '3u_7M7M,q/TXKii --  & OO- . NN, -  "!OE1166QCad#aS0I0I*I!JKiWX[\jmH$eE:. R\]b]y]y^A^A~A]BBFGD NN>$7HI J JJ( ))l "44tt4ttBRUIttZ_ZpZpstZt+69eiiH\^c>d>d~( ?F-7-D-D6<<>]aC++DEKKRRTZZ\J$($u#=#A#A*#MC Jrc(V^8dQhRRRRRRRR/#)rr r"rawr0defaultrrr)rs"rrr7s. J Js J J JS JrcVVfV#VR9dD\V4pV\JgVR8wdV^8d\#VR8XdV\8d\#T#VR8Xd$\P V4'dV#\#VP 4P 4pVR9d\#VR8H#)uaOne header value → field value; ``default`` when absent, ``_SENTINEL`` on a contract violation.signedbpusdtrue)microsrkrl)rnfalse)r%r r _USD_REmatchr`ra)r rhrivalflags&&& r _parse_fieldru7s { ))n )  0S1W  DLS7]yCC u}mmC((s7i7 99;   D$559I46>Irc$V^8dQhRRRRRR/#)rheadersrYproviderr"rOptional[CreditsState]r)rs"rrrGs#..#4..Mc.rc h\;QJdRV4F 'gK RM RM !RV44'gR#VP4UUu/uFwr#VP4VbK ppp\VP R44pV\ JdR#V^8wd.V^8d%\ 'gRs\PRV4R#VP RR4pVR 8Hp/p\FGvrp VP \V 44p V fV'dV \9dK8\W.V O5!W&KI VP R 4p VP R 4pV e#Ve\R V 4VR &\RV4VR&\ VP49g V\9dR#V'd#\V4pVfR#VP!V4VP R4p\#RRVRVRVR\$P$!4RR/VB#uuppi \&d\P)RRR7R#i;i)avParse x-nous-credits-* (and x-nous-tool-pool-*) headers into a CreditsState. None (miss) on ANY of: no version header; version != 1 (> 1 also warns once); a required field violating ``_HEADER_FIELDS``; unknown ``denominator_kind``; any unexpected exception. Fail-open on the subscription_limit pair: a half-pair (only -micros or only -usd) parses as both-absent (both None).c3F"TFqP4R8HxK R#5i)x-nous-credits-versionN)ra)rks& rr(parse_credits_headers..QsJ'Q779 88's!TFNr|uAcredits header version %d unsupported, ignoring — update Hermeszx-nous-credits-denominator-kindr7r`z(x-nous-credits-subscription-limit-microsz%x-nous-credits-subscription-limit-usdror/rmr1zx-nous-credits-disabled-reasonr(r8r:r>r?u9credits ▸ parse_credits_headers raised (fail-open miss)exc_infor)ritemsrar%rr rloggerwarningrNrV_WINDOW_OPTIONAL_FIELDSruvalues_VALID_DENOMINATOR_KINDSrfupdater'rWr6debug)rwrxr}vrX version_valr8 window_notefieldsrr rirhlim_micros_raw lim_usd_rawwindowr:s&& rparse_credits_headersrGs'sJ'JsssJ'JJJ,3MMOx2XF. //;E;/OF+ ,   '+;C[+[ )'2F~ MM& !!++&FGQKQBRQdsQ(, QAEQIOQ Q==@  P[_ `s_ H H H H H-'H H 0H A H B H "H *H ;A H H "H10H1c V^8dQhRRRR/#)r http_responserrrr)rs"rrrxs  C D rcVe\VRR4MRpV'gR#\V4pVRJ;'d VP# \d\P RRR7R#i;i)zTrue iff *http_response* carries complete usage-window ``x-nous-credits-*`` headers (the same test as ``CreditsState.is_usage_window``). Lets the window-only header captures leave every other account untouched. Never raises.NrwFz Usage-window header parse failedTr)getattrrrar6rr)rrwrs& rresponse_is_usage_windowrxsi=J=V'-D9\`%g.D ::U%:%::  7$ GsAA A"A('A(paidreasonc4V^8dQhRRRRRRRRRRR RR R /#) r remainingr" subscriptionrr0rrrrrrr)rs"rrrsJ E E E3 E} EXe E E+8 EDH Erc/pRV3RV3RV3RV33F3wrxVfK \\V4R,4VuWg R2&Wg R2&K5 VeRVR &WFR &VfV#/VCR V/C#) zBFixture spec from *_usd strings; micros derived exactly (Decimal).rrsubscription_limitrr?_micros_usdrBr8r9r:)r!r) rrrrrrdrPrms &&&&$$ r_fixturersA#Y/.,1ORfhmQnq|HqIJ  ?69'#,:R6SUX 3Aw !gTN"3J  2 m1D$Dq$D*;V$DDrhealthyz30.34z18.00z20.00z12.34 sub_50pctz10.00 sub_75pctz5.00 sub_90pctz2.00grant_exhausted0.00r\out_of_credits)rrdebtz-5.00zdict[str, dict] _DEV_FIXTUREScV^8dQhRR/#rrryr)rs"rrrsvv#9vrc \PPRR4P4pV'd/\ \PPR44'gR#\P P V9gRV9d?\VRRR7;_uu_4pVP4P4pRRR4\PVP44;p'gR#\R/R ^R R /VCBR R R\P!4/B# +'giLg;i \dR#i;i)zFixture CreditsState for HERMES_DEV_CREDITS_FIXTURE, or None (unknown name / unset). Prod-leak guard: applies ONLY when HERMES_DEV_CREDITS is also on, so a stray fixture env var never surfaces fabricated balances.HERMES_DEV_CREDITS_FIXTUREr*HERMES_DEV_CREDITSN/rz utf-8-sig)encodingr(r4rr?Tr>r)osenvironrr`rpathsepopenreadrrrar'rW)rfhspecs rdev_fixture_credits_staters ::>>6 ; A A CD rzz~~6J'KLL ww{{dcTk dC+66"wwy(7"%%djjl3 3D 3  u9a&IDI uW[ uimiririt uu76  s0D5$D"D5" D2 -D52D55 EEcV^8dQhRR/#rr)rs"rrrs)?rc\VRR4p\VRR4pRRlp/pRF$wrVV!\WR44wWE R2&WE R2&K& \VRR4p\V\\34'dV^8d V!V4MRp\VR R4p \ \VR R44p V e^R uVR &VR &Rp\ R/VBRV^,RV^,RRR\ P !4RV!\VRR44^,R\V \4'dT MRRV eR MV^,eRMR/BT ;'g/B# \d\PRRR7R#i;i)uMap a NousPortalAccountInfo into a header-shaped CreditsState for the seed. Float account dollars → micros plus a DISPLAY *_usd (formatting account floats is allowed; parsing a server *_usd is not). Fail-open → None.paid_service_access_infoNrcV^8dQhRR/#)rrztuple[int, str]r)rs"rr1_credits_state_from_account..__annotate__s t t trcj\V\\34'd\VR,4VR 3#R#)r?r@)rQr*)rpr!r=round)dollarss&r_money+_credits_state_from_account.._moneys5EOPWZ]_dYeEfEfE'I-.73-A sls srrrmonthly_creditspaid_service_accessr`rr,r-r/r1r?Fr>r2rollover_creditsr9Tr8rBr7u/credits ▸ seed account→state mapping failedr))rtotal_usable_credits)rsubscription_credits_remaining)rpurchased_credits_remainingNNr) rrpr!r=_window_seed_fieldsr'rWrr6rr) raccsubrrprefixattrmonthlycaprrs & r_credits_state_from_accountrsd6=dND1 t!#KLFBHQT\`IaBb ?FXW% &(?K#0$7!+Gc5\!B!BwQR{fWoXdt2D9$WT>4%HI  HI6 EF( )62D+EC  03A ORSTv ch vzvvwB "730BD#IJ1M cmnrtxcycy[_@D 06/A^^abc^d^pHZv| ||    FQU VsD?EE"E-,E-cV^8dQhRR/#)rrrZr)rs"rrrs7rc~aSfR#\S\4'd SPMRV3Rllp\V!R44pVe\ V4'gR#RV/pV!R4RJVR&V!R4p\V\ 4'dTMRVR&V!R4p\V\ 4'd V'dTMRVR&V#) uPortal ``usage_window`` (NousUsageWindowInfo or dict) → CreditsState window fields; None unless it carries a readable gauge list with an all-scope allowance (same requirement as the header parser).Nc<\SW4#rj)r)r}ruws&&r%_window_seed_fields..s QARrr@rDTrFrCrj)rprrrr rr")rrr@rbrerdsf rrrs zr4(("&&/RC #h- (F ~Yv..#V,C!$%:!;t!CC,-J1;J1M1M:SWC  !F%/%<%<6TC Jrr_seen_usage_bandsicV^8dQhRR/#rrrr)rs"rrrs==d=rcV'gR#\PVR4V\V&\\4\8d.\P\ \ \444R#R#)uRemember the usage band last evaluated for ``session_id`` (process-lifetime). Desktop reap/resume rebuilds the AIAgent per turn, so the in-memory ``_credits_latch`` (and its ``usage_band``) never survives across messages — every rebuild re-announces the current band as a fresh crossing (#101578). ``agent.session_id`` IS stable across those rebuilds, so this map lets ``_hydrate_seed_state`` restore the band the user already saw. Deliberately NOT durable: a real process restart is a real ``session open`` and the cold-start seed should still warn immediately. Bounded (MRU eviction) so a long-lived gateway juggling many sessions cannot grow it without limit.N)rrlen_SEEN_USAGE_BANDS_MAXrDiter) session_idbands&&r_remember_shown_bandrsR *d+$(j!  55d4(9#:;<6r_seen_window_noticesc V^8dQhRRRR/#rrrrrr)rs"rrrsDDdDtDrcV'dVPR4'dR#RVR&\PV4pV'gR#VPR/4pVR,P4F0wrEWAR,9gKVR,P V4WSV&K2 VPR/4P VR,4R# \ d\PRRR 7R#i;i) zXLoad what this session already showed into a fresh latch (once per latch). Never raises.window_restoredNTrrrrzwindow notice restore failedr) rrrrrrr6rr)rrsavedrrrs&& rrestore_window_noticesrsDUYY'899 #' $((4   "-w--/IC/)h##C(!c 0 "-44U8_E D 3d CDs(CC!C8CAC"C43C4c V^8dQhRRRR/#)renabledrrrr)rs"rrrsKKDKTKrc4a^RIHp\VRR4pVeVP'gR#T!W1R7Vn\ V4^RIHp^RIH oV!V3RlRR 7P4R# \d\PR R R 7R#i;i) a The user just changed "Keep going on credits": the agent's state takes the new value now (the next reply's headers confirm it) and the notice policy re-runs, so a "turn on Keep going" line clears at once. The account snapshot the pickers read is refreshed in the background. Never raises.)rU_credits_stateN)rFspawn_context_threadget_nous_portal_account_infoc<S!RR7#)T force_freshrrsrr)apply_keep_going_change..(s %Ad%Srzkeep-going-refreshru#keep going ▸ local refresh failedTr) dataclassesrUrrar_rerun_notice_policyagent.memory_providerrhermes_cli.nous_accountrstartr6rr)agentrrUrrrs&& @rapply_keep_going_changers K'/6 = 5 5 5 &uLU#>HSZnouuw K :T JKs(A1AA11"BBcV^8dQhRR/#rr)rs"rrr-s///rc2\PVR4R#)zNThe session is no longer on a window plan: drop its saved lines. Never raises.N)rr)rs&rforget_window_noticesr-sZ.rc V^8dQhRRRR/#rr)rs"rrr2s E Et E Erc V'gR#VPR/4pR\Uu/uF#q3VR,9gKW29gKW2V,bK% upR\VPR/44/p\P VR4V\V&\ \4\ 8d.\P \\\444R#R#uupi \d\PRRR7R#i;i) z_Record the window notices this session shows now (process lifetime, bounded MRU). Never raises.Nrrrrzwindow notice remember failedTr) r_WINDOW_NOTICE_KEYSrrrrrrDrr6rr)rrrr}entrys&& rremember_window_noticesr2s E  '2&0Ck0C1ERZOG[;`a`j;1Ah;0Ck4 /2 >?A  T2+0Z( # $'< < $ $T$/C*D%E F = l E 4t DEs3CCCC CBCC"D?DcV^8dQhRR/#rr)rs"rrrBs   rc\Wn\VRR4fVPVn\VRR4p\ V\ 4'dXVP eJRVR&\P\VRR44pVe!W2R&VR,P\4\V4R#) zInstall a seed CreditsState on the agent and fire the notice policy once. Primes the crossing gate: the cold-start snapshot IS the first observation, so a session opening in a band warns immediately._credits_session_start_microsN_credits_latchTrrrr) rrr)r rprrorrrrr)rrr prior_bands&& r_hydrate_seed_stater Bs!u5t<D.3.D.D+ E+T 2E%5#6#6#B!%o'**75,+MN  !",,  (O   1 2rcV^8dQhRR/#rr)rs"rrrTs4rcT\\VRR4;p4'd V!4R#R#)_emit_credits_noticesN)callabler)remits& rrrTs''>EEFF GrcV^8dQhRR/#rr)rs"rrrYs L L$ Lrcv^RIHpV!R4R# \d\P RRR7R#i;i)u_Fill the in-process Nous pricing catalog so :func:`is_free_tier_model`'s peek can answer. The peek never fetches and nothing else warms it during session start, so a cold process reads an EMPTY catalog and a subscription-billed model — which spends no credits — still draws the depleted banner. Fail-open: a miss leaves the peek exactly as it was.get_pricing_for_providernousu$credits ▸ nous pricing warm failedTrN)r5rr6rrrs r_warm_nous_pricing_cacherYs5 LF ( L ;d KLs "88cV^8dQhRR/#rHr)rs"rrrfsDrc|a\SRR4;'gRp\SRR4R8wg V'gR#^RIHpHpV!V4'gV!V4'dR#\SRR4pVeVP 4'dR#R V3R llp^R IHpV!VR R 7SnSPP4R#)uDepleted account, model the peek cannot vouch for, Nous catalog cold: start a background warm whose completion re-runs the policy and return True so the caller defers the depleted decision to it — the session-start warm is one-shot but the catalog expires after ``_NOUS_CATALOG_TTL_SECONDS``, and a cold peek would bring the banner back for a subscription-billed model. False = decide now: peek warm, not on Nous, a warm in flight (the warm's own re-run included — fail-open, a failed fetch leaves the peek cold and the banner shows), or a fetch already failed and the cache is still refusing to dial. May raise; the notice path that calls it catches.r'r*rxrF)r1pricing_fetch_suppressed_credits_pricing_warmNcV^8dQhRR/#rr)rs"rr;rewarm_pricing_before_depleted_notice..__annotate__zs$$d$rc2<\4\S4R#rj)rr)rsr_warm_then_rerun?rewarm_pricing_before_depleted_notice.._warm_then_rerunzs "U#rrzcredits-pricing-warmrT) rr5r1ris_aliverrrr)rr'r1rinflightrrsf r%rewarm_pricing_before_depleted_noticer#fsuj"-33Huj"%/xW8$$(@(J(Ju5t.__annotate__s b b$ brc<^RIHp\4V!RR7p\SRR4e\ S4R#\ V4;pe\ SV4R#R# \d\PRRR7R#i;i)rQrTrrNu2credits ▸ session-start seed (background) failedr) rrrrrrr r6rr)rrrrs r_bg_seed/seed_credits_at_session_start.._bg_seeds~ bP)*3E5"2D9E)/8>>EK'u5L b Q\` a bs3AA"A=<A=rz credits-seedru1credits ▸ session-start seed failed (fail-open)r) rrr6r rrrrr)rfixturer)rsf rseed_credits_at_session_startr,s# 5*b )V 3wuFVX\7]7i /1G   w / b b$ ?XN;AAC7 G 8  HSW Xs9!A? A,A?'A?, A<9A?;A<<A??"B%$B%>r7r`rB))g?r2)g?rK)rrZrj)r*) )r)ro)r,rk)r2ro)r3ro)r;ro)r5rorQ)r+rm)r-rm)r4rm)r9rT)r6rF>r;r+r2r)r-r,r)l__conditional_annotations__r __future__rloggingrre threadingrWrrdecimalrtypingrrrutilsragent.usage_gaugesr r r r r rrrr getLoggerrrrr frozensetrcompilerqobjectr r_r%r'r%rrrrCrrrrrrrrrrrrrrrrrrrrrrrrrrr!rrr,r8rMrN_GRANT_ONLY_FIELDSrr^rVrfrurrrrrrrrrrrrrrrrr rrr#r,)r0s@rr>sg> #  !))!      8 $!&$&$%QR **& ' H !*f!56 g(g( g(X;w7v# " 0)2)/CK u=-s T&{ W !25 [  $cglc45Y^5.1& "P  M &7<&R     Z+6UX]U7<Uz%! -0BO/TT 0h  @I J .b $ E! E;? E Ex'7;'7G4&&'2&&'2x'BvEJZ[ HVWgvEJZ [ "  v&@(4=(/0HJ^_dD&K$/ E  $ L>'r