Yjg 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)frozencXeZdZUdZded<ded<ded<ded<ded <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_providersN)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 IC:\Users\server\AppData\Local\hermes\hermes-agent\hermes_cli\inventory.pywith_overrideszConfigContext.with_overrides8sa  6%5B! "  0"/B   6%5B! "&(2wt""r"""d2)r rr rr rrr)__name__ __module__ __qualname____doc____annotations__rrrr r +s  +/'+*. 33333333rr rc ddlm}m}|}|di}t |t r]|d|ddpd}|ddpd}|ddpd}n|rt |nd}d}d}|d }t|||t |t r|ni|| 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)r r r rr)hermes_cli.configr"r#get isinstancerr r )r"r#cfg model_cfgr r r raws rload_picker_contextr1Os ONNNNNNN +--C$$I)T""! ivr1J1JKKQr $==R88>B$==R88>B+4;I  ''+  C )#)(d33;ss88==    rFN) explicit_onlyinclude_unconfigured picker_hintscanonical_orderpricing capabilitiesforce_fresh_nous_tierrefreshprobe_custom_providersprobe_current_custom_provider max_modelsctxr2boolr3r4r5r6r7r8r9r:r;r< int | Nonerc Jddlm} | |j|j|j|j|j|| || |  } 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 rrr8r<r9r:r;Ncg|]=}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|]}|VdSNrG)rIms r z'build_models_payload..s*"P"P17799"P"P"P"P"P"PrmodelsrDr'c@g|]}|v|Sr rR)rIrS user_modelss rrKz(build_models_payload..s+PPP!17799K3O3OA3O3O3Or total_modelscg|]=}t|dddk;|>SrCrFrHs rrKz(build_models_payload..sKxxx1PSTUTYTYZ`bdTeTePfPfPlPlPnPnrwPwPwQPwPwPwrr8)r*r$r()hermes_cli.model_switchrAr r r rr_moa_provider_row_filter_explicit_provider_rowsr_append_unconfigured_rowshermes_cli.providersrN Exceptionsetr,updatelen_apply_picker_hints_reorder_canonical_apply_pricing_apply_capabilities)r=r2r3r4r5r6r7r8r9r:r;r<rArowsmoa_row_is_routing_aggregatorrowrDoriginalfilteredrWs @rbuild_models_payloadrnostEDDDDD ' '--')-35&C   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'rh 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_capabilitiesNrDr'rUT)fast reasoningr7)hermes_cli.modelsrragent.models_devrsr`r,r>supports_reasoning) rhrrrsrkrDcapsr$rumetas rrgrgsJ;:::::&;;;;;;; &&&!%&##wwv$"+-WWX&&,"  EI%1d1%11$>>D'$()@$A$A  %%% $III%55e<<==&DKK #N'##s "B BBrLrMcpddlm}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|]}|dSrDrRrHs r z,_append_unconfigured_rows..?s& , , ,!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) rDr& is_currentrOrUrXsource authenticated auth_typekey_envwarning canonical)rDr&rrOrUrXr)hermes_cli.authr}rvr~rr rGr r striprDr,rapi_key_env_varsappendlabel)rhr=rMr}r~rseencur cur_modelextrasentryr.rrrs rr^r^/sI211111GGGGGGGG , ,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'rDrOrE) rrr r rrGr,r"_raw_config_has_enabled_moa_preset)rhr=r current_slugkeptrkrDs rr]r]us@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_configFrEpresetsr'Tenabled>fanout aggregator max_tokensreference_modelsreference_max_tokensreference_temperatureaggregator_temperaturec3 K|]}|vV dSrQr )rIkeyrEs rrTz5_raw_config_has_enabled_moa_preset..s'11cscz111111r) r+rr`r-rr,itemsr ranyr>)rr0rr&preset legacy_keysrEs @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. rr|rrrrUrOrDrr'rrzpaste z to activatez!run `hermes model` to configure ()rN)rr}r,rr)rhr}rk is_skeletonr.rrs rrdrds8211111   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)r~c$i|] \}}|j|Sr r)rIies r z&_reorder_canonical..s B B B41aQVQ B B Brc30K|]}|dv |VdS)rDNr rIrJorders rrTz%_reorder_canonical..s1//qAfI......//rc |dS)NrDr )rJrs rz$_reorder_canonical..seAfI&r)rc(g|]}|dv |Srr rs rrKz&_reorder_canonical..s' 8 8 8A6%!7!7a!7!7!7r)rvr~ enumeratesorted)rhr~canonrrs @rreres655555 B B9-@#A#A B B BE ////D/// & & & &   E9 8 8 8 8 8 8F 6>rrZcfddlm}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 | | <| 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_tierget_pricing_for_providerpartition_nous_models_by_tierNrDr'rUprompt completioninput_cache_readfree)inputoutputcacherr6nous) force_fresh free_tierT)runavailable_modelsF) rvrrrrr r,rGr`r>r)rhr8rrrrnous_free_tierrkrDrU raw_pricing formattedmidpinp_rawout_raw cache_rawinpoutris_free _selectable unavailables rrfrfs,&*N5/5/37762&&''--//""(b   22488>BKK   KKK   %'   C$$A eeHb))GeeL"--G0"55I5<]]((111C5<]]((111C9BL**9555EVmD)C#)G 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 r2r>r3r>r4r>r5r>r6r>r7r>r8r>r9r>r:r>r;r>r<r?rr)rhrorrp)rhror=r rMr>rro)rhror=r rro)rr>)rhrorro)rhror8r>rrp)r')r r rr)r __future__r dataclassesrrtypingrr r1rnrgr^r]rrdrerfr\r rrrsB#"""""********  $ 3 3 3 3 3 3 3 3FF !&!"'#'*/!TTTTTTn########Z CCCCCCL    F)U)U)U)UX# # # # L0#(U/U/U/U/U/U/pr