fix(openapi): document exclusive news filters (#1265)

Stainless-Generated-From: 1a70e0e

Author: stlc-bot

src/context/dev/resources/news.py

@@ -64,16 +64,19 @@ def search(
         """
         Searches live and historical company news for one company, identified in
         searchBy by name, domain, ticker (optionally disambiguated by exchange), or
-        ISIN. Results can be filtered by publisher domain, publisher country, article
-        language, article type, and published-at date, and include stable story IDs,
-        source metadata, verified entity relevance, and cursor pagination.
+        ISIN. Results can be filtered by one of publisher domain, publisher country,
+        article language, or article type, optionally combined with a published-at date
+        range, and include stable story IDs, source metadata, verified entity relevance,
+        and cursor pagination.
 
         Args:
           search_by: What to search for.
 
           cursor: Opaque next_cursor from the previous response, or null for the first page.
 
-          filter_by: Optional result filters.
+          filter_by: Optional result filters. Use at most one of sourceDomain, sourceCountry,
+              articleLanguage, or articleType. A date range may accompany that category;
+              date.from must not exceed date.to.
 
           limit: Maximum results to return. Defaults to 10.
 
@@ -150,16 +153,19 @@ async def search(
         """
         Searches live and historical company news for one company, identified in
         searchBy by name, domain, ticker (optionally disambiguated by exchange), or
-        ISIN. Results can be filtered by publisher domain, publisher country, article
-        language, article type, and published-at date, and include stable story IDs,
-        source metadata, verified entity relevance, and cursor pagination.
+        ISIN. Results can be filtered by one of publisher domain, publisher country,
+        article language, or article type, optionally combined with a published-at date
+        range, and include stable story IDs, source metadata, verified entity relevance,
+        and cursor pagination.
 
         Args:
           search_by: What to search for.
 
           cursor: Opaque next_cursor from the previous response, or null for the first page.
 
-          filter_by: Optional result filters.
+          filter_by: Optional result filters. Use at most one of sourceDomain, sourceCountry,
+              articleLanguage, or articleType. A date range may accompany that category;
+              date.from must not exceed date.to.
 
           limit: Maximum results to return. Defaults to 10.
 

src/context/dev/types/news_search_params.py

@@ -30,7 +30,11 @@ class NewsSearchParams(TypedDict, total=False):
     """Opaque next_cursor from the previous response, or null for the first page."""
 
     filter_by: Annotated[FilterBy, PropertyInfo(alias="filterBy")]
-    """Optional result filters."""
+    """Optional result filters.
+
+    Use at most one of sourceDomain, sourceCountry, articleLanguage, or articleType.
+    A date range may accompany that category; date.from must not exceed date.to.
+    """
 
     limit: int
     """Maximum results to return. Defaults to 10."""
@@ -185,14 +189,17 @@ class SearchBy(TypedDict, total=False):
 
 
 class FilterByDate(_FilterByDateReservedKeywords, total=False):
-    """Published-at window in epoch milliseconds."""
+    """Published-at window in epoch milliseconds. from must be before or equal to to."""
 
     to: int
     """Inclusive end of the published-at window, in epoch milliseconds."""
 
 
 class FilterBy(TypedDict, total=False):
-    """Optional result filters."""
+    """Optional result filters.
+
+    Use at most one of sourceDomain, sourceCountry, articleLanguage, or articleType. A date range may accompany that category; date.from must not exceed date.to.
+    """
 
     article_language: Annotated[
         List[Literal["ar", "de", "en", "es", "fr", "hi", "it", "ja", "ko", "nl", "pt", "ru", "zh"]],
@@ -206,7 +213,7 @@ class FilterBy(TypedDict, total=False):
     """Article types to include. Up to 3."""
 
     date: FilterByDate
-    """Published-at window in epoch milliseconds."""
+    """Published-at window in epoch milliseconds. from must be before or equal to to."""
 
     source_country: Annotated[
         List[