feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 38
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-b73de7a5f87b3bed7d9e4259bd109cd62f4eb5f61fa082f31fc22d5bf8e69bcc.yml
-openapi_spec_hash: 5dcb5ba9b8487329adc2f89eeb4df7c4
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-b5a46cf886759797353b250da971e46cf66804b825ded9c51609f34d72d1169c.yml
+openapi_spec_hash: 1947de2a731ddab05bfb781f37cd42b6
 config_hash: bff282047fafdad771fb7ec685f56944

src/context/dev/resources/web.py

@@ -2170,6 +2170,7 @@ def web_scrape_sitemap(
         domain: str,
         headers: Dict[str, str] | Omit = omit,
         max_links: int | Omit = omit,
+        search: str | Omit = omit,
         sitemap_url: str | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
         timeout_ms: int | Omit = omit,
@@ -2182,8 +2183,13 @@ def web_scrape_sitemap(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebWebScrapeSitemapResponse:
-        """
-        Crawl an entire website's sitemap and return all discovered page URLs.
+        """Crawl an entire website's sitemap and return all discovered page URLs.
+
+        Pass
+        `search` to have the crawled sitemap filtered down to the pages about a phrase
+        (for example `pricing and plans` or `api authentication docs`), most relevant
+        first — a searched crawl scans the whole sitemap and costs 2 credits instead
+        of 1.
 
         Args:
           domain: Domain to build a sitemap for
@@ -2195,6 +2201,10 @@ def web_scrape_sitemap(
           max_links: Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
               Minimum is 1, maximum is 100,000.
 
+          search: Optional search phrase. When provided, the crawled sitemap is filtered to the
+              pages whose URLs are about that phrase, most relevant first, and the request
+              costs 2 credits instead of 1.
+
           sitemap_url: Optional explicit sitemap URL. When provided, exactly this sitemap is crawled
               instead of discovering the domain's sitemaps.
 
@@ -2234,6 +2244,7 @@ def web_scrape_sitemap(
                         "domain": domain,
                         "headers": headers,
                         "max_links": max_links,
+                        "search": search,
                         "sitemap_url": sitemap_url,
                         "tags": tags,
                         "timeout_ms": timeout_ms,
@@ -4371,6 +4382,7 @@ async def web_scrape_sitemap(
         domain: str,
         headers: Dict[str, str] | Omit = omit,
         max_links: int | Omit = omit,
+        search: str | Omit = omit,
         sitemap_url: str | Omit = omit,
         tags: SequenceNotStr[str] | Omit = omit,
         timeout_ms: int | Omit = omit,
@@ -4383,8 +4395,13 @@ async def web_scrape_sitemap(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebWebScrapeSitemapResponse:
-        """
-        Crawl an entire website's sitemap and return all discovered page URLs.
+        """Crawl an entire website's sitemap and return all discovered page URLs.
+
+        Pass
+        `search` to have the crawled sitemap filtered down to the pages about a phrase
+        (for example `pricing and plans` or `api authentication docs`), most relevant
+        first — a searched crawl scans the whole sitemap and costs 2 credits instead
+        of 1.
 
         Args:
           domain: Domain to build a sitemap for
@@ -4396,6 +4413,10 @@ async def web_scrape_sitemap(
           max_links: Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
               Minimum is 1, maximum is 100,000.
 
+          search: Optional search phrase. When provided, the crawled sitemap is filtered to the
+              pages whose URLs are about that phrase, most relevant first, and the request
+              costs 2 credits instead of 1.
+
           sitemap_url: Optional explicit sitemap URL. When provided, exactly this sitemap is crawled
               instead of discovering the domain's sitemaps.
 
@@ -4435,6 +4456,7 @@ async def web_scrape_sitemap(
                         "domain": domain,
                         "headers": headers,
                         "max_links": max_links,
+                        "search": search,
                         "sitemap_url": sitemap_url,
                         "tags": tags,
                         "timeout_ms": timeout_ms,

src/context/dev/types/web_web_scrape_sitemap_params.py

@@ -28,6 +28,13 @@ class WebWebScrapeSitemapParams(TypedDict, total=False):
     Defaults to 10,000. Minimum is 1, maximum is 100,000.
     """
 
+    search: str
+    """Optional search phrase.
+
+    When provided, the crawled sitemap is filtered to the pages whose URLs are about
+    that phrase, most relevant first, and the request costs 2 credits instead of 1.
+    """
+
     sitemap_url: Annotated[str, PropertyInfo(alias="sitemapUrl")]
     """Optional explicit sitemap URL.
 

src/context/dev/types/web_web_scrape_sitemap_response.py

@@ -50,7 +50,10 @@ class WebWebScrapeSitemapResponse(BaseModel):
     """Indicates success"""
 
     urls: List[str]
-    """Array of discovered page URLs from the sitemap (max 500)"""
+    """Discovered page URLs from the sitemap, up to `maxLinks`.
+
+    When `search` is set these are only the matching pages, most relevant first.
+    """
 
     key_metadata: Optional[KeyMetadata] = None
     """Metadata about the API key used for the request.

tests/api_resources/test_web.py

@@ -633,6 +633,7 @@ def test_method_web_scrape_sitemap_with_all_params(self, client: ContextDev) ->
             domain="xxx",
             headers={"foo": "J!"},
             max_links=1,
+            search="help center and troubleshooting articles",
             sitemap_url="https://example.com",
             tags=["production", "team-alpha"],
             timeout_ms=1,
@@ -1277,6 +1278,7 @@ async def test_method_web_scrape_sitemap_with_all_params(self, async_client: Asy
             domain="xxx",
             headers={"foo": "J!"},
             max_links=1,
+            search="help center and troubleshooting articles",
             sitemap_url="https://example.com",
             tags=["production", "team-alpha"],
             timeout_ms=1,