iUdZddlmZddlZddlZddlmZddlmZm Z m Z ddl m Z m Z mZmZmZddlmZddlmZmZmZmZmZejeZd Zejd ejZdddZ dedZ!Gdde Z"ide"ddde"ddde"ddde"ddde"ddde"ddde"ddd e"dd d!e"dd!d"e"d#d"d$e"d$d%d&e"d'd&d(e"d)d(d*e"d*d*d+e"d+d+d,e"d-d,d.e"d/d.e"d0d1e"d2d3e"d4d5e"d6d7d8Z#d9e$d:<Gd;d<ia'd=e$d?<dfd@Z(dgdBZ)eGdCdDZ*eGdEdFZ+dhdIZ,didMZ- djdkdTZ. dldmdWZ/ dndod^Z0 dpdqdcZ1dS)ruShared model-switching logic for CLI and gateway /model commands. Both the CLI (cli.py) and gateway (gateway/run.py) /model handlers share the same core pipeline: parse flags -> alias resolution -> provider resolution -> credential resolution -> normalize model name -> metadata lookup -> build result This module ties together the foundation layers: - ``agent.models_dev`` -- models.dev catalog, ModelInfo, ProviderInfo - ``hermes_cli.providers`` -- canonical provider identity + overlays - ``hermes_cli.model_normalize`` -- per-provider name formatting Provider switching uses the ``--provider`` flag exclusively. No colon-based ``provider:model`` syntax — colons are reserved for OpenRouter variant suffixes (``:free``, ``:extended``, ``:fast``). ) annotationsN) dataclass)List NamedTupleOptional)custom_provider_slugdetermine_api_mode get_label is_aggregatorresolve_provider_full)normalize_model_for_provider)ModelCapabilities ModelInfoget_model_capabilitiesget_model_infolist_provider_modelszNous Research Hermes 3 & 4 models are NOT agentic and are not designed for use with Hermes Agent. They lack the tool-calling capabilities required for agent workflows. Consider using an agentic model instead (Claude, GPT, Gemini, DeepSeek, etc.).z&(?:^|[/:])hermes[-_ ]?[34](?:[-_.:]|$) model_namestrreturnboolcX|sdStt|S)zReturn True if *model_name* is a real Nous Hermes 3/4 chat model. Used to decide whether to surface the non-agentic warning at startup. Callers in :mod:`cli.py` and here should go through this single helper so the two sites don't drift. F)r_NOUS_HERMES_NON_AGENTIC_REsearchrs 5/root/.hermes/hermes-agent/hermes_cli/model_switch.pyis_nous_hermes_non_agenticrKs. u +22:>> ? ??c2t|rtSdS)zHReturn a warning string if *model_name* is a Nous Hermes 3/4 chat model.)r_HERMES_MODEL_WARNINGrs r_check_hermes_model_warningr!Ws!*--%$$ 2rc(eZdZUdZded<ded<dS) ModelIdentityz:Vendor slug and family prefix used for catalog resolution.rvendorfamilyN__name__ __module__ __qualname____doc____annotations__rrr#r#cs(DDKKKKKKKKrr#sonnet anthropicz claude-sonnetopusz claude-opushaikuz claude-haikuclaudegpt5openaizgpt-5gptcodexo3o4geminigoogledeepseekz deepseek-chatgrokzx-aillamaz meta-llamaqwenminimaxnemotronnvidiakimi moonshotaizz-aiglmstepfunstepxiaomimimozarcee-aitrinity)rCrErGrHzdict[str, ModelIdentity] MODEL_ALIASESc2eZdZUdZded<ded<ded<dS) DirectAliasz5Exact model mapping that bypasses catalog resolution.rmodelproviderbase_urlNr&r,rrrKrKs1??JJJMMMMMMMMrrKdict[str, DirectAlias]_BUILTIN_DIRECT_ALIASESDIRECT_ALIASESc tt} ddlm}|}|d}t |tr|D]\}}t |ts|dd}|dd}|dd}|r9t||| || <n#t$rYnwxYw|S) aoLoad direct aliases from config.yaml ``model_aliases:`` section. Config format:: model_aliases: qwen: model: "qwen3.5:397b" provider: custom base_url: "https://ollama.com/v1" minimax: model: "minimax-m2.7" provider: custom base_url: "https://ollama.com/v1" r) load_config model_aliasesrLrrMcustomrN)rLrMrN) dictrPhermes_cli.configrSget isinstanceitemsrKstriplower Exception) mergedrScfg user_aliasesnameentryrLrMrNs r_load_direct_aliasesrcs)) * *F 111111kmmww// lD ) ) +1133   e!%.. '2.. 99Z:: 99Z443>#h444F4::<<--//0      MsC'C>> D  D Nonec4tstadSdS)z&Lazy-load direct aliases on first use.N)rQrcr,rr_ensure_direct_aliasesrfs% 0-//00rceZdZUdZded<dZded<dZded<dZded <dZded <dZ ded <dZ ded <dZ ded <dZ ded<dZ ded<dZded<dZded<dZded<dZded<dS)ModelSwitchResultz!Result of a model switch attempt.rsuccessrr new_modeltarget_providerFprovider_changedapi_keyrNapi_mode error_messagewarning_messageprovider_labelresolved_via_aliasNzOptional[ModelCapabilities] capabilitieszOptional[ModelInfo] model_info is_global)r'r(r)r*r+rjrkrlrmrNrnrorprqrrrsrtrur,rrrhrhs++MMMIO"""""GHHMON     04L4444&*J****IrrhcVeZdZUdZded<dZded<dZded<dZded<dZded <d S) CustomAutoResultz?Result of switching to bare 'custom' provider with auto-detect.rrirrrLrNrmroN) r'r(r)r*r+rLrNrmror,rrrwrwsaIIMMMEOOOOHGMrrwraw_argstuple[str, str, bool]cd}d}d|vr*d}|dd}|}d}g}|t|krf||dkr'|dzt|kr||dz}|dz }n ||||dz }|t|kfd |}|||fS) aParse --provider and --global flags from /model command args. Returns (model_input, explicit_provider, is_global). Examples:: "sonnet" -> ("sonnet", "", False) "sonnet --global" -> ("sonnet", "", True) "sonnet --provider anthropic" -> ("sonnet", "anthropic", False) "--provider my-ollama" -> ("", "my-ollama", False) "sonnet --provider anthropic --global" -> ("sonnet", "anthropic", True) Frz--globalTrz --provider )replacer[splitlenappendjoin)rxruexplicit_providerpartsifiltered model_inputs rparse_model_flagsrsIX ##J3399;; NN  E AH c%jj.. 8| # #AE (:(: %a!e  FAA OOE!H % % % FA c%jj..((8$$**,,K *I 66r raw_inputcurrent_providerOptional[tuple[str, str, str]]c|}tt|}||j|j|fStD]3\}}|j|kr|j|j|fcS4t|}|dS|\}}t|} | sdSt|} | D]~} | } | r6|d|} | | r|| |fcSN|}| |r|| |fcSdS)aResolve a short alias against the current provider's catalog. Looks up *raw_input* in :data:`MODEL_ALIASES`, then searches the current provider's models.dev catalog for the first model whose ID starts with ``vendor/family`` (or just ``family`` for non-aggregator providers). Returns: ``(provider, resolved_model_id, alias_name)`` if a match is found on the current provider, or ``None`` if the alias doesn't exist or no matching model is available. N/) r[r\rfrQrXrMrLrZrIrr startswith)rrkeydirect alias_namedaidentityr$r%catalog aggregatormodel_id mid_lowerprefix family_lowers r resolve_aliasr.s //   ! ! # #C    $ $F s33 )..0077 B 8>>  s " "K:6 6 6 6 #  %%HtNFF##344G t/00J 9 9NN$$  9))))//11F##F++ 9((C8888 9"<<>>L##L11 9((C8888 9 4rruser_providersrVcustom_providers list | None list[str]cf t|||d}d|DS#t$rgcYSwxYw)uReturn slugs of providers that have credentials. Uses ``list_authenticated_providers()`` which is backed by the models.dev in-memory cache (1 hr TTL) — no extra network cost. r)rrr max_modelscg|] }|d S)slugr,).0ps r z4get_authenticated_provider_slugs..|s---a& ---r)list_authenticated_providersr])rrr providerss r get_authenticated_provider_slugsrksa 0-)-    .-9----  s ! 00r,authenticated_providerscD|pd}|D]}t||}||cSdS)zTry to resolve an alias on the user's authenticated providers. Falls back to ``("openrouter", "nous")`` only when no authenticated providers are supplied (backwards compat for non-interactive callers). ) openrouternousN)r)rrrrMresults r_resolve_alias_fallbackrsF(A+AIy(33  MMM  4rF current_modelcurrent_base_urlcurrent_api_keyrurc  ddlm} m} m} ddlm} d} |}|}|rt|||}|[d|d} ddlm }|}|r|d z }|dd D]}|d |j z }n#t$rYnwxYwtd || S|j }|sr|jrGddlm}||j}|r|}nPtd ||j|d|jd|jd|Std ||j|d|jd|St#||}||\}}} nEt#||}|%|\}}} t$d| ||nL|}|t*vr{t-|||}t/||}|$|\}}} t$d| ||nt*|}td |d|d|jd|jd S|d}|dkrd|vrt7|rt|d|}||dzd}|r%|r#|d|}t$d||t7|r| st9|} | rs|}!| D]}"|"|!kr|"}n?| D];}"d|"vr5|"dd\}}#|#|!kr|"}n<|pd}$|dvpd |$vpd!|$v}%||kr|%s| s| ||}|r|\}}||k}&t=|}'|d"rt|||}(|(|(j}'|})|}*d}+|&s|r | |#},|, d$d})|, d%d}*|, d&d}+n#t$r$}-td ||'|d'|'d(|-cYd}-~-Sd}-~-wwxYw | |#},|, d$d})|, d%d}*|, d&d}+n#t$rYnwxYw| r fallback c. On aggregator, try vendor/model slug conversion d. Aggregator catalog search e. detect_provider_for_model() as last resort f. Resolve credentials g. Normalize model name for target provider Finally: h. Get full model metadata from models.dev i. Build result Args: raw_input: The model name (after flag parsing). current_provider: The currently active provider. current_model: The currently active model name. current_base_url: The currently active base URL. current_api_key: The currently active API key. is_global: Whether to persist the switch. explicit_provider: From --provider flag (empty = no explicit provider). user_providers: The ``providers:`` dict from config.yaml (for user endpoints). custom_providers: The ``custom_providers:`` list from config.yaml. Returns: ModelSwitchResult with all information the caller needs. r)detect_provider_for_modelvalidate_requested_modelopencode_model_api_mode)resolve_runtime_providerrNzUnknown provider 'z`'. Check 'hermes model' for available providers, or define it in config.yaml under 'providers:'.)validate_config_structureu1 Run 'hermes doctor' — config issues detected:u • F)riruro)_auto_detect_local_modelzNo model detected on z (z@). Specify the model explicitly: /model --provider )rirkrqruroz Provider 'zN' has no base URL configured. Specify a model: /model --provider zAlias '%s' resolved to %s on %s)rrrz,Alias '%s' resolved via fallback to %s on %szAlias 'z ' maps to rz] but no matching model was found in any provider catalog. Try specifying the full model name.:r{z3Converted vendor:model '%s' to aggregator slug '%s')rUlocal localhostz 127.0.0.1zcustom:) requestedrmrNrnz,Could not resolve credentials for provider 'z': zno-key-required)rmrNT)acceptedpersist recognizedmessagerrz Invalid model)rirjrkrqrurocorrected_model> opencode-go opencode-zenopencodez | ) rirjrkrlrmrNrnrprqrrrsrtru)*hermes_cli.modelsrrrhermes_cli.runtime_providerrr[r rWrrr]rhidrNrrarloggerdebugr\rIrrr$r%findr rrr rrXrfrQr r rrrr!r)5rrrrrrurrrrrrrresolved_aliasrjrkpdef _switch_errr _cfg_issues_cirdetected alias_result_rauthedfallback_resultr colon_posleftrightrnew_model_lowermidbare_base is_customrlrq custom_pdefrmrNrnruntimee_da validationmsgrsrtwarnings hermes_warns5 r switch_modelrs ` EDDDDDN!!I&O Y6$      <6%6666   GGGGGG7799 @#XXK*2A2@@#'?#+'?'??     $#)  ' } PPPPPP33DMBB  (II, %(7'+y"+pDIpppp\mpp    )!$3#'9'_TY__K\__    %Y@@  #+7 (Ay.%Y0@AA  #9E 6OY LL1 ?     //##))++Cm##9%5#1%5 #:)V"L"L".AP>OYLLF& ? -S1H, %"+CcCCX_CCxCCC &NN3// q==S %9%9mL\>]>]%9$ZiZ06688>>@@D%i!mnn5;;==E'+$5$5e$5$5  Q%y  ) ) &. &*?;;G &"+//"3"3" & &Cyy{{o55$' 6 '&&#::&)iiQ&7&7GAt#zz||>>,/ %!&B$(;; 5 8K5$8  / / / 0" 010>* % %  nnY88 +)     ~~'((201 TTT**?IFF A%ox@@*/9EEL ;;JH~~i  / 9-...-i88K% $$$ ')08@ 8,,,b%)!   sV1A88 BBAP QP;5Q;QAR R R 2TTTrint List[dict]c CddlCddlm}m}m}ddlm}ddlm}m } g} t} |} t| } d|D| d<d| vr | d| d<| D]1\}}| |}t|ts1| |}|r|jrt!|j}n,| d g}t|t st#Cfd |D}|s| |g}t%|}|d|}|}||}|r|jn|}| ||||kp||kd ||d d | |3ddlm}ddlm}d| D}| D]\}}|| vr | ||}|| vr&d }|jr t#Cfd|jD}|sT|jdkrI||fD]D} | | }!|!r+|!jr$t#Cfd|!jDrd}nE|s ddlm}"|"}#|# di}$|# di}%|#r||$vs ||$vs||%vs||%vrd}n3#t6$r&}&t8d||&Yd}&~&nd}&~&wwxYw|s\ ddlm}'|'|}(|( rd}n3#t6$r&}&t8d||&Yd}&~&nd}&~&wwxYw|s|dkr ddl!m"})m#}*|*}+|)},|+r|+ ds|,r|, drd}n2#t6$r%}&t8d|&Yd}&~&nd}&~&wwxYw|s| |gp| |g}t%|}|d|}| |tI|||kp||kd ||dd | || | ddlm%}-n#tL$rg}-YnwxYw|-D]y}.|.j'| vr | |.j'}/d }0|/r'|/jr t#Cfd |/jD}0|0sd ddlm}"|"}1|1 di}2|1 di}3|1r|.j'|2vs |.j'|3vrd}0n#t6$rYnwxYw|0s> ddlm}'|'|.j'}4|4 rd}0n#t6$rYnwxYw|0s| |.j'g}5t%|5}6|5d|}7| |.j'|.j(|.j'|kd |7|6d!d | |.j'{|r;t|tr%| D]\}8}9t|9ts|9 d"d#p|8}|9 d$d#p|9 d%d#pd#}:|9 d&d#};g}<|;r|<|;|9 d'g}=t|=t r |=D]}>|>r|>|| |8||8|kd|<|.sAAAVS!SAAArrrenvc3LK|]}j|VdSNenvironrXrevoss r z/list_authenticated_providers..2s1>>r r**>>>>>>rFzbuilt-in)rra is_currentis_user_definedmodels total_modelssource)HERMES_OVERLAYSci|]\}}|| Sr,r,)rkvs r z0list_authenticated_providers..QsGGG1q!GGGrc3LK|]}j|VdSrrrs rrz/list_authenticated_providers.._s1PP2BJNN2..PPPPPPrrmc3LK|]}j|VdSrrrs rrz/list_authenticated_providers..es1NN"2:>>"--NNNNNNrT)_load_auth_storercredential_poolz"Auth store check failed for %s: %s) load_poolz'Credential pool check failed for %s: %sr.)read_claude_code_credentialsread_hermes_oauth_credentials accessTokenz)Anthropic external creds check failed: %shermes)CANONICAL_PROVIDERSc3LK|]}j|VdSrrrs rrz/list_authenticated_providers..s1YYr r 2 2YYYYYYr canonicalrarapiurl default_modelrz user-config)rrarrrrrapi_url) OrderedDictrN)rarrrLrc&|d |d fS)Nrrr,)rs rz.list_authenticated_providers..>sAlO 3a6G5GHr)r).ragent.models_devrrrhermes_cli.authrrrrsetrVrZrXrYapi_key_env_varslistanyrraraddhermes_cli.providersrextra_env_vars auth_typerr]rragent.credential_poolr has_credentialsagent.anthropic_adapterr r r r ImportErrorrlabel collectionsrr[rsort)Drrrrrr _mdev_pinforrrresults seen_slugsdatacurated hermes_idmdev_idpdatapconfigenv_vars has_creds model_idstotaltoprpinfo display_namer_auth_registry_mdev_to_hermespidoverlay hermes_slug_keypcfgrstoreproviders_store pool_storeexcr poolr r  hermes_credscc_creds _canon_provs_cp _cp_config _cp_has_creds _cp_store_cp_providers_store_cp_pool_store_cp_pool _cp_model_ids _cp_total_cp_topep_nameep_cfgrr models_list cfg_modelsmrgroupsrbgrprsD @rrrs .III 211111EEEEEEEEGeeJ    D%))9$:$:GAA/@AAAGL W!,/5::<<'' 7!!%&&   $'' 22  w/ G455HHyy++Hh-- >>>>X>>>>>   KK 2.. I  $ G$$%*7uzz  "22QgAQ6Q$!       t544444CCCCCC HG(>(D(D(F(FGGGO'--//X$X$ W *   &))#s33 * $ $   ! QPPPP9OPPPPPI W.);;k*  %))$//D1NNNN8MNNNNN$(   M M<<<<<<((**"'))K"<"<"YY'8"== %?**k_.L.Lj((K:,E,E $I M M M A3LLLLLLLL M  Z Z;;;;;; y--''))% $I Z Z Z F UXYYYYYYYY Z O[K77 O =<>> 7799 %\%5%5m%D%D%%!)m!11$(M      ;;;;;;$9SX..++--)$(M       CHb11  &&   ,HI(&66$%!      sx    *^T::-3355  OGVfd++ !::fb11>*!+++++++6;==% = =EeT** !IIf--3::<>M =fTl86L!L!Lt X&--m<<< ! !ID#z!! NNF "&66#'h- #CM 2 2'y>      NN4  LLHHLIII NsAK## L-LL'M M1 M,,M1=A O  O9O44O9&R-- R<;R<AU)) U65U6<,V)) V65V6)rrrr)rrrr)rrO)rrd)rxrrry)rrrrrr)rNN)rrrrVrrrr)r,)rrrrrr)rrFrNN)rrrrrrrrrrrurrrrrVrrrrh)rNNr) rrrrVrrrrrr)2r* __future__rloggingre dataclassesrtypingrrrr rr r r r hermes_cli.model_normalizer rrrrrr getLoggerr'rr compile IGNORECASErrr!r#rIr+rKrPrQrcrfrhrwrrrrrrr,rrrcsj(#""""" !!!!!!----------  8 $ $- )bj-M @ @ @ @J 1+ {O<<1+ {M::1+ {N;; 1+  {H55 1+ x111+ x//1+ x111+ x..1+ x..1+ x221+$z?;;%1+* vv..+1+0 |W5511+6 vv..71+<y)44=1+Bx44C1+H |V44I1+Nvu--y&11x00z955a1+1+1+ 1111x*354444*,++++!!!!H0000  &  "7"7"7"7R::::|$(0*,2$(WWWWW~ $( LLLLLLLr