)jq;dZddlmZddlmZmZddlmZedGddZd$d Z d d d d d d d d d%dZ d&dZ d'dZ d&dZ d(d Zd d!d)d"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 ;/home/wildlama/.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==    rF2)include_unconfigured picker_hintscanonical_orderpricing capabilitiesforce_fresh_nous_tier max_modelsctxr3boolr4r5r6r7r8r9intrc Tddlm}||j|j|j|j|j||} |r t| t| |z} |rt| |rt| } |rt| ||rt| | |j|jdS)uBuild the ``{providers, model, provider}`` shape every consumer needs from a single substrate call. Flags: - ``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. r)list_authenticated_providers)r r r rrr8r9r8)r*r$r() hermes_cli.model_switchr>r r r rrr_append_unconfigured_rows_apply_picker_hints_reorder_canonical_apply_pricing_apply_capabilities) r:r3r4r5r6r7r8r9r>rowss rbuild_models_payloadrGosJEDDDDD ' '--')-3   DADzz5dC@@@"D!!!(!$''Jt3HIIII"D!!!"(  rrF 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_capabilitiesNslugr'modelsT)fast reasoningr7)hermes_cli.modelsrKagent.models_devrL Exceptionr,r;supports_reasoning) rFrKrLrowrMcapsr$rPmetas rrErEsJ;:::::&;;;;;;; &&&!%&##wwv$"+-WWX&&,"  EI%1d1%11$>>D'$()@$A$A  %%% $III%55e<<==&DKK #N'##s "B BBc `ddlm}m}d|D}|jpd}g}|D]y}|j|vr||j||j|j|j|kdgdddz|S)zBBuild skeleton rows for canonical providers missing from ``rows``.r)CANONICAL_PROVIDERS_PROVIDER_LABELScBh|]}|dSrM)lower).0rs r z,_append_unconfigured_rows..s& , , ,!AfIOO   , , ,rr'F canonical)rMr& is_currentis_user_definedrN total_modelssource) rQrYrZr r]rMappendr,label)rFr:rYrZseencurextrasentrys rrArAsGGGGGGGG , ,t , , ,D   %2 , , . .CF$    :     % %   (,,UZEE#j..00C7#( !%    Mrc~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. r)PROVIDER_REGISTRY authenticatedrerarNrcrMapi_keyr' auth_typekey_envzpaste z to activatez!run `hermes model` to configure ()warningN)hermes_cli.authrmr,rpapi_key_env_vars)rFrmrU is_skeletonr.rprqs rrBrBs8211111   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)rYc$i|] \}}|j|Sr r\)r^ies r z&_reorder_canonical..%s B B B41aQVQ B B Brc30K|]}|dv |VdS)rMNr r^r_orders r z%_reorder_canonical..'s1//qAfI......//rc |dS)NrMr )r_r~s rz$_reorder_canonical..(seAfI&r)keyc(g|]}|dv |Sr\r r}s r z&_reorder_canonical..*s' 8 8 8A6%!7!7a!7!7!7r)rQrY enumeratesorted)rFrYcanonrjr~s @rrCrCs655555 B B9-@#A#A B B BE ////D/// & & & &   E9 8 8 8 8 8 8F 6>rr?cfddlm}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_tierNrMr'rNprompt completioninput_cache_readfree)inputoutputcacherr6nous) force_fresh free_tierT)runavailable_modelsF) rQrrrrr r,r]rSr;r)rFr8rrrrnous_free_tierrUrMrN raw_pricing formattedmidpinp_rawout_raw cache_rawinpoutris_free _selectable unavailables rrDrD.s,&*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,K1rsiB#"""""********  $ 3 3 3 3 3 3 3 3FF"'!"'@@@@@@F########R0# # # # L0#(U/U/U/U/U/U/U/U/r