+ lHjtFRt^RIHt^RIHt^RIHt^RIHtH t H t H t ^RI H t HtHtHtHt^RIHt!RR]4t!R R ]4t!R R ] 4t]!R ]]RR7!RR]4t!RR] 4t]!R]]RR7!RR] 4t]!R]]RR7!RR]4t!RR] 4t]!R]]RR7!R R!] 4t!R"R#] 4t]!R$]]R%R7!R&R']4t!R(R)] 4t]!R*]]R+R7!R,R-]4t !R.R/] 4t!]!R0] ]!R1R7!R2R3] 4t"]!R4]]"R5R7!R6R7] 4t#]!R8]]#R9R7!R:R;]4t$!R<R=] 4t%]!R>]$]%R?R7!R@RA] 4t&]!RB]]&RCR7!RDRE]4t']!RF]']&RGR7!RHRI]4t(!RJRK] 4t)]!RL](])RMR7!RNRO]4t*!RPRQ] 4t+]!RR]*]+RSR7!RTRU]4t,!RVRW] 4t-]!RX],]-RYR7!RZR[]4t.]!R\].] R]R7!R^R_]4t/]!R`]/] RaR7!RbRc]4t0]!Rd]0] ReR7!RfRg]4t1]!Rh]1] RiR7!RjRk] 4t2!RlRm] 4t3!RnRo]4t4!RpRq] 4t5]!Rr]4]5RsR7!RtRu]4t6!RvRw] 4t7!RxRy] 4t8!RzR{] 4t9!R|R}] 4t:!R~R] 4t;!RR] 4t<!RR]4t=!RR] 4t>]!R]6]>RR7!RR] 4t?!RR] 4t@]!R]?]@RR7!RR] 4tA!RR] 4tB!RR] 4tC!RR] 4tD!RR] 4tE!RR] 4tF!RR] 4tG!RR] 4tH!RR]4tI!RR] 4tJ]!R]I]JRR7!RR] 4tK!RR] 4tL!RR]4tM!RR] 4tN!RR] 4tO]!R]M]ORR7!RR]4tP!RR]4tQ!RR] 4tR!RR] 4tS]!R]P]SRR7R#)a Contracts: config, setup readiness, free tier, model inventory, connectors, diagnostics, image generation and structured session control. Handlers: ``tui_gateway/methods_config.py`` (``config.get``, ``setup.*``, ``diagnostics.share_nous``), ``methods_config_set.py`` (``config.set``), ``methods_free_tier.py``, ``methods_shared_metrics.py``, ``methods_complete.py`` (``model.options``), ``methods_connectors.py``, ``methods_images.py``, ``methods_session_control.py`` and ``methods_session.py`` (``verification.status``). ) annotations)Literal)Field) JsonValueParamsResultWireEnum)OkResult OpenModel PlanUsage ProfileParamsSessionLiveInfo)methodcB]tRt^t$RtR]R&RtR]R&RtR]R&RtR#) ConfigGetParamsz``key`` selects one getter from ``_CONFIG_GETTERS``; ``cwd`` feeds the ``project`` getter, ``session_id`` lets ``reasoning`` / ``fast`` answer with the session's live pin.strkeyN str | Nonecwd session_id) __name__ __module__ __qualname____firstlineno____doc____annotations__rr__static_attributes__rS/home/ubuntu/.hermes/hermes-agent/tui_gateway/contracts/config_free_tier_control.pyrrs#X HC!J !rrcZ]tRt^!t$RtR]R&R]R&]!]R7tR]R&Rt R ]R &R t R #) ConfigProviderRefz7``hermes_cli/models.py::list_available_providers`` row.ridlabeldefault_factory list[str]aliasesFbool authenticatedrN) rrrrrrrlistr'r)rrrrr!r!!s(A G Jt4GY4M4rr!c]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]R&RtR]R&RtR]R&RtR]R&RtR#)ConfigGetResultaUnion of every getter's payload: ``value`` for the simple words, ``config`` for ``full``, ``mtime`` / ``mcp_rev`` for the poller, ``model`` / ``provider`` / ``providers`` for ``provider``, ``home`` / ``display`` for ``profile``, ``cwd`` / ``branch`` for ``project``, ``prompt``.Nrvaluedisplay tool_progressmodelproviderzlist[ConfigProviderRef] | None providershomerbranchzdict[str, JsonValue] | Noneconfigprompt float | Nonemtimemcp_revr)rrrrrr-rr.r/r0r1r2r3rr4r5r6r8r9rrrrr,r,*saE:GZ $M:$E:Hj04I-4D*CFJ*.F '.FJE<GZrr,z config.getz[Read one normalised config value (or the whole effective config) the way the UIs render it.)paramsresultdocc^]tRt^Et$RtR]R&RtR]R&RtR]R &RtR]R &R t R ]R &Rt R#)ConfigSetParamsa ``key`` picks the setter (``_CONFIG_SETTERS``, ``details_mode.
``, display toggles); ``value`` is the raw word/string the setter normalises (falsy non-strings are reported back in the error). ``scope`` applies to ``yolo`` / ``reasoning``; ``confirm_expensive_model`` to ``model``.rrrr-NrrscopeFr(confirm_expensive_modelr) rrrrrrr-rr@rArrrrr>r>Es8l HE9!J !E:$)T)rr>c]tRt^Qt$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#)ConfigSetResulta\``{key, value}`` plus the setter's extras: model switches add ``warning`` / ``confirm_required`` / ``confirm_message`` / ``scope`` / ``deferred``; ``focus`` adds ``tool_progress``; ``cwd`` adds ``cwd`` / ``branch``; ``personality`` adds ``history_reset`` / ``info``; ``yolo`` reports its ``scope``. ``value`` is a bool only for the display toggles.rrNzstr | bool | Noner-rwarning bool | Noneconfirm_requiredconfirm_messager@deferredr/rr4 history_resetzSessionLiveInfo | Noneinfor)rrrrrrr-rDrFrGr@rHr/rr4rIrJrrrrrCrCQsc H#E #GZ$(k("&OZ&E: Hk $M:$CFJ!%M;%#'D 'rrCz config.setzWChange one config key (persisted or session-scoped) and read back the normalised value.c]tRt^lt$RtRtR]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#)SetupStatusResulta``provider_configured`` is the loose answer; the boot record's fields (``ready``, ``free_tier_account``, ``free_tier_route``, ``other_providers``, ``inference_provider``) ride along on the launch profile. An unknown ``profile`` answers ``ok=False`` + ``error``.NrEprovider_configuredreadyfree_tier_accountfree_tier_routeother_providersrinference_providerprofileokerror error_code retryable int | None retry_afterr)rrrrrrMrrNrOrPrQrRrSrTrUrVrWrYrrrrrLrLlsW(,+E;%){)#'O['#'O['%) )GZB E:!J !!I{!"K"rrLz setup.statusz`Loose provider check: is ANY provider auth state discoverable for the (launch or named) profile.c&]tRt^t$RtR]R&RtR#)SetupRuntimeCheckParamsNrr1r)rrrrr1rrrrrr[r[s Hjrr[cz]tRt^t$RtR]R&RtR]R&RtR]R&RtR]R&Rt R]R &Rt R ]R &Rt R]R &R t R#)SetupRuntimeCheckResultz``ok=False`` + ``error`` when the resolved model can't be served; ``free_tier_route`` says the selected route is the welcome host.r(rTNrr1r0sourcerUrErPrSr) rrrrrrr1r0r^rUrPrSrrrrr]r]sJ+ HHjE:FJE:#'O['GZrr]zsetup.runtime_checkz]Strict provider check through the same runtime resolution the agent uses on session creation.cB]tRt^t$RtR]R&RtR]R&RtR]R&RtR#) DiagnosticsShareNousParamsNr error_contextdict[str, str] | None extra_filesrX log_linesr) rrrrrarrcrdrrrrr`r`s! $M:$)-K&- Iz rr`c^]tRt^t$RtR]R&RtR]R&RtR]R&RtR]R&Rt R]R &R t R#) DiagnosticsShareNousResultzXStructured envelope: ``ok=False`` + ``error`` renders inline instead of failing the RPC.r(rTNrview_url upload_id expires_atrUr) rrrrrrrgrhrirUrrrrrfrfs2b HHj Iz !J !E:rrfzdiagnostics.share_nouszJUpload a force-redacted debug bundle to Nous-internal diagnostics storage.c\]tRt^t$RtR]R&R]R&R]R&R]R &R]R &^tR]R &R tR #)FreeTierChallengePayloadz``hermes_cli/anon_challenge.py::BrowserChallenge.as_payload``: the ``free_tier.challenge`` event, and ``free_tier.status``'s ``challenge`` field for a client that connected after it.zLiteral['browser']typerurlr(requiredint expires_inmessageattemptrN)rrrrrrrrrrrrrkrks.c  HNO LGSrrkc]tRt^t$RtR]R&R]R&R]R&R]R&R]R&R]R &R tR ]R &R tR ]R &R tR]R&R t R]R&R t R]R&R t R]R&R t R]R&Rt R #)FreeTierStatusResultz``available`` = an identity exists AND the tier is on; whether inference runs on it is ``setup.runtime_check.free_tier_route``'s question.r( has_guestenabled availablenotice_pendingrr0r#NrrUrVrErWrXrYzFreeTierChallengePayload | None challenge nudge_due_inconnector_nudge_due_inr)rrrrrrrUrVrWrYryrzr{rrrrrtrtsr;O MO J JE:!J !!I{!"K"15I.5 $L*#)-J-rrtzfree_tier.statuszZPure read of the focused profile's free-tier identity state (no network, no side effects).c:]tRt^t$R]R&^tR]R&R]R&RtR#) FreeTierChallengeResultParamsrrmrorrzQLiteral['done', 'failed', 'closed', 'timeout', 'refused', 'error', 'unsupported']outcomerN)rrrrrrrrrrrr}r}s HGS ^^rr}c"]tRt^t$R]R&RtR#)FreeTierChallengeResultr(acceptedrNrrrrrrrrrrrNrrzfree_tier.challenge_resultz]Report a browser window outcome for the matching pending attempt; mint remains authoritative.cd]tRt^t$R]R&R]R&RtR]R&RtR]R&RtR]R &RtR ]R &R t R#) FreeTierProvisionResultr(rurvNrrUrVrErWrXrYr) rrrrrrUrVrWrYrrrrrrs4O ME:!J !!I{!"K"rrzfree_tier.provisionzZExplicit retry of the free-tier identity mint when the boot bootstrap could not create it.c"]tRt^t$R]R&RtR#)FreeTierAckNoticeResultr(ackedrNrrrrrrs Krrzfree_tier.ack_noticezIMark the one-time availability notice as shown on the free-tier identity.c&]tRt^t$RtR]R&RtR#)FreeTierClaimNudgeParamstrialzLiteral['trial', 'connector']kindrN)rrrrrrrrrrrrs *1D '1rrc"]tRtRt$R]R&RtR#)FreeTierClaimNudgeResultir(claimedrNrrrrrrs Mrrzfree_tier.claim_nudgezVClaim the due sign-in offer; true for exactly one caller each time an offer comes due.cH]tRtRt$RtR]R&R]R&R]R&RtR]R&R tR #) SharedMetricsConsentResulti a1The focused profile's ``telemetry.shared_metrics`` opt-ins. ``send`` is never true while ``enabled`` is false; ``decided`` = either key is written in config.yaml (the shipped defaults are not an answer) and it is not a ``reask``: an "off" from before the type-ahead fix, offered once more with the reason.r(rvsenddecidedFreaskrN)rrrrrrrrrrrrr s"" M J ME4rrzshared_metrics.statuszYPure read of the focused profile's shared-metrics opt-ins (collection, upload, answered).cB]tRtRt$RtR]R&RtR]R&RtR]R&RtR #) SharedMetricsSetParamsizY``send`` is ignored unless ``enabled``; ``first_run`` marks the Desktop first-run answer.r(rvFr first_runrN) rrrrrrrrrrrrrrsc MD$Itrrzshared_metrics.setzcWrite both shared-metrics opt-ins at once (send requires collection) and reconcile consent windows.c4]tRtRt$RtR]R&RtR]R&RtR#) SharedMetricsSlashCommandParamsi(z``command`` is the raw typed name (no leading ``/``, no args); the backend canonicalizes it against the published registry. ``session_id`` scopes the count to that session's profile.rcommandNrrr)rrrrrrrrrrrrr(sbL!J !rrc"]tRtRt$R]R&RtR#)SharedMetricsSlashCommandResulti0r(rTrNrrrrrr0 Hrrzshared_metrics.slash_commandz[Count one user-typed slash command (fire-and-forget; a no-op unless shared metrics are on).cB]tRtRt$RtR]R&RtR]R&RtR]R &R tR#) !SharedMetricsStartupLatencyParamsi9a``elapsed_ms`` = the client's own launch (TUI process start / Desktop app start) to ready (TUI gateway ready / Desktop backend attached), measured once per launch by the client. The client names its surface because a Desktop may attach to a URL/cloud backend where ``HERMES_DESKTOP`` is unset; without it the backend falls back to its own client detection. ``launch_id`` is an opaque per-launch token the backend latches on (never recorded), so a reconnect re-sending the same launch counts once while a new launch counts again.float elapsed_msNz'Literal['desktop_attach', 'tui'] | Nonesurfacer launch_idr) rrrrrrrrrrrrrr9s%Y7;G 4; Iz rrc"]tRtRt$R]R&RtR#)!SharedMetricsStartupLatencyResultiFr(rTrNrrrrrrFrrrzshared_metrics.startup_latencyzbRecord one client launch-to-ready latency (fire-and-forget; a no-op unless shared metrics are on).c^]tRtRt$RtR]R&RtR]R&RtR]R&RtR ]R &Rt R ]R &R t R#) SharedMetricsUpdateRunParamsiPaOne Desktop PACKAGED self-update (electron-updater / App Installer / Store). Source-checkout hand-offs run ``hermes update`` and are counted from its receipt, never here. Raw words; the backend buckets them: ``outcome`` success|failed|noop|refused, ``failed_stage`` download|verify|apply|restart, ``mechanism`` the updater strategy kind, ``duration_ms`` wall time, ``from_commit_date`` the updated-from build's commit time (epoch seconds) when known.rr~Nr failed_stage mechanismr7 duration_msfrom_commit_dater) rrrrrrrrrrrrrrrrPs8c L#L*# Iz $K$%)l)rrc"]tRtRt$R]R&RtR#)SharedMetricsUpdateRunResulti^r(rTrNrrrrrr^rrrzshared_metrics.update_runzgCount one Desktop packaged self-update outcome (fire-and-forget; a no-op unless shared metrics are on).c&]tRtRt$RtR]R&RtR#)$SharedMetricsDesktopFeatureUseParamsihu``area`` is a Desktop surface id (``command_palette``, ``terminal_pane``, ``settings_`` …); the backend collapses anything outside its closed set to ``other``.rarearNrrrrrrrrrrrrhsK Irrz"shared_metrics.desktop_feature_usezbCount one Desktop area used today (fire-and-forget; once per area per UTC day; a no-op unless on).c0]tRtRt$RtR]R&R]R&RtR#)"SharedMetricsDesktopFrictionParamsitz``kind`` notice_dismissed|error_toast|renderer_crash|backend_disconnect|slow_frame; ``detail`` a closed code-defined word for that kind (notice id, error category, crash reason, drop reason, frame duration bucket), never message text.rrdetailrNrrrrrrts- I Krrzshared_metrics.desktop_frictionzVCount one Desktop friction event (fire-and-forget; capped per day; a no-op unless on).c0]tRtRt$RtR]R&R]R&RtR#)$SharedMetricsDesktopOnboardingParamsizL``step`` a Desktop first-run step id; ``event`` reached|completed|abandoned.rstepeventrNrrrrrrsV I Jrrz!shared_metrics.desktop_onboardingzfCount one Desktop first-run step transition (fire-and-forget; once per step+event; a no-op unless on).cB]tRtRt$RtR]R&RtR]R&RtR]R &R tR#) !SharedMetricsDesktopDislikeParamsiu7``signal`` quick_close|cancelled|setting_off_default|rage_click|undo|feature_disabled; ``target`` a closed code-defined id for that signal (area, flow, action, undo path, feature toggle); ``setting`` a config key for setting_off_default only (the value is never sent — the backend compares it to the default).rsignalr?targetNrsettingr) rrrrrrrrrrrrrrs" KFCGZrrzshared_metrics.desktop_dislikezaCount one Desktop dislike signal (fire-and-forget; capped per signal per day; a no-op unless on).c>]tRtRt$R]R&^tR]R&^tR]R&RtR #) SharedMetricsDesktopModeDayizLiteral['bots', 'sessions']moder active_msro messages_sentrN)rrrrrrrrrrrrrs %%IuM3rrc6]tRtRt$R]R&R]R&R]R&RtR #) SharedMetricsDesktopActionDayiractionz/Literal['click', 'menu', 'palette', 'shortcut']viarocountrNrrrrrrs K 88 Jrrcl]tRtRt$RtR]R&^tR]R&]!]R7t R]R &]!]R7t R ]R &R t R #)SharedMetricsDesktopDailyParamsizOne finished UTC day of Desktop use, aggregated on the client. ``day`` (YYYY-MM-DD) only latches a resend and is never recorded; the raw counts are bucketed by the backend.rdayro bot_countr$z!list[SharedMetricsDesktopModeDay]modesz#list[SharedMetricsDesktopActionDay]actionsrN) rrrrrrrrr*rrrrrrrrs9S HIs/4T/JE ,J383NG 0Nrrc"]tRtRt$R]R&RtR#)SharedMetricsDesktopDailyResultir(recordedrNrrrrrrrrrzshared_metrics.desktop_dailyzaRecord one finished Desktop day (mode use + button presses); recorded=false keeps it for a retry.cP]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R &R t R#) ModelOptionsParamsiNrrFr( explicit_onlyinclude_unconfiguredrefreshr) rrrrrrrrrrrrrrrs+!J !M4!&$&GTrrcr]tRtRt$RtR]R&R]R&RtR]R&R ]R &RtR ]R &RtR]R &Rt R]R&Rt R#) ModelPricingiu``hermes_cli/inventory.py::_apply_pricing`` — formatted $/Mtok strings (``""`` unknown, ``"free"``); the sale fields are Nous Portal-only.rinputoutputNrcacher(freerXdiscount_percent was_input was_outputr) rrrrrrrrrrrrrrrrsA: J KE: J#'j' Iz !J !rrcL]tRtRt$RtR]R&RtR]R&R]R&RtR ]R &R tR#) ModelCapabilitiesiz1``hermes_cli/inventory.py::_apply_capabilities``.r(fastF ultrafast reasoningNrEcan_disable_reasoningr) rrrrrrrrrrrrrrs$; JItO)-;-rrcB]tRtRt$RtR]R&RtR]R&RtR]R &R tR#) ProviderLimitiu``hermes_cli/inventory.py::_apply_limits`` — ``account``: the whole login is rate-limited until ``resets_at`` (ISO, absent when unknown); ``models``: only these models are, each until its time.zLiteral['account', 'models']r@Nr resets_atrbmodelsr) rrrrrrrrrrrrrrs%i (' Iz $(F !(rrcL]tRtRt$RtR]R&R]R&RtR]R &R tR ]R &R tR#)ProviderUsageWindowiuOne subscription usage window (``agent/account_usage.py::AccountUsageWindow``): e.g. the 5-hour session or the weekly cap, with how much of it is spent and when it rolls over (ISO). ``scope``: ``account`` — exhausting the window exhausts the whole login (Codex session/weekly, so a limited account's resets_at must wait for it); ``model`` — the window caps only one model family (Anthropic Opus/Sonnet weekly) and can never imply the account itself is out of quota.rr#r used_percentNrraccountzLiteral['account', 'model']r@r) rrrrrrrr@rrrrrrs*e J Iz )2E &2rrch]tRtRt$RtR]R&RtR]R&]!]R7t R]R &R ]R &R t R ]R&Rt R #)ProviderUsageAccountiuOne account of a provider's credential pool (``hermes_cli/inventory.py::_pool_usage_accounts``). ``id`` is a stable non-secret account identity (never a key or URL); ``label`` may be empty (UI falls back to a localized "Account N"). ``windows`` is empty while the account's usage is not yet known — state carries the meaning, never a fabricated gauge. ``state``: ``ready`` — live quota below the cap (numeric windows present); ``limited`` — a live credential-wide cooldown or exhausted account-scoped quota windows; ``unknown`` — no live numeric windows (failed/empty fetch, stale snapshot, provider without a usage API); ``unavailable`` — DEAD auth row (kept visible, never a quota row). ``resets_at``: for a limited account, the LATEST of its exhausted account-scoped windows (or a live cooldown when later); ``None`` when unknown (the frontend renders its own advisory, e.g. the earliest limited sibling).rr"r?r#r$list[ProviderUsageWindow]windowsz5Literal['ready', 'limited', 'unknown', 'unavailable']stateNrrr) rrrrrrr#rr*rrrrrrrrs7 & GE3O).t)DG &D @@ Iz rrcF]tRtRt$Rt]!]R7tR]R&Rt R]R&R t R#) ProviderUsagei uU``hermes_cli/inventory.py::_apply_usage`` — the provider's subscription usage, from cache. Multi-entry credential pools carry ``accounts`` (one row per account; the legacy ``windows`` stays EMPTY there — a provider-wide percentage across different logins would be fabricated). Single-account providers keep the legacy ``windows`` gauge.r$rrNz!list[ProviderUsageAccount] | Noneaccountsr) rrrrrrr*rrrrrrrrr s%C */t)DG &D26H/6rrc]tRtRt$RtR]R&R]R&]!]R7tR]R&R t R ]R &R t R ]R &R t R ]R&R t R]R&R t R]R&R tR]R&R tR]R&R tR ]R&R tR]R&R tR]R&R tR]R&R tR]R&R tR]R&R tR ]R&R tR ]R&R tR ]R&R tR ]R &R tR]R!&R tR"]R#&R tR$]R%&R tR&]R'&R tR(]R)&R*tR #)+ModelOptionProviderizOne ``hermes_cli/inventory.py::build_models_payload`` provider row (the union of every field the builder sets; ``pricing_pending`` / ``free_tier_pending`` mark the cached-only path).rslugnamer$r&rNrX total_modelsrE is_currentis_user_definedrr^list[str] | Noner'api_url auth_typer)key_envrDfeatured_modelsz#dict[str, ModelCapabilities] | None capabilitieszdict[str, ModelPricing] | Nonepricingpricing_pending free_tierfree_tier_pending free_tier_rowunavailable_modelszPlanUsage | None plan_usagerb usage_levelszProviderLimit | NonelimitzProviderUsage | Noneusager) rrrrrrrr*rrrrr^r'rrr)rrDrrrrrrrrrr r r rrrrrrs a I Id3FI3#L*#"J "#'O['FJ $G $GZ Iz !%M;%GZGZ(,O%,8]tRtRt$R]R&RtR]R&RtR]R&RtR #) ModelOptionsResulti8zlist[ModelOptionProvider]r2r?rr0r1rN)rrrrrr0r1rrrrr r 8s((E3OHcrr z model.optionsz]Provider/model inventory for the picker, layered over the session's live provider when given.cP]tRtRt$RtR]R&RtR]R&RtR]R&RtR]R &R t R#) ImageGenerateParamsiENrr6 aspect_ratiozJsonValue | NoneproberX max_bytesr) rrrrr6rrrrrrrrrrEs+FJ#L*#"E " Iz rrc^]tRtRt$RtR]R&RtR]R&RtR]R &RtR]R &Rt R]R &R t R#) ImageGenerateResultiLz``probe`` answers ``{available}`` alone; ``image_data`` (data URL) is omitted when the download failed or exceeded ``max_bytes`` so callers fall back to ``image``.r(rwNrEsuccessrimage image_datarUr) rrrrrrrrrrUrrrrrrLs7TOG[E:!J !E:rrzimage.generatezZGenerate an image through the tool's provider dispatcher and hand the renderer a data URL.cb]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R &R t R #) GoalContractSnapshoti^z.``hermes_cli/goals.py::GoalContract.to_dict``.r?rr~ verification constraints boundaries stop_whenrN) rrrrrr~rrrrrrrrrrr^s78GSL#KJIsrrcN]tRtRt$R]R&R]R&R]R&R]R&RtR ]R &R tR#) GoalGateSnapshotihrrrotimeout_seconds max_retriesattemptsNrXlast_exit_coder)rrrrrr#rrrrrrhs" LM!%NJ%rrc:]tRtRt$R]R&R]R&RtR]R&R tR #) WaitBarrierUntilipzLiteral['until']rlruntil_atr?rreasonrNrrrrrr'rrrrr%r%ps OFCrr%c:]tRtRt$R]R&R]R&RtR]R&R tR #) WaitBarrierTargetivzLiteral['session', 'pid']rlz str | intrr?rr'rNr(rrrr*r*vs ## FCrr*c]tRtRt$RtR]R&R]R&R]R&R]R&R ]R &R ]R &R ]R&RtR]R&RtR]R&RtR]R&Rt R]R&Rt R]R&] !RRR7t R]R&Rt R#) GoalSnapshoti|u[``methods_session_control.py::_safe_goal_snapshot`` — the frontend-safe GoalState subset.rtitlestatusro turns_used max_turnsrcontractr&subgoalszlist[GoalGateSnapshot]gatesNr7 created_at updated_atr paused_reason last_verdict last_reasonrl)default discriminatorz+WaitBarrierUntil | WaitBarrierTarget | None wait_barrierr)rrrrrrr4r5r6r7r8rr;rrrrr,r,|spe J KON"" !!#J ##J # $M:$#L*#"K"@Edbh@iL=irr,c]tRtRt$RtR]R&R]R&R]R&R]R&R]R &R ]R &R]R &R ]R &R ]R&R]R&R]R&R]R&R]R&R]R&RtR]R&RtR]R&RtR#) LoopSnapshotiuH``_safe_loop_snapshot`` — persisted LoopState fields, never its route.rr6r.rrinterval_seconds current_delayrotimesuntil max_ticks ticks_firedr4 last_fired_at next_due_atr(awaiting_responsedeferred_by_goalNrr6last_stop_reasonr) rrrrrrr6rHrrrrr=r=shR K K I J JN $M:$#'j'rr=cT]tRtRt$R]R&R]R&R]R&R]R&R]R &R]R &R tR #) HeartbeatSnapshotirr6r.ror>rr4rD fire_countrNrrrrrJrJs# K KOrrJcN]tRtRt$RtR]R&R]R&R]R&R ]R &R ]R &R tR#)SessionControlSnapshotiu``_snapshot_control`` — ``revision`` is a hash of the visible state (``""`` when empty); ``updated_at`` is the newest persisted timestamp (``0`` when none).zGoalSnapshot | NonegoalzLoopSnapshot | NoneloopzHeartbeatSnapshot | None heartbeatrrevisionrr5rNrrrrrMrMs'K  ''MrrMc"]tRtRt$R]R&RtR#)SessionControlReadParamsirrrNrrrrrSrSsOrrSc"]tRtRt$R]R&RtR#)SessionControlReadResultirMcontrolrNrrrrrUrUs ##rrUzsession.control.readzQStable, allowlisted snapshot of one live session's goal / loop / heartbeat state.cJ]tRtRtRtRtRtRtRtRt Rt R t R t R t R tR tRtRtR#)SessionControlActioniz goal.pausez goal.resumez goal.clearz goal.unwaitz loop.pausez loop.resumez loop.stopz subgoal.addzsubgoal.removez subgoal.clearzheartbeat.pausezheartbeat.resumezheartbeat.clearrN)rrrr goal_pause goal_resume goal_clear goal_unwait loop_pause loop_resume loop_stop subgoal_addsubgoal_remove subgoal_clearheartbeat_pauseheartbeat_resumeheartbeat_clearrrrrrXrXsDJKJKJKIK%N#M'O)'OrrXc8]tRtRt$RtRtR]R&RtR]R&RtR#) SessionControlArgsizO``subgoal.add`` reads ``text``; ``subgoal.remove`` reads the 1-based ``index``.NrtextrXindexr) rrrrrrhrrirrrrrgrgsYD*E:rrgc>]tRtRt$RtR]R&R]R&RtR]R&R tR#) SessionControlParamsiz``action`` is validated by the handler (unknown / gate actions answer ``4004``), so it stays a string on the wire; ``SessionControlAction`` lists the accepted set.rrrNzSessionControlArgs | Noneargsr)rrrrrrrlrrrrrkrksLO K&*D #*rrkcN]tRtRt$RtR]R&R]R&R]R&R]R&R]R&R tR #) SessionControlDispatchiu```_dispatch_envelope`` — the command result's user-visible envelope, every key always present.rrlrnoticerqr.rNrrrrrnrns#j     rrnc,]tRtRt$R]R&R]R&RtR#)SessionControlResultirMrVrndispatchrNrrrrrqrqs ##$$rrqzsession.controlzeRun one allowlisted goal / loop / subgoal / heartbeat action and return the exact resulting snapshot.cB]tRtRt$RtR]R&RtR]R&RtR]R&RtR#)VerificationStatusParamsiNrr session_keyrr) rrrrrrrurrrrrrtrts !J !"K"Crrtc]tRtRt$RtRtR]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#)VerificationEvidenceRowizEOne ``verification_events`` row (``agent/verification_evidence.py``).NrXr"rr4rrrootrcanonical_commandrr@r. exit_codeoutput_summaryr)rrrrrr"rr4rrrxrryrr@r.rzr{rrrrrwrws~OB !J !!J !CD*GZ$(z(D*E:FJ Iz !%NJ%rrwc^]tRtRt$RtR]R&RtR]R&RtR]R &RtR]R &Rt R ]R &R t R#)VerificationStatusInfoiz``verification_status()``: ``disabled`` / ``not_applicable`` / ``unverified`` / ``stale`` or the latest event's own status; ``root`` and friends only once a workspace was identified.rr.NzVerificationEvidenceRow | Noneevidencerrxrr changed_pathsr) rrrrrrr~rxrrrrrrr}r}s9] K/3H,3D*!J !&*M#*rr}c"]tRtRt$R]R&RtR#)VerificationStatusResultir}rrNrrrrrrs((rrzverification.statuszQBest known verification evidence for a cwd/session; read-only, never runs checks.N)Tr __future__rtypingrpydanticrbaserrrrcommonr r r r r registryrrr!r,r>rCrLr[r]r`rfrkrtr}rrrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrr%r*r,r=rJrMrSrUrXrgrkrnrqrtrwr}rrrrrs]#55RR "m"  f(|OO hj *m *(f((|OO df##&~m4E mo m  f %G_ ^` (8 ( +=+V%6% !5>R rt} &i&"+V+)v)%=F^ ^`r