opencode-python-sdk 0.1.0__py3-none-any.whl

opencode/resources/session.py

@@ -0,0 +1,3553 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``session`` resource."""
+
+from __future__ import annotations
+
+import builtins
+from collections.abc import Mapping, Sequence
+from functools import cached_property
+from typing import Any, Literal, cast
+
+from .._base_client import RequestOptions
+from .._pagination import AsyncPaginator, SyncCursorPage
+from .._qs import encode_path_segment
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._streaming import AsyncStream, Stream
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, OpenEnum, Query, Timeout
+from ..types import (
+    AbsolutePath,
+    AgentID,
+    EventSeq,
+    FileDiffInfo,
+    FormAnswer,
+    FormDetail,
+    FormFields,
+    FormID,
+    FormInfo,
+    FormMetadata,
+    InstructionEntryInfo,
+    InstructionEntryKey,
+    LocationPublicRef,
+    ModelRef,
+    PermissionRuleset,
+    ProjectID,
+    PromptAgentAttachment,
+    PromptInputFileAttachment,
+    PromptInputSkillAttachment,
+    RelativePath,
+    SessionGenerateResponseData,
+    SessionID,
+    SessionInboxCompaction,
+    SessionInboxDelivery,
+    SessionInboxInfo,
+    SessionInboxSynthetic,
+    SessionInboxUser,
+    SessionInfo,
+    SessionInterruptResponse,
+    SessionLogItem,
+    SessionMessageID,
+    SessionMessageInfo,
+    SessionMetadata,
+    SessionRevert,
+    SessionsCursor,
+    SessionsResponse,
+    SessionStatsInfo,
+    SessionTransferData,
+    SkillID,
+)
+
+__all__ = ["SessionResource", "AsyncSessionResource"]
+
+
+class SessionRevertResource(SyncAPIResource):
+    """Operations under ``client.session.revert`` (OpenCode ``session.revert``)."""
+
+    def stage(
+        self,
+        session_id: SessionID,
+        *,
+        message_id: SessionMessageID,
+        files: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionRevert:
+        """Stage session revert.
+
+        Stage or move a reversible session boundary and optionally apply its file changes.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          MessageNotFoundError
+          SessionNotFoundError
+          LocationNotFoundError
+          SessionBusyError
+          UnknownError
+
+        ``POST /api/session/:sessionID/revert/stage``
+        """
+        return cast(
+            "SessionRevert",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/revert/stage",
+                    body={"messageID": message_id, "files": files},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionRevert,
+                unwrap=True,
+            ),
+        )
+
+    def clear(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Clear staged revert.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          SessionBusyError
+          UnknownError
+
+        ``DELETE /api/session/:sessionID/revert``
+        """
+        self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}/revert",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def commit(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Commit staged revert.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          SessionBusyError
+
+        ``POST /api/session/:sessionID/revert/commit``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/revert/commit",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class SessionInboxResource(SyncAPIResource):
+    """Operations under ``client.session.inbox`` (OpenCode ``session.inbox``)."""
+
+    def list(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[SessionInboxInfo]:
+        """List session inbox.
+
+        List durable enqueued session work not yet delivered, ordered by enqueue sequence. Includes user, synthetic, compaction, and move items.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``GET /api/session/:sessionID/inbox``
+        """
+        return cast(
+            "builtins.list[SessionInboxInfo]",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/inbox",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[SessionInboxInfo],
+                unwrap=True,
+            ),
+        )
+
+    def cancel(
+        self,
+        session_id: SessionID,
+        inbox_id: SessionMessageID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Cancel inbox input.
+
+        Cancel an inbox item that has not yet been delivered. Unavailable items are a no-op.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``DELETE /api/session/:sessionID/inbox/:inboxID``
+        """
+        self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}/inbox/{encode_path_segment(inbox_id)}",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def update(
+        self,
+        session_id: SessionID,
+        inbox_id: SessionMessageID,
+        *,
+        delivery: SessionInboxDelivery,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Update inbox item.
+
+        Change a pending inbox item's delivery mode. Steering wakes session execution.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          ConflictError
+
+        ``PATCH /api/session/:sessionID/inbox/:inboxID``
+        """
+        self._client.request(
+            RequestOptions(
+                method="PATCH",
+                path=f"/api/session/{encode_path_segment(session_id)}/inbox/{encode_path_segment(inbox_id)}",
+                body={"delivery": delivery},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class SessionInstructionsEntryResource(SyncAPIResource):
+    """Operations under ``client.session.instructions.entry`` (OpenCode ``session.instructions.entry``)."""
+
+    def list(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[InstructionEntryInfo]:
+        """List instruction entries.
+
+        List API-managed instruction entries attached to the session.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/experimental/session/:sessionID/instructions/entries``
+        """
+        return cast(
+            "builtins.list[InstructionEntryInfo]",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/experimental/session/{encode_path_segment(session_id)}/instructions/entries",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[InstructionEntryInfo],
+                unwrap=True,
+            ),
+        )
+
+    def put(
+        self,
+        session_id: SessionID,
+        key: InstructionEntryKey,
+        *,
+        value: Any,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Put instruction entry.
+
+        Attach or replace one durable instruction entry. Changes announce as updates at the next step boundary.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          InstructionEntryValueTooLargeError
+
+        ``PUT /api/experimental/session/:sessionID/instructions/entries/:key``
+        """
+        self._client.request(
+            RequestOptions(
+                method="PUT",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/instructions/entries/{encode_path_segment(key)}",
+                body={"value": value},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def remove(
+        self,
+        session_id: SessionID,
+        key: InstructionEntryKey,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Remove instruction entry.
+
+        Remove one instruction entry; the removal is announced to the model at the next step boundary.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``DELETE /api/experimental/session/:sessionID/instructions/entries/:key``
+        """
+        self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/instructions/entries/{encode_path_segment(key)}",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class SessionInstructionsResource(SyncAPIResource):
+    """Operations under ``client.session.instructions`` (OpenCode ``session.instructions``)."""
+
+    @cached_property
+    def entry(self) -> SessionInstructionsEntryResource:
+        return SessionInstructionsEntryResource(self._client)
+
+
+class SessionMessageResource(SyncAPIResource):
+    """Operations under ``client.session.message`` (OpenCode ``session.message``)."""
+
+    def get(
+        self,
+        session_id: SessionID,
+        message_id: SessionMessageID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionMessageInfo:
+        """Get session message.
+
+        Retrieve one projected message owned by the Session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          MessageNotFoundError
+
+        ``GET /api/session/:sessionID/message/:messageID``
+        """
+        return cast(
+            "SessionMessageInfo",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/message/{encode_path_segment(message_id)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionMessageInfo,
+                unwrap=True,
+            ),
+        )
+
+
+class SessionFormResource(SyncAPIResource):
+    """Operations under ``client.session.form`` (OpenCode ``session.form``)."""
+
+    def list(
+        self,
+        session_id: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[FormInfo]:
+        """List session forms.
+
+        Retrieve pending forms for a session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/session/:sessionID/form``
+        """
+        return cast(
+            "builtins.list[FormInfo]",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/form",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[FormInfo],
+                unwrap=True,
+            ),
+        )
+
+    def create(
+        self,
+        session_id: str,
+        *,
+        title: str,
+        fields: FormFields,
+        id: FormID | NotGiven | None = NOT_GIVEN,
+        metadata: FormMetadata | NotGiven = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> FormInfo:
+        """Create session form.
+
+        Create a form for a session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/form``
+        """
+        return cast(
+            "FormInfo",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/form",
+                    body={"id": id, "title": title, "metadata": metadata, "fields": fields},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FormInfo,
+                unwrap=True,
+            ),
+        )
+
+    def get(
+        self,
+        session_id: str,
+        form_id: FormID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> FormDetail:
+        """Get session form.
+
+        Retrieve a form and its current state for a session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          FormNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/session/:sessionID/form/:formID``
+        """
+        return cast(
+            "FormDetail",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/form/{encode_path_segment(form_id)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FormDetail,
+                unwrap=True,
+            ),
+        )
+
+    def reply(
+        self,
+        session_id: str,
+        form_id: FormID,
+        *,
+        answer: FormAnswer,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Reply to form.
+
+        Submit an answer to a pending form.
+
+        Raises:
+          FormInvalidAnswerError
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          FormNotFoundError
+          LocationNotFoundError
+          FormAlreadySettledError
+
+        ``POST /api/session/:sessionID/form/:formID/reply``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/form/{encode_path_segment(form_id)}/reply",
+                body={"answer": answer},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def cancel(
+        self,
+        session_id: str,
+        form_id: FormID,
+        *,
+        message: str | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Cancel form.
+
+        Cancel a pending form, optionally telling the asker why it was not answered.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          FormNotFoundError
+          LocationNotFoundError
+          FormAlreadySettledError
+
+        ``DELETE /api/session/:sessionID/form/:formID``
+        """
+        self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}/form/{encode_path_segment(form_id)}",
+                query={"message": message},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class SessionResource(SyncAPIResource):
+    """Operations under ``client.session`` (OpenCode ``session``)."""
+
+    @cached_property
+    def revert(self) -> SessionRevertResource:
+        return SessionRevertResource(self._client)
+
+    @cached_property
+    def inbox(self) -> SessionInboxResource:
+        return SessionInboxResource(self._client)
+
+    @cached_property
+    def instructions(self) -> SessionInstructionsResource:
+        return SessionInstructionsResource(self._client)
+
+    @cached_property
+    def message(self) -> SessionMessageResource:
+        return SessionMessageResource(self._client)
+
+    @cached_property
+    def form(self) -> SessionFormResource:
+        return SessionFormResource(self._client)
+
+    def list(
+        self,
+        *,
+        limit: int | NotGiven | None = NOT_GIVEN,
+        order: OpenEnum[Literal["asc", "desc"]] | NotGiven | None = NOT_GIVEN,
+        search: str | NotGiven | None = NOT_GIVEN,
+        parent_id: SessionID | NotGiven | None = NOT_GIVEN,
+        archived: bool | NotGiven | None = NOT_GIVEN,
+        directory: AbsolutePath | NotGiven | None = NOT_GIVEN,
+        project: ProjectID | NotGiven | None = NOT_GIVEN,
+        subpath: RelativePath | NotGiven | None = NOT_GIVEN,
+        cursor: SessionsCursor | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SyncCursorPage[SessionInfo]:
+        """List sessions.
+
+        Retrieve sessions in the requested order. Items keep that order across pages; use cursor.next or cursor.previous to move through the ordered list.
+
+        Args:
+          limit: Maximum number of sessions to return. Defaults to the newest 50 sessions.
+          order: Session order for the first page. Use desc for newest first or asc for oldest first.
+          parent_id: Filter by parent session. Use null to return only root sessions.
+          archived: Filter by archive state. Use true to return only archived sessions or false to exclude them. Omit to include both.
+
+        Raises:
+          InvalidCursorError
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/session``
+        """
+        return self._client.page(
+            RequestOptions(
+                method="GET",
+                path="/api/session",
+                query={
+                    "limit": limit,
+                    "order": order,
+                    "search": search,
+                    "parentID": parent_id,
+                    "archived": archived,
+                    "directory": directory,
+                    "project": project,
+                    "subpath": subpath,
+                    "cursor": cursor,
+                },
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            response_type=SessionsResponse,
+        )
+
+    def stats(
+        self,
+        *,
+        from_: float | OpenEnum[Literal["Infinity", "-Infinity", "NaN"]] | NotGiven | None = NOT_GIVEN,
+        to: float | OpenEnum[Literal["Infinity", "-Infinity", "NaN"]] | NotGiven | None = NOT_GIVEN,
+        project: ProjectID | NotGiven | None = NOT_GIVEN,
+        timezone: str | NotGiven | None = NOT_GIVEN,
+        tools: OpenEnum[Literal["none", "summary", "detail"]] | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionStatsInfo:
+        """Get session statistics.
+
+        Aggregate local session activity, usage, and tool reliability for a time range.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/experimental/session/stats``
+        """
+        return cast(
+            "SessionStatsInfo",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/experimental/session/stats",
+                    query={"from": from_, "to": to, "project": project, "timezone": timezone, "tools": tools},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionStatsInfo,
+                unwrap=True,
+            ),
+        )
+
+    def create(
+        self,
+        *,
+        id: SessionID | NotGiven | None = NOT_GIVEN,
+        parent_id: SessionID | NotGiven | None = NOT_GIVEN,
+        title: str | NotGiven | None = NOT_GIVEN,
+        agent: AgentID | NotGiven | None = NOT_GIVEN,
+        model: ModelRef | NotGiven | None = NOT_GIVEN,
+        location: LocationPublicRef | NotGiven | None = NOT_GIVEN,
+        metadata: SessionMetadata | NotGiven | None = NOT_GIVEN,
+        permissions: PermissionRuleset | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Create session.
+
+        Create a session at the requested location. A parentID creates a linked child session at its parent's location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``POST /api/session``
+        """
+        return cast(
+            "SessionInfo",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/session",
+                    body={
+                        "id": id,
+                        "parentID": parent_id,
+                        "title": title,
+                        "agent": agent,
+                        "model": model,
+                        "location": self._location(location),
+                        "metadata": metadata,
+                        "permissions": permissions,
+                    },
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    def import_(
+        self,
+        *,
+        info: SessionInfo,
+        messages: Sequence[Any],
+        location: LocationPublicRef | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Import session.
+
+        Import a projected session transcript at the requested location. Accepts transcripts exported by earlier releases. If parentID is supplied, the parent session must already exist; import parents before children.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          ConflictError
+
+        ``POST /api/experimental/session/import``
+        """
+        return cast(
+            "SessionInfo",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/session/import",
+                    body={"info": info, "messages": messages, "location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    def export(
+        self,
+        session_id: SessionID,
+        *,
+        sanitize: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionTransferData:
+        """Export session.
+
+        Export a complete projected session transcript.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          UnknownError
+
+        ``GET /api/experimental/session/:sessionID/export``
+        """
+        return cast(
+            "SessionTransferData",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/experimental/session/{encode_path_segment(session_id)}/export",
+                    query={"sanitize": sanitize},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionTransferData,
+                unwrap=True,
+            ),
+        )
+
+    def active(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.dict[str, Any]:
+        """List active sessions.
+
+        Retrieve foreground Session drains currently owned by this OpenCode process. Sessions absent from the result are inactive.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/session/active``
+        """
+        return cast(
+            "builtins.dict[str, Any]",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/session/active",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.dict[str, Any],
+                unwrap=True,
+            ),
+        )
+
+    def get(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Get session.
+
+        Retrieve a session by ID.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``GET /api/session/:sessionID``
+        """
+        return cast(
+            "SessionInfo",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    def remove(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Delete session.
+
+        Delete a session and its child sessions.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``DELETE /api/session/:sessionID``
+        """
+        self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def fork(
+        self,
+        session_id: SessionID,
+        *,
+        before: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Fork session.
+
+        Create a child session by copying projected history before a message. Omit before to copy the full history.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          MessageNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/fork``
+        """
+        return cast(
+            "SessionInfo",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/fork",
+                    body={"before": before},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    def switch_agent(
+        self,
+        session_id: SessionID,
+        *,
+        agent: AgentID,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Switch session agent.
+
+        Switch the agent used by subsequent provider turns.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/agent``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/agent",
+                body={"agent": agent},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def switch_model(
+        self,
+        session_id: SessionID,
+        *,
+        model: ModelRef,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Switch session model.
+
+        Switch the model used by subsequent provider turns.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/model``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/model",
+                body={"model": model},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def update(
+        self,
+        session_id: SessionID,
+        *,
+        title: str | NotGiven | None = NOT_GIVEN,
+        metadata: SessionMetadata | NotGiven | None = NOT_GIVEN,
+        permissions: PermissionRuleset | NotGiven | None = NOT_GIVEN,
+        archived: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Update session.
+
+        Update mutable session properties.
+
+        Args:
+          archived: Archive the session with true or restore it with false. Repeating the current state is a no-op.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``PATCH /api/session/:sessionID``
+        """
+        self._client.request(
+            RequestOptions(
+                method="PATCH",
+                path=f"/api/session/{encode_path_segment(session_id)}",
+                body={"title": title, "metadata": metadata, "permissions": permissions, "archived": archived},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def move(
+        self,
+        session_id: SessionID,
+        *,
+        directory: AbsolutePath,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Move session.
+
+        Move a session to another project directory at the requested delivery boundary.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``POST /api/session/:sessionID/move``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/move",
+                body={"directory": directory, "delivery": delivery},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def prompt(
+        self,
+        session_id: SessionID,
+        *,
+        text: str,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        files: Sequence[PromptInputFileAttachment] | NotGiven = NOT_GIVEN,
+        agents: Sequence[PromptAgentAttachment] | NotGiven = NOT_GIVEN,
+        skills: Sequence[PromptInputSkillAttachment] | NotGiven = NOT_GIVEN,
+        metadata: Mapping[str, Any] | NotGiven = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInboxUser:
+        """Send message.
+
+        Durably admit one session input and schedule agent-loop execution unless resume is false.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/prompt``
+        """
+        return cast(
+            "SessionInboxUser",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/prompt",
+                    body={
+                        "id": id,
+                        "text": text,
+                        "files": files,
+                        "agents": agents,
+                        "skills": skills,
+                        "metadata": metadata,
+                        "delivery": delivery,
+                        "resume": resume,
+                    },
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInboxUser,
+                unwrap=True,
+            ),
+        )
+
+    def command(
+        self,
+        session_id: SessionID,
+        *,
+        name: str,
+        text: str,
+        files: Sequence[PromptInputFileAttachment] | NotGiven = NOT_GIVEN,
+        agents: Sequence[PromptAgentAttachment] | NotGiven = NOT_GIVEN,
+        skills: Sequence[PromptInputSkillAttachment] | NotGiven = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Run command.
+
+        Execute a slash command callback immediately.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          CommandNotFoundError
+          LocationNotFoundError
+          CommandExecutionError
+
+        ``POST /api/session/:sessionID/command``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/command",
+                body={
+                    "name": name,
+                    "text": text,
+                    "files": files,
+                    "agents": agents,
+                    "skills": skills,
+                    "delivery": delivery,
+                },
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def skill(
+        self,
+        session_id: SessionID,
+        *,
+        id: SkillID,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Activate skill.
+
+        Activate a skill for a session by appending a skill message and resuming execution.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          SkillNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/experimental/session/:sessionID/skill``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/skill",
+                body={"id": id, "resume": resume},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def synthetic(
+        self,
+        session_id: SessionID,
+        *,
+        text: str,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        description: str | NotGiven | None = NOT_GIVEN,
+        metadata: Mapping[str, Any] | NotGiven = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInboxSynthetic:
+        """Add synthetic message.
+
+        Durably admit synthetic session input and schedule execution unless resume is false.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/synthetic``
+        """
+        return cast(
+            "SessionInboxSynthetic",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/synthetic",
+                    body={
+                        "id": id,
+                        "text": text,
+                        "description": description,
+                        "metadata": metadata,
+                        "delivery": delivery,
+                        "resume": resume,
+                    },
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInboxSynthetic,
+                unwrap=True,
+            ),
+        )
+
+    def shell(
+        self,
+        session_id: SessionID,
+        *,
+        command: str,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Run shell command.
+
+        Execute one shell command in the session's working directory. Emits a shell.started event before execution and a shell.ended event with the merged output after.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/shell``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/shell",
+                body={"id": id, "command": command},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def compact(
+        self,
+        session_id: SessionID,
+        *,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInboxCompaction:
+        """Compact session.
+
+        Durably admit a session compaction request. Steers by default: it runs at the next step boundary instead of waiting behind queued prompts.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/compact``
+        """
+        return cast(
+            "SessionInboxCompaction",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/compact",
+                    body={"id": id, "delivery": delivery},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInboxCompaction,
+                unwrap=True,
+            ),
+        )
+
+    def wait(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Wait for session.
+
+        Wait for a session agent loop to become idle.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/experimental/session/:sessionID/wait``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/wait",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def context(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[SessionMessageInfo]:
+        """Get session context.
+
+        Retrieve the active context messages for a session (all messages after the last compaction).
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          UnknownError
+
+        ``GET /api/session/:sessionID/context``
+        """
+        return cast(
+            "builtins.list[SessionMessageInfo]",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/context",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[SessionMessageInfo],
+                unwrap=True,
+            ),
+        )
+
+    def diff(
+        self,
+        session_id: SessionID,
+        *,
+        from_: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        to: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        context: int | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[FileDiffInfo]:
+        """Diff session turns.
+
+        Structured per-file diffs of the files a turn changed. A turn runs from the first prompt after the session was last idle until its next idle marker, so prompts steered in while it was busy belong to the same turn; `to` extends the range through a later turn. Compares the range's first recorded snapshot with its last; a step still running in the active session compares against the working copy. Ranges that span a location change are rejected. In sessions without any idle marker, a prompt's turn spans until the next user message.
+
+        Args:
+          from_: User message whose turn to diff. Defaults to the turn of the newest user message.
+          to: Later user message whose turn ends the range. Defaults to the turn of `from` alone.
+          context: Unchanged lines around each hunk. Omit for full-file patches.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          MessageNotFoundError
+          SessionNotFoundError
+          LocationNotFoundError
+          UnknownError
+
+        ``GET /api/session/:sessionID/diff``
+        """
+        return cast(
+            "builtins.list[FileDiffInfo]",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/diff",
+                    query={"from": from_, "to": to, "context": context},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[FileDiffInfo],
+                unwrap=True,
+            ),
+        )
+
+    def generate(
+        self,
+        session_id: SessionID,
+        *,
+        prompt: str,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionGenerateResponseData:
+        """Generate text from session context.
+
+        Generate transient text from the current session context without mutating session history.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/session/:sessionID/generate``
+        """
+        return cast(
+            "SessionGenerateResponseData",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/generate",
+                    body={"prompt": prompt},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionGenerateResponseData,
+                unwrap=True,
+            ),
+        )
+
+    def log(
+        self,
+        session_id: SessionID,
+        *,
+        after: EventSeq | NotGiven | None = NOT_GIVEN,
+        follow: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> Stream[SessionLogItem]:
+        """Read the session log.
+
+        Experimental durable session event log. Reads events after an exclusive aggregate sequence and continues with live events when follow=true.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``GET /api/experimental/session/:sessionID/log``
+        """
+        return self._client.stream(
+            RequestOptions(
+                method="GET",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/log",
+                query={"after": after, "follow": follow},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            item_type=SessionLogItem,
+        )
+
+    def interrupt(
+        self,
+        session_id: SessionID,
+        *,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInterruptResponse:
+        """Interrupt session execution.
+
+        Interrupt active execution owned by this OpenCode process. Returns interrupted=true when an active execution was interrupted and false for the idle no-op. When resume=true, execution resumes pending steering input and next-in-line control items (manual compaction, moves) while queued prompts remain parked.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/interrupt``
+        """
+        return cast(
+            "SessionInterruptResponse",
+            self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/interrupt",
+                    query={"resume": resume},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInterruptResponse,
+            ),
+        )
+
+    def background(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Background blocking session tools.
+
+        Move active foreground backgroundable tools for this session into background observation. Idle requests are a no-op.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/background``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/background",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def environment(
+        self,
+        session_id: SessionID,
+        *,
+        variables: Mapping[str, str],
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Set session environment.
+
+        Replace the process environment used by local shell commands for this session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``PUT /api/session/:sessionID/environment``
+        """
+        self._client.request(
+            RequestOptions(
+                method="PUT",
+                path=f"/api/session/{encode_path_segment(session_id)}/environment",
+                body={"variables": variables},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    def view(
+        self,
+        session_id: SessionID,
+        *,
+        idle: float,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """View session.
+
+        Mark the idle transition observed by the viewer as viewed.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``POST /api/session/:sessionID/view``
+        """
+        self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/view",
+                body={"idle": idle},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncSessionRevertResource(AsyncAPIResource):
+    """Operations under ``client.session.revert`` (OpenCode ``session.revert``)."""
+
+    async def stage(
+        self,
+        session_id: SessionID,
+        *,
+        message_id: SessionMessageID,
+        files: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionRevert:
+        """Stage session revert.
+
+        Stage or move a reversible session boundary and optionally apply its file changes.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          MessageNotFoundError
+          SessionNotFoundError
+          LocationNotFoundError
+          SessionBusyError
+          UnknownError
+
+        ``POST /api/session/:sessionID/revert/stage``
+        """
+        return cast(
+            "SessionRevert",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/revert/stage",
+                    body={"messageID": message_id, "files": files},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionRevert,
+                unwrap=True,
+            ),
+        )
+
+    async def clear(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Clear staged revert.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          SessionBusyError
+          UnknownError
+
+        ``DELETE /api/session/:sessionID/revert``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}/revert",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def commit(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Commit staged revert.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          SessionBusyError
+
+        ``POST /api/session/:sessionID/revert/commit``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/revert/commit",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncSessionInboxResource(AsyncAPIResource):
+    """Operations under ``client.session.inbox`` (OpenCode ``session.inbox``)."""
+
+    async def list(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[SessionInboxInfo]:
+        """List session inbox.
+
+        List durable enqueued session work not yet delivered, ordered by enqueue sequence. Includes user, synthetic, compaction, and move items.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``GET /api/session/:sessionID/inbox``
+        """
+        return cast(
+            "builtins.list[SessionInboxInfo]",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/inbox",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[SessionInboxInfo],
+                unwrap=True,
+            ),
+        )
+
+    async def cancel(
+        self,
+        session_id: SessionID,
+        inbox_id: SessionMessageID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Cancel inbox input.
+
+        Cancel an inbox item that has not yet been delivered. Unavailable items are a no-op.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``DELETE /api/session/:sessionID/inbox/:inboxID``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}/inbox/{encode_path_segment(inbox_id)}",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def update(
+        self,
+        session_id: SessionID,
+        inbox_id: SessionMessageID,
+        *,
+        delivery: SessionInboxDelivery,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Update inbox item.
+
+        Change a pending inbox item's delivery mode. Steering wakes session execution.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          ConflictError
+
+        ``PATCH /api/session/:sessionID/inbox/:inboxID``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="PATCH",
+                path=f"/api/session/{encode_path_segment(session_id)}/inbox/{encode_path_segment(inbox_id)}",
+                body={"delivery": delivery},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncSessionInstructionsEntryResource(AsyncAPIResource):
+    """Operations under ``client.session.instructions.entry`` (OpenCode ``session.instructions.entry``)."""
+
+    async def list(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[InstructionEntryInfo]:
+        """List instruction entries.
+
+        List API-managed instruction entries attached to the session.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/experimental/session/:sessionID/instructions/entries``
+        """
+        return cast(
+            "builtins.list[InstructionEntryInfo]",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/experimental/session/{encode_path_segment(session_id)}/instructions/entries",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[InstructionEntryInfo],
+                unwrap=True,
+            ),
+        )
+
+    async def put(
+        self,
+        session_id: SessionID,
+        key: InstructionEntryKey,
+        *,
+        value: Any,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Put instruction entry.
+
+        Attach or replace one durable instruction entry. Changes announce as updates at the next step boundary.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          InstructionEntryValueTooLargeError
+
+        ``PUT /api/experimental/session/:sessionID/instructions/entries/:key``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="PUT",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/instructions/entries/{encode_path_segment(key)}",
+                body={"value": value},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def remove(
+        self,
+        session_id: SessionID,
+        key: InstructionEntryKey,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Remove instruction entry.
+
+        Remove one instruction entry; the removal is announced to the model at the next step boundary.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``DELETE /api/experimental/session/:sessionID/instructions/entries/:key``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/instructions/entries/{encode_path_segment(key)}",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncSessionInstructionsResource(AsyncAPIResource):
+    """Operations under ``client.session.instructions`` (OpenCode ``session.instructions``)."""
+
+    @cached_property
+    def entry(self) -> AsyncSessionInstructionsEntryResource:
+        return AsyncSessionInstructionsEntryResource(self._client)
+
+
+class AsyncSessionMessageResource(AsyncAPIResource):
+    """Operations under ``client.session.message`` (OpenCode ``session.message``)."""
+
+    async def get(
+        self,
+        session_id: SessionID,
+        message_id: SessionMessageID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionMessageInfo:
+        """Get session message.
+
+        Retrieve one projected message owned by the Session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          MessageNotFoundError
+
+        ``GET /api/session/:sessionID/message/:messageID``
+        """
+        return cast(
+            "SessionMessageInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/message/{encode_path_segment(message_id)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionMessageInfo,
+                unwrap=True,
+            ),
+        )
+
+
+class AsyncSessionFormResource(AsyncAPIResource):
+    """Operations under ``client.session.form`` (OpenCode ``session.form``)."""
+
+    async def list(
+        self,
+        session_id: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[FormInfo]:
+        """List session forms.
+
+        Retrieve pending forms for a session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/session/:sessionID/form``
+        """
+        return cast(
+            "builtins.list[FormInfo]",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/form",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[FormInfo],
+                unwrap=True,
+            ),
+        )
+
+    async def create(
+        self,
+        session_id: str,
+        *,
+        title: str,
+        fields: FormFields,
+        id: FormID | NotGiven | None = NOT_GIVEN,
+        metadata: FormMetadata | NotGiven = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> FormInfo:
+        """Create session form.
+
+        Create a form for a session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/form``
+        """
+        return cast(
+            "FormInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/form",
+                    body={"id": id, "title": title, "metadata": metadata, "fields": fields},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FormInfo,
+                unwrap=True,
+            ),
+        )
+
+    async def get(
+        self,
+        session_id: str,
+        form_id: FormID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> FormDetail:
+        """Get session form.
+
+        Retrieve a form and its current state for a session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          FormNotFoundError
+          LocationNotFoundError
+
+        ``GET /api/session/:sessionID/form/:formID``
+        """
+        return cast(
+            "FormDetail",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/form/{encode_path_segment(form_id)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=FormDetail,
+                unwrap=True,
+            ),
+        )
+
+    async def reply(
+        self,
+        session_id: str,
+        form_id: FormID,
+        *,
+        answer: FormAnswer,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Reply to form.
+
+        Submit an answer to a pending form.
+
+        Raises:
+          FormInvalidAnswerError
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          FormNotFoundError
+          LocationNotFoundError
+          FormAlreadySettledError
+
+        ``POST /api/session/:sessionID/form/:formID/reply``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/form/{encode_path_segment(form_id)}/reply",
+                body={"answer": answer},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def cancel(
+        self,
+        session_id: str,
+        form_id: FormID,
+        *,
+        message: str | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Cancel form.
+
+        Cancel a pending form, optionally telling the asker why it was not answered.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          FormNotFoundError
+          LocationNotFoundError
+          FormAlreadySettledError
+
+        ``DELETE /api/session/:sessionID/form/:formID``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}/form/{encode_path_segment(form_id)}",
+                query={"message": message},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+
+class AsyncSessionResource(AsyncAPIResource):
+    """Operations under ``client.session`` (OpenCode ``session``)."""
+
+    @cached_property
+    def revert(self) -> AsyncSessionRevertResource:
+        return AsyncSessionRevertResource(self._client)
+
+    @cached_property
+    def inbox(self) -> AsyncSessionInboxResource:
+        return AsyncSessionInboxResource(self._client)
+
+    @cached_property
+    def instructions(self) -> AsyncSessionInstructionsResource:
+        return AsyncSessionInstructionsResource(self._client)
+
+    @cached_property
+    def message(self) -> AsyncSessionMessageResource:
+        return AsyncSessionMessageResource(self._client)
+
+    @cached_property
+    def form(self) -> AsyncSessionFormResource:
+        return AsyncSessionFormResource(self._client)
+
+    def list(
+        self,
+        *,
+        limit: int | NotGiven | None = NOT_GIVEN,
+        order: OpenEnum[Literal["asc", "desc"]] | NotGiven | None = NOT_GIVEN,
+        search: str | NotGiven | None = NOT_GIVEN,
+        parent_id: SessionID | NotGiven | None = NOT_GIVEN,
+        archived: bool | NotGiven | None = NOT_GIVEN,
+        directory: AbsolutePath | NotGiven | None = NOT_GIVEN,
+        project: ProjectID | NotGiven | None = NOT_GIVEN,
+        subpath: RelativePath | NotGiven | None = NOT_GIVEN,
+        cursor: SessionsCursor | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> AsyncPaginator[SessionInfo]:
+        """List sessions.
+
+        Retrieve sessions in the requested order. Items keep that order across pages; use cursor.next or cursor.previous to move through the ordered list.
+
+        Args:
+          limit: Maximum number of sessions to return. Defaults to the newest 50 sessions.
+          order: Session order for the first page. Use desc for newest first or asc for oldest first.
+          parent_id: Filter by parent session. Use null to return only root sessions.
+          archived: Filter by archive state. Use true to return only archived sessions or false to exclude them. Omit to include both.
+
+        Raises:
+          InvalidCursorError
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/session``
+        """
+        return self._client.page(
+            RequestOptions(
+                method="GET",
+                path="/api/session",
+                query={
+                    "limit": limit,
+                    "order": order,
+                    "search": search,
+                    "parentID": parent_id,
+                    "archived": archived,
+                    "directory": directory,
+                    "project": project,
+                    "subpath": subpath,
+                    "cursor": cursor,
+                },
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            response_type=SessionsResponse,
+        )
+
+    async def stats(
+        self,
+        *,
+        from_: float | OpenEnum[Literal["Infinity", "-Infinity", "NaN"]] | NotGiven | None = NOT_GIVEN,
+        to: float | OpenEnum[Literal["Infinity", "-Infinity", "NaN"]] | NotGiven | None = NOT_GIVEN,
+        project: ProjectID | NotGiven | None = NOT_GIVEN,
+        timezone: str | NotGiven | None = NOT_GIVEN,
+        tools: OpenEnum[Literal["none", "summary", "detail"]] | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionStatsInfo:
+        """Get session statistics.
+
+        Aggregate local session activity, usage, and tool reliability for a time range.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/experimental/session/stats``
+        """
+        return cast(
+            "SessionStatsInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/experimental/session/stats",
+                    query={"from": from_, "to": to, "project": project, "timezone": timezone, "tools": tools},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionStatsInfo,
+                unwrap=True,
+            ),
+        )
+
+    async def create(
+        self,
+        *,
+        id: SessionID | NotGiven | None = NOT_GIVEN,
+        parent_id: SessionID | NotGiven | None = NOT_GIVEN,
+        title: str | NotGiven | None = NOT_GIVEN,
+        agent: AgentID | NotGiven | None = NOT_GIVEN,
+        model: ModelRef | NotGiven | None = NOT_GIVEN,
+        location: LocationPublicRef | NotGiven | None = NOT_GIVEN,
+        metadata: SessionMetadata | NotGiven | None = NOT_GIVEN,
+        permissions: PermissionRuleset | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Create session.
+
+        Create a session at the requested location. A parentID creates a linked child session at its parent's location.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``POST /api/session``
+        """
+        return cast(
+            "SessionInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/session",
+                    body={
+                        "id": id,
+                        "parentID": parent_id,
+                        "title": title,
+                        "agent": agent,
+                        "model": model,
+                        "location": self._location(location),
+                        "metadata": metadata,
+                        "permissions": permissions,
+                    },
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    async def import_(
+        self,
+        *,
+        info: SessionInfo,
+        messages: Sequence[Any],
+        location: LocationPublicRef | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Import session.
+
+        Import a projected session transcript at the requested location. Accepts transcripts exported by earlier releases. If parentID is supplied, the parent session must already exist; import parents before children.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          ConflictError
+
+        ``POST /api/experimental/session/import``
+        """
+        return cast(
+            "SessionInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path="/api/experimental/session/import",
+                    body={"info": info, "messages": messages, "location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    async def export(
+        self,
+        session_id: SessionID,
+        *,
+        sanitize: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionTransferData:
+        """Export session.
+
+        Export a complete projected session transcript.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          UnknownError
+
+        ``GET /api/experimental/session/:sessionID/export``
+        """
+        return cast(
+            "SessionTransferData",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/experimental/session/{encode_path_segment(session_id)}/export",
+                    query={"sanitize": sanitize},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionTransferData,
+                unwrap=True,
+            ),
+        )
+
+    async def active(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.dict[str, Any]:
+        """List active sessions.
+
+        Retrieve foreground Session drains currently owned by this OpenCode process. Sessions absent from the result are inactive.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+
+        ``GET /api/session/active``
+        """
+        return cast(
+            "builtins.dict[str, Any]",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/session/active",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.dict[str, Any],
+                unwrap=True,
+            ),
+        )
+
+    async def get(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Get session.
+
+        Retrieve a session by ID.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``GET /api/session/:sessionID``
+        """
+        return cast(
+            "SessionInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    async def remove(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Delete session.
+
+        Delete a session and its child sessions.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``DELETE /api/session/:sessionID``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="DELETE",
+                path=f"/api/session/{encode_path_segment(session_id)}",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def fork(
+        self,
+        session_id: SessionID,
+        *,
+        before: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInfo:
+        """Fork session.
+
+        Create a child session by copying projected history before a message. Omit before to copy the full history.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          MessageNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/fork``
+        """
+        return cast(
+            "SessionInfo",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/fork",
+                    body={"before": before},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInfo,
+                unwrap=True,
+            ),
+        )
+
+    async def switch_agent(
+        self,
+        session_id: SessionID,
+        *,
+        agent: AgentID,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Switch session agent.
+
+        Switch the agent used by subsequent provider turns.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/agent``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/agent",
+                body={"agent": agent},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def switch_model(
+        self,
+        session_id: SessionID,
+        *,
+        model: ModelRef,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Switch session model.
+
+        Switch the model used by subsequent provider turns.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/model``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/model",
+                body={"model": model},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def update(
+        self,
+        session_id: SessionID,
+        *,
+        title: str | NotGiven | None = NOT_GIVEN,
+        metadata: SessionMetadata | NotGiven | None = NOT_GIVEN,
+        permissions: PermissionRuleset | NotGiven | None = NOT_GIVEN,
+        archived: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Update session.
+
+        Update mutable session properties.
+
+        Args:
+          archived: Archive the session with true or restore it with false. Repeating the current state is a no-op.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``PATCH /api/session/:sessionID``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="PATCH",
+                path=f"/api/session/{encode_path_segment(session_id)}",
+                body={"title": title, "metadata": metadata, "permissions": permissions, "archived": archived},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def move(
+        self,
+        session_id: SessionID,
+        *,
+        directory: AbsolutePath,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Move session.
+
+        Move a session to another project directory at the requested delivery boundary.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``POST /api/session/:sessionID/move``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/move",
+                body={"directory": directory, "delivery": delivery},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def prompt(
+        self,
+        session_id: SessionID,
+        *,
+        text: str,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        files: Sequence[PromptInputFileAttachment] | NotGiven = NOT_GIVEN,
+        agents: Sequence[PromptAgentAttachment] | NotGiven = NOT_GIVEN,
+        skills: Sequence[PromptInputSkillAttachment] | NotGiven = NOT_GIVEN,
+        metadata: Mapping[str, Any] | NotGiven = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInboxUser:
+        """Send message.
+
+        Durably admit one session input and schedule agent-loop execution unless resume is false.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/prompt``
+        """
+        return cast(
+            "SessionInboxUser",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/prompt",
+                    body={
+                        "id": id,
+                        "text": text,
+                        "files": files,
+                        "agents": agents,
+                        "skills": skills,
+                        "metadata": metadata,
+                        "delivery": delivery,
+                        "resume": resume,
+                    },
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInboxUser,
+                unwrap=True,
+            ),
+        )
+
+    async def command(
+        self,
+        session_id: SessionID,
+        *,
+        name: str,
+        text: str,
+        files: Sequence[PromptInputFileAttachment] | NotGiven = NOT_GIVEN,
+        agents: Sequence[PromptAgentAttachment] | NotGiven = NOT_GIVEN,
+        skills: Sequence[PromptInputSkillAttachment] | NotGiven = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Run command.
+
+        Execute a slash command callback immediately.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          CommandNotFoundError
+          LocationNotFoundError
+          CommandExecutionError
+
+        ``POST /api/session/:sessionID/command``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/command",
+                body={
+                    "name": name,
+                    "text": text,
+                    "files": files,
+                    "agents": agents,
+                    "skills": skills,
+                    "delivery": delivery,
+                },
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def skill(
+        self,
+        session_id: SessionID,
+        *,
+        id: SkillID,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Activate skill.
+
+        Activate a skill for a session by appending a skill message and resuming execution.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          SkillNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/experimental/session/:sessionID/skill``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/skill",
+                body={"id": id, "resume": resume},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def synthetic(
+        self,
+        session_id: SessionID,
+        *,
+        text: str,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        description: str | NotGiven | None = NOT_GIVEN,
+        metadata: Mapping[str, Any] | NotGiven = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInboxSynthetic:
+        """Add synthetic message.
+
+        Durably admit synthetic session input and schedule execution unless resume is false.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/synthetic``
+        """
+        return cast(
+            "SessionInboxSynthetic",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/synthetic",
+                    body={
+                        "id": id,
+                        "text": text,
+                        "description": description,
+                        "metadata": metadata,
+                        "delivery": delivery,
+                        "resume": resume,
+                    },
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInboxSynthetic,
+                unwrap=True,
+            ),
+        )
+
+    async def shell(
+        self,
+        session_id: SessionID,
+        *,
+        command: str,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Run shell command.
+
+        Execute one shell command in the session's working directory. Emits a shell.started event before execution and a shell.ended event with the merged output after.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/shell``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/shell",
+                body={"id": id, "command": command},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def compact(
+        self,
+        session_id: SessionID,
+        *,
+        id: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        delivery: SessionInboxDelivery | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInboxCompaction:
+        """Compact session.
+
+        Durably admit a session compaction request. Steers by default: it runs at the next step boundary instead of waiting behind queued prompts.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ConflictError
+
+        ``POST /api/session/:sessionID/compact``
+        """
+        return cast(
+            "SessionInboxCompaction",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/compact",
+                    body={"id": id, "delivery": delivery},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInboxCompaction,
+                unwrap=True,
+            ),
+        )
+
+    async def wait(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Wait for session.
+
+        Wait for a session agent loop to become idle.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/experimental/session/:sessionID/wait``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/wait",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def context(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[SessionMessageInfo]:
+        """Get session context.
+
+        Retrieve the active context messages for a session (all messages after the last compaction).
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          UnknownError
+
+        ``GET /api/session/:sessionID/context``
+        """
+        return cast(
+            "builtins.list[SessionMessageInfo]",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/context",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[SessionMessageInfo],
+                unwrap=True,
+            ),
+        )
+
+    async def diff(
+        self,
+        session_id: SessionID,
+        *,
+        from_: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        to: SessionMessageID | NotGiven | None = NOT_GIVEN,
+        context: int | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> builtins.list[FileDiffInfo]:
+        """Diff session turns.
+
+        Structured per-file diffs of the files a turn changed. A turn runs from the first prompt after the session was last idle until its next idle marker, so prompts steered in while it was busy belong to the same turn; `to` extends the range through a later turn. Compares the range's first recorded snapshot with its last; a step still running in the active session compares against the working copy. Ranges that span a location change are rejected. In sessions without any idle marker, a prompt's turn spans until the next user message.
+
+        Args:
+          from_: User message whose turn to diff. Defaults to the turn of the newest user message.
+          to: Later user message whose turn ends the range. Defaults to the turn of `from` alone.
+          context: Unchanged lines around each hunk. Omit for full-file patches.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          MessageNotFoundError
+          SessionNotFoundError
+          LocationNotFoundError
+          UnknownError
+
+        ``GET /api/session/:sessionID/diff``
+        """
+        return cast(
+            "builtins.list[FileDiffInfo]",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path=f"/api/session/{encode_path_segment(session_id)}/diff",
+                    query={"from": from_, "to": to, "context": context},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=builtins.list[FileDiffInfo],
+                unwrap=True,
+            ),
+        )
+
+    async def generate(
+        self,
+        session_id: SessionID,
+        *,
+        prompt: str,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionGenerateResponseData:
+        """Generate text from session context.
+
+        Generate transient text from the current session context without mutating session history.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+          ServiceUnavailableError
+
+        ``POST /api/session/:sessionID/generate``
+        """
+        return cast(
+            "SessionGenerateResponseData",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/generate",
+                    body={"prompt": prompt},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionGenerateResponseData,
+                unwrap=True,
+            ),
+        )
+
+    async def log(
+        self,
+        session_id: SessionID,
+        *,
+        after: EventSeq | NotGiven | None = NOT_GIVEN,
+        follow: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> AsyncStream[SessionLogItem]:
+        """Read the session log.
+
+        Experimental durable session event log. Reads events after an exclusive aggregate sequence and continues with live events when follow=true.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``GET /api/experimental/session/:sessionID/log``
+        """
+        return await self._client.stream(
+            RequestOptions(
+                method="GET",
+                path=f"/api/experimental/session/{encode_path_segment(session_id)}/log",
+                query={"after": after, "follow": follow},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            item_type=SessionLogItem,
+        )
+
+    async def interrupt(
+        self,
+        session_id: SessionID,
+        *,
+        resume: bool | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> SessionInterruptResponse:
+        """Interrupt session execution.
+
+        Interrupt active execution owned by this OpenCode process. Returns interrupted=true when an active execution was interrupted and false for the idle no-op. When resume=true, execution resumes pending steering input and next-in-line control items (manual compaction, moves) while queued prompts remain parked.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/interrupt``
+        """
+        return cast(
+            "SessionInterruptResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="POST",
+                    path=f"/api/session/{encode_path_segment(session_id)}/interrupt",
+                    query={"resume": resume},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type=SessionInterruptResponse,
+            ),
+        )
+
+    async def background(
+        self,
+        session_id: SessionID,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Background blocking session tools.
+
+        Move active foreground backgroundable tools for this session into background observation. Idle requests are a no-op.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+          LocationNotFoundError
+
+        ``POST /api/session/:sessionID/background``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/background",
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def environment(
+        self,
+        session_id: SessionID,
+        *,
+        variables: Mapping[str, str],
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """Set session environment.
+
+        Replace the process environment used by local shell commands for this session.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``PUT /api/session/:sessionID/environment``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="PUT",
+                path=f"/api/session/{encode_path_segment(session_id)}/environment",
+                body={"variables": variables},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )
+
+    async def view(
+        self,
+        session_id: SessionID,
+        *,
+        idle: float,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> None:
+        """View session.
+
+        Mark the idle transition observed by the viewer as viewed.
+
+        Raises:
+          InvalidRequestError
+          UnauthorizedError
+          SessionNotFoundError
+
+        ``POST /api/session/:sessionID/view``
+        """
+        await self._client.request(
+            RequestOptions(
+                method="POST",
+                path=f"/api/session/{encode_path_segment(session_id)}/view",
+                body={"idle": idle},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            kind="void",
+        )