߲j/UdZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z ddl mZddlmZddlmZddlmZmZej.eZd ZdZe eeeefed <ej@Z!d Z"d Z#Gd d Z$iZ%eee$fed<de fdZ&defdZ'defdZ(de dede fdZ)de de eeeeffdZ*de e fdZ+deeeefddfdZ,de-e eeeefe.ffdZ/de de eeeeffdZ0ddddd ed!ed"e.de efd#Z1de eeeeffd$Z2d5d%Z3Gd&d'eZ4e4d(d)d*d+d,d-d.e'd d/d0eid1d2d34 Z5ee5y)6aRamp Router (router.com) provider profile: Responses-only LLM gateway (verified live). ``api_mode="codex_responses"`` + the ``api.router.com`` host mandate in ``hermes_cli/providers.py`` keep every path on the native wire. The catalog is account-scoped, so no ``fallback_models`` (picker uses ``fetch_models()``). Router 400s on ``reasoning.effort`` levels outside a model's published vocabulary and on any reasoning field for non-reasoning models, so the efforts map from ``GET /v1/models`` is cached (memory + disk mirror, background warmer; never HTTP on the request hot path) and fed to the codex transport's clamp via ``supported_reasoning_efforts``. N)Path)AnyOptional) EFFORT_LADDER) __version__)register_provider)ProviderProfile_profile_user_agentzhttps://api.router.com/v1_efforts_cacheFceZdZdZdZddZy) _CacheStatezUEfforts cache + once-only flags for one Hermes home (same names as the module slots).r _warm_started _disk_checkedNc.d|_d|_d|_y)NFr)selfs L/home/ubuntu/.hermes/hermes-agent/plugins/model-providers/router/__init__.py__init__z_CacheState.__init__+s>B""returnN)__name__ __module__ __qualname____doc__ __slots__rrrr r &s_DI#rr _state_by_homercddlm}m}|tjt St 5tj|tcdddS#1swYyxYw)zHolder of ``_efforts_cache``/``_warm_started``/``_disk_checked``: this module when unscoped (tests monkeypatch those slots), else the active home's ``_CacheState``.rget_hermes_home_overridehermes_home_keyN) hermes_constantsr!r"sysmodulesr _efforts_lockr setdefaultr r s r_stater(7sQK!){{8$$ K(():KMJKKKs #AA#c( ddlm}td|tj j fD];} t|dxsdjjd}|s9|cStS#t$rd}YwwxYw#t$rd}Y,wxYw)zXRouter base URL: profile ``.env`` first (scope-aware), plain os.environ as the fallback.rget_env_value_prefer_dotenvNRAMP_ROUTER_BASE_URL/) hermes_cli.configr+ ExceptionfilterosenvirongetstrstriprstripROUTER_DEFAULT_BASE_URL) prefer_dotenvresolvevalues r _base_urlr<BsR$  ?@  67=2>DDFMMcRE L  #"    E s"A22B2 B?B BBc ddlm}td|tj j fD]5}dD].} t||xsdj}|s*|ccS7y#t$rd}YlwxYw#t$rd}Y+wxYw)zRouter key (documented var, then alias), preferring dotenv; plain os.environ is the fallback when the dotenv resolver is unavailable or raises.rr*N)RAMP_ROUTER_API_KEYROUTER_API_KEYr-) r/r+r0r1r2r3r4r5r6)r9r:varr;s r_resolve_api_keyrARsR$  ?@< C GCL.B/557        s"A'#A8' A54A58 BBobjkeyscZ|D]%}t|tr|j|nd}'|S)zENested dict lookup; None as soon as a level is missing or not a dict.N) isinstancedictr4)rBrCkeys r_digrHds.>(d3cggcl> Jritemsc t|tsyi}|D]<}t|tr,t|j dxsdj nd}t |ddd}|rt|tsc|j ddurg||<||j d xsgDcgc]?}t|tst|j d xsdj A}}|Dcgc]}|s| }}|D cgc] } | tvs | } } | r/tjd || |D cgc] } | tvs | }} |s8|||<?|xsdScc}wcc}wcc} wcc} w) a[Parse a ``/v1/models`` ``data`` array into the efforts map (None if unusable). Ladder-unknown levels are dropped: clamp_effort ignores them, so an all-unknown vocabulary would pass the effort through unclamped to a Router 400. ``supported=True`` with no recognized level leaves the model out (unknown -> transport default clamp). Nidr-router capabilities reasoning supportedFeffortsr;zrouter: model %s publishes unrecognized reasoning effort level(s) %s; ignoring them (update agent/reasoning_effort EFFORT_LADDER to adopt new vendor tiers)) rElistrFr5r4r6rHrloggerinfo) rI efforts_by_iditemmidrNevaluesvlevelslevelunknowns r_parse_effortsr]ksh eT "*,M(3=dD3Ic$((4.&B'--/rxE *Y5  == % .!#M#  =F]]9=U=[Y[s_ijkmq_r#aeeGn*+113ss#)q!))&,KU]0J5KK  KKZ[^`g *0J5M3IeJFJ !'M# %(&  D t)K Ks0)E?.E3E!;E! E&E&6 E+E+cH ddlm}|dz dz S#t$rYywxYw)Nrget_hermes_homecachezrouter_catalog.json)r#r`r0r_s r _disk_pathrbs04 7*-BBB s  !!rTclt}|y |jjdd|jd}|j t j tj|dd|j|y#t$r }tjd|Yd}~yd}~wwxYw)NT)parentsexist_okz.tmp)tsrPutf-8encodingz)router: caps disk mirror write failed: %s) rbparentmkdir with_suffix write_textjsondumpstimereplacer0rRdebug)rTpathtmpexcs r _save_diskrvs  (efforts map or None, age in seconds; TTL when ``ts`` is unparseable).N)NrgrhrPrxrfr)rbrnloads read_textr4rErFrIrQr5maxrpfloat TypeError ValueError_DISK_TTL_SECONDSr0)rsdatarPrVrZlvparsedages r _load_diskrs  ._refreshs$&   %  rzrouter-caps-warm)targetargsnamedaemonz'router: caps warmer failed to start: %sr)r2r3r4r(r&rrA threadingThread contextvars copy_contextrunstartr0rRrr)rrrus rrrs  zz~~+, HE #    ####  !E ++-11 J\ei %'!##" E >DDEs*B,B,'AB8,B58 C!CC!c peZdZdZdddddeedeededeeefd Zd eedee ed ffd Z y) RouterProfileuERamp Router — Responses-only gateway with catalog-declared efforts.Nrrrrrrct|xsd|xsd|}|yt|ttj d|DxsdS)zLive, key-scoped catalog; the same payload seeds the caps cache. Deduped but not sorted: Router's listing order is deliberate presentation.r-rNc3~K|]5}t|ts|jds&t|d7yw)rKN)rErFr4r5).0is r z-RouterProfile.fetch_models..s0!e1AtATYZY^Y^_cYd#ag,!es ===)rrrQrFfromkeys)rrrrrIs r fetch_modelszRouterProfile.fetch_models sL %W]X^QS]de =eDMM!e!eefnjnnrmodel.ct|xsdj}|syt}| ty||vrt ||SdS)zKCatalog-declared effort vocabulary (cache-only; cold cache -> None + warm).r-N)r5r6rrtuple)rrrVrTs rsupported_reasoning_effortsz)RouterProfile.supported_reasoning_effortssR%+2$$&+-   !,/=,@u]3'(JdJr) rrrrrr5r|rQrrrrrrrrstO+/$ad o"3- o:B3- oY^ o $s)  o K# K8ERUWZRZOC\ KrrrL)z ramp-routerrampz router.comcodex_responsesz Ramp RouterucRamp Router (router.com) — routes each request to the cheapest model that clears your quality barzhttps://app.router.com/keys)r>r?r,rz Hermes-Agent/Tz gpt-5.4-minir) raliasesapi_mode display_name description signup_urlenv_varsr auth_typedefault_headerssupports_visiondefault_aux_modelfallback_modelsr)6rrrnloggingr2r$rrppathlibrtypingrragent.reasoning_effortr hermes_clir_HERMES_VERSION providersrproviders.baser r getLoggerrrRr8r rFr5rQ__annotations__Lockr&rrr rr(r<rArHr]rbrvrr|rrrrrrrLrrrrs7    05'?   8 $526c49n-.5    ##*,S+%&+KK #3 # #$c##!#!(4T#Y+?"@!@HTN Gd3S >2 Gt GE(4T#Y#78%?@($sDI~*>!?,.rTW6S66E6\dei\j6,Xd3S >&:;(E<KOK4  @K\u, NYbYd!]?2C#DEN &r