feat(search): /web/search - for news results extend description with matching passages from article.

Stainless-Generated-From: c8eb4fe

Author: stlc-bot

src/context/dev/resources/web.py

@@ -1023,6 +1023,7 @@ def search(
             "zw",
         ]
         | Omit = omit,
+        description_max_characters: Optional[int] | Omit = omit,
         exclude_domains: SequenceNotStr[str] | Omit = omit,
         freshness: Literal["last_24_hours", "last_week", "last_month", "last_year"] | Omit = omit,
         highlights_options: Optional[web_search_params.HighlightsOptions] | Omit = omit,
@@ -1051,6 +1052,8 @@ def search(
           country: Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific
               country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
 
+          description_max_characters: Maximum length of each result's `description`, in characters.
+
           exclude_domains:
               Blocklist — drop results from these domains. Up to 100 domains. Example:
               ["pinterest.com", "reddit.com"].
@@ -1091,6 +1094,7 @@ def search(
                 {
                     "query": query,
                     "country": country,
+                    "description_max_characters": description_max_characters,
                     "exclude_domains": exclude_domains,
                     "freshness": freshness,
                     "highlights_options": highlights_options,
@@ -2431,6 +2435,7 @@ async def search(
             "zw",
         ]
         | Omit = omit,
+        description_max_characters: Optional[int] | Omit = omit,
         exclude_domains: SequenceNotStr[str] | Omit = omit,
         freshness: Literal["last_24_hours", "last_week", "last_month", "last_year"] | Omit = omit,
         highlights_options: Optional[web_search_params.HighlightsOptions] | Omit = omit,
@@ -2459,6 +2464,8 @@ async def search(
           country: Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific
               country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
 
+          description_max_characters: Maximum length of each result's `description`, in characters.
+
           exclude_domains:
               Blocklist — drop results from these domains. Up to 100 domains. Example:
               ["pinterest.com", "reddit.com"].
@@ -2499,6 +2506,7 @@ async def search(
                 {
                     "query": query,
                     "country": country,
+                    "description_max_characters": description_max_characters,
                     "exclude_domains": exclude_domains,
                     "freshness": freshness,
                     "highlights_options": highlights_options,

src/context/dev/types/web_search_params.py

@@ -272,6 +272,9 @@ class WebSearchParams(TypedDict, total=False):
     country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
     """
 
+    description_max_characters: Annotated[Optional[int], PropertyInfo(alias="descriptionMaxCharacters")]
+    """Maximum length of each result's `description`, in characters."""
+
     exclude_domains: Annotated[SequenceNotStr[str], PropertyInfo(alias="excludeDomains")]
     """Blocklist — drop results from these domains.
 

tests/api_resources/test_web.py

@@ -428,6 +428,7 @@ def test_method_search_with_all_params(self, client: ContextDev) -> None:
         web = client.web.search(
             query="Stripe API authentication",
             country="af",
+            description_max_characters=0,
             exclude_domains=["xxx"],
             freshness="last_24_hours",
             highlights_options={
@@ -969,6 +970,7 @@ async def test_method_search_with_all_params(self, async_client: AsyncContextDev
         web = await async_client.web.search(
             query="Stripe API authentication",
             country="af",
+            description_max_characters=0,
             exclude_domains=["xxx"],
             freshness="last_24_hours",
             highlights_options={