PL jw3UdZddlmZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZmZddlmZdeZd Zed Zd Zgd Zgd ZgdZded<daded<gdZded<daded<ddZgdZ ded<dZ!ddZ"ddZ#idgd d!gd"d#ed$e#d%d%gd&gd'd(gd)d*gd+d,gd-d.e#d/gd0d1gd2d3gd4d5d6d7gd8gd4d9gd:d;dgd:d?gd@dAgdBdCgdDdEdFgdGgdHdIgdJdKgdLdMgdNdOgdPdQgdRdSgdTdUgdVdWgdXdYgdZgd[Z$d\ed]<d^eDe$d_<ddeZ%dʐddjZ&ddlZ'ddpZ( ddqdrddvZ) ddqdrddwZ*dxZ+dyedz<da,d{ed|<dd}Z-d~Z.dZ/dyed<iZ0ded< ddqdrddZ1ddZ2ddZ3dqddfdqdddZ4GddeZ5ge5ddde5ddde5dZdde5ddde5d?dde5d#dde5dQdde5d$dde5dCdde5dEdde5d/dde5d&dde5d%dde5dUdde5d(dde5d*dde5dAdde5d.dde5d,dde5d1dde5d3dde5d5dde5d9dde5d;dde5d>ddæe5dddƦe5dGddȦe5dIddʦe5dOdd̦e5dKddΦe5dMddЦe5dWddҦe5dYddԦe5d_ddզe5dddئZ6ded<dۄe6DZ7 ddl8m9Z:e:D]oZ;e;j<e7vr e;j=dvre;j>pe;j<Z?e;j@pe?dޝZAe6Be5e;j<e?eAe7Ce;j<pn #eD$rYnwxYwd߄e6DZEdeEd<idd,dd,dd,dd,dd&dd&dd&dd&dd%dd%dd(dd(dd(dd1d8d1dd3dd3idd5dd5ddGddGddIddIdd>dd>dd;dd;dd;dd?dd?ddAddKddKddMiddMdd_dd_dd_ddOddOd dOd dQd dQd dQd dQdd֓dd*dd*ddUddUddUiddZddZddCddCddEddEddEddEddWddWddWddWd d.d!d$d$d$d"d$d#d$d.d.d/d/d/d/dddddĐd$ ZFdՐd&ZGd֐d'ZHdאd)ZI ddqdrdِd+ZJdqdrdڐd,ZKdǐd-ZLd֐d.ZM ddqdrdِd/ZNdqdrdڐd0ZOiZPd1ed2<dېd4ZQ dܐdݐd:ZR ddqdrdߐd?ZS ddqdrdd@ZTdҐdAZUdBZVddDZWdqdrddEZX ddqdrddFZYeZeE[eZeF[zddhzZ\dGedH<ddJZ]ddMZ^dҐdNZ_dqdrddOZ`ddPZaddSZbechdTZdddWZeddYZfddZZgdd[Zhdd\Zidd]Zjd^Zkd_ed`<ddaZlddbZmddcZndddZoddfZpdҐdgZqechdhZrdiedj<ddlZsdqdrddmZtdddoZuddrZvddtZwdduZx dddwZyiazdxedy<dza{ded{<d|Z|ddd~Z}ddZ~ddZdddZ dddZ dddZ dddZ dddZ dddZdddZidddddddddddddddddddddddddddddddddddddddddddddddd Z dddZdddddZddZd dZdddddZdZd dZd dZd dZdddd dZ d ddZdddZ d ddZd|ZddZddZdqdddZddÄZ ddqdrddĄZddddŜddƄZdS(u 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) __version__z hermes-cli/zhttps://api.githubcopilot.com/modelszvscode/1.104.1)minimallowmediumhigh)r r r)anthropic/claude-opus-4.7anthropic/claude-opus-4.6ranthropic/claude-sonnet-4.6rmoonshotai/kimi-k2.6 recommended)zopenrouter/pareto-codezAauto-routes to cheapest coder meeting openrouter.min_coding_score)qwen/qwen3.6-plusranthropic/claude-haiku-4.5r)openai/gpt-5.5r)openai/gpt-5.5-proropenai/gpt-5.4-minir)openai/gpt-5.4-nanoropenai/gpt-5.3-codexr)xiaomi/mimo-v2.5-pror)tencent/hy3-previewr)z!google/gemini-3-pro-image-previewr)google/gemini-3-flash-previewrgoogle/gemini-3.1-pro-previewr$google/gemini-3.1-flash-lite-previewr)qwen/qwen3.6-35b-a3br)stepfun/step-3.5-flashrminimax/minimax-m2.7r) z-ai/glm-5.1r)zx-ai/grok-4.20r) x-ai/grok-4.3r)!nvidia/nemotron-3-super-120b-a12br)deepseek/deepseek-v4-pror)zopenrouter/elephant-alphafree)zopenrouter/owl-alphar2)ztencent/hy3-preview:freer2)z&nvidia/nemotron-3-super-120b-a12b:freer2)zinclusionai/ring-2.6-1t:freer2list[tuple[str, str]]OPENROUTER_MODELSzlist[tuple[str, str]] | None_openrouter_catalog_cache)r)zalibaba/qwen3.6-plusr)z zai/glm-5.1rr,rrrr)openai/gpt-5.4rrr!r&)zgoogle/gemini-3-flashrr()zxai/grok-4.20-reasoningrVERCEL_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_modelsr=r>listr<s 5/home/kuhnn/.hermes/hermes-agent/hermes_cli/models.py_codex_curated_modelsrBas7YXXXXXXX % %d+?&@&@ A AA)grok-4.3zgrok-4.20-0309-reasoningzgrok-4.20-0309-non-reasoningzgrok-4.20-multi-agent-0309_XAI_STATIC_FALLBACKrDidscBt|vrtgd|DzS|S)z:Pin the headline xAI model to the top of the curated list.c(g|]}|tk |S_XAI_TOP_MODEL.0ms rA z$_xai_promote_top..s""I"I"IQ.5H5H15H5H5HrCrJ)rFs rA_xai_promote_toprPs/"I"Ic"I"I"III JrCc ddlm}|}t|tr|dnd}t|tr|dnd}t|tr>|r.s'HHH3:c33G3GH3HHHrC) agent.models_devrRrVdictgetkeysrPsorted Exceptionr@rE)rRdatarSrTrFs rA_xai_curated_modelsr`s  555555!!!+D$!7!7AdhhuoooT&0d&;&;E""" fd # # 5 5HH&++--HHHC 5's 444       $ % %%sB:B>> C  C nous)rrrrrrrrrr r"r#r$google/gemini-3-pro-previewr%r'r)r*r+r-r.r/r0r1openai)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-codex xai-oauth copilot-acpcopilot)rdrerfrgrhrirjrkclaude-sonnet-4.6claude-sonnet-4claude-sonnet-4.5claude-haiku-4.5gemini-3.1-pro-previewgemini-3-pro-previewgemini-3-flash-previewzgemini-2.5-progemini)rtrurvzgemini-3.1-flash-lite-previewzgoogle-gemini-cli)rtrurvzai)glm-5.1glm-5z glm-5v-turboz glm-5-turboglm-4.7zglm-4.5z glm-4.5-flashrSnvidia) r0znvidia/nemotron-3-nano-30b-a3bz(nvidia/llama-3.3-nemotron-super-49b-v1.5zqwen/qwen3.5-397b-a17bzdeepseek-ai/deepseek-v3.2rzminimaxai/minimax-m2.5z z-ai/glm5zopenai/gpt-oss-120bz kimi-coding) kimi-k2.6 kimi-k2.5zkimi-for-codingkimi-k2-thinkingzkimi-k2-thinking-turbokimi-k2-turbo-previewkimi-k2-0905-previewzkimi-coding-cn)r}r~rrrstepfunzstep-3.5-flashzstep-3.5-flash-2603moonshotminimax) MiniMax-M2.7 MiniMax-M2.5z MiniMax-M2.1z MiniMax-M2z minimax-oauthrzMiniMax-M2.7-highspeed minimax-cn anthropic)zclaude-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-20251001deepseek)zdeepseek-v4-prozdeepseek-v4-flashz deepseek-chatzdeepseek-reasonerxiaomi) mimo-v2.5-pro mimo-v2.5 mimo-v2-pro mimo-v2-omniz mimo-v2-flashztencent-tokenhubz hy3-previewarcee)ztrinity-large-thinkingztrinity-large-previewz trinity-minigmi)zzai-org/GLM-5.1-FP8deepseek-ai/DeepSeek-V3.2moonshotai/Kimi-K2.5r)rr6 opencode-zen)#r~z gpt-5.4-prordrggpt-5.2rhzgpt-5.1z gpt-5.1-codexzgpt-5.1-codex-maxzgpt-5.1-codex-minigpt-5z gpt-5-codexz gpt-5-nanorzclaude-opus-4-5zclaude-opus-4-1rclaude-sonnet-4-5rqclaude-haiku-4-5zclaude-3-5-haikuzgemini-3.1-proz gemini-3-prozgemini-3-flash minimax-m2.7 minimax-m2.5zminimax-m2.5-freez minimax-m2.1rzr{zglm-4.6rzkimi-k2z qwen3-coderz big-pickle opencode-go) r}r~ryrzrrrrrr qwen3.6-plus qwen3.5-pluskilocode)rrr6rbr%alibaba)rr~rqwen3-coder-plusqwen3-coder-nextrzr{rzalibaba-coding-plan)rrrrr~rzr{r 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-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-foundrynovita)zmoonshotai/kimi-k2.5r-z zai-org/glm-5zdeepseek/deepseek-v3-0324zdeepseek/deepseek-r1-0528zqwen/qwen3-235b-a22b-fp8zdict[str, list[str]]_PROVIDER_MODELScg|]\}}|SrIrIrMrX_s rArOrOs!M!M!M&#q#!M!M!MrC ai-gatewaymodel_idrWpricingdict[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[float TypeError ValueError)rrps rA_is_model_freers HA uQUU8S))**a/XE!%% c:R:R4S4SWX4XX z "uusA A))A>=A>r access_tokenportal_base_urldict[str, Any]c|pdd}|d}d|dd} tj||}tj|d 5}t j|cd d d S#1swxYwYd S#t$ricYSwxYw) aFetch the user's Nous Portal account/subscription info. Calls ``/api/oauth/account`` with the OAuth access token. Returns the parsed JSON dict on success, e.g.:: { "subscription": { "plan": "Plus", "tier": 2, "monthly_charge": 20, "credits_remaining": 1686.60, ... }, ... } Returns an empty dict on any failure (network, auth, parse). https://portal.nousresearch.com/z/api/oauth/accountBearer application/json) AuthorizationAcceptheaderstimeoutN) rstripurllibrequestRequesturlopenjsonloadsreaddecoder^)rrbaseurlrreqresps rAfetch_nous_account_tierrs%(  @@ H H M MD  % % %C1<11$Gn$$S'$:: ^ # #C # 3 3 4t:diikk002233 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4  s6AB:(8B- B:-B11B:4B15B:: C C  account_infoc|d}t|tsdS|d}|dS t|dkS#tt f$rYdSwxYw)uReturn True if the account info indicates a free (unpaid) tier. Checks ``subscription.monthly_charge == 0``. Returns False when the field is missing or unparseable (assumes paid — don't block users). subscriptionFmonthly_chargeNr)r[rVrZrrr)rsubcharges rAis_nous_free_tierrs   > * *C c4 u WW% & &F ~uV}}!! z "uusAA/.A/ 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 unavailablerXs rApartition_nous_models_by_tierr&s 2 2JK$$ #w ' ' $   c " " " "   s # # # #  $$rCF force_refresh curated_idsr+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)u_Augment 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 at the front (so the picker shows them first). * ``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. rfreeRecommendedModelsN0rrcg|]}|v| SrIrIrMrXseens rArOz:union_with_portal_free_recommendations..|BBB#T/////rC fetch_nous_recommended_modelsr^r@rZrVr[_extract_model_namerset)rrrrpayload free_blockportal_free_idsentrynameaugmented_pricingfree_syntheticrX augmented_idsnew_onesrs @rA&union_with_portal_free_recommendationsrBs: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)uAugment 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 at the front (so the picker shows them first). * ``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. rpaidRecommendedModelsNcg|]}|v| SrIrIrs rArOz:union_with_portal_paid_recommendations..rrCr) rrrrr paid_blockportal_paid_idsrrrrrs @rA&union_with_portal_paid_recommendationsrstF2/ =    222[!!4==11112:DGT9R9R\4555X\J j$ ' '2z2[!!4==11!#O))"5))  )  " "4 ( ( ( 2[!!4==11%%M }  DCBBBBBBH1 =0 4== ))rint_FREE_TIER_CACHE_TTLztuple[bool, float] | None_free_tier_cachectj}tt\}}||z tkr|S ddlm}m}|d|d}|sd|fadS|dd }|d d }|sd|fadSt||}t|} | |fa| S#t$rd|faYdSwxYw) u_Check 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 False (assume paid) on any error — never blocks paying users. Nr)get_provider_auth_state resolve_nous_runtime_credentials<)min_key_ttl_secondsraFrrr) time monotonicrrhermes_cli.authr r r[rrr^) now cached_result cached_atr r stater portal_urlrresults rAcheck_nous_free_tierrs& .  C##3 y ?1 1 1 ]]]]]]]] )(R@@@@''//  %s| 5yy44 YY0"55   %s| 5.|ZHH "<00"C= !3<uus%B62B6$B66CCz/api/nous/recommended-modelsiX_NOUS_RECOMMENDED_CACHE_TTLz'dict[str, tuple[dict[str, Any], float]]_nous_recommended_cache@rrcl|pdd}tj}t|}|s||\}}||z t kr|S|t } tj |ddi} tj | |5} tj | } dddn #1swxYwYt| t si} n#t"$ri} YnwxYw| |ft|<| S)uFetch the Nous Portal's curated recommended-models payload. Hits ``/api/nous/recommended-models``. The endpoint is public — no auth is required. Results are cached per portal URL for ``_NOUS_RECOMMENDED_CACHE_TTL`` seconds; pass ``force_refresh=True`` to bypass the cache. Returns the parsed JSON dict on success, or ``{}`` on any failure (network, parse, non-2xx). Callers must treat missing/null fields as "no recommendation" and fall back to their own default. rrNrrrr)rrrrr[rNOUS_RECOMMENDED_MODELS_PATHrrrrrrrrrVrZr^) rrrrrcachedrrrrrr_s rArrs"  @@ H H M MD .  C $ ( ( . .F V/# ?8 8 8N  1/ 1 1C n$$ 12%  ^ # #C # 9 9 4T:diikk002233D 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4$%% D &*3KD! Ks7*AD.9C3' D3C77D:C7;D D%$D%c. 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_URLr rarrrr)rrr rWr[striprr^)rr rportals rA_resolve_nous_portal_urlr"9s 1        ('//52UYY0117R88>>@@  &==%% %*++223777 1110001sA!B$!B BBrr Optional[str]ct|tsdS|d}t|tr(|r|SdS)zGPull the ``modelName`` field from a recommended-model entry, else None.N modelName)rVrZr[rWr )r model_names rArrIsf eT " "t;''J*c"""z'7'7'9'9"!!! 4rC)visionrrrr'Optional[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``). rNF)paidRecommendedVisionModelfreeRecommendedVisionModel)paidRecommendedCompactionModelfreeRecommendedCompactionModel)r"rrr^rr[) r'rrrrrpaid_keyfree_key candidateskeyrs rAget_nous_recommended_aux_modelr2Ss8  8688D+D NNNG t ,..II   III  `W((_( )B(x.BJ"7;;s#3#344  KKK  4s8 AAc.eZdZUded<ded<ded<dS) ProviderEntryrWsluglabeltui_descN)__name__ __module__ __qualname____annotations__rIrCrAr4r4s+ IIIJJJMMMMMrCr4z Nous Portalz(Nous Portal (Nous Research subscription) openrouter OpenRouterz%OpenRouter (100+ models, pay-per-use)NovitaAIz?NovitaAI (AI-native cloud: Model API, Agent Sandbox, GPU Cloud)lmstudioz LM Studioz8LM Studio (local desktop app with built-in model server) Anthropicu4Anthropic (Claude models — API key or Claude Code) OpenAI Codexz Qwen Cloudz5Qwen Cloud / DashScope Coding (Qwen + multi-provider)'xAI Grok OAuth (SuperGrok Subscription)z Xiaomi MiMou:Xiaomi MiMo (MiMo-V2.5 and V2 models — pro, omni, flash)zTencent TokenHubuJTencent TokenHub (Hy3 Preview — direct API via tokenhub.tencentmaas.com)z NVIDIA NIMu>NVIDIA NIM (Nemotron models — build.nvidia.com or local NIM)zGitHub Copilotz3GitHub Copilot (uses GITHUB_TOKEN or gh auth token)zGitHub Copilot ACPz3GitHub Copilot ACP (spawns `copilot --acp --stdio`)z Hugging Facez2Hugging Face Inference Providers (20+ open models)zGoogle AI Studiou6Google AI Studio (Gemini models — native Gemini API)zGoogle Gemini (OAuth)zNGoogle Gemini via OAuth + Code Assist (free tier supported; no API key needed)DeepSeeku0DeepSeek (DeepSeek-V3, R1, coder — direct API)xAIu xAI (Grok models — direct API)z Z.AI / GLMz Z.AI / GLM (Zhipu AI direct API)zKimi / Kimi Coding Planz.Kimi Coding Plan (api.kimi.com) & Moonshot APIzKimi / Moonshot (China)z.Kimi / Moonshot China (Moonshot CN direct API)zStepFun Step Planz9StepFun 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 Cloudu6Ollama Cloud (cloud-hosted open models — ollama.com)zArcee AIu(Arcee AI (Trinity models — direct API)z GMI Cloudz"GMI Cloud (multi-model direct API)z Kilo CodezKilo Code (Kilo Gateway API)z OpenCode Zenz0OpenCode Zen (35+ curated models, pay-as-you-go)z OpenCode Goz1OpenCode Go (open models, $10/month subscription)z AWS Bedrocku>AWS Bedrock (Claude, Nova, Llama, DeepSeek — IAM or API key)z Azure FoundryuUAzure Foundry (OpenAI-style or Anthropic-style endpoint — your Azure AI deployment)zVercel AI Gatewayz qwen-oauthzQwen OAuth (Portal)z(Qwen OAuth (reuses local Qwen CLI login)zlist[ProviderEntry]CANONICAL_PROVIDERSch|] }|j SrIr5rMrs rA rKs888qAF888rC)list_providers>aws_sdkrooauth_externalexternal_processoauth_device_codez (direct API)c(i|]}|j|jSrI)r5r6rJs rA rRsAAAAFAGAAArCzCustom endpointcustomglmzz-aizz.aizhipugithubzgithub-copilotz github-modelsz github-modelzgithub-copilot-acpzcopilot-acp-agentgooglez google-geminizgoogle-ai-studiokimizkimi-cnz moonshot-cnstepzstepfun-coding-planzarcee-aiarceeaiz gmi-cloudgmicloudz minimax-china minimax_cnzminimax-portalzminimax-global minimax_oauthclaudez claude-codez deep-seekopencodezengozopencode-go-sub aigatewayvercelzvercel-ai-gatewaykiloz kilo-codez kilo-gateway dashscopealiyunqwenz alibaba-cloudz qwen-portalz gemini-cliz gemini-oauthhfz hugging-facezhuggingface-hubz novita-ainovitaaimimoz xiaomi-mimotencenttokenhubz tencent-cloud tencentmaasawsz aws-bedrockzamazon-bedrockamazongrokz grok-oauthz x-ai-oauthzxai-grok-oauth) zx-aizx.ainimz nvidia-nimz build-nvidianemotronr?z lm-studio lm_studioollama ollama_cloudprovidercPt|g}|r|dndS)aReturn the default model for a provider, or empty string if unknown. Uses the first entry in _PROVIDER_MODELS as the default. This is the model a user would be offered first in the ``hermes model`` picker. Used as a fallback when the user has configured a provider but never selected a model (e.g. ``hermes auth add openai-codex`` without ``hermes model``). rr)rr[)rvrTs rAget_default_model_for_providerrx-s, ! !(B / /F &6!99B&rCct|tsdS t|dddko&t|dddkS#tt f$rYdSwxYw)z=Return True when both prompt and completion pricing are zero.FrrrrrVrZrr[rrrs rA_openrouter_model_is_freer|;s gt $ $uW[[3//00A5d% LZ]@^@^:_:_cd:dd z "uuA A''A<;A<itemct|tsdS|d}t|tsdSd|vS)u1Return True when the model's ``supported_parameters`` advertise tool calling. hermes-agent is tool-calling-first — every provider path assumes the model can invoke tools. Models that don't advertise ``tools`` in their ``supported_parameters`` (e.g. image-only or completion-only models) cannot be driven by the agent loop and would fail at the first tool call. **Permissive when the field is missing.** Some OpenRouter-compatible gateways (Nous Portal, private mirrors, older catalog snapshots) don't populate ``supported_parameters`` at all. Treat that as "unknown capability → allow" so the picker doesn't silently empty for those users. Only hide models whose ``supported_parameters`` is an explicit list that omits ``tools``. Ported from Kilo-Org/kilocode#9068. Tsupported_parameterstools)rVrZr[r@)r~paramss rA _openrouter_model_supports_toolsrEsO dD ! !t XX, - -F fd # #t f rC @ct|sttS ddlm}|}n#t$rd}YnwxYw|rt|ntt }d|D} t jdddi}t j || 5}tj | }dddn #1swxYwYn&#t$rttp|cYSwxYw|d g} t| tsttp|Si} | D]V} t| t st#| d pd } | sQ| | | <Wg} |D]g}| |}|t'|s*t)|d rdnd }| ||fh| sttp|S| d\}}|df| d<| at| S)zYReturn the curated OpenRouter picker list, refreshed from the live catalog when possible.Nr)get_curated_openrouter_modelscg|]\}}|SrIrIrs rArOz+fetch_openrouter_models..s000VS!S000rCz#https://openrouter.ai/api/v1/modelsrrrrr_idrrr2r)r5r@hermes_cli.model_catalogrr^r4rrrrrrrrr[rVrZrWr rr|r)rrrremotefallback preferred_idsrrr live_items live_by_idr~rXcurated preferred_id live_itemdescfirst_idrs rAfetch_openrouter_modelsr^s!,],-... JJJJJJ..00 %BtF|||40A+B+BH00x000M;n$$ 112%  ^ # #C # 9 9 7Tj!3!3!5!566G 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 ;;;-9:::::;VR((J j$ ' ';-9:::,.J$%%  $((4..&B''--//   3%'G% - - NN<00   0 ::  29==3K3KLLTvvRT d+,,,, ;-9:::!*KHaM*GAJ ' ==sC0 ??4AD 89C=1 D =DD DD D,+D,c6dt|DS)z,Return just the OpenRouter model-id strings.cg|]\}}|SrIrIrs rArOzmodel_ids.. S S SFCC S S SrCr)rrs rArr" S S5MRRR S S SSrCc ddlm}|}n#t$rd}YnwxYw|rt|SttdgS)a6Return the curated Nous Portal model-id list. Prefers the remotely-hosted catalog manifest (published under ``website/static/api/model-catalog.json``); falls back to the in-repo snapshot in ``_PROVIDER_MODELS["nous"]`` when the manifest is unreachable. Always returns a list (never None). r)get_curated_nous_modelsNra)rrr^r@rr[)rrs rAget_curated_nous_model_idsrsDDDDDD((**  F||  $$VR00 1 11s  ""ct|tsdS t|dddko&t|dddkS#tt f$rYdSwxYw)zCReturn True if an AI Gateway model has $0 input AND output pricing.Finputrroutputrzr{s rA_ai_gateway_model_is_freers gt $ $uW[[#..//14_w{{8UX?Y?Y9Z9Z^_9__ z "uur}c>t|sttSddlm}tt}d|D} t j|ddddi }t j || 5}tj | }dddn #1swxYwYn&#t$rttp|cYSwxYw|d g}t!|tsttp|Si} |D]V} t!| t"st%| d pd } | sQ| | | <Wg} |D]W} | | }|t)|drdnd }| | |fX| sttp|St-d| Ddr'fd| D} | ddfn| d\}}|df| d<| at| S)zYReturn the curated AI Gateway picker list, refreshed from the live catalog when possible.NrAI_GATEWAY_BASE_URLcg|]\}}|SrIrIrs rArOz+fetch_ai_gateway_models..rrCrr rrrrr_rrrr2c3K|]@\}}|dt|d<|VAdS)z moonshotai/rN) startswithrr[)rMrXr~s rA z*fetch_ai_gateway_models..sj  T~~m,, *$((9*=*=>>        rCc*g|]\}}|k ||fSrIrI)rMrXr free_moonshots rArOz+fetch_ai_gateway_models..s+PPP933-;O;OC;;O;O;OrCr)r8r@hermes_constantsrr7rrrrrrrrrr^r[rVrZrWr rrnextitemsinsert)rrrrrrrrrrr~rXrrrrrrrs @rAfetch_ai_gateway_modelsrs1!,],-...444444,--H00x000M;n$$"))#.. 7 7 712%  ^ # #C # 9 9 7Tj!3!3!5!566G 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 ;;;-9:::::;VR((J j$ ' ';-9:::,.J$%%  $((4..&B''--//   3%'G%-- NN<00   29==3K3KLLTvvRT d+,,,, ;-9:::  '--//   M/PPPPPPPq=-89999aj ! . ' ==s7AC1 9C% C1%C))C1,C)-C11 DDc6dt|DS)z,Return just the AI Gateway model-id strings.cg|]\}}|SrIrIrs rArOz(ai_gateway_model_ids.. rrCr)rrs rAai_gateway_model_idsr rrCz$dict[str, dict[str, dict[str, str]]]_pricing_cache per_token_strcz t|}n#ttf$rYdSwxYw|dkrdS|dz}d|dS)uConvert a per-token price string to a human-friendly $/Mtok string. Always uses 2 decimal places so that prices align vertically when right-justified in a column (the decimal point stays in the same position). Examples: "0.000003" → "$3.00" (per million tokens) "0.00003" → "$30.00" "0.00000015" → "$0.15" "0.0000001" → "$0.10" "0.00018" → "$180.00" "0" → "free" ?rr2@B$z.2f)rrr)rvalper_ms rA_format_price_per_mtokrsbM"" z "ss axxv )OE u???s '' rT pricing_map current_modelindentc |sgSg}d}|D]\}}||k}||} | rtt| dd} t| dd} | dd} | rt| nd} | rd}nd\} } } ||| | | |ftd|Dd z}ttd |Dd td |Dd d}|r)ttd|Dd dnd}g}|rb||dd|ddd|ddd|ddd|d ||d|zdd|zdd|zdd|znT||dd|ddd|ddd|d||d|zdd|zdd|z|D]r\}} } } }|rdnd}|r5|||d|d| d|d| d|d| d|| E|||d|d| d|d| d||s|S)zBuild a column-aligned model+pricing table for terminal display. Returns a list of pre-formatted lines ready to print. *models* is ``[(model_id, description), ...]``. Frrrinput_cache_readT)rrrc3@K|]}t|dVdS)rNlenrMrs rArz-format_model_pricing_table..Qs,++3qt99++++++rCc3PK|]!}|d t|dV"dS)Nrrs rArz-format_model_pricing_table..T5 - -1! -S1YY - - - - - -rC)defaultc3PK|]!}|d t|dV"dS)rNrrs rArz-format_model_pricing_table..UrrCc3PK|]!}|d t|dV"dS)rNrrs rArz-format_model_pricing_table..YrrCrModel< In>z OutCachez /Mtok-u ← current)r[rrmax)rTrrrrows has_cacherX_descis_currinpout cache_readcachename_col price_col cache_collinesmarkers rAformat_model_pricing_tabler2s  35DI 4 4 U % OOC   )(x)<)<==C(|R)@)@AAC1266J:DL*:666"E ! (OCe S#sE623333++d+++++a/H - - - - -q999 - - - - -q999 I  - - - - -q999 EW ~~(~~~~d~Y~~~~5~S\~~~~ah~kt~~~~~ hhhhyhhC)OhhWZ]fWfhhiiii ff(ffffdfYffff5fS\fffffggg UhUUyUUC)OUUVVV(,ff$S#uf$*2  f LLFzCz(zzzzczIzzzz#zPYzzzz^czfozzzrxzz { { { { LLFdCd(ddddcdIdddd#dPYddd\bdd e e e e LrChttps://openrouter.ai/apiapi_key str | Nonebase_urlc4|pdd}|s|tvr t|S|ddz}dtd}|rd||d< tj||}tj|| 5}tj| } d d d n #1swxYwYn#t$rit|<icYSwxYwi} | d gD]} | d } | d } | rt| trt| ddt| ddd}| drt| d|d<| drt| d|d<|| | <| t|<| S)zFetch ``/v1/models`` and return ``{model_id: {prompt, completion}}`` pricing. Results are cached per *base_url* so repeated calls are free. Works with any OpenRouter-compatible endpoint (OpenRouter, Nous Portal). rrz /v1/modelsr)r User-AgentrrrrNr_rrrrrrinput_cache_write)rr_HERMES_USER_AGENTrrrrrrrrr^r[rVrZrW)rrrr cache_keyrrrrrrr~rXrrs rAfetch_models_with_pricingrpspR'',,I )Y.88i((   3  , .C$(G7#6W#6#6 n$$S'$:: ^ # #C # 9 9 7Tj!3!3!5!566G 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 $&y! )+F FB''   hhtnn((9%%  :gt,, gkk(B7788!'++lB"?"?@@%%E{{-.. M,/8J0K,L,L(){{.// O-09L1M-N-N)*F3K &N9 Ms7AC09C$ C0$C((C0+C(,C00D D c ddlm}|d}|s|tvr t|S tj|dddi}tj||5}tj | }d d d n #1swxYwYn#t$rit|<icYSwxYwi}| d gD]}t|ts| d } | d } | rt| ts[t!| d dt!| ddd} | drt!| d| d<| drt!| d| d<| || <|t|<|S)zFetch Vercel AI Gateway /v1/models and return hermes-shaped pricing. Vercel uses ``input`` / ``output`` field names; hermes's picker expects ``prompt`` / ``completion``. This translates. Cache read/write field names already match. rrrr rrrrNr_rrrrrrrr)rrrrrrrrrrrrr^r[rVrZrW) rrrrrrrrr~rXrrs rAfetch_ai_gateway_pricingrsj544444#**3//I )Y.88i(( n$$ ! ! !12%  ^ # #C # 9 9 7Tj!3!3!5!566G 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 $&y! )+F FB''$%%  hhtnn((9%%  7D11  '++gr2233gkk(B7788! !  ;;) * * I(+G4F,G(H(HE$ % ;;* + + K),W5H-I)J)JE% &s &N9 Ms6AC <9C5 C CC C C C&%C&cPtjddS)z1Best-effort OpenRouter API key for pricing fetch.OPENROUTER_API_KEYr)osgetenvr rIrCrA_resolve_openrouter_api_keyrs! 9)2 . . 4 4 6 66rCz&https://inference-api.nousresearch.comtuple[str, str]c ddlm}|}|r,|dd|ddfSn#t$rYnwxYwdtfS)uhReturn ``(api_key, base_url)`` for Nous Portal pricing. The Nous inference ``/v1/models`` endpoint exposes pricing without authentication, so the api_key is best-effort: when runtime credential resolution fails (expired refresh token, missing auth.json, etc.) we still return the default inference base URL so the picker keeps working with anonymous pricing data. Free-tier users in particular need this — pricing drives the free/paid partition, and silently returning empty pricing because of an auth blip makes the picker look broken ("No free models currently available"). r)r rrr)rr r[r^_DEFAULT_NOUS_INFERENCE_BASE)r credss rA!_resolve_nous_pricing_credentialsrs DDDDDD0022  IIIi,,eii B.G.GH H I      , --s=A A Act|}|dkrttd|S|dkrt|S|dkrt |S|dkrYt \}}|rF|d}|d r |d d }t|||SiS) zYReturn live pricing for providers that support it (openrouter, nous, ai-gateway, novita).r<r)rrrrrrrar/v1N)normalize_providerrrr_fetch_novita_pricingrrendswith)rvr normalizedrrstrippeds rAget_pricing_for_providerrs#H--J\!!(/110'    \!!'mDDDDX$=AAAAV=??   s++H  '' )#CRC=,!+  IrCcDtjdd}|siStjddpd}|d}|s|tvr t|S|dz}d|dt d } t j|| }t j || 5}tj | } d d d n #1swxYwYn#t$rit|<icYSwxYwi} | d gD]} t!| t"s| d} | s0| d} | d}| |_t%t'| pddz dz t%t'|pddz dz d| t%| <| t|<| S)uFetch pricing from NovitaAI /v1/models. NovitaAI returns input/output prices per million tokens in units of 0.0001 USD. Convert them to the per-token strings used by the shared pricing formatter. Results are cached in ``_pricing_cache`` keyed on the resolved base URL, matching the pattern used by ``fetch_ai_gateway_pricing`` — without this, every menu render or pricing lookup re-hits the network. NOVITA_API_KEYrNOVITA_BASE_URLzhttps://api.novita.ai/openai/v1rr rr)rrrrrNr_rinput_token_price_per_moutput_token_price_per_mri'rr)rrr rrrrrrrrrrrr^r[rVrZrWr)rrrrrrrrrrrr~rXrrs rArrsri("--3355G  y*B//5577\;\H$$I )Y.88i(( i C,7,,$(G n$$S'$:: ^ # #C # 9 9 7Tj!3!3!5!566G 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 $&y! )+F FB''   $%%  hhtnn  hh011hh122 ;3; %q//F2Y>??eCH1oo6BCC  s3xx !'N9 Ms7AD)9D D)D!!D)$D!%D))EEset[str]_KNOWN_PROVIDER_NAMESlist[dict[str, str]]cdtDdgz}i}tD].\}}||g|/g}|D] }t ||}||g}d} ddlm} m } |dkr2tpd} t| }ng|dkr| tjdd}nB| |} t| d p| d }n#t$rYnwxYw|||||d  |S) aRReturn info about all providers the user could use with ``provider:model``. Each dict has ``id``, ``label``, and ``aliases``. Checks which providers have valid credentials configured. Derives the provider list from :data:`CANONICAL_PROVIDERS` (single source of truth shared with ``hermes model``, ``/model``, etc.). cg|] }|j SrIrIrJs rArOz,list_available_providers..]s:::af:::rCrSFr)get_auth_statushas_usable_secretrr<r logged_in configured)rr6aliases authenticated)rG_PROVIDER_ALIASESr setdefaultr_PROVIDER_LABELSr[rrr_get_custom_base_urlrr rrr^) provider_order aliases_foralias canonicalrpidr6 alias_list has_credsrrcustom_base_urlstatuss rAlist_available_providersr#Ss;:&9:::hZGN)+K-3355<<yy"--44U;;;; F   $$S#.. __S"--    J J J J J J J Jh"6"8"8">B !6!6!8!899  $$--bi8Lb.Q.QRR (-- K!8!8!TFJJ|->)s33 (,7==?? ),*:*;*;<BBDD C<C3k33\BB&}55zB B h ''rCc  ddlm}|}|di}t|tr5t |ddSn#t$rYnwxYwdS)z2Get the custom endpoint base_url from config.yaml.r) load_configmodelrr)hermes_cli.configr3r[rVrZrWr r^)r3config model_cfgs rArrs 111111JJw++ i & & >y}}Z4455;;== = >      2sA/A33 B?Bct|}|dkrt|St|}|r d|DSt|g}d|DS)zReturn ``(model_id, description)`` tuples for a provider's model list. Tries to fetch the live model list from the provider's API first, falling back to the static ``_PROVIDER_MODELS`` catalog if the API is unreachable. r<rcg|]}|dfSrrIrLs rArOz/curated_models_for_provider..s&&&AB&&&rCcg|]}|dfSr:rIrLs rArOz/curated_models_for_provider..s $ $ $QG $ $ $rC)rrprovider_model_idsrr[)rvrrliverTs rAcurated_models_for_providerr>s$H--J\!!&]CCCC j ) )D '&&&&&& ! !*b 1 1F $ $V $ $ $$rCc|pd}t|}d||fDS)Nrch|]}||SrIrI)rMks rArKz!_provider_keys..s . . .!A .A . . .rC)r r*r)rvr1rs rA_provider_keysrBsI >r " " ( ( * *C#H--J . .Z( . . ..rC name_lower providersc:tfd|DS)Nc3K|]:}t|gD]}|kV;dSN)rr[r*)rMrvr4rCs rArz-_model_in_provider_catalog..sk %))(B77  ekkmm#rC)any)rCrDs` rA_model_in_provider_catalogrIs; !  rC>rarorr<r current_keysOptional[tuple[str, str]]c` ddlm}n#t$rYdSwxYw||}|dS|j|jd fd }|D]}||x}r||fcSt D]#}||vs |tvr||x}r||fcS$tD]}||vr||x}r||fcSdS) zDResolve short aliases (e.g. sonnet/opus) using static catalogs only.r) MODEL_ALIASESNrvrWr9r#ct|g}|sdS|tvrdn}|D]-}||r|cS.dS)Nr)rr[_AGGREGATOR_PROVIDERSr*r)rvrTprefixr4familyvendors rA_matchz+_resolve_static_model_alias.._matchs!%%h33 4000   %''    E{{}}''//   trC)rvrWr9r#)hermes_cli.model_switchrMr^r[rRrQrrO) rCrJrMidentityrSrvmatchedrQrRs @@rA_resolve_static_model_aliasrWsm 9999999 tt  ,,Ht _F _F       !%%fX&& &7 %W$ $ $ $ %%%% | # #x3H'H'H fX&& &7 %W$ $ $ $ %*%% | # #FF84D4D)D #W$ $ $ $ 4s  r&c |pd}|sdS| t|}t |}|r|St }|dvr4t |g}|tvr|r||vr ||dfSt |rdSt D]4\}}||vs |tvrt fd|Dr||fcS5dS)aAuto-detect a provider from static catalogs only. Returns ``(provider_id, model_name)``. The model name may be remapped when a static alias or bare provider name resolves to a catalog default. Returns ``None`` when no confident match is found. rN>rSr<rc3HK|]}|kVdSrGr*)rMrNrCs rArz3detect_static_provider_for_model..9s0771zQWWYY&777777rC) r r*rBrWrr[rrrIrrOrH) r&r%rrJ alias_matchresolved_providerdefault_modelsrrTrCs @rA detect_static_provider_for_modelr^ s]  " # # % %D tJ!"233L-j,GGK*--j*EE 888)--.?DD !1 1 1 2!55%~a'89 9"*l;;t(--// V ,  #)>">">  7777777 7 7 ;     4rCc|pd}|sdSt||}|r|St|t |rdSt |}|r|dkrd|fS||krd|fSdSdS)uAuto-detect the best provider for a model name. Returns ``(provider_id, model_name)`` — the model name may be remapped (e.g. bare ``deepseek-chat`` → ``deepseek/deepseek-chat`` for OpenRouter). Returns ``None`` when no confident match is found. Priority: 0. Bare provider name → switch to that provider's default model 1. Direct provider static catalog match 2. OpenRouter catalog match rNr<)r r^rIr*rB_find_openrouter_slug)r&r%r static_matchor_slugs rAdetect_provider_for_modelrc?s  " # # % %D t3D:JKKL!$**,,?O0P0PQQt$D))G | + + '* * d?? '* *t 4rCcH|}|sdStD]}||kr|cStD];}d|vr5|dd\}}||kr|cS.s/PP6tv&&PPPPPPrC)_strip_vendor_prefixrWrerHrprr$rs @rA_is_openai_fast_modelrvsq s8>r22 3 3C 99S>>! D u$u PPPP5OPPP P PPrCct|pd}d|vr|ddd}|S)z]Strip vendor/ prefix from a model ID (e.g. 'anthropic/claude-opus-4-6' -> 'claude-opus-4-6').rrr)rWr r*re)rr$s rArtrtsQ hn"   # # % % + + - -C czziiQ" JrCc>t|pt|S)zDReturn whether Hermes should expose the /fast toggle for this model.)_is_anthropic_fast_modelrvrs rAmodel_supports_fast_moder{s #H - - P1Fx1P1PPrCctt|pd}|dd}|dsdSd|vpd|vS)aReturn True if the model is a Claude model eligible for Anthropic Fast Mode. Fast mode is currently supported on Claude Opus 4.6 only. Per Anthropic's docs (https://platform.claude.com/docs/en/build-with-claude/fast-mode): "Fast mode is currently supported on Opus 4.6 only. Sending speed: fast with an unsupported model returns an error." Opus 4.7 explicitly rejects the ``speed`` parameter with HTTP 400. rr'rclaude-Fzopus-4-6zopus-4.6)rtrWrerrus rAryrys_ s8>r22 3 3C 99S>>! D ??9 % %u   3t!33rCdict[str, Any] | NonecRt|sdSt|rddiSddiS)uReturn request_overrides for fast/priority mode, or None if unsupported. Returns provider-appropriate overrides: - OpenAI models: ``{"service_tier": "priority"}`` (Priority Processing) - Anthropic models: ``{"speed": "fast"}`` (Anthropic Fast Mode beta) The overrides are injected into the API request kwargs by ``_build_api_kwargs`` in run_agent.py — each API path handles its own keys (service_tier for OpenAI/Codex, speed for Anthropic Messages). Nspeedfast service_tierpriority)r{ryrzs rAresolve_fast_mode_overridesrs? $H - -t))!  J ''rCc( ddlm}|d}t|dpd}|r|Sn#t $rYnwxYw ddlm}ddlm}m }|dD]}t|tst|dpd}|sQ||\}} |sb ||\} } n#t $rY~wxYw| r| cSn#t $rYnwxYwdS) u3Best-effort GitHub token for fetching the Copilot model catalog. Resolution order: 1. ``resolve_api_key_provider_credentials("copilot")`` — env vars (``COPILOT_GITHUB_TOKEN`` / ``GH_TOKEN`` / ``GITHUB_TOKEN``) plus the ``gh auth token`` CLI fallback. 2. ``read_credential_pool("copilot")`` — a token (typically a ``gho_*`` from device-code login, or a fine-grained PAT) stored in ``auth.json`` under ``credential_pool.copilot[]``. The pool is populated by ``hermes auth add copilot`` and by ``_seed_from_env`` when the env var is set in ``~/.hermes/.env``. Without (2), users whose only Copilot credential is in the pool see the ``/model`` picker fall back to a stale hardcoded list because the live catalog fetch silently 401s. To avoid wedging on a malformed pool entry, each candidate is exchanged via ``exchange_copilot_token`` — only entries that actually exchange successfully are returned, so a later valid entry is reachable when an earlier one is unsupported. r$resolve_api_key_provider_credentialsrorr)read_credential_pool)exchange_copilot_tokenvalidate_copilot_tokenr) rrrWr[r r^rhermes_cli.copilot_authrrrVrZ) rrrrrrrr$validr api_token _expires_ats rA _resolve_copilot_catalog_api_keyrs( HHHHHH44Y??eii **0b117799  N        888888        *))44 ! !EeT** eii//5266<<>>C --c22HE1  )?)?)D)D& ;;     !     ! !       2sOA A AAA;DC*)D* C74D6C77DD DD>rxgroqcohererwrWr|mistralrr fireworks perplexity togetherairrrzfrozenset[str]_MODELS_DEV_PREFERREDrc ddlm}||}n#t$rg}YnwxYw|st|St }g}|D]R}t |}||vr(||||S|D]R}t |}||vr(||||S|S)uMerge curated list with fresh models.dev entries for a preferred provider. Returns models.dev entries first (in models.dev order), then any curated-only entries appended. Preserves case for curated fallbacks (e.g. ``MiniMax-M2.7``) while trusting models.dev for newer variants. If models.dev is unreachable or returns nothing, the curated list is returned unchanged — this is the offline/CI fallback path. rlist_agentic_models) rYrr^r@rrWr*addr)rvrrmdev seen_lowermergedrXr1s rA_merge_with_models_devrHs,888888""8,,  G}}55JF#hhnn *   s c#hhnn *   s c Ms  ##c P t|}|dkrt|S|dkrOddlm}d} ddlm}|d }|d }n#t$rd}YnwxYw|| S|d krAttd td gS|dvr_ tt}|r|Sn#t$rYnwxYw|dkr(ttdgS|dkr_ ddlm }m } | }|r9||d d|dd}|r|Sn#t$rYnwxYw|dkr ddlm} | d}t|d pd} t|dpd} | r| rt#| | }|r|Sn#t$rYnwxYw|dkrt%}|r|S|dkrt'}|r|S|dkrt)|}|r|S|dkrt+jdd} | rdt+jddd} | pd} t#| |}|r|Sn#t$rYnwxYw|d kr ddlm} | d }t|d pd} t|dpd} | r| rt#| | }|r|Sn#t$rYnwxYw|d!krct1} | rSt+jd"dp)t+jddpt+jd#d} t#| | }|r|S|d$kr& dd%lm}|}||Sn#t$rYnwxYw dd&lm}ddlm} ||}|r|jd kr|jr | |}t|d pd} t|dpd} n#t$r d|j} } YnwxYw| s|j} | r|| '}|r|S|j rt|j Sn#t$rYnwxYwtt|g}|tBvrtE||S|S)(aReturn the best known model catalog for a provider. Tries live API endpoints for providers that support them (Codex, Nous), falling back to static lists. For providers in ``_MODELS_DEV_PREFERRED`` (opencode-go/zen, xiaomi, deepseek, smaller inference providers, etc.), models.dev entries are merged on top of curated so new models released on the platform appear in ``/model`` without a Hermes release. r<rrlr)get_codex_model_idsN)!resolve_codex_runtime_credentialsT)refresh_if_expiringr)rrmrS>rornrnrora)fetch_nous_modelsr rr)rinference_base_urlrrrrrFrcOPENAI_API_KEYOPENAI_BASE_URLrzhttps://api.openai.com/v1rrSCUSTOM_API_KEYrr)bedrock_model_ids_or_none)get_provider_profiler)#rrr?rrrr[r^r@r_fetch_github_modelsrrr rrWr fetch_api_models_fetch_anthropic_models_fetch_ai_gateway_modelsfetch_ollama_cloud_modelsrrrragent.bedrock_adapterrrDr auth_typer fetch_modelsfallback_modelsrr)rvrrrrrrr=rr rrrbase_rawrrrFr_pcurated_statics rAr<r<msb$H--J\!!}5555^##??????   I I I I I I55$OOOE 99Y//LL   LLL "" ====[  $((6F6J6J5RT6U6UVVWWW/// '(H(J(JKKD       D   & &(,,Y;;<< <V  [ [ [ [ [ [ [ [4466E ((9b1I1I^c^g^ghrtv^w^wxxx K    D Y  L L L L L L88CCE%))I..4"55;;==G599Z006B77==??H 8 ':: K    D [  &((  K\!!'))  K^##(}EEE  KX),b117799  y!2B77==??FFsKKH::D '66 K     U  L L L L L L88??E%))I..4"55;;==G599Z006B77==??H 8 ':: K    D X'))   *B//79-r22791266  $GX66D  Y  G G G G G G++--C     D   222222HHHHHH ! !* - -  0",)++ + 4<>??N***%j.AAA s'A A,+A,C'' C43C4,A E:: FFBH'' H43H4/L LLBN11 N>=N>1Q QQ+UA7S;:U;TUT'U9U U"!U"Optional[list[str]]c ddlm}m}n#t$rYdSwxYw|}|sdSddi}||}|r.d||d<ddlm}m}md ||z|d <n||d <dfd } ||} n#tj j $r} |r| j dkr | d} n#t$rd} YnwxYwd| vrDd| vr@d fd|Dt!|z|d <||} nYd} ~ nd} ~ wwxYwd| dgD} t%| dS#t$r=} ddl}|t*d| Yd} ~ dSd} ~ wwxYw)zFetch available models from the Anthropic /v1/models endpoint. Uses resolve_anthropic_token() to find credentials (env vars or Claude Code auto-discovery). Returns sorted model IDs or None. r)resolve_anthropic_token_is_oauth_tokenNanthropic-version 2023-06-01rr) _COMMON_BETAS_OAUTH_ONLY_BETAS_CONTEXT_1M_BETA,zanthropic-beta x-api-keyhdict[str, str]c,tjd|}tj|5}t j|cdddS#1swxYwYdS)Nz#https://api.anthropic.com/v1/modelsrr)rrrrrrrr)rrrrs rA _do_requestz,_fetch_anthropic_models.._do_request" sn$$ 1%  ^ # #C # 9 9 4T:diikk002233 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4s8B  B B iignore)errorsrzlong context betaznot yet availablec g|] }|k| SrIrI)rMbrs rArOz+_fetch_anthropic_models..< s$KKKqQ:J5J5J5J5J5JrCcHg|]}|d|d Srr[rLs rArOz+_fetch_anthropic_models..D s+GGGa155;;G!D'GGGrCr_cd|vd|vd|v|fS)NopussonnethaikurI)rNs rAz)_fetch_anthropic_models..F s# !O A  1  - rC)r1z$Failed to fetch Anthropic models: %s)rr)agent.anthropic_adapterrr ImportErrorrrrjoinrerror HTTPErrorcoderrr*r^r@r[r]logging getLoggerr8debug)rrrtokenris_oauthrrrr_http_err body_textrTerrs` @rArr s TTTTTTTTT tt $ # % %E t2LAGu%%H%#4U#4#4 ^^^^^^^^^^$'HH]=N-N$O$O !!$ 444444% ;w''DD|%     MS((# (  6 6h 6 G G M M O OII ### "III#&)338Ky8X8X03KKKKMKKK011211G,-';w//DD DDDD% .HG488FB#7#7GGGf# #     (##))*PRSTTTtttttsm 8 BE<E E&:C! E! C0-E/C00A E=E<E4E<< G2F>>Grlist[dict[str, Any]]ct|tr d|DSt|tr7|dg}t|tr d|DSgS)Nc<g|]}t|t|SrIrVrZrMr~s rArOz"_payload_items..T s'CCCJtT,B,BCCCCrCr_c<g|]}t|t|SrIrrs rArOz"_payload_items..X s'DDDTZd-C-CDDDDDrC)rVr@rZr[)rr_s rA_payload_itemsrR s{'4  DCCCCCC'4  E{{62&& dD ! ! EDDTDDD D IrCrc` ddlm}|dS#t$rtddddcYSwxYw) zStandard headers for Copilot API requests. Includes Openai-Intent and x-initiator headers that opencode and the Copilot CLI send on every request. rcopilot_request_headersT) is_agent_turnzHermesAgent/1.0zconversation-editsagent)zEditor-Versionrz Openai-Intentz x-initiator)rrrCOPILOT_EDITOR_VERSIONrs rAcopilot_default_headersr\ sm  CCCCCC&&T::::    4+1"       s --cFt|dpd}|sdS|ddurdS|d}t|trRt|dpd}|r|dkrdS|d}t|t r'd |D}|r|hd sdSd S) NrrFmodel_picker_enabled capabilitiestypechatsupported_endpointsch|]D}t|#t|ESrIrWr rMendpoints rArKz6_copilot_catalog_item_is_text_model..~ sR   8}}""$$ MM   ! !   rC> /responses /v1/messages/chat/completionsT)rWr[r rVrZr*r@ intersection)r~rr model_typernormalized_endpointss rA#_copilot_catalog_item_is_text_modelrn sB488D>>'R((..00H u xx&''500u88N++L,%%))&117R88>>@@FFHH  *..5((#899%t,,   /     (<(I(I ? ? ?) )  5 4rCOptional[list[dict[str, Any]]]c`g}|r*|itdd|i|t|D]Z}tjt |} tj||5}tj| }t|}g}t} |D]y} t| st| dpd} | r| | vrO| | || z|r|cdddcS dddn #1swxYwYK#t$$rYXwxYwdS)z=Fetch the live GitHub Copilot model catalog for this account.rrrrrrN)rrrrrCOPILOT_MODELS_URLrrrrrrrrrWr[r rr^) rrattemptsrrrr_rrTseen_idsr~rs rAfetch_github_model_catalogr s7&(H  %'' 0w00      OO+--...n$$%7$II ''W'== "z$))++"4"4"6"677&t,,/1%(UU!((D>tDD! "488D>>#7R88>>@@H#!x8';'; LL***MM$''''"! " " " " " " " " " "" " " " " " " " " " " " " " " "    H  4s=>#E#J""&)++ 99X  rCc|pdd}|tp)|dp|dS)Nrrz"https://models.github.ai/inferencez%https://models.inference.ai.azure.com)r rr*rCOPILOT_BASE_URL)rrs rA_is_github_models_base_urlr sx.b''))0055;;==J.// J  !E F F J  !H I IrCc|pdd}|dr|ddd}|pdS)zStrip ``/v1`` suffix from an LM Studio base URL to get the native API root. Returns ``None`` when the base URL is empty/invalid. rrrNr)r rr)rroots rA_lmstudio_server_rootr s` N ! ! # # * *3 / /D }}U%CRCy$$ <4rCrZcrdti}t|pd}|rd||d<|S)z5Build HTTP headers for LM Studio native API requests.rrrr)rrWr )rrrs rA_lmstudio_request_headersr sI/0G  2   $ $ & &E 5#4U#4#4 NrCOptional[list[dict]]ct|}|sdSt|}tj|dz|} tj||5}t j| }dddn #1swxYwYn#tj j $rj}|j dvrddl m} | d|j d d d |ddl} | t"d ||j Yd}~dSd}~wt&$r>}ddl} | t"d||Yd}~dSd}~wwxYwt)|t*r|dnd} t)| t.s4ddl} | t"d|dS| S)zFetch the raw model list from LM Studio's ``/api/v1/models``. Returns the ``models`` list of dicts on success, ``None`` on network errors or malformed responses. Raises ``AuthError`` on HTTP 401/403. Nz/api/v1/modelsrr>r AuthErrorz)LM Studio rejected the request with HTTP .r? auth_rejected)rvrz)LM Studio probe at %s failed with HTTP %sz LM Studio probe at %s failed: %srTzCLM Studio probe at %s returned malformed payload (no `models` list))rrrrrrrrrrrrrrrrrr8rr^rVrZr[r@) rrr server_rootrrrrexcrr raw_modelss rA_lmstudio_fetch_raw_modelsr# sw(11K t'00Gn$$[3C%CW$UUG ^ # #GW # = = 7j!3!3!5!566G 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 < !    8z ! ! 1 1 1 1 1 1)GCHGGG#$   (##)) 7ch   ttttt (##)) . S   ttttt +5Wd*C*CMX&&&J j$ ' '(##)) Q    t sI!B:)9B." B:.B22B:5B26B::E>AD33 E>3E99E>ct|||}|dSg}|D]}t|tst|dpddkret|dp|dpd}|r||vr|||S)aProbe LM Studio's model listing. Returns chat-capable model keys on success, including the valid empty-list case when the server is reachable but has no non-embedding models. Returns ``None`` on network errors, malformed responses, or empty/invalid base URLs. Raises ``AuthError`` on HTTP 401/403 so callers can surface token issues separately from reachability problems. rrrNrr embeddingr1r)r#rVrZrWr[r r*r)rrrr"r\r$r1s rAprobe_lmstudio_modelsr'* s,GhX_```JtD#t$$   swwv$" % % + + - - 3 3 5 5 D D #''%..7CGGDMM7R88>>@@  3d?? KK    KrCc.t|||}|pgS)uFetch LM Studio chat-capable model keys from native ``/api/v1/models``. Returns a list of model keys (e.g. ``publisher/model-name``) with embedding models filtered out. Returns an empty list on network errors, malformed responses, or empty/invalid base URLs. Raises ``AuthError`` on HTTP 401/403 so callers can distinguish a missing or wrong ``LM_API_KEY`` from an unreachable server — the most common LM Studio support case once auth-enabled mode is turned on. r%)r')rrrrTs rAfetch_lmstudio_modelsr)I s"#7Xw W W WF >U " "cggdmmu&<&<L E'=t344G'3DGaKK #$97 C C  !344:$.tT$:$:Ddhhx   2. sAOOOqJq#>U " "swwt}}'='= ww~&&-7d-C-CMDHH[))) 3=i3N3NXy}}.///TX dD ! ! POODOOO O O O Is  $$cDt||}|sdSd|DS)Nrrcdg|]-}|d|dd.Srrrrs rArOz(_fetch_github_models.. s5 E E E4dhhtnn EDHHT2   E E ErC)r)rrr s rArr s5('JJJG t E E7 E E EErCz openai/gpt-5rfzopenai/gpt-5-chatzopenai/gpt-5-minizopenai/gpt-5-nanozopenai/gpt-4.1rizopenai/gpt-4.1-minizopenai/gpt-4.1-nanoz openai/gpt-4orjzopenai/gpt-4o-minirk openai/o1rzopenai/o1-minizopenai/o1-preview openai/o3rgzopenai/o3-minizopenai/o4-minirzclaude-opus-4.6rrprqrrrs) zanthropic/claude-sonnet-4zanthropic/claude-sonnet-4.5rrrzclaude-sonnet-4-0rrzanthropic/claude-opus-4-6zanthropic/claude-sonnet-4-6zanthropic/claude-sonnet-4-0zanthropic/claude-sonnet-4-5zanthropic/claude-haiku-4-5r cb||rt|}|stSd|DS)Nrch|]n}t|dpd8t|dpdoSrH)rWr[r rs rArKz'_copilot_catalog_ids.. st     txx~~# $ $ * * , ,  DHHTNN b!!''))   rC)rrr rs rA_copilot_catalog_idsrN sO7,W=== uu      rCrMcpt|pd}|sdSt||}t|}|r|S|g}d|vrA||ddd|dr||dd|dr||dd|dr||ddt}|D]>}|r||vr | ||tvrt|cS||vr|cS?d|vr.|dddS|S) NrrMrrz-miniz-nanoz-chat) rWr rN_COPILOT_MODEL_ALIASESr[rrerrr) rr rr$ catalog_idsrr0r candidates rAnormalize_copilot_model_idrT s hn"   # # % %C r&wHHHK " & &s + +E  J czz#))C++A.4466777 ||G$#crc(### ||G$#crc(### ||G$#crc(###UUD  I--   . . .))4 4 4 4  # #    $ czzyya  #))+++ JrCc<|pd}|drttSt |}|drtt SgS)Nr)rIrJz openai/o4rmrnror)r r*rr@"COPILOT_REASONING_EFFORTS_O_SERIESrTCOPILOT_REASONING_EFFORTS_GPT5)rr$rs rA&_github_reasoning_efforts_for_model_idrX( s >r " " ( ( * *C ~~OPP86777+H55;;==JW%%42333 IrCcddl}|d|}|sdSt|d}|dko|d S)a%Decide whether a Copilot model should use the Responses API. Replicates opencode's ``shouldUseCopilotResponsesApi`` logic: GPT-5+ models use Responses API, except ``gpt-5-mini`` which uses Chat Completions. All non-GPT models (Claude, Gemini, etc.) use Chat Completions. rNz ^gpt-(\d+)Frrrf)rematchrgroupr)rrZr[majors rA!_should_use_copilot_responses_apir^2 sdIII HH]H - -E u  A  E A: ?h11,????rCc:||rt|}t|||sdStrdS|r\tfd|Dd}t |t r+d|dpgD}d |vrd |vrd SdS) zDetermine the API mode for a Copilot model. Uses the model ID pattern (matching opencode's approach) as the primary signal. Falls back to the catalog's ``supported_endpoints`` only for models not covered by the pattern check. NrrMchat_completionscodex_responsesc3NK|]}|dk|V dSrNrrMr~rs rArz)copilot_model_api_mode..^ 7WWt$((4..J:V:Vd:V:V:V:VWWrCch|]D}t|#t|ESrIrrs rArKz)copilot_model_api_mode..` sR###x==&&((#H ##%%###rCrrranthropic_messages)rrTr^rrVrZr[)rr r catalog_entryrrs @rAcopilot_model_api_moderiC s7,W===+HgwWWWJ "!!)44!   ,WWWWwWWWY]^^ mT * * ,##!.!2!23H!I!I!OR###  !4449LTg9g9g++  rC)rrrrmrnroct|pd}|sdSd|vr|ddd}tD]}||rdSdS)uInfer Azure Foundry api_mode from a deployment/model name. Returns ``"codex_responses"`` when the model name matches a family that only accepts the Responses API on Azure Foundry (GPT-5.x, codex, o1/o3/o4 reasoning models). Returns ``None`` otherwise — the caller should fall back to the configured/default api_mode (typically ``chat_completions``) so GPT-4o, GPT-4 Turbo, Llama, Mistral, etc. keep working. Intentionally does NOT return ``anthropic_messages``; Anthropic-style Azure endpoints are disambiguated by URL (``/anthropic`` suffix) in ``runtime_provider._detect_api_mode_for_url`` and by the user setting ``model.api_mode: anthropic_messages`` explicitly. rNrrra)rWr r*rsplit!_AZURE_FOUNDRY_RESPONSES_PREFIXESr)r&r$rPs rAazure_foundry_model_api_modern} s jB   % % ' ' - - / /C t czzjja  $4%% >>& ! ! %$$$ % 4rC provider_idct|}t|pd}|r|dvr|S|d}||r|t |dS|S)zJNormalize OpenCode config IDs to the bare model slug used in API requests.r>rrrN)rrWr r*rr)rorrvcurrentrPs rAnormalize_opencode_model_idrr s!+..H(.b!!''))G h&EEE^^^F}}!!&))%s6{{||$$ NrCct|}t||}|sdS|dkr|drdSdS|dkr0|drdS|drdSdSdS) aDetermine the API mode for an OpenCode Zen / Go model. OpenCode routes different models behind different API surfaces: - GPT-5 / Codex models on Zen use ``/v1/responses`` - Claude models on Zen use ``/v1/messages`` - MiniMax models on Go use ``/v1/messages`` - GLM / Kimi on Go use ``/v1/chat/completions`` - Other Zen models (Gemini, GLM, Kimi, MiniMax, Qwen, etc.) use ``/v1/chat/completions`` This follows the published OpenCode docs for Zen and Go endpoints. r`rzminimax-rgrr}rlra)rrrr*r)rorrvrs rAopencode_model_api_modert s"+..H,[(CCIIKKJ "!!=    , , (''!!>!!   + + (''   ( ( %$$!!  rCc t||| sgSd}|t fd|Dd}n0|r.t|}|rt fd|Dd}||d}t |t r|d}t |t r]|d}t |t r3d |D}t t |SgSd |dgD} d | vrgStt|p S) zEReturn supported reasoning-effort levels for a Copilot-visible model.rMNc3NK|]}|dk|V dSrcrrds rArz1github_model_reasoning_efforts.. rerCrc3NK|]}|dk|V dSrcrrds rArz1github_model_reasoning_efforts.. s8!c!c4dhhtnnXbFbFb$FbFbFbFb!c!crCrsupportsreasoning_effortcg|]V}t|#t|WSrIrWr r*)rMefforts rArOz2github_model_reasoning_efforts.. s^***"v;;,,..*F ))++1133***rCch|]V}t|#t|WSrIr{)rM capabilitys rArKz1github_model_reasoning_efforts.. s^   :$$&&  OO ! ! # # ) ) + +   rCr?) rTrrr[rVrZr@fromkeysrXrW) rr rrhfetched_catalogrrxeffortsnormalized_effortslegacy_capabilitiesrs @rAgithub_model_reasoning_effortsr s,HgwWWWJ  MWWWWwWWWY]^^ k4WEEE  k !c!c!c!c?!c!c!ceijjM $((88 lD ) ) #'' 33H(D)) C",,'9::gt,,C**&-***&   .@ A ABBBI  +//CC    1 1 1I 1#h6L*2M2M N NNrCapi_modec|pdd}|sddddddSt|r#t||}|tt dddS|dr|ddd}n|dz}|dfg}|r||kr||d fg}d ti} |r|d kr || d <d | d<n |rd|| d<| t r!| t|D]\} } | ddz} || tj | | } tj | |5}t!j|}d|dgD| | d|| kr|n|| dcdddcS#1swxYwY #t*$rYwxYwd|r|dn|ddz|||kr|ndddS)a8Probe a ``/models`` endpoint with light URL heuristics. For ``anthropic_messages`` mode, uses ``x-api-key`` and ``anthropic-version`` headers (Anthropic's native auth) instead of ``Authorization: Bearer``. The response shape (``data[].id``) is identical, so the same parser works for both. rrNF)rT probed_urlresolved_base_urlsuggested_base_url used_fallbackrFrrTrrgrrrrrr rrc:g|]}|ddSrHrrLs rArOz$probe_api_models..1 s$MMM1quuT2MMMrCr_r)r rrrrrrrrrupdaterrrrrrrrrr[r^)rrrrrrTalternate_baser0triedrcandidate_base is_fallbackrrrr_s rAprobe_api_modelsr sO.b''))0055J  !#"&"    "*-- %gwGGG,!1"&"    5!!,#CRC//44#e++5u*=)>J2.J66>40111E+-?@G78333& '3#$$ 7#6W#6#6 -..2.00111'1# ##C((94 Sn$$S'$:: ''W'== z$))++"4"4"6"677MM8L8LMMM"%)7)>)>s)C)C->s-C-Ci-O'0>*0L0LnnRV   s7Fetch available language models with tool-use from AI Gateway.AI_GATEWAY_API_KEYrNrrrrr r)rrrrcg|]Q}|dr:|ddkr!d|dpgvI|dRS)rrlanguageztool-usetagsrrLs rArOz,_fetch_ai_gateway_models..V sk55;;EE&MMZ//155==#6B77 $877rCr_)rrr rrrrrrrrrrrrr[r^) rrrrrrrrr_s rArrC si,b117799G ty.3399;;H '888888& //#   *C,7,,(G . g 6 6C  ^ # #C # 9 9 T:diikk002233D&"--                   tts7$!D7AD* D7*D..D71D.2D77 EEcNt||||dS)zFetch the list of available model IDs from the provider's ``/models`` endpoint. Returns a list of model ID strings, or ``None`` if the endpoint could not be reached (network error, timeout, auth failure, etc.). )rrrT)rr[)rrrrs rArra s* GXw R R R V VW_ ` ``rCcndD]1}||r|dt| cS2|S)a"Strip :cloud / -cloud suffixes that models.dev appends to Ollama Cloud IDs. The live API uses clean IDs (e.g. 'kimi-k2.6') while models.dev sometimes returns them as 'kimi-k2.6:cloud'. Normalising before the dedup merge prevents duplicate entries in the merged model list. )z:cloudz-cloudN)rr)rsuffixs rA_strip_ollama_cloud_suffixrx sP',,   V $ $ ,Ns6{{lN+ + + + , OrCrc(ddlm}|dz S)z1Return the path for the Ollama Cloud model cache.rget_hermes_homezollama_cloud_models_cache.json)rrrs rA_ollama_cloud_cache_pathr s(000000 ?  ? ??rC ignore_ttlrOptional[dict]c t}|sdSt|d5}tj|}dddn #1swxYwYt |t sdS|d}t |tr|sdS|s7|dd}tj |z tkrdS|S#t$rYnwxYwdS)zLoad cached Ollama Cloud models from disk. Args: ignore_ttl: If True, return data even if the TTL has expired (stale fallback). Nzutf-8)encodingrTrr) rexistsopenrloadrVrZr[r@r_OLLAMA_CLOUD_CACHE_TTLr^)r cache_pathfr_rTrs rA_load_ollama_cloud_cacher sD  -//   "" 4 *w / / / 19Q<vr t|}n#t$rg}YnwxYw|rd?|D|vrddddd St!}t||dd} | r| d }ddd|d |d!|d"d#St||d$d%}d}|r$d&d' fd@|Dz}dddd)|dA|dBd S|dCkrt%}||t|vrddddd St||dd} | rddd| d d |d!| d d"d#St||d$d%}d}|r"d&d' dD|Dz}dddd)|dE|d S|dkrgt'|||} | H|t| vrddddd St|| dd} | rddd| d d |d!| d d"d#SddddF|dGd St'||} | |dHkr dI| D} |t| vrddddd St|| dd} | rddd| d d |d!| d d"d#St|| d$d%}d}|r"d&d' dJ|Dz}dddd|dK|d S|dLkr d dMlm}m}|}||}dN|D}||vrddddd St|t!|d$dO}d}|r"d&d' dP|Dz}dddd)|dQ|dR|d S#t$rYnwxYwt. ||} t|}n#t$rg}YnwxYw|rdS|D|vrddddd St!}t||dd} | r| d }ddd|d |d!|d"d#St||d$d%}d}|r$d&d' fdT|Dz}dddd)|d<|dU|dVd SddddW|dX|dYd S)Za Validate a ``/model`` value for the active provider. Performs format checks first, then probes the live API to confirm the model actually exists. Returns a dict with: - accepted: whether the CLI should switch to the requested model now - persist: whether it is safe to save to config - recognized: whether it matched a known provider catalog - message: optional warning / guidance for the user rr<z openrouter.airSrorFzModel name cannot be empty.)acceptedpersist recognizedmessagec3>K|]}|VdSrG)isspace)rMchs rArz+validate_requested_model.. s* , ,B2::<< , , , , , ,rCz"Model names cannot contain spaces.r?rr)rrzD Set `LM_API_KEY` (or update it) to match the server's bearer token.Nz:Could not reach LM Studio's `/api/v1/models` to validate `z`.zDLM Studio is reachable but no chat-capable models are loaded. Load `u<` in LM Studio (Developer tab → Load Model) and try again.TzModel `z-` was not found in LM Studio's model listing.r(rg)rrTrg?)ncutoffzAuto-corrected `u` → ``)rrrcorrected_modelrrg?z Similar models: z, c3"K|] }d|dV dSrNrIrMss rArz+validate_requested_model..c +DcDcRSXXXXDcDcDcDcDcDcrCzNote: `z9` was not found in this custom endpoint's model listing (rzE). It may still work if the server supports hidden or aliased models.rz1 Endpoint verification succeeded after trying `rz)`. Consider saving that as your base URL.z?Note: could not reach this custom endpoint's model listing at `z`. Hermes will still save `z=`, but the endpoint should expose `/models` for verification.z Many Anthropic-compatible proxies do not implement the Models API (GET /v1/models). The model name has been accepted without verification.rz0 If this server expects `/v1`, try base URL: `>rmrlc3"K|] }d|dV dSrrIrs rArz+validate_requested_model.. rrCrlrArBz` was not found in the z[ model listing. It may still work if your account has access to a newer or hidden model ID.>rrc8i|]}||SrIrZrLs rArRz,validate_requested_model.. s"BBBaQWWYYBBBrCc30K|]}d|dVdSrrIrMr catalog_lowers rArz+validate_requested_model.. s6DrDrabE\WXIYE\E\E\DrDrDrDrDrDrrCz'` was not found in the MiniMax catalog.z MiniMax does not expose a /models endpoint, so Hermes cannot verify the model name. The model may still work if it exists on the server.rc3"K|] }d|dV dSrrIrs rArz+validate_requested_model.. rrCzn` was not found in Anthropic's /v1/models listing. It may still work if you have early-access or snapshot IDs.zNote: could not verify `z` against this endpoint's model listing. Many Anthropic-compatible proxies do not implement GET /v1/models. The model name has been accepted without verification.rwcg|]E}t|tr,|dr|tddn|FS)zmodels/N)rVrWrrrLs rArOz,validate_requested_model..9s]'1C&8&8[Q\\)=T=T[#i..//""Z[rCc3"K|] }d|dV dSrrIrs rArz+validate_requested_model..YrrCz1` was not found in this provider's model listing.r)discover_bedrock_modelsresolve_bedrock_regionch|] }|d SrrIrLs rArKz+validate_requested_model..ps:::!ag:::rCg?c3"K|] }d|dV dSrrIrs rArz+validate_requested_model..}rrCz/` was not found in Bedrock model discovery for zK. It may still work with custom inference profiles or cross-account access.c8i|]}||SrIrZrLs rArRz,validate_requested_model..s">>>!A>>>rCc30K|]}d|dVdSrrIrs rArz+validate_requested_model..sMAA,-'M!$'''AAAAAArCz: curated catalog and the /models endpoint was unreachable.z9 The model may still work if it exists on the provider.zNote: could not reach the z API to validate `z:`. If the service isn't down, this model may not be valid.)r rrTrHrrr'rrrr[rrr<r^r*r@r\rrrrrr)r&rvrrr requestedrrequested_for_lookuprrTr!probe api_modelsrh suggestionssuggestion_textrcatalog_modelsrkcatalog_lower_list correctedanthropic_modelsrrregion discovereddiscovered_idsrs @rAvalidate_requested_modelr s(!r((**I#H--J\!!h!?(3R3R $Y9        4     , ,) , , ,,, ;    Z------ *7XNNNFF   !e5```        >!e5eXaeee  !e5e&eee  3v;; . . $TVZ[[ [%uYYYY   X!6!6y!A!A + + +$WhJJJEE$Wh77EYYx((  !#s:66 $#"&# %%9:SVWWWD  $#"&'+AwN)NNDGNNN ,IzQsSSSK O d"8499DcDcWbDcDcDc;c;c"c%)%%IIl++%%"%%  yy)) >SfIgIg>>> !#"   peiiXdNeNe p p'0 p p p  + + + \ G 99) * * n m599UiKjKjmmm mG!$88    222 / ;;NN   NNN  #s>':'::: $#"&# %%9>QWZ[[[D  $#"&'+AwN)NNDGNNN ,,@.TU^abbbK O d"8499DcDcWbDcDcDc;c;c"c/9^/K/K^^QzN #)i))))&))   ... / ;;NN   NNN $ BB>BBBM#))++}<< $#"&# "&m&8&8&:&:!;!; $%9%?%?%A%ACUYZcfgggD )$q'2 $#"&'0P)PPIPPP ,,@,F,F,H,HJ\`ajmnnnK O s"8499DrDrDrDrfqDrDrDr;r;r"r #OiOO&OOO   $[  244  '#s+;'<'<<< $#"&#  %%9;KqY\]]]D  $#"&'+AwN)NNDGNNN ,I7G1UXYYYK O d"8499DcDcWbDcDcDc;c;c"c !#)i))&))   '''%gx(KKK  !#s:66 $#"&#  %%9:SVWWWD  $#"&'+AwN)NNDGNNN )9)))   "'844J  ! !#J 3z?? 2 2!"  %%9:SVWWWD  $#"&'+AwN)NNDGNNN ,IzQsSSSK O d"8499DcDcWbDcDcDc;c;c"c%)%%"%%    Y  ] ] ] ] ] ] ] ]++--F0088J::z:::NN** $#"&# ,ItN7K7KqY\]]]K O d"8499DcDcWbDcDcDc;c;c"c #)i))X^))&))       D &))*jAAN+J77 ' >>~>>>  % % ' '= 8 8 "   "-"4"4"6"677 & & ( (*<#     %d1g.I "#,LiLL LLL  ( & & ( (*<#     4tyyAAAA1<AAA88ON)NNNNNZ?[.. [=<[=)r9r:)rFr:r9r:)rrWrrr9rr:)rrWrrWr9r)rrr9r)rr:rrrrr9r) rr:rrrrWrrr9r)r9r)rr)rrWrrrrr9r)r9rW)rrr9r#) r'rrr(rrWrrr9r#)rvrWr9rW)rrr9r)r~rr9r)r)rrrrr9r3)rrr9r:)rrWr9rW)rr) rTr3rrrrWrrWr9r:)Nrr) rrrrWrrrrr9r)rrrrr9r)r9r)rvrWrrr9r)r9r )r$rWr%rWr9r)rvr#rrr9r3)rvrWr9r )rCrWrDr r9r)rCrWrJr r9rK)r&rWr%rWr9rK)r&rWr9r#)rvr#r9rW)rr#r9r)rrWr9rW)rr#r9r~)rvrWrr:r9r:)rvr#rrr9r:)r)rrr9r)rrr9r)r9r)r~rr9r)Nr)rr#rrr9rrG)rrWrr#r9r)rr#r9r)rr#r9r#)rr#r9rZ)NNr)rr#rr#rrr9r)rr#rr#rrr9r)rr#rr#rrr9r:)r*) r4rWrr#rr#r+rrrr9r) r4rWrr#rr#rrr9r:)rr#rrr9r)NN)r rrr#r9r )rr#r rrr#r9rW)rrWr9r:)rrWr9r)r&r#r9r#)ror#rr#r9rW)rr#r rrr#r9r:)rN) rr#rr#rrrr#r9r) rr#rr#rrrr#r9r)r9r)rrr9r)rTr:r9r)rr#rr#rrr9r:) r&rWrvr#rr#rr#rr#r9r)__doc__ __future__rrrurllib.requestr urllib.errorrdifflibrpathlibrtypingrrr hermes_clir _HERMES_VERSIONrrrrrWrVr4r;r5r7r8rBrErKrPr`rrrrrrrrrrrrrrr"rr2r4rG_canonical_slugsrDrL_list_providers_for_canonical_pprr display_name_label descriptionrrrr^rrrxr|rrrrrrrrrrrrrrrrrrr\r r#r1rr>rBrI frozensetrOrWr^rcr`rrkrprvrtr{ryrrrrr<rrrrrrrr rrrrr#r'r)r=rDrrQrNrTrXr^rirmrnrrrtrrrrrrrrrrrrIrCrArs#"""""  %%%%%%,,,,,,,,,,5555555?442(111)!E!E!E%>%>%>" !,!,!,!!!!F;?>>>>333$;?>>>>BBBB*###&&&&6p*    p*:   ;p*N))++Op*P$$&&Qp*RSp*XYp*| }p*HIp*R    Sp*d   ep*f   gp*BCp*TUp*bcp*jkp*xyp*D Ep*p*LMp*X   Yp*lmp*x yp*FGp*L Mp*V    Wp*f$$$gp*p   qp*LMp*d   ep*~   p*T   Up*r   sp*N RO p*P  Q p*p*ppppl "N!M4L!M!M!MD$%%%%>>.  >.>.>.>.>.>.H>*  >*>*>*>*>*>*J .22222&&&&z >#&&&&&CEEEEE' ''''''T 1 1 1 1  $ 666666HJ $,M&M@jkk$,M,L@ghh$,M(JABCC$,M*K@z{{ $, M+K@vww $, M.NOO $,M)L@wxx$,M+$MOxyy$,M(M@|}}$,M$&8AMNN$,M(LAABB$,M)$4@uvv$,M-$8@uvv$,M-N@tuu$,M($6@xyy$, M%'>CSTT!$,"M*J@rss#$,$M%E@bcc%$,&M%L@bcc'$,(M-$=@pqq)$,*M"$=@pqq+$,,M)$7?z{{-$,.M)I@]^^/$,0M/$5@{||1$,2M,$5@eff3$,4M.N@xyy5$,6M'J@jkk7$,8M%K@dee9$,:M*K@^__;$,<M.N@rss=$,>M-M@stt?$,@M)MAABBA$,BM/OAXYYC$,DM,$7@STTE$,FM,$9@jkkG$,$$$$T98$7888  IIIIII,,..'' 8' ' '  =m m m !-SX;f#;#;#;""==65#I#IJJJSX&&&&'   D BA-@AAA.P 5P EP EP U P  i P i PYPIP-PP hPXPP MP P !P"##PP$ I%P&9'P()P*w+P,-P./P0\1P2,3P4o5P6o7P8_9P: k;P<;=P>?P@APB >CPD -EPPPF}GPHIPJ lKPLMPN JOPPQPRJSPTUPV iWPX IYPZY[P\<]P^%_P`'aPb -cPdMePf}gPPPhiPjkPl HmPn8oPp!qPr"sPt'uPv%wPx 9yPz9{P|i}P~ iP@ EAPB+CPDEPF+GPHkIPPJ   "_PPPf ' ' ' '4A AAAAAAH(-TTTTTT 2222$E EEEEEEP38TTTTTT8:99996 ;;;;;~/0  000000h/ //////d7777 H....,FK<8 888888zC   c  " "##$X))))X!(!(!(!(H      %%%%%%2//// " ??? ----`0000f$$$$N69999FFFF&/ Q Q Q Q,QQQQ 4444"(((($7777P)2 333))&""""JJOZZZZZZzEEEEEP    $<58     L*,++++%(((((!"""""J""/////f""@""0 B!B!B!B!B!P" BFFFFF$L$$$ $ i $ 9 $9$X$-$$l$$$l$l$  !2!$""#6#$$"3#6"4 ),*,*!2#6#4#6"4G$$$P/3!     $/3! &&&&&&R@@@@(/3! &&&&&&b%!:    J/3! )O)O)O)O)O)O^" KKKKK\B" a a a a a(    @@@@ 496    ""@ @@@@@@N""" XXXXXXXXs.BP//P76P7