exa-py 1.15.0__py3-none-any.whl → 1.15.2__py3-none-any.whl

exa_py/websets/types.py

@@ -24,15 +24,24 @@ class WebsetSearchBehavior(Enum):
 
 
 class MonitorBehaviorSearchConfig(ExaBaseModel):
-    query: str
-    criteria: List[SearchCriterion]
-    entity: Union[
+    query: Optional[str] = None
+    """
+    The query to search for. By default, the query from the last search is used.
+    """
+    criteria: Optional[List[SearchCriterion]] = None
+    """
+    The criteria to search for. By default, the criteria from the last search is used.
+    """
+    entity: Optional[Union[
         WebsetCompanyEntity,
         WebsetPersonEntity,
         WebsetArticleEntity,
         WebsetResearchPaperEntity,
         WebsetCustomEntity,
-    ] = Field(..., title='WebsetEntity')
+    ]] = Field(None, title='WebsetEntity')
+    """
+    The entity to search for. By default, the entity from the last search/import is used.
+    """
     count: int
     """
     The maximum number of results to find
@@ -243,11 +252,15 @@ class EventType(Enum):
     webset_search_updated = 'webset.search.updated'
     import_created = 'import.created'
     import_completed = 'import.completed'
-    import_processing = 'import.processing'
-    webset_export_created = 'webset.export.created'
-    webset_export_completed = 'webset.export.completed'
     webset_item_created = 'webset.item.created'
     webset_item_enriched = 'webset.item.enriched'
+    monitor_created = 'monitor.created'
+    monitor_updated = 'monitor.updated'
+    monitor_deleted = 'monitor.deleted'
+    monitor_run_created = 'monitor.run.created'
+    monitor_run_completed = 'monitor.run.completed'
+    webset_export_created = 'webset.export.created'
+    webset_export_completed = 'webset.export.completed'
 
 
 class Format(Enum):
@@ -263,6 +276,7 @@ class Format(Enum):
     options = 'options'
     email = 'email'
     phone = 'phone'
+    url = 'url'
 
 
 class ImportFormat(Enum):
@@ -333,6 +347,13 @@ class ListEventsResponse(ExaBaseModel):
           WebsetSearchUpdatedEvent,
           WebsetSearchCanceledEvent,
           WebsetSearchCompletedEvent,
+          ImportCreatedEvent,
+          ImportCompletedEvent,
+          MonitorCreatedEvent,
+          MonitorUpdatedEvent,
+          MonitorDeletedEvent,
+          MonitorRunCreatedEvent,
+          MonitorRunCompletedEvent,
       ],
       Field(discriminator='type')
   ]]
@@ -802,6 +823,30 @@ class UpdateImport(ExaBaseModel):
     """
 
 
+class UpdateEnrichmentParameters(ExaBaseModel):
+    """
+    Parameters for updating an enrichment.
+    """
+    description: Optional[str] = None
+    """
+    Provide a description of the enrichment task you want to perform to each Webset Item.
+    """
+    format: Optional[Format] = None
+    """
+    Format of the enrichment response.
+
+    We automatically select the best format based on the description. If you want to explicitly specify the format, you can do so here.
+    """
+    options: Optional[List[Option]] = None
+    """
+    When the format is options, the different options for the enrichment agent to choose from.
+    """
+    metadata: Optional[Dict[str, Any]] = None
+    """
+    Set of key-value pairs you want to associate with this object.
+    """
+
+
 class Option(ExaBaseModel):
     label: str
     """
@@ -1336,6 +1381,7 @@ class WebsetEnrichmentFormat(Enum):
     options = 'options'
     email = 'email'
     phone = 'phone'
+    url = 'url'
 
 
 class WebsetEnrichmentOption(Option):
@@ -1873,6 +1919,104 @@ class WebsetSearchUpdatedEvent(ExaBaseModel):
     """
 
 
