+ lHjQRt^RIHt^RIHt^RIHtHtHtH t ^RI H t H t H t HtHt^RIHt!RR]4t!RR ] 4t!R R ]4t!R R ]4t]!R]]RR7!RR]4t!RR] 4t!RR]4t!RR]4t!RR] 4t!RR]4t!RR]4t!RR ]4t]!R!]]R"R7!R#R$] 4t!R%R&]4t!R'R(]4t !R)R*]4t!]!R+]]!R,R7!R-R.]4t"!R/R0] 4t#!R1R2]4t$]!R3]"]$R4R7!R5R6]4t%!R7R8]4t&]!R9]%]&R:R7]!R;]]&R]4t'!R?R@]4t(]!RA]'](RBR7!RCRD]4t)!RERF]4t*]!RG])]*RHR7!RIRJ]4t+!RKRL]4t,]!RM]+],RNR7!RORP]4t-!RQRR]4t.]!RS]-].RTR7!RURV]4t/]!RW]/].RXR7!RYRZ]4t0!R[R\]4t1]!R]]0]1R^R7!R_R`] 4t2!RaRb]4t3]!Rc]]3RdR7!ReRf]4t4!RgRh]4t5]!Ri]4]5RjR7!RkRl]4t6!RmRn] 4t7!RoRp]4t8]!Rq]6]8RrR7!RsRt]4t9!RuRv]4t:]!Rw]9]:RxR7!RyRz]4t;]!R{]];R|R7!R}R~]4t<!RR]4t=]!R]<]=RR7!RR] 4t>!RR]4t?!RR]4t@]!R]?]@RR7!RR]4tA!RR]4tB]!R]A]BRR7!RR]4tC!RR]4tD]!R]]DRR7!RR]4tE!RR]4tF!RR]4tG]!R]E]GRR7!RR]4tH!RR]4tI!RR]4tJ]!R]H]JRR7!RR]4tK!RR]4tL!RR]4tM]!R]K]MRR7R#)uContracts: billing / subscription / usage envelopes, delegation controls, handoff, message reactions, pet generation and ``project.facts`` (handlers in ``tui_gateway/methods_session.py``). Billing routes are FAIL-OPEN: a logged-out / unreachable portal answers an ``ok`` result whose ``error`` carries the typed code (``_serialize_billing_error``) — never a JSON-RPC error — so the client always resolves and branches on the envelope. ``BillingEnvelope`` is that shared shape. ) annotations)Field) JsonValueParamsResultWireEnum)MessageReaction OpenModel PlanUsage ProfileParams SessionParams)methodc]tRt^t$RtR]R&RtR]R&RtR]R&RtR]R&Rt R ]R &Rt R ]R &Rt R]R &Rt R]R&Rt R]R&RtR#)BillingEnvelopea ``tui_gateway/billing_view.py::_serialize_billing_error`` on failure (``ok`` false + typed ``error``); success routes add their own fields. ``payload`` is the raw portal body (error extras such as ``remainingUsd``, or the NAS success body on pending-change routes).boolokN str | Noneerrormessage portal_urlzint | float | None retry_afterzdict[str, JsonValue] | Nonepayloadactorcoderecovery)__name__ __module__ __qualname____firstlineno____doc____annotations__rrrrrrrr__static_attributes__rR/home/ubuntu/.hermes/hermes-agent/tui_gateway/contracts/billing_delegation_pets.pyrrsa[ HE:GZ!J !&*K#*+/G (/E:D*Hjr#rc]tRt^'tRtRtRtR#) UsageBarKindplantopuprN)rrrrr'r(r"rr#r$r&r&' D Er#r&c\]tRt^,t$RtR]R&R]R&R]R&R]R&RtR ]R &R ]R &R tR#)UsageBarz\``_serialize_usage_bar``: one bar, magnitudes pre-formatted; ``pct_used`` only for ``plan``.r&kindstrremaining_display total_display spent_displayN int | Nonepct_usedfloat fill_fractionr)rrrrr r!r2r"rr#r$r+r+,s-f Hjr#r+c]tRt^7t$RtRtR]R&R]R&RtR]R&RtR]R &Rt R]R &Rt R]R &Rt R]R &Rt R]R &Rt R]R&RtR]R&RtR]R&RtR]R&RtR#) UsageModelu``_serialize_usage_model`` — also embedded as ``usage`` in the billing / subscription states, where the fail-open form is a bare ``{available: false}`` (no ``ok``).N bool | Nonerr availablerstatus plan_name renews_atrenews_displaysubscription_remaining_displaytopup_remaining_displaytotal_spendable_display has_topupzUsageBar | Noneplan_bar topup_barr)rrrrr rr!r9r:r;r<r=r>r?r@rArBr"rr#r$r6r67sNB OFJ Iz  Iz !%NJ%15"J5*.Z.*.Z.!I{! $Ho$!%I%r#r6z usage.barsz_Two-bar dollar usage view shared by /usage, /topup and /subscription; fail-open to unavailable.)paramsresultdoccR]tRt^Pt$R]R&R]R&R]R&RtR]R&RtR]R&R tR#) BillingCardInfor-brandlast4maskedNrdisplay resolved_viar)rrrrr!rKrLr"rr#r$rGrGPs% J J KGZ#L*#r#rGc"]tRt^XtRtRtRtRtR#)PaymentMethodKindcardlinkunknownrN)rrrrrOrPrQr"rr#r$rNrNXs D DGr#rNcz]tRt^^t$RtR]R&RtR]R&RtR]R&RtR]R&Rt R]R &Rt R]R &Rt R]R &R t R#) BillingPaymentMethodz``_serialize_payment_method``: each kind emits only its own fields (a ``card`` never carries ``email``; ``unknown`` carries what the server called it in ``raw_kind``).rNr,NrrHrIwalletemailraw_kindrLr) rrrrr r!rHrIrTrUrVrLr"rr#r$rSrS^sLR E:E:FJE:Hj#L*#r#rScR]tRt^kt$RtR]R&R]R&RtR]R&R]R&R]R &R tR#) BillingMonthlyCapNr limit_usdr- limit_displayspent_this_month_usdr0ris_default_ceilingr)rrrrrYr!r[r"rr#r$rXrXks) Iz '+*+r#rXc"]tRt^stRtRtRtRtR#)AutoReloadCardKind canonicaldistinctnonerN)rrrrr_r`rar"rr#r$r^r^ssIH Dr#r^cP]tRt^yt$RtR]R&RtR]R&RtR]R&RtR]R&R t R#) BillingAutoReloadCardz6Only ``distinct`` carries the payment-method identity.r^r,Nrpayment_method_idrHrIr) rrrrr r!rdrHrIr"rr#r$rcrcys*@ $(z(E:E:r#rcc`]tRt^t$R]R&RtR]R&R]R&RtR]R&R]R &RtR ]R &R tR#) BillingAutoReloadrenabledNr threshold_usdr-threshold_display reload_to_usdreload_to_displayzBillingAutoReloadCard | NonerOr) rrrrr!rhrjrOr"rr#r$rfrfs2 M $M:$ $M:$)-D &-r#rfc]tRt^t$RtR]R&R]R&RtR]R&RtR]R &RtR]R &Rt R]R &Rt R]R &Rt R ]R&Rt R ]R&Rt R ]R&RtR]R&RtR]R&RtR ]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R&RtR]R &RtR ]R!&RtR]R"&RtR]R#&RtR$]R%&RtR&]R'&R(tR#))BillingStateResultz``_serialize_billing_state`` (money as strings); the ``except`` fallback emits only ``ok / logged_in / free_tier_account / error``, so everything else is optional.rr logged_inFfree_tier_accountNrfree_tier_modelorg_nameorg_slugroler7is_admincan_change_plan can_charge balance_usdbalance_displaycli_billing_enabledlist[str] | Nonecharge_presetscharge_presets_displaymin_usdmax_usdzBillingCardInfo | NonerOzBillingPaymentMethod | Nonepayment_methodzBillingMonthlyCap | None monthly_capzBillingAutoReload | None auto_reloadkeep_going_on_creditsrrUsageModel | NoneusagePlanUsage | None plan_usager)rrrrr r!rorprqrrrsrtrurvrwrxryr{r|r}r~rOrrrrrrrrr"rr#r$rmrmsW HO#t#"&OZ&HjHjD* Hk #'O['"J ""K""&OZ&'++'+N$+/3,3GZGZ#'D '26N/6,0K)0,0K)0*.;-!J !E:#E ##'J 'r#rmz billing.statez`Read-only billing view (no scope); the Nous free tier is answered locally without a portal call.c]tRt^tRtRtRtR#)SubscriptionContextpersonalteamrN)rrrrrrr"rr#r$rrs H Dr#rc]tRt^t$RtR]R&RtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R&Rt R]R &Rt R]R &R ]R &Rt R]R &RtR]R&RtR#)CurrentSubscriptionNrtier_id tier_namemonthly_creditscredits_remaining cycle_ends_atpending_downgrade_tier_namepending_downgrade_atpending_downgrade_displayrcancel_at_period_endcancellation_effective_atcancellation_effective_displayr)rrrrrr!rrrrrrrrrr"rr#r$rrsrGZ Iz "&OZ&$(z( $M:$.22'+*+,0z0,0z015"J5r#rcb]tRt^t$R]R&R]R&R]R&R]R&RtR]R &R ]R &R ]R &R tR#)SubscriptionTierOptionr-rnameint tier_orderdollars_per_month_displayNrrr is_current is_enabledr)rrrrr!rr"rr#r$rrs- L IO"""&OZ&r#rc]tRt^t$RtR]R&R]R&RtR]R&RtR]R&RtR ]R &Rt R ]R &Rt R ]R &Rt R ]R&Rt R]R&Rt R]R&RtR ]R&RtR ]R&RtR]R&RtR]R&RtR#)SubscriptionStateResultz]``_serialize_subscription_state``; the view's fallback emits only ``ok / logged_in / error``.rrrnNr7rtrurrqorg_idrszSubscriptionContext | NonecontextzCurrentSubscription | Nonecurrentz#list[SubscriptionTierOption] | Nonetiersrrrrrrr)rrrrr r!rtrurqrrsrrrrrrrr"rr#r$rrsg HO Hk #'O['HjFJD**.G '.*.G '.15E .5!J !E:#E ##'J 'r#rzsubscription.statezOCurrent plan, tier catalog and usage for the picker; fail-open when logged out.c&]tRt^t$RtR]R&RtR#)SubscriptionPreviewParamsNrsubscription_type_idr)rrrrrr!r"rr#r$rrs '+*+r#rc&]tRt^tRtRtRtRtRtR#)SubscriptionChangeEffect charge_now scheduledno_opblockedrN) rrrrrrrrr"rr#r$rrsJI EGr#rc]tRt^t$RtRtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R &Rt R]R &Rt R]R &Rt R ]R &RtR]R&RtR#)SubscriptionPreviewResultzS``_serialize_subscription_preview`` on success; ``effect`` drives the confirm copy.NzSubscriptionChangeEffect | Noneeffectrreasoncurrent_tier_idcurrent_tier_nametarget_tier_idtarget_tier_namemonthly_credits_deltar1amount_due_now_cents effective_atr)rrrrr rr!rrrrrrrrr"rr#r$rrsd].2F +2FJ"&OZ&$(z(!%NJ%#'j'(,:,'+*+#L*#r#rzsubscription.previewzAChargeless quote of what a plan change would do (billing:manage).c8]tRtRt$RtRtR]R&RtR]R&R tR#) SubscriptionChangeParamsiz]Either a target tier (downgrade / same-price change) or ``cancel`` (period-end cancellation).NrrFrcancelr) rrrrr rr!rr"rr#r$rrsg'+*+FDr#rc]tRtRtRtRtR#)BillingPendingChangeResulti zV``_billing_pending_change``: ``message`` + the raw NAS body in ``payload`` on success.rNrrrrr r"rr#r$rr s`r#rzsubscription.changezFSchedule a downgrade / same-price change or a period-end cancellation.zsubscription.resumezHClear a scheduled downgrade / cancellation (re-enables recurring spend).c4]tRtRt$RtR]R&RtR]R&RtR#)SubscriptionUpgradeParamsiNrridempotency_keyr)rrrrrr!rr"rr#r$rrs'+*+"&OZ&r#rcb]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R &R t R#) SubscriptionUpgradeResultizThe money route: ``status`` separates a completed upgrade from an SCA / decline that must finish in the portal at ``recovery_url``; ``idempotency_key`` is echoed (also on error) so a retry reuses it.Nrr9r recovery_urlrrr) rrrrr r9r!rrrrr"rr#r$rrs<FJ#'j'#L*#FJ"&OZ&r#rzsubscription.upgradez?Prorate, charge and flip the plan (billing:manage, idempotent).c4]tRtRt$RtR]R&RtR]R&RtR#)BillingChargeParamsi/Nfloat | str | None amount_usdrrr)rrrrrr!rr"rr#r$rr/s%)J")"&OZ&r#rc8]tRtRt$RtRtR]R&RtR]R&RtR#)BillingChargeResulti4uR``202 {chargeId}`` — money is not confirmed yet; poll ``billing.charge_status``.Nr charge_idrr) rrrrr rr!rr"rr#r$rr4s\ Iz "&OZ&r#rzbilling.chargez;Start a one-off top-up charge (billing:manage, idempotent).c&]tRtRt$RtR]R&RtR#)BillingChargeStatusParamsi?Nrrr)rrrrrr!r"rr#r$rr?s  Iz r#rcT]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R &R t R#) BillingChargeStatusResultiCzTSingle status read (pending | settled | failed); the caller drives the poll cadence.Nrr9zstr | float | Noner settled_atrr) rrrrr r9r!rrrr"rr#r$rrCs.^FJ%)J")!J !FJr#rzbilling.charge_statuszPoll one charge by id.cB]tRtRt$RtR]R&RtR]R&RtR]R&R tR#) BillingAutoReloadParamsiPFrrgNr threshold top_up_amountr) rrrrrgr!rrr"rr#r$rrPs"GT$(I!((,M%,r#rc]tRtRtRtRtR#)BillingMutationResultiVz.A write with no success payload beyond ``ok``.rNrrr#r$rrVs8r#rzbilling.auto_reloadzQEnable/disable auto top-up with its threshold and reload amount (billing:manage).c&]tRtRt$RtR]R&RtR#)BillingKeepGoingOnCreditsParamsi^FrrgrN)rrrrrgr!r"rr#r$rr^s GTr#rzbilling.keep_going_on_creditszCWindow plans: turn 'Keep going on credits' on/off (billing:manage).c&]tRtRt$RtR]R&RtR#)BillingStepUpParamsifNr session_idr)rrrrrr!r"rr#r$rrfs !J !r#rc*]tRtRt$RtRtR]R&RtR#)BillingStepUpResultijzL``granted`` false when the server downscopes (also on every error envelope).Nr7grantedr)rrrrr rr!r"rr#r$rrjsVG[r#rzbilling.step_upzYRun the billing:manage device flow; the URL/code arrive via billing.step_up.verification.c]tRtRt$RtR]R&RtR]R&RtR]R &RtR]R &Rt R]R &Rt R]R &Rt R ]R&Rt R]R&Rt R]R&RtR]R&RtR#)ActiveSubagentiwuOne live child from ``tools/delegate_tool_registry.py::list_active_subagents`` (the record is extended by the child runner — ``missed_steer`` etc. — so it stays open).r- subagent_idNr parent_idr1depthgoal delegation_idmodel float | None started_atr9 tool_countowner_agent_session_idr)rrrrr r!rrrrrrr9rrr"rr#r$rrwskX Iz E:D* $M:$E:#J #FJ!J !)-J-r#rc@]tRtRt$R]R&R]R&R]R&R]R&R tR #) DelegationStatusResultizlist[ActiveSubagent]activerpausedrmax_spawn_depthmax_concurrent_childrenrNrrrrr!r"rr#r$rrs  L  r#rzdelegation.statusz;Running subagent tree plus the spawn pause flag and limits.c&]tRtRt$RtR]R&RtR#)DelegationPauseParamsiTrrrN)rrrrrr!r"rr#r$rrs FDr#rc"]tRtRt$R]R&RtR#)DelegationPauseResultirrrNrrr#r$rrs Lr#rzdelegation.pausezXBlock/unblock NEW spawns globally (active children keep running); returns the new state.c,]tRtRt$R]R&R]R&RtR#)SubagentSteerParamsir-rtextrNrrr#r$rrs  Ir#rc]tRtRtRtRtRtR#) SteerStatusiqueuedrejectedrN)rrrrrrr"rr#r$rrs FHr#rc:]tRtRt$RtR]R&R]R&R]R&RtR #) SubagentSteerResultiz]``queued`` is not ``delivered``: a child past its final tool batch surfaces ``missed_steer``.rr9r-rrrNrrrrr r!r"rr#r$rrsg  Ir#rzsubagent.steerzFQueue steering text into a live delegated child owned by this session.c"]tRtRt$R]R&RtR#)HandoffRequestParamsir-platformrNrrr#r$rrsMr#rc@]tRtRt$R]R&R]R&R]R&R]R&RtR #) HandoffRequestResultirrr- session_keyr home_namerNrrr#r$rrs LMNr#rzhandoff.requestzVQueue a handoff to a messaging platform's home channel; the gateway watcher claims it.c:]tRtRt$RtR]R&R]R&R]R&RtR#) HandoffStateResultizV``state`` is pending | running | completed | failed, or '' when nothing was requested.r-staterrrNrrr#r$r r s` JM Jr#r z handoff.statez&Poll the handoff row for this session.c&]tRtRt$RtR]R&RtR#)HandoffFailParamsiNrrr)rrrrrr!r"rr#r$r r  E:r#r c0]tRtRt$RtR]R&R]R&RtR#) HandoffFailResultizW``failed`` false when the watcher already claimed the row; ``state`` is what it is now.rfailedr-r rNrrr#r$rrsa L Jr#rz handoff.failzNFail a not-yet-claimed handoff (client poll timeout); CAS against the watcher.c]tRtRtRtRtRtR#)ReactionAuthoriuseragentrN)rrrrrrr"rr#r$rrr)r#rcT]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R ]R &R t R#) MessageReactParamsiz``row_id`` is ``messages.id``; a not-yet-persisted live message names ``newest_role`` instead. ``emoji`` null clears; the same emoji again retracts.Nr1row_idr newest_roleemojizReactionAuthor | Noneauthorr) rrrrr rr!rrrr"rr#r$rrs2=FJ"K"E:$(F !(r#rc,]tRtRt$R]R&R]R&RtR#)MessageReactResultirrzlist[MessageReaction] reactionsrNrrr#r$rrs K$$r#rz message.reactzYSet/clear one author's emoji reaction on a message; returns the row's full reaction list.c&]tRtRt$RtR]R&RtR#)PetCancelParamsiNrtokenr)rrrrr r!r"rr#r$rrr r#rc"]tRtRt$R]R&RtR#)PetCancelResultirrrNrrr#r$r"r"s Hr#r"z pet.cancelz;Stop an in-flight pet generate/hatch by token (idempotent).c:]tRtRt$RtR]R&R]R&R]R&RtR #) PetGenProvideri z>``agent/pet/generate/imagegen.py::list_sprite_providers`` row.r-rlabelrdefaultrNrrr#r$r$r$ sH I J Mr#r$c,]tRtRt$R]R&R]R&RtR#)PetGenerateStatusResultirr8zlist[PetGenProvider] providersrNrrr#r$r(r(s O##r#r(zpet.generate.statusz[Whether pet generation is possible (a reference-capable image backend) and which providers.cb]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R &Rt R]R &R t R#) PetGenerateParamsiz_``prompt`` or a ``referenceImage`` data URL is required (the handler answers 4004 without one).NrpromptreferenceImager1countstyleproviderr) rrrrr r,r!r-r.r/r0r"rr#r$r+r+s7iFJ!%NJ%E:E:Hjr#r+c,]tRtRt$R]R&R]R&RtR#)PetDrafti&rindexr-dataUrirNrrr#r$r2r2&s J Lr#r2c6]tRtRt$R]R&R]R&R]R&RtR #) PetGenerateResulti+rrr-r zlist[PetDraft]draftsrNrrr#r$r6r6+s H J r#r6z pet.generatez^Candidate base looks for a new pet (draft step); drafts also stream via pet.generate.progress.c]tRtRt$R]R&R]R&RtR]R&RtR]R &RtR]R &RtR]R &Rt R]R &Rt R]R &Rt R#)PetHatchParamsi5r-r rNr cancelTokenr1r3 descriptionr,r/r0r) rrrrr!r:r3r;r,r/r0r"rr#r$r9r95sH J I"K"E:"K"FJE:Hjr#r9c]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R&Rt R]R&Rt R ]R &Rt R ]R &Rt R ]R &Rt R ]R&RtR ]R&RtR ]R&RtR]R&RtR]R&RtR#)PetSpritePayloadiCNrslug displayNamemimespritesheetBase64spritesheetRevisionr1frameWframeHframesPerStatezdict[str, int] | None framesByState framesByRowloopMsrscalerz stateRowsr)rrrrr>r!r?r@rArBrCrDrErFrGrHrIrJr"rr#r$r=r=CsD*"K"D*$(z(&**FJFJ!%NJ%+/M(/)-K&-FJE<"&I&r#r=c`]tRtRt$RtR]R&R]R&R]R&]!]R7tR ]R &R ]R &R t R#)PetHatchResultiSz]The hatched pet is installed but NOT active (``pet.select`` adopts, ``pet.remove`` discards).rrr-r>r?)default_factoryzlist[JsonValue]warningsr=petrN) rrrrr r!rlistrNr"rr#r$rLrLSs*g H I %d ;Ho; r#rLz pet.hatchzWTurn a base draft into a full spritesheet pet; progress streams via pet.hatch.progress.c&]tRtRt$RtR]R&RtR#)ProjectFactsParamsidNrcwdr)rrrrrSr!r"rr#r$rRrRds Cr#rRcN]tRtRt$RtR]R&R]R&R]R&R]R&R]R &R tR #) ProjectFactsihu```agent/coding_context.py::project_facts_for`` — the system prompt's coding-context detection.r-rootz list[str] manifestspackageManagersverifyCommands contextFilesrNrrr#r$rUrUhs"j Ir#rUc*]tRtRt$RtRtR]R&RtR#)ProjectFactsResultirz>``facts`` null outside a workspace (or when detection failed).NzProjectFacts | Nonefactsr)rrrrr r]r!r"rr#r$r\r\rsH!%E %r#r\z project.factszGStructured project facts for a cwd so UIs don't re-sniff the workspace.N)Nr __future__rpydanticrbaserrrrcommonrr r r r registryr rr&r+r6rGrNrSrXr^rcrfrmrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r rrrrrr"r$r(r+r2r6r9r=rLrRrUr\rr#r$rcs#55WW  f  &8 v&&$|M* ln$f$ $6 $ F.. ( (F}5G mo( 6& 6V(f(&M:Q \^, ,x $ $&?Ha NP}aa%=F` SU];U UW' ' ' '&?Ha LN'-' '/' 3R ce}5G 35 ~/8I []X ))%% 1:L fhm f |OO HJV$f$ ];R hj  v  ~/8I km ]  'v ' V{>. df6&& 1:L TVr#