feat(scrape): default cache age to three days and allow one year (#1339)

Stainless-Generated-From: 693ff37

Author: stlc-bot

src/context/dev/resources/web.py

@@ -380,7 +380,7 @@ def scrape(
           markdown_params: Markdown options. Requires `formats.markdown`.
 
           max_age_ms: Maximum age of a cached output, in milliseconds. `0` fetches fresh. Defaults to
-              1 day.
+              3 days (259200000 ms). Maximum: 1 year (31536000000 ms).
 
           parse_params: Required when formats.parse is true.
 
@@ -1778,7 +1778,7 @@ async def scrape(
           markdown_params: Markdown options. Requires `formats.markdown`.
 
           max_age_ms: Maximum age of a cached output, in milliseconds. `0` fetches fresh. Defaults to
-              1 day.
+              3 days (259200000 ms). Maximum: 1 year (31536000000 ms).
 
           parse_params: Required when formats.parse is true.
 

src/context/dev/types/batch_submit_params.py

@@ -346,7 +346,11 @@ class InputScrapeDataMarkdownOptions(TypedDict, total=False):
     """
 
     max_age_ms: Annotated[Optional[int], PropertyInfo(alias="maxAgeMs")]
-    """Maximum cache age in milliseconds. Defaults to 1 day. `0` fetches fresh."""
+    """Maximum cache age in milliseconds.
+
+    Defaults to 3 days (259200000 ms). Maximum: 1 year (31536000000 ms). `0` fetches
+    fresh.
+    """
 
     pdf: InputScrapeDataMarkdownOptionsPdf
     """PDF parsing controls.
@@ -647,7 +651,11 @@ class InputScrapeDataHTMLOptions(TypedDict, total=False):
     """
 
     max_age_ms: Annotated[Optional[int], PropertyInfo(alias="maxAgeMs")]
-    """Maximum cache age in milliseconds. Defaults to 1 day. `0` fetches fresh."""
+    """Maximum cache age in milliseconds.
+
+    Defaults to 3 days (259200000 ms). Maximum: 1 year (31536000000 ms). `0` fetches
+    fresh.
+    """
 
     pdf: InputScrapeDataHTMLOptionsPdf
     """PDF parsing controls.
@@ -1021,7 +1029,11 @@ class InputCrawlDataMarkdownOptions(TypedDict, total=False):
     """
 
     max_age_ms: Annotated[Optional[int], PropertyInfo(alias="maxAgeMs")]
-    """Maximum cache age in milliseconds. Defaults to 1 day. `0` fetches fresh."""
+    """Maximum cache age in milliseconds.
+
+    Defaults to 3 days (259200000 ms). Maximum: 1 year (31536000000 ms). `0` fetches
+    fresh.
+    """
 
     pdf: InputCrawlDataMarkdownOptionsPdf
     """PDF parsing controls.
@@ -1374,7 +1386,11 @@ class InputCrawlDataHTMLOptions(TypedDict, total=False):
     """
 
     max_age_ms: Annotated[Optional[int], PropertyInfo(alias="maxAgeMs")]
-    """Maximum cache age in milliseconds. Defaults to 1 day. `0` fetches fresh."""
+    """Maximum cache age in milliseconds.
+
+    Defaults to 3 days (259200000 ms). Maximum: 1 year (31536000000 ms). `0` fetches
+    fresh.
+    """
 
     pdf: InputCrawlDataHTMLOptionsPdf
     """PDF parsing controls.

src/context/dev/types/web_scrape_params.py

@@ -58,7 +58,8 @@ class WebScrapeParams(TypedDict, total=False):
     max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
     """Maximum age of a cached output, in milliseconds.
 
-    `0` fetches fresh. Defaults to 1 day.
+    `0` fetches fresh. Defaults to 3 days (259200000 ms). Maximum: 1 year
+    (31536000000 ms).
     """
 
     parse_params: Annotated[ParseParams, PropertyInfo(alias="parseParams")]