Merge main into dev

CHANGELOG.md

@@ -1,3 +1,72 @@
+## 0.13.56 (2026-08-04)
+
+### Fix
+
+- Add wikidata entities to Article DTO
+
+## 0.13.55 (2026-07-21)
+
+### Fix
+
+- Add gpt-5.6 and opus-4.8
+- Add claude-sonnet-5 for alert reports
+
+## 0.13.54 (2026-06-25)
+
+### Fix
+
+- Add ability to append date to email subject for alerts
+
+## 0.13.53 (2026-06-18)
+
+### Fix
+
+- Support Python 3.8
+
+## 0.13.52 (2026-06-18)
+
+### Fix
+
+- Allow reports to define timezone
+
+## 0.13.51 (2026-05-30)
+
+### Fix
+
+- Add skip_dedup from the scrapedurl item submission
+
+## 0.13.50 (2026-05-24)
+
+### Fix
+
+- Add usage to searchresponse
+
+## 0.13.49 (2026-05-20)
+
+### Fix
+
+- Add api_key_id hint to Alert response
+
+## 0.13.48 (2026-05-20)
+
+### Fix
+
+- Add crawl_date and content_type to Article response
+
+## 0.13.47 (2026-05-18)
+
+### Fix
+
+- If newline chars cross multiple chunks
+
+## 0.13.46 (2026-05-18)
+
+### Fix
+
+- repsonse
+- Switch to byte streaming to avoid line separators breaking pydantic validation
+- Add byok methods
+
 ## 0.13.45 (2026-05-04)
 
 ### Fix

asknews_sdk/api/chat.py

@@ -64,8 +64,12 @@
     "claude-opus-4-6",
     "claude-opus-4-5-20251101",
     "claude-sonnet-4-6",
+    "claude-sonnet-5",
     "gemini-2.5-flash",
     "o3",
+    "gpt-5.6-sol",
+    "claude-opus-4-8",
+    "gpt-5.6-terra",
 ]
 
 
@@ -171,7 +175,7 @@ def get_chat_completions(
                 (CreateChatCompletionResponseStream.__content_type__, 1.0),
             ],
             stream=stream,
-            stream_type="lines",
+            stream_type="bytes",
         )
 
         if stream:
@@ -770,7 +774,7 @@ def get_deep_news(
                 (CreateDeepNewsResponseStreamSource.__content_type__, 1.0),
             ],
             stream=stream,
-            stream_type="lines",
+            stream_type="bytes",
         )
 
         if stream:
@@ -936,7 +940,7 @@ async def get_chat_completions(
                 (CreateChatCompletionResponseStream.__content_type__, 1.0),
             ],
             stream=stream,
-            stream_type="lines",
+            stream_type="bytes",
         )
 
         if stream:
@@ -1535,7 +1539,7 @@ async def get_deep_news(
                 (CreateDeepNewsResponseStreamSource.__content_type__, 1.0),
             ],
             stream=stream,
-            stream_type="lines",
+            stream_type="bytes",
         )
 
         if stream:

asknews_sdk/dto/alert.py

@@ -25,12 +25,16 @@
     "gemini-2.5-pro",
     "gemini-3-pro",
     "claude-sonnet-4-6",
+    "claude-sonnet-5",
     "claude-opus-4-6",
     "claude-opus-4-5-20251101",
     "gemini-2.5-flash",
     "o3",
     "open-source-best",
     "gemini-3-flash",
+    "gpt-5.6-sol",
+    "claude-opus-4-8",
+    "gpt-5.6-terra",
 ]
 
 
@@ -61,7 +65,10 @@
     "claude-opus-4-5-20251101",
     "claude-opus-4-6",
     "claude-sonnet-4-6",
-    "meta-llama/Meta-Llama-3.1-405B-Instruct",
+    "claude-sonnet-5",
+    "gpt-5.6-sol",
+    "claude-opus-4-8",
+    "gpt-5.6-terra" "meta-llama/Meta-Llama-3.1-405B-Instruct",
     "meta-llama/Meta-Llama-3.3-70B-Instruct",
 ]
 AlertReportModelDefault: AlertReportModel = "claude-sonnet-4-6"
@@ -130,7 +137,7 @@ class DeepNewsSourceParams(DeepNewsParams):
         description=(
             f"The model to use for DeepNews research. Defaults to {DeepNewsSourceModelDefault}"
         ),
