ellipsis-dev 0.45.0__tar.gz → 0.46.0__tar.gz

{ellipsis_dev-0.45.0 → ellipsis_dev-0.46.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ellipsis-dev
-Version: 0.45.0
+Version: 0.46.0
 Summary: Python SDK for the Ellipsis agents platform: every /v1 operation, sync and async.
 Project-URL: Homepage, https://www.ellipsis.dev
 Project-URL: Documentation, https://www.ellipsis.dev/docs/api

{ellipsis_dev-0.45.0 → ellipsis_dev-0.46.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ellipsis-dev"
-version = "0.45.0"
+version = "0.46.0"
 description = "Python SDK for the Ellipsis agents platform: every /v1 operation, sync and async."
 readme = "README.md"
 license = "MIT"

{ellipsis_dev-0.45.0 → ellipsis_dev-0.46.0}/src/ellipsis/_client.py

@@ -25,6 +25,7 @@ from ._transport import (
     Transport,
     build_body,
     build_query,
+    new_idempotency_key,
 )
 
 
@@ -815,6 +816,7 @@ class _SyncAgents:
         environment: Union[str, models.EnvironmentConfig_Input, None] = None,
         force_rebuild: Union[bool, None] = None,
         gemini: Union[models.GeminiOverrides, None] = None,
+        idempotency_key: Union[str, None] = None,
         images: Union[List[models.ImageAttachment], None] = None,
         input: Union[dict[str, Any], None] = None,
         metadata: Union[dict[str, Union[str, None]], None] = None,
@@ -854,6 +856,9 @@ class _SyncAgents:
             "environment": environment,
             "force_rebuild": force_rebuild,
             "gemini": gemini,
+            "idempotency_key": idempotency_key
+            if idempotency_key is not None
+            else new_idempotency_key(),
             "images": images,
             "input": input,
             "metadata": metadata,
@@ -2060,7 +2065,9 @@ class _SyncSessions(SyncSessionsSugar):
         """
         path = f"/v1/sessions/{_quote(id)}/messages"
         body_fields: dict[str, Any] = {
-            "idempotency_key": idempotency_key,
+            "idempotency_key": idempotency_key
+            if idempotency_key is not None
+            else new_idempotency_key(),
             "images": images,
             "message": message,
         }
@@ -2105,6 +2112,7 @@ class _SyncSessions(SyncSessionsSugar):
         environment: Union[str, models.EnvironmentConfig_Input, None] = None,
         force_rebuild: Union[bool, None] = None,
         gemini: Union[models.GeminiConfig_Input, None] = None,
+        idempotency_key: Union[str, None] = None,
         images: Union[List[models.ImageAttachment], None] = None,
         metadata: Union[dict[str, str], None] = None,
         output: Union[models.OutputConfig, None] = None,
@@ -2144,6 +2152,9 @@ class _SyncSessions(SyncSessionsSugar):
             "environment": environment,
             "force_rebuild": force_rebuild,
             "gemini": gemini,
+            "idempotency_key": idempotency_key
+            if idempotency_key is not None
+            else new_idempotency_key(),
             "images": images,
             "metadata": metadata,
             "output": output,
@@ -2254,9 +2265,9 @@ class _SyncSessions(SyncSessionsSugar):
         thread, pull request, issue, or Linear issue it answers starts a
         new session. A session is also archived when it closes and after
         the account's `archive_inactive_sessions_days` without a message.
-        When the account sets session log retention, the session's
-        records, messages, and prompt are deleted that many days after it
-        was archived (`archived.deletes_at`). The session itself stays.
+        The session's records, messages, and prompt are deleted the
+        account's `session_logs_days` after it was archived
+        (`archived.deletes_at`). The session itself stays.
 
         Set archived to false to clear both fields and let the session
         take messages again. 409 `session_superseded` when a newer session
@@ -2645,7 +2656,7 @@ class _SyncWebhooksDeliveries:
         List webhook deliveries, newest first.
 
         Includes verification pings and deliveries for deleted webhooks.
-        History is retained for 30 days. Retries belong to the same delivery.
+        History is kept for 7 days. Retries belong to the same delivery.
 
         Required permissions: read:webhooks.
         API key: Supported.
@@ -2740,7 +2751,7 @@ class _SyncWebhooks:
         Delete a webhook and cancel outstanding deliveries.
 
         An HTTP request already in flight may finish. Delivery history remains
-        available for 30 days. Deletion frees a webhook slot.
+        available for 7 days. Deletion frees a webhook slot.
 
         Required permissions: delete:webhooks.
         API key: Supported.
@@ -3707,6 +3718,7 @@ class _AsyncAgents:
         environment: Union[str, models.EnvironmentConfig_Input, None] = None,
         force_rebuild: Union[bool, None] = None,
         gemini: Union[models.GeminiOverrides, None] = None,
+        idempotency_key: Union[str, None] = None,
         images: Union[List[models.ImageAttachment], None] = None,
         input: Union[dict[str, Any], None] = None,
         metadata: Union[dict[str, Union[str, None]], None] = None,
@@ -3746,6 +3758,9 @@ class _AsyncAgents:
             "environment": environment,
             "force_rebuild": force_rebuild,
             "gemini": gemini,
+            "idempotency_key": idempotency_key
+            if idempotency_key is not None
+            else new_idempotency_key(),
             "images": images,
             "input": input,
             "metadata": metadata,
@@ -4954,7 +4969,9 @@ class _AsyncSessions(AsyncSessionsSugar):
         """
         path = f"/v1/sessions/{_quote(id)}/messages"
         body_fields: dict[str, Any] = {
-            "idempotency_key": idempotency_key,
+            "idempotency_key": idempotency_key
+            if idempotency_key is not None
+            else new_idempotency_key(),
             "images": images,
             "message": message,
         }
@@ -4999,6 +5016,7 @@ class _AsyncSessions(AsyncSessionsSugar):
         environment: Union[str, models.EnvironmentConfig_Input, None] = None,
         force_rebuild: Union[bool, None] = None,
         gemini: Union[models.GeminiConfig_Input, None] = None,
+        idempotency_key: Union[str, None] = None,
         images: Union[List[models.ImageAttachment], None] = None,
         metadata: Union[dict[str, str], None] = None,
         output: Union[models.OutputConfig, None] = None,
@@ -5038,6 +5056,9 @@ class _AsyncSessions(AsyncSessionsSugar):
             "environment": environment,
             "force_rebuild": force_rebuild,
             "gemini": gemini,
+            "idempotency_key": idempotency_key
+            if idempotency_key is not None
+            else new_idempotency_key(),
             "images": images,
             "metadata": metadata,
             "output": output,
@@ -5148,9 +5169,9 @@ class _AsyncSessions(AsyncSessionsSugar):
         thread, pull request, issue, or Linear issue it answers starts a
         new session. A session is also archived when it closes and after
         the account's `archive_inactive_sessions_days` without a message.
-        When the account sets session log retention, the session's
-        records, messages, and prompt are deleted that many days after it
-        was archived (`archived.deletes_at`). The session itself stays.
+        The session's records, messages, and prompt are deleted the
+        account's `session_logs_days` after it was archived
+        (`archived.deletes_at`). The session itself stays.
 
         Set archived to false to clear both fields and let the session
         take messages again. 409 `session_superseded` when a newer session
@@ -5539,7 +5560,7 @@ class _AsyncWebhooksDeliveries:
         List webhook deliveries, newest first.
 
         Includes verification pings and deliveries for deleted webhooks.
-        History is retained for 30 days. Retries belong to the same delivery.
+        History is kept for 7 days. Retries belong to the same delivery.
 
         Required permissions: read:webhooks.
         API key: Supported.
@@ -5634,7 +5655,7 @@ class _AsyncWebhooks:
         Delete a webhook and cancel outstanding deliveries.
 
         An HTTP request already in flight may finish. Delivery history remains
-        available for 30 days. Deletion frees a webhook slot.
+        available for 7 days. Deletion frees a webhook slot.
 
         Required permissions: delete:webhooks.
         API key: Supported.

{ellipsis_dev-0.45.0 → ellipsis_dev-0.46.0}/src/ellipsis/_transport.py

@@ -7,6 +7,7 @@ model; everything HTTP lives here.
 
 import random
 import time
+import uuid
 from typing import Any, TypeVar
 
 import httpx
@@ -56,6 +57,13 @@ def build_body(body: BaseModel) -> Any:
     return body.model_dump(mode="json", by_alias=True, exclude_none=True)
 
 
+def new_idempotency_key() -> str:
+    """A fresh key for a request that takes `idempotency_key`. The generated
+    client makes one per call when the caller sets none, so the transport's
+    retries of that call reuse it and the server applies the call once."""
+    return uuid.uuid4().hex
+
+
 def _backoff_seconds(attempt: int, retry_after: str | None) -> float:
     if retry_after is not None:
         try:

{ellipsis_dev-0.45.0 → ellipsis_dev-0.46.0}/src/ellipsis/models.py

@@ -116,20 +116,14 @@ class BudgetCeiling(EllipsisModel):
 
 
 class DataRetentionSettings_Output(EllipsisModel):
-    api_requests_days: Union[int, None] = Field(
-        description="Reserved; API request retention is not yet enforced."
-    )
     archive_inactive_sessions_days: int = Field(
         description="Days without a message before a session is archived. A session is also archived when it closes. 1 to 90, default 7."
     )
     environment_snapshots_days: int = Field(
-        description="Retention of newly created reusable environment snapshots, up to 28 days from creation. Paused session workspaces have a separate lifetime."
-    )
-    session_logs_days: Union[int, None] = Field(
-        description="Days after a session is archived before its records and messages are deleted. The session itself stays. Null keeps them."
+        description="Retention of newly created reusable environment snapshots, up to 7 days from creation. Paused session workspaces have a separate lifetime."
     )
-    webhooks_days: Union[int, None] = Field(
-        description="Reserved; webhook retention is not yet enforced."
+    session_logs_days: int = Field(
+        description="Days after a session is archived before its records and messages are deleted. The session itself stays. 1 to 365, default 365."
     )
 
 
@@ -3262,23 +3256,17 @@ class CreditPurchaseReceipt(EllipsisModel):
 
 
 class DataRetentionSettings_Input(EllipsisModel):
-    api_requests_days: Union[int, None] = Field(
-        default=None, description="Reserved; API request retention is not yet enforced."
-    )
     archive_inactive_sessions_days: Union[int, None] = Field(
         default=None,
         description="Days without a message before a session is archived. A session is also archived when it closes. 1 to 90, default 7.",
     )
     environment_snapshots_days: Union[int, None] = Field(
         default=None,
-        description="Retention of newly created reusable environment snapshots, up to 28 days from creation. Paused session workspaces have a separate lifetime.",
+        description="Retention of newly created reusable environment snapshots, up to 7 days from creation. Paused session workspaces have a separate lifetime.",
     )
     session_logs_days: Union[int, None] = Field(
         default=None,
-        description="Days after a session is archived before its records and messages are deleted. The session itself stays. Null keeps them.",
-    )
-    webhooks_days: Union[int, None] = Field(
-        default=None, description="Reserved; webhook retention is not yet enforced."
+        description="Days after a session is archived before its records and messages are deleted. The session itself stays. 1 to 365, default 365.",
     )
 
 
@@ -5373,7 +5361,7 @@ class SendSessionMessageRequest(EllipsisModel):
 
     idempotency_key: Union[str, None] = Field(
         default=None,
-        description="Optional retry-safety key, unique per (session, key): a retry with the same key returns the original message — no duplicate message, no double turn, no double spend. The SDK auto-generates one per send.",
+        description="Optional retry safety key, unique per session. A retry with the same key returns the original message, with no second message, turn, or spend. The SDKs make a key for each call that sets none, so their own retries never send a message twice.",
     )
     images: Union[list[ImageAttachment], None] = Field(
         default=None,
@@ -5425,7 +5413,7 @@ class SessionArchived(EllipsisModel):
         description="The GitHub user who archived the session; null if unknown or unavailable."
     )
     deletes_at: Union[datetime, None] = Field(
-        description="When the session's records and messages are deleted, from the account's current session log retention. It moves when the retention changes. Null when the account keeps them or they're already deleted."
+        description="When the session's records and messages are deleted, from the account's current session log retention. It moves when the retention changes. Null when they're already deleted."
     )
 
 
@@ -5974,6 +5962,10 @@ class StartAgentSessionRequest(EllipsisModel):
         default=None,
         description="Gemini CLI options for this session. Sent fields replace the agent's; naming Gemini CLI on an agent that runs another harness replaces its harness and requires a model. Set at most one of claude_code, codex, or gemini.",
     )
+    idempotency_key: Union[str, None] = Field(
+        default=None,
+        description="Optional retry safety key, unique per account across POST /v1/sessions and POST /v1/agents/{id}/sessions. A retry with the same key returns the session the first request started instead of starting another. Only a request that started a session holds its key. A key is kept for 90 days. The SDKs make a key for each call that sets none, so their own retries never start a second session.",
+    )
     images: Union[list[ImageAttachment], None] = Field(
         default=None,
         description="Images attached to the first message, base64 inline. Requires the model's `images` capability, listed by `/v1/account/models`. Each becomes an `[Image #N]` placeholder in the prompt and an image block the model sees with it. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP.",
@@ -6062,6 +6054,10 @@ class StartSessionRequest(EllipsisModel):
         default=None,
         description="Gemini CLI input and native options. Set exactly one of claude_code, codex, or gemini.",
     )
+    idempotency_key: Union[str, None] = Field(
+        default=None,
+        description="Optional retry safety key, unique per account across POST /v1/sessions and POST /v1/agents/{id}/sessions. A retry with the same key returns the session the first request started instead of starting another. Only a request that started a session holds its key. A key is kept for 90 days. The SDKs make a key for each call that sets none, so their own retries never start a second session.",
+    )
     images: Union[list[ImageAttachment], None] = Field(
         default=None,
         description="Images attached to the first message, base64 inline. Requires the model's `images` capability, listed by `/v1/account/models`. Each becomes an `[Image #N]` placeholder in the prompt and an image block the model sees with it. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP.",