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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ellipsis-dev
-Version: 0.43.0
+Version: 0.45.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.43.0 → ellipsis_dev-0.45.0}/pyproject.toml

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

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

@@ -1809,64 +1809,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 +1869,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,
@@ -2289,6 +2206,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,
@@ -4757,64 +4703,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,
@@ -4875,31 +4763,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,
@@ -5237,6 +5100,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,

{ellipsis_dev-0.43.0 → ellipsis_dev-0.45.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.43.0 → ellipsis_dev-0.45.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",
 ]

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

@@ -70,6 +70,7 @@ CustomerAuditLogEventType = Literal[
     "credit_granted",
     "refund_issued",
     "auto_recharge_updated",
+    "platform_fee_updated",
 ]
 
 
@@ -615,17 +616,6 @@ class CodexConfig_Output(EllipsisModel):
     )
 
 
-class Duration_Output(EllipsisModel):
-    """A duration as explicit units, summed. Set any of `hours`/`minutes`/
-    `seconds` (at least one). The alternative to the `30m`-style shorthand
-    string wherever a duration is accepted.
-    """
-
-    hours: Union[int, None]
-    minutes: Union[int, None]
-    seconds: Union[int, None]
-
-
 class MemorySize_Output(EllipsisModel):
     """A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).
     Set any of `gb`/`mb` (at least one). The alternative to the `8GB`-style
@@ -637,29 +627,27 @@ class MemorySize_Output(EllipsisModel):
 
 
 class ComputeConfig_Output(EllipsisModel):
-    """Environment compute sizing. Every field is optional; an omitted field
-    inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
-    outside the platform bounds fails validation loudly (a sync error on the
-    config) rather than being clamped silently.
+    """The size and lifetime of the environment. Every field is optional. An
+    omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+    10m idle). A value outside the platform bounds fails validation.
 
-    `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
-    explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
-    `timeout_seconds` properties resolve either form to the canonical integer
-    the environment is sized with.
+    `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+    `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+    `1h30m`.
 
-    `timeout` is the max wall-clock the agent may run in one environment before
-    it is stopped, capped at 1h (equal to the default, so today the knob only
-    shortens a session; the cap matches the 1-hour validity of the session's
-    GitHub token).
+    `timeout` is the longest one message's work may run before it is stopped,
+    1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
 
-    Compute currently uses a temporary flat one-cent amount each time an
-    environment is started for a session, subject to the account's existing
-    free-compute exemptions.
+    `idle` is how long the environment stays awake after the agent finishes
+    with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+    next message resumes it. Only an interactive session pauses. A session
+    that runs once ends when its message ends.
     """
 
     cpu: Union[int, None]
+    idle: Union[str, None]
     memory: Union[str, MemorySize_Output, None]
-    timeout: Union[str, Duration_Output, None]
+    timeout: Union[str, None]
 
 
 class EnvironmentBaseBuild_Output(EllipsisModel):
@@ -1428,17 +1416,6 @@ class CodexConfig_Input(EllipsisModel):
     )
 
 
-class Duration_Input(EllipsisModel):
-    """A duration as explicit units, summed. Set any of `hours`/`minutes`/
-    `seconds` (at least one). The alternative to the `30m`-style shorthand
-    string wherever a duration is accepted.
-    """
-
-    hours: Union[int, None] = None
-    minutes: Union[int, None] = None
-    seconds: Union[int, None] = None
-
-
 class MemorySize_Input(EllipsisModel):
     """A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).
     Set any of `gb`/`mb` (at least one). The alternative to the `8GB`-style
@@ -1450,29 +1427,27 @@ class MemorySize_Input(EllipsisModel):
 
 
 class ComputeConfig_Input(EllipsisModel):
-    """Environment compute sizing. Every field is optional; an omitted field
-    inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
-    outside the platform bounds fails validation loudly (a sync error on the
-    config) rather than being clamped silently.
+    """The size and lifetime of the environment. Every field is optional. An
+    omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+    10m idle). A value outside the platform bounds fails validation.
 
-    `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
-    explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
-    `timeout_seconds` properties resolve either form to the canonical integer
-    the environment is sized with.
+    `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+    `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+    `1h30m`.
 
-    `timeout` is the max wall-clock the agent may run in one environment before
-    it is stopped, capped at 1h (equal to the default, so today the knob only
-    shortens a session; the cap matches the 1-hour validity of the session's
-    GitHub token).
+    `timeout` is the longest one message's work may run before it is stopped,
+    1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
 
-    Compute currently uses a temporary flat one-cent amount each time an
-    environment is started for a session, subject to the account's existing
-    free-compute exemptions.
+    `idle` is how long the environment stays awake after the agent finishes
+    with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+    next message resumes it. Only an interactive session pauses. A session
+    that runs once ends when its message ends.
     """
 
     cpu: Union[int, None] = None
