feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 41
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-5dbe631ce516ca688273053ddcb58870561bd6dc76fa75df354c954d7af65a3c.yml
-openapi_spec_hash: 53a74c4cccbdec8590db38183840a446
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-5e890b591fcd62757c51fa1decc2cccc3d52d5a83097b10775507e3485776f73.yml
+openapi_spec_hash: 432ee63a7d4ffca7d5993dc0853d9c81
 config_hash: 0fb0ceca5946298c416cec0cca5260c7

src/context/dev/types/news_search_response.py

@@ -10,49 +10,91 @@
 
 
 class DataMatch(BaseModel):
+    """How the article relates to the company you searched for."""
+
     confidence: Optional[float] = None
+    """How confident the match is, from 0 to 1. Null when a score is unavailable."""
 
     level: Literal["primary", "secondary"]
+    """
+    primary when the article is mainly about the company, secondary when the company
+    is mentioned but is not the main subject.
+    """
 
 
 class DataSource(BaseModel):
+    """The publication that published the article."""
+
     direct: bool
     """True when Context observed this article in the publisher-owned feed."""
 
     domain: str
+    """Website domain of the publication."""
 
     name: str
+    """Name of the publication, such as Reuters."""
 
 
 class Data(BaseModel):
     id: str
+    """Stable unique identifier for this article.
+
+    Use it to deduplicate or reference an article across requests.
+    """
 
     authors: List[str]
+    """Bylined authors. Empty when no byline is available."""
 
     description: Optional[str] = None
+    """Short summary or excerpt of the article, when the publisher provides one."""
 
     image_url: Optional[str] = None
+    """Lead image for the article, when one is available."""
 
     language: Optional[str] = None
+    """Language the article is written in, as a lowercase ISO 639-1 code such as en.
+
+    Null when unknown.
+    """
 
     match: DataMatch
+    """How the article relates to the company you searched for."""
 
     published_at: Optional[datetime] = None
+    """When the article was published, as an ISO 8601 timestamp.
+
+    Null when the publisher does not state a reliable date.
+    """
 
     source: DataSource
+    """The publication that published the article."""
 
     story_id: str
-    """Groups matching normalized headlines published on the same UTC day."""
+    """Shared by articles covering the same story on the same day.
+
+    Use it to group or collapse syndicated copies of one announcement across
+    outlets.
+    """
 
     title: str
+    """Article headline."""
 
     type: Literal["editorial", "press_release", "regulatory_filing", "advisory"]
+    """Kind of coverage.
+
+    Use it to separate independent reporting (editorial) from company-issued content
+    (press_release, regulatory_filing, advisory).
+    """
 
     url: str
+    """Link to the article on the publisher site."""
 
 
 class Meta(BaseModel):
+    """Summary information about this response."""
+
     count: int
+    """Number of articles in this page."""
 
 
 class KeyMetadata(BaseModel):
@@ -70,12 +112,19 @@ class KeyMetadata(BaseModel):
 
 class NewsSearchResponse(BaseModel):
     data: List[Data]
+    """Articles matching the search, in the requested order."""
 
     has_more: bool
+    """True when more results are available beyond this page."""
 
     meta: Meta
+    """Summary information about this response."""
 
     next_cursor: Optional[str] = None
+    """Pass as cursor in the next request to fetch the following page.
+
+    Null when there are no more results.
+    """
 
     key_metadata: Optional[KeyMetadata] = None
     """Metadata about the API key used for the request.