+class ImportCreatedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['import.created']
+    data: Import
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
+class ImportCompletedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['import.completed']
+    data: Import
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
+class MonitorCreatedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['monitor.created']
+    data: Monitor
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
+class MonitorUpdatedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['monitor.updated']
+    data: Monitor
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
+class MonitorDeletedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['monitor.deleted']
+    data: Monitor
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
+class MonitorRunCreatedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['monitor.run.created']
+    data: MonitorRun
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
+class MonitorRunCompletedEvent(ExaBaseModel):
+    id: str
+    """
+    The unique identifier for the event
+    """
+    object: Literal['event']
+    type: Literal['monitor.run.completed']
+    data: MonitorRun
+    created_at: datetime = Field(..., alias='createdAt')
+    """
+    The date and time the event was created
+    """
+
+
 class WebsetStatus(Enum):
     """
     The status of the webset

exa_py/websets/webhooks/__init__.py

@@ -1,3 +1,3 @@
-from .client import WebsetWebhooksClient
+from .client import WebsetWebhooksClient, AsyncWebsetWebhooksClient, AsyncWebhookAttemptsClient
 
-__all__ = ["WebsetWebhooksClient"] 
+__all__ = ["WebsetWebhooksClient", "AsyncWebsetWebhooksClient", "AsyncWebhookAttemptsClient"] 

exa_py/websets/webhooks/client.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Optional, Dict, Any, Union, Literal
+from typing import Optional, Dict, Any, Union
 
 from ..types import (
     CreateWebhookParameters,
@@ -11,6 +11,7 @@ from ..types import (
     EventType,
 )
 from ..core.base import WebsetsBaseClient
+from ..core.async_base import WebsetsAsyncBaseClient
 
 class WebhookAttemptsClient(WebsetsBaseClient):
     """Client for managing Webhook Attempts."""
@@ -118,4 +119,65 @@ class WebsetWebhooksClient(WebsetsBaseClient):
             Webhook: The deleted webhook.
         """
         response = self.request(f"/v0/webhooks/{id}", method="DELETE")
+        return Webhook.model_validate(response)
+
+
+class AsyncWebhookAttemptsClient(WebsetsAsyncBaseClient):
+    """Async client for managing Webhook Attempts."""
+    
+    def __init__(self, client):
+        super().__init__(client)
+    
+    async def list(self, webhook_id: str, *, cursor: Optional[str] = None, 
+             limit: Optional[int] = None, event_type: Optional[Union[EventType, str]] = None,
+             successful: Optional[bool] = None) -> ListWebhookAttemptsResponse:
+        """List all attempts made by a Webhook ordered in descending order."""
+        event_type_value = None
+        if event_type is not None:
+            if isinstance(event_type, EventType):
+                event_type_value = event_type.value
+            else:
+                event_type_value = event_type
+                
+        params = {k: v for k, v in {
+            "cursor": cursor, 
+            "limit": limit,
+            "eventType": event_type_value,
+            "successful": successful
+        }.items() if v is not None}
+        
+        response = await self.request(f"/v0/webhooks/{webhook_id}/attempts", params=params, method="GET")
+        return ListWebhookAttemptsResponse.model_validate(response)
+
+class AsyncWebsetWebhooksClient(WebsetsAsyncBaseClient):
+    """Async client for managing Webset Webhooks."""
+    
+    def __init__(self, client):
+        super().__init__(client)
+        self.attempts = AsyncWebhookAttemptsClient(client)
+
+    async def create(self, params: Union[Dict[str, Any], CreateWebhookParameters]) -> Webhook:
+        """Create a Webhook."""
+        response = await self.request("/v0/webhooks", data=params)
+        return Webhook.model_validate(response)
+
+    async def get(self, id: str) -> Webhook:
+        """Get a Webhook by ID."""
+        response = await self.request(f"/v0/webhooks/{id}", method="GET")
+        return Webhook.model_validate(response)
+
+    async def list(self, *, cursor: Optional[str] = None, limit: Optional[int] = None) -> ListWebhooksResponse:
+        """List all Webhooks."""
+        params = {k: v for k, v in {"cursor": cursor, "limit": limit}.items() if v is not None}
+        response = await self.request("/v0/webhooks", params=params, method="GET")
+        return ListWebhooksResponse.model_validate(response)
+
+    async def update(self, id: str, params: Union[Dict[str, Any], UpdateWebhookParameters]) -> Webhook:
+        """Update a Webhook."""
+        response = await self.request(f"/v0/webhooks/{id}", data=params, method="PATCH")
+        return Webhook.model_validate(response)
+
+    async def delete(self, id: str) -> Webhook:
+        """Delete a Webhook."""
+        response = await self.request(f"/v0/webhooks/{id}", method="DELETE")
         return Webhook.model_validate(response)

