From 6fc33add9a6538b2cfa58e7ee87152e39a997e92 Mon Sep 17 00:00:00 2001 From: Thomas Mildner <12685945+Thomas-Mildner@users.noreply.github.com> Date: Thu, 30 Oct 2025 03:13:19 +0100 Subject: [PATCH] Opik user auth key metadata Documentation (#16004) * fix(opik): enhance requester metadata retrieval from API key auth * docs(opik): add automatic metadata association from API keys in documentation --- .../docs/observability/opik_integration.md | 34 ++++++++++++++++++ docs/my-website/img/opik_key_metadata.png | Bin 0 -> 59183 bytes 2 files changed, 34 insertions(+) create mode 100644 docs/my-website/img/opik_key_metadata.png diff --git a/docs/my-website/docs/observability/opik_integration.md b/docs/my-website/docs/observability/opik_integration.md index 1ba1c2de21..d28c46f0b4 100644 --- a/docs/my-website/docs/observability/opik_integration.md +++ b/docs/my-website/docs/observability/opik_integration.md @@ -220,7 +220,41 @@ curl --location --request POST 'http://0.0.0.0:4000/chat/completions' \ }' ``` +## Automatic Metadata from API Keys +In some cases, the requester may be unable or unaware of how to add Opik metadata to their requests. To ensure all Opik-related actions are properly tracked, LiteLLM Proxy can automatically associate metadata from a user-specific API key when none is provided in the request. + +### How It Works + +When you create an API key in LiteLLM Proxy, you can attach Opik-specific metadata to the key itself. This metadata will be automatically applied to all requests made with that key, unless the request explicitly provides its own Opik metadata (which takes precedence). + + +### Usage + +**Step 1: Save Opik Metadata to the corresponding Api Key** +Go to 'Virtual Keys', click on your choosen api key and edit 'Settings'. +Now save the opik metadata as user api key metdata. + + + +**Step 2: Use the key - Opik metadata is automatically applied** + +```bash +curl -L -X POST 'http://0.0.0.0:4000/v1/chat/completions' \ +-H 'Content-Type: application/json' \ +-H 'Authorization: Bearer sk-key-from-step-1' \ +-d '{ + "model": "gpt-3.5-turbo", + "messages": [ + { + "role": "user", + "content": "What's the weather like in Boston today?" + } + ] +}' +``` + +All requests made with this key will automatically be tracked in the "TestProject" Opik project with the specified tags, without requiring the user to pass metadata in each request. ## Support & Talk to Founders diff --git a/docs/my-website/img/opik_key_metadata.png b/docs/my-website/img/opik_key_metadata.png new file mode 100644 index 0000000000000000000000000000000000000000..c810f270dae9e4b380db233f49d9fdffa7948e79 GIT binary patch literal 59183 zcmeFZc{tSV`#+2nDO8doON%W<_UuckDEk&d2w8^gF~*?OokGc$J+g0=-55i%@B1>w z6xoKEv5mnP^Lx8L>+}2G@B4V3=a1hX&+&8|nC87)`*ps~*ZDfH*9LlbSXsDP=;-KJ zweQ|CqN6)ZqN8I_V?F|WGtDABMMp<(?Q-*`f%eUt0tVimPA=|_baW!`9UeWh*S;#! zZfE!CQG1V=D2sQ1(I0=jHF^Z^XlxN^YHZHzX^c&J`0(f16F(1`e5cDcY^ruU{#Ic3 zn|OP%u`pwhO^S-GfG2u4Q%^IW(^!S&r;heDy(5G0&`GdpyJ?}QTXcN;o;VU2OCMpw=7)UXu}^(uAm+x9H)V29dAwKY%a-?3kqj}y9y zq4QSJceQzP{oVW_`*TN}k6b#!aYX)z!;yPO4m}!wWbVdbn$l;`XwYHs<6XzQ-giv~ z-!mJ3GM^TG)NXh8@Hdrn>t|!nZJzZFb-$G9a{G90=Jng`N-rMZ*fIxt)QdbW{`iKK zyuM<==sT_SBB@aI9XuuMmw}~*z2QaWTjx+;Pv@QE(HNgXpF8^?k4mE{q=toAe+c_U zB++PaPa2Izlsa-`-s<>qrUrVtOYsijP~}Qqpuf!=A80%2>e5{SJ~PwNzjC2t1U}IN zKit3%9o?bWmvl_P-&4TPtxSf0T|G?7JoK;63~C2AY8cJ9s-fdiXr?^gTB% zvjx0r%*Et^?*rZYiVmI-al6N!_KxDuAWsh-p;LaQ2z-P%`q~LRgSdP6C_YoU_~#vp zz~_UnB`ym5d5f=`%Ebq|1_C!dy&VPQ#IK8Azo^P0ARwUZ{n$y-=+^CjJ`Vg(<>C`x z-=~Ta5&;1L;sMg)p5D$9k_rk664#|9q@=C^cUh_rHJC)A5F7fYo1CJ^n ze5+{S^32iQ;+6{p=pLX9RatpiWbO?omS-hrgWL8BhN8^@9f+kDeG_P-9?V76_&L%U|>t)eY3tJx&kZ`pYs7-VvIq zN@D`418|-B1bz4}y?1t!&|entXUUAD9W{^&0N2$+nNJL}zvF3<0dI*wejg3AC+Ha& zZiQxsgieX%zW(cG9@Ihuw$BdM4a@>31Q-}ehkoCd)CKErdPZj41{}1T=)&ku3gq(( z$Va+d1Z}IjK?dy*=wL82{z0cfrK>f(&jH%juuEr#``WvQZN<#o7D_*R8{2+ag+eCk zkW;<3X2NH1a05k=Ks|bpf=jAfNejr z1t~C8F{{Qri@*sDZ^566lJ4sF^>52h550a)!L1CviXY6MQ|jKQS_Ey?UcP4W&9>=+ zQSR#{c?fqQ+B3%3*W_29TY|Vs=139y;tP(87_F7b_<}xFbl%BJ_NVPzlcnWN`Qi2Y zDnT#Au3pU#mWV6A1lD0U!hl84IXIIoYU{f0Jmk02vQX%@ur=A>lV}r2wT4VpXtAq3 zMHHI85se>0cQLbEQQl6CO)mUn^(l&~-XHy-KkQ94OK~99I=`~v<0|{(kLS^%q85dgl~0E>^))Yn z&2IGqmKRf=It9^-vPrBJYFnE(qHb(FCJ~{jnm2Er=HSgCSS#T+mdZKLaTZw07A?O- z^BEMK(Zy7$?2Ta)mk0wf1)f9#i)>eG8*(e!MlPen*!jsq@8wE2v`$k~QxIh4au01@ z3AVYEnEWJ!^__vR4ZDh*+4Ehp|H3y1-Q8^;Gx`C9`T}OA4YLUB)<}5GRMKC95XC>P*%kHYIFF0t!-Nct9;R_@#Yp98lRe)BkJTA zqM3F=Wv^YlD@Q-~vY4XK-IVIbi*OpcgyZEc+_I;U?AFd@$Yk6n;S9Y&uAx{?Td`ZL z+~@Z`wbl781+A=EbE}2KoDtU<+5K_6C+U5bjmo9R@Ki~=89w<}+Wdr}^*N^DT8<(b zuN)j?7YegyIh~%Jlk|L!(BQRUmgt@5)8-JIeDUJnpCs=G!6bB4vxVZJ*6uyGC`(DMhT?Tl;nFBqJVuRh82Swu&`2B4J`}hl}oTQ7O?p z!(TB2Ov@qL6P4&!EYb_XCE~p3S}LqVbP`1iMT`7HO84OxS-r|K1&oUD$3J?L*yR!@qjhBm4m z{}M(EX(P8UdCI$c(860QmjaXJRdm$$Hd9h!V6~okTX)=EPgJuX4WVsF_$?1MIoGdG zx)`XL&|nq0Sy|zmE9KgCE9)g5T1eLKXsKq#F$$@mkd3!6zrn&3z8^SXS$PGs*Qw$9 zWRUcujj1d8@9?j~Zzl&_82XF41+kAVDjW45?EWgf#9^0aAB;2TU z<;)$@i!$m;u=5u&SFTN4ITV_!+ua=M>{`32p6=fOYNH~>4RR$qA>*0pDX)7nY|A`& zGb~E1Q5sR-&`{sy&qqDsj~SLwIQ1=^Af6l8ddC!{`3WxUs=_E#I6!Y-W8SXul72%z z2D;_iyQk$k`uROnvWzUb--@5Ee4ZPuIz){X_~!ZoT1#-~dplGpyX^N+I~Or_oOFNozO}1H2VomqqcyhVZ9C1elKGld;5_c zyjP{``G>#YeUP!j!1C78GL)KJiGD@L2(2fJe+ozIx)asz^9RZc;p^(Tz6!TDVz_4X z${#XSD=jT03u!&SA&^ySagP6^bN71w_THPvf|p<98{hemttxZ3?PG-kd@rzZuD5!_ zrC;C&}~)+NKhT=IqlWn(!0b5;n_pxOvKzfj!-vr?vqAs{xdGvRL|2kw^F(PFUd zPgag;2N9{rx|#LoOCj$3ETDV;0Apux?WUTzvXyO!tUmF6a#noNn9CYj&80iL@8ht9 z>t)i=Ujk$&Z6R@V_5rz9Yuk}Utp(>1`8hYYGS+4H#yb~>tK{%-4e&YZO&Uk{hFiDadu~LZ7oOK%#Csb z*PiC0V|qfq5;{$p9;#B6pBy%kaXT|_Q%uRAp$k0E@^LhtLOZ>COv5W{=B-SvGMuvE(C^(CJMZ;5_Z zR+XeHLIHQ+vwUuRNA6R-t0pTUb8L9m5bf1vV%IwC?mOtprAoE+?`H)+Htt=DA#^G@ zj+OpW^!(A3O3uqT<7g9|@=1~%Z<2fT_p5V+qO!MsMGFw_)V|!8HKCLq`L@D)3r|S| z-cPUiCUe3L6&1P+-K5EO`<%*{nP6v8P4Zs|qqsi#{zE1C5yNg2&#T(RIgjb!>tEC! zh3<^}_%0K`r*t<>@dBX*se0(!b1*Dwa5+q1W8J(DasQ2P<1b$wZC$?t{}tEWnS|jA z8S;!}ie;Y6J&P!-WS>p>1nWSQkMm2{VdjnwC=vD+rd`6iZ(f#8es!*(z`}!6zmPDV zxbpG^V{Idfd^Q3?TWbrE^*lLmL^lx2)mF-*`?sR0QRxY_@!Oa7zfLrvAaK=Xq4DaU;1JxBH;TL8=4FZEU z;FJhpuFXe+PK1KP%s6u#x~~Nk0W-z|E`fTTRX1ppGmVa&7%m&G&UkYNtg_6P!}`^e z-5rycBQ8~&utDr@adC0%`Bq8L1;xCFXABPy*P$ls2<8)y&gXsp z>|(1Exkc1BzkU1VNB1TDn&HD|PyCOT{0s4i8J%o5x_kGJ@6FAp&z<~KXxfa)&p9{6 zE=9l7Y-!`kjs;^?8}0J z@ryN6!ivT5yKyOCI=`zE`LUv#UeWF{0d!s7Z{9}`(*Q%r)d_8slG;)XVcx;ovlz~gr zHa;jWjqKHxP&T;vaf1bKYv6GEc5Vte*>Cw6PE!SJ^)_Nn8e2!$t4}LYqZhO_ysRq;+fEfkrp-_+R(ipO5691h=^ZY4Hovk5l^cl+mRMWE#9DL+E!KW#>)vkzRe@q zr}=DJoX1}igNyG=lkeS5FBucklakoRWJje`yMEZ&Tna2!^m|g|Rfe3k*+=KhO4iM< zAG3D7(C5X96I?{bP4^0Siy%lP?KIGYX-6brDyjXbbPHMu3*!I%( z3~BiL!ND!J?JpXt8+J@!t;t+x9U|!R4&w zt)Z{C@R+8elr)+~sR z%<8MSd{L}&n`I#4C#$@}{Nchk>im3o(K$$~PuTh;L!6hpFfXPqB3im=f7WfJfA@#3 z>djkPW~R-%e%4mhAivY+PZbjr_OkxlrPL=9lF6iMLe1f0sG*%<$~^mlwc}kceqRW+;!eREXTa_NMVu|d92oFd16^O+|S;`h7hNgYcm9EppUg@I4g%&r{ z8&Qy{Z;(6bswSYzS-`*~>{Jd`6!$Y{pv;*pzPnx&m@MfQ2K`h5yMTW)i!~a`=DuqrH^^6=6&&fCtdEP5qV)3^j6v=Lc+p<57yh$7d=uy9oYT; zd)T%rINpC{DrXG4mno8$$qu%%=@@ocOt#~9oikMLFU`-<6GOHOgc?#x-~D`4DOtN( zhFH%EmS{ISG68RD>Du8xefsmGGKZCrkQ{)wOICzcc{Dh@^{5Yu^Qa{lsqA-m?Ji*0 zYYDP$KbB(OJ0tMY`aFd{qEblx4i1=*3>!>E5Po;>We(f_?Bsv3-Y5o*`JC#8qs!Fu z_6W56rpI`NbrkpciSujz5y6#7PdI`lX#8hC=jMt|{l<_PX~si?ap~!w7K1}n9-)h^ zM*d({tCIo6UnY;ke*C!A(#EAG8*F40YcwcjD)A{-Q&ZF1zN-Z}%7QY&Qo?8Kivo!W z%l@}+)%5LL`rgyvX{v{C>zZ&l1X}H|*rRc@SaNJnN;ddB%J)40nV4$};ou#TYYgEo?}@Bm~YeY$zT>YF(TfUz>)>eOSm!B8Eu2>`3Zf) zNW31|N1&Be=LEcw{D9~{(7rcOJn%*c z2|i7rl?}TBcq0bH^BbUj|Np&-!d%jBp8D})0c%Rt@B5Mf@#Sg~(>3AzHw&usvcae4 zyB(qhbCM};PIh#af?b~V)p>PhVX!h&pKY^;2fLV zmt4k%p9I_%ma{O>WzA+KAP~O$b;RBTWy4D@uq0ho*>3mQby)J2g-qQg)3C<4F$7{B zMlCt|g}RHBLj)t!^5C1k zk;r&AS=hYt;a7~yQ_}hg5b~yqmw|21N7P-)mSB-J+N`egEh?}}E-G+S;T3IMdUk3@ z;=EVgbg<{Q28&H3+xffZA6i-cdgi!d#TUQO-bjJ1)X>m70zYly+|1k2r+7IFy1S2a zsb?rG@T5HoCjyMk)21DEA^0b`lH}!jfC#3()a9nGO6%y}>sq4CnQ!^??0niyET z%ZI%Q;GG4&%j1C$*J3s*RK2oyOq=pb*}*~tz*Zr`8W#GXKy7Desq=1MKih|ph2;or zSHtyczapo}D#$D8vtFYe+{!jq zvW_1;kb_;CuFOt8KcX&XR^kOah)--SCIsycP#&t8ckqL4BJ_+p8Ug}lIOoSsuA}u4 zmRn;wq?G|J_G##w!rQlgKWt#_g?66#z@67&$f|-6|LGAhTCCe$@aA>2H(HL)^WMnn zbF85g33ct`M+*Xa-(@({rq_S=HtXXBd)wF)#3o_DG;NX}Z?<3?unY@Y{QA|hHprUb zu>!hf2^iQPbS1oXl|v?YJoBRUPriXwcup zm+pzC0x{5!rkmQks~;pD7N*vWpQSF(7frqK3-}mhrA$?sWjgHa=@_%1=tx_7VuX7O z3(P{7H&JV4MQ&yFckj_GbA)N~)0OB%f{j;4pht=ts3BmE zd#P@aAlh=S-M_EBz5k^yTDM_Gu|;9?kFCmDqOp;Y^>x%`VVmlZ=LFu3&mJ{6`%1Ok zD5IglbzU({eWQ7&x7Y?gF!qD-<0$2woqOIM(V+T*{3M3guU`v6@2w3Xg#`sg1+N*C zPPtyWeEG8TTA)|iH_ftP2|~*=GW$`sUU_CBCNCfT>C=TsHkIvDn5njLIpV2v79-F^ z$lpwAU4e1u%W$_XY9;0PnQ#DgDi8bec5U?x`R!0XYrA9l;vX<@o(0 z;)~;SMP*LmyIiSI%g~*@w2+&%*OopU~?SP?|3N}@Y-E@1=#jZuZ&t9uzSK# zVZbe@Cf(nsK)3q;TW>k=6@)#;ivg&t|(*$hV&7hf&Ge$if9I;W-bA_QdK0I(~6RfCGSqn2w$+>0?X zh8^0j+Rw|NZKJ2Y1lq!jGC~Tr$E2~{K2ys?Tw|E8v)We9YrqY3$KTU4jK5+kvmZs4 zao*3e$0ojgdmkgc>s4Y=-7wzf4Q3k*EEqLm;xb(;hj)gz3FBMdBIiDS4B9|;)NN+@ zM2}D4JJ&KZzh4i|i$%Z*Fzj?7xxr==c?vgd284Ll<;*gZhhAl5a=h9!eK6icQxr2V zi!V{Kd&Do_wUGWy{p7D-oKITs9|nPc%yeN{KNfV`C*|{r5-%a>t_xqVv~9j*SqB0z0rJJ9Q?adIAAYRBD|`2FG=9le{(_C#-gZi~>jT@wx5`!y zZMywVAHsz`>D3czcCNIvnEEWa3~mtv3S7*JEsI`~IDCKoF*H)BWvrsIWqJ@5q6AZ@ z`ay&>rV1xW)&b0r^O($Xl^o!9+2up$zzAKUUoz6raS{ziC9eKKu9G|j*B1n*c$xpt26w!$>^r*Um384W$42z*k_dHU}B{%$HvE_4>E!VA7O$qIg?)<68T^_t+4=F*dg&hY;tsx2=#NW z9M8&%zPD~|dK#3K5_T74C(8rM2+&1QR^GurUX+`8EI^iEqS8`hUFR!r>D~|B>$NH~ zgK!AIH#@lEE1)q4Hk+%)b9z$*}H)X{zIJHPr`RNusaXbXuEkzQ#NCRC^KB0n8c`QD})fcw9g7Nd9qjj|2l!vq?Dzw(^o6=|iZU0bd!xx|X zDUxHK@gK7{dihGNN>TTHP&O;kzd(I%^(F@Tlf!*dYV0*DGbcS9k;1DhwU-f{dk8^P z4d;5AVufGPgv1T94Eej6e#R6Q7R2YqFo*H$9=HY|xl7io(CVY5=u`G)yS4yY8ZLA+ zjz~T&z290z?Yq9@Y$@kC)B5&Jl%d*27Xx(93xjxq-(^+EtJVlYa8H-^q5v9<6X0a9 zw7q*Hv-YL{YL#_2=%ea1`ly>ZB@~)P^?%G`8`;p0>d+3Hbs-0HjS_R+Bn$!C?O|v` zr2;X_6YdKb9zW}+y#<7^!`D&(0nn`7#x7dQdHN!W=#xs3Q78;sIV-nHNQ-VSU99$r zmf0xZD0K_L{Ipgk=Vba^eXyOj(i}S5gM5O{jerWw!j#b#c?A6;<1r`n^oCV+%X#VzKC_$T-wFYJMoCq;fB0nd9hxIwv5;$ z|y^7X#bj%&7Baz6>8B;4qld!3AYrR!*a9f?P`FgX>M z%1U|k%W*?<(ux>#cT1y5!8z5v6yc+XaL)b`B1eSzntaYH;{Ir&2^Y5(@AFdu_#_3$ zG|#e}y9r8F#kDa5;jl0ns2{x#Wa8ol3Z$N%IR z18uA3TI~w5%^s9s_?fA${u#SAbv0#w&T=E%jFM%MGTm|p!Ht>Ef>TS_D>{nzs{(&x z0Y3$Z`No&eO#9R?K<86ED*%ZB`PBH@yyMrA`>WUu^~RyLki^IC#91Ft^p0+ZLf_oy zYKhmnvQ6uNGlKAtdw>GG1-EY($L%!uNY>9>&uh~ z(BZk^0N%*eHmri;$H4JdoB(kyMYc<{fp0v&_*RGOf8RF$i5xP$k1_txp$hN@;mcqe z%l%C-%sn%eYJ$^;4Jt}M#wX0#YOJ%^8-@FJOt~kp0nI-&i9A21diF~Jgm7J=w6aCX zxqcz@du#6yR@s+Xj$gk6Gd=#9IeC5O{zm^V4sv5-L#ABAXp=4XaXFOcvzduRKdKs0 zerJPUCU94OSV?HrQ>`jBr1Qi`Vc^pUr1M_k$&(RVrD;neP)9xWB-y?dZQQv#L z=3Q=DcV@rh<5{jFFOBFHjg^wmcY^aostg)JtlghJ6aAMB?kjo*40+gEro4au2_OTC z44>arnAz}GU6(B=aPim&z`)`3y*ex6&_o`)aT%X=4+{w;_N)vaeX~K!^e+J<>OfMg$41Fup-X0H>!CzmgNJQ?2*zgk*%sb znX%o7!&w&(`1P4q(!PWF4BD3N*}^or0!?u@-?7Txo5w9J5D{N|#^ors{i>OuVHi$p z0l-|Zt*y1BJN<`3gf6(IC%K)R*^mn%B8*U9LL1VuAZnY;nd2YCmk$97Y_|CY)oRwK zT(X&-G1q#>Yy0Mqo}MOAI3^z&bPQUh0_avevBw_So>(c{Ugk>a>k3zKsACd1{3YVW zi<(#L=?#KZ@s;xtDxsoFJ2$}iQ|227V5vuI=LqQ#;mRAeUl$I=m}kEvy@CI<;~S_n zR&sRW4Q6k&V>A8S93wUMY$mfo3wKW#WE#_jHJ(`2MH#m&+KQ$ex#2@z+2X`2f^ zbOSVMMaQ7Uxyp)j-cjhbMPxL)fbwlXdBKc(E!c82?D?+7&hg*Yb7dHW1h`FN7BG;Z zhp&-W{IQuK121#A{;svp4_d3f5C>}EnBxxg&f3E_{w7rBeFETG*%nhzfp=Lfpu3iM z&D{oSV+0J?06MmdKFt`^qY^MUMGrJ7A>+bcB}F0C32bHnwP?Td57$jTpFgfoecE(? z5=r?6N?QX004wGe4LP z=0|9+C@A53LgY0tG_mpCh$R7XW4#(a;~Nv zA#Jc3m&*Q=Jtb_AviO7N?GNFrv6R)Os)z=ND(|t0a{z-E1Radi3_9=rXEaXPg+iv_ z@BPjDJ9Q4o6Qo2?Yw_V}gym{afGTALe7>y)a51yKI93b@(A`D_T>-QbS!UX-8#td@ zW?FtbwTd_%?{k!i?X%n73v$KpJnTd3JT{15N4wAIGybbm3*EM#V{-2grK?bUgZmsD zhbYey^>cgQ@s3r=yG$9F@69TYM3*gLS|EMt)du__Qo0E8il0x7{cxb`$TyetkiQGP zB{R@}H9}b>vJsMEXy z5@|Apzb2Cw1rSswk4>qbQ!kXM%04ro$cZj&@D%gA_+2l>LOa+5=lVflu6$nHcMSfp zT5s3B^?Y@j6T{{KlzGWUDEifWq*gKI1GWmyxrYs*m1~AS_oG}hzj9Iep+6@rsye3E zt6~Xu3ircpHPoimWBgr6vdqr0iNvL#L@I^726M&EuFzIOgVr#61h6wAA|jM)ho{pf zz<0{b(}x)@=6jX}w1-Y}lXnr8K%DW+)jd7l$x1^LlgDf=FLkY^s&rFkMRiloPgNBW z@VNc)@v~h0)p&pr@*Z3thauLn2>`Bche7wB;Z!I9!M7au>5weo-ohx&eT8Q@N=`bb zWdTA%Xx%FKexm-7dHV>dyjy|A>Zu31tH5`8a^QCt+?GFiWJ349MLHLPLEbN3Qm+j7w#_m+GUtMXiLy*L1= z=jK~#`cTS-DC%0Ga_yGN^YMBrYQLfT^R~tB@NGFY+K4 z2eE`VZulG-k74!d>8BqNg}uBnk`jIRJQwMC9Kf`gE}zlm#K$)*q)O`zmVU+rEh9U` zw>>wAwt&!6EBV#oCYzmgrId$z*4+2*4?G02C|*NpXX}#!=`e&oG(X`4EnGl+!%|I^OC(J+JYa%CJ8}oWM6|P=i}Pv4BDjK(hA|Xh)q?8BzmzMOT2kS@FW-5l8;MPj{xLBq5GZqkBl4l z@cxPW>RTFJd>f4|s=h9k(n*aWOB~V{L3-=mC4)~x#Bt8u;@-YmbIzdVX<;Zz1Qe1v z3Liut{YmnIPZ?`$!+gq;MF0B5jJctn23XtU7+a_)&-q_N@#`yM*r!uvodJEd_J3`t zMFi>L^rHvRu>nO+-F1`5sg?d41QM_FFPvpt@S^6yU%&HUzBAnW>B%!p+k7rB>-~&B zK)$~ESe?pH?tP=dQr^R|Oup1_SonaX-%YB`O~ceZHce1FA11}IjXpvudEn%9n=O^> zua`5{T4MgzU}kc}M)p98Hs7PGHyXz$*mn9c7W9HzD=O}qSN1)U3^Z*Ypv?O%88))>q^ zX{UXAmoi}aZnxRSO3c&q{7K(^X=-JIG1!pVd1o^J4!LArw&t#$cIO$Xv-71Qvni-bHgV<6SQtNRk=h<)yx!~qlhOc|0Ka|V596X8F zyB$=Q9<=BYP_NSVfmU18U%PNFlm)D}!;H9?7c(1J>#;sVIdxkZw9&i`xN*tk(IETo zw3gf4a-lb= za5|UvLVwhpeJ#789M8e^f#(#iy6EDLYCxIgq-y**7=0wRacO#x{q@$5eWPK_i55&qHaqmglY)WTk&I{4l?3*P|K{ zVLGr?k}^`E#RJ=4Lqza-9KtRm%{JIoNDpP*r@DC^V#;i?6RfOJeqFb%11MA$HnxGB zvFY6ER+|33Gw>36VK#}))TorI;iXHrYu8?;2Im6uQR6YbHUu@{PW4c7eAjU4(AVS} zgmaFM^O#szSO&Gsr+)9Ap4*md^YulYc?QMFdt8P7?3{zU;_eWi{OlikY`$j;ryRmb zKS|=*sG{(Vq>aURqsw!34N(__-Ns!mP3`Lj?6;L{R-N}3kF5WBp2 z!pp?uz8*`88l0lNB-9dhO)j4(s-+M@os2JqmM1`zUlnLAJIIil1E%)N)I##^l_6B} zN(?`oQ9z3&P(MxBh7|H$bNf9!5v9vBN?9TEJrWsj3^_I}mYFk|AA@pmRPhW=W zg2v*)jQ&I}FJjrXQt>8KeiJ`;56|T(gFHkq@#n&Mp*qW49*Fu2Qe%i7P8>R;#Thl_K$~ z*OJw`iZ@XYNIY_*{X@MyOU+0AdN&44m*~;cf~uZ+oU1z~E1mv4-P7gJ#4dVUBUK&| z+wye@a`<=^uVUAHHGDaKq1$!$kkB|4@si|Tg4$O;yD47cli*uwdMSGt830$I!pW{c z($2TQb=#o%U#Y%IDik&^%2rO3l^mphLti<`r;yOb{&FIgRe`#r(O=ZnnMh0-zApg|e)wyTy>(&g zV$%4j4QroeWF4)l$hWU2vB1*Z54k;Rg4~!qh6^@{)8p?q6i)R{(DoWKYf;G4E#f$D z;yv>{nnv94bZx7;hJ*R?rcG8O^;Bnrqt5zOBKE~R>Wm@ifYGBEt0(Gtw{Zi|N6~M3 zh&0a)28>mivOb>YgzgutphRmuHZsst&Cwx|-D z@_w$L1ii^6A(Yti6>@#*ia)d=$M(Rpk zqa1}lS7huFyiy%J@_v>I9HJ`bD#|DDVf&$u#t_}3_ARsPJs_!i2WP5@>&_ARbn3jS`C4tL~@ikVJt`^wRd(O zmB97_I)$bg>&ssc=mB9CR|Vkh!84A^V8Dc)vGXqAH=Jvdy83tB z0{9Jm>(ccof3;Ubpz2Maz#Zm)5lYY3&$S~uZ4m*s;5*m}^~@*#_8hWUbtS-Sc|zp> z96bjN@F`hvZH#*6`Ge6rq?q^DsZa-VC-X7`;0#?=ySeQ~_PNmmK0pHRVnR{dP=AD{ zftpB0Sbfo6C6s(E0^i+zACPv4E|kOCN{!Br&`tp14niuR^axb+oUAv^2$3}Q_h=Cn zR4Ki&kSPH+bn2o1AoyOH{qDM_r#%9sdXPWbKX{NYu1uC8;W3yzRa6>Tb?-jJQq~+% zRkH3T{)Mn$OB)_f6vkl#rZRJ*cy>2afVBAB5Cto1rAlMXv}YMr-~GM$%?E2a{n;i# zXXpO(pCZan{6O;Sk9LrC8hMe7zbU~+vuZ!I!vv~@-1$xXjYXgo$J#8yIOV* zyu??7IR9)oFqB!b z*|TSyX;SX*0ItlcIK{P(y!BZ$XzMG5MEXv|Y`uQI>)N?sTX2w_8Zg%qM9c2mq-1n) z0s_dCGQ_Q(A`KS`OuKShl6lfV_i3P?8Wc!}ep;HB+AKR+ zl;8F%u|jE-A$P(oW!#E+%J^~=E8S`<6bf8i>Sp*CYD4_Bs5{Q=i6uOMeq*u@_DcL* zVAVn5N`Tt736Szq@W4E+iWUkeIRo0BRnZ>QO{v@;ua>Z2-@^{Elo@GprAj{(6@v9| zA0<*YE0t;&s(^rR0I%--LVhT(;d@gO%8TQ%ImH-sU{9g;=$A} z3k~}(1-OS$X)2PFhX(?HJc8CJ?i$l=9yt%gwyise227o=0mZ?xYrX^P7EVZv;r?`l z#4%iFDt(};*=X1|tLpm|S0s*9uXHsV1C&oP_@dfxl&wTMK>RZ_LtIytX;-NRz<Y4$WCZ?Ko5q*j?@XIv* z^m?1>=NpcT>bhxi_pr&Yxa6Yx|0vfp>?5QdQ-~A-+rPp(515zg2^%)#vTT`_g5z@q zhwY=>9_!cuwW<&4QW`r;(hEyK22L_@M?4cwjpzC}vJL5W-Ba6KdE@yzt-7GVSa^CQ z25?>rQ;=yu{zCr>6a5aKFQb^g;wRLx6$#r~%YSl?5Wgp5tvNFa;X^-7K=+-w3kGr9 z^{=s%`C*BxnVu5gZK3CEpWNa2?J=BLYB8XSMxK=yS^W9pVo&6=lRyrXqtDoco86Qzl5^sqOVmfE`tHcoXclkNhwr9k>?G2*1R*deDgW8s3eU54U zf|L1zt>2Ie;eytE-#Ghj9hg<;M?{5qycg&k+dH~_jQP*F1eG=D1$qPV@=dSOO+ZDK zyt%f38$zVa0GUI;c?p?t+Jd%eOp*W7mlI9<()ucfuX*Ha6UT0AnU3%ZLG%X+n4s17 z3!9r8Wd$xDZgUT#%%_VwRo8@#ofjk4Jm-QBWSBo!zT!2e(K~pkU(e7O)MLv|D>1rl zks6bSo0imfEeJdzi3^wJbg@ag2f7QXH(ojs=NRdnCxWelzU;6-9dMDZ4SI%bq8qA+ z0HPu1hc?xVdyn*>L=LB9COQiH`BfKmc|gX>Jr|W)B9g-2fuHiZr>`F%u@UvAC*+3L zW#Q&p@c#Kn^5XuZx&TxfQV~dC{EtHOR{DJz8|%o5r4(b--B%{{dLxA`r*9NI`rs`b z@CBP&Q@|`po&pZ1(NafUoH{oT7FIL4AI6dvl4l<)DF!yH0qk%Gzz#b#K4##zL>@q@ z@yF-E$^q~a02+>vs7R?XTjIwCA9=AYc=FQsqCeG&2U~8CKBb(7#Hui^5`u}(^`8(M9!E7$oMc@e z^dUt1wtOTSKD9>S+=e5ZcPgk@2M5_qeSKCnmv{OwLfS$4U4W48z_>8~@Ln0pZ)~K* z?G8CpAOIV_g#{#mj*p#iVF=H`Z*xTzPWT{JzNf(&m}4dInObw-sjq2!y@-B|C!pZy zM%Do`fbXtyJO)zh00pGuxwb_GqDKSLN{w1AEpp zW?lF~aZLfX()zvS-huuy=y#LSR25ZL6Z7I3b#>PBn-B8w?+I=tk8n9p3?UjhJ708~ z%Ul=GACBi>T?`~Nh%lLvsK6ak01iv5vti{K9?G-rjzfy4ROJHzqb_*(k5u1V$57T; z3jAG$j7x`(M(+{-BfTN<$--pj9hJMqcy!`pO$iRxN$wFNpUNb#u4UaV>11 zt(lXSMlgiBQ>V@sQ;2njhjzC%O*kn^3WBCSx~^%xypyh}XN*^zI790&61doTy{V*Oz9Y-&i(*MVZ~?9{j$&3cOxDNI<~uk5FL+x4UY;b=fl zG9_x47u(G1|Bx(hi4Y%fW~O+fU(W9)j9Jc>j>z?N=zK@ee8d>$ z&|APxca&_a_3cGAB>?yu*U3ZhNAH1}mV7`7@wzW%8|i6qAQM6gp>607QN+fIeOz4J zzfgW?z+@l)TvM%G!Vlw*IkxFPvjw1{kX8=^kf*W*602VQS!(AYRd?qhf+?=M#57UjE?g{_!P%esd7oQRy2RDE$?_OIOu1% zC(!=ceodE!=)7Nru%;pbeDfg>8J#f=@0$lsFfwiVjVv>oGayjb>jr^%>qP2a`cG63 z1qCJB0Q&bXX+eY{96JpwbTZokFC|jqT~bp1_V$cKvYw8Pk&b09PH@=w%~usk%uKJq zBQqQq`FrO#xUb1$3pU&0ua_=H|QAD;Fj*9TeX)#}xs@kN4cdZ}3}ATMJYyT6g6+1Bry4QZ)C2 zlK}x;e6Y|AhL6+26wrEaRJ?i_kq;ydWCS6~fh5Q+!8{S*9KDE_XY{^8D0&eQ5m$hv z(RU-I+QazqNMYpb==Fj=uK zw#0O@({6rV`{o25U}!ucq8w{YU-}C;Byp$v`;k!ze!yVX`93ApqW=r&P%6|YSPCb{ zEYC9(xkg8Nmj?;bdk9`5o1zyqM?VQ?O%`aPo8g`1cXr=pF&W9l79V`*c=`=m)&|j;2~J&eA{PUVz}cbQ;E|fZ_4H`;l&>pU>l5^<=t2IGBa<=3y}A%tF12$wZzW> z$Atp9gMw_h#Eu9_5ilgI-oY4oDntI412%L2(=+dV;Y$46>G5igZ=xQ(ijbt-KFiGb zqR~RCWC?8E;+l}K!a@;RqpGlIKMI%QPWfAW4q z`;UZRXwJlj+3ftfBheYB6)%5!@uL6MNl_i5z#pfza^8ghbU4h}G<`xW%O1vg^4OIJ z^zJioiu5`Z3oMN}y zH*FUpZN}DSzj|v`-otaSM*H6CGB0`mI=AoFrMAx@7|YnWq(!;EfnMH*0+-eTrIEqp ztf>-ofaQpkqfX%P$Q0R9GrVuU!E>TG?ED)=5984%n2wqo7D#_&h3mkr0Lal*a$;gS z>_I66Gvy^Rlp(Cw+M)TuGA|^}a(y)v@!MB3{4Jl7YR`>4y^Jb--X{?rL`;DCm0NKi zoHNcoif(IvQ-&1gReE^oIX_fA`eQxKxM%37rSIN{`8z&q@@^0N_@FMUmxNYr&CVq8 zoHGtd76nr6MD$e$ZP|EUk?%xRLaOlN*ZAT4X)?v;==4jXk{#36zr^o>9`$rXpJAcF zbsCoQzqotvs3!ZaYf!P>>W!#~+)7oNfDom3P(eCK6RAPz(z}#UL`6Y*?d~}q4`|V?E3=mA-wy@c5RCVE`|!=x7Zbn4ZC`n={mD<<8X{loT=-1J*s9m$ z?r_o5XpT<(i6POt7e}e*WhEvoTU#vkc*J$)CY?}q0>*69ksV@Y^TaTbQ#sC zL2K&@r<_J|g4QSLY^#}&JBw9x-FOG?^6#d_%$fCO$;MNkqlcg#ODk`Ud?(r2WJm+k zjn685(oMF|6H?7tivy}W9S|DouM?CnuuYcg;C2DHPWQcXJngMD@|cAsOC9-==xm9k z=U9c%&24oAqAbq_bEml@j@H6^+8=U6 z!CY4r<1WT>Qm>`ZBS?3*w(k@Rx#pT&j4e<+H!Sczx0n^hnI z$a2`xu<;hJKbTk0syop!UExVU&LQbj9vw^gVAJ`)GqL{-VkypJ^Wh|zq-`a7Z0vSs~Xds*=N zy3VrL{q)}S!z6Chw*-!gT;$+==P0g$Rw8MxQ zG1?rEgN9P z;Wa7FOZg+o*I5fPZ3QI$pZ=7+EdR1d5(41kdsRFZGLFi~Gq)m5BALTt012ZqkfB-$ zUl^tQrA8tO=Qqdd(I3;3;-CBNDyylKVUz_jp%Vy+&53{~8ZFJaww|j)wwMNw%~tal zgB7)xX_nE7#>Nd3xrK!{(_}V?*oWkI5efzqQA zNPBy`=d?Ip6oX&T{r&xu+q|$Jip(FXKZif^>l)LCM{XJvG7IcDcoPmp<%2g0J8`fE z-d<`*>uEGi4zy#N^rbdzJxO8{h&_CJm;4@2GvAkZbaJjMZD;hWjW08UuIJdUa7(GE zVn+uWm1|q&(8_;&1;H7wl$pJK3f89*AtJUKK9|mkIE-v5sl4LeOze=)ki{*GTyJw)+iP+mw8(73RSchxA|w=;C!)sYB0V-BsGy^#-r? z@$}6D3gfLo7j+x;52bUbr3*4c_^#hI-4u~D(JJ{ik#;9n^=;c|Bs!*75q_&z=DwVW z<1`PNd{3H7BObtPK3)asM5FI#RSTmodwVTl#{47J|8edNn6Mm~Y#zI>TNS>w9(!t` zHveqi4Nd*N`s*k_MttJN!Dgqc8!Dno*|dQlRa;I$;CNufdQVmj>Ds(4U`@JOTWD^C zamRES-Hqpoi%qZJlZbQ>37P{TGHmqo>G^e^NT5ee9haTMGzkv|k)$T~G;|$3t z;WzZ!)m^b&{v{1wIJ3I?4p8OTqjy?{g~aALN$g<>&@#6IOMB*Jl;U+h0}gcR{fZq1 zp=YMAe4>D!cxNlv&l*{ub+vhM*K{gJD|mclBmaim!n<9Rl9E!?M(h}v02dNQ<5X~P zMlollBK>+bW}g`iZVS?5<4)1}fH-#AMkH}JLtr;mc^7L1Q})W?jx-c@vXFip$piwb zFXiAm{fx93c0W)?)EchnOrjb#`Eu>W#}col>m|EeGEXRO{ev5RQ+*(a@tAL^8TKkEw z6G?tt)N8|4nw;#(Lifli`LsfPUld@fZo85y#(oWH_gX7nG3X<+$8ZU45HB=ma5pVY z$|dV>pXmlZ8$2=x_wEJ&b?DMrC4(E!jd#v}c)nC`H&yoa{2R?uQ7X^%k8uV_J^@_& zA%2232`oV_lTmOpX-4t1JG;=yEF{GP1@a+ zykHxp7rblexjD}E{F9}<8RVctczZtzB_BNEl(HkVLT6F}J*nTF2t7H5C)<|=nSe2U zTXjjP=hPX}&p%ruEz_9NtM|JOEp(&A`96R*{(f%14y>AKBr(wo6gcg}d^eRh42L%m(>wocZ6)rW{V?DDdRkg? ztWFhFcxO*q=!YYbu;^f{+-{i7yIZUaWhILqdT-$*WA_VR9JrR{c3t9Taar;mz_F(e z69^U$Bl($f>(A%e89|C>r3XR9#XC$m?2C-?0$)Aq`uf#KS%q{+e9Ca~c>b9RlVMff z31oK4aIci*R&ecuGD+7=p#raXx1<*eVM)lra#XHpkUtog__u&4)s8JKUx}f}S55w9 zVSWQreTCEDL#T-6Nt^yu78qQ*!x49p0`C6F9tC<$kl5NqnL6mKE%R)NTj9Oz%2mKR znKcQS{u$=4w=S~xe7T3Z#&39)mUbim?E88TgvK=S=f%`2Mg6zFyq#*7r_eivW{#Xv z2hIW39gI%EgHXvy)35e`W`?KFsKK=xo@q(jFU48NN&}+H7>(tA>vy$!YlBobxarhX zKEFP5VKfVo=dUHoC+Vp$o_S!E+h8aD>gRiE4gI3avr>%z{B!3Ur{0stq17(yk6O(v?@gv#9B5)*cIF^8M!BrkkIFCvXKQkIxf2zsu~F~#1Unx-7Sz?%gVJ!Kp= zEw5yv5-$~Nr4*USZ=!u$U2a;R`{_>CUhc*Yr}l$Hcj=UA<>1}v4*%Fy#jtsTPWAAR z%*J?yJ2O9cbDjDU<^e?)L;4^;+9A~B9ymovNYJXM+SWmcBh+q;t`?Q|tQG^nw+e}q zCrPf@V4(YBbHa0SPsgED*0tAP+;5>kc~5)509*IzBpCp!qxh()U5|(%rX`Ru|JsOC z)UBn(;yP`U!O6dwWNv#1Rv!TfVVy+3!~rKQtps-^m|C6j*D8Nue2M^$%zWX7R!lPc z3VrWnjEr!vErg`p!ly+HJvJ-^y$%;xiC|Q~T!BcneC2KJ(m59~=V0uBLr&C9$RQA; z`?Rrw0oy}h1!VS+0@@@Cv^R`h)Q^o>8oWO*uixQYcXDQ2-|2+?Sk)- zMv*f_%kIkx&~ZC?V}CzPf|!J-@h=A$v2ocu~jpLGm@IwD$}As zKR?f;S=Q^Dwm35_FMxPfs{nCa^Ir$u4F&tMv{GcZBcw=X!+gbb%kVYfNEuuxlTI+1 z@M0VQ1QU8_E$6#D<2f9mF-f#sIpjyZ<7WO_FPiNmAPzYzkvnH!FO_LxmESI@-yBUN z5_aAp`ksQ7ibZMoON_NbbER&~CaoRpyTkd_gWV0{RRoqMly?`q2%`7ayQ4k*B@%rq z?Z)j!7Z6j%4 zPccJW-$3PPnbfCGgIXJo4txDR_&oaL1cM5^+!6Jp^T#kuwBIVf;9s-VpMQOa^Mi!V z1-5Ql^i&S#007;VESr4Np(`&5lLO6li0u|7qJWWy%!_HstmcUtRMLCw#;T`57U-f9oR(A%Xx7FqAQqyDo~5*|?koazy08-zjd>Arq1wj6#5 z)7Q#hg=RxmmX0o*-<5@zkM(aax*$hoO73yGDFh2Ac$-#@oO#OFb+$S$w6#5z_8B`|z#6 zU^kFSLT^b(w9JQD3y-pxKV2=Jnn|3Fv08eIyjkIO&14pceNuEz^Q#^`u$&))gld1L1XM;A94I&v?*G}p%HLZ8Vb_Vn0N)RsvB zuAO^1P4`#KroogI$8APbByT&3F3Qv7Cr=Lm)}5Idf45TnQ*XgAuaY2uc zHfbV9sa)Wjw+YIF*yXQxK1jQ0H+3dNH#T;GJH9`Ae>L zo`Z(1*4ezvru~86f1j&3McXd zWfhHt_dm;eWFn}g_kd0bETC<+ato-;KXjUQNe-lMJ1DNncs&!)~I=^X|^J9 ze;+j0KLEs@SPrf>EqmaKV(vw5Ljm|3_306Fyb2wgaj`(f(Pmq3u0giXz(I?r=|p6z zn7U9F(TqGXHQt?E{VcC1X&$)VK>$3i^e_6jbfH}uoIkyGB}+qc95+(R0MzY$lpbl{ zM@&b(6H6KG{jM0%Aqb$ylO)piL4oMxs=M{bq(Yf{^GoF^%{5N74E_(C&ZO-qMR(Ef z&6Vgpz6p!go~Z%Sc(LFlTIUhm-@{H9SygU`EXTYnqd*8Ik1-Asv^~mD!Q4Z8SOo@q20$TG&e-Rg!)SN#}oJ6L{iz#Ui^+O1o;) z$HJ{M8OB&lcqL^_Fc=Bb)iovHpFkkf#I;I_ zIPMi~8$IA6N7vbzcAz@>noy^L(0=P$=C)^w!E>;)w2+E*(BJ|GQdr*od0)WW?) z>r28DV1{h8`CXT(Kciqqsxen-rwIO};k`1eDYR$2Z)YBLE|6EQUXFs;K7FlnEzwk3 zvi-1`cLC`jnQQiqYWL8G$!&>0!QTsCM!Xr9QSF=zmr)1Dj%|1Evp5ja>z%ON=E!7r zt^QU^nDS!wiXVVy+3~AGG5zMPogZRd2C_Ee1+u_k-}DIoWA?*$J|`EQ^=-RpFj&ne z%k03S%d2b_%{Rv~1KNPv-m2cMX|GBaa7Y*`a;eoVHf-Ls-bD@e(j?}EuXT0|uPrnN zJ<^7cTW02l(+#$B=>kc@iqn)G7B+lQdZde8dvq)TDiY|KqYsx*wG;!v!W%in zD=o)PE9!-3LoWS8+=fDlhrnLNT)i+(N6uqT;tQag-K-~y)D}Bw8dPo59K4*QsS1a_ zK@r~JUv`#j{(bM{5&Kxc&(d<_h{I%q-oG#(0c2dJ?Vl#oX^?5c5ORs7^3mJViO!b_ zQJ+K^g<25_NKyN$lY4-9w%CM))uUiMS9j#~DN`Iqb|4#v-!45L2QscxdF;O(U)w{z zkv~1+Qc~zuG3?KmA{=KGzBXnKqV|_>`rgs8P>5{XY=a9d6b22Dq0<6u)e5^SRMeiD zN8VNVGN!Vhs_3vR^JR4^>QQq2ifreIj8Wt(;;`#Zr^a*X&hJ}8d-4i3+u${}!hMOvVe?C=_9$eS3(*Aas z+6gJi4v-)w?CksFq7nwje~OFzEB3--r+A3tNDd-Bc=}D>XU$tfUrhC02lt#MrH7Z7 zeljl%sndm5lnDuAuM`*@xzg6aK%XpClFg1}s;$6&jeL5kixxV*lZOCPZv9 z@8ZDl4%@Vk)~3L>eK&3sM|+S5tmwJZ9b>(<3uASV{NC9fd>wF9k5ZMfzTmP$FI#lp zTVsa|$3CtrJ605xA#GQJ%5OdE{SI_2^U>m|j#F-2C40i9m<)`cE_jsiZL^ z_Pzx@+bsOdA5uRu@M&Y%v34WuI``dhV3XXp!*`r!h+P= zfruMer(B@L{)(wyAB+wt5$T{WzWo02xuUXA0Yo0}XN-se#36aQj=!?Xq z5Xe;-@5N;JJt;Ev{4mwi1CF3y^kFFfUdd;fWY7%bB?$MKwtg`LSGk5)^J6NZy6u;} zw`WPNO*tL?LyA7Z3i>!vTV2$elu&nHf`ep^%Xf($&xtB**~F~nqx4o+^Y5rV)0RVZ zaVoL|@>EE~LW__%7lo`ib4@HZprtm|OVs_XH-NepfL5P94>ROjpfIdOdkC;Bqjrn-s8DkLculoW3 zUB_)`F0dcQCzNq&B=vlqp$QBIs2Ci14+bT_%Dl}&t?ZALi{e1T>Q46RM{aj{3?rDs z$}}EK+0+20^!U(RpF{zON29*V2z93Z<3Y<6oo{ZESTeT-hia zzhj zE~H<{Y^Qx>S{~wFi9}QgXE*nvH4kH?Wm#siNoGagcC3Q!R?MJwhYKqMyD8V9A<~X^ z=;itQ0v5{?j(Brf|4s*4e8etJ)XgJq$jzA%B_s#HltjhM8&=@biE<+KHmTtLb|YKw z1Sf$#NJjb-fXclXZ5$!pA2RE9);)vS**QDju;g`$(q3Kn{rhDSBblHPyb~II4d12K zzUtvkoc28iBukIm?VKXZbZmz|f3-)~N(v5s=A-alM3qqab5e)>gJozM~pM5ZI-VI2y+)W=A7x&U$y_)-q|I2Mn!7(XkIX+=C z>|Z1n$?FdKqieBOB0dMuK(V6EjG9MfsFs$NtALEw?WWGrS4C_~DgC4fPiwaF2sZjg>)9sT;Dd7=nVrgT_!Xen-g=L|+xlhaF&&4>hz>+}UO2BYA=+(*S&>^^+unuy)``1k9Y+3O#p8VCLd`imgkx??FW?H5YdeLP4v;9Nl?TH1eO2JTPtd4(Wyo+Q z?#m5I&gy_=N7$49RQ~~2BwYURy$kdJ9e1#p`hv2`i5?D!oWe+&Cr(fjUIiWAj=}^J zqJ4Ld)g4kk%+l960N0<`H*Zcy;t>FE?k@jAGi_&BZAYs0^JnR*!GjgX9SlH1*pAnX ztcgJvhYAO)z&_?!fJy_Z_L=eKS_ps>7{y+V)?(|v0)_rq>6R?&(T(w*m$FX5YxvgY z=6Yde6_qj+giwLSb`Q%G<2ql;Rx78bFDzI{V&A;^F{DS)TN|Um`m-Tzkx}FLJXP(T zbAq#Ts9bYnSUJ$2jt9tD0r$3S?ZOvtj7%PTPBR_U3fbvu0>n;_9nOU|e=Kk__{d3f zu;)IY0|=rD8o>6L4%9qg^1b5$nSFR>k>pEIni?0joQN>lCP=aC8uC(DEKw6vmo;4Ud zu8xj;wbTD>=PU-grr1Y#rS|1;2WNjnn7~j7R1e&yUkcJQvSkRbJ|5n~>w7y5{c{7q z`2;iM@s?c0RG+J|c%jGKjsC8iqqXP!7}vR^)XTQMD=KcX0Biq5<9{#gH6_Eou(+gW zuH7kwvEdPR$c9%YP*jr$g^)6%-Y8uF3z{jvkFGe9IvqMF(m`U2=S@fy$0gRB!T)y_ zPP4%FRg0gr@>AH6>S6bVJwV*hu>r3ib8x8e8@`z=X8BG%RtF%wlvSisA1e@lSLt7# zVML=If0%1tSb~bSt$V9ltW~9J6FXKNP5wIokOg)@o1HX*q3&C6zF6_n2i3zKtax8c z99tXQ5l-eqeA4rCf3| zQMIy2Pe4*{g0zAOQ5|f-TQ078xXv`*Dl`Q|-^)Rgxl!Il-zvqH64Oz7{0(1FSQGsN z&^@&NFG4JMk4wTB(?RKuM{x&z1YDgDr={}|)q#kNDSb$uRnk@qU#jpu@r}r^JdJ)= z0sfxTnCgL@I=FK*jEH{GH_Cv#2t2>c zm27-u?KWUH)zWQbIRo)(JIW(Baqup-u9Q!<^tSbkY)CqkAFH$M{g;1g`AV_ZyeT(@ zJ#rGWiGc70IE~t$+61gYovYfr-kn|3Okv@xgD>?4_~^bxS7; zYQRh84Rx?K#Yezg-yJ|u!(D-sKbcJ=#vx8fnZq5s+A=HQv7gxM z^&Q9_Jz@5yFDJYJIMb8J#@QT!*wG6{FS0e|JUnpiNxjycGE@x!uUm$xxK*9Mgp2j# zXR^wJ0$QIL91MMBEM6@(H8f~?*g3i*Cow`J+Z{I*P0V=!FHUdCC)wgI^1Aqd?LF+{e#5s6HCosXCj!Td3<-*qiMM`MvFm)6;pT2Wd7p? zP#`ZauhbsHQEtKpK8?p0;op{k{iOTPu40mQL`u3>JyAnqMD_9OeDS>L-Kqh~x!az? z-WAHS*+FY6bUg?)(R=rvyw-WzDM|1*ds=FpyBy}|v3^VlPT^Z#+l{?6eP6udEc9RK zq9?GXiuWbeBH@Jz^^&L%D9(h4I_quGXyO?UUlTK!;vgz2rLVq}JlZb$ z;K+&-Lr6qxB;2qXu3vhG(iMPmRP5YHI>nhAadxb7*)y=c1l)8w{d-4(3-lvOqT7hY zQk!7It+U!S74sj!A)Sy6hC6PuhpXK~!y?$^~!G43@7tCd%IX!8Ml(;vTOS~YK9d?JHT+lsA?ms zg?deF!eIi@=@^no?ZMm`P7Ox;-oS}2{&l!^cnP3_7zP*8eqR+hqmRwh}1 z&CrpB3u1!i>zW!A2G4E}eiRp>i$u%}RocMw5)QWO+eMaPproT+Vxg;E3GaH*zK_St zjtG-zf&a$N7=MC-zQDhzaNNLcu=l6!-T%sEF`CM@NQ-+h+7pYvsH6l@hF>Sn$HO?Ynb7^rEUayYhdC}hC|jpyH^uc_j*uc|I)b`Z>5-{wU`-R zMK%b|33|V1v)he=?j8#@B3{BWNfGCho)XGXbVyhw$Y*1uFn9xFh?R(9iwJ;d zIr%jAHbjs0T1Ko?x=CjY9~b9)%i~(NyTh+4G9NwVyV<#$UT>n=Ng?kUFHoI7e}3h{ zt76sa*vJdAvF}=>XKN!bjZ5{Pw%uEowBK&SbTiJoxNNZtmS` zhS_SQY0?zro?REVfqDXG*g`34BK9<4Z-(F>yu+`jPqHIH0%EUnSBC*~gfY-_GRzOy zQ@B9ivtjGz|N9u&W*OAhrgR?IIb-HGR%U5xJ@myu(1_)K$^F9f^QvdY*Ua(;fQ0jI zua|!g04X}Nz$~n6{U7Z`7y)~c%twE;7x4t_MS30oWG})R za(WWjg(cH7S3IrgRYaMzk!uY8FYwm;T@D)JH(Xz3Nm2I-z&e5db<0NkDt?b{f7KsB z#()EH=EXlc5Pt!DdwWA~Qr?wyx$O)90&D+h%G(wSJen^B{ggDK0OtI^^iu%18w>e+ z_W%EPjQ{aT@CO_u72pOP>%9YX0W}_xAEa+-O3NOqO}Xw#RKMevBs&r`5$X5zVq(iZuN;GzcX086 z!9K^<2u5kE-f}<{TRs1WK1LKY5Z34Mt2?1D!2-sw^ej#CE_E5riL}L7BI`GZ<6|}6 z#a$WIVx12l;Cac_NXGCo%&|~s{&FVei+Dx;#p}=}G-nqD`97@Xa)o zfYYo1u~yO*c0P+G;W56KvHDy$EIQMV14-V>pPa;>UGXtLXHe!>sr(j~Jyc?%)A2U3 zvYUV&HsXgFDtK;8vzY@U1BqbI4^oGX=~tgtef&sRXZR2nNw2a+SG)D zT}(;DacoH}+;0mn-ycu*+F7|(y|>93Ksth{We|!1(l&b6!EoGDU(|`c1m?Jkm+Co5 zv5$ROj`h^984O@(0wBbvp|4PB`?%};)rlirU#h&~_V;x}YWyA6th8Yo>g89FP~+#X z_im1&5+_6)bWtJ>Ls?ZOv*51}-}vosKJlKJMrh02Hs&wX{WgLf^OX}xJ%K=6+xteU zR;{-)Y-=Qvtf`0`jQKIGXQ$bYg>kk|_EZX=AkwY@5?eqV!T0teeGDfz#&)0-s#|FM zpdr0goRxv{dt@QU3I+_q)|Q6i8n9gND&aLm-$NGW; zjKj_@>i`g4qeIckl0*m)87rbX)ANL#gR^5(nz;T|h4Uw@xwp6XEY@pt+WG{vdUV10l6D5ywHnhSU44nPz=lK z?=QnPK8V#smQ76u%tRdx%^X>qb1B8E@}%gIAYDb|nC%5O*o1^861Yh^z7dpp{iqB% zgc34478Soka5d_7fUP(}i#*;=2-EQz%JU@9Byuk`S097%!P&q4SJZzo*7Y&BzU{gl z6jfejf=ogYs8b4I*W=+<@nm+l@5Vim8WvjJ=c zZ$GAMS5@Af9<#C|AGRXI^z{$yw%nPGzEM(u9w){-Gt5JpyZxQV+V|uV8QM#-6U8O% zPO!zBI4VQM(nI@_Hl4^x(Cl-|#i{7bPF|;v*G%-#m=S1|^87mwwavqO2ku>B2M#1{ z07HL$lfZ2Weot&FCUZrYHQadiP|eIAIOA6>Uz4$ZKa;yV!T13|-rXbhQZj(u#`Q=* z&@}cZct^zX+*nVGgibp3=LAvj25gUcnfA_0cu_Xt;(zfk6_qS*&H$`Fb*<9-bGszc z8vVRb_f}U4KWu$j)lHL&UCAXejTlke+}x`Ajp~eiFwW3@*#ANKHq!ai!w62t%>Gt$ z_5yjAYV*46LP$jGk0ko#v*M=+(C`XV_OTqYcx4j{i}jXKu5xaR>z6*3fHn%BPeyiVJZ3!hC=Q zDN`Qnm@x{>LO8J*QvSsMYv1y#xLaEI|Fl&3tLv?s)oR=aW#y|Z0ftwvUKJRQY@v7y z=|kkq%(AZW=*m$Yf(|{_y$KhDvsf5>V**LdTjYphN@gKt>{($=!UboD~Jo1N{C# z&7h0?fT7BcZ6>|?sXr8S*^Osthsd_8x`jRlblf_1Il$BdtE@kL*9}T7!xJZARP<_3 z$k~xHaT(H1(QJy@IeD{PlNaT^HUDmFR0yQBiHr?=_}TMj=1B{}no? zk3*-p0TVqvDClI6xc7w?$`0kM)~EmLhRZA+N$a<{C8Bdkf9ul$0?P*`EDt>j??NVGc<=@+8c@mJE)=DLJWgz5&s06Im z^|zPJBRkn5rS7&yFmkz z{LvF+E-V69r3?QO$|&Lf9z=1+_KBd28pnrYeV*VqOkB>09j;EzA|Z~>SP-+7{Ob?Eec=s&4%41ks!_gnSGi;0p0%`iiU`+?@nXX;h#c%{x# zZ>lx&>#1{>+9qp}?S(q|Wg85Wz{~f=sCvYq!C|7Rz3I%w$p~>zSD$0|ub8v=HI>4c zZvwu%cUx@_CDhIO$4W`Suk z5Q*L{Z)}FNcD@D^w{eYgMlvn!@8z&SglJ0(B&q-s&veM~BhM_d?m5&;5pulq?Ll*{ zU1HDYLN~@-lLZk_J*OW(ekh@3 zs@qGS!*ZZ1UStI6D90O@ceU2ntIlDd_`NJ0$e*+c_VRHMr|5#=obm6Fo890q!?|)C z0UC6tiuCLb76$u0Rq9?th7?&;pFD}0LRULwP7dI#Y$vMHyV8UeHMr6e>alf$;zxSL zPeb!M58QXGT~X;?%4Gk&j`mnCdk9c^FV1Vq#QWga+C38)PWJRz&F^o`4`lo5(^~As z=4befKlM(H%*N)ar!HXeYaBAMwPbU1^9|yu<5qX;lRr#fbNpMhp5<>^7s!~Q8h%qa zM;|u5dzX&)X^aenpb~vsVV(5)3~mE+5rkk@PZf#h%6z3l+BdIUpQ=YOqrhI1E+NLg z4o2Psrx(NMLHxY>Un)FOrXL4mEFX1BOw>6tio5=R&e2@D6b(ZB!+Yl9^@`!?rTJx9 z=NZ-;q?T0eI(OUFTbY@sSQuHaEH-t~o)OMkBx~ryxlfVk%(eZRi zukqffm|Hy~lAi0%j&{sPFK?(h=v2PcD_;#Ld6RHnSo4I`CL+` z-GV3m&_3)4yuRybqxz%!Cu)jU%S^{wfSnDqovisFP3T5}+rOH(E_8l1Ux-mHQj(YV zwq9$Gpc=q3=bZB6Y1`?&J4IU-x?W%iO3R1_+Kw(nH_?Rgef z{^L@>HakEH0nC}cvCOl}n|RC;+3lXWzJ8gWo-2fgDaQ566~~~TGg))nov`v8tL~KD znzLOvp98lkiIveU3CV820cr%XAPVbEKA;rhlj;8A(Yjl1A}}l?AfOGH6{bTH_>7h& zcPl=H)m6$XD73flvw!#t#8($+ghr*ryLztF?vDIKRJ#b!k$OAax1VM|Ow3ee~uzxal@Htsu=%aoX3a^yh%(0Jh<|$Jj z6EX?oWKj9i(r5T!`<0wo*6Guy7dmSNDJ|%pd3XiTxN;F|?t<|$b>QXUl+b(tL<_8b zj~0Lsgz8I(A(xoS5;w)JGwK?z4k1*g1IW_K8ZyB}wvK0IaTV%rgALv~-mC3g3&Z*$ z;_V6iCOp+U4F(lX$0@5K)8BREV7$+JB?&rzu=(oaTfDh6=sn|jB?p&0Nht)`}?bx#M{0v1t{?+tO+H|rlJ*uZ};Q;o^+1s)ARZ;Q@$;iE!TDqJ&VCS zb&&$ufN81zuXTIN&+Gkg-KZWYup_C=S~JIF82sgxi|s(phjItsKs z#w-H!=!3NzSS*N5mXSkNErUItCm~TI-4U1t5D{C0IOrDX8Zf^y3#_n1P3!BdQamTy zr9hF$xbJ#+c*uVLe!qjoRDkDC!R;j@r_Nqk@@;J7e&dLw>#C?tUn6wf%Y7WE^vnnS zO#>i`21l)i26gst+0$hBV3&NGOQt7!faqe`lQsrS;#GSNQHpSXEjR#YQ~c-Aan4M* zYjPVX6R)bLXDjGWgoK0usixKbLI$WcB0BgSjYO|MPz4BhtVRlWZ8~kQ!H}bXTvJ7T z4A%(~ln3V-l^6;a8sc5KwLZVe9>-wnJnV86_Z&G<8W^)HYk@%k#+kHZ!8@piSl<5fU)s=qQ) z8P;8iMnKMS>lQ?n44RR$f@mb1sD@x@IT=QLbV+9ysI^vLFrOK|;_qMYK(%pJ%r%s*9oyRjRKZ;wa%{C~v+I7~|jZ6Ee8T0<abc*C7#FQii$HO z@noaIoqzF~2yOCh_YU5~F9$f^Jp><2EySB*_XHTG1VF8~^J}&9l;Sn;9`yi>9R_rg z;wOUqZp%F(OZjUBK#jQ8MoKEJCo61Y?}8DBQW?_L8kOESD~#}B*9}*vA)r9&1kjVR zyL$zIL&hD~E{1bccva*afk8Ie$nEbTNPgHQ2CH5%&o27ynLwhT$1VySpne@>7*{AG zKK1I~2uU1r6SFV={4xs*Xm8rBdVQk0*PD52w92Cx*!rhXWj}ToP~3X@HlJ~3YuUIx z_Itn+UQ?zFy&9#Y@n_G)h02(rU9UQ8PTT)lhnXoz78Pv=H5?I;GVHNL{X8Ltc zn30nU!+PDN4U48XTdworOb+BAnoFg47Z;c9&nr6kGM;0a!t@nMTv-`9AKgOjsm#FnLGP)1Yw;LT7WB>ouvhizBV-F4@SEiqRq`1E=I?>dp zzej8|i)jPyxNNfI!?3OtVV&cW&<~ zVx?;rVtB4zyJnI9x=9)J=r+hr5)gvi&wi|2DTd>PG^#I*B*=n7E zi4eIpJE%*Q%}~KtH%a{Cm4V!Dp1stx5Y>dc+ytEpB`pRU2_EtS7?pxuO z_;S3%u6ydATF^Jqn>b6x%gr{ub%;XP+ZcR^2=#P#@%LPR6+G$MS>kz|cRH|0SlNbf z6gg0NY;b$EIQPN#cfhi%<(;wR{umqW*&KeK%}(G^nFIq#e>DG}9jhN1ZPHhDZz~l& zE#Z+Ri762FkiE4$;8s2`;`OA*o^+3nd>jbGp&DO7jOPX4hF0aO#K*`i<%ML|I7&ur zQRW(dOo7f8yB?;=pDi>mz5bsnpsd8OQjUkcnlQUwJqeF%K*8DGadwDGFE zPL^%4XuLAL`*w%IXoWPOn2JJn)1DbF2An4VN1d1Nx*}TA$_5*G~Z%+MvSulSw#?catUH@Vs}|;S&n&@SsCZAkfi3%r&Kt zK2nQ-3>uzo)?)YzP3j|d*3fA2?|~-*l-1fpuu{uqR~Q-R%D8&6cJWM-<8*6|@m81; zQFL5Sdj05-lpzXOM48)DYAgaZt;2#asC)BvN~cI{A}Lb#scM!16U^53b#O3;$ZnUa9n;?_+SXO= z=U|{>kA_zxT9_4`Q)_S^e1Z!a!WBS1s&@EXOY|7715W+D5BD*BGX$W#P|qN)?7q?< z4OB=0(Ypyc%5w1Sy;^2R?1S!jm~9LIq_qxo3Pb65 zIn`5yDqDdugVIcbs*}j_;3;I+zQIm&Q^X##7(*$gzW%}$;C=I62pdHPAc6X*^7J{n z#O*7yu49&Ziy6Me+HMWEI=emqyz*PS{*r&`J zmu$8ty|)vq&LDd1JTZV<+8lsFh(hLd%zde+Bk1;NCId2=uy_=>9MnAQU2W%E;sABf zhHZIuIWz{I>%QoFx!{ z{*ha8P+gSXTql>U!z%799PjuK$4?@XJOe{2n>DPk?>qy>-QrW z(qGYtWQ@OU1FBF18UeW6Wi2YoL7CZN};-HtiAXv4a@;)U~f=> z3gEJuzJJdJlS!r%Pbfu0))|99VAjubmZF*L2`X<5ps}7oR7v`SvMvK~GWPY{@^Rms zMCbU)*Bou(t;}Jkv?%`FKsipJYhX>)*PXb4kk5dyuQSC{`|OF;Dgrwtzk^FdWn3{Akj zmuvYi%IXF~%2NtYdT3A(85&v!?}+1$eLL;` z`)c|4C2cGRKHkf38rhR}P<$M&l9K+}!l@Ef=FZ?S$~HCy?rS4cYhn~E1bHw=lh zzrP(9qkD)aUd~SYzaoTq? z0Yco~?Sxc2Oz}+Bc}DXYiKqgYdCD}J`oY`{K`W(1{`4}%Ky>XcLz1Kb?vJcR4i~s5m6A7b`hykq{CHu6$GS4 zrAZeMB7qQ*Yenh3Dpio)LJOcMy|>VVv;cw7LPTX%>5f!%%&)b`tRa4mWm$uG!)y^ ziDFSon?e0FDi6kiZ>aH@r6g0cg&q7vscV|1<{NR3=^f@vml9oVtdIZ3B4Bu1%4PTw zLJhH9h02h0J}4vGH2M2>#m1%hd3u)o_3~xgypY8lmaV=8@ZGaNUR{>OZps{eG+F!N zx_RwDaiUNv;$ZV&Wx_W}ck5Eax+dEem?o%V6u}5o!)t!&2CM<@AK91p5ug^25 zmE3-FePn|iE)*3e**hHjZsMI?0G8M_K8Cshoww|N$95xi6(_lqvT4=r3)yP+>hkRp zCK9oo4C1Vjzjjl~a#}pZ|I98$SeB&UlH+{URsiMC_mT~2C^Akko z+l|gWVpjnMQQtCvOU74E0>bQe(BLaZiendAEX%YorO9!>*0-w|mR;SIZ6oKs%$2R5 z>Qgb|s*@t$+EM>>eaFWN<`~?X_QPQcIeruE)muZ} zk{+6V@0TL)3$ibA2G$v+b0Sf}Z#%9SvA6z8rdjnQ>qQ$%r$fi<+Lj{3K|n7?6>Vgr zYdZUfddOdK)z#iknz6#&GP%hZk18B}sv-&_S|2?Ft@4<8`DjVN3Y*Tv|8_K;{vp4JYtQ4)nFEAde+lGMr_QV#*W*g-{yIUOYw^0v$gD^q#5?QbB4pnoL>Ej(ThkBm~bE}0!NI2#>-!xGkxRbeUoif~nW-JNDKt0zg=D3;;8RpM6$Zp4H`OR)&gaa*Owy_(yI0-ez~U_CWwVa~i&**?UzrU*gZ$*@UfWGa*>w)9#5|ToFeXuv)LXH_Js(1Ove+ksdpOo}k|!jXr+7>A6HIQ$B;PzZOQDaT1?xh= zP{M^~h{<>U{0syJdh~Rw6{K%0r$4e_;-QN=6X6)$tOT5}xAjo@>C;LeS!-}< zzQCS;RTzp|NK-Z1juHm7rY$X26zGR~IU1vYm>~^q&3|e>It*XOfvwrmeoHd??WBym z>E%zx+Cv4DRL#tE0mC}VwuNtx)(;y~EemM7^C7>l$7Vq9UFXN%6V={)6YoO?vyVKf z%SqK0tDfDefqK&Vu-AVjq;|K95n1(7AVA`vX1*MKPCivXb$+Ye zEfM+XO7MB1sDlDCo32}%Uqp)7YlTYf;k=<`t~PTs2fbrg*6|M50+I033`A|}L7v(8 zMyL462u%H1I!~D&(6MMLNVtwl*c=cEi}nKU_@dButI&fl$1a)Y_$!8kSTNp_L^8BQ z2cIEHwCUpz%y8Hj$(67fOX9Cpbb)`J1th9^9ads{WM$NbGd|bcAKtH#6TzEd^NOE( zu08}M{)>#z&i(^~bhW;>o%C`;n zAeWmZWZsnXhJ7AknV3sA-^u+wDA>GemAjvClW%p4bP0rFbghZ}v4nuensZ{ZQY7Dn zy8Y7^L|ba7r1bGg8;eo;s=u{|NHr&fz|o16)Te1dwN5A=q+R>`y!=}hlse#Qr!PDt zyH2v*9~0c?AjENe?}E3-q-MIr_Ze~_K1h6mpkd*UnIdtMV%GHvRW$`aMx{wUgaDX2 zs*dn_L&{2!%+(B8-X981A=g;#-P6w@QeDr~K{AaE95 z=dy2Ro3mA7sB4_2Vz1liDL1!A+?)>~)|!kaEvT-XJm10(36RlV8Z6{Qjf|fugc{(6 z7Y@7SD+TPuc?Vv}uJV&_x*vPOs(DM#C6=#rQKOX^HR%ljG2S)|y}xo^m&5C88-1b3 z{Xx0!k$%0|V)9iG6zuyRA90ga)bR!Wo9_Z5ktB!hN>(R)y+ugV*Xu}i=Bys(y^ATap)i@Z(kKrZPK{rtpt{s&r8*rA!JeuY@Z0Neu~OMQ+y(OARra1QoERf`*DY zBHvG+xWv`HdoEUQyOJ;?Kt>Zo8W;cBWzp z1T*CAn(PJ5zwF{R7*E)i2#YRgN3!}OdopfS2Wgj{`}Mc*d^ofSW&S-fhXx9Jm@dME zD>ED8fw<$=XI?7%>#O_>Prh9Va|$9M-6q~{+7)@k_5MXoo&T?c|M@@Vh~pWfANJ=v z6L}q!eW-ORE@Ksvnrmj~XeQ5rV^nR0`tYf8XCzxnQo?7`LgDQ0Js}{8i!_74qmvll z+t7pnG+dAPtnYmC+4)cx`aZ&{rgLp}C<(Y{0m#SaNpeu(DvpcIG&AO~1iIzv)jKPo zjpP8`Iq!mifB;WQ)7IUm^GV{g9*qzWlmUyAL+6$`}FXQzRq--V^6$eDc zV(#nx5;jD3*fJhE#Lc65TjlQ0-i4 z$>ioo*|d~bpng$KAZ)3B)e_~SyFov{`AG4}f?r>Wo!3Y`BDLA)8qJ6Oy)u%@JswZY zTp4wJ$&Z|W{rdPwsUMQ==uwz_82}Wdwq!i%p1Nc+)3ye>GeyDm>g8ar1KcI1;%}2c zx)9Ay0Dt9--q#;3cjuhxDX^@%PURq_T*tIPOlnhRL<`jhFxYd3;qRFAQ6pD93gEX| zWAf`Yz~^~fN6W;S=o6o5fkW`v-n${x)BKQG$7g`kGQ7~cu)YHkj#P&^@)8JS3 zKCtC8ba5u0z^l$ac`X)VH(d0w#BF8t!j^~eDNaS5$xGtjp2RD<=03rZ9$HSg*Q{7B z$gu4Vjg>rY6~_)QkCe85Y`n4o4t~$AHWmj3+BIy&$A2y-sC-Z?)|vlQ;S43r$lakc z$+vW*Z)f6d8$YlNXlW3gB%)zLD?@7-urSN?A_n%n|6cJQAI9-Pu2v>@-S#yS}b zwm;ja=v<6Xko+8+RqP>@;07{)kv<@y2Q6AvtD!ij1n<0bJ#0^zqB$c6$>_=D{F-`0 z)y2Wj*>tReS2wYpH&#gbIWD6}zk!aOU7M9Tz_CiX0%S^jCSc#Uv{rIgw={nx#B+J! zj_=3z&8{fv)!NO9^ww?i(xBjcr8&~caV(aRrcG)JQhl=b(m=Fkq>?1aiSCAlD(>Ij zqfj~np5BWC?^E4pby5i9Pfk83Vr@wx_%^P@j#hbP*A8tO=RgYU^7cL6-_0>py?XU( zh8LEfHy>hdR`)P^;bOuN7Nlp)=g$k*OHidrg}2d zwl$*U>AE3tvpZ-bhou8e&Ge}_LX?1oi8U`}4Uly7lnz7m|tKTNu5PWe>cIIB@kyaU)~UQ%|Z z!AGve;bNnAkZfpbogt7Ufd(kS)QKU&kh<&fHynJnaXlZ?YxmXMO99UoJy#TcQT?}_ z^jIP38EWbWlBM}CBF5Eai>63x1p$kKq`Ud%x=xA)+DA_oF4F$(k=W&K z<-GekJVL;T&w+!sLAM%l>2Ap9&3fGB)rt~5mIhsN9w~05xNQS9cp|L18OZ%RvL;;% zd5y9Pton(j<;27&;Q|4F(3PC(`PqSH0Xr8F$X`Ndq!}29?PZsNw%eao(4-?D z3WO{Z+rJ(0On{?oAliTDM#`YvrlW4+)#Mxkh)eocM4VkwH>XHP%pn*F&;DCs5VFv& z+sEaR8puV7rv@p0+iX<Z=1g(P|u*6%00yQt7K+W=kpJQj|?-Bp~_?oF_MQ4)OtrILABJ?L`Bkyplw-tSCoWQR^eF#NA z?3OW&ExV@4ObYHtvB1XnBSmSQv>KZK8#uAfjZTc`ulStJ=K8i;XJLy^Koewu1_vrv zn%=BexdO(x4&)0WUa&_4{gfGW1?v&g&kn}CM)Dz+7C@l92f9UWu8Q0%GSEx8c_omz zp_w3oM_Wo@_iKrmo6WLPb-NpaUOW3NIMq7XgDIc4^AxDU%Q3dk@U06FzZGMm%hEX@ zLrrHZ(3f6#aZHFpW)j5|aDoF$v}OW=|6$%qqg4r47>vI5O}B+CHGFGl!Np@spW~1g z{%|;GOZ+ENu7iLsMqY|T2U4Lo#JV{Fa>~5yk;l7U*mV!9KZb#%a>3|Wrgm(ISPU(5 zI}|ufWeba_5Jc@J{`cNP zn`_nMn3(Tx*zMwwvz_l?6L*?Dj+ClNjuA?1Pg4!nL0%StMs{cUJ4t`TZLh82vQ|Ol z(D&(%4YpDmwi7qIPPa$#X%hHk8I75n98S}`Y2QiIY* zgKjT1Y8a~k)r~HP?ZEz_OdcyE9LKWC`#-7%+n0Fb&SL|TN6T%yQxxnG-_{=3>qs43 z2hwbBGvFLcQ{5IU0kaZ@O@TLMMD!|}7FfpM(1qIdb?_wbF$87MbsT7I9?V++Cg@`$r&fSE9JS?-Ixab?#v*=eDy4! zKUcRrIjQ5oK5(zjIXhZQ4M^@dRf7neaKf9vQkbH_a>q7b_8WiK8|sWMc$3w`CO*rt zxZd{JFz;Sbl7e4T*;u~JdSj^FOw;K;q`o`Wf70dA0iSMSTcyWL{*2<)AHu%NROX~D zM#v$HjWB;7=f7F4>r33=^{QoQGkyGTN8$dF9H~!`+`9re{HCE=!QVkgq>%@Ol*$9e zk8hAJg{!P(r^3vefJD(H)H&T5?Uu$$Pp~VbKgl9)#l%7CXB$AjotnDOCMV@tM@8rr zNz)_qofaCOhr;#g{I}*-3Ere5UegQwYLnYCMi_`g_@cHXz z8Rq3qZZno5Hy1qAMPMO~>Y$!Kk!D5^CVC_Tvp%&8xKs__Sh)`Es7mxLk#1x6+DYxU zC}DyAEWK!u!QMzNusZ358>gO)@QIO1kMzx}LHL@2LUM>%<{|eMpRmuxc}wrjwnok(oDmU)_MK9Wo@GLRZsIDVKtNlw ztm+n1Xkg8FuoYWs?X}={4M64IpSOK~!%D>KlI;=12f#&7Zs6l+LUte`|4#6hG()F7pXV`ZP zLWEVsIx1&~gV@E)Qp`58?*nR& zCA@T0v*niph56StC44}YIvd0(|1?Z~yzI^0PxpGqlUHxX>m{c|&9x)Kp3`r%-oeqA znEU(t^B@9`04<|JrV0gSc=OYTzsy9C-evLcKQXObLdk z!B|T<;dv7Y5PvbF5~73HqL;8$wQYqrL`37J7M1Kl931XT^S#lUDpClDktVuL2!2x6 z^QdjCrHogL9xj9&>sLE{VR{QBXIn5X4jPz2-~i8kRz#@NPO)L*u(!8OKOP|aQ8xTt zS_WTg-CP+^UOyhrTFo#h6e2el+aF5)q2T%Lv5ZsZ5OFF9ftN+g4R@z1t!^K&Y_5eN zYbqQ{`v~K1G9J@^&9;Q!>dV$gSll}3Oehx0sNVuH*Ei6tWX88i3Xd5ogw$InNIBYO z^-8F9CP+$;1s$swm}#nWuh37C<)&h9NNuspzYg;Zz{Vhdd3;CJ*6KAji0Dh3xCKi))c!!SNajh>meqyiM z?zG!wMFc5pF)e|H@tTa&t+N+W0_NGgGC}3-eWEv+@d&AP7WzY!MgR~vaD6H^L0_@J z3$gG~Ee%1_Qlaq6 zc}D^Gc{bV{I-*-sCgw7DM-5MG0j-eVMsd= z;tBg33|IKHYExQCh5x=e6&Mt!#gjla-kWl|&41A|J^cqc44CH7OY2(3UGlw%Zfrd3 z&B6C;TJPrr3eX$gHcH4f(@A`;7KSUC99>w4w4$Cq%62-&$C#Esy1 zP!6kU=1RXqtNH*O#u*ZU=gtmrDmX>Wwk2Btf?XI?4r@EspT*KdGoL-%&7=z|DiSrT z-SsmoAsoxOldh(9leg<%iYG1{5t!DatbJmgov*+T{9C6BLwewRd{*Pio%OF~Qph{; z(V((3;kJ513GLO{J9)Tf*YEET%U-3%C-KLd-o5eCZVd{|JJYfM6`j1spyJ-K5s6AA*54m&ZNIVk ztHOxJ{-+vi!*Nj7NNo!{H(YE31fVQNu>grU+tVG+{c1;R@*6gvT5YOS@T^Wae}!%v zb#P{ZrV27_nqJ~5!s4*M{#EJ+Jz8ZcdJk)FH$<{{)4XkHy|UA50e;+v0H7gT-AAY< z(Jc3F;5egkT5QgiV_-)&QVpQ|aTY*u6KXFi*J5;ll zpe=%Y_UzdI+XRib3yghM3g9EOJ?NpstN)M^@YSp=R$2xGd<0J*ppkf#9W-g(iB3yr+5Ei`V2t8#(!8=o3^L?ofGId*YDVzqJ1x#T;O{cddz5{4S-VEJ^m9I$tnVn zzTOSmmjWu+{}2H3IX#8mGzjRXqdG0?xV#m!1Mzj18@Bqv}mZ5*-NepfMDVHKu z=$77ef%YqnP;L-m7$U%0>qC+V)grV48?gV5UyGAg<>mqAuhp#Idr)#yhSpUB=~%fa zde0-puh4!kZ@7ONoY}XZsVYs=1zds3f8NKsXt;Bt5%deMfqSJF5FtV#1(R|M@x_@)lFpZ~xG+DF}gx0FArD1l`_MfJb?MS}Ye zfqD5q8;+CdY?aAKdCm5}b|kGm`;UR55)-UxKL%GA9TlZHl*~)}P6)J@`-45)to~k%_PzX9zT$6Y=j;E6fnn$->pW(%TrkDj0B7Q`nFlmS zYp+eS&4AoB(EF0BCIB-ttQ)n;tsdI?CFoTL269Dxb|~NCO-V?$rnC#mEM~u`&nVK= z`_;jTaK{^U5sA|7u)$P4nh(Tq{b$+$CiL;IiSZ0Px%KjW_(NVn&7fE2S~(konR-F? zB~Z*^EFoy}GGDj+L5UZ}oBR58oob&|fTDLj$*)^+MLiZJQQk0n&VFhx)>ouN+|40= zAl4LWSqT_UE3$3v(}lv%R&P)|I5k%T+`s#cu7dXIXg?-ql&A_#f2vV;q*d{glKt{4 zai2Z)jSeFY+pUe&+2F;<*#wqP?jsdJ>~aBLO{Cx?Ldoimkod!4iwgM6(&LQ*Ha02G zJa&bPQ#7enL=4r`cqu;fn(wQKv2st6z%}5!6kT zh?0T$^Eq@SMHgZbSlfXCF?YhH>o0-?H5&O`ZReH_WXH_QeE(ETkr-UYC6g&f>jdYn z4MzC2n?y_J*X$Kq)yyxGM+hPr0qG_YH;UrQ{H7gc)|yo|?aaa{ba>)NC8fIH;^~>jXg1? zUE#Z6+c8eP7-OaVZgwbs@4Ma9)J~E>z@)!JW$o~aWNBA?DI(E#;EPAV(x*8jN4@su zP-voLu40dYeP_J;QoY$4YM>$|pc1x~JA%$Wld{s+crW)w*1X3#1rvoXKNfEPC=Wb&eZej~Scw%EH(kXy$bVmkKAh7``zqVJL`r&8Nl|)@H z&f+JaMFRmJs{P$2CxQ~iw`DnDfAvrMv5JB_fo{OQhM#(eJ%^P}E!pfxtw-zO*4QtTlztT1a?rLn=X z?e(dLUBVY@QzZTB2rHD_fqdh}fdlu6MsaUa z>`>$(RK6U#J{;!l9AC3sUaXT7ktTxbj1vozD0x1W5RkooiwX3~;!X0ZcDqgri1!!w zO|UF`PQ(Nthb1JPM_a&9Q*`yHm}xJ=2-G1h1i2c7du5Qt_ZpBY3>9Q%dF*kZ27(#Lslk8r4+qn8>%dx!5uLo%ph4$G|%>+-yXs-dYqQ8snapVG41=_tJf(Yi?cYt-G?I|zo|-B>^PC+e&CuN zEt~yrF`biiTX{m3Nn^BZ5<-q!pJO*GamfUO_f!M!$wS&e8_}AA0&o2vTwrX<(A=q( zkC3hgzbqZL&VZpjvyPq4L}UjN*DN>zDN1?xhl9d{wTxL2%h8OBvd$C6g{&u=-m^KO zUQK2A_7>GWy|+3Ynv#lnV6rhe-Q_qq8w-Kn+}XOv@!jK#Dg`fKsWA!vT<`tmL10wj sUF{`Fmj@{q9~0(iwiBPiFzj)f+?%ky?sKl?5cttl)w^Br=l$pZ1Ljq#LI3~& literal 0 HcmV?d00001