`gjAdZddlmZddlZddlZddlmZddlmZddl m Z m Z ddl m Z ejeZed Gd d Zed Gd d Zed GddZed GddZd dZd!dZd"dZ d#dZdd d$dZddd%dZd&dZdZd'dZd(dZd)dZy)*uSurface-agnostic core for the ``/subscription`` TUI screen. Companion to :mod:`agent.billing_view` — same fail-open philosophy: when not logged in or the portal is unreachable, return a struct with ``logged_in=False`` and let the surface degrade gracefully (never crash). Money is decimal end-to-end (server emits decimal strings); we only format for display. The TUI ``SubscriptionOverlay`` drives the plan change in-terminal (V3): it previews the effect, then schedules a downgrade / cancellation / resume (chargeless) or applies an upgrade (charges the card on the subscription). The portal deep-link (built locally from ``portal_url`` + ``org_id``) remains the fallback for an upgrade that needs 3DS / was declined. WS1 dependency: ``GET /api/billing/subscription`` is a NAS endpoint (WS1 Phase A). Until it ships, the fail-open contract handles 404s — the builder returns ``logged_in=False`` and the surface degrades gracefully. ) annotationsN) dataclass)Decimal)AnyOptional) parse_moneyT)frozenceZdZUdZdZded<dZded<dZded<dZded<dZ ded <dZ ded <dZ ded <d Z d ed<dZ ded<y)CurrentSubscriptionaIThe user's active subscription. ``None`` (not this object) = no plan. When present, ``tier_id`` / ``tier_name`` / ``monthly_credits`` / ``cycle_ends_at`` are always set (NAS guarantees a present ``current`` is a fully-populated plan). Only ``credits_remaining`` and the cancel/downgrade fields are optional. N Optional[str]tier_id tier_nameOptional[Decimal]monthly_creditscredits_remaining cycle_ends_atpending_downgrade_tier_namepending_downgrade_atFboolcancel_at_period_endcancellation_effective_at)__name__ __module__ __qualname____doc__r __annotations__rrrrrrrrJ/root/.hermes/venv/lib/python3.12/site-packages/agent/subscription_view.pyr r %sj"G]!#I}#)-O&-+/(/#'M='155*.-.!&$&/3}3rr cleZdZUdZded<ded<dZded<dZd ed <dZd ed <d Zd ed<dZ d ed<y)SubscriptionTieruA selectable plan in the catalog — one row of the in-terminal tier picker. Mirrors NAS's ``SubscriptionTierOption``. ``is_current`` marks the active plan (shown but not selectable); ``is_enabled=False`` is a grandfathered tier the user is on but that can no longer be selected. ``tier_order`` sorts the picker and drives the upgrade-vs-downgrade direction hint. strr namerint tier_orderNrdollars_per_monthrFr is_currentT is_enabled) rrrrrr%r&rr'r(rrrr!r!:sHL IJ+/(/)-O&-JJrr!ceZdZUdZded<dZded<dZded<dZded<dZded <dZ ded <dZ d ed <dZ d ed<dZ ded<y)SubscriptionChangePreviewuParsed ``POST /api/billing/subscription/preview`` — what a change would do. ``effect`` is the disposition the commit would take: - ``charge_now`` → an upgrade; ``amount_due_now_cents`` is the prorated charge. - ``scheduled`` → a downgrade / same-price change at ``effective_at`` (period end). - ``no_op`` → already on the target tier. - ``blocked`` → the commit would be refused; ``reason`` says why. r"effectNr reasoncurrent_tier_idcurrent_tier_nametarget_tier_idtarget_tier_namermonthly_credits_deltaz Optional[int]amount_due_now_cents effective_at) rrrrrr,r-r.r/r0r1r2r3rrrr*r*Msc K FM %)O])'+}+$(NM(&*m*/3,3*.-."&L-&rr*ceZdZUdZded<dZded<dZded<dZded<dZd ed <d Z d ed <dZ ded<dZ ded<dZ ded<dZ ded<eddZeddZy)SubscriptionStateuParsed ``GET /api/billing/subscription`` — the overview screen's data. Fail-open: ``logged_in=False`` (and empty fields) when not logged in or the portal is unreachable. r logged_inNr org_nameorg_idrolezOptional[bool]can_change_plan_rawpersonalr"contextOptional[CurrentSubscription]currentrtuple[SubscriptionTier, ...]tiers portal_urlerrorcB|jxsdjdvS)uDeprecated/display only — a legacy OWNER/ADMIN check. NOT a capability check; use :attr:`can_change_plan` for gating billing plan-change actions. )OWNERADMIN)r9upperselfs ris_adminzSubscriptionState.is_adminws! R&&(,>>>rcJ|j |jS|jS)zDServer capability when supplied; otherwise the legacy role fallback.)r:rJrHs rcan_change_planz!SubscriptionState.can_change_plans&  # # /++ +}}r)returnr)rrrrrr7r8r9r:r<r>r@rArBpropertyrJrLrrrr5r5cs O"Hm" FM D-*..GS-1G *1*,E ', $J $E= ??rr5ct|tsy|jdxs|jd}|syt||jdxs|jdt |jdt |jd|jd|jd|jd t |jd |jd xsd S) NtierIdidtierNamer#monthlyCreditscreditsRemaining cycleEndsAtpendingDowngradeTierNamependingDowngradeAtcancelAtPeriodEndcancellationEffectiveAt) r rrrrrrrr) isinstancedictgetr rrrawr s r_parse_currentr_s c4 ggh03774=G  ''*%8#CGG,<$=>%cgg.@&ABggm,$'GG,F$G WW%9:!#''*=">?"%''*C"D"L  rc|D]}||cSy)zFirst non-``None`` value (preserves a legit ``0``/``0.0``, unlike ``or``). NAS sends ``0`` for the free tier's ``tierOrder`` / ``dollarsPerMonth``; a plain ``x or default`` would drop those, so coalesce on ``None`` specifically. Nr)valsvs r _coalescercs"  =H rct|tsy|jdxs|jd}|syt||jdxsdt t |jddt |jdt |jd t|jd tt |jd d  S)zMMap one NAS ``SubscriptionTierOption`` dict into a :class:`SubscriptionTier`.NrPrQr#rD tierOrderrdollarsPerMonthDisplayrS isCurrent isEnabledTr r#r%r&rr'r()rZr[r\r!r$rcrrr]s r _parse_tierrjs c4 ggh03774=G   WWV_ "y!5q9:%cgg.F&GH#CGG,<$=> ,- #''+"6=> rc|jd}|jd}tt|tr|nd|jdxsd|jd|jd|jd|jd t |jd t|t t fr t |nd|jd xsd S) zVMap a raw ``/subscription/preview`` JSON dict into :class:`SubscriptionChangePreview`.r+amountDueNowCentsblockedr,N currentTierIdcurrentTierName targetTierIdtargetTierNamemonthlyCreditsDelta effectiveAt) r+r,r-r.r/r0r1r2r3)r\r*rZr"rr$float)payloadr+centss r(subscription_change_preview_from_payloadrws[[ "F KK+ ,E $$FC0vi{{8$, O4!++&78{{>2 %56)'++6K*LM+5ec5\+JSZPT[[/74  rrAc |jd}t|tr|ni}|jd}|dvr|nd}|jd}t|trt dd|DDnd}t d |jd |jd xsd |jd t|jdt r|jdnd |t|jd|| S)zRMap a raw ``/api/billing/subscription`` JSON dict into :class:`SubscriptionState`.orgr<)r;teamr;r@c3&K|] }|| ywNr).0ts r z2subscription_state_from_payload..s NA a Nsc32K|]}t|ywr})rj)r~xs rrz2subscription_state_from_payload..s) r6r7r8r9r:r<r>r@rA)r\rZr[listtupler5rr_)rurAraw_orgrz raw_contextr< raw_tiersr@s rsubscription_state_from_payloadrskk% G%/%>'BC++i(K(,@@kjG G$I i &  N<)< NN  wwt}$ WWV_'++o6= KK (w{{956 rg.@timeoutc4t}||S ddlm}m}m}m}m} ||}t|tr|jdnd} | r|| nd} | s |} t|| S#t$rtddcYSwxYw#|$rtdcYS|$r7}tjd d tdt|cYd}~Sd}~wt$r'tjd d tdd cYSwxYw#t$rd} YwxYw)uxFetch + parse ``GET /api/billing/subscription``. Fail-open. Returns ``SubscriptionState(logged_in=False)`` when not logged in. On a portal/HTTP failure, returns ``logged_in=False`` with ``error`` set so the surface can show a clear message rather than crashing. Dev override: when ``HERMES_DEV_SUBSCRIPTION_FIXTURE`` names a fixture state, ``/subscription`` renders from that fixture instead of the real portal — so every plan/cancel/downgrade/team/not-admin state is testable on both the CLI and TUI without a live account. Throwaway scaffolding; see :func:`dev_fixture_subscription_state`. Nr)BillingAuthError BillingError_absolutize_portal_urlget_subscription_stateresolve_portal_base_urlFzbilling client unavailabler6rBrr6u0subscription ▸ /state fetch failed (fail-open)T)exc_infou4subscription ▸ /state unexpected error (fail-open)z!could not load subscription state portalUrlrx)dev_fixture_subscription_statehermes_cli.nous_billingrrrrr Exceptionr5loggerdebugr"rZr[r\r) rfixturerrrrrruexc raw_portalrAs rbuild_subscription_staters(-.G V   ](9.8-F[)DJ7A' 3tJ  02J +7z JJ- V 58TUUV 2 511 B GRV W 5CAA ] KVZ [ 58[\\] J sLA. B D .BB DD!,C D0DD DDc,ddlm}m}m}|jsy ||j}|j r |jsy|jr|d|jind}||j |jd|dfS#t $rYywxYw)uBuild ``{portal_origin}/manage-subscription?org_id=`` from a state. Mirrors the TUI's ``buildManageUrl`` (``subscription.ts``): the deep-link target is NAS's OWN ``/manage-subscription`` page (NOT the Stripe Billing Portal — decided Jun 23), which routes upgrade→Checkout / downgrade→scheduled internally. ``org_id`` pins the page to the right account in multi-org situations. Returns ``None`` when no portal URL is resolvable. r) urlencodeurlsplit urlunsplitNr8rDz/manage-subscription) urllib.parserrrrArschemenetlocr8)staterrrpartsquerys rsubscription_manage_urlr/s=<   ))* <.dsR  &Cuc2 )#.'Oz)   s7:)r)rspecss` r _dev_tiersr\s( E  */   rc &tjdxsdjj}|syt dddt }|dvr t d S|d k(rt d*d dtdd |S|dvr t d*d ttdd |S|dvr7t d*d tddtdtdtdd |S|dvr&t d*d ttdd i|ddiS|dk(r9t d*d tddtdtddd tdd |S|d!k(r#t d*d td d"#tdd |S|d$k(rt d d$dd%d&dt 'St d d(|)S)+uReturn a fixture :class:`SubscriptionState` for ``HERMES_DEV_SUBSCRIPTION_FIXTURE``. Lets every CLI/TUI subscription state be exercised without a live portal: free | mid | top | not-admin | downgrade | cancel | team | logged-out Returns ``None`` when the env var is unset/empty (the real portal path runs). Throwaway scaffolding — mirrors ``HERMES_DEV_CREDITS_FIXTURE``. HERMES_DEV_SUBSCRIPTION_FIXTURErDNzAcme Incorg_acmerE)r7r8r9rA)z logged-out logged_out loggedoutFrrT)r6r>r@)midzmid-tierr)topztop-tierrrr5000)r rrr)z not-adminmemberr9MEMBER downgraderrr1500rz 2026-07-15)r rrrrrcancelr)rrr{zAcme Engineeringorg_eng)r6r<r>r7r8r9rAz)unknown HERMES_DEV_SUBSCRIPTION_FIXTURE: rr) osgetenvstriplowerr[_DEV_FIXTURE_PORTALr5rrr)r#commons rrrrs; II7 8 >B E E G M M OD  :jwSf gF 88 511 v~ `4ZPTEU`Y_`` "" l4zZ`Oalekll ""   GU\]cUdxAGyHIW%     && C4zZ`OaCfBhnfBpvyAfBC C {   GU\]cUdxAGyHflCOPW%     x   dVbcV$     v~ 4Xjs|DKXkl l u6_`d_e4f ggr)r^rrMr=)rarrMr)r^rrMzOptional[SubscriptionTier])rudict[str, Any]rMr*)rurrAr rMr5)rrtrMr5)rr5rMr )rrrMr )rr rMr?)rMzOptional[SubscriptionState]) r __future__rloggingr dataclassesrdecimalrtypingrragent.billing_viewr getLoggerrrr r!r*r5r_rcrjrwrrrrrrrrrrrs$# ! *   8 $ $444( $$ $'''* $!!!R, $ ,=A ,9N26/KdW<@ ',2hr