{exa_py-1.15.0.dist-info → exa_py-1.15.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: exa-py
-Version: 1.15.0
+Version: 1.15.2
 Summary: Python SDK for Exa API.
 License: MIT
 Author: Exa AI

exa_py-1.15.2.dist-info/RECORD

@@ -0,0 +1,37 @@
+exa_py/__init__.py,sha256=M2GC9oSdoV6m2msboW0vMWWl8wrth4o6gmEV4MYLGG8,66
+exa_py/api.py,sha256=ftJRM7qnF-Ki4agnG4PLtCn7YcrBV1JlC_TmhH5bbG4,109112
+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=jP6BF8nc29Mt4iU2ZEQGAC5dGM-Z9I4k3pzpPcCKJIs,9436
+exa_py/research/base.py,sha256=0C52XGUMRwRox1JSVBrbiHZxqPI6Cgif7EFNqYxpc40,5451
+exa_py/research/models.py,sha256=2gu4jckbLYHlTmln8BhDzovuqg1fejTCncqi4r0oDow,9822
+exa_py/research/sync_client.py,sha256=LHMkgqUZgKCQWgLP41Fj6EWLbt_YfX4aAgvWGjNgbXM,9155
+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
+exa_py/websets/_generator/pydantic/BaseModel.jinja2,sha256=RUDCmPZVamoVx1WudylscYFfDhGoNNtRYlpTvKjAiuA,1276
+exa_py/websets/async_client.py,sha256=fewb7T64Ip5R67sZ2fceHv-Lv0gJPqQrsXq-v6ZuZPY,5823
+exa_py/websets/client.py,sha256=mdzZSfzgajfPQKWmjvwhUqjJSrtm3aErKcv4zcp7tWI,11137
+exa_py/websets/core/__init__.py,sha256=L8dLhlle-Y7yoo0p0s60S07UyknyrcEn64W9JxkvCjM,458
+exa_py/websets/core/async_base.py,sha256=RlJEaNR7OfZFzSy4sCk5aiPNT3cztuFZIyfP5vXMGtI,3121
+exa_py/websets/core/base.py,sha256=RldWYwBg2iVfkWmdPke7xjXdwb4JKeABIOgiZtqvz-4,4125
+exa_py/websets/enrichments/__init__.py,sha256=DA57V8s3169lfMnnLcFIOMQxhFIZ9I0uwXPYZMJzs9A,145
+exa_py/websets/enrichments/client.py,sha256=EStsgPgAggEa0FiYrIG9HNZ30akuUrXtKY27f-Fa3sI,5903
+exa_py/websets/events/__init__.py,sha256=VfJzObC3rSstdqz6q2ePnOIRW50GKJoSSH3-mpmDG0w,100
+exa_py/websets/events/client.py,sha256=_jLGUlf27W5XYa7AeUVVvJ9hffwbPZ7981Qz-Fi6U1c,7691
+exa_py/websets/imports/__init__.py,sha256=5fxYvRQdJQsVngvuq278Yw5W0Ckw17I_aPRrrtPcJ1w,105
+exa_py/websets/imports/client.py,sha256=Zr_qWO1rhYTXm62Jz5bR7orfvzDhcb7pHVfeO8uvVmQ,13700
+exa_py/websets/items/__init__.py,sha256=aJZto81Zp9eK1Dou2cFrRXgv3ZBuEvCHqb2G4KuKoao,121
+exa_py/websets/items/client.py,sha256=74vRjMrEoy6cVA8679dFtD43IU2jKDH8Zlw4hLIRs8I,6027
+exa_py/websets/monitors/__init__.py,sha256=cTRxTrsUuQmmmVEN3ewKsOq26xxiBJKTy7v0UjdOooc,216
+exa_py/websets/monitors/client.py,sha256=PmIkizecQSLnicKpIPEBJafId9rx_iJlP-LD_ApuAik,5333
+exa_py/websets/monitors/runs/__init__.py,sha256=rfE6PmQds4uPAd0fN3u992pG7INwbx1QvdyH8M-t8rs,121
+exa_py/websets/monitors/runs/client.py,sha256=_fMPqxzF0gy5g76wU6N8i7XrKTtq5vaOrrIzXkM1ZcA,1985
+exa_py/websets/searches/__init__.py,sha256=w6fJnCTKwl07GWgRVKQbYkPcoAct975YyOZog37C2q8,133
+exa_py/websets/searches/client.py,sha256=_mCuQtdLvKus5ofgs2a9MtY56Zg07JBJzqIg6YWre2A,3495
+exa_py/websets/types.py,sha256=naBzmlJ-nZK3ynDGBE15lmItD5p8-x_OfsWGFpKZRDs,50874
+exa_py/websets/webhooks/__init__.py,sha256=DMl6RFkS0c79AWzkuHOXnaU5QKHmkIHYW2PhZWUFIGc,191
+exa_py/websets/webhooks/client.py,sha256=rdYU0DZKAslw5LwGKB567j3T8L34ZF9tSnlN9jLi23A,7143
+exa_py-1.15.2.dist-info/METADATA,sha256=Izyx0YsIaj8Q8bztKKC0UD1L75KJHJrZsMjZ_CVbLv0,3826
+exa_py-1.15.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+exa_py-1.15.2.dist-info/RECORD,,

exa_py-1.15.0.dist-info/RECORD

@@ -1,35 +0,0 @@
-exa_py/__init__.py,sha256=M2GC9oSdoV6m2msboW0vMWWl8wrth4o6gmEV4MYLGG8,66
-exa_py/api.py,sha256=gUvQ2NXtUgBlrFrWrCIUwiq-z2lAlo_gWVFncN68Vhw,108947
-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=jP6BF8nc29Mt4iU2ZEQGAC5dGM-Z9I4k3pzpPcCKJIs,9436
-exa_py/research/base.py,sha256=0C52XGUMRwRox1JSVBrbiHZxqPI6Cgif7EFNqYxpc40,5451
-exa_py/research/models.py,sha256=2gu4jckbLYHlTmln8BhDzovuqg1fejTCncqi4r0oDow,9822
-exa_py/research/sync_client.py,sha256=LHMkgqUZgKCQWgLP41Fj6EWLbt_YfX4aAgvWGjNgbXM,9155
-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=x7Dc0MS8raRXA7Ud6alKgnsUmLi6X9GTqfB8kOwC9iQ,179
-exa_py/websets/_generator/pydantic/BaseModel.jinja2,sha256=RUDCmPZVamoVx1WudylscYFfDhGoNNtRYlpTvKjAiuA,1276
-exa_py/websets/client.py,sha256=sKkji8QaPFnGM1-J5TB6yKJcGAEd6gk7lsnIebzXNQ8,5856
-exa_py/websets/core/__init__.py,sha256=xOyrFaqtBocMUu321Jpbk7IzIQRNZufSIGJXrKoG-Bg,323
-exa_py/websets/core/base.py,sha256=RldWYwBg2iVfkWmdPke7xjXdwb4JKeABIOgiZtqvz-4,4125
-exa_py/websets/enrichments/__init__.py,sha256=5dJIEKKceUost3RnI6PpCSB3VjUCBzxseEsIXu-ZY-Y,83
-exa_py/websets/enrichments/client.py,sha256=obUjn4vH6tKBMtHEBVdMzlN8in0Fx3sCP-bXx-Le1zM,2338
-exa_py/websets/events/__init__.py,sha256=aFJ9O5UudtQQzndVmdB96IaM2l07qyM1B_8xKY7rp58,60
-exa_py/websets/events/client.py,sha256=Hzatqp3X-K0ZGe36cjFMgbhnsErcDLdGWQVirhmHjvY,3622
-exa_py/websets/imports/__init__.py,sha256=iEl-fZZSdcvKaqLgjMES_0RwYn7hZDCMf6BZriCrjgw,64
-exa_py/websets/imports/client.py,sha256=nJs46hxlSkZm7qjboYHNBuJ62gLmA_Yzr9fc-NDky0Y,6795
-exa_py/websets/items/__init__.py,sha256=DCWZJVtRmUjnMEkKdb5gW1LT9cHcb-J8lENMnyyBeKU,71
-exa_py/websets/items/client.py,sha256=stAQ47AgkJdEsNb1E_YAXLe96VrtglOZsG79KVcy--M,3038
-exa_py/websets/monitors/__init__.py,sha256=jfr-gq8eKVa_gNe_DEqX9XCZPbJjpOe7QpH_D4RCFJQ,122
-exa_py/websets/monitors/client.py,sha256=fFxCSngkUPXqf9ilUMl8DaO2ihYveD-WfSoqARwf1eQ,3526
-exa_py/websets/monitors/runs/__init__.py,sha256=TmcETf3zdQouA_vAeLiosCNL1MYJnZ0yW2sbOAjTmm8,71
-exa_py/websets/monitors/runs/client.py,sha256=WnwcWCf7UKk68VCNUp8mRXBtlU8vglTSX-eoWVXzKIw,1229
-exa_py/websets/searches/__init__.py,sha256=_0Zx8ES5fFTEL3T8mhLxq_xK2t0JONx6ad6AtbvClsE,77
-exa_py/websets/searches/client.py,sha256=X3f7axWGfecmxf-2tBTX0Yf_--xToz1X8ZHbbudEzy0,1790
-exa_py/websets/types.py,sha256=DxO_T4Ijnd06gxFAX3f238Mt5P0_ulpY44M1kiT4y4U,47120
-exa_py/websets/webhooks/__init__.py,sha256=iTPBCxFd73z4RifLQMX6iRECx_6pwlI5qscLNjMOUHE,77
-exa_py/websets/webhooks/client.py,sha256=zS1eoWKliuiY4AIeFJdpAlPZeOINyphn7KEWANF-zaE,4384
-exa_py-1.15.0.dist-info/METADATA,sha256=QTMlL2y63YGWPWdSrQy-BkoDSAZ-axbTMVEtPhE_H0c,3826
-exa_py-1.15.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-exa_py-1.15.0.dist-info/RECORD,,