opencode-python-sdk 0.0.1.dev1__py3-none-any.whl

opencode/resources/message.py

@@ -0,0 +1,152 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``message`` resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Literal
+
+from .._base_client import RequestOptions
+from .._pagination import AsyncPaginator, SyncCursorPage
+from .._qs import encode_path_segment
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, OpenEnum, Query, Timeout
+
+if TYPE_CHECKING:
+    from ..types import (
+        SessionID,
+        SessionMessageInfo,
+    )
+
+__all__ = ["MessageResource", "AsyncMessageResource"]
+
+
+class MessageResource(SyncAPIResource):
+    """Operations under ``client.message`` (OpenCode ``message``)."""
+
+    def list(
+        self,
+        session_id: SessionID,
+        *,
+        limit: int | NotGiven | None = NOT_GIVEN,
+        order: OpenEnum[Literal["asc", "desc"]] | NotGiven | None = NOT_GIVEN,
+        cursor: str | NotGiven | None = NOT_GIVEN,
+        type: OpenEnum[
+            Literal[
+                "agent-switched",
+                "model-switched",
+                "location-switched",
+                "user",
+                "synthetic",
+                "system",
+                "skill",
+                "shell",
+                "assistant",
+                "compaction",
+                "idle",
+            ]
+        ]
+        | 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[SessionMessageInfo]:
+        """Get session messages.
+
+        Retrieve projected messages for a session, optionally filtered by type. Items keep the requested order across pages; use cursor.next or cursor.previous to move through the ordered timeline, passing the same type filter on each page.
+
+        Args:
+          limit: Maximum number of messages to return. When omitted, the endpoint returns its default page size.
+          order: Message order for the first page. Use desc for newest first or asc for oldest first.
+          cursor: Opaque pagination cursor returned as cursor.previous or cursor.next in the previous response. Do not combine with order.
+          type: Filter by message type before pagination. When omitted, all message types are returned. Pass the same type when following cursors.
+
+        Raises:
+          InvalidCursorError: The server answered 400.
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
+
+        ``GET /api/session/:sessionID/message``
+        """
+        return self._client.page(
+            RequestOptions(
+                method="GET",
+                path=f"/api/session/{encode_path_segment(session_id)}/message",
+                query={"limit": limit, "order": order, "cursor": cursor, "type": type},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            response_type="SessionMessagesResponse",
+        )
+
+
+class AsyncMessageResource(AsyncAPIResource):
+    """Operations under ``client.message`` (OpenCode ``message``)."""
+
+    def list(
+        self,
+        session_id: SessionID,
+        *,
+        limit: int | NotGiven | None = NOT_GIVEN,
+        order: OpenEnum[Literal["asc", "desc"]] | NotGiven | None = NOT_GIVEN,
+        cursor: str | NotGiven | None = NOT_GIVEN,
+        type: OpenEnum[
+            Literal[
+                "agent-switched",
+                "model-switched",
+                "location-switched",
+                "user",
+                "synthetic",
+                "system",
+                "skill",
+                "shell",
+                "assistant",
+                "compaction",
+                "idle",
+            ]
+        ]
+        | 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[SessionMessageInfo]:
+        """Get session messages.
+
+        Retrieve projected messages for a session, optionally filtered by type. Items keep the requested order across pages; use cursor.next or cursor.previous to move through the ordered timeline, passing the same type filter on each page.
+
+        Args:
+          limit: Maximum number of messages to return. When omitted, the endpoint returns its default page size.
+          order: Message order for the first page. Use desc for newest first or asc for oldest first.
+          cursor: Opaque pagination cursor returned as cursor.previous or cursor.next in the previous response. Do not combine with order.
+          type: Filter by message type before pagination. When omitted, all message types are returned. Pass the same type when following cursors.
+
+        Raises:
+          InvalidCursorError: The server answered 400.
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          SessionNotFoundError: The server answered 404.
+          UnknownError: The server answered 500.
+
+        ``GET /api/session/:sessionID/message``
+        """
+        return self._client.page(
+            RequestOptions(
+                method="GET",
+                path=f"/api/session/{encode_path_segment(session_id)}/message",
+                query={"limit": limit, "order": order, "cursor": cursor, "type": type},
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            response_type="SessionMessagesResponse",
+        )

opencode/resources/migration.py

@@ -0,0 +1,118 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``migration`` resource."""
+
+from __future__ import annotations
+
+from functools import cached_property
+from typing import TYPE_CHECKING, cast
+
+from .._base_client import RequestOptions
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+
+if TYPE_CHECKING:
+    from ..types import (
+        MigrationV1StatusResponseOption1,
+        MigrationV1StatusResponseOption2,
+        MigrationV1StatusResponseOption3,
+    )
+
+__all__ = ["MigrationResource", "AsyncMigrationResource"]
+
+
+class MigrationV1Resource(SyncAPIResource):
+    """Operations under ``client.migration.v1`` (OpenCode ``migration.v1``)."""
+
+    def status(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> MigrationV1StatusResponseOption1 | MigrationV1StatusResponseOption2 | MigrationV1StatusResponseOption3:
+        """Get V1 migration status.
+
+        Return the progress of the V1 to V2 session history migration.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+
+        ``GET /api/experimental/migration/v1``
+        """
+        return cast(
+            "MigrationV1StatusResponseOption1 | MigrationV1StatusResponseOption2 | MigrationV1StatusResponseOption3",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/experimental/migration/v1",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type="MigrationV1StatusResponseOption1 | MigrationV1StatusResponseOption2 | MigrationV1StatusResponseOption3",
+            ),
+        )
+
+
+class MigrationResource(SyncAPIResource):
+    """Operations under ``client.migration`` (OpenCode ``migration``)."""
+
+    @cached_property
+    def v1(self) -> MigrationV1Resource:
+        """Operations under ``client.migration.v1``."""
+        return MigrationV1Resource(self._client)
+
+
+class AsyncMigrationV1Resource(AsyncAPIResource):
+    """Operations under ``client.migration.v1`` (OpenCode ``migration.v1``)."""
+
+    async def status(
+        self,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> MigrationV1StatusResponseOption1 | MigrationV1StatusResponseOption2 | MigrationV1StatusResponseOption3:
+        """Get V1 migration status.
+
+        Return the progress of the V1 to V2 session history migration.
+
+        This endpoint is experimental in OpenCode and may change without notice.
+
+        Raises:
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+
+        ``GET /api/experimental/migration/v1``
+        """
+        return cast(
+            "MigrationV1StatusResponseOption1 | MigrationV1StatusResponseOption2 | MigrationV1StatusResponseOption3",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/experimental/migration/v1",
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type="MigrationV1StatusResponseOption1 | MigrationV1StatusResponseOption2 | MigrationV1StatusResponseOption3",
+            ),
+        )
+
+
+class AsyncMigrationResource(AsyncAPIResource):
+    """Operations under ``client.migration`` (OpenCode ``migration``)."""
+
+    @cached_property
+    def v1(self) -> AsyncMigrationV1Resource:
+        """Operations under ``client.migration.v1``."""
+        return AsyncMigrationV1Resource(self._client)

opencode/resources/model.py

@@ -0,0 +1,177 @@
+# This file is generated by `python -m codegen` from spec/contract.json. Do not edit it by hand.
+# OpenCode 2.1.2
+
+"""The ``model`` resource."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, cast
+
+from .._base_client import RequestOptions
+from .._resource import AsyncAPIResource, SyncAPIResource
+from .._types import NOT_GIVEN, Body, Headers, NotGiven, Query, Timeout
+
+if TYPE_CHECKING:
+    from ..types import (
+        Location,
+        ModelDefaultResponse,
+        ModelListResponse,
+    )
+
+__all__ = ["ModelResource", "AsyncModelResource"]
+
+
+class ModelResource(SyncAPIResource):
+    """Operations under ``client.model`` (OpenCode ``model``)."""
+
+    def list(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> ModelListResponse:
+        """List models.
+
+        Retrieve the current snapshot of available models ordered by release date. The snapshot may precede initial plugin settlement.
+
+        Raises:
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
+
+        ``GET /api/model``
+        """
+        return cast(
+            "ModelListResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/model",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type="ModelListResponse",
+            ),
+        )
+
+    def default(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> ModelDefaultResponse:
+        """Get default model.
+
+        Retrieve the model used when a session has no explicit model selection.
+
+        Raises:
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
+
+        ``GET /api/model/default``
+        """
+        return cast(
+            "ModelDefaultResponse",
+            self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/model/default",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type="ModelDefaultResponse",
+            ),
+        )
+
+
+class AsyncModelResource(AsyncAPIResource):
+    """Operations under ``client.model`` (OpenCode ``model``)."""
+
+    async def list(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> ModelListResponse:
+        """List models.
+
+        Retrieve the current snapshot of available models ordered by release date. The snapshot may precede initial plugin settlement.
+
+        Raises:
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
+
+        ``GET /api/model``
+        """
+        return cast(
+            "ModelListResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/model",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type="ModelListResponse",
+            ),
+        )
+
+    async def default(
+        self,
+        *,
+        location: Location | NotGiven | None = NOT_GIVEN,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: Timeout | NotGiven = NOT_GIVEN,
+    ) -> ModelDefaultResponse:
+        """Get default model.
+
+        Retrieve the model used when a session has no explicit model selection.
+
+        Raises:
+          InvalidRequestError: The server answered 400.
+          UnauthorizedError: The server answered 401.
+          LocationNotFoundError: The server answered 404.
+          ServiceUnavailableError: The server answered 503.
+
+        ``GET /api/model/default``
+        """
+        return cast(
+            "ModelDefaultResponse",
+            await self._client.request(
+                RequestOptions(
+                    method="GET",
+                    path="/api/model/default",
+                    query={"location": self._location(location)},
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                ),
+                response_type="ModelDefaultResponse",
+            ),
+        )