From 21cd2832250c2a9f5fc710e89d31cee1221b4772 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Sun, 15 Nov 2026 21:37:07 -0800 Subject: [PATCH 01/23] ADFA-7139 Refresh libs/plugin-api.jar for DebuggerEndpointService The AI-Agent-MCP debugger entry compiles against DebuggerEndpointService, DebuggerEndpoint and the debugger.endpoints permission, which the checked-in plugin-api.jar lacks. The jar is rebuilt from CodeOnTheGo branch sqlite-debugger/ADFA-7139, commit 8e7473b76 ("Add DebuggerEndpointService and the debugger.endpoints permission"); the plugin-api module is unchanged by the later commits on that branch. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- libs/plugin-api.jar | Bin 433257 -> 443851 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/libs/plugin-api.jar b/libs/plugin-api.jar index b3f00fb0202ddae5b89cd77c1f74176a457c85f7..0165f176208712e9a6b6dfa7c7cda17b5a34c0a3 100644 GIT binary patch delta 112018 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

S?zJzP!DRlr|9L`NvojX&%@0Jl;m#LFsl zjVO*iBmRDr;AJPs=8#!8ncehyw!GN89a<)aa||xP`h$#+0SK~HnbpPW!Ri+}3zJF%}f4d;I}wB)%A=zn#lHO(1j z(EH*iiZB}4IbS6VB@xFRdA8bC>zKrsgDLa?;qdUu+%(>7_KC)J(FO?@Z^j(2DA`}z z{Wn44Cbad-*FpOt3(#Jm&?MP-f7IvqMANKOoHr$bm~8y@ZG_}!q2XlX%B{g}>jHD_ z(q}leONAoy;>@5$AC}*i$_6GkX84}DP_~&rqi}SiD@W?k)V$Vi^ z&{hfO&t-gB*=pOi)0=HG2j2I*uRkzERpe=$>|Kv0@5a-Hbh)OdGz6UO`_6~k-s&Z% zMIJo`|9&N+sKslU60P?XGi$*53q-o50~Bu-#{)+?QkqZw{V8_?8dz=gT8l6qExi;; zE6X}Ki8#qm5+W(BOh!_XQjszk`3IUL?0$4Cly!Iit5@71Xg~JAfBDiu@IMQ#|LSC7 zgrPBkAI_Ks!QSvJucGYSaV8Q}+k=mG+o)W(}5DQRmiW?Uvg7Hl3FE zSX>j3*{rg|ncd8Gn!h{kDrpQsYm~n7Gs&(tEI#f#@k+IrjVwXP8Oc_}W;7+mr=SM+ zp++p~3#l=k<~mDNs_C4WmOna->y!)Q`r0~U`jy&H>nsz&!&DN7xcY4=d_>hOK z#Z8O2!lqVDZ_b4KAR>+pw#ZOndlvmiZZ*3sSq2>>>ak0P<(p@UqSH%X9>#ipw`vsM zhbhYhH!&t=&$z=($U0}qe z-A$C$doIt<$YY>f5m~_!M-c#BuLJjkDB=c?V0R-Z9=U`d;ReNKoObO&fsm{f%9VH! zYC=w9(3v>2yI{!X3i%djjO&()>qHIYLwG94+MxRt9$QN=1ho*#Es@kZWrA{DH){dg zWaVkUNjyM{s6d$^qdOp}IU*RfbRO2la)@ifAx7%S@X_yWD z(KRTv%;L7!_BIocR%?{m>;epv<$MIZRvS~|?cpe~%gx6W7;&&CFv+!QHulZ3sPB!H z8bwM?D{(19x(_!;qrYBEDvQZvux1mr=Ma7rN0Jwh z3QV1&o_odE61`qkB2Jd}t5E@u@I2oDHVWI#qZx_247%^GyDJ6JG{D+XVG z?(N;Ufc+`fat0Lr@X1A|SeyPlk9eIWyKW$%1k?nJZa=wFVlA1yEFCDzt#~g{QM3i4 za^5S6S12BPGKoh2i^Ct6DGf!;A6}uC&KNeHanY~geP-*yQ2=(i_pgY!4YE#SoHNY5 z!au8boX2oOSFHM|Eqxk8925Fzf&6}aH#K*>&#YH-E5oM<8ccT6ij??*S~dYU}nUc8cnV~f5F)LQDo_OP6rSzqboFCKDR8tl9IPJI@r z3$)Pmd+(fBM10${ru+Vz#_rQ_@iQ)i_S|+};7~^sD~myc4oZ|;{D_k9C+8;Cy_$u# zBSG#z+(LyC2Zd`W>9}V&BO`4!?Y&){8%{i5?q^F>>4NVPZ5M7D&-96B@6cYMDT0rd z%Pm7~fy?-=2>Q>wBKUqXD?%q-vD`d(4n6+Ua-9*`zSjK0vd_HU3kCQq+0(X$BwYXm z5O^Zy2r+OXW(iT|O4jKw*ZzI=8|P+;J;|d_+oqa#@z@+AYe8r>-)O2Z#pt=+C<k9bUtyy;4RxOFw6q}xCiDWgSHPT^Noxj4DMHMqqI~I84W3FWNeTacRv~$m=Xm= ze{Q>x;uTWWKskQs8e70x41{d^lMomYK%qH!Oqk!Y@T^Ie-+99*VoQZOry9`T7bpzQ z0Ruu!#V}m&WA=}MkBy=`nVWnUV@8z;dPx+#=OuE^zhe}@3?fr{jw78QrD7{lEG27n zS8i>$+7u>T7e5n(*GXR@;CUpeDyhx#MA|V@rmCC_Ulp;Td6TsL$V&NDOW{5S(2Nj3 zbB({}9}jxUibG6=w{xkn`wuW+Aac^lYzQlf(XK_2+k?M`htzO zRpo_LYh+eGo+jOY)o)vRIP0$kHZC*CFFDR*mup4!2avoF`S$I}T=3R_82&RI1hSg@w^*K{H)Lr)12uFhQt>U4v zXwNG}w3ss0%9OA}WmqoP-(mSTf0QmiI!S1apG77v<9@ASQ`WaA?3|YJ%8I+;B|nI& zR~?{vaSq(fF##&Yuh^$Mw7ixHZJ4OZgssukRR5}yp*ipPTUl(tdDe1XljTcv=26!s zay>#OUrXfl*6+!X&HtifOvl&258Vm%9R8JYJV3Lk>GOj1yegAu(WRXlL|f3Ju|j>0 z_5jN^cxWtJ7dQKkDwoT%?W5z0gl5_f~Giz@q3xIml{#aDd_sjOY1t8KQF5+$zCc@ZJt!BzXu(d$?IAtLqc z#fl=G^CZeU*gZ`$&YR9pWYQJXc}AQ3wnfUJnin7U^_z<*PG@tVC4{M*zPV z+f#c!p10sQBahchQ0GUUKlfk=l>SA!oG13$|I^%>agv~9re74iy{0ZJOE-IK2Jd|BKR zW`j5T6zwkG?zC*jmg0^kW#Y%gmARgpZFS1(F*UZiubyG4Ca8 z$k0?r(`{@>wCU`cxn@nU(gYvcGs!L-A98@AOV<3ds9uaO;PdVFy-}9^dziVkFNBvg znbRcNNC%BvVOJt591&c6-lO(&L97IhWN1EVqcKgCh%tk24OLQcZWi3t$zAw+or4fS zUH(s-Z?PNHsh8)KV55*a$1|-+9Xa^ZzX?6`)FyLuup)N($LLkjcE=HpY=}wgTej$g zV??x(1@y|(MRk#1j|HHA`q&%^@1x=xVb)=q92u^Yw!XST*Cw%AYATrR%Qn-kt-jhQ z?-8OHF?)_<-N7S5C~|9J*_S2oVm}3ZoNA?sZD0*7-9h0-qxfbD+CZO_rt;d|?;&um zokY8}JpnPqdWBl-@PRKcopeIt{n)y3{lPo@U3drlmNp?tUEH(vFhk1<0;Si40ijAc{C_DR@-yTsb&^uni7 zR6G>zq~&^pdeO*rjUgT!~XrhRrsk&{XZ8pJ0fn@*?(5vG-OJS-lxPc zRumc+$Wqb!k3T`6Vbi_^A+ab|(g#Y%->s(69$>?KAW-*VSqY zd8{tgf$%FpF84I{o-ZPo!~8`@MmSd0e6JaCTXF$EI|=ev!^z&XhZD<2D99b;p^cj| z4hOEmio9foWw~O1=SY}KbCL+8|V6WKugX_%m{aBI^rK$(Lr@&=Md zd%vHR*fxBSyjKjdTUKsGx{`=Gh+1B_Ou?~fhw^xHlMD3rrk8!IF(MdKEsx)4V#~~I zP9ZRvcLY5){++dGr5ves(X0G$w_shZ?UBoF)`+ClVQMQ1*W;X!_+1szvTt~BM#%g6GcLL6$8=lWhM4p` zeSzQVMDGi1gAze60SM9XQwLZLbJCvY+Q+$O;qqcv$mBZxqFK03?HXB5b4j8x;E9NS zx1)`?>{JjUE%*25S5@Y&K&Rjg_!bO%kLk{UB1cIhi9U52+6}c-HAjpPj1WFS7x)7B z$M^sDR=Ac{18`zkxZ0bad;Om|%u@e}+Lr=U#}@nob$e>NTzpzWT0!S^o2 zfP+JkDE>zGnXGTOTh%mXuIII^)OK)mh0mP}YyV0!xKijC1_@qx|NQqnW9~Ef{4-eH z54<+iE(B)4wm+%C_%$0LVLweqmF!;~qp}%&3bg`W1#3VZvlXfGzdLq}0G37xV_KlK znD5=1IbIaI-=g*UrF`xTKB$zfvUol#xf%3#-D9`hbSLq!uHHUnXG;0X=ylmwC{A*m zMzU^GQuWq5^WZD7G}owj8foNMrlZ=p-{I#(^{a^}hOH!Nhp7ntmt%nOmg#B25B)ZO z|0vmS%AVBaVge##zRK=`XY5_o8ot1-)`E>4li^+|U(R1ofd}KN13S*Orsm~}``05b zAprK&z}(+JeZ}Z0loUu8_1$_FeeQ=cp2zU{prrZt5a_8vP~p+GsH{0Qt7Uz*wZc+K zP`(JOu`jmDOB1Prj+<8YpPK;p3}J6-RHmjr`ZV{8Q^*G!B}=X zx-cTieUc52>wX7{F}kh#%t)V>N5-(dD7eDSiIOVy#$y zzH?8IV1v^gzvb5gY-!doPK#ScH?aY5*)vyTaNOo$emOlIJ)0j>s1V%vnCUa)Gc9m5 zd9#qy^@9Gz6X!ka8>fLj4#3J#K4U;MFB@#VO8*%@QmR}zl}^cP%5Q^9X`PJ9Z=Yz* zGocylk21@667j64#59E@!09qJs>2EiC-pKFZ$(IQb+D)!Xt-9MUbO04#dkErB&pUg zxjUOEUFEBCYgS>I9Ky)J2-2%ey1{BWD1|WlQP}S8OgWLtQU2nd4Uk?DKaLl^sdy09 z`@*Q-m;i6DP9PF;hvljuovZ!bev=4^Ce0-TS7QIaDhH?Mvy=nrWv7#@U8=M??N$Fi z|5PP9thn+=1y!m184N@Ugj6UfURYcA6SlcnYiTCdh*>G?!!nQ!?BK17gx{8ulXA@| z0yG-hv5OD{pTiG+VAG2V-bPp@54{~Wh+%;i58f4B(b6s?IDr;r#B{;y7~_}}MUJJI znL-t|4;s8qy-ex&=L6V+JQOm{RLQJIqUvBE6kE{`}@#1d0|xJ~ti|1t3)`bQ!hH4;lsWgDa~H zQ@@Q)rpQ9J`#O`rcNig)`=E?f@+6?)Xo&})d4BAzQP(Zp z9d&Hmw%JL?w$-t1Ke27ww*ADm)3I$Qf8O`|{!{1XRIS>zYF(_GJ!{V~=bmGXYw>t|LerR=aHD5veA#sn((!$NvLLpn({HH8_pM9)|r zF+Chf9imJ1b2ZZ2B_a^ZR9j*is1aIJUc5b-zEXZp5S?Awtjc7JS)|UF0&6py5$?cO z*sj3W0=v0x+>&c^1)v2|Ctp+iIxX8{weUerR^8Z}!o@bpuU5ccS&`C;n0~JHb_%OA z-eEA^w;-Kzm5r23?s237MYh{^W7O-DQ5cA#SK8v+9U&8m8eLff2i01FiBysK_Drv# z#>0476LM1vlUd2B@6MG9$!e+2sHs!>0t~pS3Q)vwma-jNMF%IHZ!lWEgf))G!RQ^# z@1Z2J#L{Guk`#dPU@*DuAh{ysLKQoV>uQXnd#2IlR?DrW#VEP-+~8i&PdersOryFQ zZGdXB18E86NUQb1BZEm_W`}f$#X3~|2BKT(kH_&3&B1I7BnI10#}(tCm}_*23N+bw z>M(>xsH&~zl~)fdn~2elW6iiV5-y0Z(*a5-(U}BjV+0t8I(H%Q+!zV4FHBn~})o=!tu0@7J=BFs|U+v>_^}aye#STqoVek&_>Jf&)5{=Iew5*>*|YZdI$`@#81BLbEY|DuuQ1|h|Bk~)fuh_51Q%3XJ&?2JH= zp@)Mre>d|M)RoWdX4ujwDK4DEu{x81YgHVDv2#U(@CQlR=t=Pf@(v4BaK@#Q&dNK% zYH5YeBmu#&XPiPC3XWSw!t0~La$e6Ch&zoim!{OXZUVh{Yq?eNhL%k_^axp1d4OPp z5VAdk*~ZEXD&S0{Z?pC7{Mt1Hxk0K(e8)sytZ(Z&ka!AM&57W-H^HGjh0sCFcOK4q zN}>HVvd?YZQYEksoE{kn*=l`IG*eu}H_|s;fq}(o0s?E5bei)h|MUs3Au4(_KD1(4 z{FA(T^n!IdR0z_RzQRbG6_6)6ltda9NwykllRa*Zs&(bxQNJMun zN)MOl!Fy`4SeLb)_sBwxzh?EgT&li_)n(#WVY{AF$`s@wn2uULo2qulrR2yiPoj0~1B@i0U$n#p zL|uJA2^UYU#@j5Gk6_mytu!f_jB+Yyr81S5taiZ8>rR~wvUn^SwKlAtCDC+$*(%nW ztj*os4L^hfi`lyaiDT`IGH>dnv*?%0-S=d@UZr#g}7s$nv3Joe(Z z6g@`|J*fB-8L63!=#b=GhAc>iKipZd$$E@gu_=TJvXoMc@v_3n0KI#>>bI*KM+{MC zP+b2>M)>s|%Ar$C*nY4`0eF0W2{$nO!36VnUbvh*pK)g8nLvw^T!TH=AJPo%G4;;Fq_{tJi_=+4iw zC4M&a1*Sj^c|a%+KtX$YQ03*tR*2Jyu-XDzQ1Q4A(H|RhR2{RA)PD@_c_0;4tz$df zJC{(pH<;w)(@*9`o;WiW*+Ec3xEe^r)A$vb11*lE66NA_EfBNgiKX|$7}gGKnI86* zTl;EQz_zamA%M^K3?KGUR~x~gH)gx1;hJ*}UzD=DpvdQYnMyX%Q2Hb zr&MN}m%#PYg(xT|w@__n77g551bdFS^vOCV*YLN0J0r<^>RaaoO83ODmyWon&d6pT zcoIyyFKB9>?w;9Nx=6jVd}B=Gjto13>ko4yXWafzG|QnK8d^bIq!GWdc@Mj zHzE$qxodjtTwZIi*7EGzTD#M=oc`C;)G5wq4ug;h`na|JBdK`oD)If(ueDz?1=j;b zFk=_GMi&-pSSYj(gdAl6S${wsEwjh{PS_!Whb zVEYJ~1D@nW6d{eS5p3eR+pvlR1PlOb=PVy~n)u!vlKZVCPM<4X-usLFbq)eaBbk!+ z@rrazrm2&5vCnKQ2Q{{JZ1b03s)ZRx!r!c=82eWkYmL zL;0jeY$&F;Q^A)B{_?S#Uzo z;2CP^@-lnR2gy6jjn9UBJ=0?$2x#d)-IUaepH#h}g;M zd6?1Efbf~THgYMjmsJRcm`V+V&U`mtsOk`L696vhC;vU<& z0zUwuDCu7=*n4Ve!Isx+pHXYcT*Xj3C8y$7aBez;-ZrEkNF#k5e~fc846m`h#0arC znCAf7nD&m5?2lsB9-iGsH|~&y>u!0V%wX5(dcas*PJxjklY1i;YU~b>zrGdfY8ukr zrvrh#IM=^q3%_90lH1hgKeh&!BU|41eS0kt;k!2hC?LZcb`aNB5S^nO8or2f?bo^k zo_}3qe+$2!ietw$MmQke{K3fn!@JinhDZRg-zf-vBg^URg>tAo<3=3vpG z!~sKu2-cS8(+BRun3(zEWu4V_^)kEuC8z^y$40a@1L@Kv@PD`V8%-6|erPL^~R?4N0gL#s6*xv*K_~ySH{H$j!k` z`_=obII{n6sC&JpZ$Nfz5Q5?TVepwbAN-ji<2Fmtd5ofa55@2rh~d5QSZnykL)ZKi z=xtS_^&vETN-XS7=)$T2z(ZF3HG7Q6@+#Ue+hI+we-HnEmW{;-)5ElubW{j$F+1!> zoZ+#O8RcF3vh}gv<`m%?*T}@XeM6dghFIz<&BQsH$)m%bf3&?6-H`JyzOwP(0oOH| z?i!66T~yKvtz0Xqzi*C=lMzc_XRU;qM?8~z9ky+Vl}pJ+kwpQ|$Z zG{5k3WAhP@>=1%_4h53?ZQui`#8Jmkvy0`6u1SM{sL}G6C3cDZOwcH(@bamJ*OWnf zsIu~Ik^T746jYhT*PKC)sPyvButC#`ZqfaBsK3Q_po1_dJH>a%pc$0hg8Fe#|K(rH zKsTU%Lco5)tzgK2@gVwbz5i_~_W^+hgFay{x>JYw@q?J)e|#eTTP)*?LZAXB)xR8Z z2GPDMyR)al>BiBc?^LERhLbZ#kU0G~p-AohlemM2qJQE*o1Pi`rIix(WH05t*ObJIJFSlFHHf*-#E{o|0Qb5oi*3uSu!v2dlxaa82|0DtHpM!W%KD@ z_19-k%onU4!9V>KK9%%wO!8%biJWPpLAN&Zt*Gww1O|F>6!G-2T!u#+4jD*DlZc@v z3)EEFt2SmNk&C3(0yB6OXO_F(ZQ^g^;2l%Q3%2m!ww#@|>O5*-s0MrZ{0B$jet7Zk zs+70k;gp60Ue&4O34eu&OwG*kOl?Zpw7Dq~_J#E=zM<>6izalG4wpU+2oog84@}0fM~YzAm$NF@rW>-otiM z;jan-NYR7Yg-83@$TR>*84nW_@dW!_8AfdL=L{2MNV#leX15MS!KzoZFWD#*^W9FN zHQQ8gPr<6+gsDMfDiUiWw~UgT?v$O`v0Ym;H70*uF_BoZEE7YvK^v8Cg}#&rQ@KHz zI(6v1lpRl`X0S7XsBI1@A|K5a`mkdJ+;M0d_6c^=Kyuc`$1VfFLe8=890_rsuqN2Y zE8J<~u0KYb6k~p%F=uh%EKc@yg;cjRiF+YssrKYB2@5R~6D|ZqM9*~SL1F7ev)$*y zZb{x?V4ndYsC9`xbbzf0f3u1aUHcn-ccup@kb(ack`DhiSw-w?@`avMd`Fs;(`+L*frW#$~Zt8Y@pxNTl}foca`~=!y}3`Hlx9f*^;tJ(#6l__2rW+ zGv-a4Bi;dsN$hElnzMyAo_*em)>Okzj>U-tg`ucUvQMRR=l$;slvP_*`>*IdIGFI3@oLyjt$EXu#nY-!BmNpOQhL}zP z)H|`^6bk4VJQn?vD#ZbfgYBxYhJF@*m)%@t8TkQ421s(t*Q@YBH!^)G4bRN) zMQ610W>#l!)62qmUN-V`@=s9+W@H>yf81-|@>xTcrsTfM9u7CL@Ri#($vq5KXDOU4 zV^{)|y~BIaV5|vQ%^GHM;+3m&R8;@+Bs@IS2h88dPqYjzpOr8XimBWT`dfljXxLI# zBjS>m6X%5n4s=oE_q!u6C>KcH;v^wzDAO9k|Xu47mhyi5WFyC*va{csGl=&T>5OJ+=`tsEy=2iwch z#lx}A$aSI18I`!Hh)ztF4osHpS+na% zA^7wWS zlDmK!Q>am6!-)5v7%gwB4t85!-KDYtJ8Ib|3WpFHYwKa!#fYY1jPPQnlB4hlRRV5# zZ_4=!y@6DEi$lS*WQfY!B~~NUhaEsrn?x5cb$jZJZu%Uwq2?-LtIUQX!?HW$GNn43 zfrV1TaHG3tnr2tYyz^Qz)1iJEx1uJc+=&=$9knRiLSaTFyY07rRMtW!s4^|_y=d_h z^WZUvJ`pw=_TKJ6XQb$~5e6Nx`Mp50VF{nha%F?tF&6ExZVZ>lzj(5m2nRqg!P2po z6baww_ApN1N5Y{Bc29CNhqj2LTxU@CMVy;|@Pe3nmL!9|b-5|jnbLa7Oq?WGaxGgD zBz+#uBEF^|cM>E6QG$h9a;!{~Sn|x%ud;iL`%OQH#%JNceFKF{{gILTpuZ0& zX^D_XMFfdik$713-@}KT2BKvSaQq&W{3;cu!oTujccewHo{Y2;hftu{-Y3o=>vsaN zl^~(PUBDqDHS}V83xBL;BlJ@-k@>vrAZ zx}gP;l60J&xV_b- z6hiN@wJI9@~pzZmYq_vbzZ&+75Z z4MlB)dRl$kMQ?nN%mU;t^MbL>pWJ9}sPsJhAMJu>*NHE8T)&3X;|>rZ&@ex!cJ7!D z`j()rdeHpSoec+a8l?Pc$?f*|lfnz8VeZ`H8DTsGy9TnAABiN%ZFw4Hu!y4uU+Xd` z;TJxH-pRoB+d{%lQn*Bkm^%x3_9QV>wnW&8n=F5x3MorA>==+3^rtUF@lXpJUvctNob8Q7_Ho(dUF_L|Z3_rF=9Q9d zY8=!iJ>V*_WxSTX6wFwZz*DZDe#LRs#-{|By^+;IC|GNpxrqP zINrQwXz`wsHUT{Chb1Gb?p*svMV<`OMsy=Gm=4==&+agI_fNE54<|fVBov=^Cyp#V z2b8oP4;!O+Mvrwjp4=n&kYfX-<>$Z(W2KyoL_%cTS>NThJ&oK6$}Q?W9LFR&6BFF1 zC~g#GcZ)Iyq`1OT9FQ3fNOi|fCd<pvHj- zL9v+u&tfz_w0iN9(D9MPrcQQ2&K$7Ydgo*rFw~3JrohuT3lPWj3cNjuAK*TP%vAM6 z`Z)-ZtdloH|rL{`3VNXy$Ar(kk4B z{?w}!S7v;xg4+*Lg+3A9V>S0;1ji`)dW&YO*T&Q-H60r^l|~NWk&5=gxFySGhK_Ra zki(i@XX2dzW+-JZ29;lzAt9;@zd*KdAYW^~i}gNNX|R%z&+6T`cuElAXAg{jf80V~ zwj`gIIIIgJVymI!$w@DEClIsCq)nhk+sWS`uPV0vEW~%sAZfltX}H!FP@~vIGSYGX zj>1rgG3?U%2xN!9L$UA(y*oi6`s*fmU!vrHhR)p$qg)?d3&Qi~{e5Q*!MJI_)$O0A z=(XY09cqKRcQ`+E3ld7&;v9y6vWnl5jkbx#r(eUTAQK2nOGo;zNU!S@-xk-?WzW~!B>zwCLBrtH{H7ER+&ne- z+jfn5x&os_w{F#{D@;J~$ekEGN05G;+b~;|rs^V-g`@Lu-2^6PKy$^_*-N?2<-V=$ z#ce){P%06(Woocvl)jZy9hd%K9h{@-VPR1%Q}YmGr`amci_WFhYWsb4M)ARM^qJ49 zL-N_;DXfrbSVX?{LZMF3m|eF4mkMy=>T+IHI%K_AcM?N7j1~}?A4)V8OP}msw;QlA zYwaB~FB}Y0wc~!%0%dDO=Lgoldpv*@Y`4j-Y(^S6hJjSLD{q%f|Xfu^-5@6 zPhO(+!Z=V-Q|~w)l5Ujn3<7w3;-8Y_)Qt4STZ0sNd5z2!d0|g4nCI)K5b@$s7=Kx?IOA2Yc0&#^f)T}^Mt1y%fF`)BfM(y^cI+ghzwK@$w5awO0riq4>P60?uk z87rfynLK&@iLT_7LWcxptTXc|^*)lcFB7>V3j%0i!XMVzFcfFsnrG{CZN&ppJNKLE zR}vmo4c-tf#Y|+72)4;`{PX6r1!lBh4MX@y^4U1inMey}Wwp@X; zlZCb_To0k;>+ivV9w*>vdK9%m`JK7@ZAM(i?y1GHvV}5i@R+;G3@6dD%`^XeQtL6} z5dbrrN^u~Y7kOgAiR2R0GEB{1yY}q(rwD^WYZ1ftuR)D0H?h>ti%L8a7YYbH%5Q&p zv*Bgx+isMVVc-JEfvnV*rR79)f{F`C2Bc*nfN*My5cC`z)wgcXZvKip)esleZjI;1 zamG@^D!k&f>G4iK!-jZ2>=u+h7UJn2zs3spJq>Di3%M{?tOzq^Yw*V zNRNWeVAId((eGXS8rO8!!X+7>6SQ)%p@0I4CI(hg!4OMzT^-rhN|m{hl@XAGylG+Q zZ+^|_`8<;BKw&5FBwv>WeGZiyn}HCVnb;xivx!D_)7a>?Cwh{p$_n-N}LC#RV>gc(Kk z;_Tcnx}|z4PN2w2J}Uc{D)25A(6}{+nRhdJqde^BBv%-JKfxy?XY)?=>VP5_HwyQA zP>;TfcW`FQ$a5Qs?-wMIpXa`97H_gR14?@k$B2u-6@zE#^Uq*oj<|gh8Zs=ykt8D{ zeYN;Hs^_*yxf{@@?E8{YUor8NpEdEc7f17PD@Q$Iq+WD*v&!-LJ1t2Yfad`{P4{4q zE&+Z=6tvUOUqk`@5elVvtmIT1_}IS`NM1lhKN9ziujVmFKk&Q(a4xvcQD>Kz$p63q zu2rkD29b*j^5>r5g~GVNlvu-|+X@;B4Q3V?8Alz3tgB-ngwO zCh?as7cObr&t%^V|AS6&z|XrA-xsG|uQk(8jLXQs?Te$7bBN@|VRDY0LE|=r{P&Jr zGNtj|Mw&O~DGI#6m~`ooK5orslec4uP83FFuT0HHMf88x9h{EsgK8kqAu&oTHulIY zKdpho=9WFazk9sO@niq4I;N?XfBMaQh{~}FJ*Kmu$R|Qkj)9>X1N;vso+nq^o36|j z;I)AI$+-1&%x<rluI?jz5V~ z@>>5qNt!`X<&pMts6#}vEUX6;k@JVVyIrA_Z#*XozhTof95pVFBPZ?4VUKM)dZAJZ zP2Vt4$vAjG2^4{D156XSP8`NuM?*8^G~u<=7CYK*_(}44vA!?_0l6MN%%326WG9~f zpE&^?q9-}`(hx(GASwhaZ z4Slp}DojXiC$a6{TiTl{AgiaXC%B#8%L8%+t&Nn5l#1p?SW9Q8r6=3lhk+U*Y5yMh zdGz%^9w7f`R!(5|kxTPC0T_u+!OsxP< zUBKv-xmJnptut-4`(vsaQBW~};(7*a<<5JH>*#57n(KP{%j*H*N5nHY(CZ(SvGmT(u5R!;_%aiW z37~Hzv1%;Y+!JfBj?rq`DYWw_VhMK`+2kddZljA5GoTyj>OQplsCsyL7#)Y95Qs?( zQ*0ex0lPZ8(dVzSlm58$ekMiT-^k20k8)>t2Ah)uyCit|_R^`0)L(a0^V$r1fa^-r zU>GWsGA^^xjMo>`V>yUKgEpRS3JKL+1jvihuRVqwZ)D-=C|pGkwsfRPXe#o~PJ7BX zGZjB*iSnvzf5CTkAI%MdJv!ZlH`wSOt$X0)wxbT_M21zUQKYtal@p>ME6{_q(Zp^y zGnjwspN}QJ6FsPA^e~j49gejMjw*lywU)Qzj-K-6#t~B!==yVFE3J%6)k#IM1u&2w zY(8P4^_lj46A@ML@)BfAoNOBFciuD9ts7udWZ00@<-BBejR-y~!NQ(mDy(?BjW$-e z_m--`o4Hb&jA3fTDym;eNT-Z1Fr4&D>otPiON}Rr8K4x#8k zICOsixR|0(#I%E*TM?D1fjy!zL9U9M3r^H{)03Qsb%g7?IuJ6PewxAKlTuN-XV zC#OUdquZeg$`8I;MuyncOt1v%=4&0Yv!$;>AK6E{fN){r80=it;SX9{kgH5 z{TG-v#2KO6@IWBSSqC~sAKiZZy_I_Lxs_wgt`g%r4XNib5+ZHPu9*GCU>D}4p~^q{ z3a5p(;G-0V0z9O>1n3q@Kyw*-%leAY*f;gG*6Gi!%y{n9OsnNati0I21h#Wd_G=V( zxz9wR^H6K|Ve$+N<_(?~mL|t9=zQvJaC*+s#5tSL-SQCxN^TK}nQ=*XD@lv=(tcRO zq!hWS;l$r$#m5Xe1IJ>sa)YRJ!iLcGIv!mSY6`~aPmjPMb z`}x`V8j3V%&(z+MRSMm6s}MzvNt-82o@Ujqs`GCU3%}VXZ2)&2YB}Yu1|IyQzet~G zMzi1-q%M6-a|0rm0F<<#=o@?CB>G>@vOUdruS0Z1*6bG(JQhAP)y_Gu{< z>jo9FgOfNMGNbouOiNno#SC20xhbd&zkX$fU~$i>P#d91yrdQ)GoWDPDHJeKJ4Zig*gfmj zW?}GZ2}$n4=R_xxeWf|KCJQfAH0-y<@&}o}Ivy;7jrWH?XBDuwq=O22-a+E_k0q%q zErl%@>^{S}e=~6{*7$^-^ginF&q&hh-hmj|CsxMH0#Zp4Jj|sH(<(EGY*GJ8h-UM! z1`mG)vjED#iFRQyyhHZ-{L6t4vsa`~nm^&#LFn+HSeKD0HzA$Q#B*IKHS)-F^F(vC zVR8w@_|1NFsyA4bGO3=6Thcde@IHHFFtluB`gBdIS=eJ*L<&_*R(Y40Vl5_u)rnJ| z`RoIl0ZUtXUaf!QerfvKV3j$Ki&trhT5K{ao+ZZ#ZPvSuq?2%$z^UB;EsiQxcua}V zRE;}Eybct1?2_=c;khN}PCl|N5@uIz%a7a`?DUs81fp76ToGH8rABa-x5DtD=!nP? zg`c5m1Po(6HH|_?#S|C+Awa1>7>MTc4X^c^13sdx!zAy;-lW^Ju{@#)Q0^LwOGAFJ zM(Srp!<9J{m&fmb66lt{&_ywiAq-J`2G+hh?OIX-1UT=VcF7Wr%RJ+K{%)Ig%b!yC z)JDsp;xA64 zLMuXn^dtxk`1Ee6ch}J&5(pT4+P8MAKs1Cq{NLBh{I_fsP6vy`9=DO*Dzzfy1|AP@jW%35*@0;r$G9Zuu@f*QhYZhzV; zq|~HC!_#wTbtJMI<3o?N?u1%07B(nF}xVTw%!$n<`wNUP{5_vvd6uS z?zNAGr)#!;@cIF-Yq42z%h0x7w(WY*A?nF3`^`NRbY91hJT;#sAqJ|0`FW>wQxqnuJd63<9f(L)L&y+3V%$j*G|Nn^$dgIln%WD;WyQnpmSi&Wm<=BMQ~D zD#@J<)jxBv8(SrBuPV;L))Kn!zKx^y(i5i4&P~in-+nDW}JYoOB zKOWr;<;HdXdUFR}N{-aAdh`!rj*FXv%rw5nE4_(zw^S zz!x0HdL`wgGJtx?xR7|cMz#CC@6IQm?)0TR@}6Z}jj>ScXSK4!JW2)cK3twi z>+_ppo~5PEl6Q4MEN)a|MyBB5asXvzcnWj(PO#$fI=?SD976qqVuC1tM$u9~@d>*G z*BYEtd~#-9gr4he)gO*aWHz}e=wl-52zn-Z%rZOJGi!VO9Df{2vMsC$Q>Bw8Hm(=Mp5>e8oO_tB`CYo-VYa~5aiXrrQBM?Sjn8#Qq zFMq6Xtdgpj`U&2$)dM002JNvI=Yabi{36n5V@zQYY+=G%U|MQG$|GAIOut!8m;WpcG} z9lhPZTzLL?s++7`hX0k#n*Q|HllQn(-o;4FO^E+=Ou%z@B~)NMR!=90ZB$S<3D5;pwc01_v)g;ht9YQYi#1T6n=idXg>@)tR@V{RRUvJp+Nze3 z3Xi<+a=~mQDH7J}4B62;h5>4ImkN_B=1*K-0uI*rjMWm>&goNI{)9Fj{JLkdS`=J- z@aS(ujp=ej3=GaFTmNGQPrOA@k)+Ab`px_)QC0}Sk>$2z1V|#nRl0$Ko(=mJo8ygR zqCq)dGO?2HMO7xX6k9T9_iY@W>=|YH#N|XvsmAeXOlt%gbDR}#7Fwby4H_{i)H}NL zQFF)G`nVaE@JC+=Nx^yGQ1)v0dALK{Xvg$?q`H> zHSq{RIB+EM0`xWMsed>tT|QD77ZY{-jL8Akx}buK!V9xuO3s@~(?;W}RNmS3LXqAB!J%i5n{6$$*8t9rSXNq~vM#YM zu~mEh{4c8vQSy7HzIh1bjRaZ~19|`Hn>IlQ_CMl8g!kV)$+J@sGQg(IJR>Hb&2q9! zkhL*RWYkRq;ZF=O8!Ey)IQc?(@^BYmQifZa)^M3s$(pXe=?=1eALzAwD1$~`fWuD| z$=eTng5lwL#4@C`LPP>kH8PY?{=%4BbVGBzb!?I>HEYNTLTxBS4 zyJDm3C?ULR^y0%~?0{a(Ym-{dL$>%zB4A2YtpvO0<(QQ?iSRBRr76J!A8M(?$Mgk=`j zrDVPCp+}oypoiDzJnM|X%B})w<-_6NQ?Nab^#Vp+Xap?VGyqScJr2Nm+vx*KvqR}9 zY4O!$$9ov9R245<&T5v_@9P&8?n|EUKpSyPB=mL;%TzhV#E;1p9JEP`4l9+nke^Zl zs{ilCFJF>kg18#KHBRI=9s3*e?8ZUx?vk{7a8yg13p3iUIZ46aIVV%KTo>RTw;|O} zo~}7K+0Yad41ijf+$P43a4oF~w~Cwta%6@gWVb+Qbh~mP6t;zv)xrq|C!)U{Ur;H( z(GBz?th#8cceqy{seVYQllSNtV7Ds7Z)O@W#P+a7W$fF|FYC=0hU3-KjZr%t;M}{B zjW#*FurI1X&b!B0_>TWnJsH&Wb=HQmd*Jy`gnSpVNdHUuLZCPc4f+1UFo6G$KF{eX z2-5%R0{5ArBxLA3O_mG#+hJ_ZVApm}9D#l>12m*)ogL3np(k9`}LPSILcfN`{W)Lb;OlTQ> zA4Qrysl3tFM(warP!gRE;-*!j6)fg|RqxJ^A9&L?PMvKcg)nH-wrh0y7QYdMS{1W* z$ivG#im_Yi-O<*w?ThNqvd$HWETe$~4z0dU=m4%r=7C8Z39=8N zYN4!R*hBX&`bK&<*NO!TM&*<#A^wGPTt)Gi-hMEl`~?QRPG+-yM}4;d99a#GEFdP; zDD<~@t_!3%+EN^>LYll`maxlQ#)#&;>V5Woy=ph7?@7Q(!oOe@6FITFC98Hs2K56s zu1BNOyLF>oDF!SUEP!}1$Cvy+0fj{5qB`f_8nN%M*%h5Mf8V~v)M35>?bh}jsC_T! zGG|tGh0?c?CXc0lDkijsB~JWQ^Kx$1FtuWs#Y`F07g|l55tVW$x9d|Y1Mtd^sevXV zJfoL_w*`fggr{F2L{Un!8&Gb!wy7ZbyiUK&{k~q`p}W022q3|#pMWKP3f_%(LJw5} zB<#e^OJo0mrMYiH$NxQfgMjIYQS~pM32T+yK4VB5fae}L---QVL|J{61b&N!Y8PiW zVv6vLOmoHbLPMm(WeSOs8V+fQ3X)G$6nlkiA|IWfT!+8u1e-GA>OsKtiv`}~q%SkT zUE9SDT0OLH@>mb}|si z->^?d2}cFfXX?<9<0QEl35n98Nm+^F#g#jM_LJvy&DZ-gjPIGcF=jHgWO0#&o zk-a3G;x?({dpgZ+DJhas$Z5=h_6tHt?X*n1eXB9EDU)5^7_tbWoH{>tFO+Zy@$pIv zAGnA@-j8_2LFLh7Xq65-x~G68`wQKsL7yvlvX@oTX}ng89K1UjTb;|^s;ws-z(9}g z6dabot#E_QZ5VsaEwoGda(mjY@nqcDhgh~=E!5;(3=uw!gV_12%id`(Gg4MkJW=J- zU;h#u6qD0F&rr@YqYiF*yldp60q4(XSJ0i;)RjCMF$?x``UwUu$o1iqf&@;rt(I(X z%m_+tb8*U`IvXZhiIWqVx-)Tw}%szYP+W;u31^hz7@(p-nb&F=F6C(!S@w(*4rIKvE}>!C%_ zB56{U?V%*-v-CMTZr@{#P)mDL7CFRt+#+@o-AN5FCGqZV!@0_5t`%@wn8bDvCJ$w{ z%rLwEcqg;B2;MhJyd&H@+g!tRsmuvQY}Gqi%GcOj*jCt=X@yIL32Q5&9&E1%*cM)X zTp*EQ$x5z%T+nu4DHR3)uJZLoBm;3vj&%qU>EsBE=*jI+%@kYb|8v z+2LXy8w?d_aI2>d;BxRwv0DDzvWSc`NmWg%G-xoXTHh?SIs>b*Wg_mZ^`%>uaDldL zCq6cL2hU5zWn5axrg7YWM$>zuW19*M4pTb#GxH497%W+Y`E6pr!Y}vs5L*-h*7f27 zYwmx=37O;`FA2nyRpdkk`+oS^uYZZEeG%RM9^C6~p$rh*E$wA97F2I@cu9U8fudyY z!Vg}satG=TVUa@Kr1esT?$E{;?o@XKf+KGISw=WsAI^vYBPej)zG#*Sm*1eyPMq^} zb0wG~VRFG&fn#k22-Ilajgftqu;^*DyI`8HrrMdO3kR(bMSn&!_ZlX^PafOYmMj|&foTw&)4^=?@@C65@7f&B>wD2 zdzUHubr5vjmYdT{SdL_ojaY;h$ePHukw@@*srHAC5O@TQ9)7vH=AVs#)1B&&(qF5< z*pSK)1%y3(az5HGn3nxJkcwZ>lPrm5Bi{&05%hoRObJ;CbU@L6`KPFvO(;BY@^g(v z<}i)_!#@oWAPWpdA*c zJ=Ogr`uTdXNAW|hcKq5dHoC1|H1fAyUIDF2TsUbCse5JP&h3h%wX$Sw#i9}MMW5Wz zFGDlfL4fkL@NsI-CBi}Ps~wij=O(M05(t4xaFqI5&|QP_y7Ysi7Vhv&ry~dLW|+8J zY2*bXZWa+i$kE02v?KSMkq3!%Ln=big=zi@aieS%<@k0;8Q(-gpz=2qY6_csPiiDa zRz*CDETNZ~qe5q_RrqN}J5@(5pCNzmyEE(63{Z8|ly#prbuOvv@NIgkda;@|Z%7%3 zGp$&vWX*CZy6A3wcp0ehNprW^sU4o-a!u)R$Y-|wGJGONR8&NH`{Iy?z6`m|PAzp! zlP+Y8*MD%*coIw2FRL)1v&xP$c%xiajWW(H87uW6&iRb?%ljvDXGNG(5m=Z3bF$7N zC>3)U1ns(>;L8!TbJdg_&4(0xjas~ zJw^fE-*3@+VK$6caLMKcG)TzB{ATpiOXY)@IU^gy%~3|$lGaKC^}fWln6^}B|46To zEr1$c4;zsCs~=OkaR6|~;~usdl@VmkVG-~jrZ~MbsPUZf2|}1Fc5_R<->FyUj|=y! z{>{%zM>$c{uH5CjwlReW`R7P|(>Ajuw}9o=9_#+tJLrcf)0xjMs2Y|Xb{EUL@?dY_v5JQr3NXdW_7!+Xgo7ruJ@G2e^?Y70t^L)S8zN7Z6 zRp^sVq#{uhr}t!65hKNXM-qdkbuB1n@n`BEyk&@QgC&kueR=xx^u9?DR-gY?N#7Xw zf6+vle~lsBx9*$__P5@~_o<<+HG{d6qkc-H_4m)OaJg^kjX||dSCnD2uc&U9E_63K z+TZ6tnAPj(u*NyP3hRiV{)!B+Qz25+&68W2*I|s)h%_*#76!7?B^FD(rWJde%Mq;o zzK+dS0;RY($=lC6y3a%S@bpOkm!?y*RNo5~q(oqO^pD5!YGb;MvbHG{>OxY$_Vk{UuU*28O)c# z!{^vX%L&~NTcdY3m9s%)o|sSC{;?!VD$#I9k_k4k^U6z zgr`=gnQ|0(0y^_OgwAeoVVKk_#okINI~-0fi!k0eRT?!itThcjr#@vxiDtdz#uJ*s74l0jMCc!8E{LWtE0cWy|8_swk)dR2e}e z6;FrtD)vJ1)^XRuc7$5vWno2Eb(lGQoW^0X9#}Z7!C@oa!r}ym`*dQ;@=?o0%xyH* zU#4o5rGo>RA_~L4^O(&(JPGe?UVhVg&TDppZBFo_m zz+q8(5rxKicAKg|9W@P`E-k_&OkZoyrf@7ZHJ{Ir;%+z^FGo+^L-~7|)_GDH66~umO|`8F_w-xcD6)Pt|`HDk>K) zE3V3l((9_FF0@_2md8PR^R{Q?e*d^c^Io>k^Y+eC-@n7FRR)kxKc2BkZ{&6z{i9P! zJkhQq+uCEL3w&XA&B9sWm9d zUrmTDD#Fr9tKHT}Y-U@sS5YAg#r_pjTz(Ke7K*dBa|xjOrWE(R8CrCKQT%QZJ7=O^ zI#WrY&Y4fEyD56VNlIqolr!FNE;iv=@=t5Q*fjindBp*Q>q44VX{_5>s2D`GmdLKB z8fTz11z|OK$g)D^>9y%4l1G)3*~P5PQ!WFfs@C*?8pD(mF*s;3G8KQRPcDx}Q?2sT zT$;5j&?iumx93jG9FJ{GlsAOFhX5aXAkiuXYsfwR#NqH0(ux*H8VYt6EzKN{3TqRD z-wvI`}xiP;#!cGp5mxUYPJX2>W!t-o!VB%Pl8gWz0(}ENh@hYE ze;I)NrVx0Hj30$Rmk^DgHM08uxO&InO2WSDcY=v++qN;W?POxx#*S^rDO8zfIgO7@Y!|oE|o+2@w# zUPk%TRZ^c2WIx4|Qcx^Xn3aYRuw&_3BCJH2@|1x8e%i1?aBB_gae?w?KH3sJYEEa0 z(QANoY>IomES?BS=W?o2*j=&6pmk@ z%Qx%(+4KQ&e*e92`QH;Apik+$@4tAMFw;oKjyTi%pE4gJ9FfFE3VPVR*rst zsS?<-qhy3pF*#1roEVcA?cC7A8qOE9V09HA;d$R?KmX;i&D!*4Lr%Lnzw5luRq^MB z%zFsHV{!L8N~P*sF)BA`f%Dw`x@{Q%At}Ksm{t)^gDq920KdhTt&9pUE8{kqFETK9 zjShVNs1@8(=d+BkvU4_M4^7`{gSa>gOuDt!=JyrKa4L4fNioOX9>^vLUE98*Y(>h3 zV8GuGGlS8kE#r_LCYEY?C9@{*(ndhC-FIP@(&Z?7@#hAcTKo*{$gA)e4$TWt$R28R zoqI+c00=?);$;D9tFw7C{ev#3yMr2t5=e2sf?k*g9gg(fLLlV|U($@@rgR)!tYfH#&x|+8z zC3Xw-r`gTrHztXZT@bAzyQCN(BL52;*GODTiwDp4o|X{zlc!tI`;xX!=%A>t!vkvH zkn$+x4&n<|p<9O1#~5puXKQqy>T`dSrz_z3&Pm~Qiv^>E&(RyJ6GsSV`*`Mny?3_P zKH#V0Z8JXp=p>=%msle4kbSBl{;*Fp2o5-B_K{n#VW45+KEkj>G|w<6Wi&d+5XTTF z8HcPR2Tlqn6ix!p^*(xGk)&pqY`5AM^#7=;|MNz;3ZmnEn@@LDudTL&ngY8J|14BkLG5XFM??e&L`x6>bDE zabhy&toEKcM@dc>g zgMEDXwu>Pka~4cq9@`-V=S|O#o3S|WC2!mV&b&^{qYIv26Co!jY6H&h;H)r#N zqHBDba@k7|gVz8o`D7Yi+d{J;EXK+JlEnaLe6lqX_NK8LfX6aOb{;b8#0?EFXP@tJ z0*cz#V{p^t&U4O@ap8_K*_oH446M>+XlHBL4WTSYCv+ z@^5>AA)Wj6V7YtBYx%3F->&;z_dU;~RG_)W^G2F;Skr@TVCGJT5jQk5&p!Q}jX&1b zAr7j_ydtVHjzy#Ek@_mVo*y&yz$sSpDVng9Rv% z%j&Ji_C01)-kF!Ho}V;G5)R(MsSK_e;GFn=6{OGO z>jw>)TssFo-x4b2O=H2rs>-TaRB85tWr^iCbf{Qr9*E_LrN&bA(`nVrg#>~E4fU@j zK@jgJw<$r8f++Jpw1{L%5ZM3G+<(HGKOQo~?@WX_i4i*r2y7f|D+n+kG`&dV{gvBg zb-0yiLXuvIETPQZ$k@=W-JhOoE}3&5`*~Z5d6Lg~HuJ6q=k8dHi$dnCg*0>1IddOd z(>wSF+Y^>eZ&xl^L5vBxCGlsM=gX`0&1T!@EWXceF#wPq{Sg4=p{Q;iavtezAt*2# zbJ}>)-f=^GqR^ClB2pYfPD@lYRRcJre)SPA`gwpcWIX719XJtcVKUFj2z-772oK{h^ z?mt|=bi3-*rYmqi*%B&(FNHmD#5}ALh-&q;q93o;8kueKJYuL{ER2BoyLO>4F5MxS zqxAT}JOBgL>OOdK>k3KV5<4sxNkzXRpg4Dfsj?xDs0=_r#KWkdAmpCUZCB}Er;0{1 z9L(_XPYFT0jMJZiEqJFt3sKnGtRA>KZOjB^L&2b($ZP=3WW7vp8S9zOAB&|vx*a7@ z+Mc5y2v;pPQnUuPl4qXGR8(4jP8sx)tuY{T`e=yLPLj$0Qk1-5=(&ABh?+; z-Bc!Buotjd-rThlJ2wSzSSR%a00m?Og+$iBS*>x2cc|L185=tWc-Vx)?Dp3<$_#

;*Jp_X{pm|tsRp@LFQ$2&qHGlHcZ*qoTT|$*v&lp?pTKaP^AJC7*$Qw?C(Wu5J6A`*6Vl%oq$hxx0V7wvCW@uDl zLl2nS7jbcm)1j}Mk9cs8)7A-uOXg3?YR%ojZ`So|4H8oOOZV-)?p}XjQ{!?>)L}Te z?~yB4aXgAtbk0_GIbDkG9i=M)j0ng+OErR)zQe;iD-!JTbo)PdNO_5<~XMctnQ3YM?k+3q$WTu|5dRu@J+CX@+l$w>E)%se63IV5^$|zZrLx=iIN(Faz z`Vec5iJ}Qa9f@O74$M)#bGd%i@R-s9R;H4fWWfaC2wK40f9Ykqzjb zWyl_M^ol7O=5>o+n~I-88Cd@3+Z5eIsE%7b}MrvwdS=AxBrvr)XsDa z-a(G^y*;SNM)M-2tVQ(lo^c$~Khn5;yMhwA@&53wzUDu`u3#PAq-aZ25ZFtuM&({! z=(ClXTDL8~cS!7iYq2@~AY<|FiUc&x4a3iDdW8ddBt7z4GYO+RZM!w^y)O@=d-ip~ zcGbwezZj%;@l`TiC}FCRN-D)`3M?>%B=}fFc!OD4mT zGV2U+kZajaT|ktDE5fX^ zMXd1Y5|Mp@%W>(W2==kG^&DHyS{ds?$f0s-WU1G|5UI((228AmNv%(df~KIACc5b+ zl{!{Lt@@?E_+eoAbG1d0t`b9N*5gsnz}%d@r*sf}i-4)yn=U%xORTlh=~Pn(FkAtF zqN=;RgIzC)O+Jwz)BV!bNMl*-(FynVf=k_xZNDvr;EAwEo5>^b1zYs-G9YF{oSZB? zW{3U_c=tyuNx7I4&IJ3AmA@6spWk_Ue$GP4+38pdrZ}}X@-A#COwp;43!Ge{lIq0@ z8nq{%ih!Kj_4GgNtRDQhA5g-t-@l>8f24miW%I~8epo59sFl6EAd*V3NvW5nJeBCn zsTN#F&bfEq$~U|e!jG0eL&Nk^R~yv7Eni+#j8|I~rZ?oEj@V|!={qR;Z6V&_Cz+jd zc{S~E7jb8~Pc)8WhTP-}&do!0g}ghw@iO*s?*V3^u2Th+I>$L;Qaq}BF>X9)sbZ!) zXqjTJ9kN+s*O`AGn;#;TV9pssCf)F5UVJ~g!eu86!O{Mq>h$yd9oF{>1rI%T9r#YQ zhIYx1IcF4j!ebbSdzJ{@*Cr#3uG1C7S$BZ6cLG7$djb1t@m0+-1GNttYF8#7cr_gf zx&*`ozS2`)5Tyz|a@{J=q(%n$Pj?189JHrk^#fj2J<-^oe<)C?@UvO8NFfk?E7W4-G%wV z1|s+s|4x3vCCe`;SDc*5pad1>3ndaup*EsWr|Ztn@KTN@6q{PaRy@+nOiM_$@I z+d;L_lvrW&oT!A**-c)o%yfXS1E{I1`YHA;V$f6mFc5urvt6qHJl_GEZWi7`JdN#D+)6$tf?*?XwKsLjZZ}4T>z1#I&_Wyq;`MK~J zzmK*B<=}R4iZfrjjvfw74GH;O4P>|c)csw+$?KHB(1r`Ht%2L23&|l;7L^TGUumR(~OW!R2?7U*QH}r?1u~l0k zV4hT&5bfYY=qDdLCG-JNoyB?7lRuY?{17-43S=x=l$E1OlCbKH(Sq$7#}3dA4I;v3 z5-Si9Rx<0s1ZbwTum}@3SZVM^i2Sy5W@<FA!gUi#nX$G zn2@#Ak71No?rr1qog-P_m31*`9<0lHgY!>*TMPiAdn6jVZ+MyoKT)-|IYGC)0~(r@ zW2e4&ifTwii< zg4~G(dk<%Zxa6)5g2bsbVN+L1&3k$~HS;f2>dElyN?Ni~A<{vNG*L$gep;q7AmG9( zuou!;_wmIOGC!~PW)MF^YaZJLQa|GI?0yKG<`%u88U_8c*tQlXeRnqJ=F;g!9vvL& z`?6f72Y`L1lulm@;j|E;dw})5Z^5zT9n_Fyq;;{GOD)>m(vtQ1ZZdn2-dCAafbTAg z+LPe63HFAuIvOTNKGH7@i~xO%-fgTYm?XrD5OkN_74Rf7^am=zhqH z9J3r6t1~^53-0jG>svRNcYYLvFmgjXBq0&E7{JYLBvc!Ry$L!U4b4@b6Zr*%wE4>D z2z{_h!Mq*hC8FOCXPzNDjNFsO=Ypy|HrczhRw!CKBMLNAyOFtorqTrKw)!66~*j96gmOv0%SRQ}h&nhV1{P(^sng z51k%J0)h~FRSypcnZ^pH_VFMc;+qrw0?p>oYP>)(mwTb&);Ns^7p6>60qAtsKCx z7Me@2!D^#!*++F+MIjk{uo4xSPum)tHia>lrLWGHmpRGOarS(`>^R`WYRDb*kZo5F z_iVROXO+?p)ne0rPC8GraMN{}9-K6_S}d`ySPy-8i@XLf0~cziz-y`QTpXAQ6Gvej zz|`DK0lVC{*@v!xpnmNVXVj>nP5FhYzlvd*S>4BlF|`nODtA1-a^V-~$fpmw2_q!1 z@eCIhz7Rb)*H&ssFtva>$MoSvhk%_5Zx+vA|p(YHdZA_7^O>g$|>kMftiH$>My z*h{m{(72j-H=m5c@`?shIAyQlc6E_B&7C6OmeyjkK`t z-thojIWMKD@tS6qHSWK9dY(FgylorRg4y#yXYQ0>0Nvc_5f+{49$UB~jRQ6GqGM(7 zok+wF1Lhd3m)@={l`?gUZi44ABw7h;M(0N3lG7G)`IR(sAxL>X)=biGZbV2Y>!@_u zp zhwtlgnCA?e7MSOB>p~|1%VLS2%tcQ3D10P(G{f%{fBmjBP+4BI_70;qkK3NYn44yp zT1i-;4qz|K?INie|15G_bf#d^C8@!Ro3jlP879Nymext!{sa)?_hf~d7A*%eo*O`e zQLCuJ$xR(9#1E+C1PR?2*x2ZSa@Jr+eLP`Dx zMaiIlBYO|U!4YU5f97bbVNN&S(9nGzC6Vb*_zRsRKE%Hn0eFy3vl-OV+;u=yWl(8r z1cW?Yoau`vxLM*)9fM-z>OxKux9R{-FXf)Is5VCNd%o`?sxKT~eU}TXe|dwtoX)pu z7HIq%2-_#6Uiiy5Q7i-O_Eg)8SY66OUP>i*QA;-p5qzVr^~u+>rCx?fUSTc<67wtj zQs7?J`?d@!GUBeqPhBuJca@9c#;|}}FI88> zXKby3fVQFfC`|qe%a4DI`_t!GfZ5brV7z5U9gCjSDgNs4X#J3yZ3P7=<40bXQ*DAz zCVe%RnS7z;T1kGM*|^^HXlJVnUkR(daooT0C-H7nh{-GQZe($ZC&@o_ym&V{Mw(h$ zMxxs!VaYwqFiR+jZrlHW8Jf4aL88c^CUK`Va>0K6DuGLg#U)9Z@%zDsWEp}W0#q&k zYj-qBfR)OnEJ~WuR4^#|Dai0g(PV|yGZgv*3}FxzQWF$3Nq1#K@hI8(4Q%>xhW=@$ zMXO_iQ;hF4w7nDgE$lr_wt=aI!_O7Vd)#sDnSH-C{dzf#|AW7S%wcRmuT&It#qIK9 z?wxdBpF4hZr>!+eM0c8(NCl*4U^GbnWq0f-q|}4iCG8qR24hD@DsYt2oK@K|#*l3?cI~;Vs?2}}IWEEQvOX>ml$S3M3?3tBUrQgKv6JTtL^!h` z$kP$0J%bZ6eWDK)7}pV}F~7>3{0+=5GY&YcvYF*EZEda7 zk5#7aHL4_HcX}ohf*0UbkI6jRs<}9Cx*|=t52a_ zo|z0ZNtTi|2<=j#bEok)L6zZ+)B*K_kW4KSg_lq$9uZzuksuT1h)ItO3YqmlCK;>? zsFPlyp$FNA9Kqy~&yZF~2HPQ(3|yRsI2?6BP@Lp_;AC`UP8MQjf1wk?>}otL=Axrx zWQU(A;9a&3 zNF<%lYNyA(7v$@?%y(Qytp;c?%8%AatYb7?C_)5qC`9}U#)!T*P;ktouy-tt%QLeV z2{hyW7TzTrYW!^-MPNkOYqy7B0)g2yniM%P!-5 zvUW&xxCzmm!V2)ro#XZYxd~1>4K2h96z)X%GB}X&;d=(N|DGzhhzBXGlT=$IHU$N; z9qKN(SC~o-fEO?=n|d+cqLZoCxkp#$QxT_plJ;B)(4ce-Atvvlo7=ePoY1(c1_Ru* z2U&N=-Y(3zk~*2vb10MzH13V(8Rs$?=d{k7is#ZMgRhw7x=an6(!dII%HaLhDiqo1l3SP5>c6L!b>m4q&4dk2+u+6!Qft#^Gh>E&tB zp$q|lBy8iT+NBS13+c^(LY+sw1@$gtOSXz3EkHc2XHj(g--gciqSz*wfVQX>^xuC} z*7x98Yo+$ev?x%XDi+mMWtzy=Jw4tMES`h5mad+zzOuJ)d3lMyL5v4EwJRn1Y_3%e zg&ul1cy-vcI}42`R5oWzcZ*!A+@J#0k~W-5cya_~weEGu&Wn?&Q;t|X1z99!-9_|D zS^$+1&PnPiuI~2kfz`^(d6DK8E^9l{#8=FXNIm-6H(2lyWI}~yTMIykv4u>@lqJ9q z=!niT_s{gcEMMC}>cgZ;xDWtFHHH_2Q0Dvt=zU*4}GS_vFuu z7P%^e%}Hnf4YA2%M*u<$n>#z3Pqg53ngMcX@Vr?3xr?RYEPWhwXIUnwmuYTL2y%L4 z9jrSs-Vuh|R{g(u^7ncJsen~dH_sSvx&8rv?v_GDddDzlaAZ7chkyH$V>saQ=SJ;9 zXBJ3s3w7hfvCl4CKR<#IeXa01Z3#W213vNMy8S0YneU+&Jl#x=)F`Sq1iEKNLjdrn z*nZz~fvB0rQ2Dp$C?muVQq&JzEr+knJFDsed;{iQ!9x)(f8ZS#nfE#OhQql3Ec{v< zsgM%B-?z^kx_9&AQ4{i196$|z*khW@-Zc!t$VPH~0)n^EbL$2N`M&721Et@SWbH8J zq5RVoaKWDK>be_vx)>Z+W`v)$8wB7++wM8BmQ&4~SCsLu^aU>iLa%4+kZ$+KAZMng z(9UL=c|ayJSpm~&jabdGvo6l7@ngRt^7M>>Yc%?YkMAx*F#AZU;4XZkPoZxuKRBGd zX}gQOb_YoCvP&2!IjAvrI7i}ic1P=iiG-1SfM*7QrpD}m^hBHR193$g#u3JGm3KjK zs5$#%kKi=3vlAGA4flqV>0~$7n;u{e&fbYqPX5q*`Wzi{ceVY$$D{K($R-0nUQ1k% zlw5G&|9PfGs)C^dqU8U}bvb8YlmY(CMG?&VgH5>OD}VzHzEIW|4;ebA!(n}4zGBpg zUAc_-K^+|m!taY8gi(^Lh!7&a#m;PNvhA@|z0L0f>=xwhhh92Kd#8N*q@Y*OnmD*EpClBdJRz<_V<1k9sExO-`5?D3wkZDye8E zTn6a_cfuFlQk5{PP+WECtdQ0yJsU8;%Qb)7K6g4Xk;`3G*VE>guZughlzFiOXZURJYq@6V_Uf-ub2cRB zR{1?O&hAWQnwoze#Ui_Va+gbJk_~O$4L>aBr=*Y-e$l96fx6@utTui2>b+@}f+#MXsm)tFpk5_ z6@h#y0zvOY5iI>t`^1uyAywFrMRg-gM(2Y3=eUtkOf0N7`5sHcSLup{Ug(c zzm^DKA{kQO8Ue~M%-(iGu%!9+I_0zYXmGDk>va8}U6fz5;XJ_!;j&DH&=L~lV^Q*+ zOm^82liF3Bhio5ND3!j5&Q=yk$u!(=^2De4*()>E0nODC_y>fZ?y(wKf?x&Sg3A+sll^m_26A#3WV&i2|> z@9r4*wbLstlY@}99HxH$wKV0w6G#!~EY7yj4qLq_Dc_dCtEzK$!9jd`@XINJ$L|mv zD>`@hGH^%kN?nnGc257qHj>1e zaS(M>CvrK#$>oXKDtP*K2`QB$U?WBR2pK)I2S9O3to-zAh(Xq+HiTUHbd{dtksYz| z1VRC;#8a3oSz-uvI_{c>%)TDI(O0XG9WsYtdz7|NGL>ol-i1H>{I>o~uM5P}&(}XcGmz~BnUn4QS8QoST(mEv z)QQG<&wQ5$z!pkG9bX6_*}7HcT^@X;e@5361ox*4eRJ#tYkp2*YQXlYhn*)v5>$= zVHZm(EPRq8u+12)?CGb<80{8)N-PLqKeB0_Ff6=XbxLF4(L8ztqa}G6F4opE_Uo;# zCMf|p>{ZVgQ8#Gv(3~9$u}@6I=^2~?O6?^ru3PPR_M(*(Nwd{XBb1qd!Pq82HLVW| zCJM!1vIeLBoYAAemqhCy&ItSK)5dDT%)60XSn??vt&R*kk5x`Q^sP{-4b6BaS&$pr zQz1)i3A8cqD4B>=R)VfGUZ6 zeuCzmP4loy^WG4u1SX*M*{!3pF*QC*6s98r?|Mhp?*2x%+Du{cPFu!D_tqi|&Wn$q zQoFxD2LHcS3GkTVYH8h%ime5aLf`f$x%m^vs{>O5A$;zv%-ex(^J>rG<1;p(SkE-{tFmRMKaFQ>Ifep^ufKU|j zxy#Fo3$N{oi>ayY?~gBVU$GUvmd%^B;)U?$Cz-3YE^=#g==y!9j5(EJ>IQS?WPtTL zx+G~2MqRsCOa`25#*wJE8jBM!VlcMpJkKM_>JY|}sC}!e?G6hgm681~2}Y6(!Riak zJPZfs<}&>SZCc!Vsw6t*jgOo=edpBlLyK7ypI1f=ooWxC`3=;ztNR{oS8X{*THg3& z-p(y&oH{IGfJ${QZs{}T74rKkBcK}kv-7w)T7SSG8+Hvv^2M`H$G$_9+HV}DG<^BW zE(O?tB4+1_A7&7!C9{{LSaD<*sy_gFp5%s1XpM8seE+wQw@F|wn2KuG$f&U$Y7om^ z%Mb&=#tqn(c_7ESQn?bUe-ru@fId&z5%7$W|Hdt$!tPpCh*@K)TEmnk z;06O>$1oV=yI+`b79f#)-pOdC!#nci7AK-h0L8qpb z?NVr21vzP5#mR_q*$KglPW z?8CEEQg^xqKY=m+;1d?}?T!!w`h|`m%2}Rks32PF(H$kvCSiKhHyH=#IWsgyOpF#1 z`WIjs?RwDMWe2L}uYZb@^4E(<=ccNl(q%ZWsbwOTvo!Cp=RsCV2|!*tT0HK&OwPZ| z)?Srtt>5aYINC;>9O4}l-m$l8#G*6bF{`?N2nop=usI54b9-!8v7&dvc6dGcV>Ad1Bp4{Y16(zDGyW{b?+#7Dw-$=d&Od zkXz$2_;u@p_$7o>Re*5^^HNXgm%CPSE9N4$pQZSJ#s!)mEnfCA*W)1#QoL`T1finL5aHO4bLg> zDaUEfXREKb_h){fjUldnv%#uzFxSSYk}?w&-1UDyps!69Y}S4U6{%wjA4kBsMU$qp z({hwAK`JSS%_rM8AB3P}$&_HKnR{;Rga66z!8M-$1-z0)SO)lqQGj zFD4iVnPVjx@Y{tM0dyF2cv=A7Wah3{uZzW5+tf0S%*!0j_z@PnRs69v-!_9xU3hGF z{8u3JL#OCdELy9fIxCkF{Tm9G6929FeZRAq7V{&-6hjRorY&QpMX6&9tEs|wU7i*y zlY54~UjI?CektlY3uO^r$X}^0DG8qtjEePOmAZ^7@bWj}N`0hSenmh~e>QVa!6vRJ z?{_t}*VMU|^P@uloyPRr+)G!~q~s(HX3sr_@(mpwgOg$fw2KHc>{sG0*5G@0xuMRn z?&{Rgxpkl`VySE(<3KLLR=nZVnk;WPBFVrVX>g%xsXQZWyo(1}O3pZ%D!M~a+MJ$o z!Y+yXBm5BMrA6G?AtYc?V3|*;jZI8lByOmM;$|FXRcN`4R|jk{&(OS>Yg5`FT5vc^ zG-!P)^T$@NZm74u-HuqAZ%(tGV4oxqTf(JEe%FeXy-qc3hDMDo7w}SXb^29dQMJ;}uQh!*C*|q5nw(xw2ieEZgMflu0&$}%i{nun( z!PQo3StV<3A$79?rjbR-Mq{(^*wJX*0>)ZzRnDsPN&~=RmD-05X>xIIEY|3#NP|rW zcXUY#&i>gA@1x$*uM&lsNrrU-C@iB1kG>38Y&F^vm|2%muaS*sZ8%W9mk`=~a)e$H zKq8f9f1gV02hPx!#TrG$qZZ$yMA_eF6KAl-se5(EEyuJ|#Qwc?auhefgZ8}lWGO*& z_$5asGXU^ZHD{A55H4Wq2spVJp%3MKemZ-&2v!SvfXoZXjxlp7GmkS94KEM5ag|?0xgAV|K!sCD8lN-kyfBC0i7&QFRZ~_G3 zk0~$p+C6d=&ppv>Fmk~+Qp=gv76Cqy%IXZDG%_WUB~(BV662ZAp0mql_SraP17 z>5%BITGT)P%MX25{~>5Mul>gRk1`IPLaPY|ks_}FhTmKn0uqJ-<%GXu9uM*B*CWb* zwq0&Om=^YbVtfc|#u|T;d)YXmWg?M#LX1K<7!gVc>?+hnl~-0$+nnOiI+iTdHnsJ+ zOSL?~Cqb01RJq?y3<3|3BjF^rrtkYz?#UK+>XWMaPM6l!ou=vA*+x_p*YagqixFoW%)b@L}Yl4)({*oX(oVo5<(Atbo&Mq^npp- zC}KX@XQH8wsmTC)*_8fumWG?&fL};%G%&r^$VB;iEx$NUG1E|TjFEN^#bhO2g~uQ}Sn+)|lc36pEo z(Jdyh0Hc&z4Gr?QFy(+!F<|!wr3ax@ZnshWjGNpLXP6{%_qC1QAoodRAf2K@Cw4aI zk_T%Krk$y{z*3aM_>Ai{F(Wm<=oOL*7P+uf2na#VO46y_lloq%g353-b-cXW%34q$$XPVMa#(qvvw&z0~ zpy@YMd8E7o!$9RS*01dHNp4HFg6z4e{szcY0_q9wHqEy?;Q)BLu{WGvaTRx@XKBz7 zMj7#d8*J?nY@H|Gqe&v+cT_J{(BSG>m83yPxv}lsDwPt>X=V7mc{M~M`h6{=t}wNK z_SN;3iO3220A$C4(YTW^d&zN{wLi4L+ICVb*{N8%>pOoW4JNBxr$v7LIfqSTfXMW1 z0SYMBmOsGdp%6fOu(osKx3b|47%${1uzt~%d7HWS8>2a@pe>B9y8RAv2UgufJ zDwl*`d1bBopn)@@ETZpR$5Lb2l|ZO-{K;s`uAu^pIhjQ(V|g)d&M^|lNm7dih1~YG ztzl_jj@l!8>FZxwaUN|I=9zG|j@S}q(8=pPAOT-bvzDdn$(L3sI({ru*AHj_!J5?rR+0zz^Ad~EA9@t6NB-tL~U2o}Xlu>Nc& ze7^1s();exGV8uV`dZ{|+9rKMRzQwxocpi^T~#3v`niJ?B^td(UaB_#$oyx^XOYp5 zPJM@lzSt2uR8f%Z{QSq&=?L5+$5~AQ9lK<;Ns(*Rm|?6Ks15Fg{)D`7ypu>Q4j*t# z1BT4D0-C-1%(g;2Lg(ZyzF-|9-O6dmz#oRdZ)2ci#=zVb7F)V3y}l)_3*G+SuD3Aq zr9PIJ?4@AM2;a@WCOMny3(<$qyZm;!F)npQ^nMTPiV(NEfRKw1NbJHDt1>77xPTD@ z|C)D<`+92RF@2 zW`_{5ZTE1ORlMB7N$`78B&Owd=3gcN|1EG6(ENF+DbfZZN{P?}Lv0Q%0zqVgisJu5 zEc}_8(183mIn=WXf|Rnl3<3v`v0Y$52-f9pA4P()(prJ<8uO!;SqBmHQWg;xj|>0T zW(U#i;#A^4fm@a^F2Ch1Om}o0-EgY z{>QaeK(S6Pv9w5VM2vU;)fVm^!w$Z7UZxhkv7zeSq_PjZ^;V4h}OLOI+fVyZwftS)hlm(mHzv0TGfIw(+K0M+Q{`3lTFdE z(7PnaagK2yp`!-+RmZ#xD+g_;JSmf^?pL3 zSLncQc{jViNB@Mu0fT#E7*3(DT+IUj)Eu}95=R87lG+Aj^rQXOqhGQ>2eM+#FzFQZ<-Mg=Uj%n2reBP|#tt?0q*lXr}F#)=JZjSq#HDJ~fOGulmd z#nu!C9b@Jh2fZtxgE!XepOP%2WV|Tt*|B05!W=aU>HVw2X|ysOST%5|gg44jXCK!~ zoAPP#`DoKvH+=K4^Bvn9-V%5VJjBo||AI@GpC}6Z*F>Eobg|ZzC>{{JN0~0Bka-i> zHK)TWTb9MJVUWsUHVA3GeM7#uNSau-p#&` zr4(!#`RrM>dk`EkJAch-QMR2iZHsk&VL!#-_*xG?(O`9aQK0g&RX>4JKU$M;D*jK~ zVipT4vKQ}DH9e}LuLh8EIT2!3R-Y5ad`8Y~)*u2b1IMiTTIy9UOwob{gZ&NDY#(Fg zq2t#B@Ty(P-?=E4O&n>;jS{ED&RgMiMG>k(0$1)l5sQ;ginXMrI9u9}wg~seoNGTt z+_|AYElQWSP9q`u=ZZC{-zI`5Y_rpQy0B7+S4lHh9`G*!ngS4CHD4y2uJdFn?bDki z7a#(M&9Wtu{pY#XqBYSfSGt994yjbAP53OHF5aeiXc!AG_ARhOv{gxr!CU%0H4nR< zuWCOyCL@&_cs_NwlDGw{nH7y?3@ZXl3X3#~8*3bkIvvYRoCBOJ$#v%o_X*EU*iql9Zr73sdq(q!LS*1tv~GFaaY^QDO$g1cZwG1I6$V5OzxVoxW0Ffo1yF zeF$+?ga>xI=ReC&h%nj^vQ1CKVD%nfi+P*V@$2@#BRRiem@Ed&x1X3Q#`|9pb0T6) z$Zwh{*}}OlH2q{r=BMqjS~dx)HX`Yu(<6OPHc>hZq5Z^|7JNtNJ^V*G5wpLE7+Vvt zwgA^RO^W;^Ot_;GZ)N4;NOyiTy1&7nA_Pjk1^(*BZoK@rsl%AP7BEup0Rsbyui$<1 zaQ!*V>ir5~6ZLmMFjleP2fmLQN3(1qv&_LM^P|b8thCb>(&X7HwGk=M(@u(*tR)G! zmKm38s-tu{0R5(Y)v{w<-0R^1%ELn3U_j?mdYm{>oY?MqCZ4@>ZJFAWPMlsc&RjaaG zLCtU2|Gh#kGL2ItO~7DNOzS}jQW)q!u~KqOz`&YoSwS_?pfV3DVE*$^3IP7kLy7D^ z*TGZXOu$e9SwEwEWJUz#;-jA#Onzql`m9Q}p^dv8lA}sI2 z(moLkbJvJ*J`7ZHw{Fx8S4z@4+%7#VEw!%F)Pp$%2-6i(7_*|07le&@LnHPNslOt> zuTh<%3fX?^A($N#HIKKls|ikH;K4-VMugoFQ}^4}l|`oLVD}9V;V&CYRJ6z!L21r@ z^!0uvHsaOk+ZARAVqre z3iBEO{LaheLR+S`>y+2GK28l{{{;RISML~JY0zzJcgMD!bZpzUjgDu)_ZYtB)l#$D>(_=wmJAqFUQ<|xL&#UgtF00fuD-kR5aBt!XK8$}AO?mJ+VSBuwGm!R~h0p@F zrDsN5aO2?&S_e9)*ox>3@Kn~7XCowg8b(kEKF73?-!%!ADa34^#q{Uc?7t+` zgmcAd#!ZKF#a%~leTQy&mI0{&ffP@IwHEp}Y5`?Xw!5?}Nm3e&PAeo+>HPCfWJ-ZZF7<$t*9bD4vMT&_ZxaN+&f0 z+1-b?T-#Sg9mrxWo(yNLNa7-{N3JeJa(N067(KS3APj%Hn(?9l-xhQ62i!JW z`|Ac=E$X_diVWm0$@dZNm9Hasvn<0%K4qL+w9TarC-;feYa5cJT}0m{JMzMLG#!-K z?(K*smqxgHO<|HF3GYpKikYjkgCWt^z~Z6`<#b^`>H7)`dPX<^$y*!BV>WH=&n!58 z$i|4`My$&hSk;Q%>>dOjQI5WoZ`c5)8$%$2)t;Xg!{)HY9-J@}0h)`RE0_?pE6rxZ z?DdULh$k-Z%l`@@K;DZYnfO`OHlP&!1`wJQ9y2h^6c`l{NC5H%3$rsYD4SQNyb9cI z?4KZDoP4Yxc*HUs2mTB<$PDs>Ae8orSKn_IVCTsDqr{+ zR;Xz-kH!0)Zm)7GiB^xW=B^=E#F&QYK|$7UL}#giCNyDf4K}Zy7YNsf5s#^RS9xfW z-u07~IXD=6gQ=O+j$%dy1@`^2hdHpFd?iIPWjb>Gmr*af#Dh)vto;dAiynBM9&nnsUN9^QP>Z7SpsS-(E0g(9GJtH`qox zpuhQfHlHB4jBen%f>G!V(AlnREWn>jpToLD>(BqZaJV?$MW8)75U^2KHDhUOQ5^U`b^!(3C4gD1tR`PR#>w*3^68feM1Tv+<3=A!WRt*FeFs`T| zbqfw!hha~}pa6^o8&?a`*9gfFZx(zx3$t|}zTl(`%^4Y*kHM1!yeOg$1d(qilHYsvY(=mqKH1n<(s} z#)5t5v0z|R)_##70IB3zFKiYAe5QA`HH>H{fn@PF4=+Mammy)$O;_a*QBm&tSjY7~ zv_n`t;VE(bjVA8tinkL3iH*JlG!DVyLqSPpfDiXSE_OBF^ zM$`9KnHZQPzvb;HWuA(+`0j$jyN~9CrTG-6Mak`4rIjYr{F-iArw9D>2sam+fj zW>}?hm9zjAY>f+?t`jddAf2V&L{ozsQzwh&gc_FS)B1$okGCL}9(h@w!xj^iDP`20 zq#^O*zNpgaBtqZY7TaTS709mynDkvP?~m(YhW@8Nt1$H_cEI7wVZK9$xLGAAP#c~} z_SHT7?|Y0S7~4E0V}{!KKkvEGD5MjFP_=zHJ!2$dJe}N25Zm2QfSOn3px>ma91&hZ z!0US9pglo_R75b^&HX%)X`zPAU!&H$F@C~@q~gRk7Jhz)-2u9D*@Hqrq=g7f*kf?> zre2sBU_4JznJ@LNJ40*|vc3g+&H_VMoWPE)J!01w$&=OrSG^?QroabwYkpLAOMcwa zR={!czGK!H33f95_|A}Q?dP!|Lj5w3N=P;m^dyDEM#P)R^wj!|5ote(_j4K`1E5ed zv$*W*KNaf+C}mawlqLmW4n_zlQkbz_phxj>S!b3S5g)0s>7^xT#3d+N2?It!5YQ)} zyqpJiKt|pqeKO)g-Mm{N_yU6~UAOsA2u&%R=f|n5eD=O>$k~Da{&@TZ|G_x`1I-|* z1omS!e;_fYS&%5k-Q7^rF%im`wf+qY%(xMutei(Cp-FMM3mc0Z>CXiWIKxBu>Gi2n zPb$FgOrvwx@z}|$+||S;_Ri^hxjS1l#je?-d{*FQA+@4YWd%XooTM);(NiQDtCAm* zjb|si`$+2{&?QX;!R**gD4JkeG^%r~5>>$>5KN@&r9Cv1u0d$LrSi8|!+CKQ^1?1B z#bkgr24$gf=XgZB-aZ04i3XfmivQfb(dWK99Y${D2CRxWA$o>xgSA+EE(P4%Rs$5; zWV0-#cilg}3x=m_Grq*)?x#3@^HDS@aH7Q{ui9jVjZX+7-TVtnrXEPxVx19kA>}p8 zb~KUS3{&LYI`nQF9J%VDD?$a0Ih4d;n0e(Y*65>Ik)tz>;V985UxWmNIU}rY3}!YX z0<@j#oKN}h!Et}&%euFXQ&>)MkJ;*Eh1P{t@74&6f`9tG%P^S`9}sV?`dt20>P*@} zdSHXSzg$db+3cozoq@N8x6Ll5hPN5%nQNc1Tl)1uaN(drGbjuGtCMsD`mdZ-;*|eX zFCI%UjQ@0!3;YP)9WEDoCc4N>ds zit#>SjM8OT&>LcNsvVzh^%}t(Iocf zj@;Xe21~&3(P1&`D}U>+-&p4QC;KLJB!e@5z;L^`P+}`0;Xa)t!($Zu!kg~coA(9~ zytR7$4vFow&BObR34-pt%d!v*^Zp9p5{Z{61_;B$w0t-D=ect1rLn8(Mo|~l!ctKk z_AL#bK#RF}YnYcLGcH&fqq^T~VALhbrn9XKGYEq(jY}Vu>NL47Il8UgqBG>m^@*M5 z%*+b#13jOj#b-faJI>h}`hzFxDmC#*HDVjOVdlfIo$aay(g^uWlee(U!!w69OgA&eco}d&)xDfaBcUzcBoBhSO3#H3Mjljo$Z)x&DDNgguxXNqK<{i(k?UNtP z>I=ws#ZG#cdBK=E(|AZ_QrV_)RAl;~sPb5FZPlRx3A5!^YrtV_fhsABfx?uU3Wxv% zkPoU=r_RU{!#9n_?fBabM6hbwsV#BS9teD(KIkUMvfMeJI#zK27Pl1#&X+0 z(tIRy7DLy}RY8J-w3dsaF+p$$ztxb#5oX4$?auDk`Y!|m5#(H~HyP$Rgn|!LKPMgh z5GQ^itg3Sa^r+L|X4b~2#g11WorJ!20Nxy-J74H2BCf|DzJCO+ao&f!TMg&53q-FZHXIIENco>ILlNm{DWz1zhvpjzQI!BW%I?JZe{++EgB^}UrPIaEi& zW5`WNs*}XugD_Nc=J&_bd>{VGYNQ7zf(8i#8|f1=LwsSp)4;f9-WLd`{xR!tGWIJa zRZRkhOgK&Kz9XY2ZtDYsUnrd*{UFVDeO(||1*)rlW>ACuv==gYw)#8$z|dQ0_|0y! z`vw22=b%OXs=7?Mbp$c_9hIW)1cC>!#@8aa48YgSmGnm;*FMSP{|@>3Q)TG-bR~^P z($5%~PT*=9%+zq7k+rr3;Q4yH{x#ia!mi`u5}r)v_GuHhfx1#hsX9c>id|K19Fb4I zrBh)QzORy^hII^v{uu8)GS`a{Y27^$0c)cc!PeY7RbN6l9LsLGmh76nH?RgsitcYe z(R6vN`c5&rVjZ|e9jQWVk+GdPVpO)-h#ujYAoQ5JUDk{m)`Dp>HIIYZu}Cc}W^Gej z_`%DSas3^rkJ#u)MBiZ2$zTg7(W<7Zte>5op;xU=JMw59mASgZO+dkv6($7dIK%XU z0>+Rg3L?~8BeldGfccbJi6aHDeaees7&IudMAs234hLuv;F<{BoTo8ww)EMbivHmNZgJfV*Ws<9N=?3GA=iQ%I7jJyN@1KwT?gTrDUynq_HAmkM7Nldz z#8@rc@V;g|h1CUw9*}*s6pDn`!ebGPwP;cSEQsNL*%PK8U5}{XCKCfb)Iah_(r??E|EF1Aq1&yRI6)Y{mkx6yPL(VLzrUzY@sbbO<4^1 zo77$%#IGYn5meEdJm~!4OAE1r;uFNAD4Uwo=oX;JvwU!x33&J2bX@7Ac8258*$}1p zKxjEUYnMIAIaoRz%j7K`rSC+_er#mv?B|hXG&W@u?M316HK>&Gr{y{-NiIYSE2n07 zS_|+Ti63u`SB?aKj(<>z>?_QVncb9YNIZ8~#`h_Y;cIQFq^^%BnTHfgQ${mnuGqtQ zHr*1JEe);W579e^D^dJO@>Stk*l) zJyG8jKgLU+V!<646!PfDt@mw1UCYka*~@% zcMW~dJO-JX2y(ik!ni+Uj)Fc@z`EDnH|wqq8TCbkfDJmlXCb zdmJbE<}HCW7jWYZ+(c{F|NN*8$d_=-wqbm`(diU;z{MBq|28$I&ilG(nLXk~#)UsS zTdE60n@?-13(P}aAZzdtC7Fh3+XSS!@diGDcBAue6e|dEFYWNr^IxR7`0NO8im_3w z#9NB*{5AV47A0dv*(5nVH3CVlmG&htFrssPHpGnAPzS zQH+&xuf&}Iy?Xa}5~p%6lHG}~R*_!osakgUN}|ip<42WM*$E(2Vgg0 z9B;wXkE&JggJuxbuF=1KAGwB(T%qIfYb4nnpFN|pdgTQQe>ersAmoJIXzVv2@``y~ zQPjBf!U!%rh+!0khMX?Ir3#v(8=zkAvj$N`NE+%x4#_`fDbMD_qpx(rZ}Acc6}ks;McE<2Pz&a4p+F>;OT!1OARJ*42i+-`3i z@O~^XYKSC39&^{N*i8w+_C5?=pL=cS$%%EUNMK=UqFm8d%B+r;p}ShBoORc zehbaJ)$J-p+=&8Vp(6IsEre-^$(KLR&`-49xTrks>jwf2u(7r5+VH6eCsUwMx}gYm zgjZihNPliSRuW^Iq>uOEaaM@v__ z)NTE3H*>bwUy^580J-WELsIVqZjhIKK zoxdb#@*cM0kioHi^eW$L#sXC-(YTy0!&PuSyXrF)H>+qP z;UPq8p=02p@K)mtdE{GBa))GEjuW(yX8v)g=vu)pI_0YG4Gr|&?F?iYeA=G%g;D}s zb!@7a_7D`A-f)RQE|)GrhjEH7c5gl!?;<}N^;eRvp0^u%ickN7YrSujnz)Bnq6r$8 z5Xnk|kJ>HenM^pJ5S6zJxXTYYD!Tx`8pLe(^%vdl5H5WXsU}ydVktQ_B??M7lp~ZB z)T4Cvgb_;u-6!P#?EiJu?WunMY_e{s6hG#lIsT{hM@*pxfM5VX>LtpG8h!i`#5aCf zSYC!$n^W}hQxP=X&9)J%sn=f&cd`leCv9J@U0=zjE*1AHNODd0evkNsB;~CTM-&K_(rLV$p4jR@2@f zXyGOSis=}NFCi>ailb0Bs;Z}?Y%2be!Mkx5@P`rd>}mznb&^v4)8^`#7cZC)Bx}bU zzB_V3s|k%!F9inkz}UA~ii1fRpHU;1 zR2T`DchpbD@VFZQpJG%uD!lUSS28qe+h1YBL|b1va_^dh6xT%Ai-0k=HqFH{j@Wzu zxcA3@XmJA6mVOICjM!<1+)xITeT*Un;C4-meY*Lm2$Qhy-qHXtPIPDCP!CsAf8yo}R`o&LGXxno#EwdS*)aRko*QT481!LuKrel*-OS)dqJ#7h0 zoU#D=P2a1HSGSV&i$h&RwKN4S=IivYHkmwIuA{LFE+k1)8l!j(nVave8Eu9y2c1H! z|9vhVc-EZ>xq#miTcnE;i;h^ek2Hr~2{_>xybN*Ih;hiG#a}uxQkx%u5fY9 z&vvv~O+-pmKMYM3X05*xrY#{xGG%%%zl)^s`GcSWt`t=!*?!9|nVI2aSh|gCpp)1R z#K9#!-PyF6$BSeoQE+9aT36CV=n16grcBk?xyFG`QzdktlKy0ZIg&^qpe7n5N>)lW` zW0$@kQ@Kr8J~A{bzQ;wpuNAbT?-d|yRZ$CTC<>gFdqOxJ5^`Hr`xiQosV?!A%tNse zurswHPo*pLP;;}t&Fhwt%FYX+qLG?|8Sc#hk~u_^pEb@(3$Ze1cbP(dFkrHglY8>m z^S_?L0%sM>g8Wp)6uCeUd4Mg73d;A^+U1o~yOU`OQ4xWU{Dw99YBOc1FT_!SRtxBc z;vjGA#+DS<*4ZTIvyGuH%y1xI-%nME`#h)_>G{nb^HUVdzbwXnisFjYW(8=slA}fbqFshmG?|nl0K`&OWpuvDcSW0F z#MoPOw7BBUba1N}rHL71;OqoM;!j^J=ZRaiN6a37UVZUVS@xd# z5PY&El^_k6_JIA&J*rx?+(%{Ye>1M_#ZBtx@qfLH9g%$w5-5*K8CKzsF~0wpov@;h7aX0hIh@#QJ3>4 zpFex#AI{Jf4Cy1WVho4dcfrNPleO3|pWrWRcpTfQnut}lf3cKmYHc=gkIY~gaMgG1 zq0zP+793WDR}}vOYFyC%h^8S~tkuZKgH*?UqVCkNVOula*oHfv!_J9%<>~Z4@kctY zWH~41Dx=UF0rU|D)=fUP@F_41t7z4VrxTES|MCmQ| zWI9Ds{(8+HR&TO!WplnW7=QGbfa`d5pF;ifNC4jt5B50zwADAY1H1nBF82?&TXVVL zPmfxx$KIJ$uF*Y~TIO`*QWHp!)hQ@UWi=*N;c!XxF+eo5V(!zk)7`e0(Ie_+tuzrE{(Pw|`bMVlo zBf$-cMdlAufg$Ufq1K>lRGLdM-P(lclMMH(!+FGE;eVAy)&E--)3pCn7D=WOvjE#~ zyh#g)kqnvc+t{KK`Gbdl+K@ZtK!H>v#Ftr(3hOooFA*Tam@gWT^|g5ZK+qq4D#_mPf`A@lDieH zOs4S6h8WhNEy`V4uH1ns-!CuN!3Bg9o@}t2>fU*a>_BdZ(iRPpMDuj*ZJE5pF53{tGTxmsJ`Ip^3YpT0 zND9OMlO?8QWR~(uA4+yO9m-pkm2jn+i{8tz-yK0~c7Y14U|@>lk8E2w!U4Q#@{hOx z*O^i-6c!;g-kImG-&&zu*3jFaD8*_7FCgbaj=vj#>O9(eIKOaLOvx=LrL`qsLrZHg=h_LSI+rs8@mQlw$ zKoQPY?-5d(jUF&CbUholNe=jeJHU1#W)07vFJ_*#_rTlJc1zuaIA=lUOc2iiNOe50`WG;-#C zVEaFtNB#G0t(3Yj5N$wqWY!?8c|tKi1&bb8V?v-nN^Bl-H-MV@*XMIB@arLXp|;6 zW&N0;s~ejw$n*C5{3do!dCD+UH@@#RsbH#Q+c}eNX$PDdmbOoXuEe;vAH@{LTQ_Cr zbpX1jS&7)ncz}_xW6k+UAF{bD>TvQ3MgI0w;#r>Rr{(zU(HiVkzOA==I!(XUq}$MA z-i^+hnRl*tqD88z7)-41rLgszEOGe?#r$XCar#GcsHSc_(bwXs?s2@IYb^RxCpI-M zOWTzj;&MY2ukgJ|9NVp!pPt-feg-RkDhaXqdany=TQo8f4% zs=M3XvX$+2u<>wC**6@1pLfG^Uy5_R6KXRNRX1_Fv~MfXnx85bbys`w`yfV*+YN6` zhw#YP0xarWS_VU7Yg8WbgWSqfN^I!z7zh5{3*8%Qjuauoz6f<%pf?JY5X7^-RmSRp zh<0Uxe?R}oy}^bz1oSHLB0Las&laK$)`_nWRVNaxoRex`g}WB|vFq|%@i5{fhZ>Td z+;rw;KB(M{7m|smoHizUcIzi`o5-H5;YMz;0zQfl&yQxN!VQuzZ6Kb104lfHK}YHcj=>_{Dh_Wf5=%iA6R&3ACNq3_;1 zJVDGO$rO=Q7_WBcqjp1i1{w}Z%K~#*eOR z-8Sa@&9fyXYGN+(6V&!)Nc1HtIKC}(Pm`BQr^|Z!#A4A78*9zO*CCB=j#0syLNF;c zz)KiKOolAjv52naXP0VS)*a=kL|!htr!<$oAXFJLLR~rSd!)44H9=KsZ2~X0!(Q;j zP$j3BEafD}P)JoFr<$agq}o(amseL-S8R=VFSLAEiTgwS@jv4qX^&gv4hs}>^AWNa|CshN%TXsIU*gQiJIuN)7FPC43ov?~sxhRerNE~**e{3xa zjjY4P$W!g8hMfq`>leNXLkGoA`&w?aHdBzsc7OcY`SJ4|Q*k4(OXv{Fz<7L#SY)`H zGA6`nA0D;U34q-tNl=I<&Be*_WrUMX%x+t9E*Rsf)Qt)O&;|AA7m||OnosUNokYzq z@@Z;C(C5yXuZ$GFWAXW#A7A>mwLt^T~9GSBg6Ju{d;3UqUR597wY}Qn9H_ zRS0J!Gei$sot%RH5?g%Kv>)C&zh_gk*-836k^#}#QuajH;8UsVjL=j??!_DbJ+U4-`vWC>Ytvtm*!|>3Zz1qnhZ>4HDd9(74P(u*(*(+?%xDPks3> zTbqEphqc;<4o2mg zsI17X?)sAZe{Ddu{P$aj{~yCh(Wnh_^drq~LHt)L%6|+1KX+0#U~vD(AU~w4C5J7B z@?~PZ9KoQ6CQg55yde(+X{6IqL{TiR09F1cgkV#+JXRC-Ne^tfV|ls~nhq6EP~-j2 z@Ll;aAFW6c|Bma8D?eKY8$wLE7G59$28Vp zG}IgSuHEFtyg1!#w72TzQhddU+^s^pt8gKEWQoAaUWb>ViIPX5`U-SCp}S+lylo>+ zcZD&xqJpPdIlHSeA<3o|TTmpMmg(bu-QaI}P4;pF*2@&&ZUQJ=DE@SH7+Lq<-QChc zrv_|)aR=3d>ZqZ})w|#ER_HQN7n(bsxlEU2gz^ho(GdNn=WSW=>akJI-q55maEEW@ zo#lXZkq6$4TFrHpl9HSkYSV^5smOu7R-nYI>eG2XE)(V<2CD@kF1z!U`}nKqKim>E z@sNe9t&`f+&LuSRtr%&PeY`MMM1&Fe!0{^VQ_ z+>~;rP?-Mhzg}Z|YqaWc3?)znb@T`I@3mirwOPJzfL8Vm7#LvK9~3<@2qR3^C0wx8 zZcPY4fC)vCVReL_{SrRda-`oG?=E?kNc)cxFIwQvBTT1fAHN?LEScc3!K^JjMIruODdb2mQN_}*B+;zO_#Lk$+%BNp$>m_W#>L;pRzYm4zQkN1UH0Em7*snX< zFXP6h5%K*$A1OcsX_{sm3H-<=xX3BG$v?u0nv~;D7S2`NM|>r*&mgIb0dlA~&c+xL zl3*wfS#xB7zX4gYA>J{|I_|`uDifWK2BKq#61x)!@M#>Np}wSicDukoA3)^M%D2$u z9xmwTGGq0)l+#xi(lbxbk1JbTZ)ewJe7|~O=^=@oD@yIpX8W5(gY>mFcfl5#rP)RR zK?NL>wDwsXn&W!+v}{q4e2BVw*o!R2<*mk?Tl^3YN9JJ`q^KO$92utV7s2#?7@ng} zYV|7rP;h{*gxh%lVUJF)pP1&3aZ;JjCE8;$GA)5u>#WF%QktP*66q{!`BXX?BoJOt zfS0VYRZd$C(gGre2)$scWAxSJDJM!mnjf_3d~(*powSK{IllrSwFF6vU8m6)$qMsa zxl+0M6Mtf_TVFgWx@LFaW}s1XZgDaaRPliGB8jM;_>PeW;i^x}dgJJ9Y;RkbQfD;>-t}W4*g#mO1LSRZpMOx_o6V-LTYp{{RoT^6Ee{n4plmUItUon z*@#{;>j_;#=X9?6D|dK~mk|NK)Up!xjd+>!unnTw4OSLuxpCBEJ+_;9F2T!8twD6d z=xoKiXiE2yI-y0dnBLoREBcRY!QFeI1uB)C2O24ifRkPKp(7Z-zgbXOY1y_wYt6S; zgaBSnC$cH5WqJ8_)Xc8&EZ+tICC&+?(^_@v#yZiB{rh-R>&yl-StPS_Pcemo{Vi(Cgs4i z&*|M8b%UwGpHzU}Z-sWvq9x!T>#16_D;FMolalns#PXMx1 zKv7#|e7KoP*9N(;loVHRs8aeLutLeWV6q_BVf_%*Of&7+tetDx zwH4sk8GY>juF>B=tQLRpZ!7_fg5Qzg2w)_`x$uS_dXvCRUBENRbHcZHe{}Z|zp3Eo z%mEX$`2vmXQFLkrO6*XetFq0$*7VvzQyottiwrO$PeN`YS24-oEQf#7(z9cgv}m!usEnf~U9s;^q)5$+5K z_w#Hjd*?(uf^@IdVY%qLBwm(X_rd!*!BkUQ-HPW=knNw{WgC`N9p0$bhOHI_Tw2&$ z_}IcN?#jrI3SD7E3N`zJRXI5sjZM!m53R#V2-pUF zj{IGh2khTy>z!S2dnla={>~o(u1Ys}ojLyS|2wI%sH0Pg;D>}g`5!nPO-hz682ta~ zzPi+3U9r_rzp{-ijWn9c#uYcru~_VpIWjhX>FiUl%Fd4}>@UjVY|aMXn&nGV#|(C2 zu1Mq+(rB%vfRRg4=u^!C>GVn{tjL4s*)}WY;MVx$C1?*+!<76 z0nL9YBioRXFao?}(-i7ShR99CNN3E;NeIVl1yA6Nr`b)CBZ`MPgqRmR;Rmp?@aa;d z+7(d9(>Y8iii=Rq1Sn9nouullvRB%QFw@6s=@Q_}bbomQuGt5Mz19HKCNt*Cg=G+6 zL-gaqMJeW9jaIl#Qbj(&v`QJYGiH9A#7!D9O*EIS{UxJ`JZVa=>05@$62}kE?Mlr> zDfJd>^41HBFjQR1+0}{6QfbuY;MNnYEJ!TvIA2@Nl>vv6G7N9eNM;Qri4g?>d&On- zBDB-l8H7EU$tGBm6d3@fK%D9d?S81>rGFYSS$C6s#i`?sCXh;OrgvX7m+!Xyq`A*w0BS4Nv8_%&T@~886^w zIUj+sG%Z2G5QD!gXXaJgI_hU?<=t-A)`CRK%%l^~*^u@eBTL(apb!KCMvvJ4Jl ztEG=wl{T;}s1D@oBZ>~WG<-DE`D2+@|W&L&(P6qcOqX6i@O-49i zV_&R$$bx?%ap5MM9QVDI|cOpv9YoyM6>#$^mAl%7MpT#S01kFfrTB~eyU!p;}`*wY}5W{fA5#ES^umo zcyFE8U^6AF$W^(tt^B`h_YSb&@;C@qq6p;7l{}nmSCHgbfa7plJ#x7Yh*wKhh0+!4 z6gg+uqEx$cw!SZMkT6^@!N+F(FArIa@OO>;CtpB&RG-Me5@DnT6nfhwwa~^~+(F5R zEDjedqsK?DPw;01n-dD>=PoiY*(CQZ@r)p~H?9pkN)TF!w%c zS#!YZMskc&e@K~L7CR?BZ|np-%rQK5{?G$e+@P3U9Vq-hq5ZXDSl~1B1Nq6Qljqpw zm;C!@#wAL1UNlZpD=wKv~=(6E3s^od#L7u!$|;FwUJ(x+&=L(8OjHvP)UiN;hb~h1f47L zxgk&3!i#V0tBQq)C8H&o4kQQc#)29I;;#njy(cNPNfo7uOA90O~$@1dVCO;EoTSG@#0%Y3Y&e5$a zm)lPyi^A4vW#zr9jYI6l(Iag9zC${>EooOyxV77*0W~G7DVfk|Gs&r|L@+@5W!>>4 z9>AsF>K*3&O+;%8{q&gkn7y*9aO@P;OojT{ST4dYXn6H)>G7aV7{a&lcB&d3q%>v zfLpo+hM68b4jR7|w*q@v$^+mjOB>O#R(!25PaH;7Lf_donn?Z2jPgvj*yQsYw$&P? z=iee?(Y`&YBUsR_yu_Y%!O@`l8mr1>F70wVcj2u&I|C=D84?G)WkzYA5KL~%Vb_6K zp3w`JW)e9W(VlekbjF}iz65dR&cX{qejsG!dU||~p3DQ3O{YIBav30-YW2f0&fpf@ zV>py)7;gxh`R~E}pMbw&2`Z<(Xqte9Jev`G9uLAY0cvDETz7+Ok~$)#8rLBksmt6G zmIs+am+8G`P-gM^iD)qMl&11NkNI5}P4t3G=5V)mtBevUt-^9>o+GqPKQ41>=5b^* zrY<%omagb#%hMe3%QV2iw%Rfa-wS&o)hfVfV%b{Fo*qiAjBl<1GAqKq z9BNRx0O>NkaCfRj|Hmp<-7ZVoG4graC%n><8|qoTzx_&79R~iFA8fOkGVI&l~oF`Rmrg}8@g*;7x{5TbO-Mb zI;P4do#_1yIU4!$#BIJX)Wh^rlm2uxa`=OX+yLx%zPT^gXXmU|Zo|J6?fe3_F6 z9OXejgQ;@D8v+RVbo+*~v%!u2Ajj(y>k?{?U>9*3Y_`f87{QJsy0Fsu7`%a`^D(gT z$s2fs;62;JxtR|UHg$jl$M(y|i_IV{q>NRTL5|NLg}77j8V{KCAZ4{p8!*NCod$lo zzIp+KbZ>gwM$plHVJ)g z)3Ztj5mj8l+@p0J8Xbr^j@dagCEhF#TK8d^9XE#*3=T!<=Z z7aJ(cxq zgW=A9=2PmGY^Vx?5;uTzO~T7@;ROXdX^O`%1)+ZEm1aq)HtLS?Oy38s0?)F@Bi;Sq z1{LHV85ZIfAp{{%Ing<|(T@s?1pfc1us`dB3Q*Si2_XKFU%h)sHpn3*#*GOHQ?{2` zr5{5N|cCDbJlYZRdP>7bCIO0D>#YA|0B1?=$F258OI5 zz|(u-Jf0xvPl|iYwIkbZ`8n_E8ge%U!2mreTp)giA#ku++v6SmelJ9kvG|33qTfvh zHdRe6mxQfRQ#KeWpG@$pDu(mc4@HP5`_!RGa6ksjh>BUu9wB!5VNDyI(;#KUPv7mW zJX3cw{TQ_3QS)SD%_|Fxn&dvy%Mt&1$clX3HIDIAwK)s+;MNdv1PUYb*;Byif*bZj`k6Vu3Qtv#*!8zTFXPHLo@0ExJN9ED~pq1YWgFDG)Zw>@z8X~b<{1OJ9XQbfC9PJ-Gb)CcQ$~BK=@gxjSZM#M{2RVfA(!2?%iI=?roI|G4@F_PD#X-=?t|TMZi9 zZfx7O?PQWBnKZW1#v#)FB3;fqwH-Au>(&~O$t>M7tNMU#R zmp044?BR=s+m;M6yc_%0jJqVJi?$$po{ViDhi^56E6PqpCu&|stqK7}OETXkuTDQg zy1c+HYs2pLJ=w3F`8>#6a*UAzin#o!lni?jRhly%Vm12!=iz9+7y|0Yt|pyY`z~=Y z+$v(r1DKhF3T%Z^z8C`_JD1h?BvAoNvuV*(m===?_aN#x^lHka)8Sl?`B6aO$gZAi z8lI2qp6evG3JRzXV4ltYcl83rR>Uhb;;@|<^k|vvs_!^7=d-1)K(i^BKWRr9XMu~D zexU}x3LgSEbkdzAvfk5$$xcB6#nm!Ituss8uI-u&1Cdl`&qHTo*z4nazv(HMU~1x; z_!ek$Vc-_uQofY$F$75iBVm_q5u!%6)uV<852)Y!l6NNEZp>Od3gxC1noU{nq&A@! zQ*s5G<(=)K?nl}949{)2P?Fg}wBHt4n3C6i(+vTB&mIslsu~Ll(&?}fAmx*WYv79S z>aQiRZzSr;tELn={pjU9Min0|4wAc^bQC@eA+T+a>C+@b_u!T>3L+(tIT6#AZVz5n zS&_Wc%YsG(%H~kFt51_kEs7`%;?n3m+B67S;3h#=@zupG(iJ9L*?JC~tWy4Y8k<&z z?>hy24f>pY4NROzs2Hj=l1}g)Vm8qUSiX7l2#72`q*|5(67v4lWG5C)WfwGWadHY0 zM1$b+?xsP}-?s^Q$2dwLnZl}}})c-q!cZ?&Mr1p6ca&sk6sTXQ*n}SP_t zqgNd(-2a@{JGFUZwP%$*{*o-;bI`?Pm8R!Omy>J2z9xdxX8tKo2qo|5^dt_ujxZD} z!u4|NlYbU~95R&Ym>^#X0tS~1x6^l3`PH2r(a?cIJBF4u#-^FcEa-X{W4%G-S z40|KC`IGx62o5=c79(tv7|Ar`ue8LUxJ>TG<<`4?|0wgeS&X{yqWZb93H`2w;|Z}a zlb4nU-E6yr72zGW;hl)9{ERT(ZM$qI>`SAF3UkK{AGCRb!KerY?8LdqvJLvmff!T@ z@uXK4Te7=E5Ss_go9a7XGE#?)%rp~7V`aubV%a<^jj#>*La5} zm*ItINs{+zAMyQgRHtFpj#6vJ^DEABC}A*V{|K?uF#MXgTN=ah+;7R7W2`@T``^o6 zoT=$UfA~+IyommDNm2(g*&&;hGa_fjB|uM;ku zkrpb;meJs7uftL;d(&Ww<=EZOsD&%{qrY9uxW9ds{6@f%-;Y!jZ~hyG%l*lrKk=z2 zISW#*OH19Oz7KBl?(@}U<>h6*chw*7ZzP{4wyF_gG%NZOwwdj>&jAS*8up`Lk@U_6 zwem@PN;;Nx15R3Ay5#cb!m@3xhmcWeVddWwwxc?wMd|g01hcn3{nDgWU%ATp^4(V# z%<_ zLrx^8yWsysLbCPBe%Ky`2+>~)Jz9!qQEIY`ZC*Rf6_Eg9J|z?Phu_A=7e81S5K~~b{=}oxuhB^%(%eT*i0l;zq?Hq5V0}C zTEBumSuP#9$Vmj-BNG9$(jg|rU~`VX+dME|3IC0tHy8v`QdFYP&7^(p44~a z+(=nKA2Q10``|%E^ML!h1Js#VNl*wDi13ClI^jpQOQyfCE@vw$8!dfkdBeA4p3b_j ziY?CL3)lb}LbIoCA#P`~teg=Oq(#=h+*Nc^jPa-YHu$@9W8D7PQ!_2n^J*9n8YOsC zbQ+aiQhZslCkL4=D<$f?k(1-f6uS9n{HPkzMF`&t*XK;p!g?_o^vWY11b7FzLN*cH z5}97l+D*uawwOL<#5}QSaX&n}@}ZE`eUDsp%6w7MoTBrG zO9=*C?VQ}+{O}Cq^U7ZJ%VaE@Ik53&w5#S1K0j0;*Y1Fi_I=gnMJOD!-D{TOU7y#= zty)QN>*>HcZGW$*MfO<28*^DT)Tq&2F(|YPd74#p%pu4e{LJ;>ev%PQFvzh!U6zrr zO!AX~aqxJQd4S|Mu&W#Xc`9<9iP88u!tn^)ozLAr?HYN+i`Rd zxC?^!(VRDPwBvTCFDSt#_c%Y=@7|aJK3lH}AaJ($LbqQ<)#L-?+m{M5mMv*Qzt0lNL{SN-ZK6Tx zqU>c1M^tklTk*&Na=nCs1i~hFJ&A zK}n^5_5*sT>>g)2F1m=E3-e?H={&S_Sua-1v`wMBuW5YsKE(Yc$`=XWdt|r(TZYrn zf09L;6=ve<&W1iSn5>TT`kOPHn7b|;4Y2z!a{=)45Klu`Y;6>>0djY+-#T9!6btR= z%5JKoS<3U~i`ZAU{+P?(g#CzNVTwygWXQw>PG=0@ew3238PA_byr%z_#Lq(DNh$CX zB5<7Ho{=C3qA(x0Jc^E`3G}iC*pa0_dUHt*WZL4mYTHphKlaJe5VM8Fp#H?~S^dE; z+;sIrDEkP3#yuZ($3FTKQy$f4Kh-g49J0xn6sD&7~jR`8AKXkP0{Z++&~vVTwt z+mG4p{$JrHIsJna_4#=51ADEFl#|sQ-o}-~%6dtOT~KWyniTD98~D_h(m4KjRg+Ug z`8v2GsU$lRin{L@eo}i>0IQ#Xqe#Ql1oZ3n9UHF~jjJ8aZVEwZ{HzQzTE-IR4qBPk zz)Z1kQ0|cyiM{oaG*PLLU$(}4HO6+*C zyMoD2)^;HhT@gvPXO4n&(&AVe2vt(l{*d0+FoIYX8^|oj(y7lifH#?tw+;0(#e95; z`NhbUW;C_7nK0#OxH-u3-xJeU%0Al7k!p4$)6s`{H_c9>ummOjp|$V`gc`Xj?GNra$dx`_+r(&n??trE{lhD;P#~PcD|KH*u#T0F zh|c&}mp@xQ+vQ<(_2#E7o-+(DPMIQN%>)HTe*7@&UQuG!OFc8R*g`68-d%D^f$wHa zqE!iZ0z?m~M(}VDo^qCR80>(Uj%E-GK`D9~6s=y)0al#6Q8|%b?KADZvzymde0M-x zK|Gg*O`6Jj)PQqd$qxJgRXFc(2scFyV|sTRV7^>j?mnbN>{W?uNl?pU7!${!yRdg{ z0l}-`IT=T4ZBGTogA^~P*WNgQN9B=usw~>3#qxzO?|M2V{L9ju$<{YKVQ_Ky=t17*J9BH z@hEbTL9D`7YMz1POeYuE924!i%3wR-eENbj`oz*Kx85PUMg14x>?}rDUUKK*+&Y>x zc$Wo`QT{^f%(Kc>AOJ|G{v5kuUb~}uFv!Np!+4Wa#K=?LH+2BshV7`IX<1!4LFUXrnb=sb zxT^|+EDwMW8LK%au8qF&(4ko2j?#gcdVsVeiGYK`FIgXP035%9cN36SF;^m&tBCbf!tU{CbpL66L&n+|a^< zkaY*Jfa4a1>0%Z=1jb%+3Q566gKGGW?)fh%Lys%M4u>+BJ; zv)K%r$$PywSiDW*_!dBYJx#r1lmoF`9HE0ib1{@!jR%-C( z0DJE*^XZQmf^j6S@o-gOx3hf|#TTIQcLD-i=bjc&M(KlX4!vwBn-=07n5GpY{MC}?+M?S0+VX9iGi$FEbVF19-2#*{1^ zQ9CV{Xn2bCTXxV^%;YtJ9&R4r_Yv;UO1{KQSH%m{gSFeY+jod9bjBX>xG4TytVja^ zN)S6*E?g^D3>744akrwilThq|PX986lvCSdWN+h4NL zLgZy__=3i!*I74dZ2jh9PcPT#coFn+-tAT^J)V~hE(VofL&DGe}J9SGLnkd!31H6zKcKFvqMrl+AQW&*j zSJU%L}v6&DTkJ!8s`2v zyaNZUZSq=T4;__z{q-5}!`9g6HShLod({tgP=m(8zN?1-p&YYVW{*-v)&8_oc|e(WUEU%5`q^oWxgJ<=MUU5i$YW^G1>NnqHtcp z+=zI#b#R$deXwddjC|&gZq03FM2DZ>3D!`lV%AW<3S&}y0Vm(`oZ-HlC9w#0RmZ2U zM}x}hkEh4x@1N+6lec}y?KBEC{2slNVGRgn6n*mWpN5-|)YQYh6akzeWefbyn$ISc z=7&AFSwvlf<$@?p6SMtQGi!y>f5veHk(4HJ#ne+9RLs394)cnR-cul>8E^P-#69Y#&_5haYy(g#I`EK zDt{yFW7l@I7K*?Av<2WpuH-jc@Ctf5(v$t-5@WFXb}4PyOa@8(-4gd~q^;J(M2Ap@ z%q!9OWNE}~{s;9m!$L0-k?90R*OZ#+Z{JB8%jr}Z0$G-<^WI+#DBq@Msu#i~+r7^1 zv-fCl8g&)UGQ% z#e96QJ~4ur_B&B4DQIpKNpyB_En?8TBkWNYH%xZ`RpGI_muIE(*`dTAPwf(M98AZn z9JIMuzLQ~K3k(9B&CH!?+Y%4T>**Usa>-hQ*~qt%{>3`T#WFJ{8plc~%}P^V6) zXc*g}o1#s_O)b!0!uNJ&wj8gUk1&lkmsqM0NOfg3U9fxDm^=BINY3yvB3dUjqY%FX z|MN7dEsi*t&^W0bx6@w2kjfW;10v;#Bg2}3K_M-c`ho`7;VwoQj62L?XLB9w)ZPl4=?m7xSUHgAYj;yuyEemhAB6KLSwX>L6^VU%}$9i^D6lg@Tfq?IOmIXHcgW9TCA z?=#&f@W3L;#ai6+=ype+?PF^ei50udIEY?<;n(5%1p$0-L+T4IXr%q z==wz)9zLbXVI{myd#foyBzHJ}NAf!m56#mjS}NgS?s?!BhM){&yERrKXi#<|_KGco z&Uq+^#sn(gY@O0HS)`6)eR^#3=#6OCP;=t-M?D~CIN(K~?qQ~17UR!ONA$1R22ZQ8 z?vqKtE~B+SCgLe9lJ<9#w1Q}+F%Q)P^PK<*j*CL&U-=R@d^d_Jl_;D>i_GdE=x5_L zAf8^uHaeqYAdOznJhB|M8kPlC-LaRvu|jUz2?^~TbrP1K%8_bI)m5#?pWbLpBB?<| zOhI*AHC(U`H<&%x|IZaZ66xo^HZ%HD;QTQRnHmoRuHodmp$GvAS#wHGqngh>VPfh% z5S-DdsXrl85%Q-*;#&3sIj_;}cb3dOiKcbmVF7{vt0p}l{VmCFkmj??NrQrL^E&DV9chDKRx&o|b#v_Di8Iq$!-F3#~ZW zY%ceC>>Qwbev4%;I)O!82Us1;n@Vq>HsQjibdHX9>0&;y8Y^q&R@zuq=e@Ingu<7O z7ZLB`PaY|hUX-4wVA-e0>X|?VFK+KXkS^;+yFpE5dQ7o?Jv^6xf884x6pbi?xNYdx zlhL z_p7E}HSr2q4${QTZ&D`n^w;jv9|BF$GSP_MyOLsol&#(Ino?sG_tM|3)ba`n8GDnL zb7F`<23(5SIVIHDHsvqjK2M5@z~KAE=9!^zmywDP=+Tr|caiVQtwT>&h629|grE_h z=*-!P{cawIZ>Bb94nsLBy~<~{9s;V>d~(!x;t!Z}6l!7~MneeN2AuNGTG}V?Sygs?<23H&dh*jR4P&2RG*}UR1Q&d*HOi6FZ&6}$W51q?P0L7QbW3b0 zr@VQW_9^Hw{=DK~O6#b9>fV2cKq-tr9dX-bV2--%ml>_&j*BkDu!yBLbGduQGv)Effk|Bdlc3BsGkOmtc zcR)Sto?IBWaygsSj5+gb!)8Myv73}m)abt)=a`IvNy72dLpuYqvam^ z=bD}FfwJJn|9T0@L@qI@U{K5)EZ83X+MA zE!w4JY0gDv?R1K_Jyod-b4{i>L!kDBzE~~fP;T7EXcAvWY}_0=Z5i}Ih<|n7>dPho z!0kla+oLB)2^1u7T#k=rUixlka=qVf8U{dL!3$by-R^eb6h%B5cP zLk1MyBuPo+G9@h{^huz5hW--VWhF!+&jHr1jWjbb!!(adu0^)2-FICa2_b$1;t@mH zntV0;TJZ5>`$6P|*?~@8q_y40Wq-mGsd>e@?$lj;MY=^HR2Huoul#0V*UcYSyu1(W zlyh6pX$L&*YZzRAaJrL@dzkgEwYch=$@pw^MvsrXpu(L|8b}Ppt%W z0uJCXS}bsH0WV8Pj6%^;YDBRWQvW(!IOUZCNVis;rMA1Y&(Q`U3fT68>eRtW0+Q#z%!(^<(a$>GUOFGSOe!L)og5SVfIOIVmln0_`Bu`#0tic+F7w@-h8AOG+6C0IbX`%C;eyp5fY#&8#IkJ3S-*HGeL^$fWt#q@%Q1!h31QY-{Z?gd zKllo)A3BJ|G0t_U+&GZoH4&z~a)LtU6H3CG6kEltcI1UtesQmIGEC(xbcVB%i+KtP zkfhkWiE-Gm;d}6I7*AB1jO-scP%1JuY}lh#GnV{5xTF7F@YNU9T2>|=z#k4KcNa}) zEPQ|3O{4qTb z3D<-1dkkyzN|nxq6&)&2-ls@I&4yTYoWKg4xXUdMh^ODEj*Og!I}^@g`9fobnWkd( zaR$BQ89aObVrV3$Uw)Y%l5DXo%j*~xz}Q^;p6gXX^gIT2V)N5Ce|I9G<1<3I-0375 zqt;XLGBjo-IJa{HS2;Ea?xEhHwg@Dz|J7GXiv|uyfpc0sm`(UUWO49IhE44r0sGb* zyMr6wLe+m~xA&sZrlkF{-+FzB>JB46Qu~(Dq=XWq5z$%rk7nIGsb?K5GuD@3Hs5#z z|4R8?!T!yUvTP>E#ft7J$mVGl*yP#dxqTa4bo`XF3lEZ2Y__u|+jzBd-4D}wp26|p z`+2G&?m^KTb0=oT*R_P=F6wpg+qUfNCpmx^cEGwZxCCy1d1H&n0akDRoU4(d?k7K} z#sM+ef8@$%xs%>#UjA0r{!cD;o?cb1q)BTvjqQ{u&~45gAee8<#ZW5k71KwoyRs zr051Z=1@(;*+a9TfF+Mq!dy9B7`6nn4ltAjSe#mz_Y=M>#CI=>_V8~dyC0&a67B#+ z6)Td)SZx$;j((0SaN1zSdd%I}qmcyGL>EJvihW-3Ltvgb;hjTU5lc;b-%+*L`C4a1 z==dl8^5H>Ch&OOKYT&&}g%O82(+S|6Xnga?i$}R;XX+8UEy$H+*Q!CK7)zH*Xk;`l z_S-X#FFw4X$0!@XBgX8U5RX>L6+Rwhe~t)b(WI@#X|^HrOI6F6`z=6Bc%ww=V?qCm zK@c>ys)e_V9>$umx6Vr*xHRk+bK=(dr>U9BuIhWmpe>I~xD(%&GKCZa$q|72POJ`Z zN$d-x^sF0-F)H-TMdHJcJHqva6|*PI-E!OFwC5}df#3B)gjiQ_rxc2wyGLCq2es6b z?l-HYP4VJ5#~TG7QZY#?GA=G(jA81bR$;x#gFEgEQCv<@;%-~~N%ufx3ToFzadlLU_Ys!FnEt`F=^MIWyX)`e#uFs~-Qb08T~t@c$n^ z^M9`}GN4jz6O7VCeSbJxnpk#c1Ood=3mb~u@mE|ibYv2-Rf@k8uA!qP!IA}WJ`8BT z_*t&!aCY?D=8{_;}z8^!4g< zD&BUt$D`ixc5rPz_N}AI?7iT5OL0rC3;|FR07RA>i=JKX(Bzx_yC1HKZqGbY3M`VF*j!j!&*xIM`?bO^DLGev6k z1C&v69Iv+mb9G{Hr6vO?!k@j06YhO_1$b7EmB$?M#ta(TN#Bs@frvy*P6f8jC^VS_ zaGU!v`mT__5{7^>`Q1)k&R_Af)84Tky*1;=LG!qP-;?E#DfY-SI{ItF+xl5t*Iz7f z6MBLQIM?1%Zwvr`+*HFxBPMQ37ti?e04K`Gl4>s&PgrsrU=SAew&ep&?1d@}qFd+$ z*(}~QjCk3M5TwjGB`9_OnvUq);ET7Mx$zb{NQ{Pe$Rx}24yt$W`|IJ}2k3gAIrfp` zwA_vS^xEB*_VdObL~$ZpTNr!>FYrAm$h|>`t&clFrz~!+WB6)!bk}?~jYAFu@bR{r zDK_ua!jUI8%_>_q=1`Qi0HowaBdoGBiN#TnG7OmDc1 z$lyfF0PRvZq!Xl5?5xsBtM!iDW9+=^;C?CgVg*4BhiZ9Ub0Jy9kD= zN?OBIr185?i)UkvU38oDi0}N#)ba26(`iLXhszczE=$|o`s)Kc75{D?wO0N5y|^{; z<*{(V)U@iLt+$#Ntgza1(6snSAo7O@*vh>Q>JOoiMAVuyoZ!uAjhphvKFvm#x8e6NegN8L1%WeVm;f- z>0|TdCj)Q>lhzqCHIGiy9~7}P&t**>{>y48m&{okzpqj_(Vt@Nmr=*it=(=k;TJH^Cc06l2$zK%AjnCxd23@E$2hO@K& ziY(96NsTCutV>#X|CWV~Xpi?r%8z_jFNw8%+1`2&ZT;6B{SDU*0fERo z7?$Qs@r@>QvG*8gzJ-eA*lL5nuKPUdAVJXR_QyLEvUqTdb!W7Py%#0p{GrN$3hr>t zN9^%a)CDl#M7ijua^!eo8}_EW^|d4_4?tk0uVt*B8!f3QmcN3t2IKw%7WEm9b7?IH z#Lz@bF_s=Il$y;W%0C1Ce7z+>Cis}GKmRA-gAW%hSFP0J@Gnc0dWAES-|n)yGcHiME}z1( zP}K`vgmFWE{G5~hVuhgyqMYDeSr>B}J-j3EDFGj_@=tfYQmM5#2{uQ`TZ_#O!#~wk z5LsJj+w(P9MI+igPdPH#nJW9Vhi)2Ul3+)aI_(nDRrb-=;(5D)D$QmxR8qXrP&q_E zspRosPg)qGh|m(NpYc*aC#hENhVr9F-C@*B{;uU=$l&@+)C@~|Q2e~7%IS=Bu}tiw zj3*~kglVsbr%Id1@f{>zx-6Byq8v`pA7M3ks0_7kI`mDo&=ul+Civp={Q!C$GVEa+ zycg8)lF=e20-VbEI`Wk}LFv9+E7)uRv-RH^0Ydr3r@T+Iq-I|e*lq5G;KmLxPKF0eb7E9nQ6REe;4DgGR!z;F8wtxRr@#`c&k@Iwv# z-VLGdv@1z!aURknt^P&odSYy~*^#RLa`Dn}6JiUGpW>>4=#jsQ;ymENYA-VFWzBL! zIt_|HA;&Cla#hX;`B$fDXJQ=f!U&+|GwNrBu!mBd8S1MIVoxnytgn(rwG6oElCTDp z{CDYJYYeS(u61R=4@xsr)AKiwY{nO>gr%Q1DB6Plb2VtL_IHLtKDCD0HSTSv*7-N% zpY)P7fwKL5Qi0vCH8{k+)!suV^N&z#6d4qZ1`F&7I4y+nUw~n0ibga>Ct#=%3q^!x zS-Mi5*AYj2V01E7_xbQ@4!N^J4Rg`qy-V^5>3g&Vmj-EUhkj9sB9?g7^y%T1KXT_M zh?#kK!IbOp(+XhvM@aYLtnfHz3i7Ix0xajdTUD^?NbemSdj)^WDP9@R!r=aFPl__R zBjKPHhfOQP?67Ip3Jtl5i3UKZuUAVBY@;Oiu|F0?`pwc~-sP52qY-@}g)NM4Lg8r; z$MyZNd+fNV8E)>wIF$}5GO@?n?&H_y4cd7w4Z^vQ^(rd0egm41eZlY3&ZKjTo!BGz zkHE{JlDV#ovnyv!G%Y?UvVPwRwENb*K~i653+vCByX`M(TSQh(hz$UfNLV!W@b1Vn zjjW%XqbvG&Ip4FUIGuar7E>VD6paw%Dn{FSOR<UvXDU9r{zFdGD2GB zhCE}PtETY*P%e0wf9=e>b;6=BtE{=#mfK3k*>;OS9>PY}%mtp-tOa6e34A6qMs^?! zqT4PC(M2x;yKdFw9B5#)ZNxii{$MZ`?Trdq#&nx;zeQ;do`ahCjDQ@c-va^%ofOE_ z+7FtDh+n%Q>4o*#CptLV z4SV2yd4gl;E*`)$OYAzrJ33{k{0no9_5PHruc6sK5i8UOBiwn9{R6Bj{vW})bR#X< zpU3TWxQMPJgFNCtv}lZhJk1)YT^uuo(*5BT@1Z0z86~JBg~>^N1xX%}$MgohqMc;W z)%AMeif1Bi_tq)j>dN0b-_C2M?Sb#mI){i4ibr;6Uyk&1qltQ_uK>>NzcndVFD^Ub zPS+)tI=WBfm(U7H@`1&XaHT?(#AvVD;*hb|S!dY&i`2!p@Qt{qESyImizwIvWa9r; zeP~C7=)(Z_!{W&QH$V}jR<1z70yNfLXC+WSvS0C5rNupIhC8?B>snaUUDcH%iN60CJD50UZMV?|4vdfad0LkKFxQ+#;jjc95OX?Y zr0n{l9b+vr{{`m8uM7iJ0riB6i4D*8i)!Q8GC)3z_7r;FCI=0+>;ykW?Y}05eyU{# z&egglE*g~*KDHT7$cMk`cfWAid2 zZiR3nL=iIB3fDZx>kcmx>Zn|m360<;kBctGR5jY|p7wk`gSc^nqvBCtfAM7tAzgD* zP~h!wa_G9w;-<8z%QNji9)Eb=0c{u<3ClNNyeeh&IyshRiTS}GYEb*v3-(#dmsPo! z1>Vz_CFJ%%N#{Ckz!pdmgB$2v-L1$bb~qwYFZ>xJ@f4{wr#>OC@MP_7^_gCjK3PRG zqVP<{A>O$5(d@EioWkkL;R|ypyQraVR(BLtGPA62XH82|r#AI^d$PLhW6HdUFav81 zKgi0qNK2=)*7I4&_A-SdOtS@KO;E6+5t#7Jn<*|#J~p=+P=BZO*kTQi3P=F{&77ao z`6_Y=zZ?gT;`hAdB4oP8NWQQGT}Y;_?%t1X?ai$;GAvS;lmdiO1`3Y5?{N(Ey|2x+ z5`v#-c*GK}?6hJ~qbCOP%y_T~&HE(7W8>L378Lg+_X7Y6^|)8`E3Uy$7NxgoAH3@Ao=sq$&k2tI^_gppJ{*fIl%kN@!C%~&Xl^CjTh!r zTbH#KB4#^$U(PQ7vhH*whWdpo+uflB)5uV{I%CZlV85fvq`R@jS#2F-ap{aUrj0do z!Nl9q(K>ee?J`1q5%f8mo6f;rv_3N-#3myno2>;Ef4M&*#WuC^+j^!f=c3N#PZl}% zz^_323TJJ5nNq=UlY=IfXmye>C{%+LmJZE2JZ1cGPRk`!CW>Jp5<0umB?XFu^B6 z(k6cN7*q_NpCHZ2tZd#KBms~X?&dQc_AwDy3K3s4d`a{wW)O3_nMKBpu-F-$2H_Si zrU~R%PCgb;N@M|vMO10;UMT9%Jf*hT<4Q=C0r1kG0m4nI4m%+#jtpWTa2REc;OM)$tff13kjMKqU5j=VtEU_q;Kj8I*9~i$N=wS`PhrD`f zePySt`C4;?k_uJzB&WCav)er=|MMW!0JH_v+YMfu~Mft zpb!9di~AsCrG(G>Lh6mMPD2o+SRtrz+q4Wn^N5Ea?03Gc_mRwBQ2zM;-LHxIB#(2^ zXKXC)JT_uB`2jEQ$83RNEyGTZN@nqO5>em9$Q0dj(UXUcxU-Se9mvS<)sPFqcf`5` z6Vmy$J`v-Ja-*xF6_SxiFg*jvd1{CWfkNrUBC(GVVyxV{tB$xD;t6VJRFZS_?IT+0 zvg21)<-P+?#Z#V5D0mL;hyqa(GY^f_@MM#SbQQEE8%$^K6!M;6Nd=33wVY>Ux^-t` z)nrNEnFuj0;Wz$F-UdP7s3d*SYu10`w=+e-aTUMHt(oJ<)|aemD%kAnB* zy;3aRshn+wQ(gN?M+Xg&jyfyW^2>NI4h)i=8tO?5Kn2e*zWYr(zdAi5xpih$JBCdet5p$~3AeGuv_E>A=s@ zqwDG6?N;;CqjT7H0N>FHSda8!g9qHJ2CiNLY)WpSxGz@bFJ7I{K;$F5Cmw4g5 z{6-(<)?hW#R*RX;*w&=inP9w5xAedXP9tT@7+C94cs$l#`DCfyd|&bKTDseWpX}3k z!Wy;U0oDhhe#4q!h_5x-)N)?bayF{)QX1@|2KDQpRxOo_Fop30ZYKS|Pw6G9o3{sf z_~uBikk9v9biTT_-liEpPtNzz5#8)4bcOFWD$k`Gd(}4ryysXEfaZJ6oD3j2C1yF(nYDmSYCHQ0{BIA`w)m@;Gt#p|R41UP zJ?Z=;owa~fim{p|PIwuT5LQ@HSCWP|!R%n4yhg8L4 z=DCt=oVEl}9ATTWtrV&w>T1a3R4u7Ka4KLpTIKYLT)GFSqZ(-^5^F9(ccZp0p!DB< zXd5N7a~TQO;kI&h3<_h-Kz><&CS6$7@Bo{M*uk;czTEXlrW ze(!ljovjB1o7H?<`^~+mD8$)hYhq=24L=eSAZlpT@i$~mGRp5~5R}8rY92e}B8z;0 zL;sBUTG2G=D-wK;zDREm5A5M_4>T+e%QhHM%M=7g5AC7TV+p7t(1bRK2*$+HU}6qn zRlWb0zDI=$V)PpL0dRofA`+?U2T(GA|6Qd)`xuK;<3M0_sO?imlF5k3v7?R;=tO@F z|GV>_Rod`b!?ffF3R4#v$t%P=^=|q(EnFWiF&HK?k^Xd$b-C8{@%I_I+q8m}|2jW~ zPJS%&mtNIpqG2JJ-gT5!_fius>^5?Lw04898$Ox(l^vuW-hAu^0Nd|Tu0}|~$Q#=Z zL+b1P>b7v3dvS%cR)!^u;f3;sh`G3Pa{Gi|7HK6PxS~_a-W93p`H)NpW4QXdum!ou zv`kyH!`;^H;Z$eWcn@U6fdqK*deL%?M8FW*4`gvv14QVa8~ta4ILUb9GQ4yp+UDt8 zsbn;r>#6&sZ&NsK$G0d<0YK zSCM9|-zOWgFt;fkv>wgN{J+^ZrS@J05-9MDHSlU@Tt?}4cV}q)_8#*~($Fz+icw?+ zeNvW!?~9a|ah~+SR6=9aC_tb0D5tzjId{{oA3EITT%0*MHoms1!KK`2NRDTyWiXX) zR*Z!K7SVLx0@R9qU)rxf0(o*&M5xB;r5GF}?9U@DSutC}kbLa4hVlXp?&6!oR$y1o zpN9NOKTt&x3ypOS4{$DsOX|3nmekMh76-hKRe25#aY&6K8^o|tl@1f#?o`*=FP zuOySdR?iXRV8Yi-V9YD65XF`FpmuBfLh+xI+KN0rWixOe-G=z-6VJcV?ZvR4iT-6| zjg-o~3k9D_asmYd=v3ELU6sIm*XV*b?RG}sD3D+4Lyr4YL_yQa=}ZJG7L~g+MbS_g z*%2s|!k-{Fo2u}<0+<3!g>@D9OEIz87iAxdfOeGADJlBl#GyAmNPdMODd$}*LuP0CM2Dnz10 zN+GRMqD9J5O8fRd*X42j-^a&&=R4myb7tnu`tF_k`q38e(5NMSt1;okJ5?X;*WVP* z_IO~rw)5jv-zGr;56b~;!zEth{hs_kQU=e6>+Py|A9g6sGkY++we(g=`J#-H!#fhA zB!`Z>KkH3=ag8P^was$IKz3QPY8MUUrpM(aBO;Z5 zHP-k@bQ{g->rKn_zHrU!&k@n|jW<7Cb2k<*Gs>=V9{hRhwB3GOYvxJG6Safop@}J7 zhU_b@`s#Z=`_%kT1}4~#|GTv1{0bGFXQn(grgfggEuMmo-BMOJL!)^!$~>+`CI0m( zI(K)eM{jTQ!>k{-UuL?mD#{XL-hQJ}Z=fX0cOY#L{%52y@{aHLdn^CbiJz9?vyVOx zkcgYNFXp{r?7HYHywl6f**2HDV=zwZ8zjz!LyiOa!_mH z0eg2lm3OH1z=-Xd!;t~5i~XYYJEkpPQ2y}JKy$$5b3A^z&wW?v+`6buyIVHgG}0hB zkHK(hT>JXX{qT2-ZrtZ7Q|S9$(-pI}3`*FHgGqxHjfB5@(xru`0B2ByU z54Gp6I3BH2-XN*EPm?S9U3yLQftnbmxk2?s|K@_6!j|->FY4PCov1%Q^h7N0ae&y< z>;TI zMZ>2qw&d|!g&Oux3g0t--`}6!(t>OYjKlB^%>8pSJf>+neT`)f%#Hk$av@FUvUt z%S;E28jBved198_4}9b=rVKxym-kiC;wAT$e~O_d-=u}lwCP(}h>SS7HZCZ0@HPL| zV~)@Ml~iaZ*H+|bt?L-l)^}}h;_lOd2Ny(1-f5usqI<6t`d=!FYl-t|xV><$>id+p zTAV`zk7Kqk7@Tq+U(XL_#f?GE?~0sTn$uUJI$^F{&V8k=suf<-xtM{xo!{@3`N1-d z9Yfw1h}TH$#wCddVVvqUX>{ZDE3T_%dh~G6=yE3)%1ob@Fipi0yAdyw9+d5Kz({$M zYUP)R@9>iP9n!M9!rJ))3Lf4G9+bR0^sV(5_x89mngfyTtL0L~hC}4sGEZtB5aw#N zt5wYs)b-=&kY}tkcTL+Tv+KR9L$Fm!8L!07e=~6f+X0hGW+n6ZzM?wsgLV&P=ihKy zQTx2o`(Q{zkzE0A%dI3^iSx~MTRCnP_84xDZ`iyx@5i1y)ro`0*C+107k2Aa)KEB6 zcVu1ok+h(8*DuG+r1UoL%==-s=8eFqcR!Vy-`u~{s{ij(%hyWftZ!(%eXf1mqhlh6p2(`AI6vRC(1Pr5 zJPegADR1BZE`~%LPk1Szl&Jmex4|-vFrKJpZawRUt8SfPmW~M@*LiE-m{DkT$E#eR zuxIVL)D)XVYgeCG*=-rWr?w(Jmg|@e@0}JMrKRxLOZha`xgb1DYd@c;fB?UZ3qpOv zHUx!6l1GH(EnP(%NM^dWb@mMx|M9V+e*b-yvcfzK#OkN*T3$Jf_!tnar98`)}cejuWJAP zfEPkMc1e>@DCK9uP0bwqib7u)t1d)VA5&j%q8ltzU$^wWUQIuLPo%$kigNwYu5~N? z7kzWQsX?>kpWEazgWo4fUV|3fdeLZ_dZPT}?|1Z9ofvrH_o7TfmM@C4H1i~ z_qWo84rpym@HPI#>6V)rZa;qpPol%T08gEo?5kgP6?R5F*6L^aKW{sn{X%mv`;qoD z#s&Y27d;yjUj#}Ft*`Eibj%4}nwHW1pjjJ%xUU3fNT}HTT+ay&dLFw%^ewc3C7Yv+2yuk5cX0+Pq~= zj9?W@-tqvNAHI2EMJ#jeyCsRfRc*y?vlV3Pb^Uz<>93-Ub_NJ5-3-;tbrj!P5gw3# zY@rg!=E)~{CwJ7J_Zc8kZby9t9ly4gnN{GB^q~1F*g@PpBrwvvZJ`t z=5X5q@5hpb_gg>gQoQ_W@s&lvj*C8C5RUmw-w-b!<%YV?c}6~4BEpQ1n9de$P-jd( z`rTwZ#(3{x^4FA0Nln|@^c15$OeHQhAYcCesj}NO=VABYiPH)ThOKC<-N=7x zA7A7#s}V%8j{N40X|uNC|^G}P2uoUikCgePBjZzv2!2=`{9+nd*pS|FIzfc^_;ln!uqtqSLHu7I({kR zew*7eLdr|jqkG za??_}_HKE+Cyp&M;mpDGGY;3MpDP^D%ekhl)S2B~y!j)0tn#bU+qYtdbq8P6uKD}J z-0Vdcd$){}w2Mev>wxR===X1ys@!(iW7xamoTGAjZe-QUwS{@H%(l-iGpgvWSIcb8 z{%i}ZySjbI@@$rF3a?@Q+{oVLDUG)xwUY{4FZ9f0q>8Zn%seWxeB7i^0!G2y<~>o>(}|^Grj4RYg%Bc;9DD^ zq%$5ehQ-^9zjIf5e{w>}h9_rA)Yp0z3HTMt-V3|fY#v%kO;bCDJJLFdJHVDyjPT-vvSGN1q)(p4i_QZVa{?o;=eGZ%B@4IZ} z5hZnB*DWtkZELyxR=HsDgW!{*Dd&b%*Q*_Q`(pO`)OyrRH!h7zr@8J~{aG2|eEN@` zx(zfP(2PK0n}6q2rJs?~J#sd4?%C_P^KYIAiFQwEdwOShLAb(BcQHL+Y?_&yH}(s3Fmw`BP)#LmFQuoZ%U&O+u4T#7y? zL}f!0sC@}LD#qhV;93x$E;`D}Vc@grO>uj|^nl?FDQZ$!=fw$DMxQu8qRHSY*gUCG zIY>$jwtYcPWQ=OLErY|a1H)Trn($~ti2xg$E=7yK+9*p!7MG*jFHpZ~25I>~S~?U~ zpAN9(P@*iZM8A;FZJ!S;Ls$q?Sw16#bS33;Yc;dO{UZog6NXeB^LLjN4=! zSb-(aAO9|fmdZnkeOUs43er#jc9T4AgdKJt2Nq(1tI@CmZk}PdS_pZ?;8; z$xlK2YxGe8--Jm95iB!Qs0jL;H$e0Sh%pl^N!bYB^$>F=Zi*eQFT2&JIXpY3)jOQmW+NEQpUM5Pzh}`lW6{ITnfu9V}+oD zvvG4w`tmq14@USZ<-jWVrS)pHZpxi!n!gq7DP6d(*dja3gP`?V`Du3X+HgZ8KuFbfH(;U?HWAyPOk#4e1QJix3>H89IWjDR&zmm03ceiPBuaUaY; zg`^%@!lEPng+y=8TCImV3&WN3kkTRI>lO4px6!V46NN$S;Zb3gU ze~Pypd?Q+hjm?xo>$fIp`>fezQP5ma`9$EIv@g`lC8$ASLudR`5dYhS#T7yF%Ww&_ zc`oFkVhIc8Lv?d;eXQ1-M4VQ$!;gaCn#f%fh@E~cn1M<(q5MR`QI94bfCWV%VI5ox zZPmi(VR_p~!E`IT2$@Tzx|=0m!6bWVt}f&Dz_lQL=1!7(gUK$BEKI@tIaPvN4Tz2b z-soXP;U*=L+o`Q1qlyG|p{bP~V+p*7sSDXEJv|8- z)P*WeJxd~Uud#EZ4X4>fQSdxyI>*YWFgI$Q2kJR0r@|I`0I#i~!Z<3`gR(KJW5I$* zS|7R!w?-BsjcCD8tY`G0SWR14upo*E#u-S)0N~vZS+D@w(8i9Vyf}!GM1=W1A;Ve? zz^e>ikb?Prc77!Llzlq#GK5T&yk)_B=(-_TwC+8L$Qt4EF|}cqz>AO(6vp50lMu`p znt9DSbG0(4Ge0dbI2x_9z#D|bk; z795&dh)K!>!xU{chsrTkCj?#e!W@@k7_cqOuLX_g#Msyj#?yyuLA;K^SiUSQa9M^6 zJ>YUbn5qigMHHUx{4w5a6HFK#bcDjvuULGJ4Gif3Lo6udeCr9aI9XUDd@H^Y7FW}! z7Q%1aF>=~`=uO4lP}_Vw7+bZ1xay)XOYkJWHH4ss9NeH*yDgzrhy0Gob^${-Li&1? zv`hR@m=$mhtZ;_3!1ME=z-j@OK83X;kYKIl5DOs_&$h;u8Ks}Lzq$^6zb%wMHAA`) zV>Z$PF)~94Vn}hgMNQz-&>L%f7NhnVO8Owk#>N9P5o(&xW5>wl;gAil1>ofJd&i)P z1-KmJo%YGk%b-_Qke%8qGt$R+GB(f{+Hx?o_%Wu6QfzPwjwL6@r2cG70?`(N$LZbq z7henQ?7Z;QLAUtq7&*BR<44X%;NNy4hQ-UThASY3+5ff7+m|L{h@%e+!RnngW6(ld z=ml?FN84?2C&sjxme^V->=YP&%qfNKd}oxeh3Iy;AxB8-n513@#n1#JGGoiD{Tt~J z^&Qj`wb`A%KT6g|VK>HF2$Hggf}j0p3=g%(^*Mr{k4Z1=aXpUu-ciY#80}R!XoI7Y z7HWM?Ca1!||8)#%?!|bKrXyIeLVWt`Z&3B>U;)+fwSQuWeFO@-|2?KSI;1d!X7?xU z26N{^mqPWE%-<7a8qp5L7@0%c+H66q6ErF66n68!F>?9`Xi}q7lLL!zDRwFJ(Fs>a zY9mmcp7P-AcXcuYiCM5K_$9SuEBMf`6F9rQ6EvM?0;JIY2QnIC01=yW1kZFsM50Th z8oGZ5!F8n9*0L^ld)YNv=Dn>BC$DDBn{ppGSHgQ0X=Yb+>CN$+q+V<%joJfPl zA(-s~W5r%Y7CL=24``1#2Mrbji(}KYKse*ak^0q-dIEL(;lkalX;+ zi~hqoBb->HoE2hYGoo<++OfFCn6)#~T8hs^=9U~h$bJb-1Ok?_5FvDV31qi+HG#}U zGu&WQp5aFby6E>}4j~l16c*W0w?wUD4hKcydz2^QSuzNeX=36c zqX4Sw;1EH-2!v0565{0po}#NrAahWS5AMv~h{Anw72>-nYMsuBBL@YT2KuZ8BcrrP zo~$oE1H~~o$ptWaN`#r~v%(f*eMT%n8ea3v32QH6N%+_oh}mY7!u0*1rCV7}LMr@l zY5IdC`#GGDKYPd@wSzHV$l^*NksZ(u7W#wI({?Oa1Re2*_M7|W3_nq$J3$S#MqRxK zZXo93gW^LV*CtM!B4kHyo#h{P8RDcu94kt(4*Qeb=dPS|qBEk=MS4<|nt^*6xE2&H zUl7SP4aDcr`Tp)tJ_Qsn$O&}`s2f7kiUXm0)e9vBu^@aVy|s;D@Dx;kgm|_T)%_79 zjTwYHV5*x)Va<9@0fYtP23YpiNeD9lj#t|r3?8>Lo&}4Hx-UH`N96=jI1!Knb*M8+ zAi1U?xH6qt`gKzU&=UTSW}HaS7SlCE|DGL$&U7A3fv6*va}qkg9{ODMNKRg)x(@c9 zmKJULjLg@;-cwc@5oUxoZv_`R3Ssm$%feOJp@^vTX**Rb#@P4J!J;<;XkH z#tGa8;4YwWiw~0Av;-&-$sNG;{?+B_1Z}z&_*Cxne1hviKji*2{{-ak2{5P?RDXUb#LIW4nkoP*Vg<0-q?|TE;ac~yxD$s@C`wN}-9Oa<4AJlwC?nRB{$!y}eFk_uje_`) zK{A25P0)KyJVQEF?amJ*O)VN|6Hh8m?Si%pqhp&P`9smLVdOVL3h+Fb5bAs|HssJJ zo*9GN;KvPtYeD>+Z>$JoTT>H{98FEh{RfLHNH(B}TkEGbw#L6Cx3&vLvl0Z3!@3b0 zoR>PM`@@F3<6va*BA#Sx*$mz@al`J^k;R;YbLll?j4B7CD#H^d$~< zu8Er?9>Z+%Kk=!pX15MOn}gi9!BoE7WK_u3;^IZ!GF$@4P?}4KoK=i$gX{!bP{L)% zpl~JxRoF}f)iGgnH`;C-5Jm>uL3yv!D1eS`$L+C9*YQx<(J=%?>r!%I={_DVjB0hc z$UzB}$3seiD<^{Zcfg$OuJ;7M+yNtWb-)B*V8cZ&%#rX;h#U|y9z;VZ4kk9S1lk@t zj`E`Bolr6RBPIZDS1xhnm;iNG5QBQ)ijF5hc5ZAVgaGW-PU5PMR{3yEL&>{rt?kl87K z=vJ{1Ix0EHg`$&8S{a##!{Sg|@fZvB^ zHE>Czqd_n^?%E4H?;(<>pNd;z4IfBhQ8O1Gl52v0Evb;dKc85zFtXhTh|V_>+1bh^ ziJVhGS!Wxx!T0-cUhL6#GHlj8E=3|`8uDnT__OOzf?$J++o4sB65gbNCENZI@GdNl z4fPy^R!I8;)pq9z*NoBWFX~GN&T(u~n8ki*T6J8L5TPzEI%!Vteqax9PYN?TfE#08 ze3OupS75TOIv8l*OEGYP;3U@E3`phf^hpT4AI=gUwL52k5-)qkB$h@d)W5RWB&0YK zx5n}$Cn0GgTs%lG3*6pCs#pGrNK4P%;) z;v`rF!LI&;nJh$-7+h4adKCgOLE;A?c$*q2+~ov+(l`hS+2Z)*uGdO~AVgsWn#9!t z9XtdbcB3{aNbbPRF)wqhmX{z0b?J`_xm_^B6U2j(>hN z5s81+hF7Nqj;M*xnl}du0&)ii0zwzxN0KTi4uzN)0geV##+22@2(zWbf`MI9r^b}l zXNPC653@uYiQ!Kys~bPLL8Mn6Oo$cTtS1|X3uf8@S=7p^RtM zi4u|^RhkejrcIt>&qP$ODST-HBf=5mMsqO-qz#mwApGenAdn=pf-0`VC7ppMi=u_e#W*%iF$+WJmX6AR7Xxy?x6n%; z6;H?|=U{ap<*-ye4~L8ah`Qn>i~3=VcN5#i#9Zildxx=R0Ux5;izG>c7C7|S8=wyN z0bvso!m(l1vf8QFabsf-LM^G0jMsGs%!j(22d==aI*|^qCXb7-nn%Fsd$g~pjg-$$ zPg~$;`NYj3aivamj!vn2SCIkkKp)U9&8QHG;CK0(^0++QpAtifFI)Mj*zGCjLQ2-@ z6WK};N+k&z%K6c|qa%j0V?P!;^j94-@w)a3o=UneX;&+L_KSo$OJ?>x)%OikugPf< zgAN_aWm>{2S9r|}tDC%p=i4~f*oIow*Ji;ioE4MchdLq?a4zG`!D_*@VY|(Qk* z4;&L;8pV+t5-+AyoK~o)8FT?Zd+CBh$)%Uuy3Q+nOkqn>T_|RXR8jMc=(hJ$AmAw$ zDrkt?K9^O86f2CQ z&yAGYY2@&q&_7h8q$wIT4pJb_Q|^NsA+N?*)x|hvuzWR)y05r3NTdql|$A& ziDnz~QF!rbN_UDheFsNB>fzTG)Ca2rskS!+w-EOEH0xUZygQm3lM8DhBC+*JxANXJ zPQ>LbPkFm_>zlD&{Y-iV+jlx*Uov#1&B;fR3XtGt+K%*iTR%=8$~x*{hM)U%dW-ZJ`Uk(PeB`fHy00w zGcHRSxi(4XRn?X0<8o77bhiokh%91Zi4RM>s|u+A|5}|+Z`)gs&Hd1W{k$lIl)wN| zyR5S!k6ByEYK<<7(yoJKCCu!|L}#(i)v2ROfmMG6s`*B&+DstBm%_o=e7ek0QKk2CvWbbL2Y zG`+|{92d4X**5jD5#Gr!^L{(;2SPioxcm7&xIf9TrNy61J@K?qp;qrErC| zyyyxcYIpvWLXE)O&pRn`^G4{Xt&$}^yJi2UA4A8%p!27OJnpGQuPtLlYT~-1afj)8 z{AosVJLHMg5EC8uAAm2SsY2WIQy!^~YdN}{B;(2$E}N#QjuS)^IGHYK16!F`e1i6~hxl1IJ@78$!@*&;9`rcOn41V+I%{~!uAgPeUS zM6pgrG<(%8pG*5~;%9sqsSq4ml|GFfA48%lL;e%Tnl5(JD)n2kSiAd9lyi@jq-!ll zjX^ETaFwEF=VYLvQWWP$DD@n2vdT5HVm`)9L(i-#_9OL>w^*t2qh?D8U2?uwP>E;J za(R}NTMrO{|0|awG@?aLTMd8x8f&FJ!ZiJH^YShIrQLO&-L`rMzljH+P&A&Dwy`aIwg#*8djf+8rq4nhnipWjDj2;T9i5+ADsrRbyZbR28yv0Qn|5b&um(BUGZql!Th z9SD*zjhyXs$Q`-Ys2a}qw?BPD1G7^1!*1;%h3t5jW(&ZE=H1d=*v#VZ~Yuj&6 z>C#TuH%lw$xia_Kc;M6%qi3_-xJ8(8mhRd2)a0$!2-!QmFQ6V=wM@q-xeDGW|IJ2V z&ucKzFtPC`c;N{szrv|=RKf6ctdTtuXE?gtI_b@}d0MfDm(*8eKuEU;bzX}=_ahvY zU^Z@$TCC{D1+^-kX%VjCMXi|3APZJlFumC3zFZ4+MPKi70{3s&+Zpm?%i9bS_DM-J zwZMCnkk--W!ww`8B_Tw%@BvSWU?QWqE`~@pjGr)>Kfs%TOFpm``qhYh(XCUulBGxb zc`gr|id!z5W&?H^_7tZ@1*oUFtmK>u4orLlzDDjq&yPZF6KT~9omw@Mq!XGf1iT}A zz7{JVs`qHM&*3xw0|d9`t0o7wRi*>gixblX*!Hp`>NRtbw{EsaR*Kasi?VEc9j7j)Q_rF!ZZlPmAZQUzjisk% zk+NRmyRAi&GKTxxDcY!`D^<8sl;XOvDNq3D-3ok(RuREIl^c`QEX8q%LLj@ zXz7>)KuEPL^Ozr6N^`o|$ z$W^(Wo#?n6G^hNWtG}=U=v8;s3vW1|VwvT@r0Jc}m5*xQshtbJj(Jm*KG8y>NU-3Q z&sy=dkk<#*YeNY!`FC*L7j>0P!(wko4%{8OR&vD5n6;=zR;!`#TXvU9-%d)*nxJSamfzTG+a3VFZNe!T{ww0D6Fdq&50y@1U~)%qW-R?9(P z=aNtR4|AwV;%e;{uj0l=qYkb?9JDCMzmhgfjtoX&(}h9p9km!rL{QQj_VmSGc3 zn575HQ;{jmlmi5nVza0JIyP?r-lbugV^$F?EqeWFv{``f%xMgMcaLU|S6x!#pphz1yv3;AOE79Bw0n`hOdf;kR!L4r*% z@kFN~5F?@QqQ9aWv%LL@^If2uyU&OHp_3pYtR)95RRc`e!c+;VTx|;%43UJZ0>0{o zUi*eD!WbC~*o%VC`p~8YN+Fh%*jFxxCJmWZW0!%Qy8V-ep95H>j>f0IJ{qx;{+-41>5MjPBsTAScL-1; zPH?3I9S*?=2BVT@q;<3z`V*3c`8m3ik|y~%Lii2*jI!HgZ{VGH!Y!ZCN2a7KqRTd0 zlG%Y5K}6W)60-5KrY{*a$WVM-f`^9bp59@e-}2fLd+?+i;Ceb~^FM)WXxhZauLA;P zI}Y;S`1PYZ`LK_mH3{Da&&G-(Zz7YmIOMzvPeExS-Hi1hi`XEc87Hunh~gd++8sJS=rb2_vS-=Y9}MtWE)Racf4(aQCSPp+6eUxV^q)ziH1TFq zz1kxPL{s~YWa&?lk8uaa&*kX5>yfEeqcS=jvtT(hf{o17hj5PVBzj~|zjK}c2HbAY zZkHkpmhFq-sN3dsBMr|5w8zlI;Kt|@IK{BU1a&J;4|Jm)DRaj-VQ`!CL=aHK@WdPt zP;rkF+!N3daPcs{+}1kT?vsh;q5X1s_*(!bZ3&JRVe-w>Zgq?KYtOC(t`T}{QgSi0&w8|mzG?SGGrGMqkQ`1w*X|vfIZu)Qv;?u%`TJUU9JBX63E`t1_Ega3KKU}OS zvnFv{h)OHh(KV^rHi6FLH$R$(n2BV#sKp;Mn1^}yk|=ylx8?xnexXx8V`_`EyuQqZ za1wa)-G*8g>fLnGU#eY6u@&QTl+1~uCn`apIBP&2XP5vX9l>`3Q1xjZqT72Uu~_$U zNU@&4>}4?`&pvGnmg`$aA9M-dFpn++I%{S7Zhvw4bGU==Dc{dUxQZ}ugqel!bsh!L zEoe7&(MJ2ln{sYVV)*i6Y6?HuYJaQfL~MJH3ml^ET)a|BRu(q(ioleS0u=N!Q>VIh zE-_EzQVB}rWXjCT+>8aCTPdT+65&D}icTnFF?5E%)?xO7)mVbUrZ-H^mvAzY9;r_F z&(y?d_z8Q>f}Id6=$m;#j}Tm_6qY81$Qs7zt#4X%_3HcX;m54o+QWHOFVo2XEBAlY zHcf;0#r7}Y>;H>?%!&DgREhW4xWE=uv!I#-7comQVOa-MY#7+N@+hky*mCSqyUtzC zXu6HdVSOMx_V1lu$O`WR^ml0sqgJRY9Jfua6g45GKRO-olnsNIkms zPqbO`q+enDrXoT_;`}OoUjTg4h_t3alp8)*>7X=9m7AI+BRjhwncm2>9AN%qT<_l} z#RD+D#RRH37cgB!lESsvbleLZ3gWBTS$D=$kq-O!q{I1WMsPe0!z2f`t}gk%XLmcv^N-Nv{G9OcIrd+#$| zDSvbYPRI<*2T?4iexYq!C{T!~{RP*5j)MRlQ-JDm%JqsMb)+yuh2l@QgL+hjexon+ zlJC7^tM8J?RDMU>{`)q;IfL1~i>*IRW~PZtpOK^jR5Im^bS2ANU;@24ApdNJvj;8Q99a5hrHQ`EjYFRC ztR;Z!JapUB-Fb=!hWw?!RhsaWW_|~EOcW7l+ql9%EVexJL@;&KcoQBcgAd}2Yl~fX z^W@=_Qh^wd1I`n5oo|sSSK?!i6_xJQeaNuib>!=hn)`Da8|yZNg1`If%e50cvy6C_ zVV|y+qpvFHXBg&39xWj3yiO;KqiqhNV3#r}QyEZKlUHD9!fTGH1(#*zD<@)v=LvTQ zXa5b^$blz>24~{&sNV$z0`i5B=ugiFR6p0mAHn>dl9i5(i`L>pGAz~RYXYVCVLRgV z%Lyzc#WM({Mq{_5sW`H!_g9mghsNpy=DgIKf9Z_NTXF8&T%W?hLe7)pNBzzl^5etw zg>fCpSw8Q2S7Q&~^Y+fBkHzuN@7E0>P`wdi9Lc}_mAj#v20OH?24pu|p&O2HK>Vqv zi1XWi1{wz*k%^Qnsb2K~x;bX})j}j9PFhlql{KXZD zX_w84UrGK@)I1eeRtm%G^hNHE^Q=O>m5V<>O`w_W_Y#T$TJ;0#TxwETOOopV8F>7O zOH+!QkZp&72u8YGqn4ZsU2fi2PfIqhA;4N)EvfAL0Nla}HdTVb0F`6wJp78L(N@c& zDubm_i-S^5TW`pU<(#7exC**;S)t9=fD@TiFhwhQ`DE+n?bM*fPERK%6$_YCypFMp zXk=qcOh!ASB;6txTc*d2Oi`&!Pi~b~iNc@=&Cy+2YmGLxo2yViiD+)8mB@@}a+tHP zl3$+m3ern~;UfF63$+O5D`a)hu%Kg03K7UTvK&UBu;|>5Qpy_y?#^~bREj&U+41^D zhAG;RJ6?oF&c2^ny8XdVU zQ_)!@30}d?;ke=fK5{}vC%ttiP-D_uE{cBgfvEAqdf&VzdL1Lcm1ssR2Q&!K~ycB-+J*@an9q-P6ALV zL4&i7X+4ALUUBYpWQzB|wU-Pp!a$oa(uwQZXD2F+&(JvmUcOb>tEFfX`mwGvcBp6g zYuEn9HWRK@lfG+79;)LY&YRjHQ~EkF1V}eWWsjzVBUi1L!TQ9KQ}nfU>2(2aWJxW_WY?fOERD+ zJakUqvO}W+vPG;{3wmGA{gJ)CdZJL5vmQUadZPX_S4yixTlzp(2%8{7Li|aS4B&Gv zw^j;XXqB~pOSI-KMN9KVyO=DuiO9$=jm)7JpgQG|QQ{Kd@%ASA)K<4Qe3ES=f{J>lZb~3hRCUC3Q+g3$tBN=@byEXK0!u2q)?>zAUlN*MQHx!Q+5m6`KD*o z2GgY#vNJ3|wTG=x%czi|zho!%3|`9^a*hsoly6=${4m=0q3l)ye)J9^-;$vV4J%>w za{EW*GVEfESjFVJm>%(s#P3VHJUBl%WgWGRvkW_BoBS#qWf?MZPU7*u{Xdu-qV-gf z_g}AMkoe6e4OC%=z>57k%SW$yU%JIq&argn&j{#-aU?7ilqrpU4FSQ`m-#1Azvx!k3 zGO_xpy7}Mxy*BVJ1owv!H2~ALc+}VT__gaWlKKd-X7XqwuPzqe$I(Gm$PJVE#(^Rs zGq%ZZhWgh8BR5q-0ECbt2c3#i*+v0AdgZNptpf~ZryST(d~eKhzjAuCqN!+kr+|@X zB)%ejCD11$KVEAL3~E`1;BT`VC3>x*!8y-B>O`d5NQF+!k%0mCLveTZU@^NZU63Ql zMs7tawys9@<$8^Jf_UE8-HakNi7xpkr{>D zPA`V!)v*I75zYV-yp~2f&4Ez)fV~>GYxss|WS*rgZpE6SGBlN z!BpB8;JcZR?BO?Qv^^pK$TY-*FXK>|*II0=jbHH0GqT~A7o*ZoWsks%Wgo|j1%m%~ z-~EwN$&>!iOB|31?BuDC(omSdWHo)I4Q7lk_jz_iNYN2Vns>t^lcezC2PZRW7^?#H z5fp$W8giml*EqX^@&({#d8eWDGgLr+>8XX7PkwH|H)#XiZ5hew!MIgN#($P|lgFg(K$=ySt^0euJldQ3lHtv&GN z@7ZNYhKdfr9V8$^(b}=xRDIH?G;3yQFV*3tP+qg@Rv`Toe#tjw?$#PXx!yE?6BOgp zx8&7J8a{dNJCt-YC-ksnblRZ~rV~a7W+OvUd>9DPLQGy1oYMRE+cgiy{mQurm)dm3 zP32jrIasz$5j-;N;WG?KlP=91fmSDa{ls&8&4Y8^7B|`6j!)(iT~n*K$3xs^Y*&I~ zUewhcDj-G%4k69uT!(v_{JWFY`_c}qCp4%);(oE<$vCbh8nl|qOB zV41!s$H_3;ps_f$*Sk!o&8N=n;vGYDYF22xdIshVeJ<34x5x=Rr*kjKI~fb~XZj2^ zUy6KMJCHZD1CPzdxUH;&E)E_E=Kb)LcMhRyxa%!o z4I@23m&JzR;4sWx0Ri8H?+M50$cZwwPoT13DlW0lJ{c9>Xi|_)zRt`g$m{_ zm4P5n{9%rjdZhq`keF8v0sJ3mU`2r5y(ub-C#VA(42Q;j7`(0u3rX@zv~2yi9FiqE z(;Q_B*If-++iR<%@W(%F0LSHzVVosi0H#=Ndg;TL5_+o#H|%=kOHi4;XcIZA2)jA!Z|9KkjV-8mWv;HgB1&tY~o zUo%hF^zuqcZchagGydF!-6H;Zj9WR~5EjEX!QV1~*E#)Dvr{x$DBBEiM7Q$R`*!K` z)gsJi`lC{9Tpb?)+T!i$$ll6*+3a=FzK%6$@5a}h)s~)(I6T}tcT_pT_cnQ9%#Hyp zou5dp6`sl(2R@TB$>o|mx;ny?E{C@8Ex(9Hg1lNj=X(tZDfTK}Iwsr=AX&1lw%%r- zQ>5TEMTyY52>ud=rs&uie}=$rg&h<5t5j46hwW$)$W^bfTGVQW*0w5^A0o$~R|2i6 z(*{=?;%58Mi%_%Yja(x#WVo;!8fc=-vC2w~yXgOas+&nCt={=RJE($#fQTj*RT=>c zNXf;O11iGX{t==vG`oGz!Ywxlu5TpoNYX>dg0p1nWa!WvF09v5^G_Qrr+U|2Z64D82m3@dr&8C6-XtqRdgjjedP;)O}G z=A9m=wQGF76P8*wF0DUpZ!b$Y!3C3QY{Uf}32ag;>4E9u@u!jrmaSis3ydacHm_~* z*z@7tj=!EdZx>7Jx@ZsOSght2A0=qs$~HC~hODVRME(TE9Me=z z&i@f{N(r@1y!7VVzIQ&Y^+C2cYkZyi`ViXM$$XvZb&Q#u_Sofe%nxMMZ(9}qeFUZ9SPpJpA2C4)fu%`bqXV!Fg~zhl`Twxt ze>jp7>)vwKKgHuy`?4S@5@#E*Qw?OH;DOny6aSzgh5(yWmSJ97py+x7xVozfrRkVS zU>u5MJ^)~x2$?Y$ls=eKKb#2T{)#uqRVS>ncB}H+rd1Vkjby9+dGlH9{`~ow7$j$p zap0hwA^0gd3y3;jH2oJ)Dx365x=@0q8acmK@UUNm%2f4Q)~NQ!QEds--Y7IqO zOf>`-N^BpkZ6TMW)}DEYF6KJoPPyaz|G>c1ZAB=&#H1MZR9+=0%trpYKpHqVgTC?g ze{woNq$=-#{->U!BnoaKr~XiZf=EPKM*^Bq)!V=oG0c+tiUpvzJp{jS1291&!7$6c z$3X4&)tjTcS~|}wHc9;v|8u{+5C1V>nRX|auBUEouj8r7jn~hUe+<~+Cb*7mY+hNL ztYk+t|A17jKEf=G>L`Am5`%U!l77mrttS9H{W!etuKIYV;hQG17@D*xb|@SMh@KzY zKXYKhQ%|HP3drmfGG$D*LRRR{6Wj{qKbq(7|MR97MoQEEj@iGy&E6P3zb9oSL0{!5 z;W&?;D&by%2$7)yMR$}{F}`k0=db9=lKTi&dH|v5BM48hqfa#5^E%1Id%xDwD8ZyZ zVwdGd)w*^!?cel4>z`ToNAnLVkTC_`7BG*J5m^JX-F_2{{K)q4M`HTn3v9JQHl4Nu zq(Y)~vbh_(OB{y`kp#!wj3pjC z*%9z8S6(f9l+S9NHA+~`Mn{Xg=4A2{tGq#Dc)*!oJG9kveYW?`YM10%9T|skbKp}W z083ZEb&t&*2Yi^Z)}N#J;`O&vZ;&IbLRHMJWE;UATu&QbesnX;`6^D}zsmgvLkGo$ zz=_BUr5}{jrx2tI)rxqv%i{9t$Wt1-%hY(c!C(wGQrG%n{}1LJqNJiyfRU#v2!aX& z-K2Fb^V%^p9ckizGKFIbWo88;5r)tXK}s&hBHi8FCev1duV$*+b@@r}7xO)9sC($Pugaku=&;w- zUBeH_(8Oqu8rW(B4_a{bjH}%#+`m zWydUg?;Uzhw#HrsPOK7~6MV^pp*F~94`Ei`A_&4V!eF!X0C4g_QyO9kDg9I68EW(z=zJf* z3HP-|-n@J=$|k`$MhUqG#NMSJP=>F=F-K1umM5^d0ppODB@xQP&5n$CuG}Q8eBwNV zFi9OVsrE+WK<_px-!FI3?5xWBYA#)@M^77}t0<*s7AJ_n_$xIQ6ooLe4b=8Oa~yZ{ zU_7nIVC?J_P_)tU;uD{qU4%BBOu(C^lX&k16e2{!DKT@poc~n=I@t+F+6-4$I=wxQ zJlNn^d*j=+qO03>^q9G#%{c%IkT*Mci_KQs6UTz{iyut6%gy@JmFJmB%f(fdB-!RL z8PF$!?SYtx=N)q`t7fhjcMKoy3{9Scr<)V!wK=REsyd;&d~VgK-n26Jqk-VI^&`xu z!p}+e!B@yIt9!&+c^3>pXM6PMM#oB&-v$6w7?qFGL?PIQOdTFPYkZn)+{@p%w|`w$KU|tp-|i`D@8R^4Zq2;#IHrL7OM_ax&pn_di3mW8l>y17hi4( z;j?g}fwUXZ^lO~Vw02+)=$sYjImkNjoOkgm)~KXlUCi#MeT)Ol$P{FL(T9=FQAL3J$3<$1$>+e7LQPW$*_sM)0%}*CfpJm$x|ji5PpMp9iVeDGYfiwmtXtFF%Wag zQ`n$Dsh$p@_(7`_JRWesy!l9DLKMhy9LM5ehWC-K=R;;Jc5mSf&k1KX(Nc<&9qgFw zZggyx^`zaIQCK4cR^eUM3t(SR`elHYJb@!^Vcr1u`~qSZL6t66;%P@ z1QSsoLO?bM1Jb){=Ujxu{;;#Wf=ha+*i4^Q@|D(JWpxWod)dYo1;wzgGlx3i(d{Xr zSq7ipIKB)p<$(D=bhxaC0er}do`K5j1)p$7lm=P2tTC9Fc+oqVxE%&zYAcI#A&uN8;Lpriy9 z%H?Q9{b#q~wWzQ^b6+smQ-257C~f{~DI%Ajzm_unl%NPXF6XDviLn5@VdUl<<-&tY%BA5Jyu(yQi5u*aF9F&S z=F?AG-12^!P(-R%ncYG$Rt3rE4Q8I>#Cb~ZCx~Z?=MI{M+lRY_w~~{hse~Ja7ov?& z5XEzou#mEx+%w6_zXz#(J==9E{c=O|&G1hLg8VlpVJ^hV)Q1NF2Wciu%oq8e#|Sr7 zSOOFl_!IvG_dAEYNDPL4a2P*miW#dU9clxVKQ5>q9?6saAP$L}EIY}Ef?%G#Ig!(9 ztLr?bNFi(?*_$0FjFUn!v+0cJY}@Kx=pohjt@AoNn4BDUbMavN@#5rN@cR94@=C4` zQLo~MZhv*38MPiJ{_}BdUxfKfm3~kQNWwrsMn2bxL7x~j~NvS zo)LCwj{nJ_E$5M_>Q^fcXOh|vtuJ9)>+YPQ6jWHM8mXnNZg#ZG30TO~tG|@s8y@Iz z8FwXBEDWL;sje*Xl*d6$lcWPZ6yx)jl?N3^ALhftK#bzr$nQJ@jK9-pj~UytVE9c zd12N2WH`9ZWVowvWW^~&VRh&2I6UMuk5hb=ajA|%v zK8t8P?sbwk5b4pYnfT<-UCL3?c0h=&ny!-kfy(H5R#=HT8G*WJ)Uuw4T1eC<+PLu< zCo3`-B`-1xh6ya|TTB0Y9ttl`q#6pY!J#1 zWJ%@YPxV#az<8pHjpxDy?C)Hnek9G_?-tQw%S*Ls8aFP4KAW$`=gC8)*OS|NW80tHjPW<)DPoFSZ z+Js*opav?8AA$$Q{7CYp<-M2@sg(L@Vrtbe!T^+$jS0krK_LOG)#arh;N$Y_s7lU7 zOL=;gP5Sf*l%=NphkfMk&g25}6s;hw@TC-O*ylJZTqjIkMEt*`fLq)_9*1l8`~ELD zOpCGTqzPdVLJX-MF+Ml;S#E{c*YS0Y?YsG^j&tmXew}zdxd?l-uhqRl$QgX!Vi-+z zFoRt>w3fsyT+=rQc8R}}pQ;);AsYyeE=*pyTR+eN>_K~FHBeYw#F%5gBn(-)$kTgj z{JXg+v&~UDLRC?fK+4UAg%54mA-_3k`MEP$a-(l&#TegtJhfk=y;QgD#{7XZayLak zllfo3p!>ajRrPEz_IzHztj>@^huETG&n_vTp~7Mx5S}g{fxEhn_YH6KOD{u(PQnYN zi^@IyltWXu5%?}y3{)Z9lDRG>Icfy|5+o_PtA&A^i@@X^WKbirey*QcF)-DW(^QYj z8RiHO|E>ObSGywm(~H#|dZ`UfbsuhOjda1?`)K0@+LbJQpU}H$gJ{;XHpn~wGNIaO z?;&kN!^UL;*a=^{#kppWI6kRy?Dr>=$?J7i#x7B7Urpm+D@kzQ_ScdK9mQftRlUCd zEsO4D|Cyq0Sd-ZLx-R`jjlhxXXwj~4vxi%k9-UhiZi8FZrK@-3xgFuO{|acXhkjSk zG2Oy3UgvrFiOjU}pTPBT#dLDJA_MR_&#ugQtKgzxAVq?8mx6WzraV8!a*D@ByVZXze+WD7i&e>24 zjlT+>?5Puj=*dUZFnfikz?l#b1K9?>15F7BICyy)84CESm~(YwM#WW&ChHWvJCzEO z^%Q4e7i^)#Z#*h#h|BNol8VN)j*G$aeqYq)C*z@~A&jBxqoLJJ@l_IDQ7>ewVlHv! z8R*~f)6p7o=anJ=$Y+%ujKJ+3#2SlFtDYbCXrd0~dgAtbsM?q)bbI>) z@0F_kxNM>g+{>Fos+xz{yRli9+Xy9$A1v@*y+n#y${yhkBY%A`VX;ts()kHcf<}xX z#`#dNn_y4c48rZULF_=P=wf@((H|A#PA|{-77ulmy|MbPRnV~lG!tp+AT;(I7CXq* z3R-bE290IuLtdpis55#ZuZ8H-n??PAghRt5zk|pl89Ut22$jlnh5v?d&m2Ep3l1fKNj{2>Q)VbUl zS1R~aH6D+fE4ZdArnu}eyUG|Ui6}5X$}ZTet?wV54%3wbhWm^eH@uWC^oG9 zb2sEJ1t;#*-6x#yC-OyFh2c*K$-94}SGx)LB1t@DSKHYfqp%x2XE3WKEZm$>eTykG zd@E^bTgjRqDLOm++GM*od79S;a^_!8)_Ury10|4S<*jS~lxexxdhw zlk15$yr{z`Z9%8Uoebfe!J##Yc?r}E1bJ4T z&T%S*7!q+2+hh*$)$Zz#UD0pL71F%~q@$rn6SvHfwV7337dE~eB1vT*KxXlTCGd`b zO=pFPk=7p-+UZ){rr*Z_CHOpHm6~VvQuVV!Qb&}_G%+zzwm$K-m zSV>5|8dyotRt1nZ>gn2iaU1W`3b&UaoAidW&w@_*kF9PlAvfJ{2hQkpvGSLM_qR;7 zDL!jSBDvh9XYj;Q-H?YI|1>WA5b=DX zm+6)S^}dC;0QF@823#))bz<~Ryoi7Z4boBlVEKR%5)8CMun)~;#$e&b)nNGmAOMGN zTtYbtzTt1Hji`-om;uZHR*1pFEd?F~{{bWAR3m6G`c!3I zD2!BK5GV!^psThZj3bZ<#?YM1r=`*v0QPI}om*{AWRXQRJ|BTe&@Qo=UV%%#!Dv_L z#pEISwvTu>*7<`I_D3r82;e z)diuDy)5RMu@XGySU~?u{X-XprrO<89q*&0?_NEyHv1`t_^1!(t@V|$)vqSwsdTu- z(T#{F)QAwmKPc>MrZ9R}Ae^~sYLPdgc6u4DT}y7K243InhB56<;?gs(1F6_r<7dL8 zDFaOAQ_F009KJ>kAkT|6s|)XRY4sUa-3oF&b=)0%2m9Pw*qUoX_3)Li?9-hT6YtmZbU+gzoJzcD8gqpISx8)DyF#r`qKu<^A z_)}EW1cUi(Cxz=tuFuOuhCp_e;;5VMWy61HCn6krmcD+*=2l}4Ytp7VNKK0nWC413 zyLT}GN~jqx|NXdM`t2e5Mrb*lQg3#<@Hm=^2%wd+`QSt z#r2G#F(9y6URZNsJ(1G8w{A5a-D{FH>C2y(IVu}k&vMS|S_f$oKChNCSu1)25!L=C zlxZ>%Uhm4`PC0|0?rGUf&51A!Ber%#cA~{`u_lVVIW?x1XkhW|YEFa~l#WL>+;I(f zqC!s1upGqgI>cu+NQ*mkjO)!G9Kv`&?0hQ08JkW_qC8t4rNLR+|eUrrh?RqMBhq}6dZr_DW z%?kyU0T!!mC~gR&2%HCV2gju)$psitd+7AiC?yAIB(?NYD~rF3Z!B)2&V z9DId^igsqh;2!IV)!p_XV6dCZq@S)P(+}7V*4BRZ^n8QV!DSjX?{nFfW7Y!e+cgn= zwUgD2h}(@6yvMPqbUbC>OuJ!=b@eMPowu_Kfs{BwZlkg7m(I23Kx*QM2u@U!w6{NX zjp(?P9XJgf`Fx9*V)pJeIOU-_9quZ$U6XY#;CeLM?Qa?#G4vC)(#{2^&>Zi|r_Q~Z z#Evuf9I+AqJ~MU^b}-hzHDCWRBWjv>KXp(>3+<+ROcHM#E=YF`Xvt`3_*f!RYL_)yqW+`u?bqJ<+L`b8DE^#}dj@M&y_`$dw)_OSDC=?z zIr5!Fshnh>ojJV;d3xkYlxQc)MjB;LCGavcWN>)5#Ee2JO7vN^Uv|zOEuqz$7j=E1 z>DeCP>my~9-A2dQ)9=|}lXLOmp6y%NQi+MBoZ~q|G?YA+K5Uu;RotTg<_@ToSfd!( z*c*FzBHZ?i4sU77hr{%)ntQkCY8HeRT@B$(G1%y|r55Y_fozLH`@RhcoYvTt3;57v z3p2u(BAcRL@9wpMLs={3;n|DNe%*(uvwq8uTJ=YdM#R42Fib?EGnJ77$6oGYD^6+F z^oOEFa^76@2(COiY`P5+cgJni6NH2shUuxu8|ktSLyAbs#Yu4b1z6MU3Y1SY)~bO? zS}BLbHoMi7Ar5@}UwSO7Z*fl~eGbpM*t8&jXz&Na**=szBqyn-J`BlQM`G;|DY#fn z`4B2N6F7l*5hY5UTv{!-12}ZJL?B2jNhBz#E9{6lK&TlS1jHUnz4W)Abe5Dnin-+|g8j#j{?!_EaC<+p-yrURyYPyM5;_B<^_3UeDhuws)2@_$ z=VHXHR>beK$9>sW=GG&L)2@0aBy3*i--$Bs*;~o8cK!0Vu9EBbemgn$d_DJDPrmnC zsoxOHVLw?WF{-+<_8hBS;}#|h?0~oug=HtSM}J$4?y|l{=M?O<$PHTM!xqi9s@{xo zqC~cqo|^Tv*;-v%TihSPw80VbwFlU<=n%N1Qa52klQX%--zMkx9ymrgCod)CatvGD zHn`LY3$t{WY1vHh5snTHCR=K8e_ERfxeRUDn~pWKy8P*AG_&bP&al#nIR>`HXqBf- ztYbMDj{5GfPoT0{Y1C@ala0sG zUz~;{#JcD;oQe!$j-Fb?5hq}W>ojT>N*m|F zqbV|rw;NEJcC{(yoBwXTMgdB|i5Wl1fYAc%?AKZuu5yy{d&Kw)xI-3<`*1_GgSm+T%hV^3?1l*c=s42*XgA6==^QGK|5T|P z?+;`Y`n7+pY}Gl9GWSe74T_8NCONX+$sAhsOC>7OFa+angj~#1*8_OG$aYwCn{e~l>(0uD>8zGUSFcNHFJ}{0w*5b@-Z8qesN2@A*tTukwr#Uw zTRYsb&5CWiVkZ^bwkt`6U(S1OyZ1Zi=W6@s>U*p?M(^X9!ct5ZIfCq(6}tZdPB8UfM1ThCl2S?~Cnh<|Qv^AiY0VYRS!)&Dv4zmld z17hz}s$=Es8udXOcOQk%Bzh+fQEZ^FXGEGUtXNmoAz0T7 z%ULx$=&o_^Udvb#cZ30yf_XP=;0!;d{JajX&~O+(;}sg}o-7LLZ6qf68fARnKwQ$u z3GP?pM1oI@FdY`P|F&!C3)`e z55{(*M;GSNyExI}%jXmL$4WuT$7|8aX%1!gyhuf{#d@517!wWn*VI=gg~ARa3O$%S zs$?9m2DFHvr15T-yRs_tZkaBw6gSt<})O*>q%78euP0TLoa8s6M`gKPc#ai z#p29UTjo|Q1$pH4duI_o69)a5y|0Hyj)xKw0t!#{vx2DWIP<}It?Nb`sm!61z(Z;E zE0QLq-Pz5m5zS-{Msv-vD(A*3o1OEDxY~QHr>e;GUt#m4PLCZ$86!P{TooEI&-Ul? zxL7Ooo)28M0Q;L*RExjkOO6cEm`dwcv0hKfMxraVs~zabVyeWcJrEe5M4FP{)xVh&I=lYRO#_fGy) zx%(-W1b}$PBM-OcPlT^bH2MNbJjrOM|2axUsdkU$HE8x8kq1&wnC`Rr_sU?vSGeY! zan1+Hf6OF`5_Tx(l$0H^2{5|5b54cWG2(lDR=5rR#7k zQ|`pDdXUbK9(xUP0H0_E6*&EI2yrN-(6JCM2XHsC(DfgVGk>t$63W#4!tZ&h=~QB^ z5#;f?JL)82tqC}7Zhu%iqm}q~(2fG%A(MAobxf3Sy)=J~yg(N!-h+(#S5$ftjzoni zR9uZ@isQ;(T*Yk!^(&Z z{{;@6L~!u+Qs(be-0JQu|2w>=VENiY_|qfXX3Yj$-hHv*S2DEwpQbP6i{ya>>QC}; zKONIckEZh^qWqGN!$n_oTjv;!FYK78Ye3LV#LfaWsV5cR=TGn>s)MiKM=5YHr4b`x zUCi)|{4ZC(U0ev?`Ea~P_Omlc0WqJ_(#i05Uu0ORUWs7r5z_`N-!{9 zG-e^6lVm?>qN^zLF8k!$etG>kpbFGlwUp+gj4tu?yQMhpw2i%-sEtrk-%eg1-d}{f zDkf<&;q|6$KFJ&40z9+;U#47-0Lho)9ndi*9e=|4HT9qOpRamPU!Wy`?nPA4s8{@2 zQ3ZEihA>@9f~GCO3t_# zVMk!e8*yHAgCI-J78k#G0o~#tC9_=U4WSV9s@*bkO|xUOi}NeS&gqx?)UNTE$~+sx z7?q&c3q)bT5jhko&hGLLZtN(pzm*#JJNpJKo7A0R#T6n0EF;!%Zw!Bx((i+; zu}VPL<;z~|m0u!Oz$oKlo1_U9WEfNQ)B3k(?qV*ZR{x)6PqhC_ez|LPumgNIG{_L? zeG8yW>CFS%AFk?O&c-H_;t=r&cig9>r9Ri0PqP~AMq33u_|C8QSxD=U{HhM z)oy7AmdmgCS7~uMW)04mUd}egZUxkBa2)nc{ z-GhslI1F5@mT~Im&U1_%gDcs2fYTVWYF5=_Xq!B-hJTPr<35!8Pos>jKq+2*n%}-O zSJiKp0+0Nr2+!zR81@)hiaZ$bv5z@Xi@=Cqj1Wdz4x7miFh6H_^u5Hgyp3`%(yE&G z@`BPGXzn^+zP4Lpc_;@=yzEuvi9%;Y|GL?PF zGwi6;gJxz;Nz-zMMqJM?9lWWL(fJOq8Ct4I7{L9)8oI^&%|qxb^jhep-IsQEU&ODk z53z969{_KoKm$ayW^Pt7=m%V zS$M+L>YnSHtGQW5(GsO&)RR(C1QkIE4nIYg%pIS!u{jhARuSX<<6dnvXcXfJb1zt_ zGt#psbN-$1L4l;Kndsnkb-Wuo74xD_I6epA*Z<0sZtSaJkbldR@;`AjrgUKnP{{OD zOGxbRe4&Bk0yDaR;s*PL=IMl1+a1d)B;o83nGmdVvS#HE1W1)j*GpfQ9AE$6{$KA9eQMP#cJBMVOf`Ew@q$_faTe5K zdq{=Fbg6g46&Mp^8K)1*>)JOFiq#z@x&8zIB$>)+WB61w!NY(djg=ifUK9d7@i>#K zKgaz6l2O#mUVE$B%y!jnr4AdT`fbDE;^lExko_Cs2im3EH4ZJ>*36-ou7)jz!U*+;8bdp>iuaX)`vg5jUqwJhQ5GNI z3>Jbe?d_NrzAq;I(^W*l)j3h$YjG?_| zjznEn9q(U1ffXmZFp08jR7@CwflQb*=$}U0U$5i2a)0cY?Tos~PyYU(c-duQOrE5q zDEWH%?HEMjNHd|#oMtQ-Xj>>u=HhX1$&TCa$0w>EiDfqJ z)^vwBQMU<$F6)#T{RX1xg%kt6>=XaSP2ah-$B+56DfshO>0vYY#2JNo`Y3#aoOy&H z9zZJFU7#(UFjf#%INKeZ2J@|y*|eFpr^Zw{ci7ug6E}qZSE_)HenE8nTTg=NyQSb1 z>48L`DCq>G-=$AZgMJt(#Sxga(=-j*b{ zREnn-r_@JkeJ0tfe-{eGh$F_=cf4)**J;%&e7=Cf{DTPQDYxZju0i5BL107W%@R$= zu|{RwY_YAaiV8g5!#_4Hk4CR)R}KnI%zG0P4h8}`rc^_d7r)wIC0`UcLwk!&>(TuBBrs*((*ZVVlh^})vHTuhO;{$tF zLj%AId@AFFkKA2pnR$7O)06w2W^32Q+|xpCT54R^5BK`d<>qW<)=YvbcwK|zV0 zsdny-=?y2yUh<1o@1?a==Q3S^ccQIghDwFhSe4}M4=_3?5S~A)=^`m5<BO*{&wXku3tKvFO|s2>yPa} zeOZU#Mm@6&sFJyI`<;GMF}Zcvcah*+|FsMhZ`mUTh70J{Rn31{1TL~TCTbl)8F2%G z=|qe-476z%<{ll#lP2A#sRo9!v#Km4RvipzWd!{L_6=A)d_9uix=F1De_M?+)E#3D z!JQ@Sdznplsrj&UPDIQjL?`|$ROw`pCJyEcl9-E^$TCY&nC})Rn~D2EcK#8u?nfy9$dA7 zt?w4RPSA3E42wZCgTI8r164U*Z|YqpG4FRhU+cUnHZPwDpeOTOa} z6d+J&;>F!V+W{A?-@NUk_vtaGuI%dl<=^)L8$`Fc*9BxRh5L|gIHp!Aa{`7AisqKB zdPx+$bADKqx$vH<#5u9wpSJY4(UI*40KxWc^VLcZHQ2~(&**cGu7g%;pm{EX4OAN1wcFR-fHev^e zYYFJIdyFC6qwe4XG>1N1GgaylWS*4aa8oqZ9c)Ls*%-|4S|kM-_~A%6Jf>Y-0Ic`n z-1w|usV7BdmlF*Ywru~njyBw2VORBN~Nv`Y8;p?)uDzFwf&vXmabyb z{UN5kOma;sy)3*~q=E07dgwf<`eu`zMLX%)JjA8Nsk>*Go*aF^sMs|eC~J%o_etHc zBW%_t?JlLm(Oh@{@X}dB2R`X90Bg@J7_b3q@Tq3V=p$mDv)OJ#6{{w|sMR2BJN$+G zDlDq#f?Or~0K1aok$L~T@F*jb2?<|q3F`A&0cKsu1H7kz9XHM@aC)^Bqw+`L)GMNz zZ^c#z7fUBg)wX@v7!c++L1cF7Xd4!@zBgxXqp6Czkd(gLl@zl+gVVbLOiIr`ULOXp+!^l2li;%euH?o_4zzi=#`0$Iu+K=$rxLQd;{l&Cs8j)x7 z3B53i>CY%?B_pJpr_G-qaq)6CZtnz9Nn%_=am z22CTh`S}TQUC9DA_c&khXVmL|p?n*M4sU*Oe&^`ktrB@3Y~Hwk%BR)R2H*(`iT;>P z=yc}?M2twmusxwz<2~E+=M#dqA!T9Vuo`koN({6R#iXxV11?4%_nJLpY<+!?)g} zIZN)+OkYRZzCT~b0aymJXhXdxY%o6KK3$v#m0P2+0M~v`^718`k@hohBKt(k)s@v@ z-#@?|Nw*c1*ru1vQ+$iy*8AU1m1nb6s$s&W+Zqz?Q_$>EV7U3UckeN;spFeZ*FonH z?%i9MMyT8~nme%U;pnr4jyJ)uNc|eq$@~VYdk!_P)w|0cQ0EykKft*4H)p-_qDtBJ zkxLh)ZKNk+VdDBwknjk!%VJGS<@ptvK=0ilcz@;U!c1?MX>x=+eHBZ&1-Op-*uo*F^w0gd zl1mN@rA&X#;I;iehHEqlqXkrUk8RwG3A+xb8n3>@VLjl=<7dWTw` z+~<{0V(=*^BE(-P3PZ^Eo_XoEh8_^eQdHG?t$on|uq_!azeo0ZqS3opy37AHvhVyJ z*_(9kdj@A|r!x{TZ>O&IkpC)fB~z@Co_88KfTvUqoeC$50ijP&P~}vR0m3&P3X#+Q z%n9yMM-16Y8TZ*mu7)Ev^%A$uD%9cK1sS>H=CwhLHs3)Ji~+y*jo`s{b_yYk;l&uM8BprC;dsQdqcCSHCB-zx%a5lCcpp+4u>EQZ_3&V z{o_Y1=8qrT|LwH;aD!q&5a`U;ny066gOUQUdZ~_E$XSMKbQ{72pbgMo(%wtcKVlR7D28G$EHP@ zJrq!z-X5w6RJYcp)6n07vr))hk_IH~DF6%=4Z!Zte@Pn?tnW+b=ZYMcWR>Db+;8_M z&}SYl)GJyKEuV-du<};0*^KwA!872PkOap%ht5gxRvC~Ziz&gA*vaM(_O~*Jx;M`B zMZwq&bN2g@1u6dY<`a`YDMN5?tW1?T)&=FOSF7%}u9H92FDn6mC2&YH*#PL)C=!Q( zkmOM9EH}^KJjDb&Bgjqvd;EJfx^JaCsASEx&p)2LZv*f_PGp<89uf>QQ4$8Ete zg`7EGO`2-!UkYe(1ZwIMdTvY-!p1;YZ_+W!uNjEyA(Ni~|6l`6FWt1*afe8RDgaqW@9s zo|9PDF~&26J5i+(=j?fB{GG%$lddDr$9u4pa7`|2(pIfutK`1&BnNa)*E?(0SRuX{ zY-P2U1=(n`j|SZAh}WjFOlNUU{;c?+5nCpu(4_k7?MaZG+OU(Y3?jk^sq&c?jcUop zUB8W;_JXe+dlVw3P0BgaDjp=4BEX3W6#u$g3IU6k-?3sz?hoE;#d{+Nc+S^n6#ID>&TdAV4o5Ey(8)skF-Nh-}z!m1c%nlmP4%&ydaAI4YEYmr1tI8TF zwMQc~H2o1WdZqSbthMtL{q#E%6Di5fhj4Egj0~JltJoDV(NW=zz;Q6Av@a!Cfo)RL zQIfAvVYQH3pQ~lIumEE@h@IkQ;o?mF?t#kP7(N6##Q>MEop&UyrCnw3H&MlGBM;{} zp8*O*Vxwo`Z3c{ahI!{97`*1$jLQgezm}p#y4gJA>+nf^reZGCfHq6E#kd}pqHpC6 zRwoxt$+}lb+{Oc4I;vG@HVRnHlk!{}fAcmF5SL^1Y${kwXF6=|oSO{ktbe+RxOH(- zf|9CPB>=P^N7PPoXr>yXuZx*;F=1rxqDmY6#MM*s<(X-=7plA-b6QP)_TdT?*{|M+ z`k*C;8%4OnZWCvdN;}Fm@1~3Ui(Lf!Ql`fU1+yl|&$sdA=raYTYzh;Gtgk*#iL2XI%?3=Pch5osByTR<9`j-Vq1- zeFpwP75cfQcWk2MO9?7abY^l%SQAAFaLRM!MwUeX=-9~jK~BoXxYdj?J{vPq*YRon zfjVf1)Xl}*8(23M33PL;y+UHH2sA91;?u{?53s^Le-zO+9xL{2yw!OEMG4h8hcmcK z4*=>XhyNgS%gEKD@1-zda;`)(>SeJT7xHG%Ny-f2B?ZD>1u>ASU;4>t^&P3sMJ4;+ zP_6s`iWA+zjVaU<1n#*#=i^cq@aZ5hyK6^zCxlW=2@Kv{nJJ`DnoH{LZ$D0zq~sh?d5*1S0A@LVu-LW9EgceP8K53L|MIeNP@w|<&Ze=aW7uw*7au|W+Mnmh z%#iM5!h}|(Yxl34!)PVd)H(3>&K}ZEZOg( zep0W0SV&!?&<6JW`*broJgLve>f70B-j0e#J^%j)yyL}ZT+x6EKqkhZ4*Hf&z~xM} zjV$6qPSUUgp29c^)(wH&cvAE;L4gS+8VZ`fAht(YPCn~)KAO6NQA)WPBZrsry;5)Z zORpLx%Rkcu)S8-$Qz9109t3yzB!g^0l-LMSFD%6{x;^2H4^*wdV~;0@OHN9{dxy^F zv5@k=7$*Nnw)vW60BgJq{K%jEtaH!M$%Khdb>@U76J#y{rne-ek=kqVc$XV@pl;_C z5tmVTID_!C4tYw@Q2{&C$Dcsy7m;fmQGj^yk%$9I0Sn6hj}JnV8Otc<$m_pz{^HLc z!xZ!4#s1Mag=~}2Jftp@L&PW{lSw8&7b88WBV_IY^@gJ50D-wY>1N+d<(Td5o@l*t z6++WGnSCn_80&tj*34fAYQX@~T8WL;00IVyDXcrO*TE~&>s={{cWj{!#F0C-&7Qbi zd@+2XgNU^q#JC#H`SFH9$yXj#{AWA<0hFWF!G?4*qS1gjFnmX6{6p+L?jh&U1L{$h z|L_GBU2>TBxu;nMoudzEN2y1{Ut&a4Xoe;q`M!ky#~~b4SWs!Deg*O?yq;KJq>(72cHasOb z3Paiz(|K~hgzj(r(L$Sfc765f)A`dE@c#Zp(1*rv>UH*-$DlBV=gYa$(wEMmgZ9)K zb*>uTy2>FMK2LQQrf%x4cX|RSEgZ;;fuRY$-d=jQ z?^mFrLG)#jR*H*LaTx`Vfbs84X#bBF34?n&)|nOBneXAN?3{1H3j@J;oi(T=PG?w~ z{nNf1{O}nX1|~C*4wLcVd=K!!KqC}$JGe5p_G7#IX1hc{WHn9I z#*}yiM^7BJ5EtAcmd7ozdG|P0@@09`-m{EPtE3q;NgWNq7YQWNOou%?D({6yd~E1@ zVw)55oF3!gDKZhM&d=tmRjZcG4P4P6&{>xWU8b6Ltr&tSh6j}sYydU?RCXzo`ZLttzYwrz+gfI zDXHgOvk&v&VLA>K_gnBn%7A)5!;wt5!_w8fYGJS;_un`D&x7%Wcj1Y)VTW{x}q7C(h`%kJ%Rq&KVY4 z9~~DI5nK@>zSsqZ$h;ODez*2K8LtrkQ`$?QsUY6p(zg7zQ@$}6>BQEM_y9&TI}=ye z-0#JY|29?D<}vkQNwJuyiLr)j_;op0yi622#8aSHSQb3W#oC&tXXyL6J|k{EA&KDc z=7=o#4a(=!tccfgU1!>MIxcyB27JE$m&oba_$wh5v~Z{Kei_u-m=N1GQf{UZEtSmI zaeA z?Uj-(ReTX&YDK%oKEohh*1flH_Y*QIf93?B-d2Cb0Z8W>u5MtTwI9xH3KN z$`tA?h1!q+)H3VWe<$XoYcjs#-_B-Gl5tZvi=dkswjPQ$oc=|!pet%mc2fue2e9Yuh75D_tsAN}@BLQ&9IR|FmG5TegKzSC4oCVodfIUCaJ3DY!}`W#yJC$W!3h znU7^rO_pj5{}48Q;%5%`6XK2_A+Mh`^wjSs9e*5eGb~&8{zsx7z%N@IPfrtauz>2=n8IJ5Ksu>3_=WJ(g7IY_pw-xCyEecC zk8MXbNy-X~9PAwef`X@dnJ`q0U~AogHAz?0wXcGE&d%V!umYd_D8{#dWG~3P;86-m znR}*uU%-}oR`v<=f%jUo@VMDk^;edj8-`6izUL%I;AHcm^JM$&`77Wa>j%^=9I$72 z!gQv-y%pd@R+d>}Gfa&`A<(8?JB>s6=WK;x>rgVR4^2|%*Rmy*dy{7U<1jULh>uQJ z<tW`n1(zRognkV*I=IPkX$N#~bQqwzvmp~Bw_10t zMvFu)HcqQAnJLvc73ts!ns)p$_p*ouv>s4n8H1cAJ?l|J1WJsVVRc{?SqeHAew^wr zIWj=X6CUJ|JfXQD7M`R?n+0dxe?PB}(hk#358D)yh%4-Z0+KViPty*~5%Mtm0g~%f z15}LDoi9_TA}ut!I-!r5HJEn*xs5ip(SlyV))nTm-rg(HWK#DiSr|$Z;z5yhHH(XT zus4#ai{cN*zF>2BSvSUA2mF7T<%E%-O{g3BpCO4Ho?| z?(sI6jg9)zNB4W$sO~gjUW)5=(K<<**&s2qzD6P%WRg3(M+sz=eL=D28`M;70s6x8 zt(e;w#;L=m^p-?bWG^c+B|Vce`6e0|nzv!C9Y`47k@{BXN2QkF!4v&n^?2qV{s-9o zTBrIodLJ6`S9qM!4hSgw-Q9@QCHU)f;13EAoRXOa^G3_6LI-0560#A-R*oh$gpCImKO3&)lM*_3<)=9a?cmd)|MQ z=|$ob24l3@#e1UO4faaUi!Y9gWdXMz0(gYgUGCqy*mk=_p1aa3*^#%xEzwZSh2LX0 zLfs6`xUY=gL>)!YIX2rm;g*70X={m|UT#$K69^aVEf~jxjo=sePlX=3HyAM8hAoA& zSV5+dJ86M6SGU;AinS4_r^GFz}(pF2xk82%h#Pq&F27_?;gZAJ7IaEr6O~c2RW+s3k{r<>X)2Fe!c{fI*z%_D zyVaoKf;7FnmLhnfQ3vR}yBkeJQL%BO4l4I7Q|^)aRop{%Ihz*aS;bpps(A5R?D4fp zu9L@bhtg0tKWxpn)>3z*(2%)q-QZ*Fd?{GbKy4(aLZ^k6271lE*nNQcFI&s7P7g1` z6S#?3NqOoYTMe;YMCW{+I^SWd4CAeo5)3TL778hPL5&KH=uSX=YQe^w^Y$of>T9w@ zxVrtg!!bUewJ+S9Xt8ZXySlPduab7CWY|b?yCJ_wQCDa^0j+p`!#bufv!~ZDBu*Bn}ww2Z1#9< zK2wt!#7CyO6$Bt8Q{4;VOrEwe*sheXGg!Y=Pewn+F{f4l(v5!A7=5P@znl6Xhn=l?vrG95=6YiX*{|Sr!kkLkQ#3 zislS9y%NWX)9nFkgw?SXcXg-^9N`ah;EJU>RltL|*HERbo{C&nGUI-rdi?C478gh5 zGfzR|3<027II1+8{HiPLwUnsfz=$>Z9bfoqDS?+)Kuw8ZKMXmS~8CXwR<6sjcqTWJmZo>*Gde;fsv>oL;rA(66b`kVwL#pU8G%%6X;H ze!68~S^lEE&S~caO>l2HRI44pV8Vw;wWaP8W&t30foa=IsS|!Z1BKw)F$}s~fKYsc zBzyk%?mazSrN#ZlZt|r+UlWO&uk4bpTcVuvbhZnS+`T$}YT}LGa$9g%Q0P+Ny5ihw z-uPb+2nx^gAzMcIAfry0b$mMi#;p5pN=!-4E2GNSBh~3I`}~tV%mA29fF7<<@!0k& z9b@Y@F*y1QPV1nfCkeF%PI^A8fM4^gtv3fb1YC2i2g;}n3>T+OdDLnS4EW)sMO@^U zXdW=Wp*W^4EF~GzR$t&Zpws^d?{#?O^+R%q-;*s-a5`w3cciQVb)DXZQ=+%Syz^gN z;vv7q^aGy@x*q$(+X0uP)=WwM5mC{Hn!~P!E#7+RTR$YAS)u)bAmD}2$}mlT#!T@L znLTPyQW+hHdBPkd-Tu!<*?htz1dkAnJdUD}qwRFNcR5SsY z6^UzUr9_Qf)?DFGS^KNu2DRdpi;vbqXrZV8b*ENw;`@RV`jfr@&A^Lz1-}#@si(OKm=0E&>?Bmt`xqfFo)d75zxE}mE zm&*g}gVjF`nFl;SMn&Sp@WXlHobZphXIN&OgAd3@Y2rY?aiuHVl-!g&wNCm6?cadX zJA-%pgq9D)kDZtQ?5LzO*?a@}PD;TE(~Uzw;L-zaATiop)j?%ZU{_aUspP+#5{K{b z3@r%xfB)WX3yJU@o>6f8FF4;td)xtKMKY$9njmbLDtR9Xs53P&35bodu5t*nDx%c} z{Tyc;f%l4v@1)T#(|_~%&J&5ku=x;T$4V-jvvU3U9-gkI-aj86umVq3&C3Zx1(a-t zyG99-)>WuC8X3BKi9F5o`JIa;^3A0k{Hg3ld&hzSEbZZbeFDFr2yV7M3%F->%&{8@ z3Ov1)nCb1eZF9od-N{2{Fb93eVtBU;X5UbhR=tr!vo2BsxE8w_ZX9E+1@WIFk7?#| z^meojlcez>_PvP0BAc~XN&C@6SRc2g0jTrv2dBd9VVdwqGSby0Hyp+D=*@)ZklOgB>@J z50|$YzU>s-!!kzU=34hW9{7}gG*@q_zP3@QSG{V{WT(D$KJYYRxW+*%$?V#QM6qIf!PD8Zq|!3Vc2~k$wrLQ*HO+m8+xTLF&pfac4qozKrx?PLRER+do?4 zXFJSlL~|mLO1X(Kl1^c%&MEcJk!dWiW=_@#v}T>^FVx*CRcrhSV_u(_-H$)@$JpBn zJ>o)*y_QB_s~*DzmJ59u9Y4%F%n#R9ZExA=e|8y8Ie~lD-@2OsPiI2=?lS(POJX}n zL_qGh>$><2gUV%pcf?3MS2v#*&YLu_;tBoeqYKVcF}4ciV*Du$TEMyBoVR z5OT-$VhkPsNqunTz*Sw1WIR8$>3iLC5-@dDw<8n)>J=9bKiTEHk*s^SoH$xU9BDxe zws#e7ttL5v7OpEUJ3{_Sl;ov!d5(%50_Yk=YR9@SKkL~!D}(^5s+}TiW5T1sMaR0P zGvtnycT6y^L?oBCQ9UXSu=x;5G#qyh{zkcoWrrW1B*~iQUaqqc&GeCHeOflB*6gwt zB)n3~Dl_kP1M~jSG0!s>K%7^m2HG&mR9c*V3+}Li^M_!UAM5YQp4Z?AN$RC4fI3h_ zQ^+Fw1M1F*!BWI5RQMrRX=(x<18X6@&4vy{OFSufLXa#D1C6_^8_yKKWDRXH|!$I`?! z`#mWr)$v^AZvHPU>qff9UhLBQ?+YbGFsIQiTXCqf0Pqsp>}B5b zja}f#mPP!5JlME>Ko(Jbq(%*~qhR~yKgUlS(nhB_&kfR^!l&38DqE8MqwVo9uTImW z?whwPkrnpLVYsDjEVWK*duan#Gdk+^=-1R!)T^)-VO_9IuyF$k15Tqq6;0Ilw*ONd z|KC-IS@JIQZPd1)xX`c`Pr9SOzcbR}|II8-cX9{& zTL*)ZO-%SS#cNA zl3KTt+Pqeq@TQY*(uPmH_}LhdFjB18$!ad-{^p&OV8el5!Z;_{t)eJ7FSGyRrCM-z zX9@;}hY={*ujCfg8Cqx$lxni>>gVeQyjw0nIyy|7e3Y|gU*9tN_RJsR{ncz4?pks< zTFPbmX;>4nZSoQh3BVQO*!~cE*#uElh4TI4kiWkSzYXGFCSpsaw#E?iEvODB8?ARM zHzPC1OEiD*cgP{E>XUC?`Vbd*I|30qV4iLY@~J>es{K-y61CHxheM|hgMwq(_!J32tsT)=ZT)5GR@ z?YFbV=lb*S+6mDY#*gbzA(XMhC^Z^|GQh-PM~W&o9Yza_y}W|L$>f1Ey^e*X%u(uq*ZJ&Ola1nYNOquOxaRC52q+UJuoAM!M}{uOvF?V) z*;KHqvGzz!40ovwNdfb3x2AM%Zl-K54VDY%-j_?FEFa)Zc#@=$UqgFwM3cv zJgVWozc8Ra=TDKwrKF}+Va`mI)$#lYxfN;sdSf0?SQdif4>E~#F>> z$B;=$v3!MUO{qx zY9L=fr8fyKI8rkT^olQn2-+s$53Fj~epWGEG2;BW9*7aAm>)bS!7cT1v2M4CX1GgE z)ZiDf+X(Oj;tjrT~^Y+XbnV zJ7n`12p<@)X8i_X<4iHcP-8SZOH0rEOu+&bQ2%IYWl%s@ORJs77|oxj@}DU#hC8u{ ze^q(Pu;d11t>-skua0B%S$=6vYj|oM`QFBe=7G4|=n9Pnnr4ynUKnlVG9!l)IAKjv z86lH(p(Q)%FEwS5PST-Op8{CuoL->i)bb*!pxI4E%QI<8ElU}LKHQ@juf;`ZPd%xq zq>KrC42ZA2R++5Kg~FlfO*X|fQE!`+Z{1=R!He$qp_?NF+}qW2L`d5o-te?L&TX-3 z%V;6=g}}pOr&)p>qbq%K58{SIn{{mLbjBvU-8q+jgQZ_}*akkZDgi<#?n$^E^1F6~ zf8vdN#4veuYAeI}j8s1ArhZFlywa|f)>At*psI1W(r(y{SSv?RYWKCKrGO91l@?{^ z%Vf!L@ebdViG$NJ2M{V9DdE*oa!;ZMz|fXA7tJ5Q@sRyBY^KeGdx0`b3khR?sW`ti z!-OJ_{4=>AgD;IH6)-Vl@z8A9=sdlvIK(nWb)xN92Cn86Ug?DLTXy<} zu30hjuRuEAT{cra_WF(8KUj;kB;U-yYboozG~Gnw7j+zhDg8a|aI~&-BftN_?Xo<- zi-WE^v(Op(D=$`8s$YQmf(HB@nKJAE`)r9|pNq$yCZ9I`HNYpnPaa#ynQ*u`xQVm_-OuC254{sgb(>LF1s?E%nO7N!maAj=td4BCXYDa3Ze}D?VkZVF z@<;G*Vq;QSH7l<;b{#~Ls_HXqHbmWksVa0Y)Xq<>y^~u^)kP|84VV=?RIh!&i>7w& z`=M=sDjpH?24Gd?o(wektHr8uwdboPia^ZI^{5&F?zR7~Usz$GJHV=ipBK5=?$0jOTBj^SuzenV! z+Z%d2R>A6D7y+^o_5tae_--=tjswfF_Ix+T zl#H&@1DuowLQFO7oEsOi$p#YRL{HhWyI&Eb8tj9bHo` z%|Uia-UL{C9jvSJSnI4`o>wwDDxS5Mo*-&Llv#~ zH;L8Wk5qYVH+D4SrzBeFno==#+Ox`o2_B%2b1Hzo=0Xqd!mDfB4vm9TWE(4p@$nsm zuVfdi^JRtNvv;$=(6N#_FB-C~y7W!s8&ha{su4YR_Ui{7%@t z>suE;N&meK?E|E`K1y#0P0FrgWA{d1#P#H=W8$+{0_;vBCk)Ia6@1kQ%5$ukNI0zYcA8|H6w0H-;wtaSex( z$c!}4#v1lOFR5~R<}@N-1#KD$3}pooLnQC&)RN#=aa_duD^+5(3wy~b$``H#;}>Mi zytp_7)`Rdn=?B>9s1szpeLpeN=#vNhBd*;6_N9Xzmsv)eaTnTPJ=DgVF}gj#v*>dF zMXfsD^g6#xb+a&3hS$t-pi=W`hcNq~>TsiP;4xXW4LnbFEOHFM!K zcI>p8X!C1puLn+506H8W|L+EXAeR30w4Q8OrK^bSLA873_!b(UgTP@>#l!7oHHgz^ zeD1&=7{=}6*Dl1l-@f;TEkyV(&MkBu@f1pMH3yu_bCdKPhk+>ebrwarPykn@1^Hzn)iS zXEoAa>=@trkwel<-cI!5@N1D%14pHw ztuXkfIK-a_*gO;rell7wN%h;9^4-iVSV2RyAqkD!AM$~gmYcqo5C9U?$9mZ5r!i&n zQ;wr2lcGj89!;8SkhEMtVJ{m4jV%9yk9KVO4QI~F>=$UD-7)4+6 zIh#080s!-A>o8K=EuAR>eTz+nV+u?mG4I31hYV(zUN(#NgOA6Nu~LXF9=xWwTrpu| z|6)ZdNneFc-y0{OJK{jIqexNGNLkhJlB9O7N_yve*}4%%{~AiOxDGR4+3*_fTKx;tZU|NPX1c=RgwV9>cCe%I0&-&xBHFW6II0}qV?yh! zzK=l>DLZev7UBblmryFoYd!TZf7W>nSbU@FEW^ck@4l1!0v?UITT?fud^9a4z?oJV z2A=Fekn5@OtwKD9AK%?V9?R~IjEdR6qRQL5Km_>7kZ*tiL+Vbwm=VLUE^7bg&Zl#u zcfV{S^fHkd9g}Wh8wI=lv^|T%et_6&&dUbxX$ItmRr7h>PD9y@3>%xf8kyufH*M#P$?wb2iW@?>}Ro^oR zkH86WSo24*Yy0hUuy9l)X}Px|n!@|vR@xg`vv{M45; zVZd5elU9y!>PQ`sU^J(;+Ye3;jvsJ<^`*WnsgEBBfDJ*1q{h#8LJBj1g`&YPocc0> zm7>NkampExfkjgGN*EABCoFY}3KrdC55o^*fu#*&L(eO@_#P;4WUb-}HalKnr8rNid+$E%=wP-48%`% zu7xue-j{33rg(JeQSkD*mu#o&wv+4?-ji*>$IC*`uhkfM3|I7u14PN$J)}!%>6nv08&N6sdf0If!HOF%Yl$ zeHbrM{5x?47JlDJ@?r)6R-&lb6t!rVH9nzkhbsO0(t4^wM!rs#`iOEpAm+Bo0-b`6 zH_dN|o0)>eN0kItNZWqgy+q3$dwG9V{4C}3$k zxlZzZZ5M2f6NEsr8wZPRU1|<*R@55*eT<4UZ5;W*Nwo{nv#1*UZG(`wFjI0Zg=9LGidxN@5+aIudDVH-Uid>q;l(aF z(&j#bUtu%0!I0a#ed)_Lmt+k4a2C|&z6GljM_YiyKHPOvGk7=Ch}Dg(weyU#`DRwu zSQM=Z1bR$bw9FUjX)m%9AF>nPga^Kahb$0!tF?FuB{11%^LApH2}xbo z{f3vDE=D9bx&+jCSSu=YMpL%nlcavYRt4#kWo}~gHibOL;Au~xQ$Fk(0JtnIUFm# zs53N=k&H4-hi*X;V#$YdlqRZEC!fz+WflNcNAyyc7VGFibPB0eYIBor#fzZHy7n^C z2Bl;;64NcsvskkRb?PAbkEagi2{6k-Y2}(T;Ab;l-CLLNW)e7U=btU`NJ7-oDWe|w zGeJ&t$Dz%ilNuG1636QDJ8WIT1=n2WCzWZzz>58SkZb$?sV=E!vNeM zJkzJES$MN$oVNyC_bocUJ(DR~U_Hv!O3u*fNAb1(b$NRReY`ju1!_J$I|X9$w6p%L z!HcW+NA^YqEq28V85-j&VDoY0amx>mMhx}`36IA1ra&HGDsg8us?_EK<;3yV17`>} zlcd|tVhU9Z_p;ws0Ta@3lY(HcGZqjSIMI)U6df)u-bzJ9xL27P7#OjSge0p-LZY2u zuY)||#bSzFZHKi3lBoymD9TBlJyyt(u>Hsc4jiAruqW`0Q)^E}&{+_^4xz;<6LYn0u|EnRSXONceI54(@s#}`kPI1|<^WTgB} zyzG4mN=p`|4Mu#%(AsxvrojFT4yCz5H>#^R`va~gb~Me zGI&q!o~r;m5D4eUd0I0<&MnKvVz#sO*arm&o$iZ$gq-Ktk=|y{qTvYqj3?)w9t|>; zxdXc>FuL(|k3P+8^W{Jp`!#6Y^yqgeJsS zutP}Fg*WE`h@KV=J=L})ED$@_h@I-j%y!}BdGQLqcm`fSL2O+hwy*rx2eiEV(h;zF zt$HM-x7khykK8SKomr~H%CD#n5TXl~i$N<$1hZYOs%JY+ihX5g0?7hoRM(R1wY~X0wc^%F7B|${1kffSo;rZ7PNFI*dRke z+`Pb5%}a8&e<-B6y!4NM55@)q=3J(FEXWaCUIyV>46d{ao@BzaAbgAb9=~DlZtZfR zZrQ3mA8Fm>pJF5N$Jo@2KjR(U^u5Hp#}Z$dVY$6HmegJWX7GkNM$Cc^fu|6)Gh;~L zaEz`^s9lTUl5&*8>hyk5_Z>+_e~n^| zLJL9;XeA;Y2RTGJo*gbvIC}3`#PI*$IGX8a9zE=kc>p5j_cM`hz$w5n!a2Yx;mAI4 z&pu!o`47N`Y$O7Qzjua!&H@JPQ|}eOWi|uo3=xX7KC0pPhYlJJpTKBAk~{zelLBuC z2Ac9(1%wT_wj`w$OihYp=#Mjk3KQr@LtvLNvPb?dKk|=)C1WgfL9>WL3)Atq2_L4f z;?5dV%3-$A<5~!j#s8R{UaTX}I%_?w0w|R%IJu@I{US9Tj$HMcp6lBA_q5gUHuK&6 z5B)D_Bj|C(wCvh_;hei7+hzKNI%|b#vewjdvdILX{$G&U`n;pK_Onby^ulB1a#HgN zrz?`+pB*;WD944`mT@<>mZ|a-VQB(JyR~FD4Sh?;x(0(GCt9zIc?BsGA4?g1?>UE- z@r~k^Gpx(4TALAOo}Evdk&Z1}HhRd%6=@BZDzpt&b09OU=#|FH`)9f$L$6{h>?y|~ zQ)3H&iU|^>pLUb2DmLM0{T>!KnGFiZ3a&1~kD@AGo)Psy(ASj9XzBx=<1cI@1CC2d)99GB}^3s}hqvXc(L$$qCi0J|( z=&U#hNaqwy^hM0rqj44LA}C?`(lE@0E!Vqc1!I~Dc9vsp!v=&skwBIom*Ex|fE~-x z)LbLa)bh4N_T1Q-ht?Z=x|Fyk)Z3&x8qPUjT`j+;-S+k^k<&JeJV)sc@d7z4nX{?U z%oL8(?m9v}ypHJu;X``6TOU8A;z9#j6(?UMDIXwN6Fp&9l7Cxm#djBAo2n@6O%Ua zx0aTOPTj)PQ*w7Omgo1w&l=m*{;{Jwf{rM{jJIqMr0MbWWGjlKpcDZ-v54S{@W&~# zEI0kRB7Z7ueko$RKR?T4BCbxXht$DTF*R%~|0=f#$0MiQlah#U?BXX^u9B16I$vn$ zJUMRB8y4qVBZa>Ulb^oB)XN4eg-DR8!5nqmk+Q~ni#f#+bCKA>o|UL)FFeL6xCl>% zX6*Pjy=XnDO3r}GcCWv~S{3+tEnk}eIYT8P`*U!9cHX2+f z!@H~`BFrBgLL`Ofc8Or4+vcv$3cMj|!ez`4NG*$Or^ zm{qsxmO~aDDi6U!l6-^e7l=`^Eh7c!`EyXmp@THAvPr2$L=!atsy_*hAXO5Y4L?15 zp;5kIuhd-+7PutbUGe}(vyjG}IjoYWEyd;=Qm~Q+OiwgD{Ze($Xr-aElTmc&83l^t z#UCagw-YWKuNWj@6zhG903PkUjo{7@x3Sadd&F-l-@gvsSR|lx^@EI5-GgyM-eE>c zb3~j4!G7R!Zws8ekn^0oD)DQ+Wax5V=kTE;bSL}mqKZV%-I@Rz8Fa^U=uT{qw^jPY z`IK-$u%Hx@s+eV%AZ}r+-#sM%aL5MY|I=}YMgIj{@`YxSc^if8>w2ayl&a&_#GHB# znaB@g+=W&es+j7;F2A=%NYDW;54OOub8x%5H_*WguNSI_!LJQ{w_ZEJ3x5*h=1w;5 z@nJvR1!s23mkGFW(7)_}pN)af$H8|O_f0GOXM6sQJRabKSni=!|Tkva}S?g{L z9Wl88_t3S6wpK~+<<`T9Hg}%H2dUo&8g!Ql-7yJUC!Z^?3JCW`J9X*TH~0is0i}fK zd2a&n%q&7oD8$|YR=s<0urH^vyZFEcod9@x9W^L=2X4h- zUBjS6S*KvgKLywgl1WA>4S7<2@6L?e$l(>9E$VO3`{xbwJ$WB-*PjjZ)D%*eUg=+Y zh6C*NfcXa4eg zo4ob^z*|1YC$*a3DcemzGJvfg>MH8@){>+qqyd`WYrRb3ABG$>eZ`UE0@&ebkzdF{ z4ue%*K~Yr<>2L8?T$&nQ!kW_FoULkOS7!l%~>qcl`#z8y+i+4*=8c(ZtI8Y6~yS zgE|K58Rt;#7m2B)gLbLk)?6BQp1@?jN=}Y-cOFPtnq4=iT?OIN_wq*v@&#CPI4T#qz=%5rv(^THH`TrAI_0_ins2fmgqD1(ql0U zL(w`CxFWLf!&`A9{b2^Y5ehQnQDO%ugrCaj zl~_Lo@jImSv;)}M4w-^&k5djjbq)`;#w;4$TQsGx2raE9HmUu&v0X784x0kawEiZ+ zAt%djGIahgb@7E}15_qvF* z^f`lPa&z>9sII7>CD$KbgJ`*P4g7cX4;!}g1 z_CLyna#H0ICW;x6-ETg^ONO4_oW(5@|2p&lctl(pLT<`uY+VoTCG>68CFaSClAzs^ zIf@mDHO}p_lr|<4S)S-qE^=0$ayjb*WNTYBfQNJRb4TqPQjeTNU$V9cKhLo(J9y{V zIRI8rk=&BzBM9VDLcgjW1|MbTpZ;sE8EPe)_OJ7pI4P!A=L6bI+9zfGzHvxhCj7Qw z6Z@F-61TCjqzGrHHy59GhyzQ%^uztndfLhSxF&e%nL3) z7iwe`S@Ky#H1R3vkW`<*i9vYuPye-sh$0_Z*`U;*i20(q^thQxKxIK#wJrvjO!f38>y$*NcP_R=_~VN3_zAg z$g@$+C)khweHZWNW~$NI?J=RoI{3AU4Mq?C8l3k!w9)OT)|ir9sOrR?w!aEtDylsVoO=n*8~YKr>XMGK#S)a=R&j1G{y z&Qnrhtod(&s|Jx(=>MRJjlFS10VM8oGlp6CNT^Fjv4_;+<4)kB_U3wa=X1&hLSOqq zclLy9bNB6S9yi9iO#gg7{gEmGnqmQ!Tmh!dfqH}^rC$8SA`joV4MH(G=XU<9MvWG` zGzOJ>Dcvo@_8QPN#hz{}+p~R~vBUwhIFh$^eB8az5NRptuTGNW!vDyx1-Ph@=i@6M zHKG-0fl=u&DP5-(TC&9~cb%9GvrXeSn4-)=F0lNxEplR`&SFl1s;Jj7?p9UYvk$t~ zgXNN(KP$)%A3MciU2^I~Z?)gW&Lz{-)C|+ABr^spzY$IeOpZm8B=Qbo&E*@_kzpD< zBrY?&8408UW+a`Ul!0?Q`gn4MHEQ(30CG*Q5d_8 zgQs8mNEgLC0xvKE{89JedUm7e5#o4sz9dalDf7zorN1TCqj*Bz(HkfUlUun39)!oa zJ6||wTnraierM+@kY8V4FMl2*zAA;o+ePFfyf9WRsOQ5+LhO(60l)ni~bde5$$Xs_LnosF%oAIe6n zj>oIB>TV&nd{Yri05hs}eWe4m;9j#`wrK4+U_l0#^>9~Jib!Ko24`crr9d7)1P`s9 z2NjeJ?j@e^F-R-(_88nibR9h)jOeT^Xp8l#$kl*FE16tV$Te?6$CBmQtb6=^E72Pb`(^+BpBd;u>Nm*AeQ+XWuGRCAt1F5CJK&qDC)>rchz zr7=Alk0ymy@aw;N*7l^b21lLpuFhbo+6i;bzcOMQGKoqf*KsxQde`>oC$5H@U>1l{ z*6C|X@o9wgqaPyX?p2Ha;MZ(c;ClPHa|{y${8N+o;Xp;PV< zk9?PTID(*lG9+G97*+cqJQ$T9-XRsn@F-boKgBQ`W2wE)Ua+9%4;YR%$RWsja7VSZ zfFX~ejG>63Dpu)KZIpVFV)6^D#cBpf3IwuGE;p~2 zKMA-UC0QGcac1RNK2Jo*yC>{Lt#(_AbQ1JN84sj{M$e7%^k)w0La zyS$|jA*DINh3RKGGQXO@}O$b7E5gmHRgX*yjhq*QSxvW zf3z-V>*JjXxxtt5}!kEOV!Gx5&z?#am_8fAQ3gvX25>(-Qn*G11Ba^x@4Jn5N*1b7$$W#ELh zT=7b0*cQa!GJry`!#tYVP?S%q=0x)(C}+2U207au=m-f+i-QoZqUPR_@Accc9rg|S z+y(T^rkq?ZbAW$ z)3Cm~^KsKv??CV~d<#NKxxSu7Aj|0W&%={{iVlJ$^+^|1T^d?z;#=zNFf0OX38wO- zov&y5Eak*h6_abbJYqHG>!2=`OVS7A7>BUgQi1RPiW!L*AIS6mhPsuQzh3{?;tysMB*m1K1;R+%dpH*Nmd`gUC<7%aFpD^9sNoHs(c8E`jz59 z+Pn0>Z1gaMKx{s00+&CJ#mIk~=Vw2D%=1bUwhKS84kL00EJ+C=3Wl&F*NC5_xL;m}4y_V91M z3ir@O`ov9-eM)4swWZcR2G)Iy*v>Wg@K9woMHDN>QR21K9f{uJ_IUT0W_Z88z ztbYMxoBrk6#~FiZf_S=N+{}@=Kn0ZS9o|@LI+SNPsqN(ZAwPuq>aZpN)iYD)X0z#M=)fzVbl3LGe=PyA`(N)i>=ha9x zx?;*`&lFVaQ-1?vPUnUm!EOFB1FoD6aQa=Y4l6(K4=z;z7oCd&vl3IAC)t*QAeEtr|!D?ZpCHLrjn=fNDt0A9V0-{7D&i=kGr>5* zGrk7iz>^YLKLR!b<=bB)>kOE%1O?1#Ff`jPQ_kS2UKUB`ky>mr(C#=KZC)2^kKFj5 z8bg=hu>~%LJGgd0e(Wus&JZCYzk{|FCFUyUJUeft2%tm^gs2_*&`Vg+RZ z(Y{oFNKhpJRW(6hQ3K40njUU^BoFFq@!PQl_zhDgV~hyQz!CF7IY-l!H*tcKzG_7x5i=?OFomQ|d>-o~way3?hXJINz%m|5y0vv$r zL*d-wDw-Q5UNL z#t+e~Yjia1XgiyX^adjjv@)lWA6tz7HQTw0)AWArcC*D%;NBzzY<0jJ!OY{m4N$1* zx-+0shJ4*Qe8C+bpa@d5L}DDsGaDfFT`_os2y|1CiFLjsc8O`niwDJg4)uJC`l$ya zZ6C~y($a8>;)!{JKt8wvR6-E`ARZgsagB!dr!wsNikzp8il$xJ~+Y#3Upc(N_Hm zWXXYIjaya%!Cz9sm5ID46Gu+)l(Z$PC;>`=Dn0|b#YaG^zsHYNMPe6vZ*2-`)VB=* zWu{6^gX@cgCPPP@EY!aq^&i9AZQylQ64OlO{$l_yG$Y&xFEa3I3@G{mS@H3d5D7jz zz=9`w%IiYxK)jK{LMT#Q{22KYK4;W(n7YQdXG?87+P& z!zJ*nRd9iPP{g66CQ0D#Ljkh2Go~?9w#&)jx8$4yyITSOAHjNejm2M^i(+8*Jh|p{ zv*`u@esnP+_Y2P`Wp9rm3*xF0rw4srSfiX6my%KDULBiyF-&RrJW+q<^h~+Uj2{C( zGLJK!89<3-VR+}speXd8aMr_(L;(AL!da`4Nm{19=~yXe0@vXe7@93NfhMj*NQjmf z?J!~`qhfm++^?V6*S|@-5Q{ZvM8{#7Gy=tq6v-!;1`W>P9!Ln6G&y8-@}t~~G9wEU z2Jgly1rrX3z`)q(enkc4oC3K(h`eCp(Hvs~V7HHtG$*k;+d2ZD4xSCWXSgqqEEDWj zw3g6rl)018y>j^7n}|Gf^1P1W0G`66+izlz^Dv5vz~JBP(o9z!_tlx_ZfTN0V5qBLr*uMFG;Du$PLr6(cvS=@)I~OCJrJ zeHr}Be*I8!klkGKYW?cZ7Gx6^cmNDaS}KNp^XI=+`yT}Xld^^aOn{m>_{RY_k>yAV zh>+v2P&6z7;bOT!3LGjhIw16i+t27qf%>Qz>uR<=-HkcZefNT|*A3+E*8#IpV2nj! zHF!vZz$J~0S}qSZ;($hJ1H{>)h@FIRnPX0U>_x>DZlRT?+Kcf~ml{TZ#s#$vJK|_e zZI59oR>Bet9^+}2*)5Y4%@w1TH(AbcN@>ImgHQj*YrDg~rRSX|7JvxKMSq6;;w6Cv zYGe^oHhLy_F$kq~`-0q&GsIZ8?3FM$ED3H`gqm0DZ|KeCB+i(P%}^@=clzXA?YKyU z!e_LqLzj+cXCL!E5hNDz{u1u=du3FGpEWsx&906eo6k=5qKL~bNmF*?X+mb(@deNK z{ZjSb(k2+-e$}=n513gzdH%i_lCO83lGlsN2{n2mOsYc>RkSBpW|MG}eaMjw)wrk- zht4PxUga8XR8d-6Vm4W1NUoV~EY{n<*?1vBRg&=e7I=7*NRB?N4lmn3uE`v5deWYU zCPgWrWK7)a7huLmr&=YtiAPbnZ!u43tpFam>bKp8`?rEpC7@8w{&!)hh>mWdKZ$PH zz6l!t0+=Cys~T3G^}oRT+N-bu8KCALApct&Bq5rGe*Um)HPQcX1l|4*FiZ-9I~dFl zaA@nlfJ0kLE1tBsn(BYAFhJB-lOs)V_~us;_;iGA#A}VhWuSkMLo3N@;n(9qz6kdU z^DI+VKZM&7W*_tSULmd@!tIqag~zEh{@ZL%$$xM|7f+IC90vW$#8XdeovR18iHnSaf@l+L4+`_Q;Hlv!M zKFnKuo#mlqa93;xPmeKLCWau)9OFcDW&+I0J2@MfG^fghE`|+}1|2u)#58SH^`Y(3 zr9W{B=1b|`+}hfQX^|gha7z#5gV7o!{q{zimWq+VP-9l6LfPRkuj%6A{-??CcZs>%k%(S5Ue zk`^eQP$r>rL}Vk@ade7s*8M{|M90NW`H;)tVUaX5(3h9}r? zl)qB-w!&N=!a4c_@oE_%AW{b=YzpjPc6JR2RL6lt`KB@cuq zO)fWfeu}?pohDGUvXEb^%s@190X8|nxO^z#lHr10ddO76P{;+cnTM1;&M z!ZwEKqvQJm+r#f2V1fL~D;DXHInugnj9zAzRd1DHu zy!5nS+yPji#IH5K&Qxpj*06u=9?q&6(59@x`Kc*xCtLIS{_7N)tZkc|3J+E33iTP=SqvU2xS%B+|hSj%x+5v9kG7nV1wH&+=2R5ek4N=p}!c1fd> zx5MuC_q#4clhmxX%+Pbm6egT}Mw*dUyfa1Qy+9@$0CqH)a#EuBHWB4iiDp%MR3DP4~3LI?Y$r=1?sGfzADpBuzw(yj6vmn*63 z^6Y%}!*+Xtc3R4_*HPDepz4^{|8Ie4lP_EvhIG$l<=vzxy6#2DWp|=?m!5%ZoACiW z?xS}-xBh~-6>UBF393;}=@_W2Y)D{KqmzlZQlG93SKxYrPo>D(La6Xc2v+HqO5{2F z2(>EhxR{9L{>pZ5+5S3=nQJsh;JPEkTCu9xjUs7MF^bQQxC)63cPX%(k3MQ#Y3WJh z?}2*~nrQrNuUWJn(PVshE{C2eVYdYwIiFsYtM1=8J3unq;I{Qa_lwX#VZ6 zuhnLdWENdQ>LkCkX}s8(zCc@LJHiM$k|@|OvrszHY|@X`@;`gDo@BX`CP#5RH8fY& z_CDs27E?)mR*kIQc7`pP>=M&X6ipfqY>l;xpXW2$36qN(vI|T zanrJpSrkH33cgZ0d=qK)_m5fUKOwGzBXgg6P{b9Q9W!4}8?Ve}VQLG>9nWGZrWw1# zcBL5`!}_EdJHxI?n_0sO0pj_#N=^hciT$uwC4Ozd0#i;V$blLw6sF4Hh^2jXZ1;k* zyo7f!Ibxvo3MFPh3WU9)N`wJQh2oJIgGovABgG{LF_RKQS&mJ}gLCFu*^i6JU!D1x zQ1|UnIERdhwo6*DqKqU|)Na0@=5Fg4;@YJ|L!}{^oM|KvDFy1)jM6T5^Ncw#B}BQ6 za`sHvVe!X}L$p|B5-7*SJJ?5ke^;?w=PF+oI=~kh;YR@{#tUGHDF^_#qjxFR5b%yb zP!=%8J}|d(-Y}yj_hi!gTDkis^lORN9V*N6vPFf4lY^rVP-`^&gB7EKk25eFEAFbm z0^V=SQyz2sw!vY+pk-j1mCiCKUs$QoGpJ$=E5jU{71pfFz4I*uL$Ds?eMJSe3iA@W z^MIpBO|?`Hnu^DH^<)7567|M&9nUSsrzYIiYyQlJ(&#Z0UvVrb=iQt^nSC;WqSni) zajdXV3TcrJ(SmiaA+#G1G4%F92>KbE=EbvF>`J#(_ zaHQTjlB);m>{g1ts0}os=?HF2Zh+wzBqdm-LyN-cGQ`UfW3B;d(&daXvO4$nH6n}i zA$)yL|4zwUE8+k8W0#NghP*~+p!xaHh7M_IwakTpAo~W%5|TMJ=(!VjB2+|(3@IA^ zHh6aOMmML~`6A<;8eH0ee)(NR;HZO;jKA+?wDq?1(- z4iUk}{0KiN2>1&i6JJS=z#tm8rO=CSkc5G9!F!MAak2<%>%K`Ozr>*_uZ6aOJ#=d?rSiTZx& z56Xu;b=MudhX7s0@lNJV=k0%;vJnEke#hi}{zzm-;FP%UpR-ptLSQVw0Y~&fVHLKf zxYBl#eEY8u@la4hzg&m{gu>=rNsU|yCgB7Q*CR|ZlN37xzgI9cit+du!A%E&y*bqR z(`;t5YoqI~oo>KCs9nZq3_O^43xcNo1o+=EAr?d-juie26xd_xpg)#f^|8QH#yhhy zf{bwWlpn#&m~%(4e@6ju-@=dhT?PtfM)H`U%w)~_!c84RoHg$L7-~?HP*|W(0%9?39&qO4gnsg6NS%5kWaBPr4je=bmoNr~^IqdHb;z3bQeF+s~AdC6P~z30@O; zEL6>DvFxmx+f8fK+e;QKPrRJQQYm8Xo@3CR%Fa_^>yg}(>g5ce0cpgp3JS#}lHmrOFcm(gn@&#_E&Zt@Tei38=pGYBnPQ4FCsco~8wTIUCX z1$7L>^5Qn~{R?Uh$`?&XHPg!o-mIU=cg*;JdkN?3=CJ(7Gi>WTxt9~(=qP@8~&4GhOpc@))E zM}xWLLQqun6V5<5g_eZ$kFQ$E5BrH04oV^vB$t%In{e<|0;VoizQ@co_8HxT5 zk8X4`y`J1mYx^NtoL7ANe5w6Zv+JL`OuY_k>7JV^=C4~H>9;mFjL15 zHzdcQnnw4=Y11)RpS%>)3JS@in43K|crq23ktd7{&tO6k7zx>CCr*x36S ztd3`_jrnOQDr!umvfKj)P&Zq+Q@u>;8f36Auq9(D0GI zY4W2e1P@`g^h6P1G_CQDM?)-%*i7z#wyNzw9B*CIULMut)h%3!uzn!&(FGWHpr5@E zad$$XCi7=y@Rsc2yKVn=!WL2U)c$&pelVTe(tny3@fgu0y9`iOIA2$-IG2q;Y)TYS zOHdi144060@EV=HvpTYNLpc@EwmBaBlr&4|+-B%anksmSCq4@bSQO1X2txGW)c@m_ zx}kD-D%i3cn#P-v!ItT+s0Wa~SSHNEK4?S8R;_gv&0({?FDPau#V*NiI&HsAW)H)q z6$)le%HWXp8^!RqjcPkA9HljD>UrM9)rn97RW=bB^ouV<_c|q z;%hx9x5=Gk{afYBCVC^~yk4f%o+~ehAwtj3W(2VlzR!shy}RL_eFLa_Y=xgu+R#`` z6MUt^&9yPQqD*c@=!lssBeOcFUxj7vZ#xpxp<7B{y@1*{2rIg#E)8 z=e5Hz&NivJsg_6C8G(O&`x5Hz(^T4wGK|1PC9!+gtn*Q!{dhj?{A?~J5aXGXbt0*>F^CH3=>(_?*k?dnX?9fQFz!EF zxUl5xy5MZXE#LHJ;k8DnCD=DLyBLT_a8{98BySov6iOk*%RYH#p1WlI&#EFamzg69 zXK8*HuUa;GuFxn8ta(Bb}u$1nI2>miN zqy-=zfJ%koEFzI?K?}WT>X56XUE?sb z3~0U^G_9&5Bq|{?mR>Sqr)LsMnwl-O*}PQCXp|Xj_ONK4imysr)oe@-HmAWzh^95| z6k}?(%&_&v*_?)ybrY~x;Xc~)(Ft8MGY6#bS!Iu7EBpILx0j14fz3=<~A{n)q6F(+8KRB1eW7R|1j$!3M3wgGZM zdSMvfJ%0@Th1L>8QAII+l^7saL1yqY))p@1n;`C>HU3lzV73rZih1^wsPG>fLGaVX z-`!2bbHA9*Ve$E@XgJzVGQT9`x52W^L(@~;TJ?VkJxJqThN^7;kukfZ^IU#6a==?$ z)x<)|$s?R&jDZcC_Fy4vKc34heF4lAup+`w632ytpUfqNh8)i&l&YP~y_9J`u|G=7 z!(iM0#=b*JcZmDw4y3cx+^|p6+@oF%pymiwyF2K6psSc7ek<9Qq*b zyQ_(Z7F?zvjIa?9M%&5@;_So*a`cxYMY)PBY>e47N}f&iRKx5=_4 zv6SxYPybawP>3BE$dHPE61!eKBIhF_J-&cLSl9Ov_`x%%&*4itJG(BuANaX5;FYWK z57=_c_7s>w_}Q}{g^lJu5lPNK3wH`r>;8cSt&|13W8(DveTC90i}g<7&TY;Uxe{sy zk4Io)Z5IEI5#=|SQ@e-kMi20he~piHS~Ruaznp5tx}>crty7*GGC{o>_+koAmqOKP z5BfP)asKOQT$jJBC_+zfHHU`d_&i@h;ZP+!cf=HKNl`Nn>6Qf5qp12SuwFFO&s)^5 zHV#!{KUk((W3N~CU6YL1tn`%^&jFLH;$Eq|w?v8xmvlMnz;j8lDFJBEE)w8ljP}t~ zHOiXWQ}sX?NPG-0cn_?ciQT8dr?k2DO&Ms_%-cNG(9J3T}~C11lL=0@~Wt|I+*mgdvUo3WuzcCPvN=Afz;Sv zjH}9a1YM#gm;B+}!vaVrqMmAM_S#o$QO`Cs_FAx8bOQNE{Zr~LCubCyicR{+Tqgsk zYI9clhW3t0c`gV#y5!4rZlE}O-YeV)NwCG2ZTI2$p9{1ngND(MjngrM%)UnCoeEjG zFIS$+6WPfzZVY&EoK}a?>m?X=^mUh1rJ<{pNK(LN@|1eYMib`68T`-yE5}W)5BJhO zpD!-6>t<_=Sgt5F^~!8XIE6+FAKag$IV+R*Rl4SosofzD3Ej{pK(w7BDY~7PRT_)x zYYr$m1i*DVNMqR-cW13h*D7;g1;V%dFUvP>UU&?G!7bNx$K&#ad!GmryZxL4x;_-*W>ke8@~TOX8>L zhvr9%bd9h|B~N}!9R>#C599@chp=~n{c?C0Ru_^S&I6Q~4~473z;b|%|1_lY%1SK+qe!+TOSPejQ#w<+iBl%ppM^IP z0Qu~Vt+Dn^4QpL_636}pNBABf-uHvwEkHP!VhapbRw#v1Y6Eb-2Wire?bbK`-dT z5L0(f)5cVUKecue;be*8TTlzqJC>mZg#~ zuKoAg&w7@=>x2I+sC5?{)lBNjy)_a?yKhrtGDu;-D4r{+KKirgp|}Bm^Y%OAwe|MW z8;Y5Agpt%A^?SU*FeA1lOk2#=M8Gt0uu+&D+DmG&oc=kzci6fs4Wxk;izRouBENa# zs~){T@^PNR{pn|4(NdBWFG8R2nGv?4f`5sEQZXX>Bc0B10CKUYUt_#c?X3*gLa}!4 zRlpJi4omhp#*&9>kGKj8aq8QiGbS`sTE9QOY1_R9wIOzCN86>$IrOY&27qPSWJY0sLRqgTc9wDJV@5c|nVG&lC^)7@8=9WZ-3Q&ZMt<*q zD$Tw=8Zr{`E67!^z@N;fQ|w}!GJzIGrInEb+N!0ycL)2!5s>WW>vV_>wHuv($&6sH~y^Q-XJ8el&Y&HbnPWl=bnnSi088f$?E>%Dg73S`)1w^-VUTA1xA z-gI4&nO}#D?JHalEw(#m3977eHJ#j&PcaVt3*uv%7jbO%_i&kp!nQcDOd@YwYI>Ui zbvGOt?cC4%D`vSW1G^3D-V8Il5;3JKPi$CJRtiB_{A(dx3lo?jX8<0bd4fpqIOfsH z5C?pMYjUwwvHag@{he^UgT2=X4y?!69Qgl)Xzs|4y!2&^c&?L;i&2kr&VYTfB?Y|pAxSP1o6rfW^3Ihyu1EsB3 z-cWErB^hvNfSQiOybSWkqE#}RU2v9&<>dB;NIOqRC#)2Pl68u{SO8EUU%pFhl?SwT zvx3XPk4rFYvk&~Irx*|5_$Wp%x#O#_bb{^Wl<%&CyM?=Z@5kdYYrv@Im}41E6M+@m z=F95#1RVIWv?AB4e;Gxp`w%o)O4`>*hqc4a6nxN5*zR$Uwq2J6=SAGCLM!Jnrm6Sr zS-tpB{IJM;iYZv2wRm})jhGH=%0cZP6p5nW}eF3_p|_H2A(2vST@4T z&K#juA$&KxGLT_e%TDY}l?0nqwbGeO^Flbr((-n8A4kF}0IHnfNTb z!(29Dz*8otWr1ukXqd2LNZIdn4=A%ULA+M!E7`JR?ItRx6tN_{#p&6$9CJFRglG9- z)nM_`Nij^2F@eON0RS)EnJ=M=8A{f@4az_FVZqANrIsR)w3 z--_~?FrPKY2CefP`1>vlzrMZ}(!h@87h_UJdJ`)l{9~YgKNl7Dkh?e>2&@@0+jD=Nj!3&uLndlS4K((4mK5B+8+h|&TVHtZk8`zqIU zNU+&0X?MU_eKxOAg=IeZ+(0 zrGt$^=#1x*in^_mXG1SV|0h^s8C@1ISN3HdW_b1TsIjSxS!|VFRxb;$5Fvz5%U-fO z7GE6hSLY>JMc@tNd{)!?P+crg7eT;HgEp0X{bRt zcS)Yg2w-h*{ENnEed;=?G=Mn->ls!Ndo5crW`@C9Tq7`kd#c-sK?iaC1qbZVO~oV6 zkZU7t9c;3*#eN1UJIDB{IVT5JSU46IhbH*Ux{^V3Q2!WNq`WdP#G9l!pBFx7WiXws zFMrDBBBWK=WOb!mhpEY&-bbLmyuFbF>)RR|JpkC*A-*LoH_ zKZKhDzjLO~U;~gN4MpaLX+m;z5(;u(04kM(h(+2cmd`QjLBBy)loKsei-9|m#9O0% zul`%68rwEGx9j9`Oy!ENdj9$>@}J?UX4^0{JO=8{4&_8ro&vsrH0|t>V7%|VPq5nK zwE(!aaWDT8PXWAvK`xc(?}PDtg&Aj<`A`>%`2ITSwGw#z z!StG|r}va_lV%(5V}Vb)Ahey-gAvjyvIc~y&&hHAtUaSk{;5)7EuDJ$+b%QVwW!dr zWxi`acBNa3S!ujZdKJ6n4Asi3&N?2^ddX|Wk+sBZP?>4SvFH5DLu3i~tE%z0U{9H0 zCI(jg{o%p`F6B8IATCZ6CQ#hk_MqDmJJQKcUx#ABjHKVumdN~@R!qc4qKVXHvK9bO z7E?pYD!I$ZnM}EvM*jZt?>_1N>$g@Qn@|2+a}cRTUcr0eFny%RI2y|Nu~LF+%we=d zv%v!)4d z0-TL&XN}SJ8IjT3YvQ&jtWet1#v;J6>cfqtf1y&OS*!*hT*`N0%alg4 znn>G{JOfRELjekcR%%#947k(E>l>N|HtHpm<35W^s?@r*GQxmR^gHOKrA)x$lJ-eQ z3Bw{|=m`S>f($}n-5)x)=L>(rgka}o!41s}gU;6qxhCR%w#j}WO%jO&Y<52tHT8fa z>$ZmrV4!!sALn3TWh4w)(8$3xdGv^Ibs_0;Kkz8GhJleG_G&-rP83t;An5~^)9aOlWG7~ffe%ilQ`tfH-4*72I@=i4|q?G#e5{E7XgXQ zTQ137B-Pm%st6*gi!aLHmSl|#$kXxAPN<4Iq+T^)i^UPN@W;ax#r%V#56pbxl27_b z{_#`xNKhXu!P|guxg)98o{C;SKnQ4w-kYvY1S&b8fVL?Gv`nV2j>+A(onW_Nao%(j{70|ut{ zv%K$?z}s@+w0)lq;MVMq#ld%S{L}w4I3YL-5gl3>8UZnm+jB)YFL)PGfy;BaKPFhC zTeXtvj`K+CR%zo6@4th}!mXc^HJ~=xH5l+Z0|dAL-G~rCC@M*YxN$`K%R&W*NM1Bfs% z^}8MEd34rc^DEyde_$Dzj>QBg+jDjzb&gsIjhTDZs!RqY>zqZc?d~h%zNB^Y?5W8* zIWid5C|ikKazz6tV6Yzl8KPdOEa{_r{&jHyY_=tOc+G-mo4MW(J0wZ@qx;8Z2w|(<-Ad*dD7=3Nr2WBiR}PQ(xGy zJ6*FjbzEOok;2QE;b$3h9uMqSFk@8M9u?O@k$W-X_xA=qfH9K~-!=;H!Im0w5!P%k zzdC%5U`~m(QF$5Vn9P}Gi@W{4hFyPwg;QnWd#Qf5o^1Z-S95 zG#Fhl_;2GjWLnW!fRswHAh90ZzXKbPY2g4rRu#~c(e*5N&Ql6fwhNuF5lP3)kWGw@ zeTh+b$V+gQLDi&)# zv-FA~=|O(vj3RoLMgwgtMp<9#$uYgS1zmEIjLdF zR8HwS94eAQsS=!1A&HB$Uu%b%Ad)Kz;lY?b8E;=-rk2nHjwDO8I`s_^i|+qRB1A6IH;qe{}J+if) zQ1ndSLz{_3yQ2GJN1np9FxBS!Sj?Q#qfJ3JM#BixW;ntMypqkIxC%wWLTo@b&ht^P zZPT0zlE%wco+7d`@Rc|l0eL_E!JqCn%{MDT$dRJ_K^OpnKvLXX5knlPdOqkX|!DU;k85IuF+Cw)kS zqdk2PyyNj3kp$t4fHR>4U(DPk6|kZEbdVEQP-a2W01;C3K?_yyqZP?jJg$6QEa*7<1kKWWE#6 zl3SgcMcHKPahS#Wnsb@W?Q(EfTf6zCYY27FSPL?a4W;&im+!7ADfcc!<@OWt_wWQ^5;YVcS;#_QY}YYHVS z!O)m|OFskbt@827CN_6ieb5|+g<^Wr0dsVC0n3_{_-!G}aK|OuB)5ULikJvzNb63e z^MVMYC{1k;E|PQ<$&!R~8G3`{3^xd4TapkoUFT|q0|&&O^S3!X?c@MJ{YsXA3WmQW z(3lx83(Ji?PYuel&}5MvpsD{2*Pyt}_%GoV; zY2zwM(Y=&dRJjV8qCkgMbh>DBTYJRa#>upi5Ethgr|p>3+}zFeyUAGYduKm8QV7Zm z`n3C?(oxrJkyJv)#t%0=%t{tSrnRKyXGy|aseD=nG$YvcBVkm4i)nSz^fze4--7oz zqL==C-aZj{&`uQNa6_i2n9Ucvf-bmrbZn!gL}5q4OboVv3(I*BiG($>cDFCXwWXHy9!=m0K%-hDODh#E7f2E24%RPB+Cf0TXxlwRPARrW+3-IGVG+G^*z>@s5 z9Z1N6h&qhagnY{H%=SNi3z3uarCWK}hS_^$<*d*+3=wT3UG+cV`7#y%qyJn{hmE9E zO>WPAo_Rjd{Wo;kWEozzIp0dQ+H-g8pa&0XF14mkM_(1#)8JQNSJr&oQJ_QvK4M64 z!_mrr0a!ZMSP)g7$05f)VEi}`&mZF$uH%cCd? zP?ps8b{D7V?ytLoekylP%iOh5#@Zf1YsjvKFj^Nt@4&rT#(R7ha-j!LY6b5m@FLVg zNbZ$U+RgnV36FIA7;UnF`QnGnp0vNH(~a*` zlacQ;K+{7P9zD5CYT9mAE3+tx72VC%OJAPh@G9FwGS)DcoZ92Wb&5cmnT84*kntWQ&IfQP6F=h*K z-D)lltQap?{DwOw9Yml#W>yBVRL&^~Z zP@^;Z1t^DB!Y-lL(5@ZT7=>mJ#0Bv6&Lz|Km(s9U{SJ;bCvO zm7et>L6I8>SQZIRlNJaC^B-KYy0QwI2KvVZCHW*Ov4pCSjny!&(6Uf-p^{yMk_z}T zvI@0!hxB5bX``%%L%G5#PVNiZ+gHDnqQw@j=6NIEv-p#{wP_KNe3f1D6`zLcfV_kU%dp(&nnYfD% zBc`yUu$GdFQuEY>{edw3JtGM0kqrn-qS9azHXBW--Wf-}+-qc;HKv7_?VF55KG7~W zcaHhGtd=(Y#hi@OTx(*1q7~qvMbe{V-yHX+m74)#O)J zcxSCc7dP;Fz>`!ZOc-1^WxV-}BZCRAnVaY#q$FAk+hjxg2tw8#MHb_NTyoQZDPx)7 z0lc5j7~veO2YjWR1y7tn=nR{XZ|0ff`fu1$!VxPd4w7Ahu;keNKV;Kdzk4f=)e}`W z%&>nhud&fJTV_#){@G2i9&4o@yF>{_Sgmt*U%zvd1^~(z}Jb8 zU4m!5Oe%j0RA~vELKdl;?WuUNs;4(NYABMK4E9jrypff$!>?t>MDv&R; zu>Gz28^d-(+bEG&icXE8i#E3FI=(Ec+U7L%1oFk7s5N&?_A(KydVL;Kr{J2T=51q9 zlkSrWCb=ePX?Eil%a?_78J&AGE;G!VJ}-JSlYrTgv~Mp5xBq?r`{ia@_tKspN<{DzrS|HIW?X5@Bim5%ftSogsn=svDc1yWSb+J>dQ1MBcX6g`l zF+c~joRsyro`ifty@GB0YWLznOZ)`bwRzD(Djt4BMVquHY=RUk?B&r3@bD@3k&&sh zsq(ogupUfS8Sl{wF8l45(td$#C9_C|@z{uI5!0!|anmmk&IzjCrI zzYYyna(hiP4|NLSNb96s6w6J!iDRj$pJl52!Gf>n*m4;oG7gZQ=qDy%4nc&EC=Ob3O`Vc=mZ8yCh&h_t5;*LK9<;0!YkG+u%e$VsZ%Rm+d@jH{6tB`2 z+J&+13bs|{M{k%A zu0gR=e2=F5u549_6A{v4pRRA{J^NipMElcU@m9F$*D$>?hPcin7v(E+h4v$lL}%qU ztp857qPx0*v4Kzspw*q=3+S+Wuh4-VAlXh6#=qP%aO!{kbF=0%0BscGGmg$?Y0?!hX;N2bm2lxN2fC}8^W>Qru_V!Lhaqbw=j{c zjwboPZ2bNgMDvQ9Rf|b<6~a5W6@p3T2h*LP--yHK;RD_m#9ae;pC9HNRopE}?bzxu zO#m}%EBfj%7jJ)I*0Z_-o^4J0>pn*wyNVY20A`3;+GrU~jhIkJkq`eRdI2jfUVQ^^~gnsdRTr zb2q4Qz{p|ztBkIAPawldRHuK8Xg9U=g#$Rk4%(yRtmhMH?-T10N#dGv8+po56u34L zsG)H}AQv)R7c4K2tJOn{EY_MZ2M*ONW`1zN4Kv9}I}6={Uv6qQ9SzLXseACI!$9nV(EGn=Vy9vag&X6>#ZU$(%O(~@Uopa-z! zx`;9}wHKMt%$25pz@AbLvH?XI=ikFb?eCqv_Plfz%4fJ){bJY_)H-?XGc$bc zuKOEP(GDfVilqiAK@5{pqM zbTw00o4Z5_GY>nK*CSsrB%zKDdIlW^Q{fQyDpG=l;qauWMu{G)o9wE*Hv*`_Mn@&% znX)Tqacqv&<4q)*o7fApD&TX-qsUMtn6xz%7*Sz8Gk+*gu;J(a#3n_Mn8m?i<|Et2 zj$86Wd2eRi5rYf;Opj5p-TuuqQ^#+@(_tQ>Qd*O&*bc*{ok>)Nnnr$302|O|tRk|p zqLLwLqL!gHLarc_-ly8_p%1984Vd2xx=qWtXL)i=-5O~;#F>&xAMwFyNqhcftG%!Q z2|}p2QSbuQJIGWUPbQ`*4)cRKf()D(FC7Y2)vy;4;iu*|g-nT21zd&1qO7O=oG|i# z#LiHsRj1Ll@;uy<^h+VMq5|~i4 z7?guz1l_Z+*U#cSuxd7wN_TY{)obK-`(CJm1)4ZNcSAWO_u?Fwt1cB%namp*UuGzYzU zUmVuW-n!nCgt@6XLjZIsPiMs*@P9l^<#jhXczoWH3QR53Y|}E-#>;r35LKRyb^Sme zqB8A5YFul}D~!55CN{@$S6wJ;!!uMpN_kFwdEq{(X`uKr$ou)3sr_j#yw^G3<3sQP z*7JS)_6b#MfAY^N7V;Pe#pf0$PabF2na`gr@rZ}YC+%=g%L|dDWSo^bw#&c zdb-~DduW_F4sX}+x69k!RpPQ0;7(FpP-<` z-hvA5<&14z*-7sKb)x&DxYpnEu34*fNDepB)$v0Od(KELK&hRnN7^=;_wqA?rLTlr zKd^M>dUF!!A=@J_@Yw0AbpxpbH|YKnm86Ic+iBd$`7*RWnU%)qaJhULUH5g7xk3Ie z6inEljByShddo%&VLGM%V?O}^O}_RAfB{v zjHMIwqoFa|_5L9HAgsWGg~`wpU*cZ%nNfki@!vT1EqJ#_uYy_;}2FJ&#XHcrv%sWj6K$EGS= zR!nxCtoa4N_8e`}o12IZ6FQZ{HB0l{jUu&o?&3#zMri?k4bF*XE}`3EvB=%q!qhBl zi6*XrPhT@yT+&3glJkak98Q?ExZ7}xmkF7Cx)*H;;lk5~xnfxbE-s{`+U^`XFH$Oxgpsm>HI`uRpSe)LE=+ zP01GxRev1>!iL>7JhI9D8oTBlL*^~r3~34pFWU_A{CSD#?(|ju3Ge+!fx@>dB9yu^ zxqMy9x}wqppJ>XXM>gO~8ghFqN&b)bMHYL&4+MLXk4^YY7yB}4#<(Rn1jY4%-#um! zX~+P`>9YxTa;YJo5FM`Okj4@+WZ|*Yku1bEAO=nH^1k%ho?j$Y$>cDEc8w83ivGYe z?L~nMjRzzr8Th&=pfB|6hs~IpF;saF%u_%(4uxGC0LHJ=eKW*wLHwZO4x>-}5j6^M zLE(8ZY=L-VN%}k5vqk%^gy#1iHc_z(7E_)p0rs*NG}-(arG8sn*~QlI@h?gHo!up; zV~!rgwSm@JGLPo5h%8%#=P3!6NTN$*Q|Q>+J6LWxjd@Yh52;%zkhabJhE(M~s2qPF}P80G=PF6z>``sCMj=#%>yR96Hf1h$<-7XmY zAn*#OJvdj6n(Bu~@HqS(Oe$lc?dVpQZA`La1(&&OcNsp8J7SQ+rEdIvL*w41eWCK+ z8C$*E!OdA<2fX&8@<3gL@8JI^D#(Gzp->3GEocZxAn_SEB0$ywG!HiVxy#2v2RVm% zv*ou1yLzBRLa2scSf%Dy|$<&sQtMuF@c@7rhLz z)cqv?ZL4R{vTC*;arID_Yri<+t<8A?(|=C>4VvBS6JS2R_TCXOPH$K_;Y&Yz7cYlH zkwbd-sc~bz4TD$TO!I16>@tBe;FM|MaxacogG+e0cv_NaS!N;O*T8WY%MEPA!+DRkx`CH;n*T27uaUn zGMz}5#ousS`r;s?I`$+8_$?0pK6ZMH9R9l(G;9)NwZ6v_=Hg4BhtH|oMS`gYWCfTe=!n#gvo2b2e203#`9pnt|%5=$RWxO z*V?eeCW7*P_KFVeyAnU)_^-g^RMjQpKPrj+>sI1F#!Z3!`da*^%d;UhBRMKHrd9a5 zrdKqn`HP;78kGVTo=#VQu~iD)0aFyTbmQ+Ih(INUB1{HWI>MosWkD2am0R@b)F`yv zUm7E|!_w7w;(%3n73g!Wg6UUA@d43X$0)6wTzUV7xv%h5ISOMqi#{1M9F~~&EVf85 zF1hR`UWp*Rivp-CRE!bd@2@LHp9(eD#X% zfiYe9nJ3_!tu0#E;mV9pNGZ?j3fHcGL-2?W`LDb0CV<$y2@h?tAiVy%=UGSS$MM2L zjBjtFSf_TdGrbo-#oQt6#Bf()hBn$k0?P%i;*$~~>VirXP6?$yHbZ*rsIM%A9*rh_ z+Xi!!ZUww7(qhX;96CjJV9!YH1)t_BD#k&W^;GWJ%%r|HNJ!l z&dbHugjzQc-T}=)lH-^(Az8%q$sNU$#e~PG$LiMJRl6isLSr^5ye<&DeYOGI9n3^q zJoXT6kvfuwP;hO25VKox{e{BAhU11S`L>QrhQo#nO5pL|4hKqa7`hBvvCtqm*kHw{ zlaRiEzCH;^pwcGDhd7c!zyOJ3L8Cgkk`P3IZ^h-PhEmj|g`hQ9LxgJcT)PvjabpZS zR-Pc4-bqrp2>vLlYk$;G!=Ye{d5_D%+iqTO&*zsbuy`CEBbJ+z-@aVe?NM`L5-g}6 zTG=^LC4Te+bgAY$y=Z85Nvd~Z>9F&YgAcwjx=djs)I=_V2PZ>mateDu=Y`G5NPGZd_=L``OuDKR=%tE)u-NQN!*5Q=UBJ8mECj zNckh$7e$iWyUArmuVoJ0TLjD}#uB;GwCBQjWhlb%GQMZFJqQ<*S;a(nuMpD#(s*4T z42#-q*UGL@Chn?ZI~6bx#qlf)L^|Y8673Tgr8%XE_5`6Xwn?mj3L6yKKJD>80%*VD zx|&e*(JX?28W;lUBRn;a%JY`iO>7)&9PBM@E$r@W_LggZ+De?Vett1)tO$a&dguJ_ zwE8UD%u^2YOKZ0@L=h$|fWa*%A9T?G!2W&F{OcnD#6w{Ks|+Dv00+_ZM62jBnFBBt z)<|2wL_O(`-*2imBkwH>+9YA`8m;34CWhau-)dKi=6J{BNIr~ z@V(;=Z2I1I--z%4x)_l4xa~BmzoOh9XRsGv(RShVqGl&1b-kt01#%?!BElh{IA8)O z_YQgT2@BpR2D28NSq}&ZZ%vzHsKF2^U`p<*8?`TP3163G0G`0d!Xg3@c9Hv{oXN{r z38fVa&xOz4oZs1OI)|I5mYd)CfUNHeNfyUruCGX`SRfX}dkIZbY$5&%U^92`I%LQ(+yuDvqm5d>3Az(co1xcGh_KO4q z=7;@r$ZbG}T*(R)DDYZ9-~faj=9$p_-B*jJ4Nbu%INiZXxP)YC=R-z{BlGJ>XwHR@ zj@avi@J4Hl%Yt+O2s@mPLJMuzMaYcD#ZHn9J(suhx3`D0y`OJSFkeO;$F{iG&B$|x zcWgpVSiiZ`cJ)croy{&^;50kg>S?i(dD%|!2O2oD(GW?=qNetTrh zfmLx^Fi6bw@+Sq3BHOU;@y^6~p4}<+&-3p_S*UnamHpqkZCatze&x+hN5v$5_G@0% ze^7#RikTFo3A)h`SzV>r^%;2YzHNMAG888pL--`cV<%1RHg&AmCxG%D11GG}_)1TB zgJ5T8nN|LIy1EdBuv7_PCaP~8Odz^awm1vb+aau%JnQvxzF$A(G#Q20r}#|8d#0N0 zsa83uFP0&lqOMq<4moT~$fGHM(5A5;%}Cc(^i}49iWmIzcl^hYH+6M3^)(?a9rek{ z9;MJraAZZLYPPhv=tJ$SuD!zB{L$~Cd^o!VJt+RGu{D8nsIF=GMF;1wV9fBVgr}IF ze%APM1!$tkgP8Pf7=v~ecSxIyt~;Idm<(u7|NBKiv{Q8n%uak}i%78B zaJllhKy}X7>Ft7j&}{nxdUR#FFLB|=^i1}RwEBq_3zmCf`|WTl&3FtQOmAgWkRq(p zNL?PijE+=l7e?CQn)6QA{zRD_zeZmlCSroiWuH_;9p9(_Q|hdjCQmE^ zUDdjf{{mft4ly0zZ%JWVVMLH-Oj~Mt`PbMmsqex}b|Nw4nMNL#pib!6jBSNSR{-NS zf=XC+9Uvx zX4^$5?l5$K2egY=sKMdwxlyG2?nP39-v zjYs_T)8C3nhSuoui5M)+8q%6s#H;zb{&IV-JR4gA7RNHJ%&y5>d32_AaJ64LXOzMG zB$$mTs|u|9S)$AZ5|<{-xmONlwT@>r2BR{yiLY$?R6nVm_hNNfs|=>XB8IuRrJ@uW zX`3fQMtF!5E{zV31wOHv;z29Sq11IT!EN{(knp683ULdcGOKo4+xE&sH7s8GvNU$x z@_sS_`XE>j6CJFCvgGQwS`%F5LjniY+rpW5ou(Fv+7aHE6CzR|A|do?nH;A)u4(@! zdrI|%pc|W$jSIhIGlCE1kM<<07+^m7JW-BQGeN6ksh-rZGKIfF-^Ce^zi}L4wEgH` z>BH8o?qhG$4+M*G08dm3iL}E`brcK?~YDw zW4Y(IzV+tk_d7Al31w1%9e4~$c2sBt%Usb?Q3d`h6iqSiyN2|Hqieb@AAx7(-5yum z=R%wU&IS31LSe-n87(ZQh|O-OM%Yv2HI-Ky0c%ro#&yQrZ`xyVnl9qlSu70PM69py zw(7_YUfJgu=tSLUK?uzdERA3if0J7_}^#&#oDKys&Tl zHmdJVj8f|)G^uQnIXK(YjufmbEPs@!9yzIPG$PrQ{3&+Zn&V#E zPHsRNB>AICy?>4)2^~7=F^C0^4er=_7 zhafIjYL1mUrDdq^t9>X1&Xxquq8O+|KZXnUMO9D!sZPi{ zHq=)(qxIAGLS5r=<(IELDMwtl{Me2%o#u<*oZ{;>=$G4);lIm*ezA< zdqDVAAMwHYmJFAttB`Gfqtl9XYQY+_W%Ag1P|OI^tEHZbkCvz%-F~0S0oqZ}kfQ%1 zmQkI4ZdUXQcowvf@skC?uK=azi0xS@(PGi3PBfnS9h;OYx6#qxECq;a=A+qwy0u zDcgoPyq&Am7Q?!61F91f<~yZ%o9r{STBleiiwLb`(k=%Lf$n6zxQr9{@wX`>ylxcZ z@GQhu{J-*D=XJY|he-dO5LE3%xHW=o7x0hm7=Qs`ptw<~{~yI60q?kdLudoN(%c;0 zxBjmjdts!AKY87k^cS9?VfK7at2btFfq%^P>L)?m!ad;-R)DU%}({7+ux0FQ1K%pGs&S>tkL&6 z<;~YeB?WI&PmMAaD8b!MMqNof&%}HOM~T*5y3I%6T~LO7Q9LBSL?}@m%^?3 zyrxXJpRE?fId@?-6Gt1&-{kgzsTOs;1paZd&%>}3zY<+Ktr#emCiT((+&`(5bkm9d z)R-I3KqdNZEX}aW$+?mEj;69Amn|bMi&$&H(1P~K26abdDY|QvB@7KV=Pp%7=wOQ= zZxg*;-Y>vME>L0(#Pw0JEI}@*6aCuyqfK6W8*xa*5b?nf0Lu^UL9piX%j(KM7#cy~ z3GTnms)R{3aRw6Mu%rC5ujhX^0!Or= z0x^%m{bI0#U)fU!q=dSMkZU^>Dl-P;h`ln@E7A+kwB<8`(BmL)cG1H%8X*R4XlK=s zQ$(t*UkX@bW@ZRt*pxKM>fnQaG=rxJQ}wIiSY2(d<{;xFp)1YT%dhH0u}mr-sHQv% zr*O-UiB2foG7LHxnDPr)Ebd)UCN+IUcaaIps7&|ptlVby<$TQ+Fup$`L-P+{f#p#UOn{pGg$Pu_R(|WS*+L35Z!PxjOqF&CO}x_l z`QeJzOvPD!;P%LR=?X{%t6`1Q);5F}>o&uzvtpP1Z+?} zuCX)9=7=gTwJ5_1_S1WH)XYC0da`@5lp)cuz}JRY@Y^BOI>sly_MQle9BESNpjv`M|^qYcSXEYM&5v2nT%&fEP}n^$8Q6KEYC1* zNGoq*zDVu8<0B%eBk_djNl7v^H?H9oUzzZ;wTM{qmY-n%f!8>kN86H@ zr$=x_kri<(`^<{(9bh{$oI8?X!K!~|mCZlJ)z|fBp6k(e#+LP5mjh zC=~P_FfEjO*!*P-kob|L>{UZH3wiVE|0u=eRUW^eSTl}k{AW2bK^?nuW%{L_h=iAb zR&zKr-k1y^*6#?;IjH*YMgt8#0TM=QB`Az!dz8?cFEl$B^iq6|`JI6I^|ihhx@2s(49#U5Ih{s{)PX zuQ!{d9@*FDdHEq3&)Sg3AUIyQS&l{6UgHJ9WiI8O{}-^^FI@r zU%q`I`9=cvNn4<;01{{q|EGfePjL%$g`ogX;~|Ivx5@(A)_n?=oG>Y{CB%?e6Y6oo zPUsNa`H>z{l=_!pIrWe`s3AjneSu`qLnP2Nh^ay%R^GeuTZ+P6D{j&SL86IgkL;K4 z8(EK8@8|J(0LUvSd#0+#q(H{zo%dNkLeLgEQ5@J$Cftj0&1acnvK6$6-kcjIR2|R` zmrz`QM90RClcHGSH(5h?&RpbDh^zunm60F4tMIh3?t;G)W8Q;N0!Orqnd9Gd zcF+_ss>#)P2p(LM?5~;_=b8`PF(6a;xEyityBRS=E8lw=TSm4{iYrxcE}5s;GS9&U zcKnBS`32*DjHJ3JT|7gJT$ZkF-Eb+eEhUu#?sy|F;EN&}CIEpQ>7>hkH4i${-y3M5 zAN<~5-L!+BT*t^V-+gxz6)w*SBXad^{D+i2YxVy`TuKCGVxV?2{s=oBRW84u)=#lp zJ*ztE9{__4R`9Utp7-vIDpRIbxxxu^LDE`A&J5Re`Pl+RmZcwO27#@)i7nQ9pTV{W zVA0x!9mJxNbeqj=yy>;^QLo;~!A~SjwBpoAE?$E+@NuD%tXyRAsXWsz+x&lAy#se7 zT-z)>v2EM7ZB1-@!ik-9Y}+%jZQHgpvF!=JzMtoP&-u>1R`(z1wY&CJwd<sla+RA=j_9XMAU7urg+ z=gc|QKMcFuR}&AU+p}hcmT=c|ud2aevf`{A6VY2WH`c26Pih@lZjW(DF+&< zwi6&t{NU?8RvolRVsoMgJjHlUZ4NMG6cZU|tw`>D253Devl;8XssC`itJ2SeasU*y zggIvXrL-WMB4Nf^m(r&ANbD3>{3c_k=Pw;!3#v}HjJ-BrDj&-B0W?L|sK+BYp!1lg zYePlX$_}w|cKsgO4PSuq&wJ*?9^k!c5hinSDXg=|)9_A4*zNLZjD+=ks zD2>2@7!1ns8Nnj3yEEr0DQl@wQ=?;8pr@i+uz4~jEy;JkQ~hgXB!am~(@6r?0~DGi zsmNJX5fOvWbNa9Aycz52$TH8uN>}l_FpgoQ(swvsBaktDC$M~_;yx=tT7n{Uk=*#6 z;~3xlmy0L%_^KF$WIba!1DJNbEpY5Ec)j+1yR!f1n_jP7XcPvZ>V$gC22bKj9qdmT zuex$&M~wMMk_1hlD=>KK)~mOo8jyZm&q-%Cp#Fij=_tVgG3;=}!=e(-LO#QnTfoSQ zKc1%fmzSx1QH(nqB2~zstk|><)aW!Jg{TW1hA*Cij3r4 znXX}<=Qhei(}yqk>%HYj9lP*V!8?|G@Tez3SfS z+C!O{tL&`Snz_@?$EkvC#N9b;L(1EISejDn-C9x#(Y>u7PC4GFMCa$4`0gHZ!Sv== zrTi1^tA}R#=b{AO?U38)Iuy&azWcOtAZx-%e256VWg;~*eB)(0CqO@UWDFl6Up2WG zgOO&r+$j7oOg4GAYmX+nh$T=N?&lsu`}N)er2AoR-Rv@Ys=hHFpk<%{dF~+AJKlmIAPhH)aNZ zDh64zsN>n={L0__0f4>R;JU(k!8pOJD$ZBHz(B%ry2{*gogtv>J`#=MMv)}9E?L8Z zy79?~!?o{bQa-@>=yx~PwYn(M5#)i&p+JUOV9L2UVR))AXZ@2TV+kdiCEIuVEv+UM91~EjqCUw1@_p&Y z5BwZEk8y1@il18vh$&BZ-`lJbC2~?|_;S;&Dj6b-4AKnKrfMAA1E6BJxscwTO_~Ie zzP<@Cmv|I$PMs?>xs2V5GhaE;Ky)=9y-O;gpvC&R7s9m74)eT4Uempb-gvoCQAk>q z4h}qxo+5$F;Wf&kDxd&3BIa+%GqM`9D6NsFFr5hE;&CjH67U$`1I2_+83&*m-AFvESV%^#gWb>$r)MMrFi^&2g zkL=SLPV7J)FCk23)QWlJNPZl$i8t+MP_G*rZ!+=^-V&r!SIYzFs^zo5uVUw}dg(k; zJYocAC%vDv-tT`JSwl?#wQvuC{$C{=kjpZ*hIH9JZ1{3=LdERHKjk&D($jOz7%EVJ zstw5Y_GZCP&PSZ@s_zL)eBzI-*!YZ_Ql#D5F9gFa(u16Ey3EBKvoKzSyFMP+f8ftK zhfigv;Sh@wBH@7cTY!gx~E1tcU$sI z9EW0Jzm8Y8=;>j6CXQg>yW_7McORk(?Z2`iYzRs*=kCnAx}3m|*i`@2{qE?Rv+3ls z%d^RtiVs0k6)E3GY?FeaTqg0#)i$yM4#Nt61$f*Wo-Z$bIoA1`B8eLY-&hc2%x-9J zejC|3LNgBIwD^pR@#nF)O%u)FcaFamaV)*q6|oO4FJg;`7?s$jVIBE^$6pFM2_9=* z%um~R%FyZeS&=fdOYf-3p;E0e(G_HQCX>ACAwL2; zT5`m;e1SduC(*)`%g@fR82n71*QM#STbhB3-}lk$zIkpIrFm`*YsEM@dZ#hxGHgxv zzN{6b*rwcow|uVXMDd8R5GN|nt@d-6EJm~@N!oTjc!Hwx^eAK?L^=Q=lDoT!Qg*tX zf}#BK#lFibJESUwMmP2!h=loRuw=M2RpsCv;GMcI754E~mq`=>@F&c?_xuMU6Li`S zxcjqe+mZtf@SN=jD#C42z1+zI^?vMTd#co#G z`9{~s7c#=#4Tmvp^megi+Ib+v;roiM@O3m>OLU zK5-0;N$q0GdPU6#f3V;%n3z~6b5w;w2Xsk!xI6#qCOl=!E`AZKaE~bWWZ~BH2p9Kh zxZ!L3nGkM=*_;PZp!<#Xz~A?Ghq)VP(MHgLGIjn-+%od1<1eo5kxl$3zQN`O)HMp) zNR@C3#D5SH6o`j$%PKZYK|F7E$9Nb#1ztICpsA`SIKW`}0wysSEi&!E8Pu_BJ!hR7#DM$=^DG5kEZ7KJI>R_a%nkIs?z) zYeL3m({yh8N(AHHtVsW9;v4wUNM#B*q)Ui3r%wKI8-Gh!-LtNxS)`ty+NLgSE%#^9 z14zfi+J@dC;K+T@25njYWCJ?fgT$p+pOA*ZacvTY`S1Q96FHY_DVh{5D3>O=1eJg# zR5!PrQ|ImV1x)Om_?BTW^M2jyRKQn%_u@^tB^;2i*y7nSy^`YJzQ3n7*E*0kG^@LQuu{5mSx_*Dem+LtW4ULngjML;XP#Ax=?uF7@gPvySy zVmZ1`^zNnrBxmrEZ#9p)E->Cf;pZ?bD7>u^eE#;UIIc}ZoD{Jax}VSRPU}cAV*6kSg~H^vc#S4Y*N#4#5?o^ay0erwl|=yds?ApSEbXsbLJn8 zHqo_kJ?_fZ4?8e{G$HVRIa&eWe@NO%l!3Cl-ESO5yI2#3Fw*dme>mDYkfXr@IT|l3 z=GL6U|8O+ayB}F4^Dhz(`6Zs*t2<#Kf8ME{y!j8sM2PzTWG)7AW1e~qrl1~pb(tlH z?lD*qGh!ldAi;;3@2!q;cmANJ@{Q?aJ(ZcK;AJq+{Rz;bh|5@jaD!Uf2n9qQuGN+Y zLoD9Idjy*+ou~h%SM^=%M4Nwd*?+q@q2FShzy7IkjkqAO-!Lx~`&E?OEt}263sJ~0 z-vAf&C;tGS=@a(cCi!B22ujN2KPY#4_r|^6Md&4RXttZR5I|ft2cHs+J<2;qS5mYPw4$bSX ztUqNg;thQ67KrMPysjXakj(x-QJK6-=7QQ%=BzR2j7rP9ww`bQ?|+XBssHysR)N+3 zV-@(1B!ZlVoez!#K=^=$ki7+a7Y+#Y7yU*+Afa3tq*_wCz`9jyWRL_Um`N#bFh8e1 z@@sFLfzDEon;;d~bC^XLsXHN`==`VcIrrK1?!QgYyC4H(6E<0_N}Z2m2i2F}z$Qdy z#q1mD_HniTYiT*^`=%K?sSC%Yau^I=5y|Ms5vx1H zE_eU5QMj> z;J!Xf$stDf&>otqFcJjVHsE@5s9)KdU0y}gCz7=^II4eLOKZ$sf-P&9k)Jt=-fgHk z^(k!a%O7JM>su%rF(9UGQwrTQOk+ug5_oW~0L*I`!dIf!#F95drAj}!lEfUeN*7>b z)!d+Y?f_exDX=B!noFssDysbHb)RhaM#|?geh#>)zIb<@BCA$+3Woc|y&%`@E z0!CGWbsn(hTx(`WqxmJd8{ZK^7W}+Yx=+IwS(72}96^Sa!C|8_sS=McL>a8QUDls% z79A)k_e1?$GPu_Tmw&L!r58s+$dkxvkw*Jfc=q$};_rF^NS=vo7^Fy!}_1=IWOCNE6I^Gca3xbltEjKAjs-82H zN@f1~*QA{>G-@FOJjxm1X>l^ZYXq?bsO)`D1Ljr?sp>2K)2_FWYEKh_30~*7Q(pS} zq+Bty97ZIwlEy@bf<+LaLky>#uVXEv>Sgci#_%Lb8O`^;k4U0ZHxk*G1lT=ve4dq~h1*R`vcR9D-B}u=|V|~Xj)Guo+keE-)osB(@N*UZp@SWpv zm;wl4Z15vQ;|&Ki_hMUjbk5}XS5!CDHPP{#lFTS!cvJ4?W;`S9;XGmKlrXISK(HPi zbyUyJjFkaL!lMeoGvO#8KRALervU@K0#;d$uU&>syOr~kk;&R2HbEh@Ji5Eb3?(h= z^BMhSV1N8$)anWTD0|8tTQCR>Aj5>2i3C(#dXi3~!(obbB+Vmj?2G)qY?;4U6(hCF zby-lNF0jMEc|(e2NU?J(Y({{9ZZIQiZm>m?Qtqb~yG>A==QmE*=3d5Sp;d3GYt`<< zrZrDyp1!$h+^<(MuMJhl5oCC8xy^CXz>qhwhUdsOPUo+zV}yTh+hrfqTb)^u8wZ#} zVQVp|{y25^W?i^qQHvEq3q1vJw{MVHz*ZzMVGr|#dUv@J_8jPftSzOg?RnzbN0^+!jpq6HQP>nXQFlj1pq`L?~KOJ)B8@VPR9D>oWiHC)H)#Z0~X@F?b0)Me&)`2~n^FX|u-Bl+F@f z{(;uu5qeL4-zw{tapNq$L9ys)7tayqndp4*D=)p_XS_QLFw4-lv?JN8Z)oVx|BIiy zM=gBkz(W@T`A=es1VGggc+!x6b)`OeB|CM2s@w>L|L$KBL^e$brXI|U43;#MW|!-z z(yjJ3bFT^D5{y#pezovn4we!M`!&Gr&H$hdC1#>@zt76a$;rt1n2Iy}(+$?k<^aQA z_SY`WM#B9`pZ0A2*ww)Dsv3*EO{vvM zH>yy2Hc=4p(eI_imeB%)))0$laWFmt{94V?jsvV017L7HNg^FFtR@4^0oh4lSYZ9E^&{n#KCPM{0+Y~lCmN=l!bRROMaf&_Z9J&<+ zD;(R&8(_#5BEsBZ;tG1ILkxU3RsYczC(=PNy`cXo!WyR>5~fkJeshXdDN^To_*7kz z=zz44(}ax8<8EdQ^_EtCN6ASNpYG$thMd`=t?kmfH~N{f5Yg-S*ZKKi+t>cI9$8-S znc4t1O@qU0thNIDt_%5kIz*9ppBQnDdk6+z7yxR*j1`Mbz6)XkdTK^0I4DGP&G2dt zYYtDC*XY0zBy}xDcvL{#Q0u=c-VxFV)k3T>ENcucG@5LTeZgwhw+5O|3`M5P36Y((JG=6VXg~kZ&~0jJn$fLLw;wHDe(byJqc!|M@@XCy>b>LJx@6`m zHI{CKea&7t&c1%$>Zv*2`1SQh;a~8QY^=v|4>MJlvS}^K!kStJFmHrcM0eq;z;Ww8 z0w!>@O3P~_1`avz?QLSpOu z^xlb0)+b<7$e|ks+_0D&y(U|kqfKmT*P;hhVTYbl$6Cz$%)3zP>zAnV;pf#elfu6_ z6&Kh@nzTuiVk5S|ODK{f^u<(_6@I#fZk?fOI`=&;L>3+J5SVeVrj>I}IuIlrnVj@a zQ=6QawdRNZgwbS{mXL7&yGS~a+b#8a4vi(o00oaYx0y76&gTTs5XvAt_R3Ifod$_ULJy1o&97sp;Iwx~zMgf<#x(GjHWiS#5iTgpbDm}ylSo($ zyLp$mIT$$(XF|H`78*9sXg6A(f8Ok);hcIPEZAlSsFU>_&m@ToCwJA=zJec*s?LLT zk~(nW2ywJTcZUuc7kN@s&_6E!Wihe>^fcwQXW<7Q!%dgR=aOu%7*-`roX+!dCwD16batEV38WUG<_Q1~eh4nY8ih9^ShdzTn&sAOc&Z8n%$ zIxk~7_psLoeE{0|}W`}Z;!+{PcQ-%3`!QX7| zWR70kW)d|nqu?=eusDf!y0%bKQfx^HYykVy{+lDXtdw3Pia5$V)TT42-o5_2ZUNgQ zfXg;zika&yJerz&a(Ll~?}wa6aU50am7Z#x%neW;0H@LnUP?)CS zDPN_egStp5!z|?lqW!vRJ)=-v>+i|0P5ecy-9aDdqTZQp&XCzzng#VKuSyP>GRTp#QU7NxX-SY+c6~#GDO|9w3bHA|SdlXzpYw_{HON`|gR}9jK1*;ESWAiSg|E?IMwi z0D-^kjWqH;@O2Gg>oklt`U=)Kd#YBW`J_pR^SG(PgLhVYjQH37koBI>63b|)xY&!d zI1>SX@QNd%fcTj~rwCbC2$vQ89@F+)oIrZd9vbfR+@;X$R@yXiGWFnu%zMJ;O$qsD zv}U5m_gH;r>|=1!zbQm8X7Hce%?bnM zo*L<@7>g+KQXor@z3spI4>5w^ELg&NCA(S8e83jv=!l@{)on|P3E3P^loSJWQe&tG zh9B{CI~^4o#Eqtn5jut-hvSWiG5|-gPq}xz#r3H|r7m~Xuuuy$Rp9iR*u~{*sYkqs z4Z-bpT$z+;53^=`)eZ!q)lW6~J-8}c{Z(d*v{eOjT|T4!SYBmmge3h!-Z52AP@UW7 zM#L5`jiHryHeqMQh7rEQ`l>Huiq?zs>8Dt6y&vz;W%lq0pNrE{1S{*doB$ZxnC0@U zRD-)(R+o zJ%|%#AV^b$^c;kUYYST)h^~VX4yMG_Tb4+a2|t-hjLU?KUg_(_GyyatSz{}Hu#^wp z(7k0x5KaqFO|cw!YT7S4*MP-mgY+^N>hp7d$G&Qy;oL&|SwSdj6o8=;H4woi(h8 zH~<&V2D*`UK6t2k5pE)Get}LHgz%n*akP^Y0&7PPP#fX1@dW&73Z64EuP}E2(>*6} z{SgFnWb0NtefA*Umvq6h#t0K|t9UTTeA?>vqXY~?LOJAL4>&29R4Y9Iz~g3Fu!Pv8cLPp>Yt zgj0!B^GgPGno-*ZW^qr@HMa^AN>4;x*AqvJ5mrwR$roJZ;1*bT@~#2S-Ak`5&ecGg zxyLsoB!34F@G}s4M`{O;N#jkx2>0k`{^%|pViGpzPe|2LMAh~Gnq4oHm||3{DU$$&&j zd&&4GNA!OZ8jG=H<=WQs9|H@1`{Qc?>|OLn7$F3B;*}RK-x`x1N4caHf5=goFKFuEh(qXQls? z^e$7t9Z@zZ>LHvEH$$lkpxT$G$s4R)lQ|9WCWVFvR9zqnrGsP1a3K^mhn|n#0SvkI ztnA&BcT+(NyM|g+FU=jE|K29V=1(%;30s*Hu`H&=vai)e%x@jtNn)6mYA{FMlGfLB zzNGAKTOAwrvkwg3(qbnjL4RN|lpOz#WGjs^hI9=*bz`azn4ivU?8nkT7Hg~hRbubF z1_8M|fvz*YDQvz@5PCMpVNv?A1USDWytFpvxT6^G7=f*6q1?kVp(FOLuWIy34b^4k zxlz-vGOx#lHYM*<=T*-1xQiIy#+^~MQ>W%iRz~m4kGR^+$KI4c3?X5$EsrLZEM28D zYZ~Pfb?R1r551ki-pVfX=^ZraQu292EW)MKwBI}+V$tn=t5no0>hRw*lY+P}G-n>< zxYHumCZUsRXpe@hMkwH^PRb_x(vIYLhV{fkz&bwN35<$rJutcYm#gUDdrY?*@K{}f z|D(7trvWk`(SZ*|6ZQ+j=mPtN5&MN@y6f{$*Qts0y(DnpYV=Ap zAmXoHm!aRNXXrFYcPpIF#gs9G6!rGgtsGJor{ohWhXxGq5Z(wri&pb)S9F1)q?0{S`S%$RDwXBC^M);5|n07N5 zG-)|E;S+5~Ecg(_>Ya)R|8~oyB$f{_tJ>tGG?}83YMx(X4}(>MqU36DY@k>iu8${bCKa$2pm6?IBMHs>Cw#AoHHYLgPlH5JoZ^ z@FxTWoqm|VWIM=-DHBGPn*vo&h4L;Tcb~;ZTwCY9Cd^97YHf#m@{!DDyEX{Xp_mkf zl_r>!lSvY7Lgo~>=*w8Na{Ef354H4B#$_{)S3t{0D?6haKgRok&}+sDJ1TtKr(H6( ztfVCA_o-A1>Zqh%K@KPD6YpQo2XErRfi``$pEW6rJ;-nT2r)#DqWXgjq2r#R#;=JJ zL5vDhq*E$x5{8dOsor@Wew?-N6IhCd_rX&A;RjR=ku}NE%c9jy#7k=t3*^X5=F%8b zaRAZIF7$5UO9{a&nS*^jE|qN2WKV+F;x<{k;(yJ69|oA~Zogo%9Em5IVtP7BNWNhSqjCP1EnD2Bz|+ zBBsjwnZu7DrbthCL0fawNWD}4Z8b&%qTYW!rnl?2d+5M1E(0#Dj~$XB%_tKR`M;po zrJ?VRCV}loX(b3l6O39q)GQo7EQ*CLAumA!p$(m4D$rHBE$<%YvOe{FD^4rU;05cQ z$l!!v1P z>jr1{>NbW(yjUj5^?kJmH9_CafXaEeS&T+7LrPu(Zj}HA_dEyvVHtBgqXc`3oa882 z*`{O{2W?T`%{`upVV7X9pCOHuLyMz(XR(f)r=6)L_y*w$YU_D9vFL5gH6az1cN*n`nsdLqDOg9jZaa^s9Rby!J%y*w^KPZWkKiaUT+tQhk` z`q%Dsg6b&qBR_56odYY*_eE&uKPX;2@KIk)Ex|k2rPsMIyBuOOnuG%_BTWs(Jn>;M zy#+2DiDVYObaAi)K9w%iW5pFf`;XOJM!Gq-%_X!A({_R7=01T)EWBn~;$gg5`Oj45 zFgS_MkQSW!w?>PFY14r3Da|V|3~^D(I*B4>=9E0z<1l>5qq3;6dA|oT$LF-^u9YGo z7hb072;vV!n@_xIODj9YL}^P#MuxQhm~qe8>1swg1RWtdMx{QK6*PPR7Hn=hO^leV z=>dg|*MnXB8YlAth+3gMiY{uJ@>-A4f>gy7Hl}2@Eg^sSjL&Pb9(G}i&fo?`;zt-l zotq!{=AV-aE2OBF&`Z9$FmfaPH~4oNU(`ynilyj_gnsY+S%4JaE(0s80$N|}j*6H(jDM+6mp7L!MK*s~-DQG2J=as9c2z>1{`wCxT|l zysswWuNq>Rx2hi~6#npaPM^wP=Uo256|<*UC{nQJ-F${{jl!dSsC>!Ei6P-cyJ?L; zFLvpVmjb~tD{GPLqBK{sWJvN0I5l+Dx%KbX#)bUs7kg!V!gqiLl#uzu({iItSuzJT zpx=6;rwtTvvnp1}^srf-q37%KzGEs4@i?tq2uT_XyS6!fLL6C^&_=b70n_Z0KFy`4 z;pxPk2p>sboyvWA)b%7|NE=;4DqYMNc5;3ks_T){p=oPcapKA7jUq%0gljRl!#rx) zN9iEwT#a>MmJuWXv`rSkwCSGBQ{Px85(*b5SRWWuO~)adyd>HP4}Xg3X=_BZmJ6f_ zYBCbSuEyER9|I5rHkMlU`C6xN0SU`k(b}<}6@X(@Z8LM4DA5&=XOmd9JY`iA=Z_ z%QBokvM#zI^vnSCf@)kIy}TPl#_7N*YFaMyYI>F=w|mI7`$z#Ttu| z{Hk*m6jQzMPUqru4wHa`sCQ%K1_hfDk#%8Ze}Xb9Ye~%*m7~9(C`_w%$Qs1jdv4X% z+MBgRR=iXVWv2>OWf?dD^mNR1RyswKC@s$n>VwJ%1C8psY%+h!&)VCWrclKnJNprK zLtqQ7#np8e*s^ff&Df5>G<6ELs0wZy_A;8GWi%WSLc+pJg`WXxbW;y_5MH=)8@s#= z>CosWRa3$iCL_)41>&~8Ri2|6p$g?mzc7s^@o2&swv5OEiks~6j|L6%UykWbD{ScO zd?lEunZHQaH8k@TIDT+(1YO@fH%=ph;wkRusvm=;YLq-H%8jn zo0JkO%tcg{r+NUorKj!pvg!&|?<_5p`DVF6qNA-9?Kg(xTOi8Btj};2ibpyEJ5LfA z)f7GCzQRht3DH`?D!uW!;uLgOqUHM<<|sBUYgk>usj3#3Wx-1!e}sPg4o(e0&rZi_F@*ZDkNW%$|u*g4xTp*Ek` zAoUawCER}}oafJM>&!Y#RzWW<*BC$o3ws7VLH{XBmBr7oK)A3W#iO>? zT1NgLZ2V=_+0ne4>!{06-Yknpr6vfoFouf?`0ejRkIqXicFmDzE<-m>vwJs!)N!lC zi;h$mN3{2V){bnuh(d6yBp*#F6MA0IFT!7sJ%$2EBpIRKq9>~hdKf{v&#Sy+pB5EM zXiP*9%J9iFOUTorO@uWcSc7|*)N-Ltw#$mE$CfchvAmq;Wqgcn&ozOO`dN3Gtfg|M zuVSfkUHyhor&d8UMwr;e>h)_@2m386ABkN;@hzW?^CZJN5y4Y~>!J?Z94iYYF>Mnk zy44vFSvS!i*yzW(zV~t30`oo49eAVUNC5Pu)ci4NW$XCIe=d`O| z67fL0`({bA#@YMTUeobba=kqDdB}z#f8w4=2PooXY=1}5HK>nf?5c9R~`<<%YRH#6su?4e8SR(UgSQ8WA zXc9zJs=hUyM#tMM5^x1M1-+EUucwn^Bb>3>+9P%t%z zX+&T(6R!5I10X)kr%pjUY z*}*o*Za5`A_otOrEyG+urB%cpJb=r17@`9=!6vA|62W2`cQTiQ8|wbbNG=ax-)Dz) z1;bTSa^((n)eadnCz+}vAF>8Y-)_;}N#7>`fK4?XLaK%gc;3YmdLf3^3vv}o4?+O# zcM$(_6pd1o|Bm28KjHO_cMJdxkj8tMBMiR3;YLzCf%?nOAM*3Q7G~y2SY$Qu*xP}~ z7;l#^7!H~#UJxN9H~x!H+7J~WY7D&vEdbpC?F;>f44$|U#bA7nBsdB>4OtSIkt~{2 zPXt@cBjg6x7}OYb7q_3i9|@WZ*`9Qg)C_r>*bL-S0q?kuM9Y4+D$ER@pn2C5)+W4tnhO| z7&&K)Ja#{M5y4JIR}fS}+3Q;vzLm&0h#HwHZ6J3%*!o~p)7UWMwyXHhzdY}dh}3(d zz};@%(vV`R!llWJ4K6mmd%w@uCxUOeeS!fc1!iY3RjUV^rjF^9r068i(`J|vTAq<5 zY%F`@_hO%<=)5w2>Wl#}sR00FhY{Oh{;|DLZ#Mk<1V*s{VfE65PSAQ7+om8n4Z{-B zSVSa2U5c8DUhkHKUXqMcG$dsJIcSo=~@1#F%UnH!~GF*Ss0YdYZ4W}Z-yJs|97gH{yH^L~aBXqv~k3g=;FNtc`}jM^({WX7~g zWs^I{AyM&yV!g|tA#B0OG||}`Mt+F1*jzZs5UC#_J^n7^_Bb_SG75!}A(TdM-=w#s zT&XBpm+NgaB$v~>pZ#?&*aJxSa_#5qH(0?|LED{xb|fz2g)k0=Rl;w|4sf_&rL?Qc zwH3dUH@Y_0VQD>Ui+7&>^*k(TuIso5Oa?Fo`%iu$aIPT-6eUamqXE!E0g8-lIiLz? zKNeEGDZt^#{Dwv0r3bLfv+J;ft>%b-Gk_Xc`Q53irGhu<7QqA#&DMq9gNtog>OlgQ9+N9 z!Sl-)D>`o;uun!v&VLSRnUfnH9R(^@MF&5WU9N^dmR&ktGxmJiaI~mjz9UY#hcV!% zdbstQN}lStnRJHLyfq=xMJ{8RS!UEGYo1_wU01eEBvoV6ko4DlALttCo$+fvnf*&( z-cw1&&BY5XDwyu_5JKpbg<*!cMW45^hrGyQP*N-`fSq&1-pI(8?#H+3l*V!qTE8&| z7936AlB<{R=B!Uv3Qd}KjOR(W0SiXgoskXa?64(@(iq3(>_C)uvOIfBtG8?*V(zs2 zoC%wwE4|m904U{12pxm{<-v;B(P3WHwD6eYg7+p0%Sb4L9;-B`LJ0#(TYbOc<_)Ho znB#&041=}zd{=wFN?8SvB>1$FBjG8M%VyqO8cN`h?=@lj`CAp z22TBu;!gPM?(<&p?9fHkL~Z9qIm8iK#5Vgh@Z?SL9yyoU-PqkYWO2Q5bDIZOv{qW* z{*@$fx;JO80z3w1z;6h!hA=hg83T;S~qx9vXJ_1l=U)ZF8C(0RPauVil&)I94^>X)Hrm45^W~BYtf`?)5%7O+q@c@9RyG@qS+2v-7+OD&CS}zk zRB&n-Euu8~8PTy?;`6=dxJ>n=7p4}ow@8?!mzNXN)}#W=Vkd7=Wcjykt(}T!>;1oe z_pvj`6G9+{TZ5&2Uj|nMsQd@GeQl_wq>}tZXabsTNy0IaL&2~_6Mp-fC96av%l2BC z{#>xjZaUOYbJ_(sNW6cuhmPMF4j>A_rcy5*uS#sa8&8d7F2&! z@Rg_TmM_jKs$S@tG)~q^h6Q)I(Me6SV#t~`5{cTyVc)V%k1uL{6DO>>hJ-;@ye|C8 zCq>sHrCcI+6YHj|8Es|cW72>yWt*~SgmFjG91>wTHS2p-z4v=K2bL8Rp0pjpO5NeU zAW(XJ21>7}fWodZcQ%59%d6Yl19LTO$}7663$W0?OQwx{oa*f>IvZuis75;pu=yeXokyxE3s25jfd-5>0P)G09JyMHqRtfrZYHP>cd-R6@PIuWcf7 zu88XPTNb4R07!UM@ze0wwxtqvEY3Y8)K`SD`33s_I^78L$zR-nE`4RF z{|0~{XG3D88LWas0n`kCZg3(C$;L9Q#gc6(oO5rbQd+Is+8lb=bZ~6=TZkz`Y-_Mf z5M_o1)L{oj$m5V7HY-kytXZCjp*%PeS+6RqsEjD!{`MbyyMNnCkh*)h1^_DwduM88 zb_|3FU-js`UWQ9ZlUa~FN8go`;aiouO`Im*AsDF)04RKOKmho+b0~!;tN7vNb-$ z)m%}=^o#)A8h|?A7c-pRlR|$B6HBd|WHx)ey~Esu6_L`|McU|cGh+^Rka`Zs#@RPZ zn8gfbfm_PgYlfu+&#@?`2zoQU-|#3b@dx2wfrDK}d%fYmr}Uq2!;9Wwb+N5C0L#o! zHPr|0fx4LINmejq;xNg+DATSZ$@AZs_Q-cHFDJ%p)&Onu2|hvEeM`?Kwcm72wB{3z z%ABkV0w4?{gYrZHS265RHX8<>~RwmoX6 zRDKRWS)ra9aYw4baMq4c31|`AIajxPhfnDFqynI)!d6R6tGTE_A*8C@0M&MwhSg*X>mZCS8A? zrQI7#R@xrv3HAj?{D!JWU0|QxpmD?>LW?D)o<5aVEC7>(YMq91)Z0PrNq~zbqR^Ts zh6bRR98j;_4e%u2S+}bCZct%!7y_2)*E@&4Byr|m`%S1=OUue*XmH(&L%K7OD3CL$zekC zwJ%IOWary=vO$Wy-lBeFSnvor#3jmY$t-TSHEpSf)UQ6G9bi-^ij*I^Nw%6OOq!0) zjCaF-p#5zo?$W|@5rY!kd@JsRQ^?Cyrwb?JRNb?OSfuP+hs&ZAP&*gCON`TWCnZ@$tWY_F zfv`-&Fp2wd@Yt|MAwq0VTfVuj#k-!)Sh@=G7>2D|nF`vB6?*^{ZVsz$Q+09;Eh?G4 zqL)_U{CuCSJ;zdeqb3kL@-bVYLEFxw?tYNO2v@XbgQhUG$%BT4q+qNX2nwoO9u1yp z(d{w5r>y11#aNwdgs#ayL!{o1hU9CdH(8% zJWqXVw=%>~HcHPN!`W+Z=$43~HfB#>V7JP*&-<6hv8;9L%I!S>Pl|0QqR2WX8*m_?@H) z;N4@nhLttb(ti9}G{qiBf~8HT-p4F2RA)<}-At3kcXZb1M<4jHl|2@0{AHmAOlhX- zV^&bW1s@@enCC`@C(GBo0GaZX9(n^8gx$p^ki!k2tir8GN|b;$?44NlLzIS|7m zwe1eBo<6~`&%|;V84;Y%w(<}aJ~m?mp6mnvzp}0a9_#0i^Wd@f=CO&$p4l1MduApp zG9s&t#}3)+t6`LptjNqNWQ354WQ0Pp3MC2udp!Nr)4$iN*W=#zzPr!eeeUja-&@v{ z28{d`8o771g*R86Y8~U2y=c-A8SSspH#qF3Wby0xHxh$Q$FFF_YKAjafK5mL2hh_-cH{nFxW6YEpbIb7~rqWTQl*Ux}Rg z0Rp=IZBhq>8O-%=k782HRVp%&EL@ZVL((3pPbB)(NX5?;^J_Qh?Tp>#9PYTX=}P2h zI{5lY-G>|&_*LF08wU99zHsUl`qZt%$krRdr#}+EV|k~uQjb60(Q}85@$D4*5-c(H z6izJ#^^kWr@mp@|lD-Zi^BOE^fyc3e@9399(tKI-?#((p@8YrwT6JLbCucSY`)3b; zjj8vF1klzmIKP*}a^Wn$U%{(1K6-ZGpjE4Ox#Z-eijMJ2T`O5N&v*jPy)w(p>``q* zANJ{U(oH_C4r@uDDvvIoHA7uK>l2_ZfZeD)HW<|YRbFv;7_~({DB?QFWRxF5>(Y-; z-1D-}jc@j;sZnQ<7fYp4PMDHK$Iq*+x-Qo+ytS=DE^u2+^_#NMRg?Enux_19p&9S` z{Wa!{3r zd>-G24^my7>f~LV3c`*rYSWzG%JkJ|Ia01Xka)DgG+gQ`@CaI(RB^jdss3Ht#}U^y zs%zpN&E88PlU89Wn;;9WF(d!-aP6#%%1IYn3>r%`VwJ2Z({bM%lE2{MY}%{(F=G>hsGz4E|L6V$!{@OeQY zukJ37QxlLbqL zb8A&tj4G$^(={XP0g@Z8!cVIWhx6PGELnX9PA-0fpJuWf2ItFdmqzYf?H#>J&X{+{ zB3j-{EYo0Ea#`Q(oa|NP2u~VsfFF1W^|NvOe%(0LVkOr{hEJ)zdR|47t{wfiP0vkG zM=OI;&;vq|ycPwFzsfx40?m1SS34Rpu7M9e7qe@|L@}f^shNrwM{r zV4b{QtuvlW@o>0Q^8@e7V}q^)xjOx{0+XOb(oM*~T_h!j1HLcoW?A&>#I88&>D{{r zUV`&5Ax>$su=uAFOQK)al){BSh%J<#o2Ht0kI3w@wbH5Ex=g%c*)c}Z9vSR3&eyIY zX)(h^e_ryb+0V;@1<$@=Nr(M2CrZL5v+M`jhk!#y%eZRbfn@YSv)X+p>;49Qm9IE> zl%{VJUNStP66DuOpwbFSRTCe%OE$eOC09$@`c)_7J9xD_4)yHpw5JIl_r+VQ>r=st zQ^CVSZCgjCS6*S~m!Mwn31fj7`Rd0OE3=o-OV$Rci&PpGr=Ri_zB0(&HYkY`(=E=p4dPuU-v%!_e_U| zMSRj=gHLPW8mHE;wlB(-v=Q4v-Ytv`}=p2A07lo z!hEj=uRaQ4Imwl+UUtpsA(>RuLBC<{27hY%KJsk(_MAS?Qe(`x(&YT|o&4tF@%?L` z63RB*`a7$~3cJ_dy^h#sIz07$<4{@1*sww}bWMBMj{es8Ud_`d7UOw!I48DQcV;O3_1`tYp3x5B8CC_1S! z`S536183F%iNV2+)6f)&EaA^Rd{s%QiRAl5B5w`hwbR8Fec^L2tMvxfjT_bx+07r- zXR_^Kb41|n+7$=n)d2O?&5<|y2x$A>0iRSB7w?#O4kj_O)lIV{t!_;TqENBz@zR*)52~hJ3A<1Z?VH?iW zHfc;tT%>)#txDwPKFzXuPZEbByPLpg{cIFz?Gxz6&L#uTHZI%Frx(?Vcf&;=8AQ+} zEUCG2M5zC~^>O;dJNXkeH1zi2dMmD-I^5fxbW~(QvQ28_JuEgo(W+CMbUB?gRUUUs zFPqKXQqi7kR*`DhB6>w6O+!=@Y|>$zW0aFLZH>N|`OoBHBdWvZF_>Jm!q6M9)bqi{ ztKXmhLtBy^d*`}HW18naSk~iTzC{i5iA$iUGUlL+$2nb))TTBmv(n!Z|IRv$>>!g++QgBx*p}O9P%FN-va`d6H8Tqy->A#!?Pn5giH{lTS8?Xg_-fXk!|!>4 zYoJ)WI6gx+Su-cj*A$W$iTz@H3aNgFSRqMCSIF62L5Ad|>AMc&QXAdPTmj(F;cffOpme`Y#Ofy8_l})Bt%e1Gr zjDSa#UkFEKUo`DQ#vdWeBVSsz&!4YN7~%V6WmchaO3pcT#f;`l9KO8GLl_Z~^`~SV z&U(wi_{Fx*TdZm1+iTy{ap3McP%5DpZ)Q$RP`}w9$bVn%I@|Myi<=o@2?rhp{thu_ zF;aThIGNs5%}SM0-@>|!kBq8ZJ8k;*LW_#8{KUuJAZ?i<`WcR;Y0*2lJ5*Emm2=LM z=i-uAE5XHs;xruVNXbYzaRM{i^b{p7GUApPxBR>7pqei&G8dTEn)Oaja#twpxyN1c+?qQJTWM1IvJJ!vPQ0%YgU=4T ztOlD2z$nvetoUvUh^Mn5@f}%z5=eG7Ea(iZuaI_7lI8h%^9Ikji_2cUb|&bp;HqZw z1bGGj6O$eqyQ{XiA$C8uuIA-a1T<%KF1_m`Uo|UfB~lQzecefVPnUh92=`3dj}o2N zWPHJAWNZb=9bZz_XqpemL~E*IxO3%~gh+73y?{^M(2ft{^NMj0 z!{lmVHmAN1FYbCt)AdRrnn}%{?AKXVzf+!GJ-sR?F}8a?7u*Gf`DL!CC}=MZj6&2< z+E-jn)b^i@CDen@5sasP-CS zxqGKXVCKe5&2ariS4+yo4y59I==u-&FLwg3Yuqcm(IYE03L*2IGDFG{6swq;U0 zi}?FJav@W1NXmnK3Y-ljqS{S2N9cuzRtKv^n_C9Bnxhf}BBUm=?VkE05iixv~4nPl?iC6n+O=U8h~w(c$B)j#)>ej947qx!Z@ymocr$c zMuT}zu7CF!EDjR1-I&8x*KcwD{P`WWuil`vTbSk33)JH^ub+vTlRc#|_xXV39CMqf zk>&)Amq11F33^Hlz*%*^`^;?W!}wGXDxJ-gw07>H%KXe8v8sPL)K*F$FZ;mzx!%!=M*Wrz40~FE7(SI_1l`loIAB! z>;(n^4HkQ$ak)kYMFR`rq&6Fch_YqFvL3wbr8h1G3J*M_38E}@)bH{~aPll#!QCew z9OQr59K1^1^*VknD`DPTfS|tgVWZmHyK^Inq zzNJ+4hY{bYg~g^?Bwn0=Gh7>X>Zta|-sI_f622@SD>4;zhK4bglckP7V#B0|SA6TM zyX#{A38yWh+hJv2PHAg|B7Qy{L0yYIAQR9QK zTU44n;37S7qffQ^EPZN)yZ!kGlp{`g_rvaLwXKxl`k(n=`fAFv>gyQ%{r8LZrN*~} zFCeX>HL_a^GYJG(Q#j9j^{rHpeYlE{7fA>W01TdQcEqLDYq69RAE zlj1P;2PA{1gq*eB@odpwd&1QsnX{MBp5LAL^?;hB!F({MD5r~0J}>t+n=s>bhUc?7 zR0LafOq%qMPEYap<7z4Ob8pPbKDW;4#O;p`O#05!>c1(frJpU<8&v2i-}UL~l;zFb zT5a3w)rls2wwkoE?4g=*wj8NMXU}Mr)F|&EVhoIKyBJ1Jw@cnoPj_@;8wy{K%WzAZ}k>nu%Dm=lcCrC46i)j&ApuF4eERoAB>@A-%~g<6F=KlP1d? z=#FPof7x;ktTf}EX$ZIYt$VX6Zo!Nfy%A+E#HX;Jv?RNACQ)Zl@b& z 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 From 6f2fde440c49a5f3214a87fcb430b9599f37fffa Mon Sep 17 00:00:00 2001 From: David Schachter Date: Sun, 15 Nov 2026 21:37:08 -0800 Subject: [PATCH 02/23] ADFA-7139 AI-Agent-MCP: automatic server entry for the open project's debugger An app built in Code on the Go with cogo.sqliteDebugger=true serves its databases over MCP on 127.0.0.1. AI-Agent-MCP now offers that server to the Agent with nothing typed in. - One automatic server entry per endpoint reported by DebuggerEndpointService: http://127.0.0.1:/mcp, the token kept in memory only and never stored in the Keystore. No endpoint means no entry and no error. - The endpoint is re-read before reconnecting after a refused connection, 401 or 403, so a relaunched app (new port and token) is picked up; its tools stay offered across the relaunch. A refused read is logged once. - For this entry only, tools whose readOnlyHint is exactly true (boolean) start switched on and others start off. Hand-added servers keep today's behaviour even when they claim the hint. AI-Core still asks for approval on every call of a contributed tool, so the pre-approval does not skip the prompt; automatic approval is ADFA-7147. - The manifest declares debugger.endpoints and plugin.min_ide_version 26.43: an older Code on the Go rejects the unknown permission at validation, so it cannot install this version at all. - Showing the entry in the settings screen is deferred to phase 2: the eight phase 1 tools are all read-only, so nothing needs switching on. Tests: no endpoint; stale endpoint (refused, 401, 403) re-read; relaunch through a fake MCP server keeps the tools; the annotation rule (true, false, missing, "true", 1, null); a hand-added server claiming the hint stays off; a repeated read failure is logged once. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../AI-Agent-MCP/src/main/AndroidManifest.xml | 19 +- .../aiagentmcp/client/McpConnections.kt | 5 + .../plugins/aiagentmcp/client/McpSession.kt | 4 + .../plugins/aiagentmcp/client/McpTool.kt | 3 + .../aiagentmcp/debugger/AutomaticServers.kt | 199 ++++++++++++++++++ .../aiagentmcp/debugger/EndpointRetry.kt | 49 +++++ .../aiagentmcp/debugger/ReadOnlyTrust.kt | 33 +++ .../plugins/aiagentmcp/plugin/McpPlugin.kt | 51 ++++- .../plugins/aiagentmcp/settings/McpServer.kt | 3 + .../aiagentmcp/tools/McpToolCatalog.kt | 33 ++- .../plugins/aiagentmcp/tools/McpToolSource.kt | 36 ++-- .../debugger/AutomaticServersTest.kt | 182 ++++++++++++++++ .../aiagentmcp/debugger/EndpointRetryTest.kt | 142 +++++++++++++ .../debugger/ReadOnlyHintParsingTest.kt | 66 ++++++ .../debugger/RelaunchToolSourceTest.kt | 122 +++++++++++ .../debugger/RepeatedFailureLogTest.kt | 23 ++ .../aiagentmcp/testing/FakeMcpServer.kt | 59 ++++++ 17 files changed, 1001 insertions(+), 28 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt create mode 100644 plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetry.kt create mode 100644 plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetryTest.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RepeatedFailureLogTest.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt diff --git a/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml b/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml index 4c179768d..a41b06ca9 100644 --- a/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml +++ b/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml @@ -39,23 +39,26 @@ android:name="plugin.author" android:value="App Dev for All" /> - + + android:value="26.43" /> - + + android:value="network.access,debugger.endpoints" /> = emptyMap(), + val readOnlyHint: Boolean = false, ) /** diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt new file mode 100644 index 000000000..89c997a7f --- /dev/null +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -0,0 +1,199 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import android.util.Log +import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import com.itsaky.androidide.plugins.services.DebuggerEndpoint +import java.util.concurrent.CopyOnWriteArrayList + +private const val TAG = "$LOG_PREFIX.AutomaticServers" + +/** One endpoint as this plugin needs it, kept apart from the host type so tests need no jar. */ +data class AutomaticEndpoint(val applicationId: String, val port: Int, val token: String) { + // The token is a credential: it stays out of logs. + override fun toString() = "AutomaticEndpoint($applicationId, port=$port)" +} + +/** + * Reports the first failure in full and every later one briefly, so a failure that repeats on a timer + * does not fill the log. One instance per process. + */ +class RepeatedFailureLog( + private val first: (Throwable) -> Unit, + private val later: (Throwable) -> Unit, +) { + private val reported = java.util.concurrent.atomic.AtomicBoolean(false) + + fun report(e: Throwable) { + if (reported.compareAndSet(false, true)) first(e) else later(e) + } +} + +/** + * The server entries Code on the Go supplies for the open project's debuggable apps. + * + * Held in memory only: port and token change on every app start, so nothing here is worth + * persisting, and the token stays out of the Keystore-backed store the user's own servers use. + * Read from the host on [refresh]; an app that has not reported yields no entry at all. + */ +object AutomaticServers { + + const val ID_PREFIX = "debugger:" + + private class State(val endpoint: AutomaticEndpoint, val tools: List = emptyList()) + + @Volatile private var states: Map = emptyMap() + + @Volatile private var source: (() -> List)? = null + + private val listeners = CopyOnWriteArrayList<() -> Unit>() + + private val endpointListeners = CopyOnWriteArrayList<(String) -> Unit>() + + /** The probe calls [refresh] every 20 s, so a refused permission would otherwise log a stack trace forever. */ + private val readFailures = RepeatedFailureLog( + first = { e -> Log.w(TAG, "Could not read the debugger endpoints; keeping the previous entries", e) }, + later = { e -> Log.d(TAG, "Still cannot read the debugger endpoints: $e") }, + ) + + /** Where endpoints come from; null (deactivation) clears every entry. */ + fun install(source: (() -> List)?) { + this.source = source + if (source == null) clear() else refresh() + } + + /** Adapts the host's service. A host without the service, or without the permission, is no source. */ + fun fromHost(read: () -> List): () -> List = { + read().map { AutomaticEndpoint(it.applicationId, it.port, it.token) } + } + + fun addChangeListener(listener: () -> Unit) { + listeners.add(listener) + } + + fun removeChangeListener(listener: () -> Unit) { + listeners.remove(listener) + } + + /** + * Registers [listener], called with the id of an entry that appeared or whose port or token + * changed, so the owner can list its tools at once instead of at the next probe. + */ + fun addEndpointListener(listener: (String) -> Unit) { + endpointListeners.add(listener) + } + + fun removeEndpointListener(listener: (String) -> Unit) { + endpointListeners.remove(listener) + } + + /** + * Re-reads the endpoints. Blocking host call: use a background thread. + * @return true when the set of entries, a port or a token changed. + */ + fun refresh(): Boolean { + val read = source ?: return false + val fresh = try { + read().associateBy { idFor(it.applicationId) } + } catch (e: Exception) { + // A failed read is not "no apps": the entries stay as they were, since wiping them + // would take every debugger tool away from the agent on a transient database error. + readFailures.report(e) + return false + } + val moved = mutableListOf() + val removed: List + val changed = synchronized(this) { + val old = states + val next = fresh.mapValues { (id, endpoint) -> + val previous = old[id] + when { + previous == null -> State(endpoint).also { moved += id } + previous.endpoint == endpoint -> previous + // The previous list stays until the new process answers: the tool names almost + // never change on a relaunch, and an empty list would take every tool away from + // the agent for as long as the re-list takes. + else -> State(endpoint, previous.tools).also { moved += id } + } + } + states = next + removed = (old.keys - next.keys).toList() + old.mapValues { it.value.endpoint } != next.mapValues { it.value.endpoint } + } + for (id in removed) { + McpToolCatalog.forget(id) + McpConnections.invalidate(id) + } + for (id in moved) { + // A refused credential is not final for this entry: the new one has not been tried. + McpServerHealth.credentialChanged(id) + for (l in endpointListeners) runCatching { l(id) } + } + if (changed) fireChanged() + return changed + } + + /** The entries to offer, with their tool switches already decided by [ReadOnlyTrust]. */ + fun servers(): List = states.map { (id, state) -> + McpServer( + id = id, + name = "SQLite debugger (${state.endpoint.applicationId})", + url = urlFor(state.endpoint), + enabled = true, + knownTools = state.tools.map { it.name }, + enabledTools = ReadOnlyTrust.enabledTools(state.tools), + automatic = true, + ) + } + + fun isAutomatic(serverId: String): Boolean = serverId.startsWith(ID_PREFIX) + + /** The bearer token for [serverId], or null when it has no entry (any more). */ + fun token(serverId: String): String? = states[serverId]?.endpoint?.token + + /** The endpoint now stored for [serverId], or null when it has no entry. */ + fun endpoint(serverId: String): AutomaticEndpoint? = states[serverId]?.endpoint + + fun urlFor(endpoint: AutomaticEndpoint) = "http://127.0.0.1:${endpoint.port}/mcp" + + /** + * Remembers what the server listed. + * + * @param origin the endpoint the list was fetched from. A list from an endpoint that has since + * been replaced belongs to the old process and is dropped; the check and the write share one + * lock, so a refresh cannot slip between them. + * @return false when the list was dropped (no entry any more, or [origin] is out of date). + */ + fun recordTools(serverId: String, origin: AutomaticEndpoint, tools: List): Boolean { + synchronized(this) { + val state = states[serverId] ?: return false + if (state.endpoint != origin) return false + // The probe re-lists every cycle; an unchanged list must not make the agent rebuild. + if (state.tools == tools) return true + states = states + (serverId to State(state.endpoint, tools)) + } + fireChanged() + return true + } + + fun clear() { + val had = synchronized(this) { states.isNotEmpty().also { states = emptyMap() } } + if (had) fireChanged() + } + + fun idFor(applicationId: String) = ID_PREFIX + applicationId + + private fun fireChanged() { + for (l in listeners) runCatching { l() } + } +} + +/** Every server the agent may use: the user's own plus the automatic entries. */ +object McpServers { + fun all(): List = McpServerStore.servers() + AutomaticServers.servers() +} diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetry.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetry.kt new file mode 100644 index 000000000..d6cfb34fa --- /dev/null +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetry.kt @@ -0,0 +1,49 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer +import com.itsaky.androidide.plugins.aiagentmcp.transport.McpHttpException +import java.net.ConnectException + +/** + * Retries a call on an automatic entry once, with the endpoint read again. + * + * A relaunched app listens on a new port with a new token, so a refused connection or a 401/403 + * usually means the stored values are stale. The retry happens only when this entry's URL or + * token now differ from the ones the failing call used: asking the same server the same thing + * again helps nobody. A read timeout is not retried: the server may still be running the call, + * and repeating it would run a slow query twice. + * + * @param refresh re-reads the endpoints. + * @param current the entry now stored for an id, or null when its app is gone. + * @param token the token now stored for an id, or null when it has no entry. + */ +class EndpointRetry( + private val refresh: () -> Boolean, + private val current: (String) -> McpServer?, + private val token: (String) -> String?, +) { + fun call(server: McpServer, block: (McpServer) -> T): T { + // What the call is about to use: the credential is read per request, so a refresh by the + // probe that lands first is what this call sends, and is what the comparison must see. + val usedToken = token(server.id) + try { + return block(server) + } catch (e: Exception) { + if (!server.automatic || !isStale(e)) throw e + refresh() + val fresh = current(server.id) ?: throw e + // Judged for this id alone, from the values used: a probe refresh that already + // replaced them still earns the retry, and another app's change does not. + if (fresh.url == server.url && token(server.id) == usedToken) throw e + return block(fresh) + } + } + + companion object { + fun isStale(e: Throwable): Boolean = when (e) { + is ConnectException -> true + is McpHttpException -> e.statusCode == 401 || e.statusCode == 403 + else -> false + } + } +} diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt new file mode 100644 index 000000000..d19cae5b1 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt @@ -0,0 +1,33 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool + +/** + * Which tools of the automatic debugger entry start switched on, and which this plugin declares read-only. + * + * Declaring a tool read-only does not skip the approval dialog today: AI-Core overrides + * `requiresApproval` to true for every contributed tool (`ContributedToolHandler`), so the Agent still + * asks on each call until automatic approval exists (ADFA-7147). + * + * Only that entry may use this: the hint is the server's own claim, and the debugger endpoint is the + * one server whose code the IDE itself installed. A server the user adds by hand is never asked. + */ +object ReadOnlyTrust { + + /** + * @param tools what `tools/list` returned. + * @return the names of the tools that declared `annotations.readOnlyHint` as boolean true. + */ + fun enabledTools(tools: List): Set = + tools.filter { it.readOnlyHint }.mapTo(linkedSetOf()) { it.name } + + /** + * Reads the hint from one `tools/list` entry's `annotations`. + * + * Exactly boolean true counts. The string "true", 1, false, null and a missing key do not: an + * approval skipped on a loose reading (once AI-Core honours the declaration) cannot be taken back. + * + * @param hint the value under `readOnlyHint`, or null when absent. + */ + fun isReadOnlyHint(hint: Any?): Boolean = hint == true +} diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index e3f00c588..4333f9fe9 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -5,6 +5,8 @@ import com.itsaky.androidide.plugins.PluginContext import com.itsaky.androidide.plugins.PluginLifecycleListener import com.itsaky.androidide.plugins.aiagentmcp.R import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.debugger.McpServers import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore import com.itsaky.androidide.plugins.aiagentmcp.settings.McpSettingsFragment import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth @@ -15,6 +17,7 @@ import com.itsaky.androidide.plugins.extensions.PluginSettingsEntry import com.itsaky.androidide.plugins.extensions.PluginTooltipButton import com.itsaky.androidide.plugins.extensions.PluginTooltipEntry import com.itsaky.androidide.plugins.extensions.SettingsExtension +import com.itsaky.androidide.plugins.services.DebuggerEndpointService import com.itsaky.androidide.plugins.services.SharedServices import com.itsaky.androidide.plugins.services.ToolSourceRegistry import kotlinx.coroutines.CoroutineScope @@ -159,6 +162,20 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { } } + /** + * Lists an automatic entry's tools as soon as its endpoint appears or changes, so a relaunched + * app's next call does not wait for the probe's cadence. + */ + private val relistAutomatic: (String) -> Unit = { id -> + scope.launch { + val server = McpServers.all().firstOrNull { it.id == id && it.enabled } + if (server != null) { + runCatching { McpToolCatalog.connect(server) } + if (isActive) settingsChanged() + } + } + } + override fun initialize(context: PluginContext): Boolean { this.context = context pluginContext = context @@ -174,6 +191,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { activationJob = active.coroutineContext[Job] toolSource = McpToolSource() McpServerStore.addChangeListener(settingsChanged) + AutomaticServers.addChangeListener(settingsChanged) McpServerHealth.addChangeListener(healthChanged) context.addPluginLifecycleListener(aiCoreLifecycle) @@ -184,6 +202,10 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { // Tool lists are answered from cache, so the cache has to be filled before the user opens // the Agent — otherwise the first cold-start session sees no MCP tools at all. active.launch { + // Off the main thread: the host reads its database. Before refreshAll, so the entry is + // connected like any other. + installDebuggerEndpoints() + AutomaticServers.addEndpointListener(relistAutomatic) val refreshed = McpToolCatalog.refreshAll { isActive } if (refreshed > 0 && isActive) settingsChanged() probeHealth { isActive } @@ -197,6 +219,8 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { override fun deactivate(): Boolean = try { context.removePluginLifecycleListener(aiCoreLifecycle) McpServerStore.removeChangeListener(settingsChanged) + AutomaticServers.removeChangeListener(settingsChanged) + AutomaticServers.removeEndpointListener(relistAutomatic) McpServerHealth.removeChangeListener(healthChanged) unregisterToolSource() // Before the connections are closed: an in-flight refresh would otherwise repopulate the @@ -212,6 +236,8 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { override fun dispose() { runCatching { context.removePluginLifecycleListener(aiCoreLifecycle) } McpServerStore.removeChangeListener(settingsChanged) + AutomaticServers.removeChangeListener(settingsChanged) + AutomaticServers.removeEndpointListener(relistAutomatic) McpServerHealth.removeChangeListener(healthChanged) unregisterToolSource() stopScope() @@ -237,7 +263,8 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { while (keepGoing()) { delay(PROBE_INTERVAL_MS) cycle++ - val due = McpServerStore.servers().filter { server -> + if (AutomaticServers.refresh()) settingsChanged() + val due = McpServers.all().filter { server -> val health = McpServerHealth.of(server.id) server.enabled && health?.refused != true && (cycle % HEALTHY_PROBE_EVERY == 0 || health?.state != McpServerHealth.State.AVAILABLE) @@ -258,6 +285,27 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { } } + /** + * Points [AutomaticServers] at the host's debugger endpoints. + * + * `plugin.min_ide_version` keeps this plugin off an IDE that lacks the service: such an IDE + * rejects the unknown `debugger.endpoints` permission when it validates the manifest. The catch + * is defence only, for a host that registers no service anyway. A call that later throws (no + * permission, unreadable database) leaves the entries as they were. + */ + private fun installDebuggerEndpoints() { + val service = try { + context.services.get(DebuggerEndpointService::class.java) + } catch (e: Throwable) { + null + } + if (service == null) { + context.logger.info("McpPlugin: this IDE has no debugger endpoint service") + return + } + AutomaticServers.install(AutomaticServers.fromHost { service.endpoints }) + } + /** A fresh scope for this activation; the previous one is cancelled, never reused. */ private fun newScope() = CoroutineScope(SupervisorJob() + Dispatchers.IO) @@ -353,6 +401,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { toolSource = null McpConnections.closeAll() McpToolCatalog.clear() + AutomaticServers.install(null) } /** diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt index be60ecf21..eb29222ea 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt @@ -13,6 +13,8 @@ package com.itsaky.androidide.plugins.aiagentmcp.settings * @property knownTools the tool names last seen on this server, for the toggle list. * @property enabledTools the tools the user switched on; empty is the default, so a new server * contributes nothing until its tools are chosen deliberately. + * @property automatic true for the entry Code on the Go supplies for a debuggable app: never + * stored, no Keystore token, and the only kind whose read-only tools start on. */ data class McpServer( val id: String, @@ -21,6 +23,7 @@ data class McpServer( val enabled: Boolean = true, val knownTools: List = emptyList(), val enabledTools: Set = emptySet(), + val automatic: Boolean = false, ) { /** The tools that should actually be offered to the agent right now. */ val activeTools: List diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt index 8fbb514db..45eab5c04 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt @@ -4,6 +4,9 @@ import android.util.Log import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections import com.itsaky.androidide.plugins.aiagentmcp.client.McpProtocolException import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.debugger.EndpointRetry +import com.itsaky.androidide.plugins.aiagentmcp.debugger.McpServers import com.itsaky.androidide.plugins.aiagentmcp.errors.McpErrorFormatter import com.itsaky.androidide.plugins.aiagentmcp.errors.McpFailure import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX @@ -27,6 +30,13 @@ object McpToolCatalog { private val toolsByServer = ConcurrentHashMap>() + /** Re-reads an automatic entry's endpoint and tries once more when the stored one is stale. */ + val retry = EndpointRetry( + refresh = AutomaticServers::refresh, + current = { id -> AutomaticServers.servers().firstOrNull { it.id == id } }, + token = AutomaticServers::token, + ) + /** * The cached tools for a server. * @param serverId the server. @@ -61,7 +71,7 @@ object McpToolCatalog { ): Listing { McpServerHealth.connectingIfUnknown(server.id) val listing = try { - list(server, exchangeListener) + retry.call(server) { list(it, exchangeListener) } } catch (e: Throwable) { recordFailure(server, e) throw e @@ -91,10 +101,13 @@ object McpToolCatalog { } private fun isConfigured(serverId: String): Boolean = - McpServerStore.servers().any { it.id == serverId } + McpServers.all().any { it.id == serverId } /** The handshake-and-list itself; see [connect]. */ private fun list(server: McpServer, exchangeListener: McpExchangeListener): Listing { + // Taken before the request: if the endpoint is replaced while this list is in flight, the + // list is the old process's and must not be attached to the new one. + val origin = if (server.automatic) AutomaticServers.endpoint(server.id) else null // Kept, not just its tools: the name the handshake returned lands on the session. val session = McpConnections.session(server) val tools = session.recording(exchangeListener) { @@ -108,8 +121,18 @@ object McpToolCatalog { emptyList() } } - toolsByServer[server.id] = tools - McpServerStore.setKnownTools(server.id, tools.map { it.name }) + if (server.automatic) { + val current = origin != null && AutomaticServers.urlFor(origin) == server.url && + AutomaticServers.recordTools(server.id, origin, tools) + if (!current) { + Log.i(TAG, "Dropping a tool list from an endpoint '${server.name}' has since left") + return Listing(session.serverName, tools) + } + toolsByServer[server.id] = tools + } else { + toolsByServer[server.id] = tools + McpServerStore.setKnownTools(server.id, tools.map { it.name }) + } Log.i(TAG, "Server '${server.name}' listed ${tools.size} tool(s)") return Listing(session.serverName, tools) } @@ -128,7 +151,7 @@ object McpToolCatalog { */ fun refreshAll(keepGoing: () -> Boolean = { true }): Int { var refreshed = 0 - for (server in McpServerStore.servers().filter { it.enabled }) { + for (server in McpServers.all().filter { it.enabled }) { if (!keepGoing()) { Log.i(TAG, "Stopped refreshing tool lists; the caller is gone") break diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt index f4e04bf39..010634ccf 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt @@ -4,12 +4,12 @@ import android.util.Log import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections import com.itsaky.androidide.plugins.aiagentmcp.client.McpSession import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.debugger.McpServers import com.itsaky.androidide.plugins.aiagentmcp.errors.McpErrorFormatter import com.itsaky.androidide.plugins.aiagentmcp.R import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX import com.itsaky.androidide.plugins.aiagentmcp.plugin.McpPlugin import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer -import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore import com.itsaky.androidide.plugins.services.CapabilityStatus import com.itsaky.androidide.plugins.services.ToolSourceRegistry import java.util.concurrent.CompletableFuture @@ -59,6 +59,7 @@ class McpToolSource : name = exposed.name, description = exposed.tool.description, parametersSchema = exposed.tool.inputSchema, + preApproved = exposed.server.automatic && exposed.tool.readOnlyHint, ) } @@ -68,7 +69,7 @@ class McpToolSource : */ override fun getToolGroups(): List { val namesByServer = exposedTools().groupBy({ it.server.id }, { it.name }) - return McpServerStore.servers().filter { it.enabled }.map { server -> + return McpServers.all().filter { it.enabled }.map { server -> Group( id = server.id, displayName = server.name, @@ -93,7 +94,7 @@ class McpToolSource : enabledHealth().firstOrNull { it?.state == McpServerHealth.State.DEGRADED }?.message private fun enabledHealth(): List = - McpServerStore.servers().filter { it.enabled }.map { McpServerHealth.of(it.id) } + McpServers.all().filter { it.enabled }.map { McpServerHealth.of(it.id) } override fun invoke( invocation: ToolSourceRegistry.ToolInvocation, @@ -140,12 +141,14 @@ class McpToolSource : tool: McpTool, arguments: Map, ): ToolSourceRegistry.ToolOutcome = try { - val session = McpConnections.session(server) - liveSessions[callId] = session - val result = try { - session.callTool(tool.name, arguments) - } finally { - liveSessions.remove(callId) + val result = McpToolCatalog.retry.call(server) { target -> + val session = McpConnections.session(target) + liveSessions[callId] = session + try { + session.callTool(tool.name, arguments) + } finally { + liveSessions.remove(callId) + } } // A reply of any kind, a tool's own failure included, means the server is answering. McpServerHealth.available(server.id) @@ -172,7 +175,7 @@ class McpToolSource : * @return the pairs, in configured order. */ private fun enabledTools(): List> = - McpServerStore.servers() + McpServers.all() .filter { it.enabled } .flatMap { server -> McpToolCatalog.tools(server.id) @@ -231,21 +234,26 @@ class McpToolSource : /** * One tool, as the host contract describes it. * - * Every remote tool asks for approval and declares itself non-read-only: this plugin cannot + * Every remote tool declares that it requires approval and is not read-only: this plugin cannot * know what a server's tool does, and guessing on the permissive side is the one guess that - * cannot be undone. The contract is a Java interface, so its accessors are implemented as + * cannot be undone. The one exception is [preApproved]: a readOnlyHint tool of the automatic + * debugger entry, whose server Code on the Go itself installed, declares no approval needed. + * That is a declaration only: AI-Core currently overrides `requiresApproval` to true for every + * contributed tool (`ContributedToolHandler`), so the Agent still asks on each call. Honouring + * the declaration is tracked in ADFA-7147. The contract is a Java interface, so its accessors are implemented as * functions: Kotlin synthesises properties for *reading* a Java getter, never for overriding one. */ private class Spec( private val name: String, private val description: String, private val parametersSchema: Map, + private val preApproved: Boolean = false, ) : ToolSourceRegistry.ToolSpec { override fun getName(): String = name override fun getDescription(): String = description override fun getParametersSchema(): Map = parametersSchema - override fun requiresApproval(): Boolean = true - override fun isReadOnly(): Boolean = false + override fun requiresApproval(): Boolean = !preApproved + override fun isReadOnly(): Boolean = preApproved } /** diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt new file mode 100644 index 000000000..e313a7f11 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt @@ -0,0 +1,182 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue +import org.junit.Test + +class AutomaticServersTest { + + @After + fun reset() = AutomaticServers.install(null) + + private fun endpoint(app: String = "com.example.app", port: Int = 4000, token: String = "t1") = + AutomaticEndpoint(app, port, token) + + @Test + fun `no endpoint means no entry and no error`() { + AutomaticServers.install { emptyList() } + assertTrue(AutomaticServers.servers().isEmpty()) + assertTrue(McpServers.all().isEmpty()) + } + + @Test + fun `a host that refuses or lacks the service means no entry and no error`() { + AutomaticServers.install { throw SecurityException("no permission") } + assertTrue(AutomaticServers.servers().isEmpty()) + } + + @Test + fun `an endpoint becomes a loopback entry with its token held in memory`() { + AutomaticServers.install { listOf(endpoint(port = 4321, token = "secret")) } + + val server = AutomaticServers.servers().single() + assertEquals("http://127.0.0.1:4321/mcp", server.url) + assertTrue(server.automatic) + assertTrue(server.enabled) + assertEquals("secret", AutomaticServers.token(server.id)) + assertFalse("secret" in server.toString()) + } + + @Test + fun `the entry disappears when the app stops reporting`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + assertEquals(1, AutomaticServers.servers().size) + + current = emptyList() + assertTrue(AutomaticServers.refresh()) + assertTrue(AutomaticServers.servers().isEmpty()) + } + + @Test + fun `refresh reports a change only when port or token differ`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + assertFalse(AutomaticServers.refresh()) + + current = listOf(endpoint(port = 4001)) + assertTrue(AutomaticServers.refresh()) + current = listOf(endpoint(port = 4001, token = "t2")) + assertTrue(AutomaticServers.refresh()) + assertEquals("t2", AutomaticServers.token(AutomaticServers.idFor("com.example.app"))) + } + + @Test + fun `a relaunch keeps the old tools and switches until the new process lists`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val id = AutomaticServers.idFor("com.example.app") + AutomaticServers.recordTools(id, endpoint(), listOf(McpTool("q", "", readOnlyHint = true))) + + current = listOf(endpoint(port = 4002)) + AutomaticServers.refresh() + + val server = AutomaticServers.servers().single() + assertEquals(listOf("q"), server.knownTools) + assertEquals(setOf("q"), server.enabledTools) + assertTrue(server.url.endsWith(":4002/mcp")) + } + + @Test + fun `a relaunch asks the owner to list the new endpoint at once`() { + var current = listOf(endpoint()) + val asked = mutableListOf() + AutomaticServers.install { current } + AutomaticServers.addEndpointListener { asked += it } + + assertFalse(AutomaticServers.refresh()) + assertTrue(asked.isEmpty()) + + current = listOf(endpoint(port = 4002, token = "t2")) + AutomaticServers.refresh() + assertEquals(listOf(AutomaticServers.idFor("com.example.app")), asked) + } + + @Test + fun `a relaunch lets the probe ask an entry that had refused its credential`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val id = AutomaticServers.idFor("com.example.app") + McpServerHealth.degraded(id, "refused", refused = true) + + current = listOf(endpoint(token = "t2")) + AutomaticServers.refresh() + assertFalse(McpServerHealth.of(id)!!.refused) + McpServerHealth.forget(id) + } + + @Test + fun `a tool list fetched from a replaced endpoint is dropped`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val id = AutomaticServers.idFor("com.example.app") + val old = endpoint() + AutomaticServers.recordTools(id, old, listOf(McpTool("fresh", ""))) + + current = listOf(endpoint(port = 4002)) + AutomaticServers.refresh() + assertFalse(AutomaticServers.recordTools(id, old, listOf(McpTool("stale", "")))) + + assertEquals(listOf("fresh"), AutomaticServers.servers().single().knownTools) + assertTrue(AutomaticServers.recordTools(id, endpoint(port = 4002), listOf(McpTool("newer", "")))) + assertEquals(listOf("newer"), AutomaticServers.servers().single().knownTools) + } + + @Test + fun `a failed read keeps the entries as they were`() { + var failing = false + AutomaticServers.install { + if (failing) throw IllegalStateException("db closed") + listOf(endpoint()) + } + val id = AutomaticServers.idFor("com.example.app") + AutomaticServers.recordTools(id, endpoint(), listOf(McpTool("q", "", readOnlyHint = true))) + + failing = true + assertFalse(AutomaticServers.refresh()) + + val server = AutomaticServers.servers().single() + assertEquals(listOf("q"), server.knownTools) + assertEquals("t1", AutomaticServers.token(id)) + } + + @Test + fun `an entry that disappears has its health and cached tools forgotten`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val id = AutomaticServers.idFor("com.example.app") + McpServerHealth.available(id) + + current = emptyList() + AutomaticServers.refresh() + + assertNull(McpServerHealth.of(id)) + assertTrue(McpToolCatalog.tools(id).isEmpty()) + } + + @Test + fun `only readOnlyHint tools of the automatic entry start on`() { + AutomaticServers.install { listOf(endpoint()) } + val id = AutomaticServers.idFor("com.example.app") + AutomaticServers.recordTools( + id, + endpoint(), + listOf( + McpTool("reads", "", readOnlyHint = true), + McpTool("writes", "", readOnlyHint = false), + McpTool("unmarked", ""), + ), + ) + + val server = AutomaticServers.servers().single() + assertEquals(listOf("reads", "writes", "unmarked"), server.knownTools) + assertEquals(setOf("reads"), server.enabledTools) + assertEquals(listOf("reads"), server.activeTools) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetryTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetryTest.kt new file mode 100644 index 000000000..bbb66d403 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/EndpointRetryTest.kt @@ -0,0 +1,142 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.aiagentmcp.client.McpProtocolException +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer +import com.itsaky.androidide.plugins.aiagentmcp.transport.McpHttpException +import java.net.ConnectException +import java.net.SocketTimeoutException +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertThrows +import org.junit.Test + +class EndpointRetryTest { + + private val app = "com.example.app" + private var stored = listOf(AutomaticEndpoint(app, 1111, "old")) + private val retry = EndpointRetry( + refresh = AutomaticServers::refresh, + current = { id -> AutomaticServers.servers().firstOrNull { it.id == id } }, + token = AutomaticServers::token, + ) + + init { + AutomaticServers.install { stored } + } + + @After + fun reset() = AutomaticServers.install(null) + + private fun server() = AutomaticServers.servers().single() + + @Test + fun `a refused first connect uses the refreshed endpoint on retry`() { + val urls = mutableListOf() + val first = server() + stored = listOf(AutomaticEndpoint(app, 2222, "new")) + + val result = retry.call(first) { s -> + urls += s.url + if (s.url.endsWith(":1111/mcp")) throw ConnectException("refused") + "ok:" + AutomaticServers.token(s.id) + } + + assertEquals("ok:new", result) + assertEquals(listOf("http://127.0.0.1:1111/mcp", "http://127.0.0.1:2222/mcp"), urls) + } + + @Test + fun `401 and 403 also refresh`() { + for (failure in listOf(McpHttpException(401, ""), McpHttpException(403, ""))) { + stored = listOf(AutomaticEndpoint(app, 1111, "old")) + AutomaticServers.install { stored } + val first = server() + stored = listOf(AutomaticEndpoint(app, 3333, "n")) + var calls = 0 + val out = retry.call(first) { s -> calls++; if (calls == 1) throw failure else s.url } + assertEquals("http://127.0.0.1:3333/mcp", out) + } + } + + @Test + fun `a timeout is not retried, so a slow call is not run twice`() { + val first = server() + stored = listOf(AutomaticEndpoint(app, 3333, "n")) + var calls = 0 + assertThrows(SocketTimeoutException::class.java) { + retry.call(first) { calls++; throw SocketTimeoutException("read timed out") } + } + assertEquals(1, calls) + } + + @Test + fun `a credential a concurrent refresh already replaced is still retried`() { + val first = server() + var calls = 0 + val out = retry.call(first) { s -> + calls++ + if (calls == 1) { + // The probe's refresh lands while this call is in flight, so the retry's own + // refresh sees nothing new. + stored = listOf(AutomaticEndpoint(app, 1111, "rotated")) + AutomaticServers.refresh() + throw McpHttpException(401, "") + } + "retried:" + AutomaticServers.token(s.id) + } + assertEquals("retried:rotated", out) + assertEquals(2, calls) + } + + @Test + fun `another app's change does not cause a retry`() { + stored = listOf(AutomaticEndpoint(app, 1111, "old"), AutomaticEndpoint("com.example.other", 9000, "o1")) + AutomaticServers.install { stored } + val mine = AutomaticServers.servers().first { it.id == AutomaticServers.idFor(app) } + stored = listOf(AutomaticEndpoint(app, 1111, "old"), AutomaticEndpoint("com.example.other", 9001, "o2")) + var calls = 0 + assertThrows(ConnectException::class.java) { + retry.call(mine) { calls++; throw ConnectException("refused") } + } + assertEquals(1, calls) + } + + @Test + fun `an unchanged endpoint is not asked twice`() { + var calls = 0 + assertThrows(ConnectException::class.java) { + retry.call(server()) { calls++; throw ConnectException("refused") } + } + assertEquals(1, calls) + } + + @Test + fun `an app that is gone surfaces the original failure`() { + val first = server() + stored = emptyList() + assertThrows(ConnectException::class.java) { + retry.call(first) { throw ConnectException("refused") } + } + } + + @Test + fun `other failures are not retried`() { + stored = listOf(AutomaticEndpoint(app, 4444, "x")) + var calls = 0 + assertThrows(McpProtocolException::class.java) { + retry.call(server()) { calls++; throw McpProtocolException(-32000, "bad") } + } + assertEquals(1, calls) + } + + @Test + fun `a hand-added server is never retried through the endpoint source`() { + val handAdded = McpServer("h", "mine", "http://127.0.0.1:1111/mcp") + stored = listOf(AutomaticEndpoint(app, 5555, "x")) + var calls = 0 + assertThrows(ConnectException::class.java) { + retry.call(handAdded) { calls++; throw ConnectException("refused") } + } + assertEquals(1, calls) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt new file mode 100644 index 000000000..dc940d7c4 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt @@ -0,0 +1,66 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.aiagentmcp.client.McpSession +import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.transport.McpExchangeListener +import com.itsaky.androidide.plugins.aiagentmcp.transport.McpHttpClient +import java.net.HttpURLConnection +import org.json.JSONArray +import org.json.JSONObject +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Test + +/** The rule is read from a real `tools/list` reply, so the JSON types are the ones a server sends. */ +class ReadOnlyHintParsingTest { + + private fun listed(annotations: Any?, present: Boolean = true): McpTool { + val tool = JSONObject().put("name", "t") + if (present) tool.put("annotations", annotations) + val http = object : McpHttpClient() { + override fun post( + url: String, + token: String, + body: JSONObject, + sessionId: String?, + protocolVersion: String?, + extraHeaders: Map, + onConnected: (HttpURLConnection) -> Unit, + exchangeListener: McpExchangeListener, + ): Response { + val result = when (body.optString("method")) { + "initialize" -> JSONObject().put("protocolVersion", "2026-07-28") + "tools/list" -> JSONObject().put("tools", JSONArray().put(tool)) + else -> return Response(null, null) + } + val reply = JSONObject().put("jsonrpc", "2.0").put("id", body.opt("id")).put("result", result) + return Response(reply.toString(), null) + } + } + return McpSession("http://127.0.0.1:1/mcp", { com.itsaky.androidide.plugins.aiagentmcp.client.McpCredentials("", emptyMap()) }, http) + .listTools().single() + } + + private fun hint(value: Any?) = listed(JSONObject().put("readOnlyHint", value)) + + @Test fun `boolean true is read only`() = assertTrue(hint(true).readOnlyHint) + + @Test fun `boolean false is not`() = assertFalse(hint(false).readOnlyHint) + + @Test fun `missing hint is not`() = assertFalse(listed(JSONObject()).readOnlyHint) + + @Test fun `missing annotations is not`() = assertFalse(listed(null, present = false).readOnlyHint) + + @Test fun `string true is not`() = assertFalse(hint("true").readOnlyHint) + + @Test fun `number one is not`() = assertFalse(hint(1).readOnlyHint) + + @Test fun `json null is not`() = assertFalse(hint(JSONObject.NULL).readOnlyHint) + + @Test + fun `trust enables exactly the true ones`() { + val tools = listOf(McpTool("a", "", readOnlyHint = true), McpTool("b", "")) + assertEquals(setOf("a"), ReadOnlyTrust.enabledTools(tools)) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt new file mode 100644 index 000000000..a0b33707e --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt @@ -0,0 +1,122 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.plugin.McpPlugin +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion.tool +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolSource +import com.itsaky.androidide.plugins.security.KeystoreSecretStore +import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import io.mockk.every +import io.mockk.mockk +import io.mockk.mockkObject +import io.mockk.unmockkObject +import java.util.concurrent.TimeUnit +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +/** What the agent is offered, driven through [McpToolSource] against loopback servers. */ +class RelaunchToolSourceTest { + + private val app = "com.example.app" + private val servers = mutableListOf() + private val source = McpToolSource() + private lateinit var plugin: McpPlugin + + @Before + fun setUp() { + val context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + plugin = McpPlugin().also { it.initialize(context) } + // The Keystore is not there on the JVM; a hand-added server in these tests has no secrets. + mockkObject(McpServerStore) + every { McpServerStore.token(any()) } returns KeystoreSecretStore.Stored.Absent + every { McpServerStore.headers(any()) } returns emptyMap() + } + + @After + fun tearDown() { + source.close() + AutomaticServers.install(null) + McpConnections.closeAll() + McpToolCatalog.clear() + servers.forEach { it.stop() } + plugin.dispose() + unmockkObject(McpServerStore) + } + + private fun fake(token: String, vararg tools: org.json.JSONObject) = + FakeMcpServer(token, tools.toList()).also { servers += it } + + private fun offered(): Map = + source.listTools().associateBy { it.name } + + private fun invoke(name: String): ToolSourceRegistry.ToolOutcome = + source.invoke( + mockk { + every { toolName } returns name + every { arguments } returns emptyMap() + every { callId } returns "call-1" + } + ).get(30, TimeUnit.SECONDS) + + private fun debuggerTools() = arrayOf(tool("list_tables", true), tool("run_sql", false), tool("unmarked", null)) + + @Test + fun `a relaunch keeps the read-only tools offered and the next call reaches the new endpoint`() { + val first = fake("t1", *debuggerTools()) + var stored = listOf(AutomaticEndpoint(app, first.port, "t1")) + AutomaticServers.install { stored } + McpToolCatalog.connect(AutomaticServers.servers().single()) + val before = offered() + assertEquals(1, before.size) + val name = before.keys.single() + + val second = fake("t2", *debuggerTools()) + stored = listOf(AutomaticEndpoint(app, second.port, "t2")) + assertTrue(AutomaticServers.refresh()) + + // No re-list has happened yet: the agent must not lose its tools meanwhile. + assertEquals(setOf(name), offered().keys) + val outcome = invoke(name) + assertTrue(outcome.errorMessage, outcome.isSuccess) + assertEquals("served by ${second.port}", outcome.output) + } + + @Test + fun `an automatic entry's read-only tool is pre-approved and the others are not offered`() { + val server = fake("t1", *debuggerTools()) + AutomaticServers.install { listOf(AutomaticEndpoint(app, server.port, "t1")) } + McpToolCatalog.connect(AutomaticServers.servers().single()) + + val spec = offered().values.single() + assertTrue(spec.name.endsWith("list_tables")) + assertFalse(spec.requiresApproval()) + assertTrue(spec.isReadOnly) + } + + @Test + fun `a hand-added server claiming readOnlyHint is off by default and asks once switched on`() { + val server = fake("", tool("claims", true)) + val handAdded = McpServerStore.saveDetails( + McpServerStore.newServer("Mine", "http://127.0.0.1:${server.port}/mcp") + ) + McpToolCatalog.connect(handAdded) + assertTrue(McpToolCatalog.tools(handAdded.id).single().readOnlyHint) + + assertTrue(offered().isEmpty()) + + McpServerStore.setToolEnabled(handAdded.id, "claims", true) + val spec = offered().values.single() + assertTrue(spec.requiresApproval()) + assertFalse(spec.isReadOnly) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RepeatedFailureLogTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RepeatedFailureLogTest.kt new file mode 100644 index 000000000..4b75f36f6 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RepeatedFailureLogTest.kt @@ -0,0 +1,23 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import org.junit.Assert.assertEquals +import org.junit.Test + +class RepeatedFailureLogTest { + @Test + fun `the first failure is reported in full and the repeats briefly`() { + val full = mutableListOf() + val brief = mutableListOf() + val log = RepeatedFailureLog(first = { full += it }, later = { brief += it }) + val a = SecurityException("a") + val b = SecurityException("b") + val c = IllegalStateException("c") + + log.report(a) + log.report(b) + log.report(c) + + assertEquals(listOf(a), full) + assertEquals(listOf(b, c), brief) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt new file mode 100644 index 000000000..8cfa7c223 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt @@ -0,0 +1,59 @@ +package com.itsaky.androidide.plugins.aiagentmcp.testing + +import com.sun.net.httpserver.HttpServer +import java.net.InetSocketAddress +import org.json.JSONArray +import org.json.JSONObject + +/** + * A loopback MCP server for tests: answers the handshake, `tools/list` and `tools/call` over + * plain JSON, and 401 unless the bearer token is [token] (any request when it is empty). A call's text names the port that served + * it, so a test can tell which endpoint a call reached. + * + * @param tools the `tools/list` entries. + */ +class FakeMcpServer(val token: String, private val tools: List) { + + private val server: HttpServer = HttpServer.create(InetSocketAddress("127.0.0.1", 0), 0).apply { + createContext("/mcp") { exchange -> + val request = JSONObject(exchange.requestBody.use { String(it.readBytes()) }) + val id = request.opt("id") + if (token.isNotEmpty() && exchange.requestHeaders.getFirst("Authorization") != "Bearer $token") { + exchange.sendResponseHeaders(401, -1) + } else if (id == null) { + exchange.sendResponseHeaders(202, -1) + } else { + val result = when (request.getString("method")) { + "initialize" -> JSONObject() + .put("protocolVersion", "2025-03-26") + .put("serverInfo", JSONObject().put("name", "fake")) + "tools/list" -> JSONObject().put("tools", JSONArray(tools)) + "tools/call" -> JSONObject().put( + "content", + JSONArray().put(JSONObject().put("type", "text").put("text", "served by $port")), + ) + else -> JSONObject() + } + val bytes = JSONObject().put("jsonrpc", "2.0").put("id", id).put("result", result) + .toString().toByteArray() + exchange.responseHeaders.add("Content-Type", "application/json") + exchange.sendResponseHeaders(200, bytes.size.toLong()) + exchange.responseBody.use { it.write(bytes) } + } + exchange.close() + } + start() + } + + val port: Int get() = server.address.port + + fun stop() = server.stop(0) + + companion object { + fun tool(name: String, readOnlyHint: Boolean?): JSONObject = JSONObject() + .put("name", name) + .put("description", name) + .put("inputSchema", JSONObject().put("type", "object")) + .also { if (readOnlyHint != null) it.put("annotations", JSONObject().put("readOnlyHint", readOnlyHint)) } + } +} From aa490b601d7b7262eaa51ab1cb6d5c75c7c9d228 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Sun, 15 Nov 2026 21:37:08 -0800 Subject: [PATCH 03/23] ADFA-7139 AI-Agent-MCP: document the debugger entry The plugin README and the plugin's help page describe the automatic SQLite debugger entry, its read-only tool rule and the approval prompt. plugins/README.md lists debugger.endpoints among the permissions and says a plugin declaring it needs plugin.min_ide_version of at least 26.43. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 30 +++++++++++++++++++++++--- plugins/AI-Agent-MCP/ai-agent-mcp.html | 3 ++- plugins/README.md | 4 +++- 3 files changed, 32 insertions(+), 5 deletions(-) diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index 50a6d7788..ec74f1854 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -36,7 +36,8 @@ Configuration → MCP servers**: 1. **Add server** — name, endpoint URL, optional token. 2. **Connect** — saves the server, performs the MCP handshake and lists the tools it offers, all in one step. -3. Switch on the tools you want. **They start off**: one popular GitHub server +3. Switch on the tools you want. **They start off** (except the read-only tools + of the automatic debugger entry, below): one popular GitHub server advertises around ninety tools, which would fill a phone-sized context window on its own. 4. **Clear stored credential** — removes the stored token and headers. The token @@ -47,6 +48,26 @@ Every remote tool asks for approval on every call, and there is no "always allow" for contributed tools — they run outside the Agent's own path containment, so the dialog is the only gate. +### The SQLite debugger entry + +For an app built in Code on the Go with `cogo.sqliteDebugger=true`, the plugin +adds a server entry on its own, named "SQLite debugger ()", with +no URL or token to type. Code on the Go stores the port and token the running +debug app reports; the plugin reads them through the `DebuggerEndpointService` +(permission `debugger.endpoints`, so it needs Code on the Go 26.43 or later) and +points the entry at `http://127.0.0.1:/mcp`. A relaunched app gets a new +port and token, and the plugin reads them again after a refused connection. An +app that has not reported yet has no entry, and no error is shown. + +- It is held in memory only and is **not shown in the settings screen in this + version**, so there is no switch to turn it off there. +- The tools that declare MCP's `readOnlyHint: true` start switched **on**. Any + other tool of that entry starts off. The hint is trusted for this entry only, + never for a server you add yourself. +- The Agent still asks for approval on every call: AI-Core makes every + contributed tool ask (it ignores the tool's own `requiresApproval`). Approving + read-only calls automatically is tracked in ADFA-7147. + ## Transport MCP's **Streamable HTTP** transport over `HttpURLConnection`: @@ -105,10 +126,13 @@ Two dependencies were deliberately not taken: - `http://` is accepted only for a server on this device (`localhost`, `127.0.0.0/8`, `[::1]`), with or without credentials; any other host needs `https://`, since its traffic would cross a network in the clear. The check is `McpUrlPolicy`, built on - the host's `ServerUrl` (plugin-api **26.42**, hence this plugin's - `min_ide_version`), and judges the URL as typed with no DNS lookup. Save refuses + the host's `ServerUrl` (plugin-api 26.42), and judges the URL as typed with no DNS lookup. Save refuses such a URL, and the transport refuses it again, so a server saved before the rule is listed with a warning and never contacted until it is switched to `https://`. +- The plugin declares the `debugger.endpoints` permission, to offer the SQLite debugger of the + open project's app without typing a port or token. Code on the Go 26.42 and older reject an + unknown permission when they validate the manifest, so this version needs **26.43 or newer** + (`plugin.min_ide_version`); users on 26.42 or older cannot install it. - Redirects are never followed automatically. A 3xx is repeated only when it resolves to the same origin, so the bearer token and the user's own headers cannot be replayed to another host in one hop. diff --git a/plugins/AI-Agent-MCP/ai-agent-mcp.html b/plugins/AI-Agent-MCP/ai-agent-mcp.html index 5277617f4..92f0cf1ea 100644 --- a/plugins/AI-Agent-MCP/ai-agent-mcp.html +++ b/plugins/AI-Agent-MCP/ai-agent-mcp.html @@ -141,7 +141,8 @@

Usage

New tools always arrive switched off, including on the connection - that discovers them. Nothing a server adds later becomes visible to the model + that discovers them. The one exception is the read-only tools of the SQLite + debugger entry that Code on the Go supplies for your own debug app. Nothing a server adds later becomes visible to the model without your say-so.
diff --git a/plugins/README.md b/plugins/README.md index 2eb07e5c4..d6dc15178 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -148,7 +148,9 @@ A plugin is an Android *application* module (despite installing as a library) wi Available permission strings (declared comma-separated in `plugin.permissions`): `filesystem.read`, `filesystem.write`, `network.access`, `system.commands`, `ide.settings`, -`project.structure`. +`project.structure`, `native.code`, `ide.environment.write`, `debugger.endpoints`. An IDE rejects +a manifest that names a permission it does not know, so a plugin declaring `debugger.endpoints` +needs `plugin.min_ide_version` of at least 26.43. --- From 816e8cc80278ecd19d1b38b72eefa08363d4b01d Mon Sep 17 00:00:00 2001 From: David Schachter Date: Sun, 15 Nov 2026 23:17:33 -0800 Subject: [PATCH 04/23] ADFA-7139 AI-Agent-MCP: raise plugin.min_ide_version to 26.47, the first release with debugger.endpoints Code on the Go 26.43 to 26.46 are released and none carries PluginPermission.DEBUGGER_ENDPOINTS or DebuggerEndpointService. An unknown permission key does not only warn: PluginManager.loadPlugin (PluginManager.kt:568) calls PluginSecurityManager.validatePlugin, which returns false when validatePermissions (PluginSecurityManager.kt:50, :92) finds a key outside PluginPermission, and loadPlugin then fails with "plugin failed security validation". The same code is at tags 26.42 and 26.46 and on origin/stage. The warn-and-drop at PluginManager.kt:582 runs only after validation passed, so it never sees an unknown key from a manifest. 26.46 therefore rejects this plugin, and the floor must be the next release, 26.47 (26.46 was tagged 2026-11-10, weekly cadence). The manifest comment, plugin README and plugins/README.md say so. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 9 +++++---- plugins/AI-Agent-MCP/src/main/AndroidManifest.xml | 15 +++++++++------ plugins/README.md | 5 +++-- 3 files changed, 17 insertions(+), 12 deletions(-) diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index ec74f1854..3e1f4544c 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -54,7 +54,7 @@ For an app built in Code on the Go with `cogo.sqliteDebugger=true`, the plugin adds a server entry on its own, named "SQLite debugger ()", with no URL or token to type. Code on the Go stores the port and token the running debug app reports; the plugin reads them through the `DebuggerEndpointService` -(permission `debugger.endpoints`, so it needs Code on the Go 26.43 or later) and +(permission `debugger.endpoints`, so it needs Code on the Go 26.47 or later) and points the entry at `http://127.0.0.1:/mcp`. A relaunched app gets a new port and token, and the plugin reads them again after a refused connection. An app that has not reported yet has no entry, and no error is shown. @@ -130,9 +130,10 @@ Two dependencies were deliberately not taken: such a URL, and the transport refuses it again, so a server saved before the rule is listed with a warning and never contacted until it is switched to `https://`. - The plugin declares the `debugger.endpoints` permission, to offer the SQLite debugger of the - open project's app without typing a port or token. Code on the Go 26.42 and older reject an - unknown permission when they validate the manifest, so this version needs **26.43 or newer** - (`plugin.min_ide_version`); users on 26.42 or older cannot install it. + open project's app without typing a port or token. Code on the Go 26.46 and older reject a + manifest that names a permission they do not know (`PluginSecurityManager.validatePlugin`), so this + version needs **26.47 or newer**, the first release that ships `DebuggerEndpointService` + (`plugin.min_ide_version`); users on 26.46 or older cannot install it. - Redirects are never followed automatically. A 3xx is repeated only when it resolves to the same origin, so the bearer token and the user's own headers cannot be replayed to another host in one hop. diff --git a/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml b/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml index a41b06ca9..e1ed9f715 100644 --- a/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml +++ b/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml @@ -39,14 +39,17 @@ android:name="plugin.author" android:value="App Dev for All" /> - + + android:value="26.47" /> Date: Sun, 15 Nov 2026 23:17:33 -0800 Subject: [PATCH 05/23] ADFA-7139 AI-Agent-MCP: an activation that ends during the first endpoint read leaves nothing behind The host's database read blocks and cannot be cancelled. If the plugin was deactivated meanwhile, the old coroutine resumed, re-installed the endpoint source and added the endpoint listener, which nothing removed; a quick re-activate added it twice. Now the launch checks the activation before and after the read, install() keeps neither the source nor the entries of a finished activation, and deactivate removes the listener after the scope ends so a late add is caught. McpPluginDebuggerStartTest fails without this (a listener is left registered when the activation ended during the read) and passes with it; it also checks that a live activation adds one listener. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/debugger/AutomaticServers.kt | 34 +++++++- .../plugins/aiagentmcp/plugin/McpPlugin.kt | 30 +++++-- .../plugin/McpPluginDebuggerStartTest.kt | 81 +++++++++++++++++++ 3 files changed, 135 insertions(+), 10 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginDebuggerStartTest.kt diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index 89c997a7f..c899401be 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -61,10 +61,31 @@ object AutomaticServers { later = { e -> Log.d(TAG, "Still cannot read the debugger endpoints: $e") }, ) - /** Where endpoints come from; null (deactivation) clears every entry. */ + /** + * Where endpoints come from; null (deactivation) clears every entry. + * + * @param keepGoing false once the activation installing [source] is over. The first read blocks + * and cannot be cancelled, so an activation that ended during it must neither keep [source] + * nor publish what it read: deactivation has already cleared everything, and a later + * activation owns the state now. + */ fun install(source: (() -> List)?) { - this.source = source - if (source == null) clear() else refresh() + if (source == null) { + // Under the lock the other overload takes, so a late install cannot set its source after this. + synchronized(this) { this.source = null } + clear() + } else { + install(source) { true } + } + } + + /** As [install], for a source that may be superseded while its first read is blocked. */ + fun install(source: () -> List, keepGoing: () -> Boolean) { + synchronized(this) { + if (!keepGoing()) return + this.source = source + } + refresh(keepGoing) } /** Adapts the host's service. A host without the service, or without the permission, is no source. */ @@ -92,11 +113,15 @@ object AutomaticServers { endpointListeners.remove(listener) } + /** How many endpoint listeners are registered; a test seam for a listener nothing removes. */ + internal val endpointListenerCount: Int get() = endpointListeners.size + /** * Re-reads the endpoints. Blocking host call: use a background thread. + * @param keepGoing checked after the read, before anything is stored. * @return true when the set of entries, a port or a token changed. */ - fun refresh(): Boolean { + fun refresh(keepGoing: () -> Boolean = { true }): Boolean { val read = source ?: return false val fresh = try { read().associateBy { idFor(it.applicationId) } @@ -109,6 +134,7 @@ object AutomaticServers { val moved = mutableListOf() val removed: List val changed = synchronized(this) { + if (!keepGoing()) return false val old = states val next = fresh.mapValues { (id, endpoint) -> val previous = old[id] diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index 4333f9fe9..3d4b2f953 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -204,8 +204,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { active.launch { // Off the main thread: the host reads its database. Before refreshAll, so the entry is // connected like any other. - installDebuggerEndpoints() - AutomaticServers.addEndpointListener(relistAutomatic) + startDebuggerEntry { isActive } val refreshed = McpToolCatalog.refreshAll { isActive } if (refreshed > 0 && isActive) settingsChanged() probeHealth { isActive } @@ -220,12 +219,14 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { context.removePluginLifecycleListener(aiCoreLifecycle) McpServerStore.removeChangeListener(settingsChanged) AutomaticServers.removeChangeListener(settingsChanged) - AutomaticServers.removeEndpointListener(relistAutomatic) McpServerHealth.removeChangeListener(healthChanged) unregisterToolSource() // Before the connections are closed: an in-flight refresh would otherwise repopulate the // catalogue and the session map straight after they were cleared. stopScope() + // After the scope ends, not before: startDebuggerEntry adds this listener and then checks + // the scope, so one added late is removed by that check and one added early is removed here. + AutomaticServers.removeEndpointListener(relistAutomatic) releaseConnections() true } catch (e: Exception) { @@ -237,10 +238,10 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { runCatching { context.removePluginLifecycleListener(aiCoreLifecycle) } McpServerStore.removeChangeListener(settingsChanged) AutomaticServers.removeChangeListener(settingsChanged) - AutomaticServers.removeEndpointListener(relistAutomatic) McpServerHealth.removeChangeListener(healthChanged) unregisterToolSource() stopScope() + AutomaticServers.removeEndpointListener(relistAutomatic) releaseConnections() pluginContext = null context.logger.info("McpPlugin: disposed") @@ -293,7 +294,24 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { * is defence only, for a host that registers no service anyway. A call that later throws (no * permission, unreadable database) leaves the entries as they were. */ - private fun installDebuggerEndpoints() { + /** + * Installs the host's endpoints and starts listening for changes, unless the activation ends first. + * + * The host's database read blocks and cancellation cannot interrupt it, so [keepGoing] is + * consulted around it. The listener is re-checked after it is added: [deactivate] ends the scope + * before it removes the listener, so one added in between is seen here and taken out again. + * + * @param keepGoing false once this activation is over. + */ + internal fun startDebuggerEntry(keepGoing: () -> Boolean) { + if (!keepGoing()) return + installDebuggerEndpoints(keepGoing) + if (!keepGoing()) return + AutomaticServers.addEndpointListener(relistAutomatic) + if (!keepGoing()) AutomaticServers.removeEndpointListener(relistAutomatic) + } + + private fun installDebuggerEndpoints(keepGoing: () -> Boolean) { val service = try { context.services.get(DebuggerEndpointService::class.java) } catch (e: Throwable) { @@ -303,7 +321,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { context.logger.info("McpPlugin: this IDE has no debugger endpoint service") return } - AutomaticServers.install(AutomaticServers.fromHost { service.endpoints }) + AutomaticServers.install(AutomaticServers.fromHost { service.endpoints }, keepGoing) } /** A fresh scope for this activation; the previous one is cancelled, never reused. */ diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginDebuggerStartTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginDebuggerStartTest.kt new file mode 100644 index 000000000..596ef7272 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginDebuggerStartTest.kt @@ -0,0 +1,81 @@ +package com.itsaky.androidide.plugins.aiagentmcp.plugin + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.services.DebuggerEndpoint +import com.itsaky.androidide.plugins.services.DebuggerEndpointService +import io.mockk.every +import io.mockk.mockk +import java.util.concurrent.CountDownLatch +import java.util.concurrent.TimeUnit +import java.util.concurrent.atomic.AtomicBoolean +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +/** + * An activation that ends during the host's blocking first read of the debugger endpoints must + * leave no source and no listener behind: nothing removes them after [McpPlugin.deactivate]. + */ +class McpPluginDebuggerStartTest { + + private val entered = CountDownLatch(1) + private val release = CountDownLatch(1) + private lateinit var plugin: McpPlugin + + @Before + fun setUp() { + AutomaticServers.install(null) + val endpoint = mockk { + every { applicationId } returns "com.example.app" + every { port } returns 4000 + every { token } returns "t1" + } + val service = mockk { + every { endpoints } answers { + entered.countDown() + release.await(10, TimeUnit.SECONDS) + listOf(endpoint) + } + } + val context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + every { context.services.get(DebuggerEndpointService::class.java) } returns service + plugin = McpPlugin().also { it.initialize(context) } + } + + @After + fun tearDown() { + release.countDown() + plugin.dispose() + AutomaticServers.install(null) + } + + @Test + fun `an activation that ends during the first read installs nothing and adds no listener`() { + val listeners = AutomaticServers.endpointListenerCount + val active = AtomicBoolean(true) + val start = Thread { plugin.startDebuggerEntry { active.get() } }.also { it.start() } + assertTrue("the read never started", entered.await(10, TimeUnit.SECONDS)) + + active.set(false) + release.countDown() + start.join(10_000) + + assertTrue(AutomaticServers.servers().isEmpty()) + assertEquals(listeners, AutomaticServers.endpointListenerCount) + } + + @Test + fun `a live activation installs the entry and the listener once`() { + val listeners = AutomaticServers.endpointListenerCount + release.countDown() + plugin.startDebuggerEntry { true } + + assertEquals(1, AutomaticServers.servers().size) + assertEquals(listeners + 1, AutomaticServers.endpointListenerCount) + } +} From 185d360cde82da897766067da728cd85f6f9c1f0 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Sun, 15 Nov 2026 23:17:33 -0800 Subject: [PATCH 06/23] ADFA-7139 AI-Agent-MCP: a session for a replaced debugger endpoint sends no token credentialsFor returned the entry's current token for any session of that id, so the old session's close() sent DELETE to the old port carrying the new process's token. The supplier now takes the url its session was built for and releases the token only while the entry still points there. ReplacedEndpointCredentialTest replaces an endpoint and checks the DELETE the old server saw: it fails without this (the DELETE carried "Bearer new-token") and passes with it. FakeMcpServer now records requests and can hand out a session id. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/client/McpConnections.kt | 15 ++++-- .../client/ReplacedEndpointCredentialTest.kt | 49 +++++++++++++++++++ .../aiagentmcp/testing/FakeMcpServer.kt | 24 ++++++++- 3 files changed, 82 insertions(+), 6 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/ReplacedEndpointCredentialTest.kt diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt index 76ac6442c..e1f469474 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt @@ -59,7 +59,7 @@ object McpConnections { stale = current?.second // A supplier, not the values: the session is kept for the life of the process, and a // token in one of its fields would be readable in a heap dump for just as long. - McpSession(server.url, { credentialsFor(server.id) }) + McpSession(server.url, { credentialsFor(server.id, server.url) }) .also { sessions[server.id] = key to it } } @@ -88,16 +88,21 @@ object McpConnections { * does not register, and it is what keeps the plaintext from outliving the request. * * @param serverId the server being called. + * @param url the url the calling session was built for. An automatic entry's token is released + * only while the entry still points there; a session for a replaced endpoint gets none, so + * its `close()` and any call still in flight cannot hand the new process's token to the old port. * @return its token and headers; either may be empty. * @throws UnreadableSecretException when a stored credential cannot be decrypted here. Sending * the request without it would earn a 401 and tell the user their token was refused. * @throws UnavailableSecretException when the keystore could not be reached to decrypt one, a * failure to retry rather than to report as a lost credential. */ - private fun credentialsFor(serverId: String): McpCredentials { + private fun credentialsFor(serverId: String, url: String): McpCredentials { if (AutomaticServers.isAutomatic(serverId)) { - // Read per request, so a refreshed endpoint's token is used without a new session. - return McpCredentials(AutomaticServers.token(serverId).orEmpty(), emptyMap()) + // Read per request, so a token refreshed on the same port is used without a new session. + val endpoint = AutomaticServers.endpoint(serverId) + val token = if (endpoint != null && AutomaticServers.urlFor(endpoint) == url) endpoint.token else "" + return McpCredentials(token, emptyMap()) } val token = when (val stored = McpServerStore.token(serverId)) { // Trimmed here, not by the store: the host's readAndMigrate migrates verbatim, and a @@ -128,7 +133,7 @@ object McpConnections { private fun keyFor(server: McpServer): Key { // Headers join the key for the same reason the token does: edit one and the old session // would keep sending the old value until the IDE restarts. - val credentials = credentialsFor(server.id) + val credentials = credentialsFor(server.id, server.url) return Key( serverId = server.id, url = server.url, diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/ReplacedEndpointCredentialTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/ReplacedEndpointCredentialTest.kt new file mode 100644 index 000000000..fda4e6a69 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/ReplacedEndpointCredentialTest.kt @@ -0,0 +1,49 @@ +package com.itsaky.androidide.plugins.aiagentmcp.client + +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticEndpoint +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion.tool +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertNotEquals +import org.junit.Assert.assertTrue +import org.junit.Test + +/** A session for a replaced debugger endpoint must not send the new endpoint's token to the old port. */ +class ReplacedEndpointCredentialTest { + + private val app = "com.example.app" + private val servers = mutableListOf() + + @After + fun tearDown() { + AutomaticServers.install(null) + McpConnections.closeAll() + McpToolCatalog.clear() + servers.forEach { it.stop() } + } + + @Test + fun `closing the session of a replaced endpoint does not send the new token to the old port`() { + val old = FakeMcpServer("old-token", listOf(tool("list_tables", true)), sessionId = "s1") + .also { servers += it } + val replacement = FakeMcpServer("new-token", listOf(tool("list_tables", true)), sessionId = "s2") + .also { servers += it } + var stored = listOf(AutomaticEndpoint(app, old.port, "old-token")) + AutomaticServers.install { stored } + + val session = McpConnections.session(AutomaticServers.servers().single()) + session.listTools() + assertTrue("the session opened against the old endpoint", old.requests.any { it.httpMethod == "POST" }) + + stored = listOf(AutomaticEndpoint(app, replacement.port, "new-token")) + assertTrue(AutomaticServers.refresh()) + McpConnections.session(AutomaticServers.servers().single()) // replaces and closes the old one + + val delete = old.requests.single { it.httpMethod == "DELETE" } + assertNotEquals("Bearer new-token", delete.authorization) + assertEquals(null, delete.authorization?.removePrefix("Bearer ")?.takeIf { it.isNotEmpty() }) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt index 8cfa7c223..c2c6383da 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/testing/FakeMcpServer.kt @@ -10,12 +10,31 @@ import org.json.JSONObject * plain JSON, and 401 unless the bearer token is [token] (any request when it is empty). A call's text names the port that served * it, so a test can tell which endpoint a call reached. * + * Every request is recorded in [requests], and a non-null [sessionId] is handed out on `initialize`, + * so a test can see the `DELETE` a closing session sends and which token it carried. + * * @param tools the `tools/list` entries. + * @param sessionId the `Mcp-Session-Id` to assign, or null for a server without sessions. */ -class FakeMcpServer(val token: String, private val tools: List) { +class FakeMcpServer( + val token: String, + private val tools: List, + private val sessionId: String? = null, +) { + + /** One request as the server saw it. */ + data class Seen(val httpMethod: String, val authorization: String?) + + val requests = java.util.concurrent.CopyOnWriteArrayList() private val server: HttpServer = HttpServer.create(InetSocketAddress("127.0.0.1", 0), 0).apply { createContext("/mcp") { exchange -> + requests += Seen(exchange.requestMethod, exchange.requestHeaders.getFirst("Authorization")) + if (exchange.requestMethod == "DELETE") { + exchange.sendResponseHeaders(200, -1) + exchange.close() + return@createContext + } val request = JSONObject(exchange.requestBody.use { String(it.readBytes()) }) val id = request.opt("id") if (token.isNotEmpty() && exchange.requestHeaders.getFirst("Authorization") != "Bearer $token") { @@ -37,6 +56,9 @@ class FakeMcpServer(val token: String, private val tools: List) { val bytes = JSONObject().put("jsonrpc", "2.0").put("id", id).put("result", result) .toString().toByteArray() exchange.responseHeaders.add("Content-Type", "application/json") + if (sessionId != null && request.getString("method") == "initialize") { + exchange.responseHeaders.add("Mcp-Session-Id", sessionId) + } exchange.sendResponseHeaders(200, bytes.size.toLong()) exchange.responseBody.use { it.write(bytes) } } From 3fc5002e09509833a05136ddbb98a1019e04ea60 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 19:04:30 -0800 Subject: [PATCH 07/23] ADFA-7139 AI-Agent-MCP: move the stacked KDoc onto installDebuggerEndpoints The doc describing the host endpoint service sat on startDebuggerEntry above its own KDoc; it belongs to installDebuggerEndpoints, which reads the service. Comment-only change, so no test. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../plugins/aiagentmcp/plugin/McpPlugin.kt | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index 3d4b2f953..cf5fb22c9 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -286,14 +286,6 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { } } - /** - * Points [AutomaticServers] at the host's debugger endpoints. - * - * `plugin.min_ide_version` keeps this plugin off an IDE that lacks the service: such an IDE - * rejects the unknown `debugger.endpoints` permission when it validates the manifest. The catch - * is defence only, for a host that registers no service anyway. A call that later throws (no - * permission, unreadable database) leaves the entries as they were. - */ /** * Installs the host's endpoints and starts listening for changes, unless the activation ends first. * @@ -311,6 +303,14 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { if (!keepGoing()) AutomaticServers.removeEndpointListener(relistAutomatic) } + /** + * Points [AutomaticServers] at the host's debugger endpoints. + * + * `plugin.min_ide_version` keeps this plugin off an IDE that lacks the service: such an IDE + * rejects the unknown `debugger.endpoints` permission when it validates the manifest. The catch + * is defence only, for a host that registers no service anyway. A call that later throws (no + * permission, unreadable database) leaves the entries as they were. + */ private fun installDebuggerEndpoints(keepGoing: () -> Boolean) { val service = try { context.services.get(DebuggerEndpointService::class.java) From 5911aaccaadd9fa7bd454672a3b9f8b0c133eb34 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 19:04:30 -0800 Subject: [PATCH 08/23] ADFA-7139 AI-Agent-MCP: the health probe refreshes nothing once its activation is over probeHealth checked keepGoing only before the delay, then called AutomaticServers.refresh() without it, so a deactivation during the delay (or during the refresh's blocking read) let the refresh restore the automatic entries that install(null) had just cleared, and re-publish them. It now returns if the activation ended during the delay, passes keepGoing to refresh (which checks it after the read, before storing) and re-checks before settingsChanged(). startDebuggerEntry and installDebuggerEndpoints already guard each step. probeHealth is now internal with an intervalMs parameter so a test can drive it. Tests: McpPluginProbeHealthTest (ended during the delay; ended during the refresh read). Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../plugins/aiagentmcp/plugin/McpPlugin.kt | 14 ++-- .../plugin/McpPluginProbeHealthTest.kt | 77 +++++++++++++++++++ 2 files changed, 86 insertions(+), 5 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index cf5fb22c9..4fc17e476 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -207,7 +207,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { startDebuggerEntry { isActive } val refreshed = McpToolCatalog.refreshAll { isActive } if (refreshed > 0 && isActive) settingsChanged() - probeHealth { isActive } + probeHealth({ isActive }) } true } catch (e: Exception) { @@ -257,14 +257,18 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { * Servers are asked in parallel, so one that hangs until its timeout delays no other's tag. * * @param keepGoing false once this activation is over; checked before each probe, since a probe - * blocks on a socket with no suspension point, like [McpToolCatalog.refreshAll]. + * blocks on a socket with no suspension point, like [McpToolCatalog.refreshAll]. Checked again + * after the delay and, inside [AutomaticServers.refresh], after its blocking read: deactivation + * clears the automatic entries, and a refresh that outlived it would restore them. + * @param intervalMs the wait between cycles; a seam for tests. */ - private suspend fun probeHealth(keepGoing: () -> Boolean) { + internal suspend fun probeHealth(keepGoing: () -> Boolean, intervalMs: Long = PROBE_INTERVAL_MS) { var cycle = 0 while (keepGoing()) { - delay(PROBE_INTERVAL_MS) + delay(intervalMs) + if (!keepGoing()) return cycle++ - if (AutomaticServers.refresh()) settingsChanged() + if (AutomaticServers.refresh(keepGoing) && keepGoing()) settingsChanged() val due = McpServers.all().filter { server -> val health = McpServerHealth.of(server.id) server.enabled && health?.refused != true && (cycle % HEALTHY_PROBE_EVERY == 0 || diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt new file mode 100644 index 000000000..a0d34bfde --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt @@ -0,0 +1,77 @@ +package com.itsaky.androidide.plugins.aiagentmcp.plugin + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticEndpoint +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import io.mockk.every +import io.mockk.mockk +import java.util.concurrent.atomic.AtomicBoolean +import java.util.concurrent.atomic.AtomicInteger +import kotlinx.coroutines.runBlocking +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +/** + * The health probe must not refresh or re-publish the automatic entries once its activation is + * over: deactivation has cleared them, and a refresh that outlived it would restore them. + */ +class McpPluginProbeHealthTest { + + private lateinit var plugin: McpPlugin + private val reads = AtomicInteger() + private val active = AtomicBoolean(true) + + @Before + fun setUp() { + AutomaticServers.install(null) + val context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + plugin = McpPlugin().also { it.initialize(context) } + } + + @After + fun tearDown() { + plugin.dispose() + AutomaticServers.install(null) + } + + private var current = emptyList() + private var onRead: () -> Unit = {} + + private fun installSource() { + AutomaticServers.install({ + reads.incrementAndGet() + onRead() + current + }) + } + + @Test + fun `an activation that ends during the delay refreshes nothing`() { + installSource() + current = listOf(AutomaticEndpoint("com.example.app", 4000, "t1")) + val before = reads.get() + // The loop condition sees a live activation; the check after the delay sees it ended. + val asked = AtomicInteger() + + runBlocking { plugin.probeHealth({ asked.incrementAndGet() == 1 }, intervalMs = 10) } + + assertEquals(before, reads.get()) + assertTrue(AutomaticServers.servers().isEmpty()) + } + + @Test + fun `an activation that ends during the refresh read stores nothing`() { + installSource() + current = listOf(AutomaticEndpoint("com.example.app", 4000, "t1")) + onRead = { active.set(false) } + + runBlocking { plugin.probeHealth({ active.get() }, intervalMs = 10) } + + assertTrue(AutomaticServers.servers().isEmpty()) + } +} From 994860ea48693983aa9c55aa679e1e175cb1a2ab Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 21:24:17 -0800 Subject: [PATCH 09/23] ADFA-7139 AI-Agent-MCP: no refresh restores automatic entries after deactivation AutomaticServers.refresh now stores nothing when the source it read is no longer the installed one, so a refresh started by EndpointRetry (default keepGoing) that was in flight when install(null) cleared the entries cannot bring them back. Every caller is covered, not only the ones passing keepGoing. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/debugger/AutomaticServers.kt | 6 ++++- .../plugin/McpPluginProbeHealthTest.kt | 23 ++++++++++++++++++- 2 files changed, 27 insertions(+), 2 deletions(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index c899401be..0be21ef45 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -118,6 +118,10 @@ object AutomaticServers { /** * Re-reads the endpoints. Blocking host call: use a background thread. + * Nothing is stored when the source that was read is no longer installed, so a refresh in + * flight when deactivation cleared the entries (or a later activation replaced the source) + * cannot restore them, whichever caller started it. + * * @param keepGoing checked after the read, before anything is stored. * @return true when the set of entries, a port or a token changed. */ @@ -134,7 +138,7 @@ object AutomaticServers { val moved = mutableListOf() val removed: List val changed = synchronized(this) { - if (!keepGoing()) return false + if (source !== read || !keepGoing()) return false val old = states val next = fresh.mapValues { (id, endpoint) -> val previous = old[id] diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt index a0d34bfde..2704fc576 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginProbeHealthTest.kt @@ -4,8 +4,10 @@ import com.itsaky.androidide.plugins.PluginContext import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticEndpoint import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog import io.mockk.every import io.mockk.mockk +import java.net.ConnectException import java.util.concurrent.atomic.AtomicBoolean import java.util.concurrent.atomic.AtomicInteger import kotlinx.coroutines.runBlocking @@ -17,7 +19,8 @@ import org.junit.Test /** * The health probe must not refresh or re-publish the automatic entries once its activation is - * over: deactivation has cleared them, and a refresh that outlived it would restore them. + * over: deactivation has cleared them, and a refresh that outlived it would restore them. The same + * holds for the endpoint retry's refresh. */ class McpPluginProbeHealthTest { @@ -74,4 +77,22 @@ class McpPluginProbeHealthTest { assertTrue(AutomaticServers.servers().isEmpty()) } + + @Test + fun `an endpoint retry in flight at deactivation restores nothing`() { + installSource() + current = listOf(AutomaticEndpoint("com.example.app", 4000, "t1")) + AutomaticServers.refresh() + val server = AutomaticServers.servers().single() + current = listOf(AutomaticEndpoint("com.example.app", 4001, "t2")) + // Deactivation lands while the retry's refresh is reading the host. + onRead = { AutomaticServers.install(null) } + + try { + McpToolCatalog.retry.call(server) { throw ConnectException("refused") } + } catch (expected: ConnectException) { + } + + assertTrue(AutomaticServers.servers().isEmpty()) + } } From 6e57f6a5ee786360ce834c896a1f557ae610ccf8 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 22:49:35 -0800 Subject: [PATCH 10/23] ADFA-7139 AI-Agent-MCP: tidy the keepGoing KDoc and a duplicate tool-list notification @param keepGoing was documented on the install overload that has no such parameter; it now sits on the two-argument overload that takes it. probeHealth called settingsChanged() after AutomaticServers.refresh returned true. refresh returns true only when it fired its change listeners, and McpPlugin.activate registers settingsChanged on them before probeHealth starts, so the agent was told twice. The call is removed; no test, since the agent is notified exactly as before. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/debugger/AutomaticServers.kt | 14 ++++++++------ .../plugins/aiagentmcp/plugin/McpPlugin.kt | 3 ++- 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index 0be21ef45..bf53c980a 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -63,11 +63,6 @@ object AutomaticServers { /** * Where endpoints come from; null (deactivation) clears every entry. - * - * @param keepGoing false once the activation installing [source] is over. The first read blocks - * and cannot be cancelled, so an activation that ended during it must neither keep [source] - * nor publish what it read: deactivation has already cleared everything, and a later - * activation owns the state now. */ fun install(source: (() -> List)?) { if (source == null) { @@ -79,7 +74,14 @@ object AutomaticServers { } } - /** As [install], for a source that may be superseded while its first read is blocked. */ + /** + * As [install], for a source that may be superseded while its first read is blocked. + * + * @param keepGoing false once the activation installing [source] is over. The first read blocks + * and cannot be cancelled, so an activation that ended during it must neither keep [source] + * nor publish what it read: deactivation has already cleared everything, and a later + * activation owns the state now. + */ fun install(source: () -> List, keepGoing: () -> Boolean) { synchronized(this) { if (!keepGoing()) return diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index 4fc17e476..3b0635433 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -268,7 +268,8 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { delay(intervalMs) if (!keepGoing()) return cycle++ - if (AutomaticServers.refresh(keepGoing) && keepGoing()) settingsChanged() + // A change already told the agent: refresh fires the change listener added on activation. + AutomaticServers.refresh(keepGoing) val due = McpServers.all().filter { server -> val health = McpServerHealth.of(server.id) server.enabled && health?.refused != true && (cycle % HEALTHY_PROBE_EVERY == 0 || From 02704e7451b7471e2f91e1669b6d8f15eeda7621 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 22:49:35 -0800 Subject: [PATCH 11/23] ADFA-7139 AI-Agent-MCP: a cancelled tool call does not run its endpoint retry EndpointRetry runs a call a second time against the re-read endpoint. A cancel landing between the attempts found no live session to drop (the first had ended, the second not begun), so the retry went out anyway. McpToolSource now records a cancel for a running call and the retry's block checks it before opening a session, failing as an interrupted read, which is how a dropped connection already reports a cancel (classified as Cancelled, so the server is not marked degraded). Test: CancelBetweenAttemptsTest cancels from inside the retry's endpoint re-read; without the check the new endpoint receives the retry. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../plugins/aiagentmcp/tools/McpToolSource.kt | 19 ++++ .../debugger/CancelBetweenAttemptsTest.kt | 98 +++++++++++++++++++ 2 files changed, 117 insertions(+) create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt index 010634ccf..0bc2e7eae 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt @@ -12,6 +12,7 @@ import com.itsaky.androidide.plugins.aiagentmcp.plugin.McpPlugin import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer import com.itsaky.androidide.plugins.services.CapabilityStatus import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import java.io.InterruptedIOException import java.util.concurrent.CompletableFuture import java.util.concurrent.ConcurrentHashMap import java.util.concurrent.ExecutorService @@ -42,6 +43,16 @@ class McpToolSource : */ private val liveSessions = ConcurrentHashMap() + /** Calls whose worker is running, so [cancel] knows whether a flag will ever be read. */ + private val running: MutableSet = ConcurrentHashMap.newKeySet() + + /** + * Running calls that were cancelled. The session drop in [cancel] reaches only a request in + * flight; one landing between the two attempts of the endpoint retry finds no session, so the + * retry reads this before it sends anything. + */ + private val cancelled: MutableSet = ConcurrentHashMap.newKeySet() + /** * Remote calls run here rather than on the common pool: an MCP call blocks on a socket for as * long as the read timeout, and the common pool is sized for CPU work. @@ -114,6 +125,7 @@ class McpToolSource : override fun cancel(callId: String) { inFlight.remove(callId)?.cancel(true) + if (callId in running) cancelled += callId // The worker is blocked on a socket read, where an interrupt does nothing; dropping the // connection is what actually ends it. Only this call's, so a concurrent call against // another server keeps its socket. @@ -141,7 +153,11 @@ class McpToolSource : tool: McpTool, arguments: Map, ): ToolSourceRegistry.ToolOutcome = try { + running += callId val result = McpToolCatalog.retry.call(server) { target -> + // Cancelled between two attempts (or before the first): nothing is sent. Signalled as + // an interrupted read, which is how a dropped connection already reports a cancel. + if (callId in cancelled) throw InterruptedIOException("Tool call $callId was cancelled") val session = McpConnections.session(target) liveSessions[callId] = session try { @@ -158,6 +174,9 @@ class McpToolSource : McpToolCatalog.recordFailure(server, e) val context = McpPlugin.getContext()?.androidContext Outcome(false, "", McpErrorFormatter.format(context, server.name, e)) + } finally { + running -= callId + cancelled -= callId } /** diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt new file mode 100644 index 000000000..901d4ec4c --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt @@ -0,0 +1,98 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.plugin.McpPlugin +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion.tool +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolSource +import com.itsaky.androidide.plugins.security.KeystoreSecretStore +import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import io.mockk.every +import io.mockk.mockk +import io.mockk.mockkObject +import io.mockk.unmockkObject +import java.util.concurrent.TimeUnit +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + + +/** A cancel that lands between the endpoint retry's two attempts must stop the second one. */ +class CancelBetweenAttemptsTest { + + private val app = "com.example.app" + private val servers = mutableListOf() + private val source = McpToolSource() + private lateinit var plugin: McpPlugin + + @Before + fun setUp() { + val context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + plugin = McpPlugin().also { it.initialize(context) } + // The Keystore is not there on the JVM; a hand-added server in these tests has no secrets. + mockkObject(McpServerStore) + every { McpServerStore.token(any()) } returns KeystoreSecretStore.Stored.Absent + every { McpServerStore.headers(any()) } returns emptyMap() + } + + @After + fun tearDown() { + source.close() + AutomaticServers.install(null) + McpConnections.closeAll() + McpToolCatalog.clear() + servers.forEach { it.stop() } + plugin.dispose() + unmockkObject(McpServerStore) + } + + private fun fake(token: String, vararg tools: org.json.JSONObject) = + FakeMcpServer(token, tools.toList()).also { servers += it } + + private fun offered(): Map = + source.listTools().associateBy { it.name } + + private fun invoke(name: String): java.util.concurrent.CompletableFuture = + source.invoke( + mockk { + every { toolName } returns name + every { arguments } returns emptyMap() + every { callId } returns "call-1" + } + ) + + @Test + fun `a cancel between the attempts sends nothing to the new endpoint`() { + val first = fake("t1", tool("list_tables", true)) + var stored = listOf(AutomaticEndpoint(app, first.port, "t1")) + var cancelOnRead = false + AutomaticServers.install { + if (cancelOnRead) source.cancel("call-1") + stored + } + McpToolCatalog.connect(AutomaticServers.servers().single()) + val name = offered().keys.single() + + // The app relaunches: the first attempt is refused, and the retry's re-read is where the + // cancel lands. + first.stop() + val second = fake("t2", tool("list_tables", true)) + stored = listOf(AutomaticEndpoint(app, second.port, "t2")) + cancelOnRead = true + val future = invoke(name) + + // The agent's future is cancelled with the call; the worker behind it is what must stop. + // Bounded wait: without the check the retry reaches the new endpoint within milliseconds. + val deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(2) + while (second.requests.isEmpty() && System.nanoTime() < deadline) Thread.sleep(20) + assertTrue(future.isCompletedExceptionally) + assertTrue("the retry was sent anyway: ${second.requests}", second.requests.isEmpty()) + } +} From d102bfe9c6de22c5d13a16e2164861fd0ee651e7 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 22:50:08 -0800 Subject: [PATCH 12/23] ADFA-7139 AI-Agent-MCP: tell each app's SQLite debugger tools apart by name and description Every SQLite debugger entry is named "SQLite debugger ()" and tool names use the first 10 identifier characters of the server name, so every entry's tools began sqlite_deb. With two apps reporting, the model saw sqlite_deb_query and sqlite_deb_query_2 with identical descriptions, and which app got "_2" followed the host's row order. Now, for automatic entries only: - the name prefix is db_ plus the first 7 characters of the application ID's last segment (db_notes_query); apps whose prefix would be shared (com.a.notes, com.b.notes) both use the first 5 characters of the segment plus 4 hex digits of a digest of the full application ID (notes_3fa1_query). It depends only on the set of IDs, so it is stable across restarts and row order, and stays within the 10-character prefix rule. The collision set is every automatic entry, not only those with tools on. - each description starts " (SQLite debugger): ", so the model and the approval dialog name the app. Hand-added servers keep McpToolText.exposedName(server.name, ...) and their own description. What depends on the names or descriptions: - ReadOnlyTrust.enabledTools and the stored knownTools/enabledTools use the server's own tool names (query), not the exposed ones: unchanged. - The tool source registration with AI-Core (listTools/getToolGroups): the exposed names and descriptions of these tools change once, on upgrade; group ids and display names do not. Calls resolve by exposed name from the same list, so listing and invoking agree. - AI-Core's session-grant key (addons#167, ContributedToolHandler.sessionApprovalKey = provider:tool name:digest(description, schema)): it changes once for these tools, so a grant given to the old text is not carried over, and it now differs per app, so an "Always Allow" for one app's query no longer covers another's. Tests: AppToolNamesTest (two apps; two with the same last segment, both row orders; one app with a hand-added server unchanged), McpToolTextTest (appPrefixes). Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 9 ++ .../aiagentmcp/debugger/AutomaticServers.kt | 3 + .../plugins/aiagentmcp/tools/McpToolSource.kt | 37 ++++- .../plugins/aiagentmcp/tools/McpToolText.kt | 46 ++++++ .../aiagentmcp/debugger/AppToolNamesTest.kt | 136 ++++++++++++++++++ .../aiagentmcp/tools/McpToolTextTest.kt | 19 +++ 6 files changed, 246 insertions(+), 4 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index 3e1f4544c..1268b9a5d 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -59,6 +59,15 @@ points the entry at `http://127.0.0.1:/mcp`. A relaunched app gets a new port and token, and the plugin reads them again after a refused connection. An app that has not reported yet has no entry, and no error is shown. +Each app's tools are told apart for the model. Their names start with `db_` and +the last segment of the application ID (`db_notes_query` for +`com.example.notes`); when two apps would share that prefix, both use the first +five characters of the segment and four hex digits derived from the full +application ID (`notes_3fa1_query`), so a name never depends on which app was +read first. Each description starts with the application ID, as +"com.example.notes (SQLite debugger): ...", and the approval dialog shows it. +Servers you add yourself keep the name prefix taken from their label. + - It is held in memory only and is **not shown in the settings screen in this version**, so there is no switch to turn it off there. - The tools that declare MCP's `readOnlyHint: true` start switched **on**. Any diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index bf53c980a..58701d1d4 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -220,6 +220,9 @@ object AutomaticServers { fun idFor(applicationId: String) = ID_PREFIX + applicationId + /** The application ID an automatic entry's id was made from. */ + fun applicationIdOf(serverId: String) = serverId.removePrefix(ID_PREFIX) + private fun fireChanged() { for (l in listeners) runCatching { l() } } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt index 0bc2e7eae..7f0dd210d 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt @@ -4,6 +4,7 @@ import android.util.Log import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections import com.itsaky.androidide.plugins.aiagentmcp.client.McpSession import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers import com.itsaky.androidide.plugins.aiagentmcp.debugger.McpServers import com.itsaky.androidide.plugins.aiagentmcp.errors.McpErrorFormatter import com.itsaky.androidide.plugins.aiagentmcp.R @@ -68,7 +69,7 @@ class McpToolSource : override fun listTools(): List = exposedTools().map { exposed -> Spec( name = exposed.name, - description = exposed.tool.description, + description = exposed.description, parametersSchema = exposed.tool.inputSchema, preApproved = exposed.server.automatic && exposed.tool.readOnlyHint, ) @@ -222,8 +223,20 @@ class McpToolSource : val exposed = mutableListOf() val taken = mutableSetOf() + // From every automatic entry, not only those offering tools, so a prefix does not change + // when another app's tools are switched off or its tool list is still empty. + val appPrefixes = McpToolText.appPrefixes( + McpServers.all().filter { it.automatic }.map { AutomaticServers.applicationIdOf(it.id) }, + ) for ((server, tool) in enabledTools()) { - val base = McpToolText.exposedName(server.name, tool.name) + val base = if (server.automatic) { + McpToolText.exposedNameWithPrefix( + appPrefixes.getValue(AutomaticServers.applicationIdOf(server.id)), + tool.name, + ) + } else { + McpToolText.exposedName(server.name, tool.name) + } if (base == null) { Log.w(TAG, "Dropping a tool from '${server.name}': its name has nothing usable") continue @@ -237,7 +250,7 @@ class McpToolSource : Log.i(TAG, "'${tool.name}' on '${server.name}' shares a name; offering it as '$name'") } taken += name - exposed += Exposed(server, tool, name) + exposed += Exposed(server, tool, name, describe(server, tool)) } return exposed } @@ -248,7 +261,23 @@ class McpToolSource : * @property tool the tool, as the server described it. * @property name the name the agent and the model see. */ - private class Exposed(val server: McpServer, val tool: McpTool, val name: String) + private class Exposed( + val server: McpServer, + val tool: McpTool, + val name: String, + val description: String, + ) + + /** + * The description the model and the approval dialog see. A SQLite debugger tool starts with + * its application ID: every entry's tools say the same thing otherwise, and the model could + * not tell which app's database one reads. A hand-added server's text is passed through. + */ + private fun describe(server: McpServer, tool: McpTool): String { + if (!server.automatic) return tool.description + val app = "${AutomaticServers.applicationIdOf(server.id)} (SQLite debugger)" + return if (tool.description.isBlank()) app else "$app: ${tool.description}" + } /** * One tool, as the host contract describes it. diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt index 18291c736..781cf00f0 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt @@ -33,6 +33,52 @@ object McpToolText { return if (prefix.isEmpty()) tool else "${prefix}_$tool" } + /** + * As [exposedName], for a prefix that is already decided (see [appPrefixes]). + * @param prefix a sanitised prefix of at most [MAX_PREFIX_LENGTH] characters. + */ + fun exposedNameWithPrefix(prefix: String, toolName: String): String? { + val tool = identifier(toolName).take(MAX_NAME_LENGTH).trim('_') + if (tool.isEmpty()) return null + return if (prefix.isEmpty()) tool else "${prefix}_$tool" + } + + /** + * The name prefix of each SQLite debugger entry, told apart by app. + * + * The server label cannot do it: every entry is labelled "SQLite debugger (...)", and the + * first [MAX_PREFIX_LENGTH] characters of that are the same for all of them. The prefix is + * `db_` and the first seven characters of the application ID's last segment. Entries whose + * prefix would still be shared (`com.a.notes` and `com.b.notes`) all take the first five + * characters of the segment and four hex digits of a digest of the full application ID + * instead. Both forms depend only on the set of application IDs, never on their order, and + * fit [MAX_PREFIX_LENGTH]. + * + * @param applicationIds the application ID of every entry. + * @return the prefix by application ID. + */ + fun appPrefixes(applicationIds: Collection): Map { + val ids = applicationIds.distinct() + val plain = ids.associateWith { id -> + "db_" + segment(id).take(MAX_PREFIX_LENGTH - 3).trim('_') + } + val shared = plain.values.groupingBy { it }.eachCount() + return ids.associateWith { id -> + if (shared.getValue(plain.getValue(id)) == 1) { + plain.getValue(id) + } else { + segment(id).take(5).trim('_') + "_" + digest(id) + } + } + } + + private fun segment(applicationId: String): String = + identifier(applicationId.substringAfterLast('.')).ifEmpty { "app" } + + private fun digest(text: String): String = + java.security.MessageDigest.getInstance("SHA-256").digest(text.toByteArray()) + .take(2).joinToString("") { "%02x".format(it) } + /** * A free variant of [name], numbered when two tools ended up sharing one exposed name. * diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt new file mode 100644 index 000000000..e1ab30db6 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt @@ -0,0 +1,136 @@ +package com.itsaky.androidide.plugins.aiagentmcp.debugger + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.plugin.McpPlugin +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion.tool +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolSource +import com.itsaky.androidide.plugins.security.KeystoreSecretStore +import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import io.mockk.every +import io.mockk.mockk +import io.mockk.mockkObject +import io.mockk.unmockkObject +import java.util.concurrent.TimeUnit +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertFalse +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + + +/** + * What the model is told for each SQLite debugger entry: tools that differ per app in name and + * description, so two apps reporting for one project are never confused. + */ +class AppToolNamesTest { + + private val servers = mutableListOf() + private val source = McpToolSource() + private lateinit var plugin: McpPlugin + + @Before + fun setUp() { + val context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + plugin = McpPlugin().also { it.initialize(context) } + // The Keystore is not there on the JVM; a hand-added server in these tests has no secrets. + mockkObject(McpServerStore) + every { McpServerStore.token(any()) } returns KeystoreSecretStore.Stored.Absent + every { McpServerStore.headers(any()) } returns emptyMap() + } + + @After + fun tearDown() { + source.close() + AutomaticServers.install(null) + McpConnections.closeAll() + McpToolCatalog.clear() + servers.forEach { it.stop() } + plugin.dispose() + unmockkObject(McpServerStore) + } + + private fun fake(token: String, vararg tools: org.json.JSONObject) = + FakeMcpServer(token, tools.toList()).also { servers += it } + + private fun offered(): Map = + source.listTools().associateBy { it.name } + + private fun invoke(name: String): ToolSourceRegistry.ToolOutcome = + source.invoke( + mockk { + every { toolName } returns name + every { arguments } returns emptyMap() + every { callId } returns "call-1" + } + ).get(30, TimeUnit.SECONDS) + + private fun debuggerTools() = arrayOf(tool("list_tables", true), tool("run_sql", false), tool("unmarked", null)) + + private fun connectAll(vararg apps: Pair, reversed: Boolean = false) { + val endpoints = apps.map { (id, server) -> AutomaticEndpoint(id, server.port, server.token) } + AutomaticServers.install { if (reversed) endpoints.reversed() else endpoints } + AutomaticServers.servers().forEach { McpToolCatalog.connect(it) } + } + + /** The exposed names by application ID, read from each description. */ + private fun byApp(): Map> = offered().values.associate { + it.description.substringBefore(" (SQLite debugger)") to (it.name to it.description) + } + + @Test + fun `two apps get distinct tool names and descriptions naming each app`() { + connectAll( + "com.example.notes" to fake("a", tool("query", true)), + "com.example.shop" to fake("b", tool("query", true)), + ) + + val apps = byApp() + assertEquals(setOf("com.example.notes", "com.example.shop"), apps.keys) + assertEquals("db_notes_query", apps.getValue("com.example.notes").first) + assertEquals("db_shop_query", apps.getValue("com.example.shop").first) + assertEquals("com.example.notes (SQLite debugger): query", apps.getValue("com.example.notes").second) + } + + @Test + fun `apps sharing a last segment stay distinct and keep their names whatever the row order`() { + val one = "com.alpha.notes" + val two = "com.beta.notes" + connectAll(one to fake("a", tool("query", true)), two to fake("b", tool("query", true))) + val forward = byApp() + assertEquals(2, forward.values.map { it.first }.toSet().size) + assertTrue(forward.getValue(one).first.length <= 10 + "_query".length) + + AutomaticServers.install(null) + McpToolCatalog.clear() + servers.forEach { it.stop() } + servers.clear() + connectAll(one to fake("a", tool("query", true)), two to fake("b", tool("query", true)), reversed = true) + + assertEquals(forward, byApp()) + } + + @Test + fun `a single app still works and a hand-added server keeps its name and description`() { + val debugger = fake("a", tool("query", true)) + connectAll("com.example.notes" to debugger) + val mine = fake("", tool("claims", true)) + val handAdded = McpServerStore.saveDetails( + McpServerStore.newServer("Company Docs", "http://127.0.0.1:${mine.port}/mcp") + ) + McpToolCatalog.connect(handAdded) + McpServerStore.setToolEnabled(handAdded.id, "claims", true) + + val specs = offered() + assertEquals(setOf("db_notes_query", "company_do_claims"), specs.keys) + assertEquals("claims", specs.getValue("company_do_claims").description) + val outcome = invoke("db_notes_query") + assertTrue(outcome.errorMessage, outcome.isSuccess) + } +} diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolTextTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolTextTest.kt index 41e7afe3a..a7a0c6374 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolTextTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolTextTest.kt @@ -2,6 +2,7 @@ package com.itsaky.androidide.plugins.aiagentmcp.tools import org.junit.Assert.assertEquals import org.junit.Assert.assertNull +import org.junit.Assert.assertTrue import org.junit.Test /** @@ -59,4 +60,22 @@ class McpToolTextTest { assertNull(McpToolText.disambiguate("git_search", taken)) } + + @Test + fun givenAppIds_whenPrefixed_thenEachAppGetsItsOwnShortStablePrefix() { + val ids = listOf("com.example.notes", "com.example.shop", "org.other.Notes") + val prefixes = McpToolText.appPrefixes(ids) + assertEquals("db_shop", prefixes.getValue("com.example.shop")) + // The two notes apps share a segment: both fall back to segment plus digest. + val a = prefixes.getValue("com.example.notes") + val b = prefixes.getValue("org.other.Notes") + assertEquals(2, setOf(a, b).size) + assertTrue(a.startsWith("notes_") && a.length <= 10) + assertEquals(prefixes, McpToolText.appPrefixes(ids.reversed())) + } + + @Test + fun givenAnAppIdWithNothingUsable_whenPrefixed_thenItStillGetsAName() { + assertEquals("db_app", McpToolText.appPrefixes(listOf("com.example.***")).getValue("com.example.***")) + } } From 96b49e3996e57057be5aa966e916cd5c4c7b727f Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 23:09:17 -0800 Subject: [PATCH 13/23] ADFA-7139 AI-Agent-MCP: switch on only the SQLite debugger's four core tools An SQLite debugger entry now starts with list_databases, get_schema, query and get_events switched on, each only when the server advertises it with readOnlyHint: true. Its other tools stay known but off. A tool without readOnlyHint exactly true is still never switched on; hand-added servers are unchanged. This changes ADFA-7139's earlier rule, under which every read-only tool started on. Why: AI-Core describes at most 12 contributed tools per message (4 in compact mode), in order, and drops the rest, and every app has its own entry. With all 8 read-only tools on, two apps used the whole normal budget and a hand-added server pushed SQLite debugger tools out silently. Phase 2 adds the entry to settings so a user can switch the others on. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 16 +++++--- plugins/AI-Agent-MCP/ai-agent-mcp.html | 5 ++- .../aiagentmcp/debugger/ReadOnlyTrust.kt | 29 +++++++++++--- .../plugins/aiagentmcp/settings/McpServer.kt | 3 +- .../aiagentmcp/debugger/AppToolNamesTest.kt | 2 +- .../debugger/AutomaticServersTest.kt | 39 ++++++++++++++----- .../debugger/CancelBetweenAttemptsTest.kt | 4 +- .../debugger/ReadOnlyHintParsingTest.kt | 21 ++++++++-- .../debugger/RelaunchToolSourceTest.kt | 4 +- 9 files changed, 92 insertions(+), 31 deletions(-) diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index 1268b9a5d..b3780e9b8 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -36,8 +36,8 @@ Configuration → MCP servers**: 1. **Add server** — name, endpoint URL, optional token. 2. **Connect** — saves the server, performs the MCP handshake and lists the tools it offers, all in one step. -3. Switch on the tools you want. **They start off** (except the read-only tools - of the automatic debugger entry, below): one popular GitHub server +3. Switch on the tools you want. **They start off** (except four read-only tools + of the automatic SQLite debugger entry, below): one popular GitHub server advertises around ninety tools, which would fill a phone-sized context window on its own. 4. **Clear stored credential** — removes the stored token and headers. The token @@ -70,9 +70,15 @@ Servers you add yourself keep the name prefix taken from their label. - It is held in memory only and is **not shown in the settings screen in this version**, so there is no switch to turn it off there. -- The tools that declare MCP's `readOnlyHint: true` start switched **on**. Any - other tool of that entry starts off. The hint is trusted for this entry only, - never for a server you add yourself. +- Four tools start switched **on**: `list_databases`, `get_schema`, `query` and + `get_events`, each only when the server declares MCP's `readOnlyHint: true` for + it. Every other tool of that entry (today `list_connections`, + `explain_query_plan`, `get_stats` and `integrity_check`) starts off, and so + does any tool without that hint. The hint is trusted for this entry only, never + for a server you add yourself. Four, not all eight, because AI-Core describes + at most 12 contributed tools per message (4 for a small on-device model), in + order, and drops the rest; every app has its own entry. Switching the others + on will come with showing this entry in the settings screen (phase 2). - The Agent still asks for approval on every call: AI-Core makes every contributed tool ask (it ignores the tool's own `requiresApproval`). Approving read-only calls automatically is tracked in ADFA-7147. diff --git a/plugins/AI-Agent-MCP/ai-agent-mcp.html b/plugins/AI-Agent-MCP/ai-agent-mcp.html index 92f0cf1ea..410a38967 100644 --- a/plugins/AI-Agent-MCP/ai-agent-mcp.html +++ b/plugins/AI-Agent-MCP/ai-agent-mcp.html @@ -141,8 +141,9 @@

Usage

New tools always arrive switched off, including on the connection - that discovers them. The one exception is the read-only tools of the SQLite - debugger entry that Code on the Go supplies for your own debug app. Nothing a server adds later becomes visible to the model + that discovers them. The one exception is four read-only tools (list databases, get schema, + query and get events) of the SQLite debugger entry that Code on the Go + supplies for your own debug app. Nothing a server adds later becomes visible to the model without your say-so.
diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt index d19cae5b1..36efda224 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyTrust.kt @@ -3,23 +3,42 @@ package com.itsaky.androidide.plugins.aiagentmcp.debugger import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool /** - * Which tools of the automatic debugger entry start switched on, and which this plugin declares read-only. + * Which tools of an automatic SQLite debugger entry start switched on, and which this plugin declares + * read-only. * * Declaring a tool read-only does not skip the approval dialog today: AI-Core overrides * `requiresApproval` to true for every contributed tool (`ContributedToolHandler`), so the Agent still * asks on each call until automatic approval exists (ADFA-7147). * - * Only that entry may use this: the hint is the server's own claim, and the debugger endpoint is the - * one server whose code the IDE itself installed. A server the user adds by hand is never asked. + * Only that entry may use this: the hint is the server's own claim, and the SQLite debugger endpoint + * is the one server whose code the IDE itself installed. A server the user adds by hand is never asked. */ object ReadOnlyTrust { + /** + * The only tools of an SQLite debugger entry that start switched on, and only when the server + * advertises them with `readOnlyHint: true`. Its other tools (today `list_connections`, + * `explain_query_plan`, `get_stats` and `integrity_check`) stay known but off. + * + * Why four: AI-Core describes at most 12 contributed tools per message + * (`PromptToolBudget.MAX_CONTRIBUTED_TOOLS`) and only 4 in compact mode + * (`COMPACT_MAX_CONTRIBUTED_TOOLS`), counting them in order and dropping the rest. Every app + * gets its own entry, so with all 8 read-only tools on, two apps alone would use the whole + * normal budget. With four each, two apps use 8 of 12 and in compact mode the first app's four + * fill the budget. A hand-added server's tools are listed before any app's, so one with ten or + * more switched-on tools leaves room for only two of an app's four (none in compact mode). + * + * Phase 2 adds the SQLite debugger entry to AI-Agent-MCP's settings, so a user can switch the + * others on. + */ + val CORE_TOOLS: Set = linkedSetOf("list_databases", "get_schema", "query", "get_events") + /** * @param tools what `tools/list` returned. - * @return the names of the tools that declared `annotations.readOnlyHint` as boolean true. + * @return the names of the [CORE_TOOLS] that declared `annotations.readOnlyHint` as boolean true. */ fun enabledTools(tools: List): Set = - tools.filter { it.readOnlyHint }.mapTo(linkedSetOf()) { it.name } + tools.filter { it.readOnlyHint && it.name in CORE_TOOLS }.mapTo(linkedSetOf()) { it.name } /** * Reads the hint from one `tools/list` entry's `annotations`. diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt index eb29222ea..95bbeffaa 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServer.kt @@ -14,7 +14,8 @@ package com.itsaky.androidide.plugins.aiagentmcp.settings * @property enabledTools the tools the user switched on; empty is the default, so a new server * contributes nothing until its tools are chosen deliberately. * @property automatic true for the entry Code on the Go supplies for a debuggable app: never - * stored, no Keystore token, and the only kind whose read-only tools start on. + * stored, no Keystore token, and the only kind with tools that start on (four read-only ones, + * see `ReadOnlyTrust.CORE_TOOLS`). */ data class McpServer( val id: String, diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt index e1ab30db6..04093db5c 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt @@ -71,7 +71,7 @@ class AppToolNamesTest { } ).get(30, TimeUnit.SECONDS) - private fun debuggerTools() = arrayOf(tool("list_tables", true), tool("run_sql", false), tool("unmarked", null)) + private fun debuggerTools() = arrayOf(tool("list_databases", true), tool("run_sql", false), tool("unmarked", null)) private fun connectAll(vararg apps: Pair, reversed: Boolean = false) { val endpoints = apps.map { (id, server) -> AutomaticEndpoint(id, server.port, server.token) } diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt index e313a7f11..660784420 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt @@ -72,14 +72,14 @@ class AutomaticServersTest { var current = listOf(endpoint()) AutomaticServers.install { current } val id = AutomaticServers.idFor("com.example.app") - AutomaticServers.recordTools(id, endpoint(), listOf(McpTool("q", "", readOnlyHint = true))) + AutomaticServers.recordTools(id, endpoint(), listOf(McpTool("query", "", readOnlyHint = true))) current = listOf(endpoint(port = 4002)) AutomaticServers.refresh() val server = AutomaticServers.servers().single() - assertEquals(listOf("q"), server.knownTools) - assertEquals(setOf("q"), server.enabledTools) + assertEquals(listOf("query"), server.knownTools) + assertEquals(setOf("query"), server.enabledTools) assertTrue(server.url.endsWith(":4002/mcp")) } @@ -161,22 +161,41 @@ class AutomaticServersTest { } @Test - fun `only readOnlyHint tools of the automatic entry start on`() { + fun `only readOnlyHint core tools of the automatic entry start on`() { AutomaticServers.install { listOf(endpoint()) } val id = AutomaticServers.idFor("com.example.app") AutomaticServers.recordTools( id, endpoint(), listOf( - McpTool("reads", "", readOnlyHint = true), - McpTool("writes", "", readOnlyHint = false), - McpTool("unmarked", ""), + McpTool("query", "", readOnlyHint = true), + McpTool("get_stats", "", readOnlyHint = true), + McpTool("get_schema", "", readOnlyHint = false), + McpTool("get_events", ""), ), ) val server = AutomaticServers.servers().single() - assertEquals(listOf("reads", "writes", "unmarked"), server.knownTools) - assertEquals(setOf("reads"), server.enabledTools) - assertEquals(listOf("reads"), server.activeTools) + assertEquals(listOf("query", "get_stats", "get_schema", "get_events"), server.knownTools) + assertEquals(setOf("query"), server.enabledTools) + assertEquals(listOf("query"), server.activeTools) + } + + @Test + fun `the four core tools start on and the other four stay known but off`() { + AutomaticServers.install { listOf(endpoint()) } + val names = listOf( + "list_connections", "list_databases", "get_schema", "query", + "explain_query_plan", "get_stats", "integrity_check", "get_events", + ) + AutomaticServers.recordTools( + AutomaticServers.idFor("com.example.app"), + endpoint(), + names.map { McpTool(it, "", readOnlyHint = true) }, + ) + + val server = AutomaticServers.servers().single() + assertEquals(names, server.knownTools) + assertEquals(setOf("list_databases", "get_schema", "query", "get_events"), server.enabledTools) } } diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt index 901d4ec4c..08134d1d6 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/CancelBetweenAttemptsTest.kt @@ -70,7 +70,7 @@ class CancelBetweenAttemptsTest { @Test fun `a cancel between the attempts sends nothing to the new endpoint`() { - val first = fake("t1", tool("list_tables", true)) + val first = fake("t1", tool("list_databases", true)) var stored = listOf(AutomaticEndpoint(app, first.port, "t1")) var cancelOnRead = false AutomaticServers.install { @@ -83,7 +83,7 @@ class CancelBetweenAttemptsTest { // The app relaunches: the first attempt is refused, and the retry's re-read is where the // cancel lands. first.stop() - val second = fake("t2", tool("list_tables", true)) + val second = fake("t2", tool("list_databases", true)) stored = listOf(AutomaticEndpoint(app, second.port, "t2")) cancelOnRead = true val future = invoke(name) diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt index dc940d7c4..74c724506 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/ReadOnlyHintParsingTest.kt @@ -59,8 +59,23 @@ class ReadOnlyHintParsingTest { @Test fun `json null is not`() = assertFalse(hint(JSONObject.NULL).readOnlyHint) @Test - fun `trust enables exactly the true ones`() { - val tools = listOf(McpTool("a", "", readOnlyHint = true), McpTool("b", "")) - assertEquals(setOf("a"), ReadOnlyTrust.enabledTools(tools)) + fun `trust enables exactly the core tools that declared true`() { + val tools = listOf( + McpTool("query", "", readOnlyHint = true), + McpTool("get_schema", ""), + McpTool("get_stats", "", readOnlyHint = true), + ) + assertEquals(setOf("query"), ReadOnlyTrust.enabledTools(tools)) + } + + @Test + fun `the core tools are exactly these four`() { + assertEquals(setOf("list_databases", "get_schema", "query", "get_events"), ReadOnlyTrust.CORE_TOOLS) + } + + @Test + fun `a query tool that is not read only stays off`() { + val tools = listOf(McpTool("query", "", readOnlyHint = false), McpTool("list_databases", "")) + assertEquals(emptySet(), ReadOnlyTrust.enabledTools(tools)) } } diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt index a0b33707e..918a694ab 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/RelaunchToolSourceTest.kt @@ -68,7 +68,7 @@ class RelaunchToolSourceTest { } ).get(30, TimeUnit.SECONDS) - private fun debuggerTools() = arrayOf(tool("list_tables", true), tool("run_sql", false), tool("unmarked", null)) + private fun debuggerTools() = arrayOf(tool("list_databases", true), tool("run_sql", false), tool("unmarked", null)) @Test fun `a relaunch keeps the read-only tools offered and the next call reaches the new endpoint`() { @@ -98,7 +98,7 @@ class RelaunchToolSourceTest { McpToolCatalog.connect(AutomaticServers.servers().single()) val spec = offered().values.single() - assertTrue(spec.name.endsWith("list_tables")) + assertTrue(spec.name.endsWith("list_databases")) assertFalse(spec.requiresApproval()) assertTrue(spec.isReadOnly) } From eb97b3a1f1d22cd2f287e0a0f12b19275c6894ed Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 23:09:26 -0800 Subject: [PATCH 14/23] ADFA-7139 AI-Agent-MCP: README names the seven-character app prefix; exposedName reuses exposedNameWithPrefix README: SQLite debugger tool names keep the first seven characters of the application ID's last segment (com.example.myapplication gives db_myappli_query), not the whole segment. McpToolText: exposedName repeated the body of exposedNameWithPrefix; it now sanitises the server label and calls it. No behaviour change. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 5 +++-- .../androidide/plugins/aiagentmcp/tools/McpToolText.kt | 8 ++------ 2 files changed, 5 insertions(+), 8 deletions(-) diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index b3780e9b8..a380a1b06 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -60,8 +60,9 @@ port and token, and the plugin reads them again after a refused connection. An app that has not reported yet has no entry, and no error is shown. Each app's tools are told apart for the model. Their names start with `db_` and -the last segment of the application ID (`db_notes_query` for -`com.example.notes`); when two apps would share that prefix, both use the first +the first seven characters of the application ID's last segment +(`db_notes_query` for `com.example.notes`, `db_myappli_query` for +`com.example.myapplication`); when two apps would share that prefix, both use the first five characters of the segment and four hex digits derived from the full application ID (`notes_3fa1_query`), so a name never depends on which app was read first. Each description starts with the application ID, as diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt index 781cf00f0..faa798dbe 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolText.kt @@ -26,12 +26,8 @@ object McpToolText { * @param toolName the tool's own name. * @return the exposed name, or null when nothing usable survives sanitising. */ - fun exposedName(serverName: String, toolName: String): String? { - val tool = identifier(toolName).take(MAX_NAME_LENGTH).trim('_') - if (tool.isEmpty()) return null - val prefix = identifier(serverName).take(MAX_PREFIX_LENGTH).trim('_') - return if (prefix.isEmpty()) tool else "${prefix}_$tool" - } + fun exposedName(serverName: String, toolName: String): String? = + exposedNameWithPrefix(identifier(serverName).take(MAX_PREFIX_LENGTH).trim('_'), toolName) /** * As [exposedName], for a prefix that is already decided (see [appPrefixes]). From 71222087274b98927013a80803b40e6fe1ffce80 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Mon, 16 Nov 2026 23:10:38 -0800 Subject: [PATCH 15/23] ADFA-7139 AI-Agent-MCP: read the server list once when naming the tools to offer exposedTools read the server list for the app prefixes and again for the tool loop, so an app listed between the two reads had tools but no prefix and getValue threw. It now reads the list once and uses that snapshot for both. Test: a source whose second read of the list differs; the listing now reads once. Co-Authored-By: Claude Sonnet 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../plugins/aiagentmcp/tools/McpToolSource.kt | 12 +++++++---- .../aiagentmcp/debugger/AppToolNamesTest.kt | 21 +++++++++++++++++++ 2 files changed, 29 insertions(+), 4 deletions(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt index 7f0dd210d..81d2e37af 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt @@ -192,10 +192,11 @@ class McpToolSource : /** * Every enabled tool of every enabled server, paired with its server. + * @param servers one snapshot of the server list, so the caller's other reads agree with it. * @return the pairs, in configured order. */ - private fun enabledTools(): List> = - McpServers.all() + private fun enabledTools(servers: List): List> = + servers .filter { it.enabled } .flatMap { server -> McpToolCatalog.tools(server.id) @@ -223,12 +224,15 @@ class McpToolSource : val exposed = mutableListOf() val taken = mutableSetOf() + // Read once: an app listed between two reads would have tools here but no prefix below. + val servers = McpServers.all() + // From every automatic entry, not only those offering tools, so a prefix does not change // when another app's tools are switched off or its tool list is still empty. val appPrefixes = McpToolText.appPrefixes( - McpServers.all().filter { it.automatic }.map { AutomaticServers.applicationIdOf(it.id) }, + servers.filter { it.automatic }.map { AutomaticServers.applicationIdOf(it.id) }, ) - for ((server, tool) in enabledTools()) { + for ((server, tool) in enabledTools(servers)) { val base = if (server.automatic) { McpToolText.exposedNameWithPrefix( appPrefixes.getValue(AutomaticServers.applicationIdOf(server.id)), diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt index 04093db5c..48b210049 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AppToolNamesTest.kt @@ -15,6 +15,7 @@ import io.mockk.every import io.mockk.mockk import io.mockk.mockkObject import io.mockk.unmockkObject +import io.mockk.verify import java.util.concurrent.TimeUnit import org.junit.After import org.junit.Assert.assertEquals @@ -116,6 +117,26 @@ class AppToolNamesTest { assertEquals(forward, byApp()) } + @Test + fun `an app listed between two reads of the server list cannot break the listing`() { + connectAll( + "com.example.notes" to fake("a", tool("query", true)), + "com.example.shop" to fake("b", tool("query", true)), + ) + val full = McpServers.all() + val before = full.filter { AutomaticServers.applicationIdOf(it.id) == "com.example.notes" } + // A second read would see the newly listed app; the listing must not make one. + mockkObject(McpServers) + try { + every { McpServers.all() } returnsMany listOf(before, full) andThen full + + assertEquals(setOf("db_notes_query"), source.listTools().map { it.name }.toSet()) + verify(exactly = 1) { McpServers.all() } + } finally { + unmockkObject(McpServers) + } + } + @Test fun `a single app still works and a hand-added server keeps its name and description`() { val debugger = fake("a", tool("query", true)) From 57477d2e2c31dafbec8e7724bc313505e7e3923c Mon Sep 17 00:00:00 2001 From: David Schachter Date: Tue, 17 Nov 2026 18:45:40 -0800 Subject: [PATCH 16/23] ADFA-7139 AI-Agent-MCP: an Error from the host no longer crashes Code on the Go A plugin-api that does not match the host's fails with an Error (AbstractMethodError, NoSuchMethodError, another LinkageError), not an Exception. AutomaticServers.refresh caught only Exception around its read of DebuggerEndpointService.endpoints, so such an Error escaped the activation coroutine. Its scope (SupervisorJob + Dispatchers.IO) had no handler, so the Error reached Android's uncaught-exception handler and took down the IDE, whose process the plugin runs in. - refresh catches Throwable around the read, rethrows CancellationException, reports the failure through the existing RepeatedFailureLog (in full once, briefly after that) and keeps the previous entries. - McpToolCatalog.refreshAll does the same around connect, which calls the host's KeystoreSecretStore and ServerUrl: one server's Error now costs only that server, as an Exception already did. - settingsChanged guards notifyToolsChanged against Throwable, like healthChanged already guards notifyToolSourceStatusChanged: the registry is AI Core's, built against its own plugin-api. - The activation scope gets a CoroutineExceptionHandler as a backstop, logging through android.util.Log, so anything still unforeseen stops at this plugin's log. Tests: a source that throws AbstractMethodError keeps the entries unchanged and refresh returns false; startDebuggerEntry, the health probe and refreshAll survive an AbstractMethodError from the debugger service, the registry and the Keystore; an Error thrown in a coroutine of the plugin's scope never reaches the default uncaught-exception handler. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/debugger/AutomaticServers.kt | 13 +- .../plugins/aiagentmcp/plugin/McpPlugin.kt | 42 ++++- .../aiagentmcp/tools/McpToolCatalog.kt | 12 +- .../debugger/AutomaticServersTest.kt | 26 +++ .../plugin/McpPluginHostErrorTest.kt | 148 ++++++++++++++++++ 5 files changed, 231 insertions(+), 10 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index 58701d1d4..26a4b8ce8 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -10,6 +10,7 @@ import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog import com.itsaky.androidide.plugins.services.DebuggerEndpoint import java.util.concurrent.CopyOnWriteArrayList +import kotlin.coroutines.cancellation.CancellationException private const val TAG = "$LOG_PREFIX.AutomaticServers" @@ -55,7 +56,10 @@ object AutomaticServers { private val endpointListeners = CopyOnWriteArrayList<(String) -> Unit>() - /** The probe calls [refresh] every 20 s, so a refused permission would otherwise log a stack trace forever. */ + /** + * The probe calls [refresh] every 20 s, so a refused permission or a plugin-api mismatch would + * otherwise log a stack trace forever. + */ private val readFailures = RepeatedFailureLog( first = { e -> Log.w(TAG, "Could not read the debugger endpoints; keeping the previous entries", e) }, later = { e -> Log.d(TAG, "Still cannot read the debugger endpoints: $e") }, @@ -131,9 +135,14 @@ object AutomaticServers { val read = source ?: return false val fresh = try { read().associateBy { idFor(it.applicationId) } - } catch (e: Exception) { + } catch (e: CancellationException) { + throw e + } catch (e: Throwable) { // A failed read is not "no apps": the entries stay as they were, since wiping them // would take every debugger tool away from the agent on a transient database error. + // Throwable, not Exception: a plugin-api that does not match the host's fails here with + // an AbstractMethodError or another LinkageError, and one that escaped would end the + // caller's coroutine in the IDE's uncaught-exception handler and crash Code on the Go. readFailures.report(e) return false } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index 3b0635433..4f26726e9 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -1,5 +1,6 @@ package com.itsaky.androidide.plugins.aiagentmcp.plugin +import android.util.Log import com.itsaky.androidide.plugins.IPlugin import com.itsaky.androidide.plugins.PluginContext import com.itsaky.androidide.plugins.PluginLifecycleListener @@ -7,6 +8,7 @@ import com.itsaky.androidide.plugins.aiagentmcp.R import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers import com.itsaky.androidide.plugins.aiagentmcp.debugger.McpServers +import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore import com.itsaky.androidide.plugins.aiagentmcp.settings.McpSettingsFragment import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth @@ -20,6 +22,7 @@ import com.itsaky.androidide.plugins.extensions.SettingsExtension import com.itsaky.androidide.plugins.services.DebuggerEndpointService import com.itsaky.androidide.plugins.services.SharedServices import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import kotlinx.coroutines.CoroutineExceptionHandler import kotlinx.coroutines.CoroutineScope import kotlinx.coroutines.Dispatchers import kotlinx.coroutines.Job @@ -32,6 +35,8 @@ import kotlinx.coroutines.delay import kotlinx.coroutines.isActive import kotlinx.coroutines.launch +private const val TAG = "$LOG_PREFIX.McpPlugin" + /** * Connects the Agent to Model Context Protocol servers. * @@ -118,6 +123,15 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { const val TOOLTIP_TAG_HEADER_REMOVE = "mcp_header_remove" const val TOOLTIP_TAG_BACK = "mcp_back" + /** + * Logs a failure that escaped a coroutine of [newScope]. Platform logging, not + * `context.logger`: a handler that itself threw would hand both failures to the IDE's + * uncaught-exception handler, and a scope exists before [initialize] sets the context. + */ + private val BACKSTOP = CoroutineExceptionHandler { _, e -> + Log.e(TAG, "Background work failed; it stops here and Code on the Go carries on", e) + } + @Volatile private var pluginContext: PluginContext? = null @@ -144,9 +158,19 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { } } - /** Tells the agent to re-read the tool list whenever a server or a toggle changes. */ + /** + * Tells the agent to re-read the tool list whenever a server or a toggle changes. + * + * Guarded against [Throwable], like [healthChanged]: it runs on this plugin's own coroutines, + * and the registry is AI Core's, built against a plugin-api of its own. A LinkageError from it + * would otherwise end the coroutine in the IDE's uncaught-exception handler. + */ private val settingsChanged: () -> Unit = { - resolveToolSourceRegistry()?.notifyToolsChanged(PLUGIN_ID) + try { + resolveToolSourceRegistry()?.notifyToolsChanged(PLUGIN_ID) + } catch (e: Throwable) { + context.logger.warn("McpPlugin: could not tell the agent the tools changed: $e") + } } /** @@ -314,7 +338,8 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { * `plugin.min_ide_version` keeps this plugin off an IDE that lacks the service: such an IDE * rejects the unknown `debugger.endpoints` permission when it validates the manifest. The catch * is defence only, for a host that registers no service anyway. A call that later throws (no - * permission, unreadable database) leaves the entries as they were. + * permission, unreadable database, a LinkageError from a host whose plugin-api differs) leaves + * the entries as they were: [AutomaticServers.refresh] catches it. */ private fun installDebuggerEndpoints(keepGoing: () -> Boolean) { val service = try { @@ -329,8 +354,15 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { AutomaticServers.install(AutomaticServers.fromHost { service.endpoints }, keepGoing) } - /** A fresh scope for this activation; the previous one is cancelled, never reused. */ - private fun newScope() = CoroutineScope(SupervisorJob() + Dispatchers.IO) + /** + * A fresh scope for this activation; the previous one is cancelled, never reused. + * + * [BACKSTOP] logs what escapes a coroutine here. Each host call is guarded where it is made, so + * a failure costs only that call; this catches the one nobody foresaw, which would otherwise + * reach the IDE's uncaught-exception handler and crash Code on the Go, whose process this + * plugin runs in. Internal as a seam, so a test can watch such a failure stop there. + */ + internal fun newScope() = CoroutineScope(SupervisorJob() + Dispatchers.IO + BACKSTOP) /** * Installs [next] as the current scope and cancels whichever scope it displaced. diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt index 45eab5c04..f3798644b 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt @@ -16,6 +16,7 @@ import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore import com.itsaky.androidide.plugins.aiagentmcp.transport.JsonRpc import com.itsaky.androidide.plugins.aiagentmcp.transport.McpExchangeListener import java.util.concurrent.ConcurrentHashMap +import kotlin.coroutines.cancellation.CancellationException private const val TAG = "$LOG_PREFIX.McpToolCatalog" @@ -159,9 +160,14 @@ object McpToolCatalog { try { connect(server) refreshed++ - } catch (e: Exception) { - // One unreachable server must not cost the user the tools of the others. - Log.w(TAG, "Could not list tools for '${server.name}': ${e.message}") + } catch (e: CancellationException) { + throw e + } catch (e: Throwable) { + // One unreachable server must not cost the user the tools of the others. Throwable, + // not Exception: connect calls the host (its Keystore, its ServerUrl), and a + // plugin-api that does not match the host's fails there with a LinkageError, which + // would otherwise end the activation's coroutine and crash Code on the Go. + Log.w(TAG, "Could not list tools for '${server.name}': $e") } } return refreshed diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt index 660784420..02f7f9860 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt @@ -8,6 +8,7 @@ import org.junit.Assert.assertEquals import org.junit.Assert.assertFalse import org.junit.Assert.assertNull import org.junit.Assert.assertTrue +import org.junit.Assert.fail import org.junit.Test class AutomaticServersTest { @@ -146,6 +147,31 @@ class AutomaticServersTest { assertEquals("t1", AutomaticServers.token(id)) } + /** A host whose plugin-api differs from this plugin's: an Error, which `catch (Exception)` misses. */ + @Test + fun `a read that throws a linkage error keeps the entries as they were`() { + var failing = false + AutomaticServers.install { + if (failing) throw AbstractMethodError("DebuggerEndpointService.getEndpoints") + listOf(endpoint()) + } + val id = AutomaticServers.idFor("com.example.app") + AutomaticServers.recordTools(id, endpoint(), listOf(McpTool("q", "", readOnlyHint = true))) + + failing = true + val changed = try { + AutomaticServers.refresh() + } catch (e: LinkageError) { + fail("refresh let $e escape to its caller's coroutine") + return + } + + assertFalse(changed) + val server = AutomaticServers.servers().single() + assertEquals(listOf("q"), server.knownTools) + assertEquals("t1", AutomaticServers.token(id)) + } + @Test fun `an entry that disappears has its health and cached tools forgotten`() { var current = listOf(endpoint()) diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt new file mode 100644 index 000000000..33fb9d1a4 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt @@ -0,0 +1,148 @@ +package com.itsaky.androidide.plugins.aiagentmcp.plugin + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticEndpoint +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion.tool +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import com.itsaky.androidide.plugins.security.KeystoreSecretStore +import com.itsaky.androidide.plugins.services.DebuggerEndpointService +import com.itsaky.androidide.plugins.services.SharedServices +import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import io.mockk.every +import io.mockk.mockk +import io.mockk.mockkObject +import io.mockk.unmockkObject +import io.mockk.verify +import java.util.concurrent.CopyOnWriteArrayList +import java.util.concurrent.TimeUnit +import java.util.concurrent.atomic.AtomicBoolean +import kotlinx.coroutines.launch +import kotlinx.coroutines.runBlocking +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +/** + * A host whose plugin-api differs from the one this plugin was built against answers a call with an + * Error (AbstractMethodError, NoSuchMethodError, another LinkageError), not an Exception. On this + * plugin's own coroutines such an Error reached the IDE's uncaught-exception handler, which crashes + * Code on the Go, since a plugin runs in its process. + */ +class McpPluginHostErrorTest { + + private lateinit var context: PluginContext + private lateinit var plugin: McpPlugin + private val servers = mutableListOf() + + @Before + fun setUp() { + AutomaticServers.install(null) + context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + plugin = McpPlugin().also { it.initialize(context) } + } + + @After + fun tearDown() { + SharedServices.unregister(ToolSourceRegistry::class.java) + AutomaticServers.install(null) + McpConnections.closeAll() + McpToolCatalog.clear() + servers.forEach { it.stop() } + plugin.dispose() + } + + private fun fake(token: String, vararg tools: org.json.JSONObject) = + FakeMcpServer(token, tools.toList()).also { servers += it } + + /** Runs [block], turning an Error that escapes it into this test's failure. */ + private fun survives(what: String, block: () -> T): T = try { + block() + } catch (e: Error) { + if (e is AssertionError) throw e + throw AssertionError("$what let $e escape", e) + } + + @Test + fun `a debugger service that throws a linkage error does not end the activation`() { + val service = mockk { + every { endpoints } throws AbstractMethodError("DebuggerEndpointService.getEndpoints") + } + every { context.services.get(DebuggerEndpointService::class.java) } returns service + + survives("startDebuggerEntry") { plugin.startDebuggerEntry { true } } + + assertTrue(AutomaticServers.servers().isEmpty()) + } + + @Test + fun `a registry that throws a linkage error does not end the health probe`() { + val active = AtomicBoolean(true) + val registry = mockk(relaxed = true) { + every { notifyToolsChanged(any()) } answers { + active.set(false) + throw AbstractMethodError("ToolSourceRegistry.notifyToolsChanged") + } + } + SharedServices.register(ToolSourceRegistry::class.java, registry) + val app = fake("t1", tool("query", true)) + AutomaticServers.install { listOf(AutomaticEndpoint("com.example.app", app.port, "t1")) } + // A bound, so a probe that never lists the tools fails the verify below instead of hanging. + val deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(20) + + survives("the health probe") { + runBlocking { + plugin.probeHealth({ active.get() && System.nanoTime() < deadline }, intervalMs = 10) + } + } + + verify { registry.notifyToolsChanged(McpPlugin.PLUGIN_ID) } + } + + @Test + fun `a keystore call that throws a linkage error costs only its own server`() { + val app = fake("", tool("query", null)) + val broken = McpServerStore.saveDetails( + McpServerStore.newServer("Broken", "http://127.0.0.1:${app.port}/mcp") + ) + val working = McpServerStore.saveDetails( + McpServerStore.newServer("Working", "http://127.0.0.1:${app.port}/mcp") + ) + mockkObject(McpServerStore) + try { + every { McpServerStore.token(broken.id) } throws AbstractMethodError("KeystoreSecretStore.readAndMigrate") + every { McpServerStore.token(working.id) } returns KeystoreSecretStore.Stored.Absent + every { McpServerStore.headers(any()) } returns emptyMap() + + val answered = survives("refreshAll") { McpToolCatalog.refreshAll() } + + assertEquals(1, answered) + assertEquals(listOf("query"), McpToolCatalog.tools(working.id).map { it.name }) + } finally { + unmockkObject(McpServerStore) + } + } + + @Test + fun `an error that escapes a coroutine stops at the backstop, not at the IDE's handler`() { + val reached = CopyOnWriteArrayList() + val previous = Thread.getDefaultUncaughtExceptionHandler() + Thread.setDefaultUncaughtExceptionHandler { _, e -> reached += e } + try { + runBlocking { + plugin.newScope().launch { throw AbstractMethodError("an unguarded host call") }.join() + } + } finally { + Thread.setDefaultUncaughtExceptionHandler(previous) + } + + assertEquals("reached the IDE's uncaught-exception handler", emptyList(), reached.toList()) + } +} From 3620d18c5221ce1ebddf21a29335ea763bc48c74 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Tue, 17 Nov 2026 18:45:47 -0800 Subject: [PATCH 17/23] ADFA-7139 AI-Agent-MCP: the help text names the SQLite debugger tools that start on The plugin tooltip still said every tool stays off until the user turns it on. Since 96b49e39 the automatic SQLite debugger entry turns four tools on by default (ReadOnlyTrust.CORE_TOOLS), as the README and the gallery page say. The tooltip, the in-IDE help page and the gallery card (addon.json) now say so too, and that the entry is not on the MCP servers screen in this version. "Asks for your approval every time" stays: AI-Core still asks on every call of a contributed tool until appdevforall/addons#167 lands. The merge note on #166 lists these lines for whichever of the two lands second. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/addon.json | 2 +- .../src/main/assets/docs/index.html | 18 +++++++++++++----- .../plugins/aiagentmcp/plugin/McpPlugin.kt | 8 ++++++-- 3 files changed, 20 insertions(+), 8 deletions(-) diff --git a/plugins/AI-Agent-MCP/addon.json b/plugins/AI-Agent-MCP/addon.json index 08cb09121..c676d9a79 100644 --- a/plugins/AI-Agent-MCP/addon.json +++ b/plugins/AI-Agent-MCP/addon.json @@ -1,6 +1,6 @@ { "summary": "Give the Agent tools from Model Context Protocol (MCP) servers. Requires the AI Core addon and an AI backend.", - "description": "Connects to MCP servers you configure and adds the tools they offer to the AI Core Agent, next to its own. Each tool starts switched off until you enable it. When the Agent calls a tool, the arguments it chose, which can include your code, are sent to the MCP server that offers that tool. This addon adds tools, not a model, so you still need an AI backend.", + "description": "Connects to MCP servers you configure and adds the tools they offer to the AI Core Agent, next to its own. Each tool starts switched off until you enable it, except four read-only tools of the SQLite debugger entry that Code on the Go adds for your own debug app. When the Agent calls a tool, the arguments it chose, which can include your code, are sent to the MCP server that offers that tool. This addon adds tools, not a model, so you still need an AI backend.", "tags": [ "ai", "agent", diff --git a/plugins/AI-Agent-MCP/src/main/assets/docs/index.html b/plugins/AI-Agent-MCP/src/main/assets/docs/index.html index c8c449df0..e15623f92 100644 --- a/plugins/AI-Agent-MCP/src/main/assets/docs/index.html +++ b/plugins/AI-Agent-MCP/src/main/assets/docs/index.html @@ -72,16 +72,24 @@

Adding a server

Choosing tools

-

Every tool starts switched off. That is deliberate: each enabled tool - costs prompt space on every message you send, and a large server can advertise - ninety of them — enough to fill a phone-sized context window on its own. Switch - on the handful you actually want.

+

Every tool starts switched off, with the one exception below. That is + deliberate: each enabled tool costs prompt space on every message you send, and a + large server can advertise ninety of them — enough to fill a phone-sized context + window on its own. Switch on the handful you actually want.

+

The one exception is the SQLite debugger entry, which Code on the Go + adds by itself for an app you build with the SQLite debugger, named + "SQLite debugger (application ID)". Four of its read-only tools start + switched on: list_databases, get_schema, + query and get_events. Its other tools start off. This + version does not show the entry on the MCP servers screen, so it has no switches + there yet.

The Agent reads this list from memory, so tap Connect again after the server changes; a chat that is already open picks the new list up.

Approval

Every remote tool asks for your approval before it runs, showing the - arguments it would send, and there is no "always allow" for them. The Agent's + arguments it would send, and there is no "always allow" for them. That includes + the four SQLite debugger tools that start switched on. The Agent's own file tools are confined to the open project; a remote tool is confined by nothing this device controls, so the dialog is the only gate — read it.

diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index 4f26726e9..b44c83f09 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -508,8 +508,12 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { MCP (Model Context Protocol) servers give the Agent extra tools, such as access to an issue tracker or a documentation site.

To use this add-on, you must also install AI Core. Then go to Preferences → MCP - servers and add a server. Each tool stays off until you turn it on, and - the Agent asks for your approval every time it uses one. + servers
and add a server. Each tool stays off until you turn it + on.

The one exception is the SQLite debugger entry that CoGo adds + for an app you build with the SQLite debugger: four of its read-only tools + start on (list databases, get schema, query, and get events). This version + doesn't list that entry on the MCP servers screen.

The Agent asks for + your approval every time it uses a tool, including those four. """.trimIndent(), buttons = listOf( PluginTooltipButton( From be3dc86e1703311a345717bd83e640054d20130c Mon Sep 17 00:00:00 2001 From: David Schachter Date: Tue, 17 Nov 2026 18:45:59 -0800 Subject: [PATCH 18/23] ADFA-7139 AI-Agent-MCP: an older endpoint read never stores over a newer one AutomaticServers.refresh reads the host outside its lock and, before storing, checked only that the source was still installed. The probe's refresh and a failing call's EndpointRetry can overlap, so the read that started first could finish last and put back the endpoint the other had already replaced. The next failing call healed it through EndpointRetry, at the cost of one refused call. Each read now takes a number under the lock as it starts, and a read whose number is lower than the one already stored is dropped. Test: two interleaved refreshes, the older read released only after the newer one stored; the newer endpoint stays. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/debugger/AutomaticServers.kt | 20 ++++++++-- .../debugger/AutomaticServersTest.kt | 38 +++++++++++++++++++ 2 files changed, 55 insertions(+), 3 deletions(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index 26a4b8ce8..a611a47f9 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -52,6 +52,13 @@ object AutomaticServers { @Volatile private var source: (() -> List)? = null + /** + * Numbers each [refresh]'s read in the order the reads start, and the number of the read now + * stored. Both are guarded by this object's lock. + */ + private var readsStarted = 0L + private var storedRead = 0L + private val listeners = CopyOnWriteArrayList<() -> Unit>() private val endpointListeners = CopyOnWriteArrayList<(String) -> Unit>() @@ -126,13 +133,19 @@ object AutomaticServers { * Re-reads the endpoints. Blocking host call: use a background thread. * Nothing is stored when the source that was read is no longer installed, so a refresh in * flight when deactivation cleared the entries (or a later activation replaced the source) - * cannot restore them, whichever caller started it. + * cannot restore them, whichever caller started it. Nor is it stored when a refresh that + * started later has already stored its own: the probe's refresh and a failing call's retry can + * overlap, and the read that started first may finish last with the endpoint the other has + * already replaced. * * @param keepGoing checked after the read, before anything is stored. * @return true when the set of entries, a port or a token changed. */ fun refresh(keepGoing: () -> Boolean = { true }): Boolean { - val read = source ?: return false + val (read, ticket) = synchronized(this) { + val current = source ?: return false + current to ++readsStarted + } val fresh = try { read().associateBy { idFor(it.applicationId) } } catch (e: CancellationException) { @@ -149,7 +162,8 @@ object AutomaticServers { val moved = mutableListOf() val removed: List val changed = synchronized(this) { - if (source !== read || !keepGoing()) return false + if (source !== read || !keepGoing() || ticket < storedRead) return false + storedRead = ticket val old = states val next = fresh.mapValues { (id, endpoint) -> val previous = old[id] diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt index 02f7f9860..d848ae217 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt @@ -3,6 +3,10 @@ package com.itsaky.androidide.plugins.aiagentmcp.debugger import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import java.util.concurrent.CountDownLatch +import java.util.concurrent.TimeUnit +import java.util.concurrent.atomic.AtomicInteger +import kotlin.concurrent.thread import org.junit.After import org.junit.Assert.assertEquals import org.junit.Assert.assertFalse @@ -172,6 +176,40 @@ class AutomaticServersTest { assertEquals("t1", AutomaticServers.token(id)) } + /** + * The probe's refresh and a failing call's retry can overlap. The read that started first + * returns the endpoint from before the relaunch, and here it finishes last. + */ + @Test + fun `an older read that finishes last does not store over a newer one`() { + val olderEntered = CountDownLatch(1) + val releaseOlder = CountDownLatch(1) + val reads = AtomicInteger() + AutomaticServers.install { + when (reads.incrementAndGet()) { + 1 -> listOf(endpoint(port = 4000)) + 2 -> { + olderEntered.countDown() + releaseOlder.await(10, TimeUnit.SECONDS) + listOf(endpoint(port = 4000)) + } + else -> listOf(endpoint(port = 4001, token = "t2")) + } + } + val id = AutomaticServers.idFor("com.example.app") + var olderChanged = true + val older = thread { olderChanged = AutomaticServers.refresh() } + assertTrue("the older read never started", olderEntered.await(10, TimeUnit.SECONDS)) + + assertTrue(AutomaticServers.refresh()) + releaseOlder.countDown() + older.join(10_000) + + assertEquals(4001, AutomaticServers.endpoint(id)?.port) + assertEquals("t2", AutomaticServers.token(id)) + assertFalse(olderChanged) + } + @Test fun `an entry that disappears has its health and cached tools forgotten`() { var current = listOf(endpoint()) From fe8e819fce8637102a54e99609776fd370150ddd Mon Sep 17 00:00:00 2001 From: David Schachter Date: Tue, 17 Nov 2026 18:51:46 -0800 Subject: [PATCH 19/23] ADFA-7139 AI-Agent-MCP: the docs name debugger.endpoints beside network.access The manifest has declared network.access,debugger.endpoints since 816e8cc8, but the README, the gallery page (twice), the in-IDE help page and McpPlugin's class KDoc still said the plugin declares network.access and nothing else. Each now names both permissions and says what debugger.endpoints is for: reading the SQLite debugger endpoints Code on the Go stores. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 3 ++- plugins/AI-Agent-MCP/ai-agent-mcp.html | 6 ++++-- plugins/AI-Agent-MCP/src/main/assets/docs/index.html | 4 +++- .../androidide/plugins/aiagentmcp/plugin/McpPlugin.kt | 5 +++-- 4 files changed, 12 insertions(+), 6 deletions(-) diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index a380a1b06..bb2f3cf03 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -12,7 +12,8 @@ This is a *tool* plugin, not a model backend: it adds no inference. Install `ai-core` declares the filesystem, shell and project permissions its own tools need, and **no network access**. MCP is the mirror image: it declares -`network.access` and nothing else. Keeping them apart is what lets a user install +`network.access`, plus `debugger.endpoints` to read the SQLite debugger endpoints +Code on the Go stores, and nothing else. Keeping them apart is what lets a user install the Agent without granting it the network, or add remote tools without widening what the Agent itself may touch. diff --git a/plugins/AI-Agent-MCP/ai-agent-mcp.html b/plugins/AI-Agent-MCP/ai-agent-mcp.html index 410a38967..ac29bb103 100644 --- a/plugins/AI-Agent-MCP/ai-agent-mcp.html +++ b/plugins/AI-Agent-MCP/ai-agent-mcp.html @@ -52,7 +52,8 @@

Executive overview

It is deliberately a plugin of its own rather than part of AI Core. AI Core declares the filesystem, shell and project permissions its own tools need and no network access; this plugin is the mirror image, declaring - network.access and nothing else. That split is what lets you run the + network.access, plus debugger.endpoints to read the SQLite debugger + endpoints Code on the Go stores, and nothing else. That split is what lets you run the Agent without granting it the network, or add remote tools without widening what the Agent itself may touch.

@@ -119,7 +120,8 @@

Technical architecture

which is a Kotlin Multiplatform library with no stated Android target, ships no HTTP engine, and required a Kotlin version these plugins do not standardise on.

-

The plugin declares network.access and nothing else. It holds no +

The plugin declares network.access and debugger.endpoints, which + only reads the SQLite debugger endpoints Code on the Go stores, and nothing else. It holds no filesystem, shell or project permission, so it cannot read your project; project content reaches a server only if the model puts it in a tool argument and you approve that call.

diff --git a/plugins/AI-Agent-MCP/src/main/assets/docs/index.html b/plugins/AI-Agent-MCP/src/main/assets/docs/index.html index e15623f92..8cead601b 100644 --- a/plugins/AI-Agent-MCP/src/main/assets/docs/index.html +++ b/plugins/AI-Agent-MCP/src/main/assets/docs/index.html @@ -96,7 +96,9 @@

Approval

What is sent

  • The tool's arguments, as the model composed them, to that server only.
  • -
  • Nothing else: this plugin has network access and no other permission. +
  • Nothing else: this plugin has network access, plus + debugger.endpoints to read the SQLite debugger endpoints Code on the Go + stores, and no other permission. It cannot read your project or your files. Anything from your project reaches a server only if the model puts it in an argument and you approve the call.
  • Server and tool names are reduced here to the alphabet a tool name may diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index b44c83f09..fb8505433 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -41,8 +41,9 @@ private const val TAG = "$LOG_PREFIX.McpPlugin" * Connects the Agent to Model Context Protocol servers. * * Deliberately a plugin of its own rather than part of AI Core: everything here is network work, - * so it declares `network.access` and nothing else, while AI Core declares the filesystem, shell - * and project permissions its own tools need and no network at all. + * so it declares `network.access`, plus `debugger.endpoints` to read the SQLite debugger endpoints + * Code on the Go stores, and nothing else, while AI Core declares the filesystem, shell and project + * permissions its own tools need and no network at all. */ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { From 21944cf0e897dc228f90f44c2d72397f71d288b8 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Tue, 17 Nov 2026 21:53:05 -0800 Subject: [PATCH 20/23] ADFA-7139 AI-Agent-MCP: an OutOfMemoryError from the host reaches the IDE's handler again 57477d2e widened the catches around host calls from Exception to Throwable so that a LinkageError from a mismatched plugin-api would not crash Code on the Go. Throwable also takes in VirtualMachineError (OutOfMemoryError, StackOverflowError) and ThreadDeath. An OutOfMemoryError in the endpoint read was then logged every 20 s as a failed read, and the coroutine backstop swallowed one from any coroutine of the plugin instead of letting the IDE's handler see it. - AutomaticServers.refresh and McpToolCatalog.refreshAll catch Exception and LinkageError only, still rethrowing CancellationException first. - The backstop rethrows a VirtualMachineError or a ThreadDeath. The coroutine machinery passes a failure its handler rethrows, unwrapped, to the thread's uncaught-exception handler. Anything else is logged as before. - The other guards on paths that reach the host follow the same rule: McpPlugin's registry and service calls (settingsChanged, healthChanged, installDebuggerEndpoints, register/unregisterToolSource, resolveToolSourceRegistry), the connect calls of the probe and the relist, dispose's listener removal, the listener loops of McpServerStore, McpServerHealth and AutomaticServers (their listeners tell the host), and McpSession.close and McpConnections' closes (the DELETE reads the Keystore). runCatchingRecoverable is runCatching with that rule. - McpToolSource.runTool keeps Throwable, with a comment: it runs inside CompletableFuture.supplyAsync, which catches every Throwable itself, so narrowing it would only hand AI Core an exceptional future instead of a failure outcome. Tests: a read that throws OutOfMemoryError makes refresh throw it; an OutOfMemoryError escaping a coroutine of the plugin's scope reaches the default uncaught-exception handler; each other narrowed guard lets an OutOfMemoryError from its host call or listener through. The five linkage-error tests still pass. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/client/McpConnections.kt | 7 +- .../plugins/aiagentmcp/client/McpSession.kt | 10 +- .../aiagentmcp/debugger/AutomaticServers.kt | 21 +- .../plugins/aiagentmcp/errors/Recoverable.kt | 21 ++ .../plugins/aiagentmcp/plugin/McpPlugin.kt | 69 +++-- .../aiagentmcp/settings/McpServerStore.kt | 9 +- .../aiagentmcp/tools/McpServerHealth.kt | 9 +- .../aiagentmcp/tools/McpToolCatalog.kt | 17 +- .../plugins/aiagentmcp/tools/McpToolSource.kt | 4 + .../debugger/AutomaticServersTest.kt | 32 ++ .../plugin/McpPluginFatalErrorTest.kt | 288 ++++++++++++++++++ 11 files changed, 445 insertions(+), 42 deletions(-) create mode 100644 plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/errors/Recoverable.kt create mode 100644 plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginFatalErrorTest.kt diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt index e1f469474..e1289e8ce 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpConnections.kt @@ -2,6 +2,7 @@ package com.itsaky.androidide.plugins.aiagentmcp.client import android.util.Log import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.errors.runCatchingRecoverable import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX import com.itsaky.androidide.plugins.aiagentmcp.security.UnavailableSecretException import com.itsaky.androidide.plugins.aiagentmcp.security.UnreadableSecretException @@ -65,19 +66,19 @@ object McpConnections { stale?.let { Log.i(TAG, "Server '${server.name}' changed; dropping its session") - runCatching { it.close() } + runCatchingRecoverable { it.close() } } return session } /** Drops the session for [serverId], ending it server-side when it had one. */ fun invalidate(serverId: String) { - sessions.remove(serverId)?.second?.let { runCatching { it.close() } } + sessions.remove(serverId)?.second?.let { runCatchingRecoverable { it.close() } } } /** Ends every session, for the plugin shutting down. */ fun closeAll() { - sessions.values.forEach { (_, session) -> runCatching { session.close() } } + sessions.values.forEach { (_, session) -> runCatchingRecoverable { session.close() } } sessions.clear() } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpSession.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpSession.kt index fe5fcaa4c..9371499da 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpSession.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/client/McpSession.kt @@ -2,6 +2,7 @@ package com.itsaky.androidide.plugins.aiagentmcp.client import android.util.Log import com.itsaky.androidide.plugins.aiagentmcp.debugger.ReadOnlyTrust +import com.itsaky.androidide.plugins.aiagentmcp.errors.runCatchingRecoverable import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX import com.itsaky.androidide.plugins.aiagentmcp.transport.JsonRpc import com.itsaky.androidide.plugins.aiagentmcp.transport.McpExchangeListener @@ -193,11 +194,16 @@ class McpSession( runCatching { liveConnection?.disconnect() } } - /** Ends the server-side session, if there is one, and forgets the handshake. */ + /** + * Ends the server-side session, if there is one, and forgets the handshake. + * + * The DELETE is best effort; its credentials come from the host's Keystore, so a LinkageError + * is survived as well as an Exception, and any other Error propagates. + */ @Synchronized fun close() { sessionId?.let { id -> - runCatching { + runCatchingRecoverable { val current = credentials() http.deleteSession(endpoint, current.token, id, current.headers) } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index a611a47f9..487cedb75 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -3,6 +3,7 @@ package com.itsaky.androidide.plugins.aiagentmcp.debugger import android.util.Log import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections import com.itsaky.androidide.plugins.aiagentmcp.client.McpTool +import com.itsaky.androidide.plugins.aiagentmcp.errors.runCatchingRecoverable import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore @@ -138,6 +139,9 @@ object AutomaticServers { * overlap, and the read that started first may finish last with the endpoint the other has * already replaced. * + * A read that fails with an Exception or a LinkageError leaves the entries as they were; any + * other Error, an OutOfMemoryError above all, propagates to the caller. + * * @param keepGoing checked after the read, before anything is stored. * @return true when the set of entries, a port or a token changed. */ @@ -150,12 +154,18 @@ object AutomaticServers { read().associateBy { idFor(it.applicationId) } } catch (e: CancellationException) { throw e - } catch (e: Throwable) { + } catch (e: Exception) { // A failed read is not "no apps": the entries stay as they were, since wiping them // would take every debugger tool away from the agent on a transient database error. - // Throwable, not Exception: a plugin-api that does not match the host's fails here with - // an AbstractMethodError or another LinkageError, and one that escaped would end the - // caller's coroutine in the IDE's uncaught-exception handler and crash Code on the Go. + readFailures.report(e) + return false + } catch (e: LinkageError) { + // Treated as a failed read too: a plugin-api that does not match the host's fails here + // with an AbstractMethodError or another LinkageError, and one that escaped would end + // the caller's coroutine in the IDE's uncaught-exception handler and crash Code on the + // Go. Nothing broader than these two: an OutOfMemoryError or a StackOverflowError is + // the process failing, not the read, and has to reach that handler rather than be + // logged here every 20 s as a read that failed. readFailures.report(e) return false } @@ -246,8 +256,9 @@ object AutomaticServers { /** The application ID an automatic entry's id was made from. */ fun applicationIdOf(serverId: String) = serverId.removePrefix(ID_PREFIX) + /** A listener that tells the host may fail like any host call; see [runCatchingRecoverable]. */ private fun fireChanged() { - for (l in listeners) runCatching { l() } + for (l in listeners) runCatchingRecoverable { l() } } } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/errors/Recoverable.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/errors/Recoverable.kt new file mode 100644 index 000000000..9493ebb70 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/errors/Recoverable.kt @@ -0,0 +1,21 @@ +package com.itsaky.androidide.plugins.aiagentmcp.errors + +/** + * As [runCatching], but catching only what this plugin can recover from: an [Exception], or a + * [LinkageError], which is how a host whose plugin-api differs from this plugin's fails a call + * (AbstractMethodError, NoSuchMethodError, NoClassDefFoundError). + * + * Any other Error propagates, a [VirtualMachineError] (OutOfMemoryError, StackOverflowError) above + * all: it means the process is failing, not one call, and the IDE's uncaught-exception handler has + * to see it rather than this plugin quietly carrying on. + * + * @param block the work, usually one that reaches the host directly or through a listener. + * @return its value, or the recoverable failure it threw. + */ +internal inline fun runCatchingRecoverable(block: () -> T): Result = try { + Result.success(block()) +} catch (e: Exception) { + Result.failure(e) +} catch (e: LinkageError) { + Result.failure(e) +} diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index fb8505433..a4db642fd 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -8,6 +8,7 @@ import com.itsaky.androidide.plugins.aiagentmcp.R import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers import com.itsaky.androidide.plugins.aiagentmcp.debugger.McpServers +import com.itsaky.androidide.plugins.aiagentmcp.errors.runCatchingRecoverable import com.itsaky.androidide.plugins.aiagentmcp.logging.LOG_PREFIX import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore import com.itsaky.androidide.plugins.aiagentmcp.settings.McpSettingsFragment @@ -128,8 +129,14 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { * Logs a failure that escaped a coroutine of [newScope]. Platform logging, not * `context.logger`: a handler that itself threw would hand both failures to the IDE's * uncaught-exception handler, and a scope exists before [initialize] sets the context. + * + * A [VirtualMachineError] (OutOfMemoryError, StackOverflowError) or a [ThreadDeath] is + * rethrown instead: it is the process failing, not this plugin's work, and the IDE's + * handler has to see it. The coroutine machinery hands a failure its handler rethrows, + * unwrapped, to the thread's uncaught-exception handler. */ private val BACKSTOP = CoroutineExceptionHandler { _, e -> + if (e is VirtualMachineError || e is ThreadDeath) throw e Log.e(TAG, "Background work failed; it stops here and Code on the Go carries on", e) } @@ -162,14 +169,17 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { /** * Tells the agent to re-read the tool list whenever a server or a toggle changes. * - * Guarded against [Throwable], like [healthChanged]: it runs on this plugin's own coroutines, - * and the registry is AI Core's, built against a plugin-api of its own. A LinkageError from it - * would otherwise end the coroutine in the IDE's uncaught-exception handler. + * Guarded against a [LinkageError] as well as an [Exception], like [healthChanged]: it runs on + * this plugin's own coroutines, and the registry is AI Core's, built against a plugin-api of + * its own. A LinkageError from it would otherwise end the coroutine in the IDE's + * uncaught-exception handler. Nothing broader: an OutOfMemoryError has to reach that handler. */ private val settingsChanged: () -> Unit = { try { resolveToolSourceRegistry()?.notifyToolsChanged(PLUGIN_ID) - } catch (e: Throwable) { + } catch (e: Exception) { + context.logger.warn("McpPlugin: could not tell the agent the tools changed: $e") + } catch (e: LinkageError) { context.logger.warn("McpPlugin: could not tell the agent the tools changed: $e") } } @@ -181,7 +191,9 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { private val healthChanged: () -> Unit = { try { if (registered) resolveToolSourceRegistry()?.notifyToolSourceStatusChanged(PLUGIN_ID) - } catch (e: Throwable) { + } catch (e: Exception) { + context.logger.debug("McpPlugin: could not report a health change: ${e.message}") + } catch (e: LinkageError) { // An AI Core built before contract 2 has no such method; its tags cannot show health. context.logger.debug("McpPlugin: could not report a health change: ${e.message}") } @@ -195,7 +207,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { scope.launch { val server = McpServers.all().firstOrNull { it.id == id && it.enabled } if (server != null) { - runCatching { McpToolCatalog.connect(server) } + runCatchingRecoverable { McpToolCatalog.connect(server) } if (isActive) settingsChanged() } } @@ -260,7 +272,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { } override fun dispose() { - runCatching { context.removePluginLifecycleListener(aiCoreLifecycle) } + runCatchingRecoverable { context.removePluginLifecycleListener(aiCoreLifecycle) } McpServerStore.removeChangeListener(settingsChanged) AutomaticServers.removeChangeListener(settingsChanged) McpServerHealth.removeChangeListener(healthChanged) @@ -306,7 +318,7 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { if (!keepGoing()) return@async false val before = McpToolCatalog.tools(server.id) // Recorded by connect itself; a failure here is what the tag already shows. - runCatching { McpToolCatalog.connect(server) } + runCatchingRecoverable { McpToolCatalog.connect(server) } McpToolCatalog.tools(server.id) != before } }.awaitAll().any { it } @@ -343,11 +355,9 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { * the entries as they were: [AutomaticServers.refresh] catches it. */ private fun installDebuggerEndpoints(keepGoing: () -> Boolean) { - val service = try { + val service = runCatchingRecoverable { context.services.get(DebuggerEndpointService::class.java) - } catch (e: Throwable) { - null - } + }.getOrNull() if (service == null) { context.logger.info("McpPlugin: this IDE has no debugger endpoint service") return @@ -361,7 +371,8 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { * [BACKSTOP] logs what escapes a coroutine here. Each host call is guarded where it is made, so * a failure costs only that call; this catches the one nobody foresaw, which would otherwise * reach the IDE's uncaught-exception handler and crash Code on the Go, whose process this - * plugin runs in. Internal as a seam, so a test can watch such a failure stop there. + * plugin runs in. A VirtualMachineError or a ThreadDeath it passes on to that handler. Internal + * as a seam, so a test can watch where such a failure ends up. */ internal fun newScope() = CoroutineScope(SupervisorJob() + Dispatchers.IO + BACKSTOP) @@ -414,9 +425,10 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { /** * Registers this plugin's tools with AI Core, if the registry is reachable. * - * Guarded against [Throwable] rather than [Exception]: on an IDE older than the release that - * ships the contract the class is simply absent, and a [NoClassDefFoundError] here would fail - * the whole plugin rather than the one thing it cannot do. + * Guarded against a [LinkageError] as well as an [Exception]: on an IDE older than the release + * that ships the contract the class is simply absent, and a [NoClassDefFoundError] here would + * fail the whole plugin rather than the one thing it cannot do. Nothing broader: an + * OutOfMemoryError has to reach the IDE's uncaught-exception handler. * * @return true when registered (now or already), false when AI Core is absent. */ @@ -430,24 +442,30 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { registered = true context.logger.info("McpPlugin: registered the MCP tool source with AI Core") true - } catch (e: Throwable) { + } catch (e: Exception) { + context.logger.error("McpPlugin: could not register the MCP tool source", e) + false + } catch (e: LinkageError) { context.logger.error("McpPlugin: could not register the MCP tool source", e) false } } - /** Withdraws the tools, so a disabled plugin stops appearing in the agent's tool list. */ + /** + * Withdraws the tools, so a disabled plugin stops appearing in the agent's tool list. + * + * Guarded like [registerToolSource]: an Exception or a LinkageError is logged, anything else + * propagates. + */ private fun unregisterToolSource() { if (!registered) return val source = toolSource - try { + runCatchingRecoverable { if (source != null) { resolveToolSourceRegistry()?.unregisterToolSource(source) context.logger.info("McpPlugin: unregistered the MCP tool source") } - } catch (e: Throwable) { - context.logger.warn("McpPlugin: could not unregister the MCP tool source", e) - } + }.onFailure { e -> context.logger.warn("McpPlugin: could not unregister the MCP tool source", e) } registered = false } @@ -463,12 +481,13 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { /** * Resolves AI Core's tool registry, preferring the process-global registry and falling back to * the provider-scoped lookup so a registry cleared by another plugin is not fatal. - * @return the registry, or null when AI Core is absent or too old to carry the contract. + * @return the registry, or null when AI Core is absent or too old to carry the contract, or + * the lookup failed with an Exception or a LinkageError. Any other Error propagates. */ - private fun resolveToolSourceRegistry(): ToolSourceRegistry? = try { + private fun resolveToolSourceRegistry(): ToolSourceRegistry? = runCatchingRecoverable { SharedServices.get(ToolSourceRegistry::class.java) ?: context.getPluginService(AI_CORE_PLUGIN_ID, ToolSourceRegistry::class.java) - } catch (e: Throwable) { + }.getOrElse { e -> context.logger.warn("McpPlugin: could not resolve the tool registry: ${e.message}") null } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServerStore.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServerStore.kt index 1cd47b47f..a6c33fb01 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServerStore.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/settings/McpServerStore.kt @@ -338,11 +338,18 @@ object McpServerStore { private fun prefs(): SharedPreferences? = McpPlugin.getContext()?.getPluginSharedPreferences(PREFERENCE_FILE) + /** + * Tells every listener, one failing listener costing only itself. A listener may call the + * host, so a LinkageError is survived as well as an Exception; anything else, an + * OutOfMemoryError above all, propagates to whoever made the change. + */ private fun fireChanged() { for (listener in listeners) { try { listener() - } catch (e: Throwable) { + } catch (e: Exception) { + Log.e(TAG, "A settings change listener threw", e) + } catch (e: LinkageError) { Log.e(TAG, "A settings change listener threw", e) } } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpServerHealth.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpServerHealth.kt index 168722041..f068df2b5 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpServerHealth.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpServerHealth.kt @@ -94,11 +94,18 @@ object McpServerHealth { if (byServer.put(serverId, health) != health) fireChanged() } + /** + * Tells every listener, one failing listener costing only itself. A listener may call the + * host, so a LinkageError is survived as well as an Exception; anything else, an + * OutOfMemoryError above all, propagates to whoever made the change. + */ private fun fireChanged() { for (listener in listeners) { try { listener() - } catch (e: Throwable) { + } catch (e: Exception) { + Log.e(TAG, "A health change listener threw", e) + } catch (e: LinkageError) { Log.e(TAG, "A health change listener threw", e) } } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt index f3798644b..c80b8a219 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolCatalog.kt @@ -147,6 +147,9 @@ object McpToolCatalog { * a cancelled refresh carries on filling this cache and [McpConnections] after both were * cleared, leaving sockets nothing can reach. * + * A server that fails with an Exception or a LinkageError is skipped; any other Error, an + * OutOfMemoryError above all, ends the walk and propagates. + * * @param keepGoing false once the caller has stopped caring; the walk stops there. * @return how many servers answered. */ @@ -162,11 +165,15 @@ object McpToolCatalog { refreshed++ } catch (e: CancellationException) { throw e - } catch (e: Throwable) { - // One unreachable server must not cost the user the tools of the others. Throwable, - // not Exception: connect calls the host (its Keystore, its ServerUrl), and a - // plugin-api that does not match the host's fails there with a LinkageError, which - // would otherwise end the activation's coroutine and crash Code on the Go. + } catch (e: Exception) { + // One unreachable server must not cost the user the tools of the others. + Log.w(TAG, "Could not list tools for '${server.name}': $e") + } catch (e: LinkageError) { + // Costs only this server too: connect calls the host (its Keystore, its ServerUrl), + // and a plugin-api that does not match the host's fails there with a LinkageError, + // which would otherwise end the activation's coroutine and crash Code on the Go. + // Nothing broader: an OutOfMemoryError is the process failing, not this server, and + // has to reach the IDE's uncaught-exception handler. Log.w(TAG, "Could not list tools for '${server.name}': $e") } } diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt index 81d2e37af..98cfbce1e 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/tools/McpToolSource.kt @@ -171,6 +171,10 @@ class McpToolSource : McpServerHealth.available(server.id) Outcome(result.success, result.text, result.errorMessage) } catch (e: Throwable) { + // Throwable, unlike the other host-facing catches in this plugin: this runs inside + // CompletableFuture.supplyAsync, which catches every Throwable itself, so narrowing this + // would not bring an OutOfMemoryError to the IDE's handler. It would only hand AI Core an + // exceptionally completed future in place of the failure outcome it expects. Log.w(TAG, "Tool '${tool.name}' on '${server.name}' failed", e) McpToolCatalog.recordFailure(server, e) val context = McpPlugin.getContext()?.androidContext diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt index d848ae217..fe68c8ad1 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt @@ -11,6 +11,7 @@ import org.junit.After import org.junit.Assert.assertEquals import org.junit.Assert.assertFalse import org.junit.Assert.assertNull +import org.junit.Assert.assertThrows import org.junit.Assert.assertTrue import org.junit.Assert.fail import org.junit.Test @@ -210,6 +211,37 @@ class AutomaticServersTest { assertFalse(olderChanged) } + /** The process failing, not the read: the IDE's handler has to see it, not a log line every 20 s. */ + @Test + fun `a read that throws an OutOfMemoryError reaches the caller`() { + var failing = false + AutomaticServers.install { + if (failing) throw OutOfMemoryError("reading the debugger endpoints") + listOf(endpoint()) + } + + failing = true + val thrown = assertThrows(OutOfMemoryError::class.java) { AutomaticServers.refresh() } + + assertEquals("reading the debugger endpoints", thrown.message) + } + + /** The listener added on activation tells the host, so it can fail like a host call. */ + @Test + fun `a change listener that throws an OutOfMemoryError reaches the caller`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val listener: () -> Unit = { throw OutOfMemoryError("telling the agent") } + AutomaticServers.addChangeListener(listener) + try { + current = listOf(endpoint(port = 4001)) + + assertThrows(OutOfMemoryError::class.java) { AutomaticServers.refresh() } + } finally { + AutomaticServers.removeChangeListener(listener) + } + } + @Test fun `an entry that disappears has its health and cached tools forgotten`() { var current = listOf(endpoint()) diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginFatalErrorTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginFatalErrorTest.kt new file mode 100644 index 000000000..ce5abe483 --- /dev/null +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginFatalErrorTest.kt @@ -0,0 +1,288 @@ +package com.itsaky.androidide.plugins.aiagentmcp.plugin + +import com.itsaky.androidide.plugins.PluginContext +import com.itsaky.androidide.plugins.aiagentmcp.client.McpConnections +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticEndpoint +import com.itsaky.androidide.plugins.aiagentmcp.debugger.AutomaticServers +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServer +import com.itsaky.androidide.plugins.aiagentmcp.settings.McpServerStore +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion.tool +import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpServerHealth +import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog +import com.itsaky.androidide.plugins.security.KeystoreSecretStore +import com.itsaky.androidide.plugins.services.DebuggerEndpoint +import com.itsaky.androidide.plugins.services.DebuggerEndpointService +import com.itsaky.androidide.plugins.services.SharedServices +import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import io.mockk.Runs +import io.mockk.every +import io.mockk.just +import io.mockk.mockk +import io.mockk.mockkObject +import io.mockk.unmockkObject +import java.util.concurrent.CopyOnWriteArrayList +import java.util.concurrent.CountDownLatch +import java.util.concurrent.TimeUnit +import java.util.concurrent.atomic.AtomicBoolean +import java.util.concurrent.atomic.AtomicInteger +import kotlinx.coroutines.launch +import kotlinx.coroutines.runBlocking +import org.json.JSONObject +import org.junit.After +import org.junit.Assert.assertEquals +import org.junit.Assert.assertSame +import org.junit.Assert.assertThrows +import org.junit.Assert.assertTrue +import org.junit.Before +import org.junit.Test + +/** + * An OutOfMemoryError (or a StackOverflowError, or a ThreadDeath) is the process failing, not one + * host call. The guards that keep a LinkageError from a mismatched plugin-api away from the IDE's + * uncaught-exception handler must let it through: caught, it was logged as an ordinary failure, + * every 20 s on the probe's path, and the IDE never learnt of it. + */ +class McpPluginFatalErrorTest { + + private lateinit var context: PluginContext + private lateinit var plugin: McpPlugin + private val servers = mutableListOf() + + @Before + fun setUp() { + AutomaticServers.install(null) + context = mockk(relaxed = true) + every { context.getPluginSharedPreferences(any()) } returns FakeSharedPreferences() + plugin = McpPlugin().also { it.initialize(context) } + } + + @After + fun tearDown() { + // First, so no listener of this plugin hears the cleanup below. + plugin.dispose() + SharedServices.unregister(ToolSourceRegistry::class.java) + AutomaticServers.install(null) + McpConnections.closeAll() + McpToolCatalog.clear() + servers.forEach { it.stop() } + } + + private fun fake(token: String, vararg tools: JSONObject, sessionId: String? = null) = + FakeMcpServer(token, tools.toList(), sessionId).also { servers += it } + + private fun userServer(port: Int): McpServer = + McpServerStore.saveDetails(McpServerStore.newServer("Server", "http://127.0.0.1:$port/mcp")) + + /** Runs [block] with the default uncaught-exception handler replaced; returns what reached it. */ + private fun reachingDefaultHandler(waitMs: Long = 0, block: () -> Unit): List { + val reached = CopyOnWriteArrayList() + val first = CountDownLatch(1) + val previous = Thread.getDefaultUncaughtExceptionHandler() + Thread.setDefaultUncaughtExceptionHandler { _, e -> + reached += e + first.countDown() + } + try { + block() + if (waitMs > 0) first.await(waitMs, TimeUnit.MILLISECONDS) + } finally { + Thread.setDefaultUncaughtExceptionHandler(previous) + } + return reached.toList() + } + + private fun awaitUntil(what: String, condition: () -> Boolean) { + val deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(10) + while (!condition()) { + check(System.nanoTime() < deadline) { "timed out waiting until $what" } + Thread.sleep(10) + } + } + + @Test + fun `an OutOfMemoryError that escapes a coroutine reaches the IDE's handler`() { + val error = OutOfMemoryError("in a coroutine of the plugin's scope") + + val reached = reachingDefaultHandler { + runBlocking { plugin.newScope().launch { throw error }.join() } + } + + assertEquals(1, reached.size) + assertSame(error, reached.single()) + } + + @Test + fun `a keystore call that throws an OutOfMemoryError ends the refresh`() { + val server = userServer(fake("", tool("query", null)).port) + mockkObject(McpServerStore) + try { + every { McpServerStore.token(server.id) } throws OutOfMemoryError("KeystoreSecretStore.readAndMigrate") + + assertThrows(OutOfMemoryError::class.java) { McpToolCatalog.refreshAll() } + } finally { + unmockkObject(McpServerStore) + } + } + + @Test + fun `a keystore call that throws an OutOfMemoryError ends the health probe`() { + val server = userServer(fake("", tool("query", null)).port) + val deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(3) + mockkObject(McpServerStore) + try { + every { McpServerStore.token(server.id) } throws OutOfMemoryError("KeystoreSecretStore.readAndMigrate") + + assertThrows(OutOfMemoryError::class.java) { + runBlocking { plugin.probeHealth({ System.nanoTime() < deadline }, intervalMs = 10) } + } + } finally { + unmockkObject(McpServerStore) + } + } + + @Test + fun `a registry that throws an OutOfMemoryError ends the health probe`() { + val active = AtomicBoolean(true) + val registry = mockk(relaxed = true) { + every { notifyToolsChanged(any()) } answers { + active.set(false) + throw OutOfMemoryError("ToolSourceRegistry.notifyToolsChanged") + } + } + SharedServices.register(ToolSourceRegistry::class.java, registry) + val app = fake("t1", tool("query", true)) + AutomaticServers.install { listOf(AutomaticEndpoint("com.example.app", app.port, "t1")) } + val deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(20) + + assertThrows(OutOfMemoryError::class.java) { + runBlocking { + plugin.probeHealth({ active.get() && System.nanoTime() < deadline }, intervalMs = 10) + } + } + } + + @Test + fun `a debugger service lookup that throws an OutOfMemoryError reaches the caller`() { + every { context.services.get(DebuggerEndpointService::class.java) } throws + OutOfMemoryError("PluginContext.services.get") + + assertThrows(OutOfMemoryError::class.java) { plugin.startDebuggerEntry { true } } + } + + @Test + fun `a registry lookup that throws an OutOfMemoryError ends the activation`() { + every { context.getPluginService(any(), ToolSourceRegistry::class.java) } throws + OutOfMemoryError("PluginContext.getPluginService") + try { + assertThrows(OutOfMemoryError::class.java) { plugin.activate() } + } finally { + every { context.getPluginService(any(), ToolSourceRegistry::class.java) } returns null + } + } + + @Test + fun `a registration that throws an OutOfMemoryError ends the activation`() { + val registry = mockk(relaxed = true) { + every { registerToolSource(any()) } throws OutOfMemoryError("ToolSourceRegistry.registerToolSource") + } + SharedServices.register(ToolSourceRegistry::class.java, registry) + + assertThrows(OutOfMemoryError::class.java) { plugin.activate() } + } + + @Test + fun `an unregistration that throws an OutOfMemoryError ends the deactivation`() { + val registry = mockk(relaxed = true) + SharedServices.register(ToolSourceRegistry::class.java, registry) + assertTrue(plugin.activate()) + every { registry.unregisterToolSource(any()) } throws + OutOfMemoryError("ToolSourceRegistry.unregisterToolSource") + try { + assertThrows(OutOfMemoryError::class.java) { plugin.deactivate() } + } finally { + every { registry.unregisterToolSource(any()) } just Runs + } + } + + @Test + fun `a health report that throws an OutOfMemoryError reaches whoever changed the health`() { + val registry = mockk(relaxed = true) + SharedServices.register(ToolSourceRegistry::class.java, registry) + assertTrue(plugin.activate()) + every { registry.notifyToolSourceStatusChanged(any()) } throws + OutOfMemoryError("ToolSourceRegistry.notifyToolSourceStatusChanged") + try { + assertThrows(OutOfMemoryError::class.java) { McpServerHealth.available("a-server") } + } finally { + every { registry.notifyToolSourceStatusChanged(any()) } just Runs + } + } + + @Test + fun `a settings listener that throws an OutOfMemoryError reaches whoever changed the settings`() { + val listener: () -> Unit = { throw OutOfMemoryError("telling the agent") } + McpServerStore.addChangeListener(listener) + try { + assertThrows(OutOfMemoryError::class.java) { userServer(1) } + } finally { + McpServerStore.removeChangeListener(listener) + } + } + + @Test + fun `a keystore call that throws an OutOfMemoryError while closing a session reaches the caller`() { + val server = userServer(fake("", tool("query", null), sessionId = "s1").port) + mockkObject(McpServerStore) + try { + every { McpServerStore.token(server.id) } returns KeystoreSecretStore.Stored.Absent + every { McpServerStore.headers(any()) } returns emptyMap() + McpToolCatalog.connect(server) + every { McpServerStore.token(server.id) } throws OutOfMemoryError("KeystoreSecretStore.readAndMigrate") + + assertThrows(OutOfMemoryError::class.java) { McpConnections.closeAll() } + } finally { + unmockkObject(McpServerStore) + } + } + + @Test + fun `dispose lets an OutOfMemoryError from the host through`() { + every { context.removePluginLifecycleListener(any()) } throws + OutOfMemoryError("PluginContext.removePluginLifecycleListener") + try { + assertThrows(OutOfMemoryError::class.java) { plugin.dispose() } + } finally { + every { context.removePluginLifecycleListener(any()) } just Runs + } + } + + @Test + fun `a relist that throws an OutOfMemoryError reaches the IDE's handler`() { + val app = fake("t1", tool("query", true)) + val currentPort = AtomicInteger(app.port) + val service = mockk { + every { endpoints } answers { listOf(DebuggerEndpoint("com.example.app", currentPort.get(), "t1", 0L)) } + } + every { context.services.get(DebuggerEndpointService::class.java) } returns service + val id = AutomaticServers.idFor("com.example.app") + assertTrue(plugin.activate()) + // The activation's own refresh lists the tools; after it only a relist connects, until the + // probe's first cycle 20 s later. + awaitUntil("the activation listed the tools") { McpToolCatalog.tools(id).isNotEmpty() } + mockkObject(McpToolCatalog) + try { + every { McpToolCatalog.connect(any(), any()) } throws OutOfMemoryError("relisting a relaunched app") + + val reached = reachingDefaultHandler(waitMs = 10_000) { + currentPort.set(app.port + 1) + AutomaticServers.refresh() + } + + assertTrue("reached the IDE's handler: $reached", reached.firstOrNull() is OutOfMemoryError) + } finally { + unmockkObject(McpToolCatalog) + } + } +} From d68fde9424905371e6b5588bc9e6d2fccc5fac07 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Tue, 17 Nov 2026 21:53:42 -0800 Subject: [PATCH 21/23] ADFA-7139 AI-Agent-MCP: min_ide_version is 26.48, since 26.47 shipped without the service Code on the Go 26.47 was released on 2026-11-17 without DebuggerEndpointService or the debugger.endpoints permission: the CoGo stack that adds them (#2259 to #2261) is not merged yet. So the first release that can ship them is 26.48. plugin.min_ide_version, its manifest comment, the plugin README and plugins/README.md now say 26.48 or later. 26.48 is still a guess, valid only if the stack merges before that release is cut. The manifest and both READMEs say to recheck it against the real release number before merging. The plugin manager only displays min_ide_version and checks it is not blank; it never compares it with the running version, so a debug build of Code on the Go still loads the plugin. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- plugins/AI-Agent-MCP/README.md | 9 +++++---- .../AI-Agent-MCP/src/main/AndroidManifest.xml | 20 ++++++++++--------- plugins/README.md | 3 ++- 3 files changed, 18 insertions(+), 14 deletions(-) diff --git a/plugins/AI-Agent-MCP/README.md b/plugins/AI-Agent-MCP/README.md index bb2f3cf03..8a1461e13 100644 --- a/plugins/AI-Agent-MCP/README.md +++ b/plugins/AI-Agent-MCP/README.md @@ -55,7 +55,7 @@ For an app built in Code on the Go with `cogo.sqliteDebugger=true`, the plugin adds a server entry on its own, named "SQLite debugger ()", with no URL or token to type. Code on the Go stores the port and token the running debug app reports; the plugin reads them through the `DebuggerEndpointService` -(permission `debugger.endpoints`, so it needs Code on the Go 26.47 or later) and +(permission `debugger.endpoints`, so it needs Code on the Go 26.48 or later) and points the entry at `http://127.0.0.1:/mcp`. A relaunched app gets a new port and token, and the plugin reads them again after a refused connection. An app that has not reported yet has no entry, and no error is shown. @@ -147,10 +147,11 @@ Two dependencies were deliberately not taken: such a URL, and the transport refuses it again, so a server saved before the rule is listed with a warning and never contacted until it is switched to `https://`. - The plugin declares the `debugger.endpoints` permission, to offer the SQLite debugger of the - open project's app without typing a port or token. Code on the Go 26.46 and older reject a + open project's app without typing a port or token. Code on the Go 26.47 and older reject a manifest that names a permission they do not know (`PluginSecurityManager.validatePlugin`), so this - version needs **26.47 or newer**, the first release that ships `DebuggerEndpointService` - (`plugin.min_ide_version`); users on 26.46 or older cannot install it. + version needs **26.48 or later**, the first release that ships `DebuggerEndpointService` + (`plugin.min_ide_version`); users on 26.47 or older cannot install it. 26.48 assumes the + release after 26.47 ships it; recheck it against the real release number before merging. - Redirects are never followed automatically. A 3xx is repeated only when it resolves to the same origin, so the bearer token and the user's own headers cannot be replayed to another host in one hop. diff --git a/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml b/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml index e1ed9f715..bb853f280 100644 --- a/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml +++ b/plugins/AI-Agent-MCP/src/main/AndroidManifest.xml @@ -39,17 +39,19 @@ android:name="plugin.author" android:value="App Dev for All" /> - + + android:value="26.48" /> Date: Wed, 18 Nov 2026 17:49:25 -0800 Subject: [PATCH 22/23] ADFA-7139 AI-Agent-MCP: an endpoint listener's OutOfMemoryError reaches the caller 21944cf0 narrowed the listener loops of McpServerStore, McpServerHealth and AutomaticServers.fireChanged to runCatchingRecoverable, but missed the endpoint-listener loop in AutomaticServers.refresh, which kept a bare runCatching. McpPlugin's relist listener is the one registered there; an OutOfMemoryError or a StackOverflowError raised while it ran was swallowed, not passed on to the IDE's uncaught-exception handler. The loop now uses runCatchingRecoverable, like fireChanged in the same file: an Exception or a LinkageError still costs only that listener's call, and any other Error propagates to refresh's caller. The KDoc of addEndpointListener and refresh says so. The other bare runCatching calls stay, since none of them calls host code or a listener that does: - McpSession.cancel (McpSession.kt:194): HttpURLConnection.disconnect. - McpToolSource.cancel (McpToolSource.kt:133): McpSession.cancel above. - McpTranscriptDialog.copy (McpTranscriptDialog.kt:70): the platform ClipboardManager. - McpHttpClient.kt:118 drains a 202 body from the platform connection; :144 calls McpExchangeListener, whose only implementations are this plugin's own McpExchangeLog and NONE. - McpRedactor.kt:56 (URLDecoder) and McpLogFormat.kt:56 (org.json): JDK and platform parsing. Tests: an endpoint listener that throws OutOfMemoryError makes refresh throw it (with the bare runCatching: "expected java.lang.OutOfMemoryError to be thrown, but nothing was thrown"); one that throws AbstractMethodError costs only its own call, and the next listener still hears the relaunch. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../aiagentmcp/debugger/AutomaticServers.kt | 8 +++- .../debugger/AutomaticServersTest.kt | 37 +++++++++++++++++++ 2 files changed, 43 insertions(+), 2 deletions(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt index 487cedb75..643762385 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServers.kt @@ -118,6 +118,9 @@ object AutomaticServers { /** * Registers [listener], called with the id of an entry that appeared or whose port or token * changed, so the owner can list its tools at once instead of at the next probe. + * + * Guarded like the change listeners: an Exception or a LinkageError from [listener] costs only + * that call, and any other Error propagates to [refresh]'s caller; see [runCatchingRecoverable]. */ fun addEndpointListener(listener: (String) -> Unit) { endpointListeners.add(listener) @@ -140,7 +143,8 @@ object AutomaticServers { * already replaced. * * A read that fails with an Exception or a LinkageError leaves the entries as they were; any - * other Error, an OutOfMemoryError above all, propagates to the caller. + * other Error, an OutOfMemoryError above all, propagates to the caller. So does one from a + * change or endpoint listener. * * @param keepGoing checked after the read, before anything is stored. * @return true when the set of entries, a port or a token changed. @@ -197,7 +201,7 @@ object AutomaticServers { for (id in moved) { // A refused credential is not final for this entry: the new one has not been tried. McpServerHealth.credentialChanged(id) - for (l in endpointListeners) runCatching { l(id) } + for (l in endpointListeners) runCatchingRecoverable { l(id) } } if (changed) fireChanged() return changed diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt index fe68c8ad1..1f950d2eb 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/debugger/AutomaticServersTest.kt @@ -242,6 +242,43 @@ class AutomaticServersTest { } } + /** Guarded like the change listeners: the process failing is not a relist that failed. */ + @Test + fun `an endpoint listener that throws an OutOfMemoryError reaches the caller`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val listener: (String) -> Unit = { throw OutOfMemoryError("relisting a relaunched app") } + AutomaticServers.addEndpointListener(listener) + try { + current = listOf(endpoint(port = 4001)) + + assertThrows(OutOfMemoryError::class.java) { AutomaticServers.refresh() } + } finally { + AutomaticServers.removeEndpointListener(listener) + } + } + + /** The other half of that guard: a host whose plugin-api differs costs only the one listener. */ + @Test + fun `an endpoint listener that throws a linkage error costs only its own call`() { + var current = listOf(endpoint()) + AutomaticServers.install { current } + val asked = mutableListOf() + val failing: (String) -> Unit = { throw AbstractMethodError("ToolSourceRegistry.notifyToolsChanged") } + val working: (String) -> Unit = { asked += it } + AutomaticServers.addEndpointListener(failing) + AutomaticServers.addEndpointListener(working) + try { + current = listOf(endpoint(port = 4001)) + + assertTrue(AutomaticServers.refresh()) + assertEquals(listOf(AutomaticServers.idFor("com.example.app")), asked) + } finally { + AutomaticServers.removeEndpointListener(failing) + AutomaticServers.removeEndpointListener(working) + } + } + @Test fun `an entry that disappears has its health and cached tools forgotten`() { var current = listOf(endpoint()) From f95d21e6852d02d37a01accd919945c9a5afcad6 Mon Sep 17 00:00:00 2001 From: David Schachter Date: Wed, 18 Nov 2026 17:49:25 -0800 Subject: [PATCH 23/23] ADFA-7139 AI-Agent-MCP: deactivate stops the scope even when the host cannot remove its listener deactivate() called context.removePluginLifecycleListener first, inside a try that catches Exception only. A host whose plugin-api differs from this plugin's answers that call with a LinkageError (AbstractMethodError, NoSuchMethodError), which skipped every later step: the activation's scope kept running, its probe kept refreshing every 20 s, and the sessions, the tool catalogue and the automatic entries were never released. An Exception from the same call skipped them too, ending in the catch's "deactivation failed". The removal now goes through runCatchingRecoverable, as dispose()'s already does, and a failure is logged as a warning. The rest of the deactivation runs either way. Any other Error, an OutOfMemoryError above all, still propagates. Test: with removePluginLifecycleListener throwing AbstractMethodError, deactivate stops the activation's scope, clears the automatic entries and the cached tools, and lets nothing escape. Without the fix it fails with "the activation's scope must be stopped". Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Vh2DAYT7GPoC2cDzo8LErn --- .../plugins/aiagentmcp/plugin/McpPlugin.kt | 5 ++- .../plugin/McpPluginHostErrorTest.kt | 45 +++++++++++++++++++ 2 files changed, 49 insertions(+), 1 deletion(-) diff --git a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt index a4db642fd..aa0763890 100644 --- a/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt +++ b/plugins/AI-Agent-MCP/src/main/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPlugin.kt @@ -253,7 +253,10 @@ class McpPlugin : IPlugin, SettingsExtension, DocumentationExtension { } override fun deactivate(): Boolean = try { - context.removePluginLifecycleListener(aiCoreLifecycle) + // Guarded like dispose's: a host whose plugin-api differs answers with a LinkageError, and + // one escaping here would skip every step below, leaving the scope and its probe running. + runCatchingRecoverable { context.removePluginLifecycleListener(aiCoreLifecycle) } + .onFailure { e -> context.logger.warn("McpPlugin: could not remove the lifecycle listener", e) } McpServerStore.removeChangeListener(settingsChanged) AutomaticServers.removeChangeListener(settingsChanged) McpServerHealth.removeChangeListener(healthChanged) diff --git a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt index 33fb9d1a4..2b9f30e7a 100644 --- a/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt +++ b/plugins/AI-Agent-MCP/src/test/kotlin/com/itsaky/androidide/plugins/aiagentmcp/plugin/McpPluginHostErrorTest.kt @@ -10,10 +10,13 @@ import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeMcpServer.Companion. import com.itsaky.androidide.plugins.aiagentmcp.testing.FakeSharedPreferences import com.itsaky.androidide.plugins.aiagentmcp.tools.McpToolCatalog import com.itsaky.androidide.plugins.security.KeystoreSecretStore +import com.itsaky.androidide.plugins.services.DebuggerEndpoint import com.itsaky.androidide.plugins.services.DebuggerEndpointService import com.itsaky.androidide.plugins.services.SharedServices import com.itsaky.androidide.plugins.services.ToolSourceRegistry +import io.mockk.Runs import io.mockk.every +import io.mockk.just import io.mockk.mockk import io.mockk.mockkObject import io.mockk.unmockkObject @@ -25,6 +28,7 @@ import kotlinx.coroutines.launch import kotlinx.coroutines.runBlocking import org.junit.After import org.junit.Assert.assertEquals +import org.junit.Assert.assertNull import org.junit.Assert.assertTrue import org.junit.Before import org.junit.Test @@ -62,6 +66,14 @@ class McpPluginHostErrorTest { private fun fake(token: String, vararg tools: org.json.JSONObject) = FakeMcpServer(token, tools.toList()).also { servers += it } + private fun awaitUntil(what: String, condition: () -> Boolean) { + val deadline = System.nanoTime() + TimeUnit.SECONDS.toNanos(10) + while (!condition()) { + check(System.nanoTime() < deadline) { "timed out waiting until $what" } + Thread.sleep(10) + } + } + /** Runs [block], turning an Error that escapes it into this test's failure. */ private fun survives(what: String, block: () -> T): T = try { block() @@ -130,6 +142,39 @@ class McpPluginHostErrorTest { } } + /** + * The removal comes first in deactivate, so an Error from it used to skip every later step: the + * scope and its 20 s probe kept running, and nothing was released. + */ + @Test + fun `a listener removal that throws a linkage error still stops the scope and releases the connections`() { + val app = fake("t1", tool("query", true)) + val service = mockk { + every { endpoints } returns listOf(DebuggerEndpoint("com.example.app", app.port, "t1", 0L)) + } + every { context.services.get(DebuggerEndpointService::class.java) } returns service + val id = AutomaticServers.idFor("com.example.app") + assertTrue(plugin.activate()) + val job = requireNotNull(plugin.scopeJob) + awaitUntil("the activation listed the tools") { McpToolCatalog.tools(id).isNotEmpty() } + every { context.removePluginLifecycleListener(any()) } throws + AbstractMethodError("PluginContext.removePluginLifecycleListener") + + val escaped = try { + plugin.deactivate() + null + } catch (e: Error) { + e + } finally { + every { context.removePluginLifecycleListener(any()) } just Runs + } + + assertTrue("the activation's scope must be stopped", job.isCancelled) + assertTrue("the automatic entries must be released", AutomaticServers.servers().isEmpty()) + assertTrue("the cached tools must be released", McpToolCatalog.tools(id).isEmpty()) + assertNull("deactivate let $escaped escape", escaped) + } + @Test fun `an error that escapes a coroutine stops at the backstop, not at the IDE's handler`() { val reached = CopyOnWriteArrayList()