exa-py 1.14.0__py3-none-any.whl → 1.14.2__py3-none-any.whl

exa_py/research/client.py

@@ -9,7 +9,7 @@ block, but at runtime we only pay the cost if/when a helper is actually used.
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Dict, Optional
+from typing import TYPE_CHECKING, Any, Dict, Optional, Literal
 
 if TYPE_CHECKING:  # pragma: no cover – only for static analysers
     # Import with full type info when static type-checking.  `_Result` still
@@ -39,15 +39,20 @@ class ResearchClient:
         self,
         *,
         instructions: str,
-        model: str = "exa-research",
-        output_schema: Dict[str, Any],
+        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
+        output_infer_schema: bool = None,
+        output_schema: Dict[str, Any] = None,
     ) -> "ResearchTaskId":
         """Submit a research request and return the *task identifier*."""
-        payload = {
-            "instructions": instructions,
-            "model": model,
-            "output": {"schema": output_schema},
-        }
+        payload = {"instructions": instructions}
+        if model is not None:
+            payload["model"] = model
+        if output_schema is not None or output_infer_schema is not None:
+            payload["output"] = {}
+            if output_schema is not None:
+                payload["output"]["schema"] = output_schema
+            if output_infer_schema is not None:
+                payload["output"]["inferSchema"] = output_infer_schema
 
         raw_response: Dict[str, Any] = self._client.request(
             "/research/v0/tasks", payload
@@ -64,9 +69,7 @@ class ResearchClient:
 
         return ResearchTaskId(id=raw_response["id"])
 
-    def get_task(
-        self, id: str
-    ) -> "ResearchTask":  # noqa: D401 – imperative mood is fine
+    def get_task(self, id: str) -> "ResearchTask":  # noqa: D401 – imperative mood is fine
         """Fetch the current status / result for a research task."""
         endpoint = f"/research/v0/tasks/{id}"
 
@@ -175,7 +178,7 @@ class AsyncResearchClient:
         self,
         *,
         instructions: str,
-        model: str = "exa-research",
+        model: Literal["exa-research", "exa-research-pro"] = "exa-research",
         output_schema: Dict[str, Any],
     ) -> "ResearchTaskId":
         """Submit a research request and return the *task identifier* (async)."""

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/websets/monitors/__init__.py

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

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/websets/monitors/runs/__init__.py

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

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) 

exa_py/websets/types.py

@@ -11,7 +11,7 @@ from typing import Any, Dict, List, Literal, Optional, Union
 from pydantic import AnyUrl, Field, PositiveInt, confloat, constr
 from .core.base import ExaBaseModel
 
