feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 29
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-ea4f36d262d32250c0626d46b9df01e15fd17dec54928c712284693c8be487d2.yml
-openapi_spec_hash: 33fe53c36120b880472d3743ba2bd898
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-190c8939f11afec54c1c0303cb21e7164a350fb66c5fe8fb5ae970e809dfb066.yml
+openapi_spec_hash: 65e3c8513e047a95bcf276b6f88045a6
 config_hash: ff35e224e809656528c44163aa41bebd

src/context/dev/types/monitor_create_params.py

@@ -61,7 +61,7 @@ class ChangeDetectionMonitorsExactChangeDetection(TypedDict, total=False):
 
 class ChangeDetectionMonitorsSemanticChangeDetection(TypedDict, total=False):
     """
-    Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+    Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
     """
 
     type: Required[Literal["semantic"]]
@@ -128,7 +128,7 @@ class TargetMonitorsSitemapTarget(TypedDict, total=False):
 class TargetMonitorsExtractTarget(TypedDict, total=False):
     """Watch the monitor-relevant pages of a site for meaningful changes.
 
-    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
     """
 
     instructions: Required[str]
@@ -153,9 +153,13 @@ class TargetMonitorsExtractTarget(TypedDict, total=False):
     schema: Dict[str, object]
     """JSON Schema describing the data you care about.
 
-    It guides which pages are selected for tracking and gives the change judge
-    context on what matters. If omitted, a default summary + key-points schema is
-    used.
+    It is used three ways: it guides which pages are selected for tracking, it gives
+    the change judge extra context on which changes matter (alongside
+    `instructions`), and it defines the shape of the baseline `data` snapshot on GET
+    /monitors/{monitor_id} (refreshed at most about once a day). It is not a
+    response format for changes: change events and webhook payloads always contain
+    diffs, summaries, and evidence excerpts — never data in this schema's shape. If
+    omitted, a default summary + key-points schema is used.
     """
 
 

src/context/dev/types/monitor_create_response.py

@@ -39,7 +39,7 @@ class ChangeDetectionMonitorsExactChangeDetection(BaseModel):
 
 class ChangeDetectionMonitorsSemanticChangeDetection(BaseModel):
     """
-    Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+    Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
     """
 
     type: Literal["semantic"]
@@ -107,7 +107,7 @@ class TargetMonitorsSitemapTarget(BaseModel):
 class TargetMonitorsExtractTarget(BaseModel):
     """Watch the monitor-relevant pages of a site for meaningful changes.
 
-    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
     """
 
     instructions: str
@@ -132,9 +132,13 @@ class TargetMonitorsExtractTarget(BaseModel):
     schema_: Optional[Dict[str, object]] = FieldInfo(alias="schema", default=None)
     """JSON Schema describing the data you care about.
 
-    It guides which pages are selected for tracking and gives the change judge
-    context on what matters. If omitted, a default summary + key-points schema is
-    used.
+    It is used three ways: it guides which pages are selected for tracking, it gives
+    the change judge extra context on which changes matter (alongside
+    `instructions`), and it defines the shape of the baseline `data` snapshot on GET
+    /monitors/{monitor_id} (refreshed at most about once a day). It is not a
+    response format for changes: change events and webhook payloads always contain
+    diffs, summaries, and evidence excerpts — never data in this schema's shape. If
+    omitted, a default summary + key-points schema is used.
     """
 
 

src/context/dev/types/monitor_list_response.py

@@ -40,7 +40,7 @@ class DataChangeDetectionMonitorsExactChangeDetection(BaseModel):
 
 class DataChangeDetectionMonitorsSemanticChangeDetection(BaseModel):
     """
-    Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+    Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
     """
 
     type: Literal["semantic"]
@@ -108,7 +108,7 @@ class DataTargetMonitorsSitemapTarget(BaseModel):
 class DataTargetMonitorsExtractTarget(BaseModel):
     """Watch the monitor-relevant pages of a site for meaningful changes.
 
-    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
     """
 
     instructions: str
@@ -133,9 +133,13 @@ class DataTargetMonitorsExtractTarget(BaseModel):
     schema_: Optional[Dict[str, object]] = FieldInfo(alias="schema", default=None)
     """JSON Schema describing the data you care about.
 
-    It guides which pages are selected for tracking and gives the change judge
-    context on what matters. If omitted, a default summary + key-points schema is
-    used.
+    It is used three ways: it guides which pages are selected for tracking, it gives
+    the change judge extra context on which changes matter (alongside
+    `instructions`), and it defines the shape of the baseline `data` snapshot on GET
+    /monitors/{monitor_id} (refreshed at most about once a day). It is not a
+    response format for changes: change events and webhook payloads always contain
+    diffs, summaries, and evidence excerpts — never data in this schema's shape. If
+    omitted, a default summary + key-points schema is used.
     """
 
 

