linq-python 0.37.1__tar.gz → 0.38.0__tar.gz

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

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

{linq_python-0.37.1 → linq_python-0.38.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.38.0](https://github.com/linq-team/linq-python/compare/v0.37.1...v0.38.0) (2026-09-01)
+
+
+### Features
+
+* add mentions array to text parts, deprecate singular mention fields ([de49b5c](https://github.com/linq-team/linq-python/commit/de49b5cc2db3cf5be4e6a87c3c938c8cc6237d25))
+
 ## [0.37.1](https://github.com/linq-team/linq-python/compare/v0.37.0...v0.37.1) (2026-08-31)
 
 

{linq_python-0.37.1 → linq_python-0.38.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.37.1
+Version: 0.38.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.37.1 → linq_python-0.38.0}/pyproject.toml

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

{linq_python-0.37.1 → linq_python-0.38.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.37.1"  # x-release-please-version
+__version__ = "0.38.0"  # x-release-please-version

linq_python-0.38.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.38.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.37.1 → linq_python-0.38.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.37.1 → linq_python-0.38.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.37.1 → linq_python-0.38.0}/uv.lock

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

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

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

linq_python-0.37.1/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.37.1/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"""