Merge pull request #33 from context-dot-dev/release-please--branches--main--changes--next

release: 0.28.0

Author: YahiaBakour

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.27.0"
+  ".": "0.28.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 24
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-cc8ca2c80e73bdcff491c96d9289c9e88d831215375ef83632cc51f8e8e06183.yml
-openapi_spec_hash: bf55dce481efcf2f24bc9ff59c2e3f61
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-1785aa93e6fb2784640a4c32eb0221f0b31aa06644d090f72f8533524aeef7c6.yml
+openapi_spec_hash: 7dc1fadcec32637e795f641a0e97c63e
 config_hash: cf2c7f48b329e0a61612b30cd2755ad1

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.28.0 (2026-06-01)
+
+Full Changelog: [v0.27.0...v0.28.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.27.0...v0.28.0)
+
+### Features
+
+* **api:** api update ([cd90e97](https://github.com/context-dot-dev/context-python-sdk/commit/cd90e97f36bc6adcf790522df90edb2640f3f510))
+* **api:** api update ([edeabb0](https://github.com/context-dot-dev/context-python-sdk/commit/edeabb036e0a5f8730fd0175fcd2fd42d4156b05))
+* **api:** api update ([5b94819](https://github.com/context-dot-dev/context-python-sdk/commit/5b9481966d0e279462f6cdea930cd738871239ee))
+
 ## 0.27.0 (2026-05-31)
 
 Full Changelog: [v0.26.0...v0.27.0](https://github.com/context-dot-dev/context-python-sdk/compare/v0.26.0...v0.27.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "context.dev"
-version = "0.27.0"
+version = "0.28.0"
 description = "The official Python library for the context.dev API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/context/dev/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "context.dev"
-__version__ = "0.27.0"  # x-release-please-version
+__version__ = "0.28.0"  # x-release-please-version

src/context/dev/resources/web.py

@@ -86,10 +86,8 @@ def extract(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebExtractResponse:
         """
-        Crawl a website, convert pages to Markdown using the scrape cache, and extract
-        structured data into the provided JSON Schema. The schema must describe the
-        response data object. This endpoint does not accept targeted page-type
-        selection.
+        Crawl a website, use the provided JSON Schema and instructions to prioritize
+        relevant internal links, and extract structured data from the selected pages.
 
         Args:
           schema: JSON Schema for the returned data object. TypeScript Zod users can pass a JSON
@@ -99,12 +97,12 @@ def extract(
           url: The starting website URL to crawl and extract from. Must include http:// or
               https://.
 
-          fact_check: When true (default), every returned value must be grounded in facts stated on
-              the page; fields that cannot be supported by the page are returned as
-              null/empty. When false, the model may make reasonable inferences and derivations
-              from the page content (e.g. ideal customer, competitor analysis,
-              recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-              metrics) faithful to the source.
+          fact_check: When true, every returned value must be grounded in facts stated on the page;
+              fields that cannot be supported by the page are returned as null/empty. When
+              false (default), the model may make reasonable inferences and derivations from
+              the page content (e.g. ideal customer, competitor analysis, recommendations)
+              while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+              faithful to the source.
 
           follow_subdomains: When true, follow links on subdomains of the starting URL's domain.
 
@@ -114,7 +112,7 @@ def extract(
               interpret fields in the schema.
 
           max_age_ms: Return cached scrape results if a prior scrape for the same parameters is
-              younger than this many milliseconds.
+              younger than this many milliseconds. Defaults to 7 days (604800000 ms).
 
           stop_after_ms: Soft time budget for the crawl in milliseconds.
 
@@ -876,10 +874,8 @@ async def extract(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> WebExtractResponse:
         """
-        Crawl a website, convert pages to Markdown using the scrape cache, and extract
-        structured data into the provided JSON Schema. The schema must describe the
-        response data object. This endpoint does not accept targeted page-type
-        selection.
+        Crawl a website, use the provided JSON Schema and instructions to prioritize
+        relevant internal links, and extract structured data from the selected pages.
 
         Args:
           schema: JSON Schema for the returned data object. TypeScript Zod users can pass a JSON
@@ -889,12 +885,12 @@ async def extract(
           url: The starting website URL to crawl and extract from. Must include http:// or
               https://.
 
-          fact_check: When true (default), every returned value must be grounded in facts stated on
-              the page; fields that cannot be supported by the page are returned as
-              null/empty. When false, the model may make reasonable inferences and derivations
-              from the page content (e.g. ideal customer, competitor analysis,
-              recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-              metrics) faithful to the source.
+          fact_check: When true, every returned value must be grounded in facts stated on the page;
+              fields that cannot be supported by the page are returned as null/empty. When
+              false (default), the model may make reasonable inferences and derivations from
+              the page content (e.g. ideal customer, competitor analysis, recommendations)
+              while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+              faithful to the source.
 
           follow_subdomains: When true, follow links on subdomains of the starting URL's domain.
 
@@ -904,7 +900,7 @@ async def extract(
               interpret fields in the schema.
 
           max_age_ms: Return cached scrape results if a prior scrape for the same parameters is
-              younger than this many milliseconds.
+              younger than this many milliseconds. Defaults to 7 days (604800000 ms).
 
           stop_after_ms: Soft time budget for the crawl in milliseconds.
 

src/context/dev/types/web_extract_params.py

@@ -26,12 +26,12 @@ class WebExtractParams(TypedDict, total=False):
 
     fact_check: Annotated[bool, PropertyInfo(alias="factCheck")]
     """
-    When true (default), every returned value must be grounded in facts stated on
-    the page; fields that cannot be supported by the page are returned as
-    null/empty. When false, the model may make reasonable inferences and derivations
-    from the page content (e.g. ideal customer, competitor analysis,
-    recommendations) while keeping verifiable specifics (names, quotes, URLs, dates,
-    metrics) faithful to the source.
+    When true, every returned value must be grounded in facts stated on the page;
+    fields that cannot be supported by the page are returned as null/empty. When
+    false (default), the model may make reasonable inferences and derivations from
+    the page content (e.g. ideal customer, competitor analysis, recommendations)
+    while keeping verifiable specifics (names, quotes, URLs, dates, metrics)
+    faithful to the source.
     """
 
     follow_subdomains: Annotated[bool, PropertyInfo(alias="followSubdomains")]
@@ -49,7 +49,7 @@ class WebExtractParams(TypedDict, total=False):
     max_age_ms: Annotated[int, PropertyInfo(alias="maxAgeMs")]
     """
     Return cached scrape results if a prior scrape for the same parameters is
-    younger than this many milliseconds.
+    younger than this many milliseconds. Defaults to 7 days (604800000 ms).
     """
 
     pdf: Pdf