linq-python 0.7.0__tar.gz → 0.8.0__tar.gz

linq_python-0.8.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.8.0"
+}

{linq_python-0.7.0 → linq_python-0.8.0}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.8.0 (2026-05-07)
+
+Full Changelog: [v0.7.0...v0.8.0](https://github.com/linq-team/linq-python/compare/v0.7.0...v0.8.0)
+
+### Features
+
+* **chat-service:** expose health_score.updated_at on chat reads + webhooks ([ae5f146](https://github.com/linq-team/linq-python/commit/ae5f1461f6468c48ec88d999d59293e2f364ddd6))
+* remove health_score from synapse — health_status is the contract ([5ec27d1](https://github.com/linq-team/linq-python/commit/5ec27d1544c85532b8d0344b3108a88cf474db90))
+
+
+### Bug Fixes
+
+* **chat-service:** stamp health_status from risk-service sync reply ([ff22296](https://github.com/linq-team/linq-python/commit/ff222969e755bd20e352de665b5e7fe47ea99705))
+
+
+### Chores
+
+* **internal:** reformat pyproject.toml ([3ab97d9](https://github.com/linq-team/linq-python/commit/3ab97d9f5daea08054fba6086ca2c1849289d8ff))
+
+
+### Documentation
+
+* **openapi:** add HealthStatus [BETA] + deprecate HealthScore ([d4e3711](https://github.com/linq-team/linq-python/commit/d4e37118b71348796cb029bed6f3b831c3996941))
+* **openapi:** add named examples to unblock docs OpExample ([6a37d71](https://github.com/linq-team/linq-python/commit/6a37d71c0aa57feefc85810a5012da74153b835f))
+
 ## 0.7.0 (2026-04-30)
 
 Full Changelog: [v0.6.0...v0.7.0](https://github.com/linq-team/linq-python/compare/v0.6.0...v0.7.0)

{linq_python-0.7.0 → linq_python-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.7.0
+Version: 0.8.0
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.7.0 → linq_python-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.7.0"
+version = "0.8.0"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -154,7 +154,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/linq/_files.py', '_dev/.*.py', 'tests/.*']
+exclude = ["src/linq/_files.py", "_dev/.*.py", "tests/.*"]
 
 strict_equality = true
 implicit_reexport = true

{linq_python-0.7.0 → linq_python-0.8.0}/src/linq/_version.py

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

linq_python-0.8.0/src/linq/types/chat.py

@@ -0,0 +1,84 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+
+__all__ = ["Chat", "HealthStatus"]
+
+
+class HealthStatus(BaseModel):
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and delivery signals on the conversation. Many `at_risk` or `critical` chats on a single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    """
+
+    doc_url: str
+    """Deep-link to the relevant section of the Chat Health guide for this status."""
+
+    status: Literal["healthy", "at_risk", "critical", "opted_out"]
+    """Current health bucket for the chat.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
+    and how to react. `doc_url` deep-links to the relevant section.
+    """
+
+    updated_at: datetime
+    """When this status last changed."""
+
+
+class Chat(BaseModel):
+    id: str
+    """Unique identifier for the chat"""
+
+    created_at: datetime
+    """When the chat was created"""
+
+    display_name: Optional[str] = None
+    """Display name for the chat.
+
+    Defaults to a comma-separated list of recipient handles. Can be updated for
+    group chats.
+    """
+
+    handles: List[ChatHandle]
+    """List of chat participants with full handle details.
+
+    Always contains at least two handles (your phone number and the other
+    participant).
+    """
+
+    health_status: HealthStatus
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and
+    delivery signals on the conversation. Many `at_risk` or `critical` chats on a
+    single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is
+    the long-term contract. Each status carries a `doc_url` that deep-links to the
+    relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status
+    means and how to react.
+    """
+
+    is_archived: bool
+    """Whether the chat is archived"""
+
+    is_group: bool
+    """Whether this is a group chat"""
+
+    updated_at: datetime
+    """When the chat was last updated"""
+
+    service: Optional[ServiceType] = None
+    """Messaging service type"""

linq_python-0.8.0/src/linq/types/chat_create_response.py

@@ -0,0 +1,85 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .chats.sent_message import SentMessage
+from .shared.chat_handle import ChatHandle
+from .shared.service_type import ServiceType
+
+__all__ = ["ChatCreateResponse", "Chat", "ChatHealthStatus"]
+
+
+class ChatHealthStatus(BaseModel):
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and delivery signals on the conversation. Many `at_risk` or `critical` chats on a single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    """
+
+    doc_url: str
+    """Deep-link to the relevant section of the Chat Health guide for this status."""
+
+    status: Literal["healthy", "at_risk", "critical", "opted_out"]
+    """Current health bucket for the chat.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
+    and how to react. `doc_url` deep-links to the relevant section.
+    """
+
+    updated_at: datetime
+    """When this status last changed."""
+
+
+class Chat(BaseModel):
+    id: str
+    """Unique identifier for the created chat (UUID)"""
+
+    display_name: Optional[str] = None
+    """Display name for the chat.
+
+    Defaults to a comma-separated list of recipient handles. Can be updated for
+    group chats.
+    """
+
+    handles: List[ChatHandle]
+    """List of participants in the chat.
+
+    Always contains at least two handles (your phone number and the other
+    participant).
+    """
+
+    health_status: ChatHealthStatus
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and
+    delivery signals on the conversation. Many `at_risk` or `critical` chats on a
+    single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is
+    the long-term contract. Each status carries a `doc_url` that deep-links to the
+    relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status
+    means and how to react.
+    """
+
+    is_group: bool
+    """Whether this is a group chat"""
+
+    message: SentMessage
+    """A message that was sent (used in CreateChat and SendMessage responses)"""
+
+    service: ServiceType
+    """Messaging service type"""
+
+
+class ChatCreateResponse(BaseModel):
+    """Response for creating a new chat with an initial message"""
+
+    chat: Chat

{linq_python-0.7.0 → linq_python-0.8.0}/src/linq/types/chat_created_webhook_event.py

@@ -2,13 +2,38 @@
 
 from typing import List, Optional
 from datetime import datetime
+from typing_extensions import Literal
 
 from .._models import BaseModel
 from .shared.chat_handle import ChatHandle
 from .webhook_event_type import WebhookEventType
 from .shared.service_type import ServiceType
 
-__all__ = ["ChatCreatedWebhookEvent", "Data"]
+__all__ = ["ChatCreatedWebhookEvent", "Data", "DataHealthStatus"]
+
+
+class DataHealthStatus(BaseModel):
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and delivery signals on the conversation. Many `at_risk` or `critical` chats on a single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    """
+
+    doc_url: str
+    """Deep-link to the relevant section of the Chat Health guide for this status."""
+
+    status: Literal["healthy", "at_risk", "critical", "opted_out"]
+    """Current health bucket for the chat.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
+    and how to react. `doc_url` deep-links to the relevant section.
+    """
+
+    updated_at: datetime
+    """When this status last changed."""
 
 
 class Data(BaseModel):
@@ -37,6 +62,21 @@ class Data(BaseModel):
     participant).
     """
 
+    health_status: DataHealthStatus
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and
+    delivery signals on the conversation. Many `at_risk` or `critical` chats on a
+    single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is
+    the long-term contract. Each status carries a `doc_url` that deep-links to the
+    relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status
+    means and how to react.
+    """
+
     is_group: bool
     """Whether this is a group chat"""
 

{linq_python-0.7.0 → linq_python-0.8.0}/src/linq/types/message_edited_webhook_event.py

@@ -7,7 +7,31 @@ from .._models import BaseModel
 from .shared.chat_handle import ChatHandle
 from .webhook_event_type import WebhookEventType
 
-__all__ = ["MessageEditedWebhookEvent", "Data", "DataChat", "DataPart"]
+__all__ = ["MessageEditedWebhookEvent", "Data", "DataChat", "DataChatHealthStatus", "DataPart"]
+
+
+class DataChatHealthStatus(BaseModel):
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and delivery signals on the conversation. Many `at_risk` or `critical` chats on a single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
+    """
+
+    doc_url: str
+    """Deep-link to the relevant section of the Chat Health guide for this status."""
+
+    status: Literal["healthy", "at_risk", "critical", "opted_out"]
+    """Current health bucket for the chat.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
+    and how to react. `doc_url` deep-links to the relevant section.
+    """
+
+    updated_at: datetime
+    """When this status last changed."""
 
 
 class DataChat(BaseModel):
@@ -16,6 +40,21 @@ class DataChat(BaseModel):
     id: str
     """Chat identifier"""
 
+    health_status: DataChatHealthStatus
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and
+    delivery signals on the conversation. Many `at_risk` or `critical` chats on a
+    single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is
+    the long-term contract. Each status carries a `doc_url` that deep-links to the
+    relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status
+    means and how to react.
+    """
+
     is_group: bool
     """Whether this is a group chat"""
 

{linq_python-0.7.0 → linq_python-0.8.0}/src/linq/types/message_event_v2.py

@@ -12,21 +12,31 @@ from .schemas_message_effect import SchemasMessageEffect
 from .schemas_text_part_response import SchemasTextPartResponse
 from .schemas_media_part_response import SchemasMediaPartResponse
 
-__all__ = ["MessageEventV2", "Chat", "ChatHealthScore", "Part", "PartSchemasLinkPartResponse", "ReplyTo"]
+__all__ = ["MessageEventV2", "Chat", "ChatHealthStatus", "Part", "PartSchemasLinkPartResponse", "ReplyTo"]
 
 
-class ChatHealthScore(BaseModel):
-    """**[BETA]** Health assessment for a chat.
+class ChatHealthStatus(BaseModel):
+    """**[BETA]** Current health for a chat.
 
-    Higher `score` is healthier.
-    `null` when a score isn't available yet. Scoring may change during beta.
+    Always present — chats start at `healthy` and may shift based on engagement and delivery signals on the conversation. Many `at_risk` or `critical` chats on a single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is the long-term contract. Each status carries a `doc_url` that deep-links to the relevant section of the Chat Health guide.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status means and how to react.
     """
 
-    reason: str
-    """Short summary of what's affecting the score. Empty when the score is 100."""
+    doc_url: str
+    """Deep-link to the relevant section of the Chat Health guide for this status."""
 
-    score: int
-    """Health score from 0 to 100. Higher is healthier."""
+    status: Literal["healthy", "at_risk", "critical", "opted_out"]
+    """Current health bucket for the chat.
+
+    See the [Chat Health guide](/guides/chats/chat-health) for what each value means
+    and how to react. `doc_url` deep-links to the relevant section.
+    """
+
+    updated_at: datetime
+    """When this status last changed."""
 
 
 class Chat(BaseModel):
@@ -35,11 +45,19 @@ class Chat(BaseModel):
     id: str
     """Chat identifier"""
 
-    health_score: Optional[ChatHealthScore] = None
-    """**[BETA]** Health assessment for a chat.
+    health_status: ChatHealthStatus
+    """**[BETA]** Current health for a chat.
+
+    Always present — chats start at `healthy` and may shift based on engagement and
+    delivery signals on the conversation. Many `at_risk` or `critical` chats on a
+    single line increase the risk of line flagging.
+
+    Switch on `status` to gate sends or surface line health in your UI — the enum is
+    the long-term contract. Each status carries a `doc_url` that deep-links to the
+    relevant section of the Chat Health guide.
 
-    Higher `score` is healthier. `null` when a score isn't available yet. Scoring
-    may change during beta.
+    See the [Chat Health guide](/guides/chats/chat-health) for what each status
+    means and how to react.
     """
 
     is_group: Optional[bool] = None

{linq_python-0.7.0 → linq_python-0.8.0}/tests/api_resources/test_contact_card.py

@@ -24,7 +24,7 @@ class TestContactCard:
     @parametrize
     def test_method_create(self, client: LinqAPIV3) -> None:
         contact_card = client.contact_card.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
         )
         assert_matches_type(SetContactCard, contact_card, path=["response"])
@@ -33,10 +33,10 @@ class TestContactCard:
     @parametrize
     def test_method_create_with_all_params(self, client: LinqAPIV3) -> None:
         contact_card = client.contact_card.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
             image_url="https://cdn.linqapp.com/contact-card/example.jpg",
-            last_name="Doe",
+            last_name="Support",
         )
         assert_matches_type(SetContactCard, contact_card, path=["response"])
 
@@ -44,7 +44,7 @@ class TestContactCard:
     @parametrize
     def test_raw_response_create(self, client: LinqAPIV3) -> None:
         response = client.contact_card.with_raw_response.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
         )
 
@@ -57,7 +57,7 @@ class TestContactCard:
     @parametrize
     def test_streaming_response_create(self, client: LinqAPIV3) -> None:
         with client.contact_card.with_streaming_response.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
         ) as response:
             assert not response.is_closed
@@ -159,7 +159,7 @@ class TestAsyncContactCard:
     @parametrize
     async def test_method_create(self, async_client: AsyncLinqAPIV3) -> None:
         contact_card = await async_client.contact_card.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
         )
         assert_matches_type(SetContactCard, contact_card, path=["response"])
@@ -168,10 +168,10 @@ class TestAsyncContactCard:
     @parametrize
     async def test_method_create_with_all_params(self, async_client: AsyncLinqAPIV3) -> None:
         contact_card = await async_client.contact_card.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
             image_url="https://cdn.linqapp.com/contact-card/example.jpg",
-            last_name="Doe",
+            last_name="Support",
         )
         assert_matches_type(SetContactCard, contact_card, path=["response"])
 
@@ -179,7 +179,7 @@ class TestAsyncContactCard:
     @parametrize
     async def test_raw_response_create(self, async_client: AsyncLinqAPIV3) -> None:
         response = await async_client.contact_card.with_raw_response.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
         )
 
@@ -192,7 +192,7 @@ class TestAsyncContactCard:
     @parametrize
     async def test_streaming_response_create(self, async_client: AsyncLinqAPIV3) -> None:
         async with async_client.contact_card.with_streaming_response.create(
-            first_name="John",
+            first_name="Acme",
             phone_number="+15551234567",
         ) as response:
             assert not response.is_closed

linq_python-0.7.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.7.0"
-}

linq_python-0.7.0/src/linq/types/chat.py

@@ -1,65 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from typing import List, Optional
-from datetime import datetime
-
-from .._models import BaseModel
-from .shared.chat_handle import ChatHandle
-from .shared.service_type import ServiceType
-
-__all__ = ["Chat", "HealthScore"]
-
-
-class HealthScore(BaseModel):
-    """**[BETA]** Health assessment for a chat.
-
-    Higher `score` is healthier.
-    `null` when a score isn't available yet. Scoring may change during beta.
-    """
-
-    reason: str
-    """Short summary of what's affecting the score. Empty when the score is 100."""
-
-    score: int
-    """Health score from 0 to 100. Higher is healthier."""
-
-
-class Chat(BaseModel):
-    id: str
-    """Unique identifier for the chat"""
-
-    created_at: datetime
-    """When the chat was created"""
-
-    display_name: Optional[str] = None
-    """Display name for the chat.
-
-    Defaults to a comma-separated list of recipient handles. Can be updated for
-    group chats.
-    """
-
-    handles: List[ChatHandle]
-    """List of chat participants with full handle details.
-
-    Always contains at least two handles (your phone number and the other
-    participant).
-    """
-
-    is_archived: bool
-    """Whether the chat is archived"""
-
-    is_group: bool
-    """Whether this is a group chat"""
-
-    updated_at: datetime
-    """When the chat was last updated"""
-
-    health_score: Optional[HealthScore] = None
-    """**[BETA]** Health assessment for a chat.
-
-    Higher `score` is healthier. `null` when a score isn't available yet. Scoring
-    may change during beta.
-    """
-
-    service: Optional[ServiceType] = None
-    """Messaging service type"""

linq_python-0.7.0/src/linq/types/chat_create_response.py

@@ -1,65 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from typing import List, Optional
-
-from .._models import BaseModel
-from .chats.sent_message import SentMessage
-from .shared.chat_handle import ChatHandle
-from .shared.service_type import ServiceType
-
-__all__ = ["ChatCreateResponse", "Chat", "ChatHealthScore"]
-
-
-class ChatHealthScore(BaseModel):
-    """**[BETA]** Health assessment for a chat.
-
-    Higher `score` is healthier.
-    `null` when a score isn't available yet. Scoring may change during beta.
-    """
-
-    reason: str
-    """Short summary of what's affecting the score. Empty when the score is 100."""
-
-    score: int
-    """Health score from 0 to 100. Higher is healthier."""
-
-
-class Chat(BaseModel):
-    id: str
-    """Unique identifier for the created chat (UUID)"""
-
-    display_name: Optional[str] = None
-    """Display name for the chat.
-
-    Defaults to a comma-separated list of recipient handles. Can be updated for
-    group chats.
-    """
-
-    handles: List[ChatHandle]
-    """List of participants in the chat.
-
-    Always contains at least two handles (your phone number and the other
-    participant).
-    """
-
-    is_group: bool
-    """Whether this is a group chat"""
-
-    message: SentMessage
-    """A message that was sent (used in CreateChat and SendMessage responses)"""
-
-    service: ServiceType
-    """Messaging service type"""
-
-    health_score: Optional[ChatHealthScore] = None
-    """**[BETA]** Health assessment for a chat.
-
-    Higher `score` is healthier. `null` when a score isn't available yet. Scoring
-    may change during beta.
-    """
-
-
-class ChatCreateResponse(BaseModel):
-    """Response for creating a new chat with an initial message"""
-
-    chat: Chat