+ Wi=^RIHt^RIt^RIt^RIt^RIt^RIHt^RIHt^RI H t H t H t H t HtHtHtHtHtHtHtHtHtHt^RIHt^RIt^RIt^RIHt^RIHt^R I H!t!^R I"H#t#^R I$H%t%H&t&H't'H(t(H)t)H*t*H+t+^R IH,t,^R I-H.t.^RI/H0t0H1t1^RI2H3t3H4t4]Pj!R4R8Ht6Rt7RRlt8.3RRllt9RRlt:RRlt;RRlt<]R,t=]R,t>!RR]#RR 7t?!R!R"]#RR 7t@]]?]@3,tA/R#]B.bR$]C.bR%]D.bR&]D.bR']B.bR(]B.bR)]B.bR*]B.bR+]B.bR,]D.bR-]D.bR.]>]B.bR/]=.bR0]D.bR1]E.bR2]F]E.bR3]D.bR4]B.R5]F.R6]E./CtGR7]B.R$]C.R%]D.R&]D.R']B.R(]B.R)]B.R*]B.R,]D.R-]D.R8]E.R/]=.R0]D.R2]F]E./tH]R,tIR9]D.R:]F]E.R;]F]E.R<]F]E.R=]F]E.R>]F]E.R?]C.R@]I.RA]C.RB]E.R0]D./ tJRC]C.RD]B]D.RE]F.R0]D./tKRFRGltLRHtMRIRJltN]R,tO]R,tP!RKRL]#RR 7tQ!RMRN]#RR 7tR!RORP]#RR 7tS!RQRR]#RR 7tT!RSRT]#RR 7tU!RURV]#RR 7tV!RWRX]#RR 7tW!RYRZ]#RR 7tX!R[R\]#RR 7tY]!R]R^44tZ]!R_R`44t[]!RaRb44t\]!RcRd44t]]!ReRf44t^]!RgRh44t_]!RiRj44t`]!RkRl44ta]!RmRn44tb]!RoRp44tc]!RqRr44td]!RsRt44te]!RuRv44tf]]e]f3,tg]!RwRx44th]!RyRz]h44ti]!R{R|]h44tj]!R}R~]h44tk]!RR]h44tl]!RR44tm]!RR44tn]!RR44to!RR4tp!RR4tq!RR]p4tr!RR]q4ts]!R4tt]!RR44tu]!RR] ]t,44tv]!RR44tw]R,tx]!RR44ty]!RR44tzRRlt{RRlt|!RR4t}!RR]}4t~R#)) annotationsN) dataclass)wraps)AnyCallableDictGenericIterableIteratorListLiteralOptionalTypeVarUnionget_args get_originoverload)AsyncWebsetsClient)OpenAI)ChatCompletionMessageParam) ChatModel) TypedDict)ExaOpenAICompletion_convert_schema_input_get_package_versionadd_message_to_messagesformat_exa_resultmaybe_get_queryJSONSchemaInput) WebsetsClient)ExaJSONEncoder)SearchMonitorsClientAsyncSearchMonitorsClient)ResearchClientAsyncResearchClientIS_BETATruei'c V^8dQhRRRR/#) snake_strstrreturn)formats"I/home/ubuntu/hermes-agent/venv/lib/python3.14/site-packages/exa_py/api.py __annotate__r07sFFcFcFcVR8XdR#VR8XdR#VPR4pV^,RPRVR,44,#) zConvert snake_case string to camelCase. Args: snake_str (str): The string in snake_case format. Returns: str: The string converted to camelCase format. schema_z$schemanot_not_c3@"TFqP4xK R#5iN)title).0xs& r/ !snake_to_camel..Gs"En7799ns:NN)splitjoin)r* componentss& r/snake_to_camelrC7sJIF%J a=277"Ejn"EE EEr1c$V^8dQhRRRRRR/#)r)datadict skip_keysz list[str]r,r-)r.s"r/r0r0Js!Dr1c \V\4'd\VP4UUu/uF>wr#VfK \V4\V\4'dW!9d \ W14MTbK@ upp#V#uuppi)z Convert keys in a dictionary from snake_case to camelCase recursively. Args: data (dict): The dictionary with keys in snake_case format. Returns: dict: The dictionary with keys converted to camelCase format. ) isinstancerFitemsrC to_camel_case)rErGkvs&& r/rKrKJsy$   %  N1 !T""q'9 -Q: %    K s A47A4c V^8dQhRRRR/#)r) camel_strr+r,r-)r.s"r/r0r0_s D Dc Dc Dr1c~\P!RRV4p\P!RRV4P4#)zConvert camelCase string to snake_case. Args: camel_str (str): The string in camelCase format. Returns: str: The string converted to snake_case format. z(.)([A-Z][a-z]+)z\1_\2z([a-z0-9])([A-Z]))resublower)rOr*s& r/camel_to_snakerT_s4)8Y?I 66%x ; A A CCr1c V^8dQhRRRR/#)r)rErFr,r-)r.s"r/r0r0lsr1c \V\4'dPVP4UUu/uF2wr\V4\V\4'd \ V4MTbK4 upp#V#uuppi)z Convert keys in a dictionary from camelCase to snake_case recursively. Args: data (dict): The dictionary with keys in camelCase format. Returns: dict: The dictionary with keys converted to snake_case format. )rIrFrJrT to_snake_case)rErLrMs& r/rWrWlsd$  $ 1 :a3F3F}Q/A M$   K  s8A(c V^8dQhRRRR/#)r) entities_datazOptional[List[dict]]r,zOptional[List]r-)r.s"r/r0r0~sw*w*#7w*Nw*r1c~aa a a a a aaaaaaaaaaV'gR#^RIHpHpHoHoHo Ho Ho Ho H o H oH oH oRV3RlloRV3RlloRVVV3RlloR V 3R lloR V V3R lloR V 3RlloRVV V VV3RllpRVV3Rllp.pVFpVPR4pVR8XdBVPV!VR,RVR,V!VPR/44R74K\VR8XgKeVPV!VR,RVR,V!VPR/44R74K V'dV#R#)z Parse entity data from API response into Entity dataclasses. Handles field mapping for reserved Python keywords: - 'from' -> 'from_date' - 'to' -> 'to_date' N) CompanyEntity PersonEntityEntityCompanyPropertiesEntityPersonProperties EntityCompanyPropertiesWorkforce#EntityCompanyPropertiesHeadquarters!EntityCompanyPropertiesFinancials#EntityCompanyPropertiesFundingRound!EntityCompanyPropertiesWebTrafficEntityDateRange EntityPersonPropertiesCompanyRef&EntityPersonPropertiesWorkHistoryEntryc V^8dQhRRRR/#)r)rEOptional[dict]r,Optional[EntityDateRange]r-)r.s"r/r0%_parse_entities..__annotate__s  ~ 2K r1ch<V'gR#S!VPR4VPR4R7#)Nfromto) from_dateto_dateget)rErds&r/parse_date_range)_parse_entities..parse_date_ranges-hhv&HHTN  r1c V^8dQhRRRR/#)r)rErhr,*Optional[EntityPersonPropertiesCompanyRef]r-)r.s"r/r0rjs   3] r1ch<V'gR#S!VPR4VPR4R7#)Nidname)rwrxrp)rEres&r/parse_company_ref*_parse_entities..parse_company_refs-/xx~&!  r1c V^8dQhRRRR/#)r)rErFr,rfr-)r.s"r/r0rjs  t 0V r1c <S!VPR4VPR4S!VPR44S!VPR44R7#)r:locationdatescompany)r:r}r~rrp)rErfryrrs&r/parse_work_history_entry1_parse_entities..parse_work_history_entrysJ5((7#XXj)"488G#45%dhhy&9:   r1c V^8dQhRRRR/#)r)rErhr,-Optional[EntityCompanyPropertiesFundingRound]r-)r.s"r/r0rjs  . 5b r1c<V'gR#S!VPR4VPR4VPR4R7#)Nrxdateamount)rxrrrp)rErbs&r/parse_funding_round,_parse_entities..parse_funding_rounds:2&!&!88H%  r1c V^8dQhRRRR/#)r)rErhr,+Optional[EntityCompanyPropertiesFinancials]r-)r.s"r/r0rjs  ~ 2] r1c <V'gR#S!VPR4VPR4S!VPR44R7#)N revenueAnnual fundingTotalfundingLatestRound)revenue_annual funding_totalfunding_latest_roundrp)rErars&r/parse_financials)_parse_entities..parse_financialss@088O4((>2!4TXX>R5S!T  r1c V^8dQhRRRR/#)r)rErhr,+Optional[EntityCompanyPropertiesWebTraffic]r-)r.s"r/r0rjs   3^ r1cH<V'gR#S!VPR4R7#)N visitsMonthly)visits_monthlyrp)rErcs&r/parse_web_traffic*_parse_entities..parse_web_traffics"088O4  r1c V^8dQhRRRR/#)r)rErFr,r]r-)r.s"r/r0rjs  t 0G r1c<VPR4pVPR4pS!VPR4VPR4VPR4V'dS!VPR4R7MRV'dIS!VPR4VPR 4VPR 4VPR 4R 7MRS!VPR 44S!VPR44R7#) workforce headquartersrx foundedYear descriptiontotalrNaddresscity postalCodecountry)rr postal_coder financials webTraffic)rx founded_yearrrrr web_trafficrp)rEworkforce_dataheadquarters_datar]r`r_rrs& r/parse_company_properties1_parse_entities..parse_company_propertiess+. HH^4&&!-0/]k6^=O=OPW=XYqu # =)--i8&**62-11,?)--i8  )-'(>?)$((<*@A  r1c V^8dQhRRRR/#)r)rErFr,r^r-)r.s"r/r0rjs  d /E r1c <VPR4pS!VPR4VPR4V'dVUu.uF pS!V4NK upR7#RR7#uupi) workHistoryrxr}N)rxr} work_historyrp)rErwhr^rs& r/parse_person_properties0_parse_entities..parse_person_propertiessgxx . %&!XXj)R^N2226N  ei  OsA! typerrwversion properties)rwrrrperson) exa_py.apir[r\r]r^r_r`rarbrcrdrerfrqappend)rYr[r\rrentities entity_data entity_typer]rarbr`rcr_rdr^rerfryrrrrrrs& @@@@@@@@@@@@@@@@r/_parse_entitiesr~s$                   $  H$ !oof- ) # OOMt$#I.3KOOLRT4UV   H $ OOLt$#I.2;??.sCNq=**NsTFzInvalid value for option 'z': z. Expected one of )rJ ValueErrorany)rrkeyexpected_typesrs&& @r/validate_search_optionsrsmmo U  0Q78 8 = !sCNCsssCNCCC,SEUG;MnM]^ &r1c\V4\JdV\V49#\V\4'd \W4#R#)F)rr rrIr)r expected_types&&r/rrs:- G+///-&&%// r1c V^8dQhRRRR/#)r)rawrFr,Optional[CostDollars]r-)r.s"r/r0r0sPPDP%:Pr1cV'gR#VPR4pVfR#VPR4pVPR4p\WVR7#)zZ Parse the costDollars JSON into a CostDollars object, or return None if missing/invalid. Nrsearchr)rrr)rq CostDollars)rr search_part contents_parts& r/parse_cost_dollarsr sK  GGG E }''(#KGGJ'M U OOr1cN]tRtRt$RtR]R&R]R&R]R&R ]R &R ]R &R tR #)TextContentsOptionsia A class representing the options that you can specify when requesting text Attributes: max_characters (int): The maximum number of characters to return. Default: None (no limit). include_html_tags (bool): If true, include HTML tags in the returned text. Default false. verbosity (VERBOSITY_OPTIONS): Controls verbosity level of returned content. "compact" (default): main content only; "standard": balanced; "full": all sections. Requires max_age_hours=0 to take effect. include_sections (List[SECTION_TAG]): Only include content from these semantic sections. Requires max_age_hours=0 to take effect. exclude_sections (List[SECTION_TAG]): Exclude content from these semantic sections. Requires max_age_hours=0 to take effect. intmax_charactersboolinclude_html_tagsVERBOSITY_OPTIONS verbosityzList[SECTION_TAG]include_sectionsexclude_sectionsr-Nrr-r1r/r r s'   ''''r1r c]tRtRt$RtR]R&R]R&R]R&R]R&R ]R &R ]R &R ]R&R]R&R]R&R ]R&R ]R&R]R&R]R&R]R&R]R&RtR#) JSONSchemaiaRepresents a JSON Schema definition used for structured summary output. .. deprecated:: 1.15.0 Use Pydantic models or dict[str, Any] directly instead. This will be removed in a future version. To learn more visit https://json-schema.org/overview/what-is-jsonschema. r+r3r:rzLLiteral['object', 'array', 'string', 'number', 'boolean', 'null', 'integer']rzDict[str, JSONSchema]rz#Union[JSONSchema, List[JSONSchema]]rJrrr enumzUnion[bool, JSONSchema]additionalProperties definitionspatternPropertieszList[JSONSchema]allOfanyOfoneOfr4r-Nrr-r1r/rrs`L J VV%% .. J11&&,,    r1rc0]tRtRt$RtR]R&R]R&RtR#) SummaryContentsOptionsiaxA class representing the options that you can specify when requesting summary Attributes: query (str): The query string for the summary. Summary will bias towards answering the query. schema (Union[BaseModel, dict[str, Any]]): JSON schema for structured output from summary. Can be a Pydantic model (automatically converted) or a dict containing JSON Schema. r+rrschemar-Nrr-r1r/r r s J r1r cD]tRtRt$RtR]R&R]R&R]R&R]R&R tR #) HighlightsContentsOptionsiaA class representing the options that you can specify when requesting highlights. Attributes: query (str): The query string for highlight generation. Highlights will be biased towards this query. max_characters (int): The maximum number of characters to return for highlights. Default: None (server default). num_sentences (int): Deprecated. Use max_characters instead. The number of sentences per highlight. highlights_per_url (int): Deprecated. Use max_characters instead. The number of highlights to return per URL. r+rrr num_sentenceshighlights_per_urlr-Nrr-r1r/r#r#s  Jr1r#c&]tRtRt$RtR]R&RtR#)ContextContentsOptionsi aAOptions for retrieving aggregated context from a set of search results. .. deprecated:: Use ``highlights`` or ``text`` instead. The ``context`` option is deprecated and will be removed in a future version. Attributes: max_characters (int): The maximum number of characters to include in the context string. rrr-Nrr-r1r/r'r' sr1r'c0]tRtRt$RtR]R&R]R&RtR#) ExtrasOptionsizFA class representing additional extraction fields (e.g. links, images)rlinks image_linksr-Nrr-r1r/r)r)sP Jr1r)c]tRtRt$RtR]R&R]R&R]R&R ]R &R ]R &R ]R&R ]R&R ]R&R]R&R]R&RtR#)ContentsOptionsi"aWOptions for retrieving page contents in search and find_similar methods. All fields are optional. If no content options are specified, text with max_characters=10000 is returned by default. Attributes: text (TextContentsOptions | True): Options for text extraction, or True for defaults. highlights (HighlightsContentsOptions | True): Options for highlight extraction, or True for defaults. summary (SummaryContentsOptions | True): Options for summary generation, or True for defaults. context (ContextContentsOptions | True): Deprecated. Use ``highlights`` or ``text`` instead. Will be removed in a future version. max_age_hours (int): Maximum age of cached content in hours. If content is older, it will be fetched fresh. Special values: 0 = always fetch fresh content, -1 = never fetch fresh (use cached content only). Example: 168 = fetch fresh for pages older than 7 days. subpages (int): Number of subpages to crawl. subpage_target (str | List[str]): Target subpage path(s) to crawl. extras (ExtrasOptions): Additional extraction options (links, images). )Union[TextContentsOptions, Literal[True]]rz/Union[HighlightsContentsOptions, Literal[True]]r,Union[SummaryContentsOptions, Literal[True]]rz,Union[ContextContentsOptions, Literal[True]]rLIVECRAWL_OPTIONSrrrrrzUnion[str, List[str]]rr)rr-Nrr-r1r/r-r-"sD$ 43?? 99 99  M)) r1r-c0]tRtRt$RtR]R&R]R&RtR#)CostDollarsSearchiAz)Represents the cost breakdown for search.floatneuralkeywordr-Nrr-r1r/r2r2As3 M Nr1r2c0]tRtRt$RtR]R&R]R&RtR#)CostDollarsContentsiHz+Represents the cost breakdown for contents.r3rrr-Nrr-r1r/r7r7Hs5 K Nr1r7cB]tRtRt$RtR]R&RtR]R&RtR]R &R tR#) riOz1Represents costDollars field in the API response.r3rNr2rr7rr-) rrrrrrrrrr-r1r/rrOs ; L $F $$(H!(r1rc*]tRtRt$RtRtR]R&RtR#)r_i\zCompany workforce information.N Optional[int]rr-)rrrrrrrrr-r1r/r_r_\s(E=r1r_cT]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R]R&R t R#) r`icz!Company headquarters information.N Optional[str]rrrrr-) rrrrrrrrrrrr-r1r/r`r`cs-+!G]!D-!%K%!G]!r1r`cF]tRtRt$RtRtR]R&RtR]R&RtR]R&R t R#) rbimzFunding round information.Nr<rxrr:rr-) rrrrrrxrrrrr-r1r/rbrbms#$D-D- FM r1rbcF]tRtRt$RtRtR]R&RtR]R&RtR]R&R t R#) raivzCompany financial information.Nr:rrrrr-) rrrrrrrrrrr-r1r/raravs%($(NM(#'M='JNGNr1rac*]tRtRt$RtRtR]R&RtR#)rciz Company web traffic information.Nr:rr-)rrrrrrrrr-r1r/rcrcs*$(NM(r1rcc~]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R ]R &Rt R ]R &Rt R ]R&Rt R]R&Rt R#)r]iz+Structured properties for a company entity.Nr<rxr:rrz*Optional[EntityCompanyPropertiesWorkforce]rz-Optional[EntityCompanyPropertiesHeadquarters]rrrrrr-)rrrrrrxrrrrrrrrr-r1r/r]r]sO5D-"&L-&!%K%<@I9@BFL?F>BJ;B?CK<Cr1r]c8]tRtRt$RtRtR]R&RtR]R&RtR#)rdiz$Date range for work history entries.Nr<rnror-) rrrrrrnrrorr-r1r/rdrds.#I}#!G]!r1rdc8]tRtRt$RtRtR]R&RtR]R&RtR#)reiz'Reference to a company in work history.Nr<rwrxr-) rrrrrrwrrxrr-r1r/reres1B D-r1recT]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R ]R &R t R#) rfiz)A single work history entry for a person.Nr<r:r}rir~rurr-) rrrrrr:rr}r~rrr-r1r/rfrfs/3E="Hm"'+E $+:>G 7>r1rfcF]tRtRt$RtRtR]R&RtR]R&RtR]R&R t R#) r^iz*Structured properties for a person entity.Nr<rxr}z6Optional[List[EntityPersonPropertiesWorkHistoryEntry]]rr-) rrrrrrxrr}rrr-r1r/r^r^s$4D-"Hm"KOLHOr1r^cD]tRtRt$RtR]R&R]R&R]R&R ]R &R tR #) r[iz%Structured entity data for a company.r+rwzLiteral['company']rrrr]rr-Nrr-r1r/r[r[s/ G  L''r1r[cD]tRtRt$RtR]R&R]R&R]R&R ]R &R tR #) r\iz$Structured entity data for a person.r+rwzLiteral['person']rrrr^rr-Nrr-r1r/r\r\s. G  L&&r1r\c]tRtRt$RtR]R&R]R&RtR]R&RtR ]R &RtR]R &Rt R]R &Rt R]R &Rt R]R&Rt R]R&Rt R]R&RtR]R&RRltRtRtR#)_ResultiaDA class representing the base fields of a search result. Attributes: title (str): The title of the search result. url (str): The URL of the search result. id (str): The temporary ID for the document. score (float, optional): A number from 0 to 1 representing similarity. published_date (str, optional): An estimate of the creation date, from parsing HTML content. author (str, optional): The author of the content (if available). image (str, optional): A URL to an image associated with the content (if available). favicon (str, optional): A URL to the favicon (if available). subpages (List[_Result], optional): Subpages of main page extras (Dict, optional): Additional metadata; e.g. links, images. entities (List[Entity], optional): Structured entity data for company or person searches. r+rrwNr<r:Optional[float]scorepublished_dateauthorimagefaviconzOptional[List[_Result]]rzOptional[Dict]rzOptional[List[Entity]]rc  WnW nW0nW@nWPnW`nWpnWnWnWn Wn R#r9) rrwr:rJrKrLrMrNrrr) selfrrwr:rJrKrLrMrNrrrs &&&&&&&&&&&&r/__init___Result.__init__s<  ,      r1c RVP RVP RVP RVP RVP RVP RVP RVP RVP R VP R 2pVP'd0R PR VP44pVR V R 2, pV#) Title:  URL:  ID: z Score:  Published Date: Author: z Image: z Favicon: z Extras: z Subpages:  c3"TF5pRVP RVPP;'gR 2xK7 R#5i)z - [z] UnknownN)rrrx)r;es& r/r="_Result.__str__..s;%&Axr!,,"3"3"@"@y!AB&s/? ?z Entities: ) r:rrwrJrKrLrMrNrrrrA)rPresult entities_strs& r/__str___Result.__str__sdjj\"HH:77)jj\"#2234{{m$jj\" ~&{{m$r +  ===99%%L  L>4 4F r1) rLrrrNrwrMrKrJrr:r) NNNNNNNNN)rrrrrrr:rJrKrLrMrNrrrrQr`rr-r1r/rHrHsy H GE=!E?!$(NM( FM E=!G]!(,H%,!FN!'+H$+!4r1rHcva]tRtRt$RtRtR]R&RtR]R&RtR]R&Rt R ]R &RV3R llt V3R lt R t V;t #)Resultiae A class representing a search result with optional text, summary, and highlights. Attributes: text (str, optional): The text content of the page. summary (str, optional): A summary of the page content. highlights (List[str], optional): Relevant sentences from the page. highlight_scores (List[float], optional): Scores for each highlight. Nr<rrOptional[List[str]]rzOptional[List[float]]highlight_scoresc  j<\SV`VVVVVVVVV V V 4 WnWnWnWnR#r9)superrQrrrre)rPrrwr:rJrKrLrMrNrrrrrrre __class__s&&&&&&&&&&&&&&&&r/rQResult.__init__,sJ$               $ 0r1c <\SV`4pVRVP RVP R2,pVP'dVRVP R2, pVP 'dVRVP R2, pV#)Text: z Summary: rYz Highlights: zHighlight Scores: )rgr`rrrre)rPbase_strr^rhs& r/r`Result.__str__Ps}7?$fTYYK{4<<.KK ???  T__$5R8 8F  *4+@+@*AD DF r1)rerrr) NNNNNNNNNNNNN)rrrrrrrrrrerQr`r __classcell__rhs@r/rcrcsED-!G]!&*J#*.2+2"1Hr1rccna]tRtRt$Rt]P !]R7tR] R&R V3Rllt V3Rlt Rt V;t #) ResultWithTextiZzz A class representing a search result with text present. Attributes: text (str): The text of the search result page. default_factoryr+rc  F<\S V`VVVVVVVVV V V 4 WnR#r9)rgrQr)rPrrwr:rJrKrLrMrNrrrrrhs&&&&&&&&&&&&&r/rQResultWithText.__init__es:              r1c N<\SV`4pVRVP R2,#)rkrY)rgr`rrPrlrhs& r/r`ResultWithText.__str__s'7?$F499+R000r1)r NNNNNNNNNr7)rrrrr dataclassesfieldr+rrrQr`rrnros@r/rqrqZs.!!#6D#6<11r1rqcna]tRtRt$Rt]P !]R7tR] R&R V3Rllt V3Rlt Rt V;t #) ResultWithSummaryiz[ A class representing a search result with summary present. Attributes: summary (str) rrr+rc  F<\S V`VVVVVVVVV V V 4 WnR#r9)rgrQr)rPrrwr:rJrKrLrMrNrrrrrhs&&&&&&&&&&&&&r/rQResultWithSummary.__init__s:              r1c N<\SV`4pVRVP R2,#) Summary: rY)rgr`rrws& r/r`ResultWithSummary.__str__s'7?$Idll^2666r1)rry)rrrrrrzr{r+rrrQr`rrnros@r/r}r}s.$$S9GS9<77r1r}ca]tRtRt$Rt]P !]R7tR] R&]P !]R7t R] R&R V3Rllt V3Rlt R t V;t#) ResultWithTextAndSummaryizs A class representing a search result with text and summary present. Attributes: text (str) summary (str) rrr+rrc  R<\SV`VVVVVVVVV V V 4 WnWnR#r9)rgrQrr)rPrrwr:rJrKrLrMrNrrrrrrhs&&&&&&&&&&&&&&r/rQ!ResultWithTextAndSummary.__init__s?               r1c x<\SV`4pVRVP R2,RVP R2,#)rkrYr)rgr`rrrws& r/r` ResultWithTextAndSummary.__str__s97?$F499+R00Yt||nB3OOOr1)rr) NNNNNNNNNr7r7)rrrrrrzr{r+rrrrQr`rrnros@r/rrsF!!#6D#6$$S9GS9@PPr1rcx]tRtRt$RtR]R&R]R&RtR]R&RtR]R &RtR]R &Rt R]R &RR lt R t Rt R#) AnswerResultiaA class representing a result for an answer. Attributes: title (str): The title of the search result. url (str): The URL of the search result. id (str): The temporary ID for the document. published_date (str, optional): An estimate of the creation date, from parsing HTML content. author (str, optional): If available, the author of the content. text (str, optional): The full page text from each search result. r+rwrNr<r:rKrLrc NWnW nW0nW@nWPnW`nR#r9rwrr:rKrLr)rPrwrr:rKrLrs&&&&&&&r/rQAnswerResult.__init__s# ,  r1c  RVP RVP RVP RVP RVP RVP R2 #)rTrUrVrWrX Text:  )r:rrwrKrLrrPs&r/r`AnswerResult.__str__sbdjj\"HH:77)#2234{{m$YYKt  % r1)rLrwrKrr:r)NNNN) rrrrrrr:rKrLrrQr`rr-r1r/rrsE  G HE=$(NM( FM D- r1rcP]tRtRt$RtRtR]R&RtR]R&RR ltR R lt R t R#) StreamChunkizA class representing a single chunk of streaming data. Attributes: content (Optional[str]): The partial text content of the streamed response. citations (Optional[List[AnswerResult]]): List of citations if provided in this chunk. Nr<contentzOptional[List[AnswerResult]] citationscV^8dQhRR/#)r)r,rr-)r.s"r/r0StreamChunk.__annotate__sFF$Fr1c JVPRJ;'gVPRJ#)z&Check if this chunk contains any data.Nrrrs&r/has_dataStreamChunk.has_datas"||4'EE4>>+EEr1cV^8dQhRR/#)r)r,r+r-)r.s"r/r0r!s   r1c RpVP'dWP, pVP'd)VR, pVPFpVRV 2, pK V#)z"Format the chunk data as a string.r7z Citations:rYrrPoutputsources& r/r`StreamChunk.__str__!sR <<< ll "F >>> n $F..Bvh-') r1r-) rrrrrrrrrr`rr-r1r/rrs."G]!.2I+2F  r1rcD]tRtRt$RtR]R&R]R&RtR]R &R tR tR#) AnswerResponsei-aA class representing the response for an answer operation. Attributes: answer (str): The generated answer. citations (List[AnswerResult]): A list of citations used to generate the answer. cost_dollars (CostDollars, optional): The cost breakdown for this request. Union[str, dict[str, Any]]answerzList[AnswerResult]rNr cost_dollarsc fRVP R2pVPFpVRVP 2, pVRVP 2, pVRVP 2, pVRVP 2, pVRVP 2, pVRVP 2, pVR, pK V#) zAnswer: z Citations:z Title: rVrUrWrXrrY)rrr:rwrrKrLrrs& r/r`AnswerResponse.__str__;sDKK=7nnF  &,,0 0F vyyk* *F  |, ,F *6+@+@*AB BF  6==/2 2F  . .F dNF% r1r-) rrrrrrrr`rr-r1r/rr-s% '&!!*.L'. r1rcD]tRtRtRtRRltRtRRltRR ltR t R #) StreamAnswerResponseiH1A class representing a streaming answer response.cV^8dQhRR/#)r) raw_responsezrequests.Responser-)r.s"r/r0!StreamAnswerResponse.__annotate__Ks!!%6!r1c 2WnVP4R#r9 _raw_response_ensure_ok_statusrPrs&&r/rQStreamAnswerResponse.__init__K)  r1c VPP^8wd:\RVPP RVPP 24hR# Request failed with status code : Nr status_coderrrs&r/r&StreamAnswerResponse._ensure_ok_statusOT    ) )S 0243E3E3Q3Q2RRTUYUgUgUlUlTmn  1r1cV^8dQhRR/#)r)r,zIterator[StreamChunk]r-)r.s"r/r0rUs&#&#/&#r1c# "VPP4EF~pV'gKVPR4PR4p\P !V4pRpRpRT9dKTR,'d<RTR,^,9d'TR,^,R,PR4pRT9dTR,'dTR,R8wd.pTR,Fp\T4pTP\TPR4TPR 4TPR 4TPR 4TPR 4TPR 4R74K \YER7pTP4'gEKzTxEK R# \P dEKi;i5i)zutf-8data: Nchoicesdeltarrnullrwrr:rKrLrrr) r iter_linesdecode removeprefixjsonloadsJSONDecodeErrorrqrWrrrr) rPline decoded_linechunkrrssnake_s stream_chunks & r/__iter__StreamAnswerResponse.__iter__Us|&&113D;;w/<>yIGu$+&&+&&0 {++A+A.G$$$&{{40 ' E 2")++g"6+2;;7G+H#*;;x#8!(V!4  ,'wLL$$&&""K4 ''  s>A F? F""F?]tRtRtRtRRltRtRtRRltR t R #) AsyncStreamAnswerResponseircV^8dQhRR/#)r)rzhttpx.Responser-)r.s"r/r0&AsyncStreamAnswerResponse.__annotate__s!!^!r1c 2WnVP4R#r9rrs&&r/rQ"AsyncStreamAnswerResponse.__init__rr1c VPP^8wd:\RVPP RVPP 24hR#rrrs&r/r+AsyncStreamAnswerResponse._ensure_ok_statusrr1c aV3RlpV!4#)cz<"SPP4RjxL pV'gKVPR4p\P!V4pRpRpRT9dKTR,'d<RTR,^,9d'TR,^,R,P R4pRT9dTR,'dTR,R8wd.pTR,Fp\T4pTP\TP R4TP R4TP R 4TP R 4TP R 4TP R 4R 74K \Y4R7pTP4'gEKqT5xEKyELu \P dEKi;iEDR#5i)Nrrrrrrrwrr:rKrLrrr) r aiter_linesrrrrrqrWrrrr) rrrrrrrrrPs r/ generator6AsyncStreamAnswerResponse.__aiter__..generators"00<<>% '% 'd#00:  JJ|4E %% *:*:% "21"55"' "21"5g">"B"B9"M 5(k**k*f4 "I";//"/"2!(((#*;;t#4$+KK$6&-kk'&:/6{{;K/L'.{{8'<%,[[%8  0 +7P ((**&&K% ' ++ ?sWF;F7FF7F;FF;4AF;CF;F;F7F4/F;3F44F;r-)rPrsf r/ __aiter__#AsyncStreamAnswerResponse.__aiter__s& 'P{r1cV^8dQhRR/#rr-)r.s"r/r0rrr1c :VPP4R#rrrs&r/rAsyncStreamAnswerResponse.closerr1rN) rrrrrrQrrrrr-r1r/rrs;! )V##r1rc]tRtRtRtRtR#)StreamSearchResponsei1A class representing a streaming search response.r-Nrrrrrrr-r1r/rr;r1rc]tRtRtRtRtR#)AsyncStreamSearchResponseirr-Nrr-r1r/rrrr1rTc:]tRtRt$RtR]R&R]R&R]R&RtR#) ContentStatusizAA class representing the status of a content retrieval operation.r+rwstatusrr-Nrr-r1r/rrsK G K Kr1rc]tRtRt$RtR]R&R]R&R]R&RtR]R &RtR ]R &RtR ]R &Rt R]R&Rt R]R&Rt Rt R#)SearchResponseiaA class representing the response for a search operation. Attributes: results (List[Result]): A list of search results. resolved_search_type (str, optional): 'neural' or 'keyword' if auto. auto_date (str, optional): A date for filtering if autoprompt found one. context (str, optional): Deprecated. Combined context string when requested via contents.context. Use highlights or text instead. output (DeepSearchOutput, optional): Search synthesized output object returned when output_schema is provided, containing content and field-level grounding. statuses (List[ContentStatus], optional): Status list from get_contents. cost_dollars (CostDollars, optional): Cost breakdown. search_time (float, optional): Time taken for the search in milliseconds. zList[T]resultsr<resolved_search_type auto_dateNrzOptional['DeepSearchOutput']rzOptional[List[ContentStatus]]statusesrrrI search_timec RPRVP44pVP'dVRVP 2, pVPeVRVP 2, pVP'dVRVP 2, pVP eVRVP R2, pVP 'dVRVP P 2, pVP P'd!VRVP P 2, pVP P'd!VR VP P 2, pVP'dVR VP 2, pV#) rc38"TFp\V4xK R#5ir9)r+)r;r^s& r/r=)SearchResponse.__str__..sD|VS[[|sz Context: z Output: z Resolved Search Type: z Search Time: msz CostDollars: total=z - search: z - contents: z Statuses: ) rArrrrrrrrrr)rPrs& r/r`SearchResponse.__str__sQDt||DD <<<  DLL>2 2F ;; "  4;;-0 0F  $ $ $ 01J1J0KL LF    ' (8(8'9< ->-G-G,HII ===  T]]O4 4F r1r-) rrrrrrrrrrrr`rr-r1r/rrsU ''!G]!+/F (/.2H+2*.L'.#'K'r1rc0]tRtRt$RtR]R&R]R&RtR#)!DeepSearchOutputGroundingCitationiz0Citation metadata for one grounded output field.r+rr:r-Nrr-r1r/rrs: H Jr1rc:]tRtRt$RtR]R&R]R&R]R&R tR #) DeepSearchOutputGroundingiz>Grounding metadata for one field in search synthesized output.r+r{z'List[DeepSearchOutputGroundingCitation]r#DeepSearchOutputGroundingConfidence confidencer-Nrr-r1r/r r sH J6633r1r c0]tRtRt$RtR]R&R]R&RtR#) DeepSearchOutputiz"Search synthesized output payload.rrzList[DeepSearchOutputGrounding] groundingr-Nrr-r1r/rrs, ''..r1rc V^8dQhRRRR/#)r)rrr,zOptional[DeepSearchOutput]r-)r.s"r/r0r0s=B=B#=B*D=Br1c \V\4'gR#VPR4p\V\4'dTpM\V\4'dTpMRp.pVPR4p\V\4'Ed<VEF4p\V\4'gKVPR4p\V\4'gKE.pVPR4p\V\4'dVFp \V \4'gKV PR4p V PR4p \V \4'gKUTP \ T \V \4'dT MRR 74K VPR 4p V R9dR p VP \VVV R 74EK7 \W#R 7#)zParse search output into a typed object. Args: raw: Raw `output` field from API response. Returns: Parsed DeepSearchOutput when the payload is an object, otherwise None. Nrr7rr{rrr:)rr:r medium)r{rr )rrlowrhigh) rIrFrqr+listrrr r) r raw_contentrr raw_grounding grounding_rowr{r raw_citationscitationrr:r s & r/parse_deep_search_outputrs c4 '')$K+s##.9 K & &13IGGK(M-&&*MmT22!%%g.EeS))ACI)--k:M-.. -H%h55 ",,u-C$LL1E%c3// $$9 #+5eS+A+A%r!.'**<8J!::%   )') ;+J G AAr1c$V^8dQhRRRRRR/#)r) original_dictrfields_to_nestrnew_keyr+r-)r.s"r/r0r0_s!tYr1cZ/pVFpW@9gK VPV4W4&K W0V&V#r9)pop)rrr  nested_dictr{s&&& r/ nest_fieldsr$_s<K   !!.!2!25!9K   )' r1c']tRtRtRtRORRlltRPRRlltRR R RR RR RR RRRRRRRRRRRRRRRRRRRRRRRRRRRRR/RRlltR RR RR RR RRRRRRRRRRRRRRRRRRRRRRRRRRRRR/RRlltR R!lt ] RQR"R#ll4t ] R$RR%RR&RR'RR(RR)RR*RRR/R+R,ll4t ] R$RR%RR&RR'RR(RR)RR*RRR/R-R.ll4t ] R$RR%RR&RR'RR(RR)RR*RRR/R/R0ll4t R1R2lt R RR RR RR RRRRRRRRRRRRRR3RRRRR/ R4R5llt ] R RR RR RRRRRRRRRRRRRR3RRRRRR$RR%RR&RR'RR(RR)RR*R/R6R7ll4t ] R RR RR RRRRRRRRRRRRRR3RRRRRR$RR%RR&RR'RR(RR)RR*R/R8R9ll4t ] R RR RR RRRRRRRRRRRRRR3RRRRRR$RR%RR&RR'RR(RR)RR*R/R:R;ll4t ] R RR RR RRRRRRRRRRRRRR3RRRRRR$RR%RR&RR'RR(RR)RR*R/R<R=ll4t ] R RR RR RRRRRRRRRRRRRR3RRRRRR$RR%RR&RR'RR(RR)RR*R/R>R?ll4t R@RAlt RBRCltRDRElt] RR RFR RRRGRRRRR/RHRIll4tRR RFR RRRGRRRRR/RJRKlltRFR RRRGRRRRR/RLRMlltRNtR#)RExaipz&A client for interacting with Exa API.Nc$V^8dQhRRRRRR/#)r)api_keyr<base_urlr+ user_agentr-)r.s"r/r0Exa.__annotate__ss($3$3$3$3" $3r1c Vf/^RIpVPPR4pVf \R4hVfR\ 4 2pW nRVRVRR/Vn\V4Vn\V4Vn \V4Vn R#) aVInitialize the Exa client with the provided API key and optional base URL and user agent. Args: api_key (str): The API key for authenticating with the Exa API. base_url (str, optional): The base URL for the Exa API. Defaults to "https://api.exa.ai". user_agent (str, optional): Custom user agent. Defaults to "exa-py {version}". N EXA_API_KEYzNAPI key must be provided as an argument or in EXA_API_KEY environment variablezexa-py/z x-api-keyz User-Agentz Content-Typezapplication/json) osenvironrqrrr)headersr websetsr$researchr"monitors)rPr(r)r*r.s&&&& r/rQ Exa.__init__ss ? jjnn]3G d  "#7#9":;J  * .  %T* &t, ,T2 r1c 0V^8dQhRRRRRRRRRR R R /#) r)endpointr+rEz$Optional[Union[Dict[str, Any], str]]methodparamszOptional[Dict[str, Any]]r0Optional[Dict[str, str]]r,z(Union[Dict[str, Any], requests.Response]r-)r.s"r/r0r+sNQQQ3Q Q ) Q * Q 2Qr1c \V\4'dTpM&V'd\P!V\R7MRpT;'d2\V\ 4;'dVP R4;'gT;'dVP R4R8Hp/VPCpV'dVPV4VP4R8XdaV'd.\P !VPV,VVRR7p V #\P !VPV,WR7p EMVP4R 8Xd`V'd.\P!VPV,VVRR 7p V #\P!VPV,WhR 7p MVP4R 8Xd+\P!VPV,WhR 7p MMVP4R 8Xd+\P!VPV,VR7p M\RV 24hV P R8d&\RV P RV P" 24hV P4#)aSend a request to the Exa API, optionally streaming if data['stream'] is True. Args: endpoint (str): The API endpoint (path). data (dict, optional): The JSON payload to send. Defaults to None. method (str, optional): The HTTP method to use. Defaults to "POST". params (Dict[str, Any], optional): Query parameters to include. Defaults to None. headers (Dict[str, str], optional): Additional headers to include in the request. Defaults to None. Returns: Union[dict, requests.Response]: If streaming, returns the Response object. Otherwise, returns the JSON-decoded response as a dict. Raises: ValueError: If the request fails (non-200 status code). )clsNrtrueGETT)r0r8r)r0r8POST)rEr0r)rEr0PATCHDELETEr0Unsupported HTTP method: irr)rIr+rdumpsr!rFrqr0updateupperrequestsr)postpatchdeleterrr) rPr6rEr7r8r0 json_dataneeds_streamingrequest_headersress &&&&&& r/request Exa.requests2 dC IAE 4^<$I QQJtT$:QQtxx?Q   5 5vzz(+v5  +T\\*   " "7 + <<>U "llMMH,+!   llMMH,o\\^v %mmMMH,"+   mmMMH,9\\^w &.. (yC\\^x '//$--(":OTC8AB B ??c !23??2C2chhZP xxzr1rFrrrrrrrrrrrrrrrrrrc*lV^8dQhRRRRRRRRR R R R R R RR RR RR RR RR RRRRRR RRRR RR RR RRRR/# r)rr+rOptional[bool]r0Optional[Union[ContentsOptions, Literal[False]]]rr:rrdrrr<rrrrrr Optional[Union[SearchType, str]]rOptional[Category]rrrrrrOptional[DeepOutputSchema]r,SearchResponse[Result]r-)r.s"r/r0r+sM M M  M C M # M -M -M (M &M ,M *M *M *M /M %!M "##M $#%M &%'M (0)M *%+M ,2-M . /M r1c V'd \R4h\4P4UUu/uFwppVR8wgKVfKVVbK pppVPRR4VRJdVPRR4M"VfRV9dRR\//VR&M VeVVR&\ V\ 4\VR .R 7pVPR V4p\VPR 44p.pVR ,EF"p\V4pVP\VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4\VPR44R74EK% \TRV9d VR,MRRV9d VR,MRVPR4\!VPR 44VVPR!4R"7#uuppi)#a] Perform a search. By default, returns text contents with 10,000 max characters. Use contents=False to opt-out. Args: query (str): The query string. stream (bool, optional): If True, stream the synthesized search response. Use ``stream_search(...)`` instead of ``search(..., stream=True)``. contents (ContentsOptions | False, optional): Options for retrieving page contents. Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents. See ContentsOptions for available options (text, highlights, summary, etc.). Note: The ``context`` option is deprecated; use ``highlights`` or ``text`` instead. num_results (int, optional): Number of search results to return. Default 10. include_domains (List[str], optional): Domains to include in the search. exclude_domains (List[str], optional): Domains to exclude from the search. start_crawl_date (str, optional): Only links crawled after this date. end_crawl_date (str, optional): Only links crawled before this date. start_published_date (str, optional): Only links published after this date. end_published_date (str, optional): Only links published before this date. include_text (List[str], optional): Strings that must appear in the page text. exclude_text (List[str], optional): Strings that must not appear in the page text. type (SearchType, optional): Search type - 'auto' (default), 'fast', 'deep-lite', 'deep', 'deep-reasoning', 'neural', or 'instant'. category (Category, optional): Data category to focus on (e.g. 'company', 'news', 'research paper'). flags (List[str], optional): Experimental flags for Exa usage. moderation (bool, optional): If True, the search results will be moderated for safety. user_location (str, optional): Two-letter ISO country code of the user (e.g. US). additional_queries (List[str], optional): Alternative query formulations for deep search to skip automatic LLM-based query expansion. Max 5 queries. Only applicable when type is 'deep-lite', 'deep', or 'deep-reasoning'. Example: ["machine learning", "ML algorithms", "neural networks"] system_prompt (str, optional): Instructions that guide both the search process and the final returned result. Use this to prefer certain sources, emphasize novelty, avoid duplicates, or constrain the response style. Supported for all search types. output_schema (DeepOutputSchema, optional): Search output schema for structured synthesis. When provided, the API returns synthesized output in ``output``. Use ``{"type": "text", "description": ...}`` for plain text output or ``{"type": "object", "properties": ..., "required": ...}`` for structured JSON. For object schemas, max nesting depth is 2 and max total properties is 10. Supported for all search types. Returns: SearchResponse: The response containing search results, etc. Raises: ValueError: If stream=True is provided. Use stream_search() instead. Examples: # Basic search result = exa.search( "hottest AI startups", num_results=2, contents={"highlights": True} ) # Deep search with query variations deep_result = exa.search( "blog post about AI", type="deep", additional_queries=["AI blogpost", "machine learning blogs"], num_results=5 ) Zstream=True is not supported in `search()`. Please use `stream_search(...)` for streaming.rPNrFrrrrrG/search costDollarsrrrwr:rJrKrLrMrNrrrrrerrrwr:rJrKrLrMrNrrrrrrerresolvedSearchTypeautoDaterr searchTimerrrr)rlocalsrJr"DEFAULT_MAX_CHARACTERSrSEARCH_OPTIONS_TYPESrKrNr rqrWrrcrrrrPrrrrrrrrrrrrrrrrrrrrrLrMrrErrr^ snake_results&&$$$$$$$$$$$$$$$$$$$ r/r Exa.searchsXn A  %+HNN$4V$4DAqV 441a4$4V Hd# u  KK D )  *G";#),<>T+U"VGJ   !"*GJ )=>O3DE||Iw/)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &* *>$*FD% &D *d 2D HHY'+DHHX,>?%.  QWs JJJc(hV^8dQhRRRRRRRRR RR R R R R R RR RRRRRRRRRRRRRR RRRR RRRR/#)r)rr+rrSrr:rrdrrr<rrrrrrrTrrUrrrRrrrrrVr,rr-)r.s"r/r0r+{sK2K2K2C K2 # K2 - K2-K2(K2&K2,K2*K2*K2*K2/K2%K2 #!K2"##K2$%%K2&0'K2(%)K2*2+K2, -K2r1c |\4P4UUu/uFwppVR8wgKVfKVVbK pppVRJdVPRR4M"VfRV9dRR\//VR&M VeVVR&\ V\ 4\ VR.R7pR VR &VPR V4p\V4#uuppi) a%Generate a streaming search response. Args: query (str): The query string. contents (ContentsOptions | False, optional): Options for retrieving page contents. Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents. num_results (int, optional): Number of search results to return. Default 10. include_domains (List[str], optional): Domains to include in the search. exclude_domains (List[str], optional): Domains to exclude from the search. start_crawl_date (str, optional): Only links crawled after this date. end_crawl_date (str, optional): Only links crawled before this date. start_published_date (str, optional): Only links published after this date. end_published_date (str, optional): Only links published before this date. include_text (List[str], optional): Strings that must appear in the page text. exclude_text (List[str], optional): Strings that must not appear in the page text. type (SearchType, optional): Search type - 'auto' (default), 'fast', 'deep-lite', 'deep', 'deep-reasoning', 'neural', or 'instant'. category (Category, optional): Data category to focus on. flags (List[str], optional): Experimental flags for Exa usage. moderation (bool, optional): If True, the search results will be moderated for safety. user_location (str, optional): Two-letter ISO country code of the user (e.g. US). additional_queries (List[str], optional): Alternative query formulations for deep search. system_prompt (str, optional): Instructions that guide the search process and streamed synthesis. output_schema (DeepOutputSchema, optional): Search output schema for structured synthesis. Returns: StreamSearchResponse: An iterator yielding OpenAI-style streaming chunks with partial ``content`` and optional ``citations``. Examples: stream = exa.stream_search( "What are the latest battery breakthroughs?", type="auto" ) for chunk in stream: if chunk.content: print(chunk.content, end="", flush=True) rPNFrrrrrZTrr[) rbrJr"rcrrdrKrNrrPrrrrrrrrrrrrrrrrrrrrLrMrrs&&$$$$$$$$$$$$$$$$$$ r/ stream_searchExa.stream_search{s|%+HNN$4V$4DAqV 441a4$4V u  KK D )  *G";#),<>T+U"VGJ   !"*GJ )=>O3DE ||Iw7 #L11Ws B8B8B8cV^8dQhRR/#r)rr+r-)r.s"r/r0r+sT T T r1c |RV/pVP4FwrEVfK WSV&K RV9dRV9dRV9d R\/VR&/pVP\4VP\4VP\ 4\ W64RV9dC\VR,\4'd&VR,pRV9d\VR,4VR&\V.ROR 4p\VR.R 7pVPR V4p\VPR 44p .p VR,EF"p \V 4p V P!\#V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR 4V PR4V PR4V PR4V PR4V PR4\%V PR44R74EK% \'V VPR4VPR4VPR4\)VPR44V VPR4R7#) D DEPRECATED: Use search() instead. The search() method now returns text contents by default. Migration: - search_and_contents(query) → search(query) - search_and_contents(query, text=True) → search(query, contents={"text": True}) - search_and_contents(query, summary=True) → search(query, contents={"summary": True}) rrrrrr!rrrrrZr[r\rrrwr:rJrKrLrMrNrerr]r^r_rr`ra rrrrrrrrrr)rJrcrDrdCONTENTS_OPTIONS_TYPESCONTENTS_ENDPOINT_OPTIONS_TYPESrrIrFrr$rKrNr rqrWrrcrrr rPrkwargsrrLrMmerged_options summary_optsrErrr^rfs &&, r/search_and_contentsExa.search_and_contentss}E"LLNDA} # ' !('/1GHGFO2345=>8  Jwy/A4$H$H"9-L<')>|H?U)V X&      H:>||Iw/)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'+DHHX,>?%.  r1c@V^8dQhRRRRRRRRRR R RR R R RRRRR/ #)r)r$Union[str, List[str], List[_Result]]rr:rOptional[LIVECRAWL_OPTIONS]rrrRrrOptional[Union[str, List[str]]]rOptional[ExtrasOptions]rrdr,SearchResponse[ResultWithText]r-)r.s"r/r0r+sn - -2 -) -/ - % - - -  -8 -( -# - ( -r1c  R#r9r-) rPrrrrrrrrrs &&&&&&&&&&r/ get_contentsExa.get_contentss*-r1rrrrrrrcDV^8dQhRRRRRRRRR RR R R RR RRRRRRR/ #)r)rr{rr.rr:rr|rrrRrrr}rr~rrdr,rr-)r.s"r/r0r+-sx - -2 -8 - ) - / -% -- -  -8 -( -# - ( -r1c  R#r9r-) rPrrrrrrrrrrs &&$$$$$$$$$r/rr,s*-r1cDV^8dQhRRRRRRRRR RR R R RR RRRRRRR/ #)r)rr{rr/rr:rr|rrrRrrr}rr~rrdr,!SearchResponse[ResultWithSummary]r-)r.s"r/r0r+=sx 0 02 0> 0 ) 0 / 0% 0- 0  08 0( 0# 0 + 0r1c  R#r9r-) rPrrrrrrrrrrs &&$$$$$$$$$r/rr<s-0r1cHV^8dQhRRRRRRRRR R R RR R RRRRRRRRRR/ #)r)rr{rr.rr/rr:rr|rrrRrrr}rr~rrdr,(SearchResponse[ResultWithTextAndSummary]r-)r.s"r/r0r+Ms77278 7 > 7 ) 7/7%7-7 787(7#7 27r1c  R#r9r-) rPrrrrrrrrrrrs &&$$$$$$$$$$r/rrLs47r1cV^8dQhRR/#r)rr{r-)r.s"r/r0r+]se e !Ee r1c \V\4'dV.pM]\V\4'dH\V4^8d8\V^,\4'dVUu.uFq3P NK ppRV/pVP 4FwrVVR8wgKVfKWdV&K RV9dRV9dRV9d R\/VR&/pVP\4VP\4\WG4RV9dC\VR,\4'd&VR,pRV9d\VR,4VR&\VR.4pVPRV4p \!V P#R 44p .p V P#R .4FMp V P%\'V P#R 4V P#R 4V P#R 4R74KO .p V R,EF"p\)V4pV P%\+VP#R4VP#R 4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4VP#R4\-VP#R44R74EK% \/V V P#R4V P#R4V P#R4V V V P#R4R 7#uupi)!aRetrieve contents for a list of URLs. Args: urls (str | List[str] | List[Result]): A single URL, list of URLs, or list of Result objects. text (TextContentsOptions | True, optional): Options for text extraction. summary (SummaryContentsOptions | True, optional): Options for summary generation. max_age_hours (int, optional): Maximum age of cached content in hours. If content is older, it will be fetched fresh. Special values: 0 = always fetch fresh content, -1 = never fetch fresh (cache only). Example: 168 = fetch fresh for pages older than 7 days. filter_empty_results (bool, optional): Whether to filter out empty results. subpages (int, optional): Number of subpages to retrieve. subpage_target (str | List[str], optional): Target subpages to retrieve. extras (ExtrasOptions, optional): Options for extra content (links, image_links). flags (List[str], optional): Experimental flags. Returns: SearchResponse[Result]: The response containing the contents of the URLs. Examples: # Get contents for a single URL contents = exa.get_contents("https://example.com/article") # Get contents for multiple URLs contents = exa.get_contents([ "https://example.com/article1", "https://example.com/article2" ]) rrPrrrrr! /contentsr\rrwrrrwrrrrr:rJrKrLrMrNrrrerr]r^r_rr`rrrr)rIr+rlenrHrrJrcrDrrrsrrFrrKrNr rqrrrWrcrrrPrrurrrLrMrvrwrErrrrr^rfs&&, r/rr]s< dC 6D d # #D A *T!Wg:V:V#'(4aEE4D(4.LLNDAF{q} # ' !('/1GHGFO45=>8  Jwy/A4$H$H"9-L<')>|H?U)V X&(4||K1)$((=*AB hhz2.F OOzz$'!::h/!::h/ /9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'%.  w)s"M&rcTV^8dQhRRRRRRRRR RR R R R R R RR RRRRRRRRRRRR/#r)rr+rrSrr:rrdrrr<rrrrrrrRrrUrr,rWr-)r.s"r/r0r+s_ _ _ C _ # _ - _ -_ (_ &_ ,_ *_ *_ *_  ._ %_ #!_ " #_ r1c  h\4P4UUu/uFwppVR8wgKVfKVVbK pppVRJdVPRR4M"VfRV9dRR\//VR&M VeVVR&\ V\ 4\ V4pVPRV4p\VPR44p.pVR ,EF"p\V4pVP\VPR 4VPR 4VPR 4VPR 4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4\VPR44R74EK% \VVPR4VPR4VVPR4R7#uuppi)aiFinds similar pages to a given URL, potentially with domain filters and date filters. By default, returns text contents with 10,000 max characters. Use contents=False to opt-out. Args: url (str): The URL to find similar pages for. contents (ContentsOptions | False, optional): Options for retrieving page contents. Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents. See ContentsOptions for available options (text, highlights, summary, etc.). num_results (int, optional): Number of results to return. Default is None (server default). include_domains (List[str], optional): Domains to include in the search. exclude_domains (List[str], optional): Domains to exclude from the search. start_crawl_date (str, optional): Only links crawled after this date. end_crawl_date (str, optional): Only links crawled before this date. start_published_date (str, optional): Only links published after this date. end_published_date (str, optional): Only links published before this date. include_text (List[str], optional): Strings that must appear in the page text. exclude_text (List[str], optional): Strings that must not appear in the page text. exclude_source_domain (bool, optional): Whether to exclude the source domain. category (Category, optional): Data category to focus on (e.g. 'company', 'news', 'research paper'). flags (List[str], optional): Experimental flags. Returns: SearchResponse[Result] Examples: similar_results = exa.find_similar( "miniclip.com", num_results=2, exclude_source_domain=True ) rPNFrrr /findSimilarr\rrrwr:rJrKrLrMrNrrrrrerr]r^r_r`rr)rbrJr"rcrFIND_SIMILAR_OPTIONS_TYPESrKrNr rqrWrrcrrrPrrrrrrrrrrrrrrrLrMrrErrr^rfs&&$$$$$$$$$$$$$ r/ find_similarExa.find_similarsd%+HNN$4V$4DAqV 441a4$4V u  KK D )  *G";#),<>T+U"VGJ   !"*GJ )CD(||NG4)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ %.   OWs H.H.H.c*lV^8dQhRRRRRRRRRR R R R R R R R RRRRRRRRRRRRRRRRRRRRRRRRR/#) r)rr+rr:rrdrrr<rrrrrrrRrrUrrrr|rrrrr}rr~r,rr-)r.s"r/r0r+&s-- -# - - - - -(-&-,-*-*-*- .-%-#- )!-"/#-$%%-&-'-( )-*8+-,(--. (/-r1c R#r9r-)rPrrrrrrrrrrrrrrrrrrrrs&&$$$$$$$$$$$$$$$$$$$r/find_similar_and_contentsExa.find_similar_and_contents%s0*-r1c,pV^8dQhRRRRRRRRR RR R R R R R RR RRRRRRRRRRRRRRRRRRRRRRRRR R!/#"r)rr+rr.rr:rrdrrr<rrrrrrrRrrUrrrr|rrrrr}rr~r,rr-)r.s"r/r0r+@-- -8 - # - - ---(-&-,-*-*-*- .-%- #!-")#-$/%-&%'-(-)-* +-,8--.(/-0 (1-r1c R#r9r-rPrrrrrrrrrrrrrrrrrrrrrs&&$$$$$$$$$$$$$$$$$$$$r/rr?2*-r1c,pV^8dQhRRRRRRRRR RR R R R R R RR RRRRRRRRRRRRRRRRRRRRRRRRR R!/#rr-)r.s"r/r0r+[rr1c R#r9r-rs&&$$$$$$$$$$$$$$$$$$$$r/rrZrr1c,pV^8dQhRRRRRRRRR RR R R R R R RR RRRRRRRRRRRRRRRRRRRRRRRRR R!/#)"r)rr+rr/rr:rrdrrr<rrrrrrrRrrUrrrr|rrrrr}rr~r,rr-)r.s"r/r0r+vs00 0> 0 # 0 - 0-0(0&0,0*0*0*0 .0%0 #!0")#0$/%0&%'0(-)0* +0,8-0.(/00 +10r1c R#r9r-)rPrrrrrrrrrrrrrrrrrrrrrs&&$$$$$$$$$$$$$$$$$$$$r/rrus2-0r1c.tV^8dQhRRRRRRRRR R R R R R RR RR RR RR RR RRRRRR RRRRRRRRRRRRR R!R"R#/#)$r)rr+rr.rr/rr:rrdrrr<rrrrrrrRrrUrrrr|rrrrr}rr~r,rr-)r.s"r/r0r+s77 78 7 > 7 # 7-7-7(7&7,7*7*7*7 .7 %!7"##7$)%7&/'7(%)7*-+7, -7.8/70(172 237r1c R#r9r-)rPrrrrrrrrrrrrrrrrrrrrrrs&&$$$$$$$$$$$$$$$$$$$$$r/rrs447r1cV^8dQhRR/#r)rr+r-)r.s"r/r0r+sO O SO r1c <RV/pVP4FwrEVfK WSV&K RV9dRV9d R\/VR&/pVP\4VP\4VP\ 4\ W64RV9dC\VR,\4'd&VR,pRV9d\VR,4VR&\V.ROR 4p\VR.R 7pVPR V4p\VPR 44p .p VR,EF"p \V 4p V P!\#V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR 4V PR4V PR4V PR4V PR4\%V PR44R74EK% \'V VPR4VPR4VPR4V VPR4R7#)h DEPRECATED: Use find_similar() instead. The find_similar() method now returns text contents by default. Migration: - find_similar_and_contents(url) → find_similar(url) - find_similar_and_contents(url, text=True) → find_similar(url, contents={"text": True}) - find_similar_and_contents(url, summary=True) → find_similar(url, contents={"summary": True}) rrrrr!rrrrrrZrr\rrwr:rJrKrLrMrNrerr]r^r_r`rrrrq)rJrcrDrrrrsrrIrFrr$rKrNr rqrWrrcrr rPrrurrLrMrvrwrErrr^rfs &&, r/rrsb#,LLNDA} #  Yg%=/1GHGFO8945=>8  Jwy/A4$H$H"9-L<')>|H?U)V X&      H:>||NG4)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'%.   r1cV^8dQhRR/#)r)clientrr-)r.s"r/r0r+sDD6Dr1c aaVPPPo\S4RRVV3Rlll4p\ R4W!PPnV#)abWrap an OpenAI client with Exa functionality. After wrapping, any call to `client.chat.completions.create` will be intercepted and enhanced with Exa RAG functionality. To disable Exa for a specific call, set `use_exa="none"` in the `create` method. Args: client (OpenAI): The OpenAI client to wrap. Returns: OpenAI: The wrapped OpenAI client. c XV^8dQhRRRRRRRRR R R R R R RR RR RR RR RR RRRRRRRR /#)r)messagesz$Iterable[ChatCompletionMessageParam]modelzUnion[str, ChatModel]use_exaz-Optional[Literal['required', 'none', 'auto']]rr:rrdrrr<rrrrrrrTrrUresult_max_lenrrr-)r.s"r/r0Exa.wrap..__annotate__ s. . :. ).  C .  ' . 1. 1. ,. *. #0. !.. .. .. 3.  )!. " #. $'%. r1c<RVRVRVRVRVRVRV RV RV R V R V R V/ pR V/pVPV4SPS\V4VVVR 7#)rrrrrrrrrrrrr) create_fnrmax_len create_kwargs exa_kwargs)rD_create_with_toolr)rrrrrrrrrrrrrrrr openai_kwargsrrfuncrPs&&&&&&&&&&&&&&&&, r/create_with_rag!Exa.wrap..create_with_rag s0{!?!?"$4 .&(<$&8  H J%e,M   /))h&+% * r1z.Wrapping OpenAI client with Exa functionality.)autoNNNNNNNNNNiN)chat completionscreaterprint)rPrrrsf& @r/wrapExa.wrapsV{{&&-- t. .  . ` >?)8 & r1c$V^8dQhRRRRRR/#)r)rrrz List[ChatCompletionMessageParam]r,rr-)r.s"r/r0r+C s(>>>3> >r1c RRRRRRRRRRRR RR RR //R R .///.pWdR &V!RRV/VBp\V4pV'g\P!VRR7#VPVVP R4VP R4VP R4VP R4VP R4VP R4VP R4VP R4VP R4VP R4VP R4VP R4R7 p \ WR7p \ WrV 4p V!RRV /VBp\P!WyR7p V #)rfunctionrxrrz(Search the web for relevant information. parametersobjectrrstringzThe query to search for.rtoolsrN) completion exa_resultrrrrrrrrrrr) rrrrrrrrrrrrr)rr-)rrfrom_completionrxrqrr) rPrrrrrrrrrexa_str new_messagesexa_completions &&&&&& r/rExa._create_with_toolC s H!#M $# & -/I&' #WI #   ("'gBBMB  +&66%$  --"}5&NN+<=&NN+<='^^,>?%>>*:;!+0F!G)~~.BC#7#7'^^J/..). $J@.zWM F F F ,<<! r1rrc8V^8dQhRRRRRRRRRR R R R RR R/#r)rr+rrRrrr<r#Optional[Literal['exa', 'exa-pro']]rOptional[JSONSchemaInput]rr,z+Union[AnswerResponse, StreamAnswerResponse]r-)r.s"r/r0r+ sZ : : : :  : % :3 :1 :% : 5 :r1c R#r9r-)rPrrrrrrrs&&$$$$$$r/r Exa.answer s7:r1c8V^8dQhRRRRRRRRRR R R R RR R/#rr-)r.s"r/r0r+ snDKDKDK DK  DK % DK3DK1DK%DK 5DKr1c  V'd \R4h\4P4UU u/uFwrVR8wgKV fKWbK p pp RV 9d!V R,e\V R,4V R&\ V R.4p VP RV 4p .p V R,Fp \ V 4pV P\VPR4VPR4VPR4VPR 4VPR 4VPR 4R 74K \V PR 44p\V R,W4#uup pi)a?Generate an answer to a query using Exa's search and LLM capabilities. Args: query (str): The query to answer. text (bool, optional): Whether to include full text in the results. Defaults to False. system_prompt (str, optional): A system prompt to guide the LLM's behavior when generating the answer. model (str, optional): The model to use for answering. Defaults to None. output_schema (dict[str, Any], optional): JSON schema describing the desired answer structure. Returns: AnswerResponse: An object containing the answer and citations. Raises: ValueError: If stream=True is provided. Use stream_answer() instead for streaming responses. Examples: response = exa.answer("What is the capital of France?") print(response.answer) # e.g. "Paris" print(response.citations) # list of citations used # If you want the full text of the citations in the response: response_with_text = exa.answer( "What is the capital of France?", text=True ) print(response_with_text.citations[0].text) # Full page text Zstream=True is not supported in `answer()`. Please use `stream_answer(...)` for streaming.rPr/answerrrwrr:rKrLrrr\r) rrbrJrrKrNrWrrrqr rrPrrrrrrrrLrMrresponserr^rfrs&&$$$$$$ r/rr sLN A  %+HNN$4V$4DAV 4414$4V g %'/*B*N'NN)NNNNNNNN)rrrrrrQrNrrkrxrrrrrrrrrr-r1r/r&r&ps0$3LQfM "' M FJ M &* M 04M 04M +/M )-M /3M -1M -1M -1M 26M (,!M "&*#M $&*%M &(,'M (37)M *(,+M ,59-M ^K2FJ K2 &* K2 04 K204K2+/K2)-K2/3K2-1K2-1K2-1K226K2(,K2 &*!K2"&*#K2$(,%K2&37'K2((,)K2*59+K2ZT l - - - ,0 - 26 -(, -04 -#' -;? -+/ -&* - - 0 ,0 0 26 0(, 004 0#' 0;? 0+/ 0&* 0 07 ,0 7267(,7047#'7;?7+/7&*77 e N_ FJ _ &* _ 04 _ 04_ +/_ )-_ /3_ -1_ -1_ -1_ 15_ (,_ &*!_ B-&* - 04 - 04 -+/-)--/3--1--1--1-15-(,-&*- ,0!-"26#-$(,%-&04'-(#')-*;?+-,+/---2- &* - 04 -04-+/-)--/3--1--1--1-15-(,- &*!-",0#-$26%-&(,'-(04)-*#'+-,;?--.+//--4- &* - 04 -04-+/-)--/3--1--1--1-15-(,- &*!-",0#-$26%-&(,'-(04)-*#'+-,;?--.+//--40 &* 0 04 0040+/0)-0/30-10-10-10150(,0 &*!0",0#0$26%0&(,'0(04)0*#'+0,;?-0.+//0047 &* 7047047+/7)-7/37-17-17-17157 (,!7"&*#7$,0%7&26'7((,)7*04+7,#'-7.;?/70+/1776O bDL>@ :"' : % : (, :6: :48 :(, : :DK"' DK % DK (, DK6:DK48DK(,DKL*2 *2 (, *2 6: *248*2(,*2*2r1r&c&a]tRtRtR1RV3Rlllt]RRl4tR2RRlltR R R RR RR RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR/RRlltR RR RR RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR/RR llt R!R"lt R#R$lt R RR RR RRRRRRRRRRRRRRRR%RRRRR/ R&R'llt R(R)lt R R R*R RRR+RRRRR/R,R-lltR*R RRR+RRRRR/R.R/lltR0tV;t#)3AsyncExai c V^8dQhRRRR/#)r)r(r+api_baser-)r.s"r/r0AsyncExa.__annotate__ ssr1c <\SV`W4\V4Vn\ V4Vn\ V4VnRVnR#r9) rgrQr%r2rr1r#r3_client)rPr(rrhs&&&r/rQAsyncExa.__init__ s; ++D1 )$/ 1$7  r1cV^8dQhRR/#)r)r,zhttpx.AsyncClientr-)r.s"r/r0r s)r1c VPf3\P!VPVPRR7VnVP#)NiX)r)r0timeout)rhttpx AsyncClientr)r0rs&r/rAsyncExa.client s; <<  ,, cDL||r1Nc$V^8dQhRRRRRR/#)r)r6r+r7r0r9r-)r.s"r/r0r s-III I * Ir1c "T;'d2\V\4;'dVPR4;'gT;'dVPR4R8Hp/VPCpV'dVP V4VP 4R8XdV'dS\ P!RVPV,VVR7pVPPVRR7GRjxL p V #VPPVPV,WGR7GRjxL p EMKVP 4R8XdV'dR\ P!RVPV,W'R 7pVPPVRR7GRjxL p V #VPPVPV,W'R 7GRjxL p MVP 4R 8Xd8VPPVPV,W'R 7GRjxL p MZVP 4R 8Xd8VPPVPV,VR 7GRjxL p M\R V 24hV P^8wd7V P^8wd&\RV P RV P 24hV P#4#ELELELAEL LLx5i)anSend a request to the Exa API, optionally streaming if data['stream'] is True. Args: endpoint (str): The API endpoint (path). data (dict, optional): The JSON payload to send. method (str, optional): The HTTP method to use. Defaults to "POST". params (dict, optional): Query parameters. headers (Dict[str, str], optional): Additional headers to include in the request. Defaults to None. Returns: Union[dict, httpx.Response]: If streaming, returns the Response object. Otherwise, returns the JSON-decoded response as a dict. Raises: ValueError: If the request fails (non-200 status code). rr<r=)r8r0T)rNr>)rr0r?r@rArBrr)rIrFrqr0rDrErRequestr)rsendrGrHrIrrrr) rPr6rEr7r8r0rKrLrNrMs &&&&&& r/ async_requestAsyncExa.async_request sl2 QQJtT$:QQtxx?Q   5 5vzz(+v5  +T\\*   " "7 + <<>U "--MMH,!+  !KK,,WT,BB  KKOOMMH,V,\\^v %--DMMH44!KK,,WT,BB  KK,,MMH,4-\\^w & )) (t*C\\^x ' ** (/+C8AB B ??c !coo&<23??2C2chhZP xxz?CCs!KK K*K2-K A K+K ,7K#K$"KA KK7K K A KKA K!K"A+KKKKKKrFrrrrrrrrrrrrrrrrrrc*lV^8dQhRRRRRRRRR R R R R R RR RR RR RR RR RRRRRR RRRR RR RR RRRR/#rQr-)r.s"r/r0rb sJ J J  J C J # J -J -J (J &J ,J *J *J *J /J %!J "##J $#%J &%'J (0)J *%+J ,2-J . /J r1c ("V'd \R4h\4P4UUu/uFwppVR8wgKVfKVVbK pppVPRR4VRJdVPRR4M"VfRV9dRR\//VR&M VeVVR&\ V\ 4\VR .R 7pVPR V4GRjxL p\VPR 44p.pVR ,EF"p\V4pVP\VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4\VPR44R74EK% \VVPR4VPR4VPR4\!VPR 44VVPR!4R"7#uuppiEL5i)#a Perform a search with a prompt-engineered query to retrieve relevant results. By default, returns text contents with 10,000 max characters. Use contents=False to opt-out. Args: query (str): The query string. stream (bool, optional): If True, stream the synthesized search response. Use ``stream_search(...)`` instead of ``search(..., stream=True)``. contents (ContentsOptions | False, optional): Options for retrieving page contents. Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents. See ContentsOptions for available options (text, highlights, summary, etc.). Note: The ``context`` option is deprecated; use ``highlights`` or ``text`` instead. num_results (int, optional): Number of search results to return. Default 10. include_domains (List[str], optional): Domains to include in the search. exclude_domains (List[str], optional): Domains to exclude from the search. start_crawl_date (str, optional): Only links crawled after this date. end_crawl_date (str, optional): Only links crawled before this date. start_published_date (str, optional): Only links published after this date. end_published_date (str, optional): Only links published before this date. include_text (List[str], optional): Strings that must appear in the page text. exclude_text (List[str], optional): Strings that must not appear in the page text. type (SearchType, optional): Search type - 'auto' (default), 'fast', 'deep-lite', 'deep', 'deep-reasoning', 'neural', or 'instant'. category (Category, optional): Data category to focus on (e.g. 'company', 'news', 'research paper'). flags (List[str], optional): Experimental flags for Exa usage. moderation (bool, optional): If True, the search results will be moderated for safety. user_location (str, optional): Two-letter ISO country code of the user (e.g. US). additional_queries (List[str], optional): Alternative query formulations for deep search to skip automatic LLM-based query expansion. Max 5 queries. Only applicable when type is 'deep-lite', 'deep', or 'deep-reasoning'. Example: ["machine learning", "ML algorithms", "neural networks"] system_prompt (str, optional): Instructions that guide both the search process and the final returned result. Use this to prefer certain sources, emphasize novelty, avoid duplicates, or constrain the response style. Supported for all search types. output_schema (DeepOutputSchema, optional): Search output schema for structured synthesis. When provided, the API returns synthesized output in ``output``. Use ``{"type": "text", "description": ...}`` for plain text output or ``{"type": "object", "properties": ..., "required": ...}`` for structured JSON. For object schemas, max nesting depth is 2 and max total properties is 10. Supported for all search types. Returns: SearchResponse: The response containing search results, etc. Raises: ValueError: If stream=True is provided. Use stream_search() instead. Examples: Basic async search: >>> async_exa = AsyncExa(api_key="your-api-key") >>> results = await async_exa.search("latest AI research papers") >>> print(results.results[0].title) Async search with filters: >>> results = await async_exa.search( ... "climate change research", ... include_domains=["nature.com", "science.org"], ... start_published_date="2024-01-01" ... ) rYrPNrFrrrrrZr[r\rrrwr:rJrKrLrMrNrrrrrerr]r^r_rrr`ra)rrbrJr"rcrrdrKrr rqrWrrcrrrres&&$$$$$$$$$$$$$$$$$$$ r/rAsyncExa.searchb s[h A  %+HNN$4V$4DAqV 441a4$4V Hd# u  KK D )  *G";#),<>T+U"VGJ   !"*GJ )=>O3DE'' 7;;)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'+DHHX,>?%.  QW >> async_exa = AsyncExa(api_key="your-api-key") >>> stream = await async_exa.stream_search( ... "What are the latest battery breakthroughs?", ... type="auto" ... ) >>> async for chunk in stream: ... if chunk.content: ... print(chunk.content, end="", flush=True) rPNFrrrrrZTrr[) rbrJr"rcrrdrKrrrjs&&$$$$$$$$$$$$$$$$$$ r/rkAsyncExa.stream_search sz%+HNN$4V$4DAqV 441a4$4V u  KK D )  *G";#),<>T+U"VGJ   !"*GJ )=>O3DE !// 7CC (66WDs&C  CCCA6C 2C3C cV^8dQhRR/#rnr-)r.s"r/r0r: sS S sS r1c h"RV/pVP4FwrEVfK WSV&K RV9dRV9dRV9d R\/VR&/pVP\4VP\4VP\ 4\ W64RV9dC\VR,\4'd&VR,pRV9d\VR,4VR&\V.ROR 4p\VR.R 7pVPR V4GRjxL p\VPR44p .p VR,EF"p \V 4p V P!\#V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR 4V PR4V PR4V PR4V PR4V PR4\%V PR44R74EK% \'V VPR4VPR4VPR 4V VPR4R7#EL5i) rprNrrrrr!rrrrrZr[r\rrrwr:rJrKrLrMrNrerr]r^r_r`rrq)rJrcrDrdrrrsrrIrFrr$rKrr rqrWrrcrrrts &&, r/rxAsyncExa.search_and_contents: syE"LLNDA} # ' !('/1GHGFO2345=>8  Jwy/A4$H$H"9-L<')>|H?U)V X&      H:>'' 7;;)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'%.   1>> async_exa = AsyncExa(api_key="your-api-key") >>> results = await async_exa.get_contents("https://example.com/article") >>> print(results.results[0].text) Get contents from async search results: >>> search_results = await async_exa.search("AI news", contents=False) >>> contents = await async_exa.get_contents(search_results.results[:5]) rrPNrrrrr!rr\rrwrrrrrr:rJrKrLrMrNrrrerr]r^r_rr`r)rIr+rrrHrrJrcrDrrrsrrFrrKrr rqrrrWrcrrrs&&, r/rAsyncExa.get_contents s< dC 6D d # #D A *T!Wg:V:V#'(4aEE4D(4.LLNDAF{q} # ' !('/1GHGFO45=>8  Jwy/A4$H$H"9-L<')>|H?U)V X&(4'' W==)$((=*AB hhz2.F OOzz$'!::h/!::h/ /9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'%.  w)4>s,A"M8$M08M8M8"C M8,M5-H M8rcTV^8dQhRRRRRRRRR RR R R R R R RR RRRRRRRRRRRR/#rr-)r.s"r/r0r se e e C e # e - e -e (e &e ,e *e *e *e  .e %e #!e " #e r1c  "\4P4UUu/uFwppVR8wgKVfKVVbK pppVRJdVPRR4M"VfRV9dRR\//VR&M VeVVR&\ V\ 4\ V4pVPRV4GRjxL p\VPR44p.pVR ,EF"p\V4pVP\VPR 4VPR 4VPR 4VPR 4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4VPR4\VPR44R74EK% \VVPR4VPR4VVPR4R7#uuppiEL5i)aFinds similar pages to a given URL, potentially with domain filters and date filters. By default, returns text contents with 10,000 max characters. Use contents=False to opt-out. Args: url (str): The URL to find similar pages for. contents (ContentsOptions | False, optional): Options for retrieving page contents. Defaults to {"text": {"maxCharacters": 10000}}. Use False to disable contents. See ContentsOptions for available options (text, highlights, summary, etc.). num_results (int, optional): Number of results to return. Default is None (server default). include_domains (List[str], optional): Domains to include in the search. exclude_domains (List[str], optional): Domains to exclude from the search. start_crawl_date (str, optional): Only links crawled after this date. end_crawl_date (str, optional): Only links crawled before this date. start_published_date (str, optional): Only links published after this date. end_published_date (str, optional): Only links published before this date. include_text (List[str], optional): Strings that must appear in the page text. exclude_text (List[str], optional): Strings that must not appear in the page text. exclude_source_domain (bool, optional): Whether to exclude the source domain. category (Category, optional): Data category to focus on (e.g. 'company', 'news', 'research paper'). flags (List[str], optional): Experimental flags. Returns: SearchResponse[Result] Examples: Find similar pages asynchronously: >>> async_exa = AsyncExa(api_key="your-api-key") >>> results = await async_exa.find_similar("https://www.nature.com/articles/s41586-021-03819-2") >>> print(results.results[0].title) Find similar with domain filters: >>> results = await async_exa.find_similar( ... "https://arxiv.org/abs/2301.00001", ... include_domains=["arxiv.org", "openreview.net"], ... exclude_source_domain=True ... ) rPNFrrrrr\rrrwr:rJrKrLrMrNrrrrrerr]r^r_r`r)rbrJr"rcrrrKrr rqrWrrcrrrs&&$$$$$$$$$$$$$ r/rAsyncExa.find_similar sp%+HNN$4V$4DAqV 441a4$4V u  KK D )  *G";#),<>T+U"VGJ   !"*GJ )CD(''@@)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ %.   OWAs'I H8H8H8A.I*H>+FIcV^8dQhRR/#rr-)r.s"r/r0r] sN N 3N r1c Z"RV/pVP4FwrEVfK WSV&K RV9dRV9d R\/VR&/pVP\4VP\4VP\ 4\ W64RV9dC\VR,\4'd&VR,pRV9d\VR,4VR&\V.ROR 4p\VR.R 7pVPR V4GRjxL p\VPR44p .p VR,EF"p \V 4p V P!\#V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR4V PR 4V PR 4V PR4V PR4V PR4V PR4\%V PR44R74EK% \'V VPR4VPR4VPR4V VPR4R7#EL5i)rrNrrrr!rrrrrrZrr\rrwr:rJrKrLrMrNrerr]r^r_r`rrq)rJrcrDrrrrsrrIrFrr$rKrr rqrWrrcrrrs &&, r/r"AsyncExa.find_similar_and_contents] sp#,LLNDA} #  Yg%=/1GHGFO8945=>8  Jwy/A4$H$H"9-L<')>|H?U)V X&      H:>''@@)$((=*AB 9ooF(0L NN$((/#''-&**73&**73#/#3#34D#E'++H5&**73(,,Y7)--j9'++H5%))&1(,,Y7+// =%1%5%56H%I,VZZ -CD &*  HH) * HHZ HHY'%.   1AsJ+C(J+ J( FJ+rrc8V^8dQhRRRRRRRRRR R R R RR R/#rr-)r.s"r/r0r snBKBKBK BK  BK % BK3BK1BK%BK 5BKr1c "V'd \R4h\4P4UU u/uFwrVR8wgKV fKWbK p pp RV 9d!V R,e\V R,4V R&\ V R.R7p VP RV 4GRjxL p .p V R,Fp \ V 4pV P\VPR4VPR 4VPR 4VPR 4VPR 4VPR 4R74K \V PR44p\V R,W4#uup piL5i)agGenerate an answer to a query using Exa's search and LLM capabilities. Args: query (str): The query to answer. text (bool, optional): Whether to include full text in the results. Defaults to False. system_prompt (str, optional): A system prompt to guide the LLM's behavior when generating the answer. model (str, optional): The model to use for answering. Defaults to None. output_schema (dict[str, Any], optional): JSON schema describing the desired answer structure. Returns: AnswerResponse: An object containing the answer and citations. Raises: ValueError: If stream=True is provided. Use stream_answer() instead for streaming responses. Examples: Basic async question answering: >>> async_exa = AsyncExa(api_key="your-api-key") >>> response = await async_exa.answer("What are the latest developments in quantum computing?") >>> print(response.answer) Async answer with citations: >>> response = await async_exa.answer("Explain renewable energy benefits", text=True) >>> for citation in response.citations: ... print(f"{citation.title}: {citation.url}") rrPNrrZrrrwrr:rKrLrrr\r) rrbrJrrKrrWrrrqr rrs&&$$$$$$ r/rAsyncExa.answer sZJ A  %+HNN$4V$4DAV 4414$4V g %'/*B*N'>> async_exa = AsyncExa(api_key="your-api-key") >>> async for chunk in async_exa.stream_answer("What is quantum computing?"): ... if chunk.text: ... print(chunk.text, end="", flush=True) Async stream with citations: >>> async for chunk in async_exa.stream_answer("Explain climate change", text=True): ... if chunk.text: ... print(chunk.text, end="") ... if chunk.citations: ... print(f"\nCitations: {[c.url for c in chunk.citations]}") rPNrrZTrr)rbrJrrKrrrs &&$$$$$ r/rAsyncExa.stream_answer sL%+HNN$4V$4DAV 4414$4V g %'/*B*N'r@s#" !"( V-'#-E9 ))I & ( F&68* D$w*v  q 9EYe-/EEF$ cU$C5$ $ v $$se$ $ $cU$  !$& '$,   -$4 5$6 dV7$84&9$:t ;$< =$BcUdV tfG$N C5C5vvseSE3%TFTFdV  dVt $NO TF T4L d|4, d|t ##$cUTF dV sDk tf dV #0P&9: \ 3()5(,%6 Ye     Ye IUiu> )5 )) )      "" " !! ! OO O )) )   D D  D "" "   ?? ? PP P (( ( '' ' }l* + JJ JZ ;W; ;| *1W*1 *1Z *7*7 *7Z .Pw.P .Pb % %  % P  6  47#7#t:#:#z</<< 9< CL   +WQZ+ +\  '..E&F#4 44 4 // /=B@"P2P2f$] 7s] 7r1