feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev%2Fcontext.dev-91dbd4c6ac7e59beea9c160c063dbcc54ab6375444833f1da0d38a3e6c182384.yml
-openapi_spec_hash: 5a827539bca2813c6d0d2bba2c3301a2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev%2Fcontext.dev-d5ca4cac056c38a1cb69c6d9033abe0d2b4d5858ee9a76e1172b23649ab1cca6.yml
+openapi_spec_hash: 8e1dd204746bcfaaf637d93b1d339eb2
 config_hash: 70354330f92ce169beabc98696ebb9a3

src/context/dev/resources/ai.py

@@ -106,6 +106,7 @@ def extract_product(
         self,
         *,
         url: str,
+        max_age_ms: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -121,6 +122,10 @@ def extract_product(
         Args:
           url: The product page URL to extract product data from.
 
+          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 7 days (604800000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           timeout_ms: Optional timeout in milliseconds for the request. Maximum allowed value is
               300000ms (5 minutes).
 
@@ -137,6 +142,7 @@ def extract_product(
             body=maybe_transform(
                 {
                     "url": url,
+                    "max_age_ms": max_age_ms,
                     "timeout_ms": timeout_ms,
                 },
                 ai_extract_product_params.AIExtractProductParams,
@@ -152,6 +158,7 @@ def extract_products(
         self,
         *,
         domain: str,
+        max_age_ms: int | Omit = omit,
         max_products: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -170,6 +177,10 @@ def extract_products(
         Args:
           domain: The domain name to analyze.
 
+          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 7 days (604800000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           max_products: Maximum number of products to extract.
 
           timeout_ms: Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -190,6 +201,7 @@ def extract_products(
         self,
         *,
         direct_url: str,
+        max_age_ms: int | Omit = omit,
         max_products: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -209,6 +221,10 @@ def extract_products(
           direct_url: A specific URL to use directly as the starting point for extraction without
               domain resolution.
 
+          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 7 days (604800000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           max_products: Maximum number of products to extract.
 
           timeout_ms: Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -229,6 +245,7 @@ def extract_products(
         self,
         *,
         domain: str | Omit = omit,
+        max_age_ms: int | Omit = omit,
         max_products: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         direct_url: str | Omit = omit,
@@ -244,6 +261,7 @@ def extract_products(
             body=maybe_transform(
                 {
                     "domain": domain,
+                    "max_age_ms": max_age_ms,
                     "max_products": max_products,
                     "timeout_ms": timeout_ms,
                     "direct_url": direct_url,
@@ -337,6 +355,7 @@ async def extract_product(
         self,
         *,
         url: str,
+        max_age_ms: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -352,6 +371,10 @@ async def extract_product(
         Args:
           url: The product page URL to extract product data from.
 
+          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 7 days (604800000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           timeout_ms: Optional timeout in milliseconds for the request. Maximum allowed value is
               300000ms (5 minutes).
 
@@ -368,6 +391,7 @@ async def extract_product(
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "max_age_ms": max_age_ms,
                     "timeout_ms": timeout_ms,
                 },
                 ai_extract_product_params.AIExtractProductParams,
@@ -383,6 +407,7 @@ async def extract_products(
         self,
         *,
         domain: str,
+        max_age_ms: int | Omit = omit,
         max_products: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -401,6 +426,10 @@ async def extract_products(
         Args:
           domain: The domain name to analyze.
 
+          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 7 days (604800000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           max_products: Maximum number of products to extract.
 
           timeout_ms: Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -421,6 +450,7 @@ async def extract_products(
         self,
         *,
         direct_url: str,
+        max_age_ms: int | Omit = omit,
         max_products: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -440,6 +470,10 @@ async def extract_products(
           direct_url: A specific URL to use directly as the starting point for extraction without
               domain resolution.
 
+          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 7 days (604800000 ms) when
+              omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+
           max_products: Maximum number of products to extract.
 
           timeout_ms: Optional timeout in milliseconds for the request. Maximum allowed value is
@@ -460,6 +494,7 @@ async def extract_products(
         self,
         *,
         domain: str | Omit = omit,
+        max_age_ms: int | Omit = omit,
         max_products: int | Omit = omit,
         timeout_ms: int | Omit = omit,
         direct_url: str | Omit = omit,
@@ -475,6 +510,7 @@ async def extract_products(
             body=await async_maybe_transform(
                 {
                     "domain": domain,
+                    "max_age_ms": max_age_ms,
                     "max_products": max_products,
                     "timeout_ms": timeout_ms,
                     "direct_url": direct_url,

src/context/dev/types/ai_extract_product_params.py

@@ -13,6 +13,13 @@ class AIExtractProductParams(TypedDict, total=False):
     url: Required[str]
     """The product page URL to extract product data from."""
 
+    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 7 days (604800000 ms) when
+    omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+    """
+
     timeout_ms: Annotated[int, PropertyInfo(alias="timeoutMS")]
     """Optional timeout in milliseconds for the request.
 

src/context/dev/types/ai_extract_products_params.py

@@ -14,6 +14,13 @@ class ByDomain(TypedDict, total=False):
     domain: Required[str]
     """The domain name to analyze."""
 
+    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 7 days (604800000 ms) when
+    omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+    """
+
     max_products: Annotated[int, PropertyInfo(alias="maxProducts")]
     """Maximum number of products to extract."""
 
@@ -31,6 +38,13 @@ class ByDirectURL(TypedDict, total=False):
     domain resolution.
     """
 
+    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 7 days (604800000 ms) when
+    omitted. Max is 30 days (2592000000 ms). Set to 0 to always scrape fresh.
+    """
+
     max_products: Annotated[int, PropertyInfo(alias="maxProducts")]
     """Maximum number of products to extract."""
 

tests/api_resources/test_ai.py

@@ -125,6 +125,7 @@ def test_method_extract_product(self, client: ContextDev) -> None:
     def test_method_extract_product_with_all_params(self, client: ContextDev) -> None:
         ai = client.ai.extract_product(
             url="https://example.com",
+            max_age_ms=0,
             timeout_ms=1000,
         )
         assert_matches_type(AIExtractProductResponse, ai, path=["response"])
@@ -168,6 +169,7 @@ def test_method_extract_products_overload_1(self, client: ContextDev) -> None:
     def test_method_extract_products_with_all_params_overload_1(self, client: ContextDev) -> None:
         ai = client.ai.extract_products(
             domain="domain",
+            max_age_ms=0,
             max_products=1,
             timeout_ms=1000,
         )
@@ -212,6 +214,7 @@ def test_method_extract_products_overload_2(self, client: ContextDev) -> None:
     def test_method_extract_products_with_all_params_overload_2(self, client: ContextDev) -> None:
         ai = client.ai.extract_products(
             direct_url="https://example.com",
+            max_age_ms=0,
             max_products=1,
             timeout_ms=1000,
         )
@@ -353,6 +356,7 @@ async def test_method_extract_product(self, async_client: AsyncContextDev) -> No
     async def test_method_extract_product_with_all_params(self, async_client: AsyncContextDev) -> None:
         ai = await async_client.ai.extract_product(
             url="https://example.com",
+            max_age_ms=0,
             timeout_ms=1000,
         )
         assert_matches_type(AIExtractProductResponse, ai, path=["response"])
@@ -396,6 +400,7 @@ async def test_method_extract_products_overload_1(self, async_client: AsyncConte
     async def test_method_extract_products_with_all_params_overload_1(self, async_client: AsyncContextDev) -> None:
         ai = await async_client.ai.extract_products(
             domain="domain",
+            max_age_ms=0,
             max_products=1,
             timeout_ms=1000,
         )
@@ -440,6 +445,7 @@ async def test_method_extract_products_overload_2(self, async_client: AsyncConte
     async def test_method_extract_products_with_all_params_overload_2(self, async_client: AsyncContextDev) -> None:
         ai = await async_client.ai.extract_products(
             direct_url="https://example.com",
+            max_age_ms=0,
             max_products=1,
             timeout_ms=1000,
         )