+    idle: Union[str, None] = None
     memory: Union[str, MemorySize_Input, None] = None
-    timeout: Union[str, Duration_Input, None] = None
+    timeout: Union[str, None] = None
 
 
 class EnvironmentBaseBuild_Input(EllipsisModel):
@@ -3508,6 +3483,16 @@ Not derivable from the row: `environment_id` says WHICH environment, not
 how it was chosen, and is null for the built-in basic environment."""
 
 
+class EnvironmentTimelineEvent(EllipsisModel):
+    """The session's environment started preparing, became ready, was paused
+    after its idle window, or was resumed for the next message.
+    """
+
+    action: Literal["started", "ready", "asleep", "awake"]
+    at: datetime
+    type: Literal["environment"]
+
+
 class EnvironmentsListResponse(EllipsisModel):
     """The caller's saved environments."""
 
@@ -3545,6 +3530,7 @@ ErrorReason = Literal[
     "execution_disabled",
     "interrupted",
     "stopped",
+    "timeout",
 ]
 """Why a message failed, was stopped, or was cancelled."""
 
@@ -3912,6 +3898,30 @@ class GithubCheckSuiteEvent(EllipsisModel):
     url: str
 
 
+class GithubCloneTimelineEvent(EllipsisModel):
+    """A repository cloned into the environment."""
+
+    at: datetime = Field(description="When the last request behind it ended.")
+    ok: bool = Field(description="Whether GitHub did it.")
+    repository: str
+    type: Literal["github.clone"]
+
+
+class GithubCommitTimelineEvent(EllipsisModel):
+    """Files committed through the API, one entry for each run of commits to
+    the same branch.
+    """
+
+    at: datetime = Field(description="When the last request behind it ended.")
+    branch: Union[str, None] = Field(
+        description="Null when the repository's default branch."
+    )
+    ok: bool = Field(description="Whether GitHub did it.")
+    paths: list[str] = Field(description="The files written or deleted.")
+    repository: str
+    type: Literal["github.commit"]
+
+
 class GithubConfigEllipsis(EllipsisModel):
     """The product namespace of a GitHub routing file, with an explicit kind."""
 
@@ -4024,6 +4034,19 @@ class GithubIssueEvent(EllipsisModel):
     url: str
 
 
+class GithubIssueTimelineEvent(EllipsisModel):
+    action: Literal["opened", "edited", "commented", "closed", "reopened"]
+    at: datetime = Field(description="When the last request behind it ended.")
+    number: Union[int, None] = Field(
+        description="Null when Ellipsis could not tell which."
+    )
+    ok: bool = Field(description="Whether GitHub did it.")
+    repository: Union[str, None] = Field(
+        description="Null when Ellipsis could not tell which."
+    )
+    type: Literal["github.issue"]
+
+
 class LinkedSlackIdentity(EllipsisModel):
     """The Slack identity linked to a GitHub member."""
 
@@ -4071,6 +4094,19 @@ class GithubMembersListResponse(EllipsisModel):
     )
 
 
