`gj# XUdZddlmZddlmZddlmZmZmZm Z dZ dZ dddd dddd dd dd dddd dd dd dddd dddd d ddd d Z d e d<edGddZddZddZddZddZddlZddlmZddlZedGddZd dZ d! d"dZy)#uODetect xAI models retired on May 15, 2026. Source: https://docs.x.ai/developers/migration/may-15-retirement Pure logic: walks a Hermes config dict, returns issues for any reference to a retired xAI model. No I/O, no CLI dependencies — testable in isolation and reusable from both `hermes doctor` and a future `hermes migrate xai`. ) annotations) dataclass)AnyDictListOptionalz8https://docs.x.ai/developers/migration/may-15-retirementz May 15, 2026zgrok-4.3N) replacementreasoning_effortnotenonezgrok-imagine-image-quality)z grok-4-0709zgrok-4-fast-reasoningzgrok-4-fast-non-reasoningzgrok-4-1-fast-reasoningzgrok-4-1-fast-non-reasoningzgrok-code-fast-1zgrok-3zgrok-imagine-image-proz#Dict[str, Dict[str, Optional[str]]]_RETIRED_MODELST)frozencLeZdZUdZded<ded<ded<dZded<dZded <y) RetirementIssuez.model`` (introspective — covers future aux slots) - ``delegation.model`` - ``tts.xai.model`` - ``plugins.image_gen.xai.model`` modelc t|syt|}tj|}|yj t |||d|jd|jdy)Nr r r )rrr r r )r(r%r getappendr)pathr*normentryissuess r_checkz%find_retired_xai_refs.._checkJsju% % ##D) =  om,"YY'9:6"   r principalzprincipal.model auxiliaryz auxiliary.z.model delegationzdelegation.modelttsxaiz tts.xai.modelplugins image_genzplugins.image_gen.xai.model)r.rr*rreturnNone)r'dictr,items) configr2r3aux slot_nameslot_cfgr5r6tts_xair8r9ig_xair1s @rfind_retired_xai_refsrD>sw%'F   fd #  ;'I)T" )--"89 **[ !C#t#&99; N Ix(D)I;f5x||G7LM NL)J*d#!:>>'#:; **U C#t''%. gt $ ?GKK$8 9jj#G'4 KK , i &]]5)F&$'4fjj6IJ Mrc"|jd|jd|jg}|jr|j d|jd|j r|j d|j ddj |S)z8One-line human-readable rendering of a retirement issue.z: u → use z(set reasoning_effort: "z")z[note: ] )rrr r r-r join)issuepartss r format_issuerK{s    R 3 36i@Q@Q?TU E  /0F0F/GrJK zz wuzzl!,- 88E?r)Pathc:eZdZUdZded<ded<ded<ded <y ) ApplyResultz#Outcome of an apply_migration call.rL file_pathzOptional[Path] backup_pathList[RetirementIssue]issues_resolvedboolconfig_changedN)rrrrrrrrrNrNs-O**rrNc|jd}t|dkrtd||}|ddD],}t|tr||vrt d|d|||}.||dfS)zResolve a dotted slot path to (parent_mapping, leaf_key). Example: "auxiliary.vision.model" -> (yaml_doc["auxiliary"]["vision"], "model"). Raises KeyError if any intermediate node is missing or not a mapping. .z$Path must have at least one parent: Nz Path segment z missing in )splitr! ValueErrorr'r<KeyError)yaml_doc dotted_pathrJnodesegments r_walk_to_parentr`s   c "E 5zA~? OPP D":$%)<]7+\+QR RG} r?rcddlm}t|}|js t ||st |dgdS|d}d|_|jd d 5}|j|}dddt |dgdSg}|D]W} t||j\} } |j| | <|jr|j| d <|j|Y|st |dgdSd} |rctj j#j%d } |j'|j(d| } t+j,|| ddlm} | ||jdd 5}|j3||dddt || |dS#1swY.bak-pre-migrate-xai-YYYYMMDD-HHMMSS`` before rewriting, unless ``backup=False``. r)YAMLNF)rOrPrRrTrt)typTrzutf-8)encodingr z %Y%m%d-%H%M%Sz.bak-pre-migrate-xai-)$require_readable_config_before_writew) ruamel.yamlrbrLexistsFileNotFoundErrorrNpreserve_quotesopenloadr`rr[r r r-_dtdatetimenowstrftime with_namenameshutilcopy2hermes_cli.configrgdump)rr1backuprbyamlfhdocresolvedrIparentleafrPtsrgs rapply_migrationrs&!{#K     ,, !    D>DD   #  0Biim {!   ')H  *30A0ABLFD((t  ! !).)?)?F% &  !   #'K \\    ( ( 9!++ 5bT :   [+.F(5   #  0B #r    [   6s*!F-F:G -F7: GG G)r"rr:r)r"rr:rS)r>zDict[str, Any]r:rQ)rIrr:r)r\rr]rr:z'tuple[Any, str]')T)rrLr1rQryrSr:rN)r __future__r dataclassesrtypingrrrrMIGRATION_GUIDE_URLRETIREMENT_DATEr rrr%r(rDrKrpropathlibrLrurNr`rrrrrs+#!,,Q 5?TXcg$h4>TXcg$h4>TZdh$i4>TXcg$h4>TZdh$i4>TXcg$h4>TXcg$h4Pfjtx$y 84  $ 4 :z    $(UU !U U Ur