-        examples=["claude-sonnet-4-5-20250929"],
+        examples=["claude-sonnet-4-6"],
     )
     search_depth: Optional[int] = Field(
         default=1,
@@ -160,7 +167,7 @@ class DeepNewsReportParams(DeepNewsParams):
         description=(
             f"The model to use for DeepNews research. Defaults to {DeepNewsReportModelDefault}"
         ),
-        examples=["claude-sonnet-4-5-20250929"],
+        examples=["claude-sonnet-4-6"],
     )
     search_depth: Optional[int] = Field(
         default=2,
@@ -281,6 +288,10 @@ class EmailParams(BaseModel):
     asknews_watermark: Optional[bool] = Field(
         default=True, description='Append "Generated by AskNews AI" watermark.'
     )
+    subject_date: Optional[bool] = Field(
+        default=False,
+        description="Whether to include the date in the subject of the email. Defaults to False.",
+    )
 
 
 class GoogleDocsParams(BaseModel):
@@ -338,6 +349,13 @@ class ReportRequestParams(BaseModel):
         default=True,
         description='Append "Generated by AskNews AI" watermark.',
     )
+    timezone: Optional[str] = Field(
+        default="UTC",
+        description=(
+            "The timezone to use for any timestamps in the report. Defaults to UTC. "
+            "Should be a valid tz database name, e.g. 'America/New_York'."
+        ),
+    )
 
 
 class LegacyReportRequest(ReportRequestParams):
@@ -675,3 +693,4 @@ class AlertResponse(BaseSchema):
     alert_type: Optional[AlertType] = None
     title: Optional[str] = None
     seat_id: Optional[UUID] = None
+    api_key_id: Optional[str] = None

asknews_sdk/dto/base.py

@@ -69,6 +69,15 @@ class Entities(BaseModel):
     Science: Annotated[Optional[List[str]], Field([], title="Science")]
 
 
+class WikidataEntity(BaseModel):
+    title: Annotated[str, Field(title="Title")]
+    qid: Annotated[str, Field(title="Qid")]
+    relevance: Annotated[float, Field(title="Relevance")]
+    description: Annotated[Optional[str], Field(None, title="Description")]
+    # Original GLiNER/graph surface form before Wikidata disambiguation.
+    source_mention: Annotated[Optional[str], Field(None, title="Source Mention")]
+
+
 class Author(BaseModel):
     email: Optional[str] = None
     name: Optional[str] = None
@@ -85,6 +94,9 @@ class Article(BaseModel):
     domain_url: Annotated[str, Field(title="Domain Url")]
     eng_title: Annotated[str, Field(title="Eng Title")]
     entities: Annotated[Entities, Field(title="Entities")]
+    wikidata_entities: Annotated[
+        Optional[Dict[str, List[WikidataEntity]]], Field(None, title="Wikidata Entities")
+    ] = None
     image_url: Annotated[Optional[str], Field(None, title="Image Url")]
     keywords: Annotated[List[str], Field(title="Keywords")]
     language: Annotated[str, Field(title="Language")]
@@ -139,6 +151,25 @@ class Article(BaseModel):
     full_text: Optional[str] = None
     image_description: Optional[str] = None
     original_language_summary: Optional[str] = None
+    crawl_date: Optional[AwareDatetime] = None
+    content_type: Optional[
+        Literal[
+            "news",
+            "opinion",
+            "analysis",
+            "review",
+            "listicle",
+            "guide",
+            "interview",
+            "profile",
+            "forum",
+            "liveblog",
+            "fact-check",
+            "press_release",
+            "obituary",
+            "data_journalism",
+        ]
+    ] = None
 
 
 class PingResponse(BaseSchema):

asknews_sdk/dto/news.py

@@ -14,11 +14,16 @@ class SearchResponseDictItem(Article):
     as_string_key: Annotated[str, Field(title="As String Key")]
 
 
+class Usage(BaseModel):
+    credits: int
+
+
 class SearchResponse(BaseSchema):
     as_dicts: Annotated[Optional[List[SearchResponseDictItem]], Field(None, title="As Dicts")]
     as_string: Annotated[Optional[str], Field(None, title="As String")]
     offset: Annotated[Optional[Union[int, str]], Field(None, title="Offset")]
     hit_cache: Annotated[Optional[bool], Field(None, title="Hit Cache")]
+    usage: Optional[Usage] = None
 
 
 class SourceReportItem(BaseModel):
@@ -81,6 +86,7 @@ class ScrapeDataItem(BaseModel):
 class ScrapedURLItem(BaseModel):
     url: Annotated[str, Field(title="URL")]
     data: Annotated[Optional[ScrapeDataItem], Field(title="Data")] = None
+    skip_dedupe: Annotated[bool, Field(title="Skip Dedupe check")] = False
     metadata: Annotated[Optional[Dict], Field(title="Metadata")] = None
     enrichments: Annotated[Optional[Dict], Field(title="Enrichments")] = None