+class GithubOtherTimelineEvent(EllipsisModel):
+    """A change sent to GitHub that none of the other types describe."""
+
+    at: datetime = Field(description="When the last request behind it ended.")
+    method: str
+    ok: bool = Field(description="Whether GitHub did it.")
+    operation: Union[str, None] = Field(
+        description="The GraphQL mutation, for `/api/graphql`."
+    )
+    path: str
+    type: Literal["github.other"]
+
+
 class GithubPullRequestEvent(EllipsisModel):
     action: Union[PullRequestAction, Literal["review_commented"]]
     actor: Union[SessionEventActor, None]
@@ -4082,6 +4118,38 @@ class GithubPullRequestEvent(EllipsisModel):
     url: str
 
 
+class GithubPullRequestTimelineEvent(EllipsisModel):
+    action: Literal[
+        "opened",
+        "edited",
+        "ready_for_review",
+        "converted_to_draft",
+        "review_requested",
+        "commented",
+        "reviewed",
+        "review_commented",
+        "thread_resolved",
+        "branch_updated",
+        "auto_merge_enabled",
+        "merge_queued",
+        "merged",
+        "closed",
+        "reopened",
+    ]
+    at: datetime = Field(description="When the last request behind it ended.")
+    number: Union[int, None] = Field(
+        description="Null when Ellipsis could not tell which."
+    )
+    ok: bool = Field(description="Whether GitHub did it.")
+    repository: Union[str, None] = Field(
+        description="Null when Ellipsis could not tell which."
+    )
+    review: Union[Literal["approved", "changes_requested", "commented"], None] = Field(
+        description="The review's verdict, for `reviewed`."
+    )
+    type: Literal["github.pull_request"]
+
+
 class GithubPushEvent(EllipsisModel):
     actor: Union[SessionEventActor, None]
     after: str
@@ -4092,6 +4160,31 @@ class GithubPushEvent(EllipsisModel):
     url: str
 
 
+class GithubPushTimelineEvent(EllipsisModel):
+    """A branch or tag pushed, created, or deleted, over git or through the API."""
+
+    action: Literal["pushed", "created", "deleted"]
+    at: datetime = Field(description="When the last request behind it ended.")
+    branch: Union[str, None] = Field(
+        description="Null for a tag, or when Ellipsis did not record the push's branches."
+    )
+    ok: bool = Field(description="Whether GitHub did it.")
+    repository: str
+    tag: Union[str, None] = Field(description="Null for a branch.")
+    type: Literal["github.push"]
+
+
+class GithubRefusedTimelineEvent(EllipsisModel):
+    """Requests Ellipsis refused before they reached GitHub, one entry for
+    each run of them.
+    """
+
+    at: datetime = Field(description="When the last request behind it ended.")
+    ok: bool = Field(description="Whether GitHub did it.")
+    reason: str = Field(description="The `reason` on the refused requests.")
+    type: Literal["github.refused"]
+
+
 class GithubReleaseEvent(EllipsisModel):
     action: ReleaseAction
     actor: Union[SessionEventActor, None]
@@ -4103,6 +4196,15 @@ class GithubReleaseEvent(EllipsisModel):
     url: str
 
 
