+ Wj'|Rt^RIHt^RIt^RIHtHtHtHt^RI H t ] t ] !4t RRltRRltR R ltR R ltR RltRRltRRltRRltRRltRRltRRltRRltRRltRR ltR!R"ltR#R$ltR%R&lt/]PAR)]4CR']/C]PAR*]4CR(]/Ct!R#)+uhermes fallback — manage the fallback provider chain (tried in order when the primary fails). Subcommands: ``list`` (default), ``add`` (same picker as `hermes model`), ``remove``, ``clear``. ) annotationsN)AnyDictListOptional)get_fallback_chaincV^8dQhRR/#)entrydict[str, Any])formats"KC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\fallback_cmd.py __annotate__rs{{^{c^RIHpVPVPR4VPR4VPR4R7#)z=BackendIdentity for a ``{provider, model, base_url?}`` entry.)BackendIdentityprovidermodelbase_url)rrr)agent.backend_identityrbuildget)r rs& r _identityrs=6  %))J*?uyyQXGYdidmdmnxdy zzrc$V^8dQhRRRRRR/#)r configr chainlist[dict[str, Any]]returnNoner )r s"rrrs"'''0D''rc2WR&VPRR4R#)zaPersist the chain to ``fallback_providers``; drop the legacy key so there is one source of truth.fallback_providersfallback_modelN)pop)rrs&&r _write_chainr$s#(   JJ&rc V^8dQhRRRR/#)r r r rstrr )r s"rrrskkkCkrcVPR4pVPRR4 RVPRR4 RV'd RV R2 2#R 2#) z6One-line human-readable rendering of a fallback entry.rr? (via r)z [])r)r bases& r _format_entryr.sZ 99Z Dii% &geii C.H-I\`SQUPVVW=Ji jjfhJi jjrc V^8dQhRRRR/#)r model_cfgrrzOptional[dict[str, Any]]r )r s"rrr%s   8P rc\V\4'gR#VPR4;'gRP4pVPR4;'gVPR4;'gRP4pV'd V'gR#RVRV/pTP RUu/uF7q@PV4;'gRP4;p'gK5WEbK9 up4V#uupi)z^Pull the ``{provider, model, base_url?, api_mode?}`` dict from a ``config["model"]`` snapshot.Nrr,defaultr)rapi_mode) isinstancedictrstripupdate)r0rrr keyvalues& r _extract_fallback_from_model_cfgr:%s i & & j)//R668H ]]9 % E Ew)? E E2 L L NE 5'7EBE LL(@r(@}}]`OaOgOgegNnNnNpEpUEp*#*(@rs Lss+C1C1"C1cV^8dQhRR/#)r rrr )r s"rrr2sFFFrc^RIHpHpV!4;_uu_4V!4pVPR\4uuRRR4# +'giR#;i)z4Return the current ``active_provider`` in auth.json.)_auth_store_lock_load_auth_storeactive_providerN)hermes_cli.authr=r>r_MISSING_ACTIVE_PROVIDER)r=r>stores r_snapshot_auth_active_providerrC2s5B    "yy*,DE    s A A c V^8dQhRRRR/#)r r9rrrr )r s"rrr;s       rc^RIHpHpHpV!4;_uu_4V!4pV\JdVP RR4MWR&V!V4RRR4R# +'giR#;i)z>Write back a previously snapshotted ``active_provider`` value.)r=r>_save_auth_storer?N)r@r=r>rFrAr#)r9r=r>rFrBs& r_restore_auth_active_providerrG;sQTT    " , , II' .',# $    s 1A A& c V^8dQhRRRR/#)r model_beforerrrr )r s"rrrHsSTrc^RIHpHpV!4pVPRR4Ve\P !V4VR&V!V4R#)z>Restore ``config["model"]`` to a previously-captured snapshot. load_config save_configrN)hermes_cli.configrLrMr#copydeepcopy)rIrLrMcfgs& r_restore_model_cfgrRHs:: -CGGGT}}\2G rc$V^8dQhRRRRRR/#)r rIractive_provider_beforerrr )r s"rrrRs& c c cc cd crcJ.p\V4\V4V'd/RP RV44p\ RV 24V^,hR# \dpTPT4Rp?LeRp?ii;i \dpTPT4Rp?LRp?ii;i)z:Attempt both halves of temporary picker-route restoration.Nz; c38"TFp\V4xK R#5iN)r&).0excs& r )_restore_primary_route..^s7CHHsz+Could not fully restore the primary route: )rR BaseExceptionappendrGjoin RuntimeError)rIrTerrorsrYdetailss&& r_restore_primary_routerbRs"$F<(%&<=))777H RSY_`aYbb  c  cs. A A< A9A44A9< B"BB"c V^8dQhRRRR/#)r nintrr&r )r s"rrrbs5555rc&T RV^8XdR 2#R 2#) r entriesr )rds&r_entriesribs%SQ!V'3 443 44rc$V^8dQhRRRRRR/#)r headingr&rrrrr )r s"rrrfs']]#]&:]t]rc \RV R\\V44 R24\RPR\ V^4444R#)z z (z):r,c3J"TFwrRV R\V4 R2xK R#5i)z z.  N)r.)rXir s& rrZ_print_chain..hs)[GZ81D2mE2326GZs!#N)printrilenr^ enumerate)rkrs&&r _print_chainrtfsC Bwir(3u:./r 23 "''[yQVXYGZ[ [\rcV^8dQhRR/#)r empty_messager&r )r s"rrrks!!s!rcz^RIHpV!4p\V4pV'g\RV R24Y#;'gR3#)z\Load config + chain; print ``empty_message`` block and return ``(config, None)`` when empty.)rLrnN)rNrL _read_chainrq)rvrLrrs& r _load_chainryks9- ]F  E  =/$% ==D  rc V^8dQhRRRR/#)r rr rz Optional[str]r )r s"rrrusMMnMMrcVPR4p\V\4'dVPR4;'gRP4;'gRpVPR4;'gVPR4;'gRP4;'gRpV RV R2#\V\4'dVP4;'gR#R#)z?One-line description of the primary model for display purposes.rrr(r2r)r*N)rr4r5r6r&)rr0rrs& r_describe_primaryr|us 7#I)T""MM*-44;;=DDy)JJY]]7-CJJsQQSZZWZz++(29c(B(B9??  $ $LLrcV^8dQhRR/#r rrr )r s"rrrs i it irc\R4wrVf\R4R#\4\V4;p'd\RV R24\RV4\R4\R4R#) z!Print the current fallback chain.z# No fallback providers configured.Nz% Add one with: hermes fallback add z Primary: rnzFallback chainzM Tried in order when the primary fails (rate-limit, 5xx, connection errors).zZ Docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/fallback-providers )ryrqr|rt)argsrrprimarys& rcmd_fallback_listrsc EFMF } 67 G#F++w+ gYb)*!5) YZ ghrcV^8dQhRR/#r~r )r s"rrrs5Z5Zd5ZrcVaa^RIHpHp^RIHpHpV!R4\ P!V!4PR44p\4p\R4V!VR7V!4pVPR4p\V4p \YV4T 'g\R 4R#^R IHo\%T 4o\T4p T 'd>S!\%T 4S4'd&\R \'T 4 R 24\R 4R#T!4p \)T 4p\*;QJd TT3RlT4F 'gK RM RM!TT3RlT44'd\R\'T 4 R24R#TP-T 4\/Y4T!T 4\R\'T 4 24\R\1\3T44 R24\R4R# \d?p \YV4h \dp T PRT 24Rp ? hRp ? ii;iRp ? ii;i)zQLaunch the same picker as `hermes model`, then append the selection to the chain.) _require_ttyselect_provider_and_modelrKz fallback addru Adding a fallback provider. The picker below is the same one used by `hermes model` — select the provider + model you want as a fallback. )rzKCould not fully restore the primary route after fallback selection failed: Nz No fallback added.)same_deploymentz/ Selected model matches the current primary (z).u; A provider cannot be a fallback for itself — no change.c3H<"TFpS!\V4S4xK R#5irW)r)rXexisting new_identrs& rrZ#cmd_fallback_add..s Q5x?9X. : :5s"TFz u. is already in the fallback chain — skipped.z Added fallback:  Chain is now  long. zL Run `hermes fallback list` to view, or `hermes fallback remove` to delete.)hermes_cli.mainrrrNrLrMrOrPrrCrqr:r\rb Exceptionadd_noterrrr.rxanyr]r$rirr)rrrrLrMrIrT after_cfg model_after new_entry picker_error restore_error primary_entry final_cfgrrrs& @@rcmd_fallback_addrsG: ==!2!27!;[`@a[`VWqAQ[`@aemdn@npq rC {cAgE !2 ,-iinG "=#9": ;< eOHSZ01 :lIklAbsC! cV^8dQhRR/#r~r )r s"rrrs+++rc`^RIHp\R4wr#VfR#\4\ RV4\ R4P 4P4pTR 9d\R4R#\T.4T!T4\R4R# \\3d\R4R#i;i) z0Remove all fallback entries (with confirmation).ru8 No fallback providers configured — nothing to clear.NzCurrent fallback chainz Clear all entries? [y/N]: z Cancelled.u Cancelled — no change.z Fallback chain cleared. >yyes) rNrMryrqrtinputr6lowerKeyboardInterruptEOFErrorr$)rrMrrresps& rcmd_fallback_clearrs- Z[MF } G)5134::<BBD < *+ )* x ( s'B B-,B-cV^8dQhRR/#r~r )r s"rrrs$rc\VRR4p\PV4pVf%\RV 24\R4\ ^4hV!V4R#)z:Top-level dispatcher for ``hermes fallback [subcommand]``.fallback_commandNzUnknown fallback subcommand: z$Use one of: list, add, remove, clear)getattr _SUBCOMMANDSrrq SystemExit)rsubhandlers& r cmd_fallbackrsP $*D 1Cs#G -cU34 45m DMraddclear)Nr,listls)removerm)"__doc__ __future__rrOtypingrrrrhermes_cli.fallback_configrrxobjectrArr$r.r:rCrGrRrbrirtryr|rrrrrr5fromkeysrr rrrs# ,,9! "8{ ' k F   c 5] !M i5Zpm(+* mm,.?@BGIY mm$&9: