+ WjRt^RIHt^RIt^RIHt]P !]4tRRlt RRlt RR lt R R lt R R lt RRltRRltRRltRRltR#)zFHelpers for reading the effective fallback provider chain from config.) annotationsN)Anyc V^8dQhRRRR/#)valuerreturnstr)formats"NC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\fallback_config.py __annotate__r sGGGGcp\V\4'd VP4PR4#R#)/) isinstancerstriprstrip)rs&r _normalized_base_urlr s*(25#(>(>5;;=   $FBFr c V^8dQhRRRR/#)rrrrr )r s"r r r s%%#%#%r c^RIHpT!T4# \d+\P RRR7TP 4u#i;i)alCollapse provider aliases to the canonical id (lazy to avoid import cycles). ``opencode-zen`` is the legacy pre-rename id of ``opencode``; ``zen`` is a short alias. Without normalization, two fallback entries naming the same backend under different ids are kept as separate slots, shifting the chain and letting an alias slip past the same-backend skip (#85235). )normalize_providerzpfallback provider alias collapse degraded to lowercase: could not import hermes_cli.providers.normalize_providerT)exc_info)hermes_cli.providersr Exceptionloggerwarninglower)rrs& r _normalize_provider_idrsR ; e $$    G  {{} s2AAc V^8dQhRRRR/#)rentrydict[str, Any] | Nonerz str | Noner )r s"r r r &s!6:r c\V\4'gR#\VPR4;'gR4P 4;p'dV#\VPR4;'gVPR4;'gR4P 4;p'd1^RIHpV!V4;'gRP 4;'gR#R#)aAPI key for one fallback entry: inline ``api_key``, else ``key_env``. Mirrors the custom-provider convention (``api_key_env`` accepted as alias); None when neither yields a value so ``resolve_runtime_provider`` falls through to standard credential resolution. ``key_env`` goes through ``agent.secret_scope.get_secret``, not raw ``os.getenv``: in a multiplexed gateway a bare env read ignores the active profile's scope and can return another profile's credential. Napi_keyrkey_env api_key_env) get_secret)rdictrgetragent.secret_scoper&)r inliner$r&s& r resolve_entry_api_keyr+&s eT " "UYYy)//R06688v8 eii *LLeii .FLL"MSSUUwU17#))r002::d: r c$V^8dQhRRRRRR/#)rr r!runtimerrr )r s"r r r 9s$ +@r cT;'g/p\VPR4;'gR4P4pVP4R8wdV#\VPR4;'g&T;'g/PR4;'gR4P4pV'dVP4R8wdV#V#)u Provider identity to persist/display for a resolved fallback entry. ``resolve_runtime_provider`` returns the bare billing class ``"custom"`` for every named ``providers:`` / ``custom_providers:`` entry; the entry's configured id only survives in ``requested_provider``. Fallback resolvers that persist ``runtime["provider"]`` as the agent identity therefore label sessions/billing rows ``custom`` instead of the configured provider name — while the manual ``/model`` switch path correctly persists the named id (#98739). Same class as the delegation fix in ``tools/delegate_tool.py``. Returns the entry's requested identity when the resolved provider is the bare ``custom`` class; a genuinely ad-hoc endpoint (requested provider IS ``custom``) keeps the bare class unchanged. providerrcustomrequested_provider)rr(rr)r r-resolved requesteds&& r effective_runtime_providerr49s"mmG7;;z*00b1779H~~8# ()   KKR  Z (    eg  Y__&(2 Or c ,V^8dQhRRRRRRRRRR/#)rprimary_providerr primary_modelfallback_providerfallback_modelrrr )r s"r r r Xs;mmm*-mBEmWZmmr cRPRW344;'gRpRPRW#344;'gRpRV RV R2#) zUser-visible one-shot line for a provider switch made during credential resolution, before any AIAgent exists (#74349). Shared by the messaging gateway, the TUI/Desktop gateway and cron so the three pre-agent fallback paths cannot drift in wording.rc3f"TF'q'gK \V4P4xK) R#5iNrr.0ps& r ,pre_agent_fallback_notice..^s#qYZNCFLLNN4U 1!1primaryc3f"TF'q'gK \V4P4xK) R#5ir<r=r>s& r rArB_s#^5X\]^SV\\^^5XrCfallbacku⚠️ Provider fallback: z unavailable; using z for this response.)join)r6r7r8r9 primary_desc fallback_descs&&&& r pre_agent_fallback_noticerJXs] 884U[[hh_hLHH^6G5X^^llblM ' ~5I-Xk llr c V^8dQhRRRR/#)rrawrrlist[dict[str, Any]]r )r s"r r r ds(<r c \V\4'dV.M\V\4'dTM.p.pVFp\V\4'gK\VP R4;'gR4P 4p\VP R4;'gR4P 4pV'd V'gK/VCRVRV/Cp\ VP R44pV'dWvR&VPV4K V#r/rmodelbase_url)rr'listrr(rrappend)rL candidatesentriesr r/rP normalizedrQs& r _iter_fallback_entriesrWds$S$//#JsD %-z "z" Nr c V^8dQhRRRR/#)rr zdict[str, Any]rztuple[str, str, str]r )r s"r r r vs>.Br cF\\VPR4;'gR4P44\VPR4;'gR4P4P 4\ VPR44P 43#rO)rrr(rrr)r s&r _entry_identityrZvsxs599Z#8#>#>B?EEGH EIIg  $ $"%++-335UYYz2399; r c V^8dQhRRRR/#)rconfigr!rrMr )r s"r r r ~s49Mr cT;'g/p.p\4pRFYp\VPV44F8p\V4pWR9gKVP V4VP V4K: K[ V#)aZReturn the effective fallback chain merged across old and new config keys. ``fallback_providers`` remains the primary source of truth and keeps its order. Legacy ``fallback_model`` entries are appended afterwards unless they target the same provider/model/base_url route as an earlier entry. The returned list always contains fresh dict copies. )fallback_providersr9)setrWr(rZaddrS)r\chainseenkeyr identitys& r get_fallback_chainre~sk\\rF"$E&)eD7+FJJsOrusPL"   8 $G%.&>m$(!r