feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev%2Fcontext.dev-3020cfc216e9d0b8f59d6ec1c186c857531dc20a6536746e2a28d00261c70ad2.yml
-openapi_spec_hash: 6bb12c5f849e2523bb813e9f56804832
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev%2Fcontext.dev-ca8e38b0f28a9967dab631b8868f1d59bc035fd994a717e0125c77ca592bd105.yml
+openapi_spec_hash: ef0a5df01201a032dcc41f9a25b733e6
 config_hash: 7d13dca2b2c6f71fc463cb6062efa5ea

src/context/dev/resources/web.py

@@ -251,6 +251,7 @@ def web_crawl_md(
         follow_subdomains: bool | Omit = omit,
         include_images: bool | Omit = omit,
         include_links: bool | Omit = omit,
+        max_age_ms: int | Omit = omit,
         max_depth: int | Omit = omit,
         max_pages: int | Omit = omit,
         shorten_base64_images: bool | Omit = omit,
@@ -278,6 +279,10 @@ def web_crawl_md(
 
           include_links: Preserve hyperlinks in the Markdown output
 
+          max_age_ms: Return a cached result if a prior scrape for the same parameters exists and is
+              younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           max_depth: Maximum link depth from the starting URL (0 = only the starting page)
 
           max_pages: Maximum number of pages to crawl. Hard cap: 500.
@@ -305,6 +310,7 @@ def web_crawl_md(
                     "follow_subdomains": follow_subdomains,
                     "include_images": include_images,
                     "include_links": include_links,
+                    "max_age_ms": max_age_ms,
                     "max_depth": max_depth,
                     "max_pages": max_pages,
                     "shorten_base64_images": shorten_base64_images,
@@ -738,6 +744,7 @@ async def web_crawl_md(
         follow_subdomains: bool | Omit = omit,
         include_images: bool | Omit = omit,
         include_links: bool | Omit = omit,
+        max_age_ms: int | Omit = omit,
         max_depth: int | Omit = omit,
         max_pages: int | Omit = omit,
         shorten_base64_images: bool | Omit = omit,
@@ -765,6 +772,10 @@ async def web_crawl_md(
 
           include_links: Preserve hyperlinks in the Markdown output
 
+          max_age_ms: Return a cached result if a prior scrape for the same parameters exists and is
+              younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           max_depth: Maximum link depth from the starting URL (0 = only the starting page)
 
           max_pages: Maximum number of pages to crawl. Hard cap: 500.
@@ -792,6 +803,7 @@ async def web_crawl_md(
                     "follow_subdomains": follow_subdomains,
                     "include_images": include_images,
                     "include_links": include_links,
+                    "max_age_ms": max_age_ms,
                     "max_depth": max_depth,
                     "max_pages": max_pages,
                     "shorten_base64_images": shorten_base64_images,

src/context/dev/types/web_web_crawl_md_params.py

@@ -26,6 +26,13 @@ class WebWebCrawlMdParams(TypedDict, total=False):
     include_links: Annotated[bool, PropertyInfo(alias="includeLinks")]
     """Preserve hyperlinks in the Markdown output"""
 
+    max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
+    """
+    Return a cached result if a prior scrape for the same parameters exists and is
+    younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+    omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+    """
+
     max_depth: Annotated[int, PropertyInfo(alias="maxDepth")]
     """Maximum link depth from the starting URL (0 = only the starting page)"""
 

tests/api_resources/test_web.py

@@ -158,6 +158,7 @@ def test_method_web_crawl_md_with_all_params(self, client: ContextDev) -> None:
             follow_subdomains=True,
             include_images=True,
             include_links=True,
+            max_age_ms=0,
             max_depth=0,
             max_pages=1,
             shorten_base64_images=True,
@@ -498,6 +499,7 @@ async def test_method_web_crawl_md_with_all_params(self, async_client: AsyncCont
             follow_subdomains=True,
             include_images=True,
             include_links=True,
+            max_age_ms=0,
             max_depth=0,
             max_pages=1,
             shorten_base64_images=True,