`gjJf dZddlmZddlmZmZddlmZedGddZdd Z d d d d d d d d dd d d dd Z ddZ d d ddZ ddZ ddZddZddZd d ddZd d!dZy )"uProvider/model inventory context — shared substrate for the dashboard ``/api/model/options``, the TUI ``model.options``/``model.save_key`` JSON-RPC handlers, and the interactive picker. Before this module the three call-sites each duplicated: 1. The 17-LOC config-slice that pulls ``model.{default,name,provider,base_url}``, ``providers:``, and ``custom_providers:`` out of ``load_config()``; 2. The call into ``list_authenticated_providers`` with the resulting kwargs; 3. (TUI only) a 45-LOC post-pass that merges authenticated rows with unconfigured ``CANONICAL_PROVIDERS`` rows and emits ``authenticated``/ ``auth_type``/``key_env``/``warning`` hints for the picker UI. Consolidating those three steps into one entry point eliminates two bugs the duplicates were hiding: - The dashboard read ``cfg.get("custom_providers")`` directly, missing the v12+ keyed ``providers:`` form (which the TUI handled via ``get_compatible_custom_providers``). - The TUI's canonical-merge keyed on ``is_user_defined`` to decide ordering. Section 3 of ``list_authenticated_providers`` sets ``is_user_defined=True`` even for canonical slugs that appear in the ``providers:`` config dict, which silently demoted them to the tail of the picker. ``_reorder_canonical`` keys on slug membership instead. Substrate facts (verified May 2026): - ``list_authenticated_providers`` already populates each row's ``models`` from the curated catalog (same source as the picker). Do NOT call ``provider_model_ids()`` per row to "freshen" — that bypasses curation and pulls in non-agentic models (Nous /models returns ~400 IDs including TTS, embeddings, rerankers, image/video generators). ) annotations) dataclassreplace)OptionalT)frozencreZdZUdZded<ded<ded<ded<ded <d Zded <d d d d  dd Zy ) ConfigContextzSnapshot of the model + provider config every inventory caller needs. Built once via ``load_picker_context()``; the TUI overlays live agent state via ``with_overrides()`` before passing through. strcurrent_provider current_modelcurrent_base_urldictuser_providerslistcustom_providersNexcluded_providers)r r r cPi}|r||d<|r||d<|r||d<|r t|fi|S|S)uReturn a copy with truthy overrides applied. Truthy-only because the TUI reads agent attributes that may be empty strings before an agent is spawned — empties must NOT clobber the disk-config values. r r r )r)selfr r r kws G/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/inventory.pywith_overrideszConfigContext.with_overrides9sI %5B! " "/B  %5B! "&(wt"r"2d2)r Optional[str]r rr rreturnz'ConfigContext')__name__ __module__ __qualname____doc____annotations__rrrrr r +sj ## +/'+*. 3(3% 3 ( 3  3rr c ddlm}m}|}|jdi}t |t rS|jd|jddxsd}|jddxsd}|jddxsd}n|r t |nd}d}d}|jd }|jd ijd xsg}t|||t |t r|ni||t |tr| Sg S) uLoad the disk-config snapshot every consumer needs. Replaces the inline 17-LOC config-slice that ``web_server.py`` and ``tui_gateway/server.py`` (×2 sites) used to do. r)get_compatible_custom_providers load_configmodeldefaultnameproviderbase_url providers model_catalogr)r r r rrr) hermes_cli.configr"r#get isinstancerr r r) r"r#cfg model_cfgr r r rawexcludeds rload_picker_contextr3Ps O -C$I)T"! ivr1JKQr $==R8>B$==R8>B+4I  ''+ Cww+//0DEKH )#)(d3s8='1(D'A8   HJ  rFN) explicit_onlyinclude_unconfigured picker_hintscanonical_orderpricing capabilitiesforce_fresh_nous_tierrefreshprobe_custom_providersprobe_current_custom_provider max_modelsc ddlm} | |j|j|j|j |j || || | |jxsg } t|j}|A|g| Dcgc]1}t|jddjdk7s0|3c}z} |r&t| |} t| t| |d z} dd lm}|t%}| D]?}|jd s|j'd |jd xsgDA|r| D]}|jd r|jdd}||s0|jd xsg}|Dcgc]}|j|vs|}}t)|t)|ks||d <t)||d<|rSt| t| |Dcgc]1}t|jddjdk7s0|3c}z} |r t+| |r t-| } |r t/| ||r t1| | |j|jdScc}w#t"$rd}YwxYwcc}wcc}w)u| Build the ``{providers, model, provider}`` shape every consumer needs from a single substrate call. Flags: - ``explicit_only``: keep only providers the user explicitly configured (current provider, providers from config, or providers backed by provider-specific env vars). This hides ambient / auto-seeded credentials from desktop chat pickers. - ``include_unconfigured``: append ``CANONICAL_PROVIDERS`` rows that ``list_authenticated_providers`` didn't emit (TUI uses this to show the full provider universe in the picker). - ``picker_hints``: add ``authenticated``/``auth_type``/``key_env``/ ``warning`` per row (TUI ``ModelPickerDialog`` shape). - ``canonical_order``: reorder canonical-slug rows to ``CANONICAL_PROVIDERS`` declaration order; truly-custom rows go last (TUI display order). - ``pricing``: enrich each row with formatted per-model pricing and, for Nous, ``free_tier``/``unavailable_models`` so the GUI picker can show $/Mtok columns and gate paid models on free accounts — mirroring the ``hermes model`` CLI picker. Adds network calls (pricing fetch + Nous tier check); only set for interactive pickers. - ``capabilities``: add a per-row ``capabilities`` map ``{model: {fast, reasoning}}`` so pickers can gate the model-options controls (fast toggle / reasoning) to what each model actually supports, instead of offering knobs the backend would reject. - ``force_fresh_nous_tier``: bypass the short Nous free-tier cache when selecting Portal-recommended Nous models and applying tier gating. Keep this false for UI picker opens; explicit auth/model flows can opt in when they need freshly-purchased credits to show up immediately. - ``refresh``: bust the per-provider model-id disk cache so every row re-fetches its live catalog. Set only for an explicit user-triggered "refresh models" action; normal picker opens leave it false to stay snappy on the 1h cache. - ``probe_custom_providers``: allow saved custom/provider endpoints to run live ``/models`` discovery while building the payload. GUI picker opens should leave this false unless the user explicitly refreshes; the row can still render its configured model immediately, and slow/offline local endpoints no longer block the dialog. - ``probe_current_custom_provider``: when ``probe_custom_providers`` is false, still live-probe the current custom endpoint. This keeps normal GUI/TUI picker opens fast while making the active custom provider's model list match the classic CLI picker. r)list_authenticated_providers) r r r rrr:r>r;r<r=rNslugr'moaT current_only)is_routing_aggregatoris_user_definedc3<K|]}|jywN)lower).0ms r z'build_models_payload..s"P1779"Psmodels total_modelsr:)r*r$r()hermes_cli.model_switchr@r r r rrr_moa_provider_rowr r-rI_filter_explicit_provider_rowsr_append_unconfigured_rowshermes_cli.providersrE Exceptionsetupdatelen_apply_picker_hints_reorder_canonical_apply_pricing_apply_capabilities)ctxr4r5r6r7r8r9r:r;r<r=r>r@rowsmoa_rowr_is_routing_aggregator user_modelsrowrAoriginalrKfiltereds rbuild_models_payloadrfrstE '----''))--35&C117R D  4 45GytW!s1553D/E/K/K/MQV/VAWW-dC8 Dz5 #D  &X) #  QCww()"""Pswwx7H7NB"PP Q  877,-wwvr*.d3778,2'/P!1779K3OAPPx=3x=0$,CM*-h-C'/ 82Dz(A$(Lx1PSTUTYTYZ`bdTePfPlPlPnrwPwQxxD!!$'t3HID!""(( KX0 &!%&:Q ys671I.)I.I3>JJ#1J J 3 JJcXddlm} ddlm}|D]v}|j dxsd}i}|j dxsgD]@}d}|#|r! |||}|t |j}t |||d ||<B||d <xy#t$rd}YwxYw#t$rd}Y?wxYw) uAttach a ``{model: {fast, reasoning}}`` map to each provider row. `fast` mirrors ``model_supports_fast_mode`` (the same gate the runtime enforces). `reasoning` comes from the models.dev catalog when known and defaults to True otherwise — the effort dial is broadly accepted and a no-op on models that ignore it, whereas hiding it from a capable-but- uncatalogued model is the worse failure. r)model_supports_fast_mode)get_model_capabilitiesNrAr'rMT)fast reasoningr9)hermes_cli.modelsrhagent.models_devrirUr-boolsupports_reasoning) r^rhrircrAcapsr$rkmetas rr\r\ s;&;#wwv$"+-WWX&," EI%1d%1$>D'$()@)@$A 5e<=&DK #N'# &!%&!% $I%s#B B BB B)(B)rCcddlm}ddlm}m}|Dchc]}|dj }}|j xsdj }t|jxsdj} g} |D]n} | jj |vr!|r| jj |k7rA| jj |k(r|j| j} | r | jnd} | r| jr| jdnd}| dk(r|rd|dnd }| j| j|j| j| jd d | r| gng| rd ndd d | ||d  | j| j|j| j| j| jj |k(d gdddq| Scc}w)aBuild fallback rows for canonical providers missing from ``rows``. Most missing canonical providers become empty setup skeletons. The one exception is the *current* configured provider: if config.yaml still points at it but credentials are presently unavailable, keep a visible row carrying the saved model so GUI pickers don't silently snap to some other provider. rPROVIDER_REGISTRY)CANONICAL_PROVIDERS_PROVIDER_LABELSrAr'api_keyz6Configured provider missing usable credentials; paste z- to reactivate. Showing the saved model only.ziConfigured provider is not authenticated; run `hermes model` to reactivate. Showing the saved model only.TFzconfigured-current) rAr& is_currentrFrMrNsource authenticated auth_typekey_envwarning canonical)rAr&ryrFrMrNrz)hermes_cli.authrtrlrurvrIr r r striprAr-r|api_key_env_varsappendlabel)r^r]rDrtrurvr`seencur cur_modelextrasentryr/r|r}r~s rrSrS3s2G'+ ,!AfIOO  ,D ,    %2 , , .CC%%+,224IF$.  ::    %  EJJ,,.#5  ::    $#'' 3C), )IC00$$Q'  )gI R000  MM!JJ,00U[[I"&',-6ykB)2A2%*!*&&     (,,UZZE#jj..0C7#( !%  I. ^ Mg -sG,cddlm}t|jxsdj j }g}|D]}t|j ddj j }|s=|j dr|j|`|r||k(r|j|y|dk(rtr|j|||s|j||S)a'Keep only rows backed by explicit user configuration. ``list_authenticated_providers`` intentionally discovers ambient / auto- seeded credentials (for example GitHub CLI -> Copilot). Desktop chat model pickers want the narrower subset the user explicitly configured for Hermes. r)!is_provider_explicitly_configuredr'rArFrB) rrr r rrIr-r"_raw_config_has_enabled_moa_preset)r^r]r current_slugkeptrcrAs rrRrRysBs++1r288:@@BLD37762&'--/557  77$ % KK   DL0 KK   5= 23 C  ,T 2 KK )* Krc  ddlm}|}t|tsy|j dttsyj d}t|tr]|j D]I\}}t|xsdjs$t|tsy|j ddsIyyhd }tfd |Dxrtj ddS#t$rYywxYw) a~Return True when the user's raw config explicitly enables MoA. ``load_config()`` includes ``DEFAULT_CONFIG["moa"].presets.default`` for everyone. Explicit-only model pickers must not treat that default as a user choice, but they should keep MoA visible once the user has saved at least one enabled preset (or an older flat MoA config) in their own config.yaml. r)read_raw_configFrBpresetsr'Tenabled>fanout aggregator max_tokensreference_modelsreference_max_tokensreference_temperatureaggregator_temperaturec3&K|]}|v ywrHr )rJkeyrBs rrLz5_raw_config_has_enabled_moa_preset..s1cscz1s) r,rrUr.rr-itemsr ranyrn)rr1rr&preset legacy_keysrBs @rrrs5 c4  ''%.C c4 ggi G'4 #MMO LD&tzr?((*fd+zz)T*  K 1[1 1 Td3779d;S6TT; s C66 DDcrddlm}|D]}d|vr|jddk(xr|jd }| |d<|r|jdrJ|j|d}|r |jnd }|r|jr|jdnd }||d <||d <|d k(r|rd |dnd|d|d<y)a0Add ``authenticated``/``auth_type``/``key_env``/``warning`` per row. Mutates ``rows`` in-place. Rows already from ``list_authenticated_providers`` are marked ``authenticated=True``; the unconfigured skeleton rows from ``_append_unconfigured_rows`` get the picker's setup-hint shape. rrsr{rzrrMrFrArwr'r|r}zpaste z to activatez!run `hermes model` to configure ()r~N)rrtr-r|r)r^rtrc is_skeletonr/r|r}s rrYrYs2  c !  ggh';6Pswwx?P;P #.Ocgg&78 ##CK0%(CMMi ,,   #  %K II%'WI\ *4YKqA I+ rcddlm}t|Dcic]\}}|j|c}}t fd|Dfd}|Dcgc] }|dvs |}}||zScc}}wcc}w)uCanonical slugs in ``CANONICAL_PROVIDERS`` declaration order; truly-custom rows last. Keys on slug membership, NOT ``is_user_defined`` — section 3 of ``list_authenticated_providers`` sets ``is_user_defined=True`` on rows from the ``providers:`` config dict even when the slug is canonical. Keying on the flag would silently demote canonical providers configured via the new keyed schema. r)ruc32K|]}|dvs |yw)rANr )rJr`orders rrLz%_reorder_canonical..s/qAfI./s c|dS)NrAr )r`rs rz$_reorder_canonical..seAfI&r)rrA)rlru enumeraterAsorted)r^ruiecanonr`rrs @rrZrZst6#,-@#A B41aQVVQY BE /D/ & E 8A6%!7a 8F 8 6> C 9sA& A,A,rOcddlm}m}m}m}d}|D]9}t |j ddj}|j dxsg} | sE ||xsi} | sUi} | D]} | j | } | s| j dd}| j dd}| j d d}|dk7r||nd}|dk7r||nd}|r||nd}|d k(xr |d k(xs|dk(}||||d | | <| r| |d <|d k(s | ||}t||d<|r|t| | d\}}||d<ng|d<<y#t$ri} YwxYw#t$rd|d<g|d<YewxYw)uEnrich each provider row with per-model pricing + Nous tier gating. Mutates ``rows`` in-place. For every row whose provider supports live pricing (openrouter / nous / novita) adds:: row["pricing"] = {model_id: {"input": "$3.00", "output": "$15.00", "cache": "$0.30" | None, "free": bool}} For Nous additionally adds:: row["free_tier"] = bool # current account is free-tier row["unavailable_models"] = [...] # paid models a free user can't pick Prices are pre-formatted via ``_format_price_per_mtok`` so the GUI just renders strings — identical formatting to the CLI picker. All failures are swallowed (best-effort): a row simply gets no ``pricing`` key. r)_format_price_per_mtokcheck_nous_free_tierget_pricing_for_providerpartition_nous_models_by_tierNrAr'rMprompt completioninput_cache_readfree)inputoutputcacherr8nous) force_fresh free_tierT)runavailable_modelsF) rlrrrrr r-rIrUrnr)r^r:rrrrnous_free_tierrcrArM raw_pricing formattedmidpinp_rawout_raw cache_rawinpoutris_free _selectable unavailables rr[r[s,&*N5/37762&'--/"(b  248>BK %'  C$AeeHb)GeeL"-G0"5I5<](1C5<](1C9B*95EVmD)C#)G IcN & &C N 6> /!)%9$9&N$(#7K !/LV kT0,K1";=#4#4U#;#ArBcggi,1134'+1r88:eC$K!"m   sAB*B BB)rr )r]r r4rnr5rnr6rnr7rnr8rnr9rnr:rnr;rnr<rnr=rnr>z int | Nonerr)r^ list[dict]rNone)r^rr]r rDrnrr)r^rr]r rr)rrn)r^rrr)r^rr:rnrr)r')r r rz dict | None)r __future__r dataclassesrrtypingrr r3rfr\rSrRrrYrZr[rQr rrrstB#*  $!3!3!3HJ !&!"'#'*/!U UU U  U  UUU UU!U$(UU Up##Z C C C C  CL F)UX# L0#(U/ U/ U/ U/pr