Pmj%0dZddlmZGddZdS)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. ) annotationsceZdZdZd3dZd4dZdZdZd5d Zd Z d ddZ dZ dZ dddZ dZd6dddZdddZdZdZd7d8dZdd d9d"Zd#Zd:d%Zd&Zd3d'Zd(Zd)Zd*Zd+Zd,Zd-Zddd.d/Zd0Z d1Z!d2Z"dS);CLIBillingMixinz@Mixin holding interactive-CLI billing and subscription handlers.returnboolc.ddlm}m}m} ddlm}m}|}n#t$rd}d}YnwxYw|&|jr|d}|j p|j dkrdnd}t|ddp||j } | rd | nd } |r,t|d |d || d }|||j D]} || d }|jr|j|d|jd|j dkr|d |dd }n5|j dkr*|j d|jdnd} d| d} |d | d }|rd Sddlm}|}|sdSt|D]}td |d S)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)clir r r agent.billing_usager r Exception available plan_namestatusgetattr renews_atprint_usage_bar_lines has_topuptotal_spendable_usdagent.account_usager)selfr r r r rusage printed_anyplanrrenews_bar_ln_amt_lowrlineslines B/home/thesage/.hermes/hermes-agent/hermes_cli/cli_billing_mixin.py_print_nous_credits_blockz)CLIBillingMixin._print_nous_credits_blocks (''''''''' ! L L L L L L L L%%''EE ! ! !E MMM !   ]5NK?R1G1GvvTD$U,3332F #:RR 7 7v 7 788::;;;"  00HH # #   "  Q5#<#HOu/HOOOPPP|v%%hRR effhhiii" &&?D?X?d;54;;;;jtT4TTT T $$$"  t ;:::::""$$ 5   D +t++    ts 00NonecDddlm}m}|d|ddS)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. rr r ruARun /subscription to change plan · /topup to add to your balanceN)rr r )r*r r s r4_print_usage_ctaz CLIBillingMixin._print_usage_ctaXsF $#######^RR[\\^^_____cddlm}m}m}ddlm}m}|}|js]t|j r |d|d|j n&|d|dtddS|j d krt|d |d td d |j rE|j pd }d|j |rd|nd}|d |||j pd} td| dtd|d |ddS||||dS)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.)rr r r agent.subscription_viewr<r= logged_inr%errorcontextorg_nameroletitle_subscription_overview) r*r r r r<r=staterJ _org_lineorgs r4_show_subscriptionz"CLIBillingMixin._show_subscriptiongs (''''''''']]]]]]]]((**  GGG{ NU""%RU[%R%R"S"SUUVVVVF""%C"D"DFFGGGLMMM F =F " " GGG G6RR 34466 7 7 7 #z## $ $ $~ . (b//11SENST4QM4MMMrSS ,RR ]],,---.0LC QSQQQ R R R 9 : : : GVSTTVV W W W F ##E+B+B5+I+IJJJJJr:c ddlm}m}m}ddlm} ddlm}|}n#t$rd}YnwxYw|j} | o| j } |j } | r| j p| j n |r|j nd} |rt|ddnd} | }|rt|ddnd}|s| r| jr|| j}d}| r | jrd }n| r| jr d | j}| sd }n^|$| d kr|jd |jd}d| |d|d}n8|rt|ddnd}|d|ddnd}|rdn|rd|nd}d| |||}d}| r&| jr|| jpd}| j pdd|f}n,| r*| jr#|| jpd}| j pd| j|f}|d|rc|\}}}|d|d|d|d|d|d|z|d|d|d |d|d!||t)dd"||| D]}t)||r:t|d#d$r)t|ddt)d%|jd| r|d|d&n0| d kr*||j d |jdnd'}d(|d)}|d||jrE|jpd}d*|j|rd|nd}|d||t)dd"| s;t)|d|d+|rt)d,|dSt|d-ds3t)|r!t)d.|t)d/dS| r|||dS|||dS)0uPrint 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. rr rr Nr"rru → cancelsu → uPlan: Free · free models onlyrrrrrDz 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.rArBr'Frz;> Paid models need a subscription. Start one to reach them.rrz1 left. Top up or upgrade before a mid-run cutoff.rCz%Plan changes need an org admin/owner. Manage on portal: _appz Manage your subscription: z5 Open it in your browser, then re-run /subscription.)rr r r rrr rcurrenttier_idcan_change_plan tier_namer!r# cycle_ends_atcancel_at_period_endpending_downgrade_tier_namer(cancellation_effective_atpending_downgrade_atr%r&rIrJrK_subscription_free_catalog_subscription_change_menu)r*rM manage_urlr r r rr r+cis_free can_changer!u_status view_onlyr_flipr"_tot_spend_left_tail_trans_when_from_tor/r0r1rJrNs r4rLz&CLIBillingMixin._subscription_overviews- (''''''''' 655555  = = = = = =%%''EE   EEE  MQY'* 23]Q[-AIU:\%//X\ 5:D75(D111"N CHR(8$???d i>>>u>>F   Z' Z!M!"=>>aBaE{1kIuEFF  Z10 Z!M!"899S=SE{1kA4QSXYF   & E3 G5RR 23355 6 6 6 GEEE3EE""UU]2C2CEE F F F GPMMMMNNPP Q Q Q GBKKK%F%%&&& :   ,,UI>>  G 'NNNN  KWUK77 KGEK`bf *J$"++--DOO0M t 2OOI G(I(( ) ) ) :     GGG GFCDDFF G G G ;9Z99::: FtVT**  GGG OAZAABBBMNNN F    + +E: > > > F &&uj99999 # 22urlstrc|sdS ddlm}m}|s |sdSn#t$rYnwxYw ddl}t ||S#t$rYdSwxYw)a\Open ``url`` in a REAL graphical browser; return whether one opened. The one opener behind every "open the portal" path in this mixin. Applies the same console-browser / remote-session guard the device-code auth flows use (``hermes_cli.auth``): ``webbrowser.open()`` returns ``True`` even when it launched a text-mode browser (w3m/lynx over SSH) that hijacks the TTY, so we refuse those and let the caller print the URL instead. Returns ``False`` on any guard refusal or open failure, ``True`` only when a real graphical browser launched. Fr)_can_open_graphical_browser_is_remote_sessionN)hermes_cli.authrwrxr webbrowserropen)r*rtrwrxrzs r4_open_url_in_browserz$CLIBillingMixin._open_url_in_browsers 5  W W W W W W W W!!## +F+F+H+H u     D       ,,-- -   55 s% 22%A A*)A*c xddlm}m}m}ddlmm}m}||}|s|||ddSt|d|dtd d t|d D]#\} } td | d | $|d |d fd|D} | d| dd| } | pd } | rHd t| cxkrt!|kr!nn|t| d z jn|| | rdkrtddS||p|}|s|d |ddSt'fd|Dd}|r|jnd}||rtd|dntd|d|tddS)uFree + admin/owner + interactive: print the plan catalog, pick one, then open the portal manage-subscription deep-link with ``plan=``. The catalog mirrors the TUI Free rows (name · $/mo · $credits/mo, from the same ``tiers[]`` data via the shared ``selectable_tiers`` / ``format_tier_row`` helpers). Monthly credits are DOLLARS — rendered ``$X credits/mo`` (hidden when absent/zero). Starting a NEW subscription needs a fresh card, so the only action is the portal hand-off (the terminal never charges here); the picked tier rides along as ``plan=`` so the portal preselects it. rr )format_tier_rowselectable_tiersr=zStart a subscriptionverbNrAz Choose a planrrBz. z:Starting a subscription opens the portal to add your card.cHg|]}|j|d|jdfS)zstart z on the portal)rZname).0tr~s r4 z>CLIBillingMixin._subscription_free_catalog..Ds;cccXYAIq113RAF3R3R3RScccr:cancelCancel do nothingz%Pick a plan to open it on the portal.rKdetailchoicesrru" 🟡 Cancelled. No plan started.rZ6No manage URL available — is your portal configured?c32K|]}|jk |VdSNr)rrchoices r4 z=CLIBillingMixin._subscription_free_catalog..[s/??Q19+>+>q+>+>+>+>??r:rUz Opening the portal to start u…z Open this URL to start : 4 Finish in your browser, then re-run /subscription.)rr r r rEr~rr=_subscription_open_portalr% enumerateappend_prompt_text_input_modalstripisdigitintlenrZ_normalize_slash_confirm_choicenextrr|)r*rMrdr r r rr=tiersirrraw_digittier_urlpickedlabelrr~s @@r4rbz*CLIBillingMixin._subscription_free_catalog$s' ('''''''''          ! ''   * *5*CY * Z Z Z F .O,,../// :   eQ'' 2 2DAq 0q00OOA..00 1 1 1 1WRRTUUWWXXXcccc]bccc9:::++(:,  )""$$ >>   HS[[ > > > >CJJ > > > > >3v;;?+3FF99#wGGF 8++ 6 7 7 7 F+*5&AAAOZ  GWTUUWW X X X F????%???FF%6 ;  $ $X . . C =5=== > > > > AeAAxAA B B B DEEEEEr:Manage your subscriptionrcLddlm}m}|s't|d|ddStd|dfdd g}||d | }|||}|dkrF||std |ttd dS|dkrM ||td|dS#t$rtd|YdSwxYwtddS)u@Open / copy the manage-subscription URL — the portal hand-off.rr8rrNr{z*open the subscription page in your browser)copyz Copy linkz2copy the manage-subscription URL to your clipboardrrr Open this URL: rru 📋 Copied: z Manage URL:  🟡 Cancelled.) rr r r%rrr|_write_osc52_clipboardr) r*rMrdrr r rrrs r4rz)CLIBillingMixin._subscription_open_portales########  GGG GWTUUWW X X X F  TG H W .  ++$r7+SS55c7CC V  ,,Z88 86*66777 GGG H I I I I I v   5++J7774 4455555 5 5 53z33444444 5 % & & & & &s 'C22DDcF|j}t|o |jp|j}|r|jndpd}|r dd|ddfdg}nddg}|d |d |d d | }|||}|dkr||dS|dkr| |ddS|dkr| |dS|dkr| ||dStddS)zAThe in-terminal change menu for a paid admin/owner (interactive).NrUkeepzKeep 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)closeCloserrrrr)resumeNrru 🟡 Closed. No plan change.) rYrr^r_r\rrr_subscription_pick_tier_subscription_apply_subscription_confirm_cancelrr%) r*rMrdre has_pending keep_namerrrs r4rcz)CLIBillingMixin._subscription_change_menus M1Z!"8"YA=S=_9q-39999eiD GL122LLbb9I6J6JLL M M M `\\\d\\\]]]]^^^^___ JJ BBBBBB))#666!$8SXXD>bo9V&V&V$&I!f!f!fJ     G)J)) * * *7;`3t3333A`I)F7 #9:OO -.N~s1>?R?RVX?X?XAN3B3''_~E GW122WWbb9T6U6UWW X X X G{6{{U{{{ | | |6f66I '*F #676O " V GTQq7NQQQRRTT U U U++)BP_+``  / /_ E E N N 5 6 6 6 F   \ JJJJJs/ A0B3B7BB"7G G'&G'cddlm}m}m}ddlm}|j}|r|jr||jndpd}t|d|dd|d|d |r|j nd d |d |d|d ddg}| dd|} | | |dkrtddS| |ddS)z4Confirm, then schedule a cancellation at period end.rr rRNrTrzConfirm cancellationrz Cancel rUu — it stays active until z, then won't renew.zOYou keep your remaining credits for this period. You can resume before it ends.)rrr)rrzkeep your planzCancel subscription?rrru) 🟡 Cancelled. Your plan is unchanged.)rN) rr r r rrrYr]r%r\rrr) r*rMr r r rre_endrrs r4rz,CLIBillingMixin._subscription_confirm_cancelsm''''''''''555555 M34SS ao...twXw TRR.//TT226Q3R3RTTUUUuA>Q[[;uu\`uuuvvvlRRijjllmmm Q 3 ++2HQS]l+mm  / /_ E E N N = > > > F   (899999r:NcDddlm}m}m}m}ddlm} m} m} m } m } m }m }m }|\}}d}|dkrddlm}|p |} |dkr| |||pi}n#| $r| | | f$r!}|||Yd}~dSd}~w| $re}t#|dd}t#|d d}|d vs||d kr||n|||Yd}~dSd}~wwxYw|d}|d pd }|d}|dkr|d|d|d|nt|dkr|d|d|d|nY|dkr|d|r|d|n7|dkr|d|r|d|n|ddS|dkr|||d|d|nE|dkr|d |d|d!|n!|d"kr||d|d#||d|d$dS#| $r0|r||||%YdSt+d&YdS| $r!}|||Yd}~dSd}~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. rr r _DIM_RST)rBillingTransientBillingRemoteSpendingRevokedrBillingSessionRevoked"delete_subscription_pending_changepost_subscription_upgradeput_subscription_pending_changeNrnew_idempotency_key)ridempotency_keyr"rG) 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.rT)ruu✓ 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)rr r rrrrrr rr r r r rrrr#&_subscription_render_upgrade_ambiguousgetrr%)r*rMrrrr r rrrrr rr r r r kindargkeyrresr_status_coder"r_urls r4rz#CLIBillingMixin._subscription_apply5s 0///////////  c 9   > > > > > >!:%8%8%:%:C= 8y  33^abbbhfhCC+(*?A]^33E3???FFFFF#   %c8T::G#C$77E IIIW_`gkn`n`n CCCHHHH77sCCCFFFFF **ww/00COww}--...GKKKdKKTKKLLLLz))Goootooimoopppp000Gjkkk5 3T 3 3444///Gtuuu5 3T 3 3444??EEEz!!//SIIII^T^^X\^^____!!//t<<<<_T__Y]__````!!22444VTVVPTVVWWW GKHIIKK L L L L L# ] ] ] ]88f^a8bbbbbb\]]]]]] 8 8 8  + +E3 7 7 7 7 7 7 7 7 7 8siI AI C/&B<IC/ AC*$I*C//CIBIJ(J:J>JJ)rcVddlm}m}m}m}t t d|d|dt |ddst ddSd d g}|d d | } || |dkrt ddSt d ddl m } | d} n*#t$r} t d| Yd} ~ dSd} ~ wwxYw| st ddS|d|d| ddl m } | n#t$rYnwxYwddlm} |}n#t$r|}YnwxYw|\}}|dkr|||ddS||||ddS)u?insufficient_scope → allow remote spending (step-up), then replay `retry`. Mirrors _billing_handle_scope_required: the classic CLI calls step_up_nous_billing_scope directly (it opens the browser + blocks), then replays the held preview/mutation so the user never re-runs the command. rr ! One-time setuprzTo change your plan from the terminal, allow Remote Spending once. It opens your browser to authorize, then your change picks up right here.rXNzK Run `hermes portal` and allow Remote Spending, then re-run /subscription.rAllow Remote Spendingzopen your browser to authorizenozNot nowrr&.Opens your browser to authorize this terminal.rrz: No change made. Allow Remote Spending when you're ready.2 Opening your browser to allow Remote Spending…step_up_nous_billing_scopeT open_browser" Couldn't allow Remote Spending: uZ Couldn't allow Remote Spending — an org admin or owner has to approve it for this org.u✓ Remote Spending allowed.) nous_billing)r<rFr)rr)rr r rrr%r#rrryr,r hermes_clir0invalidate_cached_tokenrEr<rr)r*rMrrr r rrrrr,grantedr_nbr<freshrkindrargs r4rz3CLIBillingMixin._subscription_handle_scope_requireds 0///////////  "###jRRghhjj k k ktVT**  _ ` ` ` F N ' ++)C#,    / /_ E E N N N O O O F BCCC  B B B B B B00dCCCGG    >>   6 6 6 6 6 6  ' ' ) ) ) )    D  EDDDDD ,,..EE   EEE  t I    2 25$U 2 S S S S S  $ $UE?af $ g g g g gs<:C C4C//C4D77 EE E E('E(cddlm}t|dd}t|pd}|dkr |dn!|dvr|d |n|d |t|d d}|r|d |dSdS) zLRender a subscription BillingError (a lighter _billing_render_charge_error).r)r rGNzSomething went wrong.insufficient_scopeu? 🟡 Remote Spending isn't allowed yet. Allow it, then retry.)subscription_mutation_rejectedpreview_rejectedr 🔴 portal_urlr)rr r#ru)r*rMrr codemsgr"s r4rz*CLIBillingMixin._subscription_render_errorssGT**#hh11 ' ' ' GU V V V V K K K GOcOO $ $ $ $ GOcOO $ $ $sL$//  ) G''' ( ( ( ( ( ) )r:cddlm}m}|d|d|d|t|ddnd}|r|d|dSdS) 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).rr8uS 🟡 Couldn't confirm the upgrade — your card may or may not have been charged.rzr?z- Run `hermes portal` to log in, then /topup.N) rr r rrrFr%rG_billing_overview)r*rBr r rrM_msgs r4 _show_billingzCLIBillingMixin._show_billings $#######::::::##%%  GGG{ G>>>,""T((,,----F""%C"D"DFFGGGEFFF F u%%%%%r:rrrc|t|dd}|sdS|rtd|td|dS)zCPrint a portal deep-link line (the funnel for portal-only actions).r=NrrW)r#r%)r*rMrrts r4_billing_portal_hintz$CLIBillingMixin._billing_portal_hintsYe\400  F  ! -v--  *S**+++++r:c Pddlm}m}m}ddlm} ddlm}|}n#t$rd}YnwxYwt|d|d||j |j rE|j pd }d |j |rd |nd} |d || td d ||t|d dD]} t| |j} | H| jr2td|| jd|| jntd|jrB|jr;|jtd|jjn|d |dtd d |js.|d |d||dS|js0|d |d||ddSt|dds||dS|d |d| m| jrf| j_| jrF| j?| jr&d|| jd|| jd} nd} |d || td d gd} |dd| }||| }|d kr||dS|d!kr||dS|d"kr||dS|d#kr||dStd$dS)%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 — remote spending is discovered reactively when a charge 403s insufficient_scope. rr  format_moneyrSNr>uTop up · balance rrCrDrrBr!u 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.$Remote spending is off for this org.zUA billing admin can turn it on from the portal's Hermes Agent page to add funds here.rGrXu?Add funds now — a single charge, added to your balance today.uRefill when low — charges z- automatically when your balance falls below rueRefill when low — charges your card automatically when your balance falls below the amount you set.))buy Add fundsz,a single charge, added to your balance today)auto Auto-reloadz/refill automatically when your balance runs low)limitz Monthly limitz&show the monthly spend cap (read-only)rrzTop up your balancerrPrRrTrz Cancelled.) rr r r rrLrr rr% balance_usdrIrJrKr&r# auto_reloadenabled threshold_usd reload_to_usdr[cli_billing_enabledrdisplayrI is_finiterr_billing_buy_flow_billing_auto_reload_flow_billing_limit_screen_billing_open_portal)r*rMr r r rLr r+rJrNr/ar _auto_linerrrs r4rDz!CLIBillingMixin._billing_overviews9 ('''''''''333333  = = = = = =%%''EE   EEE  V""S,,u?P2Q2QSSTTVVWWW > *J$"++--DOO0M t 2OOI G(I(( ) ) ) :   ,,UGE;PT4U4UVV  G 'NNNN   >z ,F<<@P3Q3QFF%1\"2B%C%CFF *+++   nU%> nz%5!3556666lRR ijjllmmm :   $  GLIJJLL M M M  % %e , , , F(  GEBCCEE F F F  % %n &    FtVT**   % %e , , , F \RRYZZ\\]]] N   , **,,- , **,,-S||BN1O1OSSS J 2  %RR ^^%%&&& :      ++',  55c7CC U??  " "5 ) ) ) ) ) v    * *5 1 1 1 1 1 w    & &u - - - - - x    % %e , , , , , . ! ! ! ! !rslistc Hg}|rt|ddnd}||jdkrtdtdt |jdz}d|zdd|z zz}|j d|jdnd }|pd d dd }|d |d |d|j dd|jd| |rt|ddnd} | C| j dkr8|d dd d dd| j dd|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░rDz% usedrr-r[z] $rz left of $ topup_barztop-upu██████████u · never expires) r# total_usdmaxminround fill_fractionpct_usedljustr remaining_usd) r*r+r!r2pbfilledbarpct_srtbs r4r&z CLIBillingMixin._usage_bar_linessm16 @WUJ - - -D >blQ..CE"*:R*?$@$@AABBF6>erF{&;b.22 LLjhnnQ//jj*jj"BRjjjj k k k r:ct|dd}|stddS||std|tddS)Nr=z No portal URL available.rz* Complete billing changes in the browser.)r#r%r|)r*rMrts r4r`z$CLIBillingMixin._billing_open_portalsqe\400  . / / / F((-- - +c++ , , , :;;;;;r:c&ddlm}m}|jst |d|d||ddSd S) zGGuard charge/auto-reload entry points; print + return False if blocked.rr8r>rNFrOzWA billing admin can turn it on from the portal's Hermes Agent page before adding funds.rGT)rr r r[r%rIrZ)r*rMr r s r4_billing_require_adminz&CLIBillingMixin._billing_require_admins########$  GGG GQbb!NOOQQ R R R  % %e , , ,5(  GGG GJbb!GHHJJ K K K  % %p &   5tr:c ddlm}m}m}m}m}t |d|d|d|d|dgd}td D]}|d d | } | | |} | d kr-| ||d|dc| dkrhddl m }  | } n#t$rd} YnwxYw| | jr| }|j"|d|d|jjd||cSt dt ddS)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)r r 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 continuerrfz Add a cardrrruCAdd the card on the billing page, then pick “check again” here.rzrNu✓ Card found: u — continuing.uM Still no card on file — finish adding it on the portal, then check again. Cancelled. No funds added.)rr r r rrr%rangerrr`rrrrFrr[) r*rMr r r rrr_rrrr5s r4_billing_add_card_flowz&CLIBillingMixin._billing_add_card_flows 43333333333333 2""/0022333*+++~RR{||~~    q  A//l2W^/__C99#wGGF!!))%000hRR effhhiii""BBBBBB!//11EE !!! EEE!$$!E:)Gaaauz7Iaa[_aabbb LLLefff  ,---ts C$$ C32C3cddlm}m}ddlmm}||sdSt|ddsdfd|j D}t|d|d td |td | |dS|j | |}||j dSg}|j D]0}|t||d f1|d |d|j }|r d|jnd} |d | |} || |} | r| dkrtddSddlm} | dkrj|d} | tddS|| pd|j|j}|jstd|jdS|j}n- | | }n #t6$rtdYdSwxYw|||dS)u@Screen 2 (preset select) → Screen 3 (confirm + charge + poll).r)r r rLvalidate_charge_amountNrXz, c3.K|]}|VdSr)rrrLs r4rz4CLIBillingMixin._billing_buy_flow.. s+NNA QNNNNNNr:r>rQz Presets: z9 Run this in the interactive CLI to complete a purchase.zone-time credit purchase)customuCustom amount…zenter your own amountrz Payment: zNo saved card on filerrr{)Decimalrz Amount (USD): rmin_usdmax_usdr<u 🔴 Invalid selection.)rr r rrLrrxr#joincharge_presetsr%rIrr~rrur[rrdecimalr_prompt_text_inputrrokrGamountr_billing_confirm_and_charge)r*rMr r rpresetspreset_choicesrrrrrrenteredvrrLs @r4r]z!CLIBillingMixin._billing_buy_flows########KKKKKKKK**511  FtVT** iiNNNN9MNNNNNG GGG G/bboo// 0 0 0 ))) * * * M N N N  % %e , , , F : //66E} 2% Y YA  ! !3q66<<??JJ 8++ 0 1 1 1 F###### X  --.@AAG4555&& 2u}emA4 )))***XFF     1222  ((77777s H''IIcddlm}m}m}ddlm}m}|j}t|d|dtddtd|||r5td |j |j |d|d tddd } |d|| d d||ddfddg} t|dd stdd S| d||d|r|j nd| } | | | } | dkr||d S| d krtdd Sddlm} m}m}|} |||}nH#|$r||||Yd S| $r!}|||Yd }~d Sd }~wwxYw|d}|stdd S|d|d||||d S) uFScreen 3 — confirm total + consent, charge, then poll to settlement.rr )rLrr>zConfirm purchaserrBz 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 browserrrXz3 Run in the interactive CLI to confirm a purchase.?z no saved cardrrr{)rr post_charge amount_usdrrrchargeIdu6 🔴 No charge id returned; please check the portal.u-Charge submitted — confirming settlement…)rr r r rrLrrr%r[ provenancer#rrr`rrrr_billing_handle_scope_required_billing_render_charge_errorr_billing_poll_charge)r*rMrr r r rLrr_consentrrrrrrrresultr charge_ids r4rz+CLIBillingMixin._billing_confirm_and_chargeDsr''''''''''HHHHHHHHz 2""/0022333 :    0,,v..00111  U . .. / / /&SRR PQQSSTTT :   I  #RR\\##$$$5<<//5557J K W 2  tVT**  G H H H F++0f--000$(=DLLo#,   55c?KK X    % %e , , , F U?? 0 1 1 1 F          "!##  [FCHHHFF#     / /fVY / Z Z Z FF     - -eS 9 9 9 FFFFF JJz**   J K K K FJRRGHHJJKKK !!%F;;;;;s F G%G%G  G%cFddl}ddlm}ddlm}m}m}|dz} d} || kr6 ||} n^#|$r6} | jpd} |t| dYd} ~ \d} ~ w|$r} td | Yd} ~ dSd} ~ wwxYw| d }|d krQ| d }dd lm }|r|||n ||}td|ddS|dkr+| || ddS|| || k6td||dS)zGPoll loop: 2s interval, 5-min cap, cancellable. settled = ledger truth.rNrK)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.)timerrLrrrr retry_aftersleeprkr%rr_billing_render_charge_failedrI)r*rMrr_timerLrrrdeadlineintervalr"rwait state_stramtrshowns r4rz$CLIBillingMixin._billing_poll_charges<333333          ::<<#%jjllX%% **955#   +! CbMM***   ACAABBB  8,,II%%jj--:::::::=W [[%5%5666<>>H$$225&**X:N:NOOO KK ! ! !1jjllX%%6 ? @ @ @ !!%(((((s$ AB/,B  B/B**B/c |pd}|dkrtdnA|dkrtdn+|dkrtdntd|pd d ||d S) 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)rr%rI)r*rMrs r4rz-CLIBillingMixin._billing_render_charge_faileds,B%%'' . . . 4 5 5 5 5 / / / J K K K K  & & R S S S S Z&:VDVZZZ [ [ [ !!%(((((r:cddlm}m}m}t |dd}t |dd}t |ddpt |dd}t ||s|dkr|dkrd nd } t d | d nkt ||s|d krt dnD|dkrt dn-|dvst |dddkrt dn|dkrt dn|dkrt dn|dkrLt |dipid} | t d| dnt dnt ||rMt |dd} | r$d td!t| d"z d#nd$} t d%| d&n(|d'krt d(nt d ||rt d)|dSdS)*z6Render a typed BillingError at submit time (pre-poll).r)rr r rGNactorr=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>ruq Remote spending is off for this account — a billing admin can turn it on from the portal's Hermes Agent page. 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 ~r<z min)ru! 🟡 Too many charges right nowz. This isn't a payment failure.r9uM 🔴 Remote Spending needs approval — run /topup to allow it, then retry.r) rrr r r# isinstancer%rrjrl) r*rMrrr r r>rr=who remainingrminss r4rz,CLIBillingMixin._billing_render_charge_errors          sGT**Wd++S,55[ VZ9[9[ c7 8 8 #DD]<]<]w&&@??  _C___ ` ` ` ` 2 3 3 #t?P7P7P \ ] ] ] ] ( ( ( W X X X X I I IVT**.HHH F G G G G _ $ $ c d d d d + + + i j j j j + + + i44:??OOI$YyYYYZZZZ9:::: - . . #3 t44DIMUEc!U4"9-=-=&>&>EEEESUD [d[[[ \ \ \ \ ) ) ) a b b b b /C// " " "  - +z++ , , , , , - -r:rcddlm}m}ddlm}| ||nd}t t d|d|d|d t |d dst d dSd d g}|dd|} || |} | dkrt ddSt d ddl m } | d} n*#t$r} t d| Yd} ~ dSd} ~ wwxYw| st ddSddlm }|}|j r|js&t d||dS|j=t d|d|d||dS|t ddSt ddd ||d!d"fd#g}|d$||d%|} || |dkrt d&dSdd'lm}m}dd(lm}|p |} |||)}n)#|$r!} ||| Yd} ~ dSd} ~ wwxYw|d*}|st d+dS|d|d,||||dS)-u403 insufficient_scope → in-flight reauth, then resume the held charge. The buy path discovers remote spending isn't allowed only when the charge 403s — there is no preflight. We allow it in-flight ("Allow Remote Spending" → 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. rr8rKNz your top-upr$rzcTo charge from this terminal, allow Remote Spending once. It opens your browser to authorize, then z picks up right here.rXz< Run `hermes portal` and allow Remote Spending, then retry.r%r'r&r)rrzD No charge made. Run /topup when you want to allow Remote Spending.r*r+Tr-r/uh Couldn't allow Remote Spending — an org admin or owner has to approve it. Your card was not charged.rz Remote Spending is allowed for this terminal, but it's still off for this org. A billing admin can turn it on from the portal's Hermes Agent page, then run /topup again.uB ✓ Remote Spending allowed — but there's no card on file yet.z4Top up and manage billing on the portal to continue.u6 ✓ Remote Spending allowed. Run /topup to continue.u ✓ Remote Spending allowed.rzResume z top-upzfinish the held purchase)rrrzResume your top-upu. is ready to finish — press Enter to resume.r{)rrrrrz1 No charge id returned; please check the portal.u1Resuming your top-up — confirming settlement…)rr r rrLr%r#rrryr,rrrFrZrIrrrrrrrr)r*rMrrr r rL amount_strrrrr,r3rrr5resume_choicesrrrrrrs r4rz.CLIBillingMixin._billing_handle_scope_requiredsp $#######333333-3-?\\&)))]   "###cRR`I```aacc d d dtVT**  P Q Q Q F N ' ++)C#,   55c?KK U?? X Y Y Y F BCCC  B B B B B B00dCCCGG     J K K K F ./// >f!5!5>>>@Z [ 1 ++&"l6**ZZZ",    / /^ D D P P 0 1 1 1 F FEEEEEEE::::::6!4!4!6!6  [FCHHHFF     - -eS 9 9 9 FFFFF JJz**   E F F F FNRRKLLNNOOO !!%F;;;;;s0C$$ D .DD  II=I88I=c " ddlm}m}m}ddlm}m}||sdS|j}|j }t|o|j } t|d|dtdd|d|d |rtd |j n&td ||dS| r1td ||jd ||jt#|dds&td||dS| rgd} |dd||jd ||j| } || | } | dkr||dS| dkrtddS| r||jnd} d}|| rd| dndz }||}|tddS|pds | r|j}nH||pd|j|j}|jr|jtd|jdS|j}| r||jnd}d}||rd|dndz }||}|tddS|pds | r|j}nH||pd|j|j}|jr|jtd|jdS|j}||||krtddStd|j d ||d!}|d||d"d#g}|d$d%||d |||} || |}|d&krtddSdd'lm}m}m} |d(tA|tA|)nE#|$r|!|YdS|$r!}|"||Yd}~dSd}~wwxYwtd*||d ||d+dS),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``). rr rNr>rSrrBz1Automatically add funds when your balance is low.z Card on file: u1 No saved card — manage billing on the portal.z Currently: below rMrXz6 Run in the interactive CLI to configure auto-reload.))editzEdit thresholdsz change when / how much to reload)offzTurn offzdisable auto-reloadru On — below rrrrz When balance falls below (USD)z [z]: rrrr<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-reloadrzTurn on auto-reload?zBelow rrrpatch_auto_top_upTrW threshold top_up_amountu ✅ Auto-reload on: below r)#rr r r rrLrrxrrVrrWr%rrIrXrYr#rr_billing_auto_reload_disablerrrrrrrGrrrrfloatrr)r*rMr r r rLrrra currently_on top_choicesrtopcur_thr thr_prompt threshold_raw threshold_amttvcur_rel rel_prompt reload_raw reload_amtrv _ar_consentrrrrrrs r4r^z)CLIBillingMixin._billing_auto_reload_flow^s ('''''''''KKKKKKKK**511  Fz  B-2:..  -""]++--... :   NRRKLLNNOOO   2T[22 3 3 3 3 E F F F  % %e , , , F   >ll23C&D&D>>)\"*:;;>>    tVT**  J K K K  % %e , , , F  K //#BLL1A$B$BBB!-b.>!?!?BB$ 0C66sKHHCe||11%888f}})***5AJ,,r/000d7 7<'7''''< // ;;  % & & & F#**,, & &,MM''#U]EMB5 BI-***+++IM5AJ,,r/000d0 7<'7''''< ,,Z88   % & & & F b'')) #l #)JJ'' b%-B5 BI-***+++J  !6* :U:U O P P P F  8DK 8 8-9\--H-H 8 8 8  &RR __&&''' @ . ++(bLL77bb U_H`H`bb#,   55c?KK W   % & & & F            m(<(zMonthly spend limitrrBNz/No monthly cap visible (managed on the portal).z (default ceiling)rz of z used this monthuKThe monthly limit is set on the portal — the terminal shows it read-only.) rr r r rrLr% monthly_cap limit_usdspent_this_month_usdis_default_ceilingrI) r*rMr r r rLcapspentrTceiling _limit_notes r4r_z%CLIBillingMixin._billing_limit_screensU''''''''''333333 5""23355666 :    ;#-/ GPMNNPP Q Q Q Q L!9::E L//E.1.DL**"G BuBB%BBBB C C C   &RR __&&''' !!%(((((r:)rr)rr6)rtrurrr)rA)rBru)rrurr6)rrc)#__name__ __module__ __qualname____doc__r5r9rPrLr|rbrrcrrrrrrrrFrIrDr&r`rxr~r]rrrrrr^rr_rr:r4rrsJJ????B ` ` ` `*K*K*KXs:s:s:j8?F?F?FBD^'''''< 4 4 4D>>>8QU\K\K\K\K\K|:::,Y8W[Y8Y8Y8Y8Y8vTX=h=h=h=h=h~)))" ) ) )$&&&&&@<>,,,,,,A"A"A"F*<<<&***XG8G8G8RD<D<Drs_  #"""""J)J)J)J)J)J)J)J)J)J)r: