exa-py 1.15.6__py3-none-any.whl → 1.16.1__py3-none-any.whl

exa_py/api.py

@@ -142,7 +142,9 @@ SEARCH_OPTIONS_TYPES = {
         list
     ],  # Must not be present in webpage text. (One string, up to 5 words)
     "use_autoprompt": [bool],  # Convert query to Exa. (Default: false)
-    "type": [str],  # 'keyword', 'neural', 'hybrid', 'fast', or 'auto' (Default: auto)
+    "type": [
+        str
+    ],  # 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (Default: auto)
     "category": [
         str
     ],  # A data category to focus on: 'company', 'research paper', 'news', 'pdf', 'github', 'tweet', 'personal site', 'linkedin profile', 'financial report'
@@ -260,6 +262,10 @@ class HighlightsContentsOptions(TypedDict, total=False):
         query (str): The query string for the highlights.
         num_sentences (int): Size of highlights to return, in sentences. Default: 5
         highlights_per_url (int): Number of highlights to return per URL. Default: 1
+
+    NOTE: When using the "deep" search type, only the default highlights=True is supported.
+          These options will NOT be respected. Highlights will always be based on the user's query,
+          and the number and length may vary.
     """
 
     query: str
@@ -1275,7 +1281,7 @@ class Exa:
             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.
             use_autoprompt (bool, optional): Convert query to Exa (default False).
-            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', or 'auto' (default 'auto').
+            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
             category (str, optional): e.g. 'company'
             flags (List[str], optional): Experimental flags for Exa usage.
             moderation (bool, optional): If True, the search results will be moderated for safety.
@@ -2438,8 +2444,12 @@ class AsyncExa(Exa):
         return self._client
 
     async def async_request(
-        self, endpoint: str, data=None, method: str = "POST", params=None,
-        headers: Optional[Dict[str, str]] = None
+        self,
+        endpoint: str,
+        data=None,
+        method: str = "POST",
+        params=None,
+        headers: Optional[Dict[str, str]] = None,
     ):
         """Send a request to the Exa API, optionally streaming if data['stream'] is True.
 
@@ -2470,7 +2480,10 @@ class AsyncExa(Exa):
         if method.upper() == "GET":
             if needs_streaming:
                 request = httpx.Request(
-                    "GET", self.base_url + endpoint, params=params, headers=request_headers
+                    "GET",
+                    self.base_url + endpoint,
+                    params=params,
+                    headers=request_headers,
                 )
                 res = await self.client.send(request, stream=True)
                 return res
@@ -2529,7 +2542,7 @@ class AsyncExa(Exa):
             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.
             use_autoprompt (bool, optional): Convert query to Exa (default False).
-            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', or 'auto' (default 'auto').
+            type (str, optional): 'keyword', 'neural', 'hybrid', 'fast', 'deep', or 'auto' (default 'auto').
             category (str, optional): e.g. 'company'
             flags (List[str], optional): Experimental flags for Exa usage.
             moderation (bool, optional): If True, the search results will be moderated for safety.

exa_py/research/async_client.py

@@ -23,6 +23,7 @@ from .models import (
     ResearchDto,
     ResearchEvent,
     ListResearchResponseDto,
+    ResearchModel,
 )
 from .utils import (
     async_stream_sse_events,
@@ -64,7 +65,7 @@ class AsyncResearchClient(AsyncResearchBaseClient):
         self,
         *,
         instructions: str,
-        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
+        model: ResearchModel = "exa-research-fast",
     ) -> ResearchDto: ...
 
     @overload

exa_py/research/models.py

@@ -5,6 +5,9 @@ from typing import Annotated, Any, Dict, List, Literal, Optional, Union
 from pydantic import BaseModel, Field, RootModel
 
 
+ResearchModel = Literal["exa-research-fast", "exa-research", "exa-research-pro"]
+
+
 class CostDollars(BaseModel):
     total: float
     num_pages: Annotated[float, Field(alias="numPages")]
@@ -191,7 +194,7 @@ class ResearchBaseDto(BaseModel):
         float, Field(alias="createdAt", description="Milliseconds since epoch time")
     ]
     model: Annotated[
-        Literal["exa-research", "exa-research-pro"],
+        ResearchModel,
         Field(description="The model used for the research request"),
     ] = "exa-research"
     instructions: Annotated[
@@ -273,7 +276,7 @@ class ListResearchResponseDto(BaseModel):
 
 
 class ResearchCreateRequestDto(BaseModel):
-    model: Literal["exa-research", "exa-research-pro"] = "exa-research"
+    model: ResearchModel = "exa-research"
     instructions: Annotated[
         str,
         Field(
@@ -313,6 +316,7 @@ __all__ = [
     "ResearchTaskOutput",
     "ResearchTaskOutputEvent",
     "ResearchMetaEvent",
+    "ResearchModel",
     "ResearchPlanEvent",
     "ResearchTaskEvent",
     "ResearchEvent",

exa_py/research/sync_client.py

@@ -23,6 +23,7 @@ from .models import (
     ResearchDto,
     ResearchEvent,
     ListResearchResponseDto,
+    ResearchModel,
 )
 from .utils import (
     is_pydantic_model,
@@ -63,7 +64,7 @@ class ResearchClient(ResearchBaseClient):
         self,
         *,
         instructions: str,
-        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
+        model: ResearchModel = "exa-research-fast",
     ) -> ResearchDto: ...
 
     @overload
@@ -71,7 +72,7 @@ class ResearchClient(ResearchBaseClient):
         self,
         *,
         instructions: str,
-        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
+        model: ResearchModel = "exa-research-fast",
         output_schema: Dict[str, Any],
     ) -> ResearchDto: ...
 
@@ -80,7 +81,7 @@ class ResearchClient(ResearchBaseClient):
         self,
         *,
         instructions: str,
-        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
+        model: ResearchModel = "exa-research-fast",
         output_schema: Type[T],
     ) -> ResearchDto: ...
 
@@ -88,7 +89,7 @@ class ResearchClient(ResearchBaseClient):
         self,
         *,
         instructions: str,
-        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
+        model: ResearchModel = "exa-research-fast",
         output_schema: Optional[Union[Dict[str, Any], Type[BaseModel]]] = None,
     ) -> ResearchDto:
         """Create a new research request.

{exa_py-1.15.6.dist-info → exa_py-1.16.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: exa-py
-Version: 1.15.6
+Version: 1.16.1
 Summary: Python SDK for Exa API.
 License: MIT
 Author: Exa AI
@@ -13,9 +13,11 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: httpcore (>=1.0.9)
 Requires-Dist: httpx (>=0.28.1)
 Requires-Dist: openai (>=1.48)
 Requires-Dist: pydantic (>=2.10.6)
+Requires-Dist: python-dotenv (>=1.0.1)
 Requires-Dist: requests (>=2.32.3)
 Requires-Dist: typing-extensions (>=4.12.2)
 Description-Content-Type: text/markdown

{exa_py-1.15.6.dist-info → exa_py-1.16.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
 exa_py/__init__.py,sha256=M2GC9oSdoV6m2msboW0vMWWl8wrth4o6gmEV4MYLGG8,66
-exa_py/api.py,sha256=VbsY9hvkmUyHygX0_RvKmw1LZnCbK8jCTqBR05VTiY4,109976
+exa_py/api.py,sha256=vvhpalfGtBs9-hOilhFtjUTiNSOFtZVIs5j7pE7FUW0,110347
 exa_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 exa_py/research/__init__.py,sha256=qbWY5c3LYBM7L4yGVtiMs9nUg_kMcAVhMhT0DvN6EI4,1014
-exa_py/research/async_client.py,sha256=zNPVLyI_8pPnUypyVAWOBTMpwgCuvFGY2GH5WHeQJMI,9488
+exa_py/research/async_client.py,sha256=XbqmJEAh8oHJmVVF3yOfLdNVOHi6knvUjCcz52RvxJU,9482
 exa_py/research/base.py,sha256=0C52XGUMRwRox1JSVBrbiHZxqPI6Cgif7EFNqYxpc40,5451
-exa_py/research/models.py,sha256=P2vNjdUUebi6OJSFB5jvE9Qd47MKw05Miib9aS1kiTk,10286
-exa_py/research/sync_client.py,sha256=LHMkgqUZgKCQWgLP41Fj6EWLbt_YfX4aAgvWGjNgbXM,9155
+exa_py/research/models.py,sha256=y-f_d1FBNl7X49KveWhxtTM_RHVKq0MT95nu6NSQTjk,10330
+exa_py/research/sync_client.py,sha256=QCAj2npkvlqdQjgSHSywEo0r_SFZj6YNbx41PjGCjS4,9074
 exa_py/research/utils.py,sha256=YR61UkReyK-LrvOTaX_aG_neS1DsmCkv7B6YODpwHvU,5965
 exa_py/utils.py,sha256=1jwKwcJwHSbrzwgMkprXSEZ-xssCtXxwf-GTRgaFmz8,6395
 exa_py/websets/__init__.py,sha256=8ZWndRgeTKceZ3Wcm5xCh_dykrKkoCYdZdKcK7C3aSw,226
@@ -32,6 +32,6 @@ exa_py/websets/searches/client.py,sha256=XjOU-CWc9nVYbFYUvPzo26oKAkGgETqR5YCLHJG
 exa_py/websets/types.py,sha256=ZsZtVzjBZ7UsqZNs4rBhX3PJxGKOC0ulOT1NuSlsW30,51398
 exa_py/websets/webhooks/__init__.py,sha256=DMl6RFkS0c79AWzkuHOXnaU5QKHmkIHYW2PhZWUFIGc,191
 exa_py/websets/webhooks/client.py,sha256=rdYU0DZKAslw5LwGKB567j3T8L34ZF9tSnlN9jLi23A,7143
-exa_py-1.15.6.dist-info/METADATA,sha256=3O_O5ALUZWcHqrj8V-maB64MqD_SFcg86qOdWXhaiaU,3826
-exa_py-1.15.6.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-exa_py-1.15.6.dist-info/RECORD,,
+exa_py-1.16.1.dist-info/METADATA,sha256=tLfcffYzlppyozz2bfCfAlI7h5sgcj72vtjdUSDQDRA,3899
+exa_py-1.16.1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+exa_py-1.16.1.dist-info/RECORD,,

{exa_py-1.15.6.dist-info → exa_py-1.16.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.0.1
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any