R"h*ddlZddlZddlmZmZmZddlZddlZddlZddl m Z m Z ddl m Z GddejZGdd ejZGd d ejZGd d ejZGddejZGddejZGddejZGddejZGddejZGddejZGddejZy)N)CallableUnionList) backoff_hdlr giveup_hdlr) WebPageHelpercVeZdZddeffd ZdZgfdeeeefdeefdZ xZ S)YouRMis_valid_sourcect|||s*tjj ds t d|r||_ntjd|_d|_|r||_yd|_y)Nk YDC_API_KEYzCYou must supply ydc_api_key or set environment variable YDC_API_KEYrcyNTxs 3/var/www/html/sandstorm/storm/knowledge_storm/rm.pyz YouRM.__init__..) super__init__osenvironget RuntimeError ydc_api_keyusager )selfr rr __class__s rrzYouRM.__init__so 12::>>-#@U *D !zz-8D   #2D #1D rc0|j}d|_d|iS)Nrr r!r"r!s rget_usage_and_resetzYouRM.get_usage_and_reset s  rquery_or_queries exclude_urlsct|tr|gn|}|xjt|z c_g}|D]} d|ji}t j d||j}g}|dD]0} |j| ds| d|vs |j| 2d|vr|j|d|j|S#t$r%} tjd|d| Yd} ~ d} ~ wwxYw) aSearch with You.com for self.k top passages for query or queries Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): A list of urls to exclude from the search results. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' z X-API-Keyz&https://api.ydc-index.io/search?query=headershitsurlN"Error occurs when searching query : ) isinstancestrr!lenr requestsrjsonr appendextendr Exceptionloggingerror) r"r(r)queriescollected_resultsqueryr,resultsauthoritative_resultsres rforwardz YouRM.forward&s+*C0 !  c'l"  QE Q&(8(89",,.xrrN) rrrrrr bing_api_keyendpointparamsr webpage_helperr!r ) r"bing_search_api_keyrr rMrNwebpage_helper_max_threadsrQlanguagekwargsr#s rrzBingSearch.__init__Ns( 1"2::>>:O+Pn ! 3D  " +@ AD D !hMfM +)15    #2D #1D rc0|j}d|_d|iS)NrrLr%r&s rr'zBingSearch.get_usage_and_resetzs  e$$rr(r)ct|tr|gn|}|xjt|z c_i}d|ji}|D]} t j |j|i|jd|ij}|ddD]4}|j|ds|d|vs |d|d|dd ||d<6|jjt!|j#} g} | D]#} || } | | d | d <| j%| %| S#t$r&} tjd |d | Yd } ~  d } ~ wwxYw)aSearch with Bing for self.k top passages for query or queries Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): A list of urls to exclude from the search results. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' zOcp-Apim-Subscription-Keyqr,rYwebPagesvaluer.namesnippet)r.title descriptionr/r0Nsnippets)r1r2r!r3rWr4rrXrYr5r r8r9r:rZurls_to_snippetslistkeysr6)r"r(r)r;url_to_resultsr,r=r>drAvalid_url_to_snippetsr<r.r@s rrBzBingSearch.forwards*C0 !  c'l" .0A0AB QE Q",,MM7;Vdkk;V3PU;V$&!,W5A++AeH5!E(,:V#$U8%&vY+,Y<4qx0  Q !% 3 3 D D $$& '! ( (Cs#A1#6zBAjM  $ $Q ' ( !  Q B5'A3OPP Qs% AD)*D)2D)) E2EE)NrDN zen-USen rFrGrHrintrr'rr2rrBrIrJs@rrLrLMss! $(!"&#% *2" *2  *2  *2X%RT0! %c49n 50!EI#Y0!rrLc eZdZdZ ddedededeffd ZdZded efd Zd efd Z d Z dZ de ee efde efdZxZS)VectorRMaRetrieve information from custom documents using Qdrant. To be compatible with STORM, the custom documents should have the following fields: - content: The main text content of the document. - title: The title of the document. - url: The URL of the document. STORM use url as the unique identifier of the document, so ensure different documents have different urls. - description (optional): The description of the document. The documents should be stored in a CSV file. collection_nameembedding_modeldevicercddlm} t| |d|_|s t d|s t dd|i}ddi}|||| |_||_d|_d|_ y) Nr)HuggingFaceEmbeddingsrz!Please provide a collection name.z"Please provide an embedding model.rznormalize_embeddingsT) model_name model_kwargs encode_kwargs) langchain_huggingfacer|rrr! ValueErrormodelrxclientqdrant) r"rxryrzrr|rrr#s rrzVectorRM.__init__s @  1 @A AAB B &) /6 *&%'  /  rcNddlm} |j td|jj |j rHt d|j d||j|j |j|_ytd|j d) Nr)Qdrantz!Qdrant client is not initialized.rxz Collection z" exists. Loading the collection...)rrx embeddingsz4 does not exist. Please create the collection first.) langchain_qdrantrrrcollection_existsrxprintrr)r"rs r_check_collectionzVectorRM._check_collections+  ;; @A A ;; ( (D>ii 01G ;JK K Q&3@DK  " " $ QKA3OP P Qs A-- B 6BB vector_store_pathcddlm} | td |||_|j y#t $r}td|d}~wwxYw)NrrzPlease provide a folder path.)pathz,Error occurs when loading the vector store: )rrrrrr8)r"rrrAs rinit_offline_vector_dbzVectorRM.init_offline_vector_dbsb.  $<= = Q&,=>DK  " " $ QKA3OP P Qs5 AA  Ac0|j}d|_d|iS)Nrrwr%r&s rr'zVectorRM.get_usage_and_reset#s  E""rcb|jjj|jS)z Get the count of vectors in the collection. Returns: int: Number of vectors in the collection. r)rrrSrx)r"s rget_vector_countzVectorRM.get_vector_count)s({{!!''8L8L'MMrr(r)c t|tr|gn|}|xjt|z c_g}|D]}|jj ||j }tt|D]R}||d}|j|jd|jg|jd|jddT|S)a Search in your data for self.k top passages for query or queries. Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): Dummy parameter to match the interface. Does not have any effect. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' rrrhrgr.rhrirgr.) r1r2r!r3rsimilarity_search_with_scorerranger6metadata page_content) r"r(r)r;r<r= related_docsidocs rrBzVectorRM.forward2s*C0 !  c'l"  E;;CCETVVCTL3|,- "1oa(!(('*||M'B%(%5%5$6!$g!6"||E2   ! r)mpsrD)rFrGrH__doc__r2rurrrrr'rrrrBrIrJs@rrwrws  ### #  #J,QQsQ.QQ$# N!c49n(=!TRUY!rrwc`eZdZdZd fd ZdZdefdZgfdeee efde efdZ xZ S) StanfordOvalArxivRMzS[Alpha] This retrieval class is for internal use only, not intended for the public.cPt||||_d|_||_y)Nrr)rrrXr!rerank)r"rXrrr#s rrzStanfordOvalArxivRM.__init__Ws( 1    rc0|j}d|_d|iS)Nrrr%r&s rr'z'StanfordOvalArxivRM.get_usage_and_reset]s  %u--rr=c ||j|jd}tj|j|ddi}|j dk(rz|j dd}g}|D][}|d|d |d g|jd d |jDcic] \}}|d vr||c}}d} |j| ]|Std|j cc}}w)N)r= num_blocksr Content-Typeapplication/json)r5r,rr>document_titler.contentrhN/A)rr.r)rgr.rirhmetaz0Error: Unable to retrieve results. Status code: ) rrr4postrX status_coder5ritemsr6r8) r"r=payloadresponseresponse_data_listr> response_datakeyrdresults r _retrievezStanfordOvalArxivRM._retrievecs !4;;O== MM.BT1U    3 &!)!3I!> G!3 ' *+;<(/!.y!9 :#0#4#4]E#J+8*=*=*?&C&JJU  v& 'NB8CWCWBXY sC r(r)cg}t|tr|gn|}|D]%} |j|}|j|'|S#t$r%}t j d|d|Yd}~Sd}~wwxYw)Nr/r0)r1r2rr7r8r9r:)r"r(r)r<r;r=r>rAs rrBzStanfordOvalArxivRM.forwards*C0 !   QE Q../!((1 Q !  Q B5'A3OPP Qs"A A2 A--A2)rDT) rFrGrHrrr'r2rrrrBrIrJs@rrrTsJ] . sBRT! %c49n 5!EI#Y!rrcneZdZdZ d dedeffd ZdZdZdee e e fde e fd Z xZ S) SerperRMz:Retrieve information from custom queries using Serper.dev.rMrNct||d|_d|_||_t ||||_| |ddd|_n$||_|jjd|i||_|js*tjjd s td |jr||_d |_ ytjd |_d |_ y) aArgs: serper_search_api_key str: API key to run serper, can be found by creating an account on https://serper.dev/ query_params (dict or list of dict): parameters in dictionary or list of dictionaries that has a max size of 100 that will be used to query. Commonly used fields are as follows (see more information in https://serper.dev/playground): q str: query that will be used with google search type str: type that will be used for browsing google. Types are search, images, video, maps, places, etc. gl str: Country that will be focused on for the search location str: Country where the search will originate from. All locates can be found here: https://api.serper.dev/locations. autocorrect bool: Enable autocorrect on the queries while searching, if query is misspelled, will be updated. results int: Max number of results per page. page int: Max number of pages per call. tbs str: date time range, automatically set to any time by default. qdr:h str: Date time range for the past hour. qdr:d str: Date time range for the past 24 hours. qdr:w str: Date time range for past week. qdr:m str: Date time range for past month. qdr:y str: Date time range for past year. rrNrTTr)num autocorrectpagerSERPER_API_KEYzXYou must supply a serper_search_api_key param or set environment variable SERPER_API_KEYzhttps://google.serper.dev)rrr! query_paramsENABLE_EXTRA_SNIPPET_EXTRACTIONr rZupdateserper_search_api_keyrrrrbase_url) r"rrrrrMrNr\r#s rrzSerperRM.__init__s8 1  /N,+)15   ()$ JD  ,D     $ $eQZ 0%:"))"**..AQ2Rj  ' ')>D & 4 *,4D)ED &3 rc|jd|_|jdd}tjd|j||}|dk(r%t d|j d|j|jS)Nz/searchr)z X-API-KEYrPOST)r,r5z?Error had occurred while running the search process. Error is z, had failed with status code ) r search_urlrr4requestrreasonrr5)r"rr,rs r serper_runnerzSerperRM.serper_runners!]]O7333.  ## DOOW<  t RS[SbSbRcdBCKCWCWBXY }}rc0|j}d|_d|iS)Nrrr%r&s rr'zSerperRM.get_usage_and_resets  E""rr(r)c t|tr|gn|}|xjt|z c_g|_g}|D]Y}|dk(r |j }||d<d|d<|j ||_|jj|j[g}|jrmg}|jD]@}|jdg} | D]'} | jd} | s|j| )B|jj|} ni} |jD]} |jd} |jd} | D]} | jdg}|jr1|j| j ijd g|j|| jd | jd| | jd nd d |S#YxYw)a Calls the API and searches for the query passed in. Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): Dummy parameter to match the interface. Does not have any effect. Returns: a list of dictionaries, each dictionary has keys of 'description', 'snippets' (list of strings), 'title', 'url' zQueries:rasearchtypeorganiclinkknowledgeGraphrfrirgrhrirgr.rh)r1r2r!r3r>rrrr6rrrZrjr7)r"r(r)r;r<r=rurlsrorganic_resultsrr.roknowledge_graphris rrBzSerperRM.forwards *C0 !  c'l"   -E ",,L!&L $,L ,,\:DK LL   , -   / /D,, )"(**Y";.)G!++f-C C() ) %)$7$7$H$H$N !$& !ll F "(**Y"7"(**-=">.G ' I 67H;; 155c2>BB:rR&,,(0%,[[%9#*;;v#6$3#>!0 3 3M B%'     4!  s (B?G++G/)NrDNFrprqrr) rFrGrHrrurrr'rr2rrBrIrJs@rrrsiD# (-!"&#%74  74 74r&# M!c49n(=M!TRUYM!rrcXeZdZ ddeffd ZdZgfdeeeefdeefdZ xZ S)BraveRMr ct|||s*tjj ds t d|r||_ntjd|_d|_|r||_yd|_y)Nr BRAVE_API_KEYzNYou must supply brave_search_api_key or set environment variable BRAVE_API_KEYrcyrrrs rrz"BraveRM.__init__..Mrr) rrrrrrbrave_search_api_keyr!r )r"rrr r#s rrzBraveRM.__init__;sq 1#BJJNN?,K` "(extra_snippetsrgr.rhrr/r0N) r1r2r!r3rr4rr5r6r8r9r:) r"r(r)r;r<r=r,rr>rrAs rrBzBraveRM.forwardUs>*C0 !  c'l"  QE Q0'-,0,E,E $<<YZ_Y`a#$&#,,ub155iD%F%,,(. 3CR(H%+ZZ%8#)::e#4+1::m+D  Q2!  Q B5'A3OPP QsB4C44 D"=DD"rCrErJs@rrr:sEJN2?G2("RT,! %c49n 5,!EI#Y,!rrc\eZdZ ddeffd ZdZgfdeeeefdeefdZ xZ S)SearXNGr ct|||s td||_||_d|_|r||_yd|_y)aInitialize the SearXNG search retriever. Please set up SearXNG according to https://docs.searxng.org/index.html. Args: searxng_api_url (str): The URL of the SearXNG API. Consult SearXNG documentation for details. searxng_api_key (str, optional): The API key for the SearXNG API. Defaults to None. Consult SearXNG documentation for details. k (int, optional): The number of top passages to retrieve. Defaults to 3. is_valid_source (Callable, optional): A function that takes a URL and returns a boolean indicating if the source is valid. Defaults to None. rzYou must supply searxng_api_urlrcyrrrs rrz"SearXNG.__init__..rrN)rrrsearxng_api_urlsearxng_api_keyr!r )r"rrrr r#s rrzSearXNG.__init__sN" 1@A A.. #2D #1D rc0|j}d|_d|iS)Nrrr%r&s rr'zSearXNG.get_usage_and_resets  5!!rr(r)c pt|tr|gn|}|xjt|z c_g}|jrdd|jini}|D]} |dd}t j |j||}|j} | dD]i} |j| ds| d|vs |j| j dd | j dd g| j d d | dd k|S#t$r%} tjd |d | Yd} ~ d} ~ wwxYw)aSearch with SearxNG for self.k top passages for query or queries Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): A list of urls to exclude from the search results. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' AuthorizationzBearer r5)raformatrbr>r.rrrgrr/r0N)r1r2r!r3rr4rrr5r r6r8r9r:) r"r(r)r;r<r,r=rYrr>r@rAs rrBzSearXNG.forwards`*C0 !  c'l" ##(<(<'=> ?   QE Q$7#<<(('&#--/ + A++AeH5!E(,:V)00/0uuY/C-.UU9b-A,B)*w);'(x   Q*!  Q B5'A3OPP Qs&AD/D7A D D5D00D5rCrErJs@rrrsO $( 2 " 2:" RT.! %c49n 5.!EI#Y.!rrc eZdZdZ ddedededededef fd Zd Ze je je fdd e e d efdZgfdeeeefdeefdZxZS)DuckDuckGoSearchRMz:Retrieve information from custom queries using DuckDuckGo.rqrr rMrN safe_searchregionct || ddlm}||_t ||||_d|_d|_ ||_ ||_ |r||_ nd|_ ||_ y#t$r} t d| d} ~ wwxYw) a\ Params: min_char_count: Minimum character count for the article to be considered valid. snippet_chunk_size: Maximum character count for each snippet. webpage_helper_max_threads: Maximum number of threads to use for webpage helper. **kwargs: Additional parameters for the OpenAI API. rr)DDGSz4Duckduckgo requires `pip install duckduckgo_search`.NrTapicyrrrs rrz-DuckDuckGoSearchRM.__init__.. rr)rrduckduckgo_searchr ImportErrorrr rZr!duck_duck_go_backendduck_duck_go_safe_searchduck_duck_go_regionr ddgs) r"rr rMrNr\rrrerrr#s rrzDuckDuckGoSearchRM.__init__s" 1  . +)15   %*!)4%$*  #2D #1D F = F  sA.. B7 BBc0|j}d|_d|iS)Nr DuckDuckGoRMr%r&s rr'z&DuckDuckGoSearchRM.get_usage_and_reset  &&r)max_time max_tries on_backoffgiveupr=cj|jj||j|j}|S)N) max_resultsbackend)rtextrr)r"r=r>s rrzDuckDuckGoSearchRM.requests3)).. tvvt/H/H! rr(r)c t|tr|gn|}|xjt|z c_g}|D]}|j |}|D]}t|t st d|d# |jdd}|jdd} |jd| } |jddg} t|| | | gstd||j|r||vr|| | | d } |j| nt d |d |S#t$r-} t d  d | dt d|d | Yd} ~ d} ~ wwxYw)aSearch with DuckDuckGoSearch for self.k top passages for query or queries Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): A list of urls to exclude from the search results. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' Invalid result:  hrefNrgrhbodyMissing key(s) in result: r.rgrhriinvalid source  or url in exclude_urls$Error occurs when processing result=r0r/) r1r2r!r3rdictrrallrr r6r8)r"r(r)r;r<r=r>rnr.rgrhrirrAs rrBzDuckDuckGoSearchRM.forward"s*C0 !  c'l"  MEll5)G M!!T*,QCr23M%%-CEE'40E"#%% u"=K !fd 34HUKBC(+EaS)IJJ++C0S 5L#&%*+6(0 " *008u4KLM3 M MD! !MA&"QCrJK>ugRsKLLMs2B#D E$#E  E)rDNrprqrrOnzus-en)rFrGrHrrurr2rr'backoff on_exceptionexpor8rrrrrrBrIrJs@rrrsD$(!"&#%2 2"2 2  222h' W   SRT5! %c49n 55!EI#Y5!rrc teZdZdZ d dedededeffd ZdZgfdee e e fd e e fd Z xZ S) TavilySearchRMzRetrieve information from custom queries using Tavily. Documentation and examples can be found at https://docs.tavily.com/docs/python-sdk/tavily-search/examplesrr rMrNct || ddlm}|s*t j jds td|r||_ nt j d|_ ||_ t||||_ d|_ ||j |_||_|r||_yd |_y#t$r} t d| d} ~ wwxYw) a Params: tavily_search_api_key str: API key for tavily that can be retrieved from https://tavily.com/ min_char_count: Minimum character count for the article to be considered valid. snippet_chunk_size: Maximum character count for each snippet. webpage_helper_max_threads: Maximum number of threads to use for webpage helper. include_raw_content bool: Boolean that is used to determine if the full text should be returned. rr) TavilyClientz,Tavily requires `pip install tavily-python`.NTAVILY_API_KEYzPYou must supply tavily_search_api_key or set environment variable TAVILY_API_KEYrT)rcyrrrs rrz)TavilySearchRM.__init__..rr)rrtavilyr#rrrrrtavily_search_api_keyrr rZr! tavily_clientinclude_raw_contentr ) r"r'rr rMrNr\r)r#rr#s rrzTavilySearchRM.__init__]s$ 1 W +%RZZ^^D &)+4D)ED &+)15   *$2L2LM#6  #2D #1D ? WLMSV V WsB:: C CCc0|j}d|_d|iS)Nrr!r%r&s rr'z"TavilySearchRM.get_usage_and_resets   %((rr(r)c t|tr|gn|}|xjt|z c_g}|D]V}|j|j d}|j j|}|jd}|D]} t| tstd| d$ | jdd} | jdd} | jdd} g} | jd r!| j| jd n | j| jdt| | | | gstd | |j| r| |vr| | | | d }|j|ntd | d  Y|S#t$r.}tdd|dtd|d|Yd}~Cd}~wwxYw)aSearch with TavilySearch for self.k top passages for query or queries Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): A list of urls to exclude from the search results. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' )r include_raw_contentsr>rrr.Nrgrraw_body_contentrrrrrr0r/)r1r2r!r3rr)r(rrrrr6rrr r8)r"r(r)r;r<r=args responseDatar>rnr.rgrhrirrAs rrBzTavilySearchRM.forwards*C0 !  c'l" ( ME#vv(,(@(@D  --44U;L"&&y1G M!!T*,QCr23M%%t,CEE'40E"#%% 4"8K!Huu/0 .@(AB i(89UKBC(+EaS)IJJ++C0S 5L#&%*+6(0 " *008u4KLM; M( MT! !MA&"QCrJK>ugRsKLLMs(C$F G #GG )NrDNrprqrrF) rFrGrHrrurrr'rr2rrBrIrJs@rr!r!Zsk#$(!"&#%!42 42" 42  42  42l) RT=! %c49n 5=!EI#Y=!rr!cleZdZ d dededeffd ZdZgfdeee efde efdZ xZ S) GoogleSearchr rMrNct || ddlm}|s*t j jds td|s*t j jds td |xst j d|_ |xst j d|_ |r||_ nd |_ |d d |j |_ t||||_d|_y#t$r} t d| d} ~ wwxYw)a Params: google_search_api_key: Google API key. Check out https://developers.google.com/custom-search/v1/overview "API key" section google_cse_id: Custom search engine ID. Check out https://developers.google.com/custom-search/v1/overview "Search engine ID" section k: Number of top results to retrieve. is_valid_source: Optional function to filter valid sources. min_char_count: Minimum character count for the article to be considered valid. snippet_chunk_size: Maximum character count for each snippet. webpage_helper_max_threads: Maximum number of threads to use for webpage helper. rr)buildz=GoogleSearch requires `pip install google-api-python-client`.NGOOGLE_SEARCH_API_KEYz[You must supply google_search_api_key or set the GOOGLE_SEARCH_API_KEY environment variable GOOGLE_CSE_IDzKYou must supply google_cse_id or set the GOOGLE_CSE_ID environment variablecyrrrs rrz'GoogleSearch.__init__..rr customsearchv1) developerKeyrT)rrgoogleapiclient.discoveryr3rrrrrgoogle_search_api_key google_cse_idr servicer rZr!) r"r;r<rr rMrNr\r3rr#s rrzGoogleSearch.__init__s , 1  7 %RZZ^^.rr)rrazure.core.credentialsrHazure.search.documentsrJrrrrrazure_ai_search_api_keyazure_ai_search_urlazure_ai_search_index_namer!r ) r"rRrSrTrr rHrJrr#s rrzAzureAISearch.__init__[s2( 1  A ; 'rzz~~ %0 m %+BD (+-::6O+PD ("2::>>:O+Pe !':D $')zz2G'HD $)"**.. (3 s (.HD +.0jj9U.VD +  #2D #1D U N  s D## D=, D88D=c0|j}d|_d|iS)NrrEr%r&s rr'z!AzureAISearch.get_usage_and_resets  ''rr(r)c  ddlm}ddlm}t |t r|gn|}|xjt|z c_g}||j|j||j}|D]?} |j| d} | D]$} | d| d d | d gd } |j| &A|S#t$r}t d|d}~wwxYw#t$r%} tj d | d| Yd} ~ d} ~ wwxYw)aSearch with Azure Open AI for self.k top passages for query or queries Args: query_or_queries (Union[str, List[str]]): The query or queries to search for. exclude_urls (List[str]): A list of urls to exclude from the search results. Returns: a list of Dicts, each dict has keys of 'description', 'snippets' (list of strings), 'title', 'url' rrGrIrKNr) search_texttopmetadata_storage_pathrgrchunkrr/r0)rPrHrQrJrr1r2r!r3rSrTrRrr6r8r9r:)r"r(r)rHrJrr;r<rr=r>rdocumentrAs rrBzAzureAISearch.forwards:  A ;*C0 !  c'l"   $ $  + + t;; <   QE Q --Eq-A%7F%&=>!'',%+G_$5  H &,,X67  Q ! C N  < Q B5'A3OPP Qs/ B77ras (( ) =!DMM=!@c!c!L^!t}}^!B?!$--?!Da!t}}a!HG!dmmG!TQ!dmmQ!h!!D{!T]]{!|y!4==y!xB!DMMB!r