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

opencode/resources/session.py

@@ -80,13 +80,13 @@ class SessionRevertResource(SyncAPIResource):
         Stage or move a reversible session boundary and optionally apply its file changes.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          MessageNotFoundError
-          SessionNotFoundError
-          LocationNotFoundError
-          SessionBusyError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          MessageNotFoundError: The server answered 404.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          SessionBusyError: The server answered 409.
+          UnknownError: The server answered 500.
 
         ``POST /api/session/:sessionID/revert/stage``
         """
@@ -119,12 +119,12 @@ class SessionRevertResource(SyncAPIResource):
         """Clear staged revert.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          SessionBusyError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          SessionBusyError: The server answered 409.
+          UnknownError: The server answered 500.
 
         ``DELETE /api/session/:sessionID/revert``
         """
@@ -152,11 +152,11 @@ class SessionRevertResource(SyncAPIResource):
         """Commit staged revert.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          SessionBusyError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          SessionBusyError: The server answered 409.
 
         ``POST /api/session/:sessionID/revert/commit``
         """
@@ -190,9 +190,9 @@ class SessionInboxResource(SyncAPIResource):
         List durable enqueued session work not yet delivered, ordered by enqueue sequence. Includes user, synthetic, compaction, and move items.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/inbox``
         """
@@ -227,9 +227,9 @@ class SessionInboxResource(SyncAPIResource):
         Cancel an inbox item that has not yet been delivered. Unavailable items are a no-op.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``DELETE /api/session/:sessionID/inbox/:inboxID``
         """
@@ -261,10 +261,10 @@ class SessionInboxResource(SyncAPIResource):
         Change a pending inbox item's delivery mode. Steering wakes session execution.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``PATCH /api/session/:sessionID/inbox/:inboxID``
         """
@@ -301,10 +301,10 @@ class SessionInstructionsEntryResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``GET /api/experimental/session/:sessionID/instructions/entries``
         """
@@ -342,11 +342,11 @@ class SessionInstructionsEntryResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          InstructionEntryValueTooLargeError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          InstructionEntryValueTooLargeError: The server answered 413.
 
         ``PUT /api/experimental/session/:sessionID/instructions/entries/:key``
         """
@@ -380,10 +380,10 @@ class SessionInstructionsEntryResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``DELETE /api/experimental/session/:sessionID/instructions/entries/:key``
         """
@@ -405,6 +405,7 @@ class SessionInstructionsResource(SyncAPIResource):
 
     @cached_property
     def entry(self) -> SessionInstructionsEntryResource:
+        """Operations under ``client.session.instructions.entry``."""
         return SessionInstructionsEntryResource(self._client)
 
 
@@ -426,10 +427,10 @@ class SessionMessageResource(SyncAPIResource):
         Retrieve one projected message owned by the Session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          MessageNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          MessageNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/message/:messageID``
         """
@@ -467,10 +468,10 @@ class SessionFormResource(SyncAPIResource):
         Retrieve pending forms for a session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/form``
         """
@@ -508,11 +509,11 @@ class SessionFormResource(SyncAPIResource):
         Create a form for a session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/form``
         """
@@ -548,11 +549,11 @@ class SessionFormResource(SyncAPIResource):
         Retrieve a form and its current state for a session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          FormNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          FormNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/form/:formID``
         """
@@ -588,13 +589,13 @@ class SessionFormResource(SyncAPIResource):
         Submit an answer to a pending form.
 
         Raises:
-          FormInvalidAnswerError
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          FormNotFoundError
-          LocationNotFoundError
-          FormAlreadySettledError
+          FormInvalidAnswerError: The server answered 400.
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          FormNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          FormAlreadySettledError: The server answered 409.
 
         ``POST /api/session/:sessionID/form/:formID/reply``
         """
@@ -627,12 +628,12 @@ class SessionFormResource(SyncAPIResource):
         Cancel a pending form, optionally telling the asker why it was not answered.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          FormNotFoundError
