sj5 $UdZddlmZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddlZ ddlZddlmZddlmZddlmZmZmZmZerddlmZddlmZdd lmZmZdd l m!Z!m"Z"ej#e$Z%d eZ&d Z'e'd Z(dZ)gdZ*gdZ+ddddZ,ddZ-gdZ.de/d<da0de/d<gdZ1de/d <da2de/d!<dd$Z3gd%Z4d#e/d&<gd'Z5d#e/d(<d)Z6dd+Z7dd,Z8dd-Z9dd.Z:id/d0gd1gd2d3gd4d5gd6d7e3d8e:d9d9gd:gd;dgd?d@e:dAgdBdCgdDdEgdFdGdHdIgdJgdKdLgdMidNgdOdPgdMdQgdRdSdTdUgdVgdWdXdYgdZgd[d\gd]d^gd_d`gdadbgdcddgdedfgdgdhgdidjgdkdlgdmdnggdogdpdqZ;dre/ds<dte1De;du<ddzZ<dd}Z=ddZ> dddddZ? dddddZ@dZAde/d<daBde/d<ddddZCdZDdZEde/d<iZFde/d<ddZGddZHddZI dddddZJddZKddZLdddddddZMGddeZNgeNd1ddeNdddeNdddeNd/ddeNdddeNdddeNdQddeNd7ddeNd5dd¦eNdfddĦeNd8ddƦeNdVddȦeNdXddʦeNdAdd̦eNd:ddΦeNd9ddЦeNdjddҦeNdddݦeNdCddߦeNdEddeNdGddeNdLddeNdNddeNdPddeNdddeNdZddeNd\ddeNddddeNd^ddeNdbddeNdlddeNdnddeNduddeNdddZOde/d<deODZP ddlQmRZSeSD]qZTeTjUePvr eTjVdvreTjWpeTjUZXeTjYpeXdZZeO[eNeTjUeXeZeP\eTjUrn #e]$rYnwxYwdeODZ^de^d<d d dCdEgfdd gd fd dd@d8gfdddd$d>d%d>d&d>d'd:d(d:d)d:d*d:d+d9d,d9d-d<d.d<d/d<d0dՓd1dՓd2dՓd3dՓid4dCdJdCd5dEd6dEd7dGd8dGd9dZd:dZd;d\ddd?d@dAd@dBd@dCdPdDdPidEdNdFdNdGdNdHdQdIdQdJdSdKd^dLd^dMdbdNdbdOd`dPd`dQdudRdudSdudTdddUddidVdddWdfdXdfdYdfdZdfd[dd\djd]djd^djd_dd`ddadVdbdVdcdXdddXdedXdfdXidgdldhdldidldjdldkd@dld8d8d8dmd8dnd8dod@dpd@dqdAdrdAdsdAdtdAdddudddddvZddwZedߐddyZfdߐddzZgehd1dhZid{e/d|<dd}Zjdd~ZkddZlddZmdande/d<daode/d<dZpddZqddZrddZsddZtddZuddZvddZwddZxdZy dddddZzddZ{dddddZ|da}da~ddZddZdade/d<dade/d<dېdZ dddddZddZdddddZdadaddZddZddlmZddlmZddZ dddddZddddZdΐdZddZ dddddZddddZiZde/d<dZiZde/d<ddZddZddÄZddȄZ ddddʜdd΄Z dddddτZdېdЄZdZddӄZddddԄZddddՄZ dddddքZee^eedzddhzZde/d<ddلZddۄZddބZdېd߄ZddZddZddZdېdZddZddddZdZde/d<iZde/d<iZde/d<iZde/d<dZde/d<dZde/d<ddZddZd dZ d d dZ d d dZd dZ d ddZddZddZd ddZddddZÐddZdSdiZŐde/d <dd ZƐddZehhdZehZɐd{e/d<ehd^dbhZʐd{e/d<ddZːddZ̐ddZ͐ddZΐddZϐddZАdZѐd e/d<ddZҐddZӐddZԐdd ZՐdd!Z֐dېd"Zehhd#Zؐd{e/d$<dd%Zِdd'Zڐdd(Zdddd)Zܐd*Zݐd+ZeZߐd,e/d-<e jZd dd.Zdd/Zdd0Zdd2Ze jZdd3Zd d5Zdeݐd6d!d8Zd d"d9Z d#ddd:d$d;Zd%d>Zd?d@d&dBZd'dCZdadDe/dE<dade/dF<dGade/dH<dZ d(d)dIZiadJe/dK<dGade/dL<d*Zd d*dNZd+dOZd,dPZd d-dQZ d.d/dSZ d.d0dTZ d.d1dUZGdVdWeZ d2ddXd3d]Z d(d4d^Z d(d5d_Zd(d6d`Zidadbdcdbdddbdedbdfdgdhdgdidgdjdkdldmdndodpdbdqdodrdsdtdbdudbdvdwdxdyidzd{d|d}d~ddddydyddwdd{dd}ddddddwdxdydd{dd}ddddZ d7d8dZdddd9dZd:dZd;dZdddd9dZdZ d<dZ d=dZ d>dZ dZ dZehdhZddZddZd?dZd>dZd@dZddddAdZ dBdCdZe jdZehhdZd{e/d<dZdZiZde/d<iZde/d<dZddZddddDdZ ddddEdZ! d#dddFdZ"dddGdZ#d dHdZ$ d#ddddZ%d#dIdZ& dBdJdZ'dKdZ(dddLdZ)dddddeݐddMd„Z*d*Z+ddÄZ,ddĄZ-ddŜdNdDŽZ.dOdȄZ/ d7dddPdɄZ0dddddʜdQd˄Z1dS(Ru Canonical model catalogs and lightweight validation helpers. Add, remove, or reorder entries here — both `hermes setup` and `hermes` provider-selection will pick up the change automatically. ) annotationsN)get_close_matches)Path)Any NamedTupleOptional TYPE_CHECKING) TypeGuard __version__)open_credentialed_url url_origin)atomic_json_writebase_url_host_matchesz hermes-cli/zhttps://api.githubcopilot.com/modelszvscode/1.104.1)minimallowmediumhigh)rrr) ssl_contextrequrllib.request.Requesttimeoutfloatc&t|||S)z@Open catalog requests without forwarding headers across origins.)rr)r )rrrs 5/home/agent/.hermes/hermes-agent/hermes_cli/models.py_urlopen_model_catalog_requestr,s g; O O OObase_urlstrc|sdS ddlm}||}|sdSddl}|ddur)|}d|_|j|_|S|d}t|tr7|r5tj |r||Sn#t$rYdSwxYwdS)aBuild an ``ssl.SSLContext`` from a custom provider's TLS settings. Mirrors the httpx/requests TLS resolution so the urllib ``/models`` discovery probe honors a provider's ``ssl_ca_cert`` / ``ssl_verify`` instead of falling back to the process-wide ``SSL_CERT_FILE`` / certifi bundle. Returns None when no per-provider TLS override applies, so the caller keeps urllib's default policy for public/unconfigured endpoints. Nr) get_custom_provider_tls_settings ssl_verifyF ssl_ca_cert)cafile)hermes_cli.configr"sslgetcreate_default_contextcheck_hostname CERT_NONE verify_mode isinstancer ospathisfile Exception)rr"tlsr'ctxcas r_custom_provider_ssl_contextr51s  tFFFFFF..x88 4 77< E ) ),,..C!&C !mCOJ WW] # # b#   92 9"'..*<*< 9--R-88 8 tt 4sCACA C CC)+)anthropic/claude-fable-5)anthropic/claude-opus-5r7)zanthropic/claude-opus-5-fast2x price, higher output speed)anthropic/claude-opus-4.8r7)zanthropic/claude-opus-4.8-fastr9)anthropic/claude-sonnet-5r7anthropic/claude-haiku-4.5r7)openai/gpt-5.6-solr7)openai/gpt-5.6-sol-pror7)openai/gpt-5.6-terrar7)openai/gpt-5.6-terra-pror7)openai/gpt-5.6-lunar7)openai/gpt-5.6-luna-pror7)openai/gpt-5.5r7)openai/gpt-5.5-pror7openai/gpt-5.4-minir7google/gemini-3.1-pro-previewr7)google/gemini-3.7-flashr7) x-ai/grok-4.6r7)deepseek/deepseek-v4-pror7)deepseek/deepseek-v4-pro-0813zdated snapshot of v4-pro)deepseek/deepseek-v4-flashr7)deepseek/deepseek-v4-flash-0731zdated snapshot of v4-flash)qwen/qwen3.8-maxr7)moonshotai/kimi-k3 recommended)minimax/minimax-m3r7) z-ai/glm-5.2default) z-ai/glm-5.1r7)xiaomi/mimo-v2.5-pror7) tencent/hy3r7)stepfun/step-3.7-flashr7)!nvidia/nemotron-3-super-120b-a12br7)zmeta/muse-spark-1.2r7)sakana/fugu-ultrar7)zopenrouter/pareto-codezAauto-routes to cheapest coder meeting openrouter.min_coding_score)zstealth/ox-alphafree)zopenrouter/elephant-alphar\)zz-ai/glm-5.2:freer\)zpoolside/laguna-s-2.1:freer\)zpoolside/laguna-xs-2.1:freer\)z&nvidia/nemotron-3-super-120b-a12b:freer\)z&nvidia/nemotron-3-ultra-550b-a55b:freer\)z"nvidia/nemotron-3.5-lightning:freer\list[tuple[str, str]]OPENROUTER_MODELSzlist[tuple[str, str]] | None_openrouter_catalog_cache))moonshotai/kimi-k2.6rR)zalibaba/qwen3.6-plusr7)z zai/glm-5.1r7)minimax/minimax-m2.7r7)anthropic/claude-sonnet-4.6r7)zanthropic/claude-opus-4.7r7)anthropic/claude-opus-4.6r7r<)openai/gpt-5.4r7rF)zopenai/gpt-5.3-codexr7rH)zgoogle/gemini-3-flashr7)$google/gemini-3.1-flash-lite-previewr7)zxai/grok-4.20-reasoningr7VERCEL_AI_GATEWAY_MODELS_ai_gateway_catalog_cachereturn list[str]cBddlm}m}|t|S)aDerive the openai-codex curated list from codex_models.py. Single source of truth: DEFAULT_CODEX_MODELS + forward-compat synthesis. This keeps the gateway /model picker in sync with the CLI `hermes model` flow without maintaining a separate static list. rDEFAULT_CODEX_MODELS_add_forward_compat_models)hermes_cli.codex_modelsrlrmlistrks r_codex_curated_modelsrps7YXXXXXXX % %d+?&@&@ A AAr)grok-4.6grok-build-0.1grok-4.5zgrok-4.3zgrok-4.20-0309-reasoningzgrok-4.20-0309-non-reasoningzgrok-4.20-multi-agent-0309_XAI_STATIC_FALLBACK)rqrszgrok-composer-2.5-fast_XAI_CURATED_EXTRASrqidscBt|vrtgd|DzS|S)z:Pin the headline xAI model to the top of the curated list.c(g|]}|tk |S_XAI_TOP_MODEL.0ms r z$_xai_promote_top..s""I"I"IQ.5H5H15H5H5Hrrzrvs r_xai_promote_toprs/"I"Ic"I"I"III Jrct|}tD]A}||vr|r|dtkrdnt|}|||B|S)zBAppend Hermes-curated xAI models that are missing from models.dev.r)rorur{leninsert)rvoutextra insert_ats r_xai_merge_curated_extrasrsf s))C$%% C<< GQ>!9!9AAs3xx  9e$$$$ Jrc:tt|SN)rrrs r_xai_finalize_catalogrs 5c:: ; ;;rc ddlm}|}t|tr|dnd}t|tr|dnd}t|tr>|r.s'HHH3:c33G3GH3HHHr) agent.models_devrr-dictr(keysrsortedr1rort)rdatarrrvs r_xai_curated_modelsrs  555555!!!+D$!7!7AdhhuoooT&0d&;&;E""" fd # # : :HH&++--HHHC :,VC[[999       !&:!;!; < <> C  C moarUnous)r6r8r:r;r=r>r?r@rArBrCrDrErGrIrJrKrLrMrNrOrPrQrSrTrVrWrXrYrZr[openai)gpt-5.4 gpt-5.4-mini gpt-5-mini gpt-5.3-codex gpt-5.2-codexgpt-4.1gpt-4o gpt-4o-mini openai-api) gpt-5.6-solzgpt-5.6-sol-pro gpt-5.6-terrazgpt-5.6-terra-pro gpt-5.6-lunazgpt-5.6-luna-progpt-5.5 gpt-5.5-prorr gpt-5.4-nanorrrrr openai-codex xai-oauth copilot-acpcopilot)rrrrrrrrclaude-sonnet-4.6claude-sonnet-5claude-sonnet-4claude-sonnet-4.5claude-haiku-4.5gemini-3.1-pro-previewgemini-3-pro-previewzgemini-3-flash-previewzgemini-2.5-progemini)rrgemini-3.6-flashzgemini-3.1-flash-lite-previewzai)glm-5.2glm-5.1glm-5z glm-5v-turboz glm-5-turboglm-4.7zglm-4.5z glm-4.5-flashrnvidia)z!nvidia/nemotron-3-ultra-550b-a55brZz%nvidia/nemotron-3.5-lightning-30b-a3bz-nvidia/nemotron-3-nano-omni-30b-a3b-reasoningrTr`zminimaxai/minimax-m3z kimi-coding) kimi-k3kimi-k2.7-code kimi-k2.6 kimi-k2.5zkimi-for-codingzkimi-for-coding-highspeedkimi-k2-thinkingzkimi-k2-thinking-turbokimi-k2-turbo-previewkimi-k2-0905-previewzkimi-coding-cn)rrzkimi-k2.7-code-highspeedrrrrrstepfunzstep-3.5-flashzstep-3.5-flash-2603moonshot)rrrrrrminimax) MiniMax-M3 MiniMax-M2.7 MiniMax-M2.5z MiniMax-M2.1z MiniMax-M2 minimax-oauth)rrzMiniMax-M2.7-highspeed minimax-cn anthropic) claude-fable-5rclaude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-4-6zclaude-opus-4-5-20251101zclaude-sonnet-4-5-20250929zclaude-opus-4-20250514zclaude-sonnet-4-20250514zclaude-haiku-4-5-20251001deepseekdeepseek-v4-prodeepseek-v4-flashxiaomi) mimo-v2.5-pro mimo-v2.5 mimo-v2-pro mimo-v2-omniz mimo-v2-flashztencent-tokenhub hy3-previewarcee)ztrinity-large-thinkingztrinity-large-previewz trinity-minigmi)zzai-org/GLM-5.1-FP8deepseek-ai/DeepSeek-V3.2moonshotai/Kimi-K2.5rer;rbrd opencode-zen)@x-preview-f-freerrrrrrrrz gpt-5.4-prorrrrzgpt-5.3-codex-sparkgpt-5.2rzgpt-5.1z gpt-5.1-codexzgpt-5.1-codex-maxzgpt-5.1-codex-minigpt-5z gpt-5-codexz gpt-5-nanorz claude-opus-5rrrrzclaude-opus-4-5rclaude-sonnet-4-5rclaude-haiku-4-5zgemini-3.7-flashrzgemini-3.5-flashzgemini-3.5-flash-litezgemini-3.1-prozgemini-3-flashrqrsrrzmuse-spark-1.2 minimax-m3 minimax-m2.7 minimax-m2.5rrrrrrzdeepseek-v4-flash-free qwen3.6-plus qwen3.5-plus big-picklezmimo-v2.5-freehy3-freelaguna-s-2.1-freenemotron-3-ultra-freenemotron-3.5-lightning-freemuse-spark-1.2-contributor-free opencode-free)rrrrrr opencode-go)rrrrrrszglm-5.3rrrrrrrrrrrrz qwen3.8-max qwen3.7-max qwen3.7-plusrrhy3rzmuse-spark-1.2-contributorz ox-alpha-freekilocode)rcrbrdgoogle/gemini-3-pro-previewgoogle/gemini-3-flash-previewalibaba) rrrrrqwen3-coder-plusqwen3-coder-nextrrralibaba-coding-plan) rrrzqwen3-max-2026-01-23rrrrrr huggingface) rzQwen/Qwen3.5-397B-A17BzQwen/Qwen3.5-35B-A3BrzMiniMaxAI/MiniMax-M2.5z zai-org/GLM-5zXiaomiMiMo/MiMo-V2-Flashzmoonshotai/Kimi-K2-Thinkingzmoonshotai/Kimi-K2.6bedrock) zus.anthropic.claude-sonnet-5zus.anthropic.claude-sonnet-4-6zus.anthropic.claude-opus-4-6-v1z+us.anthropic.claude-haiku-4-5-20251001-v1:0z,us.anthropic.claude-sonnet-4-5-20250929-v1:0zus.amazon.nova-pro-v1:0zus.amazon.nova-lite-v1:0zus.amazon.nova-micro-v1:0z deepseek.v3.2z)us.meta.llama4-maverick-17b-instruct-v1:0z&us.meta.llama4-scout-17b-instruct-v1:0z azure-foundry)rIrzgoogle/gemini-3.6-flashzgoogle/gemini-3.5-flashzgoogle/gemini-3.5-flash-literrezgoogle/gemini-3.1-flash-lite)zmoonshotai/kimi-k2.5raz zai-org/glm-5zdeepseek/deepseek-v3-0324zdeepseek/deepseek-r1-0528zqwen/qwen3-235b-a22b-fp8)vertexnovitazdict[str, list[str]]_PROVIDER_MODELScg|]\}}|Sryryr}r_s rrrs!M!M!M&#q#!M!M!Mr ai-gatewaymodel_idpricingdict[str, dict[str, str]]boolc||}|sdS t|dddko&t|dddkS#ttf$rYdSwxYw)zFReturn True if *model_id* has zero-cost prompt AND completion pricing.Fprompt1r completion)r(r TypeError ValueError)rrps r_is_model_freers HA uQUU8S))**a/XE!%% c:R:R4S4SWX4XX z "uusA A))A>=A> account_infodict[str, Any]c|d}t|trZ|d}t|tr| S|d}t|tr| S|d}t|tsdS|d}|dS t |dkS#t t f$rYdSwxYw) a$Return True if the account info indicates a free (unpaid) tier. Prefer the Portal's explicit ``paid_service_access.allowed`` entitlement decision. Legacy payloads fall back to ``subscription.monthly_charge == 0``. Returns False when both signals are missing or unparseable. paid_service_accessallowed paid_access subscriptionFmonthly_chargeNr)r(r-rr rrr)rrrpaidsubcharges ris_nous_free_tierrs""#899K+t$$//),, gt $ $ ; }-- dD ! ! 8O   > * *C c4 u WW% & &F ~uV}}!! z "uus CC32C3 model_ids free_tiertuple[list[str], list[str]]c|s|gfS|s|gfSg}g}|D]=}t||r||(||>||fS)aSplit Nous models into (selectable, unavailable) based on user tier. For paid-tier users: all models are selectable, none unavailable. For free-tier users: only free models are selectable; paid models are returned as unavailable (shown grayed out in the menu). )rappend)rrr selectable unavailablers rpartition_nous_models_by_tierr%s 2 2JK$$ #w ' ' $   c " " " "   s # # # #  $$rr7F force_refresh curated_idsportal_base_urlr'+tuple[list[str], dict[str, dict[str, str]]]c t||}n.#t$r!t|t|fcYSwxYwt |tr|dnd}t |tr|st|t|fSg}|D](}t |}|r||)|st|t|fSt|} ddd} |D]} | | vrt| | | <t|} t| fd|D} | r| | z} | | fS)uAugment curated list + pricing with the Portal's ``freeRecommendedModels``. The Portal's ``/api/nous/recommended-models`` endpoint advertises which models are free *right now* — independent of what the in-repo ``_PROVIDER_MODELS["nous"]`` list happens to contain or whether the docs-hosted catalog manifest has been rebuilt since the last release. For free-tier users this is the source of truth: any model the Portal flags as free should be selectable, even if the user is running an older Hermes that doesn't ship that model in its hardcoded curated list. This function returns an augmented ``(model_ids, pricing)`` pair where: * Portal free recommendations missing from ``curated_ids`` are appended after the curated list (so the in-repo curated models show first and Portal-only picks follow). * ``pricing`` gets a synthetic ``{"prompt": "0", "completion": "0"}`` entry for any free recommendation missing from the live pricing map, so :func:`partition_nous_models_by_tier` keeps it. Failures (network, parse, missing field) are silent and degrade to returning the inputs unchanged. r&freeRecommendedModelsN0r r cg|]}|v| Sryryr}rseens rrz:union_with_portal_free_recommendations..OBBB#T/////r fetch_nous_recommended_modelsr1rorr-r(_extract_model_namer"set)r(rr)r'payload free_blockportal_free_idsentrynameaugmented_pricingfree_syntheticr augmented_idsnew_onesr1s @r&union_with_portal_free_recommendationsr@s<2/ =    222[!!4==11112:DGT9R9R\4555X\J j$ ' '2z2[!!4==11!#O))"5))  )  " "4 ( ( ( 2[!!4==11W  #377N:: ' ' '%).%9%9 c "%%M }  DCBBBBBBH1%0 , --(AAcj t||}n.#t$r!t|t|fcYSwxYwt |tr|dnd}t |tr|st|t|fSg}|D](}t |}|r||)|st|t|fSt|} t|  fd|D} | r| | z} | t|fS)uFAugment curated list with the Portal's ``paidRecommendedModels``. Mirror of :func:`union_with_portal_free_recommendations` for paid-tier users. The Portal's ``/api/nous/recommended-models`` endpoint advertises which paid models are blessed *right now* — independent of what the in-repo ``_PROVIDER_MODELS["nous"]`` list happens to contain or whether the docs-hosted catalog manifest has been rebuilt since the last release. For paid-tier users this lets newly-launched paid models surface in the picker even if the user is running an older Hermes that doesn't ship them in its hardcoded curated list. This function returns an augmented ``(model_ids, pricing)`` pair where: * Portal paid recommendations missing from ``curated_ids`` are appended after the curated list (so the in-repo curated models show first and Portal-only picks follow). * ``pricing`` is left untouched — we deliberately do NOT synthesize pricing entries for paid models. Live pricing is fetched separately via :func:`get_pricing_for_provider`; if the live endpoint hasn't published pricing yet, the picker shows a blank price column rather than fabricating numbers. (The free helper synthesizes ``$0`` so :func:`partition_nous_models_by_tier` keeps free models selectable; no equivalent gating applies on the paid side, so synthesis would only mislead the user.) Failures (network, parse, missing field) are silent and degrade to returning the inputs unchanged — never block the picker on a Portal-side hiccup. r&paidRecommendedModelsNcg|]}|v| Sryryr0s rrz:union_with_portal_paid_recommendations..r2rr3) r(rr)r'r7 paid_blockportal_paid_idsr:r;r>r?r1s @r&union_with_portal_paid_recommendationsrGVstH2/ =    222[!!4==11112:DGT9R9R\4555X\J j$ ' '2z2[!!4==11!#O))"5))  )  " "4 ( ( ( 2[!!4==11%%M }  DCBBBBBBH1%0 4== ))rAint_FREE_TIER_CACHE_TTLztuple[bool, float] | None_free_tier_cache force_freshrMctj}|s!tt\}}||z tkr|S ddlm}||}|j}||fa|S#t$rd|faYdSwxYw)aCheck if the current Nous Portal user is on a free (unpaid) tier. Results are cached for ``_FREE_TIER_CACHE_TTL`` seconds to avoid hitting the Portal API on every call. The cache is short-lived so that an account upgrade is reflected within a few minutes. Returns True only when entitlement is known to be free. Unknown/error states return False so this compatibility wrapper does not block users. Nr)get_nous_portal_account_inforLF)time monotonicrKrJhermes_cli.nous_accountrO is_free_tierr1)rMnow cached_result cached_atrOrresults rcheck_nous_free_tierrXs .  C !+7#3 y ?1 1 1  HHHHHH33 LLL *"C= !3<uusAA)(A)z/api/nous/recommended-modelsiX_NOUS_RECOMMENDED_CACHE_TTLz'dict[str, tuple[dict[str, Any], float]]_nous_recommended_cache'Path'c.ddlm}|dz dz S)z5Disk path for the persisted recommended-models cache.rget_hermes_homecacheznous_recommended_cache.jsonhermes_constantsr^r]s r_nous_recommended_disk_pathrbs-000000 ?  w &)F FFrbasedict[str, Any] | Nonec ttd5}tj|}dddn #1swxYwYn#ttjf$rYdSwxYwt |tsdS||}t |tsdS|d}t |tr|r|ndS)zReturn the last-known-good payload for ``base`` from disk, or None. The disk file is a JSON object keyed by portal base URL so staging and prod don't collide: ``{"": {"data": {...}, "ts": }}``. utf-8encodingNr) openrbjsonloadOSErrorJSONDecodeErrorr-rr()rcfhblobr:rs r_read_nous_recommended_diskrps -//' B B B !b9R==D ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! T) *tt dD ! !t HHTNNE eT " "t 99V  DdD)) /api/nous/recommended-models``. The endpoint is public — no auth is required. Results are cached per portal URL for ``_NOUS_RECOMMENDED_CACHE_TTL`` seconds in process; pass ``force_refresh=True`` to bypass the in-process cache. A successful live fetch is also persisted to a per-base disk cache (``$HERMES_HOME/cache/nous_recommended_cache.json``) as last-known-good. When the live fetch fails (network, parse, non-2xx) and the in-process cache is empty, the disk copy is returned instead of ``{}`` — so a transient Portal hiccup no longer silently drops the free/paid model recommendations from the picker. Self-heals on the next successful fetch. Returns the parsed JSON dict, or ``{}`` only when neither the network nor any cache layer can supply data. Callers must treat missing/null fields as "no recommendation" and fall back to their own default. https://portal.nousresearch.com/NAcceptapplication/jsonheadersr)rstriprPrQrZr(rYNOUS_RECOMMENDED_MODELS_PATHurllibrequestRequestrrjloadsreaddecoder-rr1rrp) r)rr'rcrTcachedr7rVurlrresprdisks rr4r4s0  @@ H H M MD .  C $ ( ( . .F V/# ?8 8 8N  1/ 1 1C n$$ 12%  ,C A A A 4T:diikk002233D 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4$%% D  )-s %$T4000  't , ,D )-s % %)3KD! Ks6*4D9C# D#C''D*C'+D DDc. ddlm}m}|dpi}t|dpd}|r|dSt|dS#t$rYdSwxYw)zEBest-effort lookup of the Portal base URL the user is authed against.r)DEFAULT_NOUS_PORTAL_URLget_provider_auth_staterr)r7rr)hermes_cli.authrrr r(striprr1)rrstateportals r_resolve_nous_portal_urlrOs 1        ('//52UYY0117R88>>@@  &==%% %*++223777 1110001sA!B$!B BBr:r Optional[str]ct|tsdS|d}t|tr(|r|SdS)zGPull the ``modelName`` field from a recommended-model entry, else None.N modelName)r-rr(r r)r: model_names rr5r5_sf eT " "t;''J*c"""z'7'7'9'9"!!! 4r)visionrr)r'rOptional[bool]c|p t}t||}|sdS|" t}n#t$rd}YnwxYw|rd\}}nd\}}|r|gn||g}|D]*} t || } | r| cS+dS)uReturn the Portal's recommended model name for an auxiliary task. Picks the best field from the Portal's recommended-models payload: * ``vision=True`` → ``paidRecommendedVisionModel`` (paid tier) or ``freeRecommendedVisionModel`` (free tier) * ``vision=False`` → ``paidRecommendedCompactionModel`` or ``freeRecommendedCompactionModel`` When ``free_tier`` is ``None`` (default) the user's tier is auto-detected via :func:`check_nous_free_tier`. Pass an explicit bool to bypass the detection — useful for tests or when the caller already knows the tier. For paid-tier users we prefer the paid recommendation but gracefully fall back to the free recommendation if the Portal returned ``null`` for the paid field (common during the staged rollout of new paid models). Returns ``None`` when every candidate is missing, null, or the fetch fails — callers should fall back to their own default (currently ``google/gemini-3-flash-preview``). r&NF)paidRecommendedVisionModelfreeRecommendedVisionModel)paidRecommendedCompactionModelfreeRecommendedCompactionModel)rr4rXr1r5r() rrr)r'rcr7paid_keyfree_key candidateskeyr;s rget_nous_recommended_aux_modelris8  8688D+D NNNG t ,..II   III  `W((_( )B(x.BJ"7;;s#3#344  KKK  4s8 AAc.eZdZUded<ded<ded<dS) ProviderEntryr sluglabeltui_descN)r __module__ __qualname____annotations__ryrrrrs+ IIIJJJMMMMMrrz Nous PortalzLNous Portal (Everything your agent needs, 300+ models with bundled tool use) fireworksz Fireworks AIz1Fireworks AI (OpenAI-compatible direct model API) openrouter OpenRouterz'OpenRouter (Pay-per-use API aggregator)zMixture of AgentszIMixture of Agents (named presets; aggregator acts after reference models)rNovitaAIz5NovitaAI (Cloud: Model API, Agent Sandbox, GPU Cloud)lmstudioz LM Studioz8LM Studio (Local desktop app with built-in model server) Anthropicz4Anthropic (Claude models via API key or Claude Code)zChatGPT or Codex SubscriptionzTChatGPT or Codex Subscription (Sign in with your ChatGPT account, uses Codex models)z OpenAI APIz$OpenAI API (api.openai.com, API key)z Qwen Cloudz.Qwen Cloud / DashScope (Qwen + multi-provider)%xAI Grok OAuth (SuperGrok / Premium+)z2xAI Grok OAuth (SuperGrok / Premium+ subscription)z Xiaomi MiMoz7Xiaomi MiMo (MiMo-V2.5 and V2 models: pro, omni, flash)zTencent TokenHubz;Tencent TokenHub (Hy3 Preview via tokenhub.tencentmaas.com)z NVIDIA NIMz>NVIDIA NIM (Nemotron models via build.nvidia.com or local NIM)zGitHub Copilotz3GitHub Copilot (Uses GITHUB_TOKEN or gh auth token)zGitHub Copilot ACPz1GitHub Copilot ACP (Spawns copilot --acp --stdio)z Hugging Facez Hugging Face Inference ProviderszGoogle AI Studioz$Google AI Studio (Native Gemini API)rzGoogle Vertex AIzTGoogle Vertex AI (Gemini via GCP; OAuth2 service account or ADC, GCP billing/quotas)DeepSeekz$DeepSeek (V3, R1, coder, direct API)xAIzxAI Grok (Direct API)z Z.AI / GLMzZ.AI / GLM (Zhipu direct API)zKimi / Kimi Coding Planz.Kimi Coding Plan (api.kimi.com & Moonshot API)zKimi / Moonshot (China)z+Kimi / Moonshot China (Domestic direct API)zStepFun Step Planz;StepFun Step Plan (Agent / coding models via Step Plan API)MiniMaxzMiniMax (Global direct API)zMiniMax (OAuth)z9MiniMax via OAuth browser login (Coding Plan, minimax.io)zMiniMax (China)z#MiniMax China (Domestic direct API) ollama-cloudz Ollama Cloudz3Ollama Cloud (Cloud-hosted open models, ollama.com)zArcee AIz%Arcee AI (Trinity models, direct API)z GMI Cloudz"GMI Cloud (Multi-model direct API)z Kilo CodezKilo Code (Kilo Gateway API)z OpenCode Zenz,OpenCode Zen (Curated models, pay-as-you-go)z OpenCode Goz&OpenCode Go (Open models subscription)z AWS Bedrockz;AWS Bedrock (Claude, Nova, Llama, DeepSeek; IAM or API key)z Azure FoundryzRAzure Foundry (OpenAI-style or Anthropic-style endpoint, your Azure AI deployment)zVercel AI Gatewayz*Vercel AI Gateway (Multi-model aggregator) qwen-oauthzQwen OAuth (Portal)z(Qwen OAuth (Reuses local Qwen CLI login)zlist[ProviderEntry]CANONICAL_PROVIDERSch|] }|j Sryrr}rs r rs888qAF888r)list_providers>raws_sdkroauth_externalexternal_processoauth_device_codez (direct API)c(i|]}|j|jSry)rrrs r rsAAAAFAGAAArzCustom endpointcustomzKimi / Moonshotz.Coding Plan, Moonshot global & China endpointsz+Global, OAuth Coding Plan & China endpoints)rrrzxAI Grokz(Direct API or SuperGrok / Premium+ OAuthz Google GeminizGoogle AI Studio (API key)OpenAIz/ChatGPT/Codex subscription or direct OpenAI APIQwenz4Qwen Cloud / DashScope, Coding Plan & Qwen CLI OAuth)rrrOpenCodez0Zen pay-as-you-go, Go subscription, or free tier)rrrz)GitHub token API or copilot --acp process)kimirrgooglerqwenopencoderz%dict[str, tuple[str, str, list[str]]]PROVIDER_GROUPSc,i|]\}\}}}|D]}||Sryry)r}gid_label_descmembersrs rrrsG"""/#/wW^""OSD#""""rdict[str, str]_SLUG_TO_GROUPrctt|pddS)zCReturn the group_id a provider slug belongs to, or "" if ungrouped.r7)rr(r rlowerrs rprovider_group_for_slugrs:   c$*"oo3355;;==r B BBrc  t}i}tD]\}\}}}fd|D}|r|||<g}t} D]&} t| pd} | r| |vr?|| t| d}|s| d| d|| vr| |||| g}t|dkr| d|ddt|\} } }| d|| | t|d(|S) uFold a flat ordered slug iterable into picker rows by provider group. DISPLAY ONLY. Used by every interactive picker (``hermes model``, the setup wizard, the Telegram ``/model`` keyboard) so grouping is identical across surfaces. Each returned row is a dict:: {"kind": "single", "slug": } # ungrouped, or # 1-member group {"kind": "group", "group_id": , "label":