linq-python 0.44.0__tar.gz → 0.46.0__tar.gz

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

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

{linq_python-0.44.0 → linq_python-0.46.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.46.0](https://github.com/linq-team/linq-python/compare/v0.45.0...v0.46.0) (2026-09-06)
+
+
+### Features
+
+* add zero_retention field to poll webhooks and update add options docs ([c40732c](https://github.com/linq-team/linq-python/commit/c40732c386dbbc6ea7631d5c967aca2f30d735e9))
+
+## [0.45.0](https://github.com/linq-team/linq-python/compare/v0.44.0...v0.45.0) (2026-09-05)
+
+
+### Features
+
+* add zero_retention field to message responses ([1c47484](https://github.com/linq-team/linq-python/commit/1c474846e44ec3c830bac2acfe97ba8b0fec5650))
+
 ## [0.44.0](https://github.com/linq-team/linq-python/compare/v0.43.0...v0.44.0) (2026-09-05)
 
 

{linq_python-0.44.0 → linq_python-0.46.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.44.0
+Version: 0.46.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.44.0 → linq_python-0.46.0}/pyproject.toml

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

{linq_python-0.44.0 → linq_python-0.46.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.44.0"  # x-release-please-version
+__version__ = "0.46.0"  # x-release-please-version

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/resources/messages/poll.py

@@ -169,6 +169,13 @@ class PollResource(SyncAPIResource):
         immutable** — you can append options but never edit or remove them (Apple
         constraint). Returns the full poll.
 
+        **On a zero-day-retention line, `options` must include every existing option (in
+        the order they were originally created) followed by the new one(s)**, not just
+        the new option(s). Zero-day-retention polls never store option text, so this
+        request is the only place that text still exists — it's required to correctly
+        render the poll's existing options on the recipient's device when the update is
+        sent. Omitting an existing option returns `400`.
+
         Args:
           extra_headers: Send extra headers
 
@@ -383,6 +390,13 @@ class AsyncPollResource(AsyncAPIResource):
         immutable** — you can append options but never edit or remove them (Apple
         constraint). Returns the full poll.
 
+        **On a zero-day-retention line, `options` must include every existing option (in
+        the order they were originally created) followed by the new one(s)**, not just
+        the new option(s). Zero-day-retention polls never store option text, so this
+        request is the only place that text still exists — it's required to correctly
+        render the poll's existing options on the recipient's device when the update is
+        sent. Omitting an existing option returns `400`.
+
         Args:
           extra_headers: Send extra headers
 

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/message_event_v2.py

@@ -272,3 +272,11 @@ class MessageEventV2(BaseModel):
 
     sent_at: Optional[datetime] = None
     """When the message was sent. Null if not yet sent."""
+
+    zero_retention: Optional[bool] = None
+    """True when this message was sent on a zero-day-retention line.
+
+    `parts` is always empty in that case — Linq never persists this message's
+    content, so there is nothing to include here, not even a count or type of what
+    was sent.
+    """

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_delivered_webhook_event.py

@@ -83,6 +83,14 @@ class Data(BaseModel):
 
     sent_at: Optional[datetime] = None
 
+    zero_retention: Optional[bool] = None
+    """True when this poll was sent on a zero-day-retention line.
+
+    Every option's `text` is empty in that case — Linq never persists poll option
+    text, so there is nothing to include here. The real text was only ever shown
+    once, synchronously, in the API response when the poll was created or added to.
+    """
+
 
 class PollDeliveredWebhookEvent(BaseModel):
     """Complete webhook payload for poll.delivered events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_failed_webhook_event.py

@@ -98,6 +98,13 @@ class Data(BaseModel):
     sender_handle: Optional[ChatHandle] = None
     """Null on failure (the send never landed)."""
 
+    zero_retention: Optional[bool] = None
+    """True when this poll was sent on a zero-day-retention line.
+
+    `poll` is built from the same database read as poll.sent/delivered/read, so
+    every option's `text` is empty.
+    """
+
 
 class PollFailedWebhookEvent(BaseModel):
     """Complete webhook payload for poll.failed events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_read_webhook_event.py

@@ -83,6 +83,14 @@ class Data(BaseModel):
 
     sent_at: Optional[datetime] = None
 
+    zero_retention: Optional[bool] = None
+    """True when this poll was sent on a zero-day-retention line.
+
+    Every option's `text` is empty in that case — Linq never persists poll option
+    text, so there is nothing to include here. The real text was only ever shown
+    once, synchronously, in the API response when the poll was created or added to.
+    """
+
 
 class PollReadWebhookEvent(BaseModel):
     """Complete webhook payload for poll.read events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_received_webhook_event.py

@@ -78,6 +78,15 @@ class Data(BaseModel):
     sender_handle: Optional[ChatHandle] = None
     """The line that created the poll (is_me=false for an inbound poll)."""
 
+    zero_retention: Optional[bool] = None
+    """True when your line has zero-day-retention enabled.
+
+    Unlike other poll webhooks, option `text` here is still the real, unstripped
+    text as received — Linq never persists it in the database, but this webhook
+    fires from the live inbound event, not a database read, so this is the one place
+    it's shown.
+    """
+
 
 class PollReceivedWebhookEvent(BaseModel):
     """Complete webhook payload for poll.received events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_sent_webhook_event.py

@@ -83,6 +83,14 @@ class Data(BaseModel):
 
     sent_at: Optional[datetime] = None
 
+    zero_retention: Optional[bool] = None
+    """True when this poll was sent on a zero-day-retention line.
+
+    Every option's `text` is empty in that case — Linq never persists poll option
+    text, so there is nothing to include here. The real text was only ever shown
+    once, synchronously, in the API response when the poll was created or added to.
+    """
+
 
 class PollSentWebhookEvent(BaseModel):
     """Complete webhook payload for poll.sent events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_updated_webhook_event.py

@@ -70,6 +70,15 @@ class Data(BaseModel):
 
     service: str
 
+    zero_retention: Optional[bool] = None
+    """True when zero-day-retention applies to this update.
+
+    Behavior differs by `direction`: on an inbound update, `added_options[].text` is
+    the real text a participant just added; on an outbound update, it is empty — you
+    already saw the real text once, synchronously, in the API response when you made
+    the add, and this webhook is built from a database read, which never stored it.
+    """
+
 
 class PollUpdatedWebhookEvent(BaseModel):
     """Complete webhook payload for poll.updated events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_vote_added_webhook_event.py

@@ -38,6 +38,15 @@ class Data(BaseModel):
 
     service: str
 
+    zero_retention: Optional[bool] = None
+    """True when this poll is on a zero-day-retention line.
+
+    Votes are unaffected by zero-day-retention — a vote choice is always persisted
+    and delivered regardless — this flag is informational only, telling you why this
+    poll's other webhooks (poll.sent, poll.updated, etc.) may carry empty option
+    text.
+    """
+
 
 class PollVoteAddedWebhookEvent(BaseModel):
     """Complete webhook payload for poll.vote.added events"""

{linq_python-0.44.0 → linq_python-0.46.0}/src/linq/types/poll_vote_removed_webhook_event.py

@@ -38,6 +38,15 @@ class Data(BaseModel):
 
     service: str
 
+    zero_retention: Optional[bool] = None
+    """True when this poll is on a zero-day-retention line.
+
+    Votes are unaffected by zero-day-retention — a vote choice is always persisted
+    and delivered regardless — this flag is informational only, telling you why this
+    poll's other webhooks (poll.sent, poll.updated, etc.) may carry empty option
+    text.
+    """
+
 
 class PollVoteRemovedWebhookEvent(BaseModel):
     """Complete webhook payload for poll.vote.removed events"""

{linq_python-0.44.0 → linq_python-0.46.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/channel/imessage/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"}"""
+        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/channel/imessage/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","zero_retention":false},"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/channel/imessage/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"}"""
+        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/channel/imessage/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","zero_retention":false},"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.44.0 → linq_python-0.46.0}/uv.lock

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

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

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