_jo,SrSSKJr SSKrSSKJrJrJrJrJ r J r J r J r J r Jr SSKJrJr SSKJr SSKJrJrJrJr SS KJrJrJr \ "S \S 9r"S S \\5r"SS\5rg)z Synchronous Research API client.) annotationsN) AnyDict GeneratorGenericLiteralOptionalTypeTypeVarUnionoverload) BaseModel TypeAdapter)ResearchBaseClient) ResearchDto ResearchEventListResearchResponseDto ResearchModel)is_pydantic_modelpydantic_to_json_schemastream_sse_eventsT)boundc"\rSrSrSrSSjrSrg) ResearchTyped%z%Wrapper for typed research responses.cXlX lURUlURUlURUlUR UlUR Ul[US5(aURUl[US5(aURUl [US5(aURUl [US5(aURUl gg)Neventsoutput cost_dollarserror) research parsed_output research_idstatus created_atmodel instructionshasattrrr r!r")selfr#r$s P/home/rurouni/.local/lib/python3.13/site-packages/exa_py/research/sync_client.py__init__ResearchTyped.__init__(s *#//oo "--^^ $11 8X & &"//DK 8X & &"//DK 8^ , , ( 5 5D  8W % %!DJ &) r!r'r"rr)r(r r$r#r%r&N)r#rr$r)__name__ __module__ __qualname____firstlineno____doc__r-__static_attributes__r/r,rr%s /(r/rc2\rSrSrSr\SS.SSjj5r\SS.SSjj5r\SS.S Sjj5rSSS .S!S jjr\S"S j5r\S S S .S#Sjj5r\SS.S$Sjj5r\S S S .S%Sjj5rS S SS.S&SjjrSSS.S'Sjjr\SSS S.S(Sjj5r \SSS S.S)Sjj5r SSS SS.S*Sjjr Sr g)+ResearchClient;z(Synchronous client for the Research API.zexa-research-fast)r(cgNr6)r+r)r(s r,createResearchClient.create>s r/cgr;r6r+r)r( output_schemas r,r<r=Fr/cgr;r6r?s r,r<r=OrAr/N)r(r@cUUS.nUb#[U5(a[U5US'OX4S'URSSUS9n[[5nUR U5$)aCreate a new research request. Args: instructions (str): The research instructions describing what to research. model (str): The model to use ('exa-research-fast', 'exa-research', or 'exa-research-pro'). output_schema (dict): Optional JSON schema for structured output format. Returns: The created research object with a unique research_id. Examples: from exa_py import Exa import os exa = Exa(os.environ["EXA_API_KEY"]) # Create a simple research task instructions = "What is the latest valuation of SpaceX?" schema = { "type": "object", "properties": { "valuation": {"type": "string"}, "date": {"type": "string"}, "source": {"type": "string"} } } task = exa.research.create( instructions=instructions, output_schema=schema ) print(f"Task created with ID: {task.research_id}") )r)r( outputSchemaPOST)methoddata)rrrequestrrvalidate_python)r+r)r(r@payloadresponseadapters r,r<r=XskT)   $ //*A-*P'*7'<<6<@k*&&x00r/cgr;r6)r+r%s r,getResearchClient.getsr/F)streamrcgr;r6r+r%rQrs r,rOrPrAr/rcgr;r6rSs r,rOrPs03r/cgr;r6)r+r%rQrr@s r,rOrPsr/)rQrr@c0nU(dSUS'U(aSUS'O$SUS'Ub[U5R5US'U(a URSU3SUSS 9n[U5$URSU3SUS 9n[ [ 5nUR U5nU(a[US 5(aUR(aURR(a&URURR5n O:S SK n U RURR5n URU 5n [X5$U$![a Us$f=f) aZGet a research request by ID. Args: research_id (str): The unique identifier of the research task. stream (bool): Whether to stream events as they occur. events (bool): Whether to include events in the response. output_schema (Type[BaseModel]): Optional Pydantic model for typed output validation. Returns: Research object with status and results. Examples: # Get a research task by ID task_id = "your-task-id-here" task = exa.research.get(task_id) print(f"Task status: {task.status}") if task.status == "completed": print(f"Results: {task.output}") falserQtruerN/GETT)rGparamsrQrGr\r r)strlowerrIrrrrJr*r parsedmodel_validatejsonloadscontentr Exception) r+r%rQrr@r\rLrMr#r`rb parsed_datas r,rOrPsG8&F8 #)x %F8 !#&v;#4#4#6x ||K=!%t$H%X. .||a }$5eF|SH!+.G..x8H8!T>T!U#&*jj1H1H&I !.!=!=k!J(:: O !$#O$sBE EE)cursorlimitcrURX5nURSSUS9n[R"U5$)aList research requests. Args: cursor (str): Pagination cursor from a previous response. limit (int): Maximum number of results to return. Returns: List of research objects with pagination info. Examples: # List all research tasks response = exa.research.list() print(f"Found {len(response.data)} tasks") # List with pagination response = exa.research.list(limit=10) if response.has_more: next_page = exa.research.list(cursor=response.next_cursor) rEr[r])build_pagination_paramsrIrra)r+rgrhr\rLs r,listResearchClient.lists92--f<<<5<@&55h??r/i' ) poll_interval timeout_msrcgr;r6)r+r%rnrors r,poll_until_finished"ResearchClient.poll_until_finishedsr/cgr;r6)r+r%rnrorr@s r,rqrrsr/)rnrorr@c US- nUS- nSn[R"5n Sn U(aURXUS9n OURXS9n Sn [U S5(a U ROSn U S;aU $[R"5U - U:a[ S USUS35e[R"U5 M![a(n U S - n X:a[ S US US U 35eSn A NsSn A ff=f)afPoll until research is finished. Args: research_id (str): The unique identifier of the research task. poll_interval (int): Milliseconds between polling attempts. timeout_ms (int): Maximum time to wait in milliseconds before timing out. events (bool): Whether to include events in the response. output_schema (Type[BaseModel]): Optional Pydantic model for typed output validation. Returns: Completed research object with results. Raises: TimeoutError: If research doesn't complete within timeout. RuntimeError: If polling fails too many times. Examples: # Create and poll a task until completion task = exa.research.create( instructions="Get information about Paris, France", output_schema={ "type": "object", "properties": { "name": {"type": "string"}, "population": {"type": "string"}, "founded_date": {"type": "string"} } } ) # Poll until completion result = exa.research.poll_until_finished(task.research_id) print(f"Research complete: {result.output}") rmr)rr@rTr&N) completedfailedcanceledrzPolling failed z times in a row for research z: z Research z did not complete within ms)timerOr*r&re RuntimeError TimeoutErrorsleep)r+r%rnrorr@poll_interval_sec timeout_secmax_consecutive_failures start_timeconsecutive_failuresresultr&es r,rqrr$s8V*D0 4' #$ YY[    !XX#-&F"XXkXAF'($+2&(*C*C@@!MAyy{Z'+5" },Ej\QST JJ( );  $)$'C&)*B)CD((3}Bqc;D sAB== C/C**C/r6)r)r^r(rreturnr)r)r^r(rr@zDict[str, Any]rr)r)r^r(rr@Type[T]rr)r)r^r(rr@z0Optional[Union[Dict[str, Any], Type[BaseModel]]]rr)r%r^rr)r%r^rQLiteral[False]rboolrr)r%r^rQz Literal[True]rzOptional[bool]rz$Generator[ResearchEvent, None, None]) r%r^rQrrrr@rrResearchTyped[T]) r%r^rQrrrr@Optional[Type[BaseModel]]rzGUnion[ResearchDto, ResearchTyped, Generator[ResearchEvent, None, None]])rgz Optional[str]rhz Optional[int]rr) r%r^rnintrorrrrr) r%r^rnrrorrrr@rrr) r%r^rnrrorrrr@rrz!Union[ResearchDto, ResearchTyped]) r0r1r2r3r4r r<rOrkrqr5r6r/r,r8r8;sY2 3     3   &    3       3JN 6161 61 H 61  61p   "'       "& 33 3  3 . 33 "'       37 >> >  > 1 > Q>F!%# @@ @ ! @: "         "        " 37N*N* N*  N*  N*1N* +N*N*r/r8) r4 __future__rrztypingrrrrrr r r r r pydanticrrbasermodelsrrrrutilsrrrrrr8r6r/r,rsf&"    ,$   Cy!(GAJ(,w*'w*r/