+class GithubReleaseTimelineEvent(EllipsisModel):
+    action: Literal["created", "edited", "deleted"]
+    at: datetime = Field(description="When the last request behind it ended.")
+    ok: bool = Field(description="Whether GitHub did it.")
+    repository: str
+    tag: Union[str, None]
+    type: Literal["github.release"]
+
+
 class GithubRepository(EllipsisModel):
     """A repository connected to the account's GitHub installation — a valid
     target for `repository` when creating an agent and for the
@@ -4233,6 +4335,20 @@ class GithubWorkflowRunEvent(EllipsisModel):
     url: str
 
 
+class GithubWorkflowTimelineEvent(EllipsisModel):
+    """A GitHub Actions workflow run, or its logs read."""
+
+    action: Literal["dispatched", "rerun", "cancelled", "logs_read"]
+    at: datetime = Field(description="When the last request behind it ended.")
+    ok: bool = Field(description="Whether GitHub did it.")
+    repository: str
+    run_id: Union[int, None]
+    type: Literal["github.workflow"]
+    workflow: Union[str, None] = Field(
+        description="The workflow file or id, for `dispatched`."
+    )
+
+
 class ValidationError(EllipsisModel):
     ctx: Union[dict[str, Any], None] = None
     input: Union[Any, None] = None
@@ -4976,23 +5092,23 @@ class PullRequest(EllipsisModel):
     """A GitHub pull request. A session's pull requests are read live. A review's is kept as it was when the review ran."""
 
     additions: Union[int, None] = Field(
-        default=None, description="Lines added, null until GitHub reports them."
+        description="Lines added, null until GitHub reports them."
     )
     author: GithubAccountSnippet = Field(description="Who opened the pull request.")
     base: PullRequestBranch = Field(description="The branch the changes merge into.")
     changed_files: Union[int, None] = Field(
-        default=None, description="Files changed, null until GitHub reports them."
+        description="Files changed, null until GitHub reports them."
     )
     commits: Union[int, None] = Field(
-        default=None, description="Commits, null until GitHub reports them."
+        description="Commits, null until GitHub reports them."
     )
     created_at: datetime
     deletions: Union[int, None] = Field(
-        default=None, description="Lines deleted, null until GitHub reports them."
+        description="Lines deleted, null until GitHub reports them."
     )
     head: PullRequestBranch = Field(description="The branch with the changes.")
     id: int = Field(description="The pull request's GitHub id.")
-    merged_at: Union[datetime, None] = None
+    merged_at: Union[datetime, None]
     number: int
     repository: GithubRepositorySnippet = Field(
         description="The repository the pull request merges into."
@@ -5378,6 +5494,48 @@ class SessionEnvironment(EllipsisModel):
     variables: list[EnvironmentVariable_Output]
 
 
+class SessionHandler(EllipsisModel):
+    """The saved handler and its display name when the session started."""
+
+    agent_name: str = Field(
+        description="The handler's effective display name when the session started: ellipsis.name, or the service default (Slack, GitHub, Linear, or sentry)."
+    )
+    id: str = Field(description="Identifier of the saved handler.")
+    service: HandlerService = Field(description="The service the handler responds to.")
+    sha: str = Field(
+        description="Content fingerprint of the validated handler configuration used when the session started. This is not the Git commit SHA."
+    )
+
+
+class SessionOutput(EllipsisModel):
+    """Structured output on the wire: the contract and, when the agent has
+    submitted one, the payload. `result` is None while the session runs and
+    when the agent submitted nothing; it is the agent's own JSON, in the
+    shape of `json_schema`.
+    """
+
+    json_schema: dict[str, Any] = Field(
+        description="JSON Schema the agent's result must satisfy."
+    )
+    result: Union[dict[str, Any], None] = Field(
+        description="The payload the agent submitted, or null until it submits one."
+    )
+
+
+class SessionParent(EllipsisModel):
+    """The predecessor session this session continues."""
+
+    session_id: Union[str, None] = Field(
+        description="Identifier of the predecessor session this session continues, if any."
+    )
+
+
+class SessionReview(EllipsisModel):
+    """The code review a reviewer session ran for."""
+
+    id: str = Field(description="Identifier of the code review.")
+
+
 class SessionGitCommit(EllipsisModel):
     """One commit the session created in this repo (everything past the
     provisioning checkout's sha), captured from the environment rather than the
@@ -5398,6 +5556,9 @@ class SessionGitFile(EllipsisModel):
 
     additions: int
     deletions: int
+    patch: Union[str, None] = Field(
+        description="The file's unified diff, `diff --git` header included, exactly as git emitted it. Null when the session's diff passed 100 KB and this file was left out."
+    )
     path: str
     status: str
 
@@ -5412,6 +5573,9 @@ class SessionGitPr(EllipsisModel):
 
     gh_pr_id: Union[int, None]
     number: int
+    pull_request: Union[PullRequest, None] = Field(
+        description="The pull request as GitHub last reported it. Null until Ellipsis has read it from GitHub."
+    )
     title: Union[str, None]
     url: str
 
@@ -5439,46 +5603,12 @@ class SessionGit(EllipsisModel):
     repos: list[SessionGitRepo]
 
 
-class SessionHandler(EllipsisModel):
-    """The saved handler and its display name when the session started."""
+class SessionScm(EllipsisModel):
+    """What the session did in source control, by provider."""
 
-    agent_name: str = Field(
-        description="The handler's effective display name when the session started: ellipsis.name, or the service default (Slack, GitHub, Linear, or sentry)."
+    github: Union[SessionGit, None] = Field(
+        description="Each GitHub repository in the session's environment and what the session did to it. Null if nothing was ever captured."
     )
-    id: str = Field(description="Identifier of the saved handler.")
-    service: HandlerService = Field(description="The service the handler responds to.")
-    sha: str = Field(
-        description="Content fingerprint of the validated handler configuration used when the session started. This is not the Git commit SHA."
-    )
-
-
-class SessionOutput(EllipsisModel):
-    """Structured output on the wire: the contract and, when the agent has
-    submitted one, the payload. `result` is None while the session runs and
-    when the agent submitted nothing; it is the agent's own JSON, in the
-    shape of `json_schema`.
-    """
-
-    json_schema: dict[str, Any] = Field(
-        description="JSON Schema the agent's result must satisfy."
-    )
-    result: Union[dict[str, Any], None] = Field(
-        description="The payload the agent submitted, or null until it submits one."
-    )
-
-
-class SessionParent(EllipsisModel):
-    """The predecessor session this session continues."""
-
-    session_id: Union[str, None] = Field(
-        description="Identifier of the predecessor session this session continues, if any."
-    )
-
-
-class SessionReview(EllipsisModel):
-    """The code review a reviewer session ran for."""
-
-    id: str = Field(description="Identifier of the code review.")
 
 
 SessionSource = Literal["react", "code_review", "web", "api", "cli", "mention", "cron"]
@@ -5593,9 +5723,6 @@ class Session(EllipsisModel):
     gemini: Union[GeminiConfig_Output, None] = Field(
         description="Gemini CLI input and native options. Set exactly one of claude_code, codex, or gemini."
     )
-    git: Union[SessionGit, None] = Field(
-        description="What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured."
-    )
     handler: Union[SessionHandler, None] = Field(
         description="The saved handler and its effective display name when this session started, frozen at creation. Null for built-in responders, legacy sessions, and sessions started without a handler."
     )
@@ -5615,6 +5742,9 @@ class Session(EllipsisModel):
     review: Union[SessionReview, None] = Field(
         description="The code review this session ran for; null unless the source is `code_review`."
     )
+    scm: SessionScm = Field(
+        description="What the session did in source control, by provider. Per repository: the commit and branch it sits on, its commits, each uncommitted file with its line counts and diff, and the pull requests it opened."
+    )
     skills: list[SkillRef_Output] = Field(
         description="Skills installed for this session."
     )
@@ -5634,116 +5764,12 @@ class Session(EllipsisModel):
     )
 
 
-class SessionSpendItem(EllipsisModel):
-    charged: int = 0
-    cost: int = 0
-    key: str
-    label: str
-    tokens: int = 0
-
-
-class SessionCostCategory(EllipsisModel):
-    charged: int
-    items: list[SessionSpendItem]
-    key: str
-    label: str
-
-
-class SessionToolCount(EllipsisModel):
-    calls: int
-    name: str
-
-
-class SessionUsageBucket(EllipsisModel):
-    cache_read_tokens: int = 0
-    cache_write_tokens: int = 0
-    charged: int = 0
-    date: datetime
-    input_tokens: int = 0
-    output_tokens: int = 0
-    requests: int = 0
-
-
-class SessionAnalytics(EllipsisModel):
-    attributed_requests: int
-    attribution: list[SessionCostCategory] = Field(
-        description="Estimated input content cost by serialized text size, allocated from measured input/cache spend. Repeated context is counted on every request. Output and compute remain separate. These estimates never affect billing."
-    )
-    attribution_request_limit: int = Field(
-        description="Maximum recent stored request bodies inspected. Older, missing, multimodal, or incomplete context is left unattributed."
-    )
-    bucket_seconds: int
-    charged: int
-    historical_entries: int = Field(
-        description="Carried-forward billing totals without per-request measurements. Included in spend, excluded from the timeline and request counts."
-    )
-    pending_requests: int
-    requests: int
-    series: list[SessionUsageBucket]
-    spend: list[SessionSpendItem] = Field(
-        description="Measured token lanes priced using each request's saved rate card, plus compute. Rounding is reconciled to the ledger."
-    )
-    tools: list[SessionToolCount] = Field(
-        description="Tool invocations from retained session records. These counts are not tool call charges; third-party tool fees are not metered."
-    )
-    unresolved_requests: int
-
-
-class SessionGitPatchFile(EllipsisModel):
-    """One file's patch, split out of `git diff HEAD` at capture time.
-
-    Stored per file rather than as one blob because that is how a viewer reads
-    it: a row per changed file, opened one at a time. Counts and status are NOT
-    repeated here — they live on the matching SessionGitFile in
-    `sessions.output_git`, which rides on every session read, so a surface
-    lists the changed files (and their +/−) before it fetches a single hunk. The
-    join key is (full_name, path).
-
-    `patch` is the unified-diff section for this file, `diff --git` header
-    included, exactly as git emitted it.
-    """
-
-    full_name: str
-    patch: str
-    path: str
+class SessionClosedTimelineEvent(EllipsisModel):
+    """The session closed."""
 
-
-class SessionDiffResponse(EllipsisModel):
-    """A session's uncommitted changes, one patch per file."""
-
-    files: list[SessionGitPatchFile] = Field(
-        description="One unified-diff section per changed file, `diff --git` header included, exactly as git emitted it. Join to the per-file counts on `git.repos[].files` by (full_name, path). Empty when the tree was clean or no capture ran."
-    )
-    omitted_paths: list[str] = Field(
-        description="Paths whose hunks were dropped to fit the storage cap, so a viewer can name what is missing instead of showing a silently partial diff."
-    )
-
-
-class SessionPullRequestReview(EllipsisModel):
-    body: Union[str, None]
-    html_url: str
-    id: int
-    state: str
-    submitted_at: datetime
-    user: Union[GithubAccountSnippet, None]
-
-
-class SessionPrEntry(EllipsisModel):
-    number: int
-    pull_request: Union[PullRequest, None]
-    reviews: list[SessionPullRequestReview]
-    url: str
-
-
-class SessionGitRepoEntry(EllipsisModel):
-    commits: list[SessionGitCommit]
-    commits_total: int
-    full_name: str
-    prs: list[SessionPrEntry]
-
-
-class SessionGitResponse(EllipsisModel):
-    repos: list[SessionGitRepoEntry]
+    action: Literal["closed"]
+    at: datetime
+    type: Literal["session"]
 
 
 class SessionMessageResponse(EllipsisModel):
@@ -5816,6 +5842,24 @@ class SessionResponse(EllipsisModel):
     session: Session = Field(description="The session.")
 
 
+class SessionTimelineResponse(EllipsisModel):
+    events: list[
+        Union[
+            EnvironmentTimelineEvent,
+            SessionClosedTimelineEvent,
+            GithubCloneTimelineEvent,
+            GithubPushTimelineEvent,
+            GithubCommitTimelineEvent,
+            GithubPullRequestTimelineEvent,
+            GithubIssueTimelineEvent,
+            GithubReleaseTimelineEvent,
+            GithubWorkflowTimelineEvent,
+            GithubRefusedTimelineEvent,
+            GithubOtherTimelineEvent,
+        ]
+    ] = Field(description="Newest first.")
+
+
 class SessionsListResponse(EllipsisModel):
     """A page of sessions in the lean wire shape."""
 
@@ -5830,7 +5874,6 @@ class SessionsListResponse(EllipsisModel):
         default=None,
         description="Pass as `cursor` to fetch the next page. Null on the last page. Opaque — echo it back rather than parsing it.",
     )
