+ iHju raRtt0tRt^RIt^RIt^RIt^RIt^RIt^RIt^RIH t ^RI H t ^RI H t HtHtHtHt^RIHtHt^RIHt^RIt]P0!]4tRtRtRt/s]^k^s]^k^s ]^k]PB!4t"]PB!4t#R s$] !R R 44t%] !R R 44t&] !RR44t'/RRbRRbRRbRRbRRbRRbRRbRRbRRbRRbRRbRRbRRbRRbR R bR!R!bR"R"b/R#R"bR$R%bR&R'bR(R)bR*R*bR+R,bR-R.bR/R/bR0R1bR1R1bR2R2bR3R2bR4R4bR5R5bR6R7bR7R7bR8R8bCR9R9R:R:R;R;RR?lt*R@RAlt+RBR/RCRDllt,RBR/RERFllt-].!4t/]^kRBR/RGRHllt0RIRJlt1RKRLlt2RMRNlt3RRORPllt4RQRRlt5RSRTlt6RURVlt7RWRXlt8RYRZlt9R[R\lt:R]R^lt;R_R`lt4t?RfR /RgRhllt@RiRjltARkRlltBRmRa/RnRolltCRpRqltDRrRsltERtRultFRvRwltGRxRyltHRRzR{/R|R}llltIR~RltJRRltKRzR RBR/RRlltL]M!R04tNRRltORR{RRa/RRlltPRRRlltQRRltRRRltSRzR /RRlltT].!4tU]^kRRR/RR{/tV]^kRRRRR/RRRR.RR./RR{RR{RR/tW]^kRRRRRR/RRRR.RR./RR{RR{RR/R]WR]WR]WR]W/tX]^ kRBR/RRlltYRBR/RRlltZRBR/RRllt[RBR/RRllt\RBR/RRllt]RRlt^RRlt_RRlt`RRltaRRltbRBR/RRlltcRRltdRRlteRBR/RRlltfRRltgRzR RBR/RRllthRzR{/RRllti]P!R]P4tl]^ k]M!0Rm4tmRRltnRzR{/RRlltoRRltpRRltqRzR{RBR/RRlltrRzR RBR/RRlltsR#)u-Models.dev registry integration — primary database for providers and models. Resolution: in-memory cache (fresh, or stale served while one background daemon thread refreshes) → disk cache (~/.hermes/models_dev_cache.json, any age) → network only when no cache exists. Failed refreshes back off 5 min process-wide. Refreshes use ETag conditional GET when a servable registry is held. Hot paths pass ``allow_network=False`` and never do I/O. A corrupt/empty disk cache is quarantined, never served as ``{}``. ``models_dev.url`` in config.yaml = mirror.N) dataclassPath)AnyDictListOptionalTuple)atomic_json_writeatomic_write_text)openrouter_variant_basezhttps://models.dev/api.jsoni,Fca]tRt^'toRtRtRtRtRtRt Rt Rt Rt ^t ^tRtRtRtRtRtRtRtRtRtV3RlRltV3RlR ltV3R lR ltV3R lR ltV3RlRltV3RltRtVtR#) ModelInfoz1Full metadata for a single model from models.dev.FNgc <V^8dQhRS[/#returnbool)format __classdict__s"5/home/ubuntu/.hermes/hermes-agent/agent/models_dev.py __annotate__ModelInfo.__annotate__Fs;;t;cNVP^8;'gVP^8#)) cost_input cost_outputselfs&r has_cost_dataModelInfo.has_cost_dataFs$"::d&6&6&::rc <V^8dQhRS[/#rr)rrs"rrrHsCCCrcHVP;'gRVP9#)image) attachmentinput_modalitiesr s&rsupports_visionModelInfo.supports_visionHsBB'T-B-B"BBrc <V^8dQhRS[/#rr)rrs"rrrJs..d.rc RVP9#)pdfr(r s&r supports_pdfModelInfo.supports_pdfJs----rc <V^8dQhRS[/#rr)rrs"rrrLs00d0rc RVP9#)audior.r s&rsupports_audio_inputModelInfo.supports_audio_inputLs$////rc <V^8dQhRS[/#rstr)rrs"rrrNsHHSHrc VPR3VPR3VP4R3VP4R3VP 4R3VP R3VP R33pRPR V44;'gR #) zBHuman-readable capabilities, e.g. 'reasoning, tools, vision, PDF'. reasoningtoolsvisionPDFr3zstructured outputz open weightsz, c3>"TFwrV'gKVxK R#5iN).0onlabels& r 0ModelInfo.format_capabilities..Ts<92s  basic)r: tool_callr)r/r4structured_output open_weightsjoin)r!flagss& rformat_capabilitiesModelInfo.format_capabilitiesNs^^[ )DNNG+DtG[G[G]_gFhkok|k|k~AFkG  & & (' 2T5K5KM`4adhduduxFdG yy<<<GGGrc<V^8dQh/S[;R&S[;R&S[;R&S[;R&S[;R&S[;R&S[;R&S[;R&S[;R &S[;R &S[S[R 3,;R &S[S[R 3,;R &S[;R&S[;R&S[S[,;R&S[;R&S[;R&S[S[,;R&S[S[,;R&S[;R&S[;R&S[;R&S[;R&#)ridnamefamily provider_idr:rGr' temperaturerHrI.r(output_modalitiescontext_window max_output max_inputrrcost_cache_readcost_cache_writeknowledge_cutoff release_datestatus interleaved)r8rtupleintrfloatr)rrs"rrr'sI G I  K   #CHo* S#X+!$%&'(}#),-./0e_+12uo,36789: ;<=rr@) __name__ __module__ __qualname____firstlineno____doc__r:rGr'rSrHrIr(rTrUrVrWrrrXrYrZr[r\r]r"r)r/r4rL__annotate_func____static_attributes____classdictcell__rs@rrr's; IIJK#L(*)+NJ#IJK'+O(,LFK;;CC..00HHOrrc8a]tRt^WtoRtRt^tV3RltRtVt R#) ProviderInfoz-Full metadata for a provider from models.dev.rcv<V^8dQh/S[;R&S[;R&S[S[R3,;R&S[;R&S[;R&S[;R&#)rrOrP.envapidoc model_count)r8r^r_)rrs"rrProviderInfo.__annotate__WsW G I  sCx  H  Mrr@N) rarbrcrdrerorprfrgrhris@rrkrkWs7 CKrrkcHa]tRt^btoRtRtRtRtRtRt Rt V3Rlt Rt Vt R#)ModelCapabilitiesz;Structured capability metadata for a model from models.dev.TN@ rc<V^8dQh/S[;R&S[S[,;R&S[S[,;R&S[;R&S[S[,;R&S[;R&#)rsupports_toolsr)supports_reasoningrUmax_output_tokens model_family)rrr_r8)rrs"rrModelCapabilities.__annotate__bs_d^*  !-    }+rr@)rarbrcrdrervr)rwrUrxryrfrgrhris@rrsrsbs/EN&*O)- N'+Lrrs openrouternovitaz novita-ai anthropicopenaiz openai-apiz openai-codexzaikimizkimi-for-codingz kimi-codingmoonshotstepfunzkimi-coding-cnminimaxz minimax-oauthz minimax-cndeepseekalibabaz qwen-oauthcopilotzgithub-copilotz ai-gatewayvercelz opencode-zenopencodez opencode-gokilocodekilo fireworksz fireworks-ai huggingfacegeminigooglexaiz xai-oauthxiaominvidiazmeta-aimetagroqmistral togetherai perplexitycoherez ollama-cloudcFV^8dQhR\R\\,/#)rmdev_idr)r8list)rs"rrrs44s4tCy4rc\fE/s\P4F*wr\PV.4P V4K, \P V.4#)zAReturn the Hermes provider ids that map to *mdev_id* (may be []).)_MODELS_DEV_TO_PROVIDERPROVIDER_TO_MODELS_DEVitems setdefaultappendget)r hermes_idmappeds& r_models_dev_to_hermes_idsrsU&"$!7!=!=!? I # . .vr : A A) L"@ " & &w 33rcRV^8dQhR\R\\\3,/#)rvaluer)rdictr8)rs"rrrs"44#4$sCx.4rc6\V\4'dV#/#r? isinstancer)rs&r_dict_or_emptyrsud++533rconfigcV^8dQhR\R\\\\3,,R\\,/#rproviderrrr8rrr)rs"rrrs5&tCH~6 c]rcFaT;'gRP4oSP4PR4'dS\R4RoS'd S\9dR#Ve\ RSRVR7M \ RSRR7p\ V4PR4pV'gNVe\ RRVR7M \ RRR7p\V3R l\V\4'dTM.4R4p\T;'gR4P4pT;'gR#) z``catalog_provider`` declared on a custom provider's ``providers.`` row (or legacy ``custom_providers[]`` entry): the catalogued vendor whose models it resells. None when unset.rzcustom:N providersdefaultrrcatalog_providercustom_providersc3<"TFgp\V\4'gK\VPR4;'gR4P 4S8XgKTVPR4xKi R#5i)rPrrN)rrr8rstrip)rAerPs& rrD/_configured_catalog_provider..s^[:dA#At,014QUU6]5H5Hb1I1O1O1QUY1Y0aee.//:dsA2A2A2A2) rlower startswithlenr_cfg_getrrnextrrr8)rrprovider_configaliaslegacyrPs&$ @r_configured_catalog_providerrs NN ! ! #D zz|y))C NO$ 411   dD@ k4 6 ? + / /0B CE ! 'f E,d;  [JvW[D\D\&bd:d[\`b    " " $E ==DrcV^8dQhR\R\\\\3,,R\\,/#rr)rs"rrrs5&tCH~6 c]rcT;'gRP4p\PV4pVf\W!R7pV'd\PWD4MRpVeeV\P 49dLV\ RR79d;W$3\ 9d-\ PW$34\PRW$4RpV#)zmodels.dev provider id for a Hermes provider id, or None. A custom provider reaches the catalog only through its configured ``catalog_provider`` alias (#112649).rNrF allow_networkz_providers.%s: catalog_provider %r is neither a Hermes provider id nor a models.dev id; ignoring) rrrrvaluesfetch_models_dev _UNKNOWN_CATALOG_PROVIDER_WARNEDaddloggerwarning)rrkeyrrs&$ r_models_dev_idrs >>r "C$((-G,S@>C(,,U:  72H2O2O2Q#Q#3%#HH|#CC044c\B 9:=FG Nrc V^8dQhR\R\R\\\\3,,R\/#)rkeysrrr)r8rrr)rs"rrrs6C#xS#X/GSVrch^RIHpHpT!VeTMV!4.VO5RV/# \dTu#i;i)z@``cfg_get`` over the read-only config; *default* on any failure.)cfg_getload_config_readonlyr)hermes_cli.configrr Exception)rrrrrs$$* rrrs@C!3v9M9OhRVh`ghh s ! 11c0V^8dQhR\R\/#)rrPr)r8r)rs"rrrs$$s$t$rc*^RIHpV!4V, #)r)get_hermes_home)hermes_constantsr)rPrs& r _hermes_pathrs0  t ##rc$V^8dQhR\/#rr)rs"rrrs111rc\R4#)zmodels_dev_cache.jsonrr@rr_get_cache_pathr / 00rc$V^8dQhR\/#rr)rs"rrrs111rc\R4#)zmodels_dev_cache.etagrr@rr_get_etag_pathrrrc$V^8dQhR\/#)rwhatr7)rs"rrrs3rcrV!4# \d#p\PRY4TuRp?#Rp?ii;i)zXRun *fn*; on any exception log ``"Failed to : %s"`` at debug and return *default*.zFailed to %s: %sN)rrdebug)rfnrrs&&& r_quietlyrs2t  '1s 6166c$V^8dQhR\/#rr7)rs"rrrsWWCWrc\RRR4#)z,Last-known ETag from disk, or "" if missing.zload models.dev ETagc\4P4'd)\4PRR7P4#R#) utf-8-sigencodingr)rexists read_textrr@rr_load_etag..sXp~qAqHqHqJqJN4D4N4NXc4N4d4j4j4l5RPR5Rrrrr@rr _load_etagrs! *-RTV WWrc(V^8dQhR\RR/#)retagrNr7)rs"rrrs,,S,T,rc2aRV3Rllp\RV4R#)cV^8dQhRR/#rrNr@)rs"rr _save_etag..__annotate__s++4+rcd<\4p^RIHpV!VP4\ VS4R#)r)mkdir_under_hermes_homeN)rrrparentr ) etag_pathrrs rwrite_save_etag..writes&"$ < 0 01)T*rzsave models.dev ETagNr)rrsf r _save_etagrs++  #U+rcV^8dQhRR/#rr@)rs"rrrsXXTXrc \RR4R#)zDelete the ETag sidecar so the next fetch is unconditional: an If-None-Match without a servable cache invites a 304 that leaves the process with no data at all.zclear models.dev ETagc6\4PRR7#)T) missing_ok)runlinkr@rrr_clear_etag..sn.>.E.EQU.E.VrNrr@rr _clear_etagr s $&VWrc$V^8dQhR\/#rr7)rs"rrrsSSSSrc\RRRR7p\V\4'd'VP4'dVP4#\#)zHThe models.dev API URL, honoring the ``models_dev.url`` config override. models_devurlrr)rrr8rMODELS_DEV_URL)rs r_get_models_dev_urlrs7 < 3C$S#..399;;399;RNRrc0V^8dQhR\R\/#)rdatar)rr)rs"rrrs44S4T4rcN\V\4;'d\V4^8#)z8True if *data* is a non-empty dict suitable for serving.)rrrrs&r_validate_registryrs dD ! 3 3c$i!m3rcFV^8dQhR\\\3,/#rrr8r)rs"rrr s$sCx.rcF\4pVP4'dh\VRR7;_uu_4p\P!V4pRRR4\ X4'dV#\ PR4\V4/# +'giLE;i \dxp\ PRT4\P!\4;_uu_4\\44RRR4Rp?/# +'giRp?/#;iRp?ii;i)zLoad the disk cache; a corrupt/empty one is quarantined with a warning so it never masquerades as ``{}`` and breaks provider/model resolution.rrNzSmodels.dev disk cache is corrupt or empty; quarantining (will refetch from network)z6Failed to load models.dev disk cache; quarantining: %s) rropenjsonloadrrr_quarantine_corrupt_cacher contextlibsuppress) cache_pathfrrs r_load_disk_cacher" s 9$&     j;771yy|8!$'' NNp q %j 1 I87 9OQRS   + + %o&7 8, + I, + + I 9sR5BB B) B B B D )8D!D5D D DDD c(V^8dQhR\RR/#)rr rNr)rs"rrrs$4rcVPVPR44\ 4R# \d!p\P RT4Rp?L2Rp?ii;i)uRename a rejected cache aside and drop its ETag sidecar. Renaming makes the rejection a one-time event — otherwise every hot-path call that finds the in-memory cache empty re-parses and re-warns until a network fetch succeeds. The sidecar vouches for a registry we no longer hold.z .json.corruptz1Could not quarantine corrupt models.dev cache: %sN)rename with_suffixrrrr )r rs& rrrsNM*00ABM M H!LLMs . AAAc:V^8dQhR\\,/#rrr`)rs"rrr(s88%8rc&RRlp\RV4#)uAge of the disk cache file in seconds, or None if missing/unreadable. An mtime in the future (clock skew) is also None — unknown freshness — so callers fall through to the network.c:V^8dQhR\\,/#rr()rs"rr-_disk_cache_age_seconds..__annotate__+s))(5/)rc\4pVP4'd5\P!4VP4P, MRpV^8dV#R#)N)rrtimestatst_mtime)r ages rr0%_disk_cache_age_seconds..stat+sI$& :D:K:K:M:MdiikJOO-666SUQhs(D(rzstat models.dev disk cacher)r0s r_disk_cache_age_secondsr4(s) 0$ 77rrcVV^8dQhR\\\3,R\RR/#)rrrrNr)rs"rrr2s)4S>drcRa\RV3Rl4V'd\V4R#R#)zCSave the registry atomically, plus the ETag sidecar when non-empty.zsave models.dev disk cachec2<\\4SRRR7#)N)indent separators),:)r rrsrr"_save_disk_cache..4s3D_EVX\eiwA4BrN)rr)rrsf&r_save_disk_cacher=2s% ),BC 4 rc]tRtRtRtRtR#) _NotModifiedi:uCServer returned 304 Not Modified — existing cache is still valid.r@N)rarbrcrdrergr@rrr?r?:sMrr? conditionalctV^8dQhR\R\\\\3,\3,/#)rr@r)rr^rr8r)rs"rrr>s.2242E$sTWx.Z]J]D^2rcl/pV'd\4;p'dW!R&\P!\4VRR7pVPR8Xd \ 4hVP 4VP4p\V4'g \R4hWCPPRR43#)udFetch the live registry; returns ``(registry, etag)`` (etag "" if none). Raises on network errors and on an empty/invalid payload. ``conditional`` sends ``If-None-Match`` with the sidecar's ETag and raises ``_NotModified`` on 304 — pass True ONLY while holding ``_models_dev_fetch_lock`` AND a servable registry, or a 304 leaves the process with no data.z If-None-Match)headerstimeouti0z0models.dev returned an empty or invalid registryETagr) ) rrequestsrr status_coder?raise_for_statusrr ValueErrorrC)r@rCrresponsers$ r_fetch_models_dev_from_networkrM>s !G ,,#' ||/17GTHs"n  ==?D d # #KLL !!%%fb1 11rcV^8dQhRR/#rr@)rs"rrrQsxxxrcx\\\P!4\, \,4sR#)zGive stale cache data a 5-minute in-memory grace before retrying refresh. Only ever moves the timestamp forward, so a background refresh that completed meanwhile keeps its fresh stamp.N)max_models_dev_cache_timer/_MODELS_DEV_CACHE_TTL_MODELS_DEV_RETRY_DELAYr@rr_mark_stale_cache_gracerTQs$!!7G\9\_v9vwrc^V^8dQhR\R\R\\\3,/#)rmsgargsr)r8rr)rs"rrrXs)c#$sCx.rcf\4\4\P!V.VO5!\#)zKArm the grace window, kick off a background refresh, return the held cache.)rT$_start_background_refresh_models_devrr_models_dev_cache)rVrWs&*r _serve_staler[Xs%(* LLt rrcbV^8dQhR\\\3,R\R\RR/#)rrrwhererNr)rs"rrr`s0  4S> C S T rc \W4Vs\P!4s^s\ P RV\V4\RVP4444R#)zPersist a fetched registry: disk + in-mem + clear backoff. Callers hold ``_models_dev_fetch_lock`` so a failing refresh on one path can never stomp state a succeeding refresh just committed.zARefreshed models.dev registry (%s): %d providers, %d total modelsc3"TF8p\V\4'gK\VPR/44xK: R#5i)modelsN)rrrr)rAps& rrD#_commit_registry..js/ Smz!T?R $Ch# $ $ms A#AN) r=rZr/rQ_models_dev_retry_afterrrrsumr)rrr]s&$$r_commit_registryre`sRT !YY[ LLKUTWX\T] Sdkkm SSrc(V^8dQhR\RR/#)rr]rNr7)rs"rrrnsjj#j$jrc\'gC\4\P!4\,s\ P RV4R#\P!4s^s\ PRV4R#)uAfter a 304: clear backoff and re-mark the held cache fresh (disk is untouched — only the freshness marker advances). Caller holds the lock.zomodels.dev returned 304 but no cached registry is held (%s); cleared ETag sidecar, will refetch unconditionallyNzNmodels.dev registry unchanged (304 Not Modified, %s); cache re-confirmed fresh) rZr r/rSrcrrrQrr]s$r_confirm_cache_not_modifiedrins^    "&))+0G"GLMR T!YY[ LLachirc4V^8dQhR\R\RR/#)rexcr]rN)rr8)rs"rrrs&vvyvCvDvrc~\P!4\,s\P RV\V4R#)z=Arm the process-wide 5-minute backoff. Caller holds the lock.zV8rc|\W4pVeVPR/4MRp\V\4'dV#R#)zM0=0I]  x ,tF--6747rc V^8dQhR\R\R\\\\3,,R\\\\3,,/#)rrrrrr)rs"rrrsLWWW%)W;CDcN;SW d38nWrcF\WR7pV'd \W1R7#R#)uResolve a Hermes provider ID to its models dict, or None if unknown. ``allow_network`` defaults to False — hot-path callers must never block.rrN)rr)rrrrs&$$ r_get_provider_modelsrs" X5GEL G AVRVVrcRV^8dQhR\R\R\\,/#rrmodelr)r8r)rs"rrr s%**c*#*(3-*rc2V\9dR#\V4#)uReturn the base id to retry a catalog lookup with, or ``None``. OpenRouter's ``:nitro`` / ``:floor`` / ``:exacto`` / ``:online`` are request-time routing modifiers: they change which endpoint serves the request, never which model runs. ``/models`` and models.dev list only the base id, so a routed id must resolve to the base model's metadata. Scoped to OpenRouter so a genuine ``model:tag`` on another provider (an Ollama tag, a ``:cloud`` catalog key) is never rewritten. Deliberately excludes ``:free``, ``:batch``, ``:extended``, and ``:thinking``: those are REAL catalog SKUs with their own entries and their own — sometimes different — context windows. Stripping them would report a window LARGER than the model actually has. Their real entries are found by the exact/case-insensitive passes above, and a genuinely absent SKU must miss so ``model_overrides`` ``_default`` fill-gap semantics still apply. N)_OPENROUTER_CATALOG_PROVIDERSr )rrs&&r_openrouter_catalog_lookup_baser s&44 "5 ))rsuffix_fallbackrcjV^8dQhR\\\3,R\R\R\/#)rr`rrrrr8rr)rs"rrr#s4  cN #& <@ SV rc#"V'd!V.RUu.uF qAV,NK up,MV.FpVPV4p\V\4'dWV3xVP4pVP 4F9wrVP4V8XgK\V \4'gK4W3xK; K \ W14p V e\ W VRR7RjxL R#R#uupiL 5i)uYield ``(model_id, entry)`` candidates: exact, case-insensitive, then (optionally) ``:cloud``/``-cloud`` suffixed forms. Suffix fallback: some providers (ollama-cloud) store ``kimi-k2.6:cloud`` while the live API returns the bare name; without it context lookup falls to stale OpenRouter metadata and trips the 64k minimum-context guard. Every consumer shares this order so a suffix-keyed catalog model counts as KNOWN for ``model_overrides`` fill-gap ``_default``. ``provider`` enables the OpenRouter routing-variant fallback as a LAST resort — after exact, case-insensitive, and ``:cloud`` matching — so a real catalog SKU always wins over its base. Nrrr)z:cloudz-cloud)rrrrrr_iter_model_entries) r`rrrsuffixrPentry name_lowermidmdata routed_bases &&$$ rrr#sSb%9MN9MvFNN9MNNhmgnn 4  eT " "+ ZZ\  ,,.JCyy{j(Zt-D-Dj ) o2(BK' 2   O s(C.C'A2C.C.1-C.C,C.c V^8dQhR\\\3,R\R\R\\\\3,,/#)rr`rrr)rr8rr)rs"rrrAsGhh cNh#&h25h d38nhrc >\R\WVR74R4#)zKFirst catalog entry for *model* (exact, case-insensitive, suffix), or None.c3*"TF wrVxK R#5ir?r@)rA_midrs& rrD$_find_model_entry..Es`*_;4*_srN)rr)r`rrs&&&r_find_model_entryrAs! `*=fV^*_`bf ggrcRV^8dQhR\R\R\\,/#)rrrr)rr8rr_)rs"rrrHs*QQ#QCQHSMQrc\\V4PR44PV4p\V\\34'dV^8d \V4#R#)zNPositive int ``entry.limit[key]`` or None (audio/image models have context=0).limitN)rrrr_r`)rrrs&& r_extract_limitrHsL >%044W= > B B3 GE#EC<88UQY3u:PDPrchV^8dQhR\\\3,R\\,/#rrrrr8rrr_)rs"rrrNs&,,DcN,x},rc\VR4#)zFContext length from a models.dev model entry, or None if invalid/zero.context)r)rs&r_extract_contextrNs % ++rc ^V^8dQhR\R\R\R\\,/#)rrrrr)r8rrr_)rs"rrrSs5[[[C[4[\deh\i[rc a\W4pVeV#\\W4R4pVeV#\WR7pVe"\ V3Rl\ WQVR74R4MRpVeV#\ V4#)uContext window in tokens for provider+model, or None if not found. An EXPLICIT ``model_overrides`` entry wins over the catalog; ``_default`` fills the gap only when the catalog has no answer (the self-unblock path for wrong/missing context in models.dev). Catalog entries with context=0 are skipped in favour of later candidates. ``allow_network`` defaults to False — runs every turn. See #84482. NrUrc3V<"TFwr\V4;o'gKSxK R#5ir?)r)rArrctxs& rrD,lookup_models_dev_context..bs@J/d qABGqHjHiljH/ds) )r)_override_context_window _override_int_provider_model_capabilitiesrrr_default_override_context)rrr override_ctx declared_ctxr` catalog_ctxrs&&$ @rlookup_models_dev_contextrSs,H ' 4 ) $$rc V^8dQhR\R\\\\3,,R\\\\3,,/#rr)rs"rrrsF I I I$sCx.9Q I]efjknpsksft]u IrcaVe \VR7M \4oT;'gRP4pS'd V'gR#V\PV4.\ V4Op\ RV3RlV44R4#)zLOverride section for *provider* (keyed by Hermes OR models.dev id), or None.Nrrc3V"TFp\V\4'gKVxK! R#5ir?r)rAsections& rrD-_provider_override_section..s'B(cWgqry{hA(cs) )c3X<"TFq'dSPV4MRxK! R#5ir?)r)rArrs& rrDrs$(cXbQTss);)LXbs'*)rrrrrr)rr provider_key candidatesrs&$ @r_provider_override_sectionrs   V, " $ NN))+L L 6 : :< HsKdeqKrsJ B(cXb(cBDH IIrc V^8dQhR\R\R\\\\3,,R\\\\3,,/#rrrrrr)rs"rrrsQ Q Qs Q3 Q8DQTVYQYNC[ Qgoptuxz}u}p~g Qrc*aT;'gRP4pV'd \WR7MRpVfR#VPV4p\V\4'dV#VP 4o\ V3RlVP44R4#)zuExplicit per-provider+model override dict (exact, then case-insensitive skipping the ``_default`` sentinel), or None.rrNc3<"TFAwrVR8wgKVP4S8XgK%\V\4'gK=VxKC R#5i)_defaultN)rrr)rArr model_lowers& rrD+_explicit_model_override..sMJ:3C:G4Grc V^8dQhR\R\R\R\\\\3,,R\\\\3,,/#)rrr catalog_hitrrr)rs"rrrsVqqqq/3q=Ed3PS8n=Uq d38nqrcP\WVR7pVf V'dV#\WR7#)zGExplicit override if any; else the ``_default`` only on a catalog miss.r)rr)rrrrexplicits&&$$ r _override_forrs)(GH+{8p@WX`@pprctV^8dQhR\\\3,R\R\\,/#)roverriderrr)rs"rrrs-  DcN  # rc~VPV4pVfR#\P!\\4;_uu_4\ V4pV^8d VuuRRR4#RRR4V\ V43pV\9d,\PV4\PRW4R# +'giLU;i)zDCoerce an override field to a positive int, warning once on garbage.NzKmodel_overrides: ignoring invalid %s value %r (expected a positive integer)) rrr TypeErrorrKr_repr_OVERRIDE_WARNED_KEYSrrr)rrrawrwarn_keys&& rrrs ,,s C {   Y 3 3C 19 4 3  4T#YH,,!!(+dfio  4 3s B,, B< cRV^8dQhR\R\R\\,/#rr8rr_)rs"rrrs*KKsK3K8C=Krc<\W4pVe \VR4#R#)a*EXPLICITLY overridden context_window, or None. Explicit-only on purpose: this runs early in the resolution chain (agent/model_metadata.py, before custom_providers and live probes) where a ``_default`` must not preempt more specific sources; fill-gap defaults apply in ``lookup_models_dev_context``.NrU)rr)rrovs&& rrrs% "( 2B24.=- .JdJrcFV^8dQhR\R\\,/#)rrrr)rs"rrrs"UUU Urc<\V4pVe \VR4#R#)zBFill-gap context from a ``_default`` override, for catalog misses.NrU)rr)rrs& rrrs%%h/G7>7J="2 3TPTTrcV^8dQhR\\\3,R\\\\3,\\ ,3,/#)rrr)rr8rr^rr)rs"rrrs;c3hE$sCx.RZ[_R`B`? ]]7+ )3J)E)ET*%2 wj8   g & W %:   g &''(| MM& Mrc V^8dQhR\R\R\\\\3,,R\\\\3,,/#rr)rs"rrrsLVVVV*24S>*BV d38nVrc\WR7;'gT;'gRP4p\PY1;'gRP4P 434#)zSBuilt-in metadata for a provider/model pair, if Hermes has a vendor-specific entry.rr)rr_BUILTIN_MODEL_METADATArr)rrrrs&&$ r_builtin_model_metadatar sQ"(:VVx~~2>T>T>VL " & & {{6I6I6K6Q6Q6S'T UUrc tV^8dQhR\R\R\\\\3,,/#rr)rs"rrr s4 c cC c ccSVh@X crc^RIHpRT;'gRP4P49g V!V4fR#/\CRRRR.R R.//C#) aFill-gap base for an OpenCode Zen/Go ``*-vision*`` model id the catalog does not know. The relays resell vendor previews (``deepseek-v4-flash-vision-exp``) before models.dev indexes them, and the id's ``-vision`` token is the vendor's own capability marker; without it ``image_input_mode: auto`` treats the model as text-only and detours images through the lossy describe path (#96066). Every other field keeps the unknown-model defaults, so only vision is claimed.)opencode_provider_familyz-visionrNrrrr&r)hermes_cli.modelsrrr_UNKNOWN_MODEL_BASE)rrrs&& r_relay_vision_marker_metadatar s[ ;"++-33559QRZ9[9c b! b<'FG;LhY_X`1a bbrc^V^8dQhR\R\R\\\3,/#r)r8rr)rs"rrr-s.TT3TsTtCH~Trcb^RIHpV!V4pVeVPPV/4#/#)aExact-model declaration from the registered ``ProviderProfile.model_capabilities`` (canonical ``model_overrides`` schema). The ONE plugin seam: every consumer that reads models.dev through this module (picker badges, image routing, ``/api/model/info``, context lookup) sees it (#102115).)get_provider_profile)rrmodel_capabilitiesr)rrrprofiles&& rrr-s5/"8,G8?8K7 % % ) )% 4SQSSrc V^8dQhR\R\R\\\\3,,R\\\\3,,R\\\\3,,/#)rrrrrrr)rs"rrr7sgIIII&.tCH~&>IKSTXY\^aYaTbKcI d38nIrc\WVR7pVeTMTp\W4pV'd\VeTM\V4p\ WVRJVR7pVf \ W4pVfV#\VeTM\V4#)zCatalog/builtin metadata, patched by the plugin's declaration, then by the explicit user override. ``_UNKNOWN_MODEL_BASE`` is the base on a catalog miss; a fill-gap ``_default`` applies only when no source knows the model. None when nothing knows it.rN)rr)r rr rrr)rrrrbuiltinbasedeclaredrs&&&$ r_apply_overridesr7s &hfEG%57D+Hrr)rr_GOOGLE_HIDDEN_MODELS)rr.s&&rr+r+s^ NN ! ! # ) ) +/C C B BUWH^H^H`HfHfHhmBIBBrcRV^8dQhR\R\R\\,/#r'r()rs"rrrs%$$#$$c$rc>\WR7pVeVP4UUu.uFiwr4\V\4'gK\ W4'dK0VP RR4'gKJ\ PV4'dKgVNKk upp#.#uuppi)zModel IDs suitable for agentic use: tool_call=True, minus hidden and noise models. [] on any failure. ``allow_network`` defaults to True (called from interactive model selection).rrGF)rrrrr+r_NOISE_PATTERNSsearch)rrr`rrs&$ rlist_agentic_modelsr5s"( HF  %lln ,  eT " +Mh+\ afajajkvx}a~ HWH^H^_bHc n $"$$ sBBB0B BcjV^8dQhR\R\\\3,R\R\/#)rr.rrRr)r8rrr)rs"rrrs0$sCx.syrc!aa\VPR44o\VPR44oRV3RllpRV3Rllp\R RTRVPRR 4;'gTR VPR R 4;'gR R V/R!Uu/uFqU\VPVR 44bK upBR V!R4RV!R4R\ VR4;'g^R\ VR4;'g^R\ VR4R\ SPR^4;'g^4R\ SPR^4;'g^4RV!R4RV!R4RVPRR 4;'gR RVPRR 4;'gR RVPRR 4;'gR RVPRR 4/ B#uupi)"zEConvert a raw models.dev model entry dict into a ModelInfo dataclass.costrcJV^8dQhR\R\\R3,/#)rrr.)r8r^)rs"rr'_parse_model_info..__annotate__s"==3=5c?=rc<SPV4;'g.p\V\4'd \V4#R#)Nr@)rrrr^)rmodsrs& r_mods _parse_model_info.._modss4~~c"((b(t44uT{<"._costs$#'88C=#R b177R GJggn^`FaFgFgeg wwx$** 9< u8U   Ms$G c^V^8dQhR\R\\\3,R\/#)rrRrr)r8rrrk)rs"rrrs)cS#X<rc VPR4;'g.pVPR4;'g/p\YPRR4;'gT\V\4'd \ V4MRVPRR4;'gRVPRR4;'gR\V\ 4'd\ V4R7#^R7#) zAConvert a raw models.dev provider entry dict into a ProviderInfo.rmr`rPrrnro)rOrPrmrnrorpr@)rrkrrr^rr)rRrrmr`s&& r_parse_provider_inforJs ''%.  BC WWX  $ $"F  WWVR0??KS]^acgShShU3Znp GGE2  $ $"#''%*<*B*B_ijprv_w_wPSTZP[ }~ rc V^8dQhR\R\R\\\\3,,R\\ ,/#)rrRrrr)r8rrrrrk)rs"rrrsEKKK(,K=Ed3PS8n=UK lKrcf\WR7;'gTp\W14pVe \W44#R#)zProvider metadata by Hermes or models.dev ID, or None if not cataloged. ``allow_network`` defaults to True (interactive setup).rN)rrrJ)rRrrrrs&$$ rget_provider_inforMs5[8GGKG W 4C14  -JdJrc V^8dQhR\R\R\R\\\\3,,R\\ ,/#)rrRr.rrr)r8rrrrr)rs"rrrsRMMM #M7;MMUVZ[^`c[cVdMeM iMrc \WR7;'gTp\WBR7pVe\\WQRVR7VR34MVR3wrg\ WWsR7pVe \ WhV4#R#)uYFull model metadata by Hermes or models.dev provider ID (exact match, then case-insensitive), or None if not found. EXPLICIT ``model_overrides`` patch known catalog models; ``_default`` fills the gap only for unknown ones. ``allow_network`` defaults to False — cost guard and inventory are hot paths. ``model_overrides`` entries use the SAME canonical schema as every other consumer (``context_window``, ``supports_*``, ``model_family``) — they are translated into the catalog shape at this boundary, and sub-dicts (``limit``, ``modalities``) are merged rather than clobbered. See #84482, #8731. rrNFr)rrrrrrG) rRr.rrrr`rrrs &&$$ rget_model_inforPs[8GGKG g CF@F@R)&E\ghksuyjz{YacgXhJC ;% GC36? Sw /LLrc V^8dQh/^\9d\\\3,;R&^\9d \;R&^\9d \;R&^\9d\\\3,;R&^\9d1\ \\\ \,3,,;R&^\9d \;R&^\9d \;R&^\9d\\\3,;R&^\9d\\\3,;R &^ \9d=\\\\3,\\\3,3,;R &^ \9d\P;R &#) rrZrQrcrrrrr_DEEPSEEK_FLASH_VISIONr r3) __conditional_annotations__rr8rr`rrsetr^rePattern)rs"rrrsUTT<'&4S>&=T>"!!?T@#""ATZS#X[TH?>$sDI~"67>ITL.-#-MTX#"s"YT^XWT#s(^W_ThS#XiTxeCHotCH~=>yTvvvvwTri@8r?)r)F)r~z gpt-6-astra)rr)rzdeepseek-v4-flash)rzdeepseek-v4.1-flash)rzdeepseek-v4-flash-vision-exp> gemma-3-1b gemma-3-2b gemma-3-4b gemma-3-12b gemma-3-27b gemma-3-1b-it gemma-3-2b-it gemma-3-4b-itgemini-1.5-progemma-3-12b-itgemma-3-27b-itgemma-4-26b-itgemma-4-31b-itgemini-1.5-flashgemini-2.0-flashgemma-4-26b-a4b-itgemini-1.5-flash-8bgemini-2.0-flash-lite)urSrerrloggingrUr|r/ dataclassesrpathlibrtypingrrrrr utilsr r rr rH getLoggerrarrrRrSrZrQrcLockrtrurvrrkrsrrrrrrrTrrrrrrrrr rrr"rr4r=rr?rMrTr[rerirmrprwrYrrrr frozensetrrrrrrrrrrRr rrrrrrrrrr r rrrr!r%r,compile IGNORECASEr3r0r+r5rGrJrMrPr)rSs@rrssT   !3364   8 $. $&& !!!""")$>>+ % ,H,H ,H^    *,* (+*7BK* h*$h*0>*JOQV* * -.?*! *$-i * ' * *3I * Y * !-l * =G *y*' *4=>N*(*+J*=**$^*=*#+H*7?* 5** h*!(*$v%*$v%*$(.v%*$8A), lHhN)*.;?>449=89=*), -$$ 11W ,X S4 &8N9N2%2&x " j"v  2I&7!47!7!tF8W,1WVZW!*<. 9*0 CG Y[ <hQ , [RW[4!U"(/F0C[RV&WW  iHg 67VW-x&B  *)Y':w 18fXFTT'  #$:%'=')?02HB& % % ITX I Q^b Q HQU HqX\q  KU *,VEIV cTIfjI"k 8= bf Fzz!jjegigtgtvv" # B$$*K/3KX\KM>CMhlMMr