From 7a06d800c2bb466fa78aeddc651141bc81cafc76 Mon Sep 17 00:00:00 2001
From: Chris <66376200+crickman@users.noreply.github.com>
Date: Tue, 23 Jul 2024 07:47:48 -0700
Subject: [PATCH] ADR Agents - Assistant V2 Support (#7215)
### Motivation and Context
Open AI has release the _Assistants V2_ API. This builds on top of the
V1 _assistant_ concept, but also invalidates certain V1 features. In
addition, the _dotnet_ API that supports _Assistant V2_ features is
entirely divergent on the `Azure.AI.OpenAI.Assistants` SDK that is
currently in use.
### Description
ADR describes changes to `Microsoft.SemanticKernel.Agents.OpenAI`
project / package.
Changes prototyped in this PR:
https://github.com/microsoft/semantic-kernel/pull/7126
PR completion is gated by the V2 connector migration work due to
versioning constraints.
> ADR Reviewed on July 18th, 2024
### Contribution Checklist
- [X] The code builds clean without any errors or warnings
- [X] The PR follows the [SK Contribution
Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
and the [pre-submission formatting
script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts)
raises no violations
- [X] All unit tests pass, and I have added new tests where possible
- [X] I didn't break anyone :smile:
---------
Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>
---
docs/decisions/0049-agents-assistantsV2.md | 184 ++++++++++++++++++
docs/decisions/diagrams/assistant-agent.mmd | 44 +++++
docs/decisions/diagrams/assistant-agent.png | Bin 0 -> 190412 bytes
.../diagrams/assistant-definition.mmd | 33 ++++
.../diagrams/assistant-definition.png | Bin 0 -> 148405 bytes
.../diagrams/assistant-invocationsettings.mmd | 23 +++
.../diagrams/assistant-invocationsettings.png | Bin 0 -> 165233 bytes
.../diagrams/assistant-serviceconfig.mmd | 40 ++++
.../diagrams/assistant-serviceconfig.png | Bin 0 -> 104491 bytes
.../assistant-threadcreationsettings.mmd | 8 +
.../assistant-threadcreationsettings.png | Bin 0 -> 98257 bytes
11 files changed, 332 insertions(+)
create mode 100644 docs/decisions/0049-agents-assistantsV2.md
create mode 100644 docs/decisions/diagrams/assistant-agent.mmd
create mode 100644 docs/decisions/diagrams/assistant-agent.png
create mode 100644 docs/decisions/diagrams/assistant-definition.mmd
create mode 100644 docs/decisions/diagrams/assistant-definition.png
create mode 100644 docs/decisions/diagrams/assistant-invocationsettings.mmd
create mode 100644 docs/decisions/diagrams/assistant-invocationsettings.png
create mode 100644 docs/decisions/diagrams/assistant-serviceconfig.mmd
create mode 100644 docs/decisions/diagrams/assistant-serviceconfig.png
create mode 100644 docs/decisions/diagrams/assistant-threadcreationsettings.mmd
create mode 100644 docs/decisions/diagrams/assistant-threadcreationsettings.png
diff --git a/docs/decisions/0049-agents-assistantsV2.md b/docs/decisions/0049-agents-assistantsV2.md
new file mode 100644
index 0000000000..b606ca8701
--- /dev/null
+++ b/docs/decisions/0049-agents-assistantsV2.md
@@ -0,0 +1,184 @@
+
+# Agent Framework - Assistant V2 Migration
+
+## Context and Problem Statement
+
+Open AI has release the _Assistants V2_ API. This builds on top of the V1 _assistant_ concept, but also invalidates certain V1 features. In addition, the _dotnet_ API that supports _Assistant V2_ features is entirely divergent on the `Azure.AI.OpenAI.Assistants` SDK that is currently in use.
+
+### Open Issues
+- **Streaming:** To be addressed as a discrete feature
+
+
+## Design
+
+Migrating to Assistant V2 API is a breaking change to the existing package due to:
+- Underlying capability differences (e.g. `file-search` vs `retrieval`)
+- Underlying V2 SDK is version incompatible with V1 (`OpenAI` and `Azure.AI.OpenAI`)
+
+### Agent Implementation
+
+The `OpenAIAssistant` agent is roughly equivalent to its V1 form save for:
+
+- Supports options for _assistant_, _thread_, and _run_
+- Agent definition shifts to `Definition` property
+- Convenience methods for producing an OpenAI client
+
+Previously, the agent definition as exposed via direct properties such as:
+
+- `FileIds`
+- `Metadata`
+
+This has all been shifted and expanded upon via the `Definition` property which is of the same type (`OpenAIAssistantDefinition`) utilized to create and query an assistant.
+
+
+
+
+
+The following table describes the purpose of diagramed methods on the `OpenAIAssistantAgent`.
+
+|Method Name|Description|
+---|---
+**Create**|Create a new assistant agent
+**ListDefinitions**|List existing assistant definitions
+**Retrieve**|Retrieve an existing assistant
+**CreateThread**|Create an assistant thread
+**DeleteThread**|Delete an assistant thread
+**AddChatMessage**|Add a message to an assistant thread
+**GetThreadMessages**|Retrieve all messages from an assistant thread
+**Delete**|Delete the assistant agent's definition (puts agent into a terminal state)
+**Invoke**|Invoke the assistant agent (no chat)
+**GetChannelKeys**|Inherited from `Agent`
+**CreateChannel**|Inherited from `Agent`
+
+
+### Class Inventory
+This section provides an overview / inventory of all the public surface area described in this ADR.
+
+|Class Name|Description|
+---|---
+**OpenAIAssistantAgent**|An `Agent` based on the Open AI Assistant API
+**OpenAIAssistantChannel**|An 'AgentChannel' for `OpenAIAssistantAgent` (associated with a _thread-id_.)
+**OpenAIAssistantDefinition**|All of the metadata / definition for an Open AI Assistant. Unable to use the _Open AI API_ model due to implementation constraints (constructor not public).
+**OpenAIAssistantExecutionOptions**|Options that affect the _run_, but defined globally for the agent/assistant.
+**OpenAIAssistantInvocationOptions**|Options bound to a discrete run, used for direct (no chat) invocation.
+**OpenAIThreadCreationOptions**|Options for creating a thread that take precedence over assistant definition, when specified.
+**OpenAIServiceConfiguration**|Describes the service connection and used to create the `OpenAIClient`
+
+
+### Run Processing
+
+The heart of supporting an _assistant_ agent is creating and processing a `Run`.
+
+A `Run` is effectively a discrete _assistant_ interaction on a `Thread` (or conversation).
+
+- https://platform.openai.com/docs/api-reference/runs
+- https://platform.openai.com/docs/api-reference/run-steps
+
+This `Run` processing is implemented as internal logic within the _OpenAI Agent Framework_ that is outlined here:
+
+Initiate processing using:
+
+- `agent` -> `OpenAIAssistantAgent`
+- `client` -> `AssistantClient`
+- `threadid` -> `string`
+- `options` -> `OpenAIAssistantInvocationOptions` (optional)
+
+
+Perform processing:
+
+- Verify `agent` not deleted
+- Define `RunCreationOptions`
+- Create the `run` (based on `threadid` and `agent.Id`)
+- Process the run:
+
+ do
+
+ - Poll `run` status until is not _queued_, _in-progress_, or _cancelling_
+ - Throw if `run` status is _expired_, _failed_, or _cancelled_
+ - Query `steps` for `run`
+
+ - if `run` status is _requires-action_
+
+ - process function `steps`
+
+ - post function results
+
+ - foreach (`step` is completed)
+
+ - if (`step` is tool-call) generate and yield tool content
+
+ - else if (`step` is message) generate and yield message content
+
+ while (`run` status is not completed)
+
+
+### Vector Store Support
+
+_Vector Store_ support is required in order to enable usage of the `file-search` tool.
+
+In alignment with V2 streaming of the `FileClient`, the caller may also directly target `VectorStoreClient` from the _OpenAI SDK_.
+
+
+### Definition / Options Classes
+
+Specific configuration/options classes are introduced to support the ability to define assistant behavior at each of the supported articulation points (i.e. _assistant_, _thread_, & _run_).
+
+|Class|Purpose|
+|---|---|
+|`OpenAIAssistantDefinition`|Definition of the assistant. Used when creating a new assistant, inspecting an assistant-agent instance, or querying assistant definitions.|
+|`OpenAIAssistantExecutionOptions`|Options that affect run execution, defined within assistant scope.|
+|`OpenAIAssistantInvocationOptions`|Run level options that take precedence over assistant definition, when specified.|
+|`OpenAIAssistantToolCallBehavior`|Informs tool-call behavior for the associated scope: assistant or run.|
+|`OpenAIThreadCreationOptions`|Thread scoped options that take precedence over assistant definition, when specified.|
+|`OpenAIServiceConfiguration`|Informs the which service to target, and how.|
+
+
+#### Assistant Definition
+
+The `OpenAIAssistantDefinition` was previously used only when enumerating a list of stored agents. It has been evolved to also be used as input for creating and agent and exposed as a discrete property on the `OpenAIAssistantAgent` instance.
+
+This includes optional `ExecutionOptions` which define default _run_ behavior. Since these execution options are not part of the remote assistant definition, they are persisted in the assistant metadata for when an existing agent is retrieved. `OpenAIAssistantToolCallBehavior` is included as part of the _execution options_ and modeled in alignment with the `ToolCallBehavior` associated with _AI Connectors_.
+
+> Note: Manual function calling isn't currently supported for `OpenAIAssistantAgent` or `AgentChat` and is planned to be addressed as an enhancement. When this supported is introduced, `OpenAIAssistantToolCallBehavior` will determine the function calling behavior (also in alignment with the `ToolCallBehavior` associated with _AI Connectors_).
+
+**Alternative (Future?)**
+
+A pending change has been authored that introduces `FunctionChoiceBehavior` as a property of the base / abstract `PromptExecutionSettings`. Once realized, it may make sense to evaluate integrating this pattern for `OpenAIAssistantAgent`. This may also imply in inheritance relationship of `PromptExecutionSettings` for both `OpenAIAssistantExecutionOptions` and `OpenAIAssistantInvocationOptions` (next section).
+
+**DECISION**: Do not support `tool_choice` until the `FunctionChoiceBehavior` is realized.
+
+
+
+
+
+
+#### Assistant Invocation Options
+
+When invoking an `OpenAIAssistantAgent` directly (no-chat), definition that only apply to a discrete run may be specified. These definition are defined as `OpenAIAssistantInvocationOptions` and ovetake precedence over any corresponding assistant or thread definition.
+
+> Note: These definition are also impacted by the `ToolCallBehavior` / `FunctionChoiceBehavior` quadary.
+
+
+
+
+
+
+#### Thread Creation Options
+
+When invoking an `OpenAIAssistantAgent` directly (no-chat), a thread must be explicitly managed. When doing so, thread specific options may be specified. These options are defined as `OpenAIThreadCreationOptions` and take precedence over any corresponding assistant definition.
+
+
+
+
+
+
+#### Service Configuration
+
+The `OpenAIServiceConfiguration` defines how to connect to a specific remote service, whether it be OpenAI, Azure, or proxy. This eliminates the need to define multiple overloads for each call site that results in a connection to the remote API service (i.e. create a _client)_.
+
+> Note: This was previously named `OpenAIAssistantConfiguration`, but is not necessarily assistant specific.
+
+
+
+
+
diff --git a/docs/decisions/diagrams/assistant-agent.mmd b/docs/decisions/diagrams/assistant-agent.mmd
new file mode 100644
index 0000000000..2a90f105a5
--- /dev/null
+++ b/docs/decisions/diagrams/assistant-agent.mmd
@@ -0,0 +1,44 @@
+classDiagram
+
+ KernelAgent
+ OpenAIAssistantDefinition
+ OpenAIAssistantDefinition --> OpenAIExecutionOptions
+ OpenAIExecutionOptions
+ OpenAIExecutionOptions --> AssistantToolCallBehavior
+ OpenAIServiceConfiguration
+ OpenAIAssistantInvocationOptions
+ OpenAIAssistantInvocationOptions --> AssistantToolCallBehavior
+ OpenAIThreadCreationOptions
+
+ KernelAgent <|-- OpenAIAssistantAgent
+ OpenAIAssistantAgent ..> OpenAIServiceConfiguration
+ OpenAIAssistantAgent -- OpenAIAssistantChannel
+ OpenAIAssistantAgent --> OpenAIAssistantDefinition
+ OpenAIAssistantAgent ..> OpenAIAssistantInvocationOptions
+ OpenAIAssistantAgent ..> OpenAIThreadCreationOptions
+ class OpenAIAssistantAgent {
+ +OpenAIAssistantDefinition Definition
+ +bool IsDeleted
+ +RunPollingConfiguration Polling
+ +Task~OpenAIAssistantAgent~ Create(Kernel kernel, OpenAIServiceConfiguration config, OpenAIAssistantDefinition definition)$
+ +AsyncEnumerable~OpenAIAssistantDefinition~ ListDefinitions(OpenAIServiceConfiguration config)$
+ +Task~OpenAIAssistantAgent~ Retrieve(Kernel kernel, OpenAIServiceConfiguration config, string id)$
+ +Task~string~ CreateThread()
+ +Task~string~ CreateThread(OpenAIThreadCreationOptions? Options)
+ +Task~bool~ DeleteThread(string threadId)
+ +Task AddChatMessage(string threadId, ChatMessageContent message)
+ +AsyncEnumerable~ChatMessageContent~ GetThreadMessages(string threadId)
+ +Task~bool~ Delete()
+ +AsyncEnumerable~ChatMessageContent~ Invoke(string threadId)
+ +AsyncEnumerable~ChatMessageContent~ Invoke(string threadId, OpenAIAssistantInvocationOptions? Options)
+ #AsyncEnumerable~string~ GetChannelKeys()
+ #Task~AgentChannel~ CreateChannel()
+ }
+
+ OpenAIAssistantChannel ..> OpenAIAssistantAgent
+ class OpenAIAssistantChannel {
+ #Task Receive(IReadOnlyList history)
+ #AsyncEnumerable Invoke(OpenAIAssistantAgent agent)
+ #AsyncEnumerable GetHistory()
+ }
+
diff --git a/docs/decisions/diagrams/assistant-agent.png b/docs/decisions/diagrams/assistant-agent.png
new file mode 100644
index 0000000000000000000000000000000000000000..cfe3b28e804cc7bde8c7c27bd877ad82891dc7eb
GIT binary patch
literal 190412
zcmeFZXINBQvn~pV3L=7{ARq`zkR*}?B&djzRU|h-NdgiiN;geV1QnDhNNN-bBG5?A
zK~M=zPEAH6(*y}kLzB*!E(!bF-+t~s&w1|saqeC}TsnKsF~_V?Rio;yx5mrc>Nly6
zFdZQwA)!{frEr&o2$>N9uI<<~0&@)0rs}5;hVgg{$|T7|jg0
zJ-KJzTeHASOMWl$OId(ICsS6ro!zzS6`K4H&;ql-wc{4Ia%dW!REX5skI}!&|G3Ve6yPh?N<=
z;cFzMjIZH4B)PMcs|4iV2B=Em4fl4kPx$P@_(#Dbx+8-XJ
zQ}RJXN4y$cZg{gI9
zIJVDtdXCVdm%R5Glu4NPDYTsIs&$>0k!*~j`8$UrXI6i{^QhRCsKPrWh%oFt{PQk&
zXC(a_^Ygp!ysY8vFyJmm>2kvt_uHN)e>@J|o=gLZEHh9((?&vc>U_9oEHFJEXU
z@{ru`JS>PrN^@5l7f*p9tcG>PcV^`6y+lrdjnfIct)o!L`uQ|rcZ@7P`9ju`Jj;o_
z35ZkCqWg|A`3zHF&wDq8@BHAca*zURsDC+P-#T0YGMVV)=s0y8?a%vTbLUq186f5w
zyV)Mey$Lh|nTS7AG`U=br+6>Ix%0#SsaWOteQ^f)8=4l4%Ato@pIqxLm^aNa8TAJe
z@u1cv-F*!`m}$YiS1!9UqPT3t*6o1Y+Axa}wffTUZYdBYVV`kQ0RExJK)=^4>e7Ah
zd+ARy5|hff#_F}4`%xKrG^a0JMR_>hj=tem6z>g>&BMoL-gb06
zZc9{BN!81_{|3hnYYutAyyx7vjJ+M=Zj$bEmNDc_oG`EL&4NVD6u(7WW<_nT6<^Z*
z>T&Um`oa6zR9KC8S%CwG^Fv&4+O_Q(&EZ`ch;C{3i;B#mpW;e?SKU=oLn=*oSVfOe
z_~Il_JU+1VvEC%ZQq4PR1L^w8kx_A&oYQ!q^HkeC*ZD!NffAZXqcTOMa*wqc!&tSC
z<_u^r;*@{eXDzk0vB>z*2!pMQR1D?342I5+^F`ui5Zd&DsB>CrUEwkI<(OoxE&J0|
zE`3Ujw7Z`JKF)IgK885xNQcI~oMseJtPSOCADb(|)ip$=i5zTWlC>WwR=<1qP+d6^
z(eTv1EHC;BzJnuGKd*Srp6|Ekua|a<18&B3Nuh?YVOU+)MmDXkweex}Ey_#l72?i4@8jogH!$rO2o2X0GOi5IY!k8~l
zS|(~|99AHlI6I^;=!sBCK4*h?R~Hs}nEwhlc6L+x>%(0G5v6LO=Za3l4DKmN6>o5i
zgUm&A&g9fIl^{QtN~B#lPznLf(`63#Ur}};GdI?j5WO|J!^H#{Z8QZ7sv{AtdL
z4i`6#HJg8Zig)a@b)!T3!H{y&Z1;{nfptryUQz
zzruv`@Fgm~K7^7-v?oWZ6&jUqXrY8;w^muEy0b#g$Pk}3#1yDocNPyh5e+q5Y0k=C
zR}Q~muI`27S(=D9=8!>fDF?ACq1HV#&^Gb-a%B7^LF!J;aTaOu;H754bC^i`rPA&W
z>((~3q5ag5S80#Rg9j4s3*Vis+LKc#oBHxI_~bU7b-C2)FRix-9tXz5K2R+7_S}t&
zmqt!qgmwGk4%2uFoWGf@oMSON79{s3W(^;{Z5refDr8E3TCulkw6(hF%g(x!kX@;-vdLuL>OD*5lz`n|5DC`&U
zDj&>ibvQpXw)C4w#3?D8TWCSn*{)gkij=MlnunO^A}8Z;bBsk)QE9cy5JOb{!&WUK
z-sZmg2Si1;^Xl)WZ0pWzbe_2Qbw8Y#&7k1I!t0z2KTpQr1r-C0Ha%lcI`Qhm-eQv2mHS~@1DZaeo
z{`84R;qKK*?`FqgGwV-0F^H$+f?SYA6YEDE6Qj9cWfhjwU|v?6d;3F`h0G~l
z7-yG~>pVluT=zn>^IZQ06%2z+96AFgOPrLmn32c2PsDMnL_7+8bt;n!RxlN1etJj!
zNPPOirZqA6Mq|&vvjr=$bvPIrj~6}av1p%5ycu*;p?ab>FQzt-kxxwp^446=SZ#qY
zE`g<7_<}i2$6>>HDlV9PPj-om?7AppfG+jcEteOKHjTgX#7wL
zv2v?fMFVeyq@4QsRWtGN$YuB0Jh9~Ybr!ddOYyB?Yg-p_&y$HF>gc7&JtxU_7i@wd
zp_WE_^ZrCf0nFIWINN@R6{uYP85y|lAsQ41i_~(Y#Nd;G<%?MF-f01JN~xId_9CWP
zRhpr!Net$-Sa&tK01hWMsFw9;#I71f2*wMz4QLtIm9L>yom^(6I+nEyjLeF?wz)}h
zJ%x{{S|cRRdi>7MwKXt6m&{p2iO)(pRSm2YH2}M&NsMMr$uSQH)$*b3m@6$=k2+-HA5rXDe5DcCWDzoq
z)Vo*M{0@RWPDdOmlv@5%(^$3Gc}fxToaUpoXDo
zy#V5$bEgY-10o7G+FL(i)p)tB%NNVw-=S?tt>ubMmt2Dq?kyifZK*rmXv+ut#tsk_
zgtN+oCR(*?-~D28)u76Sh4AxhrdnTwm`y}2*c22r>V`ZK)QrMr+5JyOSS;o=WZgA-
z3o10!LjRV-?|GH@H^s`&1#_#`L_7({G~3(9v6&M|$f*j$O=_tn1awKk^n
zj^RVoJE3dG&UD+%@#$p;=GykDK#`9Aq_3l+A@-8>JsQ0d@#Q}EwvRsw+P@CK@k5ULS0^Vd=n19nZW!~E
z2`Cpf{MGY43%_g#g6FAI_3lUz|1dv3y!XMzV3JoT_goi6HwTE6>CDLe*VfdH3{rcjV5kB#aMr`QY&UW%nxpSkk8
z~_U>H)
z`AQ#-@ntIz(ubzlogciVfi4W_NoembF56FeAf&_eoZmP>%0uyEcIQ_4qrk>$92R<{
zc2~l?3awvkl$yds0SI_1Eg5+j7pu4Mz-rfg*OjvZoX(K@<`TtX~eyPG2Ue!_A
zT3VEJc+Stm?Q`HPYuNR5udu^X5sg#Yp1YD}qaA@3aEs&%a!=FO$swBvsMT9PWS;ni
zD!c;y=}Q0X;+JNO?~XQ+kjpeJGG`Dr6-DzM`%eBs>I2|9F1h2PAsF;V~*4lhiMI=ti4<=Lho+c17mlU;fj4z1z@e&V9l_?}C80SA^#h#5;9nu;K#X6;-rC4{uy
zDU%c5+c+HNfD9(=YAN;>j^bOOe2lnlqJExrXmBvC2*Tpyz8_b?MmJHk`)%N*KJUp_
z<_7o<96lCKcJN4Tw3y9P;!%mc?T(E$1H7YEUvK64uIRnJ8_9Ak8bjr_H#EiV2l=c0
zX(IdVD+b0HPaoUW3=&cT1(0WocKXS^Yd$ZIT-o?tE$lj@+mme`utCISE_P^Y+;Emr
z-Ln>Nc@Cgd=Tn>e_szUe!32vo6n0-Ub6@GP9BbE*d&?>Vul1v5hGoMecKsjNJvYI8
zS7L7WO+GXyGT}gaQfGIq?^J`Bb
zNy#6;-W!#{vmdseOV!Ov2+=KePMsO5Fb)k3eE{>D-SeK`J_GAW*G3`tF0s)jRwk>(
zn5`|2Wt)5@YvwNBTrqIpSg2{ls8OA~Ks$P?e|Pg@^Oj!*61%A(&_lUz?(XLEvpS7sKcK-Zz5X_!8t$9Ozd26aYB}qF&KVcJ#i4ch4#+mG&c`V2P=DvOYvOg9%
z!`6~zdK1k0bw{cucV8z57gxOt){r|xKhLr9vmV*LsSY0p4lhU~XV2lW{p9u8TqmeZ
zG{rSyl%0z6ZTq;atgL_$mx-ndD6
zzLZ~%PwR8|x0;%Xuhyqe>=`EM1dzXUCRh62W+|Yn(aOV#eFZEwdI$pgP(O2g-{3LibA=gV0r+r#gV?ow
z3h0mpcAkKMnzp^c9)TdU;BDB~eRsXE1DZdH7A(2Gx7&e@L*@zJoWkxEdA9L`M8dov
ze!6qyd9u(p2g&XR#r7{jJPFxVFqOk<`wMq>E`qIO?4Si=pI__d0U=ikm+79zEz|@1
zRb!{=ZcqvQt}nPI)9_Pu&-MS*1*={Y;rD#+LAIa&0P()3_O2-?f(M1?8eZ*l-h9Bj
z8tRGD?}f8KU3_uw-u1!zCZ>=Ev@%ya0=YMsFOc_tC>ww*`9FuI!AbxHK1{Z^nxy1U
zfn%bHe#N}E0tqlMuX?J6m3>R_1&UqO)qd=0lLJ&QiAk&J-FuLh0$hW?`x>>k(^O`G
z*}oB>rrKLN`AT6rY0s6Z{@|JzyD_>{>
z-FTS6zrHsZg%+6qJ)yaq`*gz($knuP_0e9Plno?@QZ(fI`~(HL0Fa^RDT&?KnnIxn
z%qyJX-Rz#A*-TQvhsQ++?s>?c7GS+4bb|8sSvf7ZhQIVogk|>y-lkvJ_Lr!@Ms}2{
z|8WhAuyw};tNy~rNBO?E?3ySkxdH$XkL+7_dA5gOI`2~p_gn^BJ@}4~rIn9p_AM5a
zhRt@E@$U^K0Yz*@@bo>2llWYMJOE?t)ZPoufUIV&yY0)Ry$8u-xxuy4=r8AXuldwM
zKIccA-f{WLLq6>(H8S5;censey_b$$|LdLQFOYSn=|mnsuXwB4kNW!BX~JLecvF*2
zoNBPFzHrosgv=Gnw>j%B0}FBWnMmAr`@TaZND#KN+ns(|??iw+L9DI6VgK=YI=Nh1$TL^O8)5_jwgai0nYn
z{@&j+D17e#BMR(R1zP@3>Rq>68u=@oCP*nQ40TU|SwP^!Pkmqo*oZgJ_gMktf_;Je
zWhJ98I7h1pnZyH;Q)CqXB(vNf_n8%R>t)ExM7iA80<(aS9B&&iZ9@Yo`h5W?^mf{(
zK&>fs`(MeQ1~*i{XuLP1mR--a*#B+<|3R4ER0qXv;d*d_Cya<^
z=AP{%JRUx#EBue}<{+`#&+5861GT;BhU{S>y90TM&M|W*AU5w=vUuc52nRP!_-r2*
z6YsUfbK@0^O)W;2os#n9-TX)HeG`~jZ?BEVuoEYu>oN+o!vGkWeN^P(ZE5%6=SjjQ
zmE`UKB-ZmRf7HY8K9yvi?J%6?*m{Fu!j+M9BIC|Sp9WN!B7l0MXS?M#e#h~{E-UeB
zmnx#3B*fU_ezQ(CM2RG$wpVK&FbX}02#26`Cg16Dova7n)o77Rjcx~}VW>euleE2ZUw&Sa$6A_MPj;go*~m;4-n7OuLOqVD
zeto`zb7?#y3^8wO)~A16rbyPyGg~!U^zzS05?6lJ0~>{f))t@M^10P>M#9G3xbq){nxElaX&4sjfQ{(UqpQ#SJJGwJ%dfxgjR8~flS
z6$$0KQ1hpZ!p(D%h?Vp})&Wg`&)bf_lfw7#b7$mGVGHaGq58{>npV1A9-b-3LHCKV
z9(WFOH_vb}K8B<(zl`_!kyD{yB#dprKwQR4qJYtr8=ti^qPUHVfxe7}nB4`ls_X<)
zMPED{5cB|O|AmVe4X%SsA2`smsu{?Eez|GV@Xja{CEGrqIwn}Lp{k!>sVfVI1FVvAJzFb@v7qf3NZ7&>tvjd3
zEAY8)STs$vD~Gh3-AbSv)-ca}V^x&Lc&lDDW@9?-z@I|$*1CN|{1C$4G)e}McaryB
zx0CUEht1`wc3}q-=2p#K_$fi7y8vg#bm|z-ug!REucsbm>FvpR<2c3}%{twS8vQ-|
zOxX32yteD
zuaV(}nv!?D)&cCelbd4L{tKsg?=AN0BsYu+!
zt2EUE57`DXjj3Amg_uwh_Jd!2aYLT#NkcEWG>q(?KBP8dxTq@hwRk>>bm}ju0Oc?+
zWU{4>v8iyDDe`QVA=J4IAvt^bJk}O%9S2+_;C>V*|BwK<-eEP@uttcmM?H(Lu52!=
zS`8HYug$c6lv7?`aTyEK7$gKH8J~Q({?5A7IwqedvtsL7a*}?0!Fb16{bAx~Eh=+R
zYmAyJ=tT#fZWZfuK#u%~Of)F)7e;Ci(DUmGcBWxz>eY~rN3dmHbnijwtfw6LEc~LO
zxMm59VZcfu!ItsfdwEhNHA5SHoX7sMkg_{r0B<(l(8)DQvpl1VXs25O%$rS?al1bj
zS^=czeuCB^8H7+GxT?=UaumQU*n$foF~4~16YnW?t}%MRqH0loGb7`t?sZccd^+hA
z_=0m*R+)9LB?j-4%{?9=*7fEwI${L8BsP08=;oO^rt22#-`Wce&k*r^=9S)EPN5Adj{mMa5Tv49@7Q{&cl}7dKp=`NUc&xq11Ju$BGLhyA*YfKJuw=g
z+3bRoAYJ}e*yTiAR#@sgG&t+ZuVKsBQL+6*v*z13yTxAtQ{&<5pm@o_lbSXeNeNLx
zR#(4{ClW)>`zLC|(~ozQyh%xE#`j1*`EA1}DXaw$BEjBJ#fsb($&9kp_
zUb2&Xjw=@w9{4hRb{s;NKnC^Ai7
zz)sWytOi6PVjqT!Zl13;f;Nsz5HLv@ZAD7~MLi0a>_F-;0pui|LZ40!6w~3e_o4bY
zsR4U9EQsl?HQWqg%&mb6_VpbfH_P&?WO|C5GA#ooeZFsoQieEcyn5!kw}U0ra-P0fHCr6QAM!6xgkU
zGd7#>3Z;IvP~~)_Mo=^boxwV-nIdbe4zoc--T62kr8(0p`$GbT-Ta)E@7+_eO_zg|
znacQDikdm*?6{ehxe~+BU~RxKggNpaFS=UfhXXb8Jbf}f?jC%>p>&2Aed80W`OmZT
ziyqFyy=E;-v1qaO73nP$OO;E?7Ot`w3Q667WJ=PE(#3bS-jhC`08SZH9GcAz`8^Ht
z^c7CR0O8Bj^Eo6_ADk!oP!^LiF4fkHG_|vN14Jm}3dHfo%y+^1>zOtVHf5t7ZU?l#
zM7P&L{0HKj5oB90VYGNYKou#MCOEh}+lOW^$$!uq88VHLjuhzQPf|9tmi^4W9xWEY
zDU_8)*`3i$q{8AoHy@bH4-y(8Pr{4)rrTLBzzViDw${&z5T;AZNpo3-{|srEi+t0R
z8Hq~33Z6?>F~0VB)?_*0AhIZ3mX2sZ3z#KB0$v-2KI*N&BI}H84nY;u2kJlt#+94=
z49|fyB=lOADmiT}6p3qs)B%K^ft4VLNJOr$j{>L#h3e_8S3txQ<~9o{eQmII=R_>h
z!;L-H>c~^IjTd>f>{j}mHlNW9ireal-YX#5;FK(74rXk2XGFd@#Eb@OPn{co?fDUR
zb$vkj(EgoiL*u-*VvAkR?Nm$C&Qmp@mwBC;GMJ&V{?cu-<+kkFsG&wC5x6Q(#R}(^
z$dcqFwUyk;tT`-03B*rXn_v*CHZXQ|o@_BbbWD|gbCz^72h?iK)LU$D;kT>t01d9+
zSlbQWpiy!P-;uKp~IttP8bDLk*(QYR84^~@=~)H;ZFwkEds>lk2+%pif@8IUMBBB
z5(vQ01KFMbD?9H)8B`3(?|x&4w6cEXjhjaflBSlEbQ0Qr!!*imbkkExZUWApR@%5_
zQS&;-lS{+JemTU&JGR@un4cmF{Ib;bX;}LQa}%?At8{0L(<3vCoLj%6#PsCa#gbC&
zLqSLs(>^^I>FM+3$%0}}{%kx5WMWk1pn^Q*AVAk*lLP|scXg=WmI)%+Q&-puh;fK*
zRb$??`{m`M?L#hgoRLv$qN_B?0)YiVVyHvQFJI=oPDM!(Jl#_VM>Y+};Eskkw9}eV
zuP`@{)tin_t@49j+X5n}3c*Y1VZ;xw#C$0MpGTJ65pM6;v
z*;U|P4*Pr)_!DU>%4=v>fLJ?9#4>!Qub^fl>QGJ4l{Ta0=Wlzr6a@L$IvMP&hnBDV
zmy3CM;xal%Q&YHw?e<)7|&Y{$voT0iNWm4rLBZN-*DRz=z
zJCqQn$Da3Qb0$aHtUmk$%Aw4CNxdyuO<-*%C+NzoZmG%~3x`JhR_sh~-asrZ*4vQGDPW6Z=MN7;-
zRDXbDpk+FTV_+s$bY3?`e;y`en~SK{X5P=s&#=Ox3-n_09rX%-Ye~A!JiI+zj8@UW
z;#8C~in}t0RJXPWy}}l%^ZWw#{LFm)U3r1b1@eB!W*-r2){VNRTxC+xKkDiZn6Izk
zla0&fQjE&{8zRpzee*wo#zm5SRKy1Z;#`BSRI^Ry>{9I9MCRYJTsf4_(Cy1C*=T)%
zlG5JlfBMIqL*?IlizZ$z?9n1)a>hlHQ!`z8P~}M7n8)Dde+++Py~ieK6PWSiPLwV`
zlorY_1CMyqSgq%dGg!f!H(7cPk_iEvkTuNQvK{&z1z@WQp3L)yjdLHq;@~C_O2pF`
zDmn!RLzqqO{8?=wkczU>nOlTigfi&+tx&$X0V-KdVNedtW>Nrxqk)8`vl@Nt=|*vY
zW!Mya;P6WHK^rPojm@{5DuPTfz!2q7N6duW>jvIUoL8D|0CwTKWM4Iomscd
zS0({K;R2`xV&}cRLCs*|>VIR3|4!N#KwzfH9gjN9!N3>!PGfG6_-s>}ad>f#@fu&?
z6qG(o4@JXZ{dWII(Eiz8;1!x?&&ylT#mkz9Ff*kn+`j~(fE}!uczbx`#lMJyjW&<0
z=1pv<^fUuEEU5QLj!*#voaQ;EgJSb!(SMc;9a--4moJ5Llo+7Cl8{2X@v}YM|MRzhX8;gRD6eqv*jd>NrazWL
zy|$d*h6{Qn@xxX>!`#PQjvIy$@hw&efP>>-g*C=t;ixdn_yKnP_^c5QAHkYqkb$(91vV5DFQPxATWtiBLV+lCv
zsKt7|W@W`6u0_OYoNdod(A%J-62o+_aI21czW&R74dqOu^PoEVBfnu@`i0+s)5M#%
z06B5o#22`G&M?y=ywEoS&_BSmpI*(ZBc2;Umsn#uQk#`S&M~|=v@+zi{Th_kZ(C#S
zPTVc@{QVQFC(H0qkO^%gAh+S5qX1l9-&F5)cZ+A9Z2Mq-kQD)A|C1@!0@N6Ov1OG4
zAhg#Z#_sj5X4&-%n7X<7@^$52K*07thUEKrQ|>%rXuFV71wVM_BfJ)EXaMjxg{ju_
zJPFM4Vth&{gk5!o_FL98zU6+Y<8yeVLkC)r>R
zbBf_P0Zr2i)sTsg6SD~iyveuBcAug-VFlx$a_T$NU)0mF0)czs;m+>Azjj^CZ0*m@>c&
zt{^;gNF`h$KD1<%&M%-OfCBu*P2y`hnLD!sXa#I*mgxZy0%h{U-kqbQ)KD4uA@KAF
zHc}wQT>ss@G;JO6N2~r*G)%R`g{oW(qmg}L;CFP&WF?LJE1ul#!LLV7_4?0T=5bBZHg%=$HjSzCfAPU3
z$ufXV@_bZGsu#m1?Rdn!r#G;V>c=fx&@+l0QCzj*29eNcP3m5yOTn&kp5sr_`5qeRg15fgD9E^Kgp
z06-;mqji`u6k<*!-XPEV!_l*YlI_~*!4fUaqPZ*7yv@>?!MXOvIv~qKHtSBmFRPUU
zw0hENmoiD&@|O#Qa&+M@rgl5Uvh=WDs;`sF-gL%($x02(0
zFl<r6(;?O0n{d5;#
zL&ZRrLg@q}_c1ZhSJR)aSJV1l3wz17*C9%pFvc%PXqdB-<~>;Z6B
z48Ug_UOLb7m1y%e%T?5RSbZ?&nyj01U*dY#KB6C_pEpPF#r3XxE>EtF=a!;^wJ}6|
zOdaTpX;9IBW=l0vc5%LWl1V519XBxh6LBgUMh1BU<;b!WW90iXU9rhlQ{Rcv;^;GS
zTP3Qo@9b7mQpQT0t#~UoT^q=WM9zTu31_6w$|9($L{Df5%GhSEcSTPVL3i6*&_)##
zpOm5@k+O*&Eu6Fb`t&8&x8^CmCFJS>0FK#Q0rV2eRs6T|e3rJMz?Kzhn=XDK?&&<5
za@1B(V%)q4V&OaIV#mdX?K8rAm1_BLsNm)9(}UVqe{=Q2)dX!@5Z~GS92Ydng}WO7
zz?2LdalR`_FvsK9%V|e^r^KxQ`h~W#^=eY8#ILiUgz+lhW?}X?U?rVZ!9<8P)LGbU
zxDC3ulShIyH5^ojIOMiHI&xp6YEF=9oPFXoTwK24__I>nai;qYC`r7wGF@84U>c`>
zjbRF+f(<8ZhPGsvZg}TMw}$=ddOOhU@l4rvJtX#uy!azsf$RS2A|vh<9HJ!-h6Y)a
zRvV!6%UlX+i(gwI^qjwWOeIDwQo)W99m`awGF&3VLYS87Wtk*_gPJ>H%xm?B(ZE?+gB6aLFkr*!37>#CBy51P
zh*0t|dia_9OM(5+Pf4Yj5^Cz}+Y3S86WAZ5-ZfWcn_woo$6qL)K*5EP#22vVxZadL
zgokZ~5ZqZquiV2mVgU^bA^ZmUJ+Xm=f7%7d$;<3ZXjyJ)0H{e^2B5@Ik|M1$cZ|uU
ztlES%=2vGt$B~YP8jCi~wzmEv=JmG$lC0viSZ>=V%VkD$5^d8LEuWza8Xb`u4mR@(
zx2pkWO$K@#xSb}@LfrLvK_2fhXomr}xQP?!vzNbMm+#wmOtz{TujtwuY%Rslj!RJG
zYLwa+&aJ1f^|`$d!wtIf>6G7BuR{|4j;3a1{hYIHDpw3c8
zDd$&f36%sRulT(4yNI@^^-0U#2xFq-KfvB(y>Yy`Cr+f=ukz$`$e$RQRoW`u>{jo(5R=&cAYVd7z4gP{x86Z?_
zz5uU#wx@7`(+QybGLO{1O8nGY6-#|Qm~x|hMQn8hVixsXy9|C#(#cgQ9HZRXIIjvDJJte_FcEy
z)>^X`DuT0%W^M1Pw|vMBUU8a?H{c$|Q=OpRcF81GWJK1eziTmWYfHXW^X5Q9
zBtNHexUk^)&U~TSUOfHg(;Jx%2fuBtoKS7Xx2I@Cm*bgSanc8usg6-s%u-+v^jOU!
zk$Q6i1semoUQi%D_U+}6IeuDn2~Dy|cA?Exs)8Vb%bX~V`|l_!=oo8OSM7^ho}#n7
z<}jr4>?+bK`OuVh;an#2MZT4i3Zl{X3-Q6-S=%|pfV*YJBZMy^9(GoYx3jc%In&!M
z0K~~s?G8B>oM8WISKD6JOxdbEiN*z}=1t@u>LH#}n#V|)XBv}rpf^GIEXM}#?JsuT
zlmgvptwI}{s_S`(!*9R8IwfHNG`Vgjl{6idK1XBXeo@_Ee
z0|I`D*Hnj8uyOA$8|2#=avPS&PEyw3Wxcqu8SNd~)By~FRz}x88^a&oo}Fj9@+36Z
zeyBNp0yG*2A7h!uFc{BZ9Me{6GYtrtVY8qo{lM%E#4kie%e{)qg)*$Z$IBB*oHEE9
z7-)pOiVPWP<}P6%L-b8iA$GuC#_^Dwy)luW;a-nJ`#kYqV~I3oDLxhR4AdWZtZ*;s4%e2<&xuMy2sH$P|N13`P}esYcKiBtLgmA?=c*6WQ~L3~EAOv{C4u7U
zcn;Go`|jT~t&y_Uw=%F0MZ?!up*4b^Np#%V(XcP|;qP?zrQgFM*^~MiCIC?v=WfZ^
zYBjC7C@Lt79C=O61?#%qy55#Y&C=UClVd+5By6gf(Bp5!^v(KxhA|n)PwwOnl~%-0
zl?`4UJIDYtD_7Ocv3NO&xu4fujEbHE9eb25E=>XkMnc@6?S#$f
zQ}{LFuRK;SVQzf@G?ZSAlHIh*p`i}Mt2`TTlveiGplyz1{2f#CBK2X#~+W-KY>q7ET_9y#A4U=7O1f~IhumDS<4L~BWjJy^EX~Iy-swS4{;oM
z?e^~ed8?Fpy5EF8dLltqaHeXbnH?~kcCf@<@?6m#*~rALkTvk(B|)E~7H8)6X#4-*
zU~GUli8o0qr1AL;pecWBOb_5sK$sk}5aW^EsQwRbw#zFFcnqF7?M2cpOJ)aAtex<>
zyS+L8%tZbR*k=DUU=0I84^5^-4xmZBCJUj!+QMY7?@jj~tco@q6OrY*K!_dHexg_+BKh40@xOM#VzC-PG{5tVv=YKkaOOXu0WBc}dXcpv9qryo#
z33ggQ2*!U269HVaZg9;ml4ImwFtW=K#k8*TzHJuN1cm9eoTn%Rgv^1lgJx^{ygu~Q
zRRBdF{{Bsk!WXpJ$;^zZzSvK0+g*o0(9B=@xdA^2?P?tHJ_ouT7dUsoey7{;Kn2>J(D3oOmVxCS-YuTm%@(pp4)%}#E>gH3~#yD50-wPcKF@^
z3c=r?`c%FatPFeD0*x}PisW(95|~eSWd2aFc2F9b(;!|AW+bwC30
zfHwT^Qblup5?kQWun2+qw|tqUP3<`wKo}w5gp6B?Kh8+HOy7$rJET7X%5-L%#J9rt
zt4K@}xrbxKY`CGoq%8>p@A|p7P2kOi#EW3*qSVT6Jt@TGNNyBdX9S&n8;)AhyV
zFt)v}V^b-X^&ppaDxH{YJ^R%2L#kV$=WLz?#G|VPhf@5Es&E)iK+*jI;i+M}H))3X
zMAPf+2j7qJ7?p-E&-B0sJ(i61R$6l`6F4|H>W8Zj=cM1M(JQ=k1DyL|z6Jx;Me~&z
zhA~i5Hk)2YO90*wz%nK-XCA`Iz^|N>b}fxCeUr9bk2^y1v{0VE`@;={jyuk{j
zGBK2~(you#3WkiTW51zqe+czh_%1uuvm~^%jZgXraz@b_#Ik}143_s^{Q<%s_m)>H
z0vK8XJ04(OV{IxJ^Uo^p9SrRk?K%?>hFK3#pqO}TuDk>#iQEFf5(XR^Vg?F{z`_P%
zYYB!Up!tF)PD)JF$l4juF9Y&XdSH|0;B=9Y>B5J5z0bb{0jrgU$!v1m@>XjseF@1QW;n`{hjT
zoc&8XvIiMXTZs$eLZACY6H?FU$^9(QL!!Q9?so_WZ*`KH-)0rscR~#Sd%=M?18ZUr
zo@YS?&KMUBatG&wZ0O5%FxO)@
ze#lpXHYt~NHAY}!RUECtXo;YRDrazXPQsh_N%lczz%5@$ATzhiPQ3H+a(i(Sf^c|SuF{B`0p<`gq`Zds
zU}Zgh8MuN#e&g~R;8c_*?^7#S`tgFHH%cBJBabHX)IZq-M4My8RlxBHC(!;=^T*rw
zTZ#7)w0jz#*FGHs?VfsWuCL|qQFODQ4P>yO|Lnq9uZ=g$fLF4yh&f&%gT+Kv+|9lD
zyGMF4$a>@^pxsXvH4rsJ^
z=&&KX-U=8Jk9Yj_Z9W_B5)FI&UCeR5>~+IpI^FWVtgIpau*m#7p|S?4Xi+O30LciE
zmdt5t3^E8BMKeSzejm~o|3d}Y2~LW@F4+8#DHGn@=a;3DS+{8eyWWr?7;^F#C<;!i!UW<^}4f1<(tDmYqdx`1_X7(P}H
zP=aA80w4x*fC?B?I1_%>)O
z1S&KjMePUgfW+ZeU1(CH?N-+(f-Iq5WD$h?W6(hwOrp;71BgWEh>US3;@H=m=BBqV
z>EeYI;n|)mGhzwc^UtDm*1Kq!yXs22?+I@9119RNBFDENLilAb5VKq429bnMKPW0q
zD86on{2_3S_6+cjk&}TCcggwxgYJR7kn4Y1G5(KRG5#+RCM{+dY|?@%fP7!?O-eUf$9@CPogGlg7AO9Zq0TBYTY}YHcx6(k3
zHKbr@@E2naDBF$s9M->;qJCf$)DWqx(YLGc5HtVPsZ?;zi(=7YJ?<%!Tz5=UtmOI3
z@?w39hSThT>x=hDw`lYO1t2Da*(Q_>-$)JNEvHIyj5~A~5g@%LIgS~aO}4yQ1ZY3z
z=|NnQ!ppl~FUmb2lz|{)sw4FSXqHt2Jh9*u-0I(?394tJ+g(seh@=-Nu7A!z
zPi4JjQVn5rC1}>Gqz-iZ@|xoi30z576Czi^+0eymq0Rz`p2RyjY6``F%!D4ZUe}m>wFEhbGQ$Y^?O7bBlExl=
z&91`RmrJto>CAF|^8O4pS{2GF(r%5te9JQVz8m
z#oU$wVFAoV>lCAi1*#v8lezm|-iPfb)u#B6)N`q-2!YIZY~^+Xhp%rwM9&pij}9nu
z>Kuq0@dpQ80Ms|seW@#Yh--B^tr^fn-#_YK4Gm;^%L_6x&KkX^)L5r87krtk40C8B
zeq`)VPoWOY^nO)8`4-@`uWCL9J?)p(*fOhJY~q<@EzBB(GHx!nwa>n0l8NSt#a2G<
zO20GCYCE4m0H^%vgO05mUFgPO=!gU8m_e||$FzSfA1>}ZG+rB04N)6;?)*AI=RNHe
z#L{OVZf|7sqj05{S#@%YP=OUnnS4fxE$j1vd9Iz}YQU~JH*RkcxZIapn=IY{hUHsu
zrkzTK=ZI}|!6O=>J8dZNU$VG8iqHFQ?#z
zVK1$KzX%WK5|T*AL8ZE}&Wf5TBMhfq2<2`d82YE_touvqI7+a*JJRZ?txp27K`ikK
z*1_G3XdI%B<^X4=2?`i=h5Mhi+>+LWJOa0B)8{fr=py)upo1=Mk#c3NVR57F3b({|zv+ET}OHa=dnF?QLW
z#%3Ra#MTciXPDknmi#Fs-=>!(04wz&1K{wM`V|9%tfwtAaJ0dPBo_^JZmbwg&U3>p
z>ax&)ZwGio6gXtGBlf9L)&u`=UM()oLc6@@t(sl%=pw+^ae68tgG_dwmxcWrISgUu
zV|c7_FzEsPdVzv|TXij5-4fdH>`5D%Vs0;=lC8D(S7%2-o?t0egua@0Xas&lUn9td
z1jiIH4a+I;xAZV2G*6??c(qB((MwRuJ
zdfa<9#eQ8XN^{L=qWl5?A;h=<$HQw4sVO_?e@L9%
zp8V*RWLP3KK8gpG`q8IU7lB*idN*|Gi~f6GKo6esm@NbKIbA2^vRffkqbc#nw!N6+
z2geV7F4h>h{`|<>2GlZYrnhQ!OBI1VY_L=^kG6#O;_T0-8&}*tbo8MB9w!mTqp4jB
zm}ikm^gg{+lRS8dp^eDIME
zIeRwnt2dMb&W`h5Pd0-q2`*KuKr7-9yR3~2PaPaTSCj=MlPv_3h
z&y$hLNy=~4T2@#346<))gHv$b@1*#lK!KiXr;}u^o$e=7!d!n*tM4-CKbeTFa!GsJ
zNG)+sYy?q2p`;pX+x29+4sjp5!wuJ}R^{WuE8Ky1m)&)Li@GxS>pjCUEi@f~?8vNOdNOHzFfMPw{uRyRE65
z7QQEO2+WGnB^X3@U4P~!6Jnotr#0TaAemAehSioU-ZrtB8&LjH5EtCJ_`QT}aMs6z
zD(PxjSBYuOq2$>hH~GxT`if=PtIN{Y%5OW~fiOq3mv1
zvKZC0?-4vS}vJ=^|(*!_6uPH6B^UZfW
zDED|>@&7Gi`cGY{00{6AC0AAeEZaU_+#m!-s{QFBl7A2+UuS<5^|`LG{PU%#fN$$}_Mrz!8OqLMQTIc-?a{n8kH6nr{WVni
zbY{N)D$s^}R}AXwE*BC2gZiLd97eh5@V`
zyl3}cR)LD5vfnWr&d%{1tn7zrVJuFT&n0)y2?+GHp8V$9{F(kiYs#N0^^uwq6^%#e
zAjB!2JS@{`7%@B?35T9}Lw}Wh<53yfuL=gv+Z@BA@|&|$=cRpNC-aTai4gVVJEJ&QraZPuwN$!S4cljbnp{*Sgn#`bu11@?=BY+ocA$>bK@C2>%sge67RQkj
zM|v8mSM&oi6-~OpTEFNS`;3%V{iQwrN@fs|`JgtV$*kiC03XDN?iQL^JEEHMsMqyt
zl8VST8A`tzZ}VfxUmeaX48zPXVFh~0jChP?xR|h-w=Bbcs~!gFFo`r++wE}z;D4)i
z$L!fuRmX~66L0^vtl+g6HRv_itU}@|ID=6005bMdhLc4P56iNHg_}G}Jd!a;-BxiA
zk5ksJ&EfVR7D-6?Uj)1Y&tZ{^k0(nR0%ELtvwz}eYk9ufEk$fBnT=4gB`{)z%Qb21
z5DPHd^jYwZ6e;OgRn$ww0kxZz7*{dkSr$2`g@KJGR~xR!N$v?S6wF&z
z9i3W7%d&@S*yDV4F_#_eVneY3^7oO*VyO#$e(EPnr#&lMw*qebB0iYLOH>*3%lHM#
zZ;|jHgBg7DuYW#2drUtS`RtQV91S)efTS23}@7H5if{oF&!Z0M+i>GTf0{EEg5Q#mAtx`CnOOQm2EDNu^=XyH<>t?u4L8{=4jmF&R>m|dOA+i8RiB*z}MQN
zt=A*)oYv}>e9@&_Lz6`DiaK&W)Zv>7P|j)?(hS?
z$cXoyeUZ^yDnbpG1Rw2RZtH`^3-L$A=Z9i?C>63x@sBeCWCUjcP_VY@Q@rFHFi|eoJ}MC}@Ve9W<(}%hv|YHi&EK=-
z==I^>er3)*@8oEf!D_zQ0vUALc*PDWM8Tru4NHh;Yx8?ZK^Csc6Lux1
zk!!fb>AFe^5j^hA$Hm1{myxdBlR-`|@P07#u7rKT%gGc$7_@Qs5OAM!WN
zqT6j>Z-o4lg5S;`E86vbeU=~;HwegM3FsUn5!Trma)@}DrTb1yRT`)C4+$(Kh3R1#
zpLEboc|3qxjj~9IvM%A=4_owEaq2wf7U#jgd+20DD_TAat@@qP_eEhYO
zXPxXn0pXYbueJD(*=52-O4Q@PO+BOkEIx?J1f}FLxkiNVd3>Z5=`uzIKipypleY=b
zoU|DY_J-whhWx8O#;J74S52-%{8G+e3?M%f7|v4ERYep(O_rFWF5lg>#k1>E@(NuG
z3N`^*@;16pClgir68yTgJA%v_J8LyvGQy?*?bLyvLH_>nupN}o;vZ?isq=AGTK6mX
z0yXvwCX
z7k)9eIRcaFC+KygHeN0Nd;K^|gGJ+9+k7rOh6Dcg7+b-fI@p^|*EFG;KhI1k^j60vJbzwPnmnC`u}P)U<^OQXG0RD;8Vu?
z!&L!C4hudTSi)8u|7ObM+~618utx70Uw}ts{BBwUKNhgV!BYlcZ)5z+zWwKO!Hpg>
ze9bX`klK5#0AF+p=^DacQ43JuLk!ERP5C$X6bQpFHlbKN;1Pgn#{0uP3%8D_@TU|H
zKSloU=ls8>IsjiBT*c@7;z~^qpK|)4?^$n=#u35&6P?4eivQ-GaSHgw1;m<%h|k~=
zBR-MXq<}4g1b<2@DbJw)VY2@@B=M(I;ObLiwI)bBe9Gg^{-`h`YzKh*w~fsAzW$qg
zwqxKI_aDzbNWoX8RBcq9A~+im;7^H7(<1S|&WV3mFsdi;HT5Lwo4%Ype9GmkKNaBz
zoQi+g?iFzyPorNCPKZ^A#r(G~=?&62ZUC0yg8@7A`X#gBRaeb!o9p}k$1?9dqgAA2
z?;+QsIW+k94*|A@CQ|G5nmM!96%yE7fBa|n|L5jbCMX3OP0Spw&7*)#C>^!{4iOMb)|5zq?1g
z&*cp4+W-3_|36O`6-n;z#{lrwwnT2<_hO1MGAOauUuDjiBsFGga+*YQdVpUwYhi4A34)Ak`sX`d)e6&abIe+@?b8ek~yu
zlz?BnZSkbop0qL1%htiinyD~?Hb30Y0oF>}7kB-*)>YsfCiFZvWW!@ThtqOcj`tOk
zz5^0~)!J5mEc5s|{+cN$Gq)Ak%*}E;e2kePzs8y5XlqvI=Kd~Uq!L6=o3AKgKvKW-
z0=kbuPj)es@jMymoJifCe2HXF;J3M!ul-cJ7ET)zo`G?ElY7wipm}|6!=T?}HlSmk
zl>*~B_u6V5flZoJ8jryUCl6eV%D|5#$khf1XN&fSsT5!(#b05|F*;Jb4hfk8
z>F+d@#!f6Tz3$i%t~FH$18jAZ(^A7WrDS%W_i%p;nvQ3)dVW4SCmmV0X*EF@8%l&s34GZ^YROqL+yp%myOgo-7RvfxWK6py>IK|_n8+1Nc#r>?e)N(@r^i-iWc4BW{
zXqCkcOoo^y&^UZ!;$T)GqwgeTv+&8Y;yvI?CxY58RJw^RZMKn6QDr{vT15~ZXd|D$s!DPB|1t7lJsH;j9LtFm`K54&q11b29J{8prUpu
zlvSr1|HW0#rWZqRwa|~$+GwO#2Hh^$6CTTT(_}zvt%&-NB~NK=fi#J`t8X;|38D{
zU-4+We2ksu^I0bb#0CAmzYJ5wj$ih?
zc|fe9z8etWj-d7XL|$SO1A#nNv{9Rzr-?9vB3^o&Ia^dMlV2f}@BQfY>nV#x?iklS
z*KU%{w6nilJ-70g^&~u@11rB0)<3h{Q&*eW@Gix0YDwJj4hnaa2z0(Gs@U%vF<|-Q
z;I;j=Ncr_>jiuGs*CD$3ugljwjXVlPwQ!h-fiFh%Ozf@}oS68u2-4DJZAaaT+}7Hg
zayla1k4>};z4nwDjFZMsO$Q45g3+)@poHQ3GSRbSY{t$y3+XTmn9HuV?E9K6X5|dm
z0rhk&=8G=8AM06ei;0*N$OBV`2MM7VEE!K)rVz4!iIA)YAu9`{MX|o`i9N8YxyknR
zthStBF3MzQ(>>?*t4~YWx}hGabl!gVH*4QZJ5!RM+Pu;Q=9y55G8623`%Nu!?YH{K
zpsCO7<2Y32keZH6!PtSE2k+Nwlx@*-T82LCX=xf?9adEsoOoGad3s2bpy&yRu_VVG
z=ySoWJ|@P!&I~;FAXm-nhsbg*%}+h^HTG2%C(VVi;zi%=>(#ht`ots<{mAl0}
zhd5drM6~=$Y7j0Z?>E;5dE12VFY%%$+1nAh_8I1KM8av(%=VR?A9jf#DWTE(y>?u{WC}tZi-a{27%WLd
z?Dx~~D0VYv=|!!TKti6Ra4(VJ?bK;NJ3@qyPtlYwhU-Um6pqH
zW8r2+uIF75KTIwU+0Ety&LpvvxziKJya}JV?M{EFiakOr1O2c}x{=4_&#!#zHtwlz
z8&Lcnp_qq+W>kPiO(CaSV{c?)^yu8?kHov`1Fx6odwI@*y)X)2c#K$>elJ^{m2`#b
zDeK$ka_iY0l?Rjur2ye70d31)(B{jF$Ad=$p9y{_=7_G+;F2V}cN7j5RhyfWwPkV|
zeXX%{Qe7s;JB@L-D4X!@-MTudC(dy&sH+O~A5CQb5q*l3e#ZCdHx7T7>ocx4Za*$9
zrw|*r8ffPNW}uy%Of<=aVt0&wwxY~{a@k0hux3?tQ~zKZnKz<~cN@P=e;f{NW4bSA
z>>`k*JJ}Q5E>Nd6Mi%kfOfAtYt+QUZ{sxXUrW9K-3C-^i+mFd%IYX
zGTEn%cde>}Vwt+5KwwS~NE;6c@V(FI7-novF)uX`(PB_0#om4%fIK_Y)G@fke|UT{
zA|^BFFd`Bi#Tu101w4q|@WnQt&FM;?K~jG^mUcdc2O_rF7pku+yS;NVQyU^^D^_Q)
zJ@-9w-`C#c`zGvOx?T^9-K))D2O-@yTX)ol96VkkY$e-w!5kSJ-e(6C-XyjBM(I{)
ziP5*faLuv5$p@8AQn8fzgUy-Y{GX*48A&EBj3$Y$^z*MuJGIeoN~3kcbmY6G4D-2s
z_q3fE4E>p5ICMHxQfWOw8@Jk<@wsQSpiS0#S`hJtFHE_0L0aU#R7EI4+}jxBkaUIx
zHxXu9Zff+4{!Be3Pz~O8CGetG51GbEKGIv
zN>7KBi;SMuP8o30(PkLecRh-%ae*bLJs~G^d3I)9juCc#a`^24uS&tyIz=p?YqHJSZ=72vRw5+75%>WNOcXjpDPG6zHo3LEINQ~SZfu-0CJmA$C9`YPSo-)mmNWK{rE14GDN
zeyf3v%HQ5|XeBmBU5d9sfo)MqX`zsVN}eZ+S!`wcZFH1Tdn@yyV#cy4iyq`26RL-W
z#8#XvCM4PI;~o!t;DE>Ct)d^>NX>OiWOh;rz~l|-E!YV~r@2=3yLKu&lI(Wh9CiWw
zDWDh$_2&r8vA-u6zIhP?`wfs>Mh7VPK1DdgG?$P#GBfN2ptcd@`^L9TBOBoiAx?iZ
z1bTtLyAJ$a{^`aZ6W4PDoqF41YW&QAcY!5H>BR*dhVxP}IexfOdKDjj92$suP|g*O
zh%J$Q5{;M?>+WCc!y>cTHsmE+&Z)!}#tuVbnV(v2=lQCVwGnrO9jbScj-vfs>W1N$
zLfOrbmp9(G7=PZH5$6$+Q=AAIglYpVUb2ep?P-Vb@|MU6ne42is~!{W{3oRxTkm}*
zEp9IS)|)VmDOT$F8Gfd-TJefGQVf>t@o)>J(S_y;J~SPi_wc4n3oaaF_#OR9AxhQb
z7(Bv~@jc0NdQMPtPDA{B0KSQudtG$18XVV4UhyEFP+RF|d?2Xl{`=UK0)CQYJT;j7
z;hPcb1BgZCY7PnAKF-(0HvC;>jzySm18;9UNZn?Mrs9!@7R
zlw|hvtUF+!4(iK`OKJ=`$**vuH2#Csn~q@bzEMys|;_qK)K
zRud8bIKgWy@nHOGs|RKVvSQuqUI^D|N?RrlSIXYSFCs(BH9_mTZ!PV(iY6X!r9bdo
z7b)v9lIL#Ix#uTk98*@6Q^oiF_C08MAm$Fek1Iv;_~}Rce5~z(SCR_&!@i(dU|C;d
zC}-pK&gZyY7cvV6EEKt7fG_G@`8Bsz(HX<}=P8!xv=B`>Jiln%35pgNdB{hf2cO>e
zzRukIf_Q&ES588+_a(B7^Zu#CLbZ8e-*?%bEJX8}-{UG(*nL1XjM)T*tjof^BJYtd
zf(o`d3fBF{aDqTF>=lEQGb8RR(7E7181E&|z>$j_+35kB1m0TpJ01YIpECKpQjXoq
zV;;jfV+tuuVp#%20Tw7u@X~WXY^LH5y~gH*8GE#?$XD0%PO5#WTmz1#rIInoXYDb<
zRkvgU`yX~6Z(Ls7UKu0W5N%LIt!nq3fuOqew#w%B;@GNpmU0W;7
znWjC62S(Y
zmL2!14J66hO4nsInXz4rQJK^NRhPvf^f{Xjw@y{nHOY2eED~K~w6^@A2$iLuMBlnTMje$>Yol>>PFE&j0lhKQEa*NT
z7SI)K{kBB6+1M_>toz_L7yKRLg~Oq#ce*I{=>BYNb|Q;gOWNi)mB&t#=lv)UD1IOUL{+R3x#EWI}CPV}hBqKZ>m@P3c<@6P~3
znj2JH{7VKk97THC6UWqA7V~*dEhp$YS(cN%(cg`8tqqqA&q)kA{z^uw+}~vjcN-5A
z0%WOZ)v;B+?e#$}p-n>5g3p$psrzCtVO3L3h|C=R8cIm)vi9%KlV^V4Ch
zWmNMnv|xu?Q1fKoKy3ZDsL9^`@ghqE%GUd2p^v7$-4a%Tir%qC;I
zLO3sjOEV8WJ+QBq>kyIVJ`;@e3U2C|+?!PYYQa2pxn^C1>Nh8BTLm<)Go%PuAkN&s4=q`3Lzp-18O9s^(F4#A$?xeMuKVc?m(01$F!
zPH2p4*>m|V>9VE>McwtlXJf@h*%XZn%YW(6=bcdeiaJo_u@Fpj(eP4Xvk(SE-7SB%g=gy9QXQ@r1Wy0*}{%W}h?Gom90bK8Ub((G)5w-m|Ps|$lz
z-mAr&A1Lh~lBqs{if*|F)m8@56_K*j!j%B3?e)m*+F5Q_+a7
zApZBl+u;{z@eB&@$bLC~^Y~Ie)=|Q7IConzc8J&JqFqzVb)cBc_a3-BnlV*oEqnZQ
z$WG5GcQfa9FGd+m8a92b5E3vBa;O+9sMuJ06;$K*R9QTiw
z6Xb-`){Sg9|FG}m3#ReUWH{r+^zw%P}X(w>e5@!-{22TM0%vR3z$GQ*@!G`N8Vu(hQ
zy6{dn5_L2qS|-USTxXP6Az-ok#wmr%WL_p+A;-aN9cgF3WDWZ9o7!4F3*^=0m@(`7
z{XGdMF3>+%uf@|K7~dgfNXQ{trmSg>@L4C9vFC2^+fq
zHDo8m5F4se`>37f1wuOC58HywZ|@yGkReDMl?Yyimwl~`xZf}V{68N)SHaaI@uRP3S5_0jn64H
z=LnZ1LI)!C+(wp+`dk#QjtIWvSZ@ePtWB0$ZLl~kSW%*0GyHm8CR^Qiy4|THj{GI8
z3!#1_46Q>(m~KKatYI^BrB01C4HnTVgI?YGlMuvH(z;<+rO^u~^nZ9F8f7A7%5<%Z
zP44#Ug94mdt7peV4s^+o;$Q|#L$~p;5Rv=4bJ}6Qq9vorvM2OY=$|vZRR0Rp&z!Np
z^?OGSmWM&Z^cB932d)vwGHqU1;?Ym}h6f6QOyNGnCC@QuyRg+s7lHaN;gl-RUL+!<%&%+>+*?)_mw$+`Z
zeRsmR-OE1b+*E6dA?mZcznYhx0E(h+L&Ms59~i5+!zJ
z9YfQMM?cb|v(5^yxa2ZBrRnygG`)eo{xhH~@P{{T4@lad(oK~<#6eZ~?WSFuhhfbhW84ojB+e_4oH4UBgA_({b
zM|^zge7{rxcOztSnR;ECjwFkcj~x`6_Yi)#z(hSTiRpvPyQBUx@Q@#On1yI(*>L|A
z499%i*)QE-^f#L^Tbu2m`J`~Hr#6^L2co5~!Te>fhrw%myqMe9+feXi@B||u?03W;
z!WlJ->Yg;bfKIVZt-Xdk&szt2J>2=k-2usZA1_6V5K8nUby5
zw~e+~)GoML7Cv~`9|E=)8ziLirXqLIgig+n$M?@*JcpNP)RSrbnuhEkjFR-@JoW;HR>
zczo<*K8?x>!#nmxppnCs$i{g`onLG|!Vvd82qg8EZjpV=y)IeC@sTL0JkUtr%!n6?
zwo}QaaAxqCdwj>knhlP9bLP)qu3klF;ja5S;(IW)q**$v%H|c)uyWDV#>cL3_5e{U
z0Y{5r$wMQudb()CrH&Qz>Qo?|60LW=Xb@a05}fSN@%ZOz_Zh~nWDP5nvkpBdVW{MV
z;k{7WONXQ*tMUQm<1bGXLP@H~k-SGwHrtMV?CxH57Y+)@J@I)EY0ut(Zj|4el%4G6
zx@n`KZzPW8rzil+;*B+QcA_q9Xz$KCBEAvcN)>rDDmkS52VI*>g^fKE?I)BFyJ&u@
zNLBr>zt~11=iWIjdb4vsiJM6Vt*{w~u-otAiNRirCvmWv=ubpmDu|>riN>3Z%%v`ilZccJ
zIPoOiZcOY!e&Zh5iBcx@N|^9tn6BAewK9aa#fLx;xPB@iRajnc0P2-DOHdWlT
zs$^__$>cl3)j7uVMQLq2>Y|>DEEl!W`hMu}U%#+1Oe}@aWkKIG*!~&A1!2!6qt1tp
zV1l?KF-H>tr#h4+1q3!aX{1tp{;mr3xaeIumsXU)vfS4`P0V%AkO1dw&&<&^$3tDxv3)Qv__g~ep&sS%A(iA
zsB+yvTOwV+T3Z^B7<|iiVHSHq_6)S$ii#v?_*Kk%Mnz);|`wa>`N{IFUkxVNX}^1M4KiZho;Pi8C`uC3sQqYLF^px8qI$s2le|%~Z6&Bxgo|s82ds
zi}8hY_tqC_T?{mW(9B9574ib}@=%O95*<=h4moRcNPw61I>=%gukHL`k?)DYO6}AI
zt@{qP*$qe%=281>`N%u1g{Xp?5A9LjbVM)j-oXvo|
zb-VRYbrBI~XG-9OA}S%2J|^?>NRKm9L|B+;W;+F=)%WhH6DQT<=iw<8tL$QFux8q4
zD#ISpKjW6Da}64YEZh>%(6}Pn-abK$+iGQ%w?GuKjkes!;^~2SkZe$#=PG4e(KmtY
zrH$qEAp=jF{gzn`V#jVC)WGL&+PhBd-jA)d4enQB7hFp?FQ0xAXv0bu9))gFsUv*b
zKQbR_ng+!*+I(s3p@{0C2Dez0n>`_bT@(3XWI;50N$wu~PG!`n(sdrk-)!H-!1np^
zi7JB8V8CUxR!B^>@;sTD=uvu)^&BfT@-~qPV)#$(a0*PA@$iR5*KEX(OEy!FZY~Z^
zC~NP*E`(WIqjc((Z)ZF8`bf|(Bd7GRWe6G4Ybck*UVNNCaiEzF=Wo7T
zapf@#B6({#<~)t(65T!hth!a)c0|4`Og|q`z@>q5%qkS~$NSp4gW1&JNMK~R$}3|o
z;@_Iwb=0p%@eD_hH&dR9M47UqRU33_Evz*zc_!FttHt=0yG|eN>1l=NG!Y8e+WJLL
z3dASMIaWIQ^SAe(i=^wz8`v|>Hi+Q^WM4SMbta=v*593?K`LH1~=lk1A
znU7B#lLlq@xlDu{RY$VPxwU%SjQH#piAen3<9T%FJ4%X}53PvEAL=|cEr$3R9&69-tMfhc)_J;T?
zg^vp)Ni|PC=DQszIiWIjsk*veph7WcCcdc=NcMWM(d^L>+PKJthM+S(#bviX?^80D
z9F|E@ezu1~b}0V(t8ovtOe_d%8LAVN8R}LY;~Q@UJi8!5$u<7o)QIVWpgl$20dz8PAhAPrqnuElZF7~4btG5PxE=+rYp|K4oE2j!tPy$j;+gqBr;)#
z3_L>jCid}>dyzp;{@YejZ-P)P%W+B-!L4N{=B%Kfn;S(SjMbTy)bEZwQk2VJC0gFJ|f0
zY-+qNe#l_%q#DPZVTcR)h>T5IRGZszTG36u0ePeEc-LoE1Sh1Wl3@}X_NL`7#3nUM
zv#AHKxl6`UozkWNVIouyq}77NUzjgXLw}cf1+{8a4$>P=h3dr(Cj7s@Ou>;COvp5UeEh%8(xYJM+HF*I*|%nS3ToKJ{jMq
zgs@l2vgEiELRWSKuBLx6Eu-|L*ZbX4LxjKfS;te!6u;DlI!fFderbCaE#BhE2C{yd
z9eHlnn$%C7Gebhl_4a+8ERqP=rrqw@EzZsqhs!&hqj^!;
zNf31SKUP-`ZH}p4sgYZBGp6l+ipvjj5v{y7v&!skx2jKU=|)@q5Ri8m5w<5%(!{SE7uJ#+1kUgI9A@tQQeBN
zR+sZPE7ZVSbYG=cpM7@qMQernC&^RB%r^=^zQkw{B~u0#ogyW(a%Q0WP7jqT$p00=
zz4=#HrjvttkJLD;{Bh~>6=|wo8H=M>l8J$LBzkTOLk>12Wn(K(i$npi))NU5{5RM9
z0;=dsF)?^nAOLlx0?vw~h&0BJ1%SJJ44!nNy?<8r-{3Cs;iEvo59os9IlF2i>lA>O
z^BRt;M1`CZ{<|9j3S_}o3k351?~nZ7>H7b$y51fp!)2_0Xu5&iPb}z*_vdu?FF+Zp
zzOQLe2Xe`XeSID(Dxz04_)@Q%5?N6}6Yu9$Mv^hlDCbqq4<6pWuiaq-8Y0Tc8&<*;
zs33ov_KalQfZtY+**x2$Y%uMlA=7LB7jx`bdk~80aHblN#-jk34`|{+xogET>Q=Ls
z{WJ6%w4<7_?;1`(IFM!ic%Ynp*9>+-5KsfBT-5NlxrzqB_fbG}zA}K!2W+9@BSY_j
z5ED=VC@s(|Ej+Go)6aRsaCtnS3JRLAwYG=5>1zG4-i_cLxyNJ)Olv}Pa{z_Y2dXYe
zE8D5Y_jG(#qD(qEck2Kb!}@_^_2dN5N(O)kFq_TX`M}9fN)b|^rv1ZYdz=EOy=bjp
zdl^Lqsfu37!KovF#U5w7Ak$qG6mp1P?x5Lt%ItWtfB}$Z25&)Jz}0q^W}Xc(8~Q!~
zkc76rbG0y3%f;p}poJ?1`XI8S6NwU}=lJOj*ka~hx~Hf7U=;+`z7?Kdxz^r(brQmb@lAO
zVK^hFBl)=r3zc+eWuN;f`KIsQWVjD|IoN1NVX-J>bWJBVEK#bGahZV@HFTgl%kPwL
z0Jps_;RWB94Lj-t0fBHlx&+SeB^H2atfYQJymk$|Lh3V^Ry@E-GWp!7u-3JDw15~<
z@*5oj6q7kQ&LPA5bWGSo$>sKlG2MC+5Pb@@?@(wsSzrcNrxPNeKl%Bq0()M^7S8T=
z^PD|CI=iG7ZpiWfAYV-sVI{aN-PK1CbBVp)_=PvR&}0|~B00sIb3`D`KpH12OJ@F6
zA&U-pGf~VuSO~b>x0OA~{g+3Ag%5hzvDnEVMH`u>$B1|zEnx5&0)wYBqR3~Y6%t=6
zAY*1GqZdBhZW_kNscAI245*MgiVzy+RYMjg3NZj=wy+-r>Gg6CAd_8cE!ec+e2dNA=?KY5x-XB9tO*?FQFtvSg%I8r$lTWf%wD4
zSEJ4sX2Z?~KZ4CK^UC8dV5nsoXTuM|6|Y~0Y;*_
zQL8MI78I}F13%ZgDh#wdaFR@1F$Yv8E7WtbhpXU^LI2=<&DNK*0i-EpcUPL>WZXlV
zb}G_~TwCY)tgd$J{-*4{19Cur+fXVOXhWFIs-<^?mBwdf{Gq$yS0mH)$GKaQTNNgR}6{|9DahGuljK(27M&MhU0*M`pi4C=Hq_$?Wyu40DQK^
z^Z%xnZ!2M-pS#4Z$Q17R^CUo1*@FgBJc@l*CMLHuc3q-yJNq
z)n@wn>X2}o6ee;Q=DlG-e=2lYz(4-q{0~-sjg$1a7GR)(u#7KWQ>`aW>R;wa9UJzNlBO^4kGAO
z@a1$Ti5i~HoY{>Fn5{oRA`z@=8asDQD2C91T0R7zP}AGY&D~P6MSA+bsV&fqSj^UB
z^o3W?Bs|GA}LRE}dC)Hw2h)k+~9&}7#)vYfRn5n|1
zgxF%s_a_i6c#aDK7!vF#iQX(}Mn#|^vHYinbI-!R(!Cw#CTY5;Ur2TqA@M8Yc+RL3kKbQcj
zJu-^4mTsy$XEQ;+5nwR!GXMHs3xSkw@%uATkL&HB?y?UX)*J_2=ZUZrUGAUr7r~XK
zHcd8RNz_;8b9deMfHD~FJQAxnGV+p2l3+U#U`9!b$*+6;1U~&{hL~eW&s((OF)rV)ZpMewcu0P5&
zd&DPSmLnN3C1t&PuLAvU^Q)+jK_3dQ5eMYLX%yxZ%ZbVKXNy#RRci|)Vh_X~e?%^L
zxvMxeSGG?lMq)D2{mVIBL4y+p(0G=!b%=ZvdcsLPalQ0#UqrI>YGlEnNbg-=d=Kdt
zkG~xefLV<`)Ra}F2DB$EvQ?9LMOV5ZT!g%ae`66*%;bZRZIpF86#PLDHEit!W9iii
zK4L@XCdMd7@*4eIOy&(M?8_K5m54!fDw4~GQha70VLaabJ!IHx99yWn^}yj
zLEZ5agp?&Jk#<260HTabG4K>xnHrq(Hb?sqa^)IKGPm!F{XvS*3N#JocHKSJbF>3T
z;QoANeAa@7+3-Ask$5{(H{WL|bBVIm4rKMXoHPJ&z!Wwq`_<=0!c3)xNaOLlfdwG+
zVzz%oT0S=Uq=&+-nN#$i$V*b|D`YtG67Nz3j=bbIiTPmg@@5x(AqU#)cT)1_$7X+l
zJR;2q&8T>jhZZqem(anCTMWfqPYKWE`It=iHaugWUx5Xt9?EMKSrzetr|!R%GeKFO!K{iVyP_n3OKnMo_`<*ERj2@Qfl
z?x`heDI(VC7n_+*0Yw189)B6PKo@_u?u*s#4@khzj<%)8z2aahEh`r1L2{-Om=ZCC
zEMMD`r)%4U_iCz5#=h7%PU>vR%5l`R&V)O~{Y51NKb{b#ZJHm=&NouAclt?HM#g-5
z%(wq)nyT
zY&}vPM*}L$m}&s!2QWGlaD-@QLb1KivuK)QK=Aq}Ou(GFi{H?Vyzb
z2*K&4fpjX?WBCoS_r1gD+_k=UtcH#h&kH$B#)LQ&gO^p4Z~uXX?0!VY?RyHud@_!<
znge@X_G`N&WMmkfs4O93AnARN%KT}GK&p&qWBvqb?dkOns24TT5m}NkGi-6R?9(M
z27oUljFWzb2`}TbK<{U*IEYs=1Q$FcC|5S+)~3y`uYP|`xnH=LlS#hbUno~-@l1Ng
zrGlM=UWHdoz#hIOcDFqOT~z%K;G+9qaZ7}c`$uMe%ZagQq^hRTj|Ahsx
zFwU@xYoU6FCWMW&H(A<>R`_y#ael4w&TgNK$4s6s7q+W6%|GrIi1$v;-qf4}0`RP)
zx`K#DAXyBdLsg|3RW3s*MK5dIK{oWDyyrLVe}8p*($XC|D1s%z+ox4VoBkWCiVHL}
zvA)JNL2OmyC&o8hr2VPz;inG<Mcx`a^#}6KD
zOv6JD*TGYw&*EzEfLtxNG*qxWTnE6FSO(Cs4Ogc)=qZaD5SWz)XTVtvP?{q^FqB6bICiX&lvflMAK
z2GH|VI|b{>W`FT}unc{3eSdQY+EVK$NGRm)fI79vNQBzk)hBF&=oi}P)yi`5p{h<
ze`Wq`UOBT_^_Z)-wg}29o~q
zMiji+-9`Q
z6wDJ5#+Sw{&%b>{&w#49`mT0U4C+~8kv?o>_!J(4U<1=ET0(3a(Tepuq~w%n^{3+d
zADo+S>bbOq9ba;bep*kiU~GT+y}E)U$tl8&R(I^*HX7q
zTV$d9m0;IFBj&e;7+I*kkABbbb^}&^K{Ae4oP>tw2!wP!H$J@D+*q2q;7o`4(vby|
zrgfO42oDrxc}^On!E7mvInthN9$<
z^xUDcbC(Ibc#g{Tic>Z4OtHzYZK~GT45oes{rf235&%f?#KKMTuUSq$%D=xjX_hk)
z6S4SDz~N@Gw!LV|&koRFSb#3o>*Sz@%_NiF8Wnk(Rr)s0KaR(E{2$wgN}UsqZj3I&V0h929?2}AP8?5hbo&l$OPyBGlN4Pv(*rf05%ZIUWrR~KQv(A8r84_Tmd5J
ze)nE+5hWkVufdt3Y){u^_o|a>FIH#|zu%^pzctQVW29b^CM;2HHO~u5vN$iN1X$gj
zcMw1Y21frUDlm>3o%EzG8nVcu`HB`eC2B~7ikCbB(^R4(PMR%(ZFbl*%Xl{W{)rf2
zBscmOOH1!;q3gCh*>~SdckT9?7U-I*KcWcolwS?n1XTcN%tjM(u}a9}CEW|VE6OnX
zsW=XRkBrbW|H#>fqb+Sa+|PJqpj(Rcn4Di+C)J6`=IK9xfI7GfD{_XK<-TLRo!fBj
zi6i(5zFa9*RYzJ00WtE?>$f0qWSxGEEbxo1MkTH)M0S{>Th>9ExWO?-E-<|q~$c`DZUFA
zyCFwamy<6tt80q>2b7QP@mlhez%AELXia@*?oo(j!~r#Q;XD8>DEYzO11BO8qMH7D
zskd3Y`}Gc0-?Ho=Bm&i_4i57-dj@b*#-ki^c+q|O>zN+&W&zMeO$*RlLzvrUmQ;NPkN18>0-*YIupJj-
z?P~%+SIrYko(pOoK>Az|CD@zWkS^0Tv`4Yr&83@2F7f0ocXD(^JLa?Xa~wgtbsMek
zjMa0CHMLsG5`I3yqiXLODl+{$R0-x4(kzjbdMu!zLRD)WW|6%W~gW}q@{a-Xda7cnf
z<4JG{9wfK~i6FtSI-&ggjx++be
zd#yRwlrhKnj?Wl41!~W6f?B#7BK^nl^*EO#ucLmSb=&%zRSw6bQ+G!H+APcYHs}}d
zh5qeudOc-M!hTJ2=6b^*UCW~152K!Nr#yvOof9hS1z@uh#!wy7-aS1JK1mTc#izY(
zU(40qt!Wh`o4E8miQ`uuXHxERL>HLyjq)I*in7<6eONCkSYxGO`SEN-;GBkF?>4cE
zMx3PBjC-sZom`XCr~C0FXRU0iui
z4UHrSO%()ij3#o&VGMz<
z&&B1}ler+YKd#ftJmne-1ZO)n+ux1)VoijXd{-fv6)Qh?W=;G90ibQz36JqH*E>iA
zz`TOoH>lPqqejQO+}|JH4r-Z3*7+9Z!37{}GuKxph%{MK~vL#F(zkjhQETab+(zIpBq)IdRe
z&;iL6irGlY<}vb~^QBkb{qq9o%ji3T+fpMfKbRgOPQZ}lEz3zJenzq3k+p)(YpyQzrUW4!=qz)i&}VE=tvsj`}Q)5sZ6az^S&^-WJ`j
z@7esc}+V`wg3K9oj=t?u7}WgM?n*#azx9nzm8eatv?5s7dTaex&p?X@tbl)7Ff
zrYog+FTEI!R(Y-WNO#4@QHI%zk|Rrg@xt*+*V|aXBX-9~y78Jo%JFtm7dNT?Va51^
zUwjID%=L;?a|=AR%rVso)%d|uoV}_=>f-~}~XZo6*F>{mEd2ouIk-~#IQX~amlmuI6>#jFc
zzJh6xn9gqU>fBDCP6dCjbyzETfj0C@cgPgf7|yT@!s2upDsK}E#!5DC8QkaC$*pg3
zIS5|Y6r)FJCnb0Q{EcrD{ERSvaW0B~352jOSWh7EIA(ldLbSe;^eyr@4_e2HHFI!L
z#J0n6SyMLKk@mSc)TH}jeZbVu56(!n?aVmA8(360^d=<++G0*bri67bCJEc6CVYyE
zFBmS;dzFc=5xw$gq7~tePQ{6d76v#9jWMpesu%hgk`#?d2#K$T|;
zWX(jo9oN7v4!ydxP38eMpi*|jAu+3x<0B;{NsyK)ZRUSR7wS{`*JC4I29!@i^Uh4r
zsWdCd=PZ@o-(XL6P0OmCOa{x8U-VuFT2t
z;#nDU;3}Ptp7md>!=)+JsNDZL^TZ_SE8CtilegygFDKb?X
zUsZ;wYxQAHfBdmJbkm?T^Va2iBZlFJuNmvTmjXY_sZKQCXZ{>s;QIz-OVnrS(^+`7
zMsC^pI}8fVtCr|AQ^@9X!tN^(FLHo$fr0i3w!t~7tbp55=Xz#mvZ^`$M{Y8ml}7^asZ*Z}uK(^mC&=P8
z6AC1mB^T}&%LB1T?~=14O{8qVjN=YIpgDhlzd3ePLvp@<5S6ak2C*W$g*k0#Dfs>@
zp(@(@Exf*w>fEy2xXqZ*?Z!ZE@uQgz(@y5;amlfP;!0z`V_Ct%OxuIU7&d{)x`xT;
ze4Pef=9}Wnpis_yh
z3VcUdVKNHm94$w|t-9WKfPd8mr!lQSvxLRL|A(T&=_`qLMudw)C%JE(vwwc=gg8QG
zK-_Xb-`5JE4{LYIUZ$i%4PCxM(|WpoAt>4Be8#h4I+N4*iyLk#GmgK3zk(|3K?GX8
z4Q?|z_qSr9v#B?u5&m=)=J}witZS$QzKe**9BVF
zAp8{p)4LUiwhP|TeP%)Lq&ZQRtpOj}VJ+c4I#)hF`T8kFFthl2yU7Z45=;j`^3(V-
zn0k&rUQ;&IWV>L>z%@Jba5>jx5bd>y(#z8Un4#7B)qAz~oYOv2})
zfpVKR7>%-D_#*#aX9F^J?Q-AEvUT
zb1pi;7!GmHLuje-x^~~1<{A~kypEt~e8-nF@^Z+Gj83ok14(_42eEEcpwUB`SGPFa
zxur&I&Ij`_^51AGku20K*6jTxu&hwS&7U~2@PR_
zY?z<_dPH7@hh)j$!K
z#<{+i(rQm~|ImveNi;gVpBk?ILTqV;eSw??9oPk08*&5hCNFtiEOovOp20Y%?H~}nR
z)v(U~xgR1lhDc}1Wai_7SMsX_NP-tI`7?TL-Gm)!TZ`37Bl=FLgzEh55|NHAXa>L9
z2#%PnT75I4!^`-_g9J*NCMI2Wslo!amA1UV@`^_ZMti4WuFG>INjSz$@>5OAUlRgw
zX<(Kt^b;1{YxCTc9ZgV0T7UiRFh7*rW!)io*ciuOl2b9MY6YyQGw#t<1tT>>u
zh1H&3IZHyS;W)AC-GXLW3SbT?QD|ByJ%Uz=gJkuCiQvzM&p<-{MNJO&y1x=K*b2Cux|T(1Ww@jWj=*Pw)6jR
z0K}^Ys@?CeY)2_v#&}lU=NcZb<-{ohgI`)2N0&MDoX8#R6czOq!o6MW4nR(dK{N72
zRKX2Oe))#4M=6eDyw*Q0C6Hq^?LcsL-D5kq>OQsb#7X4TOEL_hrM(-P2Wz*-2~VhA
zN{bvy4<<>bHR>KS4V~Z_s@2bD=b;gG=%Zhw2}U>MvRqlVY;MuOmw5^Ay_cyLQE%W&
z+1t*@8B9qC3qG(AM+qM7Re{*<{{s4n_QQh={mJhH<7wdAFip^y%~PZ;I5Ka`%xSOk
zKYV5@82(FB$31%oxD(c4N>;M~d@&pVSYq?_e_sM@rmAO&xfRH1n)7<2!{Q~NiLD(KC>eu7qs!SyK|)y~{~@K5$(
zlV|DkI^yLsU4=E<9gWFUdJJGs589<=+954zcU!~cQcCjjqL0d^Xmcl-DuC)
z%m^Jkm4=QhiAN2z`wkb-Bh_sG0{s26hh@;<4*`wIk}3`#d^m2zV#WmA3p@OgNB-xg
z|K~>@&AoaB^fAw!wzU{1wcbhsddrtYxNDzVY7uCD5(?f1%T$_Z=fZiR*aZKHz9uwl
zbFdP{Wh%_jOX;E2ab~|W;q>eKxc0CA()LJq)Vw82{EZIRj{hr&U!am*5>C#q6e;lC
z$id}#_lH)nKXMw$cud#X=cc)>*K?W#!OlEf@IkJ*cu}RsW|$-q1!<|7H;m!c{HJphbS5@R@*KZq;2f
ziZa4@H1B__)a~pX7tLbvj0f=(ohzdp&vEtQ+dv>?WHB&ml#zLTqa9qy=e=E%i?A&yL
z!M}iS6^Co*S!Rxfx5E5he-_*QD_jpH2vI5)lCSrF#Di6&e~E`T1t9wdV6X
zS|H1b1-i4Y)AR#4rHsEKRp|DF;Sy9K8LT9+luz7^4`XW)Dmif9Nauy?T>x26`1tqr
zz9kKCnMWi3EJ5YqdbhIKy5*O%almJz`v=*%E8^MeqN)y&lTPloLWkkS@lODDGR?>Z`ChnF*Hx=B3G
zp7x;L!b?RkpKi~YeaGyL&}6tkw)_rMT+evO4)^~}$@R5CeT?VfN~g}MfMFCrp+U1+
zslCILesJJ+<~%(0?;gGlZDap0Sa3*!mT9)fQ_Df!j6e?tCCc~%1t*uvm4td5-YuY(
z``qX3zv^qJ+vpqvEE5g6&%(Jd7_P|Z?({LV%1ouxXsh~PgtiH@)vMJ$WTWm-jUa^#
zK^Mmud6P$hX_CaczP{EAEj8pquA&u{M12vws<`AB{QQ;hy&M?mlPL3KXF(lp$k#w4
zQxj5zPBH^HM7$&wng(Iw+sGi`TihoASr=@tRzy#RzlGzSIba*$m`|3pR#^)|@D@6nsQ-F&fd8!l
z7nezs+vk9S3UWij*Bu>JA7X@OO=9j3d=}(}GYqi{uwyNnXTgt;eki8*X4U|i?ohu0e
zF$*qR2Y`b53Tz}FD{9VOB*S;#|
zK@i7e_>uTJ4ug=A)A$5$E`qe0SD;1ps=c7T#d7jVT>WU4q!KuMYi0~kaC&688dQru
z__)cg4ywFoQVT(lKz2t`zJmARavy`C=g%)&M{UR~s5IU;7cFn9x4n)4|K)Y6BLCV)
z^XZDumyL7Gx1b05x<1{4xmv&wH|&Mmg-N0fw6bu)?GM8!mKP)`C&pvnBptR3OxG*W
z_P$hIHSE|t;Y1l>aWb*KirLZiI;}S{QGG!Nh;7+)Ogq%suPsZPJw)PlnmMsJFx>*J
z1{T{Z6-;h`7S`?(*s5Huu;C@?EHp(EW{Sfp%ju;Gnlh`=4M;2Lm}H
z#*z5QAN4A;*q^vJyifWbuw`v!N6p8eQPzn)S8JI=X>RkaDL?GVI{`&!w}0gi^UOZ{?4pW`c}QEUNkLa19ym=fW3*Tltyk@?1ispt^lYG{`3E8!L!Huc;Z3L+`JGtooVOkQH(Ijn^93N1_ORe<`7gd|@q>5nIwXZAucr*~z<9HWBz
zGaxV_<3j_H^*#=Ao9R#
zSm}AWljCtd;sA(G5;sf=jo^ey=I1*0%_gQk$`(VSB@PQSMRQIVHdXpI-!IK&UJ`8e
zq`DfZ?A8*)^X4Kgx@tO?xNZl{KA06`MxC=^mrm_|7@T&CSX`O#B-EoQpLdZcS;WZU
zYbx39600t4IQ6A);N5!l7oI~L&ZFktHJuL}!<@X!mQ#JVgS{?U(~GILXC!@$8$!m{
zTy}b@Iexv~hMNljt~v0##dO%iM7U)+)CY#iwhP>3I9om*vNH9u>aA`FRGuplL|EPf
zg<6X}DTuQC*VxBb4=PyoC>Col9DBCM9gTnGAja_f@7|p4q4nAKQc!I-5?jlLy)4KA
zmE6UQygGP$`&k~3Nre--yhylZVAJB`h>9??OggZgGHzIy3A{`#Uuh~j0D9uLK<
z`wZbF?}VsXVddRN`OJ~?t5c@b0|Co7aDF?42Uws{*lf+3_)njMw`|XIPG7>0u`Vc~
zep;rZVRt*7xWmKa-i#a%w=kcX$g0>>&3q@1UlaN-ZrdCB@$Yj~)G53E)IO8NnkF*(
zJpAXsM`3u8&a|MEmah1ALn)Aqe*PP}O-i&w)aJ5pAlf=PVO-a0w$A_wZ3FewOM3&w
z08i?$3~w<`u@?W{Bo6r;fTg4r0ji`CVrhAAAaVntFlBKG#pH?^@++wV_k2ZMfK!N)
z$S^Di<&Ye6W#dwf&-W*3eEivi>!^47Uze0>@k;}AVPYW_-ofdPsU&?|ru(*v`P|jM
zP@U$lc>+SC?+x~T@nS2f*hQ&U_HjEWjk0l?5xRCuE|^b*NMa_TRxnuIpjBQv5t(`!
z)B9~BG1CkWNbwxezc6mm4mCtHcoBwvM8I#bqZ>_#P3DaLx}veq$unp`fpgMY52j?Y
zQZ+in*<}G#gcr+ZeNH`?Xg06j*i*N28TR}UT6M=$jc&)wL6NqK?tCB$*&$+^H}T{)
zBZnTJ?UB8Hj}{V;*YElY})>*WIZ*4?;*9NECZVZsgI{RQD6c1+WkF!y>
zxKQJD8ZyypD0&as!fP2`-k2TU2k7CE6pdQK_cw9hj_2WJqSo#94S!1sDomC73`C)j
zLzw)n+O7?#Cog*-XzN{xFYG|3>VW1Gy3XfJZ1fWrKq@2mzQE5oi|m#Pk5h-8vM=Zk54qmZ
z9%n7gtO3=hDWo39elTSj>^afdk*`c_8nDQxCgQYkJ2H)s{l4#8{#i_ZldtGF%<2}i
zQ{+EW)2x)?w*E<|)&4>M1+6-#FnTnH_uR&DK(`7g_3{f2o*5lKnmLew=QByvM%O5T
zbD<|bx_F5+ZAx>_(!yqvUnF7c$r(Z)9*dPxv<@9JFPqctpXB$&PudKdQj<_DAB2K&`jyMswv$
zepsM_D<)88CB~GvZGM%F8Sn%lSc~w=z6~9jAFSHjsT+26Y4j!3s}P^G>ByP|pa;th
zr)m{a`qVo9W=&7|JGzzBeU`QFG=><*-W;OBiAnieKXa{)0|Q?F=5Z__11rS6S9(B;HuOpnAl!8OI0K$S
zvFKcp3!Y%(@|@|(w|#mD^+)sJAUQzsfmGkJiVQlD`2wN`m4dSi$ZwSCjr7Mt>}f1I
z`0&zOM1$D$jD7{>)z*|@6xUh%LHepNG=yE9MO$FnXl$kv$NGW5bes`J95xwuh@{}+QtDK%Nq>r
zJ;c<6nF{uPAB@6rh=2AB(7v#oh)UMVx5x%EM}}`pSi}MC;cgE=g#FR5Sjm#|`=7Eg
zqJEk8Zz2eKYD!zKirl1`V`{N>b`9I)-Tn}?ngww7jtC7K8t0b`PN^V6qZc(p?2S}hxdNA
zpDfTid)C|2^v{bH79Oq)1cYNkM`7s8^WVqgYPuURh5q`Mwg#AKp`T`%~z
zv<^x5eKGd*A>z-kqmM0jW`ov3A!*b_IbCDAfIm
zuCKjNWS_@?jevSLNzV(O?fa|YRND=#@*+u%H|xU?tkZ)~Q2}_NCjm{}>kJs&*#w&y
zsezx0-=TztY6a)O`jV}AvSk>ie#CMb;ToH$@^%>j@v=f*c>+UOD*D~oAg}HZz*nS$
zOFC1DJ;XXhtxSwQ;)m$f;uOtwl^q7HI_T=GHhi{eqMyru?eXpjGx32N-*+z_vJ81P
zmQ1Fd`8(_*D6<_WXJ2$>sy@20d{P-cJ>i5KdInK_WY+^D%vH3jWxS_WXQ1$SWQZz9
zN*;i;y&&-f11@Y4*}T8icD`w5^QX9|06jj?)8+6bFZ~Wa!9od0Wv(Q9E2H7zCQI;#
zH#NeTw|sx$!!)}5H>uHwwaNF