+ kHj<:a0t$Rt^RIHt^RIt^RIt^RIt^RIHt^RI H t H t H t H t Ht^RIt^RIHtHtHt^RIHtHtHtHtHtHtHt^RIHtHtHtH t H!t!H"t"]PF!]$4t%RR R R R R R/RR RR RR R/RR RR RR R//t&R]'R&Rt(Rt)Rs*R]'R&/t+R]'R&Rt,Rt-RRR R!R"R#R$R$R%R%R&R&R'R'/t.R(R)0t/R(t0^t1^xt2RDt3REt4R*R+lt5RFR,R-llt6R.R/lt7R0R1lt8R2R3lt9R4R5lt:RFR6R7llt;RFR8R9lltR>R?lt?!R@RA]4t@RBRCltAR#)GuxAI ``grok-imagine-image`` backend: text-to-image (``/v1/images/generations``) and editing (``/v1/images/edits``), base64 output saved to cache. Selection: ``model`` kwarg → ``XAI_IMAGE_MODEL`` → ``image_gen.xai.model`` → :data:`DEFAULT_MODEL`.) annotationsN)Path)AnyDictListOptionalTuple)DEFAULT_ASPECT_RATIOresolve_aspect_ratiosuccess_response)StaticImageGenProvider catalog_rowscollect_source_images error_factoryload_image_gen_configmaterialize_image post_json)build_xai_storage_optionshermes_xai_user_agent"maybe_mark_xai_storage_notice_seenread_xai_imagine_storage_configresolve_xai_http_credentialsxai_storage_notice_textzgrok-imagine-imagedisplayzGrok Imagine Imagespeedz~5-10s strengthszFast, high-qualityzgrok-imagine-image-2.0zGrok Imagine Image 2.0z~10-20sz?Typography/layout-aware; legible small text; strongest quality.zgrok-imagine-image-qualityzGrok Imagine Image (Quality)z9Higher fidelity / detail; slower than the standard model.dict[str, dict[str, Any]]_MODELSz1Optional[tuple[dict[str, dict[str, Any]], float]] _LIVE_CACHEzHdict[tuple[str, Optional[str]], tuple[dict[str, dict[str, Any]], float]]_LIVE_CACHE_BY_CREDENTIALgr@g$@ landscapez16:9square1:1portraitz9:16z4:3z3:4z3:2z2:31k2kc V^8dQhRRRR/#)credsdict[str, Any]returnstr)formats"C/home/ubuntu/.hermes/hermes-agent/plugins/image_gen/xai/__init__.py __annotate__r/BsSS^SSc\VPR4;'gR4P4PR4#)base_urlzhttps://api.x.ai/v1/)r+getstriprstrip)r(s&r. _base_urlr7Bs3 uyy$==(= > D D F M Mc RRr0c V^8dQhRRRR/#r'r(Optional[dict[str, Any]]r*rr,)r-s"r.r/r/Fs6B[r0cJVf \4p\VPR4;'gR4P4pV'g \ R4h\ P!\ V4 R2RRV 2R\4/\R 7pVP4VP4p/pVPR 4;'gVPR 4;'g.Fp\V\4'd+VPR 4;'gVPR 4MRp\V\4'gK]VP4'gKuRVPR4;'g.RVPR4;'g./WFP4&K V#)zZ``{model_id: {"input_modalities", "aliases"}}`` from the live endpoint; raises on failure.Napi_keyzno xAI credentialsz/image-generation-models AuthorizationBearer User-Agent)headerstimeoutmodelsdataidnameinput_modalitiesaliases) rr+r4r5 RuntimeErrorrequestsr7r _LIVE_TIMEOUTraise_for_statusjson isinstancedict)r(r<responsepayloadoutentrymodel_ids& r._fetch_live_modelsrUFsY },.%))I&,,"-335G /00|| U  45 GG9"5|EZE\]H mmoG%'CX&CC'++f*=CCC;EeT;R;R599T?77eii&7X\ h $ $)9)9"EII.@$A$G$GRTYT]T]^gThTnTnln%C !D Jr0cV^8dQhRR/#r'r*rr,)r-s"r.r/r/]s/r0c^RIHpV!4fs\e>\P!4\^,, \ 8d\^,#\ R4\P!43s\^,#^RIHp\4p\V4V!VPR443p\PV4pVe6\P!4V^,, \ 8d V^,#\ V4pV\P!43\V&V# \d#p\PRT4/pRp?LRp?ii;i)z.Cached live catalog (``{}`` when unreachable).)get_hermes_home_overrideN)fingerprint_secret_value,xAI live image model catalog unavailable: %sr<)hermes_constantsrYrtime monotonic_LIVE_CACHE_TTL_fetch_live_models_or_emptyagent.credential_persistencerZr Exceptionloggerdebugr7r4r)rYrZr(exckeycachedlives r. _live_modelsri]s :!)  "t~~'7+a.'H?'Zq> !248$..:JK 1~E,. U 5eii 6JK LC & * *3 /F dnn.:_Lay &u -D&*DNN,<%=c" K  CSIs D.. E9EEc V^8dQhRRRR/#r9r,)r-s"r.r/r/xs'?D]r0cVf \4#\V4# \d#p\PRT4/uRp?#Rp?ii;i)Nr[)rUrbrcrd)r(res& r.r`r`xsD',}!#S:LU:SS  CSI s   AAAAcV^8dQhRR/#rWr,)r-s"r.r/r/s+r0cj\4pV'g\\4#/pVFQp\PV4;'g RVRRRR/p/VCRW,PR4;'g./CW&KS \P 4F wr#VP V\V44K" V#)zLive ids + curated metadata (unknown live models get generic text; curated entries the live list omits are kept); the static table alone when the API is unreachable.rrr=rz-New xAI Imagine model (from live xAI catalog)rG)rirOrr4items setdefault)rhmergedrTmetas r._catalogrrs >D G}(*F{{8$  x"k;j) fde$68J8JK]8^8d8dbde  "--/(DJ/* Mr0cV^8dQhRR/#r'r* Optional[str]r,)r-s"r.r/r/s55=5r0cj\R4PR4p\V\4'dV#R#)xaimodelN)rr4rNr+)values r._configured_modelrzs. !% ( , ,W 5Euc**544r0c V^8dQhRRRR/#)r' caller_modelrur*ztuple[str, dict[str, Any]]r,)r-s"r.r/r/sMMM:TMr0c\4pV\PPR4\ 43FpV'gK W!9gKW!V,3u# \ VP\ \ \ ,43#)ubcaller kwarg → ``XAI_IMAGE_MODEL`` → config → default, validated against the merged catalog.XAI_IMAGE_MODEL)rrosenvironr4rz DEFAULT_MODELr)r|catalog candidates& r._resolve_modelrsbjG"BJJNN3D$EGXGZ[ 9-i00 0\ '++mW]5KL LLr0c V^8dQhRRRR/#)r'r|rur*r+r,)r-s"r.r/r/s  m s r0c\4pT;'g2\PPR4;'g \ 4pV'd/W!9d)RW,PR4;'g.9dV#\ #)zaEdit model: an explicit selection that accepts image input, else the documented quality baseline.r~imagerG)rrrrr4rz_EDIT_FALLBACK_MODEL)r|rexplicits& r._resolve_edit_modelrsbjGWWrzz~~.?@WWDUDWHH'G8I8M8MN`8a8g8geg,h r0cV^8dQhRR/#)r'r*r+r,)r-s"r.r/r/s[[S[r0c\R4PR4p\V\4'dV\9dV#\ #)rw resolution)rr4rNr+_XAI_RESOLUTIONSDEFAULT_RESOLUTION)ress r._resolve_resolutionrs7  & * *< 8CS#&&32B+B3ZHZZr0c V^8dQhRRRR/#)r'sourcer+r*zdict[str, str]r,)r-s"r.r/r/sllSl^lr0c^VP4pVP4P\4'dRVRR/#^RIp^RIHpV!V4\\PPV4R4;_uu_4pVP4pRRR4\PPV4^,PR4;'gRP4pVR 8XdR pRR V R VPX4PR 4 2RR/# +'giL;i)z]Edit ``image`` field: URL / data URI pass through; local paths are inlined as ``data:`` URIs.urltype image_urlN)raise_if_read_blockedrb.pngjpgjpegz data:image/z;base64,zutf-8)r5lower startswith_REMOTE_PREFIXESbase64agent.file_safetyropenrpath expanduserreadsplitextlstrip b64encodedecode)rrrfhrawexts& r._xai_image_fieldrs \\^F ||~  !122vv{337&! bgg  ($ / /2ggi 0 77  F #A & - -c 2 ; ;e B B DC e| [Xf.>.>s.C.J.J7.S-TUW]_j kk 0 /s D D, c(V^8dQhRRRRRRRR/#) r' source_imagesz list[str]rrufailrr*r:r,)r-s"r.r/r/s,)6>Ar0c\V4\8dV!R\ R2R4#\V4Fwr4VP4P \ 4'g.\ V4P4P4'dK]V^8H;'dT;'dVP4V8HpV'dRMRpV!V R2R4u# R#) z\Edit-request guard: at most 3 sources, each a remote URL/data URI or an existing local file.z#xAI image editing supports at most z source imagestoo_many_referencesrreference_image_urlszc must be a public HTTPS URL or data URI (e.g. the `image`/`public_url` from a prior Imagine result)invalid_image_urlN) len_MAX_SOURCE_IMAGES enumeraterrrrris_filer5)rrrindexr is_primaryfields&&& r._check_source_imagesrs =..12D1E^ TVk  #=1  <<> $ $%5 6 6$v,:Q:Q:S:[:[:]:] aZMMIMM)//2Cv2M ) /EgJ J ! ! 2 r0c|]tRt^tRtRtRtRRltRRltRR lt R R lt R R lt ] 3RRRR/RRlllt RtR#)XAIImageGenProviderz#xAI ``grok-imagine-image`` backend.rwz xAI (Grok)cV^8dQhRR/#)r'r*boolr,)r-s"r.r/ XAIImageGenProvider.__annotate__sCCdCr0c F\\4PR44#)r<)rrr4selfs&r. is_available XAIImageGenProvider.is_availables0266yABBr0cV^8dQhRR/#)r'r*zlist[dict[str, Any]]r,)r-s"r.r/rsKK1Kr0c *\\4R4#)r)rrr)r rrrs&r. list_modelsXAIImageGenProvider.list_modelssHJ(IJJr0cV^8dQhRR/#rtr,)r-s"r.r/rs,,},r0c <\\\44R4#N)nextiterrrrs&r. default_model!XAIImageGenProvider.default_modelsD$d++r0cV^8dQhRR/#r'r*r)r,)r-s"r.r/rs   .  r0c  \\R4pRpV'd VRV 2, pRRRRRVR.R R /#) image_genzVgrok-imagine-image - text-to-image & image editing; uses xAI Grok OAuth or XAI_API_KEYz. rFzxAI Grok Imagine (image)badgepaidtagenv_vars post_setupxai_grok)r)rstorage_noticers& r.get_setup_schema$XAIImageGenProvider.get_setup_schemasH0=f  R'( (C .ZY[ *  r0cV^8dQhRR/#rr,)r-s"r.r/rs  n r0c RRR.R^R\/#) modalitiestextrmax_reference_imagesmax_source_images)rrs&r. capabilities XAIImageGenProvider.capabilitiess# 67+-CQ !3  r0rNrc 0V^8dQhRRRRRRRRRR R R /#) r'promptr+ aspect_ratiorrurzOptional[list[str]]kwargsrr*r)r,)r-s"r.r/rsP_B_B_B),_B _B?R_B_B  _Br0c ^\4p\VPR4;'gR4P4p\VPR4;'gR4P4;'gRpV'g\ W4!RR4#\ VPR44wr\ V4p \4p \W44p \ W\VR7p\WV4pV'dV#\V 4pR R V 2R R R \4/p\V4p\RRRR7p\R4p\!R4pV'dd\#VPR44p V Uu.uFp\%V4NK ppRT RT/p\)T4^8XdT^,TR&MTTR&T R2pM#RV RVR\*PV R4RV /pV R2pVeVVR&\ WWR7p\-VVV\.RR 7wppV'dZVP0R!8Xd,\2P5R"VP6VP84V!VP4VP:4#VPR#.4pV'g V!R$R%4#V^,p\=V\>4'dVPR&4MRp \=V \>4'dT M/p V PR'4p!\=V!\4'dT!MRp!V!'dT!p"ME\AVPR(4VPR)4R*V 2RRWV \2R+7 wp"pV'dV#R,\VR-,4/p#V'gV V#R&V'dVV#R.&V!'dV!V#R'&T#PC\DU$u/uFp$V$V 9gK V$V V$,bK up$4VPR/4'd VR/,V#R/&\GT"YT RV'd RV#R17#R0V#R17#uupi \&dpT!RT 2RT R7uRp?#Rp?ii;iuup$i)2uText-to-image, or editing via ``/v1/images/edits`` (JSON body — xAI does not support the SDK's multipart ``images.edit()``) when source images are supplied.r<r=providerrwzSNo xAI credentials found. Configure xAI OAuth in `hermes model` or set XAI_API_KEY.missing_api_keyrx)rxrr>r?z Content-Typezapplication/jsonr@rzhermes-xai-imager)filename_prefix extensionz)Could not load source image for editing: io_error)rxNrrimagesz /images/editsrr"rz/images/generationsstorage_optionsxAI)rArQrBlabelhttpzxAI image gen failed (%d): %srDzxAI returned no image dataempty_response file_output public_urlb64_jsonrxai_)prefixrrrxraspectlogstorage_enabledenabledrusager)rrxrrrmodalityextra)$rr+r4r5rrr rrrrrrr7rrrrrrbr_XAI_ASPECT_RATIOSr_REQUEST_TIMEOUTkindrcerrorstatusmessage error_typerNrOrupdate_FILE_OUTPUT_EXTRA_KEYSr )%rrrrrrr(r< provider_namerT_metarxai_resr edit_failerris_editrAr2rr storage_cfgr image_fieldsrerQ endpoint_urlrresultfailurerDfirstrr image_refrrfs%&&&$$, r.generateXAIImageGenProvider.generates-.eii *00b1779EIIj1::U;AACLLu  =e!# #)G)<=%l3%'-iN !-?S\bc "=YG J}% wwi0.BT /1 U#3 );uN;KH5kB *6::g+>?H pGTU}V 0 8} U(/(F&KG< A%#/? $0!&Z}5L8V^EWE[E[\bdiEjgG'Z':;L  &)8G% &](R# '7DT\ac ||v% #>ZD "I/ *%uyy'7$xj@QY^inf&JNIs !2DY9O4P Q")E,  &4E" # ",E,  7Ne7NRUYdRd+c;s++7Nef ::g  #G_E'N8Z_ 'W5B B-35B Bo V p #LSE!RT^fnoo pffs<'P+O??P P*&P*?P P' P"P'"P'r,)__name__ __module__ __qualname____firstlineno____doc__ provider_idrrrrrrr r__static_attributes__r,r0r.rrsR-K ECK,   0D_B#'_BUY_B_Br0rc V^8dQhRRRR/#)r'ctxrr*Noner,)r-s"r.r/r/Ws;;#;$;r0c8VP\44R#)z3Register this provider with the image gen registry.N)register_image_gen_providerr)r$s&r.registerr(Ws##$7$9:r0)zhttp://zhttps://zdata:)filename expires_atpublic_url_expires_atpublic_url_error storage_errorr)B__conditional_annotations__r  __future__rloggingrr]pathlibrtypingrrrrrrJagent.image_gen_providerr r r plugins.image_gen._commonr r rrrrrtools.xai_httprrrrrr getLoggerrrcr__annotations__rrrrr_rKrrrrrrr r7rUrir`rrrzrrrrrrr()r.s@r.r8sN# 33aa999\\   8 $'(KI]+WiV!17IP# & " % 3BF >Egich 5*f 5%ueU$<3\S.6"5 M [ l$(AB0ABH;r0