exa-py 1.14.1__tar.gz → 1.14.3__tar.gz

{exa_py-1.14.1 → exa_py-1.14.3}/PKG-INFO

@@ -1,25 +1,21 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: exa-py
-Version: 1.14.1
+Version: 1.14.3
 Summary: Python SDK for Exa API.
+Home-page: https://github.com/exa-labs/exa-py
+Author: Exa
+Author-email: Exa AI <hello@exa.ai>
 License: MIT
-Author: Exa AI
-Author-email: hello@exa.ai
 Requires-Python: >=3.9
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-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: httpx (>=0.28.1)
-Requires-Dist: openai (>=1.48)
-Requires-Dist: pydantic (>=2.10.6)
-Requires-Dist: pytest-mock (>=3.14.0)
-Requires-Dist: requests (>=2.32.3)
-Requires-Dist: typing-extensions (>=4.12.2)
 Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.32.3
+Requires-Dist: typing-extensions>=4.12.2
+Requires-Dist: openai>=1.48
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: pytest-mock>=3.14.0
+Requires-Dist: httpx>=0.28.1
+Dynamic: author
+Dynamic: home-page
 
 # Exa
 
@@ -131,4 +127,3 @@ exa = Exa(api_key="your-api-key")
       output_schema=OUTPUT_SCHEMA,
   )
 ```
-

{exa_py-1.14.1 → exa_py-1.14.3}/exa_py/api.py

@@ -159,7 +159,7 @@ FIND_SIMILAR_OPTIONS_TYPES = {
 }
 
 # the livecrawl options
-LIVECRAWL_OPTIONS = Literal["always", "fallback", "never", "auto"]
+LIVECRAWL_OPTIONS = Literal["always", "fallback", "never", "auto", "preferred"]
 
 CONTENTS_OPTIONS_TYPES = {
     "urls": [list],

{exa_py-1.14.1 → exa_py-1.14.3}/exa_py/websets/client.py

@@ -16,7 +16,7 @@ from .items import WebsetItemsClient
 from .searches import WebsetSearchesClient
 from .enrichments import WebsetEnrichmentsClient
 from .webhooks import WebsetWebhooksClient
-from .streams import StreamsClient
+from .monitors import MonitorsClient
 
 class WebsetsClient(WebsetsBaseClient):
     """Client for managing Websets."""
@@ -27,7 +27,7 @@ class WebsetsClient(WebsetsBaseClient):
         self.searches = WebsetSearchesClient(client)
         self.enrichments = WebsetEnrichmentsClient(client)
         self.webhooks = WebsetWebhooksClient(client)
-        self.streams = StreamsClient(client)
+        self.monitors = MonitorsClient(client)
 
     def create(self, params: Union[Dict[str, Any], CreateWebsetParameters]) -> Webset:
         """Create a new Webset.

exa_py-1.14.3/exa_py/websets/monitors/__init__.py

@@ -0,0 +1,4 @@
+from .client import MonitorsClient
+from .runs import MonitorRunsClient
+
+__all__ = ["MonitorsClient", "MonitorRunsClient"] 

exa_py-1.14.3/exa_py/websets/monitors/client.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+from typing import Dict, Any, Union, Optional
+
+from ..types import (
+    Monitor,
+    CreateMonitorParameters,
+    UpdateMonitor,
+    ListMonitorsResponse,
+)
+from ..core.base import WebsetsBaseClient
+from .runs import MonitorRunsClient
+
+class MonitorsClient(WebsetsBaseClient):
+    """Client for managing Monitors."""
+    
+    def __init__(self, client):
+        super().__init__(client)
+        self.runs = MonitorRunsClient(client)
+
+    def create(self, params: Union[Dict[str, Any], CreateMonitorParameters]) -> Monitor:
+        """Create a new Monitor to continuously keep your Websets updated with fresh data.
+        
+        Monitors automatically run on your defined schedule to ensure your Websets stay current without manual intervention:
+        - Find new content: Execute search operations to discover fresh items matching your criteria
+        - Update existing content: Run refresh operations to update items contents and enrichments
+        - Automated scheduling: Configure frequency, timezone, and execution times
+        
+        Args:
+            params (CreateMonitorParameters): The parameters for creating a monitor.
+        
+        Returns:
+            Monitor: The created monitor.
+        """
+        response = self.request("/v0/monitors", data=params)
+        return Monitor.model_validate(response)
+
+    def get(self, monitor_id: str) -> Monitor:
+        """Get a specific monitor.
+        
+        Args:
+            monitor_id (str): The id of the Monitor.
+        
+        Returns:
+            Monitor: The retrieved monitor.
+        """
+        response = self.request(f"/v0/monitors/{monitor_id}", method="GET")
+        return Monitor.model_validate(response)
+
+    def list(self, *, cursor: Optional[str] = None, limit: Optional[int] = None, webset_id: Optional[str] = None) -> ListMonitorsResponse:
+        """List all monitors.
+        
+        Args:
+            cursor (str, optional): The cursor to paginate through the results.
+            limit (int, optional): The number of results to return (1-200, default 25).
+            webset_id (str, optional): The id of the Webset to list monitors for.
+        
+        Returns:
+            ListMonitorsResponse: List of monitors with pagination info.
+        """
+        params = {
+            k: v 
+            for k, v in {
+                "cursor": cursor, 
+                "limit": limit, 
+                "websetId": webset_id
+            }.items() 
+            if v is not None
+        }
+        response = self.request("/v0/monitors", params=params, method="GET")
+        return ListMonitorsResponse.model_validate(response)
+
+    def update(self, monitor_id: str, params: Union[Dict[str, Any], UpdateMonitor]) -> Monitor:
+        """Update a monitor configuration.
+        
+        Args:
+            monitor_id (str): The id of the Monitor.
+            params (UpdateMonitor): The parameters for updating a monitor.
+        
+        Returns:
+            Monitor: The updated monitor.
+        """
+        response = self.request(f"/v0/monitors/{monitor_id}", data=params, method="PATCH")
+        return Monitor.model_validate(response)
+
+    def delete(self, monitor_id: str) -> Monitor:
+        """Delete a monitor.
+        
+        Args:
+            monitor_id (str): The id of the Monitor.
+        
+        Returns:
+            Monitor: The deleted monitor.
+        """
+        response = self.request(f"/v0/monitors/{monitor_id}", method="DELETE")
+        return Monitor.model_validate(response) 

exa_py-1.14.3/exa_py/websets/monitors/runs/__init__.py

@@ -0,0 +1,3 @@
+from .client import MonitorRunsClient
+
+__all__ = ["MonitorRunsClient"] 

exa_py-1.14.3/exa_py/websets/monitors/runs/client.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from ...types import (
+    MonitorRun,
+    ListMonitorRunsResponse,
+)
+from ...core.base import WebsetsBaseClient
+
+class MonitorRunsClient(WebsetsBaseClient):
+    """Client for managing Monitor Runs."""
+    
+    def __init__(self, client):
+        super().__init__(client)
+
+    def list(self, monitor_id: str) -> ListMonitorRunsResponse:
+        """List all runs for the Monitor.
+        
+        Args:
+            monitor_id (str): The id of the Monitor to list runs for.
+        
+        Returns:
+            ListMonitorRunsResponse: List of monitor runs.
+        """
+        response = self.request(f"/v0/monitors/{monitor_id}/runs", method="GET")
+        return ListMonitorRunsResponse.model_validate(response)
+
+    def get(self, monitor_id: str, run_id: str) -> MonitorRun:
+        """Get a specific monitor run.
+        
+        Args:
+            monitor_id (str): The id of the Monitor to get the run for.
+            run_id (str): The id of the monitor run.
+        
+        Returns:
+            MonitorRun: The monitor run details.
+        """
+        response = self.request(f"/v0/monitors/{monitor_id}/runs/{run_id}", method="GET")
+        return MonitorRun.model_validate(response)