+
+
3. **Removal of Canonical Knowledge Base**: The ability to create, update, and use canoncial knowledge bases in your assistant has been removed from the API(as custom knowledge bases and the Trieve integration supports as superset of this functionality). Please update your implementations as endpoints and models referencing canoncial knowledge base schemas are no longer available.
\ No newline at end of file
diff --git a/fern/changelog/2024-12-06.mdx b/fern/changelog/2024-12-06.mdx
new file mode 100644
index 000000000..d9d6b49a7
--- /dev/null
+++ b/fern/changelog/2024-12-06.mdx
@@ -0,0 +1,24 @@
+1. **OAuth 2 Authentication for Custom LLM Models and Webhooks**: In addition to (AuthZ)[https://www.okta.com/identity-101/authentication-vs-authorization/], you can now now authenticate users accessing your [custom LLMs](https://docs.vapi.ai/customization/custom-llm/using-your-server#step-2-configuring-vapi-with-custom-llm) and [server urls (aka webhooks)](https://docs.vapi.ai/server-url) using OAuth2 (RFC 6749). Use the `authenticationSession` dictionary which contains an `accessToken` and `expiresAt` datetime to authenticate further requests to your custom LLM or server URL.
+
+For example, create a webhook credential with `CreateCustomLLMCredentialDTO` with the following payload:
+```json
+{
+ "provider": "custom-llm",
+ "apiKey": "your-api-key-max-10000-characters",
+ "authenticationPlan": {
+ "type": "oauth2",
+ "url": "https://your-url.com/your/path/token",
+ "clientId": "your-client-id",
+ "clientSecret": "your-client-secret"
+ },
+ "name": "your-credential-name-between-1-and-40-characters"
+}
+```
+
+This returns a [`CustomLLMCredential`](https://api.vapi.ai/api) object as follows:
+
+
+
+
+
+This can be used to authenticate successive requests to your custom LLM or server URL.
diff --git a/fern/static/images/changelog/custom-llm-credential.png b/fern/static/images/changelog/custom-llm-credential.png
new file mode 100644
index 0000000000000000000000000000000000000000..48076e161463c29b5ec1e755bb317e59ead723c7
GIT binary patch
literal 292360
zcmeFZWl&t*w>O9dNN|_NLm)vyBS9Mo7F+_s-QC?GxCe(c76=f6yEpDmNp>1oGjcdC7$5jc29AbK`XJEBx z>-z`g66C24a1;9_PmEG{@G8+hxMt4HXqXt92ZvpBU!s^Ke6z)R=t%E8Oi7t9Qe?EQ zsHqVuQTwG~JLaT?4((pYz>TDnbp0(U`W*@K+t?LMpaF>2N@G^AL6&fGhSnB_Y!KZ* z(Q4(Yzy1DE3dJ;*5C^$gBksEQ&%XL7XJU>+#ltP?>KdGI6~COFk#1=09+sMhxPtN^ccX*2u<7FVvrWw? z@36>Mw=--M^;vZG&}6=+6WSPOghdz@)h#;h3v?Q;9uv7fVNGUFs;%#~JYwm9hbwV; z+qZLCx-&GXk5P1!-tjpGXWmZ^$kb9_&iHQJm}XOwBb4f{?^>3g $n{^=fJYqw05@zZs7JG@Y7fDxMV zUuL3?OFZ;^$*Uuir`5M)Gkl$TbTYkXK~HbsYJcYYtm|Hf5ap>e8F3#EI(j*lJrgh` zy5WKeP`R!}Ixt4&9&CEmb3DiSZEBX(H?ifW?Nz^%!}a{~`p$Jenm;32a@~3V$aN#5 zY^Y%Sk!vRp;pO_nTC&zlci^TbvT{q;wFA9BZh2y#u9TG;;=`&jOQ`Kls_p$K!|HQ` zV7Pqi{kT|QbGr^!v$Def#pu&h zPE&tR7a^UCMgFVCErY$Zsk z1r*pA5=n13cNT1l`?Nf@Ux5AiG%o zvvqy@xm<21Rs=1c-{U)QaH(4>%I ZnF>V>!^b%>xw{ zb=u`_GAwWMJ<<$qF~h*{@Bo%8_s9za{Lntgm9= zKX;**q+41gGNqd}+vwY}OenNw$Q9dSY3{xu2vM=348c0wYPCCEe2|_lX&S5sOAk&P z1U6irS;|LZU#h9e1xWcs FW zBW|<9Yt7ls0_16Ibr@?)-Zs4sgSlVY2|lC(^<(_!ixduz^66J$Fk4x6B?cwNtzH!} z#Y-lx;V4#~_RsORg21Sl;U8M-I!?C>O27&9=J zd3{|=4>-rbV4oxEMneB 7J+7#=~PgZBF26}&GL-Zt}*fo7` zZNQn#eKr27Bu3l7p t3Us zl=R@pFp#~a-vc65{i=pbw93%$u?^nkDj(Iy?C4n6U`Tn(MhjNVuC(wcka%uh-jz<6 z_E^kj>SYvjdgHz=ys~@Cwuk1(q>Mqv*w)%+NXFZg$*=AD+rghI)(kFFFw)rd$3_13 z4m#e+Xa3sZ@l93t1C0oe7_s-zz9l~4mHU0;l8ol|8)2-z2UZGSqtG8H3;^~)t;W`! zGp@RNtt?FLIz2Tt2r;=MIDx`5Fu FK>R(>9kRmdl1V;Rxic#tvAeLxej&RztQngB`i zHeQ`<$I}zbrXn58zk^T gTWmRL*vz{@&4ApjGu3k3Pp{ZFA_iVwMHE z9CDQE5}Vo=2Cbvv$X$%4hgA~%`D)#8q#JR|8?l~T=WxQNYV)yNk+ZyrGkUL$5}fP% zNq%0SYbhbwFJIE!FsZLn5C$9g@jkF1kMug+F> ^;YDNHS` zuD$b|t#FbM6Eo@pu<$<6jPB~kn?@v+(&KJMqCca3t7cezzl3h@na!-&ymy#~bxGH6 z+v)0mMi>iMny<*8vjII4{yrOXk*`ea)J(-Crs|sNhCa|%V%| lWxmaiKVELx25;|hAB#cepP`|q)#sROGuw~Q=4MF7<&TEBztdL zo6RjA=c7wfP Bx+e8*H7g~TY_%{sk7ndbM{rS0OW$mX5N;Sg|0+u% z;Y>TnTc?ZeSteV>nZb%GwbmVJJzg;t6)v@TtJRBq;{7m%G~ntYcAfvcj;VXSOzwC$ zYHpaz(VAU;*PV+8CsWb6KE=%(4#g)K8MIdapHb$dDPO=Q?(vh1us_NC*Ld1aPPCzS z8g&=WHW`nqI-Z` +B9=X6E*G*Z|X6tC#ALA&OZ6ryC*iW$c`K$qIX*+sBWpL)eR@^ z)A87Ho#fwbM}dit1W+cXOW105sCTb$4@jtX!Nwl-t^F5gE3a{P0a>m ;}Kp4{cOKmLrYQG4OO@QJZ^9=*aV44YD61_j6_s0Qh@ zB09p9Kg>z<{H=YEW44Pb8*17X4A6A{BzG)7h(P#BbLp){XHrad4t&>qbqdz4lg+t6 zotG4wvqwSZOv67)YyUXyn;zjUZwPw53xJ=X_Z_x0oaPZ+ZpYg-8aaDHTjrbW&_j?y zn
r=yo0jvZa-$9Mx5b z2nz&BJ9IPkjX%lP5L1srhd$S~DbKr=CRWV1TieDm@=O3$h5|!r drTk!!Cr?miX~a@l)Y#1L>RV1*9Ssxec{-03V*1P{iWYAm(jhX@(@99v z>8)5d5zARWpM1sM332y5zBD_#Od>Nnd)p(-HwG4SRms=XH8)gybN6)RTZYN8lpYu% z9lujM!Y0r-_;XVFXvy^Y;psxX0kksQ+zl>m>R*OH+BQaXP1lZXal???%IeY;RgxUe zeGZn76Z0uI!=f3AT84ceN(I;Z+X=z5pXl- kyo(?bjfT4Y4X~s{{=u14Qv}2uAC|KRc9 G_UVMoJzenV1Kp=hrO4NYmEXV8 ztkd?krrq9=gHDoc^n0Zy7LfG!Tq!ONR-_J$)gTa;KkQS6$AxPUtE5Rdr1W6r)!n#c z^f$7IBBs6CB9z*Qux>gb4ukkKfVwZwT%6+f53_r8jG8!x+ARVWcc@&gTfjW6hrcLX zT-{hfpG^cscA!jFR^ -489_V|ZTfuWBye5~io8U-8?zyQfa;`leGpUH9Cd zP(HEd E^6yT&~yjA^c&>d&w;TZ;&z6!iU4mLLc zSot1ua~Dr}+n(5~2~d`2z^@5W>R5Un%oo$$?9)}N0D3-@+n<4K9}nKF*Uke?P1Q6C zS2>vf?iE^9-?H{AGbAFHkhe#={J?a7J%g;bei5|26Rtnsb!D?(lNFn*V5MMNR}~>$ zq~#M!xnW~Hv5((Z%v3pMA> =X1)aV zxy1vbBM!iRaXv@r3vUWF3I1ZB5ZRqp4wfj}o%qdXANYA@9z+X &%a+m5nSnx0(d>AMsph*!ET_(@}tcLOu6R%t$kce zu)BpzxDjpLL%_eRJ^99SbkKb5Er8$yNaIX!#J6C!zzi(D%3QRWGXK`k;m!J82XDTK ze*Y#5Zf|KM>iv%YS4@75+>QD^MNWAi_qfCzI%}vra7jpY8MN0UZ||lnh}eha8B90y zB|>EY9@>74at!YF#3?n`cSF2JN5nI$ndA7$eE7zn84YT<-l*MWmP&l2BC2`);3G4D zgpS_PUSpL7UlOs`u;9xz!xF0RM=vX{nikZ_;h6X-FFzS|Su0neCe$Tw`#^HVdLe!f zKsZC)4v!auQLGWAQ6TZ^xWoHz8~9tqr@5J#Hn>O6C9Hu8RIzsAEl*Y6Xz84#R%h)j zxlb+Kr{BW%(}`{s&jV>vaL_uepjOr9wF?KFPyxXuK8Q4w 49lzTU$tNiHltXPab?j`ZeRnw2Wk&vDm+gCU9{*}fgDai9jhxwQ$ pvUWVQJPqJmw1;T51*h2Q~DH$Px?ub5D+@#|BE{*_g{HWm!xMUy~K_V z4C`u7u_4K?YE`U}D2bycC_lu+NJmawcoPw?v>_be Z}?( z&>MBO*JRdkMXoG~n70{6) CIvjCFf+1vrx@o8&mlR~Nx25e;xWrzV6y#C3$YdC@v$I#)=Zi-+D}SX@yw zB;UYi`r_KedzdGlOg|<%PD>j_eMG(_UmNSe9Hl&29lVcJU22dkxu1R2)~5HP)N7Nm zbKPD=Rkhw>v%eUd0& C#*`Zt@OsTdVcW zEWPq^3oA084_tdKhcLCI< %^aBbkmvL4c2@;P2Oc+|)e{@x2a7<8zIc$`$^lkX2b3FZgsOXzJh) zm!IkLQ}8BUaCN5K@aRduQ~ab8)s+&~xGWEJ-%|GRG0zAB8>ZFUfA5G1F1LQw_9C5D z;Rte~E=#5OZD_>O(?IX$SS|ZFH_)_eG&=|CT#ZG4EjUr(D5L8g5 $4SX zQ|Od#C3?3s){&vTh{RH)WNi%_*ed1^x3+9#t5q&kWJxxUZR^f+%t}7*M99bmMeTFL zN(7{K6;Rs#NPnp9zn)iB`}?UtlO&j364?Xf1)(mBfZ8Y)T2F%^f|!+Mpv${L@N>l{ zs=IM|u?yH*bv!%ufc8y XxzM= eh{7{<1{L~pHA>G$YcEQib9DjA*fx0H zd$bKSa8YS7kX3zUJC<0%^kP?2MrMe8ITDW))CWb07sa#BK6yWwZ11RA=W+IxS45x2 zpIHj9o>t!=mg@qeXx0JV?d-h9(J5E!vn^v~AO2Py<0I(S&n^=sZ?`%}XYCu_EHBV4 z(UbpVXhEu%x>7YaQBz}9!)JHAl<$3cS3S=>cR+|KThvXeS~^l$0eJ}NaGsw4)LyPX zqR-UGs;UzC-sb!EXFkkkp7b-89uxVV5V?UUrlzK@hg~5ZS1nK8U&O^(hho_8JX1Jb zfI=e~R3Db 9l7N~bu*;gUurwb)o4&_Fuh!!uV9Qo^OwWTvxNl>Q};Dc z^#Z7pNaWhuO!d^Nq_m=3J#R;z-EM;?I>u=fujaT>pDiGua|t3 X_wRR8bsDeZ!tfE(eU|zr%>er2=_KPjsD$7v41ZQ;(9YLrvgIsAONYyD zhMOSPk5y+((PClOvXL%P{Zph75$fSKfzjGIWS$$?h}4K9;zhq!F;;g#?PIZf_!f*s zOggaskvTOq60ZYLAv>44R`F=$!CLF#L3(HhKcdss#kk`-gLKrVZr!KXhr+=TOK+;9 zUJ)*0%SyQlAO+(X9FGbiCovYuSp7&B=!khL>C_wSeE+eWqos2pFR1qD^(FjeelMt& zvNvQI)&=`yKk&|iOLrB lBw9&IJIi7m5RxtU&)RxV0b|cgB!~QrK zo~F*+67Yk3n4)=XVd+!aOnJOhG9~CWCpu#3^gy{`&vk&{HKLaQrSJ2x5UceHa>efh zbM*;{r tqoYR4rShLRZHL&EEO0@A(?3U9|Cv4OAD>5tDA9tD5i!1@)a|G#RXOi7Xk$ zsiv8sXJwgs;S{dm^uu2!)}pw7i?A+Q1dWL62Mv_HwZ#9^DHJdWar{~Bhc)kHry)y< z5umXAUZe*z9a;?juU>!(S1Q?wDtmrb4_B<%*)$VN>wxOiH?~vKk-;%+KXy#b&bech z!Q84aHSPNL%_1T^ln#6IRLO=b%(ADkbuzLY+8zH(7zx5O=j_krjdO2LOt4-Tchao9 zID_!U@W51libkfvu1~T$t5+Crzz7A6<1+X*^j+NfdEW7&TK4K*b|bqG?_m(u;0F5f z@11$yw0Jil;&iH-#@l4Dp+~Mz<-r;$XAPGGH*2fJ5yd4XPk%XLvnaCwuLPGj@hUZ@ zfJ69qcMM01#38Wl*{%beZKGVr#cISQkQ+D%$pHGqgmJM-JY|Tasr5tCw2Upc$UoYM zhKa8I7WN4iXDcGK;IQ}@y*}=O4wS*|=;8LN5?ZY9?(An+H?3eoW?E1|8-)8+;`8N; z_;#eniDqWSLj?})?4+!`F3MOt@=X-$$Fvc}vPRUyXh@53{b~= JUsM1klBV(ov0PiAv%9;nCyA ze7STQiWpx`u5u=sj!vifs`+9ppT(C2EDA*|eN^-r>iZq Blq=;D)FE@ zs+x|)9(8sfRgJzMLB8ub{-Z?NaS-Ez+5(ks$yeI|63MaH?Hu1DRynfWd_J63WG&su zUrO>0zezjOW~rvDUUw?dzNG*qWp iGC~LoYQD(f)@k2u5 ze+$>{e!@VLuZkbG3DIB@F=dEM)|9o1g8QWwT;dN8T6#~e56G;3Xv&+Gr&^TO^$l|1 z7GvA*=xzmii}KxW+jJlMnB|)z4x*--`T6yPaHV8b`uZgy7GpIIqOV8My`Cq`;}YhW zl=bx`V9cO00;_$div8s{4Sy-;@%{@YaDn_S0g?sh7oga44aVf1EFDF=t9Y#rpFn2@ z-iL ryH-?eS?BRZU3#)3T0GA3 zA-;JyFtLf>;8^LY=%0XZ9+8$%#v+2ksv-RJJ^|!Qij9?D50NG|Ts?AQ&3mXZnsg;c z2wYr@6H(YFhl~3ZBpb1v`1RR+8q_kp6z%H^8qiT-PK?`gQj3-)hP}B;to&6T%a`Z4 zS^Ey_cqUArhE8qb1UZ|w0fiXYx*Ljnx%`;(d{k`{B}#8bmTe3e4t$zorA&?edZ`L9 z(&S2EtS W-Yhe?qSrSvW*IXqeATb unu575+ O?EG`LTR~^aOi)#P2u(>X!yxm}}a;>{#;hx0 Ky0Sx|P8>&A<3dgck7?l2gVtrt3 zr=}FjycK$}pk5Y1<>!{FrkJpU3p}~o*S@n#F9IQ)o5+HF*%xaN6@6~gdUqVHl9M)4 z&Rs6o77b-jqb5LGxvR*3_u}O=G?{>)R=!ltyfV(N*~~P<_Ldma7T0jYF*t#BL^)fo zKZ{-wnc6z~i}NGB+te9L1h)pTmz6mh8Z6O+ELXN#q2jvXg&A&DTc%2tA|+SBjeD1f z?$b}h4{I1Y0(`^OiMKGmmMyyO1%f7DPtrn#j_b1emyHymy*=4dE9ryBD;S;IWc!A_ znY0wgD>r@&D=d+FpIIYjPuDo}%RfS-R$2xX1t;X8C#&3?*Ew}U4+26jH@*Q?Ky8XA zG55IiO? ($^=k?qp8mEf6u<7y!lvsj `#>~TS3xdqyaGwr;IUYS}pK$NoT%KENKvx-%GAPN}n#3_R%&-JXbThy`TGEaP{1% zK>b`#2Zm`2^Frfrc3Fw0Yv l7}^j+)KfWP5(lDOuyx)MAul=dwv1hR15cVMQzM5 zG}jNP#^pE}JBjlCEn~;PGnKqW(x{;)qaK2tK$M#C)5K~?gw`78(#rPS zN{ut=V6=olO`Aa}EYJP-Le?q*a$PaqCcu>2dkbW%GZJTe7YcLywokUF=^Qz832l&z z-`aiWb23M=)Kt-__)1uxWiuC`)w}uOIm@*F{LVeZteWcK{sq~RqFc3LYn)0lkWIWv zvxERR-(apPgfjnT2D!T%VJqnMASp4_UZcf5?y^9ns-cOp?)G0Ybh?U %s(_WO^auR%xq$#91t1Pe;3vU zP$9468&1RX2IFIjuqcOq#g_Q?;hz zh01GN)g)6j8c0`{l}Eien7=hf)eY?}0yZZxw(^qSgQjKI79WB!n#R!iWA1sMwx&II zQ0G%Vt{@aMOeJQn+}tqb;dJqwaBqz>6w{B}oyqPuMBo6jC&{nxTLk~5JLD47#{tJ7 zuSM6LP-JA@it^&nk-C_3FmBY$)s;NhpzdS5lEkQLgQZfxmitbv3&dL3c5@{&E7nGd;2Cnh@aMU>b )I{6=PW%LzVYa5rY{Is*i$*cG_gqT^P5L z$)_7+q3X4^dU&W`NM=5LZZ*_HAg+BZ2XTi$WFI8BN}9v%AC-k!Zp >h0D7F4__x;}o`21W-K+qSS5XdoOlXLBk*<~@ zw&{D{_tp#$s69NOwCja~gwG29-0e{Fd3M{FHr d_qOzZ#27j-`xiy3K`H5t95!dZcE4;%9pS?AMnO*@)jErkr&WvFU9cKc665A z2L>S5sQ=O^R(ju92O+HYO8v6#Qe 61*K*T-n4rFcDPi29;Y?_Y46@zuH};4)$o+ zscL0wjo+b(kH%@{9loz-L^{QM9Q(+&!>u21Fuu`GCq2v7waX9@p^2}BlCQ02XrBT8 zMVIIo^ZC7$scFinLF`2rPf1407Y^l(-A=lC2eddpeZx5) |+)AjZA0xZ#B)_4Z^vZ&1xz zYW7tLq^{qnvDKp-V~n2+ux)DV(b(m1_BI#@qWInz&B|NRIajZ~HT;m!^7D #Hmn*EehIF_fK8ajhCpU}8q2YMfw`tpwu~Lh3Saplvt67%>_y; KNTJ2_!hJe|-JKlc$GEhrC 5G;S57HDuiQXQuNMiA2C7RGVFS zsx-#&FcX$~7>VO#nNS 1|WUbjq05x3xyd&IL#i*2feirQc+~t_ym6 zX)E9OQ;L>>50~U1 81IhR-+D$W{MQn~a;O%ImkbC*yn5 z_2qS<>@$761*X^C?Bdt`{>Pp$@Q3joj)z4bHEX|G@Z%CNb)z_8##+ecXSsAT4|}~B znw>V$9C$E#Go?$u=aAF??TGz-tnH~4MC|OsvZ=D6-PqJGAInLpzCmW^@|+3ladG4X zu#EX5Jbir SF^$IDMgz8jONRDJ6)$DS?KShn@>c_E)^rI<)* z_7^dY)1{*KRl gTP>IAg*i zug}=?W%d _Iw@K9@s%`;D12wZ>hOwMbMwH2p20u zU(o6Tu#8Rb)4#lsT%ur%kD}u_uNIQaZ9SuE1}~Dqd_W@u&*a$KUU7Yj(ZBq%f8cWT zlGT3J^GFDkP5Oll{* ;# z-r3|@reODv;@xiBw~7E`sZ;9ipjRW4t(c;rC^Vgd2BN+o5!L&g3>72TpUwWFkNE0x z$UByPXP*TN;ZfP_{v_LW0=^*#-9BtxVu4=9%>s1)z%g9y$U{`h2gjwNh72M+(9q}G z0moyLL^L?%<(AIjjG8h<)#_@0D%G9;SSO}7mJOzIyBSj7dVW8rvtFnX;Y&94Dwpd! z#zvnB1UPf{ThGmOHncmr+=P 8B;rfMDh@F- z7FZofGY4N(t+Ez;M`31Eth}+{nC$Le)&Ffc|4WLRCwt2zz%bn~4%o_)peFEXa9wav z$dZ3(70$E1)oh9ik{2K1TOTyU|259-Te4#sKlfl;{HwgboX)A(-Xt+1;%CHrch`f6 z#ZDYrzF^cBie2yc0SWT;3n~r3eWP&Cog3H+1j;^(6J^lstUBZ*%64>ld4vdZ{L1BU z!F{Mf_*bhxB8uC7dCzsV?%gM!yINmQXS{1=sev=lRfnY9rnQ0gg_RWs&Ic6|O6E8g zj|7l}xX6TS{_K`=Dx|6PI#T)rer~m(m^ebw783KtFkdi>JPUgUbF8&og^PDwe}yy+ z(x;Km@IZ6T>E0x#*qK~}b?8cqbm8n6LhRxD)GhAReO$bJI_~nC=-}Y@dxJEyN*(uS zj01z;m<&E-IzT!jItVN%-ro}Z_a^HbpCedZbQz`jKjB^p{hMrthK6K34uNmQqsy9_ zWa_oH9`BBPr57hA@Z|*`ID9WueY>6;55Sz(21Z7Khlht(8J!o$X9P*%0+VKG&U@h5 z#^UJ6O(o_#Zj7(E`eh $~iXl)Q{*`#AA$; {vv$DhR_4vFMKohrR(A$HUcSOhc2-MkX%vL&f#SV%~IFtEI)>=x&B}75^u%3Smyo z9EJ1u$jZSZo4v{y8izYuOTTzMdhH))2SDCkjpZmTFAS0^*)!7|#LJi>YHBzkj~At9 z+c`0(gX|-4dc??$u1DQ9*4^FR*E{mQ{f068-9czXZX2=UGtHh{1>Y>3<5LJ#ID`$y zjc9cZ_V<}e6Qrv+zL=ZKj~S*0G6T!(a0zz;<+UehtVq ZNuLi*J?!B{0PTmDJP|y8u*c zeo2q%i7_SkO0M>{SeoidevJR-7EZm$2PDE+zVGYYRkgKed@W~u8)xp1&)quzX%v7H zrNL1wz(>KN*a)M~SeYnL+Fx$TT)r({UR&}!%7s9Doa1LWe>LEPT{#pRz8N`D56pJ( zeEibE;Y`rCINu+9_&%!qsusQp&pGs+h^S!T!@5Xxm?1a?c_ztU-;eS$wwqgtbOE~1 z$`6?t(HuJJL5# zX4cl5H?U0DMqj+uQd6qneTSgY+13zkd> xZ8PzhD!!<0O7d69lnHe1qEJb$hVa61;%aT z<3D(?L+%}?pQXMJdmJ1b$Mn9Z^j=4v%ZOB{2$zS81C&oEl$G9hE@VCRZLx?5Sq9x^ zl#%201yOgE>L&6r$6PTZtb$4g?)AvpwwV4Ht#Fx%rJ6%!<>VpX5C&&)*(;TklKG`< zqQ=VE2)OE)=kWiVW3gcIXRP0XJ$gqL1d=i0b6Lq9-I4jYld1SI`Q{!bIFbxGf5&M( z7iirQGYwYFEi3EwKN|TeDIUrd7&_6<6tki3f@r`Bw%Z;;dHmVAj=5^rdOC =&v#FxcFL79b_o+9l1{J``|^=U-9g)8mW)1wT%W-LI-w&kjUar)lOhSi z$#a#BJT{9h7s&zfvkrZ&?C-o`$kq6K-JKcv!uc%x19a>q@2jz%o1b^TUJdEnbYNm) zDl;9Sa5 }?dV5g56dW h=NM|W7yY*|j&j8;(YckxL?cCze}+~~FodyT!pS}j~#OT9%EytlEY3^2vB zRx8Zd@May;RJAA!bQ=sPq14#4QM04YK)Y0@* c6Fy$7p>9VZ;OFQd6hD2ya7e@7wJWZ zTDHHFyL@NCfR#IeAmP=HU2#!Sf%nTDh03WJSY=j-^WXculFC(C&aMjy6dR{bq&>ki z)2=zDbT5uYy$7u|*4bm*7cEaXm(SWq`KngR-6M|v$tK!shK>xS<(t02Z_#o>V{OYo zCk^-)z{}o6sb`t&UF_yy711A;R7?2)WM5w=C3Nu)mlYx3*P+bkvo8eyONhn(_XAb- zySuX|l3+-abUEP)nC@4oNCUr^c#g bobMwA e*ms^ly{8_P7!iB zWk|+q>9;(yzr9@O=|1F+4bp!`?4-pHm~(>a0zO&>cQLB+fb_?8l1&9DsT1X}T|tE1 zgzq~WXCR*Z-b0eObl7eRnrpkcBwLQy78200W#RPd@%k5A={@)dAH0B!P9+0vHK{o~ zG<| UegBs{k?Pfio2+VZXY3F1uxVr~N z)Tg4gkU4$xIrWCAlYQv?>XV{s#^zdtIJaQ3;aH>phX;m<@Ci~6vob~|c_v`>HgpQy zu2I*SIL1^tJB{@L6ZB`8)#U_4AFaExaEvZ}D8=={rO?y@ik}_dydM@m_sK>r&xL$< zziocX*HEmJ+^1EX%Mx4n2QC%#);vcTy_=pdQTkaa4hgx5fkSF;k#spinDPh-b)1#) z)!WSHqEyGaeYWNF>1;aBmYmEQ;lMYBk6DOeFI~p)KX7atJa{=KIVP)hHN6y^eYb=Z zYlHF%6}NXtn6Xmbp<+3KWMDO<)~*Z0`;{+S>}_^s?fU3FozHfXUUbI64*ieEN=x~~ zG`h$l|9!veoqHLQ9E}(qLQT#07f|ik`5({t<$8>i&w(WeSQXx~?Ans8Wx#agTQF{? z|NV$1v(-R5n=E=qD+gjL{Yq5Ub-D^C7&3K*0mMK@L^s?#%G1|_6I#JTD%I6bS(z9c z*A^cLahrZgI a>tn#gK|kG zu5SEO1lsfI4dlqK?(h!rxwr|{5+Bssc?oOWaQP2?5E(6<2WG_xO-xdXnosH_xxb2o z)`}d+&;}}AhcHKG$=L7=tQE;S`-IgmV3@Spnq#b4x&K!$z(~+3alS5Z->hW3=rZpm zh(k06K1uN y?mE?l3< z{xOlLti&zQ0gsH)&k{0niGbD5uElNtJ$VFR#K1b`Wf1xiP;|xf`=y=@{a
qU+zKy!PsIhp@ihBwCF$ICIMO5g$5+~q!cmpvjZ_grDzQ@K4A zhQAORQ5&`#jbfiHrj9G`H$m+olQE%QMM(HWc_~eH!IftMkD5zgko89E9x0ILb|qEv zQybiVLLE7W0KwaqQFzR9toDx}Sn|4)&8&p0V>oi5%sauJT&QZw;LY_Ie)$if-&MUv ztYSx(&K%%~4Z6JgI(+@1VV_7w)0AO8wF`4j4pp9qIaHf@WRJ$5(;LWlWFo_?|DR zT7eSM0Lu^$^BUDD#uqj^)GOh+7DyVUb9MJWzhQ7lbwq$*i35H?tLG$~_W$jx1^*wq z(g~Tw2n}6`UTDXi6;2iY1lJL$kS6mS)c3a6O%5&gH8D&KT!+Q7l AEzAj=xq{?Z64ieWD7o-2w6;35cLGQyxb=2WKL592wQ>B12POK4iIm5k?DTG1 z2Cs$fiLcS09*A7+ _B|1G_-oKmQ?~yTX2gmR{=Eo@0e1_Y9D)-#zX5u8z*Ip$P>BmqdY%b$z2oE =BM zw) ;d|!E(UB7S zvBvjQ2-h^){(Ox|X_B<0rGiHNzX`G7lK*UaH$2co)I=B`G+oO|`GgE HhhP8_cHM?aUP^|xk$`I6E E(tmuMkZaOtKLU|60rc2GPl}gGPH&|(#W@F&RAG2g|+A5w2RF(;tBna zzG|oGd0E8XSOq!gt#-z7)Hsh$VN)M|>tz{YbujtvP!XM_MN{^cI~MhWZCD?fD45sW z);#N7efX1N(fhIB_m+wzWg}-+gKZ5etrlWoQ{w9JS_PgTDcbwBb4n^?TzrDrlg~tV z$^X71dW%nui>1#pRKC(>w!NKQTyTh7W6#Mt_}*FeYm-x&=nTR?DYO3?4*&TsiYxlG zb82d8n>|@vA8l-JwLI*?JM%f=aeB(uXB5}a&=6Ax)kXCp;^JznSJhcD4H>bsunKFU zq)D^VUw;g_IX`q>P-^+SI$jC7^rbY&URUy3b-Wtm*^U!@FnqkUm5 >QGJI9!4E@wk3NWFnnlAKHog+vD=2^l{Rq=2Gl~tnSt^)+3%E*+nm* 0qz7QE6TRl8@6QmI3%1cT!^2(uj9V}z z>sTeGqdh6t!e`pWUO(5M h%Qxy2kDV?)=4H`WiSfSJL9gjz_ C=)*)PDLwEYQ`b^|MX)5g`-e%g(1EczXEX5-e&H#%F4(gmW_kPEB0}EMFrp-%izX zJMT_7?}c~KpkR`%U_Gv2x$PF@3$$Y{5BD&drh08Xt@k0aoZa7$y(;v-yrkQ0HV+oh zOZ~}G;#0RqmWwuW@<2%ryY@;5h6o+bSI07IziygUKkZ^8Sf-1!%Jv-KUvNF*y#=h( zrV;na5P^>t` q#Ou9Q(Myw{6MXI_A2A$_t&%L6Cmtk_K0;~-uPgo+S8o*%SF~)4 zLLj)iySqd1puyeU-Q7d*V8Nx)5L`Q0aDp}N?(Xi+>+E~aJ?!^`EgE{QIcLeJQKMoN zVi&jB_Tml9Ii{rk@Q>`sQR?FxHEXQAt2+5_*I|GYZnz!SjEf5w6k`6KjqV5?L&G9{ zmRhH^_Qq)iC8aAc`f^_B6c7yrvh&!_ckb`g85kIl226d9l646UsaE8u$I7>wYddaw zBk|<=1nn4A0r=U(4wJ0OouyT&l4WELJlu4zG;!YJA(_vj*_@+GVJ6Te{F2FI*&KqL zdyiz0QvU326D79Vd%WEL($SE{P1CbUzd7;sd77x$Na(M*aGuQ^Yi-b;Z$qDDdf 2HI`JmM`foE!rs9V zq|nBAc;R6d-(03h>Vj>;4u~GHmdYaVI=Dvh`RAX?_0nHQMVyONi_|NY>lWS_A4guW z@!5_u*1=(BW(M~S7;Utyy|91*w(BvGwR$_;R10=t;Ze>p!R~*6RFm7D_kMl^m~{>d z<`T|w88B|JD6tFb<)fWiiN6t?E-cFhxl_|us{6}Ng n-nQcP`b P!*pI0s_!mr# zov*b*HG1B}T>yVZMn-NdvKi}T-J$;j>G(6a+5DUQb*#a?Lf6LJTVNX+A4Jejd rBSr3c*W zAi;^R+5o?Uuwxs$NO%RHNrx%2F(#l%g$%d(0BN|swXxA6r|)y~Dd$s5{};&4z9=4- zpt&}8?sjHq9_^LO^_kfWns5ta0vH&aA{*08m~dRQdtu@CVb}K7=YKgLJJS$Fw&K-O z$J>*3YOh!O6>;Es2q_q*1n(2Ux92M&0neDfe?Nm;NM0lJ^T`tjwkz%C+1Qu}mms>Y zN}7aca#^KsE(F=YnSrxscPGR*GBUExJ1D`qf<9R^q_0V2lfN^h0}J9-r*Qd#E*R3n zK}{U4->g^_%(#9<&CalEzuiiG2t=pum;glCXwNr5{!zChsUk#67dEUHV}|SG0Lr^* zM1WwwMg*ILelgFqu|eEQgRnn#hB` ?M>4E=xM$A z&yA4%^3upUNp9D@&* bH7mYlqTpkqrt7xlMl-0py9oB9 zOlx=fKFcw;M`dKM9 >+DhH#b>lAqVeZ&ph@hzOZ4XR8#UViz&+n zlwSv5+Eg6AsVJQ-2F@y4WVCVgHl=-+54Yz(v!hCsom$Au_ZfN-6huGY%%G=X9pSK; zzqbsp_iLyPDv9RC&+U4SxaM0MW+Pt(g~tZSvt(`VUt1XZIL3t%TQXNl5Uj!lYaPxy z9h wg@P1Y<_`^3)NEzYd2m}xx5!lFwX~ta}U_(tsDR(&1`n}K{q@uGZ z?r3{5cU^F`0r>ZAW4_v8%6f9t1))AXy7alCOf*wvXVg;xEc0u#N5k1dk-C_V=G(eW z?Hw};O~Y*0(PYi7jaoAN9to_!znVHmPBaHb5(gp``+U#%8I3DyCLZby7o+^mdWq~V zsEcyZJ!MGE=Q2mUq&?+ksexnKK#3+ZB3u#X?wD!?kPqzbykzn$+`29j=R&bJ(c_c) zDWGr}{=pUVnC3COLB$1wie;=;{T4D}x0z05uhQd1uR*1Lt7lDpP92vT2Q|UgXsFFE ziOXHW#>J2Q8=mF3SW;5YVry*KoTQeW|ILy#Ecf%`2V6tK-OB?PDV#E1SF?8(rZG#U zQZwX^rA2t{jvfnvR8xe4qA@H3_mxtq%{dddDw!Osd;f*%ZN$mZqNF(IywXw8kwqi| zAkcgFdIv?6-Txae)Mj5B6kzo1Kyvu4dA!n5`G3PZ;nVk7b5%Z%z+jJm>cY Djj!BL^*s>m_D^EahxD6nO4*U> z)!)ueHsUT5#G^ixkEsHx5W&**`rS8B{+(RR$If^l=ojdBTc+~Xki2FTy1i1J9`|xs z$&y~zg@f6H%8b13RC&9=ijTZY@r#~F5EH)feCSV}#fNuE)~Uqe^ra_8a{ma5+i^z7 z^Y+7)z7C!0qv%oHyC6kEVtY%9G1!UrbHed4n{@6geswRSdARR^eKoCxDB8Vum__P$ zZb1QAE*x5H_RjLep D9?#v4YwUW&d}x$ztt=L!JZyBHCCAO2_v z!DncJg`LN4@t1FcLWA~4FUL>UtXEDAd_M$+l-jQ-a|BW-_m@V+jh;W`+Sf-e@{)gK z$pQK9>X^P=LC>5$L(ZHcwWEOEA=T*UO_g-e?b+%0i@e8sazVetSkq-P1qe#~%(_n@ zJ~YY}sut;&s<@S_M_*+AMGh#w(y*K9=k@a$lEL~f6cJ#Bw-o^F^J z{9vs%t6+qIEavrbQG@X1#t8kpy+%QC1`u1nqZbLx8R|CE&lpW)oGCHIRN$FhSQ`^n zB0K>S3} z#9%~4z_(FOA(vQKW$=5Z=MoWE@(Xr`=T{z++7`3_Rz2P;!Y6JYd|*_Q-($GfOjdVe zg|g#6IEutzQE pb2}dYgc6@t;v<~1w~ EE1%X`#b=rqy#LyS%Ph&OD>V@3^t%Yt$9x&>hKont zp^Tha!k)oH(n{+Qg!8{mFte+TRP+qVaAQ^G>w<~t`TTveIHi@)Wg2QKorGj4#ikZN zH-!HTt%`BoOkpotD-1b!`H{UnrHF#QP8;#Fnh=0uDly1vPrwE-4(>mOsmDz#{y zuj3J?;_Z64vf^`P%QG+95BQaRbHvfg#oo6(Ow?UKeOrX&n#RiBr2lJ{Pt?wdHoM{D z0c7jR-DX^@Ne*$}E%Uc~nCHr+3z(L3j7RqOUHs@x26SyLCNRcRZEtf2i=+^cDW<`$ z%t`@1=y&%Ny-hZKvH)vD!w#wm@w?O){|7noy3|Lw7bB(1=LMbJzCOGQo|?bkr?~3? zaSAK$t+yD_5q;@?X=VYnoQT^ D6y?kM#s{v~eybzEQ4oinsocChe_^ z!5az}%LVan>-AvgX|S8PHniRcNf6J%#?jJwe@?Z7e53z~chD7Qa;5V6x?Z&K>rKI1 z*nW^;7
8k zmC!%&2R|9Tpcq=fRPcNoeFVIW|JNxqPr>@IMpuo1Sj=}hsA9+`+*?6f+|-g%R1&YI z`%C@y0xGxcE?Q20s0Ya0g=ZWFr$^JUp?2wSyLwaHobyGEH=yn0*dA{$H#d8GGAdf% zUa7VS7>fouBa6KTHT1j2A&CqQBBHrL@i2xj*1+aa9+7c&L{ux2v%6cLKx7P9;4?a= z?lP5K*T6G{59ti&>$P!94fpIKUmMfH9W25Y3D8$sU%<;BkGOXJuQ$FOq6+69@}WAM z*C&-TjiyOgc2f9Hic*lNki&&w@vBX$DUTfX`I>vI5xp7 =`fY0|4h%f0%Zg_NR_i~BVbE=vQ@BroFzJ;a(S)FLA^>EzlT-_*!yJNDG2 z9A-lTDq96=Np@mkO7^KqWmF$;Xa28X?Wd68S;a+NPAX&w%tKwR)8g4L +3 z6wpy{!NA`>mGfBpgu@f}N7j)EJZL{73@JGWyzYmRm{*i+#hQQ)SjWt}u8TJC}Rl zX!|&?!ML5En(;*ZB$3jOD42A|Fw@?`U7UX0@@crvYE|%kS-ABO!7|?W-cIH_M{1i9 z4&+eXIrv9KiEkkpwGP@r9q9;|C)qeqp#!=-DX0h*7wSqsE}dVrF*Fr2IIjPQ3x=Qe z@S2+S%-D~b(&q=jX5t?@78QQF7$tP!xEI1N6XLysjP_st=v@_m1Opu&g~`Dln=;k^ zeknA?$ XB8P^DBj^14WQ z)%=N*exR7C2iPwUx$r^cfVys=wvh{PA5)iDt>~Ln&nX=s*!dFEjts9Fm!DSuztK%( zMW$;Qp+yAy;@Qrt&?nn!{q5m%lfd&_)`@hR&M5wA&|1?c*AifKQ7V$%a(OF{QTK3# z38+n6u%;lX @aUa(bh80 z!!|s;$v4$)<+FQ@*3s_y16Ej#TGJ~_OEDf?jpS0p v5-K%5h3+xo5>E3%Xm9R(DlY6fX{eKR6_qQ*I zcBc!`Q(T?vVo@AC7mrdHr@G&Jzmm;J8DSh3rpQ%Tho` 7 zQ0Fd`N;@7mCnoWwW*^Hd3)|o*%(z7P#_`2jvE$ei3uGuLC?rgQWMgA-+>B
@^YxVn2dv+b9s2Kv0P_{W 7Y;b w2lFX>4*e_U>uB%*pXf2a7$?vcD zxKSf6Xo-#pK!b)(VHlFkC7@|=SidLP(G~qFLuZQ_tHXDn{98koJ4C{Y(ytjweu)O3 zJ*b^S oZ^)NBPNhq{x;FY*EaU$dUQ)TYZWpV#hk?C+AObBO1-mfp8-*;`gL+Ajuzm&S-4 zTv)UvGjzG_{dXu#?3UCvc5&kwdh7kxDZkOpUfNl1kH^NH%zZ9eth{ZeEvi27nQT@n zJReox)X>;q@^+5xW{CJkIlaiClrxGa9dzmEBqU1ux}nDVQ*<{spqco$+Gdo)vR*7F z5K(@NXx?QDIU#{H8r?#5zbXx2_P1qoEhlY!cjA}91sNwC0fd0u-8KIJ)Q_7~gp-ZU z1-$Gv-S9mAuZ+*9A>4zXBdrA`n?K24-)MwVG!`^9eR_SYe#^YQ^}Ib<0)- krrJpVKw}Kv Er|>?O3(1Oa-U#JGbzYUI3#RU-l`utUD~4L1BB>3)&P$2* za bcA;9U!yDk*CQ%5gg(4@FWvfyM03J(nA;6+J9 zk`zeXZqmUT8tx8$Lq%u9v2EouG$TL4sCxXfDxgG$`@aOIgq9GobwF<&*@UdprY5he zL-@{*Lp(B%azb>SLfiVmo*rl=p&P6V@2rOhAOAHgXXkTfkLc*=fBa3Spr<7wk-#ho ziof6|V`FRUdnO}@%By8;{%iPW#;=a*C_fm?=_it=3c26Z5`!=T=+tfPu}^wJ;i!hY z`wtX|QP2S`{0ljdwCIKOFQc{fLfteurDjW~NCq-VdB>QtAQ@=|aFOe-0Y$Z!=>pg4 zQ?ow#9ZMz51>cF?l)Ze*us5Zk8#QQJKeq6j5~4-l7&rht!Z@@u*~;Xrl#1Gj>{CAa zA1=TgjkbQETFJY_n8J(tKb%dtZxBlj_(Vk8VYr6trNucP$cRv;=H?=7GMQLdT<_0K zNP?bS0-v`?YfZXgz^wsQM^%9o-BjCOH(;k3SayEL=ORqaCjQJHCAST+;p@>O)Sf%U z%p%>HtdS8$&$l7#Zq|g;n 78iluT zpP-*@T6_2K&j_N{P_it^Oqtw5B?r51{&57J_FDgV71v8Wb!O@=AFtM5y_czX+C2#Z zKYYpw(a?2bo%x2FJ&x{oc{>II?p8qk{c!&z9mf6%gjiZx4OrIxTQ?ACP!=gzyUUyd zzx}qp`l7t!u^h~9t8~OzB3I8fb#O|ytnHtnED*eTK@_}D((<{jx9Gz)U?3&?j7-}- zU05*PMhOu}Y9`49?(kXq`oqi^Zyjvv)>X@!&E3$TO)@#i4^?pzBE{|Wl7AF3uf2;S zPCa$u|Is#=8f ;`a2WmTM)8omQmT%w=f((m z&4q6nSc4qQSecI#=RoNb%UF0I0PFws*~VT(acJ<4XS}O=Qh0s(xBo!!VPf{ne-hTf za(TZr%P-o_0^-33Z!}xrA$IK^nZ$RWeDdHL8K(2=nd-pKr{`Ltz(MlN8W#qZutaHQ zxT=dTu1E=HBG~V8A6ZDVDTM6M6?&~5zK`oS4q|t6r|C9y_6{&;@Q$6Uhke`Iz>(7z z`XtBfn4}0QH5xg=!%5JNyscu(k7B?qw(_n_w93Mu+$&FBv0I6FZ#NZ^KSuTw(_=)j zadAlql30ON!*+HoNPM=@h3}fiCMG8@Uty31Z3`(1Xp7T-GsQ%Po%kfzYQ!}2tr)0q zIKg`&A7*ZGaby4SZ|Xm{GfQUGli=6;;{>RGMEj$f&%q92gmv3y(7>@8GB=3V6$Txo z*&+#`oDk~jtYH@22*GkjQc>2STJDo(Y+d$zu);~jj}=qqg#Ungg7Chw aK*b* z@cb;OprCLj0s+HjpJg4>?%^^BwxX$nOfAN}n@AN-+wGMyzL{%}ixp=>HGvDXMtY{+ z?Sq$s+ZfykDRXz>JV-Ilk&oeYJ0;>2uCezscNaqzySsztL&Cy5QNx3RJG}@N{uC!H zk|N)+k&|rP;S245l0$VjIAfr5#Qu=im9VeDKtJU5JdgU6+h0nwB^m8KS=7?fHHP9d zA0BK&2lEcLZqmb_vAuyJMm_j{jLq%vhjt}2XuNQjEj`f=1vF@HZqhN-^R;VFE+$M6 z51YbPWw~_-#MqU~O3EXdc4@r>6iBxeNig1)xsw-(X^6_agZV4+hYw@Ls(wdVPL_)_ z4Hm{Qj2?_`>Dp4F>%Qvxfv*`3(9rGDKwD#I$Z*J+Fs7tx!}T>0Ju |&Th6E@!3P8xbR>LJ?%5sU=y9tH3ute zGYd&4bB!cji8WO#V?G|0Jq6Mxjlrv{=X>d)WO1B)I`1ZoE!?4GTa#wppIp;NH}8ld zu8pb)WE8HA@Zk4f$Of?B+EYRJASjY|7_mP;IjkHMb2}Y@oAoZ5=|B0u9Ma#wEty%T zQVc+OjXwOjeDoIv*|~5_m==m(-HpvM|LgtGn{@s$M*E3JXwS>A+^B8&_!8I>BD-5o zgx_r|3NM~)u+?(qy+TZ`-Fp}?8*`=JHyJrSIbK*$>iaVj`ws8vul&dN5-#$$Eu@w* zd}XICLZ%4N(`j)Lf*R0UnFD+jO(>5rTwiuhH8mh5ygM}~gSjOncdGo}AqesZO0bjk zHFQgee24g>nb*KKd{Ij&Kf;p8tZ_l1FpYe?s}_RX)9q9td3({uA(y7;x_gP26iscb znJ6&?0cfl&WJaejt(^X77}hIC%jahi6BWjL__)yO!TcuTcZbb1;IZcO3TR*$dOCV( z3vlua3Fn0t{eeX D2_3C5Gw*!gLShi4{Ka|7%l%To%9)TU2d4DEn!hYPO$|GT4q_jWJ;1&%4y z`|AgoY?zTj7C*&MxPWC*=^11SlX%ZIY2%%K^Q2#!Fl9&Mm8qp3zSqZ)Rj9$XXy1SJ z@2E;JLphA+8?9LtEQ?2>s`XQSAwX%9N~l!DU6W55C>-c95NuIwI@l xk9=QL!e71OQA=G$qjda@HY>XXJG139Y!jPrWt_Ms04x^FZhHIM#VlP zO51s7-<(2`VwsjxY!)uRsVQ1NNfU|FUo0-Mue!WkyoIg9*kFS!dZs?#;Sm;GmP9~8 zn-qybfV4kLaNYLx$A$@Sbj8{{2nDI@zy!f2I `GpCZ=R_(Za1DwxCPf}?Vm(Qb z1V#A*J9>K@kAda;+Fy3&$qc$OPhNdwd*4_C%{2kg4mYlwb=Ck7qOuKCd4ue@vTSNX z^;emr)A9JX?*>uYtp0EpUy|7}xc`23#9>$ZZ2HrPfJfS#{`E5+rWt~-RlJ_v(Q WOmYmK%bgy8`Uz4A!gR0y!dC^#$KE>~^oBNS;SJuyjOB zQfk~
VpWB2FNvr%$&nHV2sQQnNqIo4H0$ScLEpwk0oX-oLTrZ77$wB#scAJj~7@ProENexbJa z&nb02GOq2cfE%1g=t`6Op73kb3Uze0+5jGp8`N<^k4UsM0a+=v$+N7gRT}$z0mq-? zH9b L@WgYg~W*U--YwI|@ONE9(XAd-`i0otbu zX7NOeqjM+DTVd*L 7zRf+(^Y+OR&2VA9R4nW{7id7<| zM3+ij{I4&=EF5>E{JdVX^EyYIHM+}xlz-x8ZeK{F*0LFp@y{266@%{lBWWT-DZws4 zytsX6wKr( ubHsf0D4yw&0f>kU}QdRZvWLbG1^XQ}9w^0@_r;lv^7FZ818pUpyM z09t>V;ekzX1;s(0;N>f{CTPZ%LX@o&2xwNsqs*d8g17-|C~(`>c{VKEa>Yb_l;VWv z&; g W*G8fov=g_}Pp~+SGW;n(G28?0DHFj+lVv%-*@MVJxL6TKenR zOsN)clYg5SKoB;^JEj*N)8Y+h&(J4cfud(qrR#!dz&Z<4X`3EAM~DHLkXvYE87S@T zKMCF2^IaOg+`v{bNmu+YD#tL9&`5#}ro$V5Wwu>1WG-rGYkRy_^~CATK?yv@1|2=| zv=VV744q<%CAe;{Eny1(o8KDYt5W04Pu;4GpPX0>t~Zq!g-F)Ax$QsK0XWTNri~)X zRya+!ni;MzTy4@u!JSA2b_ky3lJ)w%lEub2O|Oa>t_VoAN~mGrE2Tn@*)%(usJ7wW zN5rcEoS@7J8m^iP?2nXKQW_$bi;eI6vKZXOk01Y8rg?)b#Rx@XG}25ed=?W1lM3zc zU0;YCRwA5ZYViBqAKeH2j?YqUJnbJtAahoJY8|b^K$3ThPH`!_Un^$;3+aCo&gm>T znb3w0jO1=7^s n5DfGbU<;TmT+z4PF7CLA$2Eh0xUG6$0&!QBq z{L(tzdXN$%7%Vd#TcgJ8h6Y{a20 Oj~Kt3vbaRu^?tKYQufgjj_JvR(%olI*wEt@6Q>J&mT~riGOA5p zf&j;A@wQK*DoNXuG$Ai2D^jF0)>EJVM$*>AeEoc7Xz |KqVjHBjF_KppR~db zNmSv79KgGmq)iHS&(MG=st^UwU0|A@|9c9xolkORz+oFo>JqgmElIp-W*_T=^M6^j z9^5pror{F+JM#bv7&O~P`m@BTotd@pTMEi|*{azzL2G73o^Gbj>9lzV-#MO4sdR$} z@$KFm@Dd{V$9`e@hR^X8LK1QYuArO&fkBr`+|e@Opf0YI{%gpIdnxxLbk7$mO6^(c zAQadWoNV7%ONizTm9>?;wxBbO5OscO9+JP4#95XATe-iyuI7{In ! z2H4cR^85rehmF?m0`Az@+zAx61fgezOJ#AH2J6PRwM~J+XIryn?!*8xdvv)T__nv7 zu_xCD*H~CWGPd5y-jm{$l`1T!=ew-mZo|h6eNrmMOmYGb|`_SR3>#?yXhx=VrMl0gP9>e`vxp2L%TUJ zwciJGJ>7C*#^gOvTetkz%{&b_lt~%~XP!W)*dG=@lnE;8M8|q-S`q4J0IeR5vA)*n zP#_cz&a6&r$6A*I0~UVtP59`VLd<)pEXC{*#`0tV6chxNk6a2qK{n>#%wmbz7CBc` zAu;Aidn5i}%+vXiC)g5=P-Hk*EYf?wxcVta){#MB^l+kXY5I}jGllph2e1_-+Yu06 zj`545r;FzMO7YYwMhSx^)Au5~`w$e*Mwx 5`4FWwRP@(Jb<=mCFO+k;tOM!(Qv7f;2wY!xe+l z$1<<0wdht3(X1z0JdFLk4o``lgsn`Cs#V+dc)5}(Oq2JUq4YIAGRpd!Cro@vx!HA? zJ!H`Jj@+n_p<)7n-S@j3!P{HrUodUle8O^a3vrEfAQ7!N_E(dm$0NkKMJxafoZOdq zrdSrr8`Re9=5AgjCCL{xA1}{udEzRoQepBZuz6=wr0nqCUlaz|`X(#SlUu7VG`GuN zb*gY=hM(TmJQ0@>V~ZqG*x*YD@6IV}XsBz5&nQ&nhY)?rvEV9&f^0uit>&kiROwO- zlWmd2#OBVSa>NVuBhJ!HqG6EYkWuGldj$UyCNx6B$-1BL%cgMQjYoqJHU|D?k&o4G z)!C+i13@;#TqGE6dN`LbZka2dv7OS=K**pXpXzkHw&51IFB9X)?(q& B}X- zWI6=}=l@4<&!eF<*;A){zXWJgB-PzR$-^UxhIWr4MB90Ctju!uTX#ZvYf3&gG%5mn z(Cf(AK8q|*YuPf$DgJ~^%-TO8s^lTTjsD#dpos~}|0hx=gYs=7Ar=sgmKv}|cJ$KM zAEB@(pc~=2Ase(7{EmGxKErjcpVddQlQ?Q@6;Tgp)Hy1@&&QIH1Gz>g&pMsowg8f! z!NWdWzp4Ah4j#fBJvIJO(cRV-mY+OWuLE0!w7iay9p2Zd%4l*VQ5Er$Qb|QpeCjm$ zgyEe?BfSF89qHByd>X 4JZ~^e&{;e+G7P{c{Zt z-5IzE^0~mW2pr&c)d?;N&1CZ~(9+W8pi*FG&Saii=_H$44AG}sPLEPQkLu^I0fnFM zUYfV$`?@8Dp%biQlAEO}-Gk?hRw<{MRam{ox3-wF(`jt*zrZlPU${*Z8uA*n&A)KX z?#%&
WS(Vo@?-2Fet65KG-h{Cs9lwL@lr-@T`_DUg=fy;5gt4 z&o`O#1wU_P1&j>7@O-mygl+JgulfC&*?D6*8O$krK@CY24~z_~BAYx2IvQWPq5Uu4 z2Nk0qM>*yQxHku6#A>I0xg6a3)-95h;ZUY fxdd41}67W{9{M?7}jvMKODpWD|TA#Fz&^h=2AfNcaUW6)NyRwwm z>H}!_iLQu+mu HfE~0neWW zI~z +6)r%GA{hg9NGlD!XL4wJT%&Z*6b WwrBHy0 zVqcc#GvHlSvh&J+N?*zo%X9c2qp3B)0q^-7JH|e@#a2J<%ZlbnM_Gb0M6M_5e_(f0 zaOF_oOsb5)4J3Sw6DdQJby9N_;0q2X`Hn7!%FdobT`)NOK-DK^+ZxaJHIBV6>KL|2+JEI^# zi+?!fK4npG^7L+BQ*BKcnPC3^auq}|7oxrHx7fF+`*x+`sfUV3bg{^Y*}S=4po9L1 zs2W7$@L*G8lXGAQ@f8FsxSHw0hDk#nzxRGoL(w*I$32LLeh0oDb@Um6zs+TjUmW~Y zW!T(56BsVv6$&<(vav8alWMT(u}2a+S~~yz@(zk9Lh!5ROuxp*3pnqm@M^Puq{9o{ zR2v>)a=pLDf>#sAVZ{0GaIsqU-$oK2a!4uV@pJ!%rpX{pUiOnA_pXE_TQ*9{ud_2U zaoFn1ejWq=MLzznk}j1lPXlgV33(Tg>p(we!yj5LWUNi-;s*jmuBT0|FNhKjBx9*Y z6$87H_C8ODg#G;QAK`vmDN|W7G^?yi$jP*z!lcB1>^(a;S=k+|XP#{n#FWk@6EOQ} zn`<>p00G6onATLMU!0P@dp?DaLL(|kn+YJx1Q h>^*8AGr1v&3pWpCIhfxB_EgA(gr+N*R(&z>wVmCpY@-( z!Py`7pTBiE4^)gYm5P#-Zx(3$^fVXL7xc&2 mwun++dg!spXC{HD=LX7T~mR!fx61LqTtwZh48jfow|?-9>jF_2G*^Y zPRwOnf35rA?<88i@N*BwyG(|Thz6Z|4K+WYSh{1aVCHTuDD7uSNpqY@c%(K>b6IDe z68OgpPy4JXKW)<|sDMAdvm7+MTf|M?(EsEX#V!EG>W;rbk4HmTF9Phd5jvp2h@h7g z%&cdzVt*qlNXL$W!j9*T`%w$jm;I~O`&ibC Oao0Rh)6|d+pb0 zG&ei}JgWZ?XZ7Lm@-8J4qEw#p?5r5@oKUCAk7L0J!WPdJuAE@XZud)()d18rSyju^ z=%3hM&lg Qu4f#FU0aLIv>4WAui?VOx|j*a^VGU2EsJNMpMzY0G$ zirHNe1O?@Xp1?qh@(Fa6=omAV<}-MOtbayr0glx(GTN)_))6VkuwAIfMTtvij1lw< zKcU7x)eCu6XYZUK6M~?ylBUn0WgXM&9)iF2pKSRXFBhE@;NbwxQ^7At9}A0IJNx6A z@e<3u`l(TYlD*5kBxLGH87LlFo0P@JJ>)!1_DhUy-(=1cjOxc`%L3x6&1eviltx|s zSrmGdfp@7o9UifbnwiJUjiuKg>UN@AUsq`KWQZN^>BfkOEh+3)L~H_!|Az~3=L009 z_GE4A%^;49i$hn_KXy$pWfhH9aDJX F(7N_na~#vn{v+c;ZMSe@{2jmX*UktZr|=(?OC)VJ%)2)cB^iBNye zws15u+|lIiPQX><07U&zeyU>>(D&OC(tM;xz*Ld (T~De@BKBbLS|n1 zqFLimz)t^9vqJA|6tXnX%g=xDxlV7<_~=n`b J9o>J3;JFhd3#wypNS&p++mfFUH$vOdVaG@h<6=jGX z(PN*^NJxe3?Nz}4oc~zgKYCFzt=SBnQQq}3LC2LGTP?WLW{UpId1sNJ<%UJb2o$qJ z7o+6nZ4((<<(zx6^3cD6a(jwnM;uwG2Hl`gY-n0}>}D*n6EYTRZJB Q6K!`)JjR}!ZT`5OcCR&nF=AJJ8N#T+f8c|IO1fJbMzvrQqJIDChxyLe zMUDafW4vgSX+% @Gsyr6lDdfafFt=LX3Rx96f z%3~=cuJQGl@+r =d0~a}W9QyHm_QSWNy+g8V#hD$n)kgHyJXYBe`l_!A+5MBG4dRQ`H3r<269w*U5l z_x>+x_3zbN=hHa5-dZM!y?)TJ650nX`s#KN>gz6&-omH2?SN#(>=mi60E4bktoup* z#QYlZ;?}<-jceOaPKH)(CQ~ TGnYupsRbpR54`2}IS-I)0!JnaV@dT~$-Wu3W8JZJk+FOIg#pcaynIiCN3Fi~ zUkXXrf0{^fV&NPj8Tux77ciVm@(k^ wC3DYxX%Z2>+z B9h` zCD2o-9TH#yOB`15qE5qVYtzTk0a>_cFu%Ry?*eICSH=t*B}mEHltO0FPPwuHe_lA} z&P9Oo?f2BCxJB;nyh+~{PI%++Lo8zJ>*^HIs3aXUwWpK8x>Ls!j25iS<&>FxnNV}D zf@7=ZFT!lHhaLRgB=H#5?DYlZkdwRB?M1_{n(5}AE}0AJZ~-NvJg+u9Rwxh=ZS~Bp z7x25gsoLM~lgrsLOt6c8_uV#WJ-itj<{PD3T!?16D;Ku{ds9eHCY0hZgFIt^UC@Zd ziW>@G(&D2A55GzxrW%nTpX}=RfC9CQ9>I&!RIZk(gMo>?>$fJ#DJq* k!I!ZCC<+0Z7bg7e)b0U@2tH9_PHY6v8YaZPn@JP zAH8z3Z?Pg=$tnKg;Lgr@@1z_F2CbvJ!f& 5C7(q z(sWW?TQGfiW_;culiom$LnDmFY_GPW^5;K60RS{$Y;z`h*?lv+FMXq9Z!kiVROADF z^T^IG9*K2FU^J=~YB@XAu+*nS)iiVt-zO#)VU+)%1w;u*_i)k&m^FX!L+|r@J|BA% z5Gmm*;WcOuAWNj+@yc|Pe@HfT7`Npr3FI5Uad`BMcjfHlMHmK`Qmm8|*m2d)Um()h z62@tlMCRpp@r7PKboiBxguT*KE}p__)wBy#g*e>N@pjH34ig0>TPcp!pmp#%Mt<2> z>rp5}DeV?~nnV=LS+F`8VbOYZOp^tEUm@)~bpQq(5zL*iO-#Lg6S;q+0I5DL3t#br zC3M^ScbgFHiIg~9yuW80(}_nA>X#Uqb{yo75$#S?w|AyVVPR=>-zPtDLiL~s4x}0S zXRQTL#g~3PW5C<^+IDs3@^r|<>=wHBIzxInBd$Y};*rYQ`uFWBDA#0Xlfy59bC{Lc z+0;9-@K#~DoKYPHzb{qsvg<6{^fQzO=LC1eh|-Kf ICSSv?l#BGX(0kXZ?ER(-b z4g#T!!1S`T`l1Wd# k%D2jY_Fh8{ Wf|5p- z7%NI;Xxc9$p8s feG`bKW`<+y5f7ds z!Fy~#WNPaFEn~q)ktDlERYd2opoAgQ_NR%dH3R9B=L`jb0z0>3{><&4^Y}HBw@Wt6 ztu6U6Cg;m}=-Fa;02UbN#Q@TkYNuQC#VCF~K{Xga{iyqVnnK=t?r<&=Js4UM_h8KZl4$KJVjoQ;PRgwz#oDk(G=) z*3)S=^97_`t-ZMM1X&wT6fBhij~?dh5h~jijAo+JX+HOhYJFBw=Q02xMZmqus&Qj0 z*CNGR;uFWBH+j{pJ03xl_j|oR^T7ODb&QxwQGIevltCU zb}yDJ*6c$TWT>a9bd7av2_Z&E%E&gO$|fVkH}kfRWZ#+!>pWZY3y&(LCk;AlGpY#A zBuhd``VxW(Z$=O44F&W0JfV7Uj8sipOQWkODnGc4uH=#Rj}{j($H(wQ_DkQGN^5A& z{q;Xk-#UwDtW~Oc4!mHFTOW-cYKLIJ%A9u7^m9V`)v|3nll8$*Isr{ug&NGj)oB$_ zUw@x8+tg4+D9^&enrY!l5?5feR^u7+KF*v@Rr!8qTuSEd`LasR;~^2IPW012_J8dP z-l%`kAuAs8)bs>5v4+OP4aE7`cGR68TrZhs`sTSC>*Y;9$59LR;1MsKgTwFE<`K;| z$#zfw$cbMM_~1@Rv>_$ud%6FQyLbMMD{R|_+puxc*tTukwv)!T)!0qaI1@IuZ8e;r zv2EM$^m*31-uv$NAACQ}ti5LMea(f_=W!VBH-jji&(x^wR&zT#d#^_^R^Bk5jw6kS zRPz)$s`3M^a;;!9^7Bh*V3Ak(NkMrME&(dz3QGw61tm6Ael!Z}z!^8J$9Kjw{%38a zTDoY*NAT!N8c-LXH~8sis;ICc_{-H#y3 T&mnM$BXrTHz$3}Va=W?WqwQtWMnGh@o_9!ZAeq9xWZIRPXbFQ z4HgBd*(p(sA~Td}f8(Sa6i74#QOzk=Nb%N}9+69!ZqXc1E%ZKOIr+|;9|LRTDQ}yT z(C+%Fy*-fPgHvF73xkM4jfrUcENDOBLnB7s1fn Gt#yOY|Yp<^w``HBV?IGCfxA$<&;$_SIP)zgfQ_l-HYB47P{=PbRJR9d4 z!{x28v#Y7Ao18eoe9U7R?2RM~{dOqu!2gym`k@z=hXQ+q{OGD<2NjGJWU;fXzZ@rG z6vD)g04h{y;Z+A!v%LbTu+`87cx2U?r`&>nl;#~f4aH~gUrNQqcySKh^Fs;8mAc+e za>M-OouKwGpnP<6fsM+~ErW$1$i_s5AgDUndd>f-tE}9}yLDcik82qgREkTrWsIRn zXwHL4Tm}||R27?qXXdH&tD~skS-^f{=nfprBapYH9_^-j!otmPqZ1E8Kp5Hg)_L_H z4HWdwfXcA?k;OlVdZX;@p+L}u6r4RIwoc+?sH+0)N~2x|VxP?ppVmK^Swc_?=;^t- zEUE37|HW(mZu`ae5!=AqKJ96>c COnK$c!?fE(AfcenFsu>-sNc#7mOK8NiqF4^T;jLQ8I4<2)z8j3S59bt{ z7jhiGaDmm0@&2A+7wE;NV9C_%ovo+OU7S7V?v~BH2 am?`ur0Bd%C9+w7bvZQJ@~lCiR~QVA`~DdZ9j_ z%ZtjXTDaZ_&dj4VM8v1%`ikPJ{K7_BzLH|dCXR(Dl^YdVr12{maTI>%>}gy% FrELx6GhC=eo&j98I-~*|5YLE)5yr3=1JETY{U3*{|y%LLY I&C)g