dhSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSKJ r SSK J r SSK J r JrJrJrJrJrJrJrJr SSKJr SSKJr SSKJr \ (a SS KJr SS KJr "S S \5r!g) ) annotationsN)contextmanager)StringIO) TYPE_CHECKINGAnyDict GeneratorIterableListOptionalTupleType) Embeddings) VectorStore)Document) connection)cursorc\rSrSrSr"SS\\R5r"SS5r SSSS .S&S jjr "S S 5r S'S jr S'Sjr S(S)SjjrS*S+SjjrS,SjrS*S-SjjrS.Sjr\S/S0Sjj5rS(S1SjjrS2S3SjjrS4SjrS5S6SjjrS5S7SjjrS5S8SjjrS5S9SjjrS*S:SjjrS;SjrSS#jr#S?S$jr$S%r%g)@ Yellowbrick!zYellowbrick as a vector database. Example: .. code-block:: python from langchain_community.vectorstores import Yellowbrick from langchain_community.embeddings.openai import OpenAIEmbeddings ... c \rSrSrSrSrSrSrg)Yellowbrick.IndexType*z\rSrSrSrSSSjjrS S SjjrSrg) Yellowbrick.IndexParams0z/Parameters for configuring a Yellowbrick index.NcjUc[RRnXlU=(d 0UlgN)rr'r" index_typeparams)selfr-r.s r&__init__ Yellowbrick.IndexParams.__init__3s+ !(2277 (O ,BDKr%c8URRX5$r,)r.get)r/keydefaults r& get_param!Yellowbrick.IndexParams.get_param=s;;??30 0r%)r-r.NN)r-z!Optional['Yellowbrick.IndexType']r.zOptional[Dict[str, Any]]r,)r4strr5rreturnr)rrrr r!r0r6r$rr%r& IndexParamsr)0s/==A/3 '9 '- ' 1 1r%r;NF)schemaloggerdropcSSKJn UR5 U(aXPlO[R "[ 5UlURR[R5 [R"5nUR[R5 [R"S5n URU 5 URRU5 [U[5(dURR!S5 gSUlSUlSUlX l[*R-X R5Ul[0R2"UR.R45 X@lX0lXlSUlUR?5 UR.RA5n U(ahURCUR8UR6U S 9 URCUR8UR&-UR6U S 9 UREU 5 URGU 5 URIU 5 SSS5 g!,(df  g=f) zInitialize with yellowbrick client. Args: embedding: Embedding operator connection_string: Format 'postgres://username:password@host:port/database' table: Table used to store / retrieve embeddings from r)extrasz)%(asctime)s - %(levelname)s - %(message)sz+embeddings input must be Embeddings object.N _lsh_index_lsh_hyperplane_content)tabler<r)%psycopg2r@ register_uuidr=logging getLoggerrsetLevelERROR StreamHandlerDEBUG Formatter setFormatter addHandler isinstancererrorLSH_INDEX_TABLELSH_HYPERPLANE_TABLE CONTENT_TABLEconnection_stringrDatabaseConnectionratexitregisterclose_connection_schema_table _embedding_max_embedding_len_check_database_utf8 get_cursorr>_drop_lsh_index_tables_create_schema _create_table) r/ embeddingrUrDr<r=r>r@handler formatterrs r&r0Yellowbrick.__init__@s $  K!++H5DK KK  /++-G   W]] +))*UVI   + KK " "7 +)Z00 KK  K L $0):!",!2%889JKKX889  #"& !!# __ ' ' )V  DLL P ++(:(::<<! ++F3    '   v &* ) )s BI I)c^\rSrSr%SrS\S'SrS\S'S\S'SU4S jjrSS jrSS jr \ SS j5r \ SS j5r Sr U=r$)Yellowbrick.DatabaseConnection~Nr9_connection_stringzOptional['PgConnection'] _connectionlogging.Logger_loggerc>URc4[TU] U5UlXRlX RlUR$r,) _instancesuper__new__rjrm)clsrUr= __class__s r&rq&Yellowbrick.DatabaseConnection.__new__s=}}$ % 4 3D 0(. %== r%cUR(a>URR(d"URR5 SUlgggr,)rkclosedclose)r/s r&rY/Yellowbrick.DatabaseConnection.close_connections<(8(8(?(?  &&(#' )@r%cSSKnUR(aURR(a1URUR5UlSURlUR$)NrF)rErkrvconnectrj autocommit)r/rEs r&get_connection-Yellowbrick.DatabaseConnection.get_connectionsO ##t'7'7'>'>#+#3#3D4K4K#L .3  +## #r%c## SSKJn UR5nUv UR5 g!Ua;nUR 5 UR R SSS9 [S5UeSnAff=f7f)Nr) DatabaseErrorz2Database error occurred, rolling back transaction.T)exc_infozDatabase transaction failed.)rErr|commitrollbackrmrQ RuntimeError)r/rconnes r&get_managed_connection5Yellowbrick.DatabaseConnection.get_managed_connectionst .&&(D   ! J  ""HSW###ABI  Js$A3/A3A06A++A00A3c## UR5nUR5nUv UR5 SSS5 g!UR5 f=f!,(df  g=f7fr,)rrrw)r/rrs r&r_)Yellowbrick.DatabaseConnection.get_cursorsN,,.$# LLLN /. LLN /.s1A)AAA A)AA A&"A))rk)rUr9r=rlr:z 'Yellowbrick.DatabaseConnection'r:None)r:z'PgConnection')r:z%Generator['PgConnection', None, None])r:z!Generator['PgCursor', None, None])rrrr ro__annotations__rkrqrYr|rrr_r$ __classcell__)rss@r&rVrh~sn 04 -4 !$' !1? ! - ! (  $      #  #r%rVcSSKJn UR(aGURUR S5R UR UR5S95 gg)z. Helper function: create schema if not exists rsqlzE CREATE SCHEMA IF NOT EXISTS {s} )sN)rErrZexecuteSQLformat Identifier)r/rrs r&raYellowbrick._create_schemasQ ! << NN&nnT\\2   r%c 6SSKJn UR(a UR4OSnUR"/UQURUR -P76nURURUR -S-5nUR URS5RUUS95 UR(a UR4OSnUR"/UQURP76nUR"/UQURUR -P76nURURUR -S-5nURURUR -S-5n UR URS 5RUUUU S 95 g ) z- Helper function: create table if not exists rrr _pk_doc_ida0 CREATE TABLE IF NOT EXISTS {t} ( doc_id UUID NOT NULL, text VARCHAR(60000) NOT NULL, metadata VARCHAR(1024) NOT NULL, CONSTRAINT {c} PRIMARY KEY (doc_id)) DISTRIBUTE ON (doc_id) SORT ON (doc_id) tc_pk_doc_id_embedding_id _fk_doc_ida CREATE TABLE IF NOT EXISTS {t1} ( doc_id UUID NOT NULL, embedding_id SMALLINT NOT NULL, embedding FLOAT NOT NULL, CONSTRAINT {c1} PRIMARY KEY (doc_id, embedding_id), CONSTRAINT {c2} FOREIGN KEY (doc_id) REFERENCES {t2}(doc_id)) DISTRIBUTE ON (doc_id) SORT ON (doc_id) t1t2c1c2N) rErrZrr[rTrrr) r/rr schema_prefixrrrrrrs r&rbYellowbrick._create_tablesm !+/<<R NN LM L4;;9K9K+K L NN4;;););;lJ K GG f ,0<<R ^^ 8] 8DKK 8 ^^ M] MDKK$:L:L,L M ^^ KK$,, ,/H H ^^DKK$*<*<<|K L GG f  r%cUc4URR5nURX1US9 SSS5 gURX1US9 g!,(df  g=f)zp Helper function: Drop data. If a cursor is provided, use it; otherwise, obtain a new cursor for the operation. N)r<)rr_ _drop_table)r/rDr<rs r&r>Yellowbrick.dropsT >++-  v >.-   V6  :.-s A  AcSSKJn U(aURX25nOURU5nURS5R U5nUR U5 g)z9 Executes the drop table command using the given cursor. rrz1 DROP TABLE IF EXISTS {} CASCADE N)rErrrrr)r/rrDr<r table_namedrop_table_querys r&rYellowbrick._drop_tablesW ! 6J.J77   &   '(r%cURR5nSnURU5 UR5SnSSS5 WR 5S:XdUR 5S:Xag[ S5e!,(df  NB=f)z5 Helper function: Test the database is UTF-8 encoded z SELECT pg_encoding_to_char(encoding) FROM pg_database WHERE datname = current_database(); rNutf8zutf-8TzDatabase encoding is not UTF-8)rr_rfetchonelower Exception)r/rqueryencodings r&r^ Yellowbrick._check_database_utf8sx__ ' ' )VE NN5 !(+H* >> v %)9W)D<= =* )s 'A>> B c Sn[U5nURR[U55n/nU(dUVs/sHn0PM nnURS5=(d [R 5nUR R5n [5n [5n [R"U SS[RS9n [R"U SS[RS9n Sn[U5Hunn[[R"55nUR!U5 U R#UU[$R&"X/5/5 [X_5HunnU R#UUU/5 M US- nX:dMUR)XU 5 U R+S5 U R-S5 U R+S5 U R-S5 SnM US:aUR)XU 5 SSS5 UR.[R0R2:Xa&UR5U[R6"W55 U$s snf!,(df  Nc=f)Ni' index_params ") delimiter quotecharquotingr)listr\embed_documentsr3rr;rr_rcsvwriter QUOTE_MINIMAL enumerater9uuiduuid4appendwriterowjsondumps _copy_to_dbseektruncater-r'r# _update_indexUUID)r/texts metadataskwargs batch_size embeddingsresults_rr content_io embeddings_iocontent_writerembeddings_writercurrent_batch_sizeitextdoc_uuid embedding_idrcs r& add_textsYellowbrick.add_texts3s   U __44T%[A %*+UUI+zz.1N[5L5L5N __ ' ' )V!J$JM ZZdc3CTCTN!$ cFWFW! "# $U+4tzz|,x(''4IL9Q(RS/8/G+L)%.., /RS0H#a'"%3$$VGOOA&''*!&&q)!**1-)*&%,("A%  ]CA*D  " "k&;&;&?&? ?   |TYYx-@ AS,* )s I C>I%A4I%% I3c"URS5 URS5 SSKJn UR(a UR4OSnUR"/UQUR UR -P76nURS5RUS9nURXr5 UR(a UR4OSnUR"/UQUR P76nURS5RUS9nURX5 g)Nrrrz COPY {table} (doc_id, text, metadata) FROM STDIN WITH (FORMAT CSV, DELIMITER E'\t', QUOTE '"') )rDz COPY {table} (doc_id, embedding_id, embedding) FROM STDIN WITH (FORMAT CSV, DELIMITER E'\t', QUOTE '"') ) rrErrZrr[rTrr copy_expert) r/rrrrrrDcontent_copy_queryembeddings_copy_querys r&rYellowbrick._copy_to_dbjs 1 +/<<R P Pt{{T=O=O/OP WW  &u&   -:+/<<R ; ;t{{; # ! &u&   0@r%c BU"UUUUUS9n U R"SXS.UD6 U $)aOAdd texts to the vectorstore index. Args: texts: Iterable of strings to add to the vectorstore. metadatas: Optional list of metadatas associated with the texts. connection_string: URI to Yellowbrick instance embedding: Embedding function table: table to store embeddings kwargs: vectorstore specific parameters )rcrUrDr<r>)rrr)r) rrrrcrrUrDr<r>rvsss r& from_textsYellowbrick.from_textss8*/   AEA&A r%c ^ SSKJm U(aT RS5nObUbT[U 4SjU55nT RS5R U5nT RS5R US9nO [ S 5eUR(a UR4OS nURR5nT R"/UQURUR-P76n T RS 5R XS 9n URU 5 T R"/UQURP76n T RS 5R XS 9n URU 5 UR"XRUR-/UQ76(aZT R"/UQURUR-P76n T RS 5R XS 9n URU 5 SSS5 g!,(df  g=f) z`Delete vectors by uuids. Args: ids: List of ids to delete, where each id is a uuid string. rrz' WHERE 1=1 Nc3D># UHnTRU5v M g7fr,)Literal).0idrs r& %Yellowbrick.delete..s8Cb#++b//Cs z, z5 WHERE doc_id IN ({ids}) )idsz*Either ids or delete_all must be provided.rzDELETE FROM {table} {where_sql})rD where_sql)rErrtuplejoinr ValueErrorrZrr_rr[rTr _table_existsrR) r/r delete_allrruuids ids_formattedrrtable_identifierrrs @r&deleteYellowbrick.deletes ! I _8C88EGGDM..u5Mf! IJ J+/<<R __ ' ' )V"~~   $ d.@.@ @  GG=>EE&FE NN5 !"~~J}JdkkJ GG=>EE&FE NN5 !!! d&:&::=J$'>>$"$$(KK$2F2F$F$  ABII*Ju%1*45* )4s =D1G77 HcSSKJn URU5nURU5nURUR S5R UUS95 UR 5SS:$)z. Checks if a table exists in the given schema rrz SELECT COUNT(*) FROM sys.table t INNER JOIN sys.schema s ON t.schema_id = s.schema_id WHERE s.name = {schema} AND t.name = {table_name} )r<r)rErrrrrr)r/rrr<rs r&rYellowbrick._table_existssp !V$[[,  GG  f%  #a''r%cSSKnSR[[U55nUR UR 55nUR 5n[R"USSS9nU$)Nr,)bytes) hashlibrmapr9sha1encodedigestrr)r/vectorr vector_str hash_object hash_digest vector_uuids r&_generate_vector_uuid!Yellowbrick._generate_vector_uuidsZXXc#v./ ll:#4#4#67 !((* iik#2&67 r%c SSKJn SSKJn UR S5=(d [ R 5nURR5nSUR-nURU5n URS5RURU55n URU 5 [U5V V s/sHup[!U 5X4PM n n n URS5RURU55nU"X~U 5 URU5nUR"(a UR"4OSnUR"/UQURP76nUR"/UQURUR$-P76nUR&[ R(R*:XaURS -nUR-UUU5 UR"(a UR"4OSnUR"/UQURUR.-P76nURU5nURS 5RUUUUUUR1UR3S S55S 9nURUU45 UR55nOCURS 5RUUUS9nURUU45 UR55nSSS5 /nWHHn[6R8"US5=(d 0n[;USUS9nUR=UUS45 MJ U$s sn n f!,(df  Nf=f)aRPerform a similarity search with Yellowbrick with vector Args: embedding (List[float]): query embedding k (int, optional): Top K neighbors to retrieve. Defaults to 4. NOTE: Please do not let end-user fill this and always be aware of SQL injection. Returns: List[Document, float]: List of Documents and scores rr)execute_valuesrtmp_z CREATE TEMPORARY TABLE {} ( doc_id UUID, embedding_id SMALLINT, embedding FLOAT) ON COMMIT DROP DISTRIBUTE REPLICATE z:INSERT INTO {} (doc_id, embedding_id, embedding) VALUES %sr _tmp_hasha/ WITH index_docs AS ( SELECT t1.doc_id, SUM(ABS(t1.hash-t2.hash)) as hamming_distance FROM {lsh_index} t1 INNER JOIN {input_hash_table} t2 ON t1.hash_index = t2.hash_index GROUP BY t1.doc_id HAVING hamming_distance <= {hamming_distance} ) SELECT text, metadata, SUM(v1.embedding * v2.embedding) / (SQRT(SUM(v1.embedding * v1.embedding)) * SQRT(SUM(v2.embedding * v2.embedding))) AS score FROM {v1} v1 INNER JOIN {v2} v2 ON v1.embedding_id = v2.embedding_id INNER JOIN {v3} v3 ON v2.doc_id = v3.doc_id INNER JOIN index_docs v4 ON v2.doc_id = v4.doc_id GROUP BY v3.doc_id, v3.text, v3.metadata ORDER BY score DESC LIMIT %s hamming_distance)v1v2v3 lsh_indexinput_hash_tablera SELECT text, metadata, score FROM (SELECT v2.doc_id doc_id, SUM(v1.embedding * v2.embedding) / (SQRT(SUM(v1.embedding * v1.embedding)) * SQRT(SUM(v2.embedding * v2.embedding))) AS score FROM {v1} v1 INNER JOIN {v2} v2 ON v1.embedding_id = v2.embedding_id GROUP BY v2.doc_id ORDER BY score DESC LIMIT %s ) v4 INNER JOIN {v3} v3 ON v4.doc_id = v3.doc_id ORDER BY score DESC )rrrNr) page_contentmetadata)rErpsycopg2.extrasrr3rr;rr_r[r rrrrrr9rZrTr-r'r#_generate_tmp_lsh_hashesrRrr6fetchallrloadsrr)r/rckrrrrrtmp_embeddings_table tmp_doc_idcreate_table_queryrembedding_value data_input insert_queryrrrrtmp_hash_tablerr sql_queryr documentsresultrdocs r&&similarity_search_with_score_by_vector2Yellowbrick.similarity_search_with_score_by_vectors# !2zz.1N[5L5L5N __ ' ' )V#)DKK#7 33I>J!$ "fS^^$89:  NN- .6?y5I5I1LZ,@5I 77LfS^^$89:  6 < 45B/3||T\\OM<< P>P0PQB&&+*?*?*C*CC!%{!:--(" 48<<R NN"$(KK$2F2F$F $'>>.#A GG!#F&'%5%([[$../A1E&  GZD!//+GG2&3<y1$/ //+u*x35 Fzz&),2Hq HEC   c6!9- . i* )s A/L>L8HL>8L>> M c URRU5nUR"SXBS.UD6nUVVs/sHupgUPM snn$s snnf)a%Perform a similarity search with Yellowbrick Args: query (str): query string k (int, optional): Top K neighbors to retrieve. Defaults to 4. NOTE: Please do not let end-user fill this and always be aware of SQL injection. Returns: List[Document]: List of Documents rcrrr\ embed_queryr*)r/rrrrcr'r)rs r&similarity_searchYellowbrick.similarity_searchsTOO//6 ??  (. #,,)),,,s Ac dURRU5nUR"SXBS.UD6nU$)a2Perform a similarity search with Yellowbrick Args: query (str): query string k (int, optional): Top K neighbors to retrieve. Defaults to 4. NOTE: Please do not let end-user fill this and always be aware of SQL injection. Returns: List[Document]: List of (Document, similarity) r-rr.)r/rrrrcr's r&similarity_search_with_score(Yellowbrick.similarity_search_with_scores@OO//6 ??  (. r%c bUR"SXS.UD6nUVVs/sHupVUPM snn$s snnf)a?Perform a similarity search with Yellowbrick by vectors Args: embedding (List[float]): query embedding k (int, optional): Top K neighbors to retrieve. Defaults to 4. NOTE: Please do not let end-user fill this and always be aware of SQL injection. Returns: List[Document]: List of documents r-r)r*)r/rcrrr'r)rs r&similarity_search_by_vector'Yellowbrick.similarity_search_by_vectors@??  (. #,,)),,,s +cSSKJn UR(a UR4OSnUR"/UQURUR -P76nUR"/UQURUR -P76nUR"/UQURP76nURS5RU5nU(a6URS5RUR[U55S9OURS5n URS5n URS 5RUUUU U S 9n URU 5 g ) zAdd hashes to LSH indexrrrzINSERT INTO {}zWHERE e.doc_id = {doc_id})doc_idz GROUP BY 1, 2av {query_prefix} SELECT e.doc_id as doc_id, h.id as hash_index, CASE WHEN SUM(e.embedding * h.hyperplane) > 0 THEN 1 ELSE 0 END as hash FROM {embedding_table} e INNER JOIN {hyperplanes} h ON e.embedding_id = h.hyperplane_id {condition} {group_by} ) query_prefixembedding_table hyperplanes conditiongroup_byN) rErrZrr[rSrRrrrr9r) r/rr9rrlsh_hyperplane_tablelsh_index_table_idembedding_table_idquery_prefix_idr>r? input_querys r&_update_lsh_hashesYellowbrick._update_lsh_hashessC !+/<<R "~~   KK$*C*CC !^^   KK$*>*>> !^^H]HDKKH''"23::;MN GG/ 0 7 7s{{3v;?W 7 X  77?+gg    &(.,   & {#r%cSSKJn UR(a UR4OSnUR"/UQURUR -P76nURU5nURU5nUR S5RU5n UR S5n UR S5RU UUU S9n URU 5 g) zGenerate temp LSHrrrz+CREATE TEMPORARY TABLE {} ON COMMIT DROP ASz GROUP BY 1a[ {query_prefix} SELECT h.id as hash_index, CASE WHEN SUM(e.embedding * h.hyperplane) > 0 THEN 1 ELSE 0 END as hash FROM {embedding_table} e INNER JOIN {hyperplanes} h ON e.embedding_id = h.hyperplane_id {group_by} DISTRIBUTE REPLICATE )r;r<r=r?N) rErrZrr[rSrrr) r/rtmp_embedding_tabler%rrr@tmp_embedding_table_idtmp_hash_table_idr;r?rDs r&r$Yellowbrick._generate_tmp_lsh_hashess !+/<<R "~~   KK$*C*CC "%0C!DNN>:wwLMTT  77<(gg    &%2,   " {#r%cSSKJn UR(a UR4OSnUR"/UQURUR -P76nUR URS5RUS95 UR5SS:agUR"/UQURP76nUR URS5RUS95 UR5SnUS- nURS 5RURU5URU5US 9nUR U5 g) z4Generate random hyperplanes and store in YellowbrickrrrzSELECT COUNT(*) FROM {t})rNz!SELECT MAX(embedding_id) FROM {t}ra2 WITH parameters AS ( SELECT {num_hyperplanes} AS num_hyperplanes, {dims_per_hyperplane} AS dims_per_hyperplane ) INSERT INTO {hyperplanes_table} (id, hyperplane_id, hyperplane) SELECT id, hyperplane_id, (random() * 2 - 1) AS hyperplane FROM (SELECT range-1 id FROM sys.rowgenerator WHERE range BETWEEN 1 AND (SELECT num_hyperplanes FROM parameters) AND worker_lid = 0 AND thread_id = 0) a, (SELECT range-1 hyperplane_id FROM sys.rowgenerator WHERE range BETWEEN 1 AND (SELECT dims_per_hyperplane FROM parameters) AND worker_lid = 0 AND thread_id = 0) b )num_hyperplanesdims_per_hyperplanehyperplanes_table) rErrZrr[rSrrrrr) r/rrMrrrOrnum_dimensionsr$s r&_populate_hyperplanes!Yellowbrick._populate_hyperplanes*s- +/<<R NN   KK$*C*CC  sww9:AADUAVW ?? Q ! #  NN 7M 74;; 7swwBCJJQJOP*1-!ww  $ &KK8 # N ;/  % . |$r%c PSSKJn UR(a UR4OSnUR"/UQURUR -P76nUR"/UQURUR -P76nURURUR -S-5nURURUR -S-5nURURS5RUUUUS95 UR(a UR4OSnUR"/UQURUR-P76nURURUR-S-5n URURS 5RUU S 95 g ) z&Create LSH index and hyperplane tablesrrrrra CREATE TABLE IF NOT EXISTS {t1} ( doc_id UUID NOT NULL, hash_index SMALLINT NOT NULL, hash SMALLINT NOT NULL, CONSTRAINT {c1} PRIMARY KEY (doc_id, hash_index), CONSTRAINT {c2} FOREIGN KEY (doc_id) REFERENCES {t2}(doc_id)) DISTRIBUTE ON (doc_id) SORT ON (doc_id) r _pk_id_hp_ida2 CREATE TABLE IF NOT EXISTS {t} ( id SMALLINT NOT NULL, hyperplane_id SMALLINT NOT NULL, hyperplane FLOAT NOT NULL, CONSTRAINT {c} PRIMARY KEY (id, hyperplane_id)) DISTRIBUTE REPLICATE SORT ON (id) rN) rErrZrr[rRrTrrrrS) r/rrrrrrrrrs r&_create_lsh_index_tables$Yellowbrick._create_lsh_index_tablesTsp +/<<R ^^ O] ODKK$:N:N,N O ^^ M] MDKK$:L:L,L M ^^DKK$*>*>>M N ^^DKK$*>*>>M N GG f  &,0<<R NN SM S4;;9R9R+R S NN4;;)B)BB^S T GG f r%cURURURUR-US9 URURURUR-US9 g)zDrop LSH index tables)r<rDrN)r>rZr[rRrS)r/rs r&r`"Yellowbrick._drop_lsh_index_tabless] <boolr:r)r 'PgCursor'r:rr8)rDr9r<rlrzOptional['PgCursor']r:rr,)rrnrDr9r<rlr:r)r:rm)rz Iterable[str]rOptional[List[dict]]rrr: List[str])rrnrrrrr:r)Nr: langchainpublicF)rrzType[Yellowbrick]rrprcrrrorUr9rDr9r<r9r>rmrrr:r)rzOptional[List[str]]rzOptional[bool]rrr:r)rr)rrnrr9r<r9r:rm)r List[float]r: uuid.UUID))rcrsrintrrr:List[Tuple[Document, float]])rr9rrvrrr:List[Document])rr9rrvrrr:rw)rcrsrrvrrr:rx)rrnr9zOptional[uuid.UUID]r:r)rrnrHr9r%r9r:r)rrnrMrvr:r)rr)r:r)rr)r9rtr:rr)&rrrr r!r9enumEnumr'r;r0rVrarbr>rr^rr classmethodrrrr r*r0r3r6rErrQrUr`r\r_rrjr$rr%r&rr!suC 11,!%+/<'<'<' <'  <')<'<' <'|4#4#l"1 l!%'+ ;;;% ;  ;(!% ))) )  )..+/55(5 5  5nA A.6AGOA A8 +/!#  (      @$(%); ;#; ;  ;|BJ( (.1(;>( (001V$V),VrsS"  %   13:>6lH+lHr%