src/context/dev/types/monitor_retrieve_response.py

@@ -39,7 +39,7 @@ class ChangeDetectionMonitorsExactChangeDetection(BaseModel):
 
 class ChangeDetectionMonitorsSemanticChangeDetection(BaseModel):
     """
-    Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+    Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
     """
 
     type: Literal["semantic"]
@@ -107,7 +107,7 @@ class TargetMonitorsSitemapTarget(BaseModel):
 class TargetMonitorsExtractTarget(BaseModel):
     """Watch the monitor-relevant pages of a site for meaningful changes.
 
-    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
     """
 
     instructions: str
@@ -132,9 +132,13 @@ class TargetMonitorsExtractTarget(BaseModel):
     schema_: Optional[Dict[str, object]] = FieldInfo(alias="schema", default=None)
     """JSON Schema describing the data you care about.
 
-    It guides which pages are selected for tracking and gives the change judge
-    context on what matters. If omitted, a default summary + key-points schema is
-    used.
+    It is used three ways: it guides which pages are selected for tracking, it gives
+    the change judge extra context on which changes matter (alongside
+    `instructions`), and it defines the shape of the baseline `data` snapshot on GET
+    /monitors/{monitor_id} (refreshed at most about once a day). It is not a
+    response format for changes: change events and webhook payloads always contain
+    diffs, summaries, and evidence excerpts — never data in this schema's shape. If
+    omitted, a default summary + key-points schema is used.
     """
 
 

src/context/dev/types/monitor_update_params.py

@@ -57,7 +57,7 @@ class ChangeDetectionMonitorsExactChangeDetection(TypedDict, total=False):
 
 class ChangeDetectionMonitorsSemanticChangeDetection(TypedDict, total=False):
     """
-    Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+    Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
     """
 
     type: Required[Literal["semantic"]]
@@ -124,7 +124,7 @@ class TargetMonitorsSitemapTarget(TypedDict, total=False):
 class TargetMonitorsExtractTarget(TypedDict, total=False):
     """Watch the monitor-relevant pages of a site for meaningful changes.
 
-    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
     """
 
     instructions: Required[str]
@@ -149,9 +149,13 @@ class TargetMonitorsExtractTarget(TypedDict, total=False):
     schema: Dict[str, object]
     """JSON Schema describing the data you care about.
 
-    It guides which pages are selected for tracking and gives the change judge
-    context on what matters. If omitted, a default summary + key-points schema is
-    used.
+    It is used three ways: it guides which pages are selected for tracking, it gives
+    the change judge extra context on which changes matter (alongside
+    `instructions`), and it defines the shape of the baseline `data` snapshot on GET
+    /monitors/{monitor_id} (refreshed at most about once a day). It is not a
+    response format for changes: change events and webhook payloads always contain
+    diffs, summaries, and evidence excerpts — never data in this schema's shape. If
+    omitted, a default summary + key-points schema is used.
     """
 
 

src/context/dev/types/monitor_update_response.py

@@ -39,7 +39,7 @@ class ChangeDetectionMonitorsExactChangeDetection(BaseModel):
 
 class ChangeDetectionMonitorsSemanticChangeDetection(BaseModel):
     """
-    Detect meaning-level changes to the extracted data, ignoring cosmetic or paraphrase-only differences. What is watched is determined by the extract target's `schema` and `instructions`.
+    Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
     """
 
     type: Literal["semantic"]
@@ -107,7 +107,7 @@ class TargetMonitorsSitemapTarget(BaseModel):
 class TargetMonitorsExtractTarget(BaseModel):
     """Watch the monitor-relevant pages of a site for meaningful changes.
 
-    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged against the monitor's instructions. The tracked page set is refreshed by a periodic re-discovery crawl.
+    A crawl guided by `schema`/`instructions` selects up to `max_pages` relevant pages to track; each run re-checks exactly those pages, and confirmed content changes are judged for relevance against the monitor's `instructions` (and `schema`, when provided). The tracked page set is refreshed by a periodic re-discovery crawl.
     """
 
     instructions: str
@@ -132,9 +132,13 @@ class TargetMonitorsExtractTarget(BaseModel):
     schema_: Optional[Dict[str, object]] = FieldInfo(alias="schema", default=None)
     """JSON Schema describing the data you care about.
 
-    It guides which pages are selected for tracking and gives the change judge
-    context on what matters. If omitted, a default summary + key-points schema is
-    used.
+    It is used three ways: it guides which pages are selected for tracking, it gives
+    the change judge extra context on which changes matter (alongside
+    `instructions`), and it defines the shape of the baseline `data` snapshot on GET
+    /monitors/{monitor_id} (refreshed at most about once a day). It is not a
+    response format for changes: change events and webhook payloads always contain
+    diffs, summaries, and evidence excerpts — never data in this schema's shape. If
+    omitted, a default summary + key-points schema is used.
     """