-    pull_requests: Union[dict[str, PullRequest], None] = None
     sessions: list[Session] = Field(
         description="Lean wire rows — the same shape GET /v1/sessions/{id} and the stream's session frames carry. The heavy blobs (config snapshot, input/output) live on the detail endpoints."
     )
@@ -6447,8 +6490,6 @@ __all__ = [
     "DeveloperBudgetWindow",
     "DeveloperBudgets",
     "DeveloperUsage",
-    "Duration_Input",
-    "Duration_Output",
     "EffortLevel",
     "EllipsisGrant_Input",
     "EllipsisGrant_Output",
@@ -6474,6 +6515,7 @@ __all__ = [
     "EnvironmentResponse",
     "EnvironmentScript",
     "EnvironmentSource",
+    "EnvironmentTimelineEvent",
     "EnvironmentVariable_Input",
     "EnvironmentVariable_Output",
     "EnvironmentsListResponse",
@@ -6508,21 +6550,29 @@ __all__ = [
     "GithubAccountType",
     "GithubCheckRunEvent",
     "GithubCheckSuiteEvent",
+    "GithubCloneTimelineEvent",
+    "GithubCommitTimelineEvent",
     "GithubConfig",
     "GithubConfigEllipsis",
     "GithubHandler",
     "GithubIntegrationSummary",
     "GithubIssueEvent",
+    "GithubIssueTimelineEvent",
     "GithubMember",
     "GithubMembersListResponse",
     "GithubMentionAudience",
     "GithubMentionAuthors",
     "GithubMentionPolicy",
+    "GithubOtherTimelineEvent",
     "GithubPermissions_Input",
     "GithubPermissions_Output",
     "GithubPullRequestEvent",
+    "GithubPullRequestTimelineEvent",
     "GithubPushEvent",
+    "GithubPushTimelineEvent",
+    "GithubRefusedTimelineEvent",
     "GithubReleaseEvent",
+    "GithubReleaseTimelineEvent",
     "GithubRepositoriesListResponse",
     "GithubRepository",
     "GithubRepositorySnippet",
@@ -6531,6 +6581,7 @@ __all__ = [
     "GithubStatusEvent",
     "GithubUser",
     "GithubWorkflowRunEvent",
+    "GithubWorkflowTimelineEvent",
     "HTTPValidationError",
     "Handler",
     "HandlerMetricsResponse",
@@ -6697,31 +6748,26 @@ __all__ = [
     "SeriesInterval",
     "Session",
     "SessionAgent",
-    "SessionAnalytics",
     "SessionArchived",
     "SessionAttribution",
     "SessionBudgetDefault",
     "SessionCapability",
     "SessionClosedPayload",
     "SessionClosedRecord",
+    "SessionClosedTimelineEvent",
     "SessionConfig_Input",
     "SessionConfig_Output",
     "SessionConversation",
     "SessionConversationConfig_Input",
     "SessionConversationConfig_Output",
-    "SessionCostCategory",
-    "SessionDiffResponse",
     "SessionEnvironment",
     "SessionError",
     "SessionEventActor",
     "SessionGit",
     "SessionGitCommit",
     "SessionGitFile",
-    "SessionGitPatchFile",
     "SessionGitPr",
     "SessionGitRepo",
-    "SessionGitRepoEntry",
-    "SessionGitResponse",
     "SessionHandler",
     "SessionLogSegment",
     "SessionMessage",
@@ -6729,20 +6775,17 @@ __all__ = [
     "SessionMessageResponse",
     "SessionOutput",
     "SessionParent",
-    "SessionPrEntry",
     "SessionPrompting",
-    "SessionPullRequestReview",
     "SessionRecord",
     "SessionRecordsListResponse",
     "SessionResponse",
     "SessionReview",
+    "SessionScm",
     "SessionSource",
-    "SessionSpendItem",
     "SessionStatus",
     "SessionSummary",
     "SessionSummarySource",
-    "SessionToolCount",
-    "SessionUsageBucket",
+    "SessionTimelineResponse",
     "SessionsListResponse",
     "SettingsRef_Input",
     "SettingsRef_Output",