`gj,0dZddlmZddlZGddZy)uBilling and subscription handlers for the interactive CLI (god-file decomposition). This module hosts the Nous billing/subscription methods lifted out of ``cli.py``'s ``HermesCLI`` class. ``HermesCLI`` inherits ``CLIBillingMixin`` so every ``self.`` call resolves unchanged via the MRO — behavior-neutral apart from focused billing fixes. Import discipline mirrors ``hermes_cli.cli_commands_mixin``: * Neutral, non-cyclic dependencies are imported at module top level below. * cli.py-internal symbols (the ``_cprint``/``_b``/``_d`` helpers and display constants) are imported LAZILY inside each method via ``from cli import ...``. The mixin never imports ``cli`` at module load time, avoiding the cycle created when ``cli.py`` imports this mixin. ) annotationsNceZdZdZd(dZd)dZdZdZdddZd Z d Z d d d Z dZ d*d d dZ dddZdZdZd+d,dZddd-dZdZd.dZdZd(dZdZdZdZd Zd!Zd"Zddd#d$Zd%Zd&Zd'Z y)/CLIBillingMixinz@Mixin holding interactive-CLI billing and subscription handlers.cDddlm}m}m} ddlm}m}|}|@|jr3|0d}|jxs|jdk(rdnd}t|ddxs||j} | rd | nd } |r"t|d |d || d }|j||jD] } || d }|jr"|j |d|j d|jdk(r|d |dd }n@|jdk(r1|j d|j dnd} d| d} |d | d }|ry ddlm}|}|syt|D]}td |y #t$rd}d}YwxYw)uPrint the Nous dollar balance block (two-bar view) when a Nous account is logged in. Returns True if it printed anything. Prefers the shared dollar usage model (``agent.billing_usage`` — two-bar plan/top-up view, dollars-only, the /usage + /subscription source of truth). Falls back to the legacy ``nous_credits_lines`` text only when the model is unavailable. Agent-independent (a portal fetch gated on "a Nous account is logged in"), so /usage shows the block even in the TUI slash-worker subprocess that resumes WITHOUT a live agent. Fail-open and wall-clock-bounded; honors HERMES_DEV_CREDITS_FIXTURE for offline testing. r_cprint_b_d)build_usage_model format_renewsNFfreeFreerenews_display · renews  Plan: T Total spendable: $,.2fuC> Free · free models only. Run /subscription to reach paid models.low$under $5! Low balance · z# left. Run /topup or /subscription.)nous_credits_lines)clirr r agent.billing_usager r Exception available plan_namestatusgetattr renews_atprint_usage_bar_lines has_topuptotal_spendable_usdagent.account_usager)selfrr r r r usage printed_anyplanrrenews_bar_ln_amt_lowrlineslines O/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/cli_billing_mixin.py_print_nous_credits_blockz)CLIBillingMixin._print_nous_credits_blocks (' ! L%'E  ]5NK??R1GvTD$U,"232F"R&vh 789:;"  00H # "  #5#<#<#H.u/H/H.NOP||v%"R efghi" &?D?X?X?d544T:;jt*4&0ST"TF $"  ;"$  D Btf+  [ !E M !sF FFc6ddlm}m}|d|dy)aEPrint the `/usage` call-to-action pointing at /subscription + /topup. Mirrors the TUI's ``USAGE_CTA`` (``session.ts``) so every surface ends a usage read with the same nudge. Only called when a Nous account is logged in (the balance block printed), since both commands are Nous-account only. rrr ruARun /subscription to change plan · /topup to add to your balanceN)rrr )r(rr s r2_print_usage_ctaz CLIBillingMixin._print_usage_ctaYs $"R[\]^_cddlm}m}m}ddlm}m}|}|jsRt|jr|d|d|jy|d|dtdy|jd k(rt|d |d td d |jrG|jxsdj}d|j|rd|nd}|d |||jxsd} td| dtd|d |dy|j|||y)u`/subscription` (alias `/upgrade`) — view the Nous plan + browser hand-off. The CLI mirror of the TUI ``SubscriptionOverlay``: a read of the current plan, this cycle's subscription credits, renewal date, and the plans you could switch to — then a deep-link to NAS's own ``/manage-subscription`` page (NOT the Stripe portal; that page routes upgrade→Checkout / downgrade→scheduled internally). The terminal NEVER charges for a subscription. Fail-open: logged-out / portal hiccup degrades to a clear message, never a crash. Mirrors ``_show_billing`` discipline for the interactive-vs-text split. rr)build_subscription_statesubscription_manage_url 💳 zCould not load subscription: Not logged into Nous Portal.z4 Run `hermes portal` to log in, then /subscription.Nteam ⚕ zTeam subscriptionr{─────────────────────────────────────────rOrg:  · z a team orgz This terminal is connected to z. Teams run on a sharedu% balance · use /topup to add funds.z5Personal subscriptions live on your personal account.)rrr r agent.subscription_viewr9r: logged_inr#errorcontextorg_nameroletitle_subscription_overview) r(rr r r9r:staterG _org_lineorgs r2_show_subscriptionz"CLIBillingMixin._show_subscriptionhsT ('](* G{{'"'DU[[M%R"S!TUV '"%C"D!EFGLM  ==F " G fR 3456 7 Bzl# $~~ (b//1#ENN#3Td4&Mr3RS "R ]O,-..0LC 4SE9PQ R 9 : bSTUV W  ##E+B5+IJr7c ddlm}m}m}ddlm} ddlm}|}|j} | xr | j } |j} | r| jxs| jn|r |jnd} |r t|ddnd} | }|r t|ddnd}|s | r| jr|| j}d}| r| jrd }n| r| j rd | j }| sd }nc|-| d k(r(|j"d |j"d}d| |d|d}n4|r t|ddnd}|d|ddnd}|rdn|rd|nd}d| |||}d}| r6| jr*|| j$xsd}| jxsdd|f}nA| r?| j r3|| j&xsd}| jxsd| j |f}|d|rN|\}}}|d|d|d|d|d|d|z|d|d|d |d|d!||t)dd"|j+|| D] }t)||r3t|d#d$r&t|ddt)d%|j"d| r|d|d&n6| d k(r1||j"d |j"dnd'}d(|d)}|d||j,rG|j.xsdj1}d*|j,|rd|nd}|d||t)dd"| s,t)|d|d+|rt)d,|yt|d-ds&t)|rt)d.|t)d/y| r|j3||d01y|j5||y#t$rd}YwxYw)2uPrint the plan read block, then the browser hand-off to manage it. Dollars-only (no "credits") — mirrors the TUI overlay: a status line, the shared two-bar dollar usage view (plan + top-up) with the plan name on the bar, and state-matched free/low nudges. No in-terminal tier picker — the only action is managing the subscription on the portal. rrr r Nr rru → cancelsu → uPlan: Free · free models onlyrrrrrAz leftr&u · $u · view onlyrthe end of the billing period your plancancelszthe end of the cycleu ⏳ zScheduled changeru ──▶ u· z You keep z (and its credits) until then.r>r?r%Frz;> Paid models need a subscription. Start one to reach them.rrz1 left. Top up or upgrade before a mid-run cutoff.r@z%Plan changes need an org admin/owner. Manage on portal: _appz Manage your subscription: z5 Open it in your browser, then re-run /subscription.zStart a subscriptionverb)rrr r rr r rcurrenttier_idcan_change_plan tier_namerr! cycle_ends_atcancel_at_period_endpending_downgrade_tier_namer&cancellation_effective_atpending_downgrade_atr#r$rFrGrH_subscription_open_portal_subscription_change_menu)r(rJ manage_urlrr r r r r)cis_free can_changeru_status view_onlyr_flipr _tot_spend_left_tail_trans_when_from_tor-r.r/rGrKs r2rIz&CLIBillingMixin._subscription_overviewsk (' 6  =%'E MMQYY'** 23Q[[-AIIU%//X\ 5:75(D1"N CH(8$?d!*1??;N ''"E 100A99:;E5F  8u#49R9R9^u0067Di[tD6?FDIWU$94@tF282DeF4=."E'0OYg^DT7UmoEi[wug>F  ''!!"="=>aBaE{{1kIuEF 100!!"8"89S=SE{{1kA4Q4QSXYF  & E3 fR 2345 6 b{3%r"UU]2C1DE F biw.LMNOP Q BK&F %& :, ,,UI> G 'N  WUK7GEK`bf>JJ$"++-D/$tf 2/NOI bI( ) :,  G bCDEF G,ZL9: tVT* G4ZLABMN    * *5*CY * Z  &&uj9C E s O O! O!Manage your subscriptionrVcddlm}m}|st|d|dytd|dfdd g}|j |d | }|j ||}|dk(r>d } ddl} | j|} | std |ttdy|dk(r! |j|td|ytdy#t$rd } YewxYw#t$rtd|YywxYw)u@Open / copy the manage-subscription URL — the portal hand-off.rr5ru6No manage URL available — is your portal configured?Nopenz*open the subscription page in your browser)copyz Copy linkz2copy the manage-subscription URL to your clipboardcancelCancel do nothingrrHdetailchoicesF Open this URL: z4 Finish in your browser, then re-run /subscription.ruu 📋 Copied: z Manage URL:  🟡 Cancelled.) rrr r#_prompt_text_input_modal_normalize_slash_confirm_choice webbrowserrtr_write_osc52_clipboard) r(rJrcrWrr r|rawchoiceopenedrs r2raz)CLIBillingMixin._subscription_open_portals# G bTUVW X   TG H W .  ++$r7+S55c7C V F !#4)*67 G H I v  5++J7 |45 % &   5zl34 5s$'C(C% C"!C"%C?>C?c|j}t|xr|jxs |j}|r |jndxsd}|r dd|ddfdg}nddg}|j d |j d |j d d | }|j||}|dk(r|j|y|dk(r|j|dy|dk(r|j|y|dk(r|j||ytdy)zAThe in-terminal change menu for a paid admin/owner (interactive).NrRkeepzKeep z (undo the scheduled change)zcancel the pending change)change Change planz$upgrade or downgrade in the terminal) cancel_subCancel subscription#schedule cancellation at period endportalManage on portalz%open the billing page in your browser)closeCloseryrrrrzr)resumeNrru 🟡 Closed. No plan change.) rXboolr]r^r[appendrr_subscription_pick_tier_subscription_apply_subscription_confirm_cancelrar#) r(rJrcrd has_pending keep_namer|rrs r2rbz)CLIBillingMixin._subscription_change_menu,s MM1Z!"8"8"YAz:CLIBillingMixin._subscription_pick_tier..TsF1!,,Fs%%c"|jxsdS)Nr)r)rs r2z9CLIBillingMixin._subscription_pick_tier..Ys!,,+!r7)keyz6 No other plans are available to switch to right now.Nupgrade downgraderAu/mo · z switch to rwBackryrz Current: rz$. Pick a plan to preview the effect.rzrw! 🟡 Cancelled. No plan change.)agent.billing_viewrrXtupletiersnextsorted is_enabledrrr#rrYnamedollars_per_monthrr[r!_subscription_preview_and_confirm) r(rJrrdr cur_orderr selectabler| directionrrs r2rz'CLIBillingMixin._subscription_pick_tierNs3 MMekk'R(FFJ  _1all HYXY]^G^Q _+  J K  EA&'ll&7a9%D +I NNAII!&&l1CVCV6W5XX_`i_j'koyz{{A{AzBnCD E E 78++aq{{V<<`a,  55c7C8+ 5 6  ..uf=) `sE3 E3'E3;E3T allow_stepupcddlm}m}m}ddlm}ddlm}m} m } |d|d | |} || } | j}| jxsd }t|d k(r|d|d|dy |dvr8ddlm}|d| j xsd||}|rtd|y |dk(r| j"d| j"dz dnd }|d|dd|d|r|d|d|dn |d|dd} dd lm}|d!"}|j(r |j*nd }||j,d#vr|j.d$}|d|||rd%|d&nd'}d(|f}d)d*|d+fg}nn| j2r't5| j2d,k\r| j2d d,nd-}|d|dd|d.|d/|d0|d1d2|}d3|f}d*|d4fd5g}| j6r|d|d6| j6d7|j9|d8|9}|j;||d*k7r td:y |j=|||;y #| $r'|r|j|d|f Yy td Yy |$r} |j|| Yd } ~ y d } ~ wwxYw#t0$rYdwxYw)=S=S=_Qq--3C89eiD b1232b9I6J5KL M-x/EdVK[\]-x/]^_ JJ B)#6!$SXXD>boo9V&V$&II;.e!fJ bJ() *7;$tfN3A`I)F7 #9:O -.NNs1>>?RVX?XANN3B'_~E b1232b9T6U5VW X l6(*    (89r7Ncjddlm}m}m}m}ddlm} m} m} m } m } m }m }m }|\}}d}|dk(rddlm}|xs|} |dk(r |||xsi}|j'd}|j'd xsd }|j'd}|dk(r|d|d|d|y|dk(r|d|d|d|y|dk(r|d|r |d|y|dk(r|d|r |d|y|j%dy|dk(r|||d|d|n7|dk(r|d |d|d!|n|d"k(r||d|d#||d|d$y#| $r| | | f$r}|j!||Yd}~yd}~w| $rS}t#|dd}t#|d d}|d vs||d k\r|j%|n|j!||Yd}~yd}~wwxYw#| $r&|r|j)|||%Yyt+d&Yy| $r}|j!||Yd}~yd}~wwxYw)'aRun the mutation for `action`, handling the scope step-up + the result. `action` is one of ("upgrade", tier_id) / ("schedule", tier_id) / ("cancel", None) / ("resume", None). insufficient_scope routes to the step-up and replays; the upgrade idempotency key is reused across the replay. ``allow_stepup=False`` (a post-grant replay) declines a second step-up on a repeated scope denial so the flow can't re-prompt/re-open the browser in a loop. rrr _DIM_RST)rBillingTransientBillingRemoteSpendingRevokedrBillingSessionRevoked"delete_subscription_pending_changepost_subscription_upgradeput_subscription_pending_changeNrnew_idempotency_key)ridempotency_keyr rD) network_errorendpoint_unavailableitargetTierNamez your new plan recoveryUrlalready_on_tierru✓ You are already on rupgradedu✓ Upgraded to z,. Your new monthly credits land in a moment.requires_actionuL 🟡 This upgrade needs extra verification (3DS). Finish it on the portal. Portal: payment_faileduV 🔴 Your card was declined. Update your payment method on the portal and try again.rrut✓ Scheduled — your plan doesn't change today. You keep it until the end of the billing period, then it switches.rwT)rwuu✓ Scheduled — your plan stays active until the end of the billing period, then it cancels. Nothing changes today.ru-✓ Undone — you stay on your current plan.z*Re-run /subscription anytime to review it.)rrr)rrr rrrrrrrrrrrrrrr!&_subscription_render_upgrade_ambiguousgetrr#)r(rJrrrrr rrrrrrrrrrkindargrrresr_status_coder r_urls r2rz#CLIBillingMixin._subscription_applys 0/  c 9  >!:%8%:C= 8y 3^abhfhC.*ww/0COww}-..b&=dV1TFKLz)b&6tf?   6  ' ' ) E ,.E t I   2 25$U 2 S  $ $UE?af $ g;  8> ?      E s<D=D:E  D7D22D7: EE EEcddlm}t|dd}t|xsd}|dk(r |dn|dvr |d |n |d |t|d d}|r |d |yy) zLRender a subscription BillingError (a lighter _billing_render_charge_error).r)rrDNzSomething went wrong.insufficient_scopeu= 🟡 Terminal billing isn't enabled. Enable it, then retry.)subscription_mutation_rejectedpreview_rejectedr 🔴 portal_urlr)rrr!str)r(rJrrcodemsgrs r2rz*CLIBillingMixin._subscription_render_errorxs~sGT*#h11 ' ' S T K K gcUO $ gcUO $sL$/  j' ( r7cddlm}m}|d|d|d| t|ddnd}|r |d|yy) ueA charge-route failure (transport / timeout / 500 / unknown status) is AMBIGUOUS — NAS may have already prorated + charged. Steer to a re-check, never a flat failure that invites a blind retry (mirrors the TUI's upgradeResult(null) — the CLI can't persist the key across a command re-run, so a re-check is the safe path).rr5uS 🟡 Couldn't confirm the upgrade — your card may or may not have been charged.rz'"T(,- '"%C"D!EFGEF  u%r7rrc`t|dd}|sy|rtd|td|y)zCPrint a portal deep-link line (the funnel for portal-only actions).r+NrrT)r!r#)r(rJrurls r2_billing_portal_hintz$CLIBillingMixin._billing_portal_hints7e\40   Bvh-  $SE*+r7c vddlm}m}m}ddlm} ddlm}|}t|d|d||j|jrG|jxsdj}d |j|rd |nd} |d || td d |j|t|d dD] } t| |j } | I| j"r2td|| j$d|| j&n td|j(rL|j*r@|j,#td|j,j.n|d |dtd d |j(s#|d |d|j1|y|j*s%|d |d|j1|dyt|dds|j1|ygd} |j3dd| } |j5| | }|dk(r|j7|y|dk(r|j9|y|dk(r|j;|y|dk(r|j=|ytdy#t$rd}YwxYw) uScreen 1 — overview: balance in title, two-bar dollar usage, action menu. Dollars-only (no "credits") — mirrors the TUI /topup overlay: balance leads in the title, the shared plan + top-up bars render below, then the reordered menu (Add funds first). No scope preflight — terminal billing is discovered reactively when a charge 403s insufficient_scope. rrrrPNr;uTop up · balance rr@rArr?ru Auto-reload: on — below  → reload to z Auto-reload: offz Card: uGNo saved card on file — “Add funds” walks you through adding one.+Billing actions require an org admin/owner.,Terminal billing is turned off for this org.z*Enable it on the portal to add funds here.r5rU))buy Add fundszadd money to your balance)auto Auto-reloadzconfigure automatic top-ups)limitz Monthly limitz&show the monthly spend cap (read-only)rrvzTop up your balancerzr=r?rArz Cancelled.)rrr r rrrr rr# balance_usdrFrGrHr$r! auto_reloadenabled threshold_usd reload_to_usdrZcli_billing_enabledrdisplayr8rr_billing_buy_flow_billing_auto_reload_flow_billing_limit_screen_billing_open_portal)r(rJrr r rr r)rGrKr-arr|rrs r2r1z!CLIBillingMixin._billing_overviews ('3  =%'E '"1,u?P?P2Q1RSTUVW >>JJ$"++-D/$tf 2/NOI bI( ) :, ,,UGE;PT4UV G 'N    >zz2<@P@P3Q2RS%%1"2B2B%C$DF *+  U%>%>zz%!3!3 456"R ijklm :, $$ bIJKL M  % %e , (( bJKLM N  % %e4` % a tVT*  % %e ,  ++', 55c7C U?  " "5 ) v   * *5 1 w   & &u - x   % %e , . !i E s J)) J87J8c Fg}|r t|ddnd}||jdkDrtdtdt |j dz}d|zdd|z zz}|j d|j dnd }|xsd jd dd }|jd |d |d|jdd|jd| |r t|ddnd} | D| jdkDr5|jd djd d dd| jdd|S)uThe plan + top-up dollar bars as ready-to-print lines (filled = remaining). Returns [] when there's nothing to draw. The caller resolves ``plan_name`` (the plan-bar label) and picks its own print fn — block ordering differs per surface (``_cprint`` vs ``print`` under patch_stdout). One source of truth for the bar format across /usage, /subscription, and /topup. plan_barNrru█u░rAz% usedrr+r[z] $rz left of $ topup_barztop-upu██████████u · never expires) r! total_usdmaxminround fill_fractionpct_usedljustr remaining_usd) r(r)rr0pbfilledbarpct_slabeltbs r2r$z CLIBillingMixin._usage_bar_lines+s<16WUJ -D >bllQ.CE"*:*:R*?$@ABF6>erF{&;b..2 LL2hnnQ/0*T"BRBRSWAXXij k r7ct|dd}|s tdyd} ddl}|j|}|std|tdy#t$rd}Y)wxYw)Nr+z No portal URL available.Frr}z* Complete billing changes in the browser.)r!r#rrtr)r(rJr7rrs r2rLz$CLIBillingMixin._billing_open_portal@sne\40 . /   __S)F %cU+ , :;  F sA AAcddlm}m}|js-t |d|d|j |y|j s/t |d|d|j |dyy ) zGGuard charge/auto-reload entry points; print + return False if blocked.rr5r;r;Fr<zEnable it on the portal first.r5T)rrr rZr#r8rG)r(rJrr s r2_billing_require_adminz&CLIBillingMixin._billing_require_adminPsx#$$ G gb!NOPQ R  % %e ,(( G gb!OPQR S  % %e4T % Ur7c Nddlm}m}m}m}m}t |d|d|d|d|dgd}td D]}|jd d | } |j| |} | d k(r#|j||d|dQ| dk(r_ddl m }  | } | | jr| }|j)|d|d|jj d||cSt dnt dy#t$rd} YmwxYw)uNo saved card → guide adding one on the portal, with a re-check loop. Cards are added on the portal (never in-terminal). "I've added it" re-fetches billing state so the purchase continues right here once the card is saved — this also recovers a transient miss (the card display is best-effort server-side). Returns the refreshed state (card present), or None to abandon. r)rr r rrr;zAdd a card firstz No saved card on file.ruaAdd a card once on the portal billing page — after that you can top up right from the terminal.))rzAdd a card on the portalz&opens the billing page in your browser)recheckuI've added it — check againz"re-check for the card and continuerrPz Add a cardrrzruCAdd the card on the billing page, then pick “check again” here.rerNu✓ Card found: u — continuing.uM Still no card on file — finish adding it on the portal, then check again. Cancelled. No funds added.)rrr r rrr#rangerrrLrrrrCrrH) r(rJrr r rrr|_rrrr#s r2_billing_add_card_flowz&CLIBillingMixin._billing_add_card_flow`sP 43 '"/0123*+"R{|}~  q A//l2W^/_C99#wGF!))%0"R efghi"B!/1E$!E::)b&6uzz7I7I6JJZ[_Z`ab Lef + , ,-!! E!s/D D$#D$cXddlm}m}ddlmm}|j |syt|ddsjdjfd|jD}t|d|d td |td |j|y|j |j|}| |jyg}|jD]%}|jt||d f'|jd |jd|j}|rd|j nd} |j#d | |} |j%| |} | r| dk(r tdyddlm} | dk(rt|j+d} | tdy|| xsd|j,|j.}|j0std|j2y|j4}n | | }|j9||y#t6$rtdYywxYw)u@Screen 2 (preset select) → Screen 3 (confirm + charge + poll).r)rr rvalidate_charge_amountNrUz, c3.K|] }|ywrr)rrrs r2rz4CLIBillingMixin._billing_buy_flow..sNA QNsr;r>z Presets: z9 Run this in the interactive CLI to complete a purchase.zone-time credit purchase)customuCustom amount…zenter your own amountrvz Payment: zNo saved card on filerzrwrf)Decimalrnz Amount (USD): rmin_usdmax_usdr*u 🔴 Invalid selection.)rrr rrrlrcr!joincharge_presetsr#r8rrirr,rHrrdecimalro_prompt_text_inputrqrrokrDamountr_billing_confirm_and_charge)r(rJrr rlpresetspreset_choicesrrr{rrroenteredvrxrs @r2rIz!CLIBillingMixin._billing_buy_flows#K**51 tVT*iiN9M9MNNG G gbo./ 0 Ky) * M N  % %e ,  :: //6E} 2%% YA  ! !3q6<?J8+ 0 1 # X --.@AG45& 2u}}emmA44y)*XXF   ((7  12 s7HH)(H)cddlm}m}m}ddlm}m}|j}t|d|dtddtd|||r5td |j|j|d|d tddd } |d|| d d||ddfddg} t|dd s tdy |jd||d|r |jnd| } |j| | } | dk(r|j|y | d k7r tdy ddlm} m}m}|} |||}|j+d}|s tdy |d|d|j-|||y #|$r|j'|||Yy | $r}|j)||Yd }~y d }~wwxYw) uFScreen 3 — confirm total + consent, charge, then poll to settlement.rr)rrr;zConfirm purchaserr?z Total: z Payment: Nz.Your card saved on the portal will be charged.z;By confirming, you allow Nous Research to charge your card.payrz nowzsubmit the charge)rrz)manage your card / billing in the browserrrUz3 Run in the interactive CLI to confirm a purchase.?z no saved cardrzrrf)rr post_charge amount_usdrrxrchargeIdu6 🔴 No charge id returned; please check the portal.u-Charge submitted — confirming settlement…)rrr r rrrrr#rH provenancer!rrrLrrrr_billing_handle_scope_required_billing_render_charge_errorr _billing_poll_charge)r(rJrxrr r rrr_consentrrrrrrrresultr charge_ids r2ryz+CLIBillingMixin._billing_confirm_and_charges#''Hzz '"/0123 :,  ,v./01  K ~. /&"R PQRST :, I  "R\N#$d</057J K W 2  tVT* G H ++f-.a0$(DLLo#,  55c?K X   % %e ,  U? 0 1   "#  FCHFJJz*  J K "RGHIJK !!%F;$   / /fVY / Z    - -eS 9  s F%%G G GG cddl}ddlm}ddlm}m}m}|jdz} d} |j| kr ||} | jd }|d k(r?| jd }dd lm }|r|||n||}td|dy|dk(r"|j|| jdy|j| |j| krtd|j|y#|$r6} | jxsd} |jt| dYd} ~ d} ~ w|$r} td | Yd} ~ yd} ~ wwxYw)zGPoll loop: 2s interval, 5-min cap, cancellable. settled = ledger truth.rNr)rrget_charge_statusi,g@u# 🔴 Could not check the charge: r settled amountUsd) parse_moneyu ✓ z added to your balance.failedrus 🟡 Still processing after 5 minutes — this is a timeout, not a failure. Check /billing or the portal shortly.)timerrrrrr retry_aftersleeprUr#r r_billing_render_charge_failedr8)r(rJrrx_timerrrrdeadlineintervalr rwait state_stramtrshowns r2rz$CLIBillingMixin._billing_poll_chargesL3  ::<#%jjlX% *95 8,II%jj-::= [%56H$225&**X:NO KK !1jjlX%6 ? @ !!%(5$ +! CbM* ;C5AB s#DE +D::EEEc|xsdj}|dk(r tdn5|dk(r tdn$|dk(r tdntd|xsd d |j|y ) zCBranch the poll `failed` reasons to the right copy + portal funnel.rauthentication_requiredu` 🔴 Your bank requires verification (3DS). Complete it on the portal to finish this purchase.payment_method_expiredu6 🔴 Your card has expired. Update it on the portal. card_declinedu> 🔴 Your card was declined. Try another card on the portal.u% 🔴 The charge didn't go through (processing_errorz).N)stripr#r8)r(rJrs r2rz-CLIBillingMixin._billing_render_charge_failedGsu,B%%' . . 4 5 / / J K  & R S 9&:VDV9WWYZ [ !!%(r7c2ddlm}m}m}t |dd}t |dd}t |ddxs t |dd}t ||s|dk(r|dk(rd nd } t d | d nt ||s|d k(r t dn|dk(r t dn|dvst |dddk(r t dn|dk(r t dn|dk(r t dn|dk(r>t |dixsijd} | t d| dntt dnht ||r=t |dd} | rd td!t| d"z d#nd$} t d%| d&n|d'k(r t d(nt d ||rt d)|yy)*z6Render a typed BillingError at submit time (pre-poll).r)rrrrDNactorr+remote_spending_revokedadminz*An admin stopped this terminal's spending.z%You stopped this terminal's spending.r*u> Reconnect to restore — run `hermes portal` to re-authorize.session_revokeduH 🔴 Your session was logged out. Run `hermes portal` to log in again.no_payment_methoduC 💳 No card on file — top up and manage billing on the portal.)cli_billing_disabledremote_spending_disabledr-ruU Terminal billing is off for this account — an admin must enable it on the portal. role_requiredzO Adding funds needs an org admin/owner. Ask an admin, or manage on the portal.idempotency_conflictuU 🔴 That charge key was already used for a different amount. Start a fresh top-up.monthly_cap_exceededr remainingUsdu& 🔴 Monthly spend cap reached — $z headroom left.u! 🔴 Monthly spend cap reached.rz (try again in ~<z min)ru! 🟡 Too many charges right nowz. This isn't a payment failure.r'uO 🔴 Terminal billing needs approval — run /topup to enable it, then retry.r) rrrrr! isinstancer#r rTrV) r(rJrrrrr-rr+who remainingrminss r2rz,CLIBillingMixin._billing_render_charge_errorUs  sGT*Wd+S,5[ VZ9[ c7 8DD]<]w&@?  GC5 ^_ ` 2 3t?P7P \ ] ( ( W X I IVT*.HH i j _ $ c d + + i j + + i4:??OI$>ykYZ9: - .3 t4DIM%c!U4"9-=&>%?uESUD 5dV;Z[ \ ) ) c d GC5/ "  Jzl+ , r7rcddlm}m}ddlm}|||nd}t t d|d|d|d t |d ds t d yd d g}|jdd|} |j| |} | dk7r t dyt d ddl m } | d} | s t dyddlm }|}|jr |jst d|j|y|j .t d|d|d|j|y| t dyt ddd ||d!d"fd#g}|jd$||d%|} |j| |dk7r t d&ydd'lm}m}dd(lm}|xs|} |||)}|j-d*}|s t d+y|d|d,|j/|||y#t$r} t d| Yd} ~ yd} ~ wwxYw#|$r} |j+|| Yd} ~ yd} ~ wwxYw)-u403 insufficient_scope → in-flight reauth, then resume the held charge. The buy path discovers terminal billing isn't enabled only when the charge 403s — there is no preflight. We enable it in-flight ("Enable terminal billing" → browser device-flow), then on return ask the user to press Enter to resume the held ``amount`` (reusing ``idempotency_key`` so the resumed charge collapses with the original). Never leaks the raw billing:manage scope. rr5rNz your top-uprrz`To charge this terminal, enable terminal billing once. It opens your browser to authorize, then z picks up right here.rUz> Run `hermes portal` and enable terminal billing, then retry.rrrrrzrzF No charge made. Run /topup when you want to enable terminal billing.rrTrruj Couldn't enable terminal billing — an org admin or owner has to approve it. Your card was not charged.rz Terminal billing was enabled for this terminal, but it's still turned off for this org. Enable it in the portal, then run /topup again.uC ✓ Terminal billing enabled — but there's no card on file yet.z4Top up and manage billing on the portal to continue.u7 ✓ Terminal billing enabled. Run /topup to continue.u ✓ Terminal billing enabled.rzResume z top-upzfinish the held purchase)rwrxrzResume your top-upu. is ready to finish — press Enter to resume.rf)rrrrrz1 No charge id returned; please check the portal.u1Resuming your top-up — confirming settlement…)rrr rrr#r!rrrrrrrCrGr8rrrrrrr r)r(rJrxrrr r amount_strrrrrr!rrr#resume_choicesrrrrrrs r2rz.CLIBillingMixin._billing_handle_scope_requireds $3-3-?\&)]   "#"Rz|F{GG\]^_` atVT* R S  P ' +++C#,  55c?K U? Z [  DE  B0dCG ~   ;#%E$=$= ^ _  % %e ,  ::  W X bRSTU V  % %e ,  > K L  /0 f!5 6g>@Z [ 1 ++&"6*++YZ",   / /^ D P 0 1  F:6!4!6  FCHFJJz*  E F "RKLMNO !!%F;E  8> ?  t   - -eS 9  s0%H H2 H/H**H/2I7IIc ddlm}m}m}ddlm}m}|j|sy|j}|j}t|xr |j} t|d|dtdd|d|d |rtd |jntd |j|y| r1td ||jd ||j t#|ddstd|j|y| rxgd} |j%dd||jd ||j | } |j'| | } | dk(r|j)|y| dk7r tdy| r||jnd} d}|| rd| dndz }|j+|}| tdy|xsdj-s| r |j}n`||xsd|j.|j0}|j2r |j4td|j6y|j4}| r||j nd}d}||rd|dndz }|j+|}| tdy|xsdj-s| r |j }n`||xsd|j.|j0}|j2r |j4td|j6y|j4}||||kr tdytd|jd ||d!}|d||d"d#g}|j%d$d%||d |||} |j'| |}|d&k7r tdydd'lm}m}m} |d(tA|tA|)td*||d ||d+y#|$r|jC|Yy|$r}|jE||Yd}~yd}~wwxYw),u7Screen 4 — auto-reload config: threshold + reload-to → PATCH. Prefills the current values from ``state.auto_reload``. Validates both amounts (2dp, within bounds, ``reload_to > threshold``). When auto-reload is already on, offers a "Turn off" path (PATCH ``enabled:false``). rrrkNr;r@rr?z1Automatically add funds when your balance is low.z Card on file: u1 No saved card — manage billing on the portal.z Currently: below r:rUz6 Run in the interactive CLI to configure auto-reload.))editzEdit thresholdsz change when / how much to reload)offzTurn offzdisable auto-reloadrvu On — below rzrrr~z When balance falls below (USD)z [z]: z: rrpr*z Reload balance to (USD)u; 🔴 Reload-to amount must be greater than the threshold.z5By confirming, you authorize Nous Research to charge z whenever your balance reaches z*. Turn off any time here or on the portal.)agreezAgree and turn onzenable auto-reloadrvzTurn on auto-reload?zBelow rrrpatch_auto_top_upTrD threshold top_up_amountu ✅ Auto-reload on: below r)#rrr r rrrlrcrrCrrDr#rr8rErFr!rr_billing_auto_reload_disablervrrqrrrwrxrDrrrrfloatrr)r(rJrr r rrlrrM currently_on top_choicesrtopcur_thr thr_prompt threshold_raw threshold_amttvcur_rel rel_prompt reload_raw reload_amtrv _ar_consentrrrrrrs r2rJz)CLIBillingMixin._billing_auto_reload_flows ('K**51 zz   B-2::.  '"]+,-. :, "RKLMNO  $T[[M2 3 E F  % %e ,   %l23C3C&D%EF)"*:*:;<>  tVT* J K  % %e ,  K //##L1A1A$B#CD!!-b.>.>!? @B$ 0C66sKHCe|11%8f})*5A,r//0d7 77)3'< // ;  % & #**,,,M'#U]]EMMB55BII-z*+IIM5A,r//0d0 77)3'< ,,Z8   % &  b'')l))J' b%--B55BII-z*+J  !6* :U O P  CDKK=Q--9--H,IJ7 8  "R _%&' @ . ++(L78 U_H`Gab#,  55c?K W  % &    m(@QUXKt:,Y8W[Y8vTX=h~)" )$&@<>,e"N*<  *XG8RDrs # Z)Z)r7