-class StreamBehaviorSearchConfig(ExaBaseModel):
+class MonitorBehaviorSearchConfig(ExaBaseModel):
     query: constr(min_length=2, max_length=10000)
     criteria: List[SearchCriterion] = Field(..., max_items=5)
     entity: Union[
@@ -59,20 +59,20 @@ class CreateEnrichmentParameters(ExaBaseModel):
     """
 
 
-class CreateStreamParameters(ExaBaseModel):
+class CreateMonitorParameters(ExaBaseModel):
     webset_id: str = Field(..., alias='websetId')
     """
     The id of the Webset
     """
-    cadence: StreamCadence
+    cadence: MonitorCadence
     """
-    How often the stream will run
+    How often the monitor will run
     """
-    behavior: Union[StreamBehaviorSearch, StreamBehaviorRefresh] = Field(
+    behavior: Union[MonitorBehaviorSearch, MonitorBehaviorRefresh] = Field(
         ..., discriminator='type'
     )
     """
-    Behavior to perform when stream runs
+    Behavior to perform when monitor runs
     """
     metadata: Optional[Dict[str, Any]] = None
 
@@ -198,11 +198,11 @@ class EnrichmentResult(ExaBaseModel):
     """
     enrichment_id: str = Field(..., alias='enrichmentId')
     """
-    The id of the Enrichment that generated the result
+    The unique identifier for the enrichment
     """
 
 
-class StreamRefreshBehaviorEnrichmentsConfigEnrichments(ExaBaseModel):
+class MonitorRefreshBehaviorEnrichmentsConfigEnrichments(ExaBaseModel):
     """
     Only refresh specific enrichments
     """
@@ -224,6 +224,7 @@ class EventType(Enum):
     webset_item_created = 'webset.item.created'
     webset_item_enriched = 'webset.item.enriched'
 
+
 class Format(Enum):
     """
     Format of the enrichment response.
@@ -263,14 +264,14 @@ class ListEventsResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of results
+    The cursor to use for the next page of results
     """
 
 
-class ListStreamRunsResponse(ExaBaseModel):
-    data: List[StreamRun]
+class ListMonitorRunsResponse(ExaBaseModel):
+    data: List[MonitorRun]
     """
-    The list of stream runs
+    The list of monitor runs
     """
     has_more: bool = Field(..., alias='hasMore')
     """
@@ -278,14 +279,14 @@ class ListStreamRunsResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of results
+    The cursor to use for the next page of results
     """
 
 
-class ListStreamsResponse(ExaBaseModel):
-    data: List[Stream]
+class ListMonitorsResponse(ExaBaseModel):
+    data: List[Monitor]
     """
-    The list of streams
+    The list of monitors
     """
     has_more: bool = Field(..., alias='hasMore')
     """
@@ -293,7 +294,7 @@ class ListStreamsResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of results
+    The cursor to use for the next page of results
     """
 
 
@@ -308,7 +309,7 @@ class ListWebhookAttemptsResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of results
+    The cursor to use for the next page of results
     """
 
 
@@ -323,7 +324,7 @@ class ListWebhooksResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of results
+    The cursor to use for the next page of results
     """
 
 
@@ -338,7 +339,7 @@ class ListWebsetItemResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of Items
+    The cursor to use for the next page of results
     """
 
 
@@ -353,15 +354,17 @@ class ListWebsetsResponse(ExaBaseModel):
     """
     next_cursor: Optional[str] = Field(None, alias='nextCursor')
     """
-    The cursor to paginate through the next set of results
+    The cursor to use for the next page of results
     """
 
+
 class Option(ExaBaseModel):
     label: str
     """
     The label of the option
     """
 
+
 class Progress(ExaBaseModel):
     """
     The progress of the search
@@ -446,7 +449,7 @@ class CreateWebsetParametersSearch(ExaBaseModel):
     """
     Criteria every item is evaluated against.
 
-    It's not required to provide your own criteria, we automatically detect the criteria from all the information provided in the query. Only use this when you need more fine control.
+    It's not required to provide your own criteria, we automatically detect the criteria from all the information provided in the query.
     """
 
 
@@ -459,9 +462,9 @@ class Source(Enum):
     import_ = 'import'
 
 
-class StreamRunStatus(Enum):
+class MonitorRunStatus(Enum):
     """
-    The status of the Stream Run
+    The status of the Monitor Run
     """
 
     created = 'created'
@@ -470,45 +473,45 @@ class StreamRunStatus(Enum):
     canceled = 'canceled'
 
 
-class StreamStatus(Enum):
+class MonitorStatus(Enum):
     """
-    The status of the Stream
+    The status of the Monitor
     """
 
-    open = 'open'
-    closed = 'closed'
+    enabled = 'enabled'
+    disabled = 'disabled'
 
 
-class Stream(ExaBaseModel):
+class Monitor(ExaBaseModel):
     id: str
     """
-    The unique identifier for the Stream
+    The unique identifier for the Monitor
     """
-    object: str = 'stream'
+    object: str = 'monitor'
     """
     The type of object
     """
-    status: StreamStatus
+    status: MonitorStatus
     """
-    The status of the Stream
+    The status of the Monitor
     """
     webset_id: str = Field(..., alias='websetId')
     """
-    The id of the Webset the Stream belongs to
+    The id of the Webset the Monitor belongs to
     """
-    cadence: StreamCadence
+    cadence: MonitorCadence
     """
-    How often the stream will run
+    How often the monitor will run
     """
-    behavior: Union[StreamBehaviorSearch, StreamBehaviorRefresh] = Field(
+    behavior: Union[MonitorBehaviorSearch, MonitorBehaviorRefresh] = Field(
         ..., discriminator='type'
     )
     """
-    Behavior to perform when stream runs
+    Behavior to perform when monitor runs
     """
-    last_run: Optional[StreamRun] = Field(None, alias='lastRun', title='StreamRun')
+    last_run: Optional[MonitorRun] = Field(None, alias='lastRun', title='MonitorRun')
     """
-    The last run of the stream
+    The last run of the monitor
     """
     next_run_at: Optional[datetime] = Field(None, alias='nextRunAt')
     """
@@ -520,72 +523,66 @@ class Stream(ExaBaseModel):
     """
     created_at: datetime = Field(..., alias='createdAt')
     """
-    When the stream was created
+    When the monitor was created
     """
     updated_at: datetime = Field(..., alias='updatedAt')
     """
-    When the stream was last updated
+    When the monitor was last updated
     """
 
 
-class StreamBehaviorRefresh(ExaBaseModel):
+class MonitorBehaviorRefresh(ExaBaseModel):
     type: Literal['refresh']
     config: Union[
-        StreamRefreshBehaviorEnrichmentsConfig, StreamRefreshBehaviorContentsConfig
+        MonitorRefreshBehaviorEnrichmentsConfig, MonitorRefreshBehaviorContentsConfig
     ] = Field(..., discriminator='target')
-    """
-    Specify the target of the refresh
-    """
 
 
-class StreamBehaviorSearch(ExaBaseModel):
+class MonitorBehaviorSearch(ExaBaseModel):
     type: Literal['search']
-    config: StreamBehaviorSearchConfig
+    config: MonitorBehaviorSearchConfig
 
 
-class StreamCadence(ExaBaseModel):
+class MonitorCadence(ExaBaseModel):
     cron: str
     """
-    Cron expression for stream cadence (must be a valid Unix cron with 5 fields). The schedule must trigger at most once per day.
+    Cron expression for monitor cadence (must be a valid Unix cron with 5 fields). The schedule must trigger at most once per day.
     """
     timezone: Optional[str] = 'Etc/UTC'
     """
-    IANA timezone (e.g., "America/New_York")
+    Timezone for the cron expression
     """
 
 
-class StreamRefreshBehaviorContentsConfig(ExaBaseModel):
+class MonitorRefreshBehaviorContentsConfig(ExaBaseModel):
     target: Literal['contents']
 
 
-class StreamRefreshBehaviorEnrichmentsConfig(ExaBaseModel):
+class MonitorRefreshBehaviorEnrichmentsConfig(ExaBaseModel):
     target: Literal['enrichments']
-    enrichments: Optional[StreamRefreshBehaviorEnrichmentsConfigEnrichments] = None
-    """
-    Only refresh specific enrichments
-    """
+    enrichments: Optional[MonitorRefreshBehaviorEnrichmentsConfigEnrichments] = None
 
 
-class StreamRun(ExaBaseModel):
+class MonitorRun(ExaBaseModel):
     id: str
     """
-    The unique identifier for the Stream Run
+    The unique identifier for the Monitor Run
     """
-    object: str = 'stream_run'
+    object: str = 'monitor_run'
     """
     The type of object
     """
-    status: StreamRunStatus
+    status: MonitorRunStatus
     """
-    The status of the Stream Run
+    The status of the Monitor Run
     """
-    stream_id: str = Field(..., alias='streamId')
+    monitor_id: str = Field(..., alias='monitorId')
     """
-    The stream that the run is associated with
+    The monitor that the run is associated with
     """
     type: Type
     """
-    The type of the Stream Run
+    The type of the Monitor Run
     """
     completed_at: Optional[datetime] = Field(None, alias='completedAt')
     """
@@ -611,19 +608,22 @@ class StreamRun(ExaBaseModel):
 
 class Type(Enum):
     """
-    The type of the Stream Run
+    The type of the Monitor Run
     """
 
     search = 'search'
     refresh = 'refresh'
 
 
-class UpdateStream(ExaBaseModel):
-    status: Optional[StreamStatus] = None
+class UpdateMonitor(ExaBaseModel):
+    status: Optional[MonitorStatus] = None
     """
-    The status of the stream.
+    The status of the monitor.
     """
     metadata: Optional[Dict[str, str]] = None
+    """
+    Set of key-value pairs you want to associate with this object.
+    """
 
 
 class UpdateWebhookParameters(ExaBaseModel):
@@ -728,7 +728,7 @@ class WebhookAttempt(ExaBaseModel):
     """
     attempted_at: datetime = Field(..., alias='attemptedAt')
     """
-    The date and time the webhook attempt was made
+    The date and time the attempt was made
     """
 
 
@@ -763,9 +763,9 @@ class Webset(ExaBaseModel):
     """
     The Enrichments to apply to the Webset Items.
     """
-    streams: List[Stream]
+    monitors: List[Monitor]
     """
-    The Streams for the Webset.
+    The Monitors for the Webset.
     """
     metadata: Optional[Dict[str, Any]] = {}
     """
@@ -777,7 +777,7 @@ class Webset(ExaBaseModel):
     """
     updated_at: datetime = Field(..., alias='updatedAt')
     """
-    The date and time the webset was updated
+    The date and time the webset was last updated
     """
 
 
@@ -807,9 +807,7 @@ class WebsetCustomEntity(ExaBaseModel):
     type: Literal['custom']
     description: constr(min_length=2)
     """
-    When you decide to use a custom entity, this is the description of the entity.
-
-    The entity represents what type of results the Webset will return. For example, if you want results to be Job Postings, you might use "Job Postings" as the entity description.
+    The description of the custom entity
     """
 
 
@@ -877,7 +875,7 @@ class WebsetEnrichment(ExaBaseModel):
     """
     updated_at: datetime = Field(..., alias='updatedAt')
     """
-    The date and time the enrichment was updated
+    The date and time the enrichment was last updated
     """
 
 
@@ -981,6 +979,9 @@ class WebsetItemArticleProperties(ExaBaseModel):
     article: WebsetItemArticlePropertiesFields = Field(
         ..., title='WebsetItemArticlePropertiesFields'
     )
+    """
+    The article fields
+    """
 
 
 class WebsetItemArticlePropertiesFields(ExaBaseModel):
@@ -990,7 +991,7 @@ class WebsetItemArticlePropertiesFields(ExaBaseModel):
     """
     published_at: Optional[str] = Field(None, alias='publishedAt')
     """
-    The date and time the article was published
+    The date the article was published
     """
 
 
@@ -1011,6 +1012,9 @@ class WebsetItemCompanyProperties(ExaBaseModel):
     company: WebsetItemCompanyPropertiesFields = Field(
         ..., title='WebsetItemCompanyPropertiesFields'
     )
+    """
+    The company fields
+    """
 
 
 class WebsetItemCompanyPropertiesFields(ExaBaseModel):
@@ -1036,7 +1040,7 @@ class WebsetItemCompanyPropertiesFields(ExaBaseModel):
     """
     logo_url: Optional[AnyUrl] = Field(None, alias='logoUrl')
     """
-    The logo URL of the company
+    The URL of the company logo
     """
 
 
@@ -1071,6 +1075,9 @@ class WebsetItemCustomProperties(ExaBaseModel):
     custom: WebsetItemCustomPropertiesFields = Field(
         ..., title='WebsetItemCustomPropertiesFields'
     )
+    """
+    The custom fields
+    """
 
 
 class WebsetItemCustomPropertiesFields(ExaBaseModel):
@@ -1080,9 +1087,10 @@ class WebsetItemCustomPropertiesFields(ExaBaseModel):
     """
     published_at: Optional[str] = Field(None, alias='publishedAt')
     """
-    The date and time the website was published
+    The date the content was published
     """
 
+
 class WebsetItemEnrichedEvent(ExaBaseModel):
     id: str
     """
@@ -1112,7 +1120,7 @@ class WebsetItemEvaluation(ExaBaseModel):
     """
     references: Optional[List[Reference]] = []
     """
-    The references used to generate the result.
+    The references used to evaluate the criterion
     """
 
 
@@ -1129,6 +1137,9 @@ class WebsetItemPersonProperties(ExaBaseModel):
     person: WebsetItemPersonPropertiesFields = Field(
         ..., title='WebsetItemPersonPropertiesFields'
     )
+    """
+    The person fields
+    """
 
 
 class WebsetItemPersonPropertiesFields(ExaBaseModel):
@@ -1146,7 +1157,7 @@ class WebsetItemPersonPropertiesFields(ExaBaseModel):
     """
     picture_url: Optional[AnyUrl] = Field(None, alias='pictureUrl')
     """
-    The image URL of the person
+    The URL of the person's picture
     """
 
 
@@ -1165,8 +1176,11 @@ class WebsetItemResearchPaperProperties(ExaBaseModel):
     The text content of the research paper
     """
     research_paper: WebsetItemResearchPaperPropertiesFields = Field(
-        ..., alias='researchPaper', title='WebsetItemResearchPaperPropertiesFields'
+        ..., title='WebsetItemResearchPaperPropertiesFields'
     )
+    """
+    The research paper fields
+    """
 
 
 class WebsetItemResearchPaperPropertiesFields(ExaBaseModel):
@@ -1176,7 +1190,7 @@ class WebsetItemResearchPaperPropertiesFields(ExaBaseModel):
     """
     published_at: Optional[str] = Field(None, alias='publishedAt')
     """
-    The date and time the research paper was published
+    The date the research paper was published
     """
 
 
@@ -1265,7 +1279,7 @@ class WebsetSearch(ExaBaseModel):
     """
     updated_at: datetime = Field(..., alias='updatedAt')
     """
-    The date and time the search was updated
+    The date and time the search was last updated
     """
 
 
@@ -1365,5 +1379,5 @@ class WebsetStatus(Enum):
 class GetWebsetResponse(Webset):
     items: Optional[List[WebsetItem]] = None
     """
-    When expand query parameter contains `items`, this will contain the items in the webset
+    The items in the webset
     """

{exa_py-1.14.0.dist-info → exa_py-1.14.2.dist-info}/METADATA

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

{exa_py-1.14.0.dist-info → exa_py-1.14.2.dist-info}/RECORD

@@ -2,27 +2,27 @@ exa_py/__init__.py,sha256=M2GC9oSdoV6m2msboW0vMWWl8wrth4o6gmEV4MYLGG8,66
 exa_py/api.py,sha256=zwTEiIkWa6Gynx5NW9VMMY4Nws63gVDRSmzKdT4v2aY,84903
 exa_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 exa_py/research/__init__.py,sha256=QeY-j6bP4QP5tF9ytX0IeQhJvd0Wn4cJCD69U8pP7kA,271
-exa_py/research/client.py,sha256=oFQpczMcfA20Sn_yq36As8GlFo2u8B77IqVMMRqt3qE,11481
+exa_py/research/client.py,sha256=C2ukFq_dE1xUfhMlHwpD9cY5rDClgn8N92pH4_FEVpE,11901
 exa_py/research/models.py,sha256=j7YgRoMRp2MLgnaij7775x_hJEeV5gksKpfLwmawqxY,3704
 exa_py/utils.py,sha256=Rc1FJjoR9LQ7L_OJM91Sd1GNkbHjcLyEvJENhRix6gc,2405
 exa_py/websets/__init__.py,sha256=uOBAb9VrIHrPKoddGOp2ai2KgWlyUVCLMZqfbGOlboA,70
 exa_py/websets/_generator/pydantic/BaseModel.jinja2,sha256=RUDCmPZVamoVx1WudylscYFfDhGoNNtRYlpTvKjAiuA,1276
-exa_py/websets/client.py,sha256=sC_drkIAV4Umk4IS8aNYN47xYasa2bcHQNxzOwjFYwM,4807
+exa_py/websets/client.py,sha256=G3liUYP5DIlaVSoUIK7r1Jh_TgqHvpahy_oZ5OI9z0g,4811
 exa_py/websets/core/__init__.py,sha256=xOyrFaqtBocMUu321Jpbk7IzIQRNZufSIGJXrKoG-Bg,323
 exa_py/websets/core/base.py,sha256=thVIeRtlabbvueP0dAni5Nwtl9AWYv1I1Mmyc_jlYO0,4086
 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/items/__init__.py,sha256=DCWZJVtRmUjnMEkKdb5gW1LT9cHcb-J8lENMnyyBeKU,71
 exa_py/websets/items/client.py,sha256=oZoYr52WrE76Ox6GyoS9rMn7bTrIpno0FKgIWFtb57U,2796
+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/streams/__init__.py,sha256=Bf0uikT_lGZINZHIeweRrHLN8np953v-jKIYFdS_ilg,118
-exa_py/websets/streams/client.py,sha256=eoGmIjV1rIZvENh2OYu1KmG660aWTUXDM7dNlxvdTxg,3468
-exa_py/websets/streams/runs/__init__.py,sha256=o5A7mgl9KtrqVFN_uCHPxTcKTVI3fmURZPM6_Uowg1g,69
-exa_py/websets/streams/runs/client.py,sha256=ja63-G0Y74YDgsWq30aoa0llIx8I9mIwbCbtACz7zXQ,1204
-exa_py/websets/types.py,sha256=-KmC6N9LMh5fPhhXZslmUyQcSmBqIdPF-qQ27qS4GEw,34756
+exa_py/websets/types.py,sha256=5iD5QHtCbHAkIjeLoLf_D70t5Q59AeyCnN9PN1Z6pZ4,34562
 exa_py/websets/webhooks/__init__.py,sha256=iTPBCxFd73z4RifLQMX6iRECx_6pwlI5qscLNjMOUHE,77
 exa_py/websets/webhooks/client.py,sha256=zsIRMTeJU65yj-zo7Zz-gG02Prtzgcx6utGFSoY4HQQ,4222
-exa_py-1.14.0.dist-info/METADATA,sha256=jOIKH214iEOdk7HE46-tyhST5d9iGvgCaaff12tPxiY,4120
-exa_py-1.14.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-exa_py-1.14.0.dist-info/RECORD,,
+exa_py-1.14.2.dist-info/METADATA,sha256=fkHu-6md_rBhdxa7IgROf-p8nuiMT8SHAAVIPdL1_94,4120
+exa_py-1.14.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+exa_py-1.14.2.dist-info/RECORD,,

exa_py/websets/streams/__init__.py

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

exa_py/websets/streams/client.py

@@ -1,96 +0,0 @@
-from __future__ import annotations
-
-from typing import Dict, Any, Union, Optional
-
-from ..types import (
-    Stream,
-    CreateStreamParameters,
-    UpdateStream,
-    ListStreamsResponse,
-)
-from ..core.base import WebsetsBaseClient
-from .runs import StreamRunsClient
-
-class StreamsClient(WebsetsBaseClient):
-    """Client for managing Streams."""
-    
-    def __init__(self, client):
-        super().__init__(client)
-        self.runs = StreamRunsClient(client)
-
-    def create(self, params: Union[Dict[str, Any], CreateStreamParameters]) -> Stream:
-        """Create a new Stream to continuously keep your Websets updated with fresh data.
-        
-        Streams 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 (CreateStreamParameters): The parameters for creating a stream.
-        
-        Returns:
-            Stream: The created stream.
-        """
-        response = self.request("/v0/streams", data=params)
-        return Stream.model_validate(response)
-
-    def get(self, stream_id: str) -> Stream:
-        """Get a specific stream.
-        
-        Args:
-            stream_id (str): The id of the Stream.
-        
-        Returns:
-            Stream: The retrieved stream.
-        """
-        response = self.request(f"/v0/streams/{stream_id}", method="GET")
-        return Stream.model_validate(response)
-
-    def list(self, *, cursor: Optional[str] = None, limit: Optional[int] = None, webset_id: Optional[str] = None) -> ListStreamsResponse:
-        """List all streams.
-        
-        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 streams for.
-        
-        Returns:
-            ListStreamsResponse: List of streams 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/streams", params=params, method="GET")
-        return ListStreamsResponse.model_validate(response)
-
-    def update(self, stream_id: str, params: Union[Dict[str, Any], UpdateStream]) -> Stream:
-        """Update a stream configuration.
-        
-        Args:
-            stream_id (str): The id of the Stream.
-            params (UpdateStream): The parameters for updating a stream.
-        
-        Returns:
-            Stream: The updated stream.
-        """
-        response = self.request(f"/v0/streams/{stream_id}", data=params, method="PATCH")
-        return Stream.model_validate(response)
-
-    def delete(self, stream_id: str) -> Stream:
-        """Delete a stream.
-        
-        Args:
-            stream_id (str): The id of the Stream.
-        
-        Returns:
-            Stream: The deleted stream.
-        """
-        response = self.request(f"/v0/streams/{stream_id}", method="DELETE")
-        return Stream.model_validate(response) 

exa_py/websets/streams/runs/__init__.py

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

exa_py/websets/streams/runs/client.py

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