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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ellipsis-dev
-Version: 0.44.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.44.0 → ellipsis_dev-0.46.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ellipsis-dev"
-version = "0.44.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.44.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,
@@ -1809,64 +1814,6 @@ class _SyncSessions(SyncSessionsSugar):
     def __init__(self, transport: Transport) -> None:
         self._transport = transport
 
-    def analytics(
-        self,
-        id: str,
-    ) -> models.SessionAnalytics:
-        """Get Session Analytics
-
-        Measured tokens and spend over time, plus estimated content cost.
-
-        Token lanes use the request's saved rates. Content attribution
-        apportions input/cache spend by text size, counting carried context
-        on every request. It is an estimate, not a tool call fee.
-        Only the latest 200 retained request bodies are inspected; missing
-        or unsupported context remains explicitly unattributed. No raw
-        prompts or tool results are returned. Session tokens may read only
-        their own session's analytics.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/analytics"
-        response = self._transport.request(
-            "GET", path, response_model=models.SessionAnalytics
-        )
-        assert response is not None
-        return response
-
-    def diff(
-        self,
-        id: str,
-    ) -> models.SessionDiffResponse:
-        """Get Session Diff
-
-        Return the session's uncommitted changes as a patch.
-
-        One unified-diff section per changed file, captured from the
-        environment's working tree when the session ended. The per-file
-        counts ride on the session itself (`git.repos[].files`); this
-        is the text behind them. Empty when the tree was clean. A
-        session token may read only its own session's diff.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/diff"
-        response = self._transport.request(
-            "GET", path, response_model=models.SessionDiffResponse
-        )
-        assert response is not None
-        return response
-
     def download(
         self,
         id: str,
@@ -1927,31 +1874,6 @@ class _SyncSessions(SyncSessionsSugar):
         assert response is not None
         return response
 
-    def git(
-        self,
-        id: str,
-    ) -> models.SessionGitResponse:
-        """Get Session Git
-
-        The session's GitHub-side git view: its commits, and each PR it
-        opened joined to the live gh_prs row and reviews. The identity list
-        (output_git) rides the session itself over the WebSocket; this is
-        the join a "run" notify tells an open pane to refetch.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/git"
-        response = self._transport.request(
-            "GET", path, response_model=models.SessionGitResponse
-        )
-        assert response is not None
-        return response
-
     def image(
         self,
         session_id: str,
@@ -2072,42 +1994,6 @@ class _SyncSessions(SyncSessionsSugar):
         assert response is not None
         return response
 
-    def proxy(
-        self,
-        id: str,
-        *,
-        limit: Union[int, None] = None,
-        cursor: Union[str, None] = None,
-    ) -> SyncPage[models.ProxyRequest, models.SessionProxyResponse]:
-        """Get Session Proxy
-
-        The requests the session's environment sent to GitHub through
-        Ellipsis, newest first. Each is one `proxy_requests` row as stored.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/proxy"
-        query = build_query(
-            {
-                "limit": limit,
-                "cursor": cursor,
-            }
-        )
-        response = self._transport.request(
-            "GET", path, response_model=models.SessionProxyResponse, query=query
-        )
-        assert response is not None
-        return SyncPage(
-            response,
-            "proxy_requests",
-            lambda _cursor: self.proxy(id=id, limit=limit, cursor=_cursor),
-        )
-
     def records(
         self,
         id: str,
@@ -2179,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,
         }
@@ -2224,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,
@@ -2263,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,
@@ -2325,6 +2217,35 @@ class _SyncSessions(SyncSessionsSugar):
         assert response is not None
         return response
 
+    def timeline(
+        self,
+        id: str,
+    ) -> models.SessionTimelineResponse:
+        """Get Session Timeline
+
+        What the session did, newest first. Each time its environment
+        started preparing, became ready, fell asleep after its idle window,
+        and woke for the next message, its close, and what it did on
+        GitHub through Ellipsis, such as the repositories it cloned, its pushes,
+        what it did to pull requests and issues, the files it committed
+        through the API, releases, and workflow runs, read from the
+        requests its environment sent. A run of the same GitHub action is
+        one entry.
+
+        Required permissions: read:sessions.
+        API key: Supported.
+        CLI user token: Supported.
+        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
+        Higher permission levels include lower levels: read < write < delete.
+        Grant match patterns can further restrict access to individual resources.
+        """
+        path = f"/v1/sessions/{_quote(id)}/timeline"
+        response = self._transport.request(
+            "GET", path, response_model=models.SessionTimelineResponse
+        )
+        assert response is not None
+        return response
+
     def update(
         self,
         id: str,
@@ -2344,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
@@ -2735,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.
@@ -2830,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.
@@ -3797,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,
@@ -3836,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,
@@ -4793,64 +4718,6 @@ class _AsyncSessions(AsyncSessionsSugar):
     def __init__(self, transport: AsyncTransport) -> None:
         self._transport = transport
 
-    async def analytics(
-        self,
-        id: str,
-    ) -> models.SessionAnalytics:
-        """Get Session Analytics
-
-        Measured tokens and spend over time, plus estimated content cost.
-
-        Token lanes use the request's saved rates. Content attribution
-        apportions input/cache spend by text size, counting carried context
-        on every request. It is an estimate, not a tool call fee.
-        Only the latest 200 retained request bodies are inspected; missing
-        or unsupported context remains explicitly unattributed. No raw
-        prompts or tool results are returned. Session tokens may read only
-        their own session's analytics.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/analytics"
-        response = await self._transport.request(
-            "GET", path, response_model=models.SessionAnalytics
-        )
-        assert response is not None
-        return response
-
-    async def diff(
-        self,
-        id: str,
-    ) -> models.SessionDiffResponse:
-        """Get Session Diff
-
-        Return the session's uncommitted changes as a patch.
-
-        One unified-diff section per changed file, captured from the
-        environment's working tree when the session ended. The per-file
-        counts ride on the session itself (`git.repos[].files`); this
-        is the text behind them. Empty when the tree was clean. A
-        session token may read only its own session's diff.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/diff"
-        response = await self._transport.request(
-            "GET", path, response_model=models.SessionDiffResponse
-        )
-        assert response is not None
-        return response
-
     async def download(
         self,
         id: str,
@@ -4911,31 +4778,6 @@ class _AsyncSessions(AsyncSessionsSugar):
         assert response is not None
         return response
 
-    async def git(
-        self,
-        id: str,
-    ) -> models.SessionGitResponse:
-        """Get Session Git
-
-        The session's GitHub-side git view: its commits, and each PR it
-        opened joined to the live gh_prs row and reviews. The identity list
-        (output_git) rides the session itself over the WebSocket; this is
-        the join a "run" notify tells an open pane to refetch.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/git"
-        response = await self._transport.request(
-            "GET", path, response_model=models.SessionGitResponse
-        )
-        assert response is not None
-        return response
-
     async def image(
         self,
         session_id: str,
@@ -5056,42 +4898,6 @@ class _AsyncSessions(AsyncSessionsSugar):
         assert response is not None
         return response
 
-    async def proxy(
-        self,
-        id: str,
-        *,
-        limit: Union[int, None] = None,
-        cursor: Union[str, None] = None,
-    ) -> AsyncPage[models.ProxyRequest, models.SessionProxyResponse]:
-        """Get Session Proxy
-
-        The requests the session's environment sent to GitHub through
-        Ellipsis, newest first. Each is one `proxy_requests` row as stored.
-
-        Required permissions: read:sessions.
-        API key: Supported.
-        CLI user token: Supported.
-        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
-        Higher permission levels include lower levels: read < write < delete.
-        Grant match patterns can further restrict access to individual resources.
-        """
-        path = f"/v1/sessions/{_quote(id)}/proxy"
-        query = build_query(
-            {
-                "limit": limit,
-                "cursor": cursor,
-            }
-        )
-        response = await self._transport.request(
-            "GET", path, response_model=models.SessionProxyResponse, query=query
-        )
-        assert response is not None
-        return AsyncPage(
-            response,
-            "proxy_requests",
-            lambda _cursor: self.proxy(id=id, limit=limit, cursor=_cursor),
-        )
-
     async def records(
         self,
         id: str,
@@ -5163,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,
         }
@@ -5208,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,
@@ -5247,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,
@@ -5309,6 +5121,35 @@ class _AsyncSessions(AsyncSessionsSugar):
         assert response is not None
         return response
 
+    async def timeline(
+        self,
+        id: str,
+    ) -> models.SessionTimelineResponse:
+        """Get Session Timeline
+
+        What the session did, newest first. Each time its environment
+        started preparing, became ready, fell asleep after its idle window,
+        and woke for the next message, its close, and what it did on
+        GitHub through Ellipsis, such as the repositories it cloned, its pushes,
+        what it did to pull requests and issues, the files it committed
+        through the API, releases, and workflow runs, read from the
+        requests its environment sent. A run of the same GitHub action is
+        one entry.
+
+        Required permissions: read:sessions.
+        API key: Supported.
+        CLI user token: Supported.
+        Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
+        Higher permission levels include lower levels: read < write < delete.
+        Grant match patterns can further restrict access to individual resources.
+        """
+        path = f"/v1/sessions/{_quote(id)}/timeline"
+        response = await self._transport.request(
+            "GET", path, response_model=models.SessionTimelineResponse
+        )
+        assert response is not None
+        return response
+
     async def update(
         self,
         id: str,
@@ -5328,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
@@ -5719,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.
@@ -5814,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.44.0 → ellipsis_dev-0.46.0}/src/ellipsis/_stream.py

@@ -117,6 +117,7 @@ def parse_frame(data: str | bytes) -> frames.StreamFrame | None:
 
 _FRAME_TYPES: dict[Any, Any] = {
     "session": frames.SessionFrame,
+    "timeline": frames.TimelineFrame,
     "records": frames.RecordsFrame,
     "delta": frames.DeltaFrame,
     "heartbeat": frames.HeartbeatFrame,

{ellipsis_dev-0.44.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.44.0 → ellipsis_dev-0.46.0}/src/ellipsis/frames.py

@@ -75,12 +75,37 @@ class SessionFrame(EllipsisModel):
     type: Literal["session"]
 
 
+class TimelineFrame(EllipsisModel):
+    """The session's whole timeline, newest first: sent after the first session
+    frame, and resent whole whenever it changes. The same events
+    `GET /v1/sessions/{id}/timeline` returns.
+    """
+
+    events: list[
+        Union[
+            models.EnvironmentTimelineEvent,
+            models.SessionClosedTimelineEvent,
+            models.GithubCloneTimelineEvent,
+            models.GithubPushTimelineEvent,
+            models.GithubCommitTimelineEvent,
+            models.GithubPullRequestTimelineEvent,
+            models.GithubIssueTimelineEvent,
+            models.GithubReleaseTimelineEvent,
+            models.GithubWorkflowTimelineEvent,
+            models.GithubRefusedTimelineEvent,
+            models.GithubOtherTimelineEvent,
+        ]
+    ] = Field(description="What the session did, newest first.")
+    type: Literal["timeline"]
+
+
 StreamFrame = Union[
     DeltaFrame,
     ErrorFrame,
     HeartbeatFrame,
     RecordsFrame,
     SessionFrame,
+    TimelineFrame,
 ]
 """One server->client frame. Unknown frame types must be ignored
 (additive server changes are not a protocol break)."""
@@ -92,5 +117,6 @@ __all__ = [
     "HeartbeatFrame",
     "RecordsFrame",
     "SessionFrame",
+    "TimelineFrame",
     "StreamFrame",
 ]