linq-python 0.35.0__tar.gz → 0.36.0__tar.gz

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

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

{linq_python-0.35.0 → linq_python-0.36.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.36.0](https://github.com/linq-team/linq-python/compare/v0.35.1...v0.36.0) (2026-08-28)
+
+
+### Features
+
+* support multiple mentions per message part ([49030ee](https://github.com/linq-team/linq-python/commit/49030ee5414481cca4606b9511aa87177ed83ddf))
+
+## [0.35.1](https://github.com/linq-team/linq-python/compare/v0.35.0...v0.35.1) (2026-08-27)
+
+
+### Bug Fixes
+
+* clarify reputation audit rate limiting and response behavior ([94c274c](https://github.com/linq-team/linq-python/commit/94c274c3b6e85cb8d313397682e0bf065fd5a0d7))
+
 ## [0.35.0](https://github.com/linq-team/linq-python/compare/v0.34.0...v0.35.0) (2026-08-27)
 
 

{linq_python-0.35.0 → linq_python-0.36.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.35.0
+Version: 0.36.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.35.0 → linq_python-0.36.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.35.0"
+version = "0.36.0"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{linq_python-0.35.0 → linq_python-0.36.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.35.0"  # x-release-please-version
+__version__ = "0.36.0"  # x-release-please-version

{linq_python-0.35.0 → linq_python-0.36.0}/src/linq/resources/phone_numbers.py

@@ -188,10 +188,15 @@ class PhoneNumbersResource(SyncAPIResource):
         Starts an asynchronous reputation audit for a line and returns an `audit_id`.
         Poll the GET endpoint for the result.
 
-        Rate limited per line: only one audit may run at a time (a second request
-        returns `409` while the first is still in progress), and a new audit can't be
-        started for the same line until a cooldown elapses (`429`, with `Retry-After`
-        carrying the wait).
+        Rate limited per line: only one audit may run at a time. Starting one while
+        another is still running returns `202` with the running audit's `audit_id`
+        rather than an error, so a retried start picks that audit back up instead of
+        losing it — poll the id you were given.
+
+        Once an audit finishes, a new one can't be started for the same line until a
+        cooldown elapses (`429`, with `Retry-After` carrying the wait). Keep the
+        `audit_id` from the original `202`: it stays readable on the GET endpoint for 24
+        hours, and the cooldown response does not repeat it.
 
         Args:
           extra_headers: Send extra headers
@@ -375,10 +380,15 @@ class AsyncPhoneNumbersResource(AsyncAPIResource):
         Starts an asynchronous reputation audit for a line and returns an `audit_id`.
         Poll the GET endpoint for the result.
 
-        Rate limited per line: only one audit may run at a time (a second request
-        returns `409` while the first is still in progress), and a new audit can't be
-        started for the same line until a cooldown elapses (`429`, with `Retry-After`
-        carrying the wait).
+        Rate limited per line: only one audit may run at a time. Starting one while
+        another is still running returns `202` with the running audit's `audit_id`
+        rather than an error, so a retried start picks that audit back up instead of
+        losing it — poll the id you were given.
+
+        Once an audit finishes, a new one can't be started for the same line until a
+        cooldown elapses (`429`, with `Retry-After` carrying the wait). Keep the
+        `audit_id` from the original `202`: it stays readable on the GET endpoint for 24
+        hours, and the cooldown response does not repeat it.
 
         Args:
           extra_headers: Send extra headers

linq_python-0.36.0/src/linq/types/schemas_text_part_response.py

@@ -0,0 +1,76 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .shared.text_decoration import TextDecoration
+
+__all__ = ["SchemasTextPartResponse", "Mention"]
+
+
+class Mention(BaseModel):
+    """
+    One mention on a text part — who was mentioned, and which characters of `value` are
+    the mention. A part carries one of these per mention, in the order they appear in the
+    text, so a message naming two people has two entries.
+    """
+
+    handle: str
+    """
+    Address of the mentioned participant, exactly as the device recorded it — an
+    E.164 phone number or an email address.
+    """
+
+    is_me: bool
+    """Whether the mentioned participant is this line."""
+
+    range: List[int]
+    """
+    Character range `[start, end)` in `value` highlighted as this mention.
+    _Characters are measured as UTF-16 code units. Most characters count as 1; some
+    emoji count as 2._
+    """
+
+
+class SchemasTextPartResponse(BaseModel):
+    """A text message part"""
+
+    type: Literal["text"]
+    """Indicates this is a text message part"""
+
+    value: str
+    """The text content"""
+
+    mention: Optional[str] = None
+    """DEPRECATED: Use `mentions` instead.
+
+    Handle (E.164 phone number or Apple ID email) of the **first** mention on this
+    part. A part may carry several mentions; this field shows only the first in
+    `value` order, so it cannot be used to determine whether a given participant was
+    mentioned. `null` when the part carries no mention.
+    """
+
+    mention_range: Optional[List[int]] = None
+    """DEPRECATED: Use `mentions[].range` instead.
+
+    Character range `[start, end)` in `value` highlighted as the **first** mention
+    only. `null` when the range was omitted (the whole `value` is highlighted) or
+    the part carries no mention. _Characters are measured as UTF-16 code units. Most
+    characters count as 1; some emoji count as 2._
+    """
+
+    mentions: Optional[List[Mention]] = None
+    """Every mention on this part, in the order they appear in `value`.
+
+    `null` when the part carries no mention. A part can carry several mentions of
+    different people — check `is_me` to tell whether this line was one of them.
+
+    Only iMessage carries mentions. On a received message this is populated when the
+    sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
+    from an SMS or RCS participant arrives as plain text with `mentions` null, even
+    in a group where other participants are on iMessage.
+    """
+
+    text_decorations: Optional[List[TextDecoration]] = None
+    """Text decorations applied to character ranges in the value"""

linq_python-0.36.0/src/linq/types/shared/text_part_response.py

@@ -0,0 +1,80 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from .reaction import Reaction
+from ..._models import BaseModel
+from .text_decoration import TextDecoration
+
+__all__ = ["TextPartResponse", "Mention"]
+
+
+class Mention(BaseModel):
+    """
+    One mention on a text part — who was mentioned, and which characters of `value` are
+    the mention. A part carries one of these per mention, in the order they appear in the
+    text, so a message naming two people has two entries.
+    """
+
+    handle: str
+    """
+    Address of the mentioned participant, exactly as the device recorded it — an
+    E.164 phone number or an email address.
+    """
+
+    is_me: bool
+    """Whether the mentioned participant is this line."""
+
+    range: List[int]
+    """
+    Character range `[start, end)` in `value` highlighted as this mention.
+    _Characters are measured as UTF-16 code units. Most characters count as 1; some
+    emoji count as 2._
+    """
+
+
+class TextPartResponse(BaseModel):
+    """A text message part"""
+
+    reactions: Optional[List[Reaction]] = None
+    """Reactions on this message part"""
+
+    type: Literal["text"]
+    """Indicates this is a text message part"""
+
+    value: str
+    """The text content"""
+
+    mention: Optional[str] = None
+    """DEPRECATED: Use `mentions` instead.
+
+    Handle (E.164 phone number or Apple ID email) of the **first** mention on this
+    part. A part may carry several mentions; this field shows only the first in
+    `value` order, so it cannot be used to determine whether a given participant was
+    mentioned. `null` when the part carries no mention.
+    """
+
+    mention_range: Optional[List[int]] = None
+    """DEPRECATED: Use `mentions[].range` instead.
+
+    Character range `[start, end)` in `value` highlighted as the **first** mention
+    only. `null` when the range was omitted (the whole `value` is highlighted) or
+    the part carries no mention. _Characters are measured as UTF-16 code units. Most
+    characters count as 1; some emoji count as 2._
+    """
+
+    mentions: Optional[List[Mention]] = None
+    """Every mention on this part, in the order they appear in `value`.
+
+    `null` when the part carries no mention. A part can carry several mentions of
+    different people — check `is_me` to tell whether this line was one of them.
+
+    Only iMessage carries mentions. On a received message this is populated when the
+    sender was on iMessage; SMS and RCS have no way to mark a mention, so a message
+    from an SMS or RCS participant arrives as plain text with `mentions` null, even
+    in a group where other participants are on iMessage.
+    """
+
+    text_decorations: Optional[List[TextDecoration]] = None
+    """Text decorations applied to character ranges in the value"""

{linq_python-0.35.0 → linq_python-0.36.0}/src/linq/types/text_part_param.py

@@ -23,7 +23,7 @@ class TextPartParam(TypedDict, total=False):
     """
 
     mention: str
-    """@mention a chat participant.
+    """Mention a chat participant.
 
     Group chats only — sending a mention to a direct chat is rejected with `409` /
     `2023`. The chat's service is not a constraint: a mention is accepted in any

{linq_python-0.35.0 → linq_python-0.36.0}/tests/api_resources/test_webhooks.py

@@ -31,7 +31,7 @@ class TestWebhooks:
 
         client = client.with_options(webhook_secret=client_opt)
 
-        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
+        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"mentions":[{"handle":"+14155550123","is_me":true,"range":[4,9]}],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
         msg_id = "1"
         timestamp = datetime.now(tz=timezone.utc)
         sig = hook.sign(msg_id=msg_id, timestamp=timestamp, data=data)
@@ -78,7 +78,7 @@ class TestAsyncWebhooks:
 
         async_client = async_client.with_options(webhook_secret=client_opt)
 
-        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
+        data = """{"api_version":"v3","created_at":"2025-11-23T17:30:00Z","data":{"id":"550e8400-e29b-41d4-a716-446655440001","chat":{"id":"550e8400-e29b-41d4-a716-446655440000","health_status":{"doc_url":"https://docs.linqapp.com/guides/chats/chat-health#at-risk","status":"AT_RISK","updated_at":"2026-05-01T18:28:25Z"},"is_group":true,"owner_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"}},"direction":"outbound","parts":[{"type":"text","value":"Hello!","mention":"+14155551234","mention_range":[4,9],"mentions":[{"handle":"+14155550123","is_me":true,"range":[4,9]}],"text_decorations":[{"range":[0,5],"animation":"shake","style":"bold"}]}],"sender_handle":{"id":"550e8400-e29b-41d4-a716-446655440000","handle":"+15551234567","joined_at":"2025-05-21T15:30:00.000-05:00","service":"iMessage","is_me":false,"left_at":"2019-12-27T18:11:19.117Z","status":"active"},"service":"iMessage","delivered_at":"2026-01-30T20:49:20.352Z","effect":{"name":"gentle","type":"bubble"},"idempotency_key":"unique-key","preferred_service":"iMessage","read_at":null,"reconciled_at":"2026-01-30T22:05:00.000Z","reply_to":{"message_id":"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e","part_index":0},"sent_at":"2026-01-30T20:49:19.704Z"},"event_id":"550e8400-e29b-41d4-a716-446655440000","event_type":"message.sent","partner_id":"partner_abc123","trace_id":"abc123def456","webhook_version":"2025-01-01"}"""
         msg_id = "1"
         timestamp = datetime.now(tz=timezone.utc)
         sig = hook.sign(msg_id=msg_id, timestamp=timestamp, data=data)

{linq_python-0.35.0 → linq_python-0.36.0}/uv.lock

@@ -530,7 +530,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.34.0"
+version = "0.35.1"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

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

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

linq_python-0.35.0/src/linq/types/schemas_text_part_response.py

@@ -1,36 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from typing import List, Optional
-from typing_extensions import Literal
-
-from .._models import BaseModel
-from .shared.text_decoration import TextDecoration
-
-__all__ = ["SchemasTextPartResponse"]
-
-
-class SchemasTextPartResponse(BaseModel):
-    """A text message part"""
-
-    type: Literal["text"]
-    """Indicates this is a text message part"""
-
-    value: str
-    """The text content"""
-
-    mention: Optional[str] = None
-    """
-    Handle (E.164 phone number or Apple ID email) of the @mentioned chat
-    participant, as sent. `null` when the part carries no mention.
-    """
-
-    mention_range: Optional[List[int]] = None
-    """
-    Character range `[start, end)` in `value` highlighted as the mention, as sent.
-    `null` when the send omitted it (the whole `value` is highlighted) or the part
-    carries no mention. _Characters are measured as UTF-16 code units. Most
-    characters count as 1; some emoji count as 2._
-    """
-
-    text_decorations: Optional[List[TextDecoration]] = None
-    """Text decorations applied to character ranges in the value"""

linq_python-0.35.0/src/linq/types/shared/text_part_response.py

@@ -1,40 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from typing import List, Optional
-from typing_extensions import Literal
-
-from .reaction import Reaction
-from ..._models import BaseModel
-from .text_decoration import TextDecoration
-
-__all__ = ["TextPartResponse"]
-
-
-class TextPartResponse(BaseModel):
-    """A text message part"""
-
-    reactions: Optional[List[Reaction]] = None
-    """Reactions on this message part"""
-
-    type: Literal["text"]
-    """Indicates this is a text message part"""
-
-    value: str
-    """The text content"""
-
-    mention: Optional[str] = None
-    """
-    Handle (E.164 phone number or Apple ID email) of the @mentioned chat
-    participant, as sent. `null` when the part carries no mention.
-    """
-
-    mention_range: Optional[List[int]] = None
-    """
-    Character range `[start, end)` in `value` highlighted as the mention, as sent.
-    `null` when the send omitted it (the whole `value` is highlighted) or the part
-    carries no mention. _Characters are measured as UTF-16 code units. Most
-    characters count as 1; some emoji count as 2._
-    """
-
-    text_decorations: Optional[List[TextDecoration]] = None
-    """Text decorations applied to character ranges in the value"""