-          LocationNotFoundError
-          FormAlreadySettledError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          FormNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          FormAlreadySettledError: The server answered 409.
 
         ``DELETE /api/session/:sessionID/form/:formID``
         """
@@ -655,22 +656,27 @@ class SessionResource(SyncAPIResource):
 
     @cached_property
     def revert(self) -> SessionRevertResource:
+        """Operations under ``client.session.revert``."""
         return SessionRevertResource(self._client)
 
     @cached_property
     def inbox(self) -> SessionInboxResource:
+        """Operations under ``client.session.inbox``."""
         return SessionInboxResource(self._client)
 
     @cached_property
     def instructions(self) -> SessionInstructionsResource:
+        """Operations under ``client.session.instructions``."""
         return SessionInstructionsResource(self._client)
 
     @cached_property
     def message(self) -> SessionMessageResource:
+        """Operations under ``client.session.message``."""
         return SessionMessageResource(self._client)
 
     @cached_property
     def form(self) -> SessionFormResource:
+        """Operations under ``client.session.form``."""
         return SessionFormResource(self._client)
 
     def list(
@@ -701,9 +707,9 @@ class SessionResource(SyncAPIResource):
           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
+          InvalidCursorError: The server answered 400.
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
 
         ``GET /api/session``
         """
@@ -750,8 +756,8 @@ class SessionResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
 
         ``GET /api/experimental/session/stats``
         """
@@ -793,9 +799,9 @@ class SessionResource(SyncAPIResource):
         Create a session at the requested location. A parentID creates a linked child session at its parent's location.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``POST /api/session``
         """
@@ -843,10 +849,10 @@ class SessionResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/experimental/session/import``
         """
@@ -884,10 +890,10 @@ class SessionResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
 
         ``GET /api/experimental/session/:sessionID/export``
         """
@@ -921,8 +927,8 @@ class SessionResource(SyncAPIResource):
         Retrieve foreground Session drains currently owned by this OpenCode process. Sessions absent from the result are inactive.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
 
         ``GET /api/session/active``
         """
@@ -956,9 +962,9 @@ class SessionResource(SyncAPIResource):
         Retrieve a session by ID.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID``
         """
@@ -992,9 +998,9 @@ class SessionResource(SyncAPIResource):
         Delete a session and its child sessions.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``DELETE /api/session/:sessionID``
         """
@@ -1025,11 +1031,11 @@ class SessionResource(SyncAPIResource):
         Create a child session by copying projected history before a message. Omit before to copy the full history.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          MessageNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          MessageNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/fork``
         """
@@ -1065,10 +1071,10 @@ class SessionResource(SyncAPIResource):
         Switch the agent used by subsequent provider turns.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/agent``
         """
@@ -1100,10 +1106,10 @@ class SessionResource(SyncAPIResource):
         Switch the model used by subsequent provider turns.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/model``
         """
@@ -1141,10 +1147,10 @@ class SessionResource(SyncAPIResource):
           archived: Archive the session with true or restore it with false. Repeating the current state is a no-op.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``PATCH /api/session/:sessionID``
         """
@@ -1177,9 +1183,9 @@ class SessionResource(SyncAPIResource):
         Move a session to another project directory at the requested delivery boundary.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/move``
         """
@@ -1218,11 +1224,11 @@ class SessionResource(SyncAPIResource):
         Durably admit one session input and schedule agent-loop execution unless resume is false.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/prompt``
         """
@@ -1272,12 +1278,12 @@ class SessionResource(SyncAPIResource):
         Execute a slash command callback immediately.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          CommandNotFoundError
-          LocationNotFoundError
-          CommandExecutionError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          CommandNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          CommandExecutionError: The server answered 500.
 
         ``POST /api/session/:sessionID/command``
         """
@@ -1319,11 +1325,11 @@ class SessionResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          SkillNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          SkillNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/experimental/session/:sessionID/skill``
         """
@@ -1360,11 +1366,11 @@ class SessionResource(SyncAPIResource):
         Durably admit synthetic session input and schedule execution unless resume is false.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/synthetic``
         """
@@ -1408,10 +1414,10 @@ class SessionResource(SyncAPIResource):
         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
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/shell``
         """
@@ -1444,11 +1450,11 @@ class SessionResource(SyncAPIResource):
         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
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/compact``
         """
@@ -1485,11 +1491,11 @@ class SessionResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ServiceUnavailableError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
 
         ``POST /api/experimental/session/:sessionID/wait``
         """
@@ -1519,10 +1525,10 @@ class SessionResource(SyncAPIResource):
         Retrieve the active context messages for a session (all messages after the last compaction).
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
 
         ``GET /api/session/:sessionID/context``
         """
