.cj~j dZddlmZddlmZmZddlmZedGddZd0d Z d d d d d d d d dd d d d1dZ d2d!Z d d"d3d$Z d4d%Z d5d&Zd2d'Zd6d(Zd d)d7d*Zd8d9d/Zd S):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)frozencfeZdZUdZded<ded<ded<ded<ded <d Zded <d d d d ddZd S) 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 Optional[str]return'ConfigContext'cRi}|r||d<|r||d<|r||d<|r t|fi|n|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 6/home/ice/.hermes/hermes-agent/hermes_cli/inventory.pywith_overrideszConfigContext.with_overrides9sa  6%5B! "  0"/B   6%5B! "&(2wt""r"""d2)r rr rr rrr)__name__ __module__ __qualname____doc____annotations__rrrrr r +s ##### +/'+*. 33333333rr rc |ddlm}m}|}|di}t |t r]|d|ddpd}|ddpd}|ddpd}n|rt |nd}d}d}|d }|d id pg}t|||t |t r|ni||t |tr|ng 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_contextr4Ps\ ONNNNNNN +--C$$I)T""! ivr1J1JKKQr $==R88>B$==R88>B+4;I  ''+  Cww++//0DEEKH )#)(d33;ss88=='1(D'A'AI88r    rFN) explicit_onlyinclude_unconfigured picker_hintscanonical_orderpricing capabilitiesforce_fresh_nous_tierrefreshprobe_custom_providersprobe_current_custom_provider max_modelsctxr5boolr6r7r8r9r:r;r<r=r>r? int | Nonerc Zddlm} | |j|j|j|j|j|| || | |jpg } t|j}||gd| Dz} |r2t| |} t| t| |dz} ddl m }n#t$rd}YnwxYw|t| D]K}|d r4d |d pgDLr| D]}|d r|d d }||s:|d pg}fd|D}t%|t%|kr||d <t%||d<|r*t| dt| |Dz} |rt'| |rt)| } |rt+| ||rt-| | |j|jdS)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>rNcg|]=}t|dddk;|>Sslugr(moar r.lower.0rs r z(build_models_payload..sEWWW!s1553D3D/E/E/K/K/M/MQV/V/VA/V/V/VrT current_only)is_routing_aggregatoris_user_definedc3>K|]}|VdSNrJ)rLms r z'build_models_payload..s*"P"P17799"P"P"P"P"P"PrmodelsrGr(c@g|]}|v|Sr!rU)rLrV user_modelss rrNz(build_models_payload..s+PPP!17799K3O3OA3O3O3Or total_modelscg|]=}t|dddk;|>SrFrIrKs rrNz(build_models_payload..sKxxx1PSTUTYTYZ`bdTeTePfPfPlPlPnPnrwPwPwQPwPwPwrr;)r+r%r))hermes_cli.model_switchrDr r r rrr_moa_provider_row_filter_explicit_provider_rowsr_append_unconfigured_rowshermes_cli.providersrQ Exceptionsetr.updatelen_apply_picker_hints_reorder_canonical_apply_pricing_apply_capabilities)r@r5r6r7r8r9r:r;r<r=r>r?rDrowsmoa_row_is_routing_aggregatorrowrGoriginalfilteredrZs @rbuild_models_payloadrqrstEDDDDD ' '--')-35&C17R   D  455GyWWtWWWW  -dC88 Dzz5 #D    &XXXXXXX &&&!%&) #  Q QCww()) Q"""P"Pswwx7H7H7NB"P"P"PPPP  8 8 877,--wwvr**.-d33778,,2PPPPxPPPx==3x==00$,CM*-h--C'yDzzxx(A$(L(Lxxxx"D!!!(!$''Jt3HIIII"D!!!"(  sB B/.B/rk list[dict]Nonectddlm} ddlm}n#t$rd}YnwxYw|D]}|dpd}i}|dpgD]\}d}|8|r6 |||}|t |j}n#t$rd}YnwxYwt |||d ||<]||d <dS) 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_capabilitiesNrGr(rXT)fast reasoningr:)hermes_cli.modelsruagent.models_devrvrcr.rAsupports_reasoning) rkrurvrnrGcapsr%rxmetas rrjrj sJ;:::::&;;;;;;; &&&!%&##wwv$"+-WWX&&,"  EI%1d1%11$>>D'$()@$A$A  %%% $III%55e<<==&DKK #N'##s "B BBrOrPcpddlm}ddlm}m}d|D}|jpd}t|jpd }g} |D]R} | j |vr|r| j |kr?| j |kr| | j } | r| j nd} | r| j r | j dnd} | dkr| rd| dnd }| | j | | j | jd d |r|gng|rd ndd d | | |d | | j | | j | j| j |kd gdddT| S)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_LABELScBh|]}|dSrGrUrKs r z,_append_unconfigured_rows..Cs& , , ,!AfIOO   , , ,rr(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) rGr' is_currentrRrXr[source authenticated auth_typekey_envwarning canonical)rGr'rrRrXr[r)hermes_cli.authrryrrr rJr r striprGr.rapi_key_env_varsappendlabel)rkr@rPrrrseencur cur_modelextrasentryr0rrrs rrara3sI211111GGGGGGGG , ,t , , ,D   %2 , , . .CC%+,,2244IF$. .  :     % %   EJ,,..#55  :     $ $#'' 33C),; )I0$Q''  ))g)000000  MM!J,00U[II"&',-6>ykkB)2$9AA2%*!*&&        (,,UZEE#j..00C7#( !%    MrcNddlm}t|jpd}g}|D]}t|dd}|sL|dr||w|r||kr|||dkr$tr||||r|||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(rGrRrH) rrr r rrJr.r"_raw_config_has_enabled_moa_preset)rkr@r current_slugkeptrnrGs rr`r`ys@BAAAAAs+1r2288::@@BBLD37762&&''--//5577   77$ % %  KK      DL00 KK     5== 233 ! C    , ,T 2 2  KK    Krc ddlm}|}n#t$rYdSwxYwt|tsdS|dttsdSd}t|trq|D]Z\}}t|pds)t|tsdS|ddrdS[dShd }tfd |Do"tddS) 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_configFrHpresetsr(Tenabled>fanout aggregator max_tokensreference_modelsreference_max_tokensreference_temperatureaggregator_temperaturec3 K|]}|vV dSrTr!)rLkeyrHs rrWz5_raw_config_has_enabled_moa_preset..s'11cscz111111r) r-rrcr/rr.itemsr ranyrA)rr2rr'preset legacy_keysrHs @rrrsz555555o uu c4 u ''%..C c4 uggi  G'4  #MMOO  LD&tzr??((** fd++ ttzz)T** tt uK 1111[111 1 1 Td3779d;S;S6T6TTs  ""c~ddlm}|D]}d|vr|ddko|d }| |d<|r|drT||d}|r|jnd }|r|jr |jdnd }||d <||d <|d kr|rd |dnd|d|d<dS)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. rrrrrrXrRrGrr(rrzpaste z to activatez!run `hermes model` to configure ()rN)rrr.rr)rkrrn is_skeletonr0rrs rrgrgs8211111   c ! !  ggh'';6Pswwx?P?P;P #.O cgg&788  ##CK00%(7CMMi  , C  # #  %K II%%'% +W * * * *AYAAA I+  rcddlm}dt|Dtfd|Dfd}fd|D}||zS)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)rc$i|] \}}|j|Sr!r)rLies r z&_reorder_canonical..s B B B41aQVQ B B Brc30K|]}|dv |VdS)rGNr!rLrMorders rrWz%_reorder_canonical..s1//qAfI......//rc |dS)NrGr!)rMrs rz$_reorder_canonical..seAfI&r)rc(g|]}|dv |Srr!rs rrNz&_reorder_canonical..s' 8 8 8A6%!7!7a!7!7!7r)ryr enumeratesorted)rkrcanonrrs @rrhrhs655555 B B9-@#A#A B B BE ////D/// & & & &   E9 8 8 8 8 8 8F 6>rr]c ,ddlm}m}m}m}m}d}|D]}t |dd} |dpg} | sR || pi} n#t$ri} YnwxYw| svi} | D] } | | }|s|dd}|dd}|d d}|dkr ||nd}|dkr ||nd}|r ||nd}|d ko |d kp|dk}||||d }| d krW|sU||||d }|3|\}}}||d<|dkr|||d<|dkr|||d<|| | <| r| |d<| d kri | ||}t||d<|r$|t| | d\}}||d<ng|d<#t$rd|d<g|d<YwxYwdS)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_tiercompute_sale_discountget_pricing_for_providerpartition_nous_models_by_tierNrGr(rXprompt completioninput_cache_readfree)inputoutputcachernousrodiscount_percent was_input was_outputr9) force_fresh free_tierT)runavailable_modelsF) ryrrrrrr r.rJrcrAr)rkr;rrrrrnous_free_tierrnrGrX raw_pricing formattedmidpinp_rawout_raw cache_rawinpoutris_freersalerwas_prompt_raw was_out_raw _selectable unavailables rriris~,&*NI/I/37762&&''--//""(b   22488>BKK   KKK   %' % #% #C$$A eeHb))GeeL"--G0"55I5<]]((111C5<]]((111C9BL**9555EVmD)C#)G Ev~~g~,,WaeeJ&7&7#DHA$nk0@E,-%++-C-C*..k*#b((.D.D'//l+#IcNN  '&C N 6>> /!)%9%9$9&&&N$(#7#7K !3/L/LV kT000,K1>>>>>"";;==#4#4U#;#;#ArBBcggi,,113344 4'+1r88::eC$KK!"m    ttsA+B!/1B!! B/.B/)rr )r@r r5rAr6rAr7rAr8rAr9rAr:rAr;rAr<rAr=rAr>rAr?rBrr)rkrrrrs)rkrrr@r rPrArrr)rkrrr@r rrr)rrA)rkrrrrr)rkrrr;rArrs)r()r r rr)r __future__r dataclassesrrtypingrr r4rqrjrar`rrgrhrir_r!rrrsB#"""""********  $!3!3!3!3!3!3!3!3HJ !&!"'#'*/!UUUUUUp########Z CCCCCCL    F)U)U)U)UX# # # # L0#(j/j/j/j/j/j/Zr