@@ -1564,12 +1570,12 @@ class SessionResource(SyncAPIResource):
           context: Unchanged lines around each hunk. Omit for full-file patches.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          MessageNotFoundError
-          SessionNotFoundError
-          LocationNotFoundError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          MessageNotFoundError: The server answered 404.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
 
         ``GET /api/session/:sessionID/diff``
         """
@@ -1605,11 +1611,11 @@ class SessionResource(SyncAPIResource):
         Generate transient text from the current session context without mutating session history.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ServiceUnavailableError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
 
         ``POST /api/session/:sessionID/generate``
         """
@@ -1648,9 +1654,9 @@ class SessionResource(SyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``GET /api/experimental/session/:sessionID/log``
         """
@@ -1682,10 +1688,10 @@ class SessionResource(SyncAPIResource):
         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
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/interrupt``
         """
@@ -1719,10 +1725,10 @@ class SessionResource(SyncAPIResource):
         Move active foreground backgroundable tools for this session into background observation. Idle requests are a no-op.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/background``
         """
@@ -1753,9 +1759,9 @@ class SessionResource(SyncAPIResource):
         Replace the process environment used by local shell commands for this session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``PUT /api/session/:sessionID/environment``
         """
@@ -1787,9 +1793,9 @@ class SessionResource(SyncAPIResource):
         Mark the idle transition observed by the viewer as viewed.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/view``
         """
@@ -1826,13 +1832,13 @@ class AsyncSessionRevertResource(AsyncAPIResource):
         Stage or move a reversible session boundary and optionally apply its file changes.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          MessageNotFoundError
-          SessionNotFoundError
-          LocationNotFoundError
-          SessionBusyError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          MessageNotFoundError: The server answered 404.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          SessionBusyError: The server answered 409.
+          UnknownError: The server answered 500.
 
         ``POST /api/session/:sessionID/revert/stage``
         """
@@ -1865,12 +1871,12 @@ class AsyncSessionRevertResource(AsyncAPIResource):
         """Clear staged revert.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          SessionBusyError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          SessionBusyError: The server answered 409.
+          UnknownError: The server answered 500.
 
         ``DELETE /api/session/:sessionID/revert``
         """
@@ -1898,11 +1904,11 @@ class AsyncSessionRevertResource(AsyncAPIResource):
         """Commit staged revert.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          SessionBusyError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          SessionBusyError: The server answered 409.
 
         ``POST /api/session/:sessionID/revert/commit``
         """
@@ -1936,9 +1942,9 @@ class AsyncSessionInboxResource(AsyncAPIResource):
         List durable enqueued session work not yet delivered, ordered by enqueue sequence. Includes user, synthetic, compaction, and move items.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/inbox``
         """
@@ -1973,9 +1979,9 @@ class AsyncSessionInboxResource(AsyncAPIResource):
         Cancel an inbox item that has not yet been delivered. Unavailable items are a no-op.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``DELETE /api/session/:sessionID/inbox/:inboxID``
         """
@@ -2007,10 +2013,10 @@ class AsyncSessionInboxResource(AsyncAPIResource):
         Change a pending inbox item's delivery mode. Steering wakes session execution.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``PATCH /api/session/:sessionID/inbox/:inboxID``
         """
@@ -2047,10 +2053,10 @@ class AsyncSessionInstructionsEntryResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``GET /api/experimental/session/:sessionID/instructions/entries``
         """
@@ -2088,11 +2094,11 @@ class AsyncSessionInstructionsEntryResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          InstructionEntryValueTooLargeError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          InstructionEntryValueTooLargeError: The server answered 413.
 
         ``PUT /api/experimental/session/:sessionID/instructions/entries/:key``
         """
@@ -2126,10 +2132,10 @@ class AsyncSessionInstructionsEntryResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``DELETE /api/experimental/session/:sessionID/instructions/entries/:key``
         """
@@ -2151,6 +2157,7 @@ class AsyncSessionInstructionsResource(AsyncAPIResource):
 
     @cached_property
     def entry(self) -> AsyncSessionInstructionsEntryResource:
+        """Operations under ``client.session.instructions.entry``."""
         return AsyncSessionInstructionsEntryResource(self._client)
 
 
@@ -2172,10 +2179,10 @@ class AsyncSessionMessageResource(AsyncAPIResource):
         Retrieve one projected message owned by the Session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          MessageNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          MessageNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/message/:messageID``
         """
@@ -2213,10 +2220,10 @@ class AsyncSessionFormResource(AsyncAPIResource):
         Retrieve pending forms for a session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/form``
         """
@@ -2254,11 +2261,11 @@ class AsyncSessionFormResource(AsyncAPIResource):
         Create a form for a session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/form``
         """
@@ -2294,11 +2301,11 @@ class AsyncSessionFormResource(AsyncAPIResource):
         Retrieve a form and its current state for a session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          FormNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          FormNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID/form/:formID``
         """
@@ -2334,13 +2341,13 @@ class AsyncSessionFormResource(AsyncAPIResource):
         Submit an answer to a pending form.
 
         Raises:
-          FormInvalidAnswerError
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          FormNotFoundError
-          LocationNotFoundError
-          FormAlreadySettledError
+          FormInvalidAnswerError: The server answered 400.
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          FormNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          FormAlreadySettledError: The server answered 409.
 
         ``POST /api/session/:sessionID/form/:formID/reply``
         """
@@ -2373,12 +2380,12 @@ class AsyncSessionFormResource(AsyncAPIResource):
         Cancel a pending form, optionally telling the asker why it was not answered.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          FormNotFoundError
-          LocationNotFoundError
-          FormAlreadySettledError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          FormNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          FormAlreadySettledError: The server answered 409.
 
         ``DELETE /api/session/:sessionID/form/:formID``
         """
@@ -2401,22 +2408,27 @@ class AsyncSessionResource(AsyncAPIResource):
 
     @cached_property
     def revert(self) -> AsyncSessionRevertResource:
+        """Operations under ``client.session.revert``."""
         return AsyncSessionRevertResource(self._client)
 
     @cached_property
     def inbox(self) -> AsyncSessionInboxResource:
+        """Operations under ``client.session.inbox``."""
         return AsyncSessionInboxResource(self._client)
 
     @cached_property
     def instructions(self) -> AsyncSessionInstructionsResource:
+        """Operations under ``client.session.instructions``."""
         return AsyncSessionInstructionsResource(self._client)
 
     @cached_property
     def message(self) -> AsyncSessionMessageResource:
+        """Operations under ``client.session.message``."""
         return AsyncSessionMessageResource(self._client)
 
     @cached_property
     def form(self) -> AsyncSessionFormResource:
+        """Operations under ``client.session.form``."""
         return AsyncSessionFormResource(self._client)
 
     def list(
@@ -2447,9 +2459,9 @@ class AsyncSessionResource(AsyncAPIResource):
           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
+          InvalidCursorError: The server answered 400.
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
 
         ``GET /api/session``
         """
@@ -2496,8 +2508,8 @@ class AsyncSessionResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
 
         ``GET /api/experimental/session/stats``
         """
@@ -2539,9 +2551,9 @@ class AsyncSessionResource(AsyncAPIResource):
         Create a session at the requested location. A parentID creates a linked child session at its parent's location.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``POST /api/session``
         """
@@ -2589,10 +2601,10 @@ class AsyncSessionResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/experimental/session/import``
         """
@@ -2630,10 +2642,10 @@ class AsyncSessionResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
 
         ``GET /api/experimental/session/:sessionID/export``
         """
@@ -2667,8 +2679,8 @@ class AsyncSessionResource(AsyncAPIResource):
         Retrieve foreground Session drains currently owned by this OpenCode process. Sessions absent from the result are inactive.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
 
         ``GET /api/session/active``
         """
@@ -2702,9 +2714,9 @@ class AsyncSessionResource(AsyncAPIResource):
         Retrieve a session by ID.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``GET /api/session/:sessionID``
         """
@@ -2738,9 +2750,9 @@ class AsyncSessionResource(AsyncAPIResource):
         Delete a session and its child sessions.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``DELETE /api/session/:sessionID``
         """
@@ -2771,11 +2783,11 @@ class AsyncSessionResource(AsyncAPIResource):
         Create a child session by copying projected history before a message. Omit before to copy the full history.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          MessageNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          MessageNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/fork``
         """
@@ -2811,10 +2823,10 @@ class AsyncSessionResource(AsyncAPIResource):
         Switch the agent used by subsequent provider turns.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/agent``
         """
@@ -2846,10 +2858,10 @@ class AsyncSessionResource(AsyncAPIResource):
         Switch the model used by subsequent provider turns.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/model``
         """
@@ -2887,10 +2899,10 @@ class AsyncSessionResource(AsyncAPIResource):
           archived: Archive the session with true or restore it with false. Repeating the current state is a no-op.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``PATCH /api/session/:sessionID``
         """
@@ -2923,9 +2935,9 @@ class AsyncSessionResource(AsyncAPIResource):
         Move a session to another project directory at the requested delivery boundary.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/move``
         """
@@ -2964,11 +2976,11 @@ class AsyncSessionResource(AsyncAPIResource):
         Durably admit one session input and schedule agent-loop execution unless resume is false.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/prompt``
         """
@@ -3018,12 +3030,12 @@ class AsyncSessionResource(AsyncAPIResource):
         Execute a slash command callback immediately.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          CommandNotFoundError
-          LocationNotFoundError
-          CommandExecutionError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          CommandNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          CommandExecutionError: The server answered 500.
 
         ``POST /api/session/:sessionID/command``
         """
@@ -3065,11 +3077,11 @@ class AsyncSessionResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          SkillNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          SkillNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/experimental/session/:sessionID/skill``
         """
@@ -3106,11 +3118,11 @@ class AsyncSessionResource(AsyncAPIResource):
         Durably admit synthetic session input and schedule execution unless resume is false.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ConflictError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/synthetic``
         """
@@ -3154,10 +3166,10 @@ class AsyncSessionResource(AsyncAPIResource):
         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
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/shell``
         """
@@ -3190,11 +3202,11 @@ class AsyncSessionResource(AsyncAPIResource):
         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
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ConflictError: The server answered 409.
 
         ``POST /api/session/:sessionID/compact``
         """
@@ -3231,11 +3243,11 @@ class AsyncSessionResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ServiceUnavailableError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
 
         ``POST /api/experimental/session/:sessionID/wait``
         """
@@ -3265,10 +3277,10 @@ class AsyncSessionResource(AsyncAPIResource):
         Retrieve the active context messages for a session (all messages after the last compaction).
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
 
         ``GET /api/session/:sessionID/context``
         """
@@ -3310,12 +3322,12 @@ class AsyncSessionResource(AsyncAPIResource):
           context: Unchanged lines around each hunk. Omit for full-file patches.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          MessageNotFoundError
-          SessionNotFoundError
-          LocationNotFoundError
-          UnknownError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          MessageNotFoundError: The server answered 404.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
 
         ``GET /api/session/:sessionID/diff``
         """
@@ -3351,11 +3363,11 @@ class AsyncSessionResource(AsyncAPIResource):
         Generate transient text from the current session context without mutating session history.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
-          ServiceUnavailableError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
 
         ``POST /api/session/:sessionID/generate``
         """
@@ -3394,9 +3406,9 @@ class AsyncSessionResource(AsyncAPIResource):
         This endpoint is experimental in OpenCode and may change without notice.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``GET /api/experimental/session/:sessionID/log``
         """
@@ -3428,10 +3440,10 @@ class AsyncSessionResource(AsyncAPIResource):
         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
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/interrupt``
         """
@@ -3465,10 +3477,10 @@ class AsyncSessionResource(AsyncAPIResource):
         Move active foreground backgroundable tools for this session into background observation. Idle requests are a no-op.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
-          LocationNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          LocationNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/background``
         """
@@ -3499,9 +3511,9 @@ class AsyncSessionResource(AsyncAPIResource):
         Replace the process environment used by local shell commands for this session.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``PUT /api/session/:sessionID/environment``
         """
@@ -3533,9 +3545,9 @@ class AsyncSessionResource(AsyncAPIResource):
         Mark the idle transition observed by the viewer as viewed.
 
         Raises:
-          InvalidRequestError
-          UnauthorizedError
-          SessionNotFoundError
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
 
         ``POST /api/session/